printavo-ruby 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f841fd166476152c647d7851297e8b07a8291446d5ccbe657b3a5c9bb5faef6
-  data.tar.gz: dc74bf793d7c684b4a5aa5f649f3454397a88d684cd8b6f6c7ed3faea0a768a3
+  metadata.gz: 5c7c947ef3f0582fd5c30b1aa44f69cfdc2ba135ac4b5b616db3fc5c63615322
+  data.tar.gz: 664d2cafd355a83630af29c9902cf89dc2af838694cb91cc6ba182603d115a92
 SHA512:
-  metadata.gz: 536197cc16cb7faa1ebb1a557563df9954488afc795658bcc6f6cf38d2fa0a0a319f8f04c2842e27921ecc8d627bd4ee15643517bac8e31c39c46607a1d07744
-  data.tar.gz: d7f1654d4294bfab5cb9341a55860cb2ea763f91ba553a7a8982fe1a1199de61e0618e6d9ad2ce6938ead8887be3efc4d5264075bb3ebc0d29eca979c5187315
+  metadata.gz: 7e321c541a352c6ae3983682c03406ca80725499d2014bcfcc6cda1f8f2a8654f4aba9dc25452c7da7225a993ef205f0d698b23f5dfd68396b0f6add13070f27
+  data.tar.gz: 3182ba400910bc9de615ce19944bbac0b027b80874e35a364e2c64c476d383e86bbed46b501cd0d602dd06c49aa3a20b242f7d510261c734c56649301475e301

data/docs/CHANGELOG.md

@@ -6,6 +6,22 @@ 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.10.0] - 2026-03-31
+
+### Added
+- `Printavo::Payment` model (`id`, `amount`, `payment_method`, `paid_at`)
+- `Payments` resource: `all(order_id:)`, `find(id)` — read-only, scoped to an order
+- `Printavo::PaymentRequest` model (`id`, `amount`, `sent_at`, `paid_at`, `details`)
+- `PaymentRequests` resource: `all(order_id:)`, `find(id)`, `create(**input)`, `delete(id)` —
+  `paymentRequestCreate` / `paymentRequestDelete` mutations
+- `Printavo::PaymentTerm` model (`id`, `name`, `net_days`)
+- `PaymentTerms` resource: `all`, `find(id)`, `create(**input)`, `update(id, **input)`,
+  `archive(id)` — `paymentTermCreate` / `paymentTermUpdate` / `paymentTermArchive` mutations;
+  `archive` returns `nil` (same convention as `delete`)
+- `client.payments`, `client.payment_requests`, `client.payment_terms` entry points
+  on `Printavo::Client`
+- 11 new `.graphql` files under `lib/printavo/graphql/`
+
 ## [0.9.0] - 2026-03-31
 
 ### Added

data/docs/TODO.md

@@ -243,16 +243,16 @@ return values — they are exposed via model field accessors, not separate resou
 - [ ] `productionFileCreate` / `productionFileCreates` (bulk) mutations
 - [ ] `productionFileDelete` / `productionFileDeletes` (bulk) mutations
 
-### Payments
+### Payments ✅
 
