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

package/dist/resilience.js

@@ -1,164 +0,0 @@
-/**
- * Resilience utilities for @ontrails/core
- *
- * Retry with exponential backoff and timeout wrappers,
- * all returning Result types.
- */
-import { CancelledError, TimeoutError, isRetryable } from './errors.js';
-import { Result } from './result.js';
-// ---------------------------------------------------------------------------
-// Helpers (defined before usage)
-// ---------------------------------------------------------------------------
-const sleep = (ms, signal) => 
-// oxlint-disable-next-line avoid-new -- Promise constructor needed for setTimeout-based sleep
-new Promise((resolve) => {
-    if (signal?.aborted) {
-        resolve();
-        return;
-    }
-    let settled = false;
-    const done = () => {
-        if (!settled) {
-            settled = true;
-            resolve();
-        }
-    };
-    const timer = setTimeout(done, ms);
-    const onAbort = () => {
-        clearTimeout(timer);
-        done();
-    };
-    signal?.addEventListener('abort', onAbort, { once: true });
-});
-// ---------------------------------------------------------------------------
-// shouldRetry (default)
-// ---------------------------------------------------------------------------
-/** Default retry predicate using the error taxonomy. */
-export const shouldRetry = (error) => isRetryable(error);
-// ---------------------------------------------------------------------------
-// getBackoffDelay
-// ---------------------------------------------------------------------------
-/** Compute exponential backoff delay with full jitter. */
-export const getBackoffDelay = (attempt, options) => {
-    const base = options?.baseDelay ?? 1000;
-    const max = options?.maxDelay ?? 30_000;
-    const factor = options?.backoffFactor ?? 2;
-    const exponential = base * factor ** attempt;
-    const capped = Math.min(exponential, max);
-    // Full jitter: random value in [0, capped]
-    return Math.floor(Math.random() * capped);
-};
-// ---------------------------------------------------------------------------
-// retry
-// ---------------------------------------------------------------------------
-/**
- * Retry an async function that returns a Result.
- *
- * On each failure, checks whether the error is retryable and whether the
- * attempt budget remains. Applies exponential backoff with jitter between
- * retries.
- */
-/** Attempt a single retry iteration. Returns the result to stop, or undefined to continue. */
-const tryAttempt = async (fn, attempt, maxAttempts, retryPredicate, options) => {
-    const result = await fn();
-    if (result.isOk()) {
-        return { done: true, result };
-    }
-    const isLast = attempt === maxAttempts - 1;
-    if (isLast || !retryPredicate(result.error)) {
-        return { done: true, result };
-    }
-    const delay = getBackoffDelay(attempt, options);
-    if (delay > 0) {
-        await sleep(delay, options?.signal);
-    }
-    return { done: false, result };
-};
-/** Resolve retry options to concrete values. */
-const resolveRetryOptions = (options) => ({
-    maxAttempts: options?.maxAttempts ?? 3,
-    retryPredicate: options?.shouldRetry ?? shouldRetry,
-    signal: options?.signal,
-});
-export const retry = async (fn, options) => {
-    const { maxAttempts, retryPredicate, signal } = resolveRetryOptions(options);
-    let lastResult;
-    for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
-        if (signal?.aborted) {
-            return Result.err(new CancelledError('Retry cancelled'));
-        }
-        const outcome = await tryAttempt(fn, attempt, maxAttempts, retryPredicate, options);
-        lastResult = outcome.result;
-        if (outcome.done) {
-            return outcome.result;
-        }
-    }
-    return lastResult ?? Result.err(new CancelledError('Retry exhausted'));
-};
-// ---------------------------------------------------------------------------
-// withTimeout
-// ---------------------------------------------------------------------------
-/**
- * Run an async Result-returning function with a timeout.
- *
- * If the timeout fires first, returns a TimeoutError result.
- * Also respects an external AbortSignal.
- */
-export const withTimeout = (fn, ms, signal) => {
-    if (signal?.aborted) {
-        return Promise.resolve(Result.err(new CancelledError('Already cancelled')));
-    }
-    // oxlint-disable-next-line avoid-new, promise/no-multiple-resolved -- Promise constructor needed for timeout race; settled guard ensures single resolution
-    return new Promise((resolve) => {
-        let settled = false;
-        // oxlint-disable-next-line prefer-const -- assigned after declaration
-        let timer;
-        const onAbort = () => {
-            if (settled) {
-                return;
-            }
-            settled = true;
-            clearTimeout(timer);
-            signal?.removeEventListener('abort', onAbort);
-            // oxlint-disable-next-line promise/no-multiple-resolved -- settled guard ensures single resolution
-            resolve(Result.err(new CancelledError('Operation cancelled')));
-        };
-        signal?.addEventListener('abort', onAbort, { once: true });
-        timer = setTimeout(() => {
-            if (settled) {
-                return;
-            }
-            settled = true;
-            signal?.removeEventListener('abort', onAbort);
-            // oxlint-disable-next-line promise/no-multiple-resolved -- settled guard ensures single resolution
-            resolve(Result.err(new TimeoutError(`Operation timed out after ${ms}ms`, {
-                context: { timeoutMs: ms },
-            })));
-        }, ms);
-        // oxlint-disable-next-line prefer-await-to-then, no-void -- .then() needed inside Promise constructor; void discards unhandled rejection
-        void fn().then(
-        // oxlint-disable-next-line prefer-await-to-callbacks -- callback required inside .then()
-        (result) => {
-            if (settled) {
-                return;
-            }
-            settled = true;
-            clearTimeout(timer);
-            signal?.removeEventListener('abort', onAbort);
-            // oxlint-disable-next-line promise/no-multiple-resolved -- settled guard ensures single resolution
-            resolve(result);
-        }, 
-        // oxlint-disable-next-line prefer-await-to-callbacks -- rejection handler required inside .then()
-        (error) => {
-            if (settled) {
-                return;
-            }
-            settled = true;
-            clearTimeout(timer);
-            signal?.removeEventListener('abort', onAbort);
-            // oxlint-disable-next-line promise/no-multiple-resolved -- settled guard ensures single resolution
-            resolve(Result.err(error instanceof Error ? error : new Error(String(error))));
-        });
-    });
-};
-//# sourceMappingURL=resilience.js.map

