@enricai/barnacle 1.0.0

package/dist/testing/batch-email-confirmation.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBatchEmailConfirmation = runBatchEmailConfirmation;
+const p_queue_1 = __importDefault(require("p-queue"));
+const logging_1 = require("../lib/logging");
+const logger = (0, logging_1.getLogger)({ name: "testing/batch-email-confirmation" });
+/**
+ * Site-agnostic two-phase batch runner: submit each job with a fresh testmail
+ * inbox (phase 1), then poll each successful inbox for a confirmation email
+ * (phase 2). Returns one verdict per input job.
+ *
+ * Phase separation is intentional — all submits complete before any polling
+ * begins, matching the expected cadence for ATS email confirmations that
+ * arrive seconds after submission. The caller supplies all site-specific
+ * behaviour via injected callbacks.
+ */
+async function runBatchEmailConfirmation(jobs, opts) {
+    const { allocateInbox, submit, pollEmail, mapVerdict, concurrency = 1 } = opts;
+    logger.info(`--- phase 1: submitting ${jobs.length} jobs (concurrency=${concurrency}) ---`);
+    const queue = new p_queue_1.default({ concurrency });
+    const phase1Results = await Promise.all(jobs.map((job, i) => queue.add(async () => {
+        const inbox = allocateInbox(job);
+        const outcome = await submit(job, inbox).catch((err) => {
+            const durationMs = 0;
+            return {
+                ok: false,
+                error: err instanceof Error ? err.message : String(err),
+                durationMs,
+            };
+        });
+        const status = outcome.ok ? "PASS" : "FAIL";
+        logger.info(`[${i + 1}/${jobs.length}] ${status} → ${inbox.address}`);
+        return { job, inbox, outcome };
+    })));
+    const phase1 = phase1Results.filter((r) => r != null);
+    const passed = phase1.filter((r) => r.outcome.ok);
+    const failCount = phase1.length - passed.length;
+    logger.info(`phase 1 complete: ${passed.length}/${phase1.length} submitted, ${failCount} failed`);
+    // serial to stay within testmail's per-account rate limit
+    logger.info(`--- phase 2: polling ${passed.length} inboxes for confirmation emails ---`);
+    const pollResults = new Map();
+    for (const [i, r] of passed.entries()) {
+        const pollOutcome = await pollEmail(r.inbox);
+        pollResults.set(r.job, pollOutcome);
+        if (pollOutcome.received) {
+            logger.info(`[${i + 1}/${passed.length}] EMAIL: "${pollOutcome.message.subject}" from ${pollOutcome.message.from}`);
+        }
+        else {
+            logger.info(`[${i + 1}/${passed.length}] NO EMAIL within timeout`);
+        }
+    }
+    const emailCount = [...pollResults.values()].filter((p) => p.received).length;
+    logger.info(`final: ${passed.length} submitted, ${failCount} failed, ${emailCount} confirmation emails received`);
+    return phase1.map(({ job, outcome }) => {
+        const pollOutcome = outcome.ok ? (pollResults.get(job) ?? null) : null;
+        return mapVerdict(job, outcome, pollOutcome);
+    });
+}
+//# sourceMappingURL=batch-email-confirmation.js.map

package/dist/testing/batch-email-confirmation.js.map

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

package/dist/testing/batch-report.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Site-agnostic batch-test verdict type and markdown report renderer. Any
+ * plugin batch script can populate `BatchJobVerdict[]` and call
+ * `renderBatchReport` to get a consistent table + summary without reimplementing
+ * the formatting logic. Site-specific fields (employer, reqNum, hospitalState, etc.)
+ * stay in the per-site script; only the cross-cutting outcome fields live here.
+ */
+/** Per-job outcome produced after the submit + email-poll phases. */
+export interface BatchJobVerdict {
+    /** Stable job identifier shown in the report row (e.g. reqNum, auditJobId). */
+    jobId: string;
+    /** Whether the HTTP submit phase succeeded. */
+    submitStatus: "PASS" | "FAIL";
+    /** Round-trip duration of the submit phase, milliseconds. */
+    submitDurationMs: number | null;
+    /** Whether a confirmation email arrived during the poll window. */
+    emailReceived: boolean;
+    /** Subject line of the confirmation email, if one arrived. */
+    emailSubject?: string;
+    /** Error message from whichever phase failed first. */
+    error?: string;
+}
+export interface RenderBatchReportOptions {
+    /** Label for the first column header. Defaults to `"jobId"`. */
+    jobIdLabel?: string;
+}
+/**
+ * Renders a markdown table plus a `Net: N/M received confirmation email` summary
+ * line for a batch run. Returns the formatted string — callers decide how to emit
+ * it (process.stdout.write, logger, file, etc.).
+ */
+export declare function renderBatchReport(verdicts: BatchJobVerdict[], opts?: RenderBatchReportOptions): string;
+//# sourceMappingURL=batch-report.d.ts.map

