@ontrails/testing 1.0.0-beta.0

package/dist/detours.js

@@ -0,0 +1,30 @@
+/**
+ * testDetours — verify that all detour targets exist in the topo.
+ *
+ * Pure structural validation. No implementation execution needed.
+ */
+import { describe, expect, test } from 'bun:test';
+// ---------------------------------------------------------------------------
+// testDetours
+// ---------------------------------------------------------------------------
+/**
+ * Verify that every trail's detour targets reference trails that
+ * actually exist in the app's topo.
+ */
+export const testDetours = (app) => {
+    const trailEntries = [...app.trails];
+    describe('detours', () => {
+        describe.each(trailEntries)('%s', (_id, trailDef) => {
+            const t = trailDef;
+            if (t.detours === undefined) {
+                return;
+            }
+            const { detours } = t;
+            const testCases = Object.entries(detours).flatMap(([detourName, targets]) => targets.map((targetId) => ({ detourName, targetId })));
+            test.each(testCases)('detour "$detourName" -> "$targetId" exists', ({ targetId }) => {
+                expect(app.has(targetId)).toBe(true);
+            });
+        });
+    });
+};
+//# sourceMappingURL=detours.js.map

package/dist/detours.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detours.js","sourceRoot":"","sources":["../src/detours.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAIlD,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAS,EAAQ,EAAE;IAC7C,MAAM,YAAY,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAErC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE;YAClD,MAAM,CAAC,GAAG,QAAmC,CAAC;YAE9C,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YAED,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YACtB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAC/C,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,CACxB,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,CACxD,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAClB,4CAA4C,EAC5C,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;gBACf,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/examples.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 hikes with `follows`
+ * declarations, checks that every declared follow was called at least once.
+ */
+import type { Topo, TrailContext } from '@ontrails/core';
+/**
+ * Generate describe/test blocks for every trail example in the app.
+ *
+ * For hikes with `follows` declarations and examples, also verifies that
+ * every declared follow ID was called at least once across all examples.
+ *
+ * One line in your test file:
+ * ```ts
+ * testExamples(app);
+ * ```
+ */
+export declare const testExamples: (app: Topo, ctxOrFactory?: Partial<TrailContext> | (() => Partial<TrailContext>)) => void;
+//# sourceMappingURL=examples.d.ts.map

package/dist/examples.d.ts.map

@@ -0,0 +1 @@
+{"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;AAkQxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,IAAI,EACT,eAAe,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,KACnE,IAuBF,CAAC"}

package/dist/examples.js

