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

package/dist/internal/tracing.d.ts

@@ -1,98 +0,0 @@
-/**
- * Intrinsic tracing primitives.
- *
- * This module is the home for the trace record type, the sink interface,
- * the sink registry, and the helpers `executeTrail` uses to create root
- * trace records and child spans. It is intentionally framework-internal —
- * the `@ontrails/tracing` package re-exports the public surface so callers
- * can continue to import from there.
- *
- * Tracing is intrinsic: every `executeTrail` call automatically produces a
- * root `TraceRecord`, and `ctx.trace(label, fn)` creates nested child spans
- * underneath it. A default no-op sink is installed at module load so core
- * never crashes when no real sink has been registered.
- */
-/** Evidence of a single trail execution or manual span. */
-export interface TraceRecord {
-    readonly id: string;
-    readonly traceId: string;
-    readonly rootId: string;
-    readonly parentId?: string | undefined;
-    readonly kind: 'trail' | 'span';
-    readonly name: string;
-    readonly trailId?: string | undefined;
-    readonly trailhead?: 'cli' | 'mcp' | 'http' | 'ws' | undefined;
-    readonly intent?: 'read' | 'write' | 'destroy' | undefined;
-    readonly startedAt: number;
-    readonly endedAt?: number | undefined;
-    readonly status: 'ok' | 'err' | 'cancelled';
-    readonly errorCategory?: string | undefined;
-    readonly permit?: {
-        readonly id: string;
-        readonly tenantId?: string;
-    } | undefined;
-    readonly attrs: Readonly<Record<string, unknown>>;
-}
-/**
- * Minimal shape a tracing sink must satisfy.
- *
- * Kept intentionally tiny so adapters in `@ontrails/tracing`,
- * `@ontrails/observe`, and user code can all satisfy it without
- * additional dependencies.
- */
-export interface TraceSink {
-    readonly write: (record: TraceRecord) => void | Promise<void>;
-}
-/** Trace context carried through trail execution via `ctx.extensions`. */
-export interface TraceContext {
-    readonly traceId: string;
-    readonly spanId: string;
-    readonly rootId: string;
-    readonly sampled: boolean;
-}
-/** Key used to store trace context in `ctx.extensions`. */
-export declare const TRACE_CONTEXT_KEY = "__trace_context";
-/** Read trace context from trail context extensions. */
-export declare const getTraceContext: (ctx: {
-    readonly extensions?: Readonly<Record<string, unknown>> | undefined;
-}) => TraceContext | undefined;
-/** No-op sink installed by default so core never crashes without configuration. */
-export declare const NOOP_SINK: TraceSink;
-/**
- * Register a trace sink globally.
- *
- * All trails executed via `executeTrail` will write their completed trace
- * records to this sink, as will every `ctx.trace(label, fn)` child span.
- * Registering `undefined` or calling {@link clearTraceSink} resets back to
- * the default no-op sink.
- */
-export declare const registerTraceSink: (sink: TraceSink | undefined) => void;
-/** Retrieve the currently registered sink (never undefined). */
-export declare const getTraceSink: () => TraceSink;
-/** True when tracing is effectively disabled and executeTrail should skip allocation. */
-export declare const isTracingDisabled: (sink?: TraceSink) => boolean;
-/** Reset the sink registry back to the default no-op sink. */
-export declare const clearTraceSink: () => void;
-/** Options for creating a trail-scoped {@link TraceRecord}. */
-interface CreateTraceRecordOptions {
-    readonly trailId: string;
-    readonly traceId?: string | undefined;
-    readonly parentId?: string | undefined;
-    readonly rootId?: string | undefined;
-    readonly trailhead?: TraceRecord['trailhead'];
-    readonly intent?: TraceRecord['intent'];
-    readonly permit?: {
-        readonly id: string;
-        readonly tenantId?: string;
-    } | undefined;
-}
-/** Create a fresh trail-kind {@link TraceRecord}. */
-export declare const createTraceRecord: (options: CreateTraceRecordOptions) => TraceRecord;
-/** Build a span record from a parent trace context. */
-export declare const createSpanRecord: (parent: TraceContext, label: string) => TraceRecord;
-/** Mark a record as completed with timing and status. */
-export declare const completeRecord: (record: TraceRecord, status: TraceRecord["status"], errorCategory?: string | undefined) => TraceRecord;
-/** Best-effort sink write that never throws. */
-export declare const writeToSink: (sink: TraceSink, record: TraceRecord) => Promise<void>;
-export {};
-//# sourceMappingURL=tracing.d.ts.map