package/dist/testing/batch-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-report.d.ts","sourceRoot":"","sources":["../../src/testing/batch-report.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mEAAmE;IACnE,aAAa,EAAE,OAAO,CAAC;IACvB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,eAAe,EAAE,EAC3B,IAAI,GAAE,wBAA6B,GAClC,MAAM,CAaR"}

package/dist/testing/batch-report.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Site-agnostic batch-test verdict type and markdown report renderer. Any
+ * plugin batch script can populate `BatchJobVerdict[]` and call
+ * `renderBatchReport` to get a consistent table + summary without reimplementing
+ * the formatting logic. Site-specific fields (employer, reqNum, hospitalState, etc.)
+ * stay in the per-site script; only the cross-cutting outcome fields live here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderBatchReport = renderBatchReport;
+/**
+ * Renders a markdown table plus a `Net: N/M received confirmation email` summary
+ * line for a batch run. Returns the formatted string — callers decide how to emit
+ * it (process.stdout.write, logger, file, etc.).
+ */
+function renderBatchReport(verdicts, opts = {}) {
+    const jobIdLabel = opts.jobIdLabel ?? "jobId";
+    const rows = [
+        `| ${jobIdLabel} | submit | dur (s) | email | subject / error |`,
+        `|---|---|---|---|---|`,
+        ...verdicts.map((v) => {
+            const dur = v.submitDurationMs != null ? (v.submitDurationMs / 1000).toFixed(1) : "-";
+            const detail = v.emailSubject ? v.emailSubject.slice(0, 60) : (v.error ?? "—");
+            return `| ${v.jobId} | ${v.submitStatus} | ${dur} | ${v.emailReceived ? "Y" : "N"} | ${detail} |`;
+        }),
+    ];
+    const emailCount = verdicts.filter((v) => v.emailReceived).length;
+    return `\n${rows.join("\n")}\n\nNet: ${emailCount}/${verdicts.length} received confirmation email\n`;
+}
+//# sourceMappingURL=batch-report.js.map

package/dist/testing/batch-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-report.js","sourceRoot":"","sources":["../../src/testing/batch-report.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA4BH,8CAgBC;AArBD;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,QAA2B,EAC3B,OAAiC,EAAE;IAEnC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC;IAC9C,MAAM,IAAI,GAAG;QACX,KAAK,UAAU,iDAAiD;QAChE,uBAAuB;QACvB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpB,MAAM,GAAG,GAAG,CAAC,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACtF,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;YAC/E,OAAO,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,YAAY,MAAM,GAAG,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,MAAM,IAAI,CAAC;QACpG,CAAC,CAAC;KACH,CAAC;IACF,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC;IAClE,OAAO,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,UAAU,IAAI,QAAQ,CAAC,MAAM,gCAAgC,CAAC;AACvG,CAAC"}

