@sitecore-content-sdk/content 2.0.0-canary.1 → 2.0.0-canary.12

package/dist/cjs/client/sitecore-client.js

@@ -12,6 +12,7 @@ const utils_2 = require("./utils");
 const robots_service_1 = require("../site/robots-service");
 const models_1 = require("../editing/models");
 const editing_1 = require("../editing");
+const { ERROR_MESSAGES } = core_1.constants;
 /**
  * Error page codes
  * @public
@@ -179,7 +180,7 @@ class SitecoreClient {
             mode,
         }, fetchOptions);
         if (!data) {
-            throw new Error(`Unable to fetch editing data for preview ${JSON.stringify(previewData)}`);
+            throw new Error(`Unable to fetch editing data for preview ${JSON.stringify(previewData)}. ${ERROR_MESSAGES.CONTACT_SUPPORT}`);
         }
         let layout = data.layoutData;
         const personalizeData = (0, utils_1.getGroomedVariantIds)(variantIds);
@@ -201,9 +202,6 @@ class SitecoreClient {
      */
     async getDesignLibraryData(designLibData, fetchOptions) {
         var _a;
-        if (!this.initOptions.api.local) {
-            throw new Error('Component Library requires Sitecore apiHost and apiKey to be provided');
-        }
         const { itemId, componentUid, site, language, renderingId, dataSourceId, version, mode, generation, } = designLibData;
         const componentData = await this.componentService.fetchComponentData(Object.assign({ siteName: site, itemId,
             language,
@@ -213,7 +211,7 @@ class SitecoreClient {
             version,
             mode }, (generation ? { generation } : {})), fetchOptions);
         if (!componentData) {
-            throw new Error(`Unable to fetch editing data for preview ${JSON.stringify(designLibData)}`);
+            throw new Error(`Unable to fetch editing data for preview ${JSON.stringify(designLibData)}. ${ERROR_MESSAGES.CONTACT_SUPPORT}`);
         }
         const layout = this.applyContentRewrite(componentData);
         const page = {

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

@@ -5,6 +5,7 @@ exports.deepMerge = deepMerge;
 const core_1 = require("@sitecore-content-sdk/core");
 const tools_1 = require("@sitecore-content-sdk/core/tools");
 const config_cli_1 = require("../config-cli");
+const { ERROR_MESSAGES } = core_1.constants;
 /**
  * Provides default initial values for SitecoreConfig
  * @returns default config
@@ -120,12 +121,12 @@ const validateApiConfiguration = (config) => {
     // Server-side: allow Edge OR Local; clientContextId alone is NOT sufficient
     if (!isBrowser) {
         if (!hasEdgeContextId && !hasLocalCreds) {
-            throw new Error('Configuration error: provide either Edge contextId (api.edge.contextId) or local credentials (api.local.apiHost + api.local.apiKey).');
+            throw new Error(ERROR_MESSAGES.MV_007);
         }
         if (hasEdgeContextId && !hasClientContextId) {
             // eslint-disable-next-line no-console
             if (process.env.NODE_ENV === 'development') {
-                console.warn('Warning: only a server-side edge contextId is provided. Client-side requests will require api.edge.clientContextId or a proxy.');
+                console.warn(ERROR_MESSAGES.MV_006);
             }
         }
         return; // validation complete on the server
@@ -134,8 +135,7 @@ const validateApiConfiguration = (config) => {
     if (isBrowser && !hasClientContextId) {
         // eslint-disable-next-line no-console
         if (process.env.NODE_ENV === 'development') {
-            console.warn(`Warning: clientContextId is missing. The browser will use contextId instead.
-  Client Side functionalities (like Tracking and Personalization) may be limited.`);
+            console.warn(ERROR_MESSAGES.MV_006);
         }
     }
 };

package/dist/cjs/constants.js

@@ -1,10 +1,6 @@
 "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';
+exports.HIDDEN_RENDERING_NAME = void 0;
 /**
  * Hidden rendering name
  * @internal

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

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchGeneratedComponentFromCache = exports.DesignLibraryPreviewError = exports.sendErrorEvent = exports.createComponentInstance = exports.addStyleElement = exports.getImportMapInfo = exports.getDesignLibraryImportMapEvent = exports.getDesignLibraryComponentPropsEvent = exports.getDesignLibraryComponentPreviewErrorEvent = exports.addServerComponentPreviewHandler = exports.addComponentPreviewHandler = void 0;
+exports.fetchGeneratedComponentFromCache = exports.DesignLibraryPreviewError = exports.sendErrorEvent = exports.createComponentInstance = exports.addStyleElement = exports.getImportMapInfo = exports.getDesignLibraryImportMapEvent = exports.getDesignLibraryComponentPropsEvent = exports.getDesignLibraryErrorEvent = 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, "getDesignLibraryErrorEvent", { enumerable: true, get: function () { return preview_1.getDesignLibraryErrorEvent; } });
 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; } });

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

@@ -6,7 +6,7 @@ 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.getDesignLibraryErrorEvent = getDesignLibraryErrorEvent;
 exports.getDesignLibraryComponentPropsEvent = getDesignLibraryComponentPropsEvent;
 exports.getDesignLibraryImportMapEvent = getDesignLibraryImportMapEvent;
 exports.getImportMapInfo = getImportMapInfo;
@@ -15,7 +15,7 @@ exports.fetchGeneratedComponentFromCache = fetchGeneratedComponentFromCache;
 const core_1 = require("@sitecore-content-sdk/core");
 const design_library_1 = require("../design-library");
 const debug_1 = __importDefault(require("../../debug"));
-const { SITECORE_EDGE_PLATFORM_URL_DEFAULT } = core_1.constants;
+const { SITECORE_EDGE_PLATFORM_URL_DEFAULT, ERROR_MESSAGES } = core_1.constants;
 /**
  * Event to send import map to design library
  */
@@ -29,9 +29,13 @@ const DESIGN_LIBRARY_COMPONENT_PROPS_EVENT_NAME = 'component:generation:componen
  */
 const DESIGN_LIBRARY_COMPONENT_PREVIEW_EVENT_NAME = 'component:generation:component-preview';
 /**
- * Event to send component error to design library
+ * Event to send component preview error to design library
  */
 const DESIGN_LIBRARY_COMPONENT_PREVIEW_ERROR_EVENT_NAME = 'component:generation:component-preview-error';
+/**
+ * Event to send general component preview error to design library
+ */
+const DESIGN_LIBRARY_ERROR_EVENT_NAME = 'component:generation:error';
 /**
  * Enumeration of error types for the design library preview.
  * @internal
@@ -46,6 +50,18 @@ var DesignLibraryPreviewError;
      * Error occurred during component and event handlers initialization.
      */
     DesignLibraryPreviewError["RenderInit"] = "render-init";
+    /**
+     * The import map is missing
+     */
+    DesignLibraryPreviewError["ImportMapMissing"] = "import-map-missing";
+    /**
+     * Error during loading of the import map
+     */
+    DesignLibraryPreviewError["ImportMapLoad"] = "import-map-load-error";
+    /**
+     * Error during fetching the generated component data from secured endpoint
+     */
+    DesignLibraryPreviewError["GeneratedComponentFetch"] = "generated-component-fetch-error";
 })(DesignLibraryPreviewError || (exports.DesignLibraryPreviewError = DesignLibraryPreviewError = {}));
 /**
  * Builds the component dependencies from the component imports and the import map.
@@ -192,18 +208,27 @@ const createComponentInstance = (importMap, generatedComponentData) => {
 };
 exports.createComponentInstance = createComponentInstance;
 /**
- * Generates a DesignLibraryComponentPreviewErrorEvent with the given uid and error.
+ * Generates a DesignLibraryErrorEvent depending on the type of error 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.
+ * @returns An object representing the DesignLibraryErrorEvent.
  * @internal
  */
-function getDesignLibraryComponentPreviewErrorEvent(uid, error, type) {
-    return {
-        name: DESIGN_LIBRARY_COMPONENT_PREVIEW_ERROR_EVENT_NAME,
-        message: { uid, error, type },
-    };
+function getDesignLibraryErrorEvent(uid, error, type) {
+    switch (type) {
+        case DesignLibraryPreviewError.Render:
+        case DesignLibraryPreviewError.RenderInit:
+            return {
+                name: DESIGN_LIBRARY_COMPONENT_PREVIEW_ERROR_EVENT_NAME,
+                message: { uid, error, type },
+            };
+        default:
+            return {
+                name: DESIGN_LIBRARY_ERROR_EVENT_NAME,
+                message: { uid, error, type },
+            };
+    }
 }
 /**
  * Generates a DesignLibraryComponentPropsEvent with the given uid, fields and parameters.
@@ -266,15 +291,15 @@ function isImportEntryInfoArray(data) {
         typeof data[0].exports[0] === 'string');
 }
 /**
- * Sends a component preview error event to the design library
+ * Sends a design library 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);
+    const errorEvent = getDesignLibraryErrorEvent(uid, error, type);
+    console.error(`Component Library: sending error event. ${ERROR_MESSAGES.CONTACT_SUPPORT}`, errorEvent);
     if (typeof window !== 'undefined') {
         const target = window.parent && window.parent !== window ? window.parent : window;
         target.postMessage(errorEvent, '*');
@@ -301,5 +326,6 @@ async function fetchGeneratedComponentFromCache(id, token, edgeUrl = SITECORE_ED
     if (componentDataResponse.status !== 200) {
         throw new Error(`Failed to fetch generated component data from cache for id: ${id}. Response Status: ${componentDataResponse.status}, Response Status Text: ${componentDataResponse.statusText}`);
     }
-    return componentDataResponse.data;
+    const generatedComponentData = JSON.parse(componentDataResponse.data.content);
+    return generatedComponentData;
 }

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

@@ -8,6 +8,7 @@ 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 { ERROR_MESSAGES } = core_1.constants;
 /**
  * REST service that enables Design Library functionality.
  * Returns layout data for a single rendered component.
@@ -21,8 +22,7 @@ class ComponentLayoutService {
         // 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.`);
+            throw new Error(ERROR_MESSAGES.MV_001);
         }
         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);

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

@@ -7,6 +7,7 @@ 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 { ERROR_MESSAGES } = core_1.constants;
 /**
  * Event to be sent when report status to design library
  */
@@ -185,7 +186,7 @@ const postToDesignLibrary = (evt) => {
         target.postMessage(evt, '*');
     }
     catch (err) {
-        console.error('Component Library: postMessage failed', err, evt);
+        console.error(`Component Library: postMessage failed. ${ERROR_MESSAGES.CONTACT_SUPPORT}`, err, evt);
     }
 };
 exports.postToDesignLibrary = postToDesignLibrary;

package/dist/cjs/form/form.js

@@ -4,9 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.subscribeToFormSubmitEvent = exports.executeScriptElements = exports.loadForm = void 0;
-const browser_1 = require("@sitecore-cloudsdk/events/browser");
+const events_1 = require("@sitecore-content-sdk/events");
+const core_1 = require("@sitecore-content-sdk/core");
 const client_1 = require("../client");
 const debug_1 = __importDefault(require("../debug"));
+const { ERROR_MESSAGES } = core_1.constants;
 /**
  * Fetches the form markup from the Sitecore Edge service and renders it in the component's template.
  * @param {string} contextId - The unique identifier of the current context
@@ -16,7 +18,7 @@ const debug_1 = __importDefault(require("../debug"));
  */
 const loadForm = async (contextId, formId, edgeUrl) => {
     if (!contextId) {
-        debug_1.default.form('Form was not able to render since context id was not provided');
+        debug_1.default.form(`${ERROR_MESSAGES.MV_001}. Form was not able to render.`);
         return '';
     }
     const url = (0, client_1.getEdgeProxyFormsUrl)(contextId, formId, edgeUrl);
@@ -27,14 +29,14 @@ const loadForm = async (contextId, formId, edgeUrl) => {
             cache: 'no-cache',
         });
         if (rsp.status !== 200) {
-            throw new Error('Failed to fetch form data');
+            throw new Error(`Failed to fetch form data. ${ERROR_MESSAGES.CONTACT_SUPPORT}`);
         }
         const content = await rsp.text();
         debug_1.default.form(`Form data fetch response: ${content}`);
         return content;
     }
     catch (error) {
-        debug_1.default.form(`Form '${formId}' was not able to render`, error);
+        debug_1.default.form(`Form '${formId}' was not able to render. ${ERROR_MESSAGES.CONTACT_SUPPORT}`, error);
         throw error;
     }
 };
