@ix-xs/node-comfort 1.0.4 → 1.0.51

package/core/CLI.js

@@ -1,95 +0,0 @@
-const { spawn, execSync } = require("node:child_process");
-const EventEmitter = require("node:events");
-
-class cli_stream {
-  #processus;
-  #events = new EventEmitter();
-
-  constructor(command, args) {
-    this.#processus = spawn(command, args, {
-      shell: true,
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-
-    this.#processus.stdout.on("data", (data) => {
-      this.#events.emit("data", data.toString());
-    });
-    this.#processus.stderr.on("data", (data) => {
-      this.#events.emit("data", data.toString());
-    });
-    this.#processus.on("error", (error) => {
-      this.#events.emit("error", error);
-    });
-    this.#processus.on("exit", async (code, signal) => {
-      await this.stop();
-    });
-    this.#processus.on("close", (code, signal) => {
-      this.#events.emit("stopped", code, signal);
-    });
-  }
-
-  /**
-	 * @typedef {"error"|"data"|"stopped"} EventName
-	 * @typedef {{
-	 * error: (error: Error) => void|Promise<void>,
-	 * data: (message: string) => void|Promise<void>,
-	 * stopped: (code: number, signal: keyof import("node:child_process").ChildProcessEventMap) => void|Promise<void>,
-	 * }} EventHandler
-	 */
-  /**
-	 * @template {EventName} E
-	 * @param {E} event
-	 * @param {EventHandler[E]} handler
-	 */
-  on(event, handler) {
-    this.#events.on(event, handler);
-    return this;
-  }
-
-  async stop() {
-    return new Promise((resolve) => {
-      if (!this.#processus || this.#processus.killed) {
-        this.#processus = null;
-        return resolve();
-      }
-
-      let resolved = false;
-
-      const done = () => {
-        if (!resolved) {
-          resolved = true;
-          this.#processus = null;
-          resolve();
-        }
-      };
-
-      this.#processus.once("exit", done);
-
-      this.#processus.kill("SIGTERM");
-
-      setTimeout(() => {
-        if (this.#processus && !this.#processus.killed && !resolved) {
-          this.#processus.kill("SIGKILL");
-        }
-        done();
-      }, 5000);
-    });
-  }
-}
-
-/**
- * @module CLI
- * @description
- */
-module.exports = {
-  /**
-	 * @param {string} command
-	 */
-  cli_run: (command) => {
-    return execSync(command, {
-      shell: true,
-      stdio: "pipe",
-    });
-  },
-  cli_stream,
-};

package/core/Checker.js

@@ -1,127 +0,0 @@
-const { types } = require("node:util");
-
-/**
- * @module Checker
- * @description
- * Provides a collection of utility functions for checking JavaScript value types.
- *
- * These helpers wrap common JavaScript type checks and selected `node:util.types`
- * methods for specific built-in objects such as Map, Set, Date, and Error.
- *
- * @example
- * const nodeComfort = require("@ix-xs/node-comfort");
- *
- * console.log(nodeComfort.isArray([1, 2, 3])); // true
- * console.log(nodeComfort.isNumber(42)); // true
- * console.log(nodeComfort.isDate(new Date())); // true
- */
-
-module.exports = {
-  /**
-	 * Checks if the value is an array.
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is an array, otherwise `false`.
-	 */
-  isArray(value) {
-    return Array.isArray(value);
-  },
-
-  /**
-	 * Checks if the value is a valid number (not NaN).
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is a valid number, otherwise `false`.
-	 */
-  isNumber(value) {
-    return typeof value === "number" && !Number.isNaN(value);
-  },
-
-  /**
-	 * Checks if the value is a function.
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is a function, otherwise `false`.
-	 */
-  isFunction(value) {
-    return typeof value === "function";
-  },
-
-  /**
-	 * Checks if the value is an object (and not `null`).
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is a non-null object, otherwise `false`.
-	 */
-  isObject(value) {
-    return typeof value === "object" && value !== null;
-  },
-
-  /**
-	 * Checks if the value is a boolean.
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is a boolean, otherwise `false`.
-	 */
-  isBoolean(value) {
-    return typeof value === "boolean";
-  },
-
-  /**
-	 * Checks if the value is a string.
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is a string, otherwise `false`.
-	 */
-  isString(value) {
-    return typeof value === "string";
-  },
-
-  /**
-	 * Checks if the value is `undefined`.
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is `undefined`, otherwise `false`.
-	 */
-  isUndefined(value) {
-    return typeof value === "undefined";
-  },
-
-  /**
-	 * Checks if the value is `null`.
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is `null`, otherwise `false`.
-	 */
-  isNull(value) {
-    return value === null;
-  },
-
-  /**
-	 * Checks if the value is a valid `Date` object.
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is an instance of `Date`, otherwise `false`.
-	 */
-  isDate(value) {
-    return types.isDate(value);
-  },
-
-  /**
-	 * Checks if the value is a `Map` instance.
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is a Map, otherwise `false`.
-	 */
-  isMap(value) {
-    return types.isMap(value);
-  },
-
-  /**
-	 * Checks if the value is a `Set` instance.
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is a Set, otherwise `false`.
-	 */
-  isSet(value) {
-    return types.isSet(value);
-  },
-
-  /**
-	 * Checks if the value is a native JavaScript error (`Error`, `TypeError`, etc.).
-	 * @param {*} value - The value to check.
-	 * @returns {boolean} Returns `true` if the value is a native error, otherwise `false`.
-	 */
-  isError(value) {
-    return types.isNativeError(value);
-  },
-};