package/dist/internal/tracing.d.ts.map

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

package/dist/internal/tracing.js

@@ -1,102 +0,0 @@
-/**
- * Intrinsic tracing primitives.
- *
- * This module is the home for the trace record type, the sink interface,
- * the sink registry, and the helpers `executeTrail` uses to create root
- * trace records and child spans. It is intentionally framework-internal —
- * the `@ontrails/tracing` package re-exports the public surface so callers
- * can continue to import from there.
- *
- * Tracing is intrinsic: every `executeTrail` call automatically produces a
- * root `TraceRecord`, and `ctx.trace(label, fn)` creates nested child spans
- * underneath it. A default no-op sink is installed at module load so core
- * never crashes when no real sink has been registered.
- */
-/** Key used to store trace context in `ctx.extensions`. */
-export const TRACE_CONTEXT_KEY = '__trace_context';
-/** Read trace context from trail context extensions. */
-export const getTraceContext = (ctx) => ctx.extensions?.[TRACE_CONTEXT_KEY];
-// ---------------------------------------------------------------------------
-// Default no-op sink + sink registry
-// ---------------------------------------------------------------------------
-/** No-op sink installed by default so core never crashes without configuration. */
-export const NOOP_SINK = {
-    // oxlint-disable-next-line no-empty-function -- intentional no-op
-    write: () => { },
-};
-// oxlint-disable-next-line eslint-plugin-jest/require-hook -- module-level sink registry, not test setup
-let currentSink = NOOP_SINK;
-/**
- * Register a trace sink globally.
- *
- * All trails executed via `executeTrail` will write their completed trace
- * records to this sink, as will every `ctx.trace(label, fn)` child span.
- * Registering `undefined` or calling {@link clearTraceSink} resets back to
- * the default no-op sink.
- */
-export const registerTraceSink = (sink) => {
-    currentSink = sink ?? NOOP_SINK;
-};
-/** Retrieve the currently registered sink (never undefined). */
-export const getTraceSink = () => currentSink;
-/** True when tracing is effectively disabled and executeTrail should skip allocation. */
-export const isTracingDisabled = (sink = currentSink) => sink === NOOP_SINK;
-/** Reset the sink registry back to the default no-op sink. */
-export const clearTraceSink = () => {
-    currentSink = NOOP_SINK;
-};
-/** Create a fresh trail-kind {@link TraceRecord}. */
-export const createTraceRecord = (options) => {
-    const id = Bun.randomUUIDv7();
-    const traceId = options.traceId ?? Bun.randomUUIDv7();
-    return {
-        attrs: {},
-        endedAt: undefined,
-        id,
-        intent: options.intent,
-        kind: 'trail',
-        name: options.trailId,
-        parentId: options.parentId,
-        permit: options.permit,
-        rootId: options.rootId ?? id,
-        startedAt: Date.now(),
-        status: 'ok',
-        traceId,
-        trailId: options.trailId,
-        trailhead: options.trailhead,
-    };
-};
-/** Build a span record from a parent trace context. */
-export const createSpanRecord = (parent, label) => ({
-    attrs: {},
-    endedAt: undefined,
-    errorCategory: undefined,
-    id: Bun.randomUUIDv7(),
-    intent: undefined,
-    kind: 'span',
-    name: label,
-    parentId: parent.spanId,
-    rootId: parent.rootId,
-    startedAt: Date.now(),
-    status: 'ok',
-    traceId: parent.traceId,
-    trailId: undefined,
-    trailhead: undefined,
-});
-/** Mark a record as completed with timing and status. */
-export const completeRecord = (record, status, errorCategory) => ({
-    ...record,
-    endedAt: Date.now(),
-    errorCategory,
-    status,
-});
-/** Best-effort sink write that never throws. */
-export const writeToSink = async (sink, record) => {
-    try {
-        await Promise.resolve(sink.write(record));
-    }
-    catch {
-        // Sink failures must never affect trail result delivery.
-    }
-};
-//# sourceMappingURL=tracing.js.map

