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

package/dist/all.js

@@ -1,99 +0,0 @@
-/**
- * testAll — single-line governance suite for any Topo.
- *
- * Wraps topo validation, example execution, contract checks, and detour
- * contract validation into one describe block.
- */
-import { describe, expect, test } from 'bun:test';
-import { validateEstablishedTopo, validateTopo } from '@ontrails/core';
-import { createCliHarness } from './harness-cli.js';
-import { createMcpHarness } from './harness-mcp.js';
-import { testContracts } from './contracts.js';
-import { testDetours } from './detours.js';
-import { testExamples } from './examples.js';
-const formatValidationFailure = (error) => {
-    const issues = error.context?.issues;
-    if (issues === undefined || issues.length === 0) {
-        return error.message;
-    }
-    const details = issues.map((issue) => {
-        const id = typeof issue['id'] === 'string' ? issue['id'] : undefined;
-        const message = typeof issue['message'] === 'string' ? issue['message'] : undefined;
-        const rule = typeof issue['rule'] === 'string' ? issue['rule'] : undefined;
-        return [rule, id, message].filter(Boolean).join(': ');
-    });
-    return [error.message, ...details].join('\n');
-};
-const assertValidTopo = (result) => {
-    if (result.isErr()) {
-        throw new Error(formatValidationFailure(result.error));
-    }
-};
-const registerGovernanceSuite = (topo, ctxOrFactory, validate) => {
-    describe('governance', () => {
-        test('topo validates', () => {
-            expect(() => assertValidTopo(validate(topo))).not.toThrow();
-        });
-        // oxlint-disable-next-line jest/require-hook -- these generate describe/test blocks, not setup code
-        testExamples(topo, ctxOrFactory);
-        // oxlint-disable-next-line jest/require-hook -- these generate describe/test blocks, not setup code
-        testContracts(topo, ctxOrFactory);
-        // oxlint-disable-next-line jest/require-hook -- these generate describe/test blocks, not setup code
-        testDetours(topo);
-    });
-};
-export const testAll = (topo, ctxOrFactory) => {
-    registerGovernanceSuite(topo, ctxOrFactory, validateTopo);
-};
-const isEstablishedOptions = (input) => input !== undefined &&
-    (Object.hasOwn(input, 'cli') ||
-        Object.hasOwn(input, 'createPermit') ||
-        Object.hasOwn(input, 'ctx') ||
-        Object.hasOwn(input, 'mcp') ||
-        Object.hasOwn(input, 'resources') ||
-        Object.hasOwn(input, 'strictPermits'));
-const normalizeEstablishedOptions = (input) => isEstablishedOptions(input) ? input : { ctx: input };
-const toExecutionOptions = (options) => ({
-    ...(options.createPermit === undefined
-        ? {}
-        : { createPermit: options.createPermit }),
-    ...(options.ctx === undefined ? {} : { ctx: options.ctx }),
-    ...(options.resources === undefined ? {} : { resources: options.resources }),
-    ...(options.strictPermits === undefined
-        ? {}
-        : { strictPermits: options.strictPermits }),
-});
-const toCliHarnessOptions = (topo, options) => {
-    const cliOptions = {
-        graph: topo,
-        ...options.cli,
-    };
-    if (options.ctx !== undefined) {
-        cliOptions.ctx = options.ctx;
-    }
-    return cliOptions;
-};
-const toMcpHarnessOptions = (topo, options) => ({
-    graph: topo,
-    ...options.mcp,
-});
-const registerEstablishedSurfaceSuite = (topo, resolveInput) => {
-    describe('surfaces', () => {
-        test('CLI projection validates established topo', () => {
-            const options = normalizeEstablishedOptions(resolveInput());
-            expect(() => createCliHarness(toCliHarnessOptions(topo, options))).not.toThrow();
-        });
-        test('MCP projection validates established topo', () => {
-            const options = normalizeEstablishedOptions(resolveInput());
-            expect(() => createMcpHarness(toMcpHarnessOptions(topo, options))).not.toThrow();
-        });
-    });
-};
-export const testAllEstablished = (topo, optionsOrFactory) => {
-    const resolveInput = typeof optionsOrFactory === 'function'
-        ? optionsOrFactory
-        : () => optionsOrFactory;
-    registerGovernanceSuite(topo, () => toExecutionOptions(normalizeEstablishedOptions(resolveInput())), validateEstablishedTopo);
-    registerEstablishedSurfaceSuite(topo, resolveInput);
-};
-//# sourceMappingURL=all.js.map

