@ontrails/http 1.0.0-beta.12

package/.turbo/turbo-build.log

@@ -0,0 +1 @@
+$ tsc -b

package/.turbo/turbo-lint.log

@@ -0,0 +1,3 @@
+$ oxlint ./src
+Found 0 warnings and 0 errors.
+Finished in 39ms on 6 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

@@ -0,0 +1 @@
+$ tsc --noEmit

package/CHANGELOG.md

@@ -0,0 +1,114 @@
+# @ontrails/http
+
+## 1.0.0-beta.12
+
+### Patch Changes
+
+- Complete trifecta for config, permits, and crumbs (formerly tracks)
+
+  - **config**: Add `configService`, `config.layer`, `config.trail`, and `config.workspace` trails with full `defineConfig`, `resolve`, `describe`, `explain`, `doctor`, and code generation support
+  - **permits**: Add `authService` and `auth.verify` trail for runtime authorization checks
+  - **crumbs**: Rename tracks to crumbs; add `crumbsService` and `crumbs.status` trail for structured event tracking
+  - **cli**: Fix build flag handling and improve bootstrap scaffolding
+  - **testing**: Expand test context helpers and example-based testing utilities
+  - **core/mcp/http**: Internal alignment for service and composition updates
+
+- Updated dependencies
+  - @ontrails/core@1.0.0-beta.12
+
+## 1.0.0-beta.11
+
+### Patch Changes
+
+- Add services as a first-class primitive.
+
+  Services make infrastructure dependencies declarative, injectable, and governable. Define a service with `service()`, declare it on a trail with `services: [db]`, and access it with `db.from(ctx)` or `ctx.service()`.
+
+  **Core:** `service()` factory, `ServiceSpec<T>`, `ServiceContext`, singleton resolution in `executeTrail`, in-flight creation dedup, `isService` guard, `findDuplicateServiceId`, topo service discovery and validation, `services` field on trail specs.
+
+  **Testing:** Auto-resolution of `mock` factories in `testAll`, `testExamples`, `testContracts`, and `testFollows`. Explicit `services` overrides with correct precedence (`explicit > ctx.extensions > auto-mock`). Service mock propagation through follow graphs.
+
+  **Warden:** `service-declarations` rule validates `db.from(ctx)` and `ctx.service()` usage matches declared `services: [...]`. `service-exists` rule validates declared service IDs resolve in project context. Scope-aware AST walking skips nested function boundaries.
+
+  **Surfaces:** Service overrides thread through `dispatch` and `blaze` on CLI, MCP, and HTTP.
+
+  **Introspection:** Survey and surface map outputs include service graph. Topo exposes `.services`, `.getService()`, `.hasService()`, `.listServices()`, `.serviceIds()`, `.serviceCount`.
+
+  **Docs:** ADR-009 accepted. Unified services guide, updated vocabulary, getting-started, architecture, and package READMEs.
+
+- Updated dependencies
+  - @ontrails/core@1.0.0-beta.11
+
+## 1.0.0-beta.10
+
+### Patch Changes
+
+- Cleanup and hardening pass across all packages.
+
+  **core**: Deduplicate `DispatchOptions` as type alias of `ExecuteTrailOptions`. Replace `TrailContext` index signature with typed `extensions` field for type safety. Deep-merge `extensions` in `executeTrail` context resolution. Remove unused `Surface` type, `adapters.ts`, `health.ts`, and `job.ts` proof-of-concept from published package.
+
+  **cli**: Remove vestigial `kind` checks from build. Run `validateTopo()` automatically in `blaze()` with opt-out via `validate: false`.
+
+  **http**: Remove vestigial `kind` checks from build. Run `validateTopo()` automatically in `blaze()` with opt-out.
+
+  **mcp**: Remove vestigial `kind` checks from build. Run `validateTopo()` automatically in `blaze()` with opt-out.
+
+  **warden**: Project-aware rule context preserved in trail wrappers.
+
+- Updated dependencies
+  - @ontrails/core@1.0.0-beta.10
+
+## 1.0.0-beta.9
+
+### Minor Changes
+
+- Consolidated improvements across all surface packages.
+
+  **core**: Add `TrailResult<T>` utility type, `topo.ids()` and `topo.count` accessors, `dispatch()` for headless trail execution, and extract shared `executeTrail` pipeline used by CLI/MCP/HTTP.
+
+  **http**: Detect route path collisions and return `Result` from `buildHttpRoutes()`, wire request `AbortSignal` through to trail context, and make write → POST mapping explicit in intent-to-method lookup.
+
+  **mcp**: Return `Result` from `buildMcpTools()` on collision instead of throwing.
+
+  **cli**: Verify exception catching via centralized `executeTrail`.
+
+  **testing**: Follow context awareness improvements.
+
+  **warden**: Refactor rules as composable trails with examples.
+
+  **schema**: Error code and empty body fixes.
+
+### Patch Changes
+
+- Updated dependencies
+  - @ontrails/core@1.0.0-beta.9
+
+## 1.0.0-beta.8
+
+### Major Changes
+
+- Restructure HTTP package and fix Codex review findings.
+
+  **http**: BREAKING — `blaze()` moved to `@ontrails/http/hono` subpath. Hono is now a peer dependency. `buildHttpRoutes()` is framework-agnostic. Fixed: malformed JSON → 400, execute() never throws, query parsing preserves raw strings and supports arrays.
+
+  **schema**: OpenAPI 200 response wraps in `{ data }` envelope matching wire format. Always includes 400 ValidationError with error schema. basePath trailing slash normalized.
+
+### Patch Changes
+
+- @ontrails/core@1.0.0-beta.8
+
+## 1.0.0-beta.7
+
+### Minor Changes
+
+- HTTP surface and OpenAPI generation.
+
+  **http**: New `@ontrails/http` package — Hono-based HTTP adapter. `blaze()` derives routes from trail IDs, maps intent to HTTP verbs (read→GET, write→POST, destroy→DELETE), and maps error taxonomy to status codes. Returns the Hono instance.
+
+  **schema**: Add `generateOpenApiSpec(topo)` — generates a complete OpenAPI 3.1 spec from the topo. Each trail becomes an operation with path, method, schemas, and error responses derived from the contract.
+
+  **trails**: `trails survey --openapi` outputs the OpenAPI spec for any Trails app.
+
+### Patch Changes
+
+- @ontrails/core@1.0.0-beta.7

