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

package/dist/cjs/tools/index.js

@@ -1,13 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateMap = exports.writeImportMap = exports.extractFiles = exports.ModuleType = exports.generatePlugins = exports.getComponentList = exports.generateMetadata = exports.generateSites = void 0;
-var tools_1 = require("@sitecore-content-sdk/core/tools");
-Object.defineProperty(exports, "generateSites", { enumerable: true, get: function () { return tools_1.generateSites; } });
-Object.defineProperty(exports, "generateMetadata", { enumerable: true, get: function () { return tools_1.generateMetadata; } });
-Object.defineProperty(exports, "getComponentList", { enumerable: true, get: function () { return tools_1.getComponentList; } });
-Object.defineProperty(exports, "generatePlugins", { enumerable: true, get: function () { return tools_1.generatePlugins; } });
-Object.defineProperty(exports, "ModuleType", { enumerable: true, get: function () { return tools_1.ModuleType; } });
-Object.defineProperty(exports, "extractFiles", { enumerable: true, get: function () { return tools_1.extractFiles; } });
-Object.defineProperty(exports, "writeImportMap", { enumerable: true, get: function () { return tools_1.writeImportMap; } });
-var generate_map_1 = require("./generate-map");
-Object.defineProperty(exports, "generateMap", { enumerable: true, get: function () { return generate_map_1.generateMap; } });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeImportMap = exports.generateMap = exports.extractFiles = exports.ModuleType = exports.generatePlugins = exports.getComponentList = exports.generateMetadata = exports.generateSites = void 0;
+var tools_1 = require("@sitecore-content-sdk/core/tools");
+Object.defineProperty(exports, "generateSites", { enumerable: true, get: function () { return tools_1.generateSites; } });
+Object.defineProperty(exports, "generateMetadata", { enumerable: true, get: function () { return tools_1.generateMetadata; } });
+Object.defineProperty(exports, "getComponentList", { enumerable: true, get: function () { return tools_1.getComponentList; } });
+Object.defineProperty(exports, "generatePlugins", { enumerable: true, get: function () { return tools_1.generatePlugins; } });
+Object.defineProperty(exports, "ModuleType", { enumerable: true, get: function () { return tools_1.ModuleType; } });
+Object.defineProperty(exports, "extractFiles", { enumerable: true, get: function () { return tools_1.extractFiles; } });
+var generate_map_1 = require("./generate-map");
+Object.defineProperty(exports, "generateMap", { enumerable: true, get: function () { return generate_map_1.generateMap; } });
+var import_map_1 = require("./codegen/import-map");
+Object.defineProperty(exports, "writeImportMap", { enumerable: true, get: function () { return import_map_1.writeImportMap; } });

package/dist/cjs/tools/templating/byoc-component.js

