devdraft 1.0.2 → 1.0.3

data/lib/devdraft/api/products_api.rb

@@ -3,13 +3,16 @@
 
 # A comprehensive payment processing and business management API that enables seamless integration of cryptocurrency and traditional payment methods.     
 
-OpenAPI spec version: 1.0.0
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.17.0
 
-Generated by: https://github.com/swagger-api/swagger-codegen.git
-Swagger Codegen version: 3.0.65
 =end
 
-module DevDraftAI
+require 'cgi'
+
+module Devdraft
   class ProductsApi
     attr_accessor :api_client
 
@@ -18,42 +21,42 @@ module DevDraftAI
     end
     # Create a new product
     # Creates a new product with optional image uploads.      This endpoint allows you to create products with detailed information and multiple images.  ## Use Cases - Add new products to your catalog - Create products with multiple images - Set up product pricing and descriptions  ## Supported Image Formats - JPEG/JPG - PNG - WebP - Maximum 10 images per product - Maximum file size: 5MB per image  ## Example Request (multipart/form-data) ``` name: \"Premium Widget\" description: \"High-quality widget for all your needs\" price: \"99.99\" images: [file1.jpg, file2.jpg]  // Optional, up to 10 images ```  ## Required Fields - `name`: Product name - `price`: Product price (decimal number)  ## Optional Fields - `description`: Detailed product description - `images`: Product images (up to 10 files)
-    # @param name 
-    # @param description 
-    # @param price 
-    # @param currency 
-    # @param type 
-    # @param weight 
-    # @param unit 
-    # @param quantity 
-    # @param stock_count 
-    # @param status 
-    # @param product_type 
-    # @param images 
+    # @param name [String] Product name as it will appear to customers. Should be clear and descriptive.
+    # @param description [String] Detailed description of the product. Supports markdown formatting for rich text display.
+    # @param price [Float] Product price in the specified currency. Must be greater than 0.
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :currency Currency code for the price. Defaults to USD if not specified. (default to 'USD')
+    # @option opts [String] :type Product type
+    # @option opts [Float] :weight Weight of the product
+    # @option opts [String] :unit Unit of measurement
+    # @option opts [Float] :quantity Quantity available
+    # @option opts [Float] :stock_count Stock count
+    # @option opts [String] :status Product status
+    # @option opts [String] :product_type Product type
+    # @option opts [Array<String>] :images Array of image URLs
     # @return [nil]
-    def product_controller_create(name, description, price, currency, type, weight, unit, quantity, stock_count, status, product_type, images, opts = {})
-      product_controller_create_with_http_info(name, description, price, currency, type, weight, unit, quantity, stock_count, status, product_type, images, opts)
+    def product_controller_create(name, description, price, opts = {})
+      product_controller_create_with_http_info(name, description, price, opts)
       nil
     end
 
     # Create a new product
     # Creates a new product with optional image uploads.      This endpoint allows you to create products with detailed information and multiple images.  ## Use Cases - Add new products to your catalog - Create products with multiple images - Set up product pricing and descriptions  ## Supported Image Formats - JPEG/JPG - PNG - WebP - Maximum 10 images per product - Maximum file size: 5MB per image  ## Example Request (multipart/form-data) &#x60;&#x60;&#x60; name: \&quot;Premium Widget\&quot; description: \&quot;High-quality widget for all your needs\&quot; price: \&quot;99.99\&quot; images: [file1.jpg, file2.jpg]  // Optional, up to 10 images &#x60;&#x60;&#x60;  ## Required Fields - &#x60;name&#x60;: Product name - &#x60;price&#x60;: Product price (decimal number)  ## Optional Fields - &#x60;description&#x60;: Detailed product description - &#x60;images&#x60;: Product images (up to 10 files)
