@nifrajs/testing 1.11.0 → 1.12.0

package/dist/failure-lab.js

@@ -0,0 +1,207 @@
+/**
+ * Deterministic durable-failure laboratory.
+ *
+ * The controller is an off-hot-path port: tests place named checkpoints around real adapters and a
+ * replayable schedule injects crashes, duplicate/reordered delivery, virtual delay, deadline expiry,
+ * lost provider replies, or checkpoint contention. Evidence contains tokens only - never payloads,
+ * provider results, exception messages, or stacks.
+ */
+export class FailureInjectedError extends Error {
+    kind;
+    point;
+    occurrence;
+    name = "FailureInjectedError";
+    constructor(kind, point, occurrence) {
+        super(`failure laboratory injected ${kind} at ${point}#${occurrence}`);
+        this.kind = kind;
+        this.point = point;
+        this.occurrence = occurrence;
+    }
+}
+const DEFAULT_SEED = 0x46_41_49_4c;
+const MAX_DIRECTIVES = 128;
+const MAX_OCCURRENCE = 10_000;
+const MAX_COPIES = 10;
+const MAX_DELAY_MS = 24 * 60 * 60_000;
+const POINT = /^[a-z][a-z0-9._:-]{0,127}$/;
+const SCENARIO = /^[a-z][a-z0-9._-]{0,127}$/;
+const integerIn = (value, min, max, label) => {
+    if (!Number.isSafeInteger(value) || value < min || value > max) {
+        throw new RangeError(`failure laboratory: ${label} must be an integer from ${min} to ${max}`);
+    }
+    return value;
+};
+const pointOf = (value) => {
+    if (!POINT.test(value)) {
+        throw new TypeError(`failure laboratory: invalid failure point ${JSON.stringify(value)}`);
+    }
+    return value;
+};
+const normalizeSeed = (seed) => Number.isFinite(seed) ? Math.trunc(seed) >>> 0 : DEFAULT_SEED;
+const hash = (value) => {
+    let result = 2_166_136_261;
+    for (let index = 0; index < value.length; index += 1) {
+        result ^= value.charCodeAt(index);
+        result = Math.imul(result, 16_777_619);
+    }
+    return result >>> 0;
+};
+function normalizeSchedule(schedule) {
+    if (!Array.isArray(schedule) || schedule.length > MAX_DIRECTIVES) {
+        throw new RangeError(`failure laboratory: schedule cannot exceed ${MAX_DIRECTIVES} directives`);
+    }
+    const seen = new Set();
+    return Object.freeze(schedule.map((directive) => {
+        const point = pointOf(directive.point);
+        const occurrence = integerIn(directive.occurrence ?? 1, 1, MAX_OCCURRENCE, "occurrence");
+        const identity = `${directive.kind}\n${point}\n${occurrence}`;
+        if (seen.has(identity)) {
+            throw new Error(`failure laboratory: duplicate directive ${directive.kind} at ${point}#${occurrence}`);
+        }
+        seen.add(identity);
+        if (directive.kind === "duplicate-delivery") {
+            return Object.freeze({
+                kind: directive.kind,
+                point,
+                occurrence,
+                copies: integerIn(directive.copies ?? 2, 2, MAX_COPIES, "copies"),
+            });
+        }
+        if (directive.kind === "delay") {
+            return Object.freeze({
+                kind: directive.kind,
+                point,
+                occurrence,
+                delayMs: integerIn(directive.delayMs, 1, MAX_DELAY_MS, "delayMs"),
+            });
+        }
+        return Object.freeze({ kind: directive.kind, point, occurrence });
+    }));
+}
+/** Build one isolated deterministic controller. Construct a fresh lab for every replay. */
+export function createFailureLab(options) {
+    const seed = normalizeSeed(options.seed);
+    const schedule = normalizeSchedule(options.schedule);
+    let virtualTimeMs = options.startTimeMs ?? 0;
+    if (!Number.isSafeInteger(virtualTimeMs) || virtualTimeMs < 0) {
+        throw new RangeError("failure laboratory: startTimeMs must be a non-negative safe integer");
+    }
+    const counts = new Map();
+    const emitted = [];
+    let sequence = 0;
+    const directives = (point, kinds) => {
+        pointOf(point);
+        const occurrences = new Map();
+        for (const kind of kinds) {
+            const key = `${kind}\n${point}`;
+            const occurrence = (counts.get(key) ?? 0) + 1;
+            counts.set(key, occurrence);
+            occurrences.set(kind, occurrence);
+        }
+        return schedule.filter((directive) => directive.point === point && occurrences.get(directive.kind) === directive.occurrence);
+    };
+    const emit = (directive) => {
+        emitted.push(Object.freeze({
+            sequence: ++sequence,
+            kind: directive.kind,
+            point: directive.point,
+            occurrence: directive.occurrence,
+            virtualTimeMs,
+        }));
+    };
+    const lab = {
+        checkpoint(point) {
+            for (const directive of directives(point, ["delay", "crash"])) {
+                if (directive.kind === "delay")
+                    virtualTimeMs += directive.delayMs;
+                emit(directive);
+                if (directive.kind === "crash") {
+                    throw new FailureInjectedError("crash", point, directive.occurrence);
+                }
+            }
+        },
+        deliveries(point, values) {
+            let output = [...values];
+            for (const directive of directives(point, ["duplicate-delivery", "reorder-events"])) {
+                if (directive.kind === "duplicate-delivery") {
+                    output = output.flatMap((value) => Array.from({ length: directive.copies }, () => value));
+                }
+                else if (directive.kind === "reorder-events" && output.length > 1) {
+                    const offset = 1 + (hash(`${seed}:${point}:${directive.occurrence}`) % (output.length - 1));
+                    output = [...output.slice(offset), ...output.slice(0, offset)];
+                }
+                emit(directive);
+            }
+            return Object.freeze(output);
+        },
+        async provider(point, operation) {
+            pointOf(point);
+            const result = await operation();
+            for (const directive of directives(point, ["lose-provider-reply"])) {
+                emit(directive);
+                throw new FailureInjectedError("lose-provider-reply", point, directive.occurrence);
+            }
+            return result;
+        },
+        remaining(point, remainingMs) {
+            if (!Number.isFinite(remainingMs)) {
+                throw new TypeError("failure laboratory: remainingMs must be finite");
+            }
+            const remaining = Math.max(0, remainingMs);
+            const injected = directives(point, ["expire-budget"]);
+            for (const directive of injected)
+                emit(directive);
+            return injected.length > 0 ? 0 : remaining;
+        },
+        checkpointContended(point) {
+            const injected = directives(point, ["contend-checkpoint"]);
+            for (const directive of injected)
+                emit(directive);
+            return injected.length > 0;
+        },
+        now: () => virtualTimeMs,
+        evidence: () => Object.freeze([...emitted]),
+        replay: () => Object.freeze({ seed, schedule }),
+    };
+    return Object.freeze(lab);
+}
+/** Run one scenario and evaluate its post-failure invariant without leaking its result or error text. */
+export async function runFailureScenario(scenario, options) {
+    if (!SCENARIO.test(scenario.name)) {
+        throw new TypeError(`failure laboratory: invalid scenario name ${JSON.stringify(scenario.name)}`);
+    }
+    const lab = createFailureLab(options);
+    let result;
+    let error;
+    try {
+        result = await scenario.execute(lab);
+    }
+    catch (caught) {
+        error = caught;
+    }
+    let ok = false;
+    try {
+        ok =
+            (await scenario.verify({
+                lab,
+                ...(error === undefined ? { result: result } : { error }),
+            })) === true;
+    }
+    catch {
+        ok = false;
+    }
+    const errorSummary = error === undefined
+        ? undefined
+        : Object.freeze({
+            name: error instanceof Error ? error.name : "NonErrorThrown",
+            ...(error instanceof FailureInjectedError ? { kind: error.kind } : {}),
+        });
+    return Object.freeze({
+        name: scenario.name,
+        ok,
+        replay: lab.replay(),
+        evidence: lab.evidence(),
+        ...(errorSummary === undefined ? {} : { error: errorSummary }),
+    });
+}
+//# sourceMappingURL=failure-lab.js.map

