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

package/dist/errors.js

@@ -1,185 +0,0 @@
-/* oxlint-disable max-classes-per-file -- error taxonomy requires co-located class definitions */
-/**
- * Error taxonomy for @ontrails/core
- *
- * Provides a structured error hierarchy with category-based mapping
- * to exit codes, HTTP status codes, and JSON-RPC error codes.
- */
-// ---------------------------------------------------------------------------
-// Category
-// ---------------------------------------------------------------------------
-export const errorCategories = [
-    'validation',
-    'not_found',
-    'conflict',
-    'permission',
-    'timeout',
-    'rate_limit',
-    'network',
-    'internal',
-    'auth',
-    'cancelled',
-];
-// ---------------------------------------------------------------------------
-// Base class
-// ---------------------------------------------------------------------------
-export class TrailsError extends Error {
-    context;
-    constructor(message, options) {
-        super(message, { cause: options?.cause });
-        this.name = this.constructor.name;
-        this.context = options?.context;
-    }
-}
-// ---------------------------------------------------------------------------
-// Concrete error classes
-// ---------------------------------------------------------------------------
-export class ValidationError extends TrailsError {
-    category = 'validation';
-    retryable = false;
-}
-export class AmbiguousError extends TrailsError {
-    category = 'validation';
-    retryable = false;
-}
-export class AssertionError extends TrailsError {
-    category = 'internal';
-    retryable = false;
-}
-export class NotFoundError extends TrailsError {
-    category = 'not_found';
-    retryable = false;
-}
-export class AlreadyExistsError extends TrailsError {
-    category = 'conflict';
-    retryable = false;
-}
-export class ConflictError extends TrailsError {
-    category = 'conflict';
-    retryable = false;
-}
-export class PermissionError extends TrailsError {
-    category = 'permission';
-    retryable = false;
-}
-export class TimeoutError extends TrailsError {
-    category = 'timeout';
-    retryable = true;
-}
-export class RateLimitError extends TrailsError {
-    category = 'rate_limit';
-    retryable = true;
-    retryAfter;
-    constructor(message, options) {
-        super(message, options);
-        this.retryAfter = options?.retryAfter;
-    }
-}
-export class NetworkError extends TrailsError {
-    category = 'network';
-    retryable = true;
-}
-export class InternalError extends TrailsError {
-    category = 'internal';
-    retryable = false;
-}
-export class DerivationError extends TrailsError {
-    category = 'internal';
-    retryable = false;
-}
-export class AuthError extends TrailsError {
-    category = 'auth';
-    retryable = false;
-}
-export class CancelledError extends TrailsError {
-    category = 'cancelled';
-    retryable = false;
-}
-/**
- * Returned when a detour exhausts all recovery attempts.
- *
- * Inherits the wrapped error's category for trailhead mapping (e.g. a
- * `RetryExhaustedError<ConflictError>` maps to HTTP 409), but always
- * sets `retryable = false` to prevent amplification across `ctx.cross()`
- * boundaries or stacked layers.
- */
-export class RetryExhaustedError extends InternalError {
-    category;
-    cause;
-    /** Number of recovery attempts made before exhaustion. */
-    attempts;
-    /** Name of the detour whose recovery was exhausted. */
-    detour;
-    constructor(wrapped, metadata) {
-        super(`Recovery exhausted after ${metadata.attempts} attempts: ${wrapped.message}`, { cause: wrapped });
-        this.cause = wrapped;
-        this.attempts = metadata.attempts;
-        this.detour = metadata.detour;
-        // Dynamic — inherited from wrapped error at construction time.
-        this.category = wrapped.category;
-    }
-}
-// ---------------------------------------------------------------------------
-// Taxonomy maps
-// ---------------------------------------------------------------------------
-export const exitCodeMap = {
-    auth: 9,
-    cancelled: 130,
-    conflict: 3,
-    internal: 8,
-    network: 7,
-    not_found: 2,
-    permission: 4,
-    rate_limit: 6,
-    timeout: 5,
-    validation: 1,
-};
-export const statusCodeMap = {
-    auth: 401,
-    cancelled: 499,
-    conflict: 409,
-    internal: 500,
-    network: 502,
-    not_found: 404,
-    permission: 403,
-    rate_limit: 429,
-    timeout: 504,
-    validation: 400,
-};
-export const jsonRpcCodeMap = {
-    auth: -32_600,
-    cancelled: -32_603,
-    conflict: -32_603,
-    internal: -32_603,
-    network: -32_603,
-    not_found: -32_601,
-    permission: -32_600,
-    rate_limit: -32_603,
-    timeout: -32_603,
-    validation: -32_602,
-};
-export const retryableMap = {
-    auth: false,
-    cancelled: false,
-    conflict: false,
-    internal: false,
-    network: true,
-    not_found: false,
-    permission: false,
-    rate_limit: true,
-    timeout: true,
-    validation: false,
-};
-// ---------------------------------------------------------------------------
-// Helper functions
-// ---------------------------------------------------------------------------
-/** Type guard: narrows unknown to TrailsError */
-export const isTrailsError = (error) => error instanceof TrailsError;
-/** Returns true if the error is retryable (TrailsError with retryable category). */
-export const isRetryable = (error) => {
-    if (isTrailsError(error)) {
-        return error.retryable;
-    }
-    return false;
-};
-//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/execute.d.ts

