@sitecore-cloudsdk/core 0.3.1 → 0.4.0-rc.1

package/dist/esm/src/lib/initializer/browser/initializer.d.ts

@@ -0,0 +1,63 @@
+import type { ProxySettings } from '../../interfaces';
+import type { BrowserSettings, Core, Settings } from './interfaces';
+import type { PackageInitializer } from './package-initializer';
+export declare let cloudSDKSettings: Settings;
+export declare const enabledPackages: Map<string, PackageInitializer>;
+export declare let initCoreState: Promise<void> | null;
+export declare let cookiesValuesFromEdge: ProxySettings;
+export declare class CloudSDKBrowserInitializer {
+    /**
+     * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+     * @param settings - Common settings for the CloudSDK
+     * @throws the following errors:
+     * {@link ErrorMessages.MV_0001}
+     * {@link ErrorMessages.MV_0002}
+     * {@link ErrorMessages.IE_0001}
+     * {@link ErrorMessages.IV_0001}
+     */
+    constructor(settings: BrowserSettings);
+    /**
+     * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+     */
+    initialize(): void;
+    /**
+     * Runs any necessary side effects.
+     */
+    private sideEffects;
+    /**
+     * Validates the core settings to ensure they meet required criteria.
+     *
+     * This function validates the provided core settings object to ensure that essential properties
+     * such as "sitecoreEdgeContextId" and "siteName" meet specific criteria and are not empty.
+     *
+     * @throws Error with specific error codes if any required property is missing or empty.
+     */
+    private validateSettings;
+    private createSettings;
+    private createCookies;
+}
+export declare function getCloudSDKSettings(): Settings;
+export declare function getEnabledPackage(packageName: string): PackageInitializer | undefined;
+export declare let builderInstance: null | CloudSDKBrowserInitializer;
+export declare function getCookiesValuesFromEdge(): ProxySettings;
+/**
+ * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+ * @param settings - Common settings for the CloudSDK
+ * @returns An instance of {@link CloudSDKBrowserInitializer}
+ * @throws the following errors:
+ * {@link ErrorMessages.MV_0001}
+ * {@link ErrorMessages.MV_0002}
+ * {@link ErrorMessages.IE_0001}
+ * {@link ErrorMessages.IV_0001}
+ */
+export declare function CloudSDK(settings: BrowserSettings): CloudSDKBrowserInitializer;
+declare global {
+    interface Personalize {
+    }
+    interface Window {
+        scCloudSDK: {
+            core: Core;
+            personalize: Personalize;
+        };
+    }
+}

package/dist/esm/src/lib/initializer/browser/initializer.js

