commapi 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 205e055b80825657ad0cab27d87d2ae5ee080190737f37c925e7f1a47d6f5a2b
+  data.tar.gz: 34018eb08b401b4461670bc17e471ca6a247dc51e31c0067828c6978b9d34adf
+SHA512:
+  metadata.gz: 0e747abb84f973b19d7e2490b5dff2c8c82a594d51a1eff94c6e7eb0038d72af591ed7e1e0feabcc158142054f1cbc81035542bd70a844b1f407a802c33ddc56
+  data.tar.gz: 190c021e7138f471787688ee0f44c8c0c71597033fae3ae0e022c57be8993596dbc0f8f896e845cd1cb49cfeb22aba587b908f91c18fe7c0efe79b961f64ca81

data/lib/commapi/client.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require "httparty"
+require "json"
+
+module CommApi
+  class Client
+    include HTTParty
+
+    read_timeout Integer(ENV["COMMAPI_TIMEOUT"] || 5)
+
+    def data(http_method, url, body = {})
+      case http_method
+      when :get
+        get(api_url_for(url), headers: api_headers)
+      when :post
+        post(api_url_for(url), body:, headers: api_headers)
+      end
+    end
+
+    def self.data(http_method, url, body = {})
+      self.new.data(http_method, url, body)
+    end
+
+    private
+
+    def api_headers
+      {
+        "Content-Type"  => "application/json",
+        "Authorization" => "Bearer #{CommApi.configuration.token}"
+      }
+    end
+
+    def api_url_for(service_url)
+      File.join(CommApi.configuration.url, service_url)
+    end
+
+    def default_timeout
+      self.class.default_options[:timeout] || self.class.default_options[:read_timeout]
+    end
+
+    def get(url, headers: api_headers, timeout: default_timeout)
+      request(:get, url, headers: headers, timeout: timeout)
+    end
+
+    def post(url, body: {}, headers: api_headers, timeout: default_timeout)
+      request(:post, url, body: body.to_json, headers: headers, timeout: timeout)
+    end
+
+    def patch(url, body: {}, headers: api_headers, timeout: default_timeout)
+      request(:patch, url, body: body.to_json, headers: headers, timeout: timeout)
+    end
+
+    def request(http_method, url, options = {})
+      response = self.class.send(http_method, url, options) rescue OpenStruct.new(code: 599, parsed_response: {})
+      return {} unless response.code == 200 || response.code == 201
+      response.parsed_response
+    end
+  end
+end

data/lib/commapi/configuration.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "active_support/configurable"
+
+module CommApi
+  class Configuration
+    include ActiveSupport::Configurable
+
+    config_accessor(:url)
+    config_accessor(:token)
+    config_accessor(:rabbitmq)
+  end
+end

data/lib/commapi/delivery_method.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module CommApi
+  class DeliveryMethod
+    def initialize(mail) end
+
+    def deliver!(mail)
+      Notification.email(
+        from: mail[:from].formatted.first,
+        to: mail.to,
+        cc: mail.cc,
+        bcc: mail.bcc,
+        subject: mail.subject,
+        text: mail.text_part ? mail.text_part.body&.raw_source : mail.body.raw_source,
+        html: mail.html_part ? mail.html_part.body&.raw_source : mail.body.raw_source,
+        attachments: mail.attachments.map do |a|
+          {
+            filename: a.filename,
+            content: a.body.raw_source,
+            content_type: a.mime_type,
+            contentType: a.mime_type, # TODO: Remove when the API is updated
+            encoding: a.body.encoding
+          }
+        end
+      )
+    end
+  end
+end

data/lib/commapi/messaging/amqp_client.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "bunny"
+
+module CommApi
+  module Messaging
+    class AMQPClient
+      include Singleton
+
+      attr :config, :connection, :channel
+
+      def self.instance
+        @@instance ||= new
+      end
+
+      def initialize
+        rabbitmq = CommApi.configuration.rabbitmq
+        return unless rabbitmq&.has_key?(:url)
+
+        @config = rabbitmq.with_indifferent_access
+        @connection = Bunny.new(config[:url])
+        @connection.start
+
+        @channel = @connection.create_channel
+
+        puts "Connected to #{amqp_url}"
+      rescue Bunny::TCPConnectionFailed => e
+        puts "Connection to #{amqp_url} failed: #{e.message}"
+      end
+
+      def self.classes
+        Dir["app/exchanges/*.rb", "engines/**/app/exchanges/*.rb"].
+          map { |file| File.basename(file, ".rb") }.
+          map(&:camelize).
+          map(&:constantize)
+      end
+
+      def self.connect
+        classes.each { |k| k.new } if instance.connection&.connected?
+      end
+
+      def self.disconnect!
+        instance.connection.close
+        @@instance = nil
+        puts "Disconnected from #{instance.amqp_url}"
+      end
+
+      private
+
+      def amqp_url
+        @config[:url].sub(/\/\/.*@/, "//")
+      end
+    end
+  end
+end