package/dist/all.js.map

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

package/dist/assertions.d.ts

@@ -1,72 +0,0 @@
-/**
- * Progressive assertion logic for example-driven testing.
- *
- * Three tiers:
- * 1. Full match — example has `expected` output
- * 2. Schema-only — no expected output, no error
- * 3. Error match — example declares an error class name
- */
-import type { Result } from '@ontrails/core';
-import type { z } from 'zod';
-/**
- * Assert that a Result is Ok and return its value.
- *
- * Eliminates the `if (result.isOk())` / `as unknown as` dance in tests.
- *
- * @example
- * ```typescript
- * const value = expectOk(result);
- * expect(value.name).toBe('Alice');
- * ```
- */
-export declare const expectOk: <T, E>(result: Result<T, E>) => T;
-/**
- * Assert that a Result is Err and return its error.
- *
- * Eliminates the `if (result.isErr())` / `as unknown as` dance in tests.
- *
- * @example
- * ```typescript
- * const error = expectErr(result);
- * expect(error).toBeInstanceOf(ValidationError);
- * ```
- */
-export declare const expectErr: <T, E>(result: Result<T, E>) => E;
-export interface OkResultMatch {
-    readonly __resultMatch: 'ok';
-    readonly value?: unknown | undefined;
-}
-export interface ErrResultMatch {
-    readonly __resultMatch: 'err';
-    readonly error?: unknown | undefined;
-}
-/**
- * Create a partial-match token for `Result.ok(...)` values nested inside
- * arrays or objects, such as the `Result[]` returned by batch `ctx.cross()`.
- */
-export declare const okResultMatch: (value?: unknown) => OkResultMatch;
-/**
- * Create a partial-match token for `Result.err(...)` values nested inside
- * arrays or objects, such as mixed-success batch `ctx.cross()`.
- */
-export declare const errResultMatch: (error?: unknown) => ErrResultMatch;
-/**
- * Assert that the result is ok and its value deep-equals the expected output.
- */
-export declare const assertFullMatch: (result: Result<unknown, Error>, expected: unknown) => void;
-/**
- * Assert that the result is ok and, if an output schema is provided,
- * the value parses against it.
- */
-export declare const assertSchemaMatch: (result: Result<unknown, Error>, outputSchema: z.ZodType | undefined) => void;
-/**
- * Assert that the result is ok and its value is a superset of the expected
- * partial output. Declared fields must match; extra fields are ignored.
- */
-export declare const assertPartialMatch: (result: Result<unknown, Error>, expectedMatch: unknown) => void;
-/**
- * Assert that the result is an error of the specified type, with optional
- * message substring matching.
- */
-export declare const assertErrorMatch: (result: Result<unknown, Error>, expectedError: new (...args: never[]) => Error, expectedMessage?: string) => void;
-//# sourceMappingURL=assertions.d.ts.map

package/dist/assertions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,CAGrD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,CAGtD,CAAC;AAMF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAID;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,OAAO,KAAG,aAG9C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,OAAO,KAAG,cAG/C,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAC9B,UAAU,OAAO,KAChB,IAGF,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAC9B,cAAc,CAAC,CAAC,OAAO,GAAG,SAAS,KAClC,IAUF,CAAC;AAiNF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAC9B,eAAe,OAAO,KACrB,IAGF,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAC9B,eAAe,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,EAC9C,kBAAkB,MAAM,KACvB,IAMF,CAAC"}

package/dist/assertions.js

