@amplitude/analytics-browser 0.2.4 → 0.4.0

package/lib/esm/browser-client.js

@@ -1,170 +1,142 @@
-import { __awaiter, __generator } from "tslib";
-import { add as _add, groupIdentify as _groupIdentify, Destination, identify as _identify, revenue as _revenue, init as _init, setOptOut as _setOptOut, Identify, Revenue, track as _track, setGroup as _setGroup, remove as _remove, } from '@amplitude/analytics-core';
+import { __assign, __awaiter, __extends, __generator, __read } from "tslib";
+import { AmplitudeCore, Destination, Identify, Revenue, returnWrapper } from '@amplitude/analytics-core';
 import { convertProxyObjectToRealObject, isInstanceProxy } from './utils/snippet-helper';
 import { Context } from './plugins/context';
-import { createConfig, createTransport, getConfig } from './config';
-import { trackAttributions } from './attribution';
+import { useBrowserConfig, createTransport } from './config';
+import { getAttributions } from './attribution';
 import { updateCookies } from './session-manager';
-/**
- * Initializes the Amplitude SDK with your apiKey, userId and optional configurations.
- * This method must be called before any other operations.
- *
- * ```typescript
- * await init(API_KEY, USER_ID, options).promise;
- * ```
- */
-export var init = function (apiKey, userId, options) {
-    return {
-        promise: (function () { return __awaiter(void 0, void 0, void 0, function () {
-            var browserOptions, config;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+import { parseOldCookies } from './cookie-migration';
+var AmplitudeBrowser = /** @class */ (function (_super) {
+    __extends(AmplitudeBrowser, _super);
+    function AmplitudeBrowser() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    AmplitudeBrowser.prototype.init = function (apiKey, userId, options) {
+        var _a, _b, _c;
+        return __awaiter(this, void 0, void 0, function () {
+            var oldCookies, browserOptions;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
                     case 0:
-                        browserOptions = createConfig(apiKey, userId, options);
-                        config = _init(browserOptions);
-                        updateCookies(config);
-                        return [4 /*yield*/, _add(new Context())];
+                        oldCookies = parseOldCookies(apiKey, options);
+                        browserOptions = useBrowserConfig(apiKey, userId || oldCookies.userId, __assign(__assign({}, options), { deviceId: (_a = oldCookies.deviceId) !== null && _a !== void 0 ? _a : options === null || options === void 0 ? void 0 : options.deviceId, sessionId: (_b = oldCookies.sessionId) !== null && _b !== void 0 ? _b : options === null || options === void 0 ? void 0 : options.sessionId, optOut: (_c = options === null || options === void 0 ? void 0 : options.optOut) !== null && _c !== void 0 ? _c : oldCookies.optOut }));
+                        return [4 /*yield*/, _super.prototype.init.call(this, undefined, undefined, browserOptions)];
                     case 1:
-                        _a.sent();
-                        return [4 /*yield*/, _add(new Destination())];
+                        _d.sent();
+                        // Step 3: Store user session in cookie storage
+                        updateCookies(this.config, oldCookies.lastEventTime);
+                        // Step 4: Install plugins
+                        return [4 /*yield*/, this.add(new Context())];
                     case 2:
-                        _a.sent();
-                        trackAttributions(config);
+                        // Step 4: Install plugins
+                        _d.sent();
+                        return [4 /*yield*/, this.add(new Destination())];
+                    case 3:
+                        _d.sent();
+                        // Step 4: Track attributions
+                        void this.trackAttributions();
                         return [2 /*return*/];
                 }
             });
-        }); })(),
+        });
     };
-};
-/**
- * Adds a new plugin.
- *
- * ```typescript
- * const plugin = {...};
- * amplitude.add(plugin);
- * ```
- */
-export var add = function (plugin) {
-    return {
-        promise: _add(plugin),
+    AmplitudeBrowser.prototype.getUserId = function () {
+        return this.config.userId;
     };
-};
-/**
- * Removes a plugin.
- *
- * ```typescript
- * amplitude.remove('myPlugin');
- * ```
- */
-export var remove = function (pluginName) {
-    return {
-        promise: _remove(pluginName),
+    AmplitudeBrowser.prototype.setUserId = function (userId) {
+        this.config.userId = userId;
+        updateCookies(this.config);
     };
-};
-/**
- * Returns current user ID.
- *
- * ```typescript
- * const userId = getUserId();
- * ```
- */
-export var getUserId = function () {
-    return getConfig().userId;
-};
-/**
- * Sets a new user ID.
- *
- * ```typescript
- * setUserId('userId');
- * ```
- */
-export var setUserId = function (userId) {
-    var config = getConfig();
-    config.userId = userId;
-    updateCookies(config);
-};
-/**
- * Returns current device ID.
- *
- * ```typescript
- * const deviceId = getDeviceId();
- * ```
- */
-export var getDeviceId = function () {
-    return getConfig().deviceId;
-};
-/**
- * Sets a new device ID.
- * When setting a custom device ID, make sure the value is sufficiently unique.
- * A uuid is recommended.
- *
- * ```typescript
- * setDeviceId('deviceId');
- * ```
- */
-export var setDeviceId = function (deviceId) {
-    var config = getConfig();
-    config.deviceId = deviceId;
-    updateCookies(config);
-};
+    AmplitudeBrowser.prototype.getDeviceId = function () {
+        return this.config.deviceId;
+    };
+    AmplitudeBrowser.prototype.setDeviceId = function (deviceId) {
+        this.config.deviceId = deviceId;
+        updateCookies(this.config);
+    };
+    AmplitudeBrowser.prototype.getSessionId = function () {
+        return this.config.sessionId;
+    };
+    AmplitudeBrowser.prototype.setSessionId = function (sessionId) {
+        this.config.sessionId = sessionId;
+        updateCookies(this.config);
+    };
+    AmplitudeBrowser.prototype.setOptOut = function (optOut) {
+        _super.prototype.setOptOut.call(this, optOut);
+        updateCookies(this.config);
+    };
+    AmplitudeBrowser.prototype.setTransport = function (transport) {
+        this.config.transportProvider = createTransport(transport);
+    };
+    AmplitudeBrowser.prototype.identify = function (identify, eventOptions) {
+        if (isInstanceProxy(identify)) {
+            var queue = identify._q;
+            identify._q = [];
+            identify = convertProxyObjectToRealObject(new Identify(), queue);
+        }
+        return _super.prototype.identify.call(this, identify, eventOptions);
+    };
+    AmplitudeBrowser.prototype.groupIdentify = function (groupType, groupName, identify, eventOptions) {
+        if (isInstanceProxy(identify)) {
+            var queue = identify._q;
+            identify._q = [];
+            identify = convertProxyObjectToRealObject(new Identify(), queue);
+        }
+        return _super.prototype.groupIdentify.call(this, groupType, groupName, identify, eventOptions);
+    };
+    AmplitudeBrowser.prototype.revenue = function (revenue, eventOptions) {
+        if (isInstanceProxy(revenue)) {
+            var queue = revenue._q;
+            revenue._q = [];
+            revenue = convertProxyObjectToRealObject(new Revenue(), queue);
+        }
+        return _super.prototype.revenue.call(this, revenue, eventOptions);
+    };
+    AmplitudeBrowser.prototype.trackAttributions = function () {
+        var attributions = getAttributions(this.config);
+        if (Object.keys(attributions).length === 0) {
+            return;
+        }
+        var id = new Identify();
+        Object.entries(attributions).forEach(function (_a) {
+            var _b = __read(_a, 2), key = _b[0], value = _b[1];
+            if (value) {
+                id.setOnce("initial_".concat(key), value);
+                id.set(key, value);
+            }
+        });
+        return this.identify(id);
+    };
+    return AmplitudeBrowser;
+}(AmplitudeCore));
+export { AmplitudeBrowser };
+var client = new AmplitudeBrowser();
 /**
- * Returns current session ID.
+ * Initializes the Amplitude SDK with your apiKey, userId and optional configurations.
+ * This method must be called before any other operations.
  *
  * ```typescript
- * const sessionId = getSessionId();
+ * await init(API_KEY, USER_ID, options).promise;
  * ```
  */
