chat_sdk-linear 0.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 610c576e330ed052f595520e180085ee02ee57ff6f38beef2d3a5de4ad078d44
+  data.tar.gz: e52b81ffe0a6eb62ae36f503f04812b54be7dcd381ef8182edec126fe580faf3
+SHA512:
+  metadata.gz: 02bb007d06f983ec8ba7b354e029dd40fa66bcf943087804663d0c9d25115f12a2c8791544713924dfd29d32d7e92a7051ddd357e903286cb7033c912838d7cf
+  data.tar.gz: 9fa10d981d2c67703271b34ffe2a898fd5a7559f1ff20eb9d012f04f74b0d9934f00836a08d797dad9ab1cf40f00d16983c66e8c4e5c136ed6b89f872d7a6e76

data/lib/chat_sdk/linear/adapter.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+require "openssl"
+require "rack/utils"
+
+module ChatSDK
+  module Linear
+    class Adapter < ChatSDK::Adapter::Base
+      capabilities :reactions
+
+      attr_reader :client
+
+      def initialize(api_key: nil, webhook_secret: nil, bot_username: nil)
+        @api_key = api_key || ENV["LINEAR_API_KEY"]
+        @webhook_secret = webhook_secret || ENV["LINEAR_WEBHOOK_SECRET"]
+        @bot_username = bot_username || ENV["LINEAR_BOT_USERNAME"]
+        raise ChatSDK::ConfigurationError, "Linear api_key required" unless @api_key
+        raise ChatSDK::ConfigurationError, "Linear webhook_secret required" unless @webhook_secret
+
+        @client = ApiClient.new(@api_key)
+      end
+
+      def name
+        :linear
+      end
+
+      # Inbound
+      def verify_request!(rack_request)
+        body = rack_request.body.read
+        rack_request.body.rewind
+
+        signature = rack_request.get_header("HTTP_LINEAR_SIGNATURE")
+
+        unless signature
+          raise ChatSDK::SignatureVerificationError, "Missing Linear signature header"
+        end
+
+        expected = OpenSSL::HMAC.hexdigest("SHA256", @webhook_secret, body)
+
+        unless Rack::Utils.secure_compare(signature, expected)
+          raise ChatSDK::SignatureVerificationError, "Invalid Linear signature"
+        end
+
+        true
+      end
+
+      def ack_response(_rack_request)
+        nil
+      end
+
+      def parse_events(rack_request)
+        payload = read_json_body(rack_request)
+        EventParser.parse(payload, bot_username: @bot_username)
+      rescue JSON::ParserError
+        []
+      end
+
+      # Outbound
+      def post_message(channel_id:, message:, thread_id: nil)
+        msg = ChatSDK::PostableMessage.from(message)
+        text = msg.text || msg.card&.fallback_text || ""
+
+        issue_id = channel_id
+        parent_id = nil
+
+        if thread_id&.include?(":c:")
+          parts = thread_id.split(":c:")
+          parent_id = parts.last
+        end
+
+        result = @client.create_comment(issue_id: issue_id, body: text, parent_id: parent_id)
+        comment = result.dig("data", "commentCreate", "comment") || {}
+        comment_id = comment["id"]
+        user = comment["user"] || {}
+
+        ChatSDK::Message.new(
+          id: comment_id,
+          text: text,
+          author: ChatSDK::Author.new(
+            id: user["id"] || "bot",
+            name: user["name"] || "bot",
+            platform: :linear,
+            bot: true
+          ),
+          thread_id: "linear:#{issue_id}:c:#{comment_id}",
+          channel_id: channel_id,
+          platform: :linear,
+          raw: result
+        )
+      end
+
+      def add_reaction(channel_id:, message_id:, emoji:) # rubocop:disable Lint/UnusedMethodArgument
+        @client.create_reaction(comment_id: message_id, emoji: emoji)
+      end
+
+      def remove_reaction(channel_id:, message_id:, emoji:) # rubocop:disable Lint/UnusedMethodArgument
+        @client.delete_reaction(comment_id: message_id, emoji: emoji)
+      end
+
+      def mention(user_id)
+        "@#{user_id}"
+      end
+
+      def render(postable_message)
+        postable_message.text
+      end
+    end
+  end
+end

