mailkite 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26eb50d856d1ba16356a5fc399a84414774dccf715a0dc6291b451030ea27272
-  data.tar.gz: 3472e6b74b0772e5c18906fb66e9fd8c39dcb6de194fbf1a78b131086d676d3c
+  metadata.gz: 1271ec234bd17506cc9aa35f15262d7708bb827786df2da37065457b90e0f106
+  data.tar.gz: 490ce824dc5ff8097190a893db918f906945c4239822387a9e39f10e4fa85f29
 SHA512:
-  metadata.gz: ca926ae3006b0fde3931988b8e1cb62f196831e60bf9e3d77cf5b0b10ba8dd724858ef1428a3decc422787e166e876c471605e04384880c1030e209f6dca5420
-  data.tar.gz: ae7bcbefece087b52e9936df73b885a63a4e264b6b05d0b6b362fb086dcc0bd4413df2b5b60c598680120e8e4c2adc7358564e453d7293fb970b4e35feb93e09
+  metadata.gz: 621ff2176d573d2df21262f249e018b5e0acce0ab79d296ecc40ee9e2e5d031c60009bd7514ea292fa9bb4a76183ceecbb4d573837e6388b3194e8b4231bd167
+  data.tar.gz: 3515d606332f77ba60b3304f0d7945cf3e4cfaf77799ea719b9a3d6b20c9f3736f7bb12152020b3d5d31a35ce4a84157e3c5e4418467015d5d5861fc43262e84

data/lib/mailkite.rb

@@ -15,7 +15,7 @@ require "base64"
 require "cgi"
 
 module Mailkite
-  VERSION = "0.12.0"
+  VERSION = "0.13.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
@@ -151,16 +151,28 @@ module Mailkite
       "DELETE" => Net::HTTP::Delete,
     }.freeze
 
-    def initialize(api_key, base_url = DEFAULT_BASE_URL)
-      @api_key = api_key
+    # Authenticate with a Bearer token. `api_key` (mk_live_…) and the `access_token:` keyword (an
+    # OAuth access token) are equivalent — both are Bearer credentials. For short-lived OAuth
+    # tokens pass `get_token:` — a callable invoked before each request for a fresh token (it wins):
+    #   MailKite::Client.new("mk_live_...")
+    #   MailKite::Client.new(access_token: my_oauth_token)
+    #   MailKite::Client.new(get_token: -> { current_session.access_token })
+    def initialize(api_key = nil, base_url = DEFAULT_BASE_URL, access_token: nil, get_token: nil)
+      @api_key = api_key.nil? ? access_token : api_key
+      @get_token = get_token
       @base_url = base_url.sub(%r{/+\z}, "")
     end
 
+    # The Bearer token for one request: a fresh one from get_token if set, else the static key/token.
+    def token
+      @get_token ? @get_token.call : @api_key
+    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}"
+      req["Authorization"] = "Bearer #{token}"
       unless body.nil?
         req["Content-Type"] = "application/json"
         req.body = JSON.generate(body)
@@ -178,7 +190,7 @@ module Mailkite
       qs = query.map { |k, v| "#{CGI.escape(k)}=#{CGI.escape(v.to_s)}" }.join("&")
       uri = URI("#{@base_url}/v1/attachments?#{qs}")
       req = Net::HTTP::Post.new(uri)
-      req["Authorization"] = "Bearer #{@api_key}"
+      req["Authorization"] = "Bearer #{token}"
       req["Content-Type"] = content_type
       req.body = bytes
       perform(req, uri)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mailkite
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - MailKite