@sitecore-content-sdk/core 1.5.0 → 2.0.0-canary.10

package/dist/cjs/tools/index.js

@@ -1,75 +1,31 @@
 "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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-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;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.auth = exports.getComponentSpecUrl = exports.getComponentSpec = exports.defaultImportMapTemplate = exports.writeImportMap = exports.extractFiles = exports.scaffoldComponent = exports.generateMetadata = exports.generateSites = void 0;
-var generateSites_1 = require("./generateSites");
-Object.defineProperty(exports, "generateSites", { enumerable: true, get: function () { return generateSites_1.generateSites; } });
-var generateMetadata_1 = require("./generateMetadata");
-Object.defineProperty(exports, "generateMetadata", { enumerable: true, get: function () { return generateMetadata_1.generateMetadata; } });
-var scaffold_1 = require("./scaffold");
-Object.defineProperty(exports, "scaffoldComponent", { enumerable: true, get: function () { return scaffold_1.scaffoldComponent; } });
-var extract_files_1 = require("./codegen/extract-files");
-Object.defineProperty(exports, "extractFiles", { enumerable: true, get: function () { return extract_files_1.extractFiles; } });
-var import_map_1 = require("./codegen/import-map");
-Object.defineProperty(exports, "writeImportMap", { enumerable: true, get: function () { return import_map_1.writeImportMap; } });
-Object.defineProperty(exports, "defaultImportMapTemplate", { enumerable: true, get: function () { return import_map_1.defaultMapTemplate; } });
-var component_generation_1 = require("./codegen/component-generation");
-Object.defineProperty(exports, "getComponentSpec", { enumerable: true, get: function () { return component_generation_1.getComponentSpec; } });
-Object.defineProperty(exports, "getComponentSpecUrl", { enumerable: true, get: function () { return component_generation_1.getComponentSpecUrl; } });
-__exportStar(require("./templating"), exports);
-__exportStar(require("./auth/models"), exports);
-const authModule = __importStar(require("./auth"));
-/**
- * Preserve "live binding" semantics similar to ES module imports: production
- * code always sees the current implementation; tests can swap it safely and
- * restore via `sandbox.restore()` with no hidden global state.
- *
- * Public surface consumed by the rest of the codebase.
- * @public
- */
-exports.auth = {};
-/*
- * Define an accessor so reads are dynamic
- *   - Production: returns the real `authModule.clientCredentialsFlow`.
- *   - Tests: can be replaced with a stub via `sinon.replaceGetter` or `sandbox.replaceGetter`
- */
-Object.defineProperty(exports.auth, 'clientCredentialsFlow', {
-    get: () => authModule.clientCredentialsFlow,
-    configurable: true,
-    enumerable: true,
-});
+exports.mergeURLSearchParams = exports.escapeNonSpecialQuestionMarks = exports.areURLSearchParamsEqual = exports.isRegexOrUrl = exports.getAllowedOriginsFromEnv = exports.getEnforcedCorsHeaders = exports.isTimeoutError = exports.resolveUrl = exports.SITECORE_EXPERIENCE_EDGE_HOSTNAME_ENV = exports.SITECORE_EDGE_PLATFORM_HOSTNAME_ENV = exports.resolveExperienceEdgeUrl = exports.resolveEdgeUrlForStaticFiles = exports.resolveEdgeUrl = exports.isServer = exports.normalizeUrl = exports.setCache = exports.getCacheAndClean = exports.getCache = exports.hasCache = void 0;
+var globalCache_1 = require("./globalCache");
+Object.defineProperty(exports, "hasCache", { enumerable: true, get: function () { return globalCache_1.hasCache; } });
+Object.defineProperty(exports, "getCache", { enumerable: true, get: function () { return globalCache_1.getCache; } });
+Object.defineProperty(exports, "getCacheAndClean", { enumerable: true, get: function () { return globalCache_1.getCacheAndClean; } });
+Object.defineProperty(exports, "setCache", { enumerable: true, get: function () { return globalCache_1.setCache; } });
+// decoupling client-safe logic from /tools submodule which is not client-side safe
+var normalize_url_1 = require("./normalize-url");
+Object.defineProperty(exports, "normalizeUrl", { enumerable: true, get: function () { return normalize_url_1.normalizeUrl; } });
+var is_server_1 = require("./is-server");
+Object.defineProperty(exports, "isServer", { enumerable: true, get: function () { return __importDefault(is_server_1).default; } });
+var resolve_edge_url_1 = require("./resolve-edge-url");
+Object.defineProperty(exports, "resolveEdgeUrl", { enumerable: true, get: function () { return resolve_edge_url_1.resolveEdgeUrl; } });
+Object.defineProperty(exports, "resolveEdgeUrlForStaticFiles", { enumerable: true, get: function () { return resolve_edge_url_1.resolveEdgeUrlForStaticFiles; } });
+Object.defineProperty(exports, "resolveExperienceEdgeUrl", { enumerable: true, get: function () { return resolve_edge_url_1.resolveExperienceEdgeUrl; } });
+Object.defineProperty(exports, "SITECORE_EDGE_PLATFORM_HOSTNAME_ENV", { enumerable: true, get: function () { return resolve_edge_url_1.SITECORE_EDGE_PLATFORM_HOSTNAME_ENV; } });
+Object.defineProperty(exports, "SITECORE_EXPERIENCE_EDGE_HOSTNAME_ENV", { enumerable: true, get: function () { return resolve_edge_url_1.SITECORE_EXPERIENCE_EDGE_HOSTNAME_ENV; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "resolveUrl", { enumerable: true, get: function () { return utils_1.resolveUrl; } });
+Object.defineProperty(exports, "isTimeoutError", { enumerable: true, get: function () { return utils_1.isTimeoutError; } });
+Object.defineProperty(exports, "getEnforcedCorsHeaders", { enumerable: true, get: function () { return utils_1.getEnforcedCorsHeaders; } });
+Object.defineProperty(exports, "getAllowedOriginsFromEnv", { enumerable: true, get: function () { return utils_1.getAllowedOriginsFromEnv; } });
+Object.defineProperty(exports, "isRegexOrUrl", { enumerable: true, get: function () { return utils_1.isRegexOrUrl; } });
+Object.defineProperty(exports, "areURLSearchParamsEqual", { enumerable: true, get: function () { return utils_1.areURLSearchParamsEqual; } });
+Object.defineProperty(exports, "escapeNonSpecialQuestionMarks", { enumerable: true, get: function () { return utils_1.escapeNonSpecialQuestionMarks; } });
+Object.defineProperty(exports, "mergeURLSearchParams", { enumerable: true, get: function () { return utils_1.mergeURLSearchParams; } });

package/dist/cjs/tools/{generateMetadata.js → metadata/generateMetadata.js}

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateMetadata = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const metadata_1 = require("../editing/metadata");
-const ensurePath_1 = require("../utils/ensurePath");
+const metadata_1 = require("./metadata");
+const ensurePath_1 = require("../ensurePath");
 /**
  * Generate application metadata
  * @param {GenerateMetadataConfig} config - Optional configuration for generating metadata.

package/dist/cjs/tools/metadata/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateMetadata = void 0;
+var generateMetadata_1 = require("./generateMetadata");
+Object.defineProperty(exports, "generateMetadata", { enumerable: true, get: function () { return generateMetadata_1.generateMetadata; } });

package/dist/cjs/{editing → tools/metadata}/metadata.js

@@ -2,12 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMetadata = getMetadata;
 const child_process_1 = require("child_process");
-const trackedScopes = [
-    '@sitecore',
-    '@sitecore-cloudsdk',
-    '@sitecore-feaas',
-    '@sitecore-content-sdk',
-];
+const trackedScopes = ['@sitecore', '@sitecore-feaas', '@sitecore-content-sdk'];
 /**
  * Get application metadata
  * @param {boolean} allowWorkspaces - Whether to allow workspaces in the metadata generation.

package/dist/cjs/tools/normalize-env-value.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeEnvValue = normalizeEnvValue;
+/**
+ * Normalizes values that may come from environment variables.
+ * In Node, setting `process.env.FOO = undefined` results in the string 'undefined',
+ * which should be treated as if the variable is not set.
+ * @param {string | undefined} value - Possibly undefined env-like value
+ * @returns {string | undefined} A usable string value, or undefined if not meaningful
+ * @internal
+ */
+function normalizeEnvValue(value) {
+    if (!value)
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return undefined;
+    const lowered = trimmed.toLowerCase();
+    if (lowered === 'undefined' || lowered === 'null')
+        return undefined;
+    return trimmed;
+}

package/dist/cjs/{utils → tools}/normalize-url.js

@@ -1,5 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeUrl = void 0;
+/**
+ * Normalize a URL by removing the trailing slash
+ * @param {string} url - The URL to normalize
+ * @returns {string} The normalized URL
+ * @public
+ */
 const normalizeUrl = (url) => (url.endsWith('/') ? url.slice(0, -1) : url);
 exports.normalizeUrl = normalizeUrl;

package/dist/cjs/tools/resolve-edge-url.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SITECORE_EXPERIENCE_EDGE_HOSTNAME_ENV = exports.SITECORE_EDGE_PLATFORM_HOSTNAME_ENV = void 0;
+exports.resolveEdgeUrl = resolveEdgeUrl;
+exports.resolveExperienceEdgeUrl = resolveExperienceEdgeUrl;
+exports.resolveEdgeUrlForStaticFiles = resolveEdgeUrlForStaticFiles;
+const constants_1 = require("../constants");
+const normalize_env_value_1 = require("./normalize-env-value");
+const normalize_url_1 = require("./normalize-url");
+/**
+ * Environment variable name for the custom Edge Platform hostname (framework-agnostic).
+ * Used for service endpoints (GraphQL, APIs, forms). Server-side only.
+ * @public
+ */
+exports.SITECORE_EDGE_PLATFORM_HOSTNAME_ENV = 'SITECORE_EDGE_PLATFORM_HOSTNAME';
+/**
+ * Environment variable name for the custom Experience Edge hostname.
+ * Used only when rewriting media URLs in layout/editing (rewrite-edge-host). Server-side only.
+ * @public
+ */
+exports.SITECORE_EXPERIENCE_EDGE_HOSTNAME_ENV = 'SITECORE_EXPERIENCE_EDGE_HOSTNAME';
+/**
+ * Resolves the Sitecore Edge URL based on configuration and environment.
+ *
+ * Priority order:
+ * 1. Explicit `edgeUrl` parameter (if provided and not empty)
+ * 2. `SITECORE_EDGE_PLATFORM_HOSTNAME` environment variable
+ * 3. Default Edge Platform URL (`https://edge-platform.sitecorecloud.io`)
+ *
+ * The hostname env var can be provided as:
+ * - Full URL: `https://my-custom-edge.example.com`
+ * - Hostname only: `my-custom-edge.example.com` (will be prefixed with `https://`)
+ * @param {string} [edgeUrl] - Optional explicit Edge URL to use (takes precedence if provided)
+ * @returns {string} The resolved Edge Platform base URL (normalized, no trailing slash)
+ * @public
+ * @example
+ * resolveEdgeUrl() // => 'https://my-tenant.edge.example.com'
+ * @example
+ * resolveEdgeUrl('https://custom.edge.com') // => 'https://custom.edge.com'
+ * @example
+ * resolveEdgeUrl() // => 'https://edge-platform.sitecorecloud.io'
+ */
+function resolveEdgeUrl(edgeUrl) {
+    // Use explicit edgeUrl if provided and not empty
+    const explicit = (0, normalize_env_value_1.normalizeEnvValue)(edgeUrl);
+    if (explicit) {
+        return (0, normalize_url_1.normalizeUrl)(explicit);
+    }
+    // Check for custom hostname env var
+    const hostnameEnvVar = (0, normalize_env_value_1.normalizeEnvValue)(process.env[exports.SITECORE_EDGE_PLATFORM_HOSTNAME_ENV]);
+    if (hostnameEnvVar) {
+        return normalizeHostnameToUrl(hostnameEnvVar);
+    }
+    return constants_1.SITECORE_EDGE_PLATFORM_URL_DEFAULT;
+}
+/**
+ * Resolves the Experience Edge URL for media URL rewriting.
+ * Use only when rewriting media URLs in layout/editing (e.g. rewriteEdgeHostInResponse).
+ * Priority: SITECORE_EXPERIENCE_EDGE_HOSTNAME env, then default (edge.sitecorecloud.io).
+ * Server-side only.
+ * @returns {string} The Experience Edge base URL (no trailing slash)
+ * @public
+ */
+function resolveExperienceEdgeUrl() {
+    const hostnameEnvVar = (0, normalize_env_value_1.normalizeEnvValue)(process.env[exports.SITECORE_EXPERIENCE_EDGE_HOSTNAME_ENV]);
+    if (hostnameEnvVar) {
+        return normalizeHostnameToUrl(hostnameEnvVar);
+    }
+    return constants_1.SITECORE_EXPERIENCE_EDGE_URL_DEFAULT;
+}
+/**
+ * Resolves the Edge URL for static files (e.g. stylesheets) by ignoring the custom hostname.
+ * Use this when the custom host does not serve static file paths (e.g. /v1/files/...).
+ * Returns the default Edge Platform URL.
+ * @returns {string} The Edge Platform base URL for static files (no trailing slash)
+ * @public
+ */
+function resolveEdgeUrlForStaticFiles() {
+    return constants_1.SITECORE_EDGE_PLATFORM_URL_DEFAULT;
+}
+/**
+ * Normalizes a hostname or URL to a full HTTPS URL without trailing slash.
+ * @param {string} hostnameOrUrl - A hostname (e.g., 'my.domain.com') or full URL (e.g., 'https://my.domain.com')
+ * @returns {string} A normalized HTTPS URL
+ * @internal
+ */
+function normalizeHostnameToUrl(hostnameOrUrl) {
+    const trimmed = hostnameOrUrl.trim();
+    // If it already has a protocol, normalize and return
+    if (trimmed.startsWith('https://') || trimmed.startsWith('http://')) {
+        return (0, normalize_url_1.normalizeUrl)(trimmed);
+    }
+    // Otherwise, treat as hostname and add https://
+    return (0, normalize_url_1.normalizeUrl)(`https://${trimmed}`);
+}

package/dist/cjs/{utils → tools}/utils.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mergeURLSearchParams = exports.escapeNonSpecialQuestionMarks = exports.areURLSearchParamsEqual = exports.isRegexOrUrl = exports.getEnforcedCorsHeaders = exports.enforceCors = exports.getAllowedOriginsFromEnv = exports.isTimeoutError = exports.isAbsoluteUrl = void 0;
+exports.mergeURLSearchParams = exports.escapeNonSpecialQuestionMarks = exports.areURLSearchParamsEqual = exports.isRegexOrUrl = exports.getEnforcedCorsHeaders = exports.getAllowedOriginsFromEnv = exports.isTimeoutError = void 0;
 exports.resolveUrl = resolveUrl;
 const is_server_1 = __importDefault(require("./is-server"));
 /**
@@ -34,7 +34,6 @@ function resolveUrl(urlBase, params = {}) {
     // This is a better way to work with URLs since it handles different user input
     // edge cases. This works in Node and all browser except IE11.
     // https://developer.mozilla.org/en-US/docs/Web/API/URL
-    // TODO: Verify our browser support requirements.
     if ((0, is_server_1.default)()) {
         const url = new URL(urlBase);
         for (const key in params) {
@@ -49,22 +48,6 @@ function resolveUrl(urlBase, params = {}) {
     const result = urlBase.indexOf('?') !== -1 ? `${urlBase}&${qs}` : `${urlBase}?${qs}`;
     return result;
 }
-/**
- * Checks if the given URL is an absolute URL
- * @param {string} url - The URL to check.
- * @returns {boolean} - Returns true if the URL is an absolute URL, otherwise false.
- * @public
- */
-const isAbsoluteUrl = (url) => {
-    if (!url) {
-        return false;
-    }
-    if (typeof url !== 'string') {
-        throw new TypeError('Expected a string');
-    }
-    return /^[a-z][a-z0-9+.-]*:/.test(url);
-};
-exports.isAbsoluteUrl = isAbsoluteUrl;
 /**
  * Indicates whether the error is a timeout error
  * @param {unknown} error error
@@ -93,54 +76,13 @@ const getAllowedOriginsFromEnv = () => process.env.JSS_ALLOWED_ORIGINS
     ? process.env.JSS_ALLOWED_ORIGINS.replace(' ', '').split(',')
     : [];
 exports.getAllowedOriginsFromEnv = getAllowedOriginsFromEnv;
-/**
- * Tests origin from incoming request against allowed origins list that can be
- * set in JSS's JSS_ALLOWED_ORIGINS env variable, passed via allowedOrigins param and/or
- * be already set in Access-Control-Allow-Origin by other logic.
- * Applies Access-Control-Allow-Origin and Access-Control-Allow-Methods on match
- * Also applies Access-Control-Allow-Headers for preflight requests
- * @param {IncomingMessage} req incoming request
- * @param {OutgoingMessage} res response to set CORS headers for
- * @param {string[]} [allowedOrigins] additional list of origins to test against
- * @returns true if incoming origin matches the allowed lists, false when it does not
- * @deprecated use getEnforcedCorsHeaders instead
- * @public
- */
-const enforceCors = (req, res, allowedOrigins) => {
-    // origin in not present for non-CORS requests (e.g. server-side) - so we skip the checks
-    if (!req.headers.origin) {
-        return true;
-    }
-    // 3 sources of allowed origins are considered:
-    // the env value
-    const defaultAllowedOrigins = (0, exports.getAllowedOriginsFromEnv)();
-    // the allowedOrigins prop
-    allowedOrigins = defaultAllowedOrigins.concat(allowedOrigins || []);
-    // and the existing CORS header, if present (i.e. set by nextjs config)
-    const presetCors = res.getHeader('Access-Control-Allow-Origin');
-    if (presetCors) {
-        allowedOrigins.push(presetCors);
-    }
-    const origin = req.headers.origin;
-    if (origin &&
-        allowedOrigins.some((allowedOrigin) => origin === allowedOrigin || new RegExp(convertToWildcardRegex(allowedOrigin)).test(origin))) {
-        res.setHeader('Access-Control-Allow-Origin', origin);
-        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS, DELETE, PUT, PATCH');
-        // set the allowed headers for preflight requests
-        if (req.method === 'OPTIONS') {
-            res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
-        }
-        return true;
-    }
-    return false;
-};
-exports.enforceCors = enforceCors;
 /**
  * Gets enforced CORS headers
- * @param {string} requestMethod - The HTTP method of the request.
- * @param {IncomingHttpHeaders | Headers} headers - The headers of the request.
- * @param {string | string[]} presetCorsHeader - The preset CORS header.
- * @param {string[]} [allowedOrigins] - The allowed origins.
+ * @param {object} options - The options
+ * @param {string} options.requestMethod - The HTTP method of the request.
+ * @param {IncomingHttpHeaders | Headers} options.headers - The headers of the request.
+ * @param {string | string[]} options.presetCorsHeader - The preset CORS header.
+ * @param {string[]} [options.allowedOrigins] - The allowed origins.
  * @returns {Record<string, string>} - The enforced CORS headers.
  * @public
  */

package/dist/esm/constants.js

@@ -1,29 +1,15 @@
 /**
- * Sitecore template IDs
- * @public
- */
-export var SitecoreTemplateId;
-(function (SitecoreTemplateId) {
-    // /sitecore/templates/Foundation/JavaScript Services/App
-    SitecoreTemplateId["ContentSdkApp"] = "061cba1554744b918a0617903b102b82";
-    // /sitecore/templates/System/Dictionary/Dictionary entry
-    SitecoreTemplateId["DictionaryEntry"] = "6d1cd89719364a3aa511289a94c2a7b1";
-})(SitecoreTemplateId || (SitecoreTemplateId = {}));
-/**
- * Site name error
- * @internal
- */
-export const siteNameError = 'The siteName cannot be empty';
-/**
- * Default Sitecore edge URL
+ * Default Edge Platform URL (edge-platform.sitecorecloud.io). Used for service endpoints
+ * (GraphQL, content API, forms, layout, static files) when no custom hostname is configured.
  * @internal
  */
-export const SITECORE_EDGE_URL_DEFAULT = 'https://edge-platform.sitecorecloud.io';
+export const SITECORE_EDGE_PLATFORM_URL_DEFAULT = 'https://edge-platform.sitecorecloud.io';
 /**
- * Hidden rendering name
+ * Default Experience Edge URL (edge.sitecorecloud.io). Used only when replacing media URLs
+ * in layout/editing responses (rewrite-edge-host). Do not use for service endpoints.
  * @internal
  */
-export const HIDDEN_RENDERING_NAME = 'Hidden Rendering';
+export const SITECORE_EXPERIENCE_EDGE_URL_DEFAULT = 'https://edge.sitecorecloud.io';
 /**
  * Claims URL
  * @internal

package/dist/esm/debug.js

@@ -1,8 +1,17 @@
 var _a;
 /* eslint-disable import/no-anonymous-default-export */
 import debug from 'debug';
-import isServer from './utils/is-server';
-const rootNamespace = 'content-sdk';
+import isServer from './tools/is-server';
+/**
+ * Debug module
+ * @public
+ */
+export const debugModule = debug;
+/**
+ * Debug namespace
+ * @public
+ */
+export const debugNamespace = 'content-sdk';
 // On server/node side, allow switching from the built-in
 // `%o` (pretty-print single line) and `%O` (pretty-print multiple line)
 // with a `DEBUG_MULTILINE` environment variable.
@@ -23,19 +32,6 @@ export const enableDebug = (namespaces) => debug.enable(namespaces);
  * See {@link https://www.npmjs.com/package/debug} for details.
  */
 export default {
-    search: debug(`${rootNamespace}:search`),
-    common: debug(`${rootNamespace}:common`),
-    form: debug(`${rootNamespace}:form`),
-    http: debug(`${rootNamespace}:http`),
-    layout: debug(`${rootNamespace}:layout`),
-    dictionary: debug(`${rootNamespace}:dictionary`),
-    editing: debug(`${rootNamespace}:editing`),
-    sitemap: debug(`${rootNamespace}:sitemap`),
-    multisite: debug(`${rootNamespace}:multisite`),
-    robots: debug(`${rootNamespace}:robots`),
-    redirects: debug(`${rootNamespace}:redirects`),
-    personalize: debug(`${rootNamespace}:personalize`),
-    locale: debug(`${rootNamespace}:locale`),
-    errorpages: debug(`${rootNamespace}:errorpages`),
-    proxy: debug(`${rootNamespace}:proxy`),
+    common: debug(`${debugNamespace}:common`),
+    http: debug(`${debugNamespace}:http`),
 };

package/dist/esm/graphql-request-client.js

@@ -1,7 +1,7 @@
 import { GraphQLClient as Client } from 'graphql-request';
 import parse from 'url-parse';
 import debuggers from './debug';
-import TimeoutPromise from './utils/timeout-promise';
+import TimeoutPromise from './tools/timeout-promise';
 import { DefaultRetryStrategy } from './retries';
 /**
  * A GraphQL client for Sitecore APIs that uses the 'graphql-request' library.
@@ -24,6 +24,9 @@ export class GraphQLRequestClient {
         if (clientConfig.headers) {
             this.headers = Object.assign(Object.assign({}, this.headers), clientConfig.headers);
         }
+        if (clientConfig.contextId) {
+            this.headers['x-sitecore-contextid'] = clientConfig.contextId;
+        }
         if (!endpoint || !parse(endpoint).hostname) {
             throw new Error(`Invalid GraphQL endpoint '${endpoint}'. Verify that appropriate environment variable is set`);
         }
@@ -43,9 +46,10 @@ export class GraphQLRequestClient {
      * @param {object} config - client configuration options.
      * @param {string} config.endpoint - endpoint
      * @param {string} [config.apiKey] - apikey
+     * @param {string} [config.contextId] - contextId
      */
-    static createClientFactory({ endpoint, apiKey, }) {
-        return (config = {}) => new GraphQLRequestClient(endpoint, Object.assign(Object.assign({}, config), { apiKey }));
+    static createClientFactory({ endpoint, apiKey, contextId, }) {
+        return (config = {}) => new GraphQLRequestClient(endpoint, Object.assign(Object.assign({}, config), { apiKey, contextId }));
     }
     /**
      * Execute graphql request
@@ -67,8 +71,9 @@ export class GraphQLRequestClient {
                 variables,
                 timeout: this.timeout,
             });
-            const startTimestamp = Date.now();
+            // Use performance.now() for Next.js 16 compatibility (safe to use before request data access)
             const headers = Object.assign(Object.assign({}, this.headers), options === null || options === void 0 ? void 0 : options.headers);
+            const startTimestamp = performance.now();
             const fetchWithOptionalTimeout = [this.client.request(query, variables, headers)];
             if (this.timeout) {
                 this.abortTimeout = new TimeoutPromise(this.timeout);
@@ -77,7 +82,7 @@ export class GraphQLRequestClient {
             return Promise.race(fetchWithOptionalTimeout).then((data) => {
                 var _a;
                 (_a = this.abortTimeout) === null || _a === void 0 ? void 0 : _a.clear();
-                this.debug('response in %dms: %o', Date.now() - startTimestamp, data);
+                this.debug('response in %dms: %o', performance.now() - startTimestamp, data);
                 return Promise.resolve(data);
             }, async (error) => {
                 var _a, _b;

package/dist/esm/index.js

@@ -1,13 +1,8 @@
-// NOTE: all imports are now named as to not make breaking changes
-// and to keep react-native working with cjs modules.
 import * as constants from './constants';
-import * as form from './form';
-export { default as debug, enableDebug } from './debug';
+export { default as debug, enableDebug, debugNamespace, debugModule } from './debug';
 export { GraphQLRequestClient, } from './graphql-request-client';
 export { DefaultRetryStrategy } from './retries';
 export { MemoryCacheClient } from './cache-client';
 export { ClientError } from 'graphql-request';
 export { NativeDataFetcher, } from './native-fetcher';
 export { constants };
-export { form };
-export { defineConfig } from './config';

package/dist/esm/native-fetcher.js

@@ -10,7 +10,7 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 import debuggers from './debug';
-import TimeoutPromise from './utils/timeout-promise';
+import TimeoutPromise from './tools/timeout-promise';
 /**
  * Native data fetcher class
  * @public

package/dist/esm/{utils → tools}/ensurePath.js

@@ -4,6 +4,7 @@ import path from 'path';
  * Ensures that the directory path for the given file path exists.
  * If the directory does not exist, it will be created recursively.
  * @param {string} filePath - The file path for which to ensure the directory exists.
+ * @internal
  */
 export const ensurePathExists = (filePath) => {
     const outputDir = path.dirname(filePath);

package/dist/esm/tools/index-node.js

@@ -0,0 +1,22 @@
+// export point for /node-tools submodule, which is not client-side safe and should not be imported in browser bundles
+export * from './auth/models';
+import * as authModule from './auth';
+export * from './metadata';
+export { ensurePathExists } from './ensurePath';
+/**
+ * Preserve "live binding" semantics similar to ES module imports: production
+ * code always sees the current implementation; tests can swap it safely and
+ * restore via `sandbox.restore()` with no hidden global state.
+ * @public
+ */
+export const auth = {};
+/*
+ * Define an accessor so reads are dynamic
+ *   - Production: returns the real `authModule.clientCredentialsFlow`.
+ *   - Tests: can be replaced with a stub via `sinon.replaceGetter` or `sandbox.replaceGetter`
+ */
+Object.defineProperty(auth, 'clientCredentialsFlow', {
+    get: () => authModule.clientCredentialsFlow,
+    configurable: true,
+    enumerable: true,
+});

package/dist/esm/tools/index.js

@@ -1,28 +1,6 @@
-export { generateSites } from './generateSites';
-export { generateMetadata } from './generateMetadata';
-export { scaffoldComponent } from './scaffold';
-export { extractFiles } from './codegen/extract-files';
-export { writeImportMap, defaultMapTemplate as defaultImportMapTemplate, } from './codegen/import-map';
-export { getComponentSpec, getComponentSpecUrl } from './codegen/component-generation';
-export * from './templating';
-export * from './auth/models';
-import * as authModule from './auth';
-/**
- * Preserve "live binding" semantics similar to ES module imports: production
- * code always sees the current implementation; tests can swap it safely and
- * restore via `sandbox.restore()` with no hidden global state.
- *
- * Public surface consumed by the rest of the codebase.
- * @public
- */
-export const auth = {};
-/*
- * Define an accessor so reads are dynamic
- *   - Production: returns the real `authModule.clientCredentialsFlow`.
- *   - Tests: can be replaced with a stub via `sinon.replaceGetter` or `sandbox.replaceGetter`
- */
-Object.defineProperty(auth, 'clientCredentialsFlow', {
-    get: () => authModule.clientCredentialsFlow,
-    configurable: true,
-    enumerable: true,
-});
+export { hasCache, getCache, getCacheAndClean, setCache } from './globalCache';
+// decoupling client-safe logic from /tools submodule which is not client-side safe
+export { normalizeUrl } from './normalize-url';
+export { default as isServer } from './is-server';
+export { resolveEdgeUrl, resolveEdgeUrlForStaticFiles, resolveExperienceEdgeUrl, SITECORE_EDGE_PLATFORM_HOSTNAME_ENV, SITECORE_EXPERIENCE_EDGE_HOSTNAME_ENV, } from './resolve-edge-url';
+export { resolveUrl, isTimeoutError, getEnforcedCorsHeaders, getAllowedOriginsFromEnv, isRegexOrUrl, areURLSearchParamsEqual, escapeNonSpecialQuestionMarks, mergeURLSearchParams, } from './utils';

package/dist/esm/tools/{generateMetadata.js → metadata/generateMetadata.js}

@@ -1,7 +1,7 @@
 import fs from 'fs';
 import path from 'path';
-import { getMetadata } from '../editing/metadata';
-import { ensurePathExists } from '../utils/ensurePath';
+import { getMetadata } from './metadata';
+import { ensurePathExists } from '../ensurePath';
 /**
  * Generate application metadata
  * @param {GenerateMetadataConfig} config - Optional configuration for generating metadata.

package/dist/esm/tools/metadata/index.js

@@ -0,0 +1 @@
+export { generateMetadata } from './generateMetadata';

package/dist/esm/{editing → tools/metadata}/metadata.js

@@ -1,10 +1,5 @@
 import { execSync } from 'child_process';
-const trackedScopes = [
-    '@sitecore',
-    '@sitecore-cloudsdk',
-    '@sitecore-feaas',
-    '@sitecore-content-sdk',
-];
+const trackedScopes = ['@sitecore', '@sitecore-feaas', '@sitecore-content-sdk'];
 /**
  * Get application metadata
  * @param {boolean} allowWorkspaces - Whether to allow workspaces in the metadata generation.