printavo-ruby 0.14.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0c6bbdd1f2e7dec2d40c9c5386385083049aa9f7fdd71d97ff2d8c91e0256b0
-  data.tar.gz: fca9352dae13007b7a319ec7414cf0699b2169040cd0ad94fe5683adc9506676
+  metadata.gz: b42e7a5ddd23b104e211fa3f98443f1b27ba3388131051800e9c7984c26a7cea
+  data.tar.gz: fad8a0df2cd70466b6251b11dc070e808cbe31eb4d2d60693f3e26ae489e1bc4
 SHA512:
-  metadata.gz: 81dc61d793eb316a7e98ef4d89338229504c3f7be1c104fb24685ff108d7dc495270635a5413795b981c5e2377c3f74eb0bfe5cf86db1ca19a11afd1a09d4460
-  data.tar.gz: 1ab1cb1bf5d4950c615e407ff4008db7e07e200869a2aac5859cbbb3f8380a8d19f7dab8ea83a0eafb6f8225901cf6ca62e661816c3fe185269eb1141fb5a8dd
+  metadata.gz: 7074d4f0acfdbf08619e21f37b1315dbfac60845469da6a667f00d849b04a94b89959cfddac94e502153c01354cdca2c08ca1161b8e7606e20414755448deb1d
+  data.tar.gz: ec2ee5c644a2d07c25931ee10621e3962a1ac5200207b905925bc8586a8e1c3002a58bb7595c8f6f19420db38edbff234c53da11e9968ba8ad81b7bf3555dbec

data/bin/console

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# bin/console
+require "bundler/setup"
+require "printavo"
+
+# Start an interactive session with the gem loaded.
+# Set PRINTAVO_EMAIL and PRINTAVO_TOKEN in your environment before running.
+#
+# Example:
+#   PRINTAVO_EMAIL=you@example.com PRINTAVO_TOKEN=your_token bin/console
+
+require "irb"
+IRB.start(__FILE__)

data/bin/lint

