@sitecore-content-sdk/analytics-core 2.0.0-canary.12

package/dist/esm/src/consts.js

@@ -0,0 +1,36 @@
+import packageJson from '../package.json';
+/**
+ * The package version.
+ * @internal
+ */
+export const LIBRARY_VERSION = packageJson.version;
+/**
+ * The prefix for cookie names used by the analytics library.
+ * @internal
+ */
+export const COOKIE_NAME_PREFIX = 'sc_';
+/**
+ * The name of the client ID cookie.
+ * @internal
+ */
+export const CLIENT_ID_COOKIE_NAME = 'cid';
+/**
+ * The default number of days until the client ID cookie expires.
+ * @internal
+ */
+export const DEFAULT_COOKIE_EXPIRY_DAYS = 730;
+/**
+ * The seconds in a day, used for cookie expiration calculations.
+ * @internal
+ */
+export const DAILY_SECONDS = 86400;
+/**
+ * The api version of the Edge Proxy.
+ * @internal
+ */
+export const API_VERSION = 'v1.2';
+/**
+ * The header name for the correlation ID used in analytics requests.
+ * @internal
+ */
+export const CORRELATION_ID_HEADER = 'x-sc-correlation-id';

package/dist/esm/src/cookie/get-default-cookie-attributes.js

@@ -0,0 +1,17 @@
+import { DAILY_SECONDS, DEFAULT_COOKIE_EXPIRY_DAYS } from '../consts';
+/**
+ * Gets the default cookie attributes.
+ * @param {number} [maxAge] - Sets the cookie "Max-Age" attribute in days.
+ * @param {string} [cookieDomain] - Optional domain for the cookie.
+ * @returns {CookieProperties} The default configuration settings for the cookie string.
+ * @internal
+ */
+export function getDefaultCookieAttributes(maxAge = DEFAULT_COOKIE_EXPIRY_DAYS, cookieDomain) {
+    return {
+        domain: cookieDomain,
+        maxAge: maxAge * DAILY_SECONDS,
+        path: '/',
+        sameSite: 'None',
+        secure: true,
+    };
+}

package/dist/esm/src/correlation-id/generate-correlation-id.js

@@ -0,0 +1,9 @@
+import { generateV4UUID } from '../utils';
+/**
+ * Generates a correlation id.
+ * @returns {string} A correlation id string.
+ * @internal
+ */
+export function generateCorrelationId() {
+    return generateV4UUID().replace(/-/g, '');
+}

package/dist/esm/src/index.js

@@ -0,0 +1,4 @@
+export { getClientId } from './client-id/get-client-id';
+export { analyticsPlugin } from './initialization/plugin';
+export { analyticsServerAdapter } from './initialization/server-adapter';
+export { analyticsBrowserAdapter } from './initialization/browser-adapter';

package/dist/esm/src/infer/infer.js

@@ -0,0 +1,24 @@
+/**
+ * Returns the uppercase language code of the current web page's root HTML element, using the `lang` attribute.
+ * If unavailable or invalid, undefined is returned.
+ * @returns The language attribute or undefined.
+ * @internal
+ */
+export function language() {
+    return typeof window === 'undefined' || window.document.documentElement.lang.length <= 1
+        ? undefined
+        : new Intl.Locale(window.document.documentElement.lang).language.toLocaleUpperCase();
+}
+/**
+ * Returns the name of the current page extracted from the URL's pathname.
+ * If it's the home page, it returns `Home Page`.
+ * @returns `Home Page` if root, otherwise the pathname segment.
+ * @internal
+ */
+export function pageName() {
+    if (typeof window === 'undefined')
+        return '';
+    return window.location.pathname === '/'
+        ? 'Home Page'
+        : window.location.pathname.split('/').pop();
+}

package/dist/esm/src/initialization/browser-adapter.js

