@enricai/barnacle 1.0.0

package/dist/lib/bedrock.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBedrockModel = createBedrockModel;
+const amazon_bedrock_1 = require("@ai-sdk/amazon-bedrock");
+/**
+ * Builds an AI SDK language model backed by AWS Bedrock for injection into
+ * Stagehand's `llmClient`. Centralises all @ai-sdk/amazon-bedrock imports here
+ * so no other module touches the AWS SDK.
+ *
+ * Bedrock v4 emits a `LanguageModelV3` (provider spec v3) but Stagehand's
+ * `AISdkClient` still types its `model` as `LanguageModelV2`. The two specs
+ * are runtime-compatible for Stagehand's use, so we cast at this single
+ * boundary rather than letting the version mismatch leak into call sites.
+ * Remove the cast once Stagehand accepts `LanguageModelV3`.
+ *
+ * When accessKeyId/secretAccessKey are set, uses explicit static credentials.
+ * When omitted, region-only config lets the SDK fall through to its default
+ * credential chain (env vars → ~/.aws/credentials → ECS task role → EC2
+ * instance profile) — correct for IAM-role deployments.
+ */
+function createBedrockModel(bedrockConfig) {
+    const hasExplicitCredentials = bedrockConfig.accessKeyId !== undefined && bedrockConfig.secretAccessKey !== undefined;
+    const provider = (0, amazon_bedrock_1.createAmazonBedrock)({
+        region: bedrockConfig.region,
+        ...(hasExplicitCredentials
+            ? {
+                accessKeyId: bedrockConfig.accessKeyId,
+                secretAccessKey: bedrockConfig.secretAccessKey,
+                ...(bedrockConfig.sessionToken ? { sessionToken: bedrockConfig.sessionToken } : {}),
+            }
+            : {}),
+    });
+    return provider(bedrockConfig.model);
+}
+//# sourceMappingURL=bedrock.js.map

package/dist/lib/bedrock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bedrock.js","sourceRoot":"","sources":["../../src/lib/bedrock.ts"],"names":[],"mappings":";;AAuBA,gDAgBC;AAvCD,2DAA6D;AAO7D;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,kBAAkB,CAAC,aAAmC;IACpE,MAAM,sBAAsB,GAC1B,aAAa,CAAC,WAAW,KAAK,SAAS,IAAI,aAAa,CAAC,eAAe,KAAK,SAAS,CAAC;IAEzF,MAAM,QAAQ,GAAG,IAAA,oCAAmB,EAAC;QACnC,MAAM,EAAE,aAAa,CAAC,MAAM;QAC5B,GAAG,CAAC,sBAAsB;YACxB,CAAC,CAAC;gBACE,WAAW,EAAE,aAAa,CAAC,WAAqB;gBAChD,eAAe,EAAE,aAAa,CAAC,eAAyB;gBACxD,GAAG,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,aAAa,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,aAAa,CAAC,KAAK,CAA8B,CAAC;AACpE,CAAC"}

package/dist/lib/case-insensitive-headers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Case-insensitive lookup for HTTP header records whose keys may arrive in
+ * any capitalisation (e.g. CDP `requestWillBeSent` headers from Chromium vs.
+ * Node `http.IncomingMessage` lower-cased headers). HTTP/1.1 §4.2 specifies
+ * header names are case-insensitive, but JS objects are not — this bridges
+ * the gap without requiring callers to normalise keys up front.
+ */
+export declare function lookupHeaderCaseInsensitive(headers: Record<string, string>, name: string): string | undefined;
+/**
+ * Returns a copy of the header record with the named key removed, matching
+ * case-insensitively. Needed when passing FormData to fetch — the caller must
+ * drop Content-Type so fetch can set the multipart boundary itself.
+ */
+export declare function omitHeaderCaseInsensitive(headers: Record<string, string>, name: string): Record<string, string>;
+//# sourceMappingURL=case-insensitive-headers.d.ts.map

package/dist/lib/case-insensitive-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case-insensitive-headers.d.ts","sourceRoot":"","sources":["../../src/lib/case-insensitive-headers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAMpB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGxB"}

