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

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

@@ -0,0 +1,144 @@
+"use strict";
+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;
+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.';
+/** @default */
+const siteQuery = /* GraphQL */ `
+  query DictionarySiteQuery(
+    $siteName: String!
+    $language: String!
+    $pageSize: Int = 500
+    $after: String
+  ) {
+    site {
+      siteInfo(site: $siteName) {
+        dictionary(language: $language, first: $pageSize, after: $after) {
+          pageInfo {
+            endCursor
+            hasNext
+          }
+          results {
+            key
+            value
+          }
+        }
+      }
+    }
+  }
+`;
+/**
+ * Service that fetch dictionary data using Sitecore's GraphQL API.
+ * @augments DictionaryServiceBase
+ * @mixes SearchQueryService<DictionaryQueryResult>
+ * @public
+ */
+class DictionaryService {
+    /**
+     * Creates an instance of graphQL dictionary service with the provided options
+     * @param {DictionaryService} options instance
+     */
+    constructor(options) {
+        this.options = options;
+        this.cache = this.getCacheClient();
+        this.graphQLClient = this.getGraphQLClient();
+    }
+    /**
+     * Fetches dictionary data for internalization. Uses search query by default
+     * @param {string} language the language to fetch
+     * @param {string} site site name to fetch data for.
+     * @param {FetchOptions} [fetchOptions] Options to override graphQL client details like retries and fetch implementation
+     * @returns {Promise<DictionaryPhrases>} dictionary phrases
+     * @throws {Error} if the app root was not found for the specified site and language.
+     */
+    async fetchDictionaryData(language, site, fetchOptions) {
+        var _a, _b;
+        const cacheKey = site + language;
+        const cachedValue = this.getCacheValue(cacheKey);
+        if (cachedValue) {
+            debug_1.default.dictionary('using cached dictionary data for %s %s', language, site);
+            return cachedValue;
+        }
+        const phrases = {};
+        debug_1.default.dictionary('fetching dictionary data for %s %s', language, site);
+        let results = [];
+        let hasNext = true;
+        let after = '';
+        if (!site) {
+            throw new RangeError(constants_1.siteNameError);
+        }
+        if (!language) {
+            throw new RangeError(constants_1.languageError);
+        }
+        while (hasNext) {
+            const fetchResponse = await this.graphQLClient.request(siteQuery, {
+                siteName: site,
+                language,
+                pageSize: this.options.pageSize,
+                after,
+            }, fetchOptions);
+            if ((_b = (_a = fetchResponse === null || fetchResponse === void 0 ? void 0 : fetchResponse.site) === null || _a === void 0 ? void 0 : _a.siteInfo) === null || _b === void 0 ? void 0 : _b.dictionary) {
+                results = results.concat(fetchResponse.site.siteInfo.dictionary.results);
+                after = fetchResponse.site.siteInfo.dictionary.pageInfo.endCursor;
+                hasNext = fetchResponse.site.siteInfo.dictionary.pageInfo.hasNext;
+            }
+            else {
+                hasNext = false;
+            }
+        }
+        results.forEach((item) => (phrases[item.key] = item.value));
+        this.setCacheValue(cacheKey, phrases);
+        return phrases;
+    }
+    /**
+     * Caches a @see DictionaryPhrases value for the specified cache key.
+     * @param {string} key The cache key.
+     * @param {DictionaryPhrases} value The value to cache.
+     * @returns The value added to the cache.
+     * @mixes CacheClient<DictionaryPhrases>
+     */
+    setCacheValue(key, value) {
+        return this.cache.setCacheValue(key, value);
+    }
+    /**
+     * Retrieves a @see DictionaryPhrases value from the cache.
+     * @param {string} key The cache key.
+     * @returns The @see DictionaryPhrases value, or null if the specified key is not found in the cache.
+     */
+    getCacheValue(key) {
+        return this.cache.getCacheValue(key);
+    }
+    /**
+     * Gets a cache client that can cache data. Uses memory-cache as the default
+     * library for caching (@see MemoryCacheClient). Override this method if you
+     * want to use something else.
+     * @returns {CacheClient} implementation
+     */
+    getCacheClient() {
+        return new core_1.MemoryCacheClient(this.options);
+    }
+    /**
+     * Gets a GraphQL client that can make requests to the API. Uses graphql-request as the default
+     * library for fetching graphql data (@see GraphQLRequestClient). Override this method if you
+     * want to use something else.
+     * @returns {GraphQLClient} implementation
+     */
+    getGraphQLClient() {
+        var _a, _b;
+        if (!this.options.clientFactory) {
+            throw new Error('clientFactory needs to be provided when initializing GraphQL client.');
+        }
+        return this.options.clientFactory({
+            debugger: debug_1.default.dictionary,
+            retries: (_a = this.options.retries) === null || _a === void 0 ? void 0 : _a.count,
+            retryStrategy: (_b = this.options.retries) === null || _b === void 0 ? void 0 : _b.retryStrategy,
+        });
+    }
+}
+exports.DictionaryService = DictionaryService;