@@ -1,238 +0,0 @@
-/**
- * Progressive assertion logic for example-driven testing.
- *
- * Three tiers:
- * 1. Full match — example has `expected` output
- * 2. Schema-only — no expected output, no error
- * 3. Error match — example declares an error class name
- */
-import { expect } from 'bun:test';
-import { formatZodIssues } from '@ontrails/core';
-// ---------------------------------------------------------------------------
-// Result narrowing helpers
-// ---------------------------------------------------------------------------
-/**
- * Assert that a Result is Ok and return its value.
- *
- * Eliminates the `if (result.isOk())` / `as unknown as` dance in tests.
- *
- * @example
- * ```typescript
- * const value = expectOk(result);
- * expect(value.name).toBe('Alice');
- * ```
- */
-export const expectOk = (result) => {
-    expect(result.isOk()).toBe(true);
-    return result.value;
-};
-/**
- * Assert that a Result is Err and return its error.
- *
- * Eliminates the `if (result.isErr())` / `as unknown as` dance in tests.
- *
- * @example
- * ```typescript
- * const error = expectErr(result);
- * expect(error).toBeInstanceOf(ValidationError);
- * ```
- */
-export const expectErr = (result) => {
-    expect(result.isErr()).toBe(true);
-    return result.error;
-};
-/**
- * Create a partial-match token for `Result.ok(...)` values nested inside
- * arrays or objects, such as the `Result[]` returned by batch `ctx.cross()`.
- */
-export const okResultMatch = (value) => ({
-    __resultMatch: 'ok',
-    value,
-});
-/**
- * Create a partial-match token for `Result.err(...)` values nested inside
- * arrays or objects, such as mixed-success batch `ctx.cross()`.
- */
-export const errResultMatch = (error) => ({
-    __resultMatch: 'err',
-    error,
-});
-// ---------------------------------------------------------------------------
-// Full Match
-// ---------------------------------------------------------------------------
-/**
- * Assert that the result is ok and its value deep-equals the expected output.
- */
-export const assertFullMatch = (result, expected) => {
-    const value = expectOk(result);
-    expect(value).toEqual(expected);
-};
-// ---------------------------------------------------------------------------
-// Schema-Only Match
-// ---------------------------------------------------------------------------
-/**
- * Assert that the result is ok and, if an output schema is provided,
- * the value parses against it.
- */
-export const assertSchemaMatch = (result, outputSchema) => {
-    const value = expectOk(result);
-    if (outputSchema !== undefined) {
-        const parsed = outputSchema.safeParse(value);
-        if (!parsed.success) {
-            throw new Error(`Output does not match schema: ${formatZodIssues(parsed.error.issues).join('; ')}`);
-        }
-    }
-};
-// ---------------------------------------------------------------------------
-// Partial Match
-// ---------------------------------------------------------------------------
-/** Format a path for error messages. */
-const formatLoc = (path) => path.length > 0 ? path.join('.') : 'root';
-const isResultMatchToken = (value) => typeof value === 'object' &&
-    value !== null &&
-    '__resultMatch' in value &&
-    (value['__resultMatch'] === 'ok' ||
-        value['__resultMatch'] === 'err');
-const isResultLike = (value) => typeof value === 'object' &&
-    value !== null &&
-    'isOk' in value &&
-    typeof value['isOk'] === 'function' &&
-    'isErr' in value &&
-    typeof value['isErr'] === 'function';
-/** Find an unconsumed actual element that deep-matches the expected object. */
-const findObjectMatch = (actual, elem, consumed, path, index) => actual.findIndex((a, idx) => {
-    if (consumed.has(idx)) {
-        return false;
-    }
-    try {
-        // oxlint-disable-next-line no-use-before-define -- mutual recursion with assertSubset
-        assertSubset(a, elem, [...path, `[${String(index)}]`]);
-        return true;
-    }
-    catch {
-        return false;
-    }
-});
-/**
- * Assert that every element in `expected` exists in `actual` (order-independent).
- *
- * Tracks consumed indices so that duplicate expected elements each require a
- * distinct actual element — `['a', 'a']` does not match `['a']`.
- */
-const assertArraySubset = (actual, expected, path, loc) => {
-    const consumed = new Set();
-    for (let i = 0; i < expected.length; i += 1) {
-        const elem = expected[i];
-        const matchIndex = typeof elem === 'object' && elem !== null
-            ? findObjectMatch(actual, elem, consumed, path, i)
-            : actual.findIndex((a, idx) => !consumed.has(idx) && a === elem);
-        if (matchIndex === -1) {
-            throw new Error(`at ${loc}[${String(i)}]: expected array to contain ${JSON.stringify(elem)}`);
-        }
-        consumed.add(matchIndex);
-    }
-};
-/** Assert that every key in `expected` exists in `actual` with a matching value. */
-const assertObjectSubset = (actual, expected, path) => {
-    for (const key of Object.keys(expected)) {
-        if (!(key in actual)) {
-            throw new Error(`at ${[...path, key].join('.')}: key not found in actual`);
-        }
-        // oxlint-disable-next-line no-use-before-define -- mutual recursion with assertSubset
-        assertSubset(actual[key], expected[key], [...path, key]);
-    }
-};
-/**
- * Recursively assert that `actual` is a superset of `expected`.
- *
- * - **Scalars:** strict equality.
- * - **Objects:** every key in `expected` must exist in `actual` with a matching
- *   value. Extra keys in `actual` are ignored.
- * - **Arrays:** every element in `expected` must exist in `actual`
- *   (order-independent subset check).
- * - **Nested objects:** recursive subset matching.
- */
-// oxlint-disable-next-line max-statements -- recursive dispatch across four type branches
-const assertSubset = (actual, expected, path) => {
-    const loc = formatLoc(path);
-    if (expected === null || expected === undefined) {
-        if (actual !== expected) {
-            throw new Error(`at ${loc}: expected ${String(expected)}, got ${String(actual)}`);
-        }
-        return;
-    }
-    if (isResultMatchToken(expected)) {
-        // oxlint-disable-next-line no-use-before-define -- result token matching delegates back into assertSubset
-        assertResultTokenMatch(actual, expected, path);
-        return;
-    }
-    if (Array.isArray(expected)) {
-        if (!Array.isArray(actual)) {
-            throw new TypeError(`at ${loc}: expected an array, got ${typeof actual}`);
-        }
-        assertArraySubset(actual, expected, path, loc);
-        return;
-    }
-    if (typeof expected === 'object') {
-        if (typeof actual !== 'object' ||
-            actual === null ||
-            Array.isArray(actual)) {
-            throw new Error(`at ${loc}: expected an object, got ${typeof actual}`);
-        }
-        assertObjectSubset(actual, expected, path);
-        return;
-    }
-    if (actual !== expected) {
-        throw new Error(`at ${loc}: expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`);
-    }
-};
-const assertOkResultTokenMatch = (actual, expected, loc, path) => {
-    if (!actual.isOk()) {
-        throw new Error(`at ${loc}: expected Result.ok(...), got Result.err(...)`);
-    }
-    if (expected.value !== undefined) {
-        assertSubset(actual.value, expected.value, [...path, 'value']);
-    }
-};
-const assertErrResultTokenMatch = (actual, expected, loc, path) => {
-    if (!actual.isErr()) {
-        throw new Error(`at ${loc}: expected Result.err(...), got Result.ok(...)`);
-    }
-    if (expected.error !== undefined) {
-        assertSubset(actual.error, expected.error, [...path, 'error']);
-    }
-};
-const assertResultTokenMatch = (actual, expected, path) => {
-    const loc = formatLoc(path);
-    if (!isResultLike(actual)) {
-        throw new TypeError(`at ${loc}: expected a Result-like value`);
-    }
-    if (expected.__resultMatch === 'ok') {
-        assertOkResultTokenMatch(actual, expected, loc, path);
-        return;
-    }
-    assertErrResultTokenMatch(actual, expected, loc, path);
-};
-/**
- * Assert that the result is ok and its value is a superset of the expected
- * partial output. Declared fields must match; extra fields are ignored.
- */
-export const assertPartialMatch = (result, expectedMatch) => {
-    const value = expectOk(result);
-    assertSubset(value, expectedMatch, []);
-};
-// ---------------------------------------------------------------------------
-// Error Match
-// ---------------------------------------------------------------------------
-/**
- * Assert that the result is an error of the specified type, with optional
- * message substring matching.
- */
-export const assertErrorMatch = (result, expectedError, expectedMessage) => {
-    const error = expectErr(result);
-    expect(error).toBeInstanceOf(expectedError);
-    if (expectedMessage !== undefined) {
-        expect(error.message).toContain(expectedMessage);
-    }
-};
-//# sourceMappingURL=assertions.js.map

