@hardlydifficult/chat 1.1.27 → 1.1.29

package/README.md

@@ -15,6 +15,7 @@ import { createChatClient } from "@hardlydifficult/chat";
 
 const client = createChatClient({ type: "discord" });
 const channel = await client.connect(channelId);
+console.log(client.me?.mention); // "<@123...>"
 
 // Post messages
 await channel.postMessage("Hello!");
@@ -37,6 +38,19 @@ createChatClient({ type: "slack" });
 createChatClient({ type: "slack", token: "...", appToken: "..." });
 ```
 
+## Bot Identity
+
+After `connect()`, `client.me` exposes the authenticated bot user:
+
+```typescript
+const client = createChatClient({ type: "slack" });
+await client.connect(channelId);
+
+console.log(client.me?.id); // "U09B00R2R96"
+console.log(client.me?.username); // "sprint-bot"
+console.log(client.me?.mention); // "<@U09B00R2R96>"
+```
+
 ## Incoming Messages
 
 Subscribe to new messages in a channel. The callback receives a full `Message` object — you can delete it, react to it, or reply in its thread.
@@ -110,6 +124,7 @@ const msg = await channel.postMessage("Hello");
 await msg.update("Updated content");
 msg.reply("Thread reply");
 await msg.delete();
+await msg.delete({ cascadeReplies: false }); // keep thread replies
 ```
 
 ### Reactions
