ark-email 0.5.2 → 0.6.0

data/rbi/ark_email/resources/emails.rbi

@@ -126,14 +126,15 @@ module ArkEmail
           from: String,
           subject: String,
           to: T::Array[String],
-          attachments: T::Array[ArkEmail::EmailSendParams::Attachment::OrHash],
-          bcc: T::Array[String],
-          cc: T::Array[String],
-          headers: T::Hash[Symbol, String],
-          html: String,
-          reply_to: String,
-          tag: String,
-          text: String,
+          attachments:
+            T.nilable(T::Array[ArkEmail::EmailSendParams::Attachment::OrHash]),
+          bcc: T.nilable(T::Array[String]),
+          cc: T.nilable(T::Array[String]),
+          headers: T.nilable(T::Hash[Symbol, String]),
+          html: T.nilable(String),
+          reply_to: T.nilable(String),
+          tag: T.nilable(String),
+          text: T.nilable(String),
           idempotency_key: String,
           request_options: ArkEmail::RequestOptions::OrHash
         ).returns(ArkEmail::Models::EmailSendResponse)
@@ -153,23 +154,23 @@ module ArkEmail
         subject:,
         # Body param: Recipient email addresses (max 50)
         to:,
-        # Body param: File attachments
+        # Body param: File attachments (accepts null)
         attachments: nil,
-        # Body param: BCC recipients
+        # Body param: BCC recipients (accepts null)
         bcc: nil,
-        # Body param: CC recipients
+        # Body param: CC recipients (accepts null)
         cc: nil,
-        # Body param: Custom email headers
+        # Body param: Custom email headers (accepts null)
         headers: nil,
-        # Body param: HTML body content. Maximum 5MB (5,242,880 characters). Combined with
-        # attachments, the total message must not exceed 14MB.
+        # Body param: HTML body content (accepts null). Maximum 5MB (5,242,880
+        # characters). Combined with attachments, the total message must not exceed 14MB.
         html: nil,
-        # Body param: Reply-to address
+        # Body param: Reply-to address (accepts null)
         reply_to: nil,
-        # Body param: Tag for categorization and filtering
+        # Body param: Tag for categorization and filtering (accepts null)
         tag: nil,
-        # Body param: Plain text body (auto-generated from HTML if not provided). Maximum
-        # 5MB (5,242,880 characters).
+        # Body param: Plain text body (accepts null, auto-generated from HTML if not
+        # provided). Maximum 5MB (5,242,880 characters).
         text: nil,
         # Header param: Unique key for idempotent requests. If a request with this key was
         # already processed, the cached response is returned. Keys expire after 24 hours.
@@ -214,6 +215,7 @@ module ArkEmail
           data: String,
           mail_from: String,
           rcpt_to: T::Array[String],
+          bounce: T.nilable(T::Boolean),
           request_options: ArkEmail::RequestOptions::OrHash
         ).returns(ArkEmail::Models::EmailSendRawResponse)
       end
@@ -224,6 +226,8 @@ module ArkEmail
         mail_from:,
         # Envelope recipient addresses
         rcpt_to:,
+        # Whether this is a bounce message (accepts null)
+        bounce: nil,
         request_options: {}
       )
       end

data/rbi/ark_email/resources/suppressions.rbi

@@ -8,14 +8,14 @@ module ArkEmail
       sig do
         params(
           address: String,
-          reason: String,
+          reason: T.nilable(String),
           request_options: ArkEmail::RequestOptions::OrHash
         ).returns(ArkEmail::Models::SuppressionCreateResponse)
       end
       def create(
         # Email address to suppress
         address:,
-        # Reason for suppression
+        # Reason for suppression (accepts null)
         reason: nil,
         request_options: {}
       )

data/rbi/ark_email/resources/tracking.rbi

@@ -9,11 +9,11 @@ module ArkEmail
       # value before tracking will work.
       sig do
         params(
-          domain_id: String,
+          domain_id: Integer,
           name: String,
-          ssl_enabled: T::Boolean,
-          track_clicks: T::Boolean,
-          track_opens: T::Boolean,
+          ssl_enabled: T.nilable(T::Boolean),
+          track_clicks: T.nilable(T::Boolean),
+          track_opens: T.nilable(T::Boolean),
           request_options: ArkEmail::RequestOptions::OrHash
         ).returns(ArkEmail::Models::TrackingCreateResponse)
       end
@@ -22,11 +22,11 @@ module ArkEmail
         domain_id:,
         # Subdomain name (e.g., 'track' for track.yourdomain.com)
         name:,
