trycourier 6.4.4 → 6.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b85383a5a075aec281248a33e3baeb163257dcc14a786a0faed05bafa02dd5db
-  data.tar.gz: f4144cce9c3b08a4b62579c54cf69a7d3234e21e61f74358ab8ac6d1702d2f57
+  metadata.gz: 72f51e60173a98ce2cc1e4b6d3c0613e82f18de751e7ea855ed2418808cac4d9
+  data.tar.gz: 5a10110fea4a9c3b8c5acaf39d169a902c7a8566e4ddfb49933eaed3600c0924
 SHA512:
-  metadata.gz: 344f0da30f2d93dbcad8f178ac74528c4b30209b0f4c67c8fcadd3fab10a1410d313d5467dc84c267076da4ce24387fd47602087e23dcb233eade584be12350e
-  data.tar.gz: f10b02d48f1aee2d14d0e538eaea4125eb2099262af4cd0d5a8b391342d974f6a73094f11ad8ea50094392fae9d49de32d902804ac659218f8047e7e0a512f70
+  metadata.gz: 7940121c65ecbb1ef483b5f8594cdde2a3b08f1c93d22c04ebbd829b2989030e6d3bc43359b98196fc749a4c21fe8d54cb2a3355f37e057996da472e807751eb
+  data.tar.gz: 569ff793ab8fa5d18202278cd38630cb6556c391f3097e2931c938afb87e2a6c163c4b061bab684dc4a18d668843d0b36a7ebbb5b11699976483d49e466d5370

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [6.6.0](https://github.com/trycourier/courier-ruby/compare/v6.5.0...v6.6.0) (2026-09-15)
+
+
+### Features
+
+* **api:** digest configuration, per-recipient schedules, and release ([#154](https://github.com/trycourier/courier-ruby/issues/154)) ([abaf9f2](https://github.com/trycourier/courier-ruby/commit/abaf9f215ae6c9e6aaeb36e7313c9300da23b39b))
+
+
+### Documentation
+
+* **api:** group the topic digest endpoints under Digests, and match the docs voice ([#155](https://github.com/trycourier/courier-ruby/issues/155)) ([cb00e91](https://github.com/trycourier/courier-ruby/commit/cb00e91773b41f312db5c627ee500080da48b051))
+* **api:** stop teaching an aud_ prefix that Courier does not issue ([#152](https://github.com/trycourier/courier-ruby/issues/152)) ([1bd0f05](https://github.com/trycourier/courier-ruby/commit/1bd0f05a5e3db1e593c04046a7b20e9bdd1f64bf))
+
+## [6.5.0](https://github.com/trycourier/courier-ruby/compare/v6.4.4...v6.5.0) (2026-09-04)
+
+
+### Features
+
+* **api:** document the expiry_date contract and allow boolean patch values ([#148](https://github.com/trycourier/courier-ruby/issues/148)) ([191cec0](https://github.com/trycourier/courier-ruby/commit/191cec0ef235a855add991f9b935c1d90e0239f8))
+
 ## [6.4.4](https://github.com/trycourier/courier-ruby/compare/v6.4.3...v6.4.4) (2026-09-03)
 
 

data/README.md

@@ -9,7 +9,7 @@ Add the gem to your `Gemfile`:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "trycourier", "~> 6.4.4"
+gem "trycourier", "~> 6.6.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/courier/models/digest_day_of_week.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # A day of the week. Accepted case-insensitively, returned lowercase.
+    module DigestDayOfWeek
+      extend Courier::Internal::Type::Enum
+
+      SUNDAY = :sunday
+      MONDAY = :monday
+      TUESDAY = :tuesday
+      WEDNESDAY = :wednesday
+      THURSDAY = :thursday
+      FRIDAY = :friday
+      SATURDAY = :saturday
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/courier/models/digest_frequency.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # How often a digest is delivered. `instant` delivers immediately without
+    # batching, and is the one value that takes no `time`.
+    module DigestFrequency
+      extend Courier::Internal::Type::Enum
+
+      INSTANT = :instant
+      DAILY = :daily
+      WEEKDAYS = :weekdays
+      WEEKLY = :weekly
+      CUSTOM_DAYS = :custom_days
+      MONTHLY = :monthly
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/courier/models/email_footer.rb

@@ -3,19 +3,126 @@
 module Courier
   module Models
     class EmailFooter < Courier::Internal::Type::BaseModel
-      # @!attribute content
-      #
-      #   @return [String, nil]
-      optional :content, String, nil?: true
-
       # @!attribute inherit_default
       #
       #   @return [Boolean, nil]
       optional :inherit_default, Courier::Internal::Type::Boolean, api_name: :inheritDefault, nil?: true
 
-      # @!method initialize(content: nil, inherit_default: nil)
-      #   @param content [String, nil]
+      # @!attribute markdown
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :markdown, String, nil?: true
+
+      # @!attribute social
+      #   Social links rendered in the email footer.
+      #
+      #   @return [Courier::Models::EmailFooter::Social, nil]
+      optional :social, -> { Courier::EmailFooter::Social }, nil?: true
+
+      # @!method initialize(inherit_default: nil, markdown: nil, social: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::EmailFooter} for more details.
+      #
       #   @param inherit_default [Boolean, nil]
+      #
+      #   @param markdown [String, nil] The footer body, as markdown. This is the field the API returns and accepts; it
+      #
+      #   @param social [Courier::Models::EmailFooter::Social, nil] Social links rendered in the email footer.
+
+      # @see Courier::Models::EmailFooter#social
+      class Social < Courier::Internal::Type::BaseModel
+        # @!attribute facebook
+        #
+        #   @return [Courier::Models::EmailFooter::Social::Facebook, nil]
+        optional :facebook, -> { Courier::EmailFooter::Social::Facebook }, nil?: true
+
+        # @!attribute instagram
+        #
+        #   @return [Courier::Models::EmailFooter::Social::Instagram, nil]
+        optional :instagram, -> { Courier::EmailFooter::Social::Instagram }, nil?: true
+
+        # @!attribute linkedin
+        #
+        #   @return [Courier::Models::EmailFooter::Social::Linkedin, nil]
+        optional :linkedin, -> { Courier::EmailFooter::Social::Linkedin }, nil?: true
+
+        # @!attribute medium
+        #
+        #   @return [Courier::Models::EmailFooter::Social::Medium, nil]
+        optional :medium, -> { Courier::EmailFooter::Social::Medium }, nil?: true
+
+        # @!attribute twitter
+        #
+        #   @return [Courier::Models::EmailFooter::Social::Twitter, nil]
+        optional :twitter, -> { Courier::EmailFooter::Social::Twitter }, nil?: true
+
+        # @!method initialize(facebook: nil, instagram: nil, linkedin: nil, medium: nil, twitter: nil)
+        #   Social links rendered in the email footer.
+        #
+        #   @param facebook [Courier::Models::EmailFooter::Social::Facebook, nil]
+        #   @param instagram [Courier::Models::EmailFooter::Social::Instagram, nil]
+        #   @param linkedin [Courier::Models::EmailFooter::Social::Linkedin, nil]
+        #   @param medium [Courier::Models::EmailFooter::Social::Medium, nil]
+        #   @param twitter [Courier::Models::EmailFooter::Social::Twitter, nil]
+
+        # @see Courier::Models::EmailFooter::Social#facebook
+        class Facebook < Courier::Internal::Type::BaseModel
+          # @!attribute url
+          #
+          #   @return [String, nil]
+          optional :url, String, nil?: true
+
+          # @!method initialize(url: nil)
+          #   @param url [String, nil]
+        end
+
+        # @see Courier::Models::EmailFooter::Social#instagram
+        class Instagram < Courier::Internal::Type::BaseModel
+          # @!attribute url
+          #
+          #   @return [String, nil]
+          optional :url, String, nil?: true
+
+          # @!method initialize(url: nil)
+          #   @param url [String, nil]
+        end
+
+        # @see Courier::Models::EmailFooter::Social#linkedin
+        class Linkedin < Courier::Internal::Type::BaseModel
+          # @!attribute url
+          #
+          #   @return [String, nil]
+          optional :url, String, nil?: true
+
+          # @!method initialize(url: nil)
+          #   @param url [String, nil]
+        end
+
+        # @see Courier::Models::EmailFooter::Social#medium
+        class Medium < Courier::Internal::Type::BaseModel
+          # @!attribute url
+          #
+          #   @return [String, nil]
+          optional :url, String, nil?: true
+
+          # @!method initialize(url: nil)
+          #   @param url [String, nil]
+        end
+
+        # @see Courier::Models::EmailFooter::Social#twitter
+        class Twitter < Courier::Internal::Type::BaseModel
+          # @!attribute url
+          #
+          #   @return [String, nil]
+          optional :url, String, nil?: true
+
+          # @!method initialize(url: nil)
+          #   @param url [String, nil]
+        end
+      end
     end
   end
 end

data/lib/courier/models/journey_conditions_field.rb

@@ -12,10 +12,20 @@ module Courier
       # - Binary form (3 elements): `[path, operator, value]` where `operator`
       #   is one of `is equal`, `is not equal`, `contains`, `does not contain`,
       #   `starts with`, `ends with`, `greater than`, `greater than or equal`,
-      #   `less than`, `less than or equal`.
+      #   `less than`, `less than or equal`, `was`, `was not`.
       #
       #   Example: `["user.tier", "is equal", "gold"]`.
       #
+      #   `was` / `was not` compare a `send_status.<nodeId>` path (referencing
+      #   an earlier send node's node id) against one of `SENT`, `DELIVERED`,
+      #   `OPENED`, `CLICKED`, `UNDELIVERABLE`. The first four are cumulative
+      #   and ordered `SENT < DELIVERED < OPENED < CLICKED`, so `was DELIVERED`
+      #   is true once the message has reached DELIVERED, OPENED, or CLICKED.
+      #   `UNDELIVERABLE` is an exact match only and is never part of that
+      #   ordering, in either direction.
+      #   Example:
+      #   `["send_status.P9Z3VCRJG647M7QNJZR3548HW741", "was", "DELIVERED"]`.
+      #
       # - Unary form (2 elements): `[path, operator]` where `operator` is
       #   one of `exists`, `does not exist`.
       #

data/lib/courier/models/journey_node.rb

@@ -47,7 +47,11 @@ module Courier
       # Collect events arriving at the node into a single batch and fire one downstream step with the aggregated payload. The first event into a batch owns the run; later contributing events terminate at the batch step. The batch releases when any of `max_items` is reached, a quiet window of `wait_period` elapses, or the `max_wait_period` ceiling hits.
       variant -> { Courier::JourneyNode::JourneyBatchNode }
 
-      # Add the current event to a digest keyed by the given subscription topic. The digest accumulates events and releases them on the schedule configured for the topic.
+      # Add the current event to a digest keyed by the given subscription topic. The digest accumulates events and releases them on the schedule configured for the topic, using the notification template configured on that topic. This node's `type` value is `add-to-digest`.
+      #
+      # **The topic must have a template configured.** If the topic has no template when the first event reaches this node, the journey run fails immediately: the run is marked `ERROR`, no digest instance is created, and the journey does not continue past this node. Configure the topic's template before using the topic in a journey.
+      #
+      # If the journey run is scoped to a tenant, digests are kept separate per tenant: two runs for the same user under different tenants accumulate and release as separate digests, even on the same topic.
       variant -> { Courier::JourneyNode::JourneyAddToDigestNode }
 
       # Terminate the journey run.
@@ -240,7 +244,18 @@ module Courier
         #
         #   Add the current event to a digest keyed by the given subscription topic. The
         #   digest accumulates events and releases them on the schedule configured for the
-        #   topic.
+        #   topic, using the notification template configured on that topic. This node's
+        #   `type` value is `add-to-digest`.
+        #
+        #   **The topic must have a template configured.** If the topic has no template when
+        #   the first event reaches this node, the journey run fails immediately: the run is
+        #   marked `ERROR`, no digest instance is created, and the journey does not continue
+        #   past this node. Configure the topic's template before using the topic in a
+        #   journey.
+        #
+        #   If the journey run is scoped to a tenant, digests are kept separate per tenant:
+        #   two runs for the same user under different tenants accumulate and release as
+        #   separate digests, even on the same topic.
         #
         #   @param subscription_topic_id [String] The subscription topic that owns the digest the event is added to.
         #

data/lib/courier/models/topic_digest_category.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class TopicDigestCategory < Courier::Internal::Type::BaseModel
+      # @!attribute category_key
+      #   The key that identifies the category within the digest.
+      #
+      #   @return [String]
+      required :category_key, String
+
+      # @!attribute limit
+      #   How many collected events are carried into the rendered digest. Defaults to 10.
+      #
+      #   Events beyond the limit are discarded, not held back for the next digest: the
+      #   release consumes everything collected so far and only `limit` of them appear.
+      #   `retain` decides which ones those are.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute retain
+      #   Which collected events survive the `limit`. `FIRST` and `LOWEST` keep the
+      #   earliest or smallest; `LAST` and `HIGHEST` keep the latest or largest. Accepted
+      #   case-insensitively, returned uppercase.
+      #
+      #   @return [Symbol, Courier::Models::TopicDigestCategory::Retain, nil]
+      optional :retain, enum: -> { Courier::TopicDigestCategory::Retain }
+
+      # @!attribute sort_key
+      #   The data key used to rank events. Required when `retain` is `HIGHEST` or
+      #   `LOWEST`.
+      #
+      #   @return [String, nil]
+      optional :sort_key, String
+
+      # @!method initialize(category_key:, limit: nil, retain: nil, sort_key: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::TopicDigestCategory} for more details.
+      #
+      #   How events collected under a category key are retained when a digest holds more
+      #   than it will render.
+      #
+      #   @param category_key [String] The key that identifies the category within the digest.
+      #
+      #   @param limit [Integer] How many collected events are carried into the rendered digest. Defaults to 10.
+      #
+      #   @param retain [Symbol, Courier::Models::TopicDigestCategory::Retain] Which collected events survive the `limit`. `FIRST` and `LOWEST` keep the earlie
+      #
+      #   @param sort_key [String] The data key used to rank events. Required when `retain` is `HIGHEST` or `LOWEST
+
+      # Which collected events survive the `limit`. `FIRST` and `LOWEST` keep the
+      # earliest or smallest; `LAST` and `HIGHEST` keep the latest or largest. Accepted
+      # case-insensitively, returned uppercase.
+      #
+      # @see Courier::Models::TopicDigestCategory#retain
+      module Retain
+        extend Courier::Internal::Type::Enum
+
+        FIRST = :FIRST
+        LAST = :LAST
+        HIGHEST = :HIGHEST
+        LOWEST = :LOWEST
+        NONE = :NONE
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/courier/models/topic_digest_release_request.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class TopicDigestReleaseRequest < Courier::Internal::Type::BaseModel
+      # @!attribute user_id
+      #   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.
+      #
+      #   @return [String]
+      required :user_id, String
+
+      # @!attribute tenant_id
+      #   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.
+      #
+      #   @return [String, nil]
+      optional :tenant_id, String
+
+      # @!method initialize(user_id:, tenant_id: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::TopicDigestReleaseRequest} for more details.
+      #
+      #   Which recipient's held digest to release.
+      #
+      #   @param user_id [String] The recipient whose digest to release. Required: there is no "release everyone o
+      #
+      #   @param tenant_id [String] The recipient's tenant, when they were sent to as part of one -- the same value
+    end
+  end
+end

data/lib/courier/models/topic_digest_request.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class TopicDigestRequest < Courier::Internal::Type::BaseModel
+      # @!attribute schedules
+      #   The cadences this digest delivers on. At least one is required: a digest with no
+      #   schedule collects events into an instance that can never fire. Omitting the key
+      #   on a replace leaves stored schedules untouched; sending `[]` is a `400`.
+      #
+      #   @return [Array<Courier::Models::TopicDigestScheduleRequest>]
+      required :schedules, -> { Courier::Internal::Type::ArrayOf[Courier::TopicDigestScheduleRequest] }
+
+      # @!attribute template_id
+      #   The notification template that renders the digest. A digest with no template
+      #   collects nothing, so this is required.
+      #
+      #   @return [String]
+      required :template_id, String
+
+      # @!attribute audience_id
+      #   Optional audience the digest is scoped to.
+      #
+      #   @return [String, nil]
+      optional :audience_id, String
+
+      # @!attribute categories
+      #   Retention rules per category key. Defaults to a single `digest` category
+      #   retaining `FIRST`.
+      #
+      #   @return [Array<Courier::Models::TopicDigestCategory>, nil]
+      optional :categories, -> { Courier::Internal::Type::ArrayOf[Courier::TopicDigestCategory] }
+
+      # @!attribute trigger_empty
+      #   Whether to deliver the digest even when nothing was collected.
+      #
+      #   @return [Boolean, nil]
+      optional :trigger_empty, Courier::Internal::Type::Boolean
+
+      # @!method initialize(schedules:, template_id:, audience_id: nil, categories: nil, trigger_empty: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::TopicDigestRequest} for more details.
+      #
+      #   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.
+      #
+      #   @param schedules [Array<Courier::Models::TopicDigestScheduleRequest>] The cadences this digest delivers on. At least one is required: a digest with no
+      #
+      #   @param template_id [String] The notification template that renders the digest. A digest with no template col
+      #
+      #   @param audience_id [String] Optional audience the digest is scoped to.
+      #
+      #   @param categories [Array<Courier::Models::TopicDigestCategory>] Retention rules per category key. Defaults to a single `digest` category retaini
+      #
+      #   @param trigger_empty [Boolean] Whether to deliver the digest even when nothing was collected.
+    end
+  end
+end

data/lib/courier/models/topic_digest_response.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class TopicDigestResponse < Courier::Internal::Type::BaseModel
+      # @!attribute categories
+      #   Retention rules per category key.
+      #
+      #   @return [Array<Courier::Models::TopicDigestCategory>]
+      required :categories, -> { Courier::Internal::Type::ArrayOf[Courier::TopicDigestCategory] }
+
+      # @!attribute schedules
+      #   The digest's delivery cadences, each with its server-assigned `schedule_id`.
+      #
+      #   @return [Array<Courier::Models::TopicDigestScheduleResponse>]
+      required :schedules, -> { Courier::Internal::Type::ArrayOf[Courier::TopicDigestScheduleResponse] }
+
+      # @!attribute template_id
+      #   The notification template that renders the digest.
+      #
+      #   @return [String]
+      required :template_id, String
+
+      # @!attribute audience_id
+      #   The audience the digest is scoped to, when set.
+      #
+      #   @return [String, nil]
+      optional :audience_id, String
+
+      # @!attribute created
+      #   ISO-8601 timestamp of when the digest was configured.
+      #
+      #   @return [String, nil]
+      optional :created, String
+
+      # @!attribute trigger_empty
+      #   Whether the digest is delivered even when nothing was collected.
+      #
+      #   @return [Boolean, nil]
+      optional :trigger_empty, Courier::Internal::Type::Boolean
+
+      # @!attribute updated
+      #   ISO-8601 timestamp of the last update.
+      #
+      #   @return [String, nil]
+      optional :updated, String
+
+      # @!method initialize(categories:, schedules:, template_id:, audience_id: nil, created: nil, trigger_empty: nil, updated: nil)
+      #   A topic's digest configuration.
+      #
+      #   @param categories [Array<Courier::Models::TopicDigestCategory>] Retention rules per category key.
+      #
+      #   @param schedules [Array<Courier::Models::TopicDigestScheduleResponse>] The digest's delivery cadences, each with its server-assigned `schedule_id`.
+      #
+      #   @param template_id [String] The notification template that renders the digest.
+      #
+      #   @param audience_id [String] The audience the digest is scoped to, when set.
+      #
+      #   @param created [String] ISO-8601 timestamp of when the digest was configured.
+      #
+      #   @param trigger_empty [Boolean] Whether the digest is delivered even when nothing was collected.
+      #
+      #   @param updated [String] ISO-8601 timestamp of the last update.
+    end
+  end
+end

data/lib/courier/models/topic_digest_schedule_request.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class TopicDigestScheduleRequest < Courier::Internal::Type::BaseModel
+      # @!attribute frequency
+      #   How often a digest is delivered. `instant` delivers immediately without
+      #   batching, and is the one value that takes no `time`.
+      #
+      #   @return [Symbol, Courier::Models::DigestFrequency]
+      required :frequency, enum: -> { Courier::DigestFrequency }
+
+      # @!attribute day_of_month
+      #   Required when `frequency` is `monthly`.
+      #
+      #   @return [Integer, nil]
+      optional :day_of_month, Integer
+
+      # @!attribute day_of_week
+      #   Required when `frequency` is `weekly`.
+      #
+      #   @return [Symbol, Courier::Models::DigestDayOfWeek, nil]
+      optional :day_of_week, enum: -> { Courier::DigestDayOfWeek }
+
+      # @!attribute days_of_week
+      #   Required when `frequency` is `custom_days`.
+      #
+      #   @return [Array<Symbol, Courier::Models::DigestDayOfWeek>, nil]
+      optional :days_of_week, -> { Courier::Internal::Type::ArrayOf[enum: Courier::DigestDayOfWeek] }
+
+      # @!attribute disabled
+      #   Whether the schedule is disabled.
+      #
+      #   @return [Boolean, nil]
+      optional :disabled, Courier::Internal::Type::Boolean
+
+      # @!attribute is_default
+      #   The schedule recipients are placed on when they have not chosen one. Set this
+      #   explicitly rather than relying on array position.
+      #
+      #   @return [Boolean, nil]
+      optional :is_default, Courier::Internal::Type::Boolean
+
+      # @!attribute schedule_id
+      #   Identifier of an existing schedule to update. Omit when creating a new one.
+      #
+      #   @return [String, nil]
+      optional :schedule_id, String
+
+      # @!attribute time
+      #   24-hour local delivery time, `HH:MM`. Required for every frequency except
+      #   `instant`.
+      #
+      #   @return [String, nil]
+      optional :time, String
+
+      # @!attribute timezone
+      #   IANA timezone the `time` and day fields are expressed in, e.g.
+      #   `America/New_York`. Absent means UTC. Delivery follows the same local wall-clock
+      #   across daylight-saving changes.
+      #
+      #   @return [String, nil]
+      optional :timezone, String
+
+      # @!method initialize(frequency:, day_of_month: nil, day_of_week: nil, days_of_week: nil, disabled: nil, is_default: nil, schedule_id: nil, time: nil, timezone: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::TopicDigestScheduleRequest} for more details.
+      #
+      #   One delivery cadence for a topic's digest. Supply `schedule_id` to update an
+      #   existing schedule in place; omit it and one is assigned and returned. The
+      #   `schedules` array is a full replacement, so a stored schedule absent from it is
+      #   deleted along with its delivery rule.
+      #
+      #   @param frequency [Symbol, Courier::Models::DigestFrequency] How often a digest is delivered. `instant` delivers immediately without batching
+      #
+      #   @param day_of_month [Integer] Required when `frequency` is `monthly`.
+      #
+      #   @param day_of_week [Symbol, Courier::Models::DigestDayOfWeek] Required when `frequency` is `weekly`.
+      #
+      #   @param days_of_week [Array<Symbol, Courier::Models::DigestDayOfWeek>] Required when `frequency` is `custom_days`.
+      #
+      #   @param disabled [Boolean] Whether the schedule is disabled.
+      #
+      #   @param is_default [Boolean] The schedule recipients are placed on when they have not chosen one. Set this ex
+      #
+      #   @param schedule_id [String] Identifier of an existing schedule to update. Omit when creating a new one.
+      #
+      #   @param time [String] 24-hour local delivery time, `HH:MM`. Required for every frequency except `insta
+      #
+      #   @param timezone [String] IANA timezone the `time` and day fields are expressed in, e.g. `America/New_York
+    end
+  end
+end