ecoportal-api-graphql 1.3.5 → 1.3.17

data/lib/ecoportal/api/graphql/base/page/data_field.rb

@@ -1,12 +1,137 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        module Page
-          class DataField < Logic::BaseModel
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+          # Base class for all data field types.
+          # Subclasses expose typed value accessors and serialise to DataFieldInput format.
+          class DataField < Logic::BaseModel
+            # Diff strategy for leaf data fields.
+            #
+            # A DataField's array attributes (`options`, `peopleIds`, `contractors`,
+            # `pages`, `fileContainers`, `items`, ...) are declared with `passarray`,
+            # which registers them as *cascaded* attributes. The default `DiffService`
+            # strips cascaded keys from the flat classic diff (`doc_with_non_cascaded_attributes`)
+            # on the assumption that a later `diff_reduce` pass re-adds them by cascading
+            # into nested `GraphQL::Model` children. DataField arrays are plain hashes /
+            # strings, not `GraphQL::Model` objects, so that re-add never happens and the
+            # array change becomes invisible to the diff (scalar `passthrough` fields are
+            # unaffected). For a leaf model we want every doc key diffed inline, so this
+            # service keeps cascaded keys in place.
+            class LeafDiffService < Ecoportal::API::Common::GraphQL::Model::Diffable::DiffService
+              private
+
+              # Keep all doc keys: leaf-field arrays are data, not nested models.
+              def doc_with_non_cascaded_attributes(json)
+                json
+              end
+            end
+
+            DIFF_CLASS = LeafDiffService
+            # Map GraphQL __typename values to subclass names.
+            TYPE_MAP = {
+              'PlainText'          => 'PlainText',
+              'RichText'           => 'RichText',
+              'Date'               => 'DateField',
+              'Number'             => 'Number',
+              'Gauge'              => 'Gauge',
+              'People'             => 'People',
+              'Select'             => 'Select',
+              'Checklist'          => 'Checklist',
+              'TagField'           => 'TagField',
+              'Geo'                => 'Geo',
+              'Signature'          => 'Signature',
+              'ContractorEntities' => 'ContractorEntities',
+              'CrossReference'     => 'CrossReference',
+              'ImageGallery'       => 'ImageGallery',
+              'File'               => 'FileField',
+              'Mailbox'            => 'Mailbox',
+              'ActionsList'        => 'ActionsList',
+              'Law'                => 'Law',
+              'AiSummary'          => 'AiSummary',
+              'Table'              => 'Table',
+              'SmartFill'          => 'SmartFill'
+            }.freeze
+
+            passkey :id
+            passthrough :label, :deindex, :genomeSignature
+            # __typename is stored under the 'type' key after mapping
+            passthrough :type
+
+            class << self
+              # Build the correct subclass from a raw field doc.
+              def from_doc(raw_doc)
+                type    = raw_doc.is_a?(Hash) ? (raw_doc['__typename'] || raw_doc['type']) : nil
+                subname = TYPE_MAP[type]
+                klass   = subname ? const_get(subname) : self
+                klass.new(raw_doc)
+              rescue NameError
+                new(raw_doc)
+              end
+            end
+
+            def initialize(raw_doc = {})
+              # Normalise __typename → type for passthrough accessor
+              raw_doc = raw_doc.dup if raw_doc.is_a?(Hash)
+              raw_doc['type'] ||= raw_doc['__typename'] if raw_doc.is_a?(Hash)
+              super
+            end
+
+            # DataField is a leaf model: it has no nested GraphQL::Model children.
+            # flat: true skips diff_reduce — required here, since diff_reduce would
+            # dig_delete! the (cascaded) array keys and never re-add them. The flat
+            # classic diff still sees those keys because LeafDiffService keeps them.
+            def dirty?
+              super(flat: true)
+            end
+
+            # Produces the DataFieldInput hash for this field.
+            # Returns nil if the field has not been modified.
+            # Subclasses override to produce typed payloads.
+            def as_input
+              nil
+            end
+
+            private
+
+            # Coerce a value to Float for numeric fields (Number, Gauge), treating a BLANK
+            # (nil / empty / whitespace-only string) as nil — NOT 0.0. Ruby's `"".to_f` is 0.0,
+            # so a naive `numeric&.to_f` silently wrote a real zero whenever a CSV cell was an
+            # empty string (Eco::CSV keeps quoted-empty `""` as "", not nil). A genuine number,
+            # or a numeric string like "0" / "15", still becomes a Float. Shared here so Number
+            # and Gauge cannot drift apart.
+            def numeric_or_nil(value)
+              return value.to_f if value.is_a?(Numeric)
+
+              str = value.to_s.strip
+              str.empty? ? nil : str.to_f
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+require_relative 'data_field/plain_text'
+require_relative 'data_field/rich_text'
+require_relative 'data_field/date_field'
+require_relative 'data_field/number'
+require_relative 'data_field/gauge'
+require_relative 'data_field/people'
+require_relative 'data_field/select'
+require_relative 'data_field/checklist'
+require_relative 'data_field/tag_field'
+require_relative 'data_field/geo'
+require_relative 'data_field/signature'
+require_relative 'data_field/contractor_entities'
+require_relative 'data_field/cross_reference'
+require_relative 'data_field/image_gallery'
+require_relative 'data_field/file_field'
+require_relative 'data_field/mailbox'
+require_relative 'data_field/actions_list'
+require_relative 'data_field/law'
+require_relative 'data_field/ai_summary'
+require_relative 'data_field/table'
+require_relative 'data_field/smart_fill'
+require_relative 'data_field/collection'

