printavo-ruby 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3563777c538165a00ca4888be9d489c6a0e9b14542dac6d02a18b60894826f7d
-  data.tar.gz: ceb47bf69ff0dc7f48888d4fee3f601aa621015f8028e6dd0af31e2037b36749
+  metadata.gz: 4f1b8022189ac0b62b87b7d9770c08b3f2320c6804705c41afd6e2b03c7239ca
+  data.tar.gz: 94761c4186f08d33b841eb9d364350f142c5b7b007d0f1fce2c08e7e237156d8
 SHA512:
-  metadata.gz: b266887065b5f727b6f9660557ce37d7ab64b53f23033f5c64c678cae919f00cd21e169fee17177bce7e873fdcc9d978307a3254e20de0224aab4b8e9c462d97
-  data.tar.gz: 4d1c944ca7283bab4e45dfe3cde0ddc6acf3ea35a167ee7b49574b6f7e367fff77a833253976605e2f8219aea932d5056b04004fcb55553cd4975bdfe853b3fe
+  metadata.gz: 5c22e476b535a7eebe9fba9a51ed5a36016a6da07c3f8f4e5cce478d609ee358316097f06bab770ebcdb3ec2cd43b0b5939bdc109394237691b0a4f8370cd6b4
+  data.tar.gz: 266b1fd4d0e738ca3928225681367371f6e3dc7ac26a1771e8758ff2ea6cac6adc40130e57bf7553d043a99fb2a464c1c0d609489c6f6ae83fde1568821ba716

data/docs/CHANGELOG.md

@@ -6,6 +6,27 @@ 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.7.0] - 2026-03-30
+
+### Added
+- `Printavo::Transaction` model (`id`, `amount`, `kind`, `created_at`)
+- `Transactions` resource: `all(order_id:)`, `find(id)` — scoped to an order, same pattern as Jobs
+- `Printavo::TransactionPayment` model (`id`, `amount`, `payment_method`, `paid_at`, `note`)
+- `TransactionPayments` resource: `create(**input)`, `update(id, **input)`, `delete(id)` —
+  mutation-only; `transactionPaymentCreate/Update/Delete`
+- `Printavo::Task` model (`id`, `body`, `due_at`, `completed_at`, `completed?`, `assignee`)
+- `Tasks` resource: `all`, `find(id)`, `create(**input)`, `update(id, **input)`,
+  `complete(id)` (sets `completedAt` to now via `taskUpdate`), `delete(id)`
+- `Printavo::Thread` model (`id`, `subject`, `created_at`, `updated_at`)
+- `Threads` resource: `all(order_id:)`, `find(id)`, `update(id, **input)`,
+  `email_message_create(**input)` — `threadUpdate` + `emailMessageCreate` mutations;
+  returns raw hash (no `EmailMessage` model yet)
+- `client.tasks`, `client.threads`, `client.transactions`, `client.transaction_payments`
+  entry points on `Printavo::Client`
+- 14 new `.graphql` files under `lib/printavo/graphql/`
+- `Client#login` / `Client#logout` raise `NotImplementedError` with a message directing
+  consumers to the `email` + `token` initializer; gem uses stateless header-based auth
+
 ## [0.6.0] - 2026-03-30
 
 ### Added

data/docs/TODO.md

@@ -21,6 +21,7 @@ Full task list for `printavo-ruby` across all versions. Checked items are shippe
 - [x] GitHub Actions CI: Ruby 3.3 + Ruby 4.0 matrix
 - [x] Automated RubyGems publish on `v*` tag via trusted publishing (`release.yml`)
 - [x] Git pre-push hook: guards `Gemfile.lock` version sync and `x86_64-linux` platform
+- [x] `Client#login` / `Client#logout` — raise `NotImplementedError`; gem uses header-based auth, not session mutations
 
 ---
 
@@ -51,6 +52,13 @@ Full task list for `printavo-ruby` across all versions. Checked items are shippe
 - [x] `Inquiries#update(id, **input)` — `inquiryUpdate`
 - [x] `camelize_keys` — snake_case → camelCase input conversion
 - [x] `build_customer` / `build_order` — mutation response normalization helpers
