@warlock.js/core 4.0.174 → 4.1.3

package/esm/cache/database-cache-driver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-cache-driver.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/cache/database-cache-driver.ts"],"sourcesContent":["import {\n  BaseCacheDriver,\n  type CacheData,\n  type CacheDriver,\n  type CacheKey,\n} from \"@warlock.js/cache\";\nimport { Model } from \"@warlock.js/cascade\";\n\nexport type DatabaseCacheOptions = {\n  /**\n   * Database model class\n   */\n  model?: typeof CacheModel;\n  /**\n   * Global prefix for the cache key\n   */\n  globalPrefix?: string | (() => string);\n  /**\n   * The default TTL for the cache in seconds\n   *\n   * @default Infinity\n   */\n  ttl?: number;\n};\n\nexport class CacheModel extends Model {\n  public static table = \"cache\";\n}\n\nexport class DatabaseCacheDriver\n  extends BaseCacheDriver<DatabaseCacheDriver, DatabaseCacheOptions>\n  implements CacheDriver<DatabaseCacheDriver, DatabaseCacheOptions>\n{\n  /**\n   * {@inheritdoc}\n   */\n  public name = \"database\";\n\n  /**\n   * Database model class\n   */\n  public model!: typeof CacheModel;\n\n  /**\n   * {@inheritdoc}\n   */\n  public setOptions(options: DatabaseCacheOptions) {\n    super.setOptions(options);\n\n    this.model = options.model ?? CacheModel;\n\n    return this;\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async removeNamespace(namespace: string) {\n    this.log(\"clearing\", namespace);\n\n    namespace = this.parseKey(namespace);\n\n    await this.model.delete({\n      namespace,\n    });\n\n    this.log(\"cleared\", namespace);\n\n    return this;\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async set(key: CacheKey, value: any, ttl?: number) {\n    const parsedKey = this.parseKey(key);\n\n    this.log(\"caching\", parsedKey);\n\n    if (ttl === undefined) {\n      ttl = this.ttl;\n    }\n\n    // Extract namespace: all parts except the last (e.g., \"users.id.1\" -> \"users.id\")\n    const keyParts = parsedKey.split(\".\");\n    const namespace = keyParts.slice(0, -1).join(\".\") || parsedKey;\n\n    // Find existing cache entry or create new one (upsert pattern)\n    let cacheEntry = await this.model.first({ key: parsedKey });\n\n    if (cacheEntry) {\n      // Update existing entry\n      cacheEntry.set(\"namespace\", namespace);\n      cacheEntry.set(\"data\", value);\n      cacheEntry.set(\"ttl\", ttl);\n      cacheEntry.set(\"expiresAt\", this.getExpiresAt(ttl) || null);\n      await cacheEntry.save();\n    } else {\n      // Create new entry\n      await this.model.create({\n        key: parsedKey,\n        namespace,\n        data: value,\n        ttl,\n        expiresAt: this.getExpiresAt(ttl) || null,\n      });\n    }\n\n    this.log(\"cached\", parsedKey);\n\n    return this;\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async get(key: CacheKey) {\n    const parsedKey = this.parseKey(key);\n\n    this.log(\"fetching\", parsedKey);\n\n    const model = await this.model.first({\n      key: parsedKey,\n    });\n\n    if (!model) {\n      this.log(\"notFound\", parsedKey);\n      return null;\n    }\n\n    const data: CacheData = {\n      data: model.get(\"data\"),\n      expiresAt: model.get(\"expiresAt\") as number | undefined,\n      ttl: model.get(\"ttl\") as number | undefined,\n    };\n\n    return this.parseCachedData(parsedKey, data);\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async remove(key: CacheKey) {\n    const parsedKey = this.parseKey(key);\n\n    this.log(\"removing\", parsedKey);\n\n    await this.model.delete({\n      key: parsedKey,\n    });\n\n    this.log(\"removed\", parsedKey);\n  }\n\n  /**\n   * {@inheritdoc}\n   */\n  public async flush() {\n    this.log(\"flushing\");\n    if (this.options.globalPrefix) {\n      this.removeNamespace(\"\");\n    } else {\n      await this.model.delete();\n    }\n\n    this.log(\"flushed\");\n  }\n}\n"],"mappings":";;;;AAyBA,IAAa,aAAb,cAAgC,MAAM;;eACd;;AACxB;AAEA,IAAa,sBAAb,cACU,gBAEV;;;cAIgB;;;;;CAUd,AAAO,WAAW,SAA+B;EAC/C,MAAM,WAAW,OAAO;EAExB,KAAK,QAAQ,QAAQ,SAAS;EAE9B,OAAO;CACT;;;;CAKA,MAAa,gBAAgB,WAAmB;EAC9C,KAAK,IAAI,YAAY,SAAS;EAE9B,YAAY,KAAK,SAAS,SAAS;EAEnC,MAAM,KAAK,MAAM,OAAO,EACtB,UACF,CAAC;EAED,KAAK,IAAI,WAAW,SAAS;EAE7B,OAAO;CACT;;;;CAKA,MAAa,IAAI,KAAe,OAAY,KAAc;EACxD,MAAM,YAAY,KAAK,SAAS,GAAG;EAEnC,KAAK,IAAI,WAAW,SAAS;EAE7B,IAAI,QAAQ,QACV,MAAM,KAAK;EAKb,MAAM,YADW,UAAU,MAAM,GACR,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,KAAK;EAGrD,IAAI,aAAa,MAAM,KAAK,MAAM,MAAM,EAAE,KAAK,UAAU,CAAC;EAE1D,IAAI,YAAY;GAEd,WAAW,IAAI,aAAa,SAAS;GACrC,WAAW,IAAI,QAAQ,KAAK;GAC5B,WAAW,IAAI,OAAO,GAAG;GACzB,WAAW,IAAI,aAAa,KAAK,aAAa,GAAG,KAAK,IAAI;GAC1D,MAAM,WAAW,KAAK;EACxB,OAEE,MAAM,KAAK,MAAM,OAAO;GACtB,KAAK;GACL;GACA,MAAM;GACN;GACA,WAAW,KAAK,aAAa,GAAG,KAAK;EACvC,CAAC;EAGH,KAAK,IAAI,UAAU,SAAS;EAE5B,OAAO;CACT;;;;CAKA,MAAa,IAAI,KAAe;EAC9B,MAAM,YAAY,KAAK,SAAS,GAAG;EAEnC,KAAK,IAAI,YAAY,SAAS;EAE9B,MAAM,QAAQ,MAAM,KAAK,MAAM,MAAM,EACnC,KAAK,UACP,CAAC;EAED,IAAI,CAAC,OAAO;GACV,KAAK,IAAI,YAAY,SAAS;GAC9B,OAAO;EACT;EAEA,MAAM,OAAkB;GACtB,MAAM,MAAM,IAAI,MAAM;GACtB,WAAW,MAAM,IAAI,WAAW;GAChC,KAAK,MAAM,IAAI,KAAK;EACtB;EAEA,OAAO,KAAK,gBAAgB,WAAW,IAAI;CAC7C;;;;CAKA,MAAa,OAAO,KAAe;EACjC,MAAM,YAAY,KAAK,SAAS,GAAG;EAEnC,KAAK,IAAI,YAAY,SAAS;EAE9B,MAAM,KAAK,MAAM,OAAO,EACtB,KAAK,UACP,CAAC;EAED,KAAK,IAAI,WAAW,SAAS;CAC/B;;;;CAKA,MAAa,QAAQ;EACnB,KAAK,IAAI,UAAU;EACnB,IAAI,KAAK,QAAQ,cACf,KAAK,gBAAgB,EAAE;OAEvB,MAAM,KAAK,MAAM,OAAO;EAG1B,KAAK,IAAI,SAAS;CACpB;AACF"}

