trycourier 6.1.0 → 6.3.0

data/lib/courier/models/send_to_ms_teams_channel_name.rb

@@ -8,25 +8,28 @@ module Courier
       #   @return [String]
       required :channel_name, String
 
-      # @!attribute service_url
-      #
-      #   @return [String]
-      required :service_url, String
-
       # @!attribute team_id
       #
       #   @return [String]
       required :team_id, String
 
+      # @!attribute service_url
+      #
+      #   @return [String, nil]
+      optional :service_url, String
+
       # @!attribute tenant_id
       #
-      #   @return [String]
-      required :tenant_id, String
+      #   @return [String, nil]
+      optional :tenant_id, String
 
-      # @!method initialize(channel_name:, service_url:, team_id:, tenant_id:)
+      # @!method initialize(channel_name:, team_id:, service_url: nil, tenant_id: nil)
+      #   `team_id` is required alongside `channel_name`. Also provide at least one of
+      #   `tenant_id` or `service_url`; if you provide both, they must agree.
+      #
       #   @param channel_name [String]
-      #   @param service_url [String]
       #   @param team_id [String]
+      #   @param service_url [String]
       #   @param tenant_id [String]
     end
   end

data/lib/courier/models/send_to_ms_teams_email.rb

@@ -10,15 +10,18 @@ module Courier
 
       # @!attribute service_url
       #
-      #   @return [String]
-      required :service_url, String
+      #   @return [String, nil]
+      optional :service_url, String
 
       # @!attribute tenant_id
       #
-      #   @return [String]
-      required :tenant_id, String
+      #   @return [String, nil]
+      optional :tenant_id, String
 
-      # @!method initialize(email:, service_url:, tenant_id:)
+      # @!method initialize(email:, service_url: nil, tenant_id: nil)
+      #   Provide at least one of `tenant_id` or `service_url`. If you provide both, they
+      #   must agree.
+      #
       #   @param email [String]
       #   @param service_url [String]
       #   @param tenant_id [String]

data/lib/courier/models/send_to_ms_teams_user_id.rb

@@ -3,25 +3,28 @@
 module Courier
   module Models
     class SendToMsTeamsUserID < Courier::Internal::Type::BaseModel
-      # @!attribute service_url
+      # @!attribute user_id
       #
       #   @return [String]
-      required :service_url, String
+      required :user_id, String
 
-      # @!attribute tenant_id
+      # @!attribute service_url
       #
-      #   @return [String]
-      required :tenant_id, String
+      #   @return [String, nil]
+      optional :service_url, String
 
-      # @!attribute user_id
+      # @!attribute tenant_id
       #
-      #   @return [String]
-      required :user_id, String
+      #   @return [String, nil]
+      optional :tenant_id, String
 
-      # @!method initialize(service_url:, tenant_id:, user_id:)
+      # @!method initialize(user_id:, service_url: nil, tenant_id: nil)
+      #   Provide at least one of `tenant_id` or `service_url`. If you provide both, they
+      #   must agree.
+      #
+      #   @param user_id [String]
       #   @param service_url [String]
       #   @param tenant_id [String]
-      #   @param user_id [String]
     end
   end
 end

data/lib/courier/models/user_profile.rb

@@ -106,6 +106,8 @@ module Courier
       optional :middle_name, String, nil?: true
 
       # @!attribute ms_teams
+      #   Provide at least one of `tenant_id` or `service_url`. If you provide both, they
+      #   must agree.
       #
       #   @return [Courier::Models::SendToMsTeamsUserID, Courier::Models::SendToMsTeamsEmail, Courier::Models::SendToMsTeamsChannelID, Courier::Models::SendToMsTeamsConversationID, Courier::Models::SendToMsTeamsChannelName, nil]
       optional :ms_teams, union: -> { Courier::MsTeams }, nil?: true
@@ -210,7 +212,7 @@ module Courier
       #
       #   @param middle_name [String, nil]
       #
