ecoportal-api-graphql 2.0.0 → 3.0.0

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

@@ -1,40 +1,40 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module Page
-          class Update < Logic::Mutation
-            field_name :updatePage
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Page::Update'
-            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Page::Update'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :UpdatePageInput!) {
-                  updatePage(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 Update < Logic::Mutation
+            field_name :updatePage
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Page::Update'
+            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Page::Update'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :UpdatePageInput!) {
+                  updatePage(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors {
+                  details
+                  fullMessages
+                }
+                item {
+                  spread :PageFields
+                }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,28 +1,28 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        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/create_draft'
-require_relative 'page/delete_draft'
-require_relative 'page/publish_draft'
-require_relative 'page/approve_review_task'
-require_relative 'page/reject_review_task'
-require_relative 'page/restart_review_task'
-require_relative 'page/undo_review_task'
-require_relative 'page/batch_update_review_task'
-
-require_relative 'page/execute_force_commands'
-require_relative 'page/execute_workflow_commands'
-require_relative 'page/update_variable_bindings'
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        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/create_draft'
+require_relative 'page/delete_draft'
+require_relative 'page/publish_draft'
+require_relative 'page/approve_review_task'
+require_relative 'page/reject_review_task'
+require_relative 'page/restart_review_task'
+require_relative 'page/undo_review_task'
+require_relative 'page/batch_update_review_task'
+
+require_relative 'page/execute_force_commands'
+require_relative 'page/execute_workflow_commands'
+require_relative 'page/update_variable_bindings'

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

@@ -1,35 +1,35 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module PresetView
-          class Create < Logic::Mutation
-            field_name :createPresetView
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::PresetView'
-            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::PresetView::Create'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :CreatePresetViewInput!) {
-                  createPresetView(input: :input, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                errors { details fullMessages }
-                item { id name registerId global }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module PresetView
+          class Create < Logic::Mutation
+            field_name :createPresetView
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::PresetView'
+            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::PresetView::Create'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :CreatePresetViewInput!) {
+                  createPresetView(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors { details fullMessages }
+                item { id name registerId global }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,4 +1,4 @@
-module Ecoportal
+module Ecoportal
   module API
     class GraphQL
       module Mutation

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

@@ -1,37 +1,37 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module PresetView
-          # Grant/revoke view or edit access to users or user groups.
-          # permissions: [{ id:, level: "view"|"edit", to: { userId: } | { userGroupId: }, destroy: }]
-          class Permission < Logic::Mutation
-            field_name :permissionPresetView
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::PresetView'
-            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::PresetView::Permission'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :PermissionPresetViewInput!) {
-                  permissionPresetView(input: :input, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                errors { details fullMessages }
-                item { id name }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module PresetView
+          # Grant/revoke view or edit access to users or user groups.
+          # permissions: [{ id:, level: "view"|"edit", to: { userId: } | { userGroupId: }, destroy: }]
+          class Permission < Logic::Mutation
+            field_name :permissionPresetView
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::PresetView'
+            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::PresetView::Permission'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :PermissionPresetViewInput!) {
+                  permissionPresetView(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors { details fullMessages }
+                item { id name }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,35 +1,35 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module PresetView
-          class Update < Logic::Mutation
-            field_name :updatePresetView
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::PresetView'
-            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::PresetView::Update'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :UpdatePresetViewInput!) {
-                  updatePresetView(input: :input, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                errors { details fullMessages }
-                item { id name registerId global }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module PresetView
+          class Update < Logic::Mutation
+            field_name :updatePresetView
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::PresetView'
+            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::PresetView::Update'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :UpdatePresetViewInput!) {
+                  updatePresetView(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors { details fullMessages }
+                item { id name registerId global }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,15 +1,15 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module PresetView
-        end
-      end
-    end
-  end
-end
-
-require_relative 'preset_view/create'
-require_relative 'preset_view/update'
-require_relative 'preset_view/permission'
-require_relative 'preset_view/destroy'
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module PresetView
+        end
+      end
+    end
+  end
+end
+
+require_relative 'preset_view/create'
+require_relative 'preset_view/update'
+require_relative 'preset_view/permission'
+require_relative 'preset_view/destroy'

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

@@ -1,35 +1,35 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module Register
-          class Create < Logic::Mutation
-            field_name :createRegister
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Register'
-            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Register::Create'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :CreateRegisterInput!) {
-                  createRegister(input: :input, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                errors { details fullMessages }
-                item { id name moduleType registerStatus shown }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Register
+          class Create < Logic::Mutation
+            field_name :createRegister
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Register'
+            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Register::Create'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :CreateRegisterInput!) {
+                  createRegister(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors { details fullMessages }
+                item { id name moduleType registerStatus shown }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,4 +1,4 @@
-module Ecoportal
+module Ecoportal
   module API
     class GraphQL
       module Mutation

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

@@ -1,35 +1,35 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module Register
-          class Update < Logic::Mutation
-            field_name :updateRegister
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Register'
-            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Register::Update'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(input: :UpdateRegisterInput!) {
-                  updateRegister(input: :input, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                clientMutationId
-                errors { details fullMessages }
-                item { id name moduleType registerStatus shown }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Register
+          class Update < Logic::Mutation
+            field_name :updateRegister
+
+            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Register'
+            class_resolver :input_class,   'Ecoportal::API::GraphQL::Input::Register::Update'
+
+            private
+
+            def basic_block(&block)
+              payload_block = block || default_payload_block
+              proc {
+                mutation(input: :UpdateRegisterInput!) {
+                  updateRegister(input: :input, &payload_block)
+                }
+              }
+            end
+
+            def default_payload_block
+              proc {
+                clientMutationId
+                errors { details fullMessages }
+                item { id name moduleType registerStatus shown }
+              }
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,14 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module Register
-        end
-      end
-    end
-  end
-end
-
-require_relative 'register/create'
-require_relative 'register/update'
-require_relative 'register/destroy'
+module Ecoportal
+  module API
+    class GraphQL
+      module Mutation
+        module Register
+        end
+      end
+    end
+  end
+end
+
+require_relative 'register/create'
+require_relative 'register/update'
+require_relative 'register/destroy'

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

@@ -3,15 +3,47 @@ module Ecoportal
     class GraphQL
       module Mutation
         module Template
+          # `createPageTemplate(input: CreatePageTemplateInput!)` — creates a template page from
+          # a `WorkflowCommand` batch.
+          #
+          # ★ `registerId` IS NOT COSMETIC — it is what makes the create AUTHORIZABLE.
+          #
+          # The backend resolves a page's registers BY TAG
+          # (`NewEp::Pages::AssociatedRegisters`: org registers whose `filter_tags` are a subset
+          # of the page's `combined_tags`), and `RegisterTemplatePermissionChecker` returns
+          # `false` outright when that set is EMPTY. A template created without `registerId`
+          # carries no `base_tags`, so it is associated with ZERO registers, so the check fails
+          # regardless of what the account is granted — surfacing as the misleading
+          # `You are not authorized to perform: edit_template_basic_settings`.
+          # `Pages::Templates::CreateForm#bind_register!` is what closes that hole: given
+          # `register_id` it sets `page.base_tags = register.filter_tags` BEFORE the commands run.
+          #
+          # SHAPE (verified against the LIVE eu.live SDL, 2026-09-04): `registerId: ID` is an
+          # INPUT FIELD of `CreatePageTemplateInput`, not a sibling argument of the mutation —
+          # the backend mutation declares `argument :register_id, ID, required: false` next to
+          # `argument :commands`, but `Mutations::BaseMutation < GraphQL::Schema::RelayClassicMutation`
+          # folds every argument into the generated input object. So it travels inside `input:`,
+          # exactly like `commands`.
           class Create < Logic::Mutation
-            SCHEMA_VERSION = '20260605'.freeze
+            SCHEMA_VERSION = '20260904'.freeze
 
             field_name :createPageTemplate
 
             class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Template::Create'
 
-            def query(commands:, **kargs, &block)
-              super(input: { commands: commands }, **kargs, &block)
+            # @param commands [Array<Hash>] the `WorkflowCommand` batch.
+            # @param register_id [String, nil] the register to bind the new template to. Omitted
+            #   when nil — never sent as an explicit null, so existing call sites keep producing
+            #   the byte-identical input they produced before this key existed.
+            def query(commands:, register_id: nil, **kargs, &block)
+              super(input: self.class.build_input(commands: commands, register_id: register_id), **kargs, &block)
+            end
+
+            # Extracted so the omit-nil rule is testable without a client or a network stub.
+            def self.build_input(commands:, register_id: nil)
+              {commands: commands}.tap do |input|
+                input[:registerId] = register_id unless register_id.nil?
+              end
             end
 
             private

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

@@ -10,9 +10,11 @@ module Ecoportal
 
             class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::Template::Update'
 
-            def query(id:, patch_ver:, commands:, **kargs, &block)
+            def query(id:, patch_ver:, commands:, client_mutation_id: nil, **kargs, &block)
+              input = { id: id, patchVer: patch_ver, commands: commands }
+              input[:clientMutationId] = client_mutation_id unless client_mutation_id.nil?
               super(
-                input: { id: id, patchVer: patch_ver, commands: commands },
+                input: input,
                 **kargs,
                 &block
               )

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

@@ -18,3 +18,4 @@ require_relative 'mutation/ai_summary'
 require_relative 'mutation/kickstand'
 require_relative 'mutation/template'
 require_relative 'mutation/file_container'
+require_relative 'mutation/image'