ecoportal-api-graphql 2.0.0 → 2.2.0

data/lib/ecoportal/api/graphql/base/page/data_field/ai_summary.rb

@@ -1,18 +1,18 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    # AI-generated summary field.
-    # Content is generated server-side via generateAiSummary mutation (Bedrock Claude).
-    # Not settable via DataFieldInput — use the dedicated mutation instead.
-    #
-    # instructions: the AI prompt configured on this field in the template.
-    # trigger: "submitted" | "approved" — when generation fires.
-    # trigger_stage_ids: stages that trigger generation (empty = all stages).
-    # text_format: "simple_text" | "bullet_points" | "numbered_list" | "headings"
-    class AiSummary < DataField
-      passthrough :aiSummary, :generatedAt, :instructions
-      passthrough :trigger, :textFormat
-      passarray   :triggerStageIds, :fieldConfigurations
-      passboolean :alreadyRated
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    # AI-generated summary field.
+    # Content is generated server-side via generateAiSummary mutation (Bedrock Claude).
+    # Not settable via DataFieldInput — use the dedicated mutation instead.
+    #
+    # instructions: the AI prompt configured on this field in the template.
+    # trigger: "submitted" | "approved" — when generation fires.
+    # trigger_stage_ids: stages that trigger generation (empty = all stages).
+    # text_format: "simple_text" | "bullet_points" | "numbered_list" | "headings"
+    class AiSummary < DataField
+      passthrough :aiSummary, :generatedAt, :instructions
+      passthrough :trigger, :textFormat
+      passarray   :triggerStageIds, :fieldConfigurations
+      passboolean :alreadyRated
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/data_field/checklist.rb

@@ -1,29 +1,29 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    class Checklist < DataField
-      passarray :items # each: { id:, label:, checked: }
-      passthrough :complete
-
-      # Check/uncheck an item by label or id.
-      def check(label_or_id, checked: true)
-        item = (doc['items'] || []).find { |i| i['label'] == label_or_id.to_s || i['id'] == label_or_id.to_s }
-        return unless item
-
-        item['checked'] = checked
-      end
-
-      def as_input
-        return nil unless dirty?
-
-        {
-          checklist: {
-            id:    id,
-            # rubocop:disable Style/DoubleNegation
-            items: (doc['items'] || []).map { |i| { id: i['id'], checked: !!i['checked'] } }
-            # rubocop:enable Style/DoubleNegation
-          }
-        }
-      end
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    class Checklist < DataField
+      passarray :items # each: { id:, label:, checked: }
+      passthrough :complete
+
+      # Check/uncheck an item by label or id.
+      def check(label_or_id, checked: true)
+        item = (doc['items'] || []).find { |i| i['label'] == label_or_id.to_s || i['id'] == label_or_id.to_s }
+        return unless item
+
+        item['checked'] = checked
+      end
+
+      def as_input
+        return nil unless dirty?
+
+        {
+          checklist: {
+            id:    id,
+            # rubocop:disable Style/DoubleNegation
+            items: (doc['items'] || []).map { |i| { id: i['id'], checked: !!i['checked'] } }
+            # rubocop:enable Style/DoubleNegation
+          }
+        }
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/data_field/cross_reference.rb

@@ -1,4 +1,4 @@
-module Ecoportal::API::GraphQL::Base::Page
+module Ecoportal::API::GraphQL::Base::Page
   class DataField
     # Cross-reference field — links to pages in another register.
     class CrossReference < DataField

data/lib/ecoportal/api/graphql/base/page/data_field/date_field.rb

