printavo-ruby 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c7c947ef3f0582fd5c30b1aa44f69cfdc2ba135ac4b5b616db3fc5c63615322
-  data.tar.gz: 664d2cafd355a83630af29c9902cf89dc2af838694cb91cc6ba182603d115a92
+  metadata.gz: 61a636be4f585024b3fab02968db29676052b9228c952c936ebcf67249349258
+  data.tar.gz: d12592575eaf1d5b9a88babc9dfc4bc86474222c54a9cc5c394e6e8c8b91143e
 SHA512:
-  metadata.gz: 7e321c541a352c6ae3983682c03406ca80725499d2014bcfcc6cda1f8f2a8654f4aba9dc25452c7da7225a993ef205f0d698b23f5dfd68396b0f6add13070f27
-  data.tar.gz: 3182ba400910bc9de615ce19944bbac0b027b80874e35a364e2c64c476d383e86bbed46b501cd0d602dd06c49aa3a20b242f7d510261c734c56649301475e301
+  metadata.gz: 6aa7d1e5b343728409ca0b3082c9ec9480865b69ecb5db3713cade7c9db897bf2d3bc02571eca4e1a31e4e7f98763955482726c426923f1692d380d972f0e511
+  data.tar.gz: 5a14a8ec04f1e8bff553540135077564d9c0e21c58c5e39a93454d70ef36a14512b2b2e75eacd0b068876ad5ca4491c70653b82c45ed205c9e59cd5c94ee49f8

data/docs/CHANGELOG.md

@@ -6,6 +6,23 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.11.0] - 2026-03-31
+
+### Added
+- `Printavo::ApprovalRequest` model (`id`, `status`, `sent_at`, `expires_at`, `contact` — returns `Printavo::Contact`)
+- `ApprovalRequests` resource: `all(order_id:)`, `find(id)`, `create(**input)`,
+  `approve(id)`, `revoke(id)`, `unapprove(id)` — action mutations return updated `ApprovalRequest`
+- `Printavo::PresetTask` model (`id`, `body`, `due_offset_days`, `assignee`)
+- `PresetTasks` resource: `find(id)`, `create(**input)`, `update(id, **input)`, `delete(id)` —
+  no standalone listing; preset tasks are accessed via `PresetTaskGroup#tasks`
+- `Printavo::PresetTaskGroup` model (`id`, `name`, `tasks` — returns `[PresetTask]`)
+- `PresetTaskGroups` resource: `all`, `find(id)`, `create(**input)`, `update(id, **input)`,
+  `delete(id)`, `apply(id, order_id:)` — `apply` returns `[Printavo::Task]` (live tasks created on the order)
+- `client.approval_requests`, `client.preset_task_groups`, `client.preset_tasks`
+  entry points on `Printavo::Client`
+- 16 new `.graphql` files under `lib/printavo/graphql/`
+- 2 new factory files: `spec/support/factories/approval_request.rb`, `spec/support/factories/preset_task.rb`
+
 ## [0.10.0] - 2026-03-31
 
 ### Added

data/docs/TODO.md

@@ -147,14 +147,14 @@ return values — they are exposed via model field accessors, not separate resou
 
 ---
 
-### Approvals
+### Approvals ✅
 
-- [ ] `Printavo::ApprovalRequest` model (`id`, `status`, `sentAt`, `expiresAt`, `contact`)
-- [ ] `ApprovalRequests` resource: `all(order_id:)`, `find(id)`
-- [ ] `approvalRequestCreate` mutation
-- [ ] `approvalRequestApprove(id:)` mutation
-- [ ] `approvalRequestRevoke(id:)` mutation
-- [ ] `approvalRequestUnapprove(id:)` mutation
+- [x] `Printavo::ApprovalRequest` model (`id`, `status`, `sent_at`, `expires_at`, `contact`)
+- [x] `ApprovalRequests` resource: `all(order_id:)`, `find(id)`
+- [x] `approvalRequestCreate` mutation
+- [x] `approvalRequestApprove(id:)` mutation
+- [x] `approvalRequestRevoke(id:)` mutation
+- [x] `approvalRequestUnapprove(id:)` mutation
 
 ### Categories ✅
 
