telnyx 5.169.0 → 5.170.0

data/lib/telnyx/models/email_domain_rotate_dkim_response.rb

@@ -0,0 +1,243 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::EmailDomains#rotate_dkim
+    class EmailDomainRotateDkimResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #   Result of rotating a domain's DKIM key. The new key is active and signing
+      #   switches to it immediately; the previous key is retired to a `retiring` state
+      #   (retained, not revoked) so it can be revoked after the DNS propagation grace
+      #   period. Selectors are fixed, so the DKIM DNS record's TXT value is replaced in
+      #   place at the shared `<selector>._domainkey.<domain>` host —
+      #   `old_selector_retained` is false and the returned dns_records carry the new
+      #   value the customer must publish promptly.
+      #
+      #   @return [Telnyx::Models::EmailDomainRotateDkimResponse::Data]
+      required :data, -> { Telnyx::Models::EmailDomainRotateDkimResponse::Data }
+
+      # @!method initialize(data:)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::EmailDomainRotateDkimResponse} for more details.
+      #
+      #   @param data [Telnyx::Models::EmailDomainRotateDkimResponse::Data] Result of rotating a domain's DKIM key. The new key is active and signing switch
+
+      # @see Telnyx::Models::EmailDomainRotateDkimResponse#data
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute dkim
+        #   The new active DKIM key.
+        #
+        #   @return [Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim]
+        required :dkim, -> { Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim }
+
+        # @!attribute dns_records
+        #   The DKIM DNS records the customer must publish, carrying the new key's TXT value
+        #   with verification reset to pending.
+        #
+        #   @return [Array<Telnyx::Models::DNSRecord>]
+        required :dns_records, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::DNSRecord] }
+
+        # @!attribute domain
+        #
+        #   @return [String]
+        required :domain, String
+
+        # @!attribute domain_id
+        #
+        #   @return [String]
+        required :domain_id, String
+
+        # @!attribute old_selector_retained
+        #   False for this service: one selector is fixed per domain, so rotation replaces
+        #   the TXT value at the existing \_domainkey host. There is no dual-selector
+        #   overlap; publish the replacement TXT promptly because signing switches
+        #   immediately.
+        #
+        #   @return [Boolean]
+        required :old_selector_retained, Telnyx::Internal::Type::Boolean
+
+        # @!attribute previous_dkim_key
+        #   The retired previous key, or null when the domain had no active key before
+        #   rotation. Retained in a `retiring` state so it can be revoked after the DNS
+        #   propagation grace period.
+        #
+        #   @return [Telnyx::Models::EmailDomainRotateDkimResponse::Data::PreviousDkimKey, nil]
+        required :previous_dkim_key,
+                 -> { Telnyx::Models::EmailDomainRotateDkimResponse::Data::PreviousDkimKey },
+                 nil?: true
+
+        # @!attribute record_type
+        #
+        #   @return [Symbol, Telnyx::Models::EmailDomainRotateDkimResponse::Data::RecordType]
+        required :record_type, enum: -> { Telnyx::Models::EmailDomainRotateDkimResponse::Data::RecordType }
+
+        # @!method initialize(dkim:, dns_records:, domain:, domain_id:, old_selector_retained:, previous_dkim_key:, record_type:)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::EmailDomainRotateDkimResponse::Data} for more details.
+        #
+        #   Result of rotating a domain's DKIM key. The new key is active and signing
+        #   switches to it immediately; the previous key is retired to a `retiring` state
+        #   (retained, not revoked) so it can be revoked after the DNS propagation grace
+        #   period. Selectors are fixed, so the DKIM DNS record's TXT value is replaced in
+        #   place at the shared `<selector>._domainkey.<domain>` host —
+        #   `old_selector_retained` is false and the returned dns_records carry the new
+        #   value the customer must publish promptly.
+        #
+        #   @param dkim [Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim] The new active DKIM key.
+        #
+        #   @param dns_records [Array<Telnyx::Models::DNSRecord>] The DKIM DNS records the customer must publish, carrying the new key's TXT value
+        #
+        #   @param domain [String]
+        #
+        #   @param domain_id [String]
+        #
+        #   @param old_selector_retained [Boolean] False for this service: one selector is fixed per domain, so rotation replaces t
+        #
+        #   @param previous_dkim_key [Telnyx::Models::EmailDomainRotateDkimResponse::Data::PreviousDkimKey, nil] The retired previous key, or null when the domain had no active key before rotat
+        #
+        #   @param record_type [Symbol, Telnyx::Models::EmailDomainRotateDkimResponse::Data::RecordType]
+
+        # @see Telnyx::Models::EmailDomainRotateDkimResponse::Data#dkim
+        class Dkim < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute algorithm
+          #
+          #   @return [Symbol, Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim::Algorithm]
+          required :algorithm, enum: -> { Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim::Algorithm }
+
+          # @!attribute key_length
+          #
+          #   @return [Integer, Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim::KeyLength]
+          required :key_length, enum: -> { Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim::KeyLength }
+
+          # @!attribute selector
+          #
+          #   @return [String]
+          required :selector, String
+
+          # @!attribute status
+          #
+          #   @return [Symbol, Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim::Status]
+          required :status, enum: -> { Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim::Status }
+
+          # @!attribute version
+          #   Monotonically increasing per-domain key version.
+          #
+          #   @return [Integer]
+          required :version, Integer
+
+          # @!attribute activated_at
+          #
+          #   @return [Time, nil]
+          optional :activated_at, Time, nil?: true
+
+          # @!method initialize(id:, algorithm:, key_length:, selector:, status:, version:, activated_at: nil)
+          #   The new active DKIM key.
+          #
+          #   @param id [String]
+          #
+          #   @param algorithm [Symbol, Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim::Algorithm]
+          #
+          #   @param key_length [Integer, Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim::KeyLength]
+          #
+          #   @param selector [String]
+          #
+          #   @param status [Symbol, Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim::Status]
+          #
+          #   @param version [Integer] Monotonically increasing per-domain key version.
+          #
+          #   @param activated_at [Time, nil]
+
+          # @see Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim#algorithm
+          module Algorithm
+            extend Telnyx::Internal::Type::Enum
+
+            RSA_SHA256 = :"rsa-sha256"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim#key_length
+          module KeyLength
+            extend Telnyx::Internal::Type::Enum
+
+            KEY_LENGTH_2048 = 2048
+
+            # @!method self.values
+            #   @return [Array<Integer>]
+          end
+
+          # @see Telnyx::Models::EmailDomainRotateDkimResponse::Data::Dkim#status
+          module Status
+            extend Telnyx::Internal::Type::Enum
+
+            ACTIVE = :active
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # @see Telnyx::Models::EmailDomainRotateDkimResponse::Data#previous_dkim_key
+        class PreviousDkimKey < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute selector
+          #
+          #   @return [String]
+          required :selector, String
+
+          # @!attribute status
+          #
+          #   @return [Symbol, Telnyx::Models::EmailDomainRotateDkimResponse::Data::PreviousDkimKey::Status]
+          required :status,
+                   enum: -> { Telnyx::Models::EmailDomainRotateDkimResponse::Data::PreviousDkimKey::Status }
+
+          # @!attribute version
+          #
+          #   @return [Integer]
+          required :version, Integer
+
+          # @!method initialize(id:, selector:, status:, version:)
+          #   The retired previous key, or null when the domain had no active key before
+          #   rotation. Retained in a `retiring` state so it can be revoked after the DNS
+          #   propagation grace period.
+          #
+          #   @param id [String]
+          #   @param selector [String]
+          #   @param status [Symbol, Telnyx::Models::EmailDomainRotateDkimResponse::Data::PreviousDkimKey::Status]
+          #   @param version [Integer]
+
+          # @see Telnyx::Models::EmailDomainRotateDkimResponse::Data::PreviousDkimKey#status
+          module Status
+            extend Telnyx::Internal::Type::Enum
+
+            RETIRING = :retiring
+            REVOKED = :revoked
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # @see Telnyx::Models::EmailDomainRotateDkimResponse::Data#record_type
+        module RecordType
+          extend Telnyx::Internal::Type::Enum
+
+          EMAIL_DOMAIN_DKIM_ROTATION = :email_domain_dkim_rotation
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/email_domains/email_webhook_event.rb

