@enricai/barnacle 1.0.0

package/dist/testing/persona-fixture.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEST_PERSONA = void 0;
+/**
+ * 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`.
+ */
+exports.TEST_PERSONA = {
+    FirstName: "Reginald",
+    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.
+     */
+    Phone: "+1 208-377-2156",
+    Address: {
+        Line1: "123 Test Lane",
+        City: "Austin",
+        /** Two-letter region code for forms that want abbreviations. */
+        StateAbbreviation: "TX",
+        /** Full state name for forms that want the long form (e.g. ClearCompany). */
+        StateName: "Texas",
+        PostalCode: "78701",
+        /** Texas county for Austin. Required by tenants (Encompass Health, etc.)
+         * that nest a County field inside the Address group. */
+        County: "Travis County",
+        /** Long-form for `<select>`s that show country names. */
+        CountryName: "United States",
+        /** Two-letter code for ISO-3166-style inputs. */
+        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.
+     */
+    Ssn: "123-45-6789",
+    DateOfBirth: "01/01/1990",
+    /** Generic employment row used to fill required Employment History sections. */
+    Employment: {
+        Title: "Automation Testing Specialist",
+        CompanyName: "Self-employed",
+        CompanyPhone: "+1 310-867-5311",
+        StartDate: "01/01/2020",
+        EndDate: "12/31/2025",
+        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. */
+    References: [
+        {
+            FirstName: "Pat",
+            LastName: "Smith",
+            Email: "pat.smith.ref@example.com",
+            Phone: "+1 310-867-5312",
+        },
+        {
+            FirstName: "Jamie",
+            LastName: "Johnson",
+            Email: "jamie.johnson.ref@example.com",
+            Phone: "+1 310-867-5313",
+        },
+        {
+            FirstName: "Taylor",
+            LastName: "Brown",
+            Email: "taylor.brown.ref@example.com",
+            Phone: "+1 310-867-5314",
+        },
+    ],
+    /** Signature text used in legal-attestation sections. */
+    SignatureName: "Reginald Reconaldo",
+};
+//# sourceMappingURL=persona-fixture.js.map

package/dist/testing/persona-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-fixture.js","sourceRoot":"","sources":["../../src/testing/persona-fixture.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACU,QAAA,YAAY,GAAG;IAC1B,SAAS,EAAE,UAAU;IACrB,QAAQ,EAAE,WAAW;IACrB;;;;;;;OAOG;IACH,KAAK,EAAE,iBAAiB;IACxB,OAAO,EAAE;QACP,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,QAAQ;QACd,gEAAgE;QAChE,iBAAiB,EAAE,IAAI;QACvB,6EAA6E;QAC7E,SAAS,EAAE,OAAO;QAClB,UAAU,EAAE,OAAO;QACnB;gEACwD;QACxD,MAAM,EAAE,eAAe;QACvB,yDAAyD;QACzD,WAAW,EAAE,eAAe;QAC5B,iDAAiD;QACjD,WAAW,EAAE,IAAI;KAClB;IACD;;;;OAIG;IACH,GAAG,EAAE,aAAa;IAClB,WAAW,EAAE,YAAY;IACzB,gFAAgF;IAChF,UAAU,EAAE;QACV,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,eAAe;QAC5B,YAAY,EAAE,iBAAiB;QAC/B,SAAS,EAAE,YAAY;QACvB,OAAO,EAAE,YAAY;QACrB,mBAAmB,EACjB,8FAA8F;KACjG;IACD,qFAAqF;IACrF,UAAU,EAAE;QACV;YACE,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,2BAA2B;YAClC,KAAK,EAAE,iBAAiB;SACzB;QACD;YACE,SAAS,EAAE,OAAO;YAClB,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,+BAA+B;YACtC,KAAK,EAAE,iBAAiB;SACzB;QACD;YACE,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,8BAA8B;YACrC,KAAK,EAAE,iBAAiB;SACzB;KACF;IACD,yDAAyD;IACzD,aAAa,EAAE,oBAAoB;CAC3B,CAAC"}

package/dist/testing/replay-integration-suite.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Eliminates the repeated describe.skipIf / it.each / runIntegrationJob /
+ * message.subject assertion that every replay-based integration test duplicates.
+ * Callers supply only the site-specific plugin, job list, and payload builder;
+ * the generic scaffold (file load, INTEGRATION gate, fan-out, default assertion)
+ * lives here once.
+ */
+import type { SitePlugin } from "../site-plugin";
+import type { PollTestmailInboxOptions, TestmailInbox, TestmailMessage } from "../testmail/client";
+/** Job source: either a pre-loaded array or a path resolved relative to the caller's directory. */
+type JobsSource<TJob> = {
+    jobs: TJob[];
+} | {
+    jobsPath: string;
+    dirname: string;
+};
+/**
+ * Options for `defineReplayIntegrationSuite`. The `plugin` type parameter may
+ * be narrower than `SitePlugin<unknown, unknown>` — the helper casts internally.
+ */
+export interface ReplayIntegrationSuiteOptions<TJob> {
+    /** Human-readable suite name, passed to `describe`. */
+    suiteName: string;
+    /** The plugin under test. Internally cast to `SitePlugin<unknown, unknown>`. */
+    plugin: SitePlugin<unknown, unknown>;
+    /**
+     * Override `pollTestmailInbox` so unit tests avoid real network calls.
+     * Mirrors the same escape-hatch on `IntegrationJobOptions`.
+     */
+    pollFn?: (opts: PollTestmailInboxOptions) => Promise<TestmailMessage>;
+    /**
+     * Called with the freshly allocated testmail inbox; must return the
+     * site-specific dispatch payload with the inbox address embedded.
+     */
+    buildPayload: (job: TJob, inbox: TestmailInbox) => unknown;
+    /**
+     * Override the per-message assertion. Defaults to
+     * `expect(message.subject).toBeTruthy()` — byte-identical to both existing
+     * integration tests.
+     */
+    assertMessage?: (message: TestmailMessage, job: TJob) => void;
+}
+/**
+ * Defines a replay-driven integration suite. Pass a `jobs` array or a
+ * `jobsPath`+`dirname` pair — the file is read and JSON-parsed at suite
+ * definition time. The suite is skipped unless `INTEGRATION=true`.
+ */
+export declare function defineReplayIntegrationSuite<TJob extends object>(source: JobsSource<TJob>, opts: ReplayIntegrationSuiteOptions<TJob>): void;
+export {};
+//# sourceMappingURL=replay-integration-suite.d.ts.map

package/dist/testing/replay-integration-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-integration-suite.d.ts","sourceRoot":"","sources":["../../src/testing/replay-integration-suite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,wBAAwB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIlG,mGAAmG;AACnG,KAAK,UAAU,CAAC,IAAI,IAAI;IAAE,IAAI,EAAE,IAAI,EAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF;;;GAGG;AACH,MAAM,WAAW,6BAA6B,CAAC,IAAI;IACjD,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,wBAAwB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE;;;OAGG;IACH,YAAY,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IAC3D;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,IAAI,KAAK,IAAI,CAAC;CAC/D;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,SAAS,MAAM,EAC9D,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EACxB,IAAI,EAAE,6BAA6B,CAAC,IAAI,CAAC,GACxC,IAAI,CA0BN"}

package/dist/testing/replay-integration-suite.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Eliminates the repeated describe.skipIf / it.each / runIntegrationJob /
+ * message.subject assertion that every replay-based integration test duplicates.
+ * Callers supply only the site-specific plugin, job list, and payload builder;
+ * the generic scaffold (file load, INTEGRATION gate, fan-out, default assertion)
+ * lives here once.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineReplayIntegrationSuite = defineReplayIntegrationSuite;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const vitest_1 = require("vitest");
+const integration_runner_1 = require("../testing/integration-runner");
+const DEFAULT_TIMEOUT_MS = 600_000;
+/**
+ * Defines a replay-driven integration suite. Pass a `jobs` array or a
+ * `jobsPath`+`dirname` pair — the file is read and JSON-parsed at suite
+ * definition time. The suite is skipped unless `INTEGRATION=true`.
+ */
+function defineReplayIntegrationSuite(source, opts) {
+    const { suiteName, plugin, buildPayload, assertMessage, pollFn } = opts;
+    const jobs = "jobs" in source
+        ? source.jobs
+        : JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.resolve)(source.dirname, source.jobsPath), "utf8"));
+    vitest_1.describe.skipIf(process.env.INTEGRATION !== "true")(suiteName, () => {
+        vitest_1.it.each(jobs)(`submits job and receives confirmation email`, {
+            timeout: DEFAULT_TIMEOUT_MS,
+        }, async (job) => {
+            const { message } = await (0, integration_runner_1.runIntegrationJob)({
+                plugin: plugin,
+                baseUrl: job.baseUrl,
+                buildPayload: (inbox) => buildPayload(job, inbox),
+                ...(pollFn ? { pollFn } : {}),
+            });
+            if (assertMessage) {
+                assertMessage(message, job);
+            }
+            else {
+                (0, vitest_1.expect)(message.subject).toBeTruthy();
+            }
+        });
+    });
+}
+//# sourceMappingURL=replay-integration-suite.js.map

