@sitecore-content-sdk/core 0.1.0-beta.1

package/dist/cjs/editing/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getComponentLibraryStatusEvent = exports.ComponentLibraryStatus = exports.addComponentUpdateHandler = exports.MetadataKind = exports.LayoutKind = exports.RestComponentLayoutService = exports.PAGES_EDITING_MARKER = exports.QUERY_PARAM_EDITING_SECRET = exports.EDITING_ALLOWED_ORIGINS = exports.getJssPagesClientData = exports.resetEditorChromes = exports.isEditorActive = exports.PagesEditor = exports.DEFAULT_PLACEHOLDER_UID = exports.GraphQLEditingService = void 0;
+var graphql_editing_service_1 = require("./graphql-editing-service");
+Object.defineProperty(exports, "GraphQLEditingService", { enumerable: true, get: function () { return graphql_editing_service_1.GraphQLEditingService; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "DEFAULT_PLACEHOLDER_UID", { enumerable: true, get: function () { return utils_1.DEFAULT_PLACEHOLDER_UID; } });
+Object.defineProperty(exports, "PagesEditor", { enumerable: true, get: function () { return utils_1.PagesEditor; } });
+Object.defineProperty(exports, "isEditorActive", { enumerable: true, get: function () { return utils_1.isEditorActive; } });
+Object.defineProperty(exports, "resetEditorChromes", { enumerable: true, get: function () { return utils_1.resetEditorChromes; } });
+Object.defineProperty(exports, "getJssPagesClientData", { enumerable: true, get: function () { return utils_1.getJssPagesClientData; } });
+Object.defineProperty(exports, "EDITING_ALLOWED_ORIGINS", { enumerable: true, get: function () { return utils_1.EDITING_ALLOWED_ORIGINS; } });
+Object.defineProperty(exports, "QUERY_PARAM_EDITING_SECRET", { enumerable: true, get: function () { return utils_1.QUERY_PARAM_EDITING_SECRET; } });
+Object.defineProperty(exports, "PAGES_EDITING_MARKER", { enumerable: true, get: function () { return utils_1.PAGES_EDITING_MARKER; } });
+var rest_component_layout_service_1 = require("./rest-component-layout-service");
+Object.defineProperty(exports, "RestComponentLayoutService", { enumerable: true, get: function () { return rest_component_layout_service_1.RestComponentLayoutService; } });
+var models_1 = require("./models");
+Object.defineProperty(exports, "LayoutKind", { enumerable: true, get: function () { return models_1.LayoutKind; } });
+Object.defineProperty(exports, "MetadataKind", { enumerable: true, get: function () { return models_1.MetadataKind; } });
+var component_library_1 = require("./component-library");
+Object.defineProperty(exports, "addComponentUpdateHandler", { enumerable: true, get: function () { return component_library_1.addComponentUpdateHandler; } });
+Object.defineProperty(exports, "ComponentLibraryStatus", { enumerable: true, get: function () { return component_library_1.ComponentLibraryStatus; } });
+Object.defineProperty(exports, "getComponentLibraryStatusEvent", { enumerable: true, get: function () { return component_library_1.getComponentLibraryStatusEvent; } });

package/dist/cjs/editing/models.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataKind = exports.LayoutKind = void 0;
+/**
+ * Represents the Editing Layout variant.
+ * - shared - shared layout
+ * - final - final layout
+ */
+var LayoutKind;
+(function (LayoutKind) {
+    LayoutKind["Final"] = "final";
+    LayoutKind["Shared"] = "shared";
+})(LayoutKind || (exports.LayoutKind = LayoutKind = {}));
+/**
+ * Represents the kind of metadata element.
+ * - open - starting chrome element
+ * - close - closing chrome element
+ */
+var MetadataKind;
+(function (MetadataKind) {
+    MetadataKind["Open"] = "open";
+    MetadataKind["Close"] = "close";
+})(MetadataKind || (exports.MetadataKind = MetadataKind = {}));

package/dist/cjs/editing/rest-component-layout-service.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RestComponentLayoutService = void 0;
+const __1 = require("..");
+const data_fetcher_1 = require("../data-fetcher");
+/**
+ * REST service that enables Component Library functioality
+ * Makes a request to /sitecore/api/layout/component in 'library' mode in Pages.
+ * Returns layoutData for one single rendered component
+ */
+class RestComponentLayoutService {
+    constructor(config) {
+        this.config = config;
+        this.getFetcher = (req, res) => {
+            return this.config.dataFetcherResolver
+                ? this.config.dataFetcherResolver(req, res)
+                : this.getDefaultFetcher(req);
+        };
+        /**
+         * Provides default @see NativeDataFetcher data fetcher
+         * @param {IncomingMessage} [req] Request instance
+         * @returns default fetcher
+         */
+        this.getDefaultFetcher = (req) => {
+            var _a;
+            const config = {
+                debugger: __1.debug.editing,
+            };
+            const nativeFetcher = new __1.NativeDataFetcher(config);
+            const headers = req && Object.assign(Object.assign({}, req.headers), (((_a = req.socket) === null || _a === void 0 ? void 0 : _a.remoteAddress) ? { 'X-Forwarded-For': req.socket.remoteAddress } : {}));
+            const fetcher = (url, data) => {
+                data = Object.assign(Object.assign({}, data), { headers: headers });
+                return nativeFetcher.fetch(url, data);
+            };
+            return fetcher;
+        };
+    }
+    fetchComponentData(params, req, res) {
+        params.siteName = params.siteName || this.config.siteName;
+        const querystringParams = this.getComponentFetchParams(params);
+        __1.debug.layout('fetching component with uid %s for %s %s %s', params.componentUid, params.itemId, params.language, params.siteName);
+        const fetcher = this.getFetcher(req, res);
+        const fetchUrl = this.resolveLayoutServiceUrl('component');
+        return (0, data_fetcher_1.fetchData)(fetchUrl, fetcher, querystringParams).catch((error) => {
+            var _a;
+            if (((_a = error.response) === null || _a === void 0 ? void 0 : _a.status) === 404) {
+                return error.response.data;
+            }
+            throw error;
+        });
+    }
+    /**
+     * Resolves layout service url
+     * @param {string} apiType which layout service API to call ('render' or 'placeholder')
+     * @returns the layout service url
+     */
+    resolveLayoutServiceUrl(apiType) {
+        const { apiHost = '', configurationName = 'jss' } = this.config;
+        return `${apiHost}/sitecore/api/layout/${apiType}/${configurationName}`;
+    }
+    getComponentFetchParams(params) {
+        // exclude undefined params with this one simple trick
+        return JSON.parse(JSON.stringify({
+            sc_apikey: this.config.apiKey,
+            item: params.itemId,
+            uid: params.componentUid,
+            dataSourceId: params.dataSourceId,
+            renderingItemId: params.renderingId,
+            version: params.version,
+            sc_site: params.siteName,
+            sc_lang: params.language || 'en',
+            sc_mode: params.editMode,
+        }));
+    }
+}
+exports.RestComponentLayoutService = RestComponentLayoutService;

package/dist/cjs/editing/utils.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getJssPagesClientData = exports.resetEditorChromes = exports.isEditorActive = exports.PagesEditor = exports.ChromeRediscoveryGlobalFunctionName = exports.EDITING_ALLOWED_ORIGINS = exports.PAGES_EDITING_MARKER = exports.QUERY_PARAM_EDITING_SECRET = exports.DEFAULT_PLACEHOLDER_UID = void 0;
+const is_server_1 = __importDefault(require("../utils/is-server"));
+/**
+ * Default value of uid for root placeholder when uid is not present.
+ */
+exports.DEFAULT_PLACEHOLDER_UID = '00000000-0000-0000-0000-000000000000';
+/**
+ * Query parameter for editing secret
+ */
+exports.QUERY_PARAM_EDITING_SECRET = 'secret';
+/**
+ * ID to be used as a marker for a script rendered in XMC Pages
+ * Should identify app is in XM Cloud Pages editing mode
+ */
+exports.PAGES_EDITING_MARKER = 'jss-hrz-editing';
+/**
+ * Default allowed origins for editing requests. This is used to enforce CORS, CSP headers.
+ */
+exports.EDITING_ALLOWED_ORIGINS = ['https://pages.sitecorecloud.io'];
+/**
+ * Copy of chrome rediscovery contract from Horizon (chrome-rediscovery.contract.ts)
+ */
+exports.ChromeRediscoveryGlobalFunctionName = {
+    name: 'Sitecore.Horizon.ResetChromes',
+};
+/**
+ * Static utility class for Sitecore Pages Editor
+ */
+class PagesEditor {
+    /**
+     * Determines whether the current execution context is within a Pages Editor.
+     * Pages Editor environment can be identified only in the browser
+     * @returns true if executing within a Pages Editor
+     */
+    static isActive() {
+        if ((0, is_server_1.default)()) {
+            return false;
+        }
+        // Check for Chromes mode
+        const chromesCheck = window.location.search.indexOf('sc_headless_mode=edit') > -1;
+        // JSS will render a jss-exclusive script element in Metadata mode to indicate edit mode in Pages
+        return chromesCheck || !!window.document.getElementById(exports.PAGES_EDITING_MARKER);
+    }
+    static resetChromes() {
+        if ((0, is_server_1.default)()) {
+            return;
+        }
+        // Reset chromes in Pages
+        window[exports.ChromeRediscoveryGlobalFunctionName.name] &&
+            window[exports.ChromeRediscoveryGlobalFunctionName.name]();
+    }
+}
+exports.PagesEditor = PagesEditor;
+/**
+ * Determines whether the current execution context is within a Sitecore editor.
+ * Sitecore Editor environment can be identified only in the browser
+ * @returns true if executing within a Sitecore editor
+ */
+const isEditorActive = () => {
+    return PagesEditor.isActive();
+};
+exports.isEditorActive = isEditorActive;
+/**
+ * Resets Sitecore editor "chromes"
+ */
+const resetEditorChromes = () => {
+    if (PagesEditor.isActive()) {
+        PagesEditor.resetChromes();
+    }
+};
+exports.resetEditorChromes = resetEditorChromes;
+/**
+ * Gets extra JSS clientData scripts to render in XMC Pages in addition to clientData from Pages itself
+ * @returns {Record} collection of clientData
+ */
+const getJssPagesClientData = () => {
+    const clientData = {};
+    clientData[exports.PAGES_EDITING_MARKER] = {};
+    return clientData;
+};
+exports.getJssPagesClientData = getJssPagesClientData;

package/dist/cjs/graphql/app-root-query.js

@@ -0,0 +1,73 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.languageError = exports.siteNameError = void 0;
+exports.getAppRootId = getAppRootId;
+const constants_1 = require("../constants");
+/** @private */
+exports.siteNameError = 'The site name must be a non-empty string';
+/** @private */
+exports.languageError = 'The language must be a non-empty string';
+/*
+ * GraphQL query that returns the ID of the root item of the specified site and language
+ */
+const appRootQuery = /* GraphQL */ `
+  query AppRootQuery($jssAppTemplateId: String!, $siteName: String!, $language: String!) {
+    layout(site: $siteName, routePath: "/", language: $language) {
+      homePage: item {
+        rootItem: ancestors(includeTemplateIDs: [$jssAppTemplateId]) {
+          id
+        }
+      }
+    }
+  }
+`;
+/**
+ * Gets the ID of the JSS App root item for the specified site and language.
+ * @param {GraphQLClient} client that fetches data from a GraphQL endpoint.
+ * @param {string} siteName the name of the Sitecore site.
+ * @param {string} language the item language version.
+ * @param {string} [jssAppTemplateId] optional template ID of the app root item. If not
+ * specified, the ID of the "/sitecore/templates/Foundation/JavaScript Services/App"
+ * item is used.
+ * @returns the root item ID of the JSS App in Sitecore. Returns null if the app root item is not found.
+ * @throws {RangeError} if a valid site name value is not provided.
+ * @throws {RangeError} if a valid language value is not provided.
+ * @summary This function intentionally avoids throwing an error if a root item is not found,
+ * leaving that decision up to implementations.
+ */
+function getAppRootId(client, siteName, language, jssAppTemplateId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        if (!siteName) {
+            throw new RangeError(exports.siteNameError);
+        }
+        if (!language) {
+            throw new RangeError(exports.languageError);
+        }
+        let fetchResponse = yield client.request(appRootQuery, {
+            jssAppTemplateId: jssAppTemplateId || constants_1.SitecoreTemplateId.JssApp,
+            siteName,
+            language,
+        });
+        if (!((_c = (_b = (_a = fetchResponse === null || fetchResponse === void 0 ? void 0 : fetchResponse.layout) === null || _a === void 0 ? void 0 : _a.homePage) === null || _b === void 0 ? void 0 : _b.rootItem) === null || _c === void 0 ? void 0 : _c.length) && language !== 'en') {
+            fetchResponse = yield client.request(appRootQuery, {
+                jssAppTemplateId: jssAppTemplateId || constants_1.SitecoreTemplateId.JssApp,
+                siteName,
+                language: 'en',
+            });
+        }
+        if (!((_f = (_e = (_d = fetchResponse === null || fetchResponse === void 0 ? void 0 : fetchResponse.layout) === null || _d === void 0 ? void 0 : _d.homePage) === null || _e === void 0 ? void 0 : _e.rootItem) === null || _f === void 0 ? void 0 : _f.length)) {
+            return null;
+        }
+        return fetchResponse.layout.homePage.rootItem[0].id;
+    });
+}

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEdgeProxyFormsUrl = exports.getEdgeProxyContentUrl = void 0;
+const constants_1 = require("../constants");
+/**
+ * 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) => `${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.
+ * @param {string} sitecoreEdgeContextId - The unique context id.
+ * @param {string} formId - The unique form 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 forms through the Edge Platform.
+ */
+const getEdgeProxyFormsUrl = (sitecoreEdgeContextId, formId, sitecoreEdgeUrl = constants_1.SITECORE_EDGE_URL_DEFAULT) => `${sitecoreEdgeUrl}/v1/forms/publisher/${formId}?sitecoreContextId=${sitecoreEdgeContextId}`;
+exports.getEdgeProxyFormsUrl = getEdgeProxyFormsUrl;

