@lhremote/core 0.1.0 → 0.2.1

package/dist/db/repositories/message.integration.test.js

@@ -0,0 +1,137 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { DatabaseClient } from "../client.js";
+import { ChatNotFoundError } from "../errors.js";
+import { FIXTURE_PATH } from "../testing/open-fixture.js";
+import { MessageRepository } from "./message.js";
+describe("MessageRepository (integration)", () => {
+    let client;
+    let repo;
+    beforeAll(() => {
+        client = new DatabaseClient(FIXTURE_PATH);
+        repo = new MessageRepository(client);
+    });
+    afterAll(() => {
+        client.close();
+    });
+    describe("listChats", () => {
+        it("lists all chats with participants and last message", () => {
+            const chats = repo.listChats();
+            expect(chats.length).toBeGreaterThanOrEqual(3);
+            const chat1 = chats.find((c) => c.id === 1);
+            expect(chat1).toBeDefined();
+            expect(chat1?.type).toBe("MEMBER_TO_MEMBER");
+            expect(chat1?.platform).toBe("LINKEDIN");
+            expect(chat1?.participants.length).toBeGreaterThanOrEqual(2);
+            expect(chat1?.messageCount).toBe(3);
+            expect(chat1?.lastMessage).not.toBeNull();
+        });
+        it("filters chats by person", () => {
+            // Person 1 (Ada) participates in chat 1, chat 2, and chat 4
+            const chats = repo.listChats({ personId: 1 });
+            expect(chats).toHaveLength(3);
+            const chatIds = chats.map((c) => c.id);
+            expect(chatIds).toContain(1);
+            expect(chatIds).toContain(2);
+            expect(chatIds).toContain(4);
+        });
+    });
+    describe("getThread", () => {
+        it("retrieves a full conversation thread from the real schema", () => {
+            const thread = repo.getThread(1);
+            expect(thread.chat.id).toBe(1);
+            expect(thread.chat.participants.length).toBeGreaterThanOrEqual(2);
+            expect(thread.messages.length).toBeGreaterThanOrEqual(3);
+            // Messages should be in chronological order
+            const sendTimes = thread.messages.map((m) => m.sendAt);
+            const sorted = [...sendTimes].sort();
+            expect(sendTimes).toEqual(sorted);
+        });
+        it("includes sender information from person_mini_profile", () => {
+            const thread = repo.getThread(1);
+            const adaMessage = thread.messages.find((m) => m.senderPersonId === 1);
+            expect(adaMessage).toBeDefined();
+            expect(adaMessage?.senderFirstName).toBe("Ada");
+            expect(adaMessage?.senderLastName).toBe("Lovelace");
+        });
+        it("throws ChatNotFoundError for a nonexistent chat", () => {
+            expect(() => repo.getThread(999)).toThrow(ChatNotFoundError);
+        });
+    });
+    describe("searchMessages", () => {
+        it("searches across all chats", () => {
+            const results = repo.searchMessages("compiler");
+            expect(results.length).toBeGreaterThanOrEqual(1);
+            for (const msg of results) {
+                expect(msg.text.toLowerCase()).toContain("compiler");
+            }
+        });
+        it("returns empty for no matches", () => {
+            const results = repo.searchMessages("zzz-no-match-zzz");
+            expect(results).toEqual([]);
+        });
+    });
+    describe("getMessageStats", () => {
+        it("returns stats across all messaging data", () => {
+            const stats = repo.getMessageStats();
+            expect(stats.totalMessages).toBeGreaterThanOrEqual(6);
+            expect(stats.totalChats).toBeGreaterThanOrEqual(3);
+            expect(stats.earliestMessage).toBeTruthy();
+            expect(stats.latestMessage).toBeTruthy();
+        });
+    });
+    describe("getMessagesSince", () => {
+        it("returns messages after a given timestamp grouped by conversation", () => {
+            // Fixture has messages at 2025-01-10, 2025-01-11, 2025-01-12, 2025-01-13, 2025-01-14
+            const conversations = repo.getMessagesSince("2025-01-12T00:00:00.000Z");
+            // Should include: msg 4 (2025-01-12), msg 5 (2025-01-13), msg 6 (2025-01-13),
+            //                 msg 7 (2025-01-14), msg 8 (2025-01-14)
+            const totalMessages = conversations.reduce((sum, c) => sum + c.messages.length, 0);
+            expect(totalMessages).toBe(5);
+            // Each conversation should have chatId, personId, personName
+            for (const conv of conversations) {
+                expect(conv.chatId).toBeGreaterThan(0);
+                expect(conv.personId).toBeGreaterThan(0);
+                expect(conv.personName).toBeTruthy();
+                expect(conv.messages.length).toBeGreaterThan(0);
+            }
+        });
+        it("returns empty array when no messages after the cutoff", () => {
+            const conversations = repo.getMessagesSince("2099-01-01T00:00:00.000Z");
+            expect(conversations).toEqual([]);
+        });
+        it("returns all messages when cutoff is before earliest message", () => {
+            const conversations = repo.getMessagesSince("2000-01-01T00:00:00.000Z");
+            const totalMessages = conversations.reduce((sum, c) => sum + c.messages.length, 0);
+            // Fixture has 8 messages total
+            expect(totalMessages).toBe(8);
+        });
+        it("groups messages by chat and sender", () => {
+            // Get messages including chat 1 (Ada ↔ Grace, 3 messages from 2 senders)
+            const conversations = repo.getMessagesSince("2025-01-09T00:00:00.000Z");
+            // Chat 1 should have 2 groups (Ada sent 2, Grace sent 1)
+            const chat1Groups = conversations.filter((c) => c.chatId === 1);
+            expect(chat1Groups).toHaveLength(2);
+        });
+    });
+    describe("cross-table consistency", () => {
+        it("chat participants reference valid people with mini profiles", () => {
+            const chats = repo.listChats();
+            for (const chat of chats) {
+                for (const participant of chat.participants) {
+                    expect(participant.personId).toBeGreaterThan(0);
+                    expect(participant.firstName).toBeTruthy();
+                }
+            }
+        });
+        it("thread messages reference valid senders from chat participants", () => {
+            const thread = repo.getThread(1);
+            const participantIds = thread.chat.participants.map((p) => p.personId);
+            for (const msg of thread.messages) {
+                expect(participantIds).toContain(msg.senderPersonId);
+            }
+        });
+    });
+});
+//# sourceMappingURL=message.integration.test.js.map

