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

package/src/index.ts

@@ -1,8 +1,22 @@
 // Build (framework-agnostic)
 export {
-  buildHttpRoutes,
-  type BuildHttpRoutesOptions,
-  type HttpMethod,
+  deriveHttpRoutes,
+  type DeriveHttpRoutesOptions,
+  type HttpExecutionContext,
+  type HttpHeaderSource,
+  type HttpLayerInputProjection,
   type HttpRouteDefinition,
-  type InputSource,
+  type ResolveHttpPermit,
+  type ResolveHttpPermitInput,
 } from './build.js';
+export {
+  deriveHttpInputSource,
+  deriveHttpMethod,
+  deriveHttpOperationMethod,
+  httpMethodByIntent,
+} from './method.js';
+export type { HttpMethod, HttpOperationMethod, InputSource } from './method.js';
+
+// OpenAPI
+export { deriveOpenApiSpec } from './openapi.js';
+export type { OpenApiOptions, OpenApiSpec, OpenApiServer } from './openapi.js';

package/src/method.ts

@@ -0,0 +1,24 @@
+import type { Intent, WebhookMethod } from '@ontrails/core';
+
+export type HttpMethod = 'GET' | 'POST' | 'DELETE' | WebhookMethod;
+
+export type HttpOperationMethod = Lowercase<HttpMethod>;
+
+export type InputSource = 'query' | 'body' | 'webhook';
+
+export const httpMethodByIntent = {
+  destroy: 'DELETE',
+  read: 'GET',
+  write: 'POST',
+} as const satisfies Record<Intent, HttpMethod>;
+
+export const deriveHttpMethod = (intent: Intent): HttpMethod =>
+  (httpMethodByIntent as Partial<Record<string, HttpMethod>>)[intent] ?? 'POST';
+
+export const deriveHttpOperationMethod = (
+  intent: Intent
+): HttpOperationMethod =>
+  deriveHttpMethod(intent).toLowerCase() as HttpOperationMethod;
+
+export const deriveHttpInputSource = (method: HttpMethod): InputSource =>
+  method === 'GET' ? 'query' : 'body';

package/src/openapi.ts

