@salesforce/storefront-next-dev 0.2.0-alpha.2 → 0.3.0-alpha.0

package/dist/cartridge-services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/cartridge-services/generate-cartridge.ts"],"sourcesContent":[],"mappings":";;AA8vBA;;;AAIG,UA1Ec,uBAAA,CA0Ed;EAAO;;;;;;;;;;;;;;;;;;;;UAlDO,sBAAA;;;;;;iBA8CK,gBAAA,gEAGR,0BACX,QAAQ"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/cartridge-services/generate-cartridge.ts"],"sourcesContent":[],"mappings":";;AA80BA;;;AAIG,UA1Ec,uBAAA,CA0Ed;EAAO;;;;;;;;;;;;;;;;;;;;UAlDO,sBAAA;;;;;;iBA8CK,gBAAA,gEAGR,0BACX,QAAQ"}

package/dist/cartridge-services/index.js

@@ -6,7 +6,73 @@ import { existsSync, readFileSync, unlinkSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { randomUUID } from "node:crypto";
 import { npmRunPathEnv } from "npm-run-path";
+import chalk from "chalk";
 
+//#region src/utils/logger.ts
+const LEVEL_PRIORITY = {
+	error: 0,
+	warn: 1,
+	info: 2,
+	debug: 3
+};
+let overrideLevel;
+/**
+* Returns true when the `DEBUG` env var targets sfnext or is a general enable flag.
+* Avoids accidentally enabling debug mode when DEBUG is set for unrelated libraries
+* (e.g. `DEBUG=express:*`).
+*/
+function debugEnablesSfnext() {
+	const raw = process.env.DEBUG?.trim();
+	if (!raw) return false;
+	const normalized = raw.toLowerCase();
+	if ([
+		"1",
+		"true",
+		"yes",
+		"on"
+	].includes(normalized)) return true;
+	return raw.split(",").some((token) => {
+		const value = token.trim();
+		return value === "*" || value === "sfnext" || value === "sfnext:*";
+	});
+}
+function resolveLevel() {
+	if (overrideLevel) return overrideLevel;
+	const envLevel = process.env.MRT_LOG_LEVEL ?? process.env.SFCC_LOG_LEVEL;
+	if (envLevel && envLevel in LEVEL_PRIORITY) return envLevel;
+	if (debugEnablesSfnext()) return "debug";
+	if (process.env.NODE_ENV === "production") return "warn";
+	return "info";
+}
+function shouldLog(level) {
+	return LEVEL_PRIORITY[level] <= LEVEL_PRIORITY[resolveLevel()];
+}
+const logger = {
+	error(msg, ...args) {
+		if (!shouldLog("error")) return;
+		console.error(chalk.red("[sfnext:error]"), msg, ...args);
+	},
+	warn(msg, ...args) {
+		if (!shouldLog("warn")) return;
+		console.warn(chalk.yellow("[sfnext:warn]"), msg, ...args);
+	},
+	info(msg, ...args) {
+		if (!shouldLog("info")) return;
+		console.log(chalk.cyan("[sfnext:info]"), msg, ...args);
+	},
+	debug(msg, ...args) {
+		if (!shouldLog("debug")) return;
+		console.log(chalk.gray("[sfnext:debug]"), msg, ...args);
+	},
+	setLevel(level) {
+		overrideLevel = level;
+	},
+	getLevel() {
+		return resolveLevel();
+	}
+};
+
+//#endregion
 //#region src/cartridge-services/react-router-config.ts
 let isCliAvailable = null;
 function checkReactRouterCli(projectDirectory) {
@@ -76,7 +142,7 @@ function filePathToRoute(filePath, projectRoot) {
 		const routeFileNormalized = routeFilePosix.replace(/^\.\//, "");
 		if (filePathPosix.endsWith(routeFileNormalized) || filePathPosix.endsWith(`/${routeFileNormalized}`)) return route.path;
 	}
-	console.warn(`Warning: Could not find route for file: ${filePath}`);
+	logger.warn(`Could not find route for file: ${filePath}`);
 	return "/unknown";
 }
 /**
@@ -151,7 +217,7 @@ const TYPE_MAPPING = {
 function resolveAttributeType(decoratorType, tsMorphType, fieldName) {
 	if (decoratorType) {
 		if (!VALID_ATTRIBUTE_TYPES.includes(decoratorType)) {
-			console.error(`Error: Invalid attribute type '${decoratorType}' for field '${fieldName || "unknown"}'. Valid types are: ${VALID_ATTRIBUTE_TYPES.join(", ")}`);
+			logger.error(`Invalid attribute type '${decoratorType}' for field '${fieldName || "unknown"}'. Valid types are: ${VALID_ATTRIBUTE_TYPES.join(", ")}`);
 			process.exit(1);
 		}
 		return decoratorType;
@@ -176,6 +242,30 @@ function getTypeFromTsMorph(property, _sourceFile) {
 	} catch {}
 	return "string";
 }
+/**
+* Resolve a variable's initializer expression from the same source file,
+* unwrapping `as const` type assertions.
+*/
+function resolveVariableInitializer(sourceFile, name) {
+	const varDecl = sourceFile.getVariableDeclaration(name);
+	if (!varDecl) return void 0;
+	let initializer = varDecl.getInitializer();
+	if (initializer && Node.isAsExpression(initializer)) initializer = initializer.getExpression();
+	return initializer;
+}
+/**
+* Check whether an AST node is a type that `parseExpression` can resolve to a
+* concrete JS value (as opposed to falling through to `getText()`).
+*/
+function isResolvableLiteral(node) {
+	return Node.isStringLiteral(node) || Node.isNumericLiteral(node) || Node.isTrueLiteral(node) || Node.isFalseLiteral(node) || Node.isObjectLiteralExpression(node) || Node.isArrayLiteralExpression(node);
+}
+var UnresolvedConstantReferenceError = class extends Error {
+	constructor(reference) {
+		super(`Cannot resolve constant reference '${reference}'. Ensure the variable is declared in the same file as a literal value.`);
+		this.name = "UnresolvedConstantReferenceError";
+	}
+};
 function parseExpression(expression) {
 	if (Node.isStringLiteral(expression)) return expression.getLiteralValue();
 	else if (Node.isNumericLiteral(expression)) return expression.getLiteralValue();
@@ -183,7 +273,26 @@ function parseExpression(expression) {
 	else if (Node.isFalseLiteral(expression)) return false;
 	else if (Node.isObjectLiteralExpression(expression)) return parseNestedObject(expression);
 	else if (Node.isArrayLiteralExpression(expression)) return parseArrayLiteral(expression);
-	else return expression.getText();
+	else if (Node.isPropertyAccessExpression(expression)) {
+		const obj = expression.getExpression();
+		const propName = expression.getName();
+		if (Node.isIdentifier(obj)) {
+			const resolved = resolveVariableInitializer(expression.getSourceFile(), obj.getText());
+			if (resolved && Node.isObjectLiteralExpression(resolved)) {
+				const prop = resolved.getProperty(propName);
+				if (prop && Node.isPropertyAssignment(prop)) {
+					const propInit = prop.getInitializer();
+					if (propInit) return parseExpression(propInit);
+				}
+			}
+			throw new UnresolvedConstantReferenceError(expression.getText());
+		}
+		return expression.getText();
+	} else if (Node.isIdentifier(expression)) {
+		const resolved = resolveVariableInitializer(expression.getSourceFile(), expression.getText());
+		if (resolved && isResolvableLiteral(resolved)) return parseExpression(resolved);
+		return expression.getText();
+	} else return expression.getText();
 }
 function parseNestedObject(objectLiteral) {
 	const result = {};
@@ -195,7 +304,7 @@ function parseNestedObject(objectLiteral) {
 			if (initializer) result[name] = parseExpression(initializer);
 		}
 	} catch (error) {
-		console.warn(`Warning: Could not parse nested object: ${error.message}`);
+		logger.warn(`Could not parse nested object: ${error.message}`);
 		return result;
 	}
 	return result;
@@ -206,7 +315,7 @@ function parseArrayLiteral(arrayLiteral) {
 		const elements = arrayLiteral.getElements();
 		for (const element of elements) result.push(parseExpression(element));
 	} catch (error) {
-		console.warn(`Warning: Could not parse array literal: ${error.message}`);
+		logger.warn(`Could not parse array literal: ${error.message}`);
 	}
 	return result;
 }
@@ -239,7 +348,8 @@ function parseDecoratorArgs(decorator) {
 		}
 		return result;
 	} catch (error) {
-		console.warn(`Warning: Could not parse decorator arguments: ${error.message}`);
+		if (error instanceof UnresolvedConstantReferenceError) throw error;
+		logger.warn(`Could not parse decorator arguments: ${error.message}`);
 		return result;
 	}
 }
