ecoportal-api-graphql 1.3.16 → 2.2.0

data/lib/ecoportal/api/graphql/compat/search_results.rb

@@ -1,33 +1,33 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Compat
-        # Wraps a GraphQL connection object to expose the v2-compatible search
-        # result interface. eco-helpers scripts access:
-        #   search_results.total                  — filtered count
-        #   search_results.total_before_filtering — pre-filter count (approximated)
-        #   (also Enumerable for iteration)
-        class SearchResults
-          include Enumerable
-
-          attr_reader :total, :total_before_filtering
-
-          def initialize(connection)
-            @total                  = connection.totalCount
-            # GraphQL does not expose a pre-filter count — use the same value.
-            @total_before_filtering = connection.totalCount
-            @nodes                  = connection.nodes
-          end
-
-          def each(&block)
-            @nodes.each(&block)
-          end
-
-          def empty?
-            @nodes.empty?
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Compat
+        # Wraps a GraphQL connection object to expose the v2-compatible search
+        # result interface. eco-helpers scripts access:
+        #   search_results.total                  — filtered count
+        #   search_results.total_before_filtering — pre-filter count (approximated)
+        #   (also Enumerable for iteration)
+        class SearchResults
+          include Enumerable
+
+          attr_reader :total, :total_before_filtering
+
+          def initialize(connection)
+            @total                  = connection.totalCount
+            # GraphQL does not expose a pre-filter count — use the same value.
+            @total_before_filtering = connection.totalCount
+            @nodes                  = connection.nodes
+          end
+
+          def each(&block)
+            @nodes.each(&block)
+          end
+
+          def empty?
+            @nodes.empty?
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/compat.rb

@@ -1,17 +1,17 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Compat
-      end
-    end
-  end
-end
-
-require_relative 'compat/filter_translator'
-require_relative 'compat/stage_collection'
-require_relative 'compat/search_results'
-require_relative 'compat/page_reference'
-require_relative 'compat/response'
-require_relative 'compat/stage_view'
-require_relative 'compat/pages'
-require_relative 'compat/registers'
+module Ecoportal
+  module API
+    class GraphQL
+      module Compat
+      end
+    end
+  end
+end
+
+require_relative 'compat/filter_translator'
+require_relative 'compat/stage_collection'
+require_relative 'compat/search_results'
+require_relative 'compat/page_reference'
+require_relative 'compat/response'
+require_relative 'compat/stage_view'
+require_relative 'compat/pages'
+require_relative 'compat/registers'

data/lib/ecoportal/api/graphql/concerns/data_field_access.rb

