ecoportal-api-graphql 1.3.5 → 1.3.9

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

@@ -0,0 +1,19 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class EscalationLevel < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passthrough :order, :dueInValue, :dueInUnit
+            passboolean :dueExcludeWeekends, :timerPaused
+            passthrough :elapsedSeconds
+            passdate :escalationDueAt
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class InSystemConfig < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passboolean :enabled
+            passthrough :message, :title
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class MailboxFieldSelection < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passthrough :name, :stageName
+            passboolean :deleted
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +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

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

@@ -0,0 +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

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

@@ -0,0 +1,21 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          module Operations
+            class CreatePage < OperationInterface
+              SCHEMA_VERSION = '20260605'.freeze
+
+              passthrough :templateId, :crossReferenceFieldId
+
+              def errors
+                @errors ||= doc['errors']
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +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

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

@@ -0,0 +1,17 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class PeopleFieldSelection < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passthrough :name, :stageName
+            passboolean :deleted
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +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

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

@@ -0,0 +1,17 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class RegisterField < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passthrough :key, :name, :type
+            passthrough :total
+            passboolean :missing, :enableCrossRegisterReporting
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class TaskConfigSelection < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passthrough :type, :stageName
+            passboolean :deleted
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class TimeDelayConfig < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passboolean :enabled, :excludeWeekends
+            passthrough :frequencyValue, :period
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class TriggerInterface < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+
+            require_relative 'triggers/conditional_logic'
+
+            def self.from_doc(raw_doc)
+              case raw_doc&.fetch('__typename', nil)
+              when 'PagesWorkflowTriggersConditionalLogic'
+                Triggers::ConditionalLogic.new(raw_doc)
+              else
+                new(raw_doc)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,17 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          module Triggers
+            class ConditionalLogic < TriggerInterface
+              SCHEMA_VERSION = '20260605'.freeze
+
+              passarray :filters
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class UserSelection < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passthrough :email, :name
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +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

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

@@ -0,0 +1,17 @@
+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
+          passkey :id
+          passthrough :name, :registerId
+          passboolean :global
+          passarray   :fieldConfigurations
+          passthrough :sorter # { key:, direction:, missing: }
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +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

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

@@ -0,0 +1,18 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class Register < Logic::BaseModel
+          passkey :id
+          passthrough :name, :iconName, :moduleType, :registerStatus
+          passthrough :descriptionText, :descriptionImageUrl
+          passboolean :shown, :creatable, :attachable, :permissioned
+          passboolean :contentShareable, :enableEmailOut, :isMobile
+          passboolean :restrictTemplatesAmount
+          passthrough :restrictedAmountOfTemplates
+          passarray   :filterTags
+        end
+      end
+    end
+  end
+end

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

@@ -21,4 +21,15 @@ require_relative 'base/resource'
 require_relative 'base/action_category'
 require_relative 'base/action'
 require_relative 'base/contractor_entity'
+require_relative 'base/preview_page'
+require_relative 'base/delta_result'
 require_relative 'base/organization'
+
+require_relative 'base/register'
+require_relative 'base/preset_view'
+
+require_relative 'base/ai_summary_version'
+
+require_relative 'base/force'
+require_relative 'base/pages_workflow'
+require_relative 'base/kickstand'

data/lib/ecoportal/api/graphql/builder/CLAUDE.md