@@ -0,0 +1,39 @@
+import { COOKIE_NAME_PREFIX, fetchClientIdFromEdgeProxy, getDefaultCookieAttributes, } from '../internal';
+import { createCookieString, getCookieValueClientSide } from '../utils';
+import { deleteCookie } from '../utils/cookies/delete-cookie';
+import { getAnalyticsPlugin } from './plugin';
+import { getCoreContext } from '@sitecore-content-sdk/core';
+/**
+ * Creates a browser-based analytics adapter that reads and writes the visitor ID
+ * using cookies and can resolve a new client ID from the Edge proxy when needed.
+ * The adapter also provides access to the current URL search parameters.
+ * @returns {AnalyticsBrowserAdapter} The analytics browser adapter.
+ * @public
+ */
+export function analyticsBrowserAdapter() {
+    return {
+        type: 'browser',
+        getClientId: () => {
+            return getCookieValueClientSide(getAnalyticsPlugin().options.cookies.name);
+        },
+        setClientId: async () => {
+            const coreConfig = getCoreContext().config;
+            const analyticsOptions = getAnalyticsPlugin().options;
+            const cookieAttributes = getDefaultCookieAttributes(analyticsOptions.cookies.expiryDays, analyticsOptions.cookies.domain);
+            const legacyCookie = getCookieValueClientSide(`${COOKIE_NAME_PREFIX}${coreConfig.contextId}`);
+            if (legacyCookie) {
+                document.cookie = createCookieString(analyticsOptions.cookies.name, legacyCookie, cookieAttributes);
+                deleteCookie(`${COOKIE_NAME_PREFIX}${coreConfig.contextId}`);
+                return;
+            }
+            const cookieValues = await fetchClientIdFromEdgeProxy(coreConfig.edgeUrl, coreConfig.contextId, analyticsOptions.timeout);
+            analyticsOptions.visitorIds = cookieValues;
+            document.cookie = createCookieString(analyticsOptions.cookies.name, cookieValues.clientId, cookieAttributes);
+        },
+        location: {
+            getSearchParams: () => {
+                return window.location.search;
+            },
+        },
+    };
+}

package/dist/esm/src/initialization/const.js

@@ -0,0 +1,5 @@
+/**
+ * The name of the Analytics plugin.
+ * @public
+ */
+export const ANALYTICS_PLUGIN_NAME = 'AnalyticsPlugin';

package/dist/esm/src/initialization/plugin.js

@@ -0,0 +1,71 @@
+import { CLIENT_ID_COOKIE_NAME, COOKIE_NAME_PREFIX, DEFAULT_COOKIE_EXPIRY_DAYS, LIBRARY_VERSION, } from '../consts';
+import { ANALYTICS_PLUGIN_NAME } from './const';
+import { getCoreContext, debug, constants } from '@sitecore-content-sdk/core';
+import { getClientId } from '../client-id/get-client-id';
+const debugInit = debug.init;
+const { ERROR_MESSAGES } = constants;
+/**
+ * Creates an analytics plugin with the provided options.
+ * @param {AnalyticsPluginParams} params - The parameters for the analytics plugin.
+ * @returns {AnalyticsPlugin} The analytics plugin instance.
+ * @public
+ */
+export function analyticsPlugin(params) {
+    var _a;
+    const { options, adapter } = params;
+    const resolvedOptions = {
+        cookies: {
+            domain: options === null || options === void 0 ? void 0 : options.cookieDomain,
+            enabled: (_a = options === null || options === void 0 ? void 0 : options.enableCookie) !== null && _a !== void 0 ? _a : false,
+            expiryDays: (options === null || options === void 0 ? void 0 : options.cookieExpiryDays) || DEFAULT_COOKIE_EXPIRY_DAYS,
+            name: `${COOKIE_NAME_PREFIX}${CLIENT_ID_COOKIE_NAME}`,
+            path: (options === null || options === void 0 ? void 0 : options.cookiePath) || '/',
+        },
+        timeout: options === null || options === void 0 ? void 0 : options.timeout,
+    };
+    return {
+        name: ANALYTICS_PLUGIN_NAME,
+        init,
+        options: resolvedOptions,
+        adapter,
+    };
+}
+/**
+ * Initializes the analytics plugin with the provided options.
+ * @internal
+ */
+async function init() {
+    debugInit(`Initializing ${ANALYTICS_PLUGIN_NAME}`);
+    const coreContext = getCoreContext();
+    const analyticsPlugin = getAnalyticsPlugin();
+    if (!analyticsPlugin.options.cookies.enabled) {
+        debugInit(`Cookies are disabled for ${ANALYTICS_PLUGIN_NAME}. If this was not intentional, set "enableCookie" to "true".`);
+        return;
+    }
+    const adapter = analyticsPlugin.adapter;
+    if (!adapter.getClientId() || analyticsPlugin.adapter.type !== 'browser') {
+        await adapter.setClientId();
+        debugInit(`Cookie set for ${ANALYTICS_PLUGIN_NAME}`);
+    }
+    if (analyticsPlugin.adapter.type === 'browser')
+        window.scContentSDK = Object.assign(Object.assign({}, window.scContentSDK), { analytics_core: {
+                getClientId,
+                options: {
+                    siteName: coreContext.config.siteName,
+                    contextId: coreContext.config.contextId,
+                    edgeUrl: coreContext.config.edgeUrl,
+                },
+                version: LIBRARY_VERSION,
+            } });
+}
+/**
+ * Retrieves the analytics plugin instance from the core context.
+ * @returns {AnalyticsPlugin} The analytics plugin instance.
+ * @internal
+ */
+export function getAnalyticsPlugin() {
+    const plugin = getCoreContext().plugins.get(ANALYTICS_PLUGIN_NAME);
+    if (!plugin)
+        throw new Error(ERROR_MESSAGES.IE_004(ANALYTICS_PLUGIN_NAME));
+    return plugin;
+}

