chat_sdk-slack 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 543fafad91a5d8447aa6e0b1477cc18ea7d55fcdd6d84004ff2e3870877d2097
-  data.tar.gz: e75c3ac11358aaafe1db5e7f0e1a9b80cb77119f177e67787fa41bd36f35c5d3
+  metadata.gz: 1110d3c38cf19a4274fab211b64f496c6fc0fdc9461375a6c55b87711e3395c3
+  data.tar.gz: b78730c7b156b9f2ae0c4b548fe671b062fa12cb7ee31de6993a9e28caca553b
 SHA512:
-  metadata.gz: 3e192ff34beec3c700f69bf0488c3966eb4f8adc9ccb8d69c4004f2d6df75beadec46fcfe68e9f1e28db52489e17a06178cc860de8e70a5ed493d14ac5ff67b0
-  data.tar.gz: 8c9dcbe4c7639f34c229f4600abdacbffe8d1c8b05020a6cc5b6d136ed6caed0c4ca834dae8942c9f7760a3bfc25affe9cbc5f47b3a31e36ef8645555fe0e802
+  metadata.gz: f44439e7c4fe05bac0c9b4d886af0fa01e3a49171712220e82649dca86e3b8f8d7d4277a614d6c9a9c3f3df82694deb3661bc11200b0036934ae5878b0222195
+  data.tar.gz: d845dbde4c82f06e22658e563294ab69b2067dea31f931d2229baf12c6d13230355bf3dad2e731084996789292181139617cbbeef23b798cc7d1975bda6f1466

data/lib/chat_sdk/slack/adapter.rb

@@ -5,7 +5,8 @@ module ChatSDK
     class Adapter < ChatSDK::Adapter::Base
       capabilities :edit_messages, :delete_messages, :ephemeral_messages,
         :file_uploads, :reactions, :modals, :typing_indicator,
-        :streaming_edit, :threads, :direct_messages, :message_history
+        :streaming_edit, :threads, :direct_messages, :message_history,
+        :scheduled_messages
 
       attr_reader :client
 
@@ -135,11 +136,44 @@ module ChatSDK
         @client.reactions_remove(channel: channel_id, timestamp: message_id, name: emoji)
       end
 
+      def get_user(user_id)
+        result = @client.users_info(user: user_id)
+        return nil unless result&.dig("user", "id")
+
+        ChatSDK::Author.new(
+          id: result.dig("user", "id"),
+          name: result.dig("user", "name"),
+          platform: :slack,
+          bot: result.dig("user", "is_bot") || false,
+          raw: result
+        )
+      end
+
       def open_dm(user_id)
         result = @client.conversations_open(users: user_id)
         result["channel"]["id"]
       end
 
+      def schedule_message(channel_id:, message:, post_at:, thread_id: nil)
+        msg = ChatSDK::PostableMessage.from(message)
+        text = msg.text || ""
+
+        params = {channel: channel_id, text: text, post_at: post_at.to_i}
+        params[:thread_ts] = thread_id if thread_id
+
+        result = @client.chat_scheduleMessage(**params)
+
+        ChatSDK::Message.new(
+          id: result["scheduled_message_id"],
+          text: text,
+          author: ChatSDK::Author.new(id: "bot", name: "bot", platform: :slack, bot: true),
+          thread_id: thread_id || result["scheduled_message_id"],
+          channel_id: channel_id,
+          platform: :slack,
+          raw: result
+        )
+      end
+
       def fetch_messages(channel_id:, thread_id: nil, cursor: nil, limit: 50)
         result = if thread_id
           @client.conversations_replies(channel: channel_id, ts: thread_id, cursor: cursor, limit: limit)
@@ -155,11 +189,55 @@ module ChatSDK
         @client.views_open(trigger_id: trigger_id, view: view)
       end
 
+      def publish_home_view(user_id:, view:)
+        @client.views_publish(user_id: user_id, view: view)
+      end
+
+      def set_suggested_prompts(channel_id:, thread_id:, prompts:)
+        @client.assistant_threads_setSuggestedPrompts(
+          channel_id: channel_id,
+          thread_ts: thread_id,
+          prompts: prompts
+        )
+      end
+
+      def set_assistant_status(channel_id:, thread_id:, status:)
+        @client.assistant_threads_setStatus(
+          channel_id: channel_id,
+          thread_ts: thread_id,
+          status: status
+        )
+      end
+
+      def set_assistant_title(channel_id:, thread_id:, title:)
+        @client.assistant_threads_setTitle(
+          channel_id: channel_id,
+          thread_ts: thread_id,
+          title: title
+        )
+      end
+
       def start_typing(channel_id:, thread_id: nil)
         # Slack doesn't have a native typing indicator API for bots
         # This is a no-op but the capability is declared for streaming support
       end
 
