@innovatorstack/harness 0.0.0-stage → 0.1.1

package/dist/controls/clock.js

@@ -0,0 +1,74 @@
+/** An immutable starting instant; each world owns its own clock. */
+export function fixedClock(value) {
+    return Object.freeze({ at: new Date(instant(value)).toISOString() });
+}
+export function clockSettings(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null ||
+        typeof value !== "object" ||
+        !("at" in value) ||
+        typeof value.at !== "string" ||
+        Object.keys(value).some((key) => key !== "at")) {
+        throw new TypeError("Harness clock must be configured with fixedClock().");
+    }
+    return fixedClock(value.at);
+}
+export class WorldClock {
+    current;
+    baseline;
+    constructor(settings) {
+        this.current = settings === undefined ? undefined : instant(settings.at);
+        this.baseline = this.current;
+    }
+    now() {
+        return new Date(this.current ?? Date.now());
+    }
+    control(assertOpen, assertIdle) {
+        return Object.freeze({
+            now: () => {
+                assertOpen();
+                return this.now();
+            },
+            set: (value) => {
+                assertIdle();
+                this.current = instant(value);
+            },
+            advance: (milliseconds) => {
+                assertIdle();
+                if (!Number.isSafeInteger(milliseconds) || milliseconds < 0) {
+                    throw new TypeError("Clock advancement requires nonnegative integer milliseconds.");
+                }
+                this.current = instant(new Date(this.now().getTime() + milliseconds));
+            },
+        });
+    }
+    checkpoint() {
+        this.baseline = this.current;
+    }
+    capture() {
+        return this.current;
+    }
+    restore(value) {
+        this.current = value;
+        this.checkpoint();
+    }
+    reset() {
+        this.current = this.baseline;
+    }
+}
+function instant(value) {
+    if (typeof value !== "string" && !(value instanceof Date)) {
+        throw new TypeError("Clock instants must be strings or Dates.");
+    }
+    if (typeof value === "string" && !/(?:Z|[+-]\d{2}:\d{2})$/u.test(value)) {
+        throw new TypeError("Clock instants must include an explicit timezone.");
+    }
+    const milliseconds = value instanceof Date ? value.getTime() : Date.parse(value);
+    if (!Number.isFinite(milliseconds)) {
+        throw new TypeError("The clock requires a valid date.");
+    }
+    return milliseconds;
+}
+//# sourceMappingURL=clock.js.map

package/dist/controls/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/controls/clock.ts"],"names":[],"mappings":"AAUA,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,KAAoB;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IACI,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC;QAChB,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,EAChD,CAAC;QACC,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,OAAO,UAAU;IACX,OAAO,CAAqB;IAC5B,QAAQ,CAAqB;IAErC,YAAY,QAAwB;QAChC,IAAI,CAAC,OAAO,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,GAAG;QACC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,CAAC,UAAsB,EAAE,UAAsB;QAClD,OAAO,MAAM,CAAC,MAAM,CAAC;YACjB,GAAG,EAAE,GAAG,EAAE;gBACN,UAAU,EAAE,CAAC;gBAEb,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,CAAC;YAED,GAAG,EAAE,CAAC,KAAoB,EAAE,EAAE;gBAC1B,UAAU,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAClC,CAAC;YAED,OAAO,EAAE,CAAC,YAAoB,EAAE,EAAE;gBAC9B,UAAU,EAAE,CAAC;gBAEb,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;oBAC1D,MAAM,IAAI,SAAS,CACf,8DAA8D,CACjE,CAAC;gBACN,CAAC;gBAED,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;YAC1E,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IAED,UAAU;QACN,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,KAAyB;QAC7B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAED,KAAK;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;IACjC,CAAC;CACJ;AAED,SAAS,OAAO,CAAC,KAAoB;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEjF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,YAAY,CAAC;AACxB,CAAC"}

package/dist/controls/execution.d.ts

@@ -0,0 +1,8 @@
+import type { RuntimeObserver } from "../core/types.js";
+import type { ExecutionRecorder } from "../instrumentation/recorder.js";
+import type { HarnessStorage } from "../storage/types.js";
+import type { FailureRegistry } from "./failures.js";
+import type { ExecutionObservers } from "./observers.js";
+/** Internal boundary hooks preserve the single request transaction for direct and nested calls. */
+export declare function executionObserver(storage: HarnessStorage, recorder: ExecutionRecorder, failures: FailureRegistry, observers: ExecutionObservers): RuntimeObserver;
+//# sourceMappingURL=execution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/controls/execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGzD,mGAAmG;AACnG,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,kBAAkB,GAC9B,eAAe,CAuCjB"}

