trycourier 4.8.0 → 4.10.0

data/lib/courier/models/provider_update_params.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Providers#update
+    class ProviderUpdateParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute provider
+      #   The provider key identifying the type.
+      #
+      #   @return [String]
+      required :provider, String
+
+      # @!attribute alias_
+      #   Updated alias. Omit to clear.
+      #
+      #   @return [String, nil]
+      optional :alias_, String, api_name: :alias
+
+      # @!attribute settings
+      #   Provider-specific settings (snake_case keys). Replaces the full settings object
+      #   — omitted settings fields are removed. Use the catalog endpoint to check
+      #   required fields.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :settings, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown]
+
+      # @!attribute title
+      #   Updated display title.
+      #
+      #   @return [String, nil]
+      optional :title, String
+
+      # @!method initialize(id:, provider:, alias_: nil, settings: nil, title: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::ProviderUpdateParams} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param provider [String] The provider key identifying the type.
+      #
+      #   @param alias_ [String] Updated alias. Omit to clear.
+      #
+      #   @param settings [Hash{Symbol=>Object}] Provider-specific settings (snake_case keys). Replaces the full settings object
+      #
+      #   @param title [String] Updated display title.
+      #
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/providers/catalog_list_params.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    module Providers
+      # @see Courier::Resources::Providers::Catalog#list
+      class CatalogListParams < Courier::Internal::Type::BaseModel
+        extend Courier::Internal::Type::RequestParameters::Converter
+        include Courier::Internal::Type::RequestParameters
+
+        # @!attribute channel
+        #   Exact match (case-insensitive) against the provider channel taxonomy (e.g.
+        #   `email`, `sms`, `push`).
+        #
+        #   @return [String, nil]
+        optional :channel, String
+
+        # @!attribute keys
+        #   Comma-separated provider keys to filter by (e.g. `sendgrid,twilio`).
+        #
+        #   @return [String, nil]
+        optional :keys, String
+
+        # @!attribute name
+        #   Case-insensitive substring match against the provider display name.
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!method initialize(channel: nil, keys: nil, name: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Courier::Models::Providers::CatalogListParams} for more details.
+        #
+        #   @param channel [String] Exact match (case-insensitive) against the provider channel taxonomy (e.g. `emai
+        #
+        #   @param keys [String] Comma-separated provider keys to filter by (e.g. `sendgrid,twilio`).
+        #
+        #   @param name [String] Case-insensitive substring match against the provider display name.
+        #
+        #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/courier/models/providers/catalog_list_response.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    module Providers
+      # @see Courier::Resources::Providers::Catalog#list
+      class CatalogListResponse < Courier::Internal::Type::BaseModel
+        # @!attribute paging
+        #
+        #   @return [Courier::Models::Paging]
+        required :paging, -> { Courier::Paging }
+
+        # @!attribute results
+        #
+        #   @return [Array<Courier::Models::ProvidersCatalogEntry>]
+        required :results, -> { Courier::Internal::Type::ArrayOf[Courier::ProvidersCatalogEntry] }
+
+        # @!method initialize(paging:, results:)
+        #   Paginated list of available provider types with their configuration schemas.
+        #
+        #   @param paging [Courier::Models::Paging]
+        #   @param results [Array<Courier::Models::ProvidersCatalogEntry>]
+      end
+    end
+  end
+end

