@warlock.js/core 4.2.1 → 4.2.2

package/esm/production/production-builder.mjs

@@ -0,0 +1,264 @@
+import { appPath, warlockPath } from "../utils/paths.mjs";
+import "../utils/index.mjs";
+import { tsconfigManager } from "../dev-server/tsconfig-manager.mjs";
+import { nativeNodeModulesPlugin } from "./esbuild-plugins.mjs";
+import { resolveBuildConfig } from "./resolve-build-config.mjs";
+import path from "path";
+import { toCamelCase } from "@mongez/reinforcements";
+import { colors } from "@mongez/copper";
+import { ensureDirectoryAsync, fileExistsAsync, putFileAsync, removeDirectoryAsync } from "@warlock.js/fs";
+import glob from "fast-glob";
+import esbuild from "esbuild";
+
+//#region ../@warlock.js/core/src/production/production-builder.ts
+/**
+* Production Builder
+* Generates production-ready files and bundles them for deployment
+* Build options are loaded from warlock.config.ts
+*/
+var ProductionBuilder = class {
+	constructor() {
+		this.productionDir = warlockPath("production");
+		this.generatedFiles = {
+			locales: false,
+			events: false,
+			main: false,
+			routes: false
+		};
+	}
+	/**
+	* Main build entry point
+	*/
+	async build() {
+		console.log(colors.cyan("Building for production...\n"));
+		await this.initializeOptions();
+		await this.generateCombinedFiles();
+		await this.generateEntryPoint();
+		await this.bundle();
+		await removeDirectoryAsync(this.productionDir);
+		console.log(colors.green("Build complete!"));
+		console.log(`Start production server by running ${colors.cyan("warlock start")}`);
+	}
+	/**
+	* Initialize options from warlock.config.ts
+	*/
+	async initializeOptions() {
+		this.options = resolveBuildConfig();
+		await ensureDirectoryAsync(this.productionDir);
+	}
+	/**
+	* Generate all combined files
+	*/
+	async generateCombinedFiles() {
+		console.log(colors.yellow("   Generating production files..."));
+		await this.generateBootstrap();
+		await this.generateConfigLoader();
+		const [locales, events, main, routes] = await Promise.all([
+			this.generateLocales(),
+			this.generateEvents(),
+			this.generateMain(),
+			this.generateRoutes()
+		]);
+		this.generatedFiles = {
+			locales,
+			events,
+			main,
+			routes
+		};
+	}
+	/**
+	* Generate bootstrap.ts - ensures bootstrap() runs first and sets production environment
+	*/
+	async generateBootstrap() {
+		let content = `import { bootstrap, Application } from "@warlock.js/core";
+
+// Set production environment
+Application.setRuntimeStrategy("production");
+Application.setEnvironment("production");
+
+// Bootstrap the application
+bootstrap();
+`;
+		if (await fileExistsAsync(appPath("bootstrap.ts"))) content += "import './../../src/app/bootstrap';\n";
+		await putFileAsync(path.join(this.productionDir, "bootstrap.ts"), content);
+	}
+	/**
+	* Glob for module files matching a pattern
+	* Returns relative paths from .warlock/production/ to src/app/
+	*/
+	async globModule(fileName) {
+		return (await glob(`**/${fileName}.{ts,tsx}`, {
+			cwd: appPath(),
+			absolute: false
+		})).map((file) => "../../src/app/" + file.replace(/\.(ts|tsx)$/, ""));
+	}
+	/**
+	* Glob for files in a specific directory pattern
+	* Returns relative paths from .warlock/production/ to src/app/
+	*/
+	async globModuleDirectory(directory) {
+		return (await glob(`**/${directory}/*.{ts,tsx}`, {
+			cwd: appPath(),
+			absolute: false
+		})).map((file) => "../../src/app/" + file.replace(/\.(ts|tsx)$/, ""));
+	}
+	/**
+	* Generate config-loader.ts
+	*/
+	async generateConfigLoader() {
+		const configNames = (await glob("*.{ts,tsx}", {
+			cwd: path.join(process.cwd(), "src/config"),
+			absolute: false
+		})).map((f) => f.replace(/\.(ts|tsx)$/, ""));
+		const imports = ["import config from \"@mongez/config\";", "import { configSpecialHandlers } from \"@warlock.js/core\";"];
+		const configImports = [];
+		const configSetCalls = [];
+		const executors = [];
+		for (const configName of configNames) {
+			const properConfigName = toCamelCase(configName);
+			const varName = `${properConfigName}Config`;
+			configImports.push(`import ${varName} from "../../src/config/${configName}";`);
+			configSetCalls.push(`config.set("${properConfigName}", ${varName});`);
+			executors.push(`await configSpecialHandlers.execute("${properConfigName}", ${varName});`);
+		}
+		let content = [
+			...imports,
+			"",
+			"// Config imports",
+			...configImports,
+			"",
+			"// Register configs",
+			...configSetCalls,
+			"",
+			"// Special handlers",
+			...executors,
+			""
+		].join("\n");
+		if (await fileExistsAsync(appPath("prestart.ts"))) content += "import './../../src/app/prestart';\n";
+		await putFileAsync(path.join(this.productionDir, "config-loader.ts"), content);
+	}
+	/**
+	* Generate locales.ts (only if there are locale files)
+	* @returns true if file was generated with content
+	*/
+	async generateLocales() {
+		const files = await this.globModule("utils/locales");
+		if (files.length === 0) return false;
+		await this.generateImportsFile(files, "locales.ts");
+		return true;
+	}
+	/**
+	* Generate events.ts (only if there are event files)
+	* @returns true if file was generated with content
+	*/
+	async generateEvents() {
+		const files = await this.globModuleDirectory("events");
+		if (files.length === 0) return false;
+		await this.generateImportsFile(files, "events.ts");
+		return true;
+	}
+	/**
+	* Generate main.ts (only if there are main files)
+	* @returns true if file was generated with content
+	*/
+	async generateMain() {
+		const files = await this.globModule("main");
+		if (files.length === 0) return false;
+		await this.generateImportsFile(files, "main.ts");
+		return true;
+	}
+	/**
+	* Generate routes.ts (only if there are route files)
+	* @returns true if file was generated with content
+	*/
+	async generateRoutes() {
+		const files = await this.globModule("routes");
+		if (files.length === 0) return false;
+		await this.generateImportsFile(files, "routes.ts");
+		return true;
+	}
+	/**
+	* Generate a file with imports from all given files
+	*/
+	async generateImportsFile(importPaths, outputFile) {
+		const content = importPaths.map((importPath) => `import "${importPath}";`).join("\n") + "\n";
+		await putFileAsync(path.join(this.productionDir, outputFile), content);
+	}
+	/**
+	* Generate the main entry point (app.ts)
+	*/
+	async generateEntryPoint() {
+		console.log(colors.yellow("   Generating entry point..."));
+		const imports = [
+			"// 1. Bootstrap (loads .env, initializes framework)",
+			"import \"./bootstrap\";",
+			"",
+			"// 2. Load configs",
+			"import \"./config-loader\";",
+			"",
+			"// 3. Start early-phase connectors (database, cache, logger, ...)",
+			"//    so data sources, cache, etc. are ready before app code runs",
+			"import { connectorsManager, ConnectorLifecyclePhase } from \"@warlock.js/core\";",
+			"await connectorsManager.startPhase(ConnectorLifecyclePhase.Early);"
+		];
+		imports.push("", "// 4. Load app code (events, locales, main, routes)");
+		if (this.generatedFiles.events) imports.push("await import(\"./events\");");
+		if (this.generatedFiles.locales) imports.push("await import(\"./locales\");");
+		if (this.generatedFiles.main) imports.push("await import(\"./main\");");
+		if (this.generatedFiles.routes) imports.push("await import(\"./routes\");");
+		imports.push("", "// 5. Start late-phase connectors (http, socket) — routes and", "//    listeners registered by app code are now ready to bind", "await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);", "connectorsManager.shutdownOnProcessKill();");
+		const content = imports.join("\n") + "\n";
+		await putFileAsync(path.join(this.productionDir, "app.ts"), content);
+	}
+	/**
+	* Bundle with esbuild
+	*/
+	async bundle() {
+		console.log(colors.magenta("   Bundling with esbuild..."));
+		const entryPoint = path.join(this.productionDir, "app.ts");
+		const outDir = this.options.outDirectory;
+		const outFileName = this.options.outFile;
+		const entryName = path.basename(outFileName, path.extname(outFileName));
+		await ensureDirectoryAsync(outDir);
+		const alias = this.buildAliasMapFromTsconfig();
+		await esbuild.build({
+			platform: "node",
+			entryPoints: [entryPoint],
+			bundle: true,
+			splitting: true,
+			packages: "external",
+			minify: this.options.minify,
+			sourcemap: this.options.sourcemap === true ? "linked" : this.options.sourcemap,
+			format: "esm",
+			target: ["node22"],
+			outdir: outDir,
+			entryNames: entryName,
+			alias,
+			plugins: [nativeNodeModulesPlugin]
+		});
+	}
+	/**
+	* Build an alias map from tsconfig `paths` so esbuild resolves local
+	* source aliases (e.g. `@warlock.js/cascade`) to their on-disk source
+	* folders during bundling. Without this, `packages: "external"` would
+	* leave those bare specifiers as raw imports and Node would fail to
+	* resolve them at runtime (they aren't installed in node_modules).
+	*
+	* Only exact (non-wildcard) aliases are included — esbuild's `alias`
+	* option doesn't support glob-style mappings.
+	*/
+	buildAliasMapFromTsconfig() {
+		tsconfigManager.init();
+		const alias = {};
+		const baseUrl = path.resolve(process.cwd(), tsconfigManager.baseUrl);
+		for (const [from, to] of Object.entries(tsconfigManager.aliases)) {
+			if (from.endsWith("/*") || !Array.isArray(to) || to.length === 0) continue;
+			alias[from] = path.resolve(baseUrl, to[0]);
+		}
+		return alias;
+	}
+};
+
+//#endregion
+export { ProductionBuilder };
+//# sourceMappingURL=production-builder.mjs.map

