@ada-support/embed2 1.0.39 → 1.0.40

package/README.md

@@ -1,164 +1,28 @@
 # Embed 2
 
-Embed 2 helps clients to setup Ada Web Chat in their web application. These docs are for internal-use only; for client-facing docs check out our [docs repo](https://adasupport.github.io/documentation/#embed2).
+Embed 2 allows clients to setup Ada Web Chat in their web application. For further information on how to use Embed, check out our [docs repo](https://adasupport.github.io/documentation/#embed2).
 
-## Setup
-
-These instructions will get Embed 2 up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
-
-### 1. Start Embed 2
-Run this command:
+## 1. Installation
+NPM:
 ```
-yarn && yarn start
+npm install @ada-support/embed2
 ```
-This will install dependencies and start the webpack dev server.
-
-### 2. Open the example page
-🎉 Head over to http://test.localhost:9001/example/. You should now be good to go! 🎉 
-
-Instead of `test`, you can also use a different handle to use a different local bot instead.
-
-If you are new to Embed 2, the next step will be to familiarize yourself with its architecture. You can find `README.md`s in each of the major directories that will explain how it works.
-
-You can also test different configuration options in `example/index.html`.
-
-Finally, it is highly recommend that you install the following plugins (or equivalent) into your text editor / IDE:
-- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)
-- [Better Comments](https://marketplace.visualstudio.com/items?itemName=aaron-bond.better-comments)
-
-## Tooling
-
-### Linting and Type Checking
-
-You can check for ESLint violations and type errors by running:
-
+Yarn:
 ```
-yarn lint
+yarn add @ada-support/embed2
 ```
+This will install the Embed 2 package and it's dependencies.
 
-This will also run automatically during CI.
-
-### Sentry
-
-If you want to run Sentry locally, you will need to set the value for the Sentry DSN in your .env file. Create and open your .env file:
 
+## 2. Usage
+First, import Embed 2 into your App: 
 ```
-cp .env.example .env
-vim .env
+import adaEmbed from "@ada-support/embed2";
 ```
-
-Find the Sentry DSN for the Embed 2 project at https://docs.sentry.io/error-reporting/configuration/?platform=browser and selecting "Embed" from the dropdown menu above the code snippet. Copy this value (it should be a string that looks like a URL) to the .env file.
-
-### Checking Bundle Size
-
-Embed 2 is the entry to Ada's web chat, and is downloaded more than any other Ada script. As such, maintaining a small bundle size is extremely important. We do this by leveraging the browser cache, and using lightweight modules. Additionally, separate `modern` and `legacy` bundles are generated, so the majority of users who use new browser versions do not need to fetch superfluous polyfills.
-
-Bundle size should be checked periodically. You can check the bundle size by running:
-
+Second, place the code below to start Embed 2 when the DOM is ready:
 ```
-yarn bundle-report:modern
+adaEmbed.start({
+  handle: "bot-handle",
+});
 ```
-
-and
-
-```
-yarn bundle-report:legacy
-```
-
-You will notice that many tabs are opened when running this command. Because Embed 2 is split between many sub-applications (representing framed components), a bundle analyzer is run for each application. The total bundle size is equal to sum of bundle sizes, plus external dependencies.
-
-## Connecting to an external bot
-In certain scenarios it can be useful to run Embed 2 locally, but connect to a bot that exists on one of our external environments (`production`, `staging`, `dev`, `dev2`). To achieve this follow the steps below.
-1. open example/index.html and modify the `domain` parameter in the settings dictionary to match the environment the external bot exists on, should be one of `ada-dev`, `ada-dev2`, `ada-stage`, `ada` for dev, dev2, stage, or production respectively.
-2. open src/common/helpers/url/index.ts and modify the `getURL` function to return early after constructing the `prodURL`
-```javascript
-export function getURL({
-    ...
-    const prodUrl = `https://${handle}${clusterString}.${domainString}.support/${name}/${routeString}${questionSym}${queryString}`;
-    return prodURL
-})
-```
-After starting Embed 2, access the example page by entering `http://<bot-handle>.localhost:9000` and replace <bot-handle> with the bot handle as it exists on the external environment.
-## Testing
-
-### Unit testing
-
-Unit testing is done with Karma and Jasmine. Tests can be run on a local Chrome browser with:
-
-```
-yarn test
-```
-
-### End-to-end testing
-
-#### TestCafe
-
-TestCafe can run E2E tests on real browsers via LambdaTest. These tests will run automatically during the CI pipeline, but can also be run locally.
-
-To run locally, you will first need to add `LT_USERNAME` and `LT_ACCESS_KEY` to your `.env` file. You can find your username and access key in the LambdaTest dashboard. If you have not used LambdaTest before, follow this setup guide [here](https://www.notion.so/adasupport/Cross-Browser-Testing-e141ba6682c0476ca96d329b53fc0bb2).
-
-
-Once you have added valid keys, you can now run TestCafe with:
-
-```
-yarn ci-testcafe
-```
-
-Note that this is the same command that runs during CI, and will make requests against the production API. If you would like to run against your local API, you can run:
-
-```
-yarn tc
-```
-
-#### Cypress
-
-Cypress E2E tests can be run using:
-
-```
-yarn ci-cypress
-```
-
-## Deployment
-
-### Steps to Deploy
-
-Follow instructions listed on [this notion page](https://www.notion.so/adasupport/Embed-2-deployment-runbook-fb81e8a28cb14ef1a607059914fb875a)
-
-Deployment of the static script is handled automatically by CircleCI when merging a branch into `master`. Once merged, two script will be added to the Ada CDN:
-
-```
-https://static.ada.support/embed2.<VERSION>.js
-```
-
-#### Example
-```
-https://static.ada.support/embed2.1.0.35.js
-```
-
-Once static script is created, production deployment will be "held" until approved by an Embed 2 admin. To approve the deploy, open the CircleCI job in question, and click on "Approve Job". You can read more about manual approval [here](https://circleci.com/docs/2.0/workflows/#holding-a-workflow-for-a-manual-approval).
-
-Deploying production will create the versionless script
-
-```
-https://static.ada.support/embed2.js
-```
-
-Deploying to other cluster will create a script in following format.
-
-```
-https://static.ada.support/embed2.<CLUSTER>.js
-```
-
-If you require access to the [Embed Procuction Deploys](https://github.com/orgs/AdaSupport/teams/embed-production-deploys) team (needed for production deployment), please reach out to an Engineering admin.
-
-## Versioning
-We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [releases on this repository](https://github.com/AdaSupport/embed-frames/releases).
-
-## Architecture
-![Frontend Architecture@2x(1)](https://user-images.githubusercontent.com/9045634/97473287-32b0e100-1921-11eb-98c6-d3059d6f24a8.png)
-
-Loom explanation: <https://www.loom.com/share/22f7b0060b3f46c8b3781afb1aae4b89>
-
-
-## Gotchas
-There are artifical timeouts in the application that may cause you not to see any errors with what you are working on. The longest timeout is 60000ms (60s). Please ensure you shorten this locally when you are testing your work. You can adjust this here: `src/common/constants/events.ts`
+In the example above the `handle` key is a part of `AdaSettings`. To learn more about other settings, consult the [API reference](https://adasupport.github.io/documentation/#api-reference).

package/dist/npm-entry/index.js

@@ -8495,7 +8495,7 @@ var client = new error_tracker_BrowserClient({
     return event;
   },
   environment: "production",
-  release: "a890d11ff8a747b0530d3d7e4797e541fa1c5467",
+  release: "f19ff23c3540dea5849b9545cf7188b0bf11bf6e",
   sampleRate: 0.25,
   autoSessionTracking: false,
   // Integrations don't seem to work with Sentry: https://github.com/getsentry/sentry-javascript/issues/2541
@@ -9179,7 +9179,7 @@ function getEmbedURL(_ref) {
     polyfillVersionString = "legacy";
   }
 
-  return concat_default()(_context5 = concat_default()(_context6 = concat_default()(_context7 = "".concat(host, "/embed/")).call(_context7, polyfillVersionString, "/")).call(_context6, frameName, "/")).call(_context5, "a890d11", "/index.html");
+  return concat_default()(_context5 = concat_default()(_context6 = concat_default()(_context7 = "".concat(host, "/embed/")).call(_context7, polyfillVersionString, "/")).call(_context6, frameName, "/")).call(_context5, "f19ff23", "/index.html");
 }
 /**
  * Generate the Chat / API URL
@@ -13879,7 +13879,7 @@ window.__AdaEmbedConstructor = Embed;
 /* harmony export */ });
 var isModern = new RegExp("((CPU[ +]OS|iPhone[ +]OS|CPU[ +]iPhone|CPU IPhone OS)[ +]+(14|(1[5-9]|[2-9]\\d|\\d{3,}))[_.]\\d+(?:[_.]\\d+)?)|((Chromium|Chrome)\\/(92|(9[3-9]|\\d{3,}))\\.\\d+(?:\\.\\d+)?)|(Version\\/(14|(1[5-9]|[2-9]\\d|\\d{3,}))\\.\\d+(?:\\.\\d+)? Safari\\/)|(Firefox\\/(91|(9[2-9]|\\d{3,}))\\.\\d+\\.\\d+)|(Firefox\\/(91|(9[2-9]|\\d{3,}))\\.\\d+(pre|[ab]\\d+[a-z]*)?)").test(navigator.userAgent);
 var isProduction = "production" === "production";
-var embed2Version = "a890d11";
+var embed2Version = "f19ff23";
 
 /***/ }),
 
@@ -23660,7 +23660,7 @@ function _loadEmbed() {
                 polyfillVersionString = "legacy";
               }
 
-              embedScriptSource = concat_default()(_context16 = concat_default()(_context17 = "".concat(host, "/embed/")).call(_context17, polyfillVersionString, "/client/")).call(_context16, "a890d11", "/index.js");
+              embedScriptSource = concat_default()(_context16 = concat_default()(_context17 = "".concat(host, "/embed/")).call(_context17, polyfillVersionString, "/client/")).call(_context16, "f19ff23", "/index.js");
             }
 
             clientScriptExists = Boolean( true || // The client script is bundled with npm module
@@ -23787,10 +23787,10 @@ function createEmbedObject() {
                   handle: adaSettings.handle,
                   embedVersion: 2,
                   embedSettings: adaSettings,
-                  version: "1.0.39",
+                  version: "1.0.40",
                   isNpm: true,
                   hostPage: window.location.href,
-                  commitHash: "a890d11"
+                  commitHash: "f19ff23"
                 }, {
                   sampleRate: 0.01 // 1% of logs will go through
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ada-support/embed2",
-  "version": "1.0.39",
+  "version": "1.0.40",
   "description": "",
   "main": "dist/npm-entry",
   "typings": "dist/npm-entry/index.d.ts",