package/dist/testing/contract-parity-suite.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Eliminates the duplicated offline schema-parity scaffold that every contract
+ * parity test repeats: build canonical payload → assert safeParse succeeds →
+ * assert each rejection case (omission, enum violation, etc.) fails with an
+ * issue on the expected path. Mirrors the shape of defineReplayIntegrationSuite
+ * so adding a parity guard for a new site is a one-call drop-in.
+ */
+import type { SitePluginMeta } from "../site-plugin";
+/** One case that must be rejected by the plugin's bodySchema. */
+export interface ParityRejectionCase {
+    /** Human-readable label for the `it` test title. */
+    name: string;
+    /**
+     * Transforms the canonical payload into the invalid variant.
+     * The function receives a shallow copy — mutating it in place is safe.
+     */
+    mutate: (payload: Record<string, unknown>) => Record<string, unknown>;
+    /**
+     * When provided, the test asserts that at least one Zod issue has a `path`
+     * that includes this element (string or index). Omit when the rejection
+     * is asserted solely by `result.success === false`.
+     */
+    expectIssuePath?: (string | number)[];
+}
+/**
+ * Options for `defineContractParitySuite`. Accepting `{ meta: SitePluginMeta }`
+ * rather than the generic `SitePlugin<TPayload, TResult>` sidesteps contravariance
+ * on `execute(payload: TPayload, …)` — the helper only reads `plugin.meta.bodySchema`.
+ */
+export interface ContractParitySuiteOptions {
+    /** Human-readable suite name, passed to `describe`. */
+    suiteName: string;
+    /** The plugin under test — only `meta.bodySchema` is accessed. */
+    plugin: {
+        meta: SitePluginMeta;
+    };
+    /**
+     * Returns the canonical, fully-valid payload for the plugin. Called once per
+     * test case so each case receives a fresh object.
+     */
+    buildPayload: () => Record<string, unknown>;
+    /**
+     * Cases that must be rejected by `plugin.meta.bodySchema.safeParse`. Each
+     * receives a shallow copy of the canonical payload; the `mutate` function
+     * introduces exactly one invalid state (field omission, enum violation, etc.).
+     */
+    rejectionCases: ParityRejectionCase[];
+}
+/**
+ * Defines an offline schema-parity suite. Runs unconditionally — no
+ * INTEGRATION environment variable needed. The suite has one accept case and
+ * one `it` per rejection case.
+ */
+export declare function defineContractParitySuite(opts: ContractParitySuiteOptions): void;
+//# sourceMappingURL=contract-parity-suite.d.ts.map

package/dist/testing/contract-parity-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-parity-suite.d.ts","sourceRoot":"","sources":["../../src/testing/contract-parity-suite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtE;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,MAAM,EAAE;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC;IACjC;;;OAGG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C;;;;OAIG;IACH,cAAc,EAAE,mBAAmB,EAAE,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI,CA+BhF"}

package/dist/testing/contract-parity-suite.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Eliminates the duplicated offline schema-parity scaffold that every contract
+ * parity test repeats: build canonical payload → assert safeParse succeeds →
+ * assert each rejection case (omission, enum violation, etc.) fails with an
+ * issue on the expected path. Mirrors the shape of defineReplayIntegrationSuite
+ * so adding a parity guard for a new site is a one-call drop-in.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineContractParitySuite = defineContractParitySuite;
+const vitest_1 = require("vitest");
+/**
+ * Defines an offline schema-parity suite. Runs unconditionally — no
+ * INTEGRATION environment variable needed. The suite has one accept case and
+ * one `it` per rejection case.
+ */
+function defineContractParitySuite(opts) {
+    const { suiteName, plugin, buildPayload, rejectionCases } = opts;
+    const schema = plugin.meta.bodySchema;
+    (0, vitest_1.describe)(suiteName, () => {
+        (0, vitest_1.it)("accepts the canonical payload", () => {
+            const result = schema.safeParse(buildPayload());
+            (0, vitest_1.expect)(result.success, result.success ? "" : JSON.stringify(result.error)).toBe(true);
+        });
+        for (const rc of rejectionCases) {
+            (0, vitest_1.it)(`rejects: ${rc.name}`, () => {
+                const mutated = rc.mutate({ ...buildPayload() });
+                const result = schema.safeParse(mutated);
+                (0, vitest_1.expect)(result.success).toBe(false);
+                if (!result.success && rc.expectIssuePath !== undefined) {
+                    const path = rc.expectIssuePath;
+                    const hit = result.error.issues.find((issue) => path.every((segment) => issue.path.includes(segment)));
+                    (0, vitest_1.expect)(hit, `expected an issue whose path includes ${JSON.stringify(path)}, got: ${JSON.stringify(result.error.issues.map((i) => i.path))}`).toBeDefined();
+                }
+            });
+        }
+    });
+}
+//# sourceMappingURL=contract-parity-suite.js.map

