@sitecore-cloudsdk/core 0.2.4 → 0.3.1-rc.0

package/dist/cjs/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@sitecore-cloudsdk/core",
-    "version": "0.2.4",
+    "version": "0.3.1-rc.0",
     "license": "Apache-2.0",
     "main": "dist/cjs/src/index.js",
     "module": "dist/esm/src/index.js",
@@ -16,7 +16,7 @@
         }
     },
     "dependencies": {
-        "@sitecore-cloudsdk/utils": "^0.2.4",
+        "@sitecore-cloudsdk/utils": "^0.3.0",
         "debug": "^4.3.4"
     },
     "scripts": {
@@ -29,8 +29,7 @@
         "README.md"
     ],
     "engines": {
-        "node": ">=18",
-        "npm": ">=9"
+        "node": ">=18"
     },
     "devDependencies": {
         "@types/debug": "^4.1.12"

package/dist/cjs/src/index.d.ts

@@ -1,5 +1,5 @@
-export { createCookie } from './lib/cookie/create-cookie';
-export { getBrowserIdFromMiddlewareRequest } from './lib/cookie/get-browser-id-from-middleware-request';
+export { createCookies } from './lib/cookie/create-cookies';
+export { getCookieValueFromMiddlewareRequest } from './lib/cookie/get-cookie-value-from-middleware-request';
 export { getDefaultCookieAttributes } from './lib/cookie/get-default-cookie-attributes';
 export { handleHttpCookie } from './lib/cookie/handle-http-cookie';
 export { handleNextJsMiddlewareCookie } from './lib/cookie/handle-next-js-middleware-cookie';
@@ -12,9 +12,10 @@ export { getSettings, initCore } from './lib/init/init-core';
 export { getSettingsServer, initCoreServer } from './lib/init/init-core-server';
 export { validateSettings } from './lib/settings/validate-settings';
 export { language, pageName } from './lib/infer/infer';
-export { getBrowserIdFromRequest } from './lib/cookie/get-browser-id-from-request';
+export { getCookieValueFromRequest } from './lib/cookie/get-cookie-value-from-request';
 export { handleGetSettingsError } from './lib/settings/handle-get-settings-error';
-export { API_VERSION, COOKIE_NAME_PREFIX, DAILY_SECONDS, DEFAULT_COOKIE_EXPIRY_DAYS, LIBRARY_VERSION, SITECORE_EDGE_URL, } from './lib/consts';
-export type { EPResponse, Infer } from './lib/interfaces';
-export type { CookieSettings, Settings, SettingsParamsBrowser, SettingsParamsServer } from './lib/settings/interfaces';
-export { debug } from './lib/debug/debug';
+export { generateCorrelationId } from './lib/correlation-id/generate-correlation-id';
+export { debug, processDebugResponse } from './lib/debug/debug';
+export { API_VERSION, COOKIE_NAME_PREFIX, DAILY_SECONDS, DEFAULT_COOKIE_EXPIRY_DAYS, LIBRARY_VERSION, SITECORE_EDGE_URL, CORRELATION_ID_HEADER } from './lib/consts';
+export type { EPResponse, Infer, DebugResponse } from './lib/interfaces';
+export type { CookieSettings, Settings, BrowserSettings, ServerSettings, BasicSettings } from './lib/settings/interfaces';

package/dist/cjs/src/index.js

@@ -1,11 +1,11 @@
 "use strict";
-// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.debug = exports.SITECORE_EDGE_URL = exports.LIBRARY_VERSION = exports.DEFAULT_COOKIE_EXPIRY_DAYS = exports.DAILY_SECONDS = exports.COOKIE_NAME_PREFIX = exports.API_VERSION = exports.handleGetSettingsError = exports.getBrowserIdFromRequest = exports.pageName = exports.language = exports.validateSettings = exports.initCoreServer = exports.getSettingsServer = exports.initCore = exports.getSettings = exports.createSettings = exports.getGuestId = exports.fetchBrowserIdFromEdgeProxy = exports.getBrowserId = exports.handleServerCookie = exports.handleNextJsMiddlewareCookie = exports.handleHttpCookie = exports.getDefaultCookieAttributes = exports.getBrowserIdFromMiddlewareRequest = exports.createCookie = void 0;
-var create_cookie_1 = require("./lib/cookie/create-cookie");
-Object.defineProperty(exports, "createCookie", { enumerable: true, get: function () { return create_cookie_1.createCookie; } });
-var get_browser_id_from_middleware_request_1 = require("./lib/cookie/get-browser-id-from-middleware-request");
-Object.defineProperty(exports, "getBrowserIdFromMiddlewareRequest", { enumerable: true, get: function () { return get_browser_id_from_middleware_request_1.getBrowserIdFromMiddlewareRequest; } });
+exports.CORRELATION_ID_HEADER = exports.SITECORE_EDGE_URL = exports.LIBRARY_VERSION = exports.DEFAULT_COOKIE_EXPIRY_DAYS = exports.DAILY_SECONDS = exports.COOKIE_NAME_PREFIX = exports.API_VERSION = exports.processDebugResponse = exports.debug = exports.generateCorrelationId = exports.handleGetSettingsError = exports.getCookieValueFromRequest = exports.pageName = exports.language = exports.validateSettings = exports.initCoreServer = exports.getSettingsServer = exports.initCore = exports.getSettings = exports.createSettings = exports.getGuestId = exports.fetchBrowserIdFromEdgeProxy = exports.getBrowserId = exports.handleServerCookie = exports.handleNextJsMiddlewareCookie = exports.handleHttpCookie = exports.getDefaultCookieAttributes = exports.getCookieValueFromMiddlewareRequest = exports.createCookies = void 0;
+// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+var create_cookies_1 = require("./lib/cookie/create-cookies");
+Object.defineProperty(exports, "createCookies", { enumerable: true, get: function () { return create_cookies_1.createCookies; } });
+var get_cookie_value_from_middleware_request_1 = require("./lib/cookie/get-cookie-value-from-middleware-request");
+Object.defineProperty(exports, "getCookieValueFromMiddlewareRequest", { enumerable: true, get: function () { return get_cookie_value_from_middleware_request_1.getCookieValueFromMiddlewareRequest; } });
 var get_default_cookie_attributes_1 = require("./lib/cookie/get-default-cookie-attributes");
 Object.defineProperty(exports, "getDefaultCookieAttributes", { enumerable: true, get: function () { return get_default_cookie_attributes_1.getDefaultCookieAttributes; } });
 var handle_http_cookie_1 = require("./lib/cookie/handle-http-cookie");
@@ -33,10 +33,15 @@ Object.defineProperty(exports, "validateSettings", { enumerable: true, get: func
 var infer_1 = require("./lib/infer/infer");
 Object.defineProperty(exports, "language", { enumerable: true, get: function () { return infer_1.language; } });
 Object.defineProperty(exports, "pageName", { enumerable: true, get: function () { return infer_1.pageName; } });
-var get_browser_id_from_request_1 = require("./lib/cookie/get-browser-id-from-request");
-Object.defineProperty(exports, "getBrowserIdFromRequest", { enumerable: true, get: function () { return get_browser_id_from_request_1.getBrowserIdFromRequest; } });
+var get_cookie_value_from_request_1 = require("./lib/cookie/get-cookie-value-from-request");
+Object.defineProperty(exports, "getCookieValueFromRequest", { enumerable: true, get: function () { return get_cookie_value_from_request_1.getCookieValueFromRequest; } });
 var handle_get_settings_error_1 = require("./lib/settings/handle-get-settings-error");
 Object.defineProperty(exports, "handleGetSettingsError", { enumerable: true, get: function () { return handle_get_settings_error_1.handleGetSettingsError; } });
+var generate_correlation_id_1 = require("./lib/correlation-id/generate-correlation-id");
+Object.defineProperty(exports, "generateCorrelationId", { enumerable: true, get: function () { return generate_correlation_id_1.generateCorrelationId; } });
+var debug_1 = require("./lib/debug/debug");
+Object.defineProperty(exports, "debug", { enumerable: true, get: function () { return debug_1.debug; } });
+Object.defineProperty(exports, "processDebugResponse", { enumerable: true, get: function () { return debug_1.processDebugResponse; } });
 var consts_1 = require("./lib/consts");
 Object.defineProperty(exports, "API_VERSION", { enumerable: true, get: function () { return consts_1.API_VERSION; } });
 Object.defineProperty(exports, "COOKIE_NAME_PREFIX", { enumerable: true, get: function () { return consts_1.COOKIE_NAME_PREFIX; } });
@@ -44,5 +49,4 @@ Object.defineProperty(exports, "DAILY_SECONDS", { enumerable: true, get: functio
 Object.defineProperty(exports, "DEFAULT_COOKIE_EXPIRY_DAYS", { enumerable: true, get: function () { return consts_1.DEFAULT_COOKIE_EXPIRY_DAYS; } });
 Object.defineProperty(exports, "LIBRARY_VERSION", { enumerable: true, get: function () { return consts_1.LIBRARY_VERSION; } });
 Object.defineProperty(exports, "SITECORE_EDGE_URL", { enumerable: true, get: function () { return consts_1.SITECORE_EDGE_URL; } });
-var debug_1 = require("./lib/debug/debug");
-Object.defineProperty(exports, "debug", { enumerable: true, get: function () { return debug_1.debug; } });
+Object.defineProperty(exports, "CORRELATION_ID_HEADER", { enumerable: true, get: function () { return consts_1.CORRELATION_ID_HEADER; } });

package/dist/cjs/src/lib/consts.d.ts

@@ -4,3 +4,12 @@ export declare const DEFAULT_COOKIE_EXPIRY_DAYS = 730;
 export declare const DAILY_SECONDS = 86400;
 export declare const API_VERSION = "v1.2";
 export declare const SITECORE_EDGE_URL = "https://edge-platform.sitecorecloud.io";
+export declare const CORRELATION_ID_HEADER = "x-sc-correlation-id";
+export declare enum ErrorMessages {
+    IE_0003 = "[IE-0003] Unable to set the \"sc_{SitecoreEdgeContextId}\" cookie because the browser ID could not be retrieved from the server. Make sure to set the correct values for \"sitecoreEdgeContextId\" and \"siteName\". If the issue persists, try again later or use try-catch blocks to handle this error.",
+    IE_0008 = "[IE-0008] You must first initialize the \"core\" package. Run the \"init\" function.",
+    IE_0011 = "[IE-0011] Unable to set the \"sc_{SitecoreEdgeContextId}_personalize\" cookie because the guest ID could not be retrieved from the server. Make sure to set the correct values for \"sitecoreEdgeContextId\" and \"siteName\". If the issue persists, try again later or use try-catch blocks to handle this error.",
+    IV_0001 = "[IV-0001] Incorrect value for \"sitecoreEdgeUrl\". Set the value to a valid URL string.",
+    MV_0001 = "[MV-0001] \"sitecoreEdgeContextId\" is required.",
+    MV_0002 = "[MV-0002] \"siteName\" is required."
+}

package/dist/cjs/src/lib/consts.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SITECORE_EDGE_URL = exports.API_VERSION = exports.DAILY_SECONDS = exports.DEFAULT_COOKIE_EXPIRY_DAYS = exports.COOKIE_NAME_PREFIX = exports.LIBRARY_VERSION = void 0;
+exports.ErrorMessages = exports.CORRELATION_ID_HEADER = exports.SITECORE_EDGE_URL = exports.API_VERSION = exports.DAILY_SECONDS = exports.DEFAULT_COOKIE_EXPIRY_DAYS = exports.COOKIE_NAME_PREFIX = exports.LIBRARY_VERSION = void 0;
 /* eslint-disable @typescript-eslint/naming-convention */
 const package_json_1 = __importDefault(require("../../package.json"));
 exports.LIBRARY_VERSION = package_json_1.default.version;
@@ -13,3 +13,15 @@ exports.DEFAULT_COOKIE_EXPIRY_DAYS = 730;
 exports.DAILY_SECONDS = 86400;
 exports.API_VERSION = 'v1.2';
 exports.SITECORE_EDGE_URL = 'https://edge-platform.sitecorecloud.io';
+exports.CORRELATION_ID_HEADER = 'x-sc-correlation-id';
+/* eslint-disable max-len */
+var ErrorMessages;
+(function (ErrorMessages) {
+    ErrorMessages["IE_0003"] = "[IE-0003] Unable to set the \"sc_{SitecoreEdgeContextId}\" cookie because the browser ID could not be retrieved from the server. Make sure to set the correct values for \"sitecoreEdgeContextId\" and \"siteName\". If the issue persists, try again later or use try-catch blocks to handle this error.";
+    ErrorMessages["IE_0008"] = "[IE-0008] You must first initialize the \"core\" package. Run the \"init\" function.";
+    ErrorMessages["IE_0011"] = "[IE-0011] Unable to set the \"sc_{SitecoreEdgeContextId}_personalize\" cookie because the guest ID could not be retrieved from the server. Make sure to set the correct values for \"sitecoreEdgeContextId\" and \"siteName\". If the issue persists, try again later or use try-catch blocks to handle this error.";
+    ErrorMessages["IV_0001"] = "[IV-0001] Incorrect value for \"sitecoreEdgeUrl\". Set the value to a valid URL string.";
+    ErrorMessages["MV_0001"] = "[MV-0001] \"sitecoreEdgeContextId\" is required.";
+    ErrorMessages["MV_0002"] = "[MV-0002] \"siteName\" is required.";
+})(ErrorMessages || (exports.ErrorMessages = ErrorMessages = {}));
+/* eslint-enable max-len */

package/dist/cjs/src/lib/cookie/create-cookies.d.ts

@@ -0,0 +1,6 @@
+import type { Settings } from '../settings/interfaces';
+/**
+ * Creates and adds the cookie to the document
+ * @param settings - The CookieSettings settings object
+ */
+export declare function createCookies(settings: Settings): Promise<void>;

package/dist/cjs/src/lib/cookie/create-cookies.js

@@ -0,0 +1,28 @@
+"use strict";
+// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCookies = void 0;
+const utils_1 = require("@sitecore-cloudsdk/utils");
+const fetch_browser_id_from_edge_proxy_1 = require("../init/fetch-browser-id-from-edge-proxy");
+const get_default_cookie_attributes_1 = require("./get-default-cookie-attributes");
+const get_guest_id_1 = require("../init/get-guest-id");
+/**
+ * Creates and adds the cookie to the document
+ * @param settings - The CookieSettings settings object
+ */
+async function createCookies(settings) {
+    const attributes = (0, get_default_cookie_attributes_1.getDefaultCookieAttributes)(settings.cookieSettings.cookieExpiryDays, settings.cookieSettings.cookieDomain);
+    const browserIdCookie = (0, utils_1.getCookie)(window.document.cookie, settings.cookieSettings.cookieNames.browserId);
+    if (browserIdCookie) {
+        const guestIdCookie = (0, utils_1.getCookie)(window.document.cookie, settings.cookieSettings.cookieNames.guestId);
+        if (guestIdCookie)
+            return;
+        const guestId = await (0, get_guest_id_1.getGuestId)(browserIdCookie.value, settings.sitecoreEdgeContextId, settings.sitecoreEdgeUrl);
+        document.cookie = (0, utils_1.createCookieString)(settings.cookieSettings.cookieNames.guestId, guestId, attributes);
+        return;
+    }
+    const { browserId, guestId } = await (0, fetch_browser_id_from_edge_proxy_1.fetchBrowserIdFromEdgeProxy)(settings.sitecoreEdgeUrl, settings.sitecoreEdgeContextId);
+    document.cookie = (0, utils_1.createCookieString)(settings.cookieSettings.cookieNames.browserId, browserId, attributes);
+    document.cookie = (0, utils_1.createCookieString)(settings.cookieSettings.cookieNames.guestId, guestId, attributes);
+}
+exports.createCookies = createCookies;

package/dist/cjs/src/lib/cookie/get-browser-id.js

@@ -10,6 +10,6 @@ const init_core_1 = require("../init/init-core");
  */
 function getBrowserId() {
     const settings = (0, init_core_1.getSettings)();
-    return (0, utils_1.getCookieValueClientSide)(settings.cookieSettings.cookieName);
+    return (0, utils_1.getCookieValueClientSide)(settings.cookieSettings.cookieNames.browserId);
 }
 exports.getBrowserId = getBrowserId;

package/dist/cjs/src/lib/cookie/get-cookie-value-from-middleware-request.d.ts

@@ -0,0 +1,11 @@
+import type { MiddlewareRequest } from '@sitecore-cloudsdk/utils';
+/**
+ * Extracts the cookie value from the provided Middleware Request by reading the
+ * given `cookieName` The function first checks for Next.js v12 cookie values,
+ * and if not found, it checks for Next.js v13 cookie values.
+ *
+ * @param request - The Middleware Request object.
+ * @param cookieName - The name of the cookie to retrieve.
+ * @returns The cookie value extracted from the cookie, or undefined if not found.
+ */
+export declare function getCookieValueFromMiddlewareRequest(request: MiddlewareRequest, cookieName: string): string | undefined;

package/dist/cjs/src/lib/cookie/{get-browser-id-from-middleware-request.js → get-cookie-value-from-middleware-request.js}

@@ -1,17 +1,17 @@
 "use strict";
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBrowserIdFromMiddlewareRequest = void 0;
+exports.getCookieValueFromMiddlewareRequest = void 0;
 /**
- * Retrieves the browser ID from the provided Middleware Request by extracting the cookie value
- * associated with the specified 'cookieName'. The function first checks for Next.js v12 cookie values,
+ * Extracts the cookie value from the provided Middleware Request by reading the
+ * given `cookieName` The function first checks for Next.js v12 cookie values,
  * and if not found, it checks for Next.js v13 cookie values.
  *
  * @param request - The Middleware Request object.
  * @param cookieName - The name of the cookie to retrieve.
- * @returns The browser ID extracted from the cookie, or undefined if not found.
+ * @returns The cookie value extracted from the cookie, or undefined if not found.
  */
-function getBrowserIdFromMiddlewareRequest(request, cookieName) {
+function getCookieValueFromMiddlewareRequest(request, cookieName) {
     const cookieValueFromRequest = request.cookies.get(cookieName);
     // It checks nextjs v12 cookie values
     if (typeof cookieValueFromRequest === 'string')
@@ -21,4 +21,4 @@ function getBrowserIdFromMiddlewareRequest(request, cookieName) {
         return cookieValueFromRequest.value;
     return undefined;
 }
-exports.getBrowserIdFromMiddlewareRequest = getBrowserIdFromMiddlewareRequest;
+exports.getCookieValueFromMiddlewareRequest = getCookieValueFromMiddlewareRequest;

package/dist/cjs/src/lib/cookie/get-cookie-value-from-request.d.ts

@@ -0,0 +1,9 @@
+import type { Request } from '@sitecore-cloudsdk/utils';
+/**
+ * Retrieves the cookie value from the provided request object ('T'), using the specified 'cookieName'.
+ *
+ * @param request - The request object, either a Middleware Request or an HTTP Request.
+ * @param cookieName - The name of the cookie to retrieve the cookie value from.
+ * @returns The cookie value extracted from the cookie or an empty string if not found.
+ */
+export declare function getCookieValueFromRequest<T extends Request>(request: T, cookieName: string): string;

package/dist/cjs/src/lib/cookie/get-cookie-value-from-request.js

@@ -0,0 +1,24 @@
+"use strict";
+// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCookieValueFromRequest = void 0;
+const utils_1 = require("@sitecore-cloudsdk/utils");
+const get_cookie_value_from_middleware_request_1 = require("./get-cookie-value-from-middleware-request");
+/**
+ * Retrieves the cookie value from the provided request object ('T'), using the specified 'cookieName'.
+ *
+ * @param request - The request object, either a Middleware Request or an HTTP Request.
+ * @param cookieName - The name of the cookie to retrieve the cookie value from.
+ * @returns The cookie value extracted from the cookie or an empty string if not found.
+ */
+function getCookieValueFromRequest(request, cookieName) {
+    let cookieValue = undefined;
+    if ((0, utils_1.isNextJsMiddlewareRequest)(request))
+        cookieValue = (0, get_cookie_value_from_middleware_request_1.getCookieValueFromMiddlewareRequest)(request, cookieName);
+    else if ((0, utils_1.isHttpRequest)(request)) {
+        const cookieHeader = request.headers.cookie;
+        cookieValue = (0, utils_1.getCookieServerSide)(cookieHeader, cookieName)?.value;
+    }
+    return cookieValue ?? '';
+}
+exports.getCookieValueFromRequest = getCookieValueFromRequest;

package/dist/cjs/src/lib/cookie/get-default-cookie-attributes.d.ts

@@ -1,7 +1,7 @@
+import type { CookieProperties } from '@sitecore-cloudsdk/utils';
 /**
  * Gets the default Cookie Attributes
  * @param  maxAge - Set the cookie "Max-Age" attribute in days.
  * @returns the default configuration settings for the cookie string
  */
-import { CookieProperties } from '@sitecore-cloudsdk/utils';
 export declare function getDefaultCookieAttributes(maxAge?: number, cookieDomain?: string): CookieProperties;

package/dist/cjs/src/lib/cookie/get-default-cookie-attributes.js

@@ -1,21 +1,20 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultCookieAttributes = void 0;
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+const consts_1 = require("../consts");
 /**
  * Gets the default Cookie Attributes
  * @param  maxAge - Set the cookie "Max-Age" attribute in days.
  * @returns the default configuration settings for the cookie string
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDefaultCookieAttributes = void 0;
-const consts_1 = require("../consts");
-// eslint-disable-next-line max-len
 function getDefaultCookieAttributes(maxAge = consts_1.DEFAULT_COOKIE_EXPIRY_DAYS, cookieDomain) {
     return {
         domain: cookieDomain,
         maxAge: maxAge * consts_1.DAILY_SECONDS,
         path: '/',
         sameSite: 'None',
-        secure: true,
+        secure: true
     };
 }
 exports.getDefaultCookieAttributes = getDefaultCookieAttributes;

package/dist/cjs/src/lib/cookie/handle-http-cookie.d.ts

@@ -1,5 +1,5 @@
 import type { HttpRequest, HttpResponse } from '@sitecore-cloudsdk/utils';
-import { Settings } from '../settings/interfaces';
+import type { Settings } from '../settings/interfaces';
 /**
  * Handles HTTP Cookie operations for setting the browser ID cookie in the request and response.
  *

package/dist/cjs/src/lib/cookie/handle-http-cookie.js

@@ -2,9 +2,10 @@
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleHttpCookie = void 0;
-const get_default_cookie_attributes_1 = require("./get-default-cookie-attributes");
 const utils_1 = require("@sitecore-cloudsdk/utils");
 const fetch_browser_id_from_edge_proxy_1 = require("../init/fetch-browser-id-from-edge-proxy");
+const get_default_cookie_attributes_1 = require("./get-default-cookie-attributes");
+const get_guest_id_1 = require("../init/get-guest-id");
 /**
  * Handles HTTP Cookie operations for setting the browser ID cookie in the request and response.
  *
@@ -17,22 +18,34 @@ const fetch_browser_id_from_edge_proxy_1 = require("../init/fetch-browser-id-fro
  * @throws [IE-0003] - This exception is thrown in the case getBrowserIdFromEP wasn't able to retrieve a browser id.
  */
 async function handleHttpCookie(request, response, options, timeout) {
-    const { cookieName } = options.cookieSettings;
-    const cookieValueFromRequest = request.headers.cookie;
-    let cookie;
-    let cookieValue;
-    if (cookieValueFromRequest) {
-        cookie = (0, utils_1.getCookieServerSide)(cookieValueFromRequest, cookieName);
-        if (cookie)
-            cookieValue = cookie.value;
-    }
-    if (!cookieValue)
-        cookieValue = (await (0, fetch_browser_id_from_edge_proxy_1.fetchBrowserIdFromEdgeProxy)(options.sitecoreEdgeUrl, options.sitecoreEdgeContextId, timeout))
-            .browserId;
+    const { browserId, guestId } = options.cookieSettings.cookieNames;
+    const browserIdCookie = (0, utils_1.getCookieServerSide)(request.headers.cookie, browserId);
+    let browserIdCookieValue;
+    const guestIdCookie = (0, utils_1.getCookieServerSide)(request.headers.cookie, guestId);
+    let guestIdCookieValue;
     const defaultCookieAttributes = (0, get_default_cookie_attributes_1.getDefaultCookieAttributes)(options.cookieSettings.cookieExpiryDays, options.cookieSettings.cookieDomain);
-    const cookieString = (0, utils_1.createCookieString)(cookieName, cookieValue, defaultCookieAttributes);
-    if (!cookie)
-        request.headers.cookie = cookieValueFromRequest ? cookieValueFromRequest + '; ' + cookieString : cookieString;
-    response.setHeader('Set-Cookie', cookieString);
+    if (!browserIdCookie) {
+        const cookieValues = await (0, fetch_browser_id_from_edge_proxy_1.fetchBrowserIdFromEdgeProxy)(options.sitecoreEdgeUrl, options.sitecoreEdgeContextId, timeout);
+        browserIdCookieValue = cookieValues.browserId;
+        guestIdCookieValue = cookieValues.guestId;
+    }
+    else {
+        browserIdCookieValue = browserIdCookie.value;
+        if (!guestIdCookie)
+            guestIdCookieValue = await (0, get_guest_id_1.getGuestId)(browserIdCookie.value, options.sitecoreEdgeContextId, options.sitecoreEdgeUrl);
+        else
+            guestIdCookieValue = guestIdCookie.value;
+    }
+    const browserIdCookieString = (0, utils_1.createCookieString)(browserId, browserIdCookieValue, defaultCookieAttributes);
+    const guestIdCookieString = (0, utils_1.createCookieString)(guestId, guestIdCookieValue, defaultCookieAttributes);
+    if (!browserIdCookie)
+        request.headers.cookie = request.headers.cookie
+            ? request.headers.cookie + '; ' + browserIdCookieString
+            : browserIdCookieString;
+    if (!guestIdCookie)
+        request.headers.cookie = request.headers.cookie
+            ? request.headers.cookie + '; ' + guestIdCookieString
+            : guestIdCookieString;
+    response.setHeader('Set-Cookie', [browserIdCookieString, guestIdCookieString]);
 }
 exports.handleHttpCookie = handleHttpCookie;

package/dist/cjs/src/lib/cookie/handle-next-js-middleware-cookie.d.ts

@@ -1,5 +1,5 @@
-import { MiddlewareNextResponse, MiddlewareRequest } from '@sitecore-cloudsdk/utils';
-import { Settings } from '../settings/interfaces';
+import type { MiddlewareNextResponse, MiddlewareRequest } from '@sitecore-cloudsdk/utils';
+import type { Settings } from '../settings/interfaces';
 /**
  * Handles the Middleware Request and sets a cookie with the provided 'cookieName' and 'cookieValue'.
  * If 'cookieValue' is not present in the request, it fetches it using the 'fetchBrowserIdFromEdgeProxy' function
@@ -10,7 +10,7 @@ import { Settings } from '../settings/interfaces';
  * @param options - The settings object containing configuration options.
  * @param defaultCookieAttributes - The default attributes for the cookie.
  *
- * @throws [IE-0003] - This exception is thrown in the case fetchBrowserIdFromEdgeProxy wasn't able to retrieve a browserId.
+ * @throws [IE-0003] - This exception is thrown when fetchBrowserIdFromEdgeProxy wasn't able to retrieve a browserId.
  *
  */
 export declare function handleNextJsMiddlewareCookie(request: MiddlewareRequest, response: MiddlewareNextResponse, options: Settings, timeout?: number): Promise<void>;

package/dist/cjs/src/lib/cookie/handle-next-js-middleware-cookie.js

@@ -2,9 +2,10 @@
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleNextJsMiddlewareCookie = void 0;
-const get_browser_id_from_middleware_request_1 = require("./get-browser-id-from-middleware-request");
-const get_default_cookie_attributes_1 = require("./get-default-cookie-attributes");
 const fetch_browser_id_from_edge_proxy_1 = require("../init/fetch-browser-id-from-edge-proxy");
+const get_cookie_value_from_middleware_request_1 = require("./get-cookie-value-from-middleware-request");
+const get_default_cookie_attributes_1 = require("./get-default-cookie-attributes");
+const get_guest_id_1 = require("../init/get-guest-id");
 /**
  * Handles the Middleware Request and sets a cookie with the provided 'cookieName' and 'cookieValue'.
  * If 'cookieValue' is not present in the request, it fetches it using the 'fetchBrowserIdFromEdgeProxy' function
@@ -15,17 +16,24 @@ const fetch_browser_id_from_edge_proxy_1 = require("../init/fetch-browser-id-fro
  * @param options - The settings object containing configuration options.
  * @param defaultCookieAttributes - The default attributes for the cookie.
  *
- * @throws [IE-0003] - This exception is thrown in the case fetchBrowserIdFromEdgeProxy wasn't able to retrieve a browserId.
+ * @throws [IE-0003] - This exception is thrown when fetchBrowserIdFromEdgeProxy wasn't able to retrieve a browserId.
  *
  */
 async function handleNextJsMiddlewareCookie(request, response, options, timeout) {
-    const { cookieName } = options.cookieSettings;
-    let cookieValue = (0, get_browser_id_from_middleware_request_1.getBrowserIdFromMiddlewareRequest)(request, cookieName);
-    if (!cookieValue)
-        cookieValue = (await (0, fetch_browser_id_from_edge_proxy_1.fetchBrowserIdFromEdgeProxy)(options.sitecoreEdgeUrl, options.sitecoreEdgeContextId, timeout))
-            .browserId;
+    const { browserId, guestId } = options.cookieSettings.cookieNames;
+    let browserIdCookieValue = (0, get_cookie_value_from_middleware_request_1.getCookieValueFromMiddlewareRequest)(request, browserId);
+    let guestIdCookieValue = (0, get_cookie_value_from_middleware_request_1.getCookieValueFromMiddlewareRequest)(request, guestId);
+    if (!browserIdCookieValue) {
+        const cookieValues = await (0, fetch_browser_id_from_edge_proxy_1.fetchBrowserIdFromEdgeProxy)(options.sitecoreEdgeUrl, options.sitecoreEdgeContextId, timeout);
+        browserIdCookieValue = cookieValues.browserId;
+        guestIdCookieValue = cookieValues.guestId;
+    }
+    else if (!guestIdCookieValue)
+        guestIdCookieValue = await (0, get_guest_id_1.getGuestId)(browserIdCookieValue, options.sitecoreEdgeContextId, options.sitecoreEdgeUrl);
     const defaultCookieAttributes = (0, get_default_cookie_attributes_1.getDefaultCookieAttributes)(options.cookieSettings.cookieExpiryDays, options.cookieSettings.cookieDomain);
-    request.cookies.set(cookieName, cookieValue, defaultCookieAttributes);
-    response.cookies.set(cookieName, cookieValue, defaultCookieAttributes);
+    request.cookies.set(browserId, browserIdCookieValue, defaultCookieAttributes);
+    request.cookies.set(guestId, guestIdCookieValue, defaultCookieAttributes);
+    response.cookies.set(browserId, browserIdCookieValue, defaultCookieAttributes);
+    response.cookies.set(guestId, guestIdCookieValue, defaultCookieAttributes);
 }
 exports.handleNextJsMiddlewareCookie = handleNextJsMiddlewareCookie;

package/dist/cjs/src/lib/cookie/handle-server-cookie.d.ts

@@ -1,4 +1,4 @@
-import { type Request, type MiddlewareNextResponse, type HttpResponse } from '@sitecore-cloudsdk/utils';
+import { type HttpResponse, type MiddlewareNextResponse, type Request } from '@sitecore-cloudsdk/utils';
 /**
  * Handles server-side cookie operations based on the provided 'request' and 'response' objects.
  *

package/dist/cjs/src/lib/cookie/handle-server-cookie.js

@@ -4,8 +4,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleServerCookie = void 0;
 const utils_1 = require("@sitecore-cloudsdk/utils");
 const init_core_server_1 = require("../init/init-core-server");
-const handle_next_js_middleware_cookie_1 = require("./handle-next-js-middleware-cookie");
 const handle_http_cookie_1 = require("./handle-http-cookie");
+const handle_next_js_middleware_cookie_1 = require("./handle-next-js-middleware-cookie");
 /**
  * Handles server-side cookie operations based on the provided 'request' and 'response' objects.
  *
@@ -16,11 +16,9 @@ const handle_http_cookie_1 = require("./handle-http-cookie");
  */
 async function handleServerCookie(request, response, timeout) {
     const settings = (0, init_core_server_1.getSettingsServer)();
-    if ((0, utils_1.isNextJsMiddlewareRequest)(request) && (0, utils_1.isNextJsMiddlewareResponse)(response)) {
+    if ((0, utils_1.isNextJsMiddlewareRequest)(request) && (0, utils_1.isNextJsMiddlewareResponse)(response))
         await (0, handle_next_js_middleware_cookie_1.handleNextJsMiddlewareCookie)(request, response, settings, timeout);
-    }
-    else if ((0, utils_1.isHttpRequest)(request) && (0, utils_1.isHttpResponse)(response)) {
+    else if ((0, utils_1.isHttpRequest)(request) && (0, utils_1.isHttpResponse)(response))
         await (0, handle_http_cookie_1.handleHttpCookie)(request, response, settings, timeout);
-    }
 }
 exports.handleServerCookie = handleServerCookie;

package/dist/cjs/src/lib/correlation-id/generate-correlation-id.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A function that generates a correlation id
+ *
+ * @returns A correlation id string
+ */
+export declare function generateCorrelationId(): string;

package/dist/cjs/src/lib/correlation-id/generate-correlation-id.js

@@ -0,0 +1,14 @@
+"use strict";
+// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCorrelationId = void 0;
+const utils_1 = require("@sitecore-cloudsdk/utils");
+/**
+ * A function that generates a correlation id
+ *
+ * @returns A correlation id string
+ */
+function generateCorrelationId() {
+    return (0, utils_1.generateV4UUID)().replace(/-/g, '');
+}
+exports.generateCorrelationId = generateCorrelationId;

package/dist/cjs/src/lib/debug/debug.d.ts

@@ -1,2 +1,8 @@
 import debug from 'debug';
 export { debug };
+/**
+ * Extracts debug information from an HTTP response if debugging is enabled.
+ * @param response - The HTTP response object from fetch.
+ * @returns An object containing selected response details for debugging purposes.
+ */
+export declare function processDebugResponse(namespace: string, response: Response): object;

package/dist/cjs/src/lib/debug/debug.js

@@ -3,14 +3,31 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.debug = void 0;
-// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+exports.processDebugResponse = exports.debug = void 0;
 const debug_1 = __importDefault(require("debug"));
 exports.debug = debug_1.default;
+const utils_1 = require("@sitecore-cloudsdk/utils");
 if (process.env &&
     process.env.DEBUG_MULTILINE === 'true' &&
     debug_1.default.formatters &&
     debug_1.default.formatters.o &&
-    debug_1.default.formatters.O) {
+    debug_1.default.formatters.O)
     debug_1.default.formatters.o = debug_1.default.formatters.O;
+/**
+ * Extracts debug information from an HTTP response if debugging is enabled.
+ * @param response - The HTTP response object from fetch.
+ * @returns An object containing selected response details for debugging purposes.
+ */
+function processDebugResponse(namespace, response) {
+    let debugResponse = {};
+    if (debug_1.default.enabled(namespace))
+        debugResponse = {
+            headers: (0, utils_1.normalizeHeaders)(response.headers),
+            redirected: response.redirected,
+            status: response.status,
+            statusText: response.statusText,
+            url: response.url
+        };
+    return debugResponse;
 }
+exports.processDebugResponse = processDebugResponse;

package/dist/cjs/src/lib/init/construct-get-browser-id-url.js

@@ -10,6 +10,7 @@ const consts_1 = require("../consts");
  * @returns The URL string for retrieving the browser ID and ClientKey
  */
 function constructGetBrowserIdUrl(sitecoreEdgeUrl, sitecoreEdgeContextId) {
+    // eslint-disable-next-line max-len
     return `${sitecoreEdgeUrl}/v1/events/${consts_1.API_VERSION}/browser/create.json?sitecoreContextId=${sitecoreEdgeContextId}&client_key=`;
 }
 exports.constructGetBrowserIdUrl = constructGetBrowserIdUrl;

package/dist/cjs/src/lib/init/fetch-browser-id-from-edge-proxy.d.ts

@@ -1,4 +1,4 @@
-import { ProxySettings } from '../interfaces';
+import type { ProxySettings } from '../interfaces';
 /**
  * Gets the browser ID and Client Key from Sitecore Edge Proxy
  * @param sitecoreEdgeUrl - The baseURL for the Edge Proxy API.

package/dist/cjs/src/lib/init/fetch-browser-id-from-edge-proxy.js

@@ -2,8 +2,8 @@
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchBrowserIdFromEdgeProxy = void 0;
-const utils_1 = require("@sitecore-cloudsdk/utils");
 const consts_1 = require("../consts");
+const utils_1 = require("@sitecore-cloudsdk/utils");
 const construct_get_browser_id_url_1 = require("./construct-get-browser-id-url");
 /**
  * Gets the browser ID and Client Key from Sitecore Edge Proxy
@@ -15,30 +15,27 @@ const construct_get_browser_id_url_1 = require("./construct-get-browser-id-url")
 async function fetchBrowserIdFromEdgeProxy(sitecoreEdgeUrl, sitecoreEdgeContextId, timeout) {
     const fetchOptions = {
         // eslint-disable-next-line @typescript-eslint/naming-convention
-        headers: { 'X-Library-Version': consts_1.LIBRARY_VERSION },
+        headers: { 'X-Library-Version': consts_1.LIBRARY_VERSION }
     };
     const url = (0, construct_get_browser_id_url_1.constructGetBrowserIdUrl)(sitecoreEdgeUrl, sitecoreEdgeContextId);
     let payload;
-    if (timeout !== undefined) {
+    if (timeout !== undefined)
         payload = await (0, utils_1.fetchWithTimeout)(url, timeout, fetchOptions)
             .then((response) => {
             return (response && response.json()) || null;
         })
             .catch((err) => {
-            if (err.message.includes('IV-0006') || err.message.includes('IE-0002')) {
+            if (err.message === utils_1.ErrorMessages.IV_0006 || err.message === utils_1.ErrorMessages.IE_0002)
                 throw new Error(err.message);
-            }
             return null;
         });
-    }
-    else {
+    else
         payload = await fetch(url, fetchOptions)
             .then((res) => res.json())
             .catch(() => undefined);
-    }
     if (!payload?.ref)
-        throw new Error('[IE-0003] Unable to set the cookie because the browser ID could not be retrieved from the server. Try again later, or use try-catch blocks to handle this error.');
-    const { ref: browserId } = payload;
-    return { browserId };
+        throw new Error(consts_1.ErrorMessages.IE_0003);
+    const { ref: browserId, customer_ref: guestId } = payload;
+    return { browserId, guestId };
 }
 exports.fetchBrowserIdFromEdgeProxy = fetchBrowserIdFromEdgeProxy;

package/dist/cjs/src/lib/init/get-guest-id.js

@@ -20,6 +20,8 @@ async function getGuestId(browserId, sitecoreEdgeContextId, sitecoreEdgeUrl) {
         const { error_msg: errorMsg, moreInfo } = data;
         throw new Error(`${errorMsg}, for more info: ${moreInfo}`);
     }
+    if (!data.customer.ref)
+        throw new Error(consts_1.ErrorMessages.IE_0011);
     return data.customer.ref;
 }
 exports.getGuestId = getGuestId;