@telorun/http-server 0.16.1 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @telorun/http-server
 
+## 0.17.0
+
+### Minor Changes
+
+- 942c176: Rename `ctx.resolveChildren` to `ctx.ensureKindRef`. The old name stays as a
+  deprecated delegate.
+
+  The method never resolved anything: it takes a nested slot value — an inline
+  `{ kind, …config }` definition, a `{ kind, name }` ref, or a `!ref` sentinel —
+  and produces a `KindRef`, registering the inline case as a manifest (under a
+  supplied or generated name) on the way. `ensure` carries that create-if-needed
+  side effect; `KindRef` is what comes back.
+
+  It also reads correctly next to `ctx.resolveRef`, which runs the other direction
+  — ref to live instance. Two `resolve*` methods on one interface returning
+  opposite categories was the ambiguity; this fixes it at the source rather than
+  lengthening the name of the method that was right.
+
+### Patch Changes
+
+- @telorun/http-dispatch@0.4.1
+
 ## 0.16.1
 
 ### Patch Changes

package/dist/http-api-controller.js

@@ -204,7 +204,7 @@ export async function create(resource, ctx) {
         if (!h)
             continue;
         if (typeof h === "object") {
-            handlerRefs.set(route, ctx.resolveChildren(h));
+            handlerRefs.set(route, ctx.ensureKindRef(h));
         }
         else if (typeof h === "string") {
             // String form (schema oneOf: string | object) — only the resource name

package/dist/http-server-controller.js

@@ -285,7 +285,7 @@ export async function create(resource, ctx) {
         let kind = "";
         let name = "";
         if (typeof invoke === "object" && invoke !== null) {
-            const resolved = ctx.resolveChildren(invoke);
+            const resolved = ctx.ensureKindRef(invoke);
             kind = resolved.kind;
             name = resolved.name;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/http-server",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Telo HTTP Server module - HTTP server and API resource kinds for Telo manifests.",
   "keywords": [
     "telo",
@@ -55,7 +55,7 @@
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0",
     "vitest": "^2.1.8",
-    "@telorun/sdk": "0.50.0"
+    "@telorun/sdk": "0.54.0"
   },
   "peerDependencies": {
     "@telorun/sdk": "*"

package/src/http-api-controller.ts

@@ -266,7 +266,7 @@ export async function create(resource: any, ctx: ResourceContext): Promise<HttpS
     const h = route.handler;
     if (!h) continue;
     if (typeof h === "object") {
-      handlerRefs.set(route, ctx.resolveChildren(h));
+      handlerRefs.set(route, ctx.ensureKindRef(h));
     } else if (typeof h === "string") {
       // String form (schema oneOf: string | object) — only the resource name
       // is given, not the kind. Phase 5 injects the live instance either way;

package/src/http-server-controller.ts

@@ -399,7 +399,7 @@ export async function create(
     let kind = "";
     let name = "";
     if (typeof invoke === "object" && invoke !== null) {
-      const resolved = ctx.resolveChildren(invoke);
+      const resolved = ctx.ensureKindRef(invoke);
       kind = resolved.kind;
       name = resolved.name;
     } else if (typeof invoke === "string") {

package/tests/fastify-telo-logger.test.ts

@@ -81,7 +81,7 @@ describe("Http.Server boots with request logging enabled", () => {
     return {
       log,
       args: { _: [] },
-      resolveChildren: () => ({ kind: "Http.Api", name: "x" }),
+      ensureKindRef: () => ({ kind: "Http.Api", name: "x" }),
       moduleContext: { expandWith: (value: unknown) => value },
       validateSchema: () => {},
     } as never;

package/tests/request-cancel.test.ts

@@ -42,7 +42,7 @@ describe("http-server request cancellation", () => {
     // Minimal ResourceContext: just the surface the controller touches.
     const ctx = {
       validateSchema: () => {},
-      resolveChildren: () => ({ kind: "Test.Handler", name: "SlowWork" }),
+      ensureKindRef: () => ({ kind: "Test.Handler", name: "SlowWork" }),
       moduleContext: { expandWith: (value: unknown) => value },
       createCancellationSource: () => createCancellationSource(),
       invokeResolved: (_kind: string, _name: string, h: typeof handler, input: unknown, c: unknown) =>

package/tests/request-span.test.ts

@@ -28,7 +28,7 @@ describe("http-server request span", () => {
 
     const ctx = {
       validateSchema: () => {},
-      resolveChildren: () => ({ kind: "JS.Script", name: "Echo" }),
+      ensureKindRef: () => ({ kind: "JS.Script", name: "Echo" }),
       moduleContext: { expandWith: (value: unknown) => value },
       createCancellationSource: () => createCancellationSource(),
       invokeResolved: (_kind: string, _name: string, h: typeof handler, input: unknown) =>