package/esm/cache/index.d.mts

@@ -0,0 +1 @@
+import { DatabaseCacheDriver, DatabaseCacheOptions } from "./database-cache-driver.mjs";

package/esm/cache/index.mjs

@@ -0,0 +1,9 @@
+import { DatabaseCacheDriver } from "./database-cache-driver.mjs";
+import { cache } from "@warlock.js/cache";
+
+//#region ../../@warlock.js/core/src/cache/index.ts
+cache.registerDriver("database", DatabaseCacheDriver);
+
+//#endregion
+export {  };
+//# sourceMappingURL=index.mjs.map

package/esm/cache/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/cache/index.ts"],"sourcesContent":["export { DatabaseCacheDriver } from \"./database-cache-driver\";\nexport type { DatabaseCacheOptions } from \"./database-cache-driver\";\n\n// Auto-register database cache driver\nimport { cache } from \"@warlock.js/cache\";\nimport { DatabaseCacheDriver } from \"./database-cache-driver\";\n\ncache.registerDriver(\"database\", DatabaseCacheDriver);\n"],"mappings":";;;;AAOA,MAAM,eAAe,YAAY,mBAAmB"}

package/esm/cli/cli-command.d.mts

@@ -0,0 +1,119 @@
+import { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/cli/cli-command.d.ts
+declare class CLICommand {
+  name: string;
+  /**
+   * Command source
+   */
+  commandSource?: CLICommandSource;
+  /**
+   * Command action
+   */
+  commandAction?: CLICommandAction;
+  /**
+   * Command pre action
+   * This will be executed before loading preloaders
+   */
+  commandPreAction?: CLICommandAction;
+  /**
+   *    Command preload
+   */
+  commandPreload?: CLICommandPreload;
+  /**
+   * Command description
+   */
+  commandDescription?: string;
+  /**
+   * Command options
+   */
+  commandOptions: ResolvedCLICommandOption[];
+  /**
+   * Command relative path
+   * Available only for project commands
+   * Auto injected by the framework itself
+   */
+  commandRelativePath?: string;
+  /**
+   * Determine if the command is persistent
+   */
+  isPersistent: boolean;
+  /**
+   * Command alias (short name)
+   */
+  commandAlias?: string;
+  /**
+   * Constructor
+   */
+  constructor(name: string, description?: string);
+  /**
+   * Add command source
+   */
+  source(source: CLICommandSource): this;
+  /**
+   * Set command description
+   */
+  description(description: string): this;
+  /**
+   * Determine if the command is persistent
+   */
+  persistent(isPersistent?: boolean): this;
+  /**
+   * Set command alias (short name)
+   * @example .alias("m") for "migrate"
+   */
+  alias(alias: string): this;
+  /**
+   * Command action
+   */
+  action(action: CLICommandAction): this;
+  /**
+   * Command pre action
+   * This will be executed before loading preloaders
+   */
+  preAction(action: CLICommandAction): this;
+  /**
+   * Add command options
+   */
+  options(options: CLICommandOption[]): this;
+  /**
+   * Add command relative path
+   */
+  $relativePath(relativePath: string): this;
+  /**
+   * Add command option
+   */
+  option(option: CLICommandOption): this;
+  option(name: string, description?: string, options?: Omit<CLICommandOption, "name">): this;
+  /**
+   * Parse option name and alias if exists
+   *
+   * Supports formats:
+   * - "--port, -p" → name: "port", alias: "p"
+   * - "-p, --port" → name: "port", alias: "p"
+   * - "--port" → name: "port", alias: undefined
+   * - "-p" → name: "p", alias: undefined
+   */
+  protected parseOption(option: CLICommandOption): ResolvedCLICommandOption;
+  /**
+   * Extract option name from text (removes -- or -)
+   *
+   * @example
+   * extractOptionName("--port") → "port"
+   * extractOptionName("-p") → "p"
+   * extractOptionName("--port=3000") → "port"
+   */
+  private extractOptionName;
+  /**
+   * Command preload
+   */
+  preload(options: CLICommandPreload): this;
+  /**
+   * Execute the command
+   */
+  execute(data: CommandActionData): Promise<void>;
+}
+declare function command(options: CLICommandOptions): CLICommand;
+//#endregion
+export { CLICommand, command };
+//# sourceMappingURL=cli-command.d.mts.map

package/esm/cli/cli-command.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/cli/cli-command.ts"],"mappings":";;;cAUa,UAAA;EAqDF,IAAA;EArDE;;;EAIJ,aAAA,GAAgB,gBAAA;EAKA;;;EAAhB,aAAA,GAAgB,gBAAA;EAyDD;;;;EAnDf,gBAAA,GAAmB,gBAAA;EAuHuC;;;EAlH1D,cAAA,GAAiB,iBAAA;EAoNA;;;EA/MjB,kBAAA;EAuNqC;;;EAlNrC,cAAA,EAAgB,wBAAA;EArBhB;;;;;EA4BA,mBAAA;EAZA;;;EAiBA,YAAA;EAAA;;;EAKA,YAAA;EAOL;;;cADO,IAAA,UACP,WAAA;EAoBK;;;EARA,MAAA,CAAO,MAAA,EAAQ,gBAAA;EAyBf;;;EAjBA,WAAA,CAAY,WAAA;EAyBL;;;EAjBP,UAAA,CAAW,YAAA;EAkCX;;;;EAzBA,KAAA,CAAM,KAAA;EA0CN;;;EAlCA,MAAA,CAAO,MAAA,EAAQ,gBAAA;EAmCR;;;;EA1BP,SAAA,CAAU,MAAA,EAAQ,gBAAA;EAwDf;;;EAhDH,OAAA,CAAQ,OAAA,EAAS,gBAAA;EA8FhB;;;EArFD,aAAA,CAAc,YAAA;EAmHR;;;EA3GN,MAAA,CAAO,MAAA,EAAQ,gBAAA;EACf,MAAA,CAAO,IAAA,UAAc,WAAA,WAAsB,OAAA,GAAU,IAAA,CAAK,gBAAA;EA0GrB;AAS9C;;;;;;;;EAT8C,UA5ElC,WAAA,CAAY,MAAA,EAAQ,gBAAA,GAAmB,wBAAA;;;;;;;;;UA8CzC,iBAAA;;;;EAsBD,OAAA,CAAQ,OAAA,EAAS,iBAAA;;;;EAQX,OAAA,CAAQ,IAAA,EAAM,iBAAA,GAAiB,OAAA;AAAA;AAAA,iBAS9B,OAAA,CAAQ,OAAA,EAAS,iBAAA,GAAiB,UAAA"}

package/esm/cli/cli-command.mjs

@@ -0,0 +1,159 @@
+//#region ../../@warlock.js/core/src/cli/cli-command.ts
+var CLICommand = class {
+	/**
+	* Constructor
+	*/
+	constructor(name, description) {
+		this.name = name;
+		this.commandOptions = [];
+		this.isPersistent = false;
+		if (description) this.commandDescription = description;
+		return this;
+	}
+	/**
+	* Add command source
+	*/
+	source(source) {
+		this.commandSource = source;
+		return this;
+	}
+	/**
+	* Set command description
+	*/
+	description(description) {
+		this.commandDescription = description;
+		return this;
+	}
+	/**
+	* Determine if the command is persistent
+	*/
+	persistent(isPersistent = true) {
+		this.isPersistent = isPersistent;
+		return this;
+	}
+	/**
+	* Set command alias (short name)
+	* @example .alias("m") for "migrate"
+	*/
+	alias(alias) {
+		this.commandAlias = alias;
+		return this;
+	}
+	/**
+	* Command action
+	*/
+	action(action) {
+		this.commandAction = action;
+		return this;
+	}
+	/**
+	* Command pre action
+	* This will be executed before loading preloaders
+	*/
+	preAction(action) {
+		this.commandPreAction = action;
+		return this;
+	}
+	/**
+	* Add command options
+	*/
+	options(options) {
+		options.map((option) => this.option(option));
+		return this;
+	}
+	/**
+	* Add command relative path
+	*/
+	$relativePath(relativePath) {
+		this.commandRelativePath = relativePath;
+		return this;
+	}
+	option(...args) {
+		let option;
+		if (args.length === 1) option = args[0];
+		else option = {
+			text: args[0],
+			description: args[1],
+			...args[2],
+			name: ""
+		};
+		this.commandOptions.push(this.parseOption(option));
+		return this;
+	}
+	/**
+	* Parse option name and alias if exists
+	*
+	* Supports formats:
+	* - "--port, -p" → name: "port", alias: "p"
+	* - "-p, --port" → name: "port", alias: "p"
+	* - "--port" → name: "port", alias: undefined
+	* - "-p" → name: "p", alias: undefined
+	*/
+	parseOption(option) {
+		const parts = option.text.trim().split(",").map((part) => part.trim());
+		let name = "";
+		let alias = "";
+		if (parts.length === 1) name = this.extractOptionName(parts[0]);
+		else if (parts.length === 2) {
+			const first = parts[0];
+			const second = parts[1];
+			if (first.startsWith("--")) {
+				name = this.extractOptionName(first);
+				alias = this.extractOptionName(second);
+			} else {
+				name = this.extractOptionName(second);
+				alias = this.extractOptionName(first);
+			}
+		}
+		if (alias === "h" || name === "help") throw new Error("Help option is not allowed, it's reserved for displaying command help");
+		return {
+			...option,
+			name,
+			alias
+		};
+	}
+	/**
+	* Extract option name from text (removes -- or -)
+	*
+	* @example
+	* extractOptionName("--port") → "port"
+	* extractOptionName("-p") → "p"
+	* extractOptionName("--port=3000") → "port"
+	*/
+	extractOptionName(text) {
+		let name = text.replace(/^-+/, "");
+		const equalIndex = name.indexOf("=");
+		if (equalIndex !== -1) name = name.slice(0, equalIndex);
+		const spaceIndex = name.indexOf(" ");
+		if (spaceIndex !== -1) name = name.slice(0, spaceIndex);
+		return name.trim();
+	}
+	/**
+	* Command preload
+	*/
+	preload(options) {
+		this.commandPreload = options;
+		return this;
+	}
+	/**
+	* Execute the command
+	*/
+	async execute(data) {
+		if (!this.commandAction) throw new Error(`Command "${this.name}" has no action defined`);
+		await this.commandAction(data);
+	}
+};
+function command(options) {
+	const commandInstnace = new CLICommand(options.name, options.description);
+	if (options.preload) commandInstnace.preload(options.preload);
+	if (options.persistent) commandInstnace.persistent(options.persistent);
+	if (options.alias) commandInstnace.alias(options.alias);
+	commandInstnace.action(options.action);
+	if (options.options) commandInstnace.options(options.options);
+	if (options.preAction) commandInstnace.preAction(options.preAction);
+	return commandInstnace;
+}
+
+//#endregion
+export { CLICommand, command };
+//# sourceMappingURL=cli-command.mjs.map

package/esm/cli/cli-command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/cli/cli-command.ts"],"sourcesContent":["import type {\n  CLICommandAction,\n  CLICommandOption,\n  CLICommandOptions,\n  CLICommandPreload,\n  CLICommandSource,\n  CommandActionData,\n  ResolvedCLICommandOption,\n} from \"./types\";\n\nexport class CLICommand {\n  /**\n   * Command source\n   */\n  public commandSource?: CLICommandSource;\n\n  /**\n   * Command action\n   */\n  public commandAction?: CLICommandAction;\n\n  /**\n   * Command pre action\n   * This will be executed before loading preloaders\n   */\n  public commandPreAction?: CLICommandAction;\n\n  /**\n   *    Command preload\n   */\n  public commandPreload?: CLICommandPreload;\n\n  /**\n   * Command description\n   */\n  public commandDescription?: string;\n\n  /**\n   * Command options\n   */\n  public commandOptions: ResolvedCLICommandOption[] = [];\n\n  /**\n   * Command relative path\n   * Available only for project commands\n   * Auto injected by the framework itself\n   */\n  public commandRelativePath?: string;\n\n  /**\n   * Determine if the command is persistent\n   */\n  public isPersistent: boolean = false;\n\n  /**\n   * Command alias (short name)\n   */\n  public commandAlias?: string;\n\n  /**\n   * Constructor\n   */\n  public constructor(\n    public name: string,\n    description?: string,\n  ) {\n    if (description) {\n      this.commandDescription = description;\n    }\n\n    return this;\n  }\n\n  /**\n   * Add command source\n   */\n  public source(source: CLICommandSource): this {\n    this.commandSource = source;\n    return this;\n  }\n\n  /**\n   * Set command description\n   */\n  public description(description: string): this {\n    this.commandDescription = description;\n    return this;\n  }\n\n  /**\n   * Determine if the command is persistent\n   */\n  public persistent(isPersistent = true): this {\n    this.isPersistent = isPersistent;\n    return this;\n  }\n\n  /**\n   * Set command alias (short name)\n   * @example .alias(\"m\") for \"migrate\"\n   */\n  public alias(alias: string): this {\n    this.commandAlias = alias;\n    return this;\n  }\n\n  /**\n   * Command action\n   */\n  public action(action: CLICommandAction): this {\n    this.commandAction = action;\n    return this;\n  }\n\n  /**\n   * Command pre action\n   * This will be executed before loading preloaders\n   */\n  public preAction(action: CLICommandAction): this {\n    this.commandPreAction = action;\n    return this;\n  }\n\n  /**\n   * Add command options\n   */\n  public options(options: CLICommandOption[]): this {\n    options.map((option) => this.option(option));\n\n    return this;\n  }\n\n  /**\n   * Add command relative path\n   */\n  public $relativePath(relativePath: string) {\n    this.commandRelativePath = relativePath;\n    return this;\n  }\n\n  /**\n   * Add command option\n   */\n  public option(option: CLICommandOption): this;\n  public option(name: string, description?: string, options?: Omit<CLICommandOption, \"name\">): this;\n  public option(\n    ...args: [CLICommandOption] | [string, string?, Omit<CLICommandOption, \"name\">?]\n  ): this {\n    let option: CLICommandOption;\n    if (args.length === 1) {\n      option = args[0] as CLICommandOption;\n    } else {\n      option = {\n        text: args[0],\n        description: args[1],\n        ...args[2],\n        name: \"\",\n      };\n    }\n\n    this.commandOptions.push(this.parseOption(option));\n\n    return this;\n  }\n\n  /**\n   * Parse option name and alias if exists\n   *\n   * Supports formats:\n   * - \"--port, -p\" → name: \"port\", alias: \"p\"\n   * - \"-p, --port\" → name: \"port\", alias: \"p\"\n   * - \"--port\" → name: \"port\", alias: undefined\n   * - \"-p\" → name: \"p\", alias: undefined\n   */\n  protected parseOption(option: CLICommandOption): ResolvedCLICommandOption {\n    const text = option.text.trim();\n\n    // Split by comma to check for alias\n    const parts = text.split(\",\").map((part) => part.trim());\n\n    let name = \"\";\n    let alias = \"\";\n\n    if (parts.length === 1) {\n      // Single option: \"--port\" or \"-p\"\n      name = this.extractOptionName(parts[0]);\n    } else if (parts.length === 2) {\n      // Two options: \"--port, -p\" or \"-p, --port\"\n      const first = parts[0];\n      const second = parts[1];\n\n      // Determine which is the long form (name) and which is short (alias)\n      if (first.startsWith(\"--\")) {\n        name = this.extractOptionName(first);\n        alias = this.extractOptionName(second);\n      } else {\n        name = this.extractOptionName(second);\n        alias = this.extractOptionName(first);\n      }\n    }\n\n    if (alias === \"h\" || name === \"help\") {\n      throw new Error(\"Help option is not allowed, it's reserved for displaying command help\");\n    }\n\n    return {\n      ...option,\n      name,\n      alias,\n    };\n  }\n\n  /**\n   * Extract option name from text (removes -- or -)\n   *\n   * @example\n   * extractOptionName(\"--port\") → \"port\"\n   * extractOptionName(\"-p\") → \"p\"\n   * extractOptionName(\"--port=3000\") → \"port\"\n   */\n  private extractOptionName(text: string): string {\n    // Remove leading dashes\n    let name = text.replace(/^-+/, \"\");\n\n    // Remove value assignment if exists (e.g., \"--port=3000\" → \"port\")\n    const equalIndex = name.indexOf(\"=\");\n    if (equalIndex !== -1) {\n      name = name.slice(0, equalIndex);\n    }\n\n    // Remove angle brackets if exists (e.g., \"--port <number>\" → \"port\")\n    const spaceIndex = name.indexOf(\" \");\n    if (spaceIndex !== -1) {\n      name = name.slice(0, spaceIndex);\n    }\n\n    return name.trim();\n  }\n\n  /**\n   * Command preload\n   */\n  public preload(options: CLICommandPreload) {\n    this.commandPreload = options;\n    return this;\n  }\n\n  /**\n   * Execute the command\n   */\n  public async execute(data: CommandActionData) {\n    if (!this.commandAction) {\n      throw new Error(`Command \"${this.name}\" has no action defined`);\n    }\n\n    await this.commandAction(data);\n  }\n}\n\nexport function command(options: CLICommandOptions) {\n  const commandInstnace = new CLICommand(options.name, options.description);\n\n  if (options.preload) {\n    commandInstnace.preload(options.preload);\n  }\n\n  if (options.persistent) {\n    commandInstnace.persistent(options.persistent);\n  }\n\n  if (options.alias) {\n    commandInstnace.alias(options.alias);\n  }\n\n  commandInstnace.action(options.action);\n\n  if (options.options) {\n    commandInstnace.options(options.options);\n  }\n\n  if (options.preAction) {\n    commandInstnace.preAction(options.preAction);\n  }\n\n  return commandInstnace;\n}\n"],"mappings":"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"}