-      #   @param ms_teams [Courier::Models::SendToMsTeamsUserID, Courier::Models::SendToMsTeamsEmail, Courier::Models::SendToMsTeamsChannelID, Courier::Models::SendToMsTeamsConversationID, Courier::Models::SendToMsTeamsChannelName, nil]
+      #   @param ms_teams [Courier::Models::SendToMsTeamsUserID, Courier::Models::SendToMsTeamsEmail, Courier::Models::SendToMsTeamsChannelID, Courier::Models::SendToMsTeamsConversationID, Courier::Models::SendToMsTeamsChannelName, nil] Provide at least one of `tenant_id` or `service_url`. If you provide both, they
       #
       #   @param name [String, nil]
       #

data/lib/courier/models.rb

@@ -320,6 +320,16 @@ module Courier
 
   JourneySendNode = Courier::Models::JourneySendNode
 
+  JourneySendNodeToMsTeams = Courier::Models::JourneySendNodeToMsTeams
+
+  JourneySendNodeToSlack = Courier::Models::JourneySendNodeToSlack
+
+  JourneySendNodeToSlackChannel = Courier::Models::JourneySendNodeToSlackChannel
+
+  JourneySendNodeToSlackEmail = Courier::Models::JourneySendNodeToSlackEmail
+
+  JourneySendNodeToSlackUserID = Courier::Models::JourneySendNodeToSlackUserID
+
   JourneysInvokeRequest = Courier::Models::JourneysInvokeRequest
 
   JourneysInvokeResponse = Courier::Models::JourneysInvokeResponse
@@ -422,12 +432,16 @@ module Courier
 
   NotificationGetContent = Courier::Models::NotificationGetContent
 
+  NotificationGetMetricsParams = Courier::Models::NotificationGetMetricsParams
+
   NotificationListParams = Courier::Models::NotificationListParams
 
   NotificationListVersionsParams = Courier::Models::NotificationListVersionsParams
 
   NotificationLocalePutRequest = Courier::Models::NotificationLocalePutRequest
 
+  NotificationMetricsResponse = Courier::Models::NotificationMetricsResponse
+
   NotificationPreferenceDetails = Courier::Models::NotificationPreferenceDetails
 
   NotificationPublishParams = Courier::Models::NotificationPublishParams

data/lib/courier/resources/notifications.rb

@@ -123,6 +123,59 @@ module Courier
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Courier::Models::NotificationGetMetricsParams} for more details.
+      #
+      # Fetch the delivery funnel for one Notification Template as a time series — sent,
+      # delivered, opened, clicked, errors, and undeliverable — broken out per provider
+      # and channel inside each bucket. Sum the entries in a bucket for its totals;
+      # there is no bucket-level total.
+      #
+      # Choose the window absolutely with `start` and `end`, or relatively with
+      # `lookback` (an ISO 8601 duration). `start` and `end` take precedence when both
+      # are supplied, and a request carrying neither defaults to `lookback=P30D`. The
+      # window is snapped outwards onto the `granularity` grid so every bucket it
+      # overlaps is returned whole, and the snapped boundaries come back as `start` and
+      # `end` — align a chart on those rather than on what was requested. Every boundary
+      # is UTC; there is no timezone support.
+      #
+      # Every bucket in the window is returned, including the quiet ones, whose `data`
+      # array is empty, so a series is directly plottable with no gap filling
+      # client-side. An unknown template id returns `200` with an all-empty series
+      # rather than `404`, and messages sent without a Notification Template never
+      # appear here.
+      #
+      # Available in the US region only.
+      #
+      # @overload get_metrics(id, end_: nil, granularity: nil, lookback: nil, start: nil, request_options: {})
+      #
+      # @param id [String] The Notification Template to report on — its ID (`nt_` prefix) or an alias. Must
+      #
+      # @param end_ [Time] The end of the window, as an ISO 8601 timestamp with an offset. Must be supplied
+      #
+      # @param granularity [Symbol, Courier::Models::NotificationGetMetricsParams::Granularity] The size of each bucket in the series. Defaults to `DAY`. `WEEK` buckets start o
+      #
+      # @param lookback [String] The length of the window, counted back from now, as an ISO 8601 duration (`P30D`
+      #
+      # @param start [Time] The inclusive start of the window, as an ISO 8601 timestamp with an offset (`202
+      #
+      # @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Courier::Models::NotificationMetricsResponse]
+      #
+      # @see Courier::Models::NotificationGetMetricsParams
+      def get_metrics(id, params = {})
+        parsed, options = Courier::NotificationGetMetricsParams.dump_request(params)
+        query = Courier::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["notifications/%1$s/metrics", id],
+          query: query.transform_keys(end_: "end"),
+          model: Courier::NotificationMetricsResponse,
+          options: options
+        )
+      end
+
       # Returns a notification template's published versions, most recent first, for
       # comparison or rollback. Paged.
       #

