trycourier 4.2.0 → 4.4.0

data/rbi/trycourier/models/users/token_list_response.rbi

@@ -3,11 +3,33 @@
 module Trycourier
   module Models
     module Users
-      TokenListResponse =
-        T.let(
-          Trycourier::Internal::Type::ArrayOf[Trycourier::Users::UserToken],
-          Trycourier::Internal::Type::Converter
-        )
+      class TokenListResponse < Trycourier::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Trycourier::Models::Users::TokenListResponse,
+              Trycourier::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T::Array[Trycourier::Users::UserToken]) }
+        attr_accessor :tokens
+
+        # A list of tokens registered with the user.
+        sig do
+          params(
+            tokens: T::Array[Trycourier::Users::UserToken::OrHash]
+          ).returns(T.attached_class)
+        end
+        def self.new(tokens:)
+        end
+
+        sig do
+          override.returns({ tokens: T::Array[Trycourier::Users::UserToken] })
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/trycourier/models.rbi

@@ -174,8 +174,6 @@ module Trycourier
 
   ProfileDeleteParams = Trycourier::Models::ProfileDeleteParams
 
-  ProfilePreferences = Trycourier::Models::ProfilePreferences
-
   ProfileReplaceParams = Trycourier::Models::ProfileReplaceParams
 
   ProfileRetrieveParams = Trycourier::Models::ProfileRetrieveParams

data/rbi/trycourier/resources/bulk.rbi

@@ -3,7 +3,11 @@
 module Trycourier
   module Resources
     class Bulk
-      # Ingest user data into a Bulk Job
+      # 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,
@@ -19,18 +23,28 @@ module Trycourier
       )
       end
 
-      # Create a bulk job
+      # 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:
-            T.any(
-              Trycourier::InboundBulkMessage::InboundBulkTemplateMessage::OrHash,
-              Trycourier::InboundBulkMessage::InboundBulkContentMessage::OrHash
-            ),
+          message: Trycourier::InboundBulkMessage::OrHash,
           request_options: Trycourier::RequestOptions::OrHash
         ).returns(Trycourier::Models::BulkCreateJobResponse)
       end
-      def create_job(message:, request_options: {})
+      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

data/rbi/trycourier/resources/users/tokens.rbi

