trycourier 4.10.1 → 4.11.0

data/rbi/courier/models/notification_template_response.rbi

@@ -0,0 +1,120 @@
+# typed: strong
+
+module Courier
+  module Models
+    class NotificationTemplateResponse < Courier::Models::NotificationTemplatePayload
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::NotificationTemplateResponse,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      # The template ID.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Epoch milliseconds when the template was created.
+      sig { returns(Integer) }
+      attr_accessor :created
+
+      # User ID of the creator.
+      sig { returns(String) }
+      attr_accessor :creator
+
+      # The template state. Always uppercase.
+      sig do
+        returns(Courier::NotificationTemplateResponse::State::TaggedSymbol)
+      end
+      attr_accessor :state
+
+      # Epoch milliseconds of last update.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :updated
+
+      sig { params(updated: Integer).void }
+      attr_writer :updated
+
+      # User ID of the last updater.
+      sig { returns(T.nilable(String)) }
+      attr_reader :updater
+
+      sig { params(updater: String).void }
+      attr_writer :updater
+
+      # Response for GET /notifications/{id}, POST /notifications, and PUT
+      # /notifications/{id}. Returns all template fields at the top level.
+      sig do
+        params(
+          id: String,
+          created: Integer,
+          creator: String,
+          state: Courier::NotificationTemplateResponse::State::OrSymbol,
+          updated: Integer,
+          updater: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The template ID.
+        id:,
+        # Epoch milliseconds when the template was created.
+        created:,
+        # User ID of the creator.
+        creator:,
+        # The template state. Always uppercase.
+        state:,
+        # Epoch milliseconds of last update.
+        updated: nil,
+        # User ID of the last updater.
+        updater: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created: Integer,
+            creator: String,
+            state: Courier::NotificationTemplateResponse::State::TaggedSymbol,
+            updated: Integer,
+            updater: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The template state. Always uppercase.
+      module State
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, Courier::NotificationTemplateResponse::State)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        DRAFT =
+          T.let(
+            :DRAFT,
+            Courier::NotificationTemplateResponse::State::TaggedSymbol
+          )
+        PUBLISHED =
+          T.let(
+            :PUBLISHED,
+            Courier::NotificationTemplateResponse::State::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Courier::NotificationTemplateResponse::State::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/notification_template_update_request.rbi

@@ -11,8 +11,8 @@ module Courier
           )
         end
 
-      # Full document shape used in POST and PUT request bodies, and returned inside the
-      # GET response envelope.
+      # Core template fields used in POST and PUT request bodies (nested under a
+      # `notification` key) and returned at the top level in responses.
       sig { returns(Courier::NotificationTemplatePayload) }
       attr_reader :notification
 