package/dist/testing/contract-parity-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-parity-suite.js","sourceRoot":"","sources":["../../src/testing/contract-parity-suite.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAmDH,8DA+BC;AAhFD,mCAA8C;AA4C9C;;;;GAIG;AACH,SAAgB,yBAAyB,CAAC,IAAgC;IACxE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;IAEtC,IAAA,iBAAQ,EAAC,SAAS,EAAE,GAAG,EAAE;QACvB,IAAA,WAAE,EAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC;YAChD,IAAA,eAAM,EACJ,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAE,MAA6B,CAAC,KAAK,CAAC,CAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;YAChC,IAAA,WAAE,EAAC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;gBAC7B,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,YAAY,EAAE,EAAE,CAAC,CAAC;gBACjD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;gBACzC,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;oBACxD,MAAM,IAAI,GAAG,EAAE,CAAC,eAAe,CAAC;oBAChC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7C,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CACtD,CAAC;oBACF,IAAA,eAAM,EACJ,GAAG,EACH,yCAAyC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAChI,CAAC,WAAW,EAAE,CAAC;gBAClB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/testing/coverage-guard-suite.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Provides a registry-driven structural coverage guard for site plugins.
+ * Mirrors the registry-first design of the loader: iterates SITE_PLUGINS (or a
+ * caller-supplied stub) and asserts that each registered plugin has its required
+ * co-located test file — without hardcoding any site name. Safe to run on main
+ * where SITE_PLUGINS ships empty (0 iterations → trivially green); branches that
+ * populate the registry gain coverage automatically.
+ */
+/** Minimal plugin shape required by the guard — only `meta.siteId` is needed. */
+export interface CoverageGuardPlugin {
+    meta: {
+        siteId: string;
+    };
+}
+export interface CoverageGuardSuiteOptions {
+    /** Human-readable suite name, passed to `describe`. */
+    suiteName: string;
+    /**
+     * Registry of plugins to guard. Pass `SITE_PLUGINS` from the loader for
+     * production coverage, or a stub array in unit tests.
+     */
+    plugins: CoverageGuardPlugin[];
+    /**
+     * Absolute path to the directory that contains one sub-folder per siteId.
+     * Typically `resolve(__dirname, '../sites')` from the caller's test file.
+     */
+    sitesDir: string;
+    /**
+     * Optional predicate that, when provided, is invoked once per plugin to
+     * register additional `it` assertions beyond the mandatory
+     * `contract.parity.test.ts` existence check. Defaults to no extra assertions.
+     * The predicate receives the resolved plugin directory path and the siteId.
+     */
+    extraAssertions?: (pluginDir: string, siteId: string) => void;
+}
+/**
+ * Defines a registry-driven structural coverage guard. For each plugin in
+ * `opts.plugins`, registers an `it` that asserts
+ * `<sitesDir>/<siteId>/contract.parity.test.ts` exists. Given an empty
+ * registry, registers no assertions (always green). The optional
+ * `extraAssertions` predicate allows callers to attach additional per-plugin
+ * `it` blocks (e.g. integration test file or replay fixture presence) without
+ * baking site-specific logic into the engine helper.
+ */
+export declare function defineCoverageGuardSuite(opts: CoverageGuardSuiteOptions): void;
+//# sourceMappingURL=coverage-guard-suite.d.ts.map

package/dist/testing/coverage-guard-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-guard-suite.d.ts","sourceRoot":"","sources":["../../src/testing/coverage-guard-suite.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAoB9E"}

