ecoportal-api-graphql 2.0.0 → 3.0.0

data/lib/ecoportal/api/graphql/base/page/phased/stage.rb

@@ -10,6 +10,9 @@ module Ecoportal
               passkey :id
               passthrough :name, :ordering, :state
               passboolean :active, :started
+              # Per-stage tag set (Stage.tags in the schema). Fetched by the stageAttrs
+              # fragment; a component of #all_tags. Empty array when not queried.
+              passarray :tags
 
               class_resolver :callback_type_class, 'Ecoportal::API::GraphQL::Base::PagesWorkflow::CallbackType'
 
@@ -17,6 +20,54 @@ module Ecoportal
               # canonical field objects (filtered to this stage) rather than fresh dups.
               attr_writer :page_field_collection
 
+              # The owning page, resolved via the DoubleModel's NATIVE nesting reference rather
+              # than a manually-injected back-ref. A stage is embedded under the page as
+              # page -> stages (CollectionModel) -> stage, so `_parent` is the intermediate
+              # collection, NOT the page. `root` walks the whole `_parent` chain to the top of
+              # the doc model (the page), which is robust to that intermediate nesting.
+              #
+              # Returns the page for an embedded stage, or nil for a standalone stage whose root
+              # is itself (i.e. not a page — has no baseTags/otherTags/location_ids to fold in).
+              def page
+                top = root
+                top.equal?(self) ? nil : top
+              end
+
+              # location_ids redirect: the GraphQL Stage type has NO location field — locations
+              # are assigned at the PAGE level (page.locations { id }). So a stage's location ids
+              # are the page's location ids. Empty array for a standalone stage.
+              def location_ids
+                Array(page&.location_ids)
+              end
+
+              # The stage's fully-compiled tag set (client-side build of the backend-only
+              # "compiled_tags"), per the domain formula:
+              #
+              #   Stage.all_tags = page.baseTags + page.location_ids + page.otherTags + stage.tags
+              #
+              # (page.location_ids — surfaced here via #location_ids — stands in for the per-stage
+              #  "location_ids" of the formula: the GraphQL schema does NOT expose locations on the
+              #  Stage type, they are assigned at the PAGE level.)
+              #
+              # Returns a de-duplicated Array of tag strings. For a standalone stage (no owning
+              # page) folds in only the stage's own tags.
+              def all_tags
+                (page_base_tags + location_ids + page_other_tags + Array(tags)).
+                  compact.uniq
+              end
+
+              private
+
+              def page_base_tags
+                page ? Array(page.baseTags) : []
+              end
+
+              def page_other_tags
+                page ? Array(page.otherTags) : []
+              end
+
+              public
+
               def workflow_callbacks
                 @workflow_callbacks ||= Array(doc['workflowCallbacks'] || []).map { |cb| callback_type_class.from_doc(cb) }
               end

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

@@ -1,15 +1,15 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        module Page
-          class Phased < Interface::BasePage
-            require_relative 'phased/stage'
-
-            embeds_many :stages, klass: Stage, read_only: true
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+          class Phased < Interface::BasePage
+            require_relative 'phased/stage'
+
+            embeds_many :stages, klass: Stage, read_only: true
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,48 +1,48 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        module Page
-          # Wraps a SectionUnion doc (ContentSection or SplitSection).
-          # Provides access to heading, type, and data fields within the section.
-          class Section < Logic::BaseModel
-            read_only!
-
-            passkey :id
-            passthrough :heading
-
-            # __typename normalised to 'type' during initialisation
-            passthrough :type
-
-            def initialize(raw_doc = {})
-              raw_doc = raw_doc.dup if raw_doc.is_a?(Hash)
-              raw_doc['type'] ||= raw_doc['__typename'] if raw_doc.is_a?(Hash)
-              super
-            end
-
-            # All data fields in this section.
-            # ContentSection  → dataFields
-            # SplitSection    → leftDataFields + rightDataFields (merged)
-            def components
-              all = (doc['dataFields']      || []) +
-                    (doc['leftDataFields']  || []) +
-                    (doc['rightDataFields'] || [])
-              DataField::Collection.from_doc(all)
-            end
-
-            # v2 compat alias
-            alias_method :data_fields, :components
-
-            def content_section?
-              type.to_s == 'ContentSection'
-            end
-
-            def split_section?
-              type.to_s == 'SplitSection'
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+          # Wraps a SectionUnion doc (ContentSection or SplitSection).
+          # Provides access to heading, type, and data fields within the section.
+          class Section < Logic::BaseModel
+            read_only!
+
+            passkey :id
+            passthrough :heading
+
+            # __typename normalised to 'type' during initialisation
+            passthrough :type
+
+            def initialize(raw_doc = {})
+              raw_doc = raw_doc.dup if raw_doc.is_a?(Hash)
+              raw_doc['type'] ||= raw_doc['__typename'] if raw_doc.is_a?(Hash)
+              super
+            end
+
+            # All data fields in this section.
+            # ContentSection  → dataFields
+            # SplitSection    → leftDataFields + rightDataFields (merged)
+            def components
+              all = (doc['dataFields']      || []) +
+                    (doc['leftDataFields']  || []) +
+                    (doc['rightDataFields'] || [])
+              DataField::Collection.from_doc(all)
+            end
+
+            # v2 compat alias
+            alias_method :data_fields, :components
+
+            def content_section?
+              type.to_s == 'ContentSection'
+            end
+
+            def split_section?
+              type.to_s == 'SplitSection'
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,12 +1,12 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PageInfo < Logic::BaseModel
-          passthrough :startCursor, :endCursor
-          passboolean :hasNextPage, :hasPreviousPage
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PageInfo < Logic::BaseModel
+          passthrough :startCursor, :endCursor
+          passboolean :hasNextPage, :hasPreviousPage
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/operation_interface.rb