@@ -1,18 +1,18 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.byocTemplate = void 0;
-const chalk_1 = __importDefault(require("chalk"));
-const config_1 = require("@sitecore-content-sdk/core/config");
-const constants_1 = require("./constants");
-/**
- * Next.js BYOC component boilerplate
- * @param {string} componentName - the component name
- * @returns component generated template
- */
-const generateTemplate = (componentName) => {
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.byocTemplate = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("@sitecore-content-sdk/core/config");
+const constants_1 = require("./constants");
+/**
+ * Next.js BYOC component boilerplate
+ * @param {string} componentName - the component name
+ * @returns component generated template
+ */
+const generateTemplate = (componentName) => {
     return `import React from 'react';
 import * as FEAAS from '@sitecore-feaas/clientside/react';
 
@@ -52,24 +52,24 @@ FEAAS.External.registerComponent(${componentName}, {
     },
   },
 });
-`;
-};
-/**
- * Generates a list of next steps when scaffolding a component.
- * @param {string} componentOutputPath - The file path where the component file is generated.
- * @returns {string[]} An array of strings, each representing a next step.
- */
-const getNextSteps = (componentOutputPath) => {
-    const nextSteps = [];
-    nextSteps.push('* Modify component registration through FEAAS.External.registerComponent if needed');
-    if (componentOutputPath) {
-        nextSteps.push(`* Implement the component in ${chalk_1.default.green(componentOutputPath)}`);
-    }
-    return nextSteps;
-};
-exports.byocTemplate = {
-    name: config_1.ComponentTemplateType.BYOC,
-    fileExtension: constants_1.COMPONENT_FILE_EXTENSION,
-    generateTemplate,
-    getNextSteps,
-};
+`;
+};
+/**
+ * Generates a list of next steps when scaffolding a component.
+ * @param {string} componentOutputPath - The file path where the component file is generated.
+ * @returns {string[]} An array of strings, each representing a next step.
+ */
+const getNextSteps = (componentOutputPath) => {
+    const nextSteps = [];
+    nextSteps.push('* Modify component registration through FEAAS.External.registerComponent if needed');
+    if (componentOutputPath) {
+        nextSteps.push(`* Implement the component in ${chalk_1.default.green(componentOutputPath)}`);
+    }
+    return nextSteps;
+};
+exports.byocTemplate = {
+    name: config_1.ComponentTemplateType.BYOC,
+    fileExtension: constants_1.COMPONENT_FILE_EXTENSION,
+    generateTemplate,
+    getNextSteps,
+};

package/dist/cjs/tools/templating/constants.js

@@ -1,7 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.COMPONENT_FILE_EXTENSION = void 0;
-/**
- * The file extension for nextjs components
- */
-exports.COMPONENT_FILE_EXTENSION = 'tsx';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPONENT_FILE_EXTENSION = void 0;
+/**
+ * The file extension for nextjs components
+ */
+exports.COMPONENT_FILE_EXTENSION = 'tsx';

package/dist/cjs/tools/templating/default-component.js

@@ -1,18 +1,18 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultTemplate = void 0;
-const chalk_1 = __importDefault(require("chalk"));
-const config_1 = require("@sitecore-content-sdk/core/config");
-const constants_1 = require("./constants");
-/**
- * Next.js component boilerplate
- * @param {string} componentName - the component name
- * @returns component generated template
- */
-const generateTemplate = (componentName) => {
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultTemplate = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("@sitecore-content-sdk/core/config");
+const constants_1 = require("./constants");
+/**
+ * Next.js component boilerplate
+ * @param {string} componentName - the component name
+ * @returns component generated template
+ */
+const generateTemplate = (componentName) => {
     return `import React from 'react';
 import { ComponentParams, ComponentRendering } from '@sitecore-content-sdk/nextjs';
 
@@ -32,23 +32,23 @@ export const Default = (props: ${componentName}Props): JSX.Element => {
     </div>
   );
 };
-`;
-};
-/**
- * Generates a list of next steps when scaffolding a component.
- * @param {string} componentOutputPath - The file path where the component file is generated.
- * @returns {string[]} An array of strings, each representing a next step.
- */
-const getNextSteps = (componentOutputPath) => {
-    const nextSteps = [];
-    if (componentOutputPath) {
-        nextSteps.push(`* Implement the React component in ${chalk_1.default.green(componentOutputPath)}`);
-    }
-    return nextSteps;
-};
-exports.defaultTemplate = {
-    name: config_1.ComponentTemplateType.DEFAULT,
-    fileExtension: constants_1.COMPONENT_FILE_EXTENSION,
-    generateTemplate,
-    getNextSteps,
-};
+`;
+};
+/**
+ * Generates a list of next steps when scaffolding a component.
+ * @param {string} componentOutputPath - The file path where the component file is generated.
+ * @returns {string[]} An array of strings, each representing a next step.
+ */
+const getNextSteps = (componentOutputPath) => {
+    const nextSteps = [];
+    if (componentOutputPath) {
+        nextSteps.push(`* Implement the React component in ${chalk_1.default.green(componentOutputPath)}`);
+    }
+    return nextSteps;
+};
+exports.defaultTemplate = {
+    name: config_1.ComponentTemplateType.DEFAULT,
+    fileExtension: constants_1.COMPONENT_FILE_EXTENSION,
+    generateTemplate,
+    getNextSteps,
+};

