e_plat 1.0.0.pre.rc.3 → 1.0.0.pre.rc.5

data/lib/e_plat/resource/base.rb

@@ -75,8 +75,11 @@ module EPlat
 			def cached_shopify_webhook?
 				self.to_s.include?("EPlat::ShopifyWebhook")
 			end
+
+			def element_name_plural?(word)
+				word&.downcase&.include? element_name.pluralize 
+			end
 				
-			
 			private
 				
 			def mapping_instance
@@ -219,9 +222,11 @@ module EPlat
 			def element_name
 				self.class.element_name
 			end
-			
-	end
 
+			def element_name_plural?(word)
+				self.class.element_name_plural?(word)
+			end
 
+	end
 end
 

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

@@ -136,6 +136,10 @@ module EPlat
 
             def remove_nodes_from(data)
                 return data unless data.is_a?(Hash) or data.is_a?(Array)
+
+                if data.is_a?(Hash) && data.keys.one? && self.element_name_plural?(data.keys.first) 
+                    data = data.values.first if data.values.first.is_a?(Array)
+                end
                 
                 if data.is_a?(Array)
                     return data.map { |item| remove_nodes_from(item) }
@@ -145,7 +149,7 @@ module EPlat
                     if value.is_a?(Hash) && value.key?('nodes')
                         remove_nodes_from(value['nodes'])
                     elsif value.is_a?(Array)
-                        value.map { |item| remove_nodes_from(item) } 
+                        value.map { |item| remove_nodes_from(item) }
                     else
                         remove_nodes_from(value) 
                     end
@@ -222,7 +226,13 @@ module EPlat
                     raise EPlat::GraphqlError.new(response["errors"].first["message"])
                 else
                     response = remove_mutation_root_from(response, graphql_proc_constant)
-                    load self.class.resources_parsed_from(response), true, true
+                    parsed_response = self.class.resources_parsed_from(response)
+
+                    if parsed_response.is_a?(Array)
+                        load parsed_response.first, true, true
+                    else
+                        load parsed_response, true, true
+                    end
                     
                     @persisted = true
                     changed_attributes.clear
@@ -233,16 +243,12 @@ module EPlat
         end
 
         def graphql_mutation_string(graphql_proc_constant, action)
-            mutation_proc      = eval graphql_proc_constant
+            mutation_proc = eval graphql_proc_constant
+            input = graphql_input.mutation_input(self, action)
+            
             additional_graphql = self.class.before_graphql_callbacks[action.to_sym]&.call(self)
-            input  = 
-                if action == :delete 
-                    self.is_a?(EPlat::Product::Variant) ? graphql_input.new(id: formatted_id) : graphql_input.new({id: formatted_id})
-                else
-                    graphql_input.new mapping.via_native_attributes_where_possible(self.class.remove_root_from as_json)
-                end
-                
-            mutation_proc.call(input.to_graphql_args, additional_graphql:) 
+
+            mutation_proc.call(input, additional_graphql:) 
         end
 
         def remove_mutation_root_from(data, graphql_proc_constant)

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

@@ -33,7 +33,8 @@ module EPlat
 
 				def instantiate_collection(collection, original_params = {}, prefix_options = {})
 					collection = collection["data"] if collection.is_a?(Hash) && collection["data"]
-					super
+					
+					super(collection, original_params, prefix_options)
 				end
 
 				def new(attributes={}, persisted = false)
@@ -42,11 +43,16 @@ module EPlat
 					else
 						initialize_singleton!
 
+						if self.element_name == "product"
+							(attributes["variants"] || []).each{ _1["product_id"] ||= attributes["id"] }
+						end
+
 						self.mapping = EPlat::Mapping.new_instance(specifc_mapping: specifc_mapping_name, resource: nil)
 
 						if attributes[mapping.native_top_key]
 							attributes = attributes.send(*top_key_method(mapping.native_top_key))
 						end
+
 						attributes = attributes.with_defaults(mapping.class::DEFAULT_VALUES)
 
 						super

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

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

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

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

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

@@ -0,0 +1,86 @@
+
+module EPlat::Shopify::GraphQL::V202501::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_01/mutation/product.rb

@@ -0,0 +1,55 @@
+
+module EPlat::Shopify::GraphQL::V202501::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_01/mutation.rb

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

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

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

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

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

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

@@ -4,9 +4,9 @@ class EPlat::Shopify::Product::Variant < EPlat::Product::Variant
         find_every:  "EPlat::Shopify::GraphQL::{API_VERSION}::Query.variants",
         find_single: "EPlat::Shopify::GraphQL::{API_VERSION}::Query.variant",
         find_one:	 "EPlat::Shopify::GraphQL::{API_VERSION}::Query.variants",
-        create:		 "EPlat::Shopify::GraphQL::{API_VERSION}::Mutation.product_variant_create",
-        update:	 	 "EPlat::Shopify::GraphQL::{API_VERSION}::Mutation.product_variant_update",
-        delete:		 "EPlat::Shopify::GraphQL::{API_VERSION}::Mutation.product_variant_delete"
+        create:		 "EPlat::Shopify::GraphQL::{API_VERSION}::Mutation.product_variants_bulk_create",
+        update:	 	 "EPlat::Shopify::GraphQL::{API_VERSION}::Mutation.product_variants_bulk_update",
+        delete:		 "EPlat::Shopify::GraphQL::{API_VERSION}::Mutation.product_variants_bulk_delete"
     }, unless: -> { EPlat.config.shopify_api_version == "2024_01" }
 
     def self.graphql_fields