ecoportal-api-graphql 1.3.16 → 2.0.0

data/lib/ecoportal/api/graphql/mutation/contractor_entity/update_manager_settings.rb

@@ -0,0 +1,37 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module ContractorEntity
+          # `updateContractorManagerSettings` mutation (2026-07 schema).
+          # Returns the updated Organization directly.
+          class UpdateManagerSettings < Ecoportal::API::GraphQL::Logic::Mutation
+            field_name :updateContractorManagerSettings
+
+            class_resolver :payload_class, Payload::ContractorEntity::ManagerSettings
+            class_resolver :input_class, Input::ContractorEntity::ManagerSettings
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :UpdateContractorManagerSettingsInput!) {
+                  updateContractorManagerSettings(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                id
+                name
+                allowContractorAdminsToAddAdmins
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/mutation/contractor_entity.rb

@@ -12,3 +12,4 @@ end
 require_relative 'contractor_entity/create'
 require_relative 'contractor_entity/destroy'
 require_relative 'contractor_entity/update'
+require_relative 'contractor_entity/update_manager_settings'

data/lib/ecoportal/api/graphql/mutation/file_container/upload.rb

@@ -0,0 +1,78 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module FileContainer
+          # Registers an object already uploaded to S3 as an org file container.
+          #
+          # ★ This is the REAL second half of a file upload, captured from the web client on
+          # 2026-07-30 (`tmp/file_upload_network_log.har`): the browser does
+          # `FileSignature` (GraphQL) -> S3 multipart POST -> **`uploadFile` (GraphQL)** ->
+          # `updatePage`. There is NO `POST /api/v2/<org>/s3/files` call and NO polling step —
+          # the previous implementation was a port of `ecoportal-api-v2`'s REST S3 code and
+          # targeted endpoints the platform does not use for this flow.
+          #
+          # `url` is the S3 object key returned by the upload step (NOT a URL, despite the name —
+          # verified against the capture: `uploads/<userId>/<stamp>-<token>-/<filename>`).
+          #
+          # Verified against the live schema (2026-07-30):
+          #   uploadFile(input: UploadInput) -> UploadPayload { clientMutationId errors item: FileContainer }
+          #   UploadInput { clientMutationId filename filetype filesize locationIds otherTags url containerId }
+          class Upload < Logic::Mutation
+            field_name :uploadFile
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Upload'
+
+            # @param filename [String] the file's base name as it should appear in the manager.
+            # @param filetype [String] MIME type.
+            # @param filesize [Integer, String] bytes. The schema types this as `String`.
+            # @param url [String] the S3 object KEY produced by the S3 POST step.
+            # @param location_ids [Array<String>, nil] locations to file it under.
+            # @param other_tags [Array<String>, nil] tags — the only supported way to tag a
+            #   container (there is no separate tag mutation; confirmed 2026-07-30).
+            # @param container_id [String, nil] add a new VERSION to an existing container.
+            def query(filename:, filetype:, filesize:, url:, location_ids: nil, other_tags: nil, container_id: nil, **kargs, &block)
+              input = {
+                filename: filename,
+                filetype: filetype,
+                filesize: filesize.to_s,
+                url:      url
+              }
+              input[:locationIds] = Array(location_ids) if location_ids
+              input[:otherTags]   = Array(other_tags)   if other_tags
+              input[:containerId] = container_id        if container_id
+
+              super(input: input, **kargs, &block)
+            end
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :UploadInput!) {
+                  uploadFile(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                errors { details fullMessages }
+                item {
+                  id
+                  name
+                  activeName
+                  activeVersion
+                  fileSize
+                  tags
+                  otherTags
+                }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/mutation/file_container.rb

@@ -0,0 +1,15 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        # Namespaced `FileContainer` (not `File`) on purpose: a `Mutation::File` module would
+        # shadow ::File for every sibling in this namespace, and the payload item type IS a
+        # FileContainer.
+        module FileContainer
+        end
+      end
+    end
+  end
+end
+
+require_relative 'file_container/upload'

data/lib/ecoportal/api/graphql/mutation/template/update_related_page.rb

@@ -0,0 +1,79 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Template
+          # `updateRelatedPage(input: UpdateRelatedPageInput!)` — edits an existing related-pages
+          # CONFIG entry on a template (title / target register / filters).
+          #
+          # ★ The worklog long carried this as an "ecoportal backend gap — the only genuine
+          # structural template omission". That note is STALE: the mutation exists in the live
+          # schema (verified 20260731), so the gap was ours. Without it, related-pages entries
+          # could be created and destroyed but never edited — every title or filter change meant
+          # destroy + recreate, which loses the entry id.
+          #
+          # Note the argument name asymmetry, which is the schema's: create/destroy are
+          # `createTemplateRelatedPage`/`destroyTemplateRelatedPage`, but update is plain
+          # `updateRelatedPage` (no `Template` infix).
+          class UpdateRelatedPage < Logic::Mutation
+            SCHEMA_VERSION = '20260731'.freeze
+
+            field_name :updateRelatedPage
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Template::UpdateRelatedPage'
+
+            # @param template_id [String] the template page id.
+            # @param id [String] the RelatedPages entry id being edited.
+            # @param patch_ver [Integer] template patchVer (optimistic concurrency).
+            # @param title [String, nil] new title. Omitted when nil — the schema treats an absent
+            #   key as "leave alone", so nil must NOT be sent as an explicit null.
+            # @param register_id [String, nil] retarget the entry at another register.
+            # @param filters [Array<Hash>, nil] `[SearchFilter!]`. Note `SearchFilter.params` is an
+            #   untyped `Hash` in the schema, so its inner shape is not validated by GraphQL —
+            #   callers must get it right themselves.
+            def query(template_id:, id:, patch_ver:, title: nil, register_id: nil, filters: nil, **kargs, &block)
+              input = self.class.build_input(
+                template_id: template_id, id: id, patch_ver: patch_ver,
+                title: title, register_id: register_id, filters: filters
+              )
+              super(input: input, **kargs, &block)
+            end
+
+            # Extracted so the partial-update rule is testable without a client or a network stub.
+            # A nil optional key is OMITTED, not serialised as an explicit null — the server reads
+            # an absent key as "leave alone", so sending null would blank the stored value.
+            def self.build_input(template_id:, id:, patch_ver:, title: nil, register_id: nil, filters: nil)
+              {
+                templateId: template_id,
+                id:         id,
+                patchVer:   patch_ver
+              }.tap do |input|
+                input[:title]      = title       unless title.nil?
+                input[:registerId] = register_id unless register_id.nil?
+                input[:filters]    = filters     unless filters.nil?
+              end
+            end
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :UpdateRelatedPageInput!) {
+                  updateRelatedPage(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                item { spread :TemplateRelatedPages }
+                errors { details fullMessages }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -15,4 +15,5 @@ require_relative 'template/publish'
 require_relative 'template/unpublish'
 require_relative 'template/update_information'
 require_relative 'template/create_related_page'
+require_relative 'template/update_related_page'
 require_relative 'template/destroy_related_page'

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

@@ -15,6 +15,6 @@ require_relative 'mutation/register'
 require_relative 'mutation/preset_view'
 
 require_relative 'mutation/ai_summary'
-require_relative 'mutation/smart_fill'
 require_relative 'mutation/kickstand'
 require_relative 'mutation/template'
+require_relative 'mutation/file_container'

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

@@ -0,0 +1,20 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module ContractorEntity
+          # Payload for `updateContractorManagerSettings`, which returns the
+          # updated Organization directly (not a { clientMutationId, errors, item }
+          # wrapper). Read-only view of the org fields relevant to the mutation.
+          class ManagerSettings < Logic::BaseModel
+            read_only!
+
+            passkey :id
+            passthrough :name
+            passboolean :allowContractorAdminsToAddAdmins
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -12,3 +12,4 @@ end
 require_relative 'contractor_entity/create'
 require_relative 'contractor_entity/destroy'
 require_relative 'contractor_entity/update'
+require_relative 'contractor_entity/manager_settings'

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

@@ -0,0 +1,15 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        module Template
+          # `UpdateRelatedPagePayload { clientMutationId, errors, item: RelatedPages }` — same
+          # shape as CreateTemplateRelatedPagePayload.
+          class UpdateRelatedPage < Logic::Payload
+            class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::Template::RelatedPages'
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -15,4 +15,5 @@ require_relative 'template/publish'
 require_relative 'template/unpublish'
 require_relative 'template/update_information'
 require_relative 'template/create_related_page'
+require_relative 'template/update_related_page'
 require_relative 'template/destroy_related_page'

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

@@ -0,0 +1,12 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Payload
+        # `uploadFile` -> `UploadPayload { clientMutationId errors item: FileContainer }`.
+        class Upload < Logic::Payload
+          class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::FileContainer'
+        end
+      end
+    end
+  end
+end

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

@@ -21,3 +21,4 @@ require_relative 'payload/force_commands'
 require_relative 'payload/execute_workflow_commands'
 require_relative 'payload/kickstand'
 require_relative 'payload/template'
+require_relative 'payload/upload'

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

@@ -0,0 +1,78 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # System Access Logs on `currentOrganization.activityLogs`, returning an
+        # ActivityLogUnionConnection. Exposes the full server filter set.
+        #
+        # Enum args are passed as GraphQL enum type names:
+        # - resourceType: ActivityLogTypesEnum
+        #   (view_page|download_file|access_denied|view_dashboard|
+        #    create_dashboard|update_dashboard|delete_dashboard)
+        # - source: SourceEnum (web|mobile|public|api|auto_page_creation|public_template|script)
+        # - dateFilter: DateRange ({ from:, to: })
+        class ActivityLogs < Logic::QueryConnection
+          field_name :activityLogs
+
+          accepted_params :userIds, :resourceIds, :filterSuperusers, :activityType,
+                          :resourceType, :source, :dateFilter,
+                          :after, :before, :first, :last
+
+          class_resolver :item_class, Model::ActivityLog
+          class_resolver :connection_class, Connection::ActivityLog
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(
+                userIds:          '[ID!]',
+                resourceIds:      '[ID!]',
+                filterSuperusers: :boolean,
+                activityType:     :string,
+                resourceType:     :ActivityLogTypesEnum,
+                source:           :SourceEnum,
+                dateFilter:       :DateRange,
+                after:            :string,
+                before:           :string,
+                first:            :int,
+                last:             :int
+              ) {
+                currentOrganization {
+                  activityLogs(
+                    userIds:          :userIds,
+                    resourceIds:      :resourceIds,
+                    filterSuperusers: :filterSuperusers,
+                    activityType:     :activityType,
+                    resourceType:     :resourceType,
+                    source:           :source,
+                    dateFilter:       :dateFilter,
+                    after:            :after,
+                    before:           :before,
+                    first:            :first,
+                    last:             :last,
+                    &connection_block
+                  )
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                spread :ActivityLog
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,51 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        class AuthLogs < Logic::QueryConnection
+          field_name :authLogs
+
+          class_resolver :item_class, Model::AuthLog
+          class_resolver :connection_class, Connection::AuthLog
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(
+                after:  :string,
+                before: :string,
+                first:  :int,
+                last:   :int
+              ) {
+                currentOrganization {
+                  authLogs(
+                    after:  :after,
+                    before: :before,
+                    first:  :first,
+                    last:   :last,
+                    &connection_block
+                  )
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                spread :AuthLog
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

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/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/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

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

@@ -0,0 +1,53 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        class PersonMemberChangelogs < Logic::QueryConnection
+          field_name :personMemberChangelogs
+
+          class_resolver :item_class, Model::PersonMemberChangelog
+          class_resolver :connection_class, Connection::PersonMemberChangelog
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(
+                searchConf: :Search,
+                after:      :string,
+                before:     :string,
+                first:      :int,
+                last:       :int
+              ) {
+                currentOrganization {
+                  personMemberChangelogs(
+                    searchConf: :searchConf,
+                    after:      :after,
+                    before:     :before,
+                    first:      :first,
+                    last:       :last,
+                    &connection_block
+                  )
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                spread :PersonMemberChangelog
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end