@ddd-ts-kit/testing 0.0.0-stage → 0.1.1

package/dist/e2e/start-test-server.d.ts

@@ -0,0 +1,18 @@
+import type { HttpClient } from './http-client.js';
+import type { HttpHeaders } from './http-headers.js';
+import type { RunningServer } from './running-server.js';
+export interface TestServerOptions {
+    /** Starts the whole application, real adapters included, on a free port. */
+    start(): Promise<RunningServer>;
+    /** Sent with every request of `client`, typically `authorization`. */
+    readonly headers?: HttpHeaders;
+}
+export interface TestServer extends RunningServer {
+    readonly client: HttpClient;
+}
+/**
+ * Starts the application the way `start` says (any HTTP framework, any composition root) and
+ * gives a JSON client bound to it. Close it in `afterAll`.
+ */
+export declare function startTestServer(options: TestServerOptions): Promise<TestServer>;
+//# sourceMappingURL=start-test-server.d.ts.map

package/dist/e2e/start-test-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-test-server.d.ts","sourceRoot":"","sources":["../../src/e2e/start-test-server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;CAChC;AAED,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAQrF"}

package/dist/e2e/start-test-server.js

@@ -0,0 +1,14 @@
+import { createHttpClient } from './create-http-client.js';
+/**
+ * Starts the application the way `start` says (any HTTP framework, any composition root) and
+ * gives a JSON client bound to it. Close it in `afterAll`.
+ */
+export async function startTestServer(options) {
+    const server = await options.start();
+    return {
+        url: server.url,
+        close: () => server.close(),
+        client: createHttpClient(server.url, { headers: options.headers ?? {} }),
+    };
+}
+//# sourceMappingURL=start-test-server.js.map

package/dist/e2e/start-test-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-test-server.js","sourceRoot":"","sources":["../../src/e2e/start-test-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgB3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA0B;IAC9D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAErC,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QAC3B,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC"}

package/dist/e2e/subscribed-recorder.d.ts

@@ -0,0 +1,17 @@
+import type { IntegrationEvent, IntegrationEventSubscriber } from '@ddd-ts-kit/kernel';
+import type { EventRecorder } from './event-recorder.js';
+import type { EventType } from './event-type.js';
+import { type EventuallyOptions } from './eventually.js';
+/** Records what a subscriber delivers for the types it was given, from its creation until `stop`. */
+export declare class SubscribedRecorder implements EventRecorder {
+    private readonly events;
+    private readonly types;
+    private readonly subscriptions;
+    constructor(subscriber: IntegrationEventSubscriber, types: readonly EventType[]);
+    received<Payload = unknown>(type?: EventType): IntegrationEvent<Payload>[];
+    waitFor<Payload = unknown>(type: EventType, predicate?: (event: IntegrationEvent<Payload>) => boolean, options?: EventuallyOptions): Promise<IntegrationEvent<Payload>>;
+    stop(): void;
+    private assertCollected;
+    private firstMatch;
+}
+//# sourceMappingURL=subscribed-recorder.d.ts.map

package/dist/e2e/subscribed-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribed-recorder.d.ts","sourceRoot":"","sources":["../../src/e2e/subscribed-recorder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,0BAA0B,EAAgB,MAAM,oBAAoB,CAAC;AACrG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAErE,qGAAqG;AACrG,qBAAa,kBAAmB,YAAW,aAAa;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IAEjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAE1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAE/C,YAAY,UAAU,EAAE,0BAA0B,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,EAM9E;IAED,QAAQ,CAAC,OAAO,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAKzE;IAED,OAAO,CAAC,OAAO,GAAG,OAAO,EACvB,IAAI,EAAE,SAAS,EACf,SAAS,GAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,OAAoB,EACrE,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAIpC;IAED,IAAI,IAAI,IAAI,CAIX;IAED,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,UAAU;CAenB"}

package/dist/e2e/subscribed-recorder.js

