super_good-solidus_taxjar 0.18.1 → 1.0.0

data/bin/sandbox

@@ -1,58 +1,65 @@
 #!/usr/bin/env bash
-
 set -e
+test -z "${DEBUG+empty_string}" || set -x
 
-case "$DB" in
-postgres|postgresql)
-  RAILSDB="postgresql"
-  ;;
-mysql)
-  RAILSDB="mysql"
-  ;;
-sqlite|'')
-  RAILSDB="sqlite3"
-  ;;
-*)
-  echo "Invalid DB specified: $DB"
-  exit 1
-  ;;
-esac
+test "$DB" = "sqlite" && export DB="sqlite3"
 
-if [ ! -z $SOLIDUS_BRANCH ]
+if [ -z "$PAYMENT_METHOD" ]
 then
-  BRANCH=$SOLIDUS_BRANCH
-else
-  BRANCH="master"
+  PAYMENT_METHOD="none"
 fi
 
+if [ -z "$SOLIDUS_BRANCH" ]
+then
+  echo "~~> Use 'export SOLIDUS_BRANCH=[main|v4.0|...]' to control the Solidus branch"
+  SOLIDUS_BRANCH="main"
+fi
+echo "~~> Using branch $SOLIDUS_BRANCH of solidus"
+
+case $SOLIDUS_BRANCH in
+  v3* | v4.0* | v4.1*)
+    echo "~~> Using a SOLIDUS_BRANCH older than v4.2. Skipping the --admin-preview flag for compatibility."
+    ADMIN_PREVIEW_FLAG=" "
+    ;;
+  *)
+    ADMIN_PREVIEW_FLAG="--admin-preview=false"
+    ;;
+esac
+
 extension_name="super_good-solidus_taxjar"
 
 # Stay away from the bundler env of the containing extension.
 function unbundled {
-  ruby -rbundler -e'b = proc {system *ARGV}; Bundler.respond_to?(:with_unbundled_env) ? Bundler.with_unbundled_env(&b) : Bundler.with_clean_env(&b)' -- $@
+  ruby -rbundler -e'
+      Bundler.with_unbundled_env {system *ARGV}' -- \
+        env BUNDLE_SUPPRESS_INSTALL_USING_MESSAGES=true $@
 }
 
+echo "~~~> Removing the old sandbox"
 rm -rf ./sandbox
-unbundled bundle exec rails new sandbox --database="$RAILSDB" \
-  --skip-bundle \
+
+echo "~~~> Creating a pristine Rails app"
+rails new sandbox \
+  --database="${DB:-sqlite3}" \
   --skip-git \
   --skip-keeps \
   --skip-rc \
-  --skip-spring \
-  --skip-test \
-  --skip-javascript
+  --skip-bootsnap \
+  --skip-test
 
 if [ ! -d "sandbox" ]; then
   echo 'sandbox rails application failed'
   exit 1
 fi
 
+echo "~~~> Adding solidus (with i18n) to the Gemfile"
 cd ./sandbox
 cat <<RUBY >> Gemfile
-gem 'solidus', github: 'solidusio/solidus', branch: '$BRANCH'
-gem 'solidus_auth_devise', '>= 2.1.0'
+gem 'solidus', github: 'solidusio/solidus', branch: '$SOLIDUS_BRANCH'
 gem 'rails-i18n'
 gem 'solidus_i18n'
+gem 'solidus_auth_devise'
+gem "solidus_frontend"
 
 gem '$extension_name', path: '..'
 
@@ -67,18 +74,18 @@ unbundled bundle install --gemfile Gemfile
 
 unbundled bundle exec rake db:drop db:create
 
-unbundled bundle exec rails generate spree:install \
+unbundled bundle exec rails generate solidus:install \
   --auto-accept \
-  --user_class=Spree::User \
-  --enforce_available_locales=true \
-  --with-authentication=false \
+  --payment-method=none \
+  --frontend=none \
+  ${ADMIN_PREVIEW_FLAG} \
   $@
 
-unbundled bundle exec rails generate solidus:auth:install
+SKIP_SOLIDUS_BOLT=true unbundled bundle exec rails generate solidus_frontend:install --auto-accept
+unbundled bundle exec rails generate solidus:auth:install --auto-run-migrations
+unbundled bundle exec rails generate super_good:solidus_taxjar:install --auto-run-migrations
 
 echo
 echo "🚀 Sandbox app successfully created for $extension_name!"
 echo "🚀 Using $RAILSDB and Solidus $BRANCH"
