@sitecore-content-sdk/content 1.5.0-canary.5

package/dist/cjs/config/models.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComponentTemplateType = void 0;
+/**
+ * Enumeration of default component templates
+ * @internal
+ */
+var ComponentTemplateType;
+(function (ComponentTemplateType) {
+    ComponentTemplateType["BYOC"] = "byoc";
+    ComponentTemplateType["DEFAULT"] = "default";
+})(ComponentTemplateType || (exports.ComponentTemplateType = ComponentTemplateType = {}));

package/dist/cjs/config-cli/define-cli-config.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineCliConfig = void 0;
+const validateConfig = (cliConfig) => {
+    var _a, _b, _c, _d;
+    if (!((_b = (_a = cliConfig.build) === null || _a === void 0 ? void 0 : _a.commands) === null || _b === void 0 ? void 0 : _b.length)) {
+        throw new Error('Configuration error: build commands should be defined in sitecore.cli.config');
+    }
+    if (!((_d = (_c = cliConfig.scaffold) === null || _c === void 0 ? void 0 : _c.templates) === null || _d === void 0 ? void 0 : _d.length)) {
+        throw new Error('Configuration error: scaffold templates should be defined in sitecore.cli.config');
+    }
+};
+/**
+ * Accepts a `SitecoreCliConfigInput` object and returns Sitecore Content SDK CLI configuration, updated with required default values
+ * @param {SitecoreCliConfigInput} cliConfig the cli configuration provided by the application
+ * @returns {SitecoreCliConfig} full sitecore cli configuration to use with cli
+ * @public
+ */
+const defineCliConfig = (cliConfig) => {
+    validateConfig(cliConfig);
+    return cliConfig;
+};
+exports.defineCliConfig = defineCliConfig;

package/dist/cjs/config-cli/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SITECORE_CLI_MODE_ENV_VAR = exports.defineCliConfig = void 0;
+var define_cli_config_1 = require("./define-cli-config");
+Object.defineProperty(exports, "defineCliConfig", { enumerable: true, get: function () { return define_cli_config_1.defineCliConfig; } });
+var models_1 = require("./models");
+Object.defineProperty(exports, "SITECORE_CLI_MODE_ENV_VAR", { enumerable: true, get: function () { return models_1.SITECORE_CLI_MODE_ENV_VAR; } });

package/dist/cjs/config-cli/models.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SITECORE_CLI_MODE_ENV_VAR = void 0;
+/**
+ * Environment variable to indicate that the application is running in CLI mode
+ * @internal
+ */
+exports.SITECORE_CLI_MODE_ENV_VAR = 'SITECORE_CLI_MODE';

package/dist/cjs/constants.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HIDDEN_RENDERING_NAME = exports.languageError = exports.siteNameError = void 0;
+/** @private */
+exports.siteNameError = 'The site name must be a non-empty string';
+/** @private */
+exports.languageError = 'The language must be a non-empty string';
+/**
+ * Hidden rendering name
+ * @internal
+ */
+exports.HIDDEN_RENDERING_NAME = 'Hidden Rendering';

package/dist/cjs/debug.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@sitecore-content-sdk/core");
+/**
+ * Debug module for content package
+ * @public
+ */
+const debug = {
+    form: (0, core_1.debugModule)(`${core_1.debugNamespace}:form`),
+    layout: (0, core_1.debugModule)(`${core_1.debugNamespace}:layout`),
+    dictionary: (0, core_1.debugModule)(`${core_1.debugNamespace}:dictionary`),
+    editing: (0, core_1.debugModule)(`${core_1.debugNamespace}:editing`),
+    sitemap: (0, core_1.debugModule)(`${core_1.debugNamespace}:sitemap`),
+    multisite: (0, core_1.debugModule)(`${core_1.debugNamespace}:multisite`),
+    robots: (0, core_1.debugModule)(`${core_1.debugNamespace}:robots`),
+    redirects: (0, core_1.debugModule)(`${core_1.debugNamespace}:redirects`),
+    personalize: (0, core_1.debugModule)(`${core_1.debugNamespace}:personalize`),
+    locale: (0, core_1.debugModule)(`${core_1.debugNamespace}:locale`),
+    errorpages: (0, core_1.debugModule)(`${core_1.debugNamespace}:errorpages`),
+};
+exports.default = debug;

