SDK regeneration

.fern/metadata.json

@@ -1,9 +1,10 @@
 {
-  "cliVersion": "3.98.5",
+  "cliVersion": "5.56.0",
   "generatorName": "fernapi/fern-ruby-sdk",
   "generatorVersion": "1.0.0-rc84",
   "generatorConfig": {
     "enableWireTests": true
   },
-  "sdkVersion": "45.2.0-rc.0"
+  "originGitCommit": "b2dac8b2c1b9fe87c0e1fe3eb6257b259caa0715",
+  "sdkVersion": "46.0.1.20260715"
 }

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    square.rb (45.2.0.pre.rc.0)
+    square.rb (46.0.1.20260715)
 
 GEM
   remote: https://rubygems.org/
@@ -16,8 +16,8 @@ GEM
       rexml
     hashdiff (1.2.1)
     io-console (0.8.2)
-    json (2.19.9)
-    language_server-protocol (3.17.0.5)
+    json (2.21.1)
+    language_server-protocol (3.17.0.6)
     lint_roller (1.1.0)
     method_source (1.1.0)
     minitest (5.27.0)
@@ -40,7 +40,7 @@ GEM
     reline (0.6.3)
       io-console (~> 0.5)
     rexml (3.4.4)
-    rubocop (1.88.0)
+    rubocop (1.88.2)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -51,7 +51,7 @@ GEM
       rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.1)
+    rubocop-ast (1.50.0)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
     rubocop-minitest (0.39.1)

lib/square.rb

@@ -99,12 +99,13 @@
 require_relative "square/types/catalog_measurement_unit"
 require_relative "square/types/inventory_state"
 require_relative "square/types/inventory_adjustment_group"
+require_relative "square/types/inventory_adjustment_reason_id_type"
+require_relative "square/types/inventory_adjustment_reason_id"
 require_relative "square/types/product"
 require_relative "square/types/source_application"
 require_relative "square/types/inventory_adjustment"
 require_relative "square/types/inventory_change_type"
 require_relative "square/types/inventory_physical_count"
-require_relative "square/types/inventory_transfer"
 require_relative "square/types/inventory_change"
 require_relative "square/types/batch_change_inventory_request"
 require_relative "square/types/inventory_count"
@@ -145,6 +146,7 @@
 require_relative "square/types/catalog_item_option_value"
 require_relative "square/types/catalog_item_option_value_for_item_variation"
 require_relative "square/types/catalog_item_product_type"
+require_relative "square/types/catalog_item_variation_vendor_information"
 require_relative "square/types/catalog_pricing_type"
 require_relative "square/types/catalog_stock_conversion"
 require_relative "square/types/inventory_alert_type"
@@ -195,6 +197,9 @@
 require_relative "square/types/catalog_item_option"
 require_relative "square/types/catalog_item"
 require_relative "square/types/batch_get_catalog_objects_response"
+require_relative "square/types/batch_retrieve_inventory_changes_sort_field"
+require_relative "square/types/sort_order"
+require_relative "square/types/batch_retrieve_inventory_changes_sort"
 require_relative "square/types/batch_retrieve_inventory_changes_request"
 require_relative "square/types/batch_get_inventory_changes_response"
 require_relative "square/types/batch_get_inventory_counts_request"
@@ -209,6 +214,7 @@
 require_relative "square/types/fulfillment_delivery_details"
 require_relative "square/types/fulfillment_fulfillment_entry"
 require_relative "square/types/fulfillment_fulfillment_line_item_application"
+require_relative "square/types/fulfillment_in_store_details"
 require_relative "square/types/fulfillment_pickup_details_curbside_pickup_details"
 require_relative "square/types/fulfillment_pickup_details_schedule_type"
 require_relative "square/types/fulfillment_pickup_details"
@@ -513,7 +519,6 @@
 require_relative "square/types/catalog_query_prefix"
 require_relative "square/types/catalog_query_range"
 require_relative "square/types/catalog_query_set"
-require_relative "square/types/sort_order"
 require_relative "square/types/catalog_query_sorted_attribute"
 require_relative "square/types/catalog_query_text"
 require_relative "square/types/catalog_query"
@@ -604,6 +609,9 @@
 require_relative "square/types/gift_card_type"
 require_relative "square/types/gift_card"
 require_relative "square/types/create_gift_card_response"
