ecoportal-api-graphql 1.3.5 → 1.3.9

data/lib/ecoportal/api/graphql/fragment/pages/common_page_union.rb

@@ -0,0 +1,395 @@
+# CommonPageUnion — unified page fragment for all customer integration patterns.
+#
+# Covers three core use cases via boolean query variables:
+#
+#   CREATE sequence (2-step):
+#     (a) buildFromTemplate → fetch built draft with ($fields: true) to get
+#         server-assigned data field IDs
+#     (b) fill in values → createFromTemplate
+#
+#   UPDATE sequence (2-step):
+#     (a) fetch current page with ($content: true, $fields: true) to get patchVer
+#         + current field IDs/values (IDs change after DB creation — must be read)
+#     (b) build update operations → updatePage
+#
+#   VERIFY after create/update:
+#     fetch with ($content: true, $only_content: true) to confirm result
+#
+# Variables:
+#   $content      — include field values, stage completions, files, people
+#   $only_content — exclude structural/config fields; content values only
+#   $fields       — include data field definitions (labels, options, structure)
+#
+# Documented in Jira API Docs space (Confluence APIDOCS).
+# Access: fragment.pages.assemble(:CommonPageUnion)
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        class Pages
+          fragment :CommonPageUnion, <<~GRAPHQL
+            fragment CommonPageUnion on PageUnion {
+              ...corePageData
+              ... on PhasedPage {
+                stages { ...stageAttrs }
+                attachedFiles @include(if: $content) {
+                  id @skip(if: $only_content)
+                  activeFileAttachment { downloadUrl }
+                }
+                activeStages {
+                  id
+                  name
+                  ordering
+                }
+              }
+              ... on BasicPage {
+                sections { ...sectionUnion }
+              }
+            }
+
+            fragment taskInterface on TaskInterface {
+              id
+              fromPublicTemplate
+              complete
+              completedAt { dateTime   }
+              completedBy { name email }
+              due         { dateTime   }
+              overdue
+              users       { name email }
+            }
+
+            fragment stageAttrs on Stage {
+              id @skip(if: $only_content)
+              name
+              ...sectionsFragment
+              active
+              started
+              state
+              completedBy @include(if: $content) { name email }
+              activeTask  @include(if: $content) { ...taskInterface }
+            }
+
+            fragment locationNode on LocationNodeInterface {
+              id
+              name
+              archived
+              classifications { name    }
+              ancestors       { id name }
+            }
+
+            fragment corePageData on BasePageInterface {
+              __typename
+              id
+              patchVer
+              externalId
+              name
+              uid
+              locations { ...locationNode }
+              otherTags @include(if: $content)
+              timeZone
+              updatedAt { dateTime        }
+              createdAt { dateTime        }
+              creator   { name email      }
+              state
+              archived
+            }
+
+            fragment sectionsFragment on Stage {
+              ... on HasSectionsInterface {
+                sections { ...sectionUnion }
+              }
+            }
+
+            fragment sectionUnion on SectionUnion {
+              __typename
+              ... on ContentSection {
+                id
+                heading
+                dataFields @include(if: $fields) { ...dataField }
+              }
+              ... on SplitSection {
+                id
+                heading
+                leftDataFields  @include(if: $fields) { ...dataField }
+                rightDataFields @include(if: $fields) { ...dataField }
+              }
+            }
+
+            fragment dataFieldInterface on DataFieldsInterface {
+              __typename
+              id                @skip(if: $only_content)
+              label
+              deindex           @include(if: $content)
+              linkedFieldConfig @skip(if: $only_content) {
+                crossReferenceId
+                crossReferenceField { label }
+                sourceFieldKey
+              }
+            }
+
+            fragment dataField on DataFieldUnion {
+              ...dataFieldInterface
+              ...locationField
+              ...geoField
+              ...numberField
+              ...gaugeField
+              ...dateField
+              ...plainTextField
+              ...richTextField
+              ...selectField
+              ...checklistField
+              ...signatureField
+              ...imageGalleryField
+              ...fileField
+              ...peopleField
+              ...contractorEntitiesField
+              ...crossReferenceField
+              ...mailboxField
+              ...lawField
+              ...aiSummaryField @include(if: $content)
+              ...actionsListField
+            }
+
+            fragment locationField on TagField {
+              required                 @skip(if: $only_content)
+              restrictByClassification @skip(if: $only_content)
+              allowedClassifications   @skip(if: $only_content)
+              singleSelect             @skip(if: $only_content)
+              locations @include(if: $content) { ...locationNode }
+            }
+
+            fragment geoField on Geo {
+              required    @skip(if: $only_content)
+              address     @include(if: $content)
+              coordinates @include(if: $content)
+            }
+
+            fragment numberField on Number {
+              required @skip(if: $only_content)
+              value    @include(if: $content)
+            }
+
+            fragment gaugeField on Gauge {
+              max   @skip(if: $only_content)
+              value @include(if: $content)
+            }
+
+            fragment dateField on Date {
+              required @skip(if: $only_content)
+              pastOnly @skip(if: $only_content)
+              showTime @skip(if: $only_content)
+              value    @include(if: $content) { dateTime }
+            }
+
+            fragment plainTextField on PlainText {
+              required  @skip(if: $only_content)
+              multiline @skip(if: $only_content)
+              value     @include(if: $content)
+            }
+
+            fragment richTextField on RichText {
+              required @skip(if: $only_content)
+              content  @include(if: $content)
+            }
+
+            fragment selectField on Select {
+              required @skip(if: $only_content)
+              multiple @skip(if: $only_content)
+              dataType
+              options {
+                id
+                selected @include(if: $content)
+                value
+                name
+              }
+              other
+              otherDesc @include(if: $content)
+            }
+
+            fragment checklistField on Checklist {
+              complete
+              items { checked label }
+            }
+
+            fragment signatureField on Signature {
+              required     @skip(if: $only_content)
+              signedByName @include(if: $content)
+              signatureUpdatedAt { dateTime }
+              signedById   @include(if: $content)
+            }
+
+            fragment imageGalleryField on ImageGallery {
+              images @include(if: $content) {
+                downloadUrl
+                caption
+                fileName
+                fileSize
+                uploadId @skip(if: $only_content)
+              }
+            }
+
+            fragment fileField on File {
+              required @skip(if: $only_content)
+              items    @include(if: $content) {
+                fileContainer { ...fileContainerAttrs }
+              }
+            }
+
+            fragment fileContainerAttrs on FileContainer {
+              id
+              activeFileAttachment {
+                downloadUrl
+                id @skip(if: $only_content)
+                fileSize
+                fileName
+                userName
+                fileUpdatedAt { dateTime }
+              }
+            }
+
+            fragment peopleField on People {
+              required     @skip(if: $only_content)
+              singular     @skip(if: $only_content)
+              attachMode
+              cachedPeople @include(if: $content) {
+                id
+                email
+                name
+                externalId
+                privateFields
+                publicFields
+              }
+              peopleIds @include(if: $content)
+              people    @include(if: $content) {
+                id
+                name
+                externalId
+                email
+              }
+            }
+
+            fragment contractorEntitiesField on ContractorEntities {
+              required @skip(if: $only_content)
+              contractorEntities(
+                includeDeleted: true
+              ) @include(if: $content) {
+                id
+                name
+                externalId
+                approved
+                active
+              }
+            }
+
+            fragment crossReferenceField on CrossReference {
+              required @skip(if: $only_content)
+              references(
+                first: 25
+              ) @include(if: $content) {
+                nodes    { ...referenceAttrs }
+                totalCount
+                pageInfo {
+                  hasNextPage
+                  endCursor
+                }
+              }
+            }
+
+            fragment referenceAttrs on Reference {
+              id
+              name
+              uid
+              state
+              locations { ...locationNode }
+              createdAt { dateTime        }
+              updatedAt { dateTime        }
+              creator   { name            }
+            }
+
+            fragment mailboxField on Mailbox {
+              address @skip(if: $only_content)
+              emails  @include(if: $content) {
+                nodes {
+                  subject
+                  body
+                  recipients
+                  cc
+                  bcc
+                  senderName
+                  senderEmail
+                  createdAt      { dateTime              }
+                  fileContainers { ...fileContainerAttrs }
+                }
+              }
+            }
+
+            fragment lawField on Law {
+              snippets @include(if: $content) {
+                category
+                content
+                legislation
+                product
+                title
+                topic
+                sources
+                updatedAt { dateTime }
+              }
+            }
+
+            fragment aiSummaryField on AiSummary {
+              alreadyRated
+              aiSummary
+              aiSummaryGeneratedAt { dateTime }
+              currentVersionId
+              triggerStageIds
+              textFormat
+              trigger
+              instructions @skip(if: $only_content)
+            }
+
+            fragment actionsListField on ActionsList {
+              required          @skip(if: $only_content)
+              requiredCompleted @skip(if: $only_content)
+              actions(
+                first:                   25,
+                includeRecurringActions: false
+              ) @include(if: $content) {
+                ...pageActionsList
+              }
+            }
+
+            fragment pageActionsList on DataFieldAssociatedActionsConnection {
+              nodes    { ...pageActionAttrs }
+              totalCount
+              pageInfo {
+                hasNextPage
+                endCursor
+              }
+              closedCount
+              openCount
+              overdueCount
+            }
+
+            fragment pageActionAttrs on Action {
+              id
+              name
+              description
+              assignedTo {
+                id
+                name
+                email
+              }
+              status
+              relativeStatus
+              age
+              createdAt       { dateTime }
+              completedAt     { dateTime }
+              dueDate         { dateTime }
+              dueOrClosedDate { dateTime }
+            }
+          GRAPHQL
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,15 @@
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        class Pages
+          include Ecoportal::API::GraphQL::Concerns::FragmentDefinitions
+        end
+
+        register_namespace Pages
+      end
+    end
+  end
+end
+
+require_relative 'pages/common_page_union'

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

