iureiure 1.0.0

package/packages/analytics-v1.1/CHANGELOG_LATEST.md

@@ -0,0 +1,5 @@
+## [2.48.2](https://github.com/rudderlabs/rudder-sdk-js/compare/rudder-sdk-js@2.48.1...rudder-sdk-js@2.48.2) (2024-02-16)
+
+### Dependency Updates
+
+* `@rudderstack/analytics-js-common` updated to version `2.48.1`

package/packages/analytics-v1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 RudderStack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/packages/analytics-v1.1/README.md

@@ -0,0 +1,321 @@
+## [![Release](https://img.shields.io/npm/v/rudder-sdk-js)](https://www.npmjs.com/package/rudder-sdk-js) [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](https://www.typescriptlang.org/) ![npm bundle size (scoped)](https://img.shields.io/bundlephobia/min/rudder-sdk-js) ![npm](https://img.shields.io/npm/dw/rudder-sdk-js)
+
+<p align="center">
+  <a href="https://rudderstack.com/">
+    <img alt="RudderStack" width="512" src="https://raw.githubusercontent.com/rudderlabs/rudder-sdk-js/develop/assets/rs-logo-full-light.jpg">
+  </a>
+  <br />
+  <caption>The Customer Data Platform for Developers</caption>
+</p>
+<p align="center">
+  <b>
+    <a href="https://rudderstack.com">Website</a>
+    ·
+    <a href="https://rudderstack.com/docs/stream-sources/rudderstack-sdk-integration-guides/rudderstack-javascript-sdk/">Documentation</a>
+    ·
+    <a href="https://rudderstack.com/join-rudderstack-slack-community">Community Slack</a>
+  </b>
+</p>
+
+---
+
+# RudderStack JavaScript SDK
+
+The JavaScript SDK lets you track customer event data from your website and send it to your specified destinations via RudderStack.
+
+> For detailed documentation on the RudderStack JavaScript SDK, click [**here**](https://docs.rudderstack.com/stream-sources/rudderstack-sdk-integration-guides/rudderstack-javascript-sdk).
+
+## Table of Contents
+
+- [**Installing the JavaScript SDK**](#installing-the-javascript-sdk)
+- [**Identifying your users**](#identifying-users)
+- [**Tracking user actions**](#tracking-user-actions)
+- [**The `ready` API**](#the-ready-api)
+- [**Self-hosted control plane**](#self-hosted-control-plane)
+- [**Adding your own integrations**](#adding-your-own-integrations)
+- [**Usage in Chrome Extensions**](#usage-in-chrome-extensions)
+- [**Usage in Serverless Runtimes**](#usage-in-serverless-runtimes)
+
+| **IMPORTANT**: We have deprecated the service worker export from RudderStack JavaScript SDK npm package and decoupled it to a new package. <br/>If you still wish to use it for your project, refer to [**@rudderstack/analytics-js-service-worker package**](https://www.npmjs.com/package/@rudderstack/analytics-js-service-worker). |
+| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+
+## [](https://github.com/rudderlabs/rudder-sdk-js/blob/main/packages/analytics-v1.1/README.md#installing-the-javascript-sdk)Installing the JavaScript SDK
+
+To integrate the JavaScript SDK with your website, place the following code snippet in the `<head>` section of your website.
+
+```javascript
+<script type="text/javascript">
+!function(){var e=window.rudderanalytics=window.rudderanalytics||[];e.methods=["load","page","track","identify","alias","group","ready","reset","getAnonymousId","setAnonymousId"],e.factory=function(t){return function(){e.push([t].concat(Array.prototype.slice.call(arguments)))}};for(var t=0;t<e.methods.length;t++){var r=e.methods[t];e[r]=e.factory(r)}e.loadJS=function(e,t){var r=document.createElement("script");r.type="text/javascript",r.async=!0,r.src="https://cdn.rudderlabs.com/v1.1/rudder-analytics.min.js";var a=document.getElementsByTagName("script")[0];a.parentNode.insertBefore(r,a)},e.loadJS(),
+e.load(<WRITE_KEY>,<DATA_PLANE_URL>),
+e.page()}();
+</script>
+```
+
+<br>
+
+> The above snippet lets you integrate the SDK with your website and load it asynchronously to keep your page load time unaffected.
+
+To load `rudder-analytics.js` on to your page synchronously, you can refer to the minified or non-minified versions of the code in the following sections:
+
+### Minified code
+
+```html
+<script>
+  rudderanalytics=window.rudderanalytics=[];for(var methods=["load","page","track","identify","alias","group","ready","reset","getAnonymousId","setAnonymousId"],i=0;i<methods.length;i++){var method=methods[i];rudderanalytics[method]=function(a){return function(){rudderanalytics.push([a].concat(Array.prototype.slice.call(arguments)))}}(method)}rudderanalytics.load(<WRITE_KEY>,<DATA_PLANE_URL>),rudderanalytics.page();
+</script>
+
+<script src="https://cdn.rudderlabs.com/v1.1/rudder-analytics.min.js"></script>
+```
+
+### Non-minified code
+
+```html
+<script>
+  rudderanalytics = window.rudderanalytics = [];
+
+  var methods = [
+    'load',
+    'page',
+    'track',
+    'identify',
+    'alias',
+    'group',
+    'ready',
+    'reset',
+    'getAnonymousId',
+    'setAnonymousId',
+  ];
+
+  for (var i = 0; i < methods.length; i++) {
+    var method = methods[i];
+    rudderanalytics[method] = (function (methodName) {
+      return function () {
+        rudderanalytics.push([methodName].concat(Array.prototype.slice.call(arguments)));
+      };
+    })(method);
+  }
+  rudderanalytics.load(YOUR_WRITE_KEY, DATA_PLANE_URL);
+  //For example,
+  //rudderanalytics.load("1Qb1F3jSWv0eKFBPZcrM7ypgjVo", "http://localhost:8080");
+  rudderanalytics.page();
+</script>
+
+<script src="https://cdn.rudderlabs.com/v1.1/rudder-analytics.min.js"></script>
+```
+
+In all the above versions, there is an explicit `page` call at the end. This is added to ensure that whenever the SDK loads in a page, a `page` call is sent. You can remove this call completely or modify it with the extra page properties to suit your requirement. You can also add `page` calls in your application in places not tied directly to page load, e.g., virtual page views, page renders on route change such as in SPAs, etc.
+
+### Write key and data plane URL
+
+To integrate and initialize the JavaScript SDK, you will need the source write key and the data plane URL.
+
+- To get the source write key, follow [**this guide**](https://www.rudderstack.com/docs/get-started/glossary/#write-key).
+- To get the data plane URL, follow [**this guide**](https://www.rudderstack.com/docs/rudderstack-cloud/dashboard-overview/#data-plane-url).
+
+### Alternative installation using NPM
+
+Although we recommend using the snippets mentioned above to use the JavaScript SDK with your website, you can also use this [**NPM module**](https://www.npmjs.com/package/rudder-sdk-js) to package RudderStack directly into your project.
+
+To install the SDK via npm, run the following command:
+
+```bash
+npm install rudder-sdk-js --save
+```
+
+**Note that this NPM module is only meant to be used for a browser installation**. If you want to integrate RudderStack with your Node.js application, refer to the [**RudderStack Node.js repository**](https://github.com/rudderlabs/rudder-sdk-node).
+<br><br>
+
+**IMPORTANT**: Since the module exports the [**related APIs**](#exported-apis) on an already-defined object combined with the Node.js module caching, you should run the following code snippet only once and use the exported object throughout your project:
+
+```javascript
+import * as rudderanalytics from "rudder-sdk-js";
+rudderanalytics.ready(() => {
+  console.log("we are all set!!!");
+});
+rudderanalytics.load(<WRITE_KEY>, <DATA_PLANE_URL>);
+export { rudderanalytics };
+```
+
+You can also do this with **ES5** using the `require` method, as shown:
+
+```javascript
+var rudderanalytics = require("rudder-sdk-js");
+rudderanalytics.load(<WRITE_KEY>, <DATA_PLANE_URL>);
+exports.rudderanalytics = rudderanalytics;
+```
+
+For destinations where you don't want the SDK to load the third-party scripts separately, modify the `load` call as shown:
+
+```javascript
+rudderanalytics.load(<YOUR_WRITE_KEY>, <DATA_PLANE_URL>, {loadIntegration:  false})
+```
+
+> For more information on the `load()` method, refer to the detailed [**JavaScript SDK documentation**](https://docs.rudderstack.com/stream-sources/rudderstack-sdk-integration-guides/rudderstack-javascript-sdk).
+
+A few important things to note:
+
+- The SDK expects the destination global queue or function for pushing the events is already present for the particular destination/s.
+- Currently, `loadIntegration` is supported only for Amplitude and Google Analytics.
+- The JavaScript SDK expects `window.amplitude` and `window.ga` to be already defined by the user separately for the sending the events to these destinations.
+
+### Exported APIs
+
+The APIs exported by the module are:
+
+- `load`
+- `ready`
+- `identify`
+- `alias`
+- `page`
+- `track`
+- `group`
+- `reset`
+- `getAnonymousId`
+- `setAnonymousId`
+
+### Sample implementations
+
+Refer to the following projects for a detailed walk-through of the above steps:
+
+- [**Sample Angular project**](https://github.com/rudderlabs/rudder-analytics-angular)
+- [**Sample React project**](https://github.com/rudderlabs/rudder-analytics-react)
+
+### Supported browser versions
+
+| **Browser**     | **Supported Versions** |
+| :-------------- | :--------------------- |
+| Safari          | v7 or later            |
+| IE              | v11 or later           |
+| Edge            | v80 or later           |
+| Mozilla Firefox | v47 or later           |
+| Chrome          | v54 or later           |
+| Opera           | v43 or later           |
+| Yandex          | v19.10 or later        |
+
+> If the SDK does not work on the browser versions that you are targeting, verify if adding the browser polyfills to your application solves the issue.
+
+## Identifying users
+
+The `identify` call lets you identify a visiting user and associate them to their actions. It also lets you record the traits about them like their name, email address, etc.
+
+A sample `identify()` call is shown below:
+
+```javascript
+rudderanalytics.identify(
+  '12345',
+  {
+    email: 'name@domain.com',
+  },
+  {
+    page: {
+      path: '',
+      referrer: '',
+      search: '',
+      title: '',
+      url: '',
+    },
+  },
+  () => {
+    console.log('in identify call');
+  },
+);
+```
+
+In the above example, the user-related information like the `userId` and `email` along with the [**contextual information**](https://docs.rudderstack.com/rudderstack-api/api-specification/rudderstack-spec/common-fields#javascript-sdk) is captured.
+
+> There is no need to call `identify()` for anonymous visitors to your website. Such visitors are automatically assigned an `anonymousId`.
+
+For more information on how to use the `identify` call, refer to the [**JavaScript SDK documentation**](https://docs.rudderstack.com/stream-sources/rudderstack-sdk-integration-guides/rudderstack-javascript-sdk).
+
+## Tracking user actions
+
+The `track` call lets you record the customer events, i.e. the actions that they perform, along with any associated properties.
+
+A sample `track` call is shown below:
+
+```javascript
+rudderanalytics.track(
+  'test track event GA3',
+  {
+    revenue: 30,
+    currency: 'USD',
+    user_actual_id: 12345,
+  },
+  () => {
+    console.log('in track call');
+  },
+);
+```
+
+In the above example, the `track` method tracks the user event ‘**test track event GA3**’ and information such as the `revenue`, `currency`, `anonymousId`.
+
+> You can use the `track` method to track various success metrics for your website like user signups, item purchases, article bookmarks, and more.
+
+## The `ready` API
+
+There are cases when you may want to tap into the features provided by the end-destination SDKs to enhance tracking and other functionalities. The JavaScript SDK exposes a `ready` API with a `callback` parameter that fires when the SDK is done initializing itself and the other third-party native SDK destinations.
+
+An example is shown in the following snippet:
+
+```javascript
+rudderanalytics.ready(() => {
+  console.log('we are all set!!!');
+});
+```
+
+> For more information on the other supported methods, refer to the [**JavaScript SDK APIs**](https://docs.rudderstack.com/stream-sources/rudderstack-sdk-integration-guides/rudderstack-javascript-sdk#supported-apis).
+
+## Self-Hosted control plane
+
+If you are using a device mode destination like Heap, FullStory, etc., the JavaScript SDK needs to fetch the required configuration from the [**control plane**](https://docs.rudderstack.com/get-started/rudderstack-architecture#control-plane).
+
+If you are self-hosting the control plane using the [**RudderStack Control Plane Lite**](https://docs.rudderstack.com/get-started/control-plane-lite#what-is-the-control-plane-url) utility, your `load` call will look like the following:
+
+```javascript
+rudderanalytics.load(<WRITE_KEY>, <DATA_PLANE_URL>, {
+  configUrl: <CONTROL_PLANE_URL>,
+});
+```
+
+> More information on how to get the `CONTROL_PLANE_URL` can be found [**here**](https://docs.rudderstack.com/get-started/control-plane-lite#what-is-the-control-plane-url).
+
+| **For detailed technical documentation and troubleshooting guide on the RudderStack’s JavaScript SDK, check out our [docs](https://docs.rudderstack.com/stream-sources/rudderstack-sdk-integration-guides/rudderstack-javascript-sdk).** |
+| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+
+## Adding your own integrations
+
+You can start adding integrations of your choice for sending the data through their respective web (JavaScript) SDKs.
+
+### How to build the SDK
+
+- Look for run scripts in the `package.json` file for getting the browser minified and non-minified builds. The builds are updated in the `dist` folder of the directory. Among the others, some of the important ones are:
+
+  - `npm run build:browser`: This outputs **dist/cdn/legacy/rudder-analytics.min.js**.
+  - `npm run build:package`: This outputs **dist/npm** folder that contains the npm package contents.
+
+> We use **rollup** to build our SDKs. The configuration for it is present in `rollup-configs` folder.
+
+## Usage in Chrome Extensions
+
+RudderStack JS SDK can be used in Chrome Extensions with manifest v3, both as a content script (via the JavaScript SDK package)
+or as a background script service worker (via the [service worker package](https://www.npmjs.com/package/@rudderstack/analytics-js-service-worker)).
+
+For examples and specific details look into [Chrome Extensions Usage](https://github.com/rudderlabs/rudder-sdk-js/blob/main/examples/chrome-extension/USAGE.md)
+
+## Usage in Serverless Runtimes
+
+RudderStack JS SDK [service worker](https://www.npmjs.com/package/@rudderstack/analytics-js-service-worker) can be used
+in serverless runtimes like Cloudflare Workers or Vercel Edge functions.
+
+For examples and specific details look into:
+
+- [Vercel Edge Usage](https://github.com/rudderlabs/rudder-sdk-js/blob/main/examples/serverless/USAGE.md)
+- [Cloudflare Worker Usage](https://github.com/rudderlabs/rudder-sdk-js/blob/main/examples/serverless/USAGE.md)
+
+## Contribute
+
+We would love to see you contribute to this project. Get more information on how to contribute [**here**](./CONTRIBUTING.md).
+
+## Contact us
+
+For more information on any of the sections covered in this readme, you can [**contact us**](mailto:%20docs@rudderstack.com) or start a conversation on our [**Slack**](https://resources.rudderstack.com/join-rudderstack-slack) channel.

package/packages/analytics-v1.1/__fixtures__/fixtures.js

@@ -0,0 +1,130 @@
+const dummyWriteKey = 'dummyWriteKey';
+
+const dummyDataplaneHost = 'https://dummy.dataplane.host.com';
+const sdkName = 'RudderLabs JavaScript SDK';
+const errorMessage = 'order number must be an integer';
+const actualErrorMessage = '[Transformation]:: order number must be an integer';
+
+const samplePageEvent = {
+  message: {
+    channel: 'web',
+    context: {
+      library: {
+        name: sdkName,
+        version: '2.5.2',
+      },
+    },
+    type: 'page',
+    messageId: 'a65e19c7-a937-4c7a-8349-8d1c7e9bbf9f',
+    originalTimestamp: '2022-07-23T15:18:36.998Z',
+    anonymousId: '1f7618d8-6ada-4d1c-b2c8-923fbfdd142d',
+    userId: '',
+    event: null,
+    properties: {
+      name: 'page view',
+      path: '/',
+      referrer: '$direct',
+      referring_domain: '',
+      search: '',
+      title: 'Document',
+      url: 'http://localhost:4000/',
+      tab_url: 'http://localhost:4000/',
+      initial_referrer: '$direct',
+      initial_referring_domain: '',
+    },
+    integrations: {
+      All: true,
+    },
+    user_properties: null,
+    name: 'page view',
+  },
+};
+
+const retryCount = 3;
+const samplePayloadSuccess = {
+  transformedBatch: [
+    {
+      id: '2CO2YmLozA3SZe6JtmdmMKTrCOl',
+      payload: [
+        {
+          orderNo: 1659505271417,
+          status: '200',
+          event: {
+            message: {
+              anonymousId: '7105960b-0174-4d31-a7a1-561925dedde3',
+              channel: 'web',
+              context: {
+                library: {
+                  name: sdkName,
+                  version: '2.9.2',
+                },
+              },
+              integrations: {
+                All: true,
+              },
+              messageId: '1659505271412300-2d882451-7f50-4f23-b5ac-919fa8a1957d',
+              name: 'page view 123',
+              originalTimestamp: '2022-08-03T05:41:11.412Z',
+              properties: {},
+              type: 'page',
+            },
+          },
+        },
+      ],
+    },
+  ],
+};
+
+const samplePayloadPartialSuccess = {
+  transformedBatch: [
+    {
+      id: '2CO2YmLozA3SZe6JtmdmMKTrCOl',
+      payload: [
+        {
+          orderNo: 1659505271417,
+          status: '200',
+          event: {
+            message: {
+              anonymousId: '7105960b-0174-4d31-a7a1-561925dedde3',
+              channel: 'web',
+              context: {
+                library: {
+                  name: sdkName,
+                  version: '2.9.2',
+                },
+              },
+              integrations: {
+                All: true,
+              },
+              messageId: '1659505271412300-2d882451-7f50-4f23-b5ac-919fa8a1957d',
+              name: 'page view 123',
+              originalTimestamp: '2022-08-03T05:41:11.412Z',
+              properties: {},
+              type: 'page',
+            },
+          },
+        },
+      ],
+    },
+    {
+      id: '2CO2YmLozA3SZe6JtmdmMKTrCKr',
+      payload: [
+        {
+          orderNo: 1659505271418,
+          status: '400',
+        },
+      ],
+    },
+  ],
+};
+
+export {
+  dummyWriteKey,
+  dummyDataplaneHost,
+  retryCount,
+  samplePageEvent,
+  samplePayloadSuccess,
+  samplePayloadPartialSuccess,
+  errorMessage,
+  actualErrorMessage,
+};

package/packages/analytics-v1.1/__fixtures__/msw.handlers.js

@@ -0,0 +1,51 @@
+import { http, HttpResponse } from 'msw';
+import {
+  dummyDataplaneHost,
+  samplePayloadSuccess,
+  samplePayloadPartialSuccess,
+  errorMessage,
+} from './fixtures';
+
+const handlers = [
+  http.post(`${dummyDataplaneHost}/success/transform`, () => {
+    return new HttpResponse(JSON.stringify(samplePayloadSuccess), {
+      status: 200,
+      headers: {
+        'Content-Type': 'application/json; charset=utf-8',
+      },
+    });
+  }),
+  http.post(`${dummyDataplaneHost}/partialSuccess/transform`, () => {
+    return new HttpResponse(JSON.stringify(samplePayloadPartialSuccess), {
+      status: 200,
+      headers: {
+        'Content-Type': 'application/json; charset=utf-8',
+      },
+    });
+  }),
+  http.post(`${dummyDataplaneHost}/invalidResponse/transform`, () => {
+    return new HttpResponse(samplePayloadSuccess, {
+      status: 200,
+      headers: {
+        'Content-Type': 'application/json; charset=utf-8',
+      },
+    });
+  }),
+  http.post(`${dummyDataplaneHost}/badRequest/transform`, () => {
+    return new HttpResponse(errorMessage, {
+      status: 400,
+    });
+  }),
+  http.post(`${dummyDataplaneHost}/accessDenied/transform`, () => {
+    return new HttpResponse(errorMessage, {
+      status: 404,
+    });
+  }),
+  http.post(`${dummyDataplaneHost}/serverDown/transform`, () => {
+    return new HttpResponse(errorMessage, {
+      status: 500,
+    });
+  }),
+];
+
+export { handlers };

package/packages/analytics-v1.1/__fixtures__/msw.server.js

@@ -0,0 +1,6 @@
+import { setupServer } from 'msw/node';
+import { handlers } from './msw.handlers';
+
+const server = setupServer(...handlers);
+
+export { server };