package/dist/internal/tracing.js.map

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

package/dist/internal/trails-db.d.ts

@@ -1,16 +0,0 @@
-import { Database } from 'bun:sqlite';
-export interface TrailsDbLocationOptions {
-    readonly path?: string;
-    readonly rootDir?: string;
-}
-export interface EnsureSubsystemSchemaOptions {
-    readonly migrate: (currentVersion: number) => void;
-    readonly subsystem: string;
-    readonly version: number;
-}
-export declare const deriveTrailsDir: (options?: TrailsDbLocationOptions) => string;
-export declare const deriveTrailsDbPath: (options?: TrailsDbLocationOptions) => string;
-export declare const openWriteTrailsDb: (options?: TrailsDbLocationOptions) => Database;
-export declare const openReadTrailsDb: (options?: TrailsDbLocationOptions) => Database;
-export declare const ensureSubsystemSchema: (db: Database, options: EnsureSubsystemSchemaOptions) => void;
-//# sourceMappingURL=trails-db.d.ts.map

package/dist/internal/trails-db.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trails-db.d.ts","sourceRoot":"","sources":["../../src/internal/trails-db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA2BtC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AASD,eAAO,MAAM,eAAe,GAAI,UAAU,uBAAuB,KAAG,MACjB,CAAC;AAEpD,eAAO,MAAM,kBAAkB,GAAI,UAAU,uBAAuB,KAAG,MAGnB,CAAC;AAsFrD,eAAO,MAAM,iBAAiB,GAC5B,UAAU,uBAAuB,KAChC,QAgBF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,uBAAuB,KAChC,QAUF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,IAAI,QAAQ,EACZ,SAAS,4BAA4B,KACpC,IAYF,CAAC"}

package/dist/internal/trails-db.js