-        # Enable SSL for tracking URLs (recommended)
+        # Enable SSL for tracking URLs (accepts null, defaults to true)
         ssl_enabled: nil,
-        # Enable click tracking
+        # Enable click tracking (accepts null, defaults to true)
         track_clicks: nil,
-        # Enable open tracking (tracking pixel)
+        # Enable open tracking (tracking pixel, accepts null, defaults to true)
         track_opens: nil,
         request_options: {}
       )
@@ -57,23 +57,23 @@ module ArkEmail
       sig do
         params(
           tracking_id: String,
-          excluded_click_domains: String,
-          ssl_enabled: T::Boolean,
-          track_clicks: T::Boolean,
-          track_opens: T::Boolean,
+          excluded_click_domains: T.nilable(String),
+          ssl_enabled: T.nilable(T::Boolean),
+          track_clicks: T.nilable(T::Boolean),
+          track_opens: T.nilable(T::Boolean),
           request_options: ArkEmail::RequestOptions::OrHash
         ).returns(ArkEmail::Models::TrackingUpdateResponse)
       end
       def update(
         # Track domain ID or UUID
         tracking_id,
-        # Comma-separated list of domains to exclude from click tracking
+        # Comma-separated list of domains to exclude from click tracking (accepts null)
         excluded_click_domains: nil,
-        # Enable or disable SSL for tracking URLs
+        # Enable or disable SSL for tracking URLs (accepts null)
         ssl_enabled: nil,
-        # Enable or disable click tracking
+        # Enable or disable click tracking (accepts null)
         track_clicks: nil,
-        # Enable or disable open tracking
+        # Enable or disable open tracking (accepts null)
         track_opens: nil,
         request_options: {}
       )

data/rbi/ark_email/resources/webhooks.rbi

@@ -17,16 +17,25 @@ module ArkEmail
       # - `DomainDNSError` - Domain DNS issue detected
       sig do
         params(
-          events: T::Array[ArkEmail::WebhookCreateParams::Event::OrSymbol],
           name: String,
           url: String,
-          all_events: T::Boolean,
-          enabled: T::Boolean,
+          all_events: T.nilable(T::Boolean),
+          enabled: T.nilable(T::Boolean),
+          events:
+            T.nilable(T::Array[ArkEmail::WebhookCreateParams::Event::OrSymbol]),
           request_options: ArkEmail::RequestOptions::OrHash
         ).returns(ArkEmail::Models::WebhookCreateResponse)
       end
       def create(
-        # Events to subscribe to:
+        # Webhook name for identification
+        name:,
+        # HTTPS endpoint URL
+        url:,
+        # Subscribe to all events (ignores events array, accepts null)
+        all_events: nil,
+        # Whether the webhook is enabled (accepts null)
+        enabled: nil,
+        # Events to subscribe to (accepts null):
         #
         # - `MessageSent` - Email successfully delivered to recipient's server
         # - `MessageDelayed` - Temporary delivery failure, will retry
@@ -36,14 +45,7 @@ module ArkEmail
         # - `MessageLinkClicked` - Recipient clicked a tracked link
         # - `MessageLoaded` - Recipient opened the email (tracking pixel loaded)
         # - `DomainDNSError` - DNS configuration issue detected
-        events:,
-        # Webhook name for identification
-        name:,
-        # HTTPS endpoint URL
-        url:,
-        # Subscribe to all events (ignores events array)
-        all_events: nil,
-        enabled: nil,
+        events: nil,
         request_options: {}
       )
       end
@@ -62,11 +64,11 @@ module ArkEmail
       sig do
         params(
           webhook_id: String,
-          all_events: T::Boolean,
-          enabled: T::Boolean,
-          events: T::Array[String],
-          name: String,
-          url: String,
+          all_events: T.nilable(T::Boolean),
+          enabled: T.nilable(T::Boolean),
+          events: T.nilable(T::Array[String]),
+          name: T.nilable(String),
+          url: T.nilable(String),
           request_options: ArkEmail::RequestOptions::OrHash
         ).returns(ArkEmail::Models::WebhookUpdateResponse)
       end

data/sig/ark_email/models/email_send_batch_params.rbs

@@ -38,9 +38,9 @@ module ArkEmail
         {
           subject: String,
           to: ::Array[String],
-          html: String,
-          tag: String,
-          text: String
+          html: String?,
+          tag: String?,
+          text: String?
         }
 
       class Email < ArkEmail::Internal::Type::BaseModel
@@ -48,32 +48,26 @@ module ArkEmail
 
         attr_accessor to: ::Array[String]
 