package/dist/esm/src/initialization/server-adapter.js

@@ -0,0 +1,88 @@
+import { COOKIE_NAME_PREFIX, fetchClientIdFromEdgeProxy, getDefaultCookieAttributes, } from '../internal';
+import { createCookieString, getCookieServerSide } from '../utils';
+import { getAnalyticsPlugin } from './plugin';
+import { getCoreContext } from '@sitecore-content-sdk/core';
+/**
+ * Creates a server-based analytics adapter that reads and writes the visitor ID
+ * using cookies and can resolve a new client ID from the Edge proxy when needed.
+ * The adapter also provides access to the current URL search parameters.
+ * @template Request - The HTTP request type extending `IncomingMessage`.
+ * @template Response - The HTTP response type extending `OutgoingMessage`.
+ * @param {Request} request - The HTTP request object.
+ * @param {Response} response - The HTTP response object.
+ * @returns {AnalyticsServerAdapter} The analytics server adapter.
+ * @public
+ */
+export function analyticsServerAdapter(request, response) {
+    return {
+        type: 'server',
+        getClientId: () => {
+            return getClientId(request);
+        },
+        setClientId: async () => {
+            var _a;
+            const coreConfig = getCoreContext().config;
+            const analyticsOptions = getAnalyticsPlugin().options;
+            const cookieOptions = analyticsOptions.cookies;
+            const clientIdName = cookieOptions.name;
+            const legacyClientIdName = `${COOKIE_NAME_PREFIX}${coreConfig.contextId}`;
+            const defaultCookieAttributes = getDefaultCookieAttributes(cookieOptions.expiryDays, cookieOptions.domain);
+            const legacyClientIdCookie = getCookieServerSide(request.headers.cookie, legacyClientIdName);
+            if (legacyClientIdCookie) {
+                request.headers.cookie = (_a = request.headers.cookie) === null || _a === void 0 ? void 0 : _a.replace(legacyClientIdCookie.name, clientIdName);
+                response.setHeader('Set-Cookie', [
+                    createCookieString(clientIdName, legacyClientIdCookie.value, defaultCookieAttributes),
+                    createCookieString(legacyClientIdName, '', Object.assign(Object.assign({}, defaultCookieAttributes), { maxAge: 0 })),
+                ]);
+                return;
+            }
+            const clientIdCookie = getClientId(request);
+            let clientIdCookieValue;
+            if (!clientIdCookie) {
+                const cookieValues = await fetchClientIdFromEdgeProxy(coreConfig.edgeUrl, coreConfig.contextId, analyticsOptions.timeout);
+                clientIdCookieValue = cookieValues.clientId;
+                analyticsOptions.visitorIds = cookieValues;
+            }
+            else
+                clientIdCookieValue = clientIdCookie;
+            const clientIdCookieString = createCookieString(clientIdName, clientIdCookieValue, defaultCookieAttributes);
+            if (!clientIdCookie) {
+                request.headers.cookie = request.headers.cookie
+                    ? request.headers.cookie + '; ' + clientIdCookieString
+                    : clientIdCookieString;
+            }
+            let cookieHeader;
+            const currentSetCookieHeader = response.getHeader('Set-Cookie');
+            if (currentSetCookieHeader) {
+                if (Array.isArray(currentSetCookieHeader)) {
+                    cookieHeader = [...currentSetCookieHeader, clientIdCookieString];
+                }
+                else {
+                    cookieHeader = `${currentSetCookieHeader}; ${clientIdCookieString}`;
+                }
+            }
+            else {
+                cookieHeader = clientIdCookieString;
+            }
+            response.setHeader('Set-Cookie', cookieHeader);
+        },
+        location: {
+            getSearchParams: () => {
+                // Host is irrelevant but necessary to support relative URL
+                const requestUrl = new URL(request.url, `https://localhost`);
+                return requestUrl.search;
+            },
+        },
+    };
+}
+/**
+ * Retrieves the client ID from the request cookies.
+ * @template Request - The HTTP request type extending `IncomingMessage`.
+ * @param {Request} request
+ * @returns {string | null} The client ID or null if not found.
+ * @internal
+ */
+function getClientId(request) {
+    var _a, _b;
+    return ((_b = (_a = getCookieServerSide(request.headers.cookie, getAnalyticsPlugin().options.cookies.name)) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : null);
+}

package/dist/esm/src/initialization/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/src/interfaces.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/src/internal.js

@@ -0,0 +1,7 @@
+export { getDefaultCookieAttributes } from './cookie/get-default-cookie-attributes';
+export { language, pageName } from './infer/infer';
+export { generateCorrelationId } from './correlation-id/generate-correlation-id';
+export { API_VERSION, COOKIE_NAME_PREFIX, DAILY_SECONDS, DEFAULT_COOKIE_EXPIRY_DAYS, LIBRARY_VERSION, CORRELATION_ID_HEADER, CLIENT_ID_COOKIE_NAME, } from './consts';
+export { fetchClientIdFromEdgeProxy } from './client-id/fetch-client-id-from-edge-proxy';
+export { getAnalyticsPlugin } from './initialization/plugin';
+export { ANALYTICS_PLUGIN_NAME } from './initialization/const';

package/dist/esm/src/utils/browser/appendScriptWithAttributes.js

@@ -0,0 +1,12 @@
+/**
+ * Appends a script element to the document head with the specified attributes.
+ * @param {ScriptAttributes} attributes - The attributes to set on the script element.
+ * @internal
+ */
+export function appendScriptWithAttributes(attributes) {
+    const sdkScriptElement = document.createElement('script');
+    sdkScriptElement.type = 'text/javascript';
+    sdkScriptElement.src = attributes.src;
+    sdkScriptElement.async = attributes.async;
+    document.head.appendChild(sdkScriptElement);
+}

package/dist/esm/src/utils/converters/base-64-converter.js

@@ -0,0 +1,15 @@
+/**
+ * Converts a string or plain object to a base64 string representation.
+ * @param {string | Record<string, unknown>} input The value to convert.
+ * @returns {string} The base64-encoded string.
+ * @internal
+ */
+export function convertToBase64(input) {
+    const data = typeof input === 'string' ? input : JSON.stringify(input);
+    const stringFormat = 'base64';
+    if (typeof Buffer === 'function')
+        return Buffer.from(data).toString(stringFormat);
+    if (typeof (window === null || window === void 0 ? void 0 : window.btoa) === 'function')
+        return window.btoa(data);
+    return data;
+}

package/dist/esm/src/utils/converters/flatten-object.js

@@ -0,0 +1,32 @@
+/**
+ * Flattens a nested object by concatenating keys with an underscore.
+ * @param {FlattenObjectDataParameters} data Parameters describing the flatten operation.
+ * @returns {FlattenedObject} A new flattened object.
+ * @example
+ * ```ts
+ * const object = { order: { amount: 1, delivered: false } };
+ * const flattenedObject = flattenObject(object);
+ * // flattenedObject is { order_amount: 1, order_delivered: false }
+ * ```
+ * @internal
+ */
+export function flattenObject(data) {
+    var _a;
+    const { currentKey, object } = data;
+    const newObject = (_a = data.newObject) !== null && _a !== void 0 ? _a : {};
+    // eslint-disable-next-line guard-for-in
+    for (const key in object) {
+        const value = object[key];
+        if (value === undefined)
+            continue;
+        if (typeof value === 'object' && !Array.isArray(value))
+            flattenObject({
+                currentKey: `${currentKey ? `${currentKey}_${key}` : key}`,
+                newObject,
+                object: value,
+            });
+        else
+            newObject[currentKey ? `${currentKey}_${key}` : key] = value;
+    }
+    return newObject;
+}

package/dist/esm/src/utils/cookies/consts.js

@@ -0,0 +1 @@
+export const DAILY_SECONDS = 86400;

package/dist/esm/src/utils/cookies/cookie-exists-in-server-side.js

@@ -0,0 +1,11 @@
+import { getCookieServerSide } from './get-cookie-server-side';
+/**
+ * Checks whether a cookie exists in a server-side request header string.
+ * @param {string} cookiesHeader Raw `cookie` header contents.
+ * @param {string} cookieName The cookie name to search for.
+ * @returns {boolean} True when the cookie is present.
+ * @internal
+ */
+export function cookieExistsInServerSide(cookiesHeader, cookieName) {
+    return getCookieServerSide(cookiesHeader, cookieName) !== undefined;
+}

package/dist/esm/src/utils/cookies/cookie-exists.js

@@ -0,0 +1,10 @@
+/**
+ * Checks whether the cookie exists within a cookie string.
+ * @param {string} cookieStr Cookie string containing individual cookies.
+ * @param {string} cookieName The cookie name to search for.
+ * @returns {boolean} True when the cookie exists in the string.
+ * @internal
+ */
+export function cookieExists(cookieStr, cookieName) {
+    return cookieStr.split('; ').some((cookie) => cookie.split('=')[0] === cookieName);
+}

package/dist/esm/src/utils/cookies/create-cookie-string.js

@@ -0,0 +1,17 @@
+/**
+ * Creates a cookie string with the provided attributes.
+ * @param {string} name Cookie name.
+ * @param {string} value Cookie value.
+ * @param {CookieProperties} attributes Supported cookie attributes.
+ * @returns {string} Serialized cookie ready to be assigned to `document.cookie`.
+ * @internal
+ */
+export function createCookieString(name, value, attributes) {
+    let cookieString = `${name}=${value};`;
+    cookieString += ` Max-Age=${attributes.maxAge}; SameSite=${attributes.sameSite};`;
+    cookieString += attributes.secure ? ' Secure;' : '';
+    cookieString += attributes.path ? ` Path=${attributes.path};` : '';
+    cookieString += attributes.domain ? ` Domain=${attributes.domain};` : '';
+    cookieString = cookieString.substring(0, cookieString.length - 1);
+    return cookieString;
+}

package/dist/esm/src/utils/cookies/delete-cookie.js

@@ -0,0 +1,8 @@
+/**
+ * Deletes a cookie from the document (client-side only).
+ * @param {string} cookieName The cookie to be deleted.
+ * @internal
+ */
+export function deleteCookie(cookieName) {
+    document.cookie = cookieName + '=; Path=/; Expires=Thu, 01 Jan 1970 00:00:01 GMT;';
+}

package/dist/esm/src/utils/cookies/get-cookie-server-side.js

@@ -0,0 +1,11 @@
+import { getCookie } from './get-cookie';
+/**
+ * Retrieves a cookie from the server-side request header string.
+ * @param {string | undefined} cookiesHeader Raw `cookie` header contents.
+ * @param {string} cookieName The cookie name to look up.
+ * @returns {{ name: string; value: string } | undefined} The resolved cookie information when found.
+ * @internal
+ */
+export function getCookieServerSide(cookiesHeader, cookieName) {
+    return getCookie(cookiesHeader, cookieName);
+}

package/dist/esm/src/utils/cookies/get-cookie-value-client-side.js

@@ -0,0 +1,12 @@
+import { getCookie } from './get-cookie';
+/**
+ * Retrieves the value of a cookie in the browser context.
+ * @param {string} cookieName The name of the cookie to read.
+ * @returns {string} The cookie value or an empty string when not found.
+ * @internal
+ */
+export function getCookieValueClientSide(cookieName) {
+    var _a;
+    const cookie = getCookie(document.cookie, cookieName);
+    return (_a = cookie === null || cookie === void 0 ? void 0 : cookie.value) !== null && _a !== void 0 ? _a : '';
+}

package/dist/esm/src/utils/cookies/get-cookie.js

@@ -0,0 +1,17 @@
+/**
+ * Retrieves a cookie by name from a cookie string.
+ * @param {string | undefined} cookieStr Cookie string containing serialized cookies.
+ * @param {string} cookieName The cookie name to locate.
+ * @returns {{ name: string; value: string } | undefined} The cookie name/value pair when found.
+ * @internal
+ */
+export function getCookie(cookieStr, cookieName) {
+    if (!cookieStr)
+        return undefined;
+    const found = cookieStr.split('; ').find((cookie) => {
+        return cookie.indexOf('=') > 0 && cookie.split('=')[0] === cookieName;
+    });
+    return found !== undefined
+        ? { name: found.split('=')[0], value: found.split('=')[1] }
+        : undefined;
+}

package/dist/esm/src/utils/cookies/interfaces.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/src/utils/generators/generate-v4-uuid.js

@@ -0,0 +1,8 @@
+/**
+ * Generates a v4 UUID string using the global crypto API.
+ * @returns {string} A v4 UUID string.
+ * @internal
+ */
+export function generateV4UUID() {
+    return globalThis.crypto.randomUUID();
+}

package/dist/esm/src/utils/interfaces.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/src/utils/validators/is-short-iso-date-string.js

@@ -0,0 +1,17 @@
+/**
+ * Checks if the provided string matches the shortened ISO 8601 format (`YYYY-MM-DDThh:mm`).
+ * @param {string} date The date string to validate.
+ * @returns {boolean} True when the value conforms to the shortened ISO format.
+ * @internal
+ */
+export function isShortISODateString(date) {
+    try {
+        const dateString = date + 'Z';
+        const convertedDate = new Date(dateString).toISOString().substring(0, 16);
+        return convertedDate === date;
+        // eslint-disable-next-line no-unused-vars
+    }
+    catch (error) {
+        return false;
+    }
+}

package/dist/esm/src/utils/validators/is-valid-email.js

@@ -0,0 +1,13 @@
+/**
+ * Validates whether the provided value matches a basic email pattern.
+ * @param {string} email The email address to validate.
+ * @returns {boolean} True when the email matches the allowed pattern.
+ * @internal
+ */
+export function isValidEmail(email) {
+    const regx = /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/;
+    if (!email || email.length > 320) {
+        return false;
+    }
+    return regx.test(email);
+}

package/dist/esm/src/utils.js

@@ -0,0 +1,10 @@
+export { createCookieString } from './utils/cookies/create-cookie-string';
+export { getCookieValueClientSide } from './utils/cookies/get-cookie-value-client-side';
+export { getCookie } from './utils/cookies/get-cookie';
+export { getCookieServerSide } from './utils/cookies/get-cookie-server-side';
+export { cookieExists } from './utils/cookies/cookie-exists';
+export { flattenObject } from './utils/converters/flatten-object';
+export { isShortISODateString } from './utils/validators/is-short-iso-date-string';
+export { isValidEmail } from './utils/validators/is-valid-email';
+export { generateV4UUID } from './utils/generators/generate-v4-uuid';
+export { appendScriptWithAttributes, } from './utils/browser/appendScriptWithAttributes';

package/internal.d.ts

@@ -0,0 +1,2 @@
+export * from './types/src/internal';
+

package/package.json

@@ -0,0 +1,78 @@
+{
+  "author": {
+    "name": "Sitecore Corporation",
+    "url": "https://doc.sitecore.com/xmc/en/developers/content-sdk/index.html"
+  },
+  "bugs": {
+    "url": "https://github.com/sitecore/content-sdk/issues"
+  },
+  "dependencies": {
+    "@sitecore-content-sdk/core": "2.0.0-canary.12",
+    "debug": "^4.4.3"
+  },
+  "description": "Provides shared logic and runtime initialization. Required for the Content SDK 'events' and 'personalize' packages to function.",
+  "devDependencies": {
+    "@jest/types": "^29.6.3",
+    "@stylistic/eslint-plugin": "^5.2.2",
+    "@types/debug": "^4.1.12",
+    "@types/jest": "^29.5.12",
+    "@typescript-eslint/eslint-plugin": "8.39.0",
+    "@typescript-eslint/parser": "8.39.0",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.32.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "2.32.0",
+    "eslint-plugin-jsdoc": "52.0.3",
+    "eslint-plugin-prettier": "^4.0.0",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "jest-environment-node": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.2"
+  },
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "types/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/src/index.js",
+      "require": "./dist/cjs/src/index.js",
+      "types": "./types/src/index.d.ts"
+    },
+    "./internal": {
+      "import": "./dist/esm/src/internal.js",
+      "require": "./dist/cjs/src/internal.js",
+      "types": "./types/src/internal.d.ts"
+    },
+    "./utils": {
+      "import": "./dist/esm/src/utils.js",
+      "require": "./dist/cjs/src/utils.js",
+      "types": "./types/src/utils.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "types",
+    "/*.d.ts"
+  ],
+  "homepage": "https://doc.sitecore.com/xmc/en/developers/content-sdk/index.html",
+  "license": "Apache-2.0",
+  "name": "@sitecore-content-sdk/analytics-core",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "npm run clean && tsc -p tsconfig.json && tsc -p tsconfig-esm.json",
+    "clean": "del-cli dist types",
+    "coverage": "jest --config jest.config.ts --coverage",
+    "generate-docs": "npx typedoc --plugin typedoc-plugin-markdown --outputFileStrategy Members --parametersFormat table --readme none --out ../../ref-docs/analytics-core --entryPoints src/index.ts --entryPoints src/internal.ts --entryPoints src/utils.ts --githubPages false",
+    "lint": "eslint \"./src/**/*.ts\"",
+    "prepublishOnly": "npm run build",
+    "test": "jest --config jest.config.ts",
+    "api-extractor": "npm run build && api-extractor run --local --verbose",
+    "api-extractor:verify": "api-extractor run"
+  },
+  "version": "2.0.0-canary.12",
+  "gitHead": "4a26005860f4931f25d8c63d765a030e04a5b1f4"
+}

package/types/src/client-id/fetch-client-id-from-edge-proxy.d.ts

@@ -0,0 +1,11 @@
+import type { VisitorIds } from '../interfaces';
+/**
+ * Gets the client ID and client key from Sitecore Edge proxy.
+ * @param {string} edgeUrl - The base URL for the Edge proxy API.
+ * @param {string} contextId - The Sitecore context ID parameter for the Edge proxy API.
+ * @param {number} [timeout] - The timeout in milliseconds for the call to the proxy.
+ * @returns {Promise<VisitorIds>} The client ID and profile ID from the proxy.
+ * @internal
+ */
+export declare function fetchClientIdFromEdgeProxy(edgeUrl: string, contextId: string, timeout?: number): Promise<VisitorIds>;
+//# sourceMappingURL=fetch-client-id-from-edge-proxy.d.ts.map

package/types/src/client-id/fetch-client-id-from-edge-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-client-id-from-edge-proxy.d.ts","sourceRoot":"","sources":["../../../src/client-id/fetch-client-id-from-edge-proxy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,eAAe,CAAC;AAM5D;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CA+BrB"}