ecoportal-api-graphql 2.0.0 → 2.2.0

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

@@ -1,39 +1,39 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PagesWorkflow
-          class OperationInterface < Logic::BaseModel
-            SCHEMA_VERSION = '20260605'.freeze
-
-            passkey :id
-            passdate :delayedExecuteAt
-            passboolean :timeDelayPassed
-
-            class_resolver :time_delay_config_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::TimeDelayConfig'
-
-            embeds_one :timeDelayConfig, klass: :time_delay_config_class
-
-            require_relative 'operations/assign_to'
-            require_relative 'operations/create_page'
-            require_relative 'operations/send_notification'
-
-            def self.from_doc(raw_doc)
-              case raw_doc&.fetch('__typename', nil)
-              when 'PagesWorkflowOperationsAssignTo'
-                Operations::AssignTo.new(raw_doc)
-              when 'PagesWorkflowOperationsCreatePage'
-                Operations::CreatePage.new(raw_doc)
-              when 'PagesWorkflowOperationsSendNotification'
-                Operations::SendNotification.new(raw_doc)
-              else
-                new(raw_doc)
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class OperationInterface < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passdate :delayedExecuteAt
+            passboolean :timeDelayPassed
+
+            class_resolver :time_delay_config_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::TimeDelayConfig'
+
+            embeds_one :timeDelayConfig, klass: :time_delay_config_class
+
+            require_relative 'operations/assign_to'
+            require_relative 'operations/create_page'
+            require_relative 'operations/send_notification'
+
+            def self.from_doc(raw_doc)
+              case raw_doc&.fetch('__typename', nil)
+              when 'PagesWorkflowOperationsAssignTo'
+                Operations::AssignTo.new(raw_doc)
+              when 'PagesWorkflowOperationsCreatePage'
+                Operations::CreatePage.new(raw_doc)
+              when 'PagesWorkflowOperationsSendNotification'
+                Operations::SendNotification.new(raw_doc)
+              else
+                new(raw_doc)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/operations/assign_to.rb

@@ -1,27 +1,27 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PagesWorkflow
-          module Operations
-            class AssignTo < OperationInterface
-              SCHEMA_VERSION = '20260605'.freeze
-
-              passthrough :targetTaskType
-              passboolean :lastFulfilled
-
-              class_resolver :escalation_level_class,
-                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::EscalationLevel'
-
-              embeds_many :escalationLevels, klass: :escalation_level_class, read_only: true
-
-              def strategies
-                @strategies ||= Array(doc['strategies'] || [])
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          module Operations
+            class AssignTo < OperationInterface
+              SCHEMA_VERSION = '20260605'.freeze
+
+              passthrough :targetTaskType
+              passboolean :lastFulfilled
+
+              class_resolver :escalation_level_class,
+                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::EscalationLevel'
+
+              embeds_many :escalationLevels, klass: :escalation_level_class, read_only: true
+
+              def strategies
+                @strategies ||= Array(doc['strategies'] || [])
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/operations/send_notification.rb