@@ -46,8 +46,8 @@ module Courier
         ).returns(T.attached_class)
       end
       def self.new(
-        # Full document shape used in POST and PUT request bodies, and returned inside the
-        # GET response envelope.
+        # Core template fields used in POST and PUT request bodies (nested under a
+        # `notification` key) and returned at the top level in responses.
         notification:,
         # Template state after update. Case-insensitive input, normalized to uppercase in
         # the response. Defaults to "DRAFT".

data/rbi/courier/models/tenants/template_delete_params.rbi

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

data/rbi/courier/models.rbi

@@ -97,6 +97,8 @@ module Courier
 
   Check = Courier::Models::Check
 
+  CreateJourneyRequest = Courier::Models::CreateJourneyRequest
+
   DefaultPreferences = Courier::Models::DefaultPreferences
 
   DeviceType = Courier::Models::DeviceType
@@ -155,16 +157,90 @@ module Courier
 
   Journey = Courier::Models::Journey
 
+  JourneyAINode = Courier::Models::JourneyAINode
+
+  JourneyAPIInvokeTriggerNode = Courier::Models::JourneyAPIInvokeTriggerNode
+
+  JourneyArchiveParams = Courier::Models::JourneyArchiveParams
+
+  JourneyConditionAtom =
+    T.let(
+      Courier::Models::JourneyConditionAtom,
+      Courier::Internal::Type::Converter
+    )
+
+  JourneyConditionGroup = Courier::Models::JourneyConditionGroup
+
+  JourneyConditionNestedGroup = Courier::Models::JourneyConditionNestedGroup
+
+  JourneyConditionsField = Courier::Models::JourneyConditionsField
+
+  JourneyCreateParams = Courier::Models::JourneyCreateParams
+
+  JourneyDelayDurationNode = Courier::Models::JourneyDelayDurationNode
+
+  JourneyDelayUntilNode = Courier::Models::JourneyDelayUntilNode
+
+  JourneyExitNode = Courier::Models::JourneyExitNode
+
+  JourneyFetchGetDeleteNode = Courier::Models::JourneyFetchGetDeleteNode
+
+  JourneyFetchPostPutNode = Courier::Models::JourneyFetchPostPutNode
+
   JourneyInvokeParams = Courier::Models::JourneyInvokeParams
 
   JourneyListParams = Courier::Models::JourneyListParams
 
+  JourneyListVersionsParams = Courier::Models::JourneyListVersionsParams
+
+  JourneyMergeStrategy = Courier::Models::JourneyMergeStrategy
+
+  JourneyNode = Courier::Models::JourneyNode
+
+  JourneyPublishParams = Courier::Models::JourneyPublishParams
+
+  JourneyPublishRequest = Courier::Models::JourneyPublishRequest
+
+  JourneyReplaceParams = Courier::Models::JourneyReplaceParams
+
+  JourneyResponse = Courier::Models::JourneyResponse
+
+  JourneyRetrieveParams = Courier::Models::JourneyRetrieveParams
+
+  Journeys = Courier::Models::Journeys
+
+  JourneySegmentTriggerNode = Courier::Models::JourneySegmentTriggerNode
+
+  JourneySendNode = Courier::Models::JourneySendNode
+
   JourneysInvokeRequest = Courier::Models::JourneysInvokeRequest
 
   JourneysInvokeResponse = Courier::Models::JourneysInvokeResponse
 
   JourneysListResponse = Courier::Models::JourneysListResponse
 
+  JourneyState = Courier::Models::JourneyState
+
+  JourneyTemplateCreateRequest = Courier::Models::JourneyTemplateCreateRequest
+
+  JourneyTemplateGetResponse = Courier::Models::JourneyTemplateGetResponse
+
+  JourneyTemplateListResponse = Courier::Models::JourneyTemplateListResponse
+
+  JourneyTemplatePublishRequest = Courier::Models::JourneyTemplatePublishRequest
+
+  JourneyTemplateReplaceRequest = Courier::Models::JourneyTemplateReplaceRequest
+
+  JourneyTemplateSummary = Courier::Models::JourneyTemplateSummary
+
+  JourneyThrottleDynamicNode = Courier::Models::JourneyThrottleDynamicNode
+
+  JourneyThrottleStaticNode = Courier::Models::JourneyThrottleStaticNode
+
+  JourneyVersionItem = Courier::Models::JourneyVersionItem
+
+  JourneyVersionsListResponse = Courier::Models::JourneyVersionsListResponse
+
   ListDeleteParams = Courier::Models::ListDeleteParams
 
   ListFilter = Courier::Models::ListFilter
@@ -266,14 +342,13 @@ module Courier
   NotificationTemplateCreateRequest =
     Courier::Models::NotificationTemplateCreateRequest
 
-  NotificationTemplateGetResponse =
-    Courier::Models::NotificationTemplateGetResponse
-
   NotificationTemplatePayload = Courier::Models::NotificationTemplatePayload
 
   NotificationTemplatePublishRequest =
     Courier::Models::NotificationTemplatePublishRequest
 
+  NotificationTemplateResponse = Courier::Models::NotificationTemplateResponse
+
   NotificationTemplateState = Courier::Models::NotificationTemplateState
 
   NotificationTemplateSummary = Courier::Models::NotificationTemplateSummary

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

@@ -0,0 +1,160 @@
+# typed: strong
+
+module Courier
+  module Resources
+    class Journeys
+      class Templates
+        # Create a notification template scoped to this journey. Defaults to `DRAFT`
+        # state; pass `state: "PUBLISHED"` to publish on create.
+        sig do
+          params(
+            template_id: String,
+            channel: String,
+            notification:
+              Courier::JourneyTemplateCreateRequest::Notification::OrHash,
+            provider_key: String,
+            state: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(Courier::JourneyTemplateGetResponse)
+        end
+        def create(
+          # Journey id
+          template_id,
+          channel:,
+          notification:,
+          provider_key: nil,
+          state: nil,
+          request_options: {}
+        )
+        end
+
+        # Fetch a journey-scoped notification template by id. Pass `?version=draft`
+        # (default `published`) to retrieve the working draft, or `?version=vN` for a
+        # historical version.
+        sig do
+          params(
+            notification_id: String,
+            template_id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(Courier::JourneyTemplateGetResponse)
+        end
+        def retrieve(
+          # Notification template id
+          notification_id,
+          # Journey id
+          template_id:,
+          request_options: {}
+        )
+        end
+
+        # List notification templates scoped to this journey. Journey-scoped notification
+        # templates can only be referenced from `send` nodes within the same journey.
+        sig do
+          params(
+            template_id: String,
+            cursor: String,
+            limit: Integer,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(Courier::JourneyTemplateListResponse)
+        end
+        def list(
+          # Journey id
+          template_id,
+          # Pagination cursor from a prior response.
+          cursor: nil,
+          # Page size. Minimum 1, maximum 100.
+          limit: nil,
+          request_options: {}
+        )
+        end
+
+        # Archive the journey-scoped notification template. Archived templates cannot be
+        # sent.
+        sig do
+          params(
+            notification_id: String,
+            template_id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).void
+        end
+        def archive(
+          # Notification template id
+          notification_id,
+          # Journey id
+          template_id:,
+          request_options: {}
+        )
+        end
+
+        # List published versions of the journey-scoped notification template, ordered
+        # most recent first.
+        sig do
+          params(
+            notification_id: String,
+            template_id: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(Courier::NotificationTemplateVersionListResponse)
+        end
+        def list_versions(
+          # Notification template id
+          notification_id,
+          # Journey id
+          template_id:,
+          request_options: {}
+        )
+        end
+
+        # Publish the current draft of the journey-scoped notification template as a new
+        # version. Optionally roll back to a prior version by passing
+        # `{ "version": "vN" }`.
+        sig do
+          params(
+            notification_id: String,
+            template_id: String,
+            version: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).void
+        end
+        def publish(
+          # Path param: Notification template id
+          notification_id,
+          # Path param: Journey id
+          template_id:,
+          # Body param
+          version: nil,
+          request_options: {}
+        )
+        end
+
+        # Replace the journey-scoped notification template draft.
+        sig do
+          params(
+            notification_id: String,
+            template_id: String,
+            notification:
+              Courier::JourneyTemplateReplaceRequest::Notification::OrHash,
+            state: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(Courier::JourneyTemplateGetResponse)
+        end
+        def replace(
+          # Path param: Notification template id
+          notification_id,
+          # Path param: Journey id
+          template_id:,
+          # Body param
+          notification:,
+          # Body param
+          state: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Courier::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/courier/resources/journeys.rbi

@@ -3,6 +3,68 @@
 module Courier
   module Resources
     class Journeys
+      sig { returns(Courier::Resources::Journeys::Templates) }
+      attr_reader :templates
+
+      # Create a journey. Defaults to `DRAFT` state; pass `state: "PUBLISHED"` to
+      # publish on create. Send nodes are not allowed on `POST`. The standard flow is:
+      # create the journey shell here, add notification templates with
+      # `POST /journeys/{templateId}/templates`, then wire them into the journey with
+      # `PUT /journeys/{templateId}`. Call `POST /journeys/{templateId}/publish` to
+      # publish a draft after the fact.
+      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,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(Courier::JourneyResponse)
+      end
+      def create(
+        name:,
+        nodes:,
+        enabled: nil,
+        # Lifecycle state of a journey.
+        state: nil,
+        request_options: {}
+      )
+      end
+
+      # Fetch a journey by id. Pass `?version=draft` (default `published`) to retrieve
+      # the working draft, or `?version=vN` to retrieve a historical version.
+      sig do
+        params(
+          template_id: String,
+          version: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(Courier::JourneyResponse)
+      end
+      def retrieve(
+        # Journey id
+        template_id,
+        # Version selector: `draft`, `published` (default), or `vN`.
+        version: nil,
+        request_options: {}
+      )
+      end
+
       # Get the list of journeys.
       sig do
         params(
@@ -22,7 +84,23 @@ module Courier
       )
       end
 
-      # Invoke a journey run from a journey template.
+      # Archive a journey. Archived journeys cannot be invoked. Existing journey runs
+      # continue to completion.
+      sig do
+        params(
+          template_id: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).void
+      end
+      def archive(
+        # Journey id
+        template_id,
+        request_options: {}
+      )
+      end
+
+      # Invoke a journey by id or alias to start a new run. The response includes a
+      # `runId` identifying the run.
       sig do
         params(
           template_id: String,
@@ -33,8 +111,8 @@ module Courier
         ).returns(Courier::JourneysInvokeResponse)
       end
       def invoke(
-        # A unique identifier representing the journey template to be invoked. This could
-        # be the Journey Template ID or the Journey Template Alias.
+        # A unique identifier representing the journey to be invoked. Accepts a Journey ID
+        # or Journey Alias.
         template_id,
         # Data payload passed to the journey. The expected shape can be predefined using
         # the schema builder in the journey editor. This data is available in journey
@@ -55,6 +133,81 @@ module Courier
       )
       end
 
+      # List published versions of a journey, ordered most recent first.
+      sig do
+        params(
+          template_id: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(Courier::JourneyVersionsListResponse)
+      end
+      def list_versions(
+        # Journey id
+        template_id,
+        request_options: {}
+      )
+      end
+
+      # Publish the current draft as a new version. Body is optional; pass
+      # `{ "version": "vN" }` to roll back to a prior version instead. Returns 404 if
+      # the journey has no draft to publish.
+      sig do
+        params(
+          template_id: String,
+          version: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(Courier::JourneyResponse)
+      end
+      def publish(
+        # Journey id
+        template_id,
+        version: nil,
+        request_options: {}
+      )
+      end
+
+      # Replace the journey draft. Updates the working draft only; call
+      # `POST /journeys/{templateId}/publish` to make it live, or pass
+      # `state: "PUBLISHED"` in this request to publish immediately. Send-node
+      # `template` ids must already exist and be scoped to this journey, and node ids
+      # must not be claimed by another journey.
+      sig do
+        params(
+          template_id: String,
+          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,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(Courier::JourneyResponse)
+      end
+      def replace(
+        # Journey id
+        template_id,
+        name:,
+        nodes:,
+        enabled: nil,
+        # Lifecycle state of a journey.
+        state: nil,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Courier::Client).returns(T.attached_class) }
       def self.new(client:)