nduka 1.0.0

package/dist/gateway/media-queue-worker-runtime.js

@@ -0,0 +1,35 @@
+import { MediaQueueWorker } from '../media/queue-worker.js';
+import { safeLogObject, sanitizeLogField } from '../observability/safe-log.js';
+function hasWork(result) {
+    return result.due > 0 || result.completed > 0 || result.retried > 0 || result.failed > 0 || result.ownerReview > 0;
+}
+function createDefaultWorker(logger) {
+    return new MediaQueueWorker({
+        onResult: (result) => {
+            if (hasWork(result))
+                logger.info('[MediaQueueWorker] tick', safeLogObject(result));
+        },
+        onError: (error) => logger.error('[MediaQueueWorker] error:', sanitizeLogField(error.message)),
+    });
+}
+export function createGatewayMediaWorker(logger = console, options = {}) {
+    const worker = options.worker || createDefaultWorker(logger);
+    const started = worker.start();
+    if (started)
+        logger.info('[MediaQueueWorker] started');
+    else if (worker.isEnabled())
+        logger.warn('[MediaQueueWorker] enabled but already started');
+    else
+        logger.info('[MediaQueueWorker] disabled');
+    return {
+        worker,
+        started,
+        stop: () => {
+            const stopped = worker.stop();
+            if (stopped)
+                logger.info('[MediaQueueWorker] stopped');
+            return stopped;
+        },
+    };
+}
+//# sourceMappingURL=media-queue-worker-runtime.js.map

package/dist/gateway/media-queue-worker-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-queue-worker-runtime.js","sourceRoot":"","sources":["../../src/gateway/media-queue-worker-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAkB/E,SAAS,OAAO,CAAC,MAA2B;IAC1C,OAAO,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;AACrH,CAAC;AAED,SAAS,mBAAmB,CAAC,MAA2B;IACtD,OAAO,IAAI,gBAAgB,CAAC;QAC1B,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YACnB,IAAI,OAAO,CAAC,MAAM,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;KAC/F,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,SAA8B,OAAO,EAAE,UAAqC,EAAE;IACrH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/B,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;SAClD,IAAI,MAAM,CAAC,SAAS,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;;QACtF,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAEhD,OAAO;QACL,MAAM;QACN,OAAO;QACP,IAAI,EAAE,GAAG,EAAE;YACT,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,OAAO;gBAAE,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YACvD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/gateway/message-buffer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Message Buffer — holds messages received before the gateway is READY.
+ * Flushes them when the gateway transitions to READY.
+ */
+import type { ParsedMessage } from './events/handler.js';
+export declare function bufferMessage(msg: ParsedMessage): void;
+export declare function flushBuffer(): ParsedMessage[];
+export declare function getBufferSize(): number;
+//# sourceMappingURL=message-buffer.d.ts.map

package/dist/gateway/message-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-buffer.d.ts","sourceRoot":"","sources":["../../src/gateway/message-buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKzD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAItD;AAED,wBAAgB,WAAW,IAAI,aAAa,EAAE,CAI7C;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/gateway/message-buffer.js

@@ -0,0 +1,16 @@
+let buffer = [];
+const MAX_BUFFER = 200;
+export function bufferMessage(msg) {
+    if (buffer.length < MAX_BUFFER) {
+        buffer.push(msg);
+    }
+}
+export function flushBuffer() {
+    const msgs = buffer;
+    buffer = [];
+    return msgs;
+}
+export function getBufferSize() {
+    return buffer.length;
+}
+//# sourceMappingURL=message-buffer.js.map

package/dist/gateway/message-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-buffer.js","sourceRoot":"","sources":["../../src/gateway/message-buffer.ts"],"names":[],"mappings":"AAMA,IAAI,MAAM,GAAoB,EAAE,CAAC;AACjC,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,MAAM,UAAU,aAAa,CAAC,GAAkB;IAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,MAAM,CAAC;IACpB,MAAM,GAAG,EAAE,CAAC;IACZ,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/dist/gateway/outgoing-messages.d.ts

@@ -0,0 +1,4 @@
+export declare function markOutgoingBotMessage(messageId: string | undefined | null, now?: number): void;
+export declare function consumeOutgoingBotMessage(messageId: string | undefined | null, now?: number): boolean;
+export declare function resetOutgoingBotMessagesForTests(): void;
+//# sourceMappingURL=outgoing-messages.d.ts.map

