printavo-ruby 0.5.2 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72653b7d55ebd17fbbc5331c50e530cbb15655175c35190ba3c740e5f53fad0f
-  data.tar.gz: 2f0bd39de81b2862289510ec8b282e3009165d86aa8c32c27a96b6f03228fc9e
+  metadata.gz: 3563777c538165a00ca4888be9d489c6a0e9b14542dac6d02a18b60894826f7d
+  data.tar.gz: ceb47bf69ff0dc7f48888d4fee3f601aa621015f8028e6dd0af31e2037b36749
 SHA512:
-  metadata.gz: 8dd07daab212f1a7cf4a137fd3890f099422f7fc24cb15a2368f30864d7d9c701c83c7d4d0d27a59dcec3ec11444ddb4f11acae4edf035d4033ab03523ad4127
-  data.tar.gz: 013ea7ed343e5ee3915f9092609e756b4f917d0f1d24dd6c04b4a4c837dc0dbd5d2a3d475ac67e5bde40e9ff335b219c1b352627ae8e925ac857ac9fba17951f
+  metadata.gz: b266887065b5f727b6f9660557ce37d7ab64b53f23033f5c64c678cae919f00cd21e169fee17177bce7e873fdcc9d978307a3254e20de0224aab4b8e9c462d97
+  data.tar.gz: 4d1c944ca7283bab4e45dfe3cde0ddc6acf3ea35a167ee7b49574b6f7e367fff77a833253976605e2f8219aea932d5056b04004fcb55553cd4975bdfe853b3fe

data/docs/CHANGELOG.md

@@ -6,6 +6,31 @@ 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.6.0] - 2026-03-30
+
+### Added
+- `Printavo::Contact` model (`id`, `first_name`, `last_name`, `full_name`, `email`, `phone`, `fax`)
+- `Contacts` resource: `find(id)`, `create(**input)`, `contactCreate` mutation,
+  `update(id, **input)`, `contactUpdate` mutation
+- `Printavo::Invoice` model (`id`, `nickname`, `total`, `amount_paid`,
+  `amount_outstanding`, `paid_in_full?`, `invoice_at`, `payment_due_at`,
+  `status`, `status_key`, `status?`, `contact`)
+- `Invoices` resource: `all`, `find(id)`, `update(id, **input)` (`invoiceUpdate` mutation);
+  note: invoices are promoted from quotes, so no `create` — use `client.orders.create`
+- `Printavo::Account` model (`id`, `company_name`, `company_email`, `phone`,
+  `website`, `logo_url`, `locale`)
+- `Account` resource: singleton `find` — no ID argument, returns the account
+  associated with the current API credentials
+- `client.contacts`, `client.invoices`, `client.account` entry points on `Printavo::Client`
+- 10 new `.graphql` files under `lib/printavo/graphql/` (contacts/find, create, update;
+  invoices/all, find, update; account/find)
+
+### Changed
+- `spec/support/factories.rb` split into 9 domain files under `spec/support/factories/`
+  (`account`, `contact`, `customer`, `graphql`, `inquiry`, `invoice`, `job`, `order`, `status`)
+- `spec/spec_helper.rb` loads factory files via `Dir` glob; `config.include Factories` moved here
+- Removed `Metrics/ModuleLength` exclusion from `.rubocop.yml` — no longer needed
+
 ## [0.5.2] - 2026-03-30
 
 ### Changed

data/docs/TODO.md

@@ -69,6 +69,7 @@ Full task list for `printavo-ruby` across all versions. Checked items are shippe
 - [x] Extract 17 GraphQL heredocs into external `.graphql` files (`lib/printavo/graphql/<resource>/<op>.graphql`)
 - [x] `docs/` consolidation — `CHANGELOG.md`, `CONTRIBUTING.md`, `FUTURE.md`, `CACHING.md`
 - [x] `docs/CACHING.md` — nine caching strategy patterns for rate-limit-aware consumers
+- [x] Split `spec/support/factories.rb` monolith into 9 domain files under `spec/support/factories/`
 
 ---
 
@@ -86,38 +87,166 @@ Resources and mutations present in the Printavo V2 GraphQL API that are not yet
 wrapped by a resource class. Raw GraphQL access works for all of these today via
 `client.graphql.query(...)` — these tasks add first-class resource support.
 
