@webiny/app 0.0.0-unstable.e53eceafb5 → 0.0.0-unstable.e6f0dc8ca7

package/features/router/HistoryRouterGateway.test.js

@@ -0,0 +1,204 @@
+import { describe, it, beforeEach, expect, vi } from "vitest";
+import { createMemoryHistory } from "history";
+import { HistoryRouterGateway } from "./HistoryRouterGateway.js";
+import { RouteUrl } from "./RouteUrl.js";
+const wait = () => new Promise(resolve => setTimeout(resolve, 10));
+describe("Router Gateway", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  it("should execute onMatch when history changes", async () => {
+    const spyHome = vi.fn();
+    const spyLogin = vi.fn();
+    const spyDynamic = vi.fn();
+
+    // Create `history` and set the initial pathname to an unknown route
+    const history = createMemoryHistory();
+    history.replace("/__unknown__");
+    const gateway = new HistoryRouterGateway(history, "");
+    gateway.setRoutes([{
+      name: "home",
+      path: "/",
+      onMatch: spyHome
+    }, {
+      name: "login",
+      path: "/login",
+      onMatch: spyLogin
+    }, {
+      name: "test",
+      path: "/dynamic-route/:name",
+      onMatch: spyDynamic
+    }]);
+    history.push("/login");
+    await wait();
+    history.push("/");
+    await wait();
+    history.push("/dynamic-route/cars");
+    await wait();
+    history.push("/login");
+    await wait();
+    history.push("/dynamic-route/blogs");
+    await wait();
+    history.push("/dynamic-route/blogs?search=123");
+    await wait();
+    expect(spyLogin).toHaveBeenCalledTimes(2);
+    expect(spyLogin).toHaveBeenNthCalledWith(1, {
+      name: "login",
+      path: "/login",
+      pathname: "/login",
+      params: {}
+    });
+    expect(spyLogin).toHaveBeenNthCalledWith(2, {
+      name: "login",
+      path: "/login",
+      pathname: "/login",
+      params: {}
+    });
+    expect(spyHome).toHaveBeenCalledTimes(1);
+    expect(spyHome).toHaveBeenLastCalledWith({
+      name: "home",
+      path: "/",
+      pathname: "/",
+      params: {}
+    });
+    expect(spyDynamic).toHaveBeenCalledTimes(3);
+    expect(spyDynamic).toHaveBeenNthCalledWith(1, {
+      name: "test",
+      path: "/dynamic-route/:name",
+      pathname: "/dynamic-route/cars",
+      params: {
+        name: "cars"
+      }
+    });
+    expect(spyDynamic).toHaveBeenNthCalledWith(2, {
+      name: "test",
+      path: "/dynamic-route/:name",
+      pathname: "/dynamic-route/blogs",
+      params: {
+        name: "blogs"
+      }
+    });
+    expect(spyDynamic).toHaveBeenNthCalledWith(3, {
+      name: "test",
+      path: "/dynamic-route/:name",
+      pathname: "/dynamic-route/blogs",
+      params: {
+        name: "blogs",
+        search: "123"
+      }
+    });
+  });
+  it("should generate route URLs", async () => {
+    const urls = [RouteUrl.fromPattern("/"), RouteUrl.fromPattern("/login", {}), RouteUrl.fromPattern("/login", {
+      redirect: "/",
+      reason: "login"
+    }), RouteUrl.fromPattern("/dynamic-route/:name", {
+      name: "cars"
+    }), RouteUrl.fromPattern("/dynamic-route", {
+      folderId: "696556831e485d00027a1a0b#0001"
+    })];
+    expect(urls).toEqual(["/", "/login", "/login?redirect=%2F&reason=login", "/dynamic-route/cars", "/dynamic-route?folderId=696556831e485d00027a1a0b%230001"]);
+  });
+  it("should handle baseUrl for route matching and URL generation", async () => {
+    const spyFileManager = vi.fn();
+    const spyHome = vi.fn();
+
+    // Create history with a tenant prefix
+    const history = createMemoryHistory();
+    history.replace("/tenant123/__unknown__");
+    const gateway = new HistoryRouterGateway(history, "/tenant123");
+    gateway.setRoutes([{
+      name: "home",
+      path: "/",
+      onMatch: spyHome
+    }, {
+      name: "fileManager",
+      path: "/file-manager",
+      onMatch: spyFileManager
+    }]);
+
+    // Navigate to /tenant123/file-manager
+    history.push("/tenant123/file-manager");
+    await wait();
+
+    // Should match the /file-manager route
+    expect(spyFileManager).toHaveBeenCalledTimes(1);
+    expect(spyFileManager).toHaveBeenCalledWith({
+      name: "fileManager",
+      path: "/file-manager",
+      pathname: "/tenant123/file-manager",
+      params: {}
+    });
+
+    // Test URL generation with baseUrl
+    const urlWithBase = RouteUrl.fromPattern("/file-manager", {}, "/tenant123");
+    expect(urlWithBase).toBe("/tenant123/file-manager");
+    const urlWithBaseAndParams = RouteUrl.fromPattern("/file-manager", {
+      folder: "abc"
+    }, "/tenant123");
+    expect(urlWithBaseAndParams).toBe("/tenant123/file-manager?folder=abc");
+  });
+  it("should properly sort routes with wildcards always at the bottom", async () => {
+    const spyWildcard = vi.fn();
+    const spySpecific = vi.fn();
+    const spyHome = vi.fn();
+    const history = createMemoryHistory();
+    // Start at a non-matching path to avoid initial route resolution
+    history.replace("/initial");
+    const gateway = new HistoryRouterGateway(history, "");
+
+    // Add wildcard first, then home route
+    // Note: setRoutes will trigger route resolution for current path (/initial)
+    gateway.setRoutes([{
+      name: "wildcard",
+      path: "*",
+      onMatch: spyWildcard
+    }, {
+      name: "home",
+      path: "/",
+      onMatch: spyHome
+    }]);
+
+    // Wildcard should have matched /initial
+    expect(spyWildcard).toHaveBeenCalledTimes(1);
+    vi.clearAllMocks();
+
+    // Now add a specific route after the wildcard - this should re-sort and keep wildcard at bottom
+    // Note: setRoutes will trigger route resolution again for /initial, matching wildcard again
+    gateway.setRoutes([{
+      name: "specific",
+      path: "/specific-route",
+      onMatch: spySpecific
+    }]);
+
+    // Wildcard should match /initial again after re-sorting
+    expect(spyWildcard).toHaveBeenCalledTimes(1);
+    vi.clearAllMocks();
+
+    // Navigate to the specific route
+    history.push("/specific-route");
+    await wait();
+
+    // Should match the specific route, not the wildcard
+    expect(spySpecific).toHaveBeenCalledTimes(1);
+    expect(spyWildcard).toHaveBeenCalledTimes(0);
+    expect(spyHome).toHaveBeenCalledTimes(0);
+
+    // Navigate to home
+    history.push("/");
+    await wait();
+
+    // Should match home route
+    expect(spyHome).toHaveBeenCalledTimes(1);
+    expect(spyWildcard).toHaveBeenCalledTimes(0);
+
+    // Navigate to unknown route
+    history.push("/unknown");
+    await wait();
+
+    // Should match wildcard
+    expect(spyWildcard).toHaveBeenCalledTimes(1);
+  });
+});
+
+//# sourceMappingURL=HistoryRouterGateway.test.js.map