@@ -0,0 +1,113 @@
+#!/usr/bin/env bash
+# bin/lint
+#
+# Runs RuboCop against every Ruby version declared in .mise.toml.
+# Any arguments are forwarded directly to rubocop.
+#
+# Usage:
+#   bin/lint                        # all versions, full inspection
+#   bin/lint -a                     # auto-correct safe offenses, all versions
+#   bin/lint lib/printavo/client.rb # one file, all versions
+#
+# Requires mise: https://mise.jdx.dev
+
+set -uo pipefail
+
+# ── Colours (only when writing to a real terminal) ─────────────────────────
+if [[ -t 1 ]]; then
+  RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+  CYAN='\033[0;36m'; BOLD='\033[1m'; RESET='\033[0m'
+else
+  RED=''; GREEN=''; YELLOW=''; CYAN=''; BOLD=''; RESET=''
+fi
+
+# ── Locate project root ────────────────────────────────────────────────────
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+TOML="$ROOT/.mise.toml"
+
+if [[ ! -f "$TOML" ]]; then
+  printf '%bError:%b .mise.toml not found at %s\n' "$RED" "$RESET" "$TOML" >&2
+  exit 1
+fi
+
+# ── Parse ruby versions from .mise.toml ────────────────────────────────────
+# Handles both:
+#   ruby = "4.0.2"                 (scalar)
+#   ruby = ["4.0.2", "3.3.10"]    (array, with optional trailing comma/comment)
+ruby_line=$(grep -E '^\s*ruby\s*=' "$TOML" | head -1)
+
+if [[ -z "$ruby_line" ]]; then
+  printf '%bError:%b no ruby entry found in .mise.toml\n' "$RED" "$RESET" >&2
+  exit 1
+fi
+
+# Pull every quoted token from the line into an array (bash 3-compatible)
+VERSIONS=()
+while IFS= read -r v; do
+  VERSIONS+=("$v")
+done < <(printf '%s\n' "$ruby_line" | grep -oE '"[^"]+"' | tr -d '"')
+
+if [[ ${#VERSIONS[@]} -eq 0 ]]; then
+  printf '%bError:%b could not parse ruby versions from: %s\n' "$RED" "$RESET" "$ruby_line" >&2
+  exit 1
+fi
+
+# ── Locate mise ────────────────────────────────────────────────────────────
+MISE="${HOME}/.local/bin/mise"
+[[ -x "$MISE" ]] || MISE=$(command -v mise 2>/dev/null || true)
+
+if [[ -z "$MISE" ]]; then
+  printf '%bError:%b mise not found — install from https://mise.jdx.dev\n' "$RED" "$RESET" >&2
+  exit 1
+fi
+
+# ── Helpers ────────────────────────────────────────────────────────────────
+# Track results in parallel arrays (bash 3: no associative arrays)
+RESULT_VERSIONS=()
+RESULT_STATUSES=()
+
+record() { RESULT_VERSIONS+=("$1"); RESULT_STATUSES+=("$2"); }
+
+# ── Run each version ───────────────────────────────────────────────────────
+printf '\n%bprintavo-ruby%b — running RuboCop across %d Ruby version(s)\n\n' \
+  "$BOLD" "$RESET" "${#VERSIONS[@]}"
+
+for version in "${VERSIONS[@]}"; do
+  printf '%b── Ruby %s%b ─────────────────────────────────────────────\n' \
+    "$CYAN" "$version" "$RESET"
+
+  # Verify the version is installed before trying to use it
+  if ! "$MISE" exec "ruby@${version}" -- ruby --version &>/dev/null 2>&1; then
+    printf '%b  skipped%b — ruby %s not installed\n' "$YELLOW" "$RESET" "$version"
+    printf '           run: mise install ruby@%s\n\n' "$version"
+    record "$version" "skip"
+    continue
+  fi
+
+  # bundle install (quiet) then rubocop, both executed under the target Ruby
+  if "$MISE" exec "ruby@${version}" -- \
+       bash -c "cd '$ROOT' && bundle install --quiet && bundle exec rubocop $*"; then
+    record "$version" "pass"
+  else
+    record "$version" "fail"
+  fi
+  printf '\n'
+done
+
+# ── Summary ────────────────────────────────────────────────────────────────
+printf '%bResults%b\n' "$BOLD" "$RESET"
+printf '──────────────────────\n'
+
+overall=0
+for i in "${!RESULT_VERSIONS[@]}"; do
+  v="${RESULT_VERSIONS[$i]}"
+  s="${RESULT_STATUSES[$i]}"
+  case "$s" in
+    pass) printf '  Ruby %-8s  %b✓ pass%b\n' "$v" "$GREEN" "$RESET" ;;
+    fail) printf '  Ruby %-8s  %b✗ fail%b\n' "$v" "$RED"   "$RESET"; overall=1 ;;
+    skip) printf '  Ruby %-8s  %b⚠ skip%b\n' "$v" "$YELLOW" "$RESET" ;;
+  esac
+done
+
+printf '──────────────────────\n\n'
+exit $overall

data/bin/printavo

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.join(__dir__, '..', 'lib'))
+
+require 'printavo/cli'
+
+Printavo::CLI.start(ARGV)

data/bin/spec

