@hardlydifficult/chat 1.1.3 → 1.1.5

package/README.md

@@ -13,194 +13,188 @@ npm install @hardlydifficult/chat
 ```typescript
 import { createChatClient } from "@hardlydifficult/chat";
 
-// Uses DISCORD_TOKEN and DISCORD_GUILD_ID env vars
 const client = createChatClient({ type: "discord" });
+const channel = await client.connect(channelId);
 
-// Or for Slack: uses SLACK_BOT_TOKEN and SLACK_APP_TOKEN env vars
-const client = createChatClient({ type: "slack" });
+// Post messages
+await channel.postMessage("Hello!");
 
-const channel = await client.connect(channelId);
+// Listen for incoming messages
+channel.onMessage((event) => {
+  console.log(`${event.author.username}: ${event.content}`);
+});
+```
 
-await channel
-  .postMessage("Vote: (1) Pizza, (2) Burgers, (3) Salad")
-  .addReactions(["1️⃣", "2️⃣", "3️⃣"])
-  .onReaction((event) => {
-    console.log(`${event.user.username} voted ${event.emoji}`);
-  });
+## Configuration
+
+```typescript
+// Discord - env vars: DISCORD_TOKEN, DISCORD_GUILD_ID
+createChatClient({ type: "discord" });
+createChatClient({ type: "discord", token: "...", guildId: "..." });
+
+// Slack - env vars: SLACK_BOT_TOKEN, SLACK_APP_TOKEN
+createChatClient({ type: "slack" });
+createChatClient({ type: "slack", token: "...", appToken: "..." });
 ```
 
-## Rich Documents
+## Incoming Messages
 
-Post rich, formatted messages using the `@hardlydifficult/document-generator` package:
+Subscribe to new messages in a channel. Returns an unsubscribe function.
 
 ```typescript
-import { Document } from '@hardlydifficult/document-generator';
-import { createChatClient } from '@hardlydifficult/chat';
+const unsubscribe = channel.onMessage((event) => {
+  // event.id, event.content, event.author, event.channelId, event.timestamp
+  console.log(`${event.author.username}: ${event.content}`);
+});
 
-const client = createChatClient({ type: 'slack' });
-const channel = await client.connect(channelId);
+// Later: stop listening
+unsubscribe();
+```
+
+Messages from the bot itself are automatically filtered out.
+
+## Posting Messages
+
+Content can be a string or a `Document` from `@hardlydifficult/document-generator`.
+
+```typescript
+// Simple text
+channel.postMessage("Hello!");
+
+// Rich document (auto-converted to Discord Embed / Slack Block Kit)
+import { Document } from "@hardlydifficult/document-generator";
 
 const report = new Document()
   .header("Daily Report")
   .text("Here are today's **highlights**:")
-  .list(["Feature A completed", "Bug B fixed", "99.9% uptime"])
-  .divider()
-  .link("View dashboard", "https://example.com/dashboard")
-  .context("Generated automatically");
+  .list(["Feature A completed", "Bug B fixed", "99.9% uptime"]);
 
-// Automatically converted to Slack Block Kit / Discord Embed
-await channel.postMessage(report);
+channel.postMessage(report);
 ```
 
-## Message Operations
+### File Attachments
 
-### Update Messages
+Send files as message attachments.
 
 ```typescript
-const msg = await channel.postMessage('Initial content');
-await msg.update('Updated content');
-await msg.update(new Document().header('New Header').text('New body'));
+channel.postMessage("Here's the scan report", {
+  files: [
+    { content: Buffer.from(markdownContent), name: "report.md" },
+    { content: "plain text content", name: "notes.txt" },
+  ],
+});
 ```
 
-### Delete Messages
+## Message Operations
 
 ```typescript
-const msg = await channel.postMessage('Temporary message');
-await msg.delete();
-```
-
-### Thread Replies
+const msg = await channel.postMessage("Hello");
 
