@nxtedition/cache 2.1.5 → 2.1.7

package/lib/index.d.ts

@@ -7,6 +7,7 @@ export interface DatabaseOptions {
 }
 export interface LockOptions {
     minTimeout?: number;
+    maxTimeout?: number;
 }
 export interface Serializer<V> {
     serialize: (value: V) => Buffer | Uint8Array | string;

package/lib/index.js

@@ -39,6 +39,7 @@ const dbs = new Set                 ()
  
 
                               
+                     
                      
  
 
@@ -96,6 +97,7 @@ export class Cache                                              extends EventEmi
   #lockMean         = 5
   #lockTimeout         = 10
   #lockMinTimeout         = 1
+  #lockMaxTimeout         = 1_000
 
   #location        
   #database                      = null
@@ -176,6 +178,12 @@ export class Cache                                              extends EventEmi
         this.#lockTimeout = this.#lockMinTimeout
         this.#lockMean = this.#lockTimeout / 1.2
       }
+      if (opts.lock.maxTimeout !== undefined) {
+        if (typeof opts.lock.maxTimeout !== 'number') {
+          throw new TypeError('lock.maxTimeout must be a number')
+        }
+        this.#lockMaxTimeout = Math.max(this.#lockMinTimeout, opts.lock.maxTimeout)
+      }
     }
 
     if (opts?.serializer !== undefined) {
@@ -196,7 +204,7 @@ export class Cache                                              extends EventEmi
 
     for (let n = 0; opts?.database !== null && opts?.database !== false; n++) {
       try {
-        const maxSize = opts?.database?.maxSize ?? 256 * 1024 * 1024
+        const maxSize = opts?.database?.maxSize ?? 128 * 1024 * 1024
         const timeout = opts?.database?.timeout ?? 20
 
         this.#database ??= new DatabaseSync(location, { timeout })
@@ -709,13 +717,22 @@ export class Cache                                              extends EventEmi
     // EMA of mean and variance (Welford-style), clamped to [10ms, 1s].
     // Timeout = mean * 1.2 + 3 * stddev: 20% base margin plus 3 standard
     // deviations to accommodate timing variability.
+    // Winsorize input at mean + 5σ so a single extreme outlier can't blow up the stats.
     const alpha = 0.2
-    const diff = duration - this.#lockMean
+    const clamped = Math.min(
+      duration,
+      this.#lockMean + 5 * Math.sqrt(this.#lockVar),
+      this.#lockMaxTimeout,
+    )
+    const diff = clamped - this.#lockMean
     this.#lockMean += alpha * diff
     this.#lockVar = (1 - alpha) * (this.#lockVar + alpha * diff * diff)
     this.#lockTimeout = Math.max(
       this.#lockMinTimeout,
-      Math.min(1_000, Math.ceil(this.#lockMean * 1.2 + Math.sqrt(this.#lockVar) * 3)),
+      Math.min(
+        this.#lockMaxTimeout,
+        Math.ceil(this.#lockMean * 1.2 + Math.sqrt(this.#lockVar) * 3),
+      ),
     )
   }
 

package/lib/memory.js

@@ -13,7 +13,10 @@
                  
  
 
-const maxInt = 2147483647
+let fastNow = Date.now()
+setInterval(() => {
+  fastNow = Date.now()
+}, 1e3).unref()
 
 export class MemoryCache    {
   #map                                   = new Map()
@@ -25,7 +28,6 @@ export class MemoryCache    {
   #size = 0
   #count = 0
 
-  #counter = 0
   #cork = 0
 
   constructor(opts                ) {
@@ -42,8 +44,6 @@ export class MemoryCache    {
   }
 
   set(key        , entry                     ) {
-    this.#counter = (this.#counter + 1) & maxInt
-
     const existing = this.#map.get(key)
     if (existing != null) {
       this.#delete(existing)
@@ -52,7 +52,7 @@ export class MemoryCache    {
     this.#map.set(key, entry)
     entry.key = key
     entry.index = this.#arr.push(entry) - 1
-    entry.counter = this.#counter
+    entry.counter = fastNow
 
     this.#size += entry.size ?? 0
     this.#count += 1
@@ -76,8 +76,7 @@ export class MemoryCache    {
   get(key        ) {
     const entry = this.#map.get(key)
     if (entry != null) {
-      this.#counter = (this.#counter + 1) & maxInt
-      entry.counter = this.#counter
+      entry.counter = fastNow
     }
     return entry
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxtedition/cache",
-  "version": "2.1.5",
+  "version": "2.1.7",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -30,5 +30,5 @@
     "tsd": "^0.33.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "8a59edc35cba6e3bdf43e82710a7cdbf413dc19c"
+  "gitHead": "160284d139399d39195532624e26d564aa8c8003"
 }