ecoportal-api-graphql 1.3.5 → 1.3.9

data/lib/ecoportal/api/graphql/payload/page/review_task.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Page
+          class ReviewTask < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/payload/page/unarchive.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Page
+          class Unarchive < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/payload/page/update.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Page
+          class Update < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/payload/page/update_variable_bindings.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Page
+          class UpdateVariableBindings < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,19 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Page
+        end
+      end
+    end
+  end
+end
+
+require_relative 'page/update'
+require_relative 'page/archive'
+require_relative 'page/unarchive'
+require_relative 'page/build_from_template'
+require_relative 'page/create_from_template'
+require_relative 'page/draft'
+require_relative 'page/review_task'
+require_relative 'page/update_variable_bindings'

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

@@ -0,0 +1,11 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        class PresetView < Logic::Payload
+          class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PresetView'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        class Register < Logic::Payload
+          class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::Register'
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/payload/template/create.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Template
+          class Create < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/payload/template/create_related_page.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Template
+          class CreateRelatedPage < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/payload/template/destroy_related_page.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Template
+          class DestroyRelatedPage < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/payload/template/publish.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Template
+          class Publish < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/payload/template/unpublish.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Template
+          class Unpublish < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/payload/template/update.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Template
+          class Update < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/payload/template/update_information.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Template
+          class UpdateInformation < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Template
+        end
+      end
+    end
+  end
+end
+
+require_relative 'template/create'
+require_relative 'template/update'
+require_relative 'template/publish'
+require_relative 'template/unpublish'
+require_relative 'template/update_information'
+require_relative 'template/create_related_page'
+require_relative 'template/destroy_related_page'

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

@@ -10,3 +10,14 @@ end
 require_relative 'payload/location_structure'
 require_relative 'payload/contractor_entity'
 require_relative 'payload/action'
+require_relative 'payload/page'
+require_relative 'payload/register'
+require_relative 'payload/preset_view'
+
+require_relative 'payload/ai_summary_generate'
+require_relative 'payload/ok_payload'
+
+require_relative 'payload/force_commands'
+require_relative 'payload/execute_workflow_commands'
+require_relative 'payload/kickstand'
+require_relative 'payload/template'

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

@@ -23,7 +23,7 @@ module Ecoportal
 
           def default_block
             proc {
-              ___Ecoportal__API__GraphQL__Fragment__Action
+              spread :Action
             }
           end
         end

data/lib/ecoportal/api/graphql/query/action_categories.rb

@@ -42,7 +42,7 @@ module Ecoportal
                 hasNextPage
               }
               nodes {
-                ___Ecoportal__API__GraphQL__Fragment__ActionCategory
+                spread :ActionCategory
               }
             }
           end

data/lib/ecoportal/api/graphql/query/actions.rb

@@ -30,9 +30,9 @@ module Ecoportal
 
           def default_connection_block
             proc {
-              ___Ecoportal__API__GraphQL__Fragment__Pagination
+              spread :Pagination
               nodes {
-                ___Ecoportal__API__GraphQL__Fragment__Action
+                spread :Action
               }
             }
           end

data/lib/ecoportal/api/graphql/query/contractor_entities.rb

@@ -42,7 +42,7 @@ module Ecoportal
                 hasNextPage
               }
               nodes {
-                ___Ecoportal__API__GraphQL__Fragment__ContractorEntity
+                spread :ContractorEntity
               }
             }
           end

data/lib/ecoportal/api/graphql/query/file_upload_signature.rb

