ecoportal-api-graphql 1.3.14 → 1.3.15

data/lib/ecoportal/api/graphql/fragment/force.rb

@@ -3,6 +3,17 @@ module Ecoportal
     class GraphQL
       class Fragment
         # Fields for a Force object, including all bindings needed for scripting.
+        #
+        # `Force.bindings` is `[BindingInterface]` (verified in the backend:
+        # `app/graphql/types/force_type.rb` + `types/forces/binding_interface.rb`), so its common
+        # fields are selected directly on the interface — no per-member inline fragments needed.
+        #
+        # ★ The interface exposes ONLY `name` and `referenceId` (+ `reference` per concrete type):
+        # there is NO `id` on a binding. The previous selection asked for `id` inside
+        # `... on DataFieldBinding` / `... on SectionBinding`, which makes the whole query invalid.
+        # Read/write asymmetry to be aware of: `WorkflowEditBindingInput` / `removeBinding` DO
+        # require a binding `id`, so `Force::Binding#id` (and `BindingCollection#delete!`) has no
+        # readable source for it — tracked as a shape-asymmetry finding, not fixable client-side.
         fragment :ForceFields, <<~GRAPHQL
           fragment ForceFields on Force {
             id
@@ -11,16 +22,9 @@ module Ecoportal
             customScript
             globalBindingIds
             bindings {
-              ... on DataFieldBinding {
-                id
-                name
-                referenceId
-              }
-              ... on SectionBinding {
-                id
-                name
-                referenceId
-              }
+              __typename
+              name
+              referenceId
             }
           }
         GRAPHQL

data/lib/ecoportal/api/graphql/fragment/page_task.rb

@@ -0,0 +1,39 @@
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        # Fields of a page TASK (`TaskInterface`: CompletePage / InComment / ReviewPage).
+        #
+        # The review-task mutations (`approve/reject/restart/undoReviewPageTask`) return
+        # `item: TaskInterface` — NOT a page. They used to select `item { ...PageFields }`,
+        # which is invalid GraphQL ("Fragment PageFields on BasePageInterface can't be spread
+        # inside TaskInterface") and made every one of those mutations fail. The page the
+        # caller was after is reachable through `subject` (a `PageUnion`), so it is spread
+        # there — where `PageFields` is legal.
+        #
+        # Verified against the live schema (2026-07-30): TaskInterface exposes complete,
+        # completedAt, completedBy, completedByUser, createdAt, due, escalated, escalatedAt,
+        # escalationTimes, escalationsDetails, fromPublicTemplate, id, nextEscalationTime,
+        # overdue, relativeStatus, scheduledCallbacks, stageId, subject, taskNotes, users.
+        fragment :PageTaskFields, <<~GRAPHQL
+          fragment PageTaskFields on TaskInterface {
+            __typename
+            id
+            stageId
+            complete
+            overdue
+            escalated
+            relativeStatus
+            taskNotes
+            createdAt { dateTime }
+            completedAt { dateTime }
+            due { dateTime }
+            subject {
+              ...PageFields
+            }
+          }
+        GRAPHQL
+      end
+    end
+  end
+end

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

@@ -0,0 +1,51 @@
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        # `createTemplateRelatedPage` / `destroyTemplateRelatedPage` return
+        # `item: RelatedPages` — a related-pages CONFIG entry, not a page. They used to select
+        # `item { ...PageFields }` (invalid: "can't be spread inside RelatedPages"), which made
+        # both mutations fail.
+        #
+        # Verified against the live schema (2026-07-30): RelatedPages exposes filters
+        # (StoredEsFilter), hasInaccessibleVariables, id, pages (PreviewPageConnection),
+        # register (MinimalRegister), registerId, title. Only the scalars are selected here —
+        # `pages` is a connection and `filters`/`register` are objects needing their own
+        # selections; query them explicitly when needed.
+        fragment :TemplateRelatedPages, <<~GRAPHQL
+          fragment TemplateRelatedPages on RelatedPages {
+            id
+            title
+            registerId
+            hasInaccessibleVariables
+          }
+        GRAPHQL
+
+        # `updateTemplateInformation` returns `UpdateInformationPayload { item: Template }`.
+        # ★ NOTE the type asymmetry: elsewhere in this gem a "template" is a PAGE
+        # (`Query::Templates` and the other template payloads legitimately resolve to
+        # `Model::PageUnion`, and validate clean), but THIS mutation returns the narrow
+        # `Template` type — hence `item { ...PageFields }` was invalid ("can't be spread
+        # inside Template").
+        #
+        # Verified against the live schema (2026-07-30): Template exposes active,
+        # aiDescription, commands (connection), creatorEditable, creatorEnabled, creatorFlags,
+        # description, folders, id, public, publicConfig, templateContainerUid, templateType.
+        fragment :TemplateInformation, <<~GRAPHQL
+          fragment TemplateInformation on Template {
+            id
+            description
+            aiDescription
+            templateType
+            templateContainerUid
+            active
+            public
+            folders
+            creatorEnabled
+            creatorEditable
+          }
+        GRAPHQL
+      end
+    end
+  end
+end

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

@@ -35,3 +35,6 @@ require_relative 'fragment/page'
 require_relative 'fragment/pages'
 require_relative 'fragment/force'
 require_relative 'fragment/pages_workflow'
+require_relative 'fragment/field_configuration'
+require_relative 'fragment/page_task'
+require_relative 'fragment/template'

data/lib/ecoportal/api/graphql/model/page/task.rb