package/dist/cjs/editing/codegen/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DesignLibraryPreviewError = exports.sendErrorEvent = exports.createComponentInstance = exports.addStyleElement = exports.getImportMapInfo = exports.getDesignLibraryImportMapEvent = exports.getDesignLibraryComponentPropsEvent = exports.getDesignLibraryComponentPreviewErrorEvent = exports.addServerComponentPreviewHandler = exports.addComponentPreviewHandler = void 0;
+var preview_1 = require("./preview");
+Object.defineProperty(exports, "addComponentPreviewHandler", { enumerable: true, get: function () { return preview_1.addComponentPreviewHandler; } });
+Object.defineProperty(exports, "addServerComponentPreviewHandler", { enumerable: true, get: function () { return preview_1.addServerComponentPreviewHandler; } });
+Object.defineProperty(exports, "getDesignLibraryComponentPreviewErrorEvent", { enumerable: true, get: function () { return preview_1.getDesignLibraryComponentPreviewErrorEvent; } });
+Object.defineProperty(exports, "getDesignLibraryComponentPropsEvent", { enumerable: true, get: function () { return preview_1.getDesignLibraryComponentPropsEvent; } });
+Object.defineProperty(exports, "getDesignLibraryImportMapEvent", { enumerable: true, get: function () { return preview_1.getDesignLibraryImportMapEvent; } });
+Object.defineProperty(exports, "getImportMapInfo", { enumerable: true, get: function () { return preview_1.getImportMapInfo; } });
+Object.defineProperty(exports, "addStyleElement", { enumerable: true, get: function () { return preview_1.addStyleElement; } });
+Object.defineProperty(exports, "createComponentInstance", { enumerable: true, get: function () { return preview_1.createComponentInstance; } });
+Object.defineProperty(exports, "sendErrorEvent", { enumerable: true, get: function () { return preview_1.sendErrorEvent; } });
+Object.defineProperty(exports, "DesignLibraryPreviewError", { enumerable: true, get: function () { return preview_1.DesignLibraryPreviewError; } });

package/dist/cjs/editing/codegen/preview.js