-    # @param name 
-    # @param description 
-    # @param price 
-    # @param currency 
-    # @param type 
-    # @param weight 
-    # @param unit 
-    # @param quantity 
-    # @param stock_count 
-    # @param status 
-    # @param product_type 
-    # @param images 
+    # @param name [String] Product name as it will appear to customers. Should be clear and descriptive.
+    # @param description [String] Detailed description of the product. Supports markdown formatting for rich text display.
+    # @param price [Float] Product price in the specified currency. Must be greater than 0.
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :currency Currency code for the price. Defaults to USD if not specified. (default to 'USD')
+    # @option opts [String] :type Product type
+    # @option opts [Float] :weight Weight of the product
+    # @option opts [String] :unit Unit of measurement
+    # @option opts [Float] :quantity Quantity available
+    # @option opts [Float] :stock_count Stock count
+    # @option opts [String] :status Product status
+    # @option opts [String] :product_type Product type
+    # @option opts [Array<String>] :images Array of image URLs
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def product_controller_create_with_http_info(name, description, price, currency, type, weight, unit, quantity, stock_count, status, product_type, images, opts = {})
+    def product_controller_create_with_http_info(name, description, price, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: ProductsApi.product_controller_create ...'
       end
@@ -61,53 +64,33 @@ module DevDraftAI
       if @api_client.config.client_side_validation && name.nil?
         fail ArgumentError, "Missing the required parameter 'name' when calling ProductsApi.product_controller_create"
       end
+      if @api_client.config.client_side_validation && name.to_s.length > 200
+        fail ArgumentError, 'invalid value for "name" when calling ProductsApi.product_controller_create, the character length must be smaller than or equal to 200.'
+      end
+
+      if @api_client.config.client_side_validation && name.to_s.length < 1
+        fail ArgumentError, 'invalid value for "name" when calling ProductsApi.product_controller_create, the character length must be greater than or equal to 1.'
+      end
+
       # verify the required parameter 'description' is set
       if @api_client.config.client_side_validation && description.nil?
         fail ArgumentError, "Missing the required parameter 'description' when calling ProductsApi.product_controller_create"
       end
+      if @api_client.config.client_side_validation && description.to_s.length > 2000
+        fail ArgumentError, 'invalid value for "description" when calling ProductsApi.product_controller_create, the character length must be smaller than or equal to 2000.'
+      end
+
       # verify the required parameter 'price' is set
       if @api_client.config.client_side_validation && price.nil?
         fail ArgumentError, "Missing the required parameter 'price' when calling ProductsApi.product_controller_create"
       end
-      # verify the required parameter 'currency' is set
-      if @api_client.config.client_side_validation && currency.nil?
-        fail ArgumentError, "Missing the required parameter 'currency' when calling ProductsApi.product_controller_create"
-      end
-      # verify enum value
-      if @api_client.config.client_side_validation && !['USD', 'EUR', 'GBP', 'CAD', 'AUD', 'JPY'].include?(currency)
-        fail ArgumentError, "invalid value for 'currency', must be one of USD, EUR, GBP, CAD, AUD, JPY"
-      end
-      # verify the required parameter 'type' is set
-      if @api_client.config.client_side_validation && type.nil?
-        fail ArgumentError, "Missing the required parameter 'type' when calling ProductsApi.product_controller_create"
-      end
-      # verify the required parameter 'weight' is set
-      if @api_client.config.client_side_validation && weight.nil?
-        fail ArgumentError, "Missing the required parameter 'weight' when calling ProductsApi.product_controller_create"
-      end
-      # verify the required parameter 'unit' is set
-      if @api_client.config.client_side_validation && unit.nil?
-        fail ArgumentError, "Missing the required parameter 'unit' when calling ProductsApi.product_controller_create"
-      end
-      # verify the required parameter 'quantity' is set
-      if @api_client.config.client_side_validation && quantity.nil?
-        fail ArgumentError, "Missing the required parameter 'quantity' when calling ProductsApi.product_controller_create"
-      end
-      # verify the required parameter 'stock_count' is set
-      if @api_client.config.client_side_validation && stock_count.nil?
-        fail ArgumentError, "Missing the required parameter 'stock_count' when calling ProductsApi.product_controller_create"
-      end
-      # verify the required parameter 'status' is set
-      if @api_client.config.client_side_validation && status.nil?
-        fail ArgumentError, "Missing the required parameter 'status' when calling ProductsApi.product_controller_create"
+      if @api_client.config.client_side_validation && price < 0.01
+        fail ArgumentError, 'invalid value for "price" when calling ProductsApi.product_controller_create, must be greater than or equal to 0.01.'
       end
-      # verify the required parameter 'product_type' is set
-      if @api_client.config.client_side_validation && product_type.nil?
-        fail ArgumentError, "Missing the required parameter 'product_type' when calling ProductsApi.product_controller_create"
-      end
-      # verify the required parameter 'images' is set
-      if @api_client.config.client_side_validation && images.nil?
-        fail ArgumentError, "Missing the required parameter 'images' when calling ProductsApi.product_controller_create"
+
+      allowable_values = ["USD", "EUR", "GBP", "CAD", "AUD", "JPY"]
+      if @api_client.config.client_side_validation && opts[:'currency'] && !allowable_values.include?(opts[:'currency'])
+        fail ArgumentError, "invalid value for \"currency\", must be one of #{allowable_values}"
       end
       # resource path
       local_var_path = '/api/v0/products'
@@ -118,47 +101,57 @@ module DevDraftAI
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Content-Type'
-      header_params['Content-Type'] = @api_client.select_header_content_type(['multipart/form-data'])
+      content_type = @api_client.select_header_content_type(['multipart/form-data'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
 
       # form parameters
       form_params = opts[:form_params] || {}
       form_params['name'] = name
       form_params['description'] = description
       form_params['price'] = price
-      form_params['currency'] = currency
-      form_params['type'] = type
-      form_params['weight'] = weight
-      form_params['unit'] = unit
-      form_params['quantity'] = quantity
-      form_params['stockCount'] = stock_count
-      form_params['status'] = status
-      form_params['productType'] = product_type
-      form_params['images'] = @api_client.build_collection_param(images, :multi)
+      form_params['currency'] = opts[:'currency'] if !opts[:'currency'].nil?
+      form_params['type'] = opts[:'type'] if !opts[:'type'].nil?
+      form_params['weight'] = opts[:'weight'] if !opts[:'weight'].nil?
+      form_params['unit'] = opts[:'unit'] if !opts[:'unit'].nil?
+      form_params['quantity'] = opts[:'quantity'] if !opts[:'quantity'].nil?
+      form_params['stockCount'] = opts[:'stock_count'] if !opts[:'stock_count'].nil?
+      form_params['status'] = opts[:'status'] if !opts[:'status'].nil?
+      form_params['productType'] = opts[:'product_type'] if !opts[:'product_type'].nil?
+      form_params['images'] = @api_client.build_collection_param(opts[:'images'], :csv) if !opts[:'images'].nil?
 
       # http body (model)
-      post_body = opts[:body] 
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
 
-      return_type = opts[:return_type] 
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['x-client-secret', 'x-client-key']
 
-      auth_names = opts[:auth_names] || ['x-client-key', 'x-client-secret']
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
+      new_options = opts.merge(
+        :operation => :"ProductsApi.product_controller_create",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => return_type)
+        :return_type => return_type
+      )
 
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: ProductsApi#product_controller_create\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
+
     # Get all products
     # Retrieves a list of products with pagination.      This endpoint allows you to fetch products with optional pagination.  ## Use Cases - List all products - Browse product catalog - Implement product search  ## Query Parameters - `skip`: Number of records to skip (default: 0) - `take`: Number of records to take (default: 10)  ## Example Response ```json {   \"data\": [     {       \"id\": \"prod_123456\",       \"name\": \"Premium Widget\",       \"description\": \"High-quality widget for all your needs\",       \"price\": \"99.99\",       \"images\": [         \"https://storage.example.com/images/file1.jpg\",         \"https://storage.example.com/images/file2.jpg\"       ],       \"createdAt\": \"2024-03-20T10:00:00Z\"     }   ],   \"total\": 100,   \"skip\": 0,   \"take\": 10 } ```
     # @param [Hash] opts the optional parameters
-    # @option opts [BigDecimal] :skip Number of records to skip
-    # @option opts [BigDecimal] :take Number of records to take
+    # @option opts [Float] :skip Number of records to skip
+    # @option opts [Float] :take Number of records to take
     # @return [nil]
     def product_controller_find_all(opts = {})
       product_controller_find_all_with_http_info(opts)
@@ -168,8 +161,8 @@ module DevDraftAI
     # Get all products
     # Retrieves a list of products with pagination.      This endpoint allows you to fetch products with optional pagination.  ## Use Cases - List all products - Browse product catalog - Implement product search  ## Query Parameters - &#x60;skip&#x60;: Number of records to skip (default: 0) - &#x60;take&#x60;: Number of records to take (default: 10)  ## Example Response &#x60;&#x60;&#x60;json {   \&quot;data\&quot;: [     {       \&quot;id\&quot;: \&quot;prod_123456\&quot;,       \&quot;name\&quot;: \&quot;Premium Widget\&quot;,       \&quot;description\&quot;: \&quot;High-quality widget for all your needs\&quot;,       \&quot;price\&quot;: \&quot;99.99\&quot;,       \&quot;images\&quot;: [         \&quot;https://storage.example.com/images/file1.jpg\&quot;,         \&quot;https://storage.example.com/images/file2.jpg\&quot;       ],       \&quot;createdAt\&quot;: \&quot;2024-03-20T10:00:00Z\&quot;     }   ],   \&quot;total\&quot;: 100,   \&quot;skip\&quot;: 0,   \&quot;take\&quot;: 10 } &#x60;&#x60;&#x60;
     # @param [Hash] opts the optional parameters
-    # @option opts [BigDecimal] :skip Number of records to skip
-    # @option opts [BigDecimal] :take Number of records to take
+    # @option opts [Float] :skip Number of records to skip
+    # @option opts [Float] :take Number of records to take
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def product_controller_find_all_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -190,27 +183,34 @@ module DevDraftAI
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:body] 
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
 
-      return_type = opts[:return_type] 
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['x-client-secret', 'x-client-key']
 
-      auth_names = opts[:auth_names] || ['x-client-key', 'x-client-secret']
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+      new_options = opts.merge(
+        :operation => :"ProductsApi.product_controller_find_all",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => return_type)
+        :return_type => return_type
+      )
 
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: ProductsApi#product_controller_find_all\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
+
     # Get a product by ID
     # Retrieves detailed information about a specific product.      This endpoint allows you to fetch complete product details including all images.  ## Use Cases - View product details - Display product information - Check product availability  ## Example Response ```json {   \"id\": \"prod_123456\",   \"name\": \"Premium Widget\",   \"description\": \"High-quality widget for all your needs\",   \"price\": \"99.99\",   \"images\": [     \"https://storage.example.com/images/file1.jpg\",     \"https://storage.example.com/images/file2.jpg\"   ],   \"createdAt\": \"2024-03-20T10:00:00Z\",   \"updatedAt\": \"2024-03-20T10:00:00Z\" } ```
