ecoportal-api-graphql 1.3.16 → 2.2.0

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

@@ -0,0 +1,15 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # Permissions ? the org-level ability set (Organization.permissions).
+        # Every field is a `canXXX: AuthorizationResult!` permission check. Read-only.
+        # The concrete embeds_one declarations live on Model::Permissions (they reference
+        # Model::AuthorizationResult).
+        class Permissions < Logic::BaseModel
+          read_only!
+        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/person_member_changelog.rb

@@ -0,0 +1,23 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # A single audit entry in a person member's changelog history, returned by
+        # `PersonMember.changelogs` / `Organization.personMemberChangelogs`. Read-only.
+        #
+        # Enum-valued fields are exposed as plain strings:
+        # - operation / accountOperation: 'CREATE' | 'UPDATE' | 'DESTROY'
+        class PersonMemberChangelog < Logic::BaseModel
+          read_only!
+
+          passkey :id
+          passthrough :operation, :accountOperation
+          passthrough :personMemberId, :apiKeyPrefix
+          passboolean :changedByApi
+          passarray :humanReadableDifferences
+          embeds_one :createdAt, klass: Base::DateTime
+        end
+      end
+    end
+  end
+end

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

@@ -1,15 +1,150 @@
-module Ecoportal
+module Ecoportal
   module API
     class GraphQL
       module Base
         # A register preset view — saved column/sort/filter configuration for previewPages.
         # Scripts use the id as `presetViewId` in register.previewPages queries.
         class PresetView < Logic::BaseModel
+          # `fieldConfigurations` is a passarray (leaf) invisible to the default
+          # DiffService; LeafDiffService detects it as a full-set replace, which is what
+          # makes a columns-only change reach `#as_input` at all (before it, the array was
+          # dropped from the flat diff and no mutation was issued). The read-key/shape
+          # conversion that change then needs is handled below — the GAP-P1 that comment
+          # referred to as a separate pending converter is closed by it.
+          # See Diffable::LeafDiffService.
+          DIFF_CLASS = Ecoportal::API::Common::GraphQL::Model::Diffable::LeafDiffService
+
+          # READ key vs WRITE key — and, on update, read SHAPE vs write SHAPE.
+          #
+          # The API RETURNS the collection as `fieldConfigurations`, a plain list (see the
+          # `passarray` below — that stays as-is, consumers read it). The mutations call it
+          # `fieldConfigs`, and the two mutations do NOT agree on its shape. Schema-verified
+          # against the live introspection dump (20260730):
+          #
+          #   CreatePresetViewInput.fieldConfigs : [FieldConfigurationInput!]!
+          #   UpdatePresetViewInput.fieldConfigs : FieldConfigurationOneToManyInput!
+          #                                        { additions:, deletions:, updates: }
+          #
+          # Both are NON_NULL with no default value — i.e. REQUIRED on every call — while the
+          # `FieldConfigurationOneToManyInput` members each default to `[]`, so `{}` is a
+          # valid no-op value for an update that does not touch the columns.
+          #
+          # Emitting the read key `fieldConfigurations` is an unknown-argument error, and
+          # emitting the read LIST under `fieldConfigs` is a type error: either one rejects
+          # the WHOLE mutation, a `name`-only edit included.
+          #
+          # `#as_input` emits the UPDATE shape. `Logic::Mutation#as_input` hands a read model
+          # straight to `model.as_input` without telling it which mutation it feeds, and the
+          # only model-driven path is `register.preset_view.update`: a read model carries an
+          # `id`, which `CreatePresetViewInput` does not even accept. Create is built from a
+          # caller-supplied Hash (see Builder::Register::PresetView) whose `fieldConfigs` is
+          # already the plain array the schema wants — it needs no conversion.
+          READ_KEY = 'fieldConfigurations'.freeze
+
+          # The fields `FieldConfigurationInput` accepts (same dump). The read nodes also
+          # carry `__typename` — the read side is a union, see Fragment::FieldConfiguration —
+          # which the input type does NOT accept, so nodes are whitelisted through this list
+          # rather than passed along verbatim.
+          FIELD_CONFIG_INPUT_KEYS = %i[
+            id key name weight dataFieldLabel type showTime valueToShow mode displayUid
+          ].freeze
+
           passkey :id
           passthrough :name, :registerId
           passboolean :global
           passarray   :fieldConfigurations
           passthrough :sorter # { key:, direction:, missing: }