@@ -0,0 +1,113 @@
+#!/usr/bin/env bash
+# bin/spec
+#
+# Runs the RSpec suite against every Ruby version declared in .mise.toml.
+# Any arguments are forwarded directly to rspec.
+#
+# Usage:
+#   bin/spec                               # all versions, all specs
+#   bin/spec spec/printavo/client_spec.rb  # one file, all versions
+#   bin/spec --format documentation        # forward rspec flags
+#
+# Requires mise: https://mise.jdx.dev
+
+set -uo pipefail
+
+# ── Colours (only when writing to a real terminal) ─────────────────────────
+if [[ -t 1 ]]; then
+  RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+  CYAN='\033[0;36m'; BOLD='\033[1m'; RESET='\033[0m'
+else
+  RED=''; GREEN=''; YELLOW=''; CYAN=''; BOLD=''; RESET=''
+fi
+
+# ── Locate project root ────────────────────────────────────────────────────
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+TOML="$ROOT/.mise.toml"
+
+if [[ ! -f "$TOML" ]]; then
+  printf '%bError:%b .mise.toml not found at %s\n' "$RED" "$RESET" "$TOML" >&2
+  exit 1
+fi
+
+# ── Parse ruby versions from .mise.toml ────────────────────────────────────
+# Handles both:
+#   ruby = "4.0.2"                 (scalar)
+#   ruby = ["4.0.2", "3.3.10"]    (array, with optional trailing comma/comment)
+ruby_line=$(grep -E '^\s*ruby\s*=' "$TOML" | head -1)
+
+if [[ -z "$ruby_line" ]]; then
+  printf '%bError:%b no ruby entry found in .mise.toml\n' "$RED" "$RESET" >&2
+  exit 1
+fi
+
+# Pull every quoted token from the line into an array (bash 3-compatible)
+VERSIONS=()
+while IFS= read -r v; do
+  VERSIONS+=("$v")
+done < <(printf '%s\n' "$ruby_line" | grep -oE '"[^"]+"' | tr -d '"')
+
+if [[ ${#VERSIONS[@]} -eq 0 ]]; then
+  printf '%bError:%b could not parse ruby versions from: %s\n' "$RED" "$RESET" "$ruby_line" >&2
+  exit 1
+fi
+
+# ── Locate mise ────────────────────────────────────────────────────────────
+MISE="${HOME}/.local/bin/mise"
+[[ -x "$MISE" ]] || MISE=$(command -v mise 2>/dev/null || true)
+
+if [[ -z "$MISE" ]]; then
+  printf '%bError:%b mise not found — install from https://mise.jdx.dev\n' "$RED" "$RESET" >&2
+  exit 1
+fi
+
+# ── Helpers ────────────────────────────────────────────────────────────────
+# Track results in parallel arrays (bash 3: no associative arrays)
+RESULT_VERSIONS=()
+RESULT_STATUSES=()
+
+record() { RESULT_VERSIONS+=("$1"); RESULT_STATUSES+=("$2"); }
+
+# ── Run each version ────────────────────────────────────────────────────────
+printf '\n%bprintavo-ruby%b — running specs across %d Ruby version(s)\n\n' \
+  "$BOLD" "$RESET" "${#VERSIONS[@]}"
+
+for version in "${VERSIONS[@]}"; do
+  printf '%b── Ruby %s%b ─────────────────────────────────────────────\n' \
+    "$CYAN" "$version" "$RESET"
+
+  # Verify the version is installed before trying to use it
+  if ! "$MISE" exec "ruby@${version}" -- ruby --version &>/dev/null 2>&1; then
+    printf '%b  skipped%b — ruby %s not installed\n' "$YELLOW" "$RESET" "$version"
+    printf '           run: mise install ruby@%s\n\n' "$version"
+    record "$version" "skip"
+    continue
+  fi
+
+  # bundle install (quiet) then rspec, both executed under the target Ruby
+  if "$MISE" exec "ruby@${version}" -- \
+       bash -c "cd '$ROOT' && bundle install --quiet && bundle exec rspec $*"; then
+    record "$version" "pass"
+  else
+    record "$version" "fail"
+  fi
+  printf '\n'
+done
+
+# ── Summary ────────────────────────────────────────────────────────────────
+printf '%bResults%b\n' "$BOLD" "$RESET"
+printf '──────────────────────\n'
+
+overall=0
+for i in "${!RESULT_VERSIONS[@]}"; do
+  v="${RESULT_VERSIONS[$i]}"
+  s="${RESULT_STATUSES[$i]}"
+  case "$s" in
+    pass) printf '  Ruby %-8s  %b✓ pass%b\n' "$v" "$GREEN" "$RESET" ;;
+    fail) printf '  Ruby %-8s  %b✗ fail%b\n' "$v" "$RED"   "$RESET"; overall=1 ;;
+    skip) printf '  Ruby %-8s  %b⚠ skip%b\n' "$v" "$YELLOW" "$RESET" ;;
+  esac
+done
+
+printf '──────────────────────\n\n'
+exit $overall