@@ -268,11 +378,15 @@ function extractAttributesFromSource(sourceFile, className) {
 			attributes.push(attribute);
 		}
 	} catch (error) {
-		console.warn(`Warning: Could not extract attributes from class ${className}: ${error.message}`);
+		if (error instanceof UnresolvedConstantReferenceError) throw error;
+		logger.warn(`Could not extract attributes from class ${className}: ${error.message}`);
 	}
 	return attributes;
 }
-function extractRegionDefinitionsFromSource(sourceFile, className) {
+function normalizeComponentTypeId(typeId, defaultGroup) {
+	return typeId.includes(".") ? typeId : `${defaultGroup}.${typeId}`;
+}
+function extractRegionDefinitionsFromSource(sourceFile, className, defaultComponentGroup = DEFAULT_COMPONENT_GROUP) {
 	const regionDefinitions = [];
 	try {
 		const classDeclaration = sourceFile.getClass(className);
@@ -291,8 +405,8 @@ function extractRegionDefinitionsFromSource(sourceFile, className) {
 							name: regionConfig.name || "Region"
 						};
 						if (regionConfig.componentTypes) regionDefinition.component_types = regionConfig.componentTypes;
-						if (Array.isArray(regionConfig.componentTypeInclusions)) regionDefinition.component_type_inclusions = regionConfig.componentTypeInclusions.map((incl) => ({ type_id: incl }));
-						if (Array.isArray(regionConfig.componentTypeExclusions)) regionDefinition.component_type_exclusions = regionConfig.componentTypeExclusions.map((excl) => ({ type_id: excl }));
+						if (Array.isArray(regionConfig.componentTypeInclusions)) regionDefinition.component_type_inclusions = regionConfig.componentTypeInclusions.map((incl) => ({ type_id: normalizeComponentTypeId(String(incl), defaultComponentGroup) }));
+						if (Array.isArray(regionConfig.componentTypeExclusions)) regionDefinition.component_type_exclusions = regionConfig.componentTypeExclusions.map((excl) => ({ type_id: normalizeComponentTypeId(String(excl), defaultComponentGroup) }));
 						if (regionConfig.maxComponents !== void 0) regionDefinition.max_components = regionConfig.maxComponents;
 						if (regionConfig.minComponents !== void 0) regionDefinition.min_components = regionConfig.minComponents;
 						if (regionConfig.allowMultiple !== void 0) regionDefinition.allow_multiple = regionConfig.allowMultiple;
@@ -303,7 +417,7 @@ function extractRegionDefinitionsFromSource(sourceFile, className) {
 			}
 		}
 	} catch (error) {
-		console.warn(`Warning: Could not extract region definitions from class ${className}: ${error.message}`);
+		logger.warn(`Warning: Could not extract region definitions from class ${className}: ${error.message}`);
 	}
 	return regionDefinitions;
 }
