@schibsted/pulse-sdk 8.0.0-alpha.16 → 8.0.0-alpha.18

package/dist/cjs/builders/objects/objects-node.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultValue = exports.formatObject = void 0;
+const pulse_utils_1 = require("@schibsted/pulse-utils");
+const utils_1 = require("./utils");
+/**
+ * Format UIElement.
+ *
+ * This will transform the object to a valid UIElement.
+ * When building the id of the UIElement it will primarily
+ * try to use 'page.id' and 'page.type' (if available).
+ * If page is not available it will fall back to use
+ * 'target.id' and 'target.type' when calling sdrn().
+ * If neither page nor target is available it will
+ * use default type from the object.
+ *
+ * @private
+ * @param data object and provider is mandatory, rest is optional.
+ */
+function formatUIElement({ object, provider, page, target }) {
+    const { id, type, custom, ...rest } = object || {};
+    const { id: pageId, type: pageType } = page || {};
+    const { id: targetId, type: targetType } = target || {};
+    const { id: providerId } = provider || {};
+    const uiElementId = pageType || targetType
+        ? `${(0, utils_1.generateObjectSDRN)(pageId || targetId, providerId, pageType || targetType) || ''}:element:${id}`
+        : (0, utils_1.generateObjectSDRN)(id, providerId, type);
+    const baseObject = {
+        '@id': uiElementId,
+        '@type': type,
+    };
+    if (custom) {
+        baseObject['spt:custom'] = custom;
+    }
+    return (0, pulse_utils_1.pulseMerge)({}, baseObject, rest);
+}
+function formatDefaultObject({ object, provider }) {
+    const { id, type = 'Content', custom, ...rest } = object || {};
+    const { id: providerId } = provider || {};
+    const objectId = (0, utils_1.generateObjectSDRN)(id, providerId, type);
+    let baseObject = {};
+    if (objectId) {
+        baseObject = {
+            '@id': objectId,
+            '@type': type,
+        };
+    }
+    if (custom) {
+        baseObject['spt:custom'] = custom;
+    }
+    return (0, pulse_utils_1.pulseMerge)({}, baseObject, rest);
+}
+function formatAccount({ object }) {
+    const { id, realm = 'schibsted.com', type: _, custom, ...rest } = object || {}; // type is dropped
+    if (!id) {
+        return;
+    }
+    const baseObject = {
+        '@id': `sdrn:${realm}:user:${id}`,
+        '@type': 'Account',
+        accountId: id,
+    };
+    if (custom) {
+        baseObject['spt:custom'] = custom;
+    }
+    return (0, pulse_utils_1.pulseMerge)({}, baseObject, rest);
+}
+const objectFormatterMapping = {
+    UIElement: formatUIElement,
+    Account: formatAccount,
+};
+function getObjectFormatter(type) {
+    return objectFormatterMapping[type] || formatDefaultObject;
+}
+/**
+ * Format object.
+ *
+ * This function will recursively format itself and all nested object.
+ * The initialPage parameter is optional and will be used in the recursive
+ * nature to always pass in the root object page to each formatting.
+ *
+ * @param input
+ * @param pageInput
+ * @private
+ */
+const formatObject = (input, pageInput) => {
+    const { object: objectInput = {} } = input || {};
+    const { page: pageInObject } = objectInput;
+    const page = pageInput || pageInObject;
+    const evaluatedObjectInput = Object.keys(objectInput).reduce((accl, key) => {
+        const prop = objectInput[key];
+        if (Array.isArray(prop)) {
+            return {
+                // biome-ignore lint/performance/noAccumulatingSpread: -
+                ...accl,
+                [key]: prop.map((o) => {
+                    if ((0, pulse_utils_1.isPlainObject)(o)) {
+                        return (0, exports.formatObject)(Object.assign({}, input, { object: o }), page);
+                    }
+                    return o;
+                }),
+            };
+        }
+        if ((0, pulse_utils_1.isObject)(prop)) {
+            return {
+                // biome-ignore lint/performance/noAccumulatingSpread: -
+                ...accl,
+                [key]: (0, exports.formatObject)(Object.assign({}, input, { object: prop }), page),
+            };
+        }
+        // biome-ignore lint/performance/noAccumulatingSpread: -
+        return { ...accl, [key]: prop };
+    }, {});
+    const output = Object.assign({}, input, { page, object: evaluatedObjectInput });
+    return getObjectFormatter(objectInput.type)(output);
+};
+exports.formatObject = formatObject;
+/**
+ * @internal
+ */
+exports.default = exports.formatObject;
+/**
+ * @internal
+ */
+const defaultValue = () => undefined;
+exports.defaultValue = defaultValue;