data/docs/CHANGELOG.md

@@ -6,6 +6,54 @@ 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.16.0] - 2026-04-01
+
+### Added
+- `Printavo::Enums` namespace — 18 enum modules covering every GraphQL enum in the
+  Printavo V2 schema (excluding `__DirectiveLocation` and `__TypeKind`, which are
+  GraphQL introspection internals):
+  - `ApprovalRequestStatus` — APPROVED, PENDING, REVOKED, UNAPPROVED
+  - `ContactSortField` — CREATED_AT, EMAIL, FIRST_NAME, LAST_NAME, UPDATED_AT
+  - `LineItemSize` — full garment size set (XS–6XL, youth, toddler, infant, OS, NONE)
+  - `LineItemStatus` — ACTIVE, CANCELLED
+  - `MerchOrderDeliveryMethod` — LOCAL_DELIVERY, PICKUP, SHIP
+  - `MerchOrderStatus` — CANCELLED, COMPLETE, PENDING, PROCESSING
+  - `MerchStoreStatus` — ACTIVE, ARCHIVED, CLOSED
+  - `MessageDeliveryStatus` — BOUNCED, DELIVERED, FAILED, PENDING, SENT
+  - `OrderPaymentStatus` — PAID, PARTIAL, UNPAID
+  - `OrderSortField` — CREATED_AT, CUSTOMER_DUE_AT, DUE_AT, UPDATED_AT, VISUAL_ID
+  - `PaymentDisputeStatusField` — LOST, NEEDS_RESPONSE, RESOLVED, UNDER_REVIEW, WON
+  - `PaymentRequestStatus` — CANCELLED, PAID, SENT
+  - `PoGoodsStatus` — CANCELLED, PARTIAL, PENDING, RECEIVED
+  - `StatusType` — INVOICE, QUOTE
+  - `TaskSortField` — BODY, CREATED_AT, DUE_AT, UPDATED_AT
+  - `TaskableType` — INVOICE, QUOTE
+  - `TransactionCategory` — PAYMENT, REFUND
+  - `TransactionSource` — CARD, CASH, CHECK, MANUAL, ONLINE
+- Each enum exposes an `ALL` frozen array of all values
+- Shared RSpec example `'a Printavo enum'` validates structure across all 18 modules
+
+### Notes
+- Enum values are the best-effort representation of the Printavo V2 schema at time of
+  release. Values that differ from the live schema should be reported as patch issues.
+
+## [0.15.0] - 2026-04-01
+
+### Added
+- `Printavo::Client` now accepts `max_retries:` (default: 2) and `retry_on_rate_limit:` (default: true)
+- `Printavo::Connection` — exponential backoff with ±50% jitter on retries (`backoff_factor: 2`,
+  `interval_randomness: 0.5`); retry statuses are `[500, 502, 503]` plus `429` when
+  `retry_on_rate_limit: true`
+- `Printavo::CLI` — Thor-based command-line interface:
+  - `printavo customers [--first N]` — list customers (tab-aligned output)
+  - `printavo orders [--first N]` — list orders (default subcommand)
+  - `printavo orders find ID` — find and display a single order
+  - Credentials read from `PRINTAVO_EMAIL` / `PRINTAVO_TOKEN` environment variables
+- `bin/printavo` executable (installed to PATH as `printavo`)
+- `thor ~> 1.0` added as a runtime dependency
+- `.graphql` files and `bin/` now included in `spec.files` (fixes missing graphql files in
+  published gem)
+
 ## [0.14.0] - 2026-04-01
 
 ### Added

data/docs/TODO.md