data/lib/courier/models/providers_catalog_entry.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class ProvidersCatalogEntry < Courier::Internal::Type::BaseModel
+      # @!attribute channel
+      #   Courier taxonomy channel (e.g. email, push, sms, direct_message, inbox,
+      #   webhook).
+      #
+      #   @return [String]
+      required :channel, String
+
+      # @!attribute description
+      #   Short description of the provider.
+      #
+      #   @return [String]
+      required :description, String
+
+      # @!attribute name
+      #   Human-readable display name.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute provider
+      #   The provider key (e.g. "sendgrid", "twilio").
+      #
+      #   @return [String]
+      required :provider, String
+
+      # @!attribute settings
+      #   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.
+      #
+      #   @return [Hash{Symbol=>Courier::Models::ProvidersCatalogEntry::Setting}]
+      required :settings, -> { Courier::Internal::Type::HashOf[Courier::ProvidersCatalogEntry::Setting] }
+
+      # @!method initialize(channel:, description:, name:, provider:, settings:)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::ProvidersCatalogEntry} for more details.
+      #
+      #   A provider type from the catalog. Contains the key, display name, description,
+      #   and a `settings` object describing configuration schema fields.
+      #
+      #   @param channel [String] Courier taxonomy channel (e.g. email, push, sms, direct_message, inbox, webhook)
+      #
+      #   @param description [String] Short description of the provider.
+      #
+      #   @param name [String] Human-readable display name.
+      #
+      #   @param provider [String] The provider key (e.g. "sendgrid", "twilio").
+      #
+      #   @param settings [Hash{Symbol=>Courier::Models::ProvidersCatalogEntry::Setting}] Map of setting field names (snake_case) to their schema descriptors. Each descri
+
+      class Setting < Courier::Internal::Type::BaseModel
+        # @!attribute required
+        #   Whether this field is required when configuring the provider.
+        #
+        #   @return [Boolean]
+        required :required, Courier::Internal::Type::Boolean
+
+        # @!attribute type
+        #   The field's data type (e.g. "string", "boolean", "enum").
+        #
+        #   @return [String]
+        required :type, String
+
+        # @!attribute values
+        #   Allowed values when `type` is "enum".
+        #
+        #   @return [Array<String>, nil]
+        optional :values, Courier::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(required:, type:, values: nil)
+        #   Describes a single configuration field in the provider catalog.
+        #
+        #   @param required [Boolean] Whether this field is required when configuring the provider.
+        #
+        #   @param type [String] The field's data type (e.g. "string", "boolean", "enum").
+        #
+        #   @param values [Array<String>] Allowed values when `type` is "enum".
+      end
+    end
+  end
+end

data/lib/courier/models/routing_strategy_archive_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#archive
+    class RoutingStrategyArchiveParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/routing_strategy_create_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#create
+    class RoutingStrategyCreateParams < Courier::Models::RoutingStrategyCreateRequest
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/routing_strategy_create_request.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class RoutingStrategyCreateRequest < Courier::Internal::Type::BaseModel
+      # @!attribute name
+      #   Human-readable name for the routing strategy.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute routing
+      #   Routing tree defining channel selection method and order.
+      #
+      #   @return [Courier::Models::MessageRouting]
+      required :routing, -> { Courier::MessageRouting }
+
+      # @!attribute channels
+      #   Per-channel delivery configuration. Defaults to empty if omitted.
+      #
+      #   @return [Hash{Symbol=>Courier::Models::Channel}, nil]
+      optional :channels, -> { Courier::Internal::Type::HashOf[Courier::Channel] }, nil?: true
+
+      # @!attribute description
+      #   Optional description of the routing strategy.
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute providers
+      #   Per-provider delivery configuration. Defaults to empty if omitted.
+      #
+      #   @return [Hash{Symbol=>Courier::Models::MessageProvidersType}, nil]
+      optional :providers, -> { Courier::Internal::Type::HashOf[Courier::MessageProvidersType] }, nil?: true
+
+      # @!attribute tags
+      #   Optional tags for categorization.
+      #
+      #   @return [Array<String>, nil]
+      optional :tags, Courier::Internal::Type::ArrayOf[String], nil?: true
+
+      # @!method initialize(name:, routing:, channels: nil, description: nil, providers: nil, tags: nil)
+      #   Request body for creating a routing strategy.
+      #
+      #   @param name [String] Human-readable name for the routing strategy.
+      #
+      #   @param routing [Courier::Models::MessageRouting] Routing tree defining channel selection method and order.
+      #
+      #   @param channels [Hash{Symbol=>Courier::Models::Channel}, nil] Per-channel delivery configuration. Defaults to empty if omitted.
+      #
+      #   @param description [String, nil] Optional description of the routing strategy.
+      #
+      #   @param providers [Hash{Symbol=>Courier::Models::MessageProvidersType}, nil] Per-provider delivery configuration. Defaults to empty if omitted.
+      #
+      #   @param tags [Array<String>, nil] Optional tags for categorization.
+    end
+  end
+end