@@ -1,30 +1,30 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PagesWorkflow
-          module Operations
-            class SendNotification < OperationInterface
-              SCHEMA_VERSION = '20260605'.freeze
-
-              passboolean :recurring, :recurrenceActive
-              passthrough :recurrenceCount, :recurrenceEndCount, :recurrenceEndType
-              passdate :nextRecurrenceAt
-
-              class_resolver :email_config_class,
-                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::EmailConfig'
-              class_resolver :in_system_config_class,
-                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::InSystemConfig'
-              class_resolver :recipient_config_class,
-                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::RecipientConfig'
-
-              embeds_one :emailConfig, klass: :email_config_class
-              embeds_one :inSystemConfig, klass: :in_system_config_class
-              embeds_one :recipientConfig, klass: :recipient_config_class
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          module Operations
+            class SendNotification < OperationInterface
+              SCHEMA_VERSION = '20260605'.freeze
+
+              passboolean :recurring, :recurrenceActive
+              passthrough :recurrenceCount, :recurrenceEndCount, :recurrenceEndType
+              passdate :nextRecurrenceAt
+
+              class_resolver :email_config_class,
+                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::EmailConfig'
+              class_resolver :in_system_config_class,
+                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::InSystemConfig'
+              class_resolver :recipient_config_class,
+                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::RecipientConfig'
+
+              embeds_one :emailConfig, klass: :email_config_class
+              embeds_one :inSystemConfig, klass: :in_system_config_class
+              embeds_one :recipientConfig, klass: :recipient_config_class
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,34 +1,34 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PagesWorkflow
-          class RecipientConfig < Logic::BaseModel
-            SCHEMA_VERSION = '20260605'.freeze
-
-            passboolean :allActiveUsers, :includeActionAssignees, :includeMailboxFields
-            passboolean :includePageCreator, :includePeopleFields, :includeTaskAssignees
-            passboolean :limitByPageTags
-
-            class_resolver :action_type_selection_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::ActionTypeSelection'
-            class_resolver :mailbox_field_selection_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::MailboxFieldSelection'
-            class_resolver :people_field_selection_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::PeopleFieldSelection'
-            class_resolver :task_config_selection_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::TaskConfigSelection'
-            class_resolver :user_selection_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::UserSelection'
-
-            embeds_many :actionTypeSelections, klass: :action_type_selection_class, read_only: true
-            embeds_many :mailboxFieldSelections, klass: :mailbox_field_selection_class, read_only: true
-            embeds_many :peopleFieldSelections, klass: :people_field_selection_class, read_only: true
-            embeds_many :taskConfigSelections, klass: :task_config_selection_class, read_only: true
-            embeds_many :userSelections, klass: :user_selection_class, read_only: true
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class RecipientConfig < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passboolean :allActiveUsers, :includeActionAssignees, :includeMailboxFields
+            passboolean :includePageCreator, :includePeopleFields, :includeTaskAssignees
+            passboolean :limitByPageTags
+
+            class_resolver :action_type_selection_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::ActionTypeSelection'
+            class_resolver :mailbox_field_selection_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::MailboxFieldSelection'
+            class_resolver :people_field_selection_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::PeopleFieldSelection'
+            class_resolver :task_config_selection_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::TaskConfigSelection'
+            class_resolver :user_selection_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::UserSelection'
+
+            embeds_many :actionTypeSelections, klass: :action_type_selection_class, read_only: true
+            embeds_many :mailboxFieldSelections, klass: :mailbox_field_selection_class, read_only: true
+            embeds_many :peopleFieldSelections, klass: :people_field_selection_class, read_only: true
+            embeds_many :taskConfigSelections, klass: :task_config_selection_class, read_only: true
+            embeds_many :userSelections, klass: :user_selection_class, read_only: true
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,35 +1,35 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PagesWorkflow < Logic::BaseModel
-          SCHEMA_VERSION = '20260605'.freeze
-
-          passboolean :autoPageCreationEnabled
-          passarray :stages
-
-          class_resolver :register_field_class,
-                         'Ecoportal::API::GraphQL::Base::PagesWorkflow::RegisterField'
-
-          embeds_many :fields, klass: :register_field_class, read_only: true
-
-          require_relative 'pages_workflow/register_field'
-          require_relative 'pages_workflow/time_delay_config'
-          require_relative 'pages_workflow/escalation_level'
-          require_relative 'pages_workflow/user_selection'
-          require_relative 'pages_workflow/mailbox_field_selection'
-          require_relative 'pages_workflow/people_field_selection'
-          require_relative 'pages_workflow/task_config_selection'
-          require_relative 'pages_workflow/action_type_selection'
-          require_relative 'pages_workflow/email_config'
-          require_relative 'pages_workflow/in_system_config'
-          require_relative 'pages_workflow/recipient_config'
-          require_relative 'pages_workflow/trigger_interface'
-          require_relative 'pages_workflow/operation_interface'
-          require_relative 'pages_workflow/callback_type'
-          require_relative 'pages_workflow/command_interface'
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow < Logic::BaseModel
+          SCHEMA_VERSION = '20260605'.freeze
+
+          passboolean :autoPageCreationEnabled
+          passarray :stages
+
+          class_resolver :register_field_class,
+                         'Ecoportal::API::GraphQL::Base::PagesWorkflow::RegisterField'
+
+          embeds_many :fields, klass: :register_field_class, read_only: true
+
+          require_relative 'pages_workflow/register_field'
+          require_relative 'pages_workflow/time_delay_config'
+          require_relative 'pages_workflow/escalation_level'
+          require_relative 'pages_workflow/user_selection'
+          require_relative 'pages_workflow/mailbox_field_selection'
+          require_relative 'pages_workflow/people_field_selection'
+          require_relative 'pages_workflow/task_config_selection'
+          require_relative 'pages_workflow/action_type_selection'
+          require_relative 'pages_workflow/email_config'
+          require_relative 'pages_workflow/in_system_config'
+          require_relative 'pages_workflow/recipient_config'
+          require_relative 'pages_workflow/trigger_interface'
+          require_relative 'pages_workflow/operation_interface'
+          require_relative 'pages_workflow/callback_type'
+          require_relative 'pages_workflow/command_interface'
+        end
+      end
+    end
+  end
+end

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

@@ -1,22 +1,22 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PersonMember < Logic::BaseModel
-          root!
-
-          passkey :id
-          passthrough :name, :email
-          passarray :tagRestrict, :userGroupIds
-
-          passthrough :personSchemaId
-
-          passthrough :contractorOrganizationId
-          passthrough :userId
-
-          passboolean :tracingAdmin
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PersonMember < Logic::BaseModel
+          root!
+
+          passkey :id
+          passthrough :name, :email
+          passarray :tagRestrict, :userGroupIds
+
+          passthrough :personSchemaId
+
+          passthrough :contractorOrganizationId
+          passthrough :userId
+
+          passboolean :tracingAdmin
+        end
+      end
+    end
+  end
+end

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

@@ -1,23 +1,23 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        # Elasticsearch-backed preview of a page, returned by register.previewPages.
-        # Read-only. No patchVer, no typed data field models, no field IDs.
-        # Use for fast metadata lookup only — switch to org search (pages) for full data.
-        class PreviewPage < Logic::BaseModel
-          read_only!
-
-          passkey :id
-          passthrough :uid, :name, :state, :archived
-          passthrough :creatorName, :externalId
-          passdate :createdAt, :updatedAt
-
-          # locations, dataFields, stages returned as raw arrays — typed access not needed
-          # for a read-only ES-backed preview model. Use org search for typed field access.
-          passarray :locations, :dataFields, :stages, :tags
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # Elasticsearch-backed preview of a page, returned by register.previewPages.
+        # Read-only. No patchVer, no typed data field models, no field IDs.
+        # Use for fast metadata lookup only — switch to org search (pages) for full data.
+        class PreviewPage < Logic::BaseModel
+          read_only!
+
+          passkey :id
+          passthrough :uid, :name, :state, :archived
+          passthrough :creatorName, :externalId
+          passdate :createdAt, :updatedAt
+
+          # locations, dataFields, stages returned as raw arrays — typed access not needed
+          # for a read-only ES-backed preview model. Use org search for typed field access.
+          passarray :locations, :dataFields, :stages, :tags
+        end
+      end
+    end
+  end
+end

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

@@ -1,4 +1,4 @@
-module Ecoportal
+module Ecoportal
   module API
     class GraphQL
       module Base

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