trycourier 6.4.4 → 6.6.0

data/rbi/courier/models/workspace_preference_topic_create_request.rbi

@@ -40,6 +40,21 @@ module Courier
       sig { returns(T.nilable(String)) }
       attr_accessor :description
 
+      # A topic's digest configuration: the template that renders it, the cadences it
+      # delivers on, and how collected events are retained.
+      #
+      # Send `null` for the whole object to turn a digest off, which unlinks the
+      # template and removes its schedules. There is no `enabled` flag, and
+      # `schedules: []` is rejected, because both states are un-deliverable rather than
+      # merely off.
+      sig { returns(T.nilable(Courier::TopicDigestRequest)) }
+      attr_reader :digest
+
+      sig do
+        params(digest: T.nilable(Courier::TopicDigestRequest::OrHash)).void
+      end
+      attr_writer :digest
+
       # Whether to include a list-unsubscribe header on emails for this topic.
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :include_unsubscribe_header
@@ -67,6 +82,7 @@ module Courier
               ]
             ),
           description: T.nilable(String),
+          digest: T.nilable(Courier::TopicDigestRequest::OrHash),
           include_unsubscribe_header: T.nilable(T::Boolean),
           routing_options:
             T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),
@@ -83,6 +99,14 @@ module Courier
         allowed_preferences: nil,
         # Optional description shown under the topic on the hosted preferences page.
         description: nil,
+        # A topic's digest configuration: the template that renders it, the cadences it
+        # delivers on, and how collected events are retained.
+        #
+        # Send `null` for the whole object to turn a digest off, which unlinks the
+        # template and removes its schedules. There is no `enabled` flag, and
+        # `schedules: []` is rejected, because both states are un-deliverable rather than
+        # merely off.
+        digest: nil,
         # Whether to include a list-unsubscribe header on emails for this topic.
         include_unsubscribe_header: nil,
         # Default channels delivered for this topic. Defaults to empty if omitted.
@@ -105,6 +129,7 @@ module Courier
                 ]
               ),
             description: T.nilable(String),
+            digest: T.nilable(Courier::TopicDigestRequest),
             include_unsubscribe_header: T.nilable(T::Boolean),
             routing_options:
               T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),

data/rbi/courier/models/workspace_preference_topic_get_response.rbi

@@ -65,6 +65,15 @@ module Courier
       sig { returns(T.nilable(String)) }
       attr_accessor :description
 
+      # A topic's digest configuration.
+      sig { returns(T.nilable(Courier::TopicDigestResponse)) }
+      attr_reader :digest
+
+      sig do
+        params(digest: T.nilable(Courier::TopicDigestResponse::OrHash)).void
+      end
+      attr_writer :digest
+
       # Id of the last updater.
       sig { returns(T.nilable(String)) }
       attr_accessor :updater
@@ -87,6 +96,7 @@ module Courier
           updated: String,
           creator: T.nilable(String),
           description: T.nilable(String),
+          digest: T.nilable(Courier::TopicDigestResponse::OrHash),
           updater: T.nilable(String)
         ).returns(T.attached_class)
       end
@@ -113,6 +123,8 @@ module Courier
         creator: nil,
         # Optional description shown under the topic on the hosted preferences page.
         description: nil,
+        # A topic's digest configuration.
+        digest: nil,
         # Id of the last updater.
         updater: nil
       )
@@ -137,6 +149,7 @@ module Courier
             updated: String,
             creator: T.nilable(String),
             description: T.nilable(String),
+            digest: T.nilable(Courier::TopicDigestResponse),
             updater: T.nilable(String)
           }
         )

data/rbi/courier/models/workspace_preference_topic_replace_request.rbi

@@ -40,6 +40,21 @@ module Courier
       sig { returns(T.nilable(String)) }
       attr_accessor :description
 
