@warlock.js/core 4.0.174 → 4.1.2

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

@@ -0,0 +1,117 @@
+import { rootPath } from "../utils/paths.mjs";
+import "../utils/index.mjs";
+import { devLogWarn } from "../dev-server/dev-logger.mjs";
+import { get } from "@mongez/reinforcements";
+import { fileExistsAsync } from "@warlock.js/fs";
+import { pathToFileURL } from "url";
+
+//#region ../../@warlock.js/core/src/warlock-config/warlock-config.manager.ts
+/**
+* Warlock Config Manager
+*
+* Manages lazy loading of the pre-compiled warlock.config.js file
+* from the .warlock/cache directory.
+*/
+var WarlockConfigManager = class {
+	/**
+	* Load warlock.config.js (cached after first load)
+	*
+	* @returns The resolved Warlock configuration
+	*/
+	async load() {
+		if (this.config) return this.config;
+		if (this.loading) return this.loading;
+		this.loading = this.doLoad();
+		this.config = await this.loading;
+		this.loading = void 0;
+		return this.config;
+	}
+	/**
+	* Internal load implementation
+	*
+	* The ESM loader hook transpiles `warlock.config.ts` on import — no
+	* separate compile-to-disk step is needed.
+	*/
+	async doLoad() {
+		const configPath = rootPath("warlock.config.ts");
+		if (!await fileExistsAsync(configPath)) {
+			devLogWarn("warlock.config.ts is missing, it's highly recommended to create it, run warlock init to create it");
+			return;
+		}
+		try {
+			return (await import(pathToFileURL(configPath).href)).default;
+		} catch (error) {
+			throw new Error(`Failed to load warlock.config.ts: ${error}`);
+		}
+	}
+	/**
+	* Get config value by key (dot notation supported)
+	*
+	* @example
+	* config.get("server.port") // Returns 3000
+	* config.get("cli.commands") // Returns array of commands
+	*
+	* @param key - Config key (supports dot notation), autocompletes for first level only
+	* @returns The config value
+	* @throws Error if config is not loaded
+	*/
+	get(key, defaultValue) {
+		if (!this.config) throw new Error("WarlockConfig not loaded. Call load() first or use lazyGet().");
+		return get(this.config, key, defaultValue);
+	}
+	/**
+	* Lazy get - loads config if not already loaded
+	*
+	* @example
+	* const port = await config.lazyGet("server");
+	*
+	* @param key - Config key (supports dot notation), autocompletes for first level only
+	* @param defaultValue - Default value if config key is undefined
+	* @returns The config value
+	*/
+	async lazyGet(key, defaultValue) {
+		await this.load();
+		return this.get(key, defaultValue);
+	}
+	/**
+	* Check if config is loaded
+	*/
+	get isLoaded() {
+		return this.config !== void 0;
+	}
+	/**
+	* Get the entire config object
+	*
+	* @throws Error if config is not loaded
+	*/
+	getAll() {
+		if (!this.config) throw new Error("WarlockConfig not loaded. Call load() first or use lazyGet().");
+		return this.config;
+	}
+	/**
+	* Reload config (useful for HMR/development)
+	*/
+	async reload() {
+		this.config = void 0;
+		this.loading = void 0;
+		await this.load();
+	}
+};
+/**
+* Exported singleton instance
+*
+* @example
+* import { warlockConfig } from "@warlock.js/core";
+*
+* // Lazy load and get value
+* const port = await warlockConfig.lazyGet("server.port");
+*
+* // Or load first, then get
+* await warlockConfig.load();
+* const commands = warlockConfig.get("cli.commands");
+*/
+const warlockConfigManager = new WarlockConfigManager();
+
+//#endregion
+export { WarlockConfigManager, warlockConfigManager };
+//# sourceMappingURL=warlock-config.manager.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"warlock-config.manager.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/warlock-config/warlock-config.manager.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\r\nimport { get } from \"@mongez/reinforcements\";\r\nimport { pathToFileURL } from \"url\";\r\nimport { devLogWarn } from \"../dev-server/dev-logger\";\r\nimport { rootPath } from \"../utils\";\r\nimport { WarlockConfig } from \"./types\";\r\n\r\n/**\r\n * Warlock Config Manager\r\n *\r\n * Manages lazy loading of the pre-compiled warlock.config.js file\r\n * from the .warlock/cache directory.\r\n */\r\nexport class WarlockConfigManager {\r\n  /**\r\n   * Cached config instance\r\n   */\r\n  private config?: WarlockConfig;\r\n\r\n  /**\r\n   * Loading promise to prevent duplicate loads\r\n   */\r\n  private loading?: Promise<WarlockConfig | undefined>;\r\n\r\n  /**\r\n   * Load warlock.config.js (cached after first load)\r\n   *\r\n   * @returns The resolved Warlock configuration\r\n   */\r\n  public async load(): Promise<WarlockConfig | undefined> {\r\n    // Already loaded\r\n    if (this.config) {\r\n      return this.config;\r\n    }\r\n\r\n    // Currently loading (prevent duplicate loads)\r\n    if (this.loading) {\r\n      return this.loading;\r\n    }\r\n\r\n    // Start loading\r\n    this.loading = this.doLoad();\r\n    this.config = await this.loading;\r\n    this.loading = undefined;\r\n\r\n    return this.config;\r\n  }\r\n\r\n  /**\r\n   * Internal load implementation\r\n   *\r\n   * The ESM loader hook transpiles `warlock.config.ts` on import — no\r\n   * separate compile-to-disk step is needed.\r\n   */\r\n  private async doLoad(): Promise<WarlockConfig | undefined> {\r\n    const configPath = rootPath(\"warlock.config.ts\");\r\n\r\n    if (!(await fileExistsAsync(configPath))) {\r\n      devLogWarn(\r\n        \"warlock.config.ts is missing, it's highly recommended to create it, run warlock init to create it\",\r\n      );\r\n      return;\r\n    }\r\n\r\n    try {\r\n      const configModule = await import(pathToFileURL(configPath).href);\r\n      return configModule.default;\r\n    } catch (error) {\r\n      throw new Error(`Failed to load warlock.config.ts: ${error}`);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get config value by key (dot notation supported)\r\n   *\r\n   * @example\r\n   * config.get(\"server.port\") // Returns 3000\r\n   * config.get(\"cli.commands\") // Returns array of commands\r\n   *\r\n   * @param key - Config key (supports dot notation), autocompletes for first level only\r\n   * @returns The config value\r\n   * @throws Error if config is not loaded\r\n   */\r\n  public get<Key extends keyof WarlockConfig>(\r\n    key: Key,\r\n    defaultValue?: WarlockConfig[Key],\r\n  ): WarlockConfig[Key] {\r\n    if (!this.config) {\r\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\r\n    }\r\n\r\n    return get(this.config, key as string, defaultValue);\r\n  }\r\n\r\n  /**\r\n   * Lazy get - loads config if not already loaded\r\n   *\r\n   * @example\r\n   * const port = await config.lazyGet(\"server\");\r\n   *\r\n   * @param key - Config key (supports dot notation), autocompletes for first level only\r\n   * @param defaultValue - Default value if config key is undefined\r\n   * @returns The config value\r\n   */\r\n  async lazyGet<Key extends keyof WarlockConfig>(\r\n    key: Key,\r\n    defaultValue?: WarlockConfig[Key],\r\n  ): Promise<WarlockConfig[Key]> {\r\n    await this.load();\r\n    return this.get(key, defaultValue);\r\n  }\r\n\r\n  /**\r\n   * Check if config is loaded\r\n   */\r\n  public get isLoaded(): boolean {\r\n    return this.config !== undefined;\r\n  }\r\n\r\n  /**\r\n   * Get the entire config object\r\n   *\r\n   * @throws Error if config is not loaded\r\n   */\r\n  public getAll(): WarlockConfig {\r\n    if (!this.config) {\r\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\r\n    }\r\n\r\n    return this.config;\r\n  }\r\n\r\n  /**\r\n   * Reload config (useful for HMR/development)\r\n   */\r\n  public async reload(): Promise<void> {\r\n    this.config = undefined;\r\n    this.loading = undefined;\r\n    await this.load();\r\n  }\r\n}\r\n\r\n/**\r\n * Exported singleton instance\r\n *\r\n * @example\r\n * import { warlockConfig } from \"@warlock.js/core\";\r\n *\r\n * // Lazy load and get value\r\n * const port = await warlockConfig.lazyGet(\"server.port\");\r\n *\r\n * // Or load first, then get\r\n * await warlockConfig.load();\r\n * const commands = warlockConfig.get(\"cli.commands\");\r\n */\r\nexport const warlockConfigManager = new WarlockConfigManager();\r\n"],"mappings":";;;;;;;;;;;;;;AAaA,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;EAEf,OAAO,KAAK;CACd;;;;;;;CAQA,MAAc,SAA6C;EACzD,MAAM,aAAa,SAAS,mBAAmB;EAE/C,IAAI,CAAE,MAAM,gBAAgB,UAAU,GAAI;GACxC,WACE,mGACF;GACA;EACF;EAEA,IAAI;GAEF,QAAO,MADoB,OAAO,cAAc,UAAU,EAAE,OACxC;EACtB,SAAS,OAAO;GACd,MAAM,IAAI,MAAM,qCAAqC,OAAO;EAC9D;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"}