package/dist/cjs/graphql/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEdgeProxyFormsUrl = exports.getEdgeProxyContentUrl = exports.SearchQueryService = exports.GraphQLRequestClient = exports.DefaultRetryStrategy = exports.getAppRootId = void 0;
+var app_root_query_1 = require("./app-root-query");
+Object.defineProperty(exports, "getAppRootId", { enumerable: true, get: function () { return app_root_query_1.getAppRootId; } });
+var graphql_request_client_1 = require("../graphql-request-client");
+Object.defineProperty(exports, "DefaultRetryStrategy", { enumerable: true, get: function () { return graphql_request_client_1.DefaultRetryStrategy; } });
+Object.defineProperty(exports, "GraphQLRequestClient", { enumerable: true, get: function () { return graphql_request_client_1.GraphQLRequestClient; } });
+var search_service_1 = require("./search-service");
+Object.defineProperty(exports, "SearchQueryService", { enumerable: true, get: function () { return search_service_1.SearchQueryService; } });
+var graphql_edge_proxy_1 = require("./graphql-edge-proxy");
+Object.defineProperty(exports, "getEdgeProxyContentUrl", { enumerable: true, get: function () { return graphql_edge_proxy_1.getEdgeProxyContentUrl; } });
+Object.defineProperty(exports, "getEdgeProxyFormsUrl", { enumerable: true, get: function () { return graphql_edge_proxy_1.getEdgeProxyFormsUrl; } });