+require_relative "square/types/inventory_adjustment_reason_direction"
+require_relative "square/types/inventory_adjustment_reason"
+require_relative "square/types/create_inventory_adjustment_reason_response"
 require_relative "square/types/create_invoice_attachment_request_data"
 require_relative "square/types/create_invoice_attachment_response"
 require_relative "square/types/create_invoice_response"
@@ -713,6 +721,7 @@
 require_relative "square/types/delete_customer_custom_attribute_response"
 require_relative "square/types/delete_customer_group_response"
 require_relative "square/types/delete_dispute_evidence_response"
+require_relative "square/types/delete_inventory_adjustment_reason_response"
 require_relative "square/types/delete_invoice_attachment_response"
 require_relative "square/types/delete_invoice_response"
 require_relative "square/types/delete_location_custom_attribute_definition_response"
@@ -910,6 +919,7 @@
 require_relative "square/types/list_event_types_response"
 require_relative "square/types/list_gift_card_activities_response"
 require_relative "square/types/list_gift_cards_response"
+require_relative "square/types/list_inventory_adjustment_reasons_response"
 require_relative "square/types/list_invoices_response"
 require_relative "square/types/list_jobs_response"
 require_relative "square/types/location_booking_profile"
@@ -1118,6 +1128,7 @@
 require_relative "square/types/register_domain_response_status"
 require_relative "square/types/register_domain_response"
 require_relative "square/types/remove_group_from_customer_response"
+require_relative "square/types/restore_inventory_adjustment_reason_response"
 require_relative "square/types/resume_subscription_response"
 require_relative "square/types/retrieve_booking_custom_attribute_definition_response"
 require_relative "square/types/retrieve_booking_custom_attribute_response"
@@ -1135,11 +1146,11 @@
 require_relative "square/types/get_gift_card_from_gan_response"
 require_relative "square/types/get_gift_card_from_nonce_response"
 require_relative "square/types/get_gift_card_response"
+require_relative "square/types/retrieve_inventory_adjustment_reason_response"
 require_relative "square/types/get_inventory_adjustment_response"
 require_relative "square/types/get_inventory_changes_response"
 require_relative "square/types/get_inventory_count_response"
 require_relative "square/types/get_inventory_physical_count_response"
-require_relative "square/types/get_inventory_transfer_response"
 require_relative "square/types/retrieve_job_response"
 require_relative "square/types/retrieve_location_booking_profile_response"
 require_relative "square/types/retrieve_location_custom_attribute_definition_response"
@@ -1310,6 +1321,8 @@
 require_relative "square/types/update_catalog_image_response"
 require_relative "square/types/update_customer_custom_attribute_definition_response"
 require_relative "square/types/update_customer_group_response"
+require_relative "square/types/update_inventory_adjustment_reason_response"
+require_relative "square/types/update_inventory_adjustment_response"
 require_relative "square/types/update_invoice_response"
 require_relative "square/types/update_item_modifier_lists_response"
 require_relative "square/types/update_item_taxes_response"
@@ -1382,6 +1395,7 @@
 require_relative "square/types/get_inventory_adjustment_request"
 require_relative "square/types/get_inventory_physical_count_request"
 require_relative "square/types/get_inventory_transfer_request"
+require_relative "square/types/get_inventory_transfer_response"
 require_relative "square/types/get_vendor_request"
 require_relative "square/types/get_payment_link_request"
 require_relative "square/types/get_gift_card_request"
@@ -1507,13 +1521,20 @@
 require_relative "square/gift_cards/types/unlink_customer_from_gift_card_request"
 require_relative "square/gift_cards/types/get_gift_cards_request"
 require_relative "square/inventory/client"
+require_relative "square/inventory/types/list_inventory_adjustment_reasons_request"
+require_relative "square/inventory/types/create_inventory_adjustment_reason_request"
+require_relative "square/inventory/types/delete_inventory_adjustment_reason_request"
+require_relative "square/inventory/types/restore_inventory_adjustment_reason_request"
+require_relative "square/inventory/types/retrieve_inventory_adjustment_reason_request"
+require_relative "square/inventory/types/update_inventory_adjustment_reason_request"
 require_relative "square/inventory/types/deprecated_get_adjustment_inventory_request"
+require_relative "square/inventory/types/update_inventory_adjustment_request"
 require_relative "square/inventory/types/get_adjustment_inventory_request"
 require_relative "square/inventory/types/deprecated_get_physical_count_inventory_request"
 require_relative "square/inventory/types/get_physical_count_inventory_request"
