@owlmeans/route 0.1.18-rc.9 → 0.1.18

package/README.md

@@ -1,13 +1,12 @@
 # @owlmeans/route
 
-Route model factory and type definitions for OwlMeans entrypoints.
-
-## Overview
-
-- `route()` creates a `RouteModel` used as the first argument to `entrypoint()`
-- `frontend()` / `backend()` / `socket()` helpers set the route's `AppType` and parent
-- `RouteMethod` enum covers HTTP verbs; `RouteProtocols` covers `http`/`ws`
-- This package is a dependency of `@owlmeans/entrypoint` — you rarely use it directly unless defining entrypoint-level routes
+The route declaration vocabulary for OwlMeans entrypoints. An app imports it in its shared contract
+package, next to `@owlmeans/entrypoint`, to state for each entrypoint the URL segment, parent,
+HTTP method, app type (backend or frontend) and transport identifier. It is not a
+router and serves nothing: server binding is `@owlmeans/server-route` / `@owlmeans/server-app`,
+client binding is `@owlmeans/client-route` / `@owlmeans/client-entrypoint`, UI routing is
+`@owlmeans/router`. Application code usually reads addresses through the entrypoint accessors
+(`path()`, `mount()`, `address()`) rather than through this package's `./utils`.
 
 A `RouteDeclaration` is plain, immutable data: its `path` is the segment the route contributes under
 its parent, and it is never rewritten. Where the route actually answers — the full path, the mount
@@ -17,86 +16,234 @@ context that asks, so the same declaration serves a server and a browser alike.
 ## Installation
 
 ```bash
-bun add @owlmeans/route@^0.1.18-rc.8
+bun add @owlmeans/route@^0.1.18
 ```
 