+      # A topic's digest configuration: the template that renders it, the cadences it
+      # delivers on, and how collected events are retained.
+      #
+      # Send `null` for the whole object to turn a digest off, which unlinks the
+      # template and removes its schedules. There is no `enabled` flag, and
+      # `schedules: []` is rejected, because both states are un-deliverable rather than
+      # merely off.
+      sig { returns(T.nilable(Courier::TopicDigestRequest)) }
+      attr_reader :digest
+
+      sig do
+        params(digest: T.nilable(Courier::TopicDigestRequest::OrHash)).void
+      end
+      attr_writer :digest
+
       # Whether to include a list-unsubscribe header on emails for this topic.
       sig { returns(T.nilable(T::Boolean)) }
       attr_accessor :include_unsubscribe_header
@@ -68,6 +83,7 @@ module Courier
               ]
             ),
           description: T.nilable(String),
+          digest: T.nilable(Courier::TopicDigestRequest::OrHash),
           include_unsubscribe_header: T.nilable(T::Boolean),
           routing_options:
             T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),
@@ -84,6 +100,14 @@ module Courier
         # Optional description shown under the topic on the hosted preferences page. Omit
         # to clear.
         description: nil,
+        # A topic's digest configuration: the template that renders it, the cadences it
+        # delivers on, and how collected events are retained.
+        #
+        # Send `null` for the whole object to turn a digest off, which unlinks the
+        # template and removes its schedules. There is no `enabled` flag, and
+        # `schedules: []` is rejected, because both states are un-deliverable rather than
+        # merely off.
+        digest: nil,
         # Whether to include a list-unsubscribe header on emails for this topic.
         include_unsubscribe_header: nil,
         # Default channels delivered for this topic. Omit to clear.
@@ -106,6 +130,7 @@ module Courier
                 ]
               ),
             description: T.nilable(String),
+            digest: T.nilable(Courier::TopicDigestRequest),
             include_unsubscribe_header: T.nilable(T::Boolean),
             routing_options:
               T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),

data/rbi/courier/models/workspace_preferences/topic_delete_digest_params.rbi

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

data/rbi/courier/models/workspace_preferences/topic_release_digest_params.rbi

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

data/rbi/courier/models.rbi

@@ -152,6 +152,10 @@ module Courier
 
   DigestCategory = Courier::Models::DigestCategory
 
+  DigestDayOfWeek = Courier::Models::DigestDayOfWeek
+
+  DigestFrequency = Courier::Models::DigestFrequency
+
   DigestInstance = Courier::Models::DigestInstance
 
   DigestInstanceListResponse = Courier::Models::DigestInstanceListResponse
@@ -622,6 +626,18 @@ module Courier
 
   Token = Courier::Models::Token
 
+  TopicDigestCategory = Courier::Models::TopicDigestCategory
+
+  TopicDigestReleaseRequest = Courier::Models::TopicDigestReleaseRequest
+
+  TopicDigestRequest = Courier::Models::TopicDigestRequest
+
+  TopicDigestResponse = Courier::Models::TopicDigestResponse
+
+  TopicDigestScheduleRequest = Courier::Models::TopicDigestScheduleRequest
+
+  TopicDigestScheduleResponse = Courier::Models::TopicDigestScheduleResponse
+
   TranslationRetrieveParams = Courier::Models::TranslationRetrieveParams
 
   TranslationUpdateParams = Courier::Models::TranslationUpdateParams

data/rbi/courier/resources/digests/schedules.rbi

@@ -38,8 +38,11 @@ module Courier
           ).void
         end
         def release(
-          # The ID of the digest schedule to release, in the form `sch/{uuid}`. The value
-          # must be URL-encoded (e.g. `sch%2F00000000-0000-0000-0000-000000000000`).
+          # The ID of the digest schedule to release. Newer schedules are
+          # `sch_01m26xfcn3endt3nxy4e2kx2rh` and need no encoding. Schedules created before
+          # that format are `sch/{uuid}` and contain a literal `/`, so those must be
+          # URL-encoded (e.g. `sch%2F00000000-0000-0000-0000-000000000000`). Both forms
+          # remain valid; existing ids are never migrated.
           schedule_id,
           request_options: {}
         )

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/rbi/courier/resources/workspace_preferences/topics.rbi

@@ -3,8 +3,6 @@
 module Courier
   module Resources
     class WorkspacePreferences
