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

package/dist/logger.js

@@ -1,87 +0,0 @@
-/**
- * Test logger that captures log records for assertion.
- */
-// ---------------------------------------------------------------------------
-// Level ordering for filtering
-// ---------------------------------------------------------------------------
-const LEVEL_ORDER = {
-    debug: 1,
-    error: 4,
-    fatal: 5,
-    info: 2,
-    silent: 6,
-    trace: 0,
-    warn: 3,
-};
-// ---------------------------------------------------------------------------
-// Internal factory (shared between root and child loggers)
-// ---------------------------------------------------------------------------
-const createTestLoggerInternal = (name, minLevel, sharedEntries, baseMetadata) => {
-    const minOrder = LEVEL_ORDER[minLevel] ?? 0;
-    const shouldLog = (level) => (LEVEL_ORDER[level] ?? 0) >= minOrder;
-    const log = (level, message, metadata) => {
-        if (!shouldLog(level)) {
-            return;
-        }
-        const record = {
-            category: name,
-            level,
-            message,
-            metadata: { ...baseMetadata, ...metadata },
-            timestamp: new Date(),
-        };
-        sharedEntries.push(record);
-    };
-    return {
-        assertLogged(level, messageSubstring) {
-            const match = sharedEntries.find((r) => r.level === level && r.message.includes(messageSubstring));
-            if (match === undefined) {
-                throw new Error(`Expected a log entry with level="${level}" containing "${messageSubstring}", but none was found. ` +
-                    `Entries: ${JSON.stringify(sharedEntries.map((r) => ({ level: r.level, message: r.message })))}`);
-            }
-        },
-        child(metadata) {
-            const merged = { ...baseMetadata, ...metadata };
-            return createTestLoggerInternal(name, minLevel, sharedEntries, merged);
-        },
-        clear() {
-            sharedEntries.length = 0;
-        },
-        debug(message, metadata) {
-            log('debug', message, metadata);
-        },
-        get entries() {
-            return sharedEntries;
-        },
-        error(message, metadata) {
-            log('error', message, metadata);
-        },
-        fatal(message, metadata) {
-            log('fatal', message, metadata);
-        },
-        find(predicate) {
-            return sharedEntries.filter(predicate);
-        },
-        info(message, metadata) {
-            log('info', message, metadata);
-        },
-        name,
-        trace(message, metadata) {
-            log('trace', message, metadata);
-        },
-        warn(message, metadata) {
-            log('warn', message, metadata);
-        },
-    };
-};
-// ---------------------------------------------------------------------------
-// createTestLogger
-// ---------------------------------------------------------------------------
-/**
- * Create a test logger that captures all log records in an array.
- *
- * Records are not printed. Use `entries`, `find()`, and `assertLogged()`
- * to inspect what was logged during a test.
- */
-export const createTestLogger = (options) => createTestLoggerInternal('test', options?.level ?? 'trace', [], {});
-//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/trail.d.ts

@@ -1,20 +0,0 @@
-/**
- * testTrail — custom scenario testing for individual trails.
- *
- * Use this for edge cases, boundary values, and regression tests
- * that don't belong in `examples` (which are agent-facing documentation).
- */
-import type { AnyTrail, TrailContext } from '@ontrails/core';
-import type { TestScenario } from './types.js';
-/**
- * Generate a describe block for a trail with one test per scenario.
- *
- * ```ts
- * testTrail(myTrail, [
- *   { description: "valid input", input: { name: "Alpha" }, expectOk: true },
- *   { description: "missing name", input: {}, expectErr: ValidationError },
- * ]);
- * ```
- */
-export declare const testTrail: (trailDef: AnyTrail, scenarios: readonly TestScenario[], ctx?: Partial<TrailContext>) => void;
-//# 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":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAUrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAyE/C;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,QAAQ,EAClB,WAAW,SAAS,YAAY,EAAE,EAClC,MAAM,OAAO,CAAC,YAAY,CAAC,KAC1B,IASF,CAAC"}

