trycourier 6.4.0 → 6.4.2

data/rbi/courier/models/elemental_meta_node_with_type.rbi

@@ -2,7 +2,7 @@
 
 module Courier
   module Models
-    class ElementalMetaNodeWithType < Courier::Models::ElementalBaseNode
+    class ElementalMetaNodeWithType < Courier::Models::ElementalMetaNode
       OrHash =
         T.type_alias do
           T.any(Courier::ElementalMetaNodeWithType, Courier::Internal::AnyHash)
@@ -18,6 +18,9 @@ module Courier
       end
       attr_writer :type
 
+      # The meta element contains information describing the notification that may be
+      # used by a particular channel or provider. One important field is the title field
+      # which will be used as the title for channels that support it.
       sig do
         params(
           type: Courier::ElementalMetaNodeWithType::Type::OrSymbol

data/rbi/courier/models/elemental_node.rbi

@@ -2,16 +2,7 @@
 
 module Courier
   module Models
-    # The channel element allows a notification to be customized based on which
-    # channel it is sent through. For example, you may want to display a detailed
-    # message when the notification is sent through email, and a more concise message
-    # in a push notification. Channel elements are only valid as top-level elements;
-    # you cannot nest channel elements. If there is a channel element specified at the
-    # top-level of the document, all sibling elements must be channel elements. Note:
-    # As an alternative, most elements support a `channel` property. Which allows you
-    # to selectively display an individual element on a per channel basis. See the
-    # [control flow docs](https://www.courier.com/docs/platform/content/elemental/control-flow/)
-    # for more details.
+    # Represents a body of text to be rendered inside of the notification.
     module ElementalNode
       extend Courier::Internal::Type::Union
 

data/rbi/courier/models/elemental_quote_node.rbi

@@ -0,0 +1,95 @@
+# typed: strong
+
+module Courier
+  module Models
+    class ElementalQuoteNode < Courier::Models::ElementalBaseNode
+      OrHash =
+        T.type_alias do
+          T.any(Courier::ElementalQuoteNode, Courier::Internal::AnyHash)
+        end
+
+      # The text value of the quote.
+      sig { returns(String) }
+      attr_accessor :content
+
+      # Alignment of the quote.
+      sig { returns(T.nilable(Courier::Alignment::OrSymbol)) }
+      attr_accessor :align
+
+      # CSS border color property. For example, `#fff`
+      sig { returns(T.nilable(String)) }
+      attr_accessor :border_color
+
+      # CSS px font size for this quote block, e.g. `16px`. Overrides the size of the
+      # `text_style` preset. Email only.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :font_size
+
+      # CSS line height for this quote block, as a px value or a unitless multiplier,
+      # e.g. `24px` or `1.5`. Email only.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :line_height
+
+      # Region specific content. See
+      # [locales docs](https://www.courier.com/docs/platform/content/elemental/locales/)
+      # for more details.
+      sig { returns(T.nilable(T::Hash[Symbol, Courier::LocaleItem])) }
+      attr_accessor :locales
+
+      sig { returns(T.nilable(Courier::TextStyle::OrSymbol)) }
+      attr_reader :text_style
+
+      sig { params(text_style: Courier::TextStyle::OrSymbol).void }
+      attr_writer :text_style
+
+      # Renders a quote block.
+      sig do
+        params(
+          content: String,
+          align: T.nilable(Courier::Alignment::OrSymbol),
+          border_color: T.nilable(String),
+          font_size: T.nilable(String),
+          line_height: T.nilable(String),
+          locales: T.nilable(T::Hash[Symbol, Courier::LocaleItem::OrHash]),
+          text_style: Courier::TextStyle::OrSymbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The text value of the quote.
+        content:,
+        # Alignment of the quote.
+        align: nil,
+        # CSS border color property. For example, `#fff`
+        border_color: nil,
+        # CSS px font size for this quote block, e.g. `16px`. Overrides the size of the
+        # `text_style` preset. Email only.
+        font_size: nil,
+        # CSS line height for this quote block, as a px value or a unitless multiplier,
+        # e.g. `24px` or `1.5`. Email only.
+        line_height: nil,
+        # Region specific content. See
+        # [locales docs](https://www.courier.com/docs/platform/content/elemental/locales/)
+        # for more details.
+        locales: nil,
+        text_style: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            content: String,
+            align: T.nilable(Courier::Alignment::OrSymbol),
+            border_color: T.nilable(String),
+            font_size: T.nilable(String),
+            line_height: T.nilable(String),
+            locales: T.nilable(T::Hash[Symbol, Courier::LocaleItem]),
+            text_style: Courier::TextStyle::OrSymbol
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/elemental_quote_node_with_type.rbi

@@ -2,7 +2,7 @@
 
 module Courier
   module Models
-    class ElementalQuoteNodeWithType < Courier::Models::ElementalBaseNode
+    class ElementalQuoteNodeWithType < Courier::Models::ElementalQuoteNode
       OrHash =
         T.type_alias do
           T.any(Courier::ElementalQuoteNodeWithType, Courier::Internal::AnyHash)
@@ -18,6 +18,7 @@ module Courier
       end
       attr_writer :type
 
+      # Renders a quote block.
       sig do
         params(
           type: Courier::ElementalQuoteNodeWithType::Type::OrSymbol

data/rbi/courier/models/elemental_text_node.rbi

@@ -0,0 +1,177 @@
+# typed: strong
+
+module Courier
+  module Models
+    class ElementalTextNode < Courier::Models::ElementalBaseNode
+      OrHash =
+        T.type_alias do
+          T.any(Courier::ElementalTextNode, Courier::Internal::AnyHash)
+        end
+
+      # The text content displayed in the notification. Either this field must be
+      # specified, or the elements field
+      sig { returns(String) }
+      attr_accessor :content
+
+      # Text alignment.
+      sig { returns(T.nilable(Courier::ElementalTextNode::Align::OrSymbol)) }
+      attr_reader :align
+
+      sig { params(align: Courier::ElementalTextNode::Align::OrSymbol).void }
+      attr_writer :align
+
+      # Apply bold to the text
+      sig { returns(T.nilable(String)) }
+      attr_accessor :bold
+
+      # Specifies the color of text. Can be any valid css color value
+      sig { returns(T.nilable(String)) }
+      attr_accessor :color
+
+      # CSS px font size for this text block, e.g. `16px`. Overrides the size of the
+      # `text_style` preset. Email only.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :font_size
+
+      sig { returns(T.nilable(Courier::ElementalTextNode::Format::OrSymbol)) }
+      attr_accessor :format_
+
+      # Apply italics to the text
+      sig { returns(T.nilable(String)) }
+      attr_accessor :italic
+
+      # CSS line height for this text block, as a px value or a unitless multiplier,
+      # e.g. `24px` or `1.5`. Email only.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :line_height
+
+      # Region specific content. See
+      # [locales docs](https://www.courier.com/docs/platform/content/elemental/locales/)
+      # for more details.
+      sig { returns(T.nilable(T::Hash[Symbol, Courier::LocaleItem])) }
+      attr_accessor :locales
+
+      # Apply a strike through the text
+      sig { returns(T.nilable(String)) }
+      attr_accessor :strikethrough
+
+      # Allows the text to be rendered as a heading level.
+      sig { returns(T.nilable(Courier::TextStyle::OrSymbol)) }
+      attr_accessor :text_style
+
+      # Apply an underline to the text
+      sig { returns(T.nilable(String)) }
+      attr_accessor :underline
+
+      # Represents a body of text to be rendered inside of the notification.
+      sig do
+        params(
+          content: String,
+          align: Courier::ElementalTextNode::Align::OrSymbol,
+          bold: T.nilable(String),
+          color: T.nilable(String),
+          font_size: T.nilable(String),
+          format_: T.nilable(Courier::ElementalTextNode::Format::OrSymbol),
+          italic: T.nilable(String),
+          line_height: T.nilable(String),
+          locales: T.nilable(T::Hash[Symbol, Courier::LocaleItem::OrHash]),
+          strikethrough: T.nilable(String),
+          text_style: T.nilable(Courier::TextStyle::OrSymbol),
+          underline: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The text content displayed in the notification. Either this field must be
+        # specified, or the elements field
+        content:,
+        # Text alignment.
+        align: nil,
+        # Apply bold to the text
+        bold: nil,
+        # Specifies the color of text. Can be any valid css color value
+        color: nil,
+        # CSS px font size for this text block, e.g. `16px`. Overrides the size of the
+        # `text_style` preset. Email only.
+        font_size: nil,
+        format_: nil,
+        # Apply italics to the text
+        italic: nil,
+        # CSS line height for this text block, as a px value or a unitless multiplier,
+        # e.g. `24px` or `1.5`. Email only.
+        line_height: nil,
+        # Region specific content. See
+        # [locales docs](https://www.courier.com/docs/platform/content/elemental/locales/)
+        # for more details.
+        locales: nil,
+        # Apply a strike through the text
+        strikethrough: nil,
+        # Allows the text to be rendered as a heading level.
+        text_style: nil,
+        # Apply an underline to the text
+        underline: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            content: String,
+            align: Courier::ElementalTextNode::Align::OrSymbol,
+            bold: T.nilable(String),
+            color: T.nilable(String),
+            font_size: T.nilable(String),
+            format_: T.nilable(Courier::ElementalTextNode::Format::OrSymbol),
+            italic: T.nilable(String),
+            line_height: T.nilable(String),
+            locales: T.nilable(T::Hash[Symbol, Courier::LocaleItem]),
+            strikethrough: T.nilable(String),
+            text_style: T.nilable(Courier::TextStyle::OrSymbol),
+            underline: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Text alignment.
+      module Align
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Courier::ElementalTextNode::Align) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        LEFT = T.let(:left, Courier::ElementalTextNode::Align::TaggedSymbol)
+        CENTER = T.let(:center, Courier::ElementalTextNode::Align::TaggedSymbol)
+        RIGHT = T.let(:right, Courier::ElementalTextNode::Align::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Courier::ElementalTextNode::Align::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      module Format
+        extend Courier::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Courier::ElementalTextNode::Format) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        MARKDOWN =
+          T.let(:markdown, Courier::ElementalTextNode::Format::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Courier::ElementalTextNode::Format::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/courier/models/elemental_text_node_with_type.rbi

@@ -2,7 +2,7 @@
 
 module Courier
   module Models
-    class ElementalTextNodeWithType < Courier::Models::ElementalBaseNode
+    class ElementalTextNodeWithType < Courier::Models::ElementalTextNode
       OrHash =
         T.type_alias do
           T.any(Courier::ElementalTextNodeWithType, Courier::Internal::AnyHash)
@@ -18,6 +18,7 @@ module Courier
       end
       attr_writer :type
 
+      # Represents a body of text to be rendered inside of the notification.
       sig do
         params(
           type: Courier::ElementalTextNodeWithType::Type::OrSymbol

data/rbi/courier/models/locales.rbi

@@ -0,0 +1,27 @@
+# typed: strong
+
+module Courier
+  module Models
+    class LocaleItem < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias { T.any(Courier::LocaleItem, Courier::Internal::AnyHash) }
+
+      sig { returns(String) }
+      attr_accessor :content
+
+      sig { params(content: String).returns(T.attached_class) }
+      def self.new(content:)
+      end
+
+      sig { override.returns({ content: String }) }
+      def to_hash
+      end
+    end
+
+    Locales =
+      T.let(
+        Courier::Internal::Type::HashOf[Courier::LocaleItem],
+        Courier::Internal::Type::Converter
+      )
+  end
+end

data/rbi/courier/models.rbi

@@ -160,6 +160,8 @@ module Courier
 
   Discord = Courier::Models::Discord
 
+  ElementalActionNode = Courier::Models::ElementalActionNode
+
   ElementalActionNodeWithType = Courier::Models::ElementalActionNodeWithType
 
   ElementalBaseNode = Courier::Models::ElementalBaseNode
@@ -172,18 +174,30 @@ module Courier
 
   ElementalContentSugar = Courier::Models::ElementalContentSugar
 
+  ElementalDividerNode = Courier::Models::ElementalDividerNode
+
   ElementalDividerNodeWithType = Courier::Models::ElementalDividerNodeWithType
 
+  ElementalHTMLNode = Courier::Models::ElementalHTMLNode
+
   ElementalHTMLNodeWithType = Courier::Models::ElementalHTMLNodeWithType
 
+  ElementalImageNode = Courier::Models::ElementalImageNode
+
   ElementalImageNodeWithType = Courier::Models::ElementalImageNodeWithType
 
+  ElementalMetaNode = Courier::Models::ElementalMetaNode
+
   ElementalMetaNodeWithType = Courier::Models::ElementalMetaNodeWithType
 
   ElementalNode = Courier::Models::ElementalNode
 
+  ElementalQuoteNode = Courier::Models::ElementalQuoteNode
+
   ElementalQuoteNodeWithType = Courier::Models::ElementalQuoteNodeWithType
 
+  ElementalTextNode = Courier::Models::ElementalTextNode
+
   ElementalTextNodeWithType = Courier::Models::ElementalTextNodeWithType
 
   ElementWithChecksums = Courier::Models::ElementWithChecksums
@@ -346,6 +360,10 @@ module Courier
 
   ListUpdateParams = Courier::Models::ListUpdateParams
 
+  LocaleItem = Courier::Models::LocaleItem
+
+  Locales = T.let(Courier::Models::Locales, Courier::Internal::Type::Converter)
+
   Logo = Courier::Models::Logo
 
   MessageCancelParams = Courier::Models::MessageCancelParams

data/sig/courier/models/elemental_action_node.rbs

@@ -0,0 +1,112 @@
+module Courier
+  module Models
+    type elemental_action_node =
+      {
+        content: String,
+        href: String,
+        action_id: String?,
+        align: Courier::Models::alignment?,
+        background_color: String?,
+        border_radius: String?,
+        border_size: String?,
+        disable_tracking: bool?,
+        font_size: String?,
+        locales: Courier::Models::locales?,
+        padding: String?,
+        style: Courier::Models::ElementalActionNode::style?
+      }
+
+    class ElementalActionNode < Courier::Models::ElementalBaseNode
+      def content: -> String
+
+      def content=: (String _) -> String
+
+      def href: -> String
+
+      def href=: (String _) -> String
+
+      def action_id: -> String?
+
+      def action_id=: (String? _) -> String?
+
+      def align: -> Courier::Models::alignment?
+
+      def align=: (Courier::Models::alignment? _) -> Courier::Models::alignment?
+
+      def background_color: -> String?
+
+      def background_color=: (String? _) -> String?
+
+      def border_radius: -> String?
+
+      def border_radius=: (String? _) -> String?
+
+      def border_size: -> String?
+
+      def border_size=: (String? _) -> String?
+
+      def disable_tracking: -> bool?
+
+      def disable_tracking=: (bool? _) -> bool?
+
+      def font_size: -> String?
+
+      def font_size=: (String? _) -> String?
+
+      def locales: -> Courier::Models::locales?
+
+      def locales=: (Courier::Models::locales? _) -> Courier::Models::locales?
+
+      def padding: -> String?
+
+      def padding=: (String? _) -> String?
+
+      def style: -> Courier::Models::ElementalActionNode::style?
+
+      def style=: (
+        Courier::Models::ElementalActionNode::style? _
+      ) -> Courier::Models::ElementalActionNode::style?
+
+      def initialize: (
+        content: String,
+        href: String,
+        ?action_id: String?,
+        ?align: Courier::Models::alignment?,
+        ?background_color: String?,
+        ?border_radius: String?,
+        ?border_size: String?,
+        ?disable_tracking: bool?,
+        ?font_size: String?,
+        ?locales: Courier::Models::locales?,
+        ?padding: String?,
+        ?style: Courier::Models::ElementalActionNode::style?
+      ) -> void
+
+      def to_hash: -> {
+        content: String,
+        href: String,
+        action_id: String?,
+        align: Courier::Models::alignment?,
+        background_color: String?,
+        border_radius: String?,
+        border_size: String?,
+        disable_tracking: bool?,
+        font_size: String?,
+        locales: Courier::Models::locales?,
+        padding: String?,
+        style: Courier::Models::ElementalActionNode::style?
+      }
+
+      type style = :button | :link
+
+      module Style
+        extend Courier::Internal::Type::Enum
+
+        BUTTON: :button
+        LINK: :link
+
+        def self?.values: -> ::Array[Courier::Models::ElementalActionNode::style]
+      end
+    end
+  end
+end

data/sig/courier/models/elemental_action_node_with_type.rbs

@@ -3,7 +3,7 @@ module Courier
     type elemental_action_node_with_type =
       { type: Courier::Models::ElementalActionNodeWithType::type_ }
 
-    class ElementalActionNodeWithType < Courier::Models::ElementalBaseNode
+    class ElementalActionNodeWithType < Courier::Models::ElementalActionNode
       def `type`: -> Courier::Models::ElementalActionNodeWithType::type_?
 
       def type=: (

data/sig/courier/models/elemental_divider_node.rbs

@@ -0,0 +1,15 @@
+module Courier
+  module Models
+    type elemental_divider_node = { color: String? }
+
+    class ElementalDividerNode < Courier::Models::ElementalBaseNode
+      def color: -> String?
+
+      def color=: (String? _) -> String?
+
+      def initialize: (?color: String?) -> void
+
+      def to_hash: -> { color: String? }
+    end
+  end
+end

data/sig/courier/models/elemental_divider_node_with_type.rbs

@@ -3,7 +3,7 @@ module Courier
     type elemental_divider_node_with_type =
       { type: Courier::Models::ElementalDividerNodeWithType::type_ }
 
-    class ElementalDividerNodeWithType < Courier::Models::ElementalBaseNode
+    class ElementalDividerNodeWithType < Courier::Models::ElementalDividerNode
       def `type`: -> Courier::Models::ElementalDividerNodeWithType::type_?
 
       def type=: (

data/sig/courier/models/elemental_html_node.rbs

@@ -0,0 +1,23 @@
+module Courier
+  module Models
+    type elemental_html_node =
+      { content: String, locales: Courier::Models::locales? }
+
+    class ElementalHTMLNode < Courier::Models::ElementalBaseNode
+      def content: -> String
+
+      def content=: (String _) -> String
+
+      def locales: -> Courier::Models::locales?
+
+      def locales=: (Courier::Models::locales? _) -> Courier::Models::locales?
+
+      def initialize: (
+        content: String,
+        ?locales: Courier::Models::locales?
+      ) -> void
+
+      def to_hash: -> { content: String, locales: Courier::Models::locales? }
+    end
+  end
+end

data/sig/courier/models/elemental_html_node_with_type.rbs

@@ -3,7 +3,7 @@ module Courier
     type elemental_html_node_with_type =
       { type: Courier::Models::ElementalHTMLNodeWithType::type_ }
 
-    class ElementalHTMLNodeWithType < Courier::Models::ElementalBaseNode
+    class ElementalHTMLNodeWithType < Courier::Models::ElementalHTMLNode
       def `type`: -> Courier::Models::ElementalHTMLNodeWithType::type_?
 
       def type=: (

data/sig/courier/models/elemental_image_node.rbs

@@ -0,0 +1,71 @@
+module Courier
+  module Models
+    type elemental_image_node =
+      {
+        src: String,
+        align: Courier::Models::alignment?,
+        alt_text: String?,
+        border_color: String?,
+        border_size: String?,
+        href: String?,
+        padding: String?,
+        width: String?
+      }
+
+    class ElementalImageNode < Courier::Models::ElementalBaseNode
+      def src: -> String
+
+      def src=: (String _) -> String
+
+      def align: -> Courier::Models::alignment?
+
+      def align=: (Courier::Models::alignment? _) -> Courier::Models::alignment?
+
+      def alt_text: -> String?
+
+      def alt_text=: (String? _) -> String?
+
+      def border_color: -> String?
+
+      def border_color=: (String? _) -> String?
+
+      def border_size: -> String?
+
+      def border_size=: (String? _) -> String?
+
+      def href: -> String?
+
+      def href=: (String? _) -> String?
+
+      def padding: -> String?
+
+      def padding=: (String? _) -> String?
+
+      def width: -> String?
+
+      def width=: (String? _) -> String?
+
+      def initialize: (
+        src: String,
+        ?align: Courier::Models::alignment?,
+        ?alt_text: String?,
+        ?border_color: String?,
+        ?border_size: String?,
+        ?href: String?,
+        ?padding: String?,
+        ?width: String?
+      ) -> void
+
+      def to_hash: -> {
+        src: String,
+        align: Courier::Models::alignment?,
+        alt_text: String?,
+        border_color: String?,
+        border_size: String?,
+        href: String?,
+        padding: String?,
+        width: String?
+      }
+    end
+  end
+end

data/sig/courier/models/elemental_image_node_with_type.rbs

@@ -3,7 +3,7 @@ module Courier
     type elemental_image_node_with_type =
       { type: Courier::Models::ElementalImageNodeWithType::type_ }
 
-    class ElementalImageNodeWithType < Courier::Models::ElementalBaseNode
+    class ElementalImageNodeWithType < Courier::Models::ElementalImageNode
       def `type`: -> Courier::Models::ElementalImageNodeWithType::type_?
 
       def type=: (