slack.ts 0.0.1 → 0.0.3

package/README.md

@@ -8,9 +8,14 @@ An opinionated Slack API library with full TypeScript support.
 import { App } from 'slack.ts'
 
 const app = new App({
-	token: process.env.SLACK_BOT_TOKEN
+	token: process.env.SLACK_BOT_TOKEN,
+	receiver: { type: 'socket', appToken: process.env.SLACK_APP_TOKEN! },
 })
 
-const message = await app.channel('C0123456ABC').send('Hello, slack.ts!')
-console.log("Message timestamp:", message.ts)
+app.message(async ({ message }) => {
+	if (message.user === process.env.SLACK_USER_ID) return
+	await message.reply("I'm always listening :eyes:")
+})
+
+await app.start()
 ```

package/dist/api/index.d.ts

@@ -1,26 +1,40 @@
-import type { AuthTestParams, AuthTestResponse } from './web/auth';
-import type { ChatPostMessageParams, ChatPostMessageResponse } from './web/chat';
-import type { ConversationsInfoParams, ConversationsInfoResponse, ConversationsRepliesParams, ConversationsRepliesResponse } from './web/conversations';
+import type { AppsConnectionsOpenParams, AppsConnectionsOpenResponse } from "./web/apps.js";
+import type { AuthTestParams, AuthTestResponse } from "./web/auth.js";
+import type { ChatPostMessageParams, ChatPostMessageResponse } from "./web/chat.js";
+import type { ConversationsInfoParams, ConversationsInfoResponse, ConversationsRepliesParams, ConversationsRepliesResponse } from "./web/conversations.js";
+import type { FilesCompleteUploadExternalParams, FilesCompleteUploadExternalResponse, FilesGetUploadURLExternalParams, FilesGetUploadURLExternalResponse } from "./web/files.js";
 export interface SlackWebAPIMap {
-    'auth.test': {
+    "apps.connections.open": {
+        params: AppsConnectionsOpenParams;
+        response: AppsConnectionsOpenResponse;
+    };
+    "auth.test": {
         params: AuthTestParams;
         response: AuthTestResponse;
     };
-    'chat.postMessage': {
+    "chat.postMessage": {
         params: ChatPostMessageParams;
         response: ChatPostMessageResponse;
     };
-    'conversations.info': {
+    "conversations.info": {
         params: ConversationsInfoParams;
         response: ConversationsInfoResponse;
     };
-    'conversations.replies': {
+    "conversations.replies": {
         params: ConversationsRepliesParams;
         response: ConversationsRepliesResponse;
     };
+    "files.completeUploadExternal": {
+        params: FilesCompleteUploadExternalParams;
+        response: FilesCompleteUploadExternalResponse;
+    };
+    "files.getUploadURLExternal": {
+        params: FilesGetUploadURLExternalParams;
+        response: FilesGetUploadURLExternalResponse;
+    };
 }
 export type SlackAPIMethod = keyof SlackWebAPIMap;
-export type SlackAPIParams<Method extends SlackAPIMethod> = SlackWebAPIMap[Method]['params'] & {
+export type SlackAPIParams<Method extends SlackAPIMethod> = SlackWebAPIMap[Method]["params"] & {
     token?: string;
 };
 export type SlackAPIResponse<Method extends SlackAPIMethod> = {
@@ -28,5 +42,6 @@ export type SlackAPIResponse<Method extends SlackAPIMethod> = {
     error: string;
 } | ({
     ok: true;
-} & SlackWebAPIMap[Method]['response']);
-//# sourceMappingURL=index.d.ts.map
+} & SlackWebAPIMap[Method]["response"]);
+export declare const POST_METHODS: SlackAPIMethod[];
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAChF,OAAO,KAAK,EACX,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,MAAM,qBAAqB,CAAA;AAE5B,MAAM,WAAW,cAAc;IAC9B,WAAW,EAAE;QACZ,MAAM,EAAE,cAAc,CAAA;QACtB,QAAQ,EAAE,gBAAgB,CAAA;KAC1B,CAAA;IACD,kBAAkB,EAAE;QACnB,MAAM,EAAE,qBAAqB,CAAA;QAC7B,QAAQ,EAAE,uBAAuB,CAAA;KACjC,CAAA;IACD,oBAAoB,EAAE;QACrB,MAAM,EAAE,uBAAuB,CAAA;QAC/B,QAAQ,EAAE,yBAAyB,CAAA;KACnC,CAAA;IACD,uBAAuB,EAAE;QACxB,MAAM,EAAE,0BAA0B,CAAA;QAClC,QAAQ,EAAE,4BAA4B,CAAA;KACtC,CAAA;CACD;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,cAAc,CAAA;AACjD,MAAM,MAAM,cAAc,CAAC,MAAM,SAAS,cAAc,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AACD,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,cAAc,IACvD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5B,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAChF,OAAO,KAAK,EACX,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EACX,iCAAiC,EACjC,mCAAmC,EACnC,+BAA+B,EAC/B,iCAAiC,EACjC,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,cAAc;IAC9B,uBAAuB,EAAE;QACxB,MAAM,EAAE,yBAAyB,CAAA;QACjC,QAAQ,EAAE,2BAA2B,CAAA;KACrC,CAAA;IACD,WAAW,EAAE;QACZ,MAAM,EAAE,cAAc,CAAA;QACtB,QAAQ,EAAE,gBAAgB,CAAA;KAC1B,CAAA;IACD,kBAAkB,EAAE;QACnB,MAAM,EAAE,qBAAqB,CAAA;QAC7B,QAAQ,EAAE,uBAAuB,CAAA;KACjC,CAAA;IACD,oBAAoB,EAAE;QACrB,MAAM,EAAE,uBAAuB,CAAA;QAC/B,QAAQ,EAAE,yBAAyB,CAAA;KACnC,CAAA;IACD,uBAAuB,EAAE;QACxB,MAAM,EAAE,0BAA0B,CAAA;QAClC,QAAQ,EAAE,4BAA4B,CAAA;KACtC,CAAA;IACD,8BAA8B,EAAE;QAC/B,MAAM,EAAE,iCAAiC,CAAA;QACzC,QAAQ,EAAE,mCAAmC,CAAA;KAC7C,CAAA;IACD,4BAA4B,EAAE;QAC7B,MAAM,EAAE,+BAA+B,CAAA;QACvC,QAAQ,EAAE,iCAAiC,CAAA;KAC3C,CAAA;CACD;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,cAAc,CAAA;AACjD,MAAM,MAAM,cAAc,CAAC,MAAM,SAAS,cAAc,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AACD,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,cAAc,IACvD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5B,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;AAEtD,eAAO,MAAM,YAAY,EAAE,cAAc,EAIxC,CAAA"}

package/dist/api/index.js

@@ -1 +1,5 @@
-export {};
+export const POST_METHODS = [
+    'apps.connections.open',
+    'chat.postMessage',
+    'files.completeUploadExternal',
+];

package/dist/api/web/apps.d.ts

@@ -0,0 +1,6 @@
+export interface AppsConnectionsOpenParams {
+}
+export interface AppsConnectionsOpenResponse {
+    url: string;
+}
+//# sourceMappingURL=apps.d.ts.map

package/dist/api/web/apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../../src/api/web/apps.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;CAAG;AAE7C,MAAM,WAAW,2BAA2B;IAC3C,GAAG,EAAE,MAAM,CAAA;CACX"}

package/dist/api/web/apps.js

@@ -0,0 +1 @@
+export {};

package/dist/api/web/chat.d.ts

@@ -1,4 +1,5 @@
-import type { NormalMessage } from '../types/message';
+import type { KnownBlock } from "@slack/types";
+import type { Attachment, NormalMessage } from "../types/message.js";
 interface MarkdownMessage {
     markdown_text: string;
     blocks?: never;
@@ -6,22 +7,22 @@ interface MarkdownMessage {
 }
 type TextMessage = {
     markdown_text?: never;
-    blocks?: unknown[];
+    blocks?: KnownBlock[];
     text?: string;
 } & ({
-    blocks: unknown[];
+    blocks: KnownBlock[];
 } | {
     text: string;
 });
 export type ChatPostMessageParams = {
     channel: string;
-    attachments?: unknown[];
+    attachments?: Attachment[];
     icon_emoji?: string;
     icon_url?: string;
     link_names?: boolean;
     metadata?: unknown;
     mrkdwn?: boolean;
-    parse?: 'none' | 'full';
+    parse?: "none" | "full";
     reply_broadcast?: boolean;
     thread_ts?: string;
     unfurl_links?: boolean;
@@ -34,4 +35,4 @@ export interface ChatPostMessageResponse {
     message: NormalMessage;
 }
 export {};
-//# sourceMappingURL=chat.d.ts.map
+//# sourceMappingURL=chat.d.ts.map

package/dist/api/web/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/api/web/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,UAAU,eAAe;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,KAAK,CAAA;IACd,IAAI,CAAC,EAAE,KAAK,CAAA;CACZ;AAED,KAAK,WAAW,GAAG;IAClB,aAAa,CAAC,EAAE,KAAK,CAAA;IACrB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,CAAC;IAAE,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE9C,MAAM,MAAM,qBAAqB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,OAAO,EAAE,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,CAAC,eAAe,GAAG,WAAW,CAAC,CAAA;AAEnC,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,aAAa,CAAA;CACtB"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/api/web/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEjE,UAAU,eAAe;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,KAAK,CAAA;IACd,IAAI,CAAC,EAAE,KAAK,CAAA;CACZ;AAED,KAAK,WAAW,GAAG;IAClB,aAAa,CAAC,EAAE,KAAK,CAAA;IACrB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,CAAC;IAAE,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAEjD,MAAM,MAAM,qBAAqB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,CAAC,eAAe,GAAG,WAAW,CAAC,CAAA;AAEnC,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,MAAM,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,aAAa,CAAA;CACtB"}

package/dist/api/web/conversations.d.ts

@@ -1,6 +1,6 @@
-import type { CursorPaginationParams, CursorPaginationResponse, TimestampPaginationParams } from '../types/api';
-import type { Conversation } from '../types/conversation';
-import type { AnyMessage } from '../types/message';
+import type { CursorPaginationParams, CursorPaginationResponse, TimestampPaginationParams } from "../types/api.js";
+import type { Conversation } from "../types/conversation.js";
+import type { AnyMessage } from "../types/message.js";
 export interface ConversationsInfoParams {
     /** Conversation ID to learn more about */
     channel: string;
@@ -36,4 +36,4 @@ export interface ConversationsRepliesParams extends CursorPaginationParams, Time
 export interface ConversationsRepliesResponse extends CursorPaginationResponse {
     messages: AnyMessage[];
 }
-//# sourceMappingURL=conversations.d.ts.map
+//# sourceMappingURL=conversations.d.ts.map

package/dist/api/web/files.d.ts

@@ -0,0 +1,45 @@
+import type { KnownBlock } from '@slack/types';
+interface CompleteUploadFile {
+    id: string;
+    title?: string;
+}
+export interface FilesCompleteUploadExternalParams {
+    /** Array of file ids and their corresponding (optional) titles. */
+    files: CompleteUploadFile[];
+    /** Channel ID where the file will be shared. If not specified the file will be private. */
+    channel_id?: string;
+    /**
+     * Provide another message's `ts` value to upload this file as a reply. Never use a reply's `ts`
+     * value; use its parent instead. Also make sure to provide only one channel when using
+     * 'thread_ts'
+     */
+    thread_ts?: string;
+    /** Comma-separated string of channel IDs or user IDs where the file will be shared. */
+    channels?: string;
+    /** The message text introducing the file in specified channels. */
+    initial_comment?: string;
+    /**
+     * A JSON-based array of structured rich text blocks, presented as a URL-encoded string. If the
+     * `initial_comment` field is provided, the `blocks` field is ignored
+     */
+    blocks?: KnownBlock[];
+}
+export interface FilesCompleteUploadExternalResponse {
+    files: CompleteUploadFile[];
+}
+export interface FilesGetUploadURLExternalParams {
+    /** Size in bytes of the file being uploaded. */
+    length: number;
+    /** Name of the file being uploaded. */
+    filename: string;
+    /** Syntax type of the snippet being uploaded. */
+    snippet_type?: string;
+    /** Description of image for screen-reader. */
+    alt_txt?: string;
+}
+export interface FilesGetUploadURLExternalResponse {
+    upload_url: string;
+    file_id: string;
+}
+export {};
+//# sourceMappingURL=files.d.ts.map

package/dist/api/web/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/api/web/files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,UAAU,kBAAkB;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iCAAiC;IACjD,mEAAmE;IACnE,KAAK,EAAE,kBAAkB,EAAE,CAAA;IAE3B,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,mCAAmC;IACnD,KAAK,EAAE,kBAAkB,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,+BAA+B;IAC/C,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAA;IAEd,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAA;IAEhB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,iCAAiC;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CACf"}

package/dist/api/web/files.js

@@ -0,0 +1 @@
+export {};

package/dist/client.d.ts

@@ -1,11 +1,54 @@
-import { ChannelRef } from './resources/channel';
-import type { SlackAPIMethod, SlackAPIParams, SlackAPIResponse } from './api';
+import { ChannelRef } from "./resources/channel.js";
+import { type SlackAPIMethod, type SlackAPIParams, type SlackAPIResponse } from "./api/index.js";
+import { type SocketEventsReceiverOptions } from "./events/receivers/socket.js";
+import type { DistributiveOmit } from "./utils/typing.js";
+import type { AllEvents, EventWrapper } from "./events/types/index.js";
+import { type MessageInstance } from "./resources/message.js";
+import type { MessageEvent } from "./events/types/events.js";
+type ReceiverOptions = ({
+    type: "socket";
+} & DistributiveOmit<SocketEventsReceiverOptions, "client">) | {
+    type: "dummy";
+    options?: never;
+};
 interface AppOptions {
     token?: string;
+    receiver?: ReceiverOptions;
 }
+type MessageCallbackData = {
+    message: MessageInstance;
+    client: App;
+    event: EventWrapper<MessageEvent>;
+};
+type MessageCallback = (data: MessageCallbackData) => unknown;
+type EventCallbackData<Event extends AllEvents> = {
+    client: App;
+    event: EventWrapper<Event>;
+};
+type EventCallback<Event extends AllEvents> = (data: EventCallbackData<Event>) => unknown;
 export declare class App {
     #private;
-    constructor({ token }: AppOptions);
+    private messageCallbacks;
+    private eventCallbacks;
+    constructor({ token, receiver }?: AppOptions);
+    /**
+     * Registers a callback for `message` events.
+     *
+     * @param callback Function to execute when a new message is received
+     */
+    message(callback: MessageCallback): void;
+    /**
+     * Registers a callback for a given type of event.
+     *
+     * @param type Type of event to register
+     * @param callback Function to execute when the event is received
+     */
+    event<Event extends AllEvents>(type: Event["type"], callback: EventCallback<Event>): void;
+    /**
+     * Starts the event receiver. If you don't use the events, interactions, and slash command APIs,
+     * you don't need to call this function.
+     */
+    start(): Promise<void>;
     /**
      * Gets a channel reference object. You can use this object to call API methods, or `await` it to
      * fetch channel details.
@@ -22,9 +65,9 @@ export declare class App {
      * @param [method='GET'] The HTTP method for the request. Default is `'GET'`
      * @returns The response from the API call
      */
-    request<Method extends SlackAPIMethod>(endpoint: Method, params: SlackAPIParams<Method>, method?: string): Promise<SlackAPIResponse<Method> & {
+    request<Method extends SlackAPIMethod>(endpoint: Method, params: SlackAPIParams<Method>, method?: "GET" | "POST"): Promise<SlackAPIResponse<Method> & {
         ok: true;
     }>;
 }
 export {};
-//# sourceMappingURL=client.d.ts.map
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAE7E,UAAU,UAAU;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,GAAG;;gBAGH,EAAE,KAAK,EAAE,EAAE,UAAU;IAIjC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM;IAIlB;;;;;;;OAOG;IACG,OAAO,CAAC,MAAM,SAAS,cAAc,EAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,EAC9B,MAAM,SAAQ,GACZ,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,CAAC;CAgCnD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,OAAO,EAEN,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,MAAM,OAAO,CAAA;AACd,OAAO,EAAwB,KAAK,2BAA2B,EAAE,MAAM,2BAA2B,CAAA;AAClG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAiC,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE5F,OAAO,EAAW,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAGzD,KAAK,eAAe,GACjB,CAAC;IACD,IAAI,EAAE,QAAQ,CAAA;CACb,GAAG,gBAAgB,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC,GAC5D;IACA,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAEJ,UAAU,UAAU;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC1B;AAED,KAAK,mBAAmB,GAAG;IAC1B,OAAO,EAAE,eAAe,CAAA;IACxB,MAAM,EAAE,GAAG,CAAA;IACX,KAAK,EAAE,YAAY,CAAC,YAAY,CAAC,CAAA;CACjC,CAAA;AACD,KAAK,eAAe,GAAG,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAA;AAE7D,KAAK,iBAAiB,CAAC,KAAK,SAAS,SAAS,IAAI;IACjD,MAAM,EAAE,GAAG,CAAA;IACX,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;CAC1B,CAAA;AACD,KAAK,aAAa,CAAC,KAAK,SAAS,SAAS,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,OAAO,CAAA;AAEzF,qBAAa,GAAG;;IAIf,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,cAAc,CAA0E;gBAEpF,EAAE,KAAK,EAAE,QAA4B,EAAE,GAAE,UAAe;IAsCpE;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,eAAe;IAIjC;;;;;OAKG;IACH,KAAK,CAAC,KAAK,SAAS,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC;IAKlF;;;OAGG;IACG,KAAK;IAIX;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM;IAIlB;;;;;;;OAOG;IACG,OAAO,CAAC,MAAM,SAAS,cAAc,EAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,EAC9B,MAAM,GAAE,KAAK,GAAG,MAAyD,GACvE,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,CAAC;CAgCnD"}

package/dist/client.js

@@ -1,10 +1,70 @@
-import { sleep } from './utils';
-import { ChannelRef } from './resources/channel';
-import { SlackWebAPIError, SlackWebAPIPlatformError } from './error';
+import { sleep } from "./utils/index.js";
+import { ChannelRef } from "./resources/channel.js";
+import { SlackWebAPIError, SlackWebAPIPlatformError } from "./error.js";
+import { POST_METHODS, } from "./api/index.js";
+import { SocketEventsReceiver } from "./events/receivers/socket.js";
+import { DummyReceiver } from "./events/receivers/dummy.js";
+import { Message } from "./resources/message.js";
 export class App {
     #token;
-    constructor({ token }) {
+    #receiver;
+    messageCallbacks = [];
+    eventCallbacks = {};
+    constructor({ token, receiver = { type: "dummy" } } = {}) {
         this.#token = token;
+        switch (receiver.type) {
+            case "socket":
+                this.#receiver = new SocketEventsReceiver({ ...receiver, client: this });
+                break;
+            default:
+                this.#receiver = new DummyReceiver();
+        }
+        this.#receiver.on("event", this.#onEvent.bind(this));
+    }
+    async #onEvent(event) {
+        const data = {
+            client: this,
+            event,
+        };
+        for (const callback of this.eventCallbacks[event.event.type] ?? []) {
+            callback(data);
+        }
+        if (event.event.type === "message") {
+            const data = {
+                message: new Message(this, event.event.channel, event.event.ts, event.event),
+                client: this,
+                event: event,
+            };
+            for (const callback of this.messageCallbacks) {
+                callback(data);
+            }
+        }
+    }
+    /**
+     * Registers a callback for `message` events.
+     *
+     * @param callback Function to execute when a new message is received
+     */
+    message(callback) {
+        this.messageCallbacks.push(callback);
+    }
+    /**
+     * Registers a callback for a given type of event.
+     *
+     * @param type Type of event to register
+     * @param callback Function to execute when the event is received
+     */
+    event(type, callback) {
+        if (!this.eventCallbacks[type])
+            this.eventCallbacks[type] = [];
+        this.eventCallbacks[type].push(callback);
+    }
+    /**
+     * Starts the event receiver. If you don't use the events, interactions, and slash command APIs,
+     * you don't need to call this function.
+     */
+    async start() {
+        await this.#receiver.start();
     }
     /**
      * Gets a channel reference object. You can use this object to call API methods, or `await` it to
@@ -24,27 +84,27 @@ export class App {
      * @param [method='GET'] The HTTP method for the request. Default is `'GET'`
      * @returns The response from the API call
      */
-    async request(endpoint, params, method = 'GET') {
-        const body = method !== 'GET' ? JSON.stringify(params) : undefined;
+    async request(endpoint, params, method = POST_METHODS.includes(endpoint) ? "POST" : "GET") {
+        const body = method !== "GET" ? JSON.stringify(params) : undefined;
         const url = new URL(`https://slack.com/api/${endpoint}`);
