@warlock.js/core 5.31.0 → 5.33.0

package/esm/warlock-config/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/types.ts"],"mappings":";;;;;;;;;AAcA;;;KAAY,aAAA;EA8BF;;;EA1BR,MAAA;IAkKiD;;;IA9J/C,IAAA;IA+PkB;;;IA3PlB,IAAA;IAIA;;;IAAA,cAAA;EAAA;EA+BA;;;;;;;;;;;EAjBF,KAAA,GAAQ,IAAA,CAAK,YAAA;IAkHb;;;;;IA5GE,MAAA;IAkI+C;;;;;;;;;;IAvH/C,YAAA;IAsMF;;;;;IAhME,OAAA;IA6OA;;AAAO;;;;IAtOP,0BAAA;;;;;;;;;;;;;;;;;IAiBA,YAAA;;;;;;;;;;;;;;;;IAgBA,OAAA;;;;;;IAMA,MAAA;;;;;;IAMA,SAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;EA2BF,UAAA,GAAa,SAAA;;;;EAKb,GAAA;IACE,QAAA,GAAW,UAAA;EAAA;;;;EAMb,SAAA;;;;IAIE,KAAA;;;;;;MAME,OAAA;;;;;;MAMA,OAAA;IAAA;;;;;IAMF,cAAA,GAAiB,yBAAA,KAA8B,2BAAA;;;;;IAK/C,eAAA;;;;;;;;;IASA,eAAA;;;;;;;;;IASA,qBAAA;;;;;;;;;;IAUA,mBAAA;;;;;;;;;;;;IAYA,OAAA;;;;;;;;;;IAUA,QAAA;;;;;;;;;IASA,GAAA;8CAIM,IAAA;MAEA,KAAA;MAEA,WAAA;IAAA;EAAA;;;;EAOR,QAAA;;;;;;;;;;;;;;;;;;IAkBE,UAAA,GAAa,KAAA,CAAM,oBAAA;EAAA;;;;;;;EASrB,OAAA;;;;;;;;;IASE,OAAA;;;;;;;;IASA,OAAA;EAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/types.ts"],"mappings":";;;;;;;;;;;YAcY;;;;EAIV;;;;IAIE;;;;IAIA;;;;IAIA;;;;;;;;;;;;;EAcF,QAAQ,KAAK;;;;;;IAMX;;;;;;;;;;;IAWA;;;;;;IAMA;;;;;;;IAOA;;;;;;;;;;;;;;;;;IAiBA;;;;;;;;;;;;;;;;IAgBA;;;;;;IAMA;;;;;;IAMA;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BF,aAAa;;;;EAKb;IACE,WAAW;;;;;EAMb;;;;IAIE;;;;;;MAME;;;;;;MAMA;;;;;;;IAOF,iBAAiB,8BAA8B;;;;;IAK/C;;;;;;;;;IASA;;;;;;;;;IASA;;;;;;;;;;IAUA;;;;;;;;;;;;IAYA;;;;;;;;;;IAUA;;;;;;;;;IASA;;MAIM;;MAEA;;MAEA;;;;;;EAOR;;;;;;;;;;;;;;;;;;IAkBE,aAAa,MAAM;;;;;;;;EASrB;;;;;;;;;IASE;;;;;;;;IASA"}

package/esm/warlock-config/warlock-config.manager.d.mts

@@ -1,5 +1,4 @@
 import { WarlockConfig } from "./types.mjs";
-
 //#region ../../packages/core/src/warlock-config/warlock-config.manager.d.ts
 /**
  * True when `error` is Node's "this runtime can't import a `.ts` file" error.
@@ -9,7 +8,7 @@ import { WarlockConfig } from "./types.mjs";
  * `import("warlock.config.ts")` throws `ERR_UNKNOWN_FILE_EXTENSION` — which is
  * the signal to fall back to transpiling the config ourselves.
  */
-declare function isUnknownTsExtensionError(error: unknown): boolean;
+export declare function isUnknownTsExtensionError(error: unknown): boolean;
 /**
  * True when `error` is Node failing to RESOLVE an import of the config's OWN
  * graph: an extensionless relative import (`./src/connectors/local`), a
@@ -24,20 +23,20 @@ declare function isUnknownTsExtensionError(error: unknown): boolean;
  * `pathAliases` are the tsconfig `paths` patterns (`app/*`). When the message
  * cannot be parsed the error is treated as a graph error, as before.
  */
-declare function isUnresolvedConfigImportError(error: unknown, pathAliases?: readonly string[]): boolean;
+export declare function isUnresolvedConfigImportError(error: unknown, pathAliases?: readonly string[]): boolean;
 /**
  * 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.
  */
