@warlock.js/core 4.0.48 → 4.0.57

package/esm/application.d.ts

@@ -0,0 +1,27 @@
+export type AppConfigurations = {
+    /**
+     * App name
+     */
+    appName?: string;
+    /**
+     * Default locale code
+     *
+     * @default en
+     */
+    localeCode?: string;
+    /**
+     * Application base URL
+     *
+     * @default localhost:
+     */
+    baseUrl?: string;
+    /**
+     * Application timezone
+     */
+    timezone?: string;
+    /**
+     * Locale Codes list
+     */
+    localeCodes?: string[];
+};
+//# sourceMappingURL=application.d.ts.map

package/esm/application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC"}

package/esm/bootstrap/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function displayEnvironmentMode(): void;
+//# sourceMappingURL=setup.d.ts.map

package/esm/bootstrap/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/bootstrap/setup.ts"],"names":[],"mappings":"AAGA,wBAAgB,sBAAsB,SAqBrC"}

package/esm/bootstrap/setup.js

@@ -0,0 +1,14 @@
+import {colors}from'@mongez/copper';import'@warlock.js/logger';import'../database/models/database-log/database-log.js';import {environment}from'../utils/environment.js';import'../http/context/request-context.js';import'@mongez/config';import'path';import'@mongez/slug';import'@mongez/supportive-is';import'@mongez/reinforcements';function displayEnvironmentMode() {
+    const env = environment();
+    const envColor = (env) => {
+        switch (env) {
+            case "development":
+                return colors.yellow(env);
+            case "production":
+                return colors.green(env);
+            case "test":
+                return colors.magentaBright(env);
+        }
+    };
+    console.log(colors.blueBright("ℹ"), colors.yellow(`(${new Date().toISOString()})`), colors.orange("[warlock]"), colors.magenta(`bootstrap`), colors.blueBright(`Starting application in ${envColor(env)} mode`));
+}export{displayEnvironmentMode};//# sourceMappingURL=setup.js.map

package/esm/bootstrap/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sources":["../../src/bootstrap/setup.ts"],"sourcesContent":[null],"names":[],"mappings":"mVAGgB,sBAAsB,GAAA;AACpC,IAAA,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;AAE1B,IAAA,MAAM,QAAQ,GAAG,CAAC,GAAW,KAAI;AAC/B,QAAA,QAAQ,GAAG;AACT,YAAA,KAAK,aAAa;AAChB,gBAAA,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,YAAA,KAAK,YAAY;AACf,gBAAA,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC3B,YAAA,KAAK,MAAM;AACT,gBAAA,OAAO,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;AACpC,SAAA;AACH,KAAC,CAAC;IAEF,OAAO,CAAC,GAAG,CACT,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EACtB,MAAM,CAAC,MAAM,CAAC,CAAI,CAAA,EAAA,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAG,CAAA,CAAA,CAAC,EAC9C,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAC1B,MAAM,CAAC,OAAO,CAAC,CAAA,SAAA,CAAW,CAAC,EAC3B,MAAM,CAAC,UAAU,CAAC,CAAA,wBAAA,EAA2B,QAAQ,CAAC,GAAG,CAAC,CAAA,KAAA,CAAO,CAAC,CACnE,CAAC;AACJ"}

package/esm/bootstrap.d.ts

@@ -0,0 +1,2 @@
+export declare function bootstrap(): Promise<void>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/esm/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAIA,wBAAsB,SAAS,kBAK9B"}

package/esm/bootstrap.js

@@ -0,0 +1,5 @@
+import {loadEnv}from'@mongez/dotenv';import {initializeDayjs}from'@mongez/time-wizard';import {captureAnyUnhandledRejection}from'@warlock.js/logger';async function bootstrap() {
+    await loadEnv();
+    initializeDayjs();
+    captureAnyUnhandledRejection();
+}export{bootstrap};//# sourceMappingURL=bootstrap.js.map

package/esm/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sources":["../src/bootstrap.ts"],"sourcesContent":[null],"names":[],"mappings":"qJAIO,eAAe,SAAS,GAAA;IAC7B,MAAM,OAAO,EAAE,CAAC;AAEhB,IAAA,eAAe,EAAE,CAAC;AAClB,IAAA,4BAA4B,EAAE,CAAC;AACjC"}

package/esm/cache/database-cache-driver.d.ts