@@ -374,12 +374,33 @@ return values — they are exposed via model field accessors, not separate resou
 - [x] `Orders#delete` — `quoteDelete`
 - [x] `Orders#duplicate` — `quoteDuplicate`
 
-### v0.15.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.15.0 — Retry / Backoff & CLI ✅
+
+- [x] Configurable `max_retries` on `Printavo::Client`
+- [x] Exponential backoff with jitter on 429 responses
+- [x] `retry_on_rate_limit: true/false` client option
+- [x] Thor-based `printavo` CLI (`customers`, `orders`, `orders find <id>`)
+
+### v0.16.0 — Enums ✅
+
+- [x] `Printavo::Enums::ApprovalRequestStatus`
+- [x] `Printavo::Enums::ContactSortField`
+- [x] `Printavo::Enums::LineItemSize`
+- [x] `Printavo::Enums::LineItemStatus`
+- [x] `Printavo::Enums::MerchOrderDeliveryMethod`
+- [x] `Printavo::Enums::MerchOrderStatus`
+- [x] `Printavo::Enums::MerchStoreStatus`
+- [x] `Printavo::Enums::MessageDeliveryStatus`
+- [x] `Printavo::Enums::OrderPaymentStatus`
+- [x] `Printavo::Enums::OrderSortField`
+- [x] `Printavo::Enums::PaymentDisputeStatusField`
+- [x] `Printavo::Enums::PaymentRequestStatus`
+- [x] `Printavo::Enums::PoGoodsStatus`
+- [x] `Printavo::Enums::StatusType`
+- [x] `Printavo::Enums::TaskSortField`
+- [x] `Printavo::Enums::TaskableType`
+- [x] `Printavo::Enums::TransactionCategory`
+- [x] `Printavo::Enums::TransactionSource`
 
 ### v0.99.0 — API Freeze
 

data/lib/printavo/cli.rb

@@ -0,0 +1,82 @@
+# lib/printavo/cli.rb
+# frozen_string_literal: true
+
+require 'thor'
+require 'printavo'
+
+module Printavo
+  # Shared credential helper included by CLI and its subcommands.
+  module CLIHelpers
+    private
+
+    # Builds a Printavo::Client from PRINTAVO_EMAIL / PRINTAVO_TOKEN env vars.
+    # Raises Thor::Error with a human-readable message if either is missing.
+    def build_client
+      email = ENV.fetch('PRINTAVO_EMAIL', nil)
+      token = ENV.fetch('PRINTAVO_TOKEN', nil)
+      raise Thor::Error, 'PRINTAVO_EMAIL environment variable is required' unless email && !email.empty?
+      raise Thor::Error, 'PRINTAVO_TOKEN environment variable is required' unless token && !token.empty?
+
+      Printavo::Client.new(email: email, token: token)
+    end
+  end
+
+  class CLI < Thor
+    include CLIHelpers
+
+    package_name 'printavo'
+
+    def self.exit_on_failure? = true
+
+    # ---------------------------------------------------------------------------
+    # version
+    # ---------------------------------------------------------------------------
+
+    desc 'version', 'Print the printavo-ruby gem version'
+    def version
+      say Printavo::VERSION
+    end
+
+    # ---------------------------------------------------------------------------
+    # customers
+    # ---------------------------------------------------------------------------
+
+    desc 'customers', 'List customers'
+    method_option :first, type: :numeric, default: 25, desc: 'Number of records to return'
+    def customers
+      build_client.customers.all(first: options[:first]).each do |c|
+        say "#{c.id.to_s.ljust(10)}  #{c.full_name.to_s.ljust(30)}  #{c.email}"
+      end
+    end
+
+    # ---------------------------------------------------------------------------
+    # orders subcommand
+    # ---------------------------------------------------------------------------
+
+    class Orders < Thor
+      include CLIHelpers
+
+      default_task :list
+
+      desc 'list', 'List orders (default)'
+      method_option :first, type: :numeric, default: 25, desc: 'Number of records to return'
+      def list
+        build_client.orders.all(first: options[:first]).each do |o|
+          say "#{o.id.to_s.ljust(10)}  #{o.nickname.to_s.ljust(30)}  #{o.total_price}"
+        end
+      end
+
+      desc 'find ID', 'Find an order by ID'
+      def find(id)
+        o = build_client.orders.find(id)
+        say "id:          #{o.id}"
+        say "nickname:    #{o.nickname}"
+        say "total_price: #{o.total_price}"
+        say "status:      #{o.status}"
+      end
+    end
+
+    desc 'orders SUBCOMMAND ...ARGS', 'List orders or find a specific order'
+    subcommand 'orders', Orders
+  end
+end

