@ix-xs/node-comfort 1.0.56 → 1.1.0

package/types/src/FS.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Reads an environment variable from process.env.
+ * @param {string} value - The environment variable name.
+ * @param {string} [envFilePath] - Reserved for future use.
+ * @returns {string|undefined} The environment value, or undefined if not set.
+ */
+export function getEnv(value: string, envFilePath?: string): string | undefined;
+/**
+ * Resolves a path even when it does not already exist.
+ * @param {string} [path=process.cwd()] - The path to resolve.
+ * @returns {string} The resolved path.
+ */
+export function createPath(path?: string): string;
+/**
+ * Returns folders found inside a path.
+ * @param {string} [path=process.cwd()] - The base path to inspect.
+ * @param {boolean} [recursive=true] - Whether to scan recursively.
+ * @returns {string[]|undefined} Matching folders, or undefined if the path cannot be resolved.
+ */
+export function getFoldersIn(path?: string, recursive?: boolean): string[] | undefined;
+/**
+ * Returns the resolved folder path.
+ * @param {string} [path=process.cwd()] - The folder path to resolve.
+ * @returns {string|undefined} The resolved folder path, or undefined if not found.
+ */
+export function getFolder(path?: string): string | undefined;
+/**
+ * Returns files found inside a path.
+ * @param {string} [path=process.cwd()] - The base path to inspect.
+ * @param {boolean} [recursive=true] - Whether to scan recursively.
+ * @returns {string[]|undefined} Matching files, or undefined if the path cannot be resolved.
+ */
+export function getFilesIn(path?: string, recursive?: boolean): string[] | undefined;
+/**
+ * Returns the resolved file path.
+ * @param {string} path - The file path to resolve.
+ * @returns {string|undefined} The resolved file path, or undefined if not found.
+ */
+export function getFile(path: string): string | undefined;
+/**
+ * Creates a folder.
+ * @param {string} path - The folder path to create.
+ * @param {boolean} [force=false] - Whether to recreate the folder if it already exists.
+ * @returns {boolean|undefined} True on success, false on failure, undefined if no path was provided.
+ */
+export function createFolder(path: string, force?: boolean): boolean | undefined;
+/**
+ * Creates a file.
+ * @param {string} path - The file path to create.
+ * @param {boolean} [force=false] - Whether to recreate the file if it already exists.
+ * @param {string|object|null|undefined} [data] - File content to write.
+ * @returns {boolean|undefined} True on success, false on failure, undefined if no path was provided.
+ */
+export function createFile(path: string, force?: boolean, data?: string | object | null | undefined): boolean | undefined;
+/**
+ * Deletes folders found inside a path.
+ * @param {string} [path=process.cwd()] - The base path to inspect.
+ * @param {(folder: string) => boolean} [filter=() => true] - Filter applied to each folder path.
+ * @returns {number|undefined} Number of deleted folders, or undefined if the path cannot be resolved.
+ */
+export function deleteFoldersIn(path?: string, filter?: (folder: string) => boolean): number | undefined;
+/**
+ * Deletes a folder.
+ * @param {string} path - The folder path to delete.
+ * @returns {boolean|undefined} True on success, false on failure, undefined if the path is invalid.
+ */
+export function deleteFolder(path: string): boolean | undefined;
+/**
+ * Deletes files found inside a path.
+ * @param {string} [path=process.cwd()] - The base path to inspect.
+ * @param {boolean} [recursive=false] - Whether to scan recursively.
+ * @param {(file: string) => boolean} [filter=() => true] - Filter applied to each file path.
+ * @returns {number|undefined} Number of deleted files, or undefined if the path cannot be resolved.
+ */
+export function deleteFilesIn(path?: string, recursive?: boolean, filter?: (file: string) => boolean): number | undefined;
+/**
+ * Deletes a file.
+ * @param {string} path - The file path to delete.
+ * @returns {boolean|undefined} True on success, false on failure, undefined if the path is invalid.
+ */
+export function deleteFile(path: string): boolean | undefined;
+/**
+ * Copies folders from a source path into a destination folder.
+ * @param {Object} options - Copy options.
+ * @param {string} options.dest - Destination path.
+ * @param {string} [options.path] - Source path.
+ * @param {boolean} [options.recursive=true] - Whether to recurse into subfolders.
+ * @param {boolean} [options.withFiles=false] - Whether to copy files as well.
+ * @param {boolean} [options.force=false] - Whether to overwrite existing folders.
+ * @param {(folder: string) => boolean} [options.filter=() => true] - Filter applied to each folder.
+ * @returns {number|undefined} Number of copied folders, or undefined if invalid input.
+ */
+export function copyFoldersIn(options: {
+    dest: string;
+    path?: string | undefined;
+    recursive?: boolean | undefined;
+    withFiles?: boolean | undefined;
+    force?: boolean | undefined;
+    filter?: ((folder: string) => boolean) | undefined;
+}): number | undefined;
+/**
+ * Copies a folder to a destination path.
+ * @param {Object} options - Copy options.
+ * @param {string} options.dest - Destination path.
+ * @param {string} [options.path] - Source path.
+ * @param {boolean} [options.recursive=false] - Whether to copy subfolders.
+ * @param {boolean} [options.withFiles=false] - Whether to copy files.
+ * @param {boolean} [options.force=false] - Whether to overwrite the destination.
+ * @returns {boolean|undefined} True on success, false on failure, undefined if invalid input.
+ */
+export function copyFolder(options: {
+    dest: string;
+    path?: string | undefined;
+    recursive?: boolean | undefined;
+    withFiles?: boolean | undefined;
+    force?: boolean | undefined;
+}): boolean | undefined;
+/**
+ * Copies files from a source path into a destination folder.
+ * @param {Object} options - Copy options.
+ * @param {string} options.dest - Destination path.
+ * @param {string} [options.path] - Source path.
+ * @param {boolean} [options.recursive=true] - Whether to recurse into subfolders.
+ * @param {boolean} [options.force=false] - Whether to overwrite existing files.
+ * @param {(file: string) => boolean} [options.filter=() => true] - Filter applied to each file.
+ * @returns {number|undefined} Number of copied files, or undefined if invalid input.
+ */
+export function copyFilesIn(options: {
+    dest: string;
+    path?: string | undefined;
+    recursive?: boolean | undefined;
+    force?: boolean | undefined;
+    filter?: ((file: string) => boolean) | undefined;
+}): number | undefined;
+/**
+ * Copies a file to a destination path.
+ * @param {Object} options - Copy options.
+ * @param {string} options.path - Source file path.
+ * @param {string} options.dest - Destination path.
+ * @param {boolean} [options.force=false] - Whether to overwrite the destination file.
+ * @returns {boolean|undefined} True on success, false on failure, undefined if invalid input.
+ */
+export function copyFile(options: {
+    path: string;
+    dest: string;
+    force?: boolean | undefined;
+}): boolean | undefined;
+/**
+ * Moves folders from a source path into a destination folder.
+ * @param {Object} options - Move options.
+ * @param {string} options.dest - Destination path.
+ * @param {string} [options.path] - Source path.
+ * @param {boolean} [options.recursive=true] - Whether to recurse into subfolders.
+ * @param {boolean} [options.withFiles=false] - Whether to move files as well.
+ * @param {boolean} [options.force=false] - Whether to overwrite existing folders.
+ * @param {(folder: string) => boolean} [options.filter=() => true] - Filter applied to each folder.
+ * @returns {number|undefined} Number of copied folders, or undefined if invalid input.
+ */
+export function moveFoldersIn(options: {
+    dest: string;
+    path?: string | undefined;
+    recursive?: boolean | undefined;
+    withFiles?: boolean | undefined;
+    force?: boolean | undefined;
+    filter?: ((folder: string) => boolean) | undefined;
+}): number | undefined;
+/**
+ * Moves a folder to a destination path.
+ * @param {Object} options - Move options.
+ * @param {string} options.path - Source folder path.
+ * @param {string} options.dest - Destination path.
+ * @param {boolean} [options.recursive=false] - Whether to move subfolders.
+ * @param {boolean} [options.withFiles=false] - Whether to move files.
+ * @param {boolean} [options.force=false] - Whether to overwrite the destination.
+ * @returns {boolean|undefined} True on success, false on failure, undefined if invalid input.
+ */
+export function moveFolder(options: {
+    path: string;
+    dest: string;
+    recursive?: boolean | undefined;
+    withFiles?: boolean | undefined;
+    force?: boolean | undefined;
+}): boolean | undefined;
+/**
+ * Moves files from a source path into a destination folder.
+ * @param {Object} options - Move options.
+ * @param {string} options.dest - Destination path.
+ * @param {string} [options.path] - Source path.
+ * @param {boolean} [options.recursive=true] - Whether to recurse into subfolders.
+ * @param {boolean} [options.force=false] - Whether to overwrite existing files.
+ * @param {(file: string) => boolean} [options.filter=() => true] - Filter applied to each file.
+ * @returns {number|undefined} Number of copied files, or undefined if invalid input.
+ */
+export function moveFilesIn(options: {
+    dest: string;
+    path?: string | undefined;
+    recursive?: boolean | undefined;
+    force?: boolean | undefined;
+    filter?: ((file: string) => boolean) | undefined;
+}): number | undefined;
+/**
+ * Moves a file to a destination path.
+ * @param {Object} options - Move options.
+ * @param {string} options.path - Source file path.
+ * @param {string} options.dest - Destination path.
+ * @param {boolean} [options.force=false] - Whether to overwrite the destination file.
+ * @returns {boolean|undefined} True on success, false on failure, undefined if invalid input.
+ */
+export function moveFile(options: {
+    path: string;
+    dest: string;
+    force?: boolean | undefined;
+}): boolean | undefined;
+/**
+ * Reads a file as UTF-8 text.
+ * @param {string} path - The file path to read.
+ * @returns {string|undefined} File content, or undefined if the file cannot be read.
+ */
+export function readFile(path: string): string | undefined;
+/**
+ * Watches a path and exposes event listeners.
+ * @param {Object} [options] - Watch options.
+ * @param {string} [options.path=process.cwd()] - Path to watch.
+ * @param {boolean} [options.recursive=false] - Whether to watch recursively.
+ * @param {(event: "rename"|"change", file: string) => boolean} [options.filter] - Filter applied before dispatch.
+ * @returns {{
+ *   on: <E extends "change"|"rename"|"all">(event: E, callback: E extends "all" ? (event: "change"|"rename", file: string) => void|Promise<void> : (file: string) => void|Promise<void>) => any,
+ *   stop: () => void,
+ *   pause: () => any,
+ *   resume: () => any,
+ * }|undefined} Watch controller, or undefined if the path cannot be resolved.
+ */
+export function watch(options?: {
+    path?: string | undefined;
+    recursive?: boolean | undefined;
+    filter?: ((event: "rename" | "change", file: string) => boolean) | undefined;
+}): {
+    on: <E extends "change" | "rename" | "all">(event: E, callback: E extends "all" ? (event: "change" | "rename", file: string) => void | Promise<void> : (file: string) => void | Promise<void>) => any;
+    stop: () => void;
+    pause: () => any;
+    resume: () => any;
+} | undefined;
+//# sourceMappingURL=FS.d.ts.map

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

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