@@ -0,0 +1,277 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendErrorEvent = exports.createComponentInstance = exports.addServerComponentPreviewHandler = exports.addComponentPreviewHandler = exports.DesignLibraryPreviewError = void 0;
+exports.buildComponentDependencies = buildComponentDependencies;
+exports.addStyleElement = addStyleElement;
+exports.getDesignLibraryComponentPreviewErrorEvent = getDesignLibraryComponentPreviewErrorEvent;
+exports.getDesignLibraryComponentPropsEvent = getDesignLibraryComponentPropsEvent;
+exports.getDesignLibraryImportMapEvent = getDesignLibraryImportMapEvent;
+exports.getImportMapInfo = getImportMapInfo;
+exports.isImportEntryInfoArray = isImportEntryInfoArray;
+const design_library_1 = require("../design-library");
+/**
+ * Event to send import map to design library
+ */
+const DESIGN_LIBRARY_IMPORT_MAP_EVENT_NAME = 'component:generation:import-map';
+/**
+ * Event to send component props to design library
+ */
+const DESIGN_LIBRARY_COMPONENT_PROPS_EVENT_NAME = 'component:generation:component-props';
+/**
+ * Event to receive component data from design library
+ */
+const DESIGN_LIBRARY_COMPONENT_PREVIEW_EVENT_NAME = 'component:generation:component-preview';
+/**
+ * Event to send component error to design library
+ */
+const DESIGN_LIBRARY_COMPONENT_PREVIEW_ERROR_EVENT_NAME = 'component:generation:component-preview-error';
+/**
+ * Enumeration of error types for the design library preview.
+ * @internal
+ */
+var DesignLibraryPreviewError;
+(function (DesignLibraryPreviewError) {
+    /**
+     * Error occurred during component rendering.
+     */
+    DesignLibraryPreviewError["Render"] = "render";
+    /**
+     * Error occurred during component and event handlers initialization.
+     */
+    DesignLibraryPreviewError["RenderInit"] = "render-init";
+})(DesignLibraryPreviewError || (exports.DesignLibraryPreviewError = DesignLibraryPreviewError = {}));
+/**
+ * Builds the component dependencies from the component imports and the import map.
+ * @param {ComponentImport[]} componentImports - The component imports.
+ * @param {ImportEntry[]} importMap - The import map to be used for the component.
+ * @returns {Array<{ name: string; value: unknown }>} The component dependencies.
+ */
+function buildComponentDependencies(componentImports, importMap) {
+    const successful = [];
+    const missing = {
+        modules: [],
+        exports: [],
+    };
+    componentImports.forEach((componentImport) => {
+        const moduleEntry = importMap.find((entry) => entry.module === componentImport.module);
+        if (!moduleEntry) {
+            missing.modules.push({
+                module: componentImport.module,
+                alias: componentImport.alias,
+            });
+            return;
+        }
+        const exportEntry = moduleEntry.exports.find((exp) => exp.name === componentImport.export);
+        if (!exportEntry) {
+            missing.exports.push({
+                alias: componentImport.alias,
+                export: componentImport.export,
+                module: componentImport.module,
+            });
+            return;
+        }
+        return successful.push({
+            name: componentImport.alias,
+            value: exportEntry.value,
+        });
+    });
+    return {
+        successful,
+        missing,
+    };
+}
+/**
+ * Adds the browser-side event handler for 'component:generation:component-preview' message used in Design Library
+ * The event should contain the component code, styles and imports.
+ * @param {ImportEntry[]} importMap - The import map to be used for the component.
+ * @param {Function} callback callback to be called after component is received
+ * @internal
+ */
+const addComponentPreviewHandler = (importMap, callback) => {
+    if (!window)
+        return;
+    const handler = (e) => {
+        const eventArgs = e.data;
+        try {
+            if (!(0, design_library_1.validateEvent)(e, DESIGN_LIBRARY_COMPONENT_PREVIEW_EVENT_NAME)) {
+                return;
+            }
+            console.debug('Component Library: message received', eventArgs);
+            const Component = (0, exports.createComponentInstance)(importMap, eventArgs);
+            addStyleElement(eventArgs.message.styles.content);
+            callback(null, Component);
+        }
+        catch (error) {
+            (0, exports.sendErrorEvent)(eventArgs.message.uid, error, DesignLibraryPreviewError.RenderInit);
+            callback(error, null);
+        }
+    };
+    window.addEventListener('message', handler);
+    const unsubscribe = () => {
+        window.removeEventListener('message', handler);
+    };
+    return unsubscribe;
+};
+exports.addComponentPreviewHandler = addComponentPreviewHandler;
+/**
+ * Adds the browser-side event handler for 'component:generation:component-preview' message used in Design Library for server components
+ * The event should contain the component code, styles and imports.
+ * @param {Function} callback callback to be called after component is received
+ * @internal
+ */
+const addServerComponentPreviewHandler = (callback) => {
+    const handler = (e) => {
+        if (!(0, design_library_1.validateEvent)(e, DESIGN_LIBRARY_COMPONENT_PREVIEW_EVENT_NAME)) {
+            return;
+        }
+        console.debug('Component Library: message received', e.data);
+        callback(e.data);
+    };
+    window.addEventListener('message', handler);
+    const unsubscribe = () => {
+        window.removeEventListener('message', handler);
+    };
+    return unsubscribe;
+};
+exports.addServerComponentPreviewHandler = addServerComponentPreviewHandler;
+/**
+ * Adds <style> element in the document head with the provided CSS.
+ * If an existing style element with the id "content-sdk-style-preview" is found, it is removed
+ * to prevent duplicates
+ * @param {string} stylesContent - The raw CSS text to inject into the style element.
+ * @internal
+ */
+function addStyleElement(stylesContent) {
+    const styleId = 'content-sdk-style-preview';
+    const styleElement = document.getElementById(styleId);
+    // remove existing style element if it exists to avoid duplicates
+    if (styleElement) {
+        styleElement.remove();
+    }
+    // create new style element and attach it to DOM
+    const style = document.createElement('style');
+    style.setAttribute('id', styleId);
+    style.innerHTML = stylesContent;
+    document.head.appendChild(style);
+}
+/**
+ * Dynamically creates a React component instance from provided importMap and from code, styles, and dependencies provided in the preview event.
+ * @param {ImportEntry[]} importMap - The import map containing module and export references that might be injected as dependencies in the provided code.
+ * @param {ComponentPreviewEventArgs} previewEventArgs - The event arguments containing the component code, styles, and import definitions.
+ * @returns The dynamically created React component instance.
+ * @throws If any required modules or exports are missing from the import map, an error is thrown describing the missing dependencies.
+ * @internal
+ */
+const createComponentInstance = (importMap, previewEventArgs) => {
+    const { message } = previewEventArgs;
+    const dependencies = buildComponentDependencies(message.imports, importMap);
+    if (dependencies.missing.modules.length > 0 || dependencies.missing.exports.length > 0) {
+        let errorMessage = '';
+        dependencies.missing.modules.forEach((mod) => {
+            errorMessage += `Missing module: '${mod.module}' with alias: '${mod.alias}'\n`;
+        });
+        dependencies.missing.exports.forEach((exp) => {
+            const alias = exp.export !== exp.alias ? ` with alias: '${exp.alias}'` : '';
+            errorMessage += `Missing export: '${exp.export}' from module: '${exp.module}'${alias}\n`;
+        });
+        throw errorMessage;
+    }
+    const importNames = dependencies.successful.map((entry) => entry.name);
+    const importInstances = dependencies.successful.map((entry) => entry.value);
+    const exports = { Component: null };
+    const componentFn = new Function('exports', message.styles.styleImport.name, ...importNames, message.code.content);
+    // Function will set exports.Component
+    componentFn(exports, message.styles.styleImport.content, ...importInstances);
+    return exports.Component;
+};
+exports.createComponentInstance = createComponentInstance;
+/**
+ * Generates a DesignLibraryComponentPreviewErrorEvent with the given uid and error.
+ * @param {string} uid - The unique identifier for the event.
+ * @param {unknown} error - The error to be sent.
+ * @param {DesignLibraryPreviewError} type - The type of error.
+ * @returns An object representing the DesignLibraryComponentPreviewErrorEvent.
+ * @internal
+ */
+function getDesignLibraryComponentPreviewErrorEvent(uid, error, type) {
+    return {
+        name: DESIGN_LIBRARY_COMPONENT_PREVIEW_ERROR_EVENT_NAME,
+        message: { uid, error, type },
+    };
+}
+/**
+ * Generates a DesignLibraryComponentPropsEvent with the given uid, fields and parameters.
+ * @param {string} uid - The unique identifier for the event.
+ * @param {ComponentFields} fields - The fields of the component.
+ * @param {ComponentParams} parameters - The parameters of the component.
+ * @returns An object representing the DesignLibraryComponentPropsEvent.
+ * @internal
+ */
+function getDesignLibraryComponentPropsEvent(uid, fields = {}, parameters = {}) {
+    return {
+        name: DESIGN_LIBRARY_COMPONENT_PROPS_EVENT_NAME,
+        message: {
+            uid,
+            fields,
+            parameters,
+        },
+    };
+}
+/**
+ * Generates a DesignLibraryImportMapEvent with the given uid and importMap.
+ * @param {string} uid - The unique identifier for the event.
+ * @param {ImportEntry[]} importMap - The imports map to be sent.
+ * @returns An object representing the DesignLibraryImportMapEvent.
+ * @internal
+ */
+function getDesignLibraryImportMapEvent(uid, importMap) {
+    const importMapPayload = isImportEntryInfoArray(importMap)
+        ? importMap
+        : getImportMapInfo(importMap);
+    return {
+        name: DESIGN_LIBRARY_IMPORT_MAP_EVENT_NAME,
+        message: {
+            uid,
+            importMap: importMapPayload,
+        },
+    };
+}
+/**
+ * Generates the payload for the import map to be sent to design library.
+ * @param {ImportEntry[]} importMap - The imports map to be sent.
+ * @internal
+ */
+function getImportMapInfo(importMap) {
+    return importMap.map((entry) => ({
+        module: entry.module,
+        exports: entry.exports.map((exp) => exp.name),
+    }));
+}
+/**
+ * Type guard for ImportEntryInfo[]
+ * @param {unknown} data import entry data to check
+ * @returns true if the data is ImportEntryInfo array
+ */
+function isImportEntryInfoArray(data) {
+    return (Array.isArray(data) &&
+        data.length > 0 &&
+        typeof data[0].module === 'string' &&
+        Array.isArray(data[0].exports) &&
+        typeof data[0].exports[0] === 'string');
+}
+/**
+ * Sends a component preview error event to the design library
+ * @param {string} uid - The unique identifier of the component that's being edited.
+ * @param {unknown} error - The error object or message to be sent.
+ * @param {DesignLibraryPreviewError} type - The type of error, as defined in DesignLibraryPreviewError.
+ * @internal
+ */
+const sendErrorEvent = (uid, error, type) => {
+    const errorEvent = getDesignLibraryComponentPreviewErrorEvent(uid, error, type);
+    console.error('Component Library: sending error event', errorEvent);
+    if (typeof window !== 'undefined') {
+        const target = window.parent && window.parent !== window ? window.parent : window;
+        target.postMessage(errorEvent, '*');
+    }
+};
+exports.sendErrorEvent = sendErrorEvent;

