ecoportal-api-graphql 1.3.5 → 1.3.17

data/lib/ecoportal/api/graphql/base/force/binding_collection.rb

@@ -0,0 +1,62 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class Force
+          # Wraps the bindings array of a Force.  Supports the v2 scripting interface:
+          #   force.bindings.get_by_name(name)   → [Binding, ...]
+          #   force.bindings.add(field, name:)   → queues addBinding command
+          #   force.bindings.delete!(binding)    → queues removeBinding command
+          class BindingCollection
+            include Enumerable
+
+            def initialize(raw, force:)
+              @force    = force
+              @bindings = Array(raw).map { |b| Force::Binding.new(b) }
+            end
+
+            # Filter bindings by name (case-insensitive).
+            def get_by_name(name)
+              target = name.to_s.downcase
+              @bindings.select { |b| b.name.to_s.downcase == target }
+            end
+
+            # Queue an addBinding command.  `field` may be a GraphQL DataField object
+            # (uses field.id as referenceId) or a raw ID string.
+            def add(field, name:, type: 'field')
+              ref_id = field.respond_to?(:id) ? field.id : field.to_s
+              @force.queue_command(
+                addBinding: {
+                  forceId:     @force.id,
+                  name:        name.to_s,
+                  referenceId: ref_id,
+                  type:        type
+                }
+              )
+              self
+            end
+
+            # Queue a removeBinding command.  Accepts a Binding object or an ID string.
+            def delete!(binding_or_id)
+              bid = binding_or_id.respond_to?(:id) ? binding_or_id.id : binding_or_id.to_s
+              @force.queue_command(removeBinding: { id: bid })
+              self
+            end
+
+            def each(&block)
+              @bindings.each(&block)
+            end
+
+            def size
+              @bindings.size
+            end
+
+            def empty?
+              @bindings.empty?
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/force/collection.rb

@@ -0,0 +1,47 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class Force
+          # Wraps a page's forces array.  Provides the v2 scripting interface:
+          #   page.forces.get_by_name(name)  → [Force, ...]
+          class Collection
+            include Enumerable
+
+            def initialize(raw)
+              @forces = Array(raw).map { |f| Force.new(f) }
+            end
+
+            # Filter forces by name (case-insensitive).
+            def get_by_name(name)
+              target = name.to_s.downcase
+              @forces.select { |f| f.name.to_s.downcase == target }
+            end
+
+            # True if any force has uncommitted script changes or pending binding commands.
+            def dirty?
+              @forces.any?(&:dirty?)
+            end
+
+            # All pending commands across all forces (editForce, addBinding, removeBinding).
+            def pending_commands
+              @forces.flat_map(&:all_pending_commands)
+            end
+
+            def each(&block)
+              @forces.each(&block)
+            end
+
+            def size
+              @forces.size
+            end
+
+            def empty?
+              @forces.empty?
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,65 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # Represents a Force — a AngularJS/LISP snippet that implements conditional
+        # field behaviour on a page stage.  Forces are queried as part of a page
+        # when forces are explicitly included in the query fragment.
+        #
+        # Read access is via the page's force collection:
+        #   force = page.forces.get_by_name('Workflow (S1)').first
+        #   force.custom_script          # → current LISP script
+        #   force.bindings.get_by_name('top-txt')  # → [Binding, ...]
+        #
+        # Write access queues workflow commands executed after process_ooze:
+        #   force.custom_script = new_script  # → queues editForce command
+        #   force.bindings.add(field, name: 'bind-name')   # → queues addBinding
+        #   force.bindings.delete!(binding)                 # → queues removeBinding
+        class Force < Logic::BaseModel
+          passkey     :id
+          passthrough :name, :script, :customScript, :weight, :url
+          passarray   :globalBindingIds
+
+          require_relative 'force/binding'
+          require_relative 'force/binding_collection'
+          require_relative 'force/collection'
+
+          def bindings
+            @bindings ||= Force::BindingCollection.new(doc['bindings'] || [], force: self)
+          end
+
+          # v2 compat: scripts read and write custom_script directly.
+          # Writing queues an editForce workflow command consumed by ForceCompat.
+          def custom_script=(new_script)
+            return if doc['customScript'] == new_script
+
+            doc['customScript'] = new_script
+            @_custom_script_dirty = true
+          end
+
+          def dirty?
+            @_custom_script_dirty || pending_commands.any?
+          end
+
+          # Accumulate workflow commands (editForce, addBinding, removeBinding).
+          def queue_command(command_hash)
+            pending_commands << command_hash
+          end
+
+          # All pending commands for this force (editForce if script changed + binding ops).
+          def pending_commands
+            @pending_commands ||= []
+          end
+
+          # Collect all commands including the script edit if dirty.
+          def all_pending_commands
+            cmds = []
+            cmds << { editForce: { id: id, customScript: doc['customScript'] } } if @_custom_script_dirty
+            cmds.concat(pending_commands)
+            cmds
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/kickstand/job.rb