package/dist/testing/coverage-guard-suite.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Provides a registry-driven structural coverage guard for site plugins.
+ * Mirrors the registry-first design of the loader: iterates SITE_PLUGINS (or a
+ * caller-supplied stub) and asserts that each registered plugin has its required
+ * co-located test file — without hardcoding any site name. Safe to run on main
+ * where SITE_PLUGINS ships empty (0 iterations → trivially green); branches that
+ * populate the registry gain coverage automatically.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineCoverageGuardSuite = defineCoverageGuardSuite;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const vitest_1 = require("vitest");
+/**
+ * Defines a registry-driven structural coverage guard. For each plugin in
+ * `opts.plugins`, registers an `it` that asserts
+ * `<sitesDir>/<siteId>/contract.parity.test.ts` exists. Given an empty
+ * registry, registers no assertions (always green). The optional
+ * `extraAssertions` predicate allows callers to attach additional per-plugin
+ * `it` blocks (e.g. integration test file or replay fixture presence) without
+ * baking site-specific logic into the engine helper.
+ */
+function defineCoverageGuardSuite(opts) {
+    const { suiteName, plugins, sitesDir, extraAssertions } = opts;
+    if (plugins.length === 0)
+        return;
+    (0, vitest_1.describe)(suiteName, () => {
+        for (const plugin of plugins) {
+            const { siteId } = plugin.meta;
+            const pluginDir = (0, node_path_1.resolve)(sitesDir, siteId);
+            (0, vitest_1.it)(`${siteId}: contract.parity.test.ts exists`, () => {
+                (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.resolve)(pluginDir, "contract.parity.test.ts")), `${siteId}/contract.parity.test.ts must exist`).toBe(true);
+            });
+            extraAssertions?.(pluginDir, siteId);
+        }
+    });
+}
+//# sourceMappingURL=coverage-guard-suite.js.map

package/dist/testing/coverage-guard-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-guard-suite.js","sourceRoot":"","sources":["../../src/testing/coverage-guard-suite.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA2CH,4DAoBC;AA7DD,qCAAqC;AACrC,yCAAoC;AAEpC,mCAA8C;AA6B9C;;;;;;;;GAQG;AACH,SAAgB,wBAAwB,CAAC,IAA+B;IACtE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAE/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEjC,IAAA,iBAAQ,EAAC,SAAS,EAAE,GAAG,EAAE;QACvB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;YAC/B,MAAM,SAAS,GAAG,IAAA,mBAAO,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAE5C,IAAA,WAAE,EAAC,GAAG,MAAM,kCAAkC,EAAE,GAAG,EAAE;gBACnD,IAAA,eAAM,EACJ,IAAA,oBAAU,EAAC,IAAA,mBAAO,EAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC,EACzD,GAAG,MAAM,qCAAqC,CAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,CAAC,CAAC,CAAC;YAEH,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/testing/fixtures/resume.pdf

@@ -0,0 +1,54 @@
+%PDF-1.4
+%����
+1 0 obj
+<< /Type /Catalog /Pages 2 0 R >>
+endobj
+2 0 obj
+<< /Type /Pages /Kids [3 0 R] /Count 1 >>
+endobj
+3 0 obj
+<< /Type /Page /Parent 2 0 R /MediaBox [0 0 612 792] /Contents 4 0 R /Resources << /Font << /F1 5 0 R >> >> >>
+endobj
+4 0 obj
+<< /Length 363 >>
+stream
+BT
+/F1 14 Tf
+50 740 Td
+(Maximo Tableta) Tj
+0 -25 Td
+(Resume) Tj
+0 -30 Td
+/F1 10 Tf
+(Email: vibrasmeditationdev@gmail.com) Tj
+0 -15 Td
+(Phone: 555-867-5309) Tj
+0 -25 Td
+(EXPERIENCE) Tj
+0 -15 Td
+(Test Candidate, 2020-present) Tj
+0 -15 Td
+(  - Automated form submission specialist) Tj
+0 -25 Td
+(SKILLS) Tj
+0 -15 Td
+(  - Filling out fields with correct values) Tj
+ET
+endstream
+endobj
+5 0 obj
+<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica >>
+endobj
+xref
+0 6
+0000000000 65535 f 
+0000000015 00000 n 
+0000000064 00000 n 
+0000000121 00000 n 
+0000000247 00000 n 
+0000000660 00000 n 
+trailer
+<< /Size 6 /Root 1 0 R >>
+startxref
+730
+%%EOF

