@owlmeans/server-entrypoint 0.1.18-rc.10 → 0.1.18-rc.12

package/README.md

@@ -12,7 +12,7 @@ Elevates route definitions into runnable server entrypoints with attached reques
 ## Installation
 
 ```bash
-bun add @owlmeans/server-entrypoint
+bun add @owlmeans/server-entrypoint@^0.1.18-rc.10
 ```
 
 ## Usage
@@ -76,7 +76,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
+npx @owlmeans/agent-skills@^0.1.18-rc.13
 ```
 
 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.10",
-  "generatedAt": "2026-09-01T17:39:40.763Z",
+  "version": "0.1.18-rc.12",
+  "generatedAt": "2026-09-10T18:54:42.497Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -1,6 +1,6 @@
 ---
 name: server-entrypoint
-description: How to use @owlmeans/server-entrypoint — server-side entrypoints extending @owlmeans/entrypoint with handler attachment, intermediates and mount(). Auto-invoked when importing server-entrypoint types.
+description: How to use @owlmeans/server-entrypoint — binding immutable protocols to server handlers, plus legacy elevate() forms, intermediates, guards and mount(). Auto-invoked when importing server-entrypoint types or writing a custom entrypoint helper.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,32 +8,90 @@ user-invocable: false
 # @owlmeans/server-entrypoint
 
 **Layer:** Server
-**Install:** `"@owlmeans/server-entrypoint": "^0.1.18-rc.10"` in `dependencies`
+**Install:** `"@owlmeans/server-entrypoint": "^0.1.18-rc.12"` in `dependencies`
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
-| `ServerEntrypoint<R>` | Server entrypoint interface — a `ServerRouteModel` plus a `handle` |
-| `entrypoint(arg, handler?, opts?)` | Build a server entrypoint from a route model or an existing declaration |
-| `elevate(entrypoints, alias, handler?, opts?)` | Attach a handler (or just guards) to a declared entrypoint |
-| `guard(alias, opts?)` | Require a guard, returning server entrypoint options |
-| `EntrypointOptions<R>` | Options for elevating: `handler`, `fixer`, `intermediate`, `routeOptions`, guards/gates/filter |
-| `EntrypointRef` / `RefedEntrypointHandler` | Handler reference pattern |
-| `FixerService` | Per-entrypoint error rendering (`handle(reply, error)`) |
+| `bind(protocol, implementation?, opts?)` | Materialize a protocol and its protocol-bound handler |
+| `ServerProtocolEntrypoint<P>` | The server module whose request/reply types come from `P` |
+| `BoundEntrypointHandler<P>` | A handler implementation tied to exactly one protocol |
+| `ServerEntrypoint<R>` | Server entrypoint interface — a common entrypoint whose `route` is a `ServerRouteModel` plus `handle` and an optional `fixer` |
+| `entrypoint(arg, handler?, opts?)` | Build one from an existing declaration, a server route model, or a plain route model |
+| `elevate(entrypoints, alias, handler?, opts?)` | Replace the declaration under `alias` in-place with its elevated counterpart |
+| `guard(alias, opts?)` | Options that require a guard, ready to pass as `opts` |
+| `EntrypointOptions<R>` | `fixer`, `intermediate`, `routeOptions`, plus everything a common entrypoint declares. `elevate()` reads only `route`-shaping and access keys from it — `intermediate`, `routeOptions`, `filter`, `guards`, `gate`, `gateParams`, `fixer`; `handle` and `sticky` are silently ignored there |
+| `EntrypointRef<R>` / `RefedEntrypointHandler<R>` | `(ref) => handler` — the wrapper is handed a ref that resolves to the entrypoint being built, which is how a handler reaches its own `ctx` |
+| `FixerService` | Per-entrypoint error rendering (`handle(reply, error)`), named by `opts.fixer` and resolved as a service |
 
 ## Usage
 
-Most app code uses `elevate()` from `@owlmeans/server-app` (which builds on this package). Import directly only when implementing custom entrypoint helpers.
+New code pairs `bind` with `handlers<Context>()` from `@owlmeans/server-api` (both are re-exported
+by `@owlmeans/server-app`). The callback request and reply are inferred from the protocol, so no
+call-site generic or alias lookup can drift from the shared declaration:
 
 ```typescript