package/dist/testing/replay-integration-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-integration-suite.js","sourceRoot":"","sources":["../../src/testing/replay-integration-suite.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAgDH,oEA6BC;AA3ED,qCAAuC;AACvC,yCAAoC;AAEpC,mCAA8C;AAG9C,qEAAiE;AAGjE,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAgCnC;;;;GAIG;AACH,SAAgB,4BAA4B,CAC1C,MAAwB,EACxB,IAAyC;IAEzC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExE,MAAM,IAAI,GACR,MAAM,IAAI,MAAM;QACd,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,IAAA,mBAAO,EAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAY,CAAC;IAE7F,iBAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE;QAClE,WAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,6CAA6C,EAAE;YAC3D,OAAO,EAAE,kBAAkB;SAC5B,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACf,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAA,sCAAiB,EAAC;gBAC1C,MAAM,EAAE,MAAiD;gBACzD,OAAO,EAAG,GAA+B,CAAC,OAAiB;gBAC3D,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC;gBACjD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9B,CAAC,CAAC;YAEH,IAAI,aAAa,EAAE,CAAC;gBAClB,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,IAAA,eAAM,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;YACvC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Resolved resume bytes + the metadata downstream plugins need to attach
+ * the file to a multipart request or a JSON resume blob. Plugins that
+ * accept resume uploads can destructure this shape directly into their
+ * payload fields.
+ */
+export interface TestResume {
+    buffer: Buffer;
+    contentType: "application/pdf";
+    filename: string;
+    base64: string;
+}
+/**
+ * The payload-side field names that every resume-accepting site uses
+ * identically. Extracted so tests can spread this instead of repeating
+ * the four-field mapping verbatim.
+ */
+export interface ResumePayloadFields {
+    Resume: Buffer;
+    ResumeContentType: string;
+    ResumeFilename: string;
+    ResumeBase64: string;
+}
+/**
+ * Read the shared persona PDF once and return its bytes + the per-call
+ * metadata fields the plugins expect. Centralised so the integration tests
+ * never disagree about which resume the test persona is submitting, and so
+ * a future swap to a different PDF is a one-file change instead of a fan-out
+ * across every test.
+ */
+export declare function loadTestResume(): TestResume;
+/**
+ * Maps a `TestResume` to the four payload field names every resume-accepting
+ * site shares (Resume, ResumeContentType, ResumeFilename, ResumeBase64).
+ * Extracted here so tests can spread `resumePayloadFields(resume)` instead
+ * of repeating the same literal mapping at every call site.
+ */
+export declare function resumePayloadFields(resume: TestResume): ResumePayloadFields;
+//# sourceMappingURL=resume-fixture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resume-fixture.d.ts","sourceRoot":"","sources":["../../src/testing/resume-fixture.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAQ3C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,CAO3E"}

