imessage-bot 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 imessage-bot contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,251 @@
+# imessage-bot
+
+> **Use at your own risk.** This project reads from your local iMessage database and sends messages via AppleScript. The author is not liable for any unintended messages sent, data accessed, or consequences arising from use of this software. Review the code before running it.
+
+A Node.js toolkit for reading and responding to iMessages on macOS.
+
+I originally built this to power a weight-tracking accountability bot for a friend group — members log their weight via iMessage commands, the bot parses them and stores the data. Friends wanted to use the polling layer for their own projects, so I extracted it into this standalone toolkit.
+
+Poll any iMessage group chat or direct message, react to commands, and send replies — all from a TypeScript script running on your Mac.
+
+## Requirements
+
+- **macOS** (uses the local Messages database and AppleScript)
+- **Node.js 18+**
+- **Full Disk Access** granted to Terminal (or your IDE) — see below
+
+---
+
+## ⚠️ Full Disk Access — Read This First
+
+This is the most common setup issue. Without it, Node.js cannot read `~/Library/Messages/chat.db` and you'll get a permission error immediately.
+
+### How to grant it
+
+1. Open **System Settings → Privacy & Security → Full Disk Access**
+2. Click the **+** button and add **Terminal.app** (located in `/Applications/Utilities/`)
+3. Make sure the toggle next to Terminal is **on**
+4. Fully quit and reopen Terminal
+
+### Known UI quirk
+
+On some macOS versions, after adding Terminal via the **+** button it may not appear visually in the list — but it has actually been granted. This is a known display glitch.
+
+**To verify it actually worked**, run this in Terminal:
+
+```bash
+sqlite3 ~/Library/Messages/chat.db ".tables"
+```
+
+- If you see a list of table names → Full Disk Access is working correctly.
+- If you see `unable to open database file` → it was not granted. Try removing and re-adding Terminal, then restart your Mac.
+
+> If you're running your bot from VS Code or another IDE instead of Terminal, you need to grant Full Disk Access to **that app** instead.
+
+## Installation
+
+```bash
+git clone https://github.com/yourusername/imessage-bot.git
+cd imessage-bot
+npm install
+```
+
+## Quick Start
+
+### 1. Find your chat GUID
+
+```bash
+npm run find-chats
+```
+
+This lists all your iMessage chats with their GUIDs. Copy the one you want.
+
+### 2. Write your bot
+
+```ts
+// my-bot.ts
+import { createPoller } from './src/index.js';
+
+const bot = createPoller({
+  chatGuid: 'iMessage;+;chat123456789', // paste your GUID here
+  onMessage: async ({ message, reply }) => {
+    if (message.text === '!ping') {
+      await reply('pong!');
+    }
+  },
+});
+
+bot.start();
+```
+
+```bash
+npx tsx my-bot.ts
+```
+
+That's it. Your bot is running.
+
+---
+
+## API
+
+### `createPoller(options)`
+
+The main entry point. Returns a `Poller` with `start()` and `stop()` methods.
+
+```ts
+import { createPoller } from './src/index.js';
+
+const bot = createPoller({
+  chatGuid: 'iMessage;+;chat123',   // required
+  pollIntervalMs: 10_000,           // default: 10 seconds
+  seedWeeksBack: 1,                 // how far back to look on first run (just for watermarking, not processing)
+  stateFile: '~/.my-bot-state.json', // where to persist the ROWID watermark
+
+  onReady: ({ chatGuid, stateFile }) => {
+    console.log(`Bot started, state at ${stateFile}`);
+  },
+
+  onMessage: async ({ message, reply, chatGuid }) => {
+    // message.text     — the message text
+    // message.senderId — phone number (e.g. "+15551234567") or "Me"
+    // message.isFromMe — boolean
+    // message.date     — JS timestamp in ms
+    // message.rowid    — iMessage database row ID
+    // reply(text)      — send a reply to the same chat
+    // chatGuid         — the GUID of the chat
+  },
+
+  onError: (err) => {
+    console.error('Error:', err.message);
+  },
+});
+
+bot.start();
+// bot.stop(); // gracefully stops polling
+```
+
+### `sendMessage(chatGuid, text)`
+
+Send a message to any chat directly, without the poller.
+
+```ts
+import { sendMessage } from './src/index.js';
+
+await sendMessage('iMessage;+;chat123', 'Hello from my bot!');
+```
+
+### `findChats(options?)`
+
+List chats programmatically.
+
+```ts
+import { findChats } from './src/index.js';
+
+const all = findChats();               // all chats
+const groups = findChats({ groupOnly: true, limit: 20 }); // group chats only
+```
+
+Returns `ChatInfo[]`:
+
+```ts
+interface ChatInfo {
+  guid: string;
+  displayName: string | null;
+  chatIdentifier: string;
+  isGroup: boolean;
+}
+```
+
+### `getChatParticipants(chatGuid)`
+
+Get the phone numbers of all participants in a chat.
+
+```ts
+import { getChatParticipants } from './src/index.js';
+
+const numbers = getChatParticipants('iMessage;+;chat123');
+// ['+15551234567', '+15559876543']
+```
+
+---
+
+## Examples
+
+Both examples are ready to run after replacing `YOUR_CHAT_GUID_HERE`.
+
+| Example | Command | What it does |
+|---|---|---|
+| Echo bot | `npx tsx examples/echo-bot.ts` | `!echo` and `!ping` commands |
+| Weight bot | `npx tsx examples/weight-bot.ts` | `/w` weight logging with history |
+
+---
+
+## Running as a Background Service (launchd)
+
+To keep your bot running permanently on macOS, register it as a launchd agent.
+
+Create `~/Library/LaunchAgents/com.imessage-bot.mybot.plist`:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.imessage-bot.mybot</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/local/bin/node</string>
+    <string>--import</string>
+    <string>tsx/esm</string>
+    <string>/absolute/path/to/my-bot.ts</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>/tmp/imessage-bot.log</string>
+  <key>StandardErrorPath</key>
+  <string>/tmp/imessage-bot.err</string>
+</dict>
+</plist>
+```
+
+```bash
+launchctl load ~/Library/LaunchAgents/com.imessage-bot.mybot.plist
+launchctl start com.imessage-bot.mybot
+```
+
+---
+
+## How It Works
+
+```
+iMessage → chat.db (SQLite, read-only)
+               ↓  polled every N seconds via ROWID watermark
+          imessage-bot
+               ↓  onMessage handler
+          your code (store data, call APIs, etc.)
+               ↓  reply()
+          AppleScript → Messages.app → iMessage reply
+```
+
+**ROWID watermark**: The poller tracks the last-seen message row ID in a local state file. On each poll it only fetches rows newer than that ID — no duplicate processing, no re-reading old messages.
+
+**First run**: On first start, the poller seeds the watermark from existing messages without processing them. Your bot only reacts to messages sent *after* it starts for the first time.
+
+---
+
+## Limitations
+
+- macOS only — relies on `~/Library/Messages/chat.db` and AppleScript
+- Requires the Mac to be awake and Messages.app to be running
+- Sending messages via AppleScript requires Messages.app to be signed in to the Apple ID that owns the chat
+- Polling is not real-time — default latency is up to 10 seconds (configurable)
+
+---
+
+## License
+
+MIT

package/dist/db.d.ts

@@ -0,0 +1,33 @@
+export interface ChatInfo {
+    guid: string;
+    displayName: string | null;
+    chatIdentifier: string;
+    isGroup: boolean;
+}
+export interface RawMessage {
+    rowid: number;
+    text: string;
+    date: number;
+    senderId: string;
+    isFromMe: boolean;
+}
+/**
+ * List chats. By default returns all chats.
+ * Pass `groupOnly: true` to return only group chats.
+ */
+export declare function findChats(options?: {
+    limit?: number;
+    groupOnly?: boolean;
+}): ChatInfo[];
+/**
+ * Fetch messages from a chat.
+ *
+ * - `lastSeenRowId > 0` → only messages newer than that ROWID (normal polling)
+ * - `lastSeenRowId === 0` → messages from the last `weeksBack` weeks (first-run seed)
+ */
+export declare function getMessagesFromChat(chatGuid: string, weeksBack?: number, lastSeenRowId?: number): RawMessage[];
+/**
+ * Get all participant phone numbers for a chat.
+ */
+export declare function getChatParticipants(chatGuid: string): string[];
+//# 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":"AASA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAoED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,QAAQ,EAAE,CA+B3F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAI,EACb,aAAa,SAAI,GAChB,UAAU,EAAE,CAmEd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAe9D"}

package/dist/db.js

@@ -0,0 +1,170 @@
+import Database from "better-sqlite3";
+import { join } from "path";
+import { existsSync } from "fs";
+import { Unarchiver } from "node-typedstream";
+const DB_PATH = join(process.env.HOME || "", "Library/Messages/chat.db");
+// ─── Internal helpers ────────────────────────────────────────────────────────
+function getDb() {
+    if (!existsSync(DB_PATH)) {
+        throw new Error(`iMessage database not found at ${DB_PATH}.\n` +
+            `Make sure Full Disk Access is enabled for Terminal (or your IDE) in:\n` +
+            `System Settings → Privacy & Security → Full Disk Access`);
+    }
+    return new Database(DB_PATH, { readonly: true });
+}
+/**
+ * Apple stores timestamps as nanoseconds since 2001-01-01.
+ * Convert to a standard JS timestamp (ms since 1970-01-01).
+ */
+function appleTimestampToMs(ts) {
+    const APPLE_EPOCH_OFFSET_S = 978307200; // seconds between Unix and Apple epochs
+    return (ts / 1_000_000_000 + APPLE_EPOCH_OFFSET_S) * 1000;
+}
+/**
+ * Decode binary iMessage attributedBody blobs (NSAttributedString).
+ * Uses node-typedstream — the same approach used by BlueBubbles server.
+ */
+function extractTextFromAttributedBody(body) {
+    if (!body || body.length === 0)
+        return null;
+    try {
+        const decoded = Unarchiver.open(body).decodeAll();
+        if (!decoded)
+            return null;
+        const items = (Array.isArray(decoded) ? decoded : [decoded]).flat();
+        for (const item of items) {
+            if (item && typeof item === "object") {
+                if ("string" in item && typeof item.string === "string" && item.string.trim()) {
+                    return item.string.trim();
+                }
+                if ("values" in item && Array.isArray(item.values)) {
+                    for (const val of item.values) {
+                        if (val && typeof val === "object" && "string" in val && typeof val.string === "string" && val.string.trim()) {
+                            return val.string.trim();
+                        }
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * List chats. By default returns all chats.
+ * Pass `groupOnly: true` to return only group chats.
+ */
+export function findChats(options = {}) {
+    const { limit = 50, groupOnly = false } = options;
+    const db = getDb();
+    const query = `
+    SELECT c.guid, c.display_name, c.chat_identifier, c.style
+    FROM chat c
+    LEFT JOIN (
+      SELECT cmj.chat_id, MAX(m.date) AS last_date
+      FROM message m
+      INNER JOIN chat_message_join cmj ON m.ROWID = cmj.message_id
+      GROUP BY cmj.chat_id
+    ) last ON c.ROWID = last.chat_id
+    ${groupOnly ? "WHERE c.style = 43" : ""}
+    ORDER BY last.last_date DESC NULLS LAST
+    LIMIT ?
+  `;
+    const rows = db.prepare(query).all(limit);
+    db.close();
+    return rows.map((r) => ({
+        guid: r.guid,
+        displayName: r.display_name,
+        chatIdentifier: r.chat_identifier,
+        isGroup: r.style === 43,
+    }));
+}
+/**
+ * Fetch messages from a chat.
+ *
+ * - `lastSeenRowId > 0` → only messages newer than that ROWID (normal polling)
+ * - `lastSeenRowId === 0` → messages from the last `weeksBack` weeks (first-run seed)
+ */
+export function getMessagesFromChat(chatGuid, weeksBack = 1, lastSeenRowId = 0) {
+    const db = getDb();
+    let query;
+    let params;
+    if (lastSeenRowId > 0) {
+        query = `
+      SELECT
+        m.ROWID          AS rowid,
+        m.text,
+        m.attributedBody,
+        m.date,
+        m.is_from_me,
+        COALESCE(h.id, 'Me') AS sender_id
+      FROM message m
+      INNER JOIN chat_message_join cmj ON m.ROWID = cmj.message_id
+      INNER JOIN chat c               ON cmj.chat_id = c.ROWID
+      LEFT  JOIN handle h             ON m.handle_id = h.ROWID
+      WHERE c.guid = ?
+        AND m.ROWID > ?
+        AND (m.text IS NOT NULL OR m.attributedBody IS NOT NULL)
+      ORDER BY m.ROWID ASC
+    `;
+        params = [chatGuid, lastSeenRowId];
+    }
+    else {
+        const startMs = Date.now() - weeksBack * 7 * 24 * 60 * 60 * 1000;
+        const APPLE_EPOCH_OFFSET_S = 978307200;
+        const startApple = (startMs / 1000 - APPLE_EPOCH_OFFSET_S) * 1_000_000_000;
+        query = `
+      SELECT
+        m.ROWID          AS rowid,
+        m.text,
+        m.attributedBody,
+        m.date,
+        m.is_from_me,
+        COALESCE(h.id, 'Me') AS sender_id
+      FROM message m
+      INNER JOIN chat_message_join cmj ON m.ROWID = cmj.message_id
+      INNER JOIN chat c               ON cmj.chat_id = c.ROWID
+      LEFT  JOIN handle h             ON m.handle_id = h.ROWID
+      WHERE c.guid = ?
+        AND m.date > ?
+        AND (m.text IS NOT NULL OR m.attributedBody IS NOT NULL)
+      ORDER BY m.ROWID ASC
+    `;
+        params = [chatGuid, startApple];
+    }
+    const rows = db.prepare(query).all(...params);
+    db.close();
+    return rows
+        .map((row) => {
+        const text = row.text || extractTextFromAttributedBody(row.attributedBody);
+        if (!text?.trim())
+            return null;
+        return {
+            rowid: row.rowid,
+            text: text.trim(),
+            date: appleTimestampToMs(row.date),
+            senderId: row.is_from_me ? "Me" : row.sender_id,
+            isFromMe: row.is_from_me === 1,
+        };
+    })
+        .filter((m) => m !== null);
+}
+/**
+ * Get all participant phone numbers for a chat.
+ */
+export function getChatParticipants(chatGuid) {
+    const db = getDb();
+    const rows = db
+        .prepare(`SELECT h.id
+       FROM handle h
+       INNER JOIN chat_handle_join chj ON h.ROWID = chj.handle_id
+       INNER JOIN chat c               ON chj.chat_id = c.ROWID
+       WHERE c.guid = ?`)
+        .all(chatGuid);
+    db.close();
+    return rows.map((r) => r.id);
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/find-chats.d.ts

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

package/dist/find-chats.d.ts.map

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

package/dist/find-chats.js

@@ -0,0 +1,44 @@
+/**
+ * CLI utility to discover your iMessage chat GUIDs.
+ *
+ * Run with: npm run find-chats
+ *
+ * Copy the GUID of your target chat and use it as the `chatGuid` option
+ * when calling `createPoller()`.
+ *
+ * Note: Group chat names are only stored in chat.db when the group has been
+ * explicitly named inside Messages.app. Otherwise the name is NULL — this is
+ * a macOS limitation, not a bug. Participants are shown so you can identify
+ * which chat is which.
+ */
+import { findChats, getChatParticipants } from "./db.js";
+console.log("🔍 Scanning iMessage chats...\n");
+const chats = findChats({ limit: 50 });
+if (chats.length === 0) {
+    console.log("No chats found. Make sure Full Disk Access is enabled for Terminal.");
+    console.log("System Settings → Privacy & Security → Full Disk Access");
+    process.exit(1);
+}
+const groups = chats.filter((c) => c.isGroup);
+const direct = chats.filter((c) => !c.isGroup);
+if (groups.length > 0) {
+    console.log(`─── Group Chats (${groups.length}) ─────────────────────────`);
+    for (const chat of groups) {
+        const participants = getChatParticipants(chat.guid);
+        const name = chat.displayName || "(no name set in Messages.app)";
+        console.log(`Name         : ${name}`);
+        console.log(`GUID         : ${chat.guid}`);
+        console.log(`Participants : ${participants.length > 0 ? participants.join(", ") : "none found"}`);
+        console.log("");
+    }
+}
+if (direct.length > 0) {
+    console.log(`─── Direct Messages (${direct.length}) ──────────────────────`);
+    for (const chat of direct) {
+        console.log(`Contact : ${chat.chatIdentifier}`);
+        console.log(`GUID    : ${chat.guid}`);
+        console.log("");
+    }
+}
+console.log("💡 Copy the GUID above and pass it as chatGuid to createPoller().");
+//# sourceMappingURL=find-chats.js.map

package/dist/find-chats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-chats.js","sourceRoot":"","sources":["../src/find-chats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEzD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAE/C,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AAEvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAC;IACnF,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAE/C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,MAAM,6BAA6B,CAAC,CAAC;IAC5E,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,IAAI,+BAA+B,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,kBAAkB,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QAClG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,MAAM,0BAA0B,CAAC,CAAC;IAC7E,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createPoller } from "./poller.js";
+export type { PollerOptions, Poller, MessageContext } from "./poller.js";
+export { sendMessage } from "./messenger.js";
+export { findChats, getMessagesFromChat, getChatParticipants } from "./db.js";
+export type { ChatInfo, RawMessage } from "./db.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9E,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Core bot API
+export { createPoller } from "./poller.js";
+// Low-level messaging
+export { sendMessage } from "./messenger.js";
+// Database utilities
+export { findChats, getMessagesFromChat, getChatParticipants } from "./db.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,qBAAqB;AACrB,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/dist/messenger.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Send a message to an iMessage chat via AppleScript.
+ *
+ * Requires Messages.app to be signed in and the chat to exist.
+ * The `chatGuid` can be obtained from `findChats()` or `npm run find-chats`.
+ */
+export declare function sendMessage(chatGuid: string, text: string): Promise<void>;
+//# sourceMappingURL=messenger.d.ts.map

package/dist/messenger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messenger.d.ts","sourceRoot":"","sources":["../src/messenger.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa/E"}

package/dist/messenger.js

@@ -0,0 +1,22 @@
+import { exec } from "child_process";
+import { promisify } from "util";
+const execAsync = promisify(exec);
+/**
+ * Send a message to an iMessage chat via AppleScript.
+ *
+ * Requires Messages.app to be signed in and the chat to exist.
+ * The `chatGuid` can be obtained from `findChats()` or `npm run find-chats`.
+ */
+export async function sendMessage(chatGuid, text) {
+    // Escape for AppleScript string literal
+    const escaped = text.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    const script = `
+    tell application "Messages"
+      set targetChat to chat id "${chatGuid}"
+      send "${escaped}" to targetChat
+    end tell
+  `;
+    // Escape single quotes for the shell -e argument
+    await execAsync(`osascript -e '${script.replace(/'/g, "'\\''")}'`);
+}
+//# sourceMappingURL=messenger.js.map

