@warlock.js/core 5.29.0 → 5.31.0

package/esm/warlock-config/warlock-config.manager.mjs

@@ -1,12 +1,20 @@
 import { rootPath } from "../utils/paths.mjs";
 import "../utils/index.mjs";
+import { bundleWarlockConfig } from "./bundle-config.mjs";
 import { getDeprecatedConfigWarnings } from "./warn-deprecated-config.mjs";
+import path from "node:path";
 import { get } from "@mongez/reinforcements";
 import { fileExistsAsync } from "@warlock.js/fs";
-import { readFile, unlink, writeFile } from "node:fs/promises";
+import { unlink, writeFile } from "node:fs/promises";
+import { getTsconfig } from "get-tsconfig";
 import { pathToFileURL } from "url";
 
-//#region ../core/src/warlock-config/warlock-config.manager.ts
+//#region ../../packages/core/src/warlock-config/warlock-config.manager.ts
+/**
+* `Error` with the ES2022 `cause` option, typed for packages still compiled
+* against an older lib (see `application.ts`).
+*/
+const ErrorWithCause = Error;
 /**
 * True when `error` is Node's "this runtime can't import a `.ts` file" error.
 *
@@ -19,6 +27,52 @@ function isUnknownTsExtensionError(error) {
 	return error?.code === "ERR_UNKNOWN_FILE_EXTENSION" || /Unknown file extension "\.tsx?"/.test(String(error?.message));
 }
 /**
+* True when `error` is Node failing to RESOLVE an import of the config's OWN
+* graph: an extensionless relative import (`./src/connectors/local`), a
+* directory import, or a tsconfig `paths` alias (`app/connectors`) — all of
+* which only a TypeScript toolchain resolves. Native type stripping
+* (Node ≥ 22.18) loads `warlock.config.ts` itself, then fails here.
+*
+* A package that is genuinely not installed is NOT a fallback case: the error
+* names a bare specifier that matches no `paths` pattern, and it is rethrown
+* as is. Neither is a missing module imported from inside `node_modules`.
+*
+* `pathAliases` are the tsconfig `paths` patterns (`app/*`). When the message
+* cannot be parsed the error is treated as a graph error, as before.
+*/
+function isUnresolvedConfigImportError(error, pathAliases = []) {
+	const code = error?.code;
+	if (code === "ERR_UNSUPPORTED_DIR_IMPORT") return true;
+	if (code !== "ERR_MODULE_NOT_FOUND") return false;
+	const message = String(error?.message ?? "");
+	const match = /Cannot find (module|package) '([^']+)' imported from (.+)$/m.exec(message);
+	if (!match) return true;
+	const [, kind, specifier = "", importer = ""] = match;
+	if (/[\\/]node_modules[\\/]/.test(importer)) return false;
+	if (kind === "module") return true;
+	return pathAliases.some((pattern) => aliasCovers(pattern, specifier));
+}
+/**
+* True when `error` is native type stripping refusing TypeScript it cannot
+* strip (an `enum`, a `namespace`, a parameter property) or a `.ts` file under
+* `node_modules`. Both are raised while loading, before the graph runs.
+*/
+function isUnsupportedTypeStrippingError(error) {
+	const code = error?.code;
+	return code === "ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX" || code === "ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING";
+}
+/**
+* True when a tsconfig `paths` pattern can produce `packageName` as the first
+* segment(s) of a specifier: `app/*` covers `app`, `@shared/*` covers
+* `@shared`, a catch-all `*` covers anything.
+*/
+function aliasCovers(pattern, packageName) {
+	const star = pattern.indexOf("*");
+	const prefix = star === -1 ? pattern : pattern.slice(0, star);
+	if (prefix === "") return true;
+	return prefix === packageName || prefix.startsWith(`${packageName}/`) || packageName.startsWith(prefix);
+}
+/**
 * Warlock Config Manager
 *
 * Manages lazy loading of the pre-compiled warlock.config.js file
@@ -54,30 +108,30 @@ var WarlockConfigManager = class {
 		try {
 			return (await import(pathToFileURL(configPath).href)).default;
 		} catch (error) {
-			if (isUnknownTsExtensionError(error)) return await this.loadViaEsbuild(configPath);
-			throw new Error(`Failed to load warlock.config.ts: ${error}`);
+			if (isUnknownTsExtensionError(error) || isUnsupportedTypeStrippingError(error) || isUnresolvedConfigImportError(error, configPathAliases(configPath))) return await this.loadViaEsbuild(configPath);
+			throw new ErrorWithCause(`Failed to load warlock.config.ts: ${error}`, { cause: error });
 		}
 	}
 	/**
-	* Fallback config loader for runtimes without native TypeScript support.
+	* Fallback config loader for runtimes that cannot import the config as written.
 	*
-	* Transpiles `warlock.config.ts` with esbuild (already a core dependency),
-	* writes the result as a sibling `.mjs` — so the config's own imports (bare
-	* `@warlock.js/*` and any relative paths) resolve exactly as they would from
-	* the original location — imports it, then removes the temp file.
+	* Bundles `warlock.config.ts` with its LOCAL import graph (relative imports,
+	* extensionless TS imports, tsconfig `paths` aliases) through esbuild, keeping
+	* every package external so `BaseConnector`, the container and other
+	* registries keep the application's identity (see `bundleWarlockConfig`).
+	* The bundle is written as a sibling `.mjs` — so its external imports resolve
+	* from the project exactly as they would from the original config — imported
+	* once, then removed whether it loaded or threw. An error thrown by the
+	* user's config propagates unchanged.
 	*/
 	async loadViaEsbuild(configPath) {
-		const { transformSync } = await import("esbuild");
-		const { code } = transformSync(await readFile(configPath, "utf8"), {
-			loader: "ts",
-			format: "esm",
-			target: `node${process.versions.node.split(".")[0]}`,
-			sourcefile: configPath
-		});
-		const compiledPath = configPath.replace(/warlock\.config\.ts$/, `.warlock.config.${process.pid}.mjs`);
+		const code = await bundleWarlockConfig(configPath);
+		const compiledPath = configPath.replace(/warlock\.config\.ts$/, `.warlock.config.${process.pid}.${Date.now()}.mjs`);
 		await writeFile(compiledPath, code, "utf8");
 		try {
 			return (await import(pathToFileURL(compiledPath).href)).default;
+		} catch (error) {
+			throw nameOriginalConfig(error, compiledPath, configPath);
 		} finally {
 			await unlink(compiledPath).catch(() => {});
 		}
@@ -136,6 +190,28 @@ var WarlockConfigManager = class {
 	}
 };
 /**
+* The tsconfig `paths` patterns of the project holding `configPath`.
+*/
+function configPathAliases(configPath) {
+	try {
+		return Object.keys(getTsconfig(path.dirname(configPath))?.config.compilerOptions?.paths ?? {});
+	} catch {
+		return [];
+	}
+}
+/**
+* A loader error raised by the bundled config names the temporary `.mjs`
+* module. Rewrite it to name `warlock.config.ts`, keeping the original as the
+* cause. An error thrown by the user's own config is returned unchanged.
+*/
+function nameOriginalConfig(error, compiledPath, configPath) {
+	const code = error?.code;
+	if (typeof code !== "string" || !code.startsWith("ERR_")) return error;
+	const wrapped = new ErrorWithCause(`Failed to load warlock.config.ts: ${String(error.message ?? error).split(pathToFileURL(compiledPath).href).join(pathToFileURL(configPath).href).split(compiledPath).join(configPath)}`, { cause: error });
+	wrapped.code = code;
+	return wrapped;
+}
+/**
 * Exported singleton instance
 *
 * @example
@@ -151,5 +227,5 @@ var WarlockConfigManager = class {
 const warlockConfigManager = new WarlockConfigManager();
 
 //#endregion
-export { WarlockConfigManager, isUnknownTsExtensionError, warlockConfigManager };
+export { WarlockConfigManager, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager };
 //# sourceMappingURL=warlock-config.manager.mjs.map

package/esm/warlock-config/warlock-config.manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"warlock-config.manager.mjs","names":[],"sources":["../../../../../../../core/src/warlock-config/warlock-config.manager.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { get } from \"@mongez/reinforcements\";\nimport { readFile, unlink, writeFile } from \"node:fs/promises\";\nimport { pathToFileURL } from \"url\";\nimport { rootPath } from \"../utils\";\nimport { type WarlockConfig } from \"./types\";\nimport { getDeprecatedConfigWarnings } from \"./warn-deprecated-config\";\n\n/**\n * True when `error` is Node's \"this runtime can't import a `.ts` file\" error.\n *\n * Node only executes TypeScript natively from v22.18 / v23.6 onward (earlier\n * 22.x needs `--experimental-strip-types`). On older runtimes a bare\n * `import(\"warlock.config.ts\")` throws `ERR_UNKNOWN_FILE_EXTENSION` — which is\n * the signal to fall back to transpiling the config ourselves.\n */\nexport function isUnknownTsExtensionError(error: unknown): boolean {\n  return (\n    (error as { code?: string })?.code === \"ERR_UNKNOWN_FILE_EXTENSION\" ||\n    /Unknown file extension \"\\.tsx?\"/.test(String((error as Error)?.message))\n  );\n}\n\n/**\n * Warlock Config Manager\n *\n * Manages lazy loading of the pre-compiled warlock.config.js file\n * from the .warlock/cache directory.\n */\nexport class WarlockConfigManager {\n  /**\n   * Cached config instance\n   */\n  private config?: WarlockConfig;\n\n  /**\n   * Loading promise to prevent duplicate loads\n   */\n  private loading?: Promise<WarlockConfig | undefined>;\n\n  /**\n   * Load warlock.config.js (cached after first load)\n   *\n   * @returns The resolved Warlock configuration\n   */\n  public async load(): Promise<WarlockConfig | undefined> {\n    // Already loaded\n    if (this.config) {\n      return this.config;\n    }\n\n    // Currently loading (prevent duplicate loads)\n    if (this.loading) {\n      return this.loading;\n    }\n\n    // Start loading\n    this.loading = this.doLoad();\n    this.config = await this.loading;\n    this.loading = undefined;\n\n    // Console, not the logger: this runs before any log channel exists.\n    for (const warning of getDeprecatedConfigWarnings(this.config)) {\n      console.warn(warning);\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Internal load implementation\n   *\n   * The ESM loader hook transpiles `warlock.config.ts` on import — no\n   * separate compile-to-disk step is needed.\n   */\n  private async doLoad(): Promise<WarlockConfig | undefined> {\n    const configPath = rootPath(\"warlock.config.ts\");\n\n    if (!(await fileExistsAsync(configPath))) {\n      // Written straight to the console, NOT through `@warlock.js/logger`.\n      // This runs during CLI bootstrap, before `LoggerConnector.start()` has\n      // configured a single channel, so a logger call here reaches nobody in\n      // any application — the warning would be silently dropped exactly when\n      // the user most needs it.\n      console.warn(\n        \"warlock.config.ts is missing — create it at the project root (see https://warlock.js.org/docs for the config reference)\",\n      );\n      return;\n    }\n\n    try {\n      const configModule = await import(pathToFileURL(configPath).href);\n      return configModule.default;\n    } catch (error) {\n      // `dev` registers a TS loader hook, and Node ≥ 22.18 / 23.6 strips types\n      // natively — in both cases the direct import above works. But `build` /\n      // `start` register no hook, so on an older Node the import throws\n      // ERR_UNKNOWN_FILE_EXTENSION. Transpile the config with esbuild ourselves\n      // so config loading is Node-version-independent rather than relying on an\n      // experimental runtime feature.\n      if (isUnknownTsExtensionError(error)) {\n        return await this.loadViaEsbuild(configPath);\n      }\n\n      throw new Error(`Failed to load warlock.config.ts: ${error}`);\n    }\n  }\n\n  /**\n   * Fallback config loader for runtimes without native TypeScript support.\n   *\n   * Transpiles `warlock.config.ts` with esbuild (already a core dependency),\n   * writes the result as a sibling `.mjs` — so the config's own imports (bare\n   * `@warlock.js/*` and any relative paths) resolve exactly as they would from\n   * the original location — imports it, then removes the temp file.\n   */\n  private async loadViaEsbuild(configPath: string): Promise<WarlockConfig | undefined> {\n    const { transformSync } = await import(\"esbuild\");\n    const source = await readFile(configPath, \"utf8\");\n\n    const { code } = transformSync(source, {\n      loader: \"ts\",\n      format: \"esm\",\n      target: `node${process.versions.node.split(\".\")[0]}`,\n      sourcefile: configPath,\n    });\n\n    // Unique sibling name so concurrent processes never clobber each other.\n    const compiledPath = configPath.replace(\n      /warlock\\.config\\.ts$/,\n      `.warlock.config.${process.pid}.mjs`,\n    );\n\n    await writeFile(compiledPath, code, \"utf8\");\n\n    try {\n      const configModule = await import(pathToFileURL(compiledPath).href);\n      return configModule.default;\n    } finally {\n      await unlink(compiledPath).catch(() => {});\n    }\n  }\n\n  /**\n   * Get config value by key (dot notation supported)\n   *\n   * @example\n   * config.get(\"server.port\") // Returns 3000\n   * config.get(\"cli.commands\") // Returns array of commands\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @returns The config value\n   * @throws Error if config is not loaded\n   */\n  public get<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): WarlockConfig[Key] {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return get(this.config, key as string, defaultValue);\n  }\n\n  /**\n   * Lazy get - loads config if not already loaded\n   *\n   * @example\n   * const port = await config.lazyGet(\"server\");\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @param defaultValue - Default value if config key is undefined\n   * @returns The config value\n   */\n  async lazyGet<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): Promise<WarlockConfig[Key]> {\n    await this.load();\n    return this.get(key, defaultValue);\n  }\n\n  /**\n   * Check if config is loaded\n   */\n  public get isLoaded(): boolean {\n    return this.config !== undefined;\n  }\n\n  /**\n   * Get the entire config object\n   *\n   * @throws Error if config is not loaded\n   */\n  public getAll(): WarlockConfig {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Reload config (useful for HMR/development)\n   */\n  public async reload(): Promise<void> {\n    this.config = undefined;\n    this.loading = undefined;\n    await this.load();\n  }\n}\n\n/**\n * Exported singleton instance\n *\n * @example\n * import { warlockConfig } from \"@warlock.js/core\";\n *\n * // Lazy load and get value\n * const port = await warlockConfig.lazyGet(\"server.port\");\n *\n * // Or load first, then get\n * await warlockConfig.load();\n * const commands = warlockConfig.get(\"cli.commands\");\n */\nexport const warlockConfigManager = new WarlockConfigManager();\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,SAAgB,0BAA0B,OAAyB;CACjE,OACG,OAA6B,SAAS,gCACvC,kCAAkC,KAAK,OAAQ,OAAiB,OAAO,CAAC;AAE5E;;;;;;;AAQA,IAAa,uBAAb,MAAkC;;;;;;CAgBhC,MAAa,OAA2C;EAEtD,IAAI,KAAK,QACP,OAAO,KAAK;EAId,IAAI,KAAK,SACP,OAAO,KAAK;EAId,KAAK,UAAU,KAAK,OAAO;EAC3B,KAAK,SAAS,MAAM,KAAK;EACzB,KAAK,UAAU;EAGf,KAAK,MAAM,WAAW,4BAA4B,KAAK,MAAM,GAC3D,QAAQ,KAAK,OAAO;EAGtB,OAAO,KAAK;CACd;;;;;;;CAQA,MAAc,SAA6C;EACzD,MAAM,aAAa,SAAS,mBAAmB;EAE/C,IAAI,CAAE,MAAM,gBAAgB,UAAU,GAAI;GAMxC,QAAQ,KACN,yHACF;GACA;EACF;EAEA,IAAI;GAEF,QAAO,MADoB,OAAO,cAAc,UAAU,CAAC,CAAC,MACzC,CAAC;EACtB,SAAS,OAAO;GAOd,IAAI,0BAA0B,KAAK,GACjC,OAAO,MAAM,KAAK,eAAe,UAAU;GAG7C,MAAM,IAAI,MAAM,qCAAqC,OAAO;EAC9D;CACF;;;;;;;;;CAUA,MAAc,eAAe,YAAwD;EACnF,MAAM,EAAE,kBAAkB,MAAM,OAAO;EAGvC,MAAM,EAAE,SAAS,cAAc,MAFV,SAAS,YAAY,MAAM,GAET;GACrC,QAAQ;GACR,QAAQ;GACR,QAAQ,OAAO,QAAQ,SAAS,KAAK,MAAM,GAAG,CAAC,CAAC;GAChD,YAAY;EACd,CAAC;EAGD,MAAM,eAAe,WAAW,QAC9B,wBACA,mBAAmB,QAAQ,IAAI,KACjC;EAEA,MAAM,UAAU,cAAc,MAAM,MAAM;EAE1C,IAAI;GAEF,QAAO,MADoB,OAAO,cAAc,YAAY,CAAC,CAAC,MAC3C,CAAC;EACtB,UAAU;GACR,MAAM,OAAO,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC;EAC3C;CACF;;;;;;;;;;;;CAaA,AAAO,IACL,KACA,cACoB;EACpB,IAAI,CAAC,KAAK,QACR,MAAM,IAAI,MAAM,+DAA+D;EAGjF,OAAO,IAAI,KAAK,QAAQ,KAAe,YAAY;CACrD;;;;;;;;;;;CAYA,MAAM,QACJ,KACA,cAC6B;EAC7B,MAAM,KAAK,KAAK;EAChB,OAAO,KAAK,IAAI,KAAK,YAAY;CACnC;;;;CAKA,IAAW,WAAoB;EAC7B,OAAO,KAAK,WAAW;CACzB;;;;;;CAOA,AAAO,SAAwB;EAC7B,IAAI,CAAC,KAAK,QACR,MAAM,IAAI,MAAM,+DAA+D;EAGjF,OAAO,KAAK;CACd;;;;CAKA,MAAa,SAAwB;EACnC,KAAK,SAAS;EACd,KAAK,UAAU;EACf,MAAM,KAAK,KAAK;CAClB;AACF;;;;;;;;;;;;;;AAeA,MAAa,uBAAuB,IAAI,qBAAqB"}
+{"version":3,"file":"warlock-config.manager.mjs","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warlock-config.manager.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { get } from \"@mongez/reinforcements\";\nimport { getTsconfig } from \"get-tsconfig\";\nimport { unlink, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"url\";\nimport { rootPath } from \"../utils\";\nimport { bundleWarlockConfig } from \"./bundle-config\";\nimport { type WarlockConfig } from \"./types\";\nimport { getDeprecatedConfigWarnings } from \"./warn-deprecated-config\";\n\n/**\n * `Error` with the ES2022 `cause` option, typed for packages still compiled\n * against an older lib (see `application.ts`).\n */\nconst ErrorWithCause = Error as new (message: string, options: { cause: unknown }) => Error;\n\n/**\n * True when `error` is Node's \"this runtime can't import a `.ts` file\" error.\n *\n * Node only executes TypeScript natively from v22.18 / v23.6 onward (earlier\n * 22.x needs `--experimental-strip-types`). On older runtimes a bare\n * `import(\"warlock.config.ts\")` throws `ERR_UNKNOWN_FILE_EXTENSION` — which is\n * the signal to fall back to transpiling the config ourselves.\n */\nexport function isUnknownTsExtensionError(error: unknown): boolean {\n  return (\n    (error as { code?: string })?.code === \"ERR_UNKNOWN_FILE_EXTENSION\" ||\n    /Unknown file extension \"\\.tsx?\"/.test(String((error as Error)?.message))\n  );\n}\n\n/**\n * True when `error` is Node failing to RESOLVE an import of the config's OWN\n * graph: an extensionless relative import (`./src/connectors/local`), a\n * directory import, or a tsconfig `paths` alias (`app/connectors`) — all of\n * which only a TypeScript toolchain resolves. Native type stripping\n * (Node ≥ 22.18) loads `warlock.config.ts` itself, then fails here.\n *\n * A package that is genuinely not installed is NOT a fallback case: the error\n * names a bare specifier that matches no `paths` pattern, and it is rethrown\n * as is. Neither is a missing module imported from inside `node_modules`.\n *\n * `pathAliases` are the tsconfig `paths` patterns (`app/*`). When the message\n * cannot be parsed the error is treated as a graph error, as before.\n */\nexport function isUnresolvedConfigImportError(\n  error: unknown,\n  pathAliases: readonly string[] = [],\n): boolean {\n  const code = (error as { code?: string })?.code;\n\n  if (code === \"ERR_UNSUPPORTED_DIR_IMPORT\") return true;\n  if (code !== \"ERR_MODULE_NOT_FOUND\") return false;\n\n  const message = String((error as Error)?.message ?? \"\");\n  const match = /Cannot find (module|package) '([^']+)' imported from (.+)$/m.exec(message);\n\n  if (!match) return true;\n\n  const [, kind, specifier = \"\", importer = \"\"] = match;\n\n  if (/[\\\\/]node_modules[\\\\/]/.test(importer)) return false;\n\n  // An unresolved relative or absolute path: an extensionless TS import.\n  if (kind === \"module\") return true;\n\n  // A bare name: only a tsconfig alias is the config graph's own code.\n  return pathAliases.some((pattern) => aliasCovers(pattern, specifier));\n}\n\n/**\n * True when `error` is native type stripping refusing TypeScript it cannot\n * strip (an `enum`, a `namespace`, a parameter property) or a `.ts` file under\n * `node_modules`. Both are raised while loading, before the graph runs.\n */\nexport function isUnsupportedTypeStrippingError(error: unknown): boolean {\n  const code = (error as { code?: string })?.code;\n\n  return (\n    code === \"ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX\" ||\n    code === \"ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING\"\n  );\n}\n\n/**\n * True when a tsconfig `paths` pattern can produce `packageName` as the first\n * segment(s) of a specifier: `app/*` covers `app`, `@shared/*` covers\n * `@shared`, a catch-all `*` covers anything.\n */\nfunction aliasCovers(pattern: string, packageName: string): boolean {\n  const star = pattern.indexOf(\"*\");\n  const prefix = star === -1 ? pattern : pattern.slice(0, star);\n\n  if (prefix === \"\") return true;\n\n  return (\n    prefix === packageName || prefix.startsWith(`${packageName}/`) || packageName.startsWith(prefix)\n  );\n}\n\n/**\n * Warlock Config Manager\n *\n * Manages lazy loading of the pre-compiled warlock.config.js file\n * from the .warlock/cache directory.\n */\nexport class WarlockConfigManager {\n  /**\n   * Cached config instance\n   */\n  private config?: WarlockConfig;\n\n  /**\n   * Loading promise to prevent duplicate loads\n   */\n  private loading?: Promise<WarlockConfig | undefined>;\n\n  /**\n   * Load warlock.config.js (cached after first load)\n   *\n   * @returns The resolved Warlock configuration\n   */\n  public async load(): Promise<WarlockConfig | undefined> {\n    // Already loaded\n    if (this.config) {\n      return this.config;\n    }\n\n    // Currently loading (prevent duplicate loads)\n    if (this.loading) {\n      return this.loading;\n    }\n\n    // Start loading\n    this.loading = this.doLoad();\n    this.config = await this.loading;\n    this.loading = undefined;\n\n    // Console, not the logger: this runs before any log channel exists.\n    for (const warning of getDeprecatedConfigWarnings(this.config)) {\n      console.warn(warning);\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Internal load implementation\n   *\n   * The ESM loader hook transpiles `warlock.config.ts` on import — no\n   * separate compile-to-disk step is needed.\n   */\n  private async doLoad(): Promise<WarlockConfig | undefined> {\n    const configPath = rootPath(\"warlock.config.ts\");\n\n    if (!(await fileExistsAsync(configPath))) {\n      // Written straight to the console, NOT through `@warlock.js/logger`.\n      // This runs during CLI bootstrap, before `LoggerConnector.start()` has\n      // configured a single channel, so a logger call here reaches nobody in\n      // any application — the warning would be silently dropped exactly when\n      // the user most needs it.\n      console.warn(\n        \"warlock.config.ts is missing — create it at the project root (see https://warlock.js.org/docs for the config reference)\",\n      );\n      return;\n    }\n\n    try {\n      const configModule = await import(pathToFileURL(configPath).href);\n      return configModule.default;\n    } catch (error) {\n      // `dev` registers a TS loader hook, and Node ≥ 22.18 / 23.6 strips types\n      // natively — in both cases the direct import above works for a\n      // self-contained config. But `build` / `start` register no hook, so on an\n      // older Node the import throws ERR_UNKNOWN_FILE_EXTENSION; native\n      // stripping cannot resolve extensionless or tsconfig-aliased local\n      // imports, nor strip an `enum` or a parameter property. Bundle the\n      // config's local graph with esbuild ourselves so config loading is\n      // Node-version-independent.\n      //\n      // These errors are raised while resolving and loading the STATIC graph,\n      // before any of it runs. An unresolved import reached later — a dynamic\n      // `import()` while the config runs — is indistinguishable by code, so the\n      // fallback is limited to the config's own relative and aliased imports.\n      if (\n        isUnknownTsExtensionError(error) ||\n        isUnsupportedTypeStrippingError(error) ||\n        isUnresolvedConfigImportError(error, configPathAliases(configPath))\n      ) {\n        return await this.loadViaEsbuild(configPath);\n      }\n\n      throw new ErrorWithCause(`Failed to load warlock.config.ts: ${error}`, { cause: error });\n    }\n  }\n\n  /**\n   * Fallback config loader for runtimes that cannot import the config as written.\n   *\n   * Bundles `warlock.config.ts` with its LOCAL import graph (relative imports,\n   * extensionless TS imports, tsconfig `paths` aliases) through esbuild, keeping\n   * every package external so `BaseConnector`, the container and other\n   * registries keep the application's identity (see `bundleWarlockConfig`).\n   * The bundle is written as a sibling `.mjs` — so its external imports resolve\n   * from the project exactly as they would from the original config — imported\n   * once, then removed whether it loaded or threw. An error thrown by the\n   * user's config propagates unchanged.\n   */\n  private async loadViaEsbuild(configPath: string): Promise<WarlockConfig | undefined> {\n    const code = await bundleWarlockConfig(configPath);\n\n    // Unique sibling name so concurrent processes never clobber each other.\n    const compiledPath = configPath.replace(\n      /warlock\\.config\\.ts$/,\n      `.warlock.config.${process.pid}.${Date.now()}.mjs`,\n    );\n\n    await writeFile(compiledPath, code, \"utf8\");\n\n    try {\n      const configModule = await import(pathToFileURL(compiledPath).href);\n      return configModule.default;\n    } catch (error) {\n      throw nameOriginalConfig(error, compiledPath, configPath);\n    } finally {\n      await unlink(compiledPath).catch(() => {});\n    }\n  }\n\n  /**\n   * Get config value by key (dot notation supported)\n   *\n   * @example\n   * config.get(\"server.port\") // Returns 3000\n   * config.get(\"cli.commands\") // Returns array of commands\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @returns The config value\n   * @throws Error if config is not loaded\n   */\n  public get<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): WarlockConfig[Key] {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return get(this.config, key as string, defaultValue);\n  }\n\n  /**\n   * Lazy get - loads config if not already loaded\n   *\n   * @example\n   * const port = await config.lazyGet(\"server\");\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @param defaultValue - Default value if config key is undefined\n   * @returns The config value\n   */\n  async lazyGet<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): Promise<WarlockConfig[Key]> {\n    await this.load();\n    return this.get(key, defaultValue);\n  }\n\n  /**\n   * Check if config is loaded\n   */\n  public get isLoaded(): boolean {\n    return this.config !== undefined;\n  }\n\n  /**\n   * Get the entire config object\n   *\n   * @throws Error if config is not loaded\n   */\n  public getAll(): WarlockConfig {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Reload config (useful for HMR/development)\n   */\n  public async reload(): Promise<void> {\n    this.config = undefined;\n    this.loading = undefined;\n    await this.load();\n  }\n}\n\n/**\n * The tsconfig `paths` patterns of the project holding `configPath`.\n */\nfunction configPathAliases(configPath: string): string[] {\n  try {\n    return Object.keys(getTsconfig(path.dirname(configPath))?.config.compilerOptions?.paths ?? {});\n  } catch {\n    return [];\n  }\n}\n\n/**\n * A loader error raised by the bundled config names the temporary `.mjs`\n * module. Rewrite it to name `warlock.config.ts`, keeping the original as the\n * cause. An error thrown by the user's own config is returned unchanged.\n */\nfunction nameOriginalConfig(error: unknown, compiledPath: string, configPath: string): unknown {\n  const code = (error as { code?: string })?.code;\n\n  if (typeof code !== \"string\" || !code.startsWith(\"ERR_\")) return error;\n\n  const message = String((error as Error).message ?? error)\n    .split(pathToFileURL(compiledPath).href)\n    .join(pathToFileURL(configPath).href)\n    .split(compiledPath)\n    .join(configPath);\n\n  const wrapped = new ErrorWithCause(`Failed to load warlock.config.ts: ${message}`, {\n    cause: error,\n  });\n\n  (wrapped as Error & { code?: string }).code = code;\n\n  return wrapped;\n}\n\n/**\n * Exported singleton instance\n *\n * @example\n * import { warlockConfig } from \"@warlock.js/core\";\n *\n * // Lazy load and get value\n * const port = await warlockConfig.lazyGet(\"server.port\");\n *\n * // Or load first, then get\n * await warlockConfig.load();\n * const commands = warlockConfig.get(\"cli.commands\");\n */\nexport const warlockConfigManager = new WarlockConfigManager();\n"],"mappings":"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"}

