@owlmeans/route 0.1.18-rc.10 → 0.1.18-rc.12

package/README.md

@@ -4,7 +4,7 @@ Route model factory and type definitions for OwlMeans entrypoints.
 
 ## Overview
 
-- `route()` creates a `RouteModel` used as the first argument to `entrypoint()`
+- `route()` creates a `RouteModel` used as the first argument to `protocol()` or `openProtocol()`
 - `frontend()` / `backend()` / `socket()` helpers set the route's `AppType` and parent
 - `RouteMethod` enum covers HTTP verbs; `RouteProtocols` covers `http`/`ws`
 - This package is a dependency of `@owlmeans/entrypoint` — you rarely use it directly unless defining entrypoint-level routes
@@ -22,25 +22,27 @@ bun add @owlmeans/route@^0.1.18-rc.8
 
 ## Usage
 
-Define routes for entrypoints (typically via `@owlmeans/server-app` re-exports):
+Define routes for protocols:
 
 ```typescript
 import { route, frontend, backend, socket, RouteMethod } from '@owlmeans/route'
-import { entrypoint } from '@owlmeans/entrypoint'
+import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint'
 
 // Backend REST route
-const createEntrypoint = entrypoint(
-  route('story-create', '/stories', backend('api', RouteMethod.POST))
+const createProtocol = protocol(
+  route('story-create', '/stories', backend('api', RouteMethod.POST)),
+  contract(typed<CreateStory>()),
 )
 
 // Frontend client route nested under parent
-const storyEntrypoint = entrypoint(
+const storyProtocol = openProtocol(
   route('story-view', '/stories/:id', frontend('app'))
 )
 
 // WebSocket route
-const wsEntrypoint = entrypoint(
-  route('story-ws', '/stories/stream', socket('api'))
+const wsProtocol = protocol(
+  route('story-ws', '/stories/stream', socket('api')),
+  contract(typed<StoryEvent>()),
 )
 ```
 
@@ -95,7 +97,7 @@ The pure functions the entrypoint accessors are built on. Each takes a context a
 
 ## Related Packages
 
-- [`@owlmeans/entrypoint`](../entrypoint) — `entrypoint()` takes a `RouteModel` as first argument
+- [`@owlmeans/entrypoint`](../entrypoint) — `protocol()` and `openProtocol()` consume a `RouteModel`
 - [`@owlmeans/server-app`](../server-app) — re-exports `route` as `broute` (backend) alongside `route`
 
 <!-- owlmeans:agent-guidance:start -->
@@ -106,7 +108,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.13
+npx @owlmeans/agent-skills@^0.1.18-rc.15
 ```
 
 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/route",
-  "version": "0.1.18-rc.10",
-  "generatedAt": "2026-09-10T18:54:42.502Z",
+  "version": "0.1.18-rc.12",
+  "generatedAt": "2026-09-12T08:39:52.732Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/route/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/route
 
 **Layer:** Core
-**Install:** `"@owlmeans/route": "^0.1.18-rc.10"` in `dependencies`
+**Install:** `"@owlmeans/route": "^0.1.18-rc.12"` in `dependencies`
 
 ## Key Exports
 
@@ -81,18 +81,19 @@ Application code rarely calls these directly — `@owlmeans/entrypoint` exposes
 
 ```typescript
 import { route, frontend, RouteMethod } from '@owlmeans/route'
-import { entrypoint } from '@owlmeans/entrypoint'
+import { contract, openProtocol, protocol, typed } from '@owlmeans/entrypoint'
 
 // Server route
-entrypoint(
+protocol(
   route(manager.back.project.create, '/create', {
     parent: manager.back.project.base,
     method: RouteMethod.POST,
-  })
+  }),
+  contract(typed<Project>()),
 )
 
 // Web route — frontend() marks it as a React page
-entrypoint(
+openProtocol(
   route(HOME, '/', frontend({ default: true, parent: BASE }))
 )
 ```

package/build/helper.d.ts

@@ -11,7 +11,7 @@ export declare const socket: (opts?: RouteOptions | string | null, secondary?: R
 /**
  * A backend route carried by the queue rather than by HTTP. Everything else about it is a normal
  * backend route — it has a path, a parent, guards and a filter — so the same declaration is served
- * with `elevate(...)` and called with `call()`; only the transport underneath differs.
+ * with `bind(...)` and called with `call()`; only the transport underneath differs.
  */
 export declare const job: (opts?: RouteOptions | string | null, secondary?: RouteOptions) => Partial<RouteOptions>;
 export declare const frontend: (opts?: RouteOptions | string | null, def?: RouteOptions | boolean) => Partial<RouteOptions>;

package/build/helper.js

@@ -31,7 +31,7 @@ export const socket = (opts, secondary) => {
 /**
  * A backend route carried by the queue rather than by HTTP. Everything else about it is a normal
  * backend route — it has a path, a parent, guards and a filter — so the same declaration is served
- * with `elevate(...)` and called with `call()`; only the transport underneath differs.
+ * with `bind(...)` and called with `call()`; only the transport underneath differs.
  */
 export const job = (opts, secondary) => {
     const route = backend(opts, secondary);

package/package.json

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

package/src/helper.ts

@@ -46,7 +46,7 @@ export const socket = (opts?: RouteOptions | string | null, secondary?: RouteOpt
 /**
  * A backend route carried by the queue rather than by HTTP. Everything else about it is a normal
  * backend route — it has a path, a parent, guards and a filter — so the same declaration is served
- * with `elevate(...)` and called with `call()`; only the transport underneath differs.
+ * with `bind(...)` and called with `call()`; only the transport underneath differs.
  */
 export const job = (opts?: RouteOptions | string | null, secondary?: RouteOptions): Partial<RouteOptions> => {
   const route = backend(opts, secondary)