ecoportal-api-graphql 2.0.0 → 2.2.0

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

@@ -1,41 +1,41 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Builder
-        class Action
-          attr_reader :client
-
-          def initialize(client)
-            @client = client
-          end
-
-          def archive(**kargs, &block)
-            archiveMutation.query(**kargs, &block)
-          end
-
-          def update(**kargs, &block)
-            updateMutation.query(**kargs, &block)
-          end
-
-          def create(**kargs, &block)
-            createMutation.query(**kargs, &block)
-          end
-
-          private
-
-          def archiveMutation
-            Mutation::Action::Archive.new(client)
-          end
-
-          def updateMutation
-            Mutation::Action::Update.new(client)
-          end
-
-          def createMutation
-            Mutation::Action::Create.new(client)
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class Action
+          attr_reader :client
+
+          def initialize(client)
+            @client = client
+          end
+
+          def archive(**kargs, &block)
+            archiveMutation.query(**kargs, &block)
+          end
+
+          def update(**kargs, &block)
+            updateMutation.query(**kargs, &block)
+          end
+
+          def create(**kargs, &block)
+            createMutation.query(**kargs, &block)
+          end
+
+          private
+
+          def archiveMutation
+            Mutation::Action::Archive.new(client)
+          end
+
+          def updateMutation
+            Mutation::Action::Update.new(client)
+          end
+
+          def createMutation
+            Mutation::Action::Create.new(client)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/builder/location_structure/draft.rb

@@ -1,64 +1,64 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Builder
-        class LocationStructure
-          class Draft
-            attr_reader :client, :parent
-
-            def initialize(client, parent:)
-              @client = client
-              @parent = parent
-            end
-
-            def nodeClassifications(**kargs, &block)
-              parent.nodeClassifications(**kargs, &block)
-            end
-
-            def create(**kargs, &block)
-              createMutation.query(**kargs, &block)
-            end
-
-            def addCommands(**kargs, &block)
-              addCommandsMutation.query(**kargs, &block)
-            end
-
-            def delete(**kargs, &block)
-              deleteMutation.query(**kargs, &block)
-            end
-
-            def publish(**kargs, &block)
-              publishMutation.query(**kargs, &block)
-            end
-
-            def DropBadCommands(**kargs, &block)
-              dropBadCommandsMutation.query(**kargs, &block)
-            end
-
-            private
-
-            def createMutation
-              Mutation::LocationStructure::Draft::Create.new(client)
-            end
-
-            def addCommandsMutation
-              Mutation::LocationStructure::Draft::AddCommands.new(client)
-            end
-
-            def deleteMutation
-              Mutation::LocationStructure::Draft::Delete.new(client)
-            end
-
-            def publishMutation
-              Mutation::LocationStructure::Draft::Publish.new(client)
-            end
-
-            def dropBadCommandsMutation
-              Mutation::LocationStructure::Draft::DropBadCommands.new(client)
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class LocationStructure
+          class Draft
+            attr_reader :client, :parent
+
+            def initialize(client, parent:)
+              @client = client
+              @parent = parent
+            end
+
+            def nodeClassifications(**kargs, &block)
+              parent.nodeClassifications(**kargs, &block)
+            end
+
+            def create(**kargs, &block)
+              createMutation.query(**kargs, &block)
+            end
+
+            def addCommands(**kargs, &block)
+              addCommandsMutation.query(**kargs, &block)
+            end
+
+            def delete(**kargs, &block)
+              deleteMutation.query(**kargs, &block)
+            end
+
+            def publish(**kargs, &block)
+              publishMutation.query(**kargs, &block)
+            end
+
+            def DropBadCommands(**kargs, &block)
+              dropBadCommandsMutation.query(**kargs, &block)
+            end
+
+            private
+
+            def createMutation
+              Mutation::LocationStructure::Draft::Create.new(client)
+            end
+
+            def addCommandsMutation
+              Mutation::LocationStructure::Draft::AddCommands.new(client)
+            end
+
+            def deleteMutation
+              Mutation::LocationStructure::Draft::Delete.new(client)
+            end
+
+            def publishMutation
+              Mutation::LocationStructure::Draft::Publish.new(client)
+            end
+
+            def dropBadCommandsMutation
+              Mutation::LocationStructure::Draft::DropBadCommands.new(client)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/builder/location_structure.rb