package/esm/production/production-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-builder.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/production/production-builder.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport {\r\n  ensureDirectoryAsync,\r\n  fileExistsAsync,\r\n  putFileAsync,\r\n  removeDirectoryAsync,\r\n} from \"@warlock.js/fs\";\r\nimport esbuild from \"esbuild\";\r\nimport glob from \"fast-glob\";\r\nimport path from \"path\";\r\nimport { tsconfigManager } from \"../dev-server/tsconfig-manager\";\r\nimport { appPath, warlockPath } from \"../utils\";\r\nimport { nativeNodeModulesPlugin } from \"./esbuild-plugins\";\r\nimport { resolveBuildConfig, type ResolvedBuildConfig } from \"./resolve-build-config\";\r\nimport { toCamelCase, toKebabCase } from \"@mongez/reinforcements\";\r\n\r\n/**\r\n * Production Builder\r\n * Generates production-ready files and bundles them for deployment\r\n * Build options are loaded from warlock.config.ts\r\n */\r\nexport class ProductionBuilder {\r\n  private options!: ResolvedBuildConfig;\r\n  private readonly productionDir = warlockPath(\"production\");\r\n\r\n  /**\r\n   * Main build entry point\r\n   */\r\n  public async build(): Promise<void> {\r\n    console.log(colors.cyan(\"Building for production...\\n\"));\r\n\r\n    // Step 1: Initialize options from config\r\n    await this.initializeOptions();\r\n\r\n    // Step 2: Generate combined files\r\n    await this.generateCombinedFiles();\r\n\r\n    // Step 3: Generate entry point\r\n    await this.generateEntryPoint();\r\n\r\n    // Step 4: Bundle with esbuild\r\n    await this.bundle();\r\n\r\n    // // Step 5: Remove production folder\r\n    await removeDirectoryAsync(this.productionDir);\r\n\r\n    console.log(colors.green(\"Build complete!\"));\r\n    console.log(`Start production server by running ${colors.cyan(\"warlock start\")}`);\r\n  }\r\n\r\n  /**\r\n   * Initialize options from warlock.config.ts\r\n   */\r\n  private async initializeOptions(): Promise<void> {\r\n    this.options = resolveBuildConfig();\r\n\r\n    // Ensure production directory exists\r\n    await ensureDirectoryAsync(this.productionDir);\r\n  }\r\n\r\n  /**\r\n   * Track which special files were generated\r\n   */\r\n  private generatedFiles = {\r\n    locales: false,\r\n    events: false,\r\n    main: false,\r\n    routes: false,\r\n  };\r\n\r\n  /**\r\n   * Generate all combined files\r\n   */\r\n  private async generateCombinedFiles(): Promise<void> {\r\n    console.log(colors.yellow(\"   Generating production files...\"));\r\n\r\n    // Generate bootstrap.ts file\r\n    await this.generateBootstrap();\r\n\r\n    // Generate config loader\r\n    await this.generateConfigLoader();\r\n\r\n    // Generate special files and track which ones have content\r\n    const [locales, events, main, routes] = await Promise.all([\r\n      this.generateLocales(),\r\n      this.generateEvents(),\r\n      this.generateMain(),\r\n      this.generateRoutes(),\r\n    ]);\r\n\r\n    this.generatedFiles = { locales, events, main, routes };\r\n  }\r\n\r\n  /**\r\n   * Generate bootstrap.ts - ensures bootstrap() runs first and sets production environment\r\n   */\r\n  private async generateBootstrap(): Promise<void> {\r\n    let content = `import { bootstrap, Application } from \"@warlock.js/core\";\r\n\r\n// Set production environment\r\nApplication.setRuntimeStrategy(\"production\");\r\nApplication.setEnvironment(\"production\");\r\n\r\n// Bootstrap the application\r\nbootstrap();\r\n`;\r\n    if (await fileExistsAsync(appPath(\"bootstrap.ts\"))) {\r\n      content += \"import './../../src/app/bootstrap';\\n\";\r\n    }\r\n\r\n    await putFileAsync(path.join(this.productionDir, \"bootstrap.ts\"), content);\r\n  }\r\n\r\n  /**\r\n   * Glob for module files matching a pattern\r\n   * Returns relative paths from .warlock/production/ to src/app/\r\n   */\r\n  private async globModule(fileName: string): Promise<string[]> {\r\n    const pattern = `**/${fileName}.{ts,tsx}`;\r\n    const appDirectory = appPath();\r\n\r\n    const files = await glob(pattern, {\r\n      cwd: appDirectory,\r\n      absolute: false,\r\n    });\r\n\r\n    // Convert to relative paths from .warlock/production/ to src/app/\r\n    // e.g., \"users/main\" -> \"../../src/app/users/main\"\r\n    return files.map((file) => \"../../src/app/\" + file.replace(/\\.(ts|tsx)$/, \"\"));\r\n  }\r\n\r\n  /**\r\n   * Glob for files in a specific directory pattern\r\n   * Returns relative paths from .warlock/production/ to src/app/\r\n   */\r\n  private async globModuleDirectory(directory: string): Promise<string[]> {\r\n    const pattern = `**/${directory}/*.{ts,tsx}`;\r\n    const appDirectory = appPath();\r\n\r\n    const files = await glob(pattern, {\r\n      cwd: appDirectory,\r\n      absolute: false,\r\n    });\r\n\r\n    return files.map((file) => \"../../src/app/\" + file.replace(/\\.(ts|tsx)$/, \"\"));\r\n  }\r\n\r\n  /**\r\n   * Generate config-loader.ts\r\n   */\r\n  private async generateConfigLoader(): Promise<void> {\r\n    const configDirectory = path.join(process.cwd(), \"src/config\");\r\n\r\n    const files = await glob(\"*.{ts,tsx}\", {\r\n      cwd: configDirectory,\r\n      absolute: false,\r\n    });\r\n\r\n    const configNames = files.map((f) => f.replace(/\\.(ts|tsx)$/, \"\"));\r\n\r\n    const imports: string[] = [\r\n      'import config from \"@mongez/config\";',\r\n      'import { configSpecialHandlers } from \"@warlock.js/core\";',\r\n    ];\r\n    const configImports: string[] = [];\r\n    const configSetCalls: string[] = [];\r\n    const executors: string[] = [];\r\n\r\n    for (const configName of configNames) {\r\n      const properConfigName = toCamelCase(configName);\r\n      const varName = `${properConfigName}Config`;\r\n      configImports.push(`import ${varName} from \"../../src/config/${configName}\";`);\r\n      configSetCalls.push(`config.set(\"${properConfigName}\", ${varName});`);\r\n      executors.push(`await configSpecialHandlers.execute(\"${properConfigName}\", ${varName});`);\r\n    }\r\n\r\n    let content = [\r\n      ...imports,\r\n      \"\",\r\n      \"// Config imports\",\r\n      ...configImports,\r\n      \"\",\r\n      \"// Register configs\",\r\n      ...configSetCalls,\r\n      \"\",\r\n      \"// Special handlers\",\r\n      ...executors,\r\n      \"\",\r\n    ].join(\"\\n\");\r\n\r\n    if (await fileExistsAsync(appPath(\"prestart.ts\"))) {\r\n      content += \"import './../../src/app/prestart';\\n\";\r\n    }\r\n\r\n    await putFileAsync(path.join(this.productionDir, \"config-loader.ts\"), content);\r\n  }\r\n\r\n  /**\r\n   * Generate locales.ts (only if there are locale files)\r\n   * @returns true if file was generated with content\r\n   */\r\n  private async generateLocales(): Promise<boolean> {\r\n    const files = await this.globModule(\"utils/locales\");\r\n    if (files.length === 0) return false;\r\n    await this.generateImportsFile(files, \"locales.ts\");\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Generate events.ts (only if there are event files)\r\n   * @returns true if file was generated with content\r\n   */\r\n  private async generateEvents(): Promise<boolean> {\r\n    const files = await this.globModuleDirectory(\"events\");\r\n    if (files.length === 0) return false;\r\n    await this.generateImportsFile(files, \"events.ts\");\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Generate main.ts (only if there are main files)\r\n   * @returns true if file was generated with content\r\n   */\r\n  private async generateMain(): Promise<boolean> {\r\n    const files = await this.globModule(\"main\");\r\n    if (files.length === 0) return false;\r\n    await this.generateImportsFile(files, \"main.ts\");\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Generate routes.ts (only if there are route files)\r\n   * @returns true if file was generated with content\r\n   */\r\n  private async generateRoutes(): Promise<boolean> {\r\n    const files = await this.globModule(\"routes\");\r\n    if (files.length === 0) return false;\r\n    await this.generateImportsFile(files, \"routes.ts\");\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Generate a file with imports from all given files\r\n   */\r\n  private async generateImportsFile(importPaths: string[], outputFile: string): Promise<void> {\r\n    const imports = importPaths.map((importPath) => `import \"${importPath}\";`);\r\n    const content = imports.join(\"\\n\") + \"\\n\";\r\n    await putFileAsync(path.join(this.productionDir, outputFile), content);\r\n  }\r\n\r\n  /**\r\n   * Generate the main entry point (app.ts)\r\n   */\r\n  private async generateEntryPoint(): Promise<void> {\r\n    console.log(colors.yellow(\"   Generating entry point...\"));\r\n\r\n    // Build imports based on which files were generated\r\n    const imports: string[] = [\r\n      \"// 1. Bootstrap (loads .env, initializes framework)\",\r\n      'import \"./bootstrap\";',\r\n      \"\",\r\n      \"// 2. Load configs\",\r\n      'import \"./config-loader\";',\r\n      \"\",\r\n      \"// 3. Start early-phase connectors (database, cache, logger, ...)\",\r\n      \"//    so data sources, cache, etc. are ready before app code runs\",\r\n      'import { connectorsManager, ConnectorLifecyclePhase } from \"@warlock.js/core\";',\r\n      \"await connectorsManager.startPhase(ConnectorLifecyclePhase.Early);\",\r\n    ];\r\n\r\n    // App code uses dynamic `await import(...)` so each module's side\r\n    // effects fire at THIS point in execution. Static imports would be\r\n    // hoisted to module-instantiation time (before the early-phase await\r\n    // resolves), which is exactly the bug this split is meant to fix.\r\n    // Requires `splitting: true` in esbuild (set below in bundle()).\r\n    imports.push(\"\", \"// 4. Load app code (events, locales, main, routes)\");\r\n\r\n    if (this.generatedFiles.events) {\r\n      imports.push('await import(\"./events\");');\r\n    }\r\n    if (this.generatedFiles.locales) {\r\n      imports.push('await import(\"./locales\");');\r\n    }\r\n    if (this.generatedFiles.main) {\r\n      imports.push('await import(\"./main\");');\r\n    }\r\n    if (this.generatedFiles.routes) {\r\n      imports.push('await import(\"./routes\");');\r\n    }\r\n\r\n    // Start late-phase connectors after app code registers routes/listeners\r\n    imports.push(\r\n      \"\",\r\n      \"// 5. Start late-phase connectors (http, socket) — routes and\",\r\n      \"//    listeners registered by app code are now ready to bind\",\r\n      \"await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\",\r\n      \"connectorsManager.shutdownOnProcessKill();\",\r\n    );\r\n\r\n    const content = imports.join(\"\\n\") + \"\\n\";\r\n    await putFileAsync(path.join(this.productionDir, \"app.ts\"), content);\r\n  }\r\n\r\n  /**\r\n   * Bundle with esbuild\r\n   */\r\n  private async bundle(): Promise<void> {\r\n    console.log(colors.magenta(\"   Bundling with esbuild...\"));\r\n\r\n    const entryPoint = path.join(this.productionDir, \"app.ts\");\r\n    const outDir = this.options!.outDirectory!;\r\n    const outFileName = this.options!.outFile!;\r\n    // Strip extension so entryNames produces \"<base>.js\" via esbuild\r\n    const entryName = path.basename(outFileName, path.extname(outFileName));\r\n\r\n    await ensureDirectoryAsync(outDir);\r\n\r\n    const alias = this.buildAliasMapFromTsconfig();\r\n\r\n    await esbuild.build({\r\n      platform: \"node\",\r\n      entryPoints: [entryPoint],\r\n      bundle: true,\r\n      // Required so dynamic `await import(\"./main\")` in the generated\r\n      // app.ts produces separate chunks loaded at the runtime call site,\r\n      // instead of inlining the modules at instantiation time (which\r\n      // would defeat the early/late phase split).\r\n      splitting: true,\r\n      packages: \"external\",\r\n      minify: this.options!.minify,\r\n      sourcemap: this.options!.sourcemap === true ? \"linked\" : this.options!.sourcemap,\r\n      format: \"esm\",\r\n      // Targeting a concrete Node version (not \"esnext\") so esbuild\r\n      // transpiles TC39 stage 3 decorators into helpers — Node does not\r\n      // implement them natively yet.\r\n      target: [\"node22\"],\r\n      outdir: outDir,\r\n      entryNames: entryName,\r\n      alias,\r\n      plugins: [nativeNodeModulesPlugin],\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Build an alias map from tsconfig `paths` so esbuild resolves local\r\n   * source aliases (e.g. `@warlock.js/cascade`) to their on-disk source\r\n   * folders during bundling. Without this, `packages: \"external\"` would\r\n   * leave those bare specifiers as raw imports and Node would fail to\r\n   * resolve them at runtime (they aren't installed in node_modules).\r\n   *\r\n   * Only exact (non-wildcard) aliases are included — esbuild's `alias`\r\n   * option doesn't support glob-style mappings.\r\n   */\r\n  private buildAliasMapFromTsconfig(): Record<string, string> {\r\n    tsconfigManager.init();\r\n\r\n    const alias: Record<string, string> = {};\r\n    const baseUrl = path.resolve(process.cwd(), tsconfigManager.baseUrl);\r\n\r\n    for (const [from, to] of Object.entries(tsconfigManager.aliases)) {\r\n      if (from.endsWith(\"/*\") || !Array.isArray(to) || to.length === 0) {\r\n        continue;\r\n      }\r\n\r\n      alias[from] = path.resolve(baseUrl, to[0]);\r\n    }\r\n\r\n    return alias;\r\n  }\r\n}\r\n"],"mappings":"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"}