package/dist/assertions.js.map

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

package/dist/context.d.ts

@@ -1,76 +0,0 @@
-/**
- * Test context factory for creating TrailContext instances suitable for testing.
- */
-import type { CrossFn, ResourceOverrideMap, Topo, TrailContext } from '@ontrails/core';
-import { Result, buildCrossValidationSchema } from '@ontrails/core';
-import type { TestTrailContextOptions } from './types.js';
-/**
- * Create a TrailContext with deterministic, test-friendly defaults.
- *
- * - `requestId`: `"test-request-001"` (deterministic)
- * - `logger`: a `TestLogger` that captures entries
- * - `abortSignal`: a non-aborted AbortController signal
- */
-export declare const createTestContext: (overrides?: TestTrailContextOptions) => TrailContext;
-export interface CreateCrossContextOptions {
-    readonly responses?: Record<string, Result<unknown, Error>> | undefined;
-}
-/** Minimal permit shape returned by the create function. */
-export interface MinimalPermit {
-    readonly id: string;
-    readonly scopes: readonly string[];
-}
-/** Trail shape consumed by the create function — avoids importing permits. */
-export interface PermittedTrail {
-    readonly permit?: {
-        readonly scopes: readonly string[];
-    } | 'public' | undefined;
-}
-export interface TestExecutionOptions {
-    readonly ctx?: Partial<TrailContext> | undefined;
-    readonly resources?: ResourceOverrideMap | undefined;
-    /**
-     * When true, disables automatic permit creation. Tests must provide
-     * explicit permits.
-     */
-    readonly strictPermits?: boolean | undefined;
-    /**
-     * Optional function to create a test permit for a trail. When provided,
-     * called for each trail with a non-public `permit` requirement.
-     * Returning `undefined` skips creation for that trail.
-     *
-     * A default inline implementation is used when this is not provided,
-     * keeping the testing package free of a hard dependency on `@ontrails/permits`.
-     */
-    readonly createPermit?: (trail: PermittedTrail) => MinimalPermit | undefined;
-}
-/**
- * Create a mock `CrossFn` for testing composite trails.
- *
- * Returns preconfigured `Result` values keyed by trail ID. Calls to
- * unregistered IDs return `Result.err` with a descriptive message.
- *
- * @example
- * ```ts
- * const cross = createCrossContext({
- *   responses: { 'entity.add': Result.ok({ id: '1', name: 'Alpha' }) },
- * });
- * const ctx = { ...createTestContext(), cross };
- * ```
- */
-export declare const createCrossContext: (options?: CreateCrossContextOptions) => CrossFn;
-/**
- * Default permit creator — reads `trail.permit.scopes` and produces a
- * minimal permit object. No dependency on `@ontrails/permits`.
- */
-export declare const defaultCreatePermit: (trail: PermittedTrail) => MinimalPermit | undefined;
-export declare const normalizeTestExecutionOptions: (input?: Partial<TrailContext> | TestExecutionOptions) => TestExecutionOptions;
-export declare const mergeResourceOverrides: (autoResolved: ResourceOverrideMap, ctx: Partial<TrailContext> | undefined, explicit: ResourceOverrideMap | undefined) => ResourceOverrideMap;
-export declare const createMockResources: (app: Topo) => Promise<ResourceOverrideMap>;
-export { buildCrossValidationSchema };
-/**
- * Merge a Partial<TrailContext> into a test context.
- * Used internally when the public API accepts Partial<TrailContext>.
- */
-export declare const mergeTestContext: (ctx?: Partial<TrailContext>, resources?: ResourceOverrideMap) => 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":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,mBAAmB,EACnB,IAAI,EACJ,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,MAAM,EACN,0BAA0B,EAG3B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAU1D;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,YAAY,uBAAuB,KAClC,YAeF,CAAC;AAMF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC;CACzE;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,CAAC,EACZ;QAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GACtC,QAAQ,GACR,SAAS,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACrD;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,aAAa,GAAG,SAAS,CAAC;CAC9E;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,yBAAyB,KAClC,OAiCF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,cAAc,KACpB,aAAa,GAAG,SAKlB,CAAC;AAWF,eAAO,MAAM,6BAA6B,GACxC,QAAQ,OAAO,CAAC,YAAY,CAAC,GAAG,oBAAoB,KACnD,oBACqD,CAAC;AAEzD,eAAO,MAAM,sBAAsB,GACjC,cAAc,mBAAmB,EACjC,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,EACtC,UAAU,mBAAmB,GAAG,SAAS,KACxC,mBAID,CAAC;AAaH,eAAO,MAAM,mBAAmB,GAC9B,KAAK,IAAI,KACR,OAAO,CAAC,mBAAmB,CAAkC,CAAC;AAGjE,OAAO,EAAE,0BAA0B,EAAE,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,OAAO,CAAC,YAAY,CAAC,EAC3B,YAAY,mBAAmB,KAC9B,YAeF,CAAC"}