package/types/src/Logger.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Enables or disables timestamp in logs
+ * @param {boolean} value - True to enable, false to disable
+ * @returns {Logger} The same Logger instance (for chaining)
+ */
+export function setTimestamp(value: boolean): Logger;
+/**
+ * Changes the delimiters used for text formatting
+ * @param {object} options - Delimiter options
+ * @param {string} [options.open] - New opening delimiter
+ * @param {string} [options.close] - New closing delimiter
+ * @returns {Logger} The same Logger instance (for chaining)
+ */
+export function setDelimiter(options?: {
+    open?: string | undefined;
+    close?: string | undefined;
+}): Logger;
+/**
+ * Prints a message to the console with ANSI formatting
+ * @param {*} content - Content to print (string, object, or other)
+ * @returns {Logger} The same Logger instance (for chaining)
+ */
+export function log(content: any): Logger;
+/**
+ * Start a log group (displays a label and adds indentation)
+ * @param {string} label - The group name to display
+ * @returns {Logger} The same Logger instance (for chaining)
+ */
+export function group(label: string): Logger;
+/**
+ * End the current log group
+ * @returns {Logger} The same Logger instance (for chaining)
+ */
+export function groupEnd(): Logger;
+//# sourceMappingURL=Logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/Logger.js"],"names":[],"mappings":"AA+NE;;;;GAIG;AACH,oCAHW,OAAO,GACL,MAAM,CAKlB;AAED;;;;;;GAMG;AACH,uCAJG;IAAyB,IAAI;IACJ,KAAK;CAC9B,GAAU,MAAM,CAQlB;AAED;;;;GAIG;AACH,6BAHW,GAAC,GACC,MAAM,CAiClB;AAED;;;;GAIG;AACH,6BAHW,MAAM,GACJ,MAAM,CAOlB;AAED;;;GAGG;AACH,4BAFa,MAAM,CAKlB"}

