@sitecore-content-sdk/nextjs 1.3.0-canary.9 → 1.4.0-canary.2

package/dist/esm/editing/utils.js

@@ -1,243 +1,246 @@
-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 { EDITING_ALLOWED_ORIGINS, isDesignLibraryMode, PREVIEW_KEY, QUERY_PARAM_EDITING_SECRET, } from '@sitecore-content-sdk/core/editing';
-import { DEFAULT_VARIANT } from '@sitecore-content-sdk/core/personalize';
-import { SITE_KEY } from '@sitecore-content-sdk/core/site';
-import { EDITING_PASS_THROUGH_HEADERS, QUERY_PARAM_VERCEL_PROTECTION_BYPASS, QUERY_PARAM_VERCEL_SET_BYPASS_COOKIE, } from './constants';
-import { SERVER_PROPS_ID, STATIC_PROPS_ID } from 'next/constants';
-import { getAllowedOriginsFromEnv } from '@sitecore-content-sdk/core/utils';
-/**
- * Gets editing secret value from request
- * @param {NextApiRequest | NextRequest} req incoming request
- * @returns {string | undefined} editing secret value if present
- */
-export const getEditingSecretFromRequest = (req) => {
-    const reqQuery = req.query;
-    const reqUrl = req.url;
-    let secret = undefined;
-    if (reqQuery) {
-        // pages router
-        secret = reqQuery[QUERY_PARAM_EDITING_SECRET];
-    }
-    else if (reqUrl) {
-        // app router
-        const url = new URL(reqUrl);
-        secret = url.searchParams.get(QUERY_PARAM_EDITING_SECRET);
-    }
-    return secret;
-};
-/**
- * Parses query string and its parameters to required editing parameters
- * @param {{ [key: string]: string | undefined }} query query string values
- * @returns {EditingRenderQueryParams} editing parameters
- */
-export const mapEditingParams = (query) => {
-    const params = isDesignLibraryMode(query.mode)
-        ? {
-            itemId: query.sc_itemid,
-            componentUid: query.sc_uid,
-            renderingId: query.sc_renderingId,
-            language: query.sc_lang,
-            site: query.sc_site,
-            mode: query.mode,
-            dataSourceId: query.dataSourceId,
-            version: query.sc_version,
-            generation: query.generation,
-        }
-        : {
-            site: query.sc_site,
-            itemId: query.sc_itemid,
-            language: query.sc_lang,
-            // for sc_variantId we may employ multiple variants (page-layout + component level)
-            // they will be separated by commas (,)
-            variantIds: query.sc_variant || DEFAULT_VARIANT,
-            version: query.sc_version,
-            mode: query.mode,
-            layoutKind: query.sc_layoutKind,
-        };
-    return params;
-};
-/**
- * Filters out Next.js preview cookies from a cookie string or array
- * @param {string | string[] | null} cookies cookie header value
- * @returns {string[] | null} filtered cookies
- */
-export const cleanupNextPreviewCookies = (cookies) => {
-    if (!cookies) {
-        return null;
-    }
-    if (!Array.isArray(cookies)) {
-        cookies = cookies.split(',');
-    }
-    // Filter out Next.js preview cookies
-    const filteredCookies = cookies.filter((cookie) => !new RegExp(`^${"__next_preview_data" /* PreviewCookies.PREVIEW_DATA */}=`).test(cookie) &&
-        !new RegExp(`^${"__prerender_bypass" /* PreviewCookies.PRERENDER_BYPASS */}=`).test(cookie));
-    return filteredCookies;
-};
-/**
- * Gets the Next.js preview cookies to enable preview mode
- * @param {string} site current site name
- * @returns {string[]} list of cookies to set
- */
-export const getPreviewCookies = (site) => {
-    const previewSite = `${SITE_KEY}=${site}; Path=/; HttpOnly; SameSite=None; Secure`;
-    const previewCookie = `${PREVIEW_KEY}=true; Path=/; HttpOnly; SameSite=None; Secure`;
-    return [previewSite, previewCookie];
-};
-/**
- * Returns the list of required query parameters based on the page editing mode
- * @param {DesignLibraryMode | LayoutServicePageState.Preview | LayoutServicePageState.Edit} mode current page mode
- * @returns {string[]} list of required parameters for validation
- */
-export const getRequiredEditingParamsList = (mode) => {
-    const editingRequiredParams = ['sc_site', 'sc_itemid', 'sc_lang', 'route', 'mode'];
-    const componentRequiredParams = [
-        'sc_site',
-        'sc_itemid',
-        'sc_renderingId',
-        'sc_uid',
-        'sc_lang',
-        'mode',
-    ];
-    return isDesignLibraryMode(mode) ? componentRequiredParams : editingRequiredParams;
-};
-/**
- * Gets query parameters that should be passed along to subsequent requests (e.g. for deployment protection bypass)
- * @param {object} query Object of query parameters from incoming URL
- * @returns Object of approved query parameters
- */
-export const getQueryParamsForPropagation = (query) => {
-    const params = {};
-    if (query[QUERY_PARAM_VERCEL_PROTECTION_BYPASS]) {
-        params[QUERY_PARAM_VERCEL_PROTECTION_BYPASS] = query[QUERY_PARAM_VERCEL_PROTECTION_BYPASS];
-    }
-    if (query[QUERY_PARAM_VERCEL_SET_BYPASS_COOKIE]) {
-        params[QUERY_PARAM_VERCEL_SET_BYPASS_COOKIE] = query[QUERY_PARAM_VERCEL_SET_BYPASS_COOKIE];
-    }
-    return params;
-};
-/**
- * Get headers that should be passed along to subsequent requests
- * @param {IncomingHttpHeaders} headers Incoming HTTP Headers
- * @returns Object of approved headers
- */
-export const getHeadersForPropagation = (headers) => {
-    // Filter and normalize headers
-    const filteredHeaders = EDITING_PASS_THROUGH_HEADERS.reduce((acc, header) => {
-        const value = headers.get
-            ? headers.get(header)
-            : headers[header];
-        if (value) {
-            acc[header] = Array.isArray(value) ? value.join(', ') : value;
-        }
-        return acc;
-    }, {});
-    return filteredHeaders;
-};
-/**
- * Performs an internal request to get the HTML for the editing mode
- * @param {string} requestUrl URL to send request to
- * @param {object} propagatedQsParams query string params to use with request
- * @param {object} propagatedHeaders headers to use with request
- * @param {string[]} cookies cookies to use with request
- * @param {NativeDataFetcher} dataFetcher NativeFetcher instance to send request with
- * @returns {string} HTML with editing markup
- */
-export const getEditingRequestHtml = (requestUrl, propagatedQsParams, propagatedHeaders, cookies, dataFetcher) => __awaiter(void 0, void 0, void 0, function* () {
-    // Grab the Next.js preview cookies to send on to the render request
-    propagatedHeaders.cookie = `${propagatedHeaders.cookie ? propagatedHeaders.cookie + ';' : ''}${cookies.join(';')}`;
-    // enable content sdk preview
-    propagatedHeaders.__content_sdk_preview = '1';
-    for (const key in propagatedQsParams) {
-        if ({}.hasOwnProperty.call(propagatedQsParams, key)) {
-            propagatedQsParams[key] && requestUrl.searchParams.append(key, propagatedQsParams[key]);
-        }
-    }
-    requestUrl.searchParams.append('timestamp', Date.now().toString());
-    const pageRes = yield dataFetcher
-        .get(requestUrl.toString(), {
-        credentials: 'include',
-        headers: propagatedHeaders,
-    })
-        .catch((err) => {
-        // We need to handle not found error provided by Vercel
-        // for `fallback: false` pages
-        if (err.response.status === 404) {
-            return err.response;
-        }
-        throw err;
-    });
-    let html = pageRes.data;
-    if (!html || html.length === 0) {
-        throw new Error(`Failed to render html for ${requestUrl.toString()}`);
-    }
-    // replace phkey attribute with key attribute so that newly added renderings
-    // show correct placeholders, so save and refresh won't be needed after adding each rendering
-    html = html.replace(new RegExp('phkey', 'g'), 'key');
-    // When SSG, Next will attempt to perform a router.replace on the client-side to inject the query string parms
-    // to the router state. See https://github.com/vercel/next.js/blob/v10.0.3/packages/next/client/index.tsx#L169.
-    // However, this doesn't really work since at this point we're in the editor and the location.search has nothing
-    // to do with the Next route/page we've rendered. Beyond the extraneous request, this can result in a 404 with
-    // certain route configurations (e.g. multiple catch-all routes).
-    // The following line will trick it into thinking we're SSR, thus avoiding any router.replace.
-    html = html.replace(STATIC_PROPS_ID, SERVER_PROPS_ID);
-    return html;
-});
-/**
- * Type guard for Design Library mode
- * @param {object} data preview data to check
- * @returns true if the data is EditingPreviewData
- * @see EditingPreviewData
- */
-export const isDesignLibraryPreviewData = (data) => {
-    return (typeof data === 'object' &&
-        data !== null &&
-        'mode' in data &&
-        isDesignLibraryMode(data.mode));
-};
-/**
- * Server URL Resolution order (highest to lowest priority):
- * 1. `config.sitecoreInternalEditingHostUrl` (explicitly set in config)
- * 2. Environment variable `SITECORE_INTERNAL_EDITING_HOST_URL`
- * 3. Fallbacks:
- *    - For XM Cloud deployments → `'http://localhost:3000'`
- *    - For all other cases → use the request `Host` header
- * Note we use https protocol on Vercel due to serverless function architecture.
- * In all other scenarios, including localhost (with or without a proxy e.g. ngrok)
- * and within a nodejs container, http protocol should be used.
- *
- * For information about the VERCEL environment variable, see
- * https://vercel.com/docs/environment-variables#system-environment-variables
- * @param {NextApiRequest} req
- */
-export const resolveServerUrl = (req) => {
-    const internalHostUrl = process.env.SITECORE_INTERNAL_EDITING_HOST_URL;
-    if (internalHostUrl) {
-        return internalHostUrl;
-    }
-    // in xmc deployment we always use localhost:3000
-    if (process.env.SITECORE) {
-        return 'http://localhost:3000';
-    }
-    // to preserve auth headers, use https if we're in our 3 main hosting options
-    const useHttps = (process.env.VERCEL || process.env.NETLIFY) !== undefined;
-    const host = req.headers.get
-        ? req.headers.get('host')
-        : req.headers.host;
-    // use https for requests with auth but also support unsecured http rendering hosts
-    return `${useHttps ? 'https' : 'http'}://${host}`;
-};
-/**
- * Gets the Content-Security-Policy header value
- * @returns Content-Security-Policy header value
- */
-export const getCSPHeader = () => {
-    return `frame-ancestors 'self' ${[...getAllowedOriginsFromEnv(), ...EDITING_ALLOWED_ORIGINS].join(' ')}`;
-};
+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 { EDITING_ALLOWED_ORIGINS, isDesignLibraryMode, PREVIEW_KEY, QUERY_PARAM_EDITING_SECRET, } from '@sitecore-content-sdk/core/editing';
+import { DEFAULT_VARIANT } from '@sitecore-content-sdk/core/personalize';
+import { SITE_KEY } from '@sitecore-content-sdk/core/site';
+import { EDITING_PASS_THROUGH_HEADERS, QUERY_PARAM_VERCEL_PROTECTION_BYPASS, QUERY_PARAM_VERCEL_SET_BYPASS_COOKIE, } from './constants';
+import { SERVER_PROPS_ID, STATIC_PROPS_ID } from 'next/constants';
+import { getAllowedOriginsFromEnv } from '@sitecore-content-sdk/core/utils';
+/**
+ * Gets editing secret value from request
+ * @param {NextApiRequest | NextRequest} req incoming request
+ * @returns {string | undefined} editing secret value if present
+ */
+export const getEditingSecretFromRequest = (req) => {
+    const reqQuery = req.query;
+    const reqUrl = req.url;
+    let secret = undefined;
+    if (reqQuery) {
+        // pages router
+        secret = reqQuery[QUERY_PARAM_EDITING_SECRET];
+    }
+    else if (reqUrl) {
+        // app router
+        const url = new URL(reqUrl);
+        secret = url.searchParams.get(QUERY_PARAM_EDITING_SECRET);
+    }
+    return secret;
+};
+/**
+ * Parses query string and its parameters to required editing parameters
+ * @param {{ [key: string]: string | undefined }} query query string values
+ * @returns {EditingRenderQueryParams} editing parameters
+ */
+export const mapEditingParams = (query) => {
+    const params = isDesignLibraryMode(query.mode)
+        ? {
+            itemId: query.sc_itemid,
+            componentUid: query.sc_uid,
+            renderingId: query.sc_renderingId,
+            language: query.sc_lang,
+            site: query.sc_site,
+            mode: query.mode,
+            dataSourceId: query.dataSourceId,
+            version: query.sc_version,
+            generation: query.generation,
+        }
+        : {
+            site: query.sc_site,
+            itemId: query.sc_itemid,
+            language: query.sc_lang,
+            // for sc_variantId we may employ multiple variants (page-layout + component level)
+            // they will be separated by commas (,)
+            variantIds: query.sc_variant || DEFAULT_VARIANT,
+            version: query.sc_version,
+            mode: query.mode,
+            layoutKind: query.sc_layoutKind,
+        };
+    return params;
+};
+/**
+ * Filters out Next.js preview cookies from a cookie string or array
+ * @param {string | string[] | null} cookies cookie header value
+ * @returns {string[] | null} filtered cookies
+ */
+export const cleanupNextPreviewCookies = (cookies) => {
+    if (!cookies) {
+        return null;
+    }
+    if (!Array.isArray(cookies)) {
+        cookies = cookies.split(',');
+    }
+    // Filter out Next.js preview cookies
+    const filteredCookies = cookies.filter((cookie) => !new RegExp(`^${"__next_preview_data" /* PreviewCookies.PREVIEW_DATA */}=`).test(cookie) &&
+        !new RegExp(`^${"__prerender_bypass" /* PreviewCookies.PRERENDER_BYPASS */}=`).test(cookie));
+    return filteredCookies;
+};
+/**
+ * Gets the Next.js preview cookies to enable preview mode
+ * @param {string} site current site name
+ * @returns {string[]} list of cookies to set
+ */
+export const getPreviewCookies = (site) => {
+    const previewSite = `${SITE_KEY}=${site}; Path=/; HttpOnly; SameSite=None; Secure`;
+    const previewCookie = `${PREVIEW_KEY}=true; Path=/; HttpOnly; SameSite=None; Secure`;
+    return [previewSite, previewCookie];
+};
+/**
+ * Returns the list of required query parameters based on the page editing mode
+ * @param {DesignLibraryMode | LayoutServicePageState.Preview | LayoutServicePageState.Edit} mode current page mode
+ * @returns {string[]} list of required parameters for validation
+ */
+export const getRequiredEditingParamsList = (mode) => {
+    const editingRequiredParams = ['sc_site', 'sc_itemid', 'sc_lang', 'route', 'mode'];
+    const componentRequiredParams = [
+        'sc_site',
+        'sc_itemid',
+        'sc_renderingId',
+        'sc_uid',
+        'sc_lang',
+        'mode',
+    ];
+    return isDesignLibraryMode(mode) ? componentRequiredParams : editingRequiredParams;
+};
+/**
+ * Gets query parameters that should be passed along to subsequent requests (e.g. for deployment protection bypass)
+ * @param {object} query Object of query parameters from incoming URL
+ * @returns Object of approved query parameters
+ * @internal
+ */
+export const getQueryParamsForPropagation = (query) => {
+    const params = {};
+    if (query[QUERY_PARAM_VERCEL_PROTECTION_BYPASS]) {
+        params[QUERY_PARAM_VERCEL_PROTECTION_BYPASS] = query[QUERY_PARAM_VERCEL_PROTECTION_BYPASS];
+    }
+    if (query[QUERY_PARAM_VERCEL_SET_BYPASS_COOKIE]) {
+        params[QUERY_PARAM_VERCEL_SET_BYPASS_COOKIE] = query[QUERY_PARAM_VERCEL_SET_BYPASS_COOKIE];
+    }
+    return params;
+};
+/**
+ * Get headers that should be passed along to subsequent requests
+ * @param {IncomingHttpHeaders} headers Incoming HTTP Headers
+ * @returns Object of approved headers
+ * @internal
+ */
+export const getHeadersForPropagation = (headers) => {
+    // Filter and normalize headers
+    const filteredHeaders = EDITING_PASS_THROUGH_HEADERS.reduce((acc, header) => {
+        const value = headers.get
+            ? headers.get(header)
+            : headers[header];
+        if (value) {
+            acc[header] = Array.isArray(value) ? value.join(', ') : value;
+        }
+        return acc;
+    }, {});
+    return filteredHeaders;
+};
+/**
+ * Performs an internal request to get the HTML for the editing mode
+ * @param {string} requestUrl URL to send request to
+ * @param {object} propagatedQsParams query string params to use with request
+ * @param {object} propagatedHeaders headers to use with request
+ * @param {string[]} cookies cookies to use with request
+ * @param {NativeDataFetcher} dataFetcher NativeFetcher instance to send request with
+ * @returns {string} HTML with editing markup
+ */
+export const getEditingRequestHtml = (requestUrl, propagatedQsParams, propagatedHeaders, cookies, dataFetcher) => __awaiter(void 0, void 0, void 0, function* () {
+    // Grab the Next.js preview cookies to send on to the render request
+    propagatedHeaders.cookie = `${propagatedHeaders.cookie ? propagatedHeaders.cookie + ';' : ''}${cookies.join(';')}`;
+    // enable content sdk preview
+    propagatedHeaders.__content_sdk_preview = '1';
+    for (const key in propagatedQsParams) {
+        if ({}.hasOwnProperty.call(propagatedQsParams, key)) {
+            propagatedQsParams[key] && requestUrl.searchParams.append(key, propagatedQsParams[key]);
+        }
+    }
+    requestUrl.searchParams.append('timestamp', Date.now().toString());
+    const pageRes = yield dataFetcher
+        .get(requestUrl.toString(), {
+        credentials: 'include',
+        headers: propagatedHeaders,
+    })
+        .catch((err) => {
+        // We need to handle not found error provided by Vercel
+        // for `fallback: false` pages
+        if (err.response.status === 404) {
+            return err.response;
+        }
+        throw err;
+    });
+    let html = pageRes.data;
+    if (!html || html.length === 0) {
+        throw new Error(`Failed to render html for ${requestUrl.toString()}`);
+    }
+    // replace phkey attribute with key attribute so that newly added renderings
+    // show correct placeholders, so save and refresh won't be needed after adding each rendering
+    html = html.replace(new RegExp('phkey', 'g'), 'key');
+    // When SSG, Next will attempt to perform a router.replace on the client-side to inject the query string parms
+    // to the router state. See https://github.com/vercel/next.js/blob/v10.0.3/packages/next/client/index.tsx#L169.
+    // However, this doesn't really work since at this point we're in the editor and the location.search has nothing
+    // to do with the Next route/page we've rendered. Beyond the extraneous request, this can result in a 404 with
+    // certain route configurations (e.g. multiple catch-all routes).
+    // The following line will trick it into thinking we're SSR, thus avoiding any router.replace.
+    html = html.replace(STATIC_PROPS_ID, SERVER_PROPS_ID);
+    return html;
+});
+/**
+ * Type guard for Design Library mode
+ * @param {object} data preview data to check
+ * @returns true if the data is EditingPreviewData
+ * @see EditingPreviewData
+ * @public
+ */
+export const isDesignLibraryPreviewData = (data) => {
+    return (typeof data === 'object' &&
+        data !== null &&
+        'mode' in data &&
+        isDesignLibraryMode(data.mode));
+};
+/**
+ * Server URL Resolution order (highest to lowest priority):
+ * 1. `config.sitecoreInternalEditingHostUrl` (explicitly set in config)
+ * 2. Environment variable `SITECORE_INTERNAL_EDITING_HOST_URL`
+ * 3. Fallbacks:
+ *    - For XM Cloud deployments → `'http://localhost:3000'`
+ *    - For all other cases → use the request `Host` header
+ * Note we use https protocol on Vercel due to serverless function architecture.
+ * In all other scenarios, including localhost (with or without a proxy e.g. ngrok)
+ * and within a nodejs container, http protocol should be used.
+ *
+ * For information about the VERCEL environment variable, see
+ * https://vercel.com/docs/environment-variables#system-environment-variables
+ * @param {NextApiRequest} req
+ */
+export const resolveServerUrl = (req) => {
+    const internalHostUrl = process.env.SITECORE_INTERNAL_EDITING_HOST_URL;
+    if (internalHostUrl) {
+        return internalHostUrl;
+    }
+    // in xmc deployment we always use localhost:3000
+    if (process.env.SITECORE) {
+        return 'http://localhost:3000';
+    }
+    // to preserve auth headers, use https if we're in our 3 main hosting options
+    const useHttps = (process.env.VERCEL || process.env.NETLIFY) !== undefined;
+    const host = req.headers.get
+        ? req.headers.get('host')
+        : req.headers.host;
+    // use https for requests with auth but also support unsecured http rendering hosts
+    return `${useHttps ? 'https' : 'http'}://${host}`;
+};
+/**
+ * Gets the Content-Security-Policy header value
+ * @returns Content-Security-Policy header value
+ */
+export const getCSPHeader = () => {
+    return `frame-ancestors 'self' ${[...getAllowedOriginsFromEnv(), ...EDITING_ALLOWED_ORIGINS].join(' ')}`;
+};

