ecoportal-api-graphql 1.3.5 → 1.3.17

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

@@ -0,0 +1,76 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Compat
+        # Client-side stage-specific view over a full page.
+        # Returned by Compat::Pages#get when stage_id is provided.
+        #
+        # Mimics the v2 behaviour where pages.get(id, stage_id:) returns a page
+        # object showing only the specified stage's sections and components.
+        # All other page accessors (id, name, state, patchVer, as_update, etc.)
+        # delegate to the underlying full page.
+        #
+        # This allows eco-helpers stage iteration patterns to work unchanged:
+        #   stage_view = graphql.pages.get(page_id, stage_id: stg.id)
+        #   stage_view.sections.doc.each { |sec_doc| ... }
+        #   stage_view.components.doc.each { |comp_doc| ... }
+        class StageView
+          def initialize(page, stage_id)
+            @page     = page
+            @stage_id = stage_id
+            @stage    = find_stage(page, stage_id)
+            # Record the targeted stage on the underlying page. The base OozeSamples loop
+            # enqueues and updates the FULL page (first-wins by id — the StageView is never
+            # the queued object), so a later submit!/sign_off! on that page must still know
+            # which stage was viewed. Pin the RESOLVED stage id (@stage&.id) so a name-based
+            # view ('Coding') records the id the mutation needs; fall back to the raw arg.
+            return unless @page.respond_to?(:_compat_active_stage_id=)
+            @page._compat_active_stage_id = @stage&.id || stage_id
+          end
+
+          # The stage's sections only (not the full page's).
+          def sections
+            @stage&.sections || Base::Page::SectionCollection.from_doc([])
+          end
+
+          # All data fields across the stage's sections (not the full page's).
+          def components
+            @stage&.components || Base::Page::DataField::Collection.from_doc([])
+          end
+
+          # The ID of this stage view's stage.
+          def current_stage_id
+            @stage&.id
+          end
+
+          # Always true — this view is stage-specific.
+          def stages?
+            true
+          end
+
+          # Delegate all other accessors to the underlying full page.
+          def method_missing(method, *args, &block)
+            return @page.send(method, *args, &block) if @page.respond_to?(method)
+
+            super
+          end
+
+          def respond_to_missing?(method, include_private = false)
+            @page.respond_to?(method, include_private) || super
+          end
+
+          private
+
+          def find_stage(page, stage_id)
+            return nil unless page.respond_to?(:stages)
+
+            stages = page.stages
+            return nil unless stages.respond_to?(:[])
+
+            stages[stage_id] || (stages.respond_to?(:get_by_name) ? stages.get_by_name(stage_id) : nil)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +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'

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

@@ -0,0 +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

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

@@ -0,0 +1,20 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Concerns
+        module Deprecation
+          SCHEMA_VERSION = '20260605'.freeze
+
+          WARNED = Set.new
+
+          def self.warn_once(key, message)
+            return if WARNED.include?(key)
+
+            WARNED << key
+            warn "[ecoportal-api-graphql] DEPRECATED (#{key}): #{message}"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,75 +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
-          end
-
-          module InstanceMethods
-            attr_reader :client, :fragments
-
-            def initialize(client)
-              @client = client
-              parse
-            end
-
-            def define(sym, heredoc, namespace: ::Fragment)
-              namespace.send(:remove_const, sym) if namespace.const_defined?(sym)
-
-              client.parse(heredoc).tap do |fragment|
-                without_warnings do
-                  namespace.const_set(sym, fragment)
-                end
-              end
-            rescue ::GraphQL::Client::ValidationError, ::Graphlient::Errors::ClientError => err
-              raise err.class, "On fragment #{sym} -- #{err.message}", cause: nil
-            end
-
-            private
-
-            def without_warnings
-              original_verbose = $VERBOSE
-              $VERBOSE         = nil
-
-              yield if block_given?
-            ensure
-              $VERBOSE = original_verbose
-            end
-
-            def parse
-              @fragments = self.class.fragments.
-                each_with_object({}) do |(sym, heredoc), out|
-                  out[sym] = define(
-                    sym,
-                    heredoc,
-                    namespace: self.class
-                  )
-                end
-            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/page_compat.rb