package/features/router/HistoryRouterGateway.test.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["describe","it","beforeEach","expect","vi","createMemoryHistory","HistoryRouterGateway","RouteUrl","wait","Promise","resolve","setTimeout","clearAllMocks","spyHome","fn","spyLogin","spyDynamic","history","replace","gateway","setRoutes","name","path","onMatch","push","toHaveBeenCalledTimes","toHaveBeenNthCalledWith","pathname","params","toHaveBeenLastCalledWith","search","urls","fromPattern","redirect","reason","folderId","toEqual","spyFileManager","toHaveBeenCalledWith","urlWithBase","toBe","urlWithBaseAndParams","folder","spyWildcard","spySpecific"],"sources":["HistoryRouterGateway.test.ts"],"sourcesContent":["import { describe, it, beforeEach, expect, vi } from \"vitest\";\nimport { createMemoryHistory } from \"history\";\nimport { HistoryRouterGateway } from \"./HistoryRouterGateway.js\";\nimport { RouteUrl } from \"./RouteUrl.js\";\n\nconst wait = () => new Promise(resolve => setTimeout(resolve, 10));\n\ndescribe(\"Router Gateway\", () => {\n    beforeEach(() => {\n        vi.clearAllMocks();\n    });\n\n    it(\"should execute onMatch when history changes\", async () => {\n        const spyHome = vi.fn();\n        const spyLogin = vi.fn();\n        const spyDynamic = vi.fn();\n\n        // Create `history` and set the initial pathname to an unknown route\n        const history = createMemoryHistory();\n        history.replace(\"/__unknown__\");\n\n        const gateway = new HistoryRouterGateway(history, \"\");\n        gateway.setRoutes([\n            { name: \"home\", path: \"/\", onMatch: spyHome },\n            { name: \"login\", path: \"/login\", onMatch: spyLogin },\n            { name: \"test\", path: \"/dynamic-route/:name\", onMatch: spyDynamic }\n        ]);\n\n        history.push(\"/login\");\n        await wait();\n        history.push(\"/\");\n        await wait();\n        history.push(\"/dynamic-route/cars\");\n        await wait();\n        history.push(\"/login\");\n        await wait();\n        history.push(\"/dynamic-route/blogs\");\n        await wait();\n        history.push(\"/dynamic-route/blogs?search=123\");\n        await wait();\n\n        expect(spyLogin).toHaveBeenCalledTimes(2);\n        expect(spyLogin).toHaveBeenNthCalledWith(1, {\n            name: \"login\",\n            path: \"/login\",\n            pathname: \"/login\",\n            params: {}\n        });\n        expect(spyLogin).toHaveBeenNthCalledWith(2, {\n            name: \"login\",\n            path: \"/login\",\n            pathname: \"/login\",\n            params: {}\n        });\n        expect(spyHome).toHaveBeenCalledTimes(1);\n        expect(spyHome).toHaveBeenLastCalledWith({\n            name: \"home\",\n            path: \"/\",\n            pathname: \"/\",\n            params: {}\n        });\n        expect(spyDynamic).toHaveBeenCalledTimes(3);\n        expect(spyDynamic).toHaveBeenNthCalledWith(1, {\n            name: \"test\",\n            path: \"/dynamic-route/:name\",\n            pathname: \"/dynamic-route/cars\",\n            params: {\n                name: \"cars\"\n            }\n        });\n        expect(spyDynamic).toHaveBeenNthCalledWith(2, {\n            name: \"test\",\n            path: \"/dynamic-route/:name\",\n            pathname: \"/dynamic-route/blogs\",\n            params: {\n                name: \"blogs\"\n            }\n        });\n        expect(spyDynamic).toHaveBeenNthCalledWith(3, {\n            name: \"test\",\n            path: \"/dynamic-route/:name\",\n            pathname: \"/dynamic-route/blogs\",\n            params: {\n                name: \"blogs\",\n                search: \"123\"\n            }\n        });\n    });\n\n    it(\"should generate route URLs\", async () => {\n        const urls = [\n            RouteUrl.fromPattern(\"/\"),\n            RouteUrl.fromPattern(\"/login\", {}),\n            RouteUrl.fromPattern(\"/login\", { redirect: \"/\", reason: \"login\" }),\n            RouteUrl.fromPattern(\"/dynamic-route/:name\", { name: \"cars\" }),\n            RouteUrl.fromPattern(\"/dynamic-route\", { folderId: \"696556831e485d00027a1a0b#0001\" })\n        ];\n        expect(urls).toEqual([\n            \"/\",\n            \"/login\",\n            \"/login?redirect=%2F&reason=login\",\n            \"/dynamic-route/cars\",\n            \"/dynamic-route?folderId=696556831e485d00027a1a0b%230001\"\n        ]);\n    });\n\n    it(\"should handle baseUrl for route matching and URL generation\", async () => {\n        const spyFileManager = vi.fn();\n        const spyHome = vi.fn();\n\n        // Create history with a tenant prefix\n        const history = createMemoryHistory();\n        history.replace(\"/tenant123/__unknown__\");\n\n        const gateway = new HistoryRouterGateway(history, \"/tenant123\");\n        gateway.setRoutes([\n            { name: \"home\", path: \"/\", onMatch: spyHome },\n            { name: \"fileManager\", path: \"/file-manager\", onMatch: spyFileManager }\n        ]);\n\n        // Navigate to /tenant123/file-manager\n        history.push(\"/tenant123/file-manager\");\n        await wait();\n\n        // Should match the /file-manager route\n        expect(spyFileManager).toHaveBeenCalledTimes(1);\n        expect(spyFileManager).toHaveBeenCalledWith({\n            name: \"fileManager\",\n            path: \"/file-manager\",\n            pathname: \"/tenant123/file-manager\",\n            params: {}\n        });\n\n        // Test URL generation with baseUrl\n        const urlWithBase = RouteUrl.fromPattern(\"/file-manager\", {}, \"/tenant123\");\n        expect(urlWithBase).toBe(\"/tenant123/file-manager\");\n\n        const urlWithBaseAndParams = RouteUrl.fromPattern(\n            \"/file-manager\",\n            { folder: \"abc\" },\n            \"/tenant123\"\n        );\n        expect(urlWithBaseAndParams).toBe(\"/tenant123/file-manager?folder=abc\");\n    });\n\n    it(\"should properly sort routes with wildcards always at the bottom\", async () => {\n        const spyWildcard = vi.fn();\n        const spySpecific = vi.fn();\n        const spyHome = vi.fn();\n\n        const history = createMemoryHistory();\n        // Start at a non-matching path to avoid initial route resolution\n        history.replace(\"/initial\");\n\n        const gateway = new HistoryRouterGateway(history, \"\");\n\n        // Add wildcard first, then home route\n        // Note: setRoutes will trigger route resolution for current path (/initial)\n        gateway.setRoutes([\n            { name: \"wildcard\", path: \"*\", onMatch: spyWildcard },\n            { name: \"home\", path: \"/\", onMatch: spyHome }\n        ]);\n\n        // Wildcard should have matched /initial\n        expect(spyWildcard).toHaveBeenCalledTimes(1);\n        vi.clearAllMocks();\n\n        // Now add a specific route after the wildcard - this should re-sort and keep wildcard at bottom\n        // Note: setRoutes will trigger route resolution again for /initial, matching wildcard again\n        gateway.setRoutes([{ name: \"specific\", path: \"/specific-route\", onMatch: spySpecific }]);\n\n        // Wildcard should match /initial again after re-sorting\n        expect(spyWildcard).toHaveBeenCalledTimes(1);\n        vi.clearAllMocks();\n\n        // Navigate to the specific route\n        history.push(\"/specific-route\");\n        await wait();\n\n        // Should match the specific route, not the wildcard\n        expect(spySpecific).toHaveBeenCalledTimes(1);\n        expect(spyWildcard).toHaveBeenCalledTimes(0);\n        expect(spyHome).toHaveBeenCalledTimes(0);\n\n        // Navigate to home\n        history.push(\"/\");\n        await wait();\n\n        // Should match home route\n        expect(spyHome).toHaveBeenCalledTimes(1);\n        expect(spyWildcard).toHaveBeenCalledTimes(0);\n\n        // Navigate to unknown route\n        history.push(\"/unknown\");\n        await wait();\n\n        // Should match wildcard\n        expect(spyWildcard).toHaveBeenCalledTimes(1);\n    });\n});\n"],"mappings":"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","ignoreList":[]}