@@ -254,15 +254,15 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `PaymentTerms` resource: `all`, `find(id)`, `create`, `update`, `archive`
 - [x] `paymentTermCreate`, `paymentTermUpdate`, `paymentTermArchive` mutations
 
-### Preset Tasks
+### Preset Tasks ✅
 
-- [ ] `Printavo::PresetTask` model (`id`, `body`, `dueOffsetDays`, `assignee`)
-- [ ] `Printavo::PresetTaskGroup` model (`id`, `name`, `tasks`)
-- [ ] `PresetTasks` resource: `find(id)`, `create`, `update`, `delete`
-- [ ] `presetTaskCreate`, `presetTaskUpdate`, `presetTaskDelete` mutations
-- [ ] `PresetTaskGroups` resource: `all`, `find(id)`, `create`, `update`, `delete`, `apply`
-- [ ] `presetTaskGroupCreate`, `presetTaskGroupUpdate`, `presetTaskGroupDelete` mutations
-- [ ] `presetTaskGroupApply(id:, order_id:)` mutation — applies a group to an order
+- [x] `Printavo::PresetTask` model (`id`, `body`, `due_offset_days`, `assignee`)
+- [x] `Printavo::PresetTaskGroup` model (`id`, `name`, `tasks`)
+- [x] `PresetTasks` resource: `find(id)`, `create`, `update`, `delete`
+- [x] `presetTaskCreate`, `presetTaskUpdate`, `presetTaskDelete` mutations
+- [x] `PresetTaskGroups` resource: `all`, `find(id)`, `create`, `update`, `delete`, `apply`
+- [x] `presetTaskGroupCreate`, `presetTaskGroupUpdate`, `presetTaskGroupDelete` mutations
+- [x] `presetTaskGroupApply(id:, order_id:)` mutation — applies a group to an order
 
 ### Product Catalog & Pricing ✅
 
@@ -343,11 +343,11 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `PaymentRequests` resource (`all`, `find`, `create`, `delete`)
 - [x] `PaymentTerms` resource (`all`, `find`, `create`, `update`, `archive`)
 
-### v0.11.0 — Workflow: Approvals & Preset Tasks
+### v0.11.0 — Workflow: Approvals & Preset Tasks ✅
 
-- [ ] `ApprovalRequests` resource (`all`, `find`, `create`, `approve`, `revoke`, `unapprove`)
-- [ ] `PresetTasks` resource (`find`, `create`, `update`, `delete`)
-- [ ] `PresetTaskGroups` resource (`all`, `find`, `create`, `update`, `delete`, `apply`)
+- [x] `ApprovalRequests` resource (`all`, `find`, `create`, `approve`, `revoke`, `unapprove`)
+- [x] `PresetTasks` resource (`find`, `create`, `update`, `delete`)
+- [x] `PresetTaskGroups` resource (`all`, `find`, `create`, `update`, `delete`, `apply`)
 
 ### v0.12.0 — Files, Media & Communication
 

data/lib/printavo/client.rb

@@ -29,6 +29,10 @@ module Printavo
       Resources::Account.new(@graphql)
     end
 
+    def approval_requests
+      Resources::ApprovalRequests.new(@graphql)
+    end
+
     def categories
       Resources::Categories.new(@graphql)
     end
@@ -109,6 +113,14 @@ module Printavo
       Resources::Payments.new(@graphql)
     end
 
+    def preset_task_groups
+      Resources::PresetTaskGroups.new(@graphql)
+    end
+
+    def preset_tasks
+      Resources::PresetTasks.new(@graphql)
+    end
+
     def pricing_matrices
       Resources::PricingMatrices.new(@graphql)
     end