@@ -0,0 +1,136 @@
+// © 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 '../../browser-id/fetch-browser-id-from-edge-proxy';
+import { getBrowserId } from '../../browser-id/get-browser-id';
+import { COOKIE_NAME_PREFIX, DEFAULT_COOKIE_EXPIRY_DAYS, ErrorMessages, LIBRARY_VERSION, SITECORE_EDGE_URL } from '../../consts';
+import { getDefaultCookieAttributes } from '../../cookie/get-default-cookie-attributes';
+import { debug } from '../../debug/debug';
+import { CORE_NAMESPACE } from '../../debug/namespaces';
+import { getGuestId } from '../../guest-id/get-guest-id';
+export let cloudSDKSettings;
+export const enabledPackages = new Map();
+export let initCoreState = null;
+export let cookiesValuesFromEdge;
+export class CloudSDKBrowserInitializer {
+    /**
+     * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+     * @param settings - Common settings for the CloudSDK
+     * @throws the following errors:
+     * {@link ErrorMessages.MV_0001}
+     * {@link ErrorMessages.MV_0002}
+     * {@link ErrorMessages.IE_0001}
+     * {@link ErrorMessages.IV_0001}
+     */
+    constructor(settings) {
+        if (typeof window === 'undefined')
+            throw new Error(ErrorMessages.IE_0001);
+        this.validateSettings(settings);
+        cloudSDKSettings = this.createSettings(settings);
+    }
+    /**
+     * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+     */
+    initialize() {
+        if (!enabledPackages.size)
+            debug(CORE_NAMESPACE)('CloudSDK was initialized with no packages');
+        if (cloudSDKSettings.cookieSettings.enableBrowserCookie)
+            initCoreState = this.createCookies();
+        else
+            initCoreState = Promise.resolve();
+        this.sideEffects();
+        enabledPackages.forEach((pkg) => {
+            pkg.exec();
+        });
+    }
+    /**
+     * Runs any necessary side effects.
+     */
+    sideEffects() {
+        window.scCloudSDK = {
+            ...window.scCloudSDK,
+            core: {
+                getBrowserId,
+                getGuestId,
+                settings: {
+                    sitecoreEdgeContextId: cloudSDKSettings.sitecoreEdgeContextId,
+                    sitecoreEdgeUrl: cloudSDKSettings.sitecoreEdgeUrl
+                },
+                version: LIBRARY_VERSION
+            }
+        };
+    }
+    /**
+     * Validates the core settings to ensure they meet required criteria.
+     *
+     * This function validates the provided core settings object to ensure that essential properties
+     * such as "sitecoreEdgeContextId" and "siteName" meet specific criteria and are not empty.
+     *
+     * @throws Error with specific error codes if any required property is missing or empty.
+     */
+    validateSettings(settings) {
+        const { sitecoreEdgeContextId, siteName, sitecoreEdgeUrl } = settings;
+        if (!sitecoreEdgeContextId || sitecoreEdgeContextId.trim().length === 0)
+            throw new Error(ErrorMessages.MV_0001);
+        if (!siteName || siteName.trim().length === 0)
+            throw new Error(ErrorMessages.MV_0002);
+        if (sitecoreEdgeUrl !== undefined)
+            try {
+                new URL(sitecoreEdgeUrl);
+            }
+            catch (e) {
+                throw new Error(ErrorMessages.IV_0001);
+            }
+    }
+    createSettings(settings) {
+        const { siteName, sitecoreEdgeContextId, cookieDomain, cookiePath, cookieExpiryDays, sitecoreEdgeUrl, enableBrowserCookie } = settings;
+        return {
+            cookieSettings: {
+                domain: cookieDomain,
+                enableBrowserCookie: enableBrowserCookie ?? false,
+                expiryDays: cookieExpiryDays || DEFAULT_COOKIE_EXPIRY_DAYS,
+                name: {
+                    browserId: `${COOKIE_NAME_PREFIX}${sitecoreEdgeContextId}`
+                },
+                path: cookiePath || '/'
+            },
+            siteName,
+            sitecoreEdgeContextId,
+            sitecoreEdgeUrl: sitecoreEdgeUrl ?? SITECORE_EDGE_URL
+        };
+    }
+    async createCookies() {
+        const attributes = getDefaultCookieAttributes(cloudSDKSettings.cookieSettings.expiryDays, cloudSDKSettings.cookieSettings.domain);
+        const browserIdCookie = getCookie(window.document.cookie, cloudSDKSettings.cookieSettings.name.browserId);
+        if (browserIdCookie)
+            return;
+        const cookiesValues = await fetchBrowserIdFromEdgeProxy(cloudSDKSettings.sitecoreEdgeUrl, cloudSDKSettings.sitecoreEdgeContextId);
+        document.cookie = createCookieString(cloudSDKSettings.cookieSettings.name.browserId, cookiesValues.browserId, attributes);
+        cookiesValuesFromEdge = cookiesValues;
+    }
+}
+export function getCloudSDKSettings() {
+    if (!cloudSDKSettings)
+        throw new Error(ErrorMessages.IE_0012);
+    return cloudSDKSettings;
+}
+export function getEnabledPackage(packageName) {
+    return enabledPackages.get(packageName);
+}
+export let builderInstance = null;
+export function getCookiesValuesFromEdge() {
+    return cookiesValuesFromEdge;
+}
+/**
+ * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+ * @param settings - Common settings for the CloudSDK
+ * @returns An instance of {@link CloudSDKBrowserInitializer}
+ * @throws the following errors:
+ * {@link ErrorMessages.MV_0001}
+ * {@link ErrorMessages.MV_0002}
+ * {@link ErrorMessages.IE_0001}
+ * {@link ErrorMessages.IV_0001}
+ */
+export function CloudSDK(settings) {
+    builderInstance = new CloudSDKBrowserInitializer(settings);
+    return builderInstance;
+}

package/dist/esm/src/lib/initializer/browser/interfaces.d.ts