package/esm/production/resolve-build-config.mjs

@@ -0,0 +1,28 @@
+import { warlockConfigManager } from "../warlock-config/warlock-config.manager.mjs";
+import { defaultWarlockConfigurations } from "../warlock-config/default-configurations.mjs";
+import path from "path";
+
+//#region ../@warlock.js/core/src/production/resolve-build-config.ts
+/**
+* Resolve the build config with framework defaults applied.
+*
+* Both the production builder and `warlock start` call this so they
+* agree on where the bundle lives — previously each had its own local
+* fallbacks and they drifted (`.warlock/production` vs `dist`),
+* letting `build` and `start` look at different paths.
+*/
+function resolveBuildConfig() {
+	const userBuild = warlockConfigManager.get("build") ?? {};
+	const merged = {
+		...defaultWarlockConfigurations.build,
+		...userBuild
+	};
+	return {
+		...merged,
+		entryPath: path.resolve(merged.outDirectory, merged.outFile)
+	};
+}
+
+//#endregion
+export { resolveBuildConfig };
+//# sourceMappingURL=resolve-build-config.mjs.map

package/esm/production/resolve-build-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-build-config.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/production/resolve-build-config.ts"],"sourcesContent":["import path from \"path\";\nimport { defaultWarlockConfigurations } from \"../warlock-config/default-configurations\";\nimport type { WarlockConfig } from \"../warlock-config/types\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\n\nexport type ResolvedBuildConfig = Required<NonNullable<WarlockConfig[\"build\"]>> & {\n  /** Absolute path to the bundled entry file (`{outDirectory}/{outFile}`) */\n  entryPath: string;\n};\n\n/**\n * Resolve the build config with framework defaults applied.\n *\n * Both the production builder and `warlock start` call this so they\n * agree on where the bundle lives — previously each had its own local\n * fallbacks and they drifted (`.warlock/production` vs `dist`),\n * letting `build` and `start` look at different paths.\n */\nexport function resolveBuildConfig(): ResolvedBuildConfig {\n  const userBuild = warlockConfigManager.get(\"build\") ?? {};\n  const defaults = defaultWarlockConfigurations.build!;\n  const merged = { ...defaults, ...userBuild } as Required<NonNullable<WarlockConfig[\"build\"]>>;\n\n  return {\n    ...merged,\n    entryPath: path.resolve(merged.outDirectory, merged.outFile),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAkBA,SAAgB,qBAA0C;CACxD,MAAM,YAAY,qBAAqB,IAAI,OAAO,KAAK,CAAC;CAExD,MAAM,SAAS;EAAE,GADA,6BAA6B;EAChB,GAAG;CAAU;CAE3C,OAAO;EACL,GAAG;EACH,WAAW,KAAK,QAAQ,OAAO,cAAc,OAAO,OAAO;CAC7D;AACF"}