@@ -0,0 +1,76 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # Fetches S3 pre-signed upload credentials via GraphQL.
+        # These credentials are used to upload a file directly to S3.
+        # After the S3 upload, register the file with the EcoPortal backend
+        # using FileUpload::Client#register_and_poll to obtain a fileContainerId.
+        #
+        # Usage (via FileUpload::Client — do not call this directly):
+        #   api.file_upload.upload('/path/to/file.pdf')
+        class FileUploadSignature < Logic::Query
+          field_name :fileUploadSignature
+
+          def path
+            %w[currentOrganization fileUploadSignature]
+          end
+
+          def response_class
+            SignatureResponse
+          end
+
+          SignatureResponse = Struct.new(
+            :policy, :embedded_upload_policy, :embedded_upload_signature,
+            :signature, :endpoint, :access_key, :upload_prefix, :public_endpoint,
+            keyword_init: true
+          ) do
+            def to_h
+              members.to_h { |k| [k, self[k]] }
+            end
+          end
+
+          private
+
+          def basic_block(&block)
+            block_to_use = block || default_block
+            proc {
+              query {
+                currentOrganization {
+                  fileUploadSignature(&block_to_use)
+                }
+              }
+            }
+          end
+
+          def default_block
+            proc {
+              policy
+              embeddedUploadPolicy
+              embeddedUploadSignature
+              signature
+              endpoint
+              accessKey
+              uploadPrefix
+              publicEndpoint
+            }
+          end
+
+          def wrap_response(response, _path = [])
+            data = response.to_h.dig('data', 'currentOrganization', 'fileUploadSignature') || {}
+            SignatureResponse.new(
+              policy:                    data['policy'],
+              embedded_upload_policy:    data['embeddedUploadPolicy'],
+              embedded_upload_signature: data['embeddedUploadSignature'],
+              signature:                 data['signature'],
+              endpoint:                  data['endpoint'],
+              access_key:                data['accessKey'],
+              upload_prefix:             data['uploadPrefix'],
+              public_endpoint:           data['publicEndpoint']
+            )
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -44,12 +44,12 @@ module Ecoportal
 
             def default_query_block
               proc {
-                ___Ecoportal__API__GraphQL__Fragment__LocationDraft
+                spread :LocationDraft
                 structure {
                   nodes(
                     includeArchived: :includeArchivedNodes
                   ) {
-                    ___Ecoportal__API__GraphQL__Fragment__LocationNode
+                    spread :LocationNode
                   }
                 }
               }

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

@@ -42,7 +42,7 @@ module Ecoportal
               nodes(
                 includeArchived: :includeArchivedNodes
               ) {
-                ___Ecoportal__API__GraphQL__Fragment__LocationNode
+                spread :LocationNode
               }
               drafts {
                 id

data/lib/ecoportal/api/graphql/query/location_structures.rb

@@ -46,7 +46,7 @@ module Ecoportal
               nodes(
                 includeArchived: :includeArchivedNodes
               ) {
-                ___Ecoportal__API__GraphQL__Fragment__LocationNode
+                spread :LocationNode
               }
             }
           end

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

@@ -0,0 +1,45 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        class Page < Logic::Query
+          field_name :page
+          # Response nests under currentOrganization.page; needed when instantiated
+          # directly (e.g. Compat::Pages#get) rather than via the currentOrganization proxy.
+          base_path 'currentOrganization'
+
+          accepted_params :id
+          class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+
+          private
+
+          def basic_block(&block)
+            page_block = block || default_block
+            # CommonPageUnion's directives ($content/$only_content/$fields) are declared
+            # here with the defaults for a single-page read (content + field definitions).
+            # showHiddenData defaults true so reads include hidden/deindexed fields — v2
+            # parity (scripts see every field) and matches the front-end edit load. The
+            # server omits hidden fields from `page(id:)` when this is false/absent.
+            proc {
+              query(
+                id:             :id!,
+                showHiddenData: 'Boolean = true',
+                content:        'Boolean = true',
+                only_content:   'Boolean = false',
+                fields:         'Boolean = true'
+              ) {
+                currentOrganization {
+                  page(id: :id, showHiddenData: :showHiddenData, &page_block)
+                }
+              }
+            }
+          end
+
+          def default_block
+            proc { spread :CommonPageUnion }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/page_delta.rb

