@salesforce/storefront-next-dev 0.1.1 → 0.2.0-alpha.1

package/dist/commands/preview.js

@@ -0,0 +1,101 @@
+import { a as printServerInfo, c as warn, i as printServerConfig, n as error, o as printShutdownMessage, r as info } from "../logger.js";
+import { c as loadEnvFile } from "../utils.js";
+import { n as getCommerceCloudApiUrl, r as loadProjectConfig, t as createServer } from "../server.js";
+import { t as commonFlags } from "../flags.js";
+import { Command, Flags } from "@oclif/core";
+import { execSync } from "child_process";
+import path from "path";
+import fs from "fs";
+import { pathToFileURL } from "url";
+
+//#region src/lib/preview.ts
+/**
+* Start the preview server with production build
+*/
+async function preview(options = {}) {
+	const startTime = Date.now();
+	const projectDir = path.resolve(options.projectDirectory || process.cwd());
+	const port = options.port || 3e3;
+	process.env.NODE_ENV = process.env.NODE_ENV ?? "production";
+	process.env.EXTERNAL_DOMAIN_NAME = process.env.EXTERNAL_DOMAIN_NAME ?? `localhost:${port}`;
+	loadEnvFile(projectDir);
+	const buildPath = path.join(projectDir, "build", "server", "index.js");
+	if (!fs.existsSync(buildPath)) {
+		warn("Production build not found. Building project...");
+		info("Running: pnpm build");
+		try {
+			execSync("pnpm build", {
+				cwd: projectDir,
+				stdio: "inherit"
+			});
+			info("Build completed successfully");
+		} catch (err) {
+			error(`Build failed: ${err instanceof Error ? err.message : String(err)}`);
+			process.exit(1);
+		}
+		if (!fs.existsSync(buildPath)) {
+			error(`Build still not found at ${buildPath} after running build command`);
+			process.exit(1);
+		}
+	}
+	info(`Loading production build from ${buildPath}`);
+	const build = (await import(pathToFileURL(buildPath).href)).default;
+	const config = await loadProjectConfig(projectDir);
+	const server = (await createServer({
+		mode: "preview",
+		projectDirectory: projectDir,
+		config,
+		port,
+		build
+	})).listen(port, () => {
+		printServerInfo("preview", port, startTime, projectDir);
+		printServerConfig({
+			mode: "preview",
+			port,
+			enableProxy: true,
+			enableStaticServing: true,
+			enableCompression: true,
+			proxyPath: config.commerce.api.proxy,
+			proxyHost: getCommerceCloudApiUrl(config.commerce.api.shortCode),
+			shortCode: config.commerce.api.shortCode,
+			organizationId: config.commerce.api.organizationId,
+			clientId: config.commerce.api.clientId,
+			siteId: config.commerce.api.siteId
+		});
+	});
+	["SIGTERM", "SIGINT"].forEach((signal) => {
+		process.once(signal, () => {
+			printShutdownMessage();
+			server?.close(() => {
+				process.exit(0);
+			});
+		});
+	});
+}
+
+//#endregion
+//#region src/commands/preview.ts
+/**
+* Preview server command - starts the preview server with production build.
+*/
+var Preview = class Preview extends Command {
+	static description = "Start preview server with production build (auto-builds if needed)";
+	static examples = ["<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> -d ./my-project -p 4000"];
+	static flags = {
+		...commonFlags,
+		port: Flags.integer({
+			char: "p",
+			description: "Port number (default: 3000)"
+		})
+	};
+	async run() {
+		const { flags } = await this.parse(Preview);
+		await preview({
+			projectDirectory: flags["project-directory"],
+			port: flags.port
+		});
+	}
+};
+
+//#endregion
+export { Preview as default };

package/dist/commands/push.js

