vellum_ai 0.3.15 → 0.14.75

data/lib/vellum_ai/types/enriched_normalized_completion.rb

@@ -1,118 +1,137 @@
 # frozen_string_literal: true
-
 require_relative "finish_reason_enum"
 require_relative "normalized_log_probs"
 require_relative "vellum_variable_type"
+require "ostruct"
 require "json"
 
 module Vellum
   class EnrichedNormalizedCompletion
-    attr_reader :id, :external_id, :text, :finish_reason, :logprobs, :model_version_id, :prompt_version_id, :type,
-                :deployment_release_tag, :model_name, :additional_properties
+  # @return [String] The Vellum-generated ID of the completion.
+    attr_reader :id
+  # @return [String] The external ID that was originally provided along with the generation request,
+#  which uniquely identifies this generation in an external system.
+    attr_reader :external_id
+  # @return [String] The text generated by the LLM.
+    attr_reader :text
+  # @return [Vellum::FinishReasonEnum] The reason the generation finished.
+#  * `LENGTH` - LENGTH
+#  * `STOP` - STOP
+#  * `UNKNOWN` - UNKNOWN
+    attr_reader :finish_reason
+  # @return [Vellum::NormalizedLogProbs] The logprobs of the completion. Only present if specified in the original
+#  request options.
+    attr_reader :logprobs
+  # @return [String] The ID of the model version used to generate this completion.
+    attr_reader :model_version_id
+  # @return [String] 
+    attr_reader :prompt_version_id
+  # @return [Vellum::VellumVariableType] 
+    attr_reader :type
+  # @return [String] 
+    attr_reader :deployment_release_tag
+  # @return [String] 
+    attr_reader :model_name
+  # @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 id [String] The Vellum-generated ID of the completion.
-    # @param external_id [String] The external ID that was originally provided along with the generation request, which uniquely identifies this generation in an external system.
+    # @param external_id [String] The external ID that was originally provided along with the generation request,
+#  which uniquely identifies this generation in an external system.
     # @param text [String] The text generated by the LLM.
-    # @param finish_reason [FINISH_REASON_ENUM] The reason the generation finished.
-    #   - `LENGTH` - LENGTH
-    #   - `STOP` - STOP
-    #   - `UNKNOWN` - UNKNOWN
-    # @param logprobs [NormalizedLogProbs] The logprobs of the completion. Only present if specified in the original request options.
+    # @param finish_reason [Vellum::FinishReasonEnum] The reason the generation finished.
+#  * `LENGTH` - LENGTH
+#  * `STOP` - STOP
+#  * `UNKNOWN` - UNKNOWN
+    # @param logprobs [Vellum::NormalizedLogProbs] The logprobs of the completion. Only present if specified in the original
+#  request options.
     # @param model_version_id [String] The ID of the model version used to generate this completion.
-    # @param prompt_version_id [String]
-    # @param type [VELLUM_VARIABLE_TYPE]
-    # @param deployment_release_tag [String]
-    # @param model_name [String]
+    # @param prompt_version_id [String] 
+    # @param type [Vellum::VellumVariableType] 
+    # @param deployment_release_tag [String] 
+    # @param model_name [String] 
     # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
-    # @return [EnrichedNormalizedCompletion]
-    def initialize(id:, text:, model_version_id:, prompt_version_id:, deployment_release_tag:, model_name:,
-                   external_id: nil, finish_reason: nil, logprobs: nil, type: nil, additional_properties: nil)
-      # @type [String] The Vellum-generated ID of the completion.
+    # @return [Vellum::EnrichedNormalizedCompletion]
+    def initialize(id:, external_id: OMIT, text:, finish_reason: OMIT, logprobs: OMIT, model_version_id: OMIT, prompt_version_id:, type: OMIT, deployment_release_tag:, model_name:, additional_properties: nil)
       @id = id