package/esm/warlock-config/warn-deprecated-config.mjs

@@ -1,6 +1,6 @@
 import { get } from "@mongez/reinforcements";
 
-//#region ../core/src/warlock-config/warn-deprecated-config.ts
+//#region ../../packages/core/src/warlock-config/warn-deprecated-config.ts
 /**
 * Keys of `warlock.config.ts` that are declared but never read, and where the
 * setting lives instead.

package/esm/warlock-config/warn-deprecated-config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"warn-deprecated-config.mjs","names":[],"sources":["../../../../../../../core/src/warlock-config/warn-deprecated-config.ts"],"sourcesContent":["import { get } from \"@mongez/reinforcements\";\nimport type { WarlockConfig } from \"./types\";\n\n/**\n * Keys of `warlock.config.ts` that are declared but never read, and where the\n * setting lives instead.\n */\nexport const deprecatedConfigKeys: Record<string, string> = {\n  \"server.port\": \"set the HTTP port in `config/http.ts` (`port`)\",\n  \"server.host\": \"set the HTTP host in `config/http.ts` (`host`)\",\n  \"server.retryOtherPort\": \"port fallback is not implemented, remove it\",\n  \"tests.include\": \"configure test discovery in `config/tests.ts`\",\n  \"tests.exclude\": \"configure test discovery in `config/tests.ts`\",\n};\n\n/**\n * Build one warning per deprecated key the app actually sets.\n */\nexport function getDeprecatedConfigWarnings(config: WarlockConfig | undefined): string[] {\n  if (!config) return [];\n\n  return Object.entries(deprecatedConfigKeys)\n    .filter(([key]) => get(config, key) !== undefined)\n    .map(\n      ([key, instead]) =>\n        `warlock.config.ts: \\`${key}\\` is deprecated and ignored by the framework; ${instead}.`,\n    );\n}\n"],"mappings":";;;;;;;AAOA,MAAa,uBAA+C;CAC1D,eAAe;CACf,eAAe;CACf,yBAAyB;CACzB,iBAAiB;CACjB,iBAAiB;AACnB;;;;AAKA,SAAgB,4BAA4B,QAA6C;CACvF,IAAI,CAAC,QAAQ,OAAO,CAAC;CAErB,OAAO,OAAO,QAAQ,oBAAoB,CAAC,CACxC,QAAQ,CAAC,SAAS,IAAI,QAAQ,GAAG,MAAM,MAAS,CAAC,CACjD,KACE,CAAC,KAAK,aACL,wBAAwB,IAAI,iDAAiD,QAAQ,EACzF;AACJ"}
+{"version":3,"file":"warn-deprecated-config.mjs","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warn-deprecated-config.ts"],"sourcesContent":["import { get } from \"@mongez/reinforcements\";\nimport type { WarlockConfig } from \"./types\";\n\n/**\n * Keys of `warlock.config.ts` that are declared but never read, and where the\n * setting lives instead.\n */\nexport const deprecatedConfigKeys: Record<string, string> = {\n  \"server.port\": \"set the HTTP port in `config/http.ts` (`port`)\",\n  \"server.host\": \"set the HTTP host in `config/http.ts` (`host`)\",\n  \"server.retryOtherPort\": \"port fallback is not implemented, remove it\",\n  \"tests.include\": \"configure test discovery in `config/tests.ts`\",\n  \"tests.exclude\": \"configure test discovery in `config/tests.ts`\",\n};\n\n/**\n * Build one warning per deprecated key the app actually sets.\n */\nexport function getDeprecatedConfigWarnings(config: WarlockConfig | undefined): string[] {\n  if (!config) return [];\n\n  return Object.entries(deprecatedConfigKeys)\n    .filter(([key]) => get(config, key) !== undefined)\n    .map(\n      ([key, instead]) =>\n        `warlock.config.ts: \\`${key}\\` is deprecated and ignored by the framework; ${instead}.`,\n    );\n}\n"],"mappings":";;;;;;;AAOA,MAAa,uBAA+C;CAC1D,eAAe;CACf,eAAe;CACf,yBAAyB;CACzB,iBAAiB;CACjB,iBAAiB;AACnB;;;;AAKA,SAAgB,4BAA4B,QAA6C;CACvF,IAAI,CAAC,QAAQ,OAAO,CAAC;CAErB,OAAO,OAAO,QAAQ,oBAAoB,CAAC,CACxC,QAAQ,CAAC,SAAS,IAAI,QAAQ,GAAG,MAAM,MAAS,CAAC,CACjD,KACE,CAAC,KAAK,aACL,wBAAwB,IAAI,iDAAiD,QAAQ,EACzF;AACJ"}