e_plat 1.4.0 → 1.6.0

data/lib/e_plat/resource/collection.rb

@@ -8,6 +8,7 @@ module EPlat
 			EPlat::Shopify::Product
 			EPlat::Shopify::Product::Variant
 		)
+		GRAPHQL_PAGING_PARAMS = %w(after before first last limit).freeze
 
 		def initialize(parsed = [])
 			super parsed
@@ -56,8 +57,8 @@ module EPlat
 			url = "#{ resource_class.collection_path }#{ url }" if client.bigcommerce?
 
 			if paginates_via_graphql?
-				arg_name = (url == @next) ? "after" : "before"
-				resource_class.find(:all, params: {arg_name => url, first: 100})
+				cursor_param = (url == @next) ? "after" : "before"
+				resource_class.find(:all, params: params_for_another_graphql_page(cursor_param, url))
 			elsif client.woocommerce?
 				page_number = extract_page_from_url(url)
 				resource_class.find(:all, params: {page: page_number})
@@ -66,6 +67,12 @@ module EPlat
 			end
 		end
 
+		def params_for_another_graphql_page(cursor_param, cursor)
+			filter_params = (original_params || {}).to_h.reject { |key, _value| GRAPHQL_PAGING_PARAMS.include?(key.to_s) }
+
+			filter_params.merge(cursor_param => cursor, first: 100)
+		end
+
 		def pagination_links
 			return pagination_cursors if paginates_via_graphql?
 

data/lib/e_plat/resource/concerns/graph_q_lable.rb

@@ -10,6 +10,7 @@ module EPlat
 
         FILTER_ARGS    = [:id, :after, :before, :last, :first, :sort_key, :reverse].freeze
         QUERY_ARG_ARGS = [:available_for_sale, :created_at, :product_type, :product_id, :tag, :tag_not, :title, :updated_at, :vendor].freeze
+        UserErrorsResponse = Struct.new(:body)
 
         class_methods do
 
@@ -64,7 +65,7 @@ module EPlat
 
                         instantiate_record     resources_parsed_from(response)
                     else
-                        instantiate_collection resources_parsed_from(response)
+                        instantiate_collection resources_parsed_from(response), args
                     end
                 end
             rescue ActiveResource::ResourceNotFound
@@ -229,6 +230,13 @@ module EPlat
             
         end
 
+        def save!
+            return true if save
+
+            invalid_response = UserErrorsResponse.new({message: errors.full_messages.join(", ")}.to_json)
+            raise ActiveResource::ResourceInvalid.new(invalid_response)
+        end
+
         def mutate_graphql(action, graphql_proc_constant, *args)
             callback_name = (action == :delete) ? :destroy : action
 
@@ -239,6 +247,9 @@ module EPlat
                     raise EPlat::GraphqlError.new(response.first["message"])
                 elsif response["errors"]
                     raise EPlat::GraphqlError.new(response["errors"].first["message"])
+                elsif (user_errors_by_mutation = user_errors_by_mutation_from(response)).any?
+                    log_user_errors(user_errors_by_mutation)
+                    raise_resource_invalid_with(user_errors_by_mutation.values.flatten)
                 else
                     response = remove_mutation_root_from(response, graphql_proc_constant)
                     parsed_response = self.class.resources_parsed_from(response)
@@ -253,6 +264,8 @@ module EPlat
                     changed_attributes.clear
                 end
             end
+        rescue ActiveResource::ResourceInvalid
+            raise
         rescue StandardError => e
             raise EPlat::GraphqlError.new(e.message)
         end
@@ -266,6 +279,46 @@ module EPlat
             mutation_proc.call(input, additional_graphql:) 
         end
 
+        # one request can carry several mutation roots, e.g. productUpdate plus productVariantsBulkUpdate
+        def user_errors_by_mutation_from(response)
+            data = response["data"].is_a?(Hash) ? response["data"] : response
+            mutation_payloads = data.select { |_mutation_name, payload| payload.is_a?(Hash) }
+
+            mutation_payloads
+                .transform_values { |payload| payload["userErrors"] || [] }
+                .reject { |_mutation_name, user_errors| user_errors.empty? }
+        end
+
+        def log_user_errors(user_errors_by_mutation)
+            user_errors_by_mutation.each do |mutation_name, user_errors|
+                user_errors_logger&.warn(
+                    "[EPlat] #{mutation_name} userErrors on #{self.class.name} #{id.inspect}: #{user_errors_message(user_errors)}"
+                )
+            end
+        end
+
+        def user_errors_logger
+            defined?(Rails) && Rails.logger ? Rails.logger : self.class.logger
+        end
+
+        def user_errors_message(user_errors)
+            user_errors.map do |user_error|
+                field = Array(user_error["field"]).join(".")
+
+                [field.presence, user_error["message"]].compact.join(": ")
+            end.join(", ")
+        end
+
+        # ActiveResource's save rescues ResourceInvalid into errors and returns false; save! re-raises it
+        def raise_resource_invalid_with(user_errors)
+            error_messages = user_errors.map { |user_error| user_error["message"] }
+            invalid_response = UserErrorsResponse.new(
+                {errors: {base: error_messages}, message: error_messages.join(", ")}.to_json
+            )
+
+            raise ActiveResource::ResourceInvalid.new(invalid_response)
+        end
+
         def remove_mutation_root_from(data, graphql_proc_constant)
             mutation_root = graphql_proc_constant.split(".").last.camelcase(:lower)
             (mutation_root && data[mutation_root]) ? data[mutation_root] : data

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

@@ -47,6 +47,10 @@ module EPlat::Shopify::GraphQL::V202604::Mutation::Product::Variant
 					mutation {
 						#{additional_graphql}
 						productVariantsBulkDelete(#{args}) {
+							userErrors {
+								field
+								message
+							}
 							product {
 								id
 							}
@@ -61,6 +65,10 @@ module EPlat::Shopify::GraphQL::V202604::Mutation::Product::Variant
 				<<~GRAPHQL
 					#{additional_graphql}
 					productVariantsBulkCreate(#{args}) {
+						userErrors {
+							field
+							message
+						}
 						productVariants {
 							#{EPlat::Shopify::Product::Variant.graphql_fields}
 						}
@@ -74,6 +82,10 @@ module EPlat::Shopify::GraphQL::V202604::Mutation::Product::Variant
 				<<~GRAPHQL
 					#{additional_graphql}
 					productVariantsBulkUpdate(#{args}) {
+						userErrors {
+							field
+							message
+						}
 						productVariants {
 							#{EPlat::Shopify::Product::Variant.graphql_fields}
 						}

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

@@ -10,6 +10,10 @@ module EPlat::Shopify::GraphQL::V202604::Mutation::Product
 					mutation {
 						#{additional_graphql}
 						productCreate(#{args}) {
+							userErrors {
+								field
+								message
+							}
 							product {
 								#{EPlat::Shopify::Product.graphql_fields}
 							}
@@ -25,6 +29,10 @@ module EPlat::Shopify::GraphQL::V202604::Mutation::Product
 					mutation {
 						#{additional_graphql}
 						productUpdate(#{args}) {
+							userErrors {
+								field
+								message
+							}
 							product {
 								#{EPlat::Shopify::Product.graphql_fields}
 							}

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