package/dist/resilience.js.map

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

package/dist/result.d.ts

@@ -1,57 +0,0 @@
-/**
- * A type-safe Result monad for representing success/failure without exceptions.
- */
-import { InternalError, ValidationError } from './errors.js';
-declare class Ok<T, E> {
-    readonly value: T;
-    constructor(value: T);
-    isOk(): this is Ok<T, E>;
-    isErr(): this is Err<E>;
-    map<U>(fn: (value: T) => U): Result<U, E>;
-    flatMap<U, F = E>(fn: (value: T) => Result<U, F>): Result<U, E | F>;
-    mapErr<F>(_fn: (error: E) => F): Result<T, F>;
-    match<U>(handlers: {
-        ok: (value: T) => U;
-        err: (error: E) => U;
-    }): U;
-    unwrap(): T;
-    unwrapOr(_fallback: T): T;
-}
-declare class Err<E> {
-    readonly error: E;
-    constructor(error: E);
-    isOk(): this is Ok<never, E>;
-    isErr(): this is Err<E>;
-    map<U>(_fn: (value: never) => U): Result<U, E>;
-    flatMap<U, F = E>(_fn: (value: never) => Result<U, F>): Result<U, E | F>;
-    mapErr<F>(fn: (error: E) => F): Result<never, F>;
-    match<U>(handlers: {
-        ok: (value: never) => U;
-        err: (error: E) => U;
-    }): U;
-    unwrap(): never;
-    unwrapOr<T>(fallback: T): T;
-}
-export type Result<T, E = Error> = Ok<T, E> | Err<E>;
-export declare const Result: {
-    readonly combine: <T, E>(results: readonly Result<T, E>[]) => Result<T[], E>;
-    readonly err: <E>(error: E) => Err<E>;
-    /**
-     * Wrap a fetch call in a Result, mapping failures to TrailsError subclasses.
-     *
-     * Network errors become NetworkError. Abort signals become CancelledError.
-     * HTTP error status codes map to the appropriate error category.
-     */
-    readonly fromFetch: (input: string | URL | Request, init?: RequestInit) => Promise<Result<Response, Error>>;
-    /**
-     * Parse a JSON string, returning a Result instead of throwing.
-     */
-    readonly fromJson: (json: string) => Result<unknown, ValidationError>;
-    readonly ok: <T = void>(value?: T) => Result<T, never>;
-    /**
-     * Stringify a value to JSON, returning a Result. Handles circular references.
-     */
-    readonly toJson: (value: unknown) => Result<string, InternalError>;
-};
-export {};
-//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

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

