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

package/dist/blob-ref.js

@@ -1,22 +0,0 @@
-/**
- * BlobRef — a frozen reference to binary data for @ontrails/core.
- */
-/** Creates a frozen BlobRef. */
-export const createBlobRef = (options) => Object.freeze({
-    data: options.data,
-    mimeType: options.mimeType,
-    name: options.name,
-    size: options.size,
-});
-/** Type guard for BlobRef-shaped values. */
-export const isBlobRef = (value) => {
-    if (typeof value !== 'object' || value === null) {
-        return false;
-    }
-    const obj = value;
-    return (typeof obj['name'] === 'string' &&
-        typeof obj['mimeType'] === 'string' &&
-        typeof obj['size'] === 'number' &&
-        (obj['data'] instanceof Uint8Array || obj['data'] instanceof ReadableStream));
-};
-//# sourceMappingURL=blob-ref.js.map

package/dist/blob-ref.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"blob-ref.js","sourceRoot":"","sources":["../src/blob-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,gCAAgC;AAChC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAK7B,EAAW,EAAE,CACZ,MAAM,CAAC,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,IAAI,EAAE,OAAO,CAAC,IAAI;CACnB,CAAC,CAAC;AAEL,4CAA4C;AAC5C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CACL,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ;QAC/B,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,QAAQ;QACnC,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ;QAC/B,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,UAAU,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,cAAc,CAAC,CAC7E,CAAC;AACJ,CAAC,CAAC"}

package/dist/branded.d.ts

@@ -1,36 +0,0 @@
-/**
- * Branded types and validated constructors for @ontrails/core.
- *
- * Branded types enforce domain constraints at the type level while remaining
- * plain primitives at runtime. Factory functions return Result so callers
- * handle validation failures explicitly.
- */
-import { ValidationError } from './errors.js';
-import type { Result } from './result.js';
-/** Attach a phantom tag to a base type. */
-export type Branded<T, Tag extends string> = T & {
-    readonly __brand: Tag;
-};
-/** Brand a value. No validation — use factory functions for safe construction. */
-export declare const brand: <T, Tag extends string>(_tag: Tag, value: T) => Branded<T, Tag>;
-/** Strip the brand and recover the underlying value. */
-export declare const unbrand: <T>(value: Branded<T, string>) => T;
-export type UUID = Branded<string, 'UUID'>;
-export type Email = Branded<string, 'Email'>;
-export type NonEmptyString = Branded<string, 'NonEmptyString'>;
-export type PositiveInt = Branded<number, 'PositiveInt'>;
-export declare const uuid: (value: string) => Result<UUID, ValidationError>;
-export declare const email: (value: string) => Result<Email, ValidationError>;
-export declare const nonEmptyString: (value: string) => Result<NonEmptyString, ValidationError>;
-export declare const positiveInt: (value: number) => Result<PositiveInt, ValidationError>;
-/**
- * Generate a random alphanumeric ID.
- * Runtime-agnostic: uses `crypto.getRandomValues`.
- */
-export declare const shortId: (length?: number) => string;
-/**
- * Produce a deterministic hex hash from an input string.
- * Uses a simple FNV-1a 32-bit hash — good enough for non-cryptographic IDs.
- */
-export declare const deriveIdHash: (input: string) => string;
-//# sourceMappingURL=branded.d.ts.map

package/dist/branded.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"branded.d.ts","sourceRoot":"","sources":["../src/branded.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAO1C,2CAA2C;AAC3C,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC;AAE3E,kFAAkF;AAClF,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,GAAG,SAAS,MAAM,EACzC,MAAM,GAAG,EACT,OAAO,CAAC,KACP,OAAO,CAAC,CAAC,EAAE,GAAG,CAA6B,CAAC;AAE/C,wDAAwD;AACxD,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,KAAG,CAAe,CAAC;AAMvE,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC7C,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAC/D,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAezD,eAAO,MAAM,IAAI,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,IAAI,EAAE,eAAe,CAShE,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,KAAG,MAAM,CAAC,KAAK,EAAE,eAAe,CASlE,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,KACZ,MAAM,CAAC,cAAc,EAAE,eAAe,CAKxC,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,OAAO,MAAM,KACZ,MAAM,CAAC,WAAW,EAAE,eAAe,CASrC,CAAC;AASF;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,eAAU,KAAG,MAWpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,MAY5C,CAAC"}