package/dist/cjs/builders/objects/objects.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+__exportStar(require("./objects-node"), exports);
+var objects_node_1 = require("./objects-node");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(objects_node_1).default; } });

package/dist/cjs/builders/objects/utils.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateObjectSDRN = generateObjectSDRN;
+const pulse_utils_1 = require("@schibsted/pulse-utils");
+const objectTypeContentMapping = {
+    classifiedad: 'classified',
+    notificationcontent: 'notification',
+    businesstransaction: 'transaction',
+    uielement: 'element',
+};
+const getObjectContentByType = (type = '') => objectTypeContentMapping[type.toLowerCase()] ?? type.toLowerCase();
+function idIsFormatted(id) {
+    return (0, pulse_utils_1.isString)(id) && id?.startsWith('sdrn:');
+}
+function generateObjectSDRN(id, providerId, type) {
+    if (idIsFormatted(id)) {
+        return id;
+    }
+    if (((0, pulse_utils_1.isString)(id) || Number.isFinite(id)) && (0, pulse_utils_1.isString)(providerId) && (0, pulse_utils_1.isString)(type)) {
+        const contentType = getObjectContentByType(type);
+        return `sdrn:${providerId}:${contentType}:${id}`;
+    }
+}

package/dist/cjs/builders/origin-browser.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultValue = exports.default = void 0;
+const pulse_utils_1 = require("@schibsted/pulse-utils");
+__exportStar(require("./origin-node"), exports);
+var origin_node_1 = require("./origin-node");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(origin_node_1).default; } });
+const defaultValue = () => ({
+    url: pulse_utils_1.isBrowser ? document.referrer : '',
+});
+exports.defaultValue = defaultValue;

package/dist/cjs/builders/origin-node.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultValue = void 0;
+exports.default = origin;
+const pulse_utils_1 = require("@schibsted/pulse-utils");
+const utils_1 = require("./objects/utils");
+// https://schibsted.ghe.com/data-platform/event-formats/blob/master/schema/master/common-definitions.json
+const originIdRegex = /^unknown$|^sdrn:(.*)$/;
+function isOriginSDRN(originId) {
+    return (0, pulse_utils_1.isString)(originId) && originIdRegex.test(originId);
+}
+function origin(input) {
+    const { origin: originInput, provider } = input || {};
+    const { id: originInputId, type: originInputType, ...rest } = originInput || {};
+    const { id: providerId } = provider || {};
+    // If the id of origin has already been formatted upstream, we don't want to do it again
+    // This can happen, since previously we allowed the id through without any formatting and
+    // brands had to do it on their end to get it correctly.
+    const formattedOriginId = isOriginSDRN(originInputId)
+        ? originInputId
+        : (0, utils_1.generateObjectSDRN)(originInputId, providerId, originInputType);
+    const base = {
+        ...(formattedOriginId && { '@id': formattedOriginId }),
+        ...(originInputType && { '@type': originInputType }),
+    };
+    return Object.assign({}, base, rest);
+}
+const defaultValue = () => undefined;
+exports.defaultValue = defaultValue;

package/dist/cjs/builders/origin.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+__exportStar(require("./origin-node"), exports);
+var origin_node_1 = require("./origin-node");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(origin_node_1).default; } });

package/dist/cjs/builders/provider.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultValue = void 0;
+exports.generateProviderSDRN = generateProviderSDRN;
+exports.default = provider;
+const PROVIDER_ID_UNDEFINED = '--PROVIDER-ID-NOT-DEFINED--';
+const DEFAULT_PROVIDER_TYPE = 'Organization';
+function generateProviderSDRN(providerId) {
+    if (providerId) {
+        return `sdrn:schibsted:client:${providerId}`;
+    }
+    return PROVIDER_ID_UNDEFINED;
+}
+function provider(input) {
+    const { provider: providerInput } = input || {};
+    const { id, type = DEFAULT_PROVIDER_TYPE, ...rest } = providerInput || {};
+    const base = {
+        '@type': type,
+        '@id': generateProviderSDRN(id),
+    };
+    return Object.assign({}, base, rest);
+}
+const defaultValue = () => undefined;
+exports.defaultValue = defaultValue;