@@ -0,0 +1,41 @@
+export interface BrowserSettings {
+    sitecoreEdgeContextId: string;
+    siteName: string;
+    enableBrowserCookie?: boolean;
+    cookieDomain?: string;
+    cookieExpiryDays?: number;
+    cookiePath?: string;
+    sitecoreEdgeUrl?: string;
+}
+export interface Settings {
+    sitecoreEdgeContextId: string;
+    siteName: string;
+    sitecoreEdgeUrl: string;
+    cookieSettings: {
+        name: {
+            browserId: string;
+        };
+        domain?: string;
+        expiryDays: number;
+        path?: string;
+        enableBrowserCookie?: boolean;
+    };
+}
+export interface PackageContextDependency {
+    name: string;
+    method: string;
+}
+export interface PackageContext {
+    sideEffects: () => Promise<void>;
+    settings?: unknown;
+    dependencies?: PackageContextDependency[];
+}
+export interface Core {
+    getBrowserId: () => string;
+    getGuestId: () => Promise<string>;
+    settings: {
+        sitecoreEdgeContextId: string;
+        sitecoreEdgeUrl: string;
+    };
+    version: string;
+}

package/dist/esm/src/lib/initializer/browser/interfaces.js

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

package/dist/esm/src/lib/initializer/browser/package-initializer.d.ts

@@ -0,0 +1,13 @@
+import type { PackageContext } from './interfaces';
+export declare class PackageInitializer {
+    private _initState;
+    private _settings?;
+    private _sideEffects;
+    private _dependencies;
+    constructor(packageContext: PackageContext);
+    private validatePackages;
+    exec(): void;
+    private wrapSideEffects;
+    get initState(): Promise<void> | null;
+    get settings(): unknown;
+}

package/dist/esm/src/lib/initializer/browser/package-initializer.js

@@ -0,0 +1,41 @@
+// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+import { getEnabledPackage, initCoreState } from './initializer';
+export class PackageInitializer {
+    /* eslint-enable @typescript-eslint/naming-convention */
+    constructor(packageContext) {
+        /* eslint-disable @typescript-eslint/naming-convention */
+        this._initState = null;
+        this._sideEffects = packageContext.sideEffects;
+        this._settings = packageContext.settings;
+        this._dependencies = packageContext.dependencies ?? [];
+    }
+    validatePackages() {
+        const validatedPackages = [];
+        this._dependencies.forEach((dependency) => {
+            // The package name is the name found in each package's package.json file e.g. @sitecore-cloudsdk/core"
+            const depName = dependency.name.split('/')[1];
+            const pkg = getEnabledPackage(dependency.name);
+            if (!pkg)
+                throw new Error(
+                // eslint-disable-next-line max-len
+                `[IE-0020] - This functionality also requires the "${depName}" package. Import "${dependency.name}/browser", then run ".${dependency.method}()" on "CloudSDK", before ".initialize()"`);
+            validatedPackages.push(pkg);
+        });
+        return validatedPackages;
+    }
+    exec() {
+        const validatedPackages = this.validatePackages();
+        this._initState = this.wrapSideEffects(validatedPackages);
+    }
+    async wrapSideEffects(validatedPackages) {
+        await initCoreState;
+        await Promise.all(validatedPackages.map((pkg) => pkg.initState));
+        this._sideEffects();
+    }
+    get initState() {
+        return this._initState;
+    }
+    get settings() {
+        return this._settings;
+    }
+}

package/dist/esm/src/lib/initializer/server/initializer.d.ts

