From 83724bbf44457879cab891addebe447a2e30e27a Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:07:22 -0700
Subject: [PATCH 01/26] docs(README): Update

---
 .travis.yml                       |  1 +
 packages/optimizely-sdk/README.md | 70 +++++++++++++++----------------
 2 files changed, 34 insertions(+), 37 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 96c7729ea..00d4ac9d8 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,5 +1,6 @@
 language: node_js
 node_js:
+- '0.10.0'
 - '4'
 - '6'
 - '8'
diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index 3a37a0642..cca169e33 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -1,22 +1,33 @@
-# Optimizely JavaScript SDK
+[![npm](https://img.shields.io/npm/v/%40optimizely%2Foptimizely-sdk.svg)](https://www.npmjs.com/package/@optimizely/optimizely-sdk)
+[![npm](https://img.shields.io/npm/dm/%40optimizely%2Foptimizely-sdk.svg)](https://www.npmjs.com/package/@optimizely/optimizely-sdk)
+[![Travis CI](https://img.shields.io/travis/optimizely/javascript-sdk.svg)](https://travis-ci.org/optimizely/javascript-sdk)
 
-This repository houses the JavaScript SDK for Optimizely X Full Stack.
+# JavaScript SDK for Optimizely X Full Stack
+
+Optimizely X Full Stack is A/B testing and feature management for product development teams. Experiment in any application. Make every feature on your roadmap an opportunity to learn. Learn more at https://www.optimizely.com/products/full-stack/, or see the [documentation](https://developers.optimizely.com/x/solutions/sdks/reference/index.html?language=node).
+
+This directory contains the source code for the JavaScript SDK, which is usable in both Node.js and web environments.
 
 ## Getting Started
 
-### Installing the SDK
+### Prerequisites
 
-The SDK is available through [npm](https://npmjs.com/package/optimizely-sdk). To install:
+Ensure the SDK supports all of the platforms you're targeting. In particular, we support any ES5-compliant JavaScript environment, including
+  - Node.js >= 0.10.0, and maybe even earlier. CI validates 0.10.0 and the latest version of all [LTS](https://github.com/nodejs/Release) releases from 4.x onward. By extension, places like AWS Lambda, Google Cloud Functions, and Auth0 Webtasks.
+  - [Web browsers](https://caniuse.com/#feat=es5)
+  - [Cloudflare Workers](https://developers.cloudflare.com/workers/) and [Fly](https://fly.io/), both of which are powered by V8.
+  - Anywhere else you can think of that might embed a JavaScript engine. The sky is the limit; experiment everywhere 🚀 !
+
+Once you've validated that the SDK supports the platforms you're targeting, fetch the package from [NPM](https://www.npmjs.com/package/@optimizely/optimizely-sdk). Using `npm`:
 
 ```
 npm install @optimizely/optimizely-sdk --save
 ```
 
-Or to use in a non CommonJS fashion in the Browser:
+### Usage
+See the Optimizely X Full Stack [developer documentation](http://developers.optimizely.com/server/reference/index.html) to learn how to set up your first JavaScript project and use the SDK.
 
-1. Run `npm run build`
-2. Pull in `dist/optimizely.browser.umd.min.js` as a `<script>`
-3. Use as global variable `window.optimizelyClient`
+Regarding `EventDispatcher`s: In Node.js and browser environments, the default `EventDispatcher` is powered by the [`http/s`](https://nodejs.org/api/http.html) modules and by [`XMLHttpRequest`](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest#Browser_compatibility), respectively. In all other environments, you must supply your own `EventDispatcher`.
 
 ### Migrating from 1.x.x
 
@@ -28,41 +39,26 @@ This version represents a major version change and, as such, introduces some bre
 
 - You will no longer be able to pass in `revenue` value as a stand-alone argument to the `track` call. Instead you will need to pass it as an entry in the [`eventTags`](https://developers.optimizely.com/x/solutions/sdks/reference/index.html?language=javascript#event-tags).
 
-### Feature Management Access
-
-To access the Feature Management configuration in the Optimizely dashboard, please contact your Optimizely account executive.
+### Feature Management access
 
-### Using the SDK
-See the Optimizely X Full Stack testing [developer documentation](http://developers.optimizely.com/server/reference/index.html) to learn how to set up your first JavaScript project and use the SDK.
+To access Feature Management in the Optimizely web application, please contact your Optimizely account executive.
 
-## Development
+## Contributing
+This information is relevant only if you plan on contributing to the SDK itself.
 
-### Installing dependencies
+```sh
+# Prerequisite: Install dependencies.
+npm install
 
-```npm install```
-
-### Unit tests
-
-You can run all unit tests with:
-```
+# Run unit tests with mocha.
 npm test
-```
-
-### Build distribution packages
 
+# Run unit tests in many browsers, currently via BrowserStack.
+# For this to work, the following environment variables must be set:
+#   - BROWSER_STACK_USERNAME
+#   - BROWSER_STACK_PASSWORD
+npm run test-xbrowser
 ```
-npm run build
-```
-
-This command will build several distribution bundles under the `dist` directory:
-1. optimizely.browser.cjs.js - This is the main entry point for browser/client-side bundles
-2. optimizely.browser.umd.js - This is used when not packaging the optimizely-sdk with your own JS bundles. Instead you would load this script as a `<script>` tag and reference it via the global var `optimizelyClient`
-3. optimizely.node.js - This is the main entry point for Node apps
-
-The browser bundles also come with a minified / production-ready version.
-
-### Environment Variables
 
-The .yml of this project contains environment vairables for ```BROWSER_STACK_USERNAME``` and ```BROWSER_STACK_ACCESS_KEY```.
+[.travis.yml](./.travis.yml) contains the definitions for `BROWSER_STACK_USERNAME` and `BROWSER_STACK_ACCESS_KEY` used in CI. These values are Optimizely's BrowserStack credentials, encrypted with our Travis CI public key. These creds can be rotated by following [these docs](https://docs.travis-ci.com/user/encrypting-files/).
 
-These variables, created in BrowserStack, are encrypted by the Travis CI public key. This is done directly with the Travis CI command line tools; for additional information see travis encrypt-file.

From 260b7806d18420221a1c149ac2f486489e783215 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:10:28 -0700
Subject: [PATCH 02/26] theoiaw

---
 packages/optimizely-sdk/README.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index cca169e33..f974d8913 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -1,9 +1,8 @@
+# JavaScript SDK for Optimizely X Full Stack
 [![npm](https://img.shields.io/npm/v/%40optimizely%2Foptimizely-sdk.svg)](https://www.npmjs.com/package/@optimizely/optimizely-sdk)
 [![npm](https://img.shields.io/npm/dm/%40optimizely%2Foptimizely-sdk.svg)](https://www.npmjs.com/package/@optimizely/optimizely-sdk)
 [![Travis CI](https://img.shields.io/travis/optimizely/javascript-sdk.svg)](https://travis-ci.org/optimizely/javascript-sdk)
 
-# JavaScript SDK for Optimizely X Full Stack
-
 Optimizely X Full Stack is A/B testing and feature management for product development teams. Experiment in any application. Make every feature on your roadmap an opportunity to learn. Learn more at https://www.optimizely.com/products/full-stack/, or see the [documentation](https://developers.optimizely.com/x/solutions/sdks/reference/index.html?language=node).
 
 This directory contains the source code for the JavaScript SDK, which is usable in both Node.js and web environments.
@@ -16,7 +15,7 @@ Ensure the SDK supports all of the platforms you're targeting. In particular, we
   - Node.js >= 0.10.0, and maybe even earlier. CI validates 0.10.0 and the latest version of all [LTS](https://github.com/nodejs/Release) releases from 4.x onward. By extension, places like AWS Lambda, Google Cloud Functions, and Auth0 Webtasks.
   - [Web browsers](https://caniuse.com/#feat=es5)
   - [Cloudflare Workers](https://developers.cloudflare.com/workers/) and [Fly](https://fly.io/), both of which are powered by V8.
-  - Anywhere else you can think of that might embed a JavaScript engine. The sky is the limit; experiment everywhere 🚀 !
+  - Anywhere else you can think of that might embed a JavaScript engine. The sky is the limit; experiment everywhere 🚀!
 
 Once you've validated that the SDK supports the platforms you're targeting, fetch the package from [NPM](https://www.npmjs.com/package/@optimizely/optimizely-sdk). Using `npm`:
 

From d4266fdbc6bd390129e9ee349b50a75adb051219 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:20:00 -0700
Subject: [PATCH 03/26] Add npm workaround

---
 .travis.yml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 00d4ac9d8..58103daa0 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -16,7 +16,12 @@ env:
   - secure: WnyM4gMsi2n69O/YZUD/pYwHJXdKDcBv3Hwft2cCw52yYc+z75uuRgdaLKs4BPisckBtnR17dH7hKlPX3HWwjCoqQm1q5qNpbJrArWaEcbotWGF2YFy21ZZ4rKNQmJqdgRj6XFZhLHbncA8v2gQPK7F6GUJ0vsJF/kiTfxAUjefR23oorcKSQrh9BfOxNAYu2Ma92qlaaMmHYbBdlNDM45/EQE+LnPCfboCiJD/5zTYq4Q+XhKLPV01vUDU60pj9ckDNXyLj9X2BwMbAzGAPGE4qTAB/IrMndVsUXblsahtwKQ6yrsUrsdTASz8/3oNkImtY7fqU874jSeG3d7PNBfZs47zkXEVy73ZWNBgM9rzVS5cPaIU3wqpuBoXFntDJcdHQhNTWEYdxmtcTUmxKt5TdUzDhrrkcti2WVLabU3N52aOBeOM0XBpfLkbV+HT6oWi3bNUb+EDMHvCxOxsP4IoEDfFs9HMzNIO3mmC3+2DFbI7s2Mb2oacAut38MbJDYSDTOLL4smG8scA3E0RQO4r8+TNk4aRIMQc7vCKqz7PpbO7Aj9dXSpeHrDmIszSmEoQqmaaGsRBwbXRom2P8fB9FcTbd/wbsfgoFNEPz5DlbtCtCmt0pQMa+3myWveKH52WC5KlFijBSDjYOMUnXbLnj5fK5eKaWp+z6/qcNwU8=
   # BROWSER_STACK_ACCESS_KEY
   - secure: U0GGZw46rJowBtH9gVluIrerB40u2b3uZpH0HsOdLlsXCCaTVk4JXX/JPVPashWAFLC7Enk3UOE4ofeEpVd0wbG6CxtG9/gklc2U2tvkqsdPpFZKaRrXoUzCyyPOmHEC2mXDXctbrncmttM4APaceRfbdTBEZIIfyLJadomjWylA61szFE9IZjvJpiwJO2xa5HI9GVRu3yXJci+riJux+JsDmfJ1hNwv3waMeeg/scddUH0hfgq69ftGs8cpMlYiO20eh32S7uPF7/IJTH1fDJjVKYQZwpypkF6AeI+od5CFTY1ajb25eaBNXThLS0Bo9ZJE/8Sogvon21dEJkt/ClY6R341InbAFXZvz7jyQAisvh0I4zxcu0VUCfh7bEUl6GXMO8VJnyxHEfqB+AIT2RoMXckkhulwiNUsJYH1yJ8mjnLvZq85mWBCp4n4jg0K6Wf46lHpjnHOVpLyLyoFGfiPf90AQVL02AJ3/ia8RkMuj0Ax+AGtiTC/+wy7dsDQOif/VpBNJcx/RciQ24mYOGzAMh4GsUWnXaZ9vXSxliogVNrmIefK5invJ0omv9pIx8NZHTHYGaulh4w6JsliiEq2kH78SlyvSrcsFGTwCY97LLaxiLm/75/Zf+F7LajKC23Fbtnj/LQizitFZqGMJ09DnR52krBAeultqRq8QLM=
-before_install: cd packages/optimizely-sdk
+before_install:
+- cd packages/optimizely-sdk
+# Scopes were added in npm@2, source: https://blog.npmjs.org/post/116936804365/solving-npms-hard-problem-naming-packages
+# This is needed to be able to install the SDK from NPM when testing Node.js versions
+# that shipped with an npm < 2.0.0.
+- if [ "$(node -v)" = "v0.10.0" ]; then npm install -g npm@2.0.0; fi
 install: npm install
 addons:
   srcclr: true

From a183ea96a400df35fae6daff81ea188040e34ee7 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:23:11 -0700
Subject: [PATCH 04/26] Use complete sentences

---
 packages/optimizely-sdk/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index f974d8913..5131dd52b 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -12,7 +12,7 @@ This directory contains the source code for the JavaScript SDK, which is usable
 ### Prerequisites
 
 Ensure the SDK supports all of the platforms you're targeting. In particular, we support any ES5-compliant JavaScript environment, including
-  - Node.js >= 0.10.0, and maybe even earlier. CI validates 0.10.0 and the latest version of all [LTS](https://github.com/nodejs/Release) releases from 4.x onward. By extension, places like AWS Lambda, Google Cloud Functions, and Auth0 Webtasks.
+  - Node.js >= 0.10.0, and maybe even earlier. CI validates 0.10.0 and the latest version of all [LTS](https://github.com/nodejs/Release) releases from 4.x onward. By extension, places like AWS Lambda, Google Cloud Functions, and Auth0 Webtasks are supported as well.
   - [Web browsers](https://caniuse.com/#feat=es5)
   - [Cloudflare Workers](https://developers.cloudflare.com/workers/) and [Fly](https://fly.io/), both of which are powered by V8.
   - Anywhere else you can think of that might embed a JavaScript engine. The sky is the limit; experiment everywhere 🚀!

From a4c16a1f2deeec81d622044a76dbf9d7d990913b Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:24:42 -0700
Subject: [PATCH 05/26] Fix travis yml link, hopefully

---
 packages/optimizely-sdk/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index 5131dd52b..e26ee670e 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -59,5 +59,5 @@ npm test
 npm run test-xbrowser
 ```
 
-[.travis.yml](./.travis.yml) contains the definitions for `BROWSER_STACK_USERNAME` and `BROWSER_STACK_ACCESS_KEY` used in CI. These values are Optimizely's BrowserStack credentials, encrypted with our Travis CI public key. These creds can be rotated by following [these docs](https://docs.travis-ci.com/user/encrypting-files/).
+[.travis.yml](/.travis.yml) contains the definitions for `BROWSER_STACK_USERNAME` and `BROWSER_STACK_ACCESS_KEY` used in CI. These values are Optimizely's BrowserStack credentials, encrypted with our Travis CI public key. These creds can be rotated by following [these docs](https://docs.travis-ci.com/user/encrypting-files/).
 

From e50ba3a4386630c4205da917178ec5717d10ae32 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:36:24 -0700
Subject: [PATCH 06/26] Use 0.10.44

---
 .travis.yml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 58103daa0..dbff08ac4 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,6 +1,10 @@
 language: node_js
 node_js:
-- '0.10.0'
+# The earliest version of Node.js which shipped with npm@2.x. This is relevant because support
+# for package scopes (e.g., @optimizely/...), was added in npm@2 (https://blog.npmjs.org/post/116936804365/solving-npms-hard-problem-naming-packages).
+# Additionally, we can't simply use an earlier version of Node.js and `npm install -g npm@2.0.0` because
+# npm 1.x can't even fetch and install npm@2--it errors with "Error: CERT_UNTRUSTED" while fetching.
+- '0.10.44'
 - '4'
 - '6'
 - '8'
@@ -18,10 +22,6 @@ env:
   - secure: U0GGZw46rJowBtH9gVluIrerB40u2b3uZpH0HsOdLlsXCCaTVk4JXX/JPVPashWAFLC7Enk3UOE4ofeEpVd0wbG6CxtG9/gklc2U2tvkqsdPpFZKaRrXoUzCyyPOmHEC2mXDXctbrncmttM4APaceRfbdTBEZIIfyLJadomjWylA61szFE9IZjvJpiwJO2xa5HI9GVRu3yXJci+riJux+JsDmfJ1hNwv3waMeeg/scddUH0hfgq69ftGs8cpMlYiO20eh32S7uPF7/IJTH1fDJjVKYQZwpypkF6AeI+od5CFTY1ajb25eaBNXThLS0Bo9ZJE/8Sogvon21dEJkt/ClY6R341InbAFXZvz7jyQAisvh0I4zxcu0VUCfh7bEUl6GXMO8VJnyxHEfqB+AIT2RoMXckkhulwiNUsJYH1yJ8mjnLvZq85mWBCp4n4jg0K6Wf46lHpjnHOVpLyLyoFGfiPf90AQVL02AJ3/ia8RkMuj0Ax+AGtiTC/+wy7dsDQOif/VpBNJcx/RciQ24mYOGzAMh4GsUWnXaZ9vXSxliogVNrmIefK5invJ0omv9pIx8NZHTHYGaulh4w6JsliiEq2kH78SlyvSrcsFGTwCY97LLaxiLm/75/Zf+F7LajKC23Fbtnj/LQizitFZqGMJ09DnR52krBAeultqRq8QLM=
 before_install:
 - cd packages/optimizely-sdk
-# Scopes were added in npm@2, source: https://blog.npmjs.org/post/116936804365/solving-npms-hard-problem-naming-packages
-# This is needed to be able to install the SDK from NPM when testing Node.js versions
-# that shipped with an npm < 2.0.0.
-- if [ "$(node -v)" = "v0.10.0" ]; then npm install -g npm@2.0.0; fi
 install: npm install
 addons:
   srcclr: true

From b0838263cf53ab34a85358759404ab5a0db84a09 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:36:28 -0700
Subject: [PATCH 07/26] Add Coveralls badge

---
 packages/optimizely-sdk/README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index e26ee670e..d27ccf4aa 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -2,6 +2,8 @@
 [![npm](https://img.shields.io/npm/v/%40optimizely%2Foptimizely-sdk.svg)](https://www.npmjs.com/package/@optimizely/optimizely-sdk)
 [![npm](https://img.shields.io/npm/dm/%40optimizely%2Foptimizely-sdk.svg)](https://www.npmjs.com/package/@optimizely/optimizely-sdk)
 [![Travis CI](https://img.shields.io/travis/optimizely/javascript-sdk.svg)](https://travis-ci.org/optimizely/javascript-sdk)
+[![Coveralls](https://img.shields.io/coveralls/optimizely/javascript-sdk.svg)](https://coveralls.io/github/optimizely/javascript-sdk)
+
 
 Optimizely X Full Stack is A/B testing and feature management for product development teams. Experiment in any application. Make every feature on your roadmap an opportunity to learn. Learn more at https://www.optimizely.com/products/full-stack/, or see the [documentation](https://developers.optimizely.com/x/solutions/sdks/reference/index.html?language=node).
 

From 818aaa10e58fba10bd9add98736672ece86e5f68 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:46:34 -0700
Subject: [PATCH 08/26] Give a better link to Travis encrypted env var docs

---
 packages/optimizely-sdk/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index d27ccf4aa..a3999ea4f 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -61,5 +61,5 @@ npm test
 npm run test-xbrowser
 ```
 
-[.travis.yml](/.travis.yml) contains the definitions for `BROWSER_STACK_USERNAME` and `BROWSER_STACK_ACCESS_KEY` used in CI. These values are Optimizely's BrowserStack credentials, encrypted with our Travis CI public key. These creds can be rotated by following [these docs](https://docs.travis-ci.com/user/encrypting-files/).
+[.travis.yml](/.travis.yml) contains the definitions for `BROWSER_STACK_USERNAME` and `BROWSER_STACK_ACCESS_KEY` used in CI. These values are Optimizely's BrowserStack credentials, encrypted with our Travis CI public key. These creds can be rotated by following [these docs](https://docs.travis-ci.com/user/environment-variables/#Defining-encrypted-variables-in-.travis.yml).
 

From c86675364221cb42eef4f7711dfdf53942d80bb3 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:51:09 -0700
Subject: [PATCH 09/26] Fix badge link in root readme

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 68d030ed7..62d8ea192 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
 </h3>
 
 <p align="center">
-  This repository houses the official JavaScript SDK for use with Optimizely X Full Stack
+  This repository houses the official JavaScript SDK for use with Optimizely X Full Stack.
 </p>
 
 ## Packages
@@ -12,7 +12,7 @@ This repository is a monorepo that we manage using [Lerna](https://github.com/le
 
 | Package                                                | Version                                                                                                                                   | Docs                                                                                                                                                                                                                                                                          | Description                                                                        |
 | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
-| [`optimizely-sdk`](/packages/optimizely-sdk)               | [![npm](https://img.shields.io/npm/v/optimizely-sdk.svg?style=flat-square)](https://npmjs.com/package/@optimizely/optimizely-sdk)                     | [![](https://img.shields.io/badge/API%20Docs-site-green.svg?style=flat-square)](https://developers.optimizely.com/x/solutions/sdks/reference/?language=javascript)           | The Optimizely SDK                                                                                                  |
+| [`@optimizely/optimizely-sdk`](/packages/optimizely-sdk) | [![npm](https://img.shields.io/npm/v/%40optimizely%2Foptimizely-sdk.svg)](https://www.npmjs.com/package/@optimizely/optimizely-sdk)     | [![](https://img.shields.io/badge/API%20Docs-site-green.svg?style=flat-square)](https://developers.optimizely.com/x/solutions/sdks/reference/?language=javascript)           | The Optimizely SDK                                                                                                  |
 
 ## About
 

From 2aff7da51b059ec10980733016bb23aa8e974e7d Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:51:20 -0700
Subject: [PATCH 10/26] Use right package name

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 62d8ea192..fa71346a2 100644
--- a/README.md
+++ b/README.md
@@ -16,7 +16,7 @@ This repository is a monorepo that we manage using [Lerna](https://github.com/le
 
 ## About
 
-`optimizely-sdk` is developed and maintained by [Optimizely](https://optimizely.com) and many [contributors](https://github.com/optimizely/javascript-sdk/graphs/contributors). If you're interested in learning more about what Optimizely X FullStack can do for your company, please [get in touch](mailto:eng@optimizely.com)!
+`@optimizely/optimizely-sdk` is developed and maintained by [Optimizely](https://optimizely.com) and many [contributors](https://github.com/optimizely/javascript-sdk/graphs/contributors). If you're interested in learning more about what Optimizely X Full Stack can do for your company, please [get in touch](mailto:eng@optimizely.com)!
 
 
 ### Contributing

From d3bb631e281a9f3633dbae0c7174d41cf54f5eaf Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:51:30 -0700
Subject: [PATCH 11/26] Add blurb to root readme

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index fa71346a2..5a2295ff5 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,8 @@
   This repository houses the official JavaScript SDK for use with Optimizely X Full Stack.
 </p>
 
+Optimizely X Full Stack is A/B testing and feature management for product development teams. Experiment in any application. Make every feature on your roadmap an opportunity to learn. Learn more at https://www.optimizely.com/products/full-stack/, or see the [documentation](https://developers.optimizely.com/x/solutions/sdks/reference/index.html?language=node).
+
 ## Packages
 
 This repository is a monorepo that we manage using [Lerna](https://github.com/lerna/lerna). That means that we actually publish [several packages](/packages) to npm from the same codebase, including:

From 724d1d52279a5a84dbec1c6320fcb68142f11e9e Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:51:37 -0700
Subject: [PATCH 12/26] Clarify Lerna usage

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5a2295ff5..64b80f460 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@ Optimizely X Full Stack is A/B testing and feature management for product develo
 
 ## Packages
 
-This repository is a monorepo that we manage using [Lerna](https://github.com/lerna/lerna). That means that we actually publish [several packages](/packages) to npm from the same codebase, including:
+This repository is a monorepo that we manage using [Lerna](https://github.com/lerna/lerna). Only one package lives here currently, but that may change in the future.
 
 | Package                                                | Version                                                                                                                                   | Docs                                                                                                                                                                                                                                                                          | Description                                                                        |
 | ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |

From 09b5afd57595057e3f4e377166a5ccde67e3d034 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 15:58:42 -0700
Subject: [PATCH 13/26] Add license badge

---
 packages/optimizely-sdk/README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index a3999ea4f..f72bbf0da 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -3,6 +3,7 @@
 [![npm](https://img.shields.io/npm/dm/%40optimizely%2Foptimizely-sdk.svg)](https://www.npmjs.com/package/@optimizely/optimizely-sdk)
 [![Travis CI](https://img.shields.io/travis/optimizely/javascript-sdk.svg)](https://travis-ci.org/optimizely/javascript-sdk)
 [![Coveralls](https://img.shields.io/coveralls/optimizely/javascript-sdk.svg)](https://coveralls.io/github/optimizely/javascript-sdk)
+[![license](https://img.shields.io/github/license/optimizely/javascript-sdk.svg)](https://choosealicense.com/licenses/apache-2.0/)
 
 
 Optimizely X Full Stack is A/B testing and feature management for product development teams. Experiment in any application. Make every feature on your roadmap an opportunity to learn. Learn more at https://www.optimizely.com/products/full-stack/, or see the [documentation](https://developers.optimizely.com/x/solutions/sdks/reference/index.html?language=node).

From 67cfbf6dc1d499d3a8252cd7b952c14fc5f6ec21 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 17:28:16 -0700
Subject: [PATCH 14/26] refactor(scripts): Use Karma CLI rather than grunt

---
 packages/optimizely-sdk/Gruntfile.js      |  16 -
 packages/optimizely-sdk/package-lock.json | 447 ----------------------
 packages/optimizely-sdk/package.json      |   5 +-
 3 files changed, 1 insertion(+), 467 deletions(-)
 delete mode 100644 packages/optimizely-sdk/Gruntfile.js

diff --git a/packages/optimizely-sdk/Gruntfile.js b/packages/optimizely-sdk/Gruntfile.js
deleted file mode 100644
index ef9e1abdd..000000000
--- a/packages/optimizely-sdk/Gruntfile.js
+++ /dev/null
@@ -1,16 +0,0 @@
-module.exports = function (grunt) {
-    grunt.initConfig({
-        karma: {
-            unit: {
-                configFile: 'karma.bs.conf.js',
-                singleRun: true,
-                reporters: 'progress',
-                runnerPort: 9998
-            }
-        }
-    });
-
-    require('load-grunt-tasks')(grunt);
-
-    grunt.registerTask('default', ['karma']);
-};
diff --git a/packages/optimizely-sdk/package-lock.json b/packages/optimizely-sdk/package-lock.json
index ea1ac3f9e..3db8c2a3b 100644
--- a/packages/optimizely-sdk/package-lock.json
+++ b/packages/optimizely-sdk/package-lock.json
@@ -219,18 +219,6 @@
       "integrity": "sha1-45sJrqne+Gao8gbiiK9jkZuuOcQ=",
       "dev": true
     },
-    "array-differ": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/array-differ/-/array-differ-0.1.0.tgz",
-      "integrity": "sha1-EuLJtwa+1HyLSDtX5IdHP7CGHzo=",
-      "dev": true
-    },
-    "array-find-index": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/array-find-index/-/array-find-index-1.0.2.tgz",
-      "integrity": "sha1-3wEKoSh+Fku9pvlyOwqWoexBh6E=",
-      "dev": true
-    },
     "array-slice": {
       "version": "0.2.3",
       "resolved": "https://registry.npmjs.org/array-slice/-/array-slice-0.2.3.tgz",
@@ -920,22 +908,6 @@
       "integrity": "sha1-r6uWJikQp/M8GaV3WCXGnzTjUMo=",
       "dev": true
     },
-    "camelcase": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-2.1.1.tgz",
-      "integrity": "sha1-fB0W1nmhu+WcoCys7PsBHiAfWh8=",
-      "dev": true
-    },
-    "camelcase-keys": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/camelcase-keys/-/camelcase-keys-2.1.0.tgz",
-      "integrity": "sha1-MIvur/3ygRkFHvodkyITyRuPkuc=",
-      "dev": true,
-      "requires": {
-        "camelcase": "^2.0.0",
-        "map-obj": "^1.0.0"
-      }
-    },
     "caseless": {
       "version": "0.12.0",
       "resolved": "https://registry.npmjs.org/caseless/-/caseless-0.12.0.tgz",
@@ -1094,12 +1066,6 @@
       "integrity": "sha1-DQcLTQQ6W+ozovGkDi7bPZpMz3c=",
       "dev": true
     },
-    "coffeescript": {
-      "version": "1.10.0",
-      "resolved": "https://registry.npmjs.org/coffeescript/-/coffeescript-1.10.0.tgz",
-      "integrity": "sha1-56qDAZF+9iGzXYo580jc3R234z4=",
-      "dev": true
-    },
     "collection-visit": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/collection-visit/-/collection-visit-1.0.0.tgz",
@@ -1469,15 +1435,6 @@
         "randomfill": "^1.0.3"
       }
     },
-    "currently-unhandled": {
-      "version": "0.4.1",
-      "resolved": "https://registry.npmjs.org/currently-unhandled/-/currently-unhandled-0.4.1.tgz",
-      "integrity": "sha1-mI3zP+qxke95mmE2nddsF635V+o=",
-      "dev": true,
-      "requires": {
-        "array-find-index": "^1.0.1"
-      }
-    },
     "custom-event": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/custom-event/-/custom-event-1.0.1.tgz",
@@ -1521,16 +1478,6 @@
       "integrity": "sha1-6vQ5/U1ISK105cx9vvIAZyueNFs=",
       "dev": true
     },
-    "dateformat": {
-      "version": "1.0.12",
-      "resolved": "https://registry.npmjs.org/dateformat/-/dateformat-1.0.12.tgz",
-      "integrity": "sha1-nxJLZ1lMk3/3BpMuSmQsyo27/uk=",
-      "dev": true,
-      "requires": {
-        "get-stdin": "^4.0.1",
-        "meow": "^3.3.0"
-      }
-    },
     "debug": {
       "version": "2.6.9",
       "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
@@ -2129,12 +2076,6 @@
         "es5-ext": "~0.10.14"
       }
     },
-    "eventemitter2": {
-      "version": "0.4.14",
-      "resolved": "https://registry.npmjs.org/eventemitter2/-/eventemitter2-0.4.14.tgz",
-      "integrity": "sha1-j2G3XN4BKy6esoTUVFWDtWQ7Yas=",
-      "dev": true
-    },
     "eventemitter3": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-3.1.0.tgz",
@@ -2157,12 +2098,6 @@
         "safe-buffer": "^5.1.1"
       }
     },
-    "exit": {
-      "version": "0.1.2",
-      "resolved": "https://registry.npmjs.org/exit/-/exit-0.1.2.tgz",
-      "integrity": "sha1-BjJjj42HfMghB9MKD/8aF8uhzQw=",
-      "dev": true
-    },
     "exit-hook": {
       "version": "1.1.1",
       "resolved": "https://registry.npmjs.org/exit-hook/-/exit-hook-1.1.1.tgz",
@@ -2372,30 +2307,6 @@
         "pinkie-promise": "^2.0.0"
       }
     },
-    "findup-sync": {
-      "version": "0.3.0",
-      "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-0.3.0.tgz",
-      "integrity": "sha1-N5MKpdgWt3fANEXhlmzGeQpMCxY=",
-      "dev": true,
-      "requires": {
-        "glob": "~5.0.0"
-      },
-      "dependencies": {
-        "glob": {
-          "version": "5.0.15",
-          "resolved": "https://registry.npmjs.org/glob/-/glob-5.0.15.tgz",
-          "integrity": "sha1-G8k2ueAvSmA/zCIuz3Yz0wuLk7E=",
-          "dev": true,
-          "requires": {
-            "inflight": "^1.0.4",
-            "inherits": "2",
-            "minimatch": "2 || 3",
-            "once": "^1.3.0",
-            "path-is-absolute": "^1.0.0"
-          }
-        }
-      }
-    },
     "flat-cache": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-1.3.0.tgz",
@@ -3179,12 +3090,6 @@
       "integrity": "sha1-9wLmMSfn4jHBYKgMFVSstw1QR+U=",
       "dev": true
     },
-    "get-stdin": {
-      "version": "4.0.1",
-      "resolved": "https://registry.npmjs.org/get-stdin/-/get-stdin-4.0.1.tgz",
-      "integrity": "sha1-uWjGsKBDhDJJAui/Gl3zJXmkUP4=",
-      "dev": true
-    },
     "get-uri": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/get-uri/-/get-uri-2.0.2.tgz",
@@ -3206,12 +3111,6 @@
       "integrity": "sha1-3BXKHGcjh8p2vTesCjlbogQqLCg=",
       "dev": true
     },
-    "getobject": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/getobject/-/getobject-0.1.0.tgz",
-      "integrity": "sha1-BHpEl4n6Fg0Bj1SG7ZEyC27HiFw=",
-      "dev": true
-    },
     "getpass": {
       "version": "0.1.7",
       "resolved": "https://registry.npmjs.org/getpass/-/getpass-0.1.7.tgz",
@@ -3286,150 +3185,6 @@
       "integrity": "sha1-Dqd0NxXbjY3ixe3hd14bRayFwC8=",
       "dev": true
     },
-    "grunt": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/grunt/-/grunt-1.0.2.tgz",
-      "integrity": "sha1-TmpeaVtwRy/VME9fqeNCNoNqc7w=",
-      "dev": true,
-      "requires": {
-        "coffeescript": "~1.10.0",
-        "dateformat": "~1.0.12",
-        "eventemitter2": "~0.4.13",
-        "exit": "~0.1.1",
-        "findup-sync": "~0.3.0",
-        "glob": "~7.0.0",
-        "grunt-cli": "~1.2.0",
-        "grunt-known-options": "~1.1.0",
-        "grunt-legacy-log": "~1.0.0",
-        "grunt-legacy-util": "~1.0.0",
-        "iconv-lite": "~0.4.13",
-        "js-yaml": "~3.5.2",
-        "minimatch": "~3.0.2",
-        "nopt": "~3.0.6",
-        "path-is-absolute": "~1.0.0",
-        "rimraf": "~2.2.8"
-      },
-      "dependencies": {
-        "glob": {
-          "version": "7.0.6",
-          "resolved": "https://registry.npmjs.org/glob/-/glob-7.0.6.tgz",
-          "integrity": "sha1-IRuvr0nlJbjNkyYNFKsTYVKz9Xo=",
-          "dev": true,
-          "requires": {
-            "fs.realpath": "^1.0.0",
-            "inflight": "^1.0.4",
-            "inherits": "2",
-            "minimatch": "^3.0.2",
-            "once": "^1.3.0",
-            "path-is-absolute": "^1.0.0"
-          }
-        },
-        "grunt-cli": {
-          "version": "1.2.0",
-          "resolved": "https://registry.npmjs.org/grunt-cli/-/grunt-cli-1.2.0.tgz",
-          "integrity": "sha1-VisRnrsGndtGSs4oRVAb6Xs1tqg=",
-          "dev": true,
-          "requires": {
-            "findup-sync": "~0.3.0",
-            "grunt-known-options": "~1.1.0",
-            "nopt": "~3.0.6",
-            "resolve": "~1.1.0"
-          }
-        },
-        "js-yaml": {
-          "version": "3.5.5",
-          "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.5.5.tgz",
-          "integrity": "sha1-A3fDgBfKvHMisNH7zSWkkWQfL74=",
-          "dev": true,
-          "requires": {
-            "argparse": "^1.0.2",
-            "esprima": "^2.6.0"
-          }
-        },
-        "rimraf": {
-          "version": "2.2.8",
-          "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-2.2.8.tgz",
-          "integrity": "sha1-5Dm+Kq7jJzIZUnMPmaiSnk/FBYI=",
-          "dev": true
-        }
-      }
-    },
-    "grunt-karma": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/grunt-karma/-/grunt-karma-2.0.0.tgz",
-      "integrity": "sha1-dTWD0RXf3AVf5X5Y+W1rPH5hIRg=",
-      "dev": true,
-      "requires": {
-        "lodash": "^3.10.1"
-      },
-      "dependencies": {
-        "lodash": {
-          "version": "3.10.1",
-          "resolved": "https://registry.npmjs.org/lodash/-/lodash-3.10.1.tgz",
-          "integrity": "sha1-W/Rejkm6QYnhfUgnid/RW9FAt7Y=",
-          "dev": true
-        }
-      }
-    },
-    "grunt-known-options": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/grunt-known-options/-/grunt-known-options-1.1.0.tgz",
-      "integrity": "sha1-pCdO6zL6dl2lp6OxcSYXzjsUQUk=",
-      "dev": true
-    },
-    "grunt-legacy-log": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/grunt-legacy-log/-/grunt-legacy-log-1.0.2.tgz",
-      "integrity": "sha512-WdedTJ/6zCXnI/coaouzqvkI19uwqbcPkdsXiDRKJyB5rOUlOxnCnTVbpeUdEckKVir2uHF3rDBYppj2p6N3+g==",
-      "dev": true,
-      "requires": {
-        "colors": "~1.1.2",
-        "grunt-legacy-log-utils": "~1.0.0",
-        "hooker": "~0.2.3",
-        "lodash": "~4.17.5"
-      }
-    },
-    "grunt-legacy-log-utils": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/grunt-legacy-log-utils/-/grunt-legacy-log-utils-1.0.0.tgz",
-      "integrity": "sha1-p7ji0Ps1taUPSvmG/BEnSevJbz0=",
-      "dev": true,
-      "requires": {
-        "chalk": "~1.1.1",
-        "lodash": "~4.3.0"
-      },
-      "dependencies": {
-        "lodash": {
-          "version": "4.3.0",
-          "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.3.0.tgz",
-          "integrity": "sha1-79nEpuxT87BUEkKZFcPkgk5NJaQ=",
-          "dev": true
-        }
-      }
-    },
-    "grunt-legacy-util": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/grunt-legacy-util/-/grunt-legacy-util-1.0.0.tgz",
-      "integrity": "sha1-OGqnjcbtUJhsKxiVcmWxtIq7m4Y=",
-      "dev": true,
-      "requires": {
-        "async": "~1.5.2",
-        "exit": "~0.1.1",
-        "getobject": "~0.1.0",
-        "hooker": "~0.2.3",
-        "lodash": "~4.3.0",
-        "underscore.string": "~3.2.3",
-        "which": "~1.2.1"
-      },
-      "dependencies": {
-        "lodash": {
-          "version": "4.3.0",
-          "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.3.0.tgz",
-          "integrity": "sha1-79nEpuxT87BUEkKZFcPkgk5NJaQ=",
-          "dev": true
-        }
-      }
-    },
     "handlebars": {
       "version": "4.0.11",
       "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.0.11.tgz",
@@ -3630,12 +3385,6 @@
       "integrity": "sha512-QLg82fGkfnJ/4iy1xZ81/9SIJiq1NGFUMGs6ParyjBZr6jW2Ufj/snDqTHixNlHdPNwN2RLVD0Pi3igeK9+JfA==",
       "dev": true
     },
-    "hooker": {
-      "version": "0.2.3",
-      "resolved": "https://registry.npmjs.org/hooker/-/hooker-0.2.3.tgz",
-      "integrity": "sha1-uDT3I8xKJCqmWWNFnfbZhMXT2Vk=",
-      "dev": true
-    },
     "hosted-git-info": {
       "version": "2.6.0",
       "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.6.0.tgz",
@@ -3768,15 +3517,6 @@
       "integrity": "sha1-khi5srkoojixPcT7a21XbyMUU+o=",
       "dev": true
     },
-    "indent-string": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-2.1.0.tgz",
-      "integrity": "sha1-ji1INIdCEhtKghi3oTfppSBJ3IA=",
-      "dev": true,
-      "requires": {
-        "repeating": "^2.0.0"
-      }
-    },
     "indexof": {
       "version": "0.0.1",
       "resolved": "https://registry.npmjs.org/indexof/-/indexof-0.0.1.tgz",
@@ -3939,15 +3679,6 @@
       "integrity": "sha1-rEaBd8SUNAWgkvyPKXYMb/xiBsA=",
       "dev": true
     },
-    "is-finite": {
-      "version": "1.0.2",
-      "resolved": "https://registry.npmjs.org/is-finite/-/is-finite-1.0.2.tgz",
-      "integrity": "sha1-zGZ3aVYCvlUO8R6LSqYwU0K20Ko=",
-      "dev": true,
-      "requires": {
-        "number-is-nan": "^1.0.0"
-      }
-    },
     "is-fullwidth-code-point": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-1.0.0.tgz",
@@ -4483,60 +4214,6 @@
       "integrity": "sha1-9ebgatdLeU+1tbZpiL9yjvHe2+g=",
       "dev": true
     },
-    "load-grunt-tasks": {
-      "version": "0.6.0",
-      "resolved": "https://registry.npmjs.org/load-grunt-tasks/-/load-grunt-tasks-0.6.0.tgz",
-      "integrity": "sha1-BDwErWnsyF4CqCJY/fJbenng22w=",
-      "dev": true,
-      "requires": {
-        "findup-sync": "^0.1.2",
-        "multimatch": "^0.3.0"
-      },
-      "dependencies": {
-        "findup-sync": {
-          "version": "0.1.3",
-          "resolved": "https://registry.npmjs.org/findup-sync/-/findup-sync-0.1.3.tgz",
-          "integrity": "sha1-fz56l7gjksZTvwZYm9hRkOk8NoM=",
-          "dev": true,
-          "requires": {
-            "glob": "~3.2.9",
-            "lodash": "~2.4.1"
-          }
-        },
-        "glob": {
-          "version": "3.2.11",
-          "resolved": "https://registry.npmjs.org/glob/-/glob-3.2.11.tgz",
-          "integrity": "sha1-Spc/Y1uRkPcV0QmH1cAP0oFevj0=",
-          "dev": true,
-          "requires": {
-            "inherits": "2",
-            "minimatch": "0.3"
-          }
-        },
-        "lodash": {
-          "version": "2.4.2",
-          "resolved": "https://registry.npmjs.org/lodash/-/lodash-2.4.2.tgz",
-          "integrity": "sha1-+t2DS5aDBz2hebPq5tnA0VBT9z4=",
-          "dev": true
-        },
-        "lru-cache": {
-          "version": "2.7.3",
-          "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-2.7.3.tgz",
-          "integrity": "sha1-bUUk6LlV+V1PW1iFHOId1y+06VI=",
-          "dev": true
-        },
-        "minimatch": {
-          "version": "0.3.0",
-          "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-0.3.0.tgz",
-          "integrity": "sha1-J12O2qxPG7MyZHIInnlJyDlGmd0=",
-          "dev": true,
-          "requires": {
-            "lru-cache": "2",
-            "sigmund": "~1.0.0"
-          }
-        }
-      }
-    },
     "load-json-file": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/load-json-file/-/load-json-file-1.1.0.tgz",
@@ -4799,16 +4476,6 @@
       "integrity": "sha1-MKCy2jj3N3DoKUoNIuZiXtd9AJc=",
       "dev": true
     },
-    "loud-rejection": {
-      "version": "1.6.0",
-      "resolved": "https://registry.npmjs.org/loud-rejection/-/loud-rejection-1.6.0.tgz",
-      "integrity": "sha1-W0b4AUft7leIcPCG0Eghz5mOVR8=",
-      "dev": true,
-      "requires": {
-        "currently-unhandled": "^0.4.1",
-        "signal-exit": "^3.0.0"
-      }
-    },
     "lru-cache": {
       "version": "4.1.3",
       "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-4.1.3.tgz",
@@ -4877,12 +4544,6 @@
       "integrity": "sha1-wyq9C9ZSXZsFFkW7TyasXcmKDb8=",
       "dev": true
     },
-    "map-obj": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/map-obj/-/map-obj-1.0.1.tgz",
-      "integrity": "sha1-2TPOuSBdgr3PSIb2dCvcK03qFG0=",
-      "dev": true
-    },
     "map-visit": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/map-visit/-/map-visit-1.0.0.tgz",
@@ -4976,24 +4637,6 @@
         "readable-stream": "^2.0.1"
       }
     },
-    "meow": {
-      "version": "3.7.0",
-      "resolved": "https://registry.npmjs.org/meow/-/meow-3.7.0.tgz",
-      "integrity": "sha1-cstmi0JSKCkKu/qFaJJYcwioAfs=",
-      "dev": true,
-      "requires": {
-        "camelcase-keys": "^2.0.0",
-        "decamelize": "^1.1.2",
-        "loud-rejection": "^1.0.0",
-        "map-obj": "^1.0.1",
-        "minimist": "^1.1.3",
-        "normalize-package-data": "^2.3.4",
-        "object-assign": "^4.0.1",
-        "read-pkg-up": "^1.0.1",
-        "redent": "^1.0.0",
-        "trim-newlines": "^1.0.0"
-      }
-    },
     "micromatch": {
       "version": "2.3.11",
       "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-2.3.11.tgz",
@@ -5202,50 +4845,6 @@
       "integrity": "sha1-VgiurfwAvmwpAd9fmGF4jeDVl8g=",
       "dev": true
     },
-    "multimatch": {
-      "version": "0.3.0",
-      "resolved": "https://registry.npmjs.org/multimatch/-/multimatch-0.3.0.tgz",
-      "integrity": "sha1-YD28P+MoHTOAlKHhuTqLXyvgONo=",
-      "dev": true,
-      "requires": {
-        "array-differ": "^0.1.0",
-        "array-union": "^0.1.0",
-        "minimatch": "^0.3.0"
-      },
-      "dependencies": {
-        "array-union": {
-          "version": "0.1.0",
-          "resolved": "https://registry.npmjs.org/array-union/-/array-union-0.1.0.tgz",
-          "integrity": "sha1-7emAiDMGZeaZ4evwIny8YDTmJ9s=",
-          "dev": true,
-          "requires": {
-            "array-uniq": "^0.1.0"
-          }
-        },
-        "array-uniq": {
-          "version": "0.1.1",
-          "resolved": "https://registry.npmjs.org/array-uniq/-/array-uniq-0.1.1.tgz",
-          "integrity": "sha1-WGHz7U5LthdVl6TgeOiqeOvpWMc=",
-          "dev": true
-        },
-        "lru-cache": {
-          "version": "2.7.3",
-          "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-2.7.3.tgz",
-          "integrity": "sha1-bUUk6LlV+V1PW1iFHOId1y+06VI=",
-          "dev": true
-        },
-        "minimatch": {
-          "version": "0.3.0",
-          "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-0.3.0.tgz",
-          "integrity": "sha1-J12O2qxPG7MyZHIInnlJyDlGmd0=",
-          "dev": true,
-          "requires": {
-            "lru-cache": "2",
-            "sigmund": "~1.0.0"
-          }
-        }
-      }
-    },
     "murmurhash": {
       "version": "0.0.2",
       "resolved": "https://registry.npmjs.org/murmurhash/-/murmurhash-0.0.2.tgz",
@@ -6251,16 +5850,6 @@
         "mute-stream": "0.0.5"
       }
     },
-    "redent": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/redent/-/redent-1.0.0.tgz",
-      "integrity": "sha1-z5Fqsf1fHxbfsggi3W7H9zDCr94=",
-      "dev": true,
-      "requires": {
-        "indent-string": "^2.1.0",
-        "strip-indent": "^1.0.1"
-      }
-    },
     "redis": {
       "version": "2.8.0",
       "resolved": "https://registry.npmjs.org/redis/-/redis-2.8.0.tgz",
@@ -6330,15 +5919,6 @@
       "integrity": "sha1-jcrkcOHIirwtYA//Sndihtp15jc=",
       "dev": true
     },
-    "repeating": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/repeating/-/repeating-2.0.1.tgz",
-      "integrity": "sha1-UhTFOpJtNVJwdSf7q0FdvAjQbdo=",
-      "dev": true,
-      "requires": {
-        "is-finite": "^1.0.0"
-      }
-    },
     "request": {
       "version": "2.83.0",
       "resolved": "https://registry.npmjs.org/request/-/request-2.83.0.tgz",
@@ -6596,12 +6176,6 @@
       "integrity": "sha1-P/IfGYytIXX587eBhT/ZTQ0ZtZA=",
       "dev": true
     },
-    "signal-exit": {
-      "version": "3.0.2",
-      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.2.tgz",
-      "integrity": "sha1-tf3AjxKH6hF4Yo5BXiUTK3NkbG0=",
-      "dev": true
-    },
     "sinon": {
       "version": "2.4.1",
       "resolved": "https://registry.npmjs.org/sinon/-/sinon-2.4.1.tgz",
@@ -7132,15 +6706,6 @@
         "is-utf8": "^0.2.0"
       }
     },
-    "strip-indent": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/strip-indent/-/strip-indent-1.0.1.tgz",
-      "integrity": "sha1-DHlipq3vp7vUrDZkYKY4VSrhoKI=",
-      "dev": true,
-      "requires": {
-        "get-stdin": "^4.0.1"
-      }
-    },
     "strip-json-comments": {
       "version": "1.0.4",
       "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-1.0.4.tgz",
@@ -7353,12 +6918,6 @@
       "integrity": "sha1-cXuPIgzAu3tE5AUUwisui7xw2Lk=",
       "dev": true
     },
-    "trim-newlines": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/trim-newlines/-/trim-newlines-1.0.0.tgz",
-      "integrity": "sha1-WIeWa7WCpFA6QetST301ARgVphM=",
-      "dev": true
-    },
     "tsscmp": {
       "version": "1.0.5",
       "resolved": "https://registry.npmjs.org/tsscmp/-/tsscmp-1.0.5.tgz",
@@ -7464,12 +7023,6 @@
       "integrity": "sha1-a7rwh3UA02vjTsqlhODbn+8DUgk=",
       "dev": true
     },
-    "underscore.string": {
-      "version": "3.2.3",
-      "resolved": "https://registry.npmjs.org/underscore.string/-/underscore.string-3.2.3.tgz",
-      "integrity": "sha1-gGmSYzZl1eX8tNsfs6hi62jp5to=",
-      "dev": true
-    },
     "union-value": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/union-value/-/union-value-1.0.0.tgz",
diff --git a/packages/optimizely-sdk/package.json b/packages/optimizely-sdk/package.json
index d3d9af797..26e6f2aea 100644
--- a/packages/optimizely-sdk/package.json
+++ b/packages/optimizely-sdk/package.json
@@ -6,7 +6,7 @@
   "browser": "lib/index.browser.js",
   "scripts": {
     "test": "mocha ./lib/*.tests.js ./lib/**/*.tests.js ./lib/**/**/*tests.js --recursive",
-    "test-xbrowser": "grunt karma",
+    "test-xbrowser": "karma run karma.bs.conf.js --single-run",
     "lint": "eslint lib/**",
     "cover": "istanbul cover _mocha ./lib/*.tests.js ./lib/**/*.tests.js ./lib/**/**/*tests.js",
     "coveralls": "npm run cover -- --report lcovonly && cat ./coverage/lcov.info | coveralls",
@@ -35,8 +35,6 @@
     "chai": "^3.5.0",
     "coveralls": "^2.13.1",
     "eslint": "^2.9.0",
-    "grunt": "^1.0.1",
-    "grunt-karma": "^2.0.0",
     "istanbul": "^0.4.5",
     "json-loader": "^0.5.4",
     "karma": "^2.0.0",
@@ -46,7 +44,6 @@
     "karma-mocha": "^1.3.0",
     "karma-sinon": "^1.0.5",
     "karma-webpack": "^2.0.3",
-    "load-grunt-tasks": "^0.6.0",
     "mathjs": "^3.3.0",
     "mocha": "^2.5.3",
     "mocha-lcov-reporter": "^1.3.0",

From 22a353bb652f5dd6986fbf91b9709af6183f8e32 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 17:30:15 -0700
Subject: [PATCH 15/26] s/run/start/

---
 packages/optimizely-sdk/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/optimizely-sdk/package.json b/packages/optimizely-sdk/package.json
index 26e6f2aea..7cfe9683e 100644
--- a/packages/optimizely-sdk/package.json
+++ b/packages/optimizely-sdk/package.json
@@ -6,7 +6,7 @@
   "browser": "lib/index.browser.js",
   "scripts": {
     "test": "mocha ./lib/*.tests.js ./lib/**/*.tests.js ./lib/**/**/*tests.js --recursive",
-    "test-xbrowser": "karma run karma.bs.conf.js --single-run",
+    "test-xbrowser": "karma start karma.bs.conf.js --single-run",
     "lint": "eslint lib/**",
     "cover": "istanbul cover _mocha ./lib/*.tests.js ./lib/**/*.tests.js ./lib/**/**/*tests.js",
     "coveralls": "npm run cover -- --report lcovonly && cat ./coverage/lcov.info | coveralls",

From 23dc79001b85216dc4212b493c4e13958ae25631 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 18:29:08 -0700
Subject: [PATCH 16/26] feat(ci): Only run xbrowser-tests with the latest
 Node.js release

---
 .travis.yml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 96c7729ea..e6f6cec4a 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -19,5 +19,10 @@ before_install: cd packages/optimizely-sdk
 install: npm install
 addons:
   srcclr: true
-script: npm run test-xbrowser
+script:
+- npm test
+- NODE_MAJOR=$(node -v | cut -c 2- | cut -d '.' -f 1) && echo "Node.js major version: $NODE_MAJOR"
+# No need to run cross-browser tests against BrowserStack n times; once is fine.
+# Just use the current Node.js release as the sole driver.
+- if [ "$NODE_MAJOR" = "10" ]; then npm run test-xbrowser; fi
 after_success: npm run coveralls

From e98687e4d14f5e8a05349372321119c458b9cb88 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 18:38:56 -0700
Subject: [PATCH 17/26] Try adding braces

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index e6f6cec4a..4b65914ff 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -21,7 +21,7 @@ addons:
   srcclr: true
 script:
 - npm test
-- NODE_MAJOR=$(node -v | cut -c 2- | cut -d '.' -f 1) && echo "Node.js major version: $NODE_MAJOR"
+- NODE_MAJOR=$(node -v | cut -c 2- | cut -d '.' -f 1) && echo "Node.js major version: ${NODE_MAJOR}"
 # No need to run cross-browser tests against BrowserStack n times; once is fine.
 # Just use the current Node.js release as the sole driver.
 - if [ "$NODE_MAJOR" = "10" ]; then npm run test-xbrowser; fi

From fe7a196883c5828491e401555ee140d7469c29cc Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 18:40:56 -0700
Subject: [PATCH 18/26] heck the logging

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 4b65914ff..4318ae623 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -21,7 +21,7 @@ addons:
   srcclr: true
 script:
 - npm test
-- NODE_MAJOR=$(node -v | cut -c 2- | cut -d '.' -f 1) && echo "Node.js major version: ${NODE_MAJOR}"
+- NODE_MAJOR=$(node -v | cut -c 2- | cut -d '.' -f 1)
 # No need to run cross-browser tests against BrowserStack n times; once is fine.
 # Just use the current Node.js release as the sole driver.
 - if [ "$NODE_MAJOR" = "10" ]; then npm run test-xbrowser; fi

From fae9d22990867aa875d70f07b56d4a5df8bf7daa Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 18:54:35 -0700
Subject: [PATCH 19/26] Update readme

---
 packages/optimizely-sdk/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index f72bbf0da..bcc26bd52 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -15,7 +15,7 @@ This directory contains the source code for the JavaScript SDK, which is usable
 ### Prerequisites
 
 Ensure the SDK supports all of the platforms you're targeting. In particular, we support any ES5-compliant JavaScript environment, including
-  - Node.js >= 0.10.0, and maybe even earlier. CI validates 0.10.0 and the latest version of all [LTS](https://github.com/nodejs/Release) releases from 4.x onward. By extension, places like AWS Lambda, Google Cloud Functions, and Auth0 Webtasks are supported as well.
+  - Node.js >= 0.10.44. By extension, environments like AWS Lambda, Google Cloud Functions, and Auth0 Webtasks are supported as well. Older Node.js releases probably work too, we just can't easily test them in Travis CI. 
   - [Web browsers](https://caniuse.com/#feat=es5)
   - [Cloudflare Workers](https://developers.cloudflare.com/workers/) and [Fly](https://fly.io/), both of which are powered by V8.
   - Anywhere else you can think of that might embed a JavaScript engine. The sky is the limit; experiment everywhere 🚀!

From b4d981c8308cc4ef0167240a940769168fe21d34 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 19:05:38 -0700
Subject: [PATCH 20/26] Drop note that says node < 4 is unsupported

---
 packages/optimizely-sdk/README.md | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index bcc26bd52..3e019825c 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -35,9 +35,7 @@ Regarding `EventDispatcher`s: In Node.js and browser environments, the default `
 
 This version represents a major version change and, as such, introduces some breaking changes:
 
-- The Node SDK is now combined with the JavaScript SDK so that we have one `optimizely-sdk` package that works across both server + browser environments.
-
-- We no longer support legacy Node versions (under 4.0).
+- The Node.js SDK is now combined with the JavaScript SDK. We now have just one package, `@optimizely/optimizely-sdk`, that works in many JavaScript environments.
 
 - You will no longer be able to pass in `revenue` value as a stand-alone argument to the `track` call. Instead you will need to pass it as an entry in the [`eventTags`](https://developers.optimizely.com/x/solutions/sdks/reference/index.html?language=javascript#event-tags).
 

From 268c76ead11230b8f2ac80d1d9bdd253f0c72a1e Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Fri, 29 Jun 2018 19:11:04 -0700
Subject: [PATCH 21/26] beyond...

---
 packages/optimizely-sdk/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index 3e019825c..e73a1d788 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -8,7 +8,7 @@
 
 Optimizely X Full Stack is A/B testing and feature management for product development teams. Experiment in any application. Make every feature on your roadmap an opportunity to learn. Learn more at https://www.optimizely.com/products/full-stack/, or see the [documentation](https://developers.optimizely.com/x/solutions/sdks/reference/index.html?language=node).
 
-This directory contains the source code for the JavaScript SDK, which is usable in both Node.js and web environments.
+This directory contains the source code for the JavaScript SDK, which is usable in Node.js, browsers, and beyond.
 
 ## Getting Started
 

From 0aa5b7ccbfae96c8985d7be6f53276f393153c19 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Tue, 3 Jul 2018 12:08:48 -0700
Subject: [PATCH 22/26] s/url/landing page/

---
 packages/optimizely-sdk/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index 060dea7b1..2041a2992 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -6,7 +6,7 @@
 [![license](https://img.shields.io/github/license/optimizely/javascript-sdk.svg)](https://choosealicense.com/licenses/apache-2.0/)
 
 
-Optimizely X Full Stack is A/B testing and feature management for product development teams. Experiment in any application. Make every feature on your roadmap an opportunity to learn. Learn more at https://www.optimizely.com/products/full-stack/, or see the [documentation](https://developers.optimizely.com/x/solutions/sdks/reference/index.html?language=node).
+Optimizely X Full Stack is A/B testing and feature management for product development teams. Experiment in any application. Make every feature on your roadmap an opportunity to learn. Learn more at the [landing page](https://www.optimizely.com/products/full-stack/), or see the [documentation](https://developers.optimizely.com/x/solutions/sdks/reference/index.html?language=node).
 
 This directory contains the source code for the JavaScript SDK, which is usable in Node.js, browsers, and beyond.
 

From a6263423af096a6b2463ac1c3c063609046b6a9a Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Tue, 3 Jul 2018 14:25:12 -0700
Subject: [PATCH 23/26] Options first, like a sane person

---
 packages/optimizely-sdk/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index 2041a2992..ef55e294a 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -23,7 +23,7 @@ Ensure the SDK supports all of the platforms you're targeting. In particular, we
 Once you've validated that the SDK supports the platforms you're targeting, fetch the package from [NPM](https://www.npmjs.com/package/@optimizely/optimizely-sdk). Using `npm`:
 
 ```
-npm install @optimizely/optimizely-sdk --save
+npm install --save @optimizely/optimizely-sdk
 ```
 
 ### Usage

From 40013e37736895df3a47205a86421725d2ead14e Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Tue, 3 Jul 2018 14:39:37 -0700
Subject: [PATCH 24/26] grammar around EOL date

---
 packages/optimizely-sdk/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index ef55e294a..496c20082 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -37,7 +37,7 @@ This version represents a major version change and, as such, introduces some bre
 
 - The Node.js SDK is now combined with the JavaScript SDK. We now have just one package, `@optimizely/optimizely-sdk`, that works in many JavaScript environments.
 
-- We no longer support Node.js < 4.0.0, which [reached end-of-life](https://github.com/nodejs/Release#end-of-life-releases) 2016-12-31.
+- We no longer support Node.js < 4.0.0, which collectively [reached end-of-life](https://github.com/nodejs/Release#end-of-life-releases) on 2016-12-31.
 
 - You will no longer be able to pass in `revenue` value as a stand-alone argument to the `track` call. Instead you will need to pass it as an entry in the [`eventTags`](https://developers.optimizely.com/x/solutions/sdks/reference/index.html?language=javascript#event-tags).
 

From 8d95f8b0f0eb29d131562710463748712de7d81d Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Tue, 3 Jul 2018 14:52:09 -0700
Subject: [PATCH 25/26] Delineate officially-support and other environments

---
 packages/optimizely-sdk/README.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index 496c20082..d4e550f3b 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -14,10 +14,12 @@ This directory contains the source code for the JavaScript SDK, which is usable
 
 ### Prerequisites
 
-Ensure the SDK supports all of the platforms you're targeting. In particular, we support any ES5-compliant JavaScript environment, including
+Ensure the SDK supports all of the platforms you're targeting. In particular, the SDK targets any ES5-compliant JavaScript environment. We officially support:
   - Node.js >= 4.0.0. By extension, environments like AWS Lambda, Google Cloud Functions, and Auth0 Webtasks are supported as well. Older Node.js releases likely work too (try `npm test` to validate for yourself), but are not formally supported.
   - [Web browsers](https://caniuse.com/#feat=es5)
-  - [Cloudflare Workers](https://developers.cloudflare.com/workers/) and [Fly](https://fly.io/), both of which are powered by V8.
+
+Other environments likely are compatible, too, but note that we don't officially support them:
+  - [Cloudflare Workers](https://developers.cloudflare.com/workers/) and [Fly](https://fly.io/), both of which are powered by recent releases of V8.
   - Anywhere else you can think of that might embed a JavaScript engine. The sky is the limit; experiment everywhere! 🚀
 
 Once you've validated that the SDK supports the platforms you're targeting, fetch the package from [NPM](https://www.npmjs.com/package/@optimizely/optimizely-sdk). Using `npm`:

From 964a86932cd2050d1c734f68caac5de83713c068 Mon Sep 17 00:00:00 2001
From: Spencer Wilson <spencer.wilson@optimizely.com>
Date: Tue, 3 Jul 2018 15:08:54 -0700
Subject: [PATCH 26/26] Add PWAs, WebViews, and hybrid mobile apps

---
 packages/optimizely-sdk/README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/optimizely-sdk/README.md b/packages/optimizely-sdk/README.md
index d4e550f3b..3b3a93641 100644
--- a/packages/optimizely-sdk/README.md
+++ b/packages/optimizely-sdk/README.md
@@ -19,6 +19,7 @@ Ensure the SDK supports all of the platforms you're targeting. In particular, th
   - [Web browsers](https://caniuse.com/#feat=es5)
 
 Other environments likely are compatible, too, but note that we don't officially support them:
+  - Progressive Web Apps, WebViews, and hybrid mobile apps like those built with React Native and Apache Cordova.
   - [Cloudflare Workers](https://developers.cloudflare.com/workers/) and [Fly](https://fly.io/), both of which are powered by recent releases of V8.
   - Anywhere else you can think of that might embed a JavaScript engine. The sky is the limit; experiment everywhere! 🚀