@@ -0,0 +1,187 @@
+/**
+ * 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 hikes with `follows`
+ * declarations, checks that every declared follow was called at least once.
+ */
+import { describe, expect, test } from 'bun:test';
+import { AlreadyExistsError, AmbiguousError, AssertionError, AuthError, CancelledError, ConflictError, InternalError, NetworkError, NotFoundError, PermissionError, RateLimitError, Result, TimeoutError, TrailsError, ValidationError, validateInput, } from '@ontrails/core';
+import { assertErrorMatch, assertFullMatch, assertSchemaMatch, expectOk, } from './assertions.js';
+import { mergeTestContext } from './context.js';
+// ---------------------------------------------------------------------------
+// Error class name -> constructor map
+// ---------------------------------------------------------------------------
+const ERROR_MAP = {
+    AlreadyExistsError: AlreadyExistsError,
+    AmbiguousError: AmbiguousError,
+    AssertionError: AssertionError,
+    AuthError: AuthError,
+    CancelledError: CancelledError,
+    ConflictError: ConflictError,
+    InternalError: InternalError,
+    NetworkError: NetworkError,
+    NotFoundError: NotFoundError,
+    PermissionError: PermissionError,
+    RateLimitError: RateLimitError,
+    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) {
+        assertFullMatch(result, example.expected);
+        return;
+    }
+    if (example.error !== undefined) {
+        const errorClass = resolveErrorClass(example.error);
+        assertErrorMatch(result, errorClass);
+        return;
+    }
+    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}`);
+};
+/**
+ * Run a single example against a trail.
+ * Handles validation, execution, and assertions.
+ */
+const runExample = async (t, example, output, testCtx) => {
+    const validated = validateInput(t.input, example.input);
+    if (handleValidationError(validated, example)) {
+        return;
+    }
+    const validatedInput = expectOk(validated);
+    const result = await t.implementation(validatedInput, testCtx);
+    assertProgressiveMatch(result, example, output);
+};
+// ---------------------------------------------------------------------------
+// Follows coverage for hikes
+// ---------------------------------------------------------------------------
+/**
+ * Build a recording follow function that tracks which trail IDs are called.
+ *
+ * Delegates to `baseFollow` 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 createCoverageFollow = (called, baseFollow, topo, ctx) => {
+    const follow = (id, input) => {
+        called.add(id);
+        if (baseFollow !== undefined) {
+            return baseFollow(id, input);
+        }
+        const trailDef = topo.get(id);
+        if (trailDef !== undefined) {
+            const validated = validateInput(trailDef.input, input);
+            if (validated.isErr()) {
+                return Promise.resolve(validated);
+            }
+            return Promise.resolve(trailDef.implementation(validated.value, ctx));
+        }
+        return Promise.resolve(Result.ok());
+    };
+    return follow;
+};
+/**
+ * Run a single example against a hike, recording follow calls.
+ */
+const runHikeExample = async (hikeDef, example, output, baseCtx, called, topo) => {
+    const validated = validateInput(hikeDef.input, example.input);
+    if (handleValidationError(validated, example)) {
+        return;
+    }
+    const validatedInput = expectOk(validated);
+    const follow = createCoverageFollow(called, baseCtx.follow, topo, baseCtx);
+    const testCtx = { ...baseCtx, follow };
+    const result = await hikeDef.implementation(validatedInput, testCtx);
+    assertProgressiveMatch(result, example, output);
+};
+const collectHikesWithExamples = (app) => [...app.hikes]
+    .filter(([, h]) => h.examples !== undefined && h.examples.length > 0)
+    .map(([hikeId, hikeDef]) => ({
+    examples: hikeDef.examples,
+    hikeDef,
+    hikeId,
+}));
+// ---------------------------------------------------------------------------
+// Hike example describe blocks
+// ---------------------------------------------------------------------------
+/**
+ * Generate describe/test blocks for hikes with follows coverage.
+ *
+ * Always uses a recording follow so that follows coverage can be checked.
+ * Hikes without `follows` still run their examples but skip the coverage test.
+ */
+const describeHikeExamples = (hikesWithExamples, resolveCtx, topo) => {
+    if (hikesWithExamples.length === 0) {
+        return;
+    }
+    describe.each([...hikesWithExamples])('$hikeId', ({ hikeDef, examples }) => {
+        const called = new Set();
+        test.each([...examples])('example: $name', async (example) => {
+            const baseCtx = mergeTestContext(resolveCtx());
+            await runHikeExample(hikeDef, example, hikeDef.output, baseCtx, called, topo);
+        });
+        if (hikeDef.follows.length > 0) {
+            test('follows coverage', () => {
+                const uncovered = hikeDef.follows.filter((id) => !called.has(id));
+                expect(uncovered).toEqual([]);
+            });
+        }
+    });
+};
+// ---------------------------------------------------------------------------
+// testExamples
+// ---------------------------------------------------------------------------
+/**
+ * Generate describe/test blocks for every trail example in the app.
+ *
+ * For hikes with `follows` declarations and examples, also verifies that
+ * every declared follow ID was called at least once across all examples.
+ *
+ * One line in your test file:
+ * ```ts
+ * testExamples(app);
+ * ```
+ */
+export const testExamples = (app, ctxOrFactory) => {
+    const resolveCtx = typeof ctxOrFactory === 'function' ? ctxOrFactory : () => ctxOrFactory;
+    const trailEntries = [...app.trails];
+    describe.each(trailEntries)('%s', (_id, trailDef) => {
+        const t = trailDef;
+        if (t.examples === undefined || t.examples.length === 0) {
+            return;
+        }
+        const { examples, output } = t;
+        test.each([...examples])('example: $name', async (example) => {
+            const testCtx = mergeTestContext(resolveCtx());
+            await runExample(t, example, output, testCtx);
+        });
+    });
+    describeHikeExamples(collectHikesWithExamples(app), resolveCtx, app);
+};
+//# sourceMappingURL=examples.js.map

package/dist/examples.js.map

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

package/dist/harness-cli.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI integration test harness.
+ *
+ * Builds CLI commands from an App, 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 app's topo and provides a `run()` method
+ * that parses command strings and executes them in-process.
+ *
+ * ```ts
+ * const harness = createCliHarness({ app });
+ * 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

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