package/core/Stepper.js

@@ -1,115 +0,0 @@
-/**
- * @module Stepper
- * @description
- * Fluent step controller for sequential task execution with navigation, skipping, and indexing.
- *
- * Perfect for CLI wizards, build pipelines, tutorials, or any sequential workflow.
- * Supports forward/backward navigation, jumping to specific steps, ignoring steps, and reset.
- *
- * @example
- * const nodeComfort = require("@ix-xs/node-comfort");
- *
- * // Simple 3-step process
- * nodeComfort.step([
- *   () => console.log("Step 1: Validate config"),
- *   () => console.log("Step 2: Build assets"),
- *   () => console.log("Step 3: Deploy")
- * ])
- *   .next().next().next(); // Execute all steps
- *
- * // Interactive navigation
- * const wizard = nodeComfort.step([
- *   () => nodeComfort.log("<%yellow 1%> Enter name"),
- *   () => nodeComfort.log("<%yellow 2%> Enter email"),
- *   () => nodeComfort.log("<%green ✓%> Complete!")
- * ]);
- *
- * wizard.next().back().ignore().next(); // 1 → back to 0 → skip 1 → execute 2
- */
-module.exports = {
-  /**
-	 * Creates a step controller for sequential function execution.
-	 *
-	 * Returns fluent API with `next()`, `back()`, `at()`, `ignore()`, `reset()` methods.
-	 *
-	 * @param {Array<() => void>} steps - Array of step functions to execute.
-	 *
-	 * @example
-	 * const steps = nodeComfort.step([
-	 *   () => console.log("Install dependencies"),
-	 *   () => console.log("Compile TypeScript"),
-	 *   () => console.log("Run tests")
-	 * ]);
-	 *
-	 * steps.next().next(); // Execute steps 0, 1
-	 * steps.back();        // Go back to step 0
-	 * steps.at(2);         // Jump to step 2
-	 */
-  step(steps) {
-    let i = -1;
-
-    const _ = {
-      currentIndex: i,
-      currentStep: steps[i],
-      /**
-			 * Advances to next step and executes it (if exists).
-			 */
-      next() {
-        if (i < steps.length - 1) {
-          i++;
-          if (typeof steps[i] === "function") steps[i]();
-        }
-        return _;
-      },
-      /**
-			 * Goes back to previous step and re-executes it (if exists).
-			 */
-      back() {
-        if (i > 0) {
-          i--;
-          if (typeof steps[i] === "function") steps[i]();
-        }
-        return _;
-      },
-      /**
-			 * Jumps to specific step index and executes it.
-			 * @param {number} index - Step index (0 to steps.length-1).
-			 * @example
-			 * steps.at(2); // Jump to 3rd step
-			 */
-      at(index) {
-        if (index >= 0 && index < steps.length) {
-          i = index;
-          if (typeof steps[i] === "function") steps[i]();
-        }
-        return _;
-      },
-      /**
-			 * Advances index without executing current step.
-			 * @example
-			 * steps.next().ignore().next(); // Execute 0, skip 1, execute 2
-			 */
-      ignore() {
-        if (i < steps.length - 1) {
-          i++;
-        }
-        return _;
-      },
-      /**
-			 * Resets to initial state (index: -1).
-			 */
-      reset() {
-        i = -1;
-        return _;
-      },
-      all() {
-        while (i < steps.length - 1) {
-          this.next();
-        }
-        return _;
-      },
-    };
-
-    return _;
-  },
-};

package/core/Storage.js

