openemail 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b529e237ea6cc98204574ecf5b0b0b58fb7e774cd18ed07ac265ec243885fe1c
-  data.tar.gz: 26844441518ca76d25b0908248924119c0528f56bf874b919c6f4a8dd1942e2d
+  metadata.gz: 4cff89372bfc6111e224def38735f3bdbffe7464c09604265592ee363f06d0e2
+  data.tar.gz: 217b4a0639e711d2ad12ba39d3ccbf1324d484089cc15479be886cf772373f02
 SHA512:
-  metadata.gz: b6236ffe92657e77e6478042d728023a16826bbc194b70178d7cdb809815ef577bae64b62d1ada664760ad4f0a3771a04a2b993254a43bccceb9db541680c9bd
-  data.tar.gz: 871936c1946ea670dd8728a4651295114be58d11328307ba9bc298eb9b6c556793cb8112d932fe3a0958eb429f0c38721cd7072cc35fb8e2cf7d0f36fc033f47
+  metadata.gz: bd52a785df4468aff82d1248a975144ebbb54031a22da26eee5666c971e821e7247c8b2079fe8fc7198726c5d9f24eb2b2255b432f060ef8429a277d7136f89d
+  data.tar.gz: 4c4ea067759e4cea3d00cbf5abc446e42f9af217ec7753d35909bb5dbe4e688a83c1e959b37f7c8a12e2377f09474ed800d8ab617210f1f71b6d08881b7e9a2c

data/lib/openemail/api_paths.rb

@@ -53,8 +53,15 @@ module OpenEmail
     CALENDAR_EVENT = "/calendar/events/:id"
     CALENDAR_EVENTS = "/calendar/events"
     CALENDAR_EVENT_CANCEL = "/calendar/events/:id/cancel"
+    CALENDAR_EVENT_DECLINE_PROPOSAL = "/calendar/events/:id/decline-proposal"
     CALENDAR_EVENT_ICS = "/calendar/events/:id/ics"
     CALENDAR_EVENT_RESPOND = "/calendar/events/:id/respond"
+    CALENDAR_FEED = "/calendar/feeds/:id"
+    CALENDAR_FEEDS = "/calendar/feeds"
+    CALENDAR_FEED_RESET = "/calendar/feeds/:id/reset"
+    CALENDAR_SUBSCRIPTION = "/calendar/subscriptions/:id"
+    CALENDAR_SUBSCRIPTIONS = "/calendar/subscriptions"
+    CALENDAR_SUBSCRIPTION_REFRESH = "/calendar/subscriptions/:id/refresh"
     CHAT = "/chats/:id"
     CHATS = "/chats"
     CONTACT = "/contacts/:email"
@@ -64,6 +71,8 @@ module OpenEmail
     CONTACT_ACTIVITY = "/contacts/:email/activity"
     CONTACT_AUDIENCES = "/contacts/:email/audiences"
     CONTACT_BLOCK = "/contacts/:email/block"
+    CONTACT_CARD = "/contacts/cards/:id"
+    CONTACT_CARDS = "/contacts/cards"
     CONTACT_PHOTO = "/contacts/:email/photo"
     CONTACT_THREADS = "/contacts/:email/threads"
     DNS_CONNECTION = "/dns-connections/:id"
@@ -72,10 +81,14 @@ module OpenEmail
     DOMAINS = "/domains"
     DOMAIN_ADDRESS = "/domains/:id/addresses/:addressId"
     DOMAIN_ADDRESSES = "/domains/:id/addresses"
+    DOMAIN_ADDRESS_APP_PASSWORD = "/domains/:id/addresses/:addressId/app-passwords/:passwordId"
+    DOMAIN_ADDRESS_APP_PASSWORDS = "/domains/:id/addresses/:addressId/app-passwords"
     DOMAIN_ADDRESS_FORWARD = "/domains/:id/addresses/:addressId/forwards/:forwardId"
     DOMAIN_ADDRESS_FORWARDS = "/domains/:id/addresses/:addressId/forwards"
     DOMAIN_ADDRESS_FORWARD_RESEND = "/domains/:id/addresses/:addressId/forwards/:forwardId/resend"
     DOMAIN_ADDRESS_LOGIN = "/domains/:id/addresses/:addressId/login"
+    DOMAIN_ADDRESS_MAIL_APPS = "/domains/:id/addresses/:addressId/mail-apps"
+    DOMAIN_ADDRESS_MAIL_APP_SETUP = "/domains/:id/addresses/:addressId/mail-app-setup"
     DOMAIN_ADDRESS_MEMBERS = "/domains/:id/addresses/:addressId/members"
     DOMAIN_ADDRESS_PHOTO = "/domains/:id/addresses/:addressId/photo"
     DOMAIN_DNS = "/domains/:id/dns"
@@ -139,6 +152,25 @@ module OpenEmail
     KEY_ROTATE = "/keys/:id/rotate"
     KEY_SELF = "/keys/self"
     KEY_SELF_ROTATE = "/keys/self/rotate"
