@end-close/relay 0.12.0

package/dist/forward/dispatcher.js

@@ -0,0 +1,444 @@
+import { storeOp, } from '../engine/store.js';
+import { RelayHooks } from '../engine/hooks.js';
+import { noopLogger } from '../logger.js';
+import { jsonTopLevelKeys } from '../util/payload-shape.js';
+import { sleep } from '../util/strings.js';
+import { nextAttemptAt } from './backoff.js';
+import { mapEvent, MappingError } from './mapper.js';
+import { EnrichmentError, validateEnrichedValue, withTimeout, } from './enrich.js';
+import { PermanentHttpError, TransientHttpError, } from './endclose-client.js';
+const IN_REQUEST_RETRIES = 2;
+const RESULT_POLL_ATTEMPTS = 5;
+const RESULT_POLL_DELAY_MS = 1000;
+const PRUNE_INTERVAL_MS = 3600_000;
+const PRUNE_BATCH = 50;
+const PRUNE_YIELD_MS = 25;
+export class Dispatcher {
+    deps;
+    log;
+    hooks;
+    running = false;
+    wakeRequested = false;
+    // Rows this instance left 'delivering' (a crash, or a failed release) are reclaimed
+    // by owner on the next cycle regardless of lease. Expired leases left by anyone are
+    // swept every recoverIntervalMs, so a long-lived instance also covers crashed peers.
+    reclaimOwner;
+    lastSweepAt = 0;
+    inFlight = Promise.resolve();
+    pruneWork = Promise.resolve();
+    timer;
+    pruneTimer;
+    stopped = () => !this.running;
+    constructor(deps) {
+        this.deps = deps;
+        this.log = deps.logger ?? noopLogger;
+        this.hooks = deps.hooks ?? new RelayHooks();
+        this.reclaimOwner = deps.instanceId;
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.deps.signal.on('event', this.onSignal);
+        this.timer = setInterval(() => this.wake(), this.deps.dispatch.pollIntervalMs);
+        if (this.deps.retention) {
+            this.pruneTimer = setInterval(() => this.schedulePrune(), PRUNE_INTERVAL_MS);
+            this.schedulePrune();
+        }
+        this.wake();
+    }
+    onSignal = () => this.wake();
+    /**
+     * Run exactly one dispatch cycle, serialised with the background loop if it is running.
+     * Errors propagate to the caller (they are also emitted as hooks).
+     */
+    runOnce() {
+        const run = this.inFlight.then(() => this.cycle().catch((err) => {
+            this.reportCycleError(err);
+            throw err;
+        }));
+        this.inFlight = run.then(() => { }, () => { });
+        return run;
+    }
+    /** Run retention pruning to completion, serialised with any scheduled prune. */
+    pruneNow() {
+        const run = this.pruneWork.then(() => this.runPrune());
+        this.pruneWork = run.then(() => { }, () => { });
+        return run;
+    }
+    /** Stop accepting new work and wait for the in-flight cycle and prune to drain. */
+    async stop() {
+        this.running = false;
+        this.deps.signal.off('event', this.onSignal);
+        if (this.timer)
+            clearInterval(this.timer);
+        if (this.pruneTimer)
+            clearInterval(this.pruneTimer);
+        await this.inFlight;
+        await this.pruneWork;
+    }
+    wake() {
+        if (!this.running)
+            return;
+        this.wakeRequested = true;
+        this.inFlight = this.inFlight.then(async () => {
+            while (this.wakeRequested && this.running) {
+                this.wakeRequested = false;
+                try {
+                    await this.cycle(this.stopped);
+                }
+                catch (err) {
+                    this.reportCycleError(err);
+                }
+            }
+        });
+    }
+    reportCycleError(err) {
+        const op = storeOp(err);
+        this.log.error('dispatch cycle failed', { error: err.message, ...(op ? { op } : {}) });
+        this.hooks.emit('error', { kind: 'dispatch_cycle', error: err, ...(op ? { op } : {}) });
+    }
+    async cycle(abort = () => false) {
+        const now = new Date().toISOString();
+        const summary = { delivered: 0, retried: 0, parked: 0, due: [], skipped: [], halted: false };
+        const sweepDue = Date.now() - this.lastSweepAt >= this.deps.dispatch.recoverIntervalMs;
+        if (this.reclaimOwner !== undefined || sweepDue) {
+            try {
+                // The owner clause is only safe as a one-off (nothing of ours is in flight yet);
+                // the periodic sweep relies on lease expiry alone.
+                const recovered = await this.deps.store.recoverDelivering(now, this.reclaimOwner);
+                this.reclaimOwner = undefined;
+                if (recovered > 0)
+                    this.log.info('recovered in-flight events', { count: recovered });
+                if (sweepDue) {
+                    // Same cadence for the other housekeeping write; parkAfterMs is days, not seconds.
+                    await this.deps.store.parkExpired(now, this.deps.dispatch.parkAfterMs);
+                    this.lastSweepAt = Date.now();
+                }
+            }
+            catch (err) {
+                this.log.error('recover delivering failed', { error: err.message });
+                this.hooks.emit('error', { kind: 'recover_delivering', error: err });
+            }
+        }
+        if ((await this.deps.control.getKillswitch()) !== 'none') {
+            summary.halted = true;
+            return summary; // pause/panic: buffer, do not forward
+        }
+        summary.due = await this.deps.store.routesWithDueEvents(now);
+        for (const routeId of summary.due) {
+            if (abort())
+                break;
+            const [route, paused] = await Promise.all([
+                this.deps.routes.get(routeId),
+                this.deps.control.isRoutePaused(routeId),
+            ]);
+            // An unknown route is the stronger condition: a pause flag left behind by a removed
+            // route must not disguise it as merely paused.
+            if (!route) {
+                summary.skipped.push({ routeId, reason: 'unknown_route' });
+                continue;
+            }
+            if (paused) {
+                summary.skipped.push({ routeId, reason: 'paused' });
+                continue;
+            }
+            const claimed = await this.deps.store.claimDue(routeId, now, this.deps.dispatch.batchMax, {
+                owner: this.deps.instanceId,
+                until: new Date(Date.now() + this.deps.dispatch.leaseMs).toISOString(),
+            });
+            if (claimed.length === 0)
+                continue;
+            try {
+                await this.deliverBatch(route, claimed, summary);
+            }
+            finally {
+                await this.releaseLeftover(claimed, 'left delivering after batch');
+            }
+        }
+        return summary;
+    }
+    async deliverBatch(route, claimed, counts) {
+        const routeId = route.id;
+        // Map and enrich each event independently; an event that cannot be mapped parks, one
+        // whose enrichment fails transiently retries, and neither wedges the batch.
+        const records = [];
+        const mapped = [];
+        for (const event of claimed) {
+            let payloadKeys;
+            let bodyBytes;
+            let stage = 'mapping';
+            try {
+                const plaintext = this.deps.codec.decode(event.payload, event.payload_iv);
+                bodyBytes = plaintext.length;
+                const payload = JSON.parse(plaintext.toString('utf8'));
+                payloadKeys = jsonTopLevelKeys(payload);
+                const result = mapEvent(route, payload, event.received_at, this.deps.maskingKey);
+                let { record } = result;
+                if (result.pending.length > 0) {
+                    stage = 'enrichment';
+                    record = await this.resolveEnrichments(event, payload, result);
+                }
+                records.push(record);
+                mapped.push(event);
+            }
+            catch (err) {
+                if (err instanceof MappingError || err instanceof EnrichmentError) {
+                    const reason = `${stage} failed: ${err.message}`;
+                    await this.deps.store.markParked([event.id], reason);
+                    this.recordParked([event], reason, counts);
+                    this.log.warn(`event parked: ${stage} failed`, {
+                        route: routeId,
+                        event_id: event.event_id,
+                        body_bytes: bodyBytes,
+                        payload_keys: payloadKeys,
+                    });
+                }
+                else if (stage === 'enrichment') {
+                    // The host's lookup threw or timed out: fixable on their side, so retry later.
+                    await this.retryOne(event, `enrichment failed: ${err.message}`, counts);
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+        if (records.length === 0)
+            return;
+        try {
+            const accepted = await this.postWithRetries(records);
+            await this.settleResults(accepted.id, mapped, counts);
+            this.log.info('batch forwarded', {
+                route: routeId,
+                events: mapped.length,
+                bulk_request_id: accepted.id,
+            });
+            this.hooks.emit('batch.forwarded', { routeId, events: mapped.length, bulkRequestId: accepted.id });
+        }
+        catch (err) {
+            if (err instanceof PermanentHttpError && (err.status === 400 || err.status === 422)) {
+                const reason = `${err.message}: ${err.body}`;
+                await this.deps.store.markParked(mapped.map((e) => e.id), reason);
+                this.recordParked(mapped, reason, counts);
+                this.log.error('batch parked: permanent rejection', { route: routeId, status: err.status });
+                this.hooks.emit('batch.parked', { routeId, status: err.status, events: mapped.length });
+            }
+            else {
+                // Transient network failure, 5xx, or auth problem (fixable server-side or in
+                // config): schedule redelivery with backoff. attempts is per-event.
+                const maxAttempts = Math.max(...mapped.map((e) => e.attempts));
+                const next = nextAttemptAt(maxAttempts, this.deps.dispatch.backoffBaseMs, this.deps.dispatch.backoffCapMs);
+                const message = err.message;
+                await this.deps.store.markFailed(mapped.map((e) => e.id), next, message);
+                counts.retried += mapped.length;
+                this.hooks.emit('forward', { routeId, result: 'retried', count: mapped.length });
+                for (const e of mapped)
+                    this.hooks.emit('settled', { id: e.id, routeId, result: 'retried', error: message });
+                this.log.warn('batch delivery failed, will retry', {
+                    route: routeId,
+                    events: mapped.length,
+                    error: message,
+                    next_attempt_at: next,
+                });
+            }
+        }
+    }
+    /**
+     * Fill the fields mapEvent left to the host, one enrichment at a time. Throws
+     * EnrichmentError for a bad reference or return value (park); rethrows anything else
+     * the host threw, including a timeout (retry).
+     */
+    async resolveEnrichments(event, payload, mapped) {
+        const routeId = event.route_id;
+        const record = { ...mapped.record, metadata: { ...mapped.record.metadata } };
+        for (const { field, enrichment, input } of mapped.pending) {
+            const emit = (result, error) => this.hooks.emit('enrich', { routeId, id: event.id, field, enrichment, result, ...(error ? { error } : {}) });
+            const fn = this.deps.enrichments?.[enrichment];
+            if (!fn) {
+                const err = new EnrichmentError(`${field} references unknown enrichment "${enrichment}"`);
+                emit('rejected', err.message);
+                throw err;
+            }
+            const ctx = {
+                routeId,
+                source: event.source,
+                eventId: event.event_id,
+                eventType: event.event_type,
+                receivedAt: event.received_at,
+                field,
+                payload,
+            };
+            let value;
+            try {
+                const returned = await withTimeout(() => fn(input, ctx), this.deps.dispatch.enrichTimeoutMs);
+                value = validateEnrichedValue(returned, field);
+                if (field === 'description' && value !== undefined && typeof value !== 'string') {
+                    throw new EnrichmentError(`enriched description must be a string`);
+                }
+            }
+            catch (err) {
+                const message = err.message;
+                emit(err instanceof EnrichmentError ? 'rejected' : 'failed', `${enrichment}: ${message}`);
+                const wrapped = `${field} (${enrichment}): ${message}`;
+                throw err instanceof EnrichmentError
+                    ? new EnrichmentError(wrapped, { cause: err })
+                    : new Error(wrapped, { cause: err });
+            }
+            if (value === undefined) {
+                emit('omitted');
+                continue;
+            }
+            if (field === 'description')
+                record.description = value;
+            else
+                record.metadata[field.slice('metadata.'.length)] = value;
+            emit('applied');
+        }
+        return record;
+    }
+    /** Schedule one event for redelivery with backoff, leaving the rest of its batch alone. */
+    async retryOne(event, message, counts) {
+        const next = nextAttemptAt(event.attempts, this.deps.dispatch.backoffBaseMs, this.deps.dispatch.backoffCapMs);
+        await this.deps.store.markFailed([event.id], next, message);
+        counts.retried += 1;
+        this.hooks.emit('forward', { routeId: event.route_id, result: 'retried', count: 1 });
+        this.hooks.emit('settled', { id: event.id, routeId: event.route_id, result: 'retried', error: message });
+        this.log.warn('event enrichment failed, will retry', {
+            route: event.route_id,
+            event_id: event.event_id,
+            error: message,
+            next_attempt_at: next,
+        });
+    }
+    async postWithRetries(records) {
+        let lastErr;
+        for (let attempt = 0; attempt <= IN_REQUEST_RETRIES; attempt++) {
+            try {
+                return await this.deps.client.bulkCreateRecords(records);
+            }
+            catch (err) {
+                lastErr = err;
+                if (!(err instanceof TransientHttpError))
+                    throw err;
+                await sleep(500 * (attempt + 1));
+            }
+        }
+        throw lastErr;
+    }
+    /**
+     * Bulk processing is async server-side: poll briefly for per-row results. Rows the API
+     * rejected park; everything else is delivered. If results don't settle in time, mark
+     * delivered with the bulk_request_id recorded for later inspection.
+     */
+    async settleResults(bulkRequestId, mapped, counts) {
+        const deliveredAt = new Date().toISOString();
+        for (let i = 0; i < RESULT_POLL_ATTEMPTS; i++) {
+            let status;
+            try {
+                status = await this.deps.client.getBulkRequest(bulkRequestId);
+            }
+            catch {
+                break; // polling is best-effort; the batch was accepted
+            }
+            if (status.status === 'pending' || status.status === 'processing') {
+                await sleep(RESULT_POLL_DELAY_MS);
+                continue;
+            }
+            const failed = new Set((status.results ?? [])
+                .filter((r) => r.status === 'failed' || r.status === 'rejected')
+                .map((r) => r.external_id ?? String(r.index)));
+            if (failed.size === 0)
+                break;
+            const parked = [];
+            const ok = [];
+            mapped.forEach((event, index) => {
+                const key = extResultKey(event, index);
+                (failed.has(key.externalId) || failed.has(key.index) ? parked : ok).push(event);
+            });
+            const reason = 'rejected by End Close bulk processing';
+            await this.deps.store.markParked(parked.map((e) => e.id), reason);
+            await this.deps.store.markDelivered(ok.map((e) => e.id), deliveredAt, bulkRequestId);
+            this.recordDelivered(ok, deliveredAt, counts);
+            this.recordParked(parked, reason, counts);
+            return;
+        }
+        await this.deps.store.markDelivered(mapped.map((e) => e.id), deliveredAt, bulkRequestId);
+        this.recordDelivered(mapped, deliveredAt, counts);
+    }
+    recordDelivered(events, deliveredAt, counts) {
+        if (events.length === 0)
+            return;
+        counts.delivered += events.length;
+        this.hooks.emit('forward', { routeId: events[0].route_id, result: 'delivered', count: events.length });
+        for (const e of events) {
+            this.hooks.emit('delivered', { routeId: e.route_id, receivedAt: e.received_at, deliveredAt });
+            this.hooks.emit('settled', { id: e.id, routeId: e.route_id, result: 'delivered' });
+        }
+    }
+    recordParked(events, reason, counts) {
+        if (events.length === 0)
+            return;
+        counts.parked += events.length;
+        this.hooks.emit('forward', { routeId: events[0].route_id, result: 'parked', count: events.length });
+        for (const e of events) {
+            this.hooks.emit('settled', { id: e.id, routeId: e.route_id, result: 'parked', error: reason });
+        }
+    }
+    schedulePrune() {
+        // Prune must not block forwarding: failures are logged and emitted, never propagated.
+        this.pruneWork = this.pruneWork.then(() => this.runPrune(this.stopped)).catch(() => { });
+    }
+    /** Bounded batches with a yield between them so ingest and dispatch keep running. */
+    async runPrune(abort = () => false) {
+        const { retention } = this.deps;
+        if (!retention)
+            return { wiped: 0, deleted: 0 };
+        const now = new Date().toISOString();
+        let wiped = 0;
+        let deleted = 0;
+        try {
+            while (!abort()) {
+                const batch = await this.deps.store.pruneBatch(now, retention.deliveredDays, retention.ledgerDays, PRUNE_BATCH);
+                wiped += batch.wiped;
+                deleted += batch.deleted;
+                this.hooks.emit('prune', { wiped: batch.wiped, deleted: batch.deleted });
+                if (batch.wiped === 0 && batch.deleted === 0)
+                    break;
+                await sleep(PRUNE_YIELD_MS);
+            }
+            if (wiped || deleted)
+                this.log.info('retention prune', { wiped, deleted });
+        }
+        catch (err) {
+            this.log.error('retention prune failed', { error: err.message });
+            this.hooks.emit('error', { kind: 'prune', error: err });
+            throw err;
+        }
+        return { wiped, deleted };
+    }
+    async releaseLeftover(claimed, error) {
+        const ids = claimed.map((e) => e.id);
+        try {
+            const n = await this.deps.store.releaseDelivering(ids, new Date().toISOString(), error);
+            if (n > 0) {
+                this.log.warn('released leftover delivering events', { count: n, error });
+            }
+        }
+        catch (err) {
+            this.reclaimOwner = this.deps.instanceId;
+            this.log.error('failed to release leftover delivering events', {
+                error: err.message,
+                count: ids.length,
+            });
+            this.hooks.emit('error', { kind: 'recover_delivering', error: err });
+        }
+    }
+}
+function extResultKey(event, index) {
+    // Result rows may be keyed by external_id or by index depending on API version.
+    const externalId = event.event_id.includes(':')
+        ? event.event_id.slice(event.event_id.indexOf(':') + 1)
+        : event.event_id;
+    return { externalId, index: String(index) };
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/forward/dispatcher.js.map

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

package/dist/forward/endclose-client.d.ts

@@ -0,0 +1,42 @@
+import type { EndCloseRecord } from './mapper.js';
+export interface BulkRequestSummary {
+    id: string;
+    status: string;
+    total_items?: number;
+    failed_items?: number;
+    skipped_items?: number;
+}
+export interface BulkResultItem {
+    index?: number;
+    external_id?: string;
+    status: string;
+    error?: string;
+}
+export declare class TransientHttpError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+export declare class PermanentHttpError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(message: string, status: number, body: string);
+}
+export declare class EndCloseClient {
+    private baseUrl;
+    private apiKey;
+    private fetchImpl;
+    constructor(baseUrl: string, apiKey: string, fetchImpl?: typeof fetch);
+    /** Deterministic per-batch idempotency key so a retried POST returns the original bulk request. */
+    static idempotencyKey(records: EndCloseRecord[]): string;
+    bulkCreateRecords(records: EndCloseRecord[]): Promise<BulkRequestSummary>;
+    getBulkRequest(id: string): Promise<BulkRequestSummary & {
+        results?: BulkResultItem[];
+    }>;
+    /** Operational call-home. Failures must never affect ingest or dispatch. */
+    postRelayEvent(event: {
+        name: string;
+        properties: Record<string, unknown>;
+    }): Promise<void>;
+    private request;
+}
+//# sourceMappingURL=endclose-client.d.ts.map

package/dist/forward/endclose-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endclose-client.d.ts","sourceRoot":"","sources":["../../src/forward/endclose-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;gBADxB,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,MAAM,YAAA;CAI3B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAGzC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAFrB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;CAIxB;AAID,qBAAa,cAAc;IAEvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,SAAS;gBAFT,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,OAAO,KAAa;IAGzC,mGAAmG;IACnG,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM;IAMlD,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOzE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG;QAAE,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;IAM9F,4EAA4E;IACtE,cAAc,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAInF,OAAO;CA8BtB"}

package/dist/forward/endclose-client.js

@@ -0,0 +1,76 @@
+import { createHash } from 'node:crypto';
+export class TransientHttpError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+    }
+}
+export class PermanentHttpError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+    }
+}
+const TRANSIENT_STATUSES = new Set([408, 429, 500, 502, 503, 504]);
+export class EndCloseClient {
+    baseUrl;
+    apiKey;
+    fetchImpl;
+    constructor(baseUrl, apiKey, fetchImpl = fetch) {
+        this.baseUrl = baseUrl;
+        this.apiKey = apiKey;
+        this.fetchImpl = fetchImpl;
+    }
+    /** Deterministic per-batch idempotency key so a retried POST returns the original bulk request. */
+    static idempotencyKey(records) {
+        const h = createHash('sha256');
+        for (const r of records)
+            h.update(`${r.data_stream_key}:${r.external_id}\n`);
+        return 'relay-' + h.digest('hex').slice(0, 40);
+    }
+    async bulkCreateRecords(records) {
+        return this.request('POST', '/records/bulk', {
+            idempotencyKey: EndCloseClient.idempotencyKey(records),
+            body: { on_conflict: 'skip', records },
+        });
+    }
+    async getBulkRequest(id) {
+        return this.request('GET', `/bulk_requests/${id}`, {});
+    }
+    /** Operational call-home. Failures must never affect ingest or dispatch. */
+    async postRelayEvent(event) {
+        await this.request('POST', '/relays/events', { body: event, timeoutMs: 5_000 });
+    }
+    async request(method, path, opts) {
+        const headers = {
+            'X-API-KEY': this.apiKey,
+            'Content-Type': 'application/json',
+        };
+        if (opts.idempotencyKey)
+            headers['Idempotency-Key'] = opts.idempotencyKey;
+        let res;
+        try {
+            res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+                method,
+                headers,
+                body: opts.body === undefined ? null : JSON.stringify(opts.body),
+                signal: AbortSignal.timeout(opts.timeoutMs ?? 30_000),
+            });
+        }
+        catch (err) {
+            throw new TransientHttpError(`network error: ${err.message}`);
+        }
+        const text = await res.text();
+        if (res.ok)
+            return text ? JSON.parse(text) : {};
+        if (TRANSIENT_STATUSES.has(res.status)) {
+            throw new TransientHttpError(`HTTP ${res.status}`, res.status);
+        }
+        throw new PermanentHttpError(`HTTP ${res.status}`, res.status, text.slice(0, 500));
+    }
+}
+//# sourceMappingURL=endclose-client.js.map

