@telorun/http-server 0.14.0 → 0.14.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @telorun/http-server
 
+## 0.14.1
+
+### Patch Changes
+
+- dded615: Templated definitions can now produce a mountable HTTP surface, and their dispatch targets are created once instead of per call.
+
+  - **`mount:` template dispatch** — a `Telo.Definition` with `capability: Telo.Mount` may declare `mount: <child>` (sibling to `invoke:` / `run:` / `provide:`) naming a `resources:` entry that is itself a `Telo.Mount` (e.g. an `Http.Api`). The template instance's `register()` delegates to that persistent child, so a library can ship a self-contained, declarative HTTP resource. The analyzer validates the new field (`MOUNT_ON_NON_MOUNT`, `MOUNT_DISPATCHER_CONFLICT`, `MOUNT_TARGET_UNKNOWN`, `MOUNT_TARGET_NOT_MOUNTABLE`).
+  - **Persistent dispatch targets** — the template controller no longer re-creates its `invoke:` / `run:` / `provide:` target on every call (`withEphemeral` is removed). Every `resources:` entry is created once at `init()` and reused; per-call data flows exclusively through the top-level `inputs:` sibling. A resource body may reference only `self`; `${{ inputs.* }}` inside a target body is no longer supported (move it to the top-level `inputs:`).
+  - **Library-scoped child resolution** — a template's `resources:` are spawned in a child context rooted on the _defining_ library's module context (new `EvaluationContext.spawnChildContext()`), so their internal kind aliases and `!ref`s resolve against the library's own imports rather than the consumer's.
+  - **http-server** — a route declared at `/` now sits at the mount root (`/todos` + `/` → `/todos`) instead of a trailing-slash variant Fastify treats as a distinct, unmatched URL, so collection-style mounts respond at the mount path itself.
+  - @telorun/http-dispatch@0.4.1
+
 ## 0.14.0
 
 ### Minor Changes

package/dist/http-api-controller.js

@@ -55,7 +55,7 @@ export class HttpServerApi {
         const handlerRef = this.handlerRefs.get(route);
         const handlerKind = handlerRef?.kind ?? "";
         const handlerName = handlerRef?.name ?? "";
-        const translatedPath = prefix + translateOpenApiPath(route.request.path);
+        const translatedPath = joinMountPath(prefix, translateOpenApiPath(route.request.path));
         const schema = { response: {} };
         // A stream-marked body is delivered as a raw `Stream<Uint8Array>` (see the
         // server's `contentTypeParsers[].stream`); it is opaque to AJV, so skip
@@ -205,6 +205,15 @@ function normalizeMountPrefix(prefix) {
         return "";
     return prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
 }
+/** Join a normalized mount prefix with a translated route path. A collection
+ *  route declared at `/` sits at the mount root itself (`/todos` + `/` → `/todos`),
+ *  not a trailing-slash variant Fastify would treat as a distinct, unmatched URL.
+ *  An empty prefix (root mount) keeps `/`. */
+function joinMountPath(prefix, path) {
+    if (path === "/")
+        return prefix || "/";
+    return prefix + path;
+}
 /**
  * Wraps an incoming request's raw body as a `Stream<Uint8Array>`. Requires a
  * stream content-type parser (`contentTypeParsers[].stream`) for the request's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/http-server",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "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.34.0"
+    "@telorun/sdk": "0.36.0"
   },
   "peerDependencies": {
     "@telorun/sdk": "*"

package/src/http-api-controller.ts

@@ -87,7 +87,7 @@ export class HttpServerApi implements ResourceInstance {
     const handlerRef = this.handlerRefs.get(route as unknown as object);
     const handlerKind = handlerRef?.kind ?? "";
     const handlerName = handlerRef?.name ?? "";
-    const translatedPath = prefix + translateOpenApiPath(route.request.path);
+    const translatedPath = joinMountPath(prefix, translateOpenApiPath(route.request.path));
 
     const schema: any = { response: {} };
 
@@ -269,6 +269,15 @@ function normalizeMountPrefix(prefix: string): string {
   return prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
 }
 
+/** Join a normalized mount prefix with a translated route path. A collection
+ *  route declared at `/` sits at the mount root itself (`/todos` + `/` → `/todos`),
+ *  not a trailing-slash variant Fastify would treat as a distinct, unmatched URL.
+ *  An empty prefix (root mount) keeps `/`. */
+function joinMountPath(prefix: string, path: string): string {
+  if (path === "/") return prefix || "/";
+  return prefix + path;
+}
+
 /**
  * Wraps an incoming request's raw body as a `Stream<Uint8Array>`. Requires a
  * stream content-type parser (`contentTypeParsers[].stream`) for the request's