package/dist/controls/execution.js

@@ -0,0 +1,36 @@
+import { injectionTarget } from "./targets.js";
+/** Internal boundary hooks preserve the single request transaction for direct and nested calls. */
+export function executionObserver(storage, recorder, failures, observers) {
+    return {
+        started(execution, input) {
+            recorder.started(execution, input);
+            if (failures.hasRules) {
+                const target = injectionTarget(storage, execution.operation, input);
+                if (target) {
+                    failures.enter(execution, target);
+                }
+            }
+        },
+        completed(execution, result) {
+            recorder.completed(execution, result);
+            failures.complete(execution);
+        },
+        failed(execution, error) {
+            failures.failed(execution);
+            recorder.failed(execution, error);
+        },
+        settled(requestId, outcome, error) {
+            failures.settled(requestId);
+            recorder.settled(requestId, outcome, error);
+            const report = recorder.executions.at(-1);
+            if (report?.requestId === requestId) {
+                observers.notify(report);
+            }
+        },
+        reset() {
+            failures.reset();
+            recorder.reset();
+        },
+    };
+}
+//# sourceMappingURL=execution.js.map

package/dist/controls/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/controls/execution.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,mGAAmG;AACnG,MAAM,UAAU,iBAAiB,CAC7B,OAAuB,EACvB,QAA2B,EAC3B,QAAyB,EACzB,SAA6B;IAE7B,OAAO;QACH,OAAO,CAAC,SAAS,EAAE,KAAK;YACpB,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAEnC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAEpE,IAAI,MAAM,EAAE,CAAC;oBACT,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACtC,CAAC;YACL,CAAC;QACL,CAAC;QAED,SAAS,CAAC,SAAS,EAAE,MAAM;YACvB,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACtC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,CAAC,SAAS,EAAE,KAAK;YACnB,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3B,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK;YAC7B,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC5B,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAE1C,IAAI,MAAM,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;gBAClC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC;QAED,KAAK;YACD,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,QAAQ,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/controls/failure-types.d.ts

@@ -0,0 +1,52 @@
+import type { SourceLocation } from "../diagnostics/source-location.js";
+import type { MockValue } from "../mocks/types.js";
+import type { ItemAction } from "../platform/actions.js";
+export declare enum FailurePoint {
+    BeforeCall = "BEFORE_CALL",
+    AfterCall = "AFTER_CALL"
+}
+type FailureTarget = {
+    readonly type: string;
+    readonly action: ItemAction;
+    readonly method?: never;
+    readonly sql?: never;
+} | {
+    readonly method: string;
+    readonly type?: never;
+    readonly action?: never;
+    readonly sql?: never;
+} | {
+    readonly sql: string | true;
+    readonly type?: never;
+    readonly action?: never;
+    readonly method?: never;
+};
+export type FailureInjection = FailureTarget & {
+    readonly when?: Readonly<Record<string, MockValue>>;
+    readonly at?: FailurePoint;
+    readonly occurrence?: number;
+    readonly error: Error;
+};
+export interface InjectedFailureHandle extends Disposable {
+    readonly triggered: boolean;
+}
+export interface ExecutionInjection {
+    readonly id: string;
+    readonly executionId: string;
+    readonly name: string;
+    readonly at: FailurePoint;
+    readonly occurrence: number;
+    readonly source?: SourceLocation;
+    readonly error: {
+        readonly name: string;
+        readonly message: string;
+    };
+}
+export declare class InjectedFailureError extends Error {
+    readonly injection: ExecutionInjection;
+    readonly name = "InjectedFailureError";
+    readonly code = "InjectedFailure";
+    constructor(injection: ExecutionInjection, cause: Error);
+}
+export {};
+//# sourceMappingURL=failure-types.d.ts.map