-## Usage
-
-Define routes for entrypoints (typically via `@owlmeans/server-app` re-exports):
-
-```typescript
-import { route, frontend, backend, socket, RouteMethod } from '@owlmeans/route'
-import { entrypoint } from '@owlmeans/entrypoint'
-
-// Backend REST route
-const createEntrypoint = entrypoint(
-  route('story-create', '/stories', backend('api', RouteMethod.POST))
-)
+## Concepts
+
+- **Declaration** — the `RouteDeclaration` a `route()` call produces: `alias`, `path` (the segment
+  under `parent`), `type`, `method`, `protocol`, opaque `protocolOptions`, and service coordinates.
+- **Model** — `RouteModel` is `{ route: RouteDeclaration }` and nothing more. `protocol()` and
+  `openProtocol()` from `@owlmeans/entrypoint` take it as their first argument.
+- **Marker** — `backend()`, `frontend()` and `socket()` return `Partial<RouteOptions>` that set the
+  app type and built-in protocol; a transport package may provide another marker.
+- **Parent** — a route nests under another entrypoint. Pass the parent protocol object
+  (`parent: storyProtocols.base`); the declaration stores only its alias.
+- **Service** — `service` names the configured service (`cfg.services`) that answers the route.
+  Without it the route belongs to the asking context's own service or the default one of its type.
+- **Protocol** — `RouteProtocols` contains the built-in HTTP and WebSocket identifiers. A backend
+  transport package may supply another string identifier and owns its opaque option data.
 
-// Frontend client route nested under parent
-const storyEntrypoint = entrypoint(
-  route('story-view', '/stories/:id', frontend('app'))
-)
+## Usage
 
-// WebSocket route
-const wsEntrypoint = entrypoint(
-  route('story-ws', '/stories/stream', socket('api'))
-)
+### A backend protocol tree
+
+Aliases stay private to the declaration module; the exported value is a tree of protocol objects.
+
+```ts
+import { contract, protocol } from '@owlmeans/entrypoint'
+import { backend, route, RouteMethod } from '@owlmeans/route'
+import { DEFAULT_GUARD } from '@owlmeans/auth-common'
+import { InvoiceSchema, CreateInvoiceBodySchema } from './schemas.js'
+
+const aliases = {
+  base: 'my-app:api:invoice:base',
+  list: 'my-app:api:invoice:list',
+  create: 'my-app:api:invoice:create',
+} as const
+
+const base = protocol(route(aliases.base, '/invoice', backend()), contract(), {
+  guards: DEFAULT_GUARD,
+})
+
+export const invoiceProtocols = {
+  base,
+  list: protocol(
+    route(aliases.list, '/', backend({ parent: base, method: RouteMethod.GET })),
+    contract(InvoiceSchema),
+  ),
+  create: protocol(
+    route(aliases.create, '/', backend({ parent: base, method: RouteMethod.POST })),
+    contract(CreateInvoiceBodySchema, InvoiceSchema),
+  ),
+} as const
 ```
 
-## API
-
-### `route(alias, path, opts?): RouteModel`
-
-Creates a route model. `path` is the segment this route contributes under its parent. `opts` can be a `RouteOptions` object or the result of `frontend()`, `backend()`, or `socket()`.
-
-### `frontend(parent?, sticky?): Partial<RouteOptions>`
-
-Returns options marking the route as frontend (`AppType.Frontend`), optionally with a parent alias.
-
-### `backend(parent?, method?): Partial<RouteOptions>`
+`invoiceProtocols.create` resolves to `/invoice` on the backend service, answering `POST`, and
+inherits the guard declared on `base`.
+
+### Path params, screens and default children
+
+Path params use the `:name` form and are typed through `contract.request`. `frontend()` marks a
+screen; `default: true` marks the child screen shown at the parent's path.
+
+```ts
+import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint'
+import { backend, frontend, route, RouteMethod } from '@owlmeans/route'
+import type { ProjectParams, Project, RenameProject } from './types.js'
+import { ProjectParamsSchema, RenameProjectSchema } from './schemas.js'
+
+const aliases = {
+  base: 'my-app:api:project:base',
+  rename: 'my-app:api:project:rename',
+  web: 'my-app:web:project:base',
+  dashboard: 'my-app:web:project:dashboard',
+  overview: 'my-app:web:project:overview',
+} as const
+
+const base = openProtocol(route(aliases.base, '/project', backend()))
+const web = openProtocol(route(aliases.web, '/project/:projectId', frontend()))
+
+export const projectProtocols = {
+  base,
+  rename: protocol(
+    route(aliases.rename, '/:id/rename', backend({ parent: base, method: RouteMethod.PATCH })),
+    contract.request(
+      { params: typed<ProjectParams>(ProjectParamsSchema), body: typed<RenameProject>(RenameProjectSchema) },
+      typed<Project>(),
+    ),
+  ),
+  web: {
+    base: web,
+    dashboard: openProtocol(route(aliases.dashboard, '/dashboard', frontend({ parent: web }))),
+    overview: openProtocol(route(aliases.overview, '/', frontend({ parent: web, default: true }))),
+  },
+} as const
+```
 
-Returns options marking the route as backend (`AppType.Backend`), optionally with a parent alias and `RouteMethod`.
+### Sockets, custom protocols and other services
+
+`socket()` is `backend()` with a different protocol. A route pointed at another service carries
+`service`. Adapter packages may add their own protocol and opaque `protocolOptions`; route does not
+define their semantics.
+
+```ts
+import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint'
+import { route, socket } from '@owlmeans/route'
+import type { ProjectParams, StoryUpdate } from './types.js'
+import { ProjectParamsSchema } from './schemas.js'
+
+const aliases = {
+  updates: 'my-app:api:update:base',
+  story: 'my-app:api:update:story',
+} as const
+
+const updates = openProtocol(route(aliases.updates, '/update'))
+
+export const storyProtocols = {
+  updates,
+  // WebSocket subscription under /update
+  story: protocol(
+    route(aliases.story, '/story/:id', socket({ parent: updates })),
+    contract.request({ params: typed<ProjectParams>(ProjectParamsSchema) }, typed<StoryUpdate>()),
+  ),
+} as const
+```
 
-### `socket(parent?): Partial<RouteOptions>`
+### Reading where a route answers
 
-Returns options for a WebSocket route with `RouteProtocols.SOCKET`.
+Once protocols are registered on a context, the entrypoint accessors answer address questions. The
+`./utils` helpers are the same functions over a bare declaration.
 
-### `RouteMethod`
+```ts
+import { AppType } from '@owlmeans/context'
+import { service } from '@owlmeans/config'
+import { routeAddressOf } from '@owlmeans/route/utils'
+import { invoiceProtocols } from 'my-app-common'
 
