ecoportal-api-graphql 1.3.16 → 2.2.0

data/lib/ecoportal/api/graphql/builder/CLAUDE.md

@@ -1,65 +0,0 @@
-# builder
-
-Façade classes that group related mutations (and occasional queries) under a single object.
-Consumers interact with builders rather than instantiating `Logic::Mutation` / `Logic::Query`
-subclasses directly.
-
-## Contents
-
-| File / class | Exposed from `GraphQL` as | Purpose |
-|---|---|---|
-| `action.rb` / `Builder::Action` | `GraphQL#action` | `create`, `update`, `archive` — wraps `Mutation::Action::*` |
-| `contractor_entity.rb` / `Builder::ContractorEntity` | `GraphQL#contractorEntity` | `create`, `update`, `destroy` — wraps `Mutation::ContractorEntity::*` |
-| `location_structure.rb` / `Builder::LocationStructure` | `GraphQL#locationStructure` | `nodeClassifications` (query), `applyCommandsInput`, `applyCommands`, `draft` sub-builder |
-| `location_structure/draft.rb` / `Builder::LocationStructure::Draft` | via `locationStructure.draft` | Location structure draft mutations |
-| `page.rb` / `Builder::Page` | `GraphQL#page` | Full page lifecycle: `update`, `archive`, `unarchive`, `build_from_template`, `create_from_template`, `create_draft`, `delete_draft`, `publish_draft`, `approve/reject/restart/undo/batch_update_review_task`, `execute_workflow_commands` (new), `execute_force_commands` (deprecated) |
-| `register.rb` / `Builder::Register` | *(not yet exposed)* | **Stub** — all methods commented out. No `Mutation::Register::*` classes exist yet. See TODO below. |
-
-## How builders are exposed
-
-All active builders are wired in `lib/ecoportal/api/graphql.rb` as instance methods:
-
-```ruby
-def page
-  Builder::Page.new(client)
-end
-def action
-  Builder::Action.new(client)
-end
-# etc.
-```
-
-`registers` (note: plural, lowercase) returns `Compat::Registers`, **not** `Builder::Register`.
-`Builder::Register` is a stub and is not yet wired into the top-level class.
-
-## Builder::Register — TODO
-
-`builder/register.rb` contains a stub class with all methods commented out.
-Before it can be implemented:
-
-1. Research which Register mutations exist in the schema (`createRegister`,
-   `updateRegister`, `archiveRegister`, etc.) — none are currently documented
-   in `.ai-assistance/code/ecoportal_schema_reference.md`.
-2. Create `Mutation::Register::*` + `Input::Register::*` + `Payload::Register::*`
-   following the pattern of `Mutation::Page::*`.
-3. Expose `Builder::Register` from `GraphQL#register` (distinct from `#registers`
-   which is the compat search layer).
-
-Until then, register mutation callers must instantiate `Mutation::Register::*` directly
-(none exist yet), or use `Compat::Registers` for search.
-
-## Conventions
-
-- One builder per domain entity. Sub-builders (e.g. `LocationStructure::Draft`) are
-  nested under their parent builder's folder and exposed via a method on the parent.
-- Builder methods are snake_case public API; private helper methods are camelCase
-  (matching the existing convention: `updateMutation`, `archiveMutation`, etc.).
-- Builders never hold state — each method instantiates a fresh mutation/query object.
-- Builders do not implement pagination; callers use `QueryConnection#each` for that.
-
-## Related
-
-- `../mutation/` — concrete mutation classes that builders delegate to
-- `../query/` — concrete query classes (some builders also expose query shortcuts)
-- `../compat/` — v2-compatible layer (`Compat::Pages`, `Compat::Registers`) that
-  wraps builders + queries with an eco-helpers-compatible interface

data/lib/ecoportal/api/graphql/input/workflow_command/edit_page.rb

@@ -1,28 +0,0 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Input
-        class WorkflowCommand
-          module EditPage
-            SCHEMA_VERSION = '20260605'.freeze
-            VALID_KEYS = %i[
-              name icon themeId timeZone disableDirectPermissions mobileEnabled useSectionsOnMobile
-              showStrategyForRestrictedStages showAssigneeNamesForRestrictedStages showTaskDueDateForRestrictedStages
-              hideActivityStream disableComments enableDashboardImport enableActionsOnFields showCreator active
-              counterPrefix counterPostfix counterEnabled counter
-              addLocationIds removeLocationIds
-              addBaseTags removeBaseTags
-              addOtherTags removeOtherTags
-              addFolders removeFolders
-              creatorEnabled creatorEditable creatorFlags
-            ].freeze
-
-            def self.build(**kwargs)
-              kwargs.slice(*VALID_KEYS).compact
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/ecoportal/api/graphql/mutation/smart_fill/generate.rb

@@ -1,36 +0,0 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module SmartFill
-          # Enqueue AI generation for a SmartFill data field on a page.
-          # Returns ok: true immediately — generation is asynchronous.
-          # Poll the SmartFill field's status on the page to know when done.
-          class Generate < Logic::Mutation
-            field_name :smartFillGenerate
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::OkPayload'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(pageId: :id!, dataFieldId: :id!) {
-                  smartFillGenerate(pageId: :pageId, dataFieldId: :dataFieldId, &payload_block)
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                ok
-                errors { details fullMessages }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/ecoportal/api/graphql/mutation/smart_fill/submit_feedback.rb

@@ -1,40 +0,0 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module SmartFill
-          # Submit a rating on a SmartFill generation.
-          # value: "THUMBS_UP" | "THUMBS_DOWN" (BinaryRatingEnum)
-          class SubmitFeedback < Logic::Mutation
-            field_name :smartFillSubmitFeedback
-
-            class_resolver :payload_class, 'Ecoportal::API::GraphQL::Payload::OkPayload'
-
-            private
-
-            def basic_block(&block)
-              payload_block = block || default_payload_block
-              proc {
-                mutation(pageId: :id!, dataFieldId: :id!, value: :BinaryRatingEnum!) {
-                  smartFillSubmitFeedback(
-                    pageId:      :pageId,
-                    dataFieldId: :dataFieldId,
-                    value:       :value,
-                    &payload_block
-                  )
-                }
-              }
-            end
-
-            def default_payload_block
-              proc {
-                ok
-                errors { details fullMessages }
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/ecoportal/api/graphql/mutation/smart_fill.rb

@@ -1,13 +0,0 @@
-module Ecoportal
-  module API
-    class GraphQL
-      module Mutation
-        module SmartFill
-        end
-      end
-    end
-  end
-end
-
-require_relative 'smart_fill/generate'
-require_relative 'smart_fill/submit_feedback'