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

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

@@ -0,0 +1,62 @@
+import { SITECORE_EDGE_URL_DEFAULT } from '../constants';
+/**
+ * Regular expression to check if the content styles are used in the field value
+ */
+const CLASS_REGEXP = /class=".*(\bck-content\b).*"/g;
+/**
+ * Get the content styles link to be loaded from the Sitecore Edge Platform
+ * @param {LayoutServiceData} layoutData Layout service data
+ * @param {string} sitecoreEdgeContextId Sitecore Edge Context ID
+ * @param {string} [sitecoreEdgeUrl] Sitecore Edge Platform URL. Default is https://edge-platform.sitecorecloud.io
+ * @returns {HTMLLink | null} content styles link, null if no styles are used in layout
+ */
+export const getContentStylesheetLink = (layoutData, sitecoreEdgeContextId, sitecoreEdgeUrl = SITECORE_EDGE_URL_DEFAULT) => {
+    if (!layoutData.sitecore.route)
+        return null;
+    const config = { loadStyles: false };
+    traverseComponent(layoutData.sitecore.route, config);
+    if (!config.loadStyles)
+        return null;
+    return {
+        href: getContentStylesheetUrl(sitecoreEdgeContextId, sitecoreEdgeUrl),
+        rel: 'stylesheet',
+    };
+};
+export const getContentStylesheetUrl = (sitecoreEdgeContextId, sitecoreEdgeUrl = SITECORE_EDGE_URL_DEFAULT) => `${sitecoreEdgeUrl}/v1/files/pages/styles/content-styles.css?sitecoreContextId=${sitecoreEdgeContextId}`;
+export const traversePlaceholder = (components, config) => {
+    if (config.loadStyles)
+        return;
+    components.forEach((component) => {
+        traverseComponent(component, config);
+    });
+};
+export const traverseField = (field, config) => {
+    if (!field || config.loadStyles)
+        return;
+    if ('value' in field && typeof field.value === 'string') {
+        config.loadStyles = CLASS_REGEXP.test(field.value);
+    }
+    else if ('fields' in field) {
+        Object.values(field.fields).forEach((field) => {
+            traverseField(field, config);
+        });
+    }
+    else if (Array.isArray(field)) {
+        field.forEach((field) => {
+            traverseField(field, config);
+        });
+    }
+};
+export const traverseComponent = (component, config) => {
+    if (config.loadStyles)
+        return;
+    if ('fields' in component && component.fields) {
+        Object.values(component.fields).forEach((field) => {
+            traverseField(field, config);
+        });
+    }
+    const placeholders = component.placeholders || {};
+    Object.keys(placeholders).forEach((placeholder) => {
+        traversePlaceholder(placeholders[placeholder], config);
+    });
+};

package/dist/esm/layout/graphql-layout-service.js