-export var getSessionId = function () {
-    return getConfig().sessionId;
-};
+export var init = returnWrapper(client.init.bind(client));
 /**
- * Sets a new session ID.
- * When settign a custom session ID, make sure the value is in milliseconds since epoch (Unix Timestamp).
+ * Adds a new plugin.
  *
  * ```typescript
- * setSessionId(Date.now());
- * ```
- */
-export var setSessionId = function (sessionId) {
-    var config = getConfig();
-    config.sessionId = sessionId;
-    updateCookies(config);
-};
-/**
- * Sets a new optOut config value. This toggles event tracking on/off.
- *
- *```typescript
- * // Stops tracking
- * setOptOut(true);
- *
- * // Starts/resumes tracking
- * setOptOut(false);
+ * const plugin = {...};
+ * amplitude.add(plugin);
  * ```
  */
-export var setOptOut = function (optOut) {
-    _setOptOut(optOut);
-    var config = getConfig();
-    updateCookies(config);
-};
+export var add = returnWrapper(client.add.bind(client));
 /**
- *  Sets the network transport type for events.
+ * Removes a plugin.
  *
  * ```typescript
- * // Use Fetch API
- * setTransport('fetch');
- *
- * // Use XMLHttpRequest API
- * setTransport('xhr');
- *
- * // Use navigator.sendBeacon API
- * setTransport('beacon');
+ * amplitude.remove('myPlugin');
  * ```
  */