package/dist/harness-cli.js

@@ -0,0 +1,213 @@
+/**
+ * CLI integration test harness.
+ *
+ * Builds CLI commands from an App, executes them in-process,
+ * and captures stdout/stderr.
+ */
+import { buildCliCommands } from '@ontrails/cli';
+import { createTestContext } from './context.js';
+// ---------------------------------------------------------------------------
+// Tokenizer
+// ---------------------------------------------------------------------------
+/** Parse a command string into tokens (simple split, no quoting support). */
+const parseCommandString = (input) => input
+    .trim()
+    .split(/\s+/)
+    .filter((s) => s.length > 0);
+// ---------------------------------------------------------------------------
+// Command resolution
+// ---------------------------------------------------------------------------
+/** Try to match group + name from tokens. */
+const tryGroupMatch = (commands, firstToken, secondToken, tokens) => {
+    if (secondToken === undefined || secondToken.startsWith('-')) {
+        return undefined;
+    }
+    const match = commands.find((c) => c.group === firstToken && c.name === secondToken);
+    if (match === undefined) {
+        return undefined;
+    }
+    return { command: match, flagTokens: tokens.slice(2) };
+};
+/** Try to match a direct name from the first token. */
+const tryDirectMatch = (commands, firstToken, tokens) => {
+    const match = commands.find((c) => c.name === firstToken && c.group === undefined);
+    if (match === undefined) {
+        return undefined;
+    }
+    return { command: match, flagTokens: tokens.slice(1) };
+};
+/** Resolve a command from tokens, handling group.name patterns. */
+const resolveCommand = (commands, tokens) => {
+    const [firstToken, secondToken] = tokens;
+    if (firstToken === undefined) {
+        return undefined;
+    }
+    return (tryGroupMatch(commands, firstToken, secondToken, tokens) ??
+        tryDirectMatch(commands, firstToken, tokens));
+};
+// ---------------------------------------------------------------------------
+// Flag parsing
+// ---------------------------------------------------------------------------
+/** Parse a value flag (--key value) and return new index. */
+const parseValueFlag = (key, next, flags) => {
+    const num = Number(next);
+    flags[key] = Number.isNaN(num) ? next : num;
+};
+/** Parse a single flag token and advance the index. */
+const parseSingleFlag = (tokens, i, flags) => {
+    const token = tokens[i];
+    if (token === undefined || !token.startsWith('--')) {
+        return i + 1;
+    }
+    const key = token.slice(2);
+    const next = tokens[i + 1];
+    if (next !== undefined && !next.startsWith('-')) {
+        parseValueFlag(key, next, flags);
+        return i + 2;
+    }
+    flags[key] = true;
+    return i + 1;
+};
+/** Parse flag tokens into a record. */
+const parseFlagTokens = (tokens) => {
+    const flags = {};
+    let i = 0;
+    while (i < tokens.length) {
+        i = parseSingleFlag(tokens, i, flags);
+    }
+    return flags;
+};
+/** Create interceptors for stdout/stderr capture. */
+const captureStreams = () => {
+    let stdout = '';
+    let stderr = '';
+    const origStdoutWrite = process.stdout.write;
+    const origStderrWrite = process.stderr.write;
+    process.stdout.write = ((chunk) => {
+        stdout +=
+            typeof chunk === 'string' ? chunk : new TextDecoder().decode(chunk);
+        return true;
+    });
+    process.stderr.write = ((chunk) => {
+        stderr +=
+            typeof chunk === 'string' ? chunk : new TextDecoder().decode(chunk);
+        return true;
+    });
+    return {
+        getStderr: () => stderr,
+        getStdout: () => stdout,
+        restore: () => {
+            process.stdout.write = origStdoutWrite;
+            process.stderr.write = origStderrWrite;
+        },
+        writeStdout: (text) => {
+            stdout += text;
+        },
+    };
+};
+// ---------------------------------------------------------------------------
+// Output formatting
+// ---------------------------------------------------------------------------
+/** Try to parse a string as JSON, returning undefined on failure. */
+const tryParseJson = (text) => {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+};
+/** Format result value into stdout and build the CLI result. */
+const formatSuccessResult = (value, flags, streams) => {
+    const outputMode = flags['output'] ?? (flags['json'] === true ? 'json' : 'text');
+    if (outputMode === 'json') {
+        const jsonStr = `${JSON.stringify(value, null, 2)}\n`;
+        streams.writeStdout(jsonStr);
+        return {
+            exitCode: 0,
+            json: tryParseJson(jsonStr),
+            stderr: streams.getStderr(),
+            stdout: streams.getStdout(),
+        };
+    }
+    const formatted = typeof value === 'string'
+        ? `${value}\n`
+        : `${JSON.stringify(value, null, 2)}\n`;
+    streams.writeStdout(formatted);
+    return {
+        exitCode: 0,
+        json: tryParseJson(streams.getStdout().trim()),
+        stderr: streams.getStderr(),
+        stdout: streams.getStdout(),
+    };
+};
+// ---------------------------------------------------------------------------
+// Execute command
+// ---------------------------------------------------------------------------
+/** Build an error result from a caught exception. */
+const buildErrorResult = (error, streams) => {
+    streams.restore();
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        exitCode: 1,
+        stderr: streams.getStderr() || message,
+        stdout: streams.getStdout(),
+    };
+};
+/** Execute a resolved command and return the result. */
+const executeCommand = async (command, flags, streams) => {
+    const ctx = createTestContext();
+    const result = await command.execute({}, flags, ctx);
+    streams.restore();
+    if (result.isErr()) {
+        return {
+            exitCode: 1,
+            stderr: streams.getStderr() || result.error.message,
+            stdout: streams.getStdout(),
+        };
+    }
+    return formatSuccessResult(result.value, flags, streams);
+};
+/** Run the full command pipeline: resolve, parse, execute. */
+const runCommand = async (commands, commandString) => {
+    const parts = parseCommandString(commandString);
+    const resolved = resolveCommand(commands, parts);
+    if (resolved === undefined) {
+        return {
+            exitCode: 1,
+            stderr: `Unknown command: ${commandString}`,
+            stdout: '',
+        };
+    }
+    const { command, flagTokens } = resolved;
+    const flags = parseFlagTokens(flagTokens);
+    const streams = captureStreams();
+    try {
+        return await executeCommand(command, flags, streams);
+    }
+    catch (error) {
+        return buildErrorResult(error, streams);
+    }
+};
+// ---------------------------------------------------------------------------
+// createCliHarness
+// ---------------------------------------------------------------------------
+/**
+ * Create a CLI harness for integration testing.
+ *
+ * Builds commands from the app's topo and provides a `run()` method
+ * that parses command strings and executes them in-process.
+ *
+ * ```ts
+ * const harness = createCliHarness({ app });
+ * const result = await harness.run("entity show --name Alpha --output json");
+ * expect(result.exitCode).toBe(0);
+ * ```
+ */
+export const createCliHarness = (options) => {
+    const commands = buildCliCommands(options.app);
+    return {
+        run: (commandString) => runCommand(commands, commandString),
+    };
+};
+//# sourceMappingURL=harness-cli.js.map

