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

package/dist/effective-examples.js

@@ -1,227 +0,0 @@
-import { getContourReferences } from '@ontrails/core';
-import { z } from 'zod';
-/**
- * Tracks examples that `deriveTrailExamples` synthesizes from contour
- * fixtures. Authored examples are passed through untouched and never
- * appear here, so consumers can distinguish the two by identity.
- *
- * Exposed via `isDerivedExample` so downstream testing helpers (e.g.
- * `testExamples` crossing coverage) can relax invariants that only make
- * sense for authored inputs.
- */
-const derivedExamples = new WeakSet();
-/**
- * Returns `true` if the given example was synthesized from contour fixtures
- * by `deriveTrailExamples`, `false` if it was authored on the trail.
- */
-export const isDerivedExample = (example) => derivedExamples.has(example);
-const capitalize = (value) => value.length === 0 ? value : value.slice(0, 1).toUpperCase() + value.slice(1);
-const collectReferenceMap = (contours) => {
-    const contourNames = new Set(contours.map((contour) => contour.name));
-    return new Map(contours.map((contour) => [
-        contour.name,
-        getContourReferences(contour).filter((reference) => contourNames.has(reference.contour)),
-    ]));
-};
-const getIdentityValue = (fixture) => fixture.example[fixture.contour.identity];
-const candidateMatchesSelectedReference = (candidate, target, reference) => Object.is(candidate.example[reference.field], getIdentityValue(target));
-const selectedMatchesCandidateReference = (fixture, candidate, reference) => Object.is(fixture.example[reference.field], getIdentityValue(candidate));
-const matchesCandidateReferences = (candidate, selected, referencesByContour) => {
-    const candidateReferences = referencesByContour.get(candidate.contour.name) ?? [];
-    for (const reference of candidateReferences) {
-        const target = selected.find((fixture) => fixture.contour.name === reference.contour);
-        if (target === undefined) {
-            continue;
-        }
-        if (!candidateMatchesSelectedReference(candidate, target, reference)) {
-            return false;
-        }
-    }
-    return true;
-};
-const matchesSelectedReferences = (candidate, selected, referencesByContour) => {
-    for (const fixture of selected) {
-        const fixtureReferences = referencesByContour.get(fixture.contour.name) ?? [];
-        for (const reference of fixtureReferences) {
-            if (reference.contour !== candidate.contour.name) {
-                continue;
-            }
-            if (!selectedMatchesCandidateReference(fixture, candidate, reference)) {
-                return false;
-            }
-        }
-    }
-    return true;
-};
-const matchesKnownReferences = (candidate, selected, referencesByContour) => matchesCandidateReferences(candidate, selected, referencesByContour) &&
-    matchesSelectedReferences(candidate, selected, referencesByContour);
-const selectContourFixtures = (contours, referencesByContour, index = 0, selected = []) => {
-    const contour = contours[index];
-    if (contour === undefined) {
-        return [selected];
-    }
-    const examples = contour.examples ?? [];
-    const matchingFixtures = examples.flatMap((example, exampleIndex) => {
-        const fixture = {
-            contour,
-            example: example,
-            index: exampleIndex,
-        };
-        if (!matchesKnownReferences(fixture, selected, referencesByContour)) {
-            return [];
-        }
-        return selectContourFixtures(contours, referencesByContour, index + 1, [
-            ...selected,
-            fixture,
-        ]);
-    });
-    return matchingFixtures;
-};
-/**
- * Merge selected contour fixtures into a single candidate input object.
- *
- * The resulting record contains:
- * - `<contour>`: the full fixture payload keyed by contour name.
- * - `<contour><Identity>`: the fixture's identity value on a prefixed key.
- * - `<contour><Field>`: every fixture field on a prefixed key.
- * - Unqualified `<field>` keys: first-write-wins across contours.
- *
- * The first-write-wins behaviour on unqualified keys is intentional but can
- * silently drop a later contour's value when two contours share a field name
- * (e.g. both declare `id`). The prefixed aliases above are unambiguous and
- * always written, so schemas that consume the prefixed form are unaffected;
- * schemas that rely on the bare field name should disambiguate via the
- * prefixed alias instead.
- */
-const buildDerivedInput = (fixtures) => {
-    const candidate = {};
-    for (const fixture of fixtures) {
-        candidate[fixture.contour.name] = fixture.example;
-        candidate[`${fixture.contour.name}${capitalize(fixture.contour.identity)}`] = getIdentityValue(fixture);
-        for (const [field, value] of Object.entries(fixture.example)) {
-            if (!Object.hasOwn(candidate, field)) {
-                candidate[field] = value;
-            }
-            candidate[`${fixture.contour.name}${capitalize(field)}`] = value;
-        }
-    }
-    return candidate;
-};
-/**
- * Project the merged candidate input down to keys the trail's input schema
- * knows about.
- *
- * `buildDerivedInput` emits synthesized prefixed aliases (e.g. `userEmail`)
- * alongside bare field names. Strict schemas (`z.object(...).strict()`)
- * reject any unknown key, which means an otherwise valid derived fixture
- * would silently fail `safeParse` just because of the synthesized aliases.
- * When the input is a `ZodObject`, trim the candidate to its declared keys
- * before validation. Non-object inputs pass through unchanged — they are
- * validated as-is and can decide for themselves.
- */
-const projectInputForSchema = (inputSchema, candidate) => {
-    if (!(inputSchema instanceof z.ZodObject)) {
-        return candidate;
-    }
-    const known = Object.keys(inputSchema.shape);
-    const projected = {};
-    for (const key of known) {
-        if (Object.hasOwn(candidate, key)) {
-            projected[key] = candidate[key];
-        }
-    }
-    return projected;
-};
-/**
- * Derive an expected output value from the selected contour fixtures when
- * exactly one fixture's payload satisfies the trail's output schema.
- *
- * Returns `undefined` when the trail has no output schema, when no fixture
- * matches, or when more than one matches — callers should then leave the
- * derived example without an `expected` and fall back to schema-only
- * validation. We intentionally do **not** infer `expected` from the merged
- * candidate input: input and output schemas frequently overlap structurally
- * but represent different semantics, so inferring from the input would
- * produce false deep-equality failures.
- */
-const deriveExpectedValue = (trail, fixtures) => {
-    if (trail.output === undefined) {
-        return undefined;
-    }
-    const outputSchema = trail.output;
-    const contourMatches = fixtures
-        .map((fixture) => outputSchema.safeParse(fixture.example))
-        .filter((candidate) => candidate.success);
-    if (contourMatches.length !== 1) {
-        return undefined;
-    }
-    const [singleMatch] = contourMatches;
-    if (singleMatch === undefined) {
-        return undefined;
-    }
-    return singleMatch.data;
-};
-const formatFixtureName = (fixtures, index) => {
-    const label = fixtures
-        .map((fixture) => {
-        const identity = getIdentityValue(fixture);
-        const fallback = fixture.index + 1;
-        return `${fixture.contour.name}:${String(identity ?? fallback)}`;
-    })
-        .join(', ');
-    return label.length > 0
-        ? `Derived fixture ${index + 1} (${label})`
-        : `Derived fixture ${index + 1}`;
-};
-/**
- * Prefer authored trail examples and fall back to contour-derived fixtures.
- *
- * Examples returned by this helper come from one of two provenances:
- * - **Authored.** When `trail.examples` is non-empty, its entries are
- *   returned verbatim. These are the developer's stated intent and carry
- *   full invariants — including crossing-coverage assertions in
- *   `testExamples`.
- * - **Derived.** When there are no authored examples but the trail has
- *   contours with examples, candidate inputs are synthesized from contour
- *   fixtures and validated against `trail.input`. These are opportunistic
- *   coverage that exists to let `testAll(app)` exercise contour-backed
- *   trails without per-test setup; they are not guaranteed to exercise
- *   every composition branch, so consumers should relax invariants that
- *   only make sense for authored inputs (see `isDerivedExample`).
- *
- * Contour examples stay as the raw input payload so Trails validation /
- * transforms still happen exactly once inside the normal test execution
- * path. Derived examples are additionally tagged via a module-level
- * `WeakSet` so consumers can detect them without widening the public
- * `TrailExample` shape.
- */
-export const deriveTrailExamples = (trail) => {
-    if (trail.examples !== undefined && trail.examples.length > 0) {
-        return trail.examples;
-    }
-    if (trail.contours.length === 0) {
-        return [];
-    }
-    if (trail.contours.some((contour) => contour.examples === undefined || contour.examples.length === 0)) {
-        return [];
-    }
-    const referencesByContour = collectReferenceMap(trail.contours);
-    const fixtureSets = selectContourFixtures(trail.contours, referencesByContour);
-    return fixtureSets.flatMap((fixtures, index) => {
-        const merged = buildDerivedInput(fixtures);
-        const input = projectInputForSchema(trail.input, merged);
-        const validated = trail.input.safeParse(input);
-        if (!validated.success) {
-            return [];
-        }
-        const expected = deriveExpectedValue(trail, fixtures);
-        const derived = {
-            ...(expected === undefined ? {} : { expected }),
-            input,
-            name: formatFixtureName(fixtures, index),
-        };
-        derivedExamples.add(derived);
-        return [derived];
-    });
-};
-//# sourceMappingURL=effective-examples.js.map