@@ -1,52 +0,0 @@
-/**
- * Centralized trail execution pipeline.
- *
- * Validates input, builds context, composes layers, and runs the
- * implementation. Surfaces (CLI, MCP, HTTP) delegate here instead
- * of reimplementing the pipeline.
- */
-import type { z } from 'zod';
-import type { AnyTrail } from './trail.js';
-import type { Layer } from './layer.js';
-import type { ResourceOverrideMap } from './resource.js';
-import type { Topo } from './topo.js';
-import type { TrailContextInit } from './types.js';
-import { Result } from './result.js';
-/** Options for executeTrail. */
-export interface ExecuteTrailOptions {
-    /** Partial context overrides merged on top of the base context. */
-    readonly ctx?: Partial<TrailContextInit> | undefined;
-    /** AbortSignal override (takes final precedence over ctx and factory). */
-    readonly abortSignal?: AbortSignal | undefined;
-    /** Layers to compose around the implementation. */
-    readonly layers?: readonly Layer[] | undefined;
-    /** Factory that produces a base TrailContext (takes precedence over defaults). */
-    readonly createContext?: (() => TrailContextInit | Promise<TrailContextInit>) | undefined;
-    /** Explicit resource instance overrides keyed by resource ID. */
-    readonly resources?: ResourceOverrideMap | undefined;
-    /** Config values for resources that declare a `config` schema, keyed by resource ID. */
-    readonly configValues?: Readonly<Record<string, Record<string, unknown>>> | undefined;
-    /** Topo used for signal-driven activation; required for `ctx.fire()` to work. */
-    readonly topo?: Topo | undefined;
-    /**
-     * Override the validation schema used for input validation.
-     *
-     * When a trail is invoked via `ctx.cross()` and the target declares
-     * `crossInput`, the cross function merges `trail.input` with
-     * `trail.crossInput` and passes the merged schema here so validation
-     * accepts both public and composition-only fields.
-     *
-     * Used by the cross execution path; not part of the public API.
-     *
-     * @internal
-     */
-    readonly validationSchema?: z.ZodType | undefined;
-}
-/**
- * Execute a trail through the standard validate-context-layers-run pipeline.
- *
- * The function never throws -- unexpected exceptions are caught and
- * returned as `Result.err(InternalError)`.
- */
-export declare const executeTrail: (trail: AnyTrail, rawInput: unknown, options?: ExecuteTrailOptions) => Promise<Result<unknown, Error>>;
-//# sourceMappingURL=execute.d.ts.map

package/dist/execute.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,KAAK,EAOV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AA0BpB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAcrC,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACrD,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/C,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,CAAC;IAC/C,kFAAkF;IAClF,QAAQ,CAAC,aAAa,CAAC,EACnB,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,GACpD,SAAS,CAAC;IACd,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACrD,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,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACjC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC;CACnD;AAy0BD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,QAAQ,EACf,UAAU,OAAO,EACjB,UAAU,mBAAmB,KAC5B,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CA2BhC,CAAC"}