@owlmeans/route 0.1.18-rc.33 → 0.1.18-rc.35

package/README.md

@@ -16,7 +16,7 @@ context that asks, so the same declaration serves a server and a browser alike.
 ## Installation
 
 ```bash
-bun add @owlmeans/route@^0.1.18-rc.33
+bun add @owlmeans/route@^0.1.18-rc.35
 ```
 
 ## Concepts
@@ -148,7 +148,7 @@ Once protocols are registered on a context, the entrypoint accessors answer addr
 ```ts
 import { AppType } from '@owlmeans/context'
 import { service } from '@owlmeans/config'
-import { resolveAddress, resolveMount } from '@owlmeans/route/utils'
+import { routeAddressOf } from '@owlmeans/route/utils'
 import { invoiceProtocols } from 'my-app-common'
 
 // Config side: the service the backend routes resolve against
@@ -163,8 +163,9 @@ entrypoint.isLocal() // true inside the my-app-api process
 
 // Same answers from a declaration
 const declaration = invoiceProtocols.create.route.route
-resolveMount(context, declaration)
-resolveAddress(context, declaration)
+const addresses = routeAddressOf(context)
+addresses.resolveMount(declaration)
+addresses.resolveAddress(declaration)
 ```
 
 ## API
@@ -197,20 +198,22 @@ resolveAddress(context, declaration)
 
 ### `@owlmeans/route/utils`
 
-The first six take `(context, declaration)`; the other four are pure and take no context.
+`routeAddressOf(context)` answers address questions against a context (one helper per context,
+built on first use; `makeRouteAddressHelper(context)` builds a fresh one). `routeDeclarationHelper`
+and `serviceRouteHelper` are pure and take no context.
 
 | Symbol | Kind | Purpose |
 |--------|------|---------|
-| `resolvePath(context, route)` | function | Every ancestor's segment, then this one |
-| `resolveMount(context, route)` | function | Service `base` + the full path |
-| `resolveService(context, route)` | function | The named service, else the default of the route's type, else the first of that type |
-| `resolveAddress(context, route)` | function | The `RouteAddress`; a hop over the service's internal host is never TLS |
-| `isLocalRoute(context, route)` | function | Does the route belong to the context's own service |
-| `getParentRoute(context, route)` | function | The parent declaration, with parentship-cycle detection |
-| `overrideParams(route, overrides?, filter?)` | function | Fill only blank fields of `route` from `overrides`; mutates, returns nothing |
-| `prependBase(route, path)` | function | `path` prefixed with `route.base` when set |
-| `isServiceRoute(obj?)` | type guard | Is `obj` a `CommonServiceRoute` with a known `AppType` |
-| `isServiceRouteResolved(route)` | type guard | Does the service entry name a host |
+| `routeAddressOf(context).resolvePath(route)` | helper member | Every ancestor's segment, then this one |
+| `routeAddressOf(context).resolveMount(route)` | helper member | Service `base` + the full path |
+| `routeAddressOf(context).resolveService(route)` | helper member | The named service, else the default of the route's type, else the first of that type |
+| `routeAddressOf(context).resolveAddress(route)` | helper member | The `RouteAddress`; a hop over the service's internal host is never TLS |
+| `routeAddressOf(context).isLocalRoute(route)` | helper member | Does the route belong to the context's own service |
+| `routeAddressOf(context).getParentRoute(route)` | helper member | The parent declaration, with parentship-cycle detection |
+| `routeDeclarationHelper.overrideParams(route, overrides?, filter?)` | helper member | Fill only blank fields of `route` from `overrides`; mutates, returns nothing |
+| `routeDeclarationHelper.prependBase(route, path)` | helper member | `path` prefixed with `route.base` when set |
+| `serviceRouteHelper.isServiceRoute(obj?)` | type guard | Is `obj` a `CommonServiceRoute` with a known `AppType` |
+| `serviceRouteHelper.isServiceRouteResolved(route)` | type guard | Does the service entry name a host |
 | `CreateRouteSignature<R>` | interface | Call signature shared by `route()` and `createRoute()` |
 
 ## Common pitfalls
@@ -224,8 +227,8 @@ The first six take `(context, declaration)`; the other four are pure and take no
   the chain.
 - Custom transport options are opaque here. Validate them through the package that owns the
   protocol.
-- Do not pass a context to the pure `./utils` helpers: `overrideParams(ctx, decl)` writes route
-  fields into the context object instead of resolving anything.
+- Do not pass a context to the pure `./utils` helpers: `routeDeclarationHelper.overrideParams(ctx, decl)`
+  writes route fields into the context object instead of resolving anything.
 - A mis-wired tree (no `cfg.services`, a service without a host, a parentship cycle) throws
   `SyntaxError` when an address is resolved. Fix the config; do not catch it.
 - `transportAlias` and `EntrypointTransport` live in `@owlmeans/entrypoint`, not here. A route only
@@ -250,7 +253,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.36
+npx @owlmeans/agent-skills@^0.1.18-rc.49
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/route",
-  "version": "0.1.18-rc.33",
-  "generatedAt": "2026-09-22T22:24:39.586Z",
+  "version": "0.1.18-rc.35",
+  "generatedAt": "2026-10-05T21:03:06.407Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/route/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/route
 
 **Layer:** Core
-**Install:** `"@owlmeans/route": "^0.1.18-rc.33"` in `dependencies`
+**Install:** `"@owlmeans/route": "^0.1.18-rc.35"` in `dependencies`
 
 ## Key Exports
 