@@ -0,0 +1,58 @@
+import type { Request, Response } from '@sitecore-cloudsdk/utils';
+import type { ProxySettings } from '../../interfaces';
+import type { ServerSettings, Settings } from './interfaces';
+import type { PackageInitializerServer } from './package-initializer';
+export declare let cloudSDKSettings: Settings;
+export declare const enabledPackages: Map<string, PackageInitializerServer>;
+export declare let cloudSKDRequest: Request;
+export declare let cloudSKDResponse: Response;
+export declare class CloudSDKServerInitializer {
+    private request;
+    private response;
+    /**
+     * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+     * @param request - The request object, either a Middleware Request or an HTTP Request
+     * @param response - The response object, either a Middleware Next Response or an HTTP Response
+     * @param settings - Common settings for the CloudSDK
+     * @throws the following errors:
+     * {@link ErrorMessages.MV_0001}
+     * {@link ErrorMessages.MV_0002}
+     * {@link ErrorMessages.IV_0001}
+     */
+    constructor(request: Request, response: Response, settings: ServerSettings);
+    /**
+     * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Validates the core settings to ensure they meet required criteria.
+     *
+     * This function validates the provided core settings object to ensure that essential properties
+     * such as "sitecoreEdgeContextId" and "siteName" meet specific criteria and are not empty.
+     *
+     * @throws Error with specific error codes if any required property is missing or empty.
+     */
+    private validateSettings;
+    private createSettings;
+    private createCookies;
+    private handleNextJsMiddlewareCookie;
+    private handleHttpCookie;
+}
+export declare function getCloudSDKSettings(): Settings;
+export declare function getEnabledPackage(packageName: string): PackageInitializerServer | undefined;
+export declare function getCloudSDKRequest(): Request;
+export declare function getCloudSDKResponse(): Response;
+export declare function getCookiesValuesFromEdge(): ProxySettings;
+export declare let builderInstance: null | CloudSDKServerInitializer;
+/**
+ * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+ * @param request - The request object, either a Middleware Request or an HTTP Request
+ * @param response - The response object, either a Middleware Next Response or an HTTP Response
+ * @param settings - Common settings for the CloudSDK
+ * @returns An instance of {@link CloudSDKServerInitializer}
+ * @throws the following errors:
+ * {@link ErrorMessages.MV_0001}
+ * {@link ErrorMessages.MV_0002}
+ * {@link ErrorMessages.IV_0001}
+ */
+export declare function CloudSDK(request: Request, response: Response, settings: ServerSettings): CloudSDKServerInitializer;

package/dist/esm/src/lib/initializer/server/initializer.js

