@resolid/cache 1.1.0 → 1.2.0

package/README.md

@@ -12,7 +12,7 @@ Designed for libraries, frameworks, and applications needing predictable async c
 ## Feature
 
 - Fully typed with TypeScript — no `any`.
-- Supports get/set/del/clear operations.
+- Supports get/getOrSet/set/del/clear operations.
 - Supports batch operations: getMultiple, setMultiple, delMultiple.
 - Optional TTL for automatic expiration.
 - Pluggable store backend (default is `nullCache`).
@@ -42,6 +42,9 @@ const cache = new Cacher({ defaultTtl: 1000 });
 await cache.set("foo", { a: 1 });
 const value = await cache.get("foo"); // -> { a: 1 }
 
+// Get or set with factory
+const user = await cache.getOrSet("user:1", () => fetchUser(1), 60);
+
 // Check existence
 const exists = await cache.has("foo"); // -> true
 

package/dist/index.d.mts

@@ -21,6 +21,7 @@ declare class Cacher {
   }?: CacheOptions);
   get<T>(key: string, defaultValue?: T): Promise<T | undefined>;
   set<T>(key: string, value: T, ttl?: number): Promise<boolean>;
+  getOrSet<T>(key: string, factory: () => T | Promise<T>, ttl?: number): Promise<T>;
   del(key: string): Promise<boolean>;
   clear(): Promise<boolean>;
   getMultiple<T>(keys: string[], defaultValue?: T): Promise<(T | undefined)[]>;

package/dist/index.mjs

@@ -1 +1 @@
-import{t as e}from"./null-cache-DGPituGm.mjs";function t(e){let t=e.split(`?`)[0]?.replace(/[/\\]/g,`:`).replace(/:+/g,`:`).replace(/^:|:$/g,``);if(!t)throw Error(`Cache key cannot be empty after normalization`);return t}var n=class{_store;_serializer;_defaultTtl;constructor({store:t=new e,serializer:n={serialize:JSON.stringify,deserialize:JSON.parse},defaultTtl:r}={}){this._store=t,this._serializer=n,this._defaultTtl=r}async get(e,n){let r=await this._store.get(t(e));return r===void 0?n:this._serializer.deserialize(r)}set(e,n,r){return this._store.set(t(e),this._serializer.serialize(n),r??this._defaultTtl)}del(e){return this._store.del(t(e))}clear(){return this._store.clear()}async getMultiple(e,n){return this._store.getMultiple?(await this._store.getMultiple(e.map(t))).map(e=>e===void 0?n:this._serializer.deserialize(e)):Promise.all(e.map(e=>this.get(e,n)))}async setMultiple(e,n){return this._store.setMultiple?this._store.setMultiple(Object.entries(e).reduce((e,[n,r])=>(e[t(n)]=this._serializer.serialize(r),e),{}),n):(await Promise.all(Object.entries(e).map(([e,t])=>this.set(e,t,n)))).every(Boolean)}async delMultiple(e){return this._store.delMultiple?this._store.delMultiple(e.map(t)):(await Promise.all(e.map(e=>this.del(e)))).every(Boolean)}async has(e){return this._store.has?this._store.has(t(e)):await this.get(e)!==void 0}async dispose(){await this._store.dispose?.()}};export{n as Cacher};
+import{t as e}from"./null-cache-DGPituGm.mjs";function t(e){let t=e.split(`?`)[0]?.replace(/[/\\]/g,`:`).replace(/:+/g,`:`).replace(/^:|:$/g,``);if(!t)throw Error(`Cache key cannot be empty after normalization`);return t}var n=class{_store;_serializer;_defaultTtl;constructor({store:t=new e,serializer:n={serialize:JSON.stringify,deserialize:JSON.parse},defaultTtl:r}={}){this._store=t,this._serializer=n,this._defaultTtl=r}async get(e,n){let r=await this._store.get(t(e));return r===void 0?n:this._serializer.deserialize(r)}set(e,n,r){return this._store.set(t(e),this._serializer.serialize(n),r??this._defaultTtl)}async getOrSet(e,t,n){let r=await this.get(e);if(r!==void 0)return r;let i=await t();return await this.set(e,i,n),i}del(e){return this._store.del(t(e))}clear(){return this._store.clear()}async getMultiple(e,n){return this._store.getMultiple?(await this._store.getMultiple(e.map(t))).map(e=>e===void 0?n:this._serializer.deserialize(e)):Promise.all(e.map(e=>this.get(e,n)))}async setMultiple(e,n){return this._store.setMultiple?this._store.setMultiple(Object.entries(e).reduce((e,[n,r])=>(e[t(n)]=this._serializer.serialize(r),e),{}),n):(await Promise.all(Object.entries(e).map(([e,t])=>this.set(e,t,n)))).every(Boolean)}async delMultiple(e){return this._store.delMultiple?this._store.delMultiple(e.map(t)):(await Promise.all(e.map(e=>this.del(e)))).every(Boolean)}async has(e){return this._store.has?this._store.has(t(e)):await this.get(e)!==void 0}async dispose(){await this._store.dispose?.()}};export{n as Cacher};

package/dist/stores.d.mts

@@ -24,4 +24,4 @@ declare class NullCache implements Required<CacheStore> {
   dispose(): Promise<void>;
 }
 //#endregion
-export { CacheStore, MemoryCache, NullCache };
+export { type CacheStore, MemoryCache, NullCache };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@resolid/cache",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "private": false,
   "description": "Type-safe Async Cache for TypeScript",
   "keywords": [