add first cut at deep-link redirecting, with one example contact-import that works on mobile

src/services/deepLinks.ts

@@ -27,18 +27,16 @@
  * timesafari://<route>[/<param>][?queryParam1=value1&queryParam2=value2]
  *
  * Supported Routes:
- * - user-profile: View user profile
- * - project: View project details
- * - onboard-meeting-setup: Setup onboarding meeting
- * - invite-one-accept: Accept invitation
- * - contact-import: Import contacts
- * - confirm-gift: Confirm gift
  * - claim: View claim
- * - claim-cert: View claim certificate
  * - claim-add-raw: Add raw claim
- * - contact-edit: Edit contact
- * - contacts: View contacts
+ * - claim-cert: View claim certificate
+ * - confirm-gift
+ * - contact-import: Import contacts
  * - did: View DID
+ * - invite-one-accept: Accept invitation
+ * - onboard-meeting-members
+ * - project: View project details
+ * - user-profile: View user profile
  *
  * @example
  * const handler = new DeepLinkHandler(router);
@@ -54,6 +52,7 @@ import {
 } from "../interfaces/deepLinks";
 import { logConsoleAndDb } from "../db/databaseUtil";
 import type { DeepLinkError } from "../interfaces/deepLinks";
+import { logger } from "@/utils/logger";
 
 /**
  * Handles processing and routing of deep links in the application.
@@ -81,14 +80,15 @@ export class DeepLinkHandler {
     string,
     { name: string; paramKey?: string }
   > = {
+    // note that similar lists are in src/interfaces/deepLinks.ts
     claim: { name: "claim" },
     "claim-add-raw": { name: "claim-add-raw" },
     "claim-cert": { name: "claim-cert" },
     "confirm-gift": { name: "confirm-gift" },
+    "contact-import": { name: "contact-import", paramKey: "jwt" },
     did: { name: "did", paramKey: "did" },
     "invite-one-accept": { name: "invite-one-accept", paramKey: "jwt" },
     "onboard-meeting-members": { name: "onboard-meeting-members" },
-    "onboard-meeting-setup": { name: "onboard-meeting-setup" },
     project: { name: "project" },
     "user-profile": { name: "user-profile" },
   };
@@ -99,7 +99,7 @@ export class DeepLinkHandler {
    *
    * @param url - The deep link URL to parse (format: scheme://path[?query])
    * @throws {DeepLinkError} If URL format is invalid
-   * @returns Parsed URL components (path, params, query)
+   * @returns Parsed URL components (path: string, params: {KEY: string}, query: {KEY: string})
    */
   private parseDeepLink(url: string) {
     const parts = url.split("://");
@@ -115,7 +115,16 @@ export class DeepLinkHandler {
     });
 
     const [path, queryString] = parts[1].split("?");
-    const [routePath, param] = path.split("/");
+    const [routePath, ...pathParams] = path.split("/");
+    // logger.log(
+    //   "[DeepLink] Debug:",
+    //   "Route Path:",
+    //   routePath,
+    //   "Path Params:",
+    //   pathParams,
+    //   "Query String:",
+    //   queryString,
+    // );
 
     // Validate route exists before proceeding
     if (!this.ROUTE_MAP[routePath]) {
@@ -134,10 +143,10 @@ export class DeepLinkHandler {
     }
 
     const params: Record<string, string> = {};
-    if (param) {
+    if (pathParams) {
       // Now we know routePath exists in ROUTE_MAP
       const routeConfig = this.ROUTE_MAP[routePath];
-      params[routeConfig.paramKey ?? "id"] = param;
+      params[routeConfig.paramKey ?? "id"] = pathParams.join("/");
     }
     return { path: routePath, params, query };
   }
@@ -243,6 +252,8 @@ export class DeepLinkHandler {
         code: "INVALID_PARAMETERS",
         message: (error as Error).message,
         details: error,
+        params: params,
+        query: query,
       };
     }
   }