@ontrails/core 1.0.0-beta.15 → 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);
-// ---------------------------------------------------------------------------
-// deriveBackoffDelay
-// ---------------------------------------------------------------------------
-/** Compute exponential backoff delay with full jitter. */
-export const deriveBackoffDelay = (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 = deriveBackoffDelay(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/resource-config.d.ts

@@ -1,22 +0,0 @@
-/**
- * Resource resolution pipeline.
- *
- * Extracted from execute.ts to keep both modules under the 400 LOC ceiling.
- * Handles config validation, singleton caching, concurrent-creation dedup,
- * and the full resolve-or-create flow for declared resources.
- */
-import type { ResourceOverrideMap } from './resource.js';
-import type { AnyTrail } from './trail.js';
-import type { TrailContext } from './types.js';
-import { Result } from './result.js';
-type ConfigValues = Readonly<Record<string, Record<string, unknown>>>;
-/**
- * Resolve all declared resources for a trail.
- *
- * Validates per-resource config, checks overrides and caches, and creates
- * new instances as needed. Returns an enriched context with all resource
- * instances injected into extensions.
- */
-export declare const createResources: (trail: AnyTrail, ctx: TrailContext, overrides?: ResourceOverrideMap, configValues?: ConfigValues) => Promise<Result<TrailContext, Error>>;
-export {};
-//# sourceMappingURL=resource-config.d.ts.map

package/dist/resource-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource-config.d.ts","sourceRoot":"","sources":["../src/resource-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAGV,mBAAmB,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC,KAAK,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AA4StE;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,QAAQ,EACf,KAAK,YAAY,EACjB,YAAY,mBAAmB,EAC/B,eAAe,YAAY,KAC1B,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAsBrC,CAAC"}

package/dist/resource-config.js

@@ -1,210 +0,0 @@
-/**
- * Resource resolution pipeline.
- *
- * Extracted from execute.ts to keep both modules under the 400 LOC ceiling.
- * Handles config validation, singleton caching, concurrent-creation dedup,
- * and the full resolve-or-create flow for declared resources.
- */
-import { InternalError, ValidationError } from './errors.js';
-import { Result } from './result.js';
-import { createResourceLookup } from './resource.js';
-// ---------------------------------------------------------------------------
-// Singleton caches
-// ---------------------------------------------------------------------------
-const singletonResources = new WeakMap();
-/** In-flight resource creation promises, keyed by resource x context. */
-const pendingCreations = new WeakMap();
-// ---------------------------------------------------------------------------
-// Context helpers
-// ---------------------------------------------------------------------------
-const toResourceContext = (ctx, config) => ({
-    config,
-    cwd: ctx.cwd,
-    env: ctx.env,
-    workspaceRoot: ctx.workspaceRoot,
-});
-const toResourceContextKey = (ctx) => JSON.stringify({
-    config: ctx.config,
-    cwd: ctx.cwd,
-    env: Object.entries(ctx.env ?? {}).toSorted(([left], [right]) => left.localeCompare(right)),
-    workspaceRoot: ctx.workspaceRoot,
-});
-// ---------------------------------------------------------------------------
-// Config validation
-// ---------------------------------------------------------------------------
-/** Validate and resolve a resource's config from the provided configValues map. */
-const resolveResourceConfig = (declaredResource, configValues) => {
-    if (declaredResource.config === undefined) {
-        return Result.ok();
-    }
-    const raw = configValues?.[declaredResource.id];
-    if (raw === undefined) {
-        return Result.err(new ValidationError(`Resource "${declaredResource.id}" declares a config schema but no config was provided`));
-    }
-    const parsed = declaredResource.config.safeParse(raw);
-    if (!parsed.success) {
-        return Result.err(new ValidationError(`Resource "${declaredResource.id}" config validation failed: ${parsed.error.message}`));
-    }
-    return Result.ok(parsed.data);
-};
-// ---------------------------------------------------------------------------
-// Override / cache lookups
-// ---------------------------------------------------------------------------
-const hasOwnResourceOverride = (overrides, id) => overrides !== undefined && Object.hasOwn(overrides, id);
-const getCachedSingletonResource = (declaredResource, resourceContext) => {
-    const scopedCache = singletonResources.get(declaredResource);
-    if (scopedCache === undefined) {
-        return { found: false, value: undefined };
-    }
-    const key = toResourceContextKey(resourceContext);
-    if (!scopedCache.has(key)) {
-        return { found: false, value: undefined };
-    }
-    return {
-        found: true,
-        value: scopedCache.get(key),
-    };
-};
-const getProvidedResource = (ctx, overrides, declaredResource, resourceContext) => {
-    const { id } = declaredResource;
-    if (hasOwnResourceOverride(overrides, id)) {
-        return Result.ok(overrides[id]);
-    }
-    if (Object.hasOwn(ctx.extensions ?? {}, id)) {
-        return Result.ok(ctx.extensions?.[id]);
-    }
-    const cached = getCachedSingletonResource(declaredResource, resourceContext);
-    if (cached.found) {
-        return Result.ok(cached.value);
-    }
-    return undefined;
-};
-const getOverrideOrExtension = (ctx, overrides, declaredResource) => getProvidedResource(ctx, overrides, declaredResource, toResourceContext(ctx));
-const resolveConfigAwareProvidedResource = (ctx, declaredResource, configValues) => {
-    const configResult = resolveResourceConfig(declaredResource, configValues);
-    if (configResult.isErr()) {
-        return configResult;
-    }
-    const resourceContext = toResourceContext(ctx, configResult.value);
-    const provided = getProvidedResource(ctx, undefined, declaredResource, resourceContext);
-    return provided
-        ? Result.ok({ kind: 'provided', value: provided.unwrap() })
-        : Result.ok({ kind: 'context', resourceContext });
-};
-// ---------------------------------------------------------------------------
-// Instance creation
-// ---------------------------------------------------------------------------
-const toInternalResourceError = (id, error) => {
-    const cause = error instanceof Error ? error : undefined;
-    const message = cause?.message ?? String(error);
-    return new InternalError(`Resource "${id}" failed to resolve: ${message}`, {
-        ...(cause ? { cause } : {}),
-        context: { resourceId: id },
-    });
-};
-const getSingletonResourceCache = (declaredResource) => {
-    const existing = singletonResources.get(declaredResource);
-    if (existing !== undefined) {
-        return existing;
-    }
-    const created = new Map();
-    singletonResources.set(declaredResource, created);
-    return created;
-};
-const doCreateResourceInstance = async (declaredResource, resourceContext) => {
-    try {
-        const created = await declaredResource.create(resourceContext);
-        if (created.isErr()) {
-            return Result.err(created.error);
-        }
-        const instance = created.unwrap();
-        getSingletonResourceCache(declaredResource).set(toResourceContextKey(resourceContext), instance);
-        return Result.ok(instance);
-    }
-    catch (error) {
-        return Result.err(toInternalResourceError(declaredResource.id, error));
-    }
-};
-const trackPendingCreation = (declaredResource, key, promise) => {
-    const pending = pendingCreations.get(declaredResource);
-    if (pending) {
-        pending.set(key, promise);
-    }
-    else {
-        pendingCreations.set(declaredResource, new Map([[key, promise]]));
-    }
-};
-/**
- * Deduplicates concurrent creation of the same resource singleton.
- * If a creation is already in flight for this resource x context key,
- * returns the existing promise instead of spawning a second factory call.
- */
-const createResourceInstance = async (declaredResource, resourceContext) => {
-    const key = toResourceContextKey(resourceContext);
-    const inflight = pendingCreations.get(declaredResource)?.get(key);
-    if (inflight) {
-        return inflight;
-    }
-    const promise = doCreateResourceInstance(declaredResource, resourceContext);
-    trackPendingCreation(declaredResource, key, promise);
-    try {
-        return await promise;
-    }
-    finally {
-        pendingCreations.get(declaredResource)?.delete(key);
-    }
-};
-/** Validate config and resolve a single declared resource. */
-const resolveDeclaredResource = async (declaredResource, ctx, overrides, configValues) => {
-    // Check overrides/extensions first — skip config validation entirely when
-    // a resource instance is already provided.
-    const overrideOrExtension = getOverrideOrExtension(ctx, overrides, declaredResource);
-    if (overrideOrExtension !== undefined) {
-        return overrideOrExtension;
-    }
-    // Resolve config before consulting the singleton cache so config-aware
-    // resources use the same canonical context for cache reads and writes.
-    const configAwareResource = resolveConfigAwareProvidedResource(ctx, declaredResource, configValues);
-    if (configAwareResource.isErr()) {
-        return configAwareResource;
-    }
-    // No provided instance — create via factory.
-    const resolved = configAwareResource.unwrap();
-    if (resolved.kind === 'provided') {
-        return Result.ok(resolved.value);
-    }
-    return await createResourceInstance(declaredResource, resolved.resourceContext);
-};
-// ---------------------------------------------------------------------------
-// Full trail resource resolution
-// ---------------------------------------------------------------------------
-const withResolvedResources = (ctx, resolvedResources) => {
-    const extensions = { ...ctx.extensions, ...resolvedResources };
-    const resolvedCtx = { ...ctx, extensions };
-    const lookup = createResourceLookup(() => resolvedCtx);
-    resolvedCtx.resource = lookup;
-    return resolvedCtx;
-};
-/**
- * Resolve all declared resources for a trail.
- *
- * Validates per-resource config, checks overrides and caches, and creates
- * new instances as needed. Returns an enriched context with all resource
- * instances injected into extensions.
- */
-export const createResources = async (trail, ctx, overrides, configValues) => {
-    const { resources } = trail;
-    if (resources.length === 0) {
-        return Result.ok(ctx);
-    }
-    const resolvedResources = {};
-    for (const declaredResource of resources) {
-        const resolved = await resolveDeclaredResource(declaredResource, ctx, overrides, configValues);
-        if (resolved.isErr()) {
-            return resolved;
-        }
-        resolvedResources[declaredResource.id] = resolved.unwrap();
-    }
-    return Result.ok(withResolvedResources(ctx, resolvedResources));
-};
-//# sourceMappingURL=resource-config.js.map

package/dist/resource-config.js.map

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

package/dist/resource.d.ts

@@ -1,74 +0,0 @@
-import type { Result } from './result.js';
-import type { AnySignal } from './signal.js';
-import type { ResourceLookup, TrailContext } from './types.js';
-import type { z } from 'zod';
-/**
- * Stable process-scoped fields available when constructing a resource.
- *
- * Resources are app-level singletons, so they intentionally do not receive
- * the full per-request TrailContext. When a resource declares a `config` schema,
- * the validated config is passed as `svc.config`.
- */
-export type ResourceContext<C = unknown> = Pick<TrailContext, 'cwd' | 'env' | 'workspaceRoot'> & {
-    readonly config: C;
-};
-/**
- * Everything needed to describe a resource before a factory is introduced.
- *
- * When `config` is a Zod schema, the `create` callback receives
- * `ResourceContext<C>` with the validated config value.
- */
-export interface ResourceSpec<T, C = unknown> {
-    /** Create the resource instance from stable process-scoped context. */
-    readonly create: (svc: ResourceContext<C>) => Result<T, Error> | Promise<Result<T, Error>>;
-    /** Config schema — when present, config is validated and passed to `create`. */
-    readonly config?: z.ZodType<C> | undefined;
-    /** Optional cleanup performed when the hosting trailhead shuts down. */
-    readonly dispose?: ((resource: T) => void | Promise<void>) | undefined;
-    /** Optional operational readiness probe for introspection tooling. */
-    readonly health?: ((resource: T) => Result<unknown, Error> | Promise<Result<unknown, Error>>) | undefined;
-    /** Optional test factory used by higher-level helpers. */
-    readonly mock?: (() => T | Promise<T>) | undefined;
-    /** Human-readable description. */
-    readonly description?: string | undefined;
-    /** Arbitrary meta for tooling and filtering. */
-    readonly meta?: Readonly<Record<string, unknown>> | undefined;
-    /** Signals projected or owned by this resource. */
-    readonly signals?: readonly AnySignal[] | undefined;
-}
-/** A typed resource definition. */
-export interface Resource<T> extends ResourceSpec<T> {
-    readonly kind: 'resource';
-    readonly id: string;
-    /** Read the resolved resource instance from a trail context. */
-    from(ctx: TrailContext): T;
-}
-/**
- * Existential type for heterogeneous resource collections.
- *
- * `Resource<T>` includes function parameters in `dispose`/`health`, so
- * `unknown` is too narrow for mixed resource arrays. `any` is the correct
- * existential here.
- */
-export type AnyResource = Resource<any>;
-/** Explicit runtime overrides keyed by resource ID. */
-export type ResourceOverrideMap = Readonly<Record<string, unknown>>;
-/** Create a `ctx.resource(...)` accessor bound to a concrete context snapshot. */
-export declare const createResourceLookup: (getContext: () => Pick<TrailContext, "extensions">) => ResourceLookup;
-/**
- * Create a typed resource definition.
- *
- * The resource object is inert until a later execution branch resolves concrete
- * instances into TrailContext extensions.
- */
-export declare const resource: <T>(id: string, spec: ResourceSpec<T>) => Resource<T>;
-/** Narrow unknown values to resource definitions during topo discovery. */
-export declare const isResource: (value: unknown) => value is AnyResource;
-/**
- * Return the first duplicate resource ID in a collection, if any.
- *
- * This supports later topo registration without each caller duplicating the
- * same scan logic.
- */
-export declare const findDuplicateResourceId: (resources: readonly Pick<AnyResource, "id">[]) => string | undefined;
-//# sourceMappingURL=resource.d.ts.map

package/dist/resource.d.ts.map

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

package/dist/resource.js

@@ -1,61 +0,0 @@
-import { InternalError } from './errors.js';
-const getResourceId = (resourceOrId) => typeof resourceOrId === 'string' ? resourceOrId : resourceOrId.id;
-const getResourceInstance = (ctx, resourceOrId) => {
-    const id = getResourceId(resourceOrId);
-    return ctx.extensions?.[id];
-};
-const hasResourceInstance = (ctx, resourceOrId) => Object.hasOwn(ctx.extensions ?? {}, getResourceId(resourceOrId));
-/** Create a `ctx.resource(...)` accessor bound to a concrete context snapshot. */
-export const createResourceLookup = (getContext) => ((resourceOrId) => {
-    const id = getResourceId(resourceOrId);
-    const ctx = getContext();
-    if (!hasResourceInstance(ctx, id)) {
-        throw new InternalError(`Resource "${id}" not provisioned in context`);
-    }
-    return getResourceInstance(ctx, id);
-});
-/**
- * Create a typed resource definition.
- *
- * The resource object is inert until a later execution branch resolves concrete
- * instances into TrailContext extensions.
- */
-export const resource = (id, spec) => (() => {
-    if (id.includes(':')) {
-        throw new InternalError(`Resource "${id}" is invalid because resource ids may not contain ":"`);
-    }
-    return Object.freeze({
-        ...spec,
-        from(ctx) {
-            const lookup = ctx.resource ?? createResourceLookup(() => ctx);
-            return lookup(this);
-        },
-        id,
-        kind: 'resource',
-    });
-})();
-/** Narrow unknown values to resource definitions during topo discovery. */
-export const isResource = (value) => {
-    if (typeof value !== 'object' || value === null) {
-        return false;
-    }
-    const v = value;
-    return v.kind === 'resource' && typeof v.id === 'string';
-};
-/**
- * Return the first duplicate resource ID in a collection, if any.
- *
- * This supports later topo registration without each caller duplicating the
- * same scan logic.
- */
-export const findDuplicateResourceId = (resources) => {
-    const seen = new Set();
-    for (const candidate of resources) {
-        if (seen.has(candidate.id)) {
-            return candidate.id;
-        }
-        seen.add(candidate.id);
-    }
-    return undefined;
-};
-//# sourceMappingURL=resource.js.map

package/dist/resource.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource.js","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAwE5C,MAAM,aAAa,GAAG,CACpB,YAA8C,EACtC,EAAE,CACV,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;AAEpE,MAAM,mBAAmB,GAAG,CAC1B,GAAqC,EACrC,YAA8C,EAC3C,EAAE;IACL,MAAM,EAAE,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IACvC,OAAO,GAAG,CAAC,UAAU,EAAE,CAAC,EAAE,CAAM,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAC1B,GAAqC,EACrC,YAA8C,EACrC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;AAE/E,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,UAAkD,EAClC,EAAE,CAClB,CAAC,CAAC,YAA8C,EAAE,EAAE;IAClD,MAAM,EAAE,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,IAAI,CAAC,mBAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,aAAa,CAAC,aAAa,EAAE,8BAA8B,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,mBAAmB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC,CAAmB,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAI,EAAU,EAAE,IAAqB,EAAe,EAAE,CAC5E,CAAC,GAAG,EAAE;IACJ,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,aAAa,CACrB,aAAa,EAAE,uDAAuD,CACvE,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,IAAI;QACP,IAAI,CAAC,GAAiB;YACpB,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,IAAI,oBAAoB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YAC/D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QACD,EAAE;QACF,IAAI,EAAE,UAAmB;KAC1B,CAAC,CAAC;AACL,CAAC,CAAC,EAAE,CAAC;AAEP,2EAA2E;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAwB,EAAE;IACjE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,GAAG,KAAyC,CAAC;IACpD,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC;AAC3D,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,SAA6C,EACzB,EAAE;IACtB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC,EAAE,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

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":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,cAAM,EAAE,CAAC,CAAC,EAAE,CAAC;IACX,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBAEN,KAAK,EAAE,CAAC;IAKpB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAKxB,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IAIvB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAIzC,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAInE,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAI7C,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE;QAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAA;KAAE,GAAG,CAAC;IAIpE,MAAM,IAAI,CAAC;IAIX,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC;CAG1B;AAGD,cAAM,GAAG,CAAC,CAAC;IACT,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBAEN,KAAK,EAAE,CAAC;IAKpB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAK5B,KAAK,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IAIvB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAI9C,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAIxE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAIhD,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE;QAAE,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAA;KAAE,GAAG,CAAC;IAIxE,MAAM,IAAI,KAAK;IAOf,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;CAG5B;AAED,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAGrD,eAAO,MAAM,MAAM;uBACT,CAAC,EAAE,CAAC,WAAW,SAAS,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAG,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;mBAW3D,CAAC,SAAS,CAAC,KAAG,GAAG,CAAC,CAAC,CAAC;IAIxB;;;;;OAKG;gCAEM,MAAM,GAAG,GAAG,GAAG,OAAO,SACtB,WAAW,KACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAMnC;;OAEG;8BACY,MAAM,KAAG,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC;kBAarD,CAAC,iBAAiB,CAAC,KAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC;IAIzC;;OAEG;6BACW,OAAO,KAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;CA0C7C,CAAC"}