package/dist/testing/resume-fixture.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTestResume = loadTestResume;
+exports.resumePayloadFields = resumePayloadFields;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const RESUME_PATH = (0, node_path_1.resolve)(__dirname, "./fixtures/resume.pdf");
+/**
+ * Read the shared persona PDF once and return its bytes + the per-call
+ * metadata fields the plugins expect. Centralised so the integration tests
+ * never disagree about which resume the test persona is submitting, and so
+ * a future swap to a different PDF is a one-file change instead of a fan-out
+ * across every test.
+ */
+function loadTestResume() {
+    const buffer = (0, node_fs_1.readFileSync)(RESUME_PATH);
+    return {
+        buffer,
+        contentType: "application/pdf",
+        filename: "reginald-reconaldo.pdf",
+        base64: buffer.toString("base64"),
+    };
+}
+/**
+ * Maps a `TestResume` to the four payload field names every resume-accepting
+ * site shares (Resume, ResumeContentType, ResumeFilename, ResumeBase64).
+ * Extracted here so tests can spread `resumePayloadFields(resume)` instead
+ * of repeating the same literal mapping at every call site.
+ */
+function resumePayloadFields(resume) {
+    return {
+        Resume: resume.buffer,
+        ResumeContentType: resume.contentType,
+        ResumeFilename: resume.filename,
+        ResumeBase64: resume.base64,
+    };
+}
+//# sourceMappingURL=resume-fixture.js.map