-        attr_reader html: String?
+        attr_accessor html: String?
 
-        def html=: (String) -> String
+        attr_accessor tag: String?
 
-        attr_reader tag: String?
-
-        def tag=: (String) -> String
-
-        attr_reader text: String?
-
-        def text=: (String) -> String
+        attr_accessor text: String?
 
         def initialize: (
           subject: String,
           to: ::Array[String],
-          ?html: String,
-          ?tag: String,
-          ?text: String
+          ?html: String?,
+          ?tag: String?,
+          ?text: String?
         ) -> void
 
         def to_hash: -> {
           subject: String,
           to: ::Array[String],
-          html: String,
-          tag: String,
-          text: String
+          html: String?,
+          tag: String?,
+          text: String?
         }
       end
     end

data/sig/ark_email/models/email_send_params.rbs

@@ -5,14 +5,14 @@ module ArkEmail
         from: String,
         subject: String,
         to: ::Array[String],
-        attachments: ::Array[ArkEmail::EmailSendParams::Attachment],
-        bcc: ::Array[String],
-        cc: ::Array[String],
-        headers: ::Hash[Symbol, String],
-        html: String,
-        reply_to: String,
-        tag: String,
-        text: String,
+        attachments: ::Array[ArkEmail::EmailSendParams::Attachment]?,
+        bcc: ::Array[String]?,
+        cc: ::Array[String]?,
+        headers: ::Hash[Symbol, String]?,
+        html: String?,
+        reply_to: String?,
+        tag: String?,
+        text: String?,
         idempotency_key: String
       }
       & ArkEmail::Internal::Type::request_parameters
@@ -27,39 +27,21 @@ module ArkEmail
 
       attr_accessor to: ::Array[String]
 
-      attr_reader attachments: ::Array[ArkEmail::EmailSendParams::Attachment]?
+      attr_accessor attachments: ::Array[ArkEmail::EmailSendParams::Attachment]?
 
-      def attachments=: (
-        ::Array[ArkEmail::EmailSendParams::Attachment]
-      ) -> ::Array[ArkEmail::EmailSendParams::Attachment]
+      attr_accessor bcc: ::Array[String]?
 
-      attr_reader bcc: ::Array[String]?
+      attr_accessor cc: ::Array[String]?
 
-      def bcc=: (::Array[String]) -> ::Array[String]
+      attr_accessor headers: ::Hash[Symbol, String]?
 
-      attr_reader cc: ::Array[String]?
+      attr_accessor html: String?
 
-      def cc=: (::Array[String]) -> ::Array[String]
+      attr_accessor reply_to: String?
 
-      attr_reader headers: ::Hash[Symbol, String]?
+      attr_accessor tag: String?
 
-      def headers=: (::Hash[Symbol, String]) -> ::Hash[Symbol, String]
-
-      attr_reader html: String?
-
-      def html=: (String) -> String
-
-      attr_reader reply_to: String?
-
-      def reply_to=: (String) -> String
-
-      attr_reader tag: String?
-
-      def tag=: (String) -> String
-
-      attr_reader text: String?
-
-      def text=: (String) -> String
+      attr_accessor text: String?
 
       attr_reader idempotency_key: String?
 
@@ -69,14 +51,14 @@ module ArkEmail
         from: String,
         subject: String,
         to: ::Array[String],
-        ?attachments: ::Array[ArkEmail::EmailSendParams::Attachment],
-        ?bcc: ::Array[String],
-        ?cc: ::Array[String],
-        ?headers: ::Hash[Symbol, String],
-        ?html: String,
-        ?reply_to: String,
-        ?tag: String,
-        ?text: String,
+        ?attachments: ::Array[ArkEmail::EmailSendParams::Attachment]?,
+        ?bcc: ::Array[String]?,
+        ?cc: ::Array[String]?,
+        ?headers: ::Hash[Symbol, String]?,
+        ?html: String?,
+        ?reply_to: String?,
+        ?tag: String?,
+        ?text: String?,
         ?idempotency_key: String,
         ?request_options: ArkEmail::request_opts
       ) -> void
@@ -85,14 +67,14 @@ module ArkEmail
         from: String,
         subject: String,
         to: ::Array[String],
-        attachments: ::Array[ArkEmail::EmailSendParams::Attachment],
-        bcc: ::Array[String],
-        cc: ::Array[String],
-        headers: ::Hash[Symbol, String],
-        html: String,
-        reply_to: String,
-        tag: String,
-        text: String,
+        attachments: ::Array[ArkEmail::EmailSendParams::Attachment]?,
+        bcc: ::Array[String]?,
+        cc: ::Array[String]?,
+        headers: ::Hash[Symbol, String]?,
+        html: String?,
+        reply_to: String?,
+        tag: String?,
+        text: String?,
         idempotency_key: String,
         request_options: ArkEmail::RequestOptions
       }

