printavo-ruby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f47615b00a6d63bc35e5d5cc74e5e8d591fe38218eadd0bb76e11798626f9f42
+  data.tar.gz: aa6d86cb12b1ea7617c8d97093993252fc30f1401fef8893263ed2ba4f277a48
+SHA512:
+  metadata.gz: '08fa3eb45c8ddef4ff5962c9bd59d01c14048d2c68fefb1b3e6ee526b6e4317b225958b5ed8865ba45fb42b35ef14d1c8f235a81b90a3c11e1e4dd661e2c1aa4'
+  data.tar.gz: 93ef9341891c36ab6ffa9fd61a9790b16662072a7ecb4bf733d6aa0f5cd9fe99ee75c77a47be7a023909b7468fb70abec3a8d5b076925a732c3cd8c6389ec1b6

data/CHANGELOG.md

@@ -0,0 +1,33 @@
+<!-- CHANGELOG.md -->
+# Changelog
+
+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).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-03-29
+
+### Added
+- `Printavo::Client` — instance-based, multi-client capable entry point
+- `Printavo::Resources::Customers` — `all` and `find` via GraphQL
+- `Printavo::Resources::Orders` — `all` and `find` with status + customer association
+- `Printavo::Resources::Jobs` — `all` (by order) and `find` line item queries
+- `Printavo::Customer`, `Printavo::Order`, `Printavo::Job` — rich domain models
+- `Printavo::Order#status?` — dynamic status predicate (handles user-defined statuses)
+- `Printavo::GraphqlClient` — raw GraphQL query/mutation interface
+- `Printavo::Webhooks.verify` — Rack-compatible HMAC-SHA256 signature verification
+- Error hierarchy: `AuthenticationError`, `RateLimitError`, `NotFoundError`, `ApiError`
+- Faraday connection with retry middleware (max 2 retries; 429/5xx)
+- RSpec test suite — 62 examples, 100% line coverage with VCR + WebMock + Faker sanitization
+- Coveralls coverage badge (LCOV via `simplecov-lcov`)
+- Guard + RuboCop DX setup with `bin/spec` multi-Ruby local runner
+- GitHub Actions CI: Ruby 3.3 (primary) + Ruby 4.0 (`continue-on-error`)
+- Automated RubyGems publish on `v*` tag via `release.yml`
+- `docs/CACHING.md` — nine caching strategy patterns for rate-limit-aware consumers
+
+---
+
+— Stan Carver II / Made in Texas 🤠 / https://stancarver.com

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stan Carver II
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,252 @@
+<!-- README.md -->
+
+<p align="center">
+  <img src="docs/printavo-ruby.png" alt="printavo-ruby" width="640">
+</p>
+
+# printavo-ruby
+
+[![CI](https://github.com/scarver2/printavo-ruby/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/scarver2/printavo-ruby/actions/workflows/ci.yml)
+[![Coverage Status](https://coveralls.io/repos/github/scarver2/printavo-ruby/badge.svg?branch=master)](https://coveralls.io/github/scarver2/printavo-ruby?branch=master)
+[![Gem Version](https://badge.fury.io/rb/printavo-ruby.svg)](https://badge.fury.io/rb/printavo-ruby)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+A framework-agnostic Ruby SDK for the [Printavo](https://www.printavo.com) GraphQL API (v2).
+
+> I use Printavo every day at [Texas Embroidery Ranch](https://texasembroideryranch.com). This gem was created to bridge Printavo
+> with other operational systems—CRM, marketing, finance, and automation—so that print shops
+> can build integrated workflows without writing raw GraphQL by hand.
+
+## Features
+
+- Full [Printavo v2 GraphQL API](https://www.printavo.com/docs/api/v2) support
+- Resource-oriented interface: `client.customers.all`, `client.orders.find(id)`
+- Raw GraphQL access: `client.graphql.query("{ ... }")`
+- Rich domain models: `order.status`, `order.status?(:in_production)`, `order.customer`
+- Rack-compatible webhook signature verification
+- Multi-client support — no globals required
+- Ruby 3.0+ required
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "printavo-ruby"
+```
+or
+
+```bash
+bundle add printavo-ruby
+```
+
+or install directly:
+
+```bash
+gem install printavo-ruby
+```
+
+## Authentication
+
+Printavo authenticates via your account **email** and **API token**
+(found at My Account → API Token on [printavo.com](https://www.printavo.com)).
+
+```ruby
+require "printavo"
+
+client = Printavo::Client.new(
+  email: ENV["PRINTAVO_EMAIL"],
+  token: ENV["PRINTAVO_TOKEN"]
+)
+```
+
+### Rails Initializer
+
+```ruby
+# config/initializers/printavo.rb
+PRINTAVO = Printavo::Client.new(
+  email: ENV["PRINTAVO_EMAIL"],
+  token: ENV["PRINTAVO_TOKEN"]
+)
+```
+
+## Usage
+
+### Customers
+
+```ruby
+# List customers (25 per page by default)
+customers = client.customers.all
+customers.each { |c| puts "#{c.full_name} — #{c.email}" }
+
+# Paginate
+page_2 = client.customers.all(first: 25, after: cursor)
+
+# Find a specific customer
+customer = client.customers.find("12345")
+puts customer.full_name   # => "Jane Smith"
+puts customer.company     # => "Acme Shirts"
+```
+
+### Orders
+
+```ruby
+# List orders
+orders = client.orders.all
+orders.each { |o| puts "#{o.nickname}: #{o.status}" }
+
+# Find an order
+order = client.orders.find("99")
+puts order.status                    # => "In Production"
+puts order.status_key                # => :in_production
+puts order.status?(:in_production)   # => true
+puts order.total_price               # => "1250.00"
+puts order.customer.full_name        # => "Bob Johnson"
+```
+
+### Jobs (Line Items)
+
+```ruby
+# List jobs for an order
+jobs = client.jobs.all(order_id: "99")
+jobs.each { |j| puts "#{j.name} x#{j.quantity} @ #{j.price}" }
+
+# Find a specific job
+job = client.jobs.find("77")
+puts job.taxable?   # => true
+```
+
+### Raw GraphQL
+
+For queries not yet wrapped by a resource, use the raw GraphQL client directly:
+
+```ruby
+result = client.graphql.query(<<~GQL)
+  {
+    customers(first: 5) {
+      nodes {
+        id
+        firstName
+        lastName
+      }
+    }
+  }
+GQL
+
+result["customers"]["nodes"].each { |c| puts c["firstName"] }
+```
+
+With variables:
+
+```ruby
+result = client.graphql.query(
+  "query Customer($id: ID!) { customer(id: $id) { id email } }",
+  variables: { id: "42" }
+)
+```
+
+## Webhooks
+
+`Printavo::Webhooks.verify` provides Rack-compatible HMAC-SHA256 signature verification.
+No extra dependencies required.
+
+```ruby
+# Pure Ruby / Rack
+valid = Printavo::Webhooks.verify(
+  signature,  # X-Printavo-Signature header value
+  payload,    # raw request body string
+  secret      # your webhook secret
+)
+```
+
+### Rails Controller Example
+
+```ruby
+class WebhooksController < ApplicationController
+  skip_before_action :verify_authenticity_token
+
+  def printavo
+    if Printavo::Webhooks.verify(
+         request.headers["X-Printavo-Signature"],
+         request.raw_post,
+         ENV["PRINTAVO_WEBHOOK_SECRET"]
+       )
+      event = JSON.parse(request.raw_post)
+      # process event["type"] ...
+      head :ok
+    else
+      head :unauthorized
+    end
+  end
+end
+```
+
+## Error Handling
+
+```ruby
+begin
+  client.orders.find("not_a_real_id")
+rescue Printavo::AuthenticationError => e
+  # Bad email/token
+rescue Printavo::RateLimitError => e
+  # Exceeded 10 req/5 sec — back off and retry
+rescue Printavo::NotFoundError => e
+  # Resource doesn't exist
+rescue Printavo::ApiError => e
+  # GraphQL error — e.message contains details, e.response has raw data
+rescue Printavo::Error => e
+  # Catch-all for any Printavo error
+end
+```
+
+## Versioning Roadmap
+
+| Version | Milestone |
+|---|---|
+| 0.1.0 | Auth + Customers + Orders + Jobs |
+| 0.2.0 | Status registry + Analytics/Reporting |
+| 0.3.0 | Webhooks (Rack-compatible) |
+| 0.4.0 | Expanded GraphQL DSL |
+| 0.5.0 | Mutations (create/update) |
+| 0.6.0 | Community burn-in / API stabilization |
+| 0.7.0 | Pagination abstraction helpers |
+| 0.8.0 | Retry/backoff + rate limit awareness |
+| 0.9.0 | Community feedback + API freeze |
+| 1.0.0 | Stable public SDK |
+
+**Rules**: `PATCH` = bug fix · `MINOR` = new backward-compatible feature · `MAJOR` = breaking change
+
+## API Documentation
+
+- [Printavo v2 API Reference](https://www.printavo.com/docs/api/v2)
+- [Printavo GraphQL API Blog Post](https://www.printavo.com/blog/new-graphql-api/)
+
+## Development
+
+```bash
+git clone https://github.com/scarver2/printavo-ruby.git
+cd printavo-ruby
+bundle install
+
+# Run specs
+bundle exec rspec
+
+# Lint
+bundle exec rubocop
+
+# Guard DX (watches files, re-runs tests + lint on save)
+bundle exec guard
+
+# Interactive console
+PRINTAVO_EMAIL=you@example.com PRINTAVO_TOKEN=your_token bin/console
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for full contribution guidelines.
+
+## Colophon
+
+[MIT License](LICENSE)
+
+&copy;2026 [Stan Carver II](https://stancarver.com)
+
+![Made in Texas](https://raw.githubusercontent.com/scarver2/howdy-world/master/_dashboard/www/assets/made-in-texas.png)

data/lib/printavo/client.rb

@@ -0,0 +1,38 @@
+# lib/printavo/client.rb
+module Printavo
+  class Client
+    attr_reader :graphql
+
+    # Creates a new Printavo API client. Each instance is independent —
+    # multiple clients with different credentials can coexist in one process.
+    #
+    # @param email   [String] the email address associated with your Printavo account
+    # @param token   [String] the API token from your Printavo My Account page
+    # @param timeout [Integer] HTTP timeout in seconds (default: 30)
+    #
+    # @example
+    #   client = Printavo::Client.new(
+    #     email: ENV["PRINTAVO_EMAIL"],
+    #     token: ENV["PRINTAVO_TOKEN"]
+    #   )
+    #   client.customers.all
+    #   client.orders.find("12345")
+    #   client.graphql.query("{ customers { nodes { id } } }")
+    def initialize(email:, token:, timeout: 30)
+      connection = Connection.new(email: email, token: token, timeout: timeout).build
+      @graphql   = GraphqlClient.new(connection)
+    end
+
+    def customers
+      Resources::Customers.new(@graphql)
+    end
+
+    def orders
+      Resources::Orders.new(@graphql)
+    end
+
+    def jobs
+      Resources::Jobs.new(@graphql)
+    end
+  end
+end

data/lib/printavo/config.rb

@@ -0,0 +1,13 @@
+# lib/printavo/config.rb
+module Printavo
+  class Config
+    attr_accessor :email, :token, :base_url, :timeout
+
+    BASE_URL = 'https://www.printavo.com/api/v2'.freeze
+
+    def initialize
+      @base_url = BASE_URL
+      @timeout  = 30
+    end
+  end
+end

data/lib/printavo/connection.rb

@@ -0,0 +1,31 @@
+# lib/printavo/connection.rb
+require 'faraday'
+require 'faraday/retry'
+
+module Printavo
+  class Connection
+    def initialize(email:, token:, base_url: Config::BASE_URL, timeout: 30)
+      @email    = email
+      @token    = token
+      @base_url = base_url
+      @timeout  = timeout
+    end
+
+    def build
+      Faraday.new(url: @base_url) do |f|
+        f.headers['Content-Type'] = 'application/json'
+        f.headers['Accept']       = 'application/json'
+        f.headers['email']        = @email
+        f.headers['token']        = @token
+
+        f.request :retry, max: 2, interval: 0.5, retry_statuses: [429, 500, 502, 503]
+
+        f.response :json
+        f.options.timeout      = @timeout
+        f.options.open_timeout = @timeout
+
+        f.adapter Faraday.default_adapter
+      end
+    end
+  end
+end

data/lib/printavo/errors.rb

@@ -0,0 +1,19 @@
+# lib/printavo/errors.rb
+module Printavo
+  class Error < StandardError; end
+
+  class AuthenticationError < Error; end
+
+  class RateLimitError < Error; end
+
+  class NotFoundError < Error; end
+
+  class ApiError < Error
+    attr_reader :response
+
+    def initialize(message, response: nil)
+      super(message)
+      @response = response
+    end
+  end
+end

data/lib/printavo/graphql_client.rb

@@ -0,0 +1,38 @@
+# lib/printavo/graphql_client.rb
+require 'json'
+
+module Printavo
+  class GraphqlClient
+    def initialize(connection)
+      @connection = connection
+    end
+
+    def query(query_string, variables: {})
+      response = @connection.post('') do |req|
+        req.body = JSON.generate(query: query_string, variables: variables)
+      end
+
+      handle_response(response)
+    end
+
+    private
+
+    def handle_response(response)
+      body = response.body
+
+      case response.status
+      when 401 then raise AuthenticationError, 'Invalid credentials — check your email and token'
+      when 429 then raise RateLimitError, 'Printavo rate limit exceeded (10 req/5 sec)'
+      when 404 then raise NotFoundError, 'Resource not found'
+      end
+
+      errors = body.is_a?(Hash) ? body['errors'] : nil
+      if errors&.any?
+        messages = errors.map { |e| e['message'] }.join(', ')
+        raise ApiError.new(messages, response: body)
+      end
+
+      body.is_a?(Hash) ? body['data'] : body
+    end
+  end
+end

data/lib/printavo/models/base.rb

@@ -0,0 +1,34 @@
+# lib/printavo/models/base.rb
+module Printavo
+  module Models
+    class Base
+      def initialize(attributes = {})
+        @attributes = (attributes || {}).transform_keys(&:to_s)
+      end
+
+      def [](key)
+        @attributes[key.to_s]
+      end
+
+      def dig(*keys)
+        keys.map(&:to_s).reduce(@attributes) do |obj, key|
+          break nil unless obj.is_a?(Hash)
+
+          obj[key]
+        end
+      end
+
+      def to_h
+        @attributes.dup
+      end
+
+      def ==(other)
+        other.is_a?(self.class) && other.to_h == to_h
+      end
+
+      def inspect
+        "#<#{self.class.name} #{@attributes.inspect}>"
+      end
+    end
+  end
+end

data/lib/printavo/models/customer.rb

@@ -0,0 +1,15 @@
+# lib/printavo/models/customer.rb
+module Printavo
+  class Customer < 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 company    = self['company']
+
+    def full_name
+      [first_name, last_name].compact.join(' ').strip
+    end
+  end
+end

data/lib/printavo/models/job.rb

@@ -0,0 +1,14 @@
+# lib/printavo/models/job.rb
+module Printavo
+  class Job < Models::Base
+    def id       = self['id']
+    def name     = self['name']
+    def quantity = self['quantity']
+    def price    = self['price']
+    def taxable  = self['taxable']
+
+    def taxable?
+      taxable == true
+    end
+  end
+end

data/lib/printavo/models/order.rb

@@ -0,0 +1,27 @@
+# lib/printavo/models/order.rb
+module Printavo
+  class Order < Models::Base
+    def id          = self['id']
+    def nickname    = self['nickname']
+    def total_price = self['totalPrice']
+
+    def status
+      dig('status', 'name')
+    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 customer
+      attrs = self['customer']
+      Customer.new(attrs) if attrs
+    end
+  end
+end

data/lib/printavo/resources/base.rb

@@ -0,0 +1,10 @@
+# lib/printavo/resources/base.rb
+module Printavo
+  module Resources
+    class Base
+      def initialize(graphql)
+        @graphql = graphql
+      end
+    end
+  end
+end

data/lib/printavo/resources/customers.rb

@@ -0,0 +1,48 @@
+# lib/printavo/resources/customers.rb
+module Printavo
+  module Resources
+    class Customers < Base
+      ALL_QUERY = <<~GQL.freeze
+        query Customers($first: Int, $after: String) {
+          customers(first: $first, after: $after) {
+            nodes {
+              id
+              firstName
+              lastName
+              email
+              phone
+              company
+            }
+            pageInfo {
+              hasNextPage
+              endCursor
+            }
+          }
+        }
+      GQL
+
+      FIND_QUERY = <<~GQL.freeze
+        query Customer($id: ID!) {
+          customer(id: $id) {
+            id
+            firstName
+            lastName
+            email
+            phone
+            company
+          }
+        }
+      GQL
+
+      def all(first: 25, after: nil)
+        data = @graphql.query(ALL_QUERY, variables: { first: first, after: after })
+        data['customers']['nodes'].map { |attrs| Printavo::Customer.new(attrs) }
+      end
+
+      def find(id)
+        data = @graphql.query(FIND_QUERY, variables: { id: id.to_s })
+        Printavo::Customer.new(data['customer'])
+      end
+    end
+  end
+end

data/lib/printavo/resources/jobs.rb

@@ -0,0 +1,48 @@
+# lib/printavo/resources/jobs.rb
+module Printavo
+  module Resources
+    class Jobs < Base
+      ALL_QUERY = <<~GQL.freeze
+        query LineItems($orderId: ID!, $first: Int, $after: String) {
+          order(id: $orderId) {
+            lineItems(first: $first, after: $after) {
+              nodes {
+                id
+                name
+                quantity
+                price
+                taxable
+              }
+              pageInfo {
+                hasNextPage
+                endCursor
+              }
+            }
+          }
+        }
+      GQL
+
+      FIND_QUERY = <<~GQL.freeze
+        query LineItem($id: ID!) {
+          lineItem(id: $id) {
+            id
+            name
+            quantity
+            price
+            taxable
+          }
+        }
+      GQL
+
+      def all(order_id:, first: 25, after: nil)
+        data = @graphql.query(ALL_QUERY, variables: { orderId: order_id.to_s, first: first, after: after })
+        data['order']['lineItems']['nodes'].map { |attrs| Printavo::Job.new(attrs) }
+      end
+
+      def find(id)
+        data = @graphql.query(FIND_QUERY, variables: { id: id.to_s })
+        Printavo::Job.new(data['lineItem'])
+      end
+    end
+  end
+end

data/lib/printavo/resources/orders.rb

@@ -0,0 +1,64 @@
+# lib/printavo/resources/orders.rb
+module Printavo
+  module Resources
+    class Orders < Base
+      ALL_QUERY = <<~GQL.freeze
+        query Orders($first: Int, $after: String) {
+          orders(first: $first, after: $after) {
+            nodes {
+              id
+              nickname
+              totalPrice
+              status {
+                id
+                name
+              }
+              customer {
+                id
+                firstName
+                lastName
+                email
+                company
+              }
+            }
+            pageInfo {
+              hasNextPage
+              endCursor
+            }
+          }
+        }
+      GQL
+
+      FIND_QUERY = <<~GQL.freeze
+        query Order($id: ID!) {
+          order(id: $id) {
+            id
+            nickname
+            totalPrice
+            status {
+              id
+              name
+            }
+            customer {
+              id
+              firstName
+              lastName
+              email
+              company
+            }
+          }
+        }
+      GQL
+
+      def all(first: 25, after: nil)
+        data = @graphql.query(ALL_QUERY, variables: { first: first, after: after })
+        data['orders']['nodes'].map { |attrs| Printavo::Order.new(attrs) }
+      end
+
+      def find(id)
+        data = @graphql.query(FIND_QUERY, variables: { id: id.to_s })
+        Printavo::Order.new(data['order'])
+      end
+    end
+  end
+end

data/lib/printavo/version.rb

@@ -0,0 +1,4 @@
+# lib/printavo/version.rb
+module Printavo
+  VERSION = '0.1.0'.freeze
+end

data/lib/printavo/webhooks.rb

@@ -0,0 +1,34 @@
+# lib/printavo/webhooks.rb
+require 'openssl'
+
+module Printavo
+  module Webhooks
+    # Verifies a Printavo webhook signature using HMAC-SHA256.
+    #
+    # Uses a constant-time comparison to prevent timing attacks.
+    #
+    # @param signature [String] the signature from the X-Printavo-Signature header
+    # @param payload   [String] the raw request body string
+    # @param secret    [String] your webhook secret configured in Printavo
+    # @return [Boolean]
+    #
+    # @example Rails controller
+    #   if Printavo::Webhooks.verify(
+    #        request.headers["X-Printavo-Signature"],
+    #        request.raw_post,
+    #        ENV["PRINTAVO_WEBHOOK_SECRET"]
+    #      )
+    #     # process event
+    #   else
+    #     head :unauthorized
+    #   end
+    def self.verify(signature, payload, secret)
+      return false if signature.nil? || payload.nil? || secret.nil?
+
+      expected = OpenSSL::HMAC.hexdigest('SHA256', secret, payload)
+      OpenSSL.secure_compare(expected, signature)
+    rescue ArgumentError, TypeError
+      false
+    end
+  end
+end

data/lib/printavo.rb

@@ -0,0 +1,23 @@
+# lib/printavo.rb
+require 'faraday'
+require 'faraday/retry'
+require 'json'
+
+require_relative 'printavo/version'
+require_relative 'printavo/errors'
+require_relative 'printavo/config'
+require_relative 'printavo/connection'
+require_relative 'printavo/graphql_client'
+require_relative 'printavo/models/base'
+require_relative 'printavo/models/customer'
+require_relative 'printavo/models/order'
+require_relative 'printavo/models/job'
+require_relative 'printavo/resources/base'
+require_relative 'printavo/resources/customers'
+require_relative 'printavo/resources/orders'
+require_relative 'printavo/resources/jobs'
+require_relative 'printavo/webhooks'
+require_relative 'printavo/client'
+
+module Printavo
+end

metadata

@@ -0,0 +1,309 @@
+--- !ruby/object:Gem::Specification
+name: printavo-ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Stan Carver II
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faker
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: guard-rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec_junit_formatter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: simplecov-lcov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: |
+  A framework-agnostic Ruby SDK for Printavo supporting the v2 GraphQL API.
+  Provides both a resource-oriented interface (client.orders.all) and rich domain
+  models (Printavo::Order), plus raw GraphQL access and Rack-compatible webhook
+  verification. Built to bridge Printavo with external operational systems.
+email:
+- stan@stancarver.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/printavo.rb
+- lib/printavo/client.rb
+- lib/printavo/config.rb
+- lib/printavo/connection.rb
+- lib/printavo/errors.rb
+- lib/printavo/graphql_client.rb
+- lib/printavo/models/base.rb
+- lib/printavo/models/customer.rb
+- lib/printavo/models/job.rb
+- lib/printavo/models/order.rb
+- lib/printavo/resources/base.rb
+- lib/printavo/resources/customers.rb
+- lib/printavo/resources/jobs.rb
+- lib/printavo/resources/orders.rb
+- lib/printavo/version.rb
+- lib/printavo/webhooks.rb
+homepage: https://github.com/scarver2/printavo-ruby
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/scarver2/printavo-ruby/issues
+  changelog_uri: https://github.com/scarver2/printavo-ruby/blob/master/CHANGELOG.md
+  documentation_uri: https://github.com/scarver2/printavo-ruby#readme
+  source_code_uri: https://github.com/scarver2/printavo-ruby
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Ruby SDK for the Printavo GraphQL API
+test_files: []