@adaas/a-utils 0.3.6 → 0.3.7

package/dist/browser/chunk-S2RSPZXR.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/helpers/A-Utils.helper.ts"],"names":[],"mappings":"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","file":"chunk-S2RSPZXR.mjs","sourcesContent":["import { A_Caller, A_Component, A_Feature, A_Inject } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { A_ExecutionContext } from \"@adaas/a-utils/a-execution\";\n\n\n\n@A_Frame.Component({\n    namespace: 'A-Utils',\n    name: 'A-UtilsHelper',\n    description: 'Utility helper class providing common functions for A-Utils library, such as hashing and serialization.'\n})\nexport class A_UtilsHelper extends A_Component {\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── Hashing ──────────────────────────────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Produces a deterministic, collision-resistant hash string for any JS value.\n     * \n     * Improvements over the legacy `createHash`:\n     *  - **Null-safe** — handles `null` without throwing  \n     *  - **Function-aware serialization** — functions inside objects / arrays are\n     *    serialized via `.toString()` so `{ fn: () => 1 }` ≠ `{}`  \n     *  - **FNV-1a 52-bit** — better avalanche / distribution than DJB2-32,\n     *    and uses the safe JS integer range so the result is always positive  \n     *  - **Hex output** — compact, URL-safe, fixed-width (13 chars)\n     * \n     * @param value  Any value: string, number, boolean, null, undefined,\n     *               object, array, Map, Set, function, or a mix of these.\n     * @returns      A 13-character lower-hex string (52-bit FNV-1a).\n     */\n    static hash(value?: any): string {\n        const source = A_UtilsHelper.serialize(value);\n        return A_UtilsHelper.fnv1a52(source);\n    }\n\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── Serialization ────────────────────────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Converts any JS value into a deterministic string representation\n     * suitable for hashing.\n     * \n     * Key properties:\n     *  - **Deterministic**: same logical value → same string every time\n     *  - **Injective-ish**: structurally different values produce different\n     *    strings (type tags prevent `\"3\"` vs `3` collisions)\n     *  - **Recursive**: handles nested objects, arrays, Maps, Sets\n     *  - **Function-aware**: serializes functions via `.toString()`\n     * \n     * @param value  Anything.\n     * @returns      A deterministic string.\n     */\n    static serialize(value: any): string {\n        // Primitives & null/undefined\n        if (value === null) return '<null>';\n        if (value === undefined) return '<undefined>';\n\n        switch (typeof value) {\n            case 'string':\n                return `s:${value}`;\n            case 'number':\n                return `n:${value}`;\n            case 'boolean':\n                return `b:${value}`;\n            case 'bigint':\n                return `bi:${value}`;\n            case 'symbol':\n                return `sym:${value.toString()}`;\n            case 'function':\n                return `fn:${value.toString()}`;\n        }\n\n        // Map\n        if (value instanceof Map) {\n            const entries = Array.from(value.entries())\n                .map(([k, v]) => `${A_UtilsHelper.serialize(k)}=>${A_UtilsHelper.serialize(v)}`)\n                .sort()\n                .join(',');\n            return `Map{${entries}}`;\n        }\n\n        // Set\n        if (value instanceof Set) {\n            const items = Array.from(value.values())\n                .map(v => A_UtilsHelper.serialize(v))\n                .sort()\n                .join(',');\n            return `Set{${items}}`;\n        }\n\n        // Date\n        if (value instanceof Date) {\n            return `Date:${value.toISOString()}`;\n        }\n\n        // RegExp\n        if (value instanceof RegExp) {\n            return `RegExp:${value.toString()}`;\n        }\n\n        // Array\n        if (Array.isArray(value)) {\n            const items = value.map(v => A_UtilsHelper.serialize(v)).join(',');\n            return `[${items}]`;\n        }\n\n        // toJSON support (e.g. custom entities, ASEID, etc.)\n        if (typeof value.toJSON === 'function') {\n            return `json:${A_UtilsHelper.serialize(value.toJSON())}`;\n        }\n\n        // Plain object — sort keys for determinism, serialize functions too\n        const keys = Object.keys(value).sort();\n        const pairs = keys.map(k => `${k}:${A_UtilsHelper.serialize(value[k])}`).join(',');\n        return `{${pairs}}`;\n    }\n\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── FNV-1a (pure Number, no BigInt) ──────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * FNV-1a hash using two 32-bit halves to simulate a 52-bit space,\n     * without requiring BigInt.\n     * \n     * Works identically in:\n     *  - All browsers (including Safari 13, IE11 polyfill targets, React Native)\n     *  - Node.js (any version)\n     *  - Web Workers, Service Workers, Deno, Bun\n     * \n     * - Better avalanche than DJB2 (each input bit affects many output bits)\n     * - ~52-bit effective space — vastly fewer collisions than 32-bit\n     * - Always produces a **positive** hex string of 13 characters\n     * \n     * @param input  Pre-serialized string.\n     * @returns      13-character lower-hex string.\n     */\n    private static fnv1a52(input: string): string {\n        // FNV-1a offset basis split into two 32-bit halves\n        let h1 = 0x811c9dc5;  // low 32 bits\n        let h2 = 0x00000842;  // high 20 bits (keeps us in 52-bit range)\n\n        // FNV prime = 0x01000193\n        const PRIME = 0x01000193;\n\n        for (let i = 0; i < input.length; i++) {\n            h1 ^= input.charCodeAt(i);\n\n            // Multiply h1 by prime (32-bit, unsigned)\n            const product = Math.imul(h1, PRIME);\n            h1 = product >>> 0;\n\n            // Carry overflow into h2, keep h2 within 20 bits\n            h2 = ((Math.imul(h2, PRIME) + (product / 0x100000000 >>> 0)) & 0xFFFFF) >>> 0;\n        }\n\n        // Combine: h2 (20 bits) << 32 | h1 (32 bits) → 52-bit number\n        // Since 2^52 fits in Number.MAX_SAFE_INTEGER, this is exact.\n        const combined = h2 * 0x100000000 + h1;\n\n        return combined.toString(16).padStart(13, '0');\n    }\n\n\n\n    // ==============================================================================\n    // =============== Instance methods for used for Injection ======================\n    // ==============================================================================\n    @A_Frame.Method({\n        description: 'Instance method wrapper for the static hash function, allowing it to be injected as a dependency.'\n    })\n    hash(\n        @A_Inject(A_Caller) caller: any,\n        @A_Inject(A_ExecutionContext) context: A_ExecutionContext,\n        @A_Inject(A_Feature) feature: A_Feature\n    ) {\n        const hash = A_UtilsHelper.hash(caller);\n\n        context.set(feature.name, hash);\n    }\n}"]}