@@ -1,40 +1,40 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Builder
-        class LocationStructure
-          attr_reader :client
-
-          def initialize(client)
-            @client = client
-          end
-
-          def nodeClassifications(**kargs, &block)
-            query_model = Query::LocationClassifications.new(client)
-            query_model.query(**kargs, &block)
-          end
-
-          def applyCommandsInput
-            Input::LocationStructure::ApplyCommands.new
-          end
-
-          def applyCommands(**kargs, &block)
-            applyCommandsMutation.query(**kargs, &block)
-          end
-
-          def draft
-            LocationStructure::Draft.new(client, parent: self)
-          end
-
-          private
-
-          def applyCommandsMutation
-            Mutation::LocationStructure::ApplyCommands.new(client)
-          end
-        end
-      end
-    end
-  end
-end
-
-require_relative 'location_structure/draft'
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class LocationStructure
+          attr_reader :client
+
+          def initialize(client)
+            @client = client
+          end
+
+          def nodeClassifications(**kargs, &block)
+            query_model = Query::LocationClassifications.new(client)
+            query_model.query(**kargs, &block)
+          end
+
+          def applyCommandsInput
+            Input::LocationStructure::ApplyCommands.new
+          end
+
+          def applyCommands(**kargs, &block)
+            applyCommandsMutation.query(**kargs, &block)
+          end
+
+          def draft
+            LocationStructure::Draft.new(client, parent: self)
+          end
+
+          private
+
+          def applyCommandsMutation
+            Mutation::LocationStructure::ApplyCommands.new(client)
+          end
+        end
+      end
+    end
+  end
+end
+
+require_relative 'location_structure/draft'

data/lib/ecoportal/api/graphql/builder/register/preset_view.rb