package/types/src/SQLite.d.ts

@@ -0,0 +1,168 @@
+export = SQLite;
+declare class SQLite {
+    /**
+     * Creates a new SQLite instance.
+     *
+     * By default, the database file is created at `./db.sqlite` relative
+     * to the current working directory. You can pass a custom path if needed.
+     *
+     * @example
+     * // Default path: "./db.sqlite"
+     * const db = new SQLite();
+     *
+     * @example
+     * // Custom path in a subfolder:
+     * const db = new SQLite("data/myapp.sqlite");
+     *
+     * @param {string} [path] - Path to the SQLite database file.
+     */
+    constructor(path?: string);
+    /**
+     * Creates (or ensures) a table exists for a given model definition.
+     *
+     * @example
+     * await db.createTable({
+     *   name: "sessions",
+     *   options: {
+     *     id:   { type: "TEXT", primaryKey: true },
+     *     data: { type: "TEXT" },
+     *   },
+     * });
+     *
+     * @param {{ name: string, options: Record<string, {
+     *   type: "INTEGER"|"TEXT"|"REAL"|"BLOB"|"NUMERIC",
+     *   primaryKey?: boolean,
+     *   autoincrement?: boolean,
+     *   notNull?: boolean,
+     *   unique?: boolean,
+     *   defaultValue?: any,
+     *   values?: any[]
+     * }> }} table
+     * @returns {Promise<{ ok: true } | { error: string }>}
+     */
+    createTable(table: {
+        name: string;
+        options: Record<string, {
+            type: "INTEGER" | "TEXT" | "REAL" | "BLOB" | "NUMERIC";
+            primaryKey?: boolean;
+            autoincrement?: boolean;
+            notNull?: boolean;
+            unique?: boolean;
+            defaultValue?: any;
+            values?: any[];
+        }>;
+    }): Promise<{
+        ok: true;
+    } | {
+        error: string;
+    }>;
+    /**
+     * Drops a table and removes its model definition.
+     *
+     * @param {string} tableName
+     * @returns {Promise<{ ok: true } | { error: string }>}
+     */
+    deleteTable(tableName: string): Promise<{
+        ok: true;
+    } | {
+        error: string;
+    }>;
+    /**
+     * Deletes all rows from a table.
+     *
+     * @param {string} tableName
+     * @returns {Promise<{ ok: true } | { error: string }>}
+     */
+    clearTable(tableName: string): Promise<{
+        ok: true;
+    } | {
+        error: string;
+    }>;
+    /**
+     * Gets a single row matching a WHERE clause.
+     *
+     * Returns:
+     * - `undefined` if no row matches,
+     * - the row object if found,
+     * - `{ error }` if a database error occurred.
+     *
+     * @param {string} tableName
+     * @param {Record<string, any>} where
+     * @returns {Promise<object|undefined|{ error: string }>}
+     */
+    get(tableName: string, where: Record<string, any>): Promise<object | undefined | {
+        error: string;
+    }>;
+    /**
+     * Gets multiple rows matching a WHERE clause.
+     *
+     * Returns:
+     * - an empty array if the table is not defined,
+     * - an array of row objects,
+     * - `{ error }` if a database error occurred.
+     *
+     * @param {string} tableName
+     * @param {Record<string, any>} [where={}]
+     * @param {number} [limit=50]
+     * @param {number} [offset=0]
+     * @returns {Promise<object[] | { error: string }>}
+     */
+    getAll(tableName: string, where?: Record<string, any>, limit?: number, offset?: number): Promise<object[] | {
+        error: string;
+    }>;
+    /**
+     * Inserts or replaces a row in a table.
+     *
+     * If `where` is provided (or `data.id` exists), it will first load the existing row and
+     * merge it with `data`, then perform an `INSERT OR REPLACE`. This lets you do partial updates.
+     *
+     * @example
+     * await db.set("users", { id: 1, name: "Jane" });
+     *
+     * @param {string} tableName
+     * @param {Record<string, any>} data
+     * @param {Record<string, any>|null} [where=null]
+     * @returns {Promise<{ ok: true } | { error: string }>}
+     */
+    set(tableName: string, data: Record<string, any>, where?: Record<string, any> | null): Promise<{
+        ok: true;
+    } | {
+        error: string;
+    }>;
+    /**
+     * Deletes rows matching a WHERE clause.
+     *
+     * @param {string} tableName
+     * @param {Record<string, any>} where
+     * @returns {Promise<{ ok: true, changes: number } | { error: string }>}
+     */
+    delete(tableName: string, where: Record<string, any>): Promise<{
+        ok: true;
+        changes: number;
+    } | {
+        error: string;
+    }>;
+    /**
+     * Counts rows matching a WHERE clause.
+     *
+     * Returns:
+     * - the numeric count,
+     * - or `{ error }` if a database error occurred.
+     *
+     * @param {string} tableName
+     * @param {Record<string, any>} [where={}]
+     * @returns {Promise<number | { error: string }>}
+     */
+    count(tableName: string, where?: Record<string, any>): Promise<number | {
+        error: string;
+    }>;
+    /**
+     * Closes the underlying SQLite connection (if the runtime supports it).
+     *
+     * @example
+     * db.close();
+     */
+    close(): void;
+    #private;
+}
+//# sourceMappingURL=SQLite.d.ts.map

