@geekmidas/cache 0.0.6 → 0.1.0

package/README.md

@@ -6,11 +6,12 @@ A type-safe, flexible caching library for TypeScript applications with support f
 
 - **Type-safe**: Full TypeScript support with generics for strongly-typed cache values
 - **Unified interface**: Common `Cache<T>` interface for all implementations
-- **Multiple backends**: In-memory and Redis (Upstash) implementations included
+- **Multiple backends**: In-memory, Redis (Upstash), and Expo Secure Store implementations
 - **Async API**: Promise-based interface for consistency across implementations
-- **Flexible TTL**: Support for time-to-live where applicable
+- **Flexible TTL**: Support for time-to-live across all implementations
 - **Easy testing**: Simple interface makes mocking and testing straightforward
 - **Modular exports**: Import only what you need
+- **React Native support**: Expo Secure Store implementation for mobile apps
 
 ## Installation
 
@@ -25,6 +26,11 @@ For Redis support via Upstash:
 npm install @upstash/redis
 ```
 
+For React Native support via Expo:
+```bash
+npm install expo-secure-store
+```
+
 ## Quick Start
 
 ### In-Memory Cache
@@ -208,6 +214,58 @@ await cache.set('user:1', {
 const user = await cache.get('user:1');
 ```
 
+### ExpoSecureCache
+
+Secure storage for React Native apps using Expo SecureStore.
+
+```typescript
+import { ExpoSecureCache } from '@geekmidas/cache/expo';
+
+class ExpoSecureCache<T> implements Cache<T>
+```
+
+#### Features
+
+- ✅ Secure, encrypted storage on device
+- ✅ TTL support with automatic expiration
+- ✅ Persistent across app restarts
+- ✅ iOS Keychain & Android Keystore backed
+- ❌ React Native/Expo only
+- ❌ Limited storage capacity (varies by platform)
+- ❌ Slower than in-memory cache
+
+#### Example
+
+```typescript
+import { ExpoSecureCache } from '@geekmidas/cache/expo';
+
+interface AuthTokens {
+  accessToken: string;
+  refreshToken: string;
+}
+
+const cache = new ExpoSecureCache<AuthTokens>();
+
+// Store tokens securely with 1 hour TTL
+await cache.set('auth:tokens', {
+  accessToken: 'eyJhbGciOiJIUzI1NiIs...',
+  refreshToken: 'dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4...'
+}, 3600);
+
+// Retrieve tokens
+const tokens = await cache.get('auth:tokens');
+
+// Clear tokens on logout
+await cache.delete('auth:tokens');
+```
+
+#### Platform Considerations
+
+- **iOS**: Uses Keychain Services, data persists across app reinstalls
+- **Android**: Uses Android Keystore, data cleared on app uninstall
+- **Storage Limits**: Approximately 2KB per item on most devices
+- **Performance**: Async operations can be slower than memory cache
+
 ## Advanced Usage
 
 ### Type Safety
