@plyaz/core 1.0.3 → 1.1.0

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { CACHE_MAX_SIZE_DEFAULT, CACHE_CLEANUP_INTERVAL_DEFAULT, FILE_CHECK_INTERVAL_DEFAULT, FEATURE_FLAG_FILE_PATHS, FEATURE_FLAG_CACHE_TTL_DEFAULT, FEATURES } from '@plyaz/config';
+import { CACHE_MAX_SIZE_DEFAULT, CACHE_CLEANUP_INTERVAL_DEFAULT, TIME_CONSTANTS, FORMAT_CONSTANTS, FILE_CHECK_INTERVAL_DEFAULT, FEATURE_FLAG_FILE_PATHS, FEATURE_FLAG_CACHE_TTL_DEFAULT, MATH_CONSTANTS, ISO_STANDARDS, FEATURES, FNV_CONSTANTS, HASH_SEED_CONSTANTS } from '@plyaz/config';
 import * as fs from 'fs';
 import * as path from 'path';
 import { promisify } from 'util';
@@ -23,24 +23,21 @@ var __decorateClass = (decorators, target, key, kind) => {
 };
 var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
 var __publicField = (obj, key, value) => __defNormalProp(obj, key + "" , value);
-
-// src/utils/common/hash.ts
 function hashString(str) {
-  const HASH_SHIFT = 5;
-  let hash = 0;
+  if (str.length === 0) return 0;
+  let hash = FNV_CONSTANTS.FNV_32_OFFSET;
   for (let i = 0; i < str.length; i++) {
-    const char = str.charCodeAt(i);
-    hash = (hash << HASH_SHIFT) - hash + char;
-    hash = hash & hash;
+    hash ^= str.charCodeAt(i);
+    hash = Math.imul(hash, FNV_CONSTANTS.FNV_32_PRIME) >>> 0;
   }
-  return Math.abs(hash);
+  return hash >>> 0;
 }
 __name(hashString, "hashString");
 function isInRollout(identifier, percentage) {
-  if (percentage >= 100) return true;
+  if (percentage >= MATH_CONSTANTS.PERCENTAGE_MAX) return true;
   if (percentage <= 0) return false;
   const hash = hashString(identifier);
-  return hash % 100 < percentage;
+  return hash % MATH_CONSTANTS.PERCENTAGE_MAX < percentage;
 }
 __name(isInRollout, "isInRollout");
 function createRolloutIdentifier(featureKey, userId) {
@@ -69,23 +66,22 @@ var HashUtils = {
    * @param totalBuckets - Total number of buckets (default: 100)
    * @returns true if identifier is in the bucket range
    */
-  isInBucketRange: /* @__PURE__ */ __name((identifier, startBucket, endBucket, totalBuckets = 100) => {
+  isInBucketRange: /* @__PURE__ */ __name((identifier, startBucket, endBucket, totalBuckets = MATH_CONSTANTS.PERCENTAGE_MAX) => {
     const bucket = hashString(identifier) % totalBuckets;
     return bucket >= startBucket && bucket <= endBucket;
   }, "isInBucketRange"),
   /**
    * 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)
    */
   createSeed: /* @__PURE__ */ __name((str) => {
-    const SAFE_INT = 2147483647;
-    return hashString(str) % SAFE_INT;
+    return hashString(str) % HASH_SEED_CONSTANTS.MAX_SAFE_SEED;
   }, "createSeed")
 };
-
-// src/utils/common/values.ts
 function isStringFalsy(value) {
   if (value === "") return true;
   const lower = value.toLowerCase().trim();
@@ -151,7 +147,7 @@ var ValueUtils = {
    */
   isValidPercentage: /* @__PURE__ */ __name((value) => {
     if (typeof value !== "number") return false;
-    return !isNaN(value) && isFinite(value) && value >= 0 && value <= 100;
+    return !isNaN(value) && isFinite(value) && value >= 0 && value <= MATH_CONSTANTS.PERCENTAGE_MAX;
   }, "isValidPercentage"),
   /**
    * Clamps a number to a specific range.
@@ -197,8 +193,6 @@ var ValueUtils = {
     return current;
   }, "getNestedProperty")
 };
-
-// src/utils/featureFlags/context.ts
 var FeatureFlagContextBuilder = class _FeatureFlagContextBuilder {
   static {
     __name(this, "FeatureFlagContextBuilder");
@@ -394,7 +388,7 @@ var ContextUtils = {
     if (context.platform && !["web", "mobile", "desktop"].includes(context.platform)) {
       errors.push("Platform must be web, mobile, or desktop");
     }
-    if (context.country && context.country.length !== 2) {
+    if (context.country && context.country.length !== ISO_STANDARDS.ISO_COUNTRY_CODE_LENGTH) {
       errors.push("Country must be a 2-letter ISO country code");
     }
     return {
@@ -1113,6 +1107,9 @@ var MemoryCacheStrategy = class {
     this.cleanupTimer = setInterval(() => {
       this.cleanupExpiredEntries();
     }, this.cleanupInterval);
+    if (this.cleanupTimer && typeof this.cleanupTimer.unref === "function") {
+      this.cleanupTimer.unref();
+    }
   }
   /**
    * Removes expired entries from the cache.
@@ -1161,8 +1158,6 @@ var MemoryCacheStrategy = class {
     }
   }
 };
-
-// src/base/cache/strategies/redis.ts
 var RedisCacheStrategy = class {
   /**
    * Creates a new Redis cache strategy.
@@ -1200,7 +1195,7 @@ var RedisCacheStrategy = class {
     const redisKey = this.buildRedisKey(key);
     const serializedEntry = JSON.stringify(entry);
     const ttlMs = entry.expiresAt - Date.now();
-    const ttlSeconds = Math.max(1, Math.ceil(ttlMs / 1e3));
+    const ttlSeconds = Math.max(1, Math.ceil(ttlMs / TIME_CONSTANTS.MILLISECONDS_PER_SECOND));
     await this.client.set(redisKey, serializedEntry, "EX", ttlSeconds);
     this.stats.setCount++;
   }
@@ -1371,7 +1366,7 @@ var CacheManager = class {
     const finalTtl = ttl ?? this.config.ttl;
     const entry = {
       data: value,
-      expiresAt: Date.now() + finalTtl * 1e3,
+      expiresAt: Date.now() + finalTtl * TIME_CONSTANTS.MILLISECONDS_PER_SECOND,
       createdAt: Date.now()
     };
     await this.strategy.set(key, entry);
@@ -1464,8 +1459,6 @@ var CacheManager = class {
     await this.strategy.dispose?.();
   }
 };
-
-// src/domain/featureFlags/provider.ts
 var FeatureFlagProvider = class {
   /**
    * Creates a new feature flag provider.
@@ -1700,7 +1693,7 @@ var FeatureFlagProvider = class {
         void this.refresh().catch((error) => {
           this.log("Auto-refresh failed:", error);
         });
-      }, this.config.refreshInterval * 1e3);
+      }, this.config.refreshInterval * TIME_CONSTANTS.MILLISECONDS_PER_SECOND);
     }
   }
   /**
@@ -2344,7 +2337,7 @@ var FileFeatureFlagProvider = class extends FeatureFlagProvider {
     };
     let content;
     if (format === "json") {
-      content = JSON.stringify(defaultData, null, 2);
+      content = JSON.stringify(defaultData, null, FORMAT_CONSTANTS.JSON_INDENT_SPACES);
     } else {
       content = yaml.stringify(defaultData);
     }
@@ -2452,7 +2445,7 @@ var FileFeatureFlagProvider = class extends FeatureFlagProvider {
     try {
       let content;
       if (format === "json") {
-        content = JSON.stringify(fileData, null, 2);
+        content = JSON.stringify(fileData, null, FORMAT_CONSTANTS.JSON_INDENT_SPACES);
       } else {
         content = yaml.stringify(fileData);
       }
@@ -3990,7 +3983,7 @@ function useFeatureFlagProviderStatus() {
     isInitialized: context.isInitialized,
     isLoading: context.isLoading,
     error: context.error,
-    lastUpdated: context.lastUpdated
+    lastUpdated: context.lastUpdated ? new Date(context.lastUpdated) : void 0
   };
 }
 __name(useFeatureFlagProviderStatus, "useFeatureFlagProviderStatus");