@end-close/relay 0.12.0

package/dist/engine/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/engine/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,UAAU,EACX,MAAM,YAAY,CAAA;AASnB,qBAAa,gBAAiB,YAAW,UAAU,EAAE,eAAe;IAClE,OAAO,CAAC,IAAI,CAAiC;IAC7C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,MAAM,CAAI;IAEZ,MAAM,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;IAkB1C,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMnD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAc3F,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9F,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9E,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcvF,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe/D,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3D,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAsBhF,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAKrD,IAAI,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQ/F,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAMhD,aAAa,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAkBtC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOpC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAUxC,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,UAAU;CAInB;AAED,wBAAgB,WAAW,IAAI,gBAAgB,CAE9C"}

package/dist/engine/memory-store.js

@@ -0,0 +1,205 @@
+// In-process EventStore for development, tests and single-process experiments. Not
+// durable: everything is lost when the process exits. It is the reference semantics for
+// the store contract (see the contract test suite).
+const DUE = ['pending', 'retry'];
+const TERMINAL = ['delivered', 'dropped_by_filter'];
+export class MemoryEventStore {
+    rows = new Map();
+    byKey = new Map();
+    nextId = 1;
+    async insert(e) {
+        if (this.byKey.has(e.idempotency_key))
+            return { duplicate: true };
+        const id = String(this.nextId++);
+        this.rows.set(id, {
+            ...e,
+            id,
+            attempts: 0,
+            next_attempt_at: e.received_at,
+            delivered_at: null,
+            bulk_request_id: null,
+            last_error: null,
+            claimed_by: null,
+            lease_until: null,
+        });
+        this.byKey.set(e.idempotency_key, id);
+        return { duplicate: false, id };
+    }
+    async routesWithDueEvents(now) {
+        const out = new Set();
+        for (const r of this.rows.values())
+            if (this.isDue(r, now))
+                out.add(r.route_id);
+        return [...out];
+    }
+    async claimDue(routeId, now, limit, lease) {
+        const due = [...this.rows.values()]
+            // Map iteration is insertion order, and ids are assigned in insertion order.
+            .filter((r) => r.route_id === routeId && this.isDue(r, now))
+            .slice(0, limit);
+        for (const r of due) {
+            r.status = 'delivering';
+            r.next_attempt_at = now;
+            r.claimed_by = lease.owner;
+            r.lease_until = lease.until;
+        }
+        return due.map((r) => ({ ...r }));
+    }
+    async markDelivered(ids, deliveredAt, bulkRequestId) {
+        for (const r of this.pick(ids)) {
+            r.status = 'delivered';
+            r.delivered_at = deliveredAt;
+            r.bulk_request_id = bulkRequestId;
+            r.last_error = null;
+            this.clearLease(r);
+        }
+    }
+    async markFailed(ids, nextAttemptAt, error) {
+        for (const r of this.pick(ids)) {
+            r.status = 'retry';
+            r.attempts += 1;
+            r.next_attempt_at = nextAttemptAt;
+            r.last_error = error.slice(0, 500);
+            this.clearLease(r);
+        }
+    }
+    async markParked(ids, error) {
+        for (const r of this.pick(ids)) {
+            r.status = 'parked';
+            r.last_error = error.slice(0, 500);
+            this.clearLease(r);
+        }
+    }
+    async releaseDelivering(ids, nextAttemptAt, error) {
+        let n = 0;
+        for (const r of this.pick(ids)) {
+            if (r.status !== 'delivering')
+                continue;
+            r.status = 'retry';
+            r.attempts += 1;
+            r.next_attempt_at = nextAttemptAt;
+            r.last_error = error.slice(0, 500);
+            this.clearLease(r);
+            n++;
+        }
+        return n;
+    }
+    async recoverDelivering(now, owner) {
+        let n = 0;
+        for (const r of this.rows.values()) {
+            if (r.status !== 'delivering')
+                continue;
+            const mine = owner !== undefined && r.claimed_by === owner;
+            if (r.lease_until === null || r.lease_until < now || mine) {
+                r.status = 'retry';
+                r.next_attempt_at = now;
+                this.clearLease(r);
+                n++;
+            }
+        }
+        return n;
+    }
+    async parkExpired(now, maxAgeMs) {
+        const cutoff = new Date(Date.parse(now) - maxAgeMs).toISOString();
+        let n = 0;
+        for (const r of this.rows.values()) {
+            if (r.status === 'retry' && r.received_at < cutoff) {
+                r.status = 'parked';
+                r.last_error = 'retry window exhausted';
+                n++;
+            }
+        }
+        return n;
+    }
+    async pruneBatch(now, deliveredDays, ledgerDays, limit) {
+        const wipeCutoff = new Date(Date.parse(now) - deliveredDays * 86_400_000).toISOString();
+        const deleteCutoff = new Date(Date.parse(now) - ledgerDays * 86_400_000).toISOString();
+        const terminal = [...this.rows.values()].filter((r) => TERMINAL.includes(r.status));
+        const toWipe = terminal.filter((r) => r.received_at < wipeCutoff && r.payload.length > 0).slice(0, limit);
+        if (toWipe.length > 0) {
+            for (const r of toWipe) {
+                r.payload = Buffer.alloc(0);
+                r.payload_iv = null;
+                r.headers_json = '{}';
+            }
+            return { wiped: toWipe.length, deleted: 0 };
+        }
+        const toDelete = terminal.filter((r) => r.received_at < deleteCutoff).slice(0, limit);
+        for (const r of toDelete) {
+            this.rows.delete(r.id);
+            this.byKey.delete(r.idempotency_key);
+        }
+        return { wiped: 0, deleted: toDelete.length };
+    }
+    // ── admin ──
+    async getById(id) {
+        const r = this.rows.get(id);
+        return r ? { ...r } : undefined;
+    }
+    async list(filter) {
+        return [...this.rows.values()]
+            .filter((r) => (!filter.status || r.status === filter.status) && (!filter.route || r.route_id === filter.route))
+            .sort((a, b) => Number(b.id) - Number(a.id))
+            .slice(0, filter.limit ?? 50)
+            .map(({ payload: _p, payload_iv: _iv, headers_json: _h, idempotency_key: _k, claimed_by: _c, lease_until: _l, ...rest }) => rest);
+    }
+    async countByStatus() {
+        const out = {};
+        for (const r of this.rows.values())
+            out[r.status] = (out[r.status] ?? 0) + 1;
+        return out;
+    }
+    async perRouteStats() {
+        const byRoute = new Map();
+        for (const r of this.rows.values()) {
+            const s = byRoute.get(r.route_id) ??
+                { route_id: r.route_id, counts: {}, last_delivered_at: null, oldest_pending_at: null };
+            s.counts[r.status] = (s.counts[r.status] ?? 0) + 1;
+            if (r.delivered_at && (!s.last_delivered_at || r.delivered_at > s.last_delivered_at)) {
+                s.last_delivered_at = r.delivered_at;
+            }
+            if (DUE.includes(r.status) && (!s.oldest_pending_at || r.received_at < s.oldest_pending_at)) {
+                s.oldest_pending_at = r.received_at;
+            }
+            byRoute.set(r.route_id, s);
+        }
+        return [...byRoute.values()];
+    }
+    async replay(id) {
+        const r = this.rows.get(id);
+        if (!r || r.status !== 'parked')
+            return false;
+        this.requeue(r);
+        return true;
+    }
+    async replayAllParked() {
+        let n = 0;
+        for (const r of this.rows.values()) {
+            if (r.status !== 'parked')
+                continue;
+            this.requeue(r);
+            n++;
+        }
+        return n;
+    }
+    requeue(r) {
+        r.status = 'retry';
+        r.attempts = 0;
+        r.next_attempt_at = new Date().toISOString();
+        r.last_error = null;
+    }
+    isDue(r, now) {
+        return DUE.includes(r.status) && r.next_attempt_at !== null && r.next_attempt_at <= now;
+    }
+    pick(ids) {
+        return ids.map((id) => this.rows.get(id)).filter((r) => r !== undefined);
+    }
+    clearLease(r) {
+        r.claimed_by = null;
+        r.lease_until = null;
+    }
+}
+export function memoryStore() {
+    return new MemoryEventStore();
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/engine/memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../../src/engine/memory-store.ts"],"names":[],"mappings":"AAYA,mFAAmF;AACnF,wFAAwF;AACxF,oDAAoD;AAEpD,MAAM,GAAG,GAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;AAC/C,MAAM,QAAQ,GAAkB,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAA;AAElE,MAAM,OAAO,gBAAgB;IACnB,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAA;IACrC,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACjC,MAAM,GAAG,CAAC,CAAA;IAElB,KAAK,CAAC,MAAM,CAAC,CAAW;QACtB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;QACjE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;YAChB,GAAG,CAAC;YACJ,EAAE;YACF,QAAQ,EAAE,CAAC;YACX,eAAe,EAAE,CAAC,CAAC,WAAW;YAC9B,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI;YACrB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAA;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;QACrC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IACjC,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,GAAW;QACnC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAA;QAC7B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;QAC/E,OAAO,CAAC,GAAG,GAAG,CAAC,CAAA;IACjB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,GAAW,EAAE,KAAa,EAAE,KAAY;QACtE,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,6EAA6E;aAC5E,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aAC3D,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;QAClB,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,CAAC,CAAC,MAAM,GAAG,YAAY,CAAA;YACvB,CAAC,CAAC,eAAe,GAAG,GAAG,CAAA;YACvB,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,KAAK,CAAA;YAC1B,CAAC,CAAC,WAAW,GAAG,KAAK,CAAC,KAAK,CAAA;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACnC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAa,EAAE,WAAmB,EAAE,aAA4B;QAClF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,CAAC,CAAC,MAAM,GAAG,WAAW,CAAA;YACtB,CAAC,CAAC,YAAY,GAAG,WAAW,CAAA;YAC5B,CAAC,CAAC,eAAe,GAAG,aAAa,CAAA;YACjC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAA;YACnB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAa,EAAE,aAAqB,EAAE,KAAa;QAClE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,CAAC,CAAC,MAAM,GAAG,OAAO,CAAA;YAClB,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAA;YACf,CAAC,CAAC,eAAe,GAAG,aAAa,CAAA;YACjC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YAClC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAa,EAAE,KAAa;QAC3C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAA;YACnB,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YAClC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,GAAa,EAAE,aAAqB,EAAE,KAAa;QACzE,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY;gBAAE,SAAQ;YACvC,CAAC,CAAC,MAAM,GAAG,OAAO,CAAA;YAClB,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAA;YACf,CAAC,CAAC,eAAe,GAAG,aAAa,CAAA;YACjC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YAClC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;YAClB,CAAC,EAAE,CAAA;QACL,CAAC;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,GAAW,EAAE,KAAc;QACjD,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,CAAC,MAAM,KAAK,YAAY;gBAAE,SAAQ;YACvC,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,KAAK,CAAA;YAC1D,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI,IAAI,CAAC,CAAC,WAAW,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;gBAC1D,CAAC,CAAC,MAAM,GAAG,OAAO,CAAA;gBAClB,CAAC,CAAC,eAAe,GAAG,GAAG,CAAA;gBACvB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;gBAClB,CAAC,EAAE,CAAA;YACL,CAAC;QACH,CAAC;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,QAAgB;QAC7C,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QACjE,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,WAAW,GAAG,MAAM,EAAE,CAAC;gBACnD,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAA;gBACnB,CAAC,CAAC,UAAU,GAAG,wBAAwB,CAAA;gBACvC,CAAC,EAAE,CAAA;YACL,CAAC;QACH,CAAC;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,aAAqB,EAAE,UAAkB,EAAE,KAAa;QACpF,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,aAAa,GAAG,UAAU,CAAC,CAAC,WAAW,EAAE,CAAA;QACvF,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC,WAAW,EAAE,CAAA;QACtF,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;QACnF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,UAAU,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;QACzG,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;gBAC3B,CAAC,CAAC,UAAU,GAAG,IAAI,CAAA;gBACnB,CAAC,CAAC,YAAY,GAAG,IAAI,CAAA;YACvB,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,CAAA;QAC7C,CAAC;QACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;QACrF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;YACtB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAA;QACtC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;IAC/C,CAAC;IAED,cAAc;IACd,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAgE;QACzE,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;aAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;aAC/G,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aAC3C,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;aAC5B,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IACrI,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,GAAG,GAA2B,EAAE,CAAA;QACtC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;QAC5E,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAA;QAC7C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,MAAM,CAAC,GACL,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;gBACtB,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAiB,CAAA;YACxG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;YAClD,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACrF,CAAC,CAAC,iBAAiB,GAAG,CAAC,CAAC,YAAY,CAAA;YACtC,CAAC;YACD,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBAC5F,CAAC,CAAC,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAA;YACrC,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;QAC5B,CAAC;QACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC3B,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAA;QAC7C,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QACf,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;gBAAE,SAAQ;YACnC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;YACf,CAAC,EAAE,CAAA;QACL,CAAC;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAEO,OAAO,CAAC,CAAc;QAC5B,CAAC,CAAC,MAAM,GAAG,OAAO,CAAA;QAClB,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAA;QACd,CAAC,CAAC,eAAe,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC5C,CAAC,CAAC,UAAU,GAAG,IAAI,CAAA;IACrB,CAAC;IAEO,KAAK,CAAC,CAAc,EAAE,GAAW;QACvC,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,KAAK,IAAI,IAAI,CAAC,CAAC,eAAe,IAAI,GAAG,CAAA;IACzF,CAAC;IAEO,IAAI,CAAC,GAAa;QACxB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAA;IAC5F,CAAC;IAEO,UAAU,CAAC,CAAc;QAC/B,CAAC,CAAC,UAAU,GAAG,IAAI,CAAA;QACnB,CAAC,CAAC,WAAW,GAAG,IAAI,CAAA;IACtB,CAAC;CACF;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,gBAAgB,EAAE,CAAA;AAC/B,CAAC"}

package/dist/engine/relay.d.ts

@@ -0,0 +1,116 @@
+import { type RouteConfig } from '../config/schema.js';
+import { EndCloseClient } from '../forward/endclose-client.js';
+import { type DispatchCounts } from '../forward/dispatcher.js';
+import type { Enrichment } from '../forward/enrich.js';
+import { type MappedEvent } from '../forward/mapper.js';
+import type { ProcessorAdapter, RawRequest } from '../ingest/adapters/types.js';
+import type { Json } from '../mask/paths.js';
+import { type Logger } from '../logger.js';
+import { RelayHooks, type RelayEventName, type RelayHandler } from './hooks.js';
+import { type IngestResult } from './ingest.js';
+import { type SecretResolver } from './secrets.js';
+import { type DispatchSettings, type RetentionSettings } from './settings.js';
+import { type ControlStore, type EventStore, type RouteProvider } from './store.js';
+export interface RelayOptions {
+    /** Route definitions: the same shape as the `routes` block of relay.yaml. */
+    routes: RouteConfig[] | RouteProvider;
+    store: EventStore;
+    /** Killswitch and per-route pause state. Default: in-memory, nothing paused. */
+    control?: ControlStore;
+    /** Where `auth.secret_env` references resolve. */
+    secrets: SecretResolver | Record<string, string>;
+    endclose: {
+        apiKey: string;
+        baseUrl?: string;
+        fetch?: typeof fetch;
+    };
+    /** Explicit: encrypt buffered payloads at rest under this key, or store them as-is. */
+    encryption: {
+        dataKey: string | Buffer;
+    } | 'none';
+    /** Keys the deterministic `hash` transform. Never leaves the host. */
+    maskingKey: string | Buffer;
+    dispatch?: Partial<DispatchSettings>;
+    /** `false` disables retention pruning entirely. */
+    retention?: Partial<RetentionSettings> | false;
+    /** Default: silent. */
+    logger?: Logger | null;
+    /** Additional processor adapters keyed by route `source`. */
+    adapters?: Record<string, ProcessorAdapter>;
+    /**
+     * Host functions a route's map may name with `enrich: <name>` on `description` or a
+     * `metadata` entry. Each runs in-process per event after mapping, receives the value at
+     * that field's `source`, and returns what is forwarded (validated like any mapped value).
+     * Throw to retry the event with backoff; throw `EnrichmentError` to park it; return
+     * `undefined` to omit the field. Bounded by `dispatch.enrichTimeoutMs` per call.
+     */
+    enrichments?: Record<string, Enrichment>;
+    /** Lease owner for claimed batches. Give each long-lived replica a stable id. */
+    instanceId?: string;
+    hooks?: RelayHooks;
+    /** Supply a pre-built client (the application shares one with telemetry). */
+    client?: EndCloseClient;
+}
+export type DispatchOnceResult = DispatchCounts;
+export interface FlushResult extends DispatchOnceResult {
+    /** True when nothing deliverable remained when flush returned. */
+    drained: boolean;
+    /**
+     * Why flush stopped early: the deadline passed, forwarding is paused (killswitch or
+     * every due route), or due events belong to routes the provider no longer knows.
+     */
+    reason?: 'timeout' | 'paused' | 'unroutable';
+}
+export interface Relay {
+    /** Framework-agnostic webhook entrypoint. */
+    ingest(routeId: string, req: RawRequest): Promise<IngestResult>;
+    /** Start the background dispatch loop (long-lived processes). */
+    start(): void;
+    /** Stop the loop and drain in-flight work. */
+    stop(): Promise<void>;
+    /** Run one dispatch cycle (cron / serverless / tests). */
+    dispatchOnce(opts?: {
+        prune?: boolean;
+    }): Promise<DispatchOnceResult>;
+    /**
+     * Run dispatch cycles until nothing deliverable remains or `timeoutMs` (default 30 s)
+     * passes, retrying as backoff timers expire. Returns immediately if forwarding is
+     * paused. Events still `retried` when it returns need a later cycle or a durable store.
+     */
+    flush(opts?: {
+        timeoutMs?: number;
+    }): Promise<FlushResult>;
+    /** Run retention pruning to completion. */
+    prune(): Promise<{
+        wiped: number;
+        deleted: number;
+    }>;
+    /**
+     * Map a sample payload through a route without storing or sending anything. Enrichments
+     * are not run: their fields are listed in `report.enriched` and `pending`.
+     */
+    preview(route: RouteConfig, sample: Json, receivedAt?: string): MappedEvent;
+    /** Decode a buffered payload. Sensitive: the caller is responsible for auditing. */
+    readPayload(id: string): Promise<Buffer | undefined>;
+    on<E extends RelayEventName>(name: E, handler: RelayHandler<E>): () => void;
+    readonly store: EventStore;
+    readonly control: ControlStore;
+}
+/** Reject routes whose `source` has no adapter (built-in or host-registered). */
+export declare function assertKnownSources(routes: RouteConfig[], adapters?: Record<string, ProcessorAdapter>): void;
+/** Every `enrich:` reference in a route's map, as [field, enrichment name]. */
+export declare function routeEnrichments(route: RouteConfig): [field: string, enrichment: string][];
+/** Reject routes whose map names an enrichment the host has not registered. */
+export declare function assertKnownEnrichments(routes: RouteConfig[], enrichments?: Record<string, unknown>): void;
+/**
+ * Validate a routes document (parsed YAML or a plain object) into RouteConfig[]. Applies
+ * defaults, the hard-denylist check on metadata names, duplicate-id, unknown-source and
+ * unknown-enrichment checks. Pass the host's extra adapters and enrichments so routes
+ * that use them validate too; with none registered, any `enrich:` reference is rejected.
+ */
+export declare function parseRoutes(doc: unknown, opts?: {
+    adapters?: Record<string, ProcessorAdapter>;
+    enrichments?: Record<string, unknown>;
+}): RouteConfig[];
+export declare function createRelay(opts: RelayOptions): Relay;
+//# sourceMappingURL=relay.d.ts.map

package/dist/engine/relay.d.ts.map

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

package/dist/engine/relay.js

@@ -0,0 +1,180 @@
+import { EventEmitter } from 'node:events';
+import { randomUUID } from 'node:crypto';
+import { refEnrichment, relayConfigSchema } from '../config/schema.js';
+import { deriveKey } from '../crypto/keys.js';
+import { EndCloseClient } from '../forward/endclose-client.js';
+import { Dispatcher } from '../forward/dispatcher.js';
+import { mapEvent } from '../forward/mapper.js';
+import { hasAdapter } from '../ingest/adapters/registry.js';
+import { noopLogger } from '../logger.js';
+import { sleep } from '../util/strings.js';
+import { aesGcmCodec, plainCodec } from './codec.js';
+import { RelayHooks } from './hooks.js';
+import { ingestWebhook } from './ingest.js';
+import { toSecretResolver } from './secrets.js';
+import { DEFAULT_DISPATCH, DEFAULT_RETENTION, } from './settings.js';
+import { hasAdmin, MemoryControlStore, staticRoutes, } from './store.js';
+function toKey(name, v) {
+    if (typeof v === 'string')
+        return deriveKey(name, v);
+    if (v.length !== 32)
+        throw new Error(`${name} must be a 32-byte Buffer or a string of 16+ chars`);
+    return v;
+}
+/** Reject routes whose `source` has no adapter (built-in or host-registered). */
+export function assertKnownSources(routes, adapters) {
+    for (const r of routes) {
+        if (!hasAdapter(r.source, adapters)) {
+            throw new Error(`route ${r.id}: no adapter for source "${r.source}"`);
+        }
+    }
+}
+/** Every `enrich:` reference in a route's map, as [field, enrichment name]. */
+export function routeEnrichments(route) {
+    const out = [];
+    const desc = route.map.description === undefined ? undefined : refEnrichment(route.map.description);
+    if (desc !== undefined)
+        out.push(['description', desc]);
+    for (const [key, ref] of Object.entries(route.map.metadata)) {
+        const name = refEnrichment(ref);
+        if (name !== undefined)
+            out.push([`metadata.${key}`, name]);
+    }
+    return out;
+}
+/** Reject routes whose map names an enrichment the host has not registered. */
+export function assertKnownEnrichments(routes, enrichments) {
+    for (const r of routes) {
+        for (const [field, name] of routeEnrichments(r)) {
+            if (!enrichments || !Object.hasOwn(enrichments, name)) {
+                throw new Error(`route ${r.id}: ${field} references unknown enrichment "${name}"`);
+            }
+        }
+    }
+}
+/**
+ * Validate a routes document (parsed YAML or a plain object) into RouteConfig[]. Applies
+ * defaults, the hard-denylist check on metadata names, duplicate-id, unknown-source and
+ * unknown-enrichment checks. Pass the host's extra adapters and enrichments so routes
+ * that use them validate too; with none registered, any `enrich:` reference is rejected.
+ */
+export function parseRoutes(doc, opts = {}) {
+    const config = relayConfigSchema.parse(doc);
+    const seen = new Set();
+    for (const route of config.routes) {
+        if (seen.has(route.id))
+            throw new Error(`duplicate route id: ${route.id}`);
+        seen.add(route.id);
+    }
+    assertKnownSources(config.routes, opts.adapters);
+    assertKnownEnrichments(config.routes, opts.enrichments);
+    return config.routes;
+}
+const FLUSH_POLL_MIN_MS = 50;
+const FLUSH_POLL_MAX_MS = 1000;
+// Asking for "due" events at this time returns every route holding pending/retry rows.
+const FAR_FUTURE = '9999-12-31T23:59:59.999Z';
+export function createRelay(opts) {
+    if (Array.isArray(opts.routes)) {
+        assertKnownSources(opts.routes, opts.adapters);
+        assertKnownEnrichments(opts.routes, opts.enrichments);
+    }
+    const routes = Array.isArray(opts.routes) ? staticRoutes(opts.routes) : opts.routes;
+    const control = opts.control ?? new MemoryControlStore();
+    const secrets = toSecretResolver(opts.secrets);
+    const logger = opts.logger ?? noopLogger;
+    const hooks = opts.hooks ?? new RelayHooks();
+    const codec = opts.encryption === 'none' ? plainCodec : aesGcmCodec(toKey('dataKey', opts.encryption.dataKey));
+    const maskingKey = toKey('maskingKey', opts.maskingKey);
+    const client = opts.client ??
+        new EndCloseClient(opts.endclose.baseUrl ?? 'https://api.endclose.com/v1', opts.endclose.apiKey, opts.endclose.fetch ?? fetch);
+    const dispatch = { ...DEFAULT_DISPATCH, ...opts.dispatch };
+    const retention = opts.retention === false ? null : { ...DEFAULT_RETENTION, ...opts.retention };
+    const signal = new EventEmitter();
+    const { store } = opts;
+    const ingestDeps = {
+        store,
+        control,
+        routes,
+        secrets,
+        codec,
+        signal,
+        hooks,
+        logger,
+        ...(opts.adapters ? { adapters: opts.adapters } : {}),
+    };
+    const dispatcher = new Dispatcher({
+        store,
+        control,
+        routes,
+        dispatch,
+        retention,
+        client,
+        codec,
+        maskingKey,
+        instanceId: opts.instanceId ?? randomUUID(),
+        signal,
+        hooks,
+        logger,
+        ...(opts.enrichments ? { enrichments: opts.enrichments } : {}),
+    });
+    const dispatchOnce = async (o = {}) => {
+        const { delivered, retried, parked } = await dispatcher.runOnce();
+        if (o.prune)
+            await dispatcher.pruneNow();
+        return { delivered, retried, parked };
+    };
+    const flush = async ({ timeoutMs = 30_000 } = {}) => {
+        const deadline = Date.now() + timeoutMs;
+        const totals = { delivered: 0, retried: 0, parked: 0, drained: false };
+        let pollMs = FLUSH_POLL_MIN_MS;
+        for (;;) {
+            const c = await dispatcher.runOnce();
+            totals.delivered += c.delivered;
+            totals.retried += c.retried;
+            totals.parked += c.parked;
+            if (c.halted)
+                return { ...totals, reason: 'paused' };
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                return { ...totals, reason: 'timeout' };
+            const touched = c.delivered + c.retried + c.parked;
+            if (touched > 0)
+                continue; // there may be more than one batch's worth; go straight back
+            const backlog = await store.routesWithDueEvents(FAR_FUTURE);
+            if (backlog.length === 0)
+                return { ...totals, drained: true };
+            // Backlog confined to routes the cycle deliberately skipped will not clear on its
+            // own. Anything else is waiting on a backoff timer.
+            const skipped = new Map(c.skipped.map((s) => [s.routeId, s.reason]));
+            if (backlog.every((r) => skipped.has(r))) {
+                const allPaused = backlog.every((r) => skipped.get(r) === 'paused');
+                return { ...totals, reason: allPaused ? 'paused' : 'unroutable' };
+            }
+            await sleep(Math.min(pollMs, remaining));
+            pollMs = Math.min(pollMs * 2, FLUSH_POLL_MAX_MS);
+        }
+    };
+    const readPayload = async (id) => {
+        if (!hasAdmin(store))
+            throw new Error('store does not support inspection (EventStoreAdmin)');
+        const row = await store.getById(id);
+        if (!row || row.payload.length === 0)
+            return undefined;
+        return codec.decode(row.payload, row.payload_iv);
+    };
+    return {
+        ingest: (routeId, req) => ingestWebhook(ingestDeps, routeId, req),
+        start: () => dispatcher.start(),
+        stop: () => dispatcher.stop(),
+        dispatchOnce,
+        flush,
+        prune: () => dispatcher.pruneNow(),
+        preview: (route, sample, receivedAt = new Date().toISOString()) => mapEvent(route, sample, receivedAt, maskingKey),
+        readPayload,
+        on: (name, handler) => hooks.on(name, handler),
+        store,
+        control,
+    };
+}
+//# sourceMappingURL=relay.js.map

package/dist/engine/relay.js.map

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

package/dist/engine/secrets.d.ts

@@ -0,0 +1,18 @@
+export interface SecretResolver {
+    /** The secret value for `ref`, or undefined when it is not available. */
+    resolve(ref: string): string | undefined;
+    /** Whether `ref` is currently available (defaults to `resolve(ref) !== undefined`). */
+    has?(ref: string): boolean;
+}
+export declare class SecretUnavailableError extends Error {
+    readonly ref: string;
+    constructor(ref: string);
+}
+/** Resolve from an environment-shaped record; empty strings count as unset. */
+export declare function envSecrets(env?: Record<string, string | undefined>): SecretResolver;
+export declare function staticSecrets(map: Record<string, string>): SecretResolver;
+export declare function toSecretResolver(s: SecretResolver | Record<string, string>): SecretResolver;
+export declare function hasSecret(resolver: SecretResolver, ref: string): boolean;
+/** Resolve or throw `SecretUnavailableError`. */
+export declare function requireSecret(resolver: SecretResolver, ref: string): string;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/engine/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/engine/secrets.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACxC,uFAAuF;IACvF,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM;CAGjC;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,cAAc,CAOhG;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,CAEzE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,CAI3F;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI3E"}

package/dist/engine/secrets.js

@@ -0,0 +1,42 @@
+// Secret resolution for the engine. Route configs reference secrets by NAME only (the
+// `secret_env` field); the host decides where the value comes from. The application uses the
+// process environment; an embedding application may use a static map loaded from its
+// secret manager at startup.
+//
+// Resolution is synchronous by design: it sits on the webhook verification hot path, and
+// secrets should be materialised once at boot rather than fetched per request.
+export class SecretUnavailableError extends Error {
+    ref;
+    constructor(ref) {
+        super(`missing required secret env var: ${ref}`);
+        this.ref = ref;
+    }
+}
+/** Resolve from an environment-shaped record; empty strings count as unset. */
+export function envSecrets(env = process.env) {
+    return {
+        resolve: (ref) => {
+            const v = env[ref];
+            return v ? v : undefined;
+        },
+    };
+}
+export function staticSecrets(map) {
+    return { resolve: (ref) => map[ref] };
+}
+export function toSecretResolver(s) {
+    return typeof s.resolve === 'function'
+        ? s
+        : staticSecrets(s);
+}
+export function hasSecret(resolver, ref) {
+    return resolver.has ? resolver.has(ref) : resolver.resolve(ref) !== undefined;
+}
+/** Resolve or throw `SecretUnavailableError`. */
+export function requireSecret(resolver, ref) {
+    const v = resolver.resolve(ref);
+    if (v === undefined)
+        throw new SecretUnavailableError(ref);
+    return v;
+}
+//# sourceMappingURL=secrets.js.map

package/dist/engine/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../src/engine/secrets.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,6FAA6F;AAC7F,qFAAqF;AACrF,6BAA6B;AAC7B,EAAE;AACF,yFAAyF;AACzF,+EAA+E;AAS/E,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC1B;IAArB,YAAqB,GAAW;QAC9B,KAAK,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAA;QAD7B,QAAG,GAAH,GAAG,CAAQ;IAEhC,CAAC;CACF;AAED,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,MAA0C,OAAO,CAAC,GAAG;IAC9E,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACf,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;YAClB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC1B,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAA2B;IACvD,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAA0C;IACzE,OAAO,OAAQ,CAAoB,CAAC,OAAO,KAAK,UAAU;QACxD,CAAC,CAAE,CAAoB;QACvB,CAAC,CAAC,aAAa,CAAC,CAA2B,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAwB,EAAE,GAAW;IAC7D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,CAAA;AAC/E,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,QAAwB,EAAE,GAAW;IACjE,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/B,IAAI,CAAC,KAAK,SAAS;QAAE,MAAM,IAAI,sBAAsB,CAAC,GAAG,CAAC,CAAA;IAC1D,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/engine/settings.d.ts

@@ -0,0 +1,29 @@
+export interface DispatchSettings {
+    /** Records per bulk POST. */
+    batchMax: number;
+    /** How often the loop wakes when idle (it also wakes immediately on ingest). */
+    pollIntervalMs: number;
+    backoffBaseMs: number;
+    backoffCapMs: number;
+    /** Retrying events park (never dropped) after this long. */
+    parkAfterMs: number;
+    /** How long a claimed batch is protected from recovery by other instances. */
+    leaseMs: number;
+    /** How often a running instance sweeps for expired leases left by crashed peers. */
+    recoverIntervalMs: number;
+    /**
+     * Upper bound on one `enrich` call. A slower call counts as a transient failure and the
+     * event retries with backoff. Enrichments run one at a time per event, so keep
+     * batchMax × (enrichments per event) × enrichTimeoutMs well under leaseMs.
+     */
+    enrichTimeoutMs: number;
+}
+export interface RetentionSettings {
+    /** Payloads of delivered/filtered events are wiped after this many days. */
+    deliveredDays: number;
+    /** Their rows (the idempotency ledger) are deleted after this many days. */
+    ledgerDays: number;
+}
+export declare const DEFAULT_DISPATCH: DispatchSettings;
+export declare const DEFAULT_RETENTION: RetentionSettings;
+//# sourceMappingURL=settings.d.ts.map

package/dist/engine/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/engine/settings.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAA;IACnB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAA;IACf,oFAAoF;IACpF,iBAAiB,EAAE,MAAM,CAAA;IACzB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAA;IACrB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,gBAAgB,EAAE,gBAS9B,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,iBAAwD,CAAA"}