@@ -0,0 +1,47 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # Cache-invalidation query: given a list of (id, deltaAt) pairs, returns
+        # which pages have been UPDATED since that timestamp, are NOT_FOUND (deleted/
+        # inaccessible), or are NEW (id not recognised by the server).
+        #
+        # Usage:
+        #   Query::PageDelta.new(client).query(
+        #     deltaInput: [
+        #       { id: 'abc', deltaAt: '2026-01-01T00:00:00Z' },
+        #       { id: 'def', deltaAt: '2026-03-15T12:00:00Z' }
+        #     ]
+        #   )
+        #   # => [DeltaResult(id: 'abc', delta: 'UPDATED'), ...]
+        class PageDelta < Logic::QueryArray
+          field_name :pageDelta
+
+          accepted_params :deltaInput, :searchConf
+
+          class_resolver :item_class, 'Ecoportal::API::GraphQL::Base::DeltaResult'
+
+          private
+
+          def basic_block(&block)
+            item_block = block || default_block
+            proc {
+              query(deltaInput: :'[DeltaInput!]!', searchConf: :Search) {
+                currentOrganization {
+                  pageDelta(deltaInput: :deltaInput, searchConf: :searchConf, &item_block)
+                }
+              }
+            }
+          end
+
+          def default_block
+            proc {
+              id
+              delta
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/page_with_forces.rb

@@ -0,0 +1,43 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # Fetches a single page by ID, including its full forces array.
+        # Used by OozeRedirect::ForceCompat instead of the standard Query::Page
+        # so that `page.forces.get_by_name(name)` returns populated data.
+        #
+        # Usage (via ForceCompat — not typically called directly):
+        #   page = Query::PageWithForces.new(client).query(id: page_id)
+        #   force = page.forces.get_by_name('Workflow (S1)').first
+        class PageWithForces < Logic::Query
+          field_name :page
+
+          accepted_params :id
+          class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+
+          private
+
+          def basic_block(&block)
+            page_block = block || default_block
+            proc {
+              query(id: :id!) {
+                currentOrganization {
+                  page(id: :id, &page_block)
+                }
+              }
+            }
+          end
+
+          def default_block
+            proc {
+              spread :PageFields
+              forces {
+                spread :ForceFields
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/pages.rb

@@ -0,0 +1,59 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # DB-backed full-data org search — returns PageUnion nodes with patchVer and field IDs.
+        # Required pre-update fetch: always use this (not RegisterPreviewPages) before updatePage.
+        # See .ai-assistance/code/search_filters.md — "The Required Pattern: Find Before Mutate".
+        class Pages < Logic::QueryConnection
+          field_name :pages
+          # Response nests under currentOrganization.pages; needed when instantiated
+          # directly (e.g. Compat::Pages#each) rather than via the currentOrganization proxy.
+          base_path 'currentOrganization'
+
+          class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          class_resolver :connection_class, 'Ecoportal::API::GraphQL::Connection::Page'
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(
+                searchConf: :Search,
+                after:      :string,
+                before:     :string,
+                first:      :int,
+                last:       :int
+              ) {
+                currentOrganization {
+                  pages(
+                    searchConf: :searchConf,
+                    after:      :after,
+                    before:     :before,
+                    first:      :first,
+                    last:       :last,
+                    &connection_block
+                  )
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                spread :PageFields
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/pages_workflow_commands.rb

@@ -0,0 +1,59 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # Paginated command log for a page's PagesWorkflow.
+        # Returns PagesWorkflowCommandInterface nodes — each command applied to
+        # the workflow builder (change, changeMessage, esChange concrete types).
+        #
+        # Usage:
+        #   q = Query::PagesWorkflowCommands.new(client)
+        #   q.each(id: page.id, first: 50) { |cmd| puts cmd.doc['commandAction'] }
+        class PagesWorkflowCommands < Logic::QueryConnection
+          SCHEMA_VERSION = '20260605'.freeze
+
+          field_name :commands
+
+          accepted_params :id, :after, :before, :first, :last
+
+          class_resolver :item_class,       'Ecoportal::API::GraphQL::Base::PagesWorkflow::CommandInterface'
+          class_resolver :connection_class, 'Ecoportal::API::GraphQL::Connection::PagesWorkflowCommand'
+
+          def path
+            %w[currentOrganization page workflow commands]
+          end
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(id: :id!, after: :string, before: :string, first: :int, last: :int) {
+                currentOrganization {
+                  page(id: :id) {
+                    workflow {
+                      commands(after: :after, before: :before, first: :first, last: :last, &connection_block)
+                    }
+                  }
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                spread :PagesWorkflowCommandFields
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end