@@ -1,71 +1,71 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Concerns
-        # Provides typed data field access on page models.
-        # Include in Interface::BasePage so all concrete page classes inherit it.
-        #
-        # Exposes:
-        #   page.components             — DataField::Collection (v2 compat alias for dataFields)
-        #   page.field_collection       — same, memoized
-        #   page.data_fields_updates    — [DataFieldInput, ...] for dirty fields
-        #   page.data_fields_additions  — [DataFieldInput, ...] for added fields
-        #   page.data_fields_deletions  — [field_id, ...] queued for deletion
-        module DataFieldAccess
-          # Returns a DataField::Collection wrapping raw dataFields from doc.
-          # Memoized — mutating a field object persists across calls.
-          def field_collection
-            @field_collection ||= Base::Page::DataField::Collection.from_doc(raw_data_fields)
-          end
-
-          # v2 compat alias — eco-helpers scripts call entry.components
-          def components
-            field_collection
-          end
-
-          # Returns a SectionCollection wrapping sections from doc.
-          # For BasicPage: doc['sections']. For PhasedPage: merged from stages (override in Phased).
-          def section_collection
-            @section_collection ||= Base::Page::SectionCollection.from_doc(raw_sections)
-          end
-
-          # v2 compat alias — eco-helpers scripts call entry.sections
-          def sections
-            section_collection
-          end
-
-          # Returns DataFieldInput hashes for modified existing fields (updates).
-          def data_fields_updates
-            field_collection.dirty_inputs
-          end
-
-          # Returns DataFieldInput hashes for newly added fields (via components.add).
-          def data_fields_additions
-            field_collection.dirty_additions
-          end
-
-          # Returns field IDs queued for deletion (via components.mark_for_deletion).
-          def data_fields_deletions
-            field_collection.dirty_deletions
-          end
-
-          def data_fields_dirty?
-            field_collection.dirty?
-          end
-
-          private
-
-          # Override in subclasses if fields live elsewhere (e.g. nested in stages).
-          def raw_data_fields
-            doc['dataFields'] || []
-          end
-
-          # Override in subclasses for different section sources.
-          def raw_sections
-            doc['sections'] || []
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Concerns
+        # Provides typed data field access on page models.
+        # Include in Interface::BasePage so all concrete page classes inherit it.
+        #
+        # Exposes:
+        #   page.components             — DataField::Collection (v2 compat alias for dataFields)
+        #   page.field_collection       — same, memoized
+        #   page.data_fields_updates    — [DataFieldInput, ...] for dirty fields
+        #   page.data_fields_additions  — [DataFieldInput, ...] for added fields
+        #   page.data_fields_deletions  — [field_id, ...] queued for deletion
+        module DataFieldAccess
+          # Returns a DataField::Collection wrapping raw dataFields from doc.
+          # Memoized — mutating a field object persists across calls.
+          def field_collection
+            @field_collection ||= Base::Page::DataField::Collection.from_doc(raw_data_fields)
+          end
+
+          # v2 compat alias — eco-helpers scripts call entry.components
+          def components
+            field_collection
+          end
+
+          # Returns a SectionCollection wrapping sections from doc.
+          # For BasicPage: doc['sections']. For PhasedPage: merged from stages (override in Phased).
+          def section_collection
+            @section_collection ||= Base::Page::SectionCollection.from_doc(raw_sections)
+          end
+
+          # v2 compat alias — eco-helpers scripts call entry.sections
+          def sections
+            section_collection
+          end
+
+          # Returns DataFieldInput hashes for modified existing fields (updates).
+          def data_fields_updates
+            field_collection.dirty_inputs
+          end
+
+          # Returns DataFieldInput hashes for newly added fields (via components.add).
+          def data_fields_additions
+            field_collection.dirty_additions
+          end
+
+          # Returns field IDs queued for deletion (via components.mark_for_deletion).
+          def data_fields_deletions
+            field_collection.dirty_deletions
+          end
+
+          def data_fields_dirty?
+            field_collection.dirty?
+          end
+
+          private
+
+          # Override in subclasses if fields live elsewhere (e.g. nested in stages).
+          def raw_data_fields
+            doc['dataFields'] || []
+          end
+
+          # Override in subclasses for different section sources.
+          def raw_sections
+            doc['sections'] || []
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/concerns/fragment_definitions.rb

@@ -1,68 +1,68 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Concerns
-        module FragmentDefinitions
-          class << self
-            private
-
-            def included(base)
-              super
-
-              base.send :include, Ecoportal::API::Common::GraphQL::ClassHelpers
-              base.extend ClassMethods
-              base.send :include, InstanceMethods
-            end
-          end
-
-          module ClassMethods
-            def fragment(sym, heredoc)
-              fragments[sym] = heredoc
-            end
-
-            def fragments
-              @fragments ||= {}
-            end
-
-            # Register a sub-namespace class whose fragments are visible via assemble.
-            def register_namespace(klass)
-              namespaces << klass
-            end
-
-            def namespaces
-              @namespaces ||= []
-            end
-
-            # Returns concatenated fragment definition strings for the given symbols.
-            # Searches own fragments and all registered sub-namespaces.
-            def assemble(*syms)
-              all = namespaces.reduce(fragments.dup) { |h, ns| h.merge(ns.fragments) }
-              syms.map { |sym| all[sym] }.compact.join("\n\n")
-            end
-          end
-
-          module InstanceMethods
-            attr_reader :client, :fragments
-
-            def initialize(client)
-              @client = client
-              parse
-            end
-
-            # Returns the raw fragment string for the given symbol.
-            # The namespace parameter is retained for API compatibility but has no effect.
-            def define(sym, heredoc, namespace: nil) # rubocop:disable Lint/UnusedMethodArgument
-              heredoc
-            end
-
-            private
-
-            def parse
-              @fragments = self.class.fragments.dup
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Concerns
+        module FragmentDefinitions
+          class << self
+            private
+
+            def included(base)
+              super
+
+              base.send :include, Ecoportal::API::Common::GraphQL::ClassHelpers
+              base.extend ClassMethods
+              base.send :include, InstanceMethods
+            end
+          end
+
+          module ClassMethods
+            def fragment(sym, heredoc)
+              fragments[sym] = heredoc
+            end
+
+            def fragments
+              @fragments ||= {}
+            end
+
+            # Register a sub-namespace class whose fragments are visible via assemble.
+            def register_namespace(klass)
+              namespaces << klass
+            end
+
+            def namespaces
+              @namespaces ||= []
+            end
+
+            # Returns concatenated fragment definition strings for the given symbols.
+            # Searches own fragments and all registered sub-namespaces.
+            def assemble(*syms)
+              all = namespaces.reduce(fragments.dup) { |h, ns| h.merge(ns.fragments) }
+              syms.map { |sym| all[sym] }.compact.join("\n\n")
+            end
+          end
+
+          module InstanceMethods
+            attr_reader :client, :fragments
+
+            def initialize(client)
+              @client = client
+              parse
+            end
+
+            # Returns the raw fragment string for the given symbol.
+            # The namespace parameter is retained for API compatibility but has no effect.
+            def define(sym, heredoc, namespace: nil) # rubocop:disable Lint/UnusedMethodArgument
+              heredoc
+            end
+
+            private
+
+            def parse
+              @fragments = self.class.fragments.dup
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/concerns/snake_camel_access.rb

