mailkite 0.5.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 16ccb6cd1fe7bcc80237e945bd42ea0f5f0f69d6fc618b955d8b0e93f70c04ef
-  data.tar.gz: 198dd419d07e5dda9fb2023ec653b600098f63f6837f11344db3e156d28c37e3
+  metadata.gz: ea16a5e20d5b4548d304b4c3ddd9a11d8ab600c10084b97128d409f92e99e816
+  data.tar.gz: b05b9ccaca0842f125cbe58841ba68b8ef57477feb159eb49498d522e4c1c04e
 SHA512:
-  metadata.gz: d61fd1fe911b68d90fb8359eb62fca139a8858d8dd3752d4930420e6ea2fdb6ed59c9264936a3582359ae407d5320946621c7ddcca151e691aeb24a6bf8977a5
-  data.tar.gz: 88ff488ba25e4ffccf1fdc4c26b5bcaf38b2a7bf7fb3d795a0f8165c08f53e6166bcb01420ec826c370895b163b83cd427ae7e984c1b97f4953eece037499d69
+  metadata.gz: 322718f1d3f37a5861fb5d9436dba95de176bdff6a560645b695371ca70029d5ca2dd320a5379b1b7513cf767bc9143b04c46ec668761667c7262707f91a3522
+  data.tar.gz: '03179b18866ef5ffa56291fef71046e5d3d869f48af530f2ab4d5169ecdd80b55a6d00bd947ad7dc870d66f2656dfd56e7bd86f6e28c749f3cc2c0a79a1f1275'

data/lib/mailkite.rb

@@ -15,7 +15,7 @@ require "base64"
 require "cgi"
 
 module Mailkite
-  VERSION = "0.5.0"
+  VERSION = "0.8.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
@@ -147,6 +147,7 @@ module Mailkite
       "GET" => Net::HTTP::Get,
       "POST" => Net::HTTP::Post,
       "PUT" => Net::HTTP::Put,
+      "PATCH" => Net::HTTP::Patch,
       "DELETE" => Net::HTTP::Delete,
     }.freeze
 
@@ -165,6 +166,27 @@ module Mailkite
         req.body = JSON.generate(body)
       end
 
+      perform(req, uri)
+    end
+
+    # Raw-binary request used by uploadAttachment for `bytes`/`path` uploads:
+    # the body is the file bytes themselves (not JSON, not multipart) and the
+    # Content-Type names the file's media type. Same auth + response parsing.
+    def request_binary(bytes, filename:, content_type:, retention_days: nil)
+      query = { "filename" => filename }
+      query["retentionDays"] = retention_days unless retention_days.nil?
+      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["Content-Type"] = content_type
+      req.body = bytes
+      perform(req, uri)
+    end
+
+    # Send a prepared Net::HTTP request and parse the JSON response (shared by
+    # `request` and `request_binary`).
+    def perform(req, uri)
       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
@@ -184,12 +206,73 @@ module Mailkite
       request("POST", "/v1/send", message)
     end
 
-    # Upload a file (base64 `content`) and get back a secure, time-limited URL to
-    # reference as a send() attachment ({ filename, url }) or link inline —
-    # instead of base64-inlining large files on every send. `file` keys:
-    # filename, content (base64), plus optional contentType and retentionDays.
+    # Extension → MIME map for raw-binary attachment uploads (default
+    # application/octet-stream when an extension is unknown).
+    ATTACHMENT_MIME = {
+      "pdf" => "application/pdf",
+      "png" => "image/png",
+      "jpg" => "image/jpeg",
+      "jpeg" => "image/jpeg",
+      "gif" => "image/gif",
+      "webp" => "image/webp",
+      "svg" => "image/svg+xml",
+      "csv" => "text/csv",
+      "txt" => "text/plain",
+      "html" => "text/html",
+      "json" => "application/json",
+      "zip" => "application/zip",
+      "doc" => "application/msword",
+      "docx" => "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+      "xls" => "application/vnd.ms-excel",
+      "xlsx" => "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+      "ics" => "text/calendar",
+      "ical" => "text/calendar",
+    }.freeze
+
+    # Upload a file and get back a secure, time-limited URL to reference as a
+    # send() attachment ({ filename, url }) or link inline — instead of
+    # base64-inlining large files on every send. Provide the file ONE of four
+    # ways via the `file` hash (priority order):
+    #   1. url            — MailKite fetches & re-hosts the remote file
+    #   2. bytes          — raw binary string, uploaded directly
+    #   3. path           — local file read off disk, then uploaded as bytes
+    #   4. content        — base64 string (the original behavior)
+    # Plus optional filename, contentType, and retentionDays.
     def uploadAttachment(file)