package/dist/testing/integration-runner.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Site-agnostic scaffold for integration tests that submit via a plugin and
+ * verify success by polling a testmail.app inbox. Each integration test owns
+ * its per-job payload mapping; this module owns the orchestration that is
+ * identical across every site: allocate inbox → build context → dispatch →
+ * poll → return.
+ */
+import type { SitePlugin, SitePluginResult } from "../site-plugin";
+import { allocateTestmailInbox, type PollTestmailInboxOptions, type TestmailInbox, type TestmailMessage } from "../testmail/client";
+/**
+ * Options accepted by `runIntegrationJob`. The payload builder is the only
+ * per-site concern — everything else (inbox allocation, context construction,
+ * dispatch, poll) is generic.
+ */
+export interface IntegrationJobOptions {
+    /**
+     * The plugin under test. Cast via `as SitePlugin<unknown, unknown>` at the
+     * call site when the payload type is site-specific.
+     */
+    plugin: SitePlugin<unknown, unknown>;
+    /**
+     * Called with the freshly allocated testmail inbox so the caller can embed
+     * `inbox.address` in the site-specific payload fields (e.g. `Email`,
+     * `ContactEmailAddress`). Returns the complete payload to pass to dispatch.
+     */
+    buildPayload: (inbox: TestmailInbox) => unknown;
+    /**
+     * The `baseUrl` injected into the plugin context. Typically `job.baseUrl`
+     * from the replay-jobs fixture.
+     */
+    baseUrl: string;
+    /** Total wait budget passed to `pollTestmailInbox`. Default 120_000 ms. */
+    pollTimeoutMs?: number;
+    /** Optional subject filter passed to `pollTestmailInbox`. Omit to accept any message. */
+    pollSubjectContains?: string;
+    /**
+     * Override for inbox allocation options (e.g. `namespace` in tests that
+     * stub testmail without a real TESTMAIL_NAMESPACE in env).
+     */
+    inboxOptions?: Parameters<typeof allocateTestmailInbox>[0];
+    /**
+     * Override the `pollTestmailInbox` implementation. Injected by unit tests
+     * to avoid real network calls.
+     */
+    pollFn?: (opts: PollTestmailInboxOptions) => Promise<TestmailMessage>;
+}
+/** Combined return value so callers can inspect both the dispatch result and the inbox message. */
+export interface IntegrationJobResult<TResult> {
+    result: SitePluginResult<TResult>;
+    message: TestmailMessage;
+}
+/**
+ * Runs one integration-test job end-to-end. Allocates a testmail inbox,
+ * delegates payload construction to `buildPayload`, dispatches the plugin,
+ * and polls for a confirmation email — returning both the dispatch result and
+ * the received message so callers can make assertions on either.
+ *
+ * Throws when dispatch rejects or when the inbox poll times out (via
+ * `TestmailTimeoutError`).
+ */
+export declare function runIntegrationJob<TResult = Record<string, unknown>>(opts: IntegrationJobOptions): Promise<IntegrationJobResult<TResult>>;
+//# sourceMappingURL=integration-runner.d.ts.map

package/dist/testing/integration-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-runner.d.ts","sourceRoot":"","sources":["../../src/testing/integration-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,KAAK,wBAAwB,EAE7B,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAI3B;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrC;;;;OAIG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IAChD;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,wBAAwB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CACvE;AAED,mGAAmG;AACnG,MAAM,WAAW,oBAAoB,CAAC,OAAO;IAC3C,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAgCxC"}

package/dist/testing/integration-runner.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Site-agnostic scaffold for integration tests that submit via a plugin and
+ * verify success by polling a testmail.app inbox. Each integration test owns
+ * its per-job payload mapping; this module owns the orchestration that is
+ * identical across every site: allocate inbox → build context → dispatch →
+ * poll → return.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runIntegrationJob = runIntegrationJob;
+const config_1 = require("../config");
+const dispatch_metrics_1 = require("../lib/dispatch-metrics");
+const logging_1 = require("../lib/logging");
+const loader_1 = require("../plugins/loader");
+const client_1 = require("../testmail/client");
+const DEFAULT_POLL_TIMEOUT_MS = 120_000;
+/**
+ * Runs one integration-test job end-to-end. Allocates a testmail inbox,
+ * delegates payload construction to `buildPayload`, dispatches the plugin,
+ * and polls for a confirmation email — returning both the dispatch result and
+ * the received message so callers can make assertions on either.
+ *
+ * Throws when dispatch rejects or when the inbox poll times out (via
+ * `TestmailTimeoutError`).
+ */
+async function runIntegrationJob(opts) {
+    const { plugin, buildPayload, baseUrl, pollTimeoutMs = DEFAULT_POLL_TIMEOUT_MS, pollSubjectContains, inboxOptions, pollFn = client_1.pollTestmailInbox, } = opts;
+    const logger = (0, logging_1.getLogger)({ name: `integration/${plugin.meta.siteId}` });
+    const inbox = (0, client_1.allocateTestmailInbox)(inboxOptions);
+    const payload = buildPayload(inbox);
+    const context = {
+        baseUrl,
+        logger,
+        config: config_1.config,
+        requestId: "integration-test",
+        metricsCollector: new dispatch_metrics_1.MetricsCollector(),
+    };
+    const result = await (0, loader_1.dispatch)(plugin, payload, context);
+    const message = await pollFn({
+        inbox,
+        timeoutMs: pollTimeoutMs,
+        ...(pollSubjectContains ? { subjectContains: pollSubjectContains } : {}),
+    });
+    return { result, message };
+}
+//# sourceMappingURL=integration-runner.js.map