package/dist/browser/helpers.d.mts

@@ -0,0 +1,56 @@
+import { A_Component, A_Feature } from '@adaas/a-concept';
+import { A_ExecutionContext } from './a-execution.mjs';
+
+declare class A_UtilsHelper extends A_Component {
+    /**
+     * Produces a deterministic, collision-resistant hash string for any JS value.
+     *
+     * Improvements over the legacy `createHash`:
+     *  - **Null-safe** — handles `null` without throwing
+     *  - **Function-aware serialization** — functions inside objects / arrays are
+     *    serialized via `.toString()` so `{ fn: () => 1 }` ≠ `{}`
+     *  - **FNV-1a 52-bit** — better avalanche / distribution than DJB2-32,
+     *    and uses the safe JS integer range so the result is always positive
+     *  - **Hex output** — compact, URL-safe, fixed-width (13 chars)
+     *
+     * @param value  Any value: string, number, boolean, null, undefined,
+     *               object, array, Map, Set, function, or a mix of these.
+     * @returns      A 13-character lower-hex string (52-bit FNV-1a).
+     */
+    static hash(value?: any): string;
+    /**
+     * Converts any JS value into a deterministic string representation
+     * suitable for hashing.
+     *
+     * Key properties:
+     *  - **Deterministic**: same logical value → same string every time
+     *  - **Injective-ish**: structurally different values produce different
+     *    strings (type tags prevent `"3"` vs `3` collisions)
+     *  - **Recursive**: handles nested objects, arrays, Maps, Sets
+     *  - **Function-aware**: serializes functions via `.toString()`
+     *
+     * @param value  Anything.
+     * @returns      A deterministic string.
+     */
+    static serialize(value: any): string;
+    /**
+     * FNV-1a hash using two 32-bit halves to simulate a 52-bit space,
+     * without requiring BigInt.
+     *
+     * Works identically in:
+     *  - All browsers (including Safari 13, IE11 polyfill targets, React Native)
+     *  - Node.js (any version)
+     *  - Web Workers, Service Workers, Deno, Bun
+     *
+     * - Better avalanche than DJB2 (each input bit affects many output bits)
+     * - ~52-bit effective space — vastly fewer collisions than 32-bit
+     * - Always produces a **positive** hex string of 13 characters
+     *
+     * @param input  Pre-serialized string.
+     * @returns      13-character lower-hex string.
+     */
+    private static fnv1a52;
+    hash(caller: any, context: A_ExecutionContext, feature: A_Feature): void;
+}
+
+export { A_UtilsHelper };

package/dist/browser/helpers.mjs

@@ -0,0 +1,5 @@
+export { A_UtilsHelper } from './chunk-S2RSPZXR.mjs';
+import './chunk-TQ5UON22.mjs';
+import './chunk-EQQGB2QZ.mjs';
+//# sourceMappingURL=helpers.mjs.map
+//# sourceMappingURL=helpers.mjs.map

package/dist/browser/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"helpers.mjs"}

package/dist/node/{A-Signal.types-C0Ta5Unp.d.mts → A-Signal.types-DxQHmPm6.d.mts}

@@ -14,32 +14,10 @@ import { A_Entity, A_TYPES__Entity_Serialized, A_TYPES__Entity_Constructor } fro
  * such as monitoring systems, real-time dashboards, or stateful applications.
  */
 declare class A_Signal<_TSignalDataType extends any = any, _TSignalSerializedDataType extends any = _TSignalDataType> extends A_Entity<A_Signal_Init<_TSignalDataType>, A_Signal_Serialized<_TSignalSerializedDataType>> {
-    /**
-     * Allows to define default data for the signal.
-     *
-     * If no data is provided during initialization, the default data will be used.
-     *
-     * @returns
-     */
-    static default(): A_Signal | undefined;
     /**
      * The actual data carried by the signal.
      */
     data: _TSignalDataType;
-    /**
-      * Generates signal hash uses for comparison
-      *
-      * @param str
-      */
-    protected createHash(str?: string): string;
-    protected createHash(str?: undefined): string;
-    protected createHash(str?: Record<string, any>): string;
-    protected createHash(str?: Array<any>): string;
-    protected createHash(str?: number): string;
-    protected createHash(str?: boolean): string;
-    protected createHash(str?: null): string;
-    protected createHash(map?: Map<any, any>): string;
-    protected createHash(set?: Set<any>): string;
     /**
      * This method compares the current signal with another signal instance by deduplication ID
      * this id can be configured during initialization with the "id" property.
@@ -54,8 +32,26 @@ declare class A_Signal<_TSignalDataType extends any = any, _TSignalSerializedDat
      * @returns
      */
     compare(other: A_Signal<_TSignalDataType>): boolean;
-    fromJSON(serializedEntity: A_Signal_Serialized<_TSignalSerializedDataType>): void;
+    /**
+     * Allows to define default data for the signal.
+     *
+     * If no data is provided during initialization, the default data will be used.
+     *
+     * @returns
+     */
+    fromUndefined(): void;
+    /**
+     * Allows to initialize the signal from a new signal entity. This is useful for example when we want to create a new instance of the signal entity with the same data as another instance, but with a different ASEID.
+     *
+     * @param newEntity
+     */
     fromNew(newEntity: A_Signal_Init<_TSignalDataType>): void;
+    /**
+     * Allows to initialize the signal from a serialized version of the signal. This is useful for example when we receive a signal from the server and we want to create an instance of the signal entity from the received data.
+     *
+     * @param serializedEntity
+     */
+    fromJSON(serializedEntity: A_Signal_Serialized<_TSignalSerializedDataType>): void;
     toJSON(): A_Signal_Serialized<_TSignalSerializedDataType>;
 }
 

package/dist/node/{A-Signal.types-C0Ta5Unp.d.ts → A-Signal.types-DxQHmPm6.d.ts}

@@ -14,32 +14,10 @@ import { A_Entity, A_TYPES__Entity_Serialized, A_TYPES__Entity_Constructor } fro
  * such as monitoring systems, real-time dashboards, or stateful applications.
  */
 declare class A_Signal<_TSignalDataType extends any = any, _TSignalSerializedDataType extends any = _TSignalDataType> extends A_Entity<A_Signal_Init<_TSignalDataType>, A_Signal_Serialized<_TSignalSerializedDataType>> {
-    /**
-     * Allows to define default data for the signal.
-     *
-     * If no data is provided during initialization, the default data will be used.
-     *
-     * @returns
-     */
-    static default(): A_Signal | undefined;
     /**
      * The actual data carried by the signal.
      */
     data: _TSignalDataType;
-    /**
-      * Generates signal hash uses for comparison
-      *
-      * @param str
-      */
-    protected createHash(str?: string): string;
-    protected createHash(str?: undefined): string;
-    protected createHash(str?: Record<string, any>): string;
-    protected createHash(str?: Array<any>): string;
-    protected createHash(str?: number): string;
-    protected createHash(str?: boolean): string;
-    protected createHash(str?: null): string;
-    protected createHash(map?: Map<any, any>): string;
-    protected createHash(set?: Set<any>): string;
     /**
      * This method compares the current signal with another signal instance by deduplication ID
      * this id can be configured during initialization with the "id" property.
@@ -54,8 +32,26 @@ declare class A_Signal<_TSignalDataType extends any = any, _TSignalSerializedDat
      * @returns
      */
     compare(other: A_Signal<_TSignalDataType>): boolean;
-    fromJSON(serializedEntity: A_Signal_Serialized<_TSignalSerializedDataType>): void;
+    /**
+     * Allows to define default data for the signal.
+     *
+     * If no data is provided during initialization, the default data will be used.
+     *
+     * @returns
+     */
+    fromUndefined(): void;
+    /**
+     * Allows to initialize the signal from a new signal entity. This is useful for example when we want to create a new instance of the signal entity with the same data as another instance, but with a different ASEID.
+     *
+     * @param newEntity
+     */
     fromNew(newEntity: A_Signal_Init<_TSignalDataType>): void;
+    /**
+     * Allows to initialize the signal from a serialized version of the signal. This is useful for example when we receive a signal from the server and we want to create an instance of the signal entity from the received data.
+     *
+     * @param serializedEntity
+     */
+    fromJSON(serializedEntity: A_Signal_Serialized<_TSignalSerializedDataType>): void;
     toJSON(): A_Signal_Serialized<_TSignalSerializedDataType>;
 }
 

package/dist/node/helpers/A-Utils.helper.d.mts

@@ -0,0 +1,56 @@
+import { A_Component, A_Feature } from '@adaas/a-concept';
+import { A_ExecutionContext } from '../lib/A-Execution/A-Execution.context.mjs';
+
+declare class A_UtilsHelper extends A_Component {
+    /**
+     * Produces a deterministic, collision-resistant hash string for any JS value.
+     *
+     * Improvements over the legacy `createHash`:
+     *  - **Null-safe** — handles `null` without throwing
+     *  - **Function-aware serialization** — functions inside objects / arrays are
+     *    serialized via `.toString()` so `{ fn: () => 1 }` ≠ `{}`
+     *  - **FNV-1a 52-bit** — better avalanche / distribution than DJB2-32,
+     *    and uses the safe JS integer range so the result is always positive
+     *  - **Hex output** — compact, URL-safe, fixed-width (13 chars)
+     *
+     * @param value  Any value: string, number, boolean, null, undefined,
+     *               object, array, Map, Set, function, or a mix of these.
+     * @returns      A 13-character lower-hex string (52-bit FNV-1a).
+     */
+    static hash(value?: any): string;
+    /**
+     * Converts any JS value into a deterministic string representation
+     * suitable for hashing.
+     *
+     * Key properties:
+     *  - **Deterministic**: same logical value → same string every time
+     *  - **Injective-ish**: structurally different values produce different
+     *    strings (type tags prevent `"3"` vs `3` collisions)
+     *  - **Recursive**: handles nested objects, arrays, Maps, Sets
+     *  - **Function-aware**: serializes functions via `.toString()`
+     *
+     * @param value  Anything.
+     * @returns      A deterministic string.
+     */
+    static serialize(value: any): string;
+    /**
+     * FNV-1a hash using two 32-bit halves to simulate a 52-bit space,
+     * without requiring BigInt.
+     *
+     * Works identically in:
+     *  - All browsers (including Safari 13, IE11 polyfill targets, React Native)
+     *  - Node.js (any version)
+     *  - Web Workers, Service Workers, Deno, Bun
+     *
+     * - Better avalanche than DJB2 (each input bit affects many output bits)
+     * - ~52-bit effective space — vastly fewer collisions than 32-bit
+     * - Always produces a **positive** hex string of 13 characters
+     *
+     * @param input  Pre-serialized string.
+     * @returns      13-character lower-hex string.
+     */
+    private static fnv1a52;
+    hash(caller: any, context: A_ExecutionContext, feature: A_Feature): void;
+}
+
+export { A_UtilsHelper };

package/dist/node/helpers/A-Utils.helper.d.ts

@@ -0,0 +1,56 @@
+import { A_Component, A_Feature } from '@adaas/a-concept';
+import { A_ExecutionContext } from '../lib/A-Execution/A-Execution.context.js';
+
+declare class A_UtilsHelper extends A_Component {
+    /**
+     * Produces a deterministic, collision-resistant hash string for any JS value.
+     *
+     * Improvements over the legacy `createHash`:
+     *  - **Null-safe** — handles `null` without throwing
+     *  - **Function-aware serialization** — functions inside objects / arrays are
+     *    serialized via `.toString()` so `{ fn: () => 1 }` ≠ `{}`
+     *  - **FNV-1a 52-bit** — better avalanche / distribution than DJB2-32,
+     *    and uses the safe JS integer range so the result is always positive
+     *  - **Hex output** — compact, URL-safe, fixed-width (13 chars)
+     *
+     * @param value  Any value: string, number, boolean, null, undefined,
+     *               object, array, Map, Set, function, or a mix of these.
+     * @returns      A 13-character lower-hex string (52-bit FNV-1a).
+     */
+    static hash(value?: any): string;
+    /**
+     * Converts any JS value into a deterministic string representation
+     * suitable for hashing.
+     *
+     * Key properties:
+     *  - **Deterministic**: same logical value → same string every time
+     *  - **Injective-ish**: structurally different values produce different
+     *    strings (type tags prevent `"3"` vs `3` collisions)
+     *  - **Recursive**: handles nested objects, arrays, Maps, Sets
+     *  - **Function-aware**: serializes functions via `.toString()`
+     *
+     * @param value  Anything.
+     * @returns      A deterministic string.
+     */
+    static serialize(value: any): string;
+    /**
+     * FNV-1a hash using two 32-bit halves to simulate a 52-bit space,
+     * without requiring BigInt.
+     *
+     * Works identically in:
+     *  - All browsers (including Safari 13, IE11 polyfill targets, React Native)
+     *  - Node.js (any version)
+     *  - Web Workers, Service Workers, Deno, Bun
+     *
+     * - Better avalanche than DJB2 (each input bit affects many output bits)
+     * - ~52-bit effective space — vastly fewer collisions than 32-bit
+     * - Always produces a **positive** hex string of 13 characters
+     *
+     * @param input  Pre-serialized string.
+     * @returns      13-character lower-hex string.
+     */
+    private static fnv1a52;
+    hash(caller: any, context: A_ExecutionContext, feature: A_Feature): void;
+}
+
+export { A_UtilsHelper };

package/dist/node/helpers/A-Utils.helper.js

@@ -0,0 +1,153 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var aFrame = require('@adaas/a-frame');
+var aExecution = require('@adaas/a-utils/a-execution');
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+exports.A_UtilsHelper = class A_UtilsHelper extends aConcept.A_Component {
+  // ─────────────────────────────────────────────────────────────────────────────
+  // ── Hashing ──────────────────────────────────────────────────────────────────
+  // ─────────────────────────────────────────────────────────────────────────────
+  /**
+   * Produces a deterministic, collision-resistant hash string for any JS value.
+   * 
+   * Improvements over the legacy `createHash`:
+   *  - **Null-safe** — handles `null` without throwing  
+   *  - **Function-aware serialization** — functions inside objects / arrays are
+   *    serialized via `.toString()` so `{ fn: () => 1 }` ≠ `{}`  
+   *  - **FNV-1a 52-bit** — better avalanche / distribution than DJB2-32,
+   *    and uses the safe JS integer range so the result is always positive  
+   *  - **Hex output** — compact, URL-safe, fixed-width (13 chars)
+   * 
+   * @param value  Any value: string, number, boolean, null, undefined,
+   *               object, array, Map, Set, function, or a mix of these.
+   * @returns      A 13-character lower-hex string (52-bit FNV-1a).
+   */
+  static hash(value) {
+    const source = exports.A_UtilsHelper.serialize(value);
+    return exports.A_UtilsHelper.fnv1a52(source);
+  }
+  // ─────────────────────────────────────────────────────────────────────────────
+  // ── Serialization ────────────────────────────────────────────────────────────
+  // ─────────────────────────────────────────────────────────────────────────────
+  /**
+   * Converts any JS value into a deterministic string representation
+   * suitable for hashing.
+   * 
+   * Key properties:
+   *  - **Deterministic**: same logical value → same string every time
+   *  - **Injective-ish**: structurally different values produce different
+   *    strings (type tags prevent `"3"` vs `3` collisions)
+   *  - **Recursive**: handles nested objects, arrays, Maps, Sets
+   *  - **Function-aware**: serializes functions via `.toString()`
+   * 
+   * @param value  Anything.
+   * @returns      A deterministic string.
+   */
+  static serialize(value) {
+    if (value === null) return "<null>";
+    if (value === void 0) return "<undefined>";
+    switch (typeof value) {
+      case "string":
+        return `s:${value}`;
+      case "number":
+        return `n:${value}`;
+      case "boolean":
+        return `b:${value}`;
+      case "bigint":
+        return `bi:${value}`;
+      case "symbol":
+        return `sym:${value.toString()}`;
+      case "function":
+        return `fn:${value.toString()}`;
+    }
+    if (value instanceof Map) {
+      const entries = Array.from(value.entries()).map(([k, v]) => `${exports.A_UtilsHelper.serialize(k)}=>${exports.A_UtilsHelper.serialize(v)}`).sort().join(",");
+      return `Map{${entries}}`;
+    }
+    if (value instanceof Set) {
+      const items = Array.from(value.values()).map((v) => exports.A_UtilsHelper.serialize(v)).sort().join(",");
+      return `Set{${items}}`;
+    }
+    if (value instanceof Date) {
+      return `Date:${value.toISOString()}`;
+    }
+    if (value instanceof RegExp) {
+      return `RegExp:${value.toString()}`;
+    }
+    if (Array.isArray(value)) {
+      const items = value.map((v) => exports.A_UtilsHelper.serialize(v)).join(",");
+      return `[${items}]`;
+    }
+    if (typeof value.toJSON === "function") {
+      return `json:${exports.A_UtilsHelper.serialize(value.toJSON())}`;
+    }
+    const keys = Object.keys(value).sort();
+    const pairs = keys.map((k) => `${k}:${exports.A_UtilsHelper.serialize(value[k])}`).join(",");
+    return `{${pairs}}`;
+  }
+  // ─────────────────────────────────────────────────────────────────────────────
+  // ── FNV-1a (pure Number, no BigInt) ──────────────────────────────────────────
+  // ─────────────────────────────────────────────────────────────────────────────
+  /**
+   * FNV-1a hash using two 32-bit halves to simulate a 52-bit space,
+   * without requiring BigInt.
+   * 
+   * Works identically in:
+   *  - All browsers (including Safari 13, IE11 polyfill targets, React Native)
+   *  - Node.js (any version)
+   *  - Web Workers, Service Workers, Deno, Bun
+   * 
+   * - Better avalanche than DJB2 (each input bit affects many output bits)
+   * - ~52-bit effective space — vastly fewer collisions than 32-bit
+   * - Always produces a **positive** hex string of 13 characters
+   * 
+   * @param input  Pre-serialized string.
+   * @returns      13-character lower-hex string.
+   */
+  static fnv1a52(input) {
+    let h1 = 2166136261;
+    let h2 = 2114;
+    const PRIME = 16777619;
+    for (let i = 0; i < input.length; i++) {
+      h1 ^= input.charCodeAt(i);
+      const product = Math.imul(h1, PRIME);
+      h1 = product >>> 0;
+      h2 = (Math.imul(h2, PRIME) + (product / 4294967296 >>> 0) & 1048575) >>> 0;
+    }
+    const combined = h2 * 4294967296 + h1;
+    return combined.toString(16).padStart(13, "0");
+  }
+  hash(caller, context, feature) {
+    const hash = exports.A_UtilsHelper.hash(caller);
+    context.set(feature.name, hash);
+  }
+};
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Instance method wrapper for the static hash function, allowing it to be injected as a dependency."
+  }),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(aExecution.A_ExecutionContext)),
+  __decorateParam(2, aConcept.A_Inject(aConcept.A_Feature))
+], exports.A_UtilsHelper.prototype, "hash", 1);
+exports.A_UtilsHelper = __decorateClass([
+  aFrame.A_Frame.Component({
+    namespace: "A-Utils",
+    name: "A-UtilsHelper",
+    description: "Utility helper class providing common functions for A-Utils library, such as hashing and serialization."
+  })
+], exports.A_UtilsHelper);
+//# sourceMappingURL=A-Utils.helper.js.map
+//# sourceMappingURL=A-Utils.helper.js.map

package/dist/node/helpers/A-Utils.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/helpers/A-Utils.helper.ts"],"names":["A_UtilsHelper","A_Component","A_Frame","A_Caller","A_ExecutionContext","A_Feature"],"mappings":"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","file":"A-Utils.helper.js","sourcesContent":["import { A_Caller, A_Component, A_Feature, A_Inject } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { A_ExecutionContext } from \"@adaas/a-utils/a-execution\";\n\n\n\n@A_Frame.Component({\n    namespace: 'A-Utils',\n    name: 'A-UtilsHelper',\n    description: 'Utility helper class providing common functions for A-Utils library, such as hashing and serialization.'\n})\nexport class A_UtilsHelper extends A_Component {\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── Hashing ──────────────────────────────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Produces a deterministic, collision-resistant hash string for any JS value.\n     * \n     * Improvements over the legacy `createHash`:\n     *  - **Null-safe** — handles `null` without throwing  \n     *  - **Function-aware serialization** — functions inside objects / arrays are\n     *    serialized via `.toString()` so `{ fn: () => 1 }` ≠ `{}`  \n     *  - **FNV-1a 52-bit** — better avalanche / distribution than DJB2-32,\n     *    and uses the safe JS integer range so the result is always positive  \n     *  - **Hex output** — compact, URL-safe, fixed-width (13 chars)\n     * \n     * @param value  Any value: string, number, boolean, null, undefined,\n     *               object, array, Map, Set, function, or a mix of these.\n     * @returns      A 13-character lower-hex string (52-bit FNV-1a).\n     */\n    static hash(value?: any): string {\n        const source = A_UtilsHelper.serialize(value);\n        return A_UtilsHelper.fnv1a52(source);\n    }\n\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── Serialization ────────────────────────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Converts any JS value into a deterministic string representation\n     * suitable for hashing.\n     * \n     * Key properties:\n     *  - **Deterministic**: same logical value → same string every time\n     *  - **Injective-ish**: structurally different values produce different\n     *    strings (type tags prevent `\"3\"` vs `3` collisions)\n     *  - **Recursive**: handles nested objects, arrays, Maps, Sets\n     *  - **Function-aware**: serializes functions via `.toString()`\n     * \n     * @param value  Anything.\n     * @returns      A deterministic string.\n     */\n    static serialize(value: any): string {\n        // Primitives & null/undefined\n        if (value === null) return '<null>';\n        if (value === undefined) return '<undefined>';\n\n        switch (typeof value) {\n            case 'string':\n                return `s:${value}`;\n            case 'number':\n                return `n:${value}`;\n            case 'boolean':\n                return `b:${value}`;\n            case 'bigint':\n                return `bi:${value}`;\n            case 'symbol':\n                return `sym:${value.toString()}`;\n            case 'function':\n                return `fn:${value.toString()}`;\n        }\n\n        // Map\n        if (value instanceof Map) {\n            const entries = Array.from(value.entries())\n                .map(([k, v]) => `${A_UtilsHelper.serialize(k)}=>${A_UtilsHelper.serialize(v)}`)\n                .sort()\n                .join(',');\n            return `Map{${entries}}`;\n        }\n\n        // Set\n        if (value instanceof Set) {\n            const items = Array.from(value.values())\n                .map(v => A_UtilsHelper.serialize(v))\n                .sort()\n                .join(',');\n            return `Set{${items}}`;\n        }\n\n        // Date\n        if (value instanceof Date) {\n            return `Date:${value.toISOString()}`;\n        }\n\n        // RegExp\n        if (value instanceof RegExp) {\n            return `RegExp:${value.toString()}`;\n        }\n\n        // Array\n        if (Array.isArray(value)) {\n            const items = value.map(v => A_UtilsHelper.serialize(v)).join(',');\n            return `[${items}]`;\n        }\n\n        // toJSON support (e.g. custom entities, ASEID, etc.)\n        if (typeof value.toJSON === 'function') {\n            return `json:${A_UtilsHelper.serialize(value.toJSON())}`;\n        }\n\n        // Plain object — sort keys for determinism, serialize functions too\n        const keys = Object.keys(value).sort();\n        const pairs = keys.map(k => `${k}:${A_UtilsHelper.serialize(value[k])}`).join(',');\n        return `{${pairs}}`;\n    }\n\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── FNV-1a (pure Number, no BigInt) ──────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * FNV-1a hash using two 32-bit halves to simulate a 52-bit space,\n     * without requiring BigInt.\n     * \n     * Works identically in:\n     *  - All browsers (including Safari 13, IE11 polyfill targets, React Native)\n     *  - Node.js (any version)\n     *  - Web Workers, Service Workers, Deno, Bun\n     * \n     * - Better avalanche than DJB2 (each input bit affects many output bits)\n     * - ~52-bit effective space — vastly fewer collisions than 32-bit\n     * - Always produces a **positive** hex string of 13 characters\n     * \n     * @param input  Pre-serialized string.\n     * @returns      13-character lower-hex string.\n     */\n    private static fnv1a52(input: string): string {\n        // FNV-1a offset basis split into two 32-bit halves\n        let h1 = 0x811c9dc5;  // low 32 bits\n        let h2 = 0x00000842;  // high 20 bits (keeps us in 52-bit range)\n\n        // FNV prime = 0x01000193\n        const PRIME = 0x01000193;\n\n        for (let i = 0; i < input.length; i++) {\n            h1 ^= input.charCodeAt(i);\n\n            // Multiply h1 by prime (32-bit, unsigned)\n            const product = Math.imul(h1, PRIME);\n            h1 = product >>> 0;\n\n            // Carry overflow into h2, keep h2 within 20 bits\n            h2 = ((Math.imul(h2, PRIME) + (product / 0x100000000 >>> 0)) & 0xFFFFF) >>> 0;\n        }\n\n        // Combine: h2 (20 bits) << 32 | h1 (32 bits) → 52-bit number\n        // Since 2^52 fits in Number.MAX_SAFE_INTEGER, this is exact.\n        const combined = h2 * 0x100000000 + h1;\n\n        return combined.toString(16).padStart(13, '0');\n    }\n\n\n\n    // ==============================================================================\n    // =============== Instance methods for used for Injection ======================\n    // ==============================================================================\n    @A_Frame.Method({\n        description: 'Instance method wrapper for the static hash function, allowing it to be injected as a dependency.'\n    })\n    hash(\n        @A_Inject(A_Caller) caller: any,\n        @A_Inject(A_ExecutionContext) context: A_ExecutionContext,\n        @A_Inject(A_Feature) feature: A_Feature\n    ) {\n        const hash = A_UtilsHelper.hash(caller);\n\n        context.set(feature.name, hash);\n    }\n}"]}