@@ -0,0 +1,51 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Concerns
+        # v2-compatibility accessors for page model objects.
+        # Include in Interface::BasePage so all concrete page classes inherit them.
+        # These aliases allow eco-helpers scripts to work against GraphQL page models
+        # using the same method names they used with ecoportal-api-v2.
+        module PageCompat
+          # v2 called this externalId (camelCase) or external_id (snake_case)
+          def external_id
+            externalId
+          end
+
+          # v2 called sourceTemplateId "template_id"
+          def template_id
+            sourceTemplateId
+          end
+
+          # v2 compatibility: dataFields were called "components" in APIv2
+          def components
+            respond_to?(:dataFields) ? dataFields : []
+          end
+
+          # Whether the page has any stages (PhasedPage check)
+          def stages?
+            respond_to?(:stages) && !stages.nil? && !stages.empty?
+          end
+
+          # Clears dirty tracking — call after a successful update.
+          # Mirrors v2's ooze.consolidate! which resets the change baseline.
+          def consolidate!
+            @original_doc = doc.dup if respond_to?(:doc)
+            self
+          end
+
+          # v2 validate stub — always returns nil (no client-side validation in GraphQL path).
+          # Server-side errors are returned in the mutation payload's errors field.
+          def validate
+            nil
+          end
+
+          # Dirty check — returns true if there are pending changes.
+          def dirty?
+            !as_update.nil?
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +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

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

@@ -1,10 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Concerns
-      end
-    end
-  end
-end
-
-require_relative 'concerns/fragment_definitions'
+module Ecoportal
+  module API
+    class GraphQL
+      module Concerns
+      end
+    end
+  end
+end
+
+require_relative 'concerns/deprecation'
+require_relative 'concerns/fragment_definitions'
+require_relative 'concerns/snake_camel_access'
+require_relative 'concerns/page_compat'
+require_relative 'concerns/data_field_access'

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

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class Action < Logic::Connection
-          class_resolver :node_class, Model::Action
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class Action < Logic::Connection
+          class_resolver :node_class, Model::Action
+        end
+      end
+    end
+  end
+end

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

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class ActionCategory < Logic::Connection
-          class_resolver :node_class, Base::ActionCategory
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class ActionCategory < Logic::Connection
+          class_resolver :node_class, Base::ActionCategory
+        end
+      end
+    end
+  end
+end

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

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class ContractorEntity < Logic::Connection
-          class_resolver :node_class, Model::ContractorEntity
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class ContractorEntity < Logic::Connection
+          class_resolver :node_class, Model::ContractorEntity
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class Page < Logic::Connection
+          class_resolver :node_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+        end
+      end
+    end
+  end
+end

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

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

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

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class PersonMemberConnection < Logic::Connection
-          class_resolver :node_class, Model::PersonMember
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class PersonMemberConnection < Logic::Connection
+          class_resolver :node_class, Model::PersonMember
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class PresetView < Logic::Connection
+          class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PresetView'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class PreviewPage < Logic::Connection
+          class_resolver :node_class, 'Ecoportal::API::GraphQL::Model::PreviewPage'
+        end
+      end
+    end
+  end
+end

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

@@ -1,13 +1,17 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-      end
-    end
-  end
-end
-
-require_relative 'connection/person_member'
-require_relative 'connection/contractor_entity'
-require_relative 'connection/action_category'
-require_relative 'connection/action'
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+      end
+    end
+  end
+end
+
+require_relative 'connection/person_member'
+require_relative 'connection/contractor_entity'
+require_relative 'connection/action_category'
+require_relative 'connection/action'
+require_relative 'connection/page'
+require_relative 'connection/preview_page'
+require_relative 'connection/preset_view'
+require_relative 'connection/pages_workflow_command'