@@ -0,0 +1,172 @@
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        SCHEMA_VERSION = '20260605'.freeze
+
+        fragment :PagesWorkflowFields, <<~GRAPHQL
+          fragment PagesWorkflowFields on PagesWorkflow {
+            autoPageCreationEnabled
+            fields {
+              key
+              name
+              type
+              total
+              missing
+              enableCrossRegisterReporting
+            }
+            stages {
+              id
+              name
+              ordering
+              state
+              active
+              started
+            }
+          }
+        GRAPHQL
+
+        fragment :PagesWorkflowCallbackFields, <<~GRAPHQL
+          fragment PagesWorkflowCallbackFields on PagesWorkflowCallbackType {
+            id
+            triggerCondition
+            triggers {
+              __typename
+              id
+              ... on PagesWorkflowTriggersConditionalLogic {
+                filters {
+                  id
+                  operation
+                  path
+                  key
+                  params
+                }
+              }
+            }
+            operations {
+              __typename
+              id
+              timeDelayPassed
+              timeDelayConfig {
+                enabled
+                frequencyValue
+                period
+                excludeWeekends
+              }
+              ... on PagesWorkflowOperationsAssignTo {
+                targetTaskType
+                lastFulfilled
+                escalationLevels {
+                  id
+                  order
+                  dueInValue
+                  dueInUnit
+                  dueExcludeWeekends
+                  elapsedSeconds
+                  timerPaused
+                }
+              }
+              ... on PagesWorkflowOperationsCreatePage {
+                templateId
+                crossReferenceFieldId
+              }
+              ... on PagesWorkflowOperationsSendNotification {
+                recurring
+                recurrenceActive
+                recurrenceEndType
+                recurrenceEndCount
+                emailConfig {
+                  enabled
+                  subject
+                  body
+                  attachPdf
+                  includeSmartSummary
+                  pdfRedacted
+                  sendAsGroupEmail
+                }
+                inSystemConfig {
+                  enabled
+                  title
+                  message
+                }
+                recipientConfig {
+                  allActiveUsers
+                  includePageCreator
+                  includePeopleFields
+                  includeTaskAssignees
+                  includeMailboxFields
+                  userSelections {
+                    id
+                    name
+                    email
+                    deleted
+                  }
+                  peopleFieldSelections {
+                    id
+                    name
+                    stageName
+                    deleted
+                  }
+                  taskConfigSelections {
+                    id
+                    type
+                    stageName
+                    deleted
+                  }
+                  mailboxFieldSelections {
+                    id
+                    name
+                    stageName
+                    deleted
+                  }
+                  actionTypeSelections {
+                    id
+                    name
+                    deleted
+                  }
+                }
+              }
+            }
+          }
+        GRAPHQL
+
+        fragment :PagesWorkflowCommandFields, <<~GRAPHQL
+          fragment PagesWorkflowCommandFields on PagesWorkflowCommandInterface {
+            __typename
+            id
+            commandAction
+            createdAt { dateTime }
+            patchVer
+            ownerId
+            stageId
+            stageName
+            taskId
+            taskType
+            ... on PagesWorkflowCommandChange {
+              changes {
+                field
+                from
+                to
+              }
+            }
+            ... on PagesWorkflowCommandChangeMessage {
+              changeMessages
+            }
+          }
+        GRAPHQL
+
+        # Stage-level fragment that adds workflowCallbacks to a Stage selection.
+        # Spread this on Stage (alongside or inside a page query) to populate
+        # stage.workflow_callbacks. Requires PagesWorkflowCallbackFields to be
+        # assembled in the same request.
+        fragment :StageWithCallbacksFields, <<~GRAPHQL
+          fragment StageWithCallbacksFields on Stage {
+            workflowCallbacks {
+              ...PagesWorkflowCallbackFields
+            }
+          }
+        GRAPHQL
+      end
+    end
+  end
+end