package/dist/testing/integration-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-runner.js","sourceRoot":"","sources":["../../src/testing/integration-runner.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAsEH,8CAkCC;AAtGD,qCAAkC;AAClC,6DAA0D;AAC1D,2CAA0C;AAC1C,6CAA4C;AAE5C,8CAM2B;AAE3B,MAAM,uBAAuB,GAAG,OAAO,CAAC;AA8CxC;;;;;;;;GAQG;AACI,KAAK,UAAU,iBAAiB,CACrC,IAA2B;IAE3B,MAAM,EACJ,MAAM,EACN,YAAY,EACZ,OAAO,EACP,aAAa,GAAG,uBAAuB,EACvC,mBAAmB,EACnB,YAAY,EACZ,MAAM,GAAG,0BAAiB,GAC3B,GAAG,IAAI,CAAC;IAET,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,eAAe,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,IAAA,8BAAqB,EAAC,YAAY,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG;QACd,OAAO;QACP,MAAM;QACN,MAAM,EAAN,eAAM;QACN,SAAS,EAAE,kBAAkB;QAC7B,gBAAgB,EAAE,IAAI,mCAAgB,EAAE;KACzC,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,IAAA,iBAAQ,EAAU,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAEjE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC;QAC3B,KAAK;QACL,SAAS,EAAE,aAAa;QACxB,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/testing/mock-fetch-response.d.ts

@@ -0,0 +1,7 @@
+import type { fetch as undiciFetch } from "undici";
+/**
+ * Centralises the undici-compatible Response stub so every flow test stops
+ * hand-rolling its own makeResponse with an inconsistent method surface.
+ */
+export declare function makeMockFetchResponse(status: number, body: string, headers?: Record<string, string>): Awaited<ReturnType<typeof undiciFetch>>;
+//# sourceMappingURL=mock-fetch-response.d.ts.map

package/dist/testing/mock-fetch-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-fetch-response.d.ts","sourceRoot":"","sources":["../../src/testing/mock-fetch-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAOzC"}

package/dist/testing/mock-fetch-response.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeMockFetchResponse = makeMockFetchResponse;
+/**
+ * Centralises the undici-compatible Response stub so every flow test stops
+ * hand-rolling its own makeResponse with an inconsistent method surface.
+ */
+function makeMockFetchResponse(status, body, headers = {}) {
+    return {
+        status,
+        headers: new Headers(headers),
+        text: () => Promise.resolve(body),
+        json: () => Promise.resolve(JSON.parse(body)),
+    };
+}
+//# sourceMappingURL=mock-fetch-response.js.map

package/dist/testing/mock-fetch-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-fetch-response.js","sourceRoot":"","sources":["../../src/testing/mock-fetch-response.ts"],"names":[],"mappings":";;AAMA,sDAWC;AAfD;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,MAAc,EACd,IAAY,EACZ,UAAkC,EAAE;IAEpC,OAAO;QACL,MAAM;QACN,OAAO,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC;QAC7B,IAAI,EAAE,GAAoB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAClD,IAAI,EAAE,GAAqB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;KACV,CAAC;AAC1D,CAAC"}