@@ -289,7 +347,7 @@ Create cache instances based on configuration:
 
 ```typescript
 interface CacheConfig {
-  type: 'memory' | 'redis';
+  type: 'memory' | 'redis' | 'expo';
   redis?: {
     url: string;
     token: string;
@@ -303,6 +361,8 @@ function createCache<T>(config: CacheConfig): Cache<T> {
     case 'redis':
       if (!config.redis) throw new Error('Redis config required');
       return new UpstashCache<T>(config.redis.url, config.redis.token);
+    case 'expo':
+      return new ExpoSecureCache<T>();
     default:
       throw new Error(`Unsupported cache type: ${config.type}`);
   }
@@ -418,6 +478,11 @@ describe('UserService', () => {
 - **Cons**: Network latency, external dependency
 - **Best for**: Production, multi-instance apps, shared cache
 
+### ExpoSecureCache
+- **Pros**: Secure, encrypted, persistent on device
+- **Cons**: React Native only, storage limits, slower operations
+- **Best for**: Mobile apps, sensitive data (tokens, credentials)
+
 ### Key Strategies
 
 1. **Use appropriate TTL**: Balance between cache freshness and performance

package/dist/{chunk-DWy1uDak.cjs → chunk-CUT6urMc.cjs}

@@ -5,9 +5,6 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function() {
-	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
 var __copyProps = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
 		key = keys[i];
@@ -25,12 +22,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 //#endregion
 
-Object.defineProperty(exports, '__commonJS', {
-  enumerable: true,
-  get: function () {
-    return __commonJS;
-  }
-});
 Object.defineProperty(exports, '__toESM', {
   enumerable: true,
   get: function () {

package/dist/expo.cjs

@@ -1,5 +1,5 @@
-const require_chunk = require('./chunk-DWy1uDak.cjs');
-const require_src = require('./src-C7d6HaTp.cjs');
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+const require_src = require('./src-zfYb7mdS.cjs');
 const date_fns = require_chunk.__toESM(require("date-fns"));
 const expo_secure_store = require_chunk.__toESM(require("expo-secure-store"));
 
@@ -33,4 +33,5 @@ var ExpoSecureCache = class ExpoSecureCache {
 };
 
 //#endregion
-exports.ExpoSecureCache = ExpoSecureCache;
+exports.ExpoSecureCache = ExpoSecureCache;
+//# sourceMappingURL=expo.cjs.map

package/dist/expo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo.cjs","names":["key: string","value: T","ttl: number"],"sources":["../src/expo.ts"],"sourcesContent":["import { addSeconds } from 'date-fns';\nimport * as SecureStore from 'expo-secure-store';\nimport { type Cache, getExpirationInSeconds } from './index';\n\nexport class ExpoSecureCache implements Cache {\n  static getExpiryKey(key: string): string {\n    return `${key}:expiresAt`;\n  }\n\n  async ttl(key: string): Promise<number> {\n    const result = await SecureStore.getItemAsync(\n      ExpoSecureCache.getExpiryKey(key),\n    );\n    if (!result) {\n      return 0;\n    }\n\n    const secondsLeft = getExpirationInSeconds(result);\n\n    return Math.max(secondsLeft, 0);\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const result = await SecureStore.getItemAsync(key);\n    if (!result) {\n      return undefined;\n    }\n\n    const expiresAt = await this.ttl(key);\n    if (expiresAt === 0) {\n      return undefined;\n    }\n\n    return JSON.parse(result) as T;\n  }\n\n  async set<T>(key: string, value: T, ttl: number = 600): Promise<void> {\n    const expiresAt = addSeconds(new Date(), ttl).toISOString();\n    await SecureStore.setItemAsync(key, JSON.stringify(value));\n    await SecureStore.setItemAsync(\n      ExpoSecureCache.getExpiryKey(key),\n      expiresAt,\n    );\n  }\n\n  async delete(key: string): Promise<void> {\n    await SecureStore.deleteItemAsync(key);\n    await SecureStore.deleteItemAsync(ExpoSecureCache.getExpiryKey(key));\n  }\n}\n"],"mappings":";;;;;;AAIA,IAAa,kBAAb,MAAa,gBAAiC;CAC5C,OAAO,aAAaA,KAAqB;AACvC,UAAQ,EAAE,IAAI;CACf;CAED,MAAM,IAAIA,KAA8B;EACtC,MAAM,SAAS,MAAM,kBAAY,aAC/B,gBAAgB,aAAa,IAAI,CAClC;AACD,OAAK,OACH,QAAO;EAGT,MAAM,cAAc,mCAAuB,OAAO;AAElD,SAAO,KAAK,IAAI,aAAa,EAAE;CAChC;CAED,MAAM,IAAOA,KAAqC;EAChD,MAAM,SAAS,MAAM,kBAAY,aAAa,IAAI;AAClD,OAAK,OACH;EAGF,MAAM,YAAY,MAAM,KAAK,IAAI,IAAI;AACrC,MAAI,cAAc,EAChB;AAGF,SAAO,KAAK,MAAM,OAAO;CAC1B;CAED,MAAM,IAAOA,KAAaC,OAAUC,MAAc,KAAoB;EACpE,MAAM,YAAY,yCAAW,IAAI,QAAQ,IAAI,CAAC,aAAa;AAC3D,QAAM,kBAAY,aAAa,KAAK,KAAK,UAAU,MAAM,CAAC;AAC1D,QAAM,kBAAY,aAChB,gBAAgB,aAAa,IAAI,EACjC,UACD;CACF;CAED,MAAM,OAAOF,KAA4B;AACvC,QAAM,kBAAY,gBAAgB,IAAI;AACtC,QAAM,kBAAY,gBAAgB,gBAAgB,aAAa,IAAI,CAAC;CACrE;AACF"}

package/dist/expo.d.cts

@@ -1,12 +1,13 @@
-import { Cache } from "./index-B6eF5Yxi.cjs";
+import { Cache } from "./index-CExVL1mV.cjs";
 
 //#region src/expo.d.ts
-declare class ExpoSecureCache<T> implements Cache<T> {
+declare class ExpoSecureCache implements Cache {
   static getExpiryKey(key: string): string;
   ttl(key: string): Promise<number>;
-  get(key: string): Promise<T | undefined>;
-  set(key: string, value: T, ttl?: number): Promise<void>;
+  get<T>(key: string): Promise<T | undefined>;
+  set<T>(key: string, value: T, ttl?: number): Promise<void>;
   delete(key: string): Promise<void>;
 }
 //#endregion
-export { ExpoSecureCache };
+export { ExpoSecureCache };
+//# sourceMappingURL=expo.d.cts.map

package/dist/expo.d.mts

@@ -1,12 +1,13 @@
-import { Cache } from "./index-Bv61mxVT.mjs";
+import { Cache } from "./index-M02PehQA.mjs";
 
 //#region src/expo.d.ts
-declare class ExpoSecureCache<T> implements Cache<T> {
+declare class ExpoSecureCache implements Cache {
   static getExpiryKey(key: string): string;
   ttl(key: string): Promise<number>;
-  get(key: string): Promise<T | undefined>;
-  set(key: string, value: T, ttl?: number): Promise<void>;
+  get<T>(key: string): Promise<T | undefined>;
+  set<T>(key: string, value: T, ttl?: number): Promise<void>;
   delete(key: string): Promise<void>;
 }
 //#endregion
-export { ExpoSecureCache };
+export { ExpoSecureCache };
+//# sourceMappingURL=expo.d.mts.map

package/dist/expo.mjs

@@ -1,4 +1,4 @@
-import { getExpirationInSeconds } from "./src-DVpoP03o.mjs";
+import { getExpirationInSeconds } from "./src-CrE4Nl5T.mjs";
 import { addSeconds } from "date-fns";
 import * as SecureStore from "expo-secure-store";
 
@@ -32,4 +32,5 @@ var ExpoSecureCache = class ExpoSecureCache {
 };
 
 //#endregion
-export { ExpoSecureCache };
+export { ExpoSecureCache };
+//# sourceMappingURL=expo.mjs.map

package/dist/expo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo.mjs","names":["key: string","value: T","ttl: number"],"sources":["../src/expo.ts"],"sourcesContent":["import { addSeconds } from 'date-fns';\nimport * as SecureStore from 'expo-secure-store';\nimport { type Cache, getExpirationInSeconds } from './index';\n\nexport class ExpoSecureCache implements Cache {\n  static getExpiryKey(key: string): string {\n    return `${key}:expiresAt`;\n  }\n\n  async ttl(key: string): Promise<number> {\n    const result = await SecureStore.getItemAsync(\n      ExpoSecureCache.getExpiryKey(key),\n    );\n    if (!result) {\n      return 0;\n    }\n\n    const secondsLeft = getExpirationInSeconds(result);\n\n    return Math.max(secondsLeft, 0);\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const result = await SecureStore.getItemAsync(key);\n    if (!result) {\n      return undefined;\n    }\n\n    const expiresAt = await this.ttl(key);\n    if (expiresAt === 0) {\n      return undefined;\n    }\n\n    return JSON.parse(result) as T;\n  }\n\n  async set<T>(key: string, value: T, ttl: number = 600): Promise<void> {\n    const expiresAt = addSeconds(new Date(), ttl).toISOString();\n    await SecureStore.setItemAsync(key, JSON.stringify(value));\n    await SecureStore.setItemAsync(\n      ExpoSecureCache.getExpiryKey(key),\n      expiresAt,\n    );\n  }\n\n  async delete(key: string): Promise<void> {\n    await SecureStore.deleteItemAsync(key);\n    await SecureStore.deleteItemAsync(ExpoSecureCache.getExpiryKey(key));\n  }\n}\n"],"mappings":";;;;;AAIA,IAAa,kBAAb,MAAa,gBAAiC;CAC5C,OAAO,aAAaA,KAAqB;AACvC,UAAQ,EAAE,IAAI;CACf;CAED,MAAM,IAAIA,KAA8B;EACtC,MAAM,SAAS,MAAM,YAAY,aAC/B,gBAAgB,aAAa,IAAI,CAClC;AACD,OAAK,OACH,QAAO;EAGT,MAAM,cAAc,uBAAuB,OAAO;AAElD,SAAO,KAAK,IAAI,aAAa,EAAE;CAChC;CAED,MAAM,IAAOA,KAAqC;EAChD,MAAM,SAAS,MAAM,YAAY,aAAa,IAAI;AAClD,OAAK,OACH;EAGF,MAAM,YAAY,MAAM,KAAK,IAAI,IAAI;AACrC,MAAI,cAAc,EAChB;AAGF,SAAO,KAAK,MAAM,OAAO;CAC1B;CAED,MAAM,IAAOA,KAAaC,OAAUC,MAAc,KAAoB;EACpE,MAAM,YAAY,2BAAW,IAAI,QAAQ,IAAI,CAAC,aAAa;AAC3D,QAAM,YAAY,aAAa,KAAK,KAAK,UAAU,MAAM,CAAC;AAC1D,QAAM,YAAY,aAChB,gBAAgB,aAAa,IAAI,EACjC,UACD;CACF;CAED,MAAM,OAAOF,KAA4B;AACvC,QAAM,YAAY,gBAAgB,IAAI;AACtC,QAAM,YAAY,gBAAgB,gBAAgB,aAAa,IAAI,CAAC;CACrE;AACF"}

package/dist/{index-B6eF5Yxi.d.cts → index-CExVL1mV.d.cts}

@@ -1,12 +1,13 @@
 //#region src/index.d.ts
 declare const getExpirationInSeconds: (expiresAt: string | number | Date | undefined | null) => number;
-interface Cache<T> {
+interface Cache {
   /**
    * Retrieves a value from the cache.
    *
    * @param key The key to retrieve the value for.
+   * @returns The cached value, or undefined if not found.
    */
-  get(key: string): Promise<T | undefined>;
+  get<T>(key: string): Promise<T | undefined>;
   /**
    * Sets a value in the cache.
    *
@@ -14,7 +15,7 @@ interface Cache<T> {
    * @param value The value to cache.
    * @param ttl Optional time-to-live in seconds. If not provided, the value will not expire.
    */
-  set(key: string, value: T, ttl?: number): Promise<void>;
+  set<T>(key: string, value: T, ttl?: number): Promise<void>;
   /**
    * Deletes a value from the cache.
    *
@@ -25,9 +26,10 @@ interface Cache<T> {
    * Retrieves the time-to-live (TTL) for a cached value.
    *
    * @param key The key to retrieve the TTL for.
-   * @returns The TTL in seconds, or undefined if the key does not exist.
+   * @returns The TTL in seconds, or 0 if the key does not exist.
    */
   ttl(key: string): Promise<number>;
 }
 //#endregion
-export { Cache, getExpirationInSeconds };
+export { Cache, getExpirationInSeconds };
+//# sourceMappingURL=index-CExVL1mV.d.cts.map

package/dist/{index-Bv61mxVT.d.mts → index-M02PehQA.d.mts}

@@ -1,12 +1,13 @@
 //#region src/index.d.ts
 declare const getExpirationInSeconds: (expiresAt: string | number | Date | undefined | null) => number;
-interface Cache<T> {
+interface Cache {
   /**
    * Retrieves a value from the cache.
    *
    * @param key The key to retrieve the value for.
+   * @returns The cached value, or undefined if not found.
    */
-  get(key: string): Promise<T | undefined>;
+  get<T>(key: string): Promise<T | undefined>;
   /**
    * Sets a value in the cache.
    *
@@ -14,7 +15,7 @@ interface Cache<T> {
    * @param value The value to cache.
    * @param ttl Optional time-to-live in seconds. If not provided, the value will not expire.
    */
-  set(key: string, value: T, ttl?: number): Promise<void>;
+  set<T>(key: string, value: T, ttl?: number): Promise<void>;
   /**
    * Deletes a value from the cache.
    *
@@ -25,9 +26,10 @@ interface Cache<T> {
    * Retrieves the time-to-live (TTL) for a cached value.
    *
    * @param key The key to retrieve the TTL for.
-   * @returns The TTL in seconds, or undefined if the key does not exist.
+   * @returns The TTL in seconds, or 0 if the key does not exist.
    */
   ttl(key: string): Promise<number>;
 }
 //#endregion
-export { Cache, getExpirationInSeconds };
+export { Cache, getExpirationInSeconds };
+//# sourceMappingURL=index-M02PehQA.d.mts.map

package/dist/index.cjs

@@ -1,3 +1,3 @@
-const require_src = require('./src-C7d6HaTp.cjs');
+const require_src = require('./src-zfYb7mdS.cjs');
 
 exports.getExpirationInSeconds = require_src.getExpirationInSeconds;

package/dist/index.d.cts

@@ -1,2 +1,2 @@
-import { Cache, getExpirationInSeconds } from "./index-B6eF5Yxi.cjs";
+import { Cache, getExpirationInSeconds } from "./index-CExVL1mV.cjs";
 export { Cache, getExpirationInSeconds };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { Cache, getExpirationInSeconds } from "./index-Bv61mxVT.mjs";
+import { Cache, getExpirationInSeconds } from "./index-M02PehQA.mjs";
 export { Cache, getExpirationInSeconds };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { getExpirationInSeconds } from "./src-DVpoP03o.mjs";
+import { getExpirationInSeconds } from "./src-CrE4Nl5T.mjs";
 
 export { getExpirationInSeconds };

package/dist/memory.cjs

@@ -1,4 +1,36 @@
-require('./src-C7d6HaTp.cjs');
-const require_memory = require('./memory-Csy6J-Ak.cjs');
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+const require_src = require('./src-zfYb7mdS.cjs');
+const date_fns = require_chunk.__toESM(require("date-fns"));
 
-exports.InMemoryCache = require_memory.InMemoryCache;
+//#region src/memory.ts
+var InMemoryCache = class {
+	store = /* @__PURE__ */ new Map();
+	expirations = /* @__PURE__ */ new Map();
+	async get(key) {
+		const expiration = await this.ttl(key);
+		if (!expiration) {
+			await this.delete(key);
+			return void 0;
+		}
+		return this.store.get(key);
+	}
+	async ttl(key) {
+		const expiration = this.expirations.get(key);
+		if (!expiration) return 0;
+		return require_src.getExpirationInSeconds(expiration);
+	}
+	async set(key, value, ttl = 600) {
+		this.store.set(key, value);
+		const now = /* @__PURE__ */ new Date();
+		const expiresAt = (0, date_fns.addSeconds)(now, ttl);
+		this.expirations.set(key, expiresAt);
+	}
+	async delete(key) {
+		this.store.delete(key);
+		this.expirations.delete(key);
+	}
+};
+
+//#endregion
+exports.InMemoryCache = InMemoryCache;
+//# sourceMappingURL=memory.cjs.map

package/dist/memory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.cjs","names":["key: string","value: T","ttl: number"],"sources":["../src/memory.ts"],"sourcesContent":["import { addSeconds } from 'date-fns';\nimport { type Cache, getExpirationInSeconds } from './';\n\nexport class InMemoryCache implements Cache {\n  private store: Map<string, unknown> = new Map();\n  private expirations: Map<string, Date> = new Map();\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const expiration = await this.ttl(key);\n    if (!expiration) {\n      await this.delete(key);\n      return undefined;\n    }\n\n    return this.store.get(key) as T | undefined;\n  }\n\n  async ttl(key: string): Promise<number> {\n    const expiration = this.expirations.get(key);\n    if (!expiration) {\n      return 0;\n    }\n\n    return getExpirationInSeconds(expiration);\n  }\n\n  async set<T>(key: string, value: T, ttl: number = 600): Promise<void> {\n    this.store.set(key, value);\n    const now = new Date();\n    const expiresAt = addSeconds(now, ttl);\n    this.expirations.set(key, expiresAt);\n  }\n\n  async delete(key: string): Promise<void> {\n    this.store.delete(key);\n    this.expirations.delete(key);\n  }\n}\n"],"mappings":";;;;;AAGA,IAAa,gBAAb,MAA4C;CAC1C,AAAQ,wBAA8B,IAAI;CAC1C,AAAQ,8BAAiC,IAAI;CAE7C,MAAM,IAAOA,KAAqC;EAChD,MAAM,aAAa,MAAM,KAAK,IAAI,IAAI;AACtC,OAAK,YAAY;AACf,SAAM,KAAK,OAAO,IAAI;AACtB;EACD;AAED,SAAO,KAAK,MAAM,IAAI,IAAI;CAC3B;CAED,MAAM,IAAIA,KAA8B;EACtC,MAAM,aAAa,KAAK,YAAY,IAAI,IAAI;AAC5C,OAAK,WACH,QAAO;AAGT,SAAO,mCAAuB,WAAW;CAC1C;CAED,MAAM,IAAOA,KAAaC,OAAUC,MAAc,KAAoB;AACpE,OAAK,MAAM,IAAI,KAAK,MAAM;EAC1B,MAAM,sBAAM,IAAI;EAChB,MAAM,YAAY,yBAAW,KAAK,IAAI;AACtC,OAAK,YAAY,IAAI,KAAK,UAAU;CACrC;CAED,MAAM,OAAOF,KAA4B;AACvC,OAAK,MAAM,OAAO,IAAI;AACtB,OAAK,YAAY,OAAO,IAAI;CAC7B;AACF"}

package/dist/memory.d.cts

@@ -1,13 +1,14 @@
-import { Cache } from "./index-B6eF5Yxi.cjs";
+import { Cache } from "./index-CExVL1mV.cjs";
 
 //#region src/memory.d.ts
-declare class InMemoryCache<T> implements Cache<T> {
+declare class InMemoryCache implements Cache {
   private store;
   private expirations;
-  get(key: string): Promise<T | undefined>;
+  get<T>(key: string): Promise<T | undefined>;
   ttl(key: string): Promise<number>;
-  set(key: string, value: T, ttl?: number): Promise<void>;
+  set<T>(key: string, value: T, ttl?: number): Promise<void>;
   delete(key: string): Promise<void>;
 }
 //#endregion
-export { InMemoryCache };
+export { InMemoryCache };
+//# sourceMappingURL=memory.d.cts.map

package/dist/memory.d.mts

@@ -1,13 +1,14 @@
-import { Cache } from "./index-Bv61mxVT.mjs";
+import { Cache } from "./index-M02PehQA.mjs";
 
 //#region src/memory.d.ts
-declare class InMemoryCache<T> implements Cache<T> {
+declare class InMemoryCache implements Cache {
   private store;
   private expirations;
-  get(key: string): Promise<T | undefined>;
+  get<T>(key: string): Promise<T | undefined>;
   ttl(key: string): Promise<number>;
-  set(key: string, value: T, ttl?: number): Promise<void>;
+  set<T>(key: string, value: T, ttl?: number): Promise<void>;
   delete(key: string): Promise<void>;
 }
 //#endregion
-export { InMemoryCache };
+export { InMemoryCache };
+//# sourceMappingURL=memory.d.mts.map

package/dist/memory.mjs

@@ -1,4 +1,35 @@
-import "./src-DVpoP03o.mjs";
-import { InMemoryCache } from "./memory-QDTnSEX5.mjs";
+import { getExpirationInSeconds } from "./src-CrE4Nl5T.mjs";
+import { addSeconds } from "date-fns";
 
-export { InMemoryCache };
+//#region src/memory.ts
+var InMemoryCache = class {
+	store = /* @__PURE__ */ new Map();
+	expirations = /* @__PURE__ */ new Map();
+	async get(key) {
+		const expiration = await this.ttl(key);
+		if (!expiration) {
+			await this.delete(key);
+			return void 0;
+		}
+		return this.store.get(key);
+	}
+	async ttl(key) {
+		const expiration = this.expirations.get(key);
+		if (!expiration) return 0;
+		return getExpirationInSeconds(expiration);
+	}
+	async set(key, value, ttl = 600) {
+		this.store.set(key, value);
+		const now = /* @__PURE__ */ new Date();
+		const expiresAt = addSeconds(now, ttl);
+		this.expirations.set(key, expiresAt);
+	}
+	async delete(key) {
+		this.store.delete(key);
+		this.expirations.delete(key);
+	}
+};
+
+//#endregion
+export { InMemoryCache };
+//# sourceMappingURL=memory.mjs.map

package/dist/memory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.mjs","names":["key: string","value: T","ttl: number"],"sources":["../src/memory.ts"],"sourcesContent":["import { addSeconds } from 'date-fns';\nimport { type Cache, getExpirationInSeconds } from './';\n\nexport class InMemoryCache implements Cache {\n  private store: Map<string, unknown> = new Map();\n  private expirations: Map<string, Date> = new Map();\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const expiration = await this.ttl(key);\n    if (!expiration) {\n      await this.delete(key);\n      return undefined;\n    }\n\n    return this.store.get(key) as T | undefined;\n  }\n\n  async ttl(key: string): Promise<number> {\n    const expiration = this.expirations.get(key);\n    if (!expiration) {\n      return 0;\n    }\n\n    return getExpirationInSeconds(expiration);\n  }\n\n  async set<T>(key: string, value: T, ttl: number = 600): Promise<void> {\n    this.store.set(key, value);\n    const now = new Date();\n    const expiresAt = addSeconds(now, ttl);\n    this.expirations.set(key, expiresAt);\n  }\n\n  async delete(key: string): Promise<void> {\n    this.store.delete(key);\n    this.expirations.delete(key);\n  }\n}\n"],"mappings":";;;;AAGA,IAAa,gBAAb,MAA4C;CAC1C,AAAQ,wBAA8B,IAAI;CAC1C,AAAQ,8BAAiC,IAAI;CAE7C,MAAM,IAAOA,KAAqC;EAChD,MAAM,aAAa,MAAM,KAAK,IAAI,IAAI;AACtC,OAAK,YAAY;AACf,SAAM,KAAK,OAAO,IAAI;AACtB;EACD;AAED,SAAO,KAAK,MAAM,IAAI,IAAI;CAC3B;CAED,MAAM,IAAIA,KAA8B;EACtC,MAAM,aAAa,KAAK,YAAY,IAAI,IAAI;AAC5C,OAAK,WACH,QAAO;AAGT,SAAO,uBAAuB,WAAW;CAC1C;CAED,MAAM,IAAOA,KAAaC,OAAUC,MAAc,KAAoB;AACpE,OAAK,MAAM,IAAI,KAAK,MAAM;EAC1B,MAAM,sBAAM,IAAI;EAChB,MAAM,YAAY,WAAW,KAAK,IAAI;AACtC,OAAK,YAAY,IAAI,KAAK,UAAU;CACrC;CAED,MAAM,OAAOF,KAA4B;AACvC,OAAK,MAAM,OAAO,IAAI;AACtB,OAAK,YAAY,OAAO,IAAI;CAC7B;AACF"}

package/dist/{src-DVpoP03o.mjs → src-CrE4Nl5T.mjs}

@@ -10,4 +10,5 @@ const getExpirationInSeconds = (expiresAt) => {
 };
 
 //#endregion
-export { getExpirationInSeconds };
+export { getExpirationInSeconds };
+//# sourceMappingURL=src-CrE4Nl5T.mjs.map

package/dist/src-CrE4Nl5T.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"src-CrE4Nl5T.mjs","names":["expiresAt: string | number | Date | undefined | null"],"sources":["../src/index.ts"],"sourcesContent":["import { differenceInSeconds } from 'date-fns';\n\nexport const getExpirationInSeconds = (\n  expiresAt: string | number | Date | undefined | null,\n): number => {\n  if (!expiresAt) {\n    return 0;\n  }\n\n  const expirationDate = new Date(expiresAt);\n  const now = new Date();\n\n  const secondsLeft = differenceInSeconds(expirationDate, now);\n\n  return Math.max(secondsLeft, 0);\n};\n\nexport interface Cache {\n  /**\n   * Retrieves a value from the cache.\n   *\n   * @param key The key to retrieve the value for.\n   * @returns The cached value, or undefined if not found.\n   */\n  get<T>(key: string): Promise<T | undefined>;\n  /**\n   * Sets a value in the cache.\n   *\n   * @param key The key to set the value for.\n   * @param value The value to cache.\n   * @param ttl Optional time-to-live in seconds. If not provided, the value will not expire.\n   */\n  set<T>(key: string, value: T, ttl?: number): Promise<void>;\n  /**\n   * Deletes a value from the cache.\n   *\n   * @param key The key to delete from the cache.\n   */\n  delete(key: string): Promise<void>;\n\n  /**\n   * Retrieves the time-to-live (TTL) for a cached value.\n   *\n   * @param key The key to retrieve the TTL for.\n   * @returns The TTL in seconds, or 0 if the key does not exist.\n   */\n  ttl(key: string): Promise<number>;\n}\n"],"mappings":";;;AAEA,MAAa,yBAAyB,CACpCA,cACW;AACX,MAAK,UACH,QAAO;CAGT,MAAM,iBAAiB,IAAI,KAAK;CAChC,MAAM,sBAAM,IAAI;CAEhB,MAAM,cAAc,oBAAoB,gBAAgB,IAAI;AAE5D,QAAO,KAAK,IAAI,aAAa,EAAE;AAChC"}

package/dist/{src-C7d6HaTp.cjs → src-zfYb7mdS.cjs}

@@ -1,4 +1,4 @@
-const require_chunk = require('./chunk-DWy1uDak.cjs');
+const require_chunk = require('./chunk-CUT6urMc.cjs');
 const date_fns = require_chunk.__toESM(require("date-fns"));
 
 //#region src/index.ts
@@ -16,4 +16,5 @@ Object.defineProperty(exports, 'getExpirationInSeconds', {
   get: function () {
     return getExpirationInSeconds;
   }
-});
+});
+//# sourceMappingURL=src-zfYb7mdS.cjs.map

package/dist/src-zfYb7mdS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"src-zfYb7mdS.cjs","names":["expiresAt: string | number | Date | undefined | null"],"sources":["../src/index.ts"],"sourcesContent":["import { differenceInSeconds } from 'date-fns';\n\nexport const getExpirationInSeconds = (\n  expiresAt: string | number | Date | undefined | null,\n): number => {\n  if (!expiresAt) {\n    return 0;\n  }\n\n  const expirationDate = new Date(expiresAt);\n  const now = new Date();\n\n  const secondsLeft = differenceInSeconds(expirationDate, now);\n\n  return Math.max(secondsLeft, 0);\n};\n\nexport interface Cache {\n  /**\n   * Retrieves a value from the cache.\n   *\n   * @param key The key to retrieve the value for.\n   * @returns The cached value, or undefined if not found.\n   */\n  get<T>(key: string): Promise<T | undefined>;\n  /**\n   * Sets a value in the cache.\n   *\n   * @param key The key to set the value for.\n   * @param value The value to cache.\n   * @param ttl Optional time-to-live in seconds. If not provided, the value will not expire.\n   */\n  set<T>(key: string, value: T, ttl?: number): Promise<void>;\n  /**\n   * Deletes a value from the cache.\n   *\n   * @param key The key to delete from the cache.\n   */\n  delete(key: string): Promise<void>;\n\n  /**\n   * Retrieves the time-to-live (TTL) for a cached value.\n   *\n   * @param key The key to retrieve the TTL for.\n   * @returns The TTL in seconds, or 0 if the key does not exist.\n   */\n  ttl(key: string): Promise<number>;\n}\n"],"mappings":";;;;AAEA,MAAa,yBAAyB,CACpCA,cACW;AACX,MAAK,UACH,QAAO;CAGT,MAAM,iBAAiB,IAAI,KAAK;CAChC,MAAM,sBAAM,IAAI;CAEhB,MAAM,cAAc,kCAAoB,gBAAgB,IAAI;AAE5D,QAAO,KAAK,IAAI,aAAa,EAAE;AAChC"}

package/dist/upstash.cjs

@@ -1,3 +1,33 @@
-const require_upstash = require('./upstash-u8Hs4sZG.cjs');
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+const __upstash_redis = require_chunk.__toESM(require("@upstash/redis"));
 
-exports.UpstashCache = require_upstash.UpstashCache;
+//#region src/upstash.ts
+var UpstashCache = class {
+	client;
+	constructor(url, token) {
+		this.client = new __upstash_redis.Redis({
+			url,
+			token
+		});
+	}
+	async ttl(key) {
+		const ttl = await this.client.ttl(key);
+		if (ttl === -2) return 0;
+		return ttl;
+	}
+	async get(key) {
+		const v = await this.client.get(key);
+		if (v === null) return void 0;
+		return v;
+	}
+	async set(key, value, ttl = 3600) {
+		await this.client.set(key, value, { ex: ttl });
+	}
+	async delete(key) {
+		await this.client.del(key);
+	}
+};
+
+//#endregion
+exports.UpstashCache = UpstashCache;
+//# sourceMappingURL=upstash.cjs.map

package/dist/upstash.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstash.cjs","names":["url: string","token: string","Redis","key: string","value: T"],"sources":["../src/upstash.ts"],"sourcesContent":["import { Redis } from '@upstash/redis';\nimport type { Cache } from './';\n\nexport class UpstashCache implements Cache {\n  private client: Redis;\n\n  constructor(url: string, token: string) {\n    this.client = new Redis({\n      url,\n      token,\n    });\n  }\n\n  async ttl(key: string): Promise<number> {\n    const ttl = await this.client.ttl(key);\n\n    if (ttl === -2) {\n      return 0; // Key does not exist\n    }\n\n    return ttl; // Returns TTL in seconds\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const v = await this.client.get(key);\n\n    if (v === null) {\n      return undefined;\n    }\n\n    return v as T;\n  }\n\n  async set<T>(key: string, value: T, ttl = 3600): Promise<void> {\n    await this.client.set(key, value, { ex: ttl });\n  }\n\n  async delete(key: string): Promise<void> {\n    await this.client.del(key);\n  }\n}\n"],"mappings":";;;;AAGA,IAAa,eAAb,MAA2C;CACzC,AAAQ;CAER,YAAYA,KAAaC,OAAe;AACtC,OAAK,SAAS,IAAIC,sBAAM;GACtB;GACA;EACD;CACF;CAED,MAAM,IAAIC,KAA8B;EACtC,MAAM,MAAM,MAAM,KAAK,OAAO,IAAI,IAAI;AAEtC,MAAI,QAAQ,GACV,QAAO;AAGT,SAAO;CACR;CAED,MAAM,IAAOA,KAAqC;EAChD,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAEpC,MAAI,MAAM,KACR;AAGF,SAAO;CACR;CAED,MAAM,IAAOA,KAAaC,OAAU,MAAM,MAAqB;AAC7D,QAAM,KAAK,OAAO,IAAI,KAAK,OAAO,EAAE,IAAI,IAAK,EAAC;CAC/C;CAED,MAAM,OAAOD,KAA4B;AACvC,QAAM,KAAK,OAAO,IAAI,IAAI;CAC3B;AACF"}

package/dist/upstash.d.cts

@@ -1,13 +1,14 @@
-import { Cache } from "./index-B6eF5Yxi.cjs";
+import { Cache } from "./index-CExVL1mV.cjs";
 
 //#region src/upstash.d.ts
-declare class UpstashCache<T> implements Cache<T> {
+declare class UpstashCache implements Cache {
   private client;
   constructor(url: string, token: string);
   ttl(key: string): Promise<number>;
-  get(key: string): Promise<T | undefined>;
-  set(key: string, value: T, ttl?: number): Promise<void>;
+  get<T>(key: string): Promise<T | undefined>;
+  set<T>(key: string, value: T, ttl?: number): Promise<void>;
   delete(key: string): Promise<void>;
 }
 //#endregion
-export { UpstashCache };
+export { UpstashCache };
+//# sourceMappingURL=upstash.d.cts.map

package/dist/upstash.d.mts

@@ -1,13 +1,14 @@
-import { Cache } from "./index-Bv61mxVT.mjs";
+import { Cache } from "./index-M02PehQA.mjs";
 
 //#region src/upstash.d.ts
-declare class UpstashCache<T> implements Cache<T> {
+declare class UpstashCache implements Cache {
   private client;
   constructor(url: string, token: string);
   ttl(key: string): Promise<number>;
-  get(key: string): Promise<T | undefined>;
-  set(key: string, value: T, ttl?: number): Promise<void>;
+  get<T>(key: string): Promise<T | undefined>;
+  set<T>(key: string, value: T, ttl?: number): Promise<void>;
   delete(key: string): Promise<void>;
 }
 //#endregion
-export { UpstashCache };
+export { UpstashCache };
+//# sourceMappingURL=upstash.d.mts.map

package/dist/upstash.mjs

@@ -1,3 +1,32 @@
-import { UpstashCache } from "./upstash-CXy_duOa.mjs";
+import { Redis } from "@upstash/redis";
 
-export { UpstashCache };
+//#region src/upstash.ts
+var UpstashCache = class {
+	client;
+	constructor(url, token) {
+		this.client = new Redis({
+			url,
+			token
+		});
+	}
+	async ttl(key) {
+		const ttl = await this.client.ttl(key);
+		if (ttl === -2) return 0;
+		return ttl;
+	}
+	async get(key) {
+		const v = await this.client.get(key);
+		if (v === null) return void 0;
+		return v;
+	}
+	async set(key, value, ttl = 3600) {
+		await this.client.set(key, value, { ex: ttl });
+	}
+	async delete(key) {
+		await this.client.del(key);
+	}
+};
+
+//#endregion
+export { UpstashCache };
+//# sourceMappingURL=upstash.mjs.map

package/dist/upstash.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstash.mjs","names":["url: string","token: string","key: string","value: T"],"sources":["../src/upstash.ts"],"sourcesContent":["import { Redis } from '@upstash/redis';\nimport type { Cache } from './';\n\nexport class UpstashCache implements Cache {\n  private client: Redis;\n\n  constructor(url: string, token: string) {\n    this.client = new Redis({\n      url,\n      token,\n    });\n  }\n\n  async ttl(key: string): Promise<number> {\n    const ttl = await this.client.ttl(key);\n\n    if (ttl === -2) {\n      return 0; // Key does not exist\n    }\n\n    return ttl; // Returns TTL in seconds\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const v = await this.client.get(key);\n\n    if (v === null) {\n      return undefined;\n    }\n\n    return v as T;\n  }\n\n  async set<T>(key: string, value: T, ttl = 3600): Promise<void> {\n    await this.client.set(key, value, { ex: ttl });\n  }\n\n  async delete(key: string): Promise<void> {\n    await this.client.del(key);\n  }\n}\n"],"mappings":";;;AAGA,IAAa,eAAb,MAA2C;CACzC,AAAQ;CAER,YAAYA,KAAaC,OAAe;AACtC,OAAK,SAAS,IAAI,MAAM;GACtB;GACA;EACD;CACF;CAED,MAAM,IAAIC,KAA8B;EACtC,MAAM,MAAM,MAAM,KAAK,OAAO,IAAI,IAAI;AAEtC,MAAI,QAAQ,GACV,QAAO;AAGT,SAAO;CACR;CAED,MAAM,IAAOA,KAAqC;EAChD,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAEpC,MAAI,MAAM,KACR;AAGF,SAAO;CACR;CAED,MAAM,IAAOA,KAAaC,OAAU,MAAM,MAAqB;AAC7D,QAAM,KAAK,OAAO,IAAI,KAAK,OAAO,EAAE,IAAI,IAAK,EAAC;CAC/C;CAED,MAAM,OAAOD,KAA4B;AACvC,QAAM,KAAK,OAAO,IAAI,IAAI;CAC3B;AACF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@geekmidas/cache",
-  "version": "0.0.6",
-  "description": "Type-safe email client with SMTP support and React templates",
+  "version": "0.1.0",
+  "description": "Unified cache interface with multiple storage implementations",
   "private": false,
   "type": "module",
   "exports": {
@@ -26,6 +26,10 @@
       "require": "./dist/expo.cjs"
     }
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/geekmidas/toolbox"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"