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

package/dist/generate-custom-clients.js

@@ -0,0 +1,73 @@
+import { r as readAllSchemaMetadata } from "./schema-utils.js";
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+//#region src/scapi/generate-custom-clients.ts
+const COPYRIGHT_HEADER = `/**
+ * 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.
+ */`;
+/**
+* Generate the custom-clients.ts file in the template project.
+*
+* @param scapiDir - Absolute path to the src/scapi/ directory in the template project
+*/
+function generateCustomClientsFile(scapiDir) {
+	const entries = readAllSchemaMetadata(join(scapiDir, "schemas"));
+	const customClientsPath = join(scapiDir, "custom-clients.ts");
+	if (entries.length === 0) {
+		writeFileSync(customClientsPath, `${COPYRIGHT_HEADER}
+
+/**
+ * Custom SCAPI Clients — generated by \`sfnext scapi\`, do not edit manually.
+ *
+ * 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.
+ */
+export { type Clients as AppClients } from '@salesforce/storefront-next-runtime/scapi';
+
+export const customClients: never[] = [];
+`, "utf-8");
+		return;
+	}
+	const imports = [];
+	const typeEntries = [];
+	const clientEntries = [];
+	entries.forEach(({ clientKey, basePath, supportsLocale, orgPrefix, schemaName }, index) => {
+		imports.push(`import type { paths as P${index} } from './generated/${schemaName}';`, `import { operations as ops${index} } from './generated/${schemaName}.operations';`);
+		typeEntries.push(`    ${clientKey}: ProxyClient<Client<P${index}>, typeof ops${index}>;`);
+		clientEntries.push(`    { key: '${clientKey}', basePath: '${basePath}', ops: ops${index}, locale: ${supportsLocale}, orgPrefix: ${orgPrefix} },`);
+	});
+	writeFileSync(customClientsPath, `${COPYRIGHT_HEADER}
+
+/**
+ * Custom SCAPI Clients — generated by \`sfnext scapi\`, do not edit manually.
+ */
+import { type Client, type Clients, type MergeClients, type ProxyClient } from '@salesforce/storefront-next-runtime/scapi';
+
+${imports.join("\n")}
+
+export type AppClients = MergeClients<Clients, {
+${typeEntries.join("\n")}
+}>;
+
+export const customClients = [
+${clientEntries.join("\n")}
+] as const;
+`, "utf-8");
+}
+
+//#endregion
+export { generateCustomClientsFile as t };

package/dist/hooks/init.js

@@ -1,3 +1,5 @@
+import { n as PROJECT_DIRECTORY_FLAG, t as PROJECT_DIRECTORY_CHAR } from "../flags.js";
+import { join, resolve } from "node:path";
 import { B2CPluginManager } from "@salesforce/b2c-tooling-sdk/plugins";
 import { getLogger } from "@salesforce/b2c-tooling-sdk/logging";
 