package/dist/branded.js

@@ -1,89 +0,0 @@
-/**
- * Branded types and validated constructors for @ontrails/core.
- *
- * Branded types enforce domain constraints at the type level while remaining
- * plain primitives at runtime. Factory functions return Result so callers
- * handle validation failures explicitly.
- */
-import { ValidationError } from './errors.js';
-import { Result as R } from './result.js';
-/** Brand a value. No validation — use factory functions for safe construction. */
-export const brand = (_tag, value) => value;
-/** Strip the brand and recover the underlying value. */
-export const unbrand = (value) => value;
-// ---------------------------------------------------------------------------
-// Validation patterns
-// ---------------------------------------------------------------------------
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-// ---------------------------------------------------------------------------
-// Factory functions — each returns Result<BrandedType, ValidationError>
-// ---------------------------------------------------------------------------
-export const uuid = (value) => {
-    if (!UUID_RE.test(value)) {
-        return R.err(new ValidationError(`Invalid UUID: "${value}"`, {
-            context: { value },
-        }));
-    }
-    return R.ok(value);
-};
-export const email = (value) => {
-    if (!EMAIL_RE.test(value)) {
-        return R.err(new ValidationError(`Invalid email: "${value}"`, {
-            context: { value },
-        }));
-    }
-    return R.ok(value);
-};
-export const nonEmptyString = (value) => {
-    if (value.length === 0) {
-        return R.err(new ValidationError('String must not be empty'));
-    }
-    return R.ok(value);
-};
-export const positiveInt = (value) => {
-    if (!Number.isInteger(value) || value <= 0) {
-        return R.err(new ValidationError(`Expected positive integer, got ${value}`, {
-            context: { value },
-        }));
-    }
-    return R.ok(value);
-};
-// ---------------------------------------------------------------------------
-// ID utilities
-// ---------------------------------------------------------------------------
-const ALPHANUMERIC = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
-/**
- * Generate a random alphanumeric ID.
- * Runtime-agnostic: uses `crypto.getRandomValues`.
- */
-export const shortId = (length = 8) => {
-    const bytes = new Uint8Array(length);
-    crypto.getRandomValues(bytes);
-    let id = '';
-    for (let i = 0; i < length; i += 1) {
-        const byte = bytes[i];
-        if (byte !== undefined) {
-            id += ALPHANUMERIC[byte % ALPHANUMERIC.length];
-        }
-    }
-    return id;
-};
-/**
- * Produce a deterministic hex hash from an input string.
- * Uses a simple FNV-1a 32-bit hash — good enough for non-cryptographic IDs.
- */
-export const deriveIdHash = (input) => {
-    // FNV offset basis
-    let hash = 2_166_136_261;
-    for (let i = 0; i < input.length; i += 1) {
-        // oxlint-disable-next-line no-bitwise -- FNV-1a hash requires XOR
-        hash ^= input.codePointAt(i) ?? 0;
-        // FNV prime
-        hash = Math.imul(hash, 0x01_00_01_93);
-    }
-    // Convert to unsigned 32-bit then hex
-    // oxlint-disable-next-line no-bitwise, prefer-math-trunc -- unsigned right shift needed for u32 conversion (Math.trunc differs semantically)
-    return (hash >>> 0).toString(16).padStart(8, '0');
-};
-//# sourceMappingURL=branded.js.map

package/dist/branded.js.map

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

package/dist/collections.d.ts