@@ -0,0 +1,79 @@
+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());
+    });
+};
+import { LayoutServiceBase } from './layout-service';
+import debug from '../debug';
+export const GRAPHQL_LAYOUT_QUERY_NAME = 'JssLayoutQuery';
+/**
+ * Service that fetch layout data using Sitecore's GraphQL API.
+ * @augments LayoutServiceBase
+ * @mixes GraphQLRequestClient
+ */
+export class GraphQLLayoutService extends LayoutServiceBase {
+    /**
+     * Fetch layout data using the Sitecore GraphQL endpoint.
+     * @param {GraphQLLayoutServiceConfig} serviceConfig configuration
+     */
+    constructor(serviceConfig) {
+        super();
+        this.serviceConfig = serviceConfig;
+        this.graphQLClient = this.getGraphQLClient();
+    }
+    /**
+     * Fetch layout data for an item.
+     * @param {string} itemPath item path to fetch layout data for.
+     * @param {string} [language] the language to fetch layout data for.
+     * @returns {Promise<LayoutServiceData>} layout service data
+     */
+    fetchLayoutData(itemPath, language) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const query = this.getLayoutQuery(itemPath, language);
+            debug.layout('fetching layout data for %s %s %s', itemPath, language, this.serviceConfig.siteName);
+            const data = yield this.graphQLClient.request(query);
+            // If `rendered` is empty -> not found
+            return (((_b = (_a = data === null || data === void 0 ? void 0 : data.layout) === null || _a === void 0 ? void 0 : _a.item) === null || _b === void 0 ? void 0 : _b.rendered) || {
+                sitecore: { context: { pageEditing: false, language }, route: null },
+            });
+        });
+    }
+    /**
+     * Gets a GraphQL client that can make requests to the API.
+     * @returns {GraphQLClient} implementation
+     */
+    getGraphQLClient() {
+        if (!this.serviceConfig.clientFactory) {
+            throw new Error('clientFactory needs to be provided when initializing GraphQL client.');
+        }
+        return this.serviceConfig.clientFactory({
+            debugger: debug.layout,
+            retries: this.serviceConfig.retries,
+            retryStrategy: this.serviceConfig.retryStrategy,
+        });
+    }
+    /**
+     * Returns GraphQL Layout query
+     * @param {string} itemPath page route
+     * @param {string} [language] language
+     * @returns {string} GraphQL query
+     */
+    getLayoutQuery(itemPath, language) {
+        const languageVariable = language ? `, language:"${language}"` : '';
+        const layoutQuery = this.serviceConfig.formatLayoutQuery
+            ? this.serviceConfig.formatLayoutQuery(this.serviceConfig.siteName, itemPath, language)
+            : `layout(site:"${this.serviceConfig.siteName}", routePath:"${itemPath}"${languageVariable})`;
+        return `query ${GRAPHQL_LAYOUT_QUERY_NAME} {
+      ${layoutQuery}{
+        item {
+          rendered
+        }
+      }
+    }`;
+    }
+}

package/dist/esm/layout/index.js

@@ -0,0 +1,6 @@
+// layout
+export { LayoutServicePageState, EditMode, RenderingType, EDITING_COMPONENT_PLACEHOLDER, EDITING_COMPONENT_ID, } from './models';
+export { getFieldValue, getChildPlaceholder, isFieldValueEmpty, isDynamicPlaceholder, getDynamicPlaceholderPattern, EMPTY_DATE_FIELD_VALUE, } from './utils';
+export { getContentStylesheetLink } from './content-styles';
+export { GraphQLLayoutService, GRAPHQL_LAYOUT_QUERY_NAME, } from './graphql-layout-service';
+export { getComponentLibraryStylesheetLinks } from './themes';

package/dist/esm/layout/layout-service.js

@@ -0,0 +1,5 @@
+/**
+ * Base abstraction to implement custom layout service
+ */
+export class LayoutServiceBase {
+}

package/dist/esm/layout/models.js

@@ -0,0 +1,32 @@
+/**
+ * Layout Service page state enum
+ * library mode would render a single component
+ */
+export var LayoutServicePageState;
+(function (LayoutServicePageState) {
+    LayoutServicePageState["Preview"] = "preview";
+    LayoutServicePageState["Edit"] = "edit";
+    LayoutServicePageState["Normal"] = "normal";
+})(LayoutServicePageState || (LayoutServicePageState = {}));
+/**
+ * Represents the edit mode for rendering content in Sitecore Editors
+ */
+export var EditMode;
+(function (EditMode) {
+    EditMode["Metadata"] = "metadata";
+})(EditMode || (EditMode = {}));
+/**
+ * Editing rendering type
+ */
+export var RenderingType;
+(function (RenderingType) {
+    RenderingType["Component"] = "component";
+})(RenderingType || (RenderingType = {}));
+/**
+ * Static placeholder name used for component rendering
+ */
+export const EDITING_COMPONENT_PLACEHOLDER = 'editing-componentmode-placeholder';
+/**
+ * Id of wrapper for component rendering
+ */
+export const EDITING_COMPONENT_ID = 'editing-component';