data/lib/ecoportal/api/graphql/base/page/phased/stage.rb

@@ -1,14 +1,68 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        module Page
-          class Phased
-            class Stage < Logic::BaseModel
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+          class Phased
+            # Model for a single stage on a PhasedPage.
+            # Fields match those returned by the stageAttrs fragment in CommonPageUnion.
+            class Stage < Logic::BaseModel
+              passkey :id
+              passthrough :name, :ordering, :state
+              passboolean :active, :started
+
+              class_resolver :callback_type_class, 'Ecoportal::API::GraphQL::Base::PagesWorkflow::CallbackType'
+
+              # Injected by Model::Page::Phased so this stage's #components returns the page's
+              # canonical field objects (filtered to this stage) rather than fresh dups.
+              attr_writer :page_field_collection
+
+              def workflow_callbacks
+                @workflow_callbacks ||= Array(doc['workflowCallbacks'] || []).map { |cb| callback_type_class.from_doc(cb) }
+              end
+
+              # Predicate aliases — eco-helpers scripts call stage.active? / stage.started?
+              def active?
+                !!doc['active']
+              end
+
+              def started?
+                !!doc['started']
+              end
+
+              # Sections in this stage as a SectionCollection.
+              def sections
+                @sections ||= SectionCollection.from_doc(doc['sections'] || [])
+              end
+
+              # All data fields across all sections in this stage (v2 compat: stage.components).
+              # If the parent page injected its canonical field_collection, return THOSE field
+              # objects (filtered to this stage by id) so mutations made via the stage are the
+              # same objects the page serialises in data_fields_updates. Else build from docs.
+              def components
+                @components ||= if @page_field_collection
+                                  ids = stage_field_ids
+                                  DataField::Collection.new(@page_field_collection.select { |f| ids.include?(f.id) })
+                                else
+                                  sections.components
+                                end
+              end
+
+              # Field ids belonging to this stage (across its sections' data/left/right fields).
+              def stage_field_ids
+                (doc['sections'] || []).flat_map do |sec|
+                  (sec['dataFields'] || []) + (sec['leftDataFields'] || []) + (sec['rightDataFields'] || [])
+                end.map { |f| f['id'] }.compact
+              end
+
+              # Hash-style access to raw doc — for backwards-compatible scripts.
+              def [](key)
+                doc[key.to_s]
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/phased.rb