@@ -1,23 +1,23 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    # Wraps Date data field. Mapped from __typename 'Date'.
-    # value is an ISO8601DateTime string (e.g. "2024-11-25T08:30:00+13:00").
-    class DateField < DataField
-      # value is nested: { dateTime: "...", timeZone: "..." } or raw string
-      def value
-        v = doc['value']
-        v.is_a?(Hash) ? v['dateTime'] : v
-      end
-
-      def value=(iso8601_string)
-        doc['value'] = iso8601_string
-      end
-
-      def as_input
-        return nil unless dirty?
-
-        { date: { id: id, value: value } }
-      end
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    # Wraps Date data field. Mapped from __typename 'Date'.
+    # value is an ISO8601DateTime string (e.g. "2024-11-25T08:30:00+13:00").
+    class DateField < DataField
+      # value is nested: { dateTime: "...", timeZone: "..." } or raw string
+      def value
+        v = doc['value']
+        v.is_a?(Hash) ? v['dateTime'] : v
+      end
+
+      def value=(iso8601_string)
+        doc['value'] = iso8601_string
+      end
+
+      def as_input
+        return nil unless dirty?
+
+        { date: { id: id, value: value } }
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/data_field/geo.rb

@@ -1,24 +1,24 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    class Geo < DataField
-      passthrough :address, :coordinates # coordinates: { lat:, lon: }
-
-      def address=(new_address)
-        doc['address'] = new_address
-      end
-
-      def coordinates=(lat_lon_hash)
-        doc['coordinates'] = lat_lon_hash
-      end
-
-      def as_input
-        return nil unless dirty?
-
-        payload = { id: id }
-        payload[:address]     = address     if address
-        payload[:coordinates] = coordinates if coordinates
-        { geo: payload }
-      end
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    class Geo < DataField
+      passthrough :address, :coordinates # coordinates: { lat:, lon: }
+
+      def address=(new_address)
+        doc['address'] = new_address
+      end
+
+      def coordinates=(lat_lon_hash)
+        doc['coordinates'] = lat_lon_hash
+      end
+
+      def as_input
+        return nil unless dirty?
+
+        payload = { id: id }
+        payload[:address]     = address     if address
+        payload[:coordinates] = coordinates if coordinates
+        { geo: payload }
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/data_field/image_gallery.rb

@@ -1,4 +1,4 @@
-module Ecoportal::API::GraphQL::Base::Page
+module Ecoportal::API::GraphQL::Base::Page
   class DataField
     # Image gallery field.
     # ★ WRITE PATH BROKEN (schema-invalid, live-verified 2026-08): `ImageGalleryInput` has no

data/lib/ecoportal/api/graphql/base/page/data_field/law.rb

@@ -1,8 +1,8 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    # Legal obligation / law snippets field — read access only.
-    class Law < DataField
-      passarray :laws # each: { id:, content: }
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    # Legal obligation / law snippets field — read access only.
+    class Law < DataField
+      passarray :laws # each: { id:, content: }
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/data_field/mailbox.rb

@@ -1,9 +1,9 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    # Mailbox field — email inbox linked to this field.
-    # Managed by the system; not settable via script.
-    class Mailbox < DataField
-      passthrough :email, :enabled
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    # Mailbox field — email inbox linked to this field.
+    # Managed by the system; not settable via script.
+    class Mailbox < DataField
+      passthrough :email, :enabled
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/data_field/plain_text.rb

@@ -1,17 +1,17 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    class PlainText < DataField
-      passthrough :value
-
-      def value=(new_value)
-        doc['value'] = new_value
-      end
-
-      def as_input
-        return nil unless dirty?
-
-        { plainText: { id: id, value: value } }
-      end
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    class PlainText < DataField
+      passthrough :value
+
+      def value=(new_value)
+        doc['value'] = new_value
+      end
+
+      def as_input
+        return nil unless dirty?
+
+        { plainText: { id: id, value: value } }
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/data_field/rich_text.rb

@@ -1,26 +1,26 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    class RichText < DataField
-      passthrough :content
-
-      def content=(new_content)
-        doc['content'] = new_content
-      end
-
-      # v2 compat alias — RichText value is stored as content
-      def value
-        content
-      end
-
-      def value=(new_value)
-        self.content = new_value
-      end
-
-      def as_input
-        return nil unless dirty?
-
-        { richText: { id: id, content: content } }
-      end
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    class RichText < DataField
+      passthrough :content
+
+      def content=(new_content)
+        doc['content'] = new_content
+      end
+
+      # v2 compat alias — RichText value is stored as content
+      def value
+        content
+      end
+
+      def value=(new_value)
+        self.content = new_value
+      end
+
+      def as_input
+        return nil unless dirty?
+
+        { richText: { id: id, content: content } }
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/data_field/signature.rb