package/dist/node/helpers/A-Utils.helper.mjs

@@ -0,0 +1,143 @@
+import { __decorateClass, __decorateParam } from '../chunk-EQQGB2QZ.mjs';
+import { A_Inject, A_Caller, A_Feature, A_Component } from '@adaas/a-concept';
+import { A_Frame } from '@adaas/a-frame';
+import { A_ExecutionContext } from '@adaas/a-utils/a-execution';
+
+let A_UtilsHelper = class extends A_Component {
+  // ─────────────────────────────────────────────────────────────────────────────
+  // ── Hashing ──────────────────────────────────────────────────────────────────
+  // ─────────────────────────────────────────────────────────────────────────────
+  /**
+   * Produces a deterministic, collision-resistant hash string for any JS value.
+   * 
+   * Improvements over the legacy `createHash`:
+   *  - **Null-safe** — handles `null` without throwing  
+   *  - **Function-aware serialization** — functions inside objects / arrays are
+   *    serialized via `.toString()` so `{ fn: () => 1 }` ≠ `{}`  
+   *  - **FNV-1a 52-bit** — better avalanche / distribution than DJB2-32,
+   *    and uses the safe JS integer range so the result is always positive  
+   *  - **Hex output** — compact, URL-safe, fixed-width (13 chars)
+   * 
+   * @param value  Any value: string, number, boolean, null, undefined,
+   *               object, array, Map, Set, function, or a mix of these.
+   * @returns      A 13-character lower-hex string (52-bit FNV-1a).
+   */
+  static hash(value) {
+    const source = A_UtilsHelper.serialize(value);
+    return A_UtilsHelper.fnv1a52(source);
+  }
+  // ─────────────────────────────────────────────────────────────────────────────
+  // ── Serialization ────────────────────────────────────────────────────────────
+  // ─────────────────────────────────────────────────────────────────────────────
+  /**
+   * Converts any JS value into a deterministic string representation
+   * suitable for hashing.
+   * 
+   * Key properties:
+   *  - **Deterministic**: same logical value → same string every time
+   *  - **Injective-ish**: structurally different values produce different
+   *    strings (type tags prevent `"3"` vs `3` collisions)
+   *  - **Recursive**: handles nested objects, arrays, Maps, Sets
+   *  - **Function-aware**: serializes functions via `.toString()`
+   * 
+   * @param value  Anything.
+   * @returns      A deterministic string.
+   */
+  static serialize(value) {
+    if (value === null) return "<null>";
+    if (value === void 0) return "<undefined>";
+    switch (typeof value) {
+      case "string":
+        return `s:${value}`;
+      case "number":
+        return `n:${value}`;
+      case "boolean":
+        return `b:${value}`;
+      case "bigint":
+        return `bi:${value}`;
+      case "symbol":
+        return `sym:${value.toString()}`;
+      case "function":
+        return `fn:${value.toString()}`;
+    }
+    if (value instanceof Map) {
+      const entries = Array.from(value.entries()).map(([k, v]) => `${A_UtilsHelper.serialize(k)}=>${A_UtilsHelper.serialize(v)}`).sort().join(",");
+      return `Map{${entries}}`;
+    }
+    if (value instanceof Set) {
+      const items = Array.from(value.values()).map((v) => A_UtilsHelper.serialize(v)).sort().join(",");
+      return `Set{${items}}`;
+    }
+    if (value instanceof Date) {
+      return `Date:${value.toISOString()}`;
+    }
+    if (value instanceof RegExp) {
+      return `RegExp:${value.toString()}`;
+    }
+    if (Array.isArray(value)) {
+      const items = value.map((v) => A_UtilsHelper.serialize(v)).join(",");
+      return `[${items}]`;
+    }
+    if (typeof value.toJSON === "function") {
+      return `json:${A_UtilsHelper.serialize(value.toJSON())}`;
+    }
+    const keys = Object.keys(value).sort();
+    const pairs = keys.map((k) => `${k}:${A_UtilsHelper.serialize(value[k])}`).join(",");
+    return `{${pairs}}`;
+  }
+  // ─────────────────────────────────────────────────────────────────────────────
+  // ── FNV-1a (pure Number, no BigInt) ──────────────────────────────────────────
+  // ─────────────────────────────────────────────────────────────────────────────
+  /**
+   * FNV-1a hash using two 32-bit halves to simulate a 52-bit space,
+   * without requiring BigInt.
+   * 
+   * Works identically in:
+   *  - All browsers (including Safari 13, IE11 polyfill targets, React Native)
+   *  - Node.js (any version)
+   *  - Web Workers, Service Workers, Deno, Bun
+   * 
+   * - Better avalanche than DJB2 (each input bit affects many output bits)
+   * - ~52-bit effective space — vastly fewer collisions than 32-bit
+   * - Always produces a **positive** hex string of 13 characters
+   * 
+   * @param input  Pre-serialized string.
+   * @returns      13-character lower-hex string.
+   */
+  static fnv1a52(input) {
+    let h1 = 2166136261;
+    let h2 = 2114;
+    const PRIME = 16777619;
+    for (let i = 0; i < input.length; i++) {
+      h1 ^= input.charCodeAt(i);
+      const product = Math.imul(h1, PRIME);
+      h1 = product >>> 0;
+      h2 = (Math.imul(h2, PRIME) + (product / 4294967296 >>> 0) & 1048575) >>> 0;
+    }
+    const combined = h2 * 4294967296 + h1;
+    return combined.toString(16).padStart(13, "0");
+  }
+  hash(caller, context, feature) {
+    const hash = A_UtilsHelper.hash(caller);
+    context.set(feature.name, hash);
+  }
+};
+__decorateClass([
+  A_Frame.Method({
+    description: "Instance method wrapper for the static hash function, allowing it to be injected as a dependency."
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_ExecutionContext)),
+  __decorateParam(2, A_Inject(A_Feature))
+], A_UtilsHelper.prototype, "hash", 1);
+A_UtilsHelper = __decorateClass([
+  A_Frame.Component({
+    namespace: "A-Utils",
+    name: "A-UtilsHelper",
+    description: "Utility helper class providing common functions for A-Utils library, such as hashing and serialization."
+  })
+], A_UtilsHelper);
+
+export { A_UtilsHelper };
+//# sourceMappingURL=A-Utils.helper.mjs.map
+//# sourceMappingURL=A-Utils.helper.mjs.map