package/dist/cjs/tools/templating/utils.js

@@ -0,0 +1,200 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectRouterType = detectRouterType;
+exports.detectComponentType = detectComponentType;
+exports.getComponentListWithTypes = getComponentListWithTypes;
+exports.nextjsClientMapTemplate = nextjsClientMapTemplate;
+exports.nextjsDefaultMapTemplate = nextjsDefaultMapTemplate;
+const tools_1 = require("@sitecore-content-sdk/core/tools");
+const typescript_1 = __importDefault(require("typescript"));
+const fs_1 = __importDefault(require("fs"));
+const tools_2 = require("@sitecore-content-sdk/core/tools");
+/**
+ * Detects the Next.js router type (App Router or Pages Router) based on directory structure.
+ * @param {string} projectRoot - The project root directory. Defaults to current working directory.
+ * @returns {RouterType} 'app' if App Router is detected, 'pages' otherwise
+ * @internal
+ */
+function detectRouterType(projectRoot = process.cwd()) {
+    const appDirExists = fs_1.default.existsSync(`${projectRoot}/src/app`) || fs_1.default.existsSync(`${projectRoot}/app`);
+    const pagesDirExists = fs_1.default.existsSync(`${projectRoot}/src/pages`) || fs_1.default.existsSync(`${projectRoot}/pages`);
+    if (appDirExists) {
+        return 'app';
+    }
+    if (pagesDirExists) {
+        return 'pages';
+    }
+    return 'pages';
+}
+/**
+ * Detects the component type based on directives, imports, and router context.
+ * - Checks for 'use client' directive
+ * - Checks for explicit componentType export
+ * - Checks for server-only imports (next/headers, etc.)
+ * - Defaults to 'server' for App Router, 'universal' for Pages Router
+ * @param {string} filePath - Path to the component file
+ * @param {RouterType} [routerType] - Optional router type override. Auto-detected if not provided.
+ * @returns {ComponentType} 'server', 'client', or 'universal'
+ * @internal
+ */
+function detectComponentType(filePath, routerType) {
+    try {
+        const content = fs_1.default.readFileSync(filePath, 'utf-8');
+        // Parse using TypeScript AST (following patterns from import-map.ts and utils.ts)
+        const sourceFile = typescript_1.default.createSourceFile(filePath, content, typescript_1.default.ScriptTarget.Latest, true);
+        let hasUseClientDirective = false;
+        let explicitComponentType = null;
+        let hasServerOnlyImports = false;
+        // Auto-detect router type if not provided
+        const detectedRouterType = routerType || detectRouterType();
+        // Track position to ensure directives come before imports/other statements
+        let foundFirstNonDirectiveStatement = false;
+        // Helper function to check if a node is a valid directive
+        const isValidDirective = (node) => {
+            return (typescript_1.default.isExpressionStatement(node) &&
+                typescript_1.default.isStringLiteral(node.expression) &&
+                !foundFirstNonDirectiveStatement);
+        };
+        // More comprehensive AST traversal (following patterns from import-map.ts and utils.ts)
+        const traverseNode = (node) => {
+            var _a;
+            // Check for 'use client'/'use server' directives (must be at top, before imports)
+            if (isValidDirective(node) &&
+                typescript_1.default.isStringLiteral(node.expression)) {
+                const directiveText = node.expression
+                    .text;
+                if (directiveText === 'use client') {
+                    hasUseClientDirective = true;
+                    return; // Don't mark as non-directive statement
+                }
+                if (directiveText === 'use server') {
+                    explicitComponentType = 'server';
+                    return; // Don't mark as non-directive statement
+                }
+            }
+            // Mark that we've seen a non-directive statement (imports, declarations, etc.)
+            if (typescript_1.default.isImportDeclaration(node) ||
+                typescript_1.default.isVariableStatement(node) ||
+                typescript_1.default.isFunctionDeclaration(node) ||
+                typescript_1.default.isExportDeclaration(node) ||
+                typescript_1.default.isExportAssignment(node)) {
+                foundFirstNonDirectiveStatement = true;
+            }
+            // Check for import declarations with server-only modules
+            if (typescript_1.default.isImportDeclaration(node)) {
+                const moduleSpecifier = node.moduleSpecifier;
+                if (typescript_1.default.isStringLiteral(moduleSpecifier)) {
+                    const importPath = moduleSpecifier.text;
+                    // Expand server-only module detection
+                    if (importPath === 'next/headers' ||
+                        importPath === 'server-only' ||
+                        importPath === 'next/cache' ||
+                        importPath === 'next/cookies' ||
+                        importPath.startsWith('node:') ||
+                        importPath === 'fs' ||
+                        importPath === 'path') {
+                        hasServerOnlyImports = true;
+                    }
+                }
+            }
+            // Check for explicit componentType export (improved detection)
+            if (typescript_1.default.isVariableStatement(node)) {
+                const hasExportModifier = (_a = node.modifiers) === null || _a === void 0 ? void 0 : _a.some((modifier) => modifier.kind === typescript_1.default.SyntaxKind.ExportKeyword);
+                if (hasExportModifier) {
+                    node.declarationList.declarations.forEach((declaration) => {
+                        if (typescript_1.default.isIdentifier(declaration.name) &&
+                            declaration.name.text === 'componentType' &&
+                            declaration.initializer) {
+                            // Handle string literal
+                            if (typescript_1.default.isStringLiteral(declaration.initializer)) {
+                                const typeValue = declaration.initializer.text;
+                                if (typeValue === 'server' || typeValue === 'client' || typeValue === 'universal') {
+                                    explicitComponentType = typeValue;
+                                }
+                            }
+                            // Handle template literal (e.g., `client`)
+                            else if (typescript_1.default.isNoSubstitutionTemplateLiteral(declaration.initializer)) {
+                                const typeValue = declaration.initializer.text;
+                                if (typeValue === 'server' || typeValue === 'client' || typeValue === 'universal') {
+                                    explicitComponentType = typeValue;
+                                }
+                            }
+                        }
+                    });
+                }
+            }
+            // Check for named export of componentType (export const componentType = ...)
+            if (typescript_1.default.isExportDeclaration(node) &&
+                node.exportClause &&
+                typescript_1.default.isNamedExports(node.exportClause)) {
+                node.exportClause.elements.forEach((exportSpecifier) => {
+                    if (exportSpecifier.name.text === 'componentType') {
+                        // This would need additional logic to resolve the actual value, but for now
+                        // we'll rely on the variable declaration detection above
+                    }
+                });
+            }
+            // Recursively traverse child nodes (following import-map.ts pattern)
+            typescript_1.default.forEachChild(node, traverseNode);
+        };
+        // Start traversal from the source file (following utils.ts pattern)
+        typescript_1.default.forEachChild(sourceFile, traverseNode);
+        // Priority: explicit componentType export > use client/server directives > server-only imports > universal default
+        if (explicitComponentType) {
+            return explicitComponentType;
+        }
+        if (hasUseClientDirective) {
+            return 'client';
+        }
+        if (hasServerOnlyImports) {
+            return 'server';
+        }
+        // Router-aware defaults:
+        // - App Router: defaults to server (RSC by default)
+        // - Pages Router: defaults to universal (isomorphic by default)
+        if (detectedRouterType === 'app') {
+            return 'server';
+        }
+        else {
+            return 'universal';
+        }
+    }
+    catch (error) {
+        console.warn(`Failed to parse component file ${filePath}, defaulting to universal:`, error);
+        return 'universal';
+    }
+}
+/**
+ * Get list of components with detected types (server, client, or universal).
+ * @param {string[]} paths - Paths to search for components
+ * @param {string[]} [exclude] - Paths and glob patterns to exclude from final result
+ * @param {boolean} includeVariants - Whether to include variant components
+ * @param {RouterType} [routerType] - Optional router type override for type detection. Auto-detected if not provided.
+ * @returns {ComponentFileWithType[]} Array of components with their detected types
+ * @internal
+ */
+function getComponentListWithTypes(paths, exclude, includeVariants, routerType) {
+    const components = (0, tools_1.getComponentList)(paths, exclude, includeVariants);
+    const detectedRouterType = routerType || detectRouterType();
+    return components.map((component) => (Object.assign(Object.assign({}, component), { componentType: detectComponentType(component.filePath, detectedRouterType) })));
+}
+/**
+ * React-specific import map template with 'use client' directive. Used in App Router.
+ * @param {Map<string, ModuleExports>} indexedImportMap import map to be processed into final import-map.client.ts file
+ * @returns {string} contents for resulting import map file
+ */
+function nextjsClientMapTemplate(indexedImportMap) {
+    return `'use client';
+  ${(0, tools_2.defaultImportMapTemplate)(indexedImportMap, 'nextjs')}`;
+}
+/**
+ * React-specific import map template with 'use client' directive. Used in App Router.
+ * @param {Map<string, ModuleExports>} indexedImportMap import map to be processed into final import-map.client.ts file
+ * @returns {string} contents for resulting import map file
+ */
+function nextjsDefaultMapTemplate(indexedImportMap) {
+    return (0, tools_2.defaultImportMapTemplate)(indexedImportMap, 'nextjs');
+}

