ecoportal-api-graphql 1.3.16 → 2.2.0

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

@@ -1,13 +1,13 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class Resource < Logic::BaseModel
-          passkey :id
-          passthrough :fieldId, :pageId
-          passarray :stageIds
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class Resource < Logic::BaseModel
+          passkey :id
+          passthrough :fieldId, :pageId
+          passarray :stageIds
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/template/change_log_entry.rb

@@ -0,0 +1,118 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Template
+          # One entry of a TEMPLATE's change log — a single command the platform recorded
+          # against the template. Read-only.
+          #
+          # ── Where it comes from (verified in the Rails backend on 2026-08-19) ────────────
+          # `app/graphql/types/pages/template_type.rb` declares
+          #   field :commands, Types::Pages::Interfaces::WorkflowCommandInterface.connection_type
+          # and resolves it as
+          #   NewEp::Pages::Workflows::Commands::Base.where(page: object.page)
+          #                                          .from_template_builder.order(_id: :desc)
+          #
+          # The narrow `Template` type itself is reachable as `template { ... }` on any page,
+          # because `app/graphql/types/pages/interfaces/base_page_interface.rb:27` declares
+          #   field :template, Types::Pages::TemplateType, null: true
+          #
+          # ── ★ TWO ACCESS CAVEATS — both are silent, neither raises ─────────────────────
+          # 1. `commands` returns **nil**, not an empty connection, unless the caller satisfies
+          #    `Pages::TemplatePolicy#update_information?` (`return unless allowed_to?(...)`).
+          #    A read-only account therefore sees NO change log and gets no error saying so.
+          #    Treat a nil connection as "not permitted", never as "nothing changed".
+          # 2. The scope is `.from_template_builder` — only `TEMPLATE_BUILDER`-sourced commands
+          #    appear. `WORKFLOW_BUILDER` commands against the same page are EXCLUDED
+          #    (`app/models/new_ep/pages/workflows/commands/base.rb`, `enum_field :feature_source`
+          #    with values WORKFLOW_BUILDER / TEMPLATE_BUILDER). For the workflow-builder side of
+          #    the same log see `Query::PagesWorkflowCommands`.
+          # Ordering is `_id: :desc` — newest first, server-side, not configurable.
+          #
+          # ── ★ WHY THIS LOG BEATS POLLING A WATERMARK ──────────────────────────────────
+          # `app/services/new_ep/pages/run_merged_forces.rb:17` writes with
+          #   @page.timeless.skip_patch_incr.rewrite(only_if: { updated_at: @page.updated_at.utc })
+          # so a forces run bumps NEITHER `patchVer` NOR `updatedAt`. Any change tracker that
+          # polls a watermark is structurally blind to force-driven change; the command log is
+          # per-change and cannot be skipped that way.
+          # (OPEN: whether forces run against TEMPLATES specifically is NOT confirmed — do not
+          # assume either way.)
+          #
+          # ── Field set ─────────────────────────────────────────────────────────────────
+          # These are the fields of the INTERFACE `PagesWorkflowCommandInterface` only
+          # (`app/graphql/types/pages/interfaces/workflow_command_interface.rb`). The concrete
+          # implementing types add their own (`PagesWorkflowCommandChange.changes`,
+          # `PagesWorkflowCommandChangeMessage.changeMessages`,
+          # `PagesWorkflowCommandEsChange.changes`); `__typename` is passed through so a caller
+          # can branch, and those extras can be selected with an inline fragment or by reusing
+          # `Fragment :PagesWorkflowCommandFields`.
+          #
+          # Enum-valued fields are exposed as plain strings:
+          # - commandAction: WorkflowCommandActionEnum
+          class ChangeLogEntry < Logic::BaseModel
+            read_only!
+
+            passkey :id
+            # Concrete type name: 'PagesWorkflowCommandChange' | 'PagesWorkflowCommandChangeMessage'
+            # | 'PagesWorkflowCommandEsChange'.
+            passthrough :__typename
+            passthrough :commandAction
+            # Optimistic-concurrency token the command was recorded against (Int!).
+            passthrough :patchVer
+            # `owner` (the UserType embed) is added in Model::Template::ChangeLogEntry — Base
+            # loads before Model.
+            passthrough :ownerId
+            passthrough :stageId, :stageName
+            passthrough :taskId, :taskType
+            # What the command acted on. Resolved server-side from `targeted_resource` and
+            # nil for commands that target nothing.
+            passthrough :targetedResourceId, :targetedResourceName, :targetedResourceType
+
+            # `createdAt`/`updatedAt` are `DateTimeType` OBJECTS ({ dateTime, timeZone }), not
+            # scalars — hence an embed rather than `passdate`. Use `entry.createdAt.dateTime`.
+            embeds_one :createdAt, klass: Base::DateTime
+            embeds_one :updatedAt, klass: Base::DateTime
+
+            # ── What actually changed (only populated by the DETAIL selection) ──────────
+            # Present only when the node was selected with `Fragment :TemplateChangeLogEntryDetail`
+            # (see `Query::TemplateChangeLog.detail_block` / `api.template.change_log(detail: true)`).
+            # With the default light selection both readers are empty — empty means
+            # "not selected", NOT "nothing changed", exactly like the nil-connection caveat above.
+            #
+            # Deliberately raw hashes rather than a typed embed: the two `changes`-bearing types
+            # do not share a shape (`ChangeType.from/to` are Strings;
+            # `StoredEsFilterChangeType.from/to` are objects), so one typed model would have to
+            # lie about one of them. This mirrors `Base::PagesWorkflow::CommandChange#changes`,
+            # which does the same for the workflow-builder side of the same interface.
+            def changes
+              Array(doc['changes'])
+            end
+
+            passarray :changeMessages
+
+            # Which of the three concrete command types this entry is, as a symbol:
+            # :changes | :change_messages | :es_changes | nil (unknown/unselected `__typename`).
+            # Use it instead of string-matching `__typename` at call sites.
+            DETAIL_KINDS = {
+              'PagesWorkflowCommandChange'        => :changes,
+              'PagesWorkflowCommandChangeMessage' => :change_messages,
+              'PagesWorkflowCommandEsChange'      => :es_changes
+            }.freeze
+
+            def detail_kind
+              DETAIL_KINDS[__typename]
+            end
+
+            # True when this entry carries field-level detail. False both when the light
+            # selection was used and when a command genuinely recorded no changes -- those two
+            # are indistinguishable from the response alone, which is why the caller should know
+            # which selection it asked for.
+            def detail?
+              !changes.empty? || !changeMessages.to_a.empty?
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -28,6 +28,8 @@ module Ecoportal
             passthrough :title, :registerId
             passboolean :hasInaccessibleVariables
           end
