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

package/src/hono/{blaze.ts → trailhead.ts}

@@ -1,19 +1,19 @@
 /**
- * Hono adapter for Trails HTTP routes.
+ * 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 blaze(app, { port: 3000 });
+ * await trailhead(app, { port: 3000 });
  * ```
  */
 
-import { isTrailsError, statusCodeMap, validateTopo } from '@ontrails/core';
+import { isTrailsError, statusCodeMap } from '@ontrails/core';
 import type {
-  Layer,
-  ServiceOverrideMap,
+  Gate,
+  ProvisionOverrideMap,
   Topo,
   TrailContextInit,
 } from '@ontrails/core';
@@ -29,9 +29,9 @@ import { buildHttpRoutes } from '../build.js';
 // Options
 // ---------------------------------------------------------------------------
 
-export interface BlazeHttpOptions {
+export interface TrailheadHttpOptions {
   readonly basePath?: string | undefined;
-  /** Config values for services that declare a `config` schema, keyed by service ID. */
+  /** Config values for provisions that declare a `config` schema, keyed by provision ID. */
   readonly configValues?:
     | Readonly<Record<string, Record<string, unknown>>>
     | undefined;
@@ -39,10 +39,10 @@ export interface BlazeHttpOptions {
     | (() => TrailContextInit | Promise<TrailContextInit>)
     | undefined;
   readonly hostname?: string | undefined;
-  readonly layers?: readonly Layer[] | undefined;
+  readonly gates?: readonly Gate[] | undefined;
   readonly name?: string | undefined;
   readonly port?: number | undefined;
-  readonly services?: ServiceOverrideMap | 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`. */
@@ -233,10 +233,10 @@ const createHonoHandler =
     }
 
     const requestId = c.req.header('X-Request-ID') ?? undefined;
-    const { signal } = c.req.raw;
+    const { signal: abortSignal } = c.req.raw;
 
     try {
-      const result = await route.execute(rawInput, requestId, signal);
+      const result = await route.execute(rawInput, requestId, abortSignal);
       return mapResultToResponse(result, c);
     } catch (error: unknown) {
       return handleCaughtError(error, c);
@@ -294,34 +294,21 @@ const registerErrorHandler = (hono: Hono): void => {
 // 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: Topo, skip = false): void => {
-  if (skip) {
-    return;
-  }
-  const validated = validateTopo(app);
-  if (validated.isErr()) {
-    throw validated.error;
-  }
-};
-
 // ---------------------------------------------------------------------------
-// blaze
+// trailhead
 // ---------------------------------------------------------------------------
 
 /**
  * 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).
  */
-// oxlint-disable-next-line require-await -- async for consistency with other blaze() surfaces
-export const blaze = async (
+// oxlint-disable-next-line require-await -- async for consistency with other trailhead() entrypoints
+export const trailhead = async (
   app: Topo,
-  options: BlazeHttpOptions = {}
+  options: TrailheadHttpOptions = {}
 ): Promise<Hono> => {
-  assertValidTopo(app, options.validate === false);
-
   const hono = new Hono();
 
   registerErrorHandler(hono);
@@ -330,8 +317,9 @@ export const blaze = async (
     basePath: options.basePath,
     configValues: options.configValues,
     createContext: options.createContext,
-    layers: options.layers,
-    services: options.services,
+    gates: options.gates,
+    provisions: options.provisions,
+    validate: options.validate,
   });
 
   if (routesResult.isErr()) {

package/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/build.ts","./src/index.ts","./src/hono/blaze.ts","./src/hono/index.ts"],"version":"5.9.3"}
+{"root":["./src/build.ts","./src/index.ts","./src/hono/index.ts","./src/hono/trailhead.ts"],"version":"5.9.3"}