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

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

@@ -7,3 +7,15 @@ export const DEFAULT_COOKIE_EXPIRY_DAYS = 730;
 export const DAILY_SECONDS = 86400;
 export const API_VERSION = 'v1.2';
 export const SITECORE_EDGE_URL = 'https://edge-platform.sitecorecloud.io';
+export const CORRELATION_ID_HEADER = 'x-sc-correlation-id';
+/* eslint-disable max-len */
+export 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 || (ErrorMessages = {}));
+/* eslint-enable max-len */

package/dist/esm/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/esm/src/lib/cookie/create-cookies.js

@@ -0,0 +1,24 @@
+// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+import { createCookieString, getCookie } from '@sitecore-cloudsdk/utils';
+import { fetchBrowserIdFromEdgeProxy } from '../init/fetch-browser-id-from-edge-proxy';
+import { getDefaultCookieAttributes } from './get-default-cookie-attributes';
+import { getGuestId } from '../init/get-guest-id';
+/**
+ * Creates and adds the cookie to the document
+ * @param settings - The CookieSettings settings object
+ */
+export async function createCookies(settings) {
+    const attributes = getDefaultCookieAttributes(settings.cookieSettings.cookieExpiryDays, settings.cookieSettings.cookieDomain);
+    const browserIdCookie = getCookie(window.document.cookie, settings.cookieSettings.cookieNames.browserId);
+    if (browserIdCookie) {
+        const guestIdCookie = getCookie(window.document.cookie, settings.cookieSettings.cookieNames.guestId);
+        if (guestIdCookie)
+            return;
+        const guestId = await getGuestId(browserIdCookie.value, settings.sitecoreEdgeContextId, settings.sitecoreEdgeUrl);
+        document.cookie = createCookieString(settings.cookieSettings.cookieNames.guestId, guestId, attributes);
+        return;
+    }
+    const { browserId, guestId } = await fetchBrowserIdFromEdgeProxy(settings.sitecoreEdgeUrl, settings.sitecoreEdgeContextId);
+    document.cookie = createCookieString(settings.cookieSettings.cookieNames.browserId, browserId, attributes);
+    document.cookie = createCookieString(settings.cookieSettings.cookieNames.guestId, guestId, attributes);
+}

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

@@ -7,5 +7,5 @@ import { getSettings } from '../init/init-core';
  */
 export function getBrowserId() {
     const settings = getSettings();
-    return getCookieValueClientSide(settings.cookieSettings.cookieName);
+    return getCookieValueClientSide(settings.cookieSettings.cookieNames.browserId);
 }

package/dist/esm/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/esm/src/lib/cookie/{get-browser-id-from-middleware-request.js → get-cookie-value-from-middleware-request.js}

@@ -1,14 +1,14 @@
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
 /**
- * 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.
  */
