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

package/dist/topo-store.js

@@ -1,175 +0,0 @@
-import { existsSync } from 'node:fs';
-import { NotFoundError } from './errors.js';
-import { provision } from './provision.js';
-import { Result } from './result.js';
-import { getTopoPin } from './internal/topo-saves.js';
-import { getTopoStoreExport, getTopoStoreProvision, getTopoStoreTrail, listTopoStorePins, listTopoStoreProvisions, listTopoStoreSaves, listTopoStoreTrails, queryTopoStore, resolveTopoStoreSave, } from './internal/topo-store-read.js';
-import { openReadTrailsDb, resolveTrailsDbPath } from './internal/trails-db.js';
-const missingStoreMessage = 'No saved topo state found. Populate trails.db first or run a topo-backed surface.';
-const resolveStoreRootDir = (options) => options?.rootDir ?? process.cwd();
-const requireReadDb = (options) => {
-    const dbPath = resolveTrailsDbPath(options);
-    if (!existsSync(dbPath)) {
-        throw new NotFoundError(missingStoreMessage);
-    }
-    return openReadTrailsDb(options);
-};
-const requireSavedTopoState = (db) => {
-    if (resolveTopoStoreSave(db) === undefined) {
-        throw new NotFoundError(missingStoreMessage);
-    }
-};
-const withStoredTopoState = (options, run) => {
-    const db = requireReadDb(options);
-    try {
-        requireSavedTopoState(db);
-        return run(db);
-    }
-    finally {
-        db.close();
-    }
-};
-const createSeedResolver = (seed) => {
-    const saves = [...(seed?.saves ?? [])];
-    const pins = [...(seed?.pins ?? [])];
-    const trails = [...(seed?.trails ?? [])];
-    const provisions = [...(seed?.provisions ?? [])];
-    const exports = [...(seed?.exports ?? [])];
-    const resolveSave = (ref) => {
-        if (ref?.saveId !== undefined) {
-            return saves.find((save) => save.id === ref.saveId);
-        }
-        if (ref?.pin !== undefined) {
-            const pin = pins.find((candidate) => candidate.name === ref.pin);
-            return pin === undefined
-                ? undefined
-                : saves.find((save) => save.id === pin.saveId);
-        }
-        return saves[0];
-    };
-    return {
-        exports,
-        pins,
-        provisions,
-        resolveSave,
-        saves,
-        trails,
-    };
-};
-export const createMockTopoStore = (seed) => {
-    const resolved = createSeedResolver(seed);
-    return {
-        exports: {
-            get(ref) {
-                const save = resolved.resolveSave(ref);
-                return save === undefined
-                    ? undefined
-                    : resolved.exports.find((entry) => entry.save.id === save.id);
-            },
-        },
-        pins: {
-            get(name) {
-                return resolved.pins.find((pin) => pin.name === name);
-            },
-            list() {
-                return resolved.pins;
-            },
-        },
-        provisions: {
-            get(id, options) {
-                const save = resolved.resolveSave(options?.save);
-                return resolved.provisions.find((item) => item.id === id && (save === undefined || item.saveId === save.id));
-            },
-            list(options) {
-                const save = resolved.resolveSave(options?.save);
-                return save === undefined
-                    ? []
-                    : resolved.provisions.filter((item) => item.saveId === save.id);
-            },
-        },
-        query() {
-            throw new NotFoundError('Mock topoStore.query() is unsupported. Seed typed accessors instead.');
-        },
-        saves: {
-            get(ref) {
-                return resolved.resolveSave(ref);
-            },
-            latest() {
-                return resolved.saves[0];
-            },
-            list() {
-                return resolved.saves;
-            },
-        },
-        trails: {
-            get(id, options) {
-                const save = resolved.resolveSave(options?.save);
-                if (save === undefined) {
-                    return;
-                }
-                return resolved.trails.find((trail) => trail.id === id && trail.saveId === save.id);
-            },
-            list(options) {
-                const save = resolved.resolveSave(options?.save);
-                if (save === undefined) {
-                    return [];
-                }
-                return resolved.trails.filter((trail) => trail.saveId === save.id &&
-                    (options?.intent === undefined || trail.intent === options.intent));
-            },
-        },
-    };
-};
-export const createTopoStore = (options) => ({
-    exports: {
-        get(ref) {
-            return withStoredTopoState(options, (db) => getTopoStoreExport(db, ref));
-        },
-    },
-    pins: {
-        get(name) {
-            return withStoredTopoState(options, (db) => getTopoPin(db, name));
-        },
-        list() {
-            return withStoredTopoState(options, (db) => listTopoStorePins(db));
-        },
-    },
-    provisions: {
-        get(id, queryOptions) {
-            return withStoredTopoState(options, (db) => getTopoStoreProvision(db, id, queryOptions));
-        },
-        list(queryOptions) {
-            return withStoredTopoState(options, (db) => listTopoStoreProvisions(db, queryOptions));
-        },
-    },
-    query(sql, bindings) {
-        return withStoredTopoState(options, (db) => queryTopoStore(db, sql, bindings));
-    },
-    saves: {
-        get(ref) {
-            return withStoredTopoState(options, (db) => resolveTopoStoreSave(db, ref));
-        },
-        latest() {
-            return withStoredTopoState(options, (db) => resolveTopoStoreSave(db));
-        },
-        list() {
-            return withStoredTopoState(options, (db) => listTopoStoreSaves(db));
-        },
-    },
-    trails: {
-        get(id, queryOptions) {
-            return withStoredTopoState(options, (db) => getTopoStoreTrail(db, id, queryOptions));
-        },
-        list(queryOptions) {
-            return withStoredTopoState(options, (db) => listTopoStoreTrails(db, queryOptions));
-        },
-    },
-});
-export const topoStore = provision('topo.store', {
-    create: (svc) => Result.ok(createTopoStore({
-        rootDir: svc.workspaceRoot ?? svc.cwd ?? resolveStoreRootDir(),
-    })),
-    description: 'Read-only query access to saved topo state in trails.db',
-    mock: () => createMockTopoStore(),
-});
-//# sourceMappingURL=topo-store.js.map