@@ -1,118 +0,0 @@
-import { Database } from 'bun:sqlite';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { NotFoundError } from '../errors.js';
-const TRAILS_DIR = '.trails';
-const TRAILS_DB_FILE = 'trails.db';
-const SCHEMA_VERSION_TABLE = 'meta_schema_versions';
-const WORKSPACE_SUBDIRS = ['config', 'dev', 'generated'];
-const REQUIRED_GITIGNORE_LINES = [
-    '# Local config overrides',
-    'config/',
-    '',
-    '# Development state',
-    'dev/',
-    '',
-    '# Generated artifacts',
-    'generated/',
-    '',
-    '# Shared Trails database',
-    'trails.db',
-    'trails.db-shm',
-    'trails.db-wal',
-    '',
-];
-const deriveRootDir = (rootDir) => resolve(rootDir ?? process.cwd());
-export const deriveTrailsDir = (options) => join(deriveRootDir(options?.rootDir), TRAILS_DIR);
-export const deriveTrailsDbPath = (options) => options?.path
-    ? resolve(options.path)
-    : join(deriveTrailsDir(options), TRAILS_DB_FILE);
-const ensureDbParentDir = (dbPath) => {
-    mkdirSync(dirname(dbPath), { recursive: true });
-};
-const GITIGNORE_TEMPLATE = `${REQUIRED_GITIGNORE_LINES.join('\n').trimEnd()}\n`;
-const appendMissingGitignoreLines = (gitignorePath, content) => {
-    const existingLines = new Set(content.split('\n').map((l) => l.trim()));
-    const missing = REQUIRED_GITIGNORE_LINES.filter((line) => line !== '' && !existingLines.has(line));
-    if (missing.length === 0) {
-        return;
-    }
-    const next = `${content.trimEnd()}\n\n${missing.join('\n')}`;
-    writeFileSync(gitignorePath, `${next.trimEnd()}\n`);
-};
-const ensureWorkspaceGitignore = (trailsDir) => {
-    const gitignorePath = join(trailsDir, '.gitignore');
-    if (!existsSync(gitignorePath)) {
-        writeFileSync(gitignorePath, GITIGNORE_TEMPLATE);
-        return;
-    }
-    appendMissingGitignoreLines(gitignorePath, readFileSync(gitignorePath, 'utf8'));
-};
-const ensureWorkspaceDir = (rootDir) => {
-    const trailsDir = deriveTrailsDir({ rootDir });
-    mkdirSync(trailsDir, { recursive: true });
-    for (const subdir of WORKSPACE_SUBDIRS) {
-        mkdirSync(join(trailsDir, subdir), { recursive: true });
-    }
-    ensureWorkspaceGitignore(trailsDir);
-};
-const initializeWritePragmas = (db) => {
-    db.run('PRAGMA journal_mode = WAL');
-    db.run('PRAGMA synchronous = NORMAL');
-    db.run('PRAGMA foreign_keys = ON');
-};
-const ensureSchemaVersionTable = (db) => {
-    db.run(`CREATE TABLE IF NOT EXISTS ${SCHEMA_VERSION_TABLE} (
-    subsystem TEXT PRIMARY KEY,
-    version INTEGER NOT NULL,
-    updated_at TEXT NOT NULL
-  )`);
-};
-const readSubsystemVersion = (db, subsystem) => {
-    const row = db
-        .query(`SELECT version FROM ${SCHEMA_VERSION_TABLE} WHERE subsystem = ?`)
-        .get(subsystem);
-    return row?.version ?? 0;
-};
-const writeSubsystemVersion = (db, subsystem, version) => {
-    db.run(`INSERT INTO ${SCHEMA_VERSION_TABLE} (subsystem, version, updated_at)
-     VALUES (?, ?, ?)
-     ON CONFLICT(subsystem) DO UPDATE SET
-       version = excluded.version,
-       updated_at = excluded.updated_at`, [subsystem, version, new Date().toISOString()]);
-};
-export const openWriteTrailsDb = (options) => {
-    const rootDir = deriveRootDir(options?.rootDir);
-    const dbPath = deriveTrailsDbPath(options?.path ? { path: options.path, rootDir } : { rootDir });
-    if (options?.path === undefined) {
-        ensureWorkspaceDir(rootDir);
-    }
-    else {
-        ensureDbParentDir(dbPath);
-    }
-    const db = new Database(dbPath, { create: true });
-    initializeWritePragmas(db);
-    ensureSchemaVersionTable(db);
-    return db;
-};
-export const openReadTrailsDb = (options) => {
-    const dbPath = deriveTrailsDbPath(options);
-    if (!existsSync(dbPath)) {
-        throw new NotFoundError(`Trails database not found at "${dbPath}". Run a write operation first to initialize it.`);
-    }
-    const db = new Database(dbPath, { readonly: true });
-    db.run('PRAGMA foreign_keys = ON');
-    return db;
-};
-export const ensureSubsystemSchema = (db, options) => {
-    ensureSchemaVersionTable(db);
-    db.transaction(() => {
-        const currentVersion = readSubsystemVersion(db, options.subsystem);
-        if (currentVersion >= options.version) {
-            return;
-        }
-        options.migrate(currentVersion);
-        writeSubsystemVersion(db, options.subsystem, options.version);
-    })();
-};
-//# sourceMappingURL=trails-db.js.map

package/dist/internal/trails-db.js.map

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

package/dist/internal/zod-wrappers.d.ts

@@ -1,40 +0,0 @@
-/**
- * Shared Zod wrapper helpers.
- *
- * These helpers walk the wrapper layers of a Zod schema (default, optional,
- * nullable) and rebuild the schema without any default wrappers so that
- * downstream `.partial()` calls do not silently re-materialize defaults during
- * validation. Both `@ontrails/core/trails/derive-trail.ts` and
- * `@ontrails/store/src/store.ts` previously shipped near-identical copies of
- * this walk — extracting them here keeps the wrapper semantics authored in one
- * place so the two call sites cannot drift.
- *
- * Canonical behavior: `optional` wrappers are intentionally dropped. Every
- * current call site applies `.partial()` to the stripped schema, which
- * re-introduces `optional` across the whole shape. Preserving `optional` here
- * would be redundant at best and would produce an `OptionalOptional<T>` shape
- * in edge cases at worst. `nullable` wrappers are preserved because nullability
- * is a semantic constraint that `.partial()` does not reintroduce.
- *
- * @internal
- */
-import type { z } from 'zod';
-/**
- * Strip `default` wrappers from a Zod type so that partial update schemas do
- * not silently re-materialize defaults. Walks through all wrapper layers
- * (`default`, `optional`, `nullable`), drops defaults, drops `optional` (the
- * downstream `.partial()` reintroduces it across the whole shape), and
- * preserves `nullable` so explicit nullability survives.
- *
- * @internal
- */
-export declare const stripDefaultWrappers: (schema: z.ZodType) => z.ZodType;
-/**
- * Apply {@link stripDefaultWrappers} to every field in a Zod object shape and
- * return the resulting shape record. Callers typically feed the result to
- * `.extend()` + `.partial()`.
- *
- * @internal
- */
-export declare const stripDefaultsFromShape: (schema: z.ZodType) => Record<string, z.ZodType>;
-//# sourceMappingURL=zod-wrappers.d.ts.map

