feat(slack): Enhanced DM management and file operations with API-aligned typings

slack/actions/dms/send.ts

@@ -17,6 +17,22 @@ export interface SendDmProps {
   blocks?: unknown[];
 }
 
+export interface SendDmResponse {
+  success: boolean;
+  message: string;
+  channelId?: string;
+  ts?: string;
+  messageData?: {
+    ok: boolean;
+    channel: string;
+    ts: string;
+    warning?: string;
+    response_metadata?: {
+      warnings?: string[];
+    };
+  };
+}
+
 /**
  * @description Sends a direct message to a user
  * @action send-dm
@@ -25,41 +41,32 @@ export default async function sendDm(
   props: SendDmProps,
   _req: Request,
   ctx: AppContext,
-): Promise<
-  { success: boolean; message: string; channelId?: string; ts?: string }
-> {
+): Promise<SendDmResponse> {
   try {
-    // Open a DM channel with the user
-    const channelResponse = await ctx.slack.openDmChannel(props.userId);
-
-    if (!channelResponse.ok) {
-      return {
-        success: false,
-        message: `Failed to open DM channel: ${
-          channelResponse.error || "Unknown error"
-        }`,
-      };
-    }
-
-    const channelId = channelResponse.data.channel.id;
-
-    // Send the message to the DM channel
-    const messageResponse = await ctx.slack.postMessage(channelId, props.text, {
+    // Send message directly to the user ID (Slack automatically opens DM channel)
+    const messageResponse = await ctx.slack.postMessage(props.userId, props.text, {
       blocks: props.blocks,
     });
 
     if (!messageResponse.ok) {
       return {
         success: false,
-        message: "Failed to send DM: Unknown error",
+        message: `Failed to send DM: ${messageResponse.error || "Unknown error"}`,
       };
     }
 
     return {
       success: true,
       message: "DM sent successfully",
-      channelId,
+      channelId: messageResponse.channel,
       ts: messageResponse.ts,
+      messageData: {
+        ok: messageResponse.ok,
+        channel: messageResponse.channel,
+        ts: messageResponse.ts,
+        warning: messageResponse.warning,
+        response_metadata: messageResponse.response_metadata,
+      },
     };
   } catch (error: unknown) {
     const message = error instanceof Error ? error.message : String(error);

slack/actions/files/upload.ts

@@ -0,0 +1,112 @@
+import type { AppContext } from "../../mod.ts";
+
+export interface UploadFileProps {
+  /**
+   * @description Channel ID or DM ID to send the file to (e.g., C123... or D123...)
+   */
+  channels: string;
+
+  /**
+   * @description File content as base64 string or File object
+   */
+  file: string | File;
+
+  /**
+   * @description Name of the file
+   */
+  filename: string;
+
+  /**
+   * @description Title of the file
+   */
+  title?: string;
+
+  /**
+   * @description Initial comment/message that accompanies the file
+   */
+  initial_comment?: string;
+
+  /**
+   * @description File type (optional, usually auto-detected)
+   */
+  filetype?: string;
+}
+
+export interface UploadFileResponse {
+  ok: boolean;
+  file?: {
+    id: string;
+    created: number;
+    timestamp: number;
+    name: string;
+    title: string;
+    mimetype: string;
+    filetype: string;
+    pretty_type: string;
+    user: string;
+    editable: boolean;
+    size: number;
+    mode: string;
+    is_external: boolean;
+    external_type: string;
+    is_public: boolean;
+    public_url_shared: boolean;
+    display_as_bot: boolean;
+    username: string;
+    url_private: string;
+    url_private_download: string;
+    permalink: string;
+    permalink_public?: string;
+    channels: string[];
+    groups: string[];
+    ims: string[];
+    comments_count: number;
+    is_starred?: boolean;
+  };
+  error?: string;
+  warning?: string;
+  response_metadata?: {
+    warnings?: string[];
+  };
+}
+
+/**
+ * @description Uploads a file to Slack
+ * @action upload-file
+ */
+export default async function uploadFile(
+  props: UploadFileProps,
+  _req: Request,
+  ctx: AppContext,
+): Promise<UploadFileResponse> {
+  try {
+    const response = await ctx.slack.uploadFile({
+      channels: props.channels,
+      file: props.file,
+      filename: props.filename,
+      title: props.title,
+      initial_comment: props.initial_comment,
+      filetype: props.filetype,
+    });
+
+    if (!response.ok) {
+      return {
+        ok: false,
+        error: response.error || "Failed to upload file",
+      };
+    }
+
+    return {
+      ok: response.ok,
+      file: response.file,
+      warning: response.warning,
+      response_metadata: response.response_metadata,
+    };
+  } catch (error) {
+    console.error("Error uploading file:", error);
+    return {
+      ok: false,
+      error: error instanceof Error ? error.message : "Unknown error",
+    };
+  }
+}