package/dist/forward/endclose-client.js.map

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

package/dist/forward/enrich.d.ts

@@ -0,0 +1,39 @@
+import type { Json } from '../mask/paths.js';
+export interface EnrichContext {
+    routeId: string;
+    /** The route's processor adapter name, e.g. "payabli". */
+    source: string;
+    /** Adapter-derived id, e.g. "ApprovedPayment:txn_1" (or "sha256:…" when unknown). */
+    eventId: string;
+    eventType: string | null;
+    receivedAt: string;
+    /** Output field being computed: "metadata.<key>" or "description". */
+    field: string;
+    /** The decrypted webhook payload, for inputs beyond the `source` value. */
+    payload: Json;
+}
+/**
+ * Compute the value for one enriched field from the value at its `source` (after any
+ * transforms). Return `undefined` to omit the field and still send the record. Throw to
+ * retry the whole event later with backoff (the host's database was unavailable); throw
+ * `EnrichmentError` to park it instead (the input is bad and a retry cannot help).
+ */
+export type Enrichment = (input: Json, ctx: EnrichContext) => Json | undefined | Promise<Json | undefined>;
+/** Enrichment cannot be applied to this event. Parks the event; never retried. */
+export declare class EnrichmentError extends Error {
+}
+export declare class EnrichTimeoutError extends Error {
+}
+/**
+ * Check what an enrichment returned before it may enter a record: JSON only (no
+ * undefined-in-objects, functions, NaN, class instances), no sensitive key names at any
+ * depth, and the hard denylist applied to every string. `undefined` means "omit".
+ */
+export declare function validateEnrichedValue(value: unknown, field: string): Json | undefined;
+/**
+ * Run a host callback under a deadline. A synchronous throw becomes a rejection; the timer
+ * is cleared on settle so it never keeps the process alive. A timed-out call is abandoned,
+ * not cancelled: hosts must treat enrichments as reads that may run more than once.
+ */
+export declare function withTimeout<T>(run: () => T | Promise<T>, ms: number): Promise<T>;
+//# sourceMappingURL=enrich.d.ts.map

package/dist/forward/enrich.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich.d.ts","sourceRoot":"","sources":["../../src/forward/enrich.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAO5C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAA;IACd,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,OAAO,EAAE,IAAI,CAAA;CACd;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAA;AAE1G,kFAAkF;AAClF,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAwChD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAIrF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAgBhF"}