-```typescript
-const msg = await channel.postMessage('Main message');
-msg.postReply('This is a thread reply');
-msg.postReply(new Document().text('Rich reply with **formatting**'));
+await msg.update("Updated content");
+await msg.delete();
+msg.postReply("Thread reply");
 ```
 
 ### Reactions
 
 ```typescript
-// Add reactions and listen for user votes (chainable)
 await channel
   .postMessage("Pick one")
-  .addReactions(["👍", "👎", "🤷"])
+  .addReactions(["👍", "👎"])
   .onReaction((event) => {
     console.log(`${event.user.username} reacted with ${event.emoji}`);
   });
 
-// Or wait for reactions to be added before continuing
-const msg = await channel.postMessage("Loading...").wait();
-msg.addReactions(["✅"]);
-await msg.waitForReactions();
+msg.offReaction(); // stop listening
 ```
 
-## API Reference
+### Threads
 
-### `createChatClient(config)`
+Create a thread from an existing message.
 
 ```typescript
-// Discord - env vars: DISCORD_TOKEN, DISCORD_GUILD_ID
-createChatClient({ type: 'discord' });
-createChatClient({ type: 'discord', token: '...', guildId: '...' });
-
-// Slack - env vars: SLACK_BOT_TOKEN, SLACK_APP_TOKEN
-createChatClient({ type: 'slack' });
-createChatClient({ type: 'slack', token: '...', appToken: '...' });
+const msg = await channel.postMessage("Starting a discussion");
+const thread = await msg.startThread("Discussion Thread", {
+  autoArchiveDuration: 1440, // minutes
+});
 ```
 
-### `client.connect(channelId): Promise<Channel>`
-
-Connect to a channel.
-
-### `channel.postMessage(content): Message`
-
-Post a message. Content can be a string or a Document.
+> **Slack note:** Slack threads are implicit — calling `startThread()` returns the message's timestamp as the thread ID. Post replies with `msg.postReply()` to populate the thread.
 
-### `message.addReactions(emojis): Message`
+## Typing Indicator
 
-Add reactions. Chainable and awaitable.
+Show a "typing" indicator while processing.
 
-### `message.postReply(content): Message`
-
-Post a reply in the message's thread.
-
-### `message.update(content): Promise<void>`
+```typescript
+await channel.sendTyping();
+// ... do work ...
+await channel.postMessage("Done!");
+```
 
-Update the message content.
+> **Slack note:** Slack does not support bot typing indicators. `sendTyping()` is a no-op on Slack.
 
-### `message.delete(): Promise<void>`
+## Bulk Operations
 
-Delete the message.
+Delete messages and manage threads in bulk.
 
-### `message.waitForReactions(): Promise<void>`
+```typescript
+// Delete up to 100 recent messages
+const deletedCount = await channel.bulkDelete(50);
+
+// Get all threads (active and archived)
+const threads = await channel.getThreads();
+for (const thread of threads) {
+  console.log(thread.id);
+}
+```
 
-Wait for all pending reactions to complete.
+> **Slack note:** Slack has no bulk delete API — messages are deleted one-by-one. Some may fail if the bot lacks permission to delete others' messages. `getThreads()` scans recent channel history for messages with replies.
 
-### `message.onReaction(callback): Message`
+## Connection Resilience
 
-Listen for reactions on this message. Chainable.
+Both platforms auto-reconnect via their underlying libraries (discord.js and @slack/bolt). Register callbacks for observability.
 
 ```typescript
-channel
-  .postMessage("Vote!")
-  .addReactions(["👍", "👎"])
-  .onReaction((event) => {
-    // event.emoji, event.user.id, event.user.username,
-    // event.messageId, event.channelId, event.timestamp
-  });
-```
+const client = createChatClient({ type: "discord" });
 
-### `message.offReaction(): void`
+client.onDisconnect((reason) => {
+  console.log("Disconnected:", reason);
+});
 
-Stop listening for reactions on this message.
+client.onError((error) => {
+  console.error("Connection error:", error);
+});
 
