@nemigo/helpers 0.7.0 → 0.8.0

package/dist/{async.d.ts → async/index.d.ts}

@@ -1,10 +1,8 @@
-import type { Timestamp } from "./types.js";
+import type { Timestamp } from "../types.js";
 /**
  * Создаёт задержку на указанное количество миллисекунд
- *
- * @param ms - Количество миллисекунд для задержки
  */
-export declare const delay: (ms: Timestamp) => Promise<void>;
+export declare const delay: (ms: Timestamp, success?: boolean) => Promise<void>;
 /**
  * Создаёт debounce-функцию, которая откладывает выполнение до тех пор, пока не пройдёт указанное время без новых вызовов
  *

package/dist/{async.js → async/index.js}

@@ -1,10 +1,7 @@
 /**
  * Создаёт задержку на указанное количество миллисекунд
- *
- * @param ms - Количество миллисекунд для задержки
  */
-export const delay = (ms) => new Promise((ready) => setTimeout(ready, ms));
-//...
+export const delay = (ms, success = false) => new Promise((resolve, reject) => setTimeout(success ? resolve : reject, ms));
 /**
  * Создаёт debounce-функцию, которая откладывает выполнение до тех пор, пока не пройдёт указанное время без новых вызовов
  *

package/dist/async/space.d.ts

@@ -0,0 +1,7 @@
+export declare abstract class AsyncSpace<TX> {
+    private async_storage;
+    getTX(): TX[];
+    space<T>(call: (tx: TX[]) => Promise<T>, auto?: boolean): Promise<T>;
+    commit(): Promise<void>;
+    protected abstract submit(tx: TX[]): Promise<void>;
+}

package/dist/async/space.js

@@ -0,0 +1,30 @@
+import { AsyncLocalStorage } from "async_hooks";
+export class AsyncSpace {
+    async_storage = new AsyncLocalStorage();
+    getTX() {
+        const ctx = this.async_storage.getStore();
+        if (ctx)
+            return ctx;
+        throw new Error("getTX() called outside of space()");
+    }
+    async space(call, auto = true) {
+        const ctx = this.async_storage.getStore();
+        if (ctx)
+            return call(ctx);
+        //...
+        const tx = [];
+        const result = await this.async_storage.run(tx, () => call(tx));
+        if (auto && tx.length > 0) {
+            await this.submit(tx);
+            tx.length = 0;
+        }
+        return result;
+    }
+    async commit() {
+        const ctx = this.async_storage.getStore();
+        if (!ctx)
+            throw new Error("commit() called outside of space()");
+        await this.submit(ctx);
+        ctx.length = 0;
+    }
+}

package/dist/files.d.ts

@@ -6,6 +6,14 @@ export declare const fileToBase64: (file: File) => Promise<string>;
  * @returns true, если файл является изображением
  */
 export declare const isImage: (file: File) => boolean;
+/**
+ * Проверяет, является ли файл видео
+ */
+export declare const isVideo: (file: File) => boolean;
+/**
+ * Проверяет, является ли файл аудио
+ */
+export declare const isAudio: (file: File) => boolean;
 /**
  * Преобразует размер файла в человекочитаемый формат
  *

package/dist/files.js

@@ -12,6 +12,14 @@ export const fileToBase64 = (file) => new Promise((resolve, reject) => {
  * @returns true, если файл является изображением
  */
 export const isImage = (file) => file.type.startsWith("image/") && !file.type.includes("svg");