@@ -0,0 +1,139 @@
+import "../logger.js";
+import { n as getDefaultBuildDir, r as getDefaultMessage } from "../utils.js";
+import { t as createBundle } from "../bundle.js";
+import { a as buildMrtConfig, i as SFNEXT_BASE_CARTRIDGE_OUTPUT_DIR, n as GENERATE_AND_DEPLOY_CARTRIDGE_ON_MRT_PUSH, r as SFNEXT_BASE_CARTRIDGE_NAME, t as CARTRIDGES_BASE_DIR } from "../config.js";
+import { t as generateMetadata } from "../generate-cartridge.js";
+import { Flags } from "@oclif/core";
+import path from "path";
+import fs from "fs-extra";
+import { MrtCommand } from "@salesforce/b2c-tooling-sdk/cli";
+import { resolveConfig } from "@salesforce/b2c-tooling-sdk/config";
+import { uploadCartridges } from "@salesforce/b2c-tooling-sdk/operations/code";
+import { uploadBundle, waitForEnv } from "@salesforce/b2c-tooling-sdk/operations/mrt";
+import { DEFAULT_MRT_ORIGIN, createMrtClient } from "@salesforce/b2c-tooling-sdk/clients";
+
+//#region src/commands/push.ts
+/**
+* MRT Push command - builds and pushes bundle to Managed Runtime.
+*
+* Inherits MRT flags from MrtCommand:
+* - --api-key: MRT API key (env: SFCC_MRT_API_KEY)
+* - --project/-p: MRT project slug (env: SFCC_MRT_PROJECT)
+* - --environment/-e: MRT target environment (env: SFCC_MRT_ENVIRONMENT)
+* - --cloud-origin: MRT cloud origin URL (env: SFCC_MRT_CLOUD_ORIGIN)
+* - --credentials-file: Path to MRT credentials file (env: MRT_CREDENTIALS_FILE)
+* - --config: Path to dw.json config file (env: SFCC_CONFIG)
+* - --instance/-i: Named instance from config (env: SFCC_INSTANCE)
+*/
+var Push = class Push extends MrtCommand {
+	static description = "Build and push bundle to Managed Runtime";
+	static examples = [
+		"<%= config.bin %> <%= command.id %>",
+		"<%= config.bin %> <%= command.id %> --project-directory ./my-project",
+		"<%= config.bin %> <%= command.id %> --project my-project --environment staging",
+		"<%= config.bin %> <%= command.id %> --wait"
+	];
+	static flags = {
+		...MrtCommand.baseFlags,
+		"build-directory": Flags.string({
+			char: "b",
+			description: "Build directory to push (default: auto-detected)"
+		}),
+		message: Flags.string({
+			char: "m",
+			description: "Bundle message (default: git branch:commit)"
+		}),
+		wait: Flags.boolean({
+			char: "w",
+			description: "Wait for deployment to complete",
+			default: false
+		}),
+		"project-slug": Flags.string({
+			char: "s",
+			description: "DEPRECATED: Use --project instead",
+			hidden: true
+		}),
+		target: Flags.string({
+			char: "t",
+			description: "DEPRECATED: Use --environment instead",
+			hidden: true
+		})
+	};
+	async run() {
+		const { flags } = await this.parse(Push);
+		const projectDirectory = flags["project-directory"] || process.cwd();
+		if (flags["project-slug"]) this.warn("Flag --project-slug is deprecated. Use --project instead.");
+		if (flags.target) this.warn("Flag --target is deprecated. Use --environment instead.");
+		const target = flags.environment || flags.target || this.resolvedConfig.values.mrtEnvironment;
+		if (flags.wait && !target) this.error("You must provide a target environment when using --wait (via --environment flag, SFCC_MRT_ENVIRONMENT env var, or dw.json)");
+		if (!fs.existsSync(projectDirectory)) this.error(`Project directory "${projectDirectory}" does not exist!`);
+		const projectSlug = flags.project || flags["project-slug"] || this.resolvedConfig.values.mrtProject;
+		if (!projectSlug || projectSlug.trim() === "") this.error("Project slug is required. Provide --project, set SFCC_MRT_PROJECT env var, or configure mrtProject in dw.json");
+		const buildDirectory = flags["build-directory"] ?? getDefaultBuildDir(projectDirectory);
+		if (!fs.existsSync(buildDirectory)) this.error(`Build directory "${buildDirectory}" does not exist!`);
+		if (GENERATE_AND_DEPLOY_CARTRIDGE_ON_MRT_PUSH) await this.generateAndDeployCartridge(projectDirectory);
+		if (target) process.env.DEPLOY_TARGET = target;
+		this.requireMrtCredentials();
+		const config = buildMrtConfig(buildDirectory, projectDirectory);
+		const message = flags.message ?? getDefaultMessage(projectDirectory);
+		this.log(`Creating bundle for project: ${projectSlug}`);
+		if (target) this.log(`Target environment: ${target}`);
+		const bundle = await createBundle({
+			message,
+			ssr_parameters: config.ssrParameters,
+			ssr_only: config.ssrOnly,
+			ssr_shared: config.ssrShared,
+			buildDirectory,
+			projectDirectory,
+			projectSlug
+		});
+		const origin = this.resolvedConfig.values.mrtOrigin || DEFAULT_MRT_ORIGIN;
+		const client = createMrtClient({ origin }, this.getMrtAuth());
+		this.log(`Beginning upload to ${origin}`);
+		const result = await uploadBundle(client, projectSlug, bundle, target);
+		if (flags.wait && target) {
+			this.log("Bundle uploaded - waiting for deployment to complete");
+			await waitForEnv({
+				projectSlug,
+				slug: target,
+				origin
+			}, this.getMrtAuth());
+			this.log("Deployment complete!");
+		} else this.log("Bundle uploaded successfully!");
+		this.log(`Bundle ID: ${result.bundleId}`);
+	}
+	/**
+	* Generate and deploy cartridge metadata to B2C instance.
+	* This is a pre-MRT-push step that ensures Page Designer metadata is current.
+	*/
+	async generateAndDeployCartridge(projectDirectory) {
+		const metadataDir = path.join(projectDirectory, CARTRIDGES_BASE_DIR, SFNEXT_BASE_CARTRIDGE_OUTPUT_DIR);
+		try {
+			this.log("Generating cartridge metadata before MRT push...");
+			if (!fs.existsSync(metadataDir)) fs.mkdirSync(metadataDir, { recursive: true });
+			await generateMetadata(projectDirectory, metadataDir);
+			this.log("Cartridge metadata generated successfully!");
+			this.log("Deploying cartridge to Commerce Cloud...");
+			const b2cConfig = resolveConfig({}, { workingDirectory: projectDirectory });
+			if (!b2cConfig.hasB2CInstanceConfig()) {
+				this.warn("B2C instance not configured, skipping cartridge deployment");
+				return;
+			}
+			if (!b2cConfig.values.codeVersion) {
+				this.warn("Code version not configured, skipping cartridge deployment");
+				return;
+			}
+			await uploadCartridges(b2cConfig.createB2CInstance(), [{
+				name: SFNEXT_BASE_CARTRIDGE_NAME,
+				src: path.join(projectDirectory, CARTRIDGES_BASE_DIR, SFNEXT_BASE_CARTRIDGE_NAME),
+				dest: SFNEXT_BASE_CARTRIDGE_NAME
+			}]);
+			this.log("Cartridge deployed successfully!");
+		} catch (cartridgeError) {
+			this.warn(`Failed to generate or deploy cartridge: ${cartridgeError.message}`);
+		}
+	}
+};
+
+//#endregion
+export { Push as default };