@@ -324,12 +438,13 @@ async function processComponentFile(filePath, _projectRoot) {
 				const className = classDeclaration.getName();
 				if (!className) continue;
 				const componentConfig = parseDecoratorArgs(componentDecorator);
+				const componentGroup = String(componentConfig.group || DEFAULT_COMPONENT_GROUP);
 				const attributes = extractAttributesFromSource(sourceFile, className);
-				const regionDefinitions = extractRegionDefinitionsFromSource(sourceFile, className);
+				const regionDefinitions = extractRegionDefinitionsFromSource(sourceFile, className, componentGroup);
 				const componentMetadata = {
 					typeId: componentConfig.id || className.toLowerCase(),
 					name: componentConfig.name || toHumanReadableName(className),
-					group: componentConfig.group || DEFAULT_COMPONENT_GROUP,
+					group: componentGroup,
 					description: componentConfig.description || `Custom component: ${className}`,
 					regionDefinitions,
 					attributes
@@ -337,11 +452,13 @@ async function processComponentFile(filePath, _projectRoot) {
 				components.push(componentMetadata);
 			}
 		} catch (error) {
-			console.warn(`Warning: Could not process file ${filePath}:`, error.message);
+			if (error instanceof UnresolvedConstantReferenceError) throw error;
+			logger.warn(`Could not process file ${filePath}:`, error.message);
 		}
 		return components;
 	} catch (error) {
-		console.warn(`Warning: Could not read file ${filePath}:`, error.message);
+		if (error instanceof UnresolvedConstantReferenceError) throw error;
+		logger.warn(`Could not read file ${filePath}:`, error.message);
 		return [];
 	}
 }
