@sitecore-content-sdk/core 0.2.0-beta.2 → 0.2.0-beta.21

package/dist/cjs/tools/auth/tenant-store.js

@@ -0,0 +1,250 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unitMocks = exports.getAllTenantsInfo = exports.deleteTenantAuthInfo = exports.readTenantInfo = exports.writeTenantInfo = exports.readTenantAuthInfo = exports.writeTenantAuthInfo = exports.decodeJwtPayload = void 0;
+exports.getTenantPath = getTenantPath;
+/* eslint-disable jsdoc/require-jsdoc */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const encryption_1 = require("./encryption");
+const constants_1 = require("./../../constants");
+const rootDir = path.join(os.homedir(), '.sitecore', 'sitecore-tools');
+/**
+ * Decodes a JWT without verifying its signature.
+ * @param {string} token - The access token string.
+ * @returns Decoded payload object or null if invalid.
+ */
+exports.decodeJwtPayload = _decodeJwtPayload;
+/**
+ * Write the authentication configuration for a tenant.
+ * @param {string} tenantId - The tenant ID.
+ * @param {TenantAuth} authInfo - The tenant's auth data.
+ */
+exports.writeTenantAuthInfo = _writeTenantAuthInfo;
+/**
+ * Read the authentication configuration for a tenant.
+ * @param {string} tenantId - The tenant ID.
+ * @returns Parsed auth config or null if not found or failed to read.
+ */
+exports.readTenantAuthInfo = _readTenantAuthInfo;
+/**
+ * Write the public metadata information for a tenant.
+ * @param {TenantInfo} info - The tenant info object.
+ */
+exports.writeTenantInfo = _writeTenantInfo;
+/**
+ * Read the public metadata information for a tenant.
+ * @param {string} tenantId - The tenant ID.
+ * @returns Parsed tenant info or null if not found or failed to read.
+ */
+exports.readTenantInfo = _readTenantInfo;
+/**
+ * Deletes the stored auth.json file for the given tenant.
+ * @param {string} tenantId - The tenant ID.
+ */
+exports.deleteTenantAuthInfo = _deleteTenantAuthInfo;
+/**
+ * Scans the CLI root directory and returns all valid tenant infos.
+ * @returns A list of TenantInfo objects found in {tenant-id}/info.json files.
+ */
+exports.getAllTenantsInfo = _getAllTenantsInfo;
+// mock setup for unit tests to make sinon happy and mock-able with esbuild/tsx
+// https://sinonjs.org/how-to/typescript-swc/
+// This, plus the `_` names make the exports writable for sinon
+exports.unitMocks = {
+    set decodeJwtPayload(mockImplementation) {
+        exports.decodeJwtPayload = mockImplementation;
+    },
+    get decodeJwtPayload() {
+        return _decodeJwtPayload;
+    },
+    set writeTenantAuthInfo(mockImplementation) {
+        exports.writeTenantAuthInfo = mockImplementation;
+    },
+    get writeTenantAuthInfo() {
+        return _writeTenantAuthInfo;
+    },
+    set readTenantAuthInfo(mockImplementation) {
+        exports.readTenantAuthInfo = mockImplementation;
+    },
+    get readTenantAuthInfo() {
+        return _readTenantAuthInfo;
+    },
+    set writeTenantInfo(mockImplementation) {
+        exports.writeTenantInfo = mockImplementation;
+    },
+    get writeTenantInfo() {
+        return _writeTenantInfo;
+    },
+    set readTenantInfo(mockImplementation) {
+        exports.readTenantInfo = mockImplementation;
+    },
+    get readTenantInfo() {
+        return _readTenantInfo;
+    },
+    set deleteTenantAuthInfo(mockImplementation) {
+        exports.deleteTenantAuthInfo = mockImplementation;
+    },
+    get deleteTenantAuthInfo() {
+        return _deleteTenantAuthInfo;
+    },
+    set getAllTenantsInfo(mockImplementation) {
+        exports.getAllTenantsInfo = mockImplementation;
+    },
+    get getAllTenantsInfo() {
+        return _getAllTenantsInfo;
+    },
+};
+/**
+ * Get the full path to the tenant-specific folder.
+ * @param {string} tenantId - The tenant ID.
+ * @returns The absolute path to the tenant directory.
+ */
+function getTenantPath(tenantId) {
+    return path.join(rootDir, tenantId);
+}
+async function _writeTenantAuthInfo(tenantId, authInfo) {
+    try {
+        const dir = getTenantPath(tenantId);
+        fs.mkdirSync(dir, { recursive: true });
+        const encrypted = await (0, encryption_1.encryptData)(JSON.stringify(authInfo), tenantId);
+        fs.writeFileSync(path.join(dir, 'auth.json'), JSON.stringify(encrypted));
+    }
+    catch (error) {
+        console.error(`\n Failed to write auth.json for tenant '${tenantId}': ${error.message}`);
+    }
+}
+async function _readTenantAuthInfo(tenantId) {
+    const filePath = path.join(getTenantPath(tenantId), 'auth.json');
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        const encryptedPayloadRaw = fs.readFileSync(filePath, 'utf8');
+        const encryptedPayload = JSON.parse(encryptedPayloadRaw);
+        const decryptedData = await (0, encryption_1.decryptData)(encryptedPayload, tenantId, true);
+        if (decryptedData === null) {
+            return null;
+        }
+        return JSON.parse(decryptedData);
+    }
+    catch (error) {
+        console.error(`\n Failed to read auth.json for tenant '${tenantId}': ${error.message}`);
+        return null;
+    }
+}
+async function _writeTenantInfo(info) {
+    try {
+        const dir = getTenantPath(info.tenantId);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, 'info.json'), JSON.stringify(info, null, 2));
+    }
+    catch (error) {
+        console.error(`\n Failed to write info.json for tenant '${info.tenantId}': ${error.message}`);
+    }
+}
+async function _readTenantInfo(tenantId) {
+    const infoFilePath = path.join(getTenantPath(tenantId), 'info.json');
+    if (!fs.existsSync(infoFilePath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(infoFilePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.error(`\n Failed to read info.json for tenant '${tenantId}': ${error.message}`);
+        return null;
+    }
+}
+async function _deleteTenantAuthInfo(tenantId) {
+    const filePath = path.join(getTenantPath(tenantId), 'auth.json');
+    try {
+        if (fs.existsSync(filePath)) {
+            fs.unlinkSync(filePath);
+        }
+    }
+    catch (error) {
+        console.error(`\n Failed to delete auth.json for tenant '${tenantId}': ${error.message}`);
+    }
+}
+function _getAllTenantsInfo() {
+    if (!fs.existsSync(rootDir))
+        return [];
+    const subDirs = fs
+        .readdirSync(rootDir)
+        .filter((entry) => fs.statSync(path.join(rootDir, entry)).isDirectory());
+    const tenants = [];
+    for (const dir of subDirs) {
+        const infoPath = path.join(rootDir, dir, 'info.json');
+        if (fs.existsSync(infoPath)) {
+            try {
+                const content = fs.readFileSync(infoPath, 'utf-8');
+                const data = JSON.parse(content);
+                if (data.tenantId && data.tenantName && data.organizationId) {
+                    tenants.push({
+                        tenantId: data.tenantId,
+                        tenantName: data.tenantName,
+                        organizationId: data.organizationId,
+                        clientId: data.clientId,
+                        authority: data.authority,
+                        audience: data.audience,
+                        baseUrl: data.baseUrl,
+                    });
+                }
+            }
+            catch (error) {
+                console.error('\n Failed to read tenant info file', error.message);
+            }
+        }
+    }
+    return tenants;
+}
+function _decodeJwtPayload(token) {
+    try {
+        const base64Payload = token.split('.')[1];
+        const payload = Buffer.from(base64Payload, 'base64').toString('utf-8');
+        const decoded = JSON.parse(payload);
+        return {
+            tokenTenantId: decoded === null || decoded === void 0 ? void 0 : decoded[`${constants_1.CLAIMS}/tenant_id`],
+            tokenOrgId: decoded === null || decoded === void 0 ? void 0 : decoded[`${constants_1.CLAIMS}/org_id`],
+            tokenTenantName: decoded === null || decoded === void 0 ? void 0 : decoded[`${constants_1.CLAIMS}/tenant_name`],
+        };
+    }
+    catch (error) {
+        console.error('\n Failed to decode access token:', error.message);
+        return null;
+    }
+}

package/dist/cjs/tools/index.js

@@ -10,11 +10,33 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.scaffoldComponent = exports.generateMetadata = exports.generateSites = void 0;
+exports.auth = 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 +44,6 @@ 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);
+__exportStar(require("./auth/models"), exports);
+const auth = __importStar(require("./auth"));
+exports.auth = auth;

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
@@ -16,16 +17,19 @@ export 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
@@ -56,7 +60,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 +116,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 +127,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 +138,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 +172,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 +257,18 @@ 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 +279,12 @@ export class SitecoreClient {
             siteName,
         });
     }