data/lib/commapi/messaging/exchange.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module CommApi
+  module Messaging
+    class Exchange
+      def self.exchange(exchange_name, type:, routing_key:, queue: nil, exchange_options: {}, queue_options: {})
+        return unless AMQPClient.instance.connection&.connected?
+        channel = AMQPClient.instance.channel
+        @exchange_name = exchange_name
+
+        # TODO: implement direct and fanout
+        @exchange, @queue = case type
+                            when :topic
+                              x = channel.topic(exchange_name, { durable: true }.merge(exchange_options))
+                              q = channel.queue(queue, queue_options).bind(x, routing_key:) if queue
+                              [x, q]
+                            end
+      end
+
+      def self.subscribe(options = { manual_ack: false })
+        return unless AMQPClient.instance.connection&.connected?
+        # TODO: show usage?
+        raise "Exchange is not defined" unless @exchange
+        raise "Queue is not defined" unless @queue
+
+        @queue.subscribe({ block: false }.merge(options)) do |delivery_info, properties, payload|
+          r = { delivery_info:, properties:, payload: }
+          yield r
+          AMQPClient.instance.channel.acknowledge(delivery_info.delivery_tag) if options[:manual_ack]
+        end
+      end
+
+      def self.publish(payload, options = {})
+        return unless AMQPClient.instance.connection&.connected?
+        # TODO: show usage?
+        raise "Exchange is not defined" unless @exchange
+        raise "Routing key is not defined" unless options.has_key?(:routing_key)
+
+        @exchange.publish(payload,
+                          {
+                            routing_key: options[:routing_key],
+                            message_id: SecureRandom.uuid,
+                            persistent: true,
+                            content_type: "application/json",
+                            content_encoding: "UTF-8"
+                          }.merge(options))
+      end
+    end
+  end
+end

data/lib/commapi/messaging.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module CommApi
+  module Messaging
+    autoload :AMQPClient, "commapi/messaging/amqp_client"
+    autoload :Exchange, "commapi/messaging/exchange"
+  end
+end

data/lib/commapi/notification.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module CommApi
+  class Notification
+    def self.email(options)
+      Client.data(:post, "/api/v1/email", options)
+    end
+
+    def self.sms(options)
+      Client.data(:post, "/api/v1/sms", options)
+    end
+  end
+end

data/lib/commapi/railtie.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module CommApi
+  class Railtie < Rails::Railtie
+    config.after_initialize do
+      ActionMailer::Base.add_delivery_method(:commapi, CommApi::DeliveryMethod)
+
+      CommApi::Messaging::AMQPClient.connect
+    end
+  end
+end

data/lib/commapi.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CommApi
+  autoload :Configuration, "commapi/configuration"
+  autoload :Client, "commapi/client"
+  autoload :Notification, "commapi/notification"
+  autoload :DeliveryMethod, "commapi/delivery_method"
+  autoload :Messaging, "commapi/messaging"
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  def self.configure
+    yield configuration
+  end
+end
+
+require "commapi/railtie" if defined?(Rails::Railtie)

metadata

@@ -0,0 +1,122 @@
+--- !ruby/object:Gem::Specification
+name: commapi
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Nomadix
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-05-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: actioncable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: actionmailer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: bunny
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.18.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.18.0
+description: Nomadix CommAPI Ruby gem
+email:
+- rubygems@nomadix.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/commapi.rb
+- lib/commapi/client.rb
+- lib/commapi/configuration.rb
+- lib/commapi/delivery_method.rb
+- lib/commapi/messaging.rb
+- lib/commapi/messaging/amqp_client.rb
+- lib/commapi/messaging/exchange.rb
+- lib/commapi/notification.rb
+- lib/commapi/railtie.rb
+homepage: https://nomadix.com
+licenses: []
+metadata:
+  homepage_uri: https://nomadix.com
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.16
+signing_key:
+specification_version: 4
+summary: Nomadix CommAPI Ruby gem
+test_files: []