package/dist/esm/layout/themes.js

@@ -0,0 +1,69 @@
+import { getFieldValue } from '.';
+import { SITECORE_EDGE_URL_DEFAULT } from '../constants';
+/**
+ * Pattern for library ids
+ * @example -library--foo
+ */
+const STYLES_LIBRARY_ID_REGEX = /-library--([^\s]+)/;
+/**
+ * Walks through rendering tree and returns list of links of all FEAAS, BYOC or SXA Component Library Stylesheets that are used
+ * @param {LayoutServiceData} layoutData Layout service data
+ * @param {string} sitecoreEdgeContextId Sitecore Edge Context ID
+ * @param {string} [sitecoreEdgeUrl] Sitecore Edge Platform URL. Default is https://edge-platform.sitecorecloud.io
+ * @returns {HTMLLink[]} library stylesheet links
+ */
+export function getComponentLibraryStylesheetLinks(layoutData, sitecoreEdgeContextId, sitecoreEdgeUrl = SITECORE_EDGE_URL_DEFAULT) {
+    const ids = new Set();
+    if (!layoutData.sitecore.route)
+        return [];
+    traverseComponent(layoutData.sitecore.route, ids);
+    return [...ids].map((id) => ({
+        href: getStylesheetUrl(id, sitecoreEdgeContextId, sitecoreEdgeUrl),
+        rel: 'stylesheet',
+    }));
+}
+export const getStylesheetUrl = (id, sitecoreEdgeContextId, sitecoreEdgeUrl = SITECORE_EDGE_URL_DEFAULT) => {
+    return `${sitecoreEdgeUrl}/v1/files/components/styles/${id}.css?sitecoreContextId=${sitecoreEdgeContextId}`;
+};
+/**
+ * Traverse placeholder and components to add library ids
+ * @param {ComponentRendering[]} components
+ * @param {Set<string>} ids library ids
+ */
+const traversePlaceholder = (components, ids) => {
+    components.map((component) => {
+        return traverseComponent(component, ids);
+    });
+};
+/**
+ * Traverse component and children to add library ids
+ * @param {RouteData | ComponentRendering | HtmlElementRendering} component component data
+ * @param {Set<string>} ids library ids
+ */
+const traverseComponent = (component, ids) => {
+    var _a, _b, _c, _d, _e, _f;
+    let libraryId = undefined;
+    if ('params' in component && component.params) {
+        // LibraryID in css class name takes precedence over LibraryId attribute
+        libraryId =
+            ((_b = (_a = component.params.CSSStyles) === null || _a === void 0 ? void 0 : _a.match(STYLES_LIBRARY_ID_REGEX)) === null || _b === void 0 ? void 0 : _b[1]) ||
+                ((_d = (_c = component.params.Styles) === null || _c === void 0 ? void 0 : _c.match(STYLES_LIBRARY_ID_REGEX)) === null || _d === void 0 ? void 0 : _d[1]) ||
+                component.params.LibraryId ||
+                undefined;
+    }
+    // if params are empty we try to fall back to data source
+    if (!libraryId && 'fields' in component && component.fields) {
+        libraryId =
+            ((_e = getFieldValue(component.fields, 'CSSStyles', '').match(STYLES_LIBRARY_ID_REGEX)) === null || _e === void 0 ? void 0 : _e[1]) ||
+                ((_f = getFieldValue(component.fields, 'Styles', '').match(STYLES_LIBRARY_ID_REGEX)) === null || _f === void 0 ? void 0 : _f[1]) ||
+                getFieldValue(component.fields, 'LibraryId', '') ||
+                undefined;
+    }
+    if (libraryId) {
+        ids.add(libraryId);
+    }
+    const placeholders = component.placeholders || {};
+    Object.keys(placeholders).forEach((placeholder) => {
+        traversePlaceholder(placeholders[placeholder], ids);
+    });
+};