package/dist/effective-examples.js.map

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

package/dist/examples.d.ts

@@ -1,23 +0,0 @@
-/**
- * testExamples — the headline one-liner.
- *
- * Iterates every trail in the app's topo. For each trail with examples,
- * generates describe/test blocks using bun:test. Progressive assertion
- * determines which check to run per example. For trails with `crosses`
- * declarations, checks that every declared crossing was called at least once.
- */
-import type { Topo, TrailContext } from '@ontrails/core';
-import type { TestExecutionOptions } from './context.js';
-/**
- * Generate describe/test blocks for every trail example in the app.
- *
- * For trails with `crosses` declarations and examples, also verifies that
- * every declared crossed ID was called at least once across all examples.
- *
- * One line in your test file:
- * ```ts
- * testExamples(graph);
- * ```
- */
-export declare const testExamples: (app: Topo, ctxOrFactory?: Partial<TrailContext> | TestExecutionOptions | (() => Partial<TrailContext> | TestExecutionOptions)) => void;
-//# sourceMappingURL=examples.d.ts.map

package/dist/examples.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../src/examples.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAGV,IAAI,EAGJ,YAAY,EACb,MAAM,gBAAgB,CAAC;AAuCxB,OAAO,KAAK,EAAkB,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAmPzE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,IAAI,EACT,eACI,OAAO,CAAC,YAAY,CAAC,GACrB,oBAAoB,GACpB,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,GAAG,oBAAoB,CAAC,KACvD,IAoGF,CAAC"}