-      # Manage the workspace catalog of subscription topics, the sections that group
-      # them, and publishing the preference page.
       class Topics
         # Creates a subscription topic inside a workspace preference. The default status
         # sets whether users start opted in, opted out, or required.
@@ -21,6 +19,7 @@ module Courier
                 ]
               ),
             description: T.nilable(String),
+            digest: T.nilable(Courier::TopicDigestRequest::OrHash),
             include_unsubscribe_header: T.nilable(T::Boolean),
             routing_options:
               T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),
@@ -44,6 +43,14 @@ module Courier
           # Body param: Optional description shown under the topic on the hosted preferences
           # page.
           description: nil,
+          # Body param: A topic's digest configuration: the template that renders it, the
+          # cadences it delivers on, and how collected events are retained.
+          #
+          # Send `null` for the whole object to turn a digest off, which unlinks the
+          # template and removes its schedules. There is no `enabled` flag, and
+          # `schedules: []` is rejected, because both states are un-deliverable rather than
+          # merely off.
+          digest: nil,
           # Body param: Whether to include a list-unsubscribe header on emails for this
           # topic.
           include_unsubscribe_header: nil,
@@ -119,6 +126,60 @@ module Courier
         )
         end
 
+        # Turn off a topic's digest, leaving the topic itself in place. The template is
+        # unlinked and the digest's schedules are removed along with their delivery rules.
+        # Equivalent to sending `digest: null` on a topic replace.
+        sig do
+          params(
+            topic_id: String,
+            section_id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).void
+        end
+        def delete_digest(
+          # The preference topic whose digest to turn off.
+          topic_id,
+          # The preference section containing the topic.
+          section_id:,
+          request_options: {}
+        )
+        end
+
+        # Send one recipient's held digest now, instead of waiting for its schedule. Use
+        # it to preview what a digest will look like, or to let someone flush their own.
+        #
+        # Keyed on the topic because that is how a held digest is stored: one per
+        # recipient per topic, with the schedule recorded on it rather than part of its
+        # identity. To flush every recipient on a schedule instead, use
+        # `POST /digests/schedules/{schedule_id}/trigger`.
+        sig do
+          params(
+            topic_id: String,
+            section_id: String,
+            user_id: String,
+            tenant_id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).void
+        end
+        def release_digest(
+          # Path param: The preference topic whose digest to release.
+          topic_id,
+          # Path param: The preference section containing the topic.
+          section_id:,
+          # Body param: The recipient whose digest to release. Required: there is no
+          # "release everyone on this topic" form, because a whole-schedule flush already
+          # has its own endpoint and a body-shaped difference between one recipient and all
+          # of them is too easy to get wrong.
+          user_id:,
+          # Body param: The recipient's tenant, when they were sent to as part of one -- the
+          # same value returned as `tenant_id` on a digest instance and sent as
+          # `message.context.tenant_id`. It is part of the held digest's key, so a tenanted
+          # recipient cannot be found without it. Omit for an ordinary recipient.
+          tenant_id: nil,
+          request_options: {}
+        )
+        end
+
         # Replace a topic within a workspace preference. Full document replacement;
         # missing optional fields are cleared. Same 404 rules as GET.
         sig do
@@ -135,6 +196,7 @@ module Courier
                 ]
               ),
             description: T.nilable(String),
+            digest: T.nilable(Courier::TopicDigestRequest::OrHash),
             include_unsubscribe_header: T.nilable(T::Boolean),
             routing_options:
               T.nilable(T::Array[Courier::ChannelClassification::OrSymbol]),
@@ -157,6 +219,14 @@ module Courier
           # Body param: Optional description shown under the topic on the hosted preferences
           # page. Omit to clear.
           description: nil,
+          # Body param: A topic's digest configuration: the template that renders it, the
+          # cadences it delivers on, and how collected events are retained.
+          #
+          # Send `null` for the whole object to turn a digest off, which unlinks the
+          # template and removes its schedules. There is no `enabled` flag, and
+          # `schedules: []` is rejected, because both states are un-deliverable rather than
+          # merely off.
+          digest: nil,
           # Body param: Whether to include a list-unsubscribe header on emails for this
           # topic.
           include_unsubscribe_header: nil,