package/dist/esm/layout/utils.js

@@ -0,0 +1,102 @@
+/**
+ * @param {ComponentRendering | Fields} renderingOrFields the rendering or fields object to extract the field from
+ * @param {string} fieldName the name of the field to extract
+ * @param {T} [defaultValue] the default value to return if the field is not defined
+ * @returns {Field | T} the field value or the default value if the field is not defined
+ */
+// eslint-disable-next-line no-redeclare
+export function getFieldValue(renderingOrFields, fieldName, defaultValue) {
+    if (!renderingOrFields || !fieldName) {
+        return defaultValue;
+    }
+    const fields = renderingOrFields;
+    const field = fields[fieldName];
+    if (field && typeof field.value !== 'undefined') {
+        return field.value;
+    }
+    const rendering = renderingOrFields;
+    if (!rendering.fields ||
+        !rendering.fields[fieldName] ||
+        typeof rendering.fields[fieldName].value === 'undefined') {
+        return defaultValue;
+    }
+    return rendering.fields[fieldName].value;
+}
+/**
+ * Gets rendering definitions in a given child placeholder under a current rendering.
+ * @param {ComponentRendering} rendering
+ * @param {string} placeholderName
+ * @returns {ComponentRendering[]} child placeholder
+ */
+export function getChildPlaceholder(rendering, placeholderName) {
+    if (!rendering ||
+        !placeholderName ||
+        !rendering.placeholders ||
+        !rendering.placeholders[placeholderName]) {
+        return [];
+    }
+    return rendering.placeholders[placeholderName];
+}
+/**
+ * Returns a regular expression pattern for a dynamic placeholder name.
+ * @param {string} placeholder Placeholder name with a dynamic segment (e.g. 'main-{*}')
+ * @returns Regular expression pattern for the dynamic segment
+ */
+export const getDynamicPlaceholderPattern = (placeholder) => {
+    return new RegExp(`^${placeholder.replace(/\{\*\}+/i, '\\d+')}$`);
+};
+/**
+ * Checks if the placeholder name is dynamic.
+ * @param {string} placeholder Placeholder name
+ * @returns True if the placeholder name is dynamic
+ */
+export const isDynamicPlaceholder = (placeholder) => placeholder.indexOf('{*}') !== -1;
+/**
+ * The default value for an empty Date field.
+ * This value is defined as a default one by .NET
+ */
+export const EMPTY_DATE_FIELD_VALUE = '0001-01-01T00:00:00Z';
+/**
+ * Determines if the passed in field object's value is empty.
+ * @param {GenericFieldValue | Partial<Field>} field the field object.
+ * Partial<T> type is used here because _field.value_ could be required or optional for the different field types
+ */
+export function isFieldValueEmpty(field) {
+    const isImageFieldEmpty = (fieldValue) => !fieldValue.src;
+    const isFileFieldEmpty = (fieldValue) => !fieldValue.src;
+    const isLinkFieldEmpty = (fieldValue) => !fieldValue.href;
+    const isDateFieldEmpty = (fieldValue) => {
+        if (typeof fieldValue === 'string') {
+            return fieldValue === EMPTY_DATE_FIELD_VALUE;
+        }
+        else {
+            return !(typeof (fieldValue === null || fieldValue === void 0 ? void 0 : fieldValue.getMonth) === 'function' &&
+                !isNaN(fieldValue === null || fieldValue === void 0 ? void 0 : fieldValue.getMonth()));
+        }
+    };
+    const isEmpty = (fieldValue) => {
+        if (fieldValue === null || fieldValue === undefined) {
+            return true;
+        }
+        if (typeof fieldValue === 'object') {
+            return (isImageFieldEmpty(fieldValue) &&
+                isFileFieldEmpty(fieldValue) &&
+                isLinkFieldEmpty(fieldValue) &&
+                isDateFieldEmpty(fieldValue));
+        }
+        else if (typeof fieldValue === 'number' || typeof fieldValue === 'boolean') {
+            // Avoid returning true for 0 and false values
+            return false;
+        }
+        else {
+            return !fieldValue || isDateFieldEmpty(fieldValue);
+        }
+    };
+    if (!field)
+        return true;
+    const dynamicField = field;
+    if (dynamicField.value !== undefined) {
+        return isEmpty(dynamicField.value);
+    }
+    return isEmpty(field);
+}

