ecoportal-api-graphql 1.3.17 → 2.0.0

data/lib/ecoportal/api/graphql/input/workflow_command/edit_template_container_uid.rb

@@ -0,0 +1,45 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # `WorkflowEditTemplateContainerUidInput { templateContainerUid: String! }`.
+          #
+          # Sets the template's CROSS-VERSION identity key. Semantics (verified against the
+          # backend on 2026-07-31 — see `.ai-assistance/code/ecoPortal_architecture/02_data_model.md`):
+          #
+          # - Format `/\A[a-zA-Z0-9\-_.]{3,20}\z/` — org-scoped, human-authored.
+          # - Many versions of a template may share one uid, but only ONE may be published
+          #   (`active: true`, unarchived) per organization at a time. Publishing another with
+          #   the same uid UNPUBLISHES the incumbent (a swap, not an error), which is what stops
+          #   restored UAT backups from colliding with the live PROD template.
+          # - Rejected with `:template_container_uid, :taken` when the swap is not permitted.
+          # - Requires `Pages::TemplatePolicy#change_template_container_uid?`
+          #   (`required_level: :implement`).
+          #
+          # The value is REQUIRED and non-null in the schema, so nil is rejected here rather
+          # than silently dropped — `.compact` (as used by the sibling builders) would emit an
+          # empty command that the server rejects with a less obvious message.
+          module EditTemplateContainerUid
+            SCHEMA_VERSION = '20260731'.freeze
+            VALID_KEYS = %i[templateContainerUid].freeze
+            UID_FORMAT = /\A[a-zA-Z0-9\-_.]{3,20}\z/
+
+            def self.build(**kwargs)
+              uid = kwargs[:templateContainerUid]
+              raise ArgumentError, 'templateContainerUid is required (String!)' if uid.nil?
+
+              unless UID_FORMAT.match?(uid.to_s)
+                raise ArgumentError,
+                      "Invalid templateContainerUid #{uid.inspect}: " \
+                      'use 3-20 characters (letters, numbers, -, _, . only)'
+              end
+
+              { templateContainerUid: uid.to_s }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/{edit_page_creator_permissions.rb → edit_template_creator_permissions.rb}

@@ -3,8 +3,9 @@ module Ecoportal
     class GraphQL
       module Input
         class WorkflowCommand
-          module EditPageCreatorPermissions
-            SCHEMA_VERSION = '20260605'.freeze
+          # 20260713: replaces the page-level `editPageCreatorPermissions` command (template-scoped).
+          module EditTemplateCreatorPermissions
+            SCHEMA_VERSION = '20260713'.freeze
             VALID_KEYS = %i[creatorEnabled creatorEditable creatorFlags].freeze
 
             def self.build(**kwargs)

data/lib/ecoportal/api/graphql/input/workflow_command/edit_template_descriptions.rb

@@ -0,0 +1,19 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # 20260713
+          module EditTemplateDescriptions
+            SCHEMA_VERSION = '20260713'.freeze
+            VALID_KEYS = %i[description aiDescription templateType].freeze
+
+            def self.build(**kwargs)
+              kwargs.slice(*VALID_KEYS).compact
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/edit_trigger.rb

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module EditTrigger
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[stageId taskId callbackId triggers].freeze
-
-            def self.build(**kwargs)
-              kwargs.slice(*VALID_KEYS).compact
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module EditTrigger
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[stageId taskId callbackId triggers].freeze
+
+            def self.build(**kwargs)
+              kwargs.slice(*VALID_KEYS).compact
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/expand_section.rb

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module ExpandSection
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[sectionId].freeze
-
-            def self.build(**kwargs)
-              kwargs.slice(*VALID_KEYS).compact
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module ExpandSection
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[sectionId].freeze
+
+            def self.build(**kwargs)
+              kwargs.slice(*VALID_KEYS).compact
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/action_list.rb