package/README.md

@@ -0,0 +1,88 @@
+# @ontrails/http
+
+HTTP surface adapter. One `blaze()` call turns a topo into a Hono-based HTTP server with routes, input validation, and error mapping -- all derived from the trail contracts.
+
+## Usage
+
+```typescript
+import { trail, topo, Result } from '@ontrails/core';
+import { blaze } from '@ontrails/http/hono';
+import { z } from 'zod';
+
+const greet = trail('greet', {
+  input: z.object({ name: z.string().describe('Who to greet') }),
+  output: z.object({ message: z.string() }),
+  intent: 'read',
+  run: (input) => Result.ok({ message: `Hello, ${input.name}!` }),
+});
+
+const app = topo('myapp', { greet });
+await blaze(app, { port: 3000 });
+```
+
+This starts a Hono-based HTTP server. The `greet` trail becomes `GET /greet?name=...` because its `intent` is `'read'`.
+
+For more control, build the routes yourself:
+
+```typescript
+import { buildHttpRoutes } from '@ontrails/http';
+
+const result = buildHttpRoutes(app);
+if (result.isErr()) throw result.error; // ValidationError on route collision
+for (const route of result.value) {
+  console.log(`${route.method} ${route.path} → ${route.trailId}`);
+}
+```
+
+`buildHttpRoutes` returns `Result<HttpRouteDefinition[], Error>` rather than a bare array. It returns `Result.err(ValidationError)` if two trails derive the same `(method, path)` pair.
+
+## API
+
+| Export | What it does |
+| --- | --- |
+| `buildHttpRoutes(app, options?)` | Build framework-agnostic route definitions from a topo |
+| `blaze(app, options?)` (`@ontrails/http/hono`) | Start a Hono HTTP server with all trails as routes |
+
+## Route derivation
+
+Trail intent maps directly to HTTP method and input source:
+
+| Trail field | HTTP method | Input source |
+| --- | --- | --- |
+| `intent: 'read'` | `GET` | Query string |
+| `intent: 'write'` | `POST` | JSON body |
+| `intent: 'destroy'` | `DELETE` | JSON body |
+| (none) | `POST` | JSON body |
+
+Trail IDs map to paths: `entity.show` becomes `/entity/show`. Dots become slashes, everything lowercase.
+
+## Collision detection
+
+`buildHttpRoutes` detects when two trails would produce the same `(method, path)` pair and returns `Result.err(ValidationError)` describing both trail IDs. The `blaze()` Hono adapter throws on collision.
+
+## Service resolution
+
+Declared services on each trail are resolved into the context before the implementation runs.
+
+## AbortSignal propagation
+
+The `execute` function on each `HttpRouteDefinition` accepts an optional `AbortSignal`. The Hono adapter extracts `signal` from `c.req.raw` and passes it to `execute`, so client disconnects propagate into trail execution.
+
+## `HttpRouteDefinition`
+
+Each route definition produced by `buildHttpRoutes` includes:
+
+| Field | Type | What it is |
+| --- | --- | --- |
+| `method` | `'GET' \| 'POST' \| 'DELETE'` | HTTP method |
+| `path` | `string` | Derived path (e.g. `/entity/show`) |
+| `trailId` | `string` | The trail ID this route was derived from |
+| `inputSource` | `'query' \| 'body'` | Where to read input |
+| `trail` | `Trail` | The original trail definition |
+| `execute` | `(input, requestId?, signal?) => Promise<Result>` | Validates, layers, and runs the implementation |
+
+## Installation
+
+```bash
+bun add @ontrails/http hono
+```

