@kronos-ts/test 0.1.0

package/dist/fixture.d.ts

@@ -0,0 +1,78 @@
+import { type Metadata } from "@kronos-ts/common";
+import type { CommandDescriptor, EventDescriptor, EventMessage, CommandMessage } from "@kronos-ts/messaging";
+import { type App, type RunningApp } from "@kronos-ts/app";
+import type { z } from "zod";
+type EventPair = [EventDescriptor<any>, unknown];
+type CommandPair = [CommandDescriptor<any>, unknown];
+/**
+ * Creates a BDD test fixture that runs your REAL application code
+ * against an in-memory event store with recording decorators.
+ *
+ * Pass a configuration function that sets up the same domain
+ * as your production app via the kronos() App fluent surface.
+ *
+ * ```typescript
+ * const fixture = await createTestFixture((app) => {
+ *   app.states(Course)
+ *   app.commands(createCourse, subscribeStudent)
+ *   app.queries(getCourseView, getAllCourses)
+ * })
+ *
+ * await fixture
+ *   .given()
+ *     .events([CourseCreated, { courseId: "cs-101", name: "Intro", capacity: 30 }])
+ *   .when()
+ *     .command(SubscribeStudent, { courseId: "cs-101", studentId: "stu-001" })
+ *   .then()
+ *     .expectSuccess()
+ *     .expectEvents([StudentSubscribed, { courseId: "cs-101", studentId: "stu-001" }])
+ *
+ * await fixture.stop()
+ * ```
+ */
+export declare function createTestFixture(configureFn: (app: App) => void): Promise<TestFixture>;
+export interface TestFixture {
+    given(): GivenPhase;
+    stop(): Promise<void>;
+}
+export interface GivenPhase {
+    events(...pairs: EventPair[]): GivenPhase;
+    commands(...pairs: CommandPair[]): GivenPhase;
+    execute(fn: (app: RunningApp) => void | Promise<void>): GivenPhase;
+    noPriorActivity(): GivenPhase;
+    when(): WhenPhase;
+}
+export interface WhenPhase {
+    command<P extends z.ZodType>(descriptor: CommandDescriptor<P>, payload: z.infer<P>, metadata?: Metadata): WhenResult;
+    event<P extends z.ZodType>(descriptor: EventDescriptor<P>, payload: z.infer<P>, metadata?: Metadata): WhenResult;
+    nothing(): WhenResult;
+}
+export interface WhenResult {
+    then(): ThenPhase;
+}
+export interface ThenPhase extends PromiseLike<void> {
+    expectEvents(...pairs: EventPair[]): ThenPhase;
+    expectNoEvents(): ThenPhase;
+    expectSuccess(): ThenPhase;
+    expectResult(expected: unknown): ThenPhase;
+    expectResultSatisfying(fn: (result: unknown) => void): ThenPhase;
+    expectResultPayloadSatisfying<T>(fn: (payload: T) => void): ThenPhase;
+    expectException(messageSubstring: string): ThenPhase;
+    expectExceptionType(errorName: string): ThenPhase;
+    expectExceptionSatisfying(fn: (error: unknown) => void): ThenPhase;
+    expectEventsSatisfying(fn: (events: ReadonlyArray<EventMessage>) => void): ThenPhase;
+    expectCommands(...pairs: CommandPair[]): ThenPhase;
+    expectNoCommands(): ThenPhase;
+    expectCommandsSatisfying(fn: (commands: ReadonlyArray<CommandMessage>) => void): ThenPhase;
+    expect(fn: (app: RunningApp) => void | Promise<void>): ThenPhase;
+    await(assertion: (app: RunningApp) => void | Promise<void>, timeoutMs?: number, intervalMs?: number): ThenPhase;
+    and(): TestFixture;
+}
+export declare class FixtureAssertionError extends Error {
+    constructor(message: string);
+}
+export type FieldFilter = (fieldName: string, owner: unknown) => boolean;
+export declare const allFieldsFilter: FieldFilter;
+export declare function ignoreFields(...fieldNames: string[]): FieldFilter;
+export {};
+//# sourceMappingURL=fixture.d.ts.map

