trycourier 6.4.3 → 6.5.0

data/rbi/courier/models/email_footer.rbi

@@ -6,28 +6,250 @@ module Courier
       OrHash =
         T.type_alias { T.any(Courier::EmailFooter, Courier::Internal::AnyHash) }
 
-      sig { returns(T.nilable(String)) }
-      attr_accessor :content
-
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :inherit_default
 
+      # The footer body, as markdown. This is the field the API returns and accepts; it
+      # is omitted entirely when no footer body is set. Sending null is accepted and
+      # treated as no footer body.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :markdown
+
+      # Social links rendered in the email footer.
+      sig { returns(T.nilable(Courier::EmailFooter::Social)) }
+      attr_reader :social
+
+      sig do
+        params(social: T.nilable(Courier::EmailFooter::Social::OrHash)).void
+      end
+      attr_writer :social
+
       sig do
         params(
-          content: T.nilable(String),
-          inherit_default: T.nilable(T::Boolean)
+          inherit_default: T.nilable(T::Boolean),
+          markdown: T.nilable(String),
+          social: T.nilable(Courier::EmailFooter::Social::OrHash)
         ).returns(T.attached_class)
       end
-      def self.new(content: nil, inherit_default: nil)
+      def self.new(
+        inherit_default: nil,
+        # The footer body, as markdown. This is the field the API returns and accepts; it
+        # is omitted entirely when no footer body is set. Sending null is accepted and
+        # treated as no footer body.
+        markdown: nil,
+        # Social links rendered in the email footer.
+        social: nil
+      )
       end
 
       sig do
         override.returns(
-          { content: T.nilable(String), inherit_default: T.nilable(T::Boolean) }
+          {
+            inherit_default: T.nilable(T::Boolean),
+            markdown: T.nilable(String),
+            social: T.nilable(Courier::EmailFooter::Social)
+          }
         )
       end
       def to_hash
       end
+
+      class Social < Courier::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Courier::EmailFooter::Social, Courier::Internal::AnyHash)
+          end
+
+        sig { returns(T.nilable(Courier::EmailFooter::Social::Facebook)) }
+        attr_reader :facebook
+
+        sig do
+          params(
+            facebook: T.nilable(Courier::EmailFooter::Social::Facebook::OrHash)
+          ).void
+        end
+        attr_writer :facebook
+
+        sig { returns(T.nilable(Courier::EmailFooter::Social::Instagram)) }
+        attr_reader :instagram
+
+        sig do
+          params(
+            instagram:
+              T.nilable(Courier::EmailFooter::Social::Instagram::OrHash)
+          ).void
+        end
+        attr_writer :instagram
+
+        sig { returns(T.nilable(Courier::EmailFooter::Social::Linkedin)) }
+        attr_reader :linkedin
+
+        sig do
+          params(
+            linkedin: T.nilable(Courier::EmailFooter::Social::Linkedin::OrHash)
+          ).void
+        end
+        attr_writer :linkedin
+
+        sig { returns(T.nilable(Courier::EmailFooter::Social::Medium)) }
+        attr_reader :medium
+
+        sig do
+          params(
+            medium: T.nilable(Courier::EmailFooter::Social::Medium::OrHash)
+          ).void
+        end
+        attr_writer :medium
+
+        sig { returns(T.nilable(Courier::EmailFooter::Social::Twitter)) }
+        attr_reader :twitter
+
+        sig do
+          params(
+            twitter: T.nilable(Courier::EmailFooter::Social::Twitter::OrHash)
+          ).void
+        end
+        attr_writer :twitter
+
+        # Social links rendered in the email footer.
+        sig do
+          params(
+            facebook: T.nilable(Courier::EmailFooter::Social::Facebook::OrHash),
+            instagram:
+              T.nilable(Courier::EmailFooter::Social::Instagram::OrHash),
+            linkedin: T.nilable(Courier::EmailFooter::Social::Linkedin::OrHash),
+            medium: T.nilable(Courier::EmailFooter::Social::Medium::OrHash),
+            twitter: T.nilable(Courier::EmailFooter::Social::Twitter::OrHash)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          facebook: nil,
+          instagram: nil,
+          linkedin: nil,
+          medium: nil,
+          twitter: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              facebook: T.nilable(Courier::EmailFooter::Social::Facebook),
+              instagram: T.nilable(Courier::EmailFooter::Social::Instagram),
+              linkedin: T.nilable(Courier::EmailFooter::Social::Linkedin),
+              medium: T.nilable(Courier::EmailFooter::Social::Medium),
+              twitter: T.nilable(Courier::EmailFooter::Social::Twitter)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Facebook < Courier::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::EmailFooter::Social::Facebook,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(String)) }
+          attr_accessor :url
+
+          sig { params(url: T.nilable(String)).returns(T.attached_class) }
+          def self.new(url: nil)
+          end
+
+          sig { override.returns({ url: T.nilable(String) }) }
+          def to_hash
+          end
+        end
+
+        class Instagram < Courier::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::EmailFooter::Social::Instagram,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(String)) }
+          attr_accessor :url
+
+          sig { params(url: T.nilable(String)).returns(T.attached_class) }
+          def self.new(url: nil)
+          end
+
+          sig { override.returns({ url: T.nilable(String) }) }
+          def to_hash
+          end
+        end
+
+        class Linkedin < Courier::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::EmailFooter::Social::Linkedin,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(String)) }
+          attr_accessor :url
+
+          sig { params(url: T.nilable(String)).returns(T.attached_class) }
+          def self.new(url: nil)
+          end
+
+          sig { override.returns({ url: T.nilable(String) }) }
+          def to_hash
+          end
+        end
+
+        class Medium < Courier::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::EmailFooter::Social::Medium,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(String)) }
+          attr_accessor :url
+
+          sig { params(url: T.nilable(String)).returns(T.attached_class) }
+          def self.new(url: nil)
+          end
+
+          sig { override.returns({ url: T.nilable(String) }) }
+          def to_hash
+          end
+        end
+
+        class Twitter < Courier::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::EmailFooter::Social::Twitter,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(String)) }
+          attr_accessor :url
+
+          sig { params(url: T.nilable(String)).returns(T.attached_class) }
+          def self.new(url: nil)
+          end
+
+          sig { override.returns({ url: T.nilable(String) }) }
+          def to_hash
+          end
+        end
+      end
     end
   end
 end

