printavo-ruby 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b15234d01d31d249e662a33ee862660d1ce0f6ae20894c5ebb5f0ed28b048413
-  data.tar.gz: d00bbeb852bc3ababce742381586ff0dfa0577e936c1ee7ec608de63e2cc0cd1
+  metadata.gz: 3f841fd166476152c647d7851297e8b07a8291446d5ccbe657b3a5c9bb5faef6
+  data.tar.gz: dc74bf793d7c684b4a5aa5f649f3454397a88d684cd8b6f6c7ed3faea0a768a3
 SHA512:
-  metadata.gz: fda95aafcc1ac46908d13a46bac277d39798dcef3999c49286d29ee334ff47c425477baf13be3a6a9bd2a5d70b30ad2f714ec4819938f46b8e54da2489de4df2
-  data.tar.gz: 211f5bddd9598a3254496c2bc82282634ac3208db5784d3e35f2408344864585aebeffd746e2be5f443012b0431e9bd64e7da0fbdf8941397138d55fdaf166e4
+  metadata.gz: 536197cc16cb7faa1ebb1a557563df9954488afc795658bcc6f6cf38d2fa0a0a319f8f04c2842e27921ecc8d627bd4ee15643517bac8e31c39c46607a1d07744
+  data.tar.gz: d7f1654d4294bfab5cb9341a55860cb2ea763f91ba553a7a8982fe1a1199de61e0618e6d9ad2ce6938ead8887be3efc4d5264075bb3ebc0d29eca979c5187315

data/docs/CHANGELOG.md

@@ -6,6 +6,24 @@ 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.9.0] - 2026-03-31
+
+### Added
+- `Printavo::MerchStore` model (`id`, `name`, `url`, `summary`)
+- `MerchStores` resource: `all`, `find(id)`
+- `Printavo::MerchOrder` model (`id`, `status`, `delivery`, `contact` — returns `Printavo::Contact`)
+- `MerchOrders` resource: `all`, `find(id)`
+- `Printavo::Product` model (`id`, `name`, `sku`, `description`)
+- `Products` resource: `all`, `find(id)`
+- `Printavo::PricingMatrix` model (`id`, `name`)
+- `PricingMatrices` resource: `all`, `find(id)`
+- `Printavo::Category` model (`id`, `name`)
+- `Categories` resource: `all`, `find(id)`
+- `client.categories`, `client.merch_orders`, `client.merch_stores`, `client.pricing_matrices`,
+  `client.products` entry points on `Printavo::Client`
+- 10 new `.graphql` files under `lib/printavo/graphql/`
+- 2 new factory files: `spec/support/factories/merch.rb`, `spec/support/factories/product.rb`
+
 ## [0.8.0] - 2026-03-31
 
 ### Added

data/docs/TODO.md

@@ -156,10 +156,10 @@ return values — they are exposed via model field accessors, not separate resou
 - [ ] `approvalRequestRevoke(id:)` mutation
 - [ ] `approvalRequestUnapprove(id:)` mutation
 
-### Categories
+### Categories ✅
 
-- [ ] `Printavo::Category` model (`id`, `name`)
-- [ ] `Categories` resource: `all`, `find(id)` — reference data for products/line items
+- [x] `Printavo::Category` model (`id`, `name`)
+- [x] `Categories` resource: `all`, `find(id)` — reference data for products/line items
 
 ### Contractor Profiles
 
@@ -225,13 +225,13 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `lineItemGroupUpdate` / `lineItemGroupUpdates` (bulk) mutations
 - [x] `lineItemGroupDelete` / `lineItemGroupDeletes` (bulk) mutations
 
-### Merch
+### Merch ✅
 
-- [ ] `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
+- [x] `Printavo::MerchStore` model (`id`, `name`, `url`, `summary`)
+- [x] `Printavo::MerchOrder` model (`id`, `status`, `delivery`, `contact`)
+- [x] `MerchStores` resource: `all`, `find(id)`
+- [x] `MerchOrders` resource: `all`, `find(id)`
+- [x] `client.merch_stores` / `client.merch_orders` entry points
 
 ### Mockups & Production Files
 
@@ -264,12 +264,12 @@ return values — they are exposed via model field accessors, not separate resou
 - [ ] `presetTaskGroupCreate`, `presetTaskGroupUpdate`, `presetTaskGroupDelete` mutations
 - [ ] `presetTaskGroupApply(id:, order_id:)` mutation — applies a group to an order
 
-### Product Catalog & Pricing
+### 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)`
+- [x] `Printavo::Product` model (`id`, `name`, `sku`, `description`)
+- [x] `Printavo::PricingMatrix` model (`id`, `name`)
+- [x] `Products` resource: `all`, `find(id)`
+- [x] `PricingMatrices` resource: `all`, `find(id)`
 
 ### Tasks ✅
 
@@ -331,11 +331,11 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `Fees` resource (`all`, `find`, `create`/`creates`, `update`/`updates`, `delete`/`deletes`)
 - [x] `Expenses` resource (`all`, `find`, `create`, `update`)
 