@@ -0,0 +1,45 @@
+import { AssertionError } from 'node:assert';
+import { eventually } from './eventually.js';
+/** Records what a subscriber delivers for the types it was given, from its creation until `stop`. */
+export class SubscribedRecorder {
+    events = [];
+    types;
+    subscriptions;
+    constructor(subscriber, types) {
+        this.types = types.map(nameOf);
+        this.subscriptions = this.types.map((type) => subscriber.subscribe(type, async (event) => void this.events.push(event)));
+    }
+    received(type) {
+        const events = this.events.filter((event) => type === undefined || event.type === nameOf(type));
+        // eslint-disable-next-line ddd-ts-kit/clean-no-escape-hatch -- the payload type is the caller's claim about what the application published; nothing here can check it
+        return events;
+    }
+    waitFor(type, predicate = () => true, options) {
+        this.assertCollected(nameOf(type));
+        return eventually(() => this.firstMatch(nameOf(type), predicate), options);
+    }
+    stop() {
+        for (const subscription of this.subscriptions.splice(0)) {
+            subscription.unsubscribe();
+        }
+    }
+    assertCollected(type) {
+        if (!this.types.includes(type)) {
+            throw new TypeError(`"${type}" is not collected: add it to the types given to collectEvents`);
+        }
+    }
+    firstMatch(type, predicate) {
+        const candidates = this.received(type);
+        const match = candidates.find(predicate);
+        if (match === undefined) {
+            throw new AssertionError({
+                message: `No "${type}" event matched; ${candidates.length} of that type received`,
+            });
+        }
+        return match;
+    }
+}
+function nameOf(type) {
+    return typeof type === 'string' ? type : type.type;
+}
+//# sourceMappingURL=subscribed-recorder.js.map

package/dist/e2e/subscribed-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribed-recorder.js","sourceRoot":"","sources":["../../src/e2e/subscribed-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AAErE,qGAAqG;AACrG,MAAM,OAAO,kBAAkB;IACZ,MAAM,GAAuB,EAAE,CAAC;IAEhC,KAAK,CAAoB;IAEzB,aAAa,CAAiB;IAE/C,YAAY,UAAsC,EAAE,KAA2B;QAC7E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE/B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3C,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAC1E,CAAC;IACJ,CAAC;IAED,QAAQ,CAAoB,IAAgB;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAEhG,sKAAsK;QACtK,OAAO,MAAqC,CAAC;IAC/C,CAAC;IAED,OAAO,CACL,IAAe,EACf,SAAS,GAAkD,GAAG,EAAE,CAAC,IAAI,EACrE,OAA2B;QAE3B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAEnC,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI;QACF,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,YAAY,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,IAAY;QAClC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,SAAS,CAAC,IAAI,IAAI,gEAAgE,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IAEO,UAAU,CAChB,IAAY,EACZ,SAAwD;QAExD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAU,IAAI,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,cAAc,CAAC;gBACvB,OAAO,EAAE,OAAO,IAAI,oBAAoB,UAAU,CAAC,MAAM,wBAAwB;aAClF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,SAAS,MAAM,CAAC,IAAe;IAC7B,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;AACrD,CAAC"}

package/dist/e2e/without-trailing-slashes.d.ts

@@ -0,0 +1,3 @@
+/** `value` without the slashes it ends with. */
+export declare function withoutTrailingSlashes(value: string): string;
+//# sourceMappingURL=without-trailing-slashes.d.ts.map

package/dist/e2e/without-trailing-slashes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"without-trailing-slashes.d.ts","sourceRoot":"","sources":["../../src/e2e/without-trailing-slashes.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ5D"}

package/dist/e2e/without-trailing-slashes.js

@@ -0,0 +1,9 @@
+/** `value` without the slashes it ends with. */
+export function withoutTrailingSlashes(value) {
+    let end = value.length;
+    while (end > 0 && value[end - 1] === '/') {
+        end -= 1;
+    }
+    return value.slice(0, end);
+}
+//# sourceMappingURL=without-trailing-slashes.js.map