-      request("POST", "/v1/attachments", file)
+      url = file["url"] || file[:url]
+      bytes = file["bytes"] || file[:bytes]
+      path = file["path"] || file[:path]
+      content = file["content"] || file[:content]
+      filename = file["filename"] || file[:filename]
+      content_type = file["contentType"] || file[:contentType]
+      retention_days = file["retentionDays"] || file[:retentionDays]
+
+      if url
+        body = { "url" => url }
+        body["filename"] = filename unless filename.nil?
+        body["contentType"] = content_type unless content_type.nil?
+        body["retentionDays"] = retention_days unless retention_days.nil?
+        return request("POST", "/v1/attachments", body)
+      end
+
+      if bytes || path
+        if path
+          bytes = File.binread(path)
+          filename ||= File.basename(path)
+          content_type ||= ATTACHMENT_MIME[File.extname(path).downcase.delete_prefix(".")]
+        end
+        content_type ||= "application/octet-stream"
+        return request_binary(bytes, filename: filename, content_type: content_type, retention_days: retention_days)
+      end
+
+      if content
+        body = { "content" => content, "filename" => filename }
+        body["contentType"] = content_type unless content_type.nil?
+        body["retentionDays"] = retention_days unless retention_days.nil?
+        return request("POST", "/v1/attachments", body)
+      end
+
+      raise ArgumentError, "uploadAttachment requires one of: path, bytes, url, or content"
     end
 
     # Run an inbound message through an AI agent. message keys: text (required),
@@ -284,6 +367,71 @@ module Mailkite
       request("POST", "/api/deliveries/#{id}/retry")
     end
 
+    # --- Lists ----------------------------------------------------------
+    def listLists
+      request("GET", "/api/lists")
+    end
+
+    def createList(body)
+      request("POST", "/api/lists", body)
+    end
+
+    def getList(id)
+      request("GET", "/api/lists/#{id}")
+    end
+
+    def updateList(id, body)
+      request("PATCH", "/api/lists/#{id}", body)
+    end
+
+    def deleteList(id)
+      request("DELETE", "/api/lists/#{id}")
+    end
+
+    def listListContacts(id)
+      request("GET", "/api/lists/#{id}/contacts")
+    end
+
+    def addListContacts(id, body)
+      request("POST", "/api/lists/#{id}/contacts", body)
+    end
+
+    def removeListContact(id, contactId)
+      request("DELETE", "/api/lists/#{id}/contacts/#{contactId}")
+    end
+
+    # --- Broadcasts -----------------------------------------------------
+    def listBroadcasts
+      request("GET", "/api/broadcasts")
+    end
+
+    def createBroadcast(body)
+      request("POST", "/api/broadcasts", body)
+    end
+
+    def getBroadcast(id)
+      request("GET", "/api/broadcasts/#{id}")
+    end
+
+    def updateBroadcast(id, body)
+      request("PATCH", "/api/broadcasts/#{id}", body)
+    end
+
+    def deleteBroadcast(id)
+      request("DELETE", "/api/broadcasts/#{id}")
+    end
+
+    def sendBroadcast(id, body)
+      request("POST", "/api/broadcasts/#{id}/send", body)
+    end
+
+    # --- Docs -----------------------------------------------------------
+    # Semantic search over the MailKite docs. PUBLIC — no auth required.
+    # Returns { "query" => ..., "matches" => [...] }.
+    def semanticSearch(query)
+      request("GET", "/v1/docs/search?query=#{CGI.escape(query)}")
+    end
+
     # --- Webhooks -------------------------------------------------------
     # Instance wrapper around Mailkite.verify_webhook, so you can verify on an
     # existing client. No network call; no API key required.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mailkite
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.8.0
 platform: ruby
 authors:
 - MailKite
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-25 00:00:00.000000000 Z
+date: 2026-06-27 00:00:00.000000000 Z
 dependencies: []
 description: Send and manage email over your own authenticated domain with MailKite.
 email:
@@ -21,7 +21,7 @@ homepage: https://mailkite.dev/docs/libraries
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/mailkite/mailkite
+  source_code_uri: https://github.com/mailkite/mailkite-ruby
 post_install_message:
 rdoc_options: []
 require_paths: