@nemigo/helpers 0.13.2 → 1.5.0

package/dist/zipper.d.ts

@@ -1,12 +1,30 @@
+import type { Serializable } from "./types.js";
 /**
- * Уникальный хэш для данных
+ * Тип хэша из {@link zipper}
  */
 export type ZIP = string;
 /**
- * Полином для {@link zipper}
+ * Предварительно вычисленный массив из 256 32-битных значений полинома 0xEDB88320 (стандартный для {@link http://create.stephan-brumme.com/crc32 CRC32})
  */
 export declare const polynomial: Uint32Array<ArrayBuffer>;
 /**
- * Вдохновлено (а может и является) CRC32
+ * Генерирует хэш в формате `${prefix}{hash}` на основе алгоритма {@link http://create.stephan-brumme.com/crc32 CRC32}
+ *
+ * @remarks Для сериализации используется {@link JSON.stringify}
+ * @remarks Порядок свойств в объектах **влияет** на результат
+ *
+ * @param data - Данные для хэширования
+ * @param [prefix="zip:"] - Префикс для идентификации хэша
+ *
+ * @example
+ * ```typescript
+ * const obj1 = { age: 30, name: "John" };
+ * const obj2 = { age: 30, name: "John" };
+ * const obj3 = { name: "John", age: 30 }; // Обратный порядок
+ *
+ * const hash1 = zipper(obj1); // "zip:4a8f3c2e"
+ * const hash2 = zipper(obj2); // "zip:4a8f3c2e" (тот же хэш)
+ * const hash3 = zipper(obj3); // "zip:6b9g4d3f" (другой хэш)
+ * ```
  */
-export declare function zipper(data?: unknown): ZIP;
+export declare const zipper: (data: Serializable, prefix?: string) => ZIP;

package/dist/zipper.js

@@ -1,5 +1,5 @@
 /**
- * Полином для {@link zipper}
+ * Предварительно вычисленный массив из 256 32-битных значений полинома 0xEDB88320 (стандартный для {@link http://create.stephan-brumme.com/crc32 CRC32})
  */
 export const polynomial = Uint32Array.from({ length: 256 }, (_, i) => {
     let crc = i;
@@ -8,12 +8,29 @@ export const polynomial = Uint32Array.from({ length: 256 }, (_, i) => {
     return crc;
 });
 /**
- * Вдохновлено (а может и является) CRC32
+ * Генерирует хэш в формате `${prefix}{hash}` на основе алгоритма {@link http://create.stephan-brumme.com/crc32 CRC32}
+ *
+ * @remarks Для сериализации используется {@link JSON.stringify}
+ * @remarks Порядок свойств в объектах **влияет** на результат
+ *
+ * @param data - Данные для хэширования
+ * @param [prefix="zip:"] - Префикс для идентификации хэша
+ *
+ * @example
+ * ```typescript
+ * const obj1 = { age: 30, name: "John" };
+ * const obj2 = { age: 30, name: "John" };
+ * const obj3 = { name: "John", age: 30 }; // Обратный порядок
+ *
+ * const hash1 = zipper(obj1); // "zip:4a8f3c2e"
+ * const hash2 = zipper(obj2); // "zip:4a8f3c2e" (тот же хэш)
+ * const hash3 = zipper(obj3); // "zip:6b9g4d3f" (другой хэш)
+ * ```
  */
-export function zipper(data = "undefined") {
+export const zipper = (data, prefix = "zip:") => {
     const str = JSON.stringify(data);
     let crc = 0 ^ -1;
     for (let i = str.length - 1; i >= 0; i--)
         crc = (crc >>> 8) ^ polynomial[(crc ^ str.charCodeAt(i)) & 0xff];
-    return "zi" + ((crc ^ -1) >>> 0).toString(16);
-}
+    return prefix + ((crc ^ -1) >>> 0).toString(16).padStart(8, "0");
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nemigo/helpers",
-	"version": "0.13.2",
+	"version": "1.5.0",
 	"private": false,
 	"author": {
 		"name": "Vlad Logvin",
@@ -23,13 +23,33 @@
 			"types": "./dist/index.d.ts",
 			"default": "./dist/index.js"
 		},
+		"./aggregator": {
+			"types": "./dist/aggregator.d.ts",
+			"default": "./dist/aggregator.js"
+		},
+		"./array": {
+			"types": "./dist/sortify.d.ts",
+			"default": "./dist/sortify.js"
+		},
 		"./async": {
 			"types": "./dist/async/index.d.ts",
 			"default": "./dist/async/index.js"
 		},
-		"./async/space": {
-			"types": "./dist/async/space.d.ts",
-			"default": "./dist/async/space.js"
+		"./async/context": {
+			"types": "./dist/async/context.d.ts",
+			"default": "./dist/async/context.js"
+		},
+		"./async/future": {
+			"types": "./dist/async/future.d.ts",
+			"default": "./dist/async/future.js"
+		},
+		"./async/loader": {
+			"types": "./dist/async/loader.d.ts",
+			"default": "./dist/async/loader.js"
+		},
+		"./async/queue": {
+			"types": "./dist/async/queue.d.ts",
+			"default": "./dist/async/queue.js"
 		},
 		"./cases": {
 			"types": "./dist/cases.d.ts",
@@ -39,21 +59,29 @@
 			"types": "./dist/clean.d.ts",
 			"default": "./dist/clean.js"
 		},
-		"./cleanup": {
-			"types": "./dist/cleanup.d.ts",
-			"default": "./dist/cleanup.js"
+		"./color": {
+			"types": "./dist/color/index.d.ts",
+			"default": "./dist/color/index.js"
 		},
-		"./colors": {
-			"types": "./dist/colors.d.ts",
-			"default": "./dist/colors.js"
-		},
-		"./cookie": {
-			"types": "./dist/cookie.d.ts",
-			"default": "./dist/cookie.js"
+		"./color/types": {
+			"types": "./dist/color/types.d.ts",
+			"default": "./dist/color/types.js"
 		},
 		"./datetime": {
-			"types": "./dist/datetime.d.ts",
-			"default": "./dist/datetime.js"
+			"types": "./dist/datetime/index.d.ts",
+			"default": "./dist/datetime/index.js"
+		},
+		"./datetime/delta": {
+			"types": "./dist/datetime/delta.d.ts",
+			"default": "./dist/datetime/delta.js"
+		},
+		"./datetime/format": {
+			"types": "./dist/datetime/format.d.ts",
+			"default": "./dist/datetime/format.js"
+		},
+		"./datetime/plural": {
+			"types": "./dist/datetime/plural.d.ts",
+			"default": "./dist/datetime/plural.js"
 		},
 		"./emitter": {
 			"types": "./dist/emitter.d.ts",
@@ -67,34 +95,38 @@
 			"types": "./dist/files.d.ts",
 			"default": "./dist/files.js"
 		},
-		"./format": {
-			"types": "./dist/format.d.ts",
-			"default": "./dist/format.js"
+		"./fish": {
+			"types": "./dist/cases.d.ts",
+			"default": "./dist/cases.js"
 		},
 		"./future": {
 			"types": "./dist/future.d.ts",
 			"default": "./dist/future.js"
 		},
 		"./html": {
-			"types": "./dist/html.d.ts",
-			"default": "./dist/html.js"
+			"types": "./dist/html/index.d.ts",
+			"default": "./dist/html/index.js"
+		},
+		"./html/cookie": {
+			"types": "./dist/html/cookie.d.ts",
+			"default": "./dist/html/cookie.js"
 		},
-		"./humanly": {
-			"types": "./dist/humanly.d.ts",
-			"default": "./dist/humanly.js"
+		"./html/events": {
+			"types": "./dist/html/events.d.ts",
+			"default": "./dist/html/events.js"
 		},
 		"./lens": {
 			"types": "./dist/lens.d.ts",
 			"default": "./dist/lens.js"
 		},
-		"./lru": {
-			"types": "./dist/lru.d.ts",
-			"default": "./dist/lru.js"
-		},
 		"./msgpack": {
 			"types": "./dist/msgpack.d.ts",
 			"default": "./dist/msgpack.js"
 		},
+		"./mutate": {
+			"types": "./dist/mutate.d.ts",
+			"default": "./dist/mutate.js"
+		},
 		"./omitter": {
 			"types": "./dist/omitter.d.ts",
 			"default": "./dist/omitter.js"
@@ -107,6 +139,10 @@
 			"types": "./dist/phymath/index.d.ts",
 			"default": "./dist/phymath/index.js"
 		},
+		"./phymath/format": {
+			"types": "./dist/phymath/format.d.ts",
+			"default": "./dist/phymath/format.js"
+		},
 		"./phymath/types": {
 			"types": "./dist/phymath/types.d.ts",
 			"default": "./dist/phymath/types.js"
@@ -115,14 +151,14 @@
 			"types": "./dist/promoter.d.ts",
 			"default": "./dist/promoter.js"
 		},
-		"./queue": {
-			"types": "./dist/queue.d.ts",
-			"default": "./dist/queue.js"
-		},
 		"./random": {
 			"types": "./dist/random.d.ts",
 			"default": "./dist/random.js"
 		},
+		"./rubles": {
+			"types": "./dist/rubles.d.ts",
+			"default": "./dist/rubles.js"
+		},
 		"./script": {
 			"types": "./dist/script.d.ts",
 			"default": "./dist/script.js"
@@ -136,8 +172,20 @@
 			"default": "./dist/types.js"
 		},
 		"./url": {
-			"types": "./dist/url.d.ts",
-			"default": "./dist/url.js"
+			"types": "./dist/url/index.d.ts",
+			"default": "./dist/url/index.js"
+		},
+		"./url/params": {
+			"types": "./dist/url/params.d.ts",
+			"default": "./dist/url/params.js"
+		},
+		"./url/slug": {
+			"types": "./dist/url/slug.d.ts",
+			"default": "./dist/url/slug.js"
+		},
+		"./veil": {
+			"types": "./dist/veil.d.ts",
+			"default": "./dist/veil.js"
 		},
 		"./xod": {
 			"types": "./dist/xod.d.ts",

package/dist/async/space.d.ts

@@ -1,7 +0,0 @@
-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

@@ -1,31 +0,0 @@
-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/cleanup.d.ts

@@ -1,9 +0,0 @@
-type CleanFunc = () => void;
-export declare class CleanUP {
-    private calls;
-    constructor(...args: CleanFunc[]);
-    push(...args: CleanFunc[]): void;
-    run(): void;
-    update(...args: CleanFunc[]): void;
-}
-export {};

package/dist/cleanup.js

@@ -1,18 +0,0 @@
-export class CleanUP {
-    calls = [];
-    constructor(...args) {
-        this.calls = args;
-    }
-    push(...args) {
-        this.calls = this.calls.concat(args);
-    }
-    run() {
-        for (const call of this.calls)
-            call();
-        this.calls.length = 0;
-    }
-    update(...args) {
-        this.run();
-        this.calls = args;
-    }
-}