package/dist/cjs/editing/component-layout-service.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComponentLayoutService = void 0;
+const core_1 = require("@sitecore-content-sdk/core");
+const tools_1 = require("@sitecore-content-sdk/core/tools");
+const debug_1 = __importDefault(require("../debug"));
+const models_1 = require("./models");
+const { SITECORE_EDGE_URL_DEFAULT } = core_1.constants;
+/**
+ * REST service that enables Design Library functionality.
+ * Returns layout data for a single rendered component.
+ * @public
+ */
+class ComponentLayoutService {
+    constructor(config) {
+        this.config = config;
+    }
+    fetchComponentData(params, fetchOptions) {
+        // Choose the correct Edge ID per environment
+        const sitecoreContextId = this.config.contextId || this.config.clientContextId;
+        if (!sitecoreContextId) {
+            throw new Error(`ComponentLayoutService misconfigured: contextId is missing.
+         Provide contextId on the server, and clientContextId in the browser if you need to full client-side functionality.`);
+        }
+        const fetcher = new core_1.NativeDataFetcher({ debugger: debug_1.default.layout });
+        debug_1.default.layout('fetching component with uid %s for %s %s %s %s', params.componentUid, params.itemId, params.language, params.siteName, params.dataSourceId);
+        return fetcher
+            .get(this.getFetchUrl(params), Object.assign(Object.assign({}, fetchOptions), { headers: Object.assign(Object.assign({}, fetchOptions === null || fetchOptions === void 0 ? void 0 : fetchOptions.headers), { 'x-sitecore-contextid': sitecoreContextId, sc_editMode: `${params.mode === models_1.DesignLibraryMode.Metadata}` }) }))
+            .then((response) => response.data)
+            .catch((error) => {
+            var _a;
+            if (((_a = error.response) === null || _a === void 0 ? void 0 : _a.status) === 404) {
+                return error.response.data;
+            }
+            throw error;
+        });
+    }
+    getComponentFetchParams(params) {
+        // strip undefined fields
+        return JSON.parse(JSON.stringify({
+            item: params.itemId,
+            uid: params.componentUid,
+            dataSourceId: params.dataSourceId,
+            renderingItemId: params.renderingId,
+            version: params.version,
+            sc_site: params.siteName,
+            sc_lang: params.language || 'en',
+        }));
+    }
+    /**
+     * Get the fetch URL for the partial layout data endpoint
+     * @param {ComponentLayoutRequestParams} params - The parameters for the request
+     * @returns {string} The fetch URL for the component data
+     */
+    getFetchUrl(params) {
+        return (0, tools_1.resolveUrl)(`${this.config.edgeUrl || SITECORE_EDGE_URL_DEFAULT}/layout/component`, this.getComponentFetchParams(params));
+    }
+}
+exports.ComponentLayoutService = ComponentLayoutService;