@@ -1,31 +0,0 @@
-/**
- * Collection utilities and type helpers for @ontrails/core.
- */
-/** Recursively make every property optional. */
-export type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
-};
-/** Flatten an intersection into a single object type for better IDE display. */
-export type Prettify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-/** Require at least one property from T. */
-export type AtLeastOne<T> = {
-    [K in keyof T]-?: Pick<T, K> & Partial<Omit<T, K>>;
-}[keyof T];
-/** A tuple with at least one element. */
-export type NonEmptyArray<T> = [T, ...T[]];
-/** Narrows a readonly array to a NonEmptyArray. */
-export declare const isNonEmptyArray: <T>(array: readonly T[]) => array is NonEmptyArray<T>;
-/** Split an array into chunks of at most `size` elements. */
-export declare const chunk: <T>(array: readonly T[], size: number) => T[][];
-/**
- * Remove duplicate items. When `key` is provided, uniqueness is determined
- * by the return value of the key function; otherwise strict equality is used.
- */
-export declare const dedupe: <T>(array: readonly T[], key?: (item: T) => unknown) => T[];
-/** Group items by a string key. */
-export declare const groupBy: <T>(array: readonly T[], key: (item: T) => string) => Record<string, T[]>;
-/** Return a new sorted array based on a key function (ascending). */
-export declare const sortBy: <T>(array: readonly T[], key: (item: T) => string | number) => T[];
-//# sourceMappingURL=collections.d.ts.map

package/dist/collections.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,gDAAgD;AAChD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAChE,CAAC;AAEF,gFAAgF;AAEhF,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAExD,4CAA4C;AAC5C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KACzB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACnD,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,yCAAyC;AACzC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAM3C,mDAAmD;AACnD,eAAO,MAAM,eAAe,GAAI,CAAC,EAC/B,OAAO,SAAS,CAAC,EAAE,KAClB,KAAK,IAAI,aAAa,CAAC,CAAC,CAAqB,CAAC;AAMjD,6DAA6D;AAC7D,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,OAAO,SAAS,CAAC,EAAE,EAAE,MAAM,MAAM,KAAG,CAAC,EAAE,EAS/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EACtB,OAAO,SAAS,CAAC,EAAE,EACnB,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,KACzB,CAAC,EAcH,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,OAAO,GAAI,CAAC,EACvB,OAAO,SAAS,CAAC,EAAE,EACnB,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,KACvB,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAOpB,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,MAAM,GAAI,CAAC,EACtB,OAAO,SAAS,CAAC,EAAE,EACnB,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,KAChC,CAAC,EAQA,CAAC"}

package/dist/collections.js

@@ -1,60 +0,0 @@
-/**
- * Collection utilities and type helpers for @ontrails/core.
- */
-// ---------------------------------------------------------------------------
-// Guards
-// ---------------------------------------------------------------------------
-/** Narrows a readonly array to a NonEmptyArray. */
-export const isNonEmptyArray = (array) => array.length > 0;
-// ---------------------------------------------------------------------------
-// Collection functions
-// ---------------------------------------------------------------------------
-/** Split an array into chunks of at most `size` elements. */
-export const chunk = (array, size) => {
-    if (size < 1) {
-        throw new RangeError('chunk size must be >= 1');
-    }
-    const result = [];
-    for (let i = 0; i < array.length; i += size) {
-        result.push(array.slice(i, i + size));
-    }
-    return result;
-};
-/**
- * Remove duplicate items. When `key` is provided, uniqueness is determined
- * by the return value of the key function; otherwise strict equality is used.
- */
-export const dedupe = (array, key) => {
-    if (!key) {
-        return [...new Set(array)];
-    }
-    const seen = new Set();
-    const result = [];
-    for (const item of array) {
-        const k = key(item);
-        if (!seen.has(k)) {
-            seen.add(k);
-            result.push(item);
-        }
-    }
-    return result;
-};
-/** Group items by a string key. */
-export const groupBy = (array, key) => {
-    const groups = {};
-    for (const item of array) {
-        const k = key(item);
-        (groups[k] ??= []).push(item);
-    }
-    return groups;
-};
-/** Return a new sorted array based on a key function (ascending). */
-export const sortBy = (array, key) => [...array].toSorted((a, b) => {
-    const ka = key(a);
-    const kb = key(b);
-    if (typeof ka === 'number' && typeof kb === 'number') {
-        return ka - kb;
-    }
-    return String(ka).localeCompare(String(kb));
-});
-//# sourceMappingURL=collections.js.map