@@ -1,348 +0,0 @@
-const FS = require("./FS");
-const Checker = require("./Checker");
-const { basename } = require("node:path");
-
-const originalEmitWarning = process.emitWarning;
-process.emitWarning = (warning, ...args) => {
-  if ((warning.name === "ExperimentalWarning" && warning.message.includes("SQLite")) || (typeof warning === "string" && warning.startsWith("SQLite is an experimental feature"))) {
-    return;
-  }
-
-  return originalEmitWarning.call(process, warning, ...args);
-};
-
-const { DatabaseSync } = require("node:sqlite");
-
-/**
- * @module Storage
- */
-
-module.exports = class Storage {
-  #$;
-  #statements = new Map();
-
-  /**
-   * @param {string} [path = ":memomry"]
-   */
-  constructor(path = ":memory") {
-    if (path !== ":memory" && path.includes("/")) {
-      const split = path.split("/");
-      const file = split[split.length - 1];
-      const folder = FS.createPath(path.replace(file, ""));
-
-      FS.createFolder(folder);
-    }
-
-    this.#$ = new DatabaseSync(path);
-
-    this.exec("PRAGMA journal_mode = WAL");
-    this.exec("PRAGMA foreign_keys = ON");
-  }
-
-  /**
-   * @param {string} sql
-   * @param {array|object} [options = []]
-   */
-  exec(sql, options = []) {
-    try {
-      const stmt = this.#$.prepare(sql);
-      const result = stmt.run(...Checker.isArray(options) ? options : [options]);
-
-      return {
-        changes: result.changes,
-        lastInsertRowid: result.lastInsertRowid,
-      };
-
-    } catch (error) {
-      throw error;
-    }
-  }
-
-  /**
-   * @param {string} sql
-   * @param {array|object} [options = []]
-   */
-  getOne(sql, options = []) {
-    try {
-      const stmt = this.#$.prepare(sql);
-
-      return stmt.get(...Checker.isArray(options) ? options : [options]) || null;
-    } catch (error) {
-      throw error;
-    }
-  }
-
-  /**
-   * @param {string} sql
-   * @param {array|object} [options = []]
-   */
-  getAll(sql, options = []) {
-    try {
-      const stmt = this.#$.prepare(sql);
-
-      return stmt.all(...Checker.isArray(options) ? options : [options]) || [];
-    } catch (error) {
-      throw error;
-    }
-  }
-
-  /**
-   * @param {string} name
-   * @param {string} sql
-   */
-  prepare(name, sql) {
-    if (this.#statements.has(name)) {
-      return this.#statements.get(name);
-    }
-
-    const stmt = this.#$.prepare(sql);
-
-    this.#statements.set(name, stmt);
-
-    return stmt;
-  }
-
-  /**
-   * @param {string} table
-   * @param {object} schema
-   */
-  createTable(table, schema) {
-    const columns = Object.entries(schema)
-      .map(([key, type]) => `${key} ${type}`)
-      .join(", ");
-
-    const sql = `CREATE TABLE IF NOT EXISTS ${table} (${columns})`;
-
-    this.exec(sql);
-  }
-
-  /**
-   * @param {string} table
-   * @param {object} data
-   */
-  insert(table, data) {
-    const keys = Object.keys(data);
-    const placeholders = keys.map(() => "?").join(", ");
-    const sql = `INSERT INTO ${table} (${keys.join(", ")}) VALUES (${placeholders})`;
-
-    const result = this.exec(sql, Object.values(data));
-
-    return result.lastInsertRowid;
-  }
-
-  /**
-   * @param {string} table
-   * @param {number} id
-   * @returns {object|null}
-   */
-  findById(table, id) {
-    return this.getOne(`SELECT * FROM ${table} WHERE id = ?`, [id]);
-  }
-
-  /**
-   * @param {string} table
-   * @param {object} [where = {}]
-   * @param {object} [options = {}]
-   */
-  findAll(table, where, options) {
-    const { limit = 100, offset = 0, orderBy = "id" } = options;
-
-    let sql = `SELECT * FROM ${table}`;
-
-    if (Object.keys(where).length > 0) {
-      const conditions = Object.keys(where)
-        .map(key => `${key} = ?`)
-        .join(" AND ");
-      sql += ` WHERE ${conditions}`;
-    }
-
-    sql += ` ORDER BY ${orderBy} LIMIT ? OFFSET ?`;
-
-    const params = [...Object.values(where), limit, offset];
-
-    return this.getAll(sql, params);
-  }
-
-  /**
-   * @param {string} table
-   * @param {object} [where]
-   */
-  count(table, where = {}) {
-    let sql = `SELECT COUNT(*) as count FROM ${table}`;
-
-    if (Object.keys(where).length > 0) {
-      const conditions = Object.keys(where)
-        .map(key => `${key} = ?`)
-        .join(" AND ");
-      sql += ` WHERE ${conditions}`;
-    }
-
-    const result = this.getOne(sql, Object.values(where));
-
-    return result?.count || 0;
-  }
-
-  /**
-   * @param {string} table
-   * @param {number} id
-   * @param {object} data
-   */
-  update(table, id, data) {
-    const keys = Object.keys(data);
-    const setClause = keys.map(key => `${key} = ?`).join(", ");
-    const sql = `UPDATE ${table} SET ${setClause} WHERE id = ?`;
-
-    const result = this.exec(sql, [...Object.values(data), id]);
-
-    return result.changes;
-  }
-
-  /**
-   * @param {string} table
-   * @param {number} id
-   */
-  delete(table, id) {
-    const sql = `DELETE FROM ${table} WHERE id = ?`;
-    const result = this.exec(sql, [id]);
-
-    return result.changes;
-  }
-
-  /**
-   * @param {string} table
-   * @param {object} data
-   * @param {string} [conflictColumn]
-   */
-  upsert(table, data, conflictColumn = "id") {
-    const keys = Object.keys(data);
-    const placeholders = keys.map(() => "?").join(", ");
-    const updates = keys
-      .filter(k => k !== conflictColumn)
-      .map(k => `${k} = EXCLUDED.${k}`)
-      .join(", ");
-
-    const sql = `
-      INSERT INTO ${table} (${keys.join(", ")})
-      VALUES (${placeholders})
-      ON CONFLICT(${conflictColumn})
-      DO UPDATE SET ${updates}
-    `;
-
-    return this.exec(sql, Object.values(data));
-  }
-
-  /**
-   * @param {function} callback
-   */
-  transaction(callback) {
-    try {
-      this.exec("BEGIN TRANSACTION");
-
-      const result = callback();
-
-      this.exec("COMMIT");
-
-      return result;
-    } catch (error) {
-      this.exec("ROLLBACK");
-      throw error;
-    }
-  }
-
-  /**
-   * @param {string} migrationsDir - Répertoire contenant les migrations
-   */
-  runMigrations(migrationsDir) {
-    if (!FS.getFolder(migrationsDir)) {
-      FS.createFolder(migrationsDir);
-
-      return;
-    }
-
-    const migrationFiles = FS.getFilesIn(migrationsDir).filter(f => f.endsWith(".sql")).sort();
-
-    this.createTable("__migrations", {
-      name: "TEXT PRIMARY KEY",
-      executed_at: "DATETIME DEFAULT CURRENT_TIMESTAMP",
-    });
-
-    for (const file of migrationFiles) {
-      const migrationName = basename(file, ".sql");
-      const alreadyRun = this.getOne("SELECT * FROM __migrations WHERE name = ?", [migrationName]);
-
-      if (!alreadyRun) {
-        const sql = FS.readFile(`${migrationsDir}/${file}`);
-
-        try {
-          this.exec(sql);
-          this.insert("__migrations", { name: migrationName });
-        } catch (error) {
-          throw error;
-        }
-      }
-    }
-  }
-
-  /**
-   * @param {string} table
-   */
-  export(table) {
-    return this.getAll(`SELECT * FROM ${table}`);
-  }
-
-  /**
-   * @param {string} table
-   * @param {array} data
-   */
-  import(table, data) {
-    let count = 0;
-    this.transaction(() => {
-      for (const row of data) {
-        this.insert(table, row);
-        count++;
-      }
-    });
-    return count;
-  }
-
-  /**
-   * @param {string} table
-   */
-  truncate(table) {
-    this.exec(`DELETE FROM ${table}`);
-  }
-
-  /**
-   * @param {string} indexName
-   * @param {string} table
-   * @param {string} columns
-   */
-  createIndex(indexName, table, columns) {
-    this.exec(`CREATE INDEX IF NOT EXISTS ${indexName} ON ${table} (${columns})`);
-  }
-
-  /**
-   * @returns {object}
-   */
-  stats() {
-    const tables = this.getAll("SELECT name FROM sqlite_master WHERE type='table'");
-    const stats = {};
-
-    for (const { name } of tables) {
-      if (!name.startsWith("__")) {
-        const count = this.count(name);
-        stats[name] = count;
-      }
-    }
-
-    return stats;
-  }
-
-  close() {
-    if (this.db) {
-      this.#$.close();
-      this.#statements.clear();
-      this.#$ = null;
-    }
-  }
-};