-    # @param id Product ID
+    # @param id [String] Product ID
     # @param [Hash] opts the optional parameters
     # @return [nil]
     def product_controller_find_one(id, opts = {})
@@ -220,7 +220,7 @@ module DevDraftAI
 
     # Get a product by ID
     # Retrieves detailed information about a specific product.      This endpoint allows you to fetch complete product details including all images.  ## Use Cases - View product details - Display product information - Check product availability  ## Example Response &#x60;&#x60;&#x60;json {   \&quot;id\&quot;: \&quot;prod_123456\&quot;,   \&quot;name\&quot;: \&quot;Premium Widget\&quot;,   \&quot;description\&quot;: \&quot;High-quality widget for all your needs\&quot;,   \&quot;price\&quot;: \&quot;99.99\&quot;,   \&quot;images\&quot;: [     \&quot;https://storage.example.com/images/file1.jpg\&quot;,     \&quot;https://storage.example.com/images/file2.jpg\&quot;   ],   \&quot;createdAt\&quot;: \&quot;2024-03-20T10:00:00Z\&quot;,   \&quot;updatedAt\&quot;: \&quot;2024-03-20T10:00:00Z\&quot; } &#x60;&#x60;&#x60;
-    # @param id Product ID
+    # @param id [String] Product ID
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def product_controller_find_one_with_http_info(id, opts = {})
@@ -232,7 +232,7 @@ module DevDraftAI
         fail ArgumentError, "Missing the required parameter 'id' when calling ProductsApi.product_controller_find_one"
       end
       # resource path