package/dist/result.js

@@ -1,156 +0,0 @@
-/**
- * A type-safe Result monad for representing success/failure without exceptions.
- */
-import { InternalError, ValidationError } from './errors.js';
-class Ok {
-    value;
-    constructor(value) {
-        this.value = value;
-    }
-    // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
-    isOk() {
-        return true;
-    }
-    // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
-    isErr() {
-        return false;
-    }
-    map(fn) {
-        return new Ok(fn(this.value));
-    }
-    flatMap(fn) {
-        return fn(this.value);
-    }
-    mapErr(_fn) {
-        return new Ok(this.value);
-    }
-    match(handlers) {
-        return handlers.ok(this.value);
-    }
-    unwrap() {
-        return this.value;
-    }
-    unwrapOr(_fallback) {
-        return this.value;
-    }
-}
-// oxlint-disable-next-line max-classes-per-file -- Result monad requires paired Ok/Err classes
-class Err {
-    error;
-    constructor(error) {
-        this.error = error;
-    }
-    // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
-    isOk() {
-        return false;
-    }
-    // oxlint-disable-next-line class-methods-use-this -- type guard for Result discriminated union
-    isErr() {
-        return true;
-    }
-    map(_fn) {
-        return new Err(this.error);
-    }
-    flatMap(_fn) {
-        return new Err(this.error);
-    }
-    mapErr(fn) {
-        return new Err(fn(this.error));
-    }
-    match(handlers) {
-        return handlers.err(this.error);
-    }
-    unwrap() {
-        throw this.error instanceof Error
-            ? this.error
-            : new Error(String(this.error));
-    }
-    // oxlint-disable-next-line class-methods-use-this -- symmetric API with Ok.unwrapOr
-    unwrapOr(fallback) {
-        return fallback;
-    }
-}
-// eslint-disable-next-line @typescript-eslint/no-namespace
-export const Result = {
-    combine(results) {
-        const values = [];
-        for (const result of results) {
-            if (result.isErr()) {
-                return new Err(result.error);
-            }
-            values.push(result.value);
-        }
-        return new Ok(values);
-    },
-    err(error) {
-        return new Err(error);
-    },
-    /**
-     * Wrap a fetch call in a Result, mapping failures to TrailsError subclasses.
-     *
-     * Network errors become NetworkError. Abort signals become CancelledError.
-     * HTTP error status codes map to the appropriate error category.
-     */
-    async fromFetch(input, init) {
-        // Lazy import avoids a circular dependency (fetch.ts imports Result)
-        const { fromFetch: fetchImpl } = await import('./fetch.js');
-        return fetchImpl(input, init);
-    },
-    /**
-     * Parse a JSON string, returning a Result instead of throwing.
-     */
-    fromJson(json) {
-        try {
-            return new Ok(JSON.parse(json));
-        }
-        catch (error) {
-            return new Err(new ValidationError('Invalid JSON', {
-                cause: error instanceof Error ? error : new Error(String(error)),
-                context: { input: json.slice(0, 200) },
-            }));
-        }
-    },
-    ok(value) {
-        return new Ok(value);
-    },
-    /**
-     * Stringify a value to JSON, returning a Result. Handles circular references.
-     */
-    toJson(value) {
-        try {
-            // Track the current ancestor chain, not every object ever visited.
-            // This allows shared references in a DAG while still detecting cycles.
-            const stack = [];
-            const keys = [];
-            const json = JSON.stringify(value, function json(key, val) {
-                if (stack.length > 0) {
-                    // `this` is the object that contains `key`. Trim the stack back
-                    // to `this` so we only track the current ancestor path.
-                    const thisIndex = stack.lastIndexOf(this);
-                    stack.splice(thisIndex + 1);
-                    keys.splice(thisIndex);
-                }
-                if (typeof val === 'object' && val !== null) {
-                    if (stack.includes(val)) {
-                        return '[Circular]';
-                    }
-                    stack.push(val);
-                    keys.push(key);
-                }
-                return val;
-            });
-            if (json === undefined) {
-                return new Err(new InternalError('Value is not JSON-serializable', {
-                    context: { type: typeof value },
-                }));
-            }
-            return new Ok(json);
-        }
-        catch (error) {
-            return new Err(new InternalError('Failed to stringify value', {
-                cause: error instanceof Error ? error : new Error(String(error)),
-            }));
-        }
-    },
-};
-//# sourceMappingURL=result.js.map