@@ -1,14 +1,15 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        module Page
-          class Phased < Interface::BasePage
-            require_relative 'phased/stage'
-
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+          class Phased < Interface::BasePage
+            require_relative 'phased/stage'
+
+            embeds_many :stages, klass: Stage, read_only: true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/section.rb

@@ -1,12 +1,48 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        module Page
-          class Section < Logic::BaseModel
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+          # Wraps a SectionUnion doc (ContentSection or SplitSection).
+          # Provides access to heading, type, and data fields within the section.
+          class Section < Logic::BaseModel
+            read_only!
+
+            passkey :id
+            passthrough :heading
+
+            # __typename normalised to 'type' during initialisation
+            passthrough :type
+
+            def initialize(raw_doc = {})
+              raw_doc = raw_doc.dup if raw_doc.is_a?(Hash)
+              raw_doc['type'] ||= raw_doc['__typename'] if raw_doc.is_a?(Hash)
+              super
+            end
+
+            # All data fields in this section.
+            # ContentSection  → dataFields
+            # SplitSection    → leftDataFields + rightDataFields (merged)
+            def components
+              all = (doc['dataFields']      || []) +
+                    (doc['leftDataFields']  || []) +
+                    (doc['rightDataFields'] || [])
+              DataField::Collection.from_doc(all)
+            end
+
+            # v2 compat alias
+            alias_method :data_fields, :components
+
+            def content_section?
+              type.to_s == 'ContentSection'
+            end
+
+            def split_section?
+              type.to_s == 'SplitSection'
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/section_collection.rb

@@ -0,0 +1,85 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+          # Wraps an array of raw section docs as typed Section objects.
+          # Provides v2-compatible access patterns:
+          #   sections.get_by_type(:content_section)
+          #   sections.doc                           — raw doc array
+          #   sections.ordered                       — sections in response order
+          #   sections.each { |s| s.components ... }
+          class SectionCollection
+            include Enumerable
+
+            def initialize(sections_array)
+              @sections = Array(sections_array).map { |s| Section.new(s) }
+            end
+
+            def self.from_doc(raw_array)
+              new(Array(raw_array))
+            end
+
+            # Filter by section type. Accepts symbol (:content_section / :split_section)
+            # or string ('ContentSection' / 'SplitSection'). Case-insensitive, underscore-tolerant.
+            def get_by_type(type_key)
+              target = normalise_type(type_key)
+              @sections.select { |s| normalise_type(s.type) == target }
+            end
+
+            # Find section by heading (case-insensitive).
+            def get_by_heading(heading)
+              @sections.find { |s| s.heading.to_s.downcase == heading.to_s.downcase }
+            end
+
+            # Find a section by its id (v2 compat: sections.get_by_id). Returns the section or nil.
+            def get_by_id(id)
+              wanted = id.to_s
+              @sections.find { |s| s.id.to_s == wanted }
+            end
+
+            # Raw doc array — v2 compat (scripts iterate sections.doc).
+            def doc
+              @sections.map(&:doc)
+            end
+
+            # Sections in response order (already ordered from server).
+            def ordered
+              @sections
+            end
+
+            # All data fields across every section in this collection (memoized).
+            def components
+              @components ||= begin
+                all_docs = @sections.flat_map do |s|
+                  (s.doc['dataFields'] || []) +
+                    (s.doc['leftDataFields']  || []) +
+                    (s.doc['rightDataFields'] || [])
+                end
+                DataField::Collection.from_doc(all_docs)
+              end
+            end
+
+            def each(&block)
+              @sections.each(&block)
+            end
+
+            def empty?
+              @sections.empty?
+            end
+
+            def length
+              @sections.length
+            end
+
+            private
+
+            def normalise_type(type_key)
+              type_key.to_s.downcase.delete('_') if type_key
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/task.rb