package/dist/context.js

@@ -1,118 +0,0 @@
-/**
- * Test context factory for creating TrailContext instances suitable for testing.
- */
-import { Result, buildCrossValidationSchema, createResourceLookup, passthroughTrace, } from '@ontrails/core';
-import { createTestLogger } from './logger.js';
-// ---------------------------------------------------------------------------
-// createTestContext
-// ---------------------------------------------------------------------------
-/**
- * Create a TrailContext with deterministic, test-friendly defaults.
- *
- * - `requestId`: `"test-request-001"` (deterministic)
- * - `logger`: a `TestLogger` that captures entries
- * - `abortSignal`: a non-aborted AbortController signal
- */
-export const createTestContext = (overrides) => {
-    const cwd = overrides?.cwd ?? process.cwd();
-    const ctx = {
-        abortSignal: overrides?.abortSignal ?? new AbortController().signal,
-        cwd,
-        env: overrides?.env ?? { TRAILS_ENV: 'test' },
-        extensions: undefined,
-        logger: overrides?.logger ?? createTestLogger(),
-        requestId: overrides?.requestId ?? 'test-request-001',
-        trace: overrides?.trace ?? passthroughTrace,
-        workspaceRoot: cwd,
-    };
-    const lookup = createResourceLookup(() => ctx);
-    ctx.resource = lookup;
-    return ctx;
-};
-/**
- * Create a mock `CrossFn` for testing composite trails.
- *
- * Returns preconfigured `Result` values keyed by trail ID. Calls to
- * unregistered IDs return `Result.err` with a descriptive message.
- *
- * @example
- * ```ts
- * const cross = createCrossContext({
- *   responses: { 'entity.add': Result.ok({ id: '1', name: 'Alpha' }) },
- * });
- * const ctx = { ...createTestContext(), cross };
- * ```
- */
-export const createCrossContext = (options) => {
-    const responses = options?.responses ?? {};
-    const respondToCross = (idOrTrail) => {
-        const id = typeof idOrTrail === 'string' ? idOrTrail : idOrTrail.id;
-        const response = responses[id];
-        if (response === undefined) {
-            return Promise.resolve(Result.err(new Error(`No mock response for cross("${id}")`)));
-        }
-        return Promise.resolve(response);
-    };
-    const cross = (async (idOrTrail, _input) => {
-        if (Array.isArray(idOrTrail)) {
-            return await Promise.all(idOrTrail.map(([target]) => respondToCross(target)));
-        }
-        return await respondToCross(idOrTrail);
-    });
-    return cross;
-};
-/**
- * Default permit creator — reads `trail.permit.scopes` and produces a
- * minimal permit object. No dependency on `@ontrails/permits`.
- */
-export const defaultCreatePermit = (trail) => {
-    if (!trail.permit || trail.permit === 'public') {
-        return undefined;
-    }
-    return { id: 'test-permit', scopes: trail.permit.scopes };
-};
-const isTestExecutionOptions = (input) => input !== undefined &&
-    (Object.hasOwn(input, 'ctx') ||
-        Object.hasOwn(input, 'resources') ||
-        Object.hasOwn(input, 'strictPermits') ||
-        Object.hasOwn(input, 'createPermit'));
-export const normalizeTestExecutionOptions = (input) => isTestExecutionOptions(input) ? input : { ctx: input };
-export const mergeResourceOverrides = (autoResolved, ctx, explicit) => ({
-    ...autoResolved,
-    ...ctx?.extensions,
-    ...explicit,
-});
-const buildMockResources = async (app) => {
-    const resources = {};
-    for (const declaredResource of app.listResources()) {
-        if (!declaredResource.mock) {
-            continue;
-        }
-        resources[declaredResource.id] = await declaredResource.mock();
-    }
-    return resources;
-};
-export const createMockResources = async (app) => await buildMockResources(app);
-// Re-export from core so existing consumers of this module continue to work.
-export { buildCrossValidationSchema };
-/**
- * Merge a Partial<TrailContext> into a test context.
- * Used internally when the public API accepts Partial<TrailContext>.
- */
-export const mergeTestContext = (ctx, resources) => {
-    const base = createTestContext();
-    const extensions = {
-        ...base.extensions,
-        ...ctx?.extensions,
-        ...resources,
-    };
-    const merged = {
-        ...base,
-        ...ctx,
-        extensions: Object.keys(extensions).length === 0 ? undefined : extensions,
-    };
-    const lookup = createResourceLookup(() => merged);
-    merged.resource = lookup;
-    return merged;
-};
-//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/contracts.d.ts

@@ -1,17 +0,0 @@
-/**
- * testContracts — output schema verification.
- *
- * For every trail that has both examples and an output schema,
- * run each example and validate the implementation output against
- * the declared schema.
- */
-import type { Topo, TrailContext } from '@ontrails/core';
-import type { TestExecutionOptions } from './context.js';
-/**
- * Verify that every trail implementation output matches its declared
- * output schema. Catches implementation-schema drift.
- *
- * Trails without output schemas or examples are skipped.
- */
-export declare const testContracts: (app: Topo, ctxOrFactory?: Partial<TrailContext> | TestExecutionOptions | (() => Partial<TrailContext> | TestExecutionOptions)) => void;
-//# sourceMappingURL=contracts.d.ts.map