package/dist/messenger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messenger.js","sourceRoot":"","sources":["../src/messenger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,IAAY;IAC9D,wCAAwC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAEjE,MAAM,MAAM,GAAG;;mCAEkB,QAAQ;cAC7B,OAAO;;GAElB,CAAC;IAEF,iDAAiD;IACjD,MAAM,SAAS,CAAC,iBAAiB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;AACrE,CAAC"}

package/dist/poller.d.ts

@@ -0,0 +1,75 @@
+import { type RawMessage } from "./db.js";
+export type { RawMessage };
+export interface MessageContext {
+    /** The incoming message */
+    message: RawMessage;
+    /** The GUID of the chat this message was received in */
+    chatGuid: string;
+    /** Send a reply to the same chat */
+    reply: (text: string) => Promise<void>;
+}
+export interface PollerOptions {
+    /** Chat GUID to monitor. Get this by running: npm run find-chats */
+    chatGuid: string;
+    /**
+     * How often to poll for new messages, in milliseconds.
+     * @default 10000 (10 seconds)
+     */
+    pollIntervalMs?: number;
+    /**
+     * On first run, how many weeks back to seed the ROWID watermark from.
+     * Messages in this window are NOT processed — the poller just advances past them
+     * so it only reacts to messages sent after it starts.
+     * @default 1
+     */
+    seedWeeksBack?: number;
+    /**
+     * Where to persist the ROWID watermark between restarts.
+     * Defaults to ~/.imessage-bot-<hash>.json (one file per chatGuid).
+     */
+    stateFile?: string;
+    /**
+     * Called for every new message received in the chat.
+     * Use `context.reply(text)` to respond.
+     */
+    onMessage: (context: MessageContext) => Promise<void> | void;
+    /**
+     * Called when an error occurs during a poll cycle.
+     * If not provided, errors are logged to stderr.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Called once when the poller starts.
+     */
+    onReady?: (info: {
+        chatGuid: string;
+        stateFile: string;
+    }) => void;
+}
+export interface Poller {
+    /** Start polling. Safe to call once. */
+    start(): void;
+    /** Stop polling and clear the interval. */
+    stop(): void;
+}
+/**
+ * Create an iMessage bot that polls a chat for new messages.
+ *
+ * @example
+ * ```ts
+ * import { createPoller } from 'imessage-bot';
+ *
+ * const bot = createPoller({
+ *   chatGuid: 'iMessage;+;chat123456',
+ *   onMessage: async ({ message, reply }) => {
+ *     if (message.text === '!ping') {
+ *       await reply('pong!');
+ *     }
+ *   },
+ * });
+ *
+ * bot.start();
+ * ```
+ */
+export declare function createPoller(options: PollerOptions): Poller;
+//# sourceMappingURL=poller.d.ts.map

