ecoportal-api-graphql 1.3.5 → 1.3.10

data/tests/loc_structures_get.rb

@@ -1,15 +1,15 @@
-require_relative 'local_libs'
-
-api = Ecoportal::API::GraphQL.new
-kargs = {
-  includeArchived: false,
-  includeUnpublished: false
-}
-trees = api.currentOrganization.locationStructures(**kargs)
-trees.each_with_index do |tree, idx|
-  puts "#{tree.weight}. '#{tree.name}' (#{tree.id})"
-end
-
-trees.each do |tree|
-  pp tree.treeify
-end
+require_relative 'local_libs'
+
+api = Ecoportal::API::GraphQL.new
+kargs = {
+  includeArchived:    false,
+  includeUnpublished: false
+}
+trees = api.currentOrganization.locationStructures(**kargs)
+trees.each_with_index do |tree, _idx|
+  puts "#{tree.weight}. '#{tree.name}' (#{tree.id})"
+end
+
+trees.each do |tree|
+  pp tree.treeify
+end

data/tests/validate_queries.rb

@@ -0,0 +1,105 @@
+require 'ecoportal/api-graphql'
+require 'json'
+require 'graphql'
+
+# Validate EVERY gem query against a GraphQL schema, offline — catches the whole class of
+# "field must have selections" (object field selected bare) and "selections can't be made on
+# scalars" (scalar over-selected) bugs before they reach a client runner.
+#
+# This is how the 2026-07-03 LocationStructure `updatedAt` prod failure (and a sibling
+# `createdAt` over-selection in the LocationDraft fragment) were found. Those queries had no
+# spec; this script would have flagged them.
+#
+# It renders each query's block offline (auth is stubbed — no network), assembles its fragments,
+# and validates the full document against a schema introspection JSON.
+#
+# Usage (run under bundler so the graphlient fork's #to_query_string is available):
+#   bundle exec ruby tests/validate_queries.rb [PATH_TO_SCHEMA_INTROSPECTION_JSON]
+#
+# Get a fresh schema JSON via an introspection query against the org's endpoint; the default
+# below points at the last captured dump. Prefer a fresh dump — a stale one yields false
+# "field doesn't exist" noise (harmless: this script only *fails* on the two structural classes).
+
+DEFAULT_SCHEMA = File.expand_path('../.ai-assistance/tmp/20260605T101224_live_ep_graphql_schema.graphql.json', __dir__)
+STRUCTURAL = ['must have selections', "can't be made on scalars"].freeze
+
+schema_path = ARGV[0] || DEFAULT_SCHEMA
+unless File.exist?(schema_path)
+  warn "Schema introspection JSON not found: #{schema_path}"
+  warn 'Pass a path: bundle exec ruby tests/validate_queries.rb <schema.json>'
+  exit 2
+end
+
+# Build a client offline — stub the session token so no network/creds are needed for rendering.
+Ecoportal::API::Common::GraphQL::Client.class_eval do
+  def session_token(*_args, **_kwargs)
+    'dummy'
+  end
+end
+client = Ecoportal::API::Common::GraphQL::Client.new(
+  email: 'validate@local', pass: 'x', org_id: 'validate', host: 'live.ecoportal.com', no_schema: true
+)
+schema = GraphQL::Schema.from_introspection(JSON.parse(File.read(schema_path)))
+
+# Collect every concrete query class (recursively, incl. nested like LocationStructure::Draft).
+query_classes = []
+collect = lambda do |mod|
+  mod.constants.each do |const|
+    obj = begin
+      mod.const_get(const)
+    rescue StandardError
+      next
+    end
+    next unless obj.is_a?(Module)
+
+    query_classes << obj if obj.is_a?(Class) && obj.private_method_defined?(:basic_block)
+    collect.call(obj)
+  end
+end
+collect.call(Ecoportal::API::GraphQL::Query)
+query_classes.uniq!
+
+structural_bugs = {}
+other_errors    = {}
+render_skips = []
+
+query_classes.sort_by(&:name).each do |klass|
+  inst = klass.new(client)
+  query_str = client.to_query_string(&inst.send(:basic_block))
+  fragments = begin
+    inst.send(:assemble_fragments, query_str)
+  rescue StandardError
+    ''
+  end
+  full = fragments.to_s.empty? ? query_str : "#{query_str}\n\n#{fragments}"
+  messages = schema.validate(full).map(&:message)
+  bugs  = messages.select { |m| STRUCTURAL.any? { |s| m.include?(s) } }
+  other = messages - bugs
+  structural_bugs[klass.name] = bugs  unless bugs.empty?
+  other_errors[klass.name]    = other unless other.empty?
+rescue StandardError => e
+  render_skips << "#{klass.name} — #{e.class}: #{e.message}"
+end
+
+puts "Validated #{query_classes.size} query classes against #{File.basename(schema_path)}\n\n"
+
+puts '## STRUCTURAL BUGS (fail the build — bare object / over-selected scalar):'
+if structural_bugs.empty?
+  puts '  none ✅'
+else
+  structural_bugs.each { |name, msgs| puts "  #{name}\n    - #{msgs.join("\n    - ")}" }
+end
+
+puts "\n## OTHER validation findings (verify — may be schema-dump staleness or union handling):"
+if other_errors.empty?
+  puts '  none'
+else
+  other_errors.each { |name, msgs| puts "  #{name}\n    - #{msgs.first(3).join("\n    - ")}" }
+end
+
+unless render_skips.empty?
+  puts "\n## RENDER-SKIPS (could not auto-render — check manually):"
+  render_skips.each { |s| puts "  #{s}" }
+end
+
+exit(structural_bugs.empty? ? 0 : 1)