@salesforce/storefront-next-dev 0.4.1 → 1.0.0-alpha.0

package/dist/commands/scapi/available.js

@@ -0,0 +1,225 @@
+import { i as isBuiltInClientKey, r as deriveClientKey } from "../../schema-utils.js";
+import { OAuthCommand } from "@salesforce/b2c-tooling-sdk/cli";
+import { createScapiSchemasClient, toOrganizationId } from "@salesforce/b2c-tooling-sdk/clients";
+
+//#region src/commands/scapi/available.ts
+/**
+* Survey SCAPI schemas on the active tenant to plan override testing. Lists:
+* - Built-in shopper APIs (always available platform-side; overridable by sfnext scapi)
+*   along with how many `c_*` custom attributes each currently has on this tenant.
+* - Tenant-registered custom SCAPI APIs (from the Schemas API endpoint).
+*
+* Authentication reuses the same pipeline as `sfnext scapi add`.
+*/
+const BUILT_IN_APIS = [
+	{
+		apiFamily: "product",
+		apiName: "shopper-availability",
+		apiVersion: "v1",
+		clientKey: "shopperAvailability"
+	},
+	{
+		apiFamily: "checkout",
+		apiName: "shopper-baskets",
+		apiVersion: "v1",
+		clientKey: "shopperBasketsV1"
+	},
+	{
+		apiFamily: "checkout",
+		apiName: "shopper-baskets",
+		apiVersion: "v2",
+		clientKey: "shopperBasketsV2"
+	},
+	{
+		apiFamily: "configuration",
+		apiName: "shopper-configurations",
+		apiVersion: "v1",
+		clientKey: "shopperConfigurations"
+	},
+	{
+		apiFamily: "shopper",
+		apiName: "shopper-consents",
+		apiVersion: "v1",
+		clientKey: "shopperConsents"
+	},
+	{
+		apiFamily: "shopper",
+		apiName: "shopper-context",
+		apiVersion: "v1",
+		clientKey: "shopperContext"
+	},
+	{
+		apiFamily: "customer",
+		apiName: "shopper-customers",
+		apiVersion: "v1",
+		clientKey: "shopperCustomers"
+	},
+	{
+		apiFamily: "experience",
+		apiName: "shopper-experience",
+		apiVersion: "v1",
+		clientKey: "shopperExperience"
+	},
+	{
+		apiFamily: "pricing",
+		apiName: "shopper-gift-certificates",
+		apiVersion: "v1",
+		clientKey: "shopperGiftCertificates"
+	},
+	{
+		apiFamily: "shopper",
+		apiName: "auth",
+		apiVersion: "v1",
+		clientKey: "shopperLogin"
+	},
+	{
+		apiFamily: "checkout",
+		apiName: "shopper-orders",
+		apiVersion: "v1",
+		clientKey: "shopperOrders"
+	},
+	{
+		apiFamily: "checkout",
+		apiName: "shopper-payments",
+		apiVersion: "v1",
+		clientKey: "shopperPayments"
+	},
+	{
+		apiFamily: "product",
+		apiName: "shopper-products",
+		apiVersion: "v1",
+		clientKey: "shopperProducts"
+	},
+	{
+		apiFamily: "pricing",
+		apiName: "shopper-promotions",
+		apiVersion: "v1",
+		clientKey: "shopperPromotions"
+	},
+	{
+		apiFamily: "search",
+		apiName: "shopper-search",
+		apiVersion: "v1",
+		clientKey: "shopperSearch"
+	},
+	{
+		apiFamily: "site",
+		apiName: "shopper-seo",
+		apiVersion: "v1",
+		clientKey: "shopperSeo"
+	},
+	{
+		apiFamily: "store",
+		apiName: "shopper-stores",
+		apiVersion: "v1",
+		clientKey: "shopperStores"
+	}
+];
+var Available = class extends OAuthCommand {
+	static description = "Survey SCAPI schemas available on the active tenant — built-in (overridable) and custom — and report the number of c_* custom attributes each currently has.";
+	static examples = ["<%= config.bin %> <%= command.id %>"];
+	async run() {
+		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 in dw.json.");
+		const organizationId = toOrganizationId(tenantId);
+		const oauthStrategy = this.getOAuthStrategy();
+		const client = createScapiSchemasClient({
+			shortCode,
+			tenantId
+		}, oauthStrategy);
+		this.log(`Probing built-in shopper APIs on tenant ${tenantId} for c_* custom attributes...\n`);
+		const builtInResults = [];
+		for (const api of BUILT_IN_APIS) try {
+			const { data, error, response } = await client.GET("/organizations/{organizationId}/schemas/{apiFamily}/{apiName}/{apiVersion}", { params: {
+				path: {
+					organizationId,
+					apiFamily: api.apiFamily,
+					apiName: api.apiName,
+					apiVersion: api.apiVersion
+				},
+				query: { expand: "custom_properties" }
+			} });
+			if (error || !data) {
+				builtInResults.push({
+					api,
+					cAttrCount: 0,
+					schemasWithC: [],
+					error: `${response.status}`
+				});
+				continue;
+			}
+			const schemas = data.components?.schemas ?? {};
+			let total = 0;
+			const interestingSchemas = [];
+			for (const [schemaName, schema] of Object.entries(schemas)) {
+				const props = schema?.properties ?? {};
+				const cProps = Object.keys(props).filter((k) => k.startsWith("c_"));
+				if (cProps.length > 0) {
+					total += cProps.length;
+					interestingSchemas.push(`${schemaName} (+${cProps.length})`);
+				}
+			}
+			builtInResults.push({
+				api,
+				cAttrCount: total,
+				schemasWithC: interestingSchemas
+			});
+		} catch (e) {
+			builtInResults.push({
+				api,
+				cAttrCount: 0,
+				schemasWithC: [],
+				error: e instanceof Error ? e.message : "unknown"
+			});
+		}
+		builtInResults.sort((a, b) => b.cAttrCount - a.cAttrCount);
+		const interesting = builtInResults.filter((r) => r.cAttrCount > 0);
+		const empty = builtInResults.filter((r) => r.cAttrCount === 0 && !r.error);
+		const errored = builtInResults.filter((r) => r.error);
+		this.log(`Built-in shopper APIs (${BUILT_IN_APIS.length}):`);
+		if (interesting.length > 0) {
+			this.log(`\n  Interesting (c_* attributes present) — high-value override targets:\n`);
+			for (const r of interesting) {
+				this.log(`    ${r.api.clientKey} (${r.cAttrCount} c_* attrs across ${r.schemasWithC.length} schemas)`);
+				this.log(`      sfnext scapi add ${r.api.apiFamily} ${r.api.apiName} ${r.api.apiVersion}`);
+				if (r.schemasWithC.length <= 8) this.log(`      schemas: ${r.schemasWithC.join(", ")}`);
+			}
+		}
+		if (empty.length > 0) {
+			this.log(`\n  No c_* attributes (overridable but no tenant customizations to surface):`);
+			for (const r of empty) this.log(`    ${r.api.clientKey}`);
+		}
+		if (errored.length > 0) {
+			this.log(`\n  Errored:`);
+			for (const r of errored) this.log(`    ${r.api.clientKey} — ${r.error}`);
+		}
+		this.log(`\n\nQuerying tenant for custom SCAPI APIs...`);
+		const { data: listData, error: listError, response: listResp } = await client.GET("/organizations/{organizationId}/schemas", { params: { path: { organizationId } } });
+		if (listError || !listData) {
+			this.warn(`Schemas listing failed (${listResp.status}). Custom APIs may exist but cannot be enumerated.`);
+			return;
+		}
+		const listed = listData.schemas ?? [];
+		const customApis = [];
+		for (const s of listed) {
+			if (!s.apiName) continue;
+			const clientKey = deriveClientKey(s.apiName);
+			if (!isBuiltInClientKey(clientKey)) customApis.push({
+				...s,
+				clientKey
+			});
+		}
+		if (customApis.length === 0) this.log("  No custom SCAPI APIs registered on this tenant.");
+		else {
+			this.log(`  Custom APIs (${customApis.length}):\n`);
+			for (const s of customApis) {
+				this.log(`    ${s.apiFamily}/${s.apiName}/${s.apiVersion}  (clientKey: ${s.clientKey})`);
+				this.log(`      sfnext scapi add ${s.apiFamily} ${s.apiName} ${s.apiVersion}`);
+			}
+		}
+	}
+};
+
+//#endregion
+export { Available as default };

