postscale 1.0.0

data/lib/postscale/response.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Postscale
+  class Headers
+    attr_reader :headers, :request_id, :retry_after
+
+    def initialize(headers = {})
+      @headers = {}
+      headers.each { |key, value| @headers[key.to_s] = value }
+      @request_id = self["X-Request-ID"]
+      @retry_after = self["Retry-After"]
+    end
+
+    def [](name)
+      lookup = name.to_s.downcase
+      pair = @headers.find { |key, _| key.downcase == lookup }
+      pair && pair[1]
+    end
+  end
+
+  class Result
+    attr_reader :data, :error, :headers
+
+    def initialize(data:, error:, headers:)
+      @data = data
+      @error = error
+      @headers = headers
+    end
+
+    def success?
+      @error.nil?
+    end
+  end
+
+  Response = Result
+end

data/lib/postscale/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Postscale
+  VERSION = "1.0.0"
+end

data/lib/postscale/webhook_verification.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module Postscale
+  class WebhookVerificationResult
+    attr_reader :code, :message, :timestamp
+
+    def initialize(valid:, code: nil, message: nil, timestamp: nil)
+      @valid = valid
+      @code = code
+      @message = message
+      @timestamp = timestamp
+    end
+
+    def valid?
+      @valid
+    end
+
+    alias valid valid?
+  end
+
+  module Webhook
+    DEFAULT_TOLERANCE_SECONDS = 300
+
+    module_function
+
+    def verify_signature(body, header, secrets, now: Time.now.to_i, tolerance_seconds: DEFAULT_TOLERANCE_SECONDS)
+      candidates = Array(secrets).compact.reject { |secret| secret.to_s.empty? }
+      return invalid("missing_secret", "At least one webhook secret is required.") if candidates.empty?
+
+      parsed = parse_signature_header(header)
+      return parsed if parsed.is_a?(WebhookVerificationResult)
+
+      timestamp, signatures = parsed
+      if (now.to_i - timestamp).abs > tolerance_seconds
+        return invalid(
+          "timestamp_outside_tolerance",
+          "Webhook signature timestamp is outside the allowed tolerance.",
+          timestamp
+        )
+      end
+
+      signed_payload = "#{timestamp}.#{body}"
+      candidates.each do |secret|
+        expected = OpenSSL::HMAC.hexdigest("SHA256", secret.to_s, signed_payload)
+        signatures.each do |signature|
+          return WebhookVerificationResult.new(valid: true, timestamp: timestamp) if secure_compare(expected, signature)
+        end
+      end
+
+      invalid("signature_mismatch", "Webhook signature does not match.", timestamp)
+    end
+
+    def sign_body(body, secret, timestamp: Time.now.to_i)
+      signature = OpenSSL::HMAC.hexdigest("SHA256", secret.to_s, "#{timestamp}.#{body}")
+      "t=#{timestamp},v1=#{signature}"
+    end
+
+    def parse_signature_header(header)
+      return invalid("malformed_header", "Webhook signature header is empty.") if header.nil? || header.strip.empty?
+
+      timestamp_raw = nil
+      signatures = []
+
+      header.split(",").each do |part|
+        key, value = part.strip.split("=", 2)
+        return invalid("malformed_header", "Webhook signature header is malformed.") if key.nil? || key.empty? || value.nil? || value.empty?
+
+        if key == "v1"
+          signatures << value
+        elsif key == "t"
+          return invalid("malformed_header", "Webhook signature header has multiple timestamps.") unless timestamp_raw.nil?
+
+          timestamp_raw = value
+        end
+      end
+
+      return invalid("missing_timestamp", "Webhook signature header is missing t=.") if timestamp_raw.nil?
+      return invalid("missing_signature", "Webhook signature header is missing v1=.") if signatures.empty?
+
+      begin
+        [Integer(timestamp_raw), signatures]
+      rescue ArgumentError
+        invalid("malformed_header", "Webhook signature timestamp is malformed.")
+      end
+    end
+    private_class_method :parse_signature_header
+
+    def secure_compare(expected, actual)
+      return false unless expected.bytesize == actual.to_s.bytesize
+
+      result = 0
+      expected.bytes.zip(actual.to_s.bytes) { |left, right| result |= left ^ right }
+      result.zero?
+    end
+    private_class_method :secure_compare
+
+    def invalid(code, message, timestamp = nil)
+      WebhookVerificationResult.new(
+        valid: false,
+        code: code,
+        message: message,
+        timestamp: timestamp
+      )
+    end
+    private_class_method :invalid
+  end
+end

