trycourier 4.7.1 → 4.9.0

data/rbi/courier/models/provider.rbi

@@ -0,0 +1,87 @@
+# typed: strong
+
+module Courier
+  module Models
+    class Provider < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Courier::Provider, Courier::Internal::AnyHash) }
+
+      # A unique identifier for the provider configuration.
+      sig { returns(String) }
+      attr_accessor :id
+
+      # Unix timestamp (ms) of when the provider was created.
+      sig { returns(Integer) }
+      attr_accessor :created
+
+      # The provider key (e.g. "sendgrid", "twilio", "slack").
+      sig { returns(String) }
+      attr_accessor :provider
+
+      # Provider-specific settings (snake_case keys on the wire).
+      sig { returns(T::Hash[Symbol, T.anything]) }
+      attr_accessor :settings
+
+      # Display title. Defaults to "Default Configuration" when not explicitly set.
+      sig { returns(String) }
+      attr_accessor :title
+
+      # Optional alias for this configuration.
+      sig { returns(T.nilable(String)) }
+      attr_reader :alias_
+
+      sig { params(alias_: String).void }
+      attr_writer :alias_
+
+      # Unix timestamp (ms) of when the provider was last updated.
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :updated
+
+      # A configured provider in the workspace.
+      sig do
+        params(
+          id: String,
+          created: Integer,
+          provider: String,
+          settings: T::Hash[Symbol, T.anything],
+          title: String,
+          alias_: String,
+          updated: T.nilable(Integer)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # A unique identifier for the provider configuration.
+        id:,
+        # Unix timestamp (ms) of when the provider was created.
+        created:,
+        # The provider key (e.g. "sendgrid", "twilio", "slack").
+        provider:,
+        # Provider-specific settings (snake_case keys on the wire).
+        settings:,
+        # Display title. Defaults to "Default Configuration" when not explicitly set.
+        title:,
+        # Optional alias for this configuration.
+        alias_: nil,
+        # Unix timestamp (ms) of when the provider was last updated.
+        updated: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            created: Integer,
+            provider: String,
+            settings: T::Hash[Symbol, T.anything],
+            title: String,
+            alias_: String,
+            updated: T.nilable(Integer)
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/provider_create_params.rbi

@@ -0,0 +1,82 @@
+# typed: strong
+
+module Courier
+  module Models
+    class ProviderCreateParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Courier::ProviderCreateParams, Courier::Internal::AnyHash)
+        end
+
+      # The provider key identifying the type (e.g. "sendgrid", "twilio"). Must be a
+      # known Courier provider — see the catalog endpoint for valid keys.
+      sig { returns(String) }
+      attr_accessor :provider
+
+      # Optional alias for this configuration.
+      sig { returns(T.nilable(String)) }
+      attr_reader :alias_
+
+      sig { params(alias_: String).void }
+      attr_writer :alias_
+
+      # Provider-specific settings (snake_case keys). Defaults to an empty object when
+      # omitted. Use the catalog endpoint to discover required fields for a given
+      # provider — omitting a required field returns a 400 validation error.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :settings
+
+      sig { params(settings: T::Hash[Symbol, T.anything]).void }
+      attr_writer :settings
+
+      # Optional display title. Omit to use "Default Configuration".
+      sig { returns(T.nilable(String)) }
+      attr_reader :title
+
+      sig { params(title: String).void }
+      attr_writer :title
+
+      sig do
+        params(
+          provider: String,
+          alias_: String,
+          settings: T::Hash[Symbol, T.anything],
+          title: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The provider key identifying the type (e.g. "sendgrid", "twilio"). Must be a
+        # known Courier provider — see the catalog endpoint for valid keys.
+        provider:,
+        # Optional alias for this configuration.
+        alias_: nil,
+        # Provider-specific settings (snake_case keys). Defaults to an empty object when
+        # omitted. Use the catalog endpoint to discover required fields for a given
+        # provider — omitting a required field returns a 400 validation error.
+        settings: nil,
+        # Optional display title. Omit to use "Default Configuration".
+        title: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            provider: String,
+            alias_: String,
+            settings: T::Hash[Symbol, T.anything],
+            title: String,
+            request_options: Courier::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/provider_delete_params.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module Courier
+  module Models
+    class ProviderDeleteParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Courier::ProviderDeleteParams, 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

data/rbi/courier/models/provider_list_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Courier
+  module Models
+    class ProviderListParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Courier::ProviderListParams, Courier::Internal::AnyHash)
+        end
+
+      # Opaque cursor for fetching the next page.
+      sig { returns(T.nilable(String)) }
+      attr_reader :cursor
+
+      sig { params(cursor: String).void }
+      attr_writer :cursor
+
+      sig do
+        params(
+          cursor: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Opaque cursor for fetching the next page.
+        cursor: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          { cursor: String, request_options: Courier::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/provider_list_response.rbi

@@ -0,0 +1,42 @@
+# typed: strong
+
+module Courier
+  module Models
+    class ProviderListResponse < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::Models::ProviderListResponse,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      sig { returns(Courier::Paging) }
+      attr_reader :paging
+
+      sig { params(paging: Courier::Paging::OrHash).void }
+      attr_writer :paging
+
+      sig { returns(T::Array[Courier::Provider]) }
+      attr_accessor :results
+
+      # Paginated list of provider configurations.
+      sig do
+        params(
+          paging: Courier::Paging::OrHash,
+          results: T::Array[Courier::Provider::OrHash]
+        ).returns(T.attached_class)
+      end
+      def self.new(paging:, results:)
+      end
+
+      sig do
+        override.returns(
+          { paging: Courier::Paging, results: T::Array[Courier::Provider] }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/provider_retrieve_params.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module Courier
+  module Models
+    class ProviderRetrieveParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Courier::ProviderRetrieveParams, 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

data/rbi/courier/models/provider_update_params.rbi

@@ -0,0 +1,86 @@
+# typed: strong
+
+module Courier
+  module Models
+    class ProviderUpdateParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Courier::ProviderUpdateParams, Courier::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :id
+
+      # The provider key identifying the type.
+      sig { returns(String) }
+      attr_accessor :provider
+
+      # Updated alias. Omit to clear.
+      sig { returns(T.nilable(String)) }
+      attr_reader :alias_
+
+      sig { params(alias_: String).void }
+      attr_writer :alias_
+
+      # Provider-specific settings (snake_case keys). Replaces the full settings object
+      # — omitted settings fields are removed. Use the catalog endpoint to check
+      # required fields.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :settings
+
+      sig { params(settings: T::Hash[Symbol, T.anything]).void }
+      attr_writer :settings
+
+      # Updated display title.
+      sig { returns(T.nilable(String)) }
+      attr_reader :title
+
+      sig { params(title: String).void }
+      attr_writer :title
+
+      sig do
+        params(
+          id: String,
+          provider: String,
+          alias_: String,
+          settings: T::Hash[Symbol, T.anything],
+          title: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        # The provider key identifying the type.
+        provider:,
+        # Updated alias. Omit to clear.
+        alias_: nil,
+        # Provider-specific settings (snake_case keys). Replaces the full settings object
+        # — omitted settings fields are removed. Use the catalog endpoint to check
+        # required fields.
+        settings: nil,
+        # Updated display title.
+        title: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            id: String,
+            provider: String,
+            alias_: String,
+            settings: T::Hash[Symbol, T.anything],
+            title: String,
+            request_options: Courier::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/providers/catalog_list_params.rbi

@@ -0,0 +1,75 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Providers
+      class CatalogListParams < Courier::Internal::Type::BaseModel
+        extend Courier::Internal::Type::RequestParameters::Converter
+        include Courier::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(
+              Courier::Providers::CatalogListParams,
+              Courier::Internal::AnyHash
+            )
+          end
+
+        # Exact match (case-insensitive) against the provider channel taxonomy (e.g.
+        # `email`, `sms`, `push`).
+        sig { returns(T.nilable(String)) }
+        attr_reader :channel
+
+        sig { params(channel: String).void }
+        attr_writer :channel
+
+        # Comma-separated provider keys to filter by (e.g. `sendgrid,twilio`).
+        sig { returns(T.nilable(String)) }
+        attr_reader :keys
+
+        sig { params(keys: String).void }
+        attr_writer :keys
+
+        # Case-insensitive substring match against the provider display name.
+        sig { returns(T.nilable(String)) }
+        attr_reader :name
+
+        sig { params(name: String).void }
+        attr_writer :name
+
+        sig do
+          params(
+            channel: String,
+            keys: String,
+            name: String,
+            request_options: Courier::RequestOptions::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Exact match (case-insensitive) against the provider channel taxonomy (e.g.
+          # `email`, `sms`, `push`).
+          channel: nil,
+          # Comma-separated provider keys to filter by (e.g. `sendgrid,twilio`).
+          keys: nil,
+          # Case-insensitive substring match against the provider display name.
+          name: nil,
+          request_options: {}
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              channel: String,
+              keys: String,
+              name: String,
+              request_options: Courier::RequestOptions
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/providers/catalog_list_response.rbi

@@ -0,0 +1,47 @@
+# typed: strong
+
+module Courier
+  module Models
+    module Providers
+      class CatalogListResponse < Courier::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Courier::Models::Providers::CatalogListResponse,
+              Courier::Internal::AnyHash
+            )
+          end
+
+        sig { returns(Courier::Paging) }
+        attr_reader :paging
+
+        sig { params(paging: Courier::Paging::OrHash).void }
+        attr_writer :paging
+
+        sig { returns(T::Array[Courier::ProvidersCatalogEntry]) }
+        attr_accessor :results
+
+        # Paginated list of available provider types with their configuration schemas.
+        sig do
+          params(
+            paging: Courier::Paging::OrHash,
+            results: T::Array[Courier::ProvidersCatalogEntry::OrHash]
+          ).returns(T.attached_class)
+        end
+        def self.new(paging:, results:)
+        end
+
+        sig do
+          override.returns(
+            {
+              paging: Courier::Paging,
+              results: T::Array[Courier::ProvidersCatalogEntry]
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/providers_catalog_entry.rbi

@@ -0,0 +1,129 @@
+# typed: strong
+
+module Courier
+  module Models
+    class ProvidersCatalogEntry < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::ProvidersCatalogEntry, Courier::Internal::AnyHash)
+        end
+
+      # Courier taxonomy channel (e.g. email, push, sms, direct_message, inbox,
+      # webhook).
+      sig { returns(String) }
+      attr_accessor :channel
+
+      # Short description of the provider.
+      sig { returns(String) }
+      attr_accessor :description
+
+      # Human-readable display name.
+      sig { returns(String) }
+      attr_accessor :name
+
+      # The provider key (e.g. "sendgrid", "twilio").
+      sig { returns(String) }
+      attr_accessor :provider
+
+      # Map of setting field names (snake_case) to their schema descriptors. Each
+      # descriptor has `type` and `required`. Empty when the provider has no
+      # configurable schema.
+      sig { returns(T::Hash[Symbol, Courier::ProvidersCatalogEntry::Setting]) }
+      attr_accessor :settings
+
+      # A provider type from the catalog. Contains the key, display name, description,
+      # and a `settings` object describing configuration schema fields.
+      sig do
+        params(
+          channel: String,
+          description: String,
+          name: String,
+          provider: String,
+          settings:
+            T::Hash[Symbol, Courier::ProvidersCatalogEntry::Setting::OrHash]
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Courier taxonomy channel (e.g. email, push, sms, direct_message, inbox,
+        # webhook).
+        channel:,
+        # Short description of the provider.
+        description:,
+        # Human-readable display name.
+        name:,
+        # The provider key (e.g. "sendgrid", "twilio").
+        provider:,
+        # Map of setting field names (snake_case) to their schema descriptors. Each
+        # descriptor has `type` and `required`. Empty when the provider has no
+        # configurable schema.
+        settings:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            channel: String,
+            description: String,
+            name: String,
+            provider: String,
+            settings: T::Hash[Symbol, Courier::ProvidersCatalogEntry::Setting]
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Setting < Courier::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Courier::ProvidersCatalogEntry::Setting,
+              Courier::Internal::AnyHash
+            )
+          end
+
+        # Whether this field is required when configuring the provider.
+        sig { returns(T::Boolean) }
+        attr_accessor :required
+
+        # The field's data type (e.g. "string", "boolean", "enum").
+        sig { returns(String) }
+        attr_accessor :type
+
+        # Allowed values when `type` is "enum".
+        sig { returns(T.nilable(T::Array[String])) }
+        attr_reader :values
+
+        sig { params(values: T::Array[String]).void }
+        attr_writer :values
+
+        # Describes a single configuration field in the provider catalog.
+        sig do
+          params(
+            required: T::Boolean,
+            type: String,
+            values: T::Array[String]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Whether this field is required when configuring the provider.
+          required:,
+          # The field's data type (e.g. "string", "boolean", "enum").
+          type:,
+          # Allowed values when `type` is "enum".
+          values: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            { required: T::Boolean, type: String, values: T::Array[String] }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/request_archive_params.rbi

@@ -11,15 +11,23 @@ module Courier
           T.any(Courier::RequestArchiveParams, Courier::Internal::AnyHash)
         end
 
+      sig { returns(String) }
+      attr_accessor :request_id
+
       sig do
-        params(request_options: Courier::RequestOptions::OrHash).returns(
-          T.attached_class
-        )
+        params(
+          request_id: String,
+          request_options: Courier::RequestOptions::OrHash
+        ).returns(T.attached_class)
       end
-      def self.new(request_options: {})
+      def self.new(request_id:, request_options: {})
       end
 
-      sig { override.returns({ request_options: Courier::RequestOptions }) }
+      sig do
+        override.returns(
+          { request_id: String, request_options: Courier::RequestOptions }
+        )
+      end
       def to_hash
       end
     end