package/dist/failure-lab.js.map

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

package/dist/index.d.ts

@@ -8,7 +8,9 @@
  *   const { client, cookies } = testSession<typeof app>(app)
  */
 export { AdversarialContractError, type AdversarialContractOptions, type AdversarialContractReport, type AdversarialContractResult, assertAdversarialContract, type ContractCaseContext, type ContractCaseKind, type ContractCoverageGap, type ContractCoverageGapCode, type ContractReplay, type ContractRuntime, type ContractTarget, type ContractTestApp, type ContractWitness, runAdversarialContract, } from "./adversarial.js";
+export { AdapterCertificationError, type AdapterCertificationProfile, type AdapterCertificationReport, assertAdapterCertification, type CertifiableCacheEntry, type CertifiableCacheStore, type CertifiableDomainEvent, type CertifiableEventDeliveryAdapter, type CertifiableEventRecord, type CertifiableJobStore, type CertifiableRuntimeAdapter, type CertifiableRuntimeServer, type CertifiableStorageAdapter, type CertificationCapabilityEvidence, type CertificationCheck, type CertificationCheckEvidence, cacheStoreCertificationProfile, certifyAdapter, defineCertificationProfile, eventDeliveryCertificationProfile, jobStoreCertificationProfile, runtimeAdapterCertificationProfile, storageAdapterCertificationProfile, verifyAdapterCertification, } from "./certification.js";
 export { type CookieJar, cookieJar } from "./cookies.js";