-export function getBrowserIdFromMiddlewareRequest(request, cookieName) {
+export function getCookieValueFromMiddlewareRequest(request, cookieName) {
     const cookieValueFromRequest = request.cookies.get(cookieName);
     // It checks nextjs v12 cookie values
     if (typeof cookieValueFromRequest === 'string')

package/dist/esm/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/esm/src/lib/cookie/get-cookie-value-from-request.js

@@ -0,0 +1,20 @@
+// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+import { getCookieServerSide, isHttpRequest, isNextJsMiddlewareRequest } from '@sitecore-cloudsdk/utils';
+import { getCookieValueFromMiddlewareRequest } from './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.
+ */
+export function getCookieValueFromRequest(request, cookieName) {
+    let cookieValue = undefined;
+    if (isNextJsMiddlewareRequest(request))
+        cookieValue = getCookieValueFromMiddlewareRequest(request, cookieName);
+    else if (isHttpRequest(request)) {
+        const cookieHeader = request.headers.cookie;
+        cookieValue = getCookieServerSide(cookieHeader, cookieName)?.value;
+    }
+    return cookieValue ?? '';
+}

package/dist/esm/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/esm/src/lib/cookie/get-default-cookie-attributes.js

@@ -1,17 +1,16 @@
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+import { DAILY_SECONDS, DEFAULT_COOKIE_EXPIRY_DAYS } from '../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
  */
-import { DAILY_SECONDS, DEFAULT_COOKIE_EXPIRY_DAYS } from '../consts';
-// eslint-disable-next-line max-len
 export function getDefaultCookieAttributes(maxAge = DEFAULT_COOKIE_EXPIRY_DAYS, cookieDomain) {
     return {
         domain: cookieDomain,
         maxAge: maxAge * DAILY_SECONDS,
         path: '/',
         sameSite: 'None',
-        secure: true,
+        secure: true
     };
 }

package/dist/esm/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/esm/src/lib/cookie/handle-http-cookie.js

@@ -1,7 +1,8 @@
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
-import { getDefaultCookieAttributes } from './get-default-cookie-attributes';
 import { createCookieString, getCookieServerSide } from '@sitecore-cloudsdk/utils';
 import { fetchBrowserIdFromEdgeProxy } from '../init/fetch-browser-id-from-edge-proxy';
+import { getDefaultCookieAttributes } from './get-default-cookie-attributes';
+import { getGuestId } from '../init/get-guest-id';
 /**
  * Handles HTTP Cookie operations for setting the browser ID cookie in the request and response.
  *
@@ -14,21 +15,33 @@ import { fetchBrowserIdFromEdgeProxy } from '../init/fetch-browser-id-from-edge-
  * @throws [IE-0003] - This exception is thrown in the case getBrowserIdFromEP wasn't able to retrieve a browser id.
  */
 export async function handleHttpCookie(request, response, options, timeout) {
-    const { cookieName } = options.cookieSettings;
-    const cookieValueFromRequest = request.headers.cookie;
-    let cookie;
-    let cookieValue;
-    if (cookieValueFromRequest) {
-        cookie = getCookieServerSide(cookieValueFromRequest, cookieName);
-        if (cookie)
-            cookieValue = cookie.value;
-    }
-    if (!cookieValue)
-        cookieValue = (await fetchBrowserIdFromEdgeProxy(options.sitecoreEdgeUrl, options.sitecoreEdgeContextId, timeout))
-            .browserId;
+    const { browserId, guestId } = options.cookieSettings.cookieNames;
+    const browserIdCookie = getCookieServerSide(request.headers.cookie, browserId);
+    let browserIdCookieValue;
+    const guestIdCookie = getCookieServerSide(request.headers.cookie, guestId);
+    let guestIdCookieValue;
     const defaultCookieAttributes = getDefaultCookieAttributes(options.cookieSettings.cookieExpiryDays, options.cookieSettings.cookieDomain);
-    const cookieString = createCookieString(cookieName, cookieValue, defaultCookieAttributes);
-    if (!cookie)
-        request.headers.cookie = cookieValueFromRequest ? cookieValueFromRequest + '; ' + cookieString : cookieString;
-    response.setHeader('Set-Cookie', cookieString);
+    if (!browserIdCookie) {
+        const cookieValues = await fetchBrowserIdFromEdgeProxy(options.sitecoreEdgeUrl, options.sitecoreEdgeContextId, timeout);
+        browserIdCookieValue = cookieValues.browserId;
+        guestIdCookieValue = cookieValues.guestId;
+    }
+    else {
+        browserIdCookieValue = browserIdCookie.value;
+        if (!guestIdCookie)
+            guestIdCookieValue = await getGuestId(browserIdCookie.value, options.sitecoreEdgeContextId, options.sitecoreEdgeUrl);
+        else
+            guestIdCookieValue = guestIdCookie.value;
+    }
+    const browserIdCookieString = createCookieString(browserId, browserIdCookieValue, defaultCookieAttributes);
+    const guestIdCookieString = 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]);
 }

package/dist/esm/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/esm/src/lib/cookie/handle-next-js-middleware-cookie.js

@@ -1,7 +1,8 @@
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
-import { getBrowserIdFromMiddlewareRequest } from './get-browser-id-from-middleware-request';
-import { getDefaultCookieAttributes } from './get-default-cookie-attributes';
 import { fetchBrowserIdFromEdgeProxy } from '../init/fetch-browser-id-from-edge-proxy';
+import { getCookieValueFromMiddlewareRequest } from './get-cookie-value-from-middleware-request';
+import { getDefaultCookieAttributes } from './get-default-cookie-attributes';
+import { getGuestId } from '../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
@@ -12,16 +13,23 @@ import { fetchBrowserIdFromEdgeProxy } from '../init/fetch-browser-id-from-edge-
  * @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 async function handleNextJsMiddlewareCookie(request, response, options, timeout) {
-    const { cookieName } = options.cookieSettings;
-    let cookieValue = getBrowserIdFromMiddlewareRequest(request, cookieName);
-    if (!cookieValue)
-        cookieValue = (await fetchBrowserIdFromEdgeProxy(options.sitecoreEdgeUrl, options.sitecoreEdgeContextId, timeout))
-            .browserId;
+    const { browserId, guestId } = options.cookieSettings.cookieNames;
+    let browserIdCookieValue = getCookieValueFromMiddlewareRequest(request, browserId);
+    let guestIdCookieValue = getCookieValueFromMiddlewareRequest(request, guestId);
+    if (!browserIdCookieValue) {
+        const cookieValues = await fetchBrowserIdFromEdgeProxy(options.sitecoreEdgeUrl, options.sitecoreEdgeContextId, timeout);
+        browserIdCookieValue = cookieValues.browserId;
+        guestIdCookieValue = cookieValues.guestId;
+    }
+    else if (!guestIdCookieValue)
+        guestIdCookieValue = await getGuestId(browserIdCookieValue, options.sitecoreEdgeContextId, options.sitecoreEdgeUrl);
     const defaultCookieAttributes = 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);
 }