data/lib/printavo/models/approval_request.rb

@@ -0,0 +1,12 @@
+# lib/printavo/models/approval_request.rb
+# frozen_string_literal: true
+
+module Printavo
+  class ApprovalRequest < Models::Base
+    def id         = self['id']
+    def status     = self['status']
+    def sent_at    = self['sentAt']
+    def expires_at = self['expiresAt']
+    def contact    = self['contact'] && Contact.new(self['contact'])
+  end
+end

data/lib/printavo/models/preset_task.rb

@@ -0,0 +1,11 @@
+# lib/printavo/models/preset_task.rb
+# frozen_string_literal: true
+
+module Printavo
+  class PresetTask < Models::Base
+    def id              = self['id']
+    def body            = self['body']
+    def due_offset_days = self['dueOffsetDays']
+    def assignee        = self['assignee']
+  end
+end

data/lib/printavo/models/preset_task_group.rb

@@ -0,0 +1,10 @@
+# lib/printavo/models/preset_task_group.rb
+# frozen_string_literal: true
+
+module Printavo
+  class PresetTaskGroup < Models::Base
+    def id    = self['id']
+    def name  = self['name']
+    def tasks = Array(self['tasks']).map { |attrs| PresetTask.new(attrs) }
+  end
+end

data/lib/printavo/resources/approval_requests.rb

@@ -0,0 +1,60 @@
+# lib/printavo/resources/approval_requests.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class ApprovalRequests < Base
+      ALL_QUERY          = File.read(File.join(__dir__, '../graphql/approval_requests/all.graphql')).freeze
+      FIND_QUERY         = File.read(File.join(__dir__, '../graphql/approval_requests/find.graphql')).freeze
+      CREATE_MUTATION    = File.read(File.join(__dir__, '../graphql/approval_requests/create.graphql')).freeze
+      APPROVE_MUTATION   = File.read(File.join(__dir__, '../graphql/approval_requests/approve.graphql')).freeze
+      REVOKE_MUTATION    = File.read(File.join(__dir__, '../graphql/approval_requests/revoke.graphql')).freeze
+      UNAPPROVE_MUTATION = File.read(File.join(__dir__, '../graphql/approval_requests/unapprove.graphql')).freeze
+
+      def all(order_id:, first: 25, after: nil)
+        fetch_page(order_id: order_id, first: first, after: after).records
+      end
+
+      def find(id)
+        data = @graphql.query(FIND_QUERY, variables: { id: id.to_s })
+        Printavo::ApprovalRequest.new(data['approvalRequest'])
+      end
+
+      def create(**input)
+        data = @graphql.mutate(CREATE_MUTATION, variables: { input: camelize_keys(input) })
+        Printavo::ApprovalRequest.new(data['approvalRequestCreate'])
+      end
+
+      def approve(id)
+        data = @graphql.mutate(APPROVE_MUTATION, variables: { id: id.to_s })
+        Printavo::ApprovalRequest.new(data['approvalRequestApprove'])
+      end
+
+      def revoke(id)
+        data = @graphql.mutate(REVOKE_MUTATION, variables: { id: id.to_s })
+        Printavo::ApprovalRequest.new(data['approvalRequestRevoke'])
+      end
+
+      def unapprove(id)
+        data = @graphql.mutate(UNAPPROVE_MUTATION, variables: { id: id.to_s })
+        Printavo::ApprovalRequest.new(data['approvalRequestUnapprove'])
+      end
+
+      private
+
+      def fetch_page(order_id:, first: 25, after: nil, **)
+        data = @graphql.query(
+          ALL_QUERY,
+          variables: { orderId: order_id.to_s, first: first, after: after }
+        )
+        nodes     = data['order']['approvalRequests']['nodes'].map { |attrs| Printavo::ApprovalRequest.new(attrs) }
+        page_info = data['order']['approvalRequests']['pageInfo']
+        Printavo::Page.new(
+          records: nodes,
+          has_next_page: page_info['hasNextPage'],
+          end_cursor: page_info['endCursor']
+        )
+      end
+    end
+  end
+end