package/dist/cjs/utils/index.js

@@ -1,14 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resetEditorChromes = exports.isEditorActive = exports.resolveUrl = exports.tryParseEnvValue = exports.parseRewriteHeader = exports.isServerSidePropsContext = exports.extractPath = exports.handleEditorFastRefresh = void 0;
-var utils_1 = require("./utils");
-Object.defineProperty(exports, "handleEditorFastRefresh", { enumerable: true, get: function () { return utils_1.handleEditorFastRefresh; } });
-Object.defineProperty(exports, "extractPath", { enumerable: true, get: function () { return utils_1.extractPath; } });
-Object.defineProperty(exports, "isServerSidePropsContext", { enumerable: true, get: function () { return utils_1.isServerSidePropsContext; } });
-Object.defineProperty(exports, "parseRewriteHeader", { enumerable: true, get: function () { return utils_1.parseRewriteHeader; } });
-var utils_2 = require("@sitecore-content-sdk/core/utils");
-Object.defineProperty(exports, "tryParseEnvValue", { enumerable: true, get: function () { return utils_2.tryParseEnvValue; } });
-Object.defineProperty(exports, "resolveUrl", { enumerable: true, get: function () { return utils_2.resolveUrl; } });
-var editing_1 = require("@sitecore-content-sdk/core/editing");
-Object.defineProperty(exports, "isEditorActive", { enumerable: true, get: function () { return editing_1.isEditorActive; } });
-Object.defineProperty(exports, "resetEditorChromes", { enumerable: true, get: function () { return editing_1.resetEditorChromes; } });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetEditorChromes = exports.isEditorActive = exports.resolveUrl = exports.tryParseEnvValue = exports.parseRewriteHeader = exports.isServerSidePropsContext = exports.extractPath = exports.handleEditorFastRefresh = void 0;
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "handleEditorFastRefresh", { enumerable: true, get: function () { return utils_1.handleEditorFastRefresh; } });
+Object.defineProperty(exports, "extractPath", { enumerable: true, get: function () { return utils_1.extractPath; } });
+Object.defineProperty(exports, "isServerSidePropsContext", { enumerable: true, get: function () { return utils_1.isServerSidePropsContext; } });
+Object.defineProperty(exports, "parseRewriteHeader", { enumerable: true, get: function () { return utils_1.parseRewriteHeader; } });
+var utils_2 = require("@sitecore-content-sdk/core/utils");
+Object.defineProperty(exports, "tryParseEnvValue", { enumerable: true, get: function () { return utils_2.tryParseEnvValue; } });
+Object.defineProperty(exports, "resolveUrl", { enumerable: true, get: function () { return utils_2.resolveUrl; } });
+var editing_1 = require("@sitecore-content-sdk/core/editing");
+Object.defineProperty(exports, "isEditorActive", { enumerable: true, get: function () { return editing_1.isEditorActive; } });
+Object.defineProperty(exports, "resetEditorChromes", { enumerable: true, get: function () { return editing_1.resetEditorChromes; } });

