@salesforce/storefront-next-dev 0.3.1 → 0.4.0-alpha.0

package/dist/commands/scapi/add.js

@@ -0,0 +1,298 @@
+import { i as writeSchemaMetadata, n as deriveClientKey, t as deriveBasePath } from "../../schema-utils.js";
+import { t as generateCustomClientsFile } from "../../generate-custom-clients.js";
+import { Args, Flags } from "@oclif/core";
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, dirname, extname, join, relative, resolve } from "node:path";
+import { OAuthCommand } from "@salesforce/b2c-tooling-sdk/cli";
+import { createScapiSchemasClient, toOrganizationId } from "@salesforce/b2c-tooling-sdk/clients";
+import YAML from "yaml";
+
+//#region src/scapi/generate-operation-map.ts
+/**
+* Extract operation mappings from a generated TypeScript file.
+*
+* Parses the `paths` interface to find path strings, HTTP methods,
+* and operation references (e.g., operations["getCategories"]).
+*/
+function extractOperationMap(filePath) {
+	const content = readFileSync(filePath, "utf-8");
+	const operations = {};
+	const lines = content.split("\n");
+	let currentPath = null;
+	const validMethods = [
+		"get",
+		"post",
+		"put",
+		"patch",
+		"delete",
+		"head",
+		"options"
+	];
+	let insidePathsInterface = false;
+	for (const line of lines) {
+		if (line.match(/^export interface paths \{/)) {
+			insidePathsInterface = true;
+			continue;
+		}
+		if (insidePathsInterface && line.match(/^\}$/)) break;
+		if (!insidePathsInterface) continue;
+		const pathMatch = line.match(/^\s+"([^"]+)":\s*\{/);
+		if (pathMatch) {
+			currentPath = pathMatch[1];
+			continue;
+		}
+		const operationMatch = line.match(/^\s+(\w+):\s*operations\["([^"]+)"\];?/);
+		if (operationMatch && currentPath) {
+			const [, method, operationName] = operationMatch;
+			if (validMethods.includes(method.toLowerCase())) operations[operationName] = {
+				method: method.toUpperCase(),
+				path: currentPath
+			};
+		}
+		if (currentPath && line.match(/^\s{4}\};?\s*$/)) currentPath = null;
+	}
+	return operations;
+}
+/**
+* Find the longest common prefix for all paths.
+*/
+function findCommonBasePath(operations) {
+	const paths = Object.values(operations).map((op) => op.path);
+	if (paths.length === 0) return "";
+	if (paths.length === 1) {
+		const lastSlashIndex = paths[0].lastIndexOf("/");
+		return lastSlashIndex > 0 ? paths[0].substring(0, lastSlashIndex) : "";
+	}
+	let prefix = paths[0];
+	for (let i = 1; i < paths.length; i++) {
+		const current = paths[i];
+		let j = 0;
+		while (j < prefix.length && j < current.length && prefix[j] === current[j]) j++;
+		prefix = prefix.substring(0, j);
+		if (prefix.length === 0) return "";
+	}
+	const trimmed = prefix.replace(/\/+$/, "");
+	if (!trimmed || !trimmed.includes("/")) return "";
+	return trimmed;
+}
+/**
+* Convert an operation map to optimized format with abbreviated keys.
+*/
+function convertToOptimizedOperations(operations, basePath) {
+	const optimizedOperations = {};
+	for (const [name, { method, path: opPath }] of Object.entries(operations)) optimizedOperations[name] = {
+		m: method,
+		b: basePath,
+		s: opPath.startsWith(basePath) ? opPath.substring(basePath.length) : opPath
+	};
+	return optimizedOperations;
+}
+/**
+* Generate an operation map file from a generated TypeScript types file.
+*
+* @param inputFile - Path to the openapi-typescript generated .ts file
+* @param outputFile - Path for the output .operations.ts file (defaults to same dir as input)
+* @returns The output file path
+*/
+function generateOperationFile(inputFile, outputFile) {
+	const operations = extractOperationMap(inputFile);
+	const baseName = basename(inputFile, ".ts");
+	if (!outputFile) outputFile = join(dirname(inputFile), `${baseName}.operations.ts`);
+	if (Object.keys(operations).length === 0) throw new Error(`No operations found in ${baseName}.ts`);
+	const basePath = findCommonBasePath(operations);
+	const optimizedOps = convertToOptimizedOperations(operations, basePath);
+	const output = `/**
+ * Auto-generated operation map for ${baseName}
+ *
+ * Generated by sfnext scapi — do not edit manually.
+ *
+ * Property abbreviations:
+ * - m: HTTP method (GET, POST, PUT, PATCH, DELETE, etc.)
+ * - b: Base path shared across operations
+ * - s: Suffix path unique to this operation
+ */
+
+export const BASE_PATH = '${basePath}' as const;
+
+export const operations = {
+${Object.entries(optimizedOps).map(([name, { m, s }]) => `  ${name}: { m: '${m}' as const, b: BASE_PATH, s: '${s}' }`).join(",\n")}
+} as const;
+`;
+	writeFileSync(outputFile, output, "utf-8");
+	return outputFile;
+}
+
+//#endregion
+//#region src/scapi/generate-types.ts
+/**
+* Generate TypeScript types and operation map from an OpenAPI schema file.
+*
+* @param schemaPath - Absolute path to the OAS YAML/JSON schema
+* @param outputDir - Directory where generated files will be written
+* @param baseName - Base name for the generated files (e.g., "shopper-products-v1")
+* @returns Object with paths to the generated types and operations files
+*/
+async function generateFromSchema(schemaPath, outputDir, baseName) {
+	const openapiTS = await import("openapi-typescript");
+	const schemaUrl = new URL(`file://${schemaPath}`);
+	const ast = await openapiTS.default(schemaUrl);
+	const output = openapiTS.astToString(ast);
+	mkdirSync(outputDir, { recursive: true });
+	const typesFile = join(outputDir, `${baseName}.ts`);
+	writeFileSync(typesFile, output, "utf-8");
+	return {
+		typesFile,
+		operationsFile: generateOperationFile(typesFile)
+	};
+}
+
+//#endregion
+//#region src/commands/scapi/add.ts
+/**
+* Add a custom SCAPI client.
+*
+* Supports two modes:
+* 1. **Local schema**: Provide `--schema` to generate from a local OpenAPI schema file.
+* 2. **Pull from API**: Provide positional args `<apiFamily> <apiName> <apiVersion>` to
+*    fetch the schema from the SCAPI Schemas API (requires OAuth credentials).
+*
+* @example
+* ```bash
+* # From a local schema file
+* sfnext scapi add --schema ./my-schemas/loyalty-api.yaml --name loyalty --base-path /custom/loyalty/v1
+*
+* # Pull from the SCAPI Schemas API
+* sfnext scapi add custom loyalty v1
+* ```
+*
+* @env SFCC_SHORTCODE - SCAPI short code (for API pull mode)
+* @env SFCC_TENANT_ID - Tenant ID (for API pull mode)
+* @env SFCC_OAUTH_CLIENT_ID - OAuth client ID (for API pull mode)
+* @env SFCC_OAUTH_CLIENT_SECRET - OAuth client secret (for API pull mode)
+*/
+var Add = class Add extends OAuthCommand {
+	static description = "Add a custom SCAPI client from a local schema or the SCAPI Schemas API";
+	static examples = [
+		"<%= config.bin %> <%= command.id %> --schema ./custom-api.yaml --name myCustomApi --base-path /custom/my-api/v1",
+		"<%= config.bin %> <%= command.id %> custom loyalty v1",
+		"<%= config.bin %> <%= command.id %> custom loyalty v1 --expand-custom-properties"
+	];
+	static args = {
+		apiFamily: Args.string({
+			description: "API family (e.g., custom) — for pulling from the SCAPI Schemas API",
+			required: false
+		}),
+		apiName: Args.string({
+			description: "API name (e.g., loyalty, store-inventory)",
+			required: false
+		}),
+		apiVersion: Args.string({
+			description: "API version (e.g., v1)",
+			required: false
+		})
+	};
+	static flags = {
+		...OAuthCommand.baseFlags,
+		schema: Flags.string({
+			description: "Path to a local OpenAPI schema file (YAML or JSON)",
+			exclusive: ["expand-custom-properties"]
+		}),
+		name: Flags.string({ description: "Client key name (e.g., \"loyalty\", \"storeInventory\"). Defaults to camelCase of apiName when pulling." }),
+		"base-path": Flags.string({ description: "SCAPI base path prefix (auto-derived from schema if not provided)" }),
+		"supports-locale": Flags.boolean({
+			description: "Whether this API supports the locale query parameter",
+			allowNo: true
+		}),
+		"expand-custom-properties": Flags.boolean({
+			description: "Include custom properties (c_*) in the schema (API pull only)",
+			default: true,
+			allowNo: true
+		})
+	};
+	async run() {
+		const { args, flags } = await this.parse(Add);
+		const projectDir = flags["project-directory"] ?? process.cwd();
+		const isPull = !flags.schema;
+		if (isPull) {
+			if (!args.apiFamily || !args.apiName || !args.apiVersion) this.error("Provide either --schema for a local file, or <apiFamily> <apiName> <apiVersion> to pull from the API.");
+		}
+		let schemaPath;
+		let schemaName;
+		let clientKey;
+		if (isPull) {
+			const { apiFamily, apiName, apiVersion } = args;
+			clientKey = flags.name ?? deriveClientKey(apiName);
+			const { shortCode, tenantId } = this.resolvedConfig.values;
+			if (!shortCode) this.error("SCAPI short code required. Provide --short-code, set SFCC_SHORTCODE, or configure short-code in dw.json.");
+			if (!tenantId) this.error("tenant-id is required. Provide via --tenant-id flag, SFCC_TENANT_ID env var, or tenant-id in dw.json.");
+			const organizationId = toOrganizationId(tenantId);
+			const oauthStrategy = this.getOAuthStrategy();
+			const client = createScapiSchemasClient({
+				shortCode,
+				tenantId
+			}, oauthStrategy);
+			this.log(`Fetching schema: ${apiFamily}/${apiName}/${apiVersion}...`);
+			const { data, error, response } = await client.GET("/organizations/{organizationId}/schemas/{apiFamily}/{apiName}/{apiVersion}", { params: {
+				path: {
+					organizationId,
+					apiFamily,
+					apiName,
+					apiVersion
+				},
+				query: flags["expand-custom-properties"] ? { expand: "custom_properties" } : {}
+			} });
+			if (error || !data) this.error(`Failed to fetch schema: ${response.status} ${response.statusText}`);
+			const schemasDir = join(join(projectDir, "src", "scapi"), "schemas");
+			mkdirSync(schemasDir, { recursive: true });
+			schemaName = `${apiName}-${apiVersion}`;
+			schemaPath = join(schemasDir, `${schemaName}.yaml`);
+			writeFileSync(schemaPath, YAML.stringify(data), "utf-8");
+			this.log(`Saved schema to ${relative(projectDir, schemaPath)}`);
+		} else {
+			const schemaFlag = flags.schema;
+			if (!schemaFlag) throw new TypeError("Expected --schema when running in local schema mode.");
+			const schemaInput = resolve(projectDir, schemaFlag);
+			if (!existsSync(schemaInput)) this.error(`Schema file not found: ${schemaInput}`);
+			if (!flags.name) this.error("--name is required when using --schema (e.g., --name loyalty)");
+			clientKey = flags.name;
+			const ext = extname(schemaInput);
+			schemaName = basename(schemaInput, ext);
+			const schemasDir = join(join(projectDir, "src", "scapi"), "schemas");
+			mkdirSync(schemasDir, { recursive: true });
+			schemaPath = join(schemasDir, `${schemaName}${ext}`);
+			copyFileSync(schemaInput, schemaPath);
+			this.log(`Copied schema to ${relative(projectDir, schemaPath)}`);
+		}
+		const scapiDir = join(projectDir, "src", "scapi");
+		const generatedDir = join(scapiDir, "generated");
+		mkdirSync(generatedDir, { recursive: true });
+		let basePath = flags["base-path"];
+		if (!basePath) {
+			basePath = deriveBasePath(schemaPath);
+			if (!basePath) if (isPull) {
+				const { apiFamily, apiName, apiVersion } = args;
+				basePath = `/${apiFamily}/${apiName}/${apiVersion}`;
+				this.log(`Constructed base path from API coordinates: ${basePath}`);
+			} else this.error("Could not derive base path from schema. Please provide --base-path explicitly.");
+			else this.log(`Derived base path from schema: ${basePath}`);
+		}
+		const supportsLocale = flags["supports-locale"] ?? false;
+		this.log(`Registering custom client: ${clientKey}`);
+		writeSchemaMetadata(join(scapiDir, "schemas"), schemaName, {
+			clientKey,
+			basePath,
+			supportsLocale,
+			orgPrefix: true
+		});
+		this.log("Generating TypeScript types...");
+		const { typesFile, operationsFile } = await generateFromSchema(schemaPath, generatedDir, schemaName);
+		this.log(`Generated types: ${relative(projectDir, typesFile)}`);
+		this.log(`Generated operations: ${relative(projectDir, operationsFile)}`);
+		generateCustomClientsFile(scapiDir);
+		this.log(`Updated ${relative(projectDir, join(scapiDir, "custom-clients.ts"))}`);
+		this.log(`\nDone! Custom client "${clientKey}" is ready.`);
+	}
+};
+
+//#endregion
+export { Add as default };