+export { createFailureLab, type FailureDirective, type FailureEvidence, FailureInjectedError, type FailureKind, type FailureLab, type FailureLabOptions, type FailureReplay, type FailureScenario, type FailureScenarioReport, runFailureScenario, } from "./failure-lab.js";
 export { assertIncidentReplays, type CapturedRequest, type CapturedRequestInput, type CaptureIncidentOptions, captureIncident, type GenerateRegressionTestOptions, generateRegressionTest, type IncidentCapsule, IncidentReplayError, type IncidentReplayResult, type ReplayIncidentOptions, redactForEmission, replayIncident, shapeOf, } from "./incident.js";
 export { type AppLike, type TestSession, type TestSessionOptions, testSession } from "./session.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,wBAAwB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,sBAAsB,GACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,KAAK,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,eAAe,EACf,KAAK,6BAA6B,EAClC,sBAAsB,EACtB,KAAK,eAAe,EACpB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,iBAAiB,EACjB,cAAc,EACd,OAAO,GACR,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,wBAAwB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,sBAAsB,GACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,yBAAyB,EACzB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,0BAA0B,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,8BAA8B,EAC9B,cAAc,EACd,0BAA0B,EAC1B,iCAAiC,EACjC,4BAA4B,EAC5B,kCAAkC,EAClC,kCAAkC,EAClC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,KAAK,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EACL,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,kBAAkB,GACnB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,eAAe,EACf,KAAK,6BAA6B,EAClC,sBAAsB,EACtB,KAAK,eAAe,EACpB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,iBAAiB,EACjB,cAAc,EACd,OAAO,GACR,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -8,7 +8,9 @@
  *   const { client, cookies } = testSession<typeof app>(app)
  */
 export { AdversarialContractError, assertAdversarialContract, runAdversarialContract, } from "./adversarial.js";
+export { AdapterCertificationError, assertAdapterCertification, cacheStoreCertificationProfile, certifyAdapter, defineCertificationProfile, eventDeliveryCertificationProfile, jobStoreCertificationProfile, runtimeAdapterCertificationProfile, storageAdapterCertificationProfile, verifyAdapterCertification, } from "./certification.js";
 export { cookieJar } from "./cookies.js";
+export { createFailureLab, FailureInjectedError, runFailureScenario, } from "./failure-lab.js";
 export { assertIncidentReplays, captureIncident, generateRegressionTest, IncidentReplayError, redactForEmission, replayIncident, shapeOf, } from "./incident.js";
 export { testSession } from "./session.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,wBAAwB,EAIxB,yBAAyB,EAUzB,sBAAsB,GACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAkB,SAAS,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EACL,qBAAqB,EAIrB,eAAe,EAEf,sBAAsB,EAEtB,mBAAmB,EAGnB,iBAAiB,EACjB,cAAc,EACd,OAAO,GACR,MAAM,eAAe,CAAA;AACtB,OAAO,EAA2D,WAAW,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,wBAAwB,EAIxB,yBAAyB,EAUzB,sBAAsB,GACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,yBAAyB,EAGzB,0BAA0B,EAa1B,8BAA8B,EAC9B,cAAc,EACd,0BAA0B,EAC1B,iCAAiC,EACjC,4BAA4B,EAC5B,kCAAkC,EAClC,kCAAkC,EAClC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAkB,SAAS,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,EACL,gBAAgB,EAGhB,oBAAoB,EAOpB,kBAAkB,GACnB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,qBAAqB,EAIrB,eAAe,EAEf,sBAAsB,EAEtB,mBAAmB,EAGnB,iBAAiB,EACjB,cAAc,EACd,OAAO,GACR,MAAM,eAAe,CAAA;AACtB,OAAO,EAA2D,WAAW,EAAE,MAAM,cAAc,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nifrajs/testing",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "description": "Contract-derived adversarial tests, runtime-matrix response conformance, and cookie-aware in-process sessions for Nifra apps.",
   "keywords": [
     "bun",
@@ -20,6 +20,11 @@
       "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./certification": {
+      "bun": "./src/certification.ts",
+      "types": "./dist/certification.d.ts",
+      "default": "./dist/certification.js"
     }
   },
   "files": [
@@ -32,9 +37,9 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@nifrajs/client": "1.11.0",
-    "@nifrajs/core": "1.11.0",
-    "@nifrajs/mock": "1.11.0"
+    "@nifrajs/client": "1.12.0",
+    "@nifrajs/core": "1.12.0",
+    "@nifrajs/mock": "1.12.0"
   },
   "publishConfig": {
     "access": "public"