slack.ts 0.0.6 → 0.0.8

package/dist/{client.js → src/client.js}

@@ -1,12 +1,14 @@
 import EventEmitter from "events";
 import { POST_METHODS, } from "./api/index.js";
 import { SlackWebAPIError, SlackWebAPIPlatformError } from "./error.js";
-import { DummyReceiver } from "./events/receivers/dummy.js";
-import { SocketEventsReceiver } from "./events/receivers/socket.js";
+import { DummyReceiver } from "./receivers/dummy.js";
+import { SocketEventsReceiver } from "./receivers/socket.js";
 import { Action } from "./resources/action.js";
-import { ChannelRef } from "./resources/channel.js";
+import { Channel, ChannelRef } from "./resources/channel.js";
 import { Message } from "./resources/message.js";
 import { sleep } from "./utils/index.js";
+import { SlashCommand } from "./resources/slash.js";
+import { paginate } from "./utils/paginate.js";
 export class App extends EventEmitter {
     #token;
     #receiver;
@@ -24,6 +26,7 @@ export class App extends EventEmitter {
         this.#receiver.on("event", this.#onEvent.bind(this));
         this.#receiver.on("block_actions", this.#onBlockActions.bind(this));
         this.#receiver.on("view_submission", this.#onViewSubmission.bind(this));
+        this.#receiver.on("slash_command", this.#onSlashCommand.bind(this));
         this.on("event:message", this.#onMessage.bind(this));
     }
     #onEvent(event) {
@@ -43,6 +46,11 @@ export class App extends EventEmitter {
         this.emit("submit", event);
         this.emit(`submit.${event.view.callback_id}`, event);
     }
+    #onSlashCommand(event) {
+        const command = new SlashCommand(this, event);
+        this.emit("slash", command);
+        this.emit(`/${event.command.substring(1)}`, command);
+    }
     async #onCallbackError(error) {
         console.error("Error occurred executing callback");
         console.error(error);
@@ -50,6 +58,8 @@ export class App extends EventEmitter {
     #onMessage({ payload }) {
         const message = new Message(this, payload.channel, payload.ts, payload);
         this.emit("message", message);
+        this.emit(`message:${payload.subtype ?? "normal"}`, message);
+        this.emit(`message:${payload.subtype ?? "normal"}#${payload.channel}`, message);
         this.emit(`message#${payload.channel}`, message);
     }
     /**
@@ -109,6 +119,9 @@ export class App extends EventEmitter {
     channel(id) {
         return new ChannelRef(this, id);
     }
+    async *channels(...types) {
+        yield* paginate(this, "conversations.list", { types: types.join(",") }, (r) => r.channels.map((c) => new Channel(this, c.id, c)));
+    }
     /**
      * Makes a Slack Web API request.
      *

package/dist/src/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,qBAAa,gBAAiB,SAAQ,UAAU;IAEvC,GAAG,EAAE,MAAM;IACX,IAAI,CAAC,EAAE,OAAO;gBADd,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,YAAA;CAItB;AAED,qBAAa,wBAAyB,SAAQ,gBAAgB;IAIrD,KAAK,EAAE,MAAM;gBAFpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACN,KAAK,EAAE,MAAM;CAIrB"}

package/dist/{index.d.ts → src/index.d.ts}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA"}

package/dist/{index.js → src/index.js}

@@ -1,3 +1,3 @@
 export * from "./client.js";
 export * from "./error.js";
-export * from "./builders/index.js";
+export * from "./blocks/index.js";

package/dist/src/receivers/base.d.ts

@@ -0,0 +1,23 @@
+import type EventEmitter from "events";
+import type { AllEvents, EventWrapper } from "../api/events/index.js";
+import type { BlockActions } from "../api/interactive/block_actions.js";
+import type { ViewSubmission } from "../api/interactive/view_submission.js";
+import type { SlashCommandPayload } from "../api/slash/index.js";
+export interface EventsReceiver extends EventEmitter<ReceiverEventMap> {
+    start(): unknown;
+}
+export type ReceiverEventMap = {
+    event: [
+        EventWrapper<AllEvents>
+    ];
+    block_actions: [
+        BlockActions
+    ];
+    view_submission: [
+        ViewSubmission
+    ];
+    slash_command: [
+        SlashCommandPayload
+    ];
+};
+//# sourceMappingURL=base.d.ts.map

package/dist/src/receivers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/receivers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,QAAQ,CAAA;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEvD,MAAM,WAAW,cAAe,SAAQ,YAAY,CAAC,gBAAgB,CAAC;IACrE,KAAK,IAAI,OAAO,CAAA;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC9B,KAAK,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAA;IAChC,aAAa,EAAE,CAAC,YAAY,CAAC,CAAA;IAC7B,eAAe,EAAE,CAAC,cAAc,CAAC,CAAA;IACjC,aAAa,EAAE,CAAC,mBAAmB,CAAC,CAAA;CACpC,CAAA"}

package/dist/src/receivers/base.js

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

package/dist/{events → src}/receivers/dummy.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "events";
-import type { EventsReceiver, ReceiverEventMap } from "../types/index.js";
+import type { EventsReceiver, ReceiverEventMap } from "./base.js";
 export declare class DummyReceiver extends EventEmitter<ReceiverEventMap> implements EventsReceiver {
     constructor();
     start(): void;

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

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

package/dist/{events → src}/receivers/socket.d.ts

@@ -1,6 +1,6 @@
 import EventEmitter from "events";
-import type { App } from "../../client.js";
-import type { EventsReceiver, ReceiverEventMap } from "../types/index.js";
+import type { App } from "../client.js";
+import type { EventsReceiver, ReceiverEventMap } from "./base.js";
 export interface SocketEventsReceiverOptions {
     appToken: string;
     client: App;

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

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/receivers/socket.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,QAAQ,CAAA;AAIjC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAA;AAG9D,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;IAYvD,KAAK;YAIG,QAAQ;CA6CtB"}

package/dist/{events → src}/receivers/socket.js

@@ -40,6 +40,10 @@ export class SocketEventsReceiver extends EventEmitter {
                 this.#ws?.send(JSON.stringify({ envelope_id: data.envelope_id }));
                 this.emit(data.payload.type, data.payload);
             }
+            else if (data.type === 'slash_commands') {
+                this.#ws?.send(JSON.stringify({ envelope_id: data.envelope_id }));
+                this.emit('slash_command', data.payload);
+            }
             else if (data.type === 'hello') {
                 console.debug('[socket-mode] received server hello, app id', data.connection_info.app_id);
             }

package/dist/{resources → src/resources}/action.d.ts

@@ -1,6 +1,6 @@
 import type { BlockAction, BlockActions } from "../api/interactive/block_actions.js";
 import type { App } from "../client.js";
-import { type Responder } from "../utils/respond.js";
+import { Responder } from "../utils/respond.js";
 export declare class Action<Type extends BlockAction = BlockAction> {
     #private;
     protected client: App;

package/dist/src/resources/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/resources/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACjF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE5C,qBAAa,MAAM,CAAC,IAAI,SAAS,WAAW,GAAG,WAAW;;IAKxD,SAAS,CAAC,MAAM,EAAE,GAAG;gBAAX,MAAM,EAAE,GAAG,EACrB,MAAM,EAAE,IAAI,EACZ,KAAK,EAAE,YAAY;IAOpB,IAAI,KAAK,iBAER;IAED,IAAI,GAAG,SAEN;IAED,IAAI,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAE7B;CACD;AAED,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,WAAW,GAAG,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA"}

package/dist/{resources → src/resources}/action.js

@@ -1,5 +1,5 @@
 import { makeProxy } from "../utils/index.js";
-import { ResponderImpl } from "../utils/respond.js";
+import { Responder } from "../utils/respond.js";
 export class Action {
     client;
     #data;
@@ -17,6 +17,6 @@ export class Action {
         return this.#data;
     }
     get respond() {
-        return new ResponderImpl(this.client, this.#event.response_url, this.#event.trigger_id);
+        return new Responder(this.client, this.#event.response_url, this.#event.trigger_id);
     }
 }

package/dist/{resources → src/resources}/channel.d.ts

@@ -1,3 +1,4 @@
+import type { KnownBlock } from "@slack/types";
 import type { TimestampPaginationParams } from "../api/types/api.js";
 import type { Conversation } from "../api/types/conversation.js";
 import type { NormalMessage } from "../api/types/message.js";
@@ -38,7 +39,7 @@ declare class ChannelMixin {
      * @param message The message payload to send, either a mrkdwn-formatted string or an object.
      * @returns The sent message
      */
-    send(message: DistributiveOmit<SendMessageWithoutFiles, "channel"> | string): Promise<MessageInstance<NormalMessage>>;
+    send<Blocks extends KnownBlock[] = KnownBlock[]>(message: DistributiveOmit<SendMessageWithoutFiles<Blocks>, "channel"> | string): Promise<MessageInstance<NormalMessage<Blocks>, Blocks>>;
     /**
      * Gets a message reference object. You can use this object to call API methods, or `await` it to
      * fetch message details.
@@ -46,7 +47,7 @@ declare class ChannelMixin {
      * @param ts The timestamp of the message
      * @returns A message reference object
      */
-    message(ts: string): MessageRef<import("../api/types/message.js").AnyMessage>;
+    message(ts: string): MessageRef<import("../api/types/message.js").AnyMessage, KnownBlock[]>;
     /**
      * Fetches messages in the channel. Note that this method only fetches root messages (i.e.,
      * messages not in a thread); to fetch thread replies, use the `replies` method on messages
@@ -61,11 +62,11 @@ export declare class ChannelRef extends ChannelMixin implements PromiseLike<Chan
     #private;
     then<TResult1 = ChannelInstance, TResult2 = never>(onfulfilled?: ((value: ChannelInstance) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null | undefined): PromiseLike<TResult1 | TResult2>;
 }
-export declare class Channel extends ChannelMixin {
+export declare class Channel<T extends Conversation = Conversation> extends ChannelMixin {
     #private;
-    constructor(client: App, id: string, data: Conversation);
+    constructor(client: App, id: string, data: T);
     /** A reference to the creator of this channel. Only available for non-DM channels. */
-    get creator(): UserRef | undefined;
+    get creator(): undefined extends T["creator"] ? UserRef | undefined : UserRef;
 }
 export type ChannelInstance = Channel & DistributiveOmit<Conversation, "creator">;
 export {};

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/resources/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AACjE,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;AAE3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAW,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAEhC,UAAU,mBAAoB,SAAQ,IAAI,CAAC,yBAAyB,EAAE,OAAO,CAAC;IAC7E;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,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,CAAC,MAAM,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,EACpD,OAAO,EAAE,gBAAgB,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,GAAG,MAAM,GAC5E,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;IAiB1D;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM;IAIlB;;;;;;;OAOG;IACI,QAAQ,CAAC,MAAM,GAAE,mBAAwB;CAOhD;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,OAAO,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,CAAE,SAAQ,YAAY;;gBAGnE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAM5C,sFAAsF;IACtF,IAAI,OAAO,IAAI,SAAS,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAE5E;CACD;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,gBAAgB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA"}