-export var setTransport = function (transport) {
-    var config = getConfig();
-    var transportProvider = createTransport(transport);
-    config.transportProvider = transportProvider;
-};
+export var remove = returnWrapper(client.remove.bind(client));
 /**
  * Tracks user-defined event, with specified type, optional event properties and optional overwrites.
  *
@@ -185,15 +157,11 @@ export var setTransport = function (transport) {
  * console.log(result.message); // "Event tracked successfully"
  * ```
  */
-export var track = function (eventType, eventProperties, eventOptions) {
-    return {
-        promise: _track(eventType, eventProperties, eventOptions),
-    };
-};
+export var track = returnWrapper(client.track.bind(client));
 /**
- * Alis for track()
+ * Alias for track()
  */
-export var logEvent = track;
+export var logEvent = returnWrapper(client.logEvent.bind(client));
 /**
  * Sends an identify event containing user property operations
  *
@@ -209,16 +177,7 @@ export var logEvent = track;
  * console.log(result.message); // "Event tracked successfully"
  * ```
  */
-export var identify = function (identify, eventOptions) {
-    if (isInstanceProxy(identify)) {
-        var queue = identify._q;
-        identify._q = [];
-        identify = convertProxyObjectToRealObject(new Identify(), queue);
-    }
-    return {
-        promise: _identify(undefined, undefined, identify, eventOptions),
-    };
-};
+export var identify = returnWrapper(client.identify.bind(client));
 /**
  * Sends a group identify event containing group property operations.
  *
@@ -236,21 +195,8 @@ export var identify = function (identify, eventOptions) {
  * console.log(result.message); // "Event tracked successfully"
  * ```
  */
-export var groupIdentify = function (groupType, groupName, identify, eventOptions) {
-    if (isInstanceProxy(identify)) {
-        var queue = identify._q;
-        identify._q = [];
-        identify = convertProxyObjectToRealObject(new Identify(), queue);
-    }
-    return {
-        promise: _groupIdentify(undefined, undefined, groupType, groupName, identify, eventOptions),
-    };
-};
-export var setGroup = function (groupType, groupName) {
-    return {
-        promise: _setGroup(groupType, groupName),
-    };
-};
+export var groupIdentify = returnWrapper(client.groupIdentify.bind(client));
+export var setGroup = returnWrapper(client.setGroup.bind(client));
 /**
  * Sends a revenue event containing revenue property operations.
  *
@@ -266,14 +212,83 @@ export var setGroup = function (groupType, groupName) {
  * console.log(result.message); // "Event tracked successfully"
  * ```
  */
-export var revenue = function (revenue, eventOptions) {
-    if (isInstanceProxy(revenue)) {
-        var queue = revenue._q;
-        revenue._q = [];
-        revenue = convertProxyObjectToRealObject(new Revenue(), queue);
-    }
-    return {
-        promise: _revenue(revenue, eventOptions),
-    };
-};
+export var revenue = returnWrapper(client.revenue.bind(client));
+/**
+ * Returns current user ID.
+ *
+ * ```typescript
+ * const userId = getUserId();
+ * ```
+ */
+export var getUserId = client.getUserId.bind(client);
+/**
+ * Sets a new user ID.
+ *
+ * ```typescript
+ * setUserId('userId');
+ * ```
+ */
+export var setUserId = client.setUserId.bind(client);
+/**
+ * Returns current device ID.
+ *
+ * ```typescript
+ * const deviceId = getDeviceId();
+ * ```
+ */
+export var getDeviceId = client.getDeviceId.bind(client);
+/**
+ * Sets a new device ID.
+ * When setting a custom device ID, make sure the value is sufficiently unique.
+ * A uuid is recommended.
+ *
+ * ```typescript
+ * setDeviceId('deviceId');
+ * ```
+ */
+export var setDeviceId = client.setDeviceId.bind(client);
+/**
+ * Returns current session ID.
+ *
+ * ```typescript
+ * const sessionId = getSessionId();
+ * ```
+ */
+export var getSessionId = client.getSessionId.bind(client);
+/**
+ * Sets a new session ID.
+ * When settign a custom session ID, make sure the value is in milliseconds since epoch (Unix Timestamp).
+ *
+ * ```typescript
+ * setSessionId(Date.now());
+ * ```
+ */
+export var setSessionId = client.setSessionId.bind(client);
+/**
+ * Sets a new optOut config value. This toggles event tracking on/off.
+ *
+ *```typescript
+ * // Stops tracking
+ * setOptOut(true);
+ *
+ * // Starts/resumes tracking
+ * setOptOut(false);
+ * ```
+ */
+export var setOptOut = client.setOptOut.bind(client);
+/**
+ *  Sets the network transport type for events.
+ *
+ * ```typescript
+ * // Use Fetch API
+ * setTransport('fetch');
+ *
+ * // Use XMLHttpRequest API
+ * setTransport('xhr');
+ *
+ * // Use navigator.sendBeacon API
+ * setTransport('beacon');
+ * ```
+ */
+export var setTransport = client.setTransport.bind(client);
 //# sourceMappingURL=browser-client.js.map