-      local_var_path = '/api/v0/products/{id}'.sub('{' + 'id' + '}', id.to_s)
+      local_var_path = '/api/v0/products/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -244,27 +244,34 @@ module DevDraftAI
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:body] 
+      post_body = opts[:debug_body]
 
-      return_type = opts[:return_type] 
+      # return_type
+      return_type = opts[:debug_return_type]
 
-      auth_names = opts[:auth_names] || ['x-client-key', 'x-client-secret']
-      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['x-client-secret', 'x-client-key']
+
+      new_options = opts.merge(
+        :operation => :"ProductsApi.product_controller_find_one",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => return_type)
+        :return_type => return_type
+      )
 
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: ProductsApi#product_controller_find_one\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
+
     # Delete a product
     # Deletes a product and its associated images.      This endpoint allows you to remove a product and all its associated data.  ## Use Cases - Remove discontinued products - Clean up product catalog - Delete test products  ## Notes - This action cannot be undone - All product images will be deleted - Associated data will be removed
-    # @param id Product ID
+    # @param id [String] Product ID
     # @param [Hash] opts the optional parameters
     # @return [nil]
     def product_controller_remove(id, opts = {})
@@ -274,7 +281,7 @@ module DevDraftAI
 
     # Delete a product
     # Deletes a product and its associated images.      This endpoint allows you to remove a product and all its associated data.  ## Use Cases - Remove discontinued products - Clean up product catalog - Delete test products  ## Notes - This action cannot be undone - All product images will be deleted - Associated data will be removed