-### v0.9.0 — Merch, Products & Pricing
+### v0.9.0 — Merch, Products & Pricing ✅
 
-- [ ] `MerchStores` + `MerchOrders` resources
-- [ ] `Products` resource + `PricingMatrices` resource
-- [ ] `Categories` resource (reference data)
+- [x] `MerchStores` + `MerchOrders` resources
+- [x] `Products` resource + `PricingMatrices` resource
+- [x] `Categories` resource (reference data)
 
 ### v0.10.0 — Financial: Payments, Payment Terms & Requests
 

data/lib/printavo/client.rb

@@ -29,6 +29,10 @@ module Printavo
       Resources::Account.new(@graphql)
     end
 
+    def categories
+      Resources::Categories.new(@graphql)
+    end
+
     def contacts
       Resources::Contacts.new(@graphql)
     end
@@ -81,10 +85,26 @@ module Printavo
             'Simply discard the client instance when done.'
     end
 
+    def merch_orders
+      Resources::MerchOrders.new(@graphql)
+    end
+
+    def merch_stores
+      Resources::MerchStores.new(@graphql)
+    end
+
     def orders
       Resources::Orders.new(@graphql)
     end
 
+    def pricing_matrices
+      Resources::PricingMatrices.new(@graphql)
+    end
+
+    def products
+      Resources::Products.new(@graphql)
+    end
+
     def statuses
       Resources::Statuses.new(@graphql)
     end

data/lib/printavo/models/category.rb

@@ -0,0 +1,9 @@
+# lib/printavo/models/category.rb
+# frozen_string_literal: true
+
+module Printavo
+  class Category < Models::Base
+    def id   = self['id']
+    def name = self['name']
+  end
+end

data/lib/printavo/models/merch_order.rb

@@ -0,0 +1,15 @@
+# lib/printavo/models/merch_order.rb
+# frozen_string_literal: true
+
+module Printavo
+  class MerchOrder < Models::Base
+    def id       = self['id']
+    def status   = self['status']
+    def delivery = self['delivery']
+
+    def contact
+      attrs = self['contact']
+      Contact.new(attrs) if attrs
+    end
+  end
+end

data/lib/printavo/models/merch_store.rb

@@ -0,0 +1,11 @@
+# lib/printavo/models/merch_store.rb
+# frozen_string_literal: true
+
+module Printavo
+  class MerchStore < Models::Base
+    def id      = self['id']
+    def name    = self['name']
+    def url     = self['url']
+    def summary = self['summary']
+  end
+end

data/lib/printavo/models/pricing_matrix.rb

@@ -0,0 +1,9 @@
+# lib/printavo/models/pricing_matrix.rb
+# frozen_string_literal: true
+
+module Printavo
+  class PricingMatrix < Models::Base
+    def id   = self['id']
+    def name = self['name']
+  end
+end

data/lib/printavo/models/product.rb

@@ -0,0 +1,11 @@
+# lib/printavo/models/product.rb
+# frozen_string_literal: true
+
+module Printavo
+  class Product < Models::Base
+    def id          = self['id']
+    def name        = self['name']
+    def sku         = self['sku']
+    def description = self['description']
+  end
+end

data/lib/printavo/resources/categories.rb

@@ -0,0 +1,33 @@
+# lib/printavo/resources/categories.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class Categories < Base
+      ALL_QUERY  = File.read(File.join(__dir__, '../graphql/categories/all.graphql')).freeze
+      FIND_QUERY = File.read(File.join(__dir__, '../graphql/categories/find.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::Category.new(data['category'])
+      end
+
+      private
+
+      def fetch_page(first: 25, after: nil, **)
+        data = @graphql.query(ALL_QUERY, variables: { first: first, after: after })
+        nodes = data['categories']['nodes'].map { |attrs| Printavo::Category.new(attrs) }
+        page_info = data['categories']['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/merch_orders.rb

@@ -0,0 +1,33 @@
+# lib/printavo/resources/merch_orders.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class MerchOrders < Base
+      ALL_QUERY  = File.read(File.join(__dir__, '../graphql/merch_orders/all.graphql')).freeze
+      FIND_QUERY = File.read(File.join(__dir__, '../graphql/merch_orders/find.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::MerchOrder.new(data['merchOrder'])
+      end
+
+      private
+
+      def fetch_page(first: 25, after: nil, **)
+        data = @graphql.query(ALL_QUERY, variables: { first: first, after: after })
+        nodes = data['merchOrders']['nodes'].map { |attrs| Printavo::MerchOrder.new(attrs) }
+        page_info = data['merchOrders']['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/merch_stores.rb

@@ -0,0 +1,33 @@
+# lib/printavo/resources/merch_stores.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class MerchStores < Base
+      ALL_QUERY  = File.read(File.join(__dir__, '../graphql/merch_stores/all.graphql')).freeze
+      FIND_QUERY = File.read(File.join(__dir__, '../graphql/merch_stores/find.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::MerchStore.new(data['merchStore'])
+      end
+
+      private
+
+      def fetch_page(first: 25, after: nil, **)
+        data = @graphql.query(ALL_QUERY, variables: { first: first, after: after })
+        nodes = data['merchStores']['nodes'].map { |attrs| Printavo::MerchStore.new(attrs) }
+        page_info = data['merchStores']['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/pricing_matrices.rb

@@ -0,0 +1,33 @@
+# lib/printavo/resources/pricing_matrices.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class PricingMatrices < Base
+      ALL_QUERY  = File.read(File.join(__dir__, '../graphql/pricing_matrices/all.graphql')).freeze
+      FIND_QUERY = File.read(File.join(__dir__, '../graphql/pricing_matrices/find.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::PricingMatrix.new(data['pricingMatrix'])
+      end
+
+      private
+
+      def fetch_page(first: 25, after: nil, **)
+        data = @graphql.query(ALL_QUERY, variables: { first: first, after: after })
+        nodes = data['pricingMatrices']['nodes'].map { |attrs| Printavo::PricingMatrix.new(attrs) }
+        page_info = data['pricingMatrices']['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/products.rb

@@ -0,0 +1,33 @@
+# lib/printavo/resources/products.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class Products < Base
+      ALL_QUERY  = File.read(File.join(__dir__, '../graphql/products/all.graphql')).freeze
+      FIND_QUERY = File.read(File.join(__dir__, '../graphql/products/find.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::Product.new(data['product'])
+      end
+
+      private
+
+      def fetch_page(first: 25, after: nil, **)
+        data = @graphql.query(ALL_QUERY, variables: { first: first, after: after })
+        nodes = data['products']['nodes'].map { |attrs| Printavo::Product.new(attrs) }
+        page_info = data['products']['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.8.0'
+  VERSION = '0.9.0'
 end

data/lib/printavo.rb

@@ -6,47 +6,57 @@ require 'faraday/retry'
 require 'json'
 
 require_relative 'printavo/version'
-require_relative 'printavo/errors'
 require_relative 'printavo/config'
 require_relative 'printavo/connection'
+require_relative 'printavo/errors'
 require_relative 'printavo/graphql_client'
 require_relative 'printavo/page'
 require_relative 'printavo/models/base'
 require_relative 'printavo/models/account'
+require_relative 'printavo/models/category'
 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/expense'
 require_relative 'printavo/models/fee'
 require_relative 'printavo/models/imprint'
 require_relative 'printavo/models/inquiry'
+require_relative 'printavo/models/invoice'
+require_relative 'printavo/models/job'
 require_relative 'printavo/models/line_item'
 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/pricing_matrix'
+require_relative 'printavo/models/product'
+require_relative 'printavo/models/status'
 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/categories'
 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'
 require_relative 'printavo/resources/expenses'
 require_relative 'printavo/resources/fees'
 require_relative 'printavo/resources/imprints'
 require_relative 'printavo/resources/inquiries'
+require_relative 'printavo/resources/invoices'
+require_relative 'printavo/resources/jobs'
 require_relative 'printavo/resources/line_item_groups'
 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/pricing_matrices'
+require_relative 'printavo/resources/products'
+require_relative 'printavo/resources/statuses'
 require_relative 'printavo/resources/tasks'
 require_relative 'printavo/resources/threads'
-require_relative 'printavo/resources/transactions'
 require_relative 'printavo/resources/transaction_payments'
+require_relative 'printavo/resources/transactions'
 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.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Stan Carver II
@@ -274,6 +274,7 @@ files:
 - lib/printavo/graphql_client.rb
 - lib/printavo/models/account.rb
 - lib/printavo/models/base.rb
+- lib/printavo/models/category.rb
 - lib/printavo/models/contact.rb
 - lib/printavo/models/customer.rb
 - lib/printavo/models/expense.rb
@@ -284,7 +285,11 @@ files:
 - lib/printavo/models/job.rb
 - lib/printavo/models/line_item.rb
 - lib/printavo/models/line_item_group.rb
+- lib/printavo/models/merch_order.rb
+- lib/printavo/models/merch_store.rb
 - lib/printavo/models/order.rb
+- lib/printavo/models/pricing_matrix.rb
+- lib/printavo/models/product.rb
 - lib/printavo/models/status.rb
 - lib/printavo/models/task.rb
 - lib/printavo/models/thread.rb
@@ -293,6 +298,7 @@ files:
 - lib/printavo/page.rb
 - lib/printavo/resources/account.rb
 - lib/printavo/resources/base.rb
+- lib/printavo/resources/categories.rb
 - lib/printavo/resources/contacts.rb
 - lib/printavo/resources/customers.rb
 - lib/printavo/resources/expenses.rb
@@ -303,7 +309,11 @@ files:
 - lib/printavo/resources/jobs.rb
 - lib/printavo/resources/line_item_groups.rb
 - lib/printavo/resources/line_items.rb
+- lib/printavo/resources/merch_orders.rb
+- lib/printavo/resources/merch_stores.rb
 - lib/printavo/resources/orders.rb
+- lib/printavo/resources/pricing_matrices.rb
+- lib/printavo/resources/products.rb
 - lib/printavo/resources/statuses.rb
 - lib/printavo/resources/tasks.rb
 - lib/printavo/resources/threads.rb