@webiny/app 6.0.0-beta.0 → 6.0.0-rc.0

package/features/router/RouteUrl.js.map

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

package/features/router/Router.d.ts

@@ -0,0 +1,45 @@
+import type { RouteDefinition, MatchedRoute } from "./abstractions.js";
+interface ResolveResult {
+    matchedRoute: MatchedRoute;
+    onMatch: (route: MatchedRoute) => void;
+}
+/**
+ * Router manages a collection of route definitions and resolves pathnames to matched routes.
+ */
+export declare class Router {
+    private routes;
+    private baseUrl;
+    constructor(baseUrl?: string);
+    /**
+     * Set or update route definitions. Routes with the same name will be replaced.
+     *
+     * @param routes - Array of route definitions to add
+     */
+    setRoutes(routes: RouteDefinition[]): void;
+    /**
+     * Find a route by name.
+     *
+     * @param name - Route name to find
+     * @returns Route definition if found, undefined otherwise
+     */
+    findRoute(name: string): RouteDefinition | undefined;
+    /**
+     * Resolve a pathname to a matched route.
+     * The pathname will be matched against patterns after stripping the baseUrl.
+     *
+     * @param pathname - The pathname to resolve (e.g., '/tenant123/cms/entries/123')
+     * @param queryParams - Optional query parameters to merge into route params
+     * @returns Matched route with onMatch callback, or null if no route matches
+     */
+    resolve(pathname: string, queryParams?: Record<string, unknown>): ResolveResult | null;
+    /**
+     * Get the current baseUrl.
+     */
+    getBaseUrl(): string;
+    /**
+     * Sort routes to ensure proper matching order.
+     * Wildcard routes (*) and index routes (/) are moved to the bottom.
+     */
+    private sortRoutes;
+}
+export {};

package/features/router/Router.js

@@ -0,0 +1,129 @@
+import { RouteUrl } from "./RouteUrl.js";
+/**
+ * Router manages a collection of route definitions and resolves pathnames to matched routes.
+ */
+export class Router {
+  routes = [];
+  constructor(baseUrl = "") {
+    this.baseUrl = baseUrl;
+  }
+
+  /**
+   * Set or update route definitions. Routes with the same name will be replaced.
+   *
+   * @param routes - Array of route definitions to add
+   */
+  setRoutes(routes) {
+    routes.forEach(route => {
+      const index = this.routes.findIndex(r => r.name === route.name);
+      if (index > -1) {
+        this.routes[index] = route;
+      } else {
+        this.routes.push(route);
+      }
+    });
+    this.sortRoutes();
+  }
+
+  /**
+   * Find a route by name.
+   *
+   * @param name - Route name to find
+   * @returns Route definition if found, undefined otherwise
+   */
+  findRoute(name) {
+    return this.routes.find(r => r.name === name);
+  }
+
+  /**
+   * Resolve a pathname to a matched route.
+   * The pathname will be matched against patterns after stripping the baseUrl.
+   *
+   * @param pathname - The pathname to resolve (e.g., '/tenant123/cms/entries/123')
+   * @param queryParams - Optional query parameters to merge into route params
+   * @returns Matched route with onMatch callback, or null if no route matches
+   */
+  resolve(pathname, queryParams) {
+    for (const route of this.routes) {
+      const pattern = route.path === "*" ? "(.*)" : route.path;
+      const matchResult = RouteUrl.match(pathname, pattern, this.baseUrl);
+      if (matchResult) {
+        const matchedRoute = {
+          name: route.name,
+          path: route.path,
+          pathname,
+          params: {
+            ...matchResult.params,
+            ...(queryParams || {})
+          }
+        };
+        const onMatch = matched => {
+          route.onMatch(matched);
+        };
+        return {
+          matchedRoute,
+          onMatch
+        };
+      }
+    }
+    return null;
+  }
+
+  /**
+   * Get the current baseUrl.
+   */
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+
+  /**
+   * Sort routes to ensure proper matching order.
+   * Wildcard routes (*) and index routes (/) are moved to the bottom.
+   */
+  sortRoutes() {
+    const INDEX_PATH = "/";
+    const WILDCARD_PATTERNS = ["*", "(.*)"];
+    this.routes.sort((a, b) => {
+      const pathA = a.path || "*";
+      const pathB = b.path || "*";
+      const isWildcardA = WILDCARD_PATTERNS.includes(pathA);
+      const isWildcardB = WILDCARD_PATTERNS.includes(pathB);
+      const isIndexA = pathA === INDEX_PATH;
+      const isIndexB = pathB === INDEX_PATH;
+
+      // Both are wildcards or both are index - maintain order
+      if (isWildcardA && isWildcardB || isIndexA && isIndexB) {
+        return 0;
+      }
+
+      // Index path should come before wildcard
+      if (isIndexA && isWildcardB) {
+        return -1;
+      }
+      if (isWildcardA && isIndexB) {
+        return 1;
+      }
+
+      // Push wildcards to the bottom
+      if (isWildcardA) {
+        return 1;
+      }
+      if (isWildcardB) {
+        return -1;
+      }
+
+      // Push index to the bottom (but above wildcards)
+      if (isIndexA) {
+        return 1;
+      }
+      if (isIndexB) {
+        return -1;
+      }
+
+      // All other routes maintain their order
+      return 0;
+    });
+  }
+}
+
+//# sourceMappingURL=Router.js.map