-      # @type [String] The external ID that was originally provided along with the generation request, which uniquely identifies this generation in an external system.
-      @external_id = external_id
-      # @type [String] The text generated by the LLM.
+      @external_id = external_id if external_id != OMIT
       @text = text
-      # @type [FINISH_REASON_ENUM] The reason the generation finished.
-      #   - `LENGTH` - LENGTH
-      #   - `STOP` - STOP
-      #   - `UNKNOWN` - UNKNOWN
-      @finish_reason = finish_reason
-      # @type [NormalizedLogProbs] The logprobs of the completion. Only present if specified in the original request options.
-      @logprobs = logprobs
-      # @type [String] The ID of the model version used to generate this completion.
-      @model_version_id = model_version_id
-      # @type [String]
+      @finish_reason = finish_reason if finish_reason != OMIT
+      @logprobs = logprobs if logprobs != OMIT
+      @model_version_id = model_version_id if model_version_id != OMIT
       @prompt_version_id = prompt_version_id
-      # @type [VELLUM_VARIABLE_TYPE]
-      @type = type
-      # @type [String]
+      @type = type if type != OMIT
       @deployment_release_tag = deployment_release_tag
-      # @type [String]
       @model_name = model_name
-      # @type [OpenStruct] Additional properties unmapped to the current class definition
       @additional_properties = additional_properties
+      @_field_set = { "id": id, "external_id": external_id, "text": text, "finish_reason": finish_reason, "logprobs": logprobs, "model_version_id": model_version_id, "prompt_version_id": prompt_version_id, "type": type, "deployment_release_tag": deployment_release_tag, "model_name": model_name }.reject do | _k, v |
+  v == OMIT
+end
     end
-
-    # Deserialize a JSON object to an instance of EnrichedNormalizedCompletion
+# Deserialize a JSON object to an instance of EnrichedNormalizedCompletion
     #
-    # @param json_object [JSON]
-    # @return [EnrichedNormalizedCompletion]
+    # @param json_object [String] 
+    # @return [Vellum::EnrichedNormalizedCompletion]
     def self.from_json(json_object:)
       struct = JSON.parse(json_object, object_class: OpenStruct)
       parsed_json = JSON.parse(json_object)
-      id = struct.id
-      external_id = struct.external_id
-      text = struct.text
-      finish_reason = FINISH_REASON_ENUM.key(parsed_json["finish_reason"]) || parsed_json["finish_reason"]
-      if parsed_json["logprobs"].nil?
-        logprobs = nil
-      else
+      id = parsed_json["id"]
+      external_id = parsed_json["external_id"]
+      text = parsed_json["text"]
+      finish_reason = parsed_json["finish_reason"]
+      unless parsed_json["logprobs"].nil?
         logprobs = parsed_json["logprobs"].to_json
-        logprobs = NormalizedLogProbs.from_json(json_object: logprobs)
+        logprobs = Vellum::NormalizedLogProbs.from_json(json_object: logprobs)
+      else
+        logprobs = nil
       end
-      model_version_id = struct.model_version_id
-      prompt_version_id = struct.prompt_version_id
-      type = VELLUM_VARIABLE_TYPE.key(parsed_json["type"]) || parsed_json["type"]
-      deployment_release_tag = struct.deployment_release_tag
-      model_name = struct.model_name
-      new(id: id, external_id: external_id, text: text, finish_reason: finish_reason, logprobs: logprobs,
-          model_version_id: model_version_id, prompt_version_id: prompt_version_id, type: type, deployment_release_tag: deployment_release_tag, model_name: model_name, additional_properties: struct)
+      model_version_id = parsed_json["model_version_id"]
+      prompt_version_id = parsed_json["prompt_version_id"]
+      type = parsed_json["type"]
+      deployment_release_tag = parsed_json["deployment_release_tag"]
+      model_name = parsed_json["model_name"]
+      new(
+        id: id,
+        external_id: external_id,
+        text: text,
+        finish_reason: finish_reason,
+        logprobs: logprobs,
+        model_version_id: model_version_id,
+        prompt_version_id: prompt_version_id,
+        type: type,
+        deployment_release_tag: deployment_release_tag,
+        model_name: model_name,
+        additional_properties: struct
+      )
     end