package/dist/lib/case-insensitive-headers.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookupHeaderCaseInsensitive = lookupHeaderCaseInsensitive;
+exports.omitHeaderCaseInsensitive = omitHeaderCaseInsensitive;
+/**
+ * Case-insensitive lookup for HTTP header records whose keys may arrive in
+ * any capitalisation (e.g. CDP `requestWillBeSent` headers from Chromium vs.
+ * Node `http.IncomingMessage` lower-cased headers). HTTP/1.1 §4.2 specifies
+ * header names are case-insensitive, but JS objects are not — this bridges
+ * the gap without requiring callers to normalise keys up front.
+ */
+function lookupHeaderCaseInsensitive(headers, name) {
+    const lower = name.toLowerCase();
+    for (const k of Object.keys(headers)) {
+        if (k.toLowerCase() === lower)
+            return headers[k];
+    }
+    return undefined;
+}
+/**
+ * Returns a copy of the header record with the named key removed, matching
+ * case-insensitively. Needed when passing FormData to fetch — the caller must
+ * drop Content-Type so fetch can set the multipart boundary itself.
+ */
+function omitHeaderCaseInsensitive(headers, name) {
+    const lower = name.toLowerCase();
+    return Object.fromEntries(Object.entries(headers).filter(([k]) => k.toLowerCase() !== lower));
+}
+//# sourceMappingURL=case-insensitive-headers.js.map

package/dist/lib/case-insensitive-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"case-insensitive-headers.js","sourceRoot":"","sources":["../../src/lib/case-insensitive-headers.ts"],"names":[],"mappings":";;AAOA,kEASC;AAOD,8DAMC;AA7BD;;;;;;GAMG;AACH,SAAgB,2BAA2B,CACzC,OAA+B,EAC/B,IAAY;IAEZ,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK;YAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB,CACvC,OAA+B,EAC/B,IAAY;IAEZ,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC;AAChG,CAAC"}

package/dist/lib/chromium-client-hints.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Builds the Chromium client-hint header quartet from explicit inputs.
+ * Single source of truth for the four-header idiom so plugins never
+ * hand-roll User-Agent / sec-ch-ua / sec-ch-ua-mobile / sec-ch-ua-platform.
+ */
+export declare function chromiumClientHints(opts: {
+    userAgent: string;
+    secChUa: string;
+    platform: string;
+}): Record<string, string>;
+//# sourceMappingURL=chromium-client-hints.d.ts.map

package/dist/lib/chromium-client-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromium-client-hints.d.ts","sourceRoot":"","sources":["../../src/lib/chromium-client-hints.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOzB"}

package/dist/lib/chromium-client-hints.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chromiumClientHints = chromiumClientHints;
+/**
+ * Builds the Chromium client-hint header quartet from explicit inputs.
+ * Single source of truth for the four-header idiom so plugins never
+ * hand-roll User-Agent / sec-ch-ua / sec-ch-ua-mobile / sec-ch-ua-platform.
+ */
+function chromiumClientHints(opts) {
+    return {
+        "User-Agent": opts.userAgent,
+        "sec-ch-ua": opts.secChUa,
+        "sec-ch-ua-mobile": "?0",
+        "sec-ch-ua-platform": `"${opts.platform}"`,
+    };
+}
+//# sourceMappingURL=chromium-client-hints.js.map

package/dist/lib/chromium-client-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromium-client-hints.js","sourceRoot":"","sources":["../../src/lib/chromium-client-hints.ts"],"names":[],"mappings":";;AAKA,kDAWC;AAhBD;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,IAInC;IACC,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,SAAS;QAC5B,WAAW,EAAE,IAAI,CAAC,OAAO;QACzB,kBAAkB,EAAE,IAAI;QACxB,oBAAoB,EAAE,IAAI,IAAI,CAAC,QAAQ,GAAG;KAC3C,CAAC;AACJ,CAAC"}

package/dist/lib/cookie-value.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generic cookie-string parser. Extracts a named cookie's value from a
+ * `document.cookie` string (the semicolon-separated `name=value` format the
+ * browser exposes). Site-specific callers keep the cookie name at their call
+ * sites so this helper stays domain-agnostic.
+ */
+export declare function getCookieValue(cookieStr: string, name: string): string | undefined;
+//# sourceMappingURL=cookie-value.d.ts.map

package/dist/lib/cookie-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-value.d.ts","sourceRoot":"","sources":["../../src/lib/cookie-value.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGlF"}