@@ -74,7 +76,7 @@ const subscribeToFormSubmitEvent = (formElement, componentId) => {
         const { formId, name } = e.detail;
         if (formId && name) {
             debug_1.default.form('Sending form event', formId, name);
-            (0, browser_1.form)(formId, name, (componentId === null || componentId === void 0 ? void 0 : componentId.replace(/-/g, '')) || '');
+            (0, events_1.form)(formId, name, (componentId === null || componentId === void 0 ? void 0 : componentId.replace(/-/g, '')) || '');
         }
     }));
 };

package/dist/cjs/i18n/dictionary-service.js

@@ -3,12 +3,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DictionaryService = exports.queryError = void 0;
+exports.DictionaryService = void 0;
 const core_1 = require("@sitecore-content-sdk/core");
-const constants_1 = require("../constants");
 const debug_1 = __importDefault(require("../debug"));
-/** @private */
-exports.queryError = 'Valid value for rootItemId not provided and failed to auto-resolve app root item.';
+const { ERROR_MESSAGES } = core_1.constants;
 /** @default */
 const siteQuery = /* GraphQL */ `
   query DictionarySiteQuery(
@@ -71,10 +69,10 @@ class DictionaryService {
         let hasNext = true;
         let after = '';
         if (!site) {
-            throw new RangeError(constants_1.siteNameError);
+            throw new RangeError(ERROR_MESSAGES.MV_002);
         }
         if (!language) {
-            throw new RangeError(constants_1.languageError);
+            throw new RangeError(ERROR_MESSAGES.MV_009);
         }
         while (hasNext) {
             const fetchResponse = await this.graphQLClient.request(siteQuery, {

package/dist/cjs/site/error-pages-service.js

@@ -4,8 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ErrorPagesService = void 0;
+const core_1 = require("@sitecore-content-sdk/core");
 const debug_1 = __importDefault(require("../debug"));
-const constants_1 = require("../constants");
+const { ERROR_MESSAGES } = core_1.constants;
 // The default query for request error handling
 const defaultQuery = /* GraphQL */ `
   query ErrorPagesQuery($siteName: String!, $language: String!) {
@@ -52,7 +53,7 @@ class ErrorPagesService {
     async fetchErrorPages(siteName, locale, fetchOptions) {
         const language = locale || this.options.language;
         if (!siteName) {
-            throw new Error(constants_1.siteNameError);
+            throw new Error(ERROR_MESSAGES.MV_002);
         }
         return this.graphQLClient.request(this.query, {
             siteName,

package/dist/cjs/site/redirects-service.js

@@ -5,8 +5,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RedirectsService = exports.REDIRECT_TYPE_SERVER_TRANSFER = exports.REDIRECT_TYPE_302 = exports.REDIRECT_TYPE_301 = void 0;
 const core_1 = require("@sitecore-content-sdk/core");
-const constants_1 = require("../constants");
 const debug_1 = __importDefault(require("../debug"));
+const { ERROR_MESSAGES } = core_1.constants;
 /**
  * Redirect type for 301 redirects
  * @public
@@ -66,7 +66,7 @@ class RedirectsService {
     async fetchRedirects(siteName, fetchOptions) {
         var _a, _b;
         if (!siteName) {
-            throw new Error(constants_1.siteNameError);
+            throw new Error(ERROR_MESSAGES.MV_002);
         }
         const cacheKey = `redirects-${siteName}`;
         let data = this.cache.getCacheValue(cacheKey);

package/dist/cjs/site/robots-service.js

@@ -4,8 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RobotsService = void 0;
+const core_1 = require("@sitecore-content-sdk/core");
 const debug_1 = __importDefault(require("../debug"));
-const constants_1 = require("../constants");
+const { ERROR_MESSAGES } = core_1.constants;
 // The default query for request robots.txt
 const defaultQuery = /* GraphQL */ `
   query RobotsQuery($siteName: String!) {
@@ -41,7 +42,7 @@ class RobotsService {
     async fetchRobots(fetchOptions) {
         const siteName = this.options.siteName;
         if (!siteName) {
-            throw new Error(constants_1.siteNameError);
+            throw new Error(ERROR_MESSAGES.MV_002);
         }
         const robotsResult = this.graphQLClient.request(this.query, {
             siteName,

package/dist/cjs/site/site-resolver.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SiteResolver = void 0;
+const core_1 = require("@sitecore-content-sdk/core");
+const { ERROR_MESSAGES } = core_1.constants;
 // Delimiters for multi-value hostnames
 const DELIMITERS = /\||,|;/g;
 /**
@@ -25,7 +27,7 @@ class SiteResolver {
                     return site;
                 }
             }
-            throw new Error(`Could not resolve site for host ${hostName}`);
+            throw new Error(ERROR_MESSAGES.IE_007(hostName));
         };
         /**
          * Resolve site by site name

package/dist/cjs/site/sitemap-xml-service.js

@@ -4,8 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SitemapXmlService = void 0;
+const core_1 = require("@sitecore-content-sdk/core");
 const debug_1 = __importDefault(require("../debug"));
-const constants_1 = require("../constants");
+const { ERROR_MESSAGES } = core_1.constants;
 const PREFIX_NAME_SITEMAP = 'sitemap';
 // The default query for request sitemaps
 const defaultQuery = /* GraphQL */ `
@@ -42,7 +43,7 @@ class SitemapXmlService {
     async fetchSitemaps(fetchOptions) {
         const siteName = this.options.siteName;
         if (!siteName) {
-            throw new Error(constants_1.siteNameError);
+            throw new Error(ERROR_MESSAGES.MV_002);
         }
         const sitemapResult = this.graphQLClient.request(this.query, {
             siteName,

package/dist/cjs/site/sitepath-service.js

@@ -3,21 +3,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SitePathService = exports.sitesError = exports.siteError = exports.languageError = void 0;
+exports.SitePathService = exports.sitesError = exports.languageError = void 0;
 exports.getSiteEmptyError = getSiteEmptyError;
+const core_1 = require("@sitecore-content-sdk/core");
 const personalize_1 = require("../personalize");
 const site_1 = require("../site");
 const debug_1 = __importDefault(require("../debug"));
+const { ERROR_MESSAGES } = core_1.constants;
 /** @private */
 exports.languageError = 'The list of languages cannot be empty';
-exports.siteError = 'The service needs a site name';
 exports.sitesError = 'The list of sites cannot be empty';
 /**
  * @param {string} siteName to inject into error text
  * @private
  */
 function getSiteEmptyError(siteName) {
-    return `Site "${siteName}" does not exist or site item tree is missing`;
+    return ERROR_MESSAGES.IV_007(siteName);
 }
 /**
  * GQL query made dynamic based whether personalization is enabled or not
@@ -110,7 +111,7 @@ class SitePathService {
         });
         const paths = new Array();
         if (!languages.length) {
-            throw new RangeError(exports.languageError);
+            throw new RangeError(ERROR_MESSAGES.MV_009);
         }
         // Get all sites
         if (!sites || !sites.length) {

package/dist/cjs/tools/codegen/component-generation.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getComponentSpec = exports.getComponentSpecUrl = void 0;
 const core_1 = require("@sitecore-content-sdk/core");
-const { SITECORE_EDGE_PLATFORM_URL_DEFAULT } = core_1.constants;
+const { SITECORE_EDGE_PLATFORM_URL_DEFAULT, ERROR_MESSAGES } = core_1.constants;
 /**
  * Gets the component spec url.
  * @param {GetComponentSpecParams} params - The parameters for getting the component spec url.
@@ -35,14 +35,14 @@ const getComponentSpec = async ({ componentId, edgeUrl = SITECORE_EDGE_PLATFORM_
             throw new Error('The token is incorrect or expired or the component ID is incorrect.');
         }
         if (!response.ok) {
-            throw new Error(`Failed to fetch component ${componentId}`);
+            throw new Error(`Failed to fetch component ${componentId}. ${ERROR_MESSAGES.CONTACT_SUPPORT}`);
         }
         const spec = await response.json();
         core_1.debug.common('Component spec fetched successfully for %s: %o', componentId, spec);
         return spec;
     }
     catch (error) {
-        core_1.debug.common('Failed to fetch component spec: %s', String(error));
+        core_1.debug.common(`Failed to fetch component spec: ${String(error)}. ${ERROR_MESSAGES.CONTACT_SUPPORT}`);
         throw error;
     }
 };

package/dist/cjs/tools/codegen/extract-files.js

@@ -7,10 +7,11 @@ exports.unitMocks = exports.extractFiles = void 0;
 /* eslint-disable jsdoc/require-jsdoc */
 const chalk_1 = __importDefault(require("chalk"));
 const utils_1 = require("./utils");
-const tools_1 = require("@sitecore-content-sdk/core/tools");
+const node_tools_1 = require("@sitecore-content-sdk/core/node-tools");
 const core_1 = require("@sitecore-content-sdk/core");
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
+const { ERROR_MESSAGES } = core_1.constants;
 /**
  * Extracts components from the app folder and sends them to XMCloud.
  * @param {ExtractFilesConfig} args - Config for components extraction
@@ -38,7 +39,7 @@ function _extractFiles(args = {}) {
     const renderingHost = process.env.SITECORE_RENDERINGHOST_NAME;
     return async ({ scConfig }) => {
         if (!scConfig) {
-            throw new Error('Sitecore configuration is required to be provided');
+            throw new Error(ERROR_MESSAGES.MV_008);
         }
         if ((args.customValidateDeployContext && !args.customValidateDeployContext()) ||
             !(0, utils_1.validateDeployContext)()) {
@@ -54,9 +55,9 @@ function _extractFiles(args = {}) {
         try {
             // Use Edge Platform mesh endpoint - staging is ready, prod QA in progress
             const targetUrl = scConfig.api.edge.edgeUrl;
-            const { accessToken } = await tools_1.auth.clientCredentialsFlow(authParams);
+            const { accessToken } = await node_tools_1.auth.clientCredentialsFlow(authParams);
             if (!accessToken) {
-                console.error(chalk_1.default.red('Failed to get access token, aborting code extraction'));
+                console.error(chalk_1.default.red(`Failed to get access token, aborting code extraction. ${ERROR_MESSAGES.CONTACT_SUPPORT}`));
                 return;
             }
             // Resolve files from component-map
@@ -97,7 +98,7 @@ function _extractFiles(args = {}) {
                 .join('\r\n')}`));
         }
         catch (error) {
-            console.warn(chalk_1.default.yellow('Error during code extraction:', error, error.stack));
+            console.warn(chalk_1.default.yellow(`Error during code extraction:`, error, error.stack, ERROR_MESSAGES.CONTACT_SUPPORT));
         }
     };
 }

package/dist/cjs/tools/codegen/import-map.js

@@ -44,6 +44,8 @@ const core_1 = require("@sitecore-content-sdk/core");
 const templating_1 = require("./../templating");
 const crypto_1 = __importDefault(require("crypto"));
 const utils_1 = require("./utils");
+const core_2 = require("@sitecore-content-sdk/core");
+const { ERROR_MESSAGES } = core_2.constants;
 let _getComponentList = templating_1.getComponentList;
 const aliasImport = /^([a-zA-Z0-9]+) as .+$/;
 const unitMocks = ({ getComponentListStub, }) => {
@@ -252,19 +254,11 @@ const prepImportMaps = async (paths, separateMaps) => {
             ? componentPath
             : path_1.default.resolve(appPath, componentPath);
         // read the start of the file that may be 'use client'
-        const firstLine = await new Promise((resolve) => {
-            let readBuffer = '';
-            const stream = fs_1.default.createReadStream(fullPath, { end: 12 });
-            stream
-                .on('data', async (chunk) => {
-                readBuffer += chunk.toString();
-            })
-                .on('close', () => resolve(readBuffer))
-                .on('error', () => resolve(''));
-        });
-        if (!firstLine)
+        const fileContent = await fs_1.default.promises.readFile(fullPath, 'utf8');
+        if (!fileContent)
             continue;
-        if (firstLine.match(/['"]use client['"]/)) {
+        // check if 'use client' directive is present, ignoring any comments or whitespace before it
+        if (fileContent.match(/^(?:\s|\/\/[^\n]*\n|\/\*[^*]*\*+(?:[^\/*][^*]*\*+)*\/)*['"]use client['"]/)) {
             clientPaths.push(fullPath);
         }
         else {
@@ -286,7 +280,7 @@ const writeImportMap = (args) => {
         const defaultTemplate = args.defaultTemplate || exports.defaultMapTemplate;
         const clientTemplate = args.clientTemplate || exports.defaultMapTemplate;
         if (!scConfig) {
-            throw new Error('Sitecore configuration is required to be provided');
+            throw new Error(ERROR_MESSAGES.MV_008);
         }
         if (scConfig.disableCodeGeneration) {
             core_1.debug.common('Skipping import map generation. Code generation functionality is disabled.');

package/dist/cjs/tools/codegen/utils.js

@@ -46,6 +46,7 @@ const fs_1 = __importDefault(require("fs"));
 const ts = __importStar(require("typescript"));
 const core_1 = require("@sitecore-content-sdk/core");
 const module_1 = require("module");
+const { ERROR_MESSAGES } = core_1.constants;
 /**
  * Parse the generated component-map file and return all referenced modules
  * per map entry (handles both single identifiers and spread objects).
@@ -384,7 +385,7 @@ async function _sendCode({ file, token, targetUrl, }) {
         }
     }
     catch (error) {
-        console.error(chalk_1.default.red(`Fetch request to send extracted code from ${file.path} failed: ${JSON.stringify(error)}`));
+        console.error(chalk_1.default.red(`Fetch request to send extracted code from ${file.path} failed: ${JSON.stringify(error)}. ${ERROR_MESSAGES.CONTACT_SUPPORT}`));
         return null;
     }
     return file.path;

package/dist/cjs/tools/generateSites.js

@@ -7,10 +7,12 @@ exports.generateSites = void 0;
 const path_1 = __importDefault(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 const fs_1 = __importDefault(require("fs"));
-const tools_1 = require("@sitecore-content-sdk/core/tools");
+const node_tools_1 = require("@sitecore-content-sdk/core/node-tools");
+const core_1 = require("@sitecore-content-sdk/core");
 const site_1 = require("../site");
 const client_1 = require("../client");
 const debug_1 = __importDefault(require("../debug"));
+const { ERROR_MESSAGES } = core_1.constants;
 const DEFAULT_SITES_DIST_PATH = '.sitecore/sites.json';
 /**
  * Generates site information and writes it to a specified destination path.
@@ -21,7 +23,7 @@ const DEFAULT_SITES_DIST_PATH = '.sitecore/sites.json';
 const generateSites = ({ destinationPath } = {}) => {
     return async ({ scConfig }) => {
         if (!scConfig) {
-            throw new Error('Sitecore configuration is required to be provided');
+            throw new Error(ERROR_MESSAGES.MV_008);
         }
         let sites = [];
         const sitesFilePath = path_1.default.resolve(destinationPath !== null && destinationPath !== void 0 ? destinationPath : DEFAULT_SITES_DIST_PATH);
@@ -40,7 +42,7 @@ const generateSites = ({ destinationPath } = {}) => {
                 sites = await siteInfoService.fetchSiteInfo();
             }
             catch (error) {
-                console.error(chalk_1.default.red('Error fetching site information'));
+                console.error(chalk_1.default.red(`Failed to fetch site information. ${ERROR_MESSAGES.CONTACT_SUPPORT}`));
                 throw error;
             }
         }
@@ -51,7 +53,7 @@ const generateSites = ({ destinationPath } = {}) => {
             language: scConfig.defaultLanguage,
         };
         sites.unshift(defaultSite);
-        (0, tools_1.ensurePathExists)(sitesFilePath);
+        (0, node_tools_1.ensurePathExists)(sitesFilePath);
         fs_1.default.writeFileSync(sitesFilePath, JSON.stringify(sites, null, 2), { encoding: 'utf8' });
     };
 };