package/dist/esm/media/index.js

@@ -0,0 +1,2 @@
+import * as mediaApi from './media-api';
+export { mediaApi };

package/dist/esm/media/media-api.js

@@ -0,0 +1,86 @@
+import URL from 'url-parse';
+// finds the Sitecore media URL prefix
+const mediaUrlPrefixRegex = /\/([-~]{1})\/media\//i;
+/**
+ * Get required query string params which should be merged with user params
+ * @param {object} qs layout service parsed query string
+ * @returns {object} requiredParams
+ */
+export const getRequiredParams = (qs) => {
+    const { rev, db, la, vs, ts } = qs;
+    return { rev, db, la, vs, ts };
+};
+/**
+ * Replace `/~/media` or `/-/media` with `/~/jssmedia` or `/-/jssmedia`, respectively.
+ * Can use `mediaUrlPrefix` in order to use a custom prefix.
+ * @param {string} url The URL to replace the media URL prefix in
+ * @param {RegExp} [mediaUrlPrefix] The regex to match the media URL prefix
+ * @returns {string} The URL with the media URL prefix replaced
+ */
+export const replaceMediaUrlPrefix = (url, mediaUrlPrefix = mediaUrlPrefixRegex) => {
+    const parsed = URL(url, {}, true);
+    const match = mediaUrlPrefix.exec(parsed.pathname);
+    if (match && match.length > 1) {
+        // regex will provide us with /-/ or /~/ type
+        parsed.set('pathname', parsed.pathname.replace(mediaUrlPrefix, `/${match[1]}/jssmedia/`));
+    }
+    return parsed.toString();
+};
+/**
+ * Prepares a Sitecore media URL with `params` for use by the JSS media handler.
+ * This is done by replacing `/~/media` or `/-/media` with `/~/jssmedia` or `/-/jssmedia`, respectively.
+ * Provided `params` are used as the querystring parameters for the media URL.
+ * Can use `mediaUrlPrefix` in order to use a custom prefix.
+ * If no `params` are sent, the original media URL is returned.
+ * @param {string} url The URL to prepare
+ * @param {object} [params] The querystring parameters to use
+ * @param {RegExp} [mediaUrlPrefix] The regex to match the media URL prefix
+ * @returns {string} The prepared URL
+ */
+export const updateImageUrl = (url, params, mediaUrlPrefix = mediaUrlPrefixRegex) => {
+    if (!params || Object.keys(params).length === 0) {
+        // if params aren't supplied, no need to run it through JSS media handler
+        return url;
+    }
+    // polyfill node `global` in browser to workaround https://github.com/unshiftio/url-parse/issues/150
+    if (typeof window !== 'undefined' && !window.global) {
+        window.global = {};
+    }
+    const parsed = URL(replaceMediaUrlPrefix(url, mediaUrlPrefix), {}, true);
+    const requiredParams = getRequiredParams(parsed.query);
+    const query = Object.assign({}, params);
+    Object.entries(requiredParams).forEach(([key, param]) => {
+        if (param) {
+            query[key] = param;
+        }
+    });
+    parsed.set('query', query);
+    return parsed.toString();
+};
+/**
+ * Receives an array of `srcSet` parameters that are iterated and used as parameters to generate
+ * a corresponding set of updated Sitecore media URLs via @see updateImageUrl. The result is a comma-delimited
+ * list of media URLs with respective dimension parameters.
+ * @example
+ * // returns '/ipsum.jpg?h=1000&w=1000 1000w, /ipsum.jpg?mh=250&mw=250 250w'
+ * getSrcSet('/ipsum.jpg', [{ h: 1000, w: 1000 }, { mh: 250, mw: 250 } ])
+ * More information about `srcSet`: {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img}
+ * @param {string} url The URL to prepare
+ * @param {Array} srcSet The array of parameters to use
+ * @param {object} [imageParams] The querystring parameters to use
+ * @param {RegExp} [mediaUrlPrefix] The regex to match the media URL prefix
+ * @returns {string} The prepared URL
+ */
+export const getSrcSet = (url, srcSet, imageParams, mediaUrlPrefix) => {
+    return srcSet
+        .map((params) => {
+        const newParams = Object.assign(Object.assign({}, imageParams), params);
+        const imageWidth = newParams.w || newParams.mw;
+        if (!imageWidth) {
+            return null;
+        }
+        return `${updateImageUrl(url, newParams, mediaUrlPrefix)} ${imageWidth}w`;
+    })
+        .filter((value) => value)
+        .join(', ');
+};