-    # @param id Product ID
+    # @param id [String] Product ID
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def product_controller_remove_with_http_info(id, opts = {})
@@ -286,7 +293,7 @@ module DevDraftAI
         fail ArgumentError, "Missing the required parameter 'id' when calling ProductsApi.product_controller_remove"
       end
       # resource path
-      local_var_path = '/api/v0/products/{id}'.sub('{' + 'id' + '}', id.to_s)
+      local_var_path = '/api/v0/products/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -298,125 +305,100 @@ module DevDraftAI
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:body] 
+      post_body = opts[:debug_body]
 
-      return_type = opts[:return_type] 
+      # return_type
+      return_type = opts[:debug_return_type]
 
-      auth_names = opts[:auth_names] || ['x-client-key', 'x-client-secret']
-      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path,
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['x-client-secret', 'x-client-key']
+
+      new_options = opts.merge(
+        :operation => :"ProductsApi.product_controller_remove",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => return_type)
+        :return_type => return_type
+      )
 
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: ProductsApi#product_controller_remove\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
+
     # Update a product
     # Updates an existing product's information and optionally adds new images.      This endpoint allows you to modify product details and manage product images.  ## Use Cases - Update product information - Change product pricing - Modify product images - Update product description  ## Example Request (multipart/form-data) ``` name: \"Updated Premium Widget\" description: \"Updated description\" price: \"129.99\" images: [file1.jpg, file2.jpg]  // Optional, up to 10 images ```  ## Notes - Only include fields that need to be updated - New images will replace existing images - Maximum 10 images per product - Images are automatically optimized
-    # @param name 
-    # @param description 
-    # @param price 
-    # @param currency 
-    # @param type 
-    # @param weight 
-    # @param unit 
-    # @param quantity 
-    # @param stock_count 
-    # @param status 
-    # @param product_type 
-    # @param images 
-    # @param id Product ID
+    # @param id [String] Product ID
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :name Product name as it will appear to customers. Should be clear and descriptive.
+    # @option opts [String] :description Detailed description of the product. Supports markdown formatting for rich text display.
+    # @option opts [Float] :price Product price in the specified currency. Must be greater than 0.
+    # @option opts [String] :currency Currency code for the price. Defaults to USD if not specified. (default to 'USD')
+    # @option opts [String] :type Product type
+    # @option opts [Float] :weight Weight of the product
+    # @option opts [String] :unit Unit of measurement
+    # @option opts [Float] :quantity Quantity available
+    # @option opts [Float] :stock_count Stock count
+    # @option opts [String] :status Product status
+    # @option opts [String] :product_type Product type
+    # @option opts [Array<String>] :images Array of image URLs
     # @return [nil]
-    def product_controller_update(name, description, price, currency, type, weight, unit, quantity, stock_count, status, product_type, images, id, opts = {})
-      product_controller_update_with_http_info(name, description, price, currency, type, weight, unit, quantity, stock_count, status, product_type, images, id, opts)
+    def product_controller_update(id, opts = {})
+      product_controller_update_with_http_info(id, opts)
       nil
     end
 
     # Update a product