@@ -377,11 +494,11 @@ async function processPageTypeFile(filePath, projectRoot) {
 				pageTypes.push(pageTypeMetadata);
 			}
 		} catch (error) {
-			console.warn(`Warning: Could not process file ${filePath}:`, error.message);
+			logger.warn(`Could not process file ${filePath}:`, error.message);
 		}
 		return pageTypes;
 	} catch (error) {
-		console.warn(`Warning: Could not read file ${filePath}:`, error.message);
+		logger.warn(`Could not read file ${filePath}:`, error.message);
 		return [];
 	}
 }
@@ -404,11 +521,11 @@ async function processAspectFile(filePath, _projectRoot) {
 			};
 			aspects.push(aspectMetadata);
 		} catch (parseError) {
-			console.warn(`Warning: Could not parse JSON in file ${filePath}:`, parseError.message);
+			logger.warn(`Could not parse JSON in file ${filePath}:`, parseError.message);
 		}
 		return aspects;
 	} catch (error) {
-		console.warn(`Warning: Could not read file ${filePath}:`, error.message);
+		logger.warn(`Could not read file ${filePath}:`, error.message);
 		return [];
 	}
 }
@@ -437,7 +554,7 @@ async function generateComponentCartridge(component, outputDir, dryRun = false)
 		await writeFile(outputPath, JSON.stringify(cartridgeData, null, 2));
 	}
 	const prefix = dryRun ? "   - [DRY RUN]" : "   -";