package/dist/cjs/graphql/search-service.js

@@ -0,0 +1,61 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchQueryService = void 0;
+/**
+ * @deprecated use GraphQLClient instead
+ * Provides functionality for performing GraphQL 'search' operations, including handling pagination.
+ * This class is meant to be extended or used as a mixin; it's not meant to be used directly.
+ * @template T The type of objects being requested.
+ * @mixin
+ */
+class SearchQueryService {
+    /**
+     * Creates an instance of search query service.
+     * @param {GraphQLClient} client that fetches data from a GraphQL endpoint.
+     */
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 1. Validates mandatory search query arguments
+     * 2. Executes search query with pagination
+     * 3. Aggregates pagination results into a single result-set.
+     * @template T The type of objects being requested.
+     * @param {string | DocumentNode} query the search query.
+     * @param {SearchQueryVariables} args search query arguments.
+     * @returns {T[]} array of result objects.
+     * @throws {RangeError} if a valid root item ID is not provided.
+     * @throws {RangeError} if the provided language(s) is(are) not valid.
+     */
+    fetch(query, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (!args.rootItemId) {
+                throw new RangeError('"rootItemId" and "language" must be non-empty strings');
+            }
+            if (!args.language) {
+                throw new RangeError('"rootItemId" and "language" must be non-empty strings');
+            }
+            let results = [];
+            let hasNext = true;
+            let after = '';
+            while (hasNext) {
+                const fetchResponse = yield this.client.request(query, Object.assign(Object.assign({}, args), { after }));
+                results = results.concat((_a = fetchResponse === null || fetchResponse === void 0 ? void 0 : fetchResponse.search) === null || _a === void 0 ? void 0 : _a.results);
+                hasNext = fetchResponse.search.pageInfo.hasNext;
+                after = fetchResponse.search.pageInfo.endCursor;
+            }
+            return results;
+        });
+    }
+}
+exports.SearchQueryService = SearchQueryService;

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