-echo "🚀 Use 'export DB=[postgres|mysql|sqlite]' to control the DB adapter"
-echo "🚀 Use 'export SOLIDUS_BRANCH=<BRANCH-NAME>' to control the Solidus version"
-echo "🚀 This app is intended for test purposes."
+echo "🧪 This app is intended for test purposes."

data/bin/setup

@@ -3,6 +3,6 @@ set -euo pipefail
 IFS=$'\n\t'
 set -vx
 
-bundle install
-
-# Do any other automated setup that you need to do here
+gem install bundler --conservative
+bundle update
+bin/rake clobber

data/config/routes.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+Spree::Core::Engine.routes.draw do
+  namespace :admin do
+    resource :taxjar_settings, only: [:edit, :update]
+    resources :transaction_sync_batches, only: [:index, :show, :create]
+    get 'taxjar_settings/sync_nexus_regions', to: 'taxjar_settings#sync_nexus_regions'
+    get 'taxjar_settings/sync_tax_categories', to: 'taxjar_settings#sync_tax_categories'
+    post 'taxjar_settings/backfill_transactions', to: 'taxjar_settings#backfill_transactions'
+
+    resources :orders do
+      member do
+        get :taxjar_transactions
+      end
+
+      post 'taxjar_transaction/retry', to: "taxjar_transactions#retry"
+    end
+  end
+end

data/db/migrate/20210908205201_create_taxjar_order_transactions.rb

@@ -0,0 +1,16 @@
+class CreateTaxjarOrderTransactions < ActiveRecord::Migration[5.0]
+  def change
+    create_table :solidus_taxjar_order_transactions do |t|
+      t.references :order, null: false
+      t.string :transaction_id, null: false
+
+      t.timestamps
+    end
+
+    add_foreign_key :solidus_taxjar_order_transactions,
+      :spree_orders,
+      column: :order_id
+
+    add_index :solidus_taxjar_order_transactions, :transaction_id, unique: true
+  end
+end

data/db/migrate/20211008175113_create_taxjar_refund_transaction.rb

@@ -0,0 +1,15 @@
+class CreateTaxjarRefundTransaction < ActiveRecord::Migration[5.0]
+  def change
+    create_table :solidus_taxjar_refund_transactions do |t|
+      t.references :order_transaction, index: { unique: true, name: :refund_transactions_orders_idx }
+      t.string :transaction_id, null: false, index: { unique: true }
+      t.datetime :transaction_date, null: false
+
+      t.timestamps
+    end
+
+    add_foreign_key :solidus_taxjar_refund_transactions,
+      :solidus_taxjar_order_transactions,
+      column: :order_transaction_id
+  end
+end

data/db/migrate/20211008183858_add_transaction_date_to_order_transaction.rb

@@ -0,0 +1,5 @@
+class AddTransactionDateToOrderTransaction < ActiveRecord::Migration[5.0]
+  def change
+    add_column :solidus_taxjar_order_transactions, :transaction_date, :datetime, null: false
+  end
+end

data/db/migrate/20211119143354_create_configuration.rb

@@ -0,0 +1,8 @@
+class CreateConfiguration < ActiveRecord::Migration[5.0]
+  def change
+    create_table :solidus_taxjar_configuration do |t|
+      t.text :preferences
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20220405213958_create_transaction_sync_batches.rb

@@ -0,0 +1,7 @@
+class CreateTransactionSyncBatches < ActiveRecord::Migration[5.0]
+  def change
+    create_table :solidus_taxjar_transaction_sync_batches do |t|
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20220405215225_create_transaction_sync_logs.rb

@@ -0,0 +1,14 @@
+class CreateTransactionSyncLogs < ActiveRecord::Migration[5.0]
+  def change
+    create_table :solidus_taxjar_transaction_sync_logs do |t|
+      t.references :transaction_sync_batch, foreign_key: {to_table: :solidus_taxjar_transaction_sync_batches}, index: {name: "index_transaction_sync_logs_on_transaction_sync_batch_id"}, null: false
+      t.references :order, foreign_key: {to_table: :spree_orders}, null: false
+
+      t.references :order_transaction, foreign_key: {to_table: :solidus_taxjar_order_transactions}, index: {name: "index_transaction_sync_logs_on_order_transaction_id"}
+      t.integer :status, null: false, default: 0
+      t.string :error_message
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20220908181655_add_dates_to_transaction_sync_batch.rb