package/dist/harness-cli.js.map

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

package/dist/harness-mcp.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP integration test harness.
+ *
+ * Builds MCP tools from an App, invokes them directly (no transport),
+ * and returns the MCP tool response.
+ */
+import type { McpHarness, McpHarnessOptions } from './types.js';
+/**
+ * Create an MCP harness for integration testing.
+ *
+ * Builds MCP tools from the app's topo and provides a `callTool()` method
+ * that invokes tools directly without any transport layer.
+ *
+ * ```ts
+ * const harness = createMcpHarness({ app });
+ * const result = await harness.callTool("myapp_entity_show", { name: "Alpha" });
+ * expect(result.isError).toBe(false);
+ * ```
+ */
+export declare const createMcpHarness: (options: McpHarnessOptions) => McpHarness;
+//# sourceMappingURL=harness-mcp.d.ts.map

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

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

package/dist/harness-mcp.js

@@ -0,0 +1,50 @@
+/**
+ * MCP integration test harness.
+ *
+ * Builds MCP tools from an App, invokes them directly (no transport),
+ * and returns the MCP tool response.
+ */
+import { buildMcpTools } from '@ontrails/mcp';
+// ---------------------------------------------------------------------------
+// createMcpHarness
+// ---------------------------------------------------------------------------
+/**
+ * Create an MCP harness for integration testing.
+ *
+ * Builds MCP tools from the app's topo and provides a `callTool()` method
+ * that invokes tools directly without any transport layer.
+ *
+ * ```ts
+ * const harness = createMcpHarness({ app });
+ * const result = await harness.callTool("myapp_entity_show", { name: "Alpha" });
+ * expect(result.isError).toBe(false);
+ * ```
+ */
+export const createMcpHarness = (options) => {
+    const tools = buildMcpTools(options.app);
+    const toolMap = new Map();
+    for (const tool of tools) {
+        toolMap.set(tool.name, tool);
+    }
+    return {
+        async callTool(name, args) {
+            const tool = toolMap.get(name);
+            if (tool === undefined) {
+                return {
+                    content: [{ text: `Unknown tool: ${name}`, type: 'text' }],
+                    isError: true,
+                };
+            }
+            const result = await tool.handler(args, {
+                progressToken: undefined,
+                sendProgress: undefined,
+                signal: undefined,
+            });
+            return {
+                content: result.content,
+                isError: result.isError ?? false,
+            };
+        },
+    };
+};
+//# sourceMappingURL=harness-mcp.js.map