package/dist/esm/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/esm/src/lib/cookie/handle-server-cookie.js

@@ -1,8 +1,8 @@
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
-import { isNextJsMiddlewareRequest, isNextJsMiddlewareResponse, isHttpRequest, isHttpResponse, } from '@sitecore-cloudsdk/utils';
+import { isHttpRequest, isHttpResponse, isNextJsMiddlewareRequest, isNextJsMiddlewareResponse } from '@sitecore-cloudsdk/utils';
 import { getSettingsServer } from '../init/init-core-server';
-import { handleNextJsMiddlewareCookie } from './handle-next-js-middleware-cookie';
 import { handleHttpCookie } from './handle-http-cookie';
+import { handleNextJsMiddlewareCookie } from './handle-next-js-middleware-cookie';
 /**
  * Handles server-side cookie operations based on the provided 'request' and 'response' objects.
  *
@@ -13,10 +13,8 @@ import { handleHttpCookie } from './handle-http-cookie';
  */
 export async function handleServerCookie(request, response, timeout) {
     const settings = getSettingsServer();
-    if (isNextJsMiddlewareRequest(request) && isNextJsMiddlewareResponse(response)) {
+    if (isNextJsMiddlewareRequest(request) && isNextJsMiddlewareResponse(response))
         await handleNextJsMiddlewareCookie(request, response, settings, timeout);
-    }
-    else if (isHttpRequest(request) && isHttpResponse(response)) {
+    else if (isHttpRequest(request) && isHttpResponse(response))
         await handleHttpCookie(request, response, settings, timeout);
-    }
 }

package/dist/esm/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/esm/src/lib/correlation-id/generate-correlation-id.js

@@ -0,0 +1,10 @@
+// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+import { generateV4UUID } from '@sitecore-cloudsdk/utils';
+/**
+ * A function that generates a correlation id
+ *
+ * @returns A correlation id string
+ */
+export function generateCorrelationId() {
+    return generateV4UUID().replace(/-/g, '');
+}

package/dist/esm/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/esm/src/lib/debug/debug.js

@@ -1,10 +1,26 @@
-// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
 import debug from 'debug';
+import { normalizeHeaders } from '@sitecore-cloudsdk/utils';
 if (process.env &&
     process.env.DEBUG_MULTILINE === 'true' &&
     debug.formatters &&
     debug.formatters.o &&
-    debug.formatters.O) {
+    debug.formatters.O)
     debug.formatters.o = debug.formatters.O;
-}
 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 function processDebugResponse(namespace, response) {
+    let debugResponse = {};
+    if (debug.enabled(namespace))
+        debugResponse = {
+            headers: normalizeHeaders(response.headers),
+            redirected: response.redirected,
+            status: response.status,
+            statusText: response.statusText,
+            url: response.url
+        };
+    return debugResponse;
+}

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

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

package/dist/esm/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/esm/src/lib/init/fetch-browser-id-from-edge-proxy.js

