@owlmeans/server-entrypoint 0.1.18-rc.19 → 0.1.18-rc.20

package/README.md

@@ -1,63 +1,150 @@
 # @owlmeans/server-entrypoint
 
-Server-side entrypoint system: binds shared protocol declarations to request handlers.
-
-## Overview
-
-- `bind(protocol, handler?, opts?)` materializes one immutable protocol with its handler
-- `bindAll(protocols, handlers?)` materializes a declaration collection
-- Used by `@owlmeans/server-app` when assembling a server context
+Server-side entrypoint binding: turns an immutable protocol declaration from the shared package into
+a server-local entrypoint that carries its route, guards, gate and handler. An application calls
+`bind` / `bindAll` in its `entrypoints.ts` (often through the `@owlmeans/server-app` re-export) to
+build the list it registers on the context. It does not write handlers — use `handlers<Context>()`
+from `@owlmeans/server-api` for HTTP and `connection()` from `@owlmeans/server-socket` for sockets —
+and a browser app binds the same protocols with `@owlmeans/client-entrypoint` instead.
 
 ## Installation
 
 ```bash
-bun add @owlmeans/server-entrypoint@^0.1.18-rc.10
+bun add @owlmeans/server-entrypoint@^0.1.18-rc.19
 ```
 
+## Concepts
+
+- **Protocol declaration** — the frozen `protocol()` / `openProtocol()` object from
+  `@owlmeans/entrypoint`, shared by callers and servers. It is data; binding never changes it.
+- **Server entrypoint** — what `bind` returns: a materialized copy with a server route, merged
+  guards, gate, filter, optional fixer and handler, plus a `protocol` field pointing at its
+  declaration.
+- **Bound handler** — `{ protocol, bind }`, produced by `handlers<Context>()` or `connection()`. It
+  is inseparable from the protocol whose request it accepts.
+- **Group node** — a parent declaration (`base`) bound without a handler. It contributes the path
+  prefix, guards and gate its children inherit and is never mounted as a route itself.
+- **Intermediate** — an entrypoint whose handler runs before matching routes and may replace the
+  request context; declared per route or forced with `{ intermediate: true }`.
+
 ## Usage
 
-Typical pattern — declare protocols in `common`, bind them in `api`:
+### Bind leaves and their parents
 
-```typescript
+```ts
 import { bind } from '@owlmeans/server-entrypoint'
 import { handlers } from '@owlmeans/server-api'
-import { appEntrypoints as protocols } from 'my-app-common'
-import type { Context } from 'my-app-backend'
+import { projectProtocols } from 'my-app-common'
+import type { Context } from './context.js'
 
 const api = handlers<Context>()