package/dist/topo-store.js.map

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

package/dist/topo.d.ts

@@ -1,25 +0,0 @@
-/**
- * Application entry point — scans module exports to build a topology graph.
- */
-import type { AnySignal } from './event.js';
-import type { AnyProvision } from './provision.js';
-import type { AnyTrail } from './trail.js';
-export interface Topo {
-    readonly name: string;
-    readonly trails: ReadonlyMap<string, AnyTrail>;
-    readonly signals: ReadonlyMap<string, AnySignal>;
-    readonly provisions: ReadonlyMap<string, AnyProvision>;
-    readonly count: number;
-    readonly provisionCount: number;
-    get(id: string): AnyTrail | undefined;
-    getProvision(id: string): AnyProvision | undefined;
-    has(id: string): boolean;
-    hasProvision(id: string): boolean;
-    ids(): string[];
-    provisionIds(): string[];
-    list(): AnyTrail[];
-    listSignals(): AnySignal[];
-    listProvisions(): AnyProvision[];
-}
-export declare const topo: (name: string, ...modules: Record<string, unknown>[]) => Topo;
-//# sourceMappingURL=topo.d.ts.map

package/dist/topo.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"topo.d.ts","sourceRoot":"","sources":["../src/topo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACnD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,GAAG,IAAI,MAAM,EAAE,CAAC;IAChB,YAAY,IAAI,MAAM,EAAE,CAAC;IACzB,IAAI,IAAI,QAAQ,EAAE,CAAC;IACnB,WAAW,IAAI,SAAS,EAAE,CAAC;IAC3B,cAAc,IAAI,YAAY,EAAE,CAAC;CAClC;AA4ID,eAAO,MAAM,IAAI,GACf,MAAM,MAAM,EACZ,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KACpC,IAUF,CAAC"}

package/dist/topo.js

