@astriveone/plugin-queue 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import type { Plugin, ChangeEvent } from "@astriveone/core";
+export type JobHandler = (event: ChangeEvent) => Promise<void> | void;
+/**
+ * queuePlugin — an in-process job queue triggered by database writes, with
+ * retry-with-backoff. For multi-process workloads, swap the in-memory
+ * queue for Redis/SQS by implementing the same `enqueue`/processing loop
+ * against your broker of choice — this plugin defines the contract.
+ *
+ *   await db.use(queuePlugin({
+ *     concurrency: 4,
+ *     on: { orders: { insert: async (e) => sendToFulfillment(e.doc) } },
+ *   }));
+ */
+export declare function queuePlugin(options: {
+    concurrency?: number;
+    maxAttempts?: number;
+    on: Record<string, Partial<Record<ChangeEvent["type"], JobHandler>>>;
+}): Plugin;

package/dist/index.js

@@ -0,0 +1,58 @@
+/**
+ * queuePlugin — an in-process job queue triggered by database writes, with
+ * retry-with-backoff. For multi-process workloads, swap the in-memory
+ * queue for Redis/SQS by implementing the same `enqueue`/processing loop
+ * against your broker of choice — this plugin defines the contract.
+ *
+ *   await db.use(queuePlugin({
+ *     concurrency: 4,
+ *     on: { orders: { insert: async (e) => sendToFulfillment(e.doc) } },
+ *   }));
+ */
+export function queuePlugin(options) {
+    const concurrency = options.concurrency ?? 2;
+    const maxAttempts = options.maxAttempts ?? 3;
+    const queue = [];
+    let active = 0;
+    async function processNext() {
+        if (active >= concurrency)
+            return;
+        const job = queue.shift();
+        if (!job)
+            return;
+        active++;
+        try {
+            await job.handler(job.event);
+        }
+        catch (err) {
+            job.attempts++;
+            if (job.attempts < maxAttempts) {
+                setTimeout(() => {
+                    queue.push(job);
+                    processNext();
+                }, 2 ** job.attempts * 500); // exponential backoff
+            }
+            else {
+                console.error(`AstriveOne queue plugin: job failed permanently for ${job.event.collection}/${job.event.id}`, err);
+            }
+        }
+        finally {
+            active--;
+            processNext();
+        }
+    }
+    return {
+        name: "queue",
+        version: "1.0.0",
+        install(db) {
+            db.watchAll((event) => {
+                const handler = options.on[event.collection]?.[event.type];
+                if (!handler)
+                    return;
+                queue.push({ event, handler, attempts: 0 });
+                processNext();
+            });
+            db.queue = { pending: () => queue.length, active: () => active };
+        },
+    };
+}

package/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@astriveone/plugin-queue",
+  "version": "1.0.0",
+  "description": "AstriveOne queue plugin",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": { "build": "tsc -p tsconfig.json" },
+  "dependencies": { "@astriveone/core": "1.0.0" },
+  "files": ["dist"],
+  "license": "MIT"
+}