mailkite 0.18.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4b8b0706aa98435dc195e58ee8c548e762e5fff84819432b96741de752ef32a
-  data.tar.gz: b5ab6561c1750cd702b7f4e545001bd25d8a0c75996a930eae70b691e2500bc4
+  metadata.gz: aa6c0fe1916c302b913ce3ec7d39ca3b9e78633791fdfaf0d372306bc71bc134
+  data.tar.gz: 7795b6f4b60abcaadd6de5167a1326c1b0c5e5d8eb510ab4aeb141220c499459
 SHA512:
-  metadata.gz: 6c599c0cc4f9efc6c94e5701d7adca5b508bf6fb94a7cc6c2747ad5c23649c362014664acaa402de2086af7507e757c686959681fdc3ce147f136cdfe515af34
-  data.tar.gz: 79b945cbac587203ea1c2a9613a9eb76ef98bfc357572ed2767c861c880ffbb341753f58aab10abda130aa65923928d403cbc62a7840c5a8c1ea115b1c7e0360
+  metadata.gz: 836d902177a964a2094203c597a857222cef22f6f6d51eefd0ab5ddff1baecd636c5a4fb310aa1c658f84e128c2f9e99ef52b1f963f4d3d5f8d6c825f8f46b92
+  data.tar.gz: 438ec7af44244d1cffd79b609dddffcc11cbe9655dc3796a690ac7997d10fe8fc5c229a073dbbcb34cae2ec17640f367ed1659196d4fb3d0ded23e43f2a70015

data/lib/mailkite.rb

@@ -15,7 +15,7 @@ require "base64"
 require "cgi"
 
 module Mailkite
-  VERSION = "0.18.0"
+  VERSION = "0.19.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
@@ -540,6 +540,49 @@ module Mailkite
       request("DELETE", "/api/keys/scoped/#{id}")
     end
 
+    # List the account's app passwords. Each one opens a mailbox over IMAP
+    # and/or the mailbox API, scoped to a domain and an address pattern
+    # within it.
+    def listAppPasswords
+      request("GET", "/api/app-passwords")
+    end
+
+    # Create an app password for one domain and address pattern. +body+ is a
+    # hash with "domain" (required) plus optional "address" (default "*"),
+    # "protocols" (default ["imap"]) and "label". The secret is returned once
+    # and never again.
+    def createAppPassword(body)
+      request("POST", "/api/app-passwords", body)
+    end
+
+    # Revoke an app password. Takes effect immediately — any IMAP session or
+    # API call using it stops authenticating.
+    def deleteAppPassword(id)
+      request("DELETE", "/api/app-passwords/#{id}")
+    end
+
+    # List a mailbox's messages, newest first. Authenticated with an app
+    # password granting "api" — this is how an agent reads its own inbox
+    # without an IMAP client. +params+ may carry :limit and :before.
+    def listMailboxMessages(address, params = {})
+      q = URI.encode_www_form({ "address" => address }.merge(params))
+      request("GET", "/api/mailbox/messages?#{q}")
+    end
+
+    # Fetch one message's raw RFC822 bytes from a mailbox. Same app password
+    # auth as the list.
+    def getMailboxMessageRaw(uid, address)
+      q = URI.encode_www_form("address" => address)
+      request("GET", "/api/mailbox/messages/#{uid}/raw?#{q}")
+    end
+
+    # Replace a message's IMAP flags (e.g. mark it "Seen"). Flags set here are
+    # the same ones an IMAP client sees.
+    def setMailboxMessageFlags(uid, address, flags)
+      q = URI.encode_www_form("address" => address)
+      request("POST", "/api/mailbox/messages/#{uid}/flags?#{q}", { "flags" => flags })
+    end
+
     # Current billing-period usage: emails used vs the plan's included bucket
     # (null = unlimited), AI actions, and the overage state that gates
     # sending. Powers quota meters in dashboards and integrations.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mailkite
 version: !ruby/object:Gem::Version
-  version: 0.18.0
+  version: 0.19.0
 platform: ruby
 authors:
 - MailKite
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-02 00:00:00.000000000 Z
+date: 2026-08-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mail