@@ -1,6 +1,6 @@
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
-import { fetchWithTimeout } from '@sitecore-cloudsdk/utils';
-import { LIBRARY_VERSION } from '../consts';
+import { ErrorMessages, LIBRARY_VERSION } from '../consts';
+import { ErrorMessages as UtilsErrorMessages, fetchWithTimeout } from '@sitecore-cloudsdk/utils';
 import { constructGetBrowserIdUrl } from './construct-get-browser-id-url';
 /**
  * Gets the browser ID and Client Key from Sitecore Edge Proxy
@@ -12,29 +12,26 @@ import { constructGetBrowserIdUrl } from './construct-get-browser-id-url';
 export async function fetchBrowserIdFromEdgeProxy(sitecoreEdgeUrl, sitecoreEdgeContextId, timeout) {
     const fetchOptions = {
         // eslint-disable-next-line @typescript-eslint/naming-convention
-        headers: { 'X-Library-Version': LIBRARY_VERSION },
+        headers: { 'X-Library-Version': LIBRARY_VERSION }
     };
     const url = constructGetBrowserIdUrl(sitecoreEdgeUrl, sitecoreEdgeContextId);
     let payload;
-    if (timeout !== undefined) {
+    if (timeout !== undefined)
         payload = await 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 === UtilsErrorMessages.IV_0006 || err.message === UtilsErrorMessages.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(ErrorMessages.IE_0003);
+    const { ref: browserId, customer_ref: guestId } = payload;
+    return { browserId, guestId };
 }

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

@@ -1,5 +1,5 @@
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
-import { API_VERSION, LIBRARY_VERSION } from '../consts';
+import { API_VERSION, ErrorMessages, LIBRARY_VERSION } from '../consts';
 /**
  * A function that gets the guest ref from EP.
  * @param browserId - The browser id of the client
@@ -17,5 +17,7 @@ export async function getGuestId(browserId, sitecoreEdgeContextId, sitecoreEdgeU
         const { error_msg: errorMsg, moreInfo } = data;
         throw new Error(`${errorMsg}, for more info: ${moreInfo}`);
     }
+    if (!data.customer.ref)
+        throw new Error(ErrorMessages.IE_0011);
     return data.customer.ref;
 }

package/dist/esm/src/lib/init/init-core-server.d.ts

@@ -1,10 +1,11 @@
-import { HttpResponse, MiddlewareNextResponse, Request } from '@sitecore-cloudsdk/utils';
-import { Settings, SettingsParamsServer } from '../settings/interfaces';
+import type { Request, Response } from '@sitecore-cloudsdk/utils';
+import type { ServerSettings, Settings } from '../settings/interfaces';
 export declare function setCoreSettings(settings: Settings): void;
 /**
  * Initializes the core settings for browser-based applications.
  *
- * This function initializes core settings for the application, including creating settings and handling cookies if enabled.
+ * This function initializes core settings for the application,
+ * including creating settings and handling cookies if enabled.
  *
  * @param settingsInput - The settings input to configure the core settings.
  * @returns A Promise that resolves when initialization is complete.
@@ -13,11 +14,12 @@ export declare function getSettingsServer(): Settings;
 /**
  * Initializes the core settings for browser-based applications.
  *
- * This function initializes core settings for the application, including creating settings and handling cookies if enabled.
+ * This function initializes core settings for the application,
+ * including creating settings and handling cookies if enabled.
  *
  * @param settingsInput - The settings input to configure the core settings.
  * @param request - A request object of type HttpRequest or MiddlewareRequest
  * @param response - A response object of type HttpResponse or MiddlewareNextResponse
  * @returns A Promise that resolves when initialization is complete.
  */
-export declare function initCoreServer<Response extends MiddlewareNextResponse | HttpResponse>(settingsInput: SettingsParamsServer, request: Request, response: Response): Promise<void>;
+export declare function initCoreServer(settingsInput: ServerSettings, request: Request, response: Response): Promise<void>;

package/dist/esm/src/lib/init/init-core-server.js

@@ -1,8 +1,9 @@
 // © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
-import { handleServerCookie } from '../cookie/handle-server-cookie';
+import { CORE_NAMESPACE } from '../debug/namespaces';
+import { ErrorMessages } from '../consts';
 import { createSettings } from '../settings/create-settings';
 import { debug } from '../debug/debug';