package/esm/cli/cli-commands.manager.mjs

@@ -0,0 +1,285 @@
+import { appPath } from "../utils/paths.mjs";
+import "../utils/index.mjs";
+import { Application } from "../application/application.mjs";
+import "../application/index.mjs";
+import { bootstrap } from "../bootstrap.mjs";
+import { ConnectorLifecyclePhase } from "../connectors/types.mjs";
+import { connectorsManager } from "../connectors/connectors-manager.mjs";
+import { warlockConfigManager } from "../warlock-config/warlock-config.manager.mjs";
+import { filesOrchestrator } from "../dev-server/files-orchestrator.mjs";
+import { loadConfigFiles } from "../config/load-config-files.mjs";
+import { manifestManager } from "../manifest/manifest-manager.mjs";
+import { displayCommandError, displayCommandHelp, displayCommandNotFound, displayCommandSuccess, displayExecutingCommand, displayHelp, displayMissingCommand, displayMissingOptions, displayWarlockVersionInTerminal, isMatchingCommandName } from "./cli-commands.utils.mjs";
+import { cliCommandsLoader } from "./commands-loader.mjs";
+import { frameworkCommands } from "./framework-cli-commands.mjs";
+import { parseCliArgs } from "./parse-cli-args.mjs";
+import { findSimilar } from "./string-similarity.mjs";
+import { loadEnv } from "@mongez/dotenv";
+import { colors } from "@mongez/copper";
+import { fileExistsAsync } from "@warlock.js/fs";
+
+//#region ../../@warlock.js/core/src/cli/cli-commands.manager.ts
+var CLICommandsManager = class {
+	constructor() {
+		this.commands = [];
+		this.commandsMap = /* @__PURE__ */ new Map();
+		this.aliasMap = /* @__PURE__ */ new Map();
+	}
+	/**
+	* Register the given commands
+	*/
+	register(...commands) {
+		this.commands.push(...commands);
+		commands.forEach((command) => {
+			const commandKey = command.name.split(" ")[0];
+			manifestManager.addCommandToList(command.name, {
+				relativePath: command.commandRelativePath,
+				source: command.commandSource || "project",
+				description: command.commandDescription,
+				alias: command.commandAlias,
+				options: command.commandOptions.length > 0 ? command.commandOptions : void 0
+			});
+			this.commandsMap.set(commandKey, command);
+			if (command.commandAlias) this.aliasMap.set(command.commandAlias, commandKey);
+		});
+		return this;
+	}
+	/**
+	* Get command by name or alias
+	*/
+	getCommand(name) {
+		let command = this.commandsMap.get(name);
+		if (command) return command;
+		const realName = this.aliasMap.get(name);
+		if (realName) return this.commandsMap.get(realName);
+	}
+	/**
+	* Get all command names and aliases
+	* Used for fuzzy matching suggestions
+	*/
+	getAllCommandNames() {
+		const names = [];
+		for (const name of this.commandsMap.keys()) names.push(name);
+		for (const alias of this.aliasMap.keys()) names.push(alias);
+		const manifestCommands = manifestManager.commandsJson?.commands || {};
+		for (const name of Object.keys(manifestCommands)) {
+			const baseName = name.split(" ")[0];
+			if (!names.includes(baseName)) names.push(baseName);
+			const alias = manifestCommands[name].alias;
+			if (alias && !names.includes(alias)) names.push(alias);
+		}
+		return names;
+	}
+	/**
+	* Start the cli manager
+	*/
+	async start() {
+		const { name, options, args } = parseCliArgs(process.argv);
+		if (options.noCache) {
+			manifestManager.clearCommandsCache();
+			await manifestManager.removeCommandsFile();
+		}
+		if (options.version || options.v) {
+			await displayWarlockVersionInTerminal();
+			process.exit(0);
+		}
+		await manifestManager.loadCommands();
+		this.register(...frameworkCommands.map((command) => {
+			if (!command.commandSource) command.commandSource = "framework";
+			return command;
+		}));
+		const isHelpCommand = options.help || options.h;
+		if (!name && isHelpCommand) {
+			await this.showGlobalHelp();
+			process.exit(0);
+		}
+		if (options.warmCache) {
+			await this.warmCache();
+			process.exit(0);
+		}
+		if (!name) {
+			displayMissingCommand();
+			process.exit(1);
+		}
+		const command = await this.lazyGetCommand(name);
+		if (manifestManager.hasChanges) await manifestManager.saveCommands();
+		if (!command) {
+			displayCommandNotFound(name, findSimilar(name, this.getAllCommandNames()).map((s) => s.value));
+			process.exit(1);
+		}
+		if (isHelpCommand) {
+			displayCommandHelp({
+				name: command.name,
+				alias: command.commandAlias,
+				description: command.commandDescription,
+				options: command.commandOptions
+			});
+			process.exit(0);
+		}
+		await this.execute(command, {
+			options,
+			args
+		});
+	}
+	/**
+	* Show global help with all commands
+	* Uses manifest if available for fast display
+	*/
+	async showGlobalHelp() {
+		if (manifestManager.isCommandLoaded && Object.keys(manifestManager.commandsJson?.commands || {}).length > 0) {
+			await displayHelp(Object.entries(manifestManager.commandsJson?.commands || {}).map(([name, cmd]) => ({
+				name,
+				alias: cmd.alias,
+				description: cmd.description,
+				source: cmd.source
+			})));
+			return;
+		}
+		await this.loadPluginsCommands();
+		const projectCommands = await cliCommandsLoader.scanAll();
+		this.register(...projectCommands);
+		await manifestManager.saveCommands();
+		await displayHelp(this.commands.map((cmd) => ({
+			name: cmd.name,
+			alias: cmd.commandAlias,
+			description: cmd.commandDescription,
+			source: cmd.commandSource || "project"
+		})));
+	}
+	/**
+	* Warm cache - scan all project commands and save to manifest
+	*/
+	async warmCache() {
+		console.log();
+		console.log(`  ${colors.cyan("›")} Scanning project commands...`);
+		const projectCommands = await cliCommandsLoader.scanAll();
+		this.register(...projectCommands);
+		await manifestManager.saveCommands();
+		console.log(`  ${colors.green("✔")} Cached ${colors.bold(String(projectCommands.length))} project commands`);
+		console.log();
+	}
+	/**
+	* Load plugins commands
+	*/
+	async loadPluginsCommands() {
+		await warlockConfigManager.load();
+		if (warlockConfigManager.isLoaded) this.register(...(warlockConfigManager.get("cli")?.commands || []).map((command) => {
+			if (!command.commandSource) command.commandSource = "plugin";
+			return command;
+		}));
+	}
+	/**
+	* Try to find the command based on the given command name or alias
+	*/
+	async lazyGetCommand(name) {
+		let command = this.getCommand(name);
+		if (command) return command;
+		await this.loadPluginsCommands();
+		command = this.getCommand(name);
+		if (command) return command;
+		await this.loadProjectCommands(name);
+		command = this.getCommand(name);
+		if (command) return command;
+		return null;
+	}
+	/**
+	* Load project commands
+	*/
+	async loadProjectCommands(name) {
+		const jsonCommandsFile = await manifestManager.loadCommands();
+		if (jsonCommandsFile) for (const fullCommandName in jsonCommandsFile.commands) {
+			const cmdMeta = jsonCommandsFile.commands[fullCommandName];
+			if (isMatchingCommandName(fullCommandName, name) || cmdMeta.alias === name) {
+				const commandPath = cmdMeta.relativePath;
+				if (commandPath) {
+					const executedCommand = await cliCommandsLoader.load(commandPath);
+					if (executedCommand) {
+						executedCommand.$relativePath(commandPath);
+						this.register(executedCommand);
+						return;
+					}
+				}
+			}
+		}
+		const command = await cliCommandsLoader.locate(name);
+		if (command) {
+			this.register(command);
+			return;
+		}
+	}
+	/**
+	* Validate required options
+	*/
+	validateOptions(command, options) {
+		const missing = [];
+		command.commandOptions.forEach((opt) => {
+			if (opt.required) {
+				if (!(options[opt.name] !== void 0 || opt.alias && options[opt.alias] !== void 0)) missing.push(opt);
+			}
+		});
+		return missing;
+	}
+	/**
+	* Apply default values to options
+	*/
+	applyDefaultOptions(command, options) {
+		const result = { ...options };
+		command.commandOptions.forEach((opt) => {
+			if (opt.defaultValue !== void 0) {
+				if (!(result[opt.name] !== void 0 || opt.alias && result[opt.alias] !== void 0)) result[opt.name] = opt.defaultValue;
+			}
+			if (opt.alias !== void 0 && result[opt.alias] && result[opt.name] === void 0) result[opt.name] = result[opt.alias];
+		});
+		return result;
+	}
+	/**
+	* Execute the given command
+	*/
+	async execute(command, data) {
+		const startTime = Date.now();
+		const missingOptions = this.validateOptions(command, data.options);
+		if (missingOptions.length > 0) {
+			displayMissingOptions(missingOptions);
+			process.exit(1);
+		}
+		data.options = this.applyDefaultOptions(command, data.options);
+		displayExecutingCommand(command.name);
+		if (command.commandPreAction) await command.commandPreAction(data);
+		if (command.commandPreload) await this.loadPreloaders(command);
+		try {
+			await command.execute(data);
+			if (!command.isPersistent) {
+				displayCommandSuccess(command.name, Date.now() - startTime);
+				process.exit(0);
+			}
+		} catch (error) {
+			displayCommandError(command.name, error);
+			if (!command.isPersistent) process.exit(1);
+		}
+	}
+	/**
+	* Load preloaders
+	*/
+	async loadPreloaders(command) {
+		const preloaders = command.commandPreload || {};
+		if (preloaders.runtimeStrategy) Application.setRuntimeStrategy(preloaders.runtimeStrategy);
+		if (preloaders.environemnt) Application.setEnvironment(preloaders.environemnt);
+		await warlockConfigManager.load();
+		if (preloaders.config || preloaders.bootstrap || preloaders.prestart) await filesOrchestrator.init();
+		if (preloaders.env && !preloaders.bootstrap) await loadEnv();
+		else if (preloaders.bootstrap) {
+			await bootstrap();
+			if (await fileExistsAsync(appPath("bootstrap.ts"))) await filesOrchestrator.load("src/app/bootstrap.ts");
+		}
+		if (preloaders.config) await loadConfigFiles(preloaders.config);
+		if (preloaders.prestart) {
+			if (await fileExistsAsync(appPath("prestart.ts"))) await filesOrchestrator.load("src/app/prestart.ts");
+		}
+		if (preloaders.connectors) if (preloaders.connectors === true) await connectorsManager.startPhase("early");
+		else await connectorsManager.start(preloaders.connectors);
+	}
+};
+
+//#endregion
+export { CLICommandsManager };
+//# sourceMappingURL=cli-commands.manager.mjs.map

