ecoportal-api-graphql 1.3.16 → 2.2.0

data/lib/ecoportal/api/common/graphql/model/diffable.rb

@@ -7,6 +7,7 @@ module Ecoportal
             require_relative 'diffable/hash_diff_nesting'
             require_relative 'diffable/classic_diff_service'
             require_relative 'diffable/diff_service'
+            require_relative 'diffable/leaf_diff_service'
 
             DIFF_CLASS = DiffService
 

data/lib/ecoportal/api/common/graphql/model.rb

@@ -1,17 +1,17 @@
-module Ecoportal
-  module API
-    module Common
-      module GraphQL
-        class Model < Ecoportal::API::Common::Content::DoubleModel
-          require 'ecoportal/api/common/graphql/model/diffable'
-          require 'ecoportal/api/common/graphql/model/as_input'
-
-          include Ecoportal::API::Common::GraphQL::ClassHelpers
-
-          include Diffable
-          include AsInput
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    module Common
+      module GraphQL
+        class Model < Ecoportal::API::Common::Content::DoubleModel
+          require 'ecoportal/api/common/graphql/model/diffable'
+          require 'ecoportal/api/common/graphql/model/as_input'
+
+          include Ecoportal::API::Common::GraphQL::ClassHelpers
+
+          include Diffable
+          include AsInput
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/common/graphql/patches.rb

@@ -1 +1 @@
-#require_relative 'patches/query'
+#require_relative 'patches/query'

data/lib/ecoportal/api/common/graphql/query_integration.rb

@@ -1,45 +1,45 @@
-module Ecoportal
-  module API
-    module Common
-      module GraphQL
-        module QueryIntegration
-          include Ecoportal::API::Common::GraphQL::ClassHelpers::ClassMethods
-
-          attr_accessor :client
-          attr_reader :path
-
-          # @!macro [attach] query
-          #   @method $1
-          #   The $1 query integration
-          #   @return [Collection::$1, $1]
-          #   @return [Connection::$1, $1]
-          def query(method, query_klass:, subpath: [])
-            method = method.to_sym
-            class_method = :"#{method}_query_class"
-
-            define_method(method) do |**kargs, &block|
-              if kargs.empty? && !block_given?
-                method(class_method).call
-              else
-                method(class_method).call.query(**kargs, &block)
-              end
-            end
-
-            define_method(class_method) do
-              final_path = path + [subpath].flatten.compact
-
-              resolve_class(query_klass).tap do |klass|
-                next if klass <= Ecoportal::API::GraphQL::Logic::BaseQuery
-
-                msg  = "Expected query_klass to be of type Ecoportal::API::GraphQL::Logic::BaseQuery. "
-                msg << "Given: #{klass}"
-                raise msg
-              end.new(client, base_path: final_path)
-            end
-            private class_method
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    module Common
+      module GraphQL
+        module QueryIntegration
+          include Ecoportal::API::Common::GraphQL::ClassHelpers::ClassMethods
+
+          attr_accessor :client
+          attr_reader :path
+
+          # @!macro [attach] query
+          #   @method $1
+          #   The $1 query integration
+          #   @return [Collection::$1, $1]
+          #   @return [Connection::$1, $1]
+          def query(method, query_klass:, subpath: [])
+            method = method.to_sym
+            class_method = :"#{method}_query_class"
+
+            define_method(method) do |**kargs, &block|
+              if kargs.empty? && !block_given?
+                method(class_method).call
+              else
+                method(class_method).call.query(**kargs, &block)
+              end
+            end
+
+            define_method(class_method) do
+              final_path = path + [subpath].flatten.compact
+
+              resolve_class(query_klass).tap do |klass|
+                next if klass <= Ecoportal::API::GraphQL::Logic::BaseQuery
+
+                msg  = "Expected query_klass to be of type Ecoportal::API::GraphQL::Logic::BaseQuery. "
+                msg << "Given: #{klass}"
+                raise msg
+              end.new(client, base_path: final_path)
+            end
+            private class_method
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,16 +1,16 @@
-module Ecoportal
-  module API
-    module Common
-      module GraphQL
-      end
-    end
-  end
-end
-
-require 'ecoportal/api/common/graphql/auth_service'
-require 'ecoportal/api/common/graphql/http_client'
-require 'ecoportal/api/common/graphql/client'
-require 'ecoportal/api/common/graphql/class_helpers'
-require 'ecoportal/api/common/graphql/hash_helpers'
-require 'ecoportal/api/common/graphql/model'
-require 'ecoportal/api/common/graphql/query_integration'
+module Ecoportal
+  module API
+    module Common
+      module GraphQL
+      end
+    end
+  end
+end
+
+require 'ecoportal/api/common/graphql/auth_service'
+require 'ecoportal/api/common/graphql/http_client'
+require 'ecoportal/api/common/graphql/client'
+require 'ecoportal/api/common/graphql/class_helpers'
+require 'ecoportal/api/common/graphql/hash_helpers'
+require 'ecoportal/api/common/graphql/model'
+require 'ecoportal/api/common/graphql/query_integration'

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