-
-    # Serialize an instance of EnrichedNormalizedCompletion to a JSON object
+# Serialize an instance of EnrichedNormalizedCompletion to a JSON object
     #
-    # @return [JSON]
-    def to_json(*_args)
-      {
-        "id": @id,
-        "external_id": @external_id,
-        "text": @text,
-        "finish_reason": FINISH_REASON_ENUM[@finish_reason] || @finish_reason,
-        "logprobs": @logprobs,
-        "model_version_id": @model_version_id,
-        "prompt_version_id": @prompt_version_id,
-        "type": VELLUM_VARIABLE_TYPE[@type] || @type,
-        "deployment_release_tag": @deployment_release_tag,
-        "model_name": @model_name
-      }.to_json
+    # @return [String]
+    def to_json
+      @_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.
+# 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]
+    # @param obj [Object] 
     # @return [Void]
     def self.validate_raw(obj:)
       obj.id.is_a?(String) != false || raise("Passed value for field obj.id is not the expected type, validation failed.")
       obj.external_id&.is_a?(String) != false || raise("Passed value for field obj.external_id is not the expected type, validation failed.")
       obj.text.is_a?(String) != false || raise("Passed value for field obj.text is not the expected type, validation failed.")
-      obj.finish_reason&.is_a?(FINISH_REASON_ENUM) != false || raise("Passed value for field obj.finish_reason is not the expected type, validation failed.")
-      obj.logprobs.nil? || NormalizedLogProbs.validate_raw(obj: obj.logprobs)
-      obj.model_version_id.is_a?(String) != false || raise("Passed value for field obj.model_version_id is not the expected type, validation failed.")
+      obj.finish_reason&.is_a?(Vellum::FinishReasonEnum) != false || raise("Passed value for field obj.finish_reason is not the expected type, validation failed.")
+      obj.logprobs.nil? || Vellum::NormalizedLogProbs.validate_raw(obj: obj.logprobs)
+      obj.model_version_id&.is_a?(String) != false || raise("Passed value for field obj.model_version_id is not the expected type, validation failed.")
       obj.prompt_version_id.is_a?(String) != false || raise("Passed value for field obj.prompt_version_id is not the expected type, validation failed.")
-      obj.type&.is_a?(VELLUM_VARIABLE_TYPE) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      obj.type&.is_a?(Vellum::VellumVariableType) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
       obj.deployment_release_tag.is_a?(String) != false || raise("Passed value for field obj.deployment_release_tag is not the expected type, validation failed.")
       obj.model_name.is_a?(String) != false || raise("Passed value for field obj.model_name is not the expected type, validation failed.")
     end
   end
-end
+end

data/lib/vellum_ai/types/entity_status.rb

@@ -1,6 +1,12 @@
 # frozen_string_literal: true
 
 module Vellum
-  # @type [ENTITY_STATUS]
-  ENTITY_STATUS = { active: "ACTIVE", archived: "ARCHIVED" }.freeze
-end
+# * `ACTIVE` - Active
+#  * `ARCHIVED` - Archived
+  class EntityStatus
+
+    ACTIVE = "ACTIVE"
+    ARCHIVED = "ARCHIVED"
+
+  end
+end

data/lib/vellum_ai/types/entity_visibility.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Vellum
+# * `DEFAULT` - Default
+#  * `PUBLIC` - Public
+#  * `PRIVATE` - Private
+#  * `DISABLED` - Disabled
+  class EntityVisibility
+
+    DEFAULT = "DEFAULT"
+    PUBLIC = "PUBLIC"
+    PRIVATE = "PRIVATE"
+    DISABLED = "DISABLED"
+
+  end
+end