@@ -3,9 +3,11 @@
 module Telnyx
   module Models
     module EmailDomains
-      # Event types a webhook may subscribe to. The union of email._ events (published
-      # by email-api) and email_domain._ lifecycle events (published by this service).
-      # An event not listed here can never be subscribed to and is silently dropped.
+      # Event types accepted by domain webhook subscriptions. Allowlists match the
+      # legacy event_type, not canonical_event_type. Of the 22 accepted types,
+      # email.sending is stored but intentionally not published. Cancellation,
+      # daily-limit failures, and system failures publish after commit when a matching
+      # domain webhook is configured.
       module EmailWebhookEvent
         extend Telnyx::Internal::Type::Enum
 
@@ -23,11 +25,14 @@ module Telnyx
         EMAIL_CLICKED = :"email.clicked"
         EMAIL_UNSUBSCRIBED = :"email.unsubscribed"
         EMAIL_RECEIVED = :"email.received"
+        EMAIL_CANCELLED = :"email.cancelled"
+        EMAIL_DAILY_LIMIT_EXCEEDED = :"email.daily_limit_exceeded"
         EMAIL_DOMAIN_CREATED = :"email_domain.created"
         EMAIL_DOMAIN_VERIFIED = :"email_domain.verified"
         EMAIL_DOMAIN_DEGRADED = :"email_domain.degraded"
         EMAIL_DOMAIN_SUSPENDED = :"email_domain.suspended"
         EMAIL_DOMAIN_DELETED = :"email_domain.deleted"