+    getRobotsService(siteName) {
+        return new GraphQLRobotsService({
+            clientFactory: this.clientFactory,
+            siteName,
+        });
+    }
     getBaseServiceOptions() {
         return {
             defaultSite: this.initOptions.defaultSite,
@@ -294,12 +316,7 @@ export class SitecoreClient {
         return new GraphQLErrorPagesService(Object.assign(Object.assign({}, this.initOptions), { language: this.initOptions.defaultLanguage, clientFactory: this.clientFactory }));
     }
     getComponentService() {
-        var _a, _b;
-        return new RestComponentLayoutService({
-            apiHost: (_a = this.initOptions.api.local) === null || _a === void 0 ? void 0 : _a.apiHost,
-            apiKey: (_b = this.initOptions.api.local) === null || _b === void 0 ? void 0 : _b.apiKey,
-            siteName: this.initOptions.defaultSite,
-        });
+        return new RestComponentLayoutService(this.initOptions.api.edge);
     }
     getSitePathService() {
         return new GraphQLSitePathService({

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',
@@ -51,6 +51,7 @@ export const getFallbackConfig = () => ({
             timeout: 60,
         },
     },
+    disableCodeGeneration: false,
 });
 /**
  * Merges two SitecoreConfig objects

package/dist/esm/constants.js

@@ -8,3 +8,14 @@ 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';
+// Sitecore Auth constants
+export const DEFAULT_SITECORE_AUTH_DOMAIN = 'https://auth.sitecorecloud.io';
+export const DEFAULT_SITECORE_AUTH_AUDIENCE = 'https://api.sitecorecloud.io';
+export const DEFAULT_SITECORE_AUTH_BASE_URL = 'https://edge-platform.sitecorecloud.io/cs/api';
+export const CLAIMS = 'https://auth.sitecorecloud.io/claims';
+export const CLIENT_GRANT_TYPE = 'client_credentials';
+export const DEVICE_GRANT_TYPE = 'urn:ietf:params:oauth:grant-type:device_code';
+export const REFRESH_GRANT_TYPE = 'refresh_token';
+export const SCOPE = 'openid profile email offline_access';
+export const TIMEOUT = 600;
+export const DEFAULT_INTERVAL = 10;

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

@@ -0,0 +1,141 @@
+import { GraphQLRequestClient } from '../graphql-request-client';
+import { getContentUrl } from './utils';
+import debug from '../debug';
+import { GET_LOCALE_QUERY, GET_LOCALES_QUERY, } from './locales';
+import { GET_TAXONOMY_QUERY, GET_TAXONOMIES_QUERY, } from './taxonomies';
+/**
+ * Class representing a client for interacting with the Content API.
+ */
+export class ContentClient {
+    constructor({ url, tenant, environment, preview = false, token }) {
+        this.endpoint = getContentUrl({
+            environment,
+            preview,
+            tenant,
+            url,
+        });
+        this.graphqlClient = new GraphQLRequestClient(this.endpoint, {
+            headers: {
+                Authorization: `Bearer ${token}`,
+            },
+            debugger: debug.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.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.content('Getting locale for id: %s', id);
+        const response = await this.get(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.content('Getting all locales');
+        const response = await this.get(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.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(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.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(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,
+            },
+        };
+    }
+}

package/dist/esm/content/index.js

@@ -0,0 +1,4 @@
+export { ContentClient } from './content-client';
+export { GET_LOCALE_QUERY, GET_LOCALES_QUERY, } from './locales';
+export { GET_TAXONOMY_QUERY, GET_TAXONOMIES_QUERY, } from './taxonomies';
+export { getContentUrl } from './utils';