data/lib/courier/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Courier
-  VERSION = "6.1.0"
+  VERSION = "6.3.0"
 end

data/lib/courier.rb

@@ -244,6 +244,11 @@ require_relative "courier/models/journeys/template_retrieve_content_params"
 require_relative "courier/models/journeys/template_retrieve_params"
 require_relative "courier/models/journey_segment_trigger_node"
 require_relative "courier/models/journey_send_node"
+require_relative "courier/models/journey_send_node_to_ms_teams"
+require_relative "courier/models/journey_send_node_to_slack"
+require_relative "courier/models/journey_send_node_to_slack_channel"
+require_relative "courier/models/journey_send_node_to_slack_email"
+require_relative "courier/models/journey_send_node_to_slack_user_id"
 require_relative "courier/models/journeys_invoke_response"
 require_relative "courier/models/journeys_list_response"
 require_relative "courier/models/journey_state"
@@ -298,9 +303,11 @@ 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_get_metrics_params"
 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_metrics_response"
 require_relative "courier/models/notification_preference_details"
 require_relative "courier/models/notification_publish_params"
 require_relative "courier/models/notification_put_content_params"

data/rbi/courier/models/journey_send_node.rbi

@@ -151,6 +151,9 @@ module Courier
         sig { params(template: String).void }
         attr_writer :template
 
+        # Recipient override for this send. Provide exactly one of `email_override`,
+        # `phone_number_override`, `user_id_override`, `slack`, or `ms_teams` — not a
+        # combination.
         sig { returns(T.nilable(Courier::JourneySendNode::Message::To)) }
         attr_reader :to
 
@@ -173,6 +176,9 @@ module Courier
           data: nil,
           delay: nil,
           template: nil,
+          # Recipient override for this send. Provide exactly one of `email_override`,
+          # `phone_number_override`, `user_id_override`, `slack`, or `ms_teams` — not a
+          # combination.
           to: nil
         )
         end
@@ -282,28 +288,93 @@ module Courier
           sig { params(email_override: String).void }
           attr_writer :email_override
 
+          # Send to a Microsoft Teams address directly, bypassing the recipient's stored
+          # profile. Requires exactly one target: `channel_id`, `channel_name` (with
+          # `team_id`), `user_id`, or `email`. `channel_name`, `user_id`, and `email` also
+          # need at least one of `service_url` or `tenant_id` — if you provide both, they
+          # must agree. `channel_id` doesn't require tenant context to publish, but provide
+          # `service_url` or `tenant_id` anyway: sends without either have failed at
+          # delivery in testing. `conversation_id` and `reply_to_activity_id`, available on
+          # the send API's `MsTeams` profile, aren't supported here yet.
+          sig { returns(T.nilable(Courier::JourneySendNodeToMsTeams)) }
+          attr_reader :ms_teams
+
+          sig do
+            params(ms_teams: Courier::JourneySendNodeToMsTeams::OrHash).void
+          end
+          attr_writer :ms_teams
+
           sig { returns(T.nilable(String)) }
           attr_reader :phone_number_override
 
           sig { params(phone_number_override: String).void }
           attr_writer :phone_number_override
 