package/dist/internal/zod-wrappers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zod-wrappers.d.ts","sourceRoot":"","sources":["../../src/internal/zod-wrappers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAU7B;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,CAAC,CAAC,OAY1D,CAAC;AAOF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,CAAC,CAAC,OAAO,KAChB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAS1B,CAAC"}

package/dist/internal/zod-wrappers.js

@@ -1,59 +0,0 @@
-/**
- * Shared Zod wrapper helpers.
- *
- * These helpers walk the wrapper layers of a Zod schema (default, optional,
- * nullable) and rebuild the schema without any default wrappers so that
- * downstream `.partial()` calls do not silently re-materialize defaults during
- * validation. Both `@ontrails/core/trails/derive-trail.ts` and
- * `@ontrails/store/src/store.ts` previously shipped near-identical copies of
- * this walk — extracting them here keeps the wrapper semantics authored in one
- * place so the two call sites cannot drift.
- *
- * Canonical behavior: `optional` wrappers are intentionally dropped. Every
- * current call site applies `.partial()` to the stripped schema, which
- * re-introduces `optional` across the whole shape. Preserving `optional` here
- * would be redundant at best and would produce an `OptionalOptional<T>` shape
- * in edge cases at worst. `nullable` wrappers are preserved because nullability
- * is a semantic constraint that `.partial()` does not reintroduce.
- *
- * @internal
- */
-const isWrapperType = (type) => type === 'default' || type === 'nullable' || type === 'optional';
-const readInnerType = (schema) => schema.def.innerType;
-/**
- * Strip `default` wrappers from a Zod type so that partial update schemas do
- * not silently re-materialize defaults. Walks through all wrapper layers
- * (`default`, `optional`, `nullable`), drops defaults, drops `optional` (the
- * downstream `.partial()` reintroduces it across the whole shape), and
- * preserves `nullable` so explicit nullability survives.
- *
- * @internal
- */
-export const stripDefaultWrappers = (schema) => {
-    let current = schema;
-    let isNullable = false;
-    while (isWrapperType(current.def.type)) {
-        if (current.def.type === 'nullable') {
-            isNullable = true;
-        }
-        current = readInnerType(current);
-    }
-    return isNullable ? current.nullable() : current;
-};
-const asObjectSchema = (schema) => schema;
-/**
- * Apply {@link stripDefaultWrappers} to every field in a Zod object shape and
- * return the resulting shape record. Callers typically feed the result to
- * `.extend()` + `.partial()`.
- *
- * @internal
- */
-export const stripDefaultsFromShape = (schema) => {
-    const stripped = {};
-    const objectSchema = asObjectSchema(schema);
-    for (const [field, value] of Object.entries(objectSchema.shape)) {
-        stripped[field] = stripDefaultWrappers(value);
-    }
-    return stripped;
-};
-//# sourceMappingURL=zod-wrappers.js.map