@@ -1,8 +1,8 @@
-module Ecoportal
-  module API
-    module Common
-    end
-  end
-end
-
-require_relative 'common/graphql'
+module Ecoportal
+  module API
+    module Common
+    end
+  end
+end
+
+require_relative 'common/graphql'

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

@@ -29,7 +29,7 @@ module Ecoportal
           embeds_one :createdAt, klass: Base::DateTime
           embeds_one :updatedAt, klass: Base::DateTime
           embeds_one :completedAt, klass: Base::DateTime
-          embeds_one :openededAt, klass: Base::DateTime
+          embeds_one :openedAt, klass: Base::DateTime
           embeds_one :closedAt, klass: Base::DateTime
           embeds_one :dueOrClosedDate, klass: Base::DateTime
 

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

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

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

@@ -0,0 +1,23 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # A scheduled/recurring occurrence of an action (calendar-style event view).
+        # Read-only. `occursAt` is an ISO8601 timestamp scalar (a plain string),
+        # not the `{ dateTime:, timeZone: }` DateTime object used elsewhere.
+        #
+        # status is exposed as a plain string ('open' | 'closed').
+        class ActionEvent < Logic::BaseModel
+          read_only!
+
+          passkey :id
+          passthrough :uid
+          passthrough :title, :subtitle, :description
+          passthrough :status, :relativeStatus
+          passthrough :occursAt
+          passboolean :archived, :recurring, :standaloneAction
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # The page (and stages) an ActionEvent is attached to. Read-only.
+        class ActionEventPage < Logic::BaseModel
+          read_only!
+
+          passkey :id
+          passthrough :name, :fieldId
+          passarray :stageIds
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,38 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # A single entry of a page's activity/history feed, returned by
+        # `page.activities` (ActivityInterfaceConnection). Read-only.
+        #
+        # `ActivityInterface` is an INTERFACE with ~61 concrete implementations
+        # (ActivityPageChangelog, ActivityComment, ActivityStageAssigned,
+        # ActivityCreated, ActivityEmailOut, ActivityFallback, ...). Rather than
+        # hand-model all of them, this captures the fields COMMON to the interface
+        # and passes the concrete `__typename` through so callers can branch on it.
+        #
+        # Enum-valued fields are exposed as plain strings:
+        # - priority: PriorityEnum
+        class Activity < Logic::BaseModel
+          read_only!
+
+          passkey :id
+          # Concrete type name (e.g. 'ActivityPageChangelog', 'ActivityComment', 'ActivityFallback').
+          passthrough :__typename
+          passthrough :priority
+          passthrough :stageId
+          passthrough :timeZone
+          # Origin of the activity — sourceId/sourceName are scalars; the polymorphic
+          # `source: SourceUnion` (BasicPage|PhasedPage) subtree is intentionally omitted.
+          passthrough :sourceId, :sourceName
+          passthrough :userId, :userEmail, :userName
+          passarray :categories, :subkey
+          passboolean :system, :fromPublicTemplate
+
+          embeds_one :createdAt, klass: Base::DateTime
+          embeds_one :updatedAt, klass: Base::DateTime
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,38 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # A single "System Access Log" entry, returned by
+        # `currentOrganization.activityLogs` (ActivityLogUnionConnection). Read-only.
+        #
+        # `ActivityLogUnion` is a UNION over 9 members:
+        #   DashboardAccess, DashboardCreate, DashboardDelete, DashboardUpdate,
+        #   DeniedDashboardAccess, DeniedPageAccess, FileDownload, PageAccess,
+        #   ScimIntegrationAccess.
+        # This models the field set COMMON to ALL members and passes the concrete
+        # `__typename` through. The Dashboard* members additionally expose
+        # `parentResource*` + `resource` (see Model::ActivityLog); page/file/scim
+        # members do not, so those live on the Model subclass as nullable embeds.
+        #
+        # Enum-valued fields are exposed as plain strings:
+        # - resourceType: ResourceTypesEnum
+        class ActivityLog < Logic::BaseModel
+          read_only!
+
+          passkey :id
+          # Concrete member type (e.g. 'DashboardAccess', 'PageAccess', 'FileDownload').
+          passthrough :__typename
+          passthrough :activityType
+          passthrough :source
+          passthrough :userType
+          passthrough :accountStatus
+          passthrough :becomingEmail
+          # content: Hash! — free-form activity payload; passed through as a Hash.
+          passthrough :content
+          passthrough :resourceId, :resourceName, :resourceType
+          embeds_one :createdAt, klass: Base::DateTime
+        end
+      end
+    end
+  end
+end

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