-### Contacts
+### Embedded / Infrastructure Types (no standalone resource needed)
+
+These types appear in the schema but are sub-objects, pagination wrappers, or
+return values — they are exposed via model field accessors, not separate resources.
+
+- `*Connection` / `*Edge` (all variants) — GraphQL pagination wrappers; handled by `Printavo::Page`
+- `Address`, `BillingAddress`, `CustomerAddress`, `MerchAddress`, `CustomAddress` — embedded address shapes
+- `Avatar` — embedded in `User`
+- `CatalogInformation`, `InvoiceInformation` — embedded in `Account`
+- `DeletedID` — return type for delete mutations
+- `EmailMessage`, `TextMessage` — message subtypes under `Thread`
+- `Feature`, `FeatureRestriction` — embedded in `Account.features`
+- `LineItemEnabledColumns`, `LineItemGroupSize`, `LineItemPriceReceipt`, `LineItemSizeCount` — embedded in `LineItemGroup` / `LineItem`
+- `LoggedIn` — auth response type
+- `MerchOrderDelivery`, `MerchStoreSummary` — embedded in `MerchOrder` / `MerchStore`
+- `MessageAttachment` — embedded in `Thread` messages
+- `ObjectTimestamps` — `createdAt` / `updatedAt` on all objects
+- `OrderUnionConnection` / `OrderUnionEdge` — union pagination for `Quote | Invoice`; handled via inline fragments
+- `PageInfo` — cursor pagination metadata; handled by `Printavo::Page`
+- `PaymentRequestDetail` — embedded in `PaymentRequest`
+- `Permission` — embedded in `User`
+- `Personalization` — size/color breakdown embedded in `LineItem` / `Imprint`
+- `PricingMatrixCell`, `PricingMatrixColumn` — sub-objects of `PricingMatrix`
+- `ProductCatalog` — configuration embedded in `Account`
+- `Social` — social media links embedded in `Account`
+- `ThreadSummary` — preview summary embedded on orders; not a standalone query
+- `TransactionDetails`, `TransactionUnionConnection`, `TransactionUnionEdge` — embedded / pagination wrappers
 
