openemail 0.0.1 → 0.0.3

data/lib/openemail/constants.rb

@@ -1,6 +1,27 @@
 # frozen_string_literal: true
 
 module OpenEmail
+  ADDRESS_CHECK_REASONS = {
+    INVALID_SYNTAX: "invalid_syntax",
+    DOMAIN_NOT_FOUND: "domain_not_found",
+    NO_MAIL_SERVER: "no_mail_server",
+    NULL_MX: "null_mx",
+    NO_MX_RECORD: "no_mx_record",
+    DNS_UNREACHABLE: "dns_unreachable",
+    DISPOSABLE: "disposable",
+    ROLE_ADDRESS: "role_address",
+    TYPO_SUSPECTED: "typo_suspected",
+    SUPPRESSED: "suppressed",
+    BOUNCED_BEFORE: "bounced_before",
+    MAILBOX_NOT_FOUND: "mailbox_not_found",
+    MAILBOX_UNCERTAIN: "mailbox_uncertain",
+    RANDOM_INPUT: "random_input"
+  }.freeze
+
+  ADDRESS_CHECK_RESULTS = {VALID: "valid", RISKY: "risky", INVALID: "invalid", UNKNOWN: "unknown"}.freeze
+
+  ADDRESS_CONFIDENCES = {HIGH: "high", MEDIUM: "medium", LOW: "low"}.freeze
+
   ADDRESS_FORWARD_CONSENT_STATUSES = {
     SENT: "sent",
     ALREADY_CONFIRMED: "already-confirmed",
@@ -18,6 +39,17 @@ module OpenEmail
     DIRECT: "direct"
   }.freeze
 
