slack.ts 0.0.2 → 0.0.4

package/README.md

@@ -4,13 +4,30 @@ An opinionated Slack API library with full TypeScript support.
 
 ## Usage
 
+You can install this package from npm with
+
+```shell
+npm i slack.ts
+# or
+bun add slack.ts
+```
+
+Sample usage:
+
 ```typescript
 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()
 ```
+
+For more examples, see [the examples directory](./examples).

package/dist/api/index.d.ts

@@ -1,7 +1,14 @@
+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 { ConversationsHistoryParams, ConversationsHistoryResponse, ConversationsInfoParams, ConversationsInfoResponse, ConversationsRepliesParams, ConversationsRepliesResponse } from "./web/conversations.js";
+import type { FilesCompleteUploadExternalParams, FilesCompleteUploadExternalResponse, FilesGetUploadURLExternalParams, FilesGetUploadURLExternalResponse } from "./web/files.js";
+import type { UsersInfoParams, UsersInfoResponse } from "./web/users.js";
 export interface SlackWebAPIMap {
+    "apps.connections.open": {
+        params: AppsConnectionsOpenParams;
+        response: AppsConnectionsOpenResponse;
+    };
     "auth.test": {
         params: AuthTestParams;
         response: AuthTestResponse;
@@ -14,10 +21,26 @@ export interface SlackWebAPIMap {
         params: ConversationsInfoParams;
         response: ConversationsInfoResponse;
     };
+    "conversations.history": {
+        params: ConversationsHistoryParams;
+        response: ConversationsHistoryResponse;
+    };
     "conversations.replies": {
         params: ConversationsRepliesParams;
         response: ConversationsRepliesResponse;
     };
+    "files.completeUploadExternal": {
+        params: FilesCompleteUploadExternalParams;
+        response: FilesCompleteUploadExternalResponse;
+    };
+    "files.getUploadURLExternal": {
+        params: FilesGetUploadURLExternalParams;
+        response: FilesGetUploadURLExternalResponse;
+    };
+    "users.info": {
+        params: UsersInfoParams;
+        response: UsersInfoResponse;
+    };
 }
 export type SlackAPIMethod = keyof SlackWebAPIMap;
 export type SlackAPIParams<Method extends SlackAPIMethod> = SlackWebAPIMap[Method]["params"] & {
@@ -29,4 +52,5 @@ export type SlackAPIResponse<Method extends SlackAPIMethod> = {
 } | ({
     ok: true;
 } & 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,0BAA0B,EAC1B,4BAA4B,EAC5B,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;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAErE,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,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;IACD,YAAY,EAAE;QACb,MAAM,EAAE,eAAe,CAAA;QACvB,QAAQ,EAAE,iBAAiB,CAAA;KAC3B,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/interactive/block_actions.d.ts

@@ -0,0 +1,79 @@
+import type { PlainTextElement } from "@slack/types";
+import type { AnyMessage } from "../types/message.js";
+export interface BlockActions {
+    type: "block_actions";
+    user: {
+        id: string;
+        username: string;
+        name: string;
+        team_id: string;
+    };
+    api_app_id: string;
+    token: string;
+    container: BlockActionContainer;
+    trigger_id: string;
+    team: {
+        id: string;
+        domain: string;
+        enterprise_id?: string;
+        enterprise_name?: string;
+    };
+    enterprise?: {
+        id: string;
+        name: string;
+    };
+    is_enterprise_install?: boolean;
+    channel?: {
+        id: string;
+        name: string;
+    };
+    message?: AnyMessage;
+    state?: {
+        values: Record<string, Record<string, unknown>>;
+    };
+    response_url?: string;
+    actions: BlockAction[];
+}
+interface MessageAttachmentContainer {
+    type: "message_attachment";
+    message_ts: string;
+    attachment_id: number;
+    channel_id: string;
+    is_ephemeral: boolean;
+    is_app_unfurl: boolean;
+}
+interface ViewContainer {
+    type: "view";
+    view_id: string;
+}
+interface MessageContainer {
+    type: "message";
+    message_ts: string;
+    channel_id: string;
+    is_ephemeral: boolean;
+}
+type BlockActionContainer = MessageAttachmentContainer | ViewContainer | MessageContainer;
+interface ActionCommon {
+    block_id: string;
+    action_id: string;
+    action_ts: string;
+}
+export interface ButtonAction extends ActionCommon {
+    type: "button";
+    text: PlainTextElement;
+    value?: string;
+    style?: "primary" | "danger";
+}
+export interface PlainTextInputAction extends ActionCommon {
+    type: "plain_text_input";
+    value: string | null;
+}
+export type BlockAction = ButtonAction | PlainTextInputAction;
+export type BlockActionTypes = BlockAction["type"];
+export type BlockActionMap = {
+    [K in BlockActionTypes]: BlockAction & {
+        type: K;
+    };
+};
+export {};
+//# sourceMappingURL=block_actions.d.ts.map

package/dist/api/interactive/block_actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_actions.d.ts","sourceRoot":"","sources":["../../../src/api/interactive/block_actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IACrE,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,oBAAoB,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACtF,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACzC,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,OAAO,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,CAAA;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,WAAW,EAAE,CAAA;CACtB;AAED,UAAU,0BAA0B;IACnC,IAAI,EAAE,oBAAoB,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,OAAO,CAAA;IACrB,aAAa,EAAE,OAAO,CAAA;CACtB;AAED,UAAU,aAAa;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CACf;AAED,UAAU,gBAAgB;IACzB,IAAI,EAAE,SAAS,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,OAAO,CAAA;CACrB;AAED,KAAK,oBAAoB,GAAG,0BAA0B,GAAG,aAAa,GAAG,gBAAgB,CAAA;AAEzF,UAAU,YAAY;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IACjD,IAAI,EAAE,QAAQ,CAAA;IACd,IAAI,EAAE,gBAAgB,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;CAC5B;AAED,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACzD,IAAI,EAAE,kBAAkB,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,oBAAoB,CAAA;AAE7D,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;AAElD,MAAM,MAAM,cAAc,GAAG;KAC3B,CAAC,IAAI,gBAAgB,GAAG,WAAW,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE;CAClD,CAAA"}

package/dist/api/interactive/block_actions.js

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

package/dist/api/types/user.d.ts

@@ -0,0 +1,54 @@
+export interface User {
+    id: string;
+    team_id: string;
+    name: string;
+    deleted: boolean;
+    color: string;
+    real_name: string;
+    tz: string;
+    tz_label: string;
+    tz_offset: number;
+    profile: UserProfile;
+    is_admin: boolean;
+    is_owner: boolean;
+    is_primary_owner: boolean;
+    is_restricted: boolean;
+    is_ultra_restricted: boolean;
+    is_bot: boolean;
+    updated: number;
+    is_app_user: boolean;
+    has_2fa: boolean;
+}
+export interface UserProfile {
+    real_name: string;
+    display_name?: string;
+    avatar_hash?: string;
+    real_name_normalized: string;
+    display_name_normalized?: string;
+    image_24: string;
+    image_32: string;
+    image_48: string;
+    image_72: string;
+    image_192: string;
+    image_512: string;
+    image_original?: string;
+    first_name?: string;
+    last_name?: string;
+    team: string;
+    email?: string;
+    title?: string;
+    pronouns?: string;
+    phone?: string;
+    skype?: string;
+    status_text?: string;
+    status_text_canonical?: string;
+    status_emoji?: string;
+    status_emoji_display_info?: {
+        emoji_name: string;
+        display_url: string;
+    }[];
+    status_expiration?: number;
+    huddle_state?: string;
+    huddle_state_expiration_ts?: number;
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/api/types/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../src/api/types/user.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,WAAW,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,gBAAgB,EAAE,OAAO,CAAA;IACzB,aAAa,EAAE,OAAO,CAAA;IACtB,mBAAmB,EAAE,OAAO,CAAA;IAC5B,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yBAAyB,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0BAA0B,CAAC,EAAE,MAAM,CAAA;CACnC"}

package/dist/api/types/user.js

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

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.js";
+import type { KnownBlock } from "@slack/types";
+import type { Attachment, NormalMessage } from "../types/message.js";
 interface MarkdownMessage {
     markdown_text: string;
     blocks?: never;
@@ -6,16 +7,16 @@ 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;

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

@@ -20,6 +20,18 @@ export interface ConversationsInfoParams {
 export interface ConversationsInfoResponse {
     channel: Conversation;
 }
+export interface ConversationsHistoryParams extends CursorPaginationParams, TimestampPaginationParams {
+    /** Conversation ID to fetch history for. */
+    channel: string;
+    /** Return all metadata associated with this message. */
+    include_all_metadata?: boolean;
+}
+export interface ConversationsHistoryResponse extends CursorPaginationResponse {
+    messages: AnyMessage[];
+    pin_count: number;
+    channel_actions_ts?: number | null;
+    channel_actions_count?: number;
+}
 export interface ConversationsRepliesParams extends CursorPaginationParams, TimestampPaginationParams {
     /** Conversation ID to fetch thread from. */
     channel: string;

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

@@ -1 +1 @@
-{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../../src/api/web/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,uBAAuB;IACvC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IAEf;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACzC,OAAO,EAAE,YAAY,CAAA;CACrB;AAED,MAAM,WAAW,0BAChB,SAAQ,sBAAsB,EAAE,yBAAyB;IACzD,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;IAEf;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,4BAA6B,SAAQ,wBAAwB;IAC7E,QAAQ,EAAE,UAAU,EAAE,CAAA;CACtB"}
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../../src/api/web/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,uBAAuB;IACvC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;IAEf;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACzC,OAAO,EAAE,YAAY,CAAA;CACrB;AAED,MAAM,WAAW,0BAChB,SAAQ,sBAAsB,EAAE,yBAAyB;IACzD,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;IAEf,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,4BAA6B,SAAQ,wBAAwB;IAC7E,QAAQ,EAAE,UAAU,EAAE,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,0BAChB,SAAQ,sBAAsB,EAAE,yBAAyB;IACzD,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;IAEf;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,4BAA6B,SAAQ,wBAAwB;IAC7E,QAAQ,EAAE,UAAU,EAAE,CAAA;CACtB"}

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/api/web/users.d.ts

@@ -0,0 +1,11 @@
+import type { User } from "../types/user.js";
+export interface UsersInfoParams {
+    /** User to get info on */
+    user: string;
+    /** Set this to `true` to receive the locale for this user. Defaults to `false` */
+    include_locale?: boolean;
+}
+export interface UsersInfoResponse {
+    user: User;
+}
+//# sourceMappingURL=users.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../src/api/web/users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAEzC,MAAM,WAAW,eAAe;IAC/B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IAEZ,kFAAkF;IAClF,cAAc,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,IAAI,CAAA;CACV"}

package/dist/api/web/users.js

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

package/dist/client.d.ts

@@ -1,11 +1,66 @@
 import { ChannelRef } from "./resources/channel.js";
-import type { SlackAPIMethod, SlackAPIParams, SlackAPIResponse } from "./api/index.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, AllEventTypes, EventWrapper, SlackEventMap } from "./events/types/index.js";
+import { type MessageInstance } from "./resources/message.js";
+import type { MessageEvent } from "./events/types/events.js";
+import type { BlockAction, BlockActionMap, BlockActions, BlockActionTypes } from "./api/interactive/block_actions.js";
+import EventEmitter from "events";
+import { Action, type ActionInstance } from "./resources/action.js";
+type ReceiverOptions = ({
+    type: "socket";
+} & DistributiveOmit<SocketEventsReceiverOptions, "client">) | {
+    type: "dummy";
+    options?: never;
+};
 interface AppOptions {
     token?: string;
+    receiver?: ReceiverOptions;
 }
-export declare class App {
+export type MessageCallbackData = {
+    message: MessageInstance;
+    client: App;
+    event: EventWrapper<MessageEvent>;
+};
+export type MessageCallback = (data: MessageCallbackData) => unknown;
+export type EventCallbackData<Event extends AllEvents> = {
+    client: App;
+    event: EventWrapper<Event>;
+};
+export type EventCallback<Event extends AllEvents> = (data: EventCallbackData<Event>) => unknown;
+export type BlockActionCallback<Type extends BlockAction> = (data: Action<Type>) => unknown;
+export declare class App extends EventEmitter<AppEventMap> {
     #private;
-    constructor({ token }: AppOptions);
+    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;
+    /**
+     * Registers a callback for a given type of block actions.
+     *
+     * For more powerful callbacks, use `app.on('action:button', ...)`, `app.on('action.action_id',
+     * ...)`, or `app.on('action:button.action_id', ...)` instead.
+     *
+     * @param type Type of event to register
+     * @param callback Function to execute when the event is received
+     */
+    action<Type extends BlockAction>(type: Type["type"], callback: BlockActionCallback<Type>): 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 +77,39 @@ 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;
     }>;
 }
+type AppEventMap = {
+    event: [
+        EventWrapper
+    ];
+    actions: [
+        BlockActions
+    ];
+    action: [
+        ActionInstance
+    ];
+} & {
+    [K in AllEventTypes as `event:${K}`]: [
+        {
+            payload: SlackEventMap[K];
+            event: EventWrapper<SlackEventMap[K]>;
+        }
+    ];
+} & {
+    [K in BlockActionTypes as `action:${K}`]: [
+        ActionInstance<BlockActionMap[K]>
+    ];
+} & {
+    [K in `action.${string}`]: [
+        ActionInstance
+    ];
+} & {
+    [K in BlockActionTypes as `action:${K}.${string}`]: [
+        ActionInstance<BlockActionMap[K]>
+    ];
+};
 export {};
 //# 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":"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"}

package/dist/client.js

@@ -1,10 +1,91 @@
 import { sleep } from "./utils/index.js";
 import { ChannelRef } from "./resources/channel.js";
 import { SlackWebAPIError, SlackWebAPIPlatformError } from "./error.js";
-export class App {
+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";
+import EventEmitter from "events";
+import { Action } from "./resources/action.js";
+export class App extends EventEmitter {
     #token;
-    constructor({ token }) {
+    #receiver;
+    constructor({ token, receiver = { type: "dummy" } } = {}) {
+        super({ captureRejections: true });
+        this.on("error", this.#onCallbackError.bind(this));
         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));
+        this.#receiver.on("block_actions", this.#onBlockActions.bind(this));
+    }
+    async #onEvent(event) {
+        this.emit("event", event);
+        this.emit(`event:${event.event.type}`, { payload: event.event, event: event });
+    }
+    async #onBlockActions(event) {
+        this.emit("actions", event);
+        for (const action of event.actions) {
+            const obj = new Action(this, action, event);
+            this.emit(`action:${action.type}`, obj);
+            this.emit(`action.${action.action_id}`, obj);
+            this.emit(`action:${action.type}.${action.action_id}`, obj);
+        }
+    }
+    async #onCallbackError(error) {
+        console.error("Error occurred executing callback");
+        console.error(error);
+    }
+    /**
+     * Registers a callback for `message` events.
+     *
+     * @param callback Function to execute when a new message is received
+     */
+    message(callback) {
+        this.on("event:message", async ({ event, payload }) => {
+            await callback({
+                event,
+                message: new Message(this, payload.channel, payload.ts, payload),
+                client: this,
+            });
+        });
+    }
+    /**
+     * 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) {
+        this.on(`event:${type}`, async ({ event }) => {
+            await callback({ event: event, client: this });
+        });
+    }
+    /**
+     * Registers a callback for a given type of block actions.
+     *
+     * For more powerful callbacks, use `app.on('action:button', ...)`, `app.on('action.action_id',
+     * ...)`, or `app.on('action:button.action_id', ...)` instead.
+     *
+     * @param type Type of event to register
+     * @param callback Function to execute when the event is received
+     */
+    action(type, callback) {
+        this.on(`action:${type}`, async (action) => {
+            await callback(action);
+        });
+    }
+    /**
+     * 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,7 +105,7 @@ 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") {
+    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) {
@@ -34,7 +115,7 @@ export class App {
                         url.searchParams.append(key, item);
                     }
                 }
-                else {
+                else if (value !== undefined && value !== null) {
                     url.searchParams.set(key, String(value));
                 }
             }

package/dist/error.d.ts

@@ -1,5 +1,7 @@
 export declare class SlackError extends Error {
 }
+export declare class SlackTimeoutError extends Error {
+}
 export declare class SlackWebAPIError extends SlackError {
     url: string;
     data?: unknown | undefined;

package/dist/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,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"}
+{"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"}