package/features/router/Router.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["RouteUrl","Router","routes","constructor","baseUrl","setRoutes","forEach","route","index","findIndex","r","name","push","sortRoutes","findRoute","find","resolve","pathname","queryParams","pattern","path","matchResult","match","matchedRoute","params","onMatch","matched","getBaseUrl","INDEX_PATH","WILDCARD_PATTERNS","sort","a","b","pathA","pathB","isWildcardA","includes","isWildcardB","isIndexA","isIndexB"],"sources":["Router.ts"],"sourcesContent":["import type { RouteDefinition, MatchedRoute } from \"./abstractions.js\";\nimport { RouteUrl } from \"./RouteUrl.js\";\n\ninterface ResolveResult {\n    matchedRoute: MatchedRoute;\n    onMatch: (route: MatchedRoute) => void;\n}\n\n/**\n * Router manages a collection of route definitions and resolves pathnames to matched routes.\n */\nexport class Router {\n    private routes: RouteDefinition[] = [];\n    private baseUrl: string;\n\n    constructor(baseUrl: string = \"\") {\n        this.baseUrl = baseUrl;\n    }\n\n    /**\n     * Set or update route definitions. Routes with the same name will be replaced.\n     *\n     * @param routes - Array of route definitions to add\n     */\n    setRoutes(routes: RouteDefinition[]): void {\n        routes.forEach(route => {\n            const index = this.routes.findIndex(r => r.name === route.name);\n\n            if (index > -1) {\n                this.routes[index] = route;\n            } else {\n                this.routes.push(route);\n            }\n        });\n\n        this.sortRoutes();\n    }\n\n    /**\n     * Find a route by name.\n     *\n     * @param name - Route name to find\n     * @returns Route definition if found, undefined otherwise\n     */\n    findRoute(name: string): RouteDefinition | undefined {\n        return this.routes.find(r => r.name === name);\n    }\n\n    /**\n     * Resolve a pathname to a matched route.\n     * The pathname will be matched against patterns after stripping the baseUrl.\n     *\n     * @param pathname - The pathname to resolve (e.g., '/tenant123/cms/entries/123')\n     * @param queryParams - Optional query parameters to merge into route params\n     * @returns Matched route with onMatch callback, or null if no route matches\n     */\n    resolve(pathname: string, queryParams?: Record<string, unknown>): ResolveResult | null {\n        for (const route of this.routes) {\n            const pattern = route.path === \"*\" ? \"(.*)\" : route.path;\n            const matchResult = RouteUrl.match(pathname, pattern, this.baseUrl);\n\n            if (matchResult) {\n                const matchedRoute: MatchedRoute = {\n                    name: route.name,\n                    path: route.path,\n                    pathname,\n                    params: { ...matchResult.params, ...(queryParams || {}) }\n                };\n\n                const onMatch = (matched: MatchedRoute) => {\n                    route.onMatch(matched);\n                };\n\n                return { matchedRoute, onMatch };\n            }\n        }\n\n        return null;\n    }\n\n    /**\n     * Get the current baseUrl.\n     */\n    getBaseUrl(): string {\n        return this.baseUrl;\n    }\n\n    /**\n     * Sort routes to ensure proper matching order.\n     * Wildcard routes (*) and index routes (/) are moved to the bottom.\n     */\n    private sortRoutes(): void {\n        const INDEX_PATH = \"/\";\n        const WILDCARD_PATTERNS = [\"*\", \"(.*)\"];\n\n        this.routes.sort((a, b) => {\n            const pathA = a.path || \"*\";\n            const pathB = b.path || \"*\";\n\n            const isWildcardA = WILDCARD_PATTERNS.includes(pathA);\n            const isWildcardB = WILDCARD_PATTERNS.includes(pathB);\n            const isIndexA = pathA === INDEX_PATH;\n            const isIndexB = pathB === INDEX_PATH;\n\n            // Both are wildcards or both are index - maintain order\n            if ((isWildcardA && isWildcardB) || (isIndexA && isIndexB)) {\n                return 0;\n            }\n\n            // Index path should come before wildcard\n            if (isIndexA && isWildcardB) {\n                return -1;\n            }\n            if (isWildcardA && isIndexB) {\n                return 1;\n            }\n\n            // Push wildcards to the bottom\n            if (isWildcardA) {\n                return 1;\n            }\n            if (isWildcardB) {\n                return -1;\n            }\n\n            // Push index to the bottom (but above wildcards)\n            if (isIndexA) {\n                return 1;\n            }\n            if (isIndexB) {\n                return -1;\n            }\n\n            // All other routes maintain their order\n            return 0;\n        });\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/features/router/RouterPresenter.d.ts

@@ -0,0 +1,17 @@
+import { Route } from "./Route.js";
+import { RouterRepository, RouterPresenter as Abstraction, type OnRouteExit } from "./abstractions.js";
+declare class RouterPresenterImpl implements Abstraction.Interface {
+    private routerRepository;
+    constructor(routerRepository: RouterRepository.Interface);
+    get vm(): {
+        currentRoute: import("./abstractions.js").MatchedRoute<Record<string, any>> | undefined;
+    };
+    bootstrap: (routes: Route[]) => void;
+    goToRoute: (route: any, params?: any) => void;
+    setRouteParams: (cb: any) => void;
+    getLink: (route: any, params?: any) => string;
+    onRouteExit: (cb: OnRouteExit) => void;
+    destroy: () => void;
+}
+export declare const RouterPresenter: import("@webiny/di").Implementation<typeof RouterPresenterImpl>;
+export {};

package/features/router/RouterPresenter.js

@@ -0,0 +1,45 @@
+import { makeAutoObservable, toJS } from "mobx";
+import { createImplementation } from "@webiny/di";
+import { RouterRepository, RouterPresenter as Abstraction } from "./abstractions.js";
+class RouterPresenterImpl {
+  constructor(routerRepository) {
+    this.routerRepository = routerRepository;
+    makeAutoObservable(this);
+  }
+  get vm() {
+    return {
+      currentRoute: toJS(this.routerRepository.getMatchedRoute())
+    };
+  }
+  bootstrap = routes => {
+    this.routerRepository.registerRoutes(routes);
+  };
+  goToRoute = (route, params) => {
+    this.routerRepository.goToRoute(route, params);
+  };
+  setRouteParams = cb => {
+    const currentRoute = this.routerRepository.getCurrentRoute();
+    if (!currentRoute) {
+      return;
+    }
+    const matchedRoute = this.routerRepository.getMatchedRoute();
+    const newParams = cb(matchedRoute?.params ?? {});
+    this.goToRoute(currentRoute, newParams);
+  };
+  getLink = (route, params) => {
+    return this.routerRepository.getLink(route, params);
+  };
+  onRouteExit = cb => {
+    this.routerRepository.onRouteExit(cb);
+  };
+  destroy = () => {
+    this.routerRepository.destroy();
+  };
+}
+export const RouterPresenter = createImplementation({
+  abstraction: Abstraction,
+  implementation: RouterPresenterImpl,
+  dependencies: [RouterRepository]
+});
+
+//# sourceMappingURL=RouterPresenter.js.map

package/features/router/RouterPresenter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["makeAutoObservable","toJS","createImplementation","RouterRepository","RouterPresenter","Abstraction","RouterPresenterImpl","constructor","routerRepository","vm","currentRoute","getMatchedRoute","bootstrap","routes","registerRoutes","goToRoute","route","params","setRouteParams","cb","getCurrentRoute","matchedRoute","newParams","getLink","onRouteExit","destroy","abstraction","implementation","dependencies"],"sources":["RouterPresenter.ts"],"sourcesContent":["import { makeAutoObservable, toJS } from \"mobx\";\nimport { createImplementation } from \"@webiny/di\";\nimport { Route } from \"./Route.js\";\nimport {\n    RouterRepository,\n    RouterPresenter as Abstraction,\n    type OnRouteExit\n} from \"./abstractions.js\";\n\nclass RouterPresenterImpl implements Abstraction.Interface {\n    private routerRepository: RouterRepository.Interface;\n\n    constructor(routerRepository: RouterRepository.Interface) {\n        this.routerRepository = routerRepository;\n\n        makeAutoObservable(this);\n    }\n\n    get vm() {\n        return {\n            currentRoute: toJS(this.routerRepository.getMatchedRoute())\n        };\n    }\n\n    bootstrap = (routes: Route[]) => {\n        this.routerRepository.registerRoutes(routes);\n    };\n\n    goToRoute = (route: any, params?: any) => {\n        this.routerRepository.goToRoute(route, params);\n    };\n\n    setRouteParams = (cb: any) => {\n        const currentRoute = this.routerRepository.getCurrentRoute();\n        if (!currentRoute) {\n            return;\n        }\n\n        const matchedRoute = this.routerRepository.getMatchedRoute();\n        const newParams = cb(matchedRoute?.params ?? {});\n        this.goToRoute(currentRoute, newParams);\n    };\n\n    getLink = (route: any, params?: any) => {\n        return this.routerRepository.getLink(route, params);\n    };\n\n    onRouteExit = (cb: OnRouteExit) => {\n        this.routerRepository.onRouteExit(cb);\n    };\n\n    destroy = () => {\n        this.routerRepository.destroy();\n    };\n}\n\nexport const RouterPresenter = createImplementation({\n    abstraction: Abstraction,\n    implementation: RouterPresenterImpl,\n    dependencies: [RouterRepository]\n});\n"],"mappings":"AAAA,SAASA,kBAAkB,EAAEC,IAAI,QAAQ,MAAM;AAC/C,SAASC,oBAAoB,QAAQ,YAAY;AAEjD,SACIC,gBAAgB,EAChBC,eAAe,IAAIC,WAAW;AAIlC,MAAMC,mBAAmB,CAAkC;EAGvDC,WAAWA,CAACC,gBAA4C,EAAE;IACtD,IAAI,CAACA,gBAAgB,GAAGA,gBAAgB;IAExCR,kBAAkB,CAAC,IAAI,CAAC;EAC5B;EAEA,IAAIS,EAAEA,CAAA,EAAG;IACL,OAAO;MACHC,YAAY,EAAET,IAAI,CAAC,IAAI,CAACO,gBAAgB,CAACG,eAAe,CAAC,CAAC;IAC9D,CAAC;EACL;EAEAC,SAAS,GAAIC,MAAe,IAAK;IAC7B,IAAI,CAACL,gBAAgB,CAACM,cAAc,CAACD,MAAM,CAAC;EAChD,CAAC;EAEDE,SAAS,GAAGA,CAACC,KAAU,EAAEC,MAAY,KAAK;IACtC,IAAI,CAACT,gBAAgB,CAACO,SAAS,CAACC,KAAK,EAAEC,MAAM,CAAC;EAClD,CAAC;EAEDC,cAAc,GAAIC,EAAO,IAAK;IAC1B,MAAMT,YAAY,GAAG,IAAI,CAACF,gBAAgB,CAACY,eAAe,CAAC,CAAC;IAC5D,IAAI,CAACV,YAAY,EAAE;MACf;IACJ;IAEA,MAAMW,YAAY,GAAG,IAAI,CAACb,gBAAgB,CAACG,eAAe,CAAC,CAAC;IAC5D,MAAMW,SAAS,GAAGH,EAAE,CAACE,YAAY,EAAEJ,MAAM,IAAI,CAAC,CAAC,CAAC;IAChD,IAAI,CAACF,SAAS,CAACL,YAAY,EAAEY,SAAS,CAAC;EAC3C,CAAC;EAEDC,OAAO,GAAGA,CAACP,KAAU,EAAEC,MAAY,KAAK;IACpC,OAAO,IAAI,CAACT,gBAAgB,CAACe,OAAO,CAACP,KAAK,EAAEC,MAAM,CAAC;EACvD,CAAC;EAEDO,WAAW,GAAIL,EAAe,IAAK;IAC/B,IAAI,CAACX,gBAAgB,CAACgB,WAAW,CAACL,EAAE,CAAC;EACzC,CAAC;EAEDM,OAAO,GAAGA,CAAA,KAAM;IACZ,IAAI,CAACjB,gBAAgB,CAACiB,OAAO,CAAC,CAAC;EACnC,CAAC;AACL;AAEA,OAAO,MAAMrB,eAAe,GAAGF,oBAAoB,CAAC;EAChDwB,WAAW,EAAErB,WAAW;EACxBsB,cAAc,EAAErB,mBAAmB;EACnCsB,YAAY,EAAE,CAACzB,gBAAgB;AACnC,CAAC,CAAC","ignoreList":[]}

