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

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

@@ -0,0 +1,19 @@
+/**
+ * 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
+ */
+export 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/esm/tools/normalize-url.js

@@ -0,0 +1,7 @@
+/**
+ * Normalize a URL by removing the trailing slash
+ * @param {string} url - The URL to normalize
+ * @returns {string} The normalized URL
+ * @public
+ */
+export const normalizeUrl = (url) => (url.endsWith('/') ? url.slice(0, -1) : url);

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

@@ -0,0 +1,89 @@
+import { SITECORE_EDGE_PLATFORM_URL_DEFAULT, SITECORE_EXPERIENCE_EDGE_URL_DEFAULT, } from '../constants';
+import { normalizeEnvValue } from './normalize-env-value';
+import { normalizeUrl } from './normalize-url';
+/**
+ * Environment variable name for the custom Edge Platform hostname (framework-agnostic).
+ * Used for service endpoints (GraphQL, APIs, forms). Server-side only.
+ * @public
+ */
+export const 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
+ */
+export const 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'
+ */
+export function resolveEdgeUrl(edgeUrl) {
+    // Use explicit edgeUrl if provided and not empty
+    const explicit = normalizeEnvValue(edgeUrl);
+    if (explicit) {
+        return normalizeUrl(explicit);
+    }
+    // Check for custom hostname env var
+    const hostnameEnvVar = normalizeEnvValue(process.env[SITECORE_EDGE_PLATFORM_HOSTNAME_ENV]);
+    if (hostnameEnvVar) {
+        return normalizeHostnameToUrl(hostnameEnvVar);
+    }
+    return 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
+ */
+export function resolveExperienceEdgeUrl() {
+    const hostnameEnvVar = normalizeEnvValue(process.env[SITECORE_EXPERIENCE_EDGE_HOSTNAME_ENV]);
+    if (hostnameEnvVar) {
+        return normalizeHostnameToUrl(hostnameEnvVar);
+    }
+    return 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
+ */
+export function resolveEdgeUrlForStaticFiles() {
+    return 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 normalizeUrl(trimmed);
+    }
+    // Otherwise, treat as hostname and add https://
+    return normalizeUrl(`https://${trimmed}`);
+}

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

@@ -27,7 +27,6 @@ export 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 (isServer()) {
         const url = new URL(urlBase);
         for (const key in params) {
@@ -42,21 +41,6 @@ export 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
- */
-export 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);
-};
 /**
  * Indicates whether the error is a timeout error
  * @param {unknown} error error
@@ -83,53 +67,13 @@ const convertToWildcardRegex = (pattern) => {
 export const getAllowedOriginsFromEnv = () => process.env.JSS_ALLOWED_ORIGINS
     ? process.env.JSS_ALLOWED_ORIGINS.replace(' ', '').split(',')
     : [];
-/**
- * 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
- */
-export 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 = 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;
-};
 /**
  * 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/node-tools.d.ts

@@ -0,0 +1 @@
+export * from './types/tools/index-node';

package/package.json

@@ -1,163 +1,98 @@
-{
-  "name": "@sitecore-content-sdk/core",
-  "version": "1.5.0",
-  "main": "dist/cjs/index.js",
-  "module": "dist/esm/index.js",
-  "sideEffects": false,
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "scripts": {
-    "build": "npm run clean && tsc -p tsconfig.json && tsc -p tsconfig-esm.json",
-    "clean": "del-cli dist types",
-    "lint": "eslint \"./src/**/*.ts\"",
-    "test": "mocha \"./src/**/*.test.ts\"",
-    "prepublishOnly": "npm run build",
-    "coverage": "nyc npm test",
-    "generate-docs": "npx typedoc --plugin typedoc-plugin-markdown --outputFileStrategy Members --parametersFormat table --readme none --out ../../ref-docs/core --entryPoints src/index.ts --entryPoints src/config/index.ts --entryPoints src/client/index.ts --entryPoints src/i18n/index.ts --entryPoints src/layout/index.ts --entryPoints src/media/index.ts --entryPoints src/personalize/index.ts --entryPoints src/site/index.ts --entryPoints src/tracking/index.ts --entryPoints src/utils/index.ts --entryPoints src/editing/index.ts --entryPoints src/tools/index.ts --entryPoints src/codegen/index.ts --githubPages false",
-    "api-extractor": "npm run build && api-extractor run --local --verbose",
-    "api-extractor:verify": "api-extractor run"
-  },
-  "engines": {
-    "node": ">=22"
-  },
-  "author": {
-    "name": "Sitecore Corporation",
-    "url": "https://doc.sitecore.com/xmc/en/developers/content-sdk/index.html"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Sitecore/content-sdk"
-  },
-  "license": "Apache-2.0",
-  "homepage": "https://doc.sitecore.com/xmc/en/developers/content-sdk/index.html",
-  "bugs": {
-    "url": "https://github.com/sitecore/content-sdk/issues"
-  },
-  "devDependencies": {
-    "@sitecore-cloudsdk/events": "^0.5.1",
-    "@stylistic/eslint-plugin": "^5.2.2",
-    "@types/chai": "^5.2.2",
-    "@types/chai-spies": "^1.0.6",
-    "@types/chai-string": "^1.4.5",
-    "@types/debug": "^4.1.12",
-    "@types/jsdom": "^21.1.7",
-    "@types/memory-cache": "^0.2.6",
-    "@types/mocha": "^10.0.10",
-    "@types/node": "^22.15.14",
-    "@types/proxyquire": "^1.3.31",
-    "@types/sinon": "^17.0.4",
-    "@types/sinon-chai": "^4.0.0",
-    "@types/url-parse": "1.4.11",
-    "@typescript-eslint/eslint-plugin": "8.39.0",
-    "@typescript-eslint/parser": "8.39.0",
-    "chai": "^4.4.1",
-    "chai-spies": "^1.1.0",
-    "chai-string": "^1.6.0",
-    "del-cli": "^6.0.0",
-    "eslint": "^9.32.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import": "2.32.0",
-    "eslint-plugin-jsdoc": "52.0.3",
-    "eslint-plugin-prettier": "^4.0.0",
-    "jsdom": "^26.1.0",
-    "mocha": "^11.2.2",
-    "nock": "14.0.0-beta.7",
-    "nyc": "^17.1.0",
-    "prettier": "^2.8.0",
-    "proxyquire": "^2.1.3",
-    "sinon": "^20.0.0",
-    "tslib": "^2.8.1",
-    "tsx": "^4.19.4",
-    "typescript": "~5.8.3"
-  },
-  "peerDependencies": {
-    "@sitecore-cloudsdk/events": "^0.5.1"
-  },
-  "dependencies": {
-    "chalk": "^4.1.2",
-    "debug": "^4.4.0",
-    "glob": "^11.0.2",
-    "graphql": "^16.11.0",
-    "graphql-request": "^6.1.0",
-    "memory-cache": "^0.2.0",
-    "sinon-chai": "^4.0.0",
-    "url-parse": "^1.5.10"
-  },
-  "description": "",
-  "types": "types/index.d.ts",
-  "gitHead": "ea5d751f45a07b8ae5359f92a4234fcfe4b166b2",
-  "files": [
-    "dist",
-    "types",
-    "/*.d.ts"
-  ],
-  "exports": {
-    ".": {
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js",
-      "types": "./types/index.d.ts"
-    },
-    "./client": {
-      "import": "./dist/esm/client/index.js",
-      "require": "./dist/cjs/client/index.js",
-      "types": "./types/client/index.d.ts"
-    },
-    "./config": {
-      "import": "./dist/esm/config/index.js",
-      "require": "./dist/cjs/config/index.js",
-      "types": "./types/config/index.d.ts"
-    },
-    "./config-cli": {
-      "import": "./dist/esm/config-cli/index.js",
-      "require": "./dist/cjs/config-cli/index.js",
-      "types": "./types/config-cli/index.d.ts"
-    },
-    "./codegen": {
-      "import": "./dist/esm/editing/codegen/index.js",
-      "require": "./dist/cjs/editing/codegen/index.js",
-      "types": "./types/editing/codegen/index.d.ts"
-    },
-    "./editing": {
-      "import": "./dist/esm/editing/index.js",
-      "require": "./dist/cjs/editing/index.js",
-      "types": "./types/editing/index.d.ts"
-    },
-    "./i18n": {
-      "import": "./dist/esm/i18n/index.js",
-      "require": "./dist/cjs/i18n/index.js",
-      "types": "./types/i18n/index.d.ts"
-    },
-    "./layout": {
-      "import": "./dist/esm/layout/index.js",
-      "require": "./dist/cjs/layout/index.js",
-      "types": "./types/layout/index.d.ts"
-    },
-    "./media": {
-      "import": "./dist/esm/media/index.js",
-      "require": "./dist/cjs/media/index.js",
-      "types": "./types/media/index.d.ts"
-    },
-    "./personalize": {
-      "import": "./dist/esm/personalize/index.js",
-      "require": "./dist/cjs/personalize/index.js",
-      "types": "./types/personalize/index.d.ts"
-    },
-    "./site": {
-      "import": "./dist/esm/site/index.js",
-      "require": "./dist/cjs/site/index.js",
-      "types": "./types/site/index.d.ts"
-    },
-    "./tools": {
-      "import": "./dist/esm/tools/index.js",
-      "require": "./dist/cjs/tools/index.js",
-      "types": "./types/tools/index.d.ts"
-    },
-    "./utils": {
-      "import": "./dist/esm/utils/index.js",
-      "require": "./dist/cjs/utils/index.js",
-      "types": "./types/utils/index.d.ts"
-    }
-  }
-}
+{
+  "name": "@sitecore-content-sdk/core",
+  "version": "2.0.0-canary.10",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "npm run clean && tsc -p tsconfig.json && tsc -p tsconfig-esm.json",
+    "clean": "del-cli dist types",
+    "lint": "eslint \"./src/**/*.ts\"",
+    "test": "mocha \"./src/**/*.test.ts\"",
+    "prepublishOnly": "npm run build",
+    "coverage": "nyc npm test",
+    "generate-docs": "npx typedoc --plugin typedoc-plugin-markdown --outputFileStrategy Members --parametersFormat table --readme none --out ../../ref-docs/core --entryPoints src/index.ts --entryPoints src/tools/index.ts --entryPoints src/tools/index-node.ts --githubPages false",
+    "api-extractor": "npm run build && api-extractor run --local --verbose",
+    "api-extractor:verify": "api-extractor run"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "author": {
+    "name": "Sitecore Corporation",
+    "url": "https://doc.sitecore.com/xmc/en/developers/content-sdk/index.html"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Sitecore/content-sdk"
+  },
+  "license": "Apache-2.0",
+  "homepage": "https://doc.sitecore.com/xmc/en/developers/content-sdk/index.html",
+  "bugs": {
+    "url": "https://github.com/sitecore/content-sdk/issues"
+  },
+  "devDependencies": {
+    "@stylistic/eslint-plugin": "^5.2.2",
+    "@types/chai": "^5.2.2",
+    "@types/chai-spies": "^1.0.6",
+    "@types/debug": "^4.1.12",
+    "@types/memory-cache": "^0.2.6",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^24.10.4",
+    "@types/sinon": "^17.0.4",
+    "@types/url-parse": "1.4.11",
+    "@typescript-eslint/eslint-plugin": "8.39.0",
+    "@typescript-eslint/parser": "8.39.0",
+    "chai": "^4.4.1",
+    "chai-spies": "^1.1.0",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.32.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "2.32.0",
+    "eslint-plugin-jsdoc": "52.0.3",
+    "eslint-plugin-prettier": "^4.0.0",
+    "mocha": "^11.2.2",
+    "nock": "14.0.0-beta.7",
+    "nyc": "^17.1.0",
+    "prettier": "^2.8.0",
+    "sinon": "^20.0.0",
+    "tsx": "^4.19.4",
+    "typescript": "~5.8.3"
+  },
+  "dependencies": {
+    "debug": "^4.4.0",
+    "graphql": "^16.11.0",
+    "graphql-request": "^6.1.0",
+    "memory-cache": "^0.2.0",
+    "url-parse": "^1.5.10"
+  },
+  "description": "",
+  "types": "types/index.d.ts",
+  "gitHead": "6246e4787e22778e64c90bcd9292a9988b3552a8",
+  "files": [
+    "dist",
+    "types",
+    "/*.d.ts"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./types/index.d.ts"
+    },
+    "./tools": {
+      "import": "./dist/esm/tools/index.js",
+      "require": "./dist/cjs/tools/index.js",
+      "types": "./types/tools/index.d.ts"
+    },
+    "./node-tools": {
+      "import": "./dist/esm/tools/index-node.js",
+      "require": "./dist/cjs/tools/index-node.js",
+      "types": "./types/tools/index-node.d.ts"
+    }
+  }
+}