+- [ ] `Contacts#delete(id)` — `contactDelete`
+- [ ] `Customers#delete(id)` — `customerDelete`
+- [ ] `Inquiries#delete(id)` — `inquiryDelete`
+- [ ] `Invoices#delete(id)` — `invoiceDelete`
+- [ ] `Invoices#duplicate(id)` — `invoiceDuplicate`
+- [ ] `Orders#delete(id)` — `quoteDelete`
+- [ ] `Orders#duplicate(id)` — `quoteDuplicate`
 
 ---
 
@@ -100,7 +108,9 @@ return values — they are exposed via model field accessors, not separate resou
 - `EmailMessage`, `TextMessage` — message subtypes under `Thread`
 - `Feature`, `FeatureRestriction` — embedded in `Account.features`
 - `LineItemEnabledColumns`, `LineItemGroupSize`, `LineItemPriceReceipt`, `LineItemSizeCount` — embedded in `LineItemGroup` / `LineItem`
-- `LoggedIn` — auth response type
+- `LoggedIn` — auth response type for `login` / `logout` mutations; not wrapped — gem uses
+  header-based auth. Both methods raise `NotImplementedError` on `Printavo::Client` with a
+  message directing consumers to the `email` + `token` initializer pattern.
 - `MerchOrderDelivery`, `MerchStoreSummary` — embedded in `MerchOrder` / `MerchStore`
 - `MessageAttachment` — embedded in `Thread` messages
 - `ObjectTimestamps` — `createdAt` / `updatedAt` on all objects
@@ -135,12 +145,16 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `Invoices` resource: `all`, `find(id)`, `update`
 - [x] `client.invoices` entry point on `Printavo::Client`
 
+---
+
 ### Approvals
 