data/lib/printavo/client.rb

@@ -8,9 +8,11 @@ module Printavo
     # 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)
+    # @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)
+    # @param max_retries         [Integer] max retry attempts on 5xx/429 responses (default: 2)
+    # @param retry_on_rate_limit [Boolean] retry automatically on 429 Too Many Requests (default: true)
     #
     # @example
     #   client = Printavo::Client.new(
@@ -20,9 +22,15 @@ module Printavo
     #   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)
+    def initialize(email:, token:, timeout: 30, max_retries: 2, retry_on_rate_limit: true)
+      connection = Connection.new(
+        email: email,
+        token: token,
+        timeout: timeout,
+        max_retries: max_retries,
+        retry_on_rate_limit: retry_on_rate_limit
+      ).build
+      @graphql = GraphqlClient.new(connection)
     end
 
     def account

data/lib/printavo/connection.rb

@@ -6,11 +6,20 @@ 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
+    # @param email               [String]  Printavo account email
+    # @param token               [String]  Printavo API token
+    # @param base_url            [String]  API base URL (default: Config::BASE_URL)
+    # @param timeout             [Integer] HTTP timeout in seconds (default: 30)
+    # @param max_retries         [Integer] Max retry attempts on 5xx/429 (default: 2)
+    # @param retry_on_rate_limit [Boolean] Retry on 429 Too Many Requests (default: true)
+    def initialize(email:, token:, base_url: Config::BASE_URL, timeout: 30, # rubocop:disable Metrics/ParameterLists
+                   max_retries: 2, retry_on_rate_limit: true)
+      @email               = email
+      @token               = token
+      @base_url            = base_url
+      @timeout             = timeout
+      @max_retries         = max_retries
+      @retry_on_rate_limit = retry_on_rate_limit
     end
 
     def build
@@ -19,15 +28,34 @@ module Printavo
         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.request :retry, **retry_options
         f.response :json
         f.options.timeout      = @timeout
         f.options.open_timeout = @timeout
-
         f.adapter Faraday.default_adapter
       end
     end
+
+    private
+
+    # Exponential backoff: base interval × 2^attempt, ±50% jitter.
+    # interval_randomness adds up to 50% random variance per retry.
+    def retry_options
+      {
+        max: @max_retries,
+        interval: 0.5,
+        backoff_factor: 2,
+        interval_randomness: 0.5,
+        retry_statuses: retry_statuses
+      }
+    end
+
+    # Returns the set of HTTP status codes that trigger a retry.
+    # 429 is only included when +retry_on_rate_limit+ is true (the default).
+    def retry_statuses
+      statuses = [500, 502, 503]
+      statuses << 429 if @retry_on_rate_limit
+      statuses
+    end
   end
 end

data/lib/printavo/enums/approval_request_status.rb

@@ -0,0 +1,17 @@
+# lib/printavo/enums/approval_request_status.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Enums
+    # Possible values for the +ApprovalRequest+ status field.
+    module ApprovalRequestStatus
+      APPROVED   = 'approved'
+      DECLINED   = 'declined'
+      PENDING    = 'pending'
+      REVOKED    = 'revoked'
+      UNAPPROVED = 'unapproved'
+
+      ALL = [APPROVED, DECLINED, PENDING, REVOKED, UNAPPROVED].freeze
+    end
+  end
+end