@@ -0,0 +1,31 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module EditFieldConfiguration
+            # `WorkflowEditFieldConfigurationActionListInput` — the 14th (and last unwired)
+            # member of `WorkflowEditFieldConfigurationByTypeInput`. Added to the schema in the
+            # 20260725 drift and never picked up, which left ActionsList the one field type whose
+            # configuration could not be edited through this gem.
+            #
+            # NOTE the naming asymmetry, which is the schema's, not ours: the byType KEY is
+            # `actionList` (singular) while the field TYPE is `ActionsList` (plural) — hence
+            # `Base::Page::DataField::TYPE_MAP` maps `'ActionsList'`. Keep this module named after
+            # the byType key so the registry lookup stays mechanical.
+            module ActionList
+              SCHEMA_VERSION = '20260725'.freeze
+              VALID_KEYS = %i[requiredCompleted].freeze
+              # ActionsListRequiredCompletedEnum (verified against the live schema, 20260731)
+              REQUIRED_COMPLETED = %w[NONE SOME ALL].freeze
+
+              def self.build(**kwargs)
+                { actionList: kwargs.slice(*VALID_KEYS).compact }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/contractor_entities.rb

@@ -1,24 +1,24 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module EditFieldConfiguration
-            module ContractorEntities
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[
-                singular requiresNumber isMeButton showApprovalStatus grantPermissionsEnabled
-                applyAttachedContractorsPermissionsTo adminAccess regularAccess
-                attachedContractorsPermissionsFlags attachedContractorsAdminPermissionsFlags
-              ].freeze
-
-              def self.build(**kwargs)
-                { contractorEntities: kwargs.slice(*VALID_KEYS).compact }
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module EditFieldConfiguration
+            module ContractorEntities
+              SCHEMA_VERSION = '20260605'.freeze
+              VALID_KEYS = %i[
+                singular requiresNumber isMeButton showApprovalStatus grantPermissionsEnabled
+                applyAttachedContractorsPermissionsTo adminAccess regularAccess
+                attachedContractorsPermissionsFlags attachedContractorsAdminPermissionsFlags
+              ].freeze
+
+              def self.build(**kwargs)
+                { contractorEntities: kwargs.slice(*VALID_KEYS).compact }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/cross_reference.rb

@@ -5,10 +5,12 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module CrossReference
-              SCHEMA_VERSION = '20260605'.freeze
+              SCHEMA_VERSION = '20260713'.freeze
+              # 20260713: gained addReferenceIds/removeReferenceIds (set-diff of attached references).
               VALID_KEYS = %i[
                 displayFields displayFieldsInLookup hideCreate hideAttach hideMetadata
                 registerId attachSourcePage hideDashboards singleSelectMode
+                addReferenceIds removeReferenceIds
               ].freeze
 
               def self.build(**kwargs)

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/date.rb

@@ -5,8 +5,21 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module Date
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[showTime pastOnly todayButton smartFillConfiguration removeSmartFillConfiguration].freeze
+              SCHEMA_VERSION = '20260725'.freeze
+              # 20260713: smartFillConfiguration moved out to dedicated add/edit/removeSmartFillConfig commands.
+              # 20260725: gained the date-EVENT and RENEWAL keys below (calendar events + recurring
+              # expiry on a date field). Six keys that had never been reachable from this gem —
+              # renewals are how expiry-driven registers (certifications, inductions, permits)
+              # are configured, so this was a real functional hole, not a cosmetic one.
+              VALID_KEYS = %i[
+                showTime pastOnly todayButton
+                createEvent remindMeIn
+                renews renewsEvery renewsUnit renewsUntil
+              ].freeze
+              # PagesDataFieldsDatesRenewsUnitEnum
+              RENEWS_UNITS = %w[DAY WEEK MONTH YEAR].freeze
+              # DateEventRemindOption
+              REMIND_OPTIONS = %w[NEVER ONE_DAY THREE_DAYS ONE_WEEK TWO_WEEKS ONE_MONTH].freeze
 
               def self.build(**kwargs)
                 { date: kwargs.slice(*VALID_KEYS).compact }

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/file.rb

@@ -0,0 +1,21 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module EditFieldConfiguration
+            # 20260713: `file` by-type field configuration (set-diff of file containers/items).
+            module File
+              SCHEMA_VERSION = '20260713'.freeze
+              VALID_KEYS = %i[addFileContainerIds removeItemIds].freeze
+
+              def self.build(**kwargs)
+                { file: kwargs.slice(*VALID_KEYS).compact }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/gauge.rb