@@ -1,39 +1,39 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PagesWorkflow
-          class OperationInterface < Logic::BaseModel
-            SCHEMA_VERSION = '20260605'.freeze
-
-            passkey :id
-            passdate :delayedExecuteAt
-            passboolean :timeDelayPassed
-
-            class_resolver :time_delay_config_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::TimeDelayConfig'
-
-            embeds_one :timeDelayConfig, klass: :time_delay_config_class
-
-            require_relative 'operations/assign_to'
-            require_relative 'operations/create_page'
-            require_relative 'operations/send_notification'
-
-            def self.from_doc(raw_doc)
-              case raw_doc&.fetch('__typename', nil)
-              when 'PagesWorkflowOperationsAssignTo'
-                Operations::AssignTo.new(raw_doc)
-              when 'PagesWorkflowOperationsCreatePage'
-                Operations::CreatePage.new(raw_doc)
-              when 'PagesWorkflowOperationsSendNotification'
-                Operations::SendNotification.new(raw_doc)
-              else
-                new(raw_doc)
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class OperationInterface < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passkey :id
+            passdate :delayedExecuteAt
+            passboolean :timeDelayPassed
+
+            class_resolver :time_delay_config_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::TimeDelayConfig'
+
+            embeds_one :timeDelayConfig, klass: :time_delay_config_class
+
+            require_relative 'operations/assign_to'
+            require_relative 'operations/create_page'
+            require_relative 'operations/send_notification'
+
+            def self.from_doc(raw_doc)
+              case raw_doc&.fetch('__typename', nil)
+              when 'PagesWorkflowOperationsAssignTo'
+                Operations::AssignTo.new(raw_doc)
+              when 'PagesWorkflowOperationsCreatePage'
+                Operations::CreatePage.new(raw_doc)
+              when 'PagesWorkflowOperationsSendNotification'
+                Operations::SendNotification.new(raw_doc)
+              else
+                new(raw_doc)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/operations/assign_to.rb

@@ -1,27 +1,27 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PagesWorkflow
-          module Operations
-            class AssignTo < OperationInterface
-              SCHEMA_VERSION = '20260605'.freeze
-
-              passthrough :targetTaskType
-              passboolean :lastFulfilled
-
-              class_resolver :escalation_level_class,
-                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::EscalationLevel'
-
-              embeds_many :escalationLevels, klass: :escalation_level_class, read_only: true
-
-              def strategies
-                @strategies ||= Array(doc['strategies'] || [])
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          module Operations
+            class AssignTo < OperationInterface
+              SCHEMA_VERSION = '20260605'.freeze
+
+              passthrough :targetTaskType
+              passboolean :lastFulfilled
+
+              class_resolver :escalation_level_class,
+                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::EscalationLevel'
+
+              embeds_many :escalationLevels, klass: :escalation_level_class, read_only: true
+
+              def strategies
+                @strategies ||= Array(doc['strategies'] || [])
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/operations/send_notification.rb

