e_plat 1.2.0 → 1.4.0

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

@@ -60,11 +60,15 @@ module EPlat
                 else
                     case action
                     when :find_one, :find_single
+                        raise_resource_not_found! if resource_missing_from?(response)
+
                         instantiate_record     resources_parsed_from(response)
                     else
                         instantiate_collection resources_parsed_from(response)
                     end
                 end
+            rescue ActiveResource::ResourceNotFound
+                raise
             rescue StandardError => e
                 raise EPlat::GraphqlError.new(e.message)
             end
@@ -79,6 +83,17 @@ module EPlat
                 ).body
             end
 
+            # a 200 with a null resource is Shopify graphql's version of a 404
+            def resource_missing_from?(response)
+                data = response["data"].is_a?(Hash) ? response["data"] : response
+
+                data.key?(graphql_element_name) && data[graphql_element_name].nil?
+            end
+
+            def raise_resource_not_found!
+                raise ActiveResource::ResourceNotFound.new(nil, "#{name} not found")
+            end
+
             #utils
 
             def scope_with_options_hash(args, action)

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

@@ -0,0 +1,87 @@
+class EPlat::Shopify::GraphQL::V202604::Input::Product::Variant < EPlat::Shopify::GraphQL::V202604::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_2026_04/input/product/variants_bulk.rb

@@ -0,0 +1,58 @@
+class EPlat::Shopify::GraphQL::V202604::Input::Product::VariantsBulk < EPlat::Shopify::GraphQL::V202604::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_2026_04/input/product.rb

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

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

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

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

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

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

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

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

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

data/lib/e_plat/version.rb

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