-        if (method === 'GET' && params) {
+        if (method === "GET" && params) {
             for (const [key, value] of Object.entries(params)) {
                 if (value instanceof Array) {
                     for (const item of value) {
                         url.searchParams.append(key, item);
                     }
                 }
-                else {
+                else if (value !== undefined && value !== null) {
                     url.searchParams.set(key, String(value));
                 }
             }
         }
         const headers = new Headers();
         if (body) {
-            headers.append('Content-Type', 'application/json; charset=utf-8');
+            headers.append("Content-Type", "application/json; charset=utf-8");
         }
         if (params.token || this.#token) {
-            headers.set('Authorization', `Bearer ${params.token || this.#token}`);
+            headers.set("Authorization", `Bearer ${params.token || this.#token}`);
         }
         const res = await request(url.toString(), { method, body, headers });
         if (!res.ok) {
@@ -56,7 +116,7 @@ export class App {
 async function request(url, options) {
     const res = await fetch(url, options);
     if (res.status === 429) {
-        const retryAfter = Number(res.headers.get('Retry-After') ?? 2);
+        const retryAfter = Number(res.headers.get("Retry-After") ?? 2);
         await sleep(retryAfter * 1000);
         return request(url, options);
     }

package/dist/events/receivers/dummy.d.ts

@@ -0,0 +1,7 @@
+import { EventEmitter } from "events";
+import type { EventsReceiver, ReceiverEventMap } from "../types/index.js";
+export declare class DummyReceiver extends EventEmitter<ReceiverEventMap> implements EventsReceiver {
+    constructor();
+    start(): void;
+}
+//# sourceMappingURL=dummy.d.ts.map

package/dist/events/receivers/dummy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dummy.d.ts","sourceRoot":"","sources":["../../../src/events/receivers/dummy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEhE,qBAAa,aAAc,SAAQ,YAAY,CAAC,gBAAgB,CAAE,YAAW,cAAc;;IAK1F,KAAK;CACL"}

package/dist/events/receivers/dummy.js

@@ -0,0 +1,7 @@
+import { EventEmitter } from 'events';
+export class DummyReceiver extends EventEmitter {
+    constructor() {
+        super();
+    }
+    start() { }
+}

package/dist/events/receivers/socket.d.ts

@@ -0,0 +1,15 @@
+import EventEmitter from "events";
+import type { App } from "../../client.js";
+import type { EventsReceiver, ReceiverEventMap } from "../types/index.js";
+export interface SocketEventsReceiverOptions {
+    appToken: string;
+    client: App;
+}
+export declare class SocketEventsReceiver extends EventEmitter<ReceiverEventMap> implements EventsReceiver {
+    #private;
+    client: App;
+    constructor({ appToken, client }: SocketEventsReceiverOptions);
+    start(): Promise<void>;
+    private _connect;
+}
+//# sourceMappingURL=socket.d.ts.map

package/dist/events/receivers/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/events/receivers/socket.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,QAAQ,CAAA;AAEjC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,EAAE,cAAc,EAAgB,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAE9E,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,GAAG,CAAA;CACX;AAED,qBAAa,oBAAqB,SAAQ,YAAY,CAAC,gBAAgB,CAAE,YAAW,cAAc;;IAE1F,MAAM,EAAE,GAAG,CAAA;gBAGN,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,2BAA2B;IAMvD,KAAK;YAIG,QAAQ;CAuCtB"}

package/dist/events/receivers/socket.js

@@ -0,0 +1,51 @@
+import EventEmitter from 'events';
+import WebSocket from 'ws';
+export class SocketEventsReceiver extends EventEmitter {
+    #appToken;
+    client;
+    #ws;
+    constructor({ appToken, client }) {
+        super();
+        this.#appToken = appToken;
+        this.client = client;
+    }
+    async start() {
+        await this._connect();
+    }
+    async _connect() {
+        const { url } = await this.client.request('apps.connections.open', { token: this.#appToken });
+        this.#ws = new WebSocket(url + '&debug_reconnects=true');
+        this.#ws.addEventListener('open', this.#onOpen.bind(this));
+        this.#ws.addEventListener('message', this.#onMessage.bind(this));
+        this.#ws.addEventListener('close', this.#onClose.bind(this));
+        this.#ws.addEventListener('error', this.#onError.bind(this));
+    }
+    #onOpen() {
+        console.debug('[socket-mode] websocket connected');
+    }
+    #onMessage(event) {
+        console.debug('[socket-mode] message received');
+        if (typeof event.data === 'string') {
+            const data = JSON.parse(event.data);
+            if (data.type === 'events_api') {
+                this.#ws?.send(JSON.stringify({ envelope_id: data.envelope_id }));
+                this.emit('event', data.payload);
+            }
+            else if (data.type === 'hello') {
+                console.debug('[socket-mode] received server hello, app id', data.connection_info.app_id);
+            }
+            else {
+                console.warn('[socket-mode] unknown message:', data);
+            }
+        }
+    }
+    #onClose(event) {
+        console.debug('[socket-mode] websocket closed with code', event.code, event.reason);
+        this._connect();
+    }
+    #onError(event) {
+        console.debug('[socket-mode] websocket error', event.message);
+        this.#ws?.close();
+        this._connect();
+    }
+}

package/dist/events/types/events.d.ts

@@ -0,0 +1,12 @@
+import type { AnyMessage } from "../../api/types/message.js";
+import type { DistributiveOmit } from "../../utils/typing.js";
+export type AppMentionEvent = {
+    type: "app_mention";
+    channel: string;
+    event_ts: string;
+} & DistributiveOmit<AnyMessage, "type">;
+export type MessageEvent = {
+    channel: string;
+    event_ts: string;
+} & AnyMessage;
+//# sourceMappingURL=events.d.ts.map

package/dist/events/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/events/types/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,aAAa,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CAChB,GAAG,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;AAExC,MAAM,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CAChB,GAAG,UAAU,CAAA"}

package/dist/events/types/events.js

@@ -0,0 +1 @@
+export {};

package/dist/events/types/index.d.ts

@@ -0,0 +1,32 @@
+import type EventEmitter from "events";
+import type { AppMentionEvent, MessageEvent } from "./events.js";
+export interface EventsReceiver extends EventEmitter<ReceiverEventMap> {
+    start(): unknown;
+}
+export interface EventWrapper<T extends AllEvents = AllEvents> {
+    type: "event_callback";
+    token: string;
+    team_id: string;
+    api_app_id: string;
+    event: T;
+    event_context: string;
+    event_id: string;
+    event_time: number;
+    authorizations: unknown[];
+    is_ext_shared_channel: boolean;
+    context_team_id: string;
+    context_enterprise_id: string | null;
+}
+export type AllEventTypes = AllEvents["type"];
+export type SlackEventMap = {
+    [K in AllEventTypes]: AllEvents & {
+        type: K;
+    };
+};
+export type ReceiverEventMap = {
+    event: [
+        EventWrapper<AllEvents>
+    ];
+};
+export type AllEvents = AppMentionEvent | MessageEvent;
+//# sourceMappingURL=index.d.ts.map

package/dist/events/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,QAAQ,CAAA;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE7D,MAAM,WAAW,cAAe,SAAQ,YAAY,CAAC,gBAAgB,CAAC;IACrE,KAAK,IAAI,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAC5D,IAAI,EAAE,gBAAgB,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,CAAC,CAAA;IACR,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,OAAO,EAAE,CAAA;IACzB,qBAAqB,EAAE,OAAO,CAAA;IAC9B,eAAe,EAAE,MAAM,CAAA;IACvB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;AAE7C,MAAM,MAAM,aAAa,GAAG;KAC1B,CAAC,IAAI,aAAa,GAAG,SAAS,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE;CAC7C,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,eAAe,GAAG,YAAY,CAAA"}

package/dist/events/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export * from './client';
-export * from './error';
-//# sourceMappingURL=index.d.ts.map
+export * from "./client.js";
+export * from "./error.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,2 +1,2 @@
-export * from './client';
-export * from './error';
+export * from "./client.js";
+export * from "./error.js";

package/dist/resources/channel.d.ts

@@ -1,7 +1,9 @@
-import type { Conversation } from '../api/types/conversation';
-import type { NormalMessage } from '../api/types/message';
-import type { App } from '../client';
-import { MessageRef, type MessageInstance } from './message';
+import type { Conversation } from "../api/types/conversation.js";
+import type { NormalMessage } from "../api/types/message.js";
+import type { App } from "../client.js";
+import { type SendMessageWithFiles, type SendMessageWithoutFiles } from "../utils/messaging.js";
+import type { DistributiveOmit } from "../utils/typing.js";
+import { MessageRef, type MessageInstance } from "./message.js";
 declare class ChannelMixin {
     #private;
     protected client: App;
@@ -9,13 +11,19 @@ declare class ChannelMixin {
     /** ID of the channel */
     get id(): string;
     /**
-     * Sends a message in the channel
+     * Sends a message in the channel with files.
+     *
+     * @param message The message payload to send, including the files to upload. `text` will be
+     *   ignored if `blocks` are provided.
+     */
+    send(message: DistributiveOmit<SendMessageWithFiles, "channel">): Promise<undefined>;
+    /**
+     * Sends a message in the channel.
      *
      * @param message The message payload to send, either a mrkdwn-formatted string or an object.
-     *   Including the `files` key in the object will upload the files and share them in the channel.
      * @returns The sent message
      */
-    send(message: any): Promise<MessageInstance<NormalMessage>>;
+    send(message: DistributiveOmit<SendMessageWithoutFiles, "channel"> | string): Promise<MessageInstance<NormalMessage>>;
     /**
      * Gets a message reference object. You can use this object to call API methods, or `await` it to
      * fetch message details.
@@ -23,7 +31,7 @@ declare class ChannelMixin {
      * @param ts The timestamp of the message
      * @returns A message reference object
      */
-    message(ts: string): MessageRef<import("../api/types/message").AnyMessage>;
+    message(ts: string): MessageRef<import("../api/types/message.js").AnyMessage>;
 }
 export declare class ChannelRef extends ChannelMixin implements PromiseLike<ChannelInstance> {
     #private;
@@ -35,4 +43,4 @@ export declare class Channel extends ChannelMixin {
 }
 export type ChannelInstance = Channel & Conversation;
 export {};
-//# sourceMappingURL=channel.d.ts.map
+//# sourceMappingURL=channel.d.ts.map

package/dist/resources/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/resources/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAW,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAErE,cAAM,YAAY;;IAIhB,SAAS,CAAC,MAAM,EAAE,GAAG;gBAAX,MAAM,EAAE,GAAG,EACrB,EAAE,EAAE,MAAM;IAKX,wBAAwB;IACxB,IAAI,EAAE,WAEL;IAED;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,EAAE,GAAG;IAUvB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM;CAGlB;AAED,qBAAa,UAAW,SAAQ,YAAa,YAAW,WAAW,CAAC,eAAe,CAAC;;IACnF,IAAI,CAAC,QAAQ,GAAG,eAAe,EAAE,QAAQ,GAAG,KAAK,EAChD,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/F,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GACjF,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAQnC;AAED,qBAAa,OAAQ,SAAQ,YAAY;;gBAG5B,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAUvD;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,YAAY,CAAA"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/resources/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAGN,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAW,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAErE,cAAM,YAAY;;IAIhB,SAAS,CAAC,MAAM,EAAE,GAAG;gBAAX,MAAM,EAAE,GAAG,EACrB,EAAE,EAAE,MAAM;IAKX,wBAAwB;IACxB,IAAI,EAAE,WAEL;IAED;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,oBAAoB,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAE1F;;;;;OAKG;IACG,IAAI,CACT,OAAO,EAAE,gBAAgB,CAAC,uBAAuB,EAAE,SAAS,CAAC,GAAG,MAAM,GACpE,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAiB1C;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM;CAGlB;AAED,qBAAa,UAAW,SAAQ,YAAa,YAAW,WAAW,CAAC,eAAe,CAAC;;IACnF,IAAI,CAAC,QAAQ,GAAG,eAAe,EAAE,QAAQ,GAAG,KAAK,EAChD,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC/F,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GACjF,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAQnC;AAED,qBAAa,OAAQ,SAAQ,YAAY;;gBAG5B,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAKvD;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,YAAY,CAAA"}

package/dist/resources/channel.js

@@ -1,4 +1,6 @@
-import { Message, MessageRef } from './message';
+import { makeProxy } from "../utils/index.js";
+import { sendMessage, } from "../utils/messaging.js";
+import { Message, MessageRef } from "./message.js";
 class ChannelMixin {
     client;
     #id;
@@ -10,16 +12,14 @@ class ChannelMixin {
     get id() {
         return this.#id;
     }
-    /**
-     * Sends a message in the channel
-     *
-     * @param message The message payload to send, either a mrkdwn-formatted string or an object.
-     *   Including the `files` key in the object will upload the files and share them in the channel.
-     * @returns The sent message
-     */
     async send(message) {
-        const data = await this.client.request('chat.postMessage', { ...message, channel: this.id });
-        return new Message(this.client, this.#id, data.ts, data.message);
+        if (typeof message === "string") {
+            message = { text: message };
+        }
+        const data = await sendMessage(this.client, { ...message, channel: this.id });
+        if (data) {
+            return new Message(this.client, this.#id, data.ts, data.message);
+        }
     }
     /**
      * Gets a message reference object. You can use this object to call API methods, or `await` it to
@@ -37,7 +37,7 @@ export class ChannelRef extends ChannelMixin {
         return this.#fetch().then(onfulfilled, onrejected);
     }
     async #fetch() {
-        const data = await this.client.request('conversations.info', { channel: this.id });
+        const data = await this.client.request("conversations.info", { channel: this.id });
         return new Channel(this.client, this.id, data.channel);
     }
 }
@@ -46,12 +46,6 @@ export class Channel extends ChannelMixin {
     constructor(client, id, data) {
         super(client, id);
         this.#data = data;
-        return new Proxy(this, {
-            get(target, prop) {
-                if (prop in target)
-                    return target[prop];
-                return target.#data[prop];
-            },
-        });
+        return makeProxy(this, () => this.#data);
     }
 }

package/dist/resources/message.d.ts

@@ -1,6 +1,8 @@
-import type { AnyMessage, NormalMessage } from '../api/types/message';
-import type { App } from '../client';
-import { ChannelRef } from './channel';
+import type { AnyMessage, NormalMessage } from "../api/types/message.js";
+import type { App } from "../client.js";
+import { type SendMessageWithFiles, type SendMessageWithoutFiles } from "../utils/messaging.js";
+import type { DistributiveOmit } from "../utils/typing.js";
+import { ChannelRef } from "./channel.js";
 declare class MessageMixin {
     #private;
     protected client: App;
@@ -10,6 +12,21 @@ declare class MessageMixin {
     protected get _channelId(): string;
     /** Timestamp of the message */
     get ts(): string;
+    protected get _threadTs(): string | undefined;
+    /**
+     * Sends a message as a reply to this messsage with files.
+     *
+     * @param message The message payload to send, including the files to upload. `text` will be
+     *   ignored if `blocks` are provided.
+     */
+    reply(message: DistributiveOmit<SendMessageWithFiles, "channel" | "thread_ts">): Promise<undefined>;
+    /**
+     * Sends a message as a reply to this messsage.
+     *
+     * @param message The message payload to send, either a mrkdwn-formatted string or an object.
+     * @returns The sent message
+     */
+    reply(message: DistributiveOmit<SendMessageWithoutFiles, "channel" | "thread_ts"> | string): Promise<MessageInstance<NormalMessage>>;
 }
 export declare class MessageRef<Subtype extends AnyMessage = AnyMessage> extends MessageMixin implements PromiseLike<Message<Subtype>> {
     #private;
@@ -19,10 +36,11 @@ export declare class Message<Subtype extends AnyMessage = AnyMessage> extends Me
     #private;
     constructor(client: App, channel: string, ts: string, data: Subtype);
     /** @returns Whether this message is a normal message (subtype is undefined) */
-    isNormal(): this is Message<NormalMessage>;
+    isNormal(): this is MessageInstance<NormalMessage>;
     /** The raw data of this message */
     get raw(): Subtype;
+    protected get _threadTs(): string | undefined;
 }
 export type MessageInstance<Subtype extends AnyMessage = AnyMessage> = Message<Subtype> & Subtype;
 export {};
-//# sourceMappingURL=message.d.ts.map
+//# sourceMappingURL=message.d.ts.map

package/dist/resources/message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/resources/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACrE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,cAAM,YAAY;;IAKhB,SAAS,CAAC,MAAM,EAAE,GAAG;gBAAX,MAAM,EAAE,GAAG,EACrB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM;IAMX,8CAA8C;IAC9C,IAAI,OAAO,eAEV;IAED,SAAS,KAAK,UAAU,WAEvB;IAED,+BAA+B;IAC/B,IAAI,EAAE,WAEL;CACD;AAED,qBAAa,UAAU,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,CAC9D,SAAQ,YACR,YAAW,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;;IAExC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,KAAK,EACjD,WAAW,CAAC,EACT,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAC/D,IAAI,GACJ,SAAS,EACZ,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GACjF,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAsBnC;AAED,qBAAa,OAAO,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,CAAE,SAAQ,YAAY;;gBAGrE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;IAWnE,+EAA+E;IAC/E,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC;IAI1C,mCAAmC;IACnC,IAAI,GAAG,YAEN;CACD;AAED,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA"}
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/resources/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACrE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAGpC,OAAO,EAGN,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,cAAM,YAAY;;IAKhB,SAAS,CAAC,MAAM,EAAE,GAAG;gBAAX,MAAM,EAAE,GAAG,EACrB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM;IAMX,8CAA8C;IAC9C,IAAI,OAAO,eAEV;IAED,SAAS,KAAK,UAAU,WAEvB;IAED,+BAA+B;IAC/B,IAAI,EAAE,WAEL;IAED,SAAS,KAAK,SAAS,IAAI,MAAM,GAAG,SAAS,CAE5C;IAED;;;;;OAKG;IACG,KAAK,CACV,OAAO,EAAE,gBAAgB,CAAC,oBAAoB,EAAE,SAAS,GAAG,WAAW,CAAC,GACtE,OAAO,CAAC,SAAS,CAAC;IAErB;;;;;OAKG;IACG,KAAK,CACV,OAAO,EAAE,gBAAgB,CAAC,uBAAuB,EAAE,SAAS,GAAG,WAAW,CAAC,GAAG,MAAM,GAClF,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;CAoB1C;AAED,qBAAa,UAAU,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,CAC9D,SAAQ,YACR,YAAW,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;;IAExC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,KAAK,EACjD,WAAW,CAAC,EACT,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAC/D,IAAI,GACJ,SAAS,EACZ,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GACjF,WAAW,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAsBnC;AAED,qBAAa,OAAO,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,CAAE,SAAQ,YAAY;;gBAGrE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;IAMnE,+EAA+E;IAC/E,QAAQ,IAAI,IAAI,IAAI,eAAe,CAAC,aAAa,CAAC;IAIlD,mCAAmC;IACnC,IAAI,GAAG,YAEN;IAED,cAAuB,SAAS,IAAI,MAAM,GAAG,SAAS,CAErD;CACD;AAED,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA"}

package/dist/resources/message.js

@@ -1,5 +1,7 @@
-import { SlackError } from '../error';
-import { ChannelRef } from './channel';
+import { SlackError } from "../error.js";
+import { makeProxy } from "../utils/index.js";
+import { sendMessage, } from "../utils/messaging.js";
+import { ChannelRef } from "./channel.js";
 class MessageMixin {
     client;
     #channel;
@@ -20,13 +22,29 @@ class MessageMixin {
     get ts() {
         return this.#ts;
     }
+    get _threadTs() {
+        return undefined;
+    }
+    async reply(message) {
+        if (typeof message === "string") {
+            message = { text: message };
+        }
+        const data = await sendMessage(this.client, {
+            ...message,
+            channel: this.#channel,
+            thread_ts: this._threadTs || this.#ts,
+        });
+        if (data) {
+            return new Message(this.client, this.#channel, data.ts, data.message);
+        }
+    }
 }
 export class MessageRef extends MessageMixin {
     then(onfulfilled, onrejected) {
         return this.#fetch().then(onfulfilled, onrejected);
     }
     async #fetch() {
-        const data = await this.client.request('conversations.replies', {
+        const data = await this.client.request("conversations.replies", {
             channel: this._channelId,
             ts: this.ts,
             latest: this.ts,
@@ -34,7 +52,7 @@ export class MessageRef extends MessageMixin {
             inclusive: true,
         });
         if (!data.messages.length) {
-            throw new SlackError('Message is not found');
+            throw new SlackError("Message is not found");
         }
         return new Message(this.client, this._channelId, this.ts, data.messages[0]);
     }
@@ -44,13 +62,7 @@ export class Message extends MessageMixin {
     constructor(client, channel, ts, data) {
         super(client, channel, ts);
         this.#data = data;
-        return new Proxy(this, {
-            get(target, prop) {
-                if (prop in target)
-                    return target[prop];
-                return target.#data[prop];
-            },
-        });
+        return makeProxy(this, () => this.#data);
     }
     /** @returns Whether this message is a normal message (subtype is undefined) */
     isNormal() {
@@ -60,4 +72,7 @@ export class Message extends MessageMixin {
     get raw() {
         return this.#data;
     }
+    get _threadTs() {
+        return this.#data.thread_ts;
+    }
 }

package/dist/utils/index.d.ts

@@ -1,2 +1,3 @@
 export declare function sleep(ms: number): Promise<unknown>;
+export declare function makeProxy(object: any, getter: () => any): any;
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,oBAErC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,oBAErC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAWvD"}

package/dist/utils/index.js

@@ -1,3 +1,16 @@
 export async function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+export function makeProxy(object, getter) {
+    return new Proxy(object, {
+        get(target, prop) {
+            if (prop in target) {
+                const value = target[prop];
+                if (typeof value === 'function')
+                    return value.bind(target);
+                return value;
+            }
+            return getter()[prop];
+        },
+    });
+}

package/dist/utils/messaging.d.ts

@@ -0,0 +1,28 @@
+import type { KnownBlock } from "@slack/types";
+import type { ChatPostMessageParams } from "../api/web/chat.js";
+import type { App } from "../client.js";
+export type SendMessageFile = {
+    file: Buffer | ArrayBuffer;
+    filename: string;
+    title?: string;
+    snippet_type?: string;
+    alt_txt?: string;
+};
+export interface SendMessageWithFiles {
+    channel: string;
+    files: SendMessageFile[];
+    thread_ts?: string;
+    text?: string;
+    blocks?: KnownBlock[];
+    token?: string;
+}
+export type SendMessageWithoutFiles = {
+    files?: never;
+} & ChatPostMessageParams;
+export type SendMessageParams = SendMessageWithFiles | SendMessageWithoutFiles;
+export declare function sendMessage(client: App, params: SendMessageParams): Promise<{
+    channel: string;
+    ts: string;
+    message: import("../api/types/message.js").NormalMessage;
+} | undefined>;
+//# sourceMappingURL=messaging.d.ts.map

package/dist/utils/messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/utils/messaging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAGpC,MAAM,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,eAAe,EAAE,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,uBAAuB,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG,qBAAqB,CAAA;AAE/E,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG,uBAAuB,CAAA;AAE9E,wBAAsB,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,iBAAiB;;;;eAmBvE"}

package/dist/utils/messaging.js

@@ -0,0 +1,36 @@
+import { SlackError } from "../error.js";
+export async function sendMessage(client, params) {
+    if (params.files) {
+        const files = await Promise.all(params.files.map(async (file) => ({
+            id: await uploadHelper(client, file),
+            title: file.title,
+        })));
+        await client.request("files.completeUploadExternal", {
+            files,
+            channel_id: params.channel,
+            thread_ts: params.thread_ts,
+            initial_comment: params.text,
+            blocks: params.blocks,
+        });
+    }
+    else {
+        const message = await client.request("chat.postMessage", params);
+        return { channel: message.channel, ts: message.ts, message: message.message };
+    }
+}
+async function uploadHelper(client, file) {
+    const { upload_url, file_id } = await client.request("files.getUploadURLExternal", {
+        length: file.file.byteLength,
+        filename: file.filename,
+        snippet_type: file.snippet_type,
+        alt_txt: file.alt_txt,
+    });
+    const uploadResp = await fetch(upload_url, {
+        method: "POST",
+        body: file.file,
+    });
+    if (!uploadResp.ok) {
+        throw new SlackError("Failed to upload file");
+    }
+    return file_id;
+}

package/dist/utils/typing.d.ts

@@ -0,0 +1,2 @@
+export type DistributiveOmit<T, Key extends keyof any> = T extends any ? Omit<T, Key> : never;
+//# sourceMappingURL=typing.d.ts.map

package/dist/utils/typing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.d.ts","sourceRoot":"","sources":["../../src/utils/typing.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAA"}

package/dist/utils/typing.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "slack.ts",
-	"version": "0.0.1",
+	"version": "0.0.3",
 	"description": "A fully-typed, opinionated Slack API library",
 	"author": "@jollyroger182",
 	"license": "MIT",
@@ -35,14 +35,17 @@
 	"devDependencies": {
 		"@types/bun": "^1.3.11",
 		"@types/node": "^25.5.0",
+		"@types/ws": "^8.18.1",
 		"prettier": "^3.8.1",
 		"prettier-plugin-jsdoc": "^1.8.0",
+		"ts-add-js-extension": "^1.6.6",
 		"typescript": "^5"
 	},
 	"engines": {
 		"node": ">=18"
 	},
 	"dependencies": {
-		"@slack/types": "^2.20.1"
+		"@slack/types": "^2.20.1",
+		"ws": "^8.20.0"
 	}
 }