+    KNOWLEDGE = "/knowledge"
+    KNOWLEDGE_CONNECTOR = "/knowledge/connectors/:id"
+    KNOWLEDGE_CONNECTORS = "/knowledge/connectors"
+    KNOWLEDGE_CONNECTOR_SYNC = "/knowledge/connectors/:id/sync"
+    KNOWLEDGE_DRAFTS = "/knowledge/drafts"
+    KNOWLEDGE_FILES = "/knowledge/files"
+    KNOWLEDGE_FLAGS = "/knowledge/flags"
+    KNOWLEDGE_FLAG_DISMISS = "/knowledge/flags/:id/dismiss"
+    KNOWLEDGE_ITEM = "/knowledge/:id"
+    KNOWLEDGE_ITEM_REFRESH = "/knowledge/:id/refresh"
+    KNOWLEDGE_LEVELS = "/knowledge/levels"
+    KNOWLEDGE_LINKS = "/knowledge/links"
+    KNOWLEDGE_NOTES = "/knowledge/notes"
+    KNOWLEDGE_SEARCH = "/knowledge/search"
+    KNOWLEDGE_STATS = "/knowledge/stats"
+    KNOWLEDGE_SUGGESTIONS = "/knowledge/suggestions"
+    KNOWLEDGE_SUGGESTION_ACCEPT = "/knowledge/suggestions/:id/accept"
+    KNOWLEDGE_SUGGESTION_DISMISS = "/knowledge/suggestions/:id/dismiss"
+    KNOWLEDGE_USAGE = "/knowledge/usage"
     LABEL = "/labels/:id"
     LABELS = "/labels"
     LABEL_COLORS = "/labels/colors"
@@ -216,6 +248,7 @@ module OpenEmail
     THREAD_NOTE = "/threads/:id/notes/:noteId"
     THREAD_NOTES = "/threads/:id/notes"
     THREAD_NOTES_REORDER = "/threads/:id/notes/reorder"
+    THREAD_REPLY_SUGGESTIONS = "/threads/:id/reply-suggestions"
     THREAD_RESTORE = "/threads/:id/restore"
     THREAD_SNOOZE = "/threads/:id/snooze"
     THREAD_SUMMARY = "/threads/:id/summary"
@@ -223,8 +256,10 @@ module OpenEmail
     THREAD_UNSNOOZE = "/threads/:id/unsnooze"
     THREAD_UNSUBSCRIBE = "/threads/:id/unsubscribe"
     TOOLS_BIMI = "/tools/bimi"
+    TOOLS_COST = "/tools/cost"
     TOOLS_DELIVERABILITY = "/tools/deliverability"
     TOOLS_DMARC = "/tools/dmarc"
+    TOOLS_VERIFICATION_CODE = "/tools/verification-code"
     TRACKED = "/tracking/:id"
     TRACKED_CLICKS = "/tracking/:id/clicks"
     TRACKED_OPENS = "/tracking/:id/opens"

data/lib/openemail/client.rb

@@ -32,6 +32,7 @@ module OpenEmail
       members: Resources::Members,
       suppressions: Resources::Suppressions,
       files: Resources::Files,
+      knowledge: Resources::Knowledge,
       temp_mail: Resources::TempMail,
       exports: Resources::Exports,
       chats: Resources::Chats,

data/lib/openemail/constants.rb

@@ -55,6 +55,8 @@ module OpenEmail
     KEYS_MANAGE: "keys:manage",
     FORMS_READ: "forms:read",
     FORMS_WRITE: "forms:write",
+    KNOWLEDGE_READ: "knowledge:read",
+    KNOWLEDGE_WRITE: "knowledge:write",
     BILLING_READ: "billing:read",
     BILLING_WRITE: "billing:write",
     ACCOUNT_READ: "account:read",
@@ -63,6 +65,8 @@ module OpenEmail
 
   APP_HOST_STATUSES = {NONE: "none", PENDING: "pending", ACTIVE: "active", FAILED: "failed"}.freeze
 
+  APP_PASSWORD_ORIGINS = {SETTINGS: "settings", SETUP_LINK: "setup-link", API: "api"}.freeze
+
   AUDIENCE_MEMBER_STATUSES = {SUBSCRIBED: "subscribed", UNSUBSCRIBED: "unsubscribed"}.freeze
 
   BILLING_ALERT_KINDS = {
@@ -168,10 +172,35 @@ module OpenEmail
     FAILED: "failed"
   }.freeze
 
+  CALENDAR_COLORS = {
+    BLUE: "blue",
+    SKY: "sky",
+    TEAL: "teal",
+    GREEN: "green",
+    LIME: "lime",
+    YELLOW: "yellow",
+    ORANGE: "orange",
+    RED: "red",
+    PINK: "pink",
+    PURPLE: "purple",
+    GRAY: "gray"
+  }.freeze
+
+  CALENDAR_FEED_MODES = {FULL: "full", BUSY: "busy"}.freeze
+
   CALENDAR_REMINDER_ACTIONS = {DISPLAY: "DISPLAY", EMAIL: "EMAIL", AUDIO: "AUDIO"}.freeze
 
   CALENDAR_RESPONSES = {ACCEPTED: "ACCEPTED", DECLINED: "DECLINED", TENTATIVE: "TENTATIVE"}.freeze
 
+  CALENDAR_SUBSCRIPTION_ERRORS = {
+    UNREACHABLE: "unreachable",
+    TOO_LARGE: "too-large",
+    NOT_A_CALENDAR: "not-a-calendar",
+    TOO_MANY_EVENTS: "too-many-events"
+  }.freeze
+
+  CALENDAR_SUBSCRIPTION_STATUSES = {ACTIVE: "active", FAILING: "failing", STOPPED: "stopped"}.freeze
+
   CALENDAR_TRANSPARENCIES = {OPAQUE: "OPAQUE", TRANSPARENT: "TRANSPARENT"}.freeze
 
   CALENDAR_VISIBILITIES = {PUBLIC: "PUBLIC", PRIVATE: "PRIVATE", CONFIDENTIAL: "CONFIDENTIAL"}.freeze