package/dist/esm/index.js

@@ -1,25 +1,25 @@
-export { constants, 
-// generic data access
-NativeDataFetcher, enableDebug, debug, MemoryCacheClient, } from '@sitecore-content-sdk/core';
-export { LayoutServicePageState, LayoutService, getChildPlaceholder, getFieldValue, getContentStylesheetLink, EditMode, RenderingType, } from '@sitecore-content-sdk/core/layout';
-export { ErrorPage } from '@sitecore-content-sdk/core/client';
-export { ComponentLayoutService } from '@sitecore-content-sdk/core/editing';
-export { mediaApi } from '@sitecore-content-sdk/core/media';
-export { DictionaryService, } from '@sitecore-content-sdk/core/i18n';
-export { personalizeLayout, getPersonalizedRewrite, getPersonalizedRewriteData, getGroomedVariantIds, normalizePersonalizedRewrite, CdpHelper, PersonalizeService, } from '@sitecore-content-sdk/core/personalize';
-export { SitePathService, RedirectsService, REDIRECT_TYPE_301, REDIRECT_TYPE_302, REDIRECT_TYPE_SERVER_TRANSFER, } from '@sitecore-content-sdk/core/site';
-export { SitemapXmlService, ErrorPagesService, RobotsService, SiteResolver, SiteInfoService, getSiteRewrite, getSiteRewriteData, normalizeSiteRewrite, } from '@sitecore-content-sdk/core/site';
-export { ComponentPropsService } from './services/component-props-service';
-export { ComponentPropsReactContext, ComponentPropsContext, useComponentProps, } from './components/ComponentPropsContext';
-export { Link } from './components/Link';
-export { RichText } from './components/RichText';
-export { Placeholder } from './components/Placeholder';
-export { NextImage } from './components/NextImage';
-import * as FEaaSWrapper from './components/FEaaSWrapper';
-import * as BYOCWrapper from './components/BYOCWrapper';
-export { FEaaSClientWrapper, FEaaSServerWrapper, BYOCClientWrapper, BYOCServerWrapper, } from '@sitecore-content-sdk/react';
-// Preserving original FEaaSWrapper export name for backward compatibility
-// TODO: remove in future major release
-export { FEaaSWrapper };
-export { BYOCWrapper };
-export { Image, Text, DateField, FEaaSComponent, fetchFEaaSComponentServerProps, BYOCComponent, getDesignLibraryStylesheetLinks, File, DesignLibrary, DefaultEmptyFieldEditingComponentImage, DefaultEmptyFieldEditingComponentText, SitecoreProvider, SitecoreProviderReactContext, withSitecore, useSitecore, withEditorChromes, withPlaceholder, withDatasourceCheck, withFieldMetadata, withEmptyFieldEditingComponent, EditingScripts, Form, ClientEditingChromesUpdate, AppPlaceholder, } from '@sitecore-content-sdk/react';
+export { constants, 
+// generic data access
+NativeDataFetcher, enableDebug, debug, MemoryCacheClient, } from '@sitecore-content-sdk/core';
+export { LayoutServicePageState, LayoutService, getChildPlaceholder, getFieldValue, getContentStylesheetLink, EditMode, RenderingType, } from '@sitecore-content-sdk/core/layout';
+export { ErrorPage } from '@sitecore-content-sdk/core/client';
+export { ComponentLayoutService } from '@sitecore-content-sdk/core/editing';
+export { mediaApi } from '@sitecore-content-sdk/core/media';
+export { DictionaryService, } from '@sitecore-content-sdk/core/i18n';
+export { personalizeLayout, getPersonalizedRewrite, getPersonalizedRewriteData, getGroomedVariantIds, normalizePersonalizedRewrite, CdpHelper, PersonalizeService, } from '@sitecore-content-sdk/core/personalize';
+export { SitePathService, RedirectsService, REDIRECT_TYPE_301, REDIRECT_TYPE_302, REDIRECT_TYPE_SERVER_TRANSFER, } from '@sitecore-content-sdk/core/site';
+export { SitemapXmlService, ErrorPagesService, RobotsService, SiteResolver, SiteInfoService, getSiteRewrite, getSiteRewriteData, normalizeSiteRewrite, } from '@sitecore-content-sdk/core/site';
+export { ComponentPropsService } from './services/component-props-service';
+export { ComponentPropsReactContext, ComponentPropsContext, useComponentProps, } from './components/ComponentPropsContext';
+export { Link } from './components/Link';
+export { RichText } from './components/RichText';
+export { Placeholder } from './components/Placeholder';
+export { NextImage } from './components/NextImage';
+import * as FEaaSWrapper from './components/FEaaSWrapper';
+import * as BYOCWrapper from './components/BYOCWrapper';
+export { FEaaSClientWrapper, FEaaSServerWrapper, BYOCClientWrapper, BYOCServerWrapper, } from '@sitecore-content-sdk/react';
+// Preserving original FEaaSWrapper export name for backward compatibility
+// TODO: remove in future major release
+export { FEaaSWrapper };
+export { BYOCWrapper };
+export { Image, Text, DateField, FEaaSComponent, fetchFEaaSComponentServerProps, BYOCComponent, getDesignLibraryStylesheetLinks, File, DesignLibrary, DesignLibraryApp, DefaultEmptyFieldEditingComponentImage, DefaultEmptyFieldEditingComponentText, SitecoreProvider, SitecoreProviderReactContext, withSitecore, useSitecore, withEditorChromes, withPlaceholder, withDatasourceCheck, withFieldMetadata, withEmptyFieldEditingComponent, EditingScripts, Form, ClientEditingChromesUpdate, AppPlaceholder, } from '@sitecore-content-sdk/react';

