@sitecore-content-sdk/core 0.1.0 → 0.2.0-beta.10

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/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
@@ -19,16 +20,19 @@ class SitecoreClient {
      * @param {SitecoreClientInit} initOptions initOptions for the client, containing site and Sitecore connection details
      */
     constructor(initOptions) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
         this.initOptions = initOptions;
         this.clientFactory = this.getClientFactory();
-        this.siteResolver = this.getSiteResolver();
+        this.siteResolver = (_b = (_a = initOptions.custom) === null || _a === void 0 ? void 0 : _a.siteResolver) !== null && _b !== void 0 ? _b : this.getSiteResolver();
         const baseServiceOptions = this.getBaseServiceOptions();
-        this.layoutService = this.getLayoutService(baseServiceOptions);
-        this.dictionaryService = this.getDictionaryService(baseServiceOptions);
-        this.editingService = this.getEditingService();
-        this.errorPagesService = this.getErrorPagesService();
+        this.layoutService =
+            (_d = (_c = initOptions.custom) === null || _c === void 0 ? void 0 : _c.layoutService) !== null && _d !== void 0 ? _d : this.getLayoutService(baseServiceOptions);
+        this.dictionaryService =
+            (_f = (_e = initOptions.custom) === null || _e === void 0 ? void 0 : _e.dictionaryService) !== null && _f !== void 0 ? _f : this.getDictionaryService(baseServiceOptions);
+        this.editingService = (_h = (_g = initOptions.custom) === null || _g === void 0 ? void 0 : _g.editingService) !== null && _h !== void 0 ? _h : this.getEditingService();
+        this.errorPagesService = (_k = (_j = initOptions.custom) === null || _j === void 0 ? void 0 : _j.errorPagesService) !== null && _k !== void 0 ? _k : this.getErrorPagesService();
+        this.sitePathService = (_m = (_l = initOptions.custom) === null || _l === void 0 ? void 0 : _l.sitePathService) !== null && _m !== void 0 ? _m : this.getSitePathService();
         this.componentService = this.getComponentService();
-        this.sitePathService = this.getSitePathService();
     }
     /**
      * Resolve site by hostname
@@ -59,7 +63,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 +119,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 +130,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 +141,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 +175,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 +260,18 @@ 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 +282,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,148 @@
+"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");
+const taxonomies_1 = require("./taxonomies");
+/**
+ * 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) {
+        var _a;
+        debug_1.default.content('Getting locale for id: %s', id);
+        const response = await this.get(locales_1.GET_LOCALE_QUERY, { id });
+        return ((_a = response.locale) === null || _a === void 0 ? void 0 : _a.system) || null;
+    }
+    /**
+     * Retrieves all available locales from the content service.
+     * @returns A promise that resolves to an array of locales.
+     */
+    async getLocales() {
+        var _a, _b;
+        debug_1.default.content('Getting all locales');
+        const response = await this.get(locales_1.GET_LOCALES_QUERY);
+        return (_b = (_a = response === null || response === void 0 ? void 0 : response.manyLocale) === null || _a === void 0 ? void 0 : _a.map((entry) => entry.system)) !== null && _b !== void 0 ? _b : [];
+    }
+    /**
+     * Retrieves all available taxonomies with optional pagination support.
+     * @param {object} [options] - Optional pagination options.
+     * @param {number} [options.pageSize] - Limits the number of taxonomies returned per page. Defaults to the API's default
+     * @param {string} [options.after] - Cursor for pagination; use the `cursor` returned from the previous call to fetch the next page.
+     * @returns A promise that resolves to an object containing taxonomies, their terms, and pagination info.
+     */
+    async getTaxonomies(options) {
+        var _a, _b, _c, _d, _e;
+        debug_1.default.content('Getting taxonomies (pageSize: %s, after: %s)', (_a = options === null || options === void 0 ? void 0 : options.pageSize) !== null && _a !== void 0 ? _a : 'API Default', (_b = options === null || options === void 0 ? void 0 : options.after) !== null && _b !== void 0 ? _b : '');
+        const variables = {
+            pageSize: options === null || options === void 0 ? void 0 : options.pageSize,
+            after: (_c = options === null || options === void 0 ? void 0 : options.after) !== null && _c !== void 0 ? _c : '',
+        };
+        const response = await this.get(taxonomies_1.GET_TAXONOMIES_QUERY, variables);
+        const data = response === null || response === void 0 ? void 0 : response.manyTaxonomy;
+        return {
+            results: ((_d = data === null || data === void 0 ? void 0 : data.results) !== null && _d !== void 0 ? _d : []).map((taxonomy) => {
+                var _a, _b;
+                return ({
+                    system: taxonomy.system,
+                    terms: (_b = (_a = taxonomy.terms) === null || _a === void 0 ? void 0 : _a.results) !== null && _b !== void 0 ? _b : [],
+                });
+            }),
+            cursor: data === null || data === void 0 ? void 0 : data.cursor,
+            hasMore: (_e = data === null || data === void 0 ? void 0 : data.hasMore) !== null && _e !== void 0 ? _e : false,
+        };
+    }
+    /**
+     * Retrieves a taxonomy by its ID, with optional pagination support for its terms.
+     * @param {object} options - Options for fetching the taxonomy.
+     * @param {string} options.id - The unique identifier of the taxonomy.
+     * @param {object} [options.terms] - Optional pagination options for terms.
+     * @param {number} [options.terms.pageSize] - Optional. Limits the number of terms returned per page.
+     * @param {string} [options.terms.after] - Optional. Cursor for pagination. Used to fetch the next page of terms.
+     * @returns A promise that resolves to the taxonomy object, including pagination metadata (`hasMore`, `cursor`) for its terms. Returns `null` if the taxonomy is not found.
+     */
+    async getTaxonomy({ id, terms, }) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        debug_1.default.content('Getting taxonomy for id: %s (termsPageSize: %s, termsAfter: %s)', id, (_a = terms === null || terms === void 0 ? void 0 : terms.pageSize) !== null && _a !== void 0 ? _a : 'API Default', (_b = terms === null || terms === void 0 ? void 0 : terms.after) !== null && _b !== void 0 ? _b : '');
+        const variables = {
+            id,
+            termsPageSize: terms === null || terms === void 0 ? void 0 : terms.pageSize,
+            termsAfter: terms === null || terms === void 0 ? void 0 : terms.after,
+        };
+        const response = await this.get(taxonomies_1.GET_TAXONOMY_QUERY, variables);
+        const taxonomy = response === null || response === void 0 ? void 0 : response.taxonomy;
+        if (!taxonomy)
+            return null;
+        return {
+            system: taxonomy.system,
+            terms: {
+                results: (_d = (_c = taxonomy.terms) === null || _c === void 0 ? void 0 : _c.results) !== null && _d !== void 0 ? _d : [],
+                cursor: (_e = taxonomy.terms) === null || _e === void 0 ? void 0 : _e.cursor,
+                hasMore: (_g = (_f = taxonomy.terms) === null || _f === void 0 ? void 0 : _f.hasMore) !== null && _g !== void 0 ? _g : false,
+            },
+        };
+    }
+}
+exports.ContentClient = ContentClient;