data/rbi/courier/resources/workspace_preferences.rbi

@@ -5,8 +5,6 @@ module Courier
     # Manage the workspace catalog of subscription topics, the sections that group
     # them, and publishing the preference page.
     class WorkspacePreferences
-      # Manage the workspace catalog of subscription topics, the sections that group
-      # them, and publishing the preference page.
       sig { returns(Courier::Resources::WorkspacePreferences::Topics) }
       attr_reader :topics
 

data/sig/courier/models/digest_day_of_week.rbs

@@ -0,0 +1,26 @@
+module Courier
+  module Models
+    type digest_day_of_week =
+      :sunday
+      | :monday
+      | :tuesday
+      | :wednesday
+      | :thursday
+      | :friday
+      | :saturday
+
+    module DigestDayOfWeek
+      extend Courier::Internal::Type::Enum
+
+      SUNDAY: :sunday
+      MONDAY: :monday
+      TUESDAY: :tuesday
+      WEDNESDAY: :wednesday
+      THURSDAY: :thursday
+      FRIDAY: :friday
+      SATURDAY: :saturday
+
+      def self?.values: -> ::Array[Courier::Models::digest_day_of_week]
+    end
+  end
+end

data/sig/courier/models/digest_frequency.rbs

@@ -0,0 +1,19 @@
+module Courier
+  module Models
+    type digest_frequency =
+      :instant | :daily | :weekdays | :weekly | :custom_days | :monthly
+
+    module DigestFrequency
+      extend Courier::Internal::Type::Enum
+
+      INSTANT: :instant
+      DAILY: :daily
+      WEEKDAYS: :weekdays
+      WEEKLY: :weekly
+      CUSTOM_DAYS: :custom_days
+      MONTHLY: :monthly
+
+      def self?.values: -> ::Array[Courier::Models::digest_frequency]
+    end
+  end
+end

data/sig/courier/models/email_footer.rbs

@@ -1,15 +1,117 @@
 module Courier
   module Models
-    type email_footer = { content: String?, inherit_default: bool? }
+    type email_footer =
+      {
+        inherit_default: bool?,
+        markdown: String?,
+        social: Courier::EmailFooter::Social?
+      }
 
     class EmailFooter < Courier::Internal::Type::BaseModel
-      attr_accessor content: String?
-
       attr_accessor inherit_default: bool?
 
-      def initialize: (?content: String?, ?inherit_default: bool?) -> void
+      attr_accessor markdown: String?
+
+      attr_accessor social: Courier::EmailFooter::Social?
+
+      def initialize: (
+        ?inherit_default: bool?,
+        ?markdown: String?,
+        ?social: Courier::EmailFooter::Social?
+      ) -> void
+
+      def to_hash: -> {
+        inherit_default: bool?,
+        markdown: String?,
+        social: Courier::EmailFooter::Social?
+      }
+
+      type social =
+        {
+          facebook: Courier::EmailFooter::Social::Facebook?,
+          instagram: Courier::EmailFooter::Social::Instagram?,
+          linkedin: Courier::EmailFooter::Social::Linkedin?,
+          medium: Courier::EmailFooter::Social::Medium?,
+          twitter: Courier::EmailFooter::Social::Twitter?
+        }
+
+      class Social < Courier::Internal::Type::BaseModel
+        attr_accessor facebook: Courier::EmailFooter::Social::Facebook?
+
+        attr_accessor instagram: Courier::EmailFooter::Social::Instagram?
+
+        attr_accessor linkedin: Courier::EmailFooter::Social::Linkedin?
+
+        attr_accessor medium: Courier::EmailFooter::Social::Medium?
+
+        attr_accessor twitter: Courier::EmailFooter::Social::Twitter?
+
+        def initialize: (
+          ?facebook: Courier::EmailFooter::Social::Facebook?,
+          ?instagram: Courier::EmailFooter::Social::Instagram?,
+          ?linkedin: Courier::EmailFooter::Social::Linkedin?,
+          ?medium: Courier::EmailFooter::Social::Medium?,
+          ?twitter: Courier::EmailFooter::Social::Twitter?
+        ) -> void
+
+        def to_hash: -> {
+          facebook: Courier::EmailFooter::Social::Facebook?,
+          instagram: Courier::EmailFooter::Social::Instagram?,
+          linkedin: Courier::EmailFooter::Social::Linkedin?,
+          medium: Courier::EmailFooter::Social::Medium?,
+          twitter: Courier::EmailFooter::Social::Twitter?
+        }
+
+        type facebook = { url: String? }
+
+        class Facebook < Courier::Internal::Type::BaseModel
+          attr_accessor url: String?
+
+          def initialize: (?url: String?) -> void
+
+          def to_hash: -> { url: String? }
+        end
+
+        type instagram = { url: String? }
+
+        class Instagram < Courier::Internal::Type::BaseModel
+          attr_accessor url: String?
+
+          def initialize: (?url: String?) -> void
+
+          def to_hash: -> { url: String? }
+        end
+
+        type linkedin = { url: String? }
+
+        class Linkedin < Courier::Internal::Type::BaseModel
+          attr_accessor url: String?
+
+          def initialize: (?url: String?) -> void
+
+          def to_hash: -> { url: String? }
+        end
+
+        type medium = { url: String? }
+
+        class Medium < Courier::Internal::Type::BaseModel
+          attr_accessor url: String?
+
+          def initialize: (?url: String?) -> void
+
+          def to_hash: -> { url: String? }
+        end
+
+        type twitter = { url: String? }
+
+        class Twitter < Courier::Internal::Type::BaseModel
+          attr_accessor url: String?
+
+          def initialize: (?url: String?) -> void
 