data/sig/ark_email/models/email_send_raw_params.rbs

@@ -1,7 +1,12 @@
 module ArkEmail
   module Models
     type email_send_raw_params =
-      { data: String, mail_from: String, rcpt_to: ::Array[String] }
+      {
+        data: String,
+        mail_from: String,
+        rcpt_to: ::Array[String],
+        bounce: bool?
+      }
       & ArkEmail::Internal::Type::request_parameters
 
     class EmailSendRawParams < ArkEmail::Internal::Type::BaseModel
@@ -14,10 +19,13 @@ module ArkEmail
 
       attr_accessor rcpt_to: ::Array[String]
 
+      attr_accessor bounce: bool?
+
       def initialize: (
         data: String,
         mail_from: String,
         rcpt_to: ::Array[String],
+        ?bounce: bool?,
         ?request_options: ArkEmail::request_opts
       ) -> void
 
@@ -25,6 +33,7 @@ module ArkEmail
         data: String,
         mail_from: String,
         rcpt_to: ::Array[String],
+        bounce: bool?,
         request_options: ArkEmail::RequestOptions
       }
     end

data/sig/ark_email/models/suppression_bulk_create_params.rbs

@@ -22,18 +22,16 @@ module ArkEmail
         request_options: ArkEmail::RequestOptions
       }
 
-      type suppression = { address: String, reason: String }
+      type suppression = { address: String, reason: String? }
 
       class Suppression < ArkEmail::Internal::Type::BaseModel
         attr_accessor address: String
 
-        attr_reader reason: String?
+        attr_accessor reason: String?
 
-        def reason=: (String) -> String
+        def initialize: (address: String, ?reason: String?) -> void
 
-        def initialize: (address: String, ?reason: String) -> void
-
-        def to_hash: -> { address: String, reason: String }
+        def to_hash: -> { address: String, reason: String? }
       end
     end
   end

data/sig/ark_email/models/suppression_create_params.rbs

@@ -1,7 +1,7 @@
 module ArkEmail
   module Models
     type suppression_create_params =
-      { address: String, reason: String }
+      { address: String, reason: String? }
       & ArkEmail::Internal::Type::request_parameters
 
     class SuppressionCreateParams < ArkEmail::Internal::Type::BaseModel
@@ -10,19 +10,17 @@ module ArkEmail
 
       attr_accessor address: String
 
-      attr_reader reason: String?
-
-      def reason=: (String) -> String
+      attr_accessor reason: String?
 
       def initialize: (
         address: String,
-        ?reason: String,
+        ?reason: String?,
         ?request_options: ArkEmail::request_opts
       ) -> void
 
       def to_hash: -> {
         address: String,
-        reason: String,
+        reason: String?,
         request_options: ArkEmail::RequestOptions
       }
     end

data/sig/ark_email/models/tracking_create_params.rbs

@@ -2,11 +2,11 @@ module ArkEmail
   module Models
     type tracking_create_params =
       {
-        domain_id: String,
+        domain_id: Integer,
         name: String,
-        ssl_enabled: bool,
-        track_clicks: bool,
-        track_opens: bool
+        ssl_enabled: bool?,
+        track_clicks: bool?,
+        track_opens: bool?
       }
       & ArkEmail::Internal::Type::request_parameters
 
@@ -14,37 +14,31 @@ module ArkEmail
       extend ArkEmail::Internal::Type::RequestParameters::Converter
       include ArkEmail::Internal::Type::RequestParameters
 
-      attr_accessor domain_id: String
+      attr_accessor domain_id: Integer
 
       attr_accessor name: String
 
-      attr_reader ssl_enabled: bool?
+      attr_accessor ssl_enabled: bool?
 
-      def ssl_enabled=: (bool) -> bool
+      attr_accessor track_clicks: bool?
 
-      attr_reader track_clicks: bool?
-
-      def track_clicks=: (bool) -> bool
-
-      attr_reader track_opens: bool?
-
-      def track_opens=: (bool) -> bool
+      attr_accessor track_opens: bool?
 
       def initialize: (
-        domain_id: String,
+        domain_id: Integer,
         name: String,
-        ?ssl_enabled: bool,
-        ?track_clicks: bool,
-        ?track_opens: bool,
+        ?ssl_enabled: bool?,
+        ?track_clicks: bool?,
+        ?track_opens: bool?,
         ?request_options: ArkEmail::request_opts
       ) -> void
 
       def to_hash: -> {
-        domain_id: String,
+        domain_id: Integer,
         name: String,
-        ssl_enabled: bool,
-        track_clicks: bool,
-        track_opens: bool,
+        ssl_enabled: bool?,
+        track_clicks: bool?,
+        track_opens: bool?,
         request_options: ArkEmail::RequestOptions
       }
     end

