feat(api): add put_content/put_element/put_locale, remove draft resource, update retrieve_content

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 100
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier%2Fcourier-06779bbaf9cb7a27215b6c6d1376f93a1e17ab21b111b55e89e9c989b1dc1b85.yml
-openapi_spec_hash: 69995747786fb3e075363162bc4c5d6f
-config_hash: c6ccb6f2954c650b88d1825501e727f5
+configured_endpoints: 102
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier%2Fcourier-c22b0f83f2edb9cc171977928b3e630e57a9b607a12c7ebaaee4bf2915ad0686.yml
+openapi_spec_hash: 9ebc6453998e155b12fb35c40c7d5249
+config_hash: cecef6fb68feaa0bda820cd86fa4f045

lib/courier.rb

@@ -62,6 +62,9 @@
 require_relative "courier/models/message_details"
 require_relative "courier/models/notification_template_create_request"
 require_relative "courier/models/notification_template_publish_request"
+require_relative "courier/models/notification_content_put_request"
+require_relative "courier/models/notification_element_put_request"
+require_relative "courier/models/notification_locale_put_request"
 require_relative "courier/models/notification_template_update_request"
 require_relative "courier/models/notification_template_payload"
 require_relative "courier/models/routing_strategy_create_request"
@@ -137,6 +140,7 @@
 require_relative "courier/models/elemental_node"
 require_relative "courier/models/elemental_quote_node_with_type"
 require_relative "courier/models/elemental_text_node_with_type"
+require_relative "courier/models/element_with_checksums"
 require_relative "courier/models/email_footer"
 require_relative "courier/models/email_head"
 require_relative "courier/models/email_header"
@@ -190,24 +194,30 @@
 require_relative "courier/models/ms_teams_recipient"
 require_relative "courier/models/multiple_tokens"
 require_relative "courier/models/notification_archive_params"
+require_relative "courier/models/notification_content_get_response"
+require_relative "courier/models/notification_content_mutation_response"
 require_relative "courier/models/notification_create_params"
 require_relative "courier/models/notification_get_content"
 require_relative "courier/models/notification_list_params"
 require_relative "courier/models/notification_list_response"
 require_relative "courier/models/notification_list_versions_params"
 require_relative "courier/models/notification_preference_details"
 require_relative "courier/models/notification_publish_params"
+require_relative "courier/models/notification_put_content_params"
+require_relative "courier/models/notification_put_element_params"
+require_relative "courier/models/notification_put_locale_params"
 require_relative "courier/models/notification_replace_params"
 require_relative "courier/models/notification_retrieve_content_params"
+require_relative "courier/models/notification_retrieve_content_response"
 require_relative "courier/models/notification_retrieve_params"
 require_relative "courier/models/notifications/check_delete_params"
 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/notifications/draft_retrieve_content_params"
 require_relative "courier/models/notification_template_get_response"
 require_relative "courier/models/notification_template_mutation_response"
+require_relative "courier/models/notification_template_state"
 require_relative "courier/models/notification_template_summary"
 require_relative "courier/models/notification_template_version_list_response"
 require_relative "courier/models/pagerduty"
@@ -343,7 +353,6 @@
 require_relative "courier/resources/messages"
 require_relative "courier/resources/notifications"
 require_relative "courier/resources/notifications/checks"
-require_relative "courier/resources/notifications/draft"
 require_relative "courier/resources/profiles"
 require_relative "courier/resources/profiles/lists"
 require_relative "courier/resources/providers"

lib/courier/models.rb

@@ -163,6 +163,8 @@ module Courier
 
   ElementalTextNodeWithType = Courier::Models::ElementalTextNodeWithType
 
+  ElementWithChecksums = Courier::Models::ElementWithChecksums
+
   EmailFooter = Courier::Models::EmailFooter
 
   EmailHead = Courier::Models::EmailHead
@@ -255,18 +257,34 @@ module Courier
 
   NotificationArchiveParams = Courier::Models::NotificationArchiveParams
 
+  NotificationContentGetResponse = Courier::Models::NotificationContentGetResponse
+
+  NotificationContentMutationResponse = Courier::Models::NotificationContentMutationResponse
+
+  NotificationContentPutRequest = Courier::Models::NotificationContentPutRequest
+
   NotificationCreateParams = Courier::Models::NotificationCreateParams
 
+  NotificationElementPutRequest = Courier::Models::NotificationElementPutRequest
+
   NotificationGetContent = Courier::Models::NotificationGetContent
 
   NotificationListParams = Courier::Models::NotificationListParams
 
   NotificationListVersionsParams = Courier::Models::NotificationListVersionsParams
 
+  NotificationLocalePutRequest = Courier::Models::NotificationLocalePutRequest
+
   NotificationPreferenceDetails = Courier::Models::NotificationPreferenceDetails
 
   NotificationPublishParams = Courier::Models::NotificationPublishParams
 