+/**
+ * Проверяет, является ли файл видео
+ */
+export const isVideo = (file) => file.type.startsWith("video/");
+/**
+ * Проверяет, является ли файл аудио
+ */
+export const isAudio = (file) => file.type.startsWith("audio/");
 //...
 const UNITS = [
     "B",

package/dist/format.js

@@ -1,5 +1,5 @@
 import { caseNumber } from "./cases.js";
-import { toRound } from "./phymath.js";
+import { toRound } from "./phymath/index.js";
 export const FormatNumberRegExp = /\B(?=(\d{3})+(?!\d))/g;
 /**
  * Форматирование числа по тысячам

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { CanBeArray } from "./types.js";
+import type { CanBeArray, CanBeReadonly } from "./types.js";
 /**
  * Добавляет ведущие нули к числу для достижения указанной длины
  *
@@ -32,11 +32,11 @@ export interface Partition<T> {
 /**
  * Разделяет массив на два по условию
  */
-export declare const partition: <T>(arr: T[], filter: (item: T) => boolean, initial?: Partition<T>) => Partition<T>;
+export declare const partition: <T>(arr: CanBeReadonly<T>, filter: (item: T) => boolean, initial?: Partition<T>) => Partition<T>;
 /**
  * Удаляет `null` и `undefined` и оставляет только уникальные строки
  */
-export declare const setify: (arr: (string | undefined | null)[]) => string[];
+export declare const setify: (arr: CanBeReadonly<string | undefined | null>) => string[];
 /**
  * Удаляет дубликаты объектов из массива на основе указанного ключа
  *
@@ -46,5 +46,9 @@ export declare const setify: (arr: (string | undefined | null)[]) => string[];
  * @param {K} [key="id"] - Ключ, по которому будут удаляться дубликаты
  * @returns {T[]} Новый массив без дубликатов
  */
-export declare const unify: <T, K extends keyof T>(arr: T[], key?: K) => T[];
+export declare const unify: <T, K extends keyof T>(arr: CanBeReadonly<T>, key?: K) => T[];
 export declare const useConditionGuard: (condition: unknown, ...args: any[]) => boolean;
+/**
+ * Сортирует ключи объекта в алфавитном порядке и возвращает новый объект с отсортированными ключами
+ */
+export declare function sortObjectByKeys<T>(obj: T): T;

package/dist/index.js

@@ -23,12 +23,16 @@ export const isSameType = (a, b) => Object.prototype.toString.call(a) === Object
 /**
  * Разделяет массив на два по условию
  */
-export const partition = (arr, filter, initial = { result: [], excluded: [] }) => arr.reduce((acc, item) => (acc[filter(item) ? "result" : "excluded"].push(item), acc), initial);
+export const partition = (arr, filter, initial = { result: [], excluded: [] }) => 
+// @ts-expect-error <оно себя неадекватно ведёт>
+arr.reduce((acc, item) => (acc[filter(item) ? "result" : "excluded"].push(item), acc), initial);
 //...
 /**
  * Удаляет `null` и `undefined` и оставляет только уникальные строки
  */
-export const setify = (arr) => [...new Set(arr.filter((item) => typeof item === "string"))];
+export const setify = (arr) => 
+// @ts-expect-error <оно себя неадекватно ведёт>
+[...new Set(arr.filter((item) => typeof item === "string"))];
 /**
  * Удаляет дубликаты объектов из массива на основе указанного ключа
  *
@@ -38,7 +42,9 @@ export const setify = (arr) => [...new Set(arr.filter((item) => typeof item ===
  * @param {K} [key="id"] - Ключ, по которому будут удаляться дубликаты
  * @returns {T[]} Новый массив без дубликатов
  */
-export const unify = (arr, key = "id") => [...new Map(arr.map((item) => [item[key], item])).values()];
+export const unify = (arr, key = "id") => 
+// @ts-expect-error <оно себя неадекватно ведёт>
+[...new Map(arr.map((item) => [item[key], item])).values()];
 //...
 export const useConditionGuard = (condition, ...args) => {
     switch (typeof condition) {
@@ -50,3 +56,14 @@ export const useConditionGuard = (condition, ...args) => {
             return !!condition;
     }
 };
+//...
+/**
+ * Сортирует ключи объекта в алфавитном порядке и возвращает новый объект с отсортированными ключами
+ */
+export function sortObjectByKeys(obj) {
+    const keys = Object.keys(obj).sort();
+    const result = {};
+    for (const key of keys)
+        result[key] = obj[key];
+    return result;
+}

package/dist/script.d.ts

@@ -1,3 +1,5 @@
+import type { Timestamp } from "./types.js";
+import type { ExecException } from "node:child_process";
 /**
  * Ищет значение флага в массиве аргументов процесса
  *
@@ -11,3 +13,35 @@
 declare function getProcessFlag(cmd: string[], name: string, strict: boolean): string | null;
 declare function getProcessFlag(cmd: string[], name: string, strict?: true): string;
 export { getProcessFlag };
+export interface ExecuteLogger {
+    /**
+     * Перед выполнением команды
+     */
+    before?: (path: string) => string;
+    /**
+     * При возникновении ошибки
+     */
+    onerror?: (error: ExecException) => string;
+    /**
+     * При истечении таймаута
+     */
+    ontimeout?: () => string;
+}
+export interface ExecuteOptions {
+    logger?: ExecuteLogger;
+    /**
+     * @default 5min
+     */
+    timeout?: Timestamp;
+}
+/**
+ * Запускает дочерний процесс с указанной командой в заданной директории
+ *
+ * @param path - Директория, в которой будет выполнена команда
+ * @param command - Команда для выполнения
+ * @param logger - Хуки для логирования {@link ChildLogger}
+ * @param [timeout=5min] - Таймаут выполнения команды в миллисекундах (по умолчанию 5 минут)
+ *
+ * @throws {Error} Если команда завершается с ошибкой или истекает таймаут
+ */
+export declare const execute: (path: string, command: string, { logger, timeout }?: ExecuteOptions) => Promise<void>;

package/dist/script.js

@@ -1,3 +1,4 @@
+import { exec } from "node:child_process";
 function getProcessFlag(cmd, name, strict = true) {
     const argv = cmd.slice(2);
     const index = argv.indexOf(name);
@@ -12,3 +13,46 @@ function getProcessFlag(cmd, name, strict = true) {
     return null;
 }
 export { getProcessFlag };
+/**
+ * Запускает дочерний процесс с указанной командой в заданной директории
+ *
+ * @param path - Директория, в которой будет выполнена команда
+ * @param command - Команда для выполнения
+ * @param logger - Хуки для логирования {@link ChildLogger}
+ * @param [timeout=5min] - Таймаут выполнения команды в миллисекундах (по умолчанию 5 минут)
+ *
+ * @throws {Error} Если команда завершается с ошибкой или истекает таймаут
+ */
+export const execute = async (path, command, { logger = {}, timeout = 5 * 60 * 1000 } = {}) => new Promise((resolve, reject) => {
+    if (logger.before)
+        console.log(logger.before(path));
+    let timer = null;
+    let process = null;
+    const cleanup = () => {
+        if (!timer)
+            return;
+        clearTimeout(timer);
+        timer = null;
+    };
+    timer = setTimeout(() => {
+        process?.kill("SIGTERM");
+        if (logger.ontimeout)
+            console.error(logger.ontimeout());
+        reject(new Error("TIMEOUT"));
+    }, timeout);
+    process = exec(command, { cwd: path }, (error, stdout, stderr) => {
+        cleanup();
+        if (stderr)
+            console.warn(stderr);
+        if (stdout)
+            console.log(stdout);
+        if (error) {
+            if (logger.onerror)
+                console.error(logger.onerror(error));
+            reject(error);
+            return;
+        }
+        resolve();
+    });
+    process.on("exit", cleanup);
+});

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export type * from "./phymath.types.js";
+export type * from "./phymath/types.js";
 import type { ZIP } from "./zipper.js";
 export type { ZIP };
 /**
@@ -29,6 +29,10 @@ export type CanBeNullable<T = unknown> = T | null | undefined;
  * Значение может быть массивом или одиночным элементом
  */
 export type CanBeArray<T = unknown> = T | T[];
+/**
+ * Массив может быть readonly
+ */
+export type CanBeReadonly<T = unknown> = readonly T[] | T[];
 /**
  * Значение может быть промиссом
  */

package/package.json

@@ -1,12 +1,16 @@
 {
 	"name": "@nemigo/helpers",
-	"version": "0.7.0",
+	"version": "0.8.0",
 	"private": false,
 	"author": {
 		"name": "Vlad Logvin",
 		"email": "vlad.logvin84@gmail.com"
 	},
 	"type": "module",
+	"engines": {
+		"node": ">=22",
+		"pnpm": ">=10.9.0"
+	},
 	"scripts": {
 		"build": "svelte-package && rimraf .svelte-kit",
 		"check": "tsc --noemit",
@@ -20,8 +24,12 @@
 			"default": "./dist/index.js"
 		},
 		"./async": {
-			"types": "./dist/async.d.ts",
-			"default": "./dist/async.js"
+			"types": "./dist/async/index.d.ts",
+			"default": "./dist/async/index.js"
+		},
+		"./async/space": {
+			"types": "./dist/async/space.d.ts",
+			"default": "./dist/async/space.js"
 		},
 		"./cases": {
 			"types": "./dist/cases.d.ts",
@@ -84,12 +92,12 @@
 			"default": "./dist/omitter.js"
 		},
 		"./phymath": {
-			"types": "./dist/phymath.d.ts",
-			"default": "./dist/phymath.js"
+			"types": "./dist/phymath/index.d.ts",
+			"default": "./dist/phymath/index.js"
 		},
 		"./phymath/types": {
-			"types": "./dist/phymath.types.d.ts",
-			"default": "./dist/phymath.types.js"
+			"types": "./dist/phymath/types.d.ts",
+			"default": "./dist/phymath/types.js"
 		},
 		"./promoter": {
 			"types": "./dist/promoter.d.ts",