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

package/src/index.ts

@@ -2,7 +2,21 @@
 export {
   deriveHttpRoutes,
   type DeriveHttpRoutesOptions,
-  type HttpMethod,
+  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 67ms on 4 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

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

package/dist/build.d.ts

@@ -1,57 +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 layers, and runs the
- * implementation -- all without referencing any HTTP framework types.
- */
-import { Result } from '@ontrails/core';
-import type { Intent, Layer, ResourceOverrideMap, Topo, Trail, TrailContextInit } from '@ontrails/core';
-export interface DeriveHttpRoutesOptions {
-    readonly basePath?: string | undefined;
-    /** Config values for resources that declare a `config` schema, keyed by resource ID. */
-    readonly configValues?: Readonly<Record<string, Record<string, unknown>>> | undefined;
-    readonly createContext?: (() => TrailContextInit | Promise<TrailContextInit>) | undefined;
-    readonly exclude?: readonly string[] | undefined;
-    readonly include?: readonly string[] | undefined;
-    readonly intent?: readonly Intent[] | undefined;
-    readonly layers?: readonly Layer[] | undefined;
-    readonly resources?: ResourceOverrideMap | 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, 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 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, 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 deriveHttpRoutes: (graph: Topo, options?: DeriveHttpRoutesOptions) => 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,EAMP,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,MAAM,EACN,KAAK,EACL,mBAAmB,EACnB,IAAI,EACJ,KAAK,EACL,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAMxB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,wFAAwF;IACxF,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,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACrD,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,EAAE,OAAO,CAAC,CAAC;IACjD;;;;;;;;;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;AA2JD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,IAAI,EACX,UAAS,uBAA4B,KACpC,MAAM,CAAC,mBAAmB,EAAE,EAAE,KAAK,CAiBrC,CAAC"}

package/dist/build.js

@@ -1,130 +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 layers, and runs the
- * implementation -- all without referencing any HTTP framework types.
- */
-import { Result, TRAILHEAD_KEY, ValidationError, executeTrail, filterSurfaceTrails, 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';
-/** 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 = (graph, t, layers, options) => (input, requestId, abortSignal) => executeTrail(t, input, {
-    abortSignal,
-    configValues: options.configValues,
-    createContext: options.createContext,
-    ctx: withHttpTrailhead(requestId),
-    layers,
-    resources: options.resources,
-    topo: graph,
-});
-// ---------------------------------------------------------------------------
-// Builder helpers
-// ---------------------------------------------------------------------------
-/** Filter topo items to eligible trails. */
-const eligibleTrails = (graph, options) => filterSurfaceTrails(graph.list(), {
-    exclude: options.exclude,
-    include: options.include,
-    intent: options.intent,
-});
-/** Build a single route definition from a trail. */
-const buildRoute = (graph, trail, basePath, layers, options) => {
-    const method = deriveMethod(trail);
-    const path = derivePath(basePath, trail.id);
-    return {
-        execute: createExecute(graph, 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 = (graph, trails, basePath, layers, options) => {
-    const routes = [];
-    const seenRoutes = new Map();
-    for (const trail of trails) {
-        const route = buildRoute(graph, 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 deriveHttpRoutes = (graph, options = {}) => {
-    if (options.validate !== false) {
-        const validated = validateEstablishedTopo(graph);
-        if (validated.isErr()) {
-            return Result.err(validated.error);
-        }
-    }
-    const basePath = (options.basePath ?? '').replace(/\/+$/, '');
-    const layers = options.layers ?? [];
-    return accumulateRoutes(graph, eligibleTrails(graph, options), basePath, layers, 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/index.d.ts

@@ -1,2 +0,0 @@
-export { deriveHttpRoutes, type DeriveHttpRoutesOptions, type HttpMethod, type HttpRouteDefinition, type InputSource, } from './build.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,3 +0,0 @@
-// Build (framework-agnostic)
-export { deriveHttpRoutes, } from './build.js';
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EACL,gBAAgB,GAKjB,MAAM,YAAY,CAAC"}