package/features/router/RouterRepository.d.ts

@@ -0,0 +1,21 @@
+import type { MatchedRoute, OnRouteExit } from "./abstractions.js";
+import * as Abstractions from "./abstractions.js";
+import { Route, RouteParamsDefinition, RouteParamsInfer } from "./Route.js";
+declare class RouterRepositoryImpl implements Abstractions.RouterRepository.Interface {
+    private gateway;
+    private currentRoute;
+    private routes;
+    constructor(gateway: Abstractions.RouterGateway.Interface);
+    getMatchedRoute(): MatchedRoute<Record<string, any>> | undefined;
+    getCurrentRoute(): Route<any> | undefined;
+    registerRoutes: (routes: Route[]) => void;
+    getLink<TParams extends RouteParamsDefinition | undefined>(route: Route<TParams>, params?: TParams extends RouteParamsDefinition ? RouteParamsInfer<TParams> : undefined): string;
+    goToRoute<TParams extends RouteParamsDefinition | undefined>(route: Route<TParams>, params: TParams extends RouteParamsDefinition ? RouteParamsInfer<TParams> : undefined): void;
+    onRouteExit(cb: OnRouteExit): void;
+    destroy(): void;
+    private routeWithAction;
+    private transitionToRoute;
+    private getRouteByName;
+}
+export declare const RouterRepository: import("@webiny/di").Implementation<typeof RouterRepositoryImpl>;
+export {};