@@ -47,7 +47,7 @@ module Trycourier
           params(
             user_id: String,
             request_options: Trycourier::RequestOptions::OrHash
-          ).returns(T::Array[Trycourier::Users::UserToken])
+          ).returns(Trycourier::Models::Users::TokenListResponse)
         end
         def list(
           # The user's ID. This can be any uniquely identifiable string.

data/sig/trycourier/models/bulk_create_job_params.rbs

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

data/sig/trycourier/models/bulk_retrieve_job_response.rbs

@@ -14,7 +14,7 @@ module Trycourier
 
       type job =
         {
-          definition: Trycourier::Models::inbound_bulk_message,
+          definition: Trycourier::InboundBulkMessage,
           enqueued: Integer,
           failures: Integer,
           received: Integer,
@@ -22,7 +22,7 @@ module Trycourier
         }
 
       class Job < Trycourier::Internal::Type::BaseModel
-        attr_accessor definition: Trycourier::Models::inbound_bulk_message
+        attr_accessor definition: Trycourier::InboundBulkMessage
 
         attr_accessor enqueued: Integer
 
@@ -33,7 +33,7 @@ module Trycourier
         attr_accessor status: Trycourier::Models::BulkRetrieveJobResponse::Job::status
 
         def initialize: (
-          definition: Trycourier::Models::inbound_bulk_message,
+          definition: Trycourier::InboundBulkMessage,
           enqueued: Integer,
           failures: Integer,
           received: Integer,
@@ -41,7 +41,7 @@ module Trycourier
         ) -> void
 
         def to_hash: -> {
-          definition: Trycourier::Models::inbound_bulk_message,
+          definition: Trycourier::InboundBulkMessage,
           enqueued: Integer,
           failures: Integer,
           received: Integer,

data/sig/trycourier/models/inbound_bulk_message.rbs

@@ -1,106 +1,59 @@
 module Trycourier
   module Models
     type inbound_bulk_message =
-      Trycourier::InboundBulkMessage::InboundBulkTemplateMessage
-      | Trycourier::InboundBulkMessage::InboundBulkContentMessage
-
-    module InboundBulkMessage
-      extend Trycourier::Internal::Type::Union
-
-      type inbound_bulk_template_message =
-        {
-          template: String,
-          brand: String?,
-          data: ::Hash[Symbol, top]?,
-          event: String?,
-          locale: ::Hash[Symbol, ::Hash[Symbol, top]]?,
-          override: ::Hash[Symbol, top]?
-        }
-
-      class InboundBulkTemplateMessage < Trycourier::Internal::Type::BaseModel
-        attr_accessor template: String
-
-        attr_accessor brand: String?
-
-        attr_accessor data: ::Hash[Symbol, top]?
-
-        attr_accessor event: String?
-
-        attr_accessor locale: ::Hash[Symbol, ::Hash[Symbol, top]]?
-
-        attr_accessor override: ::Hash[Symbol, top]?
-
-        def initialize: (
-          template: String,
-          ?brand: String?,
-          ?data: ::Hash[Symbol, top]?,
-          ?event: String?,
-          ?locale: ::Hash[Symbol, ::Hash[Symbol, top]]?,
-          ?override: ::Hash[Symbol, top]?
-        ) -> void
-
-        def to_hash: -> {
-          template: String,
-          brand: String?,
-          data: ::Hash[Symbol, top]?,
-          event: String?,
-          locale: ::Hash[Symbol, ::Hash[Symbol, top]]?,
-          override: ::Hash[Symbol, top]?
-        }
-      end
-
-      type inbound_bulk_content_message =
-        {
-          content: Trycourier::Models::InboundBulkMessage::InboundBulkContentMessage::content,
-          brand: String?,
-          data: ::Hash[Symbol, top]?,
-          event: String?,
-          locale: ::Hash[Symbol, ::Hash[Symbol, top]]?,
-          override: ::Hash[Symbol, top]?
-        }
-
-      class InboundBulkContentMessage < Trycourier::Internal::Type::BaseModel
-        attr_accessor content: Trycourier::Models::InboundBulkMessage::InboundBulkContentMessage::content
-
-        attr_accessor brand: String?
-
-        attr_accessor data: ::Hash[Symbol, top]?
-
-        attr_accessor event: String?
-
-        attr_accessor locale: ::Hash[Symbol, ::Hash[Symbol, top]]?
-
-        attr_accessor override: ::Hash[Symbol, top]?
-
-        def initialize: (
-          content: Trycourier::Models::InboundBulkMessage::InboundBulkContentMessage::content,
-          ?brand: String?,
-          ?data: ::Hash[Symbol, top]?,
-          ?event: String?,
-          ?locale: ::Hash[Symbol, ::Hash[Symbol, top]]?,
-          ?override: ::Hash[Symbol, top]?
-        ) -> void
-
-        def to_hash: -> {
-          content: Trycourier::Models::InboundBulkMessage::InboundBulkContentMessage::content,
-          brand: String?,
-          data: ::Hash[Symbol, top]?,
-          event: String?,
-          locale: ::Hash[Symbol, ::Hash[Symbol, top]]?,
-          override: ::Hash[Symbol, top]?
-        }
-
-        type content =
-          Trycourier::ElementalContentSugar | Trycourier::ElementalContent
-
-        module Content
-          extend Trycourier::Internal::Type::Union
-
-          def self?.variants: -> ::Array[Trycourier::Models::InboundBulkMessage::InboundBulkContentMessage::content]
-        end
+      {
+        event: String,
+        brand: String?,
+        content: Trycourier::Models::InboundBulkMessage::content?,
+        data: ::Hash[Symbol, top]?,
+        locale: ::Hash[Symbol, ::Hash[Symbol, top]]?,
+        override: ::Hash[Symbol, top]?,
+        template: String?
+      }
+
+    class InboundBulkMessage < Trycourier::Internal::Type::BaseModel
+      attr_accessor event: String
+
+      attr_accessor brand: String?
+
+      attr_accessor content: Trycourier::Models::InboundBulkMessage::content?
+
+      attr_accessor data: ::Hash[Symbol, top]?
+
+      attr_accessor locale: ::Hash[Symbol, ::Hash[Symbol, top]]?
+
+      attr_accessor override: ::Hash[Symbol, top]?
+
+      attr_accessor template: String?
+
+      def initialize: (
+        event: String,
+        ?brand: String?,
+        ?content: Trycourier::Models::InboundBulkMessage::content?,
+        ?data: ::Hash[Symbol, top]?,
+        ?locale: ::Hash[Symbol, ::Hash[Symbol, top]]?,
+        ?override: ::Hash[Symbol, top]?,
+        ?template: String?
+      ) -> void
+
+      def to_hash: -> {
+        event: String,
+        brand: String?,
+        content: Trycourier::Models::InboundBulkMessage::content?,
+        data: ::Hash[Symbol, top]?,
+        locale: ::Hash[Symbol, ::Hash[Symbol, top]]?,
+        override: ::Hash[Symbol, top]?,
+        template: String?
+      }
+
+      type content =
+        Trycourier::ElementalContentSugar | Trycourier::ElementalContent
+
+      module Content
+        extend Trycourier::Internal::Type::Union
+
+        def self?.variants: -> ::Array[Trycourier::Models::InboundBulkMessage::content]
       end
-
-      def self?.variants: -> ::Array[Trycourier::Models::inbound_bulk_message]
     end
   end
 end

data/sig/trycourier/models/inbound_bulk_message_user.rbs

@@ -4,7 +4,7 @@ module Trycourier
       {
         data: top,
         preferences: Trycourier::RecipientPreferences?,
-        profile: top,
+        profile: ::Hash[Symbol, top]?,
         recipient: String?,
         to: Trycourier::UserRecipient?
       }
@@ -16,9 +16,7 @@ module Trycourier
 
       attr_accessor preferences: Trycourier::RecipientPreferences?
 
-      attr_reader profile: top?
-
-      def profile=: (top) -> top
+      attr_accessor profile: ::Hash[Symbol, top]?
 
       attr_accessor recipient: String?
 
@@ -27,7 +25,7 @@ module Trycourier
       def initialize: (
         ?data: top,
         ?preferences: Trycourier::RecipientPreferences?,
-        ?profile: top,
+        ?profile: ::Hash[Symbol, top]?,
         ?recipient: String?,
         ?to: Trycourier::UserRecipient?
       ) -> void
@@ -35,7 +33,7 @@ module Trycourier
       def to_hash: -> {
         data: top,
         preferences: Trycourier::RecipientPreferences?,
-        profile: top,
+        profile: ::Hash[Symbol, top]?,
         recipient: String?,
         to: Trycourier::UserRecipient?
       }

data/sig/trycourier/models/recipient.rbs

@@ -9,7 +9,7 @@ module Trycourier
         list_id: String?,
         locale: String?,
         phone_number: String?,
-        preferences: Trycourier::ProfilePreferences?,
+        preferences: Trycourier::Recipient::Preferences?,
         tenant_id: String?,
         user_id: String?
       }
@@ -29,7 +29,7 @@ module Trycourier
 
       attr_accessor phone_number: String?
 
-      attr_accessor preferences: Trycourier::ProfilePreferences?
+      attr_accessor preferences: Trycourier::Recipient::Preferences?
 
       attr_accessor tenant_id: String?
 
@@ -43,7 +43,7 @@ module Trycourier
         ?list_id: String?,
         ?locale: String?,
         ?phone_number: String?,
-        ?preferences: Trycourier::ProfilePreferences?,
+        ?preferences: Trycourier::Recipient::Preferences?,
         ?tenant_id: String?,
         ?user_id: String?
       ) -> void
