Reaction Commerce v1.14.0 Release Notes
-
🔌 Removing Optional Plugins
🐎 As part of our focus simplifying the core Reaction application and improving performance, we've made the decision to remove optional plugins from the core application. From our blog post on this topic:
📦 > It’s about quality over quantity. As a part of our initiative to simplify Reaction, we’re focusing on providing one reference application per feature and moving all others over to community-sponsored packages. We’ll be migrating packages, APIs, and schemas over to npm. It’s a standard approach to package management, one that improves the developer experience overall.
Here’s how it will look:
📦 | Category | Reaction default(s) | Community package(s) | | ---------- | ------------------------------- | -------------------------------- | 📦 | Payments | Stripe, example payment package | PayPal, Authorize.net, Braintree | | Taxes | Flat rate | Avalara, TaxCloud, TaxJar | | Shipping | Flat rate | Shippo | | Connectors | CSV connector | Shopify connector |
⚡️ As the first step of this process we've moved a number of packages from the https://github.com/reactioncommerce/reaction repo to independent repositories in the new https://github.com/reaction-contrib organization. You can install these packages by following the instructions located inside of each new repository. Once installed they should work as they did in v1.13. Any issues you have with updating these packages should be filed in the repos created for these packages and not in the core Reaction repo going forward. If you're interested in contributing to or helping to maintain any of the packages that we've moved to reaction-contrib, please reach out to @zenweasel and he can get you setup.
🚀 The list of packages that have been removed in this release is as follows:
- Shopify
- TaxCloud
- Avalara
- Authorize.net
- Paypal
- Braintree
- TaxJar
- Advanced Inventory Management
- Shippo
- SMS
- Discount Rates (unused, not the same as our current discount codes)
- 🌲 Logging (unused by core application)
🚀 This work is listed as a breaking change. If your application relies on any of these packages, you will have to install them independently of Reaction going forward. This release will not destroy data associated with these plugins, so you should be able to safely update without losing information. However, please be sure to test this for your specific application before deploying to production and as always, backup your data before updating versions.
GraphQL Cart
🚀 This release contains the Cart and Checkout GraphQL schemas along with several cart queries and mutations. We're starting to make some changes to the core cart schemas for Reaction and the process that we use to create and identify carts.
🔀 One of these changes is when we create a cart for a customer. To this point, we've created a cart document for each and every visitor to a Reaction storefront. Going forward we'll be creating carts on demand. This means that a customer will not have a cart associated with them until they first add a product to the cart. This is how we've architected the GraphQL API to work and we've made some changes to the legacy Reaction cart system to put it in sync.
⚡️ We're signifincantly adjusting the Cart schema as well. The best way to understand all of this will be to read through the updated GraphQL Cart Schema in #4307 and #4390 but I'll try to note some things to be aware of going forward.
A cart will have either an account associated with it or may be anonymous.
🚚 A cart will have an array of items associated with them. As we will be lazy in creating carts, when the cart is created this array of items will have at least one item in it. We do not destory carts if a customer removes all items from a cart, so it is possible that there will be an empty array of items inside of a cart.
One of the major changes to carts is related to how we store information necessary to create an order from a cart. We're introducing a new field
checkoutto the cart schema which you can dig into in #4309. This will be where fulfillment information, payment information, addresses and any other information necessary to process a checkout will be stored.🚀 Recognizing the need to be able to handle orders which have items that require different types of fulfillment, we're organizing items into what we're calling "Fulfillment Groups." The most basic example is that a fulfillment group could be a group of items that is getting shipped to a specific address. For an order with
nitems, there can exist up tonfulfillment groups within that cart. This specific release doesn't introduce any new functionality for adding new types of fulfillment groups or splitting a single cart into multiple fulfillments, but it does lay the groundwork for splitting orders, creating new fulfillment types such as an in store pickup, ship to store, digital downloads, or generated license keys.We're currently mapping this new GraphQL Schema to the existing Reaction Simple Schema, but will be transitioning all of our existing schemas to match (more or less) our new GraphQL schemas going forward.
A cart will still be associated with a single shop. This is consistent with current behavior.
There are two GraphQL Queries for fetching carts, one for getting anonymous carts
anonymousCartByCartIdand one for getting account cartsaccountCartByAccountId🚀 This release introduces GraphQL Mutations for creating carts, adding items to carts, removing items from carts, updating cart items, and reconciling carts when a customer with an anonymous cart logs into an account.
🔀
ReconcileCartsis a new method which replaces and extends our previousmergeCartsmethod with additional functionality. ReconcileCarts has 3 modes:merge,keepAnonymousCart, andkeepAccountCart.mergeis the default mode and works identically to how the existingmergeCartsmethod works, where the anonymous cart is combined with the account cart, items are deduped, and quantities are incremented to match the combined qty of the items in the carts.keepAnonymousCartwill keep only the items and the checkout information in the anonymous cart, andkeepAccountCartwill do the same but for the Account Cart.💥 Breaking Changes
Meteor App
File Organization
- 👀 We've moved all files from
/serverinto plugins. All imports with paths that begin with /server will need to be changed for any custom code or community plugins. See the file changes in https://github.com/reactioncommerce/reaction/pull/4366/files to see examples of changing import paths from/serverto relevant plugin paths.
Cart
- ⚡️ A cart is not created until items are added. Previously a cart was created for all users, including anonymous users, immediately if one was not found. This is not a breaking change for the core app, but any custom plugins may have code that will need to be updated to handle the possibility of there not being a cart.
- ⚡️ Update the signature of most cart methods to take an optional cartToken string param. Update all places that call these methods to pass in the token for anonymous carts.
- ⚡️ Carts and Orders no longer have userId. They now have accountId. Core client code has been updated, but custom code will need to look up the account for the user and then look up the cart or order from that.
- ⚡️ The CartItem SimpleSchema no longer includes variants and product, i.e., the entire variant and product objects are not copied to the cart item. Instead, certain properties that are needed are copied directly to the CartItem object. For example, item.productSlug. See the updated schema.
- 🚚
cart/removeCartMeteor method behavior is the same as before, but the return value is now{ cart } - ⚡️ The signature of the "cart/setAnonymousUserEmail" method has changed. It now takes cartId, token arguments. The client code that calls it has been updated, but any custom code calling it will need to be updated.
- Accounts.loginWithAnonymous is no longer available to client code. This was only used in one place, and similar logic has replaced it in that spot.
- ⏪ workflow/pushCartWorkflow and workflow/revertCartWorkflow methods now require that you pass in the cartId rather than guessing which cart you intend.
- In general, be aware that cart.accountId may now be null. Previously, it would be set even for anonymous carts, to the account for the user with "anonymous" role. For now, order.accountId is still set after an anonymous order is placed.
- The "Reaction.sessionId" stored ID is now used only for auto-login of anonymous users. It is not used by any of the cart code. Also, the "Sessions" collection is no longer written to or published to clients. It will not be dropped automatically, but you can drop it if you no longer need it.
Checkout
- 👀 Stripe checkout now uses Stripe Elements - for more details see #4325
🏷 Tags
- 👀 We're now limiting the tags publication to show only tags from the current active shop. This is more of a clarification of how this was supposed to work, but if you depended on all tags being published, this will cause unexpected behavior. See #4206 for specific changes.
Other
- 📦 Removal of previously included ancillary packages listed in the "Removing Optional Plugins" section
- 🚚 The function
createCatalogProducthas been moved into it's own file. This function was not being exported and should not create any issues, but be aware. - The Catalog schema has been changed. It was in a "use at your own risk" state before this, but if you've been using it you may have to migrate some data
- 🚚 We've removed the core plugin
Loggingwhich was used only by the Avalara plugin to this point. If you relied on this plugin, you'll need to reinstall it.
GraphQL
- In the GraphQL context, there is no longer a methods object. Instead you can call any method with context.callMeteorMethod(name, ...args).
- 🔌 In the GraphQL context, context.queries is now namespaced by which plugin the queries come from. For example, context.queries.userAccount is now context.queries.accounts.userAccount.
Notable Features
🚀 Deploy to Heroku Button
🚀 We've added a deploy to Heroku button which should appear in the project readme now. You can now deploy Reaction to Heroku by clicking the "Deploy to Heroku" button and then filling out hte information required by Heroku.
Hashing Products
We're now hashing products to determine when a product changes that have not been published to the Catalog. This shows up as an indicator on the publish button when viewing a product that has unpublished changes.
Serve js and css from CDN
👀 We now provide an option to serve the bundled javascript and css files from a CDN. See #4316 for more information.
robots.txt
0️⃣ We've added a permissive default
robots.txtfile. This file permits all bots to crawl and disallows bots from crawling/resourcesGraphQL DevServer
🔋 Features
- feat: GraphQL Cart Schema (#4307)
- feat: GraphQL Cart checkout schemas (#4390)
- feat: Add anonymousCartByCartId GraphQL query (#4382)
- feat: createCart mutation, addCartItems mutation, and related cart/order schema changes (#4412)
- 🔌 feat: Meteor-free addressBookAdd method and GraphQL plugin reorg (#4167)
- feat: Add
resolveAccountFromAccountIdresolver (#4495) - 🚚 feat: remove cart items (#4474)
- ⚡️ feat: update cart items quantity (#4472)
- feat: create reconcileCarts mutation (#4443)
- feat: Add accountCartByAccountId resolver (#4427)
Meteor App
🔋 Features
- feat: Shippo address validation (#4086)
- feat: Use token to create Stripe charges (#4325)
- 🚀 feat: Create deploy to heroku button (#4320)
- 🐳 feat: enable oplog in development Docker Compose config (#4420)
- feat: Create product hash of published product properties (#4336)
- feat: added CDN settings to reaction (#4316)
- feat: Indicator to notify of pending product changes not yet published to catalog (#4383)
- feat(marketplace): Limit Tags Publication to Those for the Current Shop (#4206)
- feat: add robots.txt file (#4370)
- 🚚 feat: Remove account from anon carts, don't use session for carts (#4496)
- feat(marketplace): Consideration for Marketplace Shops on Different URLs (#3332)
🛠 Fixes
- 🛠 fix: update and pin to latest version of sharp package (#4466)
- 🛠 fix: Use hashtags and tagIds to form tags obj (#4415) .. Resolves #4414
- 🛠 fix: Marketplace Settings (#4334) .. Resolves #4333
- 🛠 fix: update dependencies (#4444)
- 🛠 fix: Invalidate circleci caches (#4432)
- 🛠 fix: changing product handle throws 404 (#4403) Resolves #4023
- 🛠 fix: Tax and inventory toggle switches do not work (#4445) Resolves #4401
- 🛠 fix: Taxcloud with marketplace setup. (#4140) Resolves #4089
- 🛠 fix: Options now have parent's taxCode (#4182) Resolves #4141
- 🛠 fix(marketplace): also send notification to shop owners upon order creation (#4295)
- 🛠 fix: not publishing customer accounts (#4402) .. Resolves #4374
- 🛠 fix: Can't save discount codes (#4410) .. Resolves #4408
- 🛠 fix: Discount Codes React Table Not Rendering Correctly (#4411) .. Resolves #4247
- 🛠 fix: Unable to save custom tax rate (#4405) .. Resolves #4396
- 🛠 fix: low quantity/sold out flags not saving correctly in db (#4342)
- 🛠 fix: Scrolling to bottom adds more products to the view (#4243) .. Resolves #4090
- 🛠 fix: remove react-addons-create-fragment (#4164)
- 🛠 fix: change session active product when adding new product (#4313)
- 🛠 fix: missing styles on refund popover (#4300) .. Resolves #4005
- 🛠 fix: fix permissions of shop social settings (#4312)
- 🛠 fix: Archived products not being removed from Catalog (#4392)
- 🛠 fix: Default settings for parcel size (#4083)
- 🛠 fix: Update prerender.js (#4331)
- 🛠 fix(marketplace): Product Visibility for Marketplace Shops (#4259) .. Resolves #4092
- 🛠 fix: mislabeled schema (#4371)
- 🛠 fix: ActionView Component Typos (#4439)
- 🛠 fix: Cannot set replyTo or other field options when using Reaction.Email.send (#4380) .. Resolves #4343
- 🛠 fix: migration error preventing app startup (#4491)
- 🛠 fix: add media information to Variants and Options (#4468)
- 🛠 fix: Publish button infinite loop bug (#4488)
- 🛠 fix: client errors related to domain lookup changes (#4471)
🐎 Performance
- perf: Dynamically import Moment locales to reduce client bundle size (#4455) .. Resolves #4454
- perf: Improve app startup time when large number of Accounts/Users exists (#4449) .. Resolves #4384
🔨 Refactors
- 🔨 refactor: Use new Reaction component library components for the SMS settings form (#4318)
- 🔨 refactor: Remove "Catalog" from menu (#4385)
- 🔨 refactor: Move all /server files to plugins (#4366)
- 🔨 refactor: Update Catalog Schema (#4421)
🔌 Plugin Migration
- 🔨 refactor: Remove Shopify plugin (#4395)
- 🔨 refactor: Remove TaxCloud plugin (#4428)
- 🔨 refactor: Remove Avalara plugin (#4398)
- 🔨 refactor: Remove Authorize.net plugin (#4310)
- 🔨 refactor: Remove Paypal plugin (#4339)
- 🔨 refactor: Remove Braintree plugin (#4351)
- 🔨 refactor: Remove disabled TaxJar plugin (#4348)
- 🔨 refactor: Remove inventory package (#4388)
- 🔨 refactor: Remove shipping-shippo plugin (#4460)
- 🔨 refactor: Remove SMS plugin (#4451)
- 🔨 refactor: Remove unused discount-rates plugin (#4458)
- 🔨 refactor: remove unused logging (#4476)
Chores
- 🚀 chore: CircleCI step for deploying to an existing ECS cluster (#4487)
- 🔒 chore: make the snyk-security step a dependency for the docker-build step; s… (#4446)
Contributors
🚀 Thanks to @pmn4 and @hrath2015 for contributing to this release :tada:
📦 NPM Package Version Changes
This is a list of all new, changed, and removed dependencies that exist in our dependency graph for a production build. This does not include dev dependencies.
🆕 New Dependencies
@babel/[email protected] @babel/[email protected] @emotion/[email protected] @emotion/[email protected] @emotion/[email protected] @emotion/[email protected] @emotion/[email protected] @emotion/[email protected] @emotion/[email protected] @reactioncommerce/[email protected] @types/[email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected]⚡️ Updated Dependencies
[email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] /Users/spencer/reaction/reaction [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected] [email protected]✂ Removed Dependencies
42-cent-base 42-cent-util @braintree/wrap-promise @sindresorhus/is @types/node UNMET PEER DEPENDENCY graphql@^0.10.0 || ^0.11.0 || ^0.12.0 aphrodite array.prototype.flatten authorize-net base64url braintree buffer-crc32 cacheable-request chain-function clone-response connect-query dateformat debuglog deprecate duplexer3 from2 got has-symbol-support-x has-to-string-tag-x http-cache-semantics into-stream is-object is-plain-obj is-retry-allowed isemail isurl joi json-buffer json-stable-stringify jsonify jsonwebtoken keyv lodash.isboolean lodash.isinteger lodash.isnumber lodash.once lowercase-keys nexmo normalize-url p-cancelable p-is-promise p-timeout paypal-rest-sdk pop-iterate prepend-http q react-addons-create-fragment react-addons-pure-render-mixin responselike rootpath scmp shippo shopify-api-node sort-keys stopcock string-hash timed-out topo twilio url-parse-lax url-to-options weak-mapMetrics
🚀 You don't improve what you don't measure. In efforts to improve the size of our bundles, the time to first paint, time to interactive, and overall performance of our applications, we're starting to report on bundle size and some performance metrics in every release. With effort and persistence, we'll see these numbers improve over time.
Bundle Size
🏗 We measure bundle size by building the application using
meteor buildand then measuring the js and css bundle size with the commandwc -c /path/to/js-bundle-file.js💻 JS Modern Browsers: 4872kb 💻 JS Legacy Browsers: 5104kb 💻 CSS All Browsers: 392kb