package/dist/lib/cookie-value.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCookieValue = getCookieValue;
+/**
+ * Generic cookie-string parser. Extracts a named cookie's value from a
+ * `document.cookie` string (the semicolon-separated `name=value` format the
+ * browser exposes). Site-specific callers keep the cookie name at their call
+ * sites so this helper stays domain-agnostic.
+ */
+function getCookieValue(cookieStr, name) {
+    const match = cookieStr.match(new RegExp(`${name}=([^;]+)`));
+    return match?.[1];
+}
+//# sourceMappingURL=cookie-value.js.map

package/dist/lib/cookie-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-value.js","sourceRoot":"","sources":["../../src/lib/cookie-value.ts"],"names":[],"mappings":";;AAMA,wCAGC;AATD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,SAAiB,EAAE,IAAY;IAC5D,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC;IAC7D,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC"}

package/dist/lib/datadog.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Initializes dd-trace APM when DD_TRACE_ENABLED=true. Loaded via the
+ * --import flag before any application module so dd-trace can monkey-patch
+ * http/net/dns for auto-instrumentation of Fastify routes and outbound calls.
+ */
+import tracer from "dd-trace";
+export { tracer };
+//# sourceMappingURL=datadog.d.ts.map

package/dist/lib/datadog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datadog.d.ts","sourceRoot":"","sources":["../../src/lib/datadog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,MAAM,MAAM,UAAU,CAAC;AAkB9B,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/lib/datadog.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tracer = void 0;
+/**
+ * Initializes dd-trace APM when DD_TRACE_ENABLED=true. Loaded via the
+ * --import flag before any application module so dd-trace can monkey-patch
+ * http/net/dns for auto-instrumentation of Fastify routes and outbound calls.
+ */
+const dd_trace_1 = __importDefault(require("dd-trace"));
+exports.tracer = dd_trace_1.default;
+const env_1 = require("../lib/env");
+const traceEnabled = (0, env_1.getBoolEnv)("DD_TRACE_ENABLED", false);
+if (traceEnabled) {
+    dd_trace_1.default.init({
+        service: (0, env_1.getEnv)("DD_SERVICE", "barnacle"),
+        env: (0, env_1.getEnv)("DD_ENV", (0, env_1.getNodeEnv)()),
+        version: (0, env_1.getEnv)("DD_VERSION", "0.1.0"),
+        hostname: (0, env_1.getEnv)("DD_AGENT_HOST", "localhost"),
+        port: (0, env_1.getNumericEnv)("DD_DOGSTATSD_PORT", 8125),
+        logInjection: true,
+        runtimeMetrics: true,
+    });
+}
+//# sourceMappingURL=datadog.js.map

package/dist/lib/datadog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datadog.js","sourceRoot":"","sources":["../../src/lib/datadog.ts"],"names":[],"mappings":";;;;;;AAAA;;;;GAIG;AACH,wDAA8B;AAkBrB,iBAlBF,kBAAM,CAkBE;AAhBf,mCAA0E;AAE1E,MAAM,YAAY,GAAG,IAAA,gBAAU,EAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;AAE3D,IAAI,YAAY,EAAE,CAAC;IACjB,kBAAM,CAAC,IAAI,CAAC;QACV,OAAO,EAAE,IAAA,YAAM,EAAC,YAAY,EAAE,UAAU,CAAC;QACzC,GAAG,EAAE,IAAA,YAAM,EAAC,QAAQ,EAAE,IAAA,gBAAU,GAAE,CAAC;QACnC,OAAO,EAAE,IAAA,YAAM,EAAC,YAAY,EAAE,OAAO,CAAC;QACtC,QAAQ,EAAE,IAAA,YAAM,EAAC,eAAe,EAAE,WAAW,CAAC;QAC9C,IAAI,EAAE,IAAA,mBAAa,EAAC,mBAAmB,EAAE,IAAI,CAAC;QAC9C,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/dd-metrics.d.ts