-```typescript
-enum RouteMethod { GET, POST, PATCH, PUT, DELETE }
-```
+// Config side: the service the backend routes resolve against
+const cfg = service({ service: 'my-app-api', type: AppType.Backend, host: 'localhost', port: 8080, base: 'api' }, baseCfg)
 
-### `RouteProtocols`
+// Runtime side, through the registered entrypoint
+const entrypoint = context.entrypoint(invoiceProtocols.create)
+entrypoint.path()    // '/invoice'
+entrypoint.mount()   // '/api/invoice'
+entrypoint.address() // { host: 'localhost', port: 8080, base: 'api', secure: true, protocol: 'http' }
+entrypoint.isLocal() // true inside the my-app-api process
 
-```typescript
-enum RouteProtocols { WEB = 'http', SOCKET = 'ws' }
+// Same answers from a declaration
+const declaration = invoiceProtocols.create.route.route
+const addresses = routeAddressOf(context)
+addresses.resolveMount(declaration)
+addresses.resolveAddress(declaration)
 ```
 
-The protocol also selects the transport that carries a call to an entrypoint on this route.
-
-### Types
+## API
 
-- `RouteDeclaration` — the plain, immutable data a `route()` call produces: `alias`, `path`,
-  `parent`, `method`, `protocol`, `secure`, plus the service coordinates
-- `RouteModel` — `{ route: RouteDeclaration }`, the model an entrypoint carries
-- `RouteAddress` — `{ host, port?, base?, secure, protocol }`, where a route answers once its
-  service has been picked
+### `@owlmeans/route`
+
+| Symbol | Kind | Purpose |
+|--------|------|---------|
+| `route(alias, path, opts?)` | function | Build a `RouteModel`; `opts` is `RouteOptions` or a parent alias string |
+| `createRoute(alias, path, opts?)` | function | Build the bare `RouteDeclaration` (parent reference collapsed to its alias) |
+| `makeRouteModel(declaration)` | function | Wrap a declaration as `{ route }` |
+| `backend(opts?, method?)` | function | Mark `AppType.Backend`; `opts` is options, a parent alias or `null`; `method` is a `RouteMethod` or more options |
+| `frontend(opts?, default?)` | function | Mark `AppType.Frontend`; `default` is a boolean flag or more options |
+| `socket(opts?, secondary?)` | function | `backend()` with `protocol: RouteProtocols.SOCKET` |
+| `service(alias, opts?)` | function | Set `service` on `opts` (mutated and returned) |
+| `rtype(type, opts?)` | function | Set an arbitrary `AppType`; the primitive behind `backend()` / `frontend()` |
+| `normalizePath(path)` | function | Trim whitespace and one leading and trailing `/` |
+| `RouteMethod` | enum | `GET = 'get'`, `POST = 'post'`, `PATCH = 'patch'`, `PUT = 'put'`, `DELETE = 'delete'` |
+| `RouteProtocols` | enum | Generic built-ins: `WEB = 'http'`, `SOCKET = 'ws'` |
+| `SEP` | const | Path separator `'/'` |
+| `PARAM` | const | Path param prefix `':'` |
+| `BasicRoute` | interface | `type`, `service?`, `host?`, `port?`, `base?`, `internalHost?`, `internalPort?` |
+| `RouteDeclaration` | interface | `BasicRoute` + `alias`, `path`, `parent?`, `default?`, `method?`, `protocol?`, transport-owned `protocolOptions?`, `secure?`, `timeout?` |
+| `RouteOptions` | interface | `Partial<RouteDeclaration>` whose `parent` is a `RouteParent` |
+| `RouteParent` | type | `string \| EntrypointReference` |
+| `RouteModel` | interface | `{ route: RouteDeclaration }` |
+| `RouteAddress` | interface | `{ host, port?, base?, secure, protocol }` |
+| `CommonServiceRoute` | interface | A service entry: `BasicRoute` + `service`, `home?`, `default?` |
+| `ResolvedServiceRoute` | interface | A service entry that names its `host` |
 
 ### `@owlmeans/route/utils`
 
