@sitecore-content-sdk/core 0.2.0-canary.3 → 0.2.0-canary.30

package/content.d.ts

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

package/content.js

@@ -0,0 +1 @@
+module.exports = require('./dist/cjs/content/index');

package/dist/cjs/client/graphql-edge-proxy.js

@@ -2,14 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEdgeProxyFormsUrl = exports.getEdgeProxyContentUrl = void 0;
 const constants_1 = require("../constants");
-const normalizeUrl = (url) => (url.endsWith('/') ? url.slice(0, -1) : url);
+const normalize_url_1 = require("../utils/normalize-url");
 /**
  * Generates a URL for accessing Sitecore Edge Platform Content using the provided endpoint and context ID.
  * @param {string} sitecoreEdgeContextId - The unique context id.
  * @param {string} [sitecoreEdgeUrl] - The base endpoint URL for the Edge Platform. Default is https://edge-platform.sitecorecloud.io
  * @returns {string} The complete URL for accessing content through the Edge Platform.
  */
-const getEdgeProxyContentUrl = (sitecoreEdgeContextId, sitecoreEdgeUrl = constants_1.SITECORE_EDGE_URL_DEFAULT) => `${normalizeUrl(sitecoreEdgeUrl)}/v1/content/api/graphql/v1?sitecoreContextId=${sitecoreEdgeContextId}`;
+const getEdgeProxyContentUrl = (sitecoreEdgeContextId, sitecoreEdgeUrl = constants_1.SITECORE_EDGE_URL_DEFAULT) => `${(0, normalize_url_1.normalizeUrl)(sitecoreEdgeUrl)}/v1/content/api/graphql/v1?sitecoreContextId=${sitecoreEdgeContextId}`;
 exports.getEdgeProxyContentUrl = getEdgeProxyContentUrl;
 /**
  * Generates a URL for accessing Sitecore Edge Platform Forms using the provided form ID and context ID.
@@ -18,5 +18,5 @@ exports.getEdgeProxyContentUrl = getEdgeProxyContentUrl;
  * @param {string} [sitecoreEdgeUrl] - The base endpoint URL for the Edge Platform. Default is https://edge-platform.sitecorecloud.io
  * @returns {string} The complete URL for accessing forms through the Edge Platform.
  */
-const getEdgeProxyFormsUrl = (sitecoreEdgeContextId, formId, sitecoreEdgeUrl = constants_1.SITECORE_EDGE_URL_DEFAULT) => `${normalizeUrl(sitecoreEdgeUrl)}/v1/forms/publisher/${formId}?sitecoreContextId=${sitecoreEdgeContextId}`;
+const getEdgeProxyFormsUrl = (sitecoreEdgeContextId, formId, sitecoreEdgeUrl = constants_1.SITECORE_EDGE_URL_DEFAULT) => `${(0, normalize_url_1.normalizeUrl)(sitecoreEdgeUrl)}/v1/forms/publisher/${formId}?sitecoreContextId=${sitecoreEdgeContextId}`;
 exports.getEdgeProxyFormsUrl = getEdgeProxyFormsUrl;

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

@@ -9,6 +9,7 @@ const layout_personalizer_1 = require("../personalize/layout-personalizer");
 const site_1 = require("../site");
 const utils_2 = require("./utils");
 const native_fetcher_1 = require("../native-fetcher");