package/types/constants.d.ts

@@ -1,26 +1,15 @@
 /**
- * Sitecore template IDs
- * @public
- */
-export declare enum SitecoreTemplateId {
-    ContentSdkApp = "061cba1554744b918a0617903b102b82",
-    DictionaryEntry = "6d1cd89719364a3aa511289a94c2a7b1"
-}
-/**
- * Site name error
- * @internal
- */
-export declare 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 declare const SITECORE_EDGE_URL_DEFAULT = "https://edge-platform.sitecorecloud.io";
+export declare 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 declare const HIDDEN_RENDERING_NAME = "Hidden Rendering";
+export declare const SITECORE_EXPERIENCE_EDGE_URL_DEFAULT = "https://edge.sitecorecloud.io";
 /**
  * Claims URL
  * @internal

package/types/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,kBAAkB;IAE5B,aAAa,qCAAqC;IAGlD,eAAe,qCAAqC;CACrD;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,iCAAiC,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,yBAAyB,2CAA2C,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,MAAM,yCAAyC,CAAC;AAC7D;;;GAGG;AACH,eAAO,MAAM,4BAA4B,kCAAkC,CAAC;AAC5E;;;GAGG;AACH,eAAO,MAAM,8BAA8B,iCAAiC,CAAC;AAC7E;;;GAGG;AACH,eAAO,MAAM,8BAA8B,kDAAkD,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,2CAA2C,CAAC;AAE3F;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,kCAAkC,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,MAAM,yCAAyC,CAAC;AAC7D;;;GAGG;AACH,eAAO,MAAM,4BAA4B,kCAAkC,CAAC;AAC5E;;;GAGG;AACH,eAAO,MAAM,8BAA8B,iCAAiC,CAAC;AAC7E;;;GAGG;AACH,eAAO,MAAM,8BAA8B,kDAAkD,CAAC"}

package/types/debug.d.ts

@@ -1,4 +1,17 @@
 import debug from 'debug';
+/**
+ * Debug module
+ * @public
+ */
+export declare const debugModule: debug.Debug & {
+    debug: debug.Debug;
+    default: debug.Debug;
+};
+/**
+ * Debug namespace
+ * @public
+ */
+export declare const debugNamespace = "content-sdk";
 /**
  * Debugger type
  * @public
@@ -15,21 +28,8 @@ export declare const enableDebug: (namespaces: string) => void;
  * See {@link https://www.npmjs.com/package/debug} for details.
  */
 declare const _default: {
-    search: debug.Debugger;
     common: debug.Debugger;
-    form: debug.Debugger;
     http: debug.Debugger;
-    layout: debug.Debugger;
-    dictionary: debug.Debugger;
-    editing: debug.Debugger;
-    sitemap: debug.Debugger;
-    multisite: debug.Debugger;
-    robots: debug.Debugger;
-    redirects: debug.Debugger;
-    personalize: debug.Debugger;
-    locale: debug.Debugger;
-    errorpages: debug.Debugger;
-    proxy: debug.Debugger;
 };
 export default _default;
 //# sourceMappingURL=debug.d.ts.map