package/dist/result.js.map

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

package/dist/run.d.ts

@@ -1,27 +0,0 @@
-/**
- * Headless trail execution without mounting a trailhead.
- *
- * Looks up a trail by ID in a topo, then delegates to `executeTrail`.
- * Returns a `Result` and never throws.
- */
-import type { Topo } from './topo.js';
-import type { ExecuteTrailOptions } from './execute.js';
-import { Result } from './result.js';
-/** Options forwarded to `executeTrail` from `run`. */
-export type RunOptions = ExecuteTrailOptions;
-/**
- * Execute a trail by ID from a topo without mounting a trailhead.
- *
- * Resolves the trail from the topo, then runs it through the standard
- * `executeTrail` pipeline. Returns `Result.err(NotFoundError)` if the
- * trail ID is not registered. Never throws — unexpected exceptions are
- * returned as `Result.err(InternalError)`.
- *
- * @example
- * ```typescript
- * const result = await run(myTopo, 'greet', { name: 'Alice' });
- * if (result.isOk()) console.log(result.value);
- * ```
- */
-export declare const run: (topo: Topo, id: string, input: unknown, options?: RunOptions) => Promise<Result<unknown, Error>>;
-//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAMrC,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAM7C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,GAAG,GACd,MAAM,IAAI,EACV,IAAI,MAAM,EACV,OAAO,OAAO,EACd,UAAU,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAUhC,CAAC"}

package/dist/run.js

@@ -1,34 +0,0 @@
-/**
- * Headless trail execution without mounting a trailhead.
- *
- * Looks up a trail by ID in a topo, then delegates to `executeTrail`.
- * Returns a `Result` and never throws.
- */
-import { executeTrail } from './execute.js';
-import { NotFoundError } from './errors.js';
-import { Result } from './result.js';
-// ---------------------------------------------------------------------------
-// run()
-// ---------------------------------------------------------------------------
-/**
- * Execute a trail by ID from a topo without mounting a trailhead.
- *
- * Resolves the trail from the topo, then runs it through the standard
- * `executeTrail` pipeline. Returns `Result.err(NotFoundError)` if the
- * trail ID is not registered. Never throws — unexpected exceptions are
- * returned as `Result.err(InternalError)`.
- *
- * @example
- * ```typescript
- * const result = await run(myTopo, 'greet', { name: 'Alice' });
- * if (result.isOk()) console.log(result.value);
- * ```
- */
-export const run = (topo, id, input, options) => {
-    const trail = topo.get(id);
-    if (trail === undefined) {
-        return Promise.resolve(Result.err(new NotFoundError(`Trail "${id}" not found in topo "${topo.name}"`)));
-    }
-    return executeTrail(trail, input, options);
-};
-//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASrC,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,IAAU,EACV,EAAU,EACV,KAAc,EACd,OAAoB,EACa,EAAE;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,OAAO,CACpB,MAAM,CAAC,GAAG,CACR,IAAI,aAAa,CAAC,UAAU,EAAE,wBAAwB,IAAI,CAAC,IAAI,GAAG,CAAC,CACpE,CACF,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC,CAAC"}