-declare function isUnsupportedTypeStrippingError(error: unknown): boolean;
+export declare function isUnsupportedTypeStrippingError(error: unknown): boolean;
 /**
  * Warlock Config Manager
  *
  * Manages lazy loading of the pre-compiled warlock.config.js file
  * from the .warlock/cache directory.
  */
-declare class WarlockConfigManager {
+export declare class WarlockConfigManager {
   /**
    * Cached config instance
    */
@@ -123,7 +122,6 @@ declare class WarlockConfigManager {
  * await warlockConfig.load();
  * const commands = warlockConfig.get("cli.commands");
  */
-declare const warlockConfigManager: WarlockConfigManager;
+export declare const warlockConfigManager: WarlockConfigManager;
 //#endregion
-export { WarlockConfigManager, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager };
 //# sourceMappingURL=warlock-config.manager.d.mts.map

package/esm/warlock-config/warlock-config.manager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"warlock-config.manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warlock-config.manager.ts"],"mappings":";;;;;AAyBA;;;;AAAwD;AAqBxD;iBArBgB,yBAAA,CAA0B,KAAc;;;AAuBnB;AA4BrC;;;;AAA8D;AA+B9D;;;;;;iBA7DgB,6BAAA,CACd,KAAA,WACA,WAAmC;;;;;;iBA4BrB,+BAAA,CAAgC,KAAc;;;;;;;cA+BjD,oBAAA;EA0LmB;;;EAAA,QAtLtB,MAAA;EAYK;;;EAAA,QAPL,OAAA;EA6FM;;;;;EAtFD,IAAA,IAAQ,OAAA,CAAQ,aAAA;EAwHZ;;;;;;EAAA,QA1FH,MAAA;EA6GkB;;;;;;;;;;;;EAAA,QArDlB,cAAA;EAoFS;;AAAO;AAwDhC;;;;AAA8D;;;;EA5GrD,GAAA,mBAAsB,aAAA,EAC3B,GAAA,EAAK,GAAA,EACL,YAAA,GAAe,aAAA,CAAc,GAAA,IAC5B,aAAA,CAAc,GAAA;;;;;;;;;;;EAkBX,OAAA,mBAA0B,aAAA,EAC9B,GAAA,EAAK,GAAA,EACL,YAAA,GAAe,aAAA,CAAc,GAAA,IAC5B,OAAA,CAAQ,aAAA,CAAc,GAAA;;;;MAQd,QAAA;;;;;;EASJ,MAAA,IAAU,aAAA;;;;EAWJ,MAAA,IAAU,OAAA;AAAA;;;;;;;;;;;;;;cAwDZ,oBAAA,EAAoB,oBAA6B"}
+{"version":3,"file":"warlock-config.manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warlock-config.manager.ts"],"mappings":";;;;;;;;;;wBAyBgB,0BAA0B;;;;;;;;;;;;;;;wBAqB1B,8BACd,gBACA;;;;;;wBA4Bc,gCAAgC;;;;;;;qBA+BnC;;;;UAIH;;;;UAKA;;;;;;EAOK,QAAQ,QAAQ;;;;;;;UA8Bf;;;;;;;;;;;;;UAwDA;;;;;;;;;;;;EAgCP,IAAI,kBAAkB,eAC3B,KAAK,KACL,eAAe,cAAc,OAC5B,cAAc;;;;;;;;;;;EAkBX,QAAQ,kBAAkB,eAC9B,KAAK,KACL,eAAe,cAAc,OAC5B,QAAQ,cAAc;;;;MAQd;;;;;;EASJ,UAAU;;;;EAWJ,UAAU;;;;;;;;;;;;;;;qBAwDZ,sBAAoB"}

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

@@ -207,7 +207,8 @@ function configPathAliases(configPath) {
 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 });
+	const message = String(error.message ?? error).split(pathToFileURL(compiledPath).href).join(pathToFileURL(configPath).href).split(compiledPath).join(configPath);
+	const wrapped = new ErrorWithCause(`Failed to load warlock.config.ts: ${message}`, { cause: error });
 	wrapped.code = code;
 	return wrapped;
 }

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

@@ -1 +1 @@
-{"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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"}
+{"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

@@ -21,5 +21,5 @@ function getDeprecatedConfigWarnings(config) {
 }
 
 //#endregion
-export { getDeprecatedConfigWarnings };
+export { deprecatedConfigKeys, getDeprecatedConfigWarnings };
 //# sourceMappingURL=warn-deprecated-config.mjs.map