-The pure functions the entrypoint accessors are built on. Each takes a context and a declaration:
-
-- `resolveService(ctx, route)` / `isLocalRoute(ctx, route)`
-- `resolvePath(ctx, route)` — the route's segment under every ancestor's
-- `resolveMount(ctx, route)` — that path under the service base
-- `resolveAddress(ctx, route)` — host, port, scheme and protocol
-
-## Related Packages
-
-- [`@owlmeans/entrypoint`](../entrypoint) — `entrypoint()` takes a `RouteModel` as first argument
-- [`@owlmeans/server-app`](../server-app) — re-exports `route` as `broute` (backend) alongside `route`
+`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 |
+|--------|------|---------|
+| `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
+
+- Pass the parent protocol object in route options, never an exported alias string. Keep aliases
+  private to the declaration module and export a `*Protocols` tree.
+- The positional marker forms (`backend(parent, method)`, `frontend(parent, true)`) accept a parent
+  only as an alias string: a protocol object in first position is spread into the options and
+  overwrites the child's alias. Pass protocols as `{ parent }`.
+- `path` is only this route's segment. Do not repeat the parent's path in it; `resolvePath()` joins
+  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: `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
+  names its protocol.
+
+## Related packages
+
+- [`@owlmeans/entrypoint`](../entrypoint) — `protocol()` / `openProtocol()` consume a `RouteModel` and
+  expose `path()`, `mount()`, `address()`, `isLocal()`
+- [`@owlmeans/context`](../context) — `AppType`, `EntrypointReference` and the registry the address helpers walk
+- [`@owlmeans/config`](../config) — `service()` declares the service entries routes resolve against
+- [`@owlmeans/server-route`](../server-route) — server-side route model; re-exported by
+  [`@owlmeans/server-app`](../server-app) as `broute`
+- [`@owlmeans/client-route`](../client-route) — marks a route as client-side and extracts its params
+- [`@owlmeans/socket`](../socket) — the SOCKET transport contracts
 
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
@@ -106,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.12
+npx @owlmeans/agent-skills@^0.1.18
 ```
 
 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,
+  "schemaVersion": 3,
   "package": "@owlmeans/route",
-  "version": "0.1.18-rc.9",
-  "generatedAt": "2026-09-04T22:43:25.449Z",
+  "version": "0.1.18",
+  "generatedAt": "2026-10-28T00:31:34.757Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -1,6 +1,6 @@
 ---
 name: route
-description: How to use @owlmeans/route — route() for declaring URL segments, frontend()/backend()/socket()/job() markers, RouteMethod and RouteProtocols enums, and the address helpers under ./utils. Auto-invoked when importing route helpers or defining an entrypoint's URL path.
+description: How to use @owlmeans/route — transport-neutral route declarations, frontend/backend/socket markers, HTTP methods, extensible protocol identifiers, and address helpers. Auto-invoked when importing route helpers or defining an entrypoint's URL path.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/route
 
 **Layer:** Core