package/dist/serialization.d.ts

@@ -1,27 +0,0 @@
-/**
- * Serialization utilities for @ontrails/core
- *
- * Safe JSON parsing/stringifying and error serialization/deserialization
- * for transport across process boundaries.
- */
-import type { ErrorCategory, TrailsError } from './errors.js';
-import { ValidationError, InternalError } from './errors.js';
-import { Result } from './result.js';
-export interface SerializedError {
-    readonly name: string;
-    readonly message: string;
-    readonly category?: ErrorCategory | undefined;
-    readonly retryable?: boolean | undefined;
-    readonly retryAfter?: number | undefined;
-    readonly context?: Record<string, unknown> | undefined;
-    readonly stack?: string | undefined;
-}
-/** Extract structured data from an Error for transport. */
-export declare const serializeError: (error: Error) => SerializedError;
-/** Reconstruct a TrailsError from serialized data. */
-export declare const deserializeError: (data: SerializedError) => TrailsError;
-/** Parse a JSON string, returning a Result instead of throwing. */
-export declare const safeParse: (json: string) => Result<unknown, ValidationError>;
-/** Stringify a value, returning a Result. Handles circular references. */
-export declare const safeStringify: (value: unknown) => Result<string, InternalError>;
-//# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,eAAe,EAUf,aAAa,EAId,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAMrC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAqFD,2DAA2D;AAC3D,eAAO,MAAM,cAAc,GAAI,OAAO,KAAK,KAAG,eAmB7C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,GAAI,MAAM,eAAe,KAAG,WAkBxD,CAAC;AAMF,mEAAmE;AACnE,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,OAAO,EAAE,eAAe,CAWvE,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,aAAa,GACxB,OAAO,OAAO,KACb,MAAM,CAAC,MAAM,EAAE,aAAa,CAwC9B,CAAC"}

package/dist/serialization.js

