@plyaz/core 1.0.4 → 1.1.0

package/dist/utils/common/hash.d.ts

@@ -7,8 +7,10 @@
  * @version 1.0.0
  */
 /**
- * Simple string hashing function for consistent distribution.
- * Uses a basic polynomial rolling hash for good distribution.
+ * Optimized string hashing function for consistent distribution.
+ * Uses FNV-1a hash algorithm for better distribution and performance.
+ * FNV-1a provides excellent avalanche properties and is faster than
+ * polynomial rolling hash for short to medium strings.
  *
  * @param str - String to hash
  * @returns Positive hash value
@@ -18,6 +20,13 @@
  * const hash = hashString('user123:AUTH_GOOGLE');
  * const bucket = hash % 100; // 0-99
  * ```
+ *
+ * @remarks
+ * FNV-1a algorithm benefits:
+ * - Excellent distribution for hash tables
+ * - Fast computation with minimal operations
+ * - Good avalanche effect (small input changes create large output changes)
+ * - Consistent timing reduces timing attack vulnerabilities
  */
 export declare function hashString(str: string): number;
 /**
@@ -72,9 +81,11 @@ export declare const HashUtils: {
     readonly isInBucketRange: (identifier: string, startBucket: number, endBucket: number, totalBuckets?: number) => boolean;
     /**
      * Creates a deterministic random seed from a string.
+     * Uses the improved hash function and ensures the seed is within
+     * the safe range for JavaScript's Math.random seeding.
      *
      * @param str - String to convert to seed
-     * @returns Deterministic seed value
+     * @returns Deterministic seed value (0 to 2^31-1)
      */
     readonly createSeed: (str: string) => number;
 };

package/dist/utils/common/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/utils/common/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAM3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAInF;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB;;;;;;OAMG;qCACqB,MAAM,gBAAe,MAAM,KAAQ,MAAM;IAIjE;;;;;;;;OAQG;2CAEW,MAAM,eACL,MAAM,aACR,MAAM,iBACH,MAAM,KACnB,OAAO;IAKV;;;;;OAKG;+BACe,MAAM,KAAG,MAAM;CAIzB,CAAC"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/utils/common/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmB9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAM3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAInF;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB;;;;;;OAMG;qCACqB,MAAM,gBAAe,MAAM,KAAQ,MAAM;IAIjE;;;;;;;;OAQG;2CAEW,MAAM,eACL,MAAM,aACR,MAAM,iBACH,MAAM,KACnB,OAAO;IAKV;;;;;;;OAOG;+BACe,MAAM,KAAG,MAAM;CAIzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/core",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "Shared core logic and utilities for Plyaz apps, services, and future SDKs – centralized, reusable, and scalable.",
   "type": "module",
   "keywords": [],
@@ -28,10 +28,10 @@
   ],
   "dependencies": {
     "@nestjs/common": "^11.1.3",
-    "@plyaz/config": "^1.3.0",
+    "@plyaz/config": "1.3.3",
     "@plyaz/translations": "^1.0.2",
     "ioredis": "^5.6.1",
-    "next": "15.3.3",
+    "next": "15.4.7",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "viem": "^2.31.7",
@@ -45,8 +45,8 @@
     "@eslint/markdown": "^6.5.0",
     "@next/eslint-plugin-next": "^15.0.3",
     "@plyaz/devtools": "^1.8.0",
-    "@plyaz/testing": "^1.3.1",
-    "@plyaz/types": "^1.3.8",
+    "@plyaz/testing": "^1.4.2",
+    "@plyaz/types": "^1.7.7",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.1",