@@ -0,0 +1,357 @@
+/**
+ * Derive an OpenAPI 3.1 specification from a Topo.
+ *
+ * Converts each trail into an HTTP operation, deriving paths, methods,
+ * parameters, and response schemas from the trail contract.
+ */
+
+import {
+  ValidationError,
+  filterSurfaceTrails,
+  projectErrorClassSurface,
+  validateSurfaceTopo,
+  zodToJsonSchema,
+} from '@ontrails/core';
+import type {
+  SurfaceSelectionOptions,
+  SurfaceValidationOptions,
+  Topo,
+  Trail,
+} from '@ontrails/core';
+
+import { deriveHttpOperationMethod } from './method.js';
+
+type JsonSchema = Readonly<Record<string, unknown>>;
+
+// ---------------------------------------------------------------------------
+// Public types
+// ---------------------------------------------------------------------------
+
+export interface OpenApiServer {
+  readonly url: string;
+  readonly description?: string | undefined;
+}
+
+export interface OpenApiOptions
+  extends SurfaceSelectionOptions, SurfaceValidationOptions {
+  /** Default: `graph.name` */
+  readonly title?: string | undefined;
+  /** Default: `'1.0.0'` */
+  readonly version?: string | undefined;
+  readonly description?: string | undefined;
+  readonly servers?: readonly OpenApiServer[] | undefined;
+  /** Prefix for all paths. Default: `''` */
+  readonly basePath?: string | undefined;
+}
+
+/** Minimal OpenAPI 3.1 spec shape — intentionally plain objects, no heavy library. */
+export interface OpenApiSpec {
+  readonly openapi: '3.1.0';
+  readonly info: {
+    readonly title: string;
+    readonly version: string;
+    readonly description?: string | undefined;
+  };
+  readonly servers?: readonly OpenApiServer[] | undefined;
+  readonly paths: Record<string, Record<string, unknown>>;
+  readonly components: { readonly schemas: Record<string, unknown> };
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/** `entity.show` → `/entity/show` */
+const trailIdToPath = (id: string, basePath: string): string =>
+  `${basePath}/${id.split('.').join('/')}`;
+
+/** First segment of a dotted ID, used as an OpenAPI tag. */
+const tagFromId = (id: string): string => id.split('.')[0] ?? id;
+
+/** Convert a Zod schema to JSON Schema via the core helper. */
+const toJsonSchema = (schema: unknown): JsonSchema =>
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  zodToJsonSchema(schema as any) as JsonSchema;
+
+/** Build query parameters from a JSON Schema `properties` object. */
+const buildQueryParameters = (
+  jsonSchema: JsonSchema
+): Record<string, unknown>[] => {
+  const properties = jsonSchema['properties'] as
+    | Record<string, Record<string, unknown>>
+    | undefined;
+  if (!properties) {
+    return [];
+  }
+
+  const required = new Set(
+    Array.isArray(jsonSchema['required'])
+      ? (jsonSchema['required'] as string[])
+      : []
+  );
+
+  return Object.entries(properties).map(([name, schema]) => ({
+    in: 'query',
+    name,
+    required: required.has(name),
+    schema,
+  }));
+};
+
+/** Map a single error example to a status code entry, or undefined if not mappable. */
+const errorExampleToEntry = (
+  errorName: string,
+  seen: Set<number>
+): [string, { description: string }] | undefined => {
+  const projection = projectErrorClassSurface('http', errorName);
+  if (projection === undefined) {
+    return undefined;
+  }
+
+  const { code } = projection;
+  if (seen.has(code)) {
+    return undefined;
+  }
+  seen.add(code);
+  return [String(code), { description: errorName }];
+};
+
+/** Extract error status codes from trail examples that have an `error` field. */
+const errorResponsesFromExamples = (
+  examples: readonly { error?: string | undefined }[]
+): Record<string, { description: string }> => {
+  const responses: Record<string, { description: string }> = {};
+  const seen = new Set<number>();
+
+  for (const ex of examples) {
+    if (!ex.error) {
+      continue;
+    }
+    const entry = errorExampleToEntry(ex.error, seen);
+    if (entry) {
+      const [code, value] = entry;
+      responses[code] = value;
+    }
+  }
+
+  return responses;
+};
+
+// ---------------------------------------------------------------------------
+// Operation builder — split into focused helpers
+// ---------------------------------------------------------------------------
+
+/** True when the body is required — non-object schemas are always required,
+ *  object schemas are required only when they have at least one required property. */
+const isBodyRequired = (schema: JsonSchema): boolean => {
+  if (schema['type'] !== 'object') {
+    return true;
+  }
+  return (
+    Array.isArray(schema['required']) &&
+    (schema['required'] as unknown[]).length > 0
+  );
+};
+
+/** Build the input portion of an operation (parameters or requestBody). */
+const buildInputSpec = (
+  t: Trail<unknown, unknown, unknown>,
+  method: string
+): Record<string, unknown> => {
+  if (!t.input) {
+    return {};
+  }
+  const inputSchema = toJsonSchema(t.input);
+
+  if (method === 'get') {
+    const params = buildQueryParameters(inputSchema);
+    return params.length > 0 ? { parameters: params } : {};
+  }
+
+  const properties = inputSchema['properties'] as
+    | Record<string, unknown>
+    | undefined;
+  if (properties !== undefined && Object.keys(properties).length === 0) {
+    return {};
+  }
+
+  return {
+    requestBody: {
+      content: { 'application/json': { schema: inputSchema } },
+      required: isBodyRequired(inputSchema),
+    },
+  };
+};
+
+/** Wrap a raw output schema in the `{ data: ... }` envelope the HTTP adapter uses. */
+const wrapInDataEnvelope = (outputSchema: JsonSchema): JsonSchema => ({
+  properties: { data: outputSchema },
+  required: ['data'],
+  type: 'object',
+});
+
+/** Shared error response body schema: `{ error: { message, code, category } }`. */
+const errorResponseSchema: JsonSchema = {
+  properties: {
+    error: {
+      properties: {
+        category: { type: 'string' },
+        code: { type: 'string' },
+        message: { type: 'string' },
+      },
+      required: ['message', 'code', 'category'],
+      type: 'object',
+    },
+  },
+  required: ['error'],
+  type: 'object',
+};
+
+/** Build the 200 response entry. */
+const buildSuccessResponse = (
+  t: Trail<unknown, unknown, unknown>
+): Record<string, unknown> => {
+  if (!t.output) {
+    return { '200': { description: 'Success' } };
+  }
+  const outputSchema = toJsonSchema(t.output);
+  return {
+    '200': {
+      content: {
+        'application/json': { schema: wrapInDataEnvelope(outputSchema) },
+      },
+      description: 'Success',
+    },
+  };
+};
+
+/** Build the default 400 validation error response. */
+const validationErrorResponse: Record<
+  string,
+  { content: Record<string, unknown>; description: string }
+> = {
+  '400': {
+    content: { 'application/json': { schema: errorResponseSchema } },
+    description: 'Validation error',
+  },
+};
+
+/** Build all responses (success + error) for a trail. */
+const buildResponses = (
+  t: Trail<unknown, unknown, unknown>
+): Record<string, unknown> => {
+  const examples = (t.examples ?? []) as readonly {
+    error?: string | undefined;
+  }[];
+  return {
+    ...buildSuccessResponse(t),
+    ...errorResponsesFromExamples(examples),
+    ...validationErrorResponse,
+  };
+};
+
+const operationIdFromTrailId = (trailId: string): string =>
+  trailId.replaceAll('.', '_');
+
+/** Build a complete OpenAPI operation for a trail. */
+const buildOperation = (
+  t: Trail<unknown, unknown, unknown>,
+  method: string
+): Record<string, unknown> => ({
+  operationId: operationIdFromTrailId(t.id),
+  responses: buildResponses(t),
+  tags: [tagFromId(t.id)],
+  ...(t.description ? { summary: t.description } : {}),
+  ...buildInputSpec(t, method),
+});
+
+// ---------------------------------------------------------------------------
+// Path collection
+// ---------------------------------------------------------------------------
+
+/** Collect all paths from public trails in the graph. */
+const collectPaths = (
+  graph: Topo,
+  basePath: string,
+  options?: OpenApiOptions
+): Record<string, Record<string, unknown>> => {
+  const paths: Record<string, Record<string, unknown>> = {};
+  const seenRoutes = new Map<string, string>();
+  const seenOperationIds = new Map<string, string>();
+
+  for (const t of filterSurfaceTrails(graph.list(), {
+    exclude: options?.exclude,
+    include: options?.include,
+    intent: options?.intent,
+  })) {
+    const method = deriveHttpOperationMethod(t.intent);
+    const path = trailIdToPath(t.id, basePath);
+    const routeKey = `${method.toUpperCase()} ${path}`;
+    const existingId = seenRoutes.get(routeKey);
+    if (existingId !== undefined) {
+      throw new ValidationError(
+        `HTTP route collision: trails "${existingId}" and "${t.id}" both derive ${routeKey}`
+      );
+    }
+    seenRoutes.set(routeKey, t.id);
+
+    const operationId = operationIdFromTrailId(t.id);
+    const existingOperationId = seenOperationIds.get(operationId);
+    if (existingOperationId !== undefined) {
+      throw new ValidationError(
+        `OpenAPI operationId collision: trails "${existingOperationId}" and "${t.id}" both derive operationId "${operationId}"`
+      );
+    }
+    seenOperationIds.set(operationId, t.id);
+
+    paths[path] ??= {};
+    paths[path][method] = buildOperation(t, method);
+  }
+
+  return paths;
+};
+
+/** Build the info object from options and graph name. */
+const buildInfo = (
+  graphName: string,
+  options?: OpenApiOptions
+): OpenApiSpec['info'] => ({
+  title: options?.title ?? graphName,
+  version: options?.version ?? '1.0.0',
+  ...(options?.description ? { description: options.description } : {}),
+});
+
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+
+/**
+ * Derive an OpenAPI 3.1 specification from a Topo.
+ *
+ * Iterates all trails, skipping signals and internal trails, and produces
+ * paths, operations, parameters, and response schemas derived from
+ * the trail contract.
+ */
+export const deriveOpenApiSpec = (
+  graph: Topo,
+  options?: OpenApiOptions
+): OpenApiSpec => {
+  const validated = validateSurfaceTopo(graph, options);
+  if (validated.isErr()) {
+    throw validated.error;
+  }
+
+  return {
+    components: { schemas: {} },
+    info: buildInfo(graph.name, options),
+    openapi: '3.1.0',
+    paths: collectPaths(
+      graph,
+      (options?.basePath ?? '').replace(/\/+$/, ''),
+      options
+    ),
+    ...(options?.servers && options.servers.length > 0
+      ? { servers: options.servers }
+      : {}),
+  };
+};

package/.turbo/turbo-build.log

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

package/.turbo/turbo-lint.log

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

package/.turbo/turbo-typecheck.log

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

package/dist/blaze.d.ts

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

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

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

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

@@ -1,54 +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 } from '@ontrails/core';
-import type { Gate, ProvisionOverrideMap, Topo, Trail, TrailContextInit } from '@ontrails/core';
-export interface BuildHttpRoutesOptions {
-    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 gates?: readonly Gate[] | undefined;
-    readonly provisions?: ProvisionOverrideMap | undefined;
-    /** Set to `false` to skip topo validation while building routes. */
-    readonly validate?: boolean | 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 gates, 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 abortSignal - 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, abortSignal?: 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, 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 declare const buildHttpRoutes: (app: Topo, options?: BuildHttpRoutesOptions) => Result<HttpRouteDefinition[], Error>;
-//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,MAAM,EAKP,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,IAAI,EACJ,oBAAoB,EACpB,IAAI,EACJ,KAAK,EACL,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAMxB,MAAM,WAAW,sBAAsB;IACrC,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,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACvD,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;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,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,KAClC,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,CAWrC,CAAC"}