package/dist/gateway/outgoing-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outgoing-messages.d.ts","sourceRoot":"","sources":["../../src/gateway/outgoing-messages.ts"],"names":[],"mappings":"AAUA,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,GAAG,SAAa,GAAG,IAAI,CAInG;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,GAAG,SAAa,GAAG,OAAO,CAIzG;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}

package/dist/gateway/outgoing-messages.js

@@ -0,0 +1,25 @@
+const MAX_TRACKED = 500;
+const tracked = new Map();
+function prune(now = Date.now()) {
+    const cutoff = now - 10 * 60_000;
+    for (const [id, timestamp] of tracked) {
+        if (timestamp < cutoff || tracked.size > MAX_TRACKED)
+            tracked.delete(id);
+    }
+}
+export function markOutgoingBotMessage(messageId, now = Date.now()) {
+    if (!messageId)
+        return;
+    prune(now);
+    tracked.set(messageId, now);
+}
+export function consumeOutgoingBotMessage(messageId, now = Date.now()) {
+    if (!messageId)
+        return false;
+    prune(now);
+    return tracked.delete(messageId);
+}
+export function resetOutgoingBotMessagesForTests() {
+    tracked.clear();
+}
+//# sourceMappingURL=outgoing-messages.js.map

package/dist/gateway/outgoing-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outgoing-messages.js","sourceRoot":"","sources":["../../src/gateway/outgoing-messages.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE1C,SAAS,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC7B,MAAM,MAAM,GAAG,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC;IACjC,KAAK,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC;QACtC,IAAI,SAAS,GAAG,MAAM,IAAI,OAAO,CAAC,IAAI,GAAG,WAAW;YAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAoC,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC3F,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,KAAK,CAAC,GAAG,CAAC,CAAC;IACX,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,SAAoC,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC9F,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,KAAK,CAAC,GAAG,CAAC,CAAC;IACX,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/gateway/process-lifecycle.d.ts

@@ -0,0 +1,8 @@
+export interface LifecycleProcess {
+    once(event: 'SIGINT' | 'SIGTERM' | 'beforeExit', listener: () => void): unknown;
+}
+export interface LifecycleHandle {
+    stop(): void;
+}
+export declare function registerLifecycleShutdown(stop: () => void, proc?: LifecycleProcess): LifecycleHandle;
+//# sourceMappingURL=process-lifecycle.d.ts.map

package/dist/gateway/process-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-lifecycle.d.ts","sourceRoot":"","sources":["../../src/gateway/process-lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CACjF;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,IAAI,GAAE,gBAA0B,GAAG,eAAe,CAa7G"}

package/dist/gateway/process-lifecycle.js

@@ -0,0 +1,14 @@
+export function registerLifecycleShutdown(stop, proc = process) {
+    let stopped = false;
+    const stopOnce = () => {
+        if (stopped)
+            return;
+        stopped = true;
+        stop();
+    };
+    proc.once('SIGINT', stopOnce);
+    proc.once('SIGTERM', stopOnce);
+    proc.once('beforeExit', stopOnce);
+    return { stop: stopOnce };
+}
+//# sourceMappingURL=process-lifecycle.js.map

package/dist/gateway/process-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-lifecycle.js","sourceRoot":"","sources":["../../src/gateway/process-lifecycle.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,yBAAyB,CAAC,IAAgB,EAAE,OAAyB,OAAO;IAC1F,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAElC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/gateway/process-safety.d.ts