@@ -1,15 +1,20 @@
-module Ecoportal
+module Ecoportal
   module API
     class GraphQL
       module Base
-        # Represents one generation version of an AiSummary field.
-        # Returned by generateAiSummary — tracks the prompt, output, token usage, and status.
+        # One generation version of an AI page summary — the `item` of `generatePageSummary`.
+        #
+        # ★ Corrected 2026-07-30 against the live schema. The previous declarations (`prompt`,
+        # `inputTokens`, `outputTokens`, `totalTokens`, `resourceType`, `ratings`) do not exist on
+        # `AiSummaryVersion` and always read nil. The real fields are: aiSummary, alreadyRated,
+        # createdAt, dataFieldLogs, generationErrors, id, pagePatchVer, status.
+        #
+        # `dataFieldLogs` / `generationErrors` / `createdAt` are left unmodelled until their own
+        # shapes are verified — select and model them deliberately rather than by assumption.
         class AiSummaryVersion < Logic::BaseModel
-          passkey :id
-          passthrough :aiSummary, :status, :prompt
-          passthrough :inputTokens, :outputTokens, :totalTokens
-          passthrough :resourceType # "field" | "stage" | "page"
-          passarray :ratings        # [[user_id, score], ...]
+          passkey     :id
+          passthrough :aiSummary, :status, :pagePatchVer
+          passboolean :alreadyRated
         end
       end
     end

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

@@ -0,0 +1,24 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # System access log entry (SCIM / security auditing), returned by
+        # `Organization.authLogs`. Read-only.
+        #
+        # Enum-valued fields are exposed as plain strings:
+        # - event: 'LOGIN' | 'LOGOUT' | 'PASSWORD_CHANGE' | 'PASSWORD_RESET_REQUEST'
+        # - loginMethod: 'PASSWORD' | 'SAML' | 'MAGIC_LINK' | 'REDIRECT' | 'OAUTH'
+        # - source: 'WEB' | 'MOBILE'
+        class AuthLog < Logic::BaseModel
+          read_only!
+
+          passkey :id
+          passthrough :event, :source
+          passthrough :loginMethod
+          passthrough :host, :ipAddress, :referrer, :userAgent
+          embeds_one :createdAt, klass: Base::DateTime
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,20 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # AuthorizationResult — the result of a permission / ability check (a `canXXX` field).
+        #   value:   Boolean!  — whether the action is allowed
+        #   message: String    — human-readable reason when denied
+        #   reasons: FailureReasons — structured reasons (not modelled here; omitted from the
+        #                         :AuthorizationResult fragment to avoid pulling that subtree).
+        # Reusable node type behind the schema's many `canXXX: AuthorizationResult` fields.
+        class AuthorizationResult < Logic::BaseModel
+          read_only!
+
+          passboolean :value
+          passthrough :message
+        end
+      end
+    end
+  end
+end

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

@@ -3,7 +3,13 @@ module Ecoportal
     class GraphQL
       module Base
         class ContractorEntity
+          # Convenience mutators over the read-model `associatedPeopleIds` / `leadContractorIds`
+          # arrays. They push/delete plain ids so that `Input::ContractorEntity::Update.from_model`
+          # can later emit the IdDiff (additions/removals) against `original_doc`.
           module MemberChanges
+            # Associates one or more people. When `lead: true`, also marks them as leads.
+            # @param values [Array<String, Hash, Person, Enumerable>] ids (or things resolvable to ids).
+            # @param lead [Boolean] whether the associated people are also lead contractors.
             def associate(*values, lead: false)
               ids = to_person_ids(*values)
 
@@ -15,7 +21,9 @@ module Ecoportal
               end
             end
 