@@ -0,0 +1,6 @@
+class AddDatesToTransactionSyncBatch < ActiveRecord::Migration[6.1]
+  def change
+    add_column :solidus_taxjar_transaction_sync_batches, :start_date, :date
+    add_column :solidus_taxjar_transaction_sync_batches, :end_date, :date
+  end
+end

data/db/migrate/20220912182210_allow_null_transaction_sync_batches_on_logs.rb

@@ -0,0 +1,5 @@
+class AllowNullTransactionSyncBatchesOnLogs < ActiveRecord::Migration[6.1]
+  def change
+    change_column :solidus_taxjar_transaction_sync_logs, :transaction_sync_batch_id, :integer, null: true
+  end
+end

data/db/migrate/20230320211309_add_refund_transaction_to_sync_logs.rb

@@ -0,0 +1,5 @@
+class AddRefundTransactionToSyncLogs < ActiveRecord::Migration[6.1]
+  def change
+    add_reference :solidus_taxjar_transaction_sync_logs, :refund_transaction, foreign_key: {to_table: :solidus_taxjar_refund_transactions}, index: {name: "index_transaction_sync_logs_on_refund_transaction_id"}
+  end
+end

data/lib/generators/super_good/solidus_taxjar/install/install_generator.rb

@@ -0,0 +1,68 @@
+module SuperGood
+  module SolidusTaxjar
+    module Generators
+      class InstallGenerator < Rails::Generators::Base
+        class_option :auto_run_migrations, type: :boolean, default: false
+
+        def create_initializer_file
+          solidus_initializer_path = "config/initializers/solidus.rb"
+
+          create_file(solidus_initializer_path) unless File.exist?(solidus_initializer_path)
+          append_to_file(solidus_initializer_path, <<~INIT)
+            Spree.config do |config|
+              config.tax_calculator_class = SuperGood::SolidusTaxjar::TaxCalculator
+            end
+          INIT
+        end
+
+        def create_omes_initializer_file
+          return unless Gem::Requirement.new('>= 3.2.0.alpha')
+            .satisfied_by?(::Spree.solidus_gem_version)
+
+          omnes_initializer_path = "config/initializers/omnes.rb"
+
+          create_file(omnes_initializer_path) unless File.exist?(omnes_initializer_path)
+          append_to_file(omnes_initializer_path, <<~INIT)
+            Rails.application.config.to_prepare do
+              if SolidusSupport::LegacyEventCompat.using_legacy?
+                require 'super_good/solidus_taxjar/spree/legacy_reporting_subscriber.rb'
+                SuperGood::SolidusTaxjar::Spree::LegacyReportingSubscriber.omnes_subscriber.subscribe_to(Spree::Bus)
+              else
+                require 'super_good/solidus_taxjar/spree/reporting_subscriber.rb'
+                SuperGood::SolidusTaxjar::Spree::ReportingSubscriber.new.subscribe_to(Spree::Bus)
+              end
+            end
+          INIT
+        end
+
+        def create_legacy_events_initializer_file
+          return unless Gem::Requirement.new('< 3.2')
+            .satisfied_by?(::Spree.solidus_gem_version)
+
+          initializer_path = "config/initializers/solidus_taxjar_legacy_events.rb"
+
+          create_file(initializer_path) unless File.exist?(initializer_path)
+          append_to_file(initializer_path, <<~INIT)
+            Rails.application.config.to_prepare do
+              require 'super_good/solidus_taxjar/spree/legacy_reporting_subscriber.rb'
+              SuperGood::SolidusTaxjar::Spree::LegacyReportingSubscriber.activate
+            end
+          INIT
+        end
+
+        def add_migrations
+          run 'bin/rails railties:install:migrations FROM=super_good_solidus_taxjar'
+        end
+
+        def run_migrations
+          run_migrations = options[:auto_run_migrations] || ['', 'y', 'Y'].include?(ask('Would you like to run the migrations now? [Y/n]'))
+          if run_migrations
+            run 'bin/rails db:migrate'
+          else
+            puts 'Skipping bin/rails db:migrate, don\'t forget to run it!'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/super_good/engine.rb