@@ -1,153 +0,0 @@
-/**
- * Serialization utilities for @ontrails/core
- *
- * Safe JSON parsing/stringifying and error serialization/deserialization
- * for transport across process boundaries.
- */
-import { ValidationError, AmbiguousError, AssertionError, NotFoundError, AlreadyExistsError, ConflictError, PermissionError, TimeoutError, RateLimitError, NetworkError, InternalError, AuthError, CancelledError, isTrailsError, } from './errors.js';
-import { Result } from './result.js';
-// ---------------------------------------------------------------------------
-// Internal helpers (defined before usage)
-// ---------------------------------------------------------------------------
-/** Build options object without including undefined context. */
-const buildOpts = (context) => {
-    if (context !== undefined) {
-        return { context };
-    }
-    return {};
-};
-const errorFactories = {
-    auth: (msg, opts) => new AuthError(msg, opts),
-    cancelled: (msg, opts) => new CancelledError(msg, opts),
-    conflict: (msg, opts) => new ConflictError(msg, opts),
-    internal: (msg, opts) => new InternalError(msg, opts),
-    network: (msg, opts) => new NetworkError(msg, opts),
-    not_found: (msg, opts) => new NotFoundError(msg, opts),
-    permission: (msg, opts) => new PermissionError(msg, opts),
-    rate_limit: (msg, opts, retryAfter) => {
-        const rlOpts = {
-            ...opts,
-        };
-        if (retryAfter !== undefined) {
-            rlOpts.retryAfter = retryAfter;
-        }
-        return new RateLimitError(msg, rlOpts);
-    },
-    timeout: (msg, opts) => new TimeoutError(msg, opts),
-    validation: (msg, opts) => new ValidationError(msg, opts),
-};
-const createErrorByCategory = (category, message, context, retryAfter) => {
-    const opts = buildOpts(context);
-    const factory = errorFactories[category] ?? errorFactories.internal;
-    return factory(message, opts, retryAfter);
-};
-/** Map error class names to their constructors for precise round-tripping. */
-const errorConstructorsByName = {
-    AlreadyExistsError: (msg, opts) => new AlreadyExistsError(msg, opts),
-    AmbiguousError: (msg, opts) => new AmbiguousError(msg, opts),
-    AssertionError: (msg, opts) => new AssertionError(msg, opts),
-    AuthError: (msg, opts) => new AuthError(msg, opts),
-    CancelledError: (msg, opts) => new CancelledError(msg, opts),
-    ConflictError: (msg, opts) => new ConflictError(msg, opts),
-    InternalError: (msg, opts) => new InternalError(msg, opts),
-    NetworkError: (msg, opts) => new NetworkError(msg, opts),
-    NotFoundError: (msg, opts) => new NotFoundError(msg, opts),
-    PermissionError: (msg, opts) => new PermissionError(msg, opts),
-    RateLimitError: (msg, opts, retryAfter) => {
-        const rlOpts = {
-            ...opts,
-        };
-        if (retryAfter !== undefined) {
-            rlOpts.retryAfter = retryAfter;
-        }
-        return new RateLimitError(msg, rlOpts);
-    },
-    TimeoutError: (msg, opts) => new TimeoutError(msg, opts),
-    ValidationError: (msg, opts) => new ValidationError(msg, opts),
-};
-// ---------------------------------------------------------------------------
-// Error serialization
-// ---------------------------------------------------------------------------
-/** Extract structured data from an Error for transport. */
-export const serializeError = (error) => {
-    const result = {
-        message: error.message,
-        name: error.name,
-        stack: error.stack,
-    };
-    if (isTrailsError(error)) {
-        return {
-            ...result,
-            category: error.category,
-            context: error.context,
-            retryAfter: error instanceof RateLimitError ? error.retryAfter : undefined,
-            retryable: error.retryable,
-        };
-    }
-    return result;
-};
-/** Reconstruct a TrailsError from serialized data. */
-export const deserializeError = (data) => {
-    const opts = buildOpts(data.context);
-    const nameFactory = errorConstructorsByName[data.name];
-    const error = nameFactory
-        ? nameFactory(data.message, opts, data.retryAfter)
-        : createErrorByCategory(data.category ?? 'internal', data.message, data.context, data.retryAfter);
-    if (data.stack) {
-        error.stack = data.stack;
-    }
-    return error;
-};
-// ---------------------------------------------------------------------------
-// Safe JSON
-// ---------------------------------------------------------------------------
-/** Parse a JSON string, returning a Result instead of throwing. */
-export const safeParse = (json) => {
-    try {
-        return Result.ok(JSON.parse(json));
-    }
-    catch (error) {
-        return Result.err(new ValidationError('Invalid JSON', {
-            cause: error instanceof Error ? error : new Error(String(error)),
-            context: { input: json.slice(0, 200) },
-        }));
-    }
-};
-/** Stringify a value, returning a Result. Handles circular references. */
-export const safeStringify = (value) => {
-    try {
-        // Track the current ancestor chain, not every object ever visited.
-        // This allows shared references in a DAG while still detecting cycles.
-        const stack = [];
-        const keys = [];
-        const json = JSON.stringify(value, function json(key, val) {
-            if (stack.length > 0) {
-                // `this` is the object that contains `key`. Trim the stack back
-                // to `this` so we only track the current ancestor path.
-                const thisIndex = stack.lastIndexOf(this);
-                stack.splice(thisIndex + 1);
-                keys.splice(thisIndex);
-            }
-            if (typeof val === 'object' && val !== null) {
-                if (stack.includes(val)) {
-                    return '[Circular]';
-                }
-                stack.push(val);
-                keys.push(key);
-            }
-            return val;
-        });
-        if (json === undefined) {
-            return Result.err(new InternalError('Value is not JSON-serializable', {
-                context: { type: typeof value },
-            }));
-        }
-        return Result.ok(json);
-    }
-    catch (error) {
-        return Result.err(new InternalError('Failed to stringify value', {
-            cause: error instanceof Error ? error : new Error(String(error)),
-        }));
-    }
-};
-//# sourceMappingURL=serialization.js.map