package/features/router/Route.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+export type RouteParamsDefinition = Record<string, z.ZodTypeAny>;
+export type RouteParamsInfer<T extends RouteParamsDefinition | undefined> = T extends RouteParamsDefinition ? z.infer<z.ZodObject<T> & {
+    [k: string]: any;
+}> : never;
+export interface RouteParams<TParams extends RouteParamsDefinition | undefined> {
+    name: string;
+    path: `/${string}` | `*`;
+    params?: (zod: typeof z) => TParams;
+}
+export declare class Route<TParams extends RouteParamsDefinition | undefined = undefined> {
+    private readonly route;
+    private readonly schema;
+    constructor(route: RouteParams<TParams>);
+    get name(): string;
+    get path(): `/${string}` | "*";
+    get params(): TParams extends RouteParamsDefinition ? RouteParamsInfer<TParams> : undefined;
+    private coerceParams;
+}

package/features/router/Route.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+export class Route {
+  constructor(route) {
+    this.route = route;
+    const paramsSchema = route.params ? route.params(z) : undefined;
+    // @ts-expect-error
+    this.schema = paramsSchema ? z.looseObject(this.coerceParams(paramsSchema)) : undefined;
+  }
+  get name() {
+    return this.route.name;
+  }
+  get path() {
+    return this.route.path;
+  }
+  get params() {
+    return this.schema;
+  }
+  coerceParams(shape) {
+    const result = {};
+    for (const [key, schema] of Object.entries(shape)) {
+      let base = schema;
+      let isOptional = false;
+      let isNullable = false;
+
+      // unwrap optional
+      if (base instanceof z.ZodOptional) {
+        isOptional = true;
+        base = base.unwrap();
+      }
+
+      // unwrap nullable
+      if (base instanceof z.ZodNullable) {
+        isNullable = true;
+        base = base.unwrap();
+      }
+
+      // replace with coerced
+      if (base instanceof z.ZodString) {
+        base = z.coerce.string();
+      } else if (base instanceof z.ZodNumber) {
+        base = z.coerce.number();
+      } else if (base instanceof z.ZodBoolean) {
+        base = z.coerce.boolean();
+      }
+
+      // rewrap optional/nullable
+      if (isNullable) {
+        base = base.nullable();
+      }
+      if (isOptional) {
+        base = base.optional();
+      }
+      result[key] = base;
+    }
+    return result;
+  }
+}
+
+//# sourceMappingURL=Route.js.map