package/dist/blaze.d.ts

@@ -0,0 +1,25 @@
+/**
+ * blaze() -- the one-liner HTTP server launcher.
+ *
+ * ```ts
+ * const app = topo("myapp", entity);
+ * await blaze(app, { port: 3000 });
+ * ```
+ */
+import type { Layer, Topo, TrailContext } from '@ontrails/core';
+import { Hono } from 'hono';
+export interface BlazeHttpOptions {
+    readonly basePath?: string | undefined;
+    readonly createContext?: (() => TrailContext | Promise<TrailContext>) | undefined;
+    readonly hostname?: string | undefined;
+    readonly layers?: readonly Layer[] | undefined;
+    readonly name?: string | undefined;
+    readonly port?: number | undefined;
+    /** Set false to return the Hono app without starting a server. */
+    readonly serve?: boolean | undefined;
+}
+/**
+ * Build HTTP routes from a topo, create a Hono app, and optionally start serving.
+ */
+export declare const blaze: (app: Topo, options?: BlazeHttpOptions) => Promise<Hono>;
+//# sourceMappingURL=blaze.d.ts.map

package/dist/blaze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blaze.d.ts","sourceRoot":"","sources":["../src/blaze.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAS5B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,aAAa,CAAC,EACnB,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,GAC5C,SAAS,CAAC;IACd,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AA8DD;;GAEG;AAEH,eAAO,MAAM,KAAK,GAChB,KAAK,IAAI,EACT,UAAS,gBAAqB,KAC7B,OAAO,CAAC,IAAI,CAed,CAAC"}

package/dist/blaze.js

