zapsmtp 0.1.0.beta3

data/lib/zapsmtp/errors.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module ZapSMTP
+  # An error answer of the API, or no answer at all (ConnectionError). Every
+  # error the library raises is a ZapSMTP::Error.
+  class Error < StandardError
+    # @return [Integer] the HTTP status; 0 when there was no answer
+    attr_reader :status
+    # @return [String] the API's error code, e.g. "invalid_parameter"; "" when there is none
+    attr_reader :code
+    # @return [String] the error type, e.g. "invalid_request_error"; "" when there is none
+    attr_reader :type
+    # @return [String, nil] X-Request-Id: quote it to support
+    attr_reader :request_id
+    # @return [Hash{String => String}, nil] the response headers, names in lower case
+    attr_reader :headers
+    # @return [Object] the parsed error body (a Hash with symbol keys), or its text
+    attr_reader :body
+
+    def initialize(message = nil, status: 0, code: "", type: "", request_id: nil, headers: nil, body: nil)
+      super(message)
+      @status = status
+      @code = code
+      @type = type
+      @request_id = request_id
+      @headers = headers
+      @body = body
+    end
+
+    # The error class for an error answer.
+    #
+    # @api private
+    def self.from_response(status, body, headers)
+      hash = body.is_a?(Hash) ? body : {}
+      error = hash[:error].is_a?(Hash) ? hash[:error] : {}
+      code = error[:code] || hash[:name] || ""
+      message = error[:message] || hash[:message] || "HTTP #{status}"
+      class_for(status).new(message.to_s, status: status, code: code.to_s, type: (error[:type] || "").to_s,
+                                          request_id: headers["x-request-id"], headers: headers, body: body)
+    end
+
+    # @api private
+    def self.class_for(status)
+      case status
+      when 401 then AuthenticationError
+      when 403 then PermissionError
+      when 404 then NotFoundError
+      when 409 then ConflictError
+      when 400, 413, 422 then ValidationError
+      when 429 then RateLimitError
+      when 500.. then ServerError
+      else Error
+      end
+    end
+  end
+
+  # 401: the API key is missing or invalid.
+  class AuthenticationError < Error; end
+
+  # 403: the key may not do this, or the domain is not verified.
+  class PermissionError < Error; end
+
+  # 404: no such resource.
+  class NotFoundError < Error; end
+
+  # 409: a conflict, e.g. the same Idempotency-Key with another request.
+  class ConflictError < Error; end
+
+  # 400, 413, 422: the request is wrong.
+  class ValidationError < Error; end
+
+  # 429: too many requests, or a quota is used up.
+  class RateLimitError < Error
+    # @return [Float, nil] seconds the API asked to wait (Retry-After), when it said
+    def retry_after
+      Retry.retry_after(headers)
+    end
+  end
+
+  # 5xx: the API failed.
+  class ServerError < Error; end
+
+  # No answer: a network failure or a timeout. #cause holds the underlying error.
+  class ConnectionError < Error; end
+
+  # A webhook request whose signature is missing, wrong or too old, or whose body is not JSON.
+  class WebhookVerificationError < Error; end
+end

data/lib/zapsmtp/generated/client.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+# Generated by sdks/codegen. Do not edit: run node sdks/codegen/generate.mjs.
+
+module ZapSMTP
+  # The ZapSMTP API client.
+  #
+  #   zap = ZapSMTP::Client.new(api_key: "zap_...") # or set ZAP_API_KEY
+  #   zap.emails.send(from: "Acme <hello@acme.com>", to: "jane@example.org", subject: "Hi", html: "<p>Hi</p>")
+  class Client < BaseClient
+    # @return [Resources::Emails]
+    attr_reader :emails
+
+    # @return [Resources::Threads]
+    attr_reader :threads
+
+    # @return [Resources::Inbound]
+    attr_reader :inbound
+
+    # @return [Resources::Simulator]
+    attr_reader :simulator
+
+    # @return [Resources::Stats]
+    attr_reader :stats
+
+    # @return [Resources::Domains]
+    attr_reader :domains
+
+    # @return [Resources::ApiKeys]
+    attr_reader :api_keys
+
+    # @return [Resources::SmtpCredentials]
+    attr_reader :smtp_credentials
+
+    # @return [Resources::Webhooks]
+    attr_reader :webhooks
+
+    # @return [Resources::Templates]
+    attr_reader :templates
+
+    # @return [Resources::Suppressions]
+    attr_reader :suppressions
+
+    # @return [Resources::DedicatedIps]
+    attr_reader :dedicated_ips
+
+    # @return [Resources::Logs]
+    attr_reader :logs
+
+    # @return [Resources::Usage]
+    attr_reader :usage
+
+    # @return [Resources::TemplateModules]
+    attr_reader :template_modules
+
+    # @return [Resources::TemplateAssets]
+    attr_reader :template_assets
+
+    # @return [Resources::TemplateTimers]
+    attr_reader :template_timers
+
+    # @return [Resources::Actions]
+    attr_reader :actions
+
+    # @return [Resources::Variables]
+    attr_reader :variables
+
+    private
+
+    def build_resources
+      @emails = Resources::Emails.new(self)
+      @threads = Resources::Threads.new(self)
+      @inbound = Resources::Inbound.new(self)
+      @simulator = Resources::Simulator.new(self)
+      @stats = Resources::Stats.new(self)
+      @domains = Resources::Domains.new(self)
+      @api_keys = Resources::ApiKeys.new(self)
+      @smtp_credentials = Resources::SmtpCredentials.new(self)
+      @webhooks = Resources::Webhooks.new(self)
+      @templates = Resources::Templates.new(self)
+      @suppressions = Resources::Suppressions.new(self)
+      @dedicated_ips = Resources::DedicatedIps.new(self)
+      @logs = Resources::Logs.new(self)
+      @usage = Resources::Usage.new(self)
+      @template_modules = Resources::TemplateModules.new(self)
+      @template_assets = Resources::TemplateAssets.new(self)
+      @template_timers = Resources::TemplateTimers.new(self)
+      @actions = Resources::Actions.new(self)
+      @variables = Resources::Variables.new(self)
+    end
+  end
+end