package/features/router/RouterRepository.js

@@ -0,0 +1,71 @@
+import { makeAutoObservable, runInAction } from "mobx";
+import * as Abstractions from "./abstractions.js";
+import { createImplementation } from "@webiny/di";
+import { RouteUrl } from "./RouteUrl.js";
+const INIT_ROUTE = {
+  name: "__init__",
+  path: "",
+  pathname: "",
+  params: {}
+};
+class RouterRepositoryImpl {
+  currentRoute = INIT_ROUTE;
+  routes = [];
+  constructor(gateway) {
+    this.gateway = gateway;
+    makeAutoObservable(this);
+  }
+  getMatchedRoute() {
+    return this.currentRoute.name !== INIT_ROUTE.name ? this.currentRoute : undefined;
+  }
+  getCurrentRoute() {
+    return this.routes.find(route => route.name === this.currentRoute.name);
+  }
+  registerRoutes = routes => {
+    this.routes = routes;
+    const routesWithAction = routes.map(this.routeWithAction);
+    this.gateway.setRoutes(routesWithAction);
+  };
+  getLink(route, params) {
+    return RouteUrl.fromPattern(route.path, params);
+  }
+  goToRoute(route, params) {
+    this.gateway.goToRoute(route.name, params);
+  }
+  onRouteExit(cb) {
+    this.gateway.onRouteExit(cb);
+  }
+  destroy() {
+    this.gateway.destroy();
+  }
+  routeWithAction = route => {
+    return {
+      name: route.name,
+      path: route.path,
+      onMatch: this.transitionToRoute.bind(this)
+    };
+  };
+  async transitionToRoute(matchedRoute) {
+    const route = this.getRouteByName(matchedRoute.name);
+    if (!route) {
+      return;
+    }
+    const params = route.params ? route.params.parse(matchedRoute.params) : matchedRoute.params;
+    runInAction(() => {
+      Object.assign(this.currentRoute, {
+        ...matchedRoute,
+        params
+      });
+    });
+  }
+  getRouteByName(name) {
+    return this.routes.find(existingRoute => existingRoute.name === name);
+  }
+}
+export const RouterRepository = createImplementation({
+  implementation: RouterRepositoryImpl,
+  abstraction: Abstractions.RouterRepository,
+  dependencies: [Abstractions.RouterGateway]
+});
+
+//# sourceMappingURL=RouterRepository.js.map

package/features/router/RouterRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["makeAutoObservable","runInAction","Abstractions","createImplementation","RouteUrl","INIT_ROUTE","name","path","pathname","params","RouterRepositoryImpl","currentRoute","routes","constructor","gateway","getMatchedRoute","undefined","getCurrentRoute","find","route","registerRoutes","routesWithAction","map","routeWithAction","setRoutes","getLink","fromPattern","goToRoute","onRouteExit","cb","destroy","onMatch","transitionToRoute","bind","matchedRoute","getRouteByName","parse","Object","assign","existingRoute","RouterRepository","implementation","abstraction","dependencies","RouterGateway"],"sources":["RouterRepository.ts"],"sourcesContent":["import { makeAutoObservable, runInAction } from \"mobx\";\nimport type { MatchedRoute, RouteDefinition, OnRouteExit } from \"./abstractions.js\";\nimport * as Abstractions from \"./abstractions.js\";\nimport { Route, RouteParamsDefinition, RouteParamsInfer } from \"./Route.js\";\nimport { createImplementation } from \"@webiny/di\";\nimport { RouteUrl } from \"./RouteUrl.js\";\n\nconst INIT_ROUTE = { name: \"__init__\", path: \"\", pathname: \"\", params: {} };\n\nclass RouterRepositoryImpl implements Abstractions.RouterRepository.Interface {\n    private gateway: Abstractions.RouterGateway.Interface;\n    private currentRoute: MatchedRoute = INIT_ROUTE;\n    private routes: Route<any>[] = [];\n\n    constructor(gateway: Abstractions.RouterGateway.Interface) {\n        this.gateway = gateway;\n\n        makeAutoObservable(this);\n    }\n\n    getMatchedRoute() {\n        return this.currentRoute.name !== INIT_ROUTE.name ? this.currentRoute : undefined;\n    }\n\n    getCurrentRoute(): Route<any> | undefined {\n        return this.routes.find(route => route.name === this.currentRoute.name);\n    }\n\n    registerRoutes = (routes: Route[]) => {\n        this.routes = routes;\n        const routesWithAction = routes.map<RouteDefinition>(this.routeWithAction);\n\n        this.gateway.setRoutes(routesWithAction);\n    };\n\n    getLink<TParams extends RouteParamsDefinition | undefined>(\n        route: Route<TParams>,\n        params?: TParams extends RouteParamsDefinition ? RouteParamsInfer<TParams> : undefined\n    ): string {\n        return RouteUrl.fromPattern(route.path, params);\n    }\n\n    goToRoute<TParams extends RouteParamsDefinition | undefined>(\n        route: Route<TParams>,\n        params: TParams extends RouteParamsDefinition ? RouteParamsInfer<TParams> : undefined\n    ): void {\n        this.gateway.goToRoute(route.name, params);\n    }\n\n    onRouteExit(cb: OnRouteExit): void {\n        this.gateway.onRouteExit(cb);\n    }\n\n    destroy() {\n        this.gateway.destroy();\n    }\n\n    private routeWithAction = (route: Route<any>) => {\n        return {\n            name: route.name,\n            path: route.path,\n            onMatch: this.transitionToRoute.bind(this)\n        };\n    };\n\n    private async transitionToRoute(matchedRoute: MatchedRoute) {\n        const route = this.getRouteByName(matchedRoute.name);\n        if (!route) {\n            return;\n        }\n\n        const params = route.params ? route.params.parse(matchedRoute.params) : matchedRoute.params;\n\n        runInAction(() => {\n            Object.assign(this.currentRoute, {\n                ...matchedRoute,\n                params\n            });\n        });\n    }\n\n    private getRouteByName(name: string) {\n        return this.routes.find(existingRoute => existingRoute.name === name);\n    }\n}\n\nexport const RouterRepository = createImplementation({\n    implementation: RouterRepositoryImpl,\n    abstraction: Abstractions.RouterRepository,\n    dependencies: [Abstractions.RouterGateway]\n});\n"],"mappings":"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","ignoreList":[]}