package/lib/esm/browser-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-client.js","sourceRoot":"","sources":["../../src/browser-client.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  add as _add,\n  groupIdentify as _groupIdentify,\n  Destination,\n  identify as _identify,\n  revenue as _revenue,\n  init as _init,\n  setOptOut as _setOptOut,\n  Identify,\n  Revenue,\n  track as _track,\n  setGroup as _setGroup,\n  remove as _remove,\n} from '@amplitude/analytics-core';\nimport {\n  AmplitudeReturn,\n  BrowserConfig,\n  BrowserOptions,\n  EventOptions,\n  Plugin,\n  Result,\n  TransportType,\n} from '@amplitude/analytics-types';\nimport { convertProxyObjectToRealObject, isInstanceProxy } from './utils/snippet-helper';\nimport { Context } from './plugins/context';\nimport { createConfig, createTransport, getConfig } from './config';\nimport { trackAttributions } from './attribution';\nimport { updateCookies } from './session-manager';\n\n/**\n * Initializes the Amplitude SDK with your apiKey, userId and optional configurations.\n * This method must be called before any other operations.\n *\n * ```typescript\n * await init(API_KEY, USER_ID, options).promise;\n * ```\n */\nexport const init = (apiKey: string, userId?: string, options?: BrowserOptions): AmplitudeReturn<void> => {\n  return {\n    promise: (async () => {\n      const browserOptions = createConfig(apiKey, userId, options);\n      const config = _init(browserOptions) as BrowserConfig;\n      updateCookies(config);\n\n      await _add(new Context());\n      await _add(new Destination());\n      trackAttributions(config);\n    })(),\n  };\n};\n\n/**\n * Adds a new plugin.\n *\n * ```typescript\n * const plugin = {...};\n * amplitude.add(plugin);\n * ```\n */\nexport const add = (plugin: Plugin): AmplitudeReturn<void> => {\n  return {\n    promise: _add(plugin),\n  };\n};\n\n/**\n * Removes a plugin.\n *\n * ```typescript\n * amplitude.remove('myPlugin');\n * ```\n */\nexport const remove = (pluginName: string): AmplitudeReturn<void> => {\n  return {\n    promise: _remove(pluginName),\n  };\n};\n\n/**\n * Returns current user ID.\n *\n * ```typescript\n * const userId = getUserId();\n * ```\n */\nexport const getUserId = () => {\n  return getConfig().userId;\n};\n\n/**\n * Sets a new user ID.\n *\n * ```typescript\n * setUserId('userId');\n * ```\n */\nexport const setUserId = (userId: string) => {\n  const config = getConfig();\n  config.userId = userId;\n  updateCookies(config);\n};\n\n/**\n * Returns current device ID.\n *\n * ```typescript\n * const deviceId = getDeviceId();\n * ```\n */\nexport const getDeviceId = () => {\n  return getConfig().deviceId;\n};\n\n/**\n * Sets a new device ID.\n * When setting a custom device ID, make sure the value is sufficiently unique.\n * A uuid is recommended.\n *\n * ```typescript\n * setDeviceId('deviceId');\n * ```\n */\nexport const setDeviceId = (deviceId: string) => {\n  const config = getConfig();\n  config.deviceId = deviceId;\n  updateCookies(config);\n};\n\n/**\n * Returns current session ID.\n *\n * ```typescript\n * const sessionId = getSessionId();\n * ```\n */\nexport const getSessionId = () => {\n  return getConfig().sessionId;\n};\n\n/**\n * Sets a new session ID.\n * When settign a custom session ID, make sure the value is in milliseconds since epoch (Unix Timestamp).\n *\n * ```typescript\n * setSessionId(Date.now());\n * ```\n */\nexport const setSessionId = (sessionId: number) => {\n  const config = getConfig();\n  config.sessionId = sessionId;\n  updateCookies(config);\n};\n\n/**\n * Sets a new optOut config value. This toggles event tracking on/off.\n *\n *```typescript\n * // Stops tracking\n * setOptOut(true);\n *\n * // Starts/resumes tracking\n * setOptOut(false);\n * ```\n */\nexport const setOptOut = (optOut: boolean) => {\n  _setOptOut(optOut);\n  const config = getConfig();\n  updateCookies(config);\n};\n\n/**\n *  Sets the network transport type for events.\n *\n * ```typescript\n * // Use Fetch API\n * setTransport('fetch');\n *\n * // Use XMLHttpRequest API\n * setTransport('xhr');\n *\n * // Use navigator.sendBeacon API\n * setTransport('beacon');\n * ```\n */\nexport const setTransport = (transport: TransportType) => {\n  const config = getConfig();\n  const transportProvider = createTransport(transport);\n  config.transportProvider = transportProvider;\n};\n\n/**\n * Tracks user-defined event, with specified type, optional event properties and optional overwrites.\n *\n * ```typescript\n * // event tracking with event type only\n * track('Page Load');\n *\n * // event tracking with event type and additional event properties\n * track('Page Load', { loadTime: 1000 });\n *\n * // event tracking with event type, additional event properties, and overwritten event options\n * track('Page Load', { loadTime: 1000 }, { sessionId: -1 });\n *\n * // alternatively, this tracking method is awaitable\n * const result = await track('Page Load').promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const track = (\n  eventType: string,\n  eventProperties?: Record<string, any>,\n  eventOptions?: EventOptions,\n): AmplitudeReturn<Result> => {\n  return {\n    promise: _track(eventType, eventProperties, eventOptions),\n  };\n};\n\n/**\n * Alis for track()\n */\nexport const logEvent = track;\n\n/**\n * Sends an identify event containing user property operations\n *\n * ```typescript\n * const id = new Identify();\n * id.set('colors', ['rose', 'gold']);\n * identify(id);\n *\n * // alternatively, this tracking method is awaitable\n * const result = await identify(id).promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const identify = (identify: Identify, eventOptions?: EventOptions): AmplitudeReturn<Result> => {\n  if (isInstanceProxy(identify)) {\n    const queue = identify._q;\n    identify._q = [];\n    identify = convertProxyObjectToRealObject(new Identify(), queue);\n  }\n  return {\n    promise: _identify(undefined, undefined, identify, eventOptions),\n  };\n};\n\n/**\n * Sends a group identify event containing group property operations.\n *\n * ```typescript\n * const id = new Identify();\n * id.set('skills', ['js', 'ts']);\n * const groupType = 'org';\n * const groupName = 'engineering';\n * groupIdentify(groupType, groupName, id);\n *\n * // alternatively, this tracking method is awaitable\n * const result = await groupIdentify(groupType, groupName, id).promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const groupIdentify = (\n  groupType: string,\n  groupName: string | string[],\n  identify: Identify,\n  eventOptions?: EventOptions,\n): AmplitudeReturn<Result> => {\n  if (isInstanceProxy(identify)) {\n    const queue = identify._q;\n    identify._q = [];\n    identify = convertProxyObjectToRealObject(new Identify(), queue);\n  }\n  return {\n    promise: _groupIdentify(undefined, undefined, groupType, groupName, identify, eventOptions),\n  };\n};\n\nexport const setGroup = (groupType: string, groupName: string | string[]): AmplitudeReturn<Result> => {\n  return {\n    promise: _setGroup(groupType, groupName),\n  };\n};\n\n/**\n * Sends a revenue event containing revenue property operations.\n *\n * ```typescript\n * const rev = new Revenue();\n * rev.setRevenue(100);\n * revenue(rev);\n *\n * // alternatively, this tracking method is awaitable\n * const result = await revenue(rev).promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const revenue = (revenue: Revenue, eventOptions?: EventOptions): AmplitudeReturn<Result> => {\n  if (isInstanceProxy(revenue)) {\n    const queue = revenue._q;\n    revenue._q = [];\n    revenue = convertProxyObjectToRealObject(new Revenue(), queue);\n  }\n  return {\n    promise: _revenue(revenue, eventOptions),\n  };\n};\n"]}
+{"version":3,"file":"browser-client.js","sourceRoot":"","sources":["../../src/browser-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { AmplitudeCore, Destination, Identify, Revenue, returnWrapper } from '@amplitude/analytics-core';\nimport {\n  BrowserConfig,\n  BrowserOptions,\n  EventOptions,\n  Identify as IIdentify,\n  Result,\n  Revenue as IRevenue,\n  TransportType,\n} from '@amplitude/analytics-types';\nimport { convertProxyObjectToRealObject, isInstanceProxy } from './utils/snippet-helper';\nimport { Context } from './plugins/context';\nimport { useBrowserConfig, createTransport } from './config';\nimport { getAttributions } from './attribution';\nimport { updateCookies } from './session-manager';\nimport { parseOldCookies } from './cookie-migration';\n\nexport class AmplitudeBrowser extends AmplitudeCore<BrowserConfig> {\n  async init(apiKey: string, userId?: string, options?: BrowserOptions) {\n    // Step 1: Read cookies stored by old SDK\n    const oldCookies = parseOldCookies(apiKey, options);\n\n    // Step 2: Create browser config\n    const browserOptions = useBrowserConfig(apiKey, userId || oldCookies.userId, {\n      ...options,\n      deviceId: oldCookies.deviceId ?? options?.deviceId,\n      sessionId: oldCookies.sessionId ?? options?.sessionId,\n      optOut: options?.optOut ?? oldCookies.optOut,\n    });\n    await super.init(undefined, undefined, browserOptions);\n\n    // Step 3: Store user session in cookie storage\n    updateCookies(this.config, oldCookies.lastEventTime);\n\n    // Step 4: Install plugins\n    await this.add(new Context());\n    await this.add(new Destination());\n\n    // Step 4: Track attributions\n    void this.trackAttributions();\n  }\n\n  getUserId() {\n    return this.config.userId;\n  }\n\n  setUserId(userId: string) {\n    this.config.userId = userId;\n    updateCookies(this.config);\n  }\n\n  getDeviceId() {\n    return this.config.deviceId;\n  }\n\n  setDeviceId(deviceId: string) {\n    this.config.deviceId = deviceId;\n    updateCookies(this.config);\n  }\n\n  getSessionId() {\n    return this.config.sessionId;\n  }\n\n  setSessionId(sessionId: number) {\n    this.config.sessionId = sessionId;\n    updateCookies(this.config);\n  }\n\n  setOptOut(optOut: boolean) {\n    super.setOptOut(optOut);\n    updateCookies(this.config);\n  }\n\n  setTransport(transport: TransportType) {\n    this.config.transportProvider = createTransport(transport);\n  }\n\n  identify(identify: IIdentify, eventOptions?: EventOptions): Promise<Result> {\n    if (isInstanceProxy(identify)) {\n      const queue = identify._q;\n      identify._q = [];\n      identify = convertProxyObjectToRealObject(new Identify(), queue);\n    }\n    return super.identify(identify, eventOptions);\n  }\n\n  groupIdentify(\n    groupType: string,\n    groupName: string | string[],\n    identify: IIdentify,\n    eventOptions?: EventOptions,\n  ): Promise<Result> {\n    if (isInstanceProxy(identify)) {\n      const queue = identify._q;\n      identify._q = [];\n      identify = convertProxyObjectToRealObject(new Identify(), queue);\n    }\n    return super.groupIdentify(groupType, groupName, identify, eventOptions);\n  }\n\n  revenue(revenue: IRevenue, eventOptions?: EventOptions) {\n    if (isInstanceProxy(revenue)) {\n      const queue = revenue._q;\n      revenue._q = [];\n      revenue = convertProxyObjectToRealObject(new Revenue(), queue);\n    }\n    return super.revenue(revenue, eventOptions);\n  }\n\n  trackAttributions() {\n    const attributions = getAttributions(this.config);\n    if (Object.keys(attributions).length === 0) {\n      return;\n    }\n    const id = new Identify();\n    Object.entries(attributions).forEach(([key, value]: [string, string]) => {\n      if (value) {\n        id.setOnce(`initial_${key}`, value);\n        id.set(key, value);\n      }\n    });\n    return this.identify(id);\n  }\n}\n\nconst client = new AmplitudeBrowser();\n\n/**\n * Initializes the Amplitude SDK with your apiKey, userId and optional configurations.\n * This method must be called before any other operations.\n *\n * ```typescript\n * await init(API_KEY, USER_ID, options).promise;\n * ```\n */\nexport const init = returnWrapper(client.init.bind(client));\n\n/**\n * Adds a new plugin.\n *\n * ```typescript\n * const plugin = {...};\n * amplitude.add(plugin);\n * ```\n */\nexport const add = returnWrapper(client.add.bind(client));\n\n/**\n * Removes a plugin.\n *\n * ```typescript\n * amplitude.remove('myPlugin');\n * ```\n */\nexport const remove = returnWrapper(client.remove.bind(client));\n\n/**\n * Tracks user-defined event, with specified type, optional event properties and optional overwrites.\n *\n * ```typescript\n * // event tracking with event type only\n * track('Page Load');\n *\n * // event tracking with event type and additional event properties\n * track('Page Load', { loadTime: 1000 });\n *\n * // event tracking with event type, additional event properties, and overwritten event options\n * track('Page Load', { loadTime: 1000 }, { sessionId: -1 });\n *\n * // alternatively, this tracking method is awaitable\n * const result = await track('Page Load').promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const track = returnWrapper(client.track.bind(client));\n\n/**\n * Alias for track()\n */\nexport const logEvent = returnWrapper(client.logEvent.bind(client));\n\n/**\n * Sends an identify event containing user property operations\n *\n * ```typescript\n * const id = new Identify();\n * id.set('colors', ['rose', 'gold']);\n * identify(id);\n *\n * // alternatively, this tracking method is awaitable\n * const result = await identify(id).promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const identify = returnWrapper(client.identify.bind(client));\n\n/**\n * Sends a group identify event containing group property operations.\n *\n * ```typescript\n * const id = new Identify();\n * id.set('skills', ['js', 'ts']);\n * const groupType = 'org';\n * const groupName = 'engineering';\n * groupIdentify(groupType, groupName, id);\n *\n * // alternatively, this tracking method is awaitable\n * const result = await groupIdentify(groupType, groupName, id).promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const groupIdentify = returnWrapper(client.groupIdentify.bind(client));\nexport const setGroup = returnWrapper(client.setGroup.bind(client));\n\n/**\n * Sends a revenue event containing revenue property operations.\n *\n * ```typescript\n * const rev = new Revenue();\n * rev.setRevenue(100);\n * revenue(rev);\n *\n * // alternatively, this tracking method is awaitable\n * const result = await revenue(rev).promise;\n * console.log(result.event); // {...}\n * console.log(result.code); // 200\n * console.log(result.message); // \"Event tracked successfully\"\n * ```\n */\nexport const revenue = returnWrapper(client.revenue.bind(client));\n\n/**\n * Returns current user ID.\n *\n * ```typescript\n * const userId = getUserId();\n * ```\n */\nexport const getUserId = client.getUserId.bind(client);\n\n/**\n * Sets a new user ID.\n *\n * ```typescript\n * setUserId('userId');\n * ```\n */\nexport const setUserId = client.setUserId.bind(client);\n\n/**\n * Returns current device ID.\n *\n * ```typescript\n * const deviceId = getDeviceId();\n * ```\n */\nexport const getDeviceId = client.getDeviceId.bind(client);\n\n/**\n * Sets a new device ID.\n * When setting a custom device ID, make sure the value is sufficiently unique.\n * A uuid is recommended.\n *\n * ```typescript\n * setDeviceId('deviceId');\n * ```\n */\nexport const setDeviceId = client.setDeviceId.bind(client);\n\n/**\n * Returns current session ID.\n *\n * ```typescript\n * const sessionId = getSessionId();\n * ```\n */\nexport const getSessionId = client.getSessionId.bind(client);\n\n/**\n * Sets a new session ID.\n * When settign a custom session ID, make sure the value is in milliseconds since epoch (Unix Timestamp).\n *\n * ```typescript\n * setSessionId(Date.now());\n * ```\n */\nexport const setSessionId = client.setSessionId.bind(client);\n\n/**\n * Sets a new optOut config value. This toggles event tracking on/off.\n *\n *```typescript\n * // Stops tracking\n * setOptOut(true);\n *\n * // Starts/resumes tracking\n * setOptOut(false);\n * ```\n */\nexport const setOptOut = client.setOptOut.bind(client);\n\n/**\n *  Sets the network transport type for events.\n *\n * ```typescript\n * // Use Fetch API\n * setTransport('fetch');\n *\n * // Use XMLHttpRequest API\n * setTransport('xhr');\n *\n * // Use navigator.sendBeacon API\n * setTransport('beacon');\n * ```\n */\nexport const setTransport = client.setTransport.bind(client);\n"]}