-require_relative "square/inventory/types/get_transfer_inventory_request"
 require_relative "square/inventory/types/get_inventory_request"
 require_relative "square/inventory/types/changes_inventory_request"
+require_relative "square/inventory/types/get_transfer_inventory_request"
 require_relative "square/invoices/client"
 require_relative "square/invoices/types/list_invoices_request"
 require_relative "square/invoices/types/create_invoice_request"

lib/square/catalog/client.rb

@@ -106,9 +106,15 @@ def batch_get(request_options: {}, **params)
       # request (items, variations, modifier lists, discounts, and taxes) is no more
       # than 10,000.
       #
+      # This endpoint uses full-replacement semantics. The client must send the complete object, and any
+      # field absent from the request is interpreted as an intentional clear. This logic applies to
+      # nested objects as well. For example, omitting inlined children like variations will delete them.
+      #
       # To ensure consistency, only one update request is processed at a time per seller account.
       # While one (batch or non-batch) update request is being processed, other (batched and non-batched)
-      # update requests are rejected with the `429` error code.
+      # update requests are rejected with the `429` error code. Prefer batching related changes into a
+      # single call rather than issuing many small writes, since each write acquires the lock separately
+      # and parallel writes to the same seller will contend with each other, producing `429` errors.
       #
       # @param request_options [Hash]
       # @param params [Square::Catalog::Types::BatchUpsertCatalogObjectsRequest]
@@ -181,6 +187,8 @@ def info(request_options: {}, **params)
       # The `types` parameter is specified as a comma-separated list of the
       # [CatalogObjectType](entity:CatalogObjectType) values,
       # for example, "`ITEM`, `ITEM_VARIATION`, `MODIFIER`, `MODIFIER_LIST`, `CATEGORY`, `DISCOUNT`, `TAX`, `IMAGE`".
+      # Always specify `types` explicitly. When upgrading to a newer API version, omitting `types` may
+      # cause new object types to appear in results that were not returned under the previous version.
       #
       # __Important:__ ListCatalog does not return deleted catalog items. To retrieve
       # deleted catalog items, use [SearchCatalogObjects](api-endpoint:Catalog-SearchCatalogObjects)
@@ -251,6 +259,11 @@ def list(request_options: {}, **params)
       # variations, whereas `SearchCatalogObjects` does.
       # - The both endpoints have different call conventions, including the query filter formats.
       #
+      # The `object_types` parameter is specified as a list of [CatalogObjectType](entity:CatalogObjectType) values.
+      # Always specify `object_types` explicitly. When upgrading to a newer API version, omitting
+      # `object_types` may cause new object types to appear in results that were not returned under
+      # the previous version.
+      #
       # @param request_options [Hash]
       # @param params [Square::Catalog::Types::SearchCatalogObjectsRequest]
       # @option request_options [String] :base_url

lib/square/catalog/object/client.rb

@@ -13,6 +13,10 @@ def initialize(client:)
 
         # Creates a new or updates the specified [CatalogObject](entity:CatalogObject).
         #
+        # This endpoint uses full-replacement semantics. The client must send the complete object, and any
+        # field absent from the request is interpreted as an intentional clear. This logic applies to
+        # nested objects as well. For example, omitting inlined children like variations will delete them.
+        #
         # To ensure consistency, only one update request is processed at a time per seller account.
         # While one (batch or non-batch) update request is being processed, other (batched and non-batched)
         # update requests are rejected with the `429` error code.

lib/square/client.rb