-- [ ] `Printavo::Approval` model (`id`, `status`, `approvedAt`, `contact`)
-- [ ] `Printavo::ApprovalRequest` model (`id`, `sentAt`, `expiresAt`, `approval`)
-- [ ] `Approvals` resource: `all(order_id:)`, `find(id)`
-- [ ] `approvalCreate`, `approvalUpdate` mutations
+- [ ] `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
 
 ### Categories
 
@@ -152,18 +166,19 @@ return values — they are exposed via model field accessors, not separate resou
 - [ ] `Printavo::ContractorProfile` model (`id`, `name`, `email`)
 - [ ] `ContractorProfiles` resource: `all`, `find(id)` — contractors assignable to invoices
 
-### Delivery Methods
+### Custom Addresses
 
-- [ ] `Printavo::DeliveryMethod` model (`id`, `name`)
-- [ ] `DeliveryMethods` resource: `all` — reference data (pickup, ship, etc.)
+- [ ] `Printavo::CustomAddress` model (`id`, `name`, `address`, `city`, `state`, `zip`)
+- [ ] `CustomAddresses` resource: `all(order_id:)`, `find(id)`, `create`, `update`, `delete`
+- [ ] `customAddressCreate` / `customAddressCreates` (bulk) mutations
+- [ ] `customAddressUpdate` / `customAddressUpdates` (bulk) mutations
+- [ ] `customAddressDelete` / `customAddressDeletes` (bulk) mutations
 
-### Delete Mutations
+### Delivery Methods
 
-- [ ] `contactDelete(id:)`
-- [ ] `customerDelete(id:)`
-- [ ] `quoteDelete(id:)` / `invoiceDelete(id:)`
-- [ ] `lineItemDelete(id:)`
-- [ ] `taskDelete(id:)`
+- [ ] `Printavo::DeliveryMethod` model (`id`, `name`)
+- [ ] `DeliveryMethods` resource: `all`, `find(id)`, `create`, `update`, `archive`
+- [ ] `deliveryMethodCreate`, `deliveryMethodUpdate`, `deliveryMethodArchive` mutations
 
 ### Email Templates
 
@@ -179,20 +194,36 @@ return values — they are exposed via model field accessors, not separate resou
 ### Fees
 
 - [ ] `Printavo::Fee` model (`id`, `name`, `amount`, `taxable`)
-- [ ] `Fees` resource: `all(order_id:)`, `find(id)`, `create`, `update`
-- [ ] `feeCreate`, `feeUpdate` mutations
+- [ ] `Fees` resource: `all(order_id:)`, `find(id)`, `create`, `update`, `delete`
+- [ ] `feeCreate` / `feeCreates` (bulk) mutations
+- [ ] `feeUpdate` / `feeUpdates` (bulk) mutations
+- [ ] `feeDelete` / `feeDeletes` (bulk) mutations
 
 ### Imprints
 
 - [ ] `Printavo::Imprint` model (`id`, `name`, `position`, `colors`, `personalization`)
-- [ ] `Imprints` resource: `all(line_item_group_id:)`, `find(id)`, `create`, `update`
-- [ ] `imprintCreate`, `imprintUpdate` mutations
+- [ ] `Imprints` resource: `all(line_item_group_id:)`, `find(id)`, `create`, `update`, `delete`
+- [ ] `imprintCreate` / `imprintCreates` (bulk) mutations
+- [ ] `imprintUpdate` / `imprintUpdates` (bulk) mutations
+- [ ] `imprintDelete` / `imprintDeletes` (bulk) mutations
+- [ ] `imprintMockupCreate` / `imprintMockupCreates` (bulk) — attach mockup to imprint
+
+### Line Items
+
+- [ ] `Printavo::LineItem` model (`id`, `name`, `quantity`, `price`, `taxable`)
+- [ ] `LineItems` resource: `all(line_item_group_id:)`, `find(id)`, `create`, `update`, `delete`
+- [ ] `lineItemCreate` / `lineItemCreates` (bulk) mutations
+- [ ] `lineItemUpdate` / `lineItemUpdates` (bulk) mutations
+- [ ] `lineItemDelete` / `lineItemDeletes` (bulk) mutations
+- [ ] `lineItemMockupCreate` / `lineItemMockupCreates` (bulk) — attach mockup to line item
 
 ### Line Item Groups
 
 - [ ] `Printavo::LineItemGroup` model (`id`, `name`, `description`, `sizes`, `enabled_columns`)
-- [ ] `LineItemGroups` resource: `all(order_id:)`, `find(id)`, `create`, `update`
-- [ ] `lineItemGroupCreate`, `lineItemGroupUpdate` mutations
+- [ ] `LineItemGroups` resource: `all(order_id:)`, `find(id)`, `create`, `update`, `delete`
+- [ ] `lineItemGroupCreate` / `lineItemGroupCreates` (bulk) mutations
+- [ ] `lineItemGroupUpdate` / `lineItemGroupUpdates` (bulk) mutations
+- [ ] `lineItemGroupDelete` / `lineItemGroupDeletes` (bulk) mutations
 
 ### Merch
 
@@ -206,26 +237,32 @@ return values — they are exposed via model field accessors, not separate resou
 
 - [ ] `Printavo::Mockup` model (`id`, `url`, `position`, `createdAt`)
 - [ ] `Printavo::ProductionFile` model (`id`, `url`, `filename`, `createdAt`)
-- [ ] `Mockups` resource: `all(order_id:)`, `find(id)`, `create`
-- [ ] `ProductionFiles` resource: `all(order_id:)`, `find(id)`, `create`
+- [ ] `Mockups` resource: `all(order_id:)`, `find(id)`, `delete`
+- [ ] `mockupDelete` / `mockupDeletes` (bulk) mutations
+- [ ] `ProductionFiles` resource: `all(order_id:)`, `find(id)`, `create`, `delete`
+- [ ] `productionFileCreate` / `productionFileCreates` (bulk) mutations
+- [ ] `productionFileDelete` / `productionFileDeletes` (bulk) mutations
 
 ### Payments
 
 - [ ] `Printavo::Payment` model (`id`, `amount`, `method`, `paidAt`)
-- [ ] `Printavo::PaymentDispute` model (`id`, `amount`, `reason`, `status`)
 - [ ] `Printavo::PaymentRequest` model (`id`, `amount`, `sentAt`, `paidAt`, `details`)
-- [ ] `Printavo::PaymentTerm` model (`id`, `name`, `netDays`) — reference data
+- [ ] `Printavo::PaymentTerm` model (`id`, `name`, `netDays`)
 - [ ] `Payments` resource: `all(order_id:)`, `find(id)`
-- [ ] `PaymentRequests` resource: `all(order_id:)`, `find(id)`, `create`
-- [ ] `PaymentTerms` resource: `all` — reference data
-- [ ] `paymentRequestCreate` mutation
+- [ ] `PaymentRequests` resource: `all(order_id:)`, `find(id)`, `create`, `delete`
+- [ ] `paymentRequestCreate`, `paymentRequestDelete` mutations
+- [ ] `PaymentTerms` resource: `all`, `find(id)`, `create`, `update`, `archive`
+- [ ] `paymentTermCreate`, `paymentTermUpdate`, `paymentTermArchive` mutations
 
 ### Preset Tasks
 
 - [ ] `Printavo::PresetTask` model (`id`, `body`, `dueOffsetDays`, `assignee`)
 - [ ] `Printavo::PresetTaskGroup` model (`id`, `name`, `tasks`)
-- [ ] `PresetTaskGroups` resource: `all`, `find(id)`, `create`, `update`
-- [ ] `presetTaskGroupCreate`, `presetTaskGroupUpdate` mutations
+- [ ] `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
 
 ### Product Catalog & Pricing
 