package/dist/internal/zod-wrappers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"zod-wrappers.js","sourceRoot":"","sources":["../../src/internal/zod-wrappers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,MAAM,aAAa,GAAG,CACpB,IAAY,EACiC,EAAE,CAC/C,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,CAAC;AAEnE,MAAM,aAAa,GAAG,CAAC,MAAiB,EAAa,EAAE,CACpD,MAAM,CAAC,GAA2C,CAAC,SAAS,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAiB,EAAa,EAAE;IACnE,IAAI,OAAO,GAAG,MAAM,CAAC;IACrB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,OAAO,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACpC,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACnD,CAAC,CAAC;AAIF,MAAM,cAAc,GAAG,CAAC,MAAiB,EAAmB,EAAE,CAC5D,MAAoC,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAAiB,EACU,EAAE;IAC7B,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAC/C,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAE5C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,QAAQ,CAAC,KAAK,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/layer.d.ts

@@ -1,23 +0,0 @@
-import type { AnyTrail } from './trail.js';
-import type { Implementation } from './types.js';
-/** A composable layer that wraps trail implementations. */
-export interface Layer {
-    readonly name: string;
-    readonly description?: string | undefined;
-    /**
-     * Wrap a trail's implementation, returning a new implementation.
-     *
-     * The trail is passed for metadata inspection (intent, schema, etc.).
-     * The implementation and return type are generic over the input/output
-     * types so layers remain type-safe when composed.
-     */
-    wrap<I, O>(trail: AnyTrail, implementation: Implementation<I, O>): Implementation<I, O>;
-}
-/**
- * Apply layers outermost-first: layers[0] wraps layers[1] wraps ... wraps
- * the base implementation.
- *
- * An empty layers array returns the implementation unchanged.
- */
-export declare const composeLayers: <I, O>(layers: readonly Layer[], trail: AnyTrail, implementation: Implementation<I, O>) => Implementation<I, O>;
-//# sourceMappingURL=layer.d.ts.map

package/dist/layer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../src/layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,2DAA2D;AAC3D,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1C;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,EAAE,CAAC,EACP,KAAK,EAAE,QAAQ,EACf,cAAc,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GACnC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACzB;AAMD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,CAAC,EAChC,QAAQ,SAAS,KAAK,EAAE,EACxB,OAAO,QAAQ,EACf,gBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,KACnC,cAAc,CAAC,CAAC,EAAE,CAAC,CAUrB,CAAC"}

package/dist/layer.js

@@ -1,21 +0,0 @@
-// ---------------------------------------------------------------------------
-// Composition
-// ---------------------------------------------------------------------------
-/**
- * Apply layers outermost-first: layers[0] wraps layers[1] wraps ... wraps
- * the base implementation.
- *
- * An empty layers array returns the implementation unchanged.
- */
-export const composeLayers = (layers, trail, implementation) => {
-    // Fold right so layers[0] is the outermost wrapper.
-    let result = implementation;
-    for (let i = layers.length - 1; i >= 0; i -= 1) {
-        const layer = layers[i];
-        if (layer) {
-            result = layer.wrap(trail, result);
-        }
-    }
-    return result;
-};
-//# sourceMappingURL=layer.js.map

package/dist/layer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"layer.js","sourceRoot":"","sources":["../src/layer.ts"],"names":[],"mappings":"AAyBA,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,MAAwB,EACxB,KAAe,EACf,cAAoC,EACd,EAAE;IACxB,oDAAoD;IACpD,IAAI,MAAM,GAAG,cAAc,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/path-security.d.ts

@@ -1,28 +0,0 @@
-/**
- * Path security utilities for preventing path traversal attacks.
- *
- * All functions are runtime-agnostic (Node / Bun compatible).
- */
-import { PermissionError } from './errors.js';
-import { Result } from './result.js';
-/**
- * Resolves `userPath` relative to `basePath` and ensures it stays within
- * the base directory. Returns the resolved absolute path on success, or a
- * `PermissionError` if the path escapes.
- *
- * Uses lexical path comparison (not `realpath`). Does not follow symlinks —
- * if an attacker can create symlinks inside `basePath`, those could point
- * outside the base. Use `realpath` before calling in symlink-sensitive environments.
- */
-export declare const securePath: (basePath: string, userPath: string) => Result<string, PermissionError>;
-/**
- * Returns `true` if `userPath` (resolved against `basePath`) stays within
- * `basePath`.
- */
-export declare const isPathSafe: (basePath: string, userPath: string) => boolean;
-/**
- * Joins multiple path segments, resolves them against `basePath`, and
- * validates the result stays within the base directory.
- */
-export declare const deriveSafePath: (basePath: string, ...segments: string[]) => Result<string, PermissionError>;
-//# sourceMappingURL=path-security.d.ts.map

package/dist/path-security.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-security.d.ts","sourceRoot":"","sources":["../src/path-security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAmBrC;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,EAAE,eAAe,CAgBhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,EAAE,UAAU,MAAM,KAAG,OAI/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,GAAG,UAAU,MAAM,EAAE,KACpB,MAAM,CAAC,MAAM,EAAE,eAAe,CAchC,CAAC"}

package/dist/path-security.js

@@ -1,63 +0,0 @@
-/**
- * Path security utilities for preventing path traversal attacks.
- *
- * All functions are runtime-agnostic (Node / Bun compatible).
- */
-import { resolve, relative, normalize, isAbsolute } from 'node:path';
-import { PermissionError } from './errors.js';
-import { Result } from './result.js';
-// ---------------------------------------------------------------------------
-// Internal
-// ---------------------------------------------------------------------------
-/** Returns true when `target` is equal to or a descendant of `base`. */
-const isWithin = (base, target) => {
-    const rel = relative(base, target);
-    // Empty string means they are the same directory.
-    // A relative path starting with ".." means it escapes.
-    // An absolute path means a completely different tree.
-    return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));
-};
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Resolves `userPath` relative to `basePath` and ensures it stays within
- * the base directory. Returns the resolved absolute path on success, or a
- * `PermissionError` if the path escapes.
- *
- * Uses lexical path comparison (not `realpath`). Does not follow symlinks —
- * if an attacker can create symlinks inside `basePath`, those could point
- * outside the base. Use `realpath` before calling in symlink-sensitive environments.
- */
-export const securePath = (basePath, userPath) => {
-    const base = resolve(basePath);
-    const resolved = resolve(base, userPath);
-    if (!isWithin(base, resolved)) {
-        return Result.err(new PermissionError(`Path traversal detected: "${userPath}" escapes "${basePath}"`, {
-            context: { basePath: base, resolved, userPath },
-        }));
-    }
-    return Result.ok(resolved);
-};
-/**
- * Returns `true` if `userPath` (resolved against `basePath`) stays within
- * `basePath`.
- */
-export const isPathSafe = (basePath, userPath) => {
-    const base = resolve(basePath);
-    const resolved = resolve(base, userPath);
-    return isWithin(base, resolved);
-};
-/**
- * Joins multiple path segments, resolves them against `basePath`, and
- * validates the result stays within the base directory.
- */
-export const deriveSafePath = (basePath, ...segments) => {
-    const base = resolve(basePath);
-    const joined = resolve(base, ...segments.map((s) => normalize(s)));
-    if (!isWithin(base, joined)) {
-        return Result.err(new PermissionError(`Path traversal detected: segments escape "${basePath}"`, { context: { basePath: base, resolved: joined, segments } }));
-    }
-    return Result.ok(joined);
-};
-//# sourceMappingURL=path-security.js.map