data/lib/courier/models/routing_strategy_get_response.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#retrieve
+    class RoutingStrategyGetResponse < Courier::Internal::Type::BaseModel
+      # @!attribute id
+      #   The routing strategy ID (rs\_ prefix).
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute channels
+      #   Per-channel delivery configuration. May be empty.
+      #
+      #   @return [Hash{Symbol=>Courier::Models::Channel}]
+      required :channels, -> { Courier::Internal::Type::HashOf[Courier::Channel] }
+
+      # @!attribute created
+      #   Epoch milliseconds when the strategy was created.
+      #
+      #   @return [Integer]
+      required :created, Integer
+
+      # @!attribute creator
+      #   User ID of the creator.
+      #
+      #   @return [String]
+      required :creator, String
+
+      # @!attribute name
+      #   Human-readable name.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute providers
+      #   Per-provider delivery configuration. May be empty.
+      #
+      #   @return [Hash{Symbol=>Courier::Models::MessageProvidersType}]
+      required :providers, -> { Courier::Internal::Type::HashOf[Courier::MessageProvidersType] }
+
+      # @!attribute routing
+      #   Routing tree defining channel selection method and order.
+      #
+      #   @return [Courier::Models::MessageRouting]
+      required :routing, -> { Courier::MessageRouting }
+
+      # @!attribute description
+      #   Description of the routing strategy.
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute tags
+      #   Tags for categorization.
+      #
+      #   @return [Array<String>, nil]
+      optional :tags, Courier::Internal::Type::ArrayOf[String], nil?: true
+
+      # @!attribute updated
+      #   Epoch milliseconds of last update.
+      #
+      #   @return [Integer, nil]
+      optional :updated, Integer, nil?: true
+
+      # @!attribute updater
+      #   User ID of the last updater.
+      #
+      #   @return [String, nil]
+      optional :updater, String, nil?: true
+
+      # @!method initialize(id:, channels:, created:, creator:, name:, providers:, routing:, description: nil, tags: nil, updated: nil, updater: nil)
+      #   Full routing strategy entity returned by GET.
+      #
+      #   @param id [String] The routing strategy ID (rs\_ prefix).
+      #
+      #   @param channels [Hash{Symbol=>Courier::Models::Channel}] Per-channel delivery configuration. May be empty.
+      #
+      #   @param created [Integer] Epoch milliseconds when the strategy was created.
+      #
+      #   @param creator [String] User ID of the creator.
+      #
+      #   @param name [String] Human-readable name.
+      #
+      #   @param providers [Hash{Symbol=>Courier::Models::MessageProvidersType}] Per-provider delivery configuration. May be empty.
+      #
+      #   @param routing [Courier::Models::MessageRouting] Routing tree defining channel selection method and order.
+      #
+      #   @param description [String, nil] Description of the routing strategy.
+      #
+      #   @param tags [Array<String>, nil] Tags for categorization.
+      #
+      #   @param updated [Integer, nil] Epoch milliseconds of last update.
+      #
+      #   @param updater [String, nil] User ID of the last updater.
+    end
+  end
+end