data/lib/chat_sdk/linear/api_client.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module ChatSDK
+  module Linear
+    class ApiClient < ChatSDK::ApiClient::Base
+      BASE_URL = "https://api.linear.app"
+
+      def initialize(api_key)
+        @api_key = api_key
+      end
+
+      def create_comment(issue_id:, body:, parent_id: nil)
+        query = <<~GQL
+          mutation CommentCreate($input: CommentCreateInput!) {
+            commentCreate(input: $input) {
+              success
+              comment {
+                id
+                body
+                user { id name }
+              }
+            }
+          }
+        GQL
+        input = {issueId: issue_id, body: body}
+        input[:parentId] = parent_id if parent_id
+        graphql(query, {input: input})
+      end
+
+      def create_reaction(comment_id:, emoji:)
+        query = <<~GQL
+          mutation($input: ReactionCreateInput!) {
+            reactionCreate(input: $input) {
+              success
+            }
+          }
+        GQL
+        graphql(query, {input: {commentId: comment_id, emoji: emoji}})
+      end
+
+      def delete_reaction(comment_id:, emoji:)
+        query = <<~GQL
+          mutation($input: ReactionCreateInput!) {
+            reactionDelete(input: $input) {
+              success
+            }
+          }
+        GQL
+        graphql(query, {input: {commentId: comment_id, emoji: emoji}})
+      end
+
+      private
+
+      def base_url
+        BASE_URL
+      end
+
+      def adapter_name
+        :linear
+      end
+
+      def configure_auth(faraday)
+        faraday.headers["Authorization"] = @api_key.to_s
+      end
+
+      def extract_error_message(response)
+        body = response.body
+        return response.status.to_s unless body.is_a?(Hash)
+
+        body.dig("errors", 0, "message") || body.dig("error") || response.status.to_s
+      end
+
+      def extract_success_body(response)
+        response.body
+      end
+
+      def graphql(query, variables = {})
+        request(:post, "/graphql", {query: query, variables: variables})
+      end
+    end
+  end
+end

data/lib/chat_sdk/linear/event_parser.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module ChatSDK
+  module Linear
+    class EventParser
+      class << self
+        def parse(payload, bot_username: nil)
+          return [] unless payload.is_a?(Hash)
+          return [] unless payload["type"] == "Comment" && payload["action"] == "create"
+
+          data = payload["data"] || {}
+          comment_id = data["id"]
+          body = data["body"] || ""
+          issue_id = data["issueId"] || data.dig("issue", "id")
+          user = data["user"] || {}
+          user_id = user["id"]
+          user_name = user["name"]
+
+          return [] if bot_username && user_name == bot_username
+
+          thread_id = "linear:#{issue_id}:c:#{comment_id}"
+
+          author = ChatSDK::Author.new(
+            id: user_id || "unknown",
+            name: user_name || "unknown",
+            platform: :linear,
+            bot: false
+          )
+
+          msg = ChatSDK::Message.new(
+            id: comment_id&.to_s,
+            text: body,
+            author: author,
+            thread_id: thread_id,
+            channel_id: issue_id,
+            platform: :linear,
+            raw: data
+          )
+
+          [
+            ChatSDK::Events::Mention.new(
+              message: msg,
+              thread_id: thread_id,
+              channel_id: issue_id,
+              platform: :linear,
+              adapter_name: :linear,
+              raw: data
+            )
+          ]
+        end
+      end
+    end
+  end
+end

data/lib/chat_sdk/linear.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "chat_sdk"
+require "faraday"
+require "faraday/net_http"
+require "zeitwerk"
+
+module ChatSDK
+  module Linear
+    class << self
+      def loader
+        @loader ||= begin
+          loader = Zeitwerk::Loader.new
+          loader.tag = "chat_sdk-linear"
+          loader.inflector.inflect("chat_sdk" => "ChatSDK", "linear" => "Linear")
+          loader.push_dir("#{__dir__}/linear", namespace: ChatSDK::Linear)
+          loader.setup
+          loader
+        end
+      end
+    end
+  end
+end
+
+ChatSDK::Linear.loader

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: chat_sdk-linear
+version: !ruby/object:Gem::Version
+  version: 0.4.0
+platform: ruby
+authors:
+- Quentin Rousseau
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: chat_sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Linear issue comment adapter for the ChatSDK framework using GraphQL
+email:
+- quentin@rootly.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/chat_sdk/linear.rb
+- lib/chat_sdk/linear/adapter.rb
+- lib/chat_sdk/linear/api_client.rb
+- lib/chat_sdk/linear/event_parser.rb
+homepage: https://github.com/rootlyhq/chat-sdk
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: Linear adapter for ChatSDK
+test_files: []