data/lib/printavo/resources/preset_task_groups.rb

@@ -0,0 +1,57 @@
+# lib/printavo/resources/preset_task_groups.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class PresetTaskGroups < Base
+      ALL_QUERY       = File.read(File.join(__dir__, '../graphql/preset_task_groups/all.graphql')).freeze
+      FIND_QUERY      = File.read(File.join(__dir__, '../graphql/preset_task_groups/find.graphql')).freeze
+      CREATE_MUTATION = File.read(File.join(__dir__, '../graphql/preset_task_groups/create.graphql')).freeze
+      UPDATE_MUTATION = File.read(File.join(__dir__, '../graphql/preset_task_groups/update.graphql')).freeze
+      DELETE_MUTATION = File.read(File.join(__dir__, '../graphql/preset_task_groups/delete.graphql')).freeze
+      APPLY_MUTATION  = File.read(File.join(__dir__, '../graphql/preset_task_groups/apply.graphql')).freeze
+
+      def all(first: 25, after: nil)
+        fetch_page(first: first, after: after).records
+      end
+
+      def find(id)
+        data = @graphql.query(FIND_QUERY, variables: { id: id.to_s })
+        Printavo::PresetTaskGroup.new(data['presetTaskGroup'])
+      end
+
+      def create(**input)
+        data = @graphql.mutate(CREATE_MUTATION, variables: { input: camelize_keys(input) })
+        Printavo::PresetTaskGroup.new(data['presetTaskGroupCreate'])
+      end
+
+      def update(id, **input)
+        data = @graphql.mutate(UPDATE_MUTATION, variables: { id: id.to_s, input: camelize_keys(input) })
+        Printavo::PresetTaskGroup.new(data['presetTaskGroupUpdate'])
+      end
+
+      def delete(id)
+        @graphql.mutate(DELETE_MUTATION, variables: { id: id.to_s })
+        nil
+      end
+
+      def apply(id, order_id:)
+        data = @graphql.mutate(APPLY_MUTATION, variables: { id: id.to_s, orderId: order_id.to_s })
+        data['presetTaskGroupApply'].map { |attrs| Printavo::Task.new(attrs) }
+      end
+
+      private
+
+      def fetch_page(first: 25, after: nil, **)
+        data = @graphql.query(ALL_QUERY, variables: { first: first, after: after })
+        nodes     = data['presetTaskGroups']['nodes'].map { |attrs| Printavo::PresetTaskGroup.new(attrs) }
+        page_info = data['presetTaskGroups']['pageInfo']
+        Printavo::Page.new(
+          records: nodes,
+          has_next_page: page_info['hasNextPage'],
+          end_cursor: page_info['endCursor']
+        )
+      end
+    end
+  end
+end

data/lib/printavo/resources/preset_tasks.rb

@@ -0,0 +1,33 @@
+# lib/printavo/resources/preset_tasks.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class PresetTasks < Base
+      FIND_QUERY      = File.read(File.join(__dir__, '../graphql/preset_tasks/find.graphql')).freeze
+      CREATE_MUTATION = File.read(File.join(__dir__, '../graphql/preset_tasks/create.graphql')).freeze
+      UPDATE_MUTATION = File.read(File.join(__dir__, '../graphql/preset_tasks/update.graphql')).freeze
+      DELETE_MUTATION = File.read(File.join(__dir__, '../graphql/preset_tasks/delete.graphql')).freeze
+
+      def find(id)
+        data = @graphql.query(FIND_QUERY, variables: { id: id.to_s })
+        Printavo::PresetTask.new(data['presetTask'])
+      end
+
+      def create(**input)
+        data = @graphql.mutate(CREATE_MUTATION, variables: { input: camelize_keys(input) })
+        Printavo::PresetTask.new(data['presetTaskCreate'])
+      end
+
+      def update(id, **input)
+        data = @graphql.mutate(UPDATE_MUTATION, variables: { id: id.to_s, input: camelize_keys(input) })
+        Printavo::PresetTask.new(data['presetTaskUpdate'])
+      end
+
+      def delete(id)
+        @graphql.mutate(DELETE_MUTATION, variables: { id: id.to_s })
+        nil
+      end
+    end
+  end
+end