+
+          class << self
+            # Turns a raw mutation-input diff into a valid `UpdatePresetViewInput`: drops the
+            # read key and sets `fieldConfigs` to the one-to-many delta.
+            #
+            # Idempotent — the read key is deleted and the delta is recomputed from
+            # `doc`/`original_doc`, so a second application yields the same Hash. That is what
+            # makes it safe for both seams (`#as_input` and `Input::PresetView::Update
+            # .from_model`) to call it on the same Hash.
+            #
+            # @param model [PresetView] the subject (read) model.
+            # @param input [Hash, nil] the mutation input hash so far (nil when nothing in the
+            #   flat diff changed).
+            # @return [Hash, nil] +input+ with a schema-valid `fieldConfigs`, or nil when
+            #   neither the flat diff nor the columns changed (no mutation to send).
+            def build_update_input(model, input)
+              return input unless model.respond_to?(:field_configs_delta)
+
+              delta = model.field_configs_delta
+              return input if input.nil? && delta.empty?
+
+              input ||= {}
+              input.delete(:fieldConfigurations)
+              input.delete(READ_KEY)
+              input[:id]         ||= model.id if model.respond_to?(:id)
+              input[:fieldConfigs] = delta
+              input
+            end
+
+            # @param node [Hash] one `fieldConfigurations` read node.
+            # @return [Hash] the node reduced to the keys `FieldConfigurationInput` accepts,
+            #   symbol-keyed. Keys the read selection did not ask for are simply absent.
+            def field_config_input(node)
+              FIELD_CONFIG_INPUT_KEYS.each_with_object({}) do |key, out|
+                str      = key.to_s
+                out[key] = node[str] if node.key?(str)
+                out[key] = node[key] if node.key?(key)
+              end
+            end
+          end
+
+          # The `FieldConfigurationOneToManyInput` delta between the server baseline
+          # (`original_doc`) and the current `doc`, matched on the config `id`:
+          # `additions` = nodes with no known id, `deletions` = baseline ids that are gone,
+          # `updates` = known nodes whose (input-visible) content changed. Empty members are
+          # omitted, so an untouched collection yields `{}` — the valid no-op.
+          #
+          # Computed DIRECTLY from the docs rather than from the flat diff, for the same
+          # reason as {Logic::Input::IdDiffFields}: `passarray` leaves are dropped by the
+          # cascaded DiffService.
+          #
+          # @return [Hash] `{ additions:, deletions:, updates: }`, empty members omitted.
+          def field_configs_delta
+            current  = field_config_nodes(doc)
+            original = field_config_nodes(original_doc)
+            known    = original.filter_map {|node| node[:id]}
+
+            additions = current.reject {|node| node[:id] && known.include?(node[:id])}
+            updates   = (current - additions) - original
+            deletions = known - current.filter_map {|node| node[:id]}
+
+            {}.tap do |delta|
+              delta[:additions] = additions unless additions.empty?
+              delta[:deletions] = deletions unless deletions.empty?
+              delta[:updates]   = updates   unless updates.empty?
+            end
+          end
+
+          # Mutation input for this preset view, shaped for `updatePresetView`.
+          # @see .build_update_input
+          def as_input(target_class: nil, clientMutationId: '')
+            input = self.class.build_update_input(self, super)
+            return input if input.nil? || target_class
+
+            # `super` merges it only when it built the Hash itself; a columns-only change
+            # synthesises the Hash here, so keep the wire payload identical either way.
+            input[:clientMutationId] = clientMutationId.to_s unless input.key?(:clientMutationId)
+            input
+          end
+
+          private
+
+          # @param source_doc [Hash, nil] `doc` or `original_doc`.
+          # @return [Array<Hash>] the read nodes, each reduced to input-accepted keys.
+          def field_config_nodes(source_doc)
+            return [] if source_doc.nil?
+
+            Array(source_doc[READ_KEY]).
+              grep(Hash).
+              map {|node| self.class.field_config_input(node)}
+          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,8 +1,13 @@
-module Ecoportal
+module Ecoportal
   module API
     class GraphQL
       module Base
         class Register < Logic::BaseModel
+          # `filterTags` is a passarray (leaf) that the default DiffService cannot
+          # diff; LeafDiffService detects it as a full-set replace. See
+          # Diffable::LeafDiffService.
+          DIFF_CLASS = Ecoportal::API::Common::GraphQL::Model::Diffable::LeafDiffService
+
           passkey :id
           passthrough :name, :iconName, :moduleType, :registerStatus
           passthrough :descriptionText, :descriptionImageUrl