package/dist/testing/resume-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-fixture.js","sourceRoot":"","sources":["../../src/testing/resume-fixture.ts"],"names":[],"mappings":";;AAqCA,wCAQC;AAQD,kDAOC;AA5DD,qCAAuC;AACvC,yCAAoC;AA2BpC,MAAM,WAAW,GAAG,IAAA,mBAAO,EAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,SAAgB,cAAc;IAC5B,MAAM,MAAM,GAAG,IAAA,sBAAY,EAAC,WAAW,CAAC,CAAC;IACzC,OAAO;QACL,MAAM;QACN,WAAW,EAAE,iBAAiB;QAC9B,QAAQ,EAAE,wBAAwB;QAClC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAClC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,MAAkB;IACpD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,iBAAiB,EAAE,MAAM,CAAC,WAAW;QACrC,cAAc,EAAE,MAAM,CAAC,QAAQ;QAC/B,YAAY,EAAE,MAAM,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC"}

package/dist/testmail/client.d.ts

@@ -0,0 +1,61 @@
+/** An address allocated for a single recon run / integration test. */
+export interface TestmailInbox {
+    /** Full address: `{namespace}.{tag}@inbox.testmail.app`. */
+    address: string;
+    /** Tag piece — used as the GraphQL query filter to scope reads to this inbox. */
+    tag: string;
+    /** Allocation timestamp (Unix ms) — passed to the inbox query so we only see emails received AFTER allocation. */
+    timestampFrom: number;
+}
+/**
+ * Single message returned by the inbox query. Shaped to match the GraphQL
+ * response one-to-one so the polling loop doesn't need to remap.
+ */
+export interface TestmailMessage {
+    id: string;
+    from: string;
+    subject: string;
+    text: string | null;
+    html: string | null;
+    /** Unix ms timestamp (per testmail GraphQL `Float`). */
+    date: number;
+}
+export interface AllocateTestmailInboxOptions {
+    /** Override the configured namespace (`TESTMAIL_NAMESPACE`). Mostly useful for tests. */
+    namespace?: string;
+}
+export interface PollTestmailInboxOptions {
+    inbox: TestmailInbox;
+    /** Substring match against `subject` (case-insensitive). Omit to return any new message. */
+    subjectContains?: string;
+    /** Total wait budget in ms. Default 60_000. */
+    timeoutMs?: number;
+    /** Sleep between iterations in ms. Default 2_000. */
+    intervalMs?: number;
+}
+/**
+ * Allocate a fresh testmail.app inbox address. No network call — testmail
+ * uses dynamic subaddressing, so any `{namespace}.{tag}@inbox.testmail.app`
+ * is implicitly valid the moment we generate it. The 8-char random tag
+ * makes collisions vanishingly unlikely without persisting state.
+ *
+ * The returned `timestampFrom` is the allocation moment in Unix ms; the
+ * polling helper filters the inbox query by this so we never see messages
+ * from previous allocations (the namespace is shared across all runs).
+ */
+export declare function allocateTestmailInbox(opts?: AllocateTestmailInboxOptions): TestmailInbox;
+/** Reset the cached client. Useful when tests swap config between cases. */
+export declare function resetTestmailClientForTests(): void;
+/**
+ * Poll the testmail.app inbox until a matching message arrives or the wait
+ * budget runs out. Uses testmail's `livequery: true` for server-side long-
+ * polling (cuts the round-trip count vs. tight client-side polling) but
+ * also wraps in a client-side retry loop so a transient query failure
+ * doesn't fail the whole wait.
+ *
+ * Throws `TestmailTimeoutError` on budget expiry. Throws `TestmailApiError`
+ * when the API returns a non-success `result` field that doesn't recover
+ * across iterations.
+ */
+export declare function pollTestmailInbox(opts: PollTestmailInboxOptions): Promise<TestmailMessage>;
+//# sourceMappingURL=client.d.ts.map