+      # Slack-specific: receive real-time events via Socket Mode WebSocket.
+      # Requires the optional 'faye-websocket' gem and an app-level token (xapp-*).
+      # Not part of the base adapter contract.
+      #
+      # Usage:
+      #   adapter.start_socket_mode(app_token: "xapp-...") do |event|
+      #     # event is a ChatSDK::Events::* instance
+      #   end
+      def start_socket_mode(app_token: nil, &block)
+        app_token ||= ENV["SLACK_APP_TOKEN"]
+        raise ChatSDK::ConfigurationError, "Slack app_token required for socket mode" unless app_token
+
+        socket = SocketMode.new(app_token: app_token, bot_client: @client)
+        socket.start(&block)
+      end
+
       def mention(user_id)
         "<@#{user_id}>"
       end

data/lib/chat_sdk/slack/socket_mode.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module ChatSDK
+  module Slack
+    # Implements Slack Socket Mode: receives events over a WebSocket instead of
+    # incoming HTTP webhooks. Useful for local development, firewalled environments,
+    # or any setup that cannot expose a public URL.
+    #
+    # Requires the optional `faye-websocket` gem and an app-level token (xapp-*).
+    #
+    # Usage:
+    #   adapter.start_socket_mode(app_token: "xapp-...") do |event|
+    #     # event is a ChatSDK::Events::* instance
+    #   end
+    class SocketMode
+      PING_INTERVAL = 30
+
+      attr_reader :app_token, :bot_client
+
+      def initialize(app_token:, bot_client:)
+        @app_token = app_token
+        @bot_client = bot_client
+        @running = false
+      end
+
+      def start(&block)
+        raise ArgumentError, "start requires a block" unless block
+
+        load_websocket_driver!
+
+        @running = true
+        while @running
+          url = obtain_websocket_url
+          run_connection(url, &block)
+        end
+      end
+
+      def stop
+        @running = false
+        @ws&.close
+      end
+
+      private
+
+      def load_websocket_driver!
+        require "faye/websocket"
+      rescue LoadError
+        raise ChatSDK::ConfigurationError,
+          "Slack Socket Mode requires the 'faye-websocket' gem. " \
+          "Add gem 'faye-websocket' to your Gemfile."
+      end
+
+      def obtain_websocket_url
+        # apps.connections.open must be called with the app-level token, not the bot token
+        app_client = ::Slack::Web::Client.new(token: @app_token)
+        response = app_client.apps_connections_open
+        response["url"]
+      end
+
+      def run_connection(url, &block)
+        EM.run do
+          @ws = Faye::WebSocket::Client.new(url, nil, ping: PING_INTERVAL)
+
+          @ws.on :message do |ws_event|
+            handle_message(ws_event, &block)
+          end
+
+          @ws.on :close do |_event|
+            @ws = nil
+            EM.stop
+          end
+        end
+      rescue
+        # Let transient errors trigger a reconnect rather than crashing the loop
+        raise unless @running
+      end
+
+      def handle_message(ws_event, &block)
+        data = JSON.parse(ws_event.data)
+
+        # Acknowledge the envelope so Slack doesn't retry
+        acknowledge(data["envelope_id"]) if data["envelope_id"]
+
+        payload = data["payload"]
+        return unless payload
+
+        # Socket Mode wraps Events API payloads in an envelope. The inner payload
+        # matches the same structure our EventParser already handles from webhooks.
+        #
+        # Envelope types:
+        #   "events_api"       -> payload is an event_callback body
+        #   "interactive"      -> payload is a block_actions / view_submission body
+        #   "slash_commands"    -> payload is a slash command body
+        events = EventParser.parse(payload)
+        events.each { |event| block.call(event) }
+      rescue JSON::ParserError
+        # Ignore malformed frames (e.g. pong/control frames)
+      end
+
+      def acknowledge(envelope_id)
+        return unless envelope_id && @ws
+
+        @ws.send(JSON.generate({envelope_id: envelope_id}))
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: chat_sdk-slack
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Quentin Rousseau
@@ -49,6 +49,7 @@ files:
 - lib/chat_sdk/slack/block_kit_renderer.rb
 - lib/chat_sdk/slack/event_parser.rb
 - lib/chat_sdk/slack/modal_renderer.rb
+- lib/chat_sdk/slack/socket_mode.rb
 homepage: https://github.com/rootlyhq/chat-sdk
 licenses:
 - MIT