@@ -0,0 +1,69 @@
+/**
+ * blaze() -- the one-liner HTTP server launcher.
+ *
+ * ```ts
+ * const app = topo("myapp", entity);
+ * await blaze(app, { port: 3000 });
+ * ```
+ */
+import { Hono } from 'hono';
+import { buildHttpRoutes } from './build.js';
+// ---------------------------------------------------------------------------
+// Internal: register routes on Hono app
+// ---------------------------------------------------------------------------
+/** Route registration keyed by HTTP method. */
+const routeRegistrars = {
+    DELETE: (hono, route) => {
+        hono.delete(route.path, route.handler);
+    },
+    GET: (hono, route) => {
+        hono.get(route.path, route.handler);
+    },
+    POST: (hono, route) => {
+        hono.post(route.path, route.handler);
+    },
+};
+const registerRoutes = (hono, app, options) => {
+    const routes = buildHttpRoutes(app, {
+        basePath: options.basePath,
+        createContext: options.createContext,
+        layers: options.layers,
+    });
+    for (const route of routes) {
+        routeRegistrars[route.method](hono, route);
+    }
+};
+// ---------------------------------------------------------------------------
+// Global error handler
+// ---------------------------------------------------------------------------
+const registerErrorHandler = (hono) => {
+    // oxlint-disable-next-line prefer-await-to-callbacks -- Hono's onError API requires a callback
+    hono.onError((err, c) => c.json({
+        error: {
+            category: 'internal',
+            code: 'InternalError',
+            message: err.message,
+        },
+    }, 500));
+};
+// ---------------------------------------------------------------------------
+// blaze
+// ---------------------------------------------------------------------------
+/**
+ * Build HTTP routes from a topo, create a Hono app, and optionally start serving.
+ */
+// oxlint-disable-next-line require-await -- async for consistency with other blaze() surfaces
+export const blaze = async (app, options = {}) => {
+    const hono = new Hono();
+    registerErrorHandler(hono);
+    registerRoutes(hono, app, options);
+    if (options.serve !== false) {
+        Bun.serve({
+            fetch: hono.fetch,
+            hostname: options.hostname ?? '0.0.0.0',
+            port: options.port ?? 3000,
+        });
+    }
+    return hono;
+};
+//# sourceMappingURL=blaze.js.map

package/dist/blaze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blaze.js","sourceRoot":"","sources":["../src/blaze.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAmB7C,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAE9E,+CAA+C;AAC/C,MAAM,eAAe,GAGjB;IACF,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,GAAG,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACnB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;CACF,CAAC;AAEF,MAAM,cAAc,GAAG,CACrB,IAAU,EACV,GAAS,EACT,OAAyB,EACnB,EAAE;IACR,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE;QAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC,CAAC;AAEF,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,oBAAoB,GAAG,CAAC,IAAU,EAAQ,EAAE;IAChD,+FAA+F;IAC/F,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CACtB,CAAC,CAAC,IAAI,CACJ;QACE,KAAK,EAAE;YACL,QAAQ,EAAE,UAAU;YACpB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB;KACF,EACD,GAAG,CACJ,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E;;GAEG;AACH,8FAA8F;AAC9F,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,EACxB,GAAS,EACT,UAA4B,EAAE,EACf,EAAE;IACjB,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAExB,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC3B,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAEnC,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QAC5B,GAAG,CAAC,KAAK,CAAC;YACR,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS;YACvC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/build.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Build framework-agnostic HTTP route definitions from a Trails topo.
+ *
+ * Each route definition describes the path, method, input source, and an
+ * `execute` function that validates input, composes layers, and runs the
+ * implementation -- all without referencing any HTTP framework types.
+ */
+import { Result } from '@ontrails/core';
+import type { Layer, ServiceOverrideMap, Topo, Trail, TrailContextInit } from '@ontrails/core';
+export interface BuildHttpRoutesOptions {
+    readonly basePath?: string | undefined;
+    /** Config values for services that declare a `config` schema, keyed by service ID. */
+    readonly configValues?: Readonly<Record<string, Record<string, unknown>>> | undefined;
+    readonly createContext?: (() => TrailContextInit | Promise<TrailContextInit>) | undefined;
+    readonly layers?: readonly Layer[] | undefined;
+    readonly services?: ServiceOverrideMap | undefined;
+}
+export type HttpMethod = 'GET' | 'POST' | 'DELETE';
+/** Input source derived from the HTTP method. */
+export type InputSource = 'query' | 'body';
+export interface HttpRouteDefinition {
+    readonly method: HttpMethod;
+    readonly path: string;
+    readonly trailId: string;
+    readonly inputSource: InputSource;
+    readonly trail: Trail<unknown, unknown>;
+    /**
+     * Validate input, compose layers, and execute the trail implementation.
+     *
+     * The caller is responsible for parsing raw input from the request and
+     * mapping the Result to an HTTP response. This function is framework-agnostic.
+     *
+     * @param signal - Optional AbortSignal from the HTTP request. When provided,
+     *   it takes final precedence over any context factory signal, allowing
+     *   client-initiated cancellation to propagate into trail execution.
+     */
+    readonly execute: (input: unknown, requestId?: string | undefined, signal?: AbortSignal | undefined) => Promise<Result<unknown, Error>>;
+}
+/**
+ * Build HTTP route definitions from a topo.
+ *
+ * Each trail becomes an HttpRouteDefinition with:
+ * - An HTTP method derived from intent (read -> GET, write -> POST, destroy -> DELETE)
+ * - A path derived from the trail ID (dots become slashes)
+ * - An input source derived from the method (GET -> query, others -> body)
+ * - An `execute` function that validates, layers, and runs the implementation
+ *
+ * Returns `Result.err(ValidationError)` if two trails derive the same
+ * (method, path) pair. Returns `Result.ok(routes)` on success.
+ */
+export declare const buildHttpRoutes: (app: Topo, options?: BuildHttpRoutesOptions) => Result<HttpRouteDefinition[], Error>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,MAAM,EAIP,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,KAAK,EACL,kBAAkB,EAClB,IAAI,EACJ,KAAK,EACL,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAMxB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,sFAAsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAClB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GACjD,SAAS,CAAC;IACd,QAAQ,CAAC,aAAa,CAAC,EACnB,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,GACpD,SAAS,CAAC;IACd,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CACpD;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,iDAAiD;AACjD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,EAAE,CAChB,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,KAC7B,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;CACtC;AAoJD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,IAAI,EACT,UAAS,sBAA2B,KACnC,MAAM,CAAC,mBAAmB,EAAE,EAAE,KAAK,CAIrC,CAAC"}