package/dist/esm/models.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/native-fetcher.js

@@ -0,0 +1,193 @@
+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 __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import debuggers from './debug';
+import TimeoutPromise from './utils/timeout-promise';
+export class NativeDataFetcher {
+    constructor(config = {}) {
+        this.config = config;
+    }
+    /**
+     * Implements a data fetcher.
+     * @param {string} url The URL to request (may include query string)
+     * @param {RequestInit} [options] Optional fetch options
+     * @returns {Promise<NativeDataFetcherResponse<T>>} response
+     */
+    fetch(url_1) {
+        return __awaiter(this, arguments, void 0, function* (url, options = {}) {
+            var _a;
+            const _b = this.config, { debugger: debugOverride, fetch: fetchOverride } = _b, init = __rest(_b, ["debugger", "fetch"]);
+            const startTimestamp = Date.now();
+            const fetchImpl = fetchOverride || fetch;
+            const debug = debugOverride || debuggers.http;
+            const requestInit = this.getRequestInit(Object.assign(Object.assign({}, init), options));
+            const fetchWithOptionalTimeout = [fetchImpl(url, requestInit)];
+            if (init.timeout) {
+                this.abortTimeout = new TimeoutPromise(init.timeout);
+                fetchWithOptionalTimeout.push(this.abortTimeout.start);
+            }
+            debug('Request initiated: %o', Object.assign({ url, headers: this.extractDebugHeaders(requestInit.headers) }, requestInit));
+            try {
+                const response = yield Promise.race(fetchWithOptionalTimeout).then((res) => {
+                    var _a;
+                    (_a = this.abortTimeout) === null || _a === void 0 ? void 0 : _a.clear();
+                    return res;
+                });
+                const respData = yield this.parseResponse(response, debug);
+                if (!response.ok) {
+                    const error = this.createError(response, respData);
+                    debug('Response error: %o', error.response);
+                    throw error;
+                }
+                debug('Response in %dms: %o', Date.now() - startTimestamp, {
+                    status: response.status,
+                    statusText: response.statusText,
+                    headers: this.extractDebugHeaders(response.headers),
+                    url: response.url,
+                    data: respData,
+                });
+                return Object.assign(Object.assign({}, response), { data: respData });
+            }
+            catch (error) {
+                (_a = this.abortTimeout) === null || _a === void 0 ? void 0 : _a.clear();
+                debug('Request failed: %o', error);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Perform a GET request
+     * @param {string} url The URL to request (may include query string)
+     * @param {RequestInit} [options] Fetch options
+     * @returns {Promise<NativeDataFetcherResponse<T>>} response
+     */
+    get(url_1) {
+        return __awaiter(this, arguments, void 0, function* (url, options = {}) {
+            return this.fetch(url, Object.assign({ method: 'GET' }, options));
+        });
+    }
+    /**
+     * Perform a POST request
+     * @param {string} url The URL to request (may include query string)
+     * @param {unknown} body The data to send with the request
+     * @param {RequestInit} [options] Fetch options
+     * @returns {Promise<NativeDataFetcherResponse<T>>} response
+     */
+    post(url_1, body_1) {
+        return __awaiter(this, arguments, void 0, function* (url, body, options = {}) {
+            return this.fetch(url, Object.assign({ method: 'POST', body: JSON.stringify(body) }, options));
+        });
+    }
+    /**
+     * Perform a DELETE request
+     * @param {string} url The URL to request (may include query string)
+     * @param {RequestInit} [options] Fetch options
+     * @returns {Promise<NativeDataFetcherResponse<T>>} response
+     */
+    delete(url_1) {
+        return __awaiter(this, arguments, void 0, function* (url, options = {}) {
+            return this.fetch(url, Object.assign({ method: 'DELETE' }, options));
+        });
+    }
+    /**
+     * Perform a PUT request
+     * @param {string} url The URL to request (may include query string)
+     * @param {unknown} body The data to send with the request
+     * @param {RequestInit} [options] Fetch options
+     * @returns {Promise<NativeDataFetcherResponse<T>>} response
+     */
+    put(url_1, body_1) {
+        return __awaiter(this, arguments, void 0, function* (url, body, options = {}) {
+            return this.fetch(url, Object.assign({ method: 'PUT', body: JSON.stringify(body) }, options));
+        });
+    }
+    /**
+     * Perform a HEAD request
+     * @param {string} url The URL to request (may include query string)
+     * @param {RequestInit} [options] Fetch options
+     * @returns {Promise<NativeDataFetcherResponse<T>>} response
+     */
+    head(url, options = {}) {
+        return this.fetch(url, Object.assign({ method: 'HEAD' }, options));
+    }
+    /**
+     * Determines settings for the request
+     * @param {RequestInit} init Custom settings for request
+     * @returns {RequestInit} The final request settings
+     */
+    getRequestInit(init = {}) {
+        const headers = new Headers(init.headers);
+        if (!init.method) {
+            init.method = init.body ? 'POST' : 'GET';
+        }
+        headers.set('Content-Type', 'application/json');
+        init.headers = headers;
+        return init;
+    }
+    /**
+     * Safely extract all headers for debug logging
+     * @param {HeadersInit} incomingHeaders Incoming headers
+     * @returns Object with headers as key/value pairs
+     */
+    extractDebugHeaders(incomingHeaders = {}) {
+        const headers = {};
+        if (typeof (incomingHeaders === null || incomingHeaders === void 0 ? void 0 : incomingHeaders.forEach) !== 'string' && incomingHeaders.forEach) {
+            incomingHeaders === null || incomingHeaders === void 0 ? void 0 : incomingHeaders.forEach((value, key) => {
+                headers[key] = value;
+            });
+        }
+        return headers;
+    }
+    /**
+     * Parses the response data.
+     * @param {Response} response - The fetch response object.
+     * @param {Function} debug - The debug logger function.
+     * @returns {Promise<unknown>} - The parsed response data.
+     */
+    parseResponse(response, debug) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const contentType = response.headers.get('Content-Type') || '';
+            try {
+                if (contentType.includes('application/json')) {
+                    return yield response.json();
+                }
+                return yield response.text();
+            }
+            catch (error) {
+                debug('Response parsing error: %o', error);
+                return undefined;
+            }
+        });
+    }
+    /**
+     * Creates a custom error for fetch failures.
+     * @param {Response} response - The fetch response object.
+     * @param {unknown} data - The parsed response data.
+     * @returns {NativeDataFetcherError} - The constructed error object.
+     */
+    createError(response, data) {
+        return Object.assign(Object.assign({}, new Error(`HTTP ${response.status} ${response.statusText}`)), { response: {
+                status: response.status,
+                statusText: response.statusText,
+                headers: this.extractDebugHeaders(response.headers),
+                data,
+            } });
+    }
+}