e_plat 1.5.0 → 1.6.0

data/lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/input/product/variant.rb

@@ -0,0 +1,84 @@
+class EPlat::Shopify::GraphQL::V202610::Input::Product::Variant < EPlat::Shopify::GraphQL::V202610::Input
+	USES_ELEMENT_NAME_AS_INPUT_ROOT_KEY = false
+
+	SUPPORTED_FIELDS = %w[
+		compareAtPrice
+		id
+		inventoryItem
+		inventoryPolicy
+		inventoryQuantities
+		mediaSrc
+		metafields
+		optionValues
+		price
+		taxable
+	].freeze
+
+	SUPPORTED_NAMED_ARGUMENT_FIELDS = {
+		product_id: %w[
+			productId
+		],
+		variant: %w[
+			compareAtPrice
+			id
+			inventoryItem
+			inventoryPolicy
+			inventoryQuantities
+			mediaSrc
+			metafields
+			optionValues
+			price
+			taxable
+		],
+		variants: %w[
+			compareAtPrice
+			id
+			inventoryItem
+			inventoryPolicy
+			inventoryQuantities
+			mediaSrc
+			metafields
+			optionValues
+			price
+			taxable
+		],
+		inventory_item: %w[
+			cost
+			countryCodeOfOrigin
+			countryHarmonizedSystemCodes
+			harmonizedSystemCode
+			measurement
+			provinceCodeOfOrigin
+			requiresShipping
+			sku
+			tracked
+		],
+		option_values: %w[
+			optionId
+			name
+			linkedMetafieldValue
+			optionId
+			optionName
+		]
+	}.with_indifferent_access.freeze
+
+
+	def self.mutation_input(resource, action)
+		case action.to_sym
+		when :delete
+			new(
+				variantsIds: [resource.formatted_id],
+				product_id: EPlat::Product.formatted_id(resource.product_id)
+			)
+		else
+			new(
+				variants: [
+					resource.class.mapping.via_native_attributes_where_possible(
+						resource.class.remove_root_from(resource.as_json)
+					)
+				],
+				product_id: EPlat::Product.formatted_id(resource.product_id)
+			)
+		end.query_input
+	end
+end

data/lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/input/product/variants_bulk.rb

@@ -0,0 +1,56 @@
+class EPlat::Shopify::GraphQL::V202610::Input::Product::VariantsBulk < EPlat::Shopify::GraphQL::V202610::Input
+	USES_ELEMENT_NAME_AS_INPUT_ROOT_KEY = false
+
+	SUPPORTED_FIELDS = %w[
+		compareAtPrice
+		id
+		inventoryItem
+		inventoryPolicy
+		inventoryQuantities
+		mediaSrc
+		metafields
+		optionValues
+		price
+		taxable
+	].freeze    
+
+	SUPPORTED_NAMED_ARGUMENT_FIELDS = {
+		variants: %w[
+			compareAtPrice
+			id
+			inventoryItem
+			inventoryPolicy
+			inventoryQuantities
+			mediaSrc
+			metafields
+			optionValues
+			price
+			taxable
+		],
+		inventory_item: %w[
+			cost
+			countryCodeOfOrigin
+			countryHarmonizedSystemCodes
+			harmonizedSystemCode
+			measurement
+			provinceCodeOfOrigin
+			requiresShipping
+			sku
+			tracked
+		],
+		option_values: %w[
+			name
+			optionId
+			linkedMetafieldValue
+			optionId
+			optionName
+		]
+	}.with_indifferent_access.freeze
+
+	def self.mutation_input(product, action)
+		new(
+			product_id: EPlat::Product.formatted_id(product.id),
+			variants: product.as_json["product"]["variants"]
+		).query_input
+	end
+end

data/lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/input/product.rb

