trycourier 4.10.1 → 4.11.0

data/lib/courier/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Courier
-  VERSION = "4.10.1"
+  VERSION = "4.11.0"
 end

data/lib/courier.rb

@@ -58,7 +58,12 @@ require_relative "courier/models/inbound_bulk_message_user"
 require_relative "courier/models/base_check"
 require_relative "courier/models/subscription_topic_new"
 require_relative "courier/models/elemental_channel_node"
+require_relative "courier/models/create_journey_request"
 require_relative "courier/models/journeys_invoke_request"
+require_relative "courier/models/journey_publish_request"
+require_relative "courier/models/journey_template_create_request"
+require_relative "courier/models/journey_template_publish_request"
+require_relative "courier/models/journey_template_replace_request"
 require_relative "courier/models/message_details"
 require_relative "courier/models/notification_template_create_request"
 require_relative "courier/models/notification_template_publish_request"
@@ -154,10 +159,47 @@ require_relative "courier/models/inbound_track_event_response"
 require_relative "courier/models/intercom"
 require_relative "courier/models/intercom_recipient"
 require_relative "courier/models/journey"
+require_relative "courier/models/journey_ai_node"
+require_relative "courier/models/journey_api_invoke_trigger_node"
+require_relative "courier/models/journey_archive_params"
+require_relative "courier/models/journey_condition_atom"
+require_relative "courier/models/journey_condition_group"
+require_relative "courier/models/journey_condition_nested_group"
+require_relative "courier/models/journey_conditions_field"
+require_relative "courier/models/journey_create_params"
+require_relative "courier/models/journey_delay_duration_node"
+require_relative "courier/models/journey_delay_until_node"
+require_relative "courier/models/journey_exit_node"
+require_relative "courier/models/journey_fetch_get_delete_node"
+require_relative "courier/models/journey_fetch_post_put_node"
 require_relative "courier/models/journey_invoke_params"
 require_relative "courier/models/journey_list_params"
+require_relative "courier/models/journey_list_versions_params"
+require_relative "courier/models/journey_merge_strategy"
+require_relative "courier/models/journey_node"
+require_relative "courier/models/journey_publish_params"
+require_relative "courier/models/journey_replace_params"
+require_relative "courier/models/journey_response"
+require_relative "courier/models/journey_retrieve_params"
+require_relative "courier/models/journeys/template_archive_params"
+require_relative "courier/models/journeys/template_create_params"
+require_relative "courier/models/journeys/template_list_params"
+require_relative "courier/models/journeys/template_list_versions_params"
+require_relative "courier/models/journeys/template_publish_params"
+require_relative "courier/models/journeys/template_replace_params"
+require_relative "courier/models/journeys/template_retrieve_params"
+require_relative "courier/models/journey_segment_trigger_node"
+require_relative "courier/models/journey_send_node"
 require_relative "courier/models/journeys_invoke_response"
 require_relative "courier/models/journeys_list_response"
+require_relative "courier/models/journey_state"
+require_relative "courier/models/journey_template_get_response"
+require_relative "courier/models/journey_template_list_response"
+require_relative "courier/models/journey_template_summary"
+require_relative "courier/models/journey_throttle_dynamic_node"
+require_relative "courier/models/journey_throttle_static_node"
+require_relative "courier/models/journey_version_item"
+require_relative "courier/models/journey_versions_list_response"
 require_relative "courier/models/list_delete_params"
 require_relative "courier/models/list_filter"
 require_relative "courier/models/list_list_params"
@@ -216,7 +258,7 @@ require_relative "courier/models/notifications/check_list_params"
 require_relative "courier/models/notifications/check_list_response"
 require_relative "courier/models/notifications/check_update_params"
 require_relative "courier/models/notifications/check_update_response"
-require_relative "courier/models/notification_template_get_response"
+require_relative "courier/models/notification_template_response"
 require_relative "courier/models/notification_template_state"
 require_relative "courier/models/notification_template_summary"
 require_relative "courier/models/notification_template_version_list_response"