@@ -0,0 +1,28 @@
+export interface DispatchTags {
+    site: string;
+    path: "http" | "browser";
+}
+export interface FailureDispatchTags extends DispatchTags {
+    error_type: string;
+}
+/** Increments `dispatch.attempt` — one per plugin invocation. */
+export declare function recordDdAttempt(tags: DispatchTags): void;
+/** Increments `dispatch.success`. */
+export declare function recordDdSuccess(tags: DispatchTags): void;
+/** Increments `dispatch.failure` with error classification. */
+export declare function recordDdFailure(tags: FailureDispatchTags): void;
+/** Records end-to-end dispatch latency as a timing distribution. */
+export declare function recordDdDuration(tags: DispatchTags, durationMs: number): void;
+/** Increments `dispatch.fallback` — hot-path failed, browser engaged. */
+export declare function recordDdFallback(site: string): void;
+/** Increments `dispatch.rate_limit` — target site returned 429. */
+export declare function recordDdRateLimit(site: string): void;
+/** Increments `tracking_click.attempt` — background click fired. */
+export declare function recordTrackingClickAttempt(site: string): void;
+/** Increments `tracking_click.success`. */
+export declare function recordTrackingClickSuccess(site: string): void;
+/** Increments `tracking_click.failure` with error classification. */
+export declare function recordTrackingClickFailure(site: string, errorType: string): void;
+/** Records tracking click latency as a timing distribution. */
+export declare function recordTrackingClickDuration(site: string, durationMs: number): void;
+//# sourceMappingURL=dd-metrics.d.ts.map

package/dist/lib/dd-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dd-metrics.d.ts","sourceRoot":"","sources":["../../src/lib/dd-metrics.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAExD;AAED,qCAAqC;AACrC,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAExD;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAE/D;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAE7E;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED,oEAAoE;AACpE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED,2CAA2C;AAC3C,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED,qEAAqE;AACrE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAEhF;AAED,+DAA+D;AAC/D,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAElF"}

package/dist/lib/dd-metrics.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordDdAttempt = recordDdAttempt;
+exports.recordDdSuccess = recordDdSuccess;
+exports.recordDdFailure = recordDdFailure;
+exports.recordDdDuration = recordDdDuration;
+exports.recordDdFallback = recordDdFallback;
+exports.recordDdRateLimit = recordDdRateLimit;
+exports.recordTrackingClickAttempt = recordTrackingClickAttempt;
+exports.recordTrackingClickSuccess = recordTrackingClickSuccess;
+exports.recordTrackingClickFailure = recordTrackingClickFailure;
+exports.recordTrackingClickDuration = recordTrackingClickDuration;
+/**
+ * Typed DogStatsD wrappers for operational dispatch metrics. These supplement
+ * the in-memory counters in src/scraper/metrics.ts (which power /readyz) with
+ * durable Datadog-side aggregation for alerting and dashboards.
+ */
+const statsd_1 = require("../lib/statsd");
+function toTagArray(tags) {
+    return Object.entries(tags).map(([k, v]) => `${k}:${v}`);
+}
+/** Increments `dispatch.attempt` — one per plugin invocation. */
+function recordDdAttempt(tags) {
+    (0, statsd_1.getStatsD)().increment("dispatch.attempt", 1, toTagArray(tags));
+}
+/** Increments `dispatch.success`. */
+function recordDdSuccess(tags) {
+    (0, statsd_1.getStatsD)().increment("dispatch.success", 1, toTagArray(tags));
+}
+/** Increments `dispatch.failure` with error classification. */
+function recordDdFailure(tags) {
+    (0, statsd_1.getStatsD)().increment("dispatch.failure", 1, toTagArray(tags));
+}
+/** Records end-to-end dispatch latency as a timing distribution. */
+function recordDdDuration(tags, durationMs) {
+    (0, statsd_1.getStatsD)().timing("dispatch.duration_ms", durationMs, toTagArray(tags));
+}
+/** Increments `dispatch.fallback` — hot-path failed, browser engaged. */
+function recordDdFallback(site) {
+    (0, statsd_1.getStatsD)().increment("dispatch.fallback", 1, [`site:${site}`]);
+}
+/** Increments `dispatch.rate_limit` — target site returned 429. */
+function recordDdRateLimit(site) {
+    (0, statsd_1.getStatsD)().increment("dispatch.rate_limit", 1, [`site:${site}`]);
+}
+/** Increments `tracking_click.attempt` — background click fired. */
+function recordTrackingClickAttempt(site) {
+    (0, statsd_1.getStatsD)().increment("tracking_click.attempt", 1, [`site:${site}`]);
+}
+/** Increments `tracking_click.success`. */
+function recordTrackingClickSuccess(site) {
+    (0, statsd_1.getStatsD)().increment("tracking_click.success", 1, [`site:${site}`]);
+}
+/** Increments `tracking_click.failure` with error classification. */
+function recordTrackingClickFailure(site, errorType) {
+    (0, statsd_1.getStatsD)().increment("tracking_click.failure", 1, [`site:${site}`, `error_type:${errorType}`]);
+}
+/** Records tracking click latency as a timing distribution. */
+function recordTrackingClickDuration(site, durationMs) {
+    (0, statsd_1.getStatsD)().timing("tracking_click.duration_ms", durationMs, [`site:${site}`]);
+}
+//# sourceMappingURL=dd-metrics.js.map