+const graphql_robots_service_1 = require("../site/graphql-robots-service");
 /**
  * This is a generic content client that can be used by any framework.
  * Use it to retrieve pages, preview data, dictionary and other data
@@ -59,7 +60,7 @@ class SitecoreClient {
      * Get page details for a route, with layout and other details
      * @param {string} path route path
      * @param {PageOptions} [pageOptions] site, language and personalization variant details for route
-     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests (like retries and fetch)
+     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests
      * @returns {Page | null} page details
      */
     async getPage(path, pageOptions, fetchOptions) {
@@ -115,7 +116,7 @@ class SitecoreClient {
     /**
      * Retrieves dictionary phrases for a given site and locale.
      * @param {RouteOptions} routeOptions - Route options containing language and site name to load dictionary for
-     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests (like retries and fetch)
+     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests
      * @returns {DictionaryPhrases} A promise that resolves to the dictionary phrases.
      */
     async getDictionary(routeOptions, fetchOptions) {
@@ -126,7 +127,7 @@ class SitecoreClient {
     /**
      * Retrieves error pages for a given site and locale.
      * @param {RouteOptions} routeOptions - Route options containing language and site name to load error pages
-     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests (like retries and fetch)
+     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests
      * @returns {ErrorPages | null} A promise that resolves to the error pages or null if not found.
      */
     async getErrorPages(routeOptions, fetchOptions) {
@@ -137,7 +138,7 @@ class SitecoreClient {
     /**
      * Retrieves preview page and layout details
      * @param {EditingPreviewData | undefined} previewData - The editing preview data for metadata mode.
-     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests (like retries and fetch)
+     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests
      * @returns {Page} preview page details
      */
     async getPreview(previewData, fetchOptions) {
@@ -171,7 +172,7 @@ class SitecoreClient {
     /**
      * Get design library page details for Design Library mode of your app
      * @param {DesignLibraryRenderPreviewData} designLibData preview data set in 'library' mode of the app
-     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests (like retries and fetch)
+     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests
      * @returns {Page} preview page for Design Library
      */
     async getDesignLibraryData(designLibData, fetchOptions) {
@@ -256,6 +257,19 @@ class SitecoreClient {
             .join('')}
       </sitemapindex>`;
     }
+    /**
+     * Retrieves the robots.txt content for a given site name.
+     *
+     * @param {string} siteName - The name of the site to retrieve the robots.txt for.
+     * @param {FetchOptions} [fetchOptions] - Optional fetch options.
+     * @returns {Promise<string | null>} A promise that resolves to the robots.txt content,
+     * or null if no content is found.
+     */
+    async getRobots(siteName, fetchOptions) {
+        const robotsService = this.getRobotsService(siteName || this.initOptions.defaultSite);
+        const content = await robotsService.fetchRobots(fetchOptions);
+        return content || null;
+    }
     /**
      * Factory methods for creating dependencies
      * Subclasses can override these to provide custom implementations.
@@ -266,6 +280,12 @@ class SitecoreClient {
             siteName,
         });
     }
+    getRobotsService(siteName) {
+        return new graphql_robots_service_1.GraphQLRobotsService({
+            clientFactory: this.clientFactory,
+            siteName,
+        });
+    }
     getBaseServiceOptions() {
         return {
             defaultSite: this.initOptions.defaultSite,

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

@@ -10,9 +10,9 @@ const retries_1 = require("../retries");
 const getFallbackConfig = () => ({
     api: {
         edge: {
-            contextId: '',
+            contextId: process.env.SITECORE_EDGE_CONTEXT_ID || '',
             clientContextId: '',
-            edgeUrl: constants_1.SITECORE_EDGE_URL_DEFAULT,
+            edgeUrl: process.env.SITECORE_EDGE_URL || constants_1.SITECORE_EDGE_URL_DEFAULT,
         },
         local: {
             apiKey: '',
@@ -20,7 +20,7 @@ const getFallbackConfig = () => ({
             path: '/sitecore/api/graph/edge',
         },
     },
-    editingSecret: 'editing-secret-missing',
+    editingSecret: process.env.JSS_EDITING_SECRET || 'editing-secret-missing',
     retries: {
         count: 3,
         retryStrategy: new retries_1.DefaultRetryStrategy({
@@ -37,8 +37,8 @@ const getFallbackConfig = () => ({
     },
     personalize: {
         enabled: process.env.NODE_ENV !== 'development',
-        edgeTimeout: 400,
-        cdpTimeout: 400,
+        edgeTimeout: parseInt(process.env.PERSONALIZE_MIDDLEWARE_EDGE_TIMEOUT, 10) || 400,
+        cdpTimeout: parseInt(process.env.PERSONALIZE_MIDDLEWARE_CDP_TIMEOUT, 10) || 400,
         scope: '',
         channel: 'WEB',
         currency: 'USD',

package/dist/cjs/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HIDDEN_RENDERING_NAME = exports.SITECORE_EDGE_URL_DEFAULT = exports.siteNameError = exports.SitecoreTemplateId = void 0;
+exports.DEFAULT_SITECORE_AUTH_AUDIENCE = exports.DEFAULT_SITECORE_AUTH_ENDPOINT = exports.HIDDEN_RENDERING_NAME = exports.SITECORE_EDGE_URL_DEFAULT = exports.siteNameError = exports.SitecoreTemplateId = void 0;
 var SitecoreTemplateId;
 (function (SitecoreTemplateId) {
     // /sitecore/templates/Foundation/JavaScript Services/App
@@ -11,3 +11,5 @@ var SitecoreTemplateId;
 exports.siteNameError = 'The siteName cannot be empty';
 exports.SITECORE_EDGE_URL_DEFAULT = 'https://edge-platform.sitecorecloud.io';
 exports.HIDDEN_RENDERING_NAME = 'Hidden Rendering';
+exports.DEFAULT_SITECORE_AUTH_ENDPOINT = 'https://auth.sitecorecloud.io/oauth/token';
+exports.DEFAULT_SITECORE_AUTH_AUDIENCE = 'https://api.sitecorecloud.io';

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

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentClient = void 0;
+const graphql_request_client_1 = require("../graphql-request-client");
+const utils_1 = require("./utils");
+const debug_1 = __importDefault(require("../debug"));
+const locales_1 = require("./locales");
+/**
+ * Class representing a client for interacting with the Content API.
+ */
+class ContentClient {
+    constructor({ url, tenant, environment, preview = false, token }) {
+        this.endpoint = (0, utils_1.getContentUrl)({
+            environment,
+            preview,
+            tenant,
+            url,
+        });
+        this.graphqlClient = new graphql_request_client_1.GraphQLRequestClient(this.endpoint, {
+            headers: {
+                Authorization: `Bearer ${token}`,
+            },
+            debugger: debug_1.default.content,
+        });
+    }
+    /**
+     * Factory method for creating a ContentClient instance. This method allows you to create a client with the values populated from environment variables or provided as arguments.
+     * @param {Partial<ContentClientOptions>} [options] - client configuration options
+     * @param {string} [options.url] - Content base graphql endpoint url. If not provided, it will be read from the SITECORE_CS_URL environment variable. Otherwise, it defaults to https://cs-graphqlapi-staging.sitecore-staging.cloud.
+     * @param {string} [options.tenant] - Tenant name. If not provided, it will be read from the SITECORE_CS_TENANT environment variable
+     * @param {string} [options.environment] - Environment name. If not provided, it will be read from the SITECORE_CS_ENVIRONMENT environment variable. Otherwise, it defaults to 'main'
+     * @param {boolean} [options.preview] - Indicates if preview mode is enabled. If not provided, it will be read from the SITECORE_CS_PREVIEW environment variable. Otherwise, it defaults to false
+     * @param {string} [options.token] - Token for authentication. If not provided, it will be read from the SITECORE_CS_TOKEN environment variable.
+     * @returns {ContentClient} ContentClient instance
+     * @throws {Error} If tenant or token is not provided
+     */
+    static createClient({ url, tenant, environment, preview, token, } = {}) {
+        const options = {
+            url: url || process.env.SITECORE_CS_URL,
+            tenant: tenant || process.env.SITECORE_CS_TENANT || '',
+            environment: environment || process.env.SITECORE_CS_ENVIRONMENT || 'main',
+            preview: preview || process.env.SITECORE_CS_PREVIEW === 'true',
+            token: token || process.env.SITECORE_CS_TOKEN || '',
+        };
+        if (!options.tenant) {
+            throw new Error('Tenant is required to be provided as an argument or as a SITECORE_CS_TENANT environment variable');
+        }
+        if (!options.token) {
+            throw new Error('Token is required to be provided as an argument or as a SITECORE_CS_TOKEN environment variable');
+        }
+        return new ContentClient(options);
+    }
+    /**
+     * Execute graphql request
+     * @param {string | DocumentNode} query graphql query
+     * @param {object} variables variables for the query
+     * @param {FetchOptions} options options for configuring the request
+     * @returns {T} response data
+     */
+    async get(query, variables = {}, options = {}) {
+        debug_1.default.content('fetching content data');
+        return this.graphqlClient.request(query, variables, options);
+    }
+    /**
+     * Retrieves the locale information for a given locale ID.
+     * @param {string} id - The unique identifier of the locale item.
+     * @returns A promise that resolves to the locale information associated with the specified locale ID.
+     */
+    async getLocale(id) {
+        debug_1.default.content('Getting locale for id: %s', id);
+        const response = await this.get(locales_1.GET_LOCALE_QUERY, { id });
+        return response.locale;
+    }
+    /**
+     * Retrieves all available locales from the content service.
+     * @returns A promise that resolves to an array of locales.
+     */
+    async getLocales() {
+        debug_1.default.content('Getting all locales');
+        const response = await this.get(locales_1.GET_LOCALES_QUERY);
+        return response.manyLocale;
+    }
+}
+exports.ContentClient = ContentClient;

package/dist/cjs/content/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContentUrl = exports.GET_LOCALES_QUERY = exports.GET_LOCALE_QUERY = exports.ContentClient = void 0;
+var content_client_1 = require("./content-client");
+Object.defineProperty(exports, "ContentClient", { enumerable: true, get: function () { return content_client_1.ContentClient; } });
+var locales_1 = require("./locales");
+Object.defineProperty(exports, "GET_LOCALE_QUERY", { enumerable: true, get: function () { return locales_1.GET_LOCALE_QUERY; } });
+Object.defineProperty(exports, "GET_LOCALES_QUERY", { enumerable: true, get: function () { return locales_1.GET_LOCALES_QUERY; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "getContentUrl", { enumerable: true, get: function () { return utils_1.getContentUrl; } });

package/dist/cjs/content/locales.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_LOCALES_QUERY = exports.GET_LOCALE_QUERY = void 0;
+/**
+ * GraphQL query to retrieve a specific locale by its ID.
+ *
+ * Variables:
+ * - id: The ID of the locale to retrieve.
+ */
+exports.GET_LOCALE_QUERY = `
+  query GetLocaleById ($id: ID!) {
+    locale(id: $id) {
+      id
+      label
+    }
+  }
+`;
+/**
+ * GraphQL query to retrieve all available locales.
+ */
+exports.GET_LOCALES_QUERY = `
+  query GetAllLocales{
+    manyLocale {
+      id
+      label
+    }
+  }
+`;

package/dist/cjs/content/utils.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContentUrl = getContentUrl;
+const normalize_url_1 = require("../utils/normalize-url");
+/**
+ * Get the Content graphql endpoint url
+ * @param {object} params Parameters
+ * @param {string} [params.url] Content base graphql endpoint url
+ * @param {string} params.tenant Tenant name
+ * @param {string} params.environment Environment name
+ * @param {boolean} params.preview Indicates if preview mode is enabled
+ * @returns {string} Content graphql endpoint url
+ */
+function getContentUrl({ url = 'https://cs-graphqlapi-staging.sitecore-staging.cloud', tenant, environment, preview, }) {
+    return `${(0, normalize_url_1.normalizeUrl)(url)}/api/graphql/v1/${tenant}/${environment}?preview=${preview}`;
+}

package/dist/cjs/debug.js

@@ -29,6 +29,7 @@ exports.enableDebug = enableDebug;
  */
 exports.default = {
     common: (0, debug_1.default)(`${rootNamespace}:common`),
+    content: (0, debug_1.default)(`${rootNamespace}:content`),
     form: (0, debug_1.default)(`${rootNamespace}:form`),
     http: (0, debug_1.default)(`${rootNamespace}:http`),
     layout: (0, debug_1.default)(`${rootNamespace}:layout`),

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

@@ -4,6 +4,7 @@ exports.updateComponentHandler = exports.addComponentUpdateHandler = exports.Des
 exports.getDesignLibraryStatusEvent = getDesignLibraryStatusEvent;
 exports.getDesignLibraryScriptLink = getDesignLibraryScriptLink;
 const constants_1 = require("../constants");
+const normalize_url_1 = require("../utils/normalize-url");
 /**
  * Event to be sent when report status to design library
  */
@@ -110,5 +111,5 @@ function getDesignLibraryStatusEvent(status, uid) {
  * @returns The full URL to the design library script.
  */
 function getDesignLibraryScriptLink(sitecoreEdgeUrl = constants_1.SITECORE_EDGE_URL_DEFAULT) {
-    return `${sitecoreEdgeUrl}/v1/files/designlibrary/lib/rh-lib-script.js`;
+    return `${(0, normalize_url_1.normalizeUrl)(sitecoreEdgeUrl)}/v1/files/designlibrary/lib/rh-lib-script.js`;
 }

package/dist/cjs/index.js

@@ -38,9 +38,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defineConfig = exports.constants = exports.NativeDataFetcher = exports.ClientError = exports.MemoryCacheClient = exports.DefaultRetryStrategy = exports.GraphQLRequestClient = exports.enableDebug = exports.debug = void 0;
+exports.defineConfig = exports.form = exports.constants = exports.NativeDataFetcher = exports.ClientError = exports.MemoryCacheClient = exports.DefaultRetryStrategy = exports.GraphQLRequestClient = exports.enableDebug = exports.debug = void 0;
 const constants = __importStar(require("./constants"));
 exports.constants = constants;
+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; } });
 Object.defineProperty(exports, "enableDebug", { enumerable: true, get: function () { return debug_1.enableDebug; } });

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.traverseComponent = exports.traverseField = exports.traversePlaceholder = exports.getContentStylesheetUrl = exports.getContentStylesheetLink = void 0;
 const constants_1 = require("../constants");
+const normalize_url_1 = require("../utils/normalize-url");
 /**
  * Regular expression to check if the content styles are used in the field value
  */
@@ -26,7 +27,7 @@ const getContentStylesheetLink = (layoutData, sitecoreEdgeContextId, sitecoreEdg
     };
 };
 exports.getContentStylesheetLink = getContentStylesheetLink;
-const getContentStylesheetUrl = (sitecoreEdgeContextId, sitecoreEdgeUrl = constants_1.SITECORE_EDGE_URL_DEFAULT) => `${sitecoreEdgeUrl}/v1/files/pages/styles/content-styles.css?sitecoreContextId=${sitecoreEdgeContextId}`;
+const getContentStylesheetUrl = (sitecoreEdgeContextId, sitecoreEdgeUrl = constants_1.SITECORE_EDGE_URL_DEFAULT) => `${(0, normalize_url_1.normalizeUrl)(sitecoreEdgeUrl)}/v1/files/pages/styles/content-styles.css?sitecoreContextId=${sitecoreEdgeContextId}`;
 exports.getContentStylesheetUrl = getContentStylesheetUrl;
 const traversePlaceholder = (components, config) => {
     if (config.loadStyles)

package/dist/cjs/layout/themes.js

@@ -4,6 +4,7 @@ exports.getStylesheetUrl = void 0;
 exports.getDesignLibraryStylesheetLinks = getDesignLibraryStylesheetLinks;
 const _1 = require(".");
 const constants_1 = require("../constants");
+const normalize_url_1 = require("../utils/normalize-url");
 /**
  * Pattern for library ids
  * @example -library--foo
@@ -27,7 +28,7 @@ function getDesignLibraryStylesheetLinks(layoutData, sitecoreEdgeContextId, site
     }));
 }
 const getStylesheetUrl = (id, sitecoreEdgeContextId, sitecoreEdgeUrl = constants_1.SITECORE_EDGE_URL_DEFAULT) => {
-    return `${sitecoreEdgeUrl}/v1/files/components/styles/${id}.css?sitecoreContextId=${sitecoreEdgeContextId}`;
+    return `${(0, normalize_url_1.normalizeUrl)(sitecoreEdgeUrl)}/v1/files/components/styles/${id}.css?sitecoreContextId=${sitecoreEdgeContextId}`;
 };
 exports.getStylesheetUrl = getStylesheetUrl;
 /**

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

@@ -36,14 +36,14 @@ class GraphQLRobotsService {
      * @returns text of robots.txt
      * @throws {Error} if the siteName is empty.
      */
-    async fetchRobots() {
+    async fetchRobots(fetchOptions) {
         const siteName = this.options.siteName;
         if (!siteName) {
             throw new Error(constants_1.siteNameError);
         }
         const robotsResult = this.graphQLClient.request(this.query, {
             siteName,
-        });
+        }, fetchOptions);
         try {
             return robotsResult.then((result) => {
                 var _a, _b;

package/dist/cjs/tools/auth/fetch-bearer-token.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchBearerToken = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const constants_1 = require("../../constants");
+/**
+ * Connects to M2M endpoint and fetches the bearer token
+ * Uses client_id and client_secret from environment variables
+ * @param {FetchBearerTokenOptions} options client id, secret, and other parameters for connection to m2m endpoint
+ * @returns {string} bearer token string
+ */
+const fetchBearerToken = async (options) => {
+    const { clientId, clientSecret } = options;
+    const audience = options.audience || constants_1.DEFAULT_SITECORE_AUTH_AUDIENCE;
+    const endpoint = options.endpoint || constants_1.DEFAULT_SITECORE_AUTH_ENDPOINT;
+    try {
+        // TODO:adjust when M2M endpoint is live
+        const authenticateResponse = await fetch(endpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                client_id: clientId,
+                client_secret: clientSecret,
+                audience: audience,
+                grant_type: 'client_credentials',
+            }),
+        });
+        const jsonResponse = await authenticateResponse.json();
+        return jsonResponse.access_token;
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('Error authenticating with Sitecore Auth endpoint:', error));
+        return null;
+    }
+};
+exports.fetchBearerToken = fetchBearerToken;

package/dist/cjs/tools/index.js

@@ -14,7 +14,7 @@ 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);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.scaffoldComponent = exports.generateMetadata = exports.generateSites = void 0;
+exports.fetchBearerToken = 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");
@@ -22,3 +22,5 @@ Object.defineProperty(exports, "generateMetadata", { enumerable: true, get: func
 var scaffold_1 = require("./scaffold");
 Object.defineProperty(exports, "scaffoldComponent", { enumerable: true, get: function () { return scaffold_1.scaffoldComponent; } });
 __exportStar(require("./templating"), exports);
+var fetch_bearer_token_1 = require("./auth/fetch-bearer-token");
+Object.defineProperty(exports, "fetchBearerToken", { enumerable: true, get: function () { return fetch_bearer_token_1.fetchBearerToken; } });

package/dist/cjs/utils/normalize-url.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeUrl = void 0;
+const normalizeUrl = (url) => (url.endsWith('/') ? url.slice(0, -1) : url);
+exports.normalizeUrl = normalizeUrl;

package/dist/cjs/utils/utils.js

@@ -173,7 +173,7 @@ exports.areURLSearchParamsEqual = areURLSearchParamsEqual;
  * @returns {string} - The modified string or regex with non-special "?" characters escaped.
  */
 const escapeNonSpecialQuestionMarks = (input) => {
-    const regexPattern = /(?<!\\)\?/g; // Match unescaped "?" characters
+    const regexPattern = /(\\)?\?/g; // Match "?" that may or may not be preceded by a backslash
     const negativeLookaheadPattern = /\(\?!$/; // Detect the start of a Negative Lookahead pattern
     const specialRegexSymbols = /[.*+)\[\]|\(]$/; // Check for special regex symbols before "?"
     let result = '';
@@ -182,12 +182,14 @@ const escapeNonSpecialQuestionMarks = (input) => {
     while ((match = regexPattern.exec(input)) !== null) {
         const index = match.index; // Position of the "?" in the string
         const before = input.slice(lastIndex, index); // Context before the "?"
+        // Check if "?" is preceded by a backslash (escaped)
+        const isEscaped = match[1] !== undefined; // match[1] is the backslash group
         // Check if "?" is part of a Negative Lookahead
         const isNegativeLookahead = negativeLookaheadPattern.test(before.slice(-3));
         // Check if "?" follows a special regex symbol
         const isSpecialRegexSymbol = specialRegexSymbols.test(before.slice(-1));
-        if (isNegativeLookahead || isSpecialRegexSymbol) {
-            // If it's a special case, keep the "?" as is
+        if (isEscaped || isNegativeLookahead || isSpecialRegexSymbol) {
+            // If it's escaped, part of a Negative Lookahead, or follows a special regex symbol, keep the "?" as is
             result += input.slice(lastIndex, index + 1);
         }
         else {

package/dist/esm/client/graphql-edge-proxy.js

@@ -1,5 +1,5 @@
 import { SITECORE_EDGE_URL_DEFAULT } from '../constants';
-const normalizeUrl = (url) => (url.endsWith('/') ? url.slice(0, -1) : url);
+import { normalizeUrl } from '../utils/normalize-url';
 /**
  * Generates a URL for accessing Sitecore Edge Platform Content using the provided endpoint and context ID.
  * @param {string} sitecoreEdgeContextId - The unique context id.

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

@@ -6,6 +6,7 @@ import { personalizeLayout } from '../personalize/layout-personalizer';
 import { SiteResolver, GraphQLErrorPagesService, GraphQLSitePathService, GraphQLSitemapXmlService, } from '../site';
 import { createGraphQLClientFactory } from './utils';
 import { NativeDataFetcher } from '../native-fetcher';
+import { GraphQLRobotsService } from '../site/graphql-robots-service';
 /**
  * This is a generic content client that can be used by any framework.
  * Use it to retrieve pages, preview data, dictionary and other data
@@ -56,7 +57,7 @@ export class SitecoreClient {
      * Get page details for a route, with layout and other details
      * @param {string} path route path
      * @param {PageOptions} [pageOptions] site, language and personalization variant details for route
-     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests (like retries and fetch)
+     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests
      * @returns {Page | null} page details
      */
     async getPage(path, pageOptions, fetchOptions) {
@@ -112,7 +113,7 @@ export class SitecoreClient {
     /**
      * Retrieves dictionary phrases for a given site and locale.
      * @param {RouteOptions} routeOptions - Route options containing language and site name to load dictionary for
-     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests (like retries and fetch)
+     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests
      * @returns {DictionaryPhrases} A promise that resolves to the dictionary phrases.
      */
     async getDictionary(routeOptions, fetchOptions) {
@@ -123,7 +124,7 @@ export class SitecoreClient {
     /**
      * Retrieves error pages for a given site and locale.
      * @param {RouteOptions} routeOptions - Route options containing language and site name to load error pages
-     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests (like retries and fetch)
+     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests
      * @returns {ErrorPages | null} A promise that resolves to the error pages or null if not found.
      */
     async getErrorPages(routeOptions, fetchOptions) {
@@ -134,7 +135,7 @@ export class SitecoreClient {
     /**
      * Retrieves preview page and layout details
      * @param {EditingPreviewData | undefined} previewData - The editing preview data for metadata mode.
-     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests (like retries and fetch)
+     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests
      * @returns {Page} preview page details
      */
     async getPreview(previewData, fetchOptions) {
@@ -168,7 +169,7 @@ export class SitecoreClient {
     /**
      * Get design library page details for Design Library mode of your app
      * @param {DesignLibraryRenderPreviewData} designLibData preview data set in 'library' mode of the app
-     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests (like retries and fetch)
+     * @param {FetchOptions} [fetchOptions] Additional fetch fetch options to override GraphQL requests
      * @returns {Page} preview page for Design Library
      */
     async getDesignLibraryData(designLibData, fetchOptions) {
@@ -253,6 +254,19 @@ export class SitecoreClient {
             .join('')}
       </sitemapindex>`;
     }
+    /**
+     * Retrieves the robots.txt content for a given site name.
+     *
+     * @param {string} siteName - The name of the site to retrieve the robots.txt for.
+     * @param {FetchOptions} [fetchOptions] - Optional fetch options.
+     * @returns {Promise<string | null>} A promise that resolves to the robots.txt content,
+     * or null if no content is found.
+     */
+    async getRobots(siteName, fetchOptions) {
+        const robotsService = this.getRobotsService(siteName || this.initOptions.defaultSite);
+        const content = await robotsService.fetchRobots(fetchOptions);
+        return content || null;
+    }
     /**
      * Factory methods for creating dependencies
      * Subclasses can override these to provide custom implementations.
@@ -263,6 +277,12 @@ export class SitecoreClient {
             siteName,
         });
     }
+    getRobotsService(siteName) {
+        return new GraphQLRobotsService({
+            clientFactory: this.clientFactory,
+            siteName,
+        });
+    }
     getBaseServiceOptions() {
         return {
             defaultSite: this.initOptions.defaultSite,

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

@@ -7,9 +7,9 @@ import { DefaultRetryStrategy } from '../retries';
 export const getFallbackConfig = () => ({
     api: {
         edge: {
-            contextId: '',
+            contextId: process.env.SITECORE_EDGE_CONTEXT_ID || '',
             clientContextId: '',
-            edgeUrl: SITECORE_EDGE_URL_DEFAULT,
+            edgeUrl: process.env.SITECORE_EDGE_URL || SITECORE_EDGE_URL_DEFAULT,
         },
         local: {
             apiKey: '',
@@ -17,7 +17,7 @@ export const getFallbackConfig = () => ({
             path: '/sitecore/api/graph/edge',
         },
     },
-    editingSecret: 'editing-secret-missing',
+    editingSecret: process.env.JSS_EDITING_SECRET || 'editing-secret-missing',
     retries: {
         count: 3,
         retryStrategy: new DefaultRetryStrategy({
@@ -34,8 +34,8 @@ export const getFallbackConfig = () => ({
     },
     personalize: {
         enabled: process.env.NODE_ENV !== 'development',
-        edgeTimeout: 400,
-        cdpTimeout: 400,
+        edgeTimeout: parseInt(process.env.PERSONALIZE_MIDDLEWARE_EDGE_TIMEOUT, 10) || 400,
+        cdpTimeout: parseInt(process.env.PERSONALIZE_MIDDLEWARE_CDP_TIMEOUT, 10) || 400,
         scope: '',
         channel: 'WEB',
         currency: 'USD',

package/dist/esm/constants.js

@@ -8,3 +8,5 @@ export var SitecoreTemplateId;
 export const siteNameError = 'The siteName cannot be empty';
 export const SITECORE_EDGE_URL_DEFAULT = 'https://edge-platform.sitecorecloud.io';
 export const HIDDEN_RENDERING_NAME = 'Hidden Rendering';
+export const DEFAULT_SITECORE_AUTH_ENDPOINT = 'https://auth.sitecorecloud.io/oauth/token';
+export const DEFAULT_SITECORE_AUTH_AUDIENCE = 'https://api.sitecorecloud.io';