data/lib/printavo/enums/contact_sort_field.rb

@@ -0,0 +1,16 @@
+# lib/printavo/enums/contact_sort_field.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Enums
+    # Fields by which a contact list can be sorted.
+    module ContactSortField
+      CONTACT_EMAIL = 'CONTACT_EMAIL'
+      CONTACT_NAME  = 'CONTACT_NAME'
+      CUSTOMER_NAME = 'CUSTOMER_NAME'
+      ORDER_COUNT   = 'ORDER_COUNT'
+
+      ALL = [CONTACT_EMAIL, CONTACT_NAME, CUSTOMER_NAME, ORDER_COUNT].freeze
+    end
+  end
+end

data/lib/printavo/enums/line_item_size.rb

@@ -0,0 +1,48 @@
+# lib/printavo/enums/line_item_size.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Enums
+    # Garment size values for line items. All values carry the +size_+ prefix
+    # as returned by the Printavo V2 GraphQL API.
+    module LineItemSize
+      # Adult
+      XS       = 'size_xs'
+      S        = 'size_s'
+      M        = 'size_m'
+      L        = 'size_l'
+      XL       = 'size_xl'
+      TWO_XL   = 'size_2xl'
+      THREE_XL = 'size_3xl'
+      FOUR_XL  = 'size_4xl'
+      FIVE_XL  = 'size_5xl'
+      SIX_XL   = 'size_6xl'
+      # Youth
+      YOUTH_XS = 'size_yxs'
+      YOUTH_S  = 'size_ys'
+      YOUTH_M  = 'size_ym'
+      YOUTH_L  = 'size_yl'
+      YOUTH_XL = 'size_yxl'
+      # Toddler
+      TODDLER_2T = 'size_2t'
+      TODDLER_3T = 'size_3t'
+      TODDLER_4T = 'size_4t'
+      TODDLER_5T = 'size_5t'
+      # Infant
+      INFANT_6M  = 'size_6m'
+      INFANT_12M = 'size_12m'
+      INFANT_18M = 'size_18m'
+      INFANT_24M = 'size_24m'
+      # Other
+      OTHER = 'size_other'
+
+      ALL = [
+        XS, S, M, L, XL, TWO_XL, THREE_XL, FOUR_XL, FIVE_XL, SIX_XL,
+        YOUTH_XS, YOUTH_S, YOUTH_M, YOUTH_L, YOUTH_XL,
+        TODDLER_2T, TODDLER_3T, TODDLER_4T, TODDLER_5T,
+        INFANT_6M, INFANT_12M, INFANT_18M, INFANT_24M,
+        OTHER
+      ].freeze
+    end
+  end
+end

data/lib/printavo/enums/line_item_status.rb

@@ -0,0 +1,19 @@
+# lib/printavo/enums/line_item_status.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Enums
+    # Inventory / fulfillment status of a +LineItem+.
+    module LineItemStatus
+      ARRIVED            = 'arrived'
+      ATTACHED_TO_PO     = 'attached_to_po'
+      IN                 = 'in'
+      NEED_ORDERING      = 'need_ordering'
+      ORDERED            = 'ordered'
+      PARTIALLY_RECEIVED = 'partially_received'
+      RECEIVED           = 'received'
+
+      ALL = [ARRIVED, ATTACHED_TO_PO, IN, NEED_ORDERING, ORDERED, PARTIALLY_RECEIVED, RECEIVED].freeze
+    end
+  end
+end

data/lib/printavo/enums/merch_order_delivery_method.rb

@@ -0,0 +1,14 @@
+# lib/printavo/enums/merch_order_delivery_method.rb
+# frozen_string_literal: true
+
+module Printavo
+  module Enums
+    # How a merch order will be fulfilled and delivered to the buyer.
+    module MerchOrderDeliveryMethod
+      DELIVERY = 'DELIVERY'
+      PICKUP   = 'PICKUP'
+
+      ALL = [DELIVERY, PICKUP].freeze
+    end
+  end
+end