@sjawhar/whatsapp-mcp 1.0.0

package/dist/tools.js

@@ -0,0 +1,339 @@
+import { z } from "zod";
+import fs from "fs";
+import path from "path";
+import { getChats, getChat, getMessages, searchMessages, searchContacts, getMessageContext, getRecipientInfo, sendTextMessage, sendFileMessage, downloadMessageMedia, transcribeVoiceNote, deleteMessage, deleteChat, updateContact, getMyInfo, } from "./whatsapp.js";
+import { getDb } from "./db.js";
+import { importContactsFromVcf } from "./import-contacts.js";
+import { validateFilePath } from "./utils.js";
+/**
+ * Register all WhatsApp MCP tools on the server.
+ */
+export function registerTools(server) {
+    // ─── Reading Tools ──────────────────────────────────────────
+    server.tool("list_chats", "List all WhatsApp chats sorted by last activity. Optionally filter by name.", {
+        nameFilter: z.string().optional().describe("Filter chats by name (case-insensitive substring match)"),
+        limit: z.number().min(1).max(100).default(20).describe("Max number of chats to return"),
+    }, async ({ nameFilter, limit }) => {
+        try {
+            const chats = await getChats(nameFilter, limit);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(chats, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    server.tool("get_chat", "Get details for a specific chat including recent messages.", {
+        jid: z.string().describe("Chat JID (phone@s.whatsapp.net) or phone number"),
+    }, async ({ jid }) => {
+        try {
+            const chat = await getChat(jid);
+            return {
+                content: [{ type: "text", text: JSON.stringify(chat, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    server.tool("list_messages", "Get messages from a specific chat. Returns most recent messages first.", {
+        jid: z.string().describe("Chat JID or phone number"),
+        limit: z.number().min(1).max(100).default(50).describe("Number of messages to return"),
+    }, async ({ jid, limit }) => {
+        try {
+            const messages = await getMessages(jid, limit);
+            return {
+                content: [{ type: "text", text: JSON.stringify(messages, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    server.tool("search_messages", "Substring search across messages. Can search in a specific chat or across all chats.", {
+        query: z.string().describe("Text to search for (case-insensitive)"),
+        jid: z.string().optional().describe("Optional: limit search to a specific chat JID"),
+    }, async ({ query, jid }) => {
+        try {
+            if (!query.trim()) {
+                throw new Error("Search query cannot be empty");
+            }
+            const results = await searchMessages(query, jid);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: results.length
+                            ? JSON.stringify(results, null, 2)
+                            : `No messages found matching "${query}"`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    server.tool("search_contacts", "Find contacts by name or phone number.", {
+        query: z.string().describe("Name or phone number to search for"),
+    }, async ({ query }) => {
+        try {
+            const results = await searchContacts(query);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: results.length
+                            ? JSON.stringify(results, null, 2)
+                            : `No contacts found matching "${query}"`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    server.tool("get_message_context", "Get messages surrounding a specific message for context.", {
+        jid: z.string().describe("Chat JID or phone number"),
+        messageId: z.string().describe("ID of the target message"),
+        count: z.number().min(1).max(20).default(5).describe("Number of messages before and after"),
+    }, async ({ jid, messageId, count }) => {
+        try {
+            const context = await getMessageContext(jid, messageId, count);
+            return {
+                content: [{ type: "text", text: JSON.stringify(context, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    // ─── Identity Tools ─────────────────────────────────────────
+    server.tool("get_my_profile", "Get the authenticated WhatsApp user's own phone number, JID, LID JID, and display name. Use this to identify 'me' for sending messages to yourself.", {}, async () => {
+        try {
+            const info = getMyInfo();
+            if (!info.jid) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "Not connected yet — WhatsApp identity not available. Try again in a moment.",
+                        }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(info, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    // ─── Contact Management Tools ───────────────────────────────
+    server.tool("update_contact", "Update or set the display name for a contact. Updates both the contact record and chat listing so the name appears immediately everywhere.", {
+        jid: z.string().describe("Contact JID (phone@s.whatsapp.net) or phone number"),
+        name: z.string().describe("The display name to set for this contact"),
+    }, async ({ jid, name }) => {
+        try {
+            const result = await updateContact(jid, name);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    server.tool("sync_contacts", "Import phone contacts from the contacts/contacts.vcf file into the database. " +
+        "Matches phone numbers from the VCF to existing WhatsApp JIDs and updates their display names. " +
+        "Use this after a fresh QR code scan to populate contact names from your address book.", {}, async () => {
+        try {
+            const result = importContactsFromVcf(getDb());
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    // ─── Writing Tools ──────────────────────────────────────────
+    server.tool("send_message", "Send a text message to a WhatsApp contact or group. " +
+        "First call without confirmed=true returns a preview for user approval. " +
+        "Call again with confirmed=true to actually send.", {
+        jid: z.string().describe("Recipient JID (phone@s.whatsapp.net), group JID, or phone number"),
+        text: z.string().describe("Message text to send"),
+        confirmed: z.boolean().default(false).describe("Set to true to confirm and send the message. When false, returns a preview for user approval."),
+    }, async ({ jid, text, confirmed }) => {
+        try {
+            const recipient = getRecipientInfo(jid);
+            if (!confirmed) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "confirmation_required",
+                                to: recipient.name || "Unknown contact",
+                                phone: recipient.phone,
+                                jid: recipient.jid,
+                                message: text,
+                                instruction: "Show the user who this message will be sent to, their number, and the message content. Ask them to confirm before calling send_message again with confirmed=true.",
+                            }, null, 2),
+                        }],
+                };
+            }
+            const result = await sendTextMessage(jid, text);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    server.tool("send_file", "Send an image, video, audio, or document file to a WhatsApp contact or group. " +
+        "First call without confirmed=true returns a preview for user approval. " +
+        "Call again with confirmed=true to actually send.", {
+        jid: z.string().describe("Recipient JID or phone number"),
+        filePath: z.string().describe("Absolute path to the file to send"),
+        caption: z.string().optional().describe("Optional caption for the file"),
+        confirmed: z.boolean().default(false).describe("Set to true to confirm and send the file. When false, returns a preview for user approval."),
+    }, async ({ jid, filePath, caption, confirmed }) => {
+        try {
+            const recipient = getRecipientInfo(jid);
+            const allowedDir = process.env.ALLOWED_SEND_DIR || "./uploads/";
+            const maxFileSize = Number(process.env.MAX_SEND_FILE_SIZE || "67108864");
+            const validation = validateFilePath(filePath, allowedDir, maxFileSize);
+            if (!validation.valid) {
+                throw new Error(validation.error);
+            }
+            if (!confirmed) {
+                const stat = fs.statSync(validation.absolutePath);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                preview: true,
+                                fileName: path.basename(validation.absolutePath),
+                                fileSize: stat.size,
+                                recipient,
+                            }, null, 2),
+                        }],
+                };
+            }
+            const result = await sendFileMessage(jid, validation.absolutePath, caption);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    server.tool("delete_message", "Delete a message for everyone in the chat. Removes it from WhatsApp servers and the local database. For messages you didn't send, this only works in groups where you are an admin. " +
+        "First call without confirmed=true returns a preview for user approval. " +
+        "Call again with confirmed=true to actually delete.", {
+        jid: z.string().describe("Chat JID or phone number where the message is"),
+        messageId: z.string().describe("ID of the message to delete"),
+        confirmed: z.boolean().default(false).describe("Set to true to confirm and delete the message. When false, returns a preview for user approval."),
+    }, async ({ jid, messageId, confirmed }) => {
+        try {
+            if (!confirmed) {
+                const recipient = getRecipientInfo(jid);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "confirmation_required",
+                                chat: recipient.name || "Unknown contact",
+                                phone: recipient.phone,
+                                jid: recipient.jid,
+                                messageId,
+                                warning: "This will delete the message for everyone.",
+                                instruction: "Show the user the chat name, number, and message ID. Ask them to confirm before calling delete_message again with confirmed=true.",
+                            }, null, 2),
+                        }],
+                };
+            }
+            const result = await deleteMessage(jid, messageId);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    server.tool("delete_chat", "Delete an entire chat from WhatsApp. Removes the chat from your chat list and deletes all messages locally. " +
+        "First call without confirmed=true returns a preview for user approval. " +
+        "Call again with confirmed=true to actually delete.", {
+        jid: z.string().describe("Chat JID or phone number of the chat to delete"),
+        confirmed: z.boolean().default(false).describe("Set to true to confirm and delete the chat. When false, returns a preview for user approval."),
+    }, async ({ jid, confirmed }) => {
+        try {
+            if (!confirmed) {
+                const recipient = getRecipientInfo(jid);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "confirmation_required",
+                                chat: recipient.name || "Unknown contact",
+                                phone: recipient.phone,
+                                jid: recipient.jid,
+                                warning: "This will permanently delete the entire chat from your WhatsApp, including all messages.",
+                                instruction: "Show the user the chat name and number. Ask them to confirm before calling delete_chat again with confirmed=true.",
+                            }, null, 2),
+                        }],
+                };
+            }
+            const result = await deleteChat(jid);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    // ─── Media Tools ────────────────────────────────────────────
+    server.tool("download_media", "Download media (voice notes, images, videos, documents) from a received message to local disk. Returns the file path so you can read/process the content directly.", {
+        jid: z.string().describe("Chat JID or phone number where the message is"),
+        messageId: z.string().describe("ID of the message containing media"),
+    }, async ({ jid, messageId }) => {
+        try {
+            const result = await downloadMessageMedia(jid, messageId);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+    server.tool("transcribe_voice_note", "Transcribe a voice note to text. Downloads the audio from WhatsApp, " +
+        "sends it to a speech-to-text API, and returns the transcription. " +
+        "Requires WHISPER_API_KEY and WHISPER_API_URL environment variables. " +
+        "Results are cached so repeated calls for the same message are instant.", {
+        jid: z.string().describe("Chat JID or phone number where the voice note is"),
+        messageId: z.string().describe("ID of the voice note message"),
+    }, async ({ jid, messageId }) => {
+        try {
+            const result = await transcribeVoiceNote(jid, messageId);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/transcribe.d.ts

@@ -0,0 +1,8 @@
+interface TranscriptionResult {
+    text: string;
+    language?: string;
+    duration?: number;
+}
+export declare function transcribeAudio(buffer: Buffer, fileName: string): Promise<TranscriptionResult>;
+export {};
+//# sourceMappingURL=transcribe.d.ts.map

package/dist/transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe.d.ts","sourceRoot":"","sources":["../src/transcribe.ts"],"names":[],"mappings":"AAEA,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA0BD,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAgC9B"}

package/dist/transcribe.js

@@ -0,0 +1,63 @@
+import { validateApiUrl } from "./utils.js";
+function getConfig() {
+    const apiKey = process.env.WHISPER_API_KEY;
+    const apiUrl = process.env.WHISPER_API_URL;
+    if (!apiKey || !apiUrl) {
+        throw new Error("Voice note transcription requires WHISPER_API_KEY and WHISPER_API_URL environment variables. " +
+            "Set them in your Claude Desktop MCP config under the \"env\" block for the WhatsApp server.\n" +
+            "Example for Groq (free): WHISPER_API_URL=https://api.groq.com/openai/v1/audio/transcriptions, " +
+            "WHISPER_API_KEY=gsk_...\n" +
+            "Example for OpenAI: WHISPER_API_URL=https://api.openai.com/v1/audio/transcriptions, " +
+            "WHISPER_API_KEY=sk-...");
+    }
+    const validatedUrl = validateApiUrl(apiUrl);
+    return {
+        apiUrl: validatedUrl.href,
+        apiKey,
+        model: process.env.WHISPER_MODEL || "whisper-large-v3-turbo",
+    };
+}
+export async function transcribeAudio(buffer, fileName) {
+    const config = getConfig();
+    const formData = new FormData();
+    formData.append("file", new Blob([new Uint8Array(buffer)]), fileName);
+    formData.append("model", config.model);
+    formData.append("response_format", "verbose_json");
+    const response = await fetch(config.apiUrl, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${config.apiKey}`,
+        },
+        body: formData,
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Transcription API error (${response.status}): ${errorText}`);
+    }
+    const result = (await response.json());
+    return {
+        text: deduplicateText(result.text),
+        language: result.language,
+        duration: result.duration,
+    };
+}
+/**
+ * Whisper models sometimes hallucinate by repeating sentences.
+ * This detects and removes consecutive duplicate sentences.
+ */
+function deduplicateText(text) {
+    const sentences = text.match(/[^.!?]+[.!?]+/g);
+    if (!sentences)
+        return text;
+    const trimmed = sentences.map((s) => s.trim());
+    const seen = new Set();
+    const deduped = [];
+    for (const sentence of trimmed) {
+        if (!seen.has(sentence)) {
+            seen.add(sentence);
+            deduped.push(sentence);
+        }
+    }
+    return deduped.join(" ");
+}
+//# sourceMappingURL=transcribe.js.map

package/dist/transcribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe.js","sourceRoot":"","sources":["../src/transcribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQ5C,SAAS,SAAS;IAChB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAE3C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,+FAA+F;YAC/F,+FAA+F;YAC/F,gGAAgG;YAChG,2BAA2B;YAC3B,sFAAsF;YACtF,wBAAwB,CACzB,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAE5C,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,IAAI;QACzB,MAAM;QACN,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,wBAAwB;KAC7D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,QAAgB;IAEhB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACtE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC;IAEnD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;QAC1C,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;SACzC;QACD,IAAI,EAAE,QAAQ;KACf,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAIpC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC;QAClC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC/C,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Normalize a phone number or JID into proper WhatsApp JID format.
+ * Accepts: "1234567890", "+1234567890", "1234567890@s.whatsapp.net"
+ * Groups are passed through as-is if they end with @g.us
+ */
+export declare function toJid(input: string): string;
+/**
+ * Extract the readable phone number or group ID from a JID.
+ */
+export declare function fromJid(jid: string): string;
+/**
+ * Format a Unix timestamp (seconds) to a readable date string.
+ */
+export declare function formatTimestamp(ts: number | null | undefined): string;
+/**
+ * Format a SQLite message row for MCP tool responses.
+ */
+export declare function formatMessageRow(row: {
+    id: string;
+    chat_jid: string;
+    from_me: number;
+    sender_jid: string | null;
+    sender_name: string | null;
+    type: string;
+    text: string | null;
+    timestamp: number;
+    has_media: number;
+}): Record<string, unknown>;
+/**
+ * Detect media MIME type from a file extension.
+ */
+export declare function mimeFromExtension(filePath: string): string;
+/**
+ * Detect the Baileys media type key from MIME type for sending files.
+ */
+export declare function mediaCategoryFromMime(mime: string): "image" | "video" | "audio" | "document";
+export declare function validateFilePath(filePath: string, allowedDir: string, maxSizeBytes: number): {
+    valid: true;
+    absolutePath: string;
+} | {
+    valid: false;
+    error: string;
+};
+export declare function sanitizeFilename(name: string): string;
+/**
+ * Validate a Whisper API URL to prevent SSRF attacks.
+ * Rejects non-http(s) protocols, localhost, and private IP ranges.
+ * Returns the parsed URL on success; throws on violation.
+ */
+export declare function validateApiUrl(url: string): URL;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAe3C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAIrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsB1D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAK5F;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAgCzE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAeD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAsB/C"}

package/dist/utils.js

@@ -0,0 +1,156 @@
+import fs from "fs";
+import path from "path";
+/**
+ * Normalize a phone number or JID into proper WhatsApp JID format.
+ * Accepts: "1234567890", "+1234567890", "1234567890@s.whatsapp.net"
+ * Groups are passed through as-is if they end with @g.us
+ */
+export function toJid(input) {
+    const trimmed = input.trim();
+    // Already a valid JID
+    if (trimmed.endsWith("@s.whatsapp.net") || trimmed.endsWith("@g.us") || trimmed.endsWith("@lid")) {
+        return trimmed.replace(/:\d+@/, "@");
+    }
+    // Strip non-numeric characters (like +, spaces, dashes)
+    const digits = trimmed.replace(/\D/g, "");
+    if (!digits) {
+        throw new Error(`Invalid phone number or JID: "${input}"`);
+    }
+    return `${digits}@s.whatsapp.net`;
+}
+/**
+ * Extract the readable phone number or group ID from a JID.
+ */
+export function fromJid(jid) {
+    return jid.replace(/@s\.whatsapp\.net$/, "").replace(/@g\.us$/, " (group)").replace(/@lid$/, "");
+}
+/**
+ * Format a Unix timestamp (seconds) to a readable date string.
+ */
+export function formatTimestamp(ts) {
+    if (!ts)
+        return "unknown";
+    const n = typeof ts === "number" ? ts : Number(ts);
+    return new Date(n * 1000).toISOString().replace("T", " ").replace(/\.\d+Z$/, " UTC");
+}
+/**
+ * Format a SQLite message row for MCP tool responses.
+ */
+export function formatMessageRow(row) {
+    return {
+        id: row.id,
+        from: row.from_me ? "me" : (row.sender_name || row.sender_jid || row.chat_jid),
+        fromMe: !!row.from_me,
+        type: row.type,
+        text: row.text || undefined,
+        timestamp: formatTimestamp(row.timestamp),
+        hasMedia: !!row.has_media,
+    };
+}
+/**
+ * Detect media MIME type from a file extension.
+ */
+export function mimeFromExtension(filePath) {
+    const ext = filePath.split(".").pop()?.toLowerCase();
+    const map = {
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        png: "image/png",
+        gif: "image/gif",
+        webp: "image/webp",
+        mp4: "video/mp4",
+        mov: "video/quicktime",
+        avi: "video/x-msvideo",
+        mp3: "audio/mpeg",
+        ogg: "audio/ogg",
+        wav: "audio/wav",
+        pdf: "application/pdf",
+        doc: "application/msword",
+        docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        xls: "application/vnd.ms-excel",
+        xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        zip: "application/zip",
+    };
+    return map[ext || ""] || "application/octet-stream";
+}
+/**
+ * Detect the Baileys media type key from MIME type for sending files.
+ */
+export function mediaCategoryFromMime(mime) {
+    if (mime.startsWith("image/"))
+        return "image";
+    if (mime.startsWith("video/"))
+        return "video";
+    if (mime.startsWith("audio/"))
+        return "audio";
+    return "document";
+}
+export function validateFilePath(filePath, allowedDir, maxSizeBytes) {
+    const absolutePath = path.resolve(filePath);
+    const allowedDirPath = path.resolve(allowedDir);
+    const allowedPrefix = `${allowedDirPath}${path.sep}`;
+    if (!absolutePath.startsWith(allowedPrefix)) {
+        return { valid: false, error: "Path not allowed" };
+    }
+    if (!fs.existsSync(absolutePath)) {
+        return { valid: false, error: `File not found: ${absolutePath}` };
+    }
+    let stat;
+    try {
+        stat = fs.statSync(absolutePath);
+    }
+    catch (err) {
+        return { valid: false, error: err?.message || "Failed to stat file" };
+    }
+    if (!stat.isFile()) {
+        return { valid: false, error: `Not a file: ${absolutePath}` };
+    }
+    if (stat.size > maxSizeBytes) {
+        return {
+            valid: false,
+            error: `File too large: ${stat.size} bytes exceeds ${maxSizeBytes} bytes`,
+        };
+    }
+    return { valid: true, absolutePath };
+}
+export function sanitizeFilename(name) {
+    return name.replace(/[^a-zA-Z0-9._-]/g, "_");
+}
+function isPrivateIp(hostname) {
+    const ipv4Regex = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/;
+    const match = hostname.match(ipv4Regex);
+    if (!match)
+        return false;
+    const [, a, b] = match.map(Number);
+    return (a === 10 ||
+        (a === 172 && b >= 16 && b <= 31) ||
+        (a === 192 && b === 168) ||
+        (a === 169 && b === 254) // link-local / cloud metadata
+    );
+}
+/**
+ * Validate a Whisper API URL to prevent SSRF attacks.
+ * Rejects non-http(s) protocols, localhost, and private IP ranges.
+ * Returns the parsed URL on success; throws on violation.
+ */
+export function validateApiUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error(`Invalid URL: ${url}`);
+    }
+    if (!['http:', 'https:'].includes(parsed.protocol)) {
+        throw new Error(`Only http/https URLs allowed for WHISPER_API_URL (got ${parsed.protocol})`);
+    }
+    const hostname = parsed.hostname.replace(/^\[|\]$/g, ''); // strip IPv6 brackets
+    if (['localhost', '127.0.0.1', '::1'].includes(hostname)) {
+        throw new Error(`SSRF protection: localhost not allowed for WHISPER_API_URL`);
+    }
+    if (isPrivateIp(hostname)) {
+        throw new Error(`SSRF protection: Private/internal IP not allowed for WHISPER_API_URL (${hostname})`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=utils.js.map