data/lib/postscale.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require "json"
+require "base64"
+require "net/http"
+require "uri"
+require "openssl"
+require "time"
+
+require_relative "postscale/version"
+require_relative "postscale/errors"
+require_relative "postscale/response"
+require_relative "postscale/configuration"
+require_relative "postscale/http_client"
+require_relative "postscale/attachments"
+require_relative "postscale/webhook_verification"
+require_relative "postscale/client"
+
+require_relative "postscale/resources/resource"
+require_relative "postscale/resources/emails"
+require_relative "postscale/resources/domains"
+require_relative "postscale/resources/dkim"
+require_relative "postscale/resources/aliases"
+require_relative "postscale/resources/inbound"
+require_relative "postscale/resources/stats"
+require_relative "postscale/resources/warming"
+require_relative "postscale/resources/suppressions"
+require_relative "postscale/resources/webhooks"
+require_relative "postscale/resources/templates"
+require_relative "postscale/resources/usage"
+require_relative "postscale/resources/trust"
+
+module Postscale
+  class << self
+    def client
+      @client ||= Client.new
+    end
+
+    def configure(**options)
+      @client = Client.new(**options)
+    end
+
+    def attachment_from_file(path, content_type = "application/octet-stream")
+      Attachments.from_file(path, content_type)
+    end
+
+    def attachment_from_bytes(filename, data, content_type = "application/octet-stream")
+      Attachments.from_bytes(filename, data, content_type)
+    end
+
+    def verify_webhook_signature(body, header, secrets, **options)
+      Webhook.verify_signature(body, header, secrets, **options)
+    end
+
+    def sign_webhook_body(body, secret, timestamp: Time.now.to_i)
+      Webhook.sign_body(body, secret, timestamp: timestamp)
+    end
+
+    def method_missing(method, *args, **kwargs, &block)
+      if client.respond_to?(method)
+        client.public_send(method, *args, **kwargs, &block)
+      else
+        super
+      end
+    end
+
+    def respond_to_missing?(method, include_private = false)
+      client.respond_to?(method, include_private) || super
+    end
+  end
+end

data/postscale.gemspec

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative "lib/postscale/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "postscale"
+  spec.version       = Postscale::VERSION
+  spec.authors       = ["Postscale"]
+  spec.email         = ["support@postscale.io"]
+
+  spec.summary       = "Official Ruby SDK for the Postscale email API"
+  spec.description   = "Send transactional emails, manage domains, DKIM, templates, webhooks, and more with the Postscale API."
+  spec.homepage      = "https://github.com/postscale/postscale-ruby"
+  spec.license       = "MIT"
+
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata = {
+    "homepage_uri"      => spec.homepage,
+    "source_code_uri"   => "https://github.com/postscale/postscale-ruby",
+    "documentation_uri" => "https://docs.postscale.io/sdks/ruby",
+    "changelog_uri"     => "https://github.com/postscale/postscale-ruby/blob/main/CHANGELOG.md",
+    "bug_tracker_uri"   => "https://github.com/postscale/postscale-ruby/issues",
+    "rubygems_mfa_required" => "true"
+  }
+
+  spec.files = Dir.glob("lib/**/*") + %w[LICENSE README.md postscale.gemspec]
+  spec.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: postscale
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Postscale
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-06-18 00:00:00.000000000 Z
+dependencies: []
+description: Send transactional emails, manage domains, DKIM, templates, webhooks,
+  and more with the Postscale API.
+email:
+- support@postscale.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/postscale.rb
+- lib/postscale/attachments.rb
+- lib/postscale/client.rb
+- lib/postscale/configuration.rb
+- lib/postscale/errors.rb
+- lib/postscale/http_client.rb
+- lib/postscale/resources/aliases.rb
+- lib/postscale/resources/dkim.rb
+- lib/postscale/resources/domains.rb
+- lib/postscale/resources/emails.rb
+- lib/postscale/resources/inbound.rb
+- lib/postscale/resources/resource.rb
+- lib/postscale/resources/stats.rb
+- lib/postscale/resources/suppressions.rb
+- lib/postscale/resources/templates.rb
+- lib/postscale/resources/trust.rb
+- lib/postscale/resources/usage.rb
+- lib/postscale/resources/warming.rb
+- lib/postscale/resources/webhooks.rb
+- lib/postscale/response.rb
+- lib/postscale/version.rb
+- lib/postscale/webhook_verification.rb
+- postscale.gemspec
+homepage: https://github.com/postscale/postscale-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/postscale/postscale-ruby
+  source_code_uri: https://github.com/postscale/postscale-ruby
+  documentation_uri: https://docs.postscale.io/sdks/ruby
+  changelog_uri: https://github.com/postscale/postscale-ruby/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/postscale/postscale-ruby/issues
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.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 the Postscale email API
+test_files: []