ecoportal-api-graphql 1.3.5 → 1.3.16

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

@@ -1,34 +1,34 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Logic
-        class Connection < Logic::BaseModel
-          class GenericNode
-            def initialize(*_args, **_kargs)
-              raise "Missuse error. You should define a node_class for a class that inherits from GraphqlConnection class."
-            end
-          end
-
-          include Enumerable
-
-          class_resolver :node_class, GenericNode
-
-          passthrough :edges
-          passthrough :totalCount
-          embeds_many :nodes, klass: :node_class
-          embeds_one :pageInfo, klass: Base::PageInfo
-
-          def empty?
-            count < 1
-          end
-
-          def each(&block)
-            return to_enum(:each) unless block
-
-            nodes.each(&block)
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Logic
+        class Connection < Logic::BaseModel
+          class GenericNode
+            def initialize(*_args, **_kargs)
+              raise "Missuse error. You should define a node_class for a class that inherits from GraphqlConnection class."
+            end
+          end
+
+          include Enumerable
+
+          class_resolver :node_class, GenericNode
+
+          passthrough :edges
+          passthrough :totalCount
+          embeds_many :nodes, klass: :node_class
+          embeds_one :pageInfo, klass: Base::PageInfo
+
+          def empty?
+            count < 1
+          end
+
+          def each(&block)
+            return to_enum(:each) unless block
+
+            nodes.each(&block)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,11 +1,26 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Logic
-        class Input < Logic::BaseModel
-          passthrough :clientMutationId
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Logic
+        class Input < Logic::BaseModel
+          passthrough :clientMutationId
+
+          class << self
+            # Builds a mutation input hash from a model's diff.
+            # Subclasses override this to reshape fields (e.g. array → IdDiffInput).
+            # @param model [Common::GraphQL::Model] the subject model.
+            # @return [Hash, nil] the mutation input hash, or nil when there are no changes.
+            def from_model(model, client_mutation_id: '')
+              diff = model.as_update
+              return nil if diff.nil?
+
+              diff[:patchVer]         = model.patchVer if model.respond_to?(:patchVer) && !model.patchVer.nil?
+              diff[:clientMutationId] = client_mutation_id unless client_mutation_id.to_s.empty?
+              diff
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/model/ai_summary_version.rb

@@ -0,0 +1,10 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        class AiSummaryVersion < Base::AiSummaryVersion
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/model/organization.rb

