mailkite 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5c90dce58b0e00df106212cea51814eac48aa3bb8d882ccf40d472d36b383597
+  data.tar.gz: 1d0c0d768de9751bdbbfe1e90d03053c9b06b9f64a05f93c91f5982f3ade6a1b
+SHA512:
+  metadata.gz: 813a0066f5324b66fbb921c275ce35d59749d65a5c04bd69889e2dbb30f3c5a23906400f3b55143c795838d47ef7f305ac94e430f2313cd64be6225e92b15c15
+  data.tar.gz: 42ced2df301a792ced60398f3b75d476598dec347ddf180bb0e0c8a66a9863b295910d5ef702b67015d15036f6bb629cff7bb4ef65f4cce1ace9e7a4afbf7cd4

data/lib/mailkite.rb

@@ -0,0 +1,167 @@
+# MailKite SDK for Ruby.
+#
+# Shape shared by every MailKite SDK: one low-level `request` plus one thin
+# method per API endpoint. Zero dependencies — uses the standard library.
+#
+#   require "mailkite"
+#   mk = Mailkite::Client.new(ENV["MAILKITE_API_KEY"])
+#   res = mk.send({ "from" => ..., "to" => ..., "subject" => ..., "text" => ... })
+
+require "net/http"
+require "uri"
+require "json"
+require "openssl"
+
+module Mailkite
+  VERSION = "0.1.0"
+  DEFAULT_BASE_URL = "https://api.mailkite.dev"
+  # Reject webhook events older than this (ms) to block replays. Pass 0 to disable.
+  DEFAULT_TOLERANCE_MS = 5 * 60 * 1000
+
+  # Verify an `x-mailkite-signature` header on an inbound webhook delivery.
+  # Local HMAC-SHA256 check — no network call. Pass the raw, unparsed body.
+  def self.verify_webhook(signature, payload, secret, tolerance_ms = DEFAULT_TOLERANCE_MS)
+    return false unless signature.is_a?(String) && !signature.empty?
+
+    parts = {}
+    signature.split(",").each do |seg|
+      i = seg.index("=")
+      next unless i
+      parts[seg[0...i].strip] = seg[(i + 1)..].strip
+    end
+    t = parts["t"]
+    v1 = parts["v1"]
+    return false if t.nil? || v1.nil? || t.empty? || v1.empty? || !t.match?(/\A-?\d+\z/)
+
+    # The t in the header is milliseconds since the epoch.
+    if tolerance_ms && tolerance_ms > 0
+      return false if ((Time.now.to_f * 1000) - t.to_i).abs > tolerance_ms
+    end
+
+    expected = OpenSSL::HMAC.hexdigest("SHA256", secret, "#{t}.#{payload}")
+    secure_compare(expected, v1)
+  rescue StandardError
+    false
+  end
+
+  # Length-independent constant-time string compare (no openssl >= 2.2 needed).
+  def self.secure_compare(a, b)
+    return false unless a.bytesize == b.bytesize
+
+    diff = 0
+    a.bytes.each_with_index { |byte, i| diff |= byte ^ b.getbyte(i) }
+    diff.zero?
+  end
+
+  class Error < StandardError
+    attr_reader :status, :body
+
+    def initialize(status, message, body = nil)
+      super(message)
+      @status = status
+      @body = body
+    end
+  end
+
+  class Client
+    VERBS = {
+      "GET" => Net::HTTP::Get,
+      "POST" => Net::HTTP::Post,
+      "PUT" => Net::HTTP::Put,
+      "DELETE" => Net::HTTP::Delete,
+    }.freeze
+
+    def initialize(api_key, base_url = DEFAULT_BASE_URL)
+      @api_key = api_key
+      @base_url = base_url.sub(%r{/+\z}, "")
+    end
+
+    # Low-level request. Every method below is a one-liner on top of this.
+    def request(method, path, body = nil)
+      uri = URI(@base_url + path)
+      req = VERBS.fetch(method).new(uri)
+      req["Authorization"] = "Bearer #{@api_key}"
+      unless body.nil?
+        req["Content-Type"] = "application/json"
+        req.body = JSON.generate(body)
+      end
+
+      res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
+      text = res.body
+      data = text && !text.empty? ? JSON.parse(text) : nil
+      code = res.code.to_i
+      unless code >= 200 && code < 300
+        message = data.is_a?(Hash) ? data["error"] : nil
+        raise Error.new(code, message || res.message || "HTTP #{code}", data)
+      end
+      data
+    end
+
+    # --- Sending --------------------------------------------------------
+    def send(message)
+      request("POST", "/v1/send", message)
+    end
+
+    # --- Domains --------------------------------------------------------
+    def listDomains
+      request("GET", "/api/domains")
+    end
+
+    def createDomain(body)
+      request("POST", "/api/domains", body)
+    end
+
+    def getDomain(id)
+      request("GET", "/api/domains/#{id}")
+    end
+
+    def deleteDomain(id)
+      request("DELETE", "/api/domains/#{id}")
+    end
+
+    def verifyDomain(id)
+      request("POST", "/api/domains/#{id}/verify")
+    end
+
+    def setWebhook(id, body)
+      request("PUT", "/api/domains/#{id}/webhook", body)
+    end
+
+    def deleteWebhook(id)
+      request("DELETE", "/api/domains/#{id}/webhook")
+    end
+
+    def testWebhook(id)
+      request("POST", "/api/domains/#{id}/webhook/test")
+    end
+
+    # --- Routes ---------------------------------------------------------
+    def listRoutes
+      request("GET", "/api/routes")
+    end
+
+    def createRoute(body)
+      request("POST", "/api/routes", body)
+    end
+
+    # --- Messages & deliveries -----------------------------------------
+    def listMessages
+      request("GET", "/api/messages")
+    end
+
+    def getMessage(id)
+      request("GET", "/api/messages/#{id}")
+    end
+
+    def retryDelivery(id)
+      request("POST", "/api/deliveries/#{id}/retry")
+    end
+
+    # --- Webhooks -------------------------------------------------------
+    # Instance wrapper around Mailkite.verify_webhook, so you can verify on an
+    # existing client. No network call; no API key required.
+    def verifyWebhook(signature, payload, secret, tolerance_ms = DEFAULT_TOLERANCE_MS)
+      Mailkite.verify_webhook(signature, payload, secret, tolerance_ms)
+    end
+  end
+end

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: mailkite
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- MailKite
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-06-22 00:00:00.000000000 Z
+dependencies: []
+description: Send and manage email over your own authenticated domain with MailKite.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/mailkite.rb
+homepage: https://mailkite.dev/docs/libraries
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/fijiwebdesign/mailkite
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.5'
+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 MailKite SDK for Ruby
+test_files: []