-**Install:** `"@owlmeans/route": "^0.1.18-rc.9"` in `dependencies`
+**Install:** `"@owlmeans/route": "^0.1.18"` in `dependencies`
 
 ## Key Exports
 
@@ -18,10 +18,10 @@ user-invocable: false
 | `frontend(options?, default?)` | Mark a route as a React page (web only) |
 | `backend(options?, method?)` | Mark a route as a backend endpoint |
 | `socket(options?, secondary?)` | A backend route answering over `RouteProtocols.SOCKET` |
-| `job(options?, secondary?)` | A backend route carried by the queue (`RouteProtocols.QUEUE`); its declaration adds `queue`, `reply` and `timeout` |
 | `service(alias, options?)` | Point a route at a named service |
 | `RouteMethod` | enum of GET, POST, PUT, PATCH, DELETE |
-| `RouteProtocols` | enum of WEB (`http`), SOCKET (`ws`), QUEUE (`queue`) |
+| `RouteProtocols` | built-in WEB (`http`) and SOCKET (`ws`) identifiers |
+| `RouteProtocol` | a built-in or package-owned transport identifier |
 | `rtype(type, options?)` | The primitive `frontend()` / `backend()` are built from |
 | `createRoute(alias, path, opts?)` / `makeRouteModel(decl)` | The declaration and its wrapper, when you need them apart |
 | `BasicRoute` | `{ type, service?, host?, port?, base?, internalHost?, internalPort? }` |
@@ -40,18 +40,15 @@ route contributes under its parent and is never rewritten, and the model carries
 Where the route answers is worked out on demand, against the context that asks — which is what lets
 the same declaration serve a client and a server at once.
 
-## Protocol picks the transport
+## Protocol ownership
 
 A route names the protocol it answers on, and an application binds one by registering a transport
 service under `transportAlias(protocol)`. So the protocol is what decides whether a call travels as
-an HTTP request, a socket frame or a queued job — the call site never says. Both `transportAlias`
-and the `EntrypointTransport` contract a transport implements are exported by `@owlmeans/entrypoint`,
-not by this package; a route only names the protocol.
-
-`job()` is `backend()` with `RouteProtocols.QUEUE`. Three declaration fields matter only for that
-protocol: `queue` (which queue carries it), `reply` and `timeout`. `reply: false` resolves once the
-broker has taken the job — the value is the job's identity and the outcome is `Accepted`, not the
-job's result; the default is to wait for the result.
+an HTTP request, a socket frame or a package-owned transport — the call site never says. Both
+`transportAlias` and `EntrypointTransport` are exported by `@owlmeans/entrypoint`; this package only
+stores an opaque protocol identifier and `protocolOptions`. The package defining a custom protocol
+owns its marker, option type, validation and transport; the generic route package does not describe
+that transport's implementation semantics.
 
 ## Subpath Exports
 
@@ -81,18 +78,19 @@ Application code rarely calls these directly — `@owlmeans/entrypoint` exposes
 
 ```typescript
 import { route, frontend, RouteMethod } from '@owlmeans/route'
-import { entrypoint } from '@owlmeans/entrypoint'
+import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint'
 
 // Server route
-entrypoint(
+protocol(
   route(manager.back.project.create, '/create', {
     parent: manager.back.project.base,
     method: RouteMethod.POST,
-  })
+  }),
+  contract(typed<Project>()),
 )
 
 // Web route — frontend() marks it as a React page
-entrypoint(
+openProtocol(
   route(HOME, '/', frontend({ default: true, parent: BASE }))
 )
 ```

package/build/consts.d.ts