package/dist/config.js

@@ -0,0 +1,87 @@
+//#region src/mrt/utils.ts
+const MRT_BUNDLE_TYPE_SSR = "ssr";
+const MRT_STREAMING_ENTRY_FILE = "streamingHandler";
+/**
+* Gets the MRT entry file for the given mode
+* @param mode - The mode to get the MRT entry file for
+* @returns The MRT entry file for the given mode
+*/
+const getMrtEntryFile = (mode) => {
+	return process.env.MRT_BUNDLE_TYPE !== MRT_BUNDLE_TYPE_SSR && mode === "production" ? MRT_STREAMING_ENTRY_FILE : MRT_BUNDLE_TYPE_SSR;
+};
+
+//#endregion
+//#region src/config.ts
+const CARTRIDGES_BASE_DIR = "cartridges";
+const SFNEXT_BASE_CARTRIDGE_NAME = "app_storefrontnext_base";
+const SFNEXT_BASE_CARTRIDGE_OUTPUT_DIR = `${SFNEXT_BASE_CARTRIDGE_NAME}/cartridge/experience`;
+/**
+* When enabled, automatically generates and deploys cartridge metadata before an MRT push.
+* This is useful for keeping Page Designer metadata in sync with component changes.
+*
+* When enabled:
+* 1. Generates cartridge metadata from decorated components
+* 2. Deploys the cartridge to Commerce Cloud (requires dw.json configuration)
+* 3. Proceeds with the MRT push
+*
+* To enable: Set this to `true` in your local config.ts
+* Default: false (manual cartridge generation/deployment via `sfnext generate-cartridge` and `sfnext deploy-cartridge`)
+*/
+const GENERATE_AND_DEPLOY_CARTRIDGE_ON_MRT_PUSH = false;
+/**
+* Build MRT SSR configuration for bundle deployment
+*
+* Defines which files should be:
+* - Server-only (ssrOnly): Deployed only to Lambda functions
+* - Shared (ssrShared): Deployed to both Lambda and CDN
+*
+* @param buildDirectory - Path to the build output directory
+* @param projectDirectory - Path to the project root (reserved for future use)
+* @returns MRT SSR configuration with glob patterns
+*/
+const buildMrtConfig = (_buildDirectory, _projectDirectory) => {
+	const ssrEntryPoint = getMrtEntryFile("production");
+	return {
+		ssrOnly: [
+			"server/**/*",
+			"loader.js",
+			`${ssrEntryPoint}.{js,mjs,cjs}`,
+			`${ssrEntryPoint}.{js,mjs,cjs}.map`,
+			"!static/**/*",
+			"sfnext-server-*.mjs",
+			"!**/*.stories.tsx",
+			"!**/*.stories.ts",
+			"!**/*-snapshot.tsx",
+			"!.storybook/**/*",
+			"!storybook-static/**/*",
+			"!**/__mocks__/**/*",
+			"!**/__snapshots__/**/*"
+		],
+		ssrShared: [
+			"client/**/*",
+			"static/**/*",
+			"**/*.css",
+			"**/*.png",
+			"**/*.jpg",
+			"**/*.jpeg",
+			"**/*.gif",
+			"**/*.svg",
+			"**/*.ico",
+			"**/*.woff",
+			"**/*.woff2",
+			"**/*.ttf",
+			"**/*.eot",
+			"!**/*.stories.tsx",
+			"!**/*.stories.ts",
+			"!**/*-snapshot.tsx",
+			"!.storybook/**/*",
+			"!storybook-static/**/*",
+			"!**/__mocks__/**/*",
+			"!**/__snapshots__/**/*"
+		],
+		ssrParameters: { ssrFunctionNodeVersion: "24.x" }
+	};
+};
+
+//#endregion
+export { buildMrtConfig as a, SFNEXT_BASE_CARTRIDGE_OUTPUT_DIR as i, GENERATE_AND_DEPLOY_CARTRIDGE_ON_MRT_PUSH as n, SFNEXT_BASE_CARTRIDGE_NAME as r, CARTRIDGES_BASE_DIR as t };

