vapi_server_sdk 0.0.0.pre.alpha7

data/lib/vapi_server_sdk/types/block_start_message.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require_relative "block_start_message_conditions_item"
+require "ostruct"
+require "json"
+
+module Vapi
+  class BlockStartMessage
+    # @return [Array<Vapi::BlockStartMessageConditionsItem>] This is an optional array of conditions that must be met for this message to be
+    #  triggered.
+    attr_reader :conditions
+    # @return [String] This is the content that the assistant will say when this message is triggered.
+    attr_reader :content
+    # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+    # @return [Object]
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param conditions [Array<Vapi::BlockStartMessageConditionsItem>] This is an optional array of conditions that must be met for this message to be
+    #  triggered.
+    # @param content [String] This is the content that the assistant will say when this message is triggered.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vapi::BlockStartMessage]
+    def initialize(content:, conditions: OMIT, additional_properties: nil)
+      @conditions = conditions if conditions != OMIT
+      @content = content
+      @additional_properties = additional_properties
+      @_field_set = { "conditions": conditions, "content": content }.reject do |_k, v|
+        v == OMIT
+      end
+    end
+
+    # Deserialize a JSON object to an instance of BlockStartMessage
+    #
+    # @param json_object [String]
+    # @return [Vapi::BlockStartMessage]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      conditions = parsed_json["conditions"]&.map do |item|
+        item = item.to_json
+        Vapi::BlockStartMessageConditionsItem.from_json(json_object: item)
+      end
+      content = parsed_json["content"]
+      new(
+        conditions: conditions,
+        content: content,
+        additional_properties: struct
+      )
+    end
+
+    # Serialize an instance of BlockStartMessage to a JSON object
+    #
+    # @return [String]
+    def to_json(*_args)
+      @_field_set&.to_json
+    end
+
+    # Leveraged for Union-type generation, validate_raw attempts to parse the given
+    #  hash and check each fields type against the current object's property
+    #  definitions.
+    #
+    # @param obj [Object]
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.conditions&.is_a?(Array) != false || raise("Passed value for field obj.conditions is not the expected type, validation failed.")
+      obj.content.is_a?(String) != false || raise("Passed value for field obj.content is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vapi_server_sdk/types/block_start_message_conditions_item.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "model_based_condition"
+require_relative "rule_based_condition"
+
+module Vapi
+  class BlockStartMessageConditionsItem
+    # @return [Object]
+    attr_reader :member
+    # @return [String]
+    attr_reader :discriminant
+
+    private_class_method :new
+    alias kind_of? is_a?
+
+    # @param member [Object]
+    # @param discriminant [String]
+    # @return [Vapi::BlockStartMessageConditionsItem]
+    def initialize(member:, discriminant:)
+      @member = member
+      @discriminant = discriminant
+    end
+
+    # Deserialize a JSON object to an instance of BlockStartMessageConditionsItem
+    #
+    # @param json_object [String]
+    # @return [Vapi::BlockStartMessageConditionsItem]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      member = case struct.type
+               when "model-based"
+                 Vapi::ModelBasedCondition.from_json(json_object: json_object)
+               when "rule-based"
+                 Vapi::RuleBasedCondition.from_json(json_object: json_object)
+               else
+                 Vapi::ModelBasedCondition.from_json(json_object: json_object)
+               end
+      new(member: member, discriminant: struct.type)
+    end
+
+    # For Union Types, to_json functionality is delegated to the wrapped member.
+    #
+    # @return [String]
+    def to_json(*_args)
+      case @discriminant
+      when "model-based"
+        { **@member.to_json, type: @discriminant }.to_json
+      when "rule-based"
+        { **@member.to_json, type: @discriminant }.to_json
+      else
+        { "type": @discriminant, value: @member }.to_json
+      end
+      @member.to_json
+    end
+
+    # Leveraged for Union-type generation, validate_raw attempts to parse the given
+    #  hash and check each fields type against the current object's property
+    #  definitions.
+    #
+    # @param obj [Object]
+    # @return [Void]
+    def self.validate_raw(obj:)
+      case obj.type
+      when "model-based"
+        Vapi::ModelBasedCondition.validate_raw(obj: obj)
+      when "rule-based"
+        Vapi::RuleBasedCondition.validate_raw(obj: obj)
+      else
+        raise("Passed value matched no type within the union, validation failed.")
+      end
+    end
+
+    # For Union Types, is_a? functionality is delegated to the wrapped member.
+    #
+    # @param obj [Object]
+    # @return [Boolean]
+    def is_a?(obj)
+      @member.is_a?(obj)
+    end
+
+    # @param member [Vapi::ModelBasedCondition]
+    # @return [Vapi::BlockStartMessageConditionsItem]
+    def self.model_based(member:)
+      new(member: member, discriminant: "model-based")
+    end
+
+    # @param member [Vapi::RuleBasedCondition]
+    # @return [Vapi::BlockStartMessageConditionsItem]
+    def self.rule_based(member:)
+      new(member: member, discriminant: "rule-based")
+    end
+  end
+end

data/lib/vapi_server_sdk/types/bot_message.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module Vapi
+  class BotMessage
+    # @return [String] The role of the bot in the conversation.
+    attr_reader :role
+    # @return [String] The message content from the bot.
+    attr_reader :message
+    # @return [Float] The timestamp when the message was sent.
+    attr_reader :time
+    # @return [Float] The timestamp when the message ended.
+    attr_reader :end_time
+    # @return [Float] The number of seconds from the start of the conversation.
+    attr_reader :seconds_from_start
+    # @return [String] The source of the message.
+    attr_reader :source
+    # @return [Float] The duration of the message in seconds.
+    attr_reader :duration
+    # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+    # @return [Object]
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param role [String] The role of the bot in the conversation.
+    # @param message [String] The message content from the bot.
+    # @param time [Float] The timestamp when the message was sent.
+    # @param end_time [Float] The timestamp when the message ended.
+    # @param seconds_from_start [Float] The number of seconds from the start of the conversation.
+    # @param source [String] The source of the message.
+    # @param duration [Float] The duration of the message in seconds.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vapi::BotMessage]
+    def initialize(role:, message:, time:, end_time:, seconds_from_start:, source: OMIT, duration: OMIT,
+                   additional_properties: nil)
+      @role = role
+      @message = message
+      @time = time
+      @end_time = end_time
+      @seconds_from_start = seconds_from_start
+      @source = source if source != OMIT
+      @duration = duration if duration != OMIT
+      @additional_properties = additional_properties
+      @_field_set = {
+        "role": role,
+        "message": message,
+        "time": time,
+        "endTime": end_time,
+        "secondsFromStart": seconds_from_start,
+        "source": source,
+        "duration": duration
+      }.reject do |_k, v|
+        v == OMIT
+      end
+    end
+
+    # Deserialize a JSON object to an instance of BotMessage
+    #
+    # @param json_object [String]
+    # @return [Vapi::BotMessage]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      role = parsed_json["role"]
+      message = parsed_json["message"]
+      time = parsed_json["time"]
+      end_time = parsed_json["endTime"]
+      seconds_from_start = parsed_json["secondsFromStart"]
+      source = parsed_json["source"]
+      duration = parsed_json["duration"]
+      new(
+        role: role,
+        message: message,
+        time: time,
+        end_time: end_time,
+        seconds_from_start: seconds_from_start,
+        source: source,
+        duration: duration,
+        additional_properties: struct
+      )
+    end
+
+    # Serialize an instance of BotMessage to a JSON object
+    #
+    # @return [String]
+    def to_json(*_args)
+      @_field_set&.to_json
+    end
+
+    # Leveraged for Union-type generation, validate_raw attempts to parse the given
+    #  hash and check each fields type against the current object's property
+    #  definitions.
+    #
+    # @param obj [Object]
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.role.is_a?(String) != false || raise("Passed value for field obj.role is not the expected type, validation failed.")
+      obj.message.is_a?(String) != false || raise("Passed value for field obj.message is not the expected type, validation failed.")
+      obj.time.is_a?(Float) != false || raise("Passed value for field obj.time is not the expected type, validation failed.")
+      obj.end_time.is_a?(Float) != false || raise("Passed value for field obj.end_time is not the expected type, validation failed.")
+      obj.seconds_from_start.is_a?(Float) != false || raise("Passed value for field obj.seconds_from_start is not the expected type, validation failed.")
+      obj.source&.is_a?(String) != false || raise("Passed value for field obj.source is not the expected type, validation failed.")
+      obj.duration&.is_a?(Float) != false || raise("Passed value for field obj.duration is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vapi_server_sdk/types/bucket_plan.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module Vapi
+  class BucketPlan
+    # @return [String] This is the name of the bucket.
+    attr_reader :name
+    # @return [String] This is the region of the bucket.
+    #  Usage:
+    #  - If `credential.type` is `aws`, then this is required.
+    #  - If `credential.type` is `gcp`, then this is optional since GCP allows buckets
+    #  to be accessed without a region but region is required for data residency
+    #  requirements. Read here: https://cloud.google.com/storage/docs/request-endpoints
+    attr_reader :region
+    # @return [String] This is the path where call artifacts will be stored.
+    #  Usage:
+    #  - To store call artifacts in a specific folder, set this to the full path. Eg.
+    #  "/folder-name1/folder-name2".
+    #  - To store call artifacts in the root of the bucket, leave this blank.
+    #  @default "/"
+    attr_reader :path
+    # @return [String] This is the HMAC access key offered by GCP for interoperability with S3 clients.
+    #  Here is the guide on how to create:
+    #  https://cloud.google.com/storage/docs/authentication/managing-hmackeys#console
+    #  Usage:
+    #  - If `credential.type` is `gcp`, then this is required.
+    #  - If `credential.type` is `aws`, then this is not required since
+    #  credential.awsAccessKeyId is used instead.
+    attr_reader :hmac_access_key
+    # @return [String] This is the secret for the HMAC access key. Here is the guide on how to create:
+    #  https://cloud.google.com/storage/docs/authentication/managing-hmackeys#console
+    #  Usage:
+    #  - If `credential.type` is `gcp`, then this is required.
+    #  - If `credential.type` is `aws`, then this is not required since
+    #  credential.awsSecretAccessKey is used instead.
+    #  Note: This is not returned in the API.
+    attr_reader :hmac_secret
+    # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+    # @return [Object]
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param name [String] This is the name of the bucket.
+    # @param region [String] This is the region of the bucket.
+    #  Usage:
+    #  - If `credential.type` is `aws`, then this is required.
+    #  - If `credential.type` is `gcp`, then this is optional since GCP allows buckets
+    #  to be accessed without a region but region is required for data residency
+    #  requirements. Read here: https://cloud.google.com/storage/docs/request-endpoints
+    # @param path [String] This is the path where call artifacts will be stored.
+    #  Usage:
+    #  - To store call artifacts in a specific folder, set this to the full path. Eg.
+    #  "/folder-name1/folder-name2".
+    #  - To store call artifacts in the root of the bucket, leave this blank.
+    #  @default "/"
+    # @param hmac_access_key [String] This is the HMAC access key offered by GCP for interoperability with S3 clients.
+    #  Here is the guide on how to create:
+    #  https://cloud.google.com/storage/docs/authentication/managing-hmackeys#console
+    #  Usage:
+    #  - If `credential.type` is `gcp`, then this is required.
+    #  - If `credential.type` is `aws`, then this is not required since
+    #  credential.awsAccessKeyId is used instead.
+    # @param hmac_secret [String] This is the secret for the HMAC access key. Here is the guide on how to create:
+    #  https://cloud.google.com/storage/docs/authentication/managing-hmackeys#console
+    #  Usage:
+    #  - If `credential.type` is `gcp`, then this is required.
+    #  - If `credential.type` is `aws`, then this is not required since
+    #  credential.awsSecretAccessKey is used instead.
+    #  Note: This is not returned in the API.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vapi::BucketPlan]
+    def initialize(name:, region: OMIT, path: OMIT, hmac_access_key: OMIT, hmac_secret: OMIT,
+                   additional_properties: nil)
+      @name = name
+      @region = region if region != OMIT
+      @path = path if path != OMIT
+      @hmac_access_key = hmac_access_key if hmac_access_key != OMIT
+      @hmac_secret = hmac_secret if hmac_secret != OMIT
+      @additional_properties = additional_properties
+      @_field_set = {
+        "name": name,
+        "region": region,
+        "path": path,
+        "hmacAccessKey": hmac_access_key,
+        "hmacSecret": hmac_secret
+      }.reject do |_k, v|
+        v == OMIT
+      end
+    end
+
+    # Deserialize a JSON object to an instance of BucketPlan
+    #
+    # @param json_object [String]
+    # @return [Vapi::BucketPlan]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      name = parsed_json["name"]
+      region = parsed_json["region"]
+      path = parsed_json["path"]
+      hmac_access_key = parsed_json["hmacAccessKey"]
+      hmac_secret = parsed_json["hmacSecret"]
+      new(
+        name: name,
+        region: region,
+        path: path,
+        hmac_access_key: hmac_access_key,
+        hmac_secret: hmac_secret,
+        additional_properties: struct
+      )
+    end
+
+    # Serialize an instance of BucketPlan to a JSON object
+    #
+    # @return [String]
+    def to_json(*_args)
+      @_field_set&.to_json
+    end
+
+    # Leveraged for Union-type generation, validate_raw attempts to parse the given
+    #  hash and check each fields type against the current object's property
+    #  definitions.
+    #
+    # @param obj [Object]
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.region&.is_a?(String) != false || raise("Passed value for field obj.region is not the expected type, validation failed.")
+      obj.path&.is_a?(String) != false || raise("Passed value for field obj.path is not the expected type, validation failed.")
+      obj.hmac_access_key&.is_a?(String) != false || raise("Passed value for field obj.hmac_access_key is not the expected type, validation failed.")
+      obj.hmac_secret&.is_a?(String) != false || raise("Passed value for field obj.hmac_secret is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vapi_server_sdk/types/buy_phone_number_dto.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require_relative "buy_phone_number_dto_fallback_destination"
+require "ostruct"
+require "json"
+
+module Vapi
+  class BuyPhoneNumberDto
+    # @return [Vapi::BuyPhoneNumberDtoFallbackDestination] This is the fallback destination an inbound call will be transferred to if:
+    #  1. `assistantId` is not set
+    #  2. `squadId` is not set
+    #  3. and, `assistant-request` message to the `serverUrl` fails
+    #  If this is not set and above conditions are met, the inbound call is hung up
+    #  with an error message.
+    attr_reader :fallback_destination
+    # @return [String] This is the area code of the phone number to purchase.
+    attr_reader :area_code
+    # @return [String] This is the name of the phone number. This is just for your own reference.
+    attr_reader :name
+    # @return [String] This is the assistant that will be used for incoming calls to this phone number.
+    #  If neither `assistantId` nor `squadId` is set, `assistant-request` will be sent
+    #  to your Server URL. Check `ServerMessage` and `ServerMessageResponse` for the
+    #  shape of the message and response that is expected.
+    attr_reader :assistant_id
+    # @return [String] This is the squad that will be used for incoming calls to this phone number.
+    #  If neither `assistantId` nor `squadId` is set, `assistant-request` will be sent
+    #  to your Server URL. Check `ServerMessage` and `ServerMessageResponse` for the
+    #  shape of the message and response that is expected.
+    attr_reader :squad_id
+    # @return [String] This is the server URL where messages will be sent for calls on this number.
+    #  This includes the `assistant-request` message.
+    #  You can see the shape of the messages sent in `ServerMessage`.
+    #  This overrides the `org.serverUrl`. Order of precedence: tool.server.url >
+    #  assistant.serverUrl > phoneNumber.serverUrl > org.serverUrl.
+    attr_reader :server_url
+    # @return [String] This is the secret Vapi will send with every message to your server. It's sent
+    #  as a header called x-vapi-secret.
+    #  Same precedence logic as serverUrl.
+    attr_reader :server_url_secret
+    # @return [OpenStruct] Additional properties unmapped to the current class definition
+    attr_reader :additional_properties
+    # @return [Object]
+    attr_reader :_field_set
+    protected :_field_set
+
+    OMIT = Object.new
+
+    # @param fallback_destination [Vapi::BuyPhoneNumberDtoFallbackDestination] This is the fallback destination an inbound call will be transferred to if:
+    #  1. `assistantId` is not set
+    #  2. `squadId` is not set
+    #  3. and, `assistant-request` message to the `serverUrl` fails
+    #  If this is not set and above conditions are met, the inbound call is hung up
+    #  with an error message.
+    # @param area_code [String] This is the area code of the phone number to purchase.
+    # @param name [String] This is the name of the phone number. This is just for your own reference.
+    # @param assistant_id [String] This is the assistant that will be used for incoming calls to this phone number.
+    #  If neither `assistantId` nor `squadId` is set, `assistant-request` will be sent
+    #  to your Server URL. Check `ServerMessage` and `ServerMessageResponse` for the
+    #  shape of the message and response that is expected.
+    # @param squad_id [String] This is the squad that will be used for incoming calls to this phone number.
+    #  If neither `assistantId` nor `squadId` is set, `assistant-request` will be sent
+    #  to your Server URL. Check `ServerMessage` and `ServerMessageResponse` for the
+    #  shape of the message and response that is expected.
+    # @param server_url [String] This is the server URL where messages will be sent for calls on this number.
+    #  This includes the `assistant-request` message.
+    #  You can see the shape of the messages sent in `ServerMessage`.
+    #  This overrides the `org.serverUrl`. Order of precedence: tool.server.url >
+    #  assistant.serverUrl > phoneNumber.serverUrl > org.serverUrl.
+    # @param server_url_secret [String] This is the secret Vapi will send with every message to your server. It's sent
+    #  as a header called x-vapi-secret.
+    #  Same precedence logic as serverUrl.
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vapi::BuyPhoneNumberDto]
+    def initialize(area_code:, fallback_destination: OMIT, name: OMIT, assistant_id: OMIT, squad_id: OMIT,
+                   server_url: OMIT, server_url_secret: OMIT, additional_properties: nil)
+      @fallback_destination = fallback_destination if fallback_destination != OMIT
+      @area_code = area_code
+      @name = name if name != OMIT
+      @assistant_id = assistant_id if assistant_id != OMIT
+      @squad_id = squad_id if squad_id != OMIT
+      @server_url = server_url if server_url != OMIT
+      @server_url_secret = server_url_secret if server_url_secret != OMIT
+      @additional_properties = additional_properties
+      @_field_set = {
+        "fallbackDestination": fallback_destination,
+        "areaCode": area_code,
+        "name": name,
+        "assistantId": assistant_id,
+        "squadId": squad_id,
+        "serverUrl": server_url,
+        "serverUrlSecret": server_url_secret
+      }.reject do |_k, v|
+        v == OMIT
+      end
+    end
+
+    # Deserialize a JSON object to an instance of BuyPhoneNumberDto
+    #
+    # @param json_object [String]
+    # @return [Vapi::BuyPhoneNumberDto]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      if parsed_json["fallbackDestination"].nil?
+        fallback_destination = nil
+      else
+        fallback_destination = parsed_json["fallbackDestination"].to_json
+        fallback_destination = Vapi::BuyPhoneNumberDtoFallbackDestination.from_json(json_object: fallback_destination)
+      end
+      area_code = parsed_json["areaCode"]
+      name = parsed_json["name"]
+      assistant_id = parsed_json["assistantId"]
+      squad_id = parsed_json["squadId"]
+      server_url = parsed_json["serverUrl"]
+      server_url_secret = parsed_json["serverUrlSecret"]
+      new(
+        fallback_destination: fallback_destination,
+        area_code: area_code,
+        name: name,
+        assistant_id: assistant_id,
+        squad_id: squad_id,
+        server_url: server_url,
+        server_url_secret: server_url_secret,
+        additional_properties: struct
+      )
+    end
+
+    # Serialize an instance of BuyPhoneNumberDto to a JSON object
+    #
+    # @return [String]
+    def to_json(*_args)
+      @_field_set&.to_json
+    end
+
+    # Leveraged for Union-type generation, validate_raw attempts to parse the given
+    #  hash and check each fields type against the current object's property
+    #  definitions.
+    #
+    # @param obj [Object]
+    # @return [Void]
+    def self.validate_raw(obj:)
+      obj.fallback_destination.nil? || Vapi::BuyPhoneNumberDtoFallbackDestination.validate_raw(obj: obj.fallback_destination)
+      obj.area_code.is_a?(String) != false || raise("Passed value for field obj.area_code is not the expected type, validation failed.")
+      obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+      obj.assistant_id&.is_a?(String) != false || raise("Passed value for field obj.assistant_id is not the expected type, validation failed.")
+      obj.squad_id&.is_a?(String) != false || raise("Passed value for field obj.squad_id is not the expected type, validation failed.")
+      obj.server_url&.is_a?(String) != false || raise("Passed value for field obj.server_url is not the expected type, validation failed.")
+      obj.server_url_secret&.is_a?(String) != false || raise("Passed value for field obj.server_url_secret is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vapi_server_sdk/types/buy_phone_number_dto_fallback_destination.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "transfer_destination_number"
+require_relative "transfer_destination_sip"
+
+module Vapi
+  # This is the fallback destination an inbound call will be transferred to if:
+  #  1. `assistantId` is not set
+  #  2. `squadId` is not set
+  #  3. and, `assistant-request` message to the `serverUrl` fails
+  #  If this is not set and above conditions are met, the inbound call is hung up
+  #  with an error message.
+  class BuyPhoneNumberDtoFallbackDestination
+    # @return [Object]
+    attr_reader :member
+    # @return [String]
+    attr_reader :discriminant
+
+    private_class_method :new
+    alias kind_of? is_a?
+
+    # @param member [Object]
+    # @param discriminant [String]
+    # @return [Vapi::BuyPhoneNumberDtoFallbackDestination]
+    def initialize(member:, discriminant:)
+      @member = member
+      @discriminant = discriminant
+    end
+
+    # Deserialize a JSON object to an instance of BuyPhoneNumberDtoFallbackDestination
+    #
+    # @param json_object [String]
+    # @return [Vapi::BuyPhoneNumberDtoFallbackDestination]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      member = case struct.type
+               when "number"
+                 Vapi::TransferDestinationNumber.from_json(json_object: json_object)
+               when "sip"
+                 Vapi::TransferDestinationSip.from_json(json_object: json_object)
+               else
+                 Vapi::TransferDestinationNumber.from_json(json_object: json_object)
+               end
+      new(member: member, discriminant: struct.type)
+    end
+
+    # For Union Types, to_json functionality is delegated to the wrapped member.
+    #
+    # @return [String]
+    def to_json(*_args)
+      case @discriminant
+      when "number"
+        { **@member.to_json, type: @discriminant }.to_json
+      when "sip"
+        { **@member.to_json, type: @discriminant }.to_json
+      else
+        { "type": @discriminant, value: @member }.to_json
+      end
+      @member.to_json
+    end
+
+    # Leveraged for Union-type generation, validate_raw attempts to parse the given
+    #  hash and check each fields type against the current object's property
+    #  definitions.
+    #
+    # @param obj [Object]
+    # @return [Void]
+    def self.validate_raw(obj:)
+      case obj.type
+      when "number"
+        Vapi::TransferDestinationNumber.validate_raw(obj: obj)
+      when "sip"
+        Vapi::TransferDestinationSip.validate_raw(obj: obj)
+      else
+        raise("Passed value matched no type within the union, validation failed.")
+      end
+    end
+
+    # For Union Types, is_a? functionality is delegated to the wrapped member.
+    #
+    # @param obj [Object]
+    # @return [Boolean]
+    def is_a?(obj)
+      @member.is_a?(obj)
+    end
+
+    # @param member [Vapi::TransferDestinationNumber]
+    # @return [Vapi::BuyPhoneNumberDtoFallbackDestination]
+    def self.number(member:)
+      new(member: member, discriminant: "number")
+    end
+
+    # @param member [Vapi::TransferDestinationSip]
+    # @return [Vapi::BuyPhoneNumberDtoFallbackDestination]
+    def self.sip(member:)
+      new(member: member, discriminant: "sip")
+    end
+  end
+end