@rajeev02/deeplink 0.1.0

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @rajeev02/deeplink
+ * Universal Deep Linking
+ * App links, universal links, deferred deep links, route matching, attribution
+ *
+ * @author Rajeev Kumar Joshi
+ * @license MIT
+ */
+export { DeepLinkRouter, getCommonRoutes } from "./router";
+export type { DeepLinkRoute, DeepLinkMatch, DeferredDeepLink, DeepLinkConfig, } from "./router";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3D,YAAY,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,GACf,MAAM,UAAU,CAAC"}

package/lib/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCommonRoutes = exports.DeepLinkRouter = void 0;
+/**
+ * @rajeev02/deeplink
+ * Universal Deep Linking
+ * App links, universal links, deferred deep links, route matching, attribution
+ *
+ * @author Rajeev Kumar Joshi
+ * @license MIT
+ */
+var router_1 = require("./router");
+Object.defineProperty(exports, "DeepLinkRouter", { enumerable: true, get: function () { return router_1.DeepLinkRouter; } });
+Object.defineProperty(exports, "getCommonRoutes", { enumerable: true, get: function () { return router_1.getCommonRoutes; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,mCAA2D;AAAlD,wGAAA,cAAc,OAAA;AAAE,yGAAA,eAAe,OAAA"}

package/lib/router/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @rajeev02/deeplink — Router
+ * Universal deep link router — pattern matching, parameter extraction,
+ * auth guards, deferred deep links, analytics attribution
+ */
+export interface DeepLinkRoute {
+    /** Pattern: "/product/:id", "/payment/:orderId/status", "/chat/:roomId" */
+    pattern: string;
+    /** Screen/page name to navigate to */
+    screen: string;
+    /** Required auth state ('authenticated' | 'any') */
+    authRequired?: boolean;
+    /** Handler function */
+    handler?: (params: Record<string, string>, query: Record<string, string>) => void;
+}
+export interface DeepLinkMatch {
+    route: DeepLinkRoute;
+    params: Record<string, string>;
+    query: Record<string, string>;
+    fullUrl: string;
+}
+export interface DeferredDeepLink {
+    url: string;
+    timestamp: number;
+    source?: string;
+    campaign?: string;
+    processed: boolean;
+}
+export interface DeepLinkConfig {
+    /** App scheme (e.g., "rajeevapp://") */
+    scheme: string;
+    /** Universal link domains (e.g., ["rajeevapp.com", "link.rajeevapp.com"]) */
+    domains: string[];
+    /** Route definitions */
+    routes: DeepLinkRoute[];
+    /** Callback when no route matches */
+    onNoMatch?: (url: string) => void;
+    /** Callback for attribution tracking */
+    onAttribution?: (source: string, campaign?: string, medium?: string) => void;
+}
+/**
+ * Deep Link Router
+ */
+export declare class DeepLinkRouter {
+    private config;
+    private deferredLink;
+    private isReady;
+    constructor(config: DeepLinkConfig);
+    /** Mark the app as ready to handle deep links (after auth check, navigation ready) */
+    setReady(): void;
+    /** Handle an incoming deep link URL */
+    handle(url: string): DeepLinkMatch | null;
+    /** Generate a deep link URL */
+    generate(pattern: string, params?: Record<string, string>, query?: Record<string, string>): string;
+    /** Generate a universal link (HTTPS) */
+    generateUniversalLink(pattern: string, params?: Record<string, string>, query?: Record<string, string>): string;
+    /** Get deferred deep link (for cold start handling) */
+    getDeferredLink(): DeferredDeepLink | null;
+    /** Get all registered routes */
+    getRoutes(): DeepLinkRoute[];
+    /** Add a route dynamically */
+    addRoute(route: DeepLinkRoute): void;
+    private parseUrl;
+    private matchPattern;
+}
+/**
+ * Common deep link routes for super apps
+ */
+export declare function getCommonRoutes(): DeepLinkRoute[];
+//# sourceMappingURL=index.d.ts.map

package/lib/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uBAAuB;IACvB,OAAO,CAAC,EAAE,CACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC1B,IAAI,CAAC;CACX;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wBAAwB;IACxB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,qCAAqC;IACrC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,wCAAwC;IACxC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9E;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,OAAO,CAAkB;gBAErB,MAAM,EAAE,cAAc;IAIlC,sFAAsF;IACtF,QAAQ,IAAI,IAAI;IAQhB,uCAAuC;IACvC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IA4CzC,+BAA+B;IAC/B,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACnC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACjC,MAAM;IAYT,wCAAwC;IACxC,qBAAqB,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACnC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACjC,MAAM;IAaT,uDAAuD;IACvD,eAAe,IAAI,gBAAgB,GAAG,IAAI;IAI1C,gCAAgC;IAChC,SAAS,IAAI,aAAa,EAAE;IAI5B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAIpC,OAAO,CAAC,QAAQ;IAwChB,OAAO,CAAC,YAAY;CAmBrB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,aAAa,EAAE,CA0CjD"}

package/lib/router/index.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * @rajeev02/deeplink — Router
+ * Universal deep link router — pattern matching, parameter extraction,
+ * auth guards, deferred deep links, analytics attribution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeepLinkRouter = void 0;
+exports.getCommonRoutes = getCommonRoutes;
+/**
+ * Deep Link Router
+ */
+class DeepLinkRouter {
+    constructor(config) {
+        this.deferredLink = null;
+        this.isReady = false;
+        this.config = config;
+    }
+    /** Mark the app as ready to handle deep links (after auth check, navigation ready) */
+    setReady() {
+        this.isReady = true;
+        if (this.deferredLink && !this.deferredLink.processed) {
+            this.handle(this.deferredLink.url);
+            this.deferredLink.processed = true;
+        }
+    }
+    /** Handle an incoming deep link URL */
+    handle(url) {
+        const parsed = this.parseUrl(url);
+        if (!parsed)
+            return null;
+        // Extract UTM params for attribution
+        if (parsed.query.utm_source && this.config.onAttribution) {
+            this.config.onAttribution(parsed.query.utm_source, parsed.query.utm_campaign, parsed.query.utm_medium);
+        }
+        // If app not ready yet, defer the link
+        if (!this.isReady) {
+            this.deferredLink = {
+                url,
+                timestamp: Date.now(),
+                source: parsed.query.utm_source,
+                processed: false,
+            };
+            return null;
+        }
+        // Match against routes
+        for (const route of this.config.routes) {
+            const params = this.matchPattern(route.pattern, parsed.path);
+            if (params !== null) {
+                const match = {
+                    route,
+                    params,
+                    query: parsed.query,
+                    fullUrl: url,
+                };
+                if (route.handler)
+                    route.handler(params, parsed.query);
+                return match;
+            }
+        }
+        // No match
+        if (this.config.onNoMatch)
+            this.config.onNoMatch(url);
+        return null;
+    }
+    /** Generate a deep link URL */
+    generate(pattern, params = {}, query = {}) {
+        let path = pattern;
+        for (const [key, value] of Object.entries(params)) {
+            path = path.replace(`:${key}`, encodeURIComponent(value));
+        }
+        const queryStr = Object.entries(query)
+            .map(([k, v]) => `${k}=${encodeURIComponent(v)}`)
+            .join("&");
+        const base = `${this.config.scheme}${path}`;
+        return queryStr ? `${base}?${queryStr}` : base;
+    }
+    /** Generate a universal link (HTTPS) */
+    generateUniversalLink(pattern, params = {}, query = {}) {
+        let path = pattern;
+        for (const [key, value] of Object.entries(params)) {
+            path = path.replace(`:${key}`, encodeURIComponent(value));
+        }
+        const queryStr = Object.entries(query)
+            .map(([k, v]) => `${k}=${encodeURIComponent(v)}`)
+            .join("&");
+        const domain = this.config.domains[0] || "app.example.com";
+        const base = `https://${domain}${path}`;
+        return queryStr ? `${base}?${queryStr}` : base;
+    }
+    /** Get deferred deep link (for cold start handling) */
+    getDeferredLink() {
+        return this.deferredLink;
+    }
+    /** Get all registered routes */
+    getRoutes() {
+        return [...this.config.routes];
+    }
+    /** Add a route dynamically */
+    addRoute(route) {
+        this.config.routes.push(route);
+    }
+    parseUrl(url) {
+        try {
+            let path;
+            let queryStr = "";
+            if (url.includes("://")) {
+                const afterScheme = url.split("://")[1] || "";
+                // Remove domain for universal links
+                let pathPart = afterScheme;
+                for (const domain of this.config.domains) {
+                    if (pathPart.startsWith(domain)) {
+                        pathPart = pathPart.substring(domain.length);
+                        break;
+                    }
+                }
+                const [p, q] = pathPart.split("?");
+                path = p.startsWith("/") ? p : `/${p}`;
+                queryStr = q || "";
+            }
+            else {
+                const [p, q] = url.split("?");
+                path = p.startsWith("/") ? p : `/${p}`;
+                queryStr = q || "";
+            }
+            const query = {};
+            if (queryStr) {
+                for (const pair of queryStr.split("&")) {
+                    const [k, v] = pair.split("=");
+                    if (k)
+                        query[decodeURIComponent(k)] = decodeURIComponent(v || "");
+                }
+            }
+            return { path, query };
+        }
+        catch {
+            return null;
+        }
+    }
+    matchPattern(pattern, path) {
+        const patternParts = pattern.split("/").filter(Boolean);
+        const pathParts = path.split("/").filter(Boolean);
+        if (patternParts.length !== pathParts.length)
+            return null;
+        const params = {};
+        for (let i = 0; i < patternParts.length; i++) {
+            if (patternParts[i].startsWith(":")) {
+                params[patternParts[i].substring(1)] = decodeURIComponent(pathParts[i]);
+            }
+            else if (patternParts[i] !== pathParts[i]) {
+                return null;
+            }
+        }
+        return params;
+    }
+}
+exports.DeepLinkRouter = DeepLinkRouter;
+/**
+ * Common deep link routes for super apps
+ */
+function getCommonRoutes() {
+    return [
+        { pattern: "/home", screen: "HomeScreen" },
+        { pattern: "/product/:id", screen: "ProductScreen" },
+        { pattern: "/product/:id/reviews", screen: "ReviewsScreen" },
+        { pattern: "/cart", screen: "CartScreen", authRequired: true },
+        { pattern: "/checkout", screen: "CheckoutScreen", authRequired: true },
+        {
+            pattern: "/order/:orderId",
+            screen: "OrderDetailScreen",
+            authRequired: true,
+        },
+        {
+            pattern: "/order/:orderId/track",
+            screen: "OrderTrackingScreen",
+            authRequired: true,
+        },
+        {
+            pattern: "/payment/:txnId/status",
+            screen: "PaymentStatusScreen",
+            authRequired: true,
+        },
+        { pattern: "/chat/:roomId", screen: "ChatScreen", authRequired: true },
+        { pattern: "/profile", screen: "ProfileScreen", authRequired: true },
+        {
+            pattern: "/profile/settings",
+            screen: "SettingsScreen",
+            authRequired: true,
+        },
+        {
+            pattern: "/notifications",
+            screen: "NotificationsScreen",
+            authRequired: true,
+        },
+        { pattern: "/scan", screen: "QrScanScreen" },
+        { pattern: "/pay", screen: "PaymentScreen", authRequired: true },
+        { pattern: "/pay/:vpa", screen: "PayToVpaScreen", authRequired: true },
+        { pattern: "/refer", screen: "ReferralScreen" },
+        { pattern: "/offers", screen: "OffersScreen" },
+        { pattern: "/help", screen: "HelpScreen" },
+        { pattern: "/kyc", screen: "KycScreen", authRequired: true },
+    ];
+}
+//# sourceMappingURL=index.js.map

package/lib/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@rajeev02/deeplink",
+  "version": "0.1.0",
+  "description": "Universal deep linking — app links, universal links, deferred deep links, route matching, attribution",
+  "main": "lib/index.js",
+  "author": "Rajeev Kumar Joshi <rajeevjoshi91@gmail.com> (https://rajeev02.github.io)",
+  "license": "MIT",
+  "types": "lib/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf lib",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "react-native",
+    "deeplink",
+    "universal-links",
+    "routing"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Rajeev02/rajeev-sdk",
+    "directory": "packages/deeplink"
+  },
+  "homepage": "https://github.com/Rajeev02/rajeev-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/Rajeev02/rajeev-sdk/issues"
+  },
+  "files": [
+    "lib/",
+    "src/",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18.3.0",
+    "react-native": ">=0.84.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "typescript": "^5.4.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,15 @@
+/**
+ * @rajeev02/deeplink
+ * Universal Deep Linking
+ * App links, universal links, deferred deep links, route matching, attribution
+ *
+ * @author Rajeev Kumar Joshi
+ * @license MIT
+ */
+export { DeepLinkRouter, getCommonRoutes } from "./router";
+export type {
+  DeepLinkRoute,
+  DeepLinkMatch,
+  DeferredDeepLink,
+  DeepLinkConfig,
+} from "./router";

package/src/router/index.ts

@@ -0,0 +1,271 @@
+/**
+ * @rajeev02/deeplink — Router
+ * Universal deep link router — pattern matching, parameter extraction,
+ * auth guards, deferred deep links, analytics attribution
+ */
+
+export interface DeepLinkRoute {
+  /** Pattern: "/product/:id", "/payment/:orderId/status", "/chat/:roomId" */
+  pattern: string;
+  /** Screen/page name to navigate to */
+  screen: string;
+  /** Required auth state ('authenticated' | 'any') */
+  authRequired?: boolean;
+  /** Handler function */
+  handler?: (
+    params: Record<string, string>,
+    query: Record<string, string>,
+  ) => void;
+}
+
+export interface DeepLinkMatch {
+  route: DeepLinkRoute;
+  params: Record<string, string>;
+  query: Record<string, string>;
+  fullUrl: string;
+}
+
+export interface DeferredDeepLink {
+  url: string;
+  timestamp: number;
+  source?: string;
+  campaign?: string;
+  processed: boolean;
+}
+
+export interface DeepLinkConfig {
+  /** App scheme (e.g., "rajeevapp://") */
+  scheme: string;
+  /** Universal link domains (e.g., ["rajeevapp.com", "link.rajeevapp.com"]) */
+  domains: string[];
+  /** Route definitions */
+  routes: DeepLinkRoute[];
+  /** Callback when no route matches */
+  onNoMatch?: (url: string) => void;
+  /** Callback for attribution tracking */
+  onAttribution?: (source: string, campaign?: string, medium?: string) => void;
+}
+
+/**
+ * Deep Link Router
+ */
+export class DeepLinkRouter {
+  private config: DeepLinkConfig;
+  private deferredLink: DeferredDeepLink | null = null;
+  private isReady: boolean = false;
+
+  constructor(config: DeepLinkConfig) {
+    this.config = config;
+  }
+
+  /** Mark the app as ready to handle deep links (after auth check, navigation ready) */
+  setReady(): void {
+    this.isReady = true;
+    if (this.deferredLink && !this.deferredLink.processed) {
+      this.handle(this.deferredLink.url);
+      this.deferredLink.processed = true;
+    }
+  }
+
+  /** Handle an incoming deep link URL */
+  handle(url: string): DeepLinkMatch | null {
+    const parsed = this.parseUrl(url);
+    if (!parsed) return null;
+
+    // Extract UTM params for attribution
+    if (parsed.query.utm_source && this.config.onAttribution) {
+      this.config.onAttribution(
+        parsed.query.utm_source,
+        parsed.query.utm_campaign,
+        parsed.query.utm_medium,
+      );
+    }
+
+    // If app not ready yet, defer the link
+    if (!this.isReady) {
+      this.deferredLink = {
+        url,
+        timestamp: Date.now(),
+        source: parsed.query.utm_source,
+        processed: false,
+      };
+      return null;
+    }
+
+    // Match against routes
+    for (const route of this.config.routes) {
+      const params = this.matchPattern(route.pattern, parsed.path);
+      if (params !== null) {
+        const match: DeepLinkMatch = {
+          route,
+          params,
+          query: parsed.query,
+          fullUrl: url,
+        };
+        if (route.handler) route.handler(params, parsed.query);
+        return match;
+      }
+    }
+
+    // No match
+    if (this.config.onNoMatch) this.config.onNoMatch(url);
+    return null;
+  }
+
+  /** Generate a deep link URL */
+  generate(
+    pattern: string,
+    params: Record<string, string> = {},
+    query: Record<string, string> = {},
+  ): string {
+    let path = pattern;
+    for (const [key, value] of Object.entries(params)) {
+      path = path.replace(`:${key}`, encodeURIComponent(value));
+    }
+    const queryStr = Object.entries(query)
+      .map(([k, v]) => `${k}=${encodeURIComponent(v)}`)
+      .join("&");
+    const base = `${this.config.scheme}${path}`;
+    return queryStr ? `${base}?${queryStr}` : base;
+  }
+
+  /** Generate a universal link (HTTPS) */
+  generateUniversalLink(
+    pattern: string,
+    params: Record<string, string> = {},
+    query: Record<string, string> = {},
+  ): string {
+    let path = pattern;
+    for (const [key, value] of Object.entries(params)) {
+      path = path.replace(`:${key}`, encodeURIComponent(value));
+    }
+    const queryStr = Object.entries(query)
+      .map(([k, v]) => `${k}=${encodeURIComponent(v)}`)
+      .join("&");
+    const domain = this.config.domains[0] || "app.example.com";
+    const base = `https://${domain}${path}`;
+    return queryStr ? `${base}?${queryStr}` : base;
+  }
+
+  /** Get deferred deep link (for cold start handling) */
+  getDeferredLink(): DeferredDeepLink | null {
+    return this.deferredLink;
+  }
+
+  /** Get all registered routes */
+  getRoutes(): DeepLinkRoute[] {
+    return [...this.config.routes];
+  }
+
+  /** Add a route dynamically */
+  addRoute(route: DeepLinkRoute): void {
+    this.config.routes.push(route);
+  }
+
+  private parseUrl(
+    url: string,
+  ): { path: string; query: Record<string, string> } | null {
+    try {
+      let path: string;
+      let queryStr: string = "";
+
+      if (url.includes("://")) {
+        const afterScheme = url.split("://")[1] || "";
+        // Remove domain for universal links
+        let pathPart = afterScheme;
+        for (const domain of this.config.domains) {
+          if (pathPart.startsWith(domain)) {
+            pathPart = pathPart.substring(domain.length);
+            break;
+          }
+        }
+        const [p, q] = pathPart.split("?");
+        path = p.startsWith("/") ? p : `/${p}`;
+        queryStr = q || "";
+      } else {
+        const [p, q] = url.split("?");
+        path = p.startsWith("/") ? p : `/${p}`;
+        queryStr = q || "";
+      }
+
+      const query: Record<string, string> = {};
+      if (queryStr) {
+        for (const pair of queryStr.split("&")) {
+          const [k, v] = pair.split("=");
+          if (k) query[decodeURIComponent(k)] = decodeURIComponent(v || "");
+        }
+      }
+
+      return { path, query };
+    } catch {
+      return null;
+    }
+  }
+
+  private matchPattern(
+    pattern: string,
+    path: string,
+  ): Record<string, string> | null {
+    const patternParts = pattern.split("/").filter(Boolean);
+    const pathParts = path.split("/").filter(Boolean);
+
+    if (patternParts.length !== pathParts.length) return null;
+
+    const params: Record<string, string> = {};
+    for (let i = 0; i < patternParts.length; i++) {
+      if (patternParts[i].startsWith(":")) {
+        params[patternParts[i].substring(1)] = decodeURIComponent(pathParts[i]);
+      } else if (patternParts[i] !== pathParts[i]) {
+        return null;
+      }
+    }
+    return params;
+  }
+}
+
+/**
+ * Common deep link routes for super apps
+ */
+export function getCommonRoutes(): DeepLinkRoute[] {
+  return [
+    { pattern: "/home", screen: "HomeScreen" },
+    { pattern: "/product/:id", screen: "ProductScreen" },
+    { pattern: "/product/:id/reviews", screen: "ReviewsScreen" },
+    { pattern: "/cart", screen: "CartScreen", authRequired: true },
+    { pattern: "/checkout", screen: "CheckoutScreen", authRequired: true },
+    {
+      pattern: "/order/:orderId",
+      screen: "OrderDetailScreen",
+      authRequired: true,
+    },
+    {
+      pattern: "/order/:orderId/track",
+      screen: "OrderTrackingScreen",
+      authRequired: true,
+    },
+    {
+      pattern: "/payment/:txnId/status",
+      screen: "PaymentStatusScreen",
+      authRequired: true,
+    },
+    { pattern: "/chat/:roomId", screen: "ChatScreen", authRequired: true },
+    { pattern: "/profile", screen: "ProfileScreen", authRequired: true },
+    {
+      pattern: "/profile/settings",
+      screen: "SettingsScreen",
+      authRequired: true,
+    },
+    {
+      pattern: "/notifications",
+      screen: "NotificationsScreen",
+      authRequired: true,
+    },
+    { pattern: "/scan", screen: "QrScanScreen" },
+    { pattern: "/pay", screen: "PaymentScreen", authRequired: true },
+    { pattern: "/pay/:vpa", screen: "PayToVpaScreen", authRequired: true },
+    { pattern: "/refer", screen: "ReferralScreen" },
+    { pattern: "/offers", screen: "OffersScreen" },
+    { pattern: "/help", screen: "HelpScreen" },
+    { pattern: "/kyc", screen: "KycScreen", authRequired: true },
+  ];
+}