@@ -0,0 +1,152 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphQLRequestClient = exports.DefaultRetryStrategy = void 0;
+const graphql_request_1 = require("graphql-request");
+const url_parse_1 = __importDefault(require("url-parse"));
+const debug_1 = __importDefault(require("./debug"));
+const timeout_promise_1 = __importDefault(require("./utils/timeout-promise"));
+/**
+ * Represents a default retry strategy for handling retry attempts in case of specific HTTP status codes.
+ * This class implements the RetryStrategy interface and provides methods to determine whether a request
+ * should be retried and calculates the delay before the next retry attempt.
+ */
+class DefaultRetryStrategy {
+    /**
+     * @param {object} options Configurable options for retry mechanism.
+     * @param {number[]} [options.statusCodes] HTTP status codes to trigger retries on. Default is [429].
+     * @param {string[]} [options.errorCodes] Node error codes to trigger retries. Default is ['ECONNRESET', 'ETIMEDOUT', 'EPROTO'].
+     * @param {number} [options.factor] Factor by which the delay increases with each retry attempt. Default is 2.
+     */
+    constructor(options = {}) {
+        this.statusCodes = options.statusCodes || [429];
+        this.errorCodes = options.errorCodes || ['ECONNRESET', 'ETIMEDOUT', 'EPROTO'];
+        this.factor = options.factor || 2;
+    }
+    shouldRetry(error, attempt, retries) {
+        var _a;
+        const isStatusCodeError = ((_a = error.response) === null || _a === void 0 ? void 0 : _a.status) !== undefined && this.statusCodes.includes(error.response.status);
+        const isNodeErrorCode = error.code !== undefined && this.errorCodes.includes(error.code);
+        return retries > 0 && attempt <= retries && (isStatusCodeError || isNodeErrorCode);
+    }
+    getDelay(error, attempt) {
+        var _a;
+        const rawHeaders = (_a = error.response) === null || _a === void 0 ? void 0 : _a.headers;
+        const retryAfterHeader = rawHeaders === null || rawHeaders === void 0 ? void 0 : rawHeaders.get('Retry-After');
+        if (retryAfterHeader !== null &&
+            retryAfterHeader !== undefined &&
+            retryAfterHeader.trim() !== '') {
+            const delaySeconds = Number.parseFloat(retryAfterHeader);
+            return delaySeconds * 1000;
+        }
+        else {
+            return Math.pow(this.factor, attempt - 1) * 1000;
+        }
+    }
+}
+exports.DefaultRetryStrategy = DefaultRetryStrategy;
+/**
+ * A GraphQL client for Sitecore APIs that uses the 'graphql-request' library.
+ * https://github.com/prisma-labs/graphql-request
+ */
+class GraphQLRequestClient {
+    /**
+     * Provides ability to execute graphql query using given `endpoint`
+     * @param {string} endpoint The Graphql endpoint
+     * @param {GraphQLRequestClientConfig} [clientConfig] GraphQL request client configuration.
+     */
+    constructor(endpoint, clientConfig = {}) {
+        var _a;
+        this.endpoint = endpoint;
+        this.headers = {};
+        if (clientConfig.apiKey) {
+            this.headers.sc_apikey = clientConfig.apiKey;
+        }
+        if (clientConfig.headers) {
+            this.headers = Object.assign(Object.assign({}, this.headers), clientConfig.headers);
+        }
+        if (!endpoint || !(0, url_parse_1.default)(endpoint).hostname) {
+            throw new Error(`Invalid GraphQL endpoint '${endpoint}'. Verify that 'layoutServiceHost' property in 'scjssconfig.json' file or appropriate environment variable is set`);
+        }
+        this.timeout = clientConfig.timeout;
+        this.retries = (_a = clientConfig.retries) !== null && _a !== void 0 ? _a : 3;
+        this.retryStrategy =
+            clientConfig.retryStrategy ||
+                new DefaultRetryStrategy({ statusCodes: [429, 502, 503, 504, 520, 521, 522, 523, 524] });
+        this.client = new graphql_request_1.GraphQLClient(endpoint, {
+            headers: this.headers,
+            fetch: clientConfig.fetch,
+        });
+        this.debug = clientConfig.debugger || debug_1.default.http;
+    }
+    /**
+     * Factory method for creating a GraphQLRequestClientFactory.
+     * @param {object} config - client configuration options.
+     * @param {string} config.endpoint - endpoint
+     * @param {string} [config.apiKey] - apikey
+     */
+    static createClientFactory({ endpoint, apiKey, }) {
+        return (config = {}) => new GraphQLRequestClient(endpoint, Object.assign(Object.assign({}, config), { apiKey }));
+    }
+    /**
+     * Execute graphql request
+     * @param {string | DocumentNode} query graphql query
+     * @param {object} [variables] graphql variables
+     * @param {RequestOptions} [options] Options for configuring a GraphQL request.
+     */
+    request(query, variables, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let attempt = 1;
+            const retryer = () => __awaiter(this, void 0, void 0, function* () {
+                // Note we don't have access to raw request/response with graphql-request
+                // but we should log whatever we have.
+                this.debug('request: %o', {
+                    url: this.endpoint,
+                    headers: Object.assign(Object.assign({}, this.headers), options === null || options === void 0 ? void 0 : options.headers),
+                    query,
+                    variables,
+                });
+                const startTimestamp = Date.now();
+                const fetchWithOptionalTimeout = [this.client.request(query, variables, options === null || options === void 0 ? void 0 : options.headers)];
+                if (this.timeout) {
+                    this.abortTimeout = new timeout_promise_1.default(this.timeout);
+                    fetchWithOptionalTimeout.push(this.abortTimeout.start);
+                }
+                return Promise.race(fetchWithOptionalTimeout).then((data) => {
+                    var _a;
+                    (_a = this.abortTimeout) === null || _a === void 0 ? void 0 : _a.clear();
+                    this.debug('response in %dms: %o', Date.now() - startTimestamp, data);
+                    return Promise.resolve(data);
+                }, (error) => __awaiter(this, void 0, void 0, function* () {
+                    var _a, _b;
+                    (_a = this.abortTimeout) === null || _a === void 0 ? void 0 : _a.clear();
+                    this.debug('response error: %o', error.response || error.message || error);
+                    const status = ((_b = error.response) === null || _b === void 0 ? void 0 : _b.status) || error.code;
+                    const shouldRetry = this.retryStrategy.shouldRetry(error, attempt, this.retries);
+                    if (shouldRetry) {
+                        const delayMs = this.retryStrategy.getDelay(error, attempt);
+                        this.debug('Error: %s. Retrying in %dms (attempt %d).', status, delayMs, attempt);
+                        attempt++;
+                        return new Promise((resolve) => setTimeout(resolve, delayMs)).then(retryer);
+                    }
+                    else {
+                        return Promise.reject(error);
+                    }
+                }));
+            });
+            return retryer();
+        });
+    }
+}
+exports.GraphQLRequestClient = GraphQLRequestClient;