-- [ ] `Printavo::Payment` model (`id`, `amount`, `method`, `paidAt`)
-- [ ] `Printavo::PaymentRequest` model (`id`, `amount`, `sentAt`, `paidAt`, `details`)
-- [ ] `Printavo::PaymentTerm` model (`id`, `name`, `netDays`)
-- [ ] `Payments` resource: `all(order_id:)`, `find(id)`
-- [ ] `PaymentRequests` resource: `all(order_id:)`, `find(id)`, `create`, `delete`
-- [ ] `paymentRequestCreate`, `paymentRequestDelete` mutations
-- [ ] `PaymentTerms` resource: `all`, `find(id)`, `create`, `update`, `archive`
-- [ ] `paymentTermCreate`, `paymentTermUpdate`, `paymentTermArchive` mutations
+- [x] `Printavo::Payment` model (`id`, `amount`, `payment_method`, `paid_at`)
+- [x] `Printavo::PaymentRequest` model (`id`, `amount`, `sent_at`, `paid_at`, `details`)
+- [x] `Printavo::PaymentTerm` model (`id`, `name`, `net_days`)
+- [x] `Payments` resource: `all(order_id:)`, `find(id)`
+- [x] `PaymentRequests` resource: `all(order_id:)`, `find(id)`, `create`, `delete`
+- [x] `paymentRequestCreate`, `paymentRequestDelete` mutations
+- [x] `PaymentTerms` resource: `all`, `find(id)`, `create`, `update`, `archive`
+- [x] `paymentTermCreate`, `paymentTermUpdate`, `paymentTermArchive` mutations
 
 ### Preset Tasks
 
@@ -337,11 +337,11 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `Products` resource + `PricingMatrices` resource
 - [x] `Categories` resource (reference data)
 
-### v0.10.0 — Financial: Payments, Payment Terms & Requests
+### v0.10.0 — Financial: Payments, Payment Terms & Requests ✅
 
-- [ ] `Payments` resource (`all`, `find`)
-- [ ] `PaymentRequests` resource (`all`, `find`, `create`, `delete`)
-- [ ] `PaymentTerms` resource (`all`, `find`, `create`, `update`, `archive`)
+- [x] `Payments` resource (`all`, `find`)
+- [x] `PaymentRequests` resource (`all`, `find`, `create`, `delete`)
+- [x] `PaymentTerms` resource (`all`, `find`, `create`, `update`, `archive`)
 
 ### v0.11.0 — Workflow: Approvals & Preset Tasks
 

data/lib/printavo/client.rb

@@ -97,6 +97,18 @@ module Printavo
       Resources::Orders.new(@graphql)
     end
 
+    def payment_requests
+      Resources::PaymentRequests.new(@graphql)
+    end
+
+    def payment_terms
+      Resources::PaymentTerms.new(@graphql)
+    end
+
+    def payments
+      Resources::Payments.new(@graphql)
+    end
+
     def pricing_matrices
       Resources::PricingMatrices.new(@graphql)
     end

data/lib/printavo/models/payment.rb

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

data/lib/printavo/models/payment_request.rb

@@ -0,0 +1,12 @@
+# lib/printavo/models/payment_request.rb
+# frozen_string_literal: true
+
+module Printavo
+  class PaymentRequest < Models::Base
+    def id      = self['id']
+    def amount  = self['amount']
+    def sent_at = self['sentAt']
+    def paid_at = self['paidAt']
+    def details = self['details']
+  end
+end

data/lib/printavo/models/payment_term.rb

@@ -0,0 +1,10 @@
+# lib/printavo/models/payment_term.rb
+# frozen_string_literal: true
+
+module Printavo
+  class PaymentTerm < Models::Base
+    def id       = self['id']
+    def name     = self['name']
+    def net_days = self['netDays']
+  end
+end

data/lib/printavo/resources/payment_requests.rb