package/dist/lib/dd-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dd-metrics.js","sourceRoot":"","sources":["../../src/lib/dd-metrics.ts"],"names":[],"mappings":";;AAqBA,0CAEC;AAGD,0CAEC;AAGD,0CAEC;AAGD,4CAEC;AAGD,4CAEC;AAGD,8CAEC;AAGD,gEAEC;AAGD,gEAEC;AAGD,gEAEC;AAGD,kEAEC;AApED;;;;GAIG;AACH,yCAAyC;AAWzC,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,iEAAiE;AACjE,SAAgB,eAAe,CAAC,IAAkB;IAChD,IAAA,kBAAS,GAAE,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,qCAAqC;AACrC,SAAgB,eAAe,CAAC,IAAkB;IAChD,IAAA,kBAAS,GAAE,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,+DAA+D;AAC/D,SAAgB,eAAe,CAAC,IAAyB;IACvD,IAAA,kBAAS,GAAE,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,oEAAoE;AACpE,SAAgB,gBAAgB,CAAC,IAAkB,EAAE,UAAkB;IACrE,IAAA,kBAAS,GAAE,CAAC,MAAM,CAAC,sBAAsB,EAAE,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,yEAAyE;AACzE,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,IAAA,kBAAS,GAAE,CAAC,SAAS,CAAC,mBAAmB,EAAE,CAAC,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,mEAAmE;AACnE,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,IAAA,kBAAS,GAAE,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAC,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,oEAAoE;AACpE,SAAgB,0BAA0B,CAAC,IAAY;IACrD,IAAA,kBAAS,GAAE,CAAC,SAAS,CAAC,wBAAwB,EAAE,CAAC,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,2CAA2C;AAC3C,SAAgB,0BAA0B,CAAC,IAAY;IACrD,IAAA,kBAAS,GAAE,CAAC,SAAS,CAAC,wBAAwB,EAAE,CAAC,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,qEAAqE;AACrE,SAAgB,0BAA0B,CAAC,IAAY,EAAE,SAAiB;IACxE,IAAA,kBAAS,GAAE,CAAC,SAAS,CAAC,wBAAwB,EAAE,CAAC,EAAE,CAAC,QAAQ,IAAI,EAAE,EAAE,cAAc,SAAS,EAAE,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,+DAA+D;AAC/D,SAAgB,2BAA2B,CAAC,IAAY,EAAE,UAAkB;IAC1E,IAAA,kBAAS,GAAE,CAAC,MAAM,CAAC,4BAA4B,EAAE,UAAU,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;AACjF,CAAC"}

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

@@ -0,0 +1,19 @@
+import type { DispatchMetrics } from "../types/dispatch-metrics";
+/** Accumulates step-level timing for a single dispatch, producing a DispatchMetrics payload for the response. */
+export declare class MetricsCollector {
+    private steps;
+    private currentStep;
+    private stepStart;
+    private attempts;
+    private started;
+    constructor();
+    /** Marks the beginning of a named step. Ends any in-progress step as failed. */
+    startStep(name: string): void;
+    /** Marks the current step as complete with the given status. */
+    endStep(status: "success" | "failed" | "skipped", error?: string): void;
+    /** Increments the attempt counter on retry. Keeps all recorded steps. */
+    markRetry(): void;
+    /** Produces the final DispatchMetrics payload. Safe to call multiple times. */
+    finalize(path: "http" | "browser"): DispatchMetrics;
+}
+//# sourceMappingURL=dispatch-metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-metrics.d.ts","sourceRoot":"","sources":["../../src/lib/dispatch-metrics.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,0BAA0B,CAAC;AAEpF,iHAAiH;AACjH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAAS;;IAMxB,gFAAgF;IAChF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ7B,gEAAgE;IAChE,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAWvE,yEAAyE;IACzE,SAAS,IAAI,IAAI;IAIjB,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe;CAiBpD"}