package/dist/collections.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"collections.js","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuBH,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAmB,EACQ,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAEjD,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,KAAmB,EAAE,IAAY,EAAS,EAAE;IACnE,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,yBAAyB,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,KAAmB,EACnB,GAA0B,EACrB,EAAE;IACP,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,mCAAmC;AACnC,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,KAAmB,EACnB,GAAwB,EACH,EAAE;IACvB,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,KAAmB,EACnB,GAAiC,EAC5B,EAAE,CACP,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;IAC3B,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAClB,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QACrD,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC"}

package/dist/context.d.ts

@@ -1,22 +0,0 @@
-import type { TrailContext, TrailContextInit, TraceFn } from './types.js';
-/**
- * Default passthrough `trace` used when a context is built outside
- * `executeTrail`. `executeTrail` replaces this with a real sink-writing
- * implementation. The passthrough runs `fn` without recording anything so
- * direct `createTrailContext()` callers (tests, ad-hoc compositions) don't
- * crash when invoking `ctx.trace(...)`.
- *
- * Declared `async` so both synchronous throws and async rejections from `fn`
- * propagate as a rejected promise to the caller — matching the real
- * sink-writing implementation's error semantics.
- */
-export declare const passthroughTrace: TraceFn;
-/**
- * Create a TrailContext with sensible defaults.
- *
- * - `requestId` defaults to `Bun.randomUUIDv7()` (sortable v7 UUID)
- * - `abortSignal` defaults to a fresh, non-aborted `AbortSignal`
- * - All other fields come from `overrides`
- */
-export declare const createTrailContext: (overrides?: Partial<TrailContextInit>) => TrailContext;
-//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAM1E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAGJ,CAAC;AAE5B;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,OAAO,CAAC,gBAAgB,CAAC,KACpC,YAeF,CAAC"}

package/dist/context.js

@@ -1,37 +0,0 @@
-import { createResourceLookup } from './resource.js';
-/**
- * Default passthrough `trace` used when a context is built outside
- * `executeTrail`. `executeTrail` replaces this with a real sink-writing
- * implementation. The passthrough runs `fn` without recording anything so
- * direct `createTrailContext()` callers (tests, ad-hoc compositions) don't
- * crash when invoking `ctx.trace(...)`.
- *
- * Declared `async` so both synchronous throws and async rejections from `fn`
- * propagate as a rejected promise to the caller — matching the real
- * sink-writing implementation's error semantics.
- */
-export const passthroughTrace = async (_label, fn) => await fn();
-/**
- * Create a TrailContext with sensible defaults.
- *
- * - `requestId` defaults to `Bun.randomUUIDv7()` (sortable v7 UUID)
- * - `abortSignal` defaults to a fresh, non-aborted `AbortSignal`
- * - All other fields come from `overrides`
- */
-export const createTrailContext = (overrides) => {
-    const ctx = {
-        abortSignal: new AbortController().signal,
-        cwd: process.cwd(),
-        env: process.env,
-        requestId: Bun.randomUUIDv7(),
-        trace: passthroughTrace,
-        ...overrides,
-    };
-    const lookup = overrides?.resource ?? createResourceLookup(() => ctx);
-    ctx.resource = lookup;
-    if (ctx.trace === undefined) {
-        ctx.trace = passthroughTrace;
-    }
-    return ctx;
-};
-//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAOrD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAY,KAAK,EAC5C,MAAc,EACd,EAAwB,EACZ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,SAAqC,EACvB,EAAE;IAChB,MAAM,GAAG,GAAG;QACV,WAAW,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM;QACzC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE,OAAO,CAAC,GAAyC;QACtD,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE;QAC7B,KAAK,EAAE,gBAAgB;QACvB,GAAG,SAAS;KACU,CAAC;IACzB,MAAM,MAAM,GAAG,SAAS,EAAE,QAAQ,IAAI,oBAAoB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;IACtE,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC;IACtB,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5B,GAAG,CAAC,KAAK,GAAG,gBAAgB,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC"}