+        EMAIL_DOMAIN_DKIM_ROTATED = :"email_domain.dkim_rotated"
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/telnyx/models/email_event_list_params.rb

@@ -19,6 +19,17 @@ module Telnyx
       #   parameters (e.g. event_type=delivered&event_type=bounced). Unknown values return
       #   no matches.
       #
+      #   Dual-name compatibility: values are accepted bare or `email.`-prefixed. A legacy
+      #   value keeps matching the rows it matched pre-rename — no widening: `failed` also
+      #   matches the rows that now store the canonical names of the outcomes it covered
+      #   (`gw_reject`, `injection_timeout`, `expired`); `bounced` matches stored
+      #   `bounced` rows only (recipient-scoped Expirations stored `failed` pre-rename and
+      #   never matched `bounced`, so `expired` is deliberately not a `bounced`
+      #   expansion). A canonical value matches its own rows plus legacy rows whose
+      #   recorded payload evidence proves that outcome (`expired` also surfaces legacy
+      #   `bounced` rows with `bounce_category: transient`). The additive
+      #   `canonical_event_type` field in each response row names the canonical outcome.
+      #
       #   @return [String, Array<String>, nil]
       optional :event_type, union: -> { Telnyx::EmailEventListParams::EventType }
 
@@ -28,12 +39,6 @@ module Telnyx
       #   @return [Time, nil]
       optional :from, Time
 
-      # @!attribute page_cursor
-      #   Opaque URL-safe Base64 cursor returned by a previous list response.
-      #
-      #   @return [String, nil]
-      optional :page_cursor, String
-
       # @!attribute page_size
       #   Number of results to return. Defaults to 25; maximum is 100. Invalid values are
       #   clamped to the valid range.
@@ -41,6 +46,13 @@ module Telnyx
       #   @return [Integer, nil]
       optional :page_size, Integer
 
+      # @!attribute page_cursor
+      #   Opaque URL-safe Base64 cursor returned by a previous event list response. The
+      #   legacy `page[after]` and flat `page_cursor` forms are also accepted.
+      #
+      #   @return [String, nil]
+      optional :page_cursor, String
+
       # @!attribute to
       #   Inclusive ISO 8601 end timestamp. When `from` is provided without `to`, defaults
       #   to `from + 30 days`.
@@ -48,20 +60,20 @@ module Telnyx
       #   @return [Time, nil]
       optional :to, Time
 
-      # @!method initialize(email_id: nil, event_type: nil, from: nil, page_cursor: nil, page_size: nil, to: nil, request_options: {})
+      # @!method initialize(email_id: nil, event_type: nil, from: nil, page_size: nil, page_cursor: nil, to: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::EmailEventListParams} for more details.
       #
       #   @param email_id [String] Filter events for a specific email message UUID. Invalid UUID values are silentl
       #
-      #   @param event_type [String, Array<String>] Comma-separated list of event types to include. Also accepts repeated query para
+      #   @param event_type [String, Array<String>] Comma-separated list of event types to include. Also accepts repeated
       #
       #   @param from [Time] Inclusive ISO 8601 start timestamp. Defaults to 30 days ago when omitted.
       #
-      #   @param page_cursor [String] Opaque URL-safe Base64 cursor returned by a previous list response.
-      #
       #   @param page_size [Integer] Number of results to return. Defaults to 25; maximum is 100. Invalid values are
       #
+      #   @param page_cursor [String] Opaque URL-safe Base64 cursor returned by a previous event list response. The le
+      #
       #   @param to [Time] Inclusive ISO 8601 end timestamp. When `from` is provided without `to`, defaults
       #
       #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
@@ -69,6 +81,17 @@ module Telnyx
       # Comma-separated list of event types to include. Also accepts repeated query
       # parameters (e.g. event_type=delivered&event_type=bounced). Unknown values return
       # no matches.
+      #
+      # Dual-name compatibility: values are accepted bare or `email.`-prefixed. A legacy
+      # value keeps matching the rows it matched pre-rename — no widening: `failed` also
+      # matches the rows that now store the canonical names of the outcomes it covered
+      # (`gw_reject`, `injection_timeout`, `expired`); `bounced` matches stored
+      # `bounced` rows only (recipient-scoped Expirations stored `failed` pre-rename and
+      # never matched `bounced`, so `expired` is deliberately not a `bounced`
+      # expansion). A canonical value matches its own rows plus legacy rows whose
+      # recorded payload evidence proves that outcome (`expired` also surfaces legacy
+      # `bounced` rows with `bounce_category: transient`). The additive
+      # `canonical_event_type` field in each response row names the canonical outcome.
       module EventType
         extend Telnyx::Internal::Type::Union