package/dist/lib/dispatch-metrics.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsCollector = void 0;
+/**
+ * Lightweight step-timing accumulator for a single dispatch invocation.
+ * Instantiated per-request in the dispatch layer, threaded through
+ * SitePluginContext, and finalized into a DispatchMetrics payload that
+ * ships in the response body for Vivian → Segment forwarding.
+ */
+const date_fns_1 = require("date-fns");
+/** Accumulates step-level timing for a single dispatch, producing a DispatchMetrics payload for the response. */
+class MetricsCollector {
+    steps = [];
+    currentStep;
+    stepStart = 0;
+    attempts = 1;
+    started;
+    constructor() {
+        this.started = Date.now();
+    }
+    /** Marks the beginning of a named step. Ends any in-progress step as failed. */
+    startStep(name) {
+        if (this.currentStep) {
+            this.endStep("failed", "interrupted by next step");
+        }
+        this.currentStep = name;
+        this.stepStart = Date.now();
+    }
+    /** Marks the current step as complete with the given status. */
+    endStep(status, error) {
+        if (!this.currentStep)
+            return;
+        this.steps.push({
+            step: this.currentStep,
+            durationMs: Date.now() - this.stepStart,
+            status,
+            ...(error && { error }),
+        });
+        this.currentStep = undefined;
+    }
+    /** Increments the attempt counter on retry. Keeps all recorded steps. */
+    markRetry() {
+        this.attempts++;
+    }
+    /** Produces the final DispatchMetrics payload. Safe to call multiple times. */
+    finalize(path) {
+        if (this.currentStep) {
+            this.endStep("failed", "dispatch ended before step completed");
+        }
+        const failedStep = this.steps.find((s) => s.status === "failed");
+        return {
+            totalDurationMs: Date.now() - this.started,
+            path,
+            steps: this.steps,
+            ...(failedStep?.error && { errorType: failedStep.error }),
+            ...(failedStep && { errorStep: failedStep.step }),
+            attemptCount: this.attempts,
+            startedAt: (0, date_fns_1.formatISO)(new Date(this.started)),
+            endedAt: (0, date_fns_1.formatISO)(new Date()),
+            recordedAt: (0, date_fns_1.formatISO)(new Date()),
+        };
+    }
+}
+exports.MetricsCollector = MetricsCollector;
+//# sourceMappingURL=dispatch-metrics.js.map

package/dist/lib/dispatch-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-metrics.js","sourceRoot":"","sources":["../../src/lib/dispatch-metrics.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,uCAAqC;AAIrC,iHAAiH;AACjH,MAAa,gBAAgB;IACnB,KAAK,GAAyB,EAAE,CAAC;IACjC,WAAW,CAAqB;IAChC,SAAS,GAAG,CAAC,CAAC;IACd,QAAQ,GAAG,CAAC,CAAC;IACb,OAAO,CAAS;IAExB;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED,gFAAgF;IAChF,SAAS,CAAC,IAAY;QACpB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED,gEAAgE;IAChE,OAAO,CAAC,MAAwC,EAAE,KAAc;QAC9D,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,IAAI,CAAC,WAAW;YACtB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;YACvC,MAAM;YACN,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED,yEAAyE;IACzE,SAAS;QACP,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,+EAA+E;IAC/E,QAAQ,CAAC,IAAwB;QAC/B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,sCAAsC,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QACjE,OAAO;YACL,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO;YAC1C,IAAI;YACJ,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;YACzD,GAAG,CAAC,UAAU,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;YACjD,YAAY,EAAE,IAAI,CAAC,QAAQ;YAC3B,SAAS,EAAE,IAAA,oBAAS,EAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5C,OAAO,EAAE,IAAA,oBAAS,EAAC,IAAI,IAAI,EAAE,CAAC;YAC9B,UAAU,EAAE,IAAA,oBAAS,EAAC,IAAI,IAAI,EAAE,CAAC;SAClC,CAAC;IACJ,CAAC;CACF;AAvDD,4CAuDC"}