+  NotificationPutContentParams = Courier::Models::NotificationPutContentParams
+
+  NotificationPutElementParams = Courier::Models::NotificationPutElementParams
+
+  NotificationPutLocaleParams = Courier::Models::NotificationPutLocaleParams
+
   NotificationReplaceParams = Courier::Models::NotificationReplaceParams
 
   NotificationRetrieveContentParams = Courier::Models::NotificationRetrieveContentParams
@@ -285,6 +303,8 @@ module Courier
 
   NotificationTemplatePublishRequest = Courier::Models::NotificationTemplatePublishRequest
 
+  NotificationTemplateState = Courier::Models::NotificationTemplateState
+
   NotificationTemplateSummary = Courier::Models::NotificationTemplateSummary
 
   NotificationTemplateUpdateRequest = Courier::Models::NotificationTemplateUpdateRequest

lib/courier/models/element_with_checksums.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class ElementWithChecksums < Courier::Internal::Type::BaseModel
+      # @!attribute checksum
+      #   MD5 hash of translatable content.
+      #
+      #   @return [String]
+      required :checksum, String
+
+      # @!attribute type
+      #   Element type (text, meta, action, etc.).
+      #
+      #   @return [String]
+      required :type, String
+
+      # @!attribute id
+      #
+      #   @return [String, nil]
+      optional :id, String
+
+      # @!attribute elements
+      #   Nested child elements (for group-type elements).
+      #
+      #   @return [Array<Courier::Models::ElementWithChecksums>, nil]
+      optional :elements, -> { Courier::Internal::Type::ArrayOf[Courier::ElementWithChecksums] }
+
+      # @!attribute locales
+      #   Locale-specific content with checksums.
+      #
+      #   @return [Hash{Symbol=>Courier::Models::ElementWithChecksums::Locale}, nil]
+      optional :locales, -> { Courier::Internal::Type::HashOf[Courier::ElementWithChecksums::Locale] }
+
+      # @!method initialize(checksum:, type:, id: nil, elements: nil, locales: nil)
+      #   An element with its content checksum and optional nested elements and locale
+      #   checksums.
+      #
+      #   @param checksum [String] MD5 hash of translatable content.
+      #
+      #   @param type [String] Element type (text, meta, action, etc.).
+      #
+      #   @param id [String]
+      #
+      #   @param elements [Array<Courier::Models::ElementWithChecksums>] Nested child elements (for group-type elements).
+      #
+      #   @param locales [Hash{Symbol=>Courier::Models::ElementWithChecksums::Locale}] Locale-specific content with checksums.
+
+      class Locale < Courier::Internal::Type::BaseModel
+        # @!attribute checksum
+        #
+        #   @return [String]
+        required :checksum, String
+
+        # @!method initialize(checksum:)
+        #   @param checksum [String]
+      end
+    end
+  end
+end

lib/courier/models/notification_content_get_response.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class NotificationContentGetResponse < Courier::Internal::Type::BaseModel
+      # @!attribute elements
+      #
+      #   @return [Array<Courier::Models::ElementWithChecksums>]
+      required :elements, -> { Courier::Internal::Type::ArrayOf[Courier::ElementWithChecksums] }
+
+      # @!attribute version
+      #   Content version identifier.
+      #
+      #   @return [String]
+      required :version, String
+
+      # @!method initialize(elements:, version:)
+      #   Elemental content response for V2 templates. Contains versioned elements with
+      #   content checksums.
+      #
+      #   @param elements [Array<Courier::Models::ElementWithChecksums>]
+      #
+      #   @param version [String] Content version identifier.
+    end
+  end
+end

lib/courier/models/notification_content_mutation_response.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Notifications#put_content
+    class NotificationContentMutationResponse < Courier::Internal::Type::BaseModel
+      # @!attribute id
+      #   Template ID.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute elements
+      #
+      #   @return [Array<Courier::Models::NotificationContentMutationResponse::Element>]
+      required :elements,
+               -> { Courier::Internal::Type::ArrayOf[Courier::NotificationContentMutationResponse::Element] }
+
+      # @!attribute state
+      #   Template state. Defaults to `DRAFT`.
+      #
+      #   @return [Symbol, Courier::Models::NotificationTemplateState]
+      required :state, enum: -> { Courier::NotificationTemplateState }
+
+      # @!attribute version
+      #   Content version identifier.
+      #
+      #   @return [String]
+      required :version, String
+
+      # @!method initialize(id:, elements:, state:, version:)
+      #   Shared mutation response for `PUT` content, `PUT` element, and `PUT` locale
+      #   operations. Contains the template ID, content version, per-element checksums,
+      #   and resulting state.
+      #
+      #   @param id [String] Template ID.
+      #
+      #   @param elements [Array<Courier::Models::NotificationContentMutationResponse::Element>]
+      #
+      #   @param state [Symbol, Courier::Models::NotificationTemplateState] Template state. Defaults to `DRAFT`.
+      #
+      #   @param version [String] Content version identifier.
+
+      class Element < Courier::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute checksum
+        #
+        #   @return [String]
+        required :checksum, String
+
+        # @!method initialize(id:, checksum:)
+        #   @param id [String]
+        #   @param checksum [String]
+      end
+    end
+  end
+end

