ecoportal-api-graphql 1.3.17 → 2.0.0

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

@@ -0,0 +1,57 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # Dashboard search on `Organization.dashboardSearch`, returning a
+        # MinimalDashboardConnection. The same `dashboardSearch` field exists on
+        # other resolvers (Register/Reporting/TodoActions/...) that the gem does
+        # not yet model; this covers the org-level entry point.
+        class DashboardSearch < Logic::QueryConnection
+          field_name :dashboardSearch
+
+          class_resolver :item_class, Model::MinimalDashboard
+          class_resolver :connection_class, Connection::MinimalDashboard
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(
+                searchConf: :Search,
+                after:      :string,
+                before:     :string,
+                first:      :int,
+                last:       :int
+              ) {
+                currentOrganization {
+                  dashboardSearch(
+                    searchConf: :searchConf,
+                    after:      :after,
+                    before:     :before,
+                    first:      :first,
+                    last:       :last,
+                    &connection_block
+                  )
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                spread :MinimalDashboard
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,76 +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
+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_classifications.rb

@@ -1,39 +1,39 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Query
-        class LocationClassifications < Logic::QueryArray
-          accepted_params :active, default: true
-
-          base_path 'currentOrganization.locations'
-          field_name :classifications
-
-          class_resolver :item_class, Base::LocationClassificationType
-
-          private
-
-          def basic_block(&block)
-            final_block = block || default_query_block
-            proc {
-              query(active: :boolean) {
-                currentOrganization {
-                  locations {
-                    classifications(active: :active, &final_block)
-                  }
-                }
-              }
-            }
-          end
-
-          def default_query_block
-            proc {
-              id
-              name
-              active
-            }
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        class LocationClassifications < Logic::QueryArray
+          accepted_params :active, default: true
+
+          base_path 'currentOrganization.locations'
+          field_name :classifications
+
+          class_resolver :item_class, Base::LocationClassificationType
+
+          private
+
+          def basic_block(&block)
+            final_block = block || default_query_block
+            proc {
+              query(active: :boolean) {
+                currentOrganization {
+                  locations {
+                    classifications(active: :active, &final_block)
+                  }
+                }
+              }
+            }
+          end
+
+          def default_query_block
+            proc {
+              id
+              name
+              active
+            }
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -37,6 +37,8 @@ module Ecoportal
               name
               archived
               weight
+              generating
+              aiPrompt
               updatedAt { dateTime timeZone }
               visitorManagementEnabled
               nodes(

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

@@ -42,6 +42,8 @@ module Ecoportal
               name
               archived
               weight
+              generating
+              aiPrompt
               visitorManagementEnabled
               nodes(
                 includeArchived: :includeArchivedNodes

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

@@ -8,7 +8,12 @@ module Ecoportal
           # directly (e.g. Compat::Pages#get) rather than via the currentOrganization proxy.
           base_path 'currentOrganization'
 
-          accepted_params :id
+          # Besides `id`, the CommonPageUnion document variables can be overridden per call
+          # (they keep their document-level defaults when not passed). `content: false` matters
+          # for least-privilege accounts: the fragment's `attachedFiles @include(if: $content)`
+          # is preauthorized on the `files: download` ability, so an account without it cannot
+          # complete ANY page read unless content is excluded.
+          accepted_params :id, :showHiddenData, :content, :only_content, :fields
           class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
 
           private

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

@@ -0,0 +1,56 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # Page history / activity feed on `page.activities`, returning an
+        # ActivityInterfaceConnection. Resolves under
+        # `currentOrganization.page(id:).activities(...)`.
+        #
+        # `Organization.page(id:)` returns a PageUnion (BasicPage | PhasedPage), so the
+        # `activities` connection is selected via inline fragments on both members —
+        # provided by the :PageActivities fragment (which also carries the connection
+        # selection via :ActivityConnection). The connection selection is therefore
+        # fixed by the fragment; a custom connection block is not accepted here.
+        #
+        # The web "page history changelog" feature drives this with
+        # `searchConf: { sorters: [{ direction: 'desc', key: 'updated_at' }] }`.
+        class PageActivities < Logic::QueryConnection
+          field_name :activities
+          # The connection nests under currentOrganization.page; wrap_response digs
+          # this path (the inline-fragment `activities` merges into `page`).
+          base_path 'currentOrganization.page'
+
+          accepted_params :id, :searchConf, :after, :before, :first, :last
+
+          class_resolver :item_class, Model::Activity
+          class_resolver :connection_class, Connection::Activity
+
+          private
+
+          def basic_block(&_block)
+            proc {
+              query(
+                id:         :id!,
+                searchConf: :Search,
+                after:      :string,
+                before:     :string,
+                first:      :int,
+                last:       :int
+              ) {
+                currentOrganization {
+                  page(id: :id) {
+                    spread :PageActivities
+                  }
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc { spread :ActivityConnection }
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,47 +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
+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/pages.rb

@@ -1,59 +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 the repo's internal docs — "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
+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/permissions.rb

@@ -0,0 +1,35 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # Fetches the org-level permission set: currentOrganization.permissions.
+        # Returns a Model::Permissions whose ~83 canXXX fields are AuthorizationResult.
+        # Selects the :Permissions fragment (which spreads :AuthorizationResult per field).
+        class Permissions < Logic::Query
+          field_name :permissions
+
+          class_resolver :item_class, Model::Permissions
+
+          private
+
+          def basic_block(&block)
+            final_block = block || default_query_block
+            proc {
+              query {
+                currentOrganization {
+                  permissions(&final_block)
+                }
+              }
+            }
+          end
+
+          def default_query_block
+            proc {
+              spread :Permissions
+            }
+          end
+        end
+      end
+    end
+  end
+end