+
+          require_relative 'template/change_log_entry'
         end
       end
     end

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

@@ -20,13 +20,22 @@ require_relative 'base/page'
 require_relative 'base/resource'
 require_relative 'base/action_category'
 require_relative 'base/action'
+require_relative 'base/action_event_page'
+require_relative 'base/action_event'
 require_relative 'base/contractor_entity'
 require_relative 'base/preview_page'
 require_relative 'base/delta_result'
+require_relative 'base/authorization_result'
+require_relative 'base/permissions'
+require_relative 'base/activity'
+require_relative 'base/activity_log'
+require_relative 'base/auth_log'
+require_relative 'base/person_member_changelog'
 require_relative 'base/organization'
 
 require_relative 'base/register'
 require_relative 'base/preset_view'
+require_relative 'base/minimal_dashboard'
 
 require_relative 'base/ai_summary_version'
 

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

@@ -1,41 +1,41 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Builder
-        class Action
-          attr_reader :client
-
-          def initialize(client)
-            @client = client
-          end
-
-          def archive(**kargs, &block)
-            archiveMutation.query(**kargs, &block)
-          end
-
-          def update(**kargs, &block)
-            updateMutation.query(**kargs, &block)
-          end
-
-          def create(**kargs, &block)
-            createMutation.query(**kargs, &block)
-          end
-
-          private
-
-          def archiveMutation
-            Mutation::Action::Archive.new(client)
-          end
-
-          def updateMutation
-            Mutation::Action::Update.new(client)
-          end
-
-          def createMutation
-            Mutation::Action::Create.new(client)
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class Action
+          attr_reader :client
+
+          def initialize(client)
+            @client = client
+          end
+
+          def archive(**kargs, &block)
+            archiveMutation.query(**kargs, &block)
+          end
+
+          def update(**kargs, &block)
+            updateMutation.query(**kargs, &block)
+          end
+
+          def create(**kargs, &block)
+            createMutation.query(**kargs, &block)
+          end
+
+          private
+
+          def archiveMutation
+            Mutation::Action::Archive.new(client)
+          end
+
+          def updateMutation
+            Mutation::Action::Update.new(client)
+          end
+
+          def createMutation
+            Mutation::Action::Create.new(client)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -21,6 +21,12 @@ module Ecoportal
             destroyMutation.query(**kargs, &block)
           end
 
+          # updateContractorManagerSettings — auto-approval settings + whether
+          # contractor admins may add other admins. Returns the updated Organization.
+          def update_manager_settings(**kargs, &block)
+            updateManagerSettingsMutation.query(**kargs, &block)
+          end
+
           private
 
           def createMutation
@@ -34,6 +40,10 @@ module Ecoportal
           def destroyMutation
             Mutation::ContractorEntity::Destroy.new(client)
           end
+
+          def updateManagerSettingsMutation
+            Mutation::ContractorEntity::UpdateManagerSettings.new(client)
+          end
         end
       end
     end

data/lib/ecoportal/api/graphql/builder/location_structure/draft.rb

