solidus_easypost 2.0.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d31b734374e49e27bb7f182577cd2f1693b716299d8419e0d9b9d456bdfe9d50
-  data.tar.gz: 603ca168bb0c4a460af1fa498c7b5448316e4986cb285b5fe9eb442f9a3fa11d
+  metadata.gz: 0d54d7ac2a6876f5b69df700919019c7ef094bb58e146139ff8ec93a9da754a0
+  data.tar.gz: 4e75d5636a2fb85d1277dd4fe6ffc2e2a61c616ed0688ba247dc72c218dabf8a
 SHA512:
-  metadata.gz: 3b0c53d359fd325783c1e4646cfd8a8f97c392ae5ddfcba384c79b05efcf755fa7ed8f06c62fac7bfea0dc41471243327f6e62c916ba463efe1dccccc625c36b
-  data.tar.gz: 21cd54816073d19859d1077002237ebf4b2c302f29e7fc3cc0e1d567ddc96a78ce69dcea6d461e207b46e67697d37a9f2f8d4f25b49f431fbc668e45a156efea
+  metadata.gz: 62e2e3f86ccbab5feab3550b7e32c3e168169b11790663a629dc56a34ede6b2bd6cbe63c4e5459b3af62c084f9686f58c02e05faac10c418836bfe2e00433dc8
+  data.tar.gz: adf8d14742ea4da96c3b4950b9db43b46b61fd279528a8f5610a2061ff7a03aa6a8ca610775862004784cef06af1e0a49c2e667d0c47b188a487ed76c5b3f912

data/.circleci/config.yml

@@ -16,12 +16,18 @@ jobs:
     executor: solidusio_extensions/mysql
     steps:
       - solidusio_extensions/run-tests
+  lint-code:
+    executor: solidusio_extensions/sqlite-memory
+    steps:
+      - solidusio_extensions/lint-code
 
 workflows:
   "Run specs on supported Solidus versions":
     jobs:
       - run-specs-with-postgres
       - run-specs-with-mysql
+      - lint-code
+
   "Weekly run specs against master":
     triggers:
       - schedule:

data/.github/stale.yml

@@ -1,17 +1,17 @@
 # Number of days of inactivity before an issue becomes stale
 daysUntilStale: 60
 # Number of days of inactivity before a stale issue is closed
-daysUntilClose: 7
+daysUntilClose: false
 # Issues with these labels will never be considered stale
 exemptLabels:
   - pinned
   - security
 # Label to use when marking an issue as stale
-staleLabel: wontfix
+staleLabel: stale
 # Comment to post when marking an issue as stale. Set to `false` to disable
 markComment: >
   This issue has been automatically marked as stale because it has not had
-  recent activity. It will be closed if no further activity occurs. Thank you
+  recent activity. It might be closed if no further activity occurs. Thank you
   for your contributions.
 # Comment to post when closing a stale issue. Set to `false` to disable
-closeComment: false
+closeComment: false

data/.github_changelog_generator

@@ -0,0 +1,2 @@
+issues=false
+exclude-labels=infrastructure

data/.gitignore

@@ -18,3 +18,4 @@ spec/examples.txt
 .rvmrc
 .ruby-version
 .ruby-gemset
+.bundle

data/.rubocop.yml

@@ -2,3 +2,6 @@ inherit_from: .rubocop_todo.yml
 
 require:
   - solidus_dev_support/rubocop
+
+AllCops:
+  NewCops: enable

data/.rubocop_todo.yml

@@ -1,71 +1,36 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2020-07-24 11:17:48 +0200 using RuboCop version 0.76.0.
+# on 2020-09-23 14:11:08 UTC using RuboCop version 0.91.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
 # Offense count: 1
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyleAlignWith, AutoCorrect, Severity.
-# SupportedStylesAlignWith: keyword, variable, start_of_line
-Layout/EndAlignment:
-  Exclude:
-    - 'app/decorators/models/solidus_easypost/spree/address_decorator.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Lint/RedundantCopDisableDirective:
-  Exclude:
-    - 'lib/generators/solidus_easypost/install/install_generator.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-RSpec/EmptyLineAfterFinalLet:
+RSpec/DescribeClass:
   Exclude:
-    - 'spec/models/solidus_easypost/return_authorization_spec.rb'
+    - 'spec/features/**/*'
+    - 'spec/integration/order_shipping_spec.rb'
 
 # Offense count: 3
-# Configuration parameters: .
-# SupportedStyles: have_received, receive
-RSpec/MessageSpies:
-  EnforcedStyle: receive
-
-# Offense count: 1
 RSpec/MultipleExpectations:
   Max: 3
 
-# Offense count: 22
-# Configuration parameters: IgnoreSharedExamples.
-RSpec/NamedSubject:
-  Exclude:
-    - 'spec/models/solidus_easypost/return_authorization_spec.rb'
-    - 'spec/models/spree/address_spec.rb'
-    - 'spec/models/spree/shipment_spec.rb'
-    - 'spec/models/spree/shipping_rate_spec.rb'
-    - 'spec/models/spree/stock/estimator_spec.rb'
-    - 'spec/models/spree/stock/package_spec.rb'
-    - 'spec/models/spree/stock_location_spec.rb'
-
 # Offense count: 4
-RSpec/NestedGroups:
-  Max: 5
-
-# Offense count: 2
-RSpec/ScatteredSetup:
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: scientific, engineering, integral
+Style/ExponentialNotation:
   Exclude:
-    - 'spec/models/solidus_easypost/return_authorization_spec.rb'
+    - 'spec/integration/checkout_spec.rb'
 
 # Offense count: 1
-# Configuration parameters: IgnoreNameless, IgnoreSymbolicNames.
-RSpec/VerifiedDoubles:
+Style/OptionalBooleanParameter:
   Exclude:
-    - 'spec/models/spree/stock/estimator_spec.rb'
+    - 'lib/solidus_easypost/estimator.rb'
 
-# Offense count: 1
+# Offense count: 3
 # Cop supports --auto-correct.
 # Configuration parameters: AutoCorrect, AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
 # URISchemes: http, https
-Metrics/LineLength:
+Layout/LineLength:
   Max: 137

data/CHANGELOG.md

