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

package/dist/schema-utils.js

@@ -0,0 +1,64 @@
+import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { extname, join } from "node:path";
+import YAML from "yaml";
+
+//#region src/scapi/schema-utils.ts
+/**
+* Convert an API name like "shopper-products" to a camelCase client key like "shopperProducts".
+*/
+function deriveClientKey(apiName) {
+	return apiName.replace(/-([a-z])/g, (_, char) => char.toUpperCase());
+}
+/**
+* Derive the SCAPI base path from an OpenAPI schema file.
+*
+* Parses the `servers[].url` field. SCAPI schemas typically have server URLs like:
+*   https://{shortCode}.api.commercecloud.salesforce.com/product/shopper-products/v1
+*
+* Returns the path portion (e.g., "/product/shopper-products/v1").
+*
+* @param schemaPath - Path to the OAS YAML/JSON file
+* @returns The derived base path, or undefined if it cannot be determined
+*/
+function deriveBasePath(schemaPath) {
+	const content = readFileSync(schemaPath, "utf-8");
+	const ext = extname(schemaPath).toLowerCase();
+	let schema;
+	if (ext === ".yaml" || ext === ".yml") schema = YAML.parse(content);
+	else schema = JSON.parse(content);
+	const servers = schema.servers;
+	if (!servers || servers.length === 0) return void 0;
+	const serverUrl = servers[0].url;
+	if (!serverUrl) return void 0;
+	try {
+		const normalizedUrl = serverUrl.replace(/\{[^}]+\}/g, "placeholder");
+		const pathname = new URL(normalizedUrl).pathname;
+		return pathname && pathname !== "/" ? pathname : void 0;
+	} catch {
+		if (serverUrl.startsWith("/") && serverUrl !== "/") return serverUrl;
+		return serverUrl.match(/(?:https?:\/\/[^/]+)?(\/.+)/)?.[1] ?? void 0;
+	}
+}
+/**
+* Read all .meta.json sidecars from a schemas directory.
+*/
+function readAllSchemaMetadata(schemasDir) {
+	if (!existsSync(schemasDir)) return [];
+	return readdirSync(schemasDir).filter((f) => f.endsWith(".meta.json")).map((f) => {
+		const content = JSON.parse(readFileSync(join(schemasDir, f), "utf-8"));
+		const schemaName = f.replace(".meta.json", "");
+		return {
+			...content,
+			schemaName
+		};
+	});
+}
+/**
+* Write a .meta.json sidecar for a schema file.
+*/
+function writeSchemaMetadata(schemasDir, schemaName, meta) {
+	writeFileSync(join(schemasDir, `${schemaName}.meta.json`), `${JSON.stringify(meta, null, 2)}\n`, "utf-8");
+}
+
+//#endregion
+export { writeSchemaMetadata as i, deriveClientKey as n, readAllSchemaMetadata as r, deriveBasePath as t };

package/dist/utils.js

@@ -3,7 +3,6 @@ import { execSync } from "child_process";
 import os from "os";
 import path from "path";
 import fs from "fs-extra";
-import dotenv from "dotenv";
 
 //#region src/utils.ts
 const getDefaultBuildDir = (targetDir) => path.join(targetDir, "build");
@@ -20,18 +19,11 @@ const getProjectPkg = (projectDir) => {
 	}
 };
 /**
-* Load .env file from project directory
-*/
-const loadEnvFile = (projectDir) => {
-	const envPath = path.join(projectDir, ".env");
-	if (fs.existsSync(envPath)) dotenv.config({ path: envPath });
-	else logger.warn("No .env file found");
-};
-/**
 * Get MRT configuration with priority logic: .env -> package.json -> defaults
+*
+* Note: .env loading is handled once at startup in the oclif init hook (src/hooks/init.ts) before any command runs.
 */
 const getMrtConfig = (projectDir) => {
-	loadEnvFile(projectDir);
 	const pkg = getProjectPkg(projectDir);
 	const defaultMrtProject = process.env.MRT_PROJECT ?? pkg.name;
 	if (!defaultMrtProject || defaultMrtProject.trim() === "") throw new Error("Project name couldn't be determined. Do one of these options:\n  1. Set MRT_PROJECT in your .env file, or\n  2. Ensure package.json has a valid \"name\" field.");
@@ -123,4 +115,4 @@ const generateEnvFile = (projectDir, configOverrides) => {
 };
 
 //#endregion
-export { getProjectDependencyTree as a, loadEnvFile as c, getMrtConfig as i, getDefaultBuildDir as n, getProjectPkg as o, getDefaultMessage as r, getPwaKitDependencies as s, generateEnvFile as t };
+export { getProjectDependencyTree as a, getMrtConfig as i, getDefaultBuildDir as n, getProjectPkg as o, getDefaultMessage as r, getPwaKitDependencies as s, generateEnvFile as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/storefront-next-dev",
-  "version": "0.3.1",
+  "version": "0.4.0-alpha.0",
   "description": "Dev and build tools for SFCC Storefront Next",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,6 +13,12 @@
         "default": "./dist/index.js"
       }
     },
+    "./data-store/local-provider": {
+      "import": {
+        "types": "./dist/data-store/local-provider.d.ts",
+        "default": "./dist/data-store/local-provider.js"
+      }
+    },
     "./logger": {
       "import": {
         "types": "./dist/logger/index.d.ts",
@@ -81,6 +87,15 @@
     "topics": {
       "extensions": {
         "description": "Manage storefront extensions"
+      },
+      "scapi": {
+        "description": "Manage custom SCAPI clients"
+      },
+      "config": {
+        "description": "Inspect and manage storefront configuration"
+      },
+      "locales": {
+        "description": "Manage locale and translation files"
       }
     }
   },
@@ -169,8 +184,7 @@
     "chalk": "^5.3.0",
     "compressible": "2.0.18",
     "compression": "^1.7.4",
-    "dotenv": "^16.4.7",
-    "express": "5.2.1",
+    "express": "5.1.0",
     "fs-extra": "^11.2.0",
     "glob": "^11.0.0",
     "handlebars": "4.7.8",
@@ -181,11 +195,13 @@
     "morgan": "^1.10.0",
     "negotiator": "1.0.0",
     "npm-run-path": "6.0.0",
+    "openapi-typescript": "7.10.1",
     "prompts": "2.4.2",
     "ts-morph": "^24.0.0",
     "tsdown": "^0.15.4",
     "tsx": "^4.20.5",
     "undici": "^6.21.3",
+    "yaml": "^2.8.2",
     "zod": "4.1.13"
   },
   "engines": {