bunqueue 2.6.39 → 2.6.40

package/dist/infrastructure/cloud/httpSender.js

@@ -0,0 +1,100 @@
+/**
+ * HTTP Sender
+ * Posts snapshots to the remote dashboard via HTTP with retry and HMAC signing
+ */
+import { CircuitBreaker } from './circuitBreaker';
+import { SnapshotBuffer } from './buffer';
+import { cloudLog } from './logger';
+export class HttpSender {
+    config;
+    circuitBreaker;
+    buffer;
+    ingestUrl;
+    batchUrl;
+    hmacKey = null;
+    constructor(config) {
+        this.config = config;
+        this.circuitBreaker = new CircuitBreaker(config.circuitBreakerThreshold, config.circuitBreakerResetMs);
+        this.buffer = new SnapshotBuffer(config.bufferSize);
+        this.ingestUrl = `${config.url}/api/v1/ingest`;
+        this.batchUrl = `${config.url}/api/v1/ingest/batch`;
+    }
+    /** Send a snapshot. Buffers on failure. */
+    async send(snapshot) {
+        // Flush buffered snapshots first if any
+        if (!this.buffer.isEmpty) {
+            await this.flushBuffer();
+        }
+        if (!this.circuitBreaker.canExecute()) {
+            this.buffer.push(snapshot);
+            return;
+        }
+        try {
+            await this.post(this.ingestUrl, snapshot);
+            this.circuitBreaker.onSuccess();
+        }
+        catch (err) {
+            this.circuitBreaker.onFailure();
+            this.buffer.push(snapshot);
+            cloudLog.debug('Snapshot buffered', {
+                buffered: this.buffer.size,
+                circuit: this.circuitBreaker.getState(),
+                error: String(err),
+            });
+        }
+    }
+    /** Try to send buffered snapshots in batches */
+    async flushBuffer() {
+        if (!this.circuitBreaker.canExecute())
+            return;
+        while (!this.buffer.isEmpty) {
+            const batch = this.buffer.drain(50);
+            if (batch.length === 0)
+                break;
+            try {
+                await this.post(this.batchUrl, batch);
+                this.circuitBreaker.onSuccess();
+                cloudLog.debug('Buffer flushed', { sent: batch.length, remaining: this.buffer.size });
+            }
+            catch {
+                // Put items back (they'll be at the front, order is acceptable)
+                for (let i = batch.length - 1; i >= 0; i--) {
+                    this.buffer.push(batch[i]);
+                }
+                this.circuitBreaker.onFailure();
+                break;
+            }
+        }
+    }
+    /** HTTP POST with auth headers and optional HMAC */
+    async post(url, body) {
+        const json = JSON.stringify(body);
+        const headers = {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.config.apiKey}`,
+            'X-Timestamp': String(Date.now()),
+        };
+        if (this.config.signingSecret) {
+            this.hmacKey ??= await crypto.subtle.importKey('raw', new TextEncoder().encode(this.config.signingSecret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+            const sig = await crypto.subtle.sign('HMAC', this.hmacKey, new TextEncoder().encode(json));
+            headers['X-Signature'] = Buffer.from(sig).toString('hex');
+        }
+        const res = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: json,
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            throw new Error(`HTTP ${res.status}: ${text.slice(0, 200)}`);
+        }
+    }
+    getBufferSize() {
+        return this.buffer.size;
+    }
+    getCircuitState() {
+        return this.circuitBreaker.getState();
+    }
+}
+//# sourceMappingURL=httpSender.js.map

package/dist/infrastructure/cloud/httpSender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSender.js","sourceRoot":"","sources":["../../../src/infrastructure/cloud/httpSender.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,OAAO,UAAU;IAOQ;IANZ,cAAc,CAAiB;IAC/B,MAAM,CAAiB;IACvB,SAAS,CAAS;IAClB,QAAQ,CAAS;IAC1B,OAAO,GAAqB,IAAI,CAAC;IAEzC,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;QAC9C,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CACtC,MAAM,CAAC,uBAAuB,EAC9B,MAAM,CAAC,qBAAqB,CAC7B,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,GAAG,GAAG,MAAM,CAAC,GAAG,gBAAgB,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,GAAG,MAAM,CAAC,GAAG,sBAAsB,CAAC;IACtD,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,IAAI,CAAC,QAAuB;QAChC,wCAAwC;QACxC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC1C,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3B,QAAQ,CAAC,KAAK,CAAC,mBAAmB,EAAE;gBAClC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;gBAC1B,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE;gBACvC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,gDAAgD;IACxC,KAAK,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE;YAAE,OAAO;QAE9C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM;YAE9B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACtC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;gBAChC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACxF,CAAC;YAAC,MAAM,CAAC;gBACP,gEAAgE;gBAChE,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7B,CAAC;gBACD,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;gBAChC,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,oDAAoD;IAC5C,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,IAAa;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YAC7C,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;SAClC,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,KAAK,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAC5C,KAAK,EACL,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EACnD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EACjC,KAAK,EACL,CAAC,MAAM,CAAC,CACT,CAAC;YACF,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3F,OAAO,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;CACF"}

package/dist/infrastructure/cloud/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * bunqueue Cloud - Remote dashboard telemetry agent
+ *
+ * Sends periodic snapshots and real-time events to bunqueue Cloud (bunqueue.io).
+ * Enabled by setting BUNQUEUE_CLOUD_URL and BUNQUEUE_CLOUD_API_KEY env vars.
+ * Zero overhead when disabled.
+ */
+export { CloudAgent } from './cloudAgent';
+export { loadCloudConfig } from './config';
+export type { CloudConfig, CloudSnapshot, CloudEvent } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/cloud/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/cloud/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/infrastructure/cloud/index.js

@@ -0,0 +1,10 @@
+/**
+ * bunqueue Cloud - Remote dashboard telemetry agent
+ *
+ * Sends periodic snapshots and real-time events to bunqueue Cloud (bunqueue.io).
+ * Enabled by setting BUNQUEUE_CLOUD_URL and BUNQUEUE_CLOUD_API_KEY env vars.
+ * Zero overhead when disabled.
+ */
+export { CloudAgent } from './cloudAgent';
+export { loadCloudConfig } from './config';
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/cloud/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/cloud/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/infrastructure/cloud/instanceId.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Instance ID Manager
+ * Generates and persists a unique instance ID to disk
+ */
+/** Load or generate a persistent instance ID */
+export declare function getInstanceId(dataPath: string | null): string;
+//# sourceMappingURL=instanceId.d.ts.map

package/dist/infrastructure/cloud/instanceId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instanceId.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/cloud/instanceId.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAyB7D"}

package/dist/infrastructure/cloud/instanceId.js

@@ -0,0 +1,34 @@
+/**
+ * Instance ID Manager
+ * Generates and persists a unique instance ID to disk
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { dirname, join } from 'path';
+const INSTANCE_ID_FILE = 'cloud-instance-id';
+/** Load or generate a persistent instance ID */
+export function getInstanceId(dataPath) {
+    if (!dataPath)
+        return crypto.randomUUID();
+    const dir = dirname(dataPath);
+    const filePath = join(dir, INSTANCE_ID_FILE);
+    try {
+        if (existsSync(filePath)) {
+            const id = readFileSync(filePath, 'utf-8').trim();
+            if (id.length > 0)
+                return id;
+        }
+    }
+    catch {
+        // Fall through to generate new ID
+    }
+    const id = crypto.randomUUID();
+    try {
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(filePath, id, 'utf-8');
+    }
+    catch {
+        // Non-fatal: use ephemeral ID if we can't persist
+    }
+    return id;
+}
+//# sourceMappingURL=instanceId.js.map

package/dist/infrastructure/cloud/instanceId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instanceId.js","sourceRoot":"","sources":["../../../src/infrastructure/cloud/instanceId.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAE7C,gDAAgD;AAChD,MAAM,UAAU,aAAa,CAAC,QAAuB;IACnD,IAAI,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAE1C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAE/B,IAAI,CAAC;QACH,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,aAAa,CAAC,QAAQ,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/infrastructure/cloud/logger.d.ts

@@ -0,0 +1,5 @@
+/**
+ * bunqueue Cloud Logger
+ */
+export declare const cloudLog: import("../../shared/logger").Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/infrastructure/cloud/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/cloud/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,QAAQ,sCAAwB,CAAC"}

package/dist/infrastructure/cloud/logger.js

@@ -0,0 +1,6 @@
+/**
+ * bunqueue Cloud Logger
+ */
+import { createLogger } from '../../shared/logger';
+export const cloudLog = createLogger('Cloud');
+//# sourceMappingURL=logger.js.map

package/dist/infrastructure/cloud/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/infrastructure/cloud/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC"}

package/dist/infrastructure/cloud/snapshotCollector.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Snapshot Collector
+ * Gathers telemetry data from all bunqueue managers into a single snapshot
+ */
+import type { QueueManager } from '../../application/queueManager';
+import type { CloudSnapshot } from './types';
+/** Collect a full snapshot from all managers. O(SHARD_COUNT) total. */
+export declare function collectSnapshot(queueManager: QueueManager, instanceId: string, instanceName: string, startedAt: number, sequenceId: number): CloudSnapshot;
+//# sourceMappingURL=snapshotCollector.d.ts.map

package/dist/infrastructure/cloud/snapshotCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotCollector.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/cloud/snapshotCollector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAKnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C,uEAAuE;AACvE,wBAAgB,eAAe,CAC7B,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,aAAa,CA2Hf"}

package/dist/infrastructure/cloud/snapshotCollector.js

@@ -0,0 +1,213 @@
+/**
+ * Snapshot Collector
+ * Gathers telemetry data from all bunqueue managers into a single snapshot
+ */
+import { hostname } from 'os';
+import { throughputTracker } from '../../application/throughputTracker';
+import { latencyTracker } from '../../application/latencyTracker';
+import { getTaskErrorStats } from '../../application/backgroundTasks';
+import { VERSION } from '../../shared/version';
+/** Cached hostname — computed once */
+const HOST = hostname();
+/** Collect a full snapshot from all managers. O(SHARD_COUNT) total. */
+export function collectSnapshot(queueManager, instanceId, instanceName, startedAt, sequenceId) {
+    const stats = queueManager.getStats();
+    const memStats = queueManager.getMemoryStats();
+    const workerStats = queueManager.workerManager.getStats();
+    const rates = throughputTracker.getRates();
+    const percentiles = latencyTracker.getPercentiles();
+    const averages = latencyTracker.getAverages();
+    const storage = queueManager.getStorageStatus();
+    const crons = queueManager.listCrons();
+    const mem = process.memoryUsage();
+    // Per-queue stats (includes DLQ counts)
+    const perQueue = queueManager.getPerQueueStats();
+    const queuesSummary = queueManager.getQueuesSummary();
+    const queueNames = queuesSummary.map((q) => q.name);
+    const queues = queuesSummary.map((q) => {
+        const pq = perQueue.get(q.name);
+        return {
+            name: q.name,
+            waiting: pq?.waiting ?? q.counts.waiting,
+            delayed: pq?.delayed ?? q.counts.delayed,
+            active: pq?.active ?? q.counts.active,
+            dlq: pq?.dlq ?? 0,
+            paused: q.paused,
+        };
+    });
+    return {
+        instanceId,
+        instanceName,
+        version: VERSION,
+        hostname: HOST,
+        pid: process.pid,
+        startedAt,
+        timestamp: Date.now(),
+        sequenceId,
+        stats: {
+            waiting: stats.waiting,
+            delayed: stats.delayed,
+            active: stats.active,
+            dlq: stats.dlq,
+            completed: stats.completed,
+            stalled: memStats.stalledCandidates,
+            paused: queuesSummary.filter((q) => q.paused).length,
+            totalPushed: String(stats.totalPushed),
+            totalPulled: String(stats.totalPulled),
+            totalCompleted: String(stats.totalCompleted),
+            totalFailed: String(stats.totalFailed),
+            uptime: stats.uptime,
+            cronJobs: stats.cronJobs,
+            cronPending: stats.cronPending,
+        },
+        throughput: rates,
+        latency: {
+            averages,
+            percentiles,
+        },
+        memory: {
+            heapUsed: Math.round((mem.heapUsed / 1024 / 1024) * 100) / 100,
+            heapTotal: Math.round((mem.heapTotal / 1024 / 1024) * 100) / 100,
+            rss: Math.round((mem.rss / 1024 / 1024) * 100) / 100,
+            external: Math.round((mem.external / 1024 / 1024) * 100) / 100,
+        },
+        collections: {
+            jobIndex: memStats.jobIndex,
+            completedJobs: memStats.completedJobs,
+            jobResults: memStats.jobResults,
+            jobLogs: memStats.jobLogs,
+            customIdMap: memStats.customIdMap,
+            jobLocks: memStats.jobLocks,
+            processingTotal: memStats.processingTotal,
+            queuedTotal: memStats.queuedTotal,
+            temporalIndexTotal: memStats.temporalIndexTotal,
+            delayedHeapTotal: memStats.delayedHeapTotal,
+        },
+        queues,
+        workers: workerStats,
+        crons: crons.map((c) => ({
+            name: c.name,
+            queue: c.queue,
+            schedule: c.schedule ?? null,
+            nextRun: c.nextRun,
+        })),
+        storage: {
+            diskFull: storage.diskFull,
+            error: storage.error,
+        },
+        taskErrors: getTaskErrorStats(),
+        // Recent jobs (last 50 across all queues, lightweight — no job data)
+        recentJobs: collectRecentJobs(queueManager, queueNames),
+        // DLQ entries (last 50 across all queues)
+        dlqEntries: collectDlqEntries(queueManager, queueNames),
+        // Worker details
+        workerDetails: queueManager.workerManager.list().map((w) => ({
+            id: w.id,
+            name: w.name,
+            queues: w.queues,
+            concurrency: w.concurrency,
+            hostname: w.hostname,
+            pid: w.pid,
+            lastSeen: w.lastSeen,
+            activeJobs: w.activeJobs,
+            processedJobs: w.processedJobs,
+            failedJobs: w.failedJobs,
+            currentJob: w.currentJob,
+        })),
+        // Per-queue config
+        queueConfigs: collectQueueConfigs(queueManager, queueNames),
+    };
+}
+/** Collect recent jobs across queues (max 50, newest first) */
+function collectRecentJobs(queueManager, queueNames) {
+    const jobs = [];
+    const perQueue = Math.max(1, Math.floor(50 / (queueNames.length || 1)));
+    for (const name of queueNames) {
+        try {
+            const queueJobs = queueManager.getJobs(name, {
+                state: ['waiting', 'active', 'delayed'],
+                start: 0,
+                end: perQueue - 1,
+            });
+            for (const j of queueJobs) {
+                const data = j.data;
+                const jobName = data?.name ?? 'default';
+                const state = j.completedAt
+                    ? 'completed'
+                    : j.startedAt
+                        ? 'active'
+                        : j.runAt > Date.now()
+                            ? 'delayed'
+                            : 'waiting';
+                const duration = j.completedAt && j.startedAt ? j.completedAt - j.startedAt : undefined;
+                jobs.push({
+                    id: String(j.id),
+                    name: jobName,
+                    queue: j.queue,
+                    state,
+                    data,
+                    priority: j.priority,
+                    createdAt: j.createdAt,
+                    startedAt: j.startedAt ?? undefined,
+                    completedAt: j.completedAt ?? undefined,
+                    failedReason: state === 'active' && j.attempts > 0
+                        ? `Retry ${j.attempts}/${j.maxAttempts}`
+                        : undefined,
+                    attempts: j.attempts,
+                    maxAttempts: j.maxAttempts,
+                    duration,
+                    progress: j.progress > 0 ? j.progress : undefined,
+                });
+            }
+        }
+        catch {
+            // Skip queue on error
+        }
+    }
+    // Sort by createdAt desc, limit 50
+    return jobs.sort((a, b) => b.createdAt - a.createdAt).slice(0, 50);
+}
+/** Collect DLQ entries across queues (max 50) */
+function collectDlqEntries(queueManager, queueNames) {
+    const entries = [];
+    for (const name of queueNames) {
+        try {
+            const dlq = queueManager.getDlqEntries(name);
+            for (const e of dlq.slice(0, 20)) {
+                entries.push({
+                    jobId: String(e.job.id),
+                    queue: e.job.queue,
+                    reason: e.reason,
+                    error: e.error,
+                    enteredAt: e.enteredAt,
+                    retryCount: e.retryCount,
+                    attempts: e.job.attempts,
+                });
+            }
+        }
+        catch {
+            // Skip queue on error
+        }
+    }
+    return entries.sort((a, b) => b.enteredAt - a.enteredAt).slice(0, 50);
+}
+/** Collect per-queue config */
+function collectQueueConfigs(queueManager, queueNames) {
+    const configs = {};
+    for (const name of queueNames) {
+        try {
+            const stall = queueManager.getStallConfig(name);
+            const dlq = queueManager.getDlqConfig(name);
+            configs[name] = {
+                paused: queueManager.isPaused(name),
+                stallConfig: { stallInterval: stall.stallInterval, maxStalls: stall.maxStalls },
+                dlqConfig: { maxRetries: dlq.maxAutoRetries, maxAge: dlq.maxAge ?? 0 },
+            };
+        }
+        catch {
+            // Skip on error
+        }
+    }
+    return configs;
+}
+//# sourceMappingURL=snapshotCollector.js.map

package/dist/infrastructure/cloud/snapshotCollector.js.map

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

package/dist/infrastructure/cloud/types.d.ts

@@ -0,0 +1,210 @@
+/**
+ * bunqueue Cloud Types
+ * Interfaces for the Cloud agent that sends telemetry to the remote dashboard
+ */
+/** Cloud configuration from environment variables */
+export interface CloudConfig {
+    /** Remote dashboard URL (e.g. https://bunqueue.io) */
+    readonly url: string;
+    /** API key for authentication */
+    readonly apiKey: string;
+    /** HMAC signing secret (optional) */
+    readonly signingSecret: string | null;
+    /** Human-readable instance name */
+    readonly instanceName: string;
+    /** Snapshot interval in ms (default: 5000) */
+    readonly intervalMs: number;
+    /** Include job data in events (default: false) */
+    readonly includeJobData: boolean;
+    /** Fields to redact from job data */
+    readonly redactFields: string[];
+    /** Event types to forward (empty = all) */
+    readonly eventFilter: string[];
+    /** Max snapshots in offline buffer (default: 720) */
+    readonly bufferSize: number;
+    /** Circuit breaker: failures before OPEN (default: 5) */
+    readonly circuitBreakerThreshold: number;
+    /** Circuit breaker: ms in OPEN before HALF_OPEN (default: 60000) */
+    readonly circuitBreakerResetMs: number;
+    /** Enable WebSocket event stream (default: true) */
+    readonly useWebSocket: boolean;
+    /** Enable HTTP snapshot posting (default: true) */
+    readonly useHttp: boolean;
+    /** Data directory for persisting instance ID */
+    readonly dataPath: string | null;
+    /** Enable remote commands from dashboard (default: false) */
+    readonly remoteCommands: boolean;
+}
+/** Snapshot payload sent every N seconds via HTTP POST */
+export interface CloudSnapshot {
+    instanceId: string;
+    instanceName: string;
+    version: string;
+    hostname: string;
+    pid: number;
+    startedAt: number;
+    timestamp: number;
+    sequenceId: number;
+    shutdown?: boolean;
+    stats: {
+        waiting: number;
+        delayed: number;
+        active: number;
+        dlq: number;
+        completed: number;
+        totalPushed: string;
+        totalPulled: string;
+        totalCompleted: string;
+        totalFailed: string;
+        stalled: number;
+        paused: number;
+        uptime: number;
+        cronJobs: number;
+        cronPending: number;
+    };
+    throughput: {
+        pushPerSec: number;
+        pullPerSec: number;
+        completePerSec: number;
+        failPerSec: number;
+    };
+    latency: {
+        averages: {
+            pushMs: number;
+            pullMs: number;
+            ackMs: number;
+        };
+        percentiles: {
+            push: {
+                p50: number;
+                p95: number;
+                p99: number;
+            };
+            pull: {
+                p50: number;
+                p95: number;
+                p99: number;
+            };
+            ack: {
+                p50: number;
+                p95: number;
+                p99: number;
+            };
+        };
+    };
+    memory: {
+        heapUsed: number;
+        heapTotal: number;
+        rss: number;
+        external: number;
+    };
+    collections: {
+        jobIndex: number;
+        completedJobs: number;
+        jobResults: number;
+        jobLogs: number;
+        customIdMap: number;
+        jobLocks: number;
+        processingTotal: number;
+        queuedTotal: number;
+        temporalIndexTotal: number;
+        delayedHeapTotal: number;
+    };
+    queues: Array<{
+        name: string;
+        waiting: number;
+        delayed: number;
+        active: number;
+        dlq: number;
+        paused: boolean;
+    }>;
+    workers: {
+        total: number;
+        active: number;
+        totalProcessed: number;
+        totalFailed: number;
+        activeJobs: number;
+    };
+    crons: Array<{
+        name: string;
+        queue: string;
+        schedule: string | null;
+        nextRun: number;
+    }>;
+    storage: {
+        diskFull: boolean;
+        error: string | null;
+    };
+    taskErrors: Record<string, {
+        consecutiveFailures: number;
+        lastError?: string;
+        lastFailureAt?: number;
+    }>;
+    /** Recent jobs across all queues (last ~50, newest first) */
+    recentJobs: Array<{
+        id: string;
+        name: string;
+        queue: string;
+        state: string;
+        data?: unknown;
+        priority: number;
+        createdAt: number;
+        startedAt?: number;
+        completedAt?: number;
+        failedReason?: string;
+        attempts: number;
+        maxAttempts: number;
+        duration?: number;
+        progress?: number;
+    }>;
+    /** DLQ entries across all queues (last ~50) */
+    dlqEntries: Array<{
+        jobId: string;
+        queue: string;
+        reason: string;
+        error: string | null;
+        enteredAt: number;
+        retryCount: number;
+        attempts: number;
+    }>;
+    /** Individual worker details */
+    workerDetails: Array<{
+        id: string;
+        name: string;
+        queues: string[];
+        concurrency: number;
+        hostname: string;
+        pid: number;
+        lastSeen: number;
+        activeJobs: number;
+        processedJobs: number;
+        failedJobs: number;
+        currentJob: string | null;
+    }>;
+    /** Per-queue configuration */
+    queueConfigs: Record<string, {
+        paused: boolean;
+        stallConfig?: {
+            stallInterval: number;
+            maxStalls: number;
+        };
+        dlqConfig?: {
+            maxRetries: number;
+            maxAge: number;
+        };
+    }>;
+}
+/** Event payload forwarded via WebSocket */
+export interface CloudEvent {
+    instanceId: string;
+    timestamp: number;
+    jobEvent?: {
+        eventType: string;
+        queue: string;
+        jobId: string;
+        error?: string;
+        progress?: number;
+        data?: unknown;
+    };
+}
+//# sourceMappingURL=types.d.ts.map