@@ -0,0 +1,56 @@
+import { BaseCacheDriver, type CacheDriver, type CacheKey } from "@warlock.js/cache";
+import { Model } from "@warlock.js/cascade";
+export type DatabaseCacheOptions = {
+    /**
+     * Database model class
+     */
+    model?: typeof CacheModel;
+    /**
+     * Global prefix for the cache key
+     */
+    globalPrefix?: string | (() => string);
+    /**
+     * The default TTL for the cache in seconds
+     *
+     * @default Infinity
+     */
+    ttl?: number;
+};
+export declare class CacheModel extends Model {
+    static table: string;
+}
+export declare class DatabaseCacheDriver extends BaseCacheDriver<DatabaseCacheDriver, DatabaseCacheOptions> implements CacheDriver<DatabaseCacheDriver, DatabaseCacheOptions> {
+    /**
+     * {@inheritdoc}
+     */
+    name: string;
+    /**
+     * Database model class
+     */
+    model: typeof CacheModel;
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options: DatabaseCacheOptions): this;
+    /**
+     * {@inheritdoc}
+     */
+    removeNamespace(namespace: string): Promise<this>;
+    /**
+     * {@inheritdoc}
+     */
+    set(key: CacheKey, value: any, ttl?: number): Promise<this>;
+    /**
+     * {@inheritdoc}
+     */
+    get(key: CacheKey): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    remove(key: CacheKey): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=database-cache-driver.d.ts.map

package/esm/cache/database-cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-cache-driver.d.ts","sourceRoot":"","sources":["../../src/cache/database-cache-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC;IAC1B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACvC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,qBAAa,UAAW,SAAQ,KAAK;IACnC,OAAc,KAAK,SAAW;CAC/B;AAED,qBAAa,mBACX,SAAQ,eAAe,CAAC,mBAAmB,EAAE,oBAAoB,CACjE,YAAW,WAAW,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;IAEjE;;OAEG;IACI,IAAI,SAAc;IAEzB;;OAEG;IACI,KAAK,EAAG,OAAO,UAAU,CAAC;IAEjC;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,oBAAoB;IAQ/C;;OAEG;IACU,eAAe,CAAC,SAAS,EAAE,MAAM;IAc9C;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM;IAuCxD;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,QAAQ;IAuB9B;;OAEG;IACU,MAAM,CAAC,GAAG,EAAE,QAAQ;IAYjC;;OAEG;IACU,KAAK;CAUnB"}

package/esm/cache/database-cache-driver.js