package/dist/e2e/without-trailing-slashes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"without-trailing-slashes.js","sourceRoot":"","sources":["../../src/e2e/without-trailing-slashes.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IAEvB,OAAO,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QACzC,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/e2e.d.ts

@@ -0,0 +1,16 @@
+export { collectEvents } from './e2e/collect-events.js';
+export { createHttpClient } from './e2e/create-http-client.js';
+export type { DatabaseReset } from './e2e/database-reset.js';
+export type { EventRecorder } from './e2e/event-recorder.js';
+export type { EventType } from './e2e/event-type.js';
+export { eventually, type EventuallyOptions } from './e2e/eventually.js';
+export { expectProblem, type ExpectedProblem, type ProblemDetails } from './e2e/expect-problem.js';
+export { expectStatus } from './e2e/expect-status.js';
+export type { HttpClient } from './e2e/http-client.js';
+export type { HttpHeaders } from './e2e/http-headers.js';
+export type { HttpResponse } from './e2e/http-response.js';
+export { listenOnRandomPort, type NodeServer } from './e2e/listen-on-random-port.js';
+export type { RequestOptions } from './e2e/request-options.js';
+export type { RunningServer } from './e2e/running-server.js';
+export { startTestServer, type TestServer, type TestServerOptions } from './e2e/start-test-server.js';
+//# sourceMappingURL=e2e.d.ts.map

package/dist/e2e.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e.d.ts","sourceRoot":"","sources":["../src/e2e.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/e2e.js

@@ -0,0 +1,8 @@
+export { collectEvents } from './e2e/collect-events.js';
+export { createHttpClient } from './e2e/create-http-client.js';
+export { eventually } from './e2e/eventually.js';
+export { expectProblem } from './e2e/expect-problem.js';
+export { expectStatus } from './e2e/expect-status.js';
+export { listenOnRandomPort } from './e2e/listen-on-random-port.js';
+export { startTestServer } from './e2e/start-test-server.js';
+//# sourceMappingURL=e2e.js.map

package/dist/e2e.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"e2e.js","sourceRoot":"","sources":["../src/e2e.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAI/D,OAAO,EAAE,UAAU,EAA0B,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,aAAa,EAA6C,MAAM,yBAAyB,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAItD,OAAO,EAAE,kBAAkB,EAAmB,MAAM,gCAAgC,CAAC;AAGrF,OAAO,EAAE,eAAe,EAA2C,MAAM,4BAA4B,CAAC"}

package/dist/execution/a-session.d.ts

@@ -0,0 +1,4 @@
+import { SessionBuilder } from './session-builder.js';
+/** `aSession().of(ada).impersonatedBy('support-7').expiringAt(tonight).build()` */
+export declare function aSession(): SessionBuilder;
+//# sourceMappingURL=a-session.d.ts.map

package/dist/execution/a-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a-session.d.ts","sourceRoot":"","sources":["../../src/execution/a-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,mFAAmF;AACnF,wBAAgB,QAAQ,IAAI,cAAc,CAEzC"}

package/dist/execution/a-session.js

@@ -0,0 +1,7 @@
+import { SessionBuilder } from './session-builder.js';
+const sessionBuilder = new SessionBuilder();
+/** `aSession().of(ada).impersonatedBy('support-7').expiringAt(tonight).build()` */
+export function aSession() {
+    return sessionBuilder;
+}
+//# sourceMappingURL=a-session.js.map

package/dist/execution/a-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a-session.js","sourceRoot":"","sources":["../../src/execution/a-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;AAE5C,mFAAmF;AACnF,MAAM,UAAU,QAAQ;IACtB,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/execution/a-test-user.d.ts

@@ -0,0 +1,4 @@
+import type { Actor } from '@ddd-ts-kit/kernel';
+/** A user of its own at each build, without tenant, role or attribute: `user-1`, `user-2`... */
+export declare const aTestUser: import("../index.js").Resolvable<Actor>;
+//# sourceMappingURL=a-test-user.d.ts.map

package/dist/execution/a-test-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a-test-user.d.ts","sourceRoot":"","sources":["../../src/execution/a-test-user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD,gGAAgG;AAChG,eAAO,MAAM,SAAS,yCAQrB,CAAC"}

package/dist/execution/a-test-user.js

@@ -0,0 +1,9 @@
+import { sequence } from '../builders/sequence.js';
+/** A user of its own at each build, without tenant, role or attribute: `user-1`, `user-2`... */
+export const aTestUser = sequence('user', (n) => ({
+    id: `user-${String(n)}`,
+    type: 'user',
+    roles: [],
+    attributes: {},
+}));
+//# sourceMappingURL=a-test-user.js.map

package/dist/execution/a-test-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a-test-user.js","sourceRoot":"","sources":["../../src/execution/a-test-user.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,gGAAgG;AAChG,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAC/B,MAAM,EACN,CAAC,CAAC,EAAS,EAAE,CAAC,CAAC;IACb,EAAE,EAAE,QAAQ,MAAM,CAAC,CAAC,CAAC,EAAE;IACvB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,EAAE;IACT,UAAU,EAAE,EAAE;CACf,CAAC,CACH,CAAC"}

package/dist/execution/an-execution-context.d.ts

@@ -0,0 +1,4 @@
+import { ExecutionContextBuilder } from './execution-context-builder.js';
+/** `anExecutionContext().as(ada).ofTenant('acme').from('http').build()` */
+export declare function anExecutionContext(): ExecutionContextBuilder;
+//# sourceMappingURL=an-execution-context.d.ts.map

package/dist/execution/an-execution-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"an-execution-context.d.ts","sourceRoot":"","sources":["../../src/execution/an-execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAIzE,2EAA2E;AAC3E,wBAAgB,kBAAkB,IAAI,uBAAuB,CAE5D"}

package/dist/execution/an-execution-context.js

@@ -0,0 +1,7 @@
+import { ExecutionContextBuilder } from './execution-context-builder.js';
+const executionContextBuilder = new ExecutionContextBuilder();
+/** `anExecutionContext().as(ada).ofTenant('acme').from('http').build()` */
+export function anExecutionContext() {
+    return executionContextBuilder;
+}
+//# sourceMappingURL=an-execution-context.js.map

package/dist/execution/an-execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"an-execution-context.js","sourceRoot":"","sources":["../../src/execution/an-execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,MAAM,uBAAuB,GAAG,IAAI,uBAAuB,EAAE,CAAC;AAE9D,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB;IAChC,OAAO,uBAAuB,CAAC;AACjC,CAAC"}

package/dist/execution/execution-context-builder.d.ts

@@ -0,0 +1,37 @@
+import { type Actor, type ExecutionContext, type ExecutionContextExtensionValues, type ExecutionOrigin, type Session } from '@ddd-ts-kit/kernel';
+import type { Buildable } from '../builders/buildable.js';
+import { Builder } from '../builders/builder.js';
+import type { Defaults } from '../builders/defaults.js';
+interface ExecutionContextProps {
+    correlationId: string;
+    causationId: string | undefined;
+    actor: Actor | undefined;
+    session: Session | undefined;
+    tenantId: string | undefined;
+    locale: string | undefined;
+    deadline: Date | undefined;
+    origin: ExecutionOrigin;
+    extensions: ExecutionContextExtensionValues;
+}
+/**
+ * By default the work of a user of its own, of origin `test`, with a correlation id of its
+ * own: `correlation-1`, `correlation-2`... Built with `executionContext`, so the tenant is
+ * that of the actor unless said otherwise.
+ */
+export declare class ExecutionContextBuilder extends Builder<ExecutionContextProps, ExecutionContext> {
+    correlatedBy(correlationId: string): this;
+    causedBy(causationId: string): this;
+    /** The actor of the work. The session, if one was set, goes: it was another actor's. */
+    as(actor: Buildable<Actor>): this;
+    /** The session of the work, and its actor as the actor of the work. */
+    inSession(session: Buildable<Session>): this;
+    ofTenant(tenantId: string): this;
+    from(origin: ExecutionOrigin): this;
+    dueBy(deadline: Date): this;
+    inLocale(locale: string): this;
+    withExtensions(extensions: ExecutionContextExtensionValues): this;
+    protected defaults(): Defaults<ExecutionContextProps>;
+    protected construct(props: ExecutionContextProps): ExecutionContext;
+}
+export {};
+//# sourceMappingURL=execution-context-builder.d.ts.map

package/dist/execution/execution-context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-builder.d.ts","sourceRoot":"","sources":["../../src/execution/execution-context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,gBAAgB,EACrB,KAAK,+BAA+B,EACpC,KAAK,eAAe,EACpB,KAAK,OAAO,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAKxD,UAAU,qBAAqB;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,IAAI,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,+BAA+B,CAAC;CAC7C;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,OAAO,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;IAC3F,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAExC;IAED,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAElC;IAED,wFAAwF;IACxF,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAEhC;IAED,uEAAuE;IACvE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAE3C;IAED,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE/B;IAED,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAElC;IAED,KAAK,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAE1B;IAED,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE7B;IAED,cAAc,CAAC,UAAU,EAAE,+BAA+B,GAAG,IAAI,CAEhE;IAED,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,qBAAqB,CAAC,CAYpD;IAED,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB,CAYlE;CACF"}

package/dist/execution/execution-context-builder.js

@@ -0,0 +1,67 @@
+import { executionContext, } from '@ddd-ts-kit/kernel';
+import { Builder } from '../builders/builder.js';
+import { resolve } from '../builders/resolve.js';
+import { sequence } from '../builders/sequence.js';
+import { aTestUser } from './a-test-user.js';
+/**
+ * By default the work of a user of its own, of origin `test`, with a correlation id of its
+ * own: `correlation-1`, `correlation-2`... Built with `executionContext`, so the tenant is
+ * that of the actor unless said otherwise.
+ */
+export class ExecutionContextBuilder extends Builder {
+    correlatedBy(correlationId) {
+        return this.with('correlationId', correlationId);
+    }
+    causedBy(causationId) {
+        return this.with('causationId', causationId);
+    }
+    /** The actor of the work. The session, if one was set, goes: it was another actor's. */
+    as(actor) {
+        return this.withMany({ actor, session: undefined });
+    }
+    /** The session of the work, and its actor as the actor of the work. */
+    inSession(session) {
+        return this.withMany({ session, actor: undefined });
+    }
+    ofTenant(tenantId) {
+        return this.with('tenantId', tenantId);
+    }
+    from(origin) {
+        return this.with('origin', origin);
+    }
+    dueBy(deadline) {
+        return this.with('deadline', deadline);
+    }
+    inLocale(locale) {
+        return this.with('locale', locale);
+    }
+    withExtensions(extensions) {
+        return this.with('extensions', extensions);
+    }
+    defaults() {
+        return {
+            correlationId: sequence('correlation'),
+            causationId: undefined,
+            actor: undefined,
+            session: undefined,
+            tenantId: undefined,
+            locale: undefined,
+            deadline: undefined,
+            origin: 'test',
+            extensions: {},
+        };
+    }
+    construct(props) {
+        const { causationId, actor, session, tenantId, locale, deadline, ...required } = props;
+        return executionContext({
+            ...required,
+            actor: actor ?? session?.actor ?? resolve(aTestUser),
+            ...(causationId === undefined ? {} : { causationId }),
+            ...(session === undefined ? {} : { session }),
+            ...(tenantId === undefined ? {} : { tenantId }),
+            ...(locale === undefined ? {} : { locale }),
+            ...(deadline === undefined ? {} : { deadline }),
+        });
+    }
+}
+//# sourceMappingURL=execution-context-builder.js.map

package/dist/execution/execution-context-builder.js.map

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

package/dist/execution/scoped.d.ts

@@ -0,0 +1,8 @@
+import type { ExecutionContext, ExecutionScope } from '@ddd-ts-kit/kernel';
+import type { Resolvable } from '../builders/resolvable.js';
+/**
+ * Runs a block inside an execution context, given as a value or as a builder:
+ * `await scoped(scope, anExecutionContext().as(ada), () => repository.save(order))`.
+ */
+export declare function scoped<T>(scope: ExecutionScope, context: ExecutionContext | Resolvable<ExecutionContext>, work: () => T): T;
+//# sourceMappingURL=scoped.d.ts.map

package/dist/execution/scoped.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped.d.ts","sourceRoot":"","sources":["../../src/execution/scoped.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,gBAAgB,GAAG,UAAU,CAAC,gBAAgB,CAAC,EACxD,IAAI,EAAE,MAAM,CAAC,GACZ,CAAC,CAEH"}

package/dist/execution/scoped.js

@@ -0,0 +1,9 @@
+import { resolve } from '../builders/resolve.js';
+/**
+ * Runs a block inside an execution context, given as a value or as a builder:
+ * `await scoped(scope, anExecutionContext().as(ada), () => repository.save(order))`.
+ */
+export function scoped(scope, context, work) {
+    return scope.run(resolve(context), work);
+}
+//# sourceMappingURL=scoped.js.map

package/dist/execution/scoped.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped.js","sourceRoot":"","sources":["../../src/execution/scoped.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,MAAM,CACpB,KAAqB,EACrB,OAAwD,EACxD,IAAa;IAEb,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/execution/session-builder.d.ts

@@ -0,0 +1,37 @@
+import type { Actor, AuthenticationMethod, AuthenticationStrength, Session, SessionExtensionValues } from '@ddd-ts-kit/kernel';
+import type { Buildable } from '../builders/buildable.js';
+import { Builder } from '../builders/builder.js';
+import type { Defaults } from '../builders/defaults.js';
+interface SessionProps {
+    id: string;
+    actor: Actor;
+    issuedAt: Date;
+    expiresAt: Date | undefined;
+    authenticationMethod: AuthenticationMethod;
+    authenticationStrength: AuthenticationStrength | undefined;
+    impersonatedBy: string | undefined;
+    locale: string | undefined;
+    timeZone: string | undefined;
+    extensions: SessionExtensionValues;
+}
+/**
+ * By default the session of a user of its own (`user-1`, `user-2`...), opened with a password
+ * at the test epoch, never expiring, with an id of its own: `session-1`, `session-2`...
+ */
+export declare class SessionBuilder extends Builder<SessionProps, Session> {
+    of(actor: Buildable<Actor>): this;
+    identifiedBy(id: string): this;
+    issuedAt(instant: Date): this;
+    expiringAt(instant: Date): this;
+    authenticatedBy(method: AuthenticationMethod): this;
+    withSecondFactor(assuranceLevel?: string): this;
+    /** Support staff acting as the actor of the session. */
+    impersonatedBy(impersonatorId: string): this;
+    inLocale(locale: string): this;
+    inTimeZone(timeZone: string): this;
+    withExtensions(extensions: SessionExtensionValues): this;
+    protected defaults(): Defaults<SessionProps>;
+    protected construct(props: SessionProps): Session;
+}
+export {};
+//# sourceMappingURL=session-builder.d.ts.map

package/dist/execution/session-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-builder.d.ts","sourceRoot":"","sources":["../../src/execution/session-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,oBAAoB,EACpB,sBAAsB,EACtB,OAAO,EACP,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAOxD,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,IAAI,GAAG,SAAS,CAAC;IAC5B,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,sBAAsB,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC3D,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,sBAAsB,CAAC;CACpC;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC;IAChE,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAEhC;IAED,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE7B;IAED,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAE5B;IAED,UAAU,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAE9B;IAED,eAAe,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAElD;IAED,gBAAgB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAK9C;IAED,wDAAwD;IACxD,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAE3C;IAED,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE7B;IAED,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEjC;IAED,cAAc,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAEvD;IAED,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,YAAY,CAAC,CAa3C;IAED,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAWhD;CACF"}

package/dist/execution/session-builder.js

@@ -0,0 +1,71 @@
+import { Builder } from '../builders/builder.js';
+import { sequence } from '../builders/sequence.js';
+import { aTestUser } from './a-test-user.js';
+/** The instant sessions are dated from by default, the one `createTestBuses` freezes its clock at. */
+const TEST_EPOCH = new Date('2026-01-01T00:00:00.000Z');
+/**
+ * By default the session of a user of its own (`user-1`, `user-2`...), opened with a password
+ * at the test epoch, never expiring, with an id of its own: `session-1`, `session-2`...
+ */
+export class SessionBuilder extends Builder {
+    of(actor) {
+        return this.with('actor', actor);
+    }
+    identifiedBy(id) {
+        return this.with('id', id);
+    }
+    issuedAt(instant) {
+        return this.with('issuedAt', instant);
+    }
+    expiringAt(instant) {
+        return this.with('expiresAt', instant);
+    }
+    authenticatedBy(method) {
+        return this.with('authenticationMethod', method);
+    }
+    withSecondFactor(assuranceLevel) {
+        return this.with('authenticationStrength', {
+            mfa: true,
+            ...(assuranceLevel === undefined ? {} : { assuranceLevel }),
+        });
+    }
+    /** Support staff acting as the actor of the session. */
+    impersonatedBy(impersonatorId) {
+        return this.with('impersonatedBy', impersonatorId);
+    }
+    inLocale(locale) {
+        return this.with('locale', locale);
+    }
+    inTimeZone(timeZone) {
+        return this.with('timeZone', timeZone);
+    }
+    withExtensions(extensions) {
+        return this.with('extensions', extensions);
+    }
+    defaults() {
+        return {
+            id: sequence('session'),
+            actor: aTestUser,
+            issuedAt: TEST_EPOCH,
+            expiresAt: undefined,
+            authenticationMethod: 'password',
+            authenticationStrength: undefined,
+            impersonatedBy: undefined,
+            locale: undefined,
+            timeZone: undefined,
+            extensions: {},
+        };
+    }
+    construct(props) {
+        const { expiresAt, authenticationStrength, impersonatedBy, locale, timeZone, ...required } = props;
+        return {
+            ...required,
+            ...(expiresAt === undefined ? {} : { expiresAt }),
+            ...(authenticationStrength === undefined ? {} : { authenticationStrength }),
+            ...(impersonatedBy === undefined ? {} : { impersonatedBy }),
+            ...(locale === undefined ? {} : { locale }),
+            ...(timeZone === undefined ? {} : { timeZone }),
+        };
+    }
+}
+//# sourceMappingURL=session-builder.js.map

package/dist/execution/session-builder.js.map

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

package/dist/faker/create-data-generator.d.ts

@@ -0,0 +1,15 @@
+import { type LocaleDefinition } from '@faker-js/faker';
+import type { DataGenerator } from './data-generator.js';
+export interface DataGeneratorOptions {
+    /** Default: the `TEST_SEED` environment variable, else a random seed. */
+    readonly seed?: number;
+    /** Locales by decreasing priority. Default: English. */
+    readonly locales?: readonly LocaleDefinition[];
+    /**
+     * The instant relative dates (`faker.date.recent()`) are computed from. Fixed by default,
+     * at 2026-01-01T00:00:00.000Z, so that a seed replays the dates too.
+     */
+    readonly referenceDate?: Date;
+}
+export declare function createDataGenerator(options?: DataGeneratorOptions): DataGenerator;
+//# sourceMappingURL=create-data-generator.d.ts.map

package/dist/faker/create-data-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-data-generator.d.ts","sourceRoot":"","sources":["../../src/faker/create-data-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;CAC/B;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAQrF"}

package/dist/faker/create-data-generator.js

@@ -0,0 +1,24 @@
+import { Faker, base, en } from '@faker-js/faker';
+export function createDataGenerator(options = {}) {
+    const seed = options.seed ?? seedFromEnvironment() ?? randomSeed();
+    const faker = new Faker({ locale: [...(options.locales ?? [en, base])] });
+    faker.setDefaultRefDate(options.referenceDate ?? DEFAULT_REFERENCE_DATE);
+    faker.seed(seed);
+    return { seed, faker, restart: () => void faker.seed(seed) };
+}
+const DEFAULT_REFERENCE_DATE = new Date('2026-01-01T00:00:00.000Z');
+function seedFromEnvironment() {
+    const raw = process.env.TEST_SEED;
+    if (raw === undefined || raw === '') {
+        return undefined;
+    }
+    const seed = Number(raw);
+    if (!Number.isSafeInteger(seed)) {
+        throw new TypeError(`TEST_SEED must be an integer, got "${raw}"`);
+    }
+    return seed;
+}
+function randomSeed() {
+    return Math.floor(Math.random() * 2 ** 31);
+}
+//# sourceMappingURL=create-data-generator.js.map

package/dist/faker/create-data-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-data-generator.js","sourceRoot":"","sources":["../../src/faker/create-data-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAyB,MAAM,iBAAiB,CAAC;AAezE,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAAyB,EAAE;IACpE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,mBAAmB,EAAE,IAAI,UAAU,EAAE,CAAC;IACnE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE1E,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC,CAAC;IACzE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,sBAAsB,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAEpE,SAAS,mBAAmB;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAElC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAEzB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,SAAS,CAAC,sCAAsC,GAAG,GAAG,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist/faker/current-data-generator.d.ts

@@ -0,0 +1,9 @@
+import type { DataGenerator } from './data-generator.js';
+/**
+ * The generator every `generated` value is drawn from, so that one seed replays a whole test
+ * file. Created on first use, from `TEST_SEED` or a random seed.
+ */
+export declare function dataGenerator(): DataGenerator;
+/** Makes `generated` draw from this generator from now on. */
+export declare function useDataGenerator(generator: DataGenerator): DataGenerator;
+//# sourceMappingURL=current-data-generator.d.ts.map

package/dist/faker/current-data-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-data-generator.d.ts","sourceRoot":"","sources":["../../src/faker/current-data-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAI7C;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,GAAG,aAAa,CAIxE"}

package/dist/faker/current-data-generator.js

@@ -0,0 +1,16 @@
+import { createDataGenerator } from './create-data-generator.js';
+let current;
+/**
+ * The generator every `generated` value is drawn from, so that one seed replays a whole test
+ * file. Created on first use, from `TEST_SEED` or a random seed.
+ */
+export function dataGenerator() {
+    current ??= createDataGenerator();
+    return current;
+}
+/** Makes `generated` draw from this generator from now on. */
+export function useDataGenerator(generator) {
+    current = generator;
+    return generator;
+}
+//# sourceMappingURL=current-data-generator.js.map

package/dist/faker/current-data-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-data-generator.js","sourceRoot":"","sources":["../../src/faker/current-data-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,IAAI,OAAkC,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,mBAAmB,EAAE,CAAC;IAElC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,SAAwB;IACvD,OAAO,GAAG,SAAS,CAAC;IAEpB,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/faker/data-generator.d.ts

@@ -0,0 +1,9 @@
+import type { Faker } from '@faker-js/faker';
+export interface DataGenerator {
+    /** Always known, also when it was drawn at random: print it when a test fails. */
+    readonly seed: number;
+    readonly faker: Faker;
+    /** Starts the sequence again from the seed. */
+    restart(): void;
+}
+//# sourceMappingURL=data-generator.d.ts.map

package/dist/faker/data-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-generator.d.ts","sourceRoot":"","sources":["../../src/faker/data-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,+CAA+C;IAC/C,OAAO,IAAI,IAAI,CAAC;CACjB"}