@@ -0,0 +1,16 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        module Page
+          # Concrete `Base::Page::Task` — adds the typed `subject` (the page the task belongs
+          # to), which the base class cannot declare because `Model::PageUnion` lives one layer
+          # up. Nullable: the caller may select the task without its subject.
+          class Task < Base::Page::Task
+            embeds_one :subject, klass: 'Ecoportal::API::GraphQL::Model::PageUnion', nullable: true
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,15 +1,16 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Model
-        module Page
-        end
-      end
-    end
-  end
-end
-
-require_relative 'page/basic'
-require_relative 'page/data_field'
-require_relative 'page/section'
-require_relative 'page/phased'
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        module Page
+        end
+      end
+    end
+  end
+end
+
+require_relative 'page/basic'
+require_relative 'page/data_field'
+require_relative 'page/section'
+require_relative 'page/phased'
+require_relative 'page/task'

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

@@ -0,0 +1,15 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Model
+        # Concrete counterparts of `Base::Template::*` (see there for the page-vs-Template
+        # type asymmetry). No extra wiring needed — both are flat, read-only models.
+        module Template
+          class Information < Base::Template::Information; end
+
+          class RelatedPages < Base::Template::RelatedPages; end
+        end
+      end
+    end
+  end
+end

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

@@ -28,3 +28,5 @@ require_relative 'model/preset_view'
 
 require_relative 'model/ai_summary_version'
 require_relative 'model/pages_workflow'
+
+require_relative 'model/template'

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

@@ -1,45 +1,45 @@
-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.
-          #
-          # stageId is optional: omit for page-level summary, provide for stage-level.
-          class Generate < Logic::Mutation
-            field_name :generateAiSummary
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::AiSummaryGenerate'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(pageId: :id!, stageId: :id) {
-                  generateAiSummary(pageId: :pageId, stageId: :stageId, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                errors { details fullMessages }
-                item {
-                  id
-                  aiSummary
-                  status
-                  inputTokens
-                  outputTokens
-                  totalTokens
-                }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+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.
+          #
+          # stageId is optional: omit for page-level summary, provide for stage-level.
+          class Generate < Logic::Mutation
+            field_name :generateAiSummary
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::AiSummaryGenerate'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(pageId: :id!, stageId: :id) {
+                  generateAiSummary(pageId: :pageId, stageId: :stageId, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                errors { details fullMessages }
+                item {
+                  id
+                  aiSummary
+                  status
+                  inputTokens
+                  outputTokens
+                  totalTokens
+                }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,40 +1,40 @@
-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
-          class SubmitFeedback < Logic::Mutation
-            field_name :submitAiSummaryFeedback
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::OkPayload'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(aiSummaryVersionId: :id!, sentiment: :AiSummarySentimentEnum!) {
-                  submitAiSummaryFeedback(
-                    aiSummaryVersionId: :aiSummaryVersionId,
-                    sentiment:          :sentiment,
-                    &payload_block
-                  )
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                ok
-                errors { details fullMessages }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+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
+          class SubmitFeedback < Logic::Mutation
+            field_name :submitAiSummaryFeedback
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::OkPayload'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(aiSummaryVersionId: :id!, sentiment: :AiSummarySentimentEnum!) {
+                  submitAiSummaryFeedback(
+                    aiSummaryVersionId: :aiSummaryVersionId,
+                    sentiment:          :sentiment,
+                    &payload_block
+                  )
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                ok
+                errors { details fullMessages }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,40 +1,40 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module Page
-          class ApproveReviewTask < Logic::Mutation
-            field_name :approveReviewPageTask
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Page::ReviewTask'
-            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Page::ReviewTask'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :ApproveReviewPageTaskInput!) {
-                  approveReviewPageTask(input: :input, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                errors {
-                  details
-                  fullMessages
-                }
-                item {
-                  spread :PageFields
-                }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Page
+          class ApproveReviewTask < Logic::Mutation
+            field_name :approveReviewPageTask
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Page::ReviewTask'
+            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Page::ReviewTask'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :ApproveReviewPageTaskInput!) {
+                  approveReviewPageTask(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors {
+                  details
+                  fullMessages
+                }
+                item {
+                  spread :PageTaskFields
+                }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,40 +1,38 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module Page
-          class BatchUpdateReviewTask < Logic::Mutation
-            field_name :batchUpdateReviewPageTask
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Page::ReviewTask'
-            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Page::ReviewTask'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :BatchUpdateReviewPageTaskInput!) {
-                  batchUpdateReviewPageTask(input: :input, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                errors {
-                  details
-                  fullMessages
-                }
-                item {
-                  spread :PageFields
-                }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Page
+          class BatchUpdateReviewTask < Logic::Mutation
+            field_name :batchUpdateReviewPageTask
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Page::ReviewTaskBatch'
+            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Page::ReviewTask'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :BatchUpdateReviewPageTaskInput!) {
+                  batchUpdateReviewPageTask(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors {
+                  details
+                  fullMessages
+                }
+                count
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,40 +1,38 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module Page
-          class CreateDraft < Logic::Mutation
-            field_name :createPageDraft
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Page::Draft'
-            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Page::CreateDraft'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :CreatePageDraftInput!) {
-                  createPageDraft(input: :input, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                errors {
-                  details
-                  fullMessages
-                }
-                item {
-                  spread :PageFields
-                }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Page
+          class CreateDraft < Logic::Mutation
+            field_name :createPageDraft
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Page::Draft'
+            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Page::CreateDraft'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :CreatePageDraftInput!) {
+                  createPageDraft(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors {
+                  details
+                  fullMessages
+                }
+                id
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end