@amplitude/analytics-browser 0.1.0

package/README.md

@@ -0,0 +1 @@
+# @amplitude/analytics-browser

package/lib/cjs/attribution.d.ts

@@ -0,0 +1,11 @@
+import { BrowserConfig, UTMData } from '@amplitude/analytics-types';
+export declare const trackAttributions: (config: BrowserConfig) => void;
+export declare const getUtmParam: () => UTMData;
+export declare const getReferrer: () => Record<string, string | undefined>;
+export declare const getGclid: () => {
+    gclid?: string | undefined;
+};
+export declare const getFbclid: () => {
+    fbclid?: string | undefined;
+};
+//# sourceMappingURL=attribution.d.ts.map

package/lib/cjs/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../src/attribution.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAkBpE,eAAO,MAAM,iBAAiB,WAAY,aAAa,SAoBtD,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,OAkB9B,CAAC;AAEF,eAAO,MAAM,WAAW,0CAYvB,CAAC;AAEF,eAAO,MAAM,QAAQ;;CAKpB,CAAC;AAEF,eAAO,MAAM,SAAS;;CAKrB,CAAC"}

package/lib/cjs/attribution.js

@@ -0,0 +1,76 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFbclid = exports.getGclid = exports.getReferrer = exports.getUtmParam = exports.trackAttributions = void 0;
+var tslib_1 = require("tslib");
+var analytics_core_1 = require("@amplitude/analytics-core");
+var constants_1 = require("./constants");
+var utm_cookie_1 = require("./storage/utm-cookie");
+var query_params_1 = require("./utils/query-params");
+var trackAttributions = function (config) {
+    var attribution = (0, tslib_1.__assign)((0, tslib_1.__assign)((0, tslib_1.__assign)((0, tslib_1.__assign)({}, (config.includeUtm && (0, exports.getUtmParam)())), (config.includeReferrer && (0, exports.getReferrer)())), (config.includeGclid && (0, exports.getGclid)())), (config.includeFbclid && (0, exports.getFbclid)()));
+    if (Object.keys(attribution).length === 0) {
+        return;
+    }
+    var id = new analytics_core_1.Identify();
+    Object.entries(attribution).forEach(function (_a) {
+        var _b = (0, tslib_1.__read)(_a, 2), key = _b[0], value = _b[1];
+        if (value) {
+            id.setOnce("initial_".concat(key), value);
+            id.set(key, value);
+        }
+    });
+    void (0, analytics_core_1.identify)(undefined, undefined, id);
+};
+exports.trackAttributions = trackAttributions;
+var getUtmParam = function () {
+    var params = (0, query_params_1.getQueryParams)();
+    var utmStorage = new utm_cookie_1.UTMCookie();
+    var cookies = (utmStorage.isEnabled() && utmStorage.get('__utmz')) || {};
+    var utmSource = params[constants_1.UTM_SOURCE] || cookies[constants_1.UTMZ_SOURCE];
+    var utmMedium = params[constants_1.UTM_MEDIUM] || cookies[constants_1.UTMZ_MEDIUM];
+    var utmCampaign = params[constants_1.UTM_CAMPAIGN] || cookies[constants_1.UTMZ_CAMPAIGN];
+    var utmTerm = params[constants_1.UTM_TERM] || cookies[constants_1.UTMZ_TERM];
+    var utmContent = params[constants_1.UTM_CONTENT] || cookies[constants_1.UTMZ_CONTENT];
+    var data = {};
+    if (utmSource)
+        data.utm_source = utmSource;
+    if (utmMedium)
+        data.utm_medium = utmMedium;
+    if (utmCampaign)
+        data.utm_campaign = utmCampaign;
+    if (utmTerm)
+        data.utm_term = utmTerm;
+    if (utmContent)
+        data.utm_content = utmContent;
+    return data;
+};
+exports.getUtmParam = getUtmParam;
+var getReferrer = function () {
+    var _a;
+    var data = {};
+    try {
+        var referrer = document.referrer || undefined;
+        var referringDomain = (_a = referrer === null || referrer === void 0 ? void 0 : referrer.split('/')[2]) !== null && _a !== void 0 ? _a : undefined;
+        if (referrer !== undefined)
+            data.referrer = referrer;
+        if (referringDomain !== undefined)
+            data.referring_domain = referringDomain;
+    }
+    catch (_b) {
+        //
+    }
+    return data;
+};
+exports.getReferrer = getReferrer;
+var getGclid = function () {
+    var _a;
+    var params = (0, query_params_1.getQueryParams)();
+    return (0, tslib_1.__assign)({}, (params[constants_1.GCLID] && (_a = {}, _a[constants_1.GCLID] = params[constants_1.GCLID], _a)));
+};
+exports.getGclid = getGclid;
+var getFbclid = function () {
+    var _a;
+    var params = (0, query_params_1.getQueryParams)();
+    return (0, tslib_1.__assign)({}, (params[constants_1.FBCLID] && (_a = {}, _a[constants_1.FBCLID] = params[constants_1.FBCLID], _a)));
+};
+exports.getFbclid = getFbclid;
+//# sourceMappingURL=attribution.js.map