data/lib/vellum_ai/types/environment_enum.rb

@@ -1,6 +1,14 @@
 # frozen_string_literal: true
 
 module Vellum
-  # @type [ENVIRONMENT_ENUM]
-  ENVIRONMENT_ENUM = { development: "DEVELOPMENT", staging: "STAGING", production: "PRODUCTION" }.freeze
-end
+# * `DEVELOPMENT` - Development
+#  * `STAGING` - Staging
+#  * `PRODUCTION` - Production
+  class EnvironmentEnum
+
+    DEVELOPMENT = "DEVELOPMENT"
+    STAGING = "STAGING"
+    PRODUCTION = "PRODUCTION"
+
+  end
+end

data/lib/vellum_ai/types/ephemeral_prompt_cache_config.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+require_relative "ephemeral_prompt_cache_config_type_enum"
+require "ostruct"
+require "json"
+
+module Vellum
+  class EphemeralPromptCacheConfig
+  # @return [Vellum::EPHEMERAL_PROMPT_CACHE_CONFIG_TYPE_ENUM] 
+    attr_reader :type
+  # @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 type [Vellum::EPHEMERAL_PROMPT_CACHE_CONFIG_TYPE_ENUM] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::EphemeralPromptCacheConfig]
+    def initialize(type: OMIT, additional_properties: nil)
+      @type = type if type != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "type": type }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of EphemeralPromptCacheConfig
+    #
+    # @param json_object [String] 
+    # @return [Vellum::EphemeralPromptCacheConfig]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      type = parsed_json["type"]
+      new(type: type, additional_properties: struct)
+    end
+# Serialize an instance of EphemeralPromptCacheConfig to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_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.type&.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/ephemeral_prompt_cache_config_type_enum.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Vellum
+  EPHEMERAL_PROMPT_CACHE_CONFIG_TYPE_ENUM = String
+end

data/lib/vellum_ai/types/error_input.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+require_relative "vellum_error"
+require "ostruct"
+require "json"
+
+module Vellum
+# A user input representing a Vellum Error value
+  class ErrorInput
+  # @return [String] The variable's name
+    attr_reader :name
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumError] 
+    attr_reader :value
+  # @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] The variable's name
+    # @param type [String] 
+    # @param value [Vellum::VellumError] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::ErrorInput]
+    def initialize(name:, type:, value:, additional_properties: nil)
+      @name = name
+      @type = type
+      @value = value
+      @additional_properties = additional_properties
+      @_field_set = { "name": name, "type": type, "value": value }
+    end
+# Deserialize a JSON object to an instance of ErrorInput
+    #
+    # @param json_object [String] 
+    # @return [Vellum::ErrorInput]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      name = parsed_json["name"]
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumError.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        name: name,
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of ErrorInput to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_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.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      Vellum::VellumError.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/error_vellum_value.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+require_relative "vellum_error"
+require "ostruct"
+require "json"
+
+module Vellum
+# A value representing an Error.
+  class ErrorVellumValue
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumError] 
+    attr_reader :value
+  # @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 type [String] 
+    # @param value [Vellum::VellumError] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::ErrorVellumValue]
+    def initialize(type:, value: OMIT, additional_properties: nil)
+      @type = type
+      @value = value if value != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "type": type, "value": value }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of ErrorVellumValue
+    #
+    # @param json_object [String] 
+    # @return [Vellum::ErrorVellumValue]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumError.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of ErrorVellumValue to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_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.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      obj.value.nil? || Vellum::VellumError.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/error_vellum_value_request.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+require_relative "vellum_error_request"
+require "ostruct"
+require "json"
+
+module Vellum
+# A value representing an Error.
+  class ErrorVellumValueRequest
+  # @return [String] 
+    attr_reader :type
+  # @return [Vellum::VellumErrorRequest] 
+    attr_reader :value
+  # @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 type [String] 
+    # @param value [Vellum::VellumErrorRequest] 
+    # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+    # @return [Vellum::ErrorVellumValueRequest]
+    def initialize(type:, value: OMIT, additional_properties: nil)
+      @type = type
+      @value = value if value != OMIT
+      @additional_properties = additional_properties
+      @_field_set = { "type": type, "value": value }.reject do | _k, v |
+  v == OMIT
+end
+    end
+# Deserialize a JSON object to an instance of ErrorVellumValueRequest
+    #
+    # @param json_object [String] 
+    # @return [Vellum::ErrorVellumValueRequest]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      parsed_json = JSON.parse(json_object)
+      type = parsed_json["type"]
+      unless parsed_json["value"].nil?
+        value = parsed_json["value"].to_json
+        value = Vellum::VellumErrorRequest.from_json(json_object: value)
+      else
+        value = nil
+      end
+      new(
+        type: type,
+        value: value,
+        additional_properties: struct
+      )
+    end
+# Serialize an instance of ErrorVellumValueRequest to a JSON object
+    #
+    # @return [String]
+    def to_json
+      @_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.type.is_a?(String) != false || raise("Passed value for field obj.type is not the expected type, validation failed.")
+      obj.value.nil? || Vellum::VellumErrorRequest.validate_raw(obj: obj.value)
+    end
+  end
+end

