@greensecurity/javascript-sdk 0.46.0-beta.9 → 0.47.0-beta.0

package/dist/esm/apps/protocol.d.ts.map

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

package/dist/esm/apps/route.d.ts

@@ -1,5 +1,5 @@
 import { type SurfaceId } from "./surfaces.js";
-/** Values the destination view receives as `environment.queryParams`. Strings only. */
+/** Values the destination view receives as `environment.navParams`, never as `queryParams`. Strings only. */
 export type EnvParams = Record<string, string>;
 export type RouteDescriptor = 
 /** The screen a surface lives on, optionally for one record (detail surfaces). */
@@ -13,6 +13,16 @@ export type RouteDescriptor =
  | {
     type: "appSettings";
     envParams?: EnvParams;
+}
+/**
+ * One of the calling app's own pages, by concrete path in the app's space (`/reports/7`, not
+ * `/reports/:id`). The host checks that it matches one of the app's routes offered in the
+ * current portal. There is no `appId`: an app can only open its own pages.
+ */
+ | {
+    type: "appPage";
+    path: string;
+    envParams?: EnvParams;
 };
 export declare function isRouteDescriptor(value: unknown): value is RouteDescriptor;
 //# sourceMappingURL=route.d.ts.map

package/dist/esm/apps/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/apps/route.ts"],"names":[],"mappings":"AAQA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE5D,uFAAuF;AACvF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE/C,MAAM,MAAM,eAAe;AACzB,kFAAkF;AAChF;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE;AACrF,oEAAoE;GAClE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAEnD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAmB1E"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/apps/route.ts"],"names":[],"mappings":"AAUA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE3D,6GAA6G;AAC7G,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE/C,MAAM,MAAM,eAAe;AACzB,kFAAkF;AAChF;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE;AACrF,oEAAoE;GAClE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE;AAChD;;;;GAIG;GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAE7D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAuB1E"}

package/dist/esm/apps/route.js

@@ -2,10 +2,12 @@
  * Hand-written (not generated by Speakeasy). Part of the third-party app platform contract;
  * see docs/third-party-apps/plan.md.
  *
- * Apps never navigate by path. They name a destination and the host maps it to its own routes,
- * which keeps host URLs free to change and stops an app from steering users to arbitrary pages.
+ * Apps never navigate by host path. They name a destination and the host maps it to its own
+ * routes, which keeps host URLs free to change and stops an app from steering users to arbitrary
+ * pages. The one path an app writes, `appPage`, is a path inside its own pages space.
  */