-    # Updates an existing product&#x27;s information and optionally adds new images.      This endpoint allows you to modify product details and manage product images.  ## Use Cases - Update product information - Change product pricing - Modify product images - Update product description  ## Example Request (multipart/form-data) &#x60;&#x60;&#x60; name: \&quot;Updated Premium Widget\&quot; description: \&quot;Updated description\&quot; price: \&quot;129.99\&quot; images: [file1.jpg, file2.jpg]  // Optional, up to 10 images &#x60;&#x60;&#x60;  ## Notes - Only include fields that need to be updated - New images will replace existing images - Maximum 10 images per product - Images are automatically optimized
-    # @param name 
-    # @param description 
-    # @param price 
-    # @param currency 
-    # @param type 
-    # @param weight 
-    # @param unit 
-    # @param quantity 
-    # @param stock_count 
-    # @param status 
-    # @param product_type 
-    # @param images 
-    # @param id Product ID
+    # Updates an existing product&#39;s information and optionally adds new images.      This endpoint allows you to modify product details and manage product images.  ## Use Cases - Update product information - Change product pricing - Modify product images - Update product description  ## Example Request (multipart/form-data) &#x60;&#x60;&#x60; name: \&quot;Updated Premium Widget\&quot; description: \&quot;Updated description\&quot; price: \&quot;129.99\&quot; images: [file1.jpg, file2.jpg]  // Optional, up to 10 images &#x60;&#x60;&#x60;  ## Notes - Only include fields that need to be updated - New images will replace existing images - Maximum 10 images per product - Images are automatically optimized
+    # @param id [String] Product ID
     # @param [Hash] opts the optional parameters