package/dist/commands/scapi/list.js

@@ -0,0 +1,35 @@
+import { r as commonFlags } from "../../flags.js";
+import { r as readAllSchemaMetadata } from "../../schema-utils.js";
+import { Command } from "@oclif/core";
+import { join } from "node:path";
+
+//#region src/commands/scapi/list.ts
+/**
+* List registered custom SCAPI clients.
+*/
+var List = class List extends Command {
+	static description = "List registered custom SCAPI clients";
+	static examples = ["<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> -d ./my-project"];
+	static flags = { ...commonFlags };
+	async run() {
+		const { flags } = await this.parse(List);
+		const projectDir = flags["project-directory"];
+		const entries = readAllSchemaMetadata(join(projectDir, "src", "scapi", "schemas"));
+		if (entries.length === 0) {
+			this.log("No custom SCAPI clients registered.");
+			this.log("Use `sfnext scapi add` to add one.");
+			return;
+		}
+		this.log(`\nRegistered SCAPI clients (${entries.length}):\n`);
+		for (const { clientKey, basePath, supportsLocale, schemaName } of entries) {
+			this.log(`  ${clientKey}`);
+			this.log(`    Schema:  schemas/${schemaName}.yaml`);
+			this.log(`    Base:    ${basePath}`);
+			this.log(`    Locale:  ${supportsLocale ? "yes" : "no"}`);
+			this.log("");
+		}
+	}
+};
+
+//#endregion
+export { List as default };