data/lib/ecoportal/api/graphql/fragment/pagination.rb

@@ -3,7 +3,7 @@ module Ecoportal
     class GraphQL
       class Fragment
         fragment :Pagination, <<~GRAPHQL
-          fragment on ActionConnection {
+          fragment Pagination on ActionConnection {
             totalCount
             pageInfo {
               endCursor

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

@@ -1,27 +1,37 @@
-# Namespace to create custom fragments from client scripts
-module Fragment
-  include Ecoportal::API::Common::GraphQL::ClassHelpers
-end
-
-# Class to define/parse fragments
-module Ecoportal
-  module API
-    class GraphQL
-      class Fragment
-        include Ecoportal::API::GraphQL::Concerns::FragmentDefinitions
-
-        def initialize(...)
-          super(...)
-        end
-      end
-    end
-  end
-end
-
-require_relative 'fragment/pagination'
-require_relative 'fragment/locations_error'
-require_relative 'fragment/location_node'
-require_relative 'fragment/location_draft'
-require_relative 'fragment/action_category'
-require_relative 'fragment/action'
-require_relative 'fragment/contractor_entity'
+# Namespace to create custom fragments from client scripts
+module Fragment
+  include Ecoportal::API::Common::GraphQL::ClassHelpers
+end
+
+# Class to define/parse fragments
+module Ecoportal
+  module API
+    class GraphQL
+      class Fragment
+        include Ecoportal::API::GraphQL::Concerns::FragmentDefinitions
+
+        def initialize(...)
+          super
+
+          pages
+        end
+
+        def pages
+          @pages ||= Pages.new(client)
+        end
+      end
+    end
+  end
+end
+
+require_relative 'fragment/pagination'
+require_relative 'fragment/locations_error'
+require_relative 'fragment/location_node'
+require_relative 'fragment/location_draft'
+require_relative 'fragment/action_category'
+require_relative 'fragment/action'
+require_relative 'fragment/contractor_entity'
+require_relative 'fragment/page'
+require_relative 'fragment/pages'
+require_relative 'fragment/force'
+require_relative 'fragment/pages_workflow'

data/lib/ecoportal/api/graphql/input/contractor_entity/update.rb

@@ -8,6 +8,31 @@ module Ecoportal
             class_resolver :id_diff_input, "Ecoportal::API::GraphQL::Input::IdDiff"
             embeds_one :associatedPeopleIds, klass: :id_diff_input
             embeds_one :leadContractorIds, klass: :id_diff_input
+
+            ID_DIFF_FIELDS = %i[associatedPeopleIds leadContractorIds].freeze
+
+            class << self
+              # Overrides Logic::Input.from_model to reshape array fields into
+              # IdDiffInput format: { additions: [...], removals: [...] }
+              # Array fields are stripped from the flat diff, so we compare
+              # doc vs original_doc directly rather than relying on the diff hash.
+              def from_model(model, **kargs)
+                diff = Logic::Input.from_model(model, **kargs)
+
+                ID_DIFF_FIELDS.each do |field|
+                  key      = field.to_s
+                  current  = Array(model.doc[key])
+                  original = Array(model.original_doc[key])
+                  next if current == original
+
+                  diff       ||= {}
+                  diff[:id]  ||= model.id
+                  diff[field]  = { additions: current - original, removals: original - current }
+                end
+
+                diff
+              end
+            end
           end
         end
       end

data/lib/ecoportal/api/graphql/input/delta_input.rb

@@ -0,0 +1,16 @@
+module Ecoportal
+  module API
+    class GraphQL
+      module Input
+        # Maps DeltaInput for the pageDelta query.
+        # Pass as an array: [{ id: 'pageId', deltaAt: 'ISO8601DateTime' }, ...]
+        # deltaAt: the last-known timestamp for this page ID.
+        # Server returns UPDATED if the page changed after deltaAt, NOT_FOUND if deleted, NEW if unknown.
+        class DeltaInput < Logic::Input
+          passkey :id
+          passthrough :deltaAt
+        end
+      end
+    end
+  end
+end