-      def to_hash: -> { content: String?, inherit_default: bool? }
+          def to_hash: -> { url: String? }
+        end
+      end
     end
   end
 end

data/sig/courier/models/topic_digest_category.rbs

@@ -0,0 +1,57 @@
+module Courier
+  module Models
+    type topic_digest_category =
+      {
+        category_key: String,
+        limit: Integer,
+        retain: Courier::Models::TopicDigestCategory::retain,
+        sort_key: String
+      }
+
+    class TopicDigestCategory < Courier::Internal::Type::BaseModel
+      attr_accessor category_key: String
+
+      attr_reader limit: Integer?
+
+      def limit=: (Integer) -> Integer
+
+      attr_reader retain: Courier::Models::TopicDigestCategory::retain?
+
+      def retain=: (
+        Courier::Models::TopicDigestCategory::retain
+      ) -> Courier::Models::TopicDigestCategory::retain
+
+      attr_reader sort_key: String?
+
+      def sort_key=: (String) -> String
+
+      def initialize: (
+        category_key: String,
+        ?limit: Integer,
+        ?retain: Courier::Models::TopicDigestCategory::retain,
+        ?sort_key: String
+      ) -> void
+
+      def to_hash: -> {
+        category_key: String,
+        limit: Integer,
+        retain: Courier::Models::TopicDigestCategory::retain,
+        sort_key: String
+      }
+
+      type retain = :FIRST | :LAST | :HIGHEST | :LOWEST | :NONE
+
+      module Retain
+        extend Courier::Internal::Type::Enum
+
+        FIRST: :FIRST
+        LAST: :LAST
+        HIGHEST: :HIGHEST
+        LOWEST: :LOWEST
+        NONE: :NONE
+
+        def self?.values: -> ::Array[Courier::Models::TopicDigestCategory::retain]
+      end
+    end
+  end
+end

data/sig/courier/models/topic_digest_release_request.rbs

@@ -0,0 +1,17 @@
+module Courier
+  module Models
+    type topic_digest_release_request = { user_id: String, tenant_id: String }
+
+    class TopicDigestReleaseRequest < Courier::Internal::Type::BaseModel
+      attr_accessor user_id: String
+
+      attr_reader tenant_id: String?
+
+      def tenant_id=: (String) -> String
+
+      def initialize: (user_id: String, ?tenant_id: String) -> void
+
+      def to_hash: -> { user_id: String, tenant_id: String }
+    end
+  end
+end