@@ -1,9 +1,9 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    # Digital signature capture field — read access only.
-    # Signatures are captured through the UI; not settable via script.
-    class Signature < DataField
-      passthrough :signedAt, :signerName
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    # Digital signature capture field — read access only.
+    # Signatures are captured through the UI; not settable via script.
+    class Signature < DataField
+      passthrough :signedAt, :signerName
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/data_field/smart_fill.rb

@@ -1,17 +1,17 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    # SmartFill field — AI-auto-populated field using a template-defined prompt.
-    # Value is generated server-side via Bedrock; trigger_type controls when.
-    #
-    # Read-only for DataFieldInput — use the generateSmartFill GraphQL mutation
-    # (or its trigger) to populate. The instructions field is template-configured
-    # and can be reviewed/updated via template management.
-    class SmartFill < DataField
-      passthrough :status        # pending | generating | success | failed
-      passthrough :trigger_type  # manual | snapshot | live
-      passthrough :instructions  # the AI prompt configured on the template field
-      passboolean :edit_enabled
-      passthrough :generated_at
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    # SmartFill field — AI-auto-populated field using a template-defined prompt.
+    # Value is generated server-side via Bedrock; trigger_type controls when.
+    #
+    # Read-only for DataFieldInput — use the generateSmartFill GraphQL mutation
+    # (or its trigger) to populate. The instructions field is template-configured
+    # and can be reviewed/updated via template management.
+    class SmartFill < DataField
+      passthrough :status        # pending | generating | success | failed
+      passthrough :trigger_type  # manual | snapshot | live
+      passthrough :instructions  # the AI prompt configured on the template field
+      passboolean :edit_enabled
+      passthrough :generated_at
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/data_field/table.rb

@@ -1,9 +1,9 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    # Table / embedded structure field — read access only.
-    # Complex structured data managed via its own mutation path.
-    class Table < DataField
-      passarray :rows
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    # Table / embedded structure field — read access only.
+    # Complex structured data managed via its own mutation path.
+    class Table < DataField
+      passarray :rows
+    end
+  end
+end

data/lib/ecoportal/api/graphql/base/page/data_field/tag_field.rb

@@ -1,21 +1,21 @@
-module Ecoportal::API::GraphQL::Base::Page
-  class DataField
-    # Location/tag field — mapped from __typename 'TagField'.
-    class TagField < DataField
-      passarray :locations # each: { id:, name: }
-
-      def location_ids
-        Array(locations).map { |l| l['id'] }.compact
-      end
-
-      def location_ids=(ids)
-        doc['locations'] = Array(ids).map { |id_val| { 'id' => id_val } }
-      end
-
-      # NOTE: LocationFieldInput has NO location-value field — page locations are set at the
-      # PAGE level (UpdatePageInput.page.locations, via Interface::BasePage#location_ids=),
-      # not via the data field. So this field contributes no value to dataFields.updates;
-      # it inherits DataField#as_input (nil). location_ids/= stay as field-level read/staging.
-    end
-  end
-end
+module Ecoportal::API::GraphQL::Base::Page
+  class DataField
+    # Location/tag field — mapped from __typename 'TagField'.
+    class TagField < DataField
+      passarray :locations # each: { id:, name: }
+
+      def location_ids
+        Array(locations).map { |l| l['id'] }.compact
+      end
+
+      def location_ids=(ids)
+        doc['locations'] = Array(ids).map { |id_val| { 'id' => id_val } }
+      end
+
+      # NOTE: LocationFieldInput has NO location-value field — page locations are set at the
+      # PAGE level (UpdatePageInput.page.locations, via Interface::BasePage#location_ids=),
+      # not via the data field. So this field contributes no value to dataFields.updates;
+      # it inherits DataField#as_input (nil). location_ids/= stay as field-level read/staging.
+    end
+  end
+end

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