package/features/router/Route.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["z","Route","constructor","route","paramsSchema","params","undefined","schema","looseObject","coerceParams","name","path","shape","result","key","Object","entries","base","isOptional","isNullable","ZodOptional","unwrap","ZodNullable","ZodString","coerce","string","ZodNumber","number","ZodBoolean","boolean","nullable","optional"],"sources":["Route.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport type RouteParamsDefinition = Record<string, z.ZodTypeAny>;\n\nexport type RouteParamsInfer<T extends RouteParamsDefinition | undefined> =\n    T extends RouteParamsDefinition ? z.infer<z.ZodObject<T> & { [k: string]: any }> : never;\n\nexport interface RouteParams<TParams extends RouteParamsDefinition | undefined> {\n    name: string;\n    path: `/${string}` | `*`;\n    params?: (zod: typeof z) => TParams;\n}\n\nexport class Route<TParams extends RouteParamsDefinition | undefined = undefined> {\n    private readonly route: RouteParams<TParams>;\n    private readonly schema: TParams extends RouteParamsDefinition\n        ? RouteParamsInfer<TParams>\n        : undefined;\n\n    constructor(route: RouteParams<TParams>) {\n        this.route = route;\n        const paramsSchema = route.params ? route.params(z) : undefined;\n        // @ts-expect-error\n        this.schema = paramsSchema ? z.looseObject(this.coerceParams(paramsSchema)) : undefined;\n    }\n\n    get name() {\n        return this.route.name;\n    }\n\n    get path() {\n        return this.route.path;\n    }\n\n    get params(): TParams extends RouteParamsDefinition ? RouteParamsInfer<TParams> : undefined {\n        return this.schema;\n    }\n\n    private coerceParams<T extends Record<string, z.ZodTypeAny>>(shape: T) {\n        const result: Record<string, z.ZodTypeAny> = {};\n        for (const [key, schema] of Object.entries(shape)) {\n            let base = schema as z.ZodTypeAny;\n            let isOptional = false;\n            let isNullable = false;\n\n            // unwrap optional\n            if (base instanceof z.ZodOptional) {\n                isOptional = true;\n                base = base.unwrap() as z.ZodTypeAny;\n            }\n\n            // unwrap nullable\n            if (base instanceof z.ZodNullable) {\n                isNullable = true;\n                base = base.unwrap() as z.ZodTypeAny;\n            }\n\n            // replace with coerced\n            if (base instanceof z.ZodString) {\n                base = z.coerce.string();\n            } else if (base instanceof z.ZodNumber) {\n                base = z.coerce.number();\n            } else if (base instanceof z.ZodBoolean) {\n                base = z.coerce.boolean();\n            }\n\n            // rewrap optional/nullable\n            if (isNullable) {\n                base = base.nullable();\n            }\n            if (isOptional) {\n                base = base.optional();\n            }\n\n            result[key] = base;\n        }\n        return result;\n    }\n}\n"],"mappings":"AAAA,SAASA,CAAC,QAAQ,KAAK;AAavB,OAAO,MAAMC,KAAK,CAAgE;EAM9EC,WAAWA,CAACC,KAA2B,EAAE;IACrC,IAAI,CAACA,KAAK,GAAGA,KAAK;IAClB,MAAMC,YAAY,GAAGD,KAAK,CAACE,MAAM,GAAGF,KAAK,CAACE,MAAM,CAACL,CAAC,CAAC,GAAGM,SAAS;IAC/D;IACA,IAAI,CAACC,MAAM,GAAGH,YAAY,GAAGJ,CAAC,CAACQ,WAAW,CAAC,IAAI,CAACC,YAAY,CAACL,YAAY,CAAC,CAAC,GAAGE,SAAS;EAC3F;EAEA,IAAII,IAAIA,CAAA,EAAG;IACP,OAAO,IAAI,CAACP,KAAK,CAACO,IAAI;EAC1B;EAEA,IAAIC,IAAIA,CAAA,EAAG;IACP,OAAO,IAAI,CAACR,KAAK,CAACQ,IAAI;EAC1B;EAEA,IAAIN,MAAMA,CAAA,EAAkF;IACxF,OAAO,IAAI,CAACE,MAAM;EACtB;EAEQE,YAAYA,CAAyCG,KAAQ,EAAE;IACnE,MAAMC,MAAoC,GAAG,CAAC,CAAC;IAC/C,KAAK,MAAM,CAACC,GAAG,EAAEP,MAAM,CAAC,IAAIQ,MAAM,CAACC,OAAO,CAACJ,KAAK,CAAC,EAAE;MAC/C,IAAIK,IAAI,GAAGV,MAAsB;MACjC,IAAIW,UAAU,GAAG,KAAK;MACtB,IAAIC,UAAU,GAAG,KAAK;;MAEtB;MACA,IAAIF,IAAI,YAAYjB,CAAC,CAACoB,WAAW,EAAE;QAC/BF,UAAU,GAAG,IAAI;QACjBD,IAAI,GAAGA,IAAI,CAACI,MAAM,CAAC,CAAiB;MACxC;;MAEA;MACA,IAAIJ,IAAI,YAAYjB,CAAC,CAACsB,WAAW,EAAE;QAC/BH,UAAU,GAAG,IAAI;QACjBF,IAAI,GAAGA,IAAI,CAACI,MAAM,CAAC,CAAiB;MACxC;;MAEA;MACA,IAAIJ,IAAI,YAAYjB,CAAC,CAACuB,SAAS,EAAE;QAC7BN,IAAI,GAAGjB,CAAC,CAACwB,MAAM,CAACC,MAAM,CAAC,CAAC;MAC5B,CAAC,MAAM,IAAIR,IAAI,YAAYjB,CAAC,CAAC0B,SAAS,EAAE;QACpCT,IAAI,GAAGjB,CAAC,CAACwB,MAAM,CAACG,MAAM,CAAC,CAAC;MAC5B,CAAC,MAAM,IAAIV,IAAI,YAAYjB,CAAC,CAAC4B,UAAU,EAAE;QACrCX,IAAI,GAAGjB,CAAC,CAACwB,MAAM,CAACK,OAAO,CAAC,CAAC;MAC7B;;MAEA;MACA,IAAIV,UAAU,EAAE;QACZF,IAAI,GAAGA,IAAI,CAACa,QAAQ,CAAC,CAAC;MAC1B;MACA,IAAIZ,UAAU,EAAE;QACZD,IAAI,GAAGA,IAAI,CAACc,QAAQ,CAAC,CAAC;MAC1B;MAEAlB,MAAM,CAACC,GAAG,CAAC,GAAGG,IAAI;IACtB;IACA,OAAOJ,MAAM;EACjB;AACJ","ignoreList":[]}