@@ -0,0 +1,17 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Kickstand
+          class Job < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passthrough :status
+            passthrough :createdAt, :updatedAt
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/kickstand/workflow.rb

@@ -0,0 +1,18 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Kickstand
+          class Workflow < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passthrough :name, :status
+            passthrough :createdAt, :updatedAt
+            passthrough :startedAt, :stoppedAt, :failedAt, :finishedAt
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/kickstand.rb

@@ -0,0 +1,13 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Kickstand
+        end
+      end
+    end
+  end
+end
+
+require_relative 'kickstand/workflow'
+require_relative 'kickstand/job'

data/lib/ecoportal/api/graphql/base/location_classification_type.rb

@@ -1,15 +1,15 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class LocationClassificationType < Logic::BaseModel
-          root!
-
-          passkey :id
-          passthrough :name
-          passboolean :active
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class LocationClassificationType < Logic::BaseModel
+          root!
+
+          passkey :id
+          passthrough :name
+          passboolean :active
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/location_node.rb

@@ -1,14 +1,14 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        # LocationNodeType
-        class LocationNode < Interface::LocationStructure::Node
-          class_resolver :location_node_class, self
-
-          passthrough :highlights
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # LocationNodeType
+        class LocationNode < Interface::LocationStructure::Node
+          class_resolver :location_node_class, self
+
+          passthrough :highlights
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/location_structure/draft/structure.rb

@@ -1,37 +1,37 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class LocationStructure
-          class Draft
-            class Structure < Interface::LocationStructure::Nodes
-              class_resolver :location_node_class, Base::LocationNode
-
-              def draft?
-                true
-              end
-
-              def id
-                draft&.id
-              end
-
-              def name
-                draft&.name
-              end
-
-              def parent_structure
-                draft&.parent_structure
-              end
-
-              def draft
-                return if _parent == self
-
-                _parent
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class LocationStructure
+          class Draft
+            class Structure < Interface::LocationStructure::Nodes
+              class_resolver :location_node_class, Base::LocationNode
+
+              def draft?
+                true
+              end
+
+              def id
+                draft&.id
+              end
+
+              def name
+                draft&.name
+              end
+
+              def parent_structure
+                draft&.parent_structure
+              end
+
+              def draft
+                return if _parent == self
+
+                _parent
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,93 +1,93 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class LocationStructure
-          class Draft < Logic::BaseModel
-            read_only!
-
-            class_resolver :structure_class, "Base::LocationStructure::Draft::Structure"
-
-            passkey :id
-
-            passthrough :name, :notes
-
-            passboolean :commited
-            alias_method :commited?, :commited
-
-            embeds_one :createdAt, klass: Base::DateTime
-
-            embeds_one :structure, klass: :structure_class
-
-            passarray :conflictingIds
-            embeds_many :commands, klass: Interface::LocationStructure::Command
-            embeds_many :results, read_only: true, klass: "Ecoportal::API::GraphQL::Payload::LocationStructure::CommandExecutionResult"
-
-            passboolean :ok
-
-            def ok?
-              ok != false
-            end
-
-            def success?
-              !error?
-            end
-
-            def error?
-              conflictingIds?    ||
-                result_errors?   ||
-                !ok?
-            end
-
-            def error_doc
-              if conflictingIds?
-                {
-                  conflictingIds: conflictingIds.doc
-                }
-              elsif result_errors?
-                {
-                  results: [result_errors.first&.error_doc]
-                }
-              elsif !ok?
-                {
-                  ok: ok
-                }
-              end
-            end
-
-            def structure_id
-              parent_structure&.id
-            end
-
-            def structure_name
-              parent_structure&.name
-            end
-
-            # @note draft is in a collection of drafts
-            def parent_structure
-              return unless _parent != self
-              return unless _parent._parent != _parent
-              return unless _parent.is_a?(Base::LocationStructure)
-
-              _parent._parent
-            end
-
-            def conflictingIds?
-              (conflictingIds || []).any?
-            end
-
-            def result_errors?
-              result_errors.any?
-            end
-
-            def result_errors
-              results.select(&:error?)
-            end
-          end
-        end
-      end # GraphQL
-    end # API
-  end # Ecoportal
-end
-
-require_relative 'draft/structure'
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class LocationStructure
+          class Draft < Logic::BaseModel
+            read_only!
+
+            class_resolver :structure_class, "Base::LocationStructure::Draft::Structure"
+
+            passkey :id
+
+            passthrough :name, :notes
+
+            passboolean :commited
+            alias_method :commited?, :commited
+
+            embeds_one :createdAt, klass: Base::DateTime
+
+            embeds_one :structure, klass: :structure_class
+
+            passarray :conflictingIds
+            embeds_many :commands, klass: Interface::LocationStructure::Command
+            embeds_many :results, read_only: true, klass: "Ecoportal::API::GraphQL::Payload::LocationStructure::CommandExecutionResult"
+
+            passboolean :ok
+
+            def ok?
+              ok != false
+            end
+
+            def success?
+              !error?
+            end
+
+            def error?
+              conflictingIds?    ||
+                result_errors?   ||
+                !ok?
+            end
+
+            def error_doc
+              if conflictingIds?
+                {
+                  conflictingIds: conflictingIds.doc
+                }
+              elsif result_errors?
+                {
+                  results: [result_errors.first&.error_doc]
+                }
+              elsif !ok?
+                {
+                  ok: ok
+                }
+              end
+            end
+
+            def structure_id
+              parent_structure&.id
+            end
+
+            def structure_name
+              parent_structure&.name
+            end
+
+            # @note draft is in a collection of drafts
+            def parent_structure
+              return unless _parent != self
+              return unless _parent._parent != _parent
+              return unless _parent.is_a?(Base::LocationStructure)
+
+              _parent._parent
+            end
+
+            def conflictingIds?
+              (conflictingIds || []).any?
+            end
+
+            def result_errors?
+              result_errors.any?
+            end
+
+            def result_errors
+              results.select(&:error?)
+            end
+          end
+        end
+      end # GraphQL
+    end # API
+  end # Ecoportal
+end
+
+require_relative 'draft/structure'

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