package/lib/esm/config.d.ts

@@ -1,12 +1,14 @@
-import { BrowserOptions, BrowserConfig as IBrowserConfig, Storage, TrackingOptions, TransportType, UserSession } from '@amplitude/analytics-types';
+import { Event, BrowserOptions, BrowserConfig as IBrowserConfig, Storage, TrackingOptions, TransportType, UserSession } from '@amplitude/analytics-types';
 import { Config } from '@amplitude/analytics-core';
 import { FetchTransport } from './transports/fetch';
+import { MemoryStorage } from './storage/memory';
 import { XHRTransport } from './transports/xhr';
 import { SendBeaconTransport } from './transports/send-beacon';
-export declare const defaultConfig: {
+export declare const getDefaultConfig: () => {
     cookieExpiration: number;
     cookieSameSite: string;
     cookieSecure: boolean;
+    cookieStorage: MemoryStorage<UserSession>;
     disableCookies: boolean;
     domain: string;
     includeGclid: boolean;
@@ -14,6 +16,7 @@ export declare const defaultConfig: {
     includeReferrer: boolean;
     includeUtm: boolean;
     sessionTimeout: number;
+    storageProvider: MemoryStorage<Event[]>;
     trackingOptions: {
         city: boolean;
         country: boolean;
@@ -38,19 +41,20 @@ export declare class BrowserConfig extends Config implements IBrowserConfig {
     cookieStorage: Storage<UserSession>;
     disableCookies: boolean;
     domain: string;
-    includeUtm: boolean;
-    includeReferrer: boolean;
     includeGclid: boolean;
     includeFbclid: boolean;
+    includeReferrer: boolean;
+    includeUtm: boolean;
     sessionTimeout: number;
     trackingOptions: TrackingOptions;
     constructor(apiKey: string, userId?: string, options?: BrowserOptions);
 }
-export declare const createConfig: (apiKey: string, userId?: string | undefined, overrides?: BrowserOptions | undefined) => IBrowserConfig;
+export declare const useBrowserConfig: (apiKey: string, userId?: string | undefined, options?: BrowserOptions | undefined) => IBrowserConfig;
 export declare const createCookieStorage: (overrides?: BrowserOptions | undefined, baseConfig?: {
     cookieExpiration: number;
     cookieSameSite: string;
     cookieSecure: boolean;
+    cookieStorage: MemoryStorage<UserSession>;
     disableCookies: boolean;
     domain: string;
     includeGclid: boolean;
@@ -58,6 +62,7 @@ export declare const createCookieStorage: (overrides?: BrowserOptions | undefine
     includeReferrer: boolean;
     includeUtm: boolean;
     sessionTimeout: number;
+    storageProvider: MemoryStorage<Event[]>;
     trackingOptions: {
         city: boolean;
         country: boolean;
@@ -75,9 +80,8 @@ export declare const createCookieStorage: (overrides?: BrowserOptions | undefine
     };
     transportProvider: FetchTransport;
 }) => Storage<UserSession>;
-export declare const createEventsStorage: (overrides?: BrowserOptions | undefined) => Storage<import("@amplitude/analytics-types").Event[]>;
+export declare const createEventsStorage: (overrides?: BrowserOptions | undefined) => Storage<Event[]>;
 export declare const createDeviceId: (idFromCookies?: string | undefined, idFromOptions?: string | undefined, idFromQueryParams?: string | undefined) => string;
 export declare const createSessionId: (idFromCookies: number | undefined, idFromOptions: number | undefined, lastEventTime: number | undefined, sessionTimeout: number) => number;
 export declare const createTransport: (transport?: TransportType | undefined) => FetchTransport | XHRTransport | SendBeaconTransport;
-export declare const getConfig: () => BrowserConfig;
 //# sourceMappingURL=config.d.ts.map

package/lib/esm/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,IAAI,cAAc,EAC/B,OAAO,EACP,eAAe,EACf,aAAa,EACb,WAAW,EACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,MAAM,EAA2B,MAAM,2BAA2B,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMpD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BzB,CAAC;AAEF,qBAAa,aAAc,SAAQ,MAAO,YAAW,cAAc;IACjE,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;gBAErB,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;CAkCtE;AAED,eAAO,MAAM,YAAY,WAAY,MAAM,0EAAgD,cAE1F,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAkB/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,mGAS/B,CAAC;AAEF,eAAO,MAAM,cAAc,4HAE1B,CAAC;AAEF,eAAO,MAAM,eAAe,4HAA6E,MAAM,WAK9G,CAAC;AAEF,eAAO,MAAM,eAAe,gGAQ3B,CAAC;AAEF,eAAO,MAAM,SAAS,qBAErB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,cAAc,EACd,aAAa,IAAI,cAAc,EAC/B,OAAO,EACP,eAAe,EACf,aAAa,EACb,WAAW,EACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6B3B,CAAC;AAEH,qBAAa,aAAc,SAAQ,MAAO,YAAW,cAAc;IACjE,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;gBAErB,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;CAwBtE;AAED,eAAO,MAAM,gBAAgB,WAAY,MAAM,wEAA8C,cAmB5F,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAkB/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,8DAS/B,CAAC;AAEF,eAAO,MAAM,cAAc,4HAE1B,CAAC;AAEF,eAAO,MAAM,eAAe,4HAA6E,MAAM,WAK9G,CAAC;AAEF,eAAO,MAAM,eAAe,gGAQ3B,CAAC"}