@@ -1,112 +0,0 @@
-/**
- * Application entry point — scans module exports to build a topology graph.
- */
-import { ValidationError } from './errors.js';
-import { isProvision } from './provision.js';
-const isRegistrable = (value) => {
-    if (typeof value !== 'object' || value === null) {
-        return false;
-    }
-    const { kind } = value;
-    return kind === 'trail' || kind === 'signal';
-};
-// ---------------------------------------------------------------------------
-// Topo implementation
-// ---------------------------------------------------------------------------
-const createTopo = (name, trails, signals, provisions) => ({
-    count: trails.size,
-    get(id) {
-        return trails.get(id);
-    },
-    getProvision(id) {
-        return provisions.get(id);
-    },
-    has(id) {
-        return trails.has(id);
-    },
-    hasProvision(id) {
-        return provisions.has(id);
-    },
-    ids() {
-        return [...trails.keys()];
-    },
-    list() {
-        return [...trails.values()];
-    },
-    listProvisions() {
-        return [...provisions.values()];
-    },
-    listSignals() {
-        return [...signals.values()];
-    },
-    name,
-    provisionCount: provisions.size,
-    provisionIds() {
-        return [...provisions.keys()];
-    },
-    provisions,
-    signals,
-    trails,
-});
-// ---------------------------------------------------------------------------
-// topo()
-// ---------------------------------------------------------------------------
-/** Register a single registrable value into the appropriate map. */
-const register = (value, trails, signals, provisions) => {
-    const { id } = value;
-    const registrars = {
-        provision: () => {
-            if (provisions.has(id)) {
-                throw new ValidationError(`Duplicate provision ID: "${id}"`);
-            }
-            provisions.set(id, value);
-        },
-        signal: () => {
-            if (signals.has(id)) {
-                throw new ValidationError(`Duplicate signal ID: "${id}"`);
-            }
-            signals.set(id, value);
-        },
-        trail: () => {
-            if (trails.has(id)) {
-                throw new ValidationError(`Duplicate trail ID: "${id}"`);
-            }
-            trails.set(id, value);
-        },
-    };
-    registrars[value.kind]?.();
-};
-const markUniqueObject = (value, seenValues) => {
-    if (typeof value !== 'object' || value === null) {
-        return true;
-    }
-    if (seenValues.has(value)) {
-        return false;
-    }
-    seenValues.add(value);
-    return true;
-};
-const registerModuleValue = (value, trails, signals, provisions) => {
-    if (isProvision(value) || isRegistrable(value)) {
-        register(value, trails, signals, provisions);
-    }
-};
-const registerModuleValues = (mod, trails, signals, provisions) => {
-    const seenValues = new WeakSet();
-    for (const value of Object.values(mod)) {
-        if (!markUniqueObject(value, seenValues)) {
-            continue;
-        }
-        registerModuleValue(value, trails, signals, provisions);
-    }
-};
-export const topo = (name, ...modules) => {
-    const trails = new Map();
-    const signals = new Map();
-    const provisions = new Map();
-    for (const mod of modules) {
-        registerModuleValues(mod, trails, signals, provisions);
-    }
-    return createTopo(name, trails, signals, provisions);
-};
-//# sourceMappingURL=topo.js.map

package/dist/topo.js.map

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

package/dist/trail.d.ts