@@ -0,0 +1,113 @@
+# Changelog
+
+## [v3.0.0](https://github.com/solidusio-contrib/solidus_easypost/tree/v3.0.0) (2022-01-05)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/v2.0.0...v3.0.0)
+
+**Closed issues:**
+
+- Dependabot can't resolve your Ruby dependency files [\#92](https://github.com/solidusio-contrib/solidus_easypost/issues/92)
+- Prepare Solidus Easypost for Solidus 3.0 [\#88](https://github.com/solidusio-contrib/solidus_easypost/issues/88)
+- Dependabot can't resolve your Ruby dependency files [\#77](https://github.com/solidusio-contrib/solidus_easypost/issues/77)
+- Dependabot can't resolve your Ruby dependency files [\#76](https://github.com/solidusio-contrib/solidus_easypost/issues/76)
+- README is incompatible with latest rubygems release [\#73](https://github.com/solidusio-contrib/solidus_easypost/issues/73)
+- Unable to Handle Refunds Out of the Box [\#58](https://github.com/solidusio-contrib/solidus_easypost/issues/58)
+
+**Merged pull requests:**
+
+- fix new cops [\#102](https://github.com/solidusio-contrib/solidus_easypost/pull/102) ([ccarruitero](https://github.com/ccarruitero))
+- fix webhooks handler setup and allow customize [\#100](https://github.com/solidusio-contrib/solidus_easypost/pull/100) ([ccarruitero](https://github.com/ccarruitero))
+- relax ruby version to support ruby 3.0 [\#99](https://github.com/solidusio-contrib/solidus_easypost/pull/99) ([ccarruitero](https://github.com/ccarruitero))
+- Add custom parcel dimension calculator class [\#98](https://github.com/solidusio-contrib/solidus_easypost/pull/98) ([vassalloandrea](https://github.com/vassalloandrea))
+- Update gemspec to allow Solidus 3 [\#94](https://github.com/solidusio-contrib/solidus_easypost/pull/94) ([vassalloandrea](https://github.com/vassalloandrea))
+- Prepare extension for solidus 3.0 [\#89](https://github.com/solidusio-contrib/solidus_easypost/pull/89) ([ccarruitero](https://github.com/ccarruitero))
+- Allow tracking packages via EasyPost [\#87](https://github.com/solidusio-contrib/solidus_easypost/pull/87) ([aldesantis](https://github.com/aldesantis))
+- Upgrade extension to latest defaults [\#86](https://github.com/solidusio-contrib/solidus_easypost/pull/86) ([aldesantis](https://github.com/aldesantis))
+- Allow admins to download postage labels [\#84](https://github.com/solidusio-contrib/solidus_easypost/pull/84) ([aldesantis](https://github.com/aldesantis))
+- Update extension with latest solidus\_dev\_support defaults [\#82](https://github.com/solidusio-contrib/solidus_easypost/pull/82) ([aldesantis](https://github.com/aldesantis))
+- Streamline and reorganize tests for better reliability [\#81](https://github.com/solidusio-contrib/solidus_easypost/pull/81) ([aldesantis](https://github.com/aldesantis))
+- Extract EasyPost object builders into separate classes [\#80](https://github.com/solidusio-contrib/solidus_easypost/pull/80) ([aldesantis](https://github.com/aldesantis))
+- Improve extension extendability [\#79](https://github.com/solidusio-contrib/solidus_easypost/pull/79) ([aldesantis](https://github.com/aldesantis))
+- Update extension to latest defaults from solidus\_dev\_support [\#78](https://github.com/solidusio-contrib/solidus_easypost/pull/78) ([aldesantis](https://github.com/aldesantis))
+
+## [v2.0.0](https://github.com/solidusio-contrib/solidus_easypost/tree/v2.0.0) (2020-07-24)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/v1.0.4...v2.0.0)
+
+**Breaking changes:**
+
+- keep same namespace in all files [\#68](https://github.com/solidusio-contrib/solidus_easypost/pull/68) ([ccarruitero](https://github.com/ccarruitero))
+
+**Closed issues:**
+
+- Dependabot can't resolve your Ruby dependency files [\#59](https://github.com/solidusio-contrib/solidus_easypost/issues/59)
+- Dependabot can't resolve your Ruby dependency files [\#57](https://github.com/solidusio-contrib/solidus_easypost/issues/57)
+- Dependabot can't resolve your Ruby dependency files [\#56](https://github.com/solidusio-contrib/solidus_easypost/issues/56)
+- Dependabot can't resolve your Ruby dependency files [\#54](https://github.com/solidusio-contrib/solidus_easypost/issues/54)
+- Dependabot can't resolve your Ruby dependency files [\#53](https://github.com/solidusio-contrib/solidus_easypost/issues/53)
+- Dependabot can't resolve your Ruby dependency files [\#52](https://github.com/solidusio-contrib/solidus_easypost/issues/52)
+- Config is now frozen. [\#49](https://github.com/solidusio-contrib/solidus_easypost/issues/49)
+- Easypost rate is bought twice [\#42](https://github.com/solidusio-contrib/solidus_easypost/issues/42)
+- UPS carrier doesn't allow empty company name in `from_address` [\#41](https://github.com/solidusio-contrib/solidus_easypost/issues/41)
+- Exception thrown by Estimator [\#35](https://github.com/solidusio-contrib/solidus_easypost/issues/35)
+- rake railties:install:migrations [\#30](https://github.com/solidusio-contrib/solidus_easypost/issues/30)
+- Easypost Migrations aren't working [\#22](https://github.com/solidusio-contrib/solidus_easypost/issues/22)
+- Missing for 2.1 solidus? [\#18](https://github.com/solidusio-contrib/solidus_easypost/issues/18)
+- Charge customer different amount? [\#17](https://github.com/solidusio-contrib/solidus_easypost/issues/17)
+- 1.3.0 seems to be empty [\#15](https://github.com/solidusio-contrib/solidus_easypost/issues/15)
+- Uninitialized constant EasyPost Error [\#14](https://github.com/solidusio-contrib/solidus_easypost/issues/14)
+
+**Merged pull requests:**
+
+- Extension cleanup [\#74](https://github.com/solidusio-contrib/solidus_easypost/pull/74) ([aldesantis](https://github.com/aldesantis))
+- Standardize whitespace in README [\#72](https://github.com/solidusio-contrib/solidus_easypost/pull/72) ([brchristian](https://github.com/brchristian))
+- Fix deprecation warning in engine.rb [\#71](https://github.com/solidusio-contrib/solidus_easypost/pull/71) ([brchristian](https://github.com/brchristian))
+- Update README.md [\#70](https://github.com/solidusio-contrib/solidus_easypost/pull/70) ([brchristian](https://github.com/brchristian))
+- Relax solidus\_support dependency [\#65](https://github.com/solidusio-contrib/solidus_easypost/pull/65) ([kennyadsl](https://github.com/kennyadsl))
+- Upgrade to the latest solidus\_dev\_support [\#60](https://github.com/solidusio-contrib/solidus_easypost/pull/60) ([vassalloandrea](https://github.com/vassalloandrea))
+- Fix CONFIGS constant not being modifiable [\#51](https://github.com/solidusio-contrib/solidus_easypost/pull/51) ([aldesantis](https://github.com/aldesantis))
+- Reorganize and improve tests [\#50](https://github.com/solidusio-contrib/solidus_easypost/pull/50) ([aldesantis](https://github.com/aldesantis))
+- Adopt solidus\_extension\_dev\_tools [\#48](https://github.com/solidusio-contrib/solidus_easypost/pull/48) ([aldesantis](https://github.com/aldesantis))
+- Use different easypost\_address for the stock locations [\#43](https://github.com/solidusio-contrib/solidus_easypost/pull/43) ([vassalloandrea](https://github.com/vassalloandrea))
+- Fix broken Rails 6 build [\#40](https://github.com/solidusio-contrib/solidus_easypost/pull/40) ([aldesantis](https://github.com/aldesantis))
+- Adopt CircleCI instead of Travis [\#39](https://github.com/solidusio-contrib/solidus_easypost/pull/39) ([aldesantis](https://github.com/aldesantis))
+- Fixing Travis [\#38](https://github.com/solidusio-contrib/solidus_easypost/pull/38) ([spaghetticode](https://github.com/spaghetticode))
+- Add Rubocop for linting [\#37](https://github.com/solidusio-contrib/solidus_easypost/pull/37) ([aitbw](https://github.com/aitbw))
+- Lock SQLite3 to version 1.3 [\#34](https://github.com/solidusio-contrib/solidus_easypost/pull/34) ([aitbw](https://github.com/aitbw))
+-  Use dynamic attributes on factories [\#33](https://github.com/solidusio-contrib/solidus_easypost/pull/33) ([aitbw](https://github.com/aitbw))
+- add solidus\_easypost file [\#32](https://github.com/solidusio-contrib/solidus_easypost/pull/32) ([peterberkenbosch](https://github.com/peterberkenbosch))
+- Add Solidus v2.8 to Travis config [\#31](https://github.com/solidusio-contrib/solidus_easypost/pull/31) ([aitbw](https://github.com/aitbw))
+- Spec suite maintenance [\#29](https://github.com/solidusio-contrib/solidus_easypost/pull/29) ([aitbw](https://github.com/aitbw))
+- Remove 2.2 from CI \(EOL\) [\#28](https://github.com/solidusio-contrib/solidus_easypost/pull/28) ([jacobherrington](https://github.com/jacobherrington))
+- Remove versions past EOL from .travis.yml [\#26](https://github.com/solidusio-contrib/solidus_easypost/pull/26) ([jacobherrington](https://github.com/jacobherrington))
+- Add Solidus 2.3-2.7 to .travis.yml [\#25](https://github.com/solidusio-contrib/solidus_easypost/pull/25) ([jacobherrington](https://github.com/jacobherrington))
+- Support Solidus 1.3 and beyond [\#19](https://github.com/solidusio-contrib/solidus_easypost/pull/19) ([jhawthorn](https://github.com/jhawthorn))
+- Add the require pry to spec helper [\#7](https://github.com/solidusio-contrib/solidus_easypost/pull/7) ([qr8r](https://github.com/qr8r))
+- Fix multiple version testing [\#5](https://github.com/solidusio-contrib/solidus_easypost/pull/5) ([jhawthorn](https://github.com/jhawthorn))
+
+## [v1.0.4](https://github.com/solidusio-contrib/solidus_easypost/tree/v1.0.4) (2016-10-03)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/v1.0.3...v1.0.4)
+
+## [v1.0.3](https://github.com/solidusio-contrib/solidus_easypost/tree/v1.0.3) (2016-07-20)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/v1.0.2...v1.0.3)
+
+## [v1.0.2](https://github.com/solidusio-contrib/solidus_easypost/tree/v1.0.2) (2016-03-14)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/solidus-1.0.2...v1.0.2)
+
+**Merged pull requests:**
+
+- Update Gemspec [\#4](https://github.com/solidusio-contrib/solidus_easypost/pull/4) ([qr8r](https://github.com/qr8r))
+- Version 1.0.0  [\#3](https://github.com/solidusio-contrib/solidus_easypost/pull/3) ([qr8r](https://github.com/qr8r))
+- Add a travis config file [\#2](https://github.com/solidusio-contrib/solidus_easypost/pull/2) ([qr8r](https://github.com/qr8r))
+- Fix address decorator spec [\#1](https://github.com/solidusio-contrib/solidus_easypost/pull/1) ([travisp](https://github.com/travisp))
+
+## [solidus-1.0.2](https://github.com/solidusio-contrib/solidus_easypost/tree/solidus-1.0.2) (2015-12-08)
+
+[Full Changelog](https://github.com/solidusio-contrib/solidus_easypost/compare/d963686e8d728ec5beec6c04fd4ae99e3cf7450e...solidus-1.0.2)
+
+
+
+\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2020 Brendan Deere
+Copyright (c) 2015 Brendan Deere
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification,

data/README.md

@@ -1,6 +1,6 @@
 # solidus_easypost
 
-[![CircleCI](https://circleci.com/gh/solidusio-contrib/solidus_easypost.svg?style=svg)](https://circleci.com/gh/solidusio-contrib/solidus_easypost)
+
 
 This is an extension to integrate EasyPost with Solidus.
 
@@ -24,31 +24,106 @@ Bundle your dependencies and run the installation generator:
 bin/rails generate solidus_easypost:install
 ```
 
-Create an initializer at `config/initializers/solidus_easypost.rb`:
+This will create an initializer at `config/initializers/solidus_easypost.rb`. Read through the
+available configuration options and make sure to adjust the extension for your requirements.
+
+Finally, you will need to configure Solidus to use the EasyPost stock estimator:
 
 ```ruby
-EasyPost.api_key = 'YOUR_API_KEY_HERE'
+# config/initializers/spree.rb
+Spree.config do |config|
+  config.stock.estimator_class = 'SolidusEasypost::Estimator'
+end
 ```
 
 ## Usage
 
-This extension hijacks `Spree::Stock::Estimator#shipping_rates` to calculate shipping rates for your
-orders. This call happens during the checkout process, once the order's address information has been
-provided.
+Once you switch to the EasyPost rate calculator, the extension will start calculating shipping rates
+for all shipments. The cheapest rate will be selected by default, but your users will be able to
+change the selected rate in the `delivery` step of the checkout process, if they wish.
+
+Admins will also be able to download the postage label associated to each EasyPost shipment after
+a shipment has been bought.
+
+### Buying labels upon shipping
+
+By default, the extension also adds a callback to the `ship` event on the `Spree::Shipment` model,
+automatically buying the selected rate from EasyPost.
+
+If you want to disable this logic, you can set `purchase_labels` to `false`.
+
+### Customizing shipping rate calculation
+
+By default, the extension will pass the entire cost of shipping to the user (i.e., the shipping cost
+presented to the user will be equal to the rate received from the EasyPost API).
+
+If you want to override this logic (e.g., you want to offer your users free shipping, but still buy
+the rates from EasyPost), you can provide your own `shipping_rate_calculator_class`.
 
-The extension also adds a callback to the `ship` event on the `Spree::Shipment` model, telling
-EasyPost which rate was selected and "buying" that rate. This can be disabled by setting:
+### Customizing shipping method selection
+
+By default, the extension will create shipping methods for each type of carrier/service for which it
+receives a rate from the EasyPost API. These are not available to users by default, and must be
+enabled before they are visible and selectable in the storefront during the checkout process.
+
+If you want to override this logic, you can provide your own `shipping_method_selector_class`.
+
+### Customizing parcel dimension calculator
+
+By default, the extension will use the default weight dimension calculator to calculate the parcel dimension that is passed to EasyPost. The default calculator uses the variants weight to calculate the parcel weight without taking into consideration the other package properties like `width`, `height`, and `lenght`.
+
+If you want to override this logic, you can provide your own `parcel_dimension_calculator_class`.
+
+### Tracking cartons via EasyPost
+
+You can optionally track packages via EasyPost's [Trackers API](https://www.easypost.com/docs/api#trackers).
+In order to do this, you can call the `#easypost_tracker` method on any carton:
+
+```ruby
+carton = Spree::Carton.find(2)
+carton.easypost_tracker # => #<Easypost::Tracker>
+```
+
+This will also save the ID of the tracker on the `easy_post_tracker_id` column, to more easily
+retrieve the tracker in the future.
+
+> NOTE: In orders for carton tracking to work, you need to make sure that the `tracking` column
+> in `spree_cartons` contains a valid tracking number, and that the `carrier` column in
+> `spree_shipping_methods` contains a carrier name [that EasyPost will recognize](https://www.easypost.com/docs/api#carrier-tracking-strings).
+> The extension already generates compliant shipping methods by default, but you may need to change
+> the data on your custom shipping methods if you want to track them.
+
+You can also enable automatic tracking for all created cartons:
 
 ```ruby
-# config/initializers/solidus_easypost.rb
 SolidusEasypost.configure do |config|
-  config.purchase_labels = false
+  config.track_all_cartons = true
 end
 ```
 
-This gem will create shipping methods for each type of carrier/service for which it receives a rate
-from the EasyPost API. These are set to  `display_on: back_end` by default and must be set to
-`front_end` or `both` before the rate will be visible on the delivery page of the checkout.
+### Getting tracking updates via webhooks
+
+Once a tracker has been created for a given carton, you can either use it manually or you can use
+EasyPost's [webhooks](https://www.easypost.com/docs/api#webhooks) to have any shipping updates
+forwarded to your application.
+
+In order for webhooks to work, you need to install the [solidus_webhooks](https://github.com/solidusio-contrib/solidus_webhooks)
+extension. When the extension is available, a webhook will be automatically configured at
+`/webhooks/easypost_trackers`. Simply add it to your EasyPost dashboard with the following
+configuration:
+
+- *Environment:* `Production` or `Test`
+- *Webhook URL:* `https://your-store.com/webhooks/easypost_trackers?token=[YOUR_TOKEN]` (replace`[YOUR_TOKEN]` with the API key of an admin user or, better yet, a[webhook user](https://github.com/solidusio-contrib/solidus_webhooks#restricting-permissions)
+
+Now, when Solidus gets a tracking update from EasyPost, a `solidus_easypost.tracker.updated` event
+will be fired. The event's payload will contain the `:carton` and `:payload` keys, with the
+`Spree::Carton` object associated to the tracker and the EasyPost payload respectively.
+
+### Customizing the tracking webhook handler
+
+If you want to override default webhook handler, you can provide your own `webhook_handler_class` in your configuration.
+
+Note that, if you override the webhook handler, no events will be fired out of the box.
 
 ## Development
 
@@ -58,14 +133,14 @@ First bundle your dependencies, then run `bin/rake`. `bin/rake` will default to
 app if it does not exist, then it will run specs. The dummy app can be regenerated by using
 `bin/rake extension:test_app`.
 
-```console
-$ bin/rake
+```shell
+bin/rake
 ```
 
 To run [Rubocop](https://github.com/bbatsov/rubocop) static code analysis run
 
-```console
-$ bundle exec rubocop
+```shell
+bundle exec rubocop
 ```
 
 When testing your application's integration with this extension you may use its factories.
@@ -83,7 +158,7 @@ the sandbox app is `./sandbox` and `bin/rails` will forward any Rails commands t
 
 Here's an example:
 
-```console
+```
 $ bin/rails server
 => Booting Puma
 => Rails 6.0.2.1 application starting in development
@@ -91,14 +166,29 @@ $ bin/rails server
 Use Ctrl-C to stop
 ```
 
+### Updating the changelog
+
+Before and after releases the changelog should be updated to reflect the up-to-date status of
+the project:
+
+```shell
+bin/rake changelog
+git add CHANGELOG.md
+git commit -m "Update the changelog"
+```
+
 ### Releasing new versions
 
 Your new extension version can be released using `gem-release` like this:
 
-```console
-$ bundle exec gem bump -v VERSION --tag --push --remote upstream && gem release
+```shell
+bundle exec gem bump -v 1.6.0
+bin/rake changelog
+git commit -a --amend
+git push
+bundle exec gem release
 ```
 
 ## License
 
-Copyright (c) 2020 Brendan Deere, released under the New BSD License.
+Copyright (c) 2015 Brendan Deere, released under the New BSD License.

data/app/controllers/spree/admin/postage_labels_controller.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Spree
+  module Admin
+    class PostageLabelsController < Spree::Admin::BaseController
+      def show
+        @shipment = Spree::Shipment.find_by(number: params[:shipment_id])
+        authorize! @shipment, :show
+
+        unless @shipment.easypost_postage_label_url
+          flash[:error] = t('.no_postage_label', shipment_number: @shipment.number)
+          redirect_back(fallback_location: edit_admin_order_path(@shipment.order))
+          return
+        end
+
+        redirect_to @shipment.easypost_postage_label_url
+      end
+    end
+  end
+end

data/app/decorators/models/solidus_easypost/spree/carton_decorator.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module SolidusEasypost
+  module Spree
+    module CartonDecorator
+      def self.prepended(base)
+        base.after_create :track_via_easypost
+      end
+
+      def easypost_tracker
+        return @easypost_tracker if @easypost_tracker
+
+        if easy_post_tracker_id.present?
+          @easypost_tracker = EasyPost::Tracker.retrieve(easy_post_tracker_id)
+        else
+          @easypost_tracker = EasyPost::Tracker.create(
+            tracking_code: tracking,
+            carrier: shipping_method.carrier,
+          )
+
+          update!(easy_post_tracker_id: @easypost_tracker.id)
+        end
+
+        @easypost_tracker
+      end
+
+      private
+
+      def track_via_easypost
+        return unless SolidusEasypost.configuration.track_all_cartons
+
+        easypost_tracker
+      end
+
+      ::Spree::Carton.prepend self
+    end
+  end
+end

data/app/decorators/models/solidus_easypost/spree/shipment_decorator.rb

@@ -3,46 +3,41 @@
 module SolidusEasypost
   module Spree
     module ShipmentDecorator
-      def self.prepended(mod)
-        mod.state_machine.before_transition(
+      def self.prepended(base)
+        base.state_machine.before_transition(
           to: :shipped,
           do: :buy_easypost_rate,
           if: -> { SolidusEasypost.configuration.purchase_labels }
         )
-      end
 
-      def easypost_shipment
-        if selected_easy_post_shipment_id
-          @ep_shipment ||= ::EasyPost::Shipment.retrieve(selected_easy_post_shipment_id)
-        else
-          @ep_shipment = build_easypost_shipment
-        end
+        base.delegate(
+          :easy_post_rate_id,
+          :easy_post_shipment_id,
+          to: :selected_shipping_rate,
+          prefix: :selected,
+          allow_nil: true,
+        )
       end
 
-      private
+      def easypost_shipment
+        return unless selected_easy_post_shipment_id
 
-      def selected_easy_post_rate_id
-        selected_shipping_rate.easy_post_rate_id
+        @easypost_shipment ||= ::EasyPost::Shipment.retrieve(selected_easy_post_shipment_id)
       end
 
-      def selected_easy_post_shipment_id
-        selected_shipping_rate.easy_post_shipment_id
+      def easypost_postage_label_url
+        easypost_shipment&.postage_label&.label_url
       end
 
-      def build_easypost_shipment
-        ::EasyPost::Shipment.create(
-          to_address: order.ship_address.easypost_address,
-          from_address: stock_location.easypost_address,
-          parcel: to_package.easypost_parcel
-        )
-      end
+      private
 
       def buy_easypost_rate
-        rate = easypost_shipment.rates.find do |sr|
-          sr.id == selected_easy_post_rate_id
+        rate = easypost_shipment.rates.find do |easypost_rate|
+          easypost_rate.id == selected_easy_post_rate_id
         end
 
         easypost_shipment.buy(rate)
+
         self.tracking = easypost_shipment.tracking_code
       end
 

data/app/models/solidus_easypost/parcel_dimension.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module SolidusEasypost
+  class ParcelDimension
+    def initialize(**params)
+      raise ArgumentError, 'The weight param is mandatory!' unless valid_value?(value: params[:weight])
+
+      @weight = params[:weight]
+      @width = params[:width]
+      @height = params[:height]
+      @depth = params[:depth]
+    end
+
+    def to_h
+      hash = {
+        weight: weight
+      }
+
+      hash[:width] = width if valid_value?(value: width)
+      hash[:height] = height if valid_value?(value: height)
+      hash[:length] = depth if valid_value?(value: depth)
+
+      hash
+    end
+
+    private
+
+    def valid_value?(value:)
+      value.present? && !value.zero?
+    end
+
+    attr_reader :width, :height, :depth, :weight
+  end
+end

data/app/models/solidus_easypost/return_authorization.rb

@@ -15,24 +15,13 @@ module SolidusEasypost
     end
 
     def easypost_shipment
-      @easypost_shipment ||= ::EasyPost::Shipment.create(
-        from_address: stock_location.easypost_address,
-        to_address: order.ship_address.easypost_address,
-        parcel: build_parcel,
-        is_return: true
-      )
+      @easypost_shipment ||= ShipmentBuilder.from_return_authorization(self)
     end
 
     def return_label(rate)
       easypost_shipment.buy(rate) unless easypost_shipment.postage_label
-      easypost_shipment.postage_label
-    end
 
-    private
-
-    def build_parcel
-      total_weight = inventory_units.joins(:variant).sum(:weight)
-      ::EasyPost::Parcel.create weight: total_weight
+      easypost_shipment.postage_label
     end
   end
 end