trycourier 5.0.0 → 6.1.0

data/rbi/courier/models/automations/run_list_steps_params.rbi

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

data/rbi/courier/models/create_journey_request.rbi

@@ -17,6 +17,8 @@ module Courier
             T.any(
               Courier::JourneyAPIInvokeTriggerNode,
               Courier::JourneySegmentTriggerNode,
+              Courier::JourneyAudienceTriggerNode,
+              Courier::JourneyWebhookTriggerNode,
               Courier::JourneySendNode,
               Courier::JourneyDelayDurationNode,
               Courier::JourneyDelayUntilNode,
@@ -57,6 +59,8 @@ module Courier
               T.any(
                 Courier::JourneyAPIInvokeTriggerNode::OrHash,
                 Courier::JourneySegmentTriggerNode::OrHash,
+                Courier::JourneyAudienceTriggerNode::OrHash,
+                Courier::JourneyWebhookTriggerNode::OrHash,
                 Courier::JourneySendNode::OrHash,
                 Courier::JourneyDelayDurationNode::OrHash,
                 Courier::JourneyDelayUntilNode::OrHash,
@@ -93,6 +97,8 @@ module Courier
                 T.any(
                   Courier::JourneyAPIInvokeTriggerNode,
                   Courier::JourneySegmentTriggerNode,
+                  Courier::JourneyAudienceTriggerNode,
+                  Courier::JourneyWebhookTriggerNode,
                   Courier::JourneySendNode,
                   Courier::JourneyDelayDurationNode,
                   Courier::JourneyDelayUntilNode,

data/rbi/courier/models/expo.rbi

@@ -2,6 +2,7 @@
 
 module Courier
   module Models
+    # Expo push tokens. Supply either a single `token` or a `tokens` value.
     module Expo
       extend Courier::Internal::Type::Union
 

data/rbi/courier/models/journey_audience_trigger_node.rbi

@@ -0,0 +1,162 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneyAudienceTriggerNode < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::JourneyAudienceTriggerNode, Courier::Internal::AnyHash)
+        end
+
+      # The Audience to watch. Must name a single Audience; wildcards are not supported.
+      sig { returns(String) }
+      attr_accessor :audience_id
+
+      sig do
+        returns(Courier::JourneyAudienceTriggerNode::TriggerType::OrSymbol)
+      end
+      attr_accessor :trigger_type
+
+      sig { returns(Courier::JourneyAudienceTriggerNode::Type::OrSymbol) }
+      attr_accessor :type
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :id
+
+      sig { params(id: String).void }
+      attr_writer :id
+
+      # Condition spec for a journey node. Accepts a single condition atom, an AND/OR
+      # group, or an AND/OR nested group. Omit the `conditions` property entirely to
+      # express "no conditions".
+      sig do
+        returns(
+          T.nilable(
+            T.any(
+              T::Array[String],
+              Courier::JourneyConditionGroup,
+              Courier::JourneyConditionNestedGroup
+            )
+          )
+        )
+      end
+      attr_reader :conditions
+
+      sig do
+        params(
+          conditions:
+            T.any(
+              T::Array[String],
+              Courier::JourneyConditionGroup::OrHash,
+              Courier::JourneyConditionNestedGroup::OrHash
+            )
+        ).void
+      end
+      attr_writer :conditions
+
+      # Trigger fired when a user newly matches an Audience. Leaving and re-joining the
+      # Audience re-enters the Journey. Membership is new-members-only: users already in
+      # the Audience when the Journey is published do not enter. Unlike the v2
+      # Automations audience trigger, there is no member scope, event type, or frequency
+      # mode to configure, and `audience_id` must name one Audience — wildcards are not
+      # supported.
+      sig do
+        params(
+          audience_id: String,
+          trigger_type:
+            Courier::JourneyAudienceTriggerNode::TriggerType::OrSymbol,
+          type: Courier::JourneyAudienceTriggerNode::Type::OrSymbol,
+          id: String,
+          conditions:
+            T.any(
+              T::Array[String],
+              Courier::JourneyConditionGroup::OrHash,
+              Courier::JourneyConditionNestedGroup::OrHash
+            )
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The Audience to watch. Must name a single Audience; wildcards are not supported.
+        audience_id:,
+        trigger_type:,
+        type:,
+        id: nil,
+        # Condition spec for a journey node. Accepts a single condition atom, an AND/OR
+        # group, or an AND/OR nested group. Omit the `conditions` property entirely to
+        # express "no conditions".
+        conditions: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            audience_id: String,
+            trigger_type:
+              Courier::JourneyAudienceTriggerNode::TriggerType::OrSymbol,
+            type: Courier::JourneyAudienceTriggerNode::Type::OrSymbol,
+            id: String,
+            conditions:
+              T.any(
+                T::Array[String],
+                Courier::JourneyConditionGroup,
+                Courier::JourneyConditionNestedGroup
+              )
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module TriggerType
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Courier::JourneyAudienceTriggerNode::TriggerType)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AUDIENCE =
+          T.let(
+            :audience,
+            Courier::JourneyAudienceTriggerNode::TriggerType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Courier::JourneyAudienceTriggerNode::TriggerType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      module Type
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Courier::JourneyAudienceTriggerNode::Type)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRIGGER =
+          T.let(
+            :trigger,
+            Courier::JourneyAudienceTriggerNode::Type::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Courier::JourneyAudienceTriggerNode::Type::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_node.rbi

@@ -13,6 +13,8 @@ module Courier
           T.any(
             Courier::JourneyAPIInvokeTriggerNode,
             Courier::JourneySegmentTriggerNode,
+            Courier::JourneyAudienceTriggerNode,
+            Courier::JourneyWebhookTriggerNode,
             Courier::JourneySendNode,
             Courier::JourneyDelayDurationNode,
             Courier::JourneyDelayUntilNode,

data/rbi/courier/models/journey_response.rbi

@@ -52,6 +52,8 @@ module Courier
               T.any(
                 Courier::JourneyAPIInvokeTriggerNode::OrHash,
                 Courier::JourneySegmentTriggerNode::OrHash,
+                Courier::JourneyAudienceTriggerNode::OrHash,
+                Courier::JourneyWebhookTriggerNode::OrHash,
                 Courier::JourneySendNode::OrHash,
                 Courier::JourneyDelayDurationNode::OrHash,
                 Courier::JourneyDelayUntilNode::OrHash,

data/rbi/courier/models/journey_run.rbi

@@ -0,0 +1,97 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneyRun < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Courier::JourneyRun, Courier::Internal::AnyHash) }
+
+      # A unique identifier representing the run.
+      sig { returns(String) }
+      attr_accessor :run_id
+
+      # Internal provenance strings describing what started the run, e.g.
+      # `invoke/<journey_id>` or `segment/page/Pricing Page`. Diagnostic only — the
+      # format is unstable and should not be parsed.
+      sig { returns(T::Array[String]) }
+      attr_accessor :source
+
+      # When the run started, as an ISO 8601 timestamp.
+      sig { returns(T.nilable(String)) }
+      attr_reader :created_at
+
+      sig { params(created_at: String).void }
+      attr_writer :created_at
+
+      # The state of the run: `PROCESSING`, `PROCESSED`, `WAITING`, `CANCELED`, `ERROR`,
+      # `THROTTLED`, or `NOT PROCESSED`. Not an enum — new values have been added
+      # before.
+      sig { returns(T.nilable(String)) }
+      attr_reader :status
+
+      sig { params(status: String).void }
+      attr_writer :status
+
+      # The id of the Journey this run belongs to.
+      sig { returns(T.nilable(String)) }
+      attr_reader :template_id
+
+      sig { params(template_id: String).void }
+      attr_writer :template_id
+
+      # When the run last changed state, as an ISO 8601 timestamp.
+      sig { returns(T.nilable(String)) }
+      attr_reader :updated_at
+
+      sig { params(updated_at: String).void }
+      attr_writer :updated_at
+
+      # One run of a Journey. `status` and `created_at` are absent on a small number of
+      # legacy runs stored without them.
+      sig do
+        params(
+          run_id: String,
+          source: T::Array[String],
+          created_at: String,
+          status: String,
+          template_id: String,
+          updated_at: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # A unique identifier representing the run.
+        run_id:,
+        # Internal provenance strings describing what started the run, e.g.
+        # `invoke/<journey_id>` or `segment/page/Pricing Page`. Diagnostic only — the
+        # format is unstable and should not be parsed.
+        source:,
+        # When the run started, as an ISO 8601 timestamp.
+        created_at: nil,
+        # The state of the run: `PROCESSING`, `PROCESSED`, `WAITING`, `CANCELED`, `ERROR`,
+        # `THROTTLED`, or `NOT PROCESSED`. Not an enum — new values have been added
+        # before.
+        status: nil,
+        # The id of the Journey this run belongs to.
+        template_id: nil,
+        # When the run last changed state, as an ISO 8601 timestamp.
+        updated_at: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            run_id: String,
+            source: T::Array[String],
+            created_at: String,
+            status: String,
+            template_id: String,
+            updated_at: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_run_list_item.rbi

@@ -0,0 +1,79 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneyRunListItem < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::JourneyRunListItem, Courier::Internal::AnyHash)
+        end
+
+      # A unique identifier representing the run.
+      sig { returns(String) }
+      attr_accessor :run_id
+
+      # Internal provenance strings describing what started the run. Diagnostic only.
+      sig { returns(T::Array[String]) }
+      attr_accessor :source
+
+      # When the run started, as an ISO 8601 timestamp.
+      sig { returns(T.nilable(String)) }
+      attr_reader :created_at
+
+      sig { params(created_at: String).void }
+      attr_writer :created_at
+
+      # The state of the run. See `JourneyRun.status` for the values it takes.
+      sig { returns(T.nilable(String)) }
+      attr_reader :status
+
+      sig { params(status: String).void }
+      attr_writer :status
+
+      # The id of the Journey this run belongs to.
+      sig { returns(T.nilable(String)) }
+      attr_reader :template_id
+
+      sig { params(template_id: String).void }
+      attr_writer :template_id
+
+      # A Journey run as it appears in a list response, without `updated_at`.
+      sig do
+        params(
+          run_id: String,
+          source: T::Array[String],
+          created_at: String,
+          status: String,
+          template_id: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # A unique identifier representing the run.
+        run_id:,
+        # Internal provenance strings describing what started the run. Diagnostic only.
+        source:,
+        # When the run started, as an ISO 8601 timestamp.
+        created_at: nil,
+        # The state of the run. See `JourneyRun.status` for the values it takes.
+        status: nil,
+        # The id of the Journey this run belongs to.
+        template_id: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            run_id: String,
+            source: T::Array[String],
+            created_at: String,
+            status: String,
+            template_id: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_run_list_response.rbi

@@ -0,0 +1,58 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneyRunListResponse < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::JourneyRunListResponse, Courier::Internal::AnyHash)
+        end
+
+      sig { returns(T::Array[Courier::JourneyRunListItem]) }
+      attr_accessor :runs
+
+      # Pass back as `cursor` to fetch the next page. Absent on the last page.
+      sig { returns(T.nilable(String)) }
+      attr_reader :next_cursor
+
+      sig { params(next_cursor: String).void }
+      attr_writer :next_cursor
+
+      # Pass back as `cursor` to fetch the previous page. Absent on the first page.
+      sig { returns(T.nilable(String)) }
+      attr_reader :prev_cursor
+
+      sig { params(prev_cursor: String).void }
+      attr_writer :prev_cursor
+
+      # A page of Journey runs.
+      sig do
+        params(
+          runs: T::Array[Courier::JourneyRunListItem::OrHash],
+          next_cursor: String,
+          prev_cursor: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        runs:,
+        # Pass back as `cursor` to fetch the next page. Absent on the last page.
+        next_cursor: nil,
+        # Pass back as `cursor` to fetch the previous page. Absent on the first page.
+        prev_cursor: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            runs: T::Array[Courier::JourneyRunListItem],
+            next_cursor: String,
+            prev_cursor: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_run_response.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneyRunResponse < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::JourneyRunResponse, Courier::Internal::AnyHash)
+        end
+
+      # One run of a Journey. `status` and `created_at` are absent on a small number of
+      # legacy runs stored without them.
+      sig { returns(Courier::JourneyRun) }
+      attr_reader :run
+
+      sig { params(run: Courier::JourneyRun::OrHash).void }
+      attr_writer :run
+
+      # A single Journey run.
+      sig { params(run: Courier::JourneyRun::OrHash).returns(T.attached_class) }
+      def self.new(
+        # One run of a Journey. `status` and `created_at` are absent on a small number of
+        # legacy runs stored without them.
+        run:
+      )
+      end
+
+      sig { override.returns({ run: Courier::JourneyRun }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_run_step.rbi

@@ -0,0 +1,97 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneyRunStep < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::JourneyRunStep, Courier::Internal::AnyHash)
+        end
+
+      # The kind of node that ran, e.g. `send`, `delay`, or `exit`.
+      sig { returns(String) }
+      attr_accessor :action
+
+      # The state of the step: the seven run statuses, plus `SKIPPED` and `COMPUTING`.
+      # Not an enum — new values have been added before.
+      sig { returns(String) }
+      attr_accessor :status
+
+      # When the step started, as an ISO 8601 timestamp.
+      sig { returns(T.nilable(String)) }
+      attr_reader :created_at
+
+      sig { params(created_at: String).void }
+      attr_writer :created_at
+
+      # The message this step produced, present on send steps. Pass it to
+      # `GET /messages/{message_id}` for delivery status. A send to a List or an
+      # Audience yields one id for the request, not one per recipient.
+      sig { returns(T.nilable(String)) }
+      attr_reader :message_id
+
+      sig { params(message_id: String).void }
+      attr_writer :message_id
+
+      # The id of the node in the published Journey that this step executed.
+      sig { returns(T.nilable(String)) }
+      attr_reader :node_id
+
+      sig { params(node_id: String).void }
+      attr_writer :node_id
+
+      # When the step last changed state, as an ISO 8601 timestamp.
+      sig { returns(T.nilable(String)) }
+      attr_reader :updated_at
+
+      sig { params(updated_at: String).void }
+      attr_writer :updated_at
+
+      # One executed node of a Journey run. `node_id` is the id of the node in the
+      # published Journey, so a step maps directly onto the Journey graph.
+      sig do
+        params(
+          action: String,
+          status: String,
+          created_at: String,
+          message_id: String,
+          node_id: String,
+          updated_at: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The kind of node that ran, e.g. `send`, `delay`, or `exit`.
+        action:,
+        # The state of the step: the seven run statuses, plus `SKIPPED` and `COMPUTING`.
+        # Not an enum — new values have been added before.
+        status:,
+        # When the step started, as an ISO 8601 timestamp.
+        created_at: nil,
+        # The message this step produced, present on send steps. Pass it to
+        # `GET /messages/{message_id}` for delivery status. A send to a List or an
+        # Audience yields one id for the request, not one per recipient.
+        message_id: nil,
+        # The id of the node in the published Journey that this step executed.
+        node_id: nil,
+        # When the step last changed state, as an ISO 8601 timestamp.
+        updated_at: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            action: String,
+            status: String,
+            created_at: String,
+            message_id: String,
+            node_id: String,
+            updated_at: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_run_steps_response.rbi

@@ -0,0 +1,28 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneyRunStepsResponse < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::JourneyRunStepsResponse, Courier::Internal::AnyHash)
+        end
+
+      sig { returns(T::Array[Courier::JourneyRunStep]) }
+      attr_accessor :steps
+
+      # Every step of a Journey run. Not paginated.
+      sig do
+        params(steps: T::Array[Courier::JourneyRunStep::OrHash]).returns(
+          T.attached_class
+        )
+      end
+      def self.new(steps:)
+      end
+
+      sig { override.returns({ steps: T::Array[Courier::JourneyRunStep] }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_segment_trigger_node.rbi

@@ -57,7 +57,10 @@ module Courier
       sig { params(event_id: String).void }
       attr_writer :event_id
 
-      # Trigger fired by a segment event (`identify`, `group`, or `track`).
+      # Trigger fired by a segment event (`identify`, `group`, `track`, or `page`). A
+      # trigger with no `event_id` fires on any event of its type — the only shape
+      # `identify` and `group` can take, and the one that catches a stock
+      # `analytics.page()` call.
       sig do
         params(
           request_type:
@@ -134,6 +137,11 @@ module Courier
             :track,
             Courier::JourneySegmentTriggerNode::RequestType::TaggedSymbol
           )
+        PAGE =
+          T.let(
+            :page,
+            Courier::JourneySegmentTriggerNode::RequestType::TaggedSymbol
+          )
 
         sig do
           override.returns(