@ix-xs/node-comfort 1.0.1 → 1.0.2

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@ix-xs/node-comfort",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "",
   "main": "index.js",
+  "types": "types/index.d.ts",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+	"compilerOptions": {
+		"target": "ES2022",
+		"module": "CommonJS",
+		"allowJs": true,
+		"declaration": true,
+		"emitDeclarationOnly": true,
+		"outDir": "types",
+		"declarationMap": true,
+		"skipLibCheck": true,
+		"forceConsistentCasingInFileNames": true,
+		"moduleResolution": "node",
+		"esModuleInterop": true,
+		"resolveJsonModule": true
+	},
+	"include": ["**/*"],
+	"exclude": ["node_modules", "types"]
+}

package/types/core/CLI.d.ts

@@ -0,0 +1,25 @@
+export class cli_stream {
+    constructor(command: any, args: any);
+    /**
+       * @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<E extends "data" | "error" | "stopped">(event: E, handler: {
+        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>;
+    }[E]): this;
+    stop(): Promise<any>;
+    #private;
+}
+export declare function cli_run(command: string): NonSharedBuffer & string;
+//# sourceMappingURL=CLI.d.ts.map

package/types/core/CLI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../core/CLI.js"],"names":[],"mappings":"AAGA;IAIE,qCAqBC;IAED;;;;;;;SAOE;IACF;;;;SAIE;IACF,GAJwB,CAAC,SAAb,4BAAW,SACb,CAAC;eAPF,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC;cACrC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC;iBACpC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,oBAAoB,EAAE,oBAAoB,KAAK,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC;gBAW/G;IAED,qBA4BC;;CACF;AAUU,yCAFC,MAAM,4BAOf"}

package/types/core/Checker.d.ts

@@ -0,0 +1,73 @@
+/**
+   * 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`.
+   */
+export function isArray(value: any): boolean;
+/**
+   * 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`.
+   */
+export function isNumber(value: any): boolean;
+/**
+   * 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`.
+   */
+export function isFunction(value: any): boolean;
+/**
+   * 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`.
+   */
+export function isObject(value: any): boolean;
+/**
+   * 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`.
+   */
+export function isBoolean(value: any): 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`.
+   */
+export function isString(value: any): boolean;
+/**
+   * Checks if the value is `undefined`.
+   * @param {*} value - The value to check.
+   * @returns {boolean} Returns `true` if the value is `undefined`, otherwise `false`.
+   */
+export function isUndefined(value: any): boolean;
+/**
+   * Checks if the value is `null`.
+   * @param {*} value - The value to check.
+   * @returns {boolean} Returns `true` if the value is `null`, otherwise `false`.
+   */
+export function isNull(value: any): boolean;
+/**
+   * 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`.
+   */
+export function isDate(value: any): boolean;
+/**
+   * 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`.
+   */
+export function isMap(value: any): boolean;
+/**
+   * 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`.
+   */
+export function isSet(value: any): boolean;
+/**
+   * 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`.
+   */
+export function isError(value: any): boolean;
+//# sourceMappingURL=Checker.d.ts.map

package/types/core/Checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checker.d.ts","sourceRoot":"","sources":["../../core/Checker.js"],"names":[],"mappings":"AAmBE;;;;KAIE;AACF,+BAHU,GAAC,GACC,OAAO,CAIlB;AAED;;;;KAIE;AACF,gCAHU,GAAC,GACC,OAAO,CAIlB;AAED;;;;KAIE;AACF,kCAHU,GAAC,GACC,OAAO,CAIlB;AAED;;;;KAIE;AACF,gCAHU,GAAC,GACC,OAAO,CAIlB;AAED;;;;KAIE;AACF,iCAHU,GAAC,GACC,OAAO,CAIlB;AAED;;;;KAIE;AACF,gCAHU,GAAC,GACC,OAAO,CAIlB;AAED;;;;KAIE;AACF,mCAHU,GAAC,GACC,OAAO,CAIlB;AAED;;;;KAIE;AACF,8BAHU,GAAC,GACC,OAAO,CAIlB;AAED;;;;KAIE;AACF,8BAHU,GAAC,GACC,OAAO,CAIlB;AAED;;;;KAIE;AACF,6BAHU,GAAC,GACC,OAAO,CAIlB;AAED;;;;KAIE;AACF,6BAHU,GAAC,GACC,OAAO,CAIlB;AAED;;;;KAIE;AACF,+BAHU,GAAC,GACC,OAAO,CAIlB"}

package/types/core/FS.d.ts

@@ -0,0 +1,211 @@
+/**
+   * Safely read an environment variable.
+   *
+   * Loads variables from the default `.env` file (if present) and then
+   * returns the value for the given key. When `options.envFile` is provided,
+   * the function expects `process.env[options.envFile]` to be an object
+   * containing namespaced environment variables (e.g. per environment).
+   *
+   * @param {string} env - Environment variable name (e.g. "PORT").
+   * @param {object} [options] - Optional configuration object.
+   * @param {string} [options.envFile] - Name of a namespaced env container under `process.env`.
+   * @returns {string|undefined} The environment variable value, or `undefined` if not found.
+   */
+export function getEnv(env: string, options?: {
+    envFile?: string;
+}): string | undefined;
+/**
+   * Resolves path relative to caller file or current directory.
+   * Supports `./`, `../`, absolute paths, and searches for existing paths.
+   * @param {string} [path=process.cwd()] - Path to resolve.
+   * @returns {string} Resolved absolute path.
+   * @example
+   * nodeComfort.createPath("./data/users"); // Resolves from caller file
+   */
+export function createPath(path?: string): string;
+/**
+   * Returns all folders in path (recursive option).
+   * @param {string} [path=process.cwd()] - Starting directory.
+   * @param {boolean} [recursive=true] - Include subfolders.
+   * @returns {string[]|undefined} Array of folder paths.
+   */
+export function getFoldersIn(path?: string, recursive?: boolean): string[] | undefined;
+/**
+   * Resolves and returns existing folder path.
+   * @param {string} [path=process.cwd()] - Folder path.
+   * @returns {string|undefined} Absolute folder path.
+   */
+export function getFolder(path?: string): string | undefined;
+/**
+   * Returns all files in path (recursive option).
+   * @param {string} [path=process.cwd()] - Starting directory.
+   * @param {boolean} [recursive=true] - Include subdirectories.
+   * @returns {string[]|undefined} Array of file paths.
+   */
+export function getFilesIn(path?: string, recursive?: boolean): string[] | undefined;
+/**
+   * Resolves and returns existing file path.
+   * @param {string} path - File path.
+   * @returns {string|undefined} Absolute file path.
+   */
+export function getFile(path: string): string | undefined;
+/**
+   * Creates folder (recursive) with force overwrite option.
+   * @param {string} path - Folder path to create.
+   * @param {boolean} [force=false] - Overwrite if exists.
+   * @returns {boolean|undefined} Success status.
+   */
+export function createFolder(path: string, force?: boolean): boolean | undefined;
+/**
+   * Creates file with auto-directory creation and content serialization.
+   * Supports string, object (→ JSON), null/undefined (→ empty).
+   * @param {string} path - File path.
+   * @param {boolean} [force=false] - Overwrite if exists.
+   * @param {string|object|null|undefined} [data] - File content.
+   * @returns {boolean|undefined} Success status.
+   * @example
+   * nodeComfort.createFile("config.json", false, { apiKey: "secret" });
+   */
+export function createFile(path: string, force?: boolean, data?: string | object | null | undefined): boolean | undefined;
+/**
+   * Deletes multiple folders matching filter.
+   * @param {string} [path=process.cwd()] - Starting directory.
+   * @param {(folder: string) => boolean} [filter] - Folder filter function.
+   * @returns {number|undefined} Count of deleted folders.
+   */
+export function deleteFoldersIn(path?: string, filter?: (folder: string) => boolean): number | undefined;
+/**
+   * Deletes folder and all contents recursively.
+   * @param {string} path - Folder path.
+   * @returns {boolean|undefined} Success status.
+   */
+export function deleteFolder(path: string): boolean | undefined;
+/**
+   * Deletes multiple files matching filter.
+   * @param {string} [path=process.cwd()] - Starting directory.
+   * @param {boolean} [recursive=false] - Search subdirectories.
+   * @param {(file: string) => boolean} [filter] - File filter function.
+   * @returns {number|undefined} Count of deleted files.
+   */
+export function deleteFilesIn(path?: string, recursive?: boolean, filter?: (file: string) => boolean): number | undefined;
+/**
+   * Deletes single file.
+   * @param {string} path - File path.
+   * @returns {boolean|undefined} Success status.
+   */
+export function deleteFile(path: string): boolean | undefined;
+/**
+   * Copies multiple folders with optional files and recursive support.
+   * @param {Object} options - Copy options.
+   * @param {string} options.dest - Destination base path.
+   * @param {string} [options.path] - Source path.
+   * @param {boolean} [options.recursive=true] - Copy subfolders.
+   * @param {boolean} [options.withFiles=false] - Include files.
+   * @param {boolean} [options.force=false] - Overwrite existing.
+   * @param {(folder: string) => boolean} [options.filter] - Folder filter.
+   * @returns {number|undefined} Count of copied folders.
+   */
+export function copyFoldersIn(options: {
+    dest: string;
+    path?: string;
+    recursive?: boolean;
+    withFiles?: boolean;
+    force?: boolean;
+    filter?: (folder: string) => boolean;
+}): number | undefined;
+/**
+   * Copies single folder with optional contents.
+   * @param {Object} options - Copy options.
+   * @param {string} options.dest - Destination path.
+   * @param {string} [options.path] - Source path.
+   * @param {boolean} [options.recursive=false] - Copy subfolders.
+   * @param {boolean} [options.withFiles=false] - Include files.
+   * @param {boolean} [options.force=false] - Overwrite existing.
+   * @returns {boolean|undefined} Success status.
+   */
+export function copyFolder(options: {
+    dest: string;
+    path?: string;
+    recursive?: boolean;
+    withFiles?: boolean;
+    force?: boolean;
+}): boolean | undefined;
+/**
+   * Copies multiple files with optional recursive structure preservation.
+   * @param {Object} options - Copy options.
+   * @param {string} options.dest - Destination base path.
+   * @param {string} [options.path] - Source path.
+   * @param {boolean} [options.recursive=true] - Preserve directory structure.
+   * @param {boolean} [options.force=false] - Overwrite existing.
+   * @param {(file: string) => boolean} [options.filter] - File filter.
+   * @returns {number|undefined} Count of copied files.
+   */
+export function copyFilesIn(options: {
+    dest: string;
+    path?: string;
+    recursive?: boolean;
+    force?: boolean;
+    filter?: (file: string) => boolean;
+}): number | undefined;
+/**
+   * Copies single file to destination (auto-creates parent folders).
+   * @param {Object} options - Copy options.
+   * @param {string} options.path - Source file path.
+   * @param {string} options.dest - Destination path or folder.
+   * @param {boolean} [options.force=false] - Overwrite existing.
+   * @returns {boolean|undefined} Success status.
+   */
+export function copyFile(options: {
+    path: string;
+    dest: string;
+    force?: boolean;
+}): boolean | undefined;
+/**
+   * Moves multiple folders (copy + delete source).
+   * @param {Object} options - Move options (same as copyFoldersIn).
+   * @returns {number|undefined} Count of moved folders.
+   */
+export function moveFoldersIn(options: any): number | undefined;
+/**
+   * Moves single folder (copy + delete source).
+   * @param {Object} options - Move options (same as copyFolder).
+   * @returns {boolean|undefined} Success status.
+   */
+export function moveFolder(options: any): boolean | undefined;
+/**
+   * Moves multiple files (copy + delete source).
+   * @param {Object} options - Move options (same as copyFilesIn).
+   * @returns {number|undefined} Count of moved files.
+   */
+export function moveFilesIn(options: any): number | undefined;
+/**
+   * Moves single file (copy + delete source).
+   * @param {Object} options - Move options (same as copyFile).
+   * @returns {boolean|undefined} Success status.
+   */
+export function moveFile(options: any): boolean | undefined;
+/**
+   * Reads file content synchronously.
+   * @param {string} path - File path.
+   * @returns {string|undefined} File content or undefined.
+   */
+export function readFile(path: string): string | undefined;
+/**
+   * Creates file system watcher with event filtering and pause/resume.
+   * @param {Object} [options] - Watcher options.
+   * @param {string} [options.path=process.cwd()] - Watch path.
+   * @param {boolean} [options.recursive=false] - Watch subdirectories.
+   * @param {(event: string, file: string) => boolean} [options.filter] - Event filter.
+   * @returns {Object|undefined} Watcher API.
+   * @example
+   * const watcher = nodeComfort.watch({ path: "./src", recursive: true });
+   * watcher.on("change", (file) => console.log("Changed:", file));
+   * watcher.on("rename", (file) => console.log("Renamed:", file));
+   * watcher.on("all", (event, file) => console.log(event, file));
+   */
+export function watch(options?: {
+    path?: string;
+    recursive?: boolean;
+    filter?: (event: string, file: string) => boolean;
+}): any | undefined;
+//# sourceMappingURL=FS.d.ts.map

package/types/core/FS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FS.d.ts","sourceRoot":"","sources":["../../core/FS.js"],"names":[],"mappings":"AAwME;;;;;;;;;;;;KAYE;AACF,4BALU,MAAM,YAEd;IAAyB,OAAO,GAAxB,MAAM;CACd,GAAU,MAAM,GAAC,SAAS,CAO3B;AACD;;;;;;;KAOE;AACF,kCALU,MAAM,GACJ,MAAM,CAajB;AAED;;;;;KAKE;AACF,oCAJU,MAAM,cACN,OAAO,GACL,MAAM,EAAE,GAAC,SAAS,CAK7B;AAED;;;;KAIE;AACF,iCAHU,MAAM,GACJ,MAAM,GAAC,SAAS,CAI3B;AAED;;;;;KAKE;AACF,kCAJU,MAAM,cACN,OAAO,GACL,MAAM,EAAE,GAAC,SAAS,CAK7B;AAED;;;;KAIE;AACF,8BAHU,MAAM,GACJ,MAAM,GAAC,SAAS,CAI3B;AAED;;;;;KAKE;AACF,mCAJU,MAAM,UACN,OAAO,GACL,OAAO,GAAC,SAAS,CAoB5B;AAED;;;;;;;;;KASE;AACF,iCAPU,MAAM,UACN,OAAO,SACP,MAAM,GAAC,MAAM,GAAC,IAAI,GAAC,SAAS,GAC1B,OAAO,GAAC,SAAS,CAiC5B;AAED;;;;;KAKE;AACF,uCAJU,MAAM,WACN,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GACzB,MAAM,GAAC,SAAS,CAe3B;AAED;;;;KAIE;AACF,mCAHU,MAAM,GACJ,OAAO,GAAC,SAAS,CAY5B;AAED;;;;;;KAME;AACF,qCALU,MAAM,cACN,OAAO,WACP,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACvB,MAAM,GAAC,SAAS,CAe3B;AAED;;;;KAIE;AACF,iCAHU,MAAM,GACJ,OAAO,GAAC,SAAS,CAY5B;AAED;;;;;;;;;;KAUE;AACF,uCARE;IAAwB,IAAI,EAApB,MAAM;IACW,IAAI,GAArB,MAAM;IACY,SAAS,GAA3B,OAAO;IACW,SAAS,GAA3B,OAAO;IACW,KAAK,GAAvB,OAAO;IAC+B,MAAM,GAA5C,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO;CACnC,GAAU,MAAM,GAAC,SAAS,CA0C3B;AAED;;;;;;;;;KASE;AACF,oCAPE;IAAwB,IAAI,EAApB,MAAM;IACW,IAAI,GAArB,MAAM;IACY,SAAS,GAA3B,OAAO;IACW,SAAS,GAA3B,OAAO;IACW,KAAK,GAAvB,OAAO;CACf,GAAU,OAAO,GAAC,SAAS,CA0C5B;AAED;;;;;;;;;KASE;AACF,qCAPE;IAAwB,IAAI,EAApB,MAAM;IACW,IAAI,GAArB,MAAM;IACY,SAAS,GAA3B,OAAO;IACW,KAAK,GAAvB,OAAO;IAC6B,MAAM,GAA1C,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO;CACjC,GAAU,MAAM,GAAC,SAAS,CA+B3B;AAED;;;;;;;KAOE;AACF,kCALE;IAAwB,IAAI,EAApB,MAAM;IACU,IAAI,EAApB,MAAM;IACY,KAAK,GAAvB,OAAO;CACf,GAAU,OAAO,GAAC,SAAS,CAwB5B;AAED;;;;KAIE;AACF,6CAFY,MAAM,GAAC,SAAS,CAkB3B;AAED;;;;KAIE;AACF,0CAFY,OAAO,GAAC,SAAS,CAS5B;AAED;;;;KAIE;AACF,2CAFY,MAAM,GAAC,SAAS,CAkB3B;AAED;;;;KAIE;AACF,wCAFY,OAAO,GAAC,SAAS,CAS5B;AAED;;;;KAIE;AACF,+BAHU,MAAM,GACJ,MAAM,GAAC,SAAS,CAW3B;AAED;;;;;;;;;;;;KAYE;AACF,gCAVE;IAAyB,IAAI,GAArB,MAAM;IACY,SAAS,GAA3B,OAAO;IAC4C,MAAM,GAAzD,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO;CAChD,GAAU,MAAO,SAAS,CAmE3B"}

package/types/core/Logger.d.ts

@@ -0,0 +1,62 @@
+/**
+   * Logs content with colors, timestamp, and group indentation.
+   * Supports strings, objects (pretty JSON), and chaining.
+   *
+   * @param {any} content - Content to log (string, object, or primitive).
+   * @returns {this} Chainable instance.
+   * @example
+   * nodeComfort.log("<%greenBright ✓ Done%>");
+   * nodeComfort.log({ users: 42, active: true });
+   * nodeComfort.group("Files").log("Processing...").groupEnd();
+   */
+export function log(content: any): this;
+/**
+   * Formats content with colors, timestamp, and group indentation (no console output).
+   *
+   * @param {any} content - Content to format.
+   * @returns {string} Formatted string.
+   * @example
+   * const msg = nodeComfort.logify("<%redBright ERROR%> Invalid input");
+   * console.log(msg);
+   */
+export function logify(content: any): string;
+/**
+   * Starts a new log group with ▼ indicator and increased indentation.
+   *
+   * @param {string} label - Group label (supports colors).
+   * @returns {this} Chainable instance.
+   * @example
+   * nodeComfort.group("<%yellow Processing%>").log("Step 1").groupEnd();
+   */
+export function group(label: string): this;
+/**
+   * Ends current group and reduces indentation.
+   *
+   * @returns {this} Chainable instance.
+   * @example
+   * nodeComfort.group("Work").groupEnd();
+   */
+export function groupEnd(): this;
+/**
+   * Configures logger options (delimiters and timestamp).
+   *
+   * @param {object} [options] - Logger options.
+   * @param {object} [options.delimiters] - Template delimiters.
+   * @param {string} [options.delimiters.start="<%="] - Start delimiter.
+   * @param {string} [options.delimiters.end="%>"] - End delimiter.
+   * @param {boolean} [options.timestamp=true] - Show timestamps.
+   * @returns {this} Chainable instance.
+   * @example
+   * nodeComfort.setLogger({
+   *   delimiters: { start: "{{", end: "}}" },
+   *   timestamp: false
+   * }).log("{{ bgGreen new delimiters }}");
+   */
+export function setLogger(options?: {
+    delimiters?: {
+        start?: string;
+        end?: string;
+    };
+    timestamp?: boolean;
+}): this;
+//# sourceMappingURL=Logger.d.ts.map

package/types/core/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../core/Logger.js"],"names":[],"mappings":"AAuME;;;;;;;;;;KAUE;AACF,6BAPU,GAAG,GACD,IAAI,CAqCf;AAED;;;;;;;;KAQE;AACF,gCANU,GAAG,GACD,MAAM,CAiBjB;AAED;;;;;;;KAOE;AACF,6BALU,MAAM,GACJ,IAAI,CASf;AAED;;;;;;KAME;AACF,4BAJY,IAAI,CAOf;AAED;;;;;;;;;;;;;;KAcE;AACF,oCAXE;IAAyB,UAAU,GACnC;QAAoC,KAAK,GAAjC,MAAM;QACsB,GAAG,GAA/B,MAAM;KACd;IAA0B,SAAS,GAA3B,OAAO;CACf,GAAU,IAAI,CAkBf"}

package/types/core/Stepper.d.ts

@@ -0,0 +1,49 @@
+/**
+   * 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
+   */
+export function step(steps: Array<() => void>): {
+    currentIndex: number;
+    currentStep: () => void;
+    /**
+           * Advances to next step and executes it (if exists).
+           */
+    next(): /*elided*/ any;
+    /**
+           * Goes back to previous step and re-executes it (if exists).
+           */
+    back(): /*elided*/ any;
+    /**
+           * 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: number): /*elided*/ any;
+    /**
+           * Advances index without executing current step.
+           * @example
+           * steps.next().ignore().next(); // Execute 0, skip 1, execute 2
+           */
+    ignore(): /*elided*/ any;
+    /**
+           * Resets to initial state (index: -1).
+           */
+    reset(): /*elided*/ any;
+    all(): /*elided*/ any;
+};
+//# sourceMappingURL=Stepper.d.ts.map

package/types/core/Stepper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stepper.d.ts","sourceRoot":"","sources":["../../core/Stepper.js"],"names":[],"mappings":"AA6BE;;;;;;;;;;;;;;;;;KAiBE;AACF,4BAbU,KAAK,CAAC,MAAM,IAAI,CAAC;;uBAAL,IAAI;IAmBtB;;aAEA;;IAQA;;aAEA;;IAQA;;;;;aAKA;cAHQ,MAAM;IAWd;;;;aAIA;;IAOA;;aAEA;;;EAcH"}

package/types/core/Storage.d.ts

@@ -0,0 +1,111 @@
+export = Storage;
+declare class Storage {
+    /**
+     * @param {string} [path = ":memomry"]
+     */
+    constructor(path?: string);
+    /**
+     * @param {string} sql
+     * @param {array|object} [options = []]
+     */
+    exec(sql: string, options?: any[] | object): {
+        changes: any;
+        lastInsertRowid: any;
+    };
+    /**
+     * @param {string} sql
+     * @param {array|object} [options = []]
+     */
+    getOne(sql: string, options?: any[] | object): any;
+    /**
+     * @param {string} sql
+     * @param {array|object} [options = []]
+     */
+    getAll(sql: string, options?: any[] | object): any;
+    /**
+     * @param {string} name
+     * @param {string} sql
+     */
+    prepare(name: string, sql: string): any;
+    /**
+     * @param {string} table
+     * @param {object} schema
+     */
+    createTable(table: string, schema: object): void;
+    /**
+     * @param {string} table
+     * @param {object} data
+     */
+    insert(table: string, data: object): any;
+    /**
+     * @param {string} table
+     * @param {number} id
+     * @returns {object|null}
+     */
+    findById(table: string, id: number): object | null;
+    /**
+     * @param {string} table
+     * @param {object} [where = {}]
+     * @param {object} [options = {}]
+     */
+    findAll(table: string, where?: object, options?: object): any;
+    /**
+     * @param {string} table
+     * @param {object} [where]
+     */
+    count(table: string, where?: object): any;
+    /**
+     * @param {string} table
+     * @param {number} id
+     * @param {object} data
+     */
+    update(table: string, id: number, data: object): any;
+    /**
+     * @param {string} table
+     * @param {number} id
+     */
+    delete(table: string, id: number): any;
+    /**
+     * @param {string} table
+     * @param {object} data
+     * @param {string} [conflictColumn]
+     */
+    upsert(table: string, data: object, conflictColumn?: string): {
+        changes: any;
+        lastInsertRowid: any;
+    };
+    /**
+     * @param {function} callback
+     */
+    transaction(callback: Function): any;
+    /**
+     * @param {string} migrationsDir - Répertoire contenant les migrations
+     */
+    runMigrations(migrationsDir: string): void;
+    /**
+     * @param {string} table
+     */
+    export(table: string): any;
+    /**
+     * @param {string} table
+     * @param {array} data
+     */
+    import(table: string, data: any[]): number;
+    /**
+     * @param {string} table
+     */
+    truncate(table: string): void;
+    /**
+     * @param {string} indexName
+     * @param {string} table
+     * @param {string} columns
+     */
+    createIndex(indexName: string, table: string, columns: string): void;
+    /**
+     * @returns {object}
+     */
+    stats(): object;
+    close(): void;
+    #private;
+}
+//# sourceMappingURL=Storage.d.ts.map

package/types/core/Storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../core/Storage.js"],"names":[],"mappings":";AAmBiB;IAIf;;OAEG;IACH,mBAFW,MAAM,EAehB;IAED;;;OAGG;IACH,UAHW,MAAM,YACN,QAAM,MAAM;;;MAetB;IAED;;;OAGG;IACH,YAHW,MAAM,YACN,QAAM,MAAM,OAUtB;IAED;;;OAGG;IACH,YAHW,MAAM,YACN,QAAM,MAAM,OAUtB;IAED;;;OAGG;IACH,cAHW,MAAM,OACN,MAAM,OAYhB;IAED;;;OAGG;IACH,mBAHW,MAAM,UACN,MAAM,QAUhB;IAED;;;OAGG;IACH,cAHW,MAAM,QACN,MAAM,OAUhB;IAED;;;;OAIG;IACH,gBAJW,MAAM,MACN,MAAM,GACJ,MAAM,GAAC,IAAI,CAIvB;IAED;;;;OAIG;IACH,eAJW,MAAM,UACN,MAAM,YACN,MAAM,OAmBhB;IAED;;;OAGG;IACH,aAHW,MAAM,UACN,MAAM,OAehB;IAED;;;;OAIG;IACH,cAJW,MAAM,MACN,MAAM,QACN,MAAM,OAUhB;IAED;;;OAGG;IACH,cAHW,MAAM,MACN,MAAM,OAOhB;IAED;;;;OAIG;IACH,cAJW,MAAM,QACN,MAAM,mBACN,MAAM;;;MAkBhB;IAED;;OAEG;IACH,qCAaC;IAED;;OAEG;IACH,6BAFW,MAAM,QA+BhB;IAED;;OAEG;IACH,cAFW,MAAM,OAIhB;IAED;;;OAGG;IACH,cAHW,MAAM,uBAYhB;IAED;;OAEG;IACH,gBAFW,MAAM,QAIhB;IAED;;;;OAIG;IACH,uBAJW,MAAM,SACN,MAAM,WACN,MAAM,QAIhB;IAED;;OAEG;IACH,SAFa,MAAM,CAclB;IAED,cAMC;;CACF"}

package/types/core/Utils.d.ts

@@ -0,0 +1,55 @@
+export function getEnv(env: any): string;
+/**
+   * Creates a Promise that resolves after specified milliseconds.
+   *
+   * @param {number} ms - Milliseconds to wait (positive integer).
+   * @returns {Promise<void>} Promise that resolves after delay.
+   *
+   * @example
+   * // Sequential delays
+   * await wait(100);  // 100ms
+   * await wait(500);  // 500ms
+   * await wait(2000); // 2 seconds
+   */
+export function wait(ms: number): Promise<void>;
+/**
+   *
+   * @param {boolean|Promise<boolean>} predicate
+   * @param {*} handler
+   * @param {object} [options]
+   * @param {number} [options.interval]
+   * @param {number|null} [options.timeout]
+   * @param {number|null} [options.max]
+   */
+export function when(predicate: boolean | Promise<boolean>, handler: any, options?: {
+    interval?: number;
+    timeout?: number | null;
+    max?: number | null;
+}): {
+    start(): /*elided*/ any;
+    stop(): /*elided*/ any;
+    /**
+           * @param {"error"|"trigger"|"timeout"} event
+           * @param {(payload: any) => void} fn
+           */
+    on(event: "error" | "trigger" | "timeout", fn: (payload: any) => void): /*elided*/ any;
+    /**
+           * @param {"error"|"trigger"|"timeout"} event
+           * @param {(payload: any) => void} fn
+           */
+    off(event: "error" | "trigger" | "timeout", fn: (payload: any) => void): /*elided*/ any;
+};
+export function dontCrash(): {
+    /**
+           * @template { "error" | "exit" | "sig" | "beforeExit" } E
+           * @param { E } event
+           * @param { { error: (error: Error | unknown) => void | Promise<void>, exit: (code: number) => void | Promise<void>, sig: (signal: "SIGINT" | "SIGTERM" | "SIGQUIT") => void | Promise<void>, beforeExit: (code: number) => void|Promise<void> }[E] } handler
+           */
+    on<E extends "error" | "exit" | "sig" | "beforeExit">(event: E, handler: {
+        error: (error: Error | unknown) => void | Promise<void>;
+        exit: (code: number) => void | Promise<void>;
+        sig: (signal: "SIGINT" | "SIGTERM" | "SIGQUIT") => void | Promise<void>;
+        beforeExit: (code: number) => void | Promise<void>;
+    }[E]): /*elided*/ any;
+};
+//# sourceMappingURL=Utils.d.ts.map

package/types/core/Utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../core/Utils.js"],"names":[],"mappings":"AAQE,yCAGC;AACD;;;;;;;;;;;KAWE;AACF,yBATU,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAUxB;AACD;;;;;;;;KAQE;AACF,gCAPU,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,WACxB,GAAC,YAET;IAAyB,QAAQ,GAAzB,MAAM;IACgB,OAAO,GAA7B,MAAM,GAAC,IAAI;IACW,GAAG,GAAzB,MAAM,GAAC,IAAI;CAAe;;;IAgGhC;;;aAGA;cAFQ,OAAO,GAAC,SAAS,GAAC,SAAS,MAC3B,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI;IAM9B;;;aAGA;eAFQ,OAAO,GAAC,SAAS,GAAC,SAAS,MAC3B,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI;EASjC;AACD;IAuBI;;;;aAIA;OAHsD,CAAC,SAA3C,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,YAAc,SAC5C,CAAC,WACD;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;EA4BnP"}

package/types/index.d.ts

@@ -0,0 +1,122 @@
+declare const _exports: {
+    getEnv(env: any): string;
+    wait(ms: number): Promise<void>;
+    when(predicate: boolean | Promise<boolean>, handler: any, options?: {
+        interval?: number;
+        timeout?: number | null;
+        max?: number | null;
+    }): {
+        start(): /*elided*/ any;
+        stop(): /*elided*/ any;
+        on(event: "error" | "trigger" | "timeout", fn: (payload: any) => void): /*elided*/ any;
+        off(event: "error" | "trigger" | "timeout", fn: (payload: any) => void): /*elided*/ any;
+    };
+    dontCrash(): {
+        on<E extends "error" | "exit" | "sig" | "beforeExit">(event: E, handler: {
+            error: (error: Error | unknown) => void | Promise<void>;
+            exit: (code: number) => void | Promise<void>;
+            sig: (signal: "SIGINT" | "SIGTERM" | "SIGQUIT") => void | Promise<void>;
+            beforeExit: (code: number) => void | Promise<void>;
+        }[E]): /*elided*/ any;
+    };
+    step(steps: Array<() => void>): {
+        currentIndex: number;
+        currentStep: () => void;
+        next(): /*elided*/ any;
+        back(): /*elided*/ any;
+        at(index: number): /*elided*/ any;
+        ignore(): /*elided*/ any;
+        reset(): /*elided*/ any;
+        all(): /*elided*/ any;
+    };
+    log(content: any): this;
+    logify(content: any): string;
+    group(label: string): this;
+    groupEnd(): this;
+    setLogger(options?: {
+        delimiters?: {
+            start?: string;
+            end?: string;
+        };
+        timestamp?: boolean;
+    }): this;
+    createPath(path?: string): string;
+    getFoldersIn(path?: string, recursive?: boolean): string[] | undefined;
+    getFolder(path?: string): string | undefined;
+    getFilesIn(path?: string, recursive?: boolean): string[] | undefined;
+    getFile(path: string): string | undefined;
+    createFolder(path: string, force?: boolean): boolean | undefined;
+    createFile(path: string, force?: boolean, data?: string | object | null | undefined): boolean | undefined;
+    deleteFoldersIn(path?: string, filter?: (folder: string) => boolean): number | undefined;
+    deleteFolder(path: string): boolean | undefined;
+    deleteFilesIn(path?: string, recursive?: boolean, filter?: (file: string) => boolean): number | undefined;
+    deleteFile(path: string): boolean | undefined;
+    copyFoldersIn(options: {
+        dest: string;
+        path?: string;
+        recursive?: boolean;
+        withFiles?: boolean;
+        force?: boolean;
+        filter?: (folder: string) => boolean;
+    }): number | undefined;
+    copyFolder(options: {
+        dest: string;
+        path?: string;
+        recursive?: boolean;
+        withFiles?: boolean;
+        force?: boolean;
+    }): boolean | undefined;
+    copyFilesIn(options: {
+        dest: string;
+        path?: string;
+        recursive?: boolean;
+        force?: boolean;
+        filter?: (file: string) => boolean;
+    }): number | undefined;
+    copyFile(options: {
+        path: string;
+        dest: string;
+        force?: boolean;
+    }): boolean | undefined;
+    moveFoldersIn(options: any): number | undefined;
+    moveFolder(options: any): boolean | undefined;
+    moveFilesIn(options: any): number | undefined;
+    moveFile(options: any): boolean | undefined;
+    readFile(path: string): string | undefined;
+    watch(options?: {
+        path?: string;
+        recursive?: boolean;
+        filter?: (event: string, file: string) => boolean;
+    }): any | undefined;
+    Storage: {
+        new (path?: string): Storage;
+    };
+    cli_run: (command: string) => NonSharedBuffer & string;
+    cli_stream: {
+        new (command: any, args: any): {
+            "__#private@#processus": import("node:child_process").ChildProcessByStdio<null, import("node:stream").Readable, import("node:stream").Readable>;
+            "__#private@#events": import("node:events")<any>;
+            on<E extends "data" | "error" | "stopped">(event: E, handler: {
+                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>;
+            }[E]): /*elided*/ any;
+            stop(): Promise<any>;
+        };
+    };
+    isArray(value: any): boolean;
+    isNumber(value: any): boolean;
+    isFunction(value: any): boolean;
+    isObject(value: any): boolean;
+    isBoolean(value: any): boolean;
+    isString(value: any): boolean;
+    isUndefined(value: any): boolean;
+    isNull(value: any): boolean;
+    isDate(value: any): boolean;
+    isMap(value: any): boolean;
+    isSet(value: any): boolean;
+    isError(value: any): boolean;
+};
+export = _exports;
+import Storage = require("./core/Storage");
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.js"],"names":[],"mappings":""}