@owlmeans/client-entrypoint 0.1.18-rc.4 → 0.1.18-rc.40

package/README.md

@@ -1,80 +1,200 @@
 # @owlmeans/client-entrypoint
 
-Client-side entrypoint system: elevates route definitions into API-calling `ClientEntrypoint` instances.
-
-## Overview
-
-- `elevate(entrypoints, alias, handler?, opts?)` — attaches a client handler to an entrypoint (mirrors server `elevate`)
-- `ClientEntrypoint<T>` has a `call(request?)` method that resolves the URL and makes an HTTP/WS request
-- `stab` — no-op handler for entrypoints that only need URL resolution (no logic)
-- `provideRequest(alias, path)` — creates an `AbstractRequest` for programmatic entrypoint calls
-- `pickPerSchema(schema, obj)` — extracts fields from an object matching an AJV schema
-- Re-exported as `celevate` from `@owlmeans/server-app`
+Client-side binding of shared entrypoint protocols. It turns an immutable `@owlmeans/entrypoint`
+declaration into a context entrypoint with three verbs: `call()`, `invoke()` and `url()`. Every
+browser and native OwlMeans app uses it, usually through the `bind` / `bindAll` / `bindScreen`
+re-exports of `@owlmeans/web-client` or `@owlmeans/web-panel`. Protocols are declared with
+[`@owlmeans/entrypoint`](../entrypoint), never here. Server handlers are bound with
+[`@owlmeans/server-entrypoint`](../server-entrypoint).
 
 ## Installation
 
 ```bash
-bun add @owlmeans/client-entrypoint
+bun add @owlmeans/client-entrypoint@^0.1.18-rc.40
 ```
 
-## Usage
-
-Define and elevate a client entrypoint for API calls:
+## Concepts
+
+- **Protocol** — the shared, immutable declaration of one route, its typed request sections, its
+  response, guards and gate. Binding never mutates it, and `context.entrypoint(protocol)` derives
+  the request and reply types from it.
+- **Binding** — `bind`, `bindAll` and `bindScreen` materialize protocols into
+  `ClientProtocolEntrypoint<Protocol>` values, which the app hands to `context.registerEntrypoints`.
+- **Screen** — a binding that carries a renderer. It is addressed by `url()`; `call()` and
+  `invoke()` throw and point the caller at `url()`.
+- **Verbs** — `call()` resolves to the value and throws the reply's error; `invoke()` resolves to
+  `{ value, outcome }`; `url()` builds the address with `:params` filled in and the query appended.
+- **Transport selection** — the route's protocol decides the carrier. When a service is registered
+  under that protocol's transport alias (a socket or queue transport), it takes the call. Otherwise
+  the API client named by `cfg.webService` does — a string, or a map keyed by service name with a
+  default key. Callers never branch on it.
+- **Call options** — a request holds only the contract's sections (`params`, `query`, `body`,
+  `headers`) plus `CallOptions`: `auth`, `host`, `base`, `unsecure`, `timeout` and `signal`.
 
-```typescript
-import { elevate, stab } from '@owlmeans/client-entrypoint'
-import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
+## Usage
 
-const appModules = [
-  entrypoint(route('project-list', '/projects', frontend('base'))),
-  entrypoint(route('project-create', '/projects', backend(RouteMethod.POST))),
+### 1. Bind a protocol tree and screens
+
+```ts
+import { handler } from '@owlmeans/client'
+import { bind, bindAll, bindScreen, stab } from '@owlmeans/client-entrypoint'
+import { apiProtocols, webProtocols } from 'my-app-common'
+import { ProjectListScreen } from './screens/project-list.js'
+
+export const clientBindings = [
+  // Every API declaration the browser may call, route parents included.
+  ...bindAll(apiProtocols),
+  // A backend route outside that tree.
+  bind(apiProtocols.health),
+  bindScreen(webProtocols.projectList, handler(ProjectListScreen)),
+  // A frontend route only ever addressed by URL, with no component of its own here.
+  bindScreen(webProtocols.projectExport, stab),
 ]
 
-// Frontend navigation — just a stub, no network call
-elevate(appModules, 'project-list', stab)
-
-// Backend API call — call() makes a POST request
-elevate(appModules, 'project-create')
+context.registerEntrypoints(clientBindings)
 ```
 
-Call an entrypoint from a service:
+### 2. Per-binding options
+
+`bind` and `bindScreen` take `ClientEntrypointOptions`. Use `bind` instead of `bindAll` when one
+protocol needs something the rest do not.
+
+```ts
+import { authProtocols } from '@owlmeans/auth-common'
+import { bind, bindScreen, stab } from '@owlmeans/client-entrypoint'
+import { apiProtocols, MY_APP_WEB } from 'my-app-common'
 