+          # Send to a Slack address directly, bypassing the recipient's stored profile.
+          # Requires exactly one of `channel`, `user_id`, or `email`.
+          sig do
+            returns(
+              T.nilable(
+                T.any(
+                  Courier::JourneySendNodeToSlackChannel,
+                  Courier::JourneySendNodeToSlackUserID,
+                  Courier::JourneySendNodeToSlackEmail
+                )
+              )
+            )
+          end
+          attr_reader :slack
+
+          sig do
+            params(
+              slack:
+                T.any(
+                  Courier::JourneySendNodeToSlackChannel::OrHash,
+                  Courier::JourneySendNodeToSlackUserID::OrHash,
+                  Courier::JourneySendNodeToSlackEmail::OrHash
+                )
+            ).void
+          end
+          attr_writer :slack
+
           sig { returns(T.nilable(String)) }
           attr_reader :user_id_override
 
           sig { params(user_id_override: String).void }
           attr_writer :user_id_override
 
+          # Recipient override for this send. Provide exactly one of `email_override`,
+          # `phone_number_override`, `user_id_override`, `slack`, or `ms_teams` — not a
+          # combination.
           sig do
             params(
               email_override: String,
+              ms_teams: Courier::JourneySendNodeToMsTeams::OrHash,
               phone_number_override: String,
+              slack:
+                T.any(
+                  Courier::JourneySendNodeToSlackChannel::OrHash,
+                  Courier::JourneySendNodeToSlackUserID::OrHash,
+                  Courier::JourneySendNodeToSlackEmail::OrHash
+                ),
               user_id_override: String
             ).returns(T.attached_class)
           end
           def self.new(
             email_override: nil,
+            # Send to a Microsoft Teams address directly, bypassing the recipient's stored
+            # profile. Requires exactly one target: `channel_id`, `channel_name` (with
+            # `team_id`), `user_id`, or `email`. `channel_name`, `user_id`, and `email` also
+            # need at least one of `service_url` or `tenant_id` — if you provide both, they
+            # must agree. `channel_id` doesn't require tenant context to publish, but provide
+            # `service_url` or `tenant_id` anyway: sends without either have failed at
+            # delivery in testing. `conversation_id` and `reply_to_activity_id`, available on
+            # the send API's `MsTeams` profile, aren't supported here yet.
+            ms_teams: nil,
             phone_number_override: nil,
+            # Send to a Slack address directly, bypassing the recipient's stored profile.
+            # Requires exactly one of `channel`, `user_id`, or `email`.
+            slack: nil,
             user_id_override: nil
           )
           end
@@ -312,7 +383,14 @@ module Courier
             override.returns(
               {
                 email_override: String,
+                ms_teams: Courier::JourneySendNodeToMsTeams,
                 phone_number_override: String,
+                slack:
+                  T.any(
+                    Courier::JourneySendNodeToSlackChannel,
+                    Courier::JourneySendNodeToSlackUserID,
+                    Courier::JourneySendNodeToSlackEmail
+                  ),
                 user_id_override: String
               }
             )

data/rbi/courier/models/journey_send_node_to_ms_teams.rbi

