@owlmeans/server-entrypoint 0.1.18-rc.9 → 0.1.18

package/README.md

@@ -1,72 +1,150 @@
 # @owlmeans/server-entrypoint
 
-Elevates route definitions into runnable server entrypoints with attached request handlers.
-
-## Overview
-
-- `elevate(entrypoints, alias, handler?, opts?)` attaches a `RefedEntrypointHandler` to an existing entrypoint in place
-- `entrypoint(commonEntrypoint, handler?, opts?)` wraps a `CommonEntrypoint` into a `ServerEntrypoint`
-- `guard(alias, opts?)` creates `EntrypointOptions` requiring a named guard service
-- Used internally by `@owlmeans/server-app`'s `elevate` re-export
+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
+bun add @owlmeans/server-entrypoint@^0.1.18
 ```
 
+## 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 — define entrypoints separately, elevate with handlers:
+### Bind leaves and their parents
 
-```typescript
-import { elevate, guard } from '@owlmeans/server-app'
-import { handleBody, handleParams } from '@owlmeans/server-app'
+```ts
+import { bind } from '@owlmeans/server-entrypoint'
+import { handlers } from '@owlmeans/server-api'
+import { projectProtocols } from 'my-app-common'
+import type { Context } from './context.js'
 
-const appEntrypoints = [
-  entrypoint(route('project-create', '/projects', backend(RouteMethod.POST)), guard('auth')),
-  entrypoint(route('project-get', '/projects/:id', backend())),
+const api = handlers<Context>()
+
+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))),
 ]
+```
 
-elevate(appEntrypoints, 'project-create', handleBody(async (payload, ctx) => {
-  return await ctx.project().create(payload)
-}))
+### Bind a flat collection
 
-elevate(appEntrypoints, 'project-get', handleParams(async (params, ctx) => {
-  return await ctx.project().get(params.id)
-}))
-```
+`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.
 
-## API
+```ts
+import { bindAll } from '@owlmeans/server-entrypoint'
+import { protocols } from '@owlmeans/entrypoint'
+import * as project from './app/project.js'
 
-### `elevate<R>(entrypoints, alias, handler?, opts?): ServerEntrypoint<R>[]`
+export const projectBindings = bindAll(protocols(projectProtocols), [
+  project.list,
+  project.create,
+  project.get,
+])
+```
 
-Replaces the element carrying `alias` with its elevated counterpart, in place, attaching `handler`. Elevating the same alias again just replaces it again; guards passed here are added to the ones the entrypoint declared. Throws when no entrypoint carries the alias.
+### Bind a tree by path
 
-### `entrypoint<R>(commonEntrypoint, handler?, opts?): ServerEntrypoint<R>`
+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:
 
-Wraps a single `CommonEntrypoint` into a `ServerEntrypoint`. Lower-level than `elevate`.
+```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'
 
-### `guard<R>(guard, opts?): EntrypointOptions<R>`
+type Implementations = Record<string, unknown>
 
-Returns `EntrypointOptions` that require the named guard service to pass before the handler runs.
+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)
+  })
 
-### `ServerEntrypoint<R>`
+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 },
+})
+```
 
-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
+### Server-local options
 
-### `RefedEntrypointHandler<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.
 
-A handler factory: `(ref: { ref?: { ctx?: Context } }) => EntrypointHandler`.
+```ts
+import { bind } from '@owlmeans/server-entrypoint'
 
-## Related Packages
+export const serverBindings = [
+  bind(sessionProtocols.base, undefined, { intermediate: true }),
+  bind(invoiceProtocols.download, invoice.download, { fixer: MY_APP_DOWNLOAD_FIXER }),
+]
+```
+
+## API
 