package/dist/cjs/i18n/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLocaleRewrite = exports.DictionaryService = void 0;
+var dictionary_service_1 = require("./dictionary-service");
+Object.defineProperty(exports, "DictionaryService", { enumerable: true, get: function () { return dictionary_service_1.DictionaryService; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "getLocaleRewrite", { enumerable: true, get: function () { return utils_1.getLocaleRewrite; } });

package/dist/cjs/i18n/utils.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLocaleRewrite = getLocaleRewrite;
+/**
+ * Get a locale rewrite path for given pathname
+ * @param {string} pathname the pathname
+ * @param {string} locale the site data to include in the rewrite
+ * @returns {string} the rewrite path
+ * @public
+ */
+function getLocaleRewrite(pathname, locale) {
+    if (pathname === '/')
+        return `/${locale}`;
+    const path = pathname.startsWith('/') ? pathname : '/' + pathname;
+    return `/${locale}${path}`;
+}

package/dist/cjs/index.js

@@ -0,0 +1,47 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HIDDEN_RENDERING_NAME = exports.defineConfig = exports.form = exports.debug = void 0;
+const form = __importStar(require("./form"));
+exports.form = form;
+var debug_1 = require("./debug");
+Object.defineProperty(exports, "debug", { enumerable: true, get: function () { return __importDefault(debug_1).default; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return config_1.defineConfig; } });
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "HIDDEN_RENDERING_NAME", { enumerable: true, get: function () { return constants_1.HIDDEN_RENDERING_NAME; } });

package/dist/cjs/layout/content-styles.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traverseComponent = exports.traverseField = exports.traversePlaceholder = exports.getContentStylesheetUrl = exports.getContentStylesheetLink = void 0;
+const core_1 = require("@sitecore-content-sdk/core");
+const tools_1 = require("@sitecore-content-sdk/core/tools");
+/**
+ * Regular expression to check if the content styles are used in the field value
+ */
+const CLASS_REGEXP = /class=".*(\bck-content\b).*"/g;
+/**
+ * Get the content styles link to be loaded from the Sitecore Edge Platform
+ * @param {LayoutServiceData} layoutData Layout service data
+ * @param {string} sitecoreEdgeContextId Sitecore Edge Context ID
+ * @param {string} [sitecoreEdgeUrl] Sitecore Edge Platform URL (resolved at config level). Defaults to platform URL.
+ * @returns {HTMLLink | null} content styles link, null if no styles are used in layout
+ * @public
+ */
+const getContentStylesheetLink = (layoutData, sitecoreEdgeContextId, sitecoreEdgeUrl = core_1.constants.SITECORE_EDGE_PLATFORM_URL_DEFAULT) => {
+    if (!layoutData.sitecore.route)
+        return null;
+    const config = { loadStyles: false };
+    (0, exports.traverseComponent)(layoutData.sitecore.route, config);
+    if (!config.loadStyles)
+        return null;
+    return {
+        href: (0, exports.getContentStylesheetUrl)(sitecoreEdgeContextId, sitecoreEdgeUrl),
+        rel: 'stylesheet',
+    };
+};
+exports.getContentStylesheetLink = getContentStylesheetLink;
+const getContentStylesheetUrl = (sitecoreEdgeContextId, sitecoreEdgeUrl = core_1.constants.SITECORE_EDGE_PLATFORM_URL_DEFAULT) => `${(0, tools_1.normalizeUrl)(sitecoreEdgeUrl)}/v1/files/pages/styles/content-styles.css?sitecoreContextId=${sitecoreEdgeContextId}`;
+exports.getContentStylesheetUrl = getContentStylesheetUrl;
+const traversePlaceholder = (components, config) => {
+    if (config.loadStyles)
+        return;
+    components.forEach((component) => {
+        (0, exports.traverseComponent)(component, config);
+    });
+};
+exports.traversePlaceholder = traversePlaceholder;
+const traverseField = (field, config) => {
+    if (!field || typeof field !== 'object' || config.loadStyles)
+        return;
+    if ('value' in field && typeof field.value === 'string') {
+        config.loadStyles = CLASS_REGEXP.test(field.value);
+    }
+    else if ('fields' in field) {
+        Object.values(field.fields).forEach((field) => {
+            (0, exports.traverseField)(field, config);
+        });
+    }
+    else if (Array.isArray(field)) {
+        field.forEach((field) => {
+            (0, exports.traverseField)(field, config);
+        });
+    }
+};
+exports.traverseField = traverseField;
+const traverseComponent = (component, config) => {
+    if (config.loadStyles)
+        return;
+    if ('fields' in component && component.fields) {
+        Object.values(component.fields).forEach((field) => {
+            (0, exports.traverseField)(field, config);
+        });
+    }
+    const placeholders = component.placeholders || {};
+    Object.keys(placeholders).forEach((placeholder) => {
+        (0, exports.traversePlaceholder)(placeholders[placeholder], config);
+    });
+};
+exports.traverseComponent = traverseComponent;

package/dist/cjs/layout/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyMediaUrlRewrite = exports.getDefaultMediaUrlTransformer = exports.containsDefaultEdgeHost = exports.rewriteEdgeHostInResponse = exports.getDesignLibraryStylesheetLinks = exports.GRAPHQL_LAYOUT_QUERY_NAME = exports.LayoutService = exports.getContentStylesheetLink = exports.EMPTY_DATE_FIELD_VALUE = exports.getDynamicPlaceholderPattern = exports.isDynamicPlaceholder = exports.isFieldValueEmpty = exports.getChildPlaceholder = exports.getFieldValue = exports.EDITING_COMPONENT_ID = exports.EDITING_COMPONENT_PLACEHOLDER = exports.RenderingType = exports.EditMode = exports.LayoutServicePageState = void 0;
+// layout
+var models_1 = require("./models");
+Object.defineProperty(exports, "LayoutServicePageState", { enumerable: true, get: function () { return models_1.LayoutServicePageState; } });
+Object.defineProperty(exports, "EditMode", { enumerable: true, get: function () { return models_1.EditMode; } });
+Object.defineProperty(exports, "RenderingType", { enumerable: true, get: function () { return models_1.RenderingType; } });
+Object.defineProperty(exports, "EDITING_COMPONENT_PLACEHOLDER", { enumerable: true, get: function () { return models_1.EDITING_COMPONENT_PLACEHOLDER; } });
+Object.defineProperty(exports, "EDITING_COMPONENT_ID", { enumerable: true, get: function () { return models_1.EDITING_COMPONENT_ID; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "getFieldValue", { enumerable: true, get: function () { return utils_1.getFieldValue; } });
+Object.defineProperty(exports, "getChildPlaceholder", { enumerable: true, get: function () { return utils_1.getChildPlaceholder; } });
+Object.defineProperty(exports, "isFieldValueEmpty", { enumerable: true, get: function () { return utils_1.isFieldValueEmpty; } });
+Object.defineProperty(exports, "isDynamicPlaceholder", { enumerable: true, get: function () { return utils_1.isDynamicPlaceholder; } });
+Object.defineProperty(exports, "getDynamicPlaceholderPattern", { enumerable: true, get: function () { return utils_1.getDynamicPlaceholderPattern; } });
+Object.defineProperty(exports, "EMPTY_DATE_FIELD_VALUE", { enumerable: true, get: function () { return utils_1.EMPTY_DATE_FIELD_VALUE; } });
+var content_styles_1 = require("./content-styles");
+Object.defineProperty(exports, "getContentStylesheetLink", { enumerable: true, get: function () { return content_styles_1.getContentStylesheetLink; } });
+var layout_service_1 = require("./layout-service");
+Object.defineProperty(exports, "LayoutService", { enumerable: true, get: function () { return layout_service_1.LayoutService; } });
+Object.defineProperty(exports, "GRAPHQL_LAYOUT_QUERY_NAME", { enumerable: true, get: function () { return layout_service_1.GRAPHQL_LAYOUT_QUERY_NAME; } });
+var themes_1 = require("./themes");
+Object.defineProperty(exports, "getDesignLibraryStylesheetLinks", { enumerable: true, get: function () { return themes_1.getDesignLibraryStylesheetLinks; } });
+var rewrite_edge_host_1 = require("./rewrite-edge-host");
+Object.defineProperty(exports, "rewriteEdgeHostInResponse", { enumerable: true, get: function () { return rewrite_edge_host_1.rewriteEdgeHostInResponse; } });
+Object.defineProperty(exports, "containsDefaultEdgeHost", { enumerable: true, get: function () { return rewrite_edge_host_1.containsDefaultEdgeHost; } });
+Object.defineProperty(exports, "getDefaultMediaUrlTransformer", { enumerable: true, get: function () { return rewrite_edge_host_1.getDefaultMediaUrlTransformer; } });
+Object.defineProperty(exports, "applyMediaUrlRewrite", { enumerable: true, get: function () { return rewrite_edge_host_1.applyMediaUrlRewrite; } });

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

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LayoutService = exports.GRAPHQL_LAYOUT_QUERY_NAME = void 0;
+const sitecore_service_base_1 = require("../sitecore-service-base");
+const debug_1 = __importDefault(require("../debug"));
+/**
+ * GraphQL layout query name
+ * @internal
+ */
+exports.GRAPHQL_LAYOUT_QUERY_NAME = 'ContentSdkLayoutQuery';
+/**
+ * Service that fetch layout data using Sitecore's GraphQL API.
+ * @augments LayoutServiceBase
+ * @mixes GraphQLRequestClient
+ * @public
+ */
+class LayoutService extends sitecore_service_base_1.SitecoreServiceBase {
+    /**
+     * Fetch layout data using the Sitecore GraphQL endpoint.
+     * @param {LayoutServiceConfig} serviceConfig configuration
+     */
+    constructor(serviceConfig) {
+        super(serviceConfig);
+        this.serviceConfig = serviceConfig;
+    }
+    /**
+     * Fetch layout data for an item.
+     * @param {string} itemPath item path to fetch layout data for.
+     * @param {RouteOptions} [routeOptions] Request options like language and site to retrieve data for
+     * @param {FetchOptions} [fetchOptions] Options to override graphQL client details like retries and fetch implementation
+     * @returns {Promise<LayoutServiceData>} layout service data
+     */
+    async fetchLayoutData(itemPath, routeOptions, fetchOptions) {
+        var _a, _b;
+        const site = routeOptions.site;
+        const query = this.getLayoutQuery(itemPath, site, routeOptions === null || routeOptions === void 0 ? void 0 : routeOptions.locale);
+        debug_1.default.layout('fetching layout data for %s %s %s', itemPath, routeOptions === null || routeOptions === void 0 ? void 0 : routeOptions.locale, site);
+        const data = await this.graphQLClient.request(query, {}, fetchOptions);
+        // If `rendered` is empty -> not found
+        const layoutData = ((_b = (_a = data === null || data === void 0 ? void 0 : data.layout) === null || _a === void 0 ? void 0 : _a.item) === null || _b === void 0 ? void 0 : _b.rendered) || {
+            sitecore: { context: { pageEditing: false, language: routeOptions === null || routeOptions === void 0 ? void 0 : routeOptions.locale }, route: null },
+        };
+        return layoutData;
+    }
+    /**
+     * Returns GraphQL Layout query
+     * @param {string} itemPath page route
+     * @param {string} [site] site name
+     * @param {string} [language] language
+     * @returns {string} GraphQL query
+     */
+    getLayoutQuery(itemPath, site, language) {
+        const languageVariable = language ? `, language:"${language}"` : '';
+        const layoutQuery = this.serviceConfig.formatLayoutQuery
+            ? this.serviceConfig.formatLayoutQuery(site, itemPath, language)
+            : `layout(site:"${site}", routePath:"${itemPath}"${languageVariable})`;
+        return `query ${exports.GRAPHQL_LAYOUT_QUERY_NAME} {
+      ${layoutQuery}{
+        item {
+          rendered
+        }
+      }
+    }`;
+    }
+}
+exports.LayoutService = LayoutService;

package/dist/cjs/layout/models.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EDITING_COMPONENT_ID = exports.EDITING_COMPONENT_PLACEHOLDER = exports.RenderingType = exports.EditMode = exports.LayoutServicePageState = void 0;
+/**
+ * Layout Service page state enum
+ * @public
+ */
+var LayoutServicePageState;
+(function (LayoutServicePageState) {
+    LayoutServicePageState["Preview"] = "preview";
+    LayoutServicePageState["Edit"] = "edit";
+    LayoutServicePageState["Normal"] = "normal";
+})(LayoutServicePageState || (exports.LayoutServicePageState = LayoutServicePageState = {}));
+/**
+ * Represents the edit mode for rendering content in Sitecore Editors
+ * @public
+ */
+var EditMode;
+(function (EditMode) {
+    EditMode["Metadata"] = "metadata";
+})(EditMode || (exports.EditMode = EditMode = {}));
+/**
+ * Editing rendering type
+ * @public
+ */
+var RenderingType;
+(function (RenderingType) {
+    RenderingType["Component"] = "component";
+})(RenderingType || (exports.RenderingType = RenderingType = {}));
+/**
+ * Static placeholder name used for component rendering
+ * @internal
+ */
+exports.EDITING_COMPONENT_PLACEHOLDER = 'editing-componentmode-placeholder';
+/**
+ * Id of wrapper for component rendering
+ * @internal
+ */
+exports.EDITING_COMPONENT_ID = 'editing-component';

package/dist/cjs/layout/rewrite-edge-host.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rewriteEdgeHostInResponse = rewriteEdgeHostInResponse;
+exports.getDefaultMediaUrlTransformer = getDefaultMediaUrlTransformer;
+exports.applyMediaUrlRewrite = applyMediaUrlRewrite;
+exports.containsDefaultEdgeHost = containsDefaultEdgeHost;
+const core_1 = require("@sitecore-content-sdk/core");
+const tools_1 = require("@sitecore-content-sdk/core/tools");
+/** Default Edge hostname derived from the default Edge URL (edge.sitecorecloud.io). @internal */
+const DEFAULT_EDGE_HOSTNAME = new URL(core_1.constants.SITECORE_EXPERIENCE_EDGE_URL_DEFAULT).hostname;
+/**
+ * Returns true if the given URL has a custom (non-default) Edge hostname.
+ * @param {string} url - Full URL or hostname
+ * @returns {boolean} True if URL host is not the default Edge hostname
+ * @internal
+ */
+function isCustomEdgeUrl(url) {
+    try {
+        const u = url.startsWith('http') ? new URL(url) : new URL(`https://${url}`);
+        const host = u.hostname.toLowerCase();
+        return host !== DEFAULT_EDGE_HOSTNAME;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Regular expression for matching the default Edge hostname in URLs.
+ * Matches both http:// and https:// protocols.
+ * @internal
+ */
+const EDGE_HOST_PATTERN = new RegExp(`https?://${escapeRegExp(DEFAULT_EDGE_HOSTNAME)}`, 'gi');
+/**
+ * Escapes a string so it can be safely embedded in a RegExp as a literal.
+ * @param {string} input - The string to escape
+ * @returns {string} The escaped string safe for RegExp construction
+ * @internal
+ */
+function escapeRegExp(input) {
+    return input.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Rewrites Experience Edge hostnames in a response object to use the custom hostname.
+ * This function performs a deep traversal of the object and replaces any string values
+ * containing the default Experience Edge hostname with the custom hostname.
+ * Caller should pass the Experience Edge URL (e.g. from resolveExperienceEdgeUrl()).
+ *
+ * Use case: Experience Edge returns Layout Service output (layout, placeholders, component fields).
+ * Field values can contain URLs with the Edge hostname—e.g. Image field `value.src`
+ * (`https://edge.sitecorecloud.io/-/media/...`), Rich Text HTML (`<img src="...">`),
+ * or link `href`. When using a custom hostname (e.g. CDN in front of Edge), these URLs
+ * must be rewritten so layout API and media requests both go through the custom host.
+ * @param {T} response - The response object to process (typically LayoutServiceData)
+ * @param {string} edgeUrl - Experience Edge URL to rewrite to (e.g. from resolveExperienceEdgeUrl).
+ * @returns {T} The response object with Experience Edge hostnames rewritten (same reference if no custom hostname)
+ * @public
+ * @example
+ * const layout = await layoutService.fetchLayoutData(path, options);
+ * const rewritten = rewriteEdgeHostInResponse(layout, resolveExperienceEdgeUrl());
+ */
+function rewriteEdgeHostInResponse(response, edgeUrl) {
+    const customEdgeUrl = (0, tools_1.normalizeUrl)(edgeUrl);
+    if (!isCustomEdgeUrl(customEdgeUrl)) {
+        return response;
+    }
+    return deepRewriteEdgeHost(response, customEdgeUrl);
+}
+/**
+ * Recursively traverses an object/array and rewrites Edge hostnames in string values.
+ * @param {T} value - The value to process
+ * @param {string} customEdgeUrl - The custom Edge URL to replace with
+ * @returns {T} The processed value with Edge hostnames replaced
+ * @internal
+ */
+function deepRewriteEdgeHost(value, customEdgeUrl) {
+    // Handle null/undefined
+    if (value === null || value === undefined) {
+        return value;
+    }
+    // Handle strings - perform the actual replacement
+    if (typeof value === 'string') {
+        return rewriteEdgeHostInString(value, customEdgeUrl);
+    }
+    // Handle arrays
+    if (Array.isArray(value)) {
+        return value.map((item) => deepRewriteEdgeHost(item, customEdgeUrl));
+    }
+    // Handle plain objects
+    if (typeof value === 'object') {
+        // Skip non-plain objects (Date, RegExp, etc.)
+        if (Object.getPrototypeOf(value) !== Object.prototype) {
+            return value;
+        }
+        const result = {};
+        for (const key of Object.keys(value)) {
+            result[key] = deepRewriteEdgeHost(value[key], customEdgeUrl);
+        }
+        return result;
+    }
+    // Return primitives (numbers, booleans) unchanged
+    return value;
+}
+/**
+ * Replaces Experience Edge hostnames in a string with the custom hostname.
+ * @param {string} str - The string to process
+ * @param {string} customEdgeUrl - The custom Experience Edge URL to replace with
+ * @returns {string} The string with Experience Edge hostnames replaced
+ * @internal
+ */
+function rewriteEdgeHostInString(str, customEdgeUrl) {
+    EDGE_HOST_PATTERN.lastIndex = 0;
+    return str.replace(EDGE_HOST_PATTERN, customEdgeUrl);
+}
+/**
+ * Returns the default media URL transformer: rewrites Experience Edge hostnames when custom hostname is configured.
+ * @param {string} edgeUrl - Experience Edge URL to rewrite to (e.g. from resolveExperienceEdgeUrl()).
+ * @returns {(value: string) => string} Transformer function; returns string unchanged when no custom hostname
+ * @internal
+ */
+function getDefaultMediaUrlTransformer(edgeUrl) {
+    const customEdgeUrl = (0, tools_1.normalizeUrl)(edgeUrl);
+    if (!isCustomEdgeUrl(customEdgeUrl)) {
+        return (s) => s;
+    }
+    return (s) => rewriteEdgeHostInString(s, customEdgeUrl);
+}
+/**
+ * Deeply traverses a value and applies a string transformer to every string.
+ * @param {T} value - Value to process (layout, object, array, string)
+ * @param {(s: string) => string} transform - Function that transforms each string
+ * @returns {T} New value with transformed strings
+ * @internal
+ */
+function applyMediaUrlRewrite(value, transform) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return transform(value);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => applyMediaUrlRewrite(item, transform));
+    }
+    if (typeof value === 'object' && Object.getPrototypeOf(value) === Object.prototype) {
+        const result = {};
+        for (const key of Object.keys(value)) {
+            result[key] = applyMediaUrlRewrite(value[key], transform);
+        }
+        return result;
+    }
+    return value;
+}
+/**
+ * Checks if a string contains the default Edge hostname (from the default Edge URL).
+ * @param {string} str - The string to check
+ * @returns {boolean} True if the string contains the default Edge hostname
+ * @public
+ */
+function containsDefaultEdgeHost(str) {
+    return str.includes(DEFAULT_EDGE_HOSTNAME);
+}

package/dist/cjs/layout/themes.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStylesheetUrl = void 0;
+exports.getDesignLibraryStylesheetLinks = getDesignLibraryStylesheetLinks;
+const core_1 = require("@sitecore-content-sdk/core");
+const tools_1 = require("@sitecore-content-sdk/core/tools");
+const _1 = require(".");
+/**
+ * Pattern for library ids
+ * @example -library--foo
+ */
+const STYLES_LIBRARY_ID_REGEX = /-library--([^\s]+)/;
+/**
+ * Walks through rendering tree and returns list of links of all FEAAS, BYOC or SXA Design Library Stylesheets that are used
+ * @param {LayoutServiceData} layoutData Layout service data
+ * @param {string} sitecoreEdgeContextId Sitecore Edge Context ID
+ * @param {string} [sitecoreEdgeUrl] Sitecore Edge Platform URL (resolved at config level). Defaults to platform URL.
+ * @returns {HTMLLink[]} library stylesheet links
+ * @public
+ */
+function getDesignLibraryStylesheetLinks(layoutData, sitecoreEdgeContextId, sitecoreEdgeUrl = core_1.constants.SITECORE_EDGE_PLATFORM_URL_DEFAULT) {
+    const ids = new Set();
+    if (!layoutData.sitecore.route)
+        return [];
+    traverseComponent(layoutData.sitecore.route, ids);
+    return [...ids].map((id) => ({
+        href: (0, exports.getStylesheetUrl)(id, sitecoreEdgeContextId, sitecoreEdgeUrl),
+        rel: 'stylesheet',
+    }));
+}
+const getStylesheetUrl = (id, sitecoreEdgeContextId, sitecoreEdgeUrl = core_1.constants.SITECORE_EDGE_PLATFORM_URL_DEFAULT) => `${(0, tools_1.normalizeUrl)(sitecoreEdgeUrl)}/v1/files/components/styles/${id}.css?sitecoreContextId=${sitecoreEdgeContextId}`;
+exports.getStylesheetUrl = getStylesheetUrl;
+/**
+ * Traverse placeholder and components to add library ids
+ * @param {ComponentRendering[]} components
+ * @param {Set<string>} ids library ids
+ */
+const traversePlaceholder = (components, ids) => {
+    components.map((component) => {
+        return traverseComponent(component, ids);
+    });
+};
+/**
+ * Traverse component and children to add library ids
+ * @param {RouteData | ComponentRendering | HtmlElementRendering} component component data
+ * @param {Set<string>} ids library ids
+ */
+const traverseComponent = (component, ids) => {
+    var _a, _b, _c, _d, _e, _f;
+    let libraryId = undefined;
+    if ('params' in component && component.params) {
+        // LibraryID in css class name takes precedence over LibraryId attribute
+        libraryId =
+            ((_b = (_a = component.params.CSSStyles) === null || _a === void 0 ? void 0 : _a.match(STYLES_LIBRARY_ID_REGEX)) === null || _b === void 0 ? void 0 : _b[1]) ||
+                ((_d = (_c = component.params.Styles) === null || _c === void 0 ? void 0 : _c.match(STYLES_LIBRARY_ID_REGEX)) === null || _d === void 0 ? void 0 : _d[1]) ||
+                component.params.LibraryId ||
+                undefined;
+    }
+    // if params are empty we try to fall back to data source
+    if (!libraryId && 'fields' in component && component.fields) {
+        libraryId =
+            ((_e = (0, _1.getFieldValue)(component.fields, 'CSSStyles', '').match(STYLES_LIBRARY_ID_REGEX)) === null || _e === void 0 ? void 0 : _e[1]) ||
+                ((_f = (0, _1.getFieldValue)(component.fields, 'Styles', '').match(STYLES_LIBRARY_ID_REGEX)) === null || _f === void 0 ? void 0 : _f[1]) ||
+                (0, _1.getFieldValue)(component.fields, 'LibraryId', '') ||
+                undefined;
+    }
+    if (libraryId) {
+        ids.add(libraryId);
+    }
+    const placeholders = component.placeholders || {};
+    Object.keys(placeholders).forEach((placeholder) => {
+        traversePlaceholder(placeholders[placeholder], ids);
+    });
+};