package/lib/cjs/attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.js","sourceRoot":"","sources":["../../src/attribution.ts"],"names":[],"mappings":"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","sourcesContent":["import { Identify, identify } from '@amplitude/analytics-core';\nimport { BrowserConfig, UTMData } from '@amplitude/analytics-types';\nimport {\n  UTM_CAMPAIGN,\n  UTM_CONTENT,\n  UTM_MEDIUM,\n  UTM_SOURCE,\n  UTM_TERM,\n  UTMZ_SOURCE,\n  UTMZ_MEDIUM,\n  UTMZ_CAMPAIGN,\n  UTMZ_TERM,\n  UTMZ_CONTENT,\n  GCLID,\n  FBCLID,\n} from './constants';\nimport { UTMCookie } from './storage/utm-cookie';\nimport { getQueryParams } from './utils/query-params';\n\nexport const trackAttributions = (config: BrowserConfig) => {\n  const attribution = {\n    ...(config.includeUtm && getUtmParam()),\n    ...(config.includeReferrer && getReferrer()),\n    ...(config.includeGclid && getGclid()),\n    ...(config.includeFbclid && getFbclid()),\n  };\n\n  if (Object.keys(attribution).length === 0) {\n    return;\n  }\n\n  const id = new Identify();\n  Object.entries(attribution).forEach(([key, value]: [string, string]) => {\n    if (value) {\n      id.setOnce(`initial_${key}`, value);\n      id.set(key, value);\n    }\n  });\n  void identify(undefined, undefined, id);\n};\n\nexport const getUtmParam = (): UTMData => {\n  const params = getQueryParams();\n  const utmStorage = new UTMCookie();\n  const cookies = (utmStorage.isEnabled() && utmStorage.get('__utmz')) || {};\n\n  const utmSource = params[UTM_SOURCE] || cookies[UTMZ_SOURCE];\n  const utmMedium = params[UTM_MEDIUM] || cookies[UTMZ_MEDIUM];\n  const utmCampaign = params[UTM_CAMPAIGN] || cookies[UTMZ_CAMPAIGN];\n  const utmTerm = params[UTM_TERM] || cookies[UTMZ_TERM];\n  const utmContent = params[UTM_CONTENT] || cookies[UTMZ_CONTENT];\n\n  const data: UTMData = {};\n  if (utmSource) data.utm_source = utmSource;\n  if (utmMedium) data.utm_medium = utmMedium;\n  if (utmCampaign) data.utm_campaign = utmCampaign;\n  if (utmTerm) data.utm_term = utmTerm;\n  if (utmContent) data.utm_content = utmContent;\n  return data;\n};\n\nexport const getReferrer = () => {\n  const data: Record<string, string | undefined> = {};\n  try {\n    const referrer = document.referrer || undefined;\n    const referringDomain = referrer?.split('/')[2] ?? undefined;\n\n    if (referrer !== undefined) data.referrer = referrer;\n    if (referringDomain !== undefined) data.referring_domain = referringDomain;\n  } catch {\n    //\n  }\n  return data;\n};\n\nexport const getGclid = () => {\n  const params = getQueryParams();\n  return {\n    ...(params[GCLID] && { [GCLID]: params[GCLID] }),\n  };\n};\n\nexport const getFbclid = () => {\n  const params = getQueryParams();\n  return {\n    ...(params[FBCLID] && { [FBCLID]: params[FBCLID] }),\n  };\n};\n"]}

package/lib/cjs/browser-client.d.ts

@@ -0,0 +1,183 @@
+import { Identify, Revenue } from '@amplitude/analytics-core';
+import { AmplitudeReturn, BrowserOptions, EventOptions, Plugin, Result, TransportType } from '@amplitude/analytics-types';
+/**
+ * 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 declare const init: (apiKey: string, userId?: string | undefined, options?: BrowserOptions | undefined) => AmplitudeReturn<void>;
+/**
+ * Adds a new plugin.
+ *
+ * ```typescript
+ * const plugin = {...};
+ * amplitude.add(plugin);
+ * ```
+ */
+export declare const add: (plugin: Plugin) => AmplitudeReturn<void>;
+/**
+ * Removes a plugin.
+ *
+ * ```typescript
+ * amplitude.remove('myPlugin');
+ * ```
+ */
+export declare const remove: (pluginName: string) => AmplitudeReturn<void>;
+/**
+ * Returns current user ID.
+ *
+ * ```typescript
+ * const userId = getUserId();
+ * ```
+ */
+export declare const getUserId: () => string | undefined;
+/**
+ * Sets a new user ID.
+ *
+ * ```typescript
+ * setUserId('userId');
+ * ```
+ */
+export declare const setUserId: (userId: string) => void;
+/**
+ * Returns current device ID.
+ *
+ * ```typescript
+ * const deviceId = getDeviceId();
+ * ```
+ */
+export declare const getDeviceId: () => string | undefined;
+/**
+ * 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 declare const setDeviceId: (deviceId: string) => void;
+/**
+ * Returns current session ID.
+ *
+ * ```typescript
+ * const sessionId = getSessionId();
+ * ```
+ */
+export declare const getSessionId: () => number | undefined;
+/**
+ * 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 declare const setSessionId: (sessionId: number) => void;
+/**
+ * Sets a new optOut config value. This toggles event tracking on/off.
+ *
+ *```typescript
+ * // Stops tracking
+ * setOptOut(true);
+ *
+ * // Starts/resumes tracking
+ * setOptOut(false);
+ * ```
+ */
+export declare const setOptOut: (optOut: boolean) => void;
+/**
+ *  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 declare const setTransport: (transport: TransportType) => void;
+/**
+ * Tracks user-defined event, with specified type, optional event properties and optional overwrites.
+ *
+ * ```typescript
+ * // event tracking with event type only
+ * track('Page Load');
+ *
+ * // event tracking with event type and additional event properties
+ * track('Page Load', { loadTime: 1000 });
+ *
+ * // event tracking with event type, additional event properties, and overwritten event options
+ * track('Page Load', { loadTime: 1000 }, { sessionId: -1 });
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await track('Page Load').promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+export declare const track: (eventType: string, eventProperties?: Record<string, any> | undefined, eventOptions?: EventOptions | undefined) => AmplitudeReturn<Result>;
+/**
+ * Alis for track()
+ */
+export declare const logEvent: (eventType: string, eventProperties?: Record<string, any> | undefined, eventOptions?: EventOptions | undefined) => AmplitudeReturn<Result>;
+/**
+ * Sends an identify event containing user property operations
+ *
+ * ```typescript
+ * const id = new Identify();
+ * id.set('colors', ['rose', 'gold']);
+ * identify(id);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await identify(id).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+export declare const identify: (identify: Identify, eventOptions?: EventOptions | undefined) => AmplitudeReturn<Result>;
+/**
+ * Sends a group identify event containing group property operations.
+ *
+ * ```typescript
+ * const id = new Identify();
+ * id.set('skills', ['js', 'ts']);
+ * const groupType = 'org';
+ * const groupName = 'engineering';
+ * groupIdentify(groupType, groupName, id);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await groupIdentify(groupType, groupName, id).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+export declare const groupIdentify: (groupType: string, groupName: string | string[], identify: Identify, eventOptions?: EventOptions | undefined) => AmplitudeReturn<Result>;
+export declare const setGroup: (groupType: string, groupName: string | string[]) => AmplitudeReturn<Result>;
+/**
+ * Sends a revenue event containing revenue property operations.
+ *
+ * ```typescript
+ * const rev = new Revenue();
+ * rev.setRevenue(100);
+ * revenue(rev);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await revenue(rev).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+export declare const revenue: (revenue: Revenue, eventOptions?: EventOptions | undefined) => AmplitudeReturn<Result>;
+//# sourceMappingURL=browser-client.d.ts.map

package/lib/cjs/browser-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-client.d.ts","sourceRoot":"","sources":["../../src/browser-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,QAAQ,EACR,OAAO,EAIR,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,eAAe,EAEf,cAAc,EACd,YAAY,EACZ,MAAM,EACN,MAAM,EACN,aAAa,EACd,MAAM,4BAA4B,CAAC;AAOpC;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,WAAY,MAAM,wEAA8C,gBAAgB,IAAI,CAYpG,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG,WAAY,MAAM,KAAG,gBAAgB,IAAI,CAIxD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,eAAgB,MAAM,KAAG,gBAAgB,IAAI,CAI/D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,0BAErB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,WAAY,MAAM,SAIvC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,0BAEvB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,aAAc,MAAM,SAI3C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,0BAExB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,cAAe,MAAM,SAI7C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,WAAY,OAAO,SAIxC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,cAAe,aAAa,SAIpD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,KAAK,cACL,MAAM,iGAGhB,gBAAgB,MAAM,CAIxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,cAZR,MAAM,iGAGhB,gBAAgB,MAAM,CASI,CAAC;AAE9B;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,aAAc,QAAQ,8CAAgC,gBAAgB,MAAM,CAShG,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,cACb,MAAM,aACN,MAAM,GAAG,MAAM,EAAE,YAClB,QAAQ,8CAEjB,gBAAgB,MAAM,CASxB,CAAC;AAEF,eAAO,MAAM,QAAQ,cAAe,MAAM,aAAa,MAAM,GAAG,MAAM,EAAE,KAAG,gBAAgB,MAAM,CAIhG,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,OAAO,YAAa,OAAO,8CAAgC,gBAAgB,MAAM,CAS7F,CAAC"}

package/lib/cjs/browser-client.js

@@ -0,0 +1,298 @@
+var _this = this;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.revenue = exports.setGroup = exports.groupIdentify = exports.identify = exports.logEvent = exports.track = exports.setTransport = exports.setOptOut = exports.setSessionId = exports.getSessionId = exports.setDeviceId = exports.getDeviceId = exports.setUserId = exports.getUserId = exports.remove = exports.add = exports.init = void 0;
+var tslib_1 = require("tslib");
+var analytics_core_1 = require("@amplitude/analytics-core");
+var snippet_helper_1 = require("./utils/snippet-helper");
+var context_1 = require("./plugins/context");
+var config_1 = require("./config");
+var attribution_1 = require("./attribution");
+var session_manager_1 = require("./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;
+ * ```
+ */
+var init = function (apiKey, userId, options) {
+    return {
+        promise: (function () { return (0, tslib_1.__awaiter)(_this, void 0, void 0, function () {
+            var browserOptions, config;
+            return (0, tslib_1.__generator)(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        browserOptions = (0, config_1.createConfig)(apiKey, userId, options);
+                        config = (0, analytics_core_1.init)(browserOptions);
+                        (0, session_manager_1.updateCookies)(config);
+                        return [4 /*yield*/, (0, analytics_core_1.add)(new context_1.Context())];
+                    case 1:
+                        _a.sent();
+                        return [4 /*yield*/, (0, analytics_core_1.add)(new analytics_core_1.Destination())];
+                    case 2:
+                        _a.sent();
+                        (0, attribution_1.trackAttributions)(config);
+                        return [2 /*return*/];
+                }
+            });
+        }); })(),
+    };
+};
+exports.init = init;
+/**
+ * Adds a new plugin.
+ *
+ * ```typescript
+ * const plugin = {...};
+ * amplitude.add(plugin);
+ * ```
+ */
+var add = function (plugin) {
+    return {
+        promise: (0, analytics_core_1.add)(plugin),
+    };
+};
+exports.add = add;
+/**
+ * Removes a plugin.
+ *
+ * ```typescript
+ * amplitude.remove('myPlugin');
+ * ```
+ */
+var remove = function (pluginName) {
+    return {
+        promise: (0, analytics_core_1.remove)(pluginName),
+    };
+};
+exports.remove = remove;
+/**
+ * Returns current user ID.
+ *
+ * ```typescript
+ * const userId = getUserId();
+ * ```
+ */
+var getUserId = function () {
+    return (0, config_1.getConfig)().userId;
+};
+exports.getUserId = getUserId;
+/**
+ * Sets a new user ID.
+ *
+ * ```typescript
+ * setUserId('userId');
+ * ```
+ */
+var setUserId = function (userId) {
+    var config = (0, config_1.getConfig)();
+    config.userId = userId;
+    (0, session_manager_1.updateCookies)(config);
+};
+exports.setUserId = setUserId;
+/**
+ * Returns current device ID.
+ *
+ * ```typescript
+ * const deviceId = getDeviceId();
+ * ```
+ */
+var getDeviceId = function () {
+    return (0, config_1.getConfig)().deviceId;
+};
+exports.getDeviceId = getDeviceId;
+/**
+ * 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');
+ * ```
+ */
+var setDeviceId = function (deviceId) {
+    var config = (0, config_1.getConfig)();
+    config.deviceId = deviceId;
+    (0, session_manager_1.updateCookies)(config);
+};
+exports.setDeviceId = setDeviceId;
+/**
+ * Returns current session ID.
+ *
+ * ```typescript
+ * const sessionId = getSessionId();
+ * ```
+ */
+var getSessionId = function () {
+    return (0, config_1.getConfig)().sessionId;
+};
+exports.getSessionId = getSessionId;
+/**
+ * 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());
+ * ```
+ */
+var setSessionId = function (sessionId) {
+    var config = (0, config_1.getConfig)();
+    config.sessionId = sessionId;
+    (0, session_manager_1.updateCookies)(config);
+};
+exports.setSessionId = setSessionId;
+/**
+ * Sets a new optOut config value. This toggles event tracking on/off.
+ *
+ *```typescript
+ * // Stops tracking
+ * setOptOut(true);
+ *
+ * // Starts/resumes tracking
+ * setOptOut(false);
+ * ```
+ */
+var setOptOut = function (optOut) {
+    (0, analytics_core_1.setOptOut)(optOut);
+    var config = (0, config_1.getConfig)();
+    (0, session_manager_1.updateCookies)(config);
+};
+exports.setOptOut = setOptOut;
+/**
+ *  Sets the network transport type for events.
+ *
+ * ```typescript
+ * // Use Fetch API
+ * setTransport('fetch');
+ *
+ * // Use XMLHttpRequest API
+ * setTransport('xhr');
+ *
+ * // Use navigator.sendBeacon API
+ * setTransport('beacon');
+ * ```
+ */
+var setTransport = function (transport) {
+    var config = (0, config_1.getConfig)();
+    var transportProvider = (0, config_1.createTransport)(transport);
+    config.transportProvider = transportProvider;
+};
+exports.setTransport = setTransport;
+/**
+ * Tracks user-defined event, with specified type, optional event properties and optional overwrites.
+ *
+ * ```typescript
+ * // event tracking with event type only
+ * track('Page Load');
+ *
+ * // event tracking with event type and additional event properties
+ * track('Page Load', { loadTime: 1000 });
+ *
+ * // event tracking with event type, additional event properties, and overwritten event options
+ * track('Page Load', { loadTime: 1000 }, { sessionId: -1 });
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await track('Page Load').promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+var track = function (eventType, eventProperties, eventOptions) {
+    return {
+        promise: (0, analytics_core_1.track)(eventType, eventProperties, eventOptions),
+    };
+};
+exports.track = track;
+/**
+ * Alis for track()
+ */
+exports.logEvent = exports.track;
+/**
+ * Sends an identify event containing user property operations
+ *
+ * ```typescript
+ * const id = new Identify();
+ * id.set('colors', ['rose', 'gold']);
+ * identify(id);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await identify(id).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+var identify = function (identify, eventOptions) {
+    if ((0, snippet_helper_1.isInstanceProxy)(identify)) {
+        var queue = identify._q;
+        identify._q = [];
+        identify = (0, snippet_helper_1.convertProxyObjectToRealObject)(new analytics_core_1.Identify(), queue);
+    }
+    return {
+        promise: (0, analytics_core_1.identify)(undefined, undefined, identify, eventOptions),
+    };
+};
+exports.identify = identify;
+/**
+ * Sends a group identify event containing group property operations.
+ *
+ * ```typescript
+ * const id = new Identify();
+ * id.set('skills', ['js', 'ts']);
+ * const groupType = 'org';
+ * const groupName = 'engineering';
+ * groupIdentify(groupType, groupName, id);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await groupIdentify(groupType, groupName, id).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+var groupIdentify = function (groupType, groupName, identify, eventOptions) {
+    if ((0, snippet_helper_1.isInstanceProxy)(identify)) {
+        var queue = identify._q;
+        identify._q = [];
+        identify = (0, snippet_helper_1.convertProxyObjectToRealObject)(new analytics_core_1.Identify(), queue);
+    }
+    return {
+        promise: (0, analytics_core_1.groupIdentify)(undefined, undefined, groupType, groupName, identify, eventOptions),
+    };
+};
+exports.groupIdentify = groupIdentify;
+var setGroup = function (groupType, groupName) {
+    return {
+        promise: (0, analytics_core_1.setGroup)(groupType, groupName),
+    };
+};
+exports.setGroup = setGroup;
+/**
+ * Sends a revenue event containing revenue property operations.
+ *
+ * ```typescript
+ * const rev = new Revenue();
+ * rev.setRevenue(100);
+ * revenue(rev);
+ *
+ * // alternatively, this tracking method is awaitable
+ * const result = await revenue(rev).promise;
+ * console.log(result.event); // {...}
+ * console.log(result.code); // 200
+ * console.log(result.message); // "Event tracked successfully"
+ * ```
+ */
+var revenue = function (revenue, eventOptions) {
+    if ((0, snippet_helper_1.isInstanceProxy)(revenue)) {
+        var queue = revenue._q;
+        revenue._q = [];
+        revenue = (0, snippet_helper_1.convertProxyObjectToRealObject)(new analytics_core_1.Revenue(), queue);
+    }
+    return {
+        promise: (0, analytics_core_1.revenue)(revenue, eventOptions),
+    };
+};
+exports.revenue = revenue;
+//# sourceMappingURL=browser-client.js.map

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

@@ -0,0 +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"]}