hisend 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e8cf15bd446a532daa5f3d6037ba959697017299c1ab53d9e0d0d5428b2607ae
+  data.tar.gz: b105cc09f5cd95fbf0f05ba0121c859ff21bae60cfa2a36653f71773711a9666
+SHA512:
+  metadata.gz: 4bde86c3c218112b8a668f2315d5f27f8ff9c9aca7e38675c2760ca632e73021b2c235a0fa3ddc3c0fc3ce806749159767e60e020f1edde36eb4358419e9048e
+  data.tar.gz: 55b06063de5c084426cc5dd69898a9deb5dd33b80c5248df23a7ac15715efc5b6c698ca259c65924b5a7f6ff0796e47fc5aaf7e73a8613a3370b302b3d526e96

data/lib/hisend/client.rb

@@ -0,0 +1,55 @@
+module Hisend
+  class Client
+    attr_reader :emails, :domains, :routing, :threads
+
+    def initialize(api_key:, base_url: 'https://api.hisend.app/v1')
+      @api_key = api_key
+      @base_url = base_url.chomp('/')
+
+      @emails = Hisend::Resources::Emails.new(self)
+      @domains = Hisend::Resources::Domains.new(self)
+      @routing = Hisend::Resources::Routing.new(self)
+      @threads = Hisend::Resources::Threads.new(self)
+    end
+
+    def request(method, endpoint, payload = nil)
+      uri = URI("#{@base_url}/#{endpoint.sub(/^\//, '')}")
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == 'https'
+
+      req_class = case method.to_s.upcase
+                  when 'GET' then Net::HTTP::Get
+                  when 'POST' then Net::HTTP::Post
+                  when 'PUT' then Net::HTTP::Put
+                  when 'DELETE' then Net::HTTP::Delete
+                  else raise ArgumentError, "Unsupported method: #{method}"
+                  end
+
+      req = req_class.new(uri)
+      req['Authorization'] = "Bearer #{@api_key}"
+      req['Content-Type'] = 'application/json'
+      req['Accept'] = 'application/json'
+
+      if payload
+        # Map :from_ to :from internally for ruby aesthetics if passed as a symbol
+        if payload.key?(:from_)
+          payload[:from] = payload.delete(:from_)
+        end
+        req.body = JSON.generate(payload)
+      end
+
+      response = http.request(req)
+      body = response.body.to_s.empty? ? nil : JSON.parse(response.body, symbolize_names: true)
+
+      unless response.is_a?(Net::HTTPSuccess)
+        error_msg = body.is_a?(Hash) && (body[:message] || body[:error]) ? (body[:message] || body[:error]) : response.body
+        raise Hisend::Error.new("API request failed: #{error_msg}", response.code.to_i)
+      end
+
+      body
+    rescue JSON::ParserError
+      raise Hisend::Error.new("Invalid JSON response from server: #{response.body}", response&.code&.to_i)
+    end
+  end
+end

data/lib/hisend/errors.rb

@@ -0,0 +1,10 @@
+module Hisend
+  class Error < StandardError
+    attr_reader :status_code
+
+    def initialize(message = "Hisend API Error", status_code = nil)
+      super(message)
+      @status_code = status_code
+    end
+  end
+end

data/lib/hisend/resources/domains.rb

@@ -0,0 +1,29 @@
+module Hisend
+  module Resources
+    class Domains
+      def initialize(client)
+        @client = client
+      end
+
+      def list
+        @client.request(:get, 'domains')
+      end
+
+      def get(id)
+        @client.request(:get, "domains/#{id}")
+      end
+
+      def verify(id)
+        @client.request(:get, "domains/#{id}/verify")
+      end
+
+      def add(data)
+        @client.request(:post, 'domains', data)
+      end
+
+      def delete(id)
+        @client.request(:delete, "domains/#{id}")
+      end
+    end
+  end
+end

data/lib/hisend/resources/emails.rb

@@ -0,0 +1,25 @@
+module Hisend
+  module Resources
+    class Emails
+      def initialize(client)
+        @client = client
+      end
+
+      def list
+        @client.request(:get, 'emails')
+      end
+
+      def get(id)
+        @client.request(:get, "emails/#{id}")
+      end
+
+      def send(data)
+        @client.request(:post, 'emails', data)
+      end
+
+      def send_batch(data)
+        @client.request(:post, 'emails/batch', data)
+      end
+    end
+  end
+end

data/lib/hisend/resources/routing.rb

@@ -0,0 +1,29 @@
+module Hisend
+  module Resources
+    class Routing
+      def initialize(client)
+        @client = client
+      end
+
+      def list(domain_id)
+        @client.request(:get, "domains/#{domain_id}/routing")
+      end
+
+      def create(domain_id, data)
+        @client.request(:post, "domains/#{domain_id}/routing", data)
+      end
+
+      def update(domain_id, id, data)
+        @client.request(:put, "domains/#{domain_id}/routing/#{id}", data)
+      end
+
+      def get(domain_id, id)
+        @client.request(:get, "domains/#{domain_id}/routing/#{id}")
+      end
+
+      def delete(domain_id, id)
+        @client.request(:delete, "domains/#{domain_id}/routing/#{id}")
+      end
+    end
+  end
+end

data/lib/hisend/resources/threads.rb

@@ -0,0 +1,17 @@
+module Hisend
+  module Resources
+    class Threads
+      def initialize(client)
+        @client = client
+      end
+
+      def list
+        @client.request(:get, 'threads')
+      end
+
+      def get_emails(id)
+        @client.request(:get, "threads/#{id}/emails")
+      end
+    end
+  end
+end

data/lib/hisend.rb

@@ -0,0 +1,14 @@
+require 'json'
+require 'net/http'
+require 'uri'
+
+require_relative 'hisend/errors'
+require_relative 'hisend/client'
+require_relative 'hisend/resources/domains'
+require_relative 'hisend/resources/emails'
+require_relative 'hisend/resources/routing'
+require_relative 'hisend/resources/threads'
+
+module Hisend
+  # Entry point is Hisend::Client
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: hisend
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Hisend
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-03-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: The official Hisend Ruby client for interacting with the Hisend API.
+email: support@hisend.app
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/hisend.rb
+- lib/hisend/client.rb
+- lib/hisend/errors.rb
+- lib/hisend/resources/domains.rb
+- lib/hisend/resources/emails.rb
+- lib/hisend/resources/routing.rb
+- lib/hisend/resources/threads.rb
+homepage: https://hisend.app
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Official Ruby SDK for Hisend
+test_files: []