+import { bind, handlers } from '@owlmeans/server-app'
+import { item } from 'project-common'
+
+const handle = handlers<Context>()
+export const getItem = handle.params(item.get, async ({ id }, context) =>
+  await context.resource<ItemResource>('item').load(id))
+
+export const appEntrypoints = [bind(item.get, getItem)]
+```
+
+Use `handle.body`, `handle.params`, or `handle.request` according to the protocol contract. A
+body/params helper refuses a protocol that did not declare that section, and the callback return
+must match the protocol response.
+
+Most legacy app code uses `elevate()` from `@owlmeans/server-app`. Import directly only when
+implementing custom entrypoint helpers.
+
+```typescript
+import { elevate, guard } from '@owlmeans/server-entrypoint'
 import type { ServerEntrypoint } from '@owlmeans/server-entrypoint'
 ```
 
-Elevating is **idempotent** — elevating the same alias again simply replaces the element once more,
-and an intermediate stays intermediate unless the new call says otherwise. Guards passed at
-elevation are **unioned** with the ones the declaration already carries, so what the entrypoint
-declared still applies.
+### elevate forms
+
+The third argument is overloaded, and all four forms are legal:
+
+```typescript
+elevate(entrypoints, alias)                     // bare — make it a server entrypoint, nothing more
+elevate(entrypoints, alias, handler)            // attach a handler
+elevate(entrypoints, alias, guard(DAUTH_GUARD)) // options only
+elevate(entrypoints, alias, handler, true)      // trailing boolean === { intermediate: true }
+```
+
+`DAUTH_GUARD` above is `@owlmeans/server-auth`'s `DEFAULT_ALIAS` (`auth`), re-exported under that
+name by `@owlmeans/server-app`.
+
+It throws `SyntaxError` when no entrypoint in the list carries that alias, and it mutates the array
+it is given — the elevated entrypoint replaces the element, and the same array is returned.
+
+**A handler only ever arrives as the third argument.** `elevate` passes the options through
+`entrypoint()`, which on an already-declared entrypoint applies `route`, `filter`, `guards`, `gate`,
+`gateParams`, `intermediate` and `fixer` and nothing else — so `elevate(list, ALIAS, { handle: fn })`
+type-checks, drops the function, and leaves an entrypoint the server never binds.
+
+Elevating is **idempotent**: elevating the same alias again simply replaces the element once more.
+An entrypoint stays intermediate unless the new call says otherwise, guards passed at elevation are
+**unioned** with the ones the declaration already carries (so what the entrypoint declared still
+applies), and a `fixer` already set survives a call that does not name one.
+
+The **bare** form only converts the declaration into a server entrypoint — a `ServerRouteModel`
+that `canServeModule` recognises. It creates no route group: an entrypoint with no `handle` is never
+bound as a route, guarded or not, and `intermediate` defaults to what the declaration already was
+(`false` for a common declaration), so a bare elevate does not put it in the intermediate chain
+either. A live intermediate is `elevate(list, ALIAS, handleIntermediate(fn), true)` — a handler plus
+`true`, with `handleIntermediate` from `@owlmeans/server-api`.
+
+A parent alias that carries only a `guard()` for its children needs no elevation at all:
+`getGuards()` walks `parent()`, which resolves the alias against the context, and a registered
+declaration answers there whether or not it was elevated. `gate()` is not in this package — it comes
+from `@owlmeans/entrypoint`, and only `guard()` is defined here.
 
 ## What a server registers
 
@@ -47,9 +105,14 @@ server.route({ url: entrypoint.mount(), method, handler })
 entrypoint.route.match(request, entrypoint.mount())   // intermediates test the same mount
 ```
 