@@ -10,11 +10,10 @@ export declare 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 declare enum RouteProtocols {
     WEB = "http",
-    SOCKET = "ws",
-    QUEUE = "queue"
+    SOCKET = "ws"
 }
 //# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,MAAM,WAAW;CAClB;AAED,eAAO,MAAM,GAAG,MAAM,CAAA;AAEtB,eAAO,MAAM,KAAK,MAAM,CAAA;AAExB;;;;GAIG;AACH,oBAAY,cAAc;IACxB,GAAG,SAAS;IACZ,MAAM,OAAO;IACb,KAAK,UAAU;CAChB"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,MAAM,WAAW;CAClB;AAED,eAAO,MAAM,GAAG,MAAM,CAAA;AAEtB,eAAO,MAAM,KAAK,MAAM,CAAA;AAExB;;;;GAIG;AACH,oBAAY,cAAc;IACxB,GAAG,SAAS;IACZ,MAAM,OAAO;CACd"}

package/build/consts.js

@@ -11,12 +11,11 @@ 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 var RouteProtocols;
 (function (RouteProtocols) {
     RouteProtocols["WEB"] = "http";
     RouteProtocols["SOCKET"] = "ws";
-    RouteProtocols["QUEUE"] = "queue";
 })(RouteProtocols || (RouteProtocols = {}));
 //# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,0BAAW,CAAA;IACX,4BAAa,CAAA;IACb,8BAAe,CAAA;IACf,0BAAW,CAAA;IACX,gCAAiB,CAAA;AACnB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAA;AAEtB,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,CAAA;AAExB;;;;GAIG;AACH,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,8BAAY,CAAA;IACZ,+BAAa,CAAA;IACb,iCAAe,CAAA;AACjB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,0BAAW,CAAA;IACX,4BAAa,CAAA;IACb,8BAAe,CAAA;IACf,0BAAW,CAAA;IACX,gCAAiB,CAAA;AACnB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAA;AAEtB,MAAM,CAAC,MAAM,KAAK,GAAG,GAAG,CAAA;AAExB;;;;GAIG;AACH,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,8BAAY,CAAA;IACZ,+BAAa,CAAA;AACf,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB"}

package/build/helper.d.ts

@@ -8,11 +8,5 @@ export declare const rtype: (type: AppType, opts?: RouteOptions | string) => Par
 export declare const backend: (opts?: RouteOptions | string | null, method?: RouteOptions | RouteMethod) => Partial<RouteOptions>;
 export declare const service: (service: string, opts?: Partial<RouteOptions>) => Partial<RouteOptions>;
 export declare const socket: (opts?: RouteOptions | string | null, secondary?: RouteOptions) => Partial<RouteOptions>;