package/dist/trail.js

@@ -1,80 +0,0 @@
-/**
- * testTrail — custom scenario testing for individual trails.
- *
- * Use this for edge cases, boundary values, and regression tests
- * that don't belong in `examples` (which are agent-facing documentation).
- */
-import { describe, expect, test } from 'bun:test';
-import { ValidationError, validateInput } from '@ontrails/core';
-import { assertErrorMatch, assertFullMatch, assertSchemaMatch, expectOk, } from './assertions.js';
-import { mergeTestContext } from './context.js';
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-const assertScenarioResult = (result, scenario, trailDef) => {
-    if (scenario.expectValue !== undefined) {
-        assertFullMatch(result, scenario.expectValue);
-    }
-    else if (scenario.expectErr !== undefined) {
-        assertErrorMatch(result, scenario.expectErr, scenario.expectErrMessage);
-    }
-    else if (scenario.expectErrMessage !== undefined) {
-        expect(result.isErr()).toBe(true);
-        if (result.isErr()) {
-            expect(result.error.message).toContain(scenario.expectErrMessage);
-        }
-    }
-    else if (scenario.expectOk === true) {
-        expect(result.isOk()).toBe(true);
-        assertSchemaMatch(result, trailDef.output);
-    }
-};
-/**
- * Handle input validation failure for a scenario.
- * Returns true if the error was expected and handled.
- * Throws if the error was unexpected.
- */
-const handleValidationError = (validated, scenario) => {
-    if (!validated.isErr()) {
-        return false;
-    }
-    if (scenario.expectErr === ValidationError) {
-        expect(validated.error).toBeInstanceOf(ValidationError);
-        if (scenario.expectErrMessage !== undefined) {
-            expect(validated.error.message).toContain(scenario.expectErrMessage);
-        }
-        return true;
-    }
-    throw new Error(`Input validation failed unexpectedly: ${validated.error.message}`);
-};
-const runScenario = async (trailDef, scenario, ctx) => {
-    const testCtx = mergeTestContext(ctx);
-    const validated = validateInput(trailDef.input, scenario.input);
-    if (handleValidationError(validated, scenario)) {
-        return;
-    }
-    const validatedInput = expectOk(validated);
-    const result = await trailDef.blaze(validatedInput, testCtx);
-    assertScenarioResult(result, scenario, trailDef);
-};
-// ---------------------------------------------------------------------------
-// testTrail
-// ---------------------------------------------------------------------------
-/**
- * Generate a describe block for a trail with one test per scenario.
- *
- * ```ts
- * testTrail(myTrail, [
- *   { description: "valid input", input: { name: "Alpha" }, expectOk: true },
- *   { description: "missing name", input: {}, expectErr: ValidationError },
- * ]);
- * ```
- */
-export const testTrail = (trailDef, scenarios, ctx) => {
-    describe(trailDef.id, () => {
-        test.each([...scenarios])('$description', async (scenario) => {
-            await runScenario(trailDef, scenario, ctx);
-        });
-    });
-};
-//# sourceMappingURL=trail.js.map

package/dist/trail.js.map

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

package/dist/types.d.ts