package/types/src/SQLite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SQLite.d.ts","sourceRoot":"","sources":["../../src/SQLite.js"],"names":[],"mappings":";AA4CiB;IAMf;;;;;;;;;;;;;;;OAeG;IACH,mBAFW,MAAM,EAahB;IAwID;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,mBAXW;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;YAC9C,IAAI,EAAE,SAAS,GAAC,MAAM,GAAC,MAAM,GAAC,MAAM,GAAC,SAAS,CAAC;YAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;YACrB,aAAa,CAAC,EAAE,OAAO,CAAC;YACxB,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,MAAM,CAAC,EAAE,OAAO,CAAC;YACjB,YAAY,CAAC,EAAE,GAAG,CAAC;YACnB,MAAM,CAAC,EAAE,GAAG,EAAE,CAAA;SACf,CAAC,CAAA;KAAE,GACM,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CASrD;IAED;;;;;OAKG;IACH,uBAHW,MAAM,GACJ,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAcrD;IAED;;;;;OAKG;IACH,sBAHW,MAAM,GACJ,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAarD;IAED;;;;;;;;;;;OAWG;IACH,eAJW,MAAM,SACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjB,OAAO,CAAC,MAAM,GAAC,SAAS,GAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAevD;IAED;;;;;;;;;;;;;OAaG;IACH,kBANW,MAAM,UACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,UACnB,MAAM,WACN,MAAM,GACJ,OAAO,CAAC,MAAM,EAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAgBjD;IAED;;;;;;;;;;;;;OAaG;IACH,eALW,MAAM,QACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,UACnB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAC,IAAI,GACtB,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAgCrD;IAED;;;;;;OAMG;IACH,kBAJW,MAAM,SACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjB,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAgBtE;IAED;;;;;;;;;;OAUG;IACH,iBAJW,MAAM,UACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjB,OAAO,CAAC,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAgB/C;IAED;;;;;OAKG;IACH,cAIC;;CACF"}