package/dist/commands/scapi/list.js

@@ -1,14 +1,17 @@
 import { r as commonFlags } from "../../flags.js";
-import { r as readAllSchemaMetadata } from "../../schema-utils.js";
+import { a as readAllSchemaMetadata, i as isBuiltInClientKey } from "../../schema-utils.js";
 import { Command } from "@oclif/core";
 import { join } from "node:path";
 
 //#region src/commands/scapi/list.ts
+function entryKind(entry) {
+	return entry.kind ?? (isBuiltInClientKey(entry.clientKey) ? "override" : "custom");
+}
 /**
-* List registered custom SCAPI clients.
+* List registered SCAPI client overrides and custom APIs.
 */
 var List = class List extends Command {
-	static description = "List registered custom SCAPI clients";
+	static description = "List registered SCAPI client overrides and custom APIs";
 	static examples = ["<%= config.bin %> <%= command.id %>", "<%= config.bin %> <%= command.id %> -d ./my-project"];
 	static flags = { ...commonFlags };
 	async run() {
@@ -16,18 +19,28 @@ var List = class List extends Command {
 		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("No SCAPI client overrides or custom APIs 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("");
+		const overrides = entries.filter((e) => entryKind(e) === "override");
+		const customs = entries.filter((e) => entryKind(e) === "custom");
+		this.log(`\nRegistered SCAPI clients (${entries.length}):`);
+		if (overrides.length > 0) {
+			this.log(`\nOverrides (${overrides.length}):\n`);
+			for (const e of overrides) this.printEntry(e);
 		}
+		if (customs.length > 0) {
+			this.log(`\nCustom APIs (${customs.length}):\n`);
+			for (const e of customs) this.printEntry(e);
+		}
+	}
+	printEntry({ clientKey, basePath, supportsLocale, schemaName }) {
+		this.log(`  ${clientKey}`);
+		this.log(`    Schema:  schemas/${schemaName}.yaml`);
+		this.log(`    Base:    ${basePath}`);
+		this.log(`    Locale:  ${supportsLocale ? "yes" : "no"}`);
+		this.log("");
 	}
 };
 

package/dist/commands/scapi/remove.js

@@ -1,5 +1,5 @@
 import { r as commonFlags } from "../../flags.js";
-import { r as readAllSchemaMetadata } from "../../schema-utils.js";
+import { a 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";
@@ -42,12 +42,18 @@ var Remove = class Remove extends Command {
 		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)) {
+		const namespacePath = join(generatedDir, `${schemaName}.namespace.ts`);
+		for (const filePath of [
+			typesPath,
+			opsPath,
+			namespacePath
+		]) 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(`Updated ${relative(projectDir, join(scapiDir, "index.ts"))}`);
 		this.log(`\nRemoved client "${clientKey}".`);
 	}
 };

package/dist/configs/react-router.config.d.ts

@@ -6,6 +6,13 @@ import { Preset } from "@react-router/dev/config";
  * Storefront Next preset for React Router configuration.
  * This preset enforces standard configuration for SFCC Storefront Next applications.
  * Users cannot override these values - they will be validated and an error will be thrown if modified.
+ *
+ * Environment variables:
+ * - `SFW_FALCON_INSTANCE` — (Optional) The Falcon instance identifier (e.g., `aws-dev2-uswest2`).
+ *   When set together with `SFW_FUNCTIONAL_DOMAIN`, adds workspace proxy domains to
+ *   `allowedActionOrigins` for CSRF protection on form actions.
+ * - `SFW_FUNCTIONAL_DOMAIN` — (Optional) The functional domain name (e.g., `cvw-dataplane-test`).
+ *   Required alongside `SFW_FALCON_INSTANCE` to construct workspace origin patterns.
  */
 declare function storefrontNextPreset(): Preset;
 //#endregion

package/dist/configs/react-router.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react-router.config.d.ts","names":[],"sources":["../../src/configs/react-router.config.ts"],"sourcesContent":[],"mappings":";;;;;;;;;iBAuBgB,oBAAA,CAAA,GAAwB"}
+{"version":3,"file":"react-router.config.d.ts","names":[],"sources":["../../src/configs/react-router.config.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;iBA8BgB,oBAAA,CAAA,GAAwB"}

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

@@ -37,9 +37,19 @@ function getBasePath() {
 * Storefront Next preset for React Router configuration.
 * This preset enforces standard configuration for SFCC Storefront Next applications.
 * Users cannot override these values - they will be validated and an error will be thrown if modified.
+*
+* Environment variables:
+* - `SFW_FALCON_INSTANCE` — (Optional) The Falcon instance identifier (e.g., `aws-dev2-uswest2`).
+*   When set together with `SFW_FUNCTIONAL_DOMAIN`, adds workspace proxy domains to
+*   `allowedActionOrigins` for CSRF protection on form actions.
+* - `SFW_FUNCTIONAL_DOMAIN` — (Optional) The functional domain name (e.g., `cvw-dataplane-test`).
+*   Required alongside `SFW_FALCON_INSTANCE` to construct workspace origin patterns.
 */
 function storefrontNextPreset() {
 	const sfwFalconInstance = process.env.SFW_FALCON_INSTANCE;
+	const sfwFunctionalDomain = process.env.SFW_FUNCTIONAL_DOMAIN;
+	if (sfwFalconInstance && !sfwFunctionalDomain) console.warn("[storefront-next] SFW_FALCON_INSTANCE is set but SFW_FUNCTIONAL_DOMAIN is not. allowedActionOrigins will not include workspace domains. Set both env vars to enable CSRF protection for workspace proxy origins.");
+	if (sfwFunctionalDomain && !sfwFalconInstance) console.warn("[storefront-next] SFW_FUNCTIONAL_DOMAIN is set but SFW_FALCON_INSTANCE is not. allowedActionOrigins will not include workspace domains. Set both env vars to enable CSRF protection for workspace proxy origins.");
 	const presetConfig = {
 		appDirectory: "./src",
 		buildDirectory: "build",
@@ -52,7 +62,7 @@ function storefrontNextPreset() {
 			unstable_optimizeDeps: true
 		},
 		basename: getBasePath() || "/",
-		...sfwFalconInstance && { allowedActionOrigins: [`*.dataplane.cvw-dataplane-test.${sfwFalconInstance}.aws.sfdc.cl`] }
+		...sfwFalconInstance && sfwFunctionalDomain && { allowedActionOrigins: [`*.dataplane.${sfwFunctionalDomain}.${sfwFalconInstance}.aws.sfdc.cl`, `*.platform.a.${sfwFunctionalDomain}.${sfwFalconInstance}.aws.sfdc.cl`] }
 	};
 	return {
 		name: "storefront-next-preset",
@@ -65,6 +75,7 @@ function storefrontNextPreset() {
 			if (reactRouterConfig.future?.v8_middleware !== presetConfig.future.v8_middleware) errors.push(`future.v8_middleware: expected ${presetConfig.future.v8_middleware}, got ${reactRouterConfig.future?.v8_middleware}`);
 			if (reactRouterConfig.future?.v8_viteEnvironmentApi !== presetConfig.future.v8_viteEnvironmentApi) errors.push(`future.v8_viteEnvironmentApi: expected ${presetConfig.future.v8_viteEnvironmentApi}, got ${reactRouterConfig.future?.v8_viteEnvironmentApi}`);
 			if (reactRouterConfig.basename !== presetConfig.basename) errors.push(`basename: expected ${presetConfig.basename}, got ${reactRouterConfig.basename}`);
+			if (presetConfig.allowedActionOrigins && JSON.stringify(reactRouterConfig.allowedActionOrigins) !== JSON.stringify(presetConfig.allowedActionOrigins)) errors.push(`allowedActionOrigins: expected ${JSON.stringify(presetConfig.allowedActionOrigins)}, got ${JSON.stringify(reactRouterConfig.allowedActionOrigins)}`);
 			if (errors.length > 0) throw new Error(`Storefront Next preset configuration was overridden. The following values must not be modified:\n${errors.map((e) => `  - ${e}`).join("\n")}`);
 		}
 	};

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            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"}
+{"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 *\n * Environment variables:\n * - `SFW_FALCON_INSTANCE` — (Optional) The Falcon instance identifier (e.g., `aws-dev2-uswest2`).\n *   When set together with `SFW_FUNCTIONAL_DOMAIN`, adds workspace proxy domains to\n *   `allowedActionOrigins` for CSRF protection on form actions.\n * - `SFW_FUNCTIONAL_DOMAIN` — (Optional) The functional domain name (e.g., `cvw-dataplane-test`).\n *   Required alongside `SFW_FALCON_INSTANCE` to construct workspace origin patterns.\n */\nexport function storefrontNextPreset(): Preset {\n    const sfwFalconInstance = process.env.SFW_FALCON_INSTANCE;\n    const sfwFunctionalDomain = process.env.SFW_FUNCTIONAL_DOMAIN;\n\n    if (sfwFalconInstance && !sfwFunctionalDomain) {\n        console.warn(\n            '[storefront-next] SFW_FALCON_INSTANCE is set but SFW_FUNCTIONAL_DOMAIN is not. ' +\n                'allowedActionOrigins will not include workspace domains. ' +\n                'Set both env vars to enable CSRF protection for workspace proxy origins.'\n        );\n    }\n\n    if (sfwFunctionalDomain && !sfwFalconInstance) {\n        console.warn(\n            '[storefront-next] SFW_FUNCTIONAL_DOMAIN is set but SFW_FALCON_INSTANCE is not. ' +\n                'allowedActionOrigins will not include workspace domains. ' +\n                'Set both env vars to enable CSRF protection for workspace proxy origins.'\n        );\n    }\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 domains for CSRF protection on form actions\n        // Both the legacy port-based dataplane format and the Pomerium reverse proxy format are supported\n        ...(sfwFalconInstance &&\n            sfwFunctionalDomain && {\n                allowedActionOrigins: [\n                    `*.dataplane.${sfwFunctionalDomain}.${sfwFalconInstance}.aws.sfdc.cl`,\n                    `*.platform.a.${sfwFunctionalDomain}.${sfwFalconInstance}.aws.sfdc.cl`,\n                ],\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            // Only validate allowedActionOrigins when the preset sets it (workspace env).\n            // In prod builds (no workspace env vars), customers are free to configure their own origins.\n            if (\n                presetConfig.allowedActionOrigins &&\n                JSON.stringify(reactRouterConfig.allowedActionOrigins) !==\n                    JSON.stringify(presetConfig.allowedActionOrigins)\n            ) {\n                errors.push(\n                    `allowedActionOrigins: expected ${JSON.stringify(presetConfig.allowedActionOrigins)}, got ${JSON.stringify(reactRouterConfig.allowedActionOrigins)}`\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":";;;;;;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;AC7CX,SAAgB,uBAA+B;CAC3C,MAAM,oBAAoB,QAAQ,IAAI;CACtC,MAAM,sBAAsB,QAAQ,IAAI;AAExC,KAAI,qBAAqB,CAAC,oBACtB,SAAQ,KACJ,mNAGH;AAGL,KAAI,uBAAuB,CAAC,kBACxB,SAAQ,KACJ,mNAGH;CASL,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;EAGtB,GAAI,qBACA,uBAAuB,EACnB,sBAAsB,CAClB,eAAe,oBAAoB,GAAG,kBAAkB,eACxD,gBAAgB,oBAAoB,GAAG,kBAAkB,cAC5D,EACJ;EACR;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;AAKjG,OACI,aAAa,wBACb,KAAK,UAAU,kBAAkB,qBAAqB,KAClD,KAAK,UAAU,aAAa,qBAAqB,CAErD,QAAO,KACH,kCAAkC,KAAK,UAAU,aAAa,qBAAqB,CAAC,QAAQ,KAAK,UAAU,kBAAkB,qBAAqB,GACrJ;AAGL,OAAI,OAAO,SAAS,EAChB,OAAM,IAAI,MACN,oGAAoG,OAAO,KAAK,MAAM,OAAO,IAAI,CAAC,KAAK,KAAK,GAC/I;;EAGZ"}

package/dist/generate-cartridge.js

@@ -309,6 +309,7 @@ function extractAttributesFromSource(sourceFile, className) {
 			};
 			if (config.values) attribute.values = config.values;
 			if (config.defaultValue !== void 0) attribute.default_value = config.defaultValue;
+			if (config.editorDefinition !== void 0) attribute.editor_definition = config.editorDefinition;
 			attributes.push(attribute);
 		}
 	} catch (error) {

package/dist/generate-custom-clients.js

@@ -1,5 +1,5 @@
-import { r as readAllSchemaMetadata } from "./schema-utils.js";
-import { writeFileSync } from "node:fs";
+import { a as readAllSchemaMetadata, i as isBuiltInClientKey } from "./schema-utils.js";
+import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
 //#region src/scapi/generate-custom-clients.ts
@@ -19,12 +19,40 @@ const COPYRIGHT_HEADER = `/**
  * limitations under the License.
  */`;
 /**
-* Generate the custom-clients.ts file in the template project.
+* Mapping of every built-in client key to its runtime namespace name.
+* Camel→Pascal would suffice for all current entries, but keeping the map explicit
+* prevents surprises if a future client uses a name that doesn't round-trip cleanly.
 *
-* @param scapiDir - Absolute path to the src/scapi/ directory in the template project
+* Keep in sync with `BUILT_IN_CLIENT_KEYS` in schema-utils.ts and the namespaces in
+* `packages/storefront-next-runtime/src/scapi-client/types.ts`.
 */
-function generateCustomClientsFile(scapiDir) {
-	const entries = readAllSchemaMetadata(join(scapiDir, "schemas"));
+const BUILT_IN_NAMESPACE_BY_KEY = {
+	shopperAvailability: "ShopperAvailability",
+	shopperBasketsV1: "ShopperBasketsV1",
+	shopperBasketsV2: "ShopperBasketsV2",
+	shopperConfigurations: "ShopperConfigurations",
+	shopperConsents: "ShopperConsents",
+	shopperContext: "ShopperContext",
+	shopperCustomers: "ShopperCustomers",
+	shopperExperience: "ShopperExperience",
+	shopperGiftCertificates: "ShopperGiftCertificates",
+	shopperLogin: "ShopperLogin",
+	shopperOrders: "ShopperOrders",
+	shopperPayments: "ShopperPayments",
+	shopperProducts: "ShopperProducts",
+	shopperPromotions: "ShopperPromotions",
+	shopperSearch: "ShopperSearch",
+	shopperSeo: "ShopperSeo",
+	shopperStores: "ShopperStores"
+};
+function isOverride(entry) {
+	return (entry.kind ?? (isBuiltInClientKey(entry.clientKey) ? "override" : "custom")) === "override";
+}
+/**
+* Write `src/scapi/custom-clients.ts` from the schema entries.
+* Always writes — empty registry produces a no-op file.
+*/
+function writeCustomClientsFile(scapiDir, entries) {
 	const customClientsPath = join(scapiDir, "custom-clients.ts");
 	if (entries.length === 0) {
 		writeFileSync(customClientsPath, `${COPYRIGHT_HEADER}
@@ -34,7 +62,7 @@ function generateCustomClientsFile(scapiDir) {
  *
  * Use \`sfnext scapi add --schema <file>\` to add a client from a local schema file.
  * Use \`sfnext scapi add <family> <name> <version>\` to pull from the SCAPI Schemas API.
- * Use \`sfnext scapi list\` to see registered custom clients.
+ * Use \`sfnext scapi list\` to see registered clients.
  */
 export { type Clients as AppClients } from '@salesforce/storefront-next-runtime/scapi';
 
@@ -68,6 +96,98 @@ ${clientEntries.join("\n")}
 ] as const;
 `, "utf-8");
 }
+/**
+* Write a per-override namespace wrapper that mirrors the shape of the runtime's
+* namespaces in `packages/storefront-next-runtime/src/scapi-client/types.ts`.
+* Only emitted when the entry overrides a built-in client.
+*/
+function writeOverrideNamespaceFile(scapiDir, entry) {
+	const namespaceName = BUILT_IN_NAMESPACE_BY_KEY[entry.clientKey];
+	if (!namespaceName) return;
+	const generatedDir = join(scapiDir, "generated");
+	mkdirSync(generatedDir, { recursive: true });
+	writeFileSync(join(generatedDir, `${entry.schemaName}.namespace.ts`), `${COPYRIGHT_HEADER}
+
+/* eslint-disable @typescript-eslint/no-namespace, import/no-namespace */
+/**
+ * Override namespace for \`${namespaceName}\` — generated by \`sfnext scapi\`, do not edit manually.
+ *
+ * Mirrors the shape of the runtime SDK's namespace so consumers of \`@/scapi\` see the
+ * same \`endpoints\`, \`schemas\`, and \`operations\` keys, but resolved against the local
+ * schema (e.g., with \`c_*\` custom attributes typed).
+ */
+import type * as Source from './${entry.schemaName}';
+
+export namespace ${namespaceName} {
+    export type endpoints = Source.paths;
+    export type schemas = Source.components['schemas'];
+    export type operations = Source.operations;
+}
+`, "utf-8");
+}
+/**
+* Write `src/scapi/index.ts` — the template-local SCAPI barrel.
+*
+* Always wildcards the runtime SCAPI surface so future SDK additions flow through
+* automatically. Overridden namespaces are re-exported explicitly below the wildcard;
+* ECMAScript module semantics make a named re-export shadow a same-named wildcard
+* re-export, so consumers of `@/scapi` see the local generated namespace for overridden
+* clients and the runtime version for everything else.
+*/
+function writeBarrelFile(scapiDir, entries) {
+	const indexPath = join(scapiDir, "index.ts");
+	const overrides = entries.filter(isOverride);
+	if (overrides.length === 0) {
+		writeFileSync(indexPath, `${COPYRIGHT_HEADER}
+
+/**
+ * Template-local SCAPI barrel — generated by \`sfnext scapi\`, do not edit manually.
+ *
+ * Template code should import SCAPI types and clients from \`@/scapi\` (this file) so
+ * that any overrides registered via \`sfnext scapi add\` resolve to local schemas. With
+ * no overrides registered this is a transparent re-export of the runtime SDK.
+ */
+export * from '@salesforce/storefront-next-runtime/scapi';
+export { customClients, type AppClients } from './custom-clients';
+`, "utf-8");
+		return;
+	}
+	const overriddenNamespaces = overrides.map((e) => BUILT_IN_NAMESPACE_BY_KEY[e.clientKey]).filter((n) => typeof n === "string");
+	const overrideExports = overrides.map((e) => {
+		const ns = BUILT_IN_NAMESPACE_BY_KEY[e.clientKey];
+		return ns ? `export type { ${ns} } from './generated/${e.schemaName}.namespace';` : "";
+	}).filter(Boolean).join("\n");
+	writeFileSync(indexPath, `${COPYRIGHT_HEADER}
+
+/**
+ * Template-local SCAPI barrel — generated by \`sfnext scapi\`, do not edit manually.
+ *
+ * Wildcard re-exports the runtime SCAPI surface; the explicit named re-exports below
+ * shadow the wildcard so each active override resolves to its locally-generated schema.
+ *
+ * Active overrides: ${overriddenNamespaces.join(", ")}
+ */
+export * from '@salesforce/storefront-next-runtime/scapi';
+
+// Overridden namespaces — resolved against local schemas
+${overrideExports}
+
+// Custom client registry consumed by api-clients.server.ts
+export { customClients, type AppClients } from './custom-clients';
+`, "utf-8");
+}
+/**
+* Generate the template's SCAPI surface (`custom-clients.ts`, `index.ts`, and any
+* per-override namespace wrappers) from `.meta.json` sidecars in `schemas/`.
+*
+* @param scapiDir - Absolute path to the src/scapi/ directory in the template project
+*/
+function generateCustomClientsFile(scapiDir) {
+	const entries = readAllSchemaMetadata(join(scapiDir, "schemas"));
+	writeCustomClientsFile(scapiDir, entries);
+	writeBarrelFile(scapiDir, entries);
+	for (const entry of entries) if (isOverride(entry)) writeOverrideNamespaceFile(scapiDir, entry);
+}
 
 //#endregion
 export { generateCustomClientsFile as t };

package/dist/hooks/init.js

@@ -48,6 +48,7 @@ async function initializePlugins() {
 * @env {string} [MRT_TARGET] - Target environment for MRT deployments
 */
 const hook = async function(opts) {
+	if (!(this.config.bin === "sfnext" || opts.id === "sfnext" || (opts.id?.startsWith("sfnext:") ?? false))) return;
 	const args = opts.argv ?? [];
 	let projectDir = process.cwd();
 	for (let i = 0; i < args.length; i++) {