ecoportal-api-graphql 2.0.0 → 3.0.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/temp_image.rb

@@ -0,0 +1,28 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # The upload-staging model behind `uploadImage` -- explicitly NOT a `FileContainer`.
+        # Verified against the live ecoPortal server schema (read-only,
+        # /tmp/work/ecoPortal): `Types::Files::TempImageType` (`app/graphql/types/files/
+        # temp_image_type.rb`) declares exactly `id s3Key error complete`, backed by
+        # `Enzyme::ImageReference::TempImage` (`app/models/enzyme/image_reference.rb`), a
+        # separate upload-staging Mongoid model from `FileContainer`.
+        #
+        # `complete` starts `false` immediately after `uploadImage` returns and is filled in
+        # later by background processing. A consumer does NOT need to wait for it: confirmed
+        # server-side (`app/services/new_ep/pages/assign_attributes_service.rb`'s
+        # `set_image_gallery_attrs`) that attaching a `TempImage` to an Image Gallery field via
+        # `ImageInput.sourceId` succeeds whether or not `complete?`/`error?` is true yet -- an
+        # incomplete image is accepted and filled in on the record later.
+        class TempImage < Logic::BaseModel
+          read_only!
+
+          passkey     :id
+          passthrough :s3Key, :error
+          passboolean :complete
+        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

@@ -15,6 +15,7 @@ require_relative 'base/location_structure'
 require_relative 'base/person_member'
 require_relative 'base/file_attachment'
 require_relative 'base/file_container'
+require_relative 'base/temp_image'
 require_relative 'base/field'
 require_relative 'base/page'
 require_relative 'base/resource'

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

@@ -1,84 +1,84 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Builder
-        class Register
-          # Sub-builder for preset view operations within a register context.
-          # Access via: api.register.preset_view
-          #
-          # Usage:
-          #   pv = api.register.preset_view
-          #
-          #   # List preset views for a register (find IDs for presetViewId in searches)
-          #   views = pv.list('REG_ID')
-          #   views.map { |v| "#{v.name} (#{v.id}) global=#{v.global?}" }
-          #
-          #   # Create a preset view
-          #   pv.create(input: {
-          #     registerId:     'REG_ID',
-          #     name:           'Active Pages',
-          #     customPresetView: true,
-          #     fieldConfigs:   [{ key: 'name', weight: 0 }, { key: 'state', weight: 1 }],
-          #     sorter:         { key: 'created_at', direction: 'desc' }
-          #   })
-          #
-          #   # Share with a user (view access)
-          #   pv.permission(input: {
-          #     id:          'VIEW_ID',
-          #     permissions: [{ level: 'view', to: { userId: 'USER_ID' } }]
-          #   })
-          class PresetView
-            attr_reader :client
-
-            def initialize(client)
-              @client = client
-            end
-
-            # List all preset views for a register. Returns an array of PresetView objects.
-            def list(register_id, search_conf: nil, &block)
-              Query::RegisterPresetViews.new(client).query(
-                registerId: register_id,
-                searchConf: search_conf,
-                &block
-              ).nodes
-            end
-
-            def create(**kargs, &block)
-              createMutation.query(**kargs, &block)
-            end
-
-            def update(**kargs, &block)
-              updateMutation.query(**kargs, &block)
-            end
-
-            def permission(**kargs, &block)
-              permissionMutation.query(**kargs, &block)
-            end
-
-            def destroy(**kargs, &block)
-              destroyMutation.query(**kargs, &block)
-            end
-
-            private
-
-            def createMutation
-              Mutation::PresetView::Create.new(client)
-            end
-
-            def updateMutation
-              Mutation::PresetView::Update.new(client)
-            end
-
-            def permissionMutation
-              Mutation::PresetView::Permission.new(client)
-            end
-
-            def destroyMutation
-              Mutation::PresetView::Destroy.new(client)
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class Register
+          # Sub-builder for preset view operations within a register context.
+          # Access via: api.register.preset_view
+          #
+          # Usage:
+          #   pv = api.register.preset_view
+          #
+          #   # List preset views for a register (find IDs for presetViewId in searches)
+          #   views = pv.list('REG_ID')
+          #   views.map { |v| "#{v.name} (#{v.id}) global=#{v.global?}" }
+          #
+          #   # Create a preset view
+          #   pv.create(input: {
+          #     registerId:     'REG_ID',
+          #     name:           'Active Pages',
+          #     customPresetView: true,
+          #     fieldConfigs:   [{ key: 'name', weight: 0 }, { key: 'state', weight: 1 }],
+          #     sorter:         { key: 'created_at', direction: 'desc' }
+          #   })
+          #
+          #   # Share with a user (view access)
+          #   pv.permission(input: {
+          #     id:          'VIEW_ID',
+          #     permissions: [{ level: 'view', to: { userId: 'USER_ID' } }]
+          #   })
+          class PresetView
+            attr_reader :client
+
+            def initialize(client)
+              @client = client
+            end
+
+            # List all preset views for a register. Returns an array of PresetView objects.
+            def list(register_id, search_conf: nil, &block)
+              Query::RegisterPresetViews.new(client).query(
+                registerId: register_id,
+                searchConf: search_conf,
+                &block
+              ).nodes
+            end
+
+            def create(**kargs, &block)
+              createMutation.query(**kargs, &block)
+            end
+
+            def update(**kargs, &block)
+              updateMutation.query(**kargs, &block)
+            end
+
+            def permission(**kargs, &block)
+              permissionMutation.query(**kargs, &block)
+            end
+
+            def destroy(**kargs, &block)
+              destroyMutation.query(**kargs, &block)
+            end
+
+            private
+
+            def createMutation
+              Mutation::PresetView::Create.new(client)
+            end
+
+            def updateMutation
+              Mutation::PresetView::Update.new(client)
+            end
+
+            def permissionMutation
+              Mutation::PresetView::Permission.new(client)
+            end
+
+            def destroyMutation
+              Mutation::PresetView::Destroy.new(client)
+            end
+          end
+        end
+      end
+    end
+  end
+end