ecoportal-api-graphql 1.3.13 → 1.3.15

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/task.rb

@@ -0,0 +1,24 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+          # A page TASK — the `item` of the review-task mutations (`TaskInterface`:
+          # CompletePage / InComment / ReviewPage). Read-only.
+          #
+          # This is NOT a page: the page it belongs to is `subject` (a PageUnion). The
+          # review-task payloads used to type `item` as `Model::PageUnion`, which never
+          # matched the schema (see `Fragment :PageTaskFields`).
+          class Task < Logic::BaseModel
+            read_only!
+
+            passkey     :id
+            passthrough :__typename, :stageId, :relativeStatus, :taskNotes
+            passboolean :complete, :overdue, :escalated
+            passdate    :createdAt, :completedAt, :due
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,16 +1,17 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        module Page
-        end
-      end
-    end
-  end
-end
-
-require_relative 'page/basic'
-require_relative 'page/data_field'
-require_relative 'page/section'
-require_relative 'page/section_collection'
-require_relative 'page/phased'
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        module Page
+        end
+      end
+    end
+  end
+end
+
+require_relative 'page/basic'
+require_relative 'page/data_field'
+require_relative 'page/section'
+require_relative 'page/section_collection'
+require_relative 'page/phased'
+require_relative 'page/task'

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

@@ -0,0 +1,35 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # Namespace for the narrow template-side types.
+        #
+        # ★ Note the platform asymmetry: in most of this gem a "template" IS a page (a page with
+        # `template: true`), which is why `Query::Templates` and most `Payload::Template::*`
+        # resolve to `Model::PageUnion`. The two types here are the exceptions — distinct schema
+        # types returned by specific template mutations.
+        module Template
+          # `item` of `updateTemplateInformation` (schema type `Template`). Read-only.
+          class Information < Logic::BaseModel
+            read_only!
+
+            passkey     :id
+            passthrough :description, :aiDescription, :templateType, :templateContainerUid
+            passboolean :active, :public, :creatorEnabled, :creatorEditable
+            passarray   :folders
+          end
+
+          # `item` of `createTemplateRelatedPage` / `destroyTemplateRelatedPage`
+          # (schema type `RelatedPages`) — a related-pages CONFIG entry, not a page. Read-only.
+          class RelatedPages < Logic::BaseModel
+            read_only!
+
+            passkey     :id
+            passthrough :title, :registerId
+            passboolean :hasInaccessibleVariables
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,35 +1,37 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-      end
-    end
-  end
-end
-
-require_relative 'base/date_time'
-require_relative 'base/page_info'
-require_relative 'base/location_classification_type'
-require_relative 'base/location_node'
-require_relative 'base/location_structure'
-require_relative 'base/person_member'
-require_relative 'base/file_attachment'
-require_relative 'base/file_container'
-require_relative 'base/field'
-require_relative 'base/page'
-require_relative 'base/resource'
-require_relative 'base/action_category'
-require_relative 'base/action'
-require_relative 'base/contractor_entity'
-require_relative 'base/preview_page'
-require_relative 'base/delta_result'
-require_relative 'base/organization'
-
-require_relative 'base/register'
-require_relative 'base/preset_view'
-
-require_relative 'base/ai_summary_version'
-
-require_relative 'base/force'
-require_relative 'base/pages_workflow'
-require_relative 'base/kickstand'
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+      end
+    end
+  end
+end
+
+require_relative 'base/date_time'
+require_relative 'base/page_info'
+require_relative 'base/location_classification_type'
+require_relative 'base/location_node'
+require_relative 'base/location_structure'
+require_relative 'base/person_member'
+require_relative 'base/file_attachment'
+require_relative 'base/file_container'
+require_relative 'base/field'
+require_relative 'base/page'
+require_relative 'base/resource'
+require_relative 'base/action_category'
+require_relative 'base/action'
+require_relative 'base/contractor_entity'
+require_relative 'base/preview_page'
+require_relative 'base/delta_result'
+require_relative 'base/organization'
+
+require_relative 'base/register'
+require_relative 'base/preset_view'
+
+require_relative 'base/ai_summary_version'
+
+require_relative 'base/force'
+require_relative 'base/pages_workflow'
+require_relative 'base/kickstand'
+
+require_relative 'base/template'

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

@@ -1,41 +1,41 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Builder
-        class ContractorEntity
-          attr_reader :client
-
-          def initialize(client)
-            @client = client
-          end
-
-          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
-
-          private
-
-          def createMutation
-            Mutation::ContractorEntity::Create.new(client)
-          end
-
-          def updateMutation
-            Mutation::ContractorEntity::Update.new(client)
-          end
-
-          def destroyMutation
-            Mutation::ContractorEntity::Destroy.new(client)
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Builder
+        class ContractorEntity
+          attr_reader :client
+
+          def initialize(client)
+            @client = client
+          end
+
+          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
+
+          private
+
+          def createMutation
+            Mutation::ContractorEntity::Create.new(client)
+          end
+
+          def updateMutation
+            Mutation::ContractorEntity::Update.new(client)
+          end
+
+          def destroyMutation
+            Mutation::ContractorEntity::Destroy.new(client)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/compat/response.rb