data/lib/courier/models/routing_strategy_list_notifications_params.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#list_notifications
+    class RoutingStrategyListNotificationsParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute cursor
+      #   Opaque pagination cursor from a previous response. Omit for the first page.
+      #
+      #   @return [String, nil]
+      optional :cursor, String, nil?: true
+
+      # @!attribute limit
+      #   Maximum number of results per page. Default 20, max 100.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!method initialize(id:, cursor: nil, limit: nil, request_options: {})
+      #   @param id [String]
+      #
+      #   @param cursor [String, nil] Opaque pagination cursor from a previous response. Omit for the first page.
+      #
+      #   @param limit [Integer] Maximum number of results per page. Default 20, max 100.
+      #
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/routing_strategy_list_params.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#list
+    class RoutingStrategyListParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute cursor
+      #   Opaque pagination cursor from a previous response. Omit for the first page.
+      #
+      #   @return [String, nil]
+      optional :cursor, String, nil?: true
+
+      # @!attribute limit
+      #   Maximum number of results per page. Default 20, max 100.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!method initialize(cursor: nil, limit: nil, request_options: {})
+      #   @param cursor [String, nil] Opaque pagination cursor from a previous response. Omit for the first page.
+      #
+      #   @param limit [Integer] Maximum number of results per page. Default 20, max 100.
+      #
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/routing_strategy_list_response.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#list
+    class RoutingStrategyListResponse < Courier::Internal::Type::BaseModel
+      # @!attribute paging
+      #
+      #   @return [Courier::Models::Paging]
+      required :paging, -> { Courier::Paging }
+
+      # @!attribute results
+      #
+      #   @return [Array<Courier::Models::RoutingStrategySummary>]
+      required :results, -> { Courier::Internal::Type::ArrayOf[Courier::RoutingStrategySummary] }
+
+      # @!method initialize(paging:, results:)
+      #   Paginated list of routing strategy summaries.
+      #
+      #   @param paging [Courier::Models::Paging]
+      #   @param results [Array<Courier::Models::RoutingStrategySummary>]
+    end
+  end
+end

data/lib/courier/models/routing_strategy_mutation_response.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#create
+    class RoutingStrategyMutationResponse < Courier::Internal::Type::BaseModel
+      # @!attribute id
+      #   The routing strategy ID (rs\_ prefix).
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:)
+      #   Response returned by create and replace operations.
+      #
+      #   @param id [String] The routing strategy ID (rs\_ prefix).
+    end
+  end
+end

data/lib/courier/models/routing_strategy_replace_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#replace
+    class RoutingStrategyReplaceParams < Courier::Models::RoutingStrategyReplaceRequest
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/courier/models/routing_strategy_replace_request.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class RoutingStrategyReplaceRequest < Courier::Internal::Type::BaseModel
+      # @!attribute name
+      #   Human-readable name for the routing strategy.
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute routing
+      #   Routing tree defining channel selection method and order.
+      #
+      #   @return [Courier::Models::MessageRouting]
+      required :routing, -> { Courier::MessageRouting }
+
+      # @!attribute channels
+      #   Per-channel delivery configuration. Omit to clear.
+      #
+      #   @return [Hash{Symbol=>Courier::Models::Channel}, nil]
+      optional :channels, -> { Courier::Internal::Type::HashOf[Courier::Channel] }, nil?: true
+
+      # @!attribute description
+      #   Optional description. Omit or null to clear.
+      #
+      #   @return [String, nil]
+      optional :description, String, nil?: true
+
+      # @!attribute providers
+      #   Per-provider delivery configuration. Omit to clear.
+      #
+      #   @return [Hash{Symbol=>Courier::Models::MessageProvidersType}, nil]
+      optional :providers, -> { Courier::Internal::Type::HashOf[Courier::MessageProvidersType] }, nil?: true
+
+      # @!attribute tags
+      #   Optional tags. Omit or null to clear.
+      #
+      #   @return [Array<String>, nil]
+      optional :tags, Courier::Internal::Type::ArrayOf[String], nil?: true
+
+      # @!method initialize(name:, routing:, channels: nil, description: nil, providers: nil, tags: nil)
+      #   Request body for replacing a routing strategy. Full document replacement;
+      #   missing optional fields are cleared.
+      #
+      #   @param name [String] Human-readable name for the routing strategy.
+      #
+      #   @param routing [Courier::Models::MessageRouting] Routing tree defining channel selection method and order.
+      #
+      #   @param channels [Hash{Symbol=>Courier::Models::Channel}, nil] Per-channel delivery configuration. Omit to clear.
+      #
+      #   @param description [String, nil] Optional description. Omit or null to clear.
+      #
+      #   @param providers [Hash{Symbol=>Courier::Models::MessageProvidersType}, nil] Per-provider delivery configuration. Omit to clear.
+      #
+      #   @param tags [Array<String>, nil] Optional tags. Omit or null to clear.
+    end
+  end
+end

data/lib/courier/models/routing_strategy_retrieve_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::RoutingStrategies#retrieve
+    class RoutingStrategyRetrieveParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end