package/features/router/RouterRepository.test.d.ts

@@ -0,0 +1 @@
+export {};

package/features/router/RouterRepository.test.js

@@ -0,0 +1,154 @@
+import { describe, it, beforeEach, expect, vi } from "vitest";
+import { createMemoryHistory } from "history";
+import { HistoryRouterGateway } from "./HistoryRouterGateway.js";
+import { RouterRepository } from "./RouterRepository.js";
+import { Route } from "./Route.js";
+const wait = () => new Promise(resolve => setTimeout(resolve, 10));
+const loginRouteDef = new Route({
+  name: "login",
+  path: "/login"
+});
+const userRouteDef = new Route({
+  name: "userById",
+  path: "/users/:id",
+  params: zod => {
+    return {
+      id: zod.string()
+    };
+  }
+});
+const allRoutes = [new Route({
+  name: "home",
+  path: "/"
+}), loginRouteDef, userRouteDef];
+const loginRoute = {
+  name: "login",
+  path: "/login",
+  pathname: "/login",
+  params: {}
+};
+const userRoute = id => {
+  return {
+    name: "userById",
+    path: "/users/:id",
+    pathname: `/users/${id}`,
+    params: {
+      id
+    }
+  };
+};
+const createRepository = (routes = allRoutes) => {
+  const history = createMemoryHistory();
+  history.replace("/__unknown__");
+  const gateway = new HistoryRouterGateway(history, "");
+  const repository = new RouterRepository(gateway);
+  repository.registerRoutes(routes);
+  return {
+    repository,
+    history
+  };
+};
+describe("Router Repository", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+  it("state should contain current route", async () => {
+    const {
+      repository,
+      history
+    } = createRepository();
+    history.push("/login");
+    await wait();
+    expect(repository.getMatchedRoute()).toEqual(loginRoute);
+  });
+  it("route guard should allow or prevent route transition", async () => {
+    const {
+      repository,
+      history
+    } = createRepository();
+    history.push("/login");
+    await wait();
+
+    // This guard should prevent the transition.
+    // The Repository should stay where it was, and the `history` should restore the previous URL.
+    repository.onRouteExit(({
+      cancel
+    }) => {
+      cancel();
+    });
+
+    // Trigger a history location change (imagine a click on "Back" button in the browser).
+    history.push("/users/123");
+    await wait();
+    expect(repository.getMatchedRoute()).toEqual(loginRoute);
+
+    // This guard should allow the transition.
+    repository.onRouteExit(guard => {
+      guard.continue();
+    });
+
+    // Trigger a history location change (imagine a click on "Back" button in the browser).
+    history.push("/users/123");
+    await wait();
+    expect(repository.getMatchedRoute()).toEqual(userRoute("123"));
+  });
+  it("route guard should be unset after route transition", async () => {
+    const guardSpy = vi.fn();
+    const {
+      repository,
+      history
+    } = createRepository();
+    history.push("/login");
+    await wait();
+
+    // This guard should prevent the transition.
+    // The Repository should stay where it was, and the `history` should restore the previous URL.
+    repository.onRouteExit(guard => {
+      guardSpy();
+      guard.continue();
+    });
+
+    // Trigger a history location change (imagine a click on "Back" button in the browser).
+    history.push("/users/123");
+    await wait();
+    expect(repository.getMatchedRoute()).toEqual(userRoute("123"));
+    expect(guardSpy).toHaveBeenCalledTimes(1);
+    vi.resetAllMocks();
+
+    // Trigger a history location change (imagine a click on "Back" button in the browser).
+    history.push("/login");
+    await wait();
+    expect(repository.getMatchedRoute()).toEqual(loginRoute);
+    expect(guardSpy).toHaveBeenCalledTimes(0);
+  });
+  it("should go to the right route", async () => {
+    const {
+      repository
+    } = createRepository();
+    repository.goToRoute(userRouteDef, {
+      id: "5"
+    });
+    await wait();
+    expect(repository.getMatchedRoute()).toEqual(userRoute("5"));
+  });
+  it("should generate a valid route link", async () => {
+    const {
+      repository
+    } = createRepository();
+    expect(repository.getLink(loginRouteDef)).toEqual("/login");
+    expect(repository.getLink(userRouteDef, {
+      id: "1"
+    })).toEqual("/users/1");
+  });
+  it("should generate a valid route link when no routes are registered", async () => {
+    const {
+      repository
+    } = createRepository([]);
+    expect(repository.getLink(loginRouteDef)).toEqual("/login");
+    expect(repository.getLink(userRouteDef, {
+      id: "1"
+    })).toEqual("/users/1");
+  });
+});
+
+//# sourceMappingURL=RouterRepository.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["describe","it","beforeEach","expect","vi","createMemoryHistory","HistoryRouterGateway","RouterRepository","Route","wait","Promise","resolve","setTimeout","loginRouteDef","name","path","userRouteDef","params","zod","id","string","allRoutes","loginRoute","pathname","userRoute","createRepository","routes","history","replace","gateway","repository","registerRoutes","clearAllMocks","push","getMatchedRoute","toEqual","onRouteExit","cancel","guard","continue","guardSpy","fn","toHaveBeenCalledTimes","resetAllMocks","goToRoute","getLink"],"sources":["RouterRepository.test.ts"],"sourcesContent":["import { describe, it, beforeEach, expect, vi } from \"vitest\";\nimport { createMemoryHistory } from \"history\";\nimport { HistoryRouterGateway } from \"./HistoryRouterGateway.js\";\nimport { RouterRepository } from \"./RouterRepository.js\";\nimport { Route } from \"./Route.js\";\n\nconst wait = () => new Promise(resolve => setTimeout(resolve, 10));\n\nconst loginRouteDef = new Route({ name: \"login\", path: \"/login\" });\n\nconst userRouteDef = new Route({\n    name: \"userById\",\n    path: \"/users/:id\",\n    params: zod => {\n        return {\n            id: zod.string()\n        };\n    }\n});\n\nconst allRoutes: Route<any>[] = [\n    new Route({ name: \"home\", path: \"/\" }),\n    loginRouteDef,\n    userRouteDef\n];\n\nconst loginRoute = {\n    name: \"login\",\n    path: \"/login\",\n    pathname: \"/login\",\n    params: {}\n};\n\nconst userRoute = (id: string) => {\n    return {\n        name: \"userById\",\n        path: \"/users/:id\",\n        pathname: `/users/${id}`,\n        params: {\n            id\n        }\n    };\n};\n\nconst createRepository = (routes = allRoutes) => {\n    const history = createMemoryHistory();\n    history.replace(\"/__unknown__\");\n\n    const gateway = new HistoryRouterGateway(history, \"\");\n    const repository = new RouterRepository(gateway);\n\n    repository.registerRoutes(routes);\n\n    return { repository, history };\n};\n\ndescribe(\"Router Repository\", () => {\n    beforeEach(() => {\n        vi.clearAllMocks();\n    });\n\n    it(\"state should contain current route\", async () => {\n        const { repository, history } = createRepository();\n        history.push(\"/login\");\n        await wait();\n\n        expect(repository.getMatchedRoute()).toEqual(loginRoute);\n    });\n\n    it(\"route guard should allow or prevent route transition\", async () => {\n        const { repository, history } = createRepository();\n        history.push(\"/login\");\n        await wait();\n\n        // This guard should prevent the transition.\n        // The Repository should stay where it was, and the `history` should restore the previous URL.\n        repository.onRouteExit(({ cancel }) => {\n            cancel();\n        });\n\n        // Trigger a history location change (imagine a click on \"Back\" button in the browser).\n        history.push(\"/users/123\");\n        await wait();\n\n        expect(repository.getMatchedRoute()).toEqual(loginRoute);\n\n        // This guard should allow the transition.\n        repository.onRouteExit(guard => {\n            guard.continue();\n        });\n\n        // Trigger a history location change (imagine a click on \"Back\" button in the browser).\n        history.push(\"/users/123\");\n        await wait();\n\n        expect(repository.getMatchedRoute()).toEqual(userRoute(\"123\"));\n    });\n\n    it(\"route guard should be unset after route transition\", async () => {\n        const guardSpy = vi.fn();\n        const { repository, history } = createRepository();\n        history.push(\"/login\");\n        await wait();\n\n        // This guard should prevent the transition.\n        // The Repository should stay where it was, and the `history` should restore the previous URL.\n        repository.onRouteExit(guard => {\n            guardSpy();\n            guard.continue();\n        });\n\n        // Trigger a history location change (imagine a click on \"Back\" button in the browser).\n        history.push(\"/users/123\");\n        await wait();\n\n        expect(repository.getMatchedRoute()).toEqual(userRoute(\"123\"));\n        expect(guardSpy).toHaveBeenCalledTimes(1);\n        vi.resetAllMocks();\n\n        // Trigger a history location change (imagine a click on \"Back\" button in the browser).\n        history.push(\"/login\");\n        await wait();\n\n        expect(repository.getMatchedRoute()).toEqual(loginRoute);\n        expect(guardSpy).toHaveBeenCalledTimes(0);\n    });\n\n    it(\"should go to the right route\", async () => {\n        const { repository } = createRepository();\n        repository.goToRoute(userRouteDef, { id: \"5\" });\n        await wait();\n        expect(repository.getMatchedRoute()).toEqual(userRoute(\"5\"));\n    });\n\n    it(\"should generate a valid route link\", async () => {\n        const { repository } = createRepository();\n\n        expect(repository.getLink(loginRouteDef)).toEqual(\"/login\");\n        expect(repository.getLink(userRouteDef, { id: \"1\" })).toEqual(\"/users/1\");\n    });\n\n    it(\"should generate a valid route link when no routes are registered\", async () => {\n        const { repository } = createRepository([]);\n\n        expect(repository.getLink(loginRouteDef)).toEqual(\"/login\");\n        expect(repository.getLink(userRouteDef, { id: \"1\" })).toEqual(\"/users/1\");\n    });\n});\n"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,EAAE,EAAEC,UAAU,EAAEC,MAAM,EAAEC,EAAE,QAAQ,QAAQ;AAC7D,SAASC,mBAAmB,QAAQ,SAAS;AAC7C,SAASC,oBAAoB;AAC7B,SAASC,gBAAgB;AACzB,SAASC,KAAK;AAEd,MAAMC,IAAI,GAAGA,CAAA,KAAM,IAAIC,OAAO,CAACC,OAAO,IAAIC,UAAU,CAACD,OAAO,EAAE,EAAE,CAAC,CAAC;AAElE,MAAME,aAAa,GAAG,IAAIL,KAAK,CAAC;EAAEM,IAAI,EAAE,OAAO;EAAEC,IAAI,EAAE;AAAS,CAAC,CAAC;AAElE,MAAMC,YAAY,GAAG,IAAIR,KAAK,CAAC;EAC3BM,IAAI,EAAE,UAAU;EAChBC,IAAI,EAAE,YAAY;EAClBE,MAAM,EAAEC,GAAG,IAAI;IACX,OAAO;MACHC,EAAE,EAAED,GAAG,CAACE,MAAM,CAAC;IACnB,CAAC;EACL;AACJ,CAAC,CAAC;AAEF,MAAMC,SAAuB,GAAG,CAC5B,IAAIb,KAAK,CAAC;EAAEM,IAAI,EAAE,MAAM;EAAEC,IAAI,EAAE;AAAI,CAAC,CAAC,EACtCF,aAAa,EACbG,YAAY,CACf;AAED,MAAMM,UAAU,GAAG;EACfR,IAAI,EAAE,OAAO;EACbC,IAAI,EAAE,QAAQ;EACdQ,QAAQ,EAAE,QAAQ;EAClBN,MAAM,EAAE,CAAC;AACb,CAAC;AAED,MAAMO,SAAS,GAAIL,EAAU,IAAK;EAC9B,OAAO;IACHL,IAAI,EAAE,UAAU;IAChBC,IAAI,EAAE,YAAY;IAClBQ,QAAQ,EAAE,UAAUJ,EAAE,EAAE;IACxBF,MAAM,EAAE;MACJE;IACJ;EACJ,CAAC;AACL,CAAC;AAED,MAAMM,gBAAgB,GAAGA,CAACC,MAAM,GAAGL,SAAS,KAAK;EAC7C,MAAMM,OAAO,GAAGtB,mBAAmB,CAAC,CAAC;EACrCsB,OAAO,CAACC,OAAO,CAAC,cAAc,CAAC;EAE/B,MAAMC,OAAO,GAAG,IAAIvB,oBAAoB,CAACqB,OAAO,EAAE,EAAE,CAAC;EACrD,MAAMG,UAAU,GAAG,IAAIvB,gBAAgB,CAACsB,OAAO,CAAC;EAEhDC,UAAU,CAACC,cAAc,CAACL,MAAM,CAAC;EAEjC,OAAO;IAAEI,UAAU;IAAEH;EAAQ,CAAC;AAClC,CAAC;AAED3B,QAAQ,CAAC,mBAAmB,EAAE,MAAM;EAChCE,UAAU,CAAC,MAAM;IACbE,EAAE,CAAC4B,aAAa,CAAC,CAAC;EACtB,CAAC,CAAC;EAEF/B,EAAE,CAAC,oCAAoC,EAAE,YAAY;IACjD,MAAM;MAAE6B,UAAU;MAAEH;IAAQ,CAAC,GAAGF,gBAAgB,CAAC,CAAC;IAClDE,OAAO,CAACM,IAAI,CAAC,QAAQ,CAAC;IACtB,MAAMxB,IAAI,CAAC,CAAC;IAEZN,MAAM,CAAC2B,UAAU,CAACI,eAAe,CAAC,CAAC,CAAC,CAACC,OAAO,CAACb,UAAU,CAAC;EAC5D,CAAC,CAAC;EAEFrB,EAAE,CAAC,sDAAsD,EAAE,YAAY;IACnE,MAAM;MAAE6B,UAAU;MAAEH;IAAQ,CAAC,GAAGF,gBAAgB,CAAC,CAAC;IAClDE,OAAO,CAACM,IAAI,CAAC,QAAQ,CAAC;IACtB,MAAMxB,IAAI,CAAC,CAAC;;IAEZ;IACA;IACAqB,UAAU,CAACM,WAAW,CAAC,CAAC;MAAEC;IAAO,CAAC,KAAK;MACnCA,MAAM,CAAC,CAAC;IACZ,CAAC,CAAC;;IAEF;IACAV,OAAO,CAACM,IAAI,CAAC,YAAY,CAAC;IAC1B,MAAMxB,IAAI,CAAC,CAAC;IAEZN,MAAM,CAAC2B,UAAU,CAACI,eAAe,CAAC,CAAC,CAAC,CAACC,OAAO,CAACb,UAAU,CAAC;;IAExD;IACAQ,UAAU,CAACM,WAAW,CAACE,KAAK,IAAI;MAC5BA,KAAK,CAACC,QAAQ,CAAC,CAAC;IACpB,CAAC,CAAC;;IAEF;IACAZ,OAAO,CAACM,IAAI,CAAC,YAAY,CAAC;IAC1B,MAAMxB,IAAI,CAAC,CAAC;IAEZN,MAAM,CAAC2B,UAAU,CAACI,eAAe,CAAC,CAAC,CAAC,CAACC,OAAO,CAACX,SAAS,CAAC,KAAK,CAAC,CAAC;EAClE,CAAC,CAAC;EAEFvB,EAAE,CAAC,oDAAoD,EAAE,YAAY;IACjE,MAAMuC,QAAQ,GAAGpC,EAAE,CAACqC,EAAE,CAAC,CAAC;IACxB,MAAM;MAAEX,UAAU;MAAEH;IAAQ,CAAC,GAAGF,gBAAgB,CAAC,CAAC;IAClDE,OAAO,CAACM,IAAI,CAAC,QAAQ,CAAC;IACtB,MAAMxB,IAAI,CAAC,CAAC;;IAEZ;IACA;IACAqB,UAAU,CAACM,WAAW,CAACE,KAAK,IAAI;MAC5BE,QAAQ,CAAC,CAAC;MACVF,KAAK,CAACC,QAAQ,CAAC,CAAC;IACpB,CAAC,CAAC;;IAEF;IACAZ,OAAO,CAACM,IAAI,CAAC,YAAY,CAAC;IAC1B,MAAMxB,IAAI,CAAC,CAAC;IAEZN,MAAM,CAAC2B,UAAU,CAACI,eAAe,CAAC,CAAC,CAAC,CAACC,OAAO,CAACX,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9DrB,MAAM,CAACqC,QAAQ,CAAC,CAACE,qBAAqB,CAAC,CAAC,CAAC;IACzCtC,EAAE,CAACuC,aAAa,CAAC,CAAC;;IAElB;IACAhB,OAAO,CAACM,IAAI,CAAC,QAAQ,CAAC;IACtB,MAAMxB,IAAI,CAAC,CAAC;IAEZN,MAAM,CAAC2B,UAAU,CAACI,eAAe,CAAC,CAAC,CAAC,CAACC,OAAO,CAACb,UAAU,CAAC;IACxDnB,MAAM,CAACqC,QAAQ,CAAC,CAACE,qBAAqB,CAAC,CAAC,CAAC;EAC7C,CAAC,CAAC;EAEFzC,EAAE,CAAC,8BAA8B,EAAE,YAAY;IAC3C,MAAM;MAAE6B;IAAW,CAAC,GAAGL,gBAAgB,CAAC,CAAC;IACzCK,UAAU,CAACc,SAAS,CAAC5B,YAAY,EAAE;MAAEG,EAAE,EAAE;IAAI,CAAC,CAAC;IAC/C,MAAMV,IAAI,CAAC,CAAC;IACZN,MAAM,CAAC2B,UAAU,CAACI,eAAe,CAAC,CAAC,CAAC,CAACC,OAAO,CAACX,SAAS,CAAC,GAAG,CAAC,CAAC;EAChE,CAAC,CAAC;EAEFvB,EAAE,CAAC,oCAAoC,EAAE,YAAY;IACjD,MAAM;MAAE6B;IAAW,CAAC,GAAGL,gBAAgB,CAAC,CAAC;IAEzCtB,MAAM,CAAC2B,UAAU,CAACe,OAAO,CAAChC,aAAa,CAAC,CAAC,CAACsB,OAAO,CAAC,QAAQ,CAAC;IAC3DhC,MAAM,CAAC2B,UAAU,CAACe,OAAO,CAAC7B,YAAY,EAAE;MAAEG,EAAE,EAAE;IAAI,CAAC,CAAC,CAAC,CAACgB,OAAO,CAAC,UAAU,CAAC;EAC7E,CAAC,CAAC;EAEFlC,EAAE,CAAC,kEAAkE,EAAE,YAAY;IAC/E,MAAM;MAAE6B;IAAW,CAAC,GAAGL,gBAAgB,CAAC,EAAE,CAAC;IAE3CtB,MAAM,CAAC2B,UAAU,CAACe,OAAO,CAAChC,aAAa,CAAC,CAAC,CAACsB,OAAO,CAAC,QAAQ,CAAC;IAC3DhC,MAAM,CAAC2B,UAAU,CAACe,OAAO,CAAC7B,YAAY,EAAE;MAAEG,EAAE,EAAE;IAAI,CAAC,CAAC,CAAC,CAACgB,OAAO,CAAC,UAAU,CAAC;EAC7E,CAAC,CAAC;AACN,CAAC,CAAC","ignoreList":[]}