@@ -10,7 +10,7 @@ def initialize(base_url: nil, token: ENV.fetch("SQUARE_TOKEN", nil))
       @raw_client = Square::Internal::Http::RawClient.new(
         base_url: base_url || Square::Environment::PRODUCTION,
         headers: {
-          "User-Agent" => "square.rb/45.2.0-rc.0",
+          "User-Agent" => "square.rb/46.0.1.20260715",
           "X-Fern-Language" => "Ruby",
           Authorization: "Bearer #{token}"
         }

lib/square/inventory/types/create_inventory_adjustment_reason_request.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Square
+  module Inventory
+    module Types
+      class CreateInventoryAdjustmentReasonRequest < Internal::Types::Model
+        field :idempotency_key, -> { String }, optional: false, nullable: false
+        field :adjustment_reason, -> { Square::Types::InventoryAdjustmentReason }, optional: false, nullable: false
+      end
+    end
+  end
+end

lib/square/inventory/types/delete_inventory_adjustment_reason_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Square
+  module Inventory
+    module Types
+      class DeleteInventoryAdjustmentReasonRequest < Internal::Types::Model
+        field :reason_id, -> { Square::Types::InventoryAdjustmentReasonId }, optional: false, nullable: false
+      end
+    end
+  end
+end

lib/square/inventory/types/list_inventory_adjustment_reasons_request.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Square
+  module Inventory
+    module Types
+      class ListInventoryAdjustmentReasonsRequest < Internal::Types::Model
+        field :include_deleted, -> { Internal::Types::Boolean }, optional: true, nullable: false
+        field :include_system_codes, -> { Internal::Types::Boolean }, optional: true, nullable: false
+      end
+    end
+  end
+end

lib/square/inventory/types/restore_inventory_adjustment_reason_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Square
+  module Inventory
+    module Types
+      class RestoreInventoryAdjustmentReasonRequest < Internal::Types::Model
+        field :reason_id, -> { Square::Types::InventoryAdjustmentReasonId }, optional: false, nullable: false
+      end
+    end
+  end
+end

lib/square/inventory/types/retrieve_inventory_adjustment_reason_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Square
+  module Inventory
+    module Types
+      class RetrieveInventoryAdjustmentReasonRequest < Internal::Types::Model
+        field :reason_id, -> { Square::Types::InventoryAdjustmentReasonId }, optional: false, nullable: false
+      end
+    end
+  end
+end

lib/square/inventory/types/update_inventory_adjustment_reason_request.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Square
+  module Inventory
+    module Types
+      class UpdateInventoryAdjustmentReasonRequest < Internal::Types::Model
+        field :reason_id, -> { Square::Types::InventoryAdjustmentReasonId }, optional: false, nullable: false
+        field :adjustment_reason, -> { Square::Types::InventoryAdjustmentReason }, optional: false, nullable: false
+      end
+    end
+  end
+end

lib/square/inventory/types/update_inventory_adjustment_request.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Square
+  module Inventory
+    module Types
+      class UpdateInventoryAdjustmentRequest < Internal::Types::Model
+        field :idempotency_key, -> { String }, optional: false, nullable: false
+        field :adjustment, -> { Square::Types::InventoryAdjustment }, optional: false, nullable: false
+      end
+    end
+  end
+end

lib/square/types/batch_retrieve_inventory_changes_request.rb

@@ -11,6 +11,8 @@ class BatchRetrieveInventoryChangesRequest < Internal::Types::Model
       field :updated_before, -> { String }, optional: true, nullable: false
       field :cursor, -> { String }, optional: true, nullable: false
       field :limit, -> { Integer }, optional: true, nullable: false
+      field :sort, -> { Square::Types::BatchRetrieveInventoryChangesSort }, optional: true, nullable: false
+      field :reason_ids, -> { Internal::Types::Array[Square::Types::InventoryAdjustmentReasonId] }, optional: true, nullable: false
     end
   end
 end

lib/square/types/batch_retrieve_inventory_changes_sort.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    class BatchRetrieveInventoryChangesSort < Internal::Types::Model
+      field :field, -> { String }, optional: true, nullable: false
+      field :order, -> { Square::Types::SortOrder }, optional: true, nullable: false
+    end
+  end
+end

lib/square/types/batch_retrieve_inventory_changes_sort_field.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Square
+  module Types
+    module BatchRetrieveInventoryChangesSortField
+      # BatchRetrieveInventoryChangesSortField is an alias for Object
+
+      # @option str [String]
+      #
+      # @return [untyped]
+      def self.load(str)
+        ::JSON.parse(str)
+      end
+
+      # @option value [untyped]
+      #
+      # @return [String]
+      def self.dump(value)
+        ::JSON.generate(value)
+      end
+    end
+  end
+end

lib/square/types/catalog_item_variation.rb

@@ -42,6 +42,7 @@ class CatalogItemVariation < Internal::Types::Model
       field :team_member_ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
       field :stockable_conversion, -> { Square::Types::CatalogStockConversion }, optional: true, nullable: false
       field :kitchen_name, -> { String }, optional: true, nullable: false
+      field :vendor_information, -> { Internal::Types::Array[Square::Types::CatalogItemVariationVendorInformation] }, optional: true, nullable: false
     end
   end
 end