-```typescript
-const agentEntrypoint = ctx.entrypoint<ClientEntrypoint<Project>>(agent.project.create)
-const [result] = await agentEntrypoint.call({
-  body: { prompt: payload.prompt, entity: req.auth?.entityId }
-})
+export const extraBindings = [
+  // Validate the request against the protocol's schemas before it leaves the browser.
+  bind(apiProtocols.project.create, { validateOnCall: true }),
+  // Pin a frontend route to an explicitly selected service.
+  bindScreen(authProtocols.flowEnter, stab, { routeOptions: { overrides: { service: MY_APP_WEB } } }),
+]
 ```
 
-## API
+### 3. Call, invoke, url
 
-### `elevate<T, R>(entrypoints, alias, handler?, opts?): ClientEntrypoint<T, R>[]`
+```ts
+import { EntrypointOutcome } from '@owlmeans/entrypoint'
 
-Mutates `entrypoints` in-place and returns the array typed as `ClientEntrypoint`. The `handler` sets how `call()` behaves.
+const create = ctx.entrypoint(apiProtocols.project.create)
 
-### `stab: RefedEntrypointHandler`
+// Value only. The body type comes from the shared contract; do not add a generic here.
+const project = await create.call({ body: { name: form.name } })
 
-No-op handler for frontend-only entrypoints that just need URL resolution.
+// Value and outcome, when the outcome decides the next step.
+const { value, outcome } = await ctx.entrypoint(apiProtocols.project.get).invoke({ params: { id } })
+if (outcome !== EntrypointOutcome.Ok) {
+  throw new ProjectMissing(id)
+}
 
-### `ClientEntrypoint<T>` (type)
+// A screen address; absolute when the route belongs to another service or when asked for.
+const href = await ctx.entrypoint(webProtocols.project).url({ params: { id: value.id } }, { absolute: true })
+```
 
-- `call(request?)` — resolves URL, makes HTTP request, returns `[T, EntrypointOutcome]`
-- `validate(request?)` — validates the request against the entrypoint filter schema
-- `getPath(partial?)` — returns the URL path (with or without path params)
+### 4. Timeouts and cancellation
+
+```ts
+const controller = new AbortController()
+const timer = setTimeout(() => controller.abort(), 15_000)
+
+try {
+  const files = await ctx.entrypoint(apiProtocols.files.list).call({
+    params: { id: projectId },
+    query: { path: '/' },
+    timeout: 10_000,
+    signal: controller.signal,
+  })
+  showFiles(files)
+} finally {
+  clearTimeout(timer)
+}
+```
 
-### `provideRequest<T>(alias, path): AbstractRequest<T>`
+A mutation route (`POST`, `PUT`, `PATCH`) always sends a body — `{}` when the contract has none —
+so `call({ params })` is enough. Never add `{ body: {} }` as a workaround.
 
-Creates a minimal request object for programmatic `call()` invocations.
+### 5. Narrowing a payload to a schema
 
-### `pickPerSchema<T>(schema, obj): Partial<T>`
+`pickPerSchema(object, schema)` keeps only the keys the AJV schema declares and skips `null` values.
+It is useful when a form model carries more fields than the contract accepts.
 
-Extracts only the keys present in the AJV schema from `obj`.
+```ts
+import { pickPerSchema } from '@owlmeans/client-entrypoint'
+import type { ProjectUpdate } from 'my-app-common'
+import { ProjectUpdateSchema } from 'my-app-common'
 
-## Related Packages
+const body = pickPerSchema<typeof formValues, ProjectUpdate>(formValues, ProjectUpdateSchema)
+await ctx.entrypoint(apiProtocols.project.update).call({ params: { id }, body })
+```
+
+## API
 