@@ -1,84 +1,84 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Builder
-        class Register
-          # Sub-builder for preset view operations within a register context.
-          # Access via: api.register.preset_view
-          #
-          # Usage:
-          #   pv = api.register.preset_view
-          #
-          #   # List preset views for a register (find IDs for presetViewId in searches)
-          #   views = pv.list('REG_ID')
-          #   views.map { |v| "#{v.name} (#{v.id}) global=#{v.global?}" }
-          #
-          #   # Create a preset view
-          #   pv.create(input: {
-          #     registerId:     'REG_ID',
-          #     name:           'Active Pages',
-          #     customPresetView: true,
-          #     fieldConfigs:   [{ key: 'name', weight: 0 }, { key: 'state', weight: 1 }],
-          #     sorter:         { key: 'created_at', direction: 'desc' }
-          #   })
-          #
-          #   # Share with a user (view access)
-          #   pv.permission(input: {
-          #     id:          'VIEW_ID',
-          #     permissions: [{ level: 'view', to: { userId: 'USER_ID' } }]
-          #   })
-          class PresetView
-            attr_reader :client
-
-            def initialize(client)
-              @client = client
-            end
-
-            # List all preset views for a register. Returns an array of PresetView objects.
-            def list(register_id, search_conf: nil, &block)
-              Query::RegisterPresetViews.new(client).query(
-                registerId: register_id,
-                searchConf: search_conf,
-                &block
-              ).nodes
-            end
-
-            def create(**kargs, &block)
-              createMutation.query(**kargs, &block)
-            end
-
-            def update(**kargs, &block)
-              updateMutation.query(**kargs, &block)
-            end
-
-            def permission(**kargs, &block)
-              permissionMutation.query(**kargs, &block)
-            end
-
-            def destroy(**kargs, &block)
-              destroyMutation.query(**kargs, &block)
-            end
-
-            private
-
-            def createMutation
-              Mutation::PresetView::Create.new(client)
-            end
-
-            def updateMutation
-              Mutation::PresetView::Update.new(client)
-            end
-
-            def permissionMutation
-              Mutation::PresetView::Permission.new(client)
-            end
-
-            def destroyMutation
-              Mutation::PresetView::Destroy.new(client)
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class Register
+          # Sub-builder for preset view operations within a register context.
+          # Access via: api.register.preset_view
+          #
+          # Usage:
+          #   pv = api.register.preset_view
+          #
+          #   # List preset views for a register (find IDs for presetViewId in searches)
+          #   views = pv.list('REG_ID')
+          #   views.map { |v| "#{v.name} (#{v.id}) global=#{v.global?}" }
+          #
+          #   # Create a preset view
+          #   pv.create(input: {
+          #     registerId:     'REG_ID',
+          #     name:           'Active Pages',
+          #     customPresetView: true,
+          #     fieldConfigs:   [{ key: 'name', weight: 0 }, { key: 'state', weight: 1 }],
+          #     sorter:         { key: 'created_at', direction: 'desc' }
+          #   })
+          #
+          #   # Share with a user (view access)
+          #   pv.permission(input: {
+          #     id:          'VIEW_ID',
+          #     permissions: [{ level: 'view', to: { userId: 'USER_ID' } }]
+          #   })
+          class PresetView
+            attr_reader :client
+
+            def initialize(client)
+              @client = client
+            end
+
+            # List all preset views for a register. Returns an array of PresetView objects.
+            def list(register_id, search_conf: nil, &block)
+              Query::RegisterPresetViews.new(client).query(
+                registerId: register_id,
+                searchConf: search_conf,
+                &block
+              ).nodes
+            end
+
+            def create(**kargs, &block)
+              createMutation.query(**kargs, &block)
+            end
+
+            def update(**kargs, &block)
+              updateMutation.query(**kargs, &block)
+            end
+
+            def permission(**kargs, &block)
+              permissionMutation.query(**kargs, &block)
+            end
+
+            def destroy(**kargs, &block)
+              destroyMutation.query(**kargs, &block)
+            end
+
+            private
+
+            def createMutation
+              Mutation::PresetView::Create.new(client)
+            end
+
+            def updateMutation
+              Mutation::PresetView::Update.new(client)
+            end
+
+            def permissionMutation
+              Mutation::PresetView::Permission.new(client)
+            end
+
+            def destroyMutation
+              Mutation::PresetView::Destroy.new(client)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,49 +1,49 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Builder
-        class Register
-          attr_reader :client
-
-          def initialize(client)
-            @client = client
-          end
-
-          # Register CRUD
-          def create(**kargs, &block)
-            createMutation.query(**kargs, &block)
-          end
-
-          def update(**kargs, &block)
-            updateMutation.query(**kargs, &block)
-          end
-
-          def destroy(**kargs, &block)
-            destroyMutation.query(**kargs, &block)
-          end
-
-          # Preset view sub-builder — list, create, update, permission, destroy
-          def preset_view
-            Register::PresetView.new(client)
-          end
-
-          private
-
-          def createMutation
-            Mutation::Register::Create.new(client)
-          end
-
-          def updateMutation
-            Mutation::Register::Update.new(client)
-          end
-
-          def destroyMutation
-            Mutation::Register::Destroy.new(client)
-          end
-        end
-      end
-    end
-  end
-end
-
-require_relative 'register/preset_view'
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class Register
+          attr_reader :client
+
+          def initialize(client)
+            @client = client
+          end
+
+          # Register CRUD
+          def create(**kargs, &block)
+            createMutation.query(**kargs, &block)
+          end
+
+          def update(**kargs, &block)
+            updateMutation.query(**kargs, &block)
+          end
+
+          def destroy(**kargs, &block)
+            destroyMutation.query(**kargs, &block)
+          end
+
+          # Preset view sub-builder — list, create, update, permission, destroy
+          def preset_view
+            Register::PresetView.new(client)
+          end
+
+          private
+
+          def createMutation
+            Mutation::Register::Create.new(client)
+          end
+
+          def updateMutation
+            Mutation::Register::Update.new(client)
+          end
+
+          def destroyMutation
+            Mutation::Register::Destroy.new(client)
+          end
+        end
+      end
+    end
+  end
+end
+
+require_relative 'register/preset_view'

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

@@ -58,6 +58,30 @@ module Ecoportal
             destroyRelatedPageMutation.query(template_id: template_id, id: id, patch_ver: patch_ver, &block)
           end
 