+Guards and gates are read with `getGuards()` / `getGates()`, which include everything the ancestors
+declared, and they run before the handler — a handler that re-checks them duplicates an enforced
+rule.
+
 ## Cross-Service URL Generation
 
-Use `makeSecurityHelper` from `@owlmeans/config` to build URLs pointing at other services (OAuth redirect URIs, webhook callbacks, etc.):
+Use `makeSecurityHelper` from `@owlmeans/config` to build URLs pointing at other services (OAuth
+redirect URIs, webhook callbacks, etc.):
 
 ```typescript
 import { makeSecurityHelper } from '@owlmeans/config'
@@ -59,4 +122,4 @@ const url = helper.makeUrl(entrypoint.address(), '/callback')
 
 ## Depends On
 
-- `@owlmeans/entrypoint`, `@owlmeans/server-route`, `@owlmeans/server-context`
+- `@owlmeans/entrypoint`, `@owlmeans/server-route`, `@owlmeans/route`, `@owlmeans/context`

package/build/entrypoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoint.d.ts","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAiB,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAG5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,eAAO,MAAM,UAAU,GAAI,CAAC,EAC1B,KAAK,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,UAAU,EAAE,UAAU,sBAAsB,CAAC,CAAC,CAAC,EAAE,OAAO,iBAAiB,CAAC,CAAC,CAAC,KACzH,gBAAgB,CAAC,CAAC,CAmCpB,CAAA"}
+{"version":3,"file":"entrypoint.d.ts","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAiB,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAG5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,eAAO,MAAM,UAAU,GAAI,CAAC,OACrB,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,UAAU,YAAY,sBAAsB,CAAC,CAAC,CAAC,SAAS,iBAAiB,CAAC,CAAC,CAAC,KACzH,gBAAgB,CAAC,CAAC,CAmCpB,CAAA"}

package/build/helper.d.ts

@@ -1,5 +1,5 @@
-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 elevated counterpart. Elevating is
  * idempotent — calling it again simply replaces the element once more, and the guards it brings
@@ -7,6 +7,7 @@ import type { CommonEntrypoint } from '@owlmeans/entrypoint';
  *
  * @throws {SyntaxError} when no entrypoint carries the alias
  */
-export declare const elevate: <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,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAG7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EACvB,aAAa,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,EACvD,OAAO,MAAM,EACb,UAAU,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,EACpE,OAAO,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,KACpC,gBAAgB,CAAC,CAAC,CAAC,EAmBrB,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,OAAO,MAAM,EAAE,OAAO,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,16 +1,20 @@
 import { entrypoint } from './entrypoint.js';
+import { bind } from './protocol.js';
 import { createBasicGuard } from './utils/helper.js';
-/**
- * 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 const elevate = (entrypoints, alias, handler, opts) => {
-    const idx = entrypoints.findIndex(({ route }) => route.route.alias === alias);
+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 ${alias} not present`);
+        throw new SyntaxError(`Entrypoint with alias ${target} not present`);
     }
     if (typeof handler === 'boolean') {
         opts = handler;
@@ -20,8 +24,12 @@ export const elevate = (entrypoints, alias, handler, opts) => {
         opts = handler;
         handler = undefined;
     }
-    entrypoints[idx] = entrypoint(entrypoints[idx], handler, typeof opts === 'boolean' ? { intermediate: opts } : opts);
+    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;
-};
+}
 export const guard = (guard, opts) => ({ ...createBasicGuard(guard, opts) });
 //# sourceMappingURL=helper.js.map

