rudder-sdk-js 2.21.0 → 2.21.1

package/README.md

@@ -5,7 +5,7 @@ The [**RudderStack**](https://rudderstack.com/) JavaScript SDK leverages the `ru
 > For detailed documentation on the RudderStack JavaScript SDK, click [**here**](https://docs.rudderstack.com/stream-sources/rudderstack-sdk-integration-guides/rudderstack-javascript-sdk).
 
 | **IMPORTANT**: We have deprecated the Autotrack feature for the RudderStack JavaScript SDK. If you still wish to use it for your project, refer to [**this repository**](https://github.com/rudderlabs/rudder-sdk-js-autotrack#autotrack). |
-| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 
 ## Installing the JavaScript SDK
 
@@ -68,6 +68,7 @@ The APIs exported by the module are:
 - `getAnonymousId`
 - `setAnonymousId`
 
+
 ### Sample implementations
 
 Refer to the following projects for a detailed walk-through of the above steps:
@@ -77,15 +78,15 @@ Refer to the following projects for a detailed walk-through of the above steps:
 
 ### Supported browser versions
 
-| **Browser**     | **Supported Versions** |
-| :-------------- | :--------------------- |
-| Safari          | v7 or later            |
-| IE              | v10 or later           |
-| Edge            | v15 or later           |
-| Mozilla Firefox | v40 or later           |
-| Chrome          | v37 or later           |
-| Opera           | v23 or later           |
-| Yandex          | v14.12 or later        |
+| **Browser**         | **Supported Versions** |
+| :------------------ | :--------------------- |
+| Safari              | v7 or later            |
+| IE                  | v10 or later           |
+| Edge                | v15 or later           |
+| Mozilla Firefox     | v40 or later           |
+| Chrome              | v37 or later           |
+| Opera               | v23 or later           |
+| Yandex              | v14.12 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.
 
@@ -97,27 +98,26 @@ A sample `identify()` call is shown below:
 
 ```javascript
 rudderanalytics.identify(
-  '12345',
-  {
-    email: 'name@domain.com',
-  },
-  {
+  "12345", {
+    email: "name@domain.com"
+  }, {
     page: {
-      path: '',
-      referrer: '',
-      search: '',
-      title: '',
-      url: '',
+      path: "",
+      referrer: "",
+      search: "",
+      title: "",
+      url: "",
     },
   },
   () => {
-    console.log('in identify call');
-  },
+    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).
@@ -130,15 +130,14 @@ A sample `track` call is shown below:
 
 ```javascript
 rudderanalytics.track(
-  'test track event GA3',
-  {
+  "test track event GA3", {
     revenue: 30,
-    currency: 'USD',
+    currency: "USD",
     user_actual_id: 12345,
   },
   () => {
-    console.log('in track call');
-  },
+    console.log("in track call");
+  }
 );
 ```
 
@@ -154,12 +153,13 @@ An example is shown in the following snippet:
 
 ```javascript
 rudderanalytics.ready(() => {
-  console.log('we are all set!!!');
+  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).
@@ -175,7 +175,7 @@ rudderanalytics.load(<WRITE_KEY>, <DATA_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).** |
-| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 
 ## Contact us
 

package/index.d.ts

@@ -1,4 +1,4 @@
-declare module 'rudder-sdk-js' {
+declare module "rudder-sdk-js" {
   /**
    * Represents the integration options object
    * Example usages:
@@ -74,7 +74,11 @@ declare module 'rudder-sdk-js' {
     // Defaults to "Lax" (see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie/SameSite)
     sameSiteCookie?: string;
     logLevel?: string;
-    getSourceConfig?: () => string | apiObject | Promise<apiObject> | Promise<string>;
+    getSourceConfig?: () =>
+      | string
+      | apiObject
+      | Promise<apiObject>
+      | Promise<string>;
     setCookieDomain?: string;
     sendAdblockPage?: boolean;
     sendAdblockPageOptions?: apiOptions;
@@ -88,7 +92,7 @@ declare module 'rudder-sdk-js' {
     sessions?: {
       autoTrack?: boolean; // Defaults to true
       timeout?: number; // Defaults to 30 mins
-    };
+    }
   }
 
   /**
@@ -135,7 +139,11 @@ declare module 'rudder-sdk-js' {
    * @param dataPlaneUrl
    * @param options
    */
-  function load(writeKey: string, dataPlaneUrl: string, options?: loadOptions): void;
+  function load(
+    writeKey: string,
+    dataPlaneUrl: string,
+    options?: loadOptions
+  ): void;
 
   /**
    * To register a callback for SDK ready state
@@ -156,7 +164,7 @@ declare module 'rudder-sdk-js' {
     name?: string,
     properties?: apiObject,
     options?: apiOptions,
-    callback?: apiCallback,
+    callback?: apiCallback
   ): void;
 
   /**
@@ -166,7 +174,12 @@ declare module 'rudder-sdk-js' {
    * @param properties
    * @param callback
    */
-  function page(category: string, name: string, properties: apiObject, callback: apiCallback): void;
+  function page(
+    category: string,
+    name: string,
+    properties: apiObject,
+    callback: apiCallback
+  ): void;
 
   /**
    * To record a page view event
@@ -187,7 +200,7 @@ declare module 'rudder-sdk-js' {
     name: string,
     properties?: apiObject,
     options?: apiOptions,
-    callback?: apiCallback,
+    callback?: apiCallback
   ): void;
 
   /**
@@ -196,7 +209,11 @@ declare module 'rudder-sdk-js' {
    * @param properties
    * @param callback
    */
-  function page(name: string, properties: apiObject, callback: apiCallback): void;
+  function page(
+    name: string,
+    properties: apiObject,
+    callback: apiCallback
+  ): void;
 
   /**
    *
@@ -211,7 +228,11 @@ declare module 'rudder-sdk-js' {
    * @param options
    * @param callback
    */
-  function page(properties: apiObject, options: apiOptions, callback?: apiCallback): void;
+  function page(
+    properties: apiObject,
+    options: apiOptions,
+    callback?: apiCallback
+  ): void;
 
   /**
    * To record a page view event
@@ -231,7 +252,7 @@ declare module 'rudder-sdk-js' {
     event: string,
     properties?: apiObject,
     options?: apiOptions,
-    callback?: apiCallback,
+    callback?: apiCallback
   ): void;
 
   /**
@@ -240,7 +261,11 @@ declare module 'rudder-sdk-js' {
    * @param properties
    * @param callback
    */
-  function track(event: string, properties: apiObject, callback: apiCallback): void;
+  function track(
+    event: string,
+    properties: apiObject,
+    callback: apiCallback
+  ): void;
 
   /**
    * To record a user track event
@@ -260,7 +285,7 @@ declare module 'rudder-sdk-js' {
     userId?: string,
     traits?: apiObject,
     options?: apiOptions,
-    callback?: apiCallback,
+    callback?: apiCallback
   ): void;
 
   /**
@@ -269,7 +294,11 @@ declare module 'rudder-sdk-js' {
    * @param traits
    * @param callback
    */
-  function identify(userId: string, traits: apiObject, callback: apiCallback): void;
+  function identify(
+    userId: string,
+    traits: apiObject,
+    callback: apiCallback
+  ): void;
 
   /**
    * To record a user identification event
@@ -284,7 +313,11 @@ declare module 'rudder-sdk-js' {
    * @param options
    * @param callback
    */
-  function identify(traits: apiObject, options: apiOptions, callback?: apiCallback): void;
+  function identify(
+    traits: apiObject,
+    options: apiOptions,
+    callback?: apiCallback
+  ): void;
 
   /**
    *
@@ -300,7 +333,12 @@ declare module 'rudder-sdk-js' {
    * @param options
    * @param callback
    */
-  function alias(to: string, from?: string, options?: apiOptions, callback?: apiCallback): void;
+  function alias(
+    to: string,
+    from?: string,
+    options?: apiOptions,
+    callback?: apiCallback
+  ): void;
 
   /**
    * To record a user alias event
@@ -336,7 +374,7 @@ declare module 'rudder-sdk-js' {
     groupId: string,
     traits?: apiObject,
     options?: apiOptions,
-    callback?: apiCallback,
+    callback?: apiCallback
   ): void;
 
   /**
@@ -345,7 +383,11 @@ declare module 'rudder-sdk-js' {
    * @param traits
    * @param callback
    */
-  function group(groupId: string, traits: apiObject, callback: apiCallback): void;
+  function group(
+    groupId: string,
+    traits: apiObject,
+    callback: apiCallback
+  ): void;
 
   /**
    * To record a user group event
@@ -360,7 +402,11 @@ declare module 'rudder-sdk-js' {
    * @param options
    * @param callback
    */
-  function group(traits: apiObject, options: apiOptions, callback?: apiCallback): void;
+  function group(
+    traits: apiObject,
+    options: apiOptions,
+    callback?: apiCallback
+  ): void;
 
   /**
    * To record a user group event
@@ -379,7 +425,10 @@ declare module 'rudder-sdk-js' {
    * @param anonymousId
    * @param rudderAmpLinkerParm AMP Linker ID string
    */
-  function setAnonymousId(anonymousId?: string, rudderAmpLinkerParm?: string): void;
+  function setAnonymousId(
+    anonymousId?: string,
+    rudderAmpLinkerParm?: string
+  ): void;
 
   /**
    * Clear user information
@@ -410,12 +459,12 @@ declare module 'rudder-sdk-js' {
   /**
    * To manually start user session in the SDK
    */
-  function startSession(sessionId?: number): void;
+   function startSession(sessionId?: number): void;
 
-  /**
+   /**
    * To manually end user session in the SDK
    */
-  function endSession(): void;
+   function endSession(): void;
 
   export {
     integrationOptions,