@@ -198,8 +227,20 @@ module OpenEmail
 
   CONTACT_BLOCK_LISTS = {BLOCKED_SENDERS: "blockedSenders", BLOCKED_DOMAINS: "blockedDomains"}.freeze
 
+  CONTACT_CARD_LABELS = {
+    HOME: "home",
+    WORK: "work",
+    MOBILE: "mobile",
+    MAIN: "main",
+    FAX: "fax",
+    PAGER: "pager",
+    OTHER: "other"
+  }.freeze
+
   CONTACT_PHOTO_TYPES = {PNG: "image/png", JPEG: "image/jpeg", WEBP: "image/webp", GIF: "image/gif"}.freeze
 
+  CONTACT_SOURCES = {MANUAL: "manual", AUTO: "auto", FORM: "form"}.freeze
+
   CONTACT_THREAD_SORTS = {NEWEST: "newest", OLDEST: "oldest", SENDER: "sender", SUBJECT: "subject"}.freeze
 
   CREDENTIAL_KINDS = {API_KEY: "apiKey", OAUTH: "oauth"}.freeze
@@ -365,6 +406,49 @@ module OpenEmail
 
   FORM_WIDTHS = {NARROW: "narrow", NORMAL: "normal", WIDE: "wide"}.freeze
 
+  IMPORT_FORMATS = {
+    GMAIL: "gmail",
+    OPENEMAIL: "openemail",
+    THUNDERBIRD: "thunderbird",
+    PROTON: "proton",
+    MBOX: "mbox",
+    EML: "eml"
+  }.freeze
+
+  KNOWLEDGE_CONNECTOR_KINDS = {SITE: "site", SITEMAP: "sitemap", FEED: "feed", ZENDESK: "zendesk"}.freeze
+
+  KNOWLEDGE_CONNECTOR_STATUSES = {QUEUED: "queued", SYNCING: "syncing", READY: "ready", FAILED: "failed"}.freeze
+
+  KNOWLEDGE_FAILURES = {
+    UNSUPPORTED: "unsupported",
+    EMPTY: "empty",
+    TOO_LARGE: "too_large",
+    FETCH_FAILED: "fetch_failed",
+    BLOCKED_URL: "blocked_url",
+    CONVERSION_FAILED: "conversion_failed",
+    INDEX_FAILED: "index_failed",
+    OVER_ALLOWANCE: "over_allowance",
+    MISSING_FILE: "missing_file"
+  }.freeze
+
+  KNOWLEDGE_FLAG_KINDS = {DUPLICATE: "duplicate", CONFLICT: "conflict"}.freeze
+
+  KNOWLEDGE_FLAG_STATUSES = {OPEN: "open", DISMISSED: "dismissed"}.freeze
+
+  KNOWLEDGE_KINDS = {NOTE: "note", FILE: "file", LINK: "link"}.freeze
+
+  KNOWLEDGE_LEVELS = {WORKSPACE: "workspace", DOMAIN: "domain", ADDRESS: "address"}.freeze
+
+  KNOWLEDGE_ORIGINS = {APP: "app", API: "api", ASSISTANT: "assistant", MCP: "mcp"}.freeze
+
+  KNOWLEDGE_REFRESH_DAY_CHOICES = {DAY: 1, WEEK: 7, MONTH: 30}.freeze
+
+  KNOWLEDGE_STATUSES = {QUEUED: "queued", PROCESSING: "processing", READY: "ready", FAILED: "failed"}.freeze
+
+  KNOWLEDGE_SUGGESTION_KINDS = {LEARNED: "learned", QUESTION: "question"}.freeze
+
+  KNOWLEDGE_SUGGESTION_STATUSES = {PENDING: "pending", ACCEPTED: "accepted", DISMISSED: "dismissed"}.freeze
+
   LANGUAGES = [
     {code: "en", label: "English", native: "English", flag: "🇬🇧", rtl: false}.freeze,
     {code: "es", label: "Spanish", native: "Español", flag: "🇪🇸", rtl: false}.freeze,
@@ -652,6 +736,30 @@ module OpenEmail
 
   LOGIN_LOGOS = {DARK: "dark", LIGHT: "light"}.freeze
 
+  MAIL_APP_PROTOCOLS = {IMAP: "imap", SMTP: "smtp", POP3: "pop3", CALDAV: "caldav", CARDDAV: "carddav"}.freeze
+
+  MAIL_APP_SECURITIES = {SSL_TLS: "ssl-tls"}.freeze
+
+  MAIL_SERVICES = {
+    OPENEMAIL: "openemail",
+    GMAIL: "gmail",
+    OUTLOOK: "outlook",
+    ICLOUD: "icloud",
+    YAHOO: "yahoo",
+    PROTON: "proton",
+    ZOHO: "zoho",
+    FASTMAIL: "fastmail",
+    RESEND: "resend",
+    SENDGRID: "sendgrid",
+    MAILGUN: "mailgun",
+    POSTMARK: "postmark",
+    MAILCHIMP: "mailchimp",
+    BREVO: "brevo",
+    SPARKPOST: "sparkpost",
+    HUBSPOT: "hubspot",
+    AMAZON_SES: "amazon-ses"
+  }.freeze
+
   MESSAGE_ENCRYPTION_FORMATS = {
     PGP_MIME: "pgp-mime",
     PGP_SIGNED: "pgp-signed",
@@ -668,10 +776,20 @@ module OpenEmail
 
   PEOPLE_SORTS = {RECENT: "recent", NAME: "name", THREADS: "threads"}.freeze
 
+  PLAN_BLOCKERS = {DOMAINS: "domains", PEOPLE: "people", SENDS: "sends"}.freeze
+
   PLAN_IDS = {FREE: "free", STARTER: "starter", BUSINESS: "business", ENTERPRISE: "enterprise"}.freeze
 
   PROVIDER_IMPORT_DOMAIN_STATES = {ABSENT: "absent", ADDED: "added", VERIFIED: "verified"}.freeze
 
+  PROVIDER_IMPORT_PROVIDERS = {
+    RESEND: "resend",
+    SENDGRID: "sendgrid",
+    POSTMARK: "postmark",
+    MAILGUN: "mailgun",
+    MAILCHIMP: "mailchimp"
+  }.freeze
+
   PROVIDER_IMPORT_RESOURCES = {
     SUPPRESSIONS: "suppressions",
     AUDIENCES: "audiences",
@@ -690,6 +808,8 @@ module OpenEmail
     CANCELLED: "cancelled"
   }.freeze
 
+  REPLY_SUGGESTION_STATES = {READY: "ready", PENDING: "pending", NONE: "none"}.freeze
+
   REWRITE_ACTIONS = {
     SHORTEN: "shorten",
     LENGTHEN: "lengthen",
@@ -749,6 +869,16 @@ module OpenEmail
     LT: "lt"
   }.freeze
 
+  SETTINGS_COLOR_THEMES = {LIGHT: "light", DARK: "dark", SYSTEM: "system"}.freeze
+
+  SETTINGS_DATE_FORMATS = {DMY: "dmy", MDY: "mdy", YMD: "ymd"}.freeze
+
+  SETTINGS_IMAGE_COMPRESSIONS = {LOW: "low", MEDIUM: "medium", ORIGINAL: "original"}.freeze
+
+  SETTINGS_TIME_FORMATS = {H12: "12h", H24: "24h"}.freeze
+
+  SETTINGS_WEEK_STARTS = {MONDAY: "monday", SUNDAY: "sunday"}.freeze
+
   STEP_UP_ERROR_CODES = {
     STEP_UP_REQUIRED: "step_up_required",
     STEP_UP_NOT_APPLICABLE: "step_up_not_applicable",

data/lib/openemail/protocol.rb

@@ -123,10 +123,12 @@ module OpenEmail
       BROADCAST_ID: "broadcastId",
       BROADCAST_IDS: "broadcastIds",
       EMAIL: "email",
+      WITHOUT_EMAIL: "withoutEmail",
       BLOCKED: "blocked",
       DATE_FROM: "dateFrom",
       DATE_TO: "dateTo",
       FROM_CONTACTS: "fromContacts",
+      SEMANTIC: "semantic",
       REASON: "reason",
       KIND: "kind",
       ENDPOINT_IDS: "endpointIds",
@@ -142,7 +144,17 @@ module OpenEmail
       OFFSET: "offset",
       REFRESH: "refresh",
       CONFIRM: "confirm",
-      USERNAME: "username"
+      USERNAME: "username",
+      SCOPE: "scope",
+      LEVEL: "level",
+      PINNED: "pinned",
+      TITLE: "title",
+      ITEM_ID: "itemId",
+      SENDS: "sends",
+      DOMAINS: "domains",
+      PEOPLE: "people",
+      AI_ACTIONS: "aiActions",
+      INTERVAL: "interval"
     }.freeze
 
     RETRY = {

data/lib/openemail/resource.rb

@@ -66,5 +66,19 @@ module OpenEmail
     def raw_content_type(data, content_type)
       RawBody.content_type(data, content_type)
     end
+
+    def upload_name(data, filename)
+      name = (filename.nil? ? RawBody.file_name(data) : filename).to_s.strip
+      raise ArgumentError, Defaults::MESSAGES[:FILENAME_REQUIRED] if name.empty?
+
+      name
+    end
+
+    def upload_timeout(timeout)
+      return timeout unless timeout.nil?
+
+      base = @transport.timeout
+      base.to_f.positive? ? [base, Defaults::UPLOAD_TIMEOUT].max : base
+    end
   end
 end

data/lib/openemail/resources/calendar.rb

@@ -40,7 +40,47 @@ module OpenEmail
       end
 
       def respond_to_event(id, body = nil, api_key: nil, **fields)
-        request(fill(ApiPaths::CALENDAR_EVENT_RESPOND, id:), method: :post, body: payload(body, fields), api_key:)
+        request(fill(ApiPaths::CALENDAR_EVENT_RESPOND, id:), method: :post, body: answer_wire(payload(body, fields)), api_key:)
+      end
+
+      def decline_proposal(id, body = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::CALENDAR_EVENT_DECLINE_PROPOSAL, id:), method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def list_feeds(api_key: nil)
+        fetch_list(ApiPaths::CALENDAR_FEEDS, api_key:)
+      end
+
+      def create_feed(body = nil, api_key: nil, **fields)
+        request(ApiPaths::CALENDAR_FEEDS, method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def reset_feed(id, api_key: nil)
+        request(fill(ApiPaths::CALENDAR_FEED_RESET, id:), method: :post, api_key:)
+      end
+
+      def delete_feed(id, api_key: nil)
+        request(fill(ApiPaths::CALENDAR_FEED, id:), method: :delete, api_key:)
+      end
+
+      def list_subscriptions(api_key: nil)
+        fetch_list(ApiPaths::CALENDAR_SUBSCRIPTIONS, api_key:)
+      end
+
+      def create_subscription(body = nil, api_key: nil, **fields)
+        request(ApiPaths::CALENDAR_SUBSCRIPTIONS, method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def update_subscription(id, patch = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::CALENDAR_SUBSCRIPTION, id:), method: :patch, body: payload(patch, fields), api_key:)
+      end
+
+      def refresh_subscription(id, api_key: nil)
+        request(fill(ApiPaths::CALENDAR_SUBSCRIPTION_REFRESH, id:), method: :post, api_key:)
+      end
+
+      def delete_subscription(id, api_key: nil)
+        request(fill(ApiPaths::CALENDAR_SUBSCRIPTION, id:), method: :delete, api_key:)
       end
 
       private
@@ -54,6 +94,12 @@ module OpenEmail
         wire["end"] = instant(wire["end"]) if wire.key?("end")
         wire
       end
+
+      def answer_wire(wire)
+        wire["proposedStart"] = instant(wire["proposedStart"]) if wire.key?("proposedStart")
+        wire["proposedEnd"] = instant(wire["proposedEnd"]) if wire.key?("proposedEnd")
+        wire
+      end
     end
   end
 end

data/lib/openemail/resources/contacts.rb

@@ -101,11 +101,44 @@ module OpenEmail
           api_key:)
       end
 
+      def list_cards(email: nil, without_email: nil, limit: nil, cursor: nil, api_key: nil)
+        fetch_page(ApiPaths::CONTACT_CARDS, card_query(email, without_email), limit:, cursor:, api_key:)
+      end
+
+      def list_all_cards(email: nil, without_email: nil, limit: nil, cursor: nil, api_key: nil)
+        collect_all(ApiPaths::CONTACT_CARDS, card_query(email, without_email), limit:, cursor:, api_key:)
+      end
+
+      def iterate_cards(email: nil, without_email: nil, limit: nil, cursor: nil, api_key: nil, &)
+        iterate_pages(ApiPaths::CONTACT_CARDS, card_query(email, without_email), limit:, cursor:, api_key:, &)
+      end
+
+      def get_card(id, api_key: nil)
+        request(fill(ApiPaths::CONTACT_CARD, id:), api_key:)
+      end
+
+      def create_card(body = nil, api_key: nil, **fields)
+        request(ApiPaths::CONTACT_CARDS, method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def update_card(id, patch = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::CONTACT_CARD, id:), method: :patch, body: payload(patch, fields), repeatable: true,
+          api_key:)
+      end
+
+      def delete_card(id, api_key: nil)
+        request(fill(ApiPaths::CONTACT_CARD, id:), method: :delete, api_key:)
+      end
+
       private
 
       def people_query(q, email, sort, blocked)
         query_params(q:, email:, sort:, blocked: flag(blocked))
       end
+
+      def card_query(email, without_email)
+        query_params(email:, without_email: flag(without_email))
+      end
     end
   end
 end

data/lib/openemail/resources/domains.rb

@@ -137,6 +137,39 @@ module OpenEmail
         request(fill(ApiPaths::DOMAIN_ADDRESS_LOGIN, id:, addressId: address_id), method: :delete, api_key:)
       end
 
+      def get_mail_app_settings(id, address_id, api_key: nil)
+        request(fill(ApiPaths::DOMAIN_ADDRESS_MAIL_APPS, id:, addressId: address_id), api_key:)
+      end
+
+      def update_mail_app_settings(id, address_id, patch = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::DOMAIN_ADDRESS_MAIL_APPS, id:, addressId: address_id), method: :patch,
+          body: payload(patch, fields), repeatable: true, api_key:)
+      end
+
+      def list_app_passwords(id, address_id, api_key: nil)
+        request(fill(ApiPaths::DOMAIN_ADDRESS_APP_PASSWORDS, id:, addressId: address_id), api_key:)
+      end
+
+      def create_app_password(id, address_id, body = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::DOMAIN_ADDRESS_APP_PASSWORDS, id:, addressId: address_id), method: :post,
+          body: payload(body, fields), api_key:)
+      end
+
+      def update_app_password(id, address_id, password_id, patch = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::DOMAIN_ADDRESS_APP_PASSWORD, id:, addressId: address_id, passwordId: password_id),
+          method: :patch, body: payload(patch, fields), repeatable: true, api_key:)
+      end
+
+      def delete_app_password(id, address_id, password_id, api_key: nil)
+        request(fill(ApiPaths::DOMAIN_ADDRESS_APP_PASSWORD, id:, addressId: address_id, passwordId: password_id),
+          method: :delete, api_key:)
+      end
+
+      def send_mail_app_setup(id, address_id, body = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::DOMAIN_ADDRESS_MAIL_APP_SETUP, id:, addressId: address_id), method: :post,
+          body: payload(body, fields), api_key:)
+      end
+
       def get_dns(id, refresh: nil, api_key: nil)
         request(fill(ApiPaths::DOMAIN_DNS, id:), query: query_params(refresh:), api_key:)
       end