package/dist/controls/failure-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-types.d.ts","sourceRoot":"","sources":["../../src/controls/failure-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,oBAAY,YAAY;IACpB,UAAU,gBAAgB;IAC1B,SAAS,eAAe;CAC3B;AAED,KAAK,aAAa,GACZ;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;CACxB,GACD;IACI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;CACxB,GACD;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AAER,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,EAAE,CAAC,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACzB,CAAC;AAEF,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACrD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAKvC,QAAQ,CAAC,SAAS,EAAE,kBAAkB;IAJ1C,SAAkB,IAAI,0BAA0B;IAChD,QAAQ,CAAC,IAAI,qBAAqB;IAElC,YACa,SAAS,EAAE,kBAAkB,EACtC,KAAK,EAAE,KAAK,EAGf;CACJ"}

package/dist/controls/failure-types.js

@@ -0,0 +1,15 @@
+export var FailurePoint;
+(function (FailurePoint) {
+    FailurePoint["BeforeCall"] = "BEFORE_CALL";
+    FailurePoint["AfterCall"] = "AFTER_CALL";
+})(FailurePoint || (FailurePoint = {}));
+export class InjectedFailureError extends Error {
+    injection;
+    name = "InjectedFailureError";
+    code = "InjectedFailure";
+    constructor(injection, cause) {
+        super(injection.error.message, { cause });
+        this.injection = injection;
+    }
+}
+//# sourceMappingURL=failure-types.js.map

package/dist/controls/failure-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-types.js","sourceRoot":"","sources":["../../src/controls/failure-types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACpB,0CAA0B,CAAA;IAC1B,wCAAwB,CAAA;AAC5B,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AA2CD,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAK9B,SAAS;IAJJ,IAAI,GAAG,sBAAsB,CAAC;IACvC,IAAI,GAAG,iBAAiB,CAAC;IAElC,YACa,SAA6B,EACtC,KAAY;QAEZ,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;yBAHjC,SAAS;IAItB,CAAC;CACJ"}

package/dist/controls/failure-validation.d.ts

@@ -0,0 +1,17 @@
+import type { MockValue } from "../mocks/types.js";
+import { ItemAction } from "../platform/actions.js";
+import { FailurePoint } from "./failure-types.js";
+import type { FailureInjection } from "./failure-types.js";
+export interface FailureRule {
+    readonly target: {
+        readonly kind: "action" | "method" | "sql";
+        readonly name: string | true;
+        readonly action?: ItemAction;
+    };
+    readonly when: Readonly<Record<string, MockValue>>;
+    readonly at: FailurePoint;
+    readonly occurrence: number;
+    readonly error: Error;
+}
+export declare function prepareFailure(value: FailureInjection): FailureRule;
+//# sourceMappingURL=failure-validation.d.ts.map

package/dist/controls/failure-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-validation.d.ts","sourceRoot":"","sources":["../../src/controls/failure-validation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,MAAM,EAAE;QACb,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;QAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;KAChC,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACzB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CA2CnE"}

package/dist/controls/failure-validation.js