@@ -1,55 +1,65 @@
-# rubocop:disable Layout/ArgumentAlignment
-
-module Ecoportal
-  module API
-    class GraphQL
-      module Model
-        class Organization < Base::Organization
-          DEFAULT_PATH = ['currentOrganization'].freeze
-
-          class << self
-            extend Ecoportal::API::Common::GraphQL::QueryIntegration
-
-            def path(*add)
-              return @path if add.empty? && instance_variable_defined?(:@path)
-
-              @path ||= self::DEFAULT_PATH.dup
-              @path   = @path.push(*add)
-            end
-
-            query :locationStructure,
-              subpath:     'locations',
-              query_klass: 'Ecoportal::API::GraphQL::Query::LocationStructure'
-            query :locationStructures,
-              subpath:     'locations',
-              query_klass: 'Ecoportal::API::GraphQL::Query::LocationStructures'
-            query :locationDraftById,
-              subpath:     %w[locations structure],
-              query_klass: 'Ecoportal::API::GraphQL::Query::LocationStructure::Draft'
-
-            query :contractorEntities,
-              query_klass: 'Ecoportal::API::GraphQL::Query::ContractorEntities'
-            #contractorEntity,
-            query :actionCategories,
-              query_klass: 'Ecoportal::API::GraphQL::Query::ActionCategories'
-            query :action,
-              query_klass: 'Ecoportal::API::GraphQL::Query::Action'
-            query :actions,
-              query_klass: 'Ecoportal::API::GraphQL::Query::Actions'
-            query :archiveAction,
-              query_klass: 'Ecoportal::API::GraphQL::Mutation::Action::Archive'
-            # actionsByPage, actionsCounter
-
-            # userGroup, userGroups
-            # personMembers, attachablePersonMembers
-
-            # register, registers
-            # page, pages
-          end
-        end
-      end
-    end
-  end
-end
-
-# rubocop:enable Layout/ArgumentAlignment
+# rubocop:disable Layout/ArgumentAlignment
+
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        class Organization < Base::Organization
+          DEFAULT_PATH = ['currentOrganization'].freeze
+
+          class << self
+            extend Ecoportal::API::Common::GraphQL::QueryIntegration
+
+            def path(*add)
+              return @path if add.empty? && instance_variable_defined?(:@path)
+
+              @path ||= self::DEFAULT_PATH.dup
+              @path.push(*add)
+            end
+
+            query :locationStructure,
+              subpath:     'locations',
+              query_klass: 'Ecoportal::API::GraphQL::Query::LocationStructure'
+            query :locationStructures,
+              subpath:     'locations',
+              query_klass: 'Ecoportal::API::GraphQL::Query::LocationStructures'
+            query :locationDraftById,
+              subpath:     %w[locations structure],
+              query_klass: 'Ecoportal::API::GraphQL::Query::LocationStructure::Draft'
+
+            query :contractorEntities,
+              query_klass: 'Ecoportal::API::GraphQL::Query::ContractorEntities'
+            #contractorEntity,
+            query :actionCategories,
+              query_klass: 'Ecoportal::API::GraphQL::Query::ActionCategories'
+            query :action,
+              query_klass: 'Ecoportal::API::GraphQL::Query::Action'
+            query :actions,
+              query_klass: 'Ecoportal::API::GraphQL::Query::Actions'
+            query :archiveAction,
+              query_klass: 'Ecoportal::API::GraphQL::Mutation::Action::Archive'
+            # actionsByPage, actionsCounter
+
+            # userGroup, userGroups
+            # personMembers, attachablePersonMembers
+
+            # register, registers
+            query :page,
+              query_klass: 'Ecoportal::API::GraphQL::Query::Page'
+            query :pages,
+              query_klass: 'Ecoportal::API::GraphQL::Query::Pages'
+            query :templates,
+              query_klass: 'Ecoportal::API::GraphQL::Query::Templates'
+            # registerPreviewPages: uses Query::RegisterPreviewPages directly (requires
+            # registerId param at the register level — not wired via QueryIntegration).
+            # Usage: Query::RegisterPreviewPages.new(client).query(registerId: 'X', ...)
+            # pageDelta: uses Query::PageDelta directly (array return, not connection).
+            # Usage: Query::PageDelta.new(client).query(deltaInput: [{id:, deltaAt:}, ...])
+          end
+        end
+      end
+    end
+  end
+end
+
+# rubocop:enable Layout/ArgumentAlignment

data/lib/ecoportal/api/graphql/model/page/basic.rb