package/dist/poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poller.d.ts","sourceRoot":"","sources":["../src/poller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAO/D,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,OAAO,EAAE,UAAU,CAAC;IACpB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE7D;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,MAAM;IACrB,wCAAwC;IACxC,KAAK,IAAI,IAAI,CAAC;IACd,2CAA2C;IAC3C,IAAI,IAAI,IAAI,CAAC;CACd;AA4BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAqF3D"}

package/dist/poller.js

@@ -0,0 +1,120 @@
+import { getMessagesFromChat } from "./db.js";
+import { sendMessage } from "./messenger.js";
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { join } from "path";
+// ─── State helpers ───────────────────────────────────────────────────────────
+function defaultStateFile(chatGuid) {
+    // Derive a short stable slug from the chat GUID so multiple bots don't collide
+    const slug = Buffer.from(chatGuid).toString("base64url").slice(0, 16);
+    return join(process.env.HOME || "", `.imessage-bot-${slug}.json`);
+}
+function loadState(stateFile) {
+    try {
+        if (existsSync(stateFile)) {
+            const data = JSON.parse(readFileSync(stateFile, "utf-8"));
+            return typeof data.lastSeenRowId === "number" ? data.lastSeenRowId : 0;
+        }
+    }
+    catch {
+        // corrupt or missing — start fresh
+    }
+    return 0;
+}
+function saveState(stateFile, lastSeenRowId) {
+    writeFileSync(stateFile, JSON.stringify({ lastSeenRowId }), "utf-8");
+}
+// ─── createPoller ────────────────────────────────────────────────────────────
+/**
+ * Create an iMessage bot that polls a chat for new messages.
+ *
+ * @example
+ * ```ts
+ * import { createPoller } from 'imessage-bot';
+ *
+ * const bot = createPoller({
+ *   chatGuid: 'iMessage;+;chat123456',
+ *   onMessage: async ({ message, reply }) => {
+ *     if (message.text === '!ping') {
+ *       await reply('pong!');
+ *     }
+ *   },
+ * });
+ *
+ * bot.start();
+ * ```
+ */
+export function createPoller(options) {
+    const { chatGuid, pollIntervalMs = 10_000, seedWeeksBack = 1, onMessage, onError, onReady, } = options;
+    const stateFile = options.stateFile ?? defaultStateFile(chatGuid);
+    let lastSeenRowId = loadState(stateFile);
+    let intervalHandle = null;
+    let running = false;
+    async function poll() {
+        try {
+            const isFirstRun = lastSeenRowId === 0;
+            const messages = getMessagesFromChat(chatGuid, seedWeeksBack, lastSeenRowId);
+            if (isFirstRun) {
+                if (messages.length > 0) {
+                    lastSeenRowId = Math.max(...messages.map((m) => m.rowid));
+                    saveState(stateFile, lastSeenRowId);
+                }
+                return;
+            }
+            if (messages.length === 0)
+                return;
+            for (const message of messages) {
+                const context = {
+                    message,
+                    chatGuid,
+                    reply: (text) => sendMessage(chatGuid, text),
+                };
+                try {
+                    await onMessage(context);
+                }
+                catch (err) {
+                    const error = err instanceof Error ? err : new Error(String(err));
+                    if (onError) {
+                        onError(error);
+                    }
+                    else {
+                        console.error(`[imessage-bot] onMessage error:`, error.message);
+                    }
+                }
+            }
+            lastSeenRowId = Math.max(...messages.map((m) => m.rowid));
+            saveState(stateFile, lastSeenRowId);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            if (onError) {
+                onError(error);
+            }
+            else {
+                console.error(`[imessage-bot] Poll error:`, error.message);
+            }
+        }
+    }
+    return {
+        start() {
+            if (running)
+                return;
+            running = true;
+            onReady?.({ chatGuid, stateFile });
+            // Immediate first poll, then on interval
+            poll();
+            intervalHandle = setInterval(poll, pollIntervalMs);
+            process.on("SIGINT", () => this.stop());
+            process.on("SIGTERM", () => this.stop());
+        },
+        stop() {
+            if (!running)
+                return;
+            running = false;
+            if (intervalHandle !== null) {
+                clearInterval(intervalHandle);
+                intervalHandle = null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=poller.js.map

package/dist/poller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poller.js","sourceRoot":"","sources":["../src/poller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAmB,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAgE5B,gFAAgF;AAEhF,SAAS,gBAAgB,CAAC,QAAgB;IACxC,+EAA+E;IAC/E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,iBAAiB,IAAI,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,SAAS,CAAC,SAAiB;IAClC,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;YAC1D,OAAO,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,SAAS,CAAC,SAAiB,EAAE,aAAqB;IACzD,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,MAAM,EACJ,QAAQ,EACR,cAAc,GAAG,MAAM,EACvB,aAAa,GAAG,CAAC,EACjB,SAAS,EACT,OAAO,EACP,OAAO,GACR,GAAG,OAAO,CAAC;IAEZ,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAClE,IAAI,aAAa,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,cAAc,GAA0C,IAAI,CAAC;IACjE,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,UAAU,IAAI;QACjB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,aAAa,KAAK,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;YAE7E,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC1D,SAAS,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBACtC,CAAC;gBACD,OAAO;YACT,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAElC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAmB;oBAC9B,OAAO;oBACP,QAAQ;oBACR,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC;iBACrD,CAAC;gBAEF,IAAI,CAAC;oBACH,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;gBAC3B,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;oBAClE,IAAI,OAAO,EAAE,CAAC;wBACZ,OAAO,CAAC,KAAK,CAAC,CAAC;oBACjB,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;oBAClE,CAAC;gBACH,CAAC;YACH,CAAC;YAED,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1D,SAAS,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;YACH,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YAEf,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;YAEnC,yCAAyC;YACzC,IAAI,EAAE,CAAC;YACP,cAAc,GAAG,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAEnD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI;YACF,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,OAAO,GAAG,KAAK,CAAC;YAChB,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5B,aAAa,CAAC,cAAc,CAAC,CAAC;gBAC9B,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "imessage-bot",
+  "version": "0.1.0",
+  "description": "A Node.js toolkit for reading and responding to iMessages on macOS",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "find-chats": "npx tsx src/find-chats.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["imessage", "bot", "macos", "messages", "automation", "applescript", "sqlite"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0",
+    "os": ["darwin"]
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  },
+  "dependencies": {
+    "better-sqlite3": "^9.4.0",
+    "node-typedstream": "^1.4.1"
+  }
+}