@owlmeans/route 0.1.18-rc.8 → 0.1.18

package/build/types.d.ts

@@ -1,5 +1,7 @@
-import type { AppType } from '@owlmeans/context';
+import type { AppType, EntrypointReference } from '@owlmeans/context';
 import type { RouteProtocols, RouteMethod } from './consts';
+/** A built-in or package-owned transport identifier. */
+export type RouteProtocol = RouteProtocols | (string & {});
 export interface BasicRoute {
     type: AppType;
     service?: string;
@@ -20,18 +22,10 @@ export interface RouteDeclaration extends BasicRoute {
     parent?: string;
     default?: boolean;
     method?: RouteMethod;
-    protocol?: RouteProtocols;
+    protocol?: RouteProtocol;
     secure?: boolean;
-    /**
-     * QUEUE routes only: the queue that carries this entrypoint's jobs. It names an address, not a
-     * process — which queues a given process consumes is configuration, never a declaration.
-     */
-    queue?: string;
-    /**
-     * QUEUE routes only: whether the caller waits for the job's return value. `false` resolves as
-     * soon as the job is accepted, which is what a long pipeline wants; the default is to wait.
-     */
-    reply?: boolean;
+    /** Transport-owned declaration data. The package defining `protocol` owns and validates it. */
+    protocolOptions?: unknown;
     /** How long a caller waits for an answer, in milliseconds, when the transport supports it. */
     timeout?: number;
 }
@@ -49,7 +43,7 @@ export interface RouteAddress {
     port?: number;
     base?: string;
     secure: boolean;
-    protocol: RouteProtocols;
+    protocol: RouteProtocol;
 }
 /**
  * The model wrapping a declaration. It carries no resolution state of its own — every address
@@ -58,6 +52,9 @@ export interface RouteAddress {
 export interface RouteModel {
     route: RouteDeclaration;
 }
-export interface RouteOptions extends Partial<RouteDeclaration> {
+export type RouteParent = string | EntrypointReference;
+export interface RouteOptions extends Omit<Partial<RouteDeclaration>, 'parent'> {
+    /** A parent protocol is preferred in application declarations; strings remain adapter input. */
+    parent?: RouteParent;
 }
 //# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,cAAc,CAAA;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,gBAAgB,CAAA;CACxB;AAED,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,gBAAgB,CAAC;CAC9D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3D,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE1D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,aAAa,CAAA;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,gBAAgB,CAAA;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,mBAAmB,CAAA;AAEtD,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC;IAC7E,gGAAgG;IAChG,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB"}

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,EACxE,SAAS,CAAC,EAAE,OAAO,gBAAgB,KAClC,gBAAgB,GAAG,IAWrB,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,OAAO,gBAAgB,EAAE,YAAY,OAAO,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,SAO/G,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACxE,SAAS,CAAC,EAAE,OAAO,gBAAgB,KAClC,oBA4BF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACrE,SAAS,CAAC,EAAE,OAAO,gBAAgB,KAClC,MASF,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACtE,SAAS,CAAC,EAAE,OAAO,gBAAgB,KAClC,MAOF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACxE,SAAS,CAAC,EAAE,OAAO,gBAAgB,KAClC,YAYF,CAAA;AAED,mEAAmE;AACnE,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EACtE,SAAS,CAAC,EAAE,OAAO,gBAAgB,KAClC,OAAyE,CAAA;AAgB5E,eAAO,MAAM,WAAW,GAAI,OAAO,gBAAgB,EAAE,MAAM,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,GAAI,MAAM,MAAM,KAAG,GAAG,IAAI,kBAEM,CAAA;AAE3D,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,GAAI,OAAO,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.8",
+  "version": "0.1.18",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -28,10 +28,10 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.18-rc.7"
+    "@owlmeans/context": "^0.1.18"
   },
   "devDependencies": {
-    "@owlmeans/dep-config": "workspace:*",
+    "@owlmeans/dep-config": "^0.1.18",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },

package/src/consts.ts

@@ -14,10 +14,9 @@ export const PARAM = ':'
 /**
  * How a route is carried. The protocol picks the transport that answers it — an application binds
  * one by registering a service under `transportAlias(protocol)` — so a caller writes `call()` and
- * never learns whether an HTTP request, a socket frame or a queued job did the work.
+ * never learns which transport carried the work.
  */
 export enum RouteProtocols {
   WEB = 'http',
-  SOCKET = 'ws',
-  QUEUE = 'queue'
+  SOCKET = 'ws'
 }

package/src/helper.ts

@@ -43,19 +43,6 @@ export const socket = (opts?: RouteOptions | string | null, secondary?: RouteOpt
   return route
 }
 
-/**
- * A backend route carried by the queue rather than by HTTP. Everything else about it is a normal
- * backend route — it has a path, a parent, guards and a filter — so the same declaration is served
- * with `elevate(...)` and called with `call()`; only the transport underneath differs.
- */
-export const job = (opts?: RouteOptions | string | null, secondary?: RouteOptions): Partial<RouteOptions> => {
-  const route = backend(opts, secondary)
-
-  route.protocol = RouteProtocols.QUEUE
-
-  return route
-}
-
 export const frontend = (opts?: RouteOptions | string | null, def?: RouteOptions | boolean): Partial<RouteOptions> => {
   if (typeof def === 'boolean') {
     opts = typeof opts === 'string' ? { parent: opts, default: def } : { default: def, ...(opts ?? {}) }

package/src/model.ts

@@ -4,12 +4,15 @@ 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 = {
     alias,
     type: AppType.Backend,
     path,
-    ...(typeof opts === 'string' ? { parent: opts } : opts)
+    ...rest,
+    ...(parent == null ? {} : { parent: typeof parent === 'string' ? parent : parent.alias }),
   }
 
   return route