-- [`@owlmeans/entrypoint`](../entrypoint) — `CommonEntrypoint` base that gets elevated
-- [`@owlmeans/client`](../client) — `useNavigate` uses `ClientEntrypoint.call()`
-- [`@owlmeans/server-app`](../server-app) — re-exports `elevate` as `celevate`
+### `@owlmeans/client-entrypoint`
+
+| Symbol | Kind | Purpose |
+|---|---|---|
+| `bind(protocol, options?)` | function | Materialize one protocol for a client context |
+| `bindAll(tree)` | function | Materialize every protocol in a named declaration tree |
+| `bindScreen(protocol, handler, options?)` | function | Materialize a frontend protocol with its renderer |
+| `stab` | const | No-op `RefedEntrypointHandler` for a URL-only frontend binding |
+| `provideRequest(alias, path)` | function | A minimal `AbstractRequest` for a dynamic boundary (for example a socket request) |
+| `pickPerSchema(object, schema)` | function | Keep only the non-null keys an AJV schema declares |
+| `ClientProtocolEntrypoint<Protocol>` | type | The bound view of a protocol — see *Entrypoint members* |
+| `ClientEntrypoint<T, R>` | type | The untyped bound entrypoint shape the protocol view is built from |
+| `ClientEntrypointOptions` | type | `routeOptions?` (`ClientRouteOptions`), `validateOnCall?`, plus common entrypoint options |
+| `ClientRequest` | type | `AbstractRequest` as the client sends it |
+| `EntrypointCall`, `EntrypointInvoke`, `EntrypointReply`, `EntrypointUrl`, `EntrypointUrlOptions`, `EntrypointFilter` | type | Verb signatures; `EntrypointReply` is `{ value, outcome }`, `EntrypointUrlOptions` is `{ absolute? }` |
+| `EntrypointRef`, `RefedEntrypointHandler` | type | The handler-factory contract `bindScreen` and `stab` use |
+| `ClientEntrypointError` | class | Base client entrypoint error |
+| `ClientValidationError` | class | Thrown by `validate()` when a request does not match its schema |
+
+### Entrypoint members
+
+| Member | Purpose |
+|---|---|
+| `call(request?)` | Round trip; resolves to the value and throws the reply's error |
+| `invoke(request?)` | Same round trip; resolves to `{ value, outcome }` |
+| `url(request?, { absolute? })` | The address, with `:params` filled and the query appended |
+| `validate(request?)` | Check the request against the protocol's filter schemas |
+| `segment()`, `path()`, `mount()` | This route's segment, the segment under its ancestors, and that path under the service base — computed on every call, never written back |
+| `protocol` | The declaration the binding was made from |
+
+### `@owlmeans/client-entrypoint/utils`
+
+| Symbol | Kind | Purpose |
+|---|---|---|
+| `apiInvoke(ref, options?)` | function | The round trip behind `invoke()` |
+| `apiHandler(ref)` | function | The handler that picks the transport service or the API client |
+| `entrypointUrl(ref, request?, options?)` | function | The address behind `url()` |
+| `validate(ref)` | function | The filter behind `validate()` |
+| `isEntrypoint(value)` | function | Re-export from `@owlmeans/entrypoint/utils` |
+
+## Common pitfalls
+
+- **Pass protocol objects, never alias strings.** `context.entrypoint(protocol)` is the lookup;
+  `entrypointRef<Request, Response>(alias)` from `@owlmeans/entrypoint` is reserved for a dynamic
+  remote declaration that cannot be imported.
+- **Do not add a result generic at the call site.** When a type is wrong, fix the shared contract.
+- **Bind route parents too.** An unbound protocol throws "entrypoint not found" before the request
+  is sent, which a broad `catch` easily misreports as a server error.
+- **Screens reject `call()` and `invoke()`.** Use `url()` or navigate to them.
+- **`cfg.webService` must resolve.** A context whose `webService` names no client for the route's
+  service (and no default key) throws a `SyntaxError` on the first call.
+- **Socket URLs are always absolute.** A relative value would resolve against the page origin, which
+  in a split deployment is the web host rather than the service answering the upgrade.
+- **Never mutate a declaration or a shared declaration collection** to change a guard, gate or
+  service. Use binding options, or derive an immutable decoration in the shared package.
+
+## Related packages
+
+- [`@owlmeans/entrypoint`](../entrypoint) — `protocol()`, `contract()`, `typed()` and protocol trees
+- [`@owlmeans/client`](../client) — `handler`, `useNavigate`, `useEntrypoint`
+- [`@owlmeans/client-route`](../client-route) — client route models and `ClientRouteOptions`
+- [`@owlmeans/api`](../api) — the HTTP client that carries calls
+- [`@owlmeans/client-socket`](../client-socket) — socket transport for socket protocols
+- [`@owlmeans/server-entrypoint`](../server-entrypoint) — the server-side counterpart
+- [`@owlmeans/web-client`](../web-client) — re-exports the binding helpers for browser apps
 
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
@@ -84,7 +204,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.41
 ```
 
 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/client-entrypoint",
-  "version": "0.1.18-rc.0",
-  "generatedAt": "2026-08-16T22:20:50.501Z",
+  "version": "0.1.18-rc.40",
+  "generatedAt": "2026-09-28T02:06:37.875Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -1,50 +1,53 @@
 ---
 name: client-entrypoint
-description: How to use @owlmeans/client-entrypoint — client-side entrypoint helpers extending @owlmeans/entrypoint with React component attachment and call helpers. Auto-invoked when importing client entrypoint helpers. Also covers the deprecated @owlmeans/client-module reexport shim.
+description: Bind shared entrypoint protocols in a client context with typed call(), invoke(), url(), bindAll(), and bindScreen(). Load when wiring client API routes or screens.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 
 # @owlmeans/client-entrypoint
 
-**Layer:** Client
-**Install:** `"@owlmeans/client-entrypoint": "^0.1.18-rc.0"` in `dependencies`
+**Install:** `bun add @owlmeans/client-entrypoint@^0.1.18-rc.40`
 
-## Key Exports
+Bind a declaration from `@owlmeans/entrypoint`; never construct or replace a contextual
+entrypoint by alias.
 
-| Export | Description |
-|--------|-------------|
-| `ClientEntrypoint<T>` types | Client entrypoint interface (handler component + call helpers) |
-| `EntrypointCall` / `EntrypointFilter` | Typed call and validation helpers |
-| `EntrypointRef` / `RefedEntrypointHandler` | Handler reference pattern |
-| Entrypoint helpers | Build client entrypoints; resolve callable references |
+```ts
+import { bind, bindAll, bindScreen } from '@owlmeans/client-entrypoint'
 