package/dist/cjs/builders/session-browser.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultValue = exports.readSession = exports.readAndParse = void 0;
+exports.default = session;
+const pulse_utils_1 = require("@schibsted/pulse-utils");
+const uuid_1 = require("uuid");
+const { USE_LOCALSTORAGE } = pulse_utils_1.cookieConfig;
+const SESSION_STORAGE_KEY = '_pulsesession';
+const generateSessionSDRN = (sessionId) => `sdrn:schibsted:session:${sessionId}`;
+// Return parsed json from cookie (or localStorage if enabled), or undefined.
+const readAndParse = (storageKey) => {
+    try {
+        const storedSession = (0, pulse_utils_1.readCookie)(storageKey);
+        if (storedSession) {
+            return JSON.parse(storedSession);
+        }
+    }
+    catch (_e) {
+        // If localStorage/cookie is not available, we treat it as if
+        // the value is undefined.
+        // If data is unparseable, we also ignore it.
+        return undefined;
+    }
+    return undefined;
+};
+exports.readAndParse = readAndParse;
+// Read and parse session data from localStorage.
+// Any invalid or unreadable data is ignored.
+const readSession = () => {
+    const storedSession = (0, exports.readAndParse)(SESSION_STORAGE_KEY);
+    if (storedSession) {
+        const [id, startTimeMs, lastEventTimeMs] = storedSession;
+        const startTime = new Date(startTimeMs);
+        const lastEventTime = new Date(lastEventTimeMs);
+        if (id &&
+            startTime &&
+            lastEventTime &&
+            !Number.isNaN(startTime.getTime()) &&
+            !Number.isNaN(lastEventTime.getTime())) {
+            return { id, startTime, lastEventTime };
+        }
+    }
+    return undefined;
+};
+exports.readSession = readSession;
+// Write session data to localStorage
+const writeSession = (session) => {
+    const { id, startTime, lastEventTime } = session;
+    try {
+        const sessionToStore = [id, startTime.getTime(), lastEventTime.getTime()];
+        const halfHourInDays = 1.0 / (24 * 2);
+        (0, pulse_utils_1.writeCookie)(SESSION_STORAGE_KEY, JSON.stringify(sessionToStore), (0, pulse_utils_1.getRootDomain)(), halfHourInDays);
+        // Delete old localStorage-based session if needed
+        if (!USE_LOCALSTORAGE && pulse_utils_1.isBrowser && window.localStorage) {
+            // removeItem will do nothing to a non-existing item.
+            window.localStorage.removeItem(SESSION_STORAGE_KEY);
+        }
+    }
+    catch (_e) {
+        // If we can't write the session, we just move on in life
+    }
+};
+const createSession = (eventCreationDate) => {
+    const now = eventCreationDate ?? new Date();
+    return {
+        id: generateSessionSDRN((0, uuid_1.v4)()),
+        startTime: now,
+        lastEventTime: now,
+    };
+};
+const updateSession = (session, eventCreationDate) => {
+    const now = eventCreationDate ?? new Date();
+    const sessionMaxInterval = 30 * 60 * 1000; // 30 minutes in milliseconds
+    if (!session || session.lastEventTime.getTime() < now.getTime() - sessionMaxInterval) {
+        return createSession(now);
+    }
+    return { ...session, lastEventTime: now };
+};
+const defaultValue = () => undefined;
+exports.defaultValue = defaultValue;
+// Add session information to an event
+// {
+//   "session": {
+//     "id": "sdrn:schibsted:session:123e4567-e89b-12d3-a456-426655440000",
+//     "startTime": "2020-01-21T12:29:00.999Z"
+//   }
+// }
+function session(_input, eventCreationDate) {
+    const oldSession = (0, exports.readSession)();
+    const newSession = updateSession(oldSession, eventCreationDate);
+    writeSession(newSession);
+    const { id, startTime } = newSession;
+    return {
+        '@id': id,
+        startTime: startTime.toISOString(),
+    };
+}

package/dist/cjs/builders/session-node.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultValue = void 0;
+exports.default = default_1;
+const defaultValue = () => undefined;
+exports.defaultValue = defaultValue;
+function default_1(input) {
+    return input ?? {};
+}

package/dist/cjs/builders/session.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+__exportStar(require("./session-browser"), exports);
+var session_browser_1 = require("./session-browser");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(session_browser_1).default; } });

package/dist/cjs/builders/tracker-browser.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+__exportStar(require("./tracker-node"), exports);
+var tracker_node_1 = require("./tracker-node");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(tracker_node_1).default; } });
+/*
+ * this use case has not surfaced in any implementation:
+ */
+// export const defaultValue = () => {
+//   const { timing } = (window.performance || {});
+//   return {
+//     performance: {
+//       browser: timing ? timing.toJSON() : undefined,
+//     },
+//   };
+// };