package/dist/build.js

@@ -0,0 +1,121 @@
+/**
+ * Build framework-agnostic HTTP route definitions from a Trails topo.
+ *
+ * Each route definition describes the path, method, input source, and an
+ * `execute` function that validates input, composes layers, and runs the
+ * implementation -- all without referencing any HTTP framework types.
+ */
+import { Result, SURFACE_KEY, ValidationError, executeTrail, } from '@ontrails/core';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Explicit intent → HTTP method mapping. */
+const intentToMethod = {
+    destroy: 'DELETE',
+    read: 'GET',
+    write: 'POST',
+};
+/** Derive HTTP method from trail intent. */
+const deriveMethod = (trail) => intentToMethod[trail.intent] ?? 'POST';
+/** Derive HTTP path from trail ID: `entity.show` -> `/entity/show`. */
+const derivePath = (basePath, trailId) => {
+    const segments = trailId.replaceAll('.', '/');
+    const base = basePath.endsWith('/') ? basePath.slice(0, -1) : basePath;
+    return `${base}/${segments}`;
+};
+/** Derive input source from HTTP method. */
+const deriveInputSource = (method) => method === 'GET' ? 'query' : 'body';
+/** Check if a trail should be included (skip internal trails). */
+const shouldInclude = (trail) => trail.metadata?.['internal'] !== true;
+/** Build per-request context overrides with the HTTP surface marker. */
+const withHttpSurface = (requestId) => ({
+    ...(requestId === undefined ? {} : { requestId }),
+    extensions: {
+        [SURFACE_KEY]: 'http',
+    },
+});
+// ---------------------------------------------------------------------------
+// Execute factory
+// ---------------------------------------------------------------------------
+/**
+ * Create an `execute` function for a single trail.
+ *
+ * Delegates to the centralized `executeTrail` pipeline in core.
+ * The returned function returns a `Result` and never throws.
+ */
+const createExecute = (t, layers, options) => (input, requestId, signal) => executeTrail(t, input, {
+    configValues: options.configValues,
+    createContext: options.createContext,
+    ctx: withHttpSurface(requestId),
+    layers,
+    services: options.services,
+    signal,
+});
+// ---------------------------------------------------------------------------
+// Builder helpers
+// ---------------------------------------------------------------------------
+/** Filter topo items to eligible trails. */
+const eligibleTrails = (app) => app.list().filter((trail) => shouldInclude(trail));
+/** Build a single route definition from a trail. */
+const buildRoute = (trail, basePath, layers, options) => {
+    const method = deriveMethod(trail);
+    const path = derivePath(basePath, trail.id);
+    return {
+        execute: createExecute(trail, layers, options),
+        inputSource: deriveInputSource(method),
+        method,
+        path,
+        trail,
+        trailId: trail.id,
+    };
+};
+// ---------------------------------------------------------------------------
+// Collision detection
+// ---------------------------------------------------------------------------
+/** Derive the lookup key for (method, path) collision detection. */
+const routeKey = (route) => `${route.method} ${route.path}`;
+/** Register a route, checking for (path, method) collisions. */
+const registerRoute = (route, seenRoutes, routes) => {
+    const key = routeKey(route);
+    const existingId = seenRoutes.get(key);
+    if (existingId !== undefined) {
+        return Result.err(new ValidationError(`HTTP route collision: trails "${existingId}" and "${route.trailId}" both derive ${route.method} ${route.path}`));
+    }
+    seenRoutes.set(key, route.trailId);
+    routes.push(route);
+    return Result.ok();
+};
+/** Accumulate route definitions, returning early on the first collision. */
+const accumulateRoutes = (trails, basePath, layers, options) => {
+    const routes = [];
+    const seenRoutes = new Map();
+    for (const trail of trails) {
+        const route = buildRoute(trail, basePath, layers, options);
+        const registered = registerRoute(route, seenRoutes, routes);
+        if (registered.isErr()) {
+            return registered;
+        }
+    }
+    return Result.ok(routes);
+};
+// ---------------------------------------------------------------------------
+// Builder
+// ---------------------------------------------------------------------------
+/**
+ * Build HTTP route definitions from a topo.
+ *
+ * Each trail becomes an HttpRouteDefinition with:
+ * - An HTTP method derived from intent (read -> GET, write -> POST, destroy -> DELETE)
+ * - A path derived from the trail ID (dots become slashes)
+ * - An input source derived from the method (GET -> query, others -> body)
+ * - An `execute` function that validates, layers, and runs the implementation
+ *
+ * Returns `Result.err(ValidationError)` if two trails derive the same
+ * (method, path) pair. Returns `Result.ok(routes)` on success.
+ */
+export const buildHttpRoutes = (app, options = {}) => {
+    const basePath = (options.basePath ?? '').replace(/\/+$/, '');
+    const layers = options.layers ?? [];
+    return accumulateRoutes(eligibleTrails(app), basePath, layers, options);
+};
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/hono/blaze.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Hono adapter for Trails HTTP routes.
+ *
+ * Takes framework-agnostic HttpRouteDefinition[] and wires them into a
+ * Hono application, handling request parsing, response mapping, and errors.
+ *
+ * ```ts
+ * const app = topo("myapp", entity);
+ * await blaze(app, { port: 3000 });
+ * ```
+ */
+import type { Layer, ServiceOverrideMap, Topo, TrailContextInit } from '@ontrails/core';
+import { Hono } from 'hono';
+export interface BlazeHttpOptions {
+    readonly basePath?: string | undefined;
+    /** Config values for services that declare a `config` schema, keyed by service ID. */
+    readonly configValues?: Readonly<Record<string, Record<string, unknown>>> | undefined;
+    readonly createContext?: (() => TrailContextInit | Promise<TrailContextInit>) | undefined;
+    readonly hostname?: string | undefined;
+    readonly layers?: readonly Layer[] | undefined;
+    readonly name?: string | undefined;
+    readonly port?: number | undefined;
+    readonly services?: ServiceOverrideMap | undefined;
+    /** Set false to return the Hono app without starting a server. */
+    readonly serve?: boolean | undefined;
+    /** Set to `false` to skip topo validation at startup. Defaults to `true`. */
+    readonly validate?: boolean | undefined;
+}
+/**
+ * Build HTTP routes from a topo, create a Hono app, and optionally start serving.
+ */
+export declare const blaze: (app: Topo, options?: BlazeHttpOptions) => Promise<Hono>;
+//# sourceMappingURL=blaze.d.ts.map

package/dist/hono/blaze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blaze.d.ts","sourceRoot":"","sources":["../../src/hono/blaze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EACV,KAAK,EACL,kBAAkB,EAClB,IAAI,EACJ,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAY5B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,sFAAsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAClB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GACjD,SAAS,CAAC;IACd,QAAQ,CAAC,aAAa,CAAC,EACnB,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,GACpD,SAAS,CAAC;IACd,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACnD,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;AAyQD;;GAEG;AAEH,eAAO,MAAM,KAAK,GAChB,KAAK,IAAI,EACT,UAAS,gBAAqB,KAC7B,OAAO,CAAC,IAAI,CA8Bd,CAAC"}