@@ -34,11 +36,34 @@ async function initializePlugins() {
 /**
 * Oclif init hook — runs before any command executes.
 *
-* Discovers b2c-cli plugins (installed via `b2c plugins:install`) and registers
-* their middleware and config sources with the global registries. This ensures
-* all sfnext commands automatically benefit from installed b2c-cli plugins.
+* Resolves the project directory from --project-directory / -d early — before
+* oclif parses flags — and loads the project's .env file into process.env.
+* Using the hook instead of bin/run.js keeps the flag name as a single source
+* of truth (imported from flags.ts) and keeps run.js minimal.
+*
+* Also discovers b2c-cli plugins (installed via `b2c plugins:install`) and
+* registers their middleware and config sources with the global registries.
+*
+* @env {string} [MRT_PROJECT] - Project name for MRT deployments
+* @env {string} [MRT_TARGET] - Target environment for MRT deployments
 */
-const hook = async function() {
+const hook = async function(opts) {
+	const args = opts.argv ?? [];
+	let projectDir = process.cwd();
+	for (let i = 0; i < args.length; i++) {
+		if ((args[i] === `--${PROJECT_DIRECTORY_FLAG}` || args[i] === `-${PROJECT_DIRECTORY_CHAR}`) && args[i + 1] && !args[i + 1].startsWith("-")) {
+			projectDir = resolve(args[i + 1]);
+			break;
+		}
+		const m = args[i].match(/* @__PURE__ */ new RegExp(`^--${PROJECT_DIRECTORY_FLAG}=(.+)$`));
+		if (m) {
+			projectDir = resolve(m[1]);
+			break;
+		}
+	}
+	try {
+		process.loadEnvFile(join(projectDir, ".env"));
+	} catch {}
 	await initializePlugins();
 };
 var init_default = hook;

package/dist/index.d.ts

@@ -106,7 +106,7 @@ interface StorefrontNextTargetsConfig {
   eventInstrumentationValidator?: EventInstrumentationValidatorConfig | false;
 }
 /**
- * Storefront Next Vite plugin that powers the React Router RSC app.
+ * Storefront Next Vite plugin that powers the React Router app.
  * Supports building and optimizing for the managed runtime environment.
  *
  * @param config - Configuration options for the plugin
@@ -138,6 +138,50 @@ declare function transformTargetPlaceholderPlugin(): {
   } | null;
 };
 //#endregion
+//#region src/plugins/uiTargetDevMode.d.ts
+interface UITargetDevModeConfig {
+  /**
+   * Enable dev mode visual markers. Defaults to false.
+   * Set via VITE_UI_TARGET_DEV_MODE=true environment variable.
+   */
+  enabled?: boolean;
+  /**
+   * Build-time filter: only show targets matching a category prefix.
+   * Set via VITE_TARGET_FILTER_CATEGORY=pdp environment variable.
+   * @example filterCategory: 'pdp' — only shows targets whose id starts with "pdp."
+   */
+  filterCategory?: string;
+  /**
+   * Map of targetId → hint label for overlay grouping/filtering.
+   * Built from target-config.json at config time and injected into each dev marker
+   * as a __hint__ prop, which is emitted as a data-ui-target-hint DOM attribute.
+   * Example: { 'emailSignUp.consent.marketing': 't/my-branch/W-123', 'checkout.contactInfo': 'pr:1384' }
+   */
+  hintMap?: Record<string, string>;
+}
+/**
+ * Vite plugin that adds visual markers to UITarget components in development.
+ *
+ * PRODUCTION: This plugin is completely inactive - zero overhead.
+ * DEVELOPMENT: Transforms UITarget JSX to add visual debugging markers.
+ *
+ * @example
+ * // Source code:
+ * <UITarget targetId="pdp.loyalty.badge">
+ *   <Widget />
+ * </UITarget>
+ *
+ * // Transformed in DEV mode:
+ * <UITargetDevMarker
+ *   targetId="pdp.loyalty.badge"
+ *   __file__="/src/components/product.tsx"
+ *   __hasChildren__={true}
+ * >
+ *   <Widget />
+ * </UITargetDevMarker>
+ */
+declare function uiTargetDevModePlugin(config?: UITargetDevModeConfig): Plugin;
+//#endregion
 //#region src/plugins/hybridProxy.d.ts
 
 interface HybridProxyPluginOptions {
@@ -417,5 +461,5 @@ interface GenerateMetadataResult {
 }
 declare function generateMetadata(projectDirectory: string, metadataDirectory: string, options?: GenerateMetadataOptions): Promise<GenerateMetadataResult>;
 //#endregion
-export { type GenerateMetadataOptions, type GenerateMetadataResult, type HybridProxyPluginOptions, type StorefrontNextTargetsConfig, clearCache, createServer, storefrontNextTargets as default, extractPatterns, generateMetadata, hybridProxyPlugin, loadConfigFromEnv, loadProjectConfig, shouldRouteToNext, testPatterns, transformTargetPlaceholderPlugin, trimExtensions };
+export { type GenerateMetadataOptions, type GenerateMetadataResult, type HybridProxyPluginOptions, type StorefrontNextTargetsConfig, type UITargetDevModeConfig, clearCache, createServer, storefrontNextTargets as default, extractPatterns, generateMetadata, hybridProxyPlugin, loadConfigFromEnv, loadProjectConfig, shouldRouteToNext, testPatterns, transformTargetPlaceholderPlugin, trimExtensions, uiTargetDevModePlugin };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":["ExtensionMeta","ExtensionConfig","Record","default"],"sources":["../src/plugins/staticRegistry.ts","../src/plugins/eventInstrumentationValidator.ts","../src/storefront-next-targets.ts","../src/plugins/transformTargets.ts","../src/plugins/hybridProxy.ts","../src/plugins/ecdnMatcher.ts","../src/server/config.ts","../src/server/modes.ts","../src/server/index.ts","../src/extensibility/extension-config.d.ts","../src/extensibility/trim-extensions.ts","../src/cartridge-services/generate-cartridge.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 */\nexport type ExtensionMeta = {\n    name: string;\n    description: string;\n    installationInstructions: string;\n    uninstallationInstructions: string;\n    folder: string;\n    dependencies: string[];\n    defaultOn?: boolean;\n};\n\ndeclare const ExtensionConfig: {\n    extensions: Record<string, ExtensionMeta>;\n};\n\nexport default ExtensionConfig;\n"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":["ExtensionMeta","ExtensionConfig","Record","default"],"sources":["../src/plugins/staticRegistry.ts","../src/plugins/eventInstrumentationValidator.ts","../src/storefront-next-targets.ts","../src/plugins/transformTargets.ts","../src/plugins/uiTargetDevMode.ts","../src/plugins/hybridProxy.ts","../src/plugins/ecdnMatcher.ts","../src/server/config.ts","../src/server/modes.ts","../src/server/index.ts","../src/extensibility/extension-config.d.ts","../src/extensibility/trim-extensions.ts","../src/cartridge-services/generate-cartridge.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 */\nexport type ExtensionMeta = {\n    name: string;\n    description: string;\n    installationInstructions: string;\n    uninstallationInstructions: string;\n    folder: string;\n    dependencies: string[];\n    defaultOn?: boolean;\n};\n\ndeclare const ExtensionConfig: {\n    extensions: Record<string, ExtensionMeta>;\n};\n\nexport default ExtensionConfig;\n"],"mappings":"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"}