ecoportal-api-graphql 1.3.5 → 1.3.17

data/lib/ecoportal/api/graphql/fragment/pagination.rb

@@ -1,17 +1,17 @@
-module Ecoportal
-  module API
-    class GraphQL
-      class Fragment
-        fragment :Pagination, <<~GRAPHQL
-          fragment on ActionConnection {
-            totalCount
-            pageInfo {
-              endCursor
-              hasNextPage
-            }
-          }
-        GRAPHQL
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        fragment :Pagination, <<~GRAPHQL
+          fragment Pagination on ActionConnection {
+            totalCount
+            pageInfo {
+              endCursor
+              hasNextPage
+            }
+          }
+        GRAPHQL
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/fragment/template.rb

@@ -0,0 +1,51 @@
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        # `createTemplateRelatedPage` / `destroyTemplateRelatedPage` return
+        # `item: RelatedPages` — a related-pages CONFIG entry, not a page. They used to select
+        # `item { ...PageFields }` (invalid: "can't be spread inside RelatedPages"), which made
+        # both mutations fail.
+        #
+        # Verified against the live schema (2026-07-30): RelatedPages exposes filters
+        # (StoredEsFilter), hasInaccessibleVariables, id, pages (PreviewPageConnection),
+        # register (MinimalRegister), registerId, title. Only the scalars are selected here —
+        # `pages` is a connection and `filters`/`register` are objects needing their own
+        # selections; query them explicitly when needed.
+        fragment :TemplateRelatedPages, <<~GRAPHQL
+          fragment TemplateRelatedPages on RelatedPages {
+            id
+            title
+            registerId
+            hasInaccessibleVariables
+          }
+        GRAPHQL
+
+        # `updateTemplateInformation` returns `UpdateInformationPayload { item: Template }`.
+        # ★ NOTE the type asymmetry: elsewhere in this gem a "template" is a PAGE
+        # (`Query::Templates` and the other template payloads legitimately resolve to
+        # `Model::PageUnion`, and validate clean), but THIS mutation returns the narrow
+        # `Template` type — hence `item { ...PageFields }` was invalid ("can't be spread
+        # inside Template").
+        #
+        # Verified against the live schema (2026-07-30): Template exposes active,
+        # aiDescription, commands (connection), creatorEditable, creatorEnabled, creatorFlags,
+        # description, folders, id, public, publicConfig, templateContainerUid, templateType.
+        fragment :TemplateInformation, <<~GRAPHQL
+          fragment TemplateInformation on Template {
+            id
+            description
+            aiDescription
+            templateType
+            templateContainerUid
+            active
+            public
+            folders
+            creatorEnabled
+            creatorEditable
+          }
+        GRAPHQL
+      end
+    end
+  end
+end

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

@@ -1,27 +1,40 @@
-# Namespace to create custom fragments from client scripts
-module Fragment
-  include Ecoportal::API::Common::GraphQL::ClassHelpers
-end
-
-# Class to define/parse fragments
-module Ecoportal
-  module API
-    class GraphQL
-      class Fragment
-        include Ecoportal::API::GraphQL::Concerns::FragmentDefinitions
-
-        def initialize(...)
-          super(...)
-        end
-      end
-    end
-  end
-end
-
-require_relative 'fragment/pagination'
-require_relative 'fragment/locations_error'
-require_relative 'fragment/location_node'
-require_relative 'fragment/location_draft'
-require_relative 'fragment/action_category'
-require_relative 'fragment/action'
-require_relative 'fragment/contractor_entity'
+# Namespace to create custom fragments from client scripts
+module Fragment
+  include Ecoportal::API::Common::GraphQL::ClassHelpers
+end
+
+# Class to define/parse fragments
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        include Ecoportal::API::GraphQL::Concerns::FragmentDefinitions
+
+        def initialize(...)
+          super
+
+          pages
+        end
+
+        def pages
+          @pages ||= Pages.new(client)
+        end
+      end
+    end
+  end
+end
+
+require_relative 'fragment/pagination'
+require_relative 'fragment/locations_error'
+require_relative 'fragment/location_node'
+require_relative 'fragment/location_draft'
+require_relative 'fragment/action_category'
+require_relative 'fragment/action'
+require_relative 'fragment/contractor_entity'
+require_relative 'fragment/page'
+require_relative 'fragment/pages'
+require_relative 'fragment/force'
+require_relative 'fragment/pages_workflow'
+require_relative 'fragment/field_configuration'
+require_relative 'fragment/page_task'
+require_relative 'fragment/template'