@@ -0,0 +1,36 @@
+class EPlat::Shopify::GraphQL::V202610::Input::Product < EPlat::Shopify::GraphQL::V202610::Input
+
+	SUPPORTED_FIELDS = %w[
+		category
+		claimOwnership
+		title
+		descriptionHtml
+		productType
+		vendor
+		tags
+		collectionsToJoin
+		collectionsToLeave
+		combinedListingRole
+		metafields
+		productOptions
+		templateSuffix
+		requiresSellingPlan
+		giftCard
+		giftCardTemplateSuffix
+		seo
+		status
+		id
+		handle
+		redirectNewHandle
+	].freeze    
+
+	def self.mutation_input(resource, action)
+		case action.to_sym
+		when :delete
+			new(input: {id: resource.formatted_id})
+		else
+			rootless_json = resource.class.remove_root_from(resource.as_json)
+			new(resource.class.mapping.via_native_attributes_where_possible rootless_json)
+		end.query_input
+	end
+end

data/lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/input.rb

@@ -0,0 +1,133 @@
+class EPlat::Shopify::GraphQL::V202610::Input
+    attr_accessor :input, :named_arguments
+
+    SUPPORTED_FIELDS = []
+    SUPPORTED_NAMED_ARGUMENT_FIELDS = {}
+    USES_ELEMENT_NAME_AS_INPUT_ROOT_KEY = true
+
+    def initialize(input = {}, **named_arguments)
+        @input = input.deep_transform_keys { |key| key.to_s.camelize(:lower) }
+        @named_arguments = named_arguments.deep_transform_keys { |key| key.to_s.camelize(:lower) }
+    end
+
+    def query_input
+        args = 
+            if named_arguments.present? 
+                named_arguments_with_allowed_fields(named_arguments) 
+            else
+                self.class::USES_ELEMENT_NAME_AS_INPUT_ROOT_KEY ? { element_name => allowed_fields } : allowed_fields
+            end
+
+        format_graphql_args(args)
+    end
+
+    def self.mutation_input(resource, action)
+        raise "mutation_input not implemented for #{self.class.name}"
+        # example:
+        # case action.to_sym
+        # when :delete
+        #     new(input: { id: resource.formatted_id })
+        # else
+        #     new(resource.class.mapping.via_native_attributes_where_possible(
+        #         resource.class.remove_root_from(resource.as_json)
+        #     ))
+        # end.query_input
+    end
+
+
+    protected
+
+    def allowed_fields
+        fields_hash = input.slice(*self.class::SUPPORTED_FIELDS)
+
+        fields_hash.map do |key, value|
+            if value.is_a?(Hash) && child_allowed_fields = self.class::SUPPORTED_NAMED_ARGUMENT_FIELDS[key] || self.class::SUPPORTED_NAMED_ARGUMENT_FIELDS[key&.underscore]
+                [key, value.slice(*child_allowed_fields)]
+            else
+                [key, value]
+            end
+        end.to_h
+    end
+
+    def named_arguments_with_allowed_fields(arguments, name=nil)
+        arguments.map do |key, value|
+            fields_hash = self.class::SUPPORTED_NAMED_ARGUMENT_FIELDS[name] || self.class::SUPPORTED_NAMED_ARGUMENT_FIELDS[key] || self.class::SUPPORTED_NAMED_ARGUMENT_FIELDS[key&.underscore] || []
+
+            case value
+            when Hash
+                [key, named_arguments_with_allowed_fields(value, key.underscore)]
+            when Array
+                [key, value.map {_1.is_a?(Hash) ? named_arguments_with_allowed_fields(_1, key.underscore) : _1}]
+            else
+                (fields_hash.empty? || fields_hash.include?(key)) ? [key, value] : [nil, nil]
+            end
+        end.to_h.compact_blank
+    end
+    
+    def format_graphql_item(item, key: nil)
+        case item
+        when Hash
+          "{ #{item.map { |k, v| "#{k}: #{v.is_a?(String) ? enum_friendly(v, key: k) : format_graphql_item(v, key: k)}" }.join(', ')} }"
+        when Array
+          "[ #{item.map { |i| format_graphql_item(i, key: key) }.join(', ')} ]"
+        else
+          enum_friendly(item, key: key)
+        end
+    end
+
+    def enum_friendly(value, key: nil)
+        case
+        when key == "tags"
+            "\"#{single_quotes_only(value)}\""
+        when value.is_a?(String)
+            if value.match?(/\A[A-Z_]+\z/)
+                value
+            else
+                "\"#{single_quotes_only(value)}\""
+            end
+        else
+            value
+        end
+    end
+
+    def single_quotes_only(value)
+        value&.gsub("\"", "'")
+    end
+
+    def format_graphql_args(args, key: nil)
+        args.map do |key, value|
+            case value
+            when Hash
+                "#{key}: { #{format_graphql_args(value, key:)} }"
+            when Array
+                if (value.first.is_a? Hash)
+                    "#{key}: [ #{value.map { |v| "{ #{format_graphql_args(v, key:)} }" }.join(', ')} ]"
+                else
+                    "#{key}: [ #{value.map { |v| enum_friendly(v, key: key) }.join(', ')} ]"
+                end
+			when String
+				"#{key}: #{enum_friendly(value, key: key)}"
+            else
+                "#{key}: #{value}"
+            end
+        end.join(', ')
+    end
+
+    def element_name
+        self.class.name.split("::").last.downcase
+    end
+
+end
+# 
+# creates a graphql mutation input.
+# if just input as arg, use:
+# input.new(
+# 	[{...}, {...}]
+# ).to_graphql_args
+# 
+# Otherwise, you can pass named arguments in for each graphql argument:
+# input.new(
+# 	product_id: "gid/123", 
+# 	variants: 	[{...}, {...}]
+# ).to_graphql_args
+# 

data/lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/mutation/product/variant.rb

@@ -0,0 +1,98 @@
+
+module EPlat::Shopify::GraphQL::V202610::Mutation::Product::Variant
+    extend ActiveSupport::Concern
+	
+	included do
+
+		# def self.product_variant_delete
+		# 	->(args, additional_graphql: nil) do
+		# 		<<~GRAPHQL
+		# 			mutation {
+		# 				#{additional_graphql}
+		# 				productVariantDelete(#{args}) {
+		# 					deletedProductVariantId
+		# 					userErrors {
+		# 						field
+		# 						message
+		# 					}
+		# 				}
+		# 			}
+		# 		GRAPHQL
+		# 	end
+		# end
+		
+		def self.product_variants_bulk_update
+			->(args, additional_graphql: nil) do
+				<<~GRAPHQL
+					mutation {
+						#{product_variants_bulk_update_fragment.call(args, additional_graphql: additional_graphql)}
+					}
+				GRAPHQL
+			end
+		end
+
+		def self.product_variants_bulk_create
+			->(args, additional_graphql: nil) do
+				<<~GRAPHQL
+					mutation {
+						#{product_variants_bulk_create_fragment.call(args, additional_graphql: additional_graphql)}
+					}
+				GRAPHQL
+			end
+		end
+
+		def self.product_variants_bulk_delete
+			->(args, additional_graphql: nil) do
+				<<~GRAPHQL
+					mutation {
+						#{additional_graphql}
+						productVariantsBulkDelete(#{args}) {
+							userErrors {
+								field
+								message
+							}
+							product {
+								id
+							}
+						}
+					}
+				GRAPHQL
+			end
+		end
+
+		def self.product_variants_bulk_create_fragment
+			->(args, additional_graphql: nil) do
+				<<~GRAPHQL
+					#{additional_graphql}
+					productVariantsBulkCreate(#{args}) {
+						userErrors {
+							field
+							message
+						}
+						productVariants {
+							#{EPlat::Shopify::Product::Variant.graphql_fields}
+						}
+					}
+				GRAPHQL
+			end
+		end
+
+		def self.product_variants_bulk_update_fragment
+			->(args, additional_graphql: nil) do
+				<<~GRAPHQL
+					#{additional_graphql}
+					productVariantsBulkUpdate(#{args}) {
+						userErrors {
+							field
+							message
+						}
+						productVariants {
+							#{EPlat::Shopify::Product::Variant.graphql_fields}
+						}
+					}
+				GRAPHQL
+			end
+		end
+		
+	end
+end

data/lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/mutation/product.rb

@@ -0,0 +1,63 @@
+
+module EPlat::Shopify::GraphQL::V202610::Mutation::Product
+    extend ActiveSupport::Concern
+	
+	included do
+
+		def self.product_create
+			->(args, additional_graphql: nil) do
+				<<~GRAPHQL
+					mutation {
+						#{additional_graphql}
+						productCreate(#{args}) {
+							userErrors {
+								field
+								message
+							}
+							product {
+								#{EPlat::Shopify::Product.graphql_fields}
+							}
+						}
+					}
+				GRAPHQL
+			end
+		end
+
+		def self.product_update
+			->(args, additional_graphql: nil) do
+				<<~GRAPHQL
+					mutation {
+						#{additional_graphql}
+						productUpdate(#{args}) {
+							userErrors {
+								field
+								message
+							}
+							product {
+								#{EPlat::Shopify::Product.graphql_fields}
+							}
+						}
+					}
+				GRAPHQL
+			end
+		end
+
+		def self.product_delete
+			->(args, additional_graphql: nil) do
+				<<~GRAPHQL
+					mutation {
+						#{additional_graphql}
+						productDelete(#{args}) {
+							deletedProductId
+							userErrors {
+								field
+								message
+							}
+						}
+					}
+				GRAPHQL
+			end
+		end
+
+	end
+end

data/lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/mutation.rb

@@ -0,0 +1,5 @@
+class EPlat::Shopify::GraphQL::V202610::Mutation
+    include Product, Product::Variant
+end
+
+

data/lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/query/product/variant.rb

@@ -0,0 +1,44 @@
+
+module EPlat::Shopify::GraphQL::V202610::Query::Product::Variant
+    extend ActiveSupport::Concern
+	
+	included do
+
+		def self.variants
+			->(args) do
+				formatted_args = args.present? ? "(#{args})" : ""
+
+				<<~GRAPHQL
+					query getProductVariants {
+						productVariants#{formatted_args} {
+							nodes {
+								#{EPlat::Shopify::Product::Variant.graphql_fields}
+							}
+							pageInfo {
+								endCursor
+								startCursor
+								hasNextPage
+								hasPreviousPage
+							}
+						}
+					}
+				GRAPHQL
+			end
+		end
+
+		def self.variant
+			->(args) do
+				formatted_args = args.present? ? "(#{args})" : ""
+
+				<<~GRAPHQL
+					query getProductVariant {
+						productVariant#{formatted_args} {
+							#{EPlat::Shopify::Product::Variant.graphql_fields}
+						}
+					}
+				GRAPHQL
+			end
+		end
+		
+	end
+end

