@enricai/barnacle 1.6.9 → 1.6.11

package/dist/lib/telemetry/submission-query.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Predicate composition over `ReconciliationRow[]` (feat-007's reader
+ * output), so a caller can ask reconciliation-shaped questions — rows for a
+ * given `siteId` cohort, `requestId`, submit outcome, beacon status, or date
+ * window — without re-parsing the submissions NDJSON. Pure and I/O-free: the
+ * route layer composes `readDurableReconciliationRows`
+ * (`src/lib/telemetry/reconciliation-source.ts`) then this module.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryReconciliationRows = queryReconciliationRows;
+const date_fns_1 = require("date-fns");
+/**
+ * Builds the AND-composed predicate list for the filter fields actually
+ * present, so an absent field never excludes a row. `from`/`to` are
+ * inclusive bounds expressed via `isBefore`/`isAfter` negation rather than
+ * `isWithinInterval`, since either bound may be supplied without the other.
+ */
+function buildPredicates(filter) {
+    const { siteId, requestId, status, beaconStatus, from, to } = filter;
+    return [
+        siteId === undefined ? null : (row) => row.siteId === siteId,
+        requestId === undefined ? null : (row) => row.requestId === requestId,
+        status === undefined ? null : (row) => row.status === status,
+        beaconStatus === undefined
+            ? null
+            : (row) => row.beaconStatus === beaconStatus,
+        from === undefined
+            ? null
+            : (row) => !(0, date_fns_1.isBefore)((0, date_fns_1.parseISO)(row.ts), (0, date_fns_1.parseISO)(from)),
+        to === undefined ? null : (row) => !(0, date_fns_1.isAfter)((0, date_fns_1.parseISO)(row.ts), (0, date_fns_1.parseISO)(to)),
+    ].filter((predicate) => predicate !== null);
+}
+/**
+ * Filters, sorts (newest-first by `ts`), and paginates reconciliation rows
+ * so the attribution-report join a human pulls in pages is deterministic
+ * rather than relying on the sink's append order.
+ */
+function queryReconciliationRows(rows, filter = {}) {
+    const predicates = buildPredicates(filter);
+    const matched = predicates.length === 0
+        ? rows
+        : rows.filter((row) => predicates.every((predicate) => predicate(row)));
+    const sorted = [...matched].sort((a, b) => (0, date_fns_1.compareDesc)((0, date_fns_1.parseISO)(a.ts), (0, date_fns_1.parseISO)(b.ts)));
+    const offset = filter.offset ?? 0;
+    const limit = filter.limit ?? sorted.length;
+    return sorted.slice(offset, offset + limit);
+}
+//# sourceMappingURL=submission-query.js.map