-### `client.disconnect(): Promise<void>`
+await client.disconnect(); // clean shutdown
+```
 
-Disconnect from the platform.
+Both callbacks return an unsubscribe function.
 
 ## Platform Setup
 
 ### Discord
 
 1. Create bot at [Discord Developer Portal](https://discord.com/developers/applications)
-2. Enable Gateway Intents: `GUILDS`, `GUILD_MESSAGES`, `GUILD_MESSAGE_REACTIONS`
-3. Bot permissions: `Send Messages`, `Add Reactions`, `Read Message History`
+2. Enable Gateway Intents: `GUILDS`, `GUILD_MESSAGES`, `GUILD_MESSAGE_REACTIONS`, `MESSAGE_CONTENT`
+3. Bot permissions: `Send Messages`, `Add Reactions`, `Read Message History`, `Manage Messages` (for bulk delete), `Create Public Threads`, `Send Messages in Threads`
 4. Set `DISCORD_TOKEN` and `DISCORD_GUILD_ID` env vars
 
 ### Slack
 
 1. Create app at [Slack API](https://api.slack.com/apps)
 2. Enable Socket Mode, generate App Token
-3. Bot scopes: `chat:write`, `chat:write.public`, `reactions:write`, `reactions:read`
-4. Subscribe to: `reaction_added`
+3. Bot scopes: `chat:write`, `chat:write.public`, `reactions:write`, `reactions:read`, `channels:history`, `files:write`
+4. Subscribe to events: `reaction_added`, `message.channels`
 5. Set `SLACK_BOT_TOKEN` and `SLACK_APP_TOKEN` env vars
 
-## Example: Interactive Poll
-
-```typescript
-import { createChatClient } from "@hardlydifficult/chat";
-import { Document } from "@hardlydifficult/document-generator";
-
-const client = createChatClient({ type: "discord" });
-const channel = await client.connect(process.env.CHANNEL_ID);
-
-const options = ["Pizza", "Burgers", "Salad"];
-const emojis = ["1️⃣", "2️⃣", "3️⃣"];
-const votes: Record<string, string> = {};
-
-const pollDoc = new Document()
-  .header("🗳️ Lunch Poll")
-  .text("What should we order?")
-  .list(options.map((o, i) => `${emojis[i]} ${o}`));
-
-await channel
-  .postMessage(pollDoc)
-  .addReactions(emojis)
-  .onReaction((event) => {
-    const choice = options[emojis.indexOf(event.emoji)];
-    if (choice) {
-      votes[event.user.id] = choice;
-      console.log(`${event.user.username} voted for ${choice}`);
-    }
-  });
-```
+## Platform Differences
+
+| Feature | Discord | Slack |
+|---|---|---|
+| Incoming messages | Full support | Full support |
+| Typing indicator | Full support | No-op (unsupported by Slack bot API) |
+| File attachments | `AttachmentBuilder` | `filesUploadV2` |
+| Thread creation | Creates named thread on message | Returns message timestamp (threads are implicit) |
+| Bulk delete | Native `bulkDelete` API (fast) | One-by-one deletion (slower, may partially fail) |
+| Get threads | `fetchActive` + `fetchArchived` | Scans channel history for threaded messages |
+| Auto-reconnect | Handled by discord.js | Handled by `@slack/bolt` Socket Mode |

package/dist/Channel.d.ts

@@ -1,18 +1,24 @@
-import type { Platform, ReactionCallback, MessageData, MessageContent } from './types';
-import { Message } from './Message';
+import { Message } from "./Message";
+import type { DisconnectCallback, ErrorCallback, FileAttachment, MessageCallback, MessageContent, MessageData, Platform, ReactionCallback, StartThreadOptions, ThreadData } from "./types";
 /**
  * Interface for platform-specific channel operations
  */
 export interface ChannelOperations {
     postMessage(channelId: string, content: MessageContent, options?: {
         threadTs?: string;
-        unfurlLinks?: boolean;
-        unfurlMedia?: boolean;
+        files?: FileAttachment[];
     }): Promise<MessageData>;
     updateMessage(messageId: string, channelId: string, content: MessageContent): Promise<void>;
     deleteMessage(messageId: string, channelId: string): Promise<void>;
     addReaction(messageId: string, channelId: string, emoji: string): Promise<void>;
     subscribeToReactions(channelId: string, callback: ReactionCallback): () => void;
+    subscribeToMessages(channelId: string, callback: MessageCallback): () => void;
+    sendTyping(channelId: string): Promise<void>;
+    startThread(messageId: string, channelId: string, name: string, options?: StartThreadOptions): Promise<ThreadData>;
+    bulkDelete(channelId: string, count: number): Promise<number>;
+    getThreads(channelId: string): Promise<ThreadData[]>;
+    onDisconnect(callback: DisconnectCallback): () => void;
+    onError(callback: ErrorCallback): () => void;
 }
 /**
  * Represents a connected channel with messaging capabilities
@@ -27,14 +33,13 @@ export declare class Channel {
     /**
      * Post a message to this channel
      * @param content - Message content (string or Document)
-     * @param options - Optional message options (e.g., threadTs for threading, unfurl settings)
+     * @param options - Optional message options (e.g., threadTs for threading, files for attachments)
      * @returns Message object with chainable reaction methods
      */
     postMessage(content: MessageContent, options?: {
         threadTs?: string;
-        unfurlLinks?: boolean;
-        unfurlMedia?: boolean;
-    }): Message;
+        files?: FileAttachment[];
+    }): Message & PromiseLike<Message>;
     /**
      * Emit a reaction event to registered message-specific callbacks
      */
@@ -48,6 +53,27 @@ export declare class Channel {
      * Create MessageOperations from ChannelOperations
      */
     private createMessageOperations;
+    /**
+     * Subscribe to incoming messages in this channel
+     * @param callback - Function called when a new message is received
+     * @returns Unsubscribe function
+     */
+    onMessage(callback: MessageCallback): () => void;
+    /**
+     * Send a typing indicator in this channel
+     */
+    sendTyping(): Promise<void>;
+    /**
+     * Bulk delete messages in this channel
+     * @param count - Number of recent messages to delete
+     * @returns Number of messages actually deleted
+     */
+    bulkDelete(count: number): Promise<number>;
+    /**
+     * Get all threads in this channel (active and archived)
+     * @returns Array of thread data
+     */
+    getThreads(): Promise<ThreadData[]>;
     /**
      * 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":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,EAAE,OAAO,EAA0B,MAAM,WAAW,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5E,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAAC;CACjF;AAED;;GAEG;AACH,qBAAa,OAAO;IAClB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAEnC,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,wBAAwB,CAA4C;IAC5E,OAAO,CAAC,uBAAuB,CAA6B;gBAEhD,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,iBAAiB;IAWzE;;;;;OAKG;IACH,WAAW,CACT,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5E,OAAO;IAYV;;OAEG;YACW,YAAY;IAa1B;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAgBnC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;OAEG;IACH,UAAU,IAAI,IAAI;CAOnB"}
+{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../src/Channel.ts"],"names":[],"mappings":"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"}

package/dist/Channel.js

@@ -21,14 +21,13 @@ class Channel {
     /**
      * Post a message to this channel
      * @param content - Message content (string or Document)
-     * @param options - Optional message options (e.g., threadTs for threading, unfurl settings)
+     * @param options - Optional message options (e.g., threadTs for threading, files for attachments)
      * @returns Message object with chainable reaction methods
      */
     postMessage(content, options) {
         const messagePromise = this.operations.postMessage(this.id, content, options);
         // Create a Message that will resolve once the post completes
-        const pendingMessage = new PendingMessage(messagePromise, this.createMessageOperations(), this.platform);
-        return pendingMessage;
+        return new PendingMessage(messagePromise, this.createMessageOperations(), this.platform);
     }
     /**
      * Emit a reaction event to registered message-specific callbacks
@@ -39,7 +38,7 @@ class Channel {
             return;
         }
         const promises = Array.from(callbacks).map((cb) => Promise.resolve(cb(event)).catch((err) => {
-            console.error('Reaction callback error:', err);
+            console.error("Reaction callback error:", err);
         }));
         await Promise.all(promises);
     }
@@ -71,8 +70,38 @@ class Channel {
             deleteMessage: (messageId, channelId) => this.operations.deleteMessage(messageId, channelId),
             postReply: async (channelId, threadTs, content) => this.operations.postMessage(channelId, content, { threadTs }),
             subscribeToReactions: (messageId, callback) => this.subscribeToMessageReactions(messageId, callback),
+            startThread: (messageId, channelId, name, options) => this.operations.startThread(messageId, channelId, name, options),
         };
     }
+    /**
+     * Subscribe to incoming messages in this channel
+     * @param callback - Function called when a new message is received
+     * @returns Unsubscribe function
+     */
+    onMessage(callback) {
+        return this.operations.subscribeToMessages(this.id, callback);
+    }
+    /**
+     * Send a typing indicator in this channel
+     */
+    async sendTyping() {
+        await this.operations.sendTyping(this.id);
+    }
+    /**
+     * Bulk delete messages in this channel
+     * @param count - Number of recent messages to delete
+     * @returns Number of messages actually deleted
+     */
+    async bulkDelete(count) {
+        return this.operations.bulkDelete(this.id, count);
+    }
+    /**
+     * Get all threads in this channel (active and archived)
+     * @returns Array of thread data
+     */
+    async getThreads() {
+        return this.operations.getThreads(this.id);
+    }
     /**
      * Disconnect from this channel (cleanup)
      */
@@ -87,22 +116,26 @@ class Channel {
 exports.Channel = Channel;
 /**
  * A Message that is still being posted.
- * Use `.wait()` to await completion and handle errors.
+ * Implements PromiseLike so it can be directly awaited:
+ *   const msg = await channel.postMessage('Hello');
+ *
+ * Also supports synchronous chaining before awaiting:
+ *   await channel.postMessage('Vote!').addReactions(['👍', '👎']).onReaction(cb);
  */
 class PendingMessage extends Message_1.Message {
     postPromise;
     deferredReactionCallbacks = [];
     constructor(postPromise, operations, platform) {
         // Initialize with placeholder data using the correct platform
-        super({ id: '', channelId: '', platform }, operations);
+        super({ id: "", channelId: "", platform }, operations);
         this.postPromise = postPromise;
         // Update our data when the post resolves and subscribe any deferred listeners
         this.postPromise
             .then((data) => {
             // Update the readonly properties via Object.defineProperty
-            Object.defineProperty(this, 'id', { value: data.id });
-            Object.defineProperty(this, 'channelId', { value: data.channelId });
-            Object.defineProperty(this, 'platform', { value: data.platform });
+            Object.defineProperty(this, "id", { value: data.id });
+            Object.defineProperty(this, "channelId", { value: data.channelId });
+            Object.defineProperty(this, "platform", { value: data.platform });
             // Subscribe deferred reaction callbacks now that we have the message ID
             for (const callback of this.deferredReactionCallbacks) {
                 const unsubscribe = this.operations.subscribeToReactions(data.id, callback);
@@ -110,7 +143,7 @@ class PendingMessage extends Message_1.Message {
             }
         })
             .catch(() => {
-            // Errors handled via wait()
+            // Errors surfaced when awaited via then()
         });
     }
     /**
@@ -133,19 +166,16 @@ class PendingMessage extends Message_1.Message {
         return this;
     }
     /**
-     * Wait for post to complete.
-     * Throws if the post fails - allows callers to handle errors.
-     *
-     * @example
-     * ```typescript
-     * const msg = channel.postMessage('Hello');
-     * await msg.wait(); // throws if post fails
-     * console.log(msg.id); // now available
-     * ```
+     * Makes PendingMessage directly awaitable.
+     * Resolves to a plain Message (not thenable) to prevent infinite await loops.
      */
-    async wait() {
-        await this.postPromise;
-        return this;
+    then(onfulfilled, onrejected) {
+        const resolved = this.postPromise.then(async () => {
+            await this.pendingReactions;
+            // Return a plain Message (no then()) to stop await from recursing
+            return this.toSnapshot();
+        });
+        return resolved.then(onfulfilled, onrejected);
     }
     /**
      * Wait for post and all pending reactions to complete.

package/dist/Channel.js.map

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

package/dist/ChatClient.d.ts

@@ -1,5 +1,5 @@
-import type { ChatConfig } from './types';
-import type { Channel } from './Channel';
+import type { Channel } from "./Channel";
+import type { ChatConfig } from "./types";
 /**
  * Abstract base class for chat platform clients
  * Provides a unified API for Discord and Slack

package/dist/ChatClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatClient.d.ts","sourceRoot":"","sources":["../src/ChatClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;GAGG;AACH,8BAAsB,UAAU;IAClB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU;gBAAlB,MAAM,EAAE,UAAU;IAEjD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CACrC"}
+{"version":3,"file":"ChatClient.d.ts","sourceRoot":"","sources":["../src/ChatClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;GAGG;AACH,8BAAsB,UAAU;IAClB,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU;gBAAlB,MAAM,EAAE,UAAU;IAEjD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CACrC"}

package/dist/Message.d.ts

@@ -1,4 +1,4 @@
-import type { MessageData, MessageContent, Platform, ReactionCallback } from './types';
+import type { MessageContent, MessageData, Platform, ReactionCallback, StartThreadOptions, ThreadData } from "./types";
 /**
  * Interface for the platform-specific reaction adder
  */
@@ -13,6 +13,7 @@ export interface MessageOperations extends ReactionAdder {
     deleteMessage(messageId: string, channelId: string): Promise<void>;
     postReply(channelId: string, threadTs: string, content: MessageContent): Promise<MessageData>;
     subscribeToReactions(messageId: string, callback: ReactionCallback): () => void;
+    startThread(messageId: string, channelId: string, name: string, options?: StartThreadOptions): Promise<ThreadData>;
 }
 /**
  * Represents a posted message with chainable reaction methods
@@ -25,6 +26,11 @@ export declare class Message {
     protected operations: MessageOperations;
     protected reactionUnsubscribers: (() => void)[];
     constructor(data: MessageData, operations: MessageOperations);
+    /**
+     * Create a plain Message snapshot, transferring reaction unsubscribers.
+     * Used by PendingMessage/ReplyMessage to resolve to a non-thenable Message.
+     */
+    protected toSnapshot(): Message;
     /**
      * Add multiple emoji reactions to this message
      * @param emojis - Array of emojis to add
@@ -56,7 +62,14 @@ export declare class Message {
      * @param content - Reply content (string or Document)
      * @returns ReplyMessage that can be awaited to handle success/failure
      */
-    postReply(content: MessageContent): ReplyMessage;
+    postReply(content: MessageContent): Message & PromiseLike<Message>;
+    /**
+     * Create a thread from this message
+     * @param name - Thread name
+     * @param options - Optional thread options
+     * @returns Channel-like object for posting into the thread
+     */
+    startThread(name: string, options?: StartThreadOptions): Promise<ThreadData>;
     /**
      * Update this message's content
      * @param content - New content (string or Document)
@@ -80,9 +93,10 @@ export declare class Message {
 }
 /**
  * A reply message that is still being posted.
- * Use `.wait()` to await completion and handle errors.
+ * Implements PromiseLike so it can be directly awaited:
+ *   const reply = await msg.postReply('text');
  */
-export declare class ReplyMessage extends Message {
+export declare class ReplyMessage extends Message implements PromiseLike<Message> {
     private replyPromise;
     private deferredReactionCallbacks;
     constructor(replyPromise: Promise<MessageData>, operations: MessageOperations, platform: Platform);
@@ -95,17 +109,10 @@ export declare class ReplyMessage extends Message {
      */
     onReaction(callback: ReactionCallback): this;
     /**
-     * Wait for reply to complete.
-     * Throws if the reply fails - allows callers to handle errors.
-     *
-     * @example
-     * ```typescript
-     * const reply = msg.postReply('text');
-     * await reply.wait(); // throws if reply fails
-     * console.log(reply.id); // now available
-     * ```
+     * Makes ReplyMessage directly awaitable.
+     * Resolves to a plain Message (not thenable) to prevent infinite await loops.
      */
-    wait(): Promise<this>;
+    then<TResult1 = Message, TResult2 = never>(onfulfilled?: ((value: Message) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
     /**
      * Wait for reply and all pending reactions to complete.
      */