lib/courier/models/notification_content_put_request.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class NotificationContentPutRequest < Courier::Internal::Type::BaseModel
+      # @!attribute content
+      #   Elemental content payload. The server defaults `version` when omitted.
+      #
+      #   @return [Courier::Models::NotificationContentPutRequest::Content]
+      required :content, -> { Courier::NotificationContentPutRequest::Content }
+
+      # @!attribute state
+      #   Template state. Defaults to `DRAFT`.
+      #
+      #   @return [Symbol, Courier::Models::NotificationTemplateState, nil]
+      optional :state, enum: -> { Courier::NotificationTemplateState }
+
+      # @!method initialize(content:, state: nil)
+      #   Request body for replacing the elemental content of a notification template.
+      #
+      #   @param content [Courier::Models::NotificationContentPutRequest::Content] Elemental content payload. The server defaults `version` when omitted.
+      #
+      #   @param state [Symbol, Courier::Models::NotificationTemplateState] Template state. Defaults to `DRAFT`.
+
+      # @see Courier::Models::NotificationContentPutRequest#content
+      class Content < Courier::Internal::Type::BaseModel
+        # @!attribute elements
+        #
+        #   @return [Array<Courier::Models::ElementalTextNodeWithType, Courier::Models::ElementalMetaNodeWithType, Courier::Models::ElementalChannelNodeWithType, Courier::Models::ElementalImageNodeWithType, Courier::Models::ElementalActionNodeWithType, Courier::Models::ElementalDividerNodeWithType, Courier::Models::ElementalQuoteNodeWithType, Courier::Models::ElementalHTMLNodeWithType>]
+        required :elements, -> { Courier::Internal::Type::ArrayOf[union: Courier::ElementalNode] }
+
+        # @!attribute version
+        #   Content version identifier (e.g., `2022-01-01`). Optional; server defaults when
+        #   omitted.
+        #
+        #   @return [String, nil]
+        optional :version, String
+
+        # @!method initialize(elements:, version: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Courier::Models::NotificationContentPutRequest::Content} for more details.
+        #
+        #   Elemental content payload. The server defaults `version` when omitted.
+        #
+        #   @param elements [Array<Courier::Models::ElementalTextNodeWithType, Courier::Models::ElementalMetaNodeWithType, Courier::Models::ElementalChannelNodeWithType, Courier::Models::ElementalImageNodeWithType, Courier::Models::ElementalActionNodeWithType, Courier::Models::ElementalDividerNodeWithType, Courier::Models::ElementalQuoteNodeWithType, Courier::Models::ElementalHTMLNodeWithType>]
+        #
+        #   @param version [String] Content version identifier (e.g., `2022-01-01`). Optional; server defaults when
+      end
+    end
+  end
+end

lib/courier/models/notification_element_put_request.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class NotificationElementPutRequest < Courier::Internal::Type::BaseModel
+      # @!attribute type
+      #   Element type (text, meta, action, image, etc.).
+      #
+      #   @return [String]
+      required :type, String
+
+      # @!attribute channels
+      #
+      #   @return [Array<String>, nil]
+      optional :channels, Courier::Internal::Type::ArrayOf[String]
+
+      # @!attribute data
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :data, Courier::Internal::Type::HashOf[Courier::Internal::Type::Unknown]
+
+      # @!attribute if_
+      #
+      #   @return [String, nil]
+      optional :if_, String, api_name: :if
+
+      # @!attribute loop_
+      #
+      #   @return [String, nil]
+      optional :loop_, String, api_name: :loop
+
+      # @!attribute ref
+      #
+      #   @return [String, nil]
+      optional :ref, String
+
+      # @!attribute state
+      #   Template state. Defaults to `DRAFT`.
+      #
+      #   @return [Symbol, Courier::Models::NotificationTemplateState, nil]
+      optional :state, enum: -> { Courier::NotificationTemplateState }
+
+      # @!method initialize(type:, channels: nil, data: nil, if_: nil, loop_: nil, ref: nil, state: nil)
+      #   Request body for updating a single element. Additional type-specific fields are
+      #   allowed.
+      #
+      #   @param type [String] Element type (text, meta, action, image, etc.).
+      #
+      #   @param channels [Array<String>]
+      #
+      #   @param data [Hash{Symbol=>Object}]
+      #
+      #   @param if_ [String]
+      #
+      #   @param loop_ [String]
+      #
+      #   @param ref [String]
+      #
+      #   @param state [Symbol, Courier::Models::NotificationTemplateState] Template state. Defaults to `DRAFT`.
+    end
+  end
+end

lib/courier/models/notification_get_content.rb

@@ -2,7 +2,6 @@
 
 module Courier
   module Models
-    # @see Courier::Resources::Notifications#retrieve_content
     class NotificationGetContent < Courier::Internal::Type::BaseModel
       # @!attribute blocks
       #