-## Subpath Exports
+context.registerEntrypoints(bindAll(projectProtocols))
+context.registerEntrypoint(bind(projectProtocols.health))
+context.registerEntrypoint(bindScreen(projectProtocols.home, handler(Home)))
 
-- `./utils`
-
-## Usage
-
-Most app code uses `elevate()` from `@owlmeans/web-client` (which builds on this). Use this directly only for cross-platform entrypoint helpers.
-
-```typescript
-import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
+const value = await context.entrypoint(projectProtocols.create).call({ body })
+const { value, outcome } = await context.entrypoint(projectProtocols.create).invoke({ body })
+const href = await context.entrypoint(projectProtocols.edit).url({ params: { id } })
 ```
 
-## URL Generation via Entrypoint Call
-
-Entrypoints with a `handler` (React component) use `urlCall` internally — calling `.call()` returns a URL string. Use `{ full: true }` to get a fully-qualified URL via `makeSecurityHelper`:
+`bindAll(tree)` flattens a nested named declaration tree while preserving the union of its protocol
+types. `bind(protocol)` is appropriate where one protocol must use a distinct client option.
+`bindScreen` is for a frontend route and renderer; screens are addressed by `url` and reject
+`call`/`invoke`.
 
-```typescript
-import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
-import { HOME } from '@owlmeans/context'
+`bindScreen` takes a `lazyHandler(...)` result (`@owlmeans/client`) directly, the same as
+`handler(Component)`: both return a `RefedEntrypointHandler`, the lazy one also carrying
+`.preload()`, so no different wiring is needed. Create it at module scope, never in a render.
 
-const [url] = await context.entrypoint<ClientEntrypoint<string>>(HOME).call({ full: true }) ?? []
-// Returns e.g. "https://app.example.com/"
+```ts
+const reports = lazyHandler(() => import('./reports.js'), 'Reports', { fallback: <Spinner /> })
+context.registerEntrypoint(bindScreen(projectProtocols.reports, reports))
 ```
 
-This is the preferred pattern for redirect URIs and navigation targets instead of manual `window.location` concatenation.
+`context.entrypoint(protocol)` derives `ClientProtocolEntrypoint<Protocol>` from the protocol. Do
+not add an explicit result generic. `entrypointRef<Request, Response>(alias)` is reserved for a
+dynamic remote declaration that cannot be imported.
 
-## Depends On
+Client calls include only contract request sections plus `CallOptions` (`auth`, host/port/base,
+timeout, signal). `url` accepts params/query plus the same address options. The route transport is
+chosen by the declaration; callers do not branch for HTTP, socket, or queue.
 
-- `@owlmeans/entrypoint`, `@owlmeans/client-route`, `@owlmeans/client-context`
+`ensureEntrypointFailureService(context)` returns the context-local failure plugin host. Register
+an `onFailure` plugin there to observe a rejected remote `invoke`/`call`, show a toast, or collect
+diagnostics. Plugins run after the transport fails and the original error is still rethrown to
+the caller. This is the opt-in seam for application-wide failure UI; keep the transport independent
+of the chosen toast library.

package/build/entrypoint.d.ts

@@ -1,6 +1,5 @@
-import type { ClientRouteModel } from '@owlmeans/client-route';
 import type { ClientEntrypoint, ClientEntrypointOptions, RefedEntrypointHandler } from './types.js';
 import type { AbstractRequest, CommonEntrypoint } from '@owlmeans/entrypoint';
-import type { CommonRouteModel } from '@owlmeans/route';
-export declare const entrypoint: <T, R extends AbstractRequest = AbstractRequest>(arg: CommonEntrypoint | ClientRouteModel | CommonRouteModel, handler?: RefedEntrypointHandler<T, R> | ClientEntrypointOptions | boolean, opts?: ClientEntrypointOptions | boolean) => ClientEntrypoint<T, R>;
+/** Attach client behaviour to an entrypoint already materialized from a protocol. */
+export declare const bindMaterializedEntrypoint: <T, R extends AbstractRequest = AbstractRequest>(arg: CommonEntrypoint, handler?: RefedEntrypointHandler<T, R>, opts?: ClientEntrypointOptions) => ClientEntrypoint<T, 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,uBAAuB,EAAiB,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAClH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAO7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAGvD,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,OAClE,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,YACjD,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,uBAAuB,GAAG,OAAO,SACnE,uBAAuB,GAAG,OAAO,KACvC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CA+DvB,CAAA"}
+{"version":3,"file":"entrypoint.d.ts","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAiB,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAClH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAO7E,qFAAqF;AACrF,eAAO,MAAM,0BAA0B,GAAI,CAAC,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,OAClF,gBAAgB,YACX,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,SAC/B,uBAAuB,KAC7B,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAqDvB,CAAA"}

package/build/entrypoint.js

@@ -1,44 +1,36 @@
-import { isEntrypoint, makeBasicEntrypoint, normalizeHelperParams, validate } from './utils/entrypoint.js';
-import { isClientRouteModel, route } from '@owlmeans/client-route';
-import { apiCall, apiHandler, urlCall } from './utils/handler.js';
+import { validate } from './utils/entrypoint.js';
+import { route } from '@owlmeans/client-route';
+import { apiInvoke, apiHandler, entrypointUrl } from './utils/handler.js';
 import { AppType } from '@owlmeans/context';
-import { normalizePath } from '@owlmeans/route';
 import { provideRequest } from './helper.js';
-export const entrypoint = (arg, handler, opts) => {
+/** Attach client behaviour to an entrypoint already materialized from a protocol. */
+export const bindMaterializedEntrypoint = (arg, handler, opts) => {
     const entrypointHandle = { ref: undefined };
     let _entrypoint;
-    [handler, opts] = normalizeHelperParams(handler, opts);
-    const _handler = handler ??
-        (('route' in arg.route ? arg.route.route.type : arg.route.type)
-            === AppType.Backend ? apiHandler : undefined);
-    if (isEntrypoint(arg)) {
-        assertExplicitHandler(arg.route.route.type, handler);
-        const routeModel = route(arg.route, opts?.routeOptions);
-        _entrypoint = arg;
-        _entrypoint.route = routeModel;
-        _entrypoint.guards = opts?.guards ?? arg.guards;
-        _entrypoint.filter = opts?.filter ?? arg.filter;
-        _entrypoint.gate = opts?.gate ?? arg.gate;
-        _entrypoint.gateParams = opts?.gateParams ?? arg.gateParams;
-    }
-    else if (isClientRouteModel(arg)) {
-        assertExplicitHandler(arg.route.type, handler);
-        _entrypoint = makeBasicEntrypoint(arg, { ...opts });
-        _entrypoint.route = arg;
-    }
-    else {
-        assertExplicitHandler(arg.route.type, handler);
-        const _route = route(arg, opts?.routeOptions);
-        _entrypoint = makeBasicEntrypoint(_route, { ...opts });
-        _entrypoint.route = _route;
-    }
-    _entrypoint.getPath = (partial) => partial === true ? normalizePath(_entrypoint.route.route.partialPath) : _entrypoint.route.route.path;
-    _entrypoint.call = handler != null ? urlCall(entrypointHandle, opts) : apiCall(entrypointHandle, opts);
+    const _handler = handler ?? (arg.route.route.type === AppType.Backend ? apiHandler : undefined);
+    assertExplicitHandler(arg.route.route.type, handler);
+    const routeModel = route(arg.route, opts?.routeOptions);
+    _entrypoint = arg;
+    _entrypoint.route = routeModel;
+    // Binding adds guards, it never swaps them: what the declaration carries still applies.
+    _entrypoint.guards = [...new Set([...(arg.guards ?? []), ...(opts?.guards ?? [])])];
+    _entrypoint.filter = opts?.filter ?? arg.filter;
+    _entrypoint.gate = opts?.gate ?? arg.gate;
+    _entrypoint.gateParams = opts?.gateParams ?? arg.gateParams;
+    _entrypoint.url = ((req, urlOpts) => entrypointUrl(entrypointHandle, req, urlOpts));
+    // An entrypoint carrying a renderer IS a screen: it is addressed by URL, never called over the
+    // wire. Saying so here turns what used to be a URL-shaped answer from `call()` into a report.
+    _entrypoint.invoke = (handler != null
+        ? (async () => {
+            throw new SyntaxError(`Entrypoint ${_entrypoint.alias} renders a screen - address it with url() instead of call()/invoke()`);
+        })
+        : apiInvoke(entrypointHandle, opts));
+    _entrypoint.call = (async (req) => (await _entrypoint.invoke(req)).value);
     _entrypoint.request = ((request) => {
         if (entrypointHandle.ref == null) {
             throw SyntaxError(`Try to request uninitialized entrypoint ${JSON.stringify(arg)}`);
         }
-        const _request = provideRequest(entrypointHandle.ref.getAlias(), entrypointHandle.ref.getPath());
+        const _request = provideRequest(entrypointHandle.ref.alias, entrypointHandle.ref.path());
         request != null && Object.entries(request).forEach(([key, value]) => {
             _request[key] = value;
         });
@@ -46,11 +38,6 @@ export const entrypoint = (arg, handler, opts) => {
     });
     _entrypoint.handle = _handler?.(entrypointHandle);
     _entrypoint.validate = validate(entrypointHandle);
-    _entrypoint.reinitializeContext = (context) => {
-        const newEntrypoint = entrypoint(_entrypoint.route, handler, opts);
-        newEntrypoint.ctx = context;
-        return newEntrypoint;
-    };
     entrypointHandle.ref = _entrypoint;
     return _entrypoint;
 };

package/build/entrypoint.js.map

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

package/build/failure.d.ts

@@ -0,0 +1,19 @@
+import type { BasicContext, LazyService } from '@owlmeans/context';
+import type { AbstractRequest } from '@owlmeans/entrypoint';
+export declare const ENTRYPOINT_FAILURE_SERVICE = "client-entrypoint:failure";
+export interface EntrypointFailure {
+    alias: string;
+    request: AbstractRequest;
+    error: unknown;
+}
+export interface EntrypointFailurePlugin {
+    alias: string;
+    onFailure: (failure: EntrypointFailure) => void | Promise<void>;
+}
+export interface EntrypointFailureService extends LazyService {
+    registerPlugin: (plugin: EntrypointFailurePlugin) => void;
+    notify: (failure: EntrypointFailure) => Promise<void>;
+}
+/** Context-local observers for rejected client calls; observers never replace the thrown error. */
+export declare const ensureEntrypointFailureService: (ctx: BasicContext<any>) => EntrypointFailureService;
+//# sourceMappingURL=failure.d.ts.map

package/build/failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.d.ts","sourceRoot":"","sources":["../src/failure.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D,eAAO,MAAM,0BAA0B,8BAA8B,CAAA;AAErE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,eAAe,CAAA;IACxB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE;AAED,MAAM,WAAW,wBAAyB,SAAQ,WAAW;IAC3D,cAAc,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAA;IACzD,MAAM,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACtD;AAED,mGAAmG;AACnG,eAAO,MAAM,8BAA8B,QAAS,YAAY,CAAC,GAAG,CAAC,KAAG,wBAiBvE,CAAA"}

package/build/failure.js

@@ -0,0 +1,25 @@
+import { createLazyService } from '@owlmeans/context';
+export const ENTRYPOINT_FAILURE_SERVICE = 'client-entrypoint:failure';
+/** Context-local observers for rejected client calls; observers never replace the thrown error. */
+export const ensureEntrypointFailureService = (ctx) => {
+    if (ctx.hasService(ENTRYPOINT_FAILURE_SERVICE)) {
+        return ctx.service(ENTRYPOINT_FAILURE_SERVICE);
+    }
+    const plugins = new Map();
+    const service = createLazyService(ENTRYPOINT_FAILURE_SERVICE, {
+        registerPlugin: plugin => { plugins.set(plugin.alias, plugin); },
+        notify: async (failure) => {
+            for (const plugin of plugins.values()) {
+                try {
+                    await plugin.onFailure(failure);
+                }
+                catch (cause) {
+                    console.warn('Entrypoint failure observer failed', cause);
+                }
+            }
+        },
+    });
+    ctx.registerService(service);
+    return service;
+};
+//# sourceMappingURL=failure.js.map

package/build/failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.js","sourceRoot":"","sources":["../src/failure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAIrD,MAAM,CAAC,MAAM,0BAA0B,GAAG,2BAA2B,CAAA;AAkBrE,mGAAmG;AACnG,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,GAAsB,EAA4B,EAAE;IACjG,IAAI,GAAG,CAAC,UAAU,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAC/C,OAAO,GAAG,CAAC,OAAO,CAA2B,0BAA0B,CAAC,CAAA;IAC1E,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmC,CAAA;IAC1D,MAAM,OAAO,GAAG,iBAAiB,CAA2B,0BAA0B,EAAE;QACtF,cAAc,EAAE,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA,CAAC,CAAC;QAC/D,MAAM,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE;YACtB,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACtC,IAAI,CAAC;oBAAC,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;gBAAC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACrD,OAAO,CAAC,IAAI,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAA;gBAC3D,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC,CAAA;IACF,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IAC5B,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/build/helper.d.ts

@@ -1,7 +1,6 @@
-import type { ClientEntrypoint, ClientEntrypointOptions, RefedEntrypointHandler } from './types.js';
-import type { AbstractRequest, CommonEntrypoint } from '@owlmeans/entrypoint';
+import type { RefedEntrypointHandler } from './types.js';
+import type { AbstractRequest } from '@owlmeans/entrypoint';
 import type { JSONSchemaType } from "ajv";
-export declare const elevate: <T = {}, R extends AbstractRequest = AbstractRequest>(entrypoints: (CommonEntrypoint | ClientEntrypoint<T, R>)[], alias: string, handler?: RefedEntrypointHandler<T, R> | ClientEntrypointOptions | boolean, opts?: ClientEntrypointOptions | boolean) => ClientEntrypoint<T, R>[];
 export declare const stab: RefedEntrypointHandler<{}>;
 export declare const provideRequest: <T extends {} = {}>(alias: string, path: string) => AbstractRequest<T>;
 export declare const pickPerSchema: <T, R>(object: T, schema: JSONSchemaType<R>) => Partial<R>;

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,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAGnG,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,eAAO,MAAM,OAAO,GAAI,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,eAC5D,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SACnD,MAAM,YACH,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,uBAAuB,GAAG,OAAO,SACnE,uBAAuB,GAAG,OAAO,KACvC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAcxB,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,sBAAsB,CAAC,EAAE,CAE3C,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,EAAE,GAAG,EAAE,SAAS,MAAM,QAAQ,MAAM,KAAG,eAAe,CAAC,CAAC,CAYhG,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,cAAc,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAQjF,CAAA"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,eAAO,MAAM,IAAI,EAAE,sBAAsB,CAAC,EAAE,CAE3C,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,EAAE,GAAG,EAAE,SAAS,MAAM,QAAQ,MAAM,KAAG,eAAe,CAAC,CAAC,CAYhG,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,cAAc,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAQjF,CAAA"}

package/build/helper.js

@@ -1,18 +1,3 @@
-import { entrypoint } from './entrypoint.js';
-import { isClientRouteModel } from '@owlmeans/client-route';
-import { normalizeHelperParams } from './utils/entrypoint.js';
-export const elevate = (entrypoints, alias, handler, opts) => {
-    [handler, opts] = normalizeHelperParams(handler, opts);
-    const idx = entrypoints.findIndex(({ route }) => route.route.alias === alias);
-    if (idx === -1) {
-        throw new SyntaxError(`Entrypoint with alias ${alias} not present`);
-    }
-    if (isClientRouteModel(entrypoints[idx].route) && opts?.force !== true) {
-        throw new SyntaxError(`Entrypoint with alias ${alias} is already elevated`);
-    }
-    entrypoints[idx] = entrypoint(entrypoints[idx], handler, opts);
-    return entrypoints;
-};
 export const stab = () => () => {
     return void 0;
 };

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,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,WAA0D,EAC1D,KAAa,EACb,OAA0E,EAC1E,IAAwC,EACd,EAAE;IAC5B,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAEtD,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,kBAAkB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,KAAK,KAAK,IAAI,EAAE,CAAC;QACvE,MAAM,IAAI,WAAW,CAAC,yBAAyB,KAAK,sBAAsB,CAAC,CAAA;IAC7E,CAAC;IAED,WAAW,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAA;IAE9D,OAAO,WAAuC,CAAA;AAChD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAA+B,GAAG,EAAE,CAAC,GAAG,EAAE;IACzD,OAAO,KAAK,CAAQ,CAAA;AACtB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAoB,KAAa,EAAE,IAAY,EAAsB,EAAE;IACnG,MAAM,OAAO,GAAG;QACd,KAAK;QACL,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,IAAI;QACJ,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI;KACtC,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAO,MAAS,EAAE,MAAyB,EAAc,EAAE,CACtF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CACnC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACX,IAAI,MAAM,CAAC,GAAc,CAAC,IAAI,IAAI,EAAE,CAAC;QACnC,GAAG,CAAC,GAAc,CAAC,GAAG,MAAM,CAAC,GAAc,CAA0B,CAAA;IACvE,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,EAAE,EAAgB,CACpB,CAAA"}
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,IAAI,GAA+B,GAAG,EAAE,CAAC,GAAG,EAAE;IACzD,OAAO,KAAK,CAAQ,CAAA;AACtB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAoB,KAAa,EAAE,IAAY,EAAsB,EAAE;IACnG,MAAM,OAAO,GAAG;QACd,KAAK;QACL,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,IAAI;QACJ,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI;KACtC,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAO,MAAS,EAAE,MAAyB,EAAc,EAAE,CACtF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CACnC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACX,IAAI,MAAM,CAAC,GAAc,CAAC,IAAI,IAAI,EAAE,CAAC;QACnC,GAAG,CAAC,GAAc,CAAC,GAAG,MAAM,CAAC,GAAc,CAA0B,CAAA;IACvE,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,EAAE,EAAgB,CACpB,CAAA"}

package/build/index.d.ts

@@ -1,5 +1,6 @@
-export * from './helper.js';
 export type * from './types.js';
-export * from './entrypoint.js';
 export * from './errors.js';
+export * from './failure.js';
+export * from './protocol.js';
+export { pickPerSchema, provideRequest, stab } from './helper.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;AAC/B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA"}

package/build/index.js

@@ -1,4 +1,5 @@
-export * from './helper.js';
-export * from './entrypoint.js';
 export * from './errors.js';
+export * from './failure.js';
+export * from './protocol.js';
+export { pickPerSchema, provideRequest, stab } from './helper.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;AAC/B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA"}

package/build/protocol.d.ts

@@ -0,0 +1,9 @@
+import type { EntrypointProtocolDeclaration, EntrypointTree } from '@owlmeans/entrypoint';
+import type { ClientEntrypointOptions, ClientProtocolEntrypoint, RefedEntrypointHandler } from './types.js';
+/** Bind a shared protocol to the client context without changing the declaration itself. */
+export declare const bind: <Protocol extends EntrypointProtocolDeclaration>(protocol: Protocol, options?: ClientEntrypointOptions) => ClientProtocolEntrypoint<Protocol>;
+/** Materialize every protocol in an exported declaration tree for a browser context. */
+export declare const bindAll: (tree: EntrypointTree) => ClientProtocolEntrypoint<EntrypointProtocolDeclaration>[];
+/** Bind a frontend protocol to the component that renders it. */
+export declare const bindScreen: <Protocol extends EntrypointProtocolDeclaration>(protocol: Protocol, handler: RefedEntrypointHandler, options?: ClientEntrypointOptions) => ClientProtocolEntrypoint<Protocol>;
+//# sourceMappingURL=protocol.d.ts.map