sevk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6c7f36600a0d24e9b0125300b35f125d85c3c2d116902386c4336c1969c539b3
+  data.tar.gz: 99ca2a8b06fba11e1d604ea021cd8664b5cd5cd48a01eaef4a0fd38219acf9d2
+SHA512:
+  metadata.gz: ede0ed66474c75ed2544e0e5c1d41013946af97d81728ecdccedc7b1022a2d9ccd5bc8a47f67c99bc5b8a1038f4bb1fb84983024a12d8f08e070565f61bcb70b
+  data.tar.gz: eab455f069c6d246b19385ca7842c66f14d16781fd837d0c5d05c2bcf894973b81eee0ff1d96886c1a4a2e4c6b9b6cad18062ca8a5c87b26c5a2937f2923fbfb

data/README.md

@@ -0,0 +1,75 @@
+> [!WARNING]
+> Sevk is currently in private beta. This SDK is not yet available for public use.
+> Join the waitlist at [sevk.io](https://sevk.io) to get early access.
+
+<p align="center">
+  <img src="https://sevk.io/logo.png" alt="Sevk" width="120" />
+</p>
+
+<h1 align="center">Sevk Ruby SDK</h1>
+
+<p align="center">
+  Official Ruby SDK for <a href="https://sevk.io">Sevk</a> email platform.
+</p>
+
+<p align="center">
+  <a href="https://docs.sevk.io">Documentation</a> •
+  <a href="https://sevk.io">Website</a>
+</p>
+
+## Installation
+
+```bash
+gem install sevk
+```
+
+## Send Email
+
+```ruby
+require 'sevk'
+
+client = Sevk::Client.new('your-api-key')
+
+client.emails.send(
+  to: 'recipient@example.com',
+  from: 'hello@yourdomain.com',
+  subject: 'Hello from Sevk!',
+  html: '<h1>Welcome!</h1>'
+)
+```
+
+## Send Email with Markup
+
+```ruby
+require 'sevk'
+
+client = Sevk::Client.new('your-api-key')
+
+html = Sevk::Markup.render(<<~MARKUP
+  <section padding="40px 20px" background-color="#f8f9fa">
+    <container max-width="600px">
+      <heading level="1" color="#1a1a1a">Welcome!</heading>
+      <paragraph color="#666666">Thanks for signing up.</paragraph>
+      <button href="https://example.com" background-color="#5227FF" color="#ffffff" padding="12px 24px">
+        Get Started
+      </button>
+    </container>
+  </section>
+MARKUP
+)
+
+client.emails.send(
+  to: 'recipient@example.com',
+  from: 'hello@yourdomain.com',
+  subject: 'Welcome!',
+  html: html
+)
+```
+
+## Documentation
+
+For full documentation, visit [docs.sevk.io](https://docs.sevk.io)
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec
+
+desc "Update all dependencies to latest versions"
+task :update do
+  sh "bundle update"
+end
+
+desc "Update dependencies and show outdated gems"
+task :outdated do
+  sh "bundle outdated"
+end
+
+desc "Run tests"
+task :test => :spec
+
+desc "Build the gem"
+task :build do
+  sh "gem build sevk.gemspec"
+end
+
+desc "Install the gem locally"
+task :install => :build do
+  sh "gem install sevk-*.gem"
+end
+
+desc "Release the gem to RubyGems"
+task :release => :build do
+  sh "gem push sevk-*.gem"
+end
+
+desc "Clean up build artifacts"
+task :clean do
+  FileUtils.rm_f Dir.glob("sevk-*.gem")
+  FileUtils.rm_rf "pkg"
+end

data/lib/sevk/client.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+module Sevk
+  class Client
+    attr_reader :api_key, :base_url
+
+    def initialize(api_key:, base_url: nil)
+      @api_key = api_key
+      @base_url = base_url || DEFAULT_BASE_URL
+    end
+
+    def contacts
+      @contacts ||= Resources::Contacts.new(self)
+    end
+
+    def audiences
+      @audiences ||= Resources::Audiences.new(self)
+    end
+
+    def templates
+      @templates ||= Resources::Templates.new(self)
+    end
+
+    def broadcasts
+      @broadcasts ||= Resources::Broadcasts.new(self)
+    end
+
+    def domains
+      @domains ||= Resources::Domains.new(self)
+    end
+
+    def topics
+      @topics ||= Resources::Topics.new(self)
+    end
+
+    def segments
+      @segments ||= Resources::Segments.new(self)
+    end
+
+    def subscriptions
+      @subscriptions ||= Resources::Subscriptions.new(self)
+    end
+
+    def emails
+      @emails ||= Resources::Emails.new(self)
+    end
+
+    def get(path, params = {})
+      request(:get, path, params)
+    end
+
+    def post(path, body = {})
+      request(:post, path, body)
+    end
+
+    def patch(path, body = {})
+      request(:patch, path, body)
+    end
+
+    def put(path, body = {})
+      request(:put, path, body)
+    end
+
+    def delete(path)
+      request(:delete, path)
+    end
+
+    private
+
+    def connection
+      @connection ||= Faraday.new do |conn|
+        conn.request :json
+        conn.response :json, content_type: /\bjson$/
+        conn.request :retry, max: 2, interval: 0.5, backoff_factor: 2
+        conn.headers["Authorization"] = "Bearer #{api_key}"
+        conn.headers["Content-Type"] = "application/json"
+        conn.headers["Accept"] = "application/json"
+        conn.adapter Faraday.default_adapter
+      end
+    end
+
+    def build_url(path)
+      # Ensure base_url ends without slash and path starts with slash
+      base = base_url.chomp("/")
+      path = "/#{path}" unless path.start_with?("/")
+      "#{base}#{path}"
+    end
+
+    def request(method, path, body = nil)
+      url = build_url(path)
+      response = case method
+                 when :get
+                   connection.get(url, body)
+                 when :post
+                   connection.post(url, body)
+                 when :patch
+                   connection.patch(url, body)
+                 when :put
+                   connection.put(url, body)
+                 when :delete
+                   connection.delete(url)
+                 end
+
+      handle_response(response)
+    end
+
+    def handle_response(response)
+      case response.status
+      when 200..299
+        response.body
+      when 400
+        raise ValidationError.new(
+          error_message(response),
+          status_code: response.status,
+          response: response.body
+        )
+      when 401
+        raise AuthenticationError.new(
+          error_message(response),
+          status_code: response.status,
+          response: response.body
+        )
+      when 403
+        raise Error.new(
+          error_message(response),
+          status_code: response.status,
+          response: response.body
+        )
+      when 404
+        raise NotFoundError.new(
+          error_message(response),
+          status_code: response.status,
+          response: response.body
+        )
+      when 429
+        raise RateLimitError.new(
+          error_message(response),
+          status_code: response.status,
+          response: response.body
+        )
+      when 500..599
+        raise ServerError.new(
+          error_message(response),
+          status_code: response.status,
+          response: response.body
+        )
+      else
+        raise Error.new(
+          error_message(response),
+          status_code: response.status,
+          response: response.body
+        )
+      end
+    end
+
+    def error_message(response)
+      if response.body.is_a?(Hash) && response.body["message"]
+        "#{response.status}: #{response.body['message']}"
+      else
+        "#{response.status}: #{response.body}"
+      end
+    end
+  end
+end

data/lib/sevk/error.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Sevk
+  class Error < StandardError
+    attr_reader :status_code, :code, :response
+
+    def initialize(message = nil, status_code: nil, code: nil, response: nil)
+      @status_code = status_code
+      @code = code
+      @response = response
+      super(message)
+    end
+
+    def not_found?
+      status_code == 404
+    end
+
+    def unauthorized?
+      status_code == 401
+    end
+
+    def forbidden?
+      status_code == 403
+    end
+
+    def bad_request?
+      status_code == 400
+    end
+
+    def server_error?
+      status_code.to_i >= 500 && status_code.to_i < 600
+    end
+  end
+
+  class AuthenticationError < Error; end
+  class NotFoundError < Error; end
+  class ValidationError < Error; end
+  class RateLimitError < Error; end
+  class ServerError < Error; end
+end