package/features/router/RouteUrl.d.ts

@@ -0,0 +1,85 @@
+interface Params {
+    [key: string]: any;
+}
+interface MatchResult {
+    params: Record<string, string>;
+}
+/**
+ * Utility class for route URL pattern matching and generation.
+ * Handles simple route patterns with :param syntax (e.g., /cms/entries/:modelId).
+ *
+ * Public API uses static methods, which internally construct RouteUrl instances
+ * to handle the logic through proper instance methods.
+ */
+export declare class RouteUrl {
+    private static patternCache;
+    private readonly pattern;
+    private readonly params;
+    private readonly baseUrl;
+    private constructor();
+    /**
+     * Generate a URL from a route pattern and parameters.
+     * Path parameters are injected into the pattern, remaining parameters become query strings.
+     *
+     * @param pattern - Route pattern (e.g., '/security/api-keys/:id')
+     * @param params - Parameters object (e.g., { id: 123, new: true })
+     * @param baseUrl - Optional base URL to prepend (e.g., '/tenant123')
+     * @returns Generated URL string
+     *
+     * @example
+     * RouteUrl.fromPattern('/security/api-keys/:id', { id: 123, new: true })
+     * // Returns: '/security/api-keys/123?new=true'
+     *
+     * @example
+     * RouteUrl.fromPattern('/file-manager', {}, '/tenant123')
+     * // Returns: '/tenant123/file-manager'
+     */
+    static fromPattern(pattern: string, params?: Params, baseUrl?: string): string;
+    /**
+     * Match a pathname against a route pattern and extract parameters.
+     * If baseUrl is provided, it will be stripped from the pathname before matching.
+     *
+     * @param pathname - The pathname to match (e.g., '/tenant123/security/api-keys/123')
+     * @param pattern - Route pattern (e.g., '/security/api-keys/:id')
+     * @param baseUrl - Optional base URL to strip before matching (e.g., '/tenant123')
+     * @returns Object with extracted params if matched, null otherwise
+     *
+     * @example
+     * RouteUrl.match('/security/api-keys/123', '/security/api-keys/:id')
+     * // Returns: { params: { id: '123' } }
+     *
+     * @example
+     * RouteUrl.match('/tenant123/file-manager', '/file-manager', '/tenant123')
+     * // Returns: { params: {} }
+     */
+    static match(pathname: string, pattern: string, baseUrl?: string): MatchResult | null;
+    /**
+     * Generate a URL from the instance's pattern, params, and baseUrl.
+     */
+    private generate;
+    /**
+     * Match a pathname against the instance's pattern.
+     */
+    private matchPathname;
+    /**
+     * Extract path parameter names from the pattern.
+     */
+    private extractPathKeys;
+    /**
+     * Replace :param placeholders with actual values from params.
+     */
+    private replacePathParams;
+    /**
+     * Build query string from params that are not path parameters.
+     */
+    private buildQueryString;
+    /**
+     * Normalize baseUrl by ensuring it starts with / and doesn't end with /
+     */
+    private normalizeBaseUrl;
+    /**
+     * Compile the instance's pattern into a regex and extract parameter names.
+     */
+    private compilePattern;
+}
+export {};