data/lib/vellum_ai/types/execute_api_request_bearer_token.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+require "json"
+require_relative "vellum_secret"
+
+module Vellum
+  class ExecuteApiRequestBearerToken
+
+
+# Deserialize a JSON object to an instance of ExecuteApiRequestBearerToken
+    #
+    # @param json_object [String] 
+    # @return [Vellum::ExecuteApiRequestBearerToken]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      begin
+        struct.is_a?(String) != false || raise("Passed value for field struct is not the expected type, validation failed.")
+        unless struct.nil?
+  return struct
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        Vellum::VellumSecret.validate_raw(obj: struct)
+        unless struct.nil?
+  return Vellum::VellumSecret.from_json(json_object: struct)
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+ return struct
+    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:)
+      begin
+        return obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+      rescue StandardError
+        # noop
+      end
+      begin
+        return Vellum::VellumSecret.validate_raw(obj: obj)
+      rescue StandardError
+        # noop
+      end
+      raise("Passed value matched no type within the union, validation failed.")
+    end
+  end
+end

data/lib/vellum_ai/types/execute_api_request_body.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+require "json"
+
+module Vellum
+  class ExecuteApiRequestBody
+
+
+# Deserialize a JSON object to an instance of ExecuteApiRequestBody
+    #
+    # @param json_object [String] 
+    # @return [Vellum::ExecuteApiRequestBody]
+    def self.from_json(json_object:)
+      struct = JSON.parse(json_object, object_class: OpenStruct)
+      begin
+        struct.is_a?(String) != false || raise("Passed value for field struct is not the expected type, validation failed.")
+        unless struct.nil?
+  return struct
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        struct.is_a?(Array) != false || raise("Passed value for field struct is not the expected type, validation failed.")
+        unless struct.nil?
+  return struct
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+      begin
+        struct.is_a?(Hash) != false || raise("Passed value for field struct is not the expected type, validation failed.")
+        unless struct.nil?
+  return struct
+else
+  return nil
+end
+      rescue StandardError
+        # noop
+      end
+ return struct
+    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:)
+      begin
+        return obj.is_a?(String) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+      rescue StandardError
+        # noop
+      end
+      begin
+        return obj.is_a?(Array) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+      rescue StandardError
+        # noop
+      end
+      begin
+        return obj.is_a?(Hash) != false || raise("Passed value for field obj is not the expected type, validation failed.")
+      rescue StandardError
+        # noop
+      end
+      raise("Passed value matched no type within the union, validation failed.")
+    end
+  end
+end