package/types/src/Utils.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Waits for a given number of milliseconds.
+ *
+ * @example
+ * await nodeComfort.wait(500); // waits 500 ms
+ *
+ * @param {number} ms - Delay in milliseconds.
+ * @returns {Promise<void>} A promise that resolves after the delay.
+ */
+export function wait(ms: number): Promise<void>;
+/**
+ * Polls a predicate at a given interval and emits events when it matches or times out.
+ *
+ * The predicate is evaluated every `options.interval` milliseconds (default: 50 ms).
+ * Be careful with the default interval: 50 ms is very frequent polling and can be
+ * unnecessarily CPU‑intensive if your predicate or trigger handlers are heavy.
+ * When `options.max` is `null`, the predicate can match indefinitely (infinite triggers),
+ * so you should choose an interval that makes sense for your use‑case.
+ *
+ * A `when(...)` task is one‑shot: once it has been stopped (manually or via `max`/`timeout`),
+ * calling `.start()` again on the same task will not restart it.
+ *
+ * @param {boolean|Promise<boolean>|(() => boolean|Promise<boolean>)} predicate
+ *        Condition to evaluate at each tick, or a function returning it.
+ * @param {*} [payload={}]
+ *        Value passed to listeners when events are emitted (e.g. an object or message).
+ * @param {object} [options]
+ * @param {number} [options.interval=50]
+ *        Polling interval in milliseconds. Increase this value if your predicate is
+ *        expensive or you expect many triggers without a `max` limit.
+ * @param {number|null} [options.timeout=null]
+ *        Maximum time in milliseconds before emitting a "timeout" event and stopping.
+ *        If `null`, no timeout is applied.
+ * @param {number|null} [options.max=null]
+ *        Maximum number of successful predicate evaluations ("trigger" events) before
+ *        automatically stopping. If `null`, triggers are infinite until `stop()` is called.
+ *
+ * @example
+ * // Basic usage: infinite triggers every 50 ms (default interval) – use with caution.
+ * const task = nodeComfort.when(() => true, { message: "Ok" });
+ *
+ * task
+ *   .on("trigger", (payload) => {
+ *     console.log(payload.message);
+ *     // task.stop(); // stop when you’re done
+ *   })
+ *   .start();
+ *
+ * @example
+ * // Safer usage: limit triggers and/or lower polling frequency.
+ * nodeComfort.when(() => true, { message: "Ok" }, { max: 1, interval: 500 })
+ *   .on("trigger", (payload) => {
+ *     console.log(payload.message);
+ *   })
+ *   .on("timeout", (payload) => {
+ *     console.log("Timed out", payload);
+ *   })
+ *   .start();
+ *
+ * @returns {{
+ *   start: () => any,
+ *   stop: () => any,
+ *   on: <E extends "error"|"trigger"|"timeout">(event: E, handler: E extends "error"
+ *       ? (error: unknown) => void|Promise<void>
+ *       : (payload: any) => void|Promise<void>) => any
+ * }} A small task controller with `start`, `stop` and `on`.
+ */
+export function when(predicate: boolean | Promise<boolean> | (() => boolean | Promise<boolean>), payload?: any, options?: {
+    interval?: number | undefined;
+    timeout?: number | null | undefined;
+    max?: number | null | undefined;
+}): {
+    start: () => any;
+    stop: () => any;
+    on: <E extends "error" | "trigger" | "timeout">(event: E, handler: E extends "error" ? (error: unknown) => void | Promise<void> : (payload: any) => void | Promise<void>) => any;
+};
+/**
+ * Installs process-level safety nets for errors, exits and signals.
+ *
+ * By default, it:
+ * - logs uncaught exceptions and unhandled rejections,
+ * - logs process exit codes,
+ * - logs SIGINT/SIGTERM/SIGQUIT and exits with code 0.
+ *
+ * You can override each handler with `.on(event, handler)`.
+ *
+ * @example
+ * // Use defaults:
+ * nodeComfort.dontCrash();
+ *
+ * @example
+ * // Custom error handler:
+ * nodeComfort.dontCrash().on("error", (err) => {
+ *   console.error("Global error:", err);
+ *   process.exit(1);
+ * });
+ *
+ * @returns {{
+ *   on: <E extends "error"|"exit"|"sig"|"beforeExit">(event: E, handler?: (
+ *     E extends "error" ? (error: Error|unknown) => void|Promise<void> :
+ *     E extends "exit" ? (code: number) => void|Promise<void> :
+ *     E extends "sig" ? (signal: "SIGINT"|"SIGTERM"|"SIGQUIT") => void|Promise<void> :
+ *     (code: number) => void|Promise<void>
+ *   )) => any
+ * }} A small controller to configure global handlers.
+ */
+export function dontCrash(): {
+    on: <E extends "error" | "exit" | "sig" | "beforeExit">(event: E, handler?: (E extends "error" ? (error: Error | unknown) => void | Promise<void> : E extends "exit" ? (code: number) => void | Promise<void> : E extends "sig" ? (signal: "SIGINT" | "SIGTERM" | "SIGQUIT") => void | Promise<void> : (code: number) => void | Promise<void>)) => any;
+};
+/**
+ * Safely stringifies a value to pretty-printed JSON (4 spaces indent).
+ *
+ * @param {*} value - Value to stringify.
+ * @returns {string} JSON string representation.
+ */
+export function JSONString(value: any): string;
+/**
+ * Parses a JSON string.
+ *
+ * @param {string} value - JSON string to parse.
+ * @returns {*} Parsed value.
+ */
+export function JSONParse(value: string): any;
+//# sourceMappingURL=Utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../src/Utils.js"],"names":[],"mappings":"AAME;;;;;;;;GAQG;AACH,yBAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAIzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,gCA7CW,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,GAAC,CAAC,MAAM,OAAO,GAAC,OAAO,CAAC,OAAO,CAAC,CAAC,YAEzD,GAAC,YAGT;IAAyB,QAAQ;IAGH,OAAO;IAGP,GAAG;CAIjC,GAsBU;IACR,KAAK,EAAE,MAAM,GAAG,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,CAAC;IAChB,EAAE,EAAE,CAAC,CAAC,SAAS,OAAO,GAAC,SAAS,GAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,SAAS,OAAO,GAC1E,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,GACtC,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,CAAA;CACnD,CAsIH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,6BATa;IACR,EAAE,EAAE,CAAC,CAAC,SAAS,OAAO,GAAC,MAAM,GAAC,KAAK,GAAC,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,CACpE,CAAC,SAAS,OAAO,GAAG,CAAC,KAAK,EAAE,KAAK,GAAC,OAAO,KAAK,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,GAChE,CAAC,SAAS,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,GACvD,CAAC,SAAS,KAAK,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAC,SAAS,GAAC,SAAS,KAAK,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,GACpF,CAAO,IAAI,EAAE,MAAM,KAAK,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,CACrC,KAAK,GAAG,CAAA;CACV,CAiEH;AAED;;;;;GAKG;AACH,kCAHW,GAAC,GACC,MAAM,CAIlB;AAED;;;;;GAKG;AACH,iCAHW,MAAM,GACJ,GAAC,CAIb"}