@@ -234,36 +271,26 @@ return values — they are exposed via model field accessors, not separate resou
 - [ ] `Products` resource: `all`, `find(id)`
 - [ ] `PricingMatrices` resource: `all`, `find(id)`
 
-### Purchase Orders
-
-- [ ] `Printavo::PurchaseOrder` model (`id`, `vendorName`, `total`, `sentAt`)
-- [ ] `Printavo::PoLineItem` model (`id`, `name`, `quantity`, `price`)
-- [ ] `PurchaseOrders` resource: `all`, `find(id)`, `create`, `update`
-- [ ] `purchaseOrderCreate`, `purchaseOrderUpdate` mutations
-
-### Refunds & Returns
-
-- [ ] `Printavo::Refund` model (`id`, `amount`, `reason`, `createdAt`)
-- [ ] `Printavo::Return` model (`id`, `quantity`, `reason`, `createdAt`)
-- [ ] `Refunds` resource: `all(order_id:)`, `find(id)`, `create`
-- [ ] `refundCreate` mutation
+### Tasks ✅
 
-### Tasks
+- [x] `Printavo::Task` model (`id`, `body`, `dueAt`, `completedAt`, `assignee`)
+- [x] `Tasks` resource: `all`, `find(id)`, `create`, `update`, `complete`, `delete`
+- [x] `taskCreate`, `taskUpdate`, `taskDelete` mutations
 
-- [ ] `Printavo::Task` model (`id`, `body`, `dueAt`, `completedAt`, `assignee`)
-- [ ] `Tasks` resource: `all`, `find(id)`, `create`, `update`, `complete`
-- [ ] `taskCreate`, `taskUpdate` mutations
+### Threads (Messages) ✅
 
-### Threads (Messages)
+- [x] `Printavo::Thread` model (`id`, `subject`, `createdAt`, `updatedAt`)
+- [x] `Threads` resource: `all(order_id:)`, `find(id)`, `update`
+- [x] `threadUpdate` mutation
+- [x] `emailMessageCreate` mutation — send an email message on a thread
 
-- [ ] `Printavo::Thread` model (`id`, `body`, `author`, `createdAt`, `attachments`)
-- [ ] `Threads` resource: `all(order_id:)`, `find(id)`, `create`
-- [ ] `threadCreate` mutation
+### Transactions ✅
 
-### Transactions
-
-- [ ] `Printavo::Transaction` model (`id`, `amount`, `kind`, `createdAt`, `details`)
-- [ ] `Transactions` resource: `all(order_id:)`, `find(id)`
+- [x] `Printavo::Transaction` model (`id`, `amount`, `kind`, `createdAt`)
+- [x] `Transactions` resource: `all(order_id:)`, `find(id)`
+- [x] `Printavo::TransactionPayment` model (`id`, `amount`, `paymentMethod`, `paidAt`, `note`)
+- [x] `TransactionPayments` resource: `create`, `update`, `delete`
+- [x] `transactionPaymentCreate`, `transactionPaymentUpdate`, `transactionPaymentDelete` mutations
 
 ### Types of Work
 
@@ -278,8 +305,7 @@ return values — they are exposed via model field accessors, not separate resou
 ### Vendors
 
 - [ ] `Printavo::Vendor` model (`id`, `name`, `email`, `phone`)
-- [ ] `Vendors` resource: `all`, `find(id)`, `create`, `update`
-- [ ] `vendorCreate`, `vendorUpdate` mutations
+- [ ] `Vendors` resource: `all`, `find(id)` — read-only; no create/update/delete in V2 API
 
 ---
 