package/dist/lib/env.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Environment variable readers for the config singleton. Kept deliberately
+ * small — only the parsers config.ts actually calls. Richer env helpers
+ * live in `@/config` where they can be typed against AppConfig.
+ */
+type NodeEnv = "development" | "production" | "test";
+/**
+ * Returns the current NODE_ENV constrained to our three supported values,
+ * defaulting to "development" for anything unrecognized.
+ */
+export declare function getNodeEnv(): NodeEnv;
+/**
+ * Reads a string env var with a default. We DON'T trim / lowercase here —
+ * callers decide the semantics so shapes like comma-separated lists can be
+ * split before whitespace matters.
+ */
+export declare function getEnv(key: string, defaultValue: string): string;
+/**
+ * Parses boolean env vars permissively: "true", "1", "yes" (case-insensitive)
+ * are truthy. Anything else (including "false", "0", "no") falls back to
+ * the default — unset string → defaultValue.
+ */
+export declare function getBoolEnv(key: string, defaultValue?: boolean): boolean;
+/**
+ * Parses numeric env vars. Non-numeric input falls back to `defaultValue`
+ * instead of throwing — configuration should degrade gracefully, not crash
+ * the process, on typos.
+ */
+export declare function getNumericEnv(key: string, defaultValue: number): number;
+/**
+ * Parses fractional env vars (e.g. LLM sampling temperature, confidence
+ * thresholds). Non-numeric input falls back to `defaultValue` so a typo
+ * never crashes the process.
+ */
+export declare function getFloatEnv(key: string, defaultValue: number): number;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/lib/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,KAAK,OAAO,GAAG,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;AAErD;;;GAGG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAMpC;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO,CAMrE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAOrE"}

package/dist/lib/env.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Environment variable readers for the config singleton. Kept deliberately
+ * small — only the parsers config.ts actually calls. Richer env helpers
+ * live in `@/config` where they can be typed against AppConfig.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodeEnv = getNodeEnv;
+exports.getEnv = getEnv;
+exports.getBoolEnv = getBoolEnv;
+exports.getNumericEnv = getNumericEnv;
+exports.getFloatEnv = getFloatEnv;
+/**
+ * Returns the current NODE_ENV constrained to our three supported values,
+ * defaulting to "development" for anything unrecognized.
+ */
+function getNodeEnv() {
+    const env = process.env.NODE_ENV;
+    if (env === "production" || env === "test") {
+        return env;
+    }
+    return "development";
+}
+/**
+ * Reads a string env var with a default. We DON'T trim / lowercase here —
+ * callers decide the semantics so shapes like comma-separated lists can be
+ * split before whitespace matters.
+ */
+function getEnv(key, defaultValue) {
+    return process.env[key] || defaultValue;
+}
+/**
+ * Parses boolean env vars permissively: "true", "1", "yes" (case-insensitive)
+ * are truthy. Anything else (including "false", "0", "no") falls back to
+ * the default — unset string → defaultValue.
+ */
+function getBoolEnv(key, defaultValue = false) {
+    const value = process.env[key];
+    if (!value) {
+        return defaultValue;
+    }
+    return ["true", "1", "yes"].includes(value.toLowerCase());
+}
+/**
+ * Parses numeric env vars. Non-numeric input falls back to `defaultValue`
+ * instead of throwing — configuration should degrade gracefully, not crash
+ * the process, on typos.
+ */
+function getNumericEnv(key, defaultValue) {
+    const value = process.env[key];
+    if (!value) {
+        return defaultValue;
+    }
+    const parsed = Number.parseInt(value, 10);
+    return Number.isNaN(parsed) ? defaultValue : parsed;
+}
+/**
+ * Parses fractional env vars (e.g. LLM sampling temperature, confidence
+ * thresholds). Non-numeric input falls back to `defaultValue` so a typo
+ * never crashes the process.
+ */
+function getFloatEnv(key, defaultValue) {
+    const value = process.env[key];
+    if (!value) {
+        return defaultValue;
+    }
+    const parsed = Number.parseFloat(value);
+    return Number.isNaN(parsed) ? defaultValue : parsed;
+}
+//# sourceMappingURL=env.js.map