@@ -4,5 +4,7 @@ module SuperGoodSolidusTaxjar
   class Engine < Rails::Engine
     isolate_namespace Spree
     engine_name 'super_good_solidus_taxjar'
+
+    include SolidusSupport::EngineExtensions
   end
 end

data/lib/super_good/solidus_taxjar/addresses.rb

@@ -20,7 +20,7 @@ module SuperGood
 
         return if taxjar_address.nil?
 
-        Spree::Address.immutable_merge(spree_address, {
+        ::Spree::Address.immutable_merge(spree_address, {
           country: us, # TaxJar only supports the US currently.
           state: state(taxjar_address.state),
           zipcode: taxjar_address.zip,
@@ -31,7 +31,7 @@ module SuperGood
 
       def possibilities(spree_address)
         taxjar_addresses(spree_address).map { |taxjar_address|
-          Spree::Address.immutable_merge(spree_address, {
+          ::Spree::Address.immutable_merge(spree_address, {
             country: us, # TaxJar only supports the US currently.
             state: state(taxjar_address.state),
             zipcode: taxjar_address.zip,
@@ -52,7 +52,7 @@ module SuperGood
       end
 
       def us
-        Spree::Country.find_by iso: "US"
+        ::Spree::Country.find_by iso: "US"
       end
 
       def state(abbr)

data/lib/super_good/solidus_taxjar/api.rb

@@ -3,7 +3,7 @@ module SuperGood
     class Api
       def self.default_taxjar_client
         client = ::Taxjar::Client.new(
-          api_key: ENV.fetch("TAXJAR_API_KEY"),
+          api_key: ENV["TAXJAR_API_KEY"],
           api_url: ENV.fetch("TAXJAR_API_URL") { "https://api.taxjar.com" } # Sandbox URL: https://api.sandbox.taxjar.com
         )
         client.set_api_config('headers', {
@@ -17,14 +17,12 @@ module SuperGood
         @taxjar_client = taxjar_client
       end
 
-      def tax_for(order)
-        taxjar_client.tax_for_order(ApiParams.order_params(order)).tap do |taxes|
-          next unless SuperGood::SolidusTaxjar.logging_enabled
+      def tax_categories
+        taxjar_client.categories
+      end
 
-          Rails.logger.info(
-            "TaxJar response for #{order.number}: #{taxes.to_h.inspect}"
-          )
-        end
+      def tax_for(order)
+        taxjar_client.tax_for_order(ApiParams.order_params(order))
       end
 
       def tax_rate_for(address)
@@ -36,7 +34,17 @@ module SuperGood
       end
 
       def create_transaction_for(order)
-        taxjar_client.create_order ApiParams.transaction_params(order)
+        latest_transaction_id =
+          OrderTransaction.latest_for(order)&.transaction_id
+
+        transaction_id = TransactionIdGenerator.next_transaction_id(
+          order: order,
+          current_transaction_id: latest_transaction_id
+        )
+
+        taxjar_client.create_order(
+          ApiParams.transaction_params(order, transaction_id)
+        )
       end
 
       def update_transaction_for(order)
@@ -47,6 +55,30 @@ module SuperGood
         taxjar_client.delete_order order.number
       end
 
+      def show_latest_transaction_for(order)
+        latest_transaction_id =
+          OrderTransaction.latest_for(order)&.transaction_id
+
+        return unless latest_transaction_id
+
+        taxjar_client.show_order(latest_transaction_id)
+      rescue Taxjar::Error::NotFound
+        nil
+      end
+
+      def create_refund_transaction_for(order)
+        unless OrderTransaction.latest_for(order)
+          raise NotImplementedError,
+            "No latest TaxJar order transaction for #{order.number}. "       \
+            "Backfilling TaxJar transaction orders from Solidus is not yet " \
+            "implemented."
+        end
+
+        taxjar_order = show_latest_transaction_for(order)
+
+        taxjar_client.create_refund ApiParams.refund_transaction_params(order, taxjar_order)
+      end
+
       def create_refund_for(reimbursement)
         taxjar_client.create_refund ApiParams.refund_params(reimbursement)
       end
@@ -55,6 +87,10 @@ module SuperGood
         taxjar_client.validate_address ApiParams.validate_address_params(spree_address)
       end
 
+      def nexus_regions
+        taxjar_client.nexus_regions
+      end
+
       private
 
       attr_reader :taxjar_client

data/lib/super_good/solidus_taxjar/api_params.rb

@@ -1,6 +1,8 @@
 module SuperGood
   module SolidusTaxjar
     module ApiParams
+      UNTAXABLE_INVENTORY_UNIT_STATES = ["returned", "canceled"]
+
       class << self
         def order_params(order)
           {}
@@ -9,13 +11,6 @@ module SuperGood
             .merge(line_items_params(order.line_items))
             .merge(shipping: shipping(order))
             .merge(SuperGood::SolidusTaxjar.custom_order_params.call(order))
-            .tap do |params|
-              next unless SuperGood::SolidusTaxjar.logging_enabled
-
-              Rails.logger.info(
-                "TaxJar params for #{order.number}: #{params.inspect}"
-              )
-            end
         end
 
         def address_params(address)
@@ -37,20 +32,44 @@ module SuperGood
           }.merge(order_address_params(address))
         end
 
-        def transaction_params(order)
+        def transaction_params(order, transaction_id = order.number)
           {}
             .merge(customer_params(order))
             .merge(order_address_params(order.tax_address))
             .merge(transaction_line_items_params(order.line_items))
             .merge(
-              transaction_id: order.number,
+              transaction_id: transaction_id,
               transaction_date: order.completed_at.to_formatted_s(:iso8601),
-              amount: [order.total - order.additional_tax_total, 0].max,
+              # We use `payment_total` to reflect the total liablity
+              # transferred.
+              amount: [order.payments.completed.sum(&:amount) - refund_total_without_tax(order) - order.additional_tax_total, 0].max,
               shipping: shipping(order),
               sales_tax: sales_tax(order)
             )
         end
 
+        def refund_transaction_params(spree_order, taxjar_order)
+          {}
+            .merge(order_address_params(spree_order.tax_address))
+            .merge(
+              {
+                transaction_id: TransactionIdGenerator.refund_transaction_id(taxjar_order.transaction_id),
+                transaction_reference_id: taxjar_order.transaction_id,
+                transaction_date: spree_order.completed_at.to_formatted_s(:iso8601),
+                amount: -1 * taxjar_order.amount,
+                sales_tax: -1 * taxjar_order.sales_tax,
+                shipping: -1 * taxjar_order.shipping,
+                line_items: taxjar_order.line_items.map { |line_item|
+                  line_item.to_h.merge({
+                    unit_price: line_item.unit_price * -1,
+                    discount:  line_item.discount * -1,
+                    sales_tax: line_item.sales_tax * -1
+                  })
+                }
+              }
+            )
+        end
+
         def refund_params(reimbursement)
           additional_taxes = reimbursement.return_items.sum(&:additional_tax_total)
 
@@ -72,7 +91,7 @@ module SuperGood
             state: spree_address.state&.abbr || spree_address.state_name,
             zip: spree_address.zipcode,
             city: spree_address.city,
-            street: spree_address.address1
+            street: [spree_address.address1, spree_address.address2].compact.join(' ')
           }
         end
 
@@ -94,9 +113,18 @@ module SuperGood
           }
         end
 
+        # @private
+        # This method builds line item parameters as expected by the TaxJar
+        # Tax API.
+        #
+        # @param line_items [Spree::LineItem::ActiveRecord_Relation] All of the
+        #   order's line items.
+        # @return [Hash] A TaxJar API-friendly line item collection.
         def line_items_params(line_items)
           {
-            line_items: valid_line_items(line_items).map do |line_item|
+            line_items: line_items.filter_map { |line_item|
+              next unless line_item.quantity.positive?
+
               {
                 id: line_item.id,
                 quantity: line_item.quantity,
@@ -104,34 +132,39 @@ module SuperGood
                 discount: discount(line_item),
                 product_tax_code: line_item.tax_category&.tax_code
               }
-            end
+            }
           }
         end
 
+        # @private
+        # This method builds line item parameters as expected by the TaxJar
+        # Transactions API. Note that this logic different from
+        # `.line_item_params` as it excludes inventory units we consider to be
+        # untaxable (i.e. returned or cancelled inventory units).
+        #
+        # @param line_items [Spree::LineItem::ActiveRecord_Relation] All of the
+        #   order's line items.
+        # @return [Hash] A TaxJar API-friendly line item collection.
         def transaction_line_items_params(line_items)
           {
-            line_items: valid_line_items(line_items).map do |line_item|
+            line_items: line_items.filter_map { |line_item|
+              quantity = taxable_quantity line_item
+              next unless quantity.positive?
+
               {
                 id: line_item.id,
-                quantity: line_item.quantity,
+                quantity: quantity,
                 product_identifier: line_item.sku,
+                description: line_item.variant.descriptive_name,
                 product_tax_code: line_item.tax_category&.tax_code,
                 unit_price: line_item.price,
                 discount: discount(line_item),
                 sales_tax: line_item_sales_tax(line_item)
               }
-            end
+            }
           }
         end
 
-        def valid_line_items(line_items)
-          # The API appears to error when sent line items with no quantity...
-          # but why would you do that anyway.
-          line_items.reject do |line_item|
-            line_item.quantity.zero?
-          end
-        end
-
         def discount(line_item)
           ::SuperGood::SolidusTaxjar.discount_calculator.new(line_item).discount
         end
@@ -143,13 +176,47 @@ module SuperGood
         def sales_tax(order)
           return 0 if order.total.zero?
 
-          order.additional_tax_total
+          order.additional_tax_total - order_reimbursement_tax_total(order)
         end
 
         def line_item_sales_tax(line_item)
           return 0 if line_item.order.total.zero?
 
-          line_item.additional_tax_total
+          line_item.additional_tax_total -  line_item_reimbursement_tax_total(line_item)
+        end
+
+        def taxable_quantity(line_item)
+          line_item.inventory_units
+            .where.not(state: UNTAXABLE_INVENTORY_UNIT_STATES)
+            .count
+        end
+
+        def line_item_reimbursement_tax_total(line_item)
+          line_item
+            .inventory_units
+            .flat_map(&:return_items)
+            .filter { |return_item| return_item.reimbursement.present? }
+            .sum(&:additional_tax_total)
+        end
+
+        def order_reimbursement_tax_total(order)
+          order.reimbursements.sum { |reimbursement| reimbursement_tax_total(reimbursement) }
+        end
+
+        def reimbursement_tax_total(reimbursement)
+          reimbursement.return_items.sum(&:additional_tax_total)
+        end
+
+        def refund_total_without_tax(order)
+          order.refunds.sum do |refund|
+            if refund.reimbursement.present?
+              refund.reimbursement.total - reimbursement_tax_total(refund.reimbursement)
+            else
+              # This use case represents making a line item level adjustment, and then refunding
+              # that amount.
+              refund.amount
+            end
+          end
         end
       end
     end

data/lib/super_good/solidus_taxjar/backfill_transactions.rb

@@ -0,0 +1,11 @@
+module SuperGood
+  module SolidusTaxjar
+    class BackfillTransactions
+      def call(start_date:, end_date:)
+        transaction_sync_batch = SuperGood::SolidusTaxjar::TransactionSyncBatch.create!(start_date: start_date, end_date: end_date)
+        SuperGood::SolidusTaxjar::BackfillTransactionSyncBatchJob.perform_later(transaction_sync_batch)
+        transaction_sync_batch
+      end
+    end
+  end
+end

data/lib/super_good/solidus_taxjar/cached_api.rb

@@ -0,0 +1,23 @@
+module SuperGood
+  module SolidusTaxjar
+    class CachedApi
+      # @param api [SuperGood::SolidusTaxjar::Api] instance of API wrapper
+      def initialize(api: SuperGood::SolidusTaxjar.api)
+        @api = api
+      end
+
+      # @param refresh [Boolean] forces a refresh of the cached regions
+      def nexus_regions(refresh: false)
+        Rails.cache.fetch(
+          :nexus_regions,
+          expires_in: SuperGood::SolidusTaxjar.cache_duration,
+          force: refresh
+        ) { api.nexus_regions }
+      end
+
+      private
+
+      attr_reader :api
+    end
+  end
+end