package/dist/commands/scapi/remove.js

@@ -0,0 +1,56 @@
+import { r as commonFlags } from "../../flags.js";
+import { r as readAllSchemaMetadata } from "../../schema-utils.js";
+import { t as generateCustomClientsFile } from "../../generate-custom-clients.js";
+import { Args, Command } from "@oclif/core";
+import { existsSync, unlinkSync } from "node:fs";
+import { join, relative } from "node:path";
+
+//#region src/commands/scapi/remove.ts
+/**
+* Remove a registered custom SCAPI client.
+*/
+var Remove = class Remove extends Command {
+	static description = "Remove a registered custom SCAPI client";
+	static examples = ["<%= config.bin %> <%= command.id %> loyalty", "<%= config.bin %> <%= command.id %> myCustomApi -d ./my-project"];
+	static args = { name: Args.string({
+		description: "Client key name to remove (e.g., \"loyalty\" or \"storeInventory\")",
+		required: true
+	}) };
+	static flags = { ...commonFlags };
+	async run() {
+		const { args, flags } = await this.parse(Remove);
+		const projectDir = flags["project-directory"];
+		const clientKey = args.name;
+		const scapiDir = join(projectDir, "src", "scapi");
+		const schemasDir = join(scapiDir, "schemas");
+		const generatedDir = join(scapiDir, "generated");
+		const entry = readAllSchemaMetadata(schemasDir).find((e) => e.clientKey === clientKey);
+		if (!entry) this.error(`No registered client found with key "${clientKey}". Run \`sfnext scapi list\` to see registered clients.`);
+		const { schemaName } = entry;
+		for (const ext of [
+			".yaml",
+			".yml",
+			".json"
+		]) {
+			const schemaPath = join(schemasDir, `${schemaName}${ext}`);
+			if (existsSync(schemaPath)) {
+				unlinkSync(schemaPath);
+				this.log(`Removed ${relative(projectDir, schemaPath)}`);
+			}
+		}
+		const metaPath = join(schemasDir, `${schemaName}.meta.json`);
+		if (existsSync(metaPath)) unlinkSync(metaPath);
+		const typesPath = join(generatedDir, `${schemaName}.ts`);
+		const opsPath = join(generatedDir, `${schemaName}.operations.ts`);
+		for (const filePath of [typesPath, opsPath]) if (existsSync(filePath)) {
+			unlinkSync(filePath);
+			this.log(`Removed ${relative(projectDir, filePath)}`);
+		}
+		generateCustomClientsFile(scapiDir);
+		this.log(`Updated ${relative(projectDir, join(scapiDir, "custom-clients.ts"))}`);
+		this.log(`\nRemoved client "${clientKey}".`);
+	}
+};
+
+//#endregion
+export { Remove as default };

