fix(mobile): resolve iOS "unmatched route docuelevate://" error in Open In share flow

Co-authored-by: christianlouis <361235+christianlouis@users.noreply.github.com>
2026-03-18 23:27:56 +00:00
parent 5ef82050b8
commit f2b7db88ba
4 changed files with 165 additions and 1 deletions
@@ -0,0 +1,119 @@
+/**
+ * Catch-all "not found" route for expo-router.
+ *
+ * This screen intercepts two different situations:
+ *
+ * 1. **iOS "Open In…" / share sheet** — iOS delivers files to the app via a
+ *    `docuelevate://<path>` URL.  expo-router strips the custom scheme and
+ *    tries to match the raw filesystem path (e.g.
+ *    `/private/var/mobile/Library/…/file.pdf`) as an in-app route.  Because
+ *    no such route exists, expo-router previously threw "unmatched route
+ *    docuelevate://…" and the upload never happened.
+ *
+ *    This screen detects the filesystem-path pattern and immediately redirects
+ *    to the Upload tab.  The `Linking` listener registered in `_layout.tsx`
+ *    runs concurrently and adds the file to `ShareContext`; `UploadScreen`
+ *    picks it up and begins uploading as soon as the redirect completes.
+ *
+ * 2. **Any other unmatched in-app route** — redirect silently to the root so
+ *    the user isn't left on a blank error page.
+ */
+
+import { usePathname, useRouter } from "expo-router";
+import React, { useEffect } from "react";
+import { ActivityIndicator, StyleSheet, View } from "react-native";
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * First path-segment names that identify iOS/Android sandbox filesystem paths.
+ * These can never be expo-router route-group names, so their presence is a
+ * strong positive signal that the URL is a shared file rather than a route.
+ *
+ *   iOS:     /private/var/mobile/…   → "private"
+ *            /var/mobile/…           → "var"  (symlink to /private/var/mobile)
+ *            /tmp/…                  → "tmp"
+ *   Android: /data/user/0/…          → "data"
+ *            /storage/emulated/0/…   → "storage"
+ */
+const FS_PATH_ROOTS = ["private", "var", "tmp", "data", "storage"];
+
+/**
+ * Route-group / special-file prefixes that identify genuine in-app routes
+ * rather than filesystem path segments.
+ *
+ * ⚠️  Keep this list in sync with the top-level entries in the `app/`
+ *     directory.  Add an entry here if you add a new top-level route group
+ *     that does **not** use the parentheses convention.
+ */
+const IN_APP_ROUTE_PREFIXES = [
+  "(auth)",  // app/(auth)/
+  "(tabs)",  // app/(tabs)/
+  "_",       // expo-router special files (_layout, _sitemap, …)
+  "+",       // expo-router special files (+not-found, …)
+  "--",      // Expo Go development proxy prefix
+];
+
+/**
+ * Return `true` when `pathname` looks like a filesystem path delivered by iOS
+ * "Open In…" (e.g. `/private/var/mobile/Library/…/file.pdf`) rather than a
+ * legitimate in-app route.
+ *
+ * Detection strategy:
+ *   1. **Positive check** – if the first path segment matches a known device
+ *      filesystem root (see `FS_PATH_ROOTS`), it is definitely a file path.
+ *   2. **Fallback negative check** – if the path does not start with any known
+ *      in-app route prefix (see `IN_APP_ROUTE_PREFIXES`), treat it as a file
+ *      path.  This is a heuristic but safe because expo-router route groups
+ *      always use parentheses (e.g. `(auth)`, `(tabs)`).
+ */
+function looksLikeFilePath(pathname: string): boolean {
+  const stripped = pathname.replace(/^\/+/, "");
+  if (stripped.length === 0) return false;
+
+  // Positive signal: path starts with a known device filesystem root segment.
+  const firstSegment = stripped.split("/")[0];
+  if (FS_PATH_ROOTS.includes(firstSegment)) return true;
+
+  // Fallback: paths that start with a known in-app route prefix are routes.
+  return !IN_APP_ROUTE_PREFIXES.some((prefix) => stripped.startsWith(prefix));
+}
+
+// ---------------------------------------------------------------------------
+// Screen component
+// ---------------------------------------------------------------------------
+
+export default function NotFoundScreen() {
+  const pathname = usePathname();
+  const router = useRouter();
+
+  useEffect(() => {
+    if (looksLikeFilePath(pathname)) {
+      // Filesystem path from iOS "Open In…" – redirect to Upload tab.
+      // The Linking listener in _layout.tsx has already (or will shortly)
+      // added the file to ShareContext; UploadScreen will pick it up.
+      router.replace("/(tabs)/");
+    } else {
+      // Truly unknown in-app route – fall back to the root redirect.
+      router.replace("/");
+    }
+  }, [pathname, router]);
+
+  // Show a brief spinner while the redirect is in flight.
+  return (
+    <View style={styles.container}>
+      <ActivityIndicator size="large" color="#1e40af" />
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    alignItems: "center",
+    justifyContent: "center",
+    backgroundColor: "#f9fafb",
+  },
+});