package/build/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAuB,EAAc,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAElF,MAAM,CAAC,MAAM,WAAW,GAA2C,CAAC,KAAK,EAAE,IAAI,EAAE,IAAK,EAAE,EAAE;IACxF,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAClE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAA;IACzC,MAAM,KAAK,GAAqB;QAC9B,KAAK;QACL,IAAI,EAAE,OAAO,CAAC,OAAO;QACrB,IAAI;QACJ,GAAG,IAAI;QACP,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;KAC1F,CAAA;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAuB,EAAc,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAElF,MAAM,CAAC,MAAM,WAAW,GAA2C,CAAC,KAAK,EAAE,IAAI,EAAE,IAAK,EAAoB,EAAE;IAC1G,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAClE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAA;IACzC,MAAM,KAAK,GAAqB;QAC9B,KAAK;QACL,IAAI,EAAE,OAAO,CAAC,OAAO;QACrB,IAAI;QACJ,GAAG,IAAI;QACP,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;KAC1F,CAAA;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/build/utils/declaration/types.d.ts

@@ -0,0 +1,9 @@
+import type { RouteDeclaration } from '../../types.js';
+/** Context-free edits and reads of one route declaration. */
+export interface RouteDeclarationHelper {
+    /** Fills the declaration's unset fields from `overrides`, limited to `filter` keys when given. */
+    overrideParams: (route: RouteDeclaration, overrides?: Partial<RouteDeclaration>, filter?: string[]) => void;
+    /** `path` under the declaration's own `base`, when it has one. */
+    prependBase: (route: RouteDeclaration, path: string) => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/utils/declaration/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/declaration/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,6DAA6D;AAC7D,MAAM,WAAW,sBAAsB;IACrC,kGAAkG;IAClG,cAAc,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IAC3G,kEAAkE;IAClE,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAC/D"}

package/build/utils/declaration/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/utils/declaration/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/declaration/types.ts"],"names":[],"mappings":""}

package/build/utils/declaration.d.ts

@@ -0,0 +1,4 @@
+import type { RouteDeclarationHelper } from './declaration/types.js';
+export declare const createRouteDeclarationHelper: () => RouteDeclarationHelper;
+export declare const routeDeclarationHelper: RouteDeclarationHelper;
+//# sourceMappingURL=declaration.d.ts.map

package/build/utils/declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../src/utils/declaration.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAEpE,eAAO,MAAM,4BAA4B,QAAO,sBAgB/C,CAAA;AAED,eAAO,MAAM,sBAAsB,wBAAiC,CAAA"}

package/build/utils/declaration.js

@@ -0,0 +1,18 @@
+import { normalizePath } from '../helper.js';
+import { SEP } from '../consts.js';
+export const createRouteDeclarationHelper = () => {
+    const overrideParams = (route, overrides, filter) => {
+        Object.entries(overrides ?? {}).forEach(([key, value]) => {
+            if (route[key] == null
+                && (filter == null || filter.includes(key))) {
+                route[key] = value;
+            }
+        });
+    };
+    const prependBase = (route, path) => route.base != null && route.base.trim() !== ''
+        ? SEP + normalizePath(route.base) + SEP + normalizePath(path)
+        : path;
+    return { overrideParams, prependBase };
+};
+export const routeDeclarationHelper = createRouteDeclarationHelper();
+//# sourceMappingURL=declaration.js.map

package/build/utils/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../src/utils/declaration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAGlC,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAA2B,EAAE;IACvE,MAAM,cAAc,GAAG,CAAC,KAAuB,EAAE,SAAqC,EAAE,MAAiB,EAAQ,EAAE;QACjH,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACvD,IAAI,KAAK,CAAC,GAA6B,CAAC,IAAI,IAAI;mBAC3C,CAAC,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC7C,KAAK,CAAC,GAA6B,CAA8C,GAAG,KAAK,CAAA;YAC5F,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,CAAC,KAAuB,EAAE,IAAY,EAAU,EAAE,CACpE,KAAK,CAAC,IAAI,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAC5C,CAAC,CAAC,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC;QAC7D,CAAC,CAAC,IAAI,CAAA;IAEV,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,CAAA;AACxC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,EAAE,CAAA"}

package/build/utils/index.d.ts

@@ -1,4 +1,8 @@
 export * from './types.js';
+export type * from './route/types.js';
+export type * from './declaration/types.js';
+export type * from './service/types.js';
 export * from './service.js';
 export * from './route.js';
+export * from './declaration.js';
 //# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,wBAAwB,CAAA;AAC3C,mBAAmB,oBAAoB,CAAA;AACvC,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA"}

package/build/utils/index.js

@@ -1,4 +1,5 @@
 export * from './types.js';
 export * from './service.js';
 export * from './route.js';
+export * from './declaration.js';
 //# sourceMappingURL=index.js.map

package/build/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAI1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA"}

package/build/utils/route/types.d.ts

@@ -0,0 +1,35 @@
+import type { RouteAddress, RouteDeclaration, ResolvedServiceRoute } from '../../types.js';
+/**
+ * Where routes answer, worked out on demand against the context that asks — a declaration states
+ * only what it contributes and every address question walks the parent chain through the context.
+ */
+export interface RouteAddressHelper {
+    /**
+     * The declaration of the route's parent entrypoint, or `null` for a root route.
+     *
+     * @throws {SyntaxError} when the parent provides no route or the parent chain is a cycle
+     */
+    getParentRoute: (route: RouteDeclaration) => RouteDeclaration | null;
+    /**
+     * Pick the service route this declaration answers on: the one it names, else the default of its
+     * app type, else the first of its app type.
+     *
+     * @throws {SyntaxError}
+     */
+    resolveService: (route: RouteDeclaration) => ResolvedServiceRoute;
+    /**
+     * The full path: every ancestor's declared segment, then this one. Walks the parent chain through
+     * the context, so a declaration always states only what it contributes.
+     */
+    resolvePath: (route: RouteDeclaration) => string;
+    /** `base` + the full path — what a server mounts and a client requests. */
+    resolveMount: (route: RouteDeclaration) => string;
+    /**
+     * Where the route answers. A backend caller reaching a service over its INTERNAL host is inside the
+     * cluster, so that hop is never TLS.
+     */
+    resolveAddress: (route: RouteDeclaration) => RouteAddress;
+    /** Does this route belong to the service the asking context IS? */
+    isLocalRoute: (route: RouteDeclaration) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/utils/route/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/route/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAE1F;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,gBAAgB,GAAG,IAAI,CAAA;IACpE;;;;;OAKG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,oBAAoB,CAAA;IACjE;;;OAGG;IACH,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,MAAM,CAAA;IAChD,2EAA2E;IAC3E,YAAY,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,MAAM,CAAA;IACjD;;;OAGG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,YAAY,CAAA;IACzD,mEAAmE;IACnE,YAAY,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAA;CACnD"}

package/build/utils/route/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/utils/route/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/route/types.ts"],"names":[],"mappings":""}

package/build/utils/route.d.ts

@@ -1,29 +1,6 @@
-import type { BasicConfig, BasicContext } from '@owlmeans/context';
-import type { RouteAddress, RouteDeclaration, ResolvedServiceRoute } from '../types.js';
-type Config = BasicConfig;
-export declare const getParentRoute: <C extends Config, T extends BasicContext<C>>(context: T, route: RouteDeclaration) => RouteDeclaration | null;
-export declare const overrideParams: (route: RouteDeclaration, overrides?: Partial<RouteDeclaration>, filter?: string[]) => void;
-/**
- * Pick the service route this declaration answers on: the one it names, else the default of its
- * app type, else the first of its app type.
- *
- * @throws {SyntaxError}
- */
-export declare const resolveService: <C extends Config, T extends BasicContext<C>>(context: T, route: RouteDeclaration) => ResolvedServiceRoute;
-/**
- * The full path: every ancestor's declared segment, then this one. Walks the parent chain through
- * the context, so a declaration always states only what it contributes.
- */
-export declare const resolvePath: <C extends Config, T extends BasicContext<C>>(context: T, route: RouteDeclaration) => string;
-/** `base` + the full path — what a server mounts and a client requests. */
-export declare const resolveMount: <C extends Config, T extends BasicContext<C>>(context: T, route: RouteDeclaration) => string;
-/**
- * Where the route answers. A backend caller reaching a service over its INTERNAL host is inside the
- * cluster, so that hop is never TLS.
- */
-export declare const resolveAddress: <C extends Config, T extends BasicContext<C>>(context: T, route: RouteDeclaration) => RouteAddress;
-/** Does this route belong to the service the asking context IS? */
-export declare const isLocalRoute: <C extends Config, T extends BasicContext<C>>(context: T, route: RouteDeclaration) => boolean;
-export declare const prependBase: (route: RouteDeclaration, path: string) => string;
-export {};
+import type { BasicContext } from '@owlmeans/context';
+import type { Config } from './types.local.js';
+import type { RouteAddressHelper } from './route/types.js';
+export declare const makeRouteAddressHelper: <C extends Config, T extends BasicContext<C>>(context: T) => RouteAddressHelper;
+export declare const routeAddressOf: <C extends Config, T extends BasicContext<C>>(target: T) => RouteAddressHelper;
 //# sourceMappingURL=route.d.ts.map

package/build/utils/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/utils/route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAc,MAAM,mBAAmB,CAAA;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAkC,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAKvH,KAAK,MAAM,GAAG,WAAW,CAAA;AAWzB,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAC/D,CAAC,SAAS,gBAAgB,KAClC,gBAAgB,GAAG,IAWrB,CAAA;AAED,eAAO,MAAM,cAAc,UAAW,gBAAgB,cAAc,OAAO,CAAC,gBAAgB,CAAC,WAAW,MAAM,EAAE,SAO/G,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAC/D,CAAC,SAAS,gBAAgB,KAClC,oBA4BF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAC5D,CAAC,SAAS,gBAAgB,KAClC,MASF,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAC7D,CAAC,SAAS,gBAAgB,KAClC,MAOF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAC/D,CAAC,SAAS,gBAAgB,KAClC,YAYF,CAAA;AAED,mEAAmE;AACnE,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAC7D,CAAC,SAAS,gBAAgB,KAClC,OAAyE,CAAA;AAgB5E,eAAO,MAAM,WAAW,UAAW,gBAAgB,QAAQ,MAAM,WAGvD,CAAA"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/utils/route.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAKrD,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,kBAAkB,CAAA;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAE1D,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,KAAG,kBAmGhG,CAAA;AAED,eAAO,MAAM,cAAc,GArGY,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,kCAqGV,CAAA"}

package/build/utils/route.js

@@ -1,104 +1,83 @@
-import { isServiceRoute, isServiceRouteResolved } from './service.js';
+import { memoHelper } from '@owlmeans/context';
+import { serviceRouteHelper } from './service.js';
 import { normalizePath } from '../helper.js';
 import { RouteProtocols, SEP } from '../consts.js';
-const carrier = (context, alias) => context.entrypoint(alias);
-export const getParentRoute = (context, route) => {
-    if (route.parent == null) {
-        return null;
-    }
-    const parent = carrier(context, route.parent);
-    if (parent.route == null) {
-        throw new SyntaxError('Parent entrypoint doesn\'t provide a route');
-    }
-    assertCycle(context, route, parent.route.route);
-    return parent.route.route;
-};
-export const overrideParams = (route, overrides, filter) => {
-    Object.entries(overrides ?? {}).forEach(([key, value]) => {
-        if (route[key] == null
-            && (filter == null || filter.includes(key))) {
-            route[key] = value;
+export const makeRouteAddressHelper = (context) => {
+    const { isServiceRoute, isServiceRouteResolved } = serviceRouteHelper;
+    const carrier = (alias) => context.entrypoint(alias);
+    const getParentRoute = (route) => {
+        if (route.parent == null) {
+            return null;
         }
-    });
-};
-/**
- * Pick the service route this declaration answers on: the one it names, else the default of its
- * app type, else the first of its app type.
- *
- * @throws {SyntaxError}
- */
-export const resolveService = (context, route) => {
-    if (context.cfg.services == null) {
-        throw new SyntaxError('Services aren\'t configured to resolve routes');
-    }
-    const named = context.cfg.services[route.service ?? context.cfg.service];
-    if (named != null && !isServiceRoute(named)) {
-        throw new SyntaxError('Service is not a valid service route');
-    }
-    const service = named?.type === route.type ? named
-        : Object.values(context.cfg.services).find((candidate) => {
-            const _candidate = candidate;
-            return _candidate.default === true && _candidate.type === route.type;
-        }) ?? Object.values(context.cfg.services).find((candidate) => candidate.type === route.type);
-    if (!isServiceRoute(service)) {
-        throw new SyntaxError('Service is not a valid service route');
-    }
-    if (!isServiceRouteResolved(service)) {
-        throw new SyntaxError('Service route is not resolved');
-    }
-    return service;
-};
-/**
- * The full path: every ancestor's declared segment, then this one. Walks the parent chain through
- * the context, so a declaration always states only what it contributes.
- */
-export const resolvePath = (context, route) => {
-    const parent = getParentRoute(context, route);
-    if (parent == null) {
-        return route.path;
-    }
-    const parentPath = resolvePath(context, parent);
-    return (parentPath.startsWith(SEP) ? SEP : '')
-        + normalizePath(normalizePath(parentPath) + SEP + normalizePath(route.path));
-};
-/** `base` + the full path — what a server mounts and a client requests. */
-export const resolveMount = (context, route) => {
-    const path = resolvePath(context, route);
-    const base = route.base ?? resolveService(context, route).base;
-    return base != null && base.trim() !== ''
-        ? SEP + normalizePath(base) + SEP + normalizePath(path)
-        : path;
-};
-/**
- * Where the route answers. A backend caller reaching a service over its INTERNAL host is inside the
- * cluster, so that hop is never TLS.
- */
-export const resolveAddress = (context, route) => {
-    const service = resolveService(context, route);
-    const host = route.host ?? service.host;
-    const internalHost = route.internalHost ?? service.internalHost;
-    return {
-        host,
-        port: route.port ?? service.port,
-        base: route.base ?? service.base,
-        secure: internalHost != null && internalHost === host ? false : route.secure ?? true,
-        protocol: route.protocol ?? RouteProtocols.WEB,
+        const parent = carrier(route.parent);
+        if (parent.route == null) {
+            throw new SyntaxError('Parent entrypoint doesn\'t provide a route');
+        }
+        assertCycle(route, parent.route.route);
+        return parent.route.route;
     };
-};
-/** Does this route belong to the service the asking context IS? */
-export const isLocalRoute = (context, route) => (route.service ?? context.cfg.service) === context.cfg.service;
-/**
- * @throws {SyntaxError}
- */
-const assertCycle = (context, route, parent) => {
-    while (parent.parent != null) {
-        if (parent.parent === route.alias) {
-            throw new SyntaxError(`Route parentship cycle detected. Parent: ${parent.alias} has his child as ancestor ${route.alias}`);
+    const resolveService = (route) => {
+        if (context.cfg.services == null) {
+            throw new SyntaxError('Services aren\'t configured to resolve routes');
+        }
+        const named = context.cfg.services[route.service ?? context.cfg.service];
+        if (named != null && !isServiceRoute(named)) {
+            throw new SyntaxError('Service is not a valid service route');
+        }
+        const service = named?.type === route.type ? named
+            : Object.values(context.cfg.services).find((candidate) => {
+                const _candidate = candidate;
+                return _candidate.default === true && _candidate.type === route.type;
+            }) ?? Object.values(context.cfg.services).find((candidate) => candidate.type === route.type);
+        if (!isServiceRoute(service)) {
+            throw new SyntaxError('Service is not a valid service route');
         }
-        parent = carrier(context, parent.parent).route.route;
-    }
+        if (!isServiceRouteResolved(service)) {
+            throw new SyntaxError('Service route is not resolved');
+        }
+        return service;
+    };
+    const resolvePath = (route) => {
+        const parent = getParentRoute(route);
+        if (parent == null) {
+            return route.path;
+        }
+        const parentPath = resolvePath(parent);
+        return (parentPath.startsWith(SEP) ? SEP : '')
+            + normalizePath(normalizePath(parentPath) + SEP + normalizePath(route.path));
+    };
+    const resolveMount = (route) => {
+        const path = resolvePath(route);
+        const base = route.base ?? resolveService(route).base;
+        return base != null && base.trim() !== ''
+            ? SEP + normalizePath(base) + SEP + normalizePath(path)
+            : path;
+    };
+    const resolveAddress = (route) => {
+        const service = resolveService(route);
+        const host = route.host ?? service.host;
+        const internalHost = route.internalHost ?? service.internalHost;
+        return {
+            host,
+            port: route.port ?? service.port,
+            base: route.base ?? service.base,
+            secure: internalHost != null && internalHost === host ? false : route.secure ?? true,
+            protocol: route.protocol ?? RouteProtocols.WEB,
+        };
+    };
+    const isLocalRoute = (route) => (route.service ?? context.cfg.service) === context.cfg.service;
+    /**
+     * @throws {SyntaxError}
+     */
+    const assertCycle = (route, parent) => {
+        while (parent.parent != null) {
+            if (parent.parent === route.alias) {
+                throw new SyntaxError(`Route parentship cycle detected. Parent: ${parent.alias} has his child as ancestor ${route.alias}`);
+            }
+            parent = carrier(parent.parent).route.route;
+        }
+    };
+    return { getParentRoute, resolveService, resolvePath, resolveMount, resolveAddress, isLocalRoute };
 };
-export const prependBase = (route, path) => route.base != null && route.base.trim() !== ''
-    ? SEP + normalizePath(route.base) + SEP + normalizePath(path)
-    : path;
+export const routeAddressOf = memoHelper.oncePer(makeRouteAddressHelper);
 //# sourceMappingURL=route.js.map

package/build/utils/route.js.map

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

package/build/utils/service/types.d.ts

@@ -0,0 +1,9 @@
+import type { CommonServiceRoute, ResolvedServiceRoute } from '../../types.js';
+/** Recognizes configured service routes. */
+export interface ServiceRouteHelper {
+    /** Whether a configured value is a service route: it names a service and a known app type. */
+    isServiceRoute: (obj?: Object) => obj is CommonServiceRoute;
+    /** A service route is usable exactly when it knows the host it answers on. */
+    isServiceRouteResolved: (route: CommonServiceRoute) => route is ResolvedServiceRoute;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/utils/service/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/service/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAE9E,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,8FAA8F;IAC9F,cAAc,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAA;IAC3D,8EAA8E;IAC9E,sBAAsB,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,KAAK,IAAI,oBAAoB,CAAA;CACrF"}

package/build/utils/service/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/utils/service/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/service/types.ts"],"names":[],"mappings":""}

package/build/utils/service.d.ts

@@ -1,5 +1,4 @@
-import type { ResolvedServiceRoute, CommonServiceRoute } from '../types.js';
-export declare const isServiceRoute: (obj?: Object) => obj is CommonServiceRoute;
-/** A service route is usable exactly when it knows the host it answers on. */
-export declare const isServiceRouteResolved: (route: CommonServiceRoute) => route is ResolvedServiceRoute;
+import type { ServiceRouteHelper } from './service/types.js';
+export declare const createServiceRouteHelper: () => ServiceRouteHelper;
+export declare const serviceRouteHelper: ServiceRouteHelper;
 //# sourceMappingURL=service.d.ts.map

package/build/utils/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/utils/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAE3E,eAAO,MAAM,cAAc,SAAU,MAAM,KAAG,GAAG,IAAI,kBAEM,CAAA;AAE3D,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,UAAW,kBAAkB,KAAG,KAAK,IAAI,oBAC5B,CAAA"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/utils/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAE5D,eAAO,MAAM,wBAAwB,QAAO,kBAS3C,CAAA;AAED,eAAO,MAAM,kBAAkB,oBAA6B,CAAA"}

package/build/utils/service.js

@@ -1,6 +1,9 @@
 import { AppType } from '@owlmeans/context';
-export const isServiceRoute = (obj) => obj != null && ('type' in obj) && ('service' in obj)
-    && (Object.values(AppType).includes(obj.type));
-/** A service route is usable exactly when it knows the host it answers on. */
-export const isServiceRouteResolved = (route) => route.host != null && route.host.trim() !== '';
+export const createServiceRouteHelper = () => {
+    const isServiceRoute = (obj) => obj != null && ('type' in obj) && ('service' in obj)
+        && (Object.values(AppType).includes(obj.type));
+    const isServiceRouteResolved = (route) => route.host != null && route.host.trim() !== '';
+    return { isServiceRoute, isServiceRouteResolved };
+};
+export const serviceRouteHelper = createServiceRouteHelper();
 //# sourceMappingURL=service.js.map

package/build/utils/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/utils/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAG3C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAY,EAA6B,EAAE,CACxE,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;OACjD,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAe,CAAC,CAAC,CAAA;AAE3D,8EAA8E;AAC9E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAyB,EAAiC,EAAE,CACjG,KAAK,CAAC,IAAI,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/utils/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAI3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAuB,EAAE;IAC/D,MAAM,cAAc,GAAG,CAAC,GAAY,EAA6B,EAAE,CACjE,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;WACjD,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAe,CAAC,CAAC,CAAA;IAE3D,MAAM,sBAAsB,GAAG,CAAC,KAAyB,EAAiC,EAAE,CAC1F,KAAK,CAAC,IAAI,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;IAEhD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,CAAA;AACnD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,EAAE,CAAA"}

package/build/utils/types.local.d.ts

@@ -0,0 +1,9 @@
+import type { BasicConfig, Contextual } from '@owlmeans/context';
+import type { RouteModel } from '../types.js';
+export type Config = BasicConfig;
+/** What an entrypoint looks like from the route layer: something that carries a route model. */
+export interface RouteCarrier extends Contextual {
+    _entrypoint: true;
+    route: RouteModel;
+}
+//# sourceMappingURL=types.local.d.ts.map

package/build/utils/types.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.local.d.ts","sourceRoot":"","sources":["../../src/utils/types.local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,MAAM,MAAM,GAAG,WAAW,CAAA;AAEhC,gGAAgG;AAChG,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,WAAW,EAAE,IAAI,CAAA;IACjB,KAAK,EAAE,UAAU,CAAA;CAClB"}

package/build/utils/types.local.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.local.js.map

package/build/utils/types.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.local.js","sourceRoot":"","sources":["../../src/utils/types.local.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/route",
-  "version": "0.1.18-rc.33",
+  "version": "0.1.18-rc.35",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -28,7 +28,7 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.18-rc.32"
+    "@owlmeans/context": "^0.1.18-rc.34"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/src/model.ts

@@ -4,7 +4,7 @@ import { AppType } from '@owlmeans/context'
 
 export const makeRouteModel = (route: RouteDeclaration): RouteModel => ({ route })
 
-export const createRoute: CreateRouteSignature<RouteDeclaration> = (alias, path, opts?) => {
+export const createRoute: CreateRouteSignature<RouteDeclaration> = (alias, path, opts?): RouteDeclaration => {
   const options = typeof opts === 'string' ? { parent: opts } : opts
   const { parent, ...rest } = options ?? {}
   const route: RouteDeclaration = {

package/src/utils/declaration/types.ts

@@ -0,0 +1,9 @@
+import type { RouteDeclaration } from '../../types.js'
+
+/** Context-free edits and reads of one route declaration. */
+export interface RouteDeclarationHelper {
+  /** Fills the declaration's unset fields from `overrides`, limited to `filter` keys when given. */
+  overrideParams: (route: RouteDeclaration, overrides?: Partial<RouteDeclaration>, filter?: string[]) => void
+  /** `path` under the declaration's own `base`, when it has one. */
+  prependBase: (route: RouteDeclaration, path: string) => string
+}

package/src/utils/declaration.ts

@@ -0,0 +1,24 @@
+import type { RouteDeclaration } from '../types.js'
+import { normalizePath } from '../helper.js'
+import { SEP } from '../consts.js'
+import type { RouteDeclarationHelper } from './declaration/types.js'
+
+export const createRouteDeclarationHelper = (): RouteDeclarationHelper => {
+  const overrideParams = (route: RouteDeclaration, overrides?: Partial<RouteDeclaration>, filter?: string[]): void => {
+    Object.entries(overrides ?? {}).forEach(([key, value]) => {
+      if (route[key as keyof RouteDeclaration] == null
+        && (filter == null || filter.includes(key))) {
+        (route[key as keyof RouteDeclaration] as RouteDeclaration[keyof RouteDeclaration]) = value
+      }
+    })
+  }
+
+  const prependBase = (route: RouteDeclaration, path: string): string =>
+    route.base != null && route.base.trim() !== ''
+      ? SEP + normalizePath(route.base) + SEP + normalizePath(path)
+      : path
+
+  return { overrideParams, prependBase }
+}
+
+export const routeDeclarationHelper = createRouteDeclarationHelper()

package/src/utils/index.ts

@@ -1,4 +1,8 @@
 
 export * from './types.js'
+export type * from './route/types.js'
+export type * from './declaration/types.js'
+export type * from './service/types.js'
 export * from './service.js'
 export * from './route.js'
+export * from './declaration.js'

package/src/utils/route/types.ts

@@ -0,0 +1,35 @@
+import type { RouteAddress, RouteDeclaration, ResolvedServiceRoute } from '../../types.js'
+
+/**
+ * Where routes answer, worked out on demand against the context that asks — a declaration states
+ * only what it contributes and every address question walks the parent chain through the context.
+ */
+export interface RouteAddressHelper {
+  /**
+   * The declaration of the route's parent entrypoint, or `null` for a root route.
+   *
+   * @throws {SyntaxError} when the parent provides no route or the parent chain is a cycle
+   */
+  getParentRoute: (route: RouteDeclaration) => RouteDeclaration | null
+  /**
+   * Pick the service route this declaration answers on: the one it names, else the default of its
+   * app type, else the first of its app type.
+   *
+   * @throws {SyntaxError}
+   */
+  resolveService: (route: RouteDeclaration) => ResolvedServiceRoute
+  /**
+   * The full path: every ancestor's declared segment, then this one. Walks the parent chain through
+   * the context, so a declaration always states only what it contributes.
+   */
+  resolvePath: (route: RouteDeclaration) => string
+  /** `base` + the full path — what a server mounts and a client requests. */
+  resolveMount: (route: RouteDeclaration) => string
+  /**
+   * Where the route answers. A backend caller reaching a service over its INTERNAL host is inside the
+   * cluster, so that hop is never TLS.
+   */
+  resolveAddress: (route: RouteDeclaration) => RouteAddress
+  /** Does this route belong to the service the asking context IS? */
+  isLocalRoute: (route: RouteDeclaration) => boolean
+}

package/src/utils/route.ts

@@ -1,151 +1,111 @@
-import type { BasicConfig, BasicContext, Contextual } from '@owlmeans/context'
-import type { RouteAddress, RouteDeclaration, RouteModel, CommonServiceRoute, ResolvedServiceRoute } from '../types.js'
-import { isServiceRoute, isServiceRouteResolved } from './service.js'
+import { memoHelper } from '@owlmeans/context'
+import type { BasicContext } from '@owlmeans/context'
+import type { RouteAddress, RouteDeclaration, CommonServiceRoute, ResolvedServiceRoute } from '../types.js'
+import { serviceRouteHelper } from './service.js'
 import { normalizePath } from '../helper.js'
 import { RouteProtocols, SEP } from '../consts.js'
+import type { Config, RouteCarrier } from './types.local.js'
+import type { RouteAddressHelper } from './route/types.js'
 
-type Config = BasicConfig
+export const makeRouteAddressHelper = <C extends Config, T extends BasicContext<C>>(context: T): RouteAddressHelper => {
+  const { isServiceRoute, isServiceRouteResolved } = serviceRouteHelper
 
-/** What an entrypoint looks like from the route layer: something that carries a route model. */
-interface RouteCarrier extends Contextual {
-  _entrypoint: true
-  route: RouteModel
-}
+  const carrier = (alias: string): RouteCarrier =>
+    context.entrypoint<RouteCarrier>(alias)
 
-const carrier = <C extends Config, T extends BasicContext<C>>(context: T, alias: string): RouteCarrier =>
-  context.entrypoint<RouteCarrier>(alias)
+  const getParentRoute = (route: RouteDeclaration): RouteDeclaration | null => {
+    if (route.parent == null) {
+      return null
+    }
+    const parent = carrier(route.parent)
+    if (parent.route == null) {
+      throw new SyntaxError('Parent entrypoint doesn\'t provide a route')
+    }
+    assertCycle(route, parent.route.route)
 
-export const getParentRoute = <C extends Config, T extends BasicContext<C>>(
-  context: T, route: RouteDeclaration
-): RouteDeclaration | null => {
-  if (route.parent == null) {
-    return null
+    return parent.route.route
   }
-  const parent = carrier<C, T>(context, route.parent)
-  if (parent.route == null) {
-    throw new SyntaxError('Parent entrypoint doesn\'t provide a route')
-  }
-  assertCycle<C, T>(context, route, parent.route.route)
 
-  return parent.route.route
-}
+  const resolveService = (route: RouteDeclaration): ResolvedServiceRoute => {
+    if (context.cfg.services == null) {
+      throw new SyntaxError('Services aren\'t configured to resolve routes')
+    }
 
-export const overrideParams = (route: RouteDeclaration, overrides?: Partial<RouteDeclaration>, filter?: string[]) => {
-  Object.entries(overrides ?? {}).forEach(([key, value]) => {
-    if (route[key as keyof RouteDeclaration] == null
-      && (filter == null || filter.includes(key))) {
-      (route[key as keyof RouteDeclaration] as RouteDeclaration[keyof RouteDeclaration]) = value
+    const named = context.cfg.services[route.service ?? context.cfg.service]
+    if (named != null && !isServiceRoute(named)) {
+      throw new SyntaxError('Service is not a valid service route')
     }
-  })
-}
 
-/**
- * Pick the service route this declaration answers on: the one it names, else the default of its
- * app type, else the first of its app type.
- *
- * @throws {SyntaxError}
- */
-export const resolveService = <C extends Config, T extends BasicContext<C>>(
-  context: T, route: RouteDeclaration
-): ResolvedServiceRoute => {
-  if (context.cfg.services == null) {
-    throw new SyntaxError('Services aren\'t configured to resolve routes')
-  }
+    const service = named?.type === route.type ? named
+      : Object.values(context.cfg.services).find<CommonServiceRoute>(
+        (candidate): candidate is CommonServiceRoute => {
+          const _candidate = candidate as CommonServiceRoute
+          return _candidate.default === true && _candidate.type === route.type
+        }
+      ) ?? Object.values(context.cfg.services).find<CommonServiceRoute>(
+        (candidate): candidate is CommonServiceRoute => (candidate as CommonServiceRoute).type === route.type
+      )
+
+    if (!isServiceRoute(service)) {
+      throw new SyntaxError('Service is not a valid service route')
+    }
+    if (!isServiceRouteResolved(service)) {
+      throw new SyntaxError('Service route is not resolved')
+    }
 
-  const named = context.cfg.services[route.service ?? context.cfg.service]
-  if (named != null && !isServiceRoute(named)) {
-    throw new SyntaxError('Service is not a valid service route')
+    return service
   }
 
-  const service = named?.type === route.type ? named
-    : Object.values(context.cfg.services).find<CommonServiceRoute>(
-      (candidate): candidate is CommonServiceRoute => {
-        const _candidate = candidate as CommonServiceRoute
-        return _candidate.default === true && _candidate.type === route.type
-      }
-    ) ?? Object.values(context.cfg.services).find<CommonServiceRoute>(
-      (candidate): candidate is CommonServiceRoute => (candidate as CommonServiceRoute).type === route.type
-    )
+  const resolvePath = (route: RouteDeclaration): string => {
+    const parent = getParentRoute(route)
+    if (parent == null) {
+      return route.path
+    }
+    const parentPath = resolvePath(parent)
 
-  if (!isServiceRoute(service)) {
-    throw new SyntaxError('Service is not a valid service route')
-  }
-  if (!isServiceRouteResolved(service)) {
-    throw new SyntaxError('Service route is not resolved')
+    return (parentPath.startsWith(SEP) ? SEP : '')
+      + normalizePath(normalizePath(parentPath) + SEP + normalizePath(route.path))
   }
 
-  return service
-}
+  const resolveMount = (route: RouteDeclaration): string => {
+    const path = resolvePath(route)
+    const base = route.base ?? resolveService(route).base
 
-/**
- * The full path: every ancestor's declared segment, then this one. Walks the parent chain through
- * the context, so a declaration always states only what it contributes.
- */
-export const resolvePath = <C extends Config, T extends BasicContext<C>>(
-  context: T, route: RouteDeclaration
-): string => {
-  const parent = getParentRoute<C, T>(context, route)
-  if (parent == null) {
-    return route.path
+    return base != null && base.trim() !== ''
+      ? SEP + normalizePath(base) + SEP + normalizePath(path)
+      : path
   }
-  const parentPath = resolvePath<C, T>(context, parent)
-
-  return (parentPath.startsWith(SEP) ? SEP : '')
-    + normalizePath(normalizePath(parentPath) + SEP + normalizePath(route.path))
-}
-
-/** `base` + the full path — what a server mounts and a client requests. */
-export const resolveMount = <C extends Config, T extends BasicContext<C>>(
-  context: T, route: RouteDeclaration
-): string => {
-  const path = resolvePath<C, T>(context, route)
-  const base = route.base ?? resolveService<C, T>(context, route).base
-
-  return base != null && base.trim() !== ''
-    ? SEP + normalizePath(base) + SEP + normalizePath(path)
-    : path
-}
 
-/**
- * Where the route answers. A backend caller reaching a service over its INTERNAL host is inside the
- * cluster, so that hop is never TLS.
- */
-export const resolveAddress = <C extends Config, T extends BasicContext<C>>(
-  context: T, route: RouteDeclaration
-): RouteAddress => {
-  const service = resolveService<C, T>(context, route)
-  const host = route.host ?? service.host
-  const internalHost = route.internalHost ?? service.internalHost
-
-  return {
-    host,
-    port: route.port ?? service.port,
-    base: route.base ?? service.base,
-    secure: internalHost != null && internalHost === host ? false : route.secure ?? true,
-    protocol: route.protocol ?? RouteProtocols.WEB,
+  const resolveAddress = (route: RouteDeclaration): RouteAddress => {
+    const service = resolveService(route)
+    const host = route.host ?? service.host
+    const internalHost = route.internalHost ?? service.internalHost
+
+    return {
+      host,
+      port: route.port ?? service.port,
+      base: route.base ?? service.base,
+      secure: internalHost != null && internalHost === host ? false : route.secure ?? true,
+      protocol: route.protocol ?? RouteProtocols.WEB,
+    }
   }
-}
 
-/** Does this route belong to the service the asking context IS? */
-export const isLocalRoute = <C extends Config, T extends BasicContext<C>>(
-  context: T, route: RouteDeclaration
-): boolean => (route.service ?? context.cfg.service) === context.cfg.service
-
-/**
- * @throws {SyntaxError}
- */
-const assertCycle = <C extends BasicConfig, T extends BasicContext<C>>(
-  context: T, route: RouteDeclaration, parent: RouteDeclaration
-) => {
-  while (parent.parent != null) {
-    if (parent.parent === route.alias) {
-      throw new SyntaxError(`Route parentship cycle detected. Parent: ${parent.alias} has his child as ancestor ${route.alias}`)
+  const isLocalRoute = (route: RouteDeclaration): boolean =>
+    (route.service ?? context.cfg.service) === context.cfg.service
+
+  /**
+   * @throws {SyntaxError}
+   */
+  const assertCycle = (route: RouteDeclaration, parent: RouteDeclaration): void => {
+    while (parent.parent != null) {
+      if (parent.parent === route.alias) {
+        throw new SyntaxError(`Route parentship cycle detected. Parent: ${parent.alias} has his child as ancestor ${route.alias}`)
+      }
+      parent = carrier(parent.parent).route.route
     }
-    parent = carrier<C, T>(context, parent.parent).route.route
   }
+
+  return { getParentRoute, resolveService, resolvePath, resolveMount, resolveAddress, isLocalRoute }
 }
 
-export const prependBase = (route: RouteDeclaration, path: string) =>
-  route.base != null && route.base.trim() !== ''
-    ? SEP + normalizePath(route.base) + SEP + normalizePath(path)
-    : path
+export const routeAddressOf = memoHelper.oncePer(makeRouteAddressHelper)

package/src/utils/service/types.ts

@@ -0,0 +1,9 @@
+import type { CommonServiceRoute, ResolvedServiceRoute } from '../../types.js'
+
+/** Recognizes configured service routes. */
+export interface ServiceRouteHelper {
+  /** Whether a configured value is a service route: it names a service and a known app type. */
+  isServiceRoute: (obj?: Object) => obj is CommonServiceRoute
+  /** A service route is usable exactly when it knows the host it answers on. */
+  isServiceRouteResolved: (route: CommonServiceRoute) => route is ResolvedServiceRoute
+}

package/src/utils/service.ts

@@ -1,10 +1,16 @@
 import { AppType } from '@owlmeans/context'
 import type { ResolvedServiceRoute, CommonServiceRoute } from '../types.js'
+import type { ServiceRouteHelper } from './service/types.js'
 
-export const isServiceRoute = (obj?: Object): obj is CommonServiceRoute =>
-  obj != null && ('type' in obj) && ('service' in obj)
-  && (Object.values(AppType).includes(obj.type as AppType))
+export const createServiceRouteHelper = (): ServiceRouteHelper => {
+  const isServiceRoute = (obj?: Object): obj is CommonServiceRoute =>
+    obj != null && ('type' in obj) && ('service' in obj)
+    && (Object.values(AppType).includes(obj.type as AppType))
 
-/** A service route is usable exactly when it knows the host it answers on. */
-export const isServiceRouteResolved = (route: CommonServiceRoute): route is ResolvedServiceRoute =>
-  route.host != null && route.host.trim() !== ''
+  const isServiceRouteResolved = (route: CommonServiceRoute): route is ResolvedServiceRoute =>
+    route.host != null && route.host.trim() !== ''
+
+  return { isServiceRoute, isServiceRouteResolved }
+}
+
+export const serviceRouteHelper = createServiceRouteHelper()

package/src/utils/types.local.ts

@@ -0,0 +1,10 @@
+import type { BasicConfig, Contextual } from '@owlmeans/context'
+import type { RouteModel } from '../types.js'
+
+export type Config = BasicConfig
+
+/** What an entrypoint looks like from the route layer: something that carries a route model. */
+export interface RouteCarrier extends Contextual {
+  _entrypoint: true
+  route: RouteModel
+}