package/dist/db/repositories/message.integration.test.js.map

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

package/dist/db/repositories/message.js

@@ -0,0 +1,308 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { ChatNotFoundError } from "../errors.js";
+import { escapeLike } from "../escape-like.js";
+/**
+ * Read-only repository for querying messaging data from
+ * LinkedHelper's SQLite database.
+ */
+export class MessageRepository {
+    stmtChatById;
+    stmtChatParticipants;
+    stmtChatMessageCount;
+    stmtChatLastMessage;
+    stmtListChats;
+    stmtListChatsByPerson;
+    stmtThreadMessages;
+    stmtThreadMessagesBefore;
+    stmtSearchMessages;
+    stmtMessagesSince;
+    stmtStats;
+    constructor(client) {
+        const { db } = client;
+        this.stmtChatById = db.prepare("SELECT id, type, platform FROM chats WHERE id = ?");
+        this.stmtChatParticipants = db.prepare(`SELECT cp.person_id, mp.first_name, mp.last_name
+       FROM chat_participants cp
+       JOIN person_mini_profile mp ON cp.person_id = mp.person_id
+       WHERE cp.chat_id = ?`);
+        this.stmtChatMessageCount = db.prepare(`SELECT COUNT(DISTINCT pm.message_id) AS cnt
+       FROM chat_participants cp
+       JOIN participant_messages pm ON cp.id = pm.chat_participant_id
+       WHERE cp.chat_id = ?`);
+        this.stmtChatLastMessage = db.prepare(`SELECT m.message_text, m.send_at
+       FROM messages m
+       JOIN participant_messages pm ON m.id = pm.message_id
+       JOIN chat_participants cp ON pm.chat_participant_id = cp.id
+       WHERE cp.chat_id = ?
+       ORDER BY m.send_at DESC
+       LIMIT 1`);
+        this.stmtListChats = db.prepare(`SELECT
+         c.id AS chat_id,
+         c.type,
+         c.platform,
+         latest_msg.message_text AS last_message,
+         latest_msg.send_at AS last_message_at,
+         COALESCE(msg_count.cnt, 0) AS message_count
+       FROM chats c
+       LEFT JOIN (
+         SELECT cp2.chat_id,
+                COUNT(DISTINCT pm2.message_id) AS cnt
+         FROM chat_participants cp2
+         JOIN participant_messages pm2 ON cp2.id = pm2.chat_participant_id
+         GROUP BY cp2.chat_id
+       ) msg_count ON c.id = msg_count.chat_id
+       LEFT JOIN (
+         SELECT cp3.chat_id,
+                m3.message_text,
+                m3.send_at,
+                ROW_NUMBER() OVER (PARTITION BY cp3.chat_id ORDER BY m3.send_at DESC) AS rn
+         FROM messages m3
+         JOIN participant_messages pm3 ON m3.id = pm3.message_id
+         JOIN chat_participants cp3 ON pm3.chat_participant_id = cp3.id
+       ) latest_msg ON c.id = latest_msg.chat_id AND latest_msg.rn = 1
+       ORDER BY latest_msg.send_at DESC
+       LIMIT ? OFFSET ?`);
+        this.stmtListChatsByPerson = db.prepare(`SELECT
+         c.id AS chat_id,
+         c.type,
+         c.platform,
+         latest_msg.message_text AS last_message,
+         latest_msg.send_at AS last_message_at,
+         COALESCE(msg_count.cnt, 0) AS message_count
+       FROM chats c
+       JOIN chat_participants cp_filter ON c.id = cp_filter.chat_id
+       LEFT JOIN (
+         SELECT cp2.chat_id,
+                COUNT(DISTINCT pm2.message_id) AS cnt
+         FROM chat_participants cp2
+         JOIN participant_messages pm2 ON cp2.id = pm2.chat_participant_id
+         GROUP BY cp2.chat_id
+       ) msg_count ON c.id = msg_count.chat_id
+       LEFT JOIN (
+         SELECT cp3.chat_id,
+                m3.message_text,
+                m3.send_at,
+                ROW_NUMBER() OVER (PARTITION BY cp3.chat_id ORDER BY m3.send_at DESC) AS rn
+         FROM messages m3
+         JOIN participant_messages pm3 ON m3.id = pm3.message_id
+         JOIN chat_participants cp3 ON pm3.chat_participant_id = cp3.id
+       ) latest_msg ON c.id = latest_msg.chat_id AND latest_msg.rn = 1
+       WHERE cp_filter.person_id = ?
+       ORDER BY latest_msg.send_at DESC
+       LIMIT ? OFFSET ?`);
+        this.stmtThreadMessages = db.prepare(`SELECT
+         m.id,
+         m.message_text,
+         m.type,
+         m.subject,
+         m.send_at,
+         m.attachments_count,
+         cp.person_id AS sender_person_id,
+         mp.first_name AS sender_first_name,
+         mp.last_name AS sender_last_name
+       FROM messages m
+       JOIN participant_messages pm ON m.id = pm.message_id
+       JOIN chat_participants cp ON pm.chat_participant_id = cp.id
+       JOIN person_mini_profile mp ON cp.person_id = mp.person_id
+       WHERE cp.chat_id = ?
+       ORDER BY m.send_at ASC
+       LIMIT ?`);
+        this.stmtThreadMessagesBefore = db.prepare(`SELECT
+         m.id,
+         m.message_text,
+         m.type,
+         m.subject,
+         m.send_at,
+         m.attachments_count,
+         cp.person_id AS sender_person_id,
+         mp.first_name AS sender_first_name,
+         mp.last_name AS sender_last_name
+       FROM messages m
+       JOIN participant_messages pm ON m.id = pm.message_id
+       JOIN chat_participants cp ON pm.chat_participant_id = cp.id
+       JOIN person_mini_profile mp ON cp.person_id = mp.person_id
+       WHERE cp.chat_id = ? AND m.send_at < ?
+       ORDER BY m.send_at ASC
+       LIMIT ?`);
+        this.stmtSearchMessages = db.prepare(`SELECT
+         m.id,
+         m.message_text,
+         m.type,
+         m.subject,
+         m.send_at,
+         m.attachments_count,
+         cp.person_id AS sender_person_id,
+         mp.first_name AS sender_first_name,
+         mp.last_name AS sender_last_name
+       FROM messages m
+       JOIN participant_messages pm ON m.id = pm.message_id
+       JOIN chat_participants cp ON pm.chat_participant_id = cp.id
+       JOIN person_mini_profile mp ON cp.person_id = mp.person_id
+       WHERE m.message_text LIKE ? ESCAPE '\\'
+       ORDER BY m.send_at DESC
+       LIMIT ?`);
+        this.stmtMessagesSince = db.prepare(`SELECT
+         m.id,
+         m.message_text,
+         m.type,
+         m.subject,
+         m.send_at,
+         m.attachments_count,
+         cp.person_id AS sender_person_id,
+         mp.first_name AS sender_first_name,
+         mp.last_name AS sender_last_name,
+         cp.chat_id
+       FROM messages m
+       JOIN participant_messages pm ON m.id = pm.message_id
+       JOIN chat_participants cp ON pm.chat_participant_id = cp.id
+       JOIN person_mini_profile mp ON cp.person_id = mp.person_id
+       WHERE m.send_at > ?
+       ORDER BY m.send_at ASC`);
+        this.stmtStats = db.prepare(`SELECT
+         COUNT(DISTINCT m.id) AS total_messages,
+         COUNT(DISTINCT c.id) AS total_chats,
+         MIN(m.send_at) AS earliest_message,
+         MAX(m.send_at) AS latest_message
+       FROM chats c
+       LEFT JOIN chat_participants cp ON c.id = cp.chat_id
+       LEFT JOIN participant_messages pm ON cp.id = pm.chat_participant_id
+       LEFT JOIN messages m ON pm.message_id = m.id`);
+    }
+    /**
+     * Lists conversations, optionally filtered by a participant's person ID.
+     */
+    listChats(options) {
+        const limit = options?.limit ?? 50;
+        const offset = options?.offset ?? 0;
+        let rows;
+        if (options?.personId != null) {
+            rows = this.stmtListChatsByPerson.all(options.personId, limit, offset);
+        }
+        else {
+            rows = this.stmtListChats.all(limit, offset);
+        }
+        return rows.map((r) => this.assembleChatFromListRow(r));
+    }
+    /**
+     * Gets the full conversation thread for a chat.
+     *
+     * @throws {ChatNotFoundError} if no chat exists with the given ID.
+     */
+    getThread(chatId, options) {
+        const chatRow = this.stmtChatById.get(chatId);
+        if (!chatRow)
+            throw new ChatNotFoundError(chatId);
+        const chat = this.assembleChat(chatRow);
+        const limit = options?.limit ?? 100;
+        let messageRows;
+        if (options?.before != null) {
+            messageRows = this.stmtThreadMessagesBefore.all(chatId, options.before, limit);
+        }
+        else {
+            messageRows = this.stmtThreadMessages.all(chatId, limit);
+        }
+        const messages = messageRows.map((r) => mapMessageRow(r));
+        return { chat, messages };
+    }
+    /**
+     * Searches messages by text content using SQL LIKE.
+     */
+    searchMessages(query, options) {
+        const limit = options?.limit ?? 50;
+        const pattern = `%${escapeLike(query)}%`;
+        const rows = this.stmtSearchMessages.all(pattern, limit);
+        return rows.map((r) => mapMessageRow(r));
+    }
+    /**
+     * Returns messages received after the given ISO timestamp, grouped
+     * by conversation.  Each group identifies the sender (person) and
+     * includes the list of new messages in chronological order.
+     */
+    getMessagesSince(since) {
+        const rows = this.stmtMessagesSince.all(since);
+        // Group by (chatId, senderPersonId)
+        const groups = new Map();
+        for (const r of rows) {
+            const key = `${String(r.chat_id)}:${String(r.sender_person_id)}`;
+            let group = groups.get(key);
+            if (!group) {
+                const name = r.sender_last_name
+                    ? `${r.sender_first_name} ${r.sender_last_name}`
+                    : r.sender_first_name;
+                group = {
+                    chatId: r.chat_id,
+                    personId: r.sender_person_id,
+                    personName: name,
+                    messages: [],
+                };
+                groups.set(key, group);
+            }
+            group.messages.push(mapMessageRow(r));
+        }
+        return [...groups.values()];
+    }
+    /**
+     * Returns aggregate statistics across all messaging data.
+     */
+    getMessageStats() {
+        const row = this.stmtStats.get();
+        return {
+            totalMessages: row.total_messages,
+            totalChats: row.total_chats,
+            earliestMessage: row.earliest_message,
+            latestMessage: row.latest_message,
+        };
+    }
+    assembleChatFromListRow(row) {
+        const participants = this.getChatParticipants(row.chat_id);
+        const lastMessage = row.last_message != null && row.last_message_at != null
+            ? { text: row.last_message, sendAt: row.last_message_at }
+            : null;
+        return {
+            id: row.chat_id,
+            type: row.type,
+            platform: row.platform,
+            participants,
+            messageCount: row.message_count,
+            lastMessage,
+        };
+    }
+    assembleChat(chatRow) {
+        const participants = this.getChatParticipants(chatRow.id);
+        const countRow = this.stmtChatMessageCount.get(chatRow.id);
+        const lastMsgRow = this.stmtChatLastMessage.get(chatRow.id);
+        const lastMessage = lastMsgRow
+            ? { text: lastMsgRow.message_text, sendAt: lastMsgRow.send_at }
+            : null;
+        return {
+            id: chatRow.id,
+            type: chatRow.type,
+            platform: chatRow.platform,
+            participants,
+            messageCount: countRow.cnt,
+            lastMessage,
+        };
+    }
+    getChatParticipants(chatId) {
+        const rows = this.stmtChatParticipants.all(chatId);
+        return rows.map((r) => ({
+            personId: r.person_id,
+            firstName: r.first_name,
+            lastName: r.last_name,
+        }));
+    }
+}
+function mapMessageRow(r) {
+    return {
+        id: r.id,
+        type: r.type,
+        text: r.message_text,
+        subject: r.subject,
+        sendAt: r.send_at,
+        attachmentsCount: r.attachments_count,
+        senderPersonId: r.sender_person_id,
+        senderFirstName: r.sender_first_name,
+        senderLastName: r.sender_last_name,
+    };
+}
+//# sourceMappingURL=message.js.map