@@ -0,0 +1,14 @@
+import type { GatewayLogger } from './logger.js';
+export interface GatewayLifecycle {
+    start(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export interface ProcessSafetyOptions {
+    exit?: (code?: number) => void;
+    processLike?: Pick<NodeJS.Process, 'once'>;
+}
+export declare function assertSingleGatewayInstance(logger: GatewayLogger, exit?: (code?: number) => void): void;
+export declare function installGlobalSafetyNet(logger: GatewayLogger, exit?: (code?: number) => void): void;
+export declare function runGateway(factory: () => GatewayLifecycle, logger: GatewayLogger, options?: ProcessSafetyOptions): Promise<void>;
+export declare function resetGatewayInstanceForTests(): void;
+//# sourceMappingURL=process-safety.d.ts.map

package/dist/gateway/process-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-safety.d.ts","sourceRoot":"","sources":["../../src/gateway/process-safety.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,WAAW,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,GAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,IAAmB,GAAG,IAAI,CAQrH;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,GAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,IAAmB,GAAG,IAAI,CAUhH;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB1I;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}

package/dist/gateway/process-safety.js

@@ -0,0 +1,48 @@
+import { runShutdownTasks } from './shutdown-registry.js';
+const INSTANCE_KEY = '__BAILEYS_RUNNING__';
+export function assertSingleGatewayInstance(logger, exit = process.exit) {
+    const globalState = globalThis;
+    if (globalState[INSTANCE_KEY]) {
+        logger.error('[FATAL] Another gateway instance is already running. Exiting.');
+        exit(1);
+        return;
+    }
+    globalState[INSTANCE_KEY] = true;
+}
+export function installGlobalSafetyNet(logger, exit = process.exit) {
+    process.on('unhandledRejection', (reason) => {
+        const message = reason?.message || String(reason);
+        if (message.includes('media key') || message.includes('empty media')) {
+            logger.warn('[Recovered] Media key error in history sync:', message);
+            return;
+        }
+        logger.error('[Fatal] Unhandled rejection:', reason);
+        exit(1);
+    });
+}
+export async function runGateway(factory, logger, options = {}) {
+    const exit = options.exit || process.exit;
+    const processLike = options.processLike || process;
+    const gateway = factory();
+    let shutdownStarted = false;
+    const shutdown = async (signal, code = 0) => {
+        if (shutdownStarted)
+            return;
+        shutdownStarted = true;
+        logger.info(`Received ${signal} — shutting down`);
+        await runShutdownTasks();
+        await gateway.shutdown();
+        exit(code);
+    };
+    processLike.once('SIGINT', () => { shutdown('SIGINT').catch(() => exit(1)); });
+    processLike.once('SIGTERM', () => { shutdown('SIGTERM').catch(() => exit(1)); });
+    processLike.once('uncaughtException', (err) => {
+        logger.error('Uncaught exception:', err.message);
+        shutdown('uncaughtException', 1).catch(() => exit(1));
+    });
+    await gateway.start();
+}
+export function resetGatewayInstanceForTests() {
+    delete globalThis[INSTANCE_KEY];
+}
+//# sourceMappingURL=process-safety.js.map

package/dist/gateway/process-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-safety.js","sourceRoot":"","sources":["../../src/gateway/process-safety.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAY3C,MAAM,UAAU,2BAA2B,CAAC,MAAqB,EAAE,OAAgC,OAAO,CAAC,IAAI;IAC7G,MAAM,WAAW,GAAG,UAAqC,CAAC;IAC1D,IAAI,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAC9E,IAAI,CAAC,CAAC,CAAC,CAAC;QACR,OAAO;IACT,CAAC;IACD,WAAW,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAqB,EAAE,OAAgC,OAAO,CAAC,IAAI;IACxG,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAe,EAAE,EAAE;QACnD,MAAM,OAAO,GAAI,MAAgB,EAAE,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,8CAA8C,EAAE,OAAO,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,CAAC,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA+B,EAAE,MAAqB,EAAE,UAAgC,EAAE;IACzH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;IAC1B,IAAI,eAAe,GAAG,KAAK,CAAC;IAE5B,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,IAAI,GAAG,CAAC,EAAE,EAAE;QAClD,IAAI,eAAe;YAAE,OAAO;QAC5B,eAAe,GAAG,IAAI,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,kBAAkB,CAAC,CAAC;QAClD,MAAM,gBAAgB,EAAE,CAAC;QACzB,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,CAAC,CAAC;IAEF,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,WAAW,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,GAAU,EAAE,EAAE;QACnD,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACjD,QAAQ,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAQ,UAAsC,CAAC,YAAY,CAAC,CAAC;AAC/D,CAAC"}

package/dist/gateway/reconnect/index.d.ts

@@ -0,0 +1,3 @@
+export { ReconnectManager } from './manager.js';
+export type { ReconnectConfig, ReconnectCallback, ConnectionStateUpdate } from './manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/gateway/reconnect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gateway/reconnect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/gateway/reconnect/index.js

@@ -0,0 +1,2 @@
+export { ReconnectManager } from './manager.js';
+//# sourceMappingURL=index.js.map

package/dist/gateway/reconnect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gateway/reconnect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/gateway/reconnect/manager.d.ts

@@ -0,0 +1,59 @@
+export interface ReconnectConfig {
+    /** Initial delay before first reconnection attempt (ms) */
+    initialDelayMs: number;
+    /** Maximum delay between reconnection attempts (ms) */
+    maxDelayMs: number;
+    /** Multiplier for exponential backoff */
+    backoffMultiplier: number;
+    /** Maximum number of reconnection attempts (0 = unlimited) */
+    maxAttempts: number;
+    /** Rolling window used to detect repeated disconnect loops (ms) */
+    rapidWindowMs: number;
+    /** Maximum reconnect schedules allowed in the rolling window before circuit breaking (0 = disabled) */
+    maxRapidAttempts: number;
+    /** Delay used after too many reconnect schedules in the rolling window (ms) */
+    rapidPauseMs: number;
+}
+export type ReconnectCallback = () => Promise<void>;
+export type ConnectionStateUpdate = {
+    connection: string;
+    lastDisconnect?: {
+        date: Date;
+        reason?: string;
+    };
+};
+export declare class ReconnectManager {
+    private config;
+    private reconnectCallback;
+    private attemptCount;
+    private isReconnecting;
+    private timer;
+    private currentDelay;
+    private rapidAttemptTimestamps;
+    private terminalDisconnectSeen;
+    constructor(config?: Partial<ReconnectConfig>);
+    /** Set the function to call when reconnection is needed. */
+    onReconnect(callback: ReconnectCallback): void;
+    /**
+     * Handle a connection state update.
+     * Returns true if reconnection was initiated.
+     */
+    handleConnectionUpdate(update: ConnectionStateUpdate): boolean;
+    private markTerminalDisconnect;
+    private rapidLoopDelay;
+    /** Schedule a reconnection attempt. */
+    private scheduleReconnect;
+    /** Reset the reconnection state (called on successful connection). */
+    reset(): void;
+    /** Try to extract a DisconnectReason status code from the reason string. */
+    private extractStatusCode;
+    /** Number of reconnection attempts so far. */
+    get attempts(): number;
+    /** Whether a reconnection is in progress. */
+    get reconnecting(): boolean;
+    /** Whether a terminal disconnect was seen. */
+    get terminal(): boolean;
+    /** Clean up. */
+    destroy(): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/gateway/reconnect/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/gateway/reconnect/manager.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,uGAAuG;IACvG,gBAAgB,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AACpD,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE;QACf,IAAI,EAAE,IAAI,CAAC;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAwBF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,sBAAsB,CAAgB;IAC9C,OAAO,CAAC,sBAAsB,CAAS;gBAE3B,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAK7C,4DAA4D;IAC5D,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAI9C;;;OAGG;IACH,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO;IA2C9D,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,cAAc;IAetB,uCAAuC;IACvC,OAAO,CAAC,iBAAiB;IAgCzB,sEAAsE;IACtE,KAAK,IAAI,IAAI;IAYb,4EAA4E;IAC5E,OAAO,CAAC,iBAAiB;IAwBzB,8CAA8C;IAC9C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,6CAA6C;IAC7C,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,8CAA8C;IAC9C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,gBAAgB;IAChB,OAAO,IAAI,IAAI;CAGhB"}

package/dist/gateway/reconnect/manager.js

@@ -0,0 +1,195 @@
+/**
+ * Reconnect Manager
+ *
+ * Implements automatic reconnection with exponential backoff.
+ * Watches connection state changes from Baileys and triggers
+ * reconnection when the socket disconnects unexpectedly.
+ *
+ * Following OpenClaw's pattern: one reconnect manager is the
+ * single authority on when and how to reconnect.
+ */
+import { DisconnectReason } from '@whiskeysockets/baileys';
+// ─── Default Config ──────────────────────────────────────────────────────────
+const DEFAULT_CONFIG = {
+    initialDelayMs: 1_000,
+    maxDelayMs: 60_000,
+    backoffMultiplier: 2,
+    maxAttempts: 0, // unlimited
+    rapidWindowMs: 60_000,
+    maxRapidAttempts: 5,
+    rapidPauseMs: 5 * 60_000,
+};
+const NON_RECONNECTABLE_STATUS = new Set([
+    DisconnectReason.badSession,
+    DisconnectReason.loggedOut,
+    DisconnectReason.forbidden,
+    DisconnectReason.connectionReplaced,
+    DisconnectReason.multideviceMismatch,
+]);
+// ─── Reconnect Manager ───────────────────────────────────────────────────────
+export class ReconnectManager {
+    config;
+    reconnectCallback = null;
+    attemptCount = 0;
+    isReconnecting = false;
+    timer = null;
+    currentDelay;
+    rapidAttemptTimestamps = [];
+    terminalDisconnectSeen = false;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.currentDelay = this.config.initialDelayMs;
+    }
+    /** Set the function to call when reconnection is needed. */
+    onReconnect(callback) {
+        this.reconnectCallback = callback;
+    }
+    /**
+     * Handle a connection state update.
+     * Returns true if reconnection was initiated.
+     */
+    handleConnectionUpdate(update) {
+        if (update.connection !== 'close') {
+            // Connection opened or connecting — reset backoff on success
+            if (update.connection === 'open') {
+                this.reset();
+            }
+            return false;
+        }
+        const reason = update.lastDisconnect?.reason || 'unknown';
+        const statusCode = this.extractStatusCode(reason);
+        // Do not reconnect when WhatsApp says this session is no longer valid or has been replaced.
+        // Reconnecting these cases can create loops, hide a real logout, or fight another active session.
+        if (NON_RECONNECTABLE_STATUS.has(statusCode)) {
+            this.markTerminalDisconnect(statusCode || reason);
+            return false;
+        }
+        if (this.terminalDisconnectSeen) {
+            console.log('[Reconnect] Terminal disconnect was already seen; refusing reconnect until process/session reset');
+            return false;
+        }
+        // Don't reconnect if already in progress
+        if (this.isReconnecting) {
+            console.log('[Reconnect] Already attempting reconnection');
+            return false;
+        }
+        // Check max attempts
+        if (this.config.maxAttempts > 0 && this.attemptCount >= this.config.maxAttempts) {
+            console.error(`[Reconnect] Max reconnection attempts (${this.config.maxAttempts}) reached — giving up`);
+            return false;
+        }
+        const immediate = statusCode === DisconnectReason.restartRequired;
+        this.scheduleReconnect(reason, immediate ? 0 : undefined);
+        return true;
+    }
+    markTerminalDisconnect(reason) {
+        this.terminalDisconnectSeen = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.isReconnecting = false;
+        console.log(`[Reconnect] Not reconnecting after terminal disconnect (${reason})`);
+    }
+    rapidLoopDelay(now = Date.now()) {
+        if (this.config.maxRapidAttempts <= 0)
+            return undefined;
+        const windowStart = now - this.config.rapidWindowMs;
+        this.rapidAttemptTimestamps = this.rapidAttemptTimestamps.filter((timestamp) => timestamp >= windowStart);
+        this.rapidAttemptTimestamps.push(now);
+        if (this.rapidAttemptTimestamps.length <= this.config.maxRapidAttempts)
+            return undefined;
+        console.warn(`[Reconnect] Rapid disconnect loop detected (${this.rapidAttemptTimestamps.length} reconnects in ${this.config.rapidWindowMs}ms); pausing for ${this.config.rapidPauseMs}ms`);
+        return this.config.rapidPauseMs;
+    }
+    /** Schedule a reconnection attempt. */
+    scheduleReconnect(reason, delayOverrideMs) {
+        this.isReconnecting = true;
+        this.attemptCount++;
+        const baseDelay = delayOverrideMs ?? this.currentDelay;
+        const loopDelay = this.rapidLoopDelay();
+        const delay = loopDelay === undefined ? baseDelay : Math.max(baseDelay, loopDelay);
+        console.log(`[Reconnect] Scheduling reconnect #${this.attemptCount} in ${delay}ms (reason: ${reason})`);
+        this.timer = setTimeout(async () => {
+            try {
+                if (this.reconnectCallback) {
+                    await this.reconnectCallback();
+                }
+            }
+            catch (err) {
+                console.error('[Reconnect] Attempt failed:', err.message);
+            }
+            finally {
+                // ALWAYS reset reconnecting flag so next attempt can proceed
+                this.isReconnecting = false;
+            }
+        }, delay);
+        // Increase delay for next attempt (exponential backoff). Restart-required reconnects are immediate,
+        // but the next non-immediate failure should still use normal backoff.
+        this.currentDelay = Math.min(this.currentDelay * this.config.backoffMultiplier, this.config.maxDelayMs);
+    }
+    /** Reset the reconnection state (called on successful connection). */
+    reset() {
+        this.attemptCount = 0;
+        this.isReconnecting = false;
+        this.currentDelay = this.config.initialDelayMs;
+        this.rapidAttemptTimestamps = [];
+        this.terminalDisconnectSeen = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Try to extract a DisconnectReason status code from the reason string. */
+    extractStatusCode(reason) {
+        // Baileys stores the status code in the Boom error's message
+        // e.g., "Connection closed: 428" or "loggedOut"
+        const match = reason.match(/\b(\d{3})\b/);
+        if (match)
+            return parseInt(match[1], 10);
+        // Check for known reason strings
+        const reasonLower = reason.toLowerCase();
+        if (reasonLower.includes('logged'))
+            return DisconnectReason.loggedOut;
+        if (reasonLower.includes('device_removed'))
+            return DisconnectReason.loggedOut;
+        if (reasonLower.includes('bad session'))
+            return DisconnectReason.badSession;
+        if (reasonLower.includes('bad_session'))
+            return DisconnectReason.badSession;
+        if (reasonLower.includes('restart'))
+            return DisconnectReason.restartRequired;
+        if (reasonLower.includes('timed'))
+            return DisconnectReason.timedOut;
+        if (reasonLower.includes('timeout'))
+            return DisconnectReason.timedOut;
+        if (reasonLower.includes('forbidden'))
+            return DisconnectReason.forbidden;
+        if (reasonLower.includes('replaced'))
+            return DisconnectReason.connectionReplaced;
+        if (reasonLower.includes('conflict'))
+            return DisconnectReason.connectionReplaced;
+        if (reasonLower.includes('unavailable'))
+            return DisconnectReason.unavailableService;
+        if (reasonLower.includes('mismatch'))
+            return DisconnectReason.multideviceMismatch;
+        return 0; // unknown
+    }
+    /** Number of reconnection attempts so far. */
+    get attempts() {
+        return this.attemptCount;
+    }
+    /** Whether a reconnection is in progress. */
+    get reconnecting() {
+        return this.isReconnecting;
+    }
+    /** Whether a terminal disconnect was seen. */
+    get terminal() {
+        return this.terminalDisconnectSeen;
+    }
+    /** Clean up. */
+    destroy() {
+        this.reset();
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/gateway/reconnect/manager.js.map

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

package/dist/gateway/self-echo-guard.d.ts

@@ -0,0 +1,2 @@
+export declare function isLikelySelfEcho(text: string | null | undefined): boolean;
+//# sourceMappingURL=self-echo-guard.d.ts.map

package/dist/gateway/self-echo-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-echo-guard.d.ts","sourceRoot":"","sources":["../../src/gateway/self-echo-guard.ts"],"names":[],"mappings":"AAsBA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAMzE"}

package/dist/gateway/self-echo-guard.js

@@ -0,0 +1,31 @@
+const SELF_REPLY_PREFIXES = [
+    'here is what i found:',
+    'i searched, but',
+    'i tried to search, but',
+    'i could not find',
+    'i couldn’t find',
+    'the current time is',
+    'no commands are needed here',
+    'i processed your request',
+    'these results are',
+];
+const RESULT_LOOP_PATTERNS = [
+    /\bweb result\b/,
+    /\btool result\b/,
+    /\bsearch results\b/,
+    /\bhere is what i found\b/,
+    /\bgot those search results\b/,
+    /\bthese results are all\b/,
+    /https?:\/\//,
+];
+export function isLikelySelfEcho(text) {
+    if (!text)
+        return false;
+    const normalized = text.toLowerCase().replace(/\s+/g, ' ').trim();
+    if (!normalized)
+        return false;
+    if (SELF_REPLY_PREFIXES.some((prefix) => normalized.startsWith(prefix)))
+        return true;
+    return RESULT_LOOP_PATTERNS.some((pattern) => pattern.test(normalized));
+}
+//# sourceMappingURL=self-echo-guard.js.map

package/dist/gateway/self-echo-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-echo-guard.js","sourceRoot":"","sources":["../../src/gateway/self-echo-guard.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG;IAC1B,uBAAuB;IACvB,iBAAiB;IACjB,wBAAwB;IACxB,kBAAkB;IAClB,iBAAiB;IACjB,qBAAqB;IACrB,6BAA6B;IAC7B,0BAA0B;IAC1B,mBAAmB;CACpB,CAAC;AAEF,MAAM,oBAAoB,GAAG;IAC3B,gBAAgB;IAChB,iBAAiB;IACjB,oBAAoB;IACpB,0BAA0B;IAC1B,8BAA8B;IAC9B,2BAA2B;IAC3B,aAAa;CACd,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAA+B;IAC9D,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACrF,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/gateway/server.d.ts

@@ -0,0 +1,61 @@
+/**
+ * WhatsApp Gateway Server
+ *
+ * Entry point for the WhatsApp automation gateway.
+ *
+ * Architecture (following OpenClaw's Gateway pattern):
+ *
+ *   WhatsApp ←→ Baileys Socket ←→ Gateway ←→ Event Bus ←→ Router ←→ AI
+ *
+ * The gateway is the sole owner of the WhatsApp session.
+ * Nothing talks directly to WhatsApp — everything routes through here.
+ */
+declare class Gateway {
+    private authStore;
+    private socketManager;
+    private eventHandler;
+    private reconnectManager;
+    private healthMonitor;
+    private shuttingDown;
+    private saveIntervals;
+    private db;
+    private mediaService;
+    private sessionManager;
+    private snapshotService;
+    private recoveryService;
+    private aiEngine;
+    private toolRegistry;
+    private ownerIdentity;
+    private globalConfig;
+    private ownerRouter;
+    private persistentMemory;
+    private whisperService;
+    private ocrClient;
+    private ocrRegistry;
+    private eventStore;
+    private chatRegistry;
+    private ops;
+    private runtime;
+    private asyncJobWorker;
+    private promptRegistry;
+    constructor();
+    /** Start the gateway. */
+    start(): Promise<void>;
+    /** Establish a WhatsApp connection. */
+    private connect;
+    /** Echo a message back (fallback when no API keys). */
+    private echoMessage;
+    /** AI-powered response using OpenRouter/Kilocode. */
+    private aiRespond;
+    private analyzeVisualMedia;
+    private handleVisualMediaMessage;
+    /** Route incoming message: OwnerRouter → commands/tools → AI. */
+    /** Single entry point — delegates to ConversationRuntime. */
+    private handleIncomingMessage;
+    private sendReply;
+    getHealth(): import("./health/monitor.js").HealthStatus;
+    /** Graceful shutdown. */
+    shutdown(): Promise<void>;
+}
+export { Gateway };
+//# sourceMappingURL=server.d.ts.map

package/dist/gateway/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/gateway/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmIH,cAAM,OAAO;IACX,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,EAAE,CAAiC;IAC3C,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAA+F;IAClH,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,SAAS,CAA8E;IAC/F,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,cAAc,CAAwB;;IAiE9C,yBAAyB;IACnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyR5B,uCAAuC;YACzB,OAAO;IAwOrB,uDAAuD;YACzC,WAAW;IA2CzB,qDAAqD;YACvC,SAAS;YAqDT,kBAAkB;YA8ClB,wBAAwB;IAiEtC,iEAAiE;IACjE,6DAA6D;YAC/C,qBAAqB;YAUrB,SAAS;IAqBvB,SAAS;IAIT,yBAAyB;IACnB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAoChC;AAkCD,OAAO,EAAE,OAAO,EAAE,CAAC"}