ecoportal-api-graphql 2.0.0 → 3.0.0

data/lib/ecoportal/api/graphql/query/contractor_entities.rb

@@ -1,53 +1,53 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Query
-        class ContractorEntities < Logic::QueryConnection
-          field_name :contractorEntities
-
-          class_resolver :item_class, Model::ContractorEntity
-          class_resolver :connection_class, Connection::ContractorEntity
-
-          private
-
-          def basic_block(&block)
-            connection_block = block || default_connection_block
-            proc {
-              query(
-                searchConf: :Search,
-                after:      :string,
-                before:     :string,
-                first:      :int,
-                last:       :int
-              ) {
-                currentOrganization {
-                  contractorEntities(
-                    searchConf: :searchConf,
-                    after:      :after,
-                    before:     :before,
-                    first:      :first,
-                    last:       :last,
-                    &connection_block
-                  )
-                }
-              }
-            }
-          end
-
-          def default_connection_block
-            proc {
-              totalCount
-              pageInfo {
-                endCursor
-                hasNextPage
-              }
-              nodes {
-                spread :ContractorEntity
-              }
-            }
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        class ContractorEntities < Logic::QueryConnection
+          field_name :contractorEntities
+
+          class_resolver :item_class, Model::ContractorEntity
+          class_resolver :connection_class, Connection::ContractorEntity
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(
+                searchConf: :Search,
+                after:      :string,
+                before:     :string,
+                first:      :int,
+                last:       :int
+              ) {
+                currentOrganization {
+                  contractorEntities(
+                    searchConf: :searchConf,
+                    after:      :after,
+                    before:     :before,
+                    first:      :first,
+                    last:       :last,
+                    &connection_block
+                  )
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                spread :ContractorEntity
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/file_upload_signature.rb

@@ -1,76 +1,76 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Query
-        # Fetches S3 pre-signed upload credentials via GraphQL.
-        # These credentials are used to upload a file directly to S3.
-        # After the S3 upload, register the file with the EcoPortal backend
-        # using FileUpload::Client#register_and_poll to obtain a fileContainerId.
-        #
-        # Usage (via FileUpload::Client — do not call this directly):
-        #   api.file_upload.upload('/path/to/file.pdf')
-        class FileUploadSignature < Logic::Query
-          field_name :fileUploadSignature
-
-          def path
-            %w[currentOrganization fileUploadSignature]
-          end
-
-          def response_class
-            SignatureResponse
-          end
-
-          SignatureResponse = Struct.new(
-            :policy, :embedded_upload_policy, :embedded_upload_signature,
-            :signature, :endpoint, :access_key, :upload_prefix, :public_endpoint,
-            keyword_init: true
-          ) do
-            def to_h
-              members.to_h { |k| [k, self[k]] }
-            end
-          end
-
-          private
-
-          def basic_block(&block)
-            block_to_use = block || default_block
-            proc {
-              query {
-                currentOrganization {
-                  fileUploadSignature(&block_to_use)
-                }
-              }
-            }
-          end
-
-          def default_block
-            proc {
-              policy
-              embeddedUploadPolicy
-              embeddedUploadSignature
-              signature
-              endpoint
-              accessKey
-              uploadPrefix
-              publicEndpoint
-            }
-          end
-
-          def wrap_response(response, _path = [])
-            data = response.to_h.dig('data', 'currentOrganization', 'fileUploadSignature') || {}
-            SignatureResponse.new(
-              policy:                    data['policy'],
-              embedded_upload_policy:    data['embeddedUploadPolicy'],
-              embedded_upload_signature: data['embeddedUploadSignature'],
-              signature:                 data['signature'],
-              endpoint:                  data['endpoint'],
-              access_key:                data['accessKey'],
-              upload_prefix:             data['uploadPrefix'],
-              public_endpoint:           data['publicEndpoint']
-            )
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # Fetches S3 pre-signed upload credentials via GraphQL.
+        # These credentials are used to upload a file directly to S3.
+        # After the S3 upload, register the file with the EcoPortal backend
+        # using FileUpload::Client#register_and_poll to obtain a fileContainerId.
+        #
+        # Usage (via FileUpload::Client — do not call this directly):
+        #   api.file_upload.upload('/path/to/file.pdf')
+        class FileUploadSignature < Logic::Query
+          field_name :fileUploadSignature
+
+          def path
+            %w[currentOrganization fileUploadSignature]
+          end
+
+          def response_class
+            SignatureResponse
+          end
+
+          SignatureResponse = Struct.new(
+            :policy, :embedded_upload_policy, :embedded_upload_signature,
+            :signature, :endpoint, :access_key, :upload_prefix, :public_endpoint,
+            keyword_init: true
+          ) do
+            def to_h
+              members.to_h { |k| [k, self[k]] }
+            end
+          end
+
+          private
+
+          def basic_block(&block)
+            block_to_use = block || default_block
+            proc {
+              query {
+                currentOrganization {
+                  fileUploadSignature(&block_to_use)
+                }
+              }
+            }
+          end
+
+          def default_block
+            proc {
+              policy
+              embeddedUploadPolicy
+              embeddedUploadSignature
+              signature
+              endpoint
+              accessKey
+              uploadPrefix
+              publicEndpoint
+            }
+          end
+
+          def wrap_response(response, _path = [])
+            data = response.to_h.dig('data', 'currentOrganization', 'fileUploadSignature') || {}
+            SignatureResponse.new(
+              policy:                    data['policy'],
+              embedded_upload_policy:    data['embeddedUploadPolicy'],
+              embedded_upload_signature: data['embeddedUploadSignature'],
+              signature:                 data['signature'],
+              endpoint:                  data['endpoint'],
+              access_key:                data['accessKey'],
+              upload_prefix:             data['uploadPrefix'],
+              public_endpoint:           data['publicEndpoint']
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/location_classifications.rb

@@ -1,39 +1,39 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Query
-        class LocationClassifications < Logic::QueryArray
-          accepted_params :active, default: true
-
-          base_path 'currentOrganization.locations'
-          field_name :classifications
-
-          class_resolver :item_class, Base::LocationClassificationType
-
-          private
-
-          def basic_block(&block)
-            final_block = block || default_query_block
-            proc {
-              query(active: :boolean) {
-                currentOrganization {
-                  locations {
-                    classifications(active: :active, &final_block)
-                  }
-                }
-              }
-            }
-          end
-
-          def default_query_block
-            proc {
-              id
-              name
-              active
-            }
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        class LocationClassifications < Logic::QueryArray
+          accepted_params :active, default: true
+
+          base_path 'currentOrganization.locations'
+          field_name :classifications
+
+          class_resolver :item_class, Base::LocationClassificationType
+
+          private
+
+          def basic_block(&block)
+            final_block = block || default_query_block
+            proc {
+              query(active: :boolean) {
+                currentOrganization {
+                  locations {
+                    classifications(active: :active, &final_block)
+                  }
+                }
+              }
+            }
+          end
+
+          def default_query_block
+            proc {
+              id
+              name
+              active
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/page_delta.rb

@@ -1,47 +1,47 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Query
-        # Cache-invalidation query: given a list of (id, deltaAt) pairs, returns
-        # which pages have been UPDATED since that timestamp, are NOT_FOUND (deleted/
-        # inaccessible), or are NEW (id not recognised by the server).
-        #
-        # Usage:
-        #   Query::PageDelta.new(client).query(
-        #     deltaInput: [
-        #       { id: 'abc', deltaAt: '2026-01-01T00:00:00Z' },
-        #       { id: 'def', deltaAt: '2026-03-15T12:00:00Z' }
-        #     ]
-        #   )
-        #   # => [DeltaResult(id: 'abc', delta: 'UPDATED'), ...]
-        class PageDelta < Logic::QueryArray
-          field_name :pageDelta
-
-          accepted_params :deltaInput, :searchConf
-
-          class_resolver :item_class, 'Ecoportal::API::GraphQL::Base::DeltaResult'
-
-          private
-
-          def basic_block(&block)
-            item_block = block || default_block
-            proc {
-              query(deltaInput: :'[DeltaInput!]!', searchConf: :Search) {
-                currentOrganization {
-                  pageDelta(deltaInput: :deltaInput, searchConf: :searchConf, &item_block)
-                }
-              }
-            }
-          end
-
-          def default_block
-            proc {
-              id
-              delta
-            }
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # Cache-invalidation query: given a list of (id, deltaAt) pairs, returns
+        # which pages have been UPDATED since that timestamp, are NOT_FOUND (deleted/
+        # inaccessible), or are NEW (id not recognised by the server).
+        #
+        # Usage:
+        #   Query::PageDelta.new(client).query(
+        #     deltaInput: [
+        #       { id: 'abc', deltaAt: '2026-01-01T00:00:00Z' },
+        #       { id: 'def', deltaAt: '2026-03-15T12:00:00Z' }
+        #     ]
+        #   )
+        #   # => [DeltaResult(id: 'abc', delta: 'UPDATED'), ...]
+        class PageDelta < Logic::QueryArray
+          field_name :pageDelta
+
+          accepted_params :deltaInput, :searchConf
+
+          class_resolver :item_class, 'Ecoportal::API::GraphQL::Base::DeltaResult'
+
+          private
+
+          def basic_block(&block)
+            item_block = block || default_block
+            proc {
+              query(deltaInput: :'[DeltaInput!]!', searchConf: :Search) {
+                currentOrganization {
+                  pageDelta(deltaInput: :deltaInput, searchConf: :searchConf, &item_block)
+                }
+              }
+            }
+          end
+
+          def default_block
+            proc {
+              id
+              delta
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/pages.rb

@@ -1,59 +1,59 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Query
-        # DB-backed full-data org search — returns PageUnion nodes with patchVer and field IDs.
-        # Required pre-update fetch: always use this (not RegisterPreviewPages) before updatePage.
-        # See .ai-assistance/code/search_filters.md — "The Required Pattern: Find Before Mutate".
-        class Pages < Logic::QueryConnection
-          field_name :pages
-          # Response nests under currentOrganization.pages; needed when instantiated
-          # directly (e.g. Compat::Pages#each) rather than via the currentOrganization proxy.
-          base_path 'currentOrganization'
-
-          class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
-          class_resolver :connection_class, 'Ecoportal::API::GraphQL::Connection::Page'
-
-          private
-
-          def basic_block(&block)
-            connection_block = block || default_connection_block
-            proc {
-              query(
-                searchConf: :Search,
-                after:      :string,
-                before:     :string,
-                first:      :int,
-                last:       :int
-              ) {
-                currentOrganization {
-                  pages(
-                    searchConf: :searchConf,
-                    after:      :after,
-                    before:     :before,
-                    first:      :first,
-                    last:       :last,
-                    &connection_block
-                  )
-                }
-              }
-            }
-          end
-
-          def default_connection_block
-            proc {
-              totalCount
-              pageInfo {
-                endCursor
-                hasNextPage
-              }
-              nodes {
-                spread :PageFields
-              }
-            }
-          end
-        end
-      end
-    end
-  end
-end
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # DB-backed full-data org search — returns PageUnion nodes with patchVer and field IDs.
+        # Required pre-update fetch: always use this (not RegisterPreviewPages) before updatePage.
+        # See the repo's internal docs — "The Required Pattern: Find Before Mutate".
+        class Pages < Logic::QueryConnection
+          field_name :pages
+          # Response nests under currentOrganization.pages; needed when instantiated
+          # directly (e.g. Compat::Pages#each) rather than via the currentOrganization proxy.
+          base_path 'currentOrganization'
+
+          class_resolver :item_class, 'Ecoportal::API::GraphQL::Model::PageUnion'
+          class_resolver :connection_class, 'Ecoportal::API::GraphQL::Connection::Page'
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(
+                searchConf: :Search,
+                after:      :string,
+                before:     :string,
+                first:      :int,
+                last:       :int
+              ) {
+                currentOrganization {
+                  pages(
+                    searchConf: :searchConf,
+                    after:      :after,
+                    before:     :before,
+                    first:      :first,
+                    last:       :last,
+                    &connection_block
+                  )
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                spread :PageFields
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/permissions.rb

@@ -3,7 +3,7 @@ module Ecoportal
     class GraphQL
       module Query
         # Fetches the org-level permission set: currentOrganization.permissions.
-        # Returns a Model::Permissions whose ~83 canXXX fields are AuthorizationResult.
+        # Returns a Model::Permissions whose ~81 canXXX fields are AuthorizationResult.
         # Selects the :Permissions fragment (which spreads :AuthorizationResult per field).
         class Permissions < Logic::Query
           field_name :permissions

data/lib/ecoportal/api/graphql/query/person_members.rb

@@ -0,0 +1,76 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Query
+        # Lists +PersonMember+ nodes for the current organization via the
+        # GraphQL-native +organization.personMembers+ connection.
+        #
+        # This is the GraphQL-native people-directory path. It is INDEPENDENTLY
+        # USEFUL (it fills the long-standing gap flagged in
+        # +model/organization.rb+) but note: it is NOT the SCIM-sourced People
+        # replacement that customer integrations are migrating to before the
+        # APIv0 retirement, whose deadline has passed. That port is scoped in
+        # the +ecoportal-scim+ gem, project +apiv0-people-adapter+ -- not here.
+        #
+        # The default node selection intentionally inlines the fields declared on
+        # +Base::PersonMember+ rather than a +spread :PersonMember+, because no
+        # +PersonMember+ fragment is registered yet (a spread of an unregistered
+        # fragment raises at render time).
+        class PersonMembers < Logic::QueryConnection
+          field_name :personMembers
+
+          class_resolver :item_class, Model::PersonMember
+          class_resolver :connection_class, Connection::PersonMemberConnection
+
+          private
+
+          def basic_block(&block)
+            connection_block = block || default_connection_block
+            proc {
+              query(
+                searchConf:      :Search,
+                includeArchived: :boolean,
+                after:           :string,
+                before:          :string,
+                first:           :int,
+                last:            :int
+              ) {
+                currentOrganization {
+                  personMembers(
+                    searchConf:      :searchConf,
+                    includeArchived: :includeArchived,
+                    after:           :after,
+                    before:          :before,
+                    first:           :first,
+                    last:            :last,
+                    &connection_block
+                  )
+                }
+              }
+            }
+          end
+
+          def default_connection_block
+            proc {
+              totalCount
+              pageInfo {
+                endCursor
+                hasNextPage
+              }
+              nodes {
+                id
+                name
+                email
+                personSchemaId
+                contractorOrganizationId
+                userId
+                tagRestrict
+                userGroupIds
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/query/register_preset_views.rb

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