@@ -0,0 +1,124 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneySendNodeToMsTeams < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Courier::JourneySendNodeToMsTeams, Courier::Internal::AnyHash)
+        end
+
+      # Bot Framework channel ID to send to.
+      sig { returns(T.nilable(String)) }
+      attr_reader :channel_id
+
+      sig { params(channel_id: String).void }
+      attr_writer :channel_id
+
+      # Teams channel name to send to. Requires `team_id`.
+      sig { returns(T.nilable(String)) }
+      attr_reader :channel_name
+
+      sig { params(channel_name: String).void }
+      attr_writer :channel_name
+
+      # Email address of the Teams user to send to.
+      sig { returns(T.nilable(String)) }
+      attr_reader :email
+
+      sig { params(email: String).void }
+      attr_writer :email
+
+      # The regional Bot Framework host for this conversation, e.g.
+      # `https://smba.trafficmanager.net/amer`. A path segment naming the Microsoft
+      # tenant may follow it and is used to derive `tenant_id` when it is not supplied
+      # directly.
+      sig { returns(T.nilable(String)) }
+      attr_reader :service_url
+
+      sig { params(service_url: String).void }
+      attr_writer :service_url
+
+      # Microsoft Teams team ID. Required alongside `channel_name`.
+      sig { returns(T.nilable(String)) }
+      attr_reader :team_id
+
+      sig { params(team_id: String).void }
+      attr_writer :team_id
+
+      # The Microsoft (Azure AD) tenant this send targets or authenticates against.
+      # Unrelated to `message.context.tenant_id`, which is the Courier customer's own
+      # multi-tenant context.
+      sig { returns(T.nilable(String)) }
+      attr_reader :tenant_id
+
+      sig { params(tenant_id: String).void }
+      attr_writer :tenant_id
+
+      # Microsoft Teams user ID to send to.
+      sig { returns(T.nilable(String)) }
+      attr_reader :user_id
+
+      sig { params(user_id: String).void }
+      attr_writer :user_id
+
+      # Send to a Microsoft Teams address directly, bypassing the recipient's stored
+      # profile. Requires exactly one target: `channel_id`, `channel_name` (with
+      # `team_id`), `user_id`, or `email`. `channel_name`, `user_id`, and `email` also
+      # need at least one of `service_url` or `tenant_id` — if you provide both, they
+      # must agree. `channel_id` doesn't require tenant context to publish, but provide
+      # `service_url` or `tenant_id` anyway: sends without either have failed at
+      # delivery in testing. `conversation_id` and `reply_to_activity_id`, available on
+      # the send API's `MsTeams` profile, aren't supported here yet.
+      sig do
+        params(
+          channel_id: String,
+          channel_name: String,
+          email: String,
+          service_url: String,
+          team_id: String,
+          tenant_id: String,
+          user_id: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Bot Framework channel ID to send to.
+        channel_id: nil,
+        # Teams channel name to send to. Requires `team_id`.
+        channel_name: nil,
+        # Email address of the Teams user to send to.
+        email: nil,
+        # The regional Bot Framework host for this conversation, e.g.
+        # `https://smba.trafficmanager.net/amer`. A path segment naming the Microsoft
+        # tenant may follow it and is used to derive `tenant_id` when it is not supplied
+        # directly.
+        service_url: nil,
+        # Microsoft Teams team ID. Required alongside `channel_name`.
+        team_id: nil,
+        # The Microsoft (Azure AD) tenant this send targets or authenticates against.
+        # Unrelated to `message.context.tenant_id`, which is the Courier customer's own
+        # multi-tenant context.
+        tenant_id: nil,
+        # Microsoft Teams user ID to send to.
+        user_id: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            channel_id: String,
+            channel_name: String,
+            email: String,
+            service_url: String,
+            team_id: String,
+            tenant_id: String,
+            user_id: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_send_node_to_slack.rbi

@@ -0,0 +1,26 @@
+# typed: strong
+
+module Courier
+  module Models
+    # Send to a Slack address directly, bypassing the recipient's stored profile.
+    # Requires exactly one of `channel`, `user_id`, or `email`.
+    module JourneySendNodeToSlack
+      extend Courier::Internal::Type::Union
+
+      Variants =
+        T.type_alias do
+          T.any(
+            Courier::JourneySendNodeToSlackChannel,
+            Courier::JourneySendNodeToSlackUserID,
+            Courier::JourneySendNodeToSlackEmail
+          )
+        end
+
+      sig do
+        override.returns(T::Array[Courier::JourneySendNodeToSlack::Variants])
+      end
+      def self.variants
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_send_node_to_slack_channel.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneySendNodeToSlackChannel < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::JourneySendNodeToSlackChannel,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      # Slack channel to send to, by name or ID.
+      sig { returns(String) }
+      attr_accessor :channel
+
+      # A runtime reference to a Slack access token, such as `{{data.slack_token}}`.
+      # Literal values are rejected — they'd be stored permanently with no way to rotate
+      # them. Omit to use the token on the recipient's stored Slack profile.
+      sig { returns(T.nilable(String)) }
+      attr_reader :access_token
+
+      sig { params(access_token: String).void }
+      attr_writer :access_token
+
+      sig do
+        params(channel: String, access_token: String).returns(T.attached_class)
+      end
+      def self.new(
+        # Slack channel to send to, by name or ID.
+        channel:,
+        # A runtime reference to a Slack access token, such as `{{data.slack_token}}`.
+        # Literal values are rejected — they'd be stored permanently with no way to rotate
+        # them. Omit to use the token on the recipient's stored Slack profile.
+        access_token: nil
+      )
+      end
+
+      sig { override.returns({ channel: String, access_token: String }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_send_node_to_slack_email.rbi

@@ -0,0 +1,47 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneySendNodeToSlackEmail < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::JourneySendNodeToSlackEmail,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      # Email address of the Slack user to send to, resolved via the workspace
+      # directory.
+      sig { returns(String) }
+      attr_accessor :email
+
+      # A runtime reference to a Slack access token, such as `{{data.slack_token}}`.
+      # Literal values are rejected — they'd be stored permanently with no way to rotate
+      # them. Omit to use the token on the recipient's stored Slack profile.
+      sig { returns(T.nilable(String)) }
+      attr_reader :access_token
+
+      sig { params(access_token: String).void }
+      attr_writer :access_token
+
+      sig do
+        params(email: String, access_token: String).returns(T.attached_class)
+      end
+      def self.new(
+        # Email address of the Slack user to send to, resolved via the workspace
+        # directory.
+        email:,
+        # A runtime reference to a Slack access token, such as `{{data.slack_token}}`.
+        # Literal values are rejected — they'd be stored permanently with no way to rotate
+        # them. Omit to use the token on the recipient's stored Slack profile.
+        access_token: nil
+      )
+      end
+
+      sig { override.returns({ email: String, access_token: String }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/journey_send_node_to_slack_user_id.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module Courier
+  module Models
+    class JourneySendNodeToSlackUserID < Courier::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Courier::JourneySendNodeToSlackUserID,
+            Courier::Internal::AnyHash
+          )
+        end
+
+      # Slack user ID to send to.
+      sig { returns(String) }
+      attr_accessor :user_id
+
+      # A runtime reference to a Slack access token, such as `{{data.slack_token}}`.
+      # Literal values are rejected — they'd be stored permanently with no way to rotate
+      # them. Omit to use the token on the recipient's stored Slack profile.
+      sig { returns(T.nilable(String)) }
+      attr_reader :access_token
+
+      sig { params(access_token: String).void }
+      attr_writer :access_token
+
+      sig do
+        params(user_id: String, access_token: String).returns(T.attached_class)
+      end
+      def self.new(
+        # Slack user ID to send to.
+        user_id:,
+        # A runtime reference to a Slack access token, such as `{{data.slack_token}}`.
+        # Literal values are rejected — they'd be stored permanently with no way to rotate
+        # them. Omit to use the token on the recipient's stored Slack profile.
+        access_token: nil
+      )
+      end
+
+      sig { override.returns({ user_id: String, access_token: String }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/courier/models/ms_teams.rbi

@@ -2,6 +2,8 @@
 
 module Courier
   module Models
+    # Provide at least one of `tenant_id` or `service_url`. If you provide both, they
+    # must agree.
     module MsTeams
       extend Courier::Internal::Type::Union