@@ -1,60 +1,60 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Concerns
-        # Provides snake_case access to camelCase methods on GraphQL model objects.
-        # eco-helpers scripts (and v2 models) use snake_case, GraphQL uses camelCase.
-        #
-        # Converts any snake_case method call to its camelCase equivalent and delegates.
-        # Works for both readers (external_id → externalId) and writers (time_zone= → timeZone=).
-        #
-        # Examples:
-        #   page.external_id        → page.externalId
-        #   page.patch_ver          → page.patchVer
-        #   page.source_template_id → page.sourceTemplateId
-        #   page.other_tags = ['x'] → page.otherTags = ['x']
-        module SnakeCamelAccess
-          def method_missing(method_name, *args, &block)
-            str    = method_name.to_s
-            setter = str.end_with?('=')
-            base   = setter ? str[0..-2] : str
-            camel  = snake_to_camel(base)
-
-            # Only intercept if conversion actually changed something and target exists
-            if camel != base
-              target = setter ? :"#{camel}=" : camel.to_sym
-              return send(target, *args, &block) if respond_to?(target)
-            end
-
-            super
-          end
-
-          def respond_to_missing?(method_name, include_private = false)
-            str    = method_name.to_s
-            setter = str.end_with?('=')
-            base   = setter ? str[0..-2] : str
-            camel  = snake_to_camel(base)
-
-            if camel != base
-              target = setter ? :"#{camel}=" : camel.to_sym
-              return true if respond_to?(target, include_private)
-            end
-
-            super
-          end
-
-          private
-
-          # Convert snake_case to lowerCamelCase.
-          # external_id → externalId, source_template_id → sourceTemplateId
-          def snake_to_camel(snake_str)
-            parts = snake_str.split('_')
-            return snake_str if parts.length < 2
-
-            parts[0] + parts[1..].map(&:capitalize).join
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Concerns
+        # Provides snake_case access to camelCase methods on GraphQL model objects.
+        # eco-helpers scripts (and v2 models) use snake_case, GraphQL uses camelCase.
+        #
+        # Converts any snake_case method call to its camelCase equivalent and delegates.
+        # Works for both readers (external_id → externalId) and writers (time_zone= → timeZone=).
+        #
+        # Examples:
+        #   page.external_id        → page.externalId
+        #   page.patch_ver          → page.patchVer
+        #   page.source_template_id → page.sourceTemplateId
+        #   page.other_tags = ['x'] → page.otherTags = ['x']
+        module SnakeCamelAccess
+          def method_missing(method_name, *args, &block)
+            str    = method_name.to_s
+            setter = str.end_with?('=')
+            base   = setter ? str[0..-2] : str
+            camel  = snake_to_camel(base)
+
+            # Only intercept if conversion actually changed something and target exists
+            if camel != base
+              target = setter ? :"#{camel}=" : camel.to_sym
+              return send(target, *args, &block) if respond_to?(target)
+            end
+
+            super
+          end
+
+          def respond_to_missing?(method_name, include_private = false)
+            str    = method_name.to_s
+            setter = str.end_with?('=')
+            base   = setter ? str[0..-2] : str
+            camel  = snake_to_camel(base)
+
+            if camel != base
+              target = setter ? :"#{camel}=" : camel.to_sym
+              return true if respond_to?(target, include_private)
+            end
+
+            super
+          end
+
+          private
+
+          # Convert snake_case to lowerCamelCase.
+          # external_id → externalId, source_template_id → sourceTemplateId
+          def snake_to_camel(snake_str)
+            parts = snake_str.split('_')
+            return snake_str if parts.length < 2
+
+            parts[0] + parts[1..].map(&:capitalize).join
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/concerns/threadable.rb