-/**
- * 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 declare const job: (opts?: RouteOptions | string | null, secondary?: RouteOptions) => Partial<RouteOptions>;
 export declare const frontend: (opts?: RouteOptions | string | null, def?: RouteOptions | boolean) => Partial<RouteOptions>;
 //# sourceMappingURL=helper.d.ts.map

package/build/helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAuB,MAAM,aAAa,CAAA;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE5D,eAAO,MAAM,KAAK,EAAE,oBAAoB,CAAC,UAAU,CACH,CAAA;AAEhD,eAAO,MAAM,aAAa,SAAU,MAAM,KAAG,MAM5C,CAAA;AAED,eAAO,MAAM,KAAK,SAAU,OAAO,SAAS,YAAY,GAAG,MAAM,KAAG,OAAO,CAAC,YAAY,CAEvF,CAAA;AAED,eAAO,MAAM,OAAO,UAAW,YAAY,GAAG,MAAM,GAAG,IAAI,WAAW,YAAY,GAAG,WAAW,KAAG,OAAO,CAAC,YAAY,CAQtH,CAAA;AAED,eAAO,MAAM,OAAO,YAAa,MAAM,SAAS,OAAO,CAAC,YAAY,CAAC,KAAG,OAAO,CAAC,YAAY,CAI3F,CAAA;AAED,eAAO,MAAM,MAAM,UAAW,YAAY,GAAG,MAAM,GAAG,IAAI,cAAc,YAAY,KAAG,OAAO,CAAC,YAAY,CAM1G,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,GAAG,UAAW,YAAY,GAAG,MAAM,GAAG,IAAI,cAAc,YAAY,KAAG,OAAO,CAAC,YAAY,CAMvG,CAAA;AAED,eAAO,MAAM,QAAQ,UAAW,YAAY,GAAG,MAAM,GAAG,IAAI,QAAQ,YAAY,GAAG,OAAO,KAAG,OAAO,CAAC,YAAY,CAQhH,CAAA"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAuB,MAAM,aAAa,CAAA;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE5D,eAAO,MAAM,KAAK,EAAE,oBAAoB,CAAC,UAAU,CACH,CAAA;AAEhD,eAAO,MAAM,aAAa,SAAU,MAAM,KAAG,MAM5C,CAAA;AAED,eAAO,MAAM,KAAK,SAAU,OAAO,SAAS,YAAY,GAAG,MAAM,KAAG,OAAO,CAAC,YAAY,CAEvF,CAAA;AAED,eAAO,MAAM,OAAO,UAAW,YAAY,GAAG,MAAM,GAAG,IAAI,WAAW,YAAY,GAAG,WAAW,KAAG,OAAO,CAAC,YAAY,CAQtH,CAAA;AAED,eAAO,MAAM,OAAO,YAAa,MAAM,SAAS,OAAO,CAAC,YAAY,CAAC,KAAG,OAAO,CAAC,YAAY,CAI3F,CAAA;AAED,eAAO,MAAM,MAAM,UAAW,YAAY,GAAG,MAAM,GAAG,IAAI,cAAc,YAAY,KAAG,OAAO,CAAC,YAAY,CAM1G,CAAA;AAED,eAAO,MAAM,QAAQ,UAAW,YAAY,GAAG,MAAM,GAAG,IAAI,QAAQ,YAAY,GAAG,OAAO,KAAG,OAAO,CAAC,YAAY,CAQhH,CAAA"}

package/build/helper.js

@@ -28,16 +28,6 @@ export const socket = (opts, secondary) => {
     route.protocol = RouteProtocols.SOCKET;
     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, secondary) => {
-    const route = backend(opts, secondary);
-    route.protocol = RouteProtocols.QUEUE;
-    return route;
-};
 export const frontend = (opts, def) => {
     if (typeof def === 'boolean') {
         opts = typeof opts === 'string' ? { parent: opts, default: def } : { default: def, ...(opts ?? {}) };

package/build/helper.js.map

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

package/build/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAG5D,eAAO,MAAM,cAAc,UAAW,gBAAgB,KAAG,UAAyB,CAAA;AAElF,eAAO,MAAM,WAAW,EAAE,oBAAoB,CAAC,gBAAgB,CAS9D,CAAA"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAG5D,eAAO,MAAM,cAAc,UAAW,gBAAgB,KAAG,UAAyB,CAAA;AAElF,eAAO,MAAM,WAAW,EAAE,oBAAoB,CAAC,gBAAgB,CAY9D,CAAA"}

package/build/model.js

@@ -1,11 +1,14 @@
 import { AppType } from '@owlmeans/context';
 export const makeRouteModel = (route) => ({ route });
 export const createRoute = (alias, path, opts) => {
+    const options = typeof opts === 'string' ? { parent: opts } : opts;
+    const { parent, ...rest } = options ?? {};
     const route = {
         alias,
         type: AppType.Backend,
         path,
-        ...(typeof opts === 'string' ? { parent: opts } : opts)
+        ...rest,
+        ...(parent == null ? {} : { parent: typeof parent === 'string' ? parent : parent.alias }),
     };
     return route;
 };

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,KAAK,GAAqB;QAC9B,KAAK;QACL,IAAI,EAAE,OAAO,CAAC,OAAO;QACrB,IAAI;QACJ,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;KACxD,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/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":""}