@@ -1,20 +1,20 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module EditFieldConfiguration
-            module Gauge
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[max].freeze
-
-              def self.build(**kwargs)
-                { gauge: kwargs.slice(*VALID_KEYS).compact }
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module EditFieldConfiguration
+            module Gauge
+              SCHEMA_VERSION = '20260605'.freeze
+              VALID_KEYS = %i[max].freeze
+
+              def self.build(**kwargs)
+                { gauge: kwargs.slice(*VALID_KEYS).compact }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/image_gallery.rb

@@ -5,8 +5,9 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module ImageGallery
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[layout stretch noPopup hideOptions].freeze
+              SCHEMA_VERSION = '20260713'.freeze
+              # 20260713: gained addImageSourceIds/removeImageIds (set-diff of gallery images).
+              VALID_KEYS = %i[layout stretch noPopup hideOptions addImageSourceIds removeImageIds].freeze
 
               def self.build(**kwargs)
                 { imageGallery: kwargs.slice(*VALID_KEYS).compact }

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/location_field.rb

@@ -1,24 +1,24 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module EditFieldConfiguration
-            module LocationField
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[
-                buttonText minimumRequired singleSelect autoselectDefaultLocation
-                restrictByClassification addAllowedClassifications removeAllowedClassifications
-                addAllowedStructures removeAllowedStructures
-              ].freeze
-
-              def self.build(**kwargs)
-                { locationField: kwargs.slice(*VALID_KEYS).compact }
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module EditFieldConfiguration
+            module LocationField
+              SCHEMA_VERSION = '20260605'.freeze
+              VALID_KEYS = %i[
+                buttonText minimumRequired singleSelect autoselectDefaultLocation
+                restrictByClassification addAllowedClassifications removeAllowedClassifications
+                addAllowedStructures removeAllowedStructures
+              ].freeze
+
+              def self.build(**kwargs)
+                { locationField: kwargs.slice(*VALID_KEYS).compact }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/people.rb

@@ -5,15 +5,39 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module People
-              SCHEMA_VERSION = '20260605'.freeze
+              SCHEMA_VERSION = '20260725'.freeze
+              # 20260725: `addViewableFields`/`removeViewableFields` were REMOVED from
+              # WorkflowEditFieldConfigurationPeopleInput — they lived on here as dead keys the
+              # server rejects. Viewable fields are now three dedicated commands
+              # (add/move/removeViewableField), which also added ordering the flat arrays could
+              # not express. The same drift added the six attached-people-permission /
+              # allowed-user-group keys below, which had never been reachable from this gem.
               VALID_KEYS = %i[
                 personSchemaId singular requiresNumber attachMode isMeButton
                 autoSelectMode autoSelectSupervisorFieldRef autoSelectDefaultLocations
-                addViewableFields removeViewableFields
+                addAllowedUserGroupIds removeAllowedUserGroupIds
+                attachedPeoplePermissionsEnabled attachedPeoplePermissionsEditable
+                attachedPeoplePermissionsFlags applyAttachedPeoplePermissionsTo
+              ].freeze
+              # WorkflowAutoSelectModeEnum — `autoSelectMode` was retyped String -> enum in the
+              # same drift. Values pass through as strings (valid for enum variables).
+              AUTO_SELECT_MODES = %w[NONE CREATOR CREATOR_SUPERVISOR PEOPLE_SUPERVISOR].freeze
+              # WorkflowApplyAttachedPeoplePermissionsToEnum
+              APPLY_PERMISSIONS_TO = %w[PAGE_ONLY PAGE ALL_STAGES CURRENT_STAGE].freeze
+              # Nested WorkflowEditFieldConfigurationAttachedPeoplePermissionsFlagsInput keys.
+              PERMISSION_FLAGS = %i[
+                canRestructure canConfigure canPermission canCreateActions
+                canAdministrateActions subscribed subscribedToTasks
               ].freeze
 
               def self.build(**kwargs)
-                { people: kwargs.slice(*VALID_KEYS).compact }
+                out = kwargs.slice(*VALID_KEYS).compact
+                # Filter the nested flags hash to the keys the schema actually declares, so a
+                # stray key can't sink the whole command server-side.
+                if (flags = out[:attachedPeoplePermissionsFlags]).is_a?(Hash)
+                  out[:attachedPeoplePermissionsFlags] = flags.slice(*PERMISSION_FLAGS).compact
+                end
+                { people: out }
               end
             end
           end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/plain_text.rb