@@ -291,6 +333,7 @@ require_relative "courier/models/tenant_list_users_response"
 require_relative "courier/models/tenant_retrieve_params"
 require_relative "courier/models/tenants/preferences/item_delete_params"
 require_relative "courier/models/tenants/preferences/item_update_params"
+require_relative "courier/models/tenants/template_delete_params"
 require_relative "courier/models/tenants/template_list_params"
 require_relative "courier/models/tenants/template_list_response"
 require_relative "courier/models/tenants/template_publish_params"
@@ -348,6 +391,7 @@ require_relative "courier/resources/brands"
 require_relative "courier/resources/bulk"
 require_relative "courier/resources/inbound"
 require_relative "courier/resources/journeys"
+require_relative "courier/resources/journeys/templates"
 require_relative "courier/resources/lists"
 require_relative "courier/resources/lists/subscriptions"
 require_relative "courier/resources/messages"

data/rbi/courier/models/create_journey_request.rbi

@@ -0,0 +1,113 @@
+# typed: strong
+
+module Courier
+  module Models
+    class CreateJourneyRequest < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::CreateJourneyRequest, Courier::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :name
+
+      sig do
+        returns(
+          T::Array[
+            T.any(
+              Courier::JourneyAPIInvokeTriggerNode,
+              Courier::JourneySegmentTriggerNode,
+              Courier::JourneySendNode,
+              Courier::JourneyDelayDurationNode,
+              Courier::JourneyDelayUntilNode,
+              Courier::JourneyFetchGetDeleteNode,
+              Courier::JourneyFetchPostPutNode,
+              Courier::JourneyAINode,
+              Courier::JourneyThrottleStaticNode,
+              Courier::JourneyThrottleDynamicNode,
+              Courier::JourneyExitNode,
+              Courier::JourneyNode::JourneyBranchNode
+            )
+          ]
+        )
+      end
+      attr_accessor :nodes
+
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :enabled
+
+      sig { params(enabled: T::Boolean).void }
+      attr_writer :enabled
+
+      # Lifecycle state of a journey.
+      sig { returns(T.nilable(Courier::JourneyState::OrSymbol)) }
+      attr_reader :state
+
+      sig { params(state: Courier::JourneyState::OrSymbol).void }
+      attr_writer :state
+
+      # Request body for creating a journey.
+      sig do
+        params(
+          name: String,
+          nodes:
+            T::Array[
+              T.any(
+                Courier::JourneyAPIInvokeTriggerNode::OrHash,
+                Courier::JourneySegmentTriggerNode::OrHash,
+                Courier::JourneySendNode::OrHash,
+                Courier::JourneyDelayDurationNode::OrHash,
+                Courier::JourneyDelayUntilNode::OrHash,
+                Courier::JourneyFetchGetDeleteNode::OrHash,
+                Courier::JourneyFetchPostPutNode::OrHash,
+                Courier::JourneyAINode::OrHash,
+                Courier::JourneyThrottleStaticNode::OrHash,
+                Courier::JourneyThrottleDynamicNode::OrHash,
+                Courier::JourneyExitNode::OrHash,
+                Courier::JourneyNode::JourneyBranchNode::OrHash
+              )
+            ],
+          enabled: T::Boolean,
+          state: Courier::JourneyState::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        name:,
+        nodes:,
+        enabled: nil,
+        # Lifecycle state of a journey.
+        state: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            name: String,
+            nodes:
+              T::Array[
+                T.any(
+                  Courier::JourneyAPIInvokeTriggerNode,
+                  Courier::JourneySegmentTriggerNode,
+                  Courier::JourneySendNode,
+                  Courier::JourneyDelayDurationNode,
+                  Courier::JourneyDelayUntilNode,
+                  Courier::JourneyFetchGetDeleteNode,
+                  Courier::JourneyFetchPostPutNode,
+                  Courier::JourneyAINode,
+                  Courier::JourneyThrottleStaticNode,
+                  Courier::JourneyThrottleDynamicNode,
+                  Courier::JourneyExitNode,
+                  Courier::JourneyNode::JourneyBranchNode
+                )
+              ],
+            enabled: T::Boolean,
+            state: Courier::JourneyState::OrSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_ai_node.rbi

@@ -0,0 +1,141 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneyAINode < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::JourneyAINode, Courier::Internal::AnyHash)
+        end
+
+      # A JSONSchema object (Draft-07-compatible). Validated at runtime by Ajv.
+      sig { returns(T::Hash[Symbol, T.anything]) }
+      attr_accessor :output_schema
+
+      sig { returns(Courier::JourneyAINode::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
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :model
+
+      sig { params(model: String).void }
+      attr_writer :model
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :user_prompt
+
+      sig { params(user_prompt: String).void }
+      attr_writer :user_prompt
+
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :web_search
+
+      sig { params(web_search: T::Boolean).void }
+      attr_writer :web_search
+
+      # Invoke an AI step with `user_prompt` and optional `web_search`. Returns a
+      # structured response conforming to `output_schema`.
+      sig do
+        params(
+          output_schema: T::Hash[Symbol, T.anything],
+          type: Courier::JourneyAINode::Type::OrSymbol,
+          id: String,
+          conditions:
+            T.any(
+              T::Array[String],
+              Courier::JourneyConditionGroup::OrHash,
+              Courier::JourneyConditionNestedGroup::OrHash
+            ),
+          model: String,
+          user_prompt: String,
+          web_search: T::Boolean
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # A JSONSchema object (Draft-07-compatible). Validated at runtime by Ajv.
+        output_schema:,
+        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,
+        model: nil,
+        user_prompt: nil,
+        web_search: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            output_schema: T::Hash[Symbol, T.anything],
+            type: Courier::JourneyAINode::Type::OrSymbol,
+            id: String,
+            conditions:
+              T.any(
+                T::Array[String],
+                Courier::JourneyConditionGroup,
+                Courier::JourneyConditionNestedGroup
+              ),
+            model: String,
+            user_prompt: String,
+            web_search: T::Boolean
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Type
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Courier::JourneyAINode::Type) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AI = T.let(:ai, Courier::JourneyAINode::Type::TaggedSymbol)
+
+        sig do
+          override.returns(T::Array[Courier::JourneyAINode::Type::TaggedSymbol])
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_api_invoke_trigger_node.rbi

@@ -0,0 +1,164 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneyAPIInvokeTriggerNode < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::JourneyAPIInvokeTriggerNode,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      sig do
+        returns(Courier::JourneyAPIInvokeTriggerNode::TriggerType::OrSymbol)
+      end
+      attr_accessor :trigger_type
+
+      sig { returns(Courier::JourneyAPIInvokeTriggerNode::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
+
+      # A JSONSchema object (Draft-07-compatible). Validated at runtime by Ajv.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :schema
+
+      sig { params(schema: T::Hash[Symbol, T.anything]).void }
+      attr_writer :schema
+
+      # Trigger fired when the journey is invoked via the API. The optional `schema`
+      # field is a JSON Schema that validates the invocation payload.
+      sig do
+        params(
+          trigger_type:
+            Courier::JourneyAPIInvokeTriggerNode::TriggerType::OrSymbol,
+          type: Courier::JourneyAPIInvokeTriggerNode::Type::OrSymbol,
+          id: String,
+          conditions:
+            T.any(
+              T::Array[String],
+              Courier::JourneyConditionGroup::OrHash,
+              Courier::JourneyConditionNestedGroup::OrHash
+            ),
+          schema: T::Hash[Symbol, T.anything]
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        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,
+        # A JSONSchema object (Draft-07-compatible). Validated at runtime by Ajv.
+        schema: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            trigger_type:
+              Courier::JourneyAPIInvokeTriggerNode::TriggerType::OrSymbol,
+            type: Courier::JourneyAPIInvokeTriggerNode::Type::OrSymbol,
+            id: String,
+            conditions:
+              T.any(
+                T::Array[String],
+                Courier::JourneyConditionGroup,
+                Courier::JourneyConditionNestedGroup
+              ),
+            schema: T::Hash[Symbol, T.anything]
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module TriggerType
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Courier::JourneyAPIInvokeTriggerNode::TriggerType)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        API_INVOKE =
+          T.let(
+            :"api-invoke",
+            Courier::JourneyAPIInvokeTriggerNode::TriggerType::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              Courier::JourneyAPIInvokeTriggerNode::TriggerType::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      module Type
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Courier::JourneyAPIInvokeTriggerNode::Type)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRIGGER =
+          T.let(
+            :trigger,
+            Courier::JourneyAPIInvokeTriggerNode::Type::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Courier::JourneyAPIInvokeTriggerNode::Type::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_archive_params.rbi

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

data/rbi/courier/models/journey_condition_atom.rbi

@@ -0,0 +1,11 @@
+# typed: strong
+
+module Courier
+  module Models
+    JourneyConditionAtom =
+      T.let(
+        Courier::Internal::Type::ArrayOf[String],
+        Courier::Internal::Type::Converter
+      )
+  end
+end

data/rbi/courier/models/journey_condition_group.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneyConditionGroup < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::JourneyConditionGroup, Courier::Internal::AnyHash)
+        end
+
+      sig { returns(T.nilable(T::Array[T::Array[String]])) }
+      attr_reader :and_
+
+      sig { params(and_: T::Array[T::Array[String]]).void }
+      attr_writer :and_
+
+      sig { returns(T.nilable(T::Array[T::Array[String]])) }
+      attr_reader :or_
+
+      sig { params(or_: T::Array[T::Array[String]]).void }
+      attr_writer :or_
+
+      # A leaf condition group. Exactly one of `AND` or `OR` must be present at runtime;
+      # each is a list of `JourneyConditionAtom` tuples.
+      sig do
+        params(
+          and_: T::Array[T::Array[String]],
+          or_: T::Array[T::Array[String]]
+        ).returns(T.attached_class)
+      end
+      def self.new(and_: nil, or_: nil)
+      end
+
+      sig do
+        override.returns(
+          { and_: T::Array[T::Array[String]], or_: T::Array[T::Array[String]] }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_condition_nested_group.rbi

@@ -0,0 +1,51 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneyConditionNestedGroup < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::JourneyConditionNestedGroup,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      sig { returns(T.nilable(T::Array[Courier::JourneyConditionGroup])) }
+      attr_reader :and_
+
+      sig do
+        params(and_: T::Array[Courier::JourneyConditionGroup::OrHash]).void
+      end
+      attr_writer :and_
+
+      sig { returns(T.nilable(T::Array[Courier::JourneyConditionGroup])) }
+      attr_reader :or_
+
+      sig { params(or_: T::Array[Courier::JourneyConditionGroup::OrHash]).void }
+      attr_writer :or_
+
+      # A nested condition group. Exactly one of `AND` or `OR` must be present at
+      # runtime; each is a list of `JourneyConditionGroup` items.
+      sig do
+        params(
+          and_: T::Array[Courier::JourneyConditionGroup::OrHash],
+          or_: T::Array[Courier::JourneyConditionGroup::OrHash]
+        ).returns(T.attached_class)
+      end
+      def self.new(and_: nil, or_: nil)
+      end
+
+      sig do
+        override.returns(
+          {
+            and_: T::Array[Courier::JourneyConditionGroup],
+            or_: T::Array[Courier::JourneyConditionGroup]
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_conditions_field.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module Courier
+  module Models
+    # 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".
+    module JourneyConditionsField
+      extend Courier::Internal::Type::Union
+
+      Variants =
+        T.type_alias do
+          T.any(
+            T::Array[String],
+            Courier::JourneyConditionGroup,
+            Courier::JourneyConditionNestedGroup
+          )
+        end
+
+      sig do
+        override.returns(T::Array[Courier::JourneyConditionsField::Variants])
+      end
+      def self.variants
+      end
+    end
+  end
+end