wip: Improve deep link validation and error handling

- Add comprehensive route validation with zod schema
- Create type-safe DeepLinkRoute enum for all valid routes
- Add structured error handling for invalid routes
- Redirect to error page with detailed feedback
- Add better timeout handling in deeplink tests

The changes improve robustness by:
1. Validating route paths before navigation
2. Providing detailed error messages for invalid links
3. Redirecting users to dedicated error pages
4. Adding parameter validation with specific feedback
5. Improving type safety across deeplink handling

src/services/deepLinks.ts

@@ -29,7 +29,11 @@
  */
 
 import { Router } from "vue-router";
-import { deepLinkSchemas, baseUrlSchema } from "../types/deepLinks";
+import {
+  deepLinkSchemas,
+  baseUrlSchema,
+  routeSchema,
+} from "../types/deepLinks";
 import { logConsoleAndDb } from "../db";
 import type { DeepLinkError } from "../interfaces/deepLinks";
 
@@ -111,7 +115,7 @@ export class DeepLinkHandler {
   ): Promise<void> {
     const routeMap: Record<string, string> = {
       "user-profile": "user-profile",
-      project: "project",
+      "project-details": "project-details",
       "onboard-meeting-setup": "onboard-meeting-setup",
       "invite-one-accept": "invite-one-accept",
       "contact-import": "contact-import",
@@ -124,25 +128,63 @@ export class DeepLinkHandler {
       did: "did",
     };
 
-    const routeName = routeMap[path];
-    if (!routeName) {
+    // First try to validate the route path
+    let routeName: string;
+
+    try {
+      // Validate route exists
+      const validRoute = routeSchema.parse(path) as DeepLinkRoute;
+      routeName = routeMap[validRoute];
+    } catch (error) {
+      // Log the invalid route attempt
+      logConsoleAndDb(`[DeepLink] Invalid route path: ${path}`, true);
+
+      // Redirect to error page with information about the invalid link
+      await this.router.replace({
+        name: "deep-link-error",
+        query: {
+          originalPath: path,
+          errorCode: "INVALID_ROUTE",
+          message: `The link you followed (${path}) is not supported`,
+        },
+      });
+
       throw {
         code: "INVALID_ROUTE",
         message: `Unsupported route: ${path}`,
       };
     }
 
-    // Validate parameters based on route type
+    // Continue with parameter validation as before...
     const schema = deepLinkSchemas[path as keyof typeof deepLinkSchemas];
-    const validatedParams = await schema.parseAsync({
-      ...params,
-      ...query,
-    });
 
-    await this.router.replace({
-      name: routeName,
-      params: validatedParams,
-      query,
-    });
+    try {
+      const validatedParams = await schema.parseAsync({
+        ...params,
+        ...query,
+      });
+
+      await this.router.replace({
+        name: routeName,
+        params: validatedParams,
+        query,
+      });
+    } catch (error) {
+      // For parameter validation errors, provide specific error feedback
+      await this.router.replace({
+        name: "deep-link-error",
+        query: {
+          originalPath: path,
+          errorCode: "INVALID_PARAMETERS",
+          message: `The link parameters are invalid: ${(error as Error).message}`,
+        },
+      });
+
+      throw {
+        code: "INVALID_PARAMETERS",
+        message: (error as Error).message,
+        details: error,
+      };
+    }
   }
 }