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

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.12
 ```
 
 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.11",
+  "generatedAt": "2026-09-04T22:43:25.444Z",
   "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 — server-side entrypoints extending @owlmeans/entrypoint with handler attachment, 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,68 @@ 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.11"` 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)`) |
+| `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.
+Most app code uses `elevate()` from `@owlmeans/server-app` (which re-exports this one). 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 +83,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 +100,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.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;AAG7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,eACV,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,SAChD,MAAM,YACH,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,SAC7D,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,KACpC,gBAAgB,CAAC,CAAC,CAAC,EAmBrB,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,SAAS,iBAAiB,CAAC,CAAC,CAAC,KAAG,iBAAiB,CAAC,CAAC,CACjD,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/server-entrypoint",
-  "version": "0.1.18-rc.10",
+  "version": "0.1.18-rc.11",
   "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.8",
+    "@owlmeans/entrypoint": "^0.1.18-rc.11",
+    "@owlmeans/route": "^0.1.18-rc.9",
+    "@owlmeans/server-route": "^0.1.18-rc.9"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",