@@ -177,6 +192,48 @@ if (postedAt !== undefined) {
 
 `post()` is fire-and-forget. `edit()` handles the race where the edit arrives before the original post completes — it chains on the stored promise.
 
+### Message Batches
+
+Group related posted messages so they can be retrieved and cleaned up together.
+
+```typescript
+const batch = await channel.beginBatch({ key: "sprint-update" });
+
+for (const member of members) {
+  const msg = await batch.post(summary(member));
+  await msg.reply(detail(member));
+}
+
+await batch.post(callouts);
+await batch.finish();
+
+const recent = await channel.getBatches({
+  key: "sprint-update",
+  author: "me",
+  limit: 5,
+});
+
+await recent[0].deleteAll({ cascadeReplies: true });
+```
+
+For safer lifecycle handling, use `withBatch` (auto-finishes in `finally`):
+
+```typescript
+await channel.withBatch({ key: "sprint-update" }, async (batch) => {
+  await batch.post("Part 1");
+  await batch.post("Part 2");
+});
+```
+
+`MessageBatch` includes:
+
+- `id`, `key`, `author`, `createdAt`, `closedAt`, `isFinished`
+- `messages` (tracked message refs)
+- `post(content, options?)`
+- `deleteAll(options?)`
+- `keepLatest(n, options?)`
+- `finish()`
+
 ### Threads
 
 Create a thread, post messages, and listen for replies. The `Thread` object is the primary interface — all threading internals are hidden.
@@ -267,17 +324,21 @@ console.log(stream.content); // "working...\n" — only pre-abort text
 
 ## Mentions
 
-Get channel members and @mention them in messages.
+Resolve fuzzy member queries directly to mention strings.
+
+```typescript
+const mention = await channel.resolveMention("Nick Mancuso");
+await channel.postMessage(`Hey ${mention ?? "@nick"}, check this out!`);
+```
+
+You can still inspect members directly:
 
 ```typescript
 const members = await channel.getMembers();
-const user = members.find((m) => m.username === "alice");
-if (user) {
-  await channel.postMessage(`Hey ${user.mention}, check this out!`);
-}
+const member = await channel.findMember("@alice");
 ```
 
-Each `Member` has `id`, `username`, `displayName`, and `mention` (a ready-to-use `<@USER_ID>` string that renders as a clickable @mention on both platforms).
+Each `Member` has `id`, `username`, `displayName`, `mention`, and (when available) `email`.
 
 ## Typing Indicator
 
@@ -307,6 +368,13 @@ Delete messages and manage threads in bulk.
 // Delete up to 100 recent messages
 const deletedCount = await channel.bulkDelete(50);
 
+// List and filter recent messages
+const botMessages = await channel.getMessages({ limit: 50, author: "me" });
+const sameMessages = await channel.getRecentBotMessages(50);
+
+// Keep latest 8 bot messages, delete older ones (opinionated cleanup helper)
+await channel.pruneMessages({ author: "me", limit: 50, keep: 8 });
+
 // Get all threads (active and archived) and delete them
 const threads = await channel.getThreads();
 for (const thread of threads) {

package/dist/BatchStore.d.ts

@@ -0,0 +1,39 @@
+import type { BatchQueryOptions, MessageAuthorFilter, Platform } from "./types.js";
+export interface BatchMessageRefRecord {
+    id: string;
+    channelId: string;
+    platform: Platform;
+    postedAt: number;
+}
+export interface BatchRecord {
+    id: string;
+    key?: string;
+    author: MessageAuthorFilter;
+    channelId: string;
+    platform: Platform;
+    createdAt: number;
+    closedAt?: number;
+    messages: BatchMessageRefRecord[];
+}
+interface BeginBatchRecordOptions {
+    key?: string;
+    author?: MessageAuthorFilter;
+    channelId: string;
+    platform: Platform;
+}
+declare class InMemoryBatchStore {
+    private byChannel;
+    private byId;
+    beginBatch(options: BeginBatchRecordOptions): BatchRecord;
+    appendMessage(channelId: string, platform: Platform, batchId: string, message: BatchMessageRefRecord): BatchRecord | null;
+    finishBatch(channelId: string, platform: Platform, batchId: string): BatchRecord | null;
+    removeMessages(channelId: string, platform: Platform, batchId: string, messageIds: string[]): BatchRecord | null;
+    getBatch(channelId: string, platform: Platform, batchId: string): BatchRecord | null;
+    getBatches(channelId: string, platform: Platform, options?: BatchQueryOptions): BatchRecord[];
+    reset(): void;
+}
+export declare const batchStore: InMemoryBatchStore;
+/** @internal Testing helper to isolate batch-store state between tests. */
+export declare function resetBatchStore(): void;
+export {};
+//# sourceMappingURL=BatchStore.d.ts.map

package/dist/BatchStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchStore.d.ts","sourceRoot":"","sources":["../src/BatchStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,UAAU,uBAAuB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAaD,cAAM,kBAAkB;IACtB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,IAAI,CAAkE;IAE9E,UAAU,CAAC,OAAO,EAAE,uBAAuB,GAAG,WAAW;IAoBzD,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,qBAAqB,GAC7B,WAAW,GAAG,IAAI;IAcrB,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GACd,WAAW,GAAG,IAAI;IASrB,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAAE,GACnB,WAAW,GAAG,IAAI;IAerB,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GACd,WAAW,GAAG,IAAI;IAQrB,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,iBAAsB,GAC9B,WAAW,EAAE;IAwBhB,KAAK,IAAI,IAAI;CAId;AAED,eAAO,MAAM,UAAU,oBAA2B,CAAC;AAEnD,2EAA2E;AAC3E,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/BatchStore.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.batchStore = void 0;
+exports.resetBatchStore = resetBatchStore;
+const node_crypto_1 = require("node:crypto");
+function channelKey(channelId, platform) {
+    return `${platform}:${channelId}`;
+}
+function cloneRecord(record) {
+    return {
+        ...record,
+        messages: record.messages.map((message) => ({ ...message })),
+    };
+}
+class InMemoryBatchStore {
+    byChannel = new Map();
+    byId = new Map();
+    beginBatch(options) {
+        const key = channelKey(options.channelId, options.platform);
+        const createdAt = Date.now();
+        const record = {
+            id: (0, node_crypto_1.randomUUID)(),
+            key: options.key,
+            author: options.author ?? "me",
+            channelId: options.channelId,
+            platform: options.platform,
+            createdAt,
+            messages: [],
+        };
+        const list = this.byChannel.get(key) ?? [];
+        list.push(record);
+        this.byChannel.set(key, list);
+        this.byId.set(record.id, { channelKey: key, record });
+        return cloneRecord(record);
+    }
+    appendMessage(channelId, platform, batchId, message) {
+        const existing = this.byId.get(batchId);
+        if (existing?.channelKey !== channelKey(channelId, platform)) {
+            return null;
+        }
+        const duplicate = existing.record.messages.some((msg) => msg.id === message.id);
+        if (!duplicate) {
+            existing.record.messages.push({ ...message });
+        }
+        return cloneRecord(existing.record);
+    }
+    finishBatch(channelId, platform, batchId) {
+        const existing = this.byId.get(batchId);
+        if (existing?.channelKey !== channelKey(channelId, platform)) {
+            return null;
+        }
+        existing.record.closedAt ??= Date.now();
+        return cloneRecord(existing.record);
+    }
+    removeMessages(channelId, platform, batchId, messageIds) {
+        if (messageIds.length === 0) {
+            return this.getBatch(channelId, platform, batchId);
+        }
+        const existing = this.byId.get(batchId);
+        if (existing?.channelKey !== channelKey(channelId, platform)) {
+            return null;
+        }
+        const toRemove = new Set(messageIds);
+        existing.record.messages = existing.record.messages.filter((message) => !toRemove.has(message.id));
+        return cloneRecord(existing.record);
+    }
+    getBatch(channelId, platform, batchId) {
+        const existing = this.byId.get(batchId);
+        if (existing?.channelKey !== channelKey(channelId, platform)) {
+            return null;
+        }
+        return cloneRecord(existing.record);
+    }
+    getBatches(channelId, platform, options = {}) {
+        const list = this.byChannel.get(channelKey(channelId, platform)) ?? [];
+        const includeOpen = options.includeOpen ?? true;
+        const filtered = list.filter((record) => {
+            if (options.key !== undefined && record.key !== options.key) {
+                return false;
+            }
+            if (options.author !== undefined && record.author !== options.author) {
+                return false;
+            }
+            if (!includeOpen && record.closedAt === undefined) {
+                return false;
+            }
+            return true;
+        });
+        filtered.sort((a, b) => b.createdAt - a.createdAt);
+        const limited = options.limit !== undefined
+            ? filtered.slice(0, Math.max(0, options.limit))
+            : filtered;
+        return limited.map((record) => cloneRecord(record));
+    }
+    reset() {
+        this.byChannel.clear();
+        this.byId.clear();
+    }
+}
+exports.batchStore = new InMemoryBatchStore();
+/** @internal Testing helper to isolate batch-store state between tests. */
+function resetBatchStore() {
+    exports.batchStore.reset();
+}
+//# sourceMappingURL=BatchStore.js.map

package/dist/BatchStore.js.map

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

package/dist/Channel.d.ts

@@ -1,6 +1,7 @@
 import { Message } from "./Message";
+import type { MessageBatch } from "./MessageBatch.js";
 import { Thread } from "./Thread";
-import type { DisconnectCallback, ErrorCallback, FileAttachment, Member, MessageCallback, MessageContent, MessageData, Platform, ReactionCallback, ThreadData } from "./types";
+import type { BatchQueryOptions, BeginBatchOptions, DeleteMessageOptions, DisconnectCallback, ErrorCallback, FileAttachment, Member, MessageCallback, MessageContent, MessageData, MessageQueryOptions, Platform, ReactionCallback, ThreadData } from "./types";
 /**
  * Interface for platform-specific channel operations
  */
@@ -11,7 +12,7 @@ export interface ChannelOperations {
         linkPreviews?: boolean;
     }): Promise<MessageData>;
     updateMessage(messageId: string, channelId: string, content: MessageContent): Promise<void>;
-    deleteMessage(messageId: string, channelId: string): Promise<void>;
+    deleteMessage(messageId: string, channelId: string, options?: DeleteMessageOptions): Promise<void>;
     addReaction(messageId: string, channelId: string, emoji: string): Promise<void>;
     removeReaction(messageId: string, channelId: string, emoji: string): Promise<void>;
     removeAllReactions(messageId: string, channelId: string): Promise<void>;
@@ -20,6 +21,7 @@ export interface ChannelOperations {
     sendTyping(channelId: string): Promise<void>;
     startThread(messageId: string, channelId: string, name: string, autoArchiveDuration?: number): Promise<ThreadData>;
     bulkDelete(channelId: string, count: number): Promise<number>;
+    getMessages(channelId: string, options?: MessageQueryOptions): Promise<MessageData[]>;
     getThreads(channelId: string): Promise<ThreadData[]>;
     deleteThread(threadId: string, channelId: string): Promise<void>;
     getMembers(channelId: string): Promise<Member[]>;
@@ -37,8 +39,8 @@ export declare class Channel {
     private operations;
     private messageReactionCallbacks;
     private unsubscribeFromPlatform;
-    private typingRefCount;
-    private typingInterval;
+    private readonly batchAdapter;
+    private readonly typingController;
     constructor(id: string, platform: Platform, operations: ChannelOperations);
     /**
      * Post a message to this channel
@@ -126,6 +128,24 @@ export declare class Channel {
      * @returns Message object that callers can interact with before dismissal
      */
     postDismissable(content: MessageContent, ownerId: string): Promise<Message>;
+    /**
+     * Begin a logical message batch for grouping related posts.
+     * Batches can later be queried with getBatches()/getBatch().
+     */
+    beginBatch(options?: BeginBatchOptions): Promise<MessageBatch>;
+    /**
+     * Execute a callback with an auto-finishing message batch.
+     * finish() is guaranteed in finally, even when callback throws.
+     */
+    withBatch<T>(optionsOrCallback: BeginBatchOptions | ((batch: MessageBatch) => Promise<T>), maybeCallback?: (batch: MessageBatch) => Promise<T>): Promise<T>;
+    /**
+     * Retrieve a batch by ID within this channel.
+     */
+    getBatch(id: string): Promise<MessageBatch | null>;
+    /**
+     * List batches in this channel, newest first.
+     */
+    getBatches(options?: BatchQueryOptions): Promise<MessageBatch[]>;
     /**
      * Bulk delete messages in this channel
      * @param count - Number of recent messages to delete
@@ -142,6 +162,33 @@ export declare class Channel {
      * @returns Array of members with mention strings
      */
     getMembers(): Promise<Member[]>;
+    /**
+     * Find a channel member by fuzzy query (mention, username, display name, or email).
+     * Returns null when no unambiguous match is found.
+     */
+    findMember(query: string): Promise<Member | null>;
+    /**
+     * Resolve a user query to a mention string (e.g., "<@U123>").
+     * Returns null when no unambiguous match is found.
+     */
+    resolveMention(query: string): Promise<string | null>;
+    /**
+     * Get recent messages in this channel.
+     * Supports filtering by author and timestamp window.
+     */
+    getMessages(options?: MessageQueryOptions): Promise<Message[]>;
+    /**
+     * Convenience helper to fetch recent messages authored by the connected bot.
+     */
+    getRecentBotMessages(limit?: number): Promise<Message[]>;
+    /**
+     * Opinionated cleanup helper: keep the newest N messages and delete the rest.
+     * Returns the number of deleted messages.
+     */
+    pruneMessages(options?: MessageQueryOptions & {
+        keep?: number;
+        cascadeReplies?: boolean;
+    }): Promise<number>;
     /**
      * Disconnect from this channel (cleanup)
      */

package/dist/Channel.d.ts.map

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

package/dist/Channel.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Channel = void 0;
+const ChannelBatchHelpers_js_1 = require("./ChannelBatchHelpers.js");
+const ChannelRuntimeFeatures_js_1 = require("./ChannelRuntimeFeatures.js");
+const memberMatching_1 = require("./memberMatching");
 const Message_1 = require("./Message");
 const PendingMessage_1 = require("./PendingMessage");
 const Thread_1 = require("./Thread");
-/** Default interval (ms) for refreshing the typing indicator. Discord expires after ~10s. */
-const TYPING_REFRESH_MS = 8000;
 /** A platform-agnostic channel that provides messaging, reactions, typing indicators, and thread management. */
 class Channel {
     id;
@@ -13,12 +14,14 @@ class Channel {
     operations;
     messageReactionCallbacks = new Map();
     unsubscribeFromPlatform = null;
-    typingRefCount = 0;
-    typingInterval = null;
+    batchAdapter;
+    typingController;
     constructor(id, platform, operations) {
         this.id = id;
         this.platform = platform;
         this.operations = operations;
+        this.batchAdapter = (0, ChannelBatchHelpers_js_1.createChannelBatchAdapter)(this.id, this.platform, (content, options) => this.postMessage(content, options), (messageId, options) => this.operations.deleteMessage(messageId, this.id, options));
+        this.typingController = new ChannelRuntimeFeatures_js_1.TypingController(() => this.operations.sendTyping(this.id));
         // Subscribe to platform reactions and forward to message-specific callbacks
         this.unsubscribeFromPlatform = this.operations.subscribeToReactions(id, (event) => this.emitReaction(event));
     }
@@ -99,7 +102,7 @@ class Channel {
             removeReaction: (messageId, channelId, emoji) => this.operations.removeReaction(messageId, channelId, emoji),
             removeAllReactions: (messageId, channelId) => this.operations.removeAllReactions(messageId, channelId),
             updateMessage: (messageId, channelId, content) => this.operations.updateMessage(messageId, channelId, content),
-            deleteMessage: (messageId, channelId) => this.operations.deleteMessage(messageId, channelId),
+            deleteMessage: (messageId, channelId, options) => this.operations.deleteMessage(messageId, channelId, options),
             reply: async (channelId, threadTs, content, files) => this.operations.postMessage(channelId, content, { threadTs, files }),
             subscribeToReactions: (messageId, callback) => this.subscribeToMessageReactions(messageId, callback),
             startThread: async (messageId, channelId, name, autoArchiveDuration) => {
@@ -168,32 +171,14 @@ class Channel {
      * can overlap — the indicator stays active until the last one ends.
      */
     beginTyping() {
-        this.typingRefCount++;
-        if (this.typingRefCount === 1) {
-            this.operations.sendTyping(this.id).catch(() => {
-                // Ignore typing indicator failures
-            });
-            this.typingInterval = setInterval(() => {
-                if (this.typingRefCount > 0) {
-                    this.operations.sendTyping(this.id).catch(() => {
-                        // Ignore typing indicator failures
-                    });
-                }
-            }, TYPING_REFRESH_MS);
-        }
+        this.typingController.begin();
     }
     /**
      * Mark the end of one unit of work. When all outstanding beginTyping()
      * calls have been balanced by endTyping(), the refresh interval stops.
      */
     endTyping() {
-        if (this.typingRefCount > 0) {
-            this.typingRefCount--;
-        }
-        if (this.typingRefCount === 0 && this.typingInterval) {
-            clearInterval(this.typingInterval);
-            this.typingInterval = null;
-        }
+        this.typingController.end();
     }
     /**
      * Show a typing indicator while executing a function.
@@ -203,13 +188,7 @@ class Channel {
      * @returns The return value of fn
      */
     async withTyping(fn) {
-        this.beginTyping();
-        try {
-            return await fn();
-        }
-        finally {
-            this.endTyping();
-        }
+        return this.typingController.withTyping(fn);
     }
     /**
      * Post a message with a trash can reaction that the owner can click to dismiss.
@@ -218,17 +197,33 @@ class Channel {
      * @returns Message object that callers can interact with before dismissal
      */
     async postDismissable(content, ownerId) {
-        const emoji = this.platform === "slack" ? ":wastebasket:" : "🗑️";
-        const emojiMatch = this.platform === "slack" ? "wastebasket" : "🗑️";
-        const msg = await this.postMessage(content);
-        msg.addReactions([emoji]).onReaction(async (event) => {
-            if (event.user.id !== ownerId || event.emoji !== emojiMatch) {
-                return;
-            }
-            msg.offReaction();
-            await msg.delete();
-        });
-        return msg;
+        return (0, ChannelRuntimeFeatures_js_1.postDismissableMessage)(this.platform, async (messageContent) => this.postMessage(messageContent), content, ownerId);
+    }
+    /**
+     * Begin a logical message batch for grouping related posts.
+     * Batches can later be queried with getBatches()/getBatch().
+     */
+    beginBatch(options = {}) {
+        return (0, ChannelBatchHelpers_js_1.beginChannelBatch)(this.batchAdapter, options);
+    }
+    /**
+     * Execute a callback with an auto-finishing message batch.
+     * finish() is guaranteed in finally, even when callback throws.
+     */
+    withBatch(optionsOrCallback, maybeCallback) {
+        return (0, ChannelBatchHelpers_js_1.withChannelBatchFromArgs)(this.batchAdapter, optionsOrCallback, maybeCallback);
+    }
+    /**
+     * Retrieve a batch by ID within this channel.
+     */
+    getBatch(id) {
+        return (0, ChannelBatchHelpers_js_1.getChannelBatch)(this.batchAdapter, id);
+    }
+    /**
+     * List batches in this channel, newest first.
+     */
+    getBatches(options = {}) {
+        return (0, ChannelBatchHelpers_js_1.getChannelBatches)(this.batchAdapter, options);
     }
     /**
      * Bulk delete messages in this channel
@@ -253,6 +248,72 @@ class Channel {
     async getMembers() {
         return this.operations.getMembers(this.id);
     }
+    /**
+     * Find a channel member by fuzzy query (mention, username, display name, or email).
+     * Returns null when no unambiguous match is found.
+     */
+    async findMember(query) {
+        const members = await this.getMembers();
+        return (0, memberMatching_1.findBestMemberMatch)(members, query);
+    }
+    /**
+     * Resolve a user query to a mention string (e.g., "<@U123>").
+     * Returns null when no unambiguous match is found.
+     */
+    async resolveMention(query) {
+        const member = await this.findMember(query);
+        return member?.mention ?? null;
+    }
+    /**
+     * Get recent messages in this channel.
+     * Supports filtering by author and timestamp window.
+     */
+    async getMessages(options = {}) {
+        const { author: optionAuthor } = options;
+        let author = optionAuthor;
+        if (author !== undefined && author !== "me") {
+            const mentionId = (0, memberMatching_1.extractMentionId)(author);
+            if (mentionId !== null) {
+                author = mentionId;
+            }
+            else {
+                const member = await this.findMember(author);
+                if (member !== null) {
+                    author = member.id;
+                }
+            }
+        }
+        const data = await this.operations.getMessages(this.id, {
+            ...options,
+            author,
+        });
+        return data.map((message) => new Message_1.Message(message, this.createMessageOperations()));
+    }
+    /**
+     * Convenience helper to fetch recent messages authored by the connected bot.
+     */
+    async getRecentBotMessages(limit = 50) {
+        return this.getMessages({ limit, author: "me" });
+    }
+    /**
+     * Opinionated cleanup helper: keep the newest N messages and delete the rest.
+     * Returns the number of deleted messages.
+     */
+    async pruneMessages(options = {}) {
+        const keep = Math.max(0, options.keep ?? 0);
+        const cascadeReplies = options.cascadeReplies ?? true;
+        const messages = await this.getMessages({
+            limit: options.limit,
+            author: options.author,
+            after: options.after,
+            before: options.before,
+        });
+        const toDelete = messages.slice(keep);
+        for (const message of toDelete) {
+            await message.delete({ cascadeReplies });
+        }
+        return toDelete.length;
+    }
     /**
      * Disconnect from this channel (cleanup)
      */
@@ -262,11 +323,7 @@ class Channel {
             this.unsubscribeFromPlatform = null;
         }
         this.messageReactionCallbacks.clear();
-        if (this.typingInterval) {
-            clearInterval(this.typingInterval);
-            this.typingInterval = null;
-        }
-        this.typingRefCount = 0;
+        this.typingController.clear();
     }
 }
 exports.Channel = Channel;