-const appEntrypoints = [
-  bind(protocols.api.projectCreate, api.request(protocols.api.projectCreate, async (req, ctx) =>
-    ctx.project().create(req.body))),
-  bind(protocols.api.projectGet, api.params(protocols.api.projectGet, async (req, ctx) =>
-    ctx.project().get(req.params.id))),
+
+export const serverBindings = [
+  bind(projectProtocols.base),
+  bind(projectProtocols.create, api.body(projectProtocols.create, async (body, context) =>
+    context.project().create(body))),
+  bind(projectProtocols.get, api.params(projectProtocols.get, async ({ id }, context) =>
+    context.project().load(id))),
 ]
 ```
 
-## API
+### Bind a flat collection
+
+`bindAll` pairs each declaration with the implementation whose `protocol` is the same object.
+Declarations without an implementation are bound as group nodes. Flatten a tree with `protocols()`
+only here, at the registration boundary.
+
+```ts
+import { bindAll } from '@owlmeans/server-entrypoint'
+import { protocols } from '@owlmeans/entrypoint'
+import * as project from './app/project.js'
 
-### `bind<Protocol>(protocol, handler?, opts?): ServerProtocolEntrypoint<Protocol>`
+export const projectBindings = bindAll(protocols(projectProtocols), [
+  project.list,
+  project.create,
+  project.get,
+])
+```
+
+### Bind a tree by path
 
-Materializes one immutable protocol declaration and attaches its protocol-bound implementation.
+Larger services walk the protocol tree and look up the implementation at the same path, so a new or
+renamed declaration stays type-checked at its binding site:
 
-### `bindAll(protocols, handlers?): ServerProtocolEntrypoint[]`
+```ts
+import { bind } from '@owlmeans/server-entrypoint'
+import type { ServerEntrypoint } from '@owlmeans/server-entrypoint'
+import { isEntrypointProtocol } from '@owlmeans/entrypoint'
+import type { EntrypointTree } from '@owlmeans/entrypoint'
+
+type Implementations = Record<string, unknown>
+
+const bindTree = (tree: EntrypointTree, implementations: Implementations = {}): ServerEntrypoint<object>[] =>
+  Object.entries(tree).flatMap(([key, declaration]) => {
+    const implementation = implementations[key]
+    if (isEntrypointProtocol(declaration)) {
+      return [bind(declaration, implementation as never)]
+    }
+    return bindTree(declaration, (implementation ?? {}) as Implementations)
+  })
+
+export const serverBindings = bindTree({ project: projectProtocols, invoice: invoiceProtocols }, {
+  project: { list: project.list, create: project.create, get: project.get },
+  invoice: { list: invoice.list, pay: invoice.pay },
+})
+```
 
-Materializes a flat declaration collection and pairs implementations by protocol reference.
+### Server-local options
 
-### `ServerEntrypoint<R>`
+The third argument adjusts only the local binding. `guards` are merged with the declaration's,
+`fixer` names a `FixerService` that answers errors instead of the default mapping, and
+`intermediate` forces the entrypoint to run as an intermediate.
 
-Extends `CommonEntrypoint` with:
-- `route: ServerRouteModel<R>` — the server route declaration; `route.match(request, entrypoint.mount())`
-  answers whether a request hits it
-- `handle: RefedEntrypointHandler<R>` — the attached handler
+```ts
+import { bind } from '@owlmeans/server-entrypoint'
 
-### `RefedEntrypointHandler<R>`
+export const serverBindings = [
+  bind(sessionProtocols.base, undefined, { intermediate: true }),
+  bind(invoiceProtocols.download, invoice.download, { fixer: MY_APP_DOWNLOAD_FIXER }),
+]
+```
 
-A handler factory: `(ref: { ref?: { ctx?: Context } }) => EntrypointHandler`.
+## API
 
-## Related Packages
+| Symbol | Kind | Purpose |
+|---|---|---|
+| `bind(protocol, implementation?, options?)` | function | Materialize one declaration and attach a bound handler (or a `RefedEntrypointHandler`); returns `ServerProtocolEntrypoint<Protocol>` |
+| `bindAll(declarations, implementations = [])` | function | Bind a flat declaration list, pairing implementations by `implementation.protocol === declaration` |
+| `ServerEntrypoint<R>` | type | `CommonEntrypoint` with `route: ServerRouteModel<R>`, `handle: EntrypointHandler`, `fixer?` |
+| `ServerProtocolEntrypoint<Protocol>` | type | `ServerEntrypoint<object>` plus `readonly protocol` |
+| `BoundEntrypointHandler<Protocol>` | type | `{ readonly protocol, bind: RefedEntrypointHandler }` |
+| `RefedEntrypointHandler<R>` | type | `(ref: EntrypointRef<R>) => EntrypointHandler`; the handler reads the bound entrypoint (and its context) from `ref.ref` |
+| `EntrypointRef<R>` | type | `{ ref?: ServerEntrypoint<R> }` |
+| `EntrypointOptions<R>` | type | `CommonEntrypointOptions` plus `fixer?`, `intermediate?`, `routeOptions?` |
+| `FixerService` | type | Service with `handle(reply, error)` used when a binding names a `fixer` |
+
+## Common pitfalls
+
+- A handler carries its `protocol`, and collections match by object identity. Never attach, find or
+  replace a handler by alias.
+- A decorated tree (`withOidcGuard(tree)`, `decorateEntrypoint(...)`) consists of new objects. Make
+  handlers from the same decorated protocols you bind, or `bindAll` will not pair them.
+- Do not mutate a declaration or create a mutable contextual declaration; decorate the tree before
+  binding instead.
+- Bind parent declarations too. A route whose parent is not registered loses its inherited path,
+  guards and gate.
+- A binding without a handler is never mounted as an HTTP route — that is how group nodes work, and
+  also why a forgotten implementation shows up as a 404.
+- HTTP handlers come from `handlers<Context>()`; socket handlers from `connection(protocol, callback)`.
+
+## Related packages
 
 - [`@owlmeans/entrypoint`](../entrypoint) — immutable protocol declarations
-- [`@owlmeans/server-api`](../server-api) — typed handler factories used with `bind`
+- [`@owlmeans/server-api`](../server-api) — `handlers<Context>()` for HTTP bindings
+- [`@owlmeans/server-socket`](../server-socket) — `connection()` for socket bindings
+- [`@owlmeans/server-route`](../server-route) — the server route model a binding carries
+- [`@owlmeans/server-app`](../server-app) — re-exports `bind` / `bindAll` and registers the list
+- [`@owlmeans/client-entrypoint`](../client-entrypoint) — the browser-side binding of the same protocols
 
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
@@ -67,7 +154,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.20
+npx @owlmeans/agent-skills@^0.1.18-rc.21
 ```
 
 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/server-entrypoint",
-  "version": "0.1.18-rc.19",
-  "generatedAt": "2026-09-12T14:18:54.790Z",
+  "version": "0.1.18-rc.20",
+  "generatedAt": "2026-09-15T12:21:31.922Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/server-entrypoint/SKILL.md

@@ -7,7 +7,7 @@ user-invocable: false
 
 # @owlmeans/server-entrypoint
 
-**Install:** `bun add @owlmeans/server-entrypoint@^0.1.18-rc.17`
+**Install:** `bun add @owlmeans/server-entrypoint@^0.1.18-rc.19`
 
 Bind the imported protocol object to the implementation that serves it:
 
@@ -17,17 +17,23 @@ import { handlers } from '@owlmeans/server-api'
 
 const api = handlers<AppContext>()
 
-export const entrypoints = [
-  bind(projectEntrypoints.create, api.body(projectEntrypoints.create, async (body, context) =>
+export const serverBindings = [
+  bind(projectProtocols.create, api.body(projectProtocols.create, async (body, context) =>
     context.projects.create(body)
   )),
 ]
 ```
 
 `bind(protocol, handler?, options?)` returns a `ServerProtocolEntrypoint<Protocol>`.
-`bindAll(declarations, handlers?)` is for a flat protocol collection. A handler carries its
+`bindAll(declarations, handlers?)` is for a flat protocol collection at a registration boundary. A handler carries its
 `protocol`, and a collection is matched by object identity; an alias is never used to find or
 replace it. HTTP code should use `handlers<Context>()`; sockets use `connection(protocol, callback)`.
 
+The second argument is either a protocol-bound handler (from `handlers<Context>()` above, or a
+library factory that returns one) or omitted entirely for a parent route. A plain callback passed
+directly to `bind()` is NOT the same thing: it is treated as a ref handler and invoked once, at
+bind time, with the entrypoint ref as its only argument — not per-request. Wrap it with
+`handlers<Context>()` first.
+
 Do not create a mutable contextual declaration, use a compatibility entrypoint type, or attach a
 handler with an alias. The declaration is shared data; the binding is its server-local runtime.

package/build/entrypoint.js

@@ -4,7 +4,7 @@ export const entrypoint = (arg, handler, opts) => {
     const entrypointHandle = { ref: undefined };
     let _entrypoint;
     if (isEntrypoint(arg)) {
-        // Binding the same alias again is legal, so an intermediate route stays intermediate unless
+        // Elevating the same alias again is legal, so an intermediate route stays intermediate unless
         // this call says otherwise.
         const intermediate = opts?.intermediate
             ?? (isServerRouteModel(arg.route) ? arg.route.isIntermediate() : false);
@@ -12,7 +12,7 @@ export const entrypoint = (arg, handler, opts) => {
         _entrypoint = arg;
         _entrypoint.route = routeModel;
         _entrypoint.filter = opts?.filter ?? arg.filter;
-        // Binding adds guards, it never swaps them: what the declaration carries still applies.
+        // Elevating adds guards, it never swaps them: what the entrypoint declared still applies.
         _entrypoint.guards = [...new Set([...(arg.guards ?? []), ...(opts?.guards ?? [])])];
         _entrypoint.gate = opts?.gate ?? arg.gate;
         _entrypoint.gateParams = opts?.gateParams ?? arg.gateParams;

package/build/entrypoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoint.js","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC1E,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAIlE,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,GAAwD,EAAE,OAAmC,EAAE,IAA2B,EACrG,EAAE;IACvB,MAAM,gBAAgB,GAAqB,EAAE,GAAG,EAAE,SAAS,EAAE,CAAA;IAE7D,IAAI,WAAgC,CAAA;IAEpC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,4FAA4F;QAC5F,4BAA4B;QAC5B,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY;eAClC,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACzE,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QACrE,WAAW,GAAG,GAA0B,CAAA;QACxC,WAAW,CAAC,KAAK,GAAG,UAAU,CAAA;QAC9B,WAAW,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,CAAA;QAC/C,wFAAwF;QACxF,WAAW,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACnF,WAAW,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAA;QACzC,WAAW,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,GAAG,CAAC,UAAU,CAAA;IAC7D,CAAC;SAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,WAAW,GAAG,oBAAoB,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,CAAwB,CAAA;QAC3E,WAAW,CAAC,KAAK,GAAG,GAAG,CAAA;IACzB,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,IAAI,KAAK,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QAC1E,WAAW,GAAG,oBAAoB,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,CAAwB,CAAA;QAC9E,WAAW,CAAC,KAAK,GAAG,MAAM,CAAA;IAC5B,CAAC;IAED,WAAW,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,WAAW,CAAC,KAAK,CAAA;IACpD,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAChD,CAAC;IAED,gBAAgB,CAAC,GAAG,GAAG,WAAW,CAAA;IAElC,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA"}
+{"version":3,"file":"entrypoint.js","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC1E,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAIlE,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,GAAwD,EAAE,OAAmC,EAAE,IAA2B,EACrG,EAAE;IACvB,MAAM,gBAAgB,GAAqB,EAAE,GAAG,EAAE,SAAS,EAAE,CAAA;IAE7D,IAAI,WAAgC,CAAA;IAEpC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,8FAA8F;QAC9F,4BAA4B;QAC5B,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY;eAClC,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QACzE,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QACrE,WAAW,GAAG,GAA0B,CAAA;QACxC,WAAW,CAAC,KAAK,GAAG,UAAU,CAAA;QAC9B,WAAW,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,CAAA;QAC/C,0FAA0F;QAC1F,WAAW,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACnF,WAAW,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAA;QACzC,WAAW,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,GAAG,CAAC,UAAU,CAAA;IAC7D,CAAC;SAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,WAAW,GAAG,oBAAoB,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,CAAwB,CAAA;QAC3E,WAAW,CAAC,KAAK,GAAG,GAAG,CAAA;IACzB,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,IAAI,KAAK,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QAC1E,WAAW,GAAG,oBAAoB,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,CAAwB,CAAA;QAC9E,WAAW,CAAC,KAAK,GAAG,MAAM,CAAA;IAC5B,CAAC;IAED,WAAW,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,WAAW,CAAC,KAAK,CAAA;IACpD,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAChD,CAAC;IAED,gBAAgB,CAAC,GAAG,GAAG,WAAW,CAAA;IAElC,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA"}

package/build/helper.d.ts

@@ -1,12 +1,13 @@
-import type { ServerEntrypoint, EntrypointOptions, RefedEntrypointHandler } from './types.js';
-import type { CommonEntrypoint } from '@owlmeans/entrypoint';
+import type { BoundEntrypointHandler, ServerEntrypoint, EntrypointOptions, RefedEntrypointHandler, ServerProtocolEntrypoint } from './types.js';
+import type { CommonEntrypoint, EntrypointProtocolDeclaration } from '@owlmeans/entrypoint';
 /**
- * Replace the entrypoint declared under `alias` with its materialized counterpart. Replacement is
+ * Replace the entrypoint declared under `alias` with its elevated counterpart. Elevating is
  * idempotent — calling it again simply replaces the element once more, and the guards it brings
  * are added to the ones already declared.
  *
  * @throws {SyntaxError} when no entrypoint carries the alias
  */
-export declare function replaceEntrypoint<R>(entrypoints: (CommonEntrypoint | ServerEntrypoint<R>)[], alias: string, handler?: RefedEntrypointHandler<R> | boolean | EntrypointOptions<R>, opts?: boolean | EntrypointOptions<R>): ServerEntrypoint<R>[];
+export declare function elevate(declarations: EntrypointProtocolDeclaration[], implementations: readonly BoundEntrypointHandler<EntrypointProtocolDeclaration>[]): ServerProtocolEntrypoint<EntrypointProtocolDeclaration>[];
+export declare function elevate<R>(entrypoints: (CommonEntrypoint | ServerEntrypoint<R>)[], alias: string, handler?: RefedEntrypointHandler<R> | boolean | EntrypointOptions<R>, opts?: boolean | EntrypointOptions<R>): ServerEntrypoint<R>[];
 export declare const guard: <R>(guard: string, opts?: EntrypointOptions<R>) => EntrypointOptions<R>;
 //# 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,KAAK,EACV,gBAAgB,EAAE,iBAAiB,EAAE,sBAAsB,EAC5D,MAAM,YAAY,CAAA;AAGnB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,WAAW,EAAE,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,EACvD,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,EACpE,IAAI,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,GACpC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAA;AA6BxB,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,SAAS,iBAAiB,CAAC,CAAC,CAAC,KAAG,iBAAiB,CAAC,CAAC,CACjD,CAAA"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,sBAAsB,EACnF,wBAAwB,EACzB,MAAM,YAAY,CAAA;AAKnB,OAAO,KAAK,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAA;AAE3F;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,YAAY,EAAE,6BAA6B,EAAE,EAC7C,eAAe,EAAE,SAAS,sBAAsB,CAAC,6BAA6B,CAAC,EAAE,GAChF,wBAAwB,CAAC,6BAA6B,CAAC,EAAE,CAAA;AAC5D,wBAAgB,OAAO,CAAC,CAAC,EACvB,WAAW,EAAE,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,EACvD,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,EACpE,IAAI,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,GACpC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAA;AA4CxB,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,SAAS,iBAAiB,CAAC,CAAC,CAAC,KAAG,iBAAiB,CAAC,CAAC,CACjD,CAAA"}

package/build/helper.js

@@ -1,7 +1,18 @@
 import { entrypoint } from './entrypoint.js';
+import { bind } from './protocol.js';
 import { createBasicGuard } from './utils/helper.js';
-export function replaceEntrypoint(entrypoints, target, handler, opts) {
-    const idx = entrypoints.findIndex(candidate => candidate.route.route.alias === target);
+import { isEntrypointProtocol } from '@owlmeans/entrypoint';
+export function elevate(entrypoints, target, handler, opts) {
+    if (typeof target !== 'string') {
+        return entrypoints.map((declaration) => {
+            if (!isEntrypointProtocol(declaration)) {
+                throw new SyntaxError('Protocol elevation accepts protocol declarations only');
+            }
+            const implementation = target.find(bound => bound.protocol === declaration);
+            return bind(declaration, implementation);
+        });
+    }
+    const idx = entrypoints.findIndex((candidate) => !isEntrypointProtocol(candidate) && candidate.route.route.alias === target);
     if (idx === -1) {
         throw new SyntaxError(`Entrypoint with alias ${target} not present`);
     }
@@ -14,6 +25,9 @@ export function replaceEntrypoint(entrypoints, target, handler, opts) {
         handler = undefined;
     }
     const declaration = entrypoints[idx];
+    if (isEntrypointProtocol(declaration)) {
+        throw new SyntaxError('String elevation accepts materialized entrypoints only');
+    }
     entrypoints[idx] = entrypoint(declaration, handler, typeof opts === 'boolean' ? { intermediate: opts } : opts);
     return entrypoints;
 }

package/build/helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAgBpD,MAAM,UAAU,iBAAiB,CAC/B,WAA4D,EAC5D,MAAc,EACd,OAAsE,EACtE,IAA0C;IAG1C,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAA;IACtF,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CAAC,yBAAyB,MAAM,cAAc,CAAC,CAAA;IACtE,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,GAAG,OAAO,CAAA;QACd,OAAO,GAAG,SAAS,CAAA;IACrB,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QACjE,IAAI,GAAG,OAAO,CAAA;QACd,OAAO,GAAG,SAAS,CAAA;IACrB,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IACpC,WAAW,CAAC,GAAG,CAAC,GAAG,UAAU,CAC3B,WAAW,EAAE,OAAO,EAAE,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAChF,CAAA;IAED,OAAO,WAAyC,CAAA;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,KAAa,EAAE,IAA2B,EAAwB,EAAE,CAC3F,CAAC,EAAE,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA"}
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAoB3D,MAAM,UAAU,OAAO,CACrB,WAAiE,EACjE,MAAiF,EACjF,OAAsE,EACtE,IAA0C;IAE1C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;YACrC,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,WAAW,CAAC,uDAAuD,CAAC,CAAA;YAChF,CAAC;YAED,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAA;YAC3E,OAAO,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;QAC1C,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAC9C,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAA;IAC7E,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CAAC,yBAAyB,MAAM,cAAc,CAAC,CAAA;IACtE,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,GAAG,OAAO,CAAA;QACd,OAAO,GAAG,SAAS,CAAA;IACrB,CAAC;IACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QACjE,IAAI,GAAG,OAAO,CAAA;QACd,OAAO,GAAG,SAAS,CAAA;IACrB,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IACpC,IAAI,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,WAAW,CAAC,wDAAwD,CAAC,CAAA;IACjF,CAAC;IAED,WAAW,CAAC,GAAG,CAAC,GAAG,UAAU,CAC3B,WAAW,EAAE,OAAO,EAAE,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAChF,CAAA;IAED,OAAO,WAAyC,CAAA;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,KAAa,EAAE,IAA2B,EAAwB,EAAE,CAC3F,CAAC,EAAE,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/server-entrypoint",
-  "version": "0.1.18-rc.19",
+  "version": "0.1.18-rc.20",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,10 +21,10 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.18-rc.16",
-    "@owlmeans/entrypoint": "^0.1.18-rc.19",
-    "@owlmeans/route": "^0.1.18-rc.17",
-    "@owlmeans/server-route": "^0.1.18-rc.17"
+    "@owlmeans/context": "^0.1.18-rc.17",
+    "@owlmeans/entrypoint": "^0.1.18-rc.20",
+    "@owlmeans/route": "^0.1.18-rc.18",
+    "@owlmeans/server-route": "^0.1.18-rc.18"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",