package/dist/cjs/editing/design-library.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.postToDesignLibrary = exports.updateComponent = exports.updateComponentHandler = exports.validateEvent = exports.validateOrigin = exports.addComponentUpdateHandler = exports.DesignLibraryStatus = exports.COMPONENT_UPDATE_CACHE_KEY_PREFIX = void 0;
+exports.getDesignLibraryStatusEvent = getDesignLibraryStatusEvent;
+exports.getDesignLibraryScriptLink = getDesignLibraryScriptLink;
+exports.isDesignLibraryMode = isDesignLibraryMode;
+const core_1 = require("@sitecore-content-sdk/core");
+const tools_1 = require("@sitecore-content-sdk/core/tools");
+const models_1 = require("./models");
+const { SITECORE_EDGE_URL_DEFAULT } = core_1.constants;
+/**
+ * Event to be sent when report status to design library
+ */
+const DESIGN_LIBRARY_STATUS_EVENT_NAME = 'component:status';
+/**
+ * Prefix for component update cache keys
+ * @internal
+ */
+exports.COMPONENT_UPDATE_CACHE_KEY_PREFIX = 'component-update-';
+/**
+ * Enumeration of statuses for the design library.
+ * @internal
+ */
+var DesignLibraryStatus;
+(function (DesignLibraryStatus) {
+    DesignLibraryStatus["READY"] = "ready";
+    DesignLibraryStatus["RENDERED"] = "rendered";
+})(DesignLibraryStatus || (exports.DesignLibraryStatus = DesignLibraryStatus = {}));
+/**
+ * Adds the browser-side event handler for 'component:update' message used in Design Library
+ * The event should update a component on page by uid, with fields and params from event args
+ * @param {ComponentRendering} rootComponent root component displayed for Design Library page
+ * @param {Function} successCallback  callback to be called after successful component update
+ * @internal
+ */
+const addComponentUpdateHandler = (rootComponent, successCallback) => {
+    if (!window)
+        return;
+    const handler = (e) => (0, exports.updateComponentHandler)(e, rootComponent, successCallback);
+    window.addEventListener('message', handler);
+    // the power to remove handler outside of this function, if needed
+    const unsubscribe = () => {
+        window.removeEventListener('message', handler);
+    };
+    return unsubscribe;
+};
+exports.addComponentUpdateHandler = addComponentUpdateHandler;
+const validateOrigin = (event) => {
+    // TODO: use `EDITING_ALLOWED_ORIGINS.concat(getAllowedOriginsFromEnv())` later
+    // nextjs's JSS_ALLOWED_ORIGINS is not available on the client, need to use NEXT_PUBLIC_ variable, but it's a breaking change for Deploy
+    const allowedOrigins = ['*'];
+    return allowedOrigins.some((origin) => origin === event.origin ||
+        new RegExp('^' + origin.replace('.', '\\.').replace(/\*/g, '.*') + '$').test(event.origin));
+};
+exports.validateOrigin = validateOrigin;
+/**
+ * Validates that a MessageEvent has the expected event name and required data.
+ * Logs debug information when validation fails due to invalid origin.
+ * @param {MessageEvent} e - The message event to validate.
+ * @param {string} eventName - The expected event name to match against e.data.name.
+ * @returns {boolean} True if the event has a valid origin, data object, and matching event name; otherwise false.
+ */
+const validateEvent = (e, eventName) => {
+    if (!e.origin || !e.data || e.data.name !== eventName) {
+        // avoid extra noise in logs
+        if (!(0, exports.validateOrigin)(e)) {
+            console.debug('Component Library: event skipped - invalid origin: message %s from origin %s', e.data.name, e.origin);
+        }
+        return false;
+    }
+    return true;
+};
+exports.validateEvent = validateEvent;
+const updateComponentHandler = (e, rootComponent, successCallback) => {
+    var _a;
+    const eventArgs = e.data;
+    if (!e.origin || !eventArgs || eventArgs.name !== 'component:update') {
+        // avoid extra noise in logs
+        if (!(0, exports.validateOrigin)(e)) {
+            console.debug('Component Library: event skipped: message %s from origin %s', eventArgs.name, e.origin);
+        }
+        return;
+    }
+    if (!((_a = eventArgs.details) === null || _a === void 0 ? void 0 : _a.uid)) {
+        console.debug('Received component:update event without uid, aborting event handler...');
+        return;
+    }
+    const findComponent = (root) => {
+        var _a, _b;
+        if (((_a = root.uid) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === ((_b = eventArgs.details) === null || _b === void 0 ? void 0 : _b.uid.toLowerCase()))
+            return root;
+        if (root.placeholders) {
+            for (const plhName of Object.keys(root.placeholders)) {
+                for (const rendering of root.placeholders[plhName]) {
+                    const result = findComponent(rendering);
+                    if (result)
+                        return result;
+                }
+            }
+        }
+        return null;
+    };
+    const componentToUpdate = findComponent(rootComponent);
+    if (componentToUpdate) {
+        console.debug('Found component with uid %s to update. Update fields: %o. Update params: %o.', eventArgs.details.uid, eventArgs.details.fields, eventArgs.details.params);
+        (0, exports.updateComponent)(componentToUpdate, eventArgs.details.fields, eventArgs.details.params);
+        if (successCallback)
+            successCallback(rootComponent);
+    }
+    else {
+        console.debug('Rendering with uid %s not found', eventArgs.details.uid);
+    }
+    // strictly for testing
+    return rootComponent;
+};
+exports.updateComponentHandler = updateComponentHandler;
+/**
+ * Updates a component's fields and params with the provided values.
+ * @param {ComponentRendering<ComponentFields>} component - The component to update.
+ * @param {ComponentFields | undefined} fields - The fields to merge into the component.
+ * @param {ComponentParams | undefined} params - The params to merge into the component.
+ * @internal
+ */
+const updateComponent = (component, fields, params) => {
+    if (fields) {
+        component.fields = Object.assign(Object.assign({}, component.fields), fields);
+    }
+    if (params) {
+        component.params = Object.assign(Object.assign({}, component.params), params);
+    }
+};
+exports.updateComponent = updateComponent;
+/**
+ * Generates a DesignLibraryStatusEvent with the given status and uid.
+ * @param {DesignLibraryStatus} status - The status of rendering.
+ * @param {string} uid - The unique identifier for the event.
+ * @returns An object representing the DesignLibraryStatusEvent.
+ * @internal
+ */
+function getDesignLibraryStatusEvent(status, uid) {
+    return {
+        name: DESIGN_LIBRARY_STATUS_EVENT_NAME,
+        message: {
+            status,
+            uid,
+        },
+    };
+}
+/**
+ * Generates the URL for the design library script link.
+ * @param {string} [sitecoreEdgeUrl] Sitecore Edge Platform URL. Default is https://edge-platform.sitecorecloud.io
+ * @returns The full URL to the design library script.
+ * @internal
+ */
+function getDesignLibraryScriptLink(sitecoreEdgeUrl = SITECORE_EDGE_URL_DEFAULT) {
+    return `${(0, tools_1.normalizeUrl)(sitecoreEdgeUrl)}/v1/files/designlibrary/lib/rh-lib-script.js`;
+}
+/**
+ * Checks if the given mode is a Design Library mode.
+ * @param {unknown} mode - The mode to check.
+ * @returns {boolean} True if the mode is a Design Library mode, false otherwise.
+ * @internal
+ */
+function isDesignLibraryMode(mode) {
+    return mode === models_1.DesignLibraryMode.Normal || mode === models_1.DesignLibraryMode.Metadata;
+}
+/**
+ * Sends an event to the Design Library
+ * @param {DesignLibraryEvent} evt - The event object to send.
+ * @internal
+ */
+const postToDesignLibrary = (evt) => {
+    if (typeof window === 'undefined')
+        return;
+    const target = window.parent && window.parent !== window ? window.parent : window;
+    try {
+        console.log('Component Library: sending event', evt.name, evt);
+        target.postMessage(evt, '*');
+    }
+    catch (err) {
+        console.error('Component Library: postMessage failed', err, evt);
+    }
+};
+exports.postToDesignLibrary = postToDesignLibrary;