@@ -1,30 +1,30 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PagesWorkflow
-          module Operations
-            class SendNotification < OperationInterface
-              SCHEMA_VERSION = '20260605'.freeze
-
-              passboolean :recurring, :recurrenceActive
-              passthrough :recurrenceCount, :recurrenceEndCount, :recurrenceEndType
-              passdate :nextRecurrenceAt
-
-              class_resolver :email_config_class,
-                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::EmailConfig'
-              class_resolver :in_system_config_class,
-                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::InSystemConfig'
-              class_resolver :recipient_config_class,
-                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::RecipientConfig'
-
-              embeds_one :emailConfig, klass: :email_config_class
-              embeds_one :inSystemConfig, klass: :in_system_config_class
-              embeds_one :recipientConfig, klass: :recipient_config_class
-            end
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          module Operations
+            class SendNotification < OperationInterface
+              SCHEMA_VERSION = '20260605'.freeze
+
+              passboolean :recurring, :recurrenceActive
+              passthrough :recurrenceCount, :recurrenceEndCount, :recurrenceEndType
+              passdate :nextRecurrenceAt
+
+              class_resolver :email_config_class,
+                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::EmailConfig'
+              class_resolver :in_system_config_class,
+                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::InSystemConfig'
+              class_resolver :recipient_config_class,
+                             'Ecoportal::API::GraphQL::Base::PagesWorkflow::RecipientConfig'
+
+              embeds_one :emailConfig, klass: :email_config_class
+              embeds_one :inSystemConfig, klass: :in_system_config_class
+              embeds_one :recipientConfig, klass: :recipient_config_class
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/pages_workflow/recipient_config.rb

@@ -1,34 +1,34 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PagesWorkflow
-          class RecipientConfig < Logic::BaseModel
-            SCHEMA_VERSION = '20260605'.freeze
-
-            passboolean :allActiveUsers, :includeActionAssignees, :includeMailboxFields
-            passboolean :includePageCreator, :includePeopleFields, :includeTaskAssignees
-            passboolean :limitByPageTags
-
-            class_resolver :action_type_selection_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::ActionTypeSelection'
-            class_resolver :mailbox_field_selection_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::MailboxFieldSelection'
-            class_resolver :people_field_selection_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::PeopleFieldSelection'
-            class_resolver :task_config_selection_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::TaskConfigSelection'
-            class_resolver :user_selection_class,
-                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::UserSelection'
-
-            embeds_many :actionTypeSelections, klass: :action_type_selection_class, read_only: true
-            embeds_many :mailboxFieldSelections, klass: :mailbox_field_selection_class, read_only: true
-            embeds_many :peopleFieldSelections, klass: :people_field_selection_class, read_only: true
-            embeds_many :taskConfigSelections, klass: :task_config_selection_class, read_only: true
-            embeds_many :userSelections, klass: :user_selection_class, read_only: true
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow
+          class RecipientConfig < Logic::BaseModel
+            SCHEMA_VERSION = '20260605'.freeze
+
+            passboolean :allActiveUsers, :includeActionAssignees, :includeMailboxFields
+            passboolean :includePageCreator, :includePeopleFields, :includeTaskAssignees
+            passboolean :limitByPageTags
+
+            class_resolver :action_type_selection_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::ActionTypeSelection'
+            class_resolver :mailbox_field_selection_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::MailboxFieldSelection'
+            class_resolver :people_field_selection_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::PeopleFieldSelection'
+            class_resolver :task_config_selection_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::TaskConfigSelection'
+            class_resolver :user_selection_class,
+                           'Ecoportal::API::GraphQL::Base::PagesWorkflow::UserSelection'
+
+            embeds_many :actionTypeSelections, klass: :action_type_selection_class, read_only: true
+            embeds_many :mailboxFieldSelections, klass: :mailbox_field_selection_class, read_only: true
+            embeds_many :peopleFieldSelections, klass: :people_field_selection_class, read_only: true
+            embeds_many :taskConfigSelections, klass: :task_config_selection_class, read_only: true
+            embeds_many :userSelections, klass: :user_selection_class, read_only: true
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,35 +1,35 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PagesWorkflow < Logic::BaseModel
-          SCHEMA_VERSION = '20260605'.freeze
-
-          passboolean :autoPageCreationEnabled
-          passarray :stages
-
-          class_resolver :register_field_class,
-                         'Ecoportal::API::GraphQL::Base::PagesWorkflow::RegisterField'
-
-          embeds_many :fields, klass: :register_field_class, read_only: true
-
-          require_relative 'pages_workflow/register_field'
-          require_relative 'pages_workflow/time_delay_config'
-          require_relative 'pages_workflow/escalation_level'
-          require_relative 'pages_workflow/user_selection'
-          require_relative 'pages_workflow/mailbox_field_selection'
-          require_relative 'pages_workflow/people_field_selection'
-          require_relative 'pages_workflow/task_config_selection'
-          require_relative 'pages_workflow/action_type_selection'
-          require_relative 'pages_workflow/email_config'
-          require_relative 'pages_workflow/in_system_config'
-          require_relative 'pages_workflow/recipient_config'
-          require_relative 'pages_workflow/trigger_interface'
-          require_relative 'pages_workflow/operation_interface'
-          require_relative 'pages_workflow/callback_type'
-          require_relative 'pages_workflow/command_interface'
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PagesWorkflow < Logic::BaseModel
+          SCHEMA_VERSION = '20260605'.freeze
+
+          passboolean :autoPageCreationEnabled
+          passarray :stages
+
+          class_resolver :register_field_class,
+                         'Ecoportal::API::GraphQL::Base::PagesWorkflow::RegisterField'
+
+          embeds_many :fields, klass: :register_field_class, read_only: true
+
+          require_relative 'pages_workflow/register_field'
+          require_relative 'pages_workflow/time_delay_config'
+          require_relative 'pages_workflow/escalation_level'
+          require_relative 'pages_workflow/user_selection'
+          require_relative 'pages_workflow/mailbox_field_selection'
+          require_relative 'pages_workflow/people_field_selection'
+          require_relative 'pages_workflow/task_config_selection'
+          require_relative 'pages_workflow/action_type_selection'
+          require_relative 'pages_workflow/email_config'
+          require_relative 'pages_workflow/in_system_config'
+          require_relative 'pages_workflow/recipient_config'
+          require_relative 'pages_workflow/trigger_interface'
+          require_relative 'pages_workflow/operation_interface'
+          require_relative 'pages_workflow/callback_type'
+          require_relative 'pages_workflow/command_interface'
+        end
+      end
+    end
+  end
+end

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