@@ -56,10 +56,37 @@ module Trycourier
         list_id: String?,
         locale: String?,
         phone_number: String?,
-        preferences: Trycourier::ProfilePreferences?,
+        preferences: Trycourier::Recipient::Preferences?,
         tenant_id: String?,
         user_id: String?
       }
+
+      type preferences =
+        {
+          notifications: ::Hash[Symbol, Trycourier::Preference],
+          categories: ::Hash[Symbol, Trycourier::Preference]?,
+          template_id: String?
+        }
+
+      class Preferences < Trycourier::Internal::Type::BaseModel
+        attr_accessor notifications: ::Hash[Symbol, Trycourier::Preference]
+
+        attr_accessor categories: ::Hash[Symbol, Trycourier::Preference]?
+
+        attr_accessor template_id: String?
+
+        def initialize: (
+          notifications: ::Hash[Symbol, Trycourier::Preference],
+          ?categories: ::Hash[Symbol, Trycourier::Preference]?,
+          ?template_id: String?
+        ) -> void
+
+        def to_hash: -> {
+          notifications: ::Hash[Symbol, Trycourier::Preference],
+          categories: ::Hash[Symbol, Trycourier::Preference]?,
+          template_id: String?
+        }
+      end
     end
   end
 end

data/sig/trycourier/models/send_message_params.rbs