package/dist/configs/react-router.config.js

@@ -5,6 +5,7 @@
 * Users cannot override these values - they will be validated and an error will be thrown if modified.
 */
 function storefrontNextPreset() {
+	const sfwFalconInstance = process.env.SFW_FALCON_INSTANCE;
 	const presetConfig = {
 		appDirectory: "./src",
 		buildDirectory: "build",
@@ -14,7 +15,8 @@ function storefrontNextPreset() {
 		future: {
 			v8_middleware: true,
 			v8_viteEnvironmentApi: true
-		}
+		},
+		...sfwFalconInstance && { allowedActionOrigins: [`*.dataplane.cvw-dataplane-test.${sfwFalconInstance}.aws.sfdc.cl`] }
 	};
 	return {
 		name: "storefront-next-preset",

package/dist/configs/react-router.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-router.config.js","names":["errors: string[]"],"sources":["../../src/configs/react-router.config.ts"],"sourcesContent":["/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport type { Preset } from '@react-router/dev/config';\n\n/**\n * Storefront Next preset for React Router configuration.\n * This preset enforces standard configuration for SFCC Storefront Next applications.\n * Users cannot override these values - they will be validated and an error will be thrown if modified.\n */\nexport function storefrontNextPreset(): Preset {\n    const presetConfig = {\n        appDirectory: './src',\n        buildDirectory: 'build',\n        routeDiscovery: { mode: 'initial' as const },\n        serverModuleFormat: 'cjs' as const,\n        ssr: true,\n        future: {\n            v8_middleware: true,\n            v8_viteEnvironmentApi: true,\n        },\n    };\n\n    return {\n        name: 'storefront-next-preset',\n        reactRouterConfig: () => presetConfig,\n        reactRouterConfigResolved: ({ reactRouterConfig }) => {\n            // Validate that critical config values have not been overridden\n            // Note: We don't validate appDirectory and buildDirectory because they get resolved\n            // to absolute paths and we can't reliably determine the correct absolute path\n            const errors: string[] = [];\n\n            if (reactRouterConfig.routeDiscovery?.mode !== presetConfig.routeDiscovery.mode) {\n                errors.push(\n                    `routeDiscovery.mode: expected \"${presetConfig.routeDiscovery.mode}\", got \"${reactRouterConfig.routeDiscovery?.mode}\"`\n                );\n            }\n\n            if (reactRouterConfig.serverModuleFormat !== presetConfig.serverModuleFormat) {\n                errors.push(\n                    `serverModuleFormat: expected \"${presetConfig.serverModuleFormat}\", got \"${reactRouterConfig.serverModuleFormat}\"`\n                );\n            }\n\n            if (reactRouterConfig.ssr !== presetConfig.ssr) {\n                errors.push(`ssr: expected ${presetConfig.ssr}, got ${reactRouterConfig.ssr}`);\n            }\n\n            if (reactRouterConfig.future?.v8_middleware !== presetConfig.future.v8_middleware) {\n                errors.push(\n                    `future.v8_middleware: expected ${presetConfig.future.v8_middleware}, got ${reactRouterConfig.future?.v8_middleware}`\n                );\n            }\n\n            if (reactRouterConfig.future?.v8_viteEnvironmentApi !== presetConfig.future.v8_viteEnvironmentApi) {\n                errors.push(\n                    `future.v8_viteEnvironmentApi: expected ${presetConfig.future.v8_viteEnvironmentApi}, got ${reactRouterConfig.future?.v8_viteEnvironmentApi}`\n                );\n            }\n\n            if (errors.length > 0) {\n                throw new Error(\n                    `Storefront Next preset configuration was overridden. The following values must not be modified:\\n${errors.map((e) => `  - ${e}`).join('\\n')}`\n                );\n            }\n        },\n    };\n}\n"],"mappings":";;;;;;AAsBA,SAAgB,uBAA+B;CAC3C,MAAM,eAAe;EACjB,cAAc;EACd,gBAAgB;EAChB,gBAAgB,EAAE,MAAM,WAAoB;EAC5C,oBAAoB;EACpB,KAAK;EACL,QAAQ;GACJ,eAAe;GACf,uBAAuB;GAC1B;EACJ;AAED,QAAO;EACH,MAAM;EACN,yBAAyB;EACzB,4BAA4B,EAAE,wBAAwB;GAIlD,MAAMA,SAAmB,EAAE;AAE3B,OAAI,kBAAkB,gBAAgB,SAAS,aAAa,eAAe,KACvE,QAAO,KACH,kCAAkC,aAAa,eAAe,KAAK,UAAU,kBAAkB,gBAAgB,KAAK,GACvH;AAGL,OAAI,kBAAkB,uBAAuB,aAAa,mBACtD,QAAO,KACH,iCAAiC,aAAa,mBAAmB,UAAU,kBAAkB,mBAAmB,GACnH;AAGL,OAAI,kBAAkB,QAAQ,aAAa,IACvC,QAAO,KAAK,iBAAiB,aAAa,IAAI,QAAQ,kBAAkB,MAAM;AAGlF,OAAI,kBAAkB,QAAQ,kBAAkB,aAAa,OAAO,cAChE,QAAO,KACH,kCAAkC,aAAa,OAAO,cAAc,QAAQ,kBAAkB,QAAQ,gBACzG;AAGL,OAAI,kBAAkB,QAAQ,0BAA0B,aAAa,OAAO,sBACxE,QAAO,KACH,0CAA0C,aAAa,OAAO,sBAAsB,QAAQ,kBAAkB,QAAQ,wBACzH;AAGL,OAAI,OAAO,SAAS,EAChB,OAAM,IAAI,MACN,oGAAoG,OAAO,KAAK,MAAM,OAAO,IAAI,CAAC,KAAK,KAAK,GAC/I;;EAGZ"}
+{"version":3,"file":"react-router.config.js","names":["errors: string[]"],"sources":["../../src/configs/react-router.config.ts"],"sourcesContent":["/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport type { Preset } from '@react-router/dev/config';\n\n/**\n * Storefront Next preset for React Router configuration.\n * This preset enforces standard configuration for SFCC Storefront Next applications.\n * Users cannot override these values - they will be validated and an error will be thrown if modified.\n */\nexport function storefrontNextPreset(): Preset {\n    const sfwFalconInstance = process.env.SFW_FALCON_INSTANCE;\n\n    const presetConfig = {\n        appDirectory: './src',\n        buildDirectory: 'build',\n        routeDiscovery: { mode: 'initial' as const },\n        serverModuleFormat: 'cjs' as const,\n        ssr: true,\n        future: {\n            v8_middleware: true,\n            v8_viteEnvironmentApi: true,\n        },\n        // Allow workspace proxy domain for CSRF protection on form actions\n        ...(sfwFalconInstance && {\n            allowedActionOrigins: [`*.dataplane.cvw-dataplane-test.${sfwFalconInstance}.aws.sfdc.cl`],\n        }),\n    };\n\n    return {\n        name: 'storefront-next-preset',\n        reactRouterConfig: () => presetConfig,\n        reactRouterConfigResolved: ({ reactRouterConfig }) => {\n            // Validate that critical config values have not been overridden\n            // Note: We don't validate appDirectory and buildDirectory because they get resolved\n            // to absolute paths and we can't reliably determine the correct absolute path\n            const errors: string[] = [];\n\n            if (reactRouterConfig.routeDiscovery?.mode !== presetConfig.routeDiscovery.mode) {\n                errors.push(\n                    `routeDiscovery.mode: expected \"${presetConfig.routeDiscovery.mode}\", got \"${reactRouterConfig.routeDiscovery?.mode}\"`\n                );\n            }\n\n            if (reactRouterConfig.serverModuleFormat !== presetConfig.serverModuleFormat) {\n                errors.push(\n                    `serverModuleFormat: expected \"${presetConfig.serverModuleFormat}\", got \"${reactRouterConfig.serverModuleFormat}\"`\n                );\n            }\n\n            if (reactRouterConfig.ssr !== presetConfig.ssr) {\n                errors.push(`ssr: expected ${presetConfig.ssr}, got ${reactRouterConfig.ssr}`);\n            }\n\n            if (reactRouterConfig.future?.v8_middleware !== presetConfig.future.v8_middleware) {\n                errors.push(\n                    `future.v8_middleware: expected ${presetConfig.future.v8_middleware}, got ${reactRouterConfig.future?.v8_middleware}`\n                );\n            }\n\n            if (reactRouterConfig.future?.v8_viteEnvironmentApi !== presetConfig.future.v8_viteEnvironmentApi) {\n                errors.push(\n                    `future.v8_viteEnvironmentApi: expected ${presetConfig.future.v8_viteEnvironmentApi}, got ${reactRouterConfig.future?.v8_viteEnvironmentApi}`\n                );\n            }\n\n            if (errors.length > 0) {\n                throw new Error(\n                    `Storefront Next preset configuration was overridden. The following values must not be modified:\\n${errors.map((e) => `  - ${e}`).join('\\n')}`\n                );\n            }\n        },\n    };\n}\n"],"mappings":";;;;;;AAsBA,SAAgB,uBAA+B;CAC3C,MAAM,oBAAoB,QAAQ,IAAI;CAEtC,MAAM,eAAe;EACjB,cAAc;EACd,gBAAgB;EAChB,gBAAgB,EAAE,MAAM,WAAoB;EAC5C,oBAAoB;EACpB,KAAK;EACL,QAAQ;GACJ,eAAe;GACf,uBAAuB;GAC1B;EAED,GAAI,qBAAqB,EACrB,sBAAsB,CAAC,kCAAkC,kBAAkB,cAAc,EAC5F;EACJ;AAED,QAAO;EACH,MAAM;EACN,yBAAyB;EACzB,4BAA4B,EAAE,wBAAwB;GAIlD,MAAMA,SAAmB,EAAE;AAE3B,OAAI,kBAAkB,gBAAgB,SAAS,aAAa,eAAe,KACvE,QAAO,KACH,kCAAkC,aAAa,eAAe,KAAK,UAAU,kBAAkB,gBAAgB,KAAK,GACvH;AAGL,OAAI,kBAAkB,uBAAuB,aAAa,mBACtD,QAAO,KACH,iCAAiC,aAAa,mBAAmB,UAAU,kBAAkB,mBAAmB,GACnH;AAGL,OAAI,kBAAkB,QAAQ,aAAa,IACvC,QAAO,KAAK,iBAAiB,aAAa,IAAI,QAAQ,kBAAkB,MAAM;AAGlF,OAAI,kBAAkB,QAAQ,kBAAkB,aAAa,OAAO,cAChE,QAAO,KACH,kCAAkC,aAAa,OAAO,cAAc,QAAQ,kBAAkB,QAAQ,gBACzG;AAGL,OAAI,kBAAkB,QAAQ,0BAA0B,aAAa,OAAO,sBACxE,QAAO,KACH,0CAA0C,aAAa,OAAO,sBAAsB,QAAQ,kBAAkB,QAAQ,wBACzH;AAGL,OAAI,OAAO,SAAS,EAChB,OAAM,IAAI,MACN,oGAAoG,OAAO,KAAK,MAAM,OAAO,IAAI,CAAC,KAAK,KAAK,GAC/I;;EAGZ"}

package/dist/dependency-utils.js

@@ -0,0 +1,314 @@
+import path from "path";
+import fs from "fs";
+
+//#region src/extensibility/path-util.ts
+const FILE_EXTENSIONS = [
+	".tsx",
+	".ts",
+	".d.ts"
+];
+function isSupportedFileExtension(fileName) {
+	return FILE_EXTENSIONS.some((ext) => fileName.endsWith(ext));
+}
+
+//#endregion
+//#region src/extensibility/trim-extensions.ts
+const SINGLE_LINE_MARKER = "@sfdc-extension-line";
+const BLOCK_MARKER_START = "@sfdc-extension-block-start";
+const BLOCK_MARKER_END = "@sfdc-extension-block-end";
+const FILE_MARKER = "@sfdc-extension-file";
+let verbose = false;
+function trimExtensions(directory, selectedExtensions, extensionConfig, verboseOverride = false) {
+	const startTime = Date.now();
+	verbose = verboseOverride ?? false;
+	const configuredExtensions = extensionConfig?.extensions || {};
+	const extensions = {};
+	Object.keys(configuredExtensions).forEach((targetKey) => {
+		extensions[targetKey] = Boolean(selectedExtensions?.[targetKey]) || false;
+	});
+	if (Object.keys(extensions).length === 0) {
+		if (verbose) console.log("No targets found, skipping trim");
+		return;
+	}
+	const processDirectory = (dir) => {
+		fs.readdirSync(dir).forEach((file) => {
+			const filePath = path.join(dir, file);
+			const stats = fs.statSync(filePath);
+			if (!filePath.includes("node_modules")) {
+				if (stats.isDirectory()) processDirectory(filePath);
+				else if (isSupportedFileExtension(file)) processFile(filePath, extensions);
+			}
+		});
+	};
+	processDirectory(directory);
+	if (extensionConfig?.extensions) {
+		deleteExtensionFolders(directory, extensions, extensionConfig);
+		updateExtensionConfig(directory, extensions);
+	}
+	const endTime = Date.now();
+	if (verbose) console.log(`Trim extensions took ${endTime - startTime}ms`);
+}
+/**
+* Update the extension config file to only include the selected extensions.
+* @param projectDirectory - The project directory
+* @param extensionSelections - The selected extensions
+*/
+function updateExtensionConfig(projectDirectory, extensionSelections) {
+	const extensionConfigPath = path.join(projectDirectory, "src", "extensions", "config.json");
+	const extensionConfig = JSON.parse(fs.readFileSync(extensionConfigPath, "utf8"));
+	Object.keys(extensionConfig.extensions).forEach((extensionKey) => {
+		if (!extensionSelections[extensionKey]) delete extensionConfig.extensions[extensionKey];
+	});
+	fs.writeFileSync(extensionConfigPath, JSON.stringify({ extensions: extensionConfig.extensions }, null, 4), "utf8");
+}
+/**
+* Process a file to trim extension-specific code based on markers.
+* @param filePath - The file path to process
+* @param extensions - The extension selections
+*/
+function processFile(filePath, extensions) {
+	const source = fs.readFileSync(filePath, "utf-8");
+	if (source.includes(FILE_MARKER)) {
+		const markerLine = source.split("\n").find((line) => line.includes(FILE_MARKER));
+		const extMatch = Object.keys(extensions).find((ext) => markerLine.includes(ext));
+		if (!extMatch) {
+			if (verbose) console.warn(`File ${filePath} is marked with ${markerLine} but it does not match any known extensions`);
+		} else if (extensions[extMatch] === false) {
+			try {
+				fs.unlinkSync(filePath);
+				if (verbose) console.log(`Deleted file ${filePath}`);
+			} catch (e) {
+				const error = e;
+				console.error(`Error deleting file ${filePath}: ${error.message}`);
+				throw e;
+			}
+			return;
+		}
+	}
+	const extKeys = Object.keys(extensions);
+	if (new RegExp(extKeys.join("|"), "g").test(source)) {
+		const lines = source.split("\n");
+		const newLines = [];
+		const blockMarkers = [];
+		let skippingBlock = false;
+		let i = 0;
+		while (i < lines.length) {
+			const line = lines[i];
+			if (line.includes(SINGLE_LINE_MARKER)) {
+				const matchingExtension = Object.keys(extensions).find((extension) => line.includes(extension));
+				if (matchingExtension && extensions[matchingExtension] === false) {
+					i += 2;
+					continue;
+				}
+			} else if (line.includes(BLOCK_MARKER_START)) {
+				const matchingExtension = Object.keys(extensions).find((extension) => line.includes(extension));
+				if (matchingExtension) {
+					blockMarkers.push({
+						extension: matchingExtension,
+						line: i
+					});
+					skippingBlock = extensions[matchingExtension] === false;
+				} else if (verbose) console.warn(`Warning: Unknown marker found in ${filePath} at line ${i}: \n${line}`);
+			} else if (line.includes(BLOCK_MARKER_END)) {
+				if (Object.keys(extensions).find((extension) => line.includes(extension))) {
+					const extension = Object.keys(extensions).find((p) => line.includes(p));
+					if (blockMarkers.length === 0) throw new Error(`Block marker mismatch in ${filePath}, encountered end marker ${extension} without a matching start marker at line ${i}:\n${lines[i]}`);
+					const startMarker = blockMarkers.pop();
+					if (!extension || startMarker.extension !== extension) throw new Error(`Block marker mismatch in ${filePath}, expected end marker for ${startMarker.extension} but got ${extension} at line ${i}:\n${lines[i]}`);
+					if (extensions[extension] === false) {
+						skippingBlock = false;
+						i++;
+						continue;
+					}
+				}
+			}
+			if (!skippingBlock) newLines.push(line);
+			i++;
+		}
+		if (blockMarkers.length > 0) throw new Error(`Unclosed end marker found in ${filePath}: ${blockMarkers[blockMarkers.length - 1].extension}`);
+		const newSource = newLines.join("\n");
+		if (newSource !== source) try {
+			fs.writeFileSync(filePath, newSource);
+			if (verbose) console.log(`Updated file ${filePath}`);
+		} catch (e) {
+			const error = e;
+			console.error(`Error updating file ${filePath}: ${error.message}`);
+			throw e;
+		}
+	}
+}
+/**
+* Delete extension folders for disabled extensions.
+* @param projectRoot - The project root directory
+* @param extensions - The extension selections
+* @param extensionConfig - The extension configuration
+*/
+function deleteExtensionFolders(projectRoot, extensions, extensionConfig) {
+	const extensionsDir = path.join(projectRoot, "src", "extensions");
+	if (!fs.existsSync(extensionsDir)) return;
+	const configuredExtensions = extensionConfig.extensions;
+	Object.keys(extensions).filter((ext) => extensions[ext] === false).forEach((extKey) => {
+		const extensionMeta = configuredExtensions[extKey];
+		if (extensionMeta?.folder) {
+			const extensionFolderPath = path.join(extensionsDir, extensionMeta.folder);
+			if (fs.existsSync(extensionFolderPath)) try {
+				fs.rmSync(extensionFolderPath, {
+					recursive: true,
+					force: true
+				});
+				if (verbose) console.log(`Deleted extension folder: ${extensionFolderPath}`);
+			} catch (err) {
+				const error = err;
+				if (error.code === "EPERM") console.error(`Permission denied - cannot delete ${extensionFolderPath}. You may need to run with sudo or check permissions.`);
+				else console.error(`Error deleting ${extensionFolderPath}: ${error.message}`);
+			}
+		}
+	});
+}
+
+//#endregion
+//#region src/extensibility/dependency-utils.ts
+/**
+* Resolve full transitive dependency chain in topological order (dependencies first).
+* Example: resolveDependencies('BOPIS', config) → ['Store Locator', 'BOPIS']
+*
+* @param extensionKey - The extension key to resolve dependencies for
+* @param config - The extension configuration
+* @returns Array of extension keys in topological order (dependencies first, then the extension itself)
+*/
+function resolveDependencies(extensionKey, config) {
+	const visited = /* @__PURE__ */ new Set();
+	const result = [];
+	function visit(key) {
+		if (visited.has(key)) return;
+		visited.add(key);
+		const extension = config.extensions[key];
+		if (!extension) return;
+		const dependencies = extension.dependencies || [];
+		for (const dep of dependencies) visit(dep);
+		result.push(key);
+	}
+	visit(extensionKey);
+	return result;
+}
+/**
+* Reverse lookup: find immediate extensions that depend on this one.
+* Example: getDependents('Store Locator', config) → ['BOPIS']
+*
+* @param extensionKey - The extension key to find dependents for
+* @param config - The extension configuration
+* @returns Array of extension keys that directly depend on this extension
+*/
+function getDependents(extensionKey, config) {
+	const dependents = [];
+	for (const [key, extension] of Object.entries(config.extensions)) if ((extension.dependencies || []).includes(extensionKey)) dependents.push(key);
+	return dependents;
+}
+/**
+* Resolve full transitive dependent chain in reverse topological order (dependents first).
+* Example: resolveDependents('Store Locator', config) → ['BOPIS', 'Store Locator']
+*
+* @param extensionKey - The extension key to resolve dependents for
+* @param config - The extension configuration
+* @returns Array of extension keys in reverse topological order (dependents first, then the extension itself)
+*/
+function resolveDependents(extensionKey, config) {
+	const visited = /* @__PURE__ */ new Set();
+	const result = [];
+	function visit(key) {
+		if (visited.has(key)) return;
+		visited.add(key);
+		const dependents = getDependents(key, config);
+		for (const dep of dependents) visit(dep);
+		result.push(key);
+	}
+	visit(extensionKey);
+	return result;
+}
+/**
+* Validate that no circular dependencies exist in the configuration.
+* Throws a descriptive error if a cycle is found.
+*
+* @param config - The extension configuration to validate
+* @throws Error if a circular dependency is detected
+*/
+function validateNoCycles(config) {
+	const visiting = /* @__PURE__ */ new Set();
+	const visited = /* @__PURE__ */ new Set();
+	function visit(key, path$1) {
+		if (visited.has(key)) return;
+		if (visiting.has(key)) {
+			const cycleStart = path$1.indexOf(key);
+			const cyclePath = [...path$1.slice(cycleStart), key];
+			throw new Error(`Circular dependency detected: ${cyclePath.join(" -> ")}`);
+		}
+		visiting.add(key);
+		path$1.push(key);
+		const extension = config.extensions[key];
+		if (extension) {
+			const dependencies = extension.dependencies || [];
+			for (const dep of dependencies) visit(dep, path$1);
+		}
+		path$1.pop();
+		visiting.delete(key);
+		visited.add(key);
+	}
+	for (const key of Object.keys(config.extensions)) visit(key, []);
+}
+/**
+* Filter resolved dependencies to only those not yet installed.
+* Returns dependencies in topological order (install order).
+*
+* @param extensionKey - The extension key to check dependencies for
+* @param installedExtensions - Array of already installed extension keys
+* @param config - The extension configuration
+* @returns Array of missing extension keys in topological order (install order)
+*/
+function getMissingDependencies(extensionKey, installedExtensions, config) {
+	const allDependencies = resolveDependencies(extensionKey, config);
+	const installedSet = new Set(installedExtensions);
+	return allDependencies.filter((key) => !installedSet.has(key));
+}
+/**
+* Resolve dependencies for multiple extensions, merging and deduplicating the results.
+* Returns all dependencies in topological order.
+*
+* @param extensionKeys - Array of extension keys to resolve dependencies for
+* @param config - The extension configuration
+* @returns Array of all extension keys in topological order (dependencies first)
+*/
+function resolveDependenciesForMultiple(extensionKeys, config) {
+	const allDeps = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const key of extensionKeys) {
+		const deps = resolveDependencies(key, config);
+		for (const dep of deps) if (!allDeps.has(dep)) {
+			allDeps.add(dep);
+			result.push(dep);
+		}
+	}
+	return result;
+}
+/**
+* Resolve dependents for multiple extensions, merging and deduplicating the results.
+* Returns all dependents in reverse topological order (uninstall order).
+*
+* @param extensionKeys - Array of extension keys to resolve dependents for
+* @param config - The extension configuration
+* @returns Array of all extension keys in reverse topological order (dependents first)
+*/
+function resolveDependentsForMultiple(extensionKeys, config) {
+	const allDeps = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const key of extensionKeys) {
+		const deps = resolveDependents(key, config);
+		for (const dep of deps) if (!allDeps.has(dep)) {
+			allDeps.add(dep);
+			result.push(dep);
+		}
+	}
+	return result;
+}
+
+//#endregion
+export { trimExtensions as a, validateNoCycles as i, resolveDependenciesForMultiple as n, resolveDependentsForMultiple as r, getMissingDependencies as t };

package/dist/entry/client.d.ts

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