@@ -291,18 +317,18 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `Contacts` resource (`find`, `create`, `update`)
 - [x] `Account` resource (singleton `find`)
 
-### v0.7.0 — Transactions, Tasks & Threads
+### v0.7.0 — Transactions, Tasks & Threads ✅
 
-- [ ] `Transactions` resource (`all`, `find`)
-- [ ] `Tasks` resource (`all`, `find`, `create`, `update`, `complete`)
-- [ ] `Threads` resource (`all`, `find`, `create`)
-- [ ] Delete mutations: `contactDelete`, `customerDelete`, `quoteDelete`, `invoiceDelete`, `lineItemDelete`, `taskDelete`
+- [x] `Transactions` resource (`all`, `find`) + `TransactionPayments` (`create`, `update`, `delete`)
+- [x] `Tasks` resource (`all`, `find`, `create`, `update`, `complete`, `delete`)
+- [x] `Threads` resource (`all`, `find`, `update`) + `emailMessageCreate`
 
-### v0.8.0 — Order Structure: Line Item Groups, Imprints & Fees
+### v0.8.0 — Order Structure: Line Items, Line Item Groups, Imprints & Fees
 
-- [ ] `LineItemGroups` resource (`all`, `find`, `create`, `update`)
-- [ ] `Imprints` resource (`all`, `find`, `create`, `update`)
-- [ ] `Fees` resource (`all`, `find`, `create`, `update`)
+- [ ] `LineItems` resource (`all`, `find`, `create`/`creates`, `update`/`updates`, `delete`/`deletes`)
+- [ ] `LineItemGroups` resource (`all`, `find`, `create`/`creates`, `update`/`updates`, `delete`/`deletes`)
+- [ ] `Imprints` resource (`all`, `find`, `create`/`creates`, `update`/`updates`, `delete`/`deletes`, mockup attach)
+- [ ] `Fees` resource (`all`, `find`, `create`/`creates`, `update`/`updates`, `delete`/`deletes`)
 - [ ] `Expenses` resource (`all`, `find`, `create`, `update`)
 
 ### v0.9.0 — Merch, Products & Pricing
@@ -311,34 +337,44 @@ return values — they are exposed via model field accessors, not separate resou
 - [ ] `Products` resource + `PricingMatrices` resource
 - [ ] `Categories` resource (reference data)
 
-### v0.10.0 — Financial: Payments, Purchase Orders & Refunds
+### v0.10.0 — Financial: Payments, Payment Terms & Requests
 
 - [ ] `Payments` resource (`all`, `find`)
-- [ ] `PaymentRequests` resource (`all`, `find`, `create`)
-- [ ] `PaymentTerms` resource (`all`) — reference data
-- [ ] `PurchaseOrders` + `PoLineItems` resources
-- [ ] `Refunds` + `Returns` resources
+- [ ] `PaymentRequests` resource (`all`, `find`, `create`, `delete`)
+- [ ] `PaymentTerms` resource (`all`, `find`, `create`, `update`, `archive`)
 
 ### v0.11.0 — Workflow: Approvals & Preset Tasks
 
-- [ ] `Approvals` resource (`all`, `find`, `create`)
-- [ ] `PresetTaskGroups` resource (`all`, `find`, `create`, `update`)
+- [ ] `ApprovalRequests` resource (`all`, `find`, `create`, `approve`, `revoke`, `unapprove`)
+- [ ] `PresetTasks` resource (`find`, `create`, `update`, `delete`)
+- [ ] `PresetTaskGroups` resource (`all`, `find`, `create`, `update`, `delete`, `apply`)
 
 ### v0.12.0 — Files, Media & Communication
 
-- [ ] `ProductionFiles` resource (`all`, `find`, `create`)
-- [ ] `Mockups` resource (`all`, `find`, `create`)
+- [ ] `ProductionFiles` resource (`all`, `find`, `create`/`creates`, `delete`/`deletes`)
+- [ ] `Mockups` resource (`all`, `find`, `delete`/`deletes`)
 - [ ] `EmailTemplates` resource (`all`, `find`)