package/features/router/RouteUrl.js

@@ -0,0 +1,232 @@
+/**
+ * Utility class for route URL pattern matching and generation.
+ * Handles simple route patterns with :param syntax (e.g., /cms/entries/:modelId).
+ *
+ * Public API uses static methods, which internally construct RouteUrl instances
+ * to handle the logic through proper instance methods.
+ */
+export class RouteUrl {
+  static patternCache = new Map();
+  constructor(pattern, params, baseUrl) {
+    this.pattern = pattern;
+    this.params = params;
+    this.baseUrl = this.normalizeBaseUrl(baseUrl);
+  }
+
+  /**
+   * Generate a URL from a route pattern and parameters.
+   * Path parameters are injected into the pattern, remaining parameters become query strings.
+   *
+   * @param pattern - Route pattern (e.g., '/security/api-keys/:id')
+   * @param params - Parameters object (e.g., { id: 123, new: true })
+   * @param baseUrl - Optional base URL to prepend (e.g., '/tenant123')
+   * @returns Generated URL string
+   *
+   * @example
+   * RouteUrl.fromPattern('/security/api-keys/:id', { id: 123, new: true })
+   * // Returns: '/security/api-keys/123?new=true'
+   *
+   * @example
+   * RouteUrl.fromPattern('/file-manager', {}, '/tenant123')
+   * // Returns: '/tenant123/file-manager'
+   */
+  static fromPattern(pattern, params, baseUrl) {
+    const routeUrl = new RouteUrl(pattern, params, baseUrl);
+    return routeUrl.generate();
+  }
+
+  /**
+   * Match a pathname against a route pattern and extract parameters.
+   * If baseUrl is provided, it will be stripped from the pathname before matching.
+   *
+   * @param pathname - The pathname to match (e.g., '/tenant123/security/api-keys/123')
+   * @param pattern - Route pattern (e.g., '/security/api-keys/:id')
+   * @param baseUrl - Optional base URL to strip before matching (e.g., '/tenant123')
+   * @returns Object with extracted params if matched, null otherwise
+   *
+   * @example
+   * RouteUrl.match('/security/api-keys/123', '/security/api-keys/:id')
+   * // Returns: { params: { id: '123' } }
+   *
+   * @example
+   * RouteUrl.match('/tenant123/file-manager', '/file-manager', '/tenant123')
+   * // Returns: { params: {} }
+   */
+  static match(pathname, pattern, baseUrl) {
+    const routeUrl = new RouteUrl(pattern, undefined, baseUrl);
+    return routeUrl.matchPathname(pathname);
+  }
+
+  /**
+   * Generate a URL from the instance's pattern, params, and baseUrl.
+   */
+  generate() {
+    if (!this.params) {
+      return this.baseUrl + this.pattern;
+    }
+
+    // Extract path parameter names from pattern
+    const pathKeys = this.extractPathKeys();
+
+    // Replace :param with actual values
+    let url = this.replacePathParams();
+
+    // Handle empty url
+    if (!url || url === "") {
+      url = "/";
+    }
+
+    // Prepend baseUrl
+    url = this.baseUrl + url;
+
+    // Add query parameters for keys not used in the path
+    const queryString = this.buildQueryString(pathKeys);
+    if (queryString) {
+      url += `?${queryString}`;
+    }
+    return url;
+  }
+
+  /**
+   * Match a pathname against the instance's pattern.
+   */
+  matchPathname(pathname) {
+    // Strip baseUrl from pathname if provided
+    if (this.baseUrl && pathname.startsWith(this.baseUrl)) {
+      pathname = pathname.slice(this.baseUrl.length) || "/";
+    } else if (this.baseUrl) {
+      // pathname doesn't start with baseUrl, no match
+      return null;
+    }
+
+    // Handle wildcard pattern
+    if (this.pattern === "*" || this.pattern === "(.*)") {
+      return {
+        params: {}
+      };
+    }
+
+    // Get or create cached pattern
+    let compiled = RouteUrl.patternCache.get(this.pattern);
+    if (!compiled) {
+      compiled = this.compilePattern();
+      RouteUrl.patternCache.set(this.pattern, compiled);
+    }
+    const match = pathname.match(compiled.regex);
+    if (!match) {
+      return null;
+    }
+
+    // Extract parameters from capture groups
+    const params = {};
+    compiled.keys.forEach((key, index) => {
+      const value = match[index + 1];
+      if (value !== undefined) {
+        params[key] = decodeURIComponent(value);
+      }
+    });
+    return {
+      params
+    };
+  }
+
+  /**
+   * Extract path parameter names from the pattern.
+   */
+  extractPathKeys() {
+    const pathKeys = new Set();
+    const paramRegex = /:([a-zA-Z_][a-zA-Z0-9_]*)/g;
+    let match;
+    while ((match = paramRegex.exec(this.pattern)) !== null) {
+      pathKeys.add(match[1]);
+    }
+    return pathKeys;
+  }
+
+  /**
+   * Replace :param placeholders with actual values from params.
+   */
+  replacePathParams() {
+    return this.pattern.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, (_, key) => {
+      const value = this.params[key];
+      if (value === undefined || value === null) {
+        return "";
+      }
+      return encodeURIComponent(String(value));
+    });
+  }
+
+  /**
+   * Build query string from params that are not path parameters.
+   */
+  buildQueryString(pathKeys) {
+    const queryParams = {};
+    for (const key in this.params) {
+      if (!pathKeys.has(key)) {
+        queryParams[key] = this.params[key];
+      }
+    }
+    if (Object.keys(queryParams).length === 0) {
+      return "";
+    }
+    const searchParams = new URLSearchParams();
+    for (const key in queryParams) {
+      const value = queryParams[key];
+      if (value !== undefined && value !== null) {
+        if (Array.isArray(value)) {
+          value.forEach(v => searchParams.append(key, String(v)));
+        } else {
+          searchParams.append(key, String(value));
+        }
+      }
+    }
+    return searchParams.toString();
+  }
+
+  /**
+   * Normalize baseUrl by ensuring it starts with / and doesn't end with /
+   */
+  normalizeBaseUrl(baseUrl) {
+    if (!baseUrl || baseUrl === "/") {
+      return "";
+    }
+    let normalized = baseUrl;
+
+    // Ensure it starts with /
+    if (!normalized.startsWith("/")) {
+      normalized = "/" + normalized;
+    }
+
+    // Remove trailing /
+    if (normalized.endsWith("/")) {
+      normalized = normalized.slice(0, -1);
+    }
+    return normalized;
+  }
+
+  /**
+   * Compile the instance's pattern into a regex and extract parameter names.
+   */
+  compilePattern() {
+    const keys = [];
+
+    // Escape special regex characters except for :param syntax
+    let regexPattern = this.pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&") // Escape special chars
+    .replace(/\\\*/g, ".*"); // Handle * wildcard (already escaped by above)
+
+    // Replace :param with capture groups
+    regexPattern = regexPattern.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, (_, key) => {
+      keys.push(key);
+      return "([^/]+)"; // Match any non-slash characters
+    });
+
+    // Create regex that matches the entire pathname
+    const regex = new RegExp(`^${regexPattern}$`);
+    return {
+      regex,
+      keys
+    };
+  }
+}
+
+//# sourceMappingURL=RouteUrl.js.map