data/lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/query/product.rb

@@ -0,0 +1,58 @@
+
+module EPlat::Shopify::GraphQL::V202610::Query::Product
+    extend ActiveSupport::Concern
+	
+	included do
+
+		def self.products
+			->(args) do
+				formatted_args = args.present? ? "(#{args})" : ""
+
+				<<~GRAPHQL
+					query getProducts {
+						products#{formatted_args} {
+							nodes {
+								#{EPlat::Shopify::Product.graphql_fields}
+							}
+							pageInfo {
+								endCursor
+								startCursor
+								hasNextPage
+								hasPreviousPage
+							}
+						}
+					}
+				GRAPHQL
+			end
+		end
+
+		def self.product
+			->(args) do
+				formatted_args = args.present? ? "(#{args})" : ""
+
+				<<~GRAPHQL
+					query getProduct {
+						product#{formatted_args} {
+							#{EPlat::Shopify::Product.graphql_fields}
+						}
+					}
+				GRAPHQL
+			end
+		end
+
+		def self.products_count
+			->(args) do
+				formatted_args = args.present? ? "(#{args})" : ""
+
+				<<~GRAPHQL
+					query productsCount {
+						productsCount#{formatted_args} {
+							count
+						}
+					}
+				GRAPHQL
+			end
+		end
+
+	end
+end