package/dist/esm/middleware/app-router-multisite-middleware.js

@@ -1,16 +1,37 @@
-import { MultisiteMiddleware } from './multisite-middleware';
-/**
- * Middleware/handler for enabling multisite support in the Next.js App Router.
- */
-export class AppRouterMultisiteMiddleware extends MultisiteMiddleware {
-    /**
-     * Generates a site-specific rewrite path for app router based on the provided pathname and site name.
-     * @param {string} pathname - The pathname to be rewritten.
-     * @param {string} siteName - The name of the site.
-     * @returns The rewritten path as a string.
-     */
-    getSiteRewrite(pathname, siteName) {
-        const path = pathname.startsWith('/') ? pathname : '/' + pathname;
-        return `/${siteName}${path}`;
-    }
-}
+import { MultisiteMiddleware } from './multisite-middleware';
+/**
+ * Middleware/handler for enabling multisite support in the Next.js App Router.
+ * @public
+ */
+export class AppRouterMultisiteMiddleware extends MultisiteMiddleware {
+    /**
+     * Warns when multisite is disabled in App Router.
+     * The middleware will still run to prevent routing errors.
+     * @param {NextResponse} _res response (unused, kept for method signature compatibility)
+     */
+    // eslint-disable-next-line no-unused-vars
+    shouldWarnWhenDisabled(_res) {
+        console.warn('⚠️ Warning: Multisite is disabled in App Router configuration, but the middleware will continue running. ' +
+            'Disabling multisite in App Router would cause 404 errors for regular page requests because the route structure requires the [site] segment. ' +
+            'Preview/Editing modes will still work. ' +
+            'For single-site setups, keep multisite enabled and configure only one site.');
+    }
+    /**
+     * In App Router, we cannot skip the middleware even if enabled is false,
+     * because the route structure requires the [site] segment.
+     * @returns {boolean} always returns false (never skip) for App Router
+     */
+    shouldSkipWhenDisabled() {
+        return false; // Never skip in App Router - route structure requires [site] segment
+    }
+    /**
+     * Generates a site-specific rewrite path for app router based on the provided pathname and site name.
+     * @param {string} pathname - The pathname to be rewritten.
+     * @param {string} siteName - The name of the site.
+     * @returns The rewritten path as a string.
+     */
+    getSiteRewrite(pathname, siteName) {
+        const path = pathname.startsWith('/') ? pathname : '/' + pathname;
+        return `/${siteName}${path}`;
+    }
+}