package/dist/harness-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-mcp.js","sourceRoot":"","sources":["../src/harness-mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAS9C,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAA0B,EAAc,EAAE;IACzE,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO;QACL,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,IAA6B;YAE7B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;oBAC1D,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;gBACtC,aAAa,EAAE,SAAS;gBACxB,YAAY,EAAE,SAAS;gBACvB,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,KAAK;aACjC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/hike.d.ts

@@ -0,0 +1,32 @@
+/**
+ * testHike — composition-aware scenario testing for hikes.
+ *
+ * Tests the composition graph: which trails were followed, in what order,
+ * and supports failure injection from followed trail examples.
+ */
+import type { AnyHike, AnyTrail, TrailContext } from '@ontrails/core';
+import type { HikeScenario } from './types.js';
+/** Options for testHike that provide trail definitions for injection. */
+export interface TestHikeOptions {
+    /** Partial context overrides. */
+    readonly ctx?: Partial<TrailContext> | undefined;
+    /** Map of trail ID to trail definition, used for injectFromExample. */
+    readonly trails?: ReadonlyMap<string, AnyTrail> | undefined;
+}
+/**
+ * Generate a describe block for a hike with one test per scenario.
+ *
+ * @example
+ * ```ts
+ * testHike(onboardHike, [
+ *   {
+ *     description: "follows add then relate",
+ *     input: { name: "Alpha" },
+ *     expectOk: true,
+ *     expectFollowed: ["entity.add", "entity.relate"],
+ *   },
+ * ]);
+ * ```
+ */
+export declare const testHike: (hikeDef: AnyHike, scenarios: readonly HikeScenario[], options?: TestHikeOptions) => void;
+//# sourceMappingURL=hike.d.ts.map

package/dist/hike.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hike.d.ts","sourceRoot":"","sources":["../src/hike.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAY,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAehF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA8N/C,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IACjD,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC;CAC7D;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,GACnB,SAAS,OAAO,EAChB,WAAW,SAAS,YAAY,EAAE,EAClC,UAAU,eAAe,KACxB,IASF,CAAC"}