package/esm/cli/cli-commands.manager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-commands.manager.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/cli/cli-commands.manager.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { loadEnv } from \"@mongez/dotenv\";\r\nimport { fileExistsAsync } from \"@warlock.js/fs\";\r\nimport { Application } from \"../application\";\r\nimport { bootstrap } from \"../bootstrap\";\r\nimport { loadConfigFiles } from \"../config/load-config-files\";\r\nimport { connectorsManager } from \"../connectors/connectors-manager\";\r\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\r\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\r\nimport { manifestManager } from \"../manifest/manifest-manager\";\r\nimport { appPath } from \"../utils\";\r\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\r\nimport { CLICommand } from \"./cli-command\";\r\nimport {\r\n  displayCommandError,\r\n  displayCommandHelp,\r\n  displayCommandNotFound,\r\n  displayCommandSuccess,\r\n  displayExecutingCommand,\r\n  displayHelp,\r\n  displayMissingCommand,\r\n  displayMissingOptions,\r\n  displayWarlockVersionInTerminal,\r\n  type HelpCommandInfo,\r\n  isMatchingCommandName,\r\n} from \"./cli-commands.utils\";\r\nimport { cliCommandsLoader } from \"./commands-loader\";\r\nimport { frameworkCommands } from \"./framework-cli-commands\";\r\nimport { parseCliArgs } from \"./parse-cli-args\";\r\nimport { findSimilar } from \"./string-similarity\";\r\nimport { CommandActionData, ResolvedCLICommandOption } from \"./types\";\r\n\r\nexport class CLICommandsManager {\r\n  /**\r\n   * List of commands\r\n   */\r\n  public commands: CLICommand[] = [];\r\n\r\n  /**\r\n   * Commands map (name -> command)\r\n   */\r\n  public commandsMap: Map<string, CLICommand> = new Map();\r\n\r\n  /**\r\n   * Alias map (alias -> command name)\r\n   */\r\n  public aliasMap: Map<string, string> = new Map();\r\n\r\n  /**\r\n   * Register the given commands\r\n   */\r\n  public register(...commands: CLICommand[]): this {\r\n    this.commands.push(...commands);\r\n\r\n    commands.forEach((command) => {\r\n      const commandKey = command.name.split(\" \")[0];\r\n\r\n      manifestManager.addCommandToList(command.name, {\r\n        relativePath: command.commandRelativePath,\r\n        source: command.commandSource || \"project\",\r\n        description: command.commandDescription,\r\n        alias: command.commandAlias,\r\n        options: command.commandOptions.length > 0 ? command.commandOptions : undefined,\r\n      });\r\n\r\n      this.commandsMap.set(commandKey, command);\r\n\r\n      // Register alias if exists\r\n      if (command.commandAlias) {\r\n        this.aliasMap.set(command.commandAlias, commandKey);\r\n      }\r\n    });\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Get command by name or alias\r\n   */\r\n  public getCommand(name: string): CLICommand | undefined {\r\n    // First try direct lookup\r\n    let command = this.commandsMap.get(name);\r\n    if (command) return command;\r\n\r\n    // Try alias lookup\r\n    const realName = this.aliasMap.get(name);\r\n    if (realName) {\r\n      return this.commandsMap.get(realName);\r\n    }\r\n\r\n    return;\r\n  }\r\n\r\n  /**\r\n   * Get all command names and aliases\r\n   * Used for fuzzy matching suggestions\r\n   */\r\n  public getAllCommandNames(): string[] {\r\n    const names: string[] = [];\r\n\r\n    // Add all command names\r\n    for (const name of this.commandsMap.keys()) {\r\n      names.push(name);\r\n    }\r\n\r\n    // Add all aliases\r\n    for (const alias of this.aliasMap.keys()) {\r\n      names.push(alias);\r\n    }\r\n\r\n    // Also include cached commands from manifest\r\n    const manifestCommands = manifestManager.commandsJson?.commands || {};\r\n    for (const name of Object.keys(manifestCommands)) {\r\n      const baseName = name.split(\" \")[0];\r\n      if (!names.includes(baseName)) {\r\n        names.push(baseName);\r\n      }\r\n      const alias = manifestCommands[name].alias;\r\n      if (alias && !names.includes(alias)) {\r\n        names.push(alias);\r\n      }\r\n    }\r\n\r\n    return names;\r\n  }\r\n\r\n  /**\r\n   * Start the cli manager\r\n   */\r\n  public async start() {\r\n    const { name, options, args } = parseCliArgs(process.argv);\r\n\r\n    if (options.noCache) {\r\n      manifestManager.clearCommandsCache();\r\n      // remove the commands.json file as wel\r\n      await manifestManager.removeCommandsFile();\r\n    }\r\n\r\n    if (options.version || options.v) {\r\n      await displayWarlockVersionInTerminal();\r\n      process.exit(0);\r\n    }\r\n\r\n    // Try to load from manifest first (fastest path)\r\n    await manifestManager.loadCommands();\r\n\r\n    // Register framework commands first (needed for help)\r\n    this.register(\r\n      ...frameworkCommands.map((command) => {\r\n        if (!command.commandSource) {\r\n          command.commandSource = \"framework\";\r\n        }\r\n        return command;\r\n      }),\r\n    );\r\n\r\n    const isHelpCommand = options.help || options.h;\r\n\r\n    // Handle global help (no command)\r\n    if (!name && isHelpCommand) {\r\n      await this.showGlobalHelp();\r\n      process.exit(0);\r\n    }\r\n\r\n    // Handle warm cache\r\n    if (options.warmCache) {\r\n      await this.warmCache();\r\n      process.exit(0);\r\n    }\r\n\r\n    if (!name) {\r\n      displayMissingCommand();\r\n      process.exit(1);\r\n    }\r\n\r\n    const command = await this.lazyGetCommand(name);\r\n\r\n    if (manifestManager.hasChanges) {\r\n      await manifestManager.saveCommands();\r\n    }\r\n\r\n    if (!command) {\r\n      // Find similar commands for suggestions\r\n      const allCommandNames = this.getAllCommandNames();\r\n      const suggestions = findSimilar(name, allCommandNames).map((s) => s.value);\r\n\r\n      displayCommandNotFound(name, suggestions);\r\n      process.exit(1);\r\n    }\r\n\r\n    // Handle command-specific help\r\n    if (isHelpCommand) {\r\n      displayCommandHelp({\r\n        name: command.name,\r\n        alias: command.commandAlias,\r\n        description: command.commandDescription,\r\n        options: command.commandOptions,\r\n      });\r\n      process.exit(0);\r\n    }\r\n\r\n    await this.execute(command, {\r\n      options,\r\n      args,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Show global help with all commands\r\n   * Uses manifest if available for fast display\r\n   */\r\n  protected async showGlobalHelp() {\r\n    if (\r\n      manifestManager.isCommandLoaded &&\r\n      Object.keys(manifestManager.commandsJson?.commands || {}).length > 0\r\n    ) {\r\n      // Use manifest directly - no need to load command files\r\n      const helpCommands: HelpCommandInfo[] = Object.entries(\r\n        manifestManager.commandsJson?.commands || {},\r\n      ).map(([name, cmd]) => ({\r\n        name,\r\n        alias: cmd.alias,\r\n        description: cmd.description,\r\n        source: cmd.source,\r\n      }));\r\n\r\n      await displayHelp(helpCommands);\r\n      return;\r\n    }\r\n\r\n    // Fallback: No manifest, build from registered commands\r\n    // This happens on first run before warm-cache\r\n    await this.loadPluginsCommands();\r\n\r\n    const projectCommands = await cliCommandsLoader.scanAll();\r\n\r\n    this.register(...projectCommands);\r\n\r\n    await manifestManager.saveCommands();\r\n\r\n    // Build help info from registered commands\r\n    const helpCommands: HelpCommandInfo[] = this.commands.map((cmd) => ({\r\n      name: cmd.name,\r\n      alias: cmd.commandAlias,\r\n      description: cmd.commandDescription,\r\n      source: cmd.commandSource || \"project\",\r\n    }));\r\n\r\n    await displayHelp(helpCommands);\r\n  }\r\n\r\n  /**\r\n   * Warm cache - scan all project commands and save to manifest\r\n   */\r\n  protected async warmCache() {\r\n    console.log();\r\n    console.log(`  ${colors.cyan(\"›\")} Scanning project commands...`);\r\n\r\n    const projectCommands = await cliCommandsLoader.scanAll();\r\n\r\n    this.register(...projectCommands);\r\n\r\n    await manifestManager.saveCommands();\r\n\r\n    console.log(\r\n      `  ${colors.green(\"✔\")} Cached ${colors.bold(String(projectCommands.length))} project commands`,\r\n    );\r\n    console.log();\r\n  }\r\n\r\n  /**\r\n   * Load plugins commands\r\n   */\r\n  protected async loadPluginsCommands() {\r\n    await warlockConfigManager.load();\r\n\r\n    if (warlockConfigManager.isLoaded) {\r\n      this.register(\r\n        ...(warlockConfigManager.get(\"cli\")?.commands || []).map((command) => {\r\n          if (!command.commandSource) {\r\n            command.commandSource = \"plugin\";\r\n          }\r\n          return command;\r\n        }),\r\n      );\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Try to find the command based on the given command name or alias\r\n   */\r\n  protected async lazyGetCommand(name: string) {\r\n    // first step, try to find it directly through current commands\r\n    let command = this.getCommand(name);\r\n    if (command) {\r\n      return command;\r\n    }\r\n\r\n    // second step, try to find it through warlock config commands\r\n    await this.loadPluginsCommands();\r\n\r\n    command = this.getCommand(name);\r\n\r\n    if (command) {\r\n      return command;\r\n    }\r\n\r\n    // third step, try to find it through project commands\r\n    await this.loadProjectCommands(name);\r\n\r\n    command = this.getCommand(name);\r\n    if (command) {\r\n      return command;\r\n    }\r\n\r\n    return null;\r\n  }\r\n\r\n  /**\r\n   * Load project commands\r\n   */\r\n  protected async loadProjectCommands(name: string) {\r\n    // first get the commands.json contents as an object\r\n    const jsonCommandsFile = await manifestManager.loadCommands();\r\n\r\n    if (jsonCommandsFile) {\r\n      // Check by name or alias\r\n      for (const fullCommandName in jsonCommandsFile.commands) {\r\n        const cmdMeta = jsonCommandsFile.commands[fullCommandName];\r\n\r\n        // Match by name or alias\r\n        if (isMatchingCommandName(fullCommandName, name) || cmdMeta.alias === name) {\r\n          const commandPath = cmdMeta.relativePath;\r\n          if (commandPath) {\r\n            const executedCommand = await cliCommandsLoader.load(commandPath);\r\n\r\n            if (executedCommand) {\r\n              executedCommand.$relativePath(commandPath);\r\n              this.register(executedCommand);\r\n              return;\r\n            }\r\n          }\r\n        }\r\n      }\r\n    }\r\n\r\n    const command = await cliCommandsLoader.locate(name);\r\n\r\n    if (command) {\r\n      this.register(command);\r\n      return;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Validate required options\r\n   */\r\n  protected validateOptions(\r\n    command: CLICommand,\r\n    options: Record<string, string | boolean | number>,\r\n  ): ResolvedCLICommandOption[] {\r\n    const missing: ResolvedCLICommandOption[] = [];\r\n\r\n    command.commandOptions.forEach((opt) => {\r\n      if (opt.required) {\r\n        // Check if option is provided by name or alias\r\n        const hasOption =\r\n          options[opt.name] !== undefined || (opt.alias && options[opt.alias] !== undefined);\r\n        if (!hasOption) {\r\n          missing.push(opt);\r\n        }\r\n      }\r\n    });\r\n\r\n    return missing;\r\n  }\r\n\r\n  /**\r\n   * Apply default values to options\r\n   */\r\n  protected applyDefaultOptions(\r\n    command: CLICommand,\r\n    options: Record<string, string | boolean | number>,\r\n  ): Record<string, string | boolean | number> {\r\n    const result = { ...options };\r\n\r\n    command.commandOptions.forEach((opt) => {\r\n      if (opt.defaultValue !== undefined) {\r\n        const hasOption =\r\n          result[opt.name] !== undefined || (opt.alias && result[opt.alias] !== undefined);\r\n        if (!hasOption) {\r\n          result[opt.name] = opt.defaultValue;\r\n        }\r\n      }\r\n\r\n      if (opt.alias !== undefined && result[opt.alias] && result[opt.name] === undefined) {\r\n        result[opt.name] = result[opt.alias];\r\n      }\r\n    });\r\n\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Execute the given command\r\n   */\r\n  public async execute(command: CLICommand, data: CommandActionData) {\r\n    const startTime = Date.now();\r\n\r\n    // Validate required options\r\n    const missingOptions = this.validateOptions(command, data.options);\r\n    if (missingOptions.length > 0) {\r\n      displayMissingOptions(missingOptions);\r\n      process.exit(1);\r\n    }\r\n\r\n    // Apply default values\r\n    data.options = this.applyDefaultOptions(command, data.options);\r\n\r\n    displayExecutingCommand(command.name);\r\n\r\n    if (command.commandPreAction) {\r\n      await command.commandPreAction(data);\r\n    }\r\n\r\n    // load preloaders\r\n    if (command.commandPreload) {\r\n      await this.loadPreloaders(command);\r\n    }\r\n\r\n    try {\r\n      await command.execute(data);\r\n\r\n      if (!command.isPersistent) {\r\n        displayCommandSuccess(command.name, Date.now() - startTime);\r\n\r\n        process.exit(0);\r\n      }\r\n    } catch (error) {\r\n      displayCommandError(command.name, error as Error);\r\n      // Persistent commands (dev/start) own their startup-failure exits;\r\n      // by the time an error reaches here they've already entered their\r\n      // run loop, so it's a runtime error we log but don't crash on —\r\n      // HMR or process supervisors can recover. Non-persistent\r\n      // one-shot commands always exit on failure.\r\n      if (!command.isPersistent) {\r\n        process.exit(1);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Load preloaders\r\n   */\r\n  protected async loadPreloaders(command: CLICommand) {\r\n    const preloaders = command.commandPreload || {};\r\n\r\n    if (preloaders.runtimeStrategy) {\r\n      Application.setRuntimeStrategy(preloaders.runtimeStrategy);\r\n    }\r\n\r\n    if (preloaders.environemnt) {\r\n      Application.setEnvironment(preloaders.environemnt);\r\n    }\r\n\r\n    await warlockConfigManager.load();\r\n\r\n    if (preloaders.config || preloaders.bootstrap || preloaders.prestart) {\r\n      await filesOrchestrator.init();\r\n    }\r\n\r\n    if (preloaders.env && !preloaders.bootstrap) {\r\n      await loadEnv();\r\n    } else if (preloaders.bootstrap) {\r\n      await bootstrap();\r\n\r\n      if (await fileExistsAsync(appPath(\"bootstrap.ts\"))) {\r\n        await filesOrchestrator.load(\"src/app/bootstrap.ts\");\r\n      }\r\n    }\r\n\r\n    // Load configuration files\r\n    if (preloaders.config) {\r\n      await loadConfigFiles(preloaders.config);\r\n    }\r\n\r\n    if (preloaders.prestart) {\r\n      if (await fileExistsAsync(appPath(\"prestart.ts\"))) {\r\n        await filesOrchestrator.load(\"src/app/prestart.ts\");\r\n      }\r\n    }\r\n\r\n    // Initialize connectors.\r\n    // `connectors: true` only starts the early phase here — late-phase\r\n    // connectors (http, socket) start after the command's action loads\r\n    // app code. Explicit lists bypass phase splitting (caller knows\r\n    // exactly which connectors they want).\r\n    if (preloaders.connectors) {\r\n      if (preloaders.connectors === true) {\r\n        await connectorsManager.startPhase(ConnectorLifecyclePhase.Early);\r\n      } else {\r\n        await connectorsManager.start(preloaders.connectors);\r\n      }\r\n    }\r\n  }\r\n}\r\n"],"mappings":"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"}