package/dist/cjs/builders/tracker-node.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultValue = void 0;
+exports.default = tracker;
+const version_json_1 = __importDefault(require("../version.json"));
+/**
+ * Format tracker objects
+ */
+function tracker(input) {
+    const { tracker: trackerInput } = input || {};
+    const base = {
+        name: 'Pulse Node.js SDK',
+        type: 'JS',
+        version: version_json_1.default.SDK_VERSION,
+    };
+    return Object.assign({}, base, trackerInput);
+}
+const defaultValue = () => undefined;
+exports.defaultValue = defaultValue;

package/dist/cjs/builders/trackerBuilder.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+__exportStar(require("./tracker-node"), exports);
+var tracker_node_1 = require("./tracker-node");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(tracker_node_1).default; } });

package/dist/cjs/config-browser.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.baseConfig = exports.remoteConfig = exports.CISEndpoints = exports.collectorEndpoints = void 0;
+exports.collectorEndpoints = {
+    dev: 'https://collector.pulse-internal-dev.schibsted.io',
+    pre: 'https://collector.pulse-internal-pre.schibsted.io',
+    pro: 'https://dc.schibsted.io',
+};
+exports.CISEndpoints = {
+    dev: 'https://cis.pulse-internal-dev.schibsted.io',
+    pre: 'https://cis.pulse-internal-pre.schibsted.io',
+    pro: 'https://ncis.schibsted.com',
+};
+exports.remoteConfig = {
+    dev: 'https://sdkconfig.pulse-internal-dev.schibsted.io/js/config.json',
+    pre: 'https://sdkconfig.pulse-internal-pre.schibsted.io/js/config.json',
+    pro: 'https://sdkconfig.pulse.schibsted.io/js/config.json',
+};
+exports.baseConfig = {
+    cisEnabled: true,
+    deployStage: 'pro',
+    eventDebounce: 200,
+    environment: 'browser',
+    collectorPath: '/api/v1/track',
+    useBeaconWhenAvailable: true,
+};

package/dist/cjs/config.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.baseConfig = void 0;
+exports.baseConfig = {
+    eventDebounce: 10,
+    environment: 'node',
+    cisEnabled: true,
+    collectorPath: '/api/v1/content',
+};

package/dist/cjs/createPulseTracker.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * @module createPulseTracker
+ * This module is part of the Pulse SDK implementation of Schibsted's Mandatory Building Blocks (MBB) specification.
+ * It is intended to simplify the creation and management of a singleton Pulse Tracker instance in browser environments.
+ * Note that this module should only be used in browser environments, as it relies on the global `window` object.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPulseTracker = createPulseTracker;
+const pulse_utils_1 = require("@schibsted/pulse-utils/");
+const Tracker_1 = __importDefault(require("./Tracker"));
+/**
+ * Flags whether the Pulse Tracker creation process has been started.
+ */
+function isTrackerCreated() {
+    return pulse_utils_1.isBrowser && !!window.__pulseTracker;
+}
+/**
+ * Make the given tracker instance globally accessible
+ * @param singleton
+ */
+function attachTrackerToWindow(singleton) {
+    if (pulse_utils_1.isBrowser) {
+        window.__pulseTracker = singleton;
+    }
+}
+/**
+ * Creates and returns the singleton Pulse Tracker instance.
+ * @param clientId
+ * @param config
+ * @param builders
+ * @throws - If called outside a browser environment.
+ * @throws - If the Pulse Tracker has already been created (or creation is already in progress).
+ */
+async function createPulseTracker({ clientId, config, builders }) {
+    if (!pulse_utils_1.isBrowser) {
+        throw new Error('createPulseTracker is only available in browser environments');
+    }
+    if (isTrackerCreated()) {
+        throw new Error('Pulse Tracker is already created (or creation already started)');
+    }
+    const singleton = (async () => {
+        return new Tracker_1.default(clientId, config, builders);
+    })();
+    attachTrackerToWindow(singleton);
+    return singleton;
+}

package/dist/cjs/defer.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const emptyFn = () => {
+    void 0;
+};
+function default_1(value) {
+    let res = emptyFn;
+    let rej = emptyFn;
+    const promise = new Promise((resolve, reject) => {
+        res = resolve;
+        rej = reject;
+    });
+    return {
+        promise,
+        resolve: res,
+        reject: rej,
+        inputValue: value,
+    };
+}