data/rbi/courier/models/notification_template_update_request.rbi

@@ -39,9 +39,12 @@ module Courier
       end
       attr_writer :state
 
-      # Request body for replacing a notification template. Same shape as create. All
-      # fields required (PUT = full replacement), except `alias`, whose omission means
-      # "leave the existing aliases alone".
+      # Request body for replacing a notification template. All fields are required,
+      # since `PUT` is a full replacement, except `alias`, whose omission leaves the
+      # existing aliases in place. Unlike `NotificationTemplateCreateRequest`,
+      # `notification.content` is not required to place its elements inside a channel
+      # block: the requirement applies to creation only, so templates already stored
+      # without one stay editable.
       sig do
         params(
           notification: Courier::NotificationTemplateWritePayload::OrHash,

data/rbi/courier/models/users/token_add_single_params.rbi

@@ -38,8 +38,12 @@ module Courier
         end
         attr_writer :device
 
-        # ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
-        # disable expiration.
+        # When the token expires. Accepts a date, or the boolean `false` to disable
+        # expiration entirely. ISO 8601 is recommended (for example
+        # `2026-10-25T00:00:00.000Z`). A value that cannot be parsed as a date is
+        # rejected; it is not treated as "no expiration" and does not fall back to the
+        # default. `true` is not a supported value. Omit the field to use the default,
+        # which expires a token that has not been re-registered for 60 days.
         sig do
           returns(
             T.nilable(
@@ -94,8 +98,12 @@ module Courier
           provider_key:,
           # Information about the device the token came from.
           device: nil,
-          # ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
-          # disable expiration.
+          # When the token expires. Accepts a date, or the boolean `false` to disable
+          # expiration entirely. ISO 8601 is recommended (for example
+          # `2026-10-25T00:00:00.000Z`). A value that cannot be parsed as a date is
+          # rejected; it is not treated as "no expiration" and does not fall back to the
+          # default. `true` is not a supported value. Omit the field to use the default,
+          # which expires a token that has not been re-registered for 60 days.
           expiry_date: nil,
           # Properties about the token.
           properties: nil,
@@ -244,8 +252,12 @@ module Courier
           end
         end
 
-        # ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
-        # disable expiration.
+        # When the token expires. Accepts a date, or the boolean `false` to disable
+        # expiration entirely. ISO 8601 is recommended (for example
+        # `2026-10-25T00:00:00.000Z`). A value that cannot be parsed as a date is
+        # rejected; it is not treated as "no expiration" and does not fall back to the
+        # default. `true` is not a supported value. Omit the field to use the default,
+        # which expires a token that has not been re-registered for 60 days.
         module ExpiryDate
           extend Courier::Internal::Type::Union
 

data/rbi/courier/models/users/token_update_params.rbi

@@ -62,32 +62,84 @@ module Courier
           sig { returns(String) }
           attr_accessor :path
 
-          # The value for the operation.
-          sig { returns(T.nilable(String)) }
+          # The value for the operation. A string for most fields; boolean `false` when
+          # disabling token expiration via `expiry_date`, which cannot be expressed as a
+          # string.
+          sig do
+            returns(
+              T.nilable(
+                Courier::Users::TokenUpdateParams::Patch::Value::Variants
+              )
+            )
+          end
           attr_accessor :value
 
           sig do
-            params(op: String, path: String, value: T.nilable(String)).returns(
-              T.attached_class
-            )
+            params(
+              op: String,
+              path: String,
+              value:
+                T.nilable(
+                  Courier::Users::TokenUpdateParams::Patch::Value::Variants
+                )
+            ).returns(T.attached_class)
           end
           def self.new(
             # The operation to perform.
             op:,
             # The JSON path specifying the part of the profile to operate on.
             path:,
-            # The value for the operation.
+            # The value for the operation. A string for most fields; boolean `false` when
+            # disabling token expiration via `expiry_date`, which cannot be expressed as a
+            # string.
             value: nil
           )
           end
 
           sig do
             override.returns(
-              { op: String, path: String, value: T.nilable(String) }
+              {
+                op: String,
+                path: String,
+                value:
+                  T.nilable(
+                    Courier::Users::TokenUpdateParams::Patch::Value::Variants
+                  )
+              }
             )
           end
           def to_hash
           end
+
+          # The value for the operation. A string for most fields; boolean `false` when
+          # disabling token expiration via `expiry_date`, which cannot be expressed as a
+          # string.
+          module Value
+            extend Courier::Internal::Type::Union
+
+            Variants =
+              T.type_alias do
+                T.any(String, T::Boolean, T::Hash[Symbol, T.anything])
+              end
+
+            sig do
+              override.returns(
+                T::Array[
+                  Courier::Users::TokenUpdateParams::Patch::Value::Variants
+                ]
+              )
+            end
+            def self.variants
+            end
+
+            UnionMember2Map =
+              T.let(
+                Courier::Internal::Type::HashOf[
+                  Courier::Internal::Type::Unknown
+                ],
+                Courier::Internal::Type::Converter
+              )
+          end
         end
       end
     end

data/rbi/courier/models/users/user_token.rbi

@@ -29,8 +29,12 @@ module Courier
         end
         attr_writer :device
 
-        # ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
-        # disable expiration.
+        # When the token expires. Accepts a date, or the boolean `false` to disable
+        # expiration entirely. ISO 8601 is recommended (for example
+        # `2026-10-25T00:00:00.000Z`). A value that cannot be parsed as a date is
+        # rejected; it is not treated as "no expiration" and does not fall back to the
+        # default. `true` is not a supported value. Omit the field to use the default,
+        # which expires a token that has not been re-registered for 60 days.
         sig do
           returns(T.nilable(Courier::Users::UserToken::ExpiryDate::Variants))
         end
@@ -71,8 +75,12 @@ module Courier
           provider_key:,
           # Information about the device the token came from.
           device: nil,
-          # ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
-          # disable expiration.
+          # When the token expires. Accepts a date, or the boolean `false` to disable
+          # expiration entirely. ISO 8601 is recommended (for example
+          # `2026-10-25T00:00:00.000Z`). A value that cannot be parsed as a date is
+          # rejected; it is not treated as "no expiration" and does not fall back to the
+          # default. `true` is not a supported value. Omit the field to use the default,
+          # which expires a token that has not been re-registered for 60 days.
           expiry_date: nil,
           # Properties about the token.
           properties: nil,
@@ -207,8 +215,12 @@ module Courier
           end
         end
 
-        # ISO 8601 formatted date the token expires. Defaults to 2 months. Set to false to
-        # disable expiration.
+        # When the token expires. Accepts a date, or the boolean `false` to disable
+        # expiration entirely. ISO 8601 is recommended (for example
+        # `2026-10-25T00:00:00.000Z`). A value that cannot be parsed as a date is
+        # rejected; it is not treated as "no expiration" and does not fall back to the
+        # default. `true` is not a supported value. Omit the field to use the default,
+        # which expires a token that has not been re-registered for 60 days.
         module ExpiryDate
           extend Courier::Internal::Type::Union
 

data/rbi/courier/models.rbi

@@ -192,6 +192,8 @@ module Courier
 
   ElementalNode = Courier::Models::ElementalNode
 
+  ElementalNodeNonChannel = Courier::Models::ElementalNodeNonChannel
+
   ElementalQuoteNode = Courier::Models::ElementalQuoteNode
 
   ElementalQuoteNodeWithType = Courier::Models::ElementalQuoteNodeWithType

data/rbi/courier/resources/journeys/templates.rbi

@@ -8,6 +8,13 @@ module Courier
       class Templates
         # Create a notification template scoped to this journey. Defaults to `DRAFT`
         # state; pass `state: "PUBLISHED"` to publish on create.
+        #
+        # The content tree must contain exactly one channel block whose `channel` matches
+        # the `channel` on the request — a journey-scoped template carries a single
+        # channel. Top-level elements, or a block for a different channel, return `400`.
+        # The template designer renders only the channel block matching the tab it draws,
+        # so content stored without one cannot be opened. An empty `elements` array is
+        # accepted.
         sig do
           params(
             template_id: String,

data/rbi/courier/resources/notifications.rbi

@@ -12,6 +12,16 @@ module Courier
 
       # Create a notification template. Requires all fields in the notification object.
       # Templates are created in draft state by default.
+      #
+      # Content must place its elements inside a channel block —
+      # `{ "type": "channel", "channel": "email", "elements": [...] }` — or the request
+      # returns `400`. The template designer renders only the channel block matching the
+      # tab it draws, so content stored without one cannot be opened. An empty
+      # `elements` array is accepted, and the requirement applies to creation only:
+      # `PUT /notifications/{id}` still accepts unwrapped content. Note this endpoint
+      # takes versioned content only — the `{ title, body }` shorthand accepted by
+      # `/send` is rejected here with an `invalid_request_error` on
+      # `notification.content.version`.
       sig do
         params(
           notification: Courier::NotificationTemplateWritePayload::OrHash,

data/rbi/courier/resources/tenants/templates.rbi

@@ -92,6 +92,16 @@ module Courier
 
         # Creates or updates a notification template scoped to one tenant, letting a
         # tenant override the content the workspace template would send.
+        #
+        # This is an upsert: it creates when the tenant has no template under
+        # `template_id`, and updates when it does. On the create half, content must place
+        # its elements inside a channel block —
+        # `{ "type": "channel", "channel": "email", "elements": [...] }` — or the request
+        # returns `400`. The template designer renders only the channel block matching the
+        # tab it draws, so content stored without one cannot be opened. An empty
+        # `elements` array is accepted, as is the `{ title, body }` shorthand, which has
+        # no elements to wrap. Updates are not checked, so tenant templates already stored
+        # without a wrapper stay editable.
         sig do
           params(
             template_id: String,

data/rbi/courier/resources/users/tokens.rbi

@@ -122,8 +122,12 @@ module Courier
           provider_key:,
           # Body param: Information about the device the token came from.
           device: nil,
-          # Body param: ISO 8601 formatted date the token expires. Defaults to 2 months. Set
-          # to false to disable expiration.
+          # Body param: When the token expires. Accepts a date, or the boolean `false` to
+          # disable expiration entirely. ISO 8601 is recommended (for example
+          # `2026-10-25T00:00:00.000Z`). A value that cannot be parsed as a date is
+          # rejected; it is not treated as "no expiration" and does not fall back to the
+          # default. `true` is not a supported value. Omit the field to use the default,
+          # which expires a token that has not been re-registered for 60 days.
           expiry_date: nil,
           # Body param: Properties about the token.
           properties: nil,

data/sig/courier/models/elemental_channel_node.rbs

@@ -3,6 +3,7 @@ module Courier
     type elemental_channel_node =
       {
         channel: String,
+        elements: ::Array[Courier::Models::elemental_node_non_channel]?,
         font_size: String?,
         line_height: String?,
         padding: String?,
@@ -14,6 +15,12 @@ module Courier
 
       def channel=: (String _) -> String
 
+      def elements: -> ::Array[Courier::Models::elemental_node_non_channel]?
+
+      def elements=: (
+        ::Array[Courier::Models::elemental_node_non_channel]? _
+      ) -> ::Array[Courier::Models::elemental_node_non_channel]?
+
       def font_size: -> String?
 
       def font_size=: (String? _) -> String?
@@ -32,6 +39,7 @@ module Courier
 
       def initialize: (
         ?channel: String,
+        ?elements: ::Array[Courier::Models::elemental_node_non_channel]?,
         ?font_size: String?,
         ?line_height: String?,
         ?padding: String?,
@@ -40,6 +48,7 @@ module Courier
 
       def to_hash: -> {
         channel: String,
+        elements: ::Array[Courier::Models::elemental_node_non_channel]?,
         font_size: String?,
         line_height: String?,
         padding: String?,