package/types/debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;AActC;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,YAAY,MAAM,SAA6B,CAAC;AAE5E;;;GAGG;;;;;;;;;;;;;;;;;;AACH,wBAgBE"}
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;;GAGG;AACH,eAAO,MAAM,WAAW;;;CAAQ,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;AActC;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,YAAY,MAAM,SAA6B,CAAC;AAE5E;;;GAGG;;;;;AACH,wBAGE"}

package/types/graphql-request-client.d.ts

@@ -31,6 +31,10 @@ export type GraphQLRequestClientConfig = {
      * The API key to use for authentication. This will be added as an 'sc_apikey' header.
      */
     apiKey?: string;
+    /**
+     * A unified identifier used to connect and retrieve data from XM Cloud instance
+     */
+    contextId?: string;
     /**
      * Override debugger for logging. Uses 'content-sdk:http' by default.
      */
@@ -64,7 +68,7 @@ export type GraphQLRequestClientConfig = {
  * @returns An instance of a GraphQL Request Client ready to send GraphQL requests.
  * @public
  */
-export type GraphQLRequestClientFactory = (config?: Omit<GraphQLRequestClientConfig, 'apiKey'>) => GraphQLRequestClient;
+export type GraphQLRequestClientFactory = (config?: Omit<GraphQLRequestClientConfig, 'apiKey' | 'contextId'>) => GraphQLRequestClient;
 /**
  * Configuration type for @type GraphQLRequestClientFactory
  * @public
@@ -72,6 +76,7 @@ export type GraphQLRequestClientFactory = (config?: Omit<GraphQLRequestClientCon
 export type GraphQLRequestClientFactoryConfig = {
     endpoint: string;
     apiKey?: string;
+    contextId?: string;
 };
 /**
  * A GraphQL client for Sitecore APIs that uses the 'graphql-request' library.
@@ -98,8 +103,9 @@ export declare class GraphQLRequestClient implements GraphQLClient {
      * @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, }: GraphQLRequestClientFactoryConfig): GraphQLRequestClientFactory;
+    static createClientFactory({ endpoint, apiKey, contextId, }: GraphQLRequestClientFactoryConfig): GraphQLRequestClientFactory;
     /**
      * Execute graphql request
      * @param {string | DocumentNode} query graphql query

package/types/graphql-request-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphql-request-client.d.ts","sourceRoot":"","sources":["../src/graphql-request-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAkB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGlF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,OAAO,CAAC,CAAC,EACP,KAAK,EAAE,MAAM,GAAG,YAAY,EAC5B,SAAS,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EACtC,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,yBAAyB,CAAC;AAElF;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GAAG,CACxC,MAAM,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,QAAQ,CAAC,KAChD,oBAAoB,CAAC;AAE1B;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IAc5C,OAAO,CAAC,QAAQ;IAb5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAgB;IAErC;;;;OAIG;gBACiB,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAE,0BAA+B;IA0BnF;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,EACzB,QAAQ,EACR,MAAM,GACP,EAAE,iCAAiC,GAAG,2BAA2B;IAKlE;;;;OAIG;IACG,OAAO,CAAC,CAAC,EACb,KAAK,EAAE,MAAM,GAAG,YAAY,EAC5B,SAAS,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EACtC,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC;CAmDd"}
+{"version":3,"file":"graphql-request-client.d.ts","sourceRoot":"","sources":["../src/graphql-request-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAkB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGlF;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,OAAO,CAAC,CAAC,EACP,KAAK,EAAE,MAAM,GAAG,YAAY,EAC5B,SAAS,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EACtC,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,yBAAyB,CAAC;AAElF;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,GAAG,CACxC,MAAM,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,QAAQ,GAAG,WAAW,CAAC,KAC9D,oBAAoB,CAAC;AAE1B;;;GAGG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IAc5C,OAAO,CAAC,QAAQ;IAb5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAgB;IAErC;;;;OAIG;gBACiB,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAE,0BAA+B;IA6BnF;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CAAC,EACzB,QAAQ,EACR,MAAM,EACN,SAAS,GACV,EAAE,iCAAiC,GAAG,2BAA2B;IAKlE;;;;OAIG;IACG,OAAO,CAAC,CAAC,EACb,KAAK,EAAE,MAAM,GAAG,YAAY,EAC5B,SAAS,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EACtC,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC;CAoDd"}

package/types/index.d.ts

@@ -1,13 +1,10 @@
 import * as constants from './constants';
-import * as form from './form';
-export { default as debug, Debugger, enableDebug } from './debug';
-export { GraphQLClient, GraphQLRequestClient, GraphQLRequestClientConfig, GraphQLRequestClientFactory, GraphQLRequestClientFactoryConfig, } from './graphql-request-client';
+export { default as debug, Debugger, enableDebug, debugNamespace, debugModule } from './debug';
+export { GraphQLClient, GraphQLRequestClient, GraphQLClientError, GraphQLRequestClientConfig, GraphQLRequestClientFactory, GraphQLRequestClientFactoryConfig, } from './graphql-request-client';
 export { DefaultRetryStrategy } from './retries';
 export { CacheClient, CacheOptions, MemoryCacheClient } from './cache-client';
 export { ClientError } from 'graphql-request';
 export { NativeDataFetcher, NativeDataFetcherConfig, NativeDataFetcherError, NativeDataFetcherResponse, } from './native-fetcher';
-export { HTMLLink, RetryStrategy, GenericGraphQLClientError, StaticPath } from './models';
+export { RetryStrategy, GenericGraphQLClientError, FetchOptions } from './models';
 export { constants };
-export { form };
-export { defineConfig } from './config';
 //# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAE/B,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,OAAO,EAAE,IAAI,EAAE,CAAC;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/F,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,CAAC"}