data/lib/ecoportal/api/graphql/helpers/locations_tree.rb

@@ -1,41 +1,41 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Helpers
-        module LocationsTree
-          RELEVANT_NODES_COUNT = 1_000
-
-          def treeify(nodes)
-            parents = nodes.each_with_object({}) do |node, out|
-              (out[node.parent_id_upcase] ||= []).push(node)
-            end
-
-            get_children(nil, parents)
-          end
-
-          private
-
-          def get_children(node_id, parents)
-            (parents[node_id&.upcase] ||= []).each_with_object([]) do |child, results|
-              class_types = child.classifications || []
-              class_ids   = class_types.map(&:id)
-              class_names = class_types.map(&:name)
-
-              results << {
-                'id'                   => child.id,
-                'name'                 => child.name,
-                'weight'               => child.weight,
-                'parent_id'            => node_id,
-                'archived'             => child.archived,
-                'archived_token'       => child.archivedToken,
-                'classifications'      => class_ids,
-                'classification_names' => class_names,
-                'nodes'                => get_children(child.id, parents).compact
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Helpers
+        module LocationsTree
+          RELEVANT_NODES_COUNT = 1_000
+
+          def treeify(nodes)
+            parents = nodes.each_with_object({}) do |node, out|
+              (out[node.parent_id_upcase] ||= []).push(node)
+            end
+
+            get_children(nil, parents)
+          end
+
+          private
+
+          def get_children(node_id, parents)
+            (parents[node_id&.upcase] ||= []).each_with_object([]) do |child, results|
+              class_types = child.classifications || []
+              class_ids   = class_types.map(&:id)
+              class_names = class_types.map(&:name)
+
+              results << {
+                'id'                   => child.id,
+                'name'                 => child.name,
+                'weight'               => child.weight,
+                'parent_id'            => node_id,
+                'archived'             => child.archived,
+                'archived_token'       => child.archivedToken,
+                'classifications'      => class_ids,
+                'classification_names' => class_names,
+                'nodes'                => get_children(child.id, parents).compact
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,10 +1,10 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Helpers
-      end
-    end
-  end
-end
-
-require_relative 'helpers/locations_tree'
+module Ecoportal
+  module API
+    class GraphQL
+      module Helpers
+      end
+    end
+  end
+end
+
+require_relative 'helpers/locations_tree'

data/lib/ecoportal/api/graphql/input/action/archive.rb

@@ -1,14 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module Action
-          class Archive < Logic::Input
-            passkey :id
-            passthrough :updateMode
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module Action
+          class Archive < Logic::Input
+            passkey :id
+            passthrough :updateMode
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/action/create.rb

@@ -1,13 +1,13 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module Action
-          class Create < Base::Action
-            passthrough :clientMutationId
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module Action
+          class Create < Base::Action
+            passthrough :clientMutationId
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/action/update.rb

@@ -1,14 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module Action
-          class Update < Ecoportal::API::GraphQL::Base::Action
-            passthrough :clientMutationId
-            passthrough :updateMode
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module Action
+          class Update < Ecoportal::API::GraphQL::Base::Action
+            passthrough :clientMutationId
+            passthrough :updateMode
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,14 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module Action
-        end
-      end
-    end
-  end
-end
-
-require_relative 'action/create'
-require_relative 'action/update'
-require_relative 'action/archive'
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module Action
+        end
+      end
+    end
+  end
+end
+
+require_relative 'action/create'
+require_relative 'action/update'
+require_relative 'action/archive'

data/lib/ecoportal/api/graphql/input/contractor_entity/create.rb

@@ -1,14 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module ContractorEntity
-          class Create < Base::ContractorEntity
-            passthrough :clientMutationId
-            passboolean :overrideAutoApproval
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module ContractorEntity
+          class Create < Base::ContractorEntity
+            passthrough :clientMutationId
+            passboolean :overrideAutoApproval
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/contractor_entity/destroy.rb

@@ -1,13 +1,13 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module ContractorEntity
-          class Destroy < Logic::Input
-            passkey :id
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module ContractorEntity
+          class Destroy < Logic::Input
+            passkey :id
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/contractor_entity/update.rb

@@ -1,16 +1,41 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module ContractorEntity
-          class Update < Input::ContractorEntity::Create
-            passthrough :clientMutationId
-            class_resolver :id_diff_input, "Ecoportal::API::GraphQL::Input::IdDiff"
-            embeds_one :associatedPeopleIds, klass: :id_diff_input
-            embeds_one :leadContractorIds, klass: :id_diff_input
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module ContractorEntity
+          class Update < Input::ContractorEntity::Create
+            passthrough :clientMutationId
+            class_resolver :id_diff_input, "Ecoportal::API::GraphQL::Input::IdDiff"
+            embeds_one :associatedPeopleIds, klass: :id_diff_input
+            embeds_one :leadContractorIds, klass: :id_diff_input
+
+            ID_DIFF_FIELDS = %i[associatedPeopleIds leadContractorIds].freeze
+
+            class << self
+              # Overrides Logic::Input.from_model to reshape array fields into
+              # IdDiffInput format: { additions: [...], removals: [...] }
+              # Array fields are stripped from the flat diff, so we compare
+              # doc vs original_doc directly rather than relying on the diff hash.
+              def from_model(model, **kargs)
+                diff = Logic::Input.from_model(model, **kargs)
+
+                ID_DIFF_FIELDS.each do |field|
+                  key      = field.to_s
+                  current  = Array(model.doc[key])
+                  original = Array(model.original_doc[key])
+                  next if current == original
+
+                  diff       ||= {}
+                  diff[:id]  ||= model.id
+                  diff[field]  = { additions: current - original, removals: original - current }
+                end
+
+                diff
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,14 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module ContractorEntity
-        end
-      end
-    end
-  end
-end
-
-require_relative 'contractor_entity/create'
-require_relative 'contractor_entity/destroy'
-require_relative 'contractor_entity/update'
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module ContractorEntity
+        end
+      end
+    end
+  end
+end
+
+require_relative 'contractor_entity/create'
+require_relative 'contractor_entity/destroy'
+require_relative 'contractor_entity/update'

data/lib/ecoportal/api/graphql/input/delta_input.rb

@@ -0,0 +1,16 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        # Maps DeltaInput for the pageDelta query.
+        # Pass as an array: [{ id: 'pageId', deltaAt: 'ISO8601DateTime' }, ...]
+        # deltaAt: the last-known timestamp for this page ID.
+        # Server returns UPDATED if the page changed after deltaAt, NOT_FOUND if deleted, NEW if unknown.
+        class DeltaInput < Logic::Input
+          passkey :id
+          passthrough :deltaAt
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/id_diff.rb

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class IdDiff < Logic::BaseModel
-          passarray :additions, :removals
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class IdDiff < Logic::BaseModel
+          passarray :additions, :removals
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/location_structure/apply_commands.rb

@@ -1,47 +1,47 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        module LocationStructure
-          class ApplyCommands < Logic::Input
-            passkey :id
-            passboolean :force
-            embeds_many :commands, klass: Interface::LocationStructure::Command
-            passboolean :preview
-
-            def add(type, **kargs)
-              if (command = new_command(type))
-                command.set_values(**kargs) unless kargs.empty?
-                yield(command) if block_given?
-              end
-              command
-            end
-
-            private
-
-            def new_command(type)
-              case type
-              when :archive
-                Input::LocationStructure::ArchiveCommand.new
-              when :unarchive
-                Input::LocationStructure::UnarchiveCommand.new
-              when :delete
-                Input::LocationStructure::DeleteCommand.new
-              when :move
-                Input::LocationStructure::MoveCommand.new
-              when :insert
-                Input::LocationStructure::InsertCommand.new
-              when :update
-                Input::LocationStructure::UpdateCommand.new
-              when :reoder
-                Input::LocationStructure::ReoderCommand.new
-              else
-                raise "Unknown command type: '#{type}'"
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        module LocationStructure
+          class ApplyCommands < Logic::Input
+            passkey :id
+            passboolean :force
+            embeds_many :commands, klass: Interface::LocationStructure::Command
+            passboolean :preview
+
+            def add(type, **kargs)
+              if (command = new_command(type))
+                command.set_values(**kargs) unless kargs.empty?
+                yield(command) if block_given?
+              end
+              command
+            end
+
+            private
+
+            def new_command(type)
+              case type
+              when :archive
+                Input::LocationStructure::ArchiveCommand.new
+              when :unarchive
+                Input::LocationStructure::UnarchiveCommand.new
+              when :delete
+                Input::LocationStructure::DeleteCommand.new
+              when :move
+                Input::LocationStructure::MoveCommand.new
+              when :insert
+                Input::LocationStructure::InsertCommand.new
+              when :update
+                Input::LocationStructure::UpdateCommand.new
+              when :reoder
+                Input::LocationStructure::ReoderCommand.new
+              else
+                raise "Unknown command type: '#{type}'"
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end