@@ -0,0 +1,63 @@
+import { cloneData, freezeData } from "../core/data.js";
+import { validateParameters } from "../mocks/parameters.js";
+import { ItemAction } from "../platform/actions.js";
+import { FailurePoint } from "./failure-types.js";
+export function prepareFailure(value) {
+    const allowed = new Set([
+        "type",
+        "action",
+        "method",
+        "sql",
+        "when",
+        "at",
+        "occurrence",
+        "error",
+    ]);
+    if (value === null ||
+        typeof value !== "object" ||
+        Object.keys(value).some((key) => !allowed.has(key)) ||
+        !(value.error instanceof Error)) {
+        throw new TypeError("A failure injection needs a target and an Error.");
+    }
+    const at = value.at ?? FailurePoint.BeforeCall;
+    const occurrence = value.occurrence ?? 1;
+    if (!Object.values(FailurePoint).includes(at) ||
+        !Number.isSafeInteger(occurrence) ||
+        occurrence < 1) {
+        throw new TypeError("Failure injection requires a valid point and positive integer occurrence.");
+    }
+    validateParameters(value.when ?? {}, "Failure injection 'when'");
+    return {
+        target: target(value),
+        at,
+        occurrence,
+        error: value.error,
+        when: freezeData(cloneData(value.when ?? {})),
+    };
+}
+function target(value) {
+    if (nonempty(value.type) &&
+        value.action !== undefined &&
+        Object.values(ItemAction).includes(value.action) &&
+        value.method === undefined &&
+        value.sql === undefined) {
+        return { kind: "action", name: value.type, action: value.action };
+    }
+    if (nonempty(value.method) &&
+        value.type === undefined &&
+        value.action === undefined &&
+        value.sql === undefined) {
+        return { kind: "method", name: value.method };
+    }
+    if ((value.sql === true || nonempty(value.sql)) &&
+        value.type === undefined &&
+        value.action === undefined &&
+        value.method === undefined) {
+        return { kind: "sql", name: value.sql };
+    }
+    throw new TypeError("Select one failure target: an ItemType/action, a Method, or SQL.");
+}
+function nonempty(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+//# sourceMappingURL=failure-validation.js.map

package/dist/controls/failure-validation.js.map

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

package/dist/controls/failures.d.ts

@@ -0,0 +1,20 @@
+import type { RuntimeExecution } from "../core/types.js";
+import type { ExecutionInjection, FailureInjection, InjectedFailureHandle } from "./failure-types.js";
+import type { InjectionDetails, InjectionTarget } from "./targets.js";
+/** Rules count matching call entries. After-call faults run only if that invocation succeeds. */
+export declare class FailureRegistry {
+    private readonly record;
+    private readonly rules;
+    private readonly pending;
+    private serial;
+    constructor(record: (execution: RuntimeExecution, evidence: ExecutionInjection, target: InjectionDetails) => void);
+    get hasRules(): boolean;
+    add(injection: FailureInjection): InjectedFailureHandle;
+    enter(execution: RuntimeExecution, target: InjectionTarget): void;
+    complete(execution: RuntimeExecution): void;
+    failed(execution: RuntimeExecution): void;
+    settled(requestId: string): void;
+    reset(): void;
+    private trigger;
+}
+//# sourceMappingURL=failures.d.ts.map

package/dist/controls/failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failures.d.ts","sourceRoot":"","sources":["../../src/controls/failures.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIzD,OAAO,KAAK,EACR,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAmBtE,iGAAiG;AACjG,qBAAa,eAAe;IAMpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAL3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,MAAM,CAAK;IAEnB,YACqB,MAAM,EAAE,CACrB,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,gBAAgB,KACvB,IAAI,EACT;IAEJ,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,GAAG,CAAC,SAAS,EAAE,gBAAgB,GAAG,qBAAqB,CA0BtD;IAED,KAAK,CAAC,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAyBhE;IAED,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAW1C;IAED,MAAM,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAExC;IAED,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAM/B;IAED,KAAK,IAAI,IAAI,CAQZ;IAED,OAAO,CAAC,OAAO;CAqClB"}

package/dist/controls/failures.js

@@ -0,0 +1,128 @@
+import { freezeData } from "../core/data.js";
+import { matchesParameters } from "../mocks/registry.js";
+import { PlatformError } from "../platform/errors.js";
+import { FailurePoint, InjectedFailureError } from "./failure-types.js";
+import { prepareFailure } from "./failure-validation.js";
+const activeRulesMax = 128;
+const registrationsMax = 100_000;
+/** Rules count matching call entries. After-call faults run only if that invocation succeeds. */
+export class FailureRegistry {
+    record;
+    rules = new Set();
+    pending = new Map();
+    serial = 0;
+    constructor(record) {
+        this.record = record;
+    }
+    get hasRules() {
+        return this.rules.size > 0;
+    }
+    add(injection) {
+        const rule = prepareFailure(injection);
+        if (this.rules.size >= activeRulesMax || this.serial >= registrationsMax) {
+            throw new RangeError("The world failure-injection limit was reached. Reset the world.");
+        }
+        const registered = {
+            id: String(++this.serial),
+            rule,
+            active: true,
+            triggered: false,
+            matches: 0,
+        };
+        this.rules.add(registered);
+        return Object.freeze({
+            get triggered() {
+                return registered.triggered;
+            },
+            [Symbol.dispose]: () => {
+                registered.active = false;
+                this.rules.delete(registered);
+            },
+        });
+    }
+    enter(execution, target) {
+        const selected = [];
+        for (const registered of this.rules) {
+            if (matches(registered.rule, target)) {
+                registered.matches += 1;
+                if (registered.matches === registered.rule.occurrence) {
+                    selected.push(registered);
+                }
+            }
+        }
+        const before = selected.filter((entry) => entry.rule.at === FailurePoint.BeforeCall);
+        this.trigger(execution, target, before);
+        const after = selected.filter((entry) => entry.rule.at === FailurePoint.AfterCall);
+        if (after.length > 0) {
+            const { values: _values, aliases: _aliases, action: _action, ...details } = target;
+            this.pending.set(execution.executionId, {
+                requestId: execution.requestId,
+                target: details,
+                rules: after,
+            });
+        }
+    }
+    complete(execution) {
+        const pending = this.pending.get(execution.executionId);
+        this.pending.delete(execution.executionId);
+        if (pending) {
+            this.trigger(execution, pending.target, pending.rules.filter((rule) => rule.active));
+        }
+    }
+    failed(execution) {
+        this.pending.delete(execution.executionId);
+    }
+    settled(requestId) {
+        for (const [id, pending] of this.pending) {
+            if (pending.requestId === requestId) {
+                this.pending.delete(id);
+            }
+        }
+    }
+    reset() {
+        for (const entry of this.rules) {
+            entry.active = false;
+        }
+        this.rules.clear();
+        this.pending.clear();
+        this.serial = 0;
+    }
+    trigger(execution, target, selected) {
+        if (selected.length > 1) {
+            throw new PlatformError("AmbiguousInjection", `Ambiguous failure injections at '${target.name}'. Narrow their targets.`);
+        }
+        const entry = selected[0];
+        if (!entry) {
+            return;
+        }
+        entry.triggered = true;
+        entry.active = false;
+        this.rules.delete(entry);
+        const evidence = freezeData({
+            id: entry.id,
+            executionId: execution.executionId,
+            name: target.name,
+            at: entry.rule.at,
+            occurrence: entry.rule.occurrence,
+            ...(target.source ? { source: { ...target.source } } : {}),
+            error: {
+                name: entry.rule.error.name.slice(0, 128),
+                message: entry.rule.error.message.slice(0, 2048),
+            },
+        });
+        this.record(execution, evidence, target);
+        throw new InjectedFailureError(evidence, entry.rule.error);
+    }
+}
+function matches(rule, target) {
+    return (rule.target.kind === target.kind &&
+        (rule.target.action === undefined || rule.target.action === target.action) &&
+        target.aliases.some((name) => sameName(rule.target.name, name)) &&
+        matchesParameters(rule.when, target.values));
+}
+function sameName(left, right) {
+    return typeof left === "string" && typeof right === "string"
+        ? left.toLowerCase() === right.toLowerCase()
+        : left === right;
+}
+//# sourceMappingURL=failures.js.map

package/dist/controls/failures.js.map

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

package/dist/controls/ids.d.ts

@@ -0,0 +1,24 @@
+export interface IdSettings {
+    readonly seed: string;
+}
+export interface IdPosition {
+    readonly fixtures: number;
+    readonly items: number;
+}
+/** Seeded IDs retain the native 32-character uppercase hexadecimal format. */
+export declare function seededIds(seed: string): IdSettings;
+export declare function idSettings(value: unknown): IdSettings | undefined;
+export declare class WorldIds {
+    private readonly settings?;
+    private counters;
+    private baseline;
+    constructor(settings?: IdSettings | undefined);
+    fixture(): string;
+    item(): string;
+    checkpoint(): void;
+    capture(): IdPosition;
+    restore(position: IdPosition): void;
+    reset(): void;
+    private next;
+}
+//# sourceMappingURL=ids.d.ts.map

package/dist/controls/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/controls/ids.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAID,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAMlD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAgBjE;AAED,qBAAa,QAAQ;IAIL,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAHtC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAAwB;IAExC,YAA6B,QAAQ,CAAC,EAAE,UAAU,YAAA,EAAI;IAEtD,OAAO,IAAI,MAAM,CAEhB;IAED,IAAI,IAAI,MAAM,CAEb;IAED,UAAU,IAAI,IAAI,CAEjB;IAED,OAAO,IAAI,UAAU,CAEpB;IAED,OAAO,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAGlC;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,OAAO,CAAC,IAAI;CAiBf"}

package/dist/controls/ids.js

@@ -0,0 +1,63 @@
+const seedCharactersMax = 1024;
+/** Seeded IDs retain the native 32-character uppercase hexadecimal format. */
+export function seededIds(seed) {
+    if (typeof seed !== "string" || seed.length === 0 || seed.length > seedCharactersMax) {
+        throw new TypeError(`An ID seed must contain 1–${seedCharactersMax} characters.`);
+    }
+    return Object.freeze({ seed });
+}
+export function idSettings(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null ||
+        typeof value !== "object" ||
+        !("seed" in value) ||
+        typeof value.seed !== "string" ||
+        Object.keys(value).some((key) => key !== "seed")) {
+        throw new TypeError("Harness ids must be configured with seededIds().");
+    }
+    return seededIds(value.seed);
+}
+export class WorldIds {
+    settings;
+    counters = { fixtures: 0, items: 0 };
+    baseline = { ...this.counters };
+    constructor(settings) {
+        this.settings = settings;
+    }
+    fixture() {
+        return this.next("fixtures");
+    }
+    item() {
+        return this.next("items");
+    }
+    checkpoint() {
+        this.baseline = { ...this.counters };
+    }
+    capture() {
+        return { ...this.counters };
+    }
+    restore(position) {
+        this.counters = { ...position };
+        this.checkpoint();
+    }
+    reset() {
+        this.counters = { ...this.baseline };
+    }
+    next(stream) {
+        if (this.counters[stream] >= Number.MAX_SAFE_INTEGER) {
+            throw new RangeError("The world ID sequence is exhausted.");
+        }
+        this.counters[stream] += 1;
+        if (!this.settings) {
+            return crypto.randomUUID().replaceAll("-", "").toUpperCase();
+        }
+        return new Bun.CryptoHasher("sha256")
+            .update(JSON.stringify([this.settings.seed, stream, this.counters[stream]]))
+            .digest("hex")
+            .slice(0, 32)
+            .toUpperCase();
+    }
+}
+//# sourceMappingURL=ids.js.map

