@critical-path/core 0.36.1 → 0.38.0

package/dist/webhooks/outbox.js

@@ -0,0 +1,74 @@
+/**
+ * A durable `WebhookDeliveryQueue`: jobs are written to a store and survive restarts. Delivery is
+ * at-least-once, so receivers should de-duplicate on `X-CriticalPath-Delivery`.
+ *
+ * ```ts
+ * const store = new SQLiteStore({ filename: 'app.db' });
+ * const outbox = new OutboxWebhookQueue(store);
+ * const engine = new CriticalPathEngine({ store, webhookDelivery: { queue: outbox } });
+ * outbox.start(); // or call outbox.processDue() from a cron job
+ * ```
+ */
+export class OutboxWebhookQueue {
+    store;
+    options;
+    deliver;
+    timer;
+    running;
+    constructor(store, options = {}) {
+        this.store = store;
+        this.options = options;
+    }
+    attach(deliver) {
+        this.deliver = deliver;
+    }
+    async enqueue(job, delayMs) {
+        await this.store.putWebhookJob({ key: `${job.id}:${job.attempt}`, job, runAt: Date.now() + delayMs });
+    }
+    /** Delivers every job that is due now, in batches. Returns how many jobs were attempted. */
+    async processDue() {
+        if (!this.deliver)
+            throw new Error('OutboxWebhookQueue is not attached; pass it as webhookDelivery.queue.');
+        const deliver = this.deliver;
+        const batchSize = this.options.batchSize ?? 20;
+        let attempted = 0;
+        for (;;) {
+            const entries = await this.store.claimWebhookJobs(Date.now(), batchSize, this.options.leaseMs ?? 60_000);
+            await Promise.all(entries.map(async (entry) => {
+                try {
+                    // `deliver` schedules any retry as a new entry before this one is removed.
+                    await deliver(entry.job);
+                    await this.store.deleteWebhookJob(entry.key);
+                }
+                catch (error) {
+                    // Leave the entry; it is claimed again when its lease expires.
+                    console.warn(`[CriticalPath Webhooks] Outbox delivery ${entry.key} failed:`, error);
+                }
+            }));
+            attempted += entries.length;
+            if (entries.length < batchSize)
+                return attempted;
+        }
+    }
+    /** Polls for due jobs until `stop()`. The timer does not keep the process alive. */
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            this.running ??= this.processDue()
+                .catch((error) => {
+                console.warn('[CriticalPath Webhooks] Outbox poll failed:', error);
+                return 0;
+            })
+                .finally(() => (this.running = undefined));
+        }, this.options.pollIntervalMs ?? 1_000);
+        this.timer.unref?.();
+    }
+    /** Stops polling and waits for the current batch to finish. */
+    async stop() {
+        clearInterval(this.timer);
+        this.timer = undefined;
+        await this.running;
+    }
+}
+//# sourceMappingURL=outbox.js.map

package/dist/webhooks/outbox.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@critical-path/core",
-  "version": "0.36.1",
+  "version": "0.38.0",
   "description": "Core headless domain engine, plugin architecture, and data stores for Critical Path",
   "author": "Jack James",
   "license": "MIT",