data/lib/openemail/resources/files.rb

@@ -76,20 +76,6 @@ module OpenEmail
       def list_query(q, kind, direction, address, since, until_value, sort)
         query_params(q:, kind:, direction:, address:, since: instant(since), until: instant(until_value), sort:)
       end
-
-      def upload_name(data, filename)
-        name = (filename.nil? ? RawBody.file_name(data) : filename).to_s.strip
-        raise ArgumentError, Defaults::MESSAGES[:FILENAME_REQUIRED] if name.empty?
-
-        name
-      end
-
-      def upload_timeout(timeout)
-        return timeout unless timeout.nil?
-
-        base = @transport.timeout
-        base.to_f.positive? ? [base, Defaults::UPLOAD_TIMEOUT].max : base
-      end
     end
   end
 end

data/lib/openemail/resources/knowledge.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+module OpenEmail
+  module Resources
+    class Knowledge < Resource
+      def list(scope: nil, level: nil, kind: nil, status: nil, pinned: nil, q: nil, limit: nil, cursor: nil,
+        api_key: nil)
+        fetch_page(ApiPaths::KNOWLEDGE, list_query(scope, level, kind, status, pinned, q), limit:, cursor:, api_key:)
+      end
+
+      def list_all(scope: nil, level: nil, kind: nil, status: nil, pinned: nil, q: nil, limit: nil, cursor: nil,
+        api_key: nil)
+        collect_all(ApiPaths::KNOWLEDGE, list_query(scope, level, kind, status, pinned, q), limit:, cursor:, api_key:)
+      end
+
+      def iterate(scope: nil, level: nil, kind: nil, status: nil, pinned: nil, q: nil, limit: nil, cursor: nil,
+        api_key: nil, &)
+        iterate_pages(ApiPaths::KNOWLEDGE, list_query(scope, level, kind, status, pinned, q), limit:, cursor:,
+          api_key:, &)
+      end
+
+      def levels(api_key: nil)
+        fetch_list(ApiPaths::KNOWLEDGE_LEVELS, api_key:)
+      end
+
+      def usage(api_key: nil)
+        request(ApiPaths::KNOWLEDGE_USAGE, api_key:)
+      end
+
+      def search(body = nil, api_key: nil, **fields)
+        request(ApiPaths::KNOWLEDGE_SEARCH, method: :post, body: payload(body, fields), repeatable: true, api_key:)
+      end
+
+      def create_note(body = nil, api_key: nil, **fields)
+        request(ApiPaths::KNOWLEDGE_NOTES, method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def add_link(body = nil, api_key: nil, **fields)
+        request(ApiPaths::KNOWLEDGE_LINKS, method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def upload_file(data, filename: nil, content_type: nil, scope: nil, title: nil, timeout: nil, api_key: nil)
+        query = query_params(filename: upload_name(data, filename), scope:, title:)
+        request(ApiPaths::KNOWLEDGE_FILES, method: :post, query:, raw: data,
+          content_type: raw_content_type(data, content_type), timeout: upload_timeout(timeout), api_key:)
+      end
+
+      def get(id, api_key: nil)
+        request(fill(ApiPaths::KNOWLEDGE_ITEM, id:), api_key:)
+      end
+
+      def update(id, patch = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::KNOWLEDGE_ITEM, id:), method: :patch, body: payload(patch, fields), repeatable: true,
+          api_key:)
+      end
+
+      def delete(id, api_key: nil)
+        request(fill(ApiPaths::KNOWLEDGE_ITEM, id:), method: :delete, api_key:)
+      end
+
+      def refresh(id, api_key: nil)
+        request(fill(ApiPaths::KNOWLEDGE_ITEM_REFRESH, id:), method: :post, repeatable: true, api_key:)
+      end
+
+      def stats(days: nil, api_key: nil)
+        request(ApiPaths::KNOWLEDGE_STATS, query: query_params(days:), api_key:)
+      end
+
+      def list_suggestions(kind: nil, status: nil, limit: nil, cursor: nil, api_key: nil)
+        fetch_page(ApiPaths::KNOWLEDGE_SUGGESTIONS, suggestion_query(kind, status), limit:, cursor:, api_key:)
+      end
+
+      def list_all_suggestions(kind: nil, status: nil, limit: nil, cursor: nil, api_key: nil)
+        collect_all(ApiPaths::KNOWLEDGE_SUGGESTIONS, suggestion_query(kind, status), limit:, cursor:, api_key:)
+      end
+
+      def iterate_suggestions(kind: nil, status: nil, limit: nil, cursor: nil, api_key: nil, &)
+        iterate_pages(ApiPaths::KNOWLEDGE_SUGGESTIONS, suggestion_query(kind, status), limit:, cursor:, api_key:, &)
+      end
+
+      def accept_suggestion(id, body = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::KNOWLEDGE_SUGGESTION_ACCEPT, id:), method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def dismiss_suggestion(id, api_key: nil)
+        request(fill(ApiPaths::KNOWLEDGE_SUGGESTION_DISMISS, id:), method: :post, api_key:)
+      end
+
+      def list_flags(item_id: nil, limit: nil, api_key: nil)
+        fetch_list(ApiPaths::KNOWLEDGE_FLAGS, query_params(item_id:, limit:), api_key:)
+      end
+
+      def dismiss_flag(id, api_key: nil)
+        request(fill(ApiPaths::KNOWLEDGE_FLAG_DISMISS, id:), method: :post, repeatable: true, api_key:)
+      end
+
+      def list_connectors(api_key: nil)
+        fetch_list(ApiPaths::KNOWLEDGE_CONNECTORS, api_key:)
+      end
+
+      def add_connector(body = nil, api_key: nil, **fields)
+        request(ApiPaths::KNOWLEDGE_CONNECTORS, method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def get_connector(id, api_key: nil)
+        request(fill(ApiPaths::KNOWLEDGE_CONNECTOR, id:), api_key:)
+      end
+
+      def update_connector(id, patch = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::KNOWLEDGE_CONNECTOR, id:), method: :patch, body: payload(patch, fields), repeatable: true,
+          api_key:)
+      end
+
+      def delete_connector(id, api_key: nil)
+        request(fill(ApiPaths::KNOWLEDGE_CONNECTOR, id:), method: :delete, api_key:)
+      end
+
+      def sync_connector(id, api_key: nil)
+        request(fill(ApiPaths::KNOWLEDGE_CONNECTOR_SYNC, id:), method: :post, repeatable: true, api_key:)
+      end
+
+      def draft_from_thread(body = nil, api_key: nil, **fields)
+        request(ApiPaths::KNOWLEDGE_DRAFTS, method: :post, body: payload(body, fields), api_key:)
+      end
+
+      private
+
+      def list_query(scope, level, kind, status, pinned, q)
+        query_params(scope:, level:, kind:, status:, pinned: flag(pinned), q:)
+      end
+
+      def suggestion_query(kind, status)
+        query_params(kind:, status:)
+      end
+    end
+  end
+end

data/lib/openemail/resources/provider_imports.rb

@@ -6,10 +6,12 @@ module OpenEmail
       NOT_GIVEN = Object.new.freeze
       private_constant :NOT_GIVEN
 
-      def inspect(provider_key = NOT_GIVEN, api_key: nil)
+      def inspect(provider_key = NOT_GIVEN, provider: nil, api_key: nil)
         return super() if provider_key.equal?(NOT_GIVEN)
 
-        request(ApiPaths::PROVIDER_IMPORTS_INSPECT, method: :post, body: {"apiKey" => provider_key}, api_key:)
+        body = {"apiKey" => provider_key}
+        body["provider"] = provider unless provider.nil?
+        request(ApiPaths::PROVIDER_IMPORTS_INSPECT, method: :post, body:, api_key:)
       end
 
       def create(body = nil, api_key: nil, **fields)

data/lib/openemail/resources/templates.rb

@@ -81,8 +81,9 @@ module OpenEmail
           body: payload(body, fields), api_key:)
       end
 