@@ -0,0 +1,157 @@
+import { createCookieString, getCookieServerSide, isHttpRequest, isHttpResponse, isNextJsMiddlewareRequest, isNextJsMiddlewareResponse } from '@sitecore-cloudsdk/utils';
+import { fetchBrowserIdFromEdgeProxy } from '../../browser-id/fetch-browser-id-from-edge-proxy';
+import { COOKIE_NAME_PREFIX, DEFAULT_COOKIE_EXPIRY_DAYS, ErrorMessages, SITECORE_EDGE_URL } from '../../consts';
+import { getCookieValueFromMiddlewareRequest } from '../../cookie/get-cookie-value-from-middleware-request';
+import { getDefaultCookieAttributes } from '../../cookie/get-default-cookie-attributes';
+import { debug } from '../../debug/debug';
+import { CORE_NAMESPACE } from '../../debug/namespaces';
+export let cloudSDKSettings;
+export const enabledPackages = new Map();
+let cookiesValuesFromEdge;
+export let cloudSKDRequest;
+export let cloudSKDResponse;
+export class CloudSDKServerInitializer {
+    /**
+     * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+     * @param request - The request object, either a Middleware Request or an HTTP Request
+     * @param response - The response object, either a Middleware Next Response or an HTTP Response
+     * @param settings - Common settings for the CloudSDK
+     * @throws the following errors:
+     * {@link ErrorMessages.MV_0001}
+     * {@link ErrorMessages.MV_0002}
+     * {@link ErrorMessages.IV_0001}
+     */
+    constructor(request, response, settings) {
+        this.validateSettings(settings);
+        cloudSDKSettings = this.createSettings(settings);
+        this.request = request;
+        this.response = response;
+    }
+    /**
+     * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+     */
+    async initialize() {
+        if (!enabledPackages.size)
+            debug(CORE_NAMESPACE)('CloudSDK was initialized with no packages');
+        if (cloudSDKSettings.cookieSettings.enableServerCookie)
+            await this.createCookies();
+        const execs = Array.from(enabledPackages).map(([, value]) => value.exec());
+        await Promise.all(execs);
+    }
+    /**
+     * Validates the core settings to ensure they meet required criteria.
+     *
+     * This function validates the provided core settings object to ensure that essential properties
+     * such as "sitecoreEdgeContextId" and "siteName" meet specific criteria and are not empty.
+     *
+     * @throws Error with specific error codes if any required property is missing or empty.
+     */
+    validateSettings(settings) {
+        const { sitecoreEdgeContextId, siteName, sitecoreEdgeUrl } = settings;
+        if (!sitecoreEdgeContextId || sitecoreEdgeContextId.trim().length === 0)
+            throw new Error(ErrorMessages.MV_0001);
+        if (!siteName || siteName.trim().length === 0)
+            throw new Error(ErrorMessages.MV_0002);
+        if (sitecoreEdgeUrl !== undefined)
+            try {
+                new URL(sitecoreEdgeUrl);
+            }
+            catch (e) {
+                throw new Error(ErrorMessages.IV_0001);
+            }
+    }
+    createSettings(settings) {
+        const { siteName, sitecoreEdgeContextId, cookieDomain, cookiePath, cookieExpiryDays, sitecoreEdgeUrl, enableServerCookie, timeout } = settings;
+        return {
+            cookieSettings: {
+                domain: cookieDomain,
+                enableServerCookie: enableServerCookie ?? false,
+                expiryDays: cookieExpiryDays || DEFAULT_COOKIE_EXPIRY_DAYS,
+                name: {
+                    browserId: `${COOKIE_NAME_PREFIX}${sitecoreEdgeContextId}`
+                },
+                path: cookiePath || '/'
+            },
+            siteName,
+            sitecoreEdgeContextId,
+            sitecoreEdgeUrl: sitecoreEdgeUrl ?? SITECORE_EDGE_URL,
+            timeout
+        };
+    }
+    async createCookies() {
+        if (isNextJsMiddlewareRequest(this.request) && isNextJsMiddlewareResponse(this.response))
+            await this.handleNextJsMiddlewareCookie();
+        else if (isHttpRequest(this.request) && isHttpResponse(this.response))
+            await this.handleHttpCookie();
+    }
+    async handleNextJsMiddlewareCookie() {
+        const request = this.request;
+        const response = this.response;
+        const { browserId: browserIdName } = cloudSDKSettings.cookieSettings.name;
+        let browserIdCookieValue = getCookieValueFromMiddlewareRequest(request, browserIdName);
+        if (!browserIdCookieValue) {
+            const cookieValues = await fetchBrowserIdFromEdgeProxy(cloudSDKSettings.sitecoreEdgeUrl, cloudSDKSettings.sitecoreEdgeContextId, cloudSDKSettings.timeout);
+            browserIdCookieValue = cookieValues.browserId;
+            cookiesValuesFromEdge = cookieValues;
+        }
+        const defaultCookieAttributes = getDefaultCookieAttributes(cloudSDKSettings.cookieSettings.expiryDays, cloudSDKSettings.cookieSettings.domain);
+        request.cookies.set(browserIdName, browserIdCookieValue, defaultCookieAttributes);
+        response.cookies.set(browserIdName, browserIdCookieValue, defaultCookieAttributes);
+    }
+    async handleHttpCookie() {
+        const request = this.request;
+        const response = this.response;
+        const browserIdName = cloudSDKSettings.cookieSettings.name.browserId;
+        const browserIdCookie = getCookieServerSide(request.headers.cookie, browserIdName);
+        let browserIdCookieValue;
+        const defaultCookieAttributes = getDefaultCookieAttributes(cloudSDKSettings.cookieSettings.expiryDays, cloudSDKSettings.cookieSettings.domain);
+        if (!browserIdCookie) {
+            const cookieValues = await fetchBrowserIdFromEdgeProxy(cloudSDKSettings.sitecoreEdgeUrl, cloudSDKSettings.sitecoreEdgeContextId, cloudSDKSettings.timeout);
+            browserIdCookieValue = cookieValues.browserId;
+            cookiesValuesFromEdge = cookieValues;
+        }
+        else
+            browserIdCookieValue = browserIdCookie.value;
+        const browserIdCookieString = createCookieString(browserIdName, browserIdCookieValue, defaultCookieAttributes);
+        if (!browserIdCookie)
+            request.headers.cookie = request.headers.cookie
+                ? request.headers.cookie + '; ' + browserIdCookieString
+                : browserIdCookieString;
+        response.setHeader('Set-Cookie', browserIdCookieString);
+    }
+}
+export function getCloudSDKSettings() {
+    if (!cloudSDKSettings)
+        throw new Error(ErrorMessages.IE_0013);
+    return cloudSDKSettings;
+}
+export function getEnabledPackage(packageName) {
+    return enabledPackages.get(packageName);
+}
+export function getCloudSDKRequest() {
+    return cloudSKDRequest;
+}
+export function getCloudSDKResponse() {
+    return cloudSKDResponse;
+}
+export function getCookiesValuesFromEdge() {
+    return cookiesValuesFromEdge;
+}
+export let builderInstance = null;
+/**
+ * Runs the initialization logic. Enables packages and create cookies for CloudSDK.
+ * @param request - The request object, either a Middleware Request or an HTTP Request
+ * @param response - The response object, either a Middleware Next Response or an HTTP Response
+ * @param settings - Common settings for the CloudSDK
+ * @returns An instance of {@link CloudSDKServerInitializer}
+ * @throws the following errors:
+ * {@link ErrorMessages.MV_0001}
+ * {@link ErrorMessages.MV_0002}
+ * {@link ErrorMessages.IV_0001}
+ */
+export function CloudSDK(request, response, settings) {
+    cloudSKDRequest = request;
+    cloudSKDResponse = response;
+    builderInstance = new CloudSDKServerInitializer(request, response, settings);
+    return builderInstance;
+}