-import { isSurfaceId } from "./surfaces.js";
+import { isConcreteRoutePath } from "./routes.js";
+import { getSurface } from "./surfaces.js";
 export function isRouteDescriptor(value) {
     if (typeof value !== "object" || value === null || !("type" in value))
         return false;
@@ -14,14 +16,18 @@ export function isRouteDescriptor(value) {
         return false;
     switch (v["type"]) {
         case "surface":
-            // Only catalog surfaces: the host has no route for anything else. Safe integers only, so a
-            // record id is never silently rounded on its way through JSON. `settings` is reachable only
-            // as `appSettings`, which always means the calling app: as a plain surface its `objectId`
-            // would name another app's settings page.
-            return isSurfaceId(v["surfaceId"]) && v["surfaceId"] !== "settings" &&
+            // Only catalog surfaces of a portal: the host has no route for anything else. Safe integers
+            // only, so a record id is never silently rounded on its way through JSON. The portal-less
+            // surfaces belong to an app and are reachable only through descriptors that always mean the
+            // calling app (`appSettings`, `appPage`): as a plain surface, `objectId` would name another
+            // app's settings page or pages.
+            return typeof v["surfaceId"] === "string" && (getSurface(v["surfaceId"])?.portal ?? null) !== null &&
                 (v["objectId"] === undefined || (Number.isSafeInteger(v["objectId"]) && v["objectId"] > 0));
         case "appSettings":
             return true;
+        case "appPage":
+            // Concrete paths only, in the route grammar: no params, dots, escapes or empty segments.
+            return isConcreteRoutePath(v["path"]);
         default:
             return false;
     }

package/dist/esm/apps/route.js.map

@@ -1 +1 @@
-{"version":3,"file":"route.js","sourceRoot":"","sources":["../../../src/apps/route.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAkB,MAAM,eAAe,CAAC;AAW5D,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpF,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,WAAW,CAAC,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE/E,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,KAAK,SAAS;YACZ,2FAA2F;YAC3F,4FAA4F;YAC5F,0FAA0F;YAC1F,0CAA0C;YAC1C,OAAO,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,KAAK,UAAU;gBACjE,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAK,CAAC,CAAC,UAAU,CAAY,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5G,KAAK,aAAa;YAChB,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../../src/apps/route.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAkB,MAAM,eAAe,CAAC;AAiB3D,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpF,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,WAAW,CAAC,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE/E,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,KAAK,SAAS;YACZ,4FAA4F;YAC5F,0FAA0F;YAC1F,4FAA4F;YAC5F,4FAA4F;YAC5F,gCAAgC;YAChC,OAAO,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC,KAAK,IAAI;gBAChG,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAK,CAAC,CAAC,UAAU,CAAY,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5G,KAAK,aAAa;YAChB,OAAO,IAAI,CAAC;QACd,KAAK,SAAS;YACZ,yFAAyF;YACzF,OAAO,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACxC;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;AAC7D,CAAC"}

package/dist/esm/apps/routes.d.ts

@@ -0,0 +1,65 @@
+/**
+ * A declared route path: `/`, or `/seg(/seg)*` where each segment is static or a `:param`. No dots,
+ * percent-escapes, upper case, empty segments or trailing slash, so no path can climb out of the
+ * app's own space. `pages` is not reserved inside that space: `/pages/foo` is an ordinary path.
+ */
+export declare const ROUTE_PATH_PATTERN = "^/(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|:[a-z][a-z0-9_]*)(?:/(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|:[a-z][a-z0-9_]*))*)?$";
+/** A concrete path an app navigates to (`{ type: "appPage" }`): the same grammar without params. */
+export declare const CONCRETE_ROUTE_PATH_PATTERN = "^/(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:/[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)*)?$";
+export declare const ROUTE_PATH_MAX_CHARS = 200;
+/** Segments in one path; `/` has none. */
+export declare const ROUTE_PATH_MAX_SEGMENTS = 8;
+/** Routes in one manifest. */
+export declare const APP_ROUTES_MAX = 50;
+/** A declared route path: the {@link ROUTE_PATH_PATTERN} grammar, ≤ 200 characters and ≤ 8 segments. */
+export declare function isRoutePath(value: unknown): value is string;
+/** A concrete route path (no `:param` segments) within the same limits as a declared one. */
+export declare function isConcreteRoutePath(value: unknown): value is string;
+/**
+ * Renames every param segment to `:_`. Two paths that normalize to the same string claim the same
+ * URLs (`/vendors/:id` and `/vendors/:vendor_id`), so a manifest may declare only one of them.
+ */
+export declare function normalizeRoutePath(path: string): string;
+export interface RouteSetIssue {
+    /** Index of the offending entry in `routes`. */
+    index: number;
+    field: "path" | "portals" | "navigation";
+    message: string;
+}
+/**
+ * The rules over a set of routes that a pattern alone cannot express: the segment cap, a param
+ * name used twice in one path, two paths claiming the same URLs, and a repeated portal. Grammar,
+ * length and the per-field limits are the schema's job; a path that fails the grammar is skipped
+ * here. The zod schema and `apps-cli validate` both report these, and the server repeats them.
+ */
+export declare function routeSetIssues(routes: ReadonlyArray<{
+    path: string;
+    portals?: readonly string[] | undefined;
+    navigation?: unknown;
+}>): RouteSetIssue[];
+export interface AppRouteMatch<R> {
+    route: R;
+    /** Param values by name, percent-decoded. Always strings: the app parses ids itself. */
+    params: Record<string, string>;
+    /** Index of `route` in the list passed to {@link matchAppRoute}. */
+    index: number;
+}
+/**
+ * Finds the route a pathname in the app's own space renders (`/reports/7` for
+ * `/{portal}/apps/{appId}/pages/reports/7`), or `null` when none does.
+ *
+ * `pathname` is URL-encoded, as it appears in a URL: `/` or `/seg(/seg)*` with no empty segment,
+ * trailing slash, query or fragment (anything else matches nothing). A host that receives decoded
+ * segments encodes each with `encodeURIComponent` before joining them.
+ *
+ * A static route segment matches only the identical pathname segment. A param segment matches any
+ * other segment that decodes to a plain value (see `paramValue`); a segment containing `:` never
+ * matches a param. When several routes match, the one with a static segment at the first position
+ * where they differ wins (static before param, left to right); among equals, the first declared.
+ * Routes whose path is not in the grammar are ignored, so a stale or hand-edited feed entry can
+ * never match.
+ */
+export declare function matchAppRoute<R extends {
+    path: string;
+}>(routes: readonly R[], pathname: string): AppRouteMatch<R> | null;
+//# sourceMappingURL=routes.d.ts.map

package/dist/esm/apps/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/apps/routes.ts"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,2HAC2F,CAAC;AAE3H,oGAAoG;AACpG,eAAO,MAAM,2BAA2B,iFAAqD,CAAC;AAE9F,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,0CAA0C;AAC1C,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,8BAA8B;AAC9B,eAAO,MAAM,cAAc,KAAK,CAAC;AAkBjC,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE3D;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GACrG,aAAa,EAAE,CAgDjB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC;IACT,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;CACf;AAmBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACtD,MAAM,EAAE,SAAS,CAAC,EAAE,EACpB,QAAQ,EAAE,MAAM,GACf,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAazB"}

package/dist/esm/apps/routes.js

@@ -0,0 +1,194 @@
+/*
+ * Hand-written (not generated by Speakeasy). Part of the third-party app platform contract;
+ * see docs/third-party-apps/fullpageview-plan.md.
+ *
+ * App page routes (`ui_extensions.routes[]`): the path grammar, the uniqueness rule and the one
+ * matcher every consumer shares (the host, `apps-cli validate`, the contract tests). Deliberately
+ * dependency-free (no zod) so the host renderer can import it without bundling zod; `manifest.ts`
+ * re-exports it because it is part of the manifest contract.
+ *
+ * The server mirrors the grammar and `normalizeRoutePath` in Ruby and reads the same fixtures
+ * (`src/__tests__/apps/fixtures/routes.json`).
+ */
+/** A static segment: lower-case letters, digits and inner hyphens. */
+const STATIC_SEGMENT = "[a-z0-9](?:[a-z0-9-]*[a-z0-9])?";
+/** A param segment: `:` and a lower-case name. */
+const PARAM_SEGMENT = ":[a-z][a-z0-9_]*";
+/**
+ * A declared route path: `/`, or `/seg(/seg)*` where each segment is static or a `:param`. No dots,
+ * percent-escapes, upper case, empty segments or trailing slash, so no path can climb out of the
+ * app's own space. `pages` is not reserved inside that space: `/pages/foo` is an ordinary path.
+ */
+export const ROUTE_PATH_PATTERN = "^/(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|:[a-z][a-z0-9_]*)(?:/(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|:[a-z][a-z0-9_]*))*)?$";
+/** A concrete path an app navigates to (`{ type: "appPage" }`): the same grammar without params. */
+export const CONCRETE_ROUTE_PATH_PATTERN = `^/(?:${STATIC_SEGMENT}(?:/${STATIC_SEGMENT})*)?$`;
+export const ROUTE_PATH_MAX_CHARS = 200;
+/** Segments in one path; `/` has none. */
+export const ROUTE_PATH_MAX_SEGMENTS = 8;
+/** Routes in one manifest. */
+export const APP_ROUTES_MAX = 50;
+/** What every param segment becomes in {@link normalizeRoutePath}. */
+const PARAM_PLACEHOLDER = ":_";
+const ROUTE_PATH_RE = new RegExp(ROUTE_PATH_PATTERN);
+const CONCRETE_ROUTE_PATH_RE = new RegExp(CONCRETE_ROUTE_PATH_PATTERN);
+const PARAM_SEGMENT_RE = new RegExp(`^${PARAM_SEGMENT}$`);
+/** The segments of a path in the grammar; `/` has none. */
+function segmentsOf(path) {
+    return path === "/" ? [] : path.slice(1).split("/");
+}
+function withinLimits(path) {
+    return path.length <= ROUTE_PATH_MAX_CHARS && segmentsOf(path).length <= ROUTE_PATH_MAX_SEGMENTS;
+}
+/** A declared route path: the {@link ROUTE_PATH_PATTERN} grammar, ≤ 200 characters and ≤ 8 segments. */
+export function isRoutePath(value) {
+    return typeof value === "string" && ROUTE_PATH_RE.test(value) && withinLimits(value);
+}
+/** A concrete route path (no `:param` segments) within the same limits as a declared one. */
+export function isConcreteRoutePath(value) {
+    return typeof value === "string" && CONCRETE_ROUTE_PATH_RE.test(value) && withinLimits(value);
+}
+/**
+ * Renames every param segment to `:_`. Two paths that normalize to the same string claim the same
+ * URLs (`/vendors/:id` and `/vendors/:vendor_id`), so a manifest may declare only one of them.
+ */
+export function normalizeRoutePath(path) {
+    return path
+        .split("/")
+        .map((segment) => (segment.startsWith(":") ? PARAM_PLACEHOLDER : segment))
+        .join("/");
+}
+/**
+ * The rules over a set of routes that a pattern alone cannot express: the segment cap, a param
+ * name used twice in one path, two paths claiming the same URLs, and a repeated portal. Grammar,
+ * length and the per-field limits are the schema's job; a path that fails the grammar is skipped
+ * here. The zod schema and `apps-cli validate` both report these, and the server repeats them.
+ */
+export function routeSetIssues(routes) {
+    const issues = [];
+    const claimed = new Map();
+    routes.forEach((route, index) => {
+        const portals = route.portals ?? [];
+        if (new Set(portals).size !== portals.length) {
+            issues.push({ index, field: "portals", message: "portals must not repeat" });
+        }
+        if (!ROUTE_PATH_RE.test(route.path))
+            return;
+        const segments = segmentsOf(route.path);
+        if (segments.length > ROUTE_PATH_MAX_SEGMENTS) {
+            issues.push({
+                index,
+                field: "path",
+                message: `${route.path} has ${segments.length} segments; the limit is ${ROUTE_PATH_MAX_SEGMENTS}`,
+            });
+        }
+        const params = segments.filter((s) => s.startsWith(":"));
+        if (new Set(params).size !== params.length) {
+            issues.push({ index, field: "path", message: `${route.path} uses a param name twice` });
+        }
+        // A sidebar entry links to one fixed address, and a path with params has none.
+        if (params.length > 0 && route.navigation !== undefined) {
+            issues.push({
+                index,
+                field: "navigation",
+                message: `${route.path} has params, so it cannot have a navigation entry; add one to a path without params`,
+            });
+        }
+        const normalized = normalizeRoutePath(route.path);
+        const earlier = claimed.get(normalized);
+        if (earlier === undefined) {
+            claimed.set(normalized, route.path);
+        }
+        else {
+            issues.push({
+                index,
+                field: "path",
+                message: `${route.path} is declared twice (as ${earlier}); each path takes one page`,
+            });
+        }
+    });
+    return issues;
+}
+/**
+ * Decodes one pathname segment into a param value, or returns `null` when it cannot be one: a
+ * malformed escape, an empty value, `.` or `..`, or a value containing `/` or `:` (raw or
+ * encoded). A param therefore never carries a path or a host-looking value into the app.
+ */
+function paramValue(segment) {
+    if (segment.includes(":"))
+        return null;
+    let value;
+    try {
+        value = decodeURIComponent(segment);
+    }
+    catch {
+        return null;
+    }
+    if (value === "" || value === "." || value === ".." || value.includes("/") || value.includes(":"))
+        return null;
+    return value;
+}
+/**
+ * Finds the route a pathname in the app's own space renders (`/reports/7` for
+ * `/{portal}/apps/{appId}/pages/reports/7`), or `null` when none does.
+ *
+ * `pathname` is URL-encoded, as it appears in a URL: `/` or `/seg(/seg)*` with no empty segment,
+ * trailing slash, query or fragment (anything else matches nothing). A host that receives decoded
+ * segments encodes each with `encodeURIComponent` before joining them.
+ *
+ * A static route segment matches only the identical pathname segment. A param segment matches any
+ * other segment that decodes to a plain value (see `paramValue`); a segment containing `:` never
+ * matches a param. When several routes match, the one with a static segment at the first position
+ * where they differ wins (static before param, left to right); among equals, the first declared.
+ * Routes whose path is not in the grammar are ignored, so a stale or hand-edited feed entry can
+ * never match.
+ */
+export function matchAppRoute(routes, pathname) {
+    if (!pathname.startsWith("/") || /[?#]/.test(pathname))
+        return null;
+    const segments = segmentsOf(pathname);
+    if (segments.some((s) => s === ""))
+        return null;
+    let best = null;
+    for (const [index, route] of routes.entries()) {
+        const candidate = matchOne(route, index, segments);
+        if (candidate !== null && (best === null || outranks(candidate.rank, best.rank)))
+            best = candidate;
+    }
+    return best === null ? null : best.match;
+}
+/** Matches one route against the pathname's segments, with its static/param rank. */
+function matchOne(route, index, segments) {
+    if (!isRoutePath(route.path))
+        return null;
+    const pattern = segmentsOf(route.path);
+    if (pattern.length !== segments.length)
+        return null;
+    const params = {};
+    const rank = [];
+    for (let i = 0; i < pattern.length; i++) {
+        const expected = pattern[i] ?? "";
+        const actual = segments[i] ?? "";
+        if (PARAM_SEGMENT_RE.test(expected)) {
+            const value = paramValue(actual);
+            if (value === null)
+                return null;
+            params[expected.slice(1)] = value;
+            rank.push(false);
+        }
+        else {
+            if (expected !== actual)
+                return null;
+            rank.push(true);
+        }
+    }
+    return { match: { route, params, index }, rank };
+}
+/** Whether `a` has a static segment at the first position where it and `b` differ. */
+function outranks(a, b) {
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return a[i] === true;
+    }
+    return false;
+}
+//# sourceMappingURL=routes.js.map

package/dist/esm/apps/routes.js.map

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

package/dist/esm/apps/surfaces.d.ts

@@ -1,5 +1,7 @@
 export type Portal = "vendor" | "company" | "facility" | "system";
-export type SurfaceKind = "navigation" | "drawer.default" | "overview" | "list" | "list.row_action" | "detail" | "detail.tabs" | "settings";
+export type SurfaceKind = "navigation" | "drawer.default" | "overview" | "list" | "list.row_action" | "detail" | "detail.tabs" | "settings"
+/** An app page: one of the app's own `ui_extensions.routes`, rendered full screen. */
+ | "page";
 /**
  * The kind of record a surface is showing. These match the public API resource each one is
  * read through (`/vendors`, `/vendors/credentials`, `/facilities`, `/companies`,
@@ -27,6 +29,19 @@ export interface SurfaceDef {
     /** Wave 1 surfaces are rendered by the host; Wave 2 ids are reserved and accepted in manifests. */
     readonly wave: 1 | 2;
 }
+/**
+ * Host URL segment reserved for app pages: `/{portal}/apps/{appId}/pages{path}`. No host route may
+ * be defined under it except the screens that render app pages, so an app path can never shadow a
+ * host page. It is not reserved inside an app's own space: `/pages/foo` is an ordinary app path.
+ */
+export declare const APP_PAGES_SEGMENT = "pages";
+/**
+ * The host pathname of an app page: `/{portal}/apps/{appId}/pages{path}`, with the root path `/`
+ * at `/{portal}/apps/{appId}/pages`. Throws unless `appId` is a positive integer and `path` is a
+ * concrete route path (`isConcreteRoutePath`), so no input can resolve outside the app's own pages
+ * (`/../settings`, `//evil.example`).
+ */
+export declare function appPagePathname(portal: Portal, appId: number, path: string): string;
 export declare const SURFACES: readonly SurfaceDef[];
 /**
  * A surface identifier. This is deliberately a plain `string`: the catalog is data-driven, so the
@@ -38,6 +53,9 @@ export declare function isSurfaceId(value: unknown): value is SurfaceId;
 export declare function getSurface(id: string): SurfaceDef | undefined;
 /** The fallback surface a portal resolves to when an app has no view for the exact surface. */
 export declare function drawerDefaultFor(portal: Portal): SurfaceId;
-/** Surfaces the host renders for a portal in the given wave (and earlier waves). */
+/**
+ * Surfaces the host renders for a portal in the given wave (and earlier waves). Portal-less
+ * surfaces (`settings`, `page`) are never included: they belong to an app, not to a portal screen.
+ */
 export declare function surfacesForPortal(portal: Portal, wave?: 1 | 2): SurfaceDef[];
 //# sourceMappingURL=surfaces.d.ts.map

package/dist/esm/apps/surfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../../../src/apps/surfaces.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAElE,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,gBAAgB,GAChB,UAAU,GACV,MAAM,GACN,iBAAiB,GACjB,QAAQ,GACR,aAAa,GACb,UAAU,CAAC;AAEf;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,mBAAmB,GACnB,UAAU,GACV,SAAS,GACT,aAAa,GACb,SAAS,GACT,OAAO,GACP,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mGAAmG;IACnG,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;CACtB;AAsED,eAAO,MAAM,QAAQ,EAAE,SAAS,UAAU,EAOxC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAI/B,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE7D;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAE1D;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,CAAC,GAAG,CAAK,GAAG,UAAU,EAAE,CAE/E"}
+{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../../../src/apps/surfaces.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAElE,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,gBAAgB,GAChB,UAAU,GACV,MAAM,GACN,iBAAiB,GACjB,QAAQ,GACR,aAAa,GACb,UAAU;AACZ,sFAAsF;GACpF,MAAM,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GACpB,QAAQ,GAAG,mBAAmB,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAExH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mGAAmG;IACnG,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQnF;AA8ED,eAAO,MAAM,QAAQ,EAAE,SAAS,UAAU,EAWxC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAI/B,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE7D;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAE1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,CAAC,GAAG,CAAK,GAAG,UAAU,EAAE,CAE/E"}

package/dist/esm/apps/surfaces.js

@@ -2,6 +2,28 @@
  * Hand-written (not generated by Speakeasy). Part of the third-party app platform contract;
  * see docs/third-party-apps/plan.md. Host (web-mobile-client) and SDK both import from here.
  */
+import { isConcreteRoutePath } from "./routes.js";
+/**
+ * Host URL segment reserved for app pages: `/{portal}/apps/{appId}/pages{path}`. No host route may
+ * be defined under it except the screens that render app pages, so an app path can never shadow a
+ * host page. It is not reserved inside an app's own space: `/pages/foo` is an ordinary app path.
+ */
+export const APP_PAGES_SEGMENT = "pages";
+/**
+ * The host pathname of an app page: `/{portal}/apps/{appId}/pages{path}`, with the root path `/`
+ * at `/{portal}/apps/{appId}/pages`. Throws unless `appId` is a positive integer and `path` is a
+ * concrete route path (`isConcreteRoutePath`), so no input can resolve outside the app's own pages
+ * (`/../settings`, `//evil.example`).
+ */
+export function appPagePathname(portal, appId, path) {
+    if (!Number.isSafeInteger(appId) || appId <= 0) {
+        throw new RangeError(`appPagePathname: app id must be a positive integer, got ${String(appId)}`);
+    }
+    if (!isConcreteRoutePath(path)) {
+        throw new RangeError(`appPagePathname: not a concrete route path: ${JSON.stringify(path)}`);
+    }
+    return `/${portal}/apps/${appId}/${APP_PAGES_SEGMENT}${path === "/" ? "" : path}`;
+}
 /** Expands a list surface into the surface itself and its row-action surface. */
 function list(portal, entity, objectType, route) {
     return [
@@ -60,7 +82,15 @@ function staffPortal(portal) {
     ];
 }
 function define(portal, wave, entries) {
-    return entries.map(([id, kind, objectType, route, idParam]) => ({ id, portal, kind, objectType, route, idParam, wave }));
+    return entries.map(([id, kind, objectType, route, idParam]) => ({
+        id,
+        portal,
+        kind,
+        objectType,
+        route,
+        idParam,
+        wave,
+    }));
 }
 export const SURFACES = Object.freeze([
     ...define("company", 1, COMPANY),
@@ -69,6 +99,10 @@ export const SURFACES = Object.freeze([
     ...define("system", 2, staffPortal("system")),
     // The app's own settings page. Every portal has one, so the route names the portal as a segment.
     ...define(null, 1, [["settings", "settings", null, "/[portal]/apps/[appId]/settings", "appId"]]),
+    // Every app page (`ui_extensions.routes`), under the one prefix reserved for apps. Like
+    // `settings` it has no portal of its own, and it is not a view viewport or a `surface` target:
+    // apps declare pages as routes and reach them with `{ type: "appPage" }`.
+    ...define(null, 1, [["page", "page", null, `/[portal]/apps/[appId]/${APP_PAGES_SEGMENT}/[...path]`, "appId"]]),
 ]);
 const SURFACES_BY_ID = new Map(SURFACES.map((s) => [s.id, s]));
 export function isSurfaceId(value) {
@@ -81,7 +115,10 @@ export function getSurface(id) {
 export function drawerDefaultFor(portal) {
     return `gs.${portal}.drawer.default`;
 }
-/** Surfaces the host renders for a portal in the given wave (and earlier waves). */
+/**
+ * Surfaces the host renders for a portal in the given wave (and earlier waves). Portal-less
+ * surfaces (`settings`, `page`) are never included: they belong to an app, not to a portal screen.
+ */
 export function surfacesForPortal(portal, wave = 1) {
     return SURFACES.filter((s) => s.portal === portal && s.wave <= wave);
 }

package/dist/esm/apps/surfaces.js.map

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

package/dist/esm/apps/testing/index.d.ts

@@ -1,7 +1,7 @@
 import { RemoteReceiver, type RemoteReceiverElement, type RemoteReceiverNode } from "@remote-dom/core/receivers";
 import type { ReactElement } from "react";
 import { type ComponentName } from "../components.js";
-import { type AppTokens, type ExtensionContext } from "../context.js";
+import { type AppTokens, type ExtensionContext, type PageRoute } from "../context.js";
 import type { HostApi } from "../protocol.js";
 import { REMOTE_FRAGMENT_TAG } from "../runtime/elements.js";
 import { type SandboxRuntime } from "../runtime/sandbox.js";
@@ -17,8 +17,24 @@ export declare function mockTokens(now?: number): AppTokens;
  * platform permissions such as `app_secrets.write` out of `auth.user.scope`: the server grants
  * them to the app's role only, so a real user token never carries them. The mock performs no
  * permission checks; stub the Secret Store's 403 yourself to test a missing grant.
+ *
+ * `environment.navParams` (what this app's own `navigate` passed as `envParams`) and
+ * `environment.queryParams` (an app page's URL query) both default to `{}`; set either to test a
+ * view opened by a navigation or from a link. Setting `environment.route` puts the view on an app
+ * page (see {@link mockPageRoute}).
  */
 export declare function getMockContext(overrides?: DeepPartial<ExtensionContext>): ExtensionContext;
+/**
+ * The `environment.route` the host sends for `pathname` on the declared route `path`, with its
+ * params decoded the way the host does it (`matchAppRoute`). `pathname` defaults to `path`, so a
+ * route without params needs only one argument. Throws when `pathname` does not match `path`:
+ * the host would never render that page.
+ *
+ * ```ts
+ * mockPageRoute("/reports/:id", "/reports/7"); // { path: "/reports/:id", pathname: "/reports/7", params: { id: "7" } }
+ * ```
+ */
+export declare function mockPageRoute(path: string, pathname?: string): PageRoute;
 export interface HostCall {
     method: keyof HostApi;
     args: unknown[];

package/dist/esm/apps/testing/index.d.ts.map

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