@@ -1,96 +0,0 @@
-import type { z } from 'zod';
-import type { FieldOverride } from './derive.js';
-import type { Result } from './result.js';
-import type { AnyProvision } from './provision.js';
-import type { Implementation, PermitRequirement, TrailContext } from './types.js';
-/**
- * A named example for documentation and testing.
- *
- * The `input` field accepts `Partial<I>` so that fields with schema defaults
- * (e.g. `z.number().default(20)`) can be omitted from examples. The schema
- * fills in defaults at validation time.
- */
-export interface TrailExample<I, O> {
-    /** Human-readable name */
-    readonly name: string;
-    /** Optional description of what this example demonstrates */
-    readonly description?: string | undefined;
-    /** The input value — fields with schema defaults may be omitted */
-    readonly input: Partial<I>;
-    /** Expected output for success-path examples */
-    readonly expected?: O | undefined;
-    /** Error class name for error-path examples */
-    readonly error?: string | undefined;
-}
-/** Everything needed to define a trail (minus the id) */
-export interface TrailSpec<I, O> {
-    /** Zod schema for validating input */
-    readonly input: z.ZodType<I>;
-    /** Zod schema for validating output (optional — some trails are fire-and-forget) */
-    readonly output?: z.ZodType<O> | undefined;
-    /** The pure function that does the work (sync or async authoring) */
-    readonly blaze: Implementation<I, O>;
-    /** Human-readable description */
-    readonly description?: string | undefined;
-    /** Named examples for docs and testing */
-    readonly examples?: readonly TrailExample<I, O>[] | undefined;
-    /** What this trail does to the world: read, write (default), or destroy */
-    readonly intent?: 'read' | 'write' | 'destroy' | undefined;
-    /** Trail is idempotent (safe to retry) */
-    readonly idempotent?: boolean | undefined;
-    /** Arbitrary meta for tooling and filtering */
-    readonly meta?: Readonly<Record<string, unknown>> | undefined;
-    /** Named sets of downstream trail IDs that may be invoked */
-    readonly detours?: Readonly<Record<string, readonly string[]>> | undefined;
-    /** Per-field overrides for deriveFields() (labels, hints, options) */
-    readonly fields?: Readonly<Record<string, FieldOverride>> | undefined;
-    /** IDs of downstream trails this trail may invoke via ctx.cross() */
-    readonly crosses?: readonly string[] | undefined;
-    /** Provisions this trail may access via provision.from(ctx) */
-    readonly provisions?: readonly AnyProvision[] | undefined;
-    /** Auth requirement: scopes object, 'public', or omitted (undeclared) */
-    readonly permit?: PermitRequirement | undefined;
-}
-/** Intent describes what a trail does to the world */
-export type Intent = 'read' | 'write' | 'destroy';
-/** A fully-defined trail — the unit of work in the Trails system */
-export interface Trail<I, O> extends Omit<TrailSpec<I, O>, 'blaze' | 'crosses' | 'intent' | 'provisions'> {
-    readonly kind: 'trail';
-    readonly id: string;
-    readonly blaze: Implementation<I, O>;
-    /** IDs of downstream trails this trail may invoke via ctx.cross() (always present, default []) */
-    readonly crosses: readonly string[];
-    /** Provisions this trail may access via provision.from(ctx) (always present, default []) */
-    readonly provisions: readonly AnyProvision[];
-    /** What this trail does to the world (always present, default 'write') */
-    readonly intent: Intent;
-}
-/**
- * Create a trail definition.
- *
- * Returns a frozen object with `kind: "trail"` and all spec fields.
- * The trail is inert until handed to a runner.
- *
- * @example
- * ```typescript
- * // ID as first argument (recommended for human authoring)
- * const show = trail("entity.show", {
- *   input: z.object({ name: z.string() }),
- *   blaze: (input) => Result.ok(entity),
- * });
- *
- * // Full spec object (for programmatic generation)
- * const show = trail({
- *   id: "entity.show",
- *   input: z.object({ name: z.string() }),
- *   blaze: (input) => Result.ok(entity),
- * });
- * ```
- */
-export declare function trail<I, O>(id: string, spec: TrailSpec<I, O>): Trail<I, O>;
-export declare function trail<I, O>(spec: TrailSpec<I, O> & {
-    readonly id: string;
-}): Trail<I, O>;
-export type AnyTrail = Trail<any, any>;
-export type { Implementation, TrailContext, Result };
-//# sourceMappingURL=trail.d.ts.map

package/dist/trail.d.ts.map

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

package/dist/trail.js