data/sig/ark_email/models/tracking_update_params.rbs

@@ -2,10 +2,10 @@ module ArkEmail
   module Models
     type tracking_update_params =
       {
-        excluded_click_domains: String,
-        ssl_enabled: bool,
-        track_clicks: bool,
-        track_opens: bool
+        excluded_click_domains: String?,
+        ssl_enabled: bool?,
+        track_clicks: bool?,
+        track_opens: bool?
       }
       & ArkEmail::Internal::Type::request_parameters
 
@@ -13,35 +13,27 @@ module ArkEmail
       extend ArkEmail::Internal::Type::RequestParameters::Converter
       include ArkEmail::Internal::Type::RequestParameters
 
-      attr_reader excluded_click_domains: String?
+      attr_accessor excluded_click_domains: String?
 
-      def excluded_click_domains=: (String) -> String
+      attr_accessor ssl_enabled: bool?
 
-      attr_reader ssl_enabled: bool?
+      attr_accessor track_clicks: bool?
 
-      def ssl_enabled=: (bool) -> bool
-
-      attr_reader track_clicks: bool?
-
-      def track_clicks=: (bool) -> bool
-
-      attr_reader track_opens: bool?
-
-      def track_opens=: (bool) -> bool
+      attr_accessor track_opens: bool?
 
       def initialize: (
-        ?excluded_click_domains: String,
-        ?ssl_enabled: bool,
-        ?track_clicks: bool,
-        ?track_opens: bool,
+        ?excluded_click_domains: String?,
+        ?ssl_enabled: bool?,
+        ?track_clicks: bool?,
+        ?track_opens: bool?,
         ?request_options: ArkEmail::request_opts
       ) -> void
 
       def to_hash: -> {
-        excluded_click_domains: String,
-        ssl_enabled: bool,
-        track_clicks: bool,
-        track_opens: bool,
+        excluded_click_domains: String?,
+        ssl_enabled: bool?,
+        track_clicks: bool?,
+        track_opens: bool?,
         request_options: ArkEmail::RequestOptions
       }
     end

data/sig/ark_email/models/webhook_create_params.rbs

@@ -2,11 +2,11 @@ module ArkEmail
   module Models
     type webhook_create_params =
       {
-        events: ::Array[ArkEmail::Models::WebhookCreateParams::event],
         name: String,
         url: String,
-        all_events: bool,
-        enabled: bool
+        all_events: bool?,
+        enabled: bool?,
+        events: ::Array[ArkEmail::Models::WebhookCreateParams::event]?
       }
       & ArkEmail::Internal::Type::request_parameters
 
@@ -14,35 +14,31 @@ module ArkEmail
       extend ArkEmail::Internal::Type::RequestParameters::Converter
       include ArkEmail::Internal::Type::RequestParameters
 
-      attr_accessor events: ::Array[ArkEmail::Models::WebhookCreateParams::event]
-
       attr_accessor name: String
 
       attr_accessor url: String
 
-      attr_reader all_events: bool?
-
-      def all_events=: (bool) -> bool
+      attr_accessor all_events: bool?
 
-      attr_reader enabled: bool?
+      attr_accessor enabled: bool?
 
-      def enabled=: (bool) -> bool
+      attr_accessor events: ::Array[ArkEmail::Models::WebhookCreateParams::event]?
 
       def initialize: (
-        events: ::Array[ArkEmail::Models::WebhookCreateParams::event],
         name: String,
         url: String,
-        ?all_events: bool,
-        ?enabled: bool,
+        ?all_events: bool?,
+        ?enabled: bool?,
+        ?events: ::Array[ArkEmail::Models::WebhookCreateParams::event]?,
         ?request_options: ArkEmail::request_opts
       ) -> void
 
       def to_hash: -> {
-        events: ::Array[ArkEmail::Models::WebhookCreateParams::event],
         name: String,
         url: String,
-        all_events: bool,
-        enabled: bool,
+        all_events: bool?,
+        enabled: bool?,
+        events: ::Array[ArkEmail::Models::WebhookCreateParams::event]?,
         request_options: ArkEmail::RequestOptions
       }