trycourier 6.10.0 → 6.11.0

data/rbi/courier/models/notifications/previews/preview_result_status.rbi

@@ -0,0 +1,69 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Notifications
+      PreviewResultStatus = Previews::PreviewResultStatus
+
+      module Previews
+        # One device's outcome. `COMPLETED` means the screenshot exists and its URLs are
+        # populated. `UNSUPPORTED`, `TIMED_OUT` and `FAILED` are all terminal, and none
+        # stands in for another — `UNSUPPORTED` means the device was retired at the
+        # vendor, `TIMED_OUT` means it did not report in time.
+        module PreviewResultStatus
+          extend Courier::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Courier::Notifications::Previews::PreviewResultStatus
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          PENDING =
+            T.let(
+              :PENDING,
+              Courier::Notifications::Previews::PreviewResultStatus::TaggedSymbol
+            )
+          PROCESSING =
+            T.let(
+              :PROCESSING,
+              Courier::Notifications::Previews::PreviewResultStatus::TaggedSymbol
+            )
+          COMPLETED =
+            T.let(
+              :COMPLETED,
+              Courier::Notifications::Previews::PreviewResultStatus::TaggedSymbol
+            )
+          UNSUPPORTED =
+            T.let(
+              :UNSUPPORTED,
+              Courier::Notifications::Previews::PreviewResultStatus::TaggedSymbol
+            )
+          TIMED_OUT =
+            T.let(
+              :TIMED_OUT,
+              Courier::Notifications::Previews::PreviewResultStatus::TaggedSymbol
+            )
+          FAILED =
+            T.let(
+              :FAILED,
+              Courier::Notifications::Previews::PreviewResultStatus::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Courier::Notifications::Previews::PreviewResultStatus::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/notifications/previews/preview_run.rbi

@@ -0,0 +1,134 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Notifications
+      PreviewRun = Previews::PreviewRun
+
+      module Previews
+        class PreviewRun < Courier::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::Notifications::Previews::PreviewRun,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          # Unique identifier for the preview run.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # ISO-8601 timestamp of when the run was created.
+          sig { returns(String) }
+          attr_accessor :created_at
+
+          # The devices this run was submitted for, snapshotted when the run was created.
+          sig { returns(T::Array[String]) }
+          attr_accessor :device_ids
+
+          # Where the run itself has got to. `PENDING` and `RENDERED` mean Courier is still
+          # preparing the email, `SUBMITTED` means it is with the rendering service, and
+          # `COMPLETED` means every device has reported. `FAILED` is the run as a whole
+          # failing — an individual device failing never fails the run.
+          sig do
+            returns(
+              Courier::Notifications::Previews::PreviewRunStatus::TaggedSymbol
+            )
+          end
+          attr_accessor :status
+
+          # The template that was rendered.
+          sig { returns(String) }
+          attr_accessor :template_id
+
+          # Why the run failed, when `status` is `FAILED`. `NO_EMAIL_CHANNEL` and
+          # `TEMPLATE_NOT_SUPPORTED` mean there was nothing to render;
+          # `ALL_DEVICES_UNSUPPORTED` means every requested device has been retired and the
+          # request can be fixed by choosing others.
+          sig do
+            returns(
+              T.nilable(
+                Courier::Notifications::Previews::PreviewRunFailureReason::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :failure_reason
+
+          sig do
+            params(
+              failure_reason:
+                Courier::Notifications::Previews::PreviewRunFailureReason::OrSymbol
+            ).void
+          end
+          attr_writer :failure_reason
+
+          # The version of the template that was rendered — `draft`, or a zero-padded
+          # published version such as `v002`. Absent until the render settles.
+          sig { returns(T.nilable(String)) }
+          attr_reader :template_version
+
+          sig { params(template_version: String).void }
+          attr_writer :template_version
+
+          # One render of a template across a set of devices. Billable.
+          sig do
+            params(
+              id: String,
+              created_at: String,
+              device_ids: T::Array[String],
+              status:
+                Courier::Notifications::Previews::PreviewRunStatus::OrSymbol,
+              template_id: String,
+              failure_reason:
+                Courier::Notifications::Previews::PreviewRunFailureReason::OrSymbol,
+              template_version: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Unique identifier for the preview run.
+            id:,
+            # ISO-8601 timestamp of when the run was created.
+            created_at:,
+            # The devices this run was submitted for, snapshotted when the run was created.
+            device_ids:,
+            # Where the run itself has got to. `PENDING` and `RENDERED` mean Courier is still
+            # preparing the email, `SUBMITTED` means it is with the rendering service, and
+            # `COMPLETED` means every device has reported. `FAILED` is the run as a whole
+            # failing — an individual device failing never fails the run.
+            status:,
+            # The template that was rendered.
+            template_id:,
+            # Why the run failed, when `status` is `FAILED`. `NO_EMAIL_CHANNEL` and
+            # `TEMPLATE_NOT_SUPPORTED` mean there was nothing to render;
+            # `ALL_DEVICES_UNSUPPORTED` means every requested device has been retired and the
+            # request can be fixed by choosing others.
+            failure_reason: nil,
+            # The version of the template that was rendered — `draft`, or a zero-padded
+            # published version such as `v002`. Absent until the render settles.
+            template_version: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                created_at: String,
+                device_ids: T::Array[String],
+                status:
+                  Courier::Notifications::Previews::PreviewRunStatus::TaggedSymbol,
+                template_id: String,
+                failure_reason:
+                  Courier::Notifications::Previews::PreviewRunFailureReason::TaggedSymbol,
+                template_version: String
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/notifications/previews/preview_run_detail.rbi

@@ -0,0 +1,148 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Notifications
+      PreviewRunDetail = Previews::PreviewRunDetail
+
+      module Previews
+        class PreviewRunDetail < Courier::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::Notifications::Previews::PreviewRunDetail,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          # Unique identifier for the preview run.
+          sig { returns(String) }
+          attr_accessor :id
+
+          # ISO-8601 timestamp of when the run was created.
+          sig { returns(String) }
+          attr_accessor :created_at
+
+          # The devices this run was submitted for, snapshotted when the run was created.
+          sig { returns(T::Array[String]) }
+          attr_accessor :device_ids
+
+          # One entry per device in `device_ids`.
+          sig do
+            returns(T::Array[Courier::Notifications::Previews::PreviewResult])
+          end
+          attr_accessor :results
+
+          # Where the run itself has got to. `PENDING` and `RENDERED` mean Courier is still
+          # preparing the email, `SUBMITTED` means it is with the rendering service, and
+          # `COMPLETED` means every device has reported. `FAILED` is the run as a whole
+          # failing — an individual device failing never fails the run.
+          sig do
+            returns(
+              Courier::Notifications::Previews::PreviewRunStatus::TaggedSymbol
+            )
+          end
+          attr_accessor :status
+
+          # The template that was rendered.
+          sig { returns(String) }
+          attr_accessor :template_id
+
+          # Why the run failed, when `status` is `FAILED`. `NO_EMAIL_CHANNEL` and
+          # `TEMPLATE_NOT_SUPPORTED` mean there was nothing to render;
+          # `ALL_DEVICES_UNSUPPORTED` means every requested device has been retired and the
+          # request can be fixed by choosing others.
+          sig do
+            returns(
+              T.nilable(
+                Courier::Notifications::Previews::PreviewRunFailureReason::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :failure_reason
+
+          sig do
+            params(
+              failure_reason:
+                Courier::Notifications::Previews::PreviewRunFailureReason::OrSymbol
+            ).void
+          end
+          attr_writer :failure_reason
+
+          # The version of the template that was rendered — `draft`, or a zero-padded
+          # published version such as `v002`. Absent until the render settles.
+          sig { returns(T.nilable(String)) }
+          attr_reader :template_version
+
+          sig { params(template_version: String).void }
+          attr_writer :template_version
+
+          # A preview run together with its per-device results.
+          sig do
+            params(
+              id: String,
+              created_at: String,
+              device_ids: T::Array[String],
+              results:
+                T::Array[
+                  Courier::Notifications::Previews::PreviewResult::OrHash
+                ],
+              status:
+                Courier::Notifications::Previews::PreviewRunStatus::OrSymbol,
+              template_id: String,
+              failure_reason:
+                Courier::Notifications::Previews::PreviewRunFailureReason::OrSymbol,
+              template_version: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Unique identifier for the preview run.
+            id:,
+            # ISO-8601 timestamp of when the run was created.
+            created_at:,
+            # The devices this run was submitted for, snapshotted when the run was created.
+            device_ids:,
+            # One entry per device in `device_ids`.
+            results:,
+            # Where the run itself has got to. `PENDING` and `RENDERED` mean Courier is still
+            # preparing the email, `SUBMITTED` means it is with the rendering service, and
+            # `COMPLETED` means every device has reported. `FAILED` is the run as a whole
+            # failing — an individual device failing never fails the run.
+            status:,
+            # The template that was rendered.
+            template_id:,
+            # Why the run failed, when `status` is `FAILED`. `NO_EMAIL_CHANNEL` and
+            # `TEMPLATE_NOT_SUPPORTED` mean there was nothing to render;
+            # `ALL_DEVICES_UNSUPPORTED` means every requested device has been retired and the
+            # request can be fixed by choosing others.
+            failure_reason: nil,
+            # The version of the template that was rendered — `draft`, or a zero-padded
+            # published version such as `v002`. Absent until the render settles.
+            template_version: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                created_at: String,
+                device_ids: T::Array[String],
+                results:
+                  T::Array[Courier::Notifications::Previews::PreviewResult],
+                status:
+                  Courier::Notifications::Previews::PreviewRunStatus::TaggedSymbol,
+                template_id: String,
+                failure_reason:
+                  Courier::Notifications::Previews::PreviewRunFailureReason::TaggedSymbol,
+                template_version: String
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/notifications/previews/preview_run_failure_reason.rbi

@@ -0,0 +1,64 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Notifications
+      PreviewRunFailureReason = Previews::PreviewRunFailureReason
+
+      module Previews
+        # Why the run failed, when `status` is `FAILED`. `NO_EMAIL_CHANNEL` and
+        # `TEMPLATE_NOT_SUPPORTED` mean there was nothing to render;
+        # `ALL_DEVICES_UNSUPPORTED` means every requested device has been retired and the
+        # request can be fixed by choosing others.
+        module PreviewRunFailureReason
+          extend Courier::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Courier::Notifications::Previews::PreviewRunFailureReason
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          TEMPLATE_NOT_SUPPORTED =
+            T.let(
+              :TEMPLATE_NOT_SUPPORTED,
+              Courier::Notifications::Previews::PreviewRunFailureReason::TaggedSymbol
+            )
+          NO_EMAIL_CHANNEL =
+            T.let(
+              :NO_EMAIL_CHANNEL,
+              Courier::Notifications::Previews::PreviewRunFailureReason::TaggedSymbol
+            )
+          RENDER_FAILED =
+            T.let(
+              :RENDER_FAILED,
+              Courier::Notifications::Previews::PreviewRunFailureReason::TaggedSymbol
+            )
+          ALL_DEVICES_UNSUPPORTED =
+            T.let(
+              :ALL_DEVICES_UNSUPPORTED,
+              Courier::Notifications::Previews::PreviewRunFailureReason::TaggedSymbol
+            )
+          VENDOR_ERROR =
+            T.let(
+              :VENDOR_ERROR,
+              Courier::Notifications::Previews::PreviewRunFailureReason::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Courier::Notifications::Previews::PreviewRunFailureReason::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/notifications/previews/preview_run_list_response.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Notifications
+      PreviewRunListResponse = Previews::PreviewRunListResponse
+
+      module Previews
+        class PreviewRunListResponse < Courier::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::Notifications::Previews::PreviewRunListResponse,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          sig { returns(Courier::Paging) }
+          attr_reader :paging
+
+          sig { params(paging: Courier::Paging::OrHash).void }
+          attr_writer :paging
+
+          sig do
+            returns(T::Array[Courier::Notifications::Previews::PreviewRun])
+          end
+          attr_accessor :results
+
+          # Paginated list of preview runs, newest first.
+          sig do
+            params(
+              paging: Courier::Paging::OrHash,
+              results:
+                T::Array[Courier::Notifications::Previews::PreviewRun::OrHash]
+            ).returns(T.attached_class)
+          end
+          def self.new(paging:, results:)
+          end
+
+          sig do
+            override.returns(
+              {
+                paging: Courier::Paging,
+                results: T::Array[Courier::Notifications::Previews::PreviewRun]
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/notifications/previews/preview_run_status.rbi

@@ -0,0 +1,61 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Notifications
+      PreviewRunStatus = Previews::PreviewRunStatus
+
+      module Previews
+        # Where the run itself has got to. `PENDING` and `RENDERED` mean Courier is still
+        # preparing the email, `SUBMITTED` means it is with the rendering service, and
+        # `COMPLETED` means every device has reported. `FAILED` is the run as a whole
+        # failing — an individual device failing never fails the run.
+        module PreviewRunStatus
+          extend Courier::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Courier::Notifications::Previews::PreviewRunStatus)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          PENDING =
+            T.let(
+              :PENDING,
+              Courier::Notifications::Previews::PreviewRunStatus::TaggedSymbol
+            )
+          RENDERED =
+            T.let(
+              :RENDERED,
+              Courier::Notifications::Previews::PreviewRunStatus::TaggedSymbol
+            )
+          SUBMITTED =
+            T.let(
+              :SUBMITTED,
+              Courier::Notifications::Previews::PreviewRunStatus::TaggedSymbol
+            )
+          COMPLETED =
+            T.let(
+              :COMPLETED,
+              Courier::Notifications::Previews::PreviewRunStatus::TaggedSymbol
+            )
+          FAILED =
+            T.let(
+              :FAILED,
+              Courier::Notifications::Previews::PreviewRunStatus::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Courier::Notifications::Previews::PreviewRunStatus::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/notifications/previews/run_create_params.rbi

@@ -0,0 +1,66 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Notifications
+      module Previews
+        class RunCreateParams < Courier::Models::Notifications::Previews::CreatePreviewRunRequest
+          extend Courier::Internal::Type::RequestParameters::Converter
+          include Courier::Internal::Type::RequestParameters
+
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::Notifications::Previews::RunCreateParams,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :id
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :idempotency_key
+
+          sig { params(idempotency_key: String).void }
+          attr_writer :idempotency_key
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :x_idempotency_expiration
+
+          sig { params(x_idempotency_expiration: String).void }
+          attr_writer :x_idempotency_expiration
+
+          sig do
+            params(
+              id: String,
+              idempotency_key: String,
+              x_idempotency_expiration: String,
+              request_options: Courier::RequestOptions::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            id:,
+            idempotency_key: nil,
+            x_idempotency_expiration: nil,
+            request_options: {}
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                idempotency_key: String,
+                x_idempotency_expiration: String,
+                request_options: Courier::RequestOptions
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/notifications/previews/run_list_params.rbi

@@ -0,0 +1,67 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Notifications
+      module Previews
+        class RunListParams < Courier::Internal::Type::BaseModel
+          extend Courier::Internal::Type::RequestParameters::Converter
+          include Courier::Internal::Type::RequestParameters
+
+          OrHash =
+            T.type_alias do
+              T.any(
+                Courier::Notifications::Previews::RunListParams,
+                Courier::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :id
+
+          # Opaque pagination cursor from a previous response. Omit for the first page.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :cursor
+
+          # Maximum number of results per page.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :limit
+
+          sig { params(limit: Integer).void }
+          attr_writer :limit
+
+          sig do
+            params(
+              id: String,
+              cursor: T.nilable(String),
+              limit: Integer,
+              request_options: Courier::RequestOptions::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            id:,
+            # Opaque pagination cursor from a previous response. Omit for the first page.
+            cursor: nil,
+            # Maximum number of results per page.
+            limit: nil,
+            request_options: {}
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                id: String,
+                cursor: T.nilable(String),
+                limit: Integer,
+                request_options: Courier::RequestOptions
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end