package/esm/utils/framework-vesion.mjs

@@ -6,10 +6,19 @@ import path from "node:path";
 * Cached version string
 */
 let cachedVersion = null;
+/**
+* Get the framework version from package.json (cached)
+*/
+async function getWarlockVersion() {
+	if (cachedVersion) return cachedVersion;
+	const version = (await getJsonFileAsync(path.join(import.meta.dirname, "./../../package.json"))).version.replace(/\^|\~/g, "");
+	cachedVersion = version;
+	return version;
+}
 function getFrameworkVersion() {
 	return cachedVersion;
 }
 
 //#endregion
-export { getFrameworkVersion };
+export { getFrameworkVersion, getWarlockVersion };
 //# sourceMappingURL=framework-vesion.mjs.map

package/esm/utils/framework-vesion.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"framework-vesion.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/framework-vesion.ts"],"sourcesContent":["import { getJsonFileAsync } from \"@warlock.js/fs\";\r\nimport path from \"node:path\";\r\n\r\n/**\r\n * Cached version string\r\n */\r\nlet cachedVersion: string | null = null;\r\n\r\n/**\r\n * Get the framework version from package.json (cached)\r\n */\r\nexport async function getWarlockVersion(): Promise<string> {\r\n  if (cachedVersion) return cachedVersion;\r\n\r\n  const frameworkPackageJson = (await getJsonFileAsync(\r\n    path.join(import.meta.dirname, \"./../../package.json\"),\r\n  )) as { version: string };\r\n\r\n  const version = frameworkPackageJson.version.replace(/\\^|\\~/g, \"\");\r\n  cachedVersion = version;\r\n  return version;\r\n}\r\n\r\nexport function getFrameworkVersion(): string | null {\r\n  return cachedVersion;\r\n}\r\n"],"mappings":";;;;;;;AAMA,IAAI,gBAA+B;AAiBnC,SAAgB,sBAAqC;CACnD,OAAO;AACT"}
+{"version":3,"file":"framework-vesion.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/utils/framework-vesion.ts"],"sourcesContent":["import { getJsonFileAsync } from \"@warlock.js/fs\";\r\nimport path from \"node:path\";\r\n\r\n/**\r\n * Cached version string\r\n */\r\nlet cachedVersion: string | null = null;\r\n\r\n/**\r\n * Get the framework version from package.json (cached)\r\n */\r\nexport async function getWarlockVersion(): Promise<string> {\r\n  if (cachedVersion) return cachedVersion;\r\n\r\n  const frameworkPackageJson = (await getJsonFileAsync(\r\n    path.join(import.meta.dirname, \"./../../package.json\"),\r\n  )) as { version: string };\r\n\r\n  const version = frameworkPackageJson.version.replace(/\\^|\\~/g, \"\");\r\n  cachedVersion = version;\r\n  return version;\r\n}\r\n\r\nexport function getFrameworkVersion(): string | null {\r\n  return cachedVersion;\r\n}\r\n"],"mappings":";;;;;;;AAMA,IAAI,gBAA+B;;;;AAKnC,eAAsB,oBAAqC;CACzD,IAAI,eAAe,OAAO;CAM1B,MAAM,WAAU,MAJoB,iBAClC,KAAK,KAAK,OAAO,KAAK,SAAS,sBAAsB,CACvD,EAEoC,CAAC,QAAQ,QAAQ,UAAU,EAAE;CACjE,gBAAgB;CAChB,OAAO;AACT;AAEA,SAAgB,sBAAqC;CACnD,OAAO;AACT"}

