ecoportal-api-graphql 1.3.16 → 2.2.0

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

@@ -1,23 +1,23 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module AddScheduledCallback
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[
-              placeholderId stageId taskId
-              dueInValue dueInUnit dueExcludeWeekends
-              recurs recursInValue recursInUnit recursExcludeWeekends
-              actions
-            ].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 AddScheduledCallback
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[
+              placeholderId stageId taskId
+              dueInValue dueInUnit dueExcludeWeekends
+              recurs recursInValue recursInUnit recursExcludeWeekends
+              actions
+            ].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/add_scheduled_callback_action.rb

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module AddScheduledCallbackAction
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[stageId taskId scheduledCallbackId action].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 AddScheduledCallbackAction
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[stageId taskId scheduledCallbackId action].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/add_section.rb

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module AddSection
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[placeholderId layout].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 AddSection
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[placeholderId layout].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/add_select_field_option.rb

@@ -1,19 +1,25 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module AddSelectFieldOption
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[dataFieldId placeholderId label weight].freeze
-
-            def self.build(data_field_id:, label:, **kwargs)
-              { dataFieldId: data_field_id, label: label }.
-                merge(kwargs.slice(*VALID_KEYS - %i[dataFieldId label]).compact)
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          module AddSelectFieldOption
+            SCHEMA_VERSION = '20260828'.freeze
+            # 20260828: added `value`, which the backend's AddSelectFieldOptionInput declares as
+            # `required: true` (schema authority: backend source, not the stale 2026-07-30
+            # introspection dump). This builder previously dropped it via kwargs.slice, so every
+            # call built by this class was rejected by the server for a missing required
+            # argument. `value` is always sent as a String, even for numeric select fields (an
+            # integral value is stored as an Integer by the server).
+            VALID_KEYS = %i[dataFieldId placeholderId label value weight].freeze
+
+            def self.build(data_field_id:, label:, value:, **kwargs)
+              { dataFieldId: data_field_id, label: label, value: value }.
+                merge(kwargs.slice(*VALID_KEYS - %i[dataFieldId label value]).compact)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,23 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # 20260713: smart-fill (AI) configuration extracted from the field-config inputs
+          # into its own add/edit/remove command family. `fieldConfigurations` accepts an array
+          # of pre-built WorkflowSmartFillFieldConfigurationInput hashes.
+          module AddSmartFillConfig
+            SCHEMA_VERSION = '20260713'.freeze
+            VALID_KEYS = %i[
+              dataFieldId triggerType instructions editEnabled textFormat limitLength fieldConfigurations
+            ].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/add_stage.rb

@@ -4,8 +4,9 @@ module Ecoportal
       module Input
         class WorkflowCommand
           module AddStage
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[placeholderId name ordering].freeze
+            SCHEMA_VERSION = '20260713'.freeze
+            # 20260713: gained `tags` (create a stage already tagged, rather than adding stage tags after).
+            VALID_KEYS = %i[placeholderId name ordering tags].freeze
 
             def self.build(**kwargs)
               kwargs.slice(*VALID_KEYS).compact

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

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module AddStageSection
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[stageId 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 AddStageSection
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[stageId 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/add_stage_tag.rb

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module AddStageTag
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[stageId tag].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 AddStageTag
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[stageId tag].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/add_strategy.rb

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module AddStrategy
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[placeholderId stageId taskId strategy].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 AddStrategy
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[placeholderId stageId taskId strategy].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/add_task.rb

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module AddTask
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[placeholderId stageId taskType].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 AddTask
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[placeholderId stageId taskType].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/add_task_assignment_user_group.rb

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module AddTaskAssignmentUserGroup
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[stageId userGroupId].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 AddTaskAssignmentUserGroup
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[stageId userGroupId].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/add_viewable_field.rb

@@ -0,0 +1,45 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # `WorkflowAddViewableFieldInput` — adds a person-schema field to the list of fields
+          # shown on a People data field ("viewable fields").
+          #
+          # ★ This command exists BECAUSE the 20260725 schema drift REMOVED
+          # `WorkflowEditFieldConfigurationPeopleInput.addViewableFields: [String!]`. Viewable
+          # fields moved from an array on the people field-config to three dedicated commands
+          # (add/move/remove), which also bought them ordering (`anchorId` + `anchorPosition`)
+          # that the old flat array could not express. Until these were wired, viewable-field
+          # management was simply impossible through this gem.
+          module AddViewableField
+            SCHEMA_VERSION = '20260725'.freeze
+            VALID_KEYS = %i[
+              dataFieldId schemaFieldId schemaFieldType anchorId anchorPosition
+            ].freeze
+            # AnchorPositionEnum
+            ANCHOR_POSITIONS = %w[BEFORE AFTER].freeze
+
+            def self.build(data_field_id:, schema_field_id:, **kwargs)
+              validate_anchor!(kwargs[:anchorPosition])
+
+              {
+                dataFieldId:   data_field_id,
+                schemaFieldId: schema_field_id
+              }.merge(kwargs.slice(*(VALID_KEYS - %i[dataFieldId schemaFieldId])).compact)
+            end
+
+            def self.validate_anchor!(position)
+              return if position.nil? || ANCHOR_POSITIONS.include?(position.to_s)
+
+              raise ArgumentError,
+                    "Invalid anchorPosition #{position.inspect}: " \
+                    "expected one of #{ANCHOR_POSITIONS.join(', ')}"
+            end
+            private_class_method :validate_anchor!
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module AddWorkflowCallback
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[placeholderId stageId taskId triggerCondition triggers operations].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 AddWorkflowCallback
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[placeholderId stageId taskId triggerCondition triggers operations].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/archive_public_config.rb

@@ -0,0 +1,19 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # 20260713
+          module ArchivePublicConfig
+            SCHEMA_VERSION = '20260713'.freeze
+            VALID_KEYS = %i[archive].freeze # archive: Boolean! (required server-side)
+
+            def self.build(**kwargs)
+              kwargs.slice(*VALID_KEYS).compact
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module CollapseSection
-            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 CollapseSection
+            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/create_public_config.rb

@@ -0,0 +1,19 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # 20260713: public (anonymous) submission config for a template.
+          module CreatePublicConfig
+            SCHEMA_VERSION = '20260713'.freeze
+            VALID_KEYS = %i[token].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_binding.rb

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module EditBinding
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[id name referenceId].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 EditBinding
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[id name referenceId].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_checklist_field_item.rb

@@ -0,0 +1,19 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        class WorkflowCommand
+          # 20260713
+          module EditChecklistFieldItem
+            SCHEMA_VERSION = '20260713'.freeze
+            VALID_KEYS = %i[dataFieldId itemId label weight].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_creator_permissions.rb

@@ -1,18 +1,18 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module EditCreatorPermissions
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[stageId creatorEnabled creatorEditable creatorFlags].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 EditCreatorPermissions
+            SCHEMA_VERSION = '20260605'.freeze
+            VALID_KEYS = %i[stageId creatorEnabled creatorEditable creatorFlags].freeze
+
+            def self.build(**kwargs)
+              kwargs.slice(*VALID_KEYS).compact
+            end
+          end
+        end
+      end
+    end
+  end
+end