@@ -1,20 +0,0 @@
-export function trail(idOrSpec, maybeSpec) {
-    const resolved = typeof idOrSpec === 'string'
-        ? { id: idOrSpec, spec: maybeSpec }
-        : { id: idOrSpec.id, spec: idOrSpec };
-    if (!resolved.spec) {
-        throw new TypeError('trail() requires a spec when an id is provided');
-    }
-    const { blaze, crosses: rawCrosses, intent: rawIntent, provisions: rawProvisions, ...spec } = resolved.spec;
-    const provisions = Object.freeze([...(rawProvisions ?? [])]);
-    return Object.freeze({
-        ...spec,
-        blaze: async (input, ctx) => await blaze(input, ctx),
-        crosses: Object.freeze([...(rawCrosses ?? [])]),
-        id: resolved.id,
-        intent: rawIntent ?? 'write',
-        kind: 'trail',
-        provisions,
-    });
-}
-//# sourceMappingURL=trail.js.map

package/dist/trail.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"trail.js","sourceRoot":"","sources":["../src/trail.ts"],"names":[],"mappings":"AA0HA,MAAM,UAAU,KAAK,CACnB,QAA8D,EAC9D,SAA2B;IAE3B,MAAM,QAAQ,GACZ,OAAO,QAAQ,KAAK,QAAQ;QAC1B,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;QACnC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAE1C,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,SAAS,CAAC,gDAAgD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,EACJ,KAAK,EACL,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,aAAa,EACzB,GAAG,IAAI,EACR,GAAG,QAAQ,CAAC,IAAI,CAAC;IAClB,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAE7D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,IAAI;QACP,KAAK,EAAE,KAAK,EAAE,KAAQ,EAAE,GAAiB,EAAE,EAAE,CAAC,MAAM,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;QACrE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/C,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,MAAM,EAAE,SAAS,IAAI,OAAO;QAC5B,IAAI,EAAE,OAAgB;QACtB,UAAU;KACX,CAAC,CAAC;AACL,CAAC"}

package/dist/type-utils.d.ts

@@ -1,24 +0,0 @@
-/**
- * Type utilities for extracting input/output types from trails.
- */
-import type { Result } from './result.js';
-import type { AnyTrail, Trail } from './trail.js';
-/** Extract the input type from a Trail. */
-export type TrailInput<T extends AnyTrail> = T extends Trail<infer I, any> ? I : never;
-/** Extract the output type from a Trail. */
-export type TrailOutput<T extends AnyTrail> = T extends Trail<any, infer O> ? O : never;
-/**
- * Extracts the full `Result<Output, Error>` type from a trail definition.
- *
- * @example
- * ```typescript
- * type SearchResult = TrailResult<typeof searchTrail>;
- * // Result<{ results: Item[]; count: number }, Error>
- * ```
- */
-export type TrailResult<T extends AnyTrail> = Result<TrailOutput<T>, Error>;
-/** Get the input Zod schema from a trail, preserving the specific schema type. */
-export declare const inputOf: <T extends AnyTrail>(trail: T) => T["input"];
-/** Get the output Zod schema from a trail, if defined, preserving the specific schema type. */
-export declare const outputOf: <T extends AnyTrail>(trail: T) => T["output"];
-//# sourceMappingURL=type-utils.d.ts.map

package/dist/type-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"type-utils.d.ts","sourceRoot":"","sources":["../src/type-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAQlD,2CAA2C;AAC3C,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,QAAQ,IACvC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE5C,4CAA4C;AAC5C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,QAAQ,IACxC,CAAC,SAAS,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAQ5E,kFAAkF;AAClF,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,QAAQ,EAAE,OAAO,CAAC,KAAG,CAAC,CAAC,OAAO,CACnD,CAAC;AAEd,+FAA+F;AAC/F,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,QAAQ,EAAE,OAAO,CAAC,KAAG,CAAC,CAAC,QAAQ,CACpD,CAAC"}

package/dist/type-utils.js

@@ -1,12 +0,0 @@
-/**
- * Type utilities for extracting input/output types from trails.
- */
-/* oxlint-enable no-explicit-any */
-// ---------------------------------------------------------------------------
-// Runtime schema accessors
-// ---------------------------------------------------------------------------
-/** Get the input Zod schema from a trail, preserving the specific schema type. */
-export const inputOf = (trail) => trail.input;
-/** Get the output Zod schema from a trail, if defined, preserving the specific schema type. */
-export const outputOf = (trail) => trail.output;
-//# sourceMappingURL=type-utils.js.map