@@ -1,22 +1,22 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class PersonMember < Logic::BaseModel
-          root!
-
-          passkey :id
-          passthrough :name, :email
-          passarray :tagRestrict, :userGroupIds
-
-          passthrough :personSchemaId
-
-          passthrough :contractorOrganizationId
-          passthrough :userId
-
-          passboolean :tracingAdmin
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class PersonMember < Logic::BaseModel
+          root!
+
+          passkey :id
+          passthrough :name, :email
+          passarray :tagRestrict, :userGroupIds
+
+          passthrough :personSchemaId
+
+          passthrough :contractorOrganizationId
+          passthrough :userId
+
+          passboolean :tracingAdmin
+        end
+      end
+    end
+  end
+end

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

@@ -1,23 +1,23 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        # Elasticsearch-backed preview of a page, returned by register.previewPages.
-        # Read-only. No patchVer, no typed data field models, no field IDs.
-        # Use for fast metadata lookup only — switch to org search (pages) for full data.
-        class PreviewPage < Logic::BaseModel
-          read_only!
-
-          passkey :id
-          passthrough :uid, :name, :state, :archived
-          passthrough :creatorName, :externalId
-          passdate :createdAt, :updatedAt
-
-          # locations, dataFields, stages returned as raw arrays — typed access not needed
-          # for a read-only ES-backed preview model. Use org search for typed field access.
-          passarray :locations, :dataFields, :stages, :tags
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # Elasticsearch-backed preview of a page, returned by register.previewPages.
+        # Read-only. No patchVer, no typed data field models, no field IDs.
+        # Use for fast metadata lookup only — switch to org search (pages) for full data.
+        class PreviewPage < Logic::BaseModel
+          read_only!
+
+          passkey :id
+          passthrough :uid, :name, :state, :archived
+          passthrough :creatorName, :externalId
+          passdate :createdAt, :updatedAt
+
+          # locations, dataFields, stages returned as raw arrays — typed access not needed
+          # for a read-only ES-backed preview model. Use org search for typed field access.
+          passarray :locations, :dataFields, :stages, :tags
+        end
+      end
+    end
+  end
+end

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

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