tiny-essentials 1.28.18 → 1.29.0

package/dist/v1/libs/tools/TinyPkgExportValidator.cjs

@@ -311,6 +311,54 @@ class TinyPkgExportValidator {
     }
   }
 
+  /**
+   * Provides a CLI-based testing interface to execute specific methods or tasks
+   * defined in the `actions` object via command-line arguments.
+   *
+   * If no command-line argument is provided, all actions in the object will be executed
+   * sequentially. If an argument is provided, only the corresponding action will run.
+   *
+   * @param {Record<string, () => Promise<void> | void>} actions - An object where keys are
+   * command names (passed via CLI) and values are the functions to be executed.
+   * @param {string[]} args - The array of command-line arguments.
+   * Defaults to `process.argv` if not provided.
+   * @throws {TypeError} If the `actions` argument is not a non-null object.
+   */
+  async execCommandTester(actions, args) {
+    if (typeof actions !== 'object' || actions === null || Array.isArray(actions)) {
+      throw new TypeError('The "actions" argument must be a non-null object.');
+    }
+    if (!Array.isArray(args) || !args.every((arg) => typeof arg === 'string')) {
+      throw new TypeError('The "args" argument must be a string array.');
+    }
+
+    // We use the 'args' parameter instead of the global 'process.argv'
+    // to allow for better dependency tracking by bundlers like Webpack.
+    const arg = args[2];
+    const availableCommands = Object.keys(actions);
+
+    // Case 1: No argument provided - Run all actions
+    if (!arg) {
+      this.#log('cyan', 'header');
+      this.#log('dim', 'Running all registered commands...');
+
+      for (const commandName of availableCommands) {
+        this.#log('cyan', `> Executing: ${commandName}`);
+        await actions[commandName]();
+      }
+    }
+    // Case 2: Specific command provided and it exists
+    else if (typeof actions[arg] === 'function') {
+      this.#log('cyan', `> Executing: ${arg}`);
+      await actions[arg]();
+    }
+    // Case 3: Argument provided but not found in actions
+    else {
+      this.#log('error', 'errorUnexpected', { message: `Unknown argument: "${arg}"` });
+      this.#log('dim', `Valid arguments are: ${availableCommands.join(', ')}`);
+    }
+  }
+
   /**
    * Loads and parses the package.json file from the specified path.
    *

package/dist/v1/libs/tools/TinyPkgExportValidator.d.mts

@@ -86,6 +86,20 @@ declare class TinyPkgExportValidator {
      * @throws {TypeError} If arguments are not strings or if options fails deep validation.
      */
     constructor(packageJsonPath: string, rootDir: string, options?: ValidatorOptions);