-	console.log(`${prefix} ${String(component.typeId)}: ${String(component.name)} (${String(component.attributes.length)} attributes) → ${fileName}.json`);
+	logger.debug(`${prefix} ${String(component.typeId)}: ${String(component.name)} (${String(component.attributes.length)} attributes) → ${fileName}.json`);
 }
 async function generatePageTypeCartridge(pageType, outputDir, dryRun = false) {
 	const fileName = toCamelCaseFileName(pageType.name);
@@ -460,7 +577,7 @@ async function generatePageTypeCartridge(pageType, outputDir, dryRun = false) {
 		await writeFile(outputPath, JSON.stringify(cartridgeData, null, 2));
 	}
 	const prefix = dryRun ? "   - [DRY RUN]" : "   -";
-	console.log(`${prefix} ${String(pageType.name)}: ${String(pageType.description)} (${String(pageType.attributes.length)} attributes) → ${fileName}.json`);
+	logger.debug(`${prefix} ${String(pageType.name)}: ${String(pageType.description)} (${String(pageType.attributes.length)} attributes) → ${fileName}.json`);
 }
 async function generateAspectCartridge(aspect, outputDir, dryRun = false) {
 	const fileName = toCamelCaseFileName(aspect.id);
@@ -476,7 +593,7 @@ async function generateAspectCartridge(aspect, outputDir, dryRun = false) {
 		await writeFile(outputPath, JSON.stringify(cartridgeData, null, 2));
 	}
 	const prefix = dryRun ? "   - [DRY RUN]" : "   -";
-	console.log(`${prefix} ${String(aspect.name)}: ${String(aspect.description)} (${String(aspect.attributeDefinitions.length)} attributes) → ${fileName}.json`);
+	logger.debug(`${prefix} ${String(aspect.name)}: ${String(aspect.description)} (${String(aspect.attributeDefinitions.length)} attributes) → ${fileName}.json`);
 }
 /**
 * Runs ESLint with --fix on the specified directory to format JSON files.
@@ -484,20 +601,20 @@ async function generateAspectCartridge(aspect, outputDir, dryRun = false) {
 */
 function lintGeneratedFiles(metadataDir, projectRoot) {
 	try {
-		console.log("🔧 Running ESLint --fix on generated JSON files...");
+		logger.debug("🔧 Running ESLint --fix on generated JSON files...");
 		execSync(`npx eslint "${metadataDir}/**/*.json" --fix --no-error-on-unmatched-pattern`, {
 			cwd: projectRoot,
 			stdio: "pipe",
 			encoding: "utf-8"
 		});
-		console.log("✅ JSON files formatted successfully");
+		logger.debug("✅ JSON files formatted successfully");
 	} catch (error) {
 		const execError = error;
 		if (execError.status === 2) {
 			const errMsg = execError.stderr || execError.stdout || "Unknown error";
-			console.warn(`⚠️  Warning: Could not run ESLint --fix: ${errMsg}`);
-		} else if (execError.stderr && execError.stderr.includes("error")) console.warn(`⚠️  Warning: Some linting issues could not be auto-fixed. Run ESLint manually to review.`);
-		else console.log("✅ JSON files formatted successfully");
+			logger.warn(`⚠️  Could not run ESLint --fix: ${errMsg}`);
+		} else if (execError.stderr && execError.stderr.includes("error")) logger.warn(`⚠️  Some linting issues could not be auto-fixed. Run ESLint manually to review.`);
+		else logger.debug("✅ JSON files formatted successfully");
 	}
 }
 async function generateMetadata(projectDirectory, metadataDirectory, options) {
@@ -505,9 +622,9 @@ async function generateMetadata(projectDirectory, metadataDirectory, options) {
 		const filePaths = options?.filePaths;
 		const isIncrementalMode = filePaths && filePaths.length > 0;
 		const dryRun = options?.dryRun || false;
-		if (dryRun) console.log("🔍 [DRY RUN] Scanning for decorated components and page types...");
-		else if (isIncrementalMode) console.log(`🔍 Generating metadata for ${filePaths.length} specified file(s)...`);
-		else console.log("🔍 Generating metadata for decorated components and page types...");
+		if (dryRun) logger.debug("🔍 [DRY RUN] Scanning for decorated components and page types...");
+		else if (isIncrementalMode) logger.debug(`🔍 Generating metadata for ${filePaths.length} specified file(s)...`);
+		else logger.debug("🔍 Generating metadata for decorated components and page types...");
 		const projectRoot = resolve(projectDirectory);
 		const srcDir = join(projectRoot, "src");
 		const metadataDir = resolve(metadataDirectory);
@@ -516,7 +633,7 @@ async function generateMetadata(projectDirectory, metadataDirectory, options) {
 		const aspectsOutputDir = join(metadataDir, "aspects");
 		if (!dryRun) {
 			if (!isIncrementalMode) {
-				console.log("🗑️  Cleaning existing output directories...");
+				logger.debug("🗑️  Cleaning existing output directories...");
 				for (const outputDir of [
 					componentsOutputDir,
 					pagesOutputDir,
@@ -526,12 +643,12 @@ async function generateMetadata(projectDirectory, metadataDirectory, options) {
 						recursive: true,
 						force: true
 					});
-					console.log(`   - Deleted: ${outputDir}`);
+					logger.debug(`   - Deleted: ${outputDir}`);
 				} catch {
-					console.log(`   - Directory not found (skipping): ${outputDir}`);
+					logger.debug(`   - Directory not found (skipping): ${outputDir}`);
 				}
-			} else console.log("📝 Incremental mode: existing cartridge files will be preserved/overwritten");
-			console.log("📁 Creating output directories...");
+			} else logger.debug("📝 Incremental mode: existing cartridge files will be preserved/overwritten");
+			logger.debug("Creating output directories...");
 			for (const outputDir of [
 				componentsOutputDir,
 				pagesOutputDir,
@@ -542,16 +659,18 @@ async function generateMetadata(projectDirectory, metadataDirectory, options) {
 				try {
 					await access(outputDir);
 				} catch {
-					console.error(`❌ Error: Failed to create output directory ${outputDir}: ${error.message}`);
+					const err = error;
+					logger.error(`❌ Failed to create output directory ${outputDir}: ${err.message}`);
 					process.exit(1);
+					throw err;
 				}
 			}
-		} else if (isIncrementalMode) console.log(`📝 [DRY RUN] Would process ${filePaths.length} specific file(s)`);
-		else console.log("📝 [DRY RUN] Would clean and regenerate all metadata files");
+		} else if (isIncrementalMode) logger.debug(`📝 [DRY RUN] Would process ${filePaths.length} specific file(s)`);
+		else logger.debug("📝 [DRY RUN] Would clean and regenerate all metadata files");
 		let files = [];
 		if (isIncrementalMode && filePaths) {
 			files = filePaths.map((fp) => resolve(projectRoot, fp));
-			console.log(`📂 Processing ${files.length} specified file(s)...`);
+			logger.debug(`📂 Processing ${files.length} specified file(s)...`);
 		} else {
 			const scanDirectory = async (dir) => {
 				const entries = await readdir(dir, { withFileTypes: true });
@@ -576,7 +695,7 @@ async function generateMetadata(projectDirectory, metadataDirectory, options) {
 			allAspects.push(...aspects);
 		}
 		if (allComponents.length === 0 && allPageTypes.length === 0 && allAspects.length === 0) {
-			console.log("⚠️  No decorated components, page types, or aspect files found.");
+			logger.info("⚠️  No decorated components, page types, or aspect files found.");
 			return {
 				componentsGenerated: 0,
 				pageTypesGenerated: 0,
@@ -585,22 +704,22 @@ async function generateMetadata(projectDirectory, metadataDirectory, options) {
 			};
 		}
 		if (allComponents.length > 0) {
-			console.log(`✅ Found ${allComponents.length} decorated component(s):`);
+			logger.debug(`✅ Found ${allComponents.length} decorated component(s)`);
 			for (const component of allComponents) await generateComponentCartridge(component, componentsOutputDir, dryRun);
-			if (dryRun) console.log(`📄 [DRY RUN] Would generate ${allComponents.length} component metadata file(s) in: ${componentsOutputDir}`);
-			else console.log(`📄 Generated ${allComponents.length} component metadata file(s) in: ${componentsOutputDir}`);
+			if (dryRun) logger.info(`[DRY RUN] Would generate ${allComponents.length} component metadata file(s)`);
+			else logger.info(`Generated ${allComponents.length} component metadata file(s)`);
 		}
 		if (allPageTypes.length > 0) {
-			console.log(`✅ Found ${allPageTypes.length} decorated page type(s):`);
+			logger.debug(`✅ Found ${allPageTypes.length} decorated page type(s)`);
 			for (const pageType of allPageTypes) await generatePageTypeCartridge(pageType, pagesOutputDir, dryRun);
-			if (dryRun) console.log(`📄 [DRY RUN] Would generate ${allPageTypes.length} page type metadata file(s) in: ${pagesOutputDir}`);
-			else console.log(`📄 Generated ${allPageTypes.length} page type metadata file(s) in: ${pagesOutputDir}`);
+			if (dryRun) logger.info(`[DRY RUN] Would generate ${allPageTypes.length} page type metadata file(s)`);
+			else logger.info(`Generated ${allPageTypes.length} page type metadata file(s)`);
 		}
 		if (allAspects.length > 0) {
-			console.log(`✅ Found ${allAspects.length} decorated aspect(s):`);
+			logger.debug(`✅ Found ${allAspects.length} decorated aspect(s)`);
 			for (const aspect of allAspects) await generateAspectCartridge(aspect, aspectsOutputDir, dryRun);
-			if (dryRun) console.log(`📄 [DRY RUN] Would generate ${allAspects.length} aspect metadata file(s) in: ${aspectsOutputDir}`);
-			else console.log(`📄 Generated ${allAspects.length} aspect metadata file(s) in: ${aspectsOutputDir}`);
+			if (dryRun) logger.info(`[DRY RUN] Would generate ${allAspects.length} aspect metadata file(s)`);
+			else logger.info(`Generated ${allAspects.length} aspect metadata file(s)`);
 		}
 		const shouldLintFix = options?.lintFix !== false;
 		if (!dryRun && shouldLintFix && (allComponents.length > 0 || allPageTypes.length > 0 || allAspects.length > 0)) lintGeneratedFiles(metadataDir, projectRoot);
@@ -611,8 +730,10 @@ async function generateMetadata(projectDirectory, metadataDirectory, options) {
 			totalFiles: allComponents.length + allPageTypes.length + allAspects.length
 		};
 	} catch (error) {
-		console.error("❌ Error:", error.message);
+		const err = error;
+		logger.error("❌ Error:", err.message);
 		process.exit(1);
+		throw err;
 	}
 }