@sjawhar/whatsapp-mcp 1.0.0

package/dist/__tests__/smoke.test.js

@@ -0,0 +1,28 @@
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { closeTestDb, seedTestDb, setupTestDb } from "./helpers/test-db.js";
+import { createMcpTestClient } from "./helpers/mcp-test-client.js";
+describe("MCP smoke test", () => {
+    let client;
+    beforeAll(async () => {
+        await setupTestDb();
+        seedTestDb();
+        client = await createMcpTestClient();
+    });
+    afterAll(async () => {
+        await client?.close();
+        closeTestDb();
+    });
+    it("connects MCP client, exposes 15 tools, and returns seeded chats", async () => {
+        const tools = await client.listTools();
+        expect(tools).toHaveLength(15);
+        const listChats = await client.callTool("list_chats", { limit: 20 });
+        expect(Array.isArray(listChats)).toBe(true);
+        expect(listChats).toEqual(expect.arrayContaining([
+            expect.objectContaining({
+                jid: "15550001111@s.whatsapp.net",
+                name: "Alice Test",
+            }),
+        ]));
+    });
+});
+//# sourceMappingURL=smoke.test.js.map

package/dist/__tests__/smoke.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.test.js","sourceRoot":"","sources":["../../src/__tests__/smoke.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAsB,MAAM,8BAA8B,CAAC;AAEvF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,MAAqB,CAAC;IAE1B,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,WAAW,EAAE,CAAC;QACpB,UAAU,EAAE,CAAC;QACb,MAAM,GAAG,MAAM,mBAAmB,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;QACtB,WAAW,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAE/B,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACrE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CACvB,MAAM,CAAC,eAAe,CAAC;YACrB,MAAM,CAAC,gBAAgB,CAAC;gBACtB,GAAG,EAAE,4BAA4B;gBACjC,IAAI,EAAE,YAAY;aACnB,CAAC;SACH,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/transcribe.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transcribe.test.d.ts.map

package/dist/__tests__/transcribe.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/transcribe.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/transcribe.test.js

@@ -0,0 +1,71 @@
+import { describe, expect, it } from "vitest";
+import { validateApiUrl } from "../utils.js";
+describe("validateApiUrl", () => {
+    // --- Valid URLs ---
+    it("accepts https Groq API URL", () => {
+        const result = validateApiUrl("https://api.groq.com/openai/v1/audio/transcriptions");
+        expect(result).toBeInstanceOf(URL);
+        expect(result.href).toBe("https://api.groq.com/openai/v1/audio/transcriptions");
+    });
+    it("accepts https OpenAI API URL", () => {
+        const result = validateApiUrl("https://api.openai.com/v1/audio/transcriptions");
+        expect(result).toBeInstanceOf(URL);
+    });
+    it("accepts http URL to public host", () => {
+        const result = validateApiUrl("http://api.example.com/v1/transcribe");
+        expect(result).toBeInstanceOf(URL);
+        expect(result.protocol).toBe("http:");
+    });
+    // --- Protocol rejection ---
+    it("rejects file:// protocol", () => {
+        expect(() => validateApiUrl("file:///etc/passwd")).toThrow("Only http/https URLs allowed");
+    });
+    it("rejects ftp:// protocol", () => {
+        expect(() => validateApiUrl("ftp://evil.com/file")).toThrow("Only http/https URLs allowed");
+    });
+    it("rejects javascript: protocol", () => {
+        expect(() => validateApiUrl("javascript:alert(1)")).toThrow();
+    });
+    // --- Localhost rejection ---
+    it("rejects localhost hostname", () => {
+        expect(() => validateApiUrl("http://localhost:8080/")).toThrow("localhost not allowed");
+    });
+    it("rejects 127.0.0.1", () => {
+        expect(() => validateApiUrl("http://127.0.0.1:8080/")).toThrow("localhost not allowed");
+    });
+    it("rejects ::1 (IPv6 loopback)", () => {
+        expect(() => validateApiUrl("http://[::1]:8080/")).toThrow("localhost not allowed");
+    });
+    // --- Private IP rejection ---
+    it("rejects 10.x.x.x (class A private)", () => {
+        expect(() => validateApiUrl("http://10.0.0.1/")).toThrow("Private/internal IP");
+    });
+    it("rejects 172.16.x.x (class B private)", () => {
+        expect(() => validateApiUrl("http://172.16.0.1/")).toThrow("Private/internal IP");
+    });
+    it("rejects 172.31.255.255 (class B private upper bound)", () => {
+        expect(() => validateApiUrl("http://172.31.255.255/")).toThrow("Private/internal IP");
+    });
+    it("accepts 172.15.0.1 (not in private range)", () => {
+        const result = validateApiUrl("http://172.15.0.1/");
+        expect(result).toBeInstanceOf(URL);
+    });
+    it("accepts 172.32.0.1 (not in private range)", () => {
+        const result = validateApiUrl("http://172.32.0.1/");
+        expect(result).toBeInstanceOf(URL);
+    });
+    it("rejects 192.168.x.x (class C private)", () => {
+        expect(() => validateApiUrl("http://192.168.1.1/")).toThrow("Private/internal IP");
+    });
+    it("rejects 169.254.169.254 (cloud metadata / link-local)", () => {
+        expect(() => validateApiUrl("http://169.254.169.254/")).toThrow("Private/internal IP");
+    });
+    // --- Invalid URLs ---
+    it("rejects completely invalid URL", () => {
+        expect(() => validateApiUrl("not-a-url")).toThrow();
+    });
+    it("rejects empty string", () => {
+        expect(() => validateApiUrl("")).toThrow();
+    });
+});
+//# sourceMappingURL=transcribe.test.js.map