+  ADDRESS_MX_STATUSES = {
+    FOUND: "found",
+    IMPLICIT: "implicit",
+    MISSING: "missing",
+    NULL_MX: "null_mx",
+    DOMAIN_NOT_FOUND: "domain_not_found",
+    UNKNOWN: "unknown"
+  }.freeze
+
+  ADD_ONS = {DEDICATED_IP: "dedicated-ip"}.freeze
+
   API_SCOPES = {
     EMAILS_SEND: "emails:send",
     EMAILS_READ: "emails:read",
@@ -55,6 +87,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,8 +97,100 @@ 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
 
+  AUTOMATION_CONDITION_KINDS = {
+    EMAIL_OPENED: "email_opened",
+    EMAIL_CLICKED: "email_clicked",
+    IN_AUDIENCE: "in_audience",
+    FIELD: "field",
+    EVENT: "event"
+  }.freeze
+
+  AUTOMATION_DATE_FIELDS = {BIRTHDAY: "birthday", JOINED: "joined"}.freeze
+
+  AUTOMATION_DURATION_UNITS = {MINUTES: "minutes", HOURS: "hours", DAYS: "days", WEEKS: "weeks"}.freeze
+
+  AUTOMATION_ENROLLMENT_SOURCES = {TRIGGER: "trigger", MANUAL: "manual", API: "api"}.freeze
+
+  AUTOMATION_ENROLLMENT_STATUSES = {ACTIVE: "active", COMPLETED: "completed", EXITED: "exited"}.freeze
+
+  AUTOMATION_EXIT_REASONS = {
+    COMPLETED: "completed",
+    EXIT_STEP: "exit_step",
+    UNSUBSCRIBED: "unsubscribed",
+    SUPPRESSED: "suppressed",
+    LEFT_AUDIENCE: "left_audience",
+    REMOVED: "removed",
+    ARCHIVED: "archived",
+    FAILED: "failed"
+  }.freeze
+
+  AUTOMATION_FIELD_OPERATORS = {
+    EQUALS: "equals",
+    NOT_EQUALS: "not_equals",
+    CONTAINS: "contains",
+    NOT_CONTAINS: "not_contains",
+    STARTS_WITH: "starts_with",
+    ENDS_WITH: "ends_with",
+    IS_SET: "is_set",
+    IS_NOT_SET: "is_not_set",
+    GREATER_THAN: "greater_than",
+    LESS_THAN: "less_than"
+  }.freeze
+
+  AUTOMATION_HOLD_REASONS = {WINDOW: "window", QUOTA: "quota", LANE: "lane", RETRY: "retry"}.freeze
+
+  AUTOMATION_PAUSE_REASONS = {
+    MANUAL: "manual",
+    SENDER_REFUSED: "sender_refused",
+    KEY_REVOKED: "key_revoked",
+    TEMPLATE_UNAVAILABLE: "template_unavailable",
+    AUDIENCE_MISSING: "audience_missing",
+    PLAN_LIMIT: "plan_limit"
+  }.freeze
+
+  AUTOMATION_RUN_OUTCOMES = {
+    SENT: "sent",
+    SKIPPED: "skipped",
+    WAITED: "waited",
+    YES: "yes",
+    NO: "no",
+    ADDED: "added",
+    REMOVED: "removed",
+    UPDATED: "updated",
+    CALLED: "called",
+    EXITED: "exited",
+    FAILED: "failed"
+  }.freeze
+
+  AUTOMATION_STATUSES = {DRAFT: "draft", LIVE: "live", PAUSED: "paused", ARCHIVED: "archived"}.freeze
+
+  AUTOMATION_STEP_KINDS = {
+    SEND_EMAIL: "send_email",
+    WAIT: "wait",
+    BRANCH: "branch",
+    ADD_TO_AUDIENCE: "add_to_audience",
+    REMOVE_FROM_AUDIENCE: "remove_from_audience",
+    UPDATE_FIELD: "update_field",
+    WEBHOOK: "webhook",
+    EXIT: "exit"
+  }.freeze
+
+  AUTOMATION_TRIGGER_KINDS = {
+    AUDIENCE_JOINED: "audience_joined",
+    FORM_SUBMITTED: "form_submitted",
+    EVENT: "event",
+    DATE: "date",
+    MANUAL: "manual"
+  }.freeze
+
+  AUTOMATION_VALUE_SOURCES = {STATIC: "static", CONTACT: "contact", EVENT: "event"}.freeze
+
+  AUTOMATION_WAIT_MODES = {DURATION: "duration", UNTIL: "until", EVENT: "event"}.freeze
+
   BILLING_ALERT_KINDS = {
     PAYMENT_FAILED: "payment_failed",
     PAY_AS_YOU_GO_PAUSED: "pay_as_you_go_paused",
@@ -168,10 +294,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,12 +349,28 @@ 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
 
+  DEDICATED_IP_INELIGIBLE_REASONS = {PLAN: "plan", VOLUME: "volume"}.freeze
+
+  DEDICATED_IP_STATUSES = {AVAILABLE: "available", WARMING: "warming", READY: "ready", RELEASED: "released"}.freeze
+
   DELIVERABILITY_CHECK_IDS = {MX: "mx", SPF: "spf", DKIM: "dkim", DMARC: "dmarc", BIMI: "bimi"}.freeze
 
   DELIVERABILITY_CHECK_STATUSES = {PASS: "pass", WARN: "warn", FAIL: "fail", ABSENT: "absent"}.freeze
@@ -296,11 +463,23 @@ module OpenEmail
 
   FILE_VISIBILITIES = {PUBLIC: "public", PRIVATE: "private"}.freeze
 
+  FOLLOW_UP_STATUSES = {WAITING: "waiting", ANSWERED: "answered", DUE: "due", CANCELLED: "cancelled"}.freeze
+
   FORM_ALIGNS = {LEFT: "left", CENTER: "center"}.freeze
 
   FORM_CONFIRM_SOURCES = {LINK: "link", APPROVAL: "approval"}.freeze
 
-  FORM_CONTACT_FIELDS = {EMAIL: "email", FIRST_NAME: "firstName", LAST_NAME: "lastName", NAME: "name"}.freeze
+  FORM_CONTACT_FIELDS = {
+    EMAIL: "email",
+    FIRST_NAME: "firstName",
+    LAST_NAME: "lastName",
+    NAME: "name",
+    PHONE: "phone",
+    COMPANY: "company",
+    JOB_TITLE: "jobTitle",
+    WEBSITE: "website",
+    BIRTHDAY: "birthday"
+  }.freeze
 
   FORM_FIELD_ERRORS = {
     REQUIRED: "required",
@@ -365,6 +544,106 @@ 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",
+    IMAP: "imap",
+    MICROSOFT: "microsoft"
+  }.freeze
+
+  IMPORT_PAUSE_REASONS = {
+    THROTTLED: "throttled",
+    DAILY_LIMIT: "daily-limit",
+    UNREACHABLE: "unreachable",
+    SIGN_IN: "sign-in"
+  }.freeze
+
+  IMPORT_STATUSES = {
+    UPLOADING: "uploading",
+    QUEUED: "queued",
+    RUNNING: "running",
+    PARKED: "parked",
+    NEEDS_PASSWORD: "needs-password",
+    COMPLETED: "completed",
+    FAILED: "failed",
+    CANCELLED: "cancelled"
+  }.freeze
+
+  INBOX_CATEGORIES = {
+    PRIMARY: "primary",
+    PROMOTIONS: "promotions",
+    UPDATES: "updates",
+    SOCIAL: "social",
+    FORUMS: "forums"
+  }.freeze
+
+  ITEM_IMPORT_KINDS = {CALENDAR: "calendar", CONTACTS: "contacts"}.freeze
+
+  ITEM_IMPORT_SKIP_REASONS = {
+    UID_TAKEN: "uid-taken",
+    NO_START: "no-start",
+    DUPLICATE: "duplicate",
+    LIMIT: "limit",
+    INVALID: "invalid",
+    EMPTY: "empty"
+  }.freeze
+
+  ITEM_IMPORT_SOURCES = {
+    FILE: "file",
+    TAKEOUT: "takeout",
+    CALDAV: "caldav",
+    CARDDAV: "carddav",
+    MICROSOFT: "microsoft"
+  }.freeze
+
+  ITEM_IMPORT_STATUSES = {
+    UPLOADING: "uploading",
+    QUEUED: "queued",
+    RUNNING: "running",
+    COMPLETED: "completed",
+    FAILED: "failed",
+    CANCELLED: "cancelled",
+    UNDONE: "undone"
+  }.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 +931,62 @@ module OpenEmail
 
   LOGIN_LOGOS = {DARK: "dark", LIGHT: "light"}.freeze
 
+  MAILBOX_FOLDER_ROLES = {
+    INBOX: "inbox",
+    SENT: "sent",
+    DRAFTS: "drafts",
+    SPAM: "spam",
+    TRASH: "trash",
+    ARCHIVE: "archive",
+    ALL: "all",
+    FLAGGED: "flagged",
+    IMPORTANT: "important",
+    FOLDER: "folder"
+  }.freeze
+
+  MAILBOX_IMPORT_SOURCES = {FILE: "file", IMAP: "imap", MICROSOFT: "microsoft"}.freeze
+
+  MAILBOX_PROVIDERS = {
+    GMAIL: "gmail",
+    OUTLOOK: "outlook",
+    YAHOO: "yahoo",
+    AOL: "aol",
+    ICLOUD: "icloud",
+    FASTMAIL: "fastmail",
+    ZOHO: "zoho",
+    OTHER: "other"
+  }.freeze
+
+  MAILBOX_SECURITIES = {TLS: "tls", STARTTLS: "starttls"}.freeze
+
+  MAILBOX_SETTINGS_SOURCES = {PRESET: "preset", MX: "mx", AUTOCONFIG: "autoconfig", SRV: "srv", GIVEN: "given"}.freeze
+
+  MAILBOX_SIGN_INS = {APP_PASSWORD: "app-password", PASSWORD: "password", MICROSOFT: "microsoft"}.freeze
+
+  MAIL_APP_PROTOCOLS = {IMAP: "imap", SMTP: "smtp", POP3: "pop3", CALDAV: "caldav", CARDDAV: "carddav"}.freeze
+
+  MAIL_APP_SECURITIES = {SSL_TLS: "ssl-tls", STARTTLS: "starttls"}.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 +1003,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 +1035,8 @@ module OpenEmail
     CANCELLED: "cancelled"
   }.freeze
 
+  REPLY_SUGGESTION_STATES = {READY: "ready", PENDING: "pending", NONE: "none"}.freeze
+
   REWRITE_ACTIONS = {
     SHORTEN: "shorten",
     LENGTHEN: "lengthen",
@@ -749,6 +1096,31 @@ module OpenEmail
     LT: "lt"
   }.freeze
 
+  SENDING_POOL_STATUSES = {
+    PENDING: "pending",
+    WARMING: "warming",
+    ACTIVE: "active",
+    RELEASING: "releasing",
+    RELEASED: "released",
+    FAILED: "failed"
+  }.freeze
+
+  SENDING_STREAM_PAUSE_REASONS = {BOUNCE_RATE: "bounce_rate", COMPLAINT_RATE: "complaint_rate"}.freeze
+
+  SENDING_STREAM_STATUSES = {ACTIVE: "active", PAUSED: "paused"}.freeze
+
+  SEND_STREAMS = {TRANSACTIONAL: "transactional", BROADCAST: "broadcast"}.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",
@@ -828,7 +1200,11 @@ module OpenEmail
     FILE_UPLOADED: "file.uploaded",
     FILE_DELETED: "file.deleted",
     FORM_SUBMITTED: "form.submitted",
-    FORM_CONFIRMED: "form.confirmed"
+    FORM_CONFIRMED: "form.confirmed",
+    AUTOMATION_ENTERED: "automation.entered",
+    AUTOMATION_EXITED: "automation.exited",
+    AUTOMATION_PAUSED: "automation.paused",
+    AUTOMATION_WEBHOOK: "automation.webhook"
   }.freeze
 
   WEBHOOK_REPLAY_ERROR_CODES = {

data/lib/openemail/protocol.rb

@@ -11,6 +11,7 @@ module OpenEmail
     CONTENT_TYPES = {
       JSON: "application/json",
       CALENDAR: "text/calendar",
+      VCARD: "text/vcard",
       OCTET_STREAM: "application/octet-stream"
     }.freeze
 
@@ -123,10 +124,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 +145,22 @@ 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",
+      CATEGORY: "category",
+      DEEP: "deep",
+      PATH: "path",
+      STEP_KEY: "stepKey",
+      NAME: "name"
     }.freeze
 
     RETRY = {

data/lib/openemail/resource.rb

@@ -43,6 +43,15 @@ module OpenEmail
       Wire.instant(value)
     end
 
+    def log_window_query(since, until_value)
+      query_params(since: instant(since), until: instant(until_value))
+    end
+
+    def log_request_query(since, until_value, failed_only, statuses, path)
+      status = (statuses.nil? || statuses.empty?) ? nil : joined(statuses)
+      log_window_query(since, until_value).merge(query_params(failed_only: flag(failed_only), status:, path:))
+    end
+
     def fetch_page(path, query = nil, style: CURSOR, limit: nil, cursor: nil, api_key: nil)
       Pagination.fetch_page(@transport, path, query:, style:, limit:, cursor:, api_key:)
     end
@@ -66,5 +75,23 @@ 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 optional_upload_name(data, filename)
+      filename.nil? ? RawBody.file_name(data) : filename
+    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/automations.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module OpenEmail
+  module Resources
+    class Automations < Resource
+      def list(status: nil, limit: nil, cursor: nil, api_key: nil)
+        fetch_page(ApiPaths::AUTOMATIONS, query_params(status:), limit:, cursor:, api_key:)
+      end
+
+      def list_all(status: nil, limit: nil, cursor: nil, api_key: nil)
+        collect_all(ApiPaths::AUTOMATIONS, query_params(status:), limit:, cursor:, api_key:)
+      end
+
+      def iterate(status: nil, limit: nil, cursor: nil, api_key: nil, &)
+        iterate_pages(ApiPaths::AUTOMATIONS, query_params(status:), limit:, cursor:, api_key:, &)
+      end
+
+      def create(body = nil, api_key: nil, **fields)
+        request(ApiPaths::AUTOMATIONS, method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def list_starters(api_key: nil)
+        fetch_list(ApiPaths::AUTOMATION_STARTERS, api_key:)
+      end
+
+      def get(id, api_key: nil)
+        request(fill(ApiPaths::AUTOMATION, id:), api_key:)
+      end
+
+      def update(id, patch = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::AUTOMATION, id:), method: :patch, body: payload(patch, fields), repeatable: true,
+          api_key:)
+      end
+
+      def delete(id, api_key: nil)
+        request(fill(ApiPaths::AUTOMATION, id:), method: :delete, api_key:)
+      end
+
+      def publish(id, api_key: nil)
+        request(fill(ApiPaths::AUTOMATION_PUBLISH, id:), method: :post, repeatable: true, api_key:)
+      end
+
+      def pause(id, api_key: nil)
+        request(fill(ApiPaths::AUTOMATION_PAUSE, id:), method: :post, repeatable: true, api_key:)
+      end
+
+      def resume(id, api_key: nil)
+        request(fill(ApiPaths::AUTOMATION_RESUME, id:), method: :post, repeatable: true, api_key:)
+      end
+
+      def archive(id, api_key: nil)
+        request(fill(ApiPaths::AUTOMATION_ARCHIVE, id:), method: :post, repeatable: true, api_key:)
+      end
+
+      def duplicate(id, api_key: nil)
+        request(fill(ApiPaths::AUTOMATION_DUPLICATE, id:), method: :post, api_key:)
+      end
+
+      def send_test(id, body = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::AUTOMATION_TEST, id:), method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def list_versions(id, api_key: nil)
+        fetch_list(fill(ApiPaths::AUTOMATION_VERSIONS, id:), api_key:)
+      end
+
+      def restore_version(id, version, api_key: nil)
+        request(fill(ApiPaths::AUTOMATION_VERSION_RESTORE, id:, version:), method: :post, repeatable: true, api_key:)
+      end
+
+      def stats(id, since: nil, until: nil, api_key: nil)
+        query = log_window_query(since, binding.local_variable_get(:until))
+        request(fill(ApiPaths::AUTOMATION_STATS, id:), query:, api_key:)
+      end
+
+      def list_enrollments(id, status: nil, step_key: nil, q: nil, limit: nil, cursor: nil, api_key: nil)
+        fetch_page(fill(ApiPaths::AUTOMATION_ENROLLMENTS, id:), query_params(status:, step_key:, q:), limit:, cursor:,
+          api_key:)
+      end
+
+      def list_all_enrollments(id, status: nil, step_key: nil, q: nil, limit: nil, cursor: nil, api_key: nil)
+        collect_all(fill(ApiPaths::AUTOMATION_ENROLLMENTS, id:), query_params(status:, step_key:, q:), limit:, cursor:,
+          api_key:)
+      end
+
+      def iterate_enrollments(id, status: nil, step_key: nil, q: nil, limit: nil, cursor: nil, api_key: nil, &)
+        iterate_pages(fill(ApiPaths::AUTOMATION_ENROLLMENTS, id:), query_params(status:, step_key:, q:), limit:,
+          cursor:, api_key:, &)
+      end
+
+      def get_enrollment(id, enrollment_id, api_key: nil)
+        request(fill(ApiPaths::AUTOMATION_ENROLLMENT, id:, enrollmentId: enrollment_id), api_key:)
+      end
+
+      def enroll(id, body = nil, api_key: nil, **fields)
+        request(fill(ApiPaths::AUTOMATION_ENROLLMENTS, id:), method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def exit_enrollment(id, enrollment_id, api_key: nil)
+        request(fill(ApiPaths::AUTOMATION_ENROLLMENT_EXIT, id:, enrollmentId: enrollment_id), method: :post, api_key:)
+      end
+    end
+  end
+end

data/lib/openemail/resources/billing.rb

@@ -43,6 +43,18 @@ module OpenEmail
         request(ApiPaths::BILLING_CHECKOUT, method: :post, body: payload(body, fields), api_key:)
       end
 
+      def list_add_ons(api_key: nil)
+        request(ApiPaths::BILLING_ADD_ONS, api_key:)
+      end
+
+      def start_add_on_checkout(body = nil, api_key: nil, **fields)
+        request(ApiPaths::BILLING_ADD_ON_CHECKOUT, method: :post, body: payload(body, fields), api_key:)
+      end
+
+      def cancel_add_on(add_on, api_key: nil)
+        request(fill(ApiPaths::BILLING_ADD_ON, addOn: add_on), method: :delete, api_key:)
+      end
+
       def open_portal(body = nil, api_key: nil, **fields)
         request(ApiPaths::BILLING_PORTAL, method: :post, body: payload(body, fields), api_key:)
       end