package/dist/{resources → src/resources}/message.d.ts

@@ -1,3 +1,4 @@
+import type { KnownBlock } from "@slack/types";
 import type { BlockAction, BlockActionTypes } from "../api/interactive/block_actions.js";
 import type { TimestampPaginationParams } from "../api/types/api.js";
 import type { AnyMessage, NormalMessage } from "../api/types/message.js";
@@ -7,6 +8,7 @@ import type { DistributiveOmit } from "../utils/typing.js";
 import type { ActionInstance } from "./action.js";
 import { ChannelRef } from "./channel.js";
 import { UserRef } from "./user.js";
+import type { ActionsToPrefixedID, ExtractActions } from "../blocks/utils/extract.js";
 interface FetchRepliesParams extends Omit<TimestampPaginationParams, "limit"> {
     /**
      * How many replies to fetch in each API call. This will not affect the number of returned
@@ -26,7 +28,7 @@ interface FetchRepliesParams extends Omit<TimestampPaginationParams, "limit"> {
      */
     root?: boolean;
 }
-declare class MessageMixin {
+declare class MessageMixin<Blocks extends KnownBlock[] = KnownBlock[]> {
     #private;
     protected client: App;
     constructor(client: App, channel: string, ts: string);
@@ -40,7 +42,7 @@ declare class MessageMixin {
      * Waits for an event about this message to occur before continuing. To configure the wait object,
      * see its methods (for example, `message.wait.timeout(60000)`).
      */
-    get wait(): MessageWait;
+    get wait(): MessageWait<Blocks>;
     /**
      * Sends a message as a reply to this messsage with files.
      *
@@ -54,7 +56,7 @@ declare class MessageMixin {
      * @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>>;
+    reply<Blocks extends KnownBlock[] = KnownBlock[]>(message: DistributiveOmit<SendMessageWithoutFiles<Blocks>, "channel" | "thread_ts"> | string): Promise<MessageInstance<NormalMessage<Blocks>, Blocks>>;
     /**
      * Fetches replies in the thread of this message. Note that this method may return the root
      * message by default; set `params.root` to `false` to skip it.
@@ -64,11 +66,11 @@ declare class MessageMixin {
      */
     replies(params?: FetchRepliesParams): AsyncGenerator<MessageInstance, void, unknown>;
 }
-export declare class MessageRef<Subtype extends AnyMessage = AnyMessage> extends MessageMixin implements PromiseLike<Message<Subtype>> {
+export declare class MessageRef<Subtype extends AnyMessage = AnyMessage, Blocks extends KnownBlock[] = KnownBlock[]> extends MessageMixin<Blocks> implements PromiseLike<Message<Subtype>> {
     #private;
     then<TResult1 = Message<Subtype>, TResult2 = never>(onfulfilled?: ((value: Message<Subtype>) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null | undefined): PromiseLike<TResult1 | TResult2>;
 }
-export declare class Message<Subtype extends AnyMessage = AnyMessage> extends MessageMixin {
+export declare class Message<Subtype extends AnyMessage = AnyMessage, Blocks extends KnownBlock[] = KnownBlock[]> extends MessageMixin<Blocks> {
     #private;
     constructor(client: App, channel: string, ts: string, data: Subtype);
     /** @returns Whether this message is a normal message (subtype is undefined) */
@@ -80,15 +82,15 @@ export declare class Message<Subtype extends AnyMessage = AnyMessage> extends Me
      * channel join messages), this may not be the user you expect. Read the Slack documentation to
      * find out.
      */
-    get author(): UserRef;
+    get author(): undefined extends Subtype["user"] ? UserRef | undefined : UserRef;
     protected get _threadTs(): string | undefined;
 }
-export type MessageInstance<Subtype extends AnyMessage = AnyMessage> = Message<Subtype> & Subtype;
-declare class MessageWait {
+export type MessageInstance<Subtype extends AnyMessage = AnyMessage, Blocks extends KnownBlock[] = KnownBlock[]> = Message<Subtype, Blocks> & Subtype;
+declare class MessageWait<Blocks extends KnownBlock[] = KnownBlock[]> {
     private message;
     private client;
     private _timeout;
-    constructor(message: MessageMixin, client: App);
+    constructor(message: MessageMixin<Blocks>, client: App);
     /**
      * Sets the timeout of the wait. A `SlackTimeoutError` will be thrown if no matching event occurs
      * after the timeout. Set this to `0` to disable timeouts; i.e., methods will wait forever. (This
@@ -114,21 +116,22 @@ declare class MessageWait {
      *   be ignored (useful for permission checks).
      *
      * An action is matched if its container is this message, its `action_id` is one of the parameters
-     * passed in, and it passes all the function checks.
-     *
-     * NOTE: You must specify at least one non-function parameter, since the `action_id` of the action
-     * must match one of the arguments.
+     * passed in (or any `action_id` if no strings are passed in), and it passes all the function
+     * checks.
      *
      * @param specifiers An array of specifiers (see above for their format)
      * @returns The action that occurred that matches the specifiers.
      * @throws `SlackTimeoutError` if timed out before a matched event occurred
      */
-    action<ActionIDs extends (string | ActionPredicate)[]>(...specifiers: ActionIDs): Promise<ExtractActionWaitReturnValue<ExtractString<ActionIDs[number]>>>;
+    action<ActionIDs extends (ActionsToPrefixedID<ExtractActions<Blocks>> | ActionPredicate)[]>(...specifiers: ActionIDs): Promise<DistributeAction<ExtractWaitActionType<ExtractString<ActionIDs[number]>, ExtractActions<Blocks>>>>;
 }
 type ActionPredicate = (action: ActionInstance) => boolean | Promise<boolean>;
-type ExtractActionWaitReturnValue<ActionID extends string> = ActionInstance<ExtractWaitActionType<ActionID>>;
-type ExtractWaitActionType<Specifier extends string> = {
-    [K in Specifier]: BlockAction & ExtractTypeAndActionID<Specifier>;
+type DistributeAction<T extends BlockAction> = T extends any ? ActionInstance<T> : never;
+type ExtractWaitActionType<Specifier extends string, Action extends {
+    type: string;
+    action_id?: string;
+}> = {
+    [K in Specifier]: BlockAction & Action & ExtractTypeAndActionID<Specifier>;
 }[Specifier];
 type ExtractTypeAndActionID<T extends string> = T extends `${infer Type extends BlockActionTypes}.${infer ActionID}` ? {
     type: Type;

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

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

package/dist/{resources → src/resources}/message.js

@@ -100,7 +100,7 @@ export class Message extends MessageMixin {
      * find out.
      */
     get author() {
-        return new UserRef(this.client, this.#data.user);
+        return this.#data.user ? new UserRef(this.client, this.#data.user) : undefined;
     }
     get _threadTs() {
         return this.#data.thread_ts;
@@ -142,10 +142,8 @@ class MessageWait {
      *   be ignored (useful for permission checks).
      *
      * An action is matched if its container is this message, its `action_id` is one of the parameters
-     * passed in, and it passes all the function checks.
-     *
-     * NOTE: You must specify at least one non-function parameter, since the `action_id` of the action
-     * must match one of the arguments.
+     * passed in (or any `action_id` if no strings are passed in), and it passes all the function
+     * checks.
      *
      * @param specifiers An array of specifiers (see above for their format)
      * @returns The action that occurred that matches the specifiers.
@@ -190,8 +188,9 @@ class MessageWait {
                 }
             }
             if (!subscriptions.length) {
-                reject(new SlackError("No action ID specifiers given"));
-                return;
+                console.warn("[MessageWait.action] warning: no action_id is passed. it is recommended to pass a list of action_id's to reduce the number of events that needs to be processed.");
+                this.client.on("action", callback);
+                subscriptions.push("action");
             }
             const timer = this._timeout
                 ? setTimeout(() => {

package/dist/src/resources/modal.d.ts

@@ -0,0 +1,22 @@
+import type { KnownBlock } from "@slack/types";
+import type { ModalView } from "../api/types/view.js";
+import type { App } from "../client.js";
+import { type SubmissionInstance } from "./submission.js";
+export declare class Modal<Blocks extends KnownBlock[] = KnownBlock[]> {
+    #private;
+    protected client: App;
+    constructor(client: App, data: ModalView<Blocks>);
+    get raw(): ModalView<Blocks>;
+    get wait(): ModalWait<Blocks>;
+}
+export type ModalInstance<Blocks extends KnownBlock[] = KnownBlock[]> = Modal<Blocks> & ModalView<Blocks>;
+declare class ModalWait<Blocks extends KnownBlock[] = KnownBlock[]> {
+    private client;
+    private modal;
+    private _timeout;
+    constructor(client: App, modal: ModalInstance<Blocks>);
+    timeout(timeout: number): this;
+    submit(): Promise<SubmissionInstance<Blocks>>;
+}
+export {};
+//# sourceMappingURL=modal.d.ts.map

package/dist/src/resources/modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal.d.ts","sourceRoot":"","sources":["../../../src/resources/modal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAGpC,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAElE,qBAAa,KAAK,CAAC,MAAM,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE;;IAI3D,SAAS,CAAC,MAAM,EAAE,GAAG;gBAAX,MAAM,EAAE,GAAG,EACrB,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC;IAMxB,IAAI,GAAG,sBAEN;IAED,IAAI,IAAI,sBAEP;CACD;AAED,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,GACpF,SAAS,CAAC,MAAM,CAAC,CAAA;AAElB,cAAM,SAAS,CAAC,MAAM,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE;IAIxD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;IAJd,OAAO,CAAC,QAAQ,CAAgB;gBAGvB,MAAM,EAAE,GAAG,EACX,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC;IAGrC,OAAO,CAAC,OAAO,EAAE,MAAM;IAKjB,MAAM;CA0BZ"}

package/dist/src/resources/slash.d.ts

@@ -0,0 +1,15 @@
+import type { SlashCommandPayload } from "../api/slash/index.js";
+import type { App } from "../client.js";
+import { Responder } from "../utils/respond.js";
+import { ChannelRef } from "./channel.js";
+import { UserRef } from "./user.js";
+export declare class SlashCommand {
+    #private;
+    private client;
+    constructor(client: App, data: SlashCommandPayload);
+    get respond(): Responder<true>;
+    get user(): UserRef;
+    get channel(): ChannelRef;
+}
+export type SlashCommandInstance = SlashCommand & SlashCommandPayload;
+//# sourceMappingURL=slash.d.ts.map

package/dist/src/resources/slash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash.d.ts","sourceRoot":"","sources":["../../../src/resources/slash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAEhC,qBAAa,YAAY;;IAIvB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,GAAG,EACnB,IAAI,EAAE,mBAAmB;IAM1B,IAAI,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAE7B;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,OAAO,IAAI,UAAU,CAExB;CACD;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,mBAAmB,CAAA"}

package/dist/src/resources/slash.js

@@ -0,0 +1,22 @@
+import { makeProxy } from "../utils/index.js";
+import { Responder } from "../utils/respond.js";
+import { ChannelRef } from "./channel.js";
+import { UserRef } from "./user.js";
+export class SlashCommand {
+    client;
+    #data;
+    constructor(client, data) {
+        this.client = client;
+        this.#data = data;
+        return makeProxy(this, () => this.#data);
+    }
+    get respond() {
+        return new Responder(this.client, this.#data.response_url, this.#data.trigger_id);
+    }
+    get user() {
+        return new UserRef(this.client, this.#data.user_id);
+    }
+    get channel() {
+        return new ChannelRef(this.client, this.#data.channel_id);
+    }
+}

package/dist/src/resources/submission.d.ts

@@ -0,0 +1,13 @@
+import type { KnownBlock } from "@slack/types";
+import type { ViewSubmission } from "../api/interactive/view_submission.js";
+import type { App } from "../client.js";
+import { Responder } from "../utils/respond.js";
+export declare class Submission<Blocks extends KnownBlock[] = KnownBlock[]> {
+    #private;
+    protected client: App;
+    constructor(client: App, data: ViewSubmission<Blocks>);
+    get respond(): Responder;
+    get values(): import("../blocks/utils/extract.js").ExtractValues<Blocks>;
+}
+export type SubmissionInstance<Blocks extends KnownBlock[] = KnownBlock[]> = Submission<Blocks> & ViewSubmission<Blocks>;
+//# sourceMappingURL=submission.d.ts.map

package/dist/src/resources/submission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submission.d.ts","sourceRoot":"","sources":["../../../src/resources/submission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE5C,qBAAa,UAAU,CAAC,MAAM,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE;;IAIhE,SAAS,CAAC,MAAM,EAAE,GAAG;gBAAX,MAAM,EAAE,GAAG,EACrB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC;IAM7B,IAAI,OAAO,IAAI,SAAS,CAEvB;IAED,IAAI,MAAM,4DAET;CACD;AAED,MAAM,MAAM,kBAAkB,CAAC,MAAM,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,GAC9F,cAAc,CAAC,MAAM,CAAC,CAAA"}

package/dist/{resources → src/resources}/submission.js

@@ -1,5 +1,5 @@
 import { makeProxy } from "../utils/index.js";
-import { ResponderImpl } from "../utils/respond.js";
+import { Responder } from "../utils/respond.js";
 export class Submission {
     client;
     #data;
@@ -9,6 +9,9 @@ export class Submission {
         return makeProxy(this, () => this.#data);
     }
     get respond() {
-        return new ResponderImpl(this.client, this.#data.response_urls[0], this.#data.trigger_id);
+        return new Responder(this.client, this.#data.response_urls[0], this.#data.trigger_id);
+    }
+    get values() {
+        return this.#data.view.state.values;
     }
 }

package/dist/src/resources/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../src/resources/user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,mBAAmB,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,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAEzD,cAAM,SAAS;;IAIb,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;CAgB1C;AAED,qBAAa,OAAQ,SAAQ,SAAU,YAAW,WAAW,CAAC,YAAY,CAAC;;IAC1E,IAAI,CAAC,QAAQ,GAAG,YAAY,EAAE,QAAQ,GAAG,KAAK,EAC7C,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC5F,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,IAAK,SAAQ,SAAS;;gBAGtB,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ;CAKnD;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,QAAQ,CAAA"}

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

@@ -0,0 +1 @@
+{"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/src/utils/messaging.d.ts

@@ -0,0 +1,34 @@
+import type { KnownBlock } from "@slack/types";
+import type { NormalMessage } from "../api/types/message.js";
+import type { ChatPostEphemeralParams, 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<Blocks extends KnownBlock[] = KnownBlock[]> {
+    channel: string;
+    files: SendMessageFile[];
+    thread_ts?: string;
+    text?: string;
+    blocks?: Blocks;
+    token?: string;
+}
+export type SendMessageWithoutFiles<Blocks extends KnownBlock[] = KnownBlock[]> = {
+    files?: never;
+    blocks?: Blocks;
+} & (({
+    ephemeral?: false;
+} & ChatPostMessageParams) | ({
+    ephemeral: true;
+} & ChatPostEphemeralParams));
+export type SendMessageParams<Blocks extends KnownBlock[] = KnownBlock[]> = SendMessageWithFiles<Blocks> | SendMessageWithoutFiles<Blocks>;
+export declare function sendMessage<Blocks extends KnownBlock[] = KnownBlock[]>(client: App, params: SendMessageParams<Blocks>): Promise<{
+    channel: string;
+    ts: string;
+    message: NormalMessage<Blocks>;
+} | undefined>;
+//# sourceMappingURL=messaging.d.ts.map

package/dist/src/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,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACrF,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,CAAC,MAAM,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE;IAC/E,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,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,uBAAuB,CAAC,MAAM,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,IAAI;IACjF,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,CACD,CAAC;IAAE,SAAS,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG,qBAAqB,CAAC,GAC/C,CAAC;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,GAAG,uBAAuB,CAAC,CACjD,CAAA;AAED,MAAM,MAAM,iBAAiB,CAAC,MAAM,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,IACrE,oBAAoB,CAAC,MAAM,CAAC,GAC5B,uBAAuB,CAAC,MAAM,CAAC,CAAA;AAElC,wBAAsB,WAAW,CAAC,MAAM,SAAS,UAAU,EAAE,GAAG,UAAU,EAAE,EAC3E,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC;;;aA0BH,aAAa,CAAC,MAAM,CAAC;eAGnD"}

package/dist/{utils → src/utils}/messaging.js

@@ -13,9 +13,19 @@ export async function sendMessage(client, params) {
             blocks: params.blocks,
         });
     }
+    else if (params.ephemeral) {
+        const { ephemeral: _, ...payload } = params;
+        const message = await client.request("chat.postEphemeral", payload);
+        console.log(message);
+    }
     else {
-        const message = await client.request("chat.postMessage", params);
-        return { channel: message.channel, ts: message.ts, message: message.message };
+        const { ephemeral: _, ...payload } = params;
+        const message = await client.request("chat.postMessage", payload);
+        return {
+            channel: message.channel,
+            ts: message.ts,
+            message: message.message,
+        };
     }
 }
 async function uploadHelper(client, file) {

package/dist/{utils → src/utils}/paginate.d.ts

@@ -4,7 +4,7 @@ import type { DistributiveOmit } from "./typing.js";
 export declare function paginate<Method extends SlackPaginatingAPIMethod, T>(client: App, method: Method, params: DistributiveOmit<SlackAPIParams<Method>, "limit" | "cursor"> & {
     limit?: number;
     batch?: number;
-}, converter: (response: SlackAPIResponse<Method> & {
+}, converter: (response: Extract<SlackAPIResponse<Method>, {
     ok: true;
-}) => Iterable<T> | AsyncIterable<T>): AsyncGenerator<Awaited<T>, void, unknown>;
+}>) => Iterable<T> | AsyncIterable<T>): AsyncGenerator<Awaited<T>, void, unknown>;
 //# sourceMappingURL=paginate.d.ts.map

package/dist/src/utils/paginate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.d.ts","sourceRoot":"","sources":["../../../src/utils/paginate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAA;AACxF,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAEhD,wBAAuB,QAAQ,CAAC,MAAM,SAAS,wBAAwB,EAAE,CAAC,EACzE,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,gBAAgB,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,GAAG;IACtE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,EACD,SAAS,EAAE,CACV,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC,KACrD,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,6CAmBnC"}

package/dist/src/utils/respond.d.ts

@@ -0,0 +1,24 @@
+import type { KnownBlock } from "@slack/types";
+import type { App } from "../client.js";
+import type { ViewsOpenParams } from "../api/web/views.js";
+import { type ModalInstance } from "../resources/modal.js";
+export declare class Responder<HasResponseURL extends boolean = true> {
+    private client;
+    private response_url;
+    private trigger_id;
+    constructor(client: App, response_url: string | undefined, trigger_id: string);
+    message(this: Responder<true>, message: string | MessageResponseParams): Promise<void>;
+    edit(this: Responder<true>, message: string | MessageResponseParams): Promise<void>;
+    delete(this: Responder<true>): Promise<void>;
+    modal<View extends ViewsOpenParams["view"]>(view: View): Promise<ModalInstance<View["blocks"]>>;
+}
+export type MessageResponseParams = {
+    ephemeral?: boolean;
+    text?: string;
+    blocks?: KnownBlock[];
+} & ({
+    text: string;
+} | {
+    blocks: KnownBlock[];
+});
+//# sourceMappingURL=respond.d.ts.map

package/dist/src/utils/respond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond.d.ts","sourceRoot":"","sources":["../../../src/utils/respond.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAS,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAG9D,qBAAa,SAAS,CAAC,cAAc,SAAS,OAAO,GAAG,IAAI;IAE1D,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,UAAU;gBAFV,MAAM,EAAE,GAAG,EACX,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,UAAU,EAAE,MAAM;IAGrB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,qBAAqB;IAuBtE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,qBAAqB;IAuBnE,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC;IAc5B,KAAK,CAAC,IAAI,SAAS,eAAe,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI;CAK5D;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;CACrB,GAAG,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CAAA"}

package/dist/{utils → src/utils}/respond.js

@@ -1,7 +1,7 @@
 import { SlackError } from "../error.js";
 import { Modal } from "../resources/modal.js";
 import { randomUUID } from "crypto";
-export class ResponderImpl {
+export class Responder {
     client;
     response_url;
     trigger_id;

package/dist/src/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;AAE7F,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAA;AAE3F,MAAM,MAAM,aAAa,CACxB,CAAC,SAAS,MAAM,EAChB,UAAU,SAAS,MAAM,GAAG,MAAM,EAClC,GAAG,SAAS,MAAM,GAAG,GAAG,EACxB,UAAU,GAAG,KAAK,IACf,CAAC,SAAS,GAAG,MAAM,MAAM,SAAS,UAAU,GAAG,GAAG,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,UAAU,CAAA;AAEvF,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,CAAA"}

package/dist/src/utils/typing.js

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