-- [`@owlmeans/entrypoint`](../entrypoint) — `CommonEntrypoint` base that gets elevated
-- [`@owlmeans/server-api`](../server-api) — handler wrappers (`handleBody`, etc.) used with `elevate`
-- [`@owlmeans/server-app`](../server-app) — re-exports `elevate`, `entrypoint`, `guard`
+| 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) — `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
@@ -76,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
+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/server-entrypoint",
-  "version": "0.1.18-rc.9",
-  "generatedAt": "2026-09-01T16:28:56.991Z",
+  "version": "0.1.18",
+  "generatedAt": "2026-10-28T00:31:34.739Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -1,62 +1,39 @@
 ---
 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: Bind immutable @owlmeans/entrypoint declarations to protocol-bound server implementations. Load when serving a shared API, socket, or queue entrypoint.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 
 # @owlmeans/server-entrypoint
 
-**Layer:** Server
-**Install:** `"@owlmeans/server-entrypoint": "^0.1.18-rc.9"` in `dependencies`
+**Install:** `bun add @owlmeans/server-entrypoint@^0.1.18`
 
-## Key Exports
+Bind the imported protocol object to the implementation that serves it:
 
-| 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)`) |
+```ts
+import { bind } from '@owlmeans/server-entrypoint'
+import { handlers } from '@owlmeans/server-api'
 
-## Usage
+const api = handlers<AppContext>()
 
-Most app code uses `elevate()` from `@owlmeans/server-app` (which builds on this package). Import directly only when implementing custom entrypoint helpers.
-
-```typescript
-import type { ServerEntrypoint } from '@owlmeans/server-entrypoint'
+export const serverBindings = [
+  bind(projectProtocols.create, api.body(projectProtocols.create, async (body, context) =>
+    context.projects.create(body)
+  )),
+]
 ```
 
-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.
-
-## What a server registers
-
-`mount()` is the address a server binds: `base` plus every ancestor's segment, then this one. The
-declaration itself only ever states the segment it contributes, so composing the rest takes the
-context the entrypoint is registered in — which is why route registration happens after `init()`,
-never at declaration time.
-
-```typescript
-server.route({ url: entrypoint.mount(), method, handler })
-entrypoint.route.match(request, entrypoint.mount())   // intermediates test the same mount
-```
-
-## Cross-Service URL Generation
-
-Use `makeSecurityHelper` from `@owlmeans/config` to build URLs pointing at other services (OAuth redirect URIs, webhook callbacks, etc.):
-
-```typescript
-import { makeSecurityHelper } from '@owlmeans/config'
-const helper = makeSecurityHelper<Config, Context>(ctx)
-const url = helper.makeUrl(entrypoint.address(), '/callback')
-```
+`bind(protocol, handler?, options?)` returns a `ServerProtocolEntrypoint<Protocol>`.
+`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)`.
 
-## Depends On
+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.
 
-- `@owlmeans/entrypoint`, `@owlmeans/server-route`, `@owlmeans/server-context`
+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.d.ts

@@ -1,6 +1,6 @@
 import type { ServerRouteModel } from '@owlmeans/server-route';
 import type { ServerEntrypoint, EntrypointOptions, RefedEntrypointHandler } from './types.js';
 import type { CommonEntrypoint } from '@owlmeans/entrypoint';
-import type { RouteModel } from '@owlmeans/route';
-export declare const entrypoint: <R>(arg: CommonEntrypoint | ServerRouteModel<R> | RouteModel, handler?: RefedEntrypointHandler<R>, opts?: EntrypointOptions<R>) => ServerEntrypoint<R>;
+import type { CommonRouteModel } from '@owlmeans/route';
+export declare const entrypoint: <R>(arg: CommonEntrypoint | ServerRouteModel<R> | CommonRouteModel, handler?: RefedEntrypointHandler<R>, opts?: EntrypointOptions<R>) => ServerEntrypoint<R>;
 //# sourceMappingURL=entrypoint.d.ts.map

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,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAIvD,eAAO,MAAM,UAAU,GAAI,CAAC,EAC1B,KAAK,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,EAAE,UAAU,sBAAsB,CAAC,CAAC,CAAC,EAAE,OAAO,iBAAiB,CAAC,CAAC,CAAC,KAC/H,gBAAgB,CAAC,CAAC,CAuCpB,CAAA"}

package/build/entrypoint.js

@@ -1,19 +1,15 @@
 import { isEntrypoint, makeCommonEntrypoint } from './utils/entrypoint.js';
 import { isServerRouteModel, route } from '@owlmeans/server-route';
+import { prependBase } from '@owlmeans/route/utils';
 export const entrypoint = (arg, handler, opts) => {
     const entrypointHandle = { ref: undefined };
     let _entrypoint;
     if (isEntrypoint(arg)) {
-        // 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);
-        const routeModel = route(arg.route, intermediate, opts?.routeOptions);
+        const routeModel = route(arg.route, opts?.intermediate ?? false, opts?.routeOptions);
         _entrypoint = arg;
         _entrypoint.route = routeModel;
         _entrypoint.filter = opts?.filter ?? arg.filter;
-        // Elevating adds guards, it never swaps them: what the entrypoint declared still applies.
-        _entrypoint.guards = [...new Set([...(arg.guards ?? []), ...(opts?.guards ?? [])])];
+        _entrypoint.guards = [...(arg.guards ?? []), ...(opts?.guards ?? [])];
         _entrypoint.gate = opts?.gate ?? arg.gate;
         _entrypoint.gateParams = opts?.gateParams ?? arg.gateParams;
     }
@@ -26,10 +22,16 @@ export const entrypoint = (arg, handler, opts) => {
         _entrypoint = makeCommonEntrypoint(_route, { ...opts });
         _entrypoint.route = _route;
     }
-    _entrypoint.fixer = opts?.fixer ?? _entrypoint.fixer;
+    _entrypoint.fixer = opts?.fixer;
     if (handler != null) {
         _entrypoint.handle = handler(entrypointHandle);
     }
+    _entrypoint.reinitializeContext = (context) => {
+        const newEntrypoint = entrypoint(arg, handler, opts);
+        newEntrypoint.ctx = context;
+        return newEntrypoint;
+    };
+    _entrypoint.getPath = () => prependBase(_entrypoint.route.route);
     entrypointHandle.ref = _entrypoint;
     return _entrypoint;
 };

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,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"}
+{"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,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,GAA8D,EAAE,OAAmC,EAAE,IAA2B,EAC3G,EAAE;IACvB,MAAM,gBAAgB,GAAqB,EAAE,GAAG,EAAE,SAAS,EAAE,CAAA;IAE7D,IAAI,WAAgC,CAAA;IAEpC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,IAAI,KAAK,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QACpF,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,WAAW,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,CAAA;QACrE,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,CAAA;IAC/B,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,WAAW,CAAC,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAChD,CAAC;IAED,WAAW,CAAC,mBAAmB,GAAG,CAAI,OAA0B,EAAE,EAAE;QAClE,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;QACpD,aAAa,CAAC,GAAG,GAAG,OAAO,CAAA;QAE3B,OAAO,aAAkB,CAAA;IAC3B,CAAC,CAAA;IAED,WAAW,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAEhE,gBAAgB,CAAC,GAAG,GAAG,WAAW,CAAA;IAElC,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA"}

package/build/helper.d.ts

@@ -1,12 +1,5 @@
 import type { ServerEntrypoint, EntrypointOptions, RefedEntrypointHandler } from './types.js';
 import type { CommonEntrypoint } 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
- * are added to the ones already declared.
- *
- * @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 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,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAI7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,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,EAuBrB,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,OAAO,MAAM,EAAE,OAAO,iBAAiB,CAAC,CAAC,CAAC,KAAG,iBAAiB,CAAC,CAAC,CACjD,CAAA"}

package/build/helper.js

@@ -1,12 +1,6 @@
 import { entrypoint } from './entrypoint.js';
+import { isServerRouteModel } from '@owlmeans/server-route';
 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);
     if (idx === -1) {
@@ -20,6 +14,10 @@ export const elevate = (entrypoints, alias, handler, opts) => {
         opts = handler;
         handler = undefined;
     }
+    const force = typeof opts === 'object' && opts.force;
+    if (isServerRouteModel(entrypoints[idx].route) && !force) {
+        throw new SyntaxError(`Entrypoint with alias ${alias} is already elevated`);
+    }
     entrypoints[idx] = entrypoint(entrypoints[idx], 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":"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":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAGpD,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;IACD,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAA;IACpD,IAAI,kBAAkB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACzD,MAAM,IAAI,WAAW,CAAC,yBAAyB,KAAK,sBAAsB,CAAC,CAAA;IAC7E,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"}

package/build/index.d.ts

@@ -1,4 +1,3 @@
-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,mBAAmB,YAAY,CAAA;AAC/B,cAAc,eAAe,CAAA"}

package/build/index.js

@@ -1,3 +1,2 @@
-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":"AAEA,cAAc,eAAe,CAAA"}

package/build/protocol.d.ts

@@ -0,0 +1,8 @@
+import { type EntrypointProtocolDeclaration } from '@owlmeans/entrypoint';
+import type { BoundEntrypointHandler, EntrypointOptions, ServerProtocolEntrypoint } from './types.js';
+import type { ServerBinding } from './types.local.js';
+/** Bind one immutable protocol and, when present, its protocol-bound implementation. */
+export declare const bind: <Protocol extends EntrypointProtocolDeclaration>(protocol: Protocol, implementation?: ServerBinding<Protocol>, options?: EntrypointOptions<object>) => ServerProtocolEntrypoint<Protocol>;
+/** Bind a flat declaration collection and pair each protocol with its own implementation. */
+export declare const bindAll: <Protocol extends EntrypointProtocolDeclaration>(declarations: readonly Protocol[], implementations?: readonly BoundEntrypointHandler<Protocol>[]) => 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":"AAAA,OAAO,EAAgD,KAAK,6BAA6B,EAAE,MAAM,sBAAsB,CAAA;AAEvH,OAAO,KAAK,EACV,sBAAsB,EAAE,iBAAiB,EACzC,wBAAwB,EACzB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAyBrD,wFAAwF;AACxF,eAAO,MAAM,IAAI,GAAI,QAAQ,SAAS,6BAA6B,YACvD,QAAQ,mBACD,aAAa,CAAC,QAAQ,CAAC,YAC9B,iBAAiB,CAAC,MAAM,CAAC,KAClC,wBAAwB,CAAC,QAAQ,CAWnC,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,OAAO,GAAI,QAAQ,SAAS,6BAA6B,gBACtD,SAAS,QAAQ,EAAE,oBAChB,SAAS,sBAAsB,CAAC,QAAQ,CAAC,EAAE,KAC3D,wBAAwB,CAAC,QAAQ,CAAC,EAEpC,CAAA"}

package/build/protocol.js

@@ -0,0 +1,30 @@
+import { materializeEntrypoint } from '@owlmeans/entrypoint';
+import { isServerRouteModel, route } from '@owlmeans/server-route';
+/** Attach a server implementation to an entrypoint materialized from a protocol declaration. */
+const bindMaterializedEntrypoint = (declaration, handler, options) => {
+    const ref = { ref: undefined };
+    const intermediate = options?.intermediate
+        ?? (isServerRouteModel(declaration.route) ? declaration.route.isIntermediate() : false);
+    const bound = declaration;
+    bound.route = route(declaration.route, intermediate, options?.routeOptions);
+    bound.filter = options?.filter ?? declaration.filter;
+    bound.guards = [...new Set([...(declaration.guards ?? []), ...(options?.guards ?? [])])];
+    bound.gate = options?.gate ?? declaration.gate;
+    bound.gateParams = options?.gateParams ?? declaration.gateParams;
+    bound.fixer = options?.fixer ?? bound.fixer;
+    if (handler != null)
+        bound.handle = handler(ref);
+    ref.ref = bound;
+    return bound;
+};
+/** Bind one immutable protocol and, when present, its protocol-bound implementation. */
+export const bind = (protocol, implementation, options) => {
+    const handler = typeof implementation === 'function'
+        ? implementation
+        : implementation?.bind;
+    const bound = Object.assign(bindMaterializedEntrypoint(materializeEntrypoint(protocol), handler, options), { protocol });
+    return bound;
+};
+/** Bind a flat declaration collection and pair each protocol with its own implementation. */
+export const bindAll = (declarations, implementations = []) => declarations.map(declaration => bind(declaration, implementations.find(implementation => implementation.protocol === declaration)));
+//# 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,EAA6D,MAAM,sBAAsB,CAAA;AACvH,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAOlE,gGAAgG;AAChG,MAAM,0BAA0B,GAAG,CACjC,WAA6B,EAC7B,OAAmC,EACnC,OAA8B,EACT,EAAE;IACvB,MAAM,GAAG,GAAqB,EAAE,GAAG,EAAE,SAAS,EAAE,CAAA;IAChD,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY;WACrC,CAAC,kBAAkB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACzF,MAAM,KAAK,GAAG,WAAkC,CAAA;IAEhD,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;IAC3E,KAAK,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,WAAW,CAAC,MAAM,CAAA;IACpD,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACxF,KAAK,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,WAAW,CAAC,IAAI,CAAA;IAC9C,KAAK,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,WAAW,CAAC,UAAU,CAAA;IAChE,KAAK,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,KAAK,CAAA;IAC3C,IAAI,OAAO,IAAI,IAAI;QAAE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAChD,GAAG,CAAC,GAAG,GAAG,KAAK,CAAA;IAEf,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,wFAAwF;AACxF,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,QAAkB,EAClB,cAAwC,EACxC,OAAmC,EACC,EAAE;IACtC,MAAM,OAAO,GAAG,OAAO,cAAc,KAAK,UAAU;QAClD,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,cAAc,EAAE,IAAI,CAAA;IACxB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,0BAA0B,CACpD,qBAAqB,CAAC,QAAQ,CAAC,EAC/B,OAAO,EACP,OAAO,CACR,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;IAEhB,OAAO,KAA2C,CAAA;AACpD,CAAC,CAAA;AAED,6FAA6F;AAC7F,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,YAAiC,EACjC,eAAe,GAAgD,EAAE,EAC3B,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CACxE,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,cAAc,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC,CACnG,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 interface ServerProtocolEntrypoint<Protocol extends EntrypointProtocolDeclaration> extends 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,WAAW,wBAAwB,CAAC,QAAQ,SAAS,6BAA6B,CAAE,SAAQ,gBAAgB,CAAC,MAAM,CAAC;IAAG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE;AAE1J,gFAAgF;AAChF,MAAM,WAAW,sBAAsB,CAAC,QAAQ,SAAS,6BAA6B;IACpF,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,IAAI,EAAE,sBAAsB,CAAA;CAC7B"}

package/build/types.local.d.ts

@@ -0,0 +1,4 @@
+import type { EntrypointProtocolDeclaration } from '@owlmeans/entrypoint';
+import type { BoundEntrypointHandler, RefedEntrypointHandler } from './types.js';
+export type ServerBinding<Protocol extends EntrypointProtocolDeclaration> = BoundEntrypointHandler<Protocol> | RefedEntrypointHandler;
+//# sourceMappingURL=types.local.d.ts.map

package/build/types.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.local.d.ts","sourceRoot":"","sources":["../src/types.local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAA;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAEhF,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,6BAA6B,IACpE,sBAAsB,CAAC,QAAQ,CAAC,GAChC,sBAAsB,CAAA"}

package/build/types.local.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.local.js.map

package/build/types.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.local.js","sourceRoot":"","sources":["../src/types.local.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/server-entrypoint",
-  "version": "0.1.18-rc.9",
+  "version": "0.1.18",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,14 +21,14 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.18-rc.7",
-    "@owlmeans/entrypoint": "^0.1.18-rc.9",
-    "@owlmeans/route": "^0.1.18-rc.7",
-    "@owlmeans/server-route": "^0.1.18-rc.7"
+    "@owlmeans/context": "^0.1.18",
+    "@owlmeans/entrypoint": "^0.1.18",
+    "@owlmeans/route": "^0.1.18",
+    "@owlmeans/server-route": "^0.1.18"
   },
   "devDependencies": {
-    "@owlmeans/dep-config": "workspace:*",
-    "@types/node": "^26.1.0",
+    "@owlmeans/dep-config": "^0.1.18",
+    "@types/node": "^26.6.4",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },

package/src/index.ts

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

package/src/protocol.ts

@@ -0,0 +1,56 @@
+import { materializeEntrypoint, type CommonEntrypoint, type EntrypointProtocolDeclaration } from '@owlmeans/entrypoint'
+import { isServerRouteModel, route } from '@owlmeans/server-route'
+import type {
+  BoundEntrypointHandler, EntrypointOptions, EntrypointRef, RefedEntrypointHandler, ServerEntrypoint,
+  ServerProtocolEntrypoint,
+} from './types.js'
+import type { ServerBinding } from './types.local.js'
+
+/** Attach a server implementation to an entrypoint materialized from a protocol declaration. */
+const bindMaterializedEntrypoint = <R>(
+  declaration: CommonEntrypoint,
+  handler?: RefedEntrypointHandler<R>,
+  options?: EntrypointOptions<R>,
+): ServerEntrypoint<R> => {
+  const ref: EntrypointRef<R> = { ref: undefined }
+  const intermediate = options?.intermediate
+    ?? (isServerRouteModel(declaration.route) ? declaration.route.isIntermediate() : false)
+  const bound = declaration as ServerEntrypoint<R>
+
+  bound.route = route(declaration.route, intermediate, options?.routeOptions)
+  bound.filter = options?.filter ?? declaration.filter
+  bound.guards = [...new Set([...(declaration.guards ?? []), ...(options?.guards ?? [])])]
+  bound.gate = options?.gate ?? declaration.gate
+  bound.gateParams = options?.gateParams ?? declaration.gateParams
+  bound.fixer = options?.fixer ?? bound.fixer
+  if (handler != null) bound.handle = handler(ref)
+  ref.ref = bound
+
+  return bound
+}
+
+/** Bind one immutable protocol and, when present, its protocol-bound implementation. */
+export const bind = <Protocol extends EntrypointProtocolDeclaration>(
+  protocol: Protocol,
+  implementation?: ServerBinding<Protocol>,
+  options?: EntrypointOptions<object>,
+): ServerProtocolEntrypoint<Protocol> => {
+  const handler = typeof implementation === 'function'
+    ? implementation
+    : implementation?.bind
+  const bound = Object.assign(bindMaterializedEntrypoint(
+    materializeEntrypoint(protocol),
+    handler,
+    options,
+  ), { protocol })
+
+  return bound as ServerProtocolEntrypoint<Protocol>
+}
+
+/** Bind a flat declaration collection and pair each protocol with its own implementation. */
+export const bindAll = <Protocol extends EntrypointProtocolDeclaration>(
+  declarations: readonly Protocol[],
+  implementations: readonly BoundEntrypointHandler<Protocol>[] = [],
+): ServerProtocolEntrypoint<Protocol>[] => declarations.map(declaration =>
+  bind(declaration, implementations.find(implementation => implementation.protocol === declaration)),
+)

package/src/types.local.ts

@@ -0,0 +1,6 @@
+import type { EntrypointProtocolDeclaration } from '@owlmeans/entrypoint'
+import type { BoundEntrypointHandler, RefedEntrypointHandler } from './types.js'
+
+export type ServerBinding<Protocol extends EntrypointProtocolDeclaration> =
+  | BoundEntrypointHandler<Protocol>
+  | RefedEntrypointHandler

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,12 @@ export interface EntrypointRef<R> {
 export interface RefedEntrypointHandler<R = {}> {
   (ref: EntrypointRef<R>): EntrypointHandler
 }
+
+/** The server-local representation of a shared protocol declaration. */
+export interface ServerProtocolEntrypoint<Protocol extends EntrypointProtocolDeclaration> extends 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
+}

package/src/entrypoint.ts

@@ -1,45 +0,0 @@
-import type { ServerRouteModel } from '@owlmeans/server-route'
-import type { ServerEntrypoint, EntrypointOptions, EntrypointRef, RefedEntrypointHandler } from './types.js'
-import { isEntrypoint, makeCommonEntrypoint } from './utils/entrypoint.js'
-import { isServerRouteModel, route } from '@owlmeans/server-route'
-import type { CommonEntrypoint } from '@owlmeans/entrypoint'
-import type { RouteModel } from '@owlmeans/route'
-
-export const entrypoint = <R>(
-  arg: CommonEntrypoint | ServerRouteModel<R> | RouteModel, handler?: RefedEntrypointHandler<R>, opts?: EntrypointOptions<R>
-): ServerEntrypoint<R> => {
-  const entrypointHandle: EntrypointRef<R> = { ref: undefined }
-
-  let _entrypoint: ServerEntrypoint<R>
-
-  if (isEntrypoint(arg)) {
-    // 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)
-    const routeModel = route(arg.route, intermediate, opts?.routeOptions)
-    _entrypoint = arg as ServerEntrypoint<R>
-    _entrypoint.route = routeModel
-    _entrypoint.filter = opts?.filter ?? arg.filter
-    // 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
-  } else if (isServerRouteModel(arg)) {
-    _entrypoint = makeCommonEntrypoint(arg, { ...opts }) as ServerEntrypoint<R>
-    _entrypoint.route = arg
-  } else {
-    const _route = route(arg, opts?.intermediate ?? false, opts?.routeOptions)
-    _entrypoint = makeCommonEntrypoint(_route, { ...opts }) as ServerEntrypoint<R>
-    _entrypoint.route = _route
-  }
-
-  _entrypoint.fixer = opts?.fixer ?? _entrypoint.fixer
-  if (handler != null) {
-    _entrypoint.handle = handler(entrypointHandle)
-  }
-
-  entrypointHandle.ref = _entrypoint
-
-  return _entrypoint
-}

package/src/helper.ts

@@ -1,40 +0,0 @@
-import type { ServerEntrypoint, EntrypointOptions, RefedEntrypointHandler } from './types.js'
-import { entrypoint } from './entrypoint.js'
-import { createBasicGuard } from './utils/helper.js'
-import type { CommonEntrypoint } 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
- * are added to the ones already declared.
- *
- * @throws {SyntaxError} when no entrypoint carries the alias
- */
-export const 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)
-  if (idx === -1) {
-    throw new SyntaxError(`Entrypoint with alias ${alias} not present`)
-  }
-  if (typeof handler === 'boolean') {
-    opts = handler
-    handler = undefined
-  }
-  if (typeof handler === 'object' && typeof handler !== 'function') {
-    opts = handler
-    handler = undefined
-  }
-
-  entrypoints[idx] = entrypoint(
-    entrypoints[idx], handler, typeof opts === 'boolean' ? { intermediate: opts } : opts
-  )
-
-  return entrypoints as ServerEntrypoint<R>[]
-}
-
-export const guard = <R>(guard: string, opts?: EntrypointOptions<R>): EntrypointOptions<R> =>
-  ({ ...createBasicGuard(guard, opts) })

package/src/utils/entrypoint.ts

@@ -1,3 +0,0 @@
-
-export { entrypoint as makeCommonEntrypoint } from '@owlmeans/entrypoint'
-export { isEntrypoint } from '@owlmeans/entrypoint/utils'

package/src/utils/helper.ts

@@ -1,2 +0,0 @@
-
-export { guard as createBasicGuard } from '@owlmeans/entrypoint'