@twin.org/core 0.0.1-next.49 → 0.0.1-next.50

package/dist/cjs/index.cjs

@@ -3975,6 +3975,19 @@ class AsyncCache {
     static async get(key) {
         return AsyncCache._cache[key]?.response;
     }
+    /**
+     * Set an entry into the cache.
+     * @param key The key to set in the cache.
+     * @param value The value to set in the cache.
+     * @param ttlMs The TTL of the entry in the cache in ms, defaults to 1s.
+     * @returns Nothing.
+     */
+    static async set(key, value, ttlMs) {
+        AsyncCache._cache[key] = {
+            response: Promise.resolve(value),
+            expires: ttlMs === 0 ? 0 : Date.now() + (ttlMs ?? 1000)
+        };
+    }
     /**
      * Remove an entry from the cache.
      * @param key The key to remove from the cache.

package/dist/esm/index.mjs

@@ -3973,6 +3973,19 @@ class AsyncCache {
     static async get(key) {
         return AsyncCache._cache[key]?.response;
     }
+    /**
+     * Set an entry into the cache.
+     * @param key The key to set in the cache.
+     * @param value The value to set in the cache.
+     * @param ttlMs The TTL of the entry in the cache in ms, defaults to 1s.
+     * @returns Nothing.
+     */
+    static async set(key, value, ttlMs) {
+        AsyncCache._cache[key] = {
+            response: Promise.resolve(value),
+            expires: ttlMs === 0 ? 0 : Date.now() + (ttlMs ?? 1000)
+        };
+    }
     /**
      * Remove an entry from the cache.
      * @param key The key to remove from the cache.

package/dist/types/utils/asyncCache.d.ts

@@ -16,6 +16,14 @@ export declare class AsyncCache {
      * @returns The item from the cache if it exists.
      */
     static get<T = unknown>(key: string): Promise<T | undefined>;
+    /**
+     * Set an entry into the cache.
+     * @param key The key to set in the cache.
+     * @param value The value to set in the cache.
+     * @param ttlMs The TTL of the entry in the cache in ms, defaults to 1s.
+     * @returns Nothing.
+     */
+    static set<T = unknown>(key: string, value: T, ttlMs?: number): Promise<void>;
     /**
      * Remove an entry from the cache.
      * @param key The key to remove from the cache.

package/docs/changelog.md

@@ -1,5 +1,12 @@
 # @twin.org/core - Changelog
 
+## [0.0.1-next.50](https://github.com/twinfoundation/framework/compare/core-v0.0.1-next.49...core-v0.0.1-next.50) (2025-03-26)
+
+
+### Features
+
+* add set method for async caches ([ba34b55](https://github.com/twinfoundation/framework/commit/ba34b55e651ad56ab8fc59e139e4af631c19cda0))
+
 ## 0.0.1-next.49
 
 - Initial Release

package/docs/reference/classes/AsyncCache.md

@@ -78,6 +78,44 @@ The item from the cache if it exists.
 
 ***
 
+### set()
+
+> `static` **set**\<`T`\>(`key`, `value`, `ttlMs`?): `Promise`\<`void`\>
+
+Set an entry into the cache.
+
+#### Type Parameters
+
+• **T** = `unknown`
+
+#### Parameters
+
+##### key
+
+`string`
+
+The key to set in the cache.
+
+##### value
+
+`T`
+
+The value to set in the cache.
+
+##### ttlMs?
+
+`number`
+
+The TTL of the entry in the cache in ms, defaults to 1s.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+***
+
 ### remove()
 
 > `static` **remove**(`key`): `void`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/core",
-	"version": "0.0.1-next.49",
+	"version": "0.0.1-next.50",
 	"description": "Helper methods/classes for data type checking/validation/guarding/error handling",
 	"repository": {
 		"type": "git",