ecoportal-api-graphql 1.3.16 → 2.2.0

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

@@ -1,14 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module Action
-        end
-      end
-    end
-  end
-end
-
-require_relative 'action/create'
-require_relative 'action/update'
-require_relative 'action/archive'
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Action
+        end
+      end
+    end
+  end
+end
+
+require_relative 'action/create'
+require_relative 'action/update'
+require_relative 'action/archive'

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

@@ -1,29 +1,40 @@
-module Ecoportal
+module Ecoportal
   module API
     class GraphQL
       module Mutation
         module AiSummary
-          # Triggers AI summary generation for a page or stage.
-          # Returns an AiSummaryVersion with the generated text and token usage.
-          # Generation is synchronous — the response contains the result or an error.
+          # Triggers AI summary generation for a page or stage. Returns an `AiSummaryVersion`.
           #
-          # stageId is optional: omit for page-level summary, provide for stage-level.
+          # ★ Corrected 2026-07-30 against the live schema — the previous wiring could never run:
+          # the mutation is `generatePageSummary(input: GenerateInput!)`, NOT `generateAiSummary`
+          # with flat `pageId`/`stageId` arguments, and `AiSummaryVersion` has no token fields.
+          #
+          # `stage_id` is optional: omit for a page-level summary, pass it for stage-level.
           class Generate < Logic::Mutation
-            field_name :generateAiSummary
+            field_name :generatePageSummary
 
             class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::AiSummaryGenerate'
 
+            def query(page_id:, stage_id: nil, **kargs, &block)
+              input = { pageId: page_id }
+              input[:stageId] = stage_id if stage_id
+              super(input: input, **kargs, &block)
+            end
+
             private
 
             def basic_block(&block)
               payload_block = block || default_payload_block
               proc {
-                mutation(pageId: :id!, stageId: :id) {
-                  generateAiSummary(pageId: :pageId, stageId: :stageId, &payload_block)
+                mutation(input: :GenerateInput!) {
+                  generatePageSummary(input: :input, &payload_block)
                 }
               }
             end
 
+            # AiSummaryVersion exposes: aiSummary, alreadyRated, createdAt, dataFieldLogs,
+            # generationErrors, id, pagePatchVer, status. Only the plain scalars are selected —
+            # `dataFieldLogs` / `generationErrors` / `createdAt` need their own selections.
             def default_payload_block
               proc {
                 errors { details fullMessages }
@@ -31,9 +42,8 @@
                   id
                   aiSummary
                   status
-                  inputTokens
-                  outputTokens
-                  totalTokens
+                  alreadyRated
+                  pagePatchVer
                 }
               }
             end

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

@@ -1,27 +1,42 @@
-module Ecoportal
+module Ecoportal
   module API
     class GraphQL
       module Mutation
         module AiSummary
-          # Submit a thumbs-up / thumbs-down rating on an AI summary version.
-          # sentiment: "THUMBS_UP" | "THUMBS_DOWN"
-          # aiSummaryVersionId: returned from generateAiSummary.item.id
+          # Submit a rating on an AI summary version.
+          #
+          # ★ Corrected 2026-07-30 against the live schema — the previous wiring could never run:
+          # the mutation is `submitPageAiSummaryFeedback(input: SubmitFeedbackInput!)`, the enum is
+          # `SentimentEnum` (there is no `AiSummarySentimentEnum`), and its values are
+          # **`positive` / `negative`** — not the "THUMBS_UP"/"THUMBS_DOWN" this used to document.
+          #
+          # `ai_summary_version_id` comes from `generatePageSummary`'s `item.id`.
           class SubmitFeedback < Logic::Mutation
-            field_name :submitAiSummaryFeedback
+            SENTIMENTS = %w[positive negative].freeze
+
+            field_name :submitPageAiSummaryFeedback
 
             class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::OkPayload'
 