package/dist/lib/telemetry/submission-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submission-query.js","sourceRoot":"","sources":["../../../src/lib/telemetry/submission-query.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,uCAAoE;AAuBpE;;;;;GAKG;AACH,SAAS,eAAe,CAAC,MAA+B;IACtD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;IAErE,OAAO;QACL,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAsB,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;QAC/E,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAsB,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS;QACxF,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAsB,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;QAC/E,YAAY,KAAK,SAAS;YACxB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,GAAsB,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,YAAY;QACjE,IAAI,KAAK,SAAS;YAChB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,GAAsB,EAAE,EAAE,CAAC,CAAC,IAAA,mBAAQ,EAAC,IAAA,mBAAQ,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAA,mBAAQ,EAAC,IAAI,CAAC,CAAC;QAC3E,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAsB,EAAE,EAAE,CAAC,CAAC,IAAA,kBAAO,EAAC,IAAA,mBAAQ,EAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAA,mBAAQ,EAAC,EAAE,CAAC,CAAC;KAC/F,CAAC,MAAM,CAAC,CAAC,SAAS,EAA2C,EAAE,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;AACvF,CAAC;AAED;;;;GAIG;AACH,iCACE,IAAyB,EACzB,MAAM,GAA4B,EAAE;IAEpC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GACX,UAAU,CAAC,MAAM,KAAK,CAAC;QACrB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAA,sBAAW,EAAC,IAAA,mBAAQ,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAA,mBAAQ,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAExF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC;IAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/dist/lib/telemetry/submission-reader.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Read path for the submissions sink: parses `.barnacle/submissions.ndjson`
+ * into typed reconciliation records and folds each `beacon` event onto its
+ * `submit` record by `requestId`, so one row per run answers both "did we
+ * submit" and "did the beacon fire" without a separate database (see
+ * feat-002's `reconciliation-record.ts` for the record shapes this reads).
+ *
+ * The sink is `appendFile` with no locking (`submission-capture.ts`), so a
+ * torn final line is expected on a live process — malformed lines are
+ * skipped with a warning rather than aborting the whole read.
+ */
+import { type BeaconEvent, type ReconciliationRecord, type SubmitRecord } from "../../lib/telemetry/reconciliation-record";
+/**
+ * One reconciliation row per run: the submit record's fields plus the
+ * outcome of its beacon fire, distinct from submit status so "submitted but
+ * the beacon did not fire" is measurable. `beaconStatus` defaults to
+ * `"not_fired"` when no matching beacon line ever arrived.
+ */
+export interface ReconciliationRow extends Omit<SubmitRecord, "kind"> {
+    beaconStatus: BeaconEvent["beaconStatus"] | "not_fired";
+    beaconTrackingUrl: string | null;
+    beaconTs: string | null;
+    beaconDurationMs: number | null;
+}
+/** Options for `readReconciliationRows`. */
+export interface ReadReconciliationRowsOptions {
+    /** Override the sink path; used in tests to avoid touching the real file. */
+    sinkPath?: string;
+}
+/**
+ * Parses NDJSON sink content into typed reconciliation records. Every line
+ * shape the sink has ever written (unkinded legacy submit lines, kinded
+ * submit lines, beacon lines) is tolerated; a line that is invalid JSON or
+ * fails schema validation is skipped with a warning, not fatal to the read.
+ */
+export declare function parseReconciliationLines(ndjsonContent: string): ReconciliationRecord[];
+/**
+ * Left-joins beacon events onto submit records by `requestId`. Submit rows
+ * are the base — a beacon may arrive strictly after its submit line (or
+ * never), so an orphan beacon with no matching submit row is dropped rather
+ * than synthesizing a phantom row. A later duplicate line (retry) overwrites
+ * an earlier one for the same `requestId` and kind.
+ */
+export declare function foldReconciliationRecords(records: ReconciliationRecord[]): ReconciliationRow[];
+/**
+ * Reads the submissions sink and folds it into one reconciliation row per
+ * run, so a plugin can join runs to its own attribution provider's report
+ * without re-parsing raw NDJSON. A missing sink file (nothing submitted yet)
+ * yields an empty array rather than throwing.
+ */
+export declare function readReconciliationRows(opts?: ReadReconciliationRowsOptions): Promise<ReconciliationRow[]>;
+//# sourceMappingURL=submission-reader.d.ts.map

package/dist/lib/telemetry/submission-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submission-reader.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/submission-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EAEzB,KAAK,YAAY,EAClB,MAAM,uCAAuC,CAAC;AAI/C;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IACnE,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC;IACxD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,4CAA4C;AAC5C,MAAM,WAAW,6BAA6B;IAC5C,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAcD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,EAAE,CA2BtF;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,iBAAiB,EAAE,CA6B9F;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,GAAE,6BAAkC,GACvC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAM9B"}