data/lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/query.rb

@@ -0,0 +1,5 @@
+class EPlat::Shopify::GraphQL::V202610::Query
+    include Product, Product::Variant
+end
+
+

data/lib/e_plat/resource/platform_specific/shopify/product/variant.rb

@@ -25,7 +25,7 @@ class EPlat::Shopify::Product::Variant < EPlat::Product::Variant
                 createdAt
                 updatedAt
                 taxable
-                barcode
+                #{ "barcode" if barcode_field_supported? }
                 image {
                     #{ EPlat::Shopify::Product::Image.graphql_fields }
                 }
@@ -47,6 +47,11 @@ class EPlat::Shopify::Product::Variant < EPlat::Product::Variant
             GRAPHQL
     end
 
+    # Shopify deprecated the single barcode field in 2026-10 in favour of the barcodes connection
+    def self.barcode_field_supported?
+        EPlat.config.shopify_api_version < "2026_10"
+    end
+
     def graphql_input
         "EPlat::Shopify::GraphQL::#{EPlat.shopify_graphql_version}::Input::Product::Variant".constantize
     end

data/lib/e_plat/version.rb

@@ -1,3 +1,3 @@
 module EPlat
-  VERSION = "1.5.0"
+  VERSION = "1.6.0"
 end

data/lib/e_plat.rb