@@ -194,16 +194,26 @@ module Trycourier
           def self?.variants: -> ::Array[Trycourier::Models::SendMessageParams::Message::content]
         end
 
-        type delay = { duration: Integer?, until_: String? }
+        type delay = { duration: Integer?, timezone: String?, until_: String? }
 
         class Delay < Trycourier::Internal::Type::BaseModel
           attr_accessor duration: Integer?
 
+          attr_accessor timezone: String?
+
           attr_accessor until_: String?
 
-          def initialize: (?duration: Integer?, ?until_: String?) -> void
+          def initialize: (
+            ?duration: Integer?,
+            ?timezone: String?,
+            ?until_: String?
+          ) -> void
 
-          def to_hash: -> { duration: Integer?, until_: String? }
+          def to_hash: -> {
+            duration: Integer?,
+            timezone: String?,
+            until_: String?
+          }
         end
 
         type expiry =

data/sig/trycourier/models/user_recipient.rbs

@@ -9,7 +9,7 @@ module Trycourier
         list_id: String?,
         locale: String?,
         phone_number: String?,
-        preferences: Trycourier::ProfilePreferences?,
+        preferences: Trycourier::UserRecipient::Preferences?,
         tenant_id: String?,
         user_id: String?
       }
@@ -29,7 +29,7 @@ module Trycourier
 
       attr_accessor phone_number: String?
 
-      attr_accessor preferences: Trycourier::ProfilePreferences?
+      attr_accessor preferences: Trycourier::UserRecipient::Preferences?
 
       attr_accessor tenant_id: String?
 
@@ -43,7 +43,7 @@ module Trycourier
         ?list_id: String?,
         ?locale: String?,
         ?phone_number: String?,
-        ?preferences: Trycourier::ProfilePreferences?,
+        ?preferences: Trycourier::UserRecipient::Preferences?,
         ?tenant_id: String?,
         ?user_id: String?
       ) -> void
@@ -56,10 +56,37 @@ module Trycourier
         list_id: String?,
         locale: String?,
         phone_number: String?,
-        preferences: Trycourier::ProfilePreferences?,
+        preferences: Trycourier::UserRecipient::Preferences?,
         tenant_id: String?,
         user_id: String?
       }
+
+      type preferences =
+        {
+          notifications: ::Hash[Symbol, Trycourier::Preference],
+          categories: ::Hash[Symbol, Trycourier::Preference]?,
+          template_id: String?
+        }
+
+      class Preferences < Trycourier::Internal::Type::BaseModel
+        attr_accessor notifications: ::Hash[Symbol, Trycourier::Preference]
+
+        attr_accessor categories: ::Hash[Symbol, Trycourier::Preference]?
+
+        attr_accessor template_id: String?
+
+        def initialize: (
+          notifications: ::Hash[Symbol, Trycourier::Preference],
+          ?categories: ::Hash[Symbol, Trycourier::Preference]?,
+          ?template_id: String?
+        ) -> void
+
+        def to_hash: -> {
+          notifications: ::Hash[Symbol, Trycourier::Preference],
+          categories: ::Hash[Symbol, Trycourier::Preference]?,
+          template_id: String?
+        }
+      end
     end
   end
 end

data/sig/trycourier/models/users/token_list_response.rbs

@@ -1,9 +1,16 @@
 module Trycourier
   module Models
     module Users
-      type token_list_response = ::Array[Trycourier::Users::UserToken]
+      type token_list_response =
+        { tokens: ::Array[Trycourier::Users::UserToken] }
 
-      TokenListResponse: Trycourier::Internal::Type::Converter
+      class TokenListResponse < Trycourier::Internal::Type::BaseModel
+        attr_accessor tokens: ::Array[Trycourier::Users::UserToken]
+
+        def initialize: (tokens: ::Array[Trycourier::Users::UserToken]) -> void
+
+        def to_hash: -> { tokens: ::Array[Trycourier::Users::UserToken] }
+      end
     end
   end
 end