@@ -0,0 +1,24 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+          # A page TASK — the `item` of the review-task mutations (`TaskInterface`:
+          # CompletePage / InComment / ReviewPage). Read-only.
+          #
+          # This is NOT a page: the page it belongs to is `subject` (a PageUnion). The
+          # review-task payloads used to type `item` as `Model::PageUnion`, which never
+          # matched the schema (see `Fragment :PageTaskFields`).
+          class Task < Logic::BaseModel
+            read_only!
+
+            passkey     :id
+            passthrough :__typename, :stageId, :relativeStatus, :taskNotes
+            passboolean :complete, :overdue, :escalated
+            passdate    :createdAt, :completedAt, :due
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,14 +1,17 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        module Page
-        end
-      end
-    end
-  end
-end
-
-require_relative 'page/data_field'
-require_relative 'page/section'
-require_relative 'page/phased'
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+        end
+      end
+    end
+  end
+end
+
+require_relative 'page/basic'
+require_relative 'page/data_field'
+require_relative 'page/section'
+require_relative 'page/section_collection'
+require_relative 'page/phased'
+require_relative 'page/task'

data/lib/ecoportal/api/graphql/base/page_info.rb

@@ -1,12 +1,12 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PageInfo < Logic::BaseModel
-          passthrough :startCursor, :endCursor
-          passboolean :hasNextPage, :hasPreviousPage
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PageInfo < Logic::BaseModel
+          passthrough :startCursor, :endCursor
+          passboolean :hasNextPage, :hasPreviousPage
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/action_type_selection.rb

@@ -0,0 +1,17 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class ActionTypeSelection < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passthrough :name
+            passboolean :deleted
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/callback_type.rb

@@ -0,0 +1,28 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class CallbackType < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passthrough :triggerCondition
+
+            def operations
+              @operations ||= Array(doc['operations'] || []).map do |op|
+                OperationInterface.from_doc(op)
+              end
+            end
+
+            def triggers
+              @triggers ||= Array(doc['triggers'] || []).map do |t|
+                TriggerInterface.from_doc(t)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/command_change.rb

@@ -0,0 +1,17 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class CommandChange < CommandInterface
+            SCHEMA_VERSION = '20260605'.freeze
+
+            def changes
+              @changes ||= Array(doc['changes'] || [])
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/command_change_message.rb

@@ -0,0 +1,15 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class CommandChangeMessage < CommandInterface
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passarray :changeMessages
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/command_es_change.rb

@@ -0,0 +1,17 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class CommandEsChange < CommandInterface
+            SCHEMA_VERSION = '20260605'.freeze
+
+            def changes
+              @changes ||= Array(doc['changes'] || [])
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/command_interface.rb

@@ -0,0 +1,36 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class CommandInterface < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passthrough :commandAction
+            passdate :createdAt, :updatedAt
+            passthrough :patchVer
+            passthrough :ownerId, :stageName, :stageId, :taskId, :taskType
+
+            require_relative 'command_change'
+            require_relative 'command_change_message'
+            require_relative 'command_es_change'
+
+            def self.from_doc(raw_doc)
+              case raw_doc&.fetch('__typename', nil)
+              when 'PagesWorkflowCommandChange'
+                CommandChange.new(raw_doc)
+              when 'PagesWorkflowCommandChangeMessage'
+                CommandChangeMessage.new(raw_doc)
+              when 'PagesWorkflowCommandEsChange'
+                CommandEsChange.new(raw_doc)
+              else
+                new(raw_doc)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/email_config.rb

@@ -0,0 +1,18 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class EmailConfig < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passboolean :attachPdf, :enabled, :includeRegistersAndTags, :includeSmartSummary
+            passboolean :pdfAttachmentSkipped, :pdfRedacted, :sendAsGroupEmail
+            passthrough :body, :subject
+            passarray :fileContainerIds, :pdfStageIds
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/escalation_level.rb

@@ -0,0 +1,19 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class EscalationLevel < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passthrough :order, :dueInValue, :dueInUnit
+            passboolean :dueExcludeWeekends, :timerPaused
+            passthrough :elapsedSeconds
+            passdate :escalationDueAt
+          end
+        end
+      end
+    end
+  end
+end