+            def query(ai_summary_version_id:, sentiment:, **kargs, &block)
+              unless SENTIMENTS.include?(sentiment.to_s)
+                raise ArgumentError, "sentiment must be one of #{SENTIMENTS.join(' / ')}; got #{sentiment.inspect}"
+              end
+
+              super(
+                input: { aiSummaryVersionId: ai_summary_version_id, sentiment: sentiment.to_s },
+                **kargs,
+                &block
+              )
+            end
+
             private
 
             def basic_block(&block)
               payload_block = block || default_payload_block
               proc {
-                mutation(aiSummaryVersionId: :id!, sentiment: :AiSummarySentimentEnum!) {
-                  submitAiSummaryFeedback(
-                    aiSummaryVersionId: :aiSummaryVersionId,
-                    sentiment:          :sentiment,
-                    &payload_block
-                  )
+                mutation(input: :SubmitFeedbackInput!) {
+                  submitPageAiSummaryFeedback(input: :input, &payload_block)
                 }
               }
             end

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

@@ -1,13 +1,13 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module AiSummary
-        end
-      end
-    end
-  end
-end
-
-require_relative 'ai_summary/generate'
-require_relative 'ai_summary/submit_feedback'
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module AiSummary
+        end
+      end
+    end
+  end
+end
+
+require_relative 'ai_summary/generate'
+require_relative 'ai_summary/submit_feedback'

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

@@ -1,40 +1,40 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module ContractorEntity
-          class Create < Logic::Mutation
-            field_name :createContractorEntity
-
-            class_resolver :payload_class, Payload::ContractorEntity::Create
-            class_resolver :input_class, Input::ContractorEntity::Create
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :CreateContractorEntityInput!) {
-                  createContractorEntity(input: :input, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                errors {
-                  details
-                  fullMessages
-                }
-                item {
-                  spread :ContractorEntity
-                }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module ContractorEntity
+          class Create < Logic::Mutation
+            field_name :createContractorEntity
+
+            class_resolver :payload_class, Payload::ContractorEntity::Create
+            class_resolver :input_class, Input::ContractorEntity::Create
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :CreateContractorEntityInput!) {
+                  createContractorEntity(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors {
+                  details
+                  fullMessages
+                }
+                item {
+                  spread :ContractorEntity
+                }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,40 +1,40 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module ContractorEntity
-          class Destroy < Logic::Mutation
-            field_name :destroyContractorEntity
-
-            class_resolver :payload_class, Payload::ContractorEntity::Destroy
-            class_resolver :input_class, Input::ContractorEntity::Destroy
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :DestroyContractorEntityInput!) {
-                  destroyContractorEntity(input: :input, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                errors {
-                  details
-                  fullMessages
-                }
-                item {
-                  spread :ContractorEntity
-                }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module ContractorEntity
+          class Destroy < Logic::Mutation
+            field_name :destroyContractorEntity
+
+            class_resolver :payload_class, Payload::ContractorEntity::Destroy
+            class_resolver :input_class, Input::ContractorEntity::Destroy
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :DestroyContractorEntityInput!) {
+                  destroyContractorEntity(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors {
+                  details
+                  fullMessages
+                }
+                item {
+                  spread :ContractorEntity
+                }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,40 +1,40 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module ContractorEntity
-          class Update < Ecoportal::API::GraphQL::Logic::Mutation
-            field_name :updateContractorEntity
-
-            class_resolver :payload_class, Ecoportal::API::GraphQL::Payload::ContractorEntity::Update
-            class_resolver :input_class, Ecoportal::API::GraphQL::Input::ContractorEntity::Update
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :UpdateContractorEntityInput!) {
-                  updateContractorEntity(input: :input, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                errors {
-                  details
-                  fullMessages
-                }
-                item {
-                  spread :ContractorEntity
-                }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module ContractorEntity
+          class Update < Ecoportal::API::GraphQL::Logic::Mutation
+            field_name :updateContractorEntity
+
+            class_resolver :payload_class, Ecoportal::API::GraphQL::Payload::ContractorEntity::Update
+            class_resolver :input_class, Ecoportal::API::GraphQL::Input::ContractorEntity::Update
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :UpdateContractorEntityInput!) {
+                  updateContractorEntity(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors {
+                  details
+                  fullMessages
+                }
+                item {
+                  spread :ContractorEntity
+                }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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/location_structure/apply_commands.rb

@@ -1,54 +1,54 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module LocationStructure
-          class ApplyCommands < Logic::Mutation
-            field_name :applyCommandsToLocationStructure
-            class_resolver :payload_class, Payload::LocationStructure::ApplyCommands
-            class_resolver :input_class, Input::LocationStructure::ApplyCommands
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :ApplyCommandsToLocationStructureInput!) {
-                  applyCommandsToLocationStructure(
-                    input: :input,
-                    &payload_block
-                  )
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                error {
-                  spread :LocationsError
-                }
-                results {
-                  ok
-                  command {
-                    id
-                    state
-                    __typename
-                  }
-                  error {
-                    spread :LocationsError
-                  }
-                }
-                structure {
-                  nodes(includeArchived: true) {
-                    spread :LocationNode
-                  }
-                }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module LocationStructure
+          class ApplyCommands < Logic::Mutation
+            field_name :applyCommandsToLocationStructure
+            class_resolver :payload_class, Payload::LocationStructure::ApplyCommands
+            class_resolver :input_class, Input::LocationStructure::ApplyCommands
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :ApplyCommandsToLocationStructureInput!) {
+                  applyCommandsToLocationStructure(
+                    input: :input,
+                    &payload_block
+                  )
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                error {
+                  spread :LocationsError
+                }
+                results {
+                  ok
+                  command {
+                    id
+                    state
+                    __typename
+                  }
+                  error {
+                    spread :LocationsError
+                  }
+                }
+                structure {
+                  nodes(includeArchived: true) {
+                    spread :LocationNode
+                  }
+                }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end