package/dist/path-security.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-security.js","sourceRoot":"","sources":["../src/path-security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,wEAAwE;AACxE,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,MAAc,EAAW,EAAE;IACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,kDAAkD;IAClD,uDAAuD;IACvD,sDAAsD;IACtD,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,QAAgB,EAChB,QAAgB,EACiB,EAAE;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,GAAG,CACf,IAAI,eAAe,CACjB,6BAA6B,QAAQ,cAAc,QAAQ,GAAG,EAC9D;YACE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAChD,CACF,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,QAAgB,EAAW,EAAE;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,QAAgB,EAChB,GAAG,QAAkB,EACY,EAAE;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,GAAG,CACf,IAAI,eAAe,CACjB,6CAA6C,QAAQ,GAAG,EACxD,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAC5D,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/patterns/bulk.d.ts

@@ -1,15 +0,0 @@
-/**
- * Bulk operation schema helpers for @ontrails/core/patterns
- */
-import { z } from 'zod';
-/** Bulk operation output wrapper for a given item schema. */
-export declare const bulkOutput: <T>(itemSchema: z.ZodType<T>) => z.ZodObject<{
-    errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        index: z.ZodNumber;
-        message: z.ZodString;
-    }, z.core.$strip>>>;
-    failed: z.ZodNumber;
-    items: z.ZodArray<z.ZodType<T, unknown, z.core.$ZodTypeInternals<T, unknown>>>;
-    succeeded: z.ZodNumber;
-}, z.core.$strip>;
-//# sourceMappingURL=bulk.d.ts.map