e_plat 1.1.2 → 1.2.0

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

@@ -0,0 +1,87 @@
+class EPlat::Shopify::GraphQL::V202510::Input::Product::Variant < EPlat::Shopify::GraphQL::V202510::Input
+	USES_ELEMENT_NAME_AS_INPUT_ROOT_KEY = false
+
+	SUPPORTED_FIELDS = %w[
+		barcode
+		compareAtPrice
+		id
+		inventoryItem
+		inventoryPolicy
+		inventoryQuantities
+		mediaSrc
+		metafields
+		optionValues
+		price
+		taxable
+	].freeze
+
+	SUPPORTED_NAMED_ARGUMENT_FIELDS = {
+		product_id: %w[
+			productId
+		],
+		variant: %w[
+			barcode
+			compareAtPrice
+			id
+			inventoryItem
+			inventoryPolicy
+			inventoryQuantities
+			mediaSrc
+			metafields
+			optionValues
+			price
+			taxable
+		],
+		variants: %w[
+			barcode
+			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_2025_10/input/product/variants_bulk.rb

@@ -0,0 +1,58 @@
+class EPlat::Shopify::GraphQL::V202510::Input::Product::VariantsBulk < EPlat::Shopify::GraphQL::V202510::Input
+	USES_ELEMENT_NAME_AS_INPUT_ROOT_KEY = false
+
+	SUPPORTED_FIELDS = %w[
+		barcode
+		compareAtPrice
+		id
+		inventoryItem
+		inventoryPolicy
+		inventoryQuantities
+		mediaSrc
+		metafields
+		optionValues
+		price
+		taxable
+	].freeze    
+
+	SUPPORTED_NAMED_ARGUMENT_FIELDS = {
+		variants: %w[
+			barcode
+			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_2025_10/input/product.rb

@@ -0,0 +1,36 @@
+class EPlat::Shopify::GraphQL::V202510::Input::Product < EPlat::Shopify::GraphQL::V202510::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_2025_10/input.rb

@@ -0,0 +1,133 @@
+class EPlat::Shopify::GraphQL::V202510::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_2025_10/mutation/product/variant.rb

@@ -0,0 +1,86 @@
+
+module EPlat::Shopify::GraphQL::V202510::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}) {
+							product {
+								id
+							}
+						}
+					}
+				GRAPHQL
+			end
+		end
+
+		def self.product_variants_bulk_create_fragment
+			->(args, additional_graphql: nil) do
+				<<~GRAPHQL
+					#{additional_graphql}
+					productVariantsBulkCreate(#{args}) {
+						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}) {
+						productVariants {
+							#{EPlat::Shopify::Product::Variant.graphql_fields}
+						}
+					}
+				GRAPHQL
+			end
+		end
+		
+	end
+end

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

@@ -0,0 +1,55 @@
+
+module EPlat::Shopify::GraphQL::V202510::Mutation::Product
+    extend ActiveSupport::Concern
+	
+	included do
+
+		def self.product_create
+			->(args, additional_graphql: nil) do
+				<<~GRAPHQL
+					mutation {
+						#{additional_graphql}
+						productCreate(#{args}) {
+							product {
+								#{EPlat::Shopify::Product.graphql_fields}
+							}
+						}
+					}
+				GRAPHQL
+			end
+		end
+
+		def self.product_update
+			->(args, additional_graphql: nil) do
+				<<~GRAPHQL
+					mutation {
+						#{additional_graphql}
+						productUpdate(#{args}) {
+							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_2025_10/mutation.rb

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

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

@@ -0,0 +1,44 @@
+
+module EPlat::Shopify::GraphQL::V202510::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_2025_10/query/product.rb

@@ -0,0 +1,58 @@
+
+module EPlat::Shopify::GraphQL::V202510::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_2025_10/query.rb

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

data/lib/e_plat/resource/platform_specific/shopify/metafield.rb

@@ -1,4 +1,6 @@
 
 module EPlat::Shopify
-	class Metafield < EPlat::Metafield; end
+	class Metafield < EPlat::Metafield
+		READ_ONLY_ATTRIBUTES = [:created_at, :id, :updated_at, :date_created, :date_modified, :description]
+	end
 end

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

@@ -44,7 +44,6 @@ class EPlat::Shopify::Product::Variant < EPlat::Product::Variant
                 legacyResourceId
                 price
                 compareAtPrice
-                taxCode
             GRAPHQL
     end
 

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

@@ -25,7 +25,6 @@ module EPlat
 				string :weight_unit
 				integer :inventory_item_id
 				integer :inventory_quantity
-				string :tax_code
 				boolean :requires_shipping
 				string :admin_graphql_api_id
 				array :option_values

data/lib/e_plat/version.rb

@@ -1,3 +1,3 @@
 module EPlat
-  VERSION = "1.1.2"
+  VERSION = "1.2.0"
 end

data/lib/e_plat.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: e_plat
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.2.0
 platform: ruby
 authors:
 - oliwoodsuk
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-03 00:00:00.000000000 Z
+date: 2025-11-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -300,6 +300,18 @@ files:
 - lib/e_plat/mapping/shopify/v_2025_01/script_tag.rb
 - lib/e_plat/mapping/shopify/v_2025_01/shop.rb
 - lib/e_plat/mapping/shopify/v_2025_01/webhook.rb
+- lib/e_plat/mapping/shopify/v_2025_10/metafield.rb
+- lib/e_plat/mapping/shopify/v_2025_10/order.rb
+- lib/e_plat/mapping/shopify/v_2025_10/order/billing_address.rb
+- lib/e_plat/mapping/shopify/v_2025_10/order/shipping_address.rb
+- lib/e_plat/mapping/shopify/v_2025_10/product.rb
+- lib/e_plat/mapping/shopify/v_2025_10/product/image.rb
+- lib/e_plat/mapping/shopify/v_2025_10/product/option.rb
+- lib/e_plat/mapping/shopify/v_2025_10/product/variant.rb
+- lib/e_plat/mapping/shopify/v_2025_10/product/variant/option_value.rb
+- lib/e_plat/mapping/shopify/v_2025_10/script_tag.rb
+- lib/e_plat/mapping/shopify/v_2025_10/shop.rb
+- lib/e_plat/mapping/shopify/v_2025_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
@@ -375,6 +387,16 @@ files:
 - lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_01/query.rb
 - lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_01/query/product.rb
 - lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_01/query/product/variant.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_10/input.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_10/input/product.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_10/input/product/variant.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_10/input/product/variants_bulk.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_10/mutation.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_10/mutation/product.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_10/mutation/product/variant.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_10/query.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_10/query/product.rb
+- lib/e_plat/resource/platform_specific/shopify/graph_q_l/v_2025_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