package/dist/fixture.d.ts.map

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

package/dist/fixture.js

@@ -0,0 +1,424 @@
+import { generateIdentifier, emptyMetadata, qualifiedNameToString, } from "@kronos-ts/common";
+import { runInNewUoW } from "@kronos-ts/messaging";
+import { kronos } from "@kronos-ts/app";
+import { createRecordings, testRecordingExtension, } from "./recording-enhancer.js";
+// ---------------------------------------------------------------------------
+// Fixture entry point
+// ---------------------------------------------------------------------------
+/**
+ * Creates a BDD test fixture that runs your REAL application code
+ * against an in-memory event store with recording decorators.
+ *
+ * Pass a configuration function that sets up the same domain
+ * as your production app via the kronos() App fluent surface.
+ *
+ * ```typescript
+ * const fixture = await createTestFixture((app) => {
+ *   app.states(Course)
+ *   app.commands(createCourse, subscribeStudent)
+ *   app.queries(getCourseView, getAllCourses)
+ * })
+ *
+ * await fixture
+ *   .given()
+ *     .events([CourseCreated, { courseId: "cs-101", name: "Intro", capacity: 30 }])
+ *   .when()
+ *     .command(SubscribeStudent, { courseId: "cs-101", studentId: "stu-001" })
+ *   .then()
+ *     .expectSuccess()
+ *     .expectEvents([StudentSubscribed, { courseId: "cs-101", studentId: "stu-001" }])
+ *
+ * await fixture.stop()
+ * ```
+ */
+export async function createTestFixture(configureFn) {
+    const recordings = createRecordings();
+    const app = kronos({ quiet: true });
+    // Apply testRecordingExtension synchronously BEFORE configureFn so its
+    // decorators land FIRST in the registration order — Phase 6 D-62: first
+    // registered = innermost wrap. Recording must be innermost so it captures
+    // messages AFTER all interceptors have enriched them.
+    testRecordingExtension(recordings)(app);
+    // Capture the eventStore reference via an identity decorator so the BDD
+    // given/when paths can append events directly. The decorator runs as
+    // part of the user-decorator pass at .start(), so it sees whatever
+    // (recording-wrapped) store the framework resolved.
+    let capturedEventStore;
+    app.decorate("eventStore", (inner) => {
+        capturedEventStore = inner;
+        return inner;
+    });
+    configureFn(app);
+    const running = await app.start();
+    if (!capturedEventStore) {
+        throw new Error("Test fixture: eventStore capture failed (start() did not run probe decorator).");
+    }
+    const eventStore = capturedEventStore;
+    return {
+        given() {
+            return new GivenPhaseImpl(running, recordings, eventStore);
+        },
+        async stop() {
+            await running.stop();
+        },
+    };
+}
+class GivenPhaseImpl {
+    app;
+    recordings;
+    eventStore;
+    givenEvents = [];
+    givenCommands = [];
+    givenSetupFns = [];
+    _prerequisite;
+    constructor(app, recordings, eventStore) {
+        this.app = app;
+        this.recordings = recordings;
+        this.eventStore = eventStore;
+    }
+    events(...pairs) {
+        this.givenEvents.push(...pairs);
+        return this;
+    }
+    commands(...pairs) {
+        this.givenCommands.push(...pairs);
+        return this;
+    }
+    execute(fn) {
+        this.givenSetupFns.push(fn);
+        return this;
+    }
+    noPriorActivity() {
+        return this;
+    }
+    when() {
+        return new WhenPhaseImpl(this.app, this.recordings, this.eventStore, this.givenEvents, this.givenCommands, this.givenSetupFns, this._prerequisite);
+    }
+}
+class WhenPhaseImpl {
+    app;
+    recordings;
+    eventStore;
+    givenEvents;
+    givenCommands;
+    givenSetupFns;
+    prerequisite;
+    constructor(app, recordings, eventStore, givenEvents, givenCommands, givenSetupFns, prerequisite) {
+        this.app = app;
+        this.recordings = recordings;
+        this.eventStore = eventStore;
+        this.givenEvents = givenEvents;
+        this.givenCommands = givenCommands;
+        this.givenSetupFns = givenSetupFns;
+        this.prerequisite = prerequisite;
+    }
+    command(descriptor, payload, metadata) {
+        const thenPhase = new ThenPhaseImpl(this.app, this.recordings, this.eventStore, this.givenEvents, this.givenCommands, this.givenSetupFns, { kind: "command", descriptor, payload, metadata }, this.prerequisite);
+        return { then: () => thenPhase };
+    }
+    event(descriptor, payload, metadata) {
+        const thenPhase = new ThenPhaseImpl(this.app, this.recordings, this.eventStore, this.givenEvents, this.givenCommands, this.givenSetupFns, { kind: "event", descriptor, payload, metadata }, this.prerequisite);
+        return { then: () => thenPhase };
+    }
+    nothing() {
+        const thenPhase = new ThenPhaseImpl(this.app, this.recordings, this.eventStore, this.givenEvents, this.givenCommands, this.givenSetupFns, { kind: "nothing" }, this.prerequisite);
+        return { then: () => thenPhase };
+    }
+}
+class ThenPhaseImpl {
+    app;
+    recordings;
+    eventStore;
+    givenEvents;
+    givenCommands;
+    givenSetupFns;
+    whenAction;
+    prerequisite;
+    assertions = [];
+    executionPromise = null;
+    constructor(app, recordings, eventStore, givenEvents, givenCommands, givenSetupFns, whenAction, prerequisite) {
+        this.app = app;
+        this.recordings = recordings;
+        this.eventStore = eventStore;
+        this.givenEvents = givenEvents;
+        this.givenCommands = givenCommands;
+        this.givenSetupFns = givenSetupFns;
+        this.whenAction = whenAction;
+        this.prerequisite = prerequisite;
+    }
+    expectEvents(...pairs) {
+        this.assertions.push((_result, _error, events) => {
+            if (events.length !== pairs.length) {
+                throw new FixtureAssertionError(`Expected ${pairs.length} event(s) but got ${events.length}.\n` +
+                    `  Expected: [${pairs.map(([d]) => qualifiedNameToString(d.name)).join(", ")}]\n` +
+                    `  Actual:   [${events.map((e) => qualifiedNameToString(e.name)).join(", ")}]`);
+            }
+            for (let i = 0; i < pairs.length; i++) {
+                const [desc, payload] = pairs[i];
+                const actual = events[i];
+                const expectedName = qualifiedNameToString(desc.name);
+                const actualName = qualifiedNameToString(actual.name);
+                if (actualName !== expectedName) {
+                    throw new FixtureAssertionError(`Event ${i}: expected "${expectedName}" but got "${actualName}"`);
+                }
+                assertDeepEqual(payload, actual.payload, `Event ${i} (${expectedName}) payload`);
+            }
+        });
+        return this;
+    }
+    expectNoEvents() {
+        this.assertions.push((_result, _error, events) => {
+            if (events.length !== 0) {
+                throw new FixtureAssertionError(`Expected no events but got ${events.length}: ` + events.map((e) => qualifiedNameToString(e.name)).join(", "));
+            }
+        });
+        return this;
+    }
+    expectSuccess() {
+        this.assertions.push((_result, error) => {
+            if (error)
+                throw new FixtureAssertionError(`Expected success but command failed: ${error instanceof Error ? error.message : String(error)}`);
+        });
+        return this;
+    }
+    expectResult(expected) {
+        this.assertions.push((result, error) => {
+            if (error)
+                throw new FixtureAssertionError(`Expected result but command failed: ${error}`);
+            assertDeepEqual(expected, result, "Command result");
+        });
+        return this;
+    }
+    expectResultSatisfying(fn) {
+        this.assertions.push((result, error) => {
+            if (error)
+                throw new FixtureAssertionError(`Expected result but command failed: ${error}`);
+            fn(result);
+        });
+        return this;
+    }
+    expectResultPayloadSatisfying(fn) {
+        this.assertions.push((result, error) => {
+            if (error)
+                throw new FixtureAssertionError(`Expected result but command failed: ${error}`);
+            fn(result);
+        });
+        return this;
+    }
+    expectException(messageSubstring) {
+        this.assertions.push((_result, error) => {
+            if (!error)
+                throw new FixtureAssertionError(`Expected exception containing "${messageSubstring}" but command succeeded`);
+            const msg = error instanceof Error ? error.message : String(error);
+            if (!msg.includes(messageSubstring)) {
+                throw new FixtureAssertionError(`Expected exception containing "${messageSubstring}" but got: "${msg}"`);
+            }
+        });
+        return this;
+    }
+    expectExceptionType(errorName) {
+        this.assertions.push((_result, error) => {
+            if (!error)
+                throw new FixtureAssertionError(`Expected ${errorName} but command succeeded`);
+            const actualName = error instanceof Error ? error.name : "Error";
+            if (actualName !== errorName) {
+                throw new FixtureAssertionError(`Expected ${errorName} but got ${actualName}: ${error instanceof Error ? error.message : error}`);
+            }
+        });
+        return this;
+    }
+    expectExceptionSatisfying(fn) {
+        this.assertions.push((_result, error) => {
+            if (!error)
+                throw new FixtureAssertionError("Expected exception but command succeeded");
+            fn(error);
+        });
+        return this;
+    }
+    expectEventsSatisfying(fn) {
+        this.assertions.push((_result, _error, events) => { fn(events); });
+        return this;
+    }
+    expectCommands(...pairs) {
+        this.assertions.push(() => {
+            const actual = this.recordings.commands();
+            const handlerCommands = actual.slice(1);
+            if (handlerCommands.length !== pairs.length) {
+                throw new FixtureAssertionError(`Expected ${pairs.length} dispatched command(s) but got ${handlerCommands.length}.`);
+            }
+            for (let i = 0; i < pairs.length; i++) {
+                const [desc, payload] = pairs[i];
+                const actualCmd = handlerCommands[i];
+                const expectedName = qualifiedNameToString(desc.name);
+                const actualName = qualifiedNameToString(actualCmd.name);
+                if (actualName !== expectedName)
+                    throw new FixtureAssertionError(`Command ${i}: expected "${expectedName}" but got "${actualName}"`);
+                assertDeepEqual(payload, actualCmd.payload, `Command ${i} (${expectedName}) payload`);
+            }
+        });
+        return this;
+    }
+    expectNoCommands() {
+        this.assertions.push(() => {
+            const handlerCommands = this.recordings.commands().slice(1);
+            if (handlerCommands.length !== 0) {
+                throw new FixtureAssertionError(`Expected no dispatched commands but got ${handlerCommands.length}`);
+            }
+        });
+        return this;
+    }
+    expectCommandsSatisfying(fn) {
+        this.assertions.push(() => { fn(this.recordings.commands().slice(1)); });
+        return this;
+    }
+    expect(fn) {
+        this.assertions.push(async () => { await fn(this.app); });
+        return this;
+    }
+    await(assertion, timeoutMs = 5000, intervalMs = 50) {
+        this.assertions.push(async () => {
+            const start = Date.now();
+            let lastError;
+            while (Date.now() - start < timeoutMs) {
+                try {
+                    await assertion(this.app);
+                    return;
+                }
+                catch (err) {
+                    lastError = err;
+                    await new Promise((r) => setTimeout(r, intervalMs));
+                }
+            }
+            throw new FixtureAssertionError(`Assertion did not pass within ${timeoutMs}ms. Last error: ${lastError instanceof Error ? lastError.message : String(lastError)}`);
+        });
+        return this;
+    }
+    and() {
+        const prerequisite = this.getExecutionPromise();
+        return {
+            given: () => {
+                const given = new GivenPhaseImpl(this.app, this.recordings, this.eventStore);
+                given._prerequisite = prerequisite;
+                return given;
+            },
+            stop: async () => { await this.app.stop(); },
+        };
+    }
+    then(onfulfilled, onrejected) {
+        return this.getExecutionPromise().then(onfulfilled, onrejected);
+    }
+    getExecutionPromise() {
+        if (!this.executionPromise)
+            this.executionPromise = this.execute();
+        return this.executionPromise;
+    }
+    async execute() {
+        if (this.prerequisite)
+            await this.prerequisite;
+        const eventStore = this.eventStore;
+        // 1. Given: publish events within a UnitOfWork
+        if (this.givenEvents.length > 0) {
+            await runInNewUoW(emptyMetadata(), async () => {
+                const events = this.givenEvents.map(([desc, payload]) => {
+                    const tags = desc.tags ? desc.tags(payload) : [];
+                    return { identifier: generateIdentifier(), name: desc.name, version: desc.version, payload, metadata: emptyMetadata(), timestamp: Date.now(), tags };
+                });
+                await eventStore.append(events);
+            });
+        }
+        // 1b. Given: run custom setup
+        for (const fn of this.givenSetupFns) {
+            await fn(this.app);
+        }
+        // 1c. Given: dispatch commands via the gateway (matches user-facing semantics).
+        //     The recording decorator on the bus captures messages whether they
+        //     arrive via gateway or direct bus dispatch.
+        for (const [desc, payload] of this.givenCommands) {
+            await this.app.commandGateway.send(desc, payload, emptyMetadata());
+        }
+        // 2. Reset recordings
+        this.recordings.reset();
+        // 3. When
+        let result;
+        let error;
+        if (this.whenAction.kind === "command") {
+            try {
+                result = await this.app.commandGateway.send(this.whenAction.descriptor, this.whenAction.payload, this.whenAction.metadata ?? emptyMetadata());
+            }
+            catch (err) {
+                error = err;
+            }
+        }
+        else if (this.whenAction.kind === "event") {
+            const desc = this.whenAction.descriptor;
+            const payload = this.whenAction.payload;
+            const tags = desc.tags ? desc.tags(payload) : [];
+            try {
+                await eventStore.append([{ identifier: generateIdentifier(), name: desc.name, version: desc.version, payload, metadata: this.whenAction.metadata ?? emptyMetadata(), timestamp: Date.now(), tags }]);
+            }
+            catch (err) {
+                error = err;
+            }
+        }
+        // 4. Then
+        const recordedEvents = this.recordings.events();
+        for (const assertion of this.assertions) {
+            await assertion(result, error, recordedEvents);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+export class FixtureAssertionError extends Error {
+    constructor(message) { super(message); this.name = "FixtureAssertionError"; }
+}
+export const allFieldsFilter = () => true;
+export function ignoreFields(...fieldNames) {
+    const ignored = new Set(fieldNames);
+    return (name) => !ignored.has(name);
+}
+function assertDeepEqual(expected, actual, label, fieldFilter = allFieldsFilter) {
+    const differences = deepCompare(expected, actual, "", fieldFilter);
+    if (differences.length > 0)
+        throw new FixtureAssertionError(`${label} mismatch:\n${differences.map((d) => `  ${d}`).join("\n")}`);
+}
+function deepCompare(expected, actual, path, fieldFilter) {
+    if (expected === actual)
+        return [];
+    if (expected === null || actual === null)
+        return [`${path || "root"}: expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`];
+    if (typeof expected !== typeof actual)
+        return [`${path || "root"}: expected type ${typeof expected}, got type ${typeof actual}`];
+    if (typeof expected !== "object")
+        return [`${path || "root"}: expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`];
+    if (Array.isArray(expected) !== Array.isArray(actual))
+        return [`${path || "root"}: expected ${Array.isArray(expected) ? "array" : "object"}, got ${Array.isArray(actual) ? "array" : "object"}`];
+    if (Array.isArray(expected) && Array.isArray(actual)) {
+        const diffs = [];
+        for (let i = 0; i < Math.max(expected.length, actual.length); i++) {
+            if (i >= expected.length)
+                diffs.push(`${path}[${i}]: unexpected extra element`);
+            else if (i >= actual.length)
+                diffs.push(`${path}[${i}]: missing expected element`);
+            else
+                diffs.push(...deepCompare(expected[i], actual[i], `${path}[${i}]`, fieldFilter));
+        }
+        return diffs;
+    }
+    const diffs = [];
+    const allKeys = new Set([...Object.keys(expected), ...Object.keys(actual)]);
+    for (const key of allKeys) {
+        if (!fieldFilter(key, expected))
+            continue;
+        const fieldPath = path ? `${path}.${key}` : key;
+        if (!(key in expected))
+            diffs.push(`${fieldPath}: unexpected field`);
+        else if (!(key in actual))
+            diffs.push(`${fieldPath}: missing expected value`);
+        else
+            diffs.push(...deepCompare(expected[key], actual[key], fieldPath, fieldFilter));
+    }
+    return diffs;
+}
+//# sourceMappingURL=fixture.js.map

package/dist/fixture.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { type TestFixture, type GivenPhase, type WhenPhase, type WhenResult, type ThenPhase, type FieldFilter, allFieldsFilter, ignoreFields, createTestFixture, FixtureAssertionError, } from "./fixture.js";
+export { type Recordings, createRecordings, testRecordingExtension, } from "./recording-enhancer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,KAAK,UAAU,EACf,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { allFieldsFilter, ignoreFields, createTestFixture, FixtureAssertionError, } from "./fixture.js";
+export { createRecordings, testRecordingExtension, } from "./recording-enhancer.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,cAAc,CAAA;AAErB,OAAO,EAEL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAA"}

package/dist/recording-enhancer.d.ts

@@ -0,0 +1,40 @@
+import type { Extension } from "@kronos-ts/app";
+import type { CommandMessage, EventMessage } from "@kronos-ts/messaging";
+/**
+ * Recorded state from the test fixture.
+ * Events and commands are captured by decorators installed at the
+ * INNERMOST position (after all interceptors have run).
+ */
+export interface Recordings {
+    /** Events recorded since the last reset. */
+    events(): ReadonlyArray<EventMessage>;
+    /** Commands dispatched since the last reset. */
+    commands(): ReadonlyArray<CommandMessage>;
+    /** Clear all recordings. Called between Given and When phases. */
+    reset(): void;
+}
+/**
+ * Create a fresh Recordings handle. Pass it into {@link testRecordingExtension}
+ * so the fixture and the decorators share the same backing arrays.
+ *
+ * Replaces the legacy "register testRecordings as a component, retrieve via
+ * configuration.getComponent" pattern (removed in Phase 8).
+ */
+export declare function createRecordings(): Recordings;
+/**
+ * Native Extension that decorates the eventStore and commandBus with
+ * recording wrappers.
+ *
+ * **Decoration order** (Phase 6 D-62): user decorators registered AFTER this
+ * extension's `app.use(...)` wrap OUTSIDE the recording decorators. To land
+ * the recording decorators at the INNERMOST position (capturing messages
+ * AFTER all interceptors have enriched them), call
+ * `app.use(testRecordingExtension(recordings))` BEFORE applying any user
+ * decorators / `configureFn(app)`.
+ *
+ * The legacy enhancer used `Number.MIN_SAFE_INTEGER` numeric priority for the
+ * same effect; Phase 6 dropped numeric priorities — innermost = first
+ * registered.
+ */
+export declare function testRecordingExtension(recordings: Recordings): Extension;
+//# sourceMappingURL=recording-enhancer.d.ts.map

package/dist/recording-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-enhancer.d.ts","sourceRoot":"","sources":["../src/recording-enhancer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAO,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAc,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEpF;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,MAAM,IAAI,aAAa,CAAC,YAAY,CAAC,CAAA;IACrC,gDAAgD;IAChD,QAAQ,IAAI,aAAa,CAAC,cAAc,CAAC,CAAA;IACzC,kEAAkE;IAClE,KAAK,IAAI,IAAI,CAAA;CACd;AAcD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAwB7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAmCxE"}