package/features/router/abstractions.d.ts

@@ -0,0 +1,68 @@
+import { Abstraction } from "@webiny/di";
+import type { Route, RouteParamsDefinition, RouteParamsInfer } from "./Route.js";
+import type { RequiredKeysOf } from "type-fest";
+/***** Presenter *****/
+export type RouteParamsArgs<TParams extends RouteParamsDefinition | undefined> = TParams extends RouteParamsDefinition ? RequiredKeysOf<RouteParamsInfer<TParams>> extends never ? [params?: RouteParamsInfer<TParams>] : [params: RouteParamsInfer<TParams>] : [];
+interface RouterViewModel {
+    currentRoute: MatchedRoute | undefined;
+}
+export interface IRouterPresenter {
+    vm: RouterViewModel;
+    bootstrap(routes: Route[]): void;
+    goToRoute<TParams extends RouteParamsDefinition | undefined>(route: Route<TParams>, ...args: RouteParamsArgs<TParams>): void;
+    getLink<TParams extends RouteParamsDefinition | undefined>(route: Route<TParams>, ...args: RouteParamsArgs<TParams>): string;
+    setRouteParams<T extends Record<string, any>>(cb: (params: T) => T): void;
+    onRouteExit(cb: OnRouteExit): void;
+    destroy(): void;
+}
+export declare const RouterPresenter: Abstraction<IRouterPresenter>;
+export declare namespace RouterPresenter {
+    type Interface = IRouterPresenter;
+}
+/***** Repository *****/
+export interface MatchedRoute<TParams = Record<string, any>> {
+    name: string;
+    pathname: string;
+    path: string;
+    params: TParams;
+}
+interface IRouterRepository {
+    onRouteExit(cb: OnRouteExit): void;
+    getMatchedRoute(): MatchedRoute | undefined;
+    getCurrentRoute(): Route<any> | undefined;
+    goToRoute<TParams extends RouteParamsDefinition | undefined>(route: Route<TParams>, params: TParams extends RouteParamsDefinition ? RouteParamsInfer<TParams> : undefined): void;
+    getLink<TParams extends RouteParamsDefinition | undefined>(route: Route<TParams>, params: TParams extends RouteParamsDefinition ? RouteParamsInfer<TParams> : undefined): string;
+    registerRoutes(routes: Route[]): void;
+    destroy(): void;
+}
+export declare const RouterRepository: Abstraction<IRouterRepository>;
+export declare namespace RouterRepository {
+    type Interface = IRouterRepository;
+}
+/***** Gateway *****/
+export interface RouteDefinition {
+    name: string;
+    path: string;
+    onMatch(route: MatchedRoute): void;
+}
+export type TransitionController = {
+    continue: () => void;
+    cancel: () => void;
+};
+export interface OnRouteExit {
+    (controller: TransitionController): void;
+}
+interface IRouterGateway {
+    setRoutes(routes: RouteDefinition[]): void;
+    goToRoute(name: string, params?: {
+        [k: string]: any;
+    }): void;
+    pushState(url: string): void;
+    onRouteExit(cb: OnRouteExit): void;
+    destroy(): void;
+}
+export declare const RouterGateway: Abstraction<IRouterGateway>;
+export declare namespace RouterGateway {
+    type Interface = IRouterGateway;
+}
+export {};