package/dist/db/repositories/message.js.map

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

package/dist/db/repositories/message.test.d.ts

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

package/dist/db/repositories/message.test.d.ts.map

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

package/dist/db/repositories/message.test.js

@@ -0,0 +1,179 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { DatabaseClient } from "../client.js";
+import { ChatNotFoundError } from "../errors.js";
+import { openFixture } from "../testing/open-fixture.js";
+import { MessageRepository } from "./message.js";
+describe("MessageRepository", () => {
+    let db;
+    let client;
+    let repo;
+    beforeEach(() => {
+        db = openFixture();
+        client = { db };
+        repo = new MessageRepository(client);
+    });
+    afterEach(() => {
+        db.close();
+    });
+    describe("listChats", () => {
+        it("returns all chats ordered by latest message", () => {
+            const chats = repo.listChats();
+            expect(chats).toHaveLength(4);
+            // Chat 4 has latest message (2025-01-14), then Chat 3 (2025-01-13), then Chat 2 (2025-01-12), then Chat 1 (2025-01-11)
+            expect(chats.map((c) => c.id)).toEqual([4, 3, 2, 1]);
+        });
+        it("includes participants for each chat", () => {
+            const chats = repo.listChats();
+            const chat1 = chats.find((c) => c.id === 1);
+            expect(chat1).toBeDefined();
+            expect(chat1?.participants).toHaveLength(2);
+            expect(chat1?.participants).toContainEqual({
+                personId: 1,
+                firstName: "Ada",
+                lastName: "Lovelace",
+            });
+            expect(chat1?.participants).toContainEqual({
+                personId: 3,
+                firstName: "Grace",
+                lastName: "Hopper",
+            });
+        });
+        it("includes last message summary", () => {
+            const chats = repo.listChats();
+            const chat1 = chats.find((c) => c.id === 1);
+            expect(chat1).toBeDefined();
+            expect(chat1?.lastMessage).toEqual({
+                text: "Let us schedule a meeting next week.",
+                sendAt: "2025-01-11T14:30:00.000Z",
+            });
+        });
+        it("includes message count", () => {
+            const chats = repo.listChats();
+            const chat1 = chats.find((c) => c.id === 1);
+            expect(chat1).toBeDefined();
+            expect(chat1?.messageCount).toBe(3);
+        });
+        it("filters by personId", () => {
+            // Person 2 (Charlie) is in chat 2, chat 3, and chat 4
+            const chats = repo.listChats({ personId: 2 });
+            expect(chats).toHaveLength(3);
+            const chatIds = chats.map((c) => c.id);
+            expect(chatIds).toContain(2);
+            expect(chatIds).toContain(3);
+            expect(chatIds).toContain(4);
+        });
+        it("respects limit parameter", () => {
+            const chats = repo.listChats({ limit: 1 });
+            expect(chats).toHaveLength(1);
+        });
+        it("respects offset parameter", () => {
+            const chats = repo.listChats({ limit: 1, offset: 1 });
+            expect(chats).toHaveLength(1);
+            expect(chats.map((c) => c.id)).toEqual([3]);
+        });
+    });
+    describe("getThread", () => {
+        it("returns messages in chronological order", () => {
+            const thread = repo.getThread(1);
+            expect(thread.messages).toHaveLength(3);
+            expect(thread.messages.map((m) => m.text)).toEqual([
+                "Hello Grace, I enjoyed your talk on compilers.",
+                "Thank you Ada! Would love to discuss analytical engines sometime.",
+                "Let us schedule a meeting next week.",
+            ]);
+        });
+        it("includes sender information", () => {
+            const thread = repo.getThread(1);
+            const adaMsg = thread.messages.find((m) => m.senderPersonId === 1);
+            const graceMsg = thread.messages.find((m) => m.senderPersonId === 3);
+            expect(adaMsg).toBeDefined();
+            expect(adaMsg?.senderFirstName).toBe("Ada");
+            expect(adaMsg?.senderLastName).toBe("Lovelace");
+            expect(graceMsg).toBeDefined();
+            expect(graceMsg?.senderFirstName).toBe("Grace");
+        });
+        it("includes chat metadata", () => {
+            const thread = repo.getThread(1);
+            expect(thread.chat.id).toBe(1);
+            expect(thread.chat.type).toBe("MEMBER_TO_MEMBER");
+            expect(thread.chat.platform).toBe("LINKEDIN");
+            expect(thread.chat.participants).toHaveLength(2);
+            expect(thread.chat.messageCount).toBe(3);
+        });
+        it("includes attachments count", () => {
+            const thread = repo.getThread(1);
+            const msgWithAttachment = thread.messages.find((m) => m.text === "Let us schedule a meeting next week.");
+            expect(msgWithAttachment).toBeDefined();
+            expect(msgWithAttachment?.attachmentsCount).toBe(1);
+        });
+        it("includes subject for InMail-style messages", () => {
+            const thread = repo.getThread(2);
+            const msg = thread.messages.find((m) => m.text === "Hi Charlie, we have an opening on our team.");
+            expect(msg).toBeDefined();
+            expect(msg?.subject).toBe("Job Opportunity");
+        });
+        it("respects limit parameter", () => {
+            const thread = repo.getThread(1, { limit: 2 });
+            expect(thread.messages).toHaveLength(2);
+        });
+        it("supports before parameter for pagination", () => {
+            const thread = repo.getThread(1, {
+                before: "2025-01-11T00:00:00.000Z",
+            });
+            expect(thread.messages).toHaveLength(2);
+            expect(thread.messages.map((m) => m.text)).toEqual([
+                "Hello Grace, I enjoyed your talk on compilers.",
+                "Thank you Ada! Would love to discuss analytical engines sometime.",
+            ]);
+        });
+        it("throws ChatNotFoundError for a missing chat", () => {
+            expect(() => repo.getThread(999)).toThrow(ChatNotFoundError);
+            expect(() => repo.getThread(999)).toThrow("Chat not found for id 999");
+        });
+    });
+    describe("searchMessages", () => {
+        it("finds messages containing search text", () => {
+            const results = repo.searchMessages("compiler");
+            expect(results).toHaveLength(2);
+            // Results are ordered by send_at DESC
+            expect(results.map((m) => m.text)).toEqual([
+                "Charlie, have you tried the new COBOL compiler?",
+                "Hello Grace, I enjoyed your talk on compilers.",
+            ]);
+        });
+        it("returns empty array for no matches", () => {
+            const results = repo.searchMessages("nonexistent-query-xyz");
+            expect(results).toEqual([]);
+        });
+        it("respects limit parameter", () => {
+            const results = repo.searchMessages("compiler", { limit: 1 });
+            expect(results).toHaveLength(1);
+        });
+        it("is case-insensitive via LIKE", () => {
+            const results = repo.searchMessages("COBOL");
+            expect(results.length).toBeGreaterThanOrEqual(1);
+        });
+        it("escapes percent wildcard in search query", () => {
+            const results = repo.searchMessages("100%");
+            expect(results).toHaveLength(1);
+            expect(results[0]?.text).toBe("We achieved 100% coverage on the test suite!");
+        });
+        it("escapes underscore wildcard in search query", () => {
+            const results = repo.searchMessages("field_name");
+            expect(results).toHaveLength(1);
+            expect(results[0]?.text).toBe("The field_name parameter needs updating.");
+        });
+    });
+    describe("getMessageStats", () => {
+        it("returns aggregate statistics", () => {
+            const stats = repo.getMessageStats();
+            expect(stats.totalMessages).toBe(8);
+            expect(stats.totalChats).toBe(4);
+            expect(stats.earliestMessage).toBe("2025-01-10T09:00:00.000Z");
+            expect(stats.latestMessage).toBe("2025-01-14T09:30:00.000Z");
+        });
+    });
+});
+//# sourceMappingURL=message.test.js.map