-      def publish(id_or_slug, api_key: nil)
-        request(fill(ApiPaths::TEMPLATE_VERSIONS, id: id_or_slug), method: :post, repeatable: true, api_key:)
+      def publish(id_or_slug, expected_version: nil, api_key: nil)
+        request(fill(ApiPaths::TEMPLATE_VERSIONS, id: id_or_slug), method: :post,
+          body: expected_version.nil? ? nil : {"expectedVersion" => expected_version}, repeatable: true, api_key:)
       end
 
       def preview(id_or_slug, body = nil, api_key: nil, **fields)

data/lib/openemail/resources/threads.rb

@@ -4,20 +4,23 @@ module OpenEmail
   module Resources
     class Threads < Resource
       def list(folder: nil, query: nil, label_ids: nil, sort: nil, date_from: nil, date_to: nil, from_contacts: nil,
-        limit: nil, cursor: nil, api_key: nil)
-        fetch_page(ApiPaths::THREADS, list_query(folder, query, label_ids, sort, date_from, date_to, from_contacts),
+        semantic: nil, address: nil, limit: nil, cursor: nil, api_key: nil)
+        fetch_page(ApiPaths::THREADS,
+          list_query(folder, query, label_ids, sort, date_from, date_to, from_contacts, semantic, address),
           style: PAGE_TOKEN, limit:, cursor:, api_key:)
       end
 
       def list_all(folder: nil, query: nil, label_ids: nil, sort: nil, date_from: nil, date_to: nil,
-        from_contacts: nil, limit: nil, cursor: nil, api_key: nil)
-        collect_all(ApiPaths::THREADS, list_query(folder, query, label_ids, sort, date_from, date_to, from_contacts),
+        from_contacts: nil, semantic: nil, address: nil, limit: nil, cursor: nil, api_key: nil)
+        collect_all(ApiPaths::THREADS,
+          list_query(folder, query, label_ids, sort, date_from, date_to, from_contacts, semantic, address),
           style: PAGE_TOKEN, limit:, cursor:, api_key:)
       end
 
       def iterate(folder: nil, query: nil, label_ids: nil, sort: nil, date_from: nil, date_to: nil, from_contacts: nil,
-        limit: nil, cursor: nil, api_key: nil, &)
-        iterate_pages(ApiPaths::THREADS, list_query(folder, query, label_ids, sort, date_from, date_to, from_contacts),
+        semantic: nil, address: nil, limit: nil, cursor: nil, api_key: nil, &)
+        iterate_pages(ApiPaths::THREADS,
+          list_query(folder, query, label_ids, sort, date_from, date_to, from_contacts, semantic, address),
           style: PAGE_TOKEN, limit:, cursor:, api_key:, &)
       end
 