@@ -0,0 +1,58 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Concerns
+        # Bounded-concurrency helpers for batch operations.
+        #
+        # Ported from `ecoportal-api-v2`'s `Common::Concerns::Threadable` rather than required
+        # from it: that gem is being decommissioned, and this is exactly the kind of small,
+        # stable primitive that should not create a new dependency on it.
+        #
+        # `new_thread` keeps at most `max` threads alive by joining the oldest before starting
+        # a new one — a deliberately simple back-pressure valve, not a pool. `max: 1` runs
+        # inline (no threads at all), which keeps single-file paths and specs deterministic.
+        module Threadable
+          private
+
+          # @param threads [Array<Thread>] the caller's thread accumulator (joined by the caller).
+          # @param max [Integer] maximum concurrent threads; `1` means run inline.
+          # @return [Array<Thread>, void]
+          def new_thread(threads, max: 20, &block)
+            if max <= 1
+              yield
+              return []
+            end
+
+            threads.shift.join if threads.count >= max
+            threads << Thread.new(&block)
+          end
+
+          # Named mutexes, created on demand. Use one key per shared resource so unrelated
+          # critical sections never serialise against each other.
+          def mutex(key = :general)
+            key           = key.to_sym
+            @mutex_map  ||= {}
+            # The map itself must be created atomically the first time.
+            @mutex_map[key] ||= Mutex.new
+          end
+
+          # Batch work must not be killed by one file raising in a thread, and must not spam
+          # the caller's stderr with per-thread reports — the caller gets the error in its
+          # result object instead. Restores both globals afterwards.
+          def with_preserved_thread_globals(abort: false, report: false)
+            mutex(:thread_globals).synchronize do
+              prev_abort  = Thread.abort_on_exception
+              prev_report = Thread.report_on_exception
+              Thread.abort_on_exception  = abort
+              Thread.report_on_exception = report
+              yield
+            ensure
+              Thread.abort_on_exception  = prev_abort
+              Thread.report_on_exception = prev_report
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/concerns.rb

@@ -12,3 +12,4 @@ require_relative 'concerns/fragment_definitions'
 require_relative 'concerns/snake_camel_access'
 require_relative 'concerns/page_compat'
 require_relative 'concerns/data_field_access'
+require_relative 'concerns/threadable'

data/lib/ecoportal/api/graphql/connection/action.rb

@@ -3,7 +3,7 @@ module Ecoportal
     class GraphQL
       module Connection
         class Action < Logic::Connection
-          class_resolver :node_class, Model::Action
+          nodes_of Model::Action
         end
       end
     end

data/lib/ecoportal/api/graphql/connection/action_category.rb

@@ -3,7 +3,7 @@ module Ecoportal
     class GraphQL
       module Connection
         class ActionCategory < Logic::Connection
-          class_resolver :node_class, Base::ActionCategory
+          nodes_of Base::ActionCategory
         end
       end
     end

data/lib/ecoportal/api/graphql/connection/activity.rb

@@ -0,0 +1,11 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class Activity < Logic::Connection
+          nodes_of Model::Activity
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection/activity_log.rb

@@ -0,0 +1,11 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class ActivityLog < Logic::Connection
+          nodes_of Model::ActivityLog
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection/auth_log.rb

@@ -0,0 +1,11 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class AuthLog < Logic::Connection
+          nodes_of Model::AuthLog
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection/contractor_entity.rb

@@ -3,7 +3,7 @@ module Ecoportal
     class GraphQL
       module Connection
         class ContractorEntity < Logic::Connection
-          class_resolver :node_class, Model::ContractorEntity
+          nodes_of Model::ContractorEntity
         end
       end
     end

data/lib/ecoportal/api/graphql/connection/minimal_dashboard.rb

@@ -0,0 +1,11 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class MinimalDashboard < Logic::Connection
+          nodes_of Model::MinimalDashboard
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection/page.rb

@@ -3,7 +3,7 @@ module Ecoportal
     class GraphQL
       module Connection
         class Page < Logic::Connection
-          class_resolver :node_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          nodes_of 'Ecoportal::API::GraphQL::Model::PageUnion'
         end
       end
     end

data/lib/ecoportal/api/graphql/connection/pages_workflow_command.rb

@@ -5,7 +5,7 @@ module Ecoportal
         class PagesWorkflowCommand < Logic::Connection
           SCHEMA_VERSION = '20260605'.freeze
 
-          class_resolver :node_class, 'Ecoportal::API::GraphQL::Base::PagesWorkflow::CommandInterface'
+          nodes_of 'Ecoportal::API::GraphQL::Base::PagesWorkflow::CommandInterface'
         end
       end
     end