package/dist/lib/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAQH,gCAMC;AAOD,wBAEC;AAOD,gCAMC;AAOD,sCAOC;AAOD,kCAOC;AA5DD;;;GAGG;AACH,SAAgB,UAAU;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;IACjC,IAAI,GAAG,KAAK,YAAY,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QAC3C,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,SAAgB,MAAM,CAAC,GAAW,EAAE,YAAoB;IACtD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,GAAW,EAAE,YAAY,GAAG,KAAK;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,GAAW,EAAE,YAAoB;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW,CAAC,GAAW,EAAE,YAAoB;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;AACtD,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared error-coercion helpers.
+ *
+ * Exists to consolidate the `err instanceof Error ? err.message : String(err)`
+ * ternary that was duplicated across the loader, session, server shutdown,
+ * health route, and several scripts. Keeping it in one place means every
+ * call site renders unknown thrown values the same way in logs and envelopes.
+ */
+/**
+ * Normalises an `unknown` thrown value to a string suitable for logging or
+ * error messages. Real `Error` instances surface their `.message`; everything
+ * else falls back to `String(value)`.
+ */
+export declare function toErrorMessage(err: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEnD"}

package/dist/lib/errors.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Shared error-coercion helpers.
+ *
+ * Exists to consolidate the `err instanceof Error ? err.message : String(err)`
+ * ternary that was duplicated across the loader, session, server shutdown,
+ * health route, and several scripts. Keeping it in one place means every
+ * call site renders unknown thrown values the same way in logs and envelopes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toErrorMessage = toErrorMessage;
+/**
+ * Normalises an `unknown` thrown value to a string suitable for logging or
+ * error messages. Real `Error` instances surface their `.message`; everything
+ * else falls back to `String(value)`.
+ */
+function toErrorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAOH,wCAEC;AAPD;;;;GAIG;AACH,SAAgB,cAAc,CAAC,GAAY;IACzC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/dist/lib/http.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Raises undici's TCP connect timeout from its 10 s hardcoded default.
+ * Must be called once at process startup in every entry point that makes
+ * outbound fetch calls (server.ts, scripts, etc.).
+ */
+export declare function configureHttpDispatcher(): void;
+//# sourceMappingURL=http.d.ts.map

package/dist/lib/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/lib/http.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureHttpDispatcher = configureHttpDispatcher;
+const undici_1 = require("undici");
+const config_1 = require("../config");
+/**
+ * Raises undici's TCP connect timeout from its 10 s hardcoded default.
+ * Must be called once at process startup in every entry point that makes
+ * outbound fetch calls (server.ts, scripts, etc.).
+ */
+function configureHttpDispatcher() {
+    (0, undici_1.setGlobalDispatcher)(new undici_1.Agent({ connect: { timeout: config_1.config.scraper.connectTimeoutMs } }));
+}
+//# sourceMappingURL=http.js.map

package/dist/lib/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/lib/http.ts"],"names":[],"mappings":";;AASA,0DAEC;AAXD,mCAAoD;AAEpD,qCAAkC;AAElC;;;;GAIG;AACH,SAAgB,uBAAuB;IACrC,IAAA,4BAAmB,EAAC,IAAI,cAAK,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,eAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC;AAC5F,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Shared Zod schema fragment for the optional post-submission tracking-click
+ * URL that every plugin may receive. The engine reads `TrackingUrl`
+ * site-agnostically in loader.ts (fireTrackingClick) — this fragment is the
+ * single source of truth so a type change propagates to every plugin from one
+ * place.
+ *
+ * Compose into a plugin contract via `.extend(JobTrackingSchema.shape)` or
+ * `.merge(JobTrackingSchema)` depending on which Zod combinator the plugin
+ * already uses.
+ */
+import { z } from "zod/v4";
+export declare const JobTrackingSchema: z.ZodObject<{
+    TrackingUrl: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+export type JobTracking = z.infer<typeof JobTrackingSchema>;
+//# sourceMappingURL=job-tracking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-tracking.d.ts","sourceRoot":"","sources":["../../src/lib/job-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,eAAO,MAAM,iBAAiB;;iBAE5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}