@@ -1,27 +1,27 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class LocationStructure < Interface::LocationStructure::Nodes
-          read_only!
-
-          class_resolver :location_node_class, Base::LocationNode
-          class_resolver :draft_class, "Base::LocationStructure::Draft"
-
-          passkey :id
-          passthrough :name, :weight
-          passboolean :archived, :published, :visitorManagementEnabled
-          embeds_one :updatedAt, klass: Base::DateTime
-
-          embeds_many :drafts, klass: :draft_class, order_key: :createdAt
-
-          def draft?
-            false
-          end
-        end
-      end
-    end
-  end
-end
-
-require_relative 'location_structure/draft'
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class LocationStructure < Interface::LocationStructure::Nodes
+          read_only!
+
+          class_resolver :location_node_class, Base::LocationNode
+          class_resolver :draft_class, "Base::LocationStructure::Draft"
+
+          passkey :id
+          passthrough :name, :weight
+          passboolean :archived, :published, :visitorManagementEnabled
+          embeds_one :updatedAt, klass: Base::DateTime
+
+          embeds_many :drafts, klass: :draft_class, order_key: :createdAt
+
+          def draft?
+            false
+          end
+        end
+      end
+    end
+  end
+end
+
+require_relative 'location_structure/draft'

data/lib/ecoportal/api/graphql/base/organization.rb

@@ -1,15 +1,15 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class Organization < Logic::BaseModel
-          root!
-
-          passkey :id
-          passthrough :name, :companyName
-          passthrough :logoUrl, read_only: true
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class Organization < Logic::BaseModel
+          root!
+
+          passkey :id
+          passthrough :name, :companyName
+          passthrough :logoUrl, read_only: true
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/basic.rb

@@ -0,0 +1,38 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+          class Basic < Interface::BasePage
+            private
+
+            # v2-compat read flatten: a basic page's fields live nested under
+            # sections (CommonPageUnion fetches `sections { ...sectionUnion }` with the
+            # data fields inside each section — it does NOT select a top-level
+            # `dataFields`). v2 exposed fields flat at the page (page.components), so
+            # gather them from sections here, mirroring Model::Page::Phased#raw_data_fields.
+            # Field docs are shared by reference, so mutations forward to the section doc.
+            #
+            # `raw_sections` keeps the DataFieldAccess default (doc['sections']) — basic
+            # pages already store sections at the page root.
+            def raw_data_fields
+              from_sections = raw_sections.flat_map { |section| field_docs_in(section) }.compact.uniq { |fld| fld['id'] }
+              return from_sections unless from_sections.empty?
+
+              # Create/flat path: fields may be supplied at the page root (top-level
+              # `dataFields`, no sections) — fall back to the DataFieldAccess default
+              # so create input + flat-built basic pages still expose their fields.
+              doc['dataFields'] || []
+            end
+
+            def field_docs_in(section)
+              (section['dataFields'] || []) +
+                (section['leftDataFields'] || []) +
+                (section['rightDataFields'] || [])
+            end
+          end
+        end
+      end
+    end
+  end
+end