data/sig/trycourier/models.rbs

@@ -109,7 +109,7 @@ module Trycourier
 
   class Icons = Trycourier::Models::Icons
 
-  module InboundBulkMessage = Trycourier::Models::InboundBulkMessage
+  class InboundBulkMessage = Trycourier::Models::InboundBulkMessage
 
   class InboundBulkMessageUser = Trycourier::Models::InboundBulkMessageUser
 
@@ -167,8 +167,6 @@ module Trycourier
 
   class ProfileDeleteParams = Trycourier::Models::ProfileDeleteParams
 
-  class ProfilePreferences = Trycourier::Models::ProfilePreferences
-
   class ProfileReplaceParams = Trycourier::Models::ProfileReplaceParams
 
   class ProfileRetrieveParams = Trycourier::Models::ProfileRetrieveParams

data/sig/trycourier/resources/bulk.rbs

@@ -8,7 +8,7 @@ module Trycourier
       ) -> nil
 
       def create_job: (
-        message: Trycourier::Models::inbound_bulk_message,
+        message: Trycourier::InboundBulkMessage,
         ?request_options: Trycourier::request_opts
       ) -> Trycourier::Models::BulkCreateJobResponse
 

data/sig/trycourier/resources/users/tokens.rbs

@@ -18,7 +18,7 @@ module Trycourier
         def list: (
           String user_id,
           ?request_options: Trycourier::request_opts
-        ) -> Trycourier::Models::Users::token_list_response
+        ) -> Trycourier::Models::Users::TokenListResponse
 
         def delete: (
           String token,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trycourier
 version: !ruby/object:Gem::Version
-  version: 4.2.0
+  version: 4.4.0
 platform: ruby
 authors:
 - Courier
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-08 00:00:00.000000000 Z
+date: 2025-12-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -167,7 +167,6 @@ files:
 - lib/trycourier/models/profile_create_params.rb
 - lib/trycourier/models/profile_create_response.rb
 - lib/trycourier/models/profile_delete_params.rb
-- lib/trycourier/models/profile_preferences.rb
 - lib/trycourier/models/profile_replace_params.rb
 - lib/trycourier/models/profile_replace_response.rb
 - lib/trycourier/models/profile_retrieve_params.rb
@@ -393,7 +392,6 @@ files:
 - rbi/trycourier/models/profile_create_params.rbi
 - rbi/trycourier/models/profile_create_response.rbi
 - rbi/trycourier/models/profile_delete_params.rbi
-- rbi/trycourier/models/profile_preferences.rbi
 - rbi/trycourier/models/profile_replace_params.rbi
 - rbi/trycourier/models/profile_replace_response.rbi
 - rbi/trycourier/models/profile_retrieve_params.rbi
@@ -618,7 +616,6 @@ files:
 - sig/trycourier/models/profile_create_params.rbs
 - sig/trycourier/models/profile_create_response.rbs
 - sig/trycourier/models/profile_delete_params.rbs
-- sig/trycourier/models/profile_preferences.rbs
 - sig/trycourier/models/profile_replace_params.rbs
 - sig/trycourier/models/profile_replace_response.rbs
 - sig/trycourier/models/profile_retrieve_params.rbs

data/lib/trycourier/models/profile_preferences.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-module Trycourier
-  module Models
-    class ProfilePreferences < Trycourier::Internal::Type::BaseModel
-      # @!attribute notifications
-      #
-      #   @return [Hash{Symbol=>Trycourier::Models::Preference}]
-      required :notifications, -> { Trycourier::Internal::Type::HashOf[Trycourier::Preference] }
-
-      # @!attribute categories
-      #
-      #   @return [Hash{Symbol=>Trycourier::Models::Preference}, nil]
-      optional :categories, -> { Trycourier::Internal::Type::HashOf[Trycourier::Preference] }, nil?: true
-
-      # @!attribute template_id
-      #
-      #   @return [String, nil]
-      optional :template_id, String, api_name: :templateId, nil?: true
-
-      # @!method initialize(notifications:, categories: nil, template_id: nil)
-      #   @param notifications [Hash{Symbol=>Trycourier::Models::Preference}]
-      #   @param categories [Hash{Symbol=>Trycourier::Models::Preference}, nil]
-      #   @param template_id [String, nil]
-    end
-  end
-end