@@ -0,0 +1,65 @@
+# builder
+
+Façade classes that group related mutations (and occasional queries) under a single object.
+Consumers interact with builders rather than instantiating `Logic::Mutation` / `Logic::Query`
+subclasses directly.
+
+## Contents
+
+| File / class | Exposed from `GraphQL` as | Purpose |
+|---|---|---|
+| `action.rb` / `Builder::Action` | `GraphQL#action` | `create`, `update`, `archive` — wraps `Mutation::Action::*` |
+| `contractor_entity.rb` / `Builder::ContractorEntity` | `GraphQL#contractorEntity` | `create`, `update`, `destroy` — wraps `Mutation::ContractorEntity::*` |
+| `location_structure.rb` / `Builder::LocationStructure` | `GraphQL#locationStructure` | `nodeClassifications` (query), `applyCommandsInput`, `applyCommands`, `draft` sub-builder |
+| `location_structure/draft.rb` / `Builder::LocationStructure::Draft` | via `locationStructure.draft` | Location structure draft mutations |
+| `page.rb` / `Builder::Page` | `GraphQL#page` | Full page lifecycle: `update`, `archive`, `unarchive`, `build_from_template`, `create_from_template`, `create_draft`, `delete_draft`, `publish_draft`, `approve/reject/restart/undo/batch_update_review_task`, `execute_workflow_commands` (new), `execute_force_commands` (deprecated) |
+| `register.rb` / `Builder::Register` | *(not yet exposed)* | **Stub** — all methods commented out. No `Mutation::Register::*` classes exist yet. See TODO below. |
+
+## How builders are exposed
+
+All active builders are wired in `lib/ecoportal/api/graphql.rb` as instance methods:
+
+```ruby
+def page
+  Builder::Page.new(client)
+end
+def action
+  Builder::Action.new(client)
+end
+# etc.
+```
+
+`registers` (note: plural, lowercase) returns `Compat::Registers`, **not** `Builder::Register`.
+`Builder::Register` is a stub and is not yet wired into the top-level class.
+
+## Builder::Register — TODO
+
+`builder/register.rb` contains a stub class with all methods commented out.
+Before it can be implemented:
+
+1. Research which Register mutations exist in the schema (`createRegister`,
+   `updateRegister`, `archiveRegister`, etc.) — none are currently documented
+   in `.ai-assistance/code/ecoportal_schema_reference.md`.
+2. Create `Mutation::Register::*` + `Input::Register::*` + `Payload::Register::*`
+   following the pattern of `Mutation::Page::*`.
+3. Expose `Builder::Register` from `GraphQL#register` (distinct from `#registers`
+   which is the compat search layer).
+
+Until then, register mutation callers must instantiate `Mutation::Register::*` directly
+(none exist yet), or use `Compat::Registers` for search.
+
+## Conventions
+
+- One builder per domain entity. Sub-builders (e.g. `LocationStructure::Draft`) are
+  nested under their parent builder's folder and exposed via a method on the parent.
+- Builder methods are snake_case public API; private helper methods are camelCase
+  (matching the existing convention: `updateMutation`, `archiveMutation`, etc.).
+- Builders never hold state — each method instantiates a fresh mutation/query object.
+- Builders do not implement pagination; callers use `QueryConnection#each` for that.
+
+## Related
+
+- `../mutation/` — concrete mutation classes that builders delegate to
+- `../query/` — concrete query classes (some builders also expose query shortcuts)
+- `../compat/` — v2-compatible layer (`Compat::Pages`, `Compat::Registers`) that
+  wraps builders + queries with an eco-helpers-compatible interface

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

@@ -0,0 +1,73 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class Kickstand
+          attr_reader :client
+
+          def initialize(client)
+            @client = client
+          end
+
+          def start(id:, &block)
+            startMutation.query(id: id, &block)
+          end
+
+          def stop(id:, &block)
+            stopMutation.query(id: id, &block)
+          end
+
+          def fail(id:, &block)
+            failMutation.query(id: id, &block)
+          end
+
+          def bulk_update(ids:, start: false, stop: false, failure: false, &block)
+            bulkUpdateMutation.query(ids: ids, start: start, stop: stop, failure: failure, &block)
+          end
+
+          def start_job(id:, &block)
+            startJobMutation.query(id: id, &block)
+          end
+
+          def fail_job(id:, &block)
+            failJobMutation.query(id: id, &block)
+          end
+
+          def bulk_update_jobs(ids:, start: false, failure: false, &block)
+            bulkUpdateJobsMutation.query(ids: ids, start: start, failure: failure, &block)
+          end
+
+          private
+
+          def startMutation
+            Mutation::Kickstand::StartWorkflow.new(client)
+          end
+
+          def stopMutation
+            Mutation::Kickstand::StopWorkflow.new(client)
+          end
+
+          def failMutation
+            Mutation::Kickstand::FailWorkflow.new(client)
+          end
+
+          def bulkUpdateMutation
+            Mutation::Kickstand::BulkUpdateWorkflows.new(client)
+          end
+
+          def startJobMutation
+            Mutation::Kickstand::StartJob.new(client)
+          end
+
+          def failJobMutation
+            Mutation::Kickstand::FailJob.new(client)
+          end
+
+          def bulkUpdateJobsMutation
+            Mutation::Kickstand::BulkUpdateJobs.new(client)
+          end
+        end
+      end
+    end
+  end
+end