trycourier 4.26.0 → 4.26.1

data/rbi/courier/models/bulk_run_job_params.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module Courier
+  module Models
+    class BulkRunJobParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Courier::BulkRunJobParams, Courier::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :job_id
+
+      sig do
+        params(
+          job_id: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(job_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          { job_id: String, request_options: Courier::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/inbound_bulk_message.rbi

@@ -0,0 +1,124 @@
+# typed: strong
+
+module Courier
+  module Models
+    class InboundBulkMessage < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::InboundBulkMessage, Courier::Internal::AnyHash)
+        end
+
+      # Event ID or Notification ID (required). Can be either a Notification ID (e.g.,
+      # "FRH3QXM9E34W4RKP7MRC8NZ1T8V8") or a custom Event ID (e.g., "welcome-email")
+      # mapped to a notification.
+      sig { returns(String) }
+      attr_accessor :event
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :brand
+
+      # Elemental content (optional, for V2 format). When provided, this will be used
+      # instead of the notification associated with the `event` field.
+      sig do
+        returns(
+          T.nilable(
+            T.any(Courier::ElementalContentSugar, Courier::ElementalContent)
+          )
+        )
+      end
+      attr_accessor :content
+
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_accessor :data
+
+      sig { returns(T.nilable(T::Hash[Symbol, T::Hash[Symbol, T.anything]])) }
+      attr_accessor :locale
+
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_accessor :override
+
+      # Notification ID or template ID (optional, for V2 format). When provided, this
+      # will be used instead of the notification associated with the `event` field.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :template
+
+      # Bulk message definition. Supports two formats:
+      #
+      # - V1 format: Requires `event` field (event ID or notification ID)
+      # - V2 format: Optionally use `template` (notification ID) or `content` (Elemental
+      #   content) in addition to `event`
+      sig do
+        params(
+          event: String,
+          brand: T.nilable(String),
+          content:
+            T.nilable(
+              T.any(
+                Courier::ElementalContentSugar::OrHash,
+                Courier::ElementalContent::OrHash
+              )
+            ),
+          data: T.nilable(T::Hash[Symbol, T.anything]),
+          locale: T.nilable(T::Hash[Symbol, T::Hash[Symbol, T.anything]]),
+          override: T.nilable(T::Hash[Symbol, T.anything]),
+          template: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Event ID or Notification ID (required). Can be either a Notification ID (e.g.,
+        # "FRH3QXM9E34W4RKP7MRC8NZ1T8V8") or a custom Event ID (e.g., "welcome-email")
+        # mapped to a notification.
+        event:,
+        brand: nil,
+        # Elemental content (optional, for V2 format). When provided, this will be used
+        # instead of the notification associated with the `event` field.
+        content: nil,
+        data: nil,
+        locale: nil,
+        override: nil,
+        # Notification ID or template ID (optional, for V2 format). When provided, this
+        # will be used instead of the notification associated with the `event` field.
+        template: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            event: String,
+            brand: T.nilable(String),
+            content:
+              T.nilable(
+                T.any(Courier::ElementalContentSugar, Courier::ElementalContent)
+              ),
+            data: T.nilable(T::Hash[Symbol, T.anything]),
+            locale: T.nilable(T::Hash[Symbol, T::Hash[Symbol, T.anything]]),
+            override: T.nilable(T::Hash[Symbol, T.anything]),
+            template: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Elemental content (optional, for V2 format). When provided, this will be used
+      # instead of the notification associated with the `event` field.
+      module Content
+        extend Courier::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(Courier::ElementalContentSugar, Courier::ElementalContent)
+          end
+
+        sig do
+          override.returns(
+            T::Array[Courier::InboundBulkMessage::Content::Variants]
+          )
+        end
+        def self.variants
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/inbound_bulk_message_user.rbi

@@ -0,0 +1,88 @@
+# typed: strong
+
+module Courier
+  module Models
+    class InboundBulkMessageUser < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::InboundBulkMessageUser, Courier::Internal::AnyHash)
+        end
+
+      # User-specific data that will be merged with message.data
+      sig { returns(T.nilable(T.anything)) }
+      attr_reader :data
+
+      sig { params(data: T.anything).void }
+      attr_writer :data
+
+      sig { returns(T.nilable(Courier::RecipientPreferences)) }
+      attr_reader :preferences
+
+      sig do
+        params(
+          preferences: T.nilable(Courier::RecipientPreferences::OrHash)
+        ).void
+      end
+      attr_writer :preferences
+
+      # User profile information. For email-based bulk jobs, `profile.email` is required
+      # for provider routing to determine if the message can be delivered. The email
+      # address should be provided here rather than in `to.email`.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_accessor :profile
+
+      # User ID (legacy field, use profile or to.user_id instead)
+      sig { returns(T.nilable(String)) }
+      attr_accessor :recipient
+
+      # Optional recipient information. Note: For email provider routing, use
+      # `profile.email` instead of `to.email`. The `to` field is primarily used for
+      # recipient identification and data merging.
+      sig { returns(T.nilable(Courier::UserRecipient)) }
+      attr_reader :to
+
+      sig { params(to: T.nilable(Courier::UserRecipient::OrHash)).void }
+      attr_writer :to
+
+      sig do
+        params(
+          data: T.anything,
+          preferences: T.nilable(Courier::RecipientPreferences::OrHash),
+          profile: T.nilable(T::Hash[Symbol, T.anything]),
+          recipient: T.nilable(String),
+          to: T.nilable(Courier::UserRecipient::OrHash)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # User-specific data that will be merged with message.data
+        data: nil,
+        preferences: nil,
+        # User profile information. For email-based bulk jobs, `profile.email` is required
+        # for provider routing to determine if the message can be delivered. The email
+        # address should be provided here rather than in `to.email`.
+        profile: nil,
+        # User ID (legacy field, use profile or to.user_id instead)
+        recipient: nil,
+        # Optional recipient information. Note: For email provider routing, use
+        # `profile.email` instead of `to.email`. The `to` field is primarily used for
+        # recipient identification and data merging.
+        to: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            data: T.anything,
+            preferences: T.nilable(Courier::RecipientPreferences),
+            profile: T.nilable(T::Hash[Symbol, T.anything]),
+            recipient: T.nilable(String),
+            to: T.nilable(Courier::UserRecipient)
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models.rbi

@@ -106,6 +106,16 @@ module Courier
 
   BroadcastUpdateParams = Courier::Models::BroadcastUpdateParams
 
+  BulkAddUsersParams = Courier::Models::BulkAddUsersParams
+
+  BulkCreateJobParams = Courier::Models::BulkCreateJobParams
+
+  BulkListUsersParams = Courier::Models::BulkListUsersParams
+
+  BulkRetrieveJobParams = Courier::Models::BulkRetrieveJobParams
+
+  BulkRunJobParams = Courier::Models::BulkRunJobParams
+
   CancelJourneyRequest = Courier::Models::CancelJourneyRequest
 
   CancelJourneyResponse = Courier::Models::CancelJourneyResponse
@@ -178,6 +188,10 @@ module Courier
 
   Icons = Courier::Models::Icons
 
+  InboundBulkMessage = Courier::Models::InboundBulkMessage
+
+  InboundBulkMessageUser = Courier::Models::InboundBulkMessageUser
+
   InboundTrackEventParams = Courier::Models::InboundTrackEventParams
 
   Intercom = Courier::Models::Intercom

data/rbi/courier/resources/bulk.rbi

@@ -0,0 +1,102 @@
+# typed: strong
+
+module Courier
+  module Resources
+    class Bulk
+      # Ingest user data into a Bulk Job.
+      #
+      # **Important**: For email-based bulk jobs, each user must include `profile.email`
+      # for provider routing to work correctly. The `to.email` field is not sufficient
+      # for email provider routing.
+      sig do
+        params(
+          job_id: String,
+          users: T::Array[Courier::InboundBulkMessageUser::OrHash],
+          request_options: Courier::RequestOptions::OrHash
+        ).void
+      end
+      def add_users(
+        # A unique identifier representing the bulk job
+        job_id,
+        users:,
+        request_options: {}
+      )
+      end
+
+      # Creates a new bulk job for sending messages to multiple recipients.
+      #
+      # **Required**: `message.event` (event ID or notification ID)
+      #
+      # **Optional (V2 format)**: `message.template` (notification ID) or
+      # `message.content` (Elemental content) can be provided to override the
+      # notification associated with the event.
+      sig do
+        params(
+          message: Courier::InboundBulkMessage::OrHash,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(Courier::Models::BulkCreateJobResponse)
+      end
+      def create_job(
+        # Bulk message definition. Supports two formats:
+        #
+        # - V1 format: Requires `event` field (event ID or notification ID)
+        # - V2 format: Optionally use `template` (notification ID) or `content` (Elemental
+        #   content) in addition to `event`
+        message:,
+        request_options: {}
+      )
+      end
+
+      # Get Bulk Job Users
+      sig do
+        params(
+          job_id: String,
+          cursor: T.nilable(String),
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(Courier::Models::BulkListUsersResponse)
+      end
+      def list_users(
+        # A unique identifier representing the bulk job
+        job_id,
+        # A unique identifier that allows for fetching the next set of users added to the
+        # bulk job
+        cursor: nil,
+        request_options: {}
+      )
+      end
+
+      # Get a bulk job
+      sig do
+        params(
+          job_id: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(Courier::Models::BulkRetrieveJobResponse)
+      end
+      def retrieve_job(
+        # A unique identifier representing the bulk job
+        job_id,
+        request_options: {}
+      )
+      end
+
+      # Run a bulk job
+      sig do
+        params(
+          job_id: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).void
+      end
+      def run_job(
+        # A unique identifier representing the bulk job
+        job_id,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Courier::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/courier/resources/send.rbi

@@ -6,7 +6,8 @@ module Courier
     # across every channel you have configured.
     class Send
       # Sends a message to one or more recipients and returns a requestId. Courier
-      # routes it to email, SMS, push, chat, or in-app based on your rules.
+      # routes it to email, SMS, push, chat, or in-app based on your rules. Use the
+      # returned requestId to look up delivery status via the Messages API.
       sig do
         params(
           message: Courier::SendMessageParams::Message::OrHash,

data/sig/courier/client.rbs

@@ -26,6 +26,8 @@ module Courier
 
     attr_reader broadcasts: Courier::Resources::Broadcasts
 
+    attr_reader bulk: Courier::Resources::Bulk
+
     attr_reader brands: Courier::Resources::Brands
 
     attr_reader digests: Courier::Resources::Digests

data/sig/courier/models/bulk_add_users_params.rbs

@@ -0,0 +1,28 @@
+module Courier
+  module Models
+    type bulk_add_users_params =
+      { job_id: String, users: ::Array[Courier::InboundBulkMessageUser] }
+      & Courier::Internal::Type::request_parameters
+
+    class BulkAddUsersParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      attr_accessor job_id: String
+
+      attr_accessor users: ::Array[Courier::InboundBulkMessageUser]
+
+      def initialize: (
+        job_id: String,
+        users: ::Array[Courier::InboundBulkMessageUser],
+        ?request_options: Courier::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        job_id: String,
+        users: ::Array[Courier::InboundBulkMessageUser],
+        request_options: Courier::RequestOptions
+      }
+    end
+  end
+end

data/sig/courier/models/bulk_create_job_params.rbs

@@ -0,0 +1,24 @@
+module Courier
+  module Models
+    type bulk_create_job_params =
+      { message: Courier::InboundBulkMessage }
+      & Courier::Internal::Type::request_parameters
+
+    class BulkCreateJobParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      attr_accessor message: Courier::InboundBulkMessage
+
+      def initialize: (
+        message: Courier::InboundBulkMessage,
+        ?request_options: Courier::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        message: Courier::InboundBulkMessage,
+        request_options: Courier::RequestOptions
+      }
+    end
+  end
+end

data/sig/courier/models/bulk_create_job_response.rbs

@@ -0,0 +1,13 @@
+module Courier
+  module Models
+    type bulk_create_job_response = { job_id: String }
+
+    class BulkCreateJobResponse < Courier::Internal::Type::BaseModel
+      attr_accessor job_id: String
+
+      def initialize: (job_id: String) -> void
+
+      def to_hash: -> { job_id: String }
+    end
+  end
+end

data/sig/courier/models/bulk_list_users_params.rbs

@@ -0,0 +1,28 @@
+module Courier
+  module Models
+    type bulk_list_users_params =
+      { job_id: String, cursor: String? }
+      & Courier::Internal::Type::request_parameters
+
+    class BulkListUsersParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      attr_accessor job_id: String
+
+      attr_accessor cursor: String?
+
+      def initialize: (
+        job_id: String,
+        ?cursor: String?,
+        ?request_options: Courier::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        job_id: String,
+        cursor: String?,
+        request_options: Courier::RequestOptions
+      }
+    end
+  end
+end

data/sig/courier/models/bulk_list_users_response.rbs

@@ -0,0 +1,65 @@
+module Courier
+  module Models
+    type bulk_list_users_response =
+      {
+        items: ::Array[Courier::Models::BulkListUsersResponse::Item],
+        paging: Courier::Paging
+      }
+
+    class BulkListUsersResponse < Courier::Internal::Type::BaseModel
+      attr_accessor items: ::Array[Courier::Models::BulkListUsersResponse::Item]
+
+      attr_accessor paging: Courier::Paging
+
+      def initialize: (
+        items: ::Array[Courier::Models::BulkListUsersResponse::Item],
+        paging: Courier::Paging
+      ) -> void
+
+      def to_hash: -> {
+        items: ::Array[Courier::Models::BulkListUsersResponse::Item],
+        paging: Courier::Paging
+      }
+
+      type item =
+        {
+          status: Courier::Models::BulkListUsersResponse::Item::status,
+          message_id: String?
+        }
+
+      class Item < Courier::Models::InboundBulkMessageUser
+        def status: -> Courier::Models::BulkListUsersResponse::Item::status
+
+        def status=: (
+          Courier::Models::BulkListUsersResponse::Item::status _
+        ) -> Courier::Models::BulkListUsersResponse::Item::status
+
+        def message_id: -> String?
+
+        def message_id=: (String? _) -> String?
+
+        def initialize: (
+          status: Courier::Models::BulkListUsersResponse::Item::status,
+          ?message_id: String?
+        ) -> void
+
+        def to_hash: -> {
+          status: Courier::Models::BulkListUsersResponse::Item::status,
+          message_id: String?
+        }
+
+        type status = :PENDING | :ENQUEUED | :ERROR
+
+        module Status
+          extend Courier::Internal::Type::Enum
+
+          PENDING: :PENDING
+          ENQUEUED: :ENQUEUED
+          ERROR: :ERROR
+
+          def self?.values: -> ::Array[Courier::Models::BulkListUsersResponse::Item::status]
+        end
+      end
+    end
+  end
+end

data/sig/courier/models/bulk_retrieve_job_params.rbs

@@ -0,0 +1,23 @@
+module Courier
+  module Models
+    type bulk_retrieve_job_params =
+      { job_id: String } & Courier::Internal::Type::request_parameters
+
+    class BulkRetrieveJobParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      attr_accessor job_id: String
+
+      def initialize: (
+        job_id: String,
+        ?request_options: Courier::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        job_id: String,
+        request_options: Courier::RequestOptions
+      }
+    end
+  end
+end

data/sig/courier/models/bulk_retrieve_job_response.rbs

@@ -0,0 +1,66 @@
+module Courier
+  module Models
+    type bulk_retrieve_job_response =
+      { job: Courier::Models::BulkRetrieveJobResponse::Job }
+
+    class BulkRetrieveJobResponse < Courier::Internal::Type::BaseModel
+      attr_accessor job: Courier::Models::BulkRetrieveJobResponse::Job
+
+      def initialize: (
+        job: Courier::Models::BulkRetrieveJobResponse::Job
+      ) -> void
+
+      def to_hash: -> { job: Courier::Models::BulkRetrieveJobResponse::Job }
+
+      type job =
+        {
+          definition: Courier::InboundBulkMessage,
+          enqueued: Integer,
+          failures: Integer,
+          received: Integer,
+          status: Courier::Models::BulkRetrieveJobResponse::Job::status
+        }
+
+      class Job < Courier::Internal::Type::BaseModel
+        attr_accessor definition: Courier::InboundBulkMessage
+
+        attr_accessor enqueued: Integer
+
+        attr_accessor failures: Integer
+
+        attr_accessor received: Integer
+
+        attr_accessor status: Courier::Models::BulkRetrieveJobResponse::Job::status
+
+        def initialize: (
+          definition: Courier::InboundBulkMessage,
+          enqueued: Integer,
+          failures: Integer,
+          received: Integer,
+          status: Courier::Models::BulkRetrieveJobResponse::Job::status
+        ) -> void
+
+        def to_hash: -> {
+          definition: Courier::InboundBulkMessage,
+          enqueued: Integer,
+          failures: Integer,
+          received: Integer,
+          status: Courier::Models::BulkRetrieveJobResponse::Job::status
+        }
+
+        type status = :CREATED | :PROCESSING | :COMPLETED | :ERROR
+
+        module Status
+          extend Courier::Internal::Type::Enum
+
+          CREATED: :CREATED
+          PROCESSING: :PROCESSING
+          COMPLETED: :COMPLETED
+          ERROR: :ERROR
+
+          def self?.values: -> ::Array[Courier::Models::BulkRetrieveJobResponse::Job::status]
+        end
+      end
+    end
+  end
+end

data/sig/courier/models/bulk_run_job_params.rbs

@@ -0,0 +1,23 @@
+module Courier
+  module Models
+    type bulk_run_job_params =
+      { job_id: String } & Courier::Internal::Type::request_parameters
+
+    class BulkRunJobParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      attr_accessor job_id: String
+
+      def initialize: (
+        job_id: String,
+        ?request_options: Courier::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        job_id: String,
+        request_options: Courier::RequestOptions
+      }
+    end
+  end
+end