@@ -0,0 +1,14 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        module Page
+          class Basic < Base::Page::Basic
+            class_resolver :user_class, 'Ecoportal::API::GraphQL::Model::User'
+            class_resolver :organization_class, 'Ecoportal::API::GraphQL::Model::Organization'
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,20 +1,82 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Model
-        module Page
-          class Phased < Base::Page::Phased
-            require_relative 'phased/stage'
-
-            class_resolver :user_class, 'Ecoportal::API::GraphQL::Model::User'
-            # class_resolver :force_class, 'Ecoportal::API::GraphQL::Model::Force'
-            # class_resolver :theme_class, 'Ecoportal::API::GraphQL::Model::Theme'
-            # class_resolver :template_class, 'Ecoportal::API::GraphQL::Model::Template'
-            # class_resolver :register_class, 'Ecoportal::API::GraphQL::Model::Register'
-            class_resolver :organization_class, 'Ecoportal::API::GraphQL::Model::Organization'
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        module Page
+          class Phased < Base::Page::Phased
+            require_relative 'phased/stage'
+
+            class_resolver :user_class, 'Ecoportal::API::GraphQL::Model::User'
+
+            # The stage the client is currently working on, set when a stage view is taken
+            # over this page (Compat::StageView / pages.get(stage_id:) / OozeRedirect#stage).
+            # It is the AUTHORITATIVE target for a subsequent submit!/sign_off!: stage tasks
+            # (and the people-field permissions scoped to them) apply to a SPECIFIC stage, so
+            # the submit must name the stage the work was done on — not a guessed "active"
+            # stage. `current_stage_id` (server-state inference) is only a last-resort fallback.
+            # Explicit accessor so it wins over the doc-backed method_missing; nil until a view
+            # is taken. See Compat::Pages#compat_stage_id for the resolution order.
+            attr_accessor :_compat_active_stage_id
+
+            # Override passarray :stages to return a StageCollection wrapper,
+            # enabling v2-compatible access: stages[id_name], stages.get_by_name, stages.ordered
+            def stages
+              embedded = super
+              # Share the page's canonical field objects with each stage, so mutations made
+              # via stage.components reach the page's data_fields_updates (phased write-path).
+              fc = field_collection
+              Array(embedded).each do |st|
+                st.page_field_collection = fc if st.respond_to?(:page_field_collection=)
+              end
+              Compat::StageCollection.new(embedded)
+            end
+
+            # v2 compatible: ID of the stage with state == 'inprogress', or nil
+            def current_stage_id
+              raw = doc['stagesIndex'] || doc['stages']
+              return nil unless raw.is_a?(Array)
+
+              active = raw.find { |s| s['state'] == 'inprogress' || s['active'] == true }
+              active&.fetch('id', nil)
+            end
+            # class_resolver :force_class, 'Ecoportal::API::GraphQL::Model::Force'
+            # class_resolver :theme_class, 'Ecoportal::API::GraphQL::Model::Theme'
+            # class_resolver :template_class, 'Ecoportal::API::GraphQL::Model::Template'
+            # class_resolver :register_class, 'Ecoportal::API::GraphQL::Model::Register'
+            class_resolver :organization_class, 'Ecoportal::API::GraphQL::Model::Organization'
+
+            private
+
+            # v2-compat read flatten: a phased page's fields/sections live nested under
+            # stages -> sections; v2 exposed them flat at the page (page.components /
+            # page.sections). These override DataFieldAccess's hooks so field_collection /
+            # section_collection gather across stages. Field docs are shared by reference,
+            # so mutations forward to the nested doc (write path reuses field_collection).
+            #
+            # NOTE (collection-level review pending):
+            #   - fields are deduped by id (a field can appear in multiple stages — matches
+            #     v2's `sections.map(&:components).flatten.uniq`);
+            #   - sections cannot be deduped yet (the sectionUnion fragment fetches no id);
+            #   - orphaned sections/fields (no stage / no section) are not fetched by
+            #     CommonPageUnion, so they are not surfaced here (query/fragment gap).
+            def raw_data_fields
+              raw_sections.flat_map { |section| field_docs_in(section) }.compact.uniq { |fld| fld['id'] }
+            end
+
+            def raw_sections
+              # A section can recur across stages (same id); dedup to match v2's flat
+              # page.sections. (sectionUnion now fetches section id — gem fragment fix.)
+              (doc['stages'] || []).flat_map { |stage| stage['sections'] || [] }.uniq { |sec| sec['id'] }
+            end
+
+            def field_docs_in(section)
+              (section['dataFields'] || []) +
+                (section['leftDataFields'] || []) +
+                (section['rightDataFields'] || [])
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        module Page
+          # Concrete `Base::Page::Task` — adds the typed `subject` (the page the task belongs
+          # to), which the base class cannot declare because `Model::PageUnion` lives one layer
+          # up. Nullable: the caller may select the task without its subject.
+          class Task < Base::Page::Task
+            embeds_one :subject, klass: 'Ecoportal::API::GraphQL::Model::PageUnion', nullable: true
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,14 +1,16 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Model
-        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 Model
+        module Page
+        end
+      end
+    end
+  end
+end
+
+require_relative 'page/basic'
+require_relative 'page/data_field'
+require_relative 'page/section'
+require_relative 'page/phased'
+require_relative 'page/task'

data/lib/ecoportal/api/graphql/model/page_union.rb

@@ -0,0 +1,21 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        # Factory class — dispatches on __typename to the correct concrete page class.
+        # Must be a Class (not a Module): v2's resolve_class matches `when Class`, so a
+        # Module target falls through to "Unknown class". `self.new` is overridden to
+        # return the concrete page instance instead of a PageUnion instance.
+        class PageUnion
+          def self.new(doc, **opts)
+            case doc&.fetch('__typename', nil)
+            when 'BasicPage'  then Page::Basic.new(doc, **opts)
+            when 'PhasedPage' then Page::Phased.new(doc, **opts)
+            else                   Interface::BasePage.new(doc, **opts)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/model/pages_workflow.rb

@@ -0,0 +1,20 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        class PagesWorkflow < Base::PagesWorkflow
+          SCHEMA_VERSION = '20260605'.freeze
+
+          class_resolver :command_connection_class,
+                         'Ecoportal::API::GraphQL::Connection::PagesWorkflowCommand'
+
+          class_resolver :operation_class,
+                         'Ecoportal::API::GraphQL::Base::PagesWorkflow::OperationUnion'
+
+          class_resolver :trigger_class,
+                         'Ecoportal::API::GraphQL::Base::PagesWorkflow::TriggerUnion'
+        end
+      end
+    end
+  end
+end

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

