@owlmeans/route 0.1.18-rc.26 → 0.1.18-rc.27

package/README.md

@@ -2,7 +2,7 @@
 
 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 (HTTP, WebSocket or queue). It is not a
+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
@@ -16,23 +16,23 @@ context that asks, so the same declaration serves a server and a browser alike.
 ## Installation
 
 ```bash
-bun add @owlmeans/route@^0.1.18-rc.26
+bun add @owlmeans/route@^0.1.18-rc.27
 ```
 
 ## Concepts
 
 - **Declaration** — the `RouteDeclaration` a `route()` call produces: `alias`, `path` (the segment
-  under `parent`), `type`, `method`, `protocol`, the service coordinates, and the queue fields.
+  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()`, `socket()`, `job()` return `Partial<RouteOptions>` that set
-  the app type and protocol; `route()` accepts them as its options.
+- **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` picks the transport that carries a call: HTTP request, socket
-  frame or queued job. The call site never chooses.
+- **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.
 
 ## Usage
 
@@ -111,29 +111,24 @@ export const projectProtocols = {
 } as const
 ```
 
-### Sockets, queued jobs and other services
+### Sockets, custom protocols and other services
 
-`socket()` and `job()` are `backend()` with a different protocol. A route pointed at another
-service carries `service`; a queue route also names its `queue`, `timeout` and, optionally, `reply`.
+`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 { job, route, RouteMethod, socket } from '@owlmeans/route'
-import { GUARD_ED25519 } from '@owlmeans/auth-common'
-import type { ProjectParams, StoryUpdate, Story } from './types.js'
+import { route, socket } from '@owlmeans/route'
+import type { ProjectParams, StoryUpdate } from './types.js'
 import { ProjectParamsSchema } from './schemas.js'
 
-const WORKER = 'my-app-worker'
 const aliases = {
   updates: 'my-app:api:update:base',
   story: 'my-app:api:update:story',
-  jobs: 'my-app:worker:story:base',
-  develop: 'my-app:worker:story:develop',
-  cleanup: 'my-app:worker:story:cleanup',
 } as const
 
 const updates = openProtocol(route(aliases.updates, '/update'))
-const jobs = openProtocol(route(aliases.jobs, '/story', { service: WORKER }), { guards: GUARD_ED25519 })
 
 export const storyProtocols = {
   updates,
@@ -142,27 +137,9 @@ export const storyProtocols = {
     route(aliases.story, '/story/:id', socket({ parent: updates })),
     contract.request({ params: typed<ProjectParams>(ProjectParamsSchema) }, typed<StoryUpdate>()),
   ),
-  jobs,
-  // Queued job: the caller waits up to timeout ms for the job's result
-  develop: protocol(
-    route(aliases.develop, '/:id/develop', job({
-      parent: jobs, method: RouteMethod.POST, service: WORKER, queue: 'story-work', timeout: 600_000,
-    })),
-    contract.request({ params: typed<ProjectParams>(ProjectParamsSchema) }, typed<Story>()),
-  ),
-  // reply: false resolves once the broker accepts the job; the outcome is Accepted
-  cleanup: protocol(
-    route(aliases.cleanup, '/:id/cleanup', job({
-      parent: jobs, method: RouteMethod.POST, service: WORKER, queue: 'story-ops', reply: false, timeout: 30_000,
-    })),
-    contract.request({ params: typed<ProjectParams>(ProjectParamsSchema) }, typed<unknown>()),
-  ),
 } as const
 ```
 
-Which queues a process consumes is configuration of that process (`listenQueues()`), never part of
-the declaration.
-
 ### Reading where a route answers
 
 Once protocols are registered on a context, the entrypoint accessors answer address questions. The
@@ -202,16 +179,15 @@ resolveAddress(context, declaration)
 | `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` |
-| `job(opts?, secondary?)` | function | `backend()` with `protocol: RouteProtocols.QUEUE` |
 | `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 | `WEB = 'http'`, `SOCKET = 'ws'`, `QUEUE = 'queue'` |
+| `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?`, `secure?`, `queue?`, `reply?`, `timeout?` |
+| `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 }` |
@@ -246,8 +222,8 @@ The first six take `(context, declaration)`; the other four are pure and take no
   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.
-- `job()` routes must name `service`, `queue` and `timeout`. `reply: false` returns the job identity
-  with an `Accepted` outcome, not the job's result.
+- 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.
 - A mis-wired tree (no `cfg.services`, a service without a host, a parentship cycle) throws
@@ -264,7 +240,6 @@ The first six take `(context, declaration)`; the other four are pure and take no
 - [`@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/queue`](../queue) — the QUEUE transport a `job()` route is carried by
 - [`@owlmeans/socket`](../socket) — the SOCKET transport contracts
 
 <!-- owlmeans:agent-guidance:start -->
@@ -275,7 +250,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.28
+npx @owlmeans/agent-skills@^0.1.18-rc.30
 ```
 
 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.26",
-  "generatedAt": "2026-09-17T08:16:11.241Z",
+  "version": "0.1.18-rc.27",
+  "generatedAt": "2026-09-19T13:42:56.268Z",
   "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.26"` in `dependencies`
+**Install:** `"@owlmeans/route": "^0.1.18-rc.27"` 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 names `service`, `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,19 +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. Use the parent protocol object in a route
-option (`job({ parent: storyProtocols.base, service, queue, timeout })`), never an exported alias string.
+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
 

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 `bind(...)` 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 `bind(...)` 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/types.d.ts

@@ -1,5 +1,7 @@
 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

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,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACrE,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,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"}
+{"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/package.json

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

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 `bind(...)` 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/types.ts

@@ -1,6 +1,9 @@
 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
@@ -22,18 +25,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
 }
@@ -54,7 +49,7 @@ export interface RouteAddress {
   port?: number
   base?: string
   secure: boolean
-  protocol: RouteProtocols
+  protocol: RouteProtocol
 }
 
 /**