package/dist/testmail/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/testmail/client.ts"],"names":[],"mappings":"AAmDA,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,aAAa,CAAC;IACrB,4FAA4F;IAC5F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,4BAAiC,GAAG,aAAa,CAY5F;AAoCD,4EAA4E;AAC5E,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAoBD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC,CAoFhG"}

package/dist/testmail/client.js

@@ -0,0 +1,190 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allocateTestmailInbox = allocateTestmailInbox;
+exports.resetTestmailClientForTests = resetTestmailClientForTests;
+exports.pollTestmailInbox = pollTestmailInbox;
+const node_crypto_1 = require("node:crypto");
+const bottleneck_1 = __importDefault(require("bottleneck"));
+const v4_1 = require("zod/v4");
+const config_1 = require("../config");
+const logging_1 = require("../lib/logging");
+const graphql_client_1 = require("../scraper/graphql-client");
+const errors_1 = require("../testmail/errors");
+const logger = (0, logging_1.getLogger)({ name: "testmail/client" });
+const TESTMAIL_ENDPOINT = "https://api.testmail.app/api/graphql";
+/**
+ * Sustained per-key rate-limit ceiling per testmail docs (5 rps). Pinning
+ * to 4 rps leaves headroom for the inbox-query loop + any concurrent
+ * callers (e.g. multiple integration tests sharing the namespace).
+ */
+const TESTMAIL_MIN_TIME_MS = 250;
+/** Default total wait budget for `pollTestmailInbox`. Calibrated for typical receipt-email latency (10-30s). */
+const DEFAULT_POLL_TIMEOUT_MS = 60_000;
+/**
+ * Default per-iteration wait between inbox queries. The query itself uses
+ * `livequery: true` which long-polls server-side, so we sleep this much
+ * BETWEEN queries — not as the primary wait mechanism.
+ */
+const DEFAULT_POLL_INTERVAL_MS = 2_000;
+const InboxQueryResponseSchema = v4_1.z.object({
+    data: v4_1.z.object({
+        inbox: v4_1.z.object({
+            result: v4_1.z.string(),
+            message: v4_1.z.string().nullable().optional(),
+            count: v4_1.z.number(),
+            emails: v4_1.z.array(v4_1.z.object({
+                id: v4_1.z.string(),
+                from: v4_1.z.string(),
+                subject: v4_1.z.string(),
+                text: v4_1.z.string().nullable().optional(),
+                html: v4_1.z.string().nullable().optional(),
+                date: v4_1.z.number(),
+            })),
+        }),
+    }),
+});
+/**
+ * Allocate a fresh testmail.app inbox address. No network call — testmail
+ * uses dynamic subaddressing, so any `{namespace}.{tag}@inbox.testmail.app`
+ * is implicitly valid the moment we generate it. The 8-char random tag
+ * makes collisions vanishingly unlikely without persisting state.
+ *
+ * The returned `timestampFrom` is the allocation moment in Unix ms; the
+ * polling helper filters the inbox query by this so we never see messages
+ * from previous allocations (the namespace is shared across all runs).
+ */
+function allocateTestmailInbox(opts = {}) {
+    const namespace = opts.namespace ?? config_1.config.testmail.namespace;
+    if (!namespace) {
+        throw new errors_1.TestmailApiError("TESTMAIL_NAMESPACE required to allocate an inbox; set it in .env or pass via opts.namespace");
+    }
+    const tag = `barnacle-${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+    const address = `${namespace}.${tag}@inbox.testmail.app`;
+    const timestampFrom = Date.now();
+    logger.info(`allocated testmail inbox ${address} (timestampFrom=${timestampFrom})`);
+    return { address, tag, timestampFrom };
+}
+let cachedClient = null;
+function getTestmailClient() {
+    if (cachedClient)
+        return cachedClient;
+    const apiKey = config_1.config.testmail.apiKey;
+    if (!apiKey) {
+        throw new errors_1.TestmailApiError("TESTMAIL_API_KEY required to query testmail.app; set it in .env");
+    }
+    const bottleneck = new bottleneck_1.default({ minTime: TESTMAIL_MIN_TIME_MS });
+    cachedClient = (0, graphql_client_1.createGraphqlClient)({
+        schema: InboxQueryResponseSchema,
+        bottleneck,
+        baseHeaders: {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            Authorization: `Bearer ${apiKey}`,
+        },
+        endpoint: TESTMAIL_ENDPOINT,
+    });
+    return cachedClient;
+}
+/** Reset the cached client. Useful when tests swap config between cases. */
+function resetTestmailClientForTests() {
+    cachedClient = null;
+}
+const INBOX_QUERY = `
+  query Inbox($namespace: String!, $tag: String, $timestampFrom: Float, $livequery: Boolean) {
+    inbox(namespace: $namespace, tag: $tag, timestamp_from: $timestampFrom, livequery: $livequery) {
+      result
+      message
+      count
+      emails {
+        id
+        from
+        subject
+        text
+        html
+        date
+      }
+    }
+  }
+`;
+/**
+ * Poll the testmail.app inbox until a matching message arrives or the wait
+ * budget runs out. Uses testmail's `livequery: true` for server-side long-
+ * polling (cuts the round-trip count vs. tight client-side polling) but
+ * also wraps in a client-side retry loop so a transient query failure
+ * doesn't fail the whole wait.
+ *
+ * Throws `TestmailTimeoutError` on budget expiry. Throws `TestmailApiError`
+ * when the API returns a non-success `result` field that doesn't recover
+ * across iterations.
+ */
+async function pollTestmailInbox(opts) {
+    const { inbox, subjectContains, timeoutMs = DEFAULT_POLL_TIMEOUT_MS, intervalMs = DEFAULT_POLL_INTERVAL_MS, } = opts;
+    const namespace = config_1.config.testmail.namespace;
+    if (!namespace) {
+        throw new errors_1.TestmailApiError("TESTMAIL_NAMESPACE required to poll an inbox; set it in .env");
+    }
+    const client = getTestmailClient();
+    const deadline = Date.now() + timeoutMs;
+    const subjectNeedle = subjectContains?.toLowerCase();
+    let lastApiError = null;
+    while (Date.now() < deadline) {
+        let response;
+        try {
+            // Bound the underlying fetch on the remaining deadline. testmail's
+            // `livequery: true` long-polls server-side (the server holds the
+            // connection open for ~15 min waiting for new mail), and Node's
+            // built-in fetch has no default timeout — without this signal a
+            // single query outlasts the caller's poll budget by many minutes.
+            const remaining = deadline - Date.now();
+            response = (await client("Inbox", INBOX_QUERY, {
+                namespace,
+                tag: inbox.tag,
+                timestampFrom: inbox.timestampFrom,
+                livequery: true,
+            }, { signal: AbortSignal.timeout(remaining) }));
+        }
+        catch (err) {
+            // Transient API failure — sleep + try again until deadline. Hold the
+            // last error so a budget expiry can report something useful.
+            lastApiError = new errors_1.TestmailApiError(`inbox query failed: ${err instanceof Error ? err.message : String(err)}`);
+            logger.warn(`testmail inbox query failed; retrying: ${lastApiError.message}`);
+            await sleep(Math.min(intervalMs, deadline - Date.now()));
+            continue;
+        }
+        const inboxData = response.data.inbox;
+        if (inboxData.result !== "success") {
+            lastApiError = new errors_1.TestmailApiError(`inbox query returned result=${inboxData.result} message=${inboxData.message ?? "<null>"}`);
+            logger.warn(`testmail inbox non-success result: ${lastApiError.message}`);
+            await sleep(Math.min(intervalMs, deadline - Date.now()));
+            continue;
+        }
+        const matching = inboxData.emails.find((email) => {
+            if (!subjectNeedle)
+                return true;
+            return email.subject.toLowerCase().includes(subjectNeedle);
+        });
+        if (matching) {
+            logger.info(`testmail inbox ${inbox.address} received matching message (subject="${matching.subject}", id=${matching.id})`);
+            return {
+                id: matching.id,
+                from: matching.from,
+                subject: matching.subject,
+                text: matching.text ?? null,
+                html: matching.html ?? null,
+                date: matching.date,
+            };
+        }
+        await sleep(Math.min(intervalMs, deadline - Date.now()));
+    }
+    const reason = lastApiError ? ` (last API error: ${lastApiError.message})` : "";
+    throw new errors_1.TestmailTimeoutError(`testmail inbox ${inbox.address} did not receive ${subjectContains ? `a message with subject containing "${subjectContains}"` : "any message"} within ${timeoutMs}ms${reason}`);
+}
+function sleep(ms) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=client.js.map

package/dist/testmail/client.js.map

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

package/dist/testmail/errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * No message matching the inbox filter arrived before the wait budget
+ * elapsed. Callers usually want to either widen the timeout or treat this
+ * as a real failure (the site didn't send the confirmation email).
+ */
+export declare class TestmailTimeoutError extends Error {
+    constructor(message: string);
+}
+/**
+ * The testmail.app GraphQL API returned a non-success `result` field or an
+ * HTTP error that the underlying HTTP client surfaced. Distinct from
+ * timeout so call-sites can decide whether to retry (rate limit, transient
+ * 5xx) or fail loud (bad API key, missing namespace).
+ */
+export declare class TestmailApiError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/testmail/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/testmail/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/testmail/errors.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestmailApiError = exports.TestmailTimeoutError = void 0;
+/**
+ * No message matching the inbox filter arrived before the wait budget
+ * elapsed. Callers usually want to either widen the timeout or treat this
+ * as a real failure (the site didn't send the confirmation email).
+ */
+class TestmailTimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+exports.TestmailTimeoutError = TestmailTimeoutError;
+/**
+ * The testmail.app GraphQL API returned a non-success `result` field or an
+ * HTTP error that the underlying HTTP client surfaced. Distinct from
+ * timeout so call-sites can decide whether to retry (rate limit, transient
+ * 5xx) or fail loud (bad API key, missing namespace).
+ */
+class TestmailApiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+exports.TestmailApiError = TestmailApiError;
+//# sourceMappingURL=errors.js.map

package/dist/testmail/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/testmail/errors.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AALD,oDAKC;AAED;;;;;GAKG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AALD,4CAKC"}

package/dist/types/dispatch-metrics.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Structured metrics payload attached to dispatch responses so Vivian can
+ * forward step-level detail into Segment events for A/B warehouse analysis.
+ */
+import { z } from "zod/v4";
+export interface DispatchStepMetric {
+    step: string;
+    durationMs: number;
+    status: "success" | "failed" | "skipped";
+    error?: string;
+}
+export interface DispatchMetrics {
+    totalDurationMs: number;
+    path: "http" | "browser";
+    steps: DispatchStepMetric[];
+    errorType?: string;
+    errorStep?: string;
+    attemptCount: number;
+    startedAt: string;
+    endedAt: string;
+    recordedAt: string;
+}
+export declare const DispatchMetricsSchema: z.ZodObject<{
+    totalDurationMs: z.ZodNumber;
+    path: z.ZodEnum<{
+        http: "http";
+        browser: "browser";
+    }>;
+    steps: z.ZodArray<z.ZodObject<{
+        step: z.ZodString;
+        durationMs: z.ZodNumber;
+        status: z.ZodEnum<{
+            success: "success";
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    errorType: z.ZodOptional<z.ZodString>;
+    errorStep: z.ZodOptional<z.ZodString>;
+    attemptCount: z.ZodNumber;
+    startedAt: z.ZodString;
+    endedAt: z.ZodString;
+    recordedAt: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=dispatch-metrics.d.ts.map

package/dist/types/dispatch-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-metrics.d.ts","sourceRoot":"","sources":["../../src/types/dispatch-metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;iBAiBhC,CAAC"}