@@ -1,15 +1,15 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Model
-        class PersonMember < Base::PersonMember
-          embeds_one :contractorOrganization, klass: "Ecoportal::API::GraphQL::Model::ContractorEntity"
-          embeds_one :account, klass: Model::Account
-
-          # embeds_many :privateFields, enum_class: Ecoportal::API::GraphQL::Model::MemberSchemaFields
-          # embeds_many :publicFields, enum_class: Ecoportal::API::GraphQL::Model::MemberSchemaFields
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        class PersonMember < Base::PersonMember
+          embeds_one :contractorOrganization, klass: "Ecoportal::API::GraphQL::Model::ContractorEntity"
+          embeds_one :account, klass: Model::Account
+
+          # embeds_many :privateFields, enum_class: Ecoportal::API::GraphQL::Model::MemberSchemaFields
+          # embeds_many :publicFields, enum_class: Ecoportal::API::GraphQL::Model::MemberSchemaFields
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,10 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        class PresetView < Base::PresetView
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,10 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        class PreviewPage < Base::PreviewPage
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/model/register.rb

@@ -0,0 +1,10 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        class Register < Base::Register
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,15 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        # Concrete counterparts of `Base::Template::*` (see there for the page-vs-Template
+        # type asymmetry). No extra wiring needed — both are flat, read-only models.
+        module Template
+          class Information < Base::Template::Information; end
+
+          class RelatedPages < Base::Template::RelatedPages; end
+        end
+      end
+    end
+  end
+end

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

@@ -1,22 +1,32 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Model
-      end
-    end
-  end
-end
-
-require_relative 'model/location_node'
-require_relative 'model/location_structure'
-require_relative 'model/account'
-require_relative 'model/user'
-require_relative 'model/person_member'
-require_relative 'model/file_attachment'
-require_relative 'model/file_container'
-require_relative 'model/field'
-require_relative 'model/page'
-require_relative 'model/resource'
-require_relative 'model/action'
-require_relative 'model/contractor_entity'
-require_relative 'model/organization'
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+      end
+    end
+  end
+end
+
+require_relative 'model/location_node'
+require_relative 'model/location_structure'
+require_relative 'model/account'
+require_relative 'model/user'
+require_relative 'model/person_member'
+require_relative 'model/file_attachment'
+require_relative 'model/file_container'
+require_relative 'model/field'
+require_relative 'model/page'
+require_relative 'model/page_union'
+require_relative 'model/preview_page'
+require_relative 'model/resource'
+require_relative 'model/action'
+require_relative 'model/contractor_entity'
+require_relative 'model/organization'
+
+require_relative 'model/register'
+require_relative 'model/preset_view'
+
+require_relative 'model/ai_summary_version'
+require_relative 'model/pages_workflow'
+
+require_relative 'model/template'

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

@@ -29,7 +29,7 @@ module Ecoportal
                   fullMessages
                 }
                 item {
-                  ___Fragment__Action
+                  spread :Action
                 }
               }
             end

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

@@ -28,7 +28,7 @@ module Ecoportal
                   fullMessages
                 }
                 item {
-                  ___Fragment__Action
+                  spread :Action
                 }
               }
             end

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

@@ -28,7 +28,7 @@ module Ecoportal
                   fullMessages
                 }
                 item {
-                  ___Fragment__Action
+                  spread :Action
                 }
               }
             end

data/lib/ecoportal/api/graphql/mutation/ai_summary/generate.rb

@@ -0,0 +1,45 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module AiSummary
+          # Triggers AI summary generation for a page or stage.
+          # Returns an AiSummaryVersion with the generated text and token usage.
+          # Generation is synchronous — the response contains the result or an error.
+          #
+          # stageId is optional: omit for page-level summary, provide for stage-level.
+          class Generate < Logic::Mutation
+            field_name :generateAiSummary
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::AiSummaryGenerate'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(pageId: :id!, stageId: :id) {
+                  generateAiSummary(pageId: :pageId, stageId: :stageId, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                errors { details fullMessages }
+                item {
+                  id
+                  aiSummary
+                  status
+                  inputTokens
+                  outputTokens
+                  totalTokens
+                }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end