package/dist/type-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"type-utils.js","sourceRoot":"","sources":["../src/type-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8BH,mCAAmC;AAEnC,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,kFAAkF;AAClF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAqB,KAAQ,EAAc,EAAE,CAClE,KAAK,CAAC,KAAK,CAAC;AAEd,+FAA+F;AAC/F,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAqB,KAAQ,EAAe,EAAE,CACpE,KAAK,CAAC,MAAM,CAAC"}

package/dist/types.d.ts

@@ -1,71 +0,0 @@
-import type { Result } from './result.js';
-/**
- * Trail implementation — sync or async.
- *
- * Authors can return `Result` directly or wrap it in a `Promise`. The framework
- * normalizes with `await` at every call site, so both forms work transparently.
- */
-export type Implementation<I, O> = (input: I, ctx: TrailContext) => Result<O, Error> | Promise<Result<O, Error>>;
-/** Invoke another trail by id — used for trail composition */
-export type CrossFn = <O>(id: string, input: unknown) => Promise<Result<O, Error>>;
-/** Resolve a provision instance from the current trail context. */
-export type ProvisionLookup = <T = unknown>(provisionOrId: {
-    readonly id: string;
-} | string) => T;
-/** Callback for reporting progress from long-running trails */
-export type ProgressCallback = (event: ProgressEvent) => void;
-/** Structured progress event emitted during trail execution */
-export interface ProgressEvent {
-    readonly type: 'start' | 'progress' | 'complete' | 'error';
-    readonly current?: number | undefined;
-    readonly total?: number | undefined;
-    readonly message?: string | undefined;
-    readonly ts: string;
-}
-/** Minimal logger interface — implementations can bridge to any logging library */
-export interface Logger {
-    readonly name?: string | undefined;
-    trace(message: string, data?: Record<string, unknown>): void;
-    debug(message: string, data?: Record<string, unknown>): void;
-    info(message: string, data?: Record<string, unknown>): void;
-    warn(message: string, data?: Record<string, unknown>): void;
-    error(message: string, data?: Record<string, unknown>): void;
-    fatal(message: string, data?: Record<string, unknown>): void;
-    child(context: Record<string, unknown>): Logger;
-}
-/** Context extension key for the invoking trailhead name. */
-export declare const TRAILHEAD_KEY: "__trails_trailhead";
-/** Minimal permit shape available on TrailContext. Permits extends this. */
-export interface BasePermit {
-    readonly id: string;
-    readonly scopes: readonly string[];
-}
-/** Runtime context threaded through every trail execution */
-export interface TrailContext {
-    readonly requestId: string;
-    readonly abortSignal: AbortSignal;
-    readonly cross?: CrossFn | undefined;
-    readonly permit?: BasePermit;
-    readonly workspaceRoot?: string | undefined;
-    readonly logger?: Logger | undefined;
-    readonly progress?: ProgressCallback | undefined;
-    readonly cwd?: string | undefined;
-    readonly env?: Record<string, string | undefined> | undefined;
-    readonly extensions?: Readonly<Record<string, unknown>> | undefined;
-    readonly provision?: ProvisionLookup | undefined;
-}
-/**
- * Permit requirement declared on a trail spec.
- *
- * A scopes object means the trail requires a permit with those scopes.
- * `'public'` means the trail has explicitly opted out of auth.
- * Omitting the field entirely means the trail hasn't declared an auth posture.
- */
-export type PermitRequirement = {
-    readonly scopes: readonly string[];
-} | 'public';
-/** Input shape used to seed a runtime TrailContext before resolution. */
-export type TrailContextInit = Omit<TrailContext, 'provision'> & {
-    readonly provision?: ProvisionLookup | undefined;
-};
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,3 +0,0 @@
-/** Context extension key for the invoking trailhead name. */
-export const TRAILHEAD_KEY = '__trails_trailhead';
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgDA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,oBAA6B,CAAC"}