+          # TEMPLATE CHANGE LOG — who changed this template, what, and when. Newest first
+          # (server-side `_id: :desc`), paginated.
+          #
+          #   api.template.change_log(id: template_page_id, first: 50)   # => Connection
+          #   api.template.change_log.each(id: template_page_id) { |e| ... }  # auto-paginates
+          #
+          # ★ Two caveats, both silent — read `Base::Template::ChangeLogEntry` before relying on
+          # this: the connection is nil (not empty) unless the caller satisfies
+          # `Pages::TemplatePolicy#update_information?`, and only TEMPLATE_BUILDER-sourced
+          # commands appear (workflow-builder ones are on `Query::PagesWorkflowCommands`).
+          #
+          # Called with no arguments it returns the query object itself, so `#each` /`#map` and
+          # the rest of Enumerable are available — same idiom as the QueryIntegration queries on
+          # `Model::Organization`.
+          # @param detail [Boolean] when true, also select FIELD-LEVEL detail (what changed).
+          #   Ignored when an explicit block is given -- the block wins, since it is the more
+          #   specific instruction. Off by default so the common who/when read stays cheap.
+          def change_log(detail: false, **kargs, &block)
+            selection = block || (detail ? Query::TemplateChangeLog.detail_block : nil)
+            return changeLogQuery if kargs.empty? && !selection
+
+            changeLogQuery.query(**kargs, &selection)
+          end
+
           private
 
           def createMutation
@@ -91,6 +115,10 @@ module Ecoportal
           def destroyRelatedPageMutation
             Mutation::Template::DestroyRelatedPage.new(client)
           end
+
+          def changeLogQuery
+            Query::TemplateChangeLog.new(client)
+          end
         end
       end
     end

data/lib/ecoportal/api/graphql/builder/template_builder.rb

@@ -24,7 +24,12 @@ module Ecoportal
         #           { field_type: 'PlainText', label: 'Description', column: 0,
         #             description: 'ID:token' },   # addField (+ editFieldConfiguration for description)
         #           { field_type: 'Select', label: 'Severity',
-        #             options: [ { label: 'Low', weight: 0 }, ... ],                # addSelectFieldOption
+        #             options: [ { label: 'Low', weight: 0, value: 'low' },
+        #                        { label: 'High', weight: 10, value: 'high' } ], # addSelectFieldOption
+        #             # `value:` is REQUIRED per option (backend: AddSelectFieldOptionInput,
+        #             # required: true) — it is the option's unique key (duplicate values within one
+        #             # field are rejected), always sent as a String even for numeric select fields
+        #             # (stored as an Integer server-side). A missing `value` raises ArgumentError.
         #             config: { select: { multiple: false } } },                   # editFieldConfiguration(byType:)
         #           { field_type: 'Gauge', label: 'Risk',
         #             stops: [ { threshold: 0, color: '#0f0' }, ... ],              # addGaugeFieldStop
@@ -125,9 +130,23 @@ module Ecoportal
             add(:editFieldConfiguration, data_field_id: field_ph, description: description)
           end
 
+          # addSelectFieldOption requires `value` (backend: AddSelectFieldOptionInput, required: true
+          # — a real field distinct from label/weight, cast to a number server-side for numeric
+          # select fields). The DSL has no natural default for it (unlike label/weight, it is
+          # business data this builder cannot infer), so it MUST be supplied per option in the spec;
+          # a missing one raises rather than silently falling back to the label/weight (which would
+          # risk persisting the wrong stored value for a scored/numeric select field).
           def emit_options(field, field_ph)
             Array(field[:options]).each do |opt|
-              add(:addSelectFieldOption, data_field_id: field_ph, label: opt[:label], weight: opt[:weight])
+              value = opt[:value]
+              if value.nil?
+                raise ArgumentError,
+                      "TemplateBuilder: option '#{opt[:label]}' on field '#{field[:label]}' is " \
+                      'missing `value` (addSelectFieldOption requires it) — supply ' \
+                      'options: [{ label:, weight:, value: }, ...] in the spec'
+              end
+
+              add(:addSelectFieldOption, data_field_id: field_ph, label: opt[:label], value: value, weight: opt[:weight])
             end
           end