package/build/helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAGpD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,WAAuD,EACvD,KAAa,EACb,OAAoE,EACpE,IAAqC,EACd,EAAE;IACzB,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;IAC7E,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CAAC,yBAAyB,KAAK,cAAc,CAAC,CAAA;IACrE,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,WAAW,CAAC,GAAG,CAAC,GAAG,UAAU,CAC3B,WAAW,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CACrF,CAAA;IAED,OAAO,WAAoC,CAAA;AAC7C,CAAC,CAAA;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/build/index.d.ts

@@ -1,4 +1,5 @@
 export * from './helper.js';
 export type * from './types.js';
 export * from './entrypoint.js';
+export * from './protocol.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA"}

package/build/index.js

@@ -1,3 +1,4 @@
 export * from './helper.js';
 export * from './entrypoint.js';
+export * from './protocol.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAE3B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAE3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA"}

package/build/protocol.d.ts

@@ -0,0 +1,5 @@
+import type { EntrypointProtocolDeclaration } from '@owlmeans/entrypoint';
+import type { BoundEntrypointHandler, EntrypointOptions, ServerProtocolEntrypoint } from './types.js';
+/** Bind one immutable protocol and, when present, its protocol-bound implementation. */
+export declare const bind: <Protocol extends EntrypointProtocolDeclaration>(protocol: Protocol, implementation?: BoundEntrypointHandler<Protocol>, options?: EntrypointOptions<object>) => ServerProtocolEntrypoint<Protocol>;
+//# sourceMappingURL=protocol.d.ts.map

package/build/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAA;AAEzE,OAAO,KAAK,EACV,sBAAsB,EAAE,iBAAiB,EAAE,wBAAwB,EACpE,MAAM,YAAY,CAAA;AAEnB,wFAAwF;AACxF,eAAO,MAAM,IAAI,GAAI,QAAQ,SAAS,6BAA6B,YACvD,QAAQ,mBACD,sBAAsB,CAAC,QAAQ,CAAC,YACvC,iBAAiB,CAAC,MAAM,CAAC,KAClC,wBAAwB,CAAC,QAAQ,CAQnC,CAAA"}

package/build/protocol.js

@@ -0,0 +1,8 @@
+import { materializeEntrypoint } from '@owlmeans/entrypoint';
+import { entrypoint } from './entrypoint.js';
+/** Bind one immutable protocol and, when present, its protocol-bound implementation. */
+export const bind = (protocol, implementation, options) => {
+    const bound = Object.assign(entrypoint(materializeEntrypoint(protocol), implementation?.bind, options), { protocol });
+    return bound;
+};
+//# sourceMappingURL=protocol.js.map

package/build/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAK5C,wFAAwF;AACxF,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,QAAkB,EAClB,cAAiD,EACjD,OAAmC,EACC,EAAE;IACtC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CACpC,qBAAqB,CAAC,QAAQ,CAAC,EAC/B,cAAc,EAAE,IAAI,EACpB,OAAO,CACR,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;IAEhB,OAAO,KAA2C,CAAA;AACpD,CAAC,CAAA"}

package/build/types.d.ts

@@ -1,5 +1,5 @@
 import type { ServerRouteModel, ServerRouteOptions } from '@owlmeans/server-route';