package/dist/lib/telemetry/submission-reader.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Read path for the submissions sink: parses `.barnacle/submissions.ndjson`
+ * into typed reconciliation records and folds each `beacon` event onto its
+ * `submit` record by `requestId`, so one row per run answers both "did we
+ * submit" and "did the beacon fire" without a separate database (see
+ * feat-002's `reconciliation-record.ts` for the record shapes this reads).
+ *
+ * The sink is `appendFile` with no locking (`submission-capture.ts`), so a
+ * torn final line is expected on a live process — malformed lines are
+ * skipped with a warning rather than aborting the whole read.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseReconciliationLines = parseReconciliationLines;
+exports.foldReconciliationRecords = foldReconciliationRecords;
+exports.readReconciliationRows = readReconciliationRows;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const config_1 = require("../../config");
+const logging_1 = require("../../lib/logging");
+const reconciliation_record_1 = require("../../lib/telemetry/reconciliation-record");
+const logger = (0, logging_1.getLogger)({ name: "telemetry/submission-reader" });
+/**
+ * Parses raw JSON, returning `undefined` on failure instead of throwing, so
+ * the line-by-line reader can skip a torn/malformed line without aborting.
+ */
+function tryParseJson(line) {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Parses NDJSON sink content into typed reconciliation records. Every line
+ * shape the sink has ever written (unkinded legacy submit lines, kinded
+ * submit lines, beacon lines) is tolerated; a line that is invalid JSON or
+ * fails schema validation is skipped with a warning, not fatal to the read.
+ */
+function parseReconciliationLines(ndjsonContent) {
+    const records = [];
+    for (const rawLine of ndjsonContent.split("\n")) {
+        const line = rawLine.trim();
+        if (line.length === 0)
+            continue;
+        const parsed = tryParseJson(line);
+        if (parsed === undefined) {
+            logger.warn(`skipping malformed submissions ndjson line (invalid JSON): ${line.slice(0, 200)}`);
+            continue;
+        }
+        const result = reconciliation_record_1.reconciliationRecordSchema.safeParse(parsed);
+        if (!result.success) {
+            logger.warn(`skipping malformed submissions ndjson line (schema mismatch): ${line.slice(0, 200)}`);
+            continue;
+        }
+        records.push(result.data);
+    }
+    return records;
+}
+/**
+ * Left-joins beacon events onto submit records by `requestId`. Submit rows
+ * are the base — a beacon may arrive strictly after its submit line (or
+ * never), so an orphan beacon with no matching submit row is dropped rather
+ * than synthesizing a phantom row. A later duplicate line (retry) overwrites
+ * an earlier one for the same `requestId` and kind.
+ */
+function foldReconciliationRecords(records) {
+    const rows = new Map();
+    for (const record of records) {
+        if (record.kind !== "submit")
+            continue;
+        const { kind: _kind, ...submitFields } = record;
+        rows.set(record.requestId, {
+            ...submitFields,
+            beaconStatus: "not_fired",
+            beaconTrackingUrl: null,
+            beaconTs: null,
+            beaconDurationMs: null,
+        });
+    }
+    for (const record of records) {
+        if (record.kind !== "beacon")
+            continue;
+        const row = rows.get(record.requestId);
+        if (row === undefined)
+            continue;
+        rows.set(record.requestId, {
+            ...row,
+            beaconStatus: record.beaconStatus,
+            beaconTrackingUrl: record.trackingUrl,
+            beaconTs: record.ts,
+            beaconDurationMs: record.durationMs,
+        });
+    }
+    return Array.from(rows.values());
+}
+/**
+ * Reads the submissions sink and folds it into one reconciliation row per
+ * run, so a plugin can join runs to its own attribution provider's report
+ * without re-parsing raw NDJSON. A missing sink file (nothing submitted yet)
+ * yields an empty array rather than throwing.
+ */
+async function readReconciliationRows(opts = {}) {
+    const sinkPath = opts.sinkPath ?? config_1.config.telemetry.submissionsNdjsonPath;
+    if (!(0, node_fs_1.existsSync)(sinkPath))
+        return [];
+    const content = await (0, promises_1.readFile)(sinkPath, "utf8");
+    return foldReconciliationRecords(parseReconciliationLines(content));
+}
+//# sourceMappingURL=submission-reader.js.map

package/dist/lib/telemetry/submission-reader.js.map

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

package/dist/lib/telemetry/submissions-s3-objects.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Object-discovery half of the durable S3 read path: enumerates the
+ * `<prefix>/submissions/<YYYY-MM-DD>/` keys that could contain rows for a
+ * requested `from`/`to` window, so the fetch stage (feat-003) never has to
+ * scan the whole telemetry bucket. Entirely inert (no `S3Client`
+ * construction, no network calls) when `config.telemetry.s3.bucket` is
+ * unset — mirrors `s3-sink.ts`'s inertness contract.
+ */
+/** Filter window for `listSubmissionsS3Objects`. Both bounds are ISO datetime strings. */
+export interface ListSubmissionsS3ObjectsOptions {
+    from?: string;
+    to?: string;
+}
+/**
+ * Enumerates the S3 object keys that could contain submissions rows for the
+ * requested `from`/`to` window. Returns `[]` without constructing an
+ * `S3Client` when no bucket is configured. The result is capped at
+ * `config.telemetry.s3.readMaxObjects` — logged with a warning when the cap
+ * actually truncated the listing — so a query spanning months of shipped
+ * NDJSON can't fan out unbounded S3 calls in the fetch stage that follows.
+ */
+export declare function listSubmissionsS3Objects(opts?: ListSubmissionsS3ObjectsOptions): Promise<string[]>;
+//# sourceMappingURL=submissions-s3-objects.d.ts.map

package/dist/lib/telemetry/submissions-s3-objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submissions-s3-objects.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/submissions-s3-objects.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+BH,0FAA0F;AAC1F,MAAM,WAAW,+BAA+B;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAkFD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,GAAE,+BAAoC,GACzC,OAAO,CAAC,MAAM,EAAE,CAAC,CAgCnB"}

package/dist/lib/telemetry/submissions-s3-objects.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * Object-discovery half of the durable S3 read path: enumerates the
+ * `<prefix>/submissions/<YYYY-MM-DD>/` keys that could contain rows for a
+ * requested `from`/`to` window, so the fetch stage (feat-003) never has to
+ * scan the whole telemetry bucket. Entirely inert (no `S3Client`
+ * construction, no network calls) when `config.telemetry.s3.bucket` is
+ * unset — mirrors `s3-sink.ts`'s inertness contract.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listSubmissionsS3Objects = listSubmissionsS3Objects;
+const client_s3_1 = require("@aws-sdk/client-s3");
+const date_fns_1 = require("date-fns");
+const config_1 = require("../../config");
+const logging_1 = require("../../lib/logging");
+const logger = (0, logging_1.getLogger)({ name: "telemetry/submissions-s3-objects" });
+const SUBMISSIONS_DIR = "submissions";
+const MS_PER_DAY = 86_400_000;
+/**
+ * Bound on how far back an open-ended window reaches. Matches
+ * `TELEMETRY_MAX_RETENTION_MS`'s existing 30-day default so a query that
+ * omits `from` can't be asked to enumerate the bucket's entire history.
+ */
+const DEFAULT_WINDOW_DAYS = 30;
+let client;
+/** Lazily constructs the S3 client. Never called on the bucket-unset path. */
+function getClient() {
+    if (!client) {
+        client = new client_s3_1.S3Client({ region: config_1.config.bedrock.region });
+    }
+    return client;
+}
+/**
+ * Resolves the inclusive `from`/`to` `Date` bounds used for day-prefix
+ * enumeration. `to` defaults to `now` (submissions can't exist in the
+ * future); `from` defaults to `DEFAULT_WINDOW_DAYS` before `to` so an
+ * unbounded query is still capped.
+ */
+function resolveWindow(opts, now) {
+    const to = opts.to ? (0, date_fns_1.parseISO)(opts.to) : now;
+    const from = opts.from ? (0, date_fns_1.parseISO)(opts.from) : (0, date_fns_1.subDays)(to, DEFAULT_WINDOW_DAYS);
+    return { from, to };
+}
+/** UTC midnight (epoch ms) of the calendar day containing `d`. */
+function utcDayStart(d) {
+    return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
+}
+/**
+ * Builds the day-partition prefixes to scan, widened by one day on each
+ * side of the requested window. Day boundaries and prefix dates are computed
+ * in UTC (matching `s3-sink.ts`'s `buildObjectKey`) so enumeration is
+ * timezone-independent — a reader and writer in different zones agree on
+ * partition names. The widening covers runs whose `ts` falls near a day
+ * boundary and thus land in an adjacent day's partition; the row-level
+ * `from`/`to` predicate in `submission-query.ts` does the exact filtering,
+ * so this only needs to not miss a partition.
+ */
+function dayPrefixes(from, to, prefix) {
+    const start = utcDayStart(from) - MS_PER_DAY;
+    const end = utcDayStart(to) + MS_PER_DAY;
+    const prefixes = [];
+    for (let t = start; t <= end; t += MS_PER_DAY) {
+        const day = new Date(t).toISOString().slice(0, 10);
+        prefixes.push(`${prefix}/${SUBMISSIONS_DIR}/${day}/`);
+    }
+    return prefixes;
+}
+/**
+ * Lists every object key under one day-partition prefix, following
+ * `NextContinuationToken` to exhaustion, stopping early once `budget` keys
+ * have been collected. `truncated` distinguishes "budget exhausted mid-list"
+ * from "listing finished naturally," so the caller only warns when the cap
+ * actually dropped objects.
+ */
+async function listPrefixKeys(bucket, prefix, budget) {
+    if (budget <= 0)
+        return { keys: [], truncated: true };
+    const keys = [];
+    let continuationToken;
+    do {
+        const response = await getClient().send(new client_s3_1.ListObjectsV2Command({
+            Bucket: bucket,
+            Prefix: prefix,
+            ContinuationToken: continuationToken,
+        }));
+        for (const object of response.Contents ?? []) {
+            if (object.Key === undefined)
+                continue;
+            if (keys.length >= budget)
+                return { keys, truncated: true };
+            keys.push(object.Key);
+        }
+        continuationToken = response.NextContinuationToken;
+    } while (continuationToken !== undefined);
+    return { keys, truncated: false };
+}
+/**
+ * Enumerates the S3 object keys that could contain submissions rows for the
+ * requested `from`/`to` window. Returns `[]` without constructing an
+ * `S3Client` when no bucket is configured. The result is capped at
+ * `config.telemetry.s3.readMaxObjects` — logged with a warning when the cap
+ * actually truncated the listing — so a query spanning months of shipped
+ * NDJSON can't fan out unbounded S3 calls in the fetch stage that follows.
+ */
+async function listSubmissionsS3Objects(opts = {}) {
+    const bucket = config_1.config.telemetry.s3.bucket;
+    if (!bucket)
+        return [];
+    const { from, to } = resolveWindow(opts, new Date());
+    const prefixes = dayPrefixes(from, to, config_1.config.telemetry.s3.prefix);
+    const maxObjects = config_1.config.telemetry.s3.readMaxObjects;
+    const keys = [];
+    let truncated = false;
+    for (const prefix of prefixes) {
+        const budget = maxObjects - keys.length;
+        if (budget <= 0) {
+            truncated = true;
+            break;
+        }
+        const result = await listPrefixKeys(bucket, prefix, budget);
+        keys.push(...result.keys);
+        if (result.truncated) {
+            truncated = true;
+            break;
+        }
+    }
+    if (truncated) {
+        logger.warn(`submissions-s3-objects: key listing capped at readMaxObjects=${maxObjects}; some objects in the requested window were not returned`);
+    }
+    return keys;
+}
+//# sourceMappingURL=submissions-s3-objects.js.map

package/dist/lib/telemetry/submissions-s3-objects.js.map

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

package/dist/lib/telemetry/submissions-s3-reader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Fetch half of the durable S3 read path: pulls the NDJSON objects named by
+ * an already-supplied key list (`submissions-s3-objects.ts`'s
+ * `listSubmissionsS3Objects`) with bounded concurrency and parses each body
+ * into `ReconciliationRecord[]` via `submission-reader.ts`'s
+ * `parseReconciliationLines`, so telemetry that only survives in S3 (ECS
+ * containers are ephemeral and per-task) becomes readable. Folding beacon
+ * lines onto submit records and merging with the local sink live elsewhere.
+ *
+ * Mirrors `s3-sink.ts`'s inertness contract: no `S3Client` construction, no
+ * network calls, when `config.telemetry.s3.bucket` is unset.
+ */
+import type { ReconciliationRecord } from "../../lib/telemetry/reconciliation-record";
+/**
+ * Fetches every listed S3 object and parses its NDJSON body into
+ * reconciliation records. Objects are fetched through a `p-queue` bounded by
+ * `config.telemetry.s3.readConcurrency` — no hand-rolled promise pooling per
+ * CLAUDE.md's battle-tested-libraries rule. A single object's `GetObject`
+ * failure is logged and skipped rather than aborting the read, matching the
+ * swallow-and-log posture the rest of `src/lib/telemetry` uses: a read
+ * failure should degrade the answer, never 500 the route. Returns `[]`
+ * without constructing an `S3Client` when no bucket is configured.
+ */
+export declare function fetchSubmissionsS3Records(keys: string[]): Promise<ReconciliationRecord[]>;
+//# sourceMappingURL=submissions-s3-reader.d.ts.map

package/dist/lib/telemetry/submissions-s3-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submissions-s3-reader.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/submissions-s3-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAsBlF;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAmB/F"}

package/dist/lib/telemetry/submissions-s3-reader.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Fetch half of the durable S3 read path: pulls the NDJSON objects named by
+ * an already-supplied key list (`submissions-s3-objects.ts`'s
+ * `listSubmissionsS3Objects`) with bounded concurrency and parses each body
+ * into `ReconciliationRecord[]` via `submission-reader.ts`'s
+ * `parseReconciliationLines`, so telemetry that only survives in S3 (ECS
+ * containers are ephemeral and per-task) becomes readable. Folding beacon
+ * lines onto submit records and merging with the local sink live elsewhere.
+ *
+ * Mirrors `s3-sink.ts`'s inertness contract: no `S3Client` construction, no
+ * network calls, when `config.telemetry.s3.bucket` is unset.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchSubmissionsS3Records = fetchSubmissionsS3Records;
+const client_s3_1 = require("@aws-sdk/client-s3");
+const p_queue_1 = __importDefault(require("p-queue"));
+const config_1 = require("../../config");
+const errors_1 = require("../../lib/errors");
+const logging_1 = require("../../lib/logging");
+const submission_reader_1 = require("../../lib/telemetry/submission-reader");
+const logger = (0, logging_1.getLogger)({ name: "telemetry/submissions-s3-reader" });
+let client;
+/** Lazily constructs the S3 client. Never called on the bucket-unset path. */
+function getClient() {
+    if (!client) {
+        client = new client_s3_1.S3Client({ region: config_1.config.bedrock.region });
+    }
+    return client;
+}
+/** Fetches and parses one object's body. Empty body yields no records rather than throwing. */
+async function fetchObjectRecords(bucket, key) {
+    const response = await getClient().send(new client_s3_1.GetObjectCommand({ Bucket: bucket, Key: key }));
+    const body = await response.Body?.transformToString();
+    return body ? (0, submission_reader_1.parseReconciliationLines)(body) : [];
+}
+/**
+ * Fetches every listed S3 object and parses its NDJSON body into
+ * reconciliation records. Objects are fetched through a `p-queue` bounded by
+ * `config.telemetry.s3.readConcurrency` — no hand-rolled promise pooling per
+ * CLAUDE.md's battle-tested-libraries rule. A single object's `GetObject`
+ * failure is logged and skipped rather than aborting the read, matching the
+ * swallow-and-log posture the rest of `src/lib/telemetry` uses: a read
+ * failure should degrade the answer, never 500 the route. Returns `[]`
+ * without constructing an `S3Client` when no bucket is configured.
+ */
+async function fetchSubmissionsS3Records(keys) {
+    const bucket = config_1.config.telemetry.s3.bucket;
+    if (!bucket)
+        return [];
+    const queue = new p_queue_1.default({ concurrency: config_1.config.telemetry.s3.readConcurrency });
+    const results = await Promise.all(keys.map((key) => queue
+        .add(() => fetchObjectRecords(bucket, key))
+        .catch((err) => {
+        logger.warn(`submissions-s3-reader: fetch of ${key} failed, skipping: ${(0, errors_1.toErrorMessage)(err)}`);
+        return undefined;
+    })));
+    return results.flatMap((records) => records ?? []);
+}
+//# sourceMappingURL=submissions-s3-reader.js.map

package/dist/lib/telemetry/submissions-s3-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submissions-s3-reader.js","sourceRoot":"","sources":["../../../src/lib/telemetry/submissions-s3-reader.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;AAEH,kDAAgE;AAChE,sDAA6B;AAE7B,qCAAkC;AAClC,yCAA8C;AAC9C,2CAA0C;AAE1C,yEAA6E;AAE7E,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC;AAEtE,IAAI,MAA4B,CAAC;AAEjC,8EAA8E;AAC9E,SAAS,SAAS;IAChB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,IAAI,oBAAQ,CAAC,EAAE,MAAM,EAAE,eAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+FAA+F;AAC/F,KAAK,UAAU,kBAAkB,CAAC,MAAc,EAAE,GAAW;IAC3D,MAAM,QAAQ,GAAG,MAAM,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,4BAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAC;IACtD,OAAO,IAAI,CAAC,CAAC,CAAC,IAAA,4CAAwB,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC;AAED;;;;;;;;;GASG;AACI,KAAK,oCAAoC,IAAc;IAC5D,MAAM,MAAM,GAAG,eAAM,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,MAAM,KAAK,GAAG,IAAI,iBAAM,CAAC,EAAE,WAAW,EAAE,eAAM,CAAC,SAAS,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACf,KAAK;SACF,GAAG,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SAC1C,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,CAAC,IAAI,CACT,mCAAmC,GAAG,sBAAsB,IAAA,uBAAc,EAAC,GAAG,CAAC,EAAE,CAClF,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CACL,CACF,CAAC;IAEF,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/lib/tracking-click.d.ts

@@ -9,11 +9,22 @@
  * No CDP behavioral signals are needed; those are only required when extracting
  * DataDome tokens for subsequent Node HTTP requests.
  */
+/**
+ * The run's opaque reconciliation join keys, threaded through so a
+ * beacon-fire outcome can be correlated back to its submit record. Optional
+ * so existing `fireTrackingClick` call sites keep compiling unchanged.
+ */
+export interface TrackingClickReconciliationContext {
+    requestId: string;
+    joinKeys: Record<string, unknown> | null;
+}
 /**
  * Launches a background tracking click. Returns immediately — the caller
- * does not await the result. Errors never propagate.
+ * does not await the result. Errors never propagate. `reconciliation` is
+ * optional so a fired/failed beacon outcome can be correlated to the run
+ * when the caller has resolved join keys; omit it to keep today's behavior.
  */
-export declare function fireTrackingClick(trackingUrl: string, siteId: string): void;
+export declare function fireTrackingClick(trackingUrl: string, siteId: string, reconciliation?: TrackingClickReconciliationContext): void;
 /**
  * Awaits all in-flight tracking clicks, used during graceful shutdown to
  * prevent Browserbase session leaks on SIGTERM.

package/dist/lib/tracking-click.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracking-click.d.ts","sourceRoot":"","sources":["../../src/lib/tracking-click.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA0DH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAK3E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E"}
+{"version":3,"file":"tracking-click.d.ts","sourceRoot":"","sources":["../../src/lib/tracking-click.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH;;;;GAIG;AACH,MAAM,WAAW,kCAAkC;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAiFD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,kCAAkC,GAClD,IAAI,CAKN;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E"}

package/dist/lib/tracking-click.js

@@ -16,18 +16,34 @@ exports.drainTrackingClicks = drainTrackingClicks;
 const dd_metrics_1 = require("../lib/dd-metrics");
 const errors_1 = require("../lib/errors");
 const logging_1 = require("../lib/logging");
+const beacon_capture_1 = require("../lib/telemetry/beacon-capture");
 const session_browserbase_1 = require("../scraper/session-browserbase");
 const logger = (0, logging_1.getLogger)({ name: "tracking-click" });
 const NAVIGATE_TIMEOUT_MS = 30_000;
 const SETTLE_WAIT_MS = 5_000;
 const BROWSERBASE_SESSION_TIMEOUT_SECONDS = 300;
 const inFlightClicks = new Set();
+/**
+ * Wraps `captureBeaconEvent` so a throwing/rejecting capture sink can never
+ * propagate into the tracking-click fire-and-forget path — the same defense
+ * `emitEnvelopeSafely` applies around `captureSubmissionEnvelope` in
+ * loader.ts, since `captureBeaconEvent`'s own internal swallow can be
+ * bypassed by a test double or an unexpected synchronous throw.
+ */
+async function captureBeaconOutcomeSafely(input) {
+    try {
+        await (0, beacon_capture_1.captureBeaconEvent)(input);
+    }
+    catch (err) {
+        logger.warn(`beacon outcome capture failed: ${(0, errors_1.toErrorMessage)(err)}`);
+    }
+}
 /**
  * Navigates a Browserbase session to the tracking URL. Errors are logged
  * and swallowed — the apply already succeeded, so a failed tracking click
  * is a monitoring concern, not a runtime failure.
  */
-async function executeTrackingClick(trackingUrl, siteId) {
+async function executeTrackingClick(trackingUrl, siteId, reconciliation) {
     const startedAt = Date.now();
     (0, dd_metrics_1.recordTrackingClickAttempt)(siteId);
     let session;
@@ -41,10 +57,30 @@ async function executeTrackingClick(trackingUrl, siteId) {
         await page.waitForTimeout(SETTLE_WAIT_MS);
         (0, dd_metrics_1.recordTrackingClickSuccess)(siteId);
         logger.info(`tracking click success site=${siteId} url=${trackingUrl.slice(0, 120)} durationMs=${Date.now() - startedAt}`);
+        if (reconciliation) {
+            await captureBeaconOutcomeSafely({
+                requestId: reconciliation.requestId,
+                siteId,
+                joinKeys: reconciliation.joinKeys,
+                beaconStatus: "fired",
+                trackingUrl,
+                durationMs: Date.now() - startedAt,
+            });
+        }
     }
     catch (err) {
         (0, dd_metrics_1.recordTrackingClickFailure)(siteId, err instanceof Error ? err.constructor.name : "unknown");
         logger.warn(`tracking click failed site=${siteId} url=${trackingUrl.slice(0, 120)}: ${(0, errors_1.toErrorMessage)(err)}`);
+        if (reconciliation) {
+            await captureBeaconOutcomeSafely({
+                requestId: reconciliation.requestId,
+                siteId,
+                joinKeys: reconciliation.joinKeys,
+                beaconStatus: "failed",
+                trackingUrl,
+                durationMs: Date.now() - startedAt,
+            });
+        }
     }
     finally {
         (0, dd_metrics_1.recordTrackingClickDuration)(siteId, Date.now() - startedAt);
@@ -57,10 +93,12 @@ async function executeTrackingClick(trackingUrl, siteId) {
 }
 /**
  * Launches a background tracking click. Returns immediately — the caller
- * does not await the result. Errors never propagate.
+ * does not await the result. Errors never propagate. `reconciliation` is
+ * optional so a fired/failed beacon outcome can be correlated to the run
+ * when the caller has resolved join keys; omit it to keep today's behavior.
  */
-function fireTrackingClick(trackingUrl, siteId) {
-    const promise = executeTrackingClick(trackingUrl, siteId).finally(() => {
+function fireTrackingClick(trackingUrl, siteId, reconciliation) {
+    const promise = executeTrackingClick(trackingUrl, siteId, reconciliation).finally(() => {
         inFlightClicks.delete(promise);
     });
     inFlightClicks.add(promise);

package/dist/lib/tracking-click.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracking-click.js","sourceRoot":"","sources":["../../src/lib/tracking-click.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;AAEH,iDAK0B;AAC1B,yCAA8C;AAC9C,2CAA0C;AAC1C,uEAAgF;AAEhF,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAErD,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,cAAc,GAAG,KAAK,CAAC;AAC7B,MAAM,mCAAmC,GAAG,GAAG,CAAC;AAEhD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAiB,CAAC;AAEhD;;;;GAIG;AACH,KAAK,UAAU,oBAAoB,CAAC,WAAmB,EAAE,MAAc;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAA,uCAA0B,EAAC,MAAM,CAAC,CAAC;IAEnC,IAAI,OAAgF,CAAC;IACrF,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,IAAA,qDAA+B,EAAC;YAC9C,eAAe,EAAE,IAAI;YACrB,8BAA8B,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE;SACjF,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QAC/D,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAChG,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;QAE1C,IAAA,uCAA0B,EAAC,MAAM,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,CACT,+BAA+B,MAAM,QAAQ,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,eAAe,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAC9G,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAA,uCAA0B,EAAC,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC5F,MAAM,CAAC,IAAI,CACT,8BAA8B,MAAM,QAAQ,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,IAAA,uBAAc,EAAC,GAAG,CAAC,EAAE,CAChG,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAA,wCAA2B,EAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;QAC5D,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACvC,MAAM,CAAC,IAAI,CAAC,wCAAwC,IAAA,uBAAc,EAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClF,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,2BAAkC,WAAmB,EAAE,MAAc;IACnE,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;QACrE,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACI,KAAK,8BAA8B,SAAS,GAAG,MAAM;IAC1D,IAAI,cAAc,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO;IACtC,MAAM,CAAC,IAAI,CAAC,YAAY,cAAc,CAAC,IAAI,8BAA8B,CAAC,CAAC;IAC3E,MAAM,OAAO,CAAC,IAAI,CAAC;QACjB,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC;QACvC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"tracking-click.js","sourceRoot":"","sources":["../../src/lib/tracking-click.ts"],"names":[],"mappings":"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"}