-- [ ] `Printavo::Contact` model (`id`, `firstName`, `lastName`, `email`, `phone`)
-- [ ] `Contacts` resource: `find(id)`
-- [ ] `contact` query (contacts are distinct from the customer's `primaryContact`)
+---
+
+### Account ✅
+
+- [x] `Printavo::Account` model (shop-level info: name, address, phone, logo)
+- [x] `Account` resource: `find` (singleton — no ID needed)
+- [x] `account` query
+
+### Contacts ✅
+
+- [x] `Printavo::Contact` model (`id`, `firstName`, `lastName`, `email`, `phone`)
+- [x] `Contacts` resource: `find(id)`, `create`, `update`
+- [x] `contact` query (contacts are distinct from the customer's `primaryContact`)
+
+### Invoices ✅
+
+- [x] `Printavo::Invoice` model (mirrors Order; has `amountPaid`, `amountOutstanding`, `paidInFull?`)
+- [x] `Invoices` resource: `all`, `find(id)`, `update`
+- [x] `client.invoices` entry point on `Printavo::Client`
+
+### Approvals
 
-### Invoices
+- [ ] `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::Invoice` model (mirrors Order; has `invoiceNumber`, `paidAt`, `balanceDue`)
-- [ ] `Invoices` resource: `all`, `find(id)`
-- [ ] `client.invoices` entry point on `Printavo::Client`
+### Categories
+
+- [ ] `Printavo::Category` model (`id`, `name`)
+- [ ] `Categories` resource: `all`, `find(id)` — reference data for products/line items
+
+### Contractor Profiles
+
+- [ ] `Printavo::ContractorProfile` model (`id`, `name`, `email`)
+- [ ] `ContractorProfiles` resource: `all`, `find(id)` — contractors assignable to invoices
+
+### Delivery Methods
+
+- [ ] `Printavo::DeliveryMethod` model (`id`, `name`)
+- [ ] `DeliveryMethods` resource: `all` — reference data (pickup, ship, etc.)
+
+### Delete Mutations
+
+- [ ] `contactDelete(id:)`
+- [ ] `customerDelete(id:)`
+- [ ] `quoteDelete(id:)` / `invoiceDelete(id:)`
+- [ ] `lineItemDelete(id:)`
+- [ ] `taskDelete(id:)`
+
+### Email Templates
+
+- [ ] `Printavo::EmailTemplate` model (`id`, `name`, `subject`, `body`)
+- [ ] `EmailTemplates` resource: `all`, `find(id)`
+
+### Expenses
+
+- [ ] `Printavo::Expense` model (`id`, `name`, `amount`, `category`)
+- [ ] `Expenses` resource: `all(order_id:)`, `find(id)`, `create`, `update`
+- [ ] `expenseCreate`, `expenseUpdate` mutations
+
+### Fees
+
+- [ ] `Printavo::Fee` model (`id`, `name`, `amount`, `taxable`)
+- [ ] `Fees` resource: `all(order_id:)`, `find(id)`, `create`, `update`
+- [ ] `feeCreate`, `feeUpdate` mutations
+
+### Imprints
+
+- [ ] `Printavo::Imprint` model (`id`, `name`, `position`, `colors`, `personalization`)
+- [ ] `Imprints` resource: `all(line_item_group_id:)`, `find(id)`, `create`, `update`
+- [ ] `imprintCreate`, `imprintUpdate` mutations
 
 ### Line Item Groups
 
-- [ ] `Printavo::LineItemGroup` model (`id`, `name`, `description`)
-- [ ] `LineItemGroups` resource: `all(order_id:)`, `find(id)`
-- [ ] `lineItemGroup` / `lineItemGroups` queries
+- [ ] `Printavo::LineItemGroup` model (`id`, `name`, `description`, `sizes`, `enabled_columns`)
+- [ ] `LineItemGroups` resource: `all(order_id:)`, `find(id)`, `create`, `update`
+- [ ] `lineItemGroupCreate`, `lineItemGroupUpdate` mutations
 
 ### Merch
 
-- [ ] `Printavo::MerchStore` model
-- [ ] `Printavo::MerchOrder` model
+- [ ] `Printavo::MerchStore` model (`id`, `name`, `url`, `summary`)
+- [ ] `Printavo::MerchOrder` model (`id`, `status`, `delivery`, `contact`)
 - [ ] `MerchStores` resource: `all`, `find(id)`
 - [ ] `MerchOrders` resource: `all`, `find(id)`
 - [ ] `client.merch_stores` / `client.merch_orders` entry points
 
-### Transactions & Payments
+### Mockups & Production Files
 
-- [ ] `Printavo::Transaction` model (`id`, `amount`, `kind`, `createdAt`)
-- [ ] `Transactions` resource: `all(order_id:)`, `find(id)`
-- [ ] Payment request mutations
-- [ ] Payment dispute handling
+- [ ] `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`
+
+### 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
+- [ ] `Payments` resource: `all(order_id:)`, `find(id)`
+- [ ] `PaymentRequests` resource: `all(order_id:)`, `find(id)`, `create`
+- [ ] `PaymentTerms` resource: `all` — reference data
+- [ ] `paymentRequestCreate` mutation
+
+### 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
+
+### Product Catalog & Pricing
+
+- [ ] `Printavo::Product` model (`id`, `name`, `sku`, `description`)
+- [ ] `Printavo::PricingMatrix` model (`id`, `name`, `cells`, `columns`)
+- [ ] `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
 
@@ -127,62 +256,96 @@ wrapped by a resource class. Raw GraphQL access works for all of these today via
 
 ### Threads (Messages)
 
-- [ ] `Printavo::Thread` model (`id`, `body`, `author`, `createdAt`)
+- [ ] `Printavo::Thread` model (`id`, `body`, `author`, `createdAt`, `attachments`)
 - [ ] `Threads` resource: `all(order_id:)`, `find(id)`, `create`
 - [ ] `threadCreate` mutation
 
-### Account
+### Transactions
 
-- [ ] `Printavo::Account` model (shop-level info: name, address, phone, logo)
-- [ ] `Account` resource: `find` (singleton — no ID needed)
-- [ ] `account` query
+- [ ] `Printavo::Transaction` model (`id`, `amount`, `kind`, `createdAt`, `details`)
+- [ ] `Transactions` resource: `all(order_id:)`, `find(id)`
 
-### Delete Mutations
+### Types of Work
 
-- [ ] `customerDelete(id:)`
-- [ ] `quoteDelete(id:)` / `invoiceDelete(id:)`
-- [ ] `lineItemDelete(id:)`
-- [ ] `taskDelete(id:)`
+- [ ] `Printavo::TypeOfWork` model (`id`, `name`)
+- [ ] `TypesOfWork` resource: `all` — reference data for order categorization
 
-### Product Catalog & Pricing
+### Users
 
-- [ ] `Printavo::Product` model
-- [ ] `Products` resource: `all`, `find(id)`
-- [ ] Pricing matrix queries
+- [ ] `Printavo::User` model (`id`, `firstName`, `lastName`, `email`, `avatar`, `permissions`)
+- [ ] `Users` resource: `all`, `find(id)` — shop staff members
+
+### Vendors
+
+- [ ] `Printavo::Vendor` model (`id`, `name`, `email`, `phone`)
+- [ ] `Vendors` resource: `all`, `find(id)`, `create`, `update`
+- [ ] `vendorCreate`, `vendorUpdate` mutations
 
 ---
 
 ## Planned Versions
 
-### v0.6.0 — Invoices, Contacts & Analytics
+### v0.6.0 — Invoices, Contacts & Account ✅
 
-- [ ] `Invoices` resource (`all`, `find`)
-- [ ] `Contacts` resource (`find`)
-- [ ] `Account` resource (singleton)
-- [ ] Analytics/Reporting resource: revenue, job counts, customer activity, turnaround times
-- [ ] Community burn-in — gather feedback on 0.5.x API surface
+- [x] `Invoices` resource (`all`, `find`, `update`)
+- [x] `Contacts` resource (`find`, `create`, `update`)
+- [x] `Account` resource (singleton `find`)
 
 ### v0.7.0 — Transactions, Tasks & Threads
 
 - [ ] `Transactions` resource (`all`, `find`)
 - [ ] `Tasks` resource (`all`, `find`, `create`, `update`, `complete`)
 - [ ] `Threads` resource (`all`, `find`, `create`)
-- [ ] Delete mutations for Customer, Order, LineItem, Task
+- [ ] Delete mutations: `contactDelete`, `customerDelete`, `quoteDelete`, `invoiceDelete`, `lineItemDelete`, `taskDelete`
+
+### v0.8.0 — Order Structure: Line Item Groups, Imprints & Fees
 
-### v0.8.0 — Merch & Products
+- [ ] `LineItemGroups` resource (`all`, `find`, `create`, `update`)
+- [ ] `Imprints` resource (`all`, `find`, `create`, `update`)
+- [ ] `Fees` resource (`all`, `find`, `create`, `update`)
+- [ ] `Expenses` resource (`all`, `find`, `create`, `update`)
+
+### v0.9.0 — Merch, Products & Pricing
 
 - [ ] `MerchStores` + `MerchOrders` resources
-- [ ] `LineItemGroups` resource
-- [ ] `Products` resource + pricing matrix queries
+- [ ] `Products` resource + `PricingMatrices` resource
+- [ ] `Categories` resource (reference data)
+
+### v0.10.0 — Financial: Payments, Purchase Orders & Refunds
+
+- [ ] `Payments` resource (`all`, `find`)
+- [ ] `PaymentRequests` resource (`all`, `find`, `create`)
+- [ ] `PaymentTerms` resource (`all`) — reference data
+- [ ] `PurchaseOrders` + `PoLineItems` resources
+- [ ] `Refunds` + `Returns` resources
+
+### v0.11.0 — Workflow: Approvals & Preset Tasks
+
+- [ ] `Approvals` resource (`all`, `find`, `create`)
+- [ ] `PresetTaskGroups` resource (`all`, `find`, `create`, `update`)
+
+### v0.12.0 — Files, Media & Communication
+
+- [ ] `ProductionFiles` resource (`all`, `find`, `create`)
+- [ ] `Mockups` resource (`all`, `find`, `create`)
+- [ ] `EmailTemplates` resource (`all`, `find`)
+
+### v0.13.0 — People, Orgs & Reference Data
+
+- [ ] `Users` resource (`all`, `find`)
+- [ ] `Vendors` resource (`all`, `find`, `create`, `update`)
+- [ ] `ContractorProfiles` resource (`all`, `find`)
+- [ ] `DeliveryMethods` resource (`all`) — reference data
+- [ ] `TypesOfWork` resource (`all`) — reference data
 
-### v0.9.0 — Retry / Backoff & CLI
+### v0.14.0 — Retry / Backoff & CLI
 
 - [ ] Configurable `max_retries` on `Printavo::Client`
 - [ ] Exponential backoff with jitter on 429 responses
 - [ ] `retry_on_rate_limit: true/false` client option
 - [ ] Thor-based `printavo` CLI (`customers`, `orders`, `orders find <id>`)
 
-### v0.10.0 — API Freeze
+### v0.99.0 — API Freeze
 
 - [ ] Community feedback integration
 - [ ] Deprecation notices for any renamed methods

data/lib/printavo/client.rb

@@ -25,10 +25,22 @@ module Printavo
       @graphql   = GraphqlClient.new(connection)
     end
 
+    def account
+      Resources::Account.new(@graphql)
+    end
+
+    def contacts
+      Resources::Contacts.new(@graphql)
+    end
+
     def customers
       Resources::Customers.new(@graphql)
     end
 
+    def invoices
+      Resources::Invoices.new(@graphql)
+    end
+
     def statuses
       Resources::Statuses.new(@graphql)
     end

data/lib/printavo/models/account.rb

@@ -0,0 +1,14 @@
+# lib/printavo/models/account.rb
+# frozen_string_literal: true
+
+module Printavo
+  class Account < Models::Base
+    def id            = self['id']
+    def company_name  = self['companyName']
+    def company_email = self['companyEmail']
+    def phone         = self['phone']
+    def website       = self['website']
+    def logo_url      = self['logoUrl']
+    def locale        = self['locale']
+  end
+end

data/lib/printavo/models/contact.rb

@@ -0,0 +1,17 @@
+# lib/printavo/models/contact.rb
+# frozen_string_literal: true
+
+module Printavo
+  class Contact < Models::Base
+    def id         = self['id']
+    def first_name = self['firstName']
+    def last_name  = self['lastName']
+    def email      = self['email']
+    def phone      = self['phone']
+    def fax        = self['fax']
+
+    def full_name
+      self['fullName'] || [first_name, last_name].compact.join(' ').strip
+    end
+  end
+end

data/lib/printavo/models/invoice.rb

@@ -0,0 +1,42 @@
+# lib/printavo/models/invoice.rb
+# frozen_string_literal: true
+
+module Printavo
+  class Invoice < Models::Base
+    def id                 = self['id']
+    def nickname           = self['nickname']
+    def total              = self['total']
+    def amount_paid        = self['amountPaid']
+    def amount_outstanding = self['amountOutstanding']
+    def paid_in_full?      = self['paidInFull']
+    def invoice_at         = self['invoiceAt']
+    def payment_due_at     = self['paymentDueAt']
+
+    def status
+      dig('status', 'name')
+    end
+
+    def status_id
+      dig('status', 'id')
+    end
+
+    def status_color
+      dig('status', 'color')
+    end
+
+    def status_key
+      return nil if status.nil?
+
+      status.downcase.gsub(/\s+/, '_').to_sym
+    end
+
+    def status?(key)
+      status_key == key.to_sym
+    end
+
+    def contact
+      attrs = self['contact']
+      Contact.new(attrs) if attrs
+    end
+  end
+end

data/lib/printavo/resources/account.rb

@@ -0,0 +1,25 @@
+# lib/printavo/resources/account.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    # Singleton resource — Printavo exposes one account per API credential.
+    # Use +client.account.find+ (no ID argument required).
+    class Account < Base
+      FIND_QUERY = File.read(File.join(__dir__, '../graphql/account/find.graphql')).freeze
+
+      # Returns the account associated with the current API credentials.
+      #
+      # @return [Printavo::Account]
+      #
+      # @example
+      #   account = client.account.find
+      #   puts account.company_name   # => "Texas Embroidery Ranch"
+      #   puts account.locale         # => "en-US"
+      def find
+        data = @graphql.query(FIND_QUERY)
+        Printavo::Account.new(data['account'])
+      end
+    end
+  end
+end

data/lib/printavo/resources/contacts.rb

@@ -0,0 +1,57 @@
+# lib/printavo/resources/contacts.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class Contacts < Base
+      FIND_QUERY      = File.read(File.join(__dir__, '../graphql/contacts/find.graphql')).freeze
+      CREATE_MUTATION = File.read(File.join(__dir__, '../graphql/contacts/create.graphql')).freeze
+      UPDATE_MUTATION = File.read(File.join(__dir__, '../graphql/contacts/update.graphql')).freeze
+
+      # Finds a contact by ID.
+      #
+      # @param id [String, Integer]
+      # @return [Printavo::Contact]
+      #
+      # @example
+      #   client.contacts.find("123")
+      def find(id)
+        data = @graphql.query(FIND_QUERY, variables: { id: id.to_s })
+        Printavo::Contact.new(data['contact'])
+      end
+
+      # Creates a new contact. Requires at minimum +email:+.
+      #
+      # @return [Printavo::Contact]
+      #
+      # @example
+      #   client.contacts.create(first_name: "Jane", last_name: "Smith",
+      #                          email: "jane@example.com", phone: "555-867-5309")
+      def create(**input)
+        data = @graphql.mutate(CREATE_MUTATION, variables: { input: camelize_keys(input) })
+        Printavo::Contact.new(data['contactCreate'])
+      end
+
+      # Updates an existing contact by ID.
+      #
+      # @param id [String, Integer]
+      # @return [Printavo::Contact]
+      #
+      # @example
+      #   client.contacts.update("123", phone: "555-999-0000")
+      def update(id, **input)
+        data = @graphql.mutate(UPDATE_MUTATION,
+                               variables: { id: id.to_s, input: camelize_keys(input) })
+        Printavo::Contact.new(data['contactUpdate'])
+      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/invoices.rb

@@ -0,0 +1,61 @@
+# lib/printavo/resources/invoices.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class Invoices < Base
+      ALL_QUERY       = File.read(File.join(__dir__, '../graphql/invoices/all.graphql')).freeze
+      FIND_QUERY      = File.read(File.join(__dir__, '../graphql/invoices/find.graphql')).freeze
+      UPDATE_MUTATION = File.read(File.join(__dir__, '../graphql/invoices/update.graphql')).freeze
+
+      def all(first: 25, after: nil)
+        fetch_page(first: first, after: after).records
+      end
+
+      # Finds an invoice by ID.
+      #
+      # @param id [String, Integer]
+      # @return [Printavo::Invoice]
+      #
+      # @example
+      #   client.invoices.find("456")
+      def find(id)
+        data = @graphql.query(FIND_QUERY, variables: { id: id.to_s })
+        Printavo::Invoice.new(data['invoice'])
+      end
+
+      # Updates an existing invoice by ID.
+      # Note: invoices are promoted from quotes — use +client.orders.create+ to originate.
+      #
+      # @param id [String, Integer]
+      # @return [Printavo::Invoice]
+      #
+      # @example
+      #   client.invoices.update("456", nickname: "Final Invoice", payment_due_at: "2026-05-01")
+      def update(id, **input)
+        data = @graphql.mutate(UPDATE_MUTATION,
+                               variables: { id: id.to_s, input: camelize_keys(input) })
+        Printavo::Invoice.new(data['invoiceUpdate'])
+      end
+
+      private
+
+      def fetch_page(first: 25, after: nil, **)
+        data = @graphql.query(ALL_QUERY, variables: { first: first, after: after })
+        nodes = data['invoices']['nodes'].map { |attrs| Printavo::Invoice.new(attrs) }
+        page_info = data['invoices']['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/version.rb

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

data/lib/printavo.rb

@@ -12,13 +12,19 @@ require_relative 'printavo/connection'
 require_relative 'printavo/graphql_client'
 require_relative 'printavo/page'
 require_relative 'printavo/models/base'
+require_relative 'printavo/models/account'
+require_relative 'printavo/models/contact'
 require_relative 'printavo/models/customer'
+require_relative 'printavo/models/invoice'
 require_relative 'printavo/models/status'
 require_relative 'printavo/models/order'
 require_relative 'printavo/models/job'
 require_relative 'printavo/models/inquiry'
 require_relative 'printavo/resources/base'
+require_relative 'printavo/resources/account'
+require_relative 'printavo/resources/contacts'
 require_relative 'printavo/resources/customers'
+require_relative 'printavo/resources/invoices'
 require_relative 'printavo/resources/statuses'
 require_relative 'printavo/resources/orders'
 require_relative 'printavo/resources/jobs'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: printavo-ruby
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.6.0
 platform: ruby
 authors:
 - Stan Carver II
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-30 00:00:00.000000000 Z
+date: 2026-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -272,16 +272,22 @@ files:
 - lib/printavo/connection.rb
 - lib/printavo/errors.rb
 - lib/printavo/graphql_client.rb
+- lib/printavo/models/account.rb
 - lib/printavo/models/base.rb
+- lib/printavo/models/contact.rb
 - lib/printavo/models/customer.rb
 - lib/printavo/models/inquiry.rb
+- lib/printavo/models/invoice.rb
 - lib/printavo/models/job.rb
 - lib/printavo/models/order.rb
 - lib/printavo/models/status.rb
 - lib/printavo/page.rb
+- lib/printavo/resources/account.rb
 - lib/printavo/resources/base.rb
+- lib/printavo/resources/contacts.rb
 - lib/printavo/resources/customers.rb
 - lib/printavo/resources/inquiries.rb
+- lib/printavo/resources/invoices.rb
 - lib/printavo/resources/jobs.rb
 - lib/printavo/resources/orders.rb
 - lib/printavo/resources/statuses.rb