@@ -81,6 +84,10 @@ module OpenEmail
         request(fill(ApiPaths::THREAD_SUMMARY, id:), api_key:)
       end
 
+      def reply_suggestions(id, api_key: nil)
+        request(fill(ApiPaths::THREAD_REPLY_SUGGESTIONS, id:), api_key:)
+      end
+
       def restore(id, api_key: nil)
         request(fill(ApiPaths::THREAD_RESTORE, id:), method: :post, repeatable: true, api_key:)
       end
@@ -95,9 +102,9 @@ module OpenEmail
 
       private
 
-      def list_query(folder, query, label_ids, sort, date_from, date_to, from_contacts)
+      def list_query(folder, query, label_ids, sort, date_from, date_to, from_contacts, semantic, address)
         query_params(folder:, query:, label_ids: joined(label_ids), sort:, date_from: instant(date_from),
-          date_to: instant(date_to), from_contacts: flag(from_contacts))
+          date_to: instant(date_to), from_contacts: flag(from_contacts), semantic: flag(semantic), address:)
       end
     end
   end

data/lib/openemail/resources/tools.rb

@@ -14,6 +14,14 @@ module OpenEmail
       def check_deliverability(domain, api_key: nil)
         request(ApiPaths::TOOLS_DELIVERABILITY, query: query_params(domain:), api_key:)
       end