+- [ ] `CustomAddresses` resource (`all`, `find`, `create`/`creates`, `update`/`updates`, `delete`/`deletes`)
 
 ### v0.13.0 — People, Orgs & Reference Data
 
 - [ ] `Users` resource (`all`, `find`)
-- [ ] `Vendors` resource (`all`, `find`, `create`, `update`)
+- [ ] `Vendors` resource (`all`, `find`) — read-only
 - [ ] `ContractorProfiles` resource (`all`, `find`)
-- [ ] `DeliveryMethods` resource (`all`) — reference data
-- [ ] `TypesOfWork` resource (`all`) — reference data
+- [ ] `DeliveryMethods` resource (`all`, `find`, `create`, `update`, `archive`)
+- [ ] `TypesOfWork` resource (`all`)
+
+### v0.14.0 — Delete & Duplicate Mutations for Shipped Resources
+
+- [ ] `Contacts#delete` — `contactDelete`
+- [ ] `Customers#delete` — `customerDelete`
+- [ ] `Inquiries#delete` — `inquiryDelete`
+- [ ] `Invoices#delete` — `invoiceDelete`
+- [ ] `Invoices#duplicate` — `invoiceDuplicate`
+- [ ] `Orders#delete` — `quoteDelete`
+- [ ] `Orders#duplicate` — `quoteDuplicate`
 
-### v0.14.0 — Retry / Backoff & CLI
+### v0.15.0 — Retry / Backoff & CLI
 
 - [ ] Configurable `max_retries` on `Printavo::Client`
 - [ ] Exponential backoff with jitter on 429 responses

data/lib/printavo/client.rb

@@ -37,24 +37,52 @@ module Printavo
       Resources::Customers.new(@graphql)
     end
 
+    def inquiries
+      Resources::Inquiries.new(@graphql)
+    end
+
     def invoices
       Resources::Invoices.new(@graphql)
     end
 
-    def statuses
-      Resources::Statuses.new(@graphql)
+    def jobs
+      Resources::Jobs.new(@graphql)
+    end
+
+    def login(*)
+      raise NotImplementedError,
+            'login is not supported — this gem authenticates via email + token headers. ' \
+            'Pass credentials to Printavo::Client.new(email:, token:) instead.'
+    end
+
+    def logout(*)
+      raise NotImplementedError,
+            'logout is not supported — this gem uses stateless header-based auth. ' \
+            'Simply discard the client instance when done.'
     end
 
     def orders
       Resources::Orders.new(@graphql)
     end
 
-    def jobs
-      Resources::Jobs.new(@graphql)
+    def statuses
+      Resources::Statuses.new(@graphql)
     end
 
-    def inquiries
-      Resources::Inquiries.new(@graphql)
+    def tasks
+      Resources::Tasks.new(@graphql)
+    end
+
+    def threads
+      Resources::Threads.new(@graphql)
+    end
+
+    def transaction_payments
+      Resources::TransactionPayments.new(@graphql)
+    end
+
+    def transactions
+      Resources::Transactions.new(@graphql)
     end
   end
 end

data/lib/printavo/models/task.rb

@@ -0,0 +1,13 @@
+# lib/printavo/models/task.rb
+# frozen_string_literal: true
+
+module Printavo
+  class Task < Models::Base
+    def id           = self['id']
+    def body         = self['body']
+    def due_at       = self['dueAt']
+    def completed_at = self['completedAt']
+    def completed?   = !completed_at.nil?
+    def assignee     = self['assignee']
+  end
+end

data/lib/printavo/models/thread.rb

@@ -0,0 +1,11 @@
+# lib/printavo/models/thread.rb
+# frozen_string_literal: true
+
+module Printavo
+  class Thread < Models::Base
+    def id         = self['id']
+    def subject    = self['subject']
+    def created_at = self['createdAt']
+    def updated_at = self['updatedAt']
+  end
+end

data/lib/printavo/models/transaction.rb

@@ -0,0 +1,11 @@
+# lib/printavo/models/transaction.rb
+# frozen_string_literal: true
+
+module Printavo
+  class Transaction < Models::Base
+    def id         = self['id']
+    def amount     = self['amount']
+    def kind       = self['kind']
+    def created_at = self['createdAt']
+  end
+end

data/lib/printavo/models/transaction_payment.rb