package/package.json

@@ -36,13 +36,13 @@
     "@mongez/slug": "^1.0.7",
     "@mongez/supportive-is": "^2.1.3",
     "@mongez/time-wizard": "^1.0.6",
-    "@warlock.js/auth": "4.2.1",
-    "@warlock.js/cache": "4.2.1",
-    "@warlock.js/cascade": "4.2.1",
-    "@warlock.js/context": "4.2.1",
-    "@warlock.js/logger": "4.2.1",
-    "@warlock.js/seal": "4.2.1",
-    "@warlock.js/fs": "4.2.1",
+    "@warlock.js/auth": "4.2.2",
+    "@warlock.js/cache": "4.2.2",
+    "@warlock.js/cascade": "4.2.2",
+    "@warlock.js/context": "4.2.2",
+    "@warlock.js/logger": "4.2.2",
+    "@warlock.js/seal": "4.2.2",
+    "@warlock.js/fs": "4.2.2",
     "chokidar": "^5.0.0",
     "dayjs": "^1.11.19",
     "es-module-lexer": "^2.0.0",
@@ -68,12 +68,12 @@
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
     "@react-email/render": "^2.0.5",
-    "@warlock.js/herald": "4.2.1"
+    "@warlock.js/herald": "4.2.2"
   },
   "bin": {
     "warlock": "bin/warlock.js"
   },
-  "version": "4.2.1",
+  "version": "4.2.2",
   "type": "module",
   "main": "./esm/index.mjs",
   "module": "./esm/index.mjs",
@@ -84,6 +84,12 @@
         "types": "./esm/index.d.mts",
         "default": "./esm/index.mjs"
       }
+    },
+    "./cli/start": {
+      "import": {
+        "types": "./esm/cli/start.d.mts",
+        "default": "./esm/cli/start.mjs"
+      }
     }
   }
 }