+    /**
+     * Provides a CLI-based testing interface to execute specific methods or tasks
+     * defined in the `actions` object via command-line arguments.
+     *
+     * If no command-line argument is provided, all actions in the object will be executed
+     * sequentially. If an argument is provided, only the corresponding action will run.
+     *
+     * @param {Record<string, () => Promise<void> | void>} actions - An object where keys are
+     * command names (passed via CLI) and values are the functions to be executed.
+     * @param {string[]} args - The array of command-line arguments.
+     * Defaults to `process.argv` if not provided.
+     * @throws {TypeError} If the `actions` argument is not a non-null object.
+     */
+    execCommandTester(actions: Record<string, () => Promise<void> | void>, args: string[]): Promise<void>;
     /**
      * Loads and parses the package.json file from the specified path.
      *

package/dist/v1/libs/tools/TinyPkgExportValidator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"TinyPkgExportValidator.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/tools/TinyPkgExportValidator.mjs"],"names":[],"mappings":"AAIG,YAAkB,aAAa,GAC/B;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAmB,GAAG,EAAX,MAAM,CACjB;;;;IAAmB,MAAM,EAAd,MAAM,CACjB;;;;IAAmB,IAAI,EAAZ,MAAM,CACjB;;;;IAAmB,GAAG,EAAX,MAAM,CACnB;CAAA,CAAA;AAGE,YAAkB,gBAAgB,GAClC;;;;IAAoB,WAAW,AAA/B,CACA,EADW,MAAM,CACjB;;;;IAAqB,MAAM,AAA3B,CACA,EADW,OAAO,CAClB;;;;IAA6B,QAAQ,AAArC,CACF,EADa,eAAe,CAC5B;CAAA,CAAA;AAGE,YAAkB,eAAe,GACjC;IAAmB,MAAM,EAAd,MAAM,CACjB;IAAoB,OAAO,EAAhB,MAAM,CACjB;IAAoB,SAAS,EAAlB,MAAM,CACjB;IAAoB,WAAW,EAApB,MAAM,CACjB;IAAoB,WAAW,EAApB,MAAM,CACjB;IAAoB,aAAa,EAAtB,MAAM,CACjB;IAAoB,aAAa,EAAtB,MAAM,CACjB;IAAoB,SAAS,EAAlB,MAAM,CACjB;IAAoB,SAAS,EAAlB,MAAM,CACjB;IAAoB,aAAa,EAAtB,MAAM,CACjB;IAAoB,UAAU,EAAnB,MAAM,CACjB;IAAoB,eAAe,EAAxB,MAAM,CACnB;CAAA,CAAA;AA4BD;;;GAGG;AACH,cAAM,sBAAsB;;IAc1B,IAAI,MAAM,IAOC,aAAa,CALvB;IAED;;;;;OAKG;IACH,IAAI,MAAM,CAAC,SAAS,EAHT,aAGS,EA6BnB;IA8BD,IAAI,WAAW,wBAEd;IACD,IAAI,eAAe,WAElB;IACD,IAAI,OAAO,WAEV;IACD,IAAI,OAAO;cA1Ba,MAAM;eAAS,OAAO;oBAAc,MAAM;QA4BjE;IACD,IAAI,OAAO,YAEV;IACD,IAAI,WAAW,WAEd;IACD,IAAI,MAAM,YAET;IAED;;;;;;;OAOG;IACH,YAAY,eAAe,EALhB,MAKgB,EAAE,OAAO,EAJzB,MAIyB,EAAE,OAAO,AAH1C,CACA,EADQ,gBAGuC,EAkBjD;IAkHD;;;;;;OAMG;IACG,KAAK,IAJE,OAAO,CAAC,IAAI,CAAC,CAoBzB;IAED;;;OAGG;IACG,QAAQ,IAFD,OAAO,CAAC,OAAO,CAAC,CA+B5B;CAwFF;eAEc,sBAAsB"}
+{"version":3,"file":"TinyPkgExportValidator.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/tools/TinyPkgExportValidator.mjs"],"names":[],"mappings":"AAIG,YAAkB,aAAa,GAC/B;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAmB,GAAG,EAAX,MAAM,CACjB;;;;IAAmB,MAAM,EAAd,MAAM,CACjB;;;;IAAmB,IAAI,EAAZ,MAAM,CACjB;;;;IAAmB,GAAG,EAAX,MAAM,CACnB;CAAA,CAAA;AAGE,YAAkB,gBAAgB,GAClC;;;;IAAoB,WAAW,AAA/B,CACA,EADW,MAAM,CACjB;;;;IAAqB,MAAM,AAA3B,CACA,EADW,OAAO,CAClB;;;;IAA6B,QAAQ,AAArC,CACF,EADa,eAAe,CAC5B;CAAA,CAAA;AAGE,YAAkB,eAAe,GACjC;IAAmB,MAAM,EAAd,MAAM,CACjB;IAAoB,OAAO,EAAhB,MAAM,CACjB;IAAoB,SAAS,EAAlB,MAAM,CACjB;IAAoB,WAAW,EAApB,MAAM,CACjB;IAAoB,WAAW,EAApB,MAAM,CACjB;IAAoB,aAAa,EAAtB,MAAM,CACjB;IAAoB,aAAa,EAAtB,MAAM,CACjB;IAAoB,SAAS,EAAlB,MAAM,CACjB;IAAoB,SAAS,EAAlB,MAAM,CACjB;IAAoB,aAAa,EAAtB,MAAM,CACjB;IAAoB,UAAU,EAAnB,MAAM,CACjB;IAAoB,eAAe,EAAxB,MAAM,CACnB;CAAA,CAAA;AA4BD;;;GAGG;AACH,cAAM,sBAAsB;;IAc1B,IAAI,MAAM,IAOC,aAAa,CALvB;IAED;;;;;OAKG;IACH,IAAI,MAAM,CAAC,SAAS,EAHT,aAGS,EA6BnB;IA8BD,IAAI,WAAW,wBAEd;IACD,IAAI,eAAe,WAElB;IACD,IAAI,OAAO,WAEV;IACD,IAAI,OAAO;cA1Ba,MAAM;eAAS,OAAO;oBAAc,MAAM;QA4BjE;IACD,IAAI,OAAO,YAEV;IACD,IAAI,WAAW,WAEd;IACD,IAAI,MAAM,YAET;IAED;;;;;;;OAOG;IACH,YAAY,eAAe,EALhB,MAKgB,EAAE,OAAO,EAJzB,MAIyB,EAAE,OAAO,AAH1C,CACA,EADQ,gBAGuC,EAkBjD;IAkHD;;;;;;;;;;;;OAYG;IACG,iBAAiB,CAAC,OAAO,EANpB,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAMrB,EAAE,IAAI,EAJ1B,MAAM,EAIoB,iBAiCpC;IAED;;;;;;OAMG;IACG,KAAK,IAJE,OAAO,CAAC,IAAI,CAAC,CAoBzB;IAED;;;OAGG;IACG,QAAQ,IAFD,OAAO,CAAC,OAAO,CAAC,CA+B5B;CAwFF;eAEc,sBAAsB"}

package/dist/v1/libs/tools/TinyPkgExportValidator.mjs

@@ -262,6 +262,50 @@ class TinyPkgExportValidator {
                 console.log(message);
         }
     }
+    /**
+     * Provides a CLI-based testing interface to execute specific methods or tasks
+     * defined in the `actions` object via command-line arguments.
+     *
+     * If no command-line argument is provided, all actions in the object will be executed
+     * sequentially. If an argument is provided, only the corresponding action will run.
+     *
+     * @param {Record<string, () => Promise<void> | void>} actions - An object where keys are
+     * command names (passed via CLI) and values are the functions to be executed.
+     * @param {string[]} args - The array of command-line arguments.
+     * Defaults to `process.argv` if not provided.
+     * @throws {TypeError} If the `actions` argument is not a non-null object.
+     */
+    async execCommandTester(actions, args) {
+        if (typeof actions !== 'object' || actions === null || Array.isArray(actions)) {
+            throw new TypeError('The "actions" argument must be a non-null object.');
+        }
+        if (!Array.isArray(args) || !args.every((arg) => typeof arg === 'string')) {
+            throw new TypeError('The "args" argument must be a string array.');
+        }
+        // We use the 'args' parameter instead of the global 'process.argv'
+        // to allow for better dependency tracking by bundlers like Webpack.
+        const arg = args[2];
+        const availableCommands = Object.keys(actions);
+        // Case 1: No argument provided - Run all actions
+        if (!arg) {
+            this.#log('cyan', 'header');
+            this.#log('dim', 'Running all registered commands...');
+            for (const commandName of availableCommands) {
+                this.#log('cyan', `> Executing: ${commandName}`);
+                await actions[commandName]();
+            }
+        }
+        // Case 2: Specific command provided and it exists
+        else if (typeof actions[arg] === 'function') {
+            this.#log('cyan', `> Executing: ${arg}`);
+            await actions[arg]();
+        }
+        // Case 3: Argument provided but not found in actions
+        else {
+            this.#log('error', 'errorUnexpected', { message: `Unknown argument: "${arg}"` });
+            this.#log('dim', `Valid arguments are: ${availableCommands.join(', ')}`);
+        }
+    }
     /**
      * Loads and parses the package.json file from the specified path.
      *