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

slack/README.md

@@ -9,7 +9,18 @@ A Deco app for integrating with Slack using OAuth 2.0 authentication. This app a
 - 📋 **Channel Operations** - List and interact with workspace channels
 - 👥 **User Management** - Get user information and profiles
 - 🎯 **Reactions** - Add emoji reactions to messages
-- 🔄 **Automatic Token Refresh** - Handles token expiration automatically
+- � **File Upload V2** - Upload files using the new Slack API (files.upload sunset Nov 12, 2025)
+- �🔄 **Automatic Token Refresh** - Handles token expiration automatically
+
+## ⚠️ IMPORTANT: File Upload API Migration
+
+**The Slack `files.upload` API will be sunset on November 12, 2025.** This app now includes:
+
+- ✅ **New V2 Upload API** - Using `files.getUploadURLExternal` + `files.completeUploadExternal`
+- ⚠️ **Legacy API Support** - With deprecation warnings (will be removed)
+- 📖 **Migration Guide** - See [UPLOAD_MIGRATION.md](./UPLOAD_MIGRATION.md) for details
+
+**Action Required**: Update your file upload code to use `uploadFileV2()` method before November 12, 2025.
 
 ## Setup Instructions
 
@@ -78,6 +89,22 @@ After OAuth setup, the app will automatically:
 ### Reactions
 - `addReaction(channelId, timestamp, reaction)` - Add emoji reaction
 
+### File Upload
+- `uploadFileV2(options)` - Upload files using new V2 API (recommended)
+- `uploadFile(options)` - Upload files using legacy API (deprecated, shows warning)
+
+**New V2 Upload Example:**
+```typescript
+const response = await slack.uploadFileV2({
+  channels: "C1234567890", // Optional
+  file: fileBlob, // Supports Uint8Array, Blob, File, base64, data URL
+  filename: "document.pdf",
+  title: "Important Document",
+  thread_ts: "1234567890.123456", // Optional - upload to thread
+  initial_comment: "Here's the document"
+});
+```
+
 ## Migration from Bot Token
 
 If you're migrating from the previous bot token approach:

slack/actions/deco-chat/channels/invoke.ts

@@ -4,6 +4,7 @@ import type { AppContext, SlackWebhookPayload } from "../../../mod.ts";
 
 /**
  * @name DECO_CHAT_CHANNELS_INVOKE
+ * @title Deco Chat Channel Invoke
  * @description This action is triggered when slack sends a webhook event
  */
 export default async function invoke(

slack/actions/deco-chat/channels/join.ts

@@ -3,6 +3,7 @@ import type { AppContext } from "../../../mod.ts";
 
 /**
  * @name DECO_CHAT_CHANNELS_JOIN
+ * @title Deco Chat Channel Join
  * @description This action is triggered when channel is selected
  */
 export default async function join(

slack/actions/deco-chat/channels/leave.ts

@@ -3,6 +3,7 @@ import type { AppContext } from "../../../mod.ts";
 
 /**
  * @name DECO_CHAT_CHANNELS_LEAVE
+ * @title Deco Chat Channel Leave
  * @description This action is triggered when slack integration is left
  */
 export default async function leave(

slack/actions/dms/send.ts

@@ -17,49 +17,58 @@ 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[];
+    };
+  };
+}
+
 /**
+ * @name DMS_SEND
+ * @title Send DM
  * @description Sends a direct message to a user
  * @action send-dm
  */
 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,
-      ts: messageResponse.ts,
+      channelId: messageResponse.data.channel,
+      ts: messageResponse.data.ts,
+      messageData: {
+        ok: messageResponse.ok,
+        channel: messageResponse.data.channel,
+        ts: messageResponse.data.ts,
+        warning: messageResponse.data.warning,
+        response_metadata: messageResponse.response_metadata,
+      },
     };
   } catch (error: unknown) {
     const message = error instanceof Error ? error.message : String(error);