+    # @option opts [String] :name Product name as it will appear to customers. Should be clear and descriptive.
+    # @option opts [String] :description Detailed description of the product. Supports markdown formatting for rich text display.
+    # @option opts [Float] :price Product price in the specified currency. Must be greater than 0.
+    # @option opts [String] :currency Currency code for the price. Defaults to USD if not specified. (default to 'USD')
+    # @option opts [String] :type Product type
+    # @option opts [Float] :weight Weight of the product
+    # @option opts [String] :unit Unit of measurement
+    # @option opts [Float] :quantity Quantity available
+    # @option opts [Float] :stock_count Stock count
+    # @option opts [String] :status Product status
+    # @option opts [String] :product_type Product type
+    # @option opts [Array<String>] :images Array of image URLs
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
-    def product_controller_update_with_http_info(name, description, price, currency, type, weight, unit, quantity, stock_count, status, product_type, images, id, opts = {})
+    def product_controller_update_with_http_info(id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: ProductsApi.product_controller_update ...'
       end
-      # verify the required parameter 'name' is set
-      if @api_client.config.client_side_validation && name.nil?
-        fail ArgumentError, "Missing the required parameter 'name' when calling ProductsApi.product_controller_update"
-      end
-      # verify the required parameter 'description' is set
-      if @api_client.config.client_side_validation && description.nil?
-        fail ArgumentError, "Missing the required parameter 'description' when calling ProductsApi.product_controller_update"
-      end
-      # verify the required parameter 'price' is set
-      if @api_client.config.client_side_validation && price.nil?
-        fail ArgumentError, "Missing the required parameter 'price' when calling ProductsApi.product_controller_update"
-      end
-      # verify the required parameter 'currency' is set
-      if @api_client.config.client_side_validation && currency.nil?
-        fail ArgumentError, "Missing the required parameter 'currency' when calling ProductsApi.product_controller_update"
-      end
-      # verify enum value
-      if @api_client.config.client_side_validation && !['USD', 'EUR', 'GBP', 'CAD', 'AUD', 'JPY'].include?(currency)
-        fail ArgumentError, "invalid value for 'currency', must be one of USD, EUR, GBP, CAD, AUD, JPY"
-      end
-      # verify the required parameter 'type' is set
-      if @api_client.config.client_side_validation && type.nil?
-        fail ArgumentError, "Missing the required parameter 'type' when calling ProductsApi.product_controller_update"
-      end
-      # verify the required parameter 'weight' is set
-      if @api_client.config.client_side_validation && weight.nil?
-        fail ArgumentError, "Missing the required parameter 'weight' when calling ProductsApi.product_controller_update"
-      end
-      # verify the required parameter 'unit' is set
-      if @api_client.config.client_side_validation && unit.nil?
-        fail ArgumentError, "Missing the required parameter 'unit' when calling ProductsApi.product_controller_update"
-      end
-      # verify the required parameter 'quantity' is set
-      if @api_client.config.client_side_validation && quantity.nil?
-        fail ArgumentError, "Missing the required parameter 'quantity' when calling ProductsApi.product_controller_update"
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ProductsApi.product_controller_update"
       end
-      # verify the required parameter 'stock_count' is set
-      if @api_client.config.client_side_validation && stock_count.nil?
-        fail ArgumentError, "Missing the required parameter 'stock_count' when calling ProductsApi.product_controller_update"
+      if @api_client.config.client_side_validation && !opts[:'name'].nil? && opts[:'name'].to_s.length > 200
+        fail ArgumentError, 'invalid value for "opts[:"name"]" when calling ProductsApi.product_controller_update, the character length must be smaller than or equal to 200.'
       end
-      # verify the required parameter 'status' is set
-      if @api_client.config.client_side_validation && status.nil?
-        fail ArgumentError, "Missing the required parameter 'status' when calling ProductsApi.product_controller_update"
+
+      if @api_client.config.client_side_validation && !opts[:'name'].nil? && opts[:'name'].to_s.length < 1
+        fail ArgumentError, 'invalid value for "opts[:"name"]" when calling ProductsApi.product_controller_update, the character length must be greater than or equal to 1.'
       end
-      # verify the required parameter 'product_type' is set
-      if @api_client.config.client_side_validation && product_type.nil?
-        fail ArgumentError, "Missing the required parameter 'product_type' when calling ProductsApi.product_controller_update"
+
+      if @api_client.config.client_side_validation && !opts[:'description'].nil? && opts[:'description'].to_s.length > 2000
+        fail ArgumentError, 'invalid value for "opts[:"description"]" when calling ProductsApi.product_controller_update, the character length must be smaller than or equal to 2000.'
       end
-      # verify the required parameter 'images' is set
-      if @api_client.config.client_side_validation && images.nil?
-        fail ArgumentError, "Missing the required parameter 'images' when calling ProductsApi.product_controller_update"
+
+      if @api_client.config.client_side_validation && !opts[:'price'].nil? && opts[:'price'] < 0.01
+        fail ArgumentError, 'invalid value for "opts[:"price"]" when calling ProductsApi.product_controller_update, must be greater than or equal to 0.01.'
       end
-      # verify the required parameter 'id' is set
-      if @api_client.config.client_side_validation && id.nil?
-        fail ArgumentError, "Missing the required parameter 'id' when calling ProductsApi.product_controller_update"
+
+      allowable_values = ["USD", "EUR", "GBP", "CAD", "AUD", "JPY"]
+      if @api_client.config.client_side_validation && opts[:'currency'] && !allowable_values.include?(opts[:'currency'])
+        fail ArgumentError, "invalid value for \"currency\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/v0/products/{id}'.sub('{' + 'id' + '}', id.to_s)
+      local_var_path = '/api/v0/products/{id}'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -424,45 +406,55 @@ module DevDraftAI
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Content-Type'
-      header_params['Content-Type'] = @api_client.select_header_content_type(['multipart/form-data'])
+      content_type = @api_client.select_header_content_type(['multipart/form-data'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
 
       # form parameters
       form_params = opts[:form_params] || {}
-      form_params['name'] = name
-      form_params['description'] = description
-      form_params['price'] = price
-      form_params['currency'] = currency
-      form_params['type'] = type
-      form_params['weight'] = weight
-      form_params['unit'] = unit
-      form_params['quantity'] = quantity
-      form_params['stockCount'] = stock_count
-      form_params['status'] = status
-      form_params['productType'] = product_type
-      form_params['images'] = @api_client.build_collection_param(images, :multi)
+      form_params['name'] = opts[:'name'] if !opts[:'name'].nil?
+      form_params['description'] = opts[:'description'] if !opts[:'description'].nil?
+      form_params['price'] = opts[:'price'] if !opts[:'price'].nil?
+      form_params['currency'] = opts[:'currency'] if !opts[:'currency'].nil?
+      form_params['type'] = opts[:'type'] if !opts[:'type'].nil?
+      form_params['weight'] = opts[:'weight'] if !opts[:'weight'].nil?
+      form_params['unit'] = opts[:'unit'] if !opts[:'unit'].nil?
+      form_params['quantity'] = opts[:'quantity'] if !opts[:'quantity'].nil?
+      form_params['stockCount'] = opts[:'stock_count'] if !opts[:'stock_count'].nil?
+      form_params['status'] = opts[:'status'] if !opts[:'status'].nil?
+      form_params['productType'] = opts[:'product_type'] if !opts[:'product_type'].nil?
+      form_params['images'] = @api_client.build_collection_param(opts[:'images'], :csv) if !opts[:'images'].nil?
 
       # http body (model)
-      post_body = opts[:body] 
+      post_body = opts[:debug_body]
 
-      return_type = opts[:return_type] 
+      # return_type
+      return_type = opts[:debug_return_type]
 
-      auth_names = opts[:auth_names] || ['x-client-key', 'x-client-secret']
-      data, status_code, headers = @api_client.call_api(:PUT, local_var_path,
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['x-client-secret', 'x-client-key']
+
+      new_options = opts.merge(
+        :operation => :"ProductsApi.product_controller_update",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => return_type)
+        :return_type => return_type
+      )
 
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: ProductsApi#product_controller_update\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end
+
     # Upload images for a product
     # Adds new images to an existing product.      This endpoint allows you to upload additional images for a product that already exists.  ## Use Cases - Add more product images - Update product gallery - Enhance product presentation  ## Supported Image Formats - JPEG/JPG - PNG - WebP - Maximum 10 images per upload - Maximum file size: 5MB per image  ## Example Request (multipart/form-data) ``` images: [file1.jpg, file2.jpg]  // Up to 10 images ```  ## Notes - Images are appended to existing product images - Total images per product cannot exceed 10 - Images are automatically optimized and resized
-    # @param id Product ID
+    # @param id [String] Product ID
     # @param [Hash] opts the optional parameters
     # @return [nil]
     def product_controller_upload_image(id, opts = {})
@@ -472,7 +464,7 @@ module DevDraftAI
 
     # Upload images for a product
     # Adds new images to an existing product.      This endpoint allows you to upload additional images for a product that already exists.  ## Use Cases - Add more product images - Update product gallery - Enhance product presentation  ## Supported Image Formats - JPEG/JPG - PNG - WebP - Maximum 10 images per upload - Maximum file size: 5MB per image  ## Example Request (multipart/form-data) &#x60;&#x60;&#x60; images: [file1.jpg, file2.jpg]  // Up to 10 images &#x60;&#x60;&#x60;  ## Notes - Images are appended to existing product images - Total images per product cannot exceed 10 - Images are automatically optimized and resized
-    # @param id Product ID
+    # @param id [String] Product ID
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def product_controller_upload_image_with_http_info(id, opts = {})
@@ -484,7 +476,7 @@ module DevDraftAI
         fail ArgumentError, "Missing the required parameter 'id' when calling ProductsApi.product_controller_upload_image"
       end
       # resource path
-      local_var_path = '/api/v0/products/{id}/images'.sub('{' + 'id' + '}', id.to_s)
+      local_var_path = '/api/v0/products/{id}/images'.sub('{' + 'id' + '}', CGI.escape(id.to_s))
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -496,19 +488,25 @@ module DevDraftAI
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:body] 
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
 
-      return_type = opts[:return_type] 
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['x-client-secret', 'x-client-key']
 
-      auth_names = opts[:auth_names] || ['x-client-key', 'x-client-secret']
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
+      new_options = opts.merge(
+        :operation => :"ProductsApi.product_controller_upload_image",
         :header_params => header_params,
         :query_params => query_params,
         :form_params => form_params,
         :body => post_body,
         :auth_names => auth_names,
-        :return_type => return_type)
+        :return_type => return_type
+      )
 
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: ProductsApi#product_controller_upload_image\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end