package/dist/cjs/utils/utils.js

@@ -1,73 +1,82 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseRewriteHeader = exports.isServerSidePropsContext = exports.extractPath = exports.getEditingSecret = exports.handleEditorFastRefresh = void 0;
-const editing_1 = require("@sitecore-content-sdk/core/editing");
-const middleware_1 = require("../middleware/middleware");
-/**
- * Since Sitecore editors do not support Fast Refresh:
- * 1. Subscribe on events provided by webpack.
- * 2. Reset editor chromes when build is finished
- * @param {boolean} [forceReload] force page reload instead of reset chromes
- */
-const handleEditorFastRefresh = (forceReload = false) => {
-    if (process.env.NODE_ENV !== 'development' || !(0, editing_1.isEditorActive)()) {
-        // Only run if development mode and editor is active
-        return;
-    }
-    const eventSource = new window.EventSource('/_next/webpack-hmr');
-    window.addEventListener('beforeunload', () => eventSource.close());
-    eventSource.onopen = () => console.log('[Sitecore Editor Fast Refresh Listener] Online');
-    eventSource.onmessage = (event) => {
-        if (event.data.indexOf('{') === -1)
-            return; // heartbeat
-        const payload = JSON.parse(event.data);
-        console.debug(`[Sitecore Editor Fast Refresh Listener] Saw event: ${JSON.stringify(payload)}`);
-        if (payload.action !== 'built')
-            return;
-        if (forceReload)
-            return window.location.reload();
-        setTimeout(() => {
-            console.log('[Sitecore Editor HMR Listener] Sitecore editor does not support Fast Refresh, reloading chromes...');
-            (0, editing_1.resetEditorChromes)();
-        }, 500);
-    };
-};
-exports.handleEditorFastRefresh = handleEditorFastRefresh;
-const getEditingSecret = () => {
-    const secret = process.env.SITECORE_EDITING_SECRET;
-    if (!secret || secret.length === 0) {
-        throw new Error('The SITECORE_EDITING_SECRET environment variable is missing or invalid.');
-    }
-    return secret;
-};
-exports.getEditingSecret = getEditingSecret;
-const extractPath = (context) => {
-    var _a;
-    return context.params === undefined
-        ? '/'
-        : Array.isArray(context.params.path)
-            ? context.params.path.join('/')
-            : (_a = context.params.path) !== null && _a !== void 0 ? _a : '/';
-};
-exports.extractPath = extractPath;
-/**
- * Determines whether context is GetServerSidePropsContext (SSR) or GetStaticPropsContext (SSG)
- * @param {GetServerSidePropsContext | GetStaticPropsContext} context
- */
-const isServerSidePropsContext = (context) => {
-    return context.req !== undefined;
-};
-exports.isServerSidePropsContext = isServerSidePropsContext;
-/**
- * For App Router application, extracts the site and locale information from the rewrite header which is in format /[site]/[locale]/[...path].
- * @param {Headers} headers - The `Headers` object containing the rewrite header.
- * @returns An object containing the `site` and `locale` extracted from the rewrite header.
- */
-const parseRewriteHeader = (headers) => {
-    const rewriteHeader = headers.get(middleware_1.REWRITE_HEADER_NAME);
-    const rewriteSegments = (rewriteHeader === null || rewriteHeader === void 0 ? void 0 : rewriteHeader.split('/').filter((segment) => segment)) || [];
-    const site = rewriteSegments[0];
-    const locale = rewriteSegments[1];
-    return { site, locale };
-};
-exports.parseRewriteHeader = parseRewriteHeader;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRewriteHeader = exports.isServerSidePropsContext = exports.extractPath = exports.getEditingSecret = exports.handleEditorFastRefresh = void 0;
+const editing_1 = require("@sitecore-content-sdk/core/editing");
+const middleware_1 = require("../middleware/middleware");
+/**
+ * Since Sitecore editors do not support Fast Refresh:
+ * 1. Subscribe on events provided by webpack.
+ * 2. Reset editor chromes when build is finished
+ * @param {boolean} [forceReload] force page reload instead of reset chromes
+ * @public
+ */
+const handleEditorFastRefresh = (forceReload = false) => {
+    if (process.env.NODE_ENV !== 'development' || !(0, editing_1.isEditorActive)()) {
+        // Only run if development mode and editor is active
+        return;
+    }
+    const eventSource = new window.EventSource('/_next/webpack-hmr');
+    window.addEventListener('beforeunload', () => eventSource.close());
+    eventSource.onopen = () => console.log('[Sitecore Editor Fast Refresh Listener] Online');
+    eventSource.onmessage = (event) => {
+        if (event.data.indexOf('{') === -1)
+            return; // heartbeat
+        const payload = JSON.parse(event.data);
+        console.debug(`[Sitecore Editor Fast Refresh Listener] Saw event: ${JSON.stringify(payload)}`);
+        if (payload.action !== 'built')
+            return;
+        if (forceReload)
+            return window.location.reload();
+        setTimeout(() => {
+            console.log('[Sitecore Editor HMR Listener] Sitecore editor does not support Fast Refresh, reloading chromes...');
+            (0, editing_1.resetEditorChromes)();
+        }, 500);
+    };
+};
+exports.handleEditorFastRefresh = handleEditorFastRefresh;
+const getEditingSecret = () => {
+    const secret = process.env.SITECORE_EDITING_SECRET;
+    if (!secret || secret.length === 0) {
+        throw new Error('The SITECORE_EDITING_SECRET environment variable is missing or invalid.');
+    }
+    return secret;
+};
+exports.getEditingSecret = getEditingSecret;
+/**
+ * Extracts the path from the Next.js context parameters.
+ * @param {GetStaticPropsContext | GetServerSidePropsContext} context - The Next.js context parameters.
+ * @returns The extracted path.
+ * @public
+ */
+const extractPath = (context) => {
+    var _a;
+    return context.params === undefined
+        ? '/'
+        : Array.isArray(context.params.path)
+            ? context.params.path.join('/')
+            : (_a = context.params.path) !== null && _a !== void 0 ? _a : '/';
+};
+exports.extractPath = extractPath;
+/**
+ * Determines whether context is GetServerSidePropsContext (SSR) or GetStaticPropsContext (SSG)
+ * @param {GetServerSidePropsContext | GetStaticPropsContext} context
+ * @public
+ */
+const isServerSidePropsContext = (context) => {
+    return context.req !== undefined;
+};
+exports.isServerSidePropsContext = isServerSidePropsContext;
+/**
+ * For App Router application, extracts the site and locale information from the rewrite header which is in format /[site]/[locale]/[...path].
+ * @param {Headers} headers - The `Headers` object containing the rewrite header.
+ * @returns An object containing the `site` and `locale` extracted from the rewrite header.
+ * @public
+ */
+const parseRewriteHeader = (headers) => {
+    const rewriteHeader = headers.get(middleware_1.REWRITE_HEADER_NAME);
+    const rewriteSegments = (rewriteHeader === null || rewriteHeader === void 0 ? void 0 : rewriteHeader.split('/').filter((segment) => segment)) || [];
+    const site = rewriteSegments[0];
+    const locale = rewriteSegments[1];
+    return { site, locale };
+};
+exports.parseRewriteHeader = parseRewriteHeader;

package/dist/esm/client/index.js

@@ -1,2 +1,2 @@
-export { DefaultRetryStrategy, GraphQLRequestClient, getEdgeProxyContentUrl, createGraphQLClientFactory, } from '@sitecore-content-sdk/core/client';
-export { SitecoreNextjsClient as SitecoreClient } from './sitecore-nextjs-client';
+export { DefaultRetryStrategy, GraphQLRequestClient, getEdgeProxyContentUrl, createGraphQLClientFactory, } from '@sitecore-content-sdk/core/client';
+export { SitecoreNextjsClient as SitecoreClient } from './sitecore-nextjs-client';

package/dist/esm/client/models.js

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