package/dist/examples.js

@@ -1,240 +0,0 @@
-/**
- * testExamples — the headline one-liner.
- *
- * Iterates every trail in the app's topo. For each trail with examples,
- * generates describe/test blocks using bun:test. Progressive assertion
- * determines which check to run per example. For trails with `crosses`
- * declarations, checks that every declared crossing was called at least once.
- */
-import { describe, expect, test } from 'bun:test';
-import { AlreadyExistsError, AmbiguousError, AssertionError, AuthError, buildCrossValidationSchema, CancelledError, ConflictError, DerivationError, InternalError, NetworkError, NotFoundError, PermissionError, RateLimitError, RetryExhaustedError, executeTrail, Result, TimeoutError, TrailsError, ValidationError, validateInput, } from '@ontrails/core';
-import { assertErrorMatch, assertFullMatch, assertPartialMatch, assertSchemaMatch, } from './assertions.js';
-import { defaultCreatePermit, mergeResourceOverrides, mergeTestContext, normalizeTestExecutionOptions, createMockResources, } from './context.js';
-import { isDerivedExample, deriveTrailExamples } from './effective-examples.js';
-// ---------------------------------------------------------------------------
-// Error class name -> constructor map
-// ---------------------------------------------------------------------------
-const ERROR_MAP = {
-    AlreadyExistsError: AlreadyExistsError,
-    AmbiguousError: AmbiguousError,
-    AssertionError: AssertionError,
-    AuthError: AuthError,
-    CancelledError: CancelledError,
-    ConflictError: ConflictError,
-    DerivationError: DerivationError,
-    InternalError: InternalError,
-    NetworkError: NetworkError,
-    NotFoundError: NotFoundError,
-    PermissionError: PermissionError,
-    RateLimitError: RateLimitError,
-    RetryExhaustedError: RetryExhaustedError,
-    TimeoutError: TimeoutError,
-    TrailsError: TrailsError,
-    ValidationError: ValidationError,
-};
-/**
- * Resolve an error class name string to the actual constructor.
- * Falls back to generic Error if the name is not in the core taxonomy.
- */
-const resolveErrorClass = (name) => ERROR_MAP[name] ?? Error;
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-const assertProgressiveMatch = (result, example, output) => {
-    if (example.expected !== undefined) {
-        return assertFullMatch(result, example.expected);
-    }
-    if (example.expectedMatch !== undefined) {
-        return assertPartialMatch(result, example.expectedMatch);
-    }
-    if (example.error !== undefined) {
-        return assertErrorMatch(result, resolveErrorClass(example.error));
-    }
-    assertSchemaMatch(result, output);
-};
-/**
- * Handle input validation failure for an example.
- * Returns true if the validation error was expected (and assertions passed).
- * Throws if the validation error was unexpected.
- */
-const handleValidationError = (validated, example) => {
-    if (!validated.isErr()) {
-        return false;
-    }
-    if (example.error !== undefined) {
-        const errorClass = resolveErrorClass(example.error);
-        expect(validated.error).toBeInstanceOf(errorClass);
-        return true;
-    }
-    throw new Error(`Example "${example.name}" has invalid input: ${validated.error.message}`);
-};
-/**
- * Apply auto-permit: if the trail declares scoped permits and the context
- * doesn't already have a permit, create one and merge it into the context.
- */
-const applyAutoPermit = (ctx, trailDef, opts) => {
-    if (opts.strictPermits) {
-        return ctx;
-    }
-    if (ctx.permit !== undefined) {
-        return ctx;
-    }
-    const create = opts.createPermit ?? defaultCreatePermit;
-    const permit = create(trailDef);
-    if (!permit) {
-        return ctx;
-    }
-    return { ...ctx, permit };
-};
-/**
- * Run a single example against a trail.
- * Handles validation, execution, and assertions.
- */
-const runExample = async (t, example, output, testCtx, resources, opts) => {
-    const validated = validateInput(t.input, example.input);
-    if (handleValidationError(validated, example)) {
-        return;
-    }
-    const ctx = opts ? applyAutoPermit(testCtx, t, opts) : testCtx;
-    const result = await executeTrail(t, example.input, {
-        ctx,
-        resources: resources ?? opts?.resources,
-    });
-    assertProgressiveMatch(result, example, output);
-};
-// ---------------------------------------------------------------------------
-// Crossing coverage for trails with crossings
-// ---------------------------------------------------------------------------
-/**
- * Build a recording cross function that tracks which trail IDs are called.
- *
- * Delegates to `baseCross` when available, otherwise looks up the trail
- * in the topo and executes it with validated input. Falls back to
- * `Result.ok()` when neither is available.
- */
-const createCoverageCross = (called, baseCross, topo, ctx, resources) => {
-    const invokeCross = async (idOrTrail, input, self) => {
-        const id = typeof idOrTrail === 'string' ? idOrTrail : idOrTrail.id;
-        called.add(id);
-        if (baseCross !== undefined) {
-            return await baseCross(id, input);
-        }
-        const trailDef = topo.get(id);
-        if (trailDef !== undefined) {
-            return await executeTrail(trailDef, input, {
-                ctx: { ...ctx, cross: self },
-                resources,
-                validationSchema: buildCrossValidationSchema(trailDef),
-            });
-        }
-        return Result.ok();
-    };
-    // Accepts either a trail object (typed cross), a string id (untyped),
-    // or a batch of `[target, input]` tuples.
-    const cross = async function cross(idOrTrail, input) {
-        if (Array.isArray(idOrTrail)) {
-            return await Promise.all(idOrTrail.map(([target, batchInput]) => invokeCross(target, batchInput, cross)));
-        }
-        return await invokeCross(idOrTrail, input, cross);
-    };
-    return cross;
-};
-/**
- * Run a single example against a trail with crossings, recording cross calls.
- */
-const runCompositionExample = async (trailDef, example, output, baseCtx, called, topo, resources, opts) => {
-    const validated = validateInput(trailDef.input, example.input);
-    if (handleValidationError(validated, example)) {
-        return;
-    }
-    const permittedCtx = opts
-        ? applyAutoPermit(baseCtx, trailDef, opts)
-        : baseCtx;
-    const cross = createCoverageCross(called, permittedCtx.cross, topo, permittedCtx, resources);
-    const testCtx = { ...permittedCtx, cross };
-    // Top-level trail validates against trail.input (not merged crossInput).
-    // Merged validation only applies to cross targets in executeFromMap/createCoverageCross.
-    const result = await executeTrail(trailDef, example.input, {
-        ctx: testCtx,
-        resources: resources ?? opts?.resources,
-    });
-    assertProgressiveMatch(result, example, output);
-};
-// ---------------------------------------------------------------------------
-// testExamples
-// ---------------------------------------------------------------------------
-/**
- * Generate describe/test blocks for every trail example in the app.
- *
- * For trails with `crosses` declarations and examples, also verifies that
- * every declared crossed ID was called at least once across all examples.
- *
- * One line in your test file:
- * ```ts
- * testExamples(graph);
- * ```
- */
-export const testExamples = (app, ctxOrFactory) => {
-    const resolveInput = typeof ctxOrFactory === 'function' ? ctxOrFactory : () => ctxOrFactory;
-    const withExamples = app.list()
-        .map((trailDef) => ({
-        ...trailDef,
-        examples: deriveTrailExamples(trailDef),
-    }))
-        .filter((trailDef) => trailDef.examples.length > 0);
-    const simpleTrails = withExamples.filter((t) => t.crosses.length === 0);
-    const compositionTrails = withExamples.filter((t) => t.crosses.length > 0);
-    // Simple trails: run examples directly
-    if (simpleTrails.length > 0) {
-        describe.each(simpleTrails)('$id', (t) => {
-            const { examples, output } = t;
-            if (!examples) {
-                return;
-            }
-            test.each([...examples])('example: $name', async (example) => {
-                const resolved = normalizeTestExecutionOptions(resolveInput());
-                const resources = mergeResourceOverrides(await createMockResources(app), resolved.ctx, resolved.resources);
-                const testCtx = mergeTestContext(resolved.ctx);
-                await runExample(t, example, output, testCtx, resources, resolved);
-            });
-        });
-    }
-    // Composition trails: use recording cross and check coverage.
-    //
-    // Crossing coverage only runs against AUTHORED examples. Contour-derived
-    // fixtures are opportunistic coverage that may not exercise every
-    // `ctx.cross()` branch in the trail, so asserting coverage against them
-    // would produce false failures for trails whose authored intent was a
-    // single path. When a trail has zero authored examples the coverage
-    // assertion is skipped entirely — the derived-example runs still
-    // execute, but they are not required to cover declared crossings.
-    if (compositionTrails.length > 0) {
-        describe.each(compositionTrails)('$id', (t) => {
-            const { examples, output } = t;
-            if (!examples) {
-                return;
-            }
-            const calledFromAuthored = new Set();
-            const hasAuthoredExamples = examples.some((example) => !isDerivedExample(example));
-            // Only record cross calls from authored examples. Derived fixtures
-            // execute normally but do not contribute to coverage — the sink map
-            // routes each example to the right bucket without an inline
-            // conditional inside the test body.
-            const discardSink = new Set();
-            const pickCoverageSink = (example) => isDerivedExample(example) ? discardSink : calledFromAuthored;
-            test.each([...examples])('example: $name', async (example) => {
-                const resolved = normalizeTestExecutionOptions(resolveInput());
-                const resources = mergeResourceOverrides(await createMockResources(app), resolved.ctx, resolved.resources);
-                const baseCtx = mergeTestContext(resolved.ctx);
-                await runCompositionExample(t, example, output, baseCtx, pickCoverageSink(example), app, resources, resolved);
-            });
-            if (hasAuthoredExamples) {
-                test('crossing coverage', () => {
-                    const uncovered = t.crosses.filter((id) => !calledFromAuthored.has(id));
-                    expect(uncovered).toEqual([]);
-                });
-            }
-        });
-    }
-};
-//# sourceMappingURL=examples.js.map

package/dist/examples.js.map

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

package/dist/harness-cli.d.ts

@@ -1,21 +0,0 @@
-/**
- * CLI integration test harness.
- *
- * Builds CLI commands from a graph, executes them in-process,
- * and captures stdout/stderr.
- */
-import type { CliHarness, CliHarnessOptions } from './types.js';
-/**
- * Create a CLI harness for integration testing.
- *
- * Builds commands from the graph's topo and provides a `run()` method
- * that parses command strings and executes them in-process.
- *
- * ```ts
- * const harness = createCliHarness({ graph });
- * const result = await harness.run("entity show --name Alpha --output json");
- * expect(result.exitCode).toBe(0);
- * ```
- */
-export declare const createCliHarness: (options: CliHarnessOptions) => CliHarness;
-//# sourceMappingURL=harness-cli.d.ts.map

package/dist/harness-cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"harness-cli.d.ts","sourceRoot":"","sources":["../src/harness-cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EAElB,MAAM,YAAY,CAAC;AA8PpB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,iBAAiB,KAAG,UAW7D,CAAC"}