data/lib/printavo/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module Printavo
-  VERSION = '0.10.0'
+  VERSION = '0.11.0'
 end

data/lib/printavo.rb

@@ -13,6 +13,7 @@ require_relative 'printavo/graphql_client'
 require_relative 'printavo/page'
 require_relative 'printavo/models/base'
 require_relative 'printavo/models/account'
+require_relative 'printavo/models/approval_request'
 require_relative 'printavo/models/category'
 require_relative 'printavo/models/contact'
 require_relative 'printavo/models/customer'
@@ -30,6 +31,8 @@ require_relative 'printavo/models/order'
 require_relative 'printavo/models/payment'
 require_relative 'printavo/models/payment_request'
 require_relative 'printavo/models/payment_term'
+require_relative 'printavo/models/preset_task'
+require_relative 'printavo/models/preset_task_group'
 require_relative 'printavo/models/pricing_matrix'
 require_relative 'printavo/models/product'
 require_relative 'printavo/models/status'
@@ -39,6 +42,7 @@ require_relative 'printavo/models/transaction'
 require_relative 'printavo/models/transaction_payment'
 require_relative 'printavo/resources/base'
 require_relative 'printavo/resources/account'
+require_relative 'printavo/resources/approval_requests'
 require_relative 'printavo/resources/categories'
 require_relative 'printavo/resources/contacts'
 require_relative 'printavo/resources/customers'
@@ -56,6 +60,8 @@ require_relative 'printavo/resources/orders'
 require_relative 'printavo/resources/payment_requests'
 require_relative 'printavo/resources/payment_terms'
 require_relative 'printavo/resources/payments'
+require_relative 'printavo/resources/preset_task_groups'
+require_relative 'printavo/resources/preset_tasks'
 require_relative 'printavo/resources/pricing_matrices'
 require_relative 'printavo/resources/products'
 require_relative 'printavo/resources/statuses'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: printavo-ruby
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Stan Carver II
@@ -273,6 +273,7 @@ files:
 - lib/printavo/errors.rb
 - lib/printavo/graphql_client.rb
 - lib/printavo/models/account.rb
+- lib/printavo/models/approval_request.rb
 - lib/printavo/models/base.rb
 - lib/printavo/models/category.rb
 - lib/printavo/models/contact.rb
@@ -291,6 +292,8 @@ files:
 - lib/printavo/models/payment.rb
 - lib/printavo/models/payment_request.rb
 - lib/printavo/models/payment_term.rb
+- lib/printavo/models/preset_task.rb
+- lib/printavo/models/preset_task_group.rb
 - lib/printavo/models/pricing_matrix.rb
 - lib/printavo/models/product.rb
 - lib/printavo/models/status.rb
@@ -300,6 +303,7 @@ files:
 - lib/printavo/models/transaction_payment.rb
 - lib/printavo/page.rb
 - lib/printavo/resources/account.rb
+- lib/printavo/resources/approval_requests.rb
 - lib/printavo/resources/base.rb
 - lib/printavo/resources/categories.rb
 - lib/printavo/resources/contacts.rb
@@ -318,6 +322,8 @@ files:
 - lib/printavo/resources/payment_requests.rb
 - lib/printavo/resources/payment_terms.rb
 - lib/printavo/resources/payments.rb
+- lib/printavo/resources/preset_task_groups.rb
+- lib/printavo/resources/preset_tasks.rb
 - lib/printavo/resources/pricing_matrices.rb
 - lib/printavo/resources/products.rb
 - lib/printavo/resources/statuses.rb