+
+      def read_verification_code(body = nil, api_key: nil, **fields)
+        request(ApiPaths::TOOLS_VERIFICATION_CODE, method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def estimate_cost(sends: nil, domains: nil, people: nil, ai_actions: nil, interval: nil, api_key: nil)
+        request(ApiPaths::TOOLS_COST, query: query_params(sends:, domains:, people:, ai_actions:, interval:), api_key:)
+      end
     end
   end
 end

data/lib/openemail/resources/tracking.rb

@@ -3,22 +3,27 @@
 module OpenEmail
   module Resources
     class Tracking < Resource
-      def list(opened: nil, clicked: nil, days: nil, minutes: nil, grain: nil, limit: nil, cursor: nil, api_key: nil)
-        fetch_page(ApiPaths::TRACKING, list_query(opened, clicked, days, minutes, grain), limit:, cursor:, api_key:)
+      def list(opened: nil, clicked: nil, days: nil, minutes: nil, grain: nil, address: nil, limit: nil, cursor: nil,
+        api_key: nil)
+        fetch_page(ApiPaths::TRACKING, list_query(opened, clicked, days, minutes, grain, address), limit:, cursor:,
+          api_key:)
       end
 
-      def list_all(opened: nil, clicked: nil, days: nil, minutes: nil, grain: nil, limit: nil, cursor: nil,
-        api_key: nil)
-        collect_all(ApiPaths::TRACKING, list_query(opened, clicked, days, minutes, grain), limit:, cursor:, api_key:)
+      def list_all(opened: nil, clicked: nil, days: nil, minutes: nil, grain: nil, address: nil, limit: nil,
+        cursor: nil, api_key: nil)
+        collect_all(ApiPaths::TRACKING, list_query(opened, clicked, days, minutes, grain, address), limit:, cursor:,
+          api_key:)
       end
 
-      def iterate(opened: nil, clicked: nil, days: nil, minutes: nil, grain: nil, limit: nil, cursor: nil,
-        api_key: nil, &)
-        iterate_pages(ApiPaths::TRACKING, list_query(opened, clicked, days, minutes, grain), limit:, cursor:, api_key:, &)
+      def iterate(opened: nil, clicked: nil, days: nil, minutes: nil, grain: nil, address: nil, limit: nil,
+        cursor: nil, api_key: nil, &)
+        iterate_pages(ApiPaths::TRACKING, list_query(opened, clicked, days, minutes, grain, address), limit:, cursor:,
+          api_key:, &)
       end
 
-      def get_stats(days: nil, minutes: nil, grain: nil, offset_minutes: nil, api_key: nil)
-        request(ApiPaths::TRACKING_STATS, query: query_params(days:, minutes:, grain:, offset_minutes:), api_key:)
+      def get_stats(days: nil, minutes: nil, grain: nil, offset_minutes: nil, address: nil, api_key: nil)
+        request(ApiPaths::TRACKING_STATS, query: query_params(days:, minutes:, grain:, offset_minutes:, address:),
+          api_key:)
       end
 
       def get(id, api_key: nil)
@@ -51,8 +56,8 @@ module OpenEmail
 
       private
 
-      def list_query(opened, clicked, days, minutes, grain)
-        query_params(opened: flag(opened), clicked: flag(clicked), days:, minutes:, grain:)
+      def list_query(opened, clicked, days, minutes, grain, address)
+        query_params(opened: flag(opened), clicked: flag(clicked), days:, minutes:, grain:, address:)
       end
 
       def hit_query(include_machine)

data/lib/openemail/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenEmail
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: openemail
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - OpenEmail
 bindir: bin
 cert_chain: []
-date: 2026-10-04 00:00:00.000000000 Z
+date: 2026-10-10 00:00:00.000000000 Z
 dependencies: []
 description: Send email and broadcasts, work with threads, drafts, labels, templates,
   rules, webhooks, tracking, contacts, audiences, sign-up forms, domains, suppressions,
@@ -54,6 +54,7 @@ files:
 - lib/openemail/resources/forms.rb
 - lib/openemail/resources/imports.rb
 - lib/openemail/resources/keys.rb
+- lib/openemail/resources/knowledge.rb
 - lib/openemail/resources/labels.rb
 - lib/openemail/resources/languages.rb
 - lib/openemail/resources/me.rb