package/dist/contour.d.ts

@@ -1,81 +0,0 @@
-import { z } from 'zod';
-import type { Branded } from './branded.js';
-/**
- * Runtime options for a contour declaration.
- */
-export interface ContourOptions<TShape extends z.ZodRawShape, TIdentity extends keyof TShape & string> {
-    /** Field name that acts as the contour's primary identity. */
-    readonly identity: TIdentity;
-    /** Example instances validated against the contour schema at declaration time. */
-    readonly examples?: readonly z.output<z.ZodObject<TShape>>[] | undefined;
-}
-/** Type-level brand name applied to a contour's identity schema. */
-export type ContourIdBrand<TName extends string> = `${Capitalize<TName>}Id`;
-type BrandedSchema<TSchema extends z.core.$ZodType, TBrand extends string> = TSchema & z.ZodType<Branded<z.output<TSchema>, TBrand>>;
-/** Output value of a branded contour identity schema. */
-export type ContourIdValue<TSchema extends z.core.$ZodType, TName extends string> = Branded<z.output<TSchema>, ContourIdBrand<TName>>;
-/** Runtime metadata attached to schemas returned from `contour.id()`. */
-export interface ContourIdMetadata<TName extends string = string, TIdentity extends string = string> {
-    readonly contour: TName;
-    readonly identity: TIdentity;
-}
-/** A structural contour reference declared by another contour field schema. */
-export interface ContourReference<TName extends string = string, TIdentity extends string = string> extends ContourIdMetadata<TName, TIdentity> {
-    readonly field: string;
-}
-/** Symbol used to tag branded contour reference schemas at runtime. */
-export declare const CONTOUR_ID_METADATA: unique symbol;
-/**
- * A contour identity schema branded for one contour and tagged with runtime
- * metadata so the topo layer can recognize declared references later on.
- */
-export type ContourIdSchema<TSchema extends z.core.$ZodType = z.core.$ZodType, TName extends string = string, TIdentity extends string = string> = BrandedSchema<TSchema, ContourIdBrand<TName>> & {
-    /** @deprecated Use `getContourIdMetadata()` — metadata lives in a WeakMap, not on the schema. */
-    readonly [CONTOUR_ID_METADATA]?: ContourIdMetadata<TName, TIdentity>;
-};
-/**
- * A first-class domain object with schema, identity metadata, and examples.
- *
- * A contour behaves like the `ZodObject` it wraps, so standard Zod composition
- * helpers such as `.pick()`, `.extend()`, and `.array()` continue to work.
- */
-export type Contour<TName extends string = string, TShape extends z.ZodRawShape = z.ZodRawShape, TIdentity extends keyof TShape & string = keyof TShape & string> = z.ZodObject<TShape> & {
-    readonly kind: 'contour';
-    readonly name: TName;
-    readonly identity: TIdentity;
-    readonly identitySchema: TShape[TIdentity];
-    readonly id: () => ContourIdSchema<TShape[TIdentity], TName, TIdentity>;
-    readonly examples?: readonly z.output<z.ZodObject<TShape>>[] | undefined;
-};
-/**
- * Read contour-reference metadata from a schema returned by `contour.id()`.
- *
- * When the schema is wrapped by Zod combinators (`.optional()`, `.nullable()`,
- * `.default()`, `.nullish()`, etc.) the `CONTOUR_ID_METADATA` symbol lives on
- * the inner schema, not on the wrapper. The unwrap handles arbitrarily nested
- * wrapper levels.
- */
-export declare const getContourIdMetadata: (schema: unknown) => ContourIdMetadata | undefined;
-/** Inspect a contour schema for fields that reference other contours via `.id()`. */
-export declare const getContourReferences: (contour: AnyContour) => readonly ContourReference[];
-/**
- * Create a contour definition from a raw Zod object shape.
- *
- * @example
- * ```typescript
- * const user = contour(
- *   'user',
- *   {
- *     id: z.string().uuid(),
- *     email: z.string().email(),
- *     name: z.string(),
- *   },
- *   { identity: 'id' }
- * );
- * ```
- */
-export declare const contour: <TName extends string, TShape extends z.ZodRawShape, TIdentity extends keyof TShape & string>(name: TName, shape: TShape, options: ContourOptions<TShape, TIdentity>) => Contour<TName, TShape, TIdentity>;
-/** Existential type for heterogeneous contour collections. */
-export type AnyContour = Contour<string, z.ZodRawShape, string>;
-export {};
-//# sourceMappingURL=contour.d.ts.map