package/dist/cjs/i18n/dictionary-service.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DictionaryServiceBase = void 0;
+const cache_client_1 = require("../cache-client");
+/**
+ * Base implementation of @see DictionaryService that handles caching dictionary values
+ */
+class DictionaryServiceBase {
+    /**
+     * Initializes a new instance of @see DictionaryService using the provided @see CacheOptions
+     * @param {CacheOptions} options Configuration options
+     */
+    constructor(options) {
+        this.options = options;
+        this.cache = this.getCacheClient();
+    }
+    /**
+     * Caches a @see DictionaryPhrases value for the specified cache key.
+     * @param {string} key The cache key.
+     * @param {DictionaryPhrases} value The value to cache.
+     * @returns The value added to the cache.
+     * @mixes CacheClient<DictionaryPhrases>
+     */
+    setCacheValue(key, value) {
+        return this.cache.setCacheValue(key, value);
+    }
+    /**
+     * Retrieves a @see DictionaryPhrases value from the cache.
+     * @param {string} key The cache key.
+     * @returns The @see DictionaryPhrases value, or null if the specified key is not found in the cache.
+     */
+    getCacheValue(key) {
+        return this.cache.getCacheValue(key);
+    }
+    /**
+     * Gets a cache client that can cache data. Uses memory-cache as the default
+     * library for caching (@see MemoryCacheClient). Override this method if you
+     * want to use something else.
+     * @returns {CacheClient} implementation
+     */
+    getCacheClient() {
+        return new cache_client_1.MemoryCacheClient(this.options);
+    }
+}
+exports.DictionaryServiceBase = DictionaryServiceBase;