@@ -0,0 +1,112 @@
+import {BaseCacheDriver}from'@warlock.js/cache';import {Model}from'@warlock.js/cascade';class CacheModel extends Model {
+    static table = "cache";
+}
+class DatabaseCacheDriver extends BaseCacheDriver {
+    /**
+     * {@inheritdoc}
+     */
+    name = "database";
+    /**
+     * Database model class
+     */
+    model;
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options) {
+        super.setOptions(options);
+        this.model = options.model ?? CacheModel;
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async removeNamespace(namespace) {
+        this.log("clearing", namespace);
+        namespace = this.parseKey(namespace);
+        await this.model.delete({
+            namespace,
+        });
+        this.log("cleared", namespace);
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async set(key, value, ttl) {
+        const parsedKey = this.parseKey(key);
+        this.log("caching", parsedKey);
+        if (ttl === undefined) {
+            ttl = this.ttl;
+        }
+        // Extract namespace: all parts except the last (e.g., "users.id.1" -> "users.id")
+        const keyParts = parsedKey.split(".");
+        const namespace = keyParts.slice(0, -1).join(".") || parsedKey;
+        // Find existing cache entry or create new one (upsert pattern)
+        let cacheEntry = await this.model.first({ key: parsedKey });
+        if (cacheEntry) {
+            // Update existing entry
+            cacheEntry.set("namespace", namespace);
+            cacheEntry.set("data", value);
+            cacheEntry.set("ttl", ttl);
+            cacheEntry.set("expiresAt", this.getExpiresAt(ttl) || null);
+            await cacheEntry.save();
+        }
+        else {
+            // Create new entry
+            await this.model.create({
+                key: parsedKey,
+                namespace,
+                data: value,
+                ttl,
+                expiresAt: this.getExpiresAt(ttl) || null,
+            });
+        }
+        this.log("cached", parsedKey);
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async get(key) {
+        const parsedKey = this.parseKey(key);
+        this.log("fetching", parsedKey);
+        const model = await this.model.first({
+            key: parsedKey,
+        });
+        if (!model) {
+            this.log("notFound", parsedKey);
+            return null;
+        }
+        const data = {
+            data: model.get("data"),
+            expiresAt: model.get("expiresAt"),
+            ttl: model.get("ttl"),
+        };
+        return this.parseCachedData(parsedKey, data);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async remove(key) {
+        const parsedKey = this.parseKey(key);
+        this.log("removing", parsedKey);
+        await this.model.delete({
+            key: parsedKey,
+        });
+        this.log("removed", parsedKey);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async flush() {
+        this.log("flushing");
+        if (this.options.globalPrefix) {
+            this.removeNamespace("");
+        }
+        else {
+            await this.model.delete();
+        }
+        this.log("flushed");
+    }
+}export{CacheModel,DatabaseCacheDriver};//# sourceMappingURL=database-cache-driver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database-cache-driver.js","sources":["../../src/cache/database-cache-driver.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/esm/cache/index.d.ts

@@ -0,0 +1,3 @@
+export { DatabaseCacheDriver } from "./database-cache-driver";
+export type { DatabaseCacheOptions } from "./database-cache-driver";
+//# sourceMappingURL=index.d.ts.map

package/esm/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/esm/cache/index.js

@@ -0,0 +1 @@
+import {DatabaseCacheDriver}from'./database-cache-driver.js';import {cache}from'@warlock.js/cache';cache.registerDriver("database", DatabaseCacheDriver);export{DatabaseCacheDriver};//# sourceMappingURL=index.js.map

package/esm/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/cache/index.ts"],"sourcesContent":[null],"names":[],"mappings":"mGAOA,KAAK,CAAC,cAAc,CAAC,UAAU,EAAE,mBAAmB,CAAC"}

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

@@ -0,0 +1,115 @@
+import type { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption } from "./types";
+export 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>;
+}
+export declare function command(options: CLICommandOptions): CLICommand;
+//# sourceMappingURL=cli-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command.d.ts","sourceRoot":"","sources":["../../src/cli/cli-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAEjB,qBAAa,UAAU;IAqDZ,IAAI,EAAE,MAAM;IApDrB;;OAEG;IACI,aAAa,CAAC,EAAE,gBAAgB,CAAC;IAExC;;OAEG;IACI,aAAa,CAAC,EAAE,gBAAgB,CAAC;IAExC;;;OAGG;IACI,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAE3C;;OAEG;IACI,cAAc,CAAC,EAAE,iBAAiB,CAAC;IAE1C;;OAEG;IACI,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAEnC;;OAEG;IACI,cAAc,EAAE,wBAAwB,EAAE,CAAM;IAEvD;;;;OAIG;IACI,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAEpC;;OAEG;IACI,YAAY,EAAE,OAAO,CAAS;IAErC;;OAEG;IACI,YAAY,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;gBAEM,IAAI,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM;IAStB;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAK7C;;OAEG;IACI,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAK7C;;OAEG;IACI,UAAU,CAAC,YAAY,UAAO,GAAG,IAAI;IAK5C;;;OAGG;IACI,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAK7C;;;OAGG;IACI,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAKhD;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAMjD;;OAEG;IACI,aAAa,CAAC,YAAY,EAAE,MAAM;IAKzC;;OAEG;IACI,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IACtC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG,IAAI;IAqBjG;;;;;;;;OAQG;IACH,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,wBAAwB;IAsCzE;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,iBAAiB;IAKzC;;OAEG;IACU,OAAO,CAAC,IAAI,EAAE,iBAAiB;CAO7C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,iBAAiB,cA0BjD"}

package/esm/cli/cli-command.js

@@ -0,0 +1,227 @@
+class CLICommand {
+    name;
+    /**
+     * Command source
+     */
+    commandSource;
+    /**
+     * Command action
+     */
+    commandAction;
+    /**
+     * Command pre action
+     * This will be executed before loading preloaders
+     */
+    commandPreAction;
+    /**
+     *    Command preload
+     */
+    commandPreload;
+    /**
+     * Command description
+     */
+    commandDescription;
+    /**
+     * Command options
+     */
+    commandOptions = [];
+    /**
+     * Command relative path
+     * Available only for project commands
+     * Auto injected by the framework itself
+     */
+    commandRelativePath;
+    /**
+     * Determine if the command is persistent
+     */
+    isPersistent = false;
+    /**
+     * Command alias (short name)
+     */
+    commandAlias;
+    /**
+     * Constructor
+     */
+    constructor(name, description) {
+        this.name = name;
+        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 text = option.text.trim();
+        // Split by comma to check for alias
+        const parts = text.split(",").map((part) => part.trim());
+        let name = "";
+        let alias = "";
+        if (parts.length === 1) {
+            // Single option: "--port" or "-p"
+            name = this.extractOptionName(parts[0]);
+        }
+        else if (parts.length === 2) {
+            // Two options: "--port, -p" or "-p, --port"
+            const first = parts[0];
+            const second = parts[1];
+            // Determine which is the long form (name) and which is short (alias)
+            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) {
+        // Remove leading dashes
+        let name = text.replace(/^-+/, "");
+        // Remove value assignment if exists (e.g., "--port=3000" → "port")
+        const equalIndex = name.indexOf("=");
+        if (equalIndex !== -1) {
+            name = name.slice(0, equalIndex);
+        }
+        // Remove angle brackets if exists (e.g., "--port <number>" → "port")
+        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;
+}export{CLICommand,command};//# sourceMappingURL=cli-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command.js","sources":["../../src/cli/cli-command.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}