@opencxh/domain 1.141.0 → 1.144.0

package/dist/platform/manifest.d.ts

@@ -138,6 +138,14 @@ export interface AppManifest<TSDK = any> {
      * Paths will be automatically prefixed with `/apps/{appName}`.
      */
     routes?: RouteDefinition[];
+    /**
+     * Root path the app's `public: true` routes are mounted under, e.g. `/help`.
+     *
+     * Only cosmetic: without it a public route keeps the `/apps/{appName}`
+     * prefix and works exactly the same. It exists because a help centre or a
+     * status page is a URL customers see and link to.
+     */
+    publicBasePath?: string;
     /** An array of menu items provided by this application. */
     menu?: MenuItem[];
     /** An array of translations provided by this application. */

package/dist/platform/routing.d.ts

@@ -8,6 +8,26 @@ export interface RouteDefinition {
     resource: string;
     /** If true, the path must match exactly. */
     exact?: boolean;
+    /**
+     * Fixed props handed to the resource on top of the path parameters.
+     *
+     * Lets one component serve several routes without the viewport having to
+     * remount a different resource per URL — which is what makes navigating
+     * between them flash. Two paths that produce the same parameters (a list and
+     * its `/search` sibling, say) stay distinguishable because the route says
+     * which one it is.
+     *
+     * Path parameters win on a name collision: those come from the URL.
+     */
+    props?: Record<string, string>;
+    /**
+     * Readable without a session. The shell skips its bounce to the login screen
+     * for these paths and renders them without any chrome.
+     *
+     * This says nothing about the data behind the page: every server route is
+     * still authenticated unless it opts out with `{ authenticated: false }`.
+     */
+    public?: boolean;
 }
 export interface NamespacedRouteDefinition extends RouteDefinition {
     appName: string;
@@ -39,3 +59,54 @@ export declare function appNameFromPath(path: string | null | undefined): string
  * and `WakeRoute` routes onward itself.
  */
 export declare function isDeepLink(path: string | null | undefined): boolean;
+/** Turn a route pattern with `:param` segments into an exact-match regex. */
+export declare function pathToRegex(path: string): RegExp;
+/** Read the `:param` values out of a concrete path, given the pattern it matched. */
+export declare function extractParams(pattern: string, actualPath: string): Record<string, string>;
+/** The shape of a manifest this module needs; keeps it free of the manifest module. */
+export interface PublicRouteSource {
+    name: string;
+    /**
+     * Root path the app's public routes hang under, e.g. `/help`. Absent means
+     * they keep the normal `/apps/{name}` prefix — public, just not pretty.
+     */
+    publicBasePath?: string;
+    routes?: RouteDefinition[];
+}
+export interface PublicRoutePattern {
+    appName: string;
+    resource: string;
+    /** Absolute pattern, e.g. `/help/:hcSlug/:locale`. */
+    pattern: string;
+    /** See {@link RouteDefinition.props}. */
+    props?: Record<string, string>;
+}
+export interface PublicRouteMatch extends PublicRoutePattern {
+    params: Record<string, string>;
+}
+/** Where an app's public routes are mounted. */
+export declare function publicBasePathFor(app: PublicRouteSource): string;
+/** Every public route across the installed apps, as absolute patterns. */
+export declare function publicRoutePatterns(apps: Iterable<PublicRouteSource>): PublicRoutePattern[];
+/**
+ * Is `a` a more specific pattern than `b`?
+ *
+ * Segment by segment, a literal beats a parameter: `/help/:hc/:locale/search`
+ * has to win over `/help/:hc/:locale/:collection`, or a help centre can never
+ * have a search page. Comparing string lengths would get exactly that case
+ * backwards, since `:collection` is the longer text.
+ *
+ * Exported because the shell asks the same question about `/apps/{name}` routes.
+ * It used to answer it with "whichever matched last", so a declared `/create`
+ * lost to the `/:id` below it — the opposite of what the author wrote down.
+ */
+export declare function isMoreSpecificPattern(a: string, b: string): boolean;
+/**
+ * The public route this path lands on, or null.
+ *
+ * Most specific pattern wins, so registration order never decides which page a
+ * URL opens.
+ */
+export declare function matchPublicRoute(path: string | null | undefined, patterns: readonly PublicRoutePattern[]): PublicRouteMatch | null;
+/** Does this path resolve to a page that may be read without a session? */
+export declare function isPublicPath(path: string | null | undefined, patterns: readonly PublicRoutePattern[]): boolean;

package/dist/platform/sdk.d.ts

@@ -22,7 +22,16 @@ export interface InternalSDK<LocalServices extends ServiceMap = {}, TranslationK
         invoke<R = any>(options: InvokeOptions): Promise<R>;
     };
     readonly router: {
+        /** Relative to the app's own `/apps/{appName}` prefix. */
         navigate(path: string, options?: any): void;
+        /**
+         * Straight to a shell path, no prefix.
+         *
+         * For the app's `public: true` routes: those hang off the manifest's
+         * `publicBasePath` (`/help/…`), so the app prefix would point at a page
+         * that does not exist.
+         */
+        navigateAbsolute(path: string, options?: any): void;
         currentPath(): string;
         path$: Observable<string>;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencxh/domain",
-  "version": "1.141.0",
+  "version": "1.144.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",