@nemigo/helpers 2.6.0 → 2.7.0

package/dist/phymath/index.d.ts

@@ -15,7 +15,7 @@ export type RoundMethod = "up" | "down" | "math";
  * @param [fraction=2] - Количество знаков после запятой
  * @param [method="math"] - Метод округления
  */
-export declare const round: (value: number, fraction?: number, method?: RoundMethod) => number;
+export declare const round: (value?: number | null, fraction?: number, method?: RoundMethod) => number;
 /**
  * Вычисляет сумму всех переданных аргументов
  *

package/dist/phymath/index.js

@@ -14,7 +14,7 @@ export const normalizero = (value) => (value === 0 ? 0 : value);
  * @param [method="math"] - Метод округления
  */
 export const round = (value, fraction = 2, method = "math") => {
-    if (Number.isNaN(value) || value === 0)
+    if (!value)
         return 0;
     const factor = 10 ** fraction;
     switch (method) {

package/dist/random.d.ts

@@ -15,21 +15,21 @@ export declare const rand: (length?: number) => string;
 /**
  * Генерирует уникальный ID, состоящий из {@link Timestamp} и случайного кода из {@link rand}
  *
- * Формат: `${Date.now()}:${rand(length)}`
+ * Формат: `${Date.now()}_${rand(length)}`
  *
  * @param [length=7] - Длина случайной части кода
  *
  * @example
  * ```typescript
- * randID(4); // "1696934400000:1234"
- * randID(6); // "1696934400000:123456"
+ * randID(4); // "1696934400000_1234"
+ * randID(6); // "1696934400000_123456"
  * ```
  */
 export declare const randID: (length?: number) => string;
 /**
  * Генерирует случайный UID из латиницы в нижнем регистре и цифр
  *
- * Формат: `prefix ? `${prefix}:${uid}` : uid`
+ * Формат: `prefix ? `${prefix}${uid}` : uid`
  *
  * @param [prefix] - Префикс для категоризации UID (например таблица)
  * @param [length=20] - Длина UID в символах
@@ -37,8 +37,12 @@ export declare const randID: (length?: number) => string;
  * @example
  * ```typescript
  * randUID(); // "a1b2c3d4e5f6g7h8i9j0"
- * randUID("user", 10); // "user:a1b2c3d4e5"
- * randUID("session", 16); // "session:a1b2c3d4e5f6g7h8"
+ * randUID("user:", 10); // "user:a1b2c3d4e5"
+ * randUID("session:", 16); // "session:a1b2c3d4e5f6g7h8"
  * ```
  */
 export declare const randUID: (prefix?: string, length?: number) => string;
+/**
+ * Генерирует случайный UUID версии 4 (RFC 4122). Использует {@link Math.random()}
+ */
+export declare const randUUID: () => string;

package/dist/random.js

@@ -18,21 +18,21 @@ export const rand = (length = 6) => {
 /**
  * Генерирует уникальный ID, состоящий из {@link Timestamp} и случайного кода из {@link rand}
  *
- * Формат: `${Date.now()}:${rand(length)}`
+ * Формат: `${Date.now()}_${rand(length)}`
  *
  * @param [length=7] - Длина случайной части кода
  *
  * @example
  * ```typescript
- * randID(4); // "1696934400000:1234"
- * randID(6); // "1696934400000:123456"
+ * randID(4); // "1696934400000_1234"
+ * randID(6); // "1696934400000_123456"
  * ```
  */
-export const randID = (length = 7) => `${Date.now()}:${rand(length)}`;
+export const randID = (length = 7) => `${Date.now()}_${rand(length)}`;
 /**
  * Генерирует случайный UID из латиницы в нижнем регистре и цифр
  *
- * Формат: `prefix ? `${prefix}:${uid}` : uid`
+ * Формат: `prefix ? `${prefix}${uid}` : uid`
  *
  * @param [prefix] - Префикс для категоризации UID (например таблица)
  * @param [length=20] - Длина UID в символах
@@ -40,14 +40,41 @@ export const randID = (length = 7) => `${Date.now()}:${rand(length)}`;
  * @example
  * ```typescript
  * randUID(); // "a1b2c3d4e5f6g7h8i9j0"
- * randUID("user", 10); // "user:a1b2c3d4e5"
- * randUID("session", 16); // "session:a1b2c3d4e5f6g7h8"
+ * randUID("user:", 10); // "user:a1b2c3d4e5"
+ * randUID("session:", 16); // "session:a1b2c3d4e5f6g7h8"
  * ```
  */
 export const randUID = (prefix, length = 20) => {
-    const UID = "abcdefghijklmnopqrstuvwxyz0123456789";
+    const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
     let uid = "";
     for (let i = 0; i < length; i++)
-        uid += UID[Math.floor(Math.random() * 36)];
-    return prefix ? `${prefix}:${uid}` : uid;
+        uid += chars[Math.floor(Math.random() * 36)];
+    return prefix ? `${prefix}${uid}` : uid;
+};
+/**
+ * Генерирует случайный UUID версии 4 (RFC 4122). Использует {@link Math.random()}
+ */
+export const randUUID = () => {
+    const chars = "0123456789abcdef";
+    let uuid = "";
+    for (let i = 0; i < 36; i++) {
+        switch (i) {
+            case 8:
+            case 13:
+            case 18:
+            case 23:
+                uuid += "-";
+                break;
+            case 14:
+                uuid += "4"; // версия UUID — 4
+                break;
+            case 19:
+                // Устанавливаем старшие два бита в 10xx (RFC 4122 variant)
+                uuid += chars[(Math.floor(Math.random() * 16) & 0x3) | 0x8];
+                break;
+            default:
+                uuid += chars[Math.floor(Math.random() * 16)];
+        }
+    }
+    return uuid;
 };

package/dist/script.d.ts

@@ -38,15 +38,23 @@ export interface ExecuteLogger {
     /**
      * Перед выполнением
      */
-    before?: (path: string) => string;
+    before?: (path: string) => void;
+    /**
+     * `stderr` поток вывода процесса
+     */
+    stderr?: (message: string) => void;
+    /**
+     * `stdout` поток вывода процесса
+     */
+    stdout?: (message: string) => void;
     /**
      * При возникновении ошибки
      */
-    onerror?: (error: ExecException) => string;
+    onerror?: (error: ExecException) => void;
     /**
      * При истечении таймаута
      */
-    ontimeout?: () => string;
+    ontimeout?: () => void;
 }
 /**
  * Опции для {@link execute}

package/dist/script.js

@@ -1,4 +1,3 @@
-/* eslint-disable no-console */
 import { exec } from "node:child_process";
 import { MS_IN_MINUTE } from "./datetime/delta.js";
 /**
@@ -61,8 +60,7 @@ export { getProcessFlag };
  * ```
  */
 export const execute = (path, command, { logger = {}, timeout = 5 * MS_IN_MINUTE } = {}) => new Promise((resolve, reject) => {
-    if (logger.before)
-        console.log(logger.before(path));
+    logger.before?.(path);
     let process = null;
     let timer = null;
     const cleanup = () => {
@@ -74,20 +72,18 @@ export const execute = (path, command, { logger = {}, timeout = 5 * MS_IN_MINUTE
     if (timeout) {
         timer = setTimeout(() => {
             process?.kill("SIGTERM");
-            if (logger.ontimeout)
-                console.error(logger.ontimeout());
+            logger.ontimeout?.();
             reject(new Error("TIMEOUT"));
         }, timeout);
     }
     process = exec(command, { cwd: path }, (error, stdout, stderr) => {
         cleanup();
         if (stderr)
-            console.warn(stderr);
+            logger.stderr?.(stderr);
         if (stdout)
-            console.log(stdout);
+            logger.stdout?.(stdout);
         if (error) {
-            if (logger.onerror)
-                console.error(logger.onerror(error));
+            logger.onerror?.(error);
             reject(error);
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nemigo/helpers",
-	"version": "2.6.0",
+	"version": "2.7.0",
 	"private": false,
 	"license": "MPL-2.0",
 	"author": {
@@ -192,6 +192,6 @@
 		"@std/msgpack": "npm:@jsr/std__msgpack"
 	},
 	"devDependencies": {
-		"@nemigo/configs": "2.6.0"
+		"@nemigo/configs": "2.6.1"
 	}
 }