package/src/checker.js

@@ -1,76 +0,0 @@
-const { types } = require("node:util");
-
-module.exports = {
-  /**
-	 * @param {*} value
-	 */
-  isArray(value) {
-    return Array.isArray(value);
-  },
-  /**
-	 * @param {*} value
-	 */
-  isNumber(value) {
-    return typeof value === "number" && !Number.isNaN(value);
-  },
-  /**
-	 * @param {*} value
-	 */
-  isFunction(value) {
-    return typeof value === "function";
-  },
-  /**
-	 * @param {*} value
-	 */
-  isObject(value) {
-    return typeof value === "object" && value !== null;
-  },
-  /**
-	 * @param {*} value
-	 */
-  isBoolean(value) {
-    return typeof value === "boolean";
-  },
-  /**
-	 * @param {*} value
-	 */
-  isString(value) {
-    return typeof value === "string";
-  },
-  /**
-	 * @param {*} value
-	 */
-  isUndefined(value) {
-    return typeof value === "undefined";
-  },
-  /**
-	 * @param {*} value
-	 */
-  isNull(value) {
-    return value === null;
-  },
-  /**
-	 * @param {*} value
-	 */
-  isDate(value) {
-    return types.isDate(value);
-  },
-  /**
-	 * @param {*} value
-	 */
-  isMap(value) {
-    return types.isMap(value);
-  },
-  /**
-	 * @param {*} value
-	 */
-  isSet(value) {
-    return types.isSet(value);
-  },
-  /**
-	 * @param {*} value
-	 */
-  isError(value) {
-    return types.isNativeError(value);
-  },
-};