-import type { CommonEntrypoint, EntrypointHandler, CommonEntrypointOptions } from '@owlmeans/entrypoint';
+import type { CommonEntrypoint, EntrypointHandler, CommonEntrypointOptions, EntrypointProtocolDeclaration } from '@owlmeans/entrypoint';
 import type { Service } from '@owlmeans/context';
 export interface ServerEntrypoint<R> extends CommonEntrypoint {
     route: ServerRouteModel<R>;
@@ -20,4 +20,13 @@ export interface EntrypointRef<R> {
 export interface RefedEntrypointHandler<R = {}> {
     (ref: EntrypointRef<R>): EntrypointHandler;
 }
+/** The server-local representation of a shared protocol declaration. */
+export type ServerProtocolEntrypoint<Protocol extends EntrypointProtocolDeclaration> = ServerEntrypoint<object> & {
+    readonly protocol: Protocol;
+};
+/** A handler that is inseparable from the protocol whose request it accepts. */
+export interface BoundEntrypointHandler<Protocol extends EntrypointProtocolDeclaration> {
+    readonly protocol: Protocol;
+    bind: RefedEntrypointHandler;
+}
 //# 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,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACxG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEhD,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,gBAAgB;IAC3D,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,iBAAiB,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,uBAAuB;IACnE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,YAAY,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,YAAa,SAAQ,OAAO;IAC3C,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAC5C;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,EAAE;IAC5C,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAA;CAC3C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAClF,OAAO,KAAK,EACV,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,6BAA6B,EAC5F,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEhD,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,gBAAgB;IAC3D,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,iBAAiB,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,uBAAuB;IACnE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,YAAY,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,YAAa,SAAQ,OAAO;IAC3C,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAC5C;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,GAAG,EAAE;IAC5C,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAA;CAC3C;AAED,wEAAwE;AACxE,MAAM,MAAM,wBAAwB,CAAC,QAAQ,SAAS,6BAA6B,IAAI,gBAAgB,CAAC,MAAM,CAAC,GAAG;IAChH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAC5B,CAAA;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB,CAAC,QAAQ,SAAS,6BAA6B;IACpF,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,IAAI,EAAE,sBAAsB,CAAA;CAC7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/server-entrypoint",
-  "version": "0.1.18-rc.10",
+  "version": "0.1.18-rc.12",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,10 +21,10 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.18-rc.7",
-    "@owlmeans/entrypoint": "^0.1.18-rc.10",
-    "@owlmeans/route": "^0.1.18-rc.8",
-    "@owlmeans/server-route": "^0.1.18-rc.8"
+    "@owlmeans/context": "^0.1.18-rc.9",
+    "@owlmeans/entrypoint": "^0.1.18-rc.12",
+    "@owlmeans/route": "^0.1.18-rc.10",
+    "@owlmeans/server-route": "^0.1.18-rc.10"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/src/helper.ts

@@ -1,7 +1,12 @@
-import type { ServerEntrypoint, EntrypointOptions, RefedEntrypointHandler } from './types.js'
+import type {
+  BoundEntrypointHandler, ServerEntrypoint, EntrypointOptions, RefedEntrypointHandler,
+  ServerProtocolEntrypoint,
+} from './types.js'
 import { entrypoint } from './entrypoint.js'
+import { bind } from './protocol.js'
 import { createBasicGuard } from './utils/helper.js'
-import type { CommonEntrypoint } from '@owlmeans/entrypoint'
+import { isEntrypointProtocol } from '@owlmeans/entrypoint'
+import type { CommonEntrypoint, EntrypointProtocolDeclaration } from '@owlmeans/entrypoint'
 
 /**
  * Replace the entrypoint declared under `alias` with its elevated counterpart. Elevating is
@@ -10,15 +15,37 @@ import type { CommonEntrypoint } from '@owlmeans/entrypoint'
  *
  * @throws {SyntaxError} when no entrypoint carries the alias
  */
-export const elevate = <R>(
+export function elevate(
+  declarations: EntrypointProtocolDeclaration[],
+  implementations: readonly BoundEntrypointHandler<EntrypointProtocolDeclaration>[],
+): ServerProtocolEntrypoint<EntrypointProtocolDeclaration>[]
+export function elevate<R>(
   entrypoints: (CommonEntrypoint | ServerEntrypoint<R>)[],
   alias: string,
   handler?: RefedEntrypointHandler<R> | boolean | EntrypointOptions<R>,
   opts?: boolean | EntrypointOptions<R>
-): ServerEntrypoint<R>[] => {
-  const idx = entrypoints.findIndex(({ route }) => route.route.alias === alias)
+): ServerEntrypoint<R>[]
+export function elevate(
+  entrypoints: (CommonEntrypoint | EntrypointProtocolDeclaration)[],
+  target: string | readonly BoundEntrypointHandler<EntrypointProtocolDeclaration>[],
+  handler?: RefedEntrypointHandler | boolean | EntrypointOptions<object>,
+  opts?: boolean | EntrypointOptions<object>,
+): (ServerEntrypoint<object> | ServerProtocolEntrypoint<EntrypointProtocolDeclaration>)[] {
+  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 ${alias} not present`)
+    throw new SyntaxError(`Entrypoint with alias ${target} not present`)
   }
   if (typeof handler === 'boolean') {
     opts = handler
@@ -29,11 +56,16 @@ export const elevate = <R>(
     handler = undefined
   }
 
+  const declaration = entrypoints[idx]
+  if (isEntrypointProtocol(declaration)) {
+    throw new SyntaxError('String elevation accepts materialized entrypoints only')
+  }
+
   entrypoints[idx] = entrypoint(
-    entrypoints[idx], handler, typeof opts === 'boolean' ? { intermediate: opts } : opts
+    declaration, handler, typeof opts === 'boolean' ? { intermediate: opts } : opts
   )
 
-  return entrypoints as ServerEntrypoint<R>[]
+  return entrypoints as ServerEntrypoint<object>[]
 }
 
 export const guard = <R>(guard: string, opts?: EntrypointOptions<R>): EntrypointOptions<R> =>

package/src/index.ts

@@ -2,3 +2,4 @@
 export * from './helper.js'
 export type * from './types.js'
 export * from './entrypoint.js'
+export * from './protocol.js'

package/src/protocol.ts

@@ -0,0 +1,21 @@
+import { materializeEntrypoint } from '@owlmeans/entrypoint'
+import type { EntrypointProtocolDeclaration } from '@owlmeans/entrypoint'
+import { entrypoint } from './entrypoint.js'
+import type {
+  BoundEntrypointHandler, EntrypointOptions, ServerProtocolEntrypoint,
+} from './types.js'
+
+/** Bind one immutable protocol and, when present, its protocol-bound implementation. */
+export const bind = <Protocol extends EntrypointProtocolDeclaration>(
+  protocol: Protocol,
+  implementation?: BoundEntrypointHandler<Protocol>,
+  options?: EntrypointOptions<object>,
+): ServerProtocolEntrypoint<Protocol> => {
+  const bound = Object.assign(entrypoint(
+    materializeEntrypoint(protocol),
+    implementation?.bind,
+    options,
+  ), { protocol })
+
+  return bound as ServerProtocolEntrypoint<Protocol>
+}

package/src/types.ts

@@ -1,5 +1,7 @@
 import type { ServerRouteModel, ServerRouteOptions } from '@owlmeans/server-route'
-import type { CommonEntrypoint, EntrypointHandler, CommonEntrypointOptions } from '@owlmeans/entrypoint'
+import type {
+  CommonEntrypoint, EntrypointHandler, CommonEntrypointOptions, EntrypointProtocolDeclaration,
+} from '@owlmeans/entrypoint'
 import type { Service } from '@owlmeans/context'
 
 export interface ServerEntrypoint<R> extends CommonEntrypoint {
@@ -25,3 +27,14 @@ export interface EntrypointRef<R> {
 export interface RefedEntrypointHandler<R = {}> {
   (ref: EntrypointRef<R>): EntrypointHandler
 }
+
+/** The server-local representation of a shared protocol declaration. */
+export type ServerProtocolEntrypoint<Protocol extends EntrypointProtocolDeclaration> = ServerEntrypoint<object> & {
+  readonly protocol: Protocol
+}
+
+/** A handler that is inseparable from the protocol whose request it accepts. */
+export interface BoundEntrypointHandler<Protocol extends EntrypointProtocolDeclaration> {
+  readonly protocol: Protocol
+  bind: RefedEntrypointHandler
+}