package/dist/esm/src/lib/initializer/server/interfaces.d.ts

@@ -0,0 +1,34 @@
+export interface ServerSettings {
+    sitecoreEdgeContextId: string;
+    siteName: string;
+    enableServerCookie?: boolean;
+    cookieDomain?: string;
+    cookieExpiryDays?: number;
+    cookiePath?: string;
+    sitecoreEdgeUrl?: string;
+    timeout?: number;
+}
+export interface Settings {
+    sitecoreEdgeContextId: string;
+    siteName: string;
+    sitecoreEdgeUrl: string;
+    timeout?: number;
+    cookieSettings: {
+        name: {
+            browserId: string;
+        };
+        domain?: string;
+        expiryDays: number;
+        path?: string;
+        enableServerCookie?: boolean;
+    };
+}
+export interface PackageContextDependencyServer {
+    name: string;
+    method: string;
+}
+export interface PackageContext {
+    sideEffects: () => Promise<void>;
+    settings?: unknown;
+    dependencies?: PackageContextDependencyServer[];
+}

package/dist/esm/src/lib/initializer/server/interfaces.js

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

package/dist/esm/src/lib/initializer/server/package-initializer.d.ts

@@ -0,0 +1,10 @@
+import type { PackageContext } from './interfaces';
+export declare class PackageInitializerServer {
+    private _settings;
+    private _sideEffects;
+    private _dependencies;
+    constructor(packageContext: PackageContext);
+    private checkDependencies;
+    exec(): Promise<void>;
+    get settings(): unknown;
+}

package/dist/esm/src/lib/initializer/server/package-initializer.js

@@ -0,0 +1,26 @@
+// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+import { getEnabledPackage } from './initializer';
+export class PackageInitializerServer {
+    /* eslint-enable @typescript-eslint/naming-convention */
+    constructor(packageContext) {
+        this._sideEffects = packageContext.sideEffects;
+        this._settings = packageContext.settings;
+        this._dependencies = packageContext.dependencies ?? [];
+    }
+    checkDependencies() {
+        this._dependencies.forEach((dependency) => {
+            // The package name is the name found in each package's package.json file e.g. @sitecore-cloudsdk/core"
+            const depName = dependency.name.split('/')[1];
+            if (!getEnabledPackage(dependency.name))
+                throw new Error(// eslint-disable-next-line max-len
+                `[IE-0021] - This functionality also requires the "${depName}" package. Import "${dependency.name}/server", then run ".${dependency.method}()" on "CloudSDK", before ".initialize()"`);
+        });
+    }
+    async exec() {
+        this.checkDependencies();
+        await this._sideEffects();
+    }
+    get settings() {
+        return this._settings;
+    }
+}

package/dist/esm/src/server.d.ts

@@ -0,0 +1,3 @@
+export { CloudSDKServerInitializer } from './lib/initializer/server/initializer';
+export type { Settings } from './lib/initializer/server/interfaces';
+export { CloudSDK } from './lib/initializer/server/initializer';

package/dist/esm/src/server.js

@@ -0,0 +1,3 @@
+// © Sitecore Corporation A/S. All rights reserved. Sitecore® is a registered trademark of Sitecore Corporation A/S.
+export { CloudSDKServerInitializer } from './lib/initializer/server/initializer';
+export { CloudSDK } from './lib/initializer/server/initializer';