package/dist/contour.d.ts.map

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

package/dist/contour.js

@@ -1,176 +0,0 @@
-import { z } from 'zod';
-/** Symbol used to tag branded contour reference schemas at runtime. */
-export const CONTOUR_ID_METADATA = Symbol.for('@ontrails/core/contour-id');
-/**
- * Module-level WeakMap storing contour identity metadata keyed by schema object.
- *
- * First-write-wins: when multiple contours share the same underlying schema
- * (e.g. `contour('admin', { id: user.shape.id }, ...)`), the first contour to
- * brand the schema claims it. Subsequent calls skip the write to prevent
- * silent metadata corruption.
- */
-const contourIdMetadata = new WeakMap();
-const formatExampleIssues = (issues) => issues
-    .map((issue) => {
-    const path = issue.path.length > 0 ? issue.path.join('.') : '<root>';
-    return `${path}: ${issue.message}`;
-})
-    .join('; ');
-const assertIdentityField = (name, shape, identity) => {
-    if (!Object.hasOwn(shape, identity)) {
-        throw new TypeError(`contour("${name}") identity "${identity}" must match a declared field`);
-    }
-};
-const assertExamples = (name, schema, examples) => {
-    for (const [index, example] of examples.entries()) {
-        const parsed = schema.safeParse(example);
-        if (!parsed.success) {
-            throw new TypeError(`contour("${name}") example ${index} is invalid: ${formatExampleIssues(parsed.error.issues)}`);
-        }
-    }
-};
-const validateExamples = (name, schema, examples) => {
-    if (examples) {
-        assertExamples(name, schema, examples);
-    }
-};
-const brandIdentitySchema = (contour, identity, schema) => {
-    const branded = schema.brand();
-    // First-write-wins: if another contour already claimed this schema object
-    // (possible when Zod v4 brand() returns `this`), preserve the original
-    // metadata rather than silently overwriting it.
-    if (!contourIdMetadata.has(branded)) {
-        contourIdMetadata.set(branded, {
-            contour,
-            identity,
-        });
-    }
-    return branded;
-};
-const attachContourMetadata = (schema, metadata) => {
-    Object.defineProperties(schema, {
-        examples: {
-            enumerable: true,
-            value: metadata.examples,
-            writable: false,
-        },
-        id: {
-            enumerable: true,
-            value: () => metadata.idSchema,
-            writable: false,
-        },
-        identity: {
-            enumerable: true,
-            value: metadata.identity,
-            writable: false,
-        },
-        identitySchema: {
-            enumerable: true,
-            value: metadata.identitySchema,
-            writable: false,
-        },
-        kind: {
-            enumerable: true,
-            value: 'contour',
-            writable: false,
-        },
-        name: {
-            enumerable: true,
-            value: metadata.name,
-            writable: false,
-        },
-    });
-};
-/** Read contour identity metadata from the module-level WeakMap, if present. */
-const readMetadata = (schema) => typeof schema === 'object' && schema !== null
-    ? contourIdMetadata.get(schema)
-    : undefined;
-/** Resolve the inner schema from a Zod wrapper (ZodOptional, ZodNullable, etc.). */
-const unwrapInner = (schema) => {
-    const def = schema._def;
-    return (def?.['innerType'] ?? def?.['schema']);
-};
-/**
- * Walk through Zod wrapper layers searching for `CONTOUR_ID_METADATA`.
- *
- * `.nullish()` produces `ZodOptional<ZodNullable<T>>` — two wrapper levels —
- * so a single-step unwrap is insufficient. This iterates until it finds the
- * metadata or exhausts all wrapper layers.
- */
-const unwrapToMetadata = (schema) => {
-    let current = schema;
-    while (typeof current === 'object' && current !== null) {
-        const inner = unwrapInner(current);
-        if (typeof inner !== 'object' || inner === null) {
-            return undefined;
-        }
-        const metadata = readMetadata(inner);
-        if (metadata !== undefined) {
-            return metadata;
-        }
-        current = inner;
-    }
-    return undefined;
-};
-/**
- * Read contour-reference metadata from a schema returned by `contour.id()`.
- *
- * When the schema is wrapped by Zod combinators (`.optional()`, `.nullable()`,
- * `.default()`, `.nullish()`, etc.) the `CONTOUR_ID_METADATA` symbol lives on
- * the inner schema, not on the wrapper. The unwrap handles arbitrarily nested
- * wrapper levels.
- */
-export const getContourIdMetadata = (schema) => readMetadata(schema) ?? unwrapToMetadata(schema);
-/** Inspect a contour schema for fields that reference other contours via `.id()`. */
-export const getContourReferences = (contour) => Object.entries(contour.shape)
-    .flatMap(([field, schema]) => {
-    if (field === contour.identity) {
-        return [];
-    }
-    const metadata = getContourIdMetadata(schema);
-    if (metadata === undefined) {
-        return [];
-    }
-    return [{ field, ...metadata }];
-})
-    .toSorted((left, right) => left.field === right.field
-    ? left.contour.localeCompare(right.contour)
-    : left.field.localeCompare(right.field));
-/**
- * Create a contour definition from a raw Zod object shape.
- *
- * @example
- * ```typescript
- * const user = contour(
- *   'user',
- *   {
- *     id: z.string().uuid(),
- *     email: z.string().email(),
- *     name: z.string(),
- *   },
- *   { identity: 'id' }
- * );
- * ```
- */
-export const contour = (name, shape, options) => {
-    assertIdentityField(name, shape, options.identity);
-    const schema = z.object(shape);
-    validateExamples(name, schema, options.examples);
-    const identitySchema = shape[options.identity];
-    if (!identitySchema) {
-        throw new TypeError(`contour("${name}") identity "${options.identity}" must resolve to a schema`);
-    }
-    const idSchema = brandIdentitySchema(name, options.identity, identitySchema);
-    const examples = options.examples
-        ? Object.freeze([...options.examples])
-        : undefined;
-    attachContourMetadata(schema, {
-        examples,
-        idSchema,
-        identity: options.identity,
-        identitySchema,
-        name,
-    });
-    return schema;
-};
-//# sourceMappingURL=contour.js.map

package/dist/contour.js.map

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

package/dist/cross-schema.d.ts

@@ -1,18 +0,0 @@
-/**
- * Cross-invocation schema merging for trails with `crossInput`.
- *
- * When a trail declares `crossInput`, callers via `ctx.cross()` pass both
- * public input and composition-only fields. The merged schema validates the
- * combined shape so `executeTrail` doesn't reject the extra fields.
- */
-import { z } from 'zod';
-import type { AnyTrail } from './trail.js';
-/**
- * Build the validation schema for a cross-invoked trail.
- *
- * When the target trail declares `crossInput`, returns the intersection of
- * `trail.input` and `trail.crossInput`. Returns `undefined` when no
- * `crossInput` is declared, signaling that normal input validation suffices.
- */
-export declare const buildCrossValidationSchema: (trailDef: AnyTrail) => z.ZodType | undefined;
-//# sourceMappingURL=cross-schema.d.ts.map

package/dist/cross-schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cross-schema.d.ts","sourceRoot":"","sources":["../src/cross-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,QAAQ,KACjB,CAAC,CAAC,OAAO,GAAG,SAcd,CAAC"}