package/dist/controls/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/controls/ids.ts"],"names":[],"mappings":"AASA,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,IAAY;IAClC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;QACnF,MAAM,IAAI,SAAS,CAAC,6BAA6B,iBAAiB,cAAc,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IACI,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;QAClB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CAAC,EAClD,CAAC;QACC,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,OAAO,QAAQ;IAIY,QAAQ;IAH7B,QAAQ,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACrC,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAExC,YAA6B,QAAqB;wBAArB,QAAQ;IAAgB,CAAC;IAEtD,OAAO;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,IAAI;QACA,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,UAAU;QACN,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;IAED,OAAO;QACH,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,QAAoB;QACxB,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAED,KAAK;QACD,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;IAEO,IAAI,CAAC,MAAkC;QAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACnD,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE3B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACjE,CAAC;QAED,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC;aAChC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;aAC3E,MAAM,CAAC,KAAK,CAAC;aACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACZ,WAAW,EAAE,CAAC;IACvB,CAAC;CACJ"}

package/dist/controls/observers.d.ts

@@ -0,0 +1,20 @@
+import type { ExecutionOutcome, ExecutionReport } from "../instrumentation/types.js";
+export type ExecutionObserver = (execution: ExecutionReport) => void;
+export interface Observation extends Disposable {
+}
+export declare class ObserverError extends AggregateError {
+    readonly requestId: string;
+    readonly outcome: ExecutionOutcome;
+    readonly name = "ObserverError";
+    constructor(errors: readonly unknown[], requestId: string, outcome: ExecutionOutcome);
+}
+/** Callbacks observe settled reports; their failures never change the business transaction. */
+export declare class ExecutionObservers {
+    private readonly listeners;
+    private notifying;
+    get isNotifying(): boolean;
+    add(callback: ExecutionObserver): Observation;
+    notify(report: ExecutionReport): void;
+    close(): void;
+}
+//# sourceMappingURL=observers.d.ts.map

package/dist/controls/observers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observers.d.ts","sourceRoot":"","sources":["../../src/controls/observers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAErF,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,eAAe,KAAK,IAAI,CAAC;AAErE,MAAM,WAAW,WAAY,SAAQ,UAAU;CAAG;AAIlD,qBAAa,aAAc,SAAQ,cAAc;IAKzC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,OAAO,EAAE,gBAAgB;IALtC,SAAkB,IAAI,mBAAmB;IAEzC,YACI,MAAM,EAAE,SAAS,OAAO,EAAE,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,EAMrC;CACJ;AAED,+FAA+F;AAC/F,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,SAAS,CAAS;IAE1B,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,GAAG,CAAC,QAAQ,EAAE,iBAAiB,GAAG,WAAW,CAoB5C;IAED,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAgCpC;IAED,KAAK,IAAI,IAAI,CAEZ;CACJ"}