package/dist/commands/validate-cartridge.js

@@ -1,5 +1,5 @@
 import { i as SFNEXT_BASE_CARTRIDGE_OUTPUT_DIR, t as CARTRIDGES_BASE_DIR } from "../config.js";
-import { t as commonFlags } from "../flags.js";
+import { r as commonFlags } from "../flags.js";
 import { t as validateCartridgeMetadata } from "../validate-cartridge.js";
 import { Command } from "@oclif/core";
 import path from "path";

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

@@ -48,7 +48,8 @@ function storefrontNextPreset() {
 		ssr: true,
 		future: {
 			v8_middleware: true,
-			v8_viteEnvironmentApi: true
+			v8_viteEnvironmentApi: true,
+			unstable_optimizeDeps: true
 		},
 		basename: getBasePath() || "/",
 		...sfwFalconInstance && { allowedActionOrigins: [`*.dataplane.cvw-dataplane-test.${sfwFalconInstance}.aws.sfdc.cl`] }

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

@@ -1 +1 @@
-{"version":3,"file":"react-router.config.js","names":["errors: string[]"],"sources":["../../src/utils/paths.ts","../../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 */\n/**\n * Normalize a file path to use forward slashes.\n * On Windows, Node APIs return backslash-separated paths, but ESM import\n * specifiers and Vite module IDs require forward slashes.\n */\nexport function toPosixPath(filePath: string): string {\n    return filePath.replace(/\\\\/g, '/');\n}\n\n/**\n * Get the Commerce Cloud API URL from a short code\n */\nexport function getCommerceCloudApiUrl(shortCode: string, proxyHost?: string): string {\n    return proxyHost || `https://${shortCode}.api.commercecloud.salesforce.com`;\n}\n\n/**\n * Get the configurable base path for the application.\n * Reads from MRT_ENV_BASE_PATH environment variable.\n *\n * The base path is used for CDN routing to the correct MRT environment.\n * It is prepended to all URLs: page routes, /mobify/bundle/ assets, and /mobify/proxy/api.\n *\n * Validation rules:\n * - Must be a single path segment starting with '/'\n * - Max 63 characters after the leading slash\n * - Only URL-safe characters allowed\n * - Returns empty string if not set\n *\n * @returns The sanitized base path (e.g., '/site-a' or '')\n *\n * @example\n * // No base path configured\n * getBasePath() // → ''\n *\n * // With base path '/storefront'\n * getBasePath() // → '/storefront'\n *\n * // Automatically sanitizes\n * // MRT_ENV_BASE_PATH='storefront/' → '/storefront'\n */\nexport function getBasePath(): string {\n    const basePath = process.env.MRT_ENV_BASE_PATH?.trim();\n\n    // Return empty string if not set or empty\n    if (!basePath) {\n        return '';\n    }\n\n    // Base path prefix must be a single path segment starting with '/', max 63 chars,\n    // using only URL-safe characters (alphanumeric, hyphens, underscores, dots, and other safe symbols)\n    // This aligns with the regex used by MRT\n    if (!/^\\/[a-zA-Z0-9_.+$~\"'@:-]{1,63}$/.test(basePath)) {\n        throw new Error(\n            `Invalid base path: \"${basePath}\". ` +\n                \"Base path must be a single segment starting with '/' (e.g., '/site-a'), \" +\n                'contain only URL-safe characters, and be at most 63 characters after the leading slash.'\n        );\n    }\n\n    return basePath;\n}\n\n/**\n * Get the bundle path for static assets\n */\nexport function getBundlePath(bundleId: string): string {\n    const basePath = getBasePath();\n    return `${basePath}/mobify/bundle/${bundleId}/client/`;\n}\n","/**\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';\nimport { getBasePath } from '../utils/paths';\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    // Read base path from env var for basename configuration\n    // This sets the base path for all React Router routes (e.g., '/site-a')\n    // In dev: reads from .env at build time\n    // In production: baked into the build, but can be overridden at runtime via patchReactRouterBuild\n    const basePath = getBasePath();\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        // Set basename from base path for CDN routing\n        // When set, all routes are served under this base path (e.g., /site-a/category/womens)\n        // React Router automatically handles Link, navigate, .data requests, and redirects\n        basename: basePath || '/',\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 (reactRouterConfig.basename !== presetConfig.basename) {\n                errors.push(`basename: expected ${presetConfig.basename}, got ${reactRouterConfig.basename}`);\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":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,cAAsB;CAClC,MAAM,WAAW,QAAQ,IAAI,mBAAmB,MAAM;AAGtD,KAAI,CAAC,SACD,QAAO;AAMX,KAAI,CAAC,kCAAkC,KAAK,SAAS,CACjD,OAAM,IAAI,MACN,uBAAuB,SAAS,oKAGnC;AAGL,QAAO;;;;;;;;;;ACpDX,SAAgB,uBAA+B;CAC3C,MAAM,oBAAoB,QAAQ,IAAI;CAQtC,MAAM,eAAe;EACjB,cAAc;EACd,gBAAgB;EAChB,gBAAgB,EAAE,MAAM,WAAoB;EAC5C,oBAAoB;EACpB,KAAK;EACL,QAAQ;GACJ,eAAe;GACf,uBAAuB;GAC1B;EAID,UAfa,aAAa,IAeJ;EAEtB,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,kBAAkB,aAAa,aAAa,SAC5C,QAAO,KAAK,sBAAsB,aAAa,SAAS,QAAQ,kBAAkB,WAAW;AAGjG,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/utils/paths.ts","../../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 */\n/**\n * Normalize a file path to use forward slashes.\n * On Windows, Node APIs return backslash-separated paths, but ESM import\n * specifiers and Vite module IDs require forward slashes.\n */\nexport function toPosixPath(filePath: string): string {\n    return filePath.replace(/\\\\/g, '/');\n}\n\n/**\n * Get the Commerce Cloud API URL from a short code\n */\nexport function getCommerceCloudApiUrl(shortCode: string, proxyHost?: string): string {\n    return proxyHost || `https://${shortCode}.api.commercecloud.salesforce.com`;\n}\n\n/**\n * Get the configurable base path for the application.\n * Reads from MRT_ENV_BASE_PATH environment variable.\n *\n * The base path is used for CDN routing to the correct MRT environment.\n * It is prepended to all URLs: page routes, /mobify/bundle/ assets, and /mobify/proxy/api.\n *\n * Validation rules:\n * - Must be a single path segment starting with '/'\n * - Max 63 characters after the leading slash\n * - Only URL-safe characters allowed\n * - Returns empty string if not set\n *\n * @returns The sanitized base path (e.g., '/site-a' or '')\n *\n * @example\n * // No base path configured\n * getBasePath() // → ''\n *\n * // With base path '/storefront'\n * getBasePath() // → '/storefront'\n *\n * // Automatically sanitizes\n * // MRT_ENV_BASE_PATH='storefront/' → '/storefront'\n */\nexport function getBasePath(): string {\n    const basePath = process.env.MRT_ENV_BASE_PATH?.trim();\n\n    // Return empty string if not set or empty\n    if (!basePath) {\n        return '';\n    }\n\n    // Base path prefix must be a single path segment starting with '/', max 63 chars,\n    // using only URL-safe characters (alphanumeric, hyphens, underscores, dots, and other safe symbols)\n    // This aligns with the regex used by MRT\n    if (!/^\\/[a-zA-Z0-9_.+$~\"'@:-]{1,63}$/.test(basePath)) {\n        throw new Error(\n            `Invalid base path: \"${basePath}\". ` +\n                \"Base path must be a single segment starting with '/' (e.g., '/site-a'), \" +\n                'contain only URL-safe characters, and be at most 63 characters after the leading slash.'\n        );\n    }\n\n    return basePath;\n}\n\n/**\n * Get the bundle path for static assets\n */\nexport function getBundlePath(bundleId: string): string {\n    const basePath = getBasePath();\n    return `${basePath}/mobify/bundle/${bundleId}/client/`;\n}\n","/**\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';\nimport { getBasePath } from '../utils/paths';\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    // Read base path from env var for basename configuration\n    // This sets the base path for all React Router routes (e.g., '/site-a')\n    // In dev: reads from .env at build time\n    // In production: baked into the build, but can be overridden at runtime via patchReactRouterBuild\n    const basePath = getBasePath();\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            unstable_optimizeDeps: true,\n        },\n        // Set basename from base path for CDN routing\n        // When set, all routes are served under this base path (e.g., /site-a/category/womens)\n        // React Router automatically handles Link, navigate, .data requests, and redirects\n        basename: basePath || '/',\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 (reactRouterConfig.basename !== presetConfig.basename) {\n                errors.push(`basename: expected ${presetConfig.basename}, got ${reactRouterConfig.basename}`);\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":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,cAAsB;CAClC,MAAM,WAAW,QAAQ,IAAI,mBAAmB,MAAM;AAGtD,KAAI,CAAC,SACD,QAAO;AAMX,KAAI,CAAC,kCAAkC,KAAK,SAAS,CACjD,OAAM,IAAI,MACN,uBAAuB,SAAS,oKAGnC;AAGL,QAAO;;;;;;;;;;ACpDX,SAAgB,uBAA+B;CAC3C,MAAM,oBAAoB,QAAQ,IAAI;CAQtC,MAAM,eAAe;EACjB,cAAc;EACd,gBAAgB;EAChB,gBAAgB,EAAE,MAAM,WAAoB;EAC5C,oBAAoB;EACpB,KAAK;EACL,QAAQ;GACJ,eAAe;GACf,uBAAuB;GACvB,uBAAuB;GAC1B;EAID,UAhBa,aAAa,IAgBJ;EAEtB,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,kBAAkB,aAAa,aAAa,SAC5C,QAAO,KAAK,sBAAsB,aAAa,SAAS,QAAQ,kBAAkB,WAAW;AAGjG,OAAI,OAAO,SAAS,EAChB,OAAM,IAAI,MACN,oGAAoG,OAAO,KAAK,MAAM,OAAO,IAAI,CAAC,KAAK,KAAK,GAC/I;;EAGZ"}

package/dist/data-store/local-provider.d.ts

@@ -0,0 +1,42 @@
+//#region src/data-store/local-provider.d.ts
+/**
+ * Copyright 2026 Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+type DataStoreEntry = {
+  value?: unknown;
+};
+type LocalDataStoreProvider = {
+  kind: 'local';
+  getEntry: (key: string) => Promise<DataStoreEntry | null>;
+};
+type LocalDataStoreProviderOptions = {
+  defaults?: Record<string, Record<string, unknown>>;
+  warnOnMissing?: boolean;
+};
+/**
+ * Create a local data-store provider for development environments.
+ *
+ * Environment variables:
+ * - `SFNEXT_DATA_STORE_DEFAULTS` (optional): JSON map of keys to preference objects.
+ *   Example: {"custom-global-preferences":{"featureFlag":true}}
+ * - `SFNEXT_DATA_STORE_WARN_ON_MISSING` (optional): Set to "false" to silence warnings.
+ *
+ * @param options - Optional defaults and warning controls for local entries.
+ * @returns Local provider that supplies preferences from defaults or empty values.
+ */
+declare function createLocalDataStoreProvider(options?: LocalDataStoreProviderOptions): LocalDataStoreProvider;
+//#endregion
+export { LocalDataStoreProvider, createLocalDataStoreProvider };
+//# sourceMappingURL=local-provider.d.ts.map

package/dist/data-store/local-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-provider.d.ts","names":[],"sources":["../../src/data-store/local-provider.ts"],"sourcesContent":[],"mappings":";;;AAoBA;AAGE;AAkBF;;;;;;;;;;;KAzBK,cAAA;;;KAIO,sBAAA;;6BAEmB,QAAQ;;KAGlC,6BAAA;aACU,eAAe;;;;;;;;;;;;;;iBAed,4BAAA,WAAsC,gCAAqC"}

package/dist/data-store/local-provider.js

@@ -0,0 +1,66 @@
+//#region src/data-store/local-provider.ts
+/**
+* Create a local data-store provider for development environments.
+*
+* Environment variables:
+* - `SFNEXT_DATA_STORE_DEFAULTS` (optional): JSON map of keys to preference objects.
+*   Example: {"custom-global-preferences":{"featureFlag":true}}
+* - `SFNEXT_DATA_STORE_WARN_ON_MISSING` (optional): Set to "false" to silence warnings.
+*
+* @param options - Optional defaults and warning controls for local entries.
+* @returns Local provider that supplies preferences from defaults or empty values.
+*/
+function createLocalDataStoreProvider(options = {}) {
+	const defaults = options.defaults ?? readDefaultsFromEnv();
+	const warnOnMissing = options.warnOnMissing ?? readWarnOnMissingFromEnv();
+	const warnedKeys = /* @__PURE__ */ new Set();
+	return {
+		kind: "local",
+		getEntry(key) {
+			const value = defaults[key];
+			if (value && typeof value === "object") return Promise.resolve({ value });
+			if (warnOnMissing && !warnedKeys.has(key)) {
+				warnedKeys.add(key);
+				console.warn(`Local data-store provider did not find '${key}'. Returning an empty object for development.`);
+			}
+			return Promise.resolve({ value: {} });
+		}
+	};
+}
+/**
+* Read default data-store entries from the environment.
+*
+* Environment variables:
+* - `SFNEXT_DATA_STORE_DEFAULTS` (optional): JSON map of keys to preference objects.
+*   Example: {"custom-global-preferences":{"featureFlag":true}}
+*
+* @returns Parsed defaults map or an empty object.
+*/
+function readDefaultsFromEnv() {
+	const raw = process.env.SFNEXT_DATA_STORE_DEFAULTS;
+	if (!raw) return {};
+	try {
+		const parsed = JSON.parse(raw);
+		if (parsed && typeof parsed === "object") return parsed;
+	} catch (error) {
+		console.warn("Failed to parse SFNEXT_DATA_STORE_DEFAULTS JSON.", error);
+	}
+	return {};
+}
+/**
+* Read warn-on-missing behavior from the environment.
+*
+* Environment variables:
+* - `SFNEXT_DATA_STORE_WARN_ON_MISSING` (optional): Set to "false" to silence warnings.
+*
+* @returns True when warnings should be emitted for missing entries.
+*/
+function readWarnOnMissingFromEnv() {
+	const raw = process.env.SFNEXT_DATA_STORE_WARN_ON_MISSING;
+	if (!raw) return true;
+	return raw.toLowerCase() !== "false";
+}
+
+//#endregion
+export { createLocalDataStoreProvider };
+//# sourceMappingURL=local-provider.js.map

package/dist/data-store/local-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-provider.js","names":[],"sources":["../../src/data-store/local-provider.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 */\n\ntype DataStoreEntry = {\n    value?: unknown;\n};\n\nexport type LocalDataStoreProvider = {\n    kind: 'local';\n    getEntry: (key: string) => Promise<DataStoreEntry | null>;\n};\n\ntype LocalDataStoreProviderOptions = {\n    defaults?: Record<string, Record<string, unknown>>;\n    warnOnMissing?: boolean;\n};\n\n/**\n * Create a local data-store provider for development environments.\n *\n * Environment variables:\n * - `SFNEXT_DATA_STORE_DEFAULTS` (optional): JSON map of keys to preference objects.\n *   Example: {\"custom-global-preferences\":{\"featureFlag\":true}}\n * - `SFNEXT_DATA_STORE_WARN_ON_MISSING` (optional): Set to \"false\" to silence warnings.\n *\n * @param options - Optional defaults and warning controls for local entries.\n * @returns Local provider that supplies preferences from defaults or empty values.\n */\nexport function createLocalDataStoreProvider(options: LocalDataStoreProviderOptions = {}): LocalDataStoreProvider {\n    const defaults = options.defaults ?? readDefaultsFromEnv();\n    const warnOnMissing = options.warnOnMissing ?? readWarnOnMissingFromEnv();\n    const warnedKeys = new Set<string>();\n\n    return {\n        kind: 'local',\n        getEntry(key: string) {\n            const value = defaults[key];\n            if (value && typeof value === 'object') {\n                return Promise.resolve({ value });\n            }\n\n            if (warnOnMissing && !warnedKeys.has(key)) {\n                warnedKeys.add(key);\n                // eslint-disable-next-line no-console\n                console.warn(\n                    `Local data-store provider did not find '${key}'. Returning an empty object for development.`\n                );\n            }\n\n            return Promise.resolve({ value: {} });\n        },\n    };\n}\n\n/**\n * Read default data-store entries from the environment.\n *\n * Environment variables:\n * - `SFNEXT_DATA_STORE_DEFAULTS` (optional): JSON map of keys to preference objects.\n *   Example: {\"custom-global-preferences\":{\"featureFlag\":true}}\n *\n * @returns Parsed defaults map or an empty object.\n */\nfunction readDefaultsFromEnv(): Record<string, Record<string, unknown>> {\n    const raw = process.env.SFNEXT_DATA_STORE_DEFAULTS;\n    if (!raw) {\n        return {};\n    }\n\n    try {\n        const parsed = JSON.parse(raw);\n        if (parsed && typeof parsed === 'object') {\n            return parsed as Record<string, Record<string, unknown>>;\n        }\n    } catch (error) {\n        // eslint-disable-next-line no-console\n        console.warn('Failed to parse SFNEXT_DATA_STORE_DEFAULTS JSON.', error);\n    }\n\n    return {};\n}\n\n/**\n * Read warn-on-missing behavior from the environment.\n *\n * Environment variables:\n * - `SFNEXT_DATA_STORE_WARN_ON_MISSING` (optional): Set to \"false\" to silence warnings.\n *\n * @returns True when warnings should be emitted for missing entries.\n */\nfunction readWarnOnMissingFromEnv(): boolean {\n    const raw = process.env.SFNEXT_DATA_STORE_WARN_ON_MISSING;\n    if (!raw) {\n        return true;\n    }\n    return raw.toLowerCase() !== 'false';\n}\n"],"mappings":";;;;;;;;;;;;AAyCA,SAAgB,6BAA6B,UAAyC,EAAE,EAA0B;CAC9G,MAAM,WAAW,QAAQ,YAAY,qBAAqB;CAC1D,MAAM,gBAAgB,QAAQ,iBAAiB,0BAA0B;CACzE,MAAM,6BAAa,IAAI,KAAa;AAEpC,QAAO;EACH,MAAM;EACN,SAAS,KAAa;GAClB,MAAM,QAAQ,SAAS;AACvB,OAAI,SAAS,OAAO,UAAU,SAC1B,QAAO,QAAQ,QAAQ,EAAE,OAAO,CAAC;AAGrC,OAAI,iBAAiB,CAAC,WAAW,IAAI,IAAI,EAAE;AACvC,eAAW,IAAI,IAAI;AAEnB,YAAQ,KACJ,2CAA2C,IAAI,+CAClD;;AAGL,UAAO,QAAQ,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;;EAE5C;;;;;;;;;;;AAYL,SAAS,sBAA+D;CACpE,MAAM,MAAM,QAAQ,IAAI;AACxB,KAAI,CAAC,IACD,QAAO,EAAE;AAGb,KAAI;EACA,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,UAAU,OAAO,WAAW,SAC5B,QAAO;UAEN,OAAO;AAEZ,UAAQ,KAAK,oDAAoD,MAAM;;AAG3E,QAAO,EAAE;;;;;;;;;;AAWb,SAAS,2BAAoC;CACzC,MAAM,MAAM,QAAQ,IAAI;AACxB,KAAI,CAAC,IACD,QAAO;AAEX,QAAO,IAAI,aAAa,KAAK"}

package/dist/flags.js

@@ -1,11 +1,13 @@
 import { Flags } from "@oclif/core";
 
 //#region src/flags.ts
-const commonFlags = { "project-directory": Flags.string({
-	char: "d",
+const PROJECT_DIRECTORY_FLAG = "project-directory";
+const PROJECT_DIRECTORY_CHAR = "d";
+const commonFlags = { [PROJECT_DIRECTORY_FLAG]: Flags.string({
+	char: PROJECT_DIRECTORY_CHAR,
 	description: "Project directory",
 	default: process.cwd()
 }) };
 
 //#endregion
-export { commonFlags as t };
+export { PROJECT_DIRECTORY_FLAG as n, commonFlags as r, PROJECT_DIRECTORY_CHAR as t };

package/dist/generate-cartridge.js

@@ -120,7 +120,7 @@ const SKIP_DIRECTORIES = [
 	".next",
 	"coverage"
 ];
-const DEFAULT_COMPONENT_GROUP = "odyssey_base";
+const DEFAULT_COMPONENT_GROUP = "storefrontnext_base";
 const ARCH_TYPE_HEADLESS = "headless";
 const VALID_ATTRIBUTE_TYPES = [
 	"string",
@@ -617,6 +617,14 @@ async function generateMetadata(projectDirectory, metadataDirectory, options) {
 				}
 			};
 			await scanDirectory(srcDir);
+			const configMetadataDir = join(projectRoot, "config-metadata");
+			try {
+				await access(configMetadataDir);
+				await scanDirectory(configMetadataDir);
+			} catch (error) {
+				if (error.code === "ENOENT") logger.debug(`   - Directory not found (skipping): ${configMetadataDir}`);
+				else logger.warn(`   - Unable to access ${configMetadataDir}:`, error.message);
+			}
 		}
 		const allComponents = [];
 		const allPageTypes = [];