@naturalcycles/nodejs-lib 15.128.0 → 15.129.1

package/dist/cache/lruMemoCache.d.ts

@@ -1,4 +1,5 @@
-import type { MemoCache } from '@naturalcycles/js-lib/decorators';
+import type { AsyncMemoCache, MemoCache } from '@naturalcycles/js-lib/decorators';
+import { MISS } from '@naturalcycles/js-lib/types';
 import { LRUCache } from 'lru-cache';
 export type LRUMemoCacheOptions<KEY, VALUE> = Partial<LRUCache.Options<KEY, VALUE, any>>;
 /**
@@ -16,3 +17,14 @@ export declare class LRUMemoCache<KEY = any, VALUE = any> implements MemoCache<K
     set(k: any, v: any): void;
     clear(): void;
 }
+/**
+ * Same as LRUMemoCache, but implements AsyncMemoCache interface, for when you need it.
+ */
+export declare class LRUAsyncMemoCache<KEY = any, VALUE = any> implements AsyncMemoCache<KEY, VALUE> {
+    constructor(opt: LRUMemoCacheOptions<KEY, VALUE>);
+    private lru;
+    has(k: any): Promise<boolean>;
+    get(k: any): Promise<VALUE | typeof MISS>;
+    set(k: any, v: any): Promise<void>;
+    clear(): Promise<void>;
+}

package/dist/cache/lruMemoCache.js

@@ -1,3 +1,4 @@
+import { MISS } from '@naturalcycles/js-lib/types';
 import { LRUCache } from 'lru-cache';
 /**
  * @example
@@ -27,3 +28,32 @@ export class LRUMemoCache {
         this.lru.clear();
     }
 }
+// lru-cache never stores `undefined` (`set(k, undefined)` deletes `k`), so it's stored as this sentinel
+const UNDEFINED = Symbol('undefined');
+/**
+ * Same as LRUMemoCache, but implements AsyncMemoCache interface, for when you need it.
+ */
+export class LRUAsyncMemoCache {
+    constructor(opt) {
+        this.lru = new LRUCache({
+            max: 100,
+            ...opt,
+        });
+    }
+    lru;
+    async has(k) {
+        return this.lru.has(k);
+    }
+    async get(k) {
+        const v = this.lru.get(k);
+        if (v === undefined)
+            return MISS;
+        return v === UNDEFINED ? undefined : v;
+    }
+    async set(k, v) {
+        this.lru.set(k, v === undefined ? UNDEFINED : v);
+    }
+    async clear() {
+        this.lru.clear();
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/nodejs-lib",
   "type": "module",
-  "version": "15.128.0",
+  "version": "15.129.1",
   "dependencies": {
     "@naturalcycles/js-lib": "^15",
     "@standard-schema/spec": "^1",

package/src/cache/lruMemoCache.ts

@@ -1,4 +1,5 @@
-import type { MemoCache } from '@naturalcycles/js-lib/decorators'
+import type { AsyncMemoCache, MemoCache } from '@naturalcycles/js-lib/decorators'
+import { MISS } from '@naturalcycles/js-lib/types'
 import { LRUCache } from 'lru-cache'
 
 // Partial, to be able to provide default `max`
@@ -37,3 +38,38 @@ export class LRUMemoCache<KEY = any, VALUE = any> implements MemoCache<KEY, VALU
     this.lru.clear()
   }
 }
+
+// lru-cache never stores `undefined` (`set(k, undefined)` deletes `k`), so it's stored as this sentinel
+const UNDEFINED = Symbol('undefined')
+
+/**
+ * Same as LRUMemoCache, but implements AsyncMemoCache interface, for when you need it.
+ */
+export class LRUAsyncMemoCache<KEY = any, VALUE = any> implements AsyncMemoCache<KEY, VALUE> {
+  constructor(opt: LRUMemoCacheOptions<KEY, VALUE>) {
+    this.lru = new LRUCache<any, any>({
+      max: 100,
+      ...opt,
+    })
+  }
+
+  private lru!: LRUCache<any, any>
+
+  async has(k: any): Promise<boolean> {
+    return this.lru.has(k)
+  }
+
+  async get(k: any): Promise<VALUE | typeof MISS> {
+    const v = this.lru.get(k)
+    if (v === undefined) return MISS
+    return v === UNDEFINED ? (undefined as VALUE) : v
+  }
+
+  async set(k: any, v: any): Promise<void> {
+    this.lru.set(k, v === undefined ? UNDEFINED : v)
+  }
+
+  async clear(): Promise<void> {
+    this.lru.clear()
+  }
+}