package/dist/cjs/content/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContentUrl = exports.GET_TAXONOMIES_QUERY = exports.GET_TAXONOMY_QUERY = 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 taxonomies_1 = require("./taxonomies");
+Object.defineProperty(exports, "GET_TAXONOMY_QUERY", { enumerable: true, get: function () { return taxonomies_1.GET_TAXONOMY_QUERY; } });
+Object.defineProperty(exports, "GET_TAXONOMIES_QUERY", { enumerable: true, get: function () { return taxonomies_1.GET_TAXONOMIES_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,32 @@
+"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) {
+      system {
+        id
+        label
+      }
+    }
+  }
+`;
+/**
+ * GraphQL query to retrieve all available locales.
+ */
+exports.GET_LOCALES_QUERY = `
+  query GetAllLocales {
+    manyLocale {
+      system {
+        id
+        label
+      }
+    }
+  }
+`;

package/dist/cjs/content/taxonomies.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GET_TAXONOMY_QUERY = exports.GET_TAXONOMIES_QUERY = void 0;
+// --- GraphQL queries ---
+/**
+ * GraphQL query to retrieve all taxonomies with optional pagination for taxonomies only.
+ *
+ * Variables:
+ * - pageSize: The number of taxonomies to retrieve per page.
+ * - after: The cursor for fetching the next page of taxonomies.
+ */
+exports.GET_TAXONOMIES_QUERY = `
+  query GetAllTaxonomies(
+    $pageSize: Int
+    $after: String
+  ) {
+    manyTaxonomy(minimumPageSize: $pageSize, after: $after) {
+      cursor
+      hasMore
+      results {
+        terms {
+          cursor
+          hasMore
+          results {
+            id
+            name
+            label
+          }
+        }
+        system {
+          id
+          name
+          version
+          label
+          createdAt
+          createdBy
+          updatedAt
+          updatedBy
+          publishStatus
+        }
+      }
+    }
+  }
+`;
+/**
+ * GraphQL query to retrieve a specific taxonomy by its ID, with optional pagination for its terms.
+ *
+ * Variables:
+ * - id: The unique ID of the taxonomy to retrieve.
+ * - termsPageSize: The number of terms to retrieve per page.
+ * - termsAfter: The cursor for fetching the next page of terms.
+ */
+exports.GET_TAXONOMY_QUERY = `
+  query GetTaxonomyById($id: ID!, $termsPageSize: Int, $termsAfter: String) {
+    taxonomy(id: $id) {
+      terms(minimumPageSize: $termsPageSize, after: $termsAfter) {
+        cursor
+        hasMore
+        results {
+          id
+          name
+          label
+        }
+      }
+      system {
+        id
+        name
+        version
+        label
+        createdAt
+        createdBy
+        updatedAt
+        updatedBy
+        publishStatus
+      }
+    }
+  }
+`;

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/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/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/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 {