package/dist/esm/middleware/index.js

@@ -1,11 +1,11 @@
-export { debug } from '@sitecore-content-sdk/core';
-export { MiddlewareBase, Middleware, defineMiddleware } from './middleware';
-export { RedirectsMiddleware } from './redirects-middleware';
-export { PersonalizeMiddleware } from './personalize-middleware';
-export { MultisiteMiddleware } from './multisite-middleware';
-export { AppRouterMultisiteMiddleware } from './app-router-multisite-middleware';
-export { SitemapMiddleware } from './sitemap-middleware';
-export { RobotsMiddleware } from './robots-middleware';
-export { LocaleMiddleware } from './locale-middleware';
-export { PersonalizeService, } from '@sitecore-content-sdk/core/personalize';
-export { RedirectsService, REDIRECT_TYPE_301, REDIRECT_TYPE_302, REDIRECT_TYPE_SERVER_TRANSFER, } from '@sitecore-content-sdk/core/site';
+export { debug } from '@sitecore-content-sdk/core';
+export { MiddlewareBase, Middleware, defineMiddleware } from './middleware';
+export { RedirectsMiddleware } from './redirects-middleware';
+export { PersonalizeMiddleware } from './personalize-middleware';
+export { MultisiteMiddleware } from './multisite-middleware';
+export { AppRouterMultisiteMiddleware } from './app-router-multisite-middleware';
+export { SitemapMiddleware } from './sitemap-middleware';
+export { RobotsMiddleware } from './robots-middleware';
+export { LocaleMiddleware } from './locale-middleware';
+export { PersonalizeService, } from '@sitecore-content-sdk/core/personalize';
+export { RedirectsService, REDIRECT_TYPE_301, REDIRECT_TYPE_302, REDIRECT_TYPE_SERVER_TRANSFER, } from '@sitecore-content-sdk/core/site';