-import { CORE_NAMESPACE } from '../debug/namespaces';
+import { handleServerCookie } from '../cookie/handle-server-cookie';
 /**
  * Internal settings object to be used by all functions in module caching.
  * It starts with a null value and is set to the proper object by the  function. *
@@ -15,21 +16,22 @@ export function setCoreSettings(settings) {
 /**
  * Initializes the core settings for browser-based applications.
  *
- * This function initializes core settings for the application, including creating settings and handling cookies if enabled.
+ * This function initializes core settings for the application,
+ * including creating settings and handling cookies if enabled.
  *
  * @param settingsInput - The settings input to configure the core settings.
  * @returns A Promise that resolves when initialization is complete.
  */
 export function getSettingsServer() {
-    if (!coreSettings) {
-        throw Error('[IE-0008] You must first initialize the "core" package. Run the "init" function.');
-    }
+    if (!coreSettings)
+        throw Error(ErrorMessages.IE_0008);
     return coreSettings;
 }
 /**
  * Initializes the core settings for browser-based applications.
  *
- * This function initializes core settings for the application, including creating settings and handling cookies if enabled.
+ * This function initializes core settings for the application,
+ * including creating settings and handling cookies if enabled.
  *
  * @param settingsInput - The settings input to configure the core settings.
  * @param request - A request object of type HttpRequest or MiddlewareRequest
@@ -40,7 +42,6 @@ export async function initCoreServer(settingsInput, request, response) {
     debug(CORE_NAMESPACE)('initializing %o', 'initCoreServer initialized');
     if (!coreSettings)
         coreSettings = createSettings(settingsInput);
-    if (settingsInput.enableServerCookie) {
+    if (settingsInput.enableServerCookie)
         await handleServerCookie(request, response, settingsInput.timeout);
-    }
 }

package/dist/esm/src/lib/init/init-core.d.ts

@@ -1,8 +1,9 @@
-import { Settings, SettingsParamsBrowser } from '../settings/interfaces';
+import type { BrowserSettings, Settings } from '../settings/interfaces';
 /**
  * Retrieves the core settings object.
  *
- * This function ensures that the core settings have been initialized and contain essential properties like `clientKey`, `cookieSettings`, and `targetURL`.
+ * This function ensures that the core settings have been initialized and contain essential properties
+ * like `clientKey`, `cookieSettings`, and `targetURL`.
  *
  * @returns The core settings object.
  * @throws Error if the core settings haven't been initialized with the required properties.
@@ -11,12 +12,13 @@ export declare function getSettings(): Settings;
 /**
  * Initializes the core settings for browser-based applications.
  *
- * This function initializes core settings for the application, including creating settings and handling cookies if enabled.
+ * This function initializes core settings for the application,
+ * including creating settings and handling cookies if enabled.
  *
  * @param settingsInput - The settings input to configure the core settings.
  * @returns A Promise that resolves when initialization is complete.
  */
-export declare function initCore(settingsInput: SettingsParamsBrowser): Promise<void>;
+export declare function initCore(settingsInput: BrowserSettings): Promise<void>;
 /**
  * Helper functions for tests
  */

package/dist/esm/src/lib/init/init-core.js

@@ -1,8 +1,8 @@
-// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
-import { createCookie } from '../cookie/create-cookie';
+import { CORE_NAMESPACE } from '../debug/namespaces';
+import { ErrorMessages } from '../consts';
+import { createCookies } from '../cookie/create-cookies';
 import { createSettings } from '../settings/create-settings';
 import { debug } from '../debug/debug';
-import { CORE_NAMESPACE } from '../debug/namespaces';
 /**
  * Internal settings object to be used by all functions in module caching.
  * It starts with a null value and is set to the proper object by the  function. *
@@ -12,22 +12,23 @@ let coreSettings = null;
 /**
  * Retrieves the core settings object.
  *
- * This function ensures that the core settings have been initialized and contain essential properties like `clientKey`, `cookieSettings`, and `targetURL`.
+ * This function ensures that the core settings have been initialized and contain essential properties
+ * like `clientKey`, `cookieSettings`, and `targetURL`.
  *
  * @returns The core settings object.
  * @throws Error if the core settings haven't been initialized with the required properties.
  */
 export function getSettings() {
-    if (!coreSettings) {
-        throw Error(`[IE-0008] You must first initialize the "core" package. Run the "init" function.`);
-    }
+    if (!coreSettings)
+        throw Error(ErrorMessages.IE_0008);
     return coreSettings;
 }
-let createCookiePromise = null;
+let createCookiesPromise = null;
 /**
  * Initializes the core settings for browser-based applications.
  *
- * This function initializes core settings for the application, including creating settings and handling cookies if enabled.
+ * This function initializes core settings for the application,
+ * including creating settings and handling cookies if enabled.
  *
  * @param settingsInput - The settings input to configure the core settings.
  * @returns A Promise that resolves when initialization is complete.
@@ -36,9 +37,9 @@ export async function initCore(settingsInput) {
     debug(CORE_NAMESPACE)('coreClient library initialized');
     if (coreSettings === null)
         coreSettings = createSettings(settingsInput);
-    if (settingsInput.enableBrowserCookie && createCookiePromise === null)
-        createCookiePromise = createCookie(coreSettings);
-    await createCookiePromise;
+    if (settingsInput.enableBrowserCookie && createCookiesPromise === null)
+        createCookiesPromise = createCookies(coreSettings);
+    await createCookiesPromise;
 }
 /**
  * Helper functions for tests
@@ -47,5 +48,5 @@ export function setCoreSettings(settings) {
     coreSettings = settings;
 }
 export function setCookiePromise(promise) {
-    createCookiePromise = promise;
+    createCookiesPromise = promise;
 }