package/dist/__tests__/transcribe.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe.test.js","sourceRoot":"","sources":["../../src/__tests__/transcribe.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,qBAAqB;IACrB,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,MAAM,GAAG,cAAc,CAAC,qDAAqD,CAAC,CAAC;QACrF,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,cAAc,CAAC,gDAAgD,CAAC,CAAC;QAChF,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,cAAc,CAAC,sCAAsC,CAAC,CAAC;QACtE,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,+BAA+B;IAC/B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,cAAc,CAAC,oBAAoB,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,cAAc,CAAC,oBAAoB,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,uBAAuB;IACvB,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/zombie.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=zombie.test.d.ts.map

package/dist/__tests__/zombie.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zombie.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/zombie.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/zombie.test.js

@@ -0,0 +1,145 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { createFakeBaileysSocket } from "./helpers/fake-baileys.js";
+import { closeTestDb, seedTestDb, setupTestDb } from "./helpers/test-db.js";
+const mockState = vi.hoisted(() => ({
+    sockets: [],
+}));
+vi.mock("@whiskeysockets/baileys", () => ({
+    default: vi.fn(() => {
+        const socket = createFakeBaileysSocket();
+        mockState.sockets.push(socket);
+        return socket;
+    }),
+    DisconnectReason: {
+        loggedOut: 401,
+        connectionClosed: 428,
+        connectionReplaced: 440,
+        badSession: 500,
+        unavailableService: 503,
+        restartRequired: 515,
+        connectionLost: 408,
+        forbidden: 403,
+        multideviceMismatch: 411,
+    },
+    fetchLatestBaileysVersion: vi.fn(async () => ({ version: [2, 3000, 0] })),
+    downloadMediaMessage: vi.fn(),
+    getContentType: vi.fn(),
+    initAuthCreds: vi.fn(() => ({})),
+    BufferJSON: {
+        replacer: (_key, value) => value,
+        reviver: (_key, value) => value,
+    },
+    proto: {
+        Message: {
+            AppStateSyncKeyData: {
+                fromObject: (value) => value,
+            },
+        },
+    },
+}));
+function latestSocket() {
+    const socket = mockState.sockets.at(-1);
+    if (!socket)
+        throw new Error("No fake socket was created");
+    return socket;
+}
+describe("zombie watchdog + send health check", () => {
+    const originalZombieTimeout = process.env.ZOMBIE_TIMEOUT_MS;
+    const originalMaxSendFailures = process.env.MAX_SEND_FAILURES;
+    beforeEach(async () => {
+        vi.resetModules();
+        vi.useFakeTimers();
+        mockState.sockets.length = 0;
+        process.env.ZOMBIE_TIMEOUT_MS = "120000";
+        process.env.MAX_SEND_FAILURES = "3";
+        process.env.MIN_SEND_INTERVAL_MS = "0";
+        process.env.SEND_JITTER_MS = "0";
+        await setupTestDb();
+        seedTestDb();
+    });
+    afterEach(async () => {
+        const whatsapp = await import("../whatsapp.js");
+        await whatsapp.closeWhatsApp();
+        closeTestDb();
+        vi.useRealTimers();
+        if (originalZombieTimeout === undefined) {
+            delete process.env.ZOMBIE_TIMEOUT_MS;
+        }
+        else {
+            process.env.ZOMBIE_TIMEOUT_MS = originalZombieTimeout;
+        }
+        if (originalMaxSendFailures === undefined) {
+            delete process.env.MAX_SEND_FAILURES;
+        }
+        else {
+            process.env.MAX_SEND_FAILURES = originalMaxSendFailures;
+        }
+    });
+    it("forces socket end after 2 minutes without connection.update activity", async () => {
+        const whatsapp = await import("../whatsapp.js");
+        await whatsapp.initWhatsApp();
+        const socket = latestSocket();
+        socket.emitConnectionOpen();
+        const endSpy = vi.spyOn(socket, "end");
+        vi.advanceTimersByTime(121_000);
+        expect(endSpy).toHaveBeenCalled();
+        const firstEndArg = endSpy.mock.calls.at(0)?.[0];
+        expect(firstEndArg).toBeInstanceOf(Error);
+        if (firstEndArg instanceof Error) {
+            expect(firstEndArg.message).toContain("Zombie connection detected");
+        }
+    });
+    it("clears zombie watchdog timer when socket disconnects", async () => {
+        const whatsapp = await import("../whatsapp.js");
+        await whatsapp.initWhatsApp();
+        const socket = latestSocket();
+        socket.emitConnectionOpen();
+        const timersAfterOpen = vi.getTimerCount();
+        expect(timersAfterOpen).toBeGreaterThanOrEqual(1); // at least zombie watchdog
+        socket.emitConnectionClose(428);
+        // Zombie watchdog cleared (-1), reconnect setTimeout added (+1) → net 0 change
+        expect(vi.getTimerCount()).toBe(timersAfterOpen);
+    });
+    it("forces reconnect after 3 consecutive send failures", async () => {
+        const whatsapp = await import("../whatsapp.js");
+        await whatsapp.initWhatsApp();
+        const socket = latestSocket();
+        socket.emitConnectionOpen();
+        const endSpy = vi.spyOn(socket, "end");
+        const sendSpy = vi.spyOn(socket, "sendMessage").mockRejectedValue(new Error("send failed"));
+        await expect(whatsapp.sendTextMessage("15550001111", "one")).rejects.toThrow("send failed");
+        await expect(whatsapp.sendTextMessage("15550001111", "two")).rejects.toThrow("send failed");
+        await expect(whatsapp.sendTextMessage("15550001111", "three")).rejects.toThrow("send failed");
+        expect(sendSpy).toHaveBeenCalledTimes(3);
+        expect(endSpy).toHaveBeenCalled();
+        const firstEndArg = endSpy.mock.calls.at(0)?.[0];
+        expect(firstEndArg).toBeInstanceOf(Error);
+        if (firstEndArg instanceof Error) {
+            expect(firstEndArg.message).toContain("Send health check failed");
+        }
+    });
+    it("resets consecutive send failures to zero after a successful send", async () => {
+        const whatsapp = await import("../whatsapp.js");
+        await whatsapp.initWhatsApp();
+        const socket = latestSocket();
+        socket.emitConnectionOpen();
+        const endSpy = vi.spyOn(socket, "end");
+        const sendSpy = vi.spyOn(socket, "sendMessage");
+        sendSpy
+            .mockRejectedValueOnce(new Error("fail-1"))
+            .mockRejectedValueOnce(new Error("fail-2"))
+            .mockResolvedValueOnce({ key: { id: "ok" } })
+            .mockRejectedValueOnce(new Error("fail-3"))
+            .mockRejectedValueOnce(new Error("fail-4"))
+            .mockRejectedValueOnce(new Error("fail-5"));
+        await expect(whatsapp.sendTextMessage("15550001111", "a")).rejects.toThrow("fail-1");
+        await expect(whatsapp.sendTextMessage("15550001111", "b")).rejects.toThrow("fail-2");
+        await expect(whatsapp.sendTextMessage("15550001111", "c")).resolves.toMatchObject({ success: true });
+        await expect(whatsapp.sendTextMessage("15550001111", "d")).rejects.toThrow("fail-3");
+        await expect(whatsapp.sendTextMessage("15550001111", "e")).rejects.toThrow("fail-4");
+        expect(endSpy).not.toHaveBeenCalled();
+        await expect(whatsapp.sendTextMessage("15550001111", "f")).rejects.toThrow("fail-5");
+        expect(endSpy).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=zombie.test.js.map

package/dist/__tests__/zombie.test.js.map

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

package/dist/db.d.ts

@@ -0,0 +1,53 @@
+import Database from "better-sqlite3";
+import type { WAMessage } from "@whiskeysockets/baileys";
+export declare function upsertChat(jid: string, name?: string | null, conversationTs?: number | null, unreadCount?: number | null): void;
+export declare function upsertContact(jid: string, name?: string | null, notify?: string | null): void;
+export declare function upsertMessage(chatJid: string, msg: WAMessage): void;
+export declare function upsertChats(chats: Array<{
+    id: string;
+    name?: string | null;
+    conversationTimestamp?: any;
+    unreadCount?: number | null;
+}>): void;
+export declare function upsertContacts(contacts: Array<{
+    id: string;
+    name?: string | null;
+    notify?: string | null;
+}>): void;
+export declare function upsertMessages(chatJid: string, msgs: WAMessage[]): void;
+export declare function deleteChat(jid: string): void;
+export declare function deleteMessage(chatJid: string, messageId: string): boolean;
+export declare function saveJidMapping(lidJid: string, phoneJid: string): void;
+export declare function getPhoneJid(lidJid: string): string | null;
+export declare function getLidJid(phoneJid: string): string | null;
+/**
+ * Return all known JIDs for a contact — the input JID plus any mapped counterpart.
+ * If a phone JID is given, also returns the LID JID (and vice versa).
+ */
+export declare function getAllJidsFor(jid: string): string[];
+export declare function getMessageFromMe(chatJid: string, messageId: string): boolean | null;
+export declare function resolveDisplayName(jid: string): string;
+export declare function getChats(nameFilter?: string, limit?: number): Record<string, unknown>[];
+export declare function getChat(jid: string): Record<string, unknown>;
+export declare function getMessages(jid: string, limit?: number): Record<string, unknown>[];
+export declare function searchMessages(query: string, jid?: string): Record<string, unknown>[];
+export declare function searchContacts(query: string): Record<string, unknown>[];
+export declare function getMessageContext(jid: string, messageId: string, count?: number): Record<string, unknown>;
+export declare function getMessageBlob(jid: string, messageId: string): string | null;
+export declare function getMessageTypeById(chatJid: string, messageId: string): string | null;
+export declare function getTranscription(chatJid: string, messageId: string): string | null;
+export declare function saveTranscription(chatJid: string, messageId: string, transcription: string): void;
+export declare function getLastMessageKey(jid: string): {
+    id: string;
+    fromMe: boolean;
+    remoteJid: string;
+    timestamp: number;
+} | null;
+export declare function deleteChatMessages(jid: string): void;
+export declare function getChatName(jid: string): string | null;
+export declare function getContactName(jid: string): string | null;
+/** Return the raw better-sqlite3 instance (for use by import-contacts). */
+export declare function getDb(): Database.Database;
+export declare function initDb(): void;
+export declare function closeDb(): void;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

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