@@ -1,80 +0,0 @@
-/**
- * Shared types for @ontrails/testing.
- */
-import type { Logger, Topo } from '@ontrails/core';
-import type { LogLevel, LogRecord } from '@ontrails/logging';
-/** A custom test scenario for a single trail. */
-export interface TestScenario {
-    /** Description shown in test output. */
-    readonly description?: string | undefined;
-    /** Assert the result error has this message (substring match). */
-    readonly expectErrMessage?: string | undefined;
-    /** Assert the result is an error of this type. */
-    readonly expectErr?: (new (...args: never[]) => Error) | undefined;
-    /** Assert the result is ok. */
-    readonly expectOk?: boolean | undefined;
-    /** Assert the result value equals this. */
-    readonly expectValue?: unknown | undefined;
-    /** Input to pass to the implementation. */
-    readonly input: unknown;
-}
-/** A test scenario for a trail's crossing graph. */
-export interface CrossScenario extends TestScenario {
-    /** Assert these trail IDs were crossed, in order. */
-    readonly expectCrossed?: readonly string[] | undefined;
-    /** Assert crossing counts per trail ID. */
-    readonly expectCrossedCount?: Readonly<Record<string, number>> | undefined;
-    /** Inject failure from a crossed trail's example by description. */
-    readonly injectFromExample?: Readonly<Record<string, string>> | undefined;
-}
-/** A logger that captures entries for assertion in tests. */
-export interface TestLogger extends Logger {
-    /** All log records captured during the test. */
-    readonly entries: readonly LogRecord[];
-    /** Clear captured entries. */
-    clear(): void;
-    /** Find entries matching a predicate. */
-    find(predicate: (record: LogRecord) => boolean): readonly LogRecord[];
-    /** Assert that at least one entry matches. */
-    assertLogged(level: LogLevel, messageSubstring: string): void;
-}
-/** Options for creating a test trail context. */
-export interface TestTrailContextOptions {
-    readonly cwd?: string | undefined;
-    readonly env?: Record<string, string> | undefined;
-    readonly logger?: Logger | undefined;
-    readonly requestId?: string | undefined;
-    readonly abortSignal?: AbortSignal | undefined;
-}
-/** Options for creating a CLI harness. */
-export interface CliHarnessOptions {
-    readonly app: Topo;
-}
-/** A test harness for CLI commands. */
-export interface CliHarness {
-    /** Execute a CLI command string and capture output. */
-    run(command: string): Promise<CliHarnessResult>;
-}
-/** The result of a CLI harness command execution. */
-export interface CliHarnessResult {
-    readonly exitCode: number;
-    /** Parsed JSON output if --output json was used. */
-    readonly json?: unknown | undefined;
-    readonly stderr: string;
-    readonly stdout: string;
-}
-/** Options for creating an MCP harness. */
-export interface McpHarnessOptions {
-    readonly app: Topo;
-}
-/** A test harness for MCP tools. */
-export interface McpHarness {
-    /** Call an MCP tool by name with arguments. */
-    callTool(name: string, args: Record<string, unknown>): Promise<McpHarnessResult>;
-}
-/** The result of an MCP harness tool invocation. */
-export interface McpHarnessResult {
-    readonly content: unknown;
-    readonly isError: boolean;
-}
-//# 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,5 +0,0 @@
-/**
- * Shared types for @ontrails/testing.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/src/__tests__/all.test.ts

@@ -1,135 +0,0 @@
-import { describe } from 'bun:test';
-
-import { Result, trail, topo } from '@ontrails/core';
-import { z } from 'zod';
-
-import { testAll } from '../all.js';
-import { store as defineStore } from '@ontrails/store';
-import { connectDrizzle } from '@ontrails/store/drizzle';
-
-const dbDefinition = defineStore({
-  entities: {
-    fixtures: [
-      {
-        id: 'seed-1',
-        name: 'Alpha',
-        source: 'mock',
-      },
-    ],
-    generated: ['id'],
-    primaryKey: 'id',
-    schema: z.object({
-      id: z.string(),
-      name: z.string(),
-      source: z.string(),
-    }),
-  },
-});
-
-const createDbProvision = (
-  seed?: readonly {
-    readonly id: string;
-    readonly name: string;
-    readonly source: string;
-  }[]
-) =>
-  connectDrizzle(dbDefinition, {
-    id: 'db.mock.all',
-    ...(seed === undefined ? {} : { mockSeed: { entities: seed } }),
-    url: ':memory:',
-  });
-
-const createOverrideStore = () => {
-  const { mock } = createDbProvision([
-    {
-      id: 'seed-1',
-      name: 'Override',
-      source: 'override',
-    },
-  ]);
-
-  if (mock === undefined) {
-    throw new Error('Expected drizzle test store to expose a mock factory');
-  }
-
-  const created = mock();
-  if (created instanceof Promise) {
-    throw new TypeError(
-      'Expected drizzle test store mock to resolve synchronously'
-    );
-  }
-
-  return created;
-};
-
-const mockDbProvision = createDbProvision();
-
-const mockedTrail = trail('provision.mocked.all', {
-  blaze: async (_input, ctx) => {
-    const entity = await mockDbProvision.from(ctx).entities.get('seed-1');
-    if (entity === null) {
-      return Result.err(new Error('expected seeded entity to exist'));
-    }
-
-    return Result.ok({ name: entity.name, source: entity.source });
-  },
-  description:
-    'Trail that uses a mocked connector-bound provision through testAll',
-  examples: [
-    {
-      expected: { name: 'Alpha', source: 'mock' },
-      input: {},
-      name: 'Uses auto-resolved provision mock',
-    },
-  ],
-  input: z.object({}),
-  output: z.object({ name: z.string(), source: z.string() }),
-  provisions: [mockDbProvision],
-});
-
-const overrideTrail = trail('provision.override.all', {
-  blaze: async (_input, ctx) => {
-    const entity = await mockDbProvision.from(ctx).entities.get('seed-1');
-    if (entity === null) {
-      return Result.err(new Error('expected overridden entity to exist'));
-    }
-
-    return Result.ok({ name: entity.name, source: entity.source });
-  },
-  description: 'Trail that prefers explicit overrides over mock factories',
-  examples: [
-    {
-      expected: { name: 'Override', source: 'override' },
-      input: {},
-      name: 'Explicit provision override wins',
-    },
-  ],
-  input: z.object({}),
-  output: z.object({ name: z.string(), source: z.string() }),
-  provisions: [mockDbProvision],
-});
-
-describe('testAll provision mocks', () => {
-  // eslint-disable-next-line jest/require-hook
-  testAll(
-    topo('test-all-provision-mock-app', {
-      mockDbProvision,
-      mockedTrail,
-    } as Record<string, unknown>)
-  );
-});
-
-describe('testAll explicit provision overrides', () => {
-  // eslint-disable-next-line jest/require-hook
-  testAll(
-    topo('test-all-provision-override-app', {
-      mockDbProvision,
-      overrideTrail,
-    } as Record<string, unknown>),
-    () => ({
-      provisions: {
-        'db.mock.all': createOverrideStore(),
-      },
-    })
-  );
-});

package/src/__tests__/context.test.ts

@@ -1,150 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-
-import { Result, provision, topo } from '@ontrails/core';
-
-import {
-  createCrossContext,
-  createTestContext,
-  mergeTestContext,
-  resolveMockProvisions,
-} from '../context.js';
-import type { TestLogger } from '../types.js';
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-describe('createTestContext', () => {
-  test('produces a valid TrailContext with no args', () => {
-    const ctx = createTestContext();
-    expect(ctx.cwd).toBe(process.cwd());
-    expect(ctx.requestId).toBe('test-request-001');
-    expect(ctx.abortSignal).toBeDefined();
-    expect(ctx.abortSignal.aborted).toBe(false);
-    expect(ctx.logger).toBeDefined();
-    expect(ctx.workspaceRoot).toBe(process.cwd());
-  });
-
-  test('default logger is a TestLogger', () => {
-    const ctx = createTestContext();
-    const logger = ctx.logger as TestLogger;
-    expect(typeof logger.info).toBe('function');
-    expect(typeof logger.clear).toBe('function');
-    expect(typeof logger.find).toBe('function');
-    expect(typeof logger.assertLogged).toBe('function');
-    expect(logger.entries).toBeDefined();
-  });
-
-  test('default env is set to test', () => {
-    const ctx = createTestContext();
-    const env = ctx['env'] as Record<string, string>;
-    expect(env).toEqual({ TRAILS_ENV: 'test' });
-  });
-
-  test('overrides requestId', () => {
-    const ctx = createTestContext({ requestId: 'custom-id' });
-    expect(ctx.requestId).toBe('custom-id');
-  });
-
-  test('overrides abortSignal', () => {
-    const controller = new AbortController();
-    controller.abort();
-    const ctx = createTestContext({ abortSignal: controller.signal });
-    expect(ctx.abortSignal.aborted).toBe(true);
-  });
-
-  test('overrides cwd', () => {
-    const ctx = createTestContext({ cwd: '/tmp/test' });
-    expect(ctx.cwd).toBe('/tmp/test');
-    expect(ctx.workspaceRoot).toBe('/tmp/test');
-  });
-
-  test('overrides env', () => {
-    const ctx = createTestContext({
-      env: { CUSTOM: '1', NODE_ENV: 'test' },
-    });
-    const env = ctx['env'] as Record<string, string>;
-    expect(env).toEqual({ CUSTOM: '1', NODE_ENV: 'test' });
-  });
-});
-
-describe('createCrossContext', () => {
-  test('returns configured ok response for registered id', async () => {
-    const cross = createCrossContext({
-      responses: { 'entity.add': Result.ok({ id: '1', name: 'Alpha' }) },
-    });
-    const result = await cross('entity.add', { name: 'Alpha' });
-    expect(result.unwrap()).toEqual({ id: '1', name: 'Alpha' });
-  });
-
-  test('returns configured err response for registered id', async () => {
-    const err = new Error('conflict');
-    const cross = createCrossContext({
-      responses: { 'entity.add': Result.err(err) },
-    });
-    const result = await cross('entity.add', {});
-    expect(result.isErr()).toBe(true);
-    expect(result.error?.message).toBe('conflict');
-  });
-
-  test('returns err with descriptive message for unregistered id', async () => {
-    const cross = createCrossContext();
-    const result = await cross('unknown.trail', {});
-    expect(result.isErr()).toBe(true);
-    expect(result.error?.message).toContain('unknown.trail');
-  });
-
-  test('no options defaults to empty responses', async () => {
-    const cross = createCrossContext();
-    const result = await cross('any.id', {});
-    expect(result.isErr()).toBe(true);
-  });
-});
-
-describe('mergeTestContext', () => {
-  test('merges provision overrides into extensions and the provision accessor', () => {
-    const ctx = mergeTestContext(
-      {
-        extensions: { existing: true },
-      },
-      { 'db.main': { source: 'mock' } }
-    );
-
-    expect(ctx.extensions).toEqual({
-      'db.main': { source: 'mock' },
-      existing: true,
-    });
-    expect(ctx.provision<{ source: string }>('db.main').source).toBe('mock');
-  });
-});
-
-describe('resolveMockProvisions', () => {
-  test('creates fresh mock provisions for each invocation', async () => {
-    let mockCalls = 0;
-    const mockable = provision(`provision.mock.${Bun.randomUUIDv7()}`, {
-      create: () => Result.ok({ source: 'factory' }),
-      mock: () => {
-        mockCalls += 1;
-        return Promise.resolve({ source: 'mock' });
-      },
-    });
-    const app = topo('mock-app', { mockable } as Record<string, unknown>);
-
-    const first = await resolveMockProvisions(app);
-    const second = await resolveMockProvisions(app);
-
-    expect(first).toEqual({ [mockable.id]: { source: 'mock' } });
-    expect(second).toEqual(first);
-    expect(second[mockable.id]).not.toBe(first[mockable.id]);
-    expect(mockCalls).toBe(2);
-  });
-
-  test('skips provisions without mock factories', async () => {
-    const plain = provision(`provision.plain.${Bun.randomUUIDv7()}`, {
-      create: () => Result.ok({ source: 'factory' }),
-    });
-    const app = topo('plain-app', { plain } as Record<string, unknown>);
-
-    expect(await resolveMockProvisions(app)).toEqual({});
-  });
-});