@@ -0,0 +1,48 @@
+# lib/printavo/resources/payment_requests.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class PaymentRequests < Base
+      ALL_QUERY       = File.read(File.join(__dir__, '../graphql/payment_requests/all.graphql')).freeze
+      FIND_QUERY      = File.read(File.join(__dir__, '../graphql/payment_requests/find.graphql')).freeze
+      CREATE_MUTATION = File.read(File.join(__dir__, '../graphql/payment_requests/create.graphql')).freeze
+      DELETE_MUTATION = File.read(File.join(__dir__, '../graphql/payment_requests/delete.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::PaymentRequest.new(data['paymentRequest'])
+      end
+
+      def create(**input)
+        data = @graphql.mutate(CREATE_MUTATION, variables: { input: camelize_keys(input) })
+        Printavo::PaymentRequest.new(data['paymentRequestCreate'])
+      end
+
+      def delete(id)
+        @graphql.mutate(DELETE_MUTATION, variables: { id: id.to_s })
+        nil
+      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']['paymentRequests']['nodes'].map { |attrs| Printavo::PaymentRequest.new(attrs) }
+        page_info = data['order']['paymentRequests']['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/payment_terms.rb

@@ -0,0 +1,51 @@
+# lib/printavo/resources/payment_terms.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class PaymentTerms < Base
+      ALL_QUERY        = File.read(File.join(__dir__, '../graphql/payment_terms/all.graphql')).freeze
+      FIND_QUERY       = File.read(File.join(__dir__, '../graphql/payment_terms/find.graphql')).freeze
+      CREATE_MUTATION  = File.read(File.join(__dir__, '../graphql/payment_terms/create.graphql')).freeze
+      UPDATE_MUTATION  = File.read(File.join(__dir__, '../graphql/payment_terms/update.graphql')).freeze
+      ARCHIVE_MUTATION = File.read(File.join(__dir__, '../graphql/payment_terms/archive.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::PaymentTerm.new(data['paymentTerm'])
+      end
+
+      def create(**input)
+        data = @graphql.mutate(CREATE_MUTATION, variables: { input: camelize_keys(input) })
+        Printavo::PaymentTerm.new(data['paymentTermCreate'])
+      end
+
+      def update(id, **input)
+        data = @graphql.mutate(UPDATE_MUTATION, variables: { id: id.to_s, input: camelize_keys(input) })
+        Printavo::PaymentTerm.new(data['paymentTermUpdate'])
+      end
+
+      def archive(id)
+        @graphql.mutate(ARCHIVE_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['paymentTerms']['nodes'].map { |attrs| Printavo::PaymentTerm.new(attrs) }
+        page_info = data['paymentTerms']['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/payments.rb

@@ -0,0 +1,36 @@
+# lib/printavo/resources/payments.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class Payments < Base
+      ALL_QUERY  = File.read(File.join(__dir__, '../graphql/payments/all.graphql')).freeze
+      FIND_QUERY = File.read(File.join(__dir__, '../graphql/payments/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::Payment.new(data['payment'])
+      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']['payments']['nodes'].map { |attrs| Printavo::Payment.new(attrs) }
+        page_info = data['order']['payments']['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.9.0'
+  VERSION = '0.10.0'
 end

data/lib/printavo.rb

@@ -27,6 +27,9 @@ require_relative 'printavo/models/line_item_group'
 require_relative 'printavo/models/merch_order'
 require_relative 'printavo/models/merch_store'
 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/pricing_matrix'
 require_relative 'printavo/models/product'
 require_relative 'printavo/models/status'
@@ -50,6 +53,9 @@ require_relative 'printavo/resources/line_items'
 require_relative 'printavo/resources/merch_orders'
 require_relative 'printavo/resources/merch_stores'
 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/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.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Stan Carver II
@@ -288,6 +288,9 @@ files:
 - lib/printavo/models/merch_order.rb
 - lib/printavo/models/merch_store.rb
 - lib/printavo/models/order.rb
+- lib/printavo/models/payment.rb
+- lib/printavo/models/payment_request.rb
+- lib/printavo/models/payment_term.rb
 - lib/printavo/models/pricing_matrix.rb
 - lib/printavo/models/product.rb
 - lib/printavo/models/status.rb
@@ -312,6 +315,9 @@ files:
 - lib/printavo/resources/merch_orders.rb
 - lib/printavo/resources/merch_stores.rb
 - lib/printavo/resources/orders.rb
+- lib/printavo/resources/payment_requests.rb
+- lib/printavo/resources/payment_terms.rb
+- lib/printavo/resources/payments.rb
 - lib/printavo/resources/pricing_matrices.rb
 - lib/printavo/resources/products.rb
 - lib/printavo/resources/statuses.rb