ecoportal-api-graphql 1.3.5 → 1.3.9

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.rb

@@ -9,6 +9,7 @@ module Ecoportal
   end
 end
 
+require_relative 'page/basic'
 require_relative 'page/data_field'
 require_relative 'page/section'
 require_relative 'page/phased'

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/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.rb

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

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

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

@@ -0,0 +1,40 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module AiSummary
+          # Submit a thumbs-up / thumbs-down rating on an AI summary version.
+          # sentiment: "THUMBS_UP" | "THUMBS_DOWN"
+          # aiSummaryVersionId: returned from generateAiSummary.item.id
+          class SubmitFeedback < Logic::Mutation
+            field_name :submitAiSummaryFeedback
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::OkPayload'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(aiSummaryVersionId: :id!, sentiment: :AiSummarySentimentEnum!) {
+                  submitAiSummaryFeedback(
+                    aiSummaryVersionId: :aiSummaryVersionId,
+                    sentiment:          :sentiment,
+                    &payload_block
+                  )
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                ok
+                errors { details fullMessages }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module AiSummary
+        end
+      end
+    end
+  end
+end
+
+require_relative 'ai_summary/generate'
+require_relative 'ai_summary/submit_feedback'

data/lib/ecoportal/api/graphql/mutation/kickstand/bulk_update_jobs.rb

@@ -0,0 +1,43 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Kickstand
+          class BulkUpdateJobs < Logic::Mutation
+            SCHEMA_VERSION = '20260605'.freeze
+
+            field_name :bulkUpdateKickstandJobs
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Kickstand::BulkUpdateJobs'
+
+            def query(ids:, start: false, failure: false, **kargs, &block)
+              super(
+                input: { ids: ids, start: start, failure: failure },
+                **kargs,
+                &block
+              )
+            end
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :BulkUpdateJobsInput!) {
+                  bulkUpdateKickstandJobs(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                items { id status }
+                errors { details fullMessages }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/mutation/kickstand/bulk_update_workflows.rb

@@ -0,0 +1,43 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Kickstand
+          class BulkUpdateWorkflows < Logic::Mutation
+            SCHEMA_VERSION = '20260605'.freeze
+
+            field_name :bulkUpdateKickstandWorkflows
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Kickstand::BulkUpdateWorkflows'
+
+            def query(ids:, start: false, stop: false, failure: false, **kargs, &block)
+              super(
+                input: { ids: ids, start: start, stop: stop, failure: failure },
+                **kargs,
+                &block
+              )
+            end
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :BulkUpdateWorkflowsInput!) {
+                  bulkUpdateKickstandWorkflows(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                items { id name status }
+                errors { details fullMessages }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/mutation/kickstand/fail_job.rb

@@ -0,0 +1,39 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Kickstand
+          class FailJob < Logic::Mutation
+            SCHEMA_VERSION = '20260605'.freeze
+
+            field_name :failKickstandJob
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Kickstand::Job'
+
+            def query(id:, **kargs, &block)
+              super(input: { id: id }, **kargs, &block)
+            end
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :FailJobInput!) {
+                  failKickstandJob(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                item { id status }
+                errors { details fullMessages }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/mutation/kickstand/fail_workflow.rb

@@ -0,0 +1,39 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Kickstand
+          class FailWorkflow < Logic::Mutation
+            SCHEMA_VERSION = '20260605'.freeze
+
+            field_name :failKickstandWorkflow
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Kickstand::Workflow'
+
+            def query(id:, **kargs, &block)
+              super(input: { id: id }, **kargs, &block)
+            end
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :FailWorkflowInput!) {
+                  failKickstandWorkflow(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                item { id name status failedAt }
+                errors { details fullMessages }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/mutation/kickstand/start_job.rb

@@ -0,0 +1,39 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Kickstand
+          class StartJob < Logic::Mutation
+            SCHEMA_VERSION = '20260605'.freeze
+
+            field_name :startKickstandJob
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Kickstand::Job'
+
+            def query(id:, **kargs, &block)
+              super(input: { id: id }, **kargs, &block)
+            end
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :StartJobInput!) {
+                  startKickstandJob(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                item { id status }
+                errors { details fullMessages }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end