-            def dissassociate(*values)
+            # Disassociates one or more people (also removing them as leads).
+            # @param values [Array<String, Hash, Person, Enumerable>] ids (or resolvable to ids).
+            def disassociate(*values)
               ids = to_person_ids(*values)
 
               associatedPeopleIds.tap do |associated|
@@ -23,7 +31,10 @@ module Ecoportal
                 associated.delete!(*ids)
               end
             end
+            # @deprecated Backwards-compatible alias for the original misspelling.
+            alias_method :dissassociate, :disassociate
 
+            # Marks one or more people as lead contractors (associating them if not already).
             def lead!(*values)
               ids = to_person_ids(*values)
 
@@ -33,6 +44,7 @@ module Ecoportal
               end
             end
 
+            # Removes one or more people from the lead contractors list.
             def unlead!(*values)
               ids = to_person_ids(*values)
 
@@ -44,7 +56,7 @@ module Ecoportal
             private
 
             def to_person_ids(*values)
-              to_person_id(values.flatten)
+              Array(to_person_id(values.flatten)).flatten.compact
             end
 
             def to_person_id(value)
@@ -54,9 +66,9 @@ module Ecoportal
               when Ecoportal::API::V1::Person
                 value.id
               when Hash
-                to_person_id(['id'])
-              when Enumarable
-                value.map {|val| to_person_id(val)}.compact
+                value['id'] || value[:id]
+              when Enumerable
+                value.map { |val| to_person_id(val) }.compact
               end
             end
           end

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

@@ -1,24 +1,24 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class ContractorEntity < Logic::BaseModel
-          require 'ecoportal/api/graphql/base/contractor_entity/member_changes'
-
-          include MemberChanges
-
-          root!
-
-          passkey :id
-          passthrough :externalId
-          passthrough :name
-          passboolean :active, :approved
-          passthrough :schemaId
-
-          passarray :associatedPeopleIds, :leadContractorIds
-          embeds_one :creator, klass: 'Ecoportal::API::GraphQL::Model::User'
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class ContractorEntity < Logic::BaseModel
+          require 'ecoportal/api/graphql/base/contractor_entity/member_changes'
+
+          include MemberChanges
+
+          root!
+
+          passkey :id
+          passthrough :externalId
+          passthrough :name
+          passboolean :active, :approved
+          passthrough :schemaId
+
+          passarray :associatedPeopleIds, :leadContractorIds
+          embeds_one :creator, klass: 'Ecoportal::API::GraphQL::Model::User'
+        end
+      end
+    end
+  end
+end

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

@@ -1,12 +1,12 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class DateTime < Logic::BaseModel
-          passdate    :dateTime
-          passthrough :timeZone
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class DateTime < Logic::BaseModel
+          passdate    :dateTime
+          passthrough :timeZone
+        end
+      end
+    end
+  end
+end

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

@@ -1,16 +1,16 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        # Result of a pageDelta query for a single page ID.
-        # delta: 'UPDATED' | 'NOT_FOUND' | 'NEW'
-        class DeltaResult < Logic::BaseModel
-          read_only!
-
-          passkey :id
-          passthrough :delta
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        # Result of a pageDelta query for a single page ID.
+        # delta: 'UPDATED' | 'NOT_FOUND' | 'NEW'
+        class DeltaResult < Logic::BaseModel
+          read_only!
+
+          passkey :id
+          passthrough :delta
+        end
+      end
+    end
+  end
+end

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

@@ -1,12 +1,12 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class Field < Logic::BaseModel
-          passkey :id
-          passthrough :label
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class Field < Logic::BaseModel
+          passkey :id
+          passthrough :label
+        end
+      end
+    end
+  end
+end

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

@@ -1,15 +1,15 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Base
-        class FileAttachment < Logic::BaseModel
-          passkey :id
-          passthrough :attachmentFileSize, :attachmentFileName, :attachmentContentType
-          passthrough :urlType, :activeName
-          passthrough :userId, :userName
-          embeds_one :attachmentUpdatedAt, klass: Base::DateTime
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Base
+        class FileAttachment < Logic::BaseModel
+          passkey :id
+          passthrough :attachmentFileSize, :attachmentFileName, :attachmentContentType
+          passthrough :urlType, :activeName
+          passthrough :userId, :userName
+          embeds_one :attachmentUpdatedAt, klass: Base::DateTime
+        end
+      end
+    end
+  end
+end