@@ -22,7 +22,7 @@ loader.setup
 
 module EPlat
   extend Dry::Configurable
-  SUPPORTED_SHOPIFY_API_VERSIONS = %w[2024_01 2024_07 2025_01 2025_10 2026_04].freeze
+  SUPPORTED_SHOPIFY_API_VERSIONS = %w[2024_01 2024_07 2025_01 2025_10 2026_04 2026_10].freeze
   SUPPORTED_BIGCOMMERCE_API_VERSIONS = ['3'].freeze
   SUPPORTED_WOOCOMMERCE_API_VERSIONS = ['3'].freeze
   SUPPORTED_PLATFORMS = %w[shopify bigcommerce woocommerce].freeze
@@ -43,7 +43,7 @@ module EPlat
   ].freeze
   PROTECTED_PREFIX = '_protected_'
 
-  setting(:shopify_api_version, default: ENV['EPLAT_SHOPIFY_API_VERSION'] || '2026_04', constructor: lambda do |value|
+  setting(:shopify_api_version, default: ENV['EPLAT_SHOPIFY_API_VERSION'] || '2026_10', constructor: lambda do |value|
     SUPPORTED_SHOPIFY_API_VERSIONS.include?(value.underscore) ? value.underscore : raise(ArgumentError, "Shopify API version #{value} is not supported")
   end)
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: e_plat
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - oliwoodsuk
@@ -322,6 +322,18 @@ files:
 - lib/e_plat/mapping/shopify/v_2026_04/script_tag.rb
 - lib/e_plat/mapping/shopify/v_2026_04/shop.rb
 - lib/e_plat/mapping/shopify/v_2026_04/webhook.rb
+- lib/e_plat/mapping/shopify/v_2026_10/metafield.rb
+- lib/e_plat/mapping/shopify/v_2026_10/order.rb
+- lib/e_plat/mapping/shopify/v_2026_10/order/billing_address.rb
+- lib/e_plat/mapping/shopify/v_2026_10/order/shipping_address.rb
+- lib/e_plat/mapping/shopify/v_2026_10/product.rb
+- lib/e_plat/mapping/shopify/v_2026_10/product/image.rb
+- lib/e_plat/mapping/shopify/v_2026_10/product/option.rb
+- lib/e_plat/mapping/shopify/v_2026_10/product/variant.rb
+- lib/e_plat/mapping/shopify/v_2026_10/product/variant/option_value.rb
+- lib/e_plat/mapping/shopify/v_2026_10/script_tag.rb
+- lib/e_plat/mapping/shopify/v_2026_10/shop.rb
+- lib/e_plat/mapping/shopify/v_2026_10/webhook.rb
 - lib/e_plat/mapping/virtual_collection/base.rb
 - lib/e_plat/mapping/virtual_collection/bigcommerce/order_line_items.rb
 - lib/e_plat/mapping/virtual_collection/shopify/product/variant/option_value.rb
@@ -417,6 +429,16 @@ files:
 - lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_04/query.rb
 - lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_04/query/product.rb
 - lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_04/query/product/variant.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/input.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/input/product.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/input/product/variant.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/input/product/variants_bulk.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/mutation.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/mutation/product.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/mutation/product/variant.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/query.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/query/product.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2026_10/query/product/variant.rb
 - lib/e_plat/resource/platform_specific/shopify/metafield.rb
 - lib/e_plat/resource/platform_specific/shopify/order.rb
 - lib/e_plat/resource/platform_specific/shopify/order/Consignment.rb