@@ -0,0 +1,12 @@
+# lib/printavo/models/transaction_payment.rb
+# frozen_string_literal: true
+
+module Printavo
+  class TransactionPayment < Models::Base
+    def id             = self['id']
+    def amount         = self['amount']
+    def payment_method = self['paymentMethod']
+    def paid_at        = self['paidAt']
+    def note           = self['note']
+  end
+end

data/lib/printavo/resources/tasks.rb

@@ -0,0 +1,65 @@
+# lib/printavo/resources/tasks.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class Tasks < Base
+      ALL_QUERY       = File.read(File.join(__dir__, '../graphql/tasks/all.graphql')).freeze
+      FIND_QUERY      = File.read(File.join(__dir__, '../graphql/tasks/find.graphql')).freeze
+      CREATE_MUTATION = File.read(File.join(__dir__, '../graphql/tasks/create.graphql')).freeze
+      UPDATE_MUTATION = File.read(File.join(__dir__, '../graphql/tasks/update.graphql')).freeze
+      DELETE_MUTATION = File.read(File.join(__dir__, '../graphql/tasks/delete.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::Task.new(data['task'])
+      end
+
+      def create(**input)
+        data = @graphql.mutate(CREATE_MUTATION, variables: { input: camelize_keys(input) })
+        Printavo::Task.new(data['taskCreate'])
+      end
+
+      def update(id, **input)
+        data = @graphql.mutate(UPDATE_MUTATION,
+                               variables: { id: id.to_s, input: camelize_keys(input) })
+        Printavo::Task.new(data['taskUpdate'])
+      end
+
+      # Marks a task complete by setting completedAt to the current time.
+      def complete(id)
+        require 'time'
+        update(id, completed_at: Time.now.utc.iso8601)
+      end
+
+      # Deletes a task. Raises on failure; returns nil on success.
+      def delete(id)
+        @graphql.mutate(DELETE_MUTATION, variables: { id: id.to_s })
+        nil
+      end
+
+      private
+
+      def fetch_page(first: 25, after: nil, **)
+        data = @graphql.query(ALL_QUERY, variables: { first: first, after: after })
+        nodes = data['tasks']['nodes'].map { |attrs| Printavo::Task.new(attrs) }
+        page_info = data['tasks']['pageInfo']
+        Printavo::Page.new(
+          records: nodes,
+          has_next_page: page_info['hasNextPage'],
+          end_cursor: page_info['endCursor']
+        )
+      end
+
+      def camelize_keys(hash)
+        hash.transform_keys do |key|
+          key.to_s.gsub(/_([a-z])/) { ::Regexp.last_match(1).upcase }
+        end
+      end
+    end
+  end
+end

data/lib/printavo/resources/threads.rb

@@ -0,0 +1,59 @@
+# lib/printavo/resources/threads.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class Threads < Base
+      ALL_QUERY                  = File.read(File.join(__dir__, '../graphql/threads/all.graphql')).freeze
+      FIND_QUERY                 = File.read(File.join(__dir__, '../graphql/threads/find.graphql')).freeze
+      UPDATE_MUTATION            = File.read(File.join(__dir__, '../graphql/threads/update.graphql')).freeze
+      EMAIL_MESSAGE_CREATE_MUTATION =
+        File.read(File.join(__dir__, '../graphql/threads/email_message_create.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::Thread.new(data['thread'])
+      end
+
+      def update(id, **input)
+        data = @graphql.mutate(UPDATE_MUTATION,
+                               variables: { id: id.to_s, input: camelize_keys(input) })
+        Printavo::Thread.new(data['threadUpdate'])
+      end
+
+      # Sends an email message on a thread. Returns the raw message hash.
+      # A dedicated EmailMessage model is planned for a future version.
+      def email_message_create(**input)
+        data = @graphql.mutate(EMAIL_MESSAGE_CREATE_MUTATION,
+                               variables: { input: camelize_keys(input) })
+        data['emailMessageCreate']
+      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']['threads']['nodes'].map { |attrs| Printavo::Thread.new(attrs) }
+        page_info = data['order']['threads']['pageInfo']
+        Printavo::Page.new(
+          records: nodes,
+          has_next_page: page_info['hasNextPage'],
+          end_cursor: page_info['endCursor']
+        )
+      end
+
+      def camelize_keys(hash)
+        hash.transform_keys do |key|
+          key.to_s.gsub(/_([a-z])/) { ::Regexp.last_match(1).upcase }
+        end
+      end
+    end
+  end
+end

data/lib/printavo/resources/transaction_payments.rb

@@ -0,0 +1,37 @@
+# lib/printavo/resources/transaction_payments.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class TransactionPayments < Base
+      CREATE_MUTATION = File.read(File.join(__dir__, '../graphql/transaction_payments/create.graphql')).freeze
+      UPDATE_MUTATION = File.read(File.join(__dir__, '../graphql/transaction_payments/update.graphql')).freeze
+      DELETE_MUTATION = File.read(File.join(__dir__, '../graphql/transaction_payments/delete.graphql')).freeze
+
+      def create(**input)
+        data = @graphql.mutate(CREATE_MUTATION, variables: { input: camelize_keys(input) })
+        Printavo::TransactionPayment.new(data['transactionPaymentCreate'])
+      end
+
+      def update(id, **input)
+        data = @graphql.mutate(UPDATE_MUTATION,
+                               variables: { id: id.to_s, input: camelize_keys(input) })
+        Printavo::TransactionPayment.new(data['transactionPaymentUpdate'])
+      end
+
+      # Deletes a transaction payment. Raises on failure; returns nil on success.
+      def delete(id)
+        @graphql.mutate(DELETE_MUTATION, variables: { id: id.to_s })
+        nil
+      end
+
+      private
+
+      def camelize_keys(hash)
+        hash.transform_keys do |key|
+          key.to_s.gsub(/_([a-z])/) { ::Regexp.last_match(1).upcase }
+        end
+      end
+    end
+  end
+end

data/lib/printavo/resources/transactions.rb

@@ -0,0 +1,36 @@
+# lib/printavo/resources/transactions.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class Transactions < Base
+      ALL_QUERY  = File.read(File.join(__dir__, '../graphql/transactions/all.graphql')).freeze
+      FIND_QUERY = File.read(File.join(__dir__, '../graphql/transactions/find.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::Transaction.new(data['transaction'])
+      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']['transactions']['nodes'].map { |attrs| Printavo::Transaction.new(attrs) }
+        page_info = data['order']['transactions']['pageInfo']
+        Printavo::Page.new(
+          records: nodes,
+          has_next_page: page_info['hasNextPage'],
+          end_cursor: page_info['endCursor']
+        )
+      end
+    end
+  end
+end

data/lib/printavo/version.rb

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

data/lib/printavo.rb

@@ -20,6 +20,10 @@ require_relative 'printavo/models/status'
 require_relative 'printavo/models/order'
 require_relative 'printavo/models/job'
 require_relative 'printavo/models/inquiry'
+require_relative 'printavo/models/task'
+require_relative 'printavo/models/thread'
+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/contacts'
@@ -29,6 +33,10 @@ require_relative 'printavo/resources/statuses'
 require_relative 'printavo/resources/orders'
 require_relative 'printavo/resources/jobs'
 require_relative 'printavo/resources/inquiries'
+require_relative 'printavo/resources/tasks'
+require_relative 'printavo/resources/threads'
+require_relative 'printavo/resources/transactions'
+require_relative 'printavo/resources/transaction_payments'
 require_relative 'printavo/webhooks'
 require_relative 'printavo/client'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: printavo-ruby
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Stan Carver II
@@ -281,6 +281,10 @@ files:
 - lib/printavo/models/job.rb
 - lib/printavo/models/order.rb
 - lib/printavo/models/status.rb
+- lib/printavo/models/task.rb
+- lib/printavo/models/thread.rb
+- lib/printavo/models/transaction.rb
+- lib/printavo/models/transaction_payment.rb
 - lib/printavo/page.rb
 - lib/printavo/resources/account.rb
 - lib/printavo/resources/base.rb
@@ -291,6 +295,10 @@ files:
 - lib/printavo/resources/jobs.rb
 - lib/printavo/resources/orders.rb
 - lib/printavo/resources/statuses.rb
+- lib/printavo/resources/tasks.rb
+- lib/printavo/resources/threads.rb
+- lib/printavo/resources/transaction_payments.rb
+- lib/printavo/resources/transactions.rb
 - lib/printavo/version.rb
 - lib/printavo/webhooks.rb
 homepage: https://github.com/scarver2/printavo-ruby