@@ -1,35 +1,35 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Compat
-        # Wraps a GraphQL mutation payload to expose the v2-compatible response interface.
-        # Scripts check .success? and .status after update/create operations.
-        class Response
-          def initialize(payload)
-            @payload = payload
-          end
-
-          def success?
-            @payload.success?
-          end
-
-          def error?
-            @payload.error?
-          end
-
-          def status
-            @payload.error? ? :error : :ok
-          end
-
-          def body
-            @payload.error_doc
-          end
-
-          def item
-            @payload.item
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Compat
+        # Wraps a GraphQL mutation payload to expose the v2-compatible response interface.
+        # Scripts check .success? and .status after update/create operations.
+        class Response
+          def initialize(payload)
+            @payload = payload
+          end
+
+          def success?
+            @payload.success?
+          end
+
+          def error?
+            @payload.error?
+          end
+
+          def status
+            @payload.error? ? :error : :ok
+          end
+
+          def body
+            @payload.error_doc
+          end
+
+          def item
+            @payload.item
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class Action < Logic::Connection
-          class_resolver :node_class, Model::Action
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class Action < Logic::Connection
+          class_resolver :node_class, Model::Action
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection/action_category.rb

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class ActionCategory < Logic::Connection
-          class_resolver :node_class, Base::ActionCategory
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class ActionCategory < Logic::Connection
+          class_resolver :node_class, Base::ActionCategory
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection/contractor_entity.rb

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class ContractorEntity < Logic::Connection
-          class_resolver :node_class, Model::ContractorEntity
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class ContractorEntity < Logic::Connection
+          class_resolver :node_class, Model::ContractorEntity
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection/page.rb

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class Page < Logic::Connection
-          class_resolver :node_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class Page < Logic::Connection
+          class_resolver :node_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+        end
+      end
+    end
+  end
+end

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

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class PersonMemberConnection < Logic::Connection
-          class_resolver :node_class, Model::PersonMember
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class PersonMemberConnection < Logic::Connection
+          class_resolver :node_class, Model::PersonMember
+        end
+      end
+    end
+  end
+end

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

@@ -1,11 +1,11 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-        class PreviewPage < Logic::Connection
-          class_resolver :node_class, 'Ecoportal::API::GraphQL::Model::PreviewPage'
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+        class PreviewPage < Logic::Connection
+          class_resolver :node_class, 'Ecoportal::API::GraphQL::Model::PreviewPage'
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/connection.rb

@@ -1,17 +1,17 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Connection
-      end
-    end
-  end
-end
-
-require_relative 'connection/person_member'
-require_relative 'connection/contractor_entity'
-require_relative 'connection/action_category'
-require_relative 'connection/action'
-require_relative 'connection/page'
-require_relative 'connection/preview_page'
-require_relative 'connection/preset_view'
-require_relative 'connection/pages_workflow_command'
+module Ecoportal
+  module API
+    class GraphQL
+      module Connection
+      end
+    end
+  end
+end
+
+require_relative 'connection/person_member'
+require_relative 'connection/contractor_entity'
+require_relative 'connection/action_category'
+require_relative 'connection/action'
+require_relative 'connection/page'
+require_relative 'connection/preview_page'
+require_relative 'connection/preset_view'
+require_relative 'connection/pages_workflow_command'

data/lib/ecoportal/api/graphql/file_upload/client.rb

@@ -22,7 +22,12 @@ module Ecoportal
         #   page.components.get_by_name('Attachment').file_container_ids = [container_id]
         #   api.pages.update(page)
         #
-        # Requires the gem to have been initialised with email/pass (OAuth Bearer token).
+        # Step 1 (GraphQL) authenticates via the gem's email/pass OAuth bearer token.
+        # Steps 3-4 (REST v2 `/s3/files`) require the gem to ALSO have been initialised
+        # with `api_key:` — `Ecoportal::API::GraphQL.new(email:, pass:, api_key:)` — since
+        # those endpoints authenticate via `X-ECOPORTAL-API-KEY`, not the GraphQL bearer
+        # token (mirrors `Ecoportal::API::Common::Content::Client#base_request` in
+        # ecoportal-api-v2).
         class Client
           POLL_INTERVAL = 2      # seconds between poll attempts
           POLL_MAX_WAIT = 120    # seconds before giving up
@@ -111,10 +116,16 @@ module Ecoportal
             end
           end
 
-          # --- REST helpers (v2 endpoints, Bearer token auth) ---
+          # --- REST helpers (v2 endpoints, X-ECOPORTAL-API-KEY auth) ---
 
-          def bearer_token
-            @bearer_token ||= @http_client.send(:key_token)
+          def api_key
+            @api_key ||= @http_client.api_key.tap do |key|
+              if key.nil? || key.to_s.strip.empty?
+                raise 'File upload requires an api_key: Ecoportal::API::GraphQL.new(email:, pass:, api_key:). ' \
+                      'The v2 REST endpoints used to register/poll an upload authenticate via ' \
+                      'X-ECOPORTAL-API-KEY, not the GraphQL OAuth bearer token.'
+              end
+            end
           end
 
           def upload_base_url
@@ -124,18 +135,18 @@ module Ecoportal
           def upload_get(path)
             uri     = URI("#{upload_base_url}#{path}")
             request = Net::HTTP::Get.new(uri)
-            request['Authorization'] = "Bearer #{bearer_token}"
-            request['Accept']        = 'application/json'
+            request['X-ECOPORTAL-API-KEY'] = api_key
+            request['Accept']              = 'application/json'
             Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }
           end
 
           def upload_post(path, body)
             uri     = URI("#{upload_base_url}#{path}")
             request = Net::HTTP::Post.new(uri)
-            request['Authorization'] = "Bearer #{bearer_token}"
-            request['Content-Type']  = 'application/json'
-            request['Accept']        = 'application/json'
-            request.body             = JSON.generate(body)
+            request['X-ECOPORTAL-API-KEY'] = api_key
+            request['Content-Type']        = 'application/json'
+            request['Accept']              = 'application/json'
+            request.body                   = JSON.generate(body)
             Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }
           end