@ontrails/http 1.0.0-beta.14 → 1.0.0-beta.16

package/dist/build.js

@@ -1,127 +0,0 @@
-/**
- * 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 gates, and runs the
- * implementation -- all without referencing any HTTP framework types.
- */
-import { Result, TRAILHEAD_KEY, ValidationError, executeTrail, validateEstablishedTopo, } 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.meta?.['internal'] !== true;
-/** Build per-request context overrides with the HTTP trailhead marker. */
-const withHttpTrailhead = (requestId) => ({
-    ...(requestId === undefined ? {} : { requestId }),
-    extensions: {
-        [TRAILHEAD_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, gates, options) => (input, requestId, abortSignal) => executeTrail(t, input, {
-    abortSignal,
-    configValues: options.configValues,
-    createContext: options.createContext,
-    ctx: withHttpTrailhead(requestId),
-    gates,
-    provisions: options.provisions,
-});
-// ---------------------------------------------------------------------------
-// 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, gates, options) => {
-    const method = deriveMethod(trail);
-    const path = derivePath(basePath, trail.id);
-    return {
-        execute: createExecute(trail, gates, 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, gates, options) => {
-    const routes = [];
-    const seenRoutes = new Map();
-    for (const trail of trails) {
-        const route = buildRoute(trail, basePath, gates, 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, gates, 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 = {}) => {
-    if (options.validate !== false) {
-        const validated = validateEstablishedTopo(app);
-        if (validated.isErr()) {
-            return Result.err(validated.error);
-        }
-    }
-    const basePath = (options.basePath ?? '').replace(/\/+$/, '');
-    const gates = options.gates ?? [];
-    return accumulateRoutes(eligibleTrails(app), basePath, gates, options);
-};
-//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/hono/blaze.d.ts

@@ -1,33 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}

package/dist/hono/blaze.js

@@ -1,232 +0,0 @@
-/**
- * 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 { isTrailsError, statusCodeMap, validateTopo } from '@ontrails/core';
-import { Hono } from 'hono';
-import { buildHttpRoutes } from '../build.js';
-/** Unwrap optional/default wrappers to reach the underlying Zod type name. */
-const unwrapZodType = (node) => {
-    let current = node;
-    while (current._zod.def['type'] === 'optional' ||
-        current._zod.def['type'] === 'default') {
-        current = current._zod.def['innerType'];
-    }
-    return current._zod.def['type'];
-};
-/** Extract the object shape from a Zod schema, or undefined if not an object. */
-const extractShape = (schema) => {
-    const s = schema;
-    if (s._zod.def['type'] !== 'object') {
-        return undefined;
-    }
-    return s._zod.def['shape'];
-};
-/** Collect top-level field names whose underlying type is array. */
-const collectArrayKeys = (inputSchema) => {
-    const shape = inputSchema ? extractShape(inputSchema) : undefined;
-    if (!shape) {
-        return new Set();
-    }
-    const keys = new Set();
-    for (const [key, value] of Object.entries(shape)) {
-        if (unwrapZodType(value) === 'array') {
-            keys.add(key);
-        }
-    }
-    return keys;
-};
-/** Parse query params into a plain object, preserving raw strings for Zod. */
-const parseQueryParams = (c, inputSchema) => {
-    const result = {};
-    const url = new URL(c.req.url);
-    const arrayKeys = collectArrayKeys(inputSchema);
-    for (const key of url.searchParams.keys()) {
-        // Already collected via getAll
-        if (key in result) {
-            continue;
-        }
-        const all = url.searchParams.getAll(key);
-        result[key] = all.length > 1 || arrayKeys.has(key) ? all : all[0];
-    }
-    return result;
-};
-/** Sentinel indicating a JSON parse failure. */
-const JSON_PARSE_ERROR = Symbol('JSON_PARSE_ERROR');
-/** Return true when the request has no body content. */
-const isEmptyBody = (c) => {
-    const contentLength = c.req.header('Content-Length');
-    if (contentLength !== undefined) {
-        return Number.parseInt(contentLength, 10) === 0;
-    }
-    // No Content-Length header — treat as empty when Content-Type is also absent.
-    return c.req.header('Content-Type') === undefined;
-};
-/** Read input from request based on input source. */
-const readInput = async (c, inputSource, inputSchema) => {
-    if (inputSource === 'query') {
-        return parseQueryParams(c, inputSchema);
-    }
-    if (isEmptyBody(c)) {
-        return {};
-    }
-    try {
-        return await c.req.json();
-    }
-    catch {
-        return JSON_PARSE_ERROR;
-    }
-};
-// ---------------------------------------------------------------------------
-// Response mapping
-// ---------------------------------------------------------------------------
-/** Map a TrailsError or generic Error to an HTTP error response. */
-const mapErrorResponse = (error) => {
-    if (isTrailsError(error)) {
-        return {
-            body: {
-                error: {
-                    category: error.category,
-                    code: error.name,
-                    message: error.message,
-                },
-            },
-            status: statusCodeMap[error.category],
-        };
-    }
-    return {
-        body: {
-            error: {
-                category: 'internal',
-                code: 'InternalError',
-                message: error.message,
-            },
-        },
-        status: 500,
-    };
-};
-// ---------------------------------------------------------------------------
-// Route registration
-// ---------------------------------------------------------------------------
-/** Map a Result to an HTTP response via Hono context. */
-const mapResultToResponse = (result, c) => {
-    if (result.isOk()) {
-        return c.json({ data: result.value }, 200);
-    }
-    const { body, status } = mapErrorResponse(result.error ?? new Error('Unknown error'));
-    return c.json(body, status);
-};
-/** Convert a caught unknown value to an error response. */
-const handleCaughtError = (error, c) => {
-    const err = error instanceof Error ? error : new Error(String(error));
-    const { body, status } = mapErrorResponse(err);
-    return c.json(body, status);
-};
-/** Create a Hono handler from a route definition. */
-const createHonoHandler = (route) => async (c) => {
-    const rawInput = await readInput(c, route.inputSource, route.trail.input);
-    if (rawInput === JSON_PARSE_ERROR) {
-        return c.json({
-            error: {
-                category: 'validation',
-                code: 'ValidationError',
-                message: 'Invalid JSON in request body',
-            },
-        }, 400);
-    }
-    const requestId = c.req.header('X-Request-ID') ?? undefined;
-    const { signal: abortSignal } = c.req.raw;
-    try {
-        const result = await route.execute(rawInput, requestId, abortSignal);
-        return mapResultToResponse(result, c);
-    }
-    catch (error) {
-        return handleCaughtError(error, c);
-    }
-};
-/** Route registration keyed by HTTP method. */
-const routeRegistrars = {
-    DELETE: (hono, path, handler) => {
-        hono.delete(path, handler);
-    },
-    GET: (hono, path, handler) => {
-        hono.get(path, handler);
-    },
-    POST: (hono, path, handler) => {
-        hono.post(path, handler);
-    },
-};
-const registerRoutes = (hono, routes) => {
-    for (const route of routes) {
-        const handler = createHonoHandler(route);
-        routeRegistrars[route.method](hono, route.path, handler);
-    }
-};
-// ---------------------------------------------------------------------------
-// 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));
-};
-// ---------------------------------------------------------------------------
-// Validation
-// ---------------------------------------------------------------------------
-/**
- * Throw a ValidationError if the topo has structural issues.
- * Pass `skip: true` to bypass validation (e.g. when `validate: false` is set).
- */
-const assertValidTopo = (app, skip = false) => {
-    if (skip) {
-        return;
-    }
-    const validated = validateTopo(app);
-    if (validated.isErr()) {
-        throw validated.error;
-    }
-};
-// ---------------------------------------------------------------------------
-// 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 = {}) => {
-    assertValidTopo(app, options.validate === false);
-    const hono = new Hono();
-    registerErrorHandler(hono);
-    const routesResult = buildHttpRoutes(app, {
-        basePath: options.basePath,
-        configValues: options.configValues,
-        createContext: options.createContext,
-        layers: options.layers,
-        services: options.services,
-    });
-    if (routesResult.isErr()) {
-        throw routesResult.error;
-    }
-    registerRoutes(hono, routesResult.value);
-    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/hono/blaze.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"blaze.js","sourceRoot":"","sources":["../../src/hono/blaze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO5E,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAM5B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAwC9C,8EAA8E;AAC9E,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE;IAC7C,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,OACG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAY,KAAK,UAAU;QAClD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAY,KAAK,SAAS,EAClD,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAW,CAAC;IACpD,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAW,CAAC;AAC5C,CAAC,CAAC;AAEF,iFAAiF;AACjF,MAAM,YAAY,GAAG,CACnB,MAAiB,EACmB,EAAE;IACtC,MAAM,CAAC,GAAG,MAA2B,CAAC;IACtC,IAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAY,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAuC,CAAC;AACnE,CAAC,CAAC;AAEF,oEAAoE;AACpE,MAAM,gBAAgB,GAAG,CACvB,WAAkC,EACb,EAAE;IACvB,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,aAAa,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,8EAA8E;AAC9E,MAAM,gBAAgB,GAAG,CACvB,CAAc,EACd,WAAmC,EACV,EAAE;IAC3B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEhD,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1C,+BAA+B;QAC/B,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,gDAAgD;AAChD,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAEpD,wDAAwD;AACxD,MAAM,WAAW,GAAG,CAAC,CAAc,EAAW,EAAE;IAC9C,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACrD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,8EAA8E;IAC9E,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,SAAS,CAAC;AACpD,CAAC,CAAC;AAEF,qDAAqD;AACrD,MAAM,SAAS,GAAG,KAAK,EACrB,CAAc,EACd,WAA6B,EAC7B,WAAmC,EACjB,EAAE;IACpB,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,gBAAgB,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gBAAgB,CAAC;IAC1B,CAAC;AACH,CAAC,CAAC;AAEF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,oEAAoE;AACpE,MAAM,gBAAgB,GAAG,CACvB,KAAY,EACqD,EAAE;IACnE,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,IAAI,EAAE;gBACJ,KAAK,EAAE;oBACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;iBACvB;aACF;YACD,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAyB;SAC9D,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE;YACJ,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB;SACF;QACD,MAAM,EAAE,GAAG;KACZ,CAAC;AACJ,CAAC,CAAC;AAEF,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,yDAAyD;AACzD,MAAM,mBAAmB,GAAG,CAC1B,MAA2D,EAC3D,CAAc,EACJ,EAAE;IACZ,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CACvC,MAAM,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,eAAe,CAAC,CAC3C,CAAC;IACF,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,2DAA2D;AAC3D,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAE,CAAc,EAAY,EAAE;IACrE,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF,qDAAqD;AACrD,MAAM,iBAAiB,GACrB,CAAC,KAA0B,EAAE,EAAE,CAC/B,KAAK,EAAE,CAAc,EAAqB,EAAE;IAC1C,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE1E,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;QAClC,OAAO,CAAC,CAAC,IAAI,CACX;YACE,KAAK,EAAE;gBACL,QAAQ,EAAE,YAAY;gBACtB,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,8BAA8B;aACxC;SACF,EACD,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;IAC5D,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACrE,OAAO,mBAAmB,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,iBAAiB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;AACH,CAAC,CAAC;AAEJ,+CAA+C;AAC/C,MAAM,eAAe,GAOjB;IACF,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3B,CAAC;CACF,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,IAAU,EAAE,MAA6B,EAAQ,EAAE;IACzE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACzC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3D,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,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,eAAe,GAAG,CAAC,GAAS,EAAE,IAAI,GAAG,KAAK,EAAQ,EAAE;IACxD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QACtB,MAAM,SAAS,CAAC,KAAK,CAAC;IACxB,CAAC;AACH,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,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC;IAEjD,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAExB,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAE3B,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,EAAE;QACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,CAAC;IAEH,IAAI,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC;QACzB,MAAM,YAAY,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAEzC,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/hono/index.d.ts

@@ -1,2 +0,0 @@
-export { trailhead, type TrailheadHttpOptions } from './trailhead.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hono/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/hono/index.js

@@ -1,2 +0,0 @@
-export { trailhead } from './trailhead.js';
-//# sourceMappingURL=index.js.map

package/dist/hono/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hono/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA6B,MAAM,gBAAgB,CAAC"}

package/dist/hono/trailhead.d.ts

@@ -1,36 +0,0 @@
-/**
- * Hono connector 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 trailhead(app, { port: 3000 });
- * ```
- */
-import type { Gate, ProvisionOverrideMap, Topo, TrailContextInit } from '@ontrails/core';
-import { Hono } from 'hono';
-export interface TrailheadHttpOptions {
-    readonly basePath?: string | undefined;
-    /** Config values for provisions that declare a `config` schema, keyed by provision ID. */
-    readonly configValues?: Readonly<Record<string, Record<string, unknown>>> | undefined;
-    readonly createContext?: (() => TrailContextInit | Promise<TrailContextInit>) | undefined;
-    readonly hostname?: string | undefined;
-    readonly gates?: readonly Gate[] | undefined;
-    readonly name?: string | undefined;
-    readonly port?: number | undefined;
-    readonly provisions?: ProvisionOverrideMap | 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.
- *
- * Topo validation runs before route construction — pass `validate: false`
- * to skip it (e.g. during hot-reload or progressive startup).
- */
-export declare const trailhead: (app: Topo, options?: TrailheadHttpOptions) => Promise<Hono>;
-//# sourceMappingURL=trailhead.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"trailhead.d.ts","sourceRoot":"","sources":["../../src/hono/trailhead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EACV,IAAI,EACJ,oBAAoB,EACpB,IAAI,EACJ,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAY5B,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,0FAA0F;IAC1F,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,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACvD,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;AA2PD;;;;;GAKG;AAEH,eAAO,MAAM,SAAS,GACpB,KAAK,IAAI,EACT,UAAS,oBAAyB,KACjC,OAAO,CAAC,IAAI,CA6Bd,CAAC"}