package/dist/testing/persona-fixture.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Standard test persona used by recon runs + integration tests. Centralised
+ * so every plugin uses the same identity (helps cross-site audit-log
+ * correlation) and so we change it in one place when a field gets rejected
+ * by a new validator (e.g. the 555 → 310 phone-number swap during the
+ * AppCast recon investigation).
+ *
+ * The Email field is intentionally omitted — callers should compose the
+ * payload by combining this fixture with a freshly allocated testmail.app
+ * address. See `src/testmail/client.ts:allocateTestmailInbox`.
+ */
+export declare const TEST_PERSONA: {
+    readonly FirstName: "Reginald";
+    readonly LastName: "Reconaldo";
+    /**
+     * Avoid both the 555 fictional range AND famously-fictional numbers like
+     * 310-867-5309 ("Jenny / 867-5309" pop-song). Some ATS phone-input
+     * widgets reject both with "Please provide correct phone number."
+     *
+     * 208-377-2156: Boise area code, random NXX-XXXX, no known
+     * pop-culture meaning.
+     */
+    readonly Phone: "+1 208-377-2156";
+    readonly Address: {
+        readonly Line1: "123 Test Lane";
+        readonly City: "Austin";
+        /** Two-letter region code for forms that want abbreviations. */
+        readonly StateAbbreviation: "TX";
+        /** Full state name for forms that want the long form (e.g. ClearCompany). */
+        readonly StateName: "Texas";
+        readonly PostalCode: "78701";
+        /** Texas county for Austin. Required by tenants (Encompass Health, etc.)
+         * that nest a County field inside the Address group. */
+        readonly County: "Travis County";
+        /** Long-form for `<select>`s that show country names. */
+        readonly CountryName: "United States";
+        /** Two-letter code for ISO-3166-style inputs. */
+        readonly CountryCode: "US";
+    };
+    /**
+     * Throwaway values for forms that require SSN / DOB even for testing.
+     * 123-45-6789 is a documented IRS test SSN; 01/01/1990 is a stable adult
+     * birthday that won't trip age-bracket validators.
+     */
+    readonly Ssn: "123-45-6789";
+    readonly DateOfBirth: "01/01/1990";
+    /** Generic employment row used to fill required Employment History sections. */
+    readonly Employment: {
+        readonly Title: "Automation Testing Specialist";
+        readonly CompanyName: "Self-employed";
+        readonly CompanyPhone: "+1 310-867-5311";
+        readonly StartDate: "01/01/2020";
+        readonly EndDate: "12/31/2025";
+        readonly PositionDescription: "Designed and executed automated browser testing workflows for healthcare application portals";
+    };
+    /** Three reference rows used by ClearCompany and similar ATSes that ask for them. */
+    readonly References: readonly [{
+        readonly FirstName: "Pat";
+        readonly LastName: "Smith";
+        readonly Email: "pat.smith.ref@example.com";
+        readonly Phone: "+1 310-867-5312";
+    }, {
+        readonly FirstName: "Jamie";
+        readonly LastName: "Johnson";
+        readonly Email: "jamie.johnson.ref@example.com";
+        readonly Phone: "+1 310-867-5313";
+    }, {
+        readonly FirstName: "Taylor";
+        readonly LastName: "Brown";
+        readonly Email: "taylor.brown.ref@example.com";
+        readonly Phone: "+1 310-867-5314";
+    }];
+    /** Signature text used in legal-attestation sections. */
+    readonly SignatureName: "Reginald Reconaldo";
+};
+export type TestPersona = typeof TEST_PERSONA;
+//# sourceMappingURL=persona-fixture.d.ts.map

package/dist/testing/persona-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-fixture.d.ts","sourceRoot":"","sources":["../../src/testing/persona-fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY;;;IAGvB;;;;;;;OAOG;;;;;QAKD,gEAAgE;;QAEhE,6EAA6E;;;QAG7E;gEACwD;;QAExD,yDAAyD;;QAEzD,iDAAiD;;;IAGnD;;;;OAIG;;;IAGH,gFAAgF;;;;;;;;;IAUhF,qFAAqF;;;;;;;;;;;;;;;;;IAqBrF,yDAAyD;;CAEjD,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC"}