@boredland/node-ts-cache 5.1.0 → 6.0.0

package/README.md

@@ -18,9 +18,10 @@ _Note: The underlying storage layer must be installed separately._
 
 | Storage                                                               | Install                                         |
 |-----------------------------------------------------------------------|-------------------------------------------------|
-| [memory](https://www.npmjs.com/package/boredland/node-ts-cache-storage-memory)| ```yarn add @boredland/node-ts-cache-storage-memory```|
-| [node-fs](https://www.npmjs.com/package/boredland/node-ts-cache-storage-node-fs)| ```yarn add @boredland/node-ts-cache-storage-node-fs```|
-| [ioredis](https://www.npmjs.com/package/boredland/node-ts-cache-storage-ioredis)| ```yarn add @boredland/node-ts-cache-storage-ioredis```|
+| [memory](https://www.npmjs.com/package/@boredland/node-ts-cache-storage-memory)| ```yarn add @boredland/node-ts-cache-storage-memory```|
+| [node-fs](https://www.npmjs.com/package/@boredland/node-ts-cache-storage-node-fs)| ```yarn add @boredland/node-ts-cache-storage-node-fs```|
+| [ioredis](https://www.npmjs.com/package/@boredland/node-ts-cache-storage-ioredis)| ```yarn add @boredland/node-ts-cache-storage-ioredis```|
+| [postgres](https://www.npmjs.com/package/@boredland/node-ts-cache-storage-pg)| ```yarn add @boredland/node-ts-cache-storage-pg```|
 
 ## Usage
 
@@ -71,7 +72,7 @@ const myCache = new CacheContainer(new MemoryStorage())
 
 class MyService {
     public async getUsers(): Promise<string[]> {
-        const cachedUsers = await myCache.getItem<string[]>("users")
+        const { content: cachedUsers } = await myCache.getItem<string[]>("users")
 
         if (cachedUsers) {
             return cachedUsers

package/dist/cache-container/cache-container-types.d.ts

@@ -2,7 +2,7 @@ export declare type CachedItem<T = any> = {
     content: T;
     meta: {
         createdAt: number;
-        ttl: number;
+        ttl: number | null;
         isLazy: boolean;
     };
 };

package/dist/cache-container/cache-container.d.ts

@@ -1,8 +1,8 @@
-import type { IStorage } from "../storage";
+import type { Storage } from "../storage";
 import type { CachingOptions } from "./cache-container-types";
 export declare class CacheContainer {
     private storage;
-    constructor(storage: IStorage);
+    constructor(storage: Storage);
     getItem<T>(key: string): Promise<{
         content: T;
         meta: {
@@ -10,8 +10,8 @@ export declare class CacheContainer {
             createdAt: number;
         };
     } | undefined>;
-    setItem(key: string, content: any, options: Partial<CachingOptions>): Promise<void>;
+    setItem(key: string, content: unknown, options?: Partial<CachingOptions>): Promise<void>;
     clear(): Promise<void>;
     private isItemExpired;
-    private unsetKey;
+    unsetKey(key: string): Promise<void>;
 }

package/dist/cache-container/cache-container.js

@@ -20,8 +20,8 @@ class CacheContainer {
             content: item.content,
             meta: {
                 createdAt: item.meta.createdAt,
-                expired: this.isItemExpired(item)
-            }
+                expired: this.isItemExpired(item),
+            },
         };
         if (result.meta.expired)
             await this.unsetKey(key);
@@ -34,12 +34,12 @@ class CacheContainer {
             ttl: DEFAULT_TTL_SECONDS,
             isLazy: true,
             isCachedForever: false,
-            ...options
+            ...options,
         };
         const meta = {
             createdAt: Date.now(),
             isLazy: finalOptions.isLazy,
-            ttl: finalOptions.isCachedForever ? Infinity : finalOptions.ttl * 1000
+            ttl: finalOptions.isCachedForever ? null : finalOptions.ttl * 1000,
         };
         await this.storage.setItem(key, { meta, content });
     }
@@ -48,12 +48,12 @@ class CacheContainer {
         debug("Cleared cache");
     }
     isItemExpired(item) {
-        if (item.meta.ttl === Infinity)
+        if (item.meta.ttl === null)
             return false;
         return Date.now() > item.meta.createdAt + item.meta.ttl;
     }
     async unsetKey(key) {
-        await this.storage.setItem(key, undefined);
+        await this.storage.removeItem(key);
     }
 }
 exports.CacheContainer = CacheContainer;

package/dist/decorator/cache-decorator.js

@@ -10,7 +10,9 @@ const jsonCalculateKey = (data) => {
     return `${data.className}:${data.methodName}:${JSON.stringify(data.args)}`;
 };
 function Cache(container, options) {
-    return function (target, methodName, descriptor) {
+    return function (target, methodName, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    descriptor) {
         const originalMethod = descriptor.value;
         const className = target.constructor.name;
         descriptor.value = async function (...args) {
@@ -18,21 +20,14 @@ function Cache(container, options) {
             const keyOptions = {
                 args,
                 methodName: methodName,
-                className
+                className,
             };
             const cacheKey = options.calculateKey
                 ? options.calculateKey(keyOptions)
                 : jsonCalculateKey(keyOptions);
-            const runOriginalMethod = async () => {
+            const runOriginalMethod = () => {
                 const methodCall = originalMethod.apply(this, args);
-                const isAsync = methodCall?.constructor?.name === "AsyncFunction" ||
-                    methodCall?.constructor?.name === "Promise";
-                if (isAsync) {
-                    return await methodCall;
-                }
-                else {
-                    return methodCall;
-                }
+                return methodCall;
             };
             if (!target.__node_ts_cache_method_run_queue) {
                 target.__node_ts_cache_method_run_queue = {};
@@ -54,8 +49,8 @@ function Cache(container, options) {
                     return methodResult;
                 }
                 finally {
-                    target.__node_ts_cache_method_run_queue[cacheKey] =
-                        undefined;
+                    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                    target.__node_ts_cache_method_run_queue[cacheKey] = undefined;
                 }
             })();
             return target.__node_ts_cache_method_run_queue[cacheKey];

package/dist/storage/storage-types.d.ts

@@ -1,6 +1,7 @@
 import type { CachedItem } from "../cache-container";
-export interface IStorage {
+export interface Storage {
     getItem(key: string): Promise<CachedItem | undefined>;
-    setItem(key: string, content: CachedItem | undefined): Promise<void>;
+    setItem(key: string, content: CachedItem): Promise<void>;
+    removeItem(key: string): Promise<void>;
     clear(): Promise<void>;
 }

package/dist/withCache.d.ts

@@ -1,5 +1,5 @@
 import type { CacheContainer, CachingOptions } from "./cache-container";
-declare type WithCacheOptions<Parameters> = Partial<Omit<CachingOptions, 'calculateKey'>> & {
+declare type WithCacheOptions<Parameters> = Partial<Omit<CachingOptions, "calculateKey">> & {
     /** an optional prefix to prepend to the key */
     prefix?: string;
     /** an optional function to calculate a key based on the parameters of the wrapped function */

package/dist/withCache.js

@@ -15,8 +15,8 @@ const withCacheFactory = (container) => {
      */
     const withCache = (operation, options = {}) => {
         return async (...parameters) => {
-            let { prefix, calculateKey, ...rest } = options;
-            prefix = prefix ?? 'default';
+            const { calculateKey, ...rest } = options;
+            const prefix = options.prefix ?? "default";
             const key = `${operation.name}:${prefix}:${calculateKey ? calculateKey(parameters) : JSON.stringify(parameters)}`;
             const cachedResponse = await container.getItem(key);
             if (cachedResponse) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@boredland/node-ts-cache",
   "description": "Simple and extensible caching module supporting decorators",
-  "version": "5.1.0",
+  "version": "6.0.0",
   "private": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",