@@ -1,64 +1,64 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Builder
-        class LocationStructure
-          class Draft
-            attr_reader :client, :parent
-
-            def initialize(client, parent:)
-              @client = client
-              @parent = parent
-            end
-
-            def nodeClassifications(**kargs, &block)
-              parent.nodeClassifications(**kargs, &block)
-            end
-
-            def create(**kargs, &block)
-              createMutation.query(**kargs, &block)
-            end
-
-            def addCommands(**kargs, &block)
-              addCommandsMutation.query(**kargs, &block)
-            end
-
-            def delete(**kargs, &block)
-              deleteMutation.query(**kargs, &block)
-            end
-
-            def publish(**kargs, &block)
-              publishMutation.query(**kargs, &block)
-            end
-
-            def DropBadCommands(**kargs, &block)
-              dropBadCommandsMutation.query(**kargs, &block)
-            end
-
-            private
-
-            def createMutation
-              Mutation::LocationStructure::Draft::Create.new(client)
-            end
-
-            def addCommandsMutation
-              Mutation::LocationStructure::Draft::AddCommands.new(client)
-            end
-
-            def deleteMutation
-              Mutation::LocationStructure::Draft::Delete.new(client)
-            end
-
-            def publishMutation
-              Mutation::LocationStructure::Draft::Publish.new(client)
-            end
-
-            def dropBadCommandsMutation
-              Mutation::LocationStructure::Draft::DropBadCommands.new(client)
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class LocationStructure
+          class Draft
+            attr_reader :client, :parent
+
+            def initialize(client, parent:)
+              @client = client
+              @parent = parent
+            end
+
+            def nodeClassifications(**kargs, &block)
+              parent.nodeClassifications(**kargs, &block)
+            end
+
+            def create(**kargs, &block)
+              createMutation.query(**kargs, &block)
+            end
+
+            def addCommands(**kargs, &block)
+              addCommandsMutation.query(**kargs, &block)
+            end
+
+            def delete(**kargs, &block)
+              deleteMutation.query(**kargs, &block)
+            end
+
+            def publish(**kargs, &block)
+              publishMutation.query(**kargs, &block)
+            end
+
+            def DropBadCommands(**kargs, &block)
+              dropBadCommandsMutation.query(**kargs, &block)
+            end
+
+            private
+
+            def createMutation
+              Mutation::LocationStructure::Draft::Create.new(client)
+            end
+
+            def addCommandsMutation
+              Mutation::LocationStructure::Draft::AddCommands.new(client)
+            end
+
+            def deleteMutation
+              Mutation::LocationStructure::Draft::Delete.new(client)
+            end
+
+            def publishMutation
+              Mutation::LocationStructure::Draft::Publish.new(client)
+            end
+
+            def dropBadCommandsMutation
+              Mutation::LocationStructure::Draft::DropBadCommands.new(client)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/builder/location_structure.rb

@@ -1,40 +1,40 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Builder
-        class LocationStructure
-          attr_reader :client
-
-          def initialize(client)
-            @client = client
-          end
-
-          def nodeClassifications(**kargs, &block)
-            query_model = Query::LocationClassifications.new(client)
-            query_model.query(**kargs, &block)
-          end
-
-          def applyCommandsInput
-            Input::LocationStructure::ApplyCommands.new
-          end
-
-          def applyCommands(**kargs, &block)
-            applyCommandsMutation.query(**kargs, &block)
-          end
-
-          def draft
-            LocationStructure::Draft.new(client, parent: self)
-          end
-
-          private
-
-          def applyCommandsMutation
-            Mutation::LocationStructure::ApplyCommands.new(client)
-          end
-        end
-      end
-    end
-  end
-end
-
-require_relative 'location_structure/draft'
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class LocationStructure
+          attr_reader :client
+
+          def initialize(client)
+            @client = client
+          end
+
+          def nodeClassifications(**kargs, &block)
+            query_model = Query::LocationClassifications.new(client)
+            query_model.query(**kargs, &block)
+          end
+
+          def applyCommandsInput
+            Input::LocationStructure::ApplyCommands.new
+          end
+
+          def applyCommands(**kargs, &block)
+            applyCommandsMutation.query(**kargs, &block)
+          end
+
+          def draft
+            LocationStructure::Draft.new(client, parent: self)
+          end
+
+          private
+
+          def applyCommandsMutation
+            Mutation::LocationStructure::ApplyCommands.new(client)
+          end
+        end
+      end
+    end
+  end
+end
+
+require_relative 'location_structure/draft'

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

@@ -105,14 +105,6 @@ module Ecoportal
             submitAiSummaryFeedbackMutation.query(**kargs, &block)
           end
 
-          def generate_smart_fill(**kargs, &block)
-            generateSmartFillMutation.query(**kargs, &block)
-          end
-
-          def submit_smart_fill_feedback(**kargs, &block)
-            submitSmartFillFeedbackMutation.query(**kargs, &block)
-          end
-
           private
 
           # Blank the page's externalId via updatePage (no patchVer needed — cleanup path).
@@ -184,14 +176,6 @@ module Ecoportal
             Mutation::AiSummary::SubmitFeedback.new(client)
           end
 
-          def generateSmartFillMutation
-            Mutation::SmartFill::Generate.new(client)
-          end
-
-          def submitSmartFillFeedbackMutation
-            Mutation::SmartFill::SubmitFeedback.new(client)
-          end
-
           def executeWorkflowCommandsMutation
             Mutation::Page::ExecuteWorkflowCommands.new(client)
           end