@@ -5,8 +5,9 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module PlainText
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[value maxLength embeddingEnabled smartFillConfiguration removeSmartFillConfiguration].freeze
+              SCHEMA_VERSION = '20260713'.freeze
+              # 20260713: smartFillConfiguration moved out to dedicated add/edit/removeSmartFillConfig commands.
+              VALID_KEYS = %i[value maxLength embeddingEnabled].freeze
 
               def self.build(**kwargs)
                 { plainText: kwargs.slice(*VALID_KEYS).compact }

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/rich_text.rb

@@ -5,8 +5,9 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module RichText
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[content markdown embeddingEnabled smartFillConfiguration removeSmartFillConfiguration].freeze
+              SCHEMA_VERSION = '20260713'.freeze
+              # 20260713: smartFillConfiguration moved out to dedicated add/edit/removeSmartFillConfig commands.
+              VALID_KEYS = %i[content markdown embeddingEnabled].freeze
 
               def self.build(**kwargs)
                 { richText: kwargs.slice(*VALID_KEYS).compact }

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/select.rb

@@ -5,8 +5,9 @@ module Ecoportal
         class WorkflowCommand
           module EditFieldConfiguration
             module Select
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[dataType multiple flat other otherDesc smartFillConfiguration removeSmartFillConfiguration].freeze
+              SCHEMA_VERSION = '20260713'.freeze
+              # 20260713: smartFillConfiguration moved out to dedicated add/edit/removeSmartFillConfig commands.
+              VALID_KEYS = %i[dataType multiple flat other otherDesc].freeze
 
               def self.build(**kwargs)
                 { select: kwargs.slice(*VALID_KEYS).compact }

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/signature.rb

@@ -1,20 +1,20 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module EditFieldConfiguration
-            module Signature
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[color].freeze
-
-              def self.build(**kwargs)
-                { signature: kwargs.slice(*VALID_KEYS).compact }
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module EditFieldConfiguration
+            module Signature
+              SCHEMA_VERSION = '20260605'.freeze
+              VALID_KEYS = %i[color].freeze
+
+              def self.build(**kwargs)
+                { signature: kwargs.slice(*VALID_KEYS).compact }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/field_config/table.rb

@@ -1,25 +1,25 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module EditFieldConfiguration
-            module Table
-              SCHEMA_VERSION = '20260605'.freeze
-              VALID_KEYS = %i[
-                tableType jurisdictionFieldRef industrialAwardFieldRef
-                workAgreementFieldRef preIncapacityFieldRef claimStatusFieldRef
-                firstIncapacityFieldRef endIncapacityFieldRef
-                firstDayOfTheWeek inProgress nextRowAdditionAt
-              ].freeze
-
-              def self.build(**kwargs)
-                { table: kwargs.slice(*VALID_KEYS).compact }
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module EditFieldConfiguration
+            module Table
+              SCHEMA_VERSION = '20260605'.freeze
+              VALID_KEYS = %i[
+                tableType jurisdictionFieldRef industrialAwardFieldRef
+                workAgreementFieldRef preIncapacityFieldRef claimStatusFieldRef
+                firstIncapacityFieldRef endIncapacityFieldRef
+                firstDayOfTheWeek inProgress nextRowAdditionAt
+              ].freeze
+
+              def self.build(**kwargs)
+                { table: kwargs.slice(*VALID_KEYS).compact }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/input/workflow_command/move_field.rb

@@ -4,8 +4,9 @@ module Ecoportal
       module Input
         class WorkflowCommand
           module MoveField
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[id sectionId column].freeze
+            SCHEMA_VERSION = '20260713'.freeze
+            # 20260713: gained anchor-based positioning (anchorId/anchorPosition).
+            VALID_KEYS = %i[id sectionId column anchorId anchorPosition].freeze
 
             def self.build(**kwargs)
               kwargs.slice(*VALID_KEYS).compact

data/lib/ecoportal/api/graphql/input/workflow_command/move_stage.rb

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module MoveStage
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[stageId ordering].freeze
-
-            def self.build(**kwargs)
-              kwargs.slice(*VALID_KEYS).compact
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module MoveStage
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[stageId ordering].freeze
+
+            def self.build(**kwargs)
+              kwargs.slice(*VALID_KEYS).compact
+            end
+          end
+        end
+      end
+    end
+  end
+end