printavo-ruby 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 07267da7ecd92123f50dab320f34dd59d32ceeb43a22421d561ec9adb92f04cb
-  data.tar.gz: b30f9770630423fca2c7ec5f5d632b5e87c48447d34f485e1c4ce9bdccf88bf4
+  metadata.gz: d38801721464e49c62cf1f1c691c157e8ef2f1e7fd09c9a7490520191a760a4f
+  data.tar.gz: 452da693c947df1df1535500644ceed9263275c3e1afa856bdaba85fabbccba9
 SHA512:
-  metadata.gz: 2b2421014c3991017e1ed9a626680ab685bfc182af243e690959190d0ee2ee7d08aef65c77cb9f209a77a62a8807af67b4e4da3138270b616ec4042ab78f9228
-  data.tar.gz: 5ed669d1ef3f544e92033862894868d567b2e8b53004f8d0c71a967acf8a1955bdfbbe3086316209b37b803be82e8dcc84fd8144200250bb397b2e857d773624
+  metadata.gz: e8e46f1df1bf4aaa1ebc4b4addf6b70e924e330fd29610a3f175f7e0d6ae222a082962d45facf65d7fb7b708155f718b35a86c58a1ac23629a522095ad391535
+  data.tar.gz: 23ca5c52505288f5f6fcdf138af7f0441ee2c9c7702e0ffd972b40e8f8702a4ea072c65e96a070ebf0845c2bf79130f4ea70c93b7df28299cc5a2790fc6c37d8

data/docs/CHANGELOG.md

@@ -6,6 +6,25 @@ 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.13.0] - 2026-03-31
+
+### Added
+- `Printavo::User` model (`id`, `first_name`, `last_name`, `email`, `full_name`)
+- `Users` resource: `all`, `find(id)` — shop staff members
+- `Printavo::Vendor` model (`id`, `name`, `email`, `phone`)
+- `Vendors` resource: `all`, `find(id)` — read-only
+- `Printavo::ContractorProfile` model (`id`, `name`, `email`)
+- `ContractorProfiles` resource: `all`, `find(id)`
+- `Printavo::DeliveryMethod` model (`id`, `name`)
+- `DeliveryMethods` resource: `all`, `find(id)`, `create(**input)`, `update(id, **input)`, `archive(id)`
+- `deliveryMethodCreate`, `deliveryMethodUpdate`, `deliveryMethodArchive` mutations
+- `Printavo::TypeOfWork` model (`id`, `name`)
+- `TypesOfWork` resource: `all` — reference data for order categorization
+- `client.contractor_profiles`, `client.delivery_methods`, `client.types_of_work`,
+  `client.users`, `client.vendors` entry points on `Printavo::Client`
+- 11 new `.graphql` files under `lib/printavo/graphql/`
+- 1 new factory file: `spec/support/factories/people.rb`
+
 ## [0.12.0] - 2026-03-31
 
 ### Added

data/docs/TODO.md

@@ -161,10 +161,10 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `Printavo::Category` model (`id`, `name`)
 - [x] `Categories` resource: `all`, `find(id)` — reference data for products/line items
 
-### Contractor Profiles
+### Contractor Profiles ✅
 
-- [ ] `Printavo::ContractorProfile` model (`id`, `name`, `email`)
-- [ ] `ContractorProfiles` resource: `all`, `find(id)` — contractors assignable to invoices
+- [x] `Printavo::ContractorProfile` model (`id`, `name`, `email`)
+- [x] `ContractorProfiles` resource: `all`, `find(id)` — contractors assignable to invoices
 
 ### Custom Addresses ✅
 
@@ -174,11 +174,11 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `customAddressUpdate` / `customAddressUpdates` (bulk) mutations
 - [x] `customAddressDelete` / `customAddressDeletes` (bulk) mutations
 
-### Delivery Methods
+### Delivery Methods ✅
 
-- [ ] `Printavo::DeliveryMethod` model (`id`, `name`)
-- [ ] `DeliveryMethods` resource: `all`, `find(id)`, `create`, `update`, `archive`
-- [ ] `deliveryMethodCreate`, `deliveryMethodUpdate`, `deliveryMethodArchive` mutations
+- [x] `Printavo::DeliveryMethod` model (`id`, `name`)
+- [x] `DeliveryMethods` resource: `all`, `find(id)`, `create`, `update`, `archive`
+- [x] `deliveryMethodCreate`, `deliveryMethodUpdate`, `deliveryMethodArchive` mutations
 
 ### Email Templates ✅
 
@@ -292,20 +292,20 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `TransactionPayments` resource: `create`, `update`, `delete`
 - [x] `transactionPaymentCreate`, `transactionPaymentUpdate`, `transactionPaymentDelete` mutations
 
-### Types of Work
+### Types of Work ✅
 
-- [ ] `Printavo::TypeOfWork` model (`id`, `name`)
-- [ ] `TypesOfWork` resource: `all` — reference data for order categorization
+- [x] `Printavo::TypeOfWork` model (`id`, `name`)
+- [x] `TypesOfWork` resource: `all` — reference data for order categorization
 
-### Users
+### Users ✅
 
-- [ ] `Printavo::User` model (`id`, `firstName`, `lastName`, `email`, `avatar`, `permissions`)
-- [ ] `Users` resource: `all`, `find(id)` — shop staff members
+- [x] `Printavo::User` model (`id`, `first_name`, `last_name`, `email`, `full_name`)
+- [x] `Users` resource: `all`, `find(id)` — shop staff members
 
-### Vendors
+### Vendors ✅
 
-- [ ] `Printavo::Vendor` model (`id`, `name`, `email`, `phone`)
-- [ ] `Vendors` resource: `all`, `find(id)` — read-only; no create/update/delete in V2 API
+- [x] `Printavo::Vendor` model (`id`, `name`, `email`, `phone`)
+- [x] `Vendors` resource: `all`, `find(id)` — read-only; no create/update/delete in V2 API
 
 ---
 
@@ -356,13 +356,13 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `EmailTemplates` resource (`all`, `find`)
 - [x] `CustomAddresses` resource (`all`, `find`, `create`/`creates`, `update`/`updates`, `delete`/`deletes`)
 
-### v0.13.0 — People, Orgs & Reference Data
+### v0.13.0 — People, Orgs & Reference Data ✅
 
-- [ ] `Users` resource (`all`, `find`)
-- [ ] `Vendors` resource (`all`, `find`) — read-only
-- [ ] `ContractorProfiles` resource (`all`, `find`)
-- [ ] `DeliveryMethods` resource (`all`, `find`, `create`, `update`, `archive`)
-- [ ] `TypesOfWork` resource (`all`)
+- [x] `Users` resource (`all`, `find`)
+- [x] `Vendors` resource (`all`, `find`) — read-only
+- [x] `ContractorProfiles` resource (`all`, `find`)
+- [x] `DeliveryMethods` resource (`all`, `find`, `create`, `update`, `archive`)
+- [x] `TypesOfWork` resource (`all`)
 
 ### v0.14.0 — Delete & Duplicate Mutations for Shipped Resources
 

data/lib/printavo/client.rb

@@ -41,6 +41,10 @@ module Printavo
       Resources::Contacts.new(@graphql)
     end
 
+    def contractor_profiles
+      Resources::ContractorProfiles.new(@graphql)
+    end
+
     def custom_addresses
       Resources::CustomAddresses.new(@graphql)
     end
@@ -49,6 +53,10 @@ module Printavo
       Resources::Customers.new(@graphql)
     end
 
+    def delivery_methods
+      Resources::DeliveryMethods.new(@graphql)
+    end
+
     def email_templates
       Resources::EmailTemplates.new(@graphql)
     end
@@ -164,5 +172,17 @@ module Printavo
     def transactions
       Resources::Transactions.new(@graphql)
     end
+
+    def types_of_work
+      Resources::TypesOfWork.new(@graphql)
+    end
+
+    def users
+      Resources::Users.new(@graphql)
+    end
+
+    def vendors
+      Resources::Vendors.new(@graphql)
+    end
   end
 end

data/lib/printavo/models/contractor_profile.rb

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

data/lib/printavo/models/delivery_method.rb

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

data/lib/printavo/models/type_of_work.rb

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

data/lib/printavo/models/user.rb

@@ -0,0 +1,12 @@
+# lib/printavo/models/user.rb
+# frozen_string_literal: true
+
+module Printavo
+  class User < Models::Base
+    def id         = self['id']
+    def first_name = self['firstName']
+    def last_name  = self['lastName']
+    def email      = self['email']
+    def full_name  = "#{first_name} #{last_name}".strip
+  end
+end

data/lib/printavo/models/vendor.rb

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

data/lib/printavo/resources/contractor_profiles.rb

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

@@ -0,0 +1,51 @@
+# lib/printavo/resources/delivery_methods.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Resources
+    class DeliveryMethods < Base
+      ALL_QUERY        = File.read(File.join(__dir__, '../graphql/delivery_methods/all.graphql')).freeze
+      FIND_QUERY       = File.read(File.join(__dir__, '../graphql/delivery_methods/find.graphql')).freeze
+      CREATE_MUTATION  = File.read(File.join(__dir__, '../graphql/delivery_methods/create.graphql')).freeze
+      UPDATE_MUTATION  = File.read(File.join(__dir__, '../graphql/delivery_methods/update.graphql')).freeze
+      ARCHIVE_MUTATION = File.read(File.join(__dir__, '../graphql/delivery_methods/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::DeliveryMethod.new(data['deliveryMethod'])
+      end
+
+      def create(**input)
+        data = @graphql.mutate(CREATE_MUTATION, variables: { input: camelize_keys(input) })
+        Printavo::DeliveryMethod.new(data['deliveryMethodCreate'])
+      end
+
+      def update(id, **input)
+        data = @graphql.mutate(UPDATE_MUTATION, variables: { id: id.to_s, input: camelize_keys(input) })
+        Printavo::DeliveryMethod.new(data['deliveryMethodUpdate'])
+      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['deliveryMethods']['nodes'].map { |attrs| Printavo::DeliveryMethod.new(attrs) }
+        page_info = data['deliveryMethods']['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/types_of_work.rb

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

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

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

data/lib/printavo.rb

@@ -16,8 +16,10 @@ 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/contractor_profile'
 require_relative 'printavo/models/custom_address'
 require_relative 'printavo/models/customer'
+require_relative 'printavo/models/delivery_method'
 require_relative 'printavo/models/email_template'
 require_relative 'printavo/models/expense'
 require_relative 'printavo/models/fee'
@@ -44,13 +46,18 @@ require_relative 'printavo/models/task'
 require_relative 'printavo/models/thread'
 require_relative 'printavo/models/transaction'
 require_relative 'printavo/models/transaction_payment'
+require_relative 'printavo/models/type_of_work'
+require_relative 'printavo/models/user'
+require_relative 'printavo/models/vendor'
 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/contractor_profiles'
 require_relative 'printavo/resources/custom_addresses'
 require_relative 'printavo/resources/customers'
+require_relative 'printavo/resources/delivery_methods'
 require_relative 'printavo/resources/email_templates'
 require_relative 'printavo/resources/expenses'
 require_relative 'printavo/resources/fees'
@@ -77,6 +84,9 @@ require_relative 'printavo/resources/tasks'
 require_relative 'printavo/resources/threads'
 require_relative 'printavo/resources/transaction_payments'
 require_relative 'printavo/resources/transactions'
+require_relative 'printavo/resources/types_of_work'
+require_relative 'printavo/resources/users'
+require_relative 'printavo/resources/vendors'
 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.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Stan Carver II
@@ -277,8 +277,10 @@ files:
 - lib/printavo/models/base.rb
 - lib/printavo/models/category.rb
 - lib/printavo/models/contact.rb
+- lib/printavo/models/contractor_profile.rb
 - lib/printavo/models/custom_address.rb
 - lib/printavo/models/customer.rb
+- lib/printavo/models/delivery_method.rb
 - lib/printavo/models/email_template.rb
 - lib/printavo/models/expense.rb
 - lib/printavo/models/fee.rb
@@ -305,14 +307,19 @@ files:
 - lib/printavo/models/thread.rb
 - lib/printavo/models/transaction.rb
 - lib/printavo/models/transaction_payment.rb
+- lib/printavo/models/type_of_work.rb
+- lib/printavo/models/user.rb
+- lib/printavo/models/vendor.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
+- lib/printavo/resources/contractor_profiles.rb
 - lib/printavo/resources/custom_addresses.rb
 - lib/printavo/resources/customers.rb
+- lib/printavo/resources/delivery_methods.rb
 - lib/printavo/resources/email_templates.rb
 - lib/printavo/resources/expenses.rb
 - lib/printavo/resources/fees.rb
@@ -339,6 +346,9 @@ files:
 - lib/printavo/resources/threads.rb
 - lib/printavo/resources/transaction_payments.rb
 - lib/printavo/resources/transactions.rb
+- lib/printavo/resources/types_of_work.rb
+- lib/printavo/resources/users.rb
+- lib/printavo/resources/vendors.rb
 - lib/printavo/version.rb
 - lib/printavo/webhooks.rb
 homepage: https://github.com/scarver2/printavo-ruby