@geekmidas/cache 1.1.2 → 10.0.0-alpha.0

package/dist/registry-CT0b-rjB.mjs

@@ -0,0 +1,41 @@
+//#region src/registry.ts
+const drivers = /* @__PURE__ */ new Map();
+/** Make a driver available to {@link createCacheClient}. Idempotent. */
+function registerCacheDriver(driver) {
+	drivers.set(driver.scheme, driver);
+}
+/** Which schemes are currently registered — the useful half of a failure. */
+function registeredCacheSchemes() {
+	return [...drivers.keys()].sort();
+}
+/**
+* Build a client for a URL.
+*
+* @throws {UnregisteredCacheScheme} when no driver handles the scheme, which in
+* practice means the entry point registered a different one — the backend and
+* the build disagreeing, caught at the first cache call rather than never.
+*/
+function createCacheClient(url) {
+	const scheme = schemeOf(url);
+	const driver = drivers.get(scheme);
+	if (!driver) throw new UnregisteredCacheScheme(url, scheme, registeredCacheSchemes());
+	return driver.create(url);
+}
+/** No driver handles the scheme in a cache URL. */
+var UnregisteredCacheScheme = class extends Error {
+	constructor(url, scheme, registered) {
+		super(`No cache driver handles '${scheme}'. ` + (registered.length ? `Registered: ${registered.join(", ")}.` : "Nothing is registered.") + " The scheme comes from the backend the target provisioned, so this is usually a build that registered a different one.");
+		this.url = url;
+		this.scheme = scheme;
+		this.registered = registered;
+		this.name = "UnregisteredCacheScheme";
+	}
+};
+function schemeOf(url) {
+	const separator = url.indexOf(":");
+	return separator === -1 ? "" : url.slice(0, separator + 1);
+}
+
+//#endregion
+export { UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes };
+//# sourceMappingURL=registry-CT0b-rjB.mjs.map

package/dist/registry-CT0b-rjB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-CT0b-rjB.mjs","names":["driver: CacheDriver","url: string","scheme: string","registered: readonly string[]"],"sources":["../src/registry.ts"],"sourcesContent":["/**\n * Cache drivers, keyed by URL scheme.\n *\n * The same shape `@geekmidas/storage` uses, for the same reason: a construct is\n * handed one URL and the scheme in it picks the client. That is what lets the\n * *backend* be a deployment choice rather than an application one — an app\n * caching in Postgres and an app caching in Upstash are the same code.\n *\n * Registration is explicit rather than an import side effect, because a\n * side-effecting module is exactly what a bundler is entitled to drop — and\n * because an app that caches in Postgres should never resolve a Redis client.\n */\n\nimport type { Cache } from './index';\n\n/** What a driver has to supply: a scheme it answers to, and a client for a URL. */\nexport interface CacheDriver {\n\t/** Including the colon, as `URL.protocol` reports it — `redis:`, `https:`. */\n\tscheme: string;\n\tcreate(url: string): Cache;\n}\n\nconst drivers = new Map<string, CacheDriver>();\n\n/** Make a driver available to {@link createCacheClient}. Idempotent. */\nexport function registerCacheDriver(driver: CacheDriver): void {\n\tdrivers.set(driver.scheme, driver);\n}\n\n/** Which schemes are currently registered — the useful half of a failure. */\nexport function registeredCacheSchemes(): string[] {\n\treturn [...drivers.keys()].sort();\n}\n\n/**\n * Build a client for a URL.\n *\n * @throws {UnregisteredCacheScheme} when no driver handles the scheme, which in\n * practice means the entry point registered a different one — the backend and\n * the build disagreeing, caught at the first cache call rather than never.\n */\nexport function createCacheClient(url: string): Cache {\n\tconst scheme = schemeOf(url);\n\tconst driver = drivers.get(scheme);\n\n\tif (!driver) {\n\t\tthrow new UnregisteredCacheScheme(url, scheme, registeredCacheSchemes());\n\t}\n\n\treturn driver.create(url);\n}\n\n/** No driver handles the scheme in a cache URL. */\nexport class UnregisteredCacheScheme extends Error {\n\tconstructor(\n\t\treadonly url: string,\n\t\treadonly scheme: string,\n\t\treadonly registered: readonly string[],\n\t) {\n\t\tsuper(\n\t\t\t`No cache driver handles '${scheme}'. ` +\n\t\t\t\t(registered.length\n\t\t\t\t\t? `Registered: ${registered.join(', ')}.`\n\t\t\t\t\t: 'Nothing is registered.') +\n\t\t\t\t' The scheme comes from the backend the target provisioned, so this ' +\n\t\t\t\t'is usually a build that registered a different one.',\n\t\t);\n\t\tthis.name = 'UnregisteredCacheScheme';\n\t}\n}\n\nfunction schemeOf(url: string): string {\n\tconst separator = url.indexOf(':');\n\treturn separator === -1 ? '' : url.slice(0, separator + 1);\n}\n"],"mappings":";AAsBA,MAAM,0BAAU,IAAI;;AAGpB,SAAgB,oBAAoBA,QAA2B;AAC9D,SAAQ,IAAI,OAAO,QAAQ,OAAO;AAClC;;AAGD,SAAgB,yBAAmC;AAClD,QAAO,CAAC,GAAG,QAAQ,MAAM,AAAC,EAAC,MAAM;AACjC;;;;;;;;AASD,SAAgB,kBAAkBC,KAAoB;CACrD,MAAM,SAAS,SAAS,IAAI;CAC5B,MAAM,SAAS,QAAQ,IAAI,OAAO;AAElC,MAAK,OACJ,OAAM,IAAI,wBAAwB,KAAK,QAAQ,wBAAwB;AAGxE,QAAO,OAAO,OAAO,IAAI;AACzB;;AAGD,IAAa,0BAAb,cAA6C,MAAM;CAClD,YACUA,KACAC,QACAC,YACR;AACD,SACE,2BAA2B,OAAO,QACjC,WAAW,UACR,cAAc,WAAW,KAAK,KAAK,CAAC,KACrC,4BACH,yHAED;EAXQ;EACA;EACA;AAUT,OAAK,OAAO;CACZ;AACD;AAED,SAAS,SAASF,KAAqB;CACtC,MAAM,YAAY,IAAI,QAAQ,IAAI;AAClC,QAAO,cAAc,KAAK,KAAK,IAAI,MAAM,GAAG,YAAY,EAAE;AAC1D"}

package/dist/registry.cjs

@@ -0,0 +1,6 @@
+const require_registry = require('./registry-CITg73zW.cjs');
+
+exports.UnregisteredCacheScheme = require_registry.UnregisteredCacheScheme;
+exports.createCacheClient = require_registry.createCacheClient;
+exports.registerCacheDriver = require_registry.registerCacheDriver;
+exports.registeredCacheSchemes = require_registry.registeredCacheSchemes;

package/dist/registry.d.cts

@@ -0,0 +1,2 @@
+import { CacheDriver, UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes } from "./index-CNQ50bVk.cjs";
+export { CacheDriver, UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes };

package/dist/registry.d.mts

@@ -0,0 +1,2 @@
+import { CacheDriver, UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes } from "./index-1sNRIo6N.mjs";
+export { CacheDriver, UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes };

package/dist/registry.mjs

@@ -0,0 +1,3 @@
+import { UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes } from "./registry-CT0b-rjB.mjs";
+
+export { UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes };

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

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

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

@@ -1 +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\texpiresAt: string | number | Date | undefined | null,\n): number => {\n\tif (!expiresAt) {\n\t\treturn 0;\n\t}\n\n\tconst expirationDate = new Date(expiresAt);\n\tconst now = new Date();\n\n\tconst secondsLeft = differenceInSeconds(expirationDate, now);\n\n\treturn Math.max(secondsLeft, 0);\n};\n\nexport interface Cache {\n\t/**\n\t * Retrieves a value from the cache.\n\t *\n\t * @param key The key to retrieve the value for.\n\t * @returns The cached value, or undefined if not found.\n\t */\n\tget<T>(key: string): Promise<T | undefined>;\n\t/**\n\t * Sets a value in the cache.\n\t *\n\t * @param key The key to set the value for.\n\t * @param value The value to cache.\n\t * @param ttl Optional time-to-live in seconds. If not provided, the value will not expire.\n\t */\n\tset<T>(key: string, value: T, ttl?: number): Promise<void>;\n\t/**\n\t * Deletes a value from the cache.\n\t *\n\t * @param key The key to delete from the cache.\n\t */\n\tdelete(key: string): Promise<void>;\n\n\t/**\n\t * Retrieves the time-to-live (TTL) for a cached value.\n\t *\n\t * @param key The key to retrieve the TTL for.\n\t * @returns The TTL in seconds, or 0 if the key does not exist.\n\t */\n\tttl(key: string): Promise<number>;\n}\n"],"mappings":";;;AAEA,MAAa,yBAAyB,CACrCA,cACY;AACZ,MAAK,UACJ,QAAO;CAGR,MAAM,iBAAiB,IAAI,KAAK;CAChC,MAAM,sBAAM,IAAI;CAEhB,MAAM,cAAc,oBAAoB,gBAAgB,IAAI;AAE5D,QAAO,KAAK,IAAI,aAAa,EAAE;AAC/B"}
+{"version":3,"file":"src-DVpoP03o.mjs","names":["expiresAt: string | number | Date | undefined | null"],"sources":["../src/index.ts"],"sourcesContent":["import { differenceInSeconds } from 'date-fns';\n\nexport const getExpirationInSeconds = (\n\texpiresAt: string | number | Date | undefined | null,\n): number => {\n\tif (!expiresAt) {\n\t\treturn 0;\n\t}\n\n\tconst expirationDate = new Date(expiresAt);\n\tconst now = new Date();\n\n\tconst secondsLeft = differenceInSeconds(expirationDate, now);\n\n\treturn Math.max(secondsLeft, 0);\n};\n\nexport interface Cache {\n\t/**\n\t * Retrieves a value from the cache.\n\t *\n\t * @param key The key to retrieve the value for.\n\t * @returns The cached value, or undefined if not found.\n\t */\n\tget<T>(key: string): Promise<T | undefined>;\n\t/**\n\t * Sets a value in the cache.\n\t *\n\t * @param key The key to set the value for.\n\t * @param value The value to cache.\n\t * @param ttl Optional time-to-live in seconds. If not provided, the value will not expire.\n\t */\n\tset<T>(key: string, value: T, ttl?: number): Promise<void>;\n\t/**\n\t * Deletes a value from the cache.\n\t *\n\t * @param key The key to delete from the cache.\n\t */\n\tdelete(key: string): Promise<void>;\n\n\t/**\n\t * Retrieves the time-to-live (TTL) for a cached value.\n\t *\n\t * @param key The key to retrieve the TTL for.\n\t * @returns The TTL in seconds, or 0 if the key does not exist.\n\t */\n\tttl(key: string): Promise<number>;\n}\n\nexport type { CacheDriver } from './registry';\nexport {\n\tcreateCacheClient,\n\tregisterCacheDriver,\n\tregisteredCacheSchemes,\n\tUnregisteredCacheScheme,\n} from './registry';\n"],"mappings":";;;AAEA,MAAa,yBAAyB,CACrCA,cACY;AACZ,MAAK,UACJ,QAAO;CAGR,MAAM,iBAAiB,IAAI,KAAK;CAChC,MAAM,sBAAM,IAAI;CAEhB,MAAM,cAAc,oBAAoB,gBAAgB,IAAI;AAE5D,QAAO,KAAK,IAAI,aAAa,EAAE;AAC/B"}

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

@@ -17,4 +17,4 @@ Object.defineProperty(exports, 'getExpirationInSeconds', {
     return getExpirationInSeconds;
   }
 });
-//# sourceMappingURL=src-zfYb7mdS.cjs.map
+//# sourceMappingURL=src-ysNIqjnr.cjs.map

package/dist/{src-zfYb7mdS.cjs.map → src-ysNIqjnr.cjs.map}

@@ -1 +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\texpiresAt: string | number | Date | undefined | null,\n): number => {\n\tif (!expiresAt) {\n\t\treturn 0;\n\t}\n\n\tconst expirationDate = new Date(expiresAt);\n\tconst now = new Date();\n\n\tconst secondsLeft = differenceInSeconds(expirationDate, now);\n\n\treturn Math.max(secondsLeft, 0);\n};\n\nexport interface Cache {\n\t/**\n\t * Retrieves a value from the cache.\n\t *\n\t * @param key The key to retrieve the value for.\n\t * @returns The cached value, or undefined if not found.\n\t */\n\tget<T>(key: string): Promise<T | undefined>;\n\t/**\n\t * Sets a value in the cache.\n\t *\n\t * @param key The key to set the value for.\n\t * @param value The value to cache.\n\t * @param ttl Optional time-to-live in seconds. If not provided, the value will not expire.\n\t */\n\tset<T>(key: string, value: T, ttl?: number): Promise<void>;\n\t/**\n\t * Deletes a value from the cache.\n\t *\n\t * @param key The key to delete from the cache.\n\t */\n\tdelete(key: string): Promise<void>;\n\n\t/**\n\t * Retrieves the time-to-live (TTL) for a cached value.\n\t *\n\t * @param key The key to retrieve the TTL for.\n\t * @returns The TTL in seconds, or 0 if the key does not exist.\n\t */\n\tttl(key: string): Promise<number>;\n}\n"],"mappings":";;;;AAEA,MAAa,yBAAyB,CACrCA,cACY;AACZ,MAAK,UACJ,QAAO;CAGR,MAAM,iBAAiB,IAAI,KAAK;CAChC,MAAM,sBAAM,IAAI;CAEhB,MAAM,cAAc,kCAAoB,gBAAgB,IAAI;AAE5D,QAAO,KAAK,IAAI,aAAa,EAAE;AAC/B"}
+{"version":3,"file":"src-ysNIqjnr.cjs","names":["expiresAt: string | number | Date | undefined | null"],"sources":["../src/index.ts"],"sourcesContent":["import { differenceInSeconds } from 'date-fns';\n\nexport const getExpirationInSeconds = (\n\texpiresAt: string | number | Date | undefined | null,\n): number => {\n\tif (!expiresAt) {\n\t\treturn 0;\n\t}\n\n\tconst expirationDate = new Date(expiresAt);\n\tconst now = new Date();\n\n\tconst secondsLeft = differenceInSeconds(expirationDate, now);\n\n\treturn Math.max(secondsLeft, 0);\n};\n\nexport interface Cache {\n\t/**\n\t * Retrieves a value from the cache.\n\t *\n\t * @param key The key to retrieve the value for.\n\t * @returns The cached value, or undefined if not found.\n\t */\n\tget<T>(key: string): Promise<T | undefined>;\n\t/**\n\t * Sets a value in the cache.\n\t *\n\t * @param key The key to set the value for.\n\t * @param value The value to cache.\n\t * @param ttl Optional time-to-live in seconds. If not provided, the value will not expire.\n\t */\n\tset<T>(key: string, value: T, ttl?: number): Promise<void>;\n\t/**\n\t * Deletes a value from the cache.\n\t *\n\t * @param key The key to delete from the cache.\n\t */\n\tdelete(key: string): Promise<void>;\n\n\t/**\n\t * Retrieves the time-to-live (TTL) for a cached value.\n\t *\n\t * @param key The key to retrieve the TTL for.\n\t * @returns The TTL in seconds, or 0 if the key does not exist.\n\t */\n\tttl(key: string): Promise<number>;\n}\n\nexport type { CacheDriver } from './registry';\nexport {\n\tcreateCacheClient,\n\tregisterCacheDriver,\n\tregisteredCacheSchemes,\n\tUnregisteredCacheScheme,\n} from './registry';\n"],"mappings":";;;;AAEA,MAAa,yBAAyB,CACrCA,cACY;AACZ,MAAK,UACJ,QAAO;CAGR,MAAM,iBAAiB,IAAI,KAAK;CAChC,MAAM,sBAAM,IAAI;CAEhB,MAAM,cAAc,kCAAoB,gBAAgB,IAAI;AAE5D,QAAO,KAAK,IAAI,aAAa,EAAE;AAC/B"}

package/dist/upstash.cjs

@@ -27,7 +27,48 @@ var UpstashCache = class {
 		await this.client.del(key);
 	}
 };
+/**
+* The `https://` and `http://` driver.
+*
+* The token travels in the URL's userinfo, because an address and the
+* credential that opens it are one fact — see {@link parseUpstashUrl}. Deployed
+* that is Upstash's host over TLS; locally it is the `serverless-redis-http`
+* proxy in front of a Redis container, and the client cannot tell the
+* difference. That is the whole point of choosing this backend.
+*/
+const upstashCacheDriver = {
+	scheme: "https:",
+	create: (url) => {
+		const { endpoint, token } = parseUpstashUrl(url);
+		return new UpstashCache(endpoint, token);
+	}
+};
+/** The same driver for plain HTTP, which is what the local proxy speaks. */
+const upstashInsecureCacheDriver = {
+	...upstashCacheDriver,
+	scheme: "http:"
+};
+/**
+* Split a cache URL into what the client takes.
+*
+* `http://:token@localhost:20705` becomes `{ endpoint: 'http://localhost:20705',
+* token }`. Deployed the scheme is `https` and the host is Upstash's; nothing
+* else differs.
+*/
+function parseUpstashUrl(url) {
+	const parsed = new URL(url);
+	const token = decodeURIComponent(parsed.password || parsed.username);
+	parsed.username = "";
+	parsed.password = "";
+	return {
+		endpoint: parsed.origin,
+		token
+	};
+}
 
 //#endregion
 exports.UpstashCache = UpstashCache;
+exports.parseUpstashUrl = parseUpstashUrl;
+exports.upstashCacheDriver = upstashCacheDriver;
+exports.upstashInsecureCacheDriver = upstashInsecureCacheDriver;
 //# sourceMappingURL=upstash.cjs.map

package/dist/upstash.cjs.map

@@ -1 +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\tprivate client: Redis;\n\n\tconstructor(url: string, token: string) {\n\t\tthis.client = new Redis({\n\t\t\turl,\n\t\t\ttoken,\n\t\t});\n\t}\n\n\tasync ttl(key: string): Promise<number> {\n\t\tconst ttl = await this.client.ttl(key);\n\n\t\tif (ttl === -2) {\n\t\t\treturn 0; // Key does not exist\n\t\t}\n\n\t\treturn ttl; // Returns TTL in seconds\n\t}\n\n\tasync get<T>(key: string): Promise<T | undefined> {\n\t\tconst v = await this.client.get(key);\n\n\t\tif (v === null) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\treturn v as T;\n\t}\n\n\tasync set<T>(key: string, value: T, ttl = 3600): Promise<void> {\n\t\tawait this.client.set(key, value, { ex: ttl });\n\t}\n\n\tasync delete(key: string): Promise<void> {\n\t\tawait this.client.del(key);\n\t}\n}\n"],"mappings":";;;;AAGA,IAAa,eAAb,MAA2C;CAC1C,AAAQ;CAER,YAAYA,KAAaC,OAAe;AACvC,OAAK,SAAS,IAAIC,sBAAM;GACvB;GACA;EACA;CACD;CAED,MAAM,IAAIC,KAA8B;EACvC,MAAM,MAAM,MAAM,KAAK,OAAO,IAAI,IAAI;AAEtC,MAAI,QAAQ,GACX,QAAO;AAGR,SAAO;CACP;CAED,MAAM,IAAOA,KAAqC;EACjD,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAEpC,MAAI,MAAM,KACT;AAGD,SAAO;CACP;CAED,MAAM,IAAOA,KAAaC,OAAU,MAAM,MAAqB;AAC9D,QAAM,KAAK,OAAO,IAAI,KAAK,OAAO,EAAE,IAAI,IAAK,EAAC;CAC9C;CAED,MAAM,OAAOD,KAA4B;AACxC,QAAM,KAAK,OAAO,IAAI,IAAI;CAC1B;AACD"}
+{"version":3,"file":"upstash.cjs","names":["url: string","token: string","Redis","key: string","value: T","upstashCacheDriver: CacheDriver","upstashInsecureCacheDriver: CacheDriver"],"sources":["../src/upstash.ts"],"sourcesContent":["import { Redis } from '@upstash/redis';\nimport type { Cache } from './';\nimport type { CacheDriver } from './registry';\n\nexport class UpstashCache implements Cache {\n\tprivate client: Redis;\n\n\tconstructor(url: string, token: string) {\n\t\tthis.client = new Redis({\n\t\t\turl,\n\t\t\ttoken,\n\t\t});\n\t}\n\n\tasync ttl(key: string): Promise<number> {\n\t\tconst ttl = await this.client.ttl(key);\n\n\t\tif (ttl === -2) {\n\t\t\treturn 0; // Key does not exist\n\t\t}\n\n\t\treturn ttl; // Returns TTL in seconds\n\t}\n\n\tasync get<T>(key: string): Promise<T | undefined> {\n\t\tconst v = await this.client.get(key);\n\n\t\tif (v === null) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\treturn v as T;\n\t}\n\n\tasync set<T>(key: string, value: T, ttl = 3600): Promise<void> {\n\t\tawait this.client.set(key, value, { ex: ttl });\n\t}\n\n\tasync delete(key: string): Promise<void> {\n\t\tawait this.client.del(key);\n\t}\n}\n\n/**\n * The `https://` and `http://` driver.\n *\n * The token travels in the URL's userinfo, because an address and the\n * credential that opens it are one fact — see {@link parseUpstashUrl}. Deployed\n * that is Upstash's host over TLS; locally it is the `serverless-redis-http`\n * proxy in front of a Redis container, and the client cannot tell the\n * difference. That is the whole point of choosing this backend.\n */\nexport const upstashCacheDriver: CacheDriver = {\n\tscheme: 'https:',\n\tcreate: (url) => {\n\t\tconst { endpoint, token } = parseUpstashUrl(url);\n\t\treturn new UpstashCache(endpoint, token);\n\t},\n};\n\n/** The same driver for plain HTTP, which is what the local proxy speaks. */\nexport const upstashInsecureCacheDriver: CacheDriver = {\n\t...upstashCacheDriver,\n\tscheme: 'http:',\n};\n\n/** What an Upstash cache URL addresses: an HTTP endpoint and the token for it. */\nexport interface UpstashAddress {\n\tendpoint: string;\n\ttoken: string;\n}\n\n/**\n * Split a cache URL into what the client takes.\n *\n * `http://:token@localhost:20705` becomes `{ endpoint: 'http://localhost:20705',\n * token }`. Deployed the scheme is `https` and the host is Upstash's; nothing\n * else differs.\n */\nexport function parseUpstashUrl(url: string): UpstashAddress {\n\tconst parsed = new URL(url);\n\tconst token = decodeURIComponent(parsed.password || parsed.username);\n\n\tparsed.username = '';\n\tparsed.password = '';\n\n\treturn {\n\t\t// `origin` drops the trailing slash `toString()` would add, which the\n\t\t// client would otherwise send as part of every path.\n\t\tendpoint: parsed.origin,\n\t\ttoken,\n\t};\n}\n"],"mappings":";;;;AAIA,IAAa,eAAb,MAA2C;CAC1C,AAAQ;CAER,YAAYA,KAAaC,OAAe;AACvC,OAAK,SAAS,IAAIC,sBAAM;GACvB;GACA;EACA;CACD;CAED,MAAM,IAAIC,KAA8B;EACvC,MAAM,MAAM,MAAM,KAAK,OAAO,IAAI,IAAI;AAEtC,MAAI,QAAQ,GACX,QAAO;AAGR,SAAO;CACP;CAED,MAAM,IAAOA,KAAqC;EACjD,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAEpC,MAAI,MAAM,KACT;AAGD,SAAO;CACP;CAED,MAAM,IAAOA,KAAaC,OAAU,MAAM,MAAqB;AAC9D,QAAM,KAAK,OAAO,IAAI,KAAK,OAAO,EAAE,IAAI,IAAK,EAAC;CAC9C;CAED,MAAM,OAAOD,KAA4B;AACxC,QAAM,KAAK,OAAO,IAAI,IAAI;CAC1B;AACD;;;;;;;;;;AAWD,MAAaE,qBAAkC;CAC9C,QAAQ;CACR,QAAQ,CAAC,QAAQ;EAChB,MAAM,EAAE,UAAU,OAAO,GAAG,gBAAgB,IAAI;AAChD,SAAO,IAAI,aAAa,UAAU;CAClC;AACD;;AAGD,MAAaC,6BAA0C;CACtD,GAAG;CACH,QAAQ;AACR;;;;;;;;AAeD,SAAgB,gBAAgBN,KAA6B;CAC5D,MAAM,SAAS,IAAI,IAAI;CACvB,MAAM,QAAQ,mBAAmB,OAAO,YAAY,OAAO,SAAS;AAEpE,QAAO,WAAW;AAClB,QAAO,WAAW;AAElB,QAAO;EAGN,UAAU,OAAO;EACjB;CACA;AACD"}

package/dist/upstash.d.cts

@@ -1,4 +1,4 @@
-import { Cache } from "./index-BSYYdwRm.cjs";
+import { Cache, CacheDriver } from "./index-CNQ50bVk.cjs";
 
 //#region src/upstash.d.ts
 declare class UpstashCache implements Cache {
@@ -9,8 +9,32 @@ declare class UpstashCache implements Cache {
   set<T>(key: string, value: T, ttl?: number): Promise<void>;
   delete(key: string): Promise<void>;
 }
+/**
+ * The `https://` and `http://` driver.
+ *
+ * The token travels in the URL's userinfo, because an address and the
+ * credential that opens it are one fact — see {@link parseUpstashUrl}. Deployed
+ * that is Upstash's host over TLS; locally it is the `serverless-redis-http`
+ * proxy in front of a Redis container, and the client cannot tell the
+ * difference. That is the whole point of choosing this backend.
+ */
+declare const upstashCacheDriver: CacheDriver;
+/** The same driver for plain HTTP, which is what the local proxy speaks. */
+declare const upstashInsecureCacheDriver: CacheDriver;
+/** What an Upstash cache URL addresses: an HTTP endpoint and the token for it. */
+interface UpstashAddress {
+  endpoint: string;
+  token: string;
+}
+/**
+ * Split a cache URL into what the client takes.
+ *
+ * `http://:token@localhost:20705` becomes `{ endpoint: 'http://localhost:20705',
+ * token }`. Deployed the scheme is `https` and the host is Upstash's; nothing
+ * else differs.
+ */
+declare function parseUpstashUrl(url: string): UpstashAddress;
 //# sourceMappingURL=upstash.d.ts.map
-
 //#endregion
-export { UpstashCache };
+export { UpstashAddress, UpstashCache, parseUpstashUrl, upstashCacheDriver, upstashInsecureCacheDriver };
 //# sourceMappingURL=upstash.d.cts.map

package/dist/upstash.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"upstash.d.cts","names":[],"sources":["../src/upstash.ts"],"sourcesContent":[],"mappings":";;;cAGa,YAAA,YAAwB;;EAAxB,WAAA,CAAA,GAAa,EAAA,MAAA,EAAA,KAAA,EAAA,MAAA;EAAA,GAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAUD,OAVC,CAAA,MAAA,CAAA;EAAA,GAUD,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAUG,OAVH,CAUW,CAVX,GAAA,SAAA,CAAA;EAAO,GAUI,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAUF,CAVE,EAAA,GAAA,CAAA,EAAA,MAAA,CAAA,EAUc,OAVd,CAAA,IAAA,CAAA;EAAC,MAAT,CAAA,GAAA,EAAA,MAAA,CAAA,EAcA,OAdA,CAAA,IAAA,CAAA"}
+{"version":3,"file":"upstash.d.cts","names":[],"sources":["../src/upstash.ts"],"sourcesContent":[],"mappings":";;;cAIa,YAAA,YAAwB;EAAxB,QAAA,MAAA;EAAa,WAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,MAAA;EAAA,GAUD,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA,CAAA,MAAA,CAAA;EAAO,GAUI,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAR,OAAQ,CAAA,CAAA,GAAA,SAAA,CAAA;EAAC,GAAT,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAUM,CAVN,EAAA,GAAA,CAAA,EAAA,MAAA,CAAA,EAUsB,OAVtB,CAAA,IAAA,CAAA;EAAO,MAUD,CAAA,GAAA,EAAA,MAAA,CAAA,EAIN,OAJM,CAAA,IAAA,CAAA;;;;AA9BQ;AAgD1C;AASA;AAMA;AAYA;;;cA3Ba,oBAAoB;;cASpB,4BAA4B;;UAMxB,cAAA;;;;;;;;;;;iBAYD,eAAA,eAA8B"}

package/dist/upstash.d.mts

@@ -1,4 +1,4 @@
-import { Cache } from "./index-Dx96gr-9.mjs";
+import { Cache, CacheDriver } from "./index-1sNRIo6N.mjs";
 
 //#region src/upstash.d.ts
 declare class UpstashCache implements Cache {
@@ -9,8 +9,32 @@ declare class UpstashCache implements Cache {
   set<T>(key: string, value: T, ttl?: number): Promise<void>;
   delete(key: string): Promise<void>;
 }
+/**
+ * The `https://` and `http://` driver.
+ *
+ * The token travels in the URL's userinfo, because an address and the
+ * credential that opens it are one fact — see {@link parseUpstashUrl}. Deployed
+ * that is Upstash's host over TLS; locally it is the `serverless-redis-http`
+ * proxy in front of a Redis container, and the client cannot tell the
+ * difference. That is the whole point of choosing this backend.
+ */
+declare const upstashCacheDriver: CacheDriver;
+/** The same driver for plain HTTP, which is what the local proxy speaks. */
+declare const upstashInsecureCacheDriver: CacheDriver;
+/** What an Upstash cache URL addresses: an HTTP endpoint and the token for it. */
+interface UpstashAddress {
+  endpoint: string;
+  token: string;
+}
+/**
+ * Split a cache URL into what the client takes.
+ *
+ * `http://:token@localhost:20705` becomes `{ endpoint: 'http://localhost:20705',
+ * token }`. Deployed the scheme is `https` and the host is Upstash's; nothing
+ * else differs.
+ */
+declare function parseUpstashUrl(url: string): UpstashAddress;
 //# sourceMappingURL=upstash.d.ts.map
-
 //#endregion
-export { UpstashCache };
+export { UpstashAddress, UpstashCache, parseUpstashUrl, upstashCacheDriver, upstashInsecureCacheDriver };
 //# sourceMappingURL=upstash.d.mts.map

package/dist/upstash.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"upstash.d.mts","names":[],"sources":["../src/upstash.ts"],"sourcesContent":[],"mappings":";;;cAGa,YAAA,YAAwB;;EAAxB,WAAA,CAAA,GAAa,EAAA,MAAA,EAAA,KAAA,EAAA,MAAA;EAAA,GAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAUD,OAVC,CAAA,MAAA,CAAA;EAAA,GAUD,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAUG,OAVH,CAUW,CAVX,GAAA,SAAA,CAAA;EAAO,GAUI,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAUF,CAVE,EAAA,GAAA,CAAA,EAAA,MAAA,CAAA,EAUc,OAVd,CAAA,IAAA,CAAA;EAAC,MAAT,CAAA,GAAA,EAAA,MAAA,CAAA,EAcA,OAdA,CAAA,IAAA,CAAA"}
+{"version":3,"file":"upstash.d.mts","names":[],"sources":["../src/upstash.ts"],"sourcesContent":[],"mappings":";;;cAIa,YAAA,YAAwB;EAAxB,QAAA,MAAA;EAAa,WAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,MAAA;EAAA,GAUD,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA,CAAA,MAAA,CAAA;EAAO,GAUI,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAR,OAAQ,CAAA,CAAA,GAAA,SAAA,CAAA;EAAC,GAAT,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAUM,CAVN,EAAA,GAAA,CAAA,EAAA,MAAA,CAAA,EAUsB,OAVtB,CAAA,IAAA,CAAA;EAAO,MAUD,CAAA,GAAA,EAAA,MAAA,CAAA,EAIN,OAJM,CAAA,IAAA,CAAA;;;;AA9BQ;AAgD1C;AASA;AAMA;AAYA;;;cA3Ba,oBAAoB;;cASpB,4BAA4B;;UAMxB,cAAA;;;;;;;;;;;iBAYD,eAAA,eAA8B"}

package/dist/upstash.mjs

@@ -26,7 +26,45 @@ var UpstashCache = class {
 		await this.client.del(key);
 	}
 };
+/**
+* The `https://` and `http://` driver.
+*
+* The token travels in the URL's userinfo, because an address and the
+* credential that opens it are one fact — see {@link parseUpstashUrl}. Deployed
+* that is Upstash's host over TLS; locally it is the `serverless-redis-http`
+* proxy in front of a Redis container, and the client cannot tell the
+* difference. That is the whole point of choosing this backend.
+*/
+const upstashCacheDriver = {
+	scheme: "https:",
+	create: (url) => {
+		const { endpoint, token } = parseUpstashUrl(url);
+		return new UpstashCache(endpoint, token);
+	}
+};
+/** The same driver for plain HTTP, which is what the local proxy speaks. */
+const upstashInsecureCacheDriver = {
+	...upstashCacheDriver,
+	scheme: "http:"
+};
+/**
+* Split a cache URL into what the client takes.
+*
+* `http://:token@localhost:20705` becomes `{ endpoint: 'http://localhost:20705',
+* token }`. Deployed the scheme is `https` and the host is Upstash's; nothing
+* else differs.
+*/
+function parseUpstashUrl(url) {
+	const parsed = new URL(url);
+	const token = decodeURIComponent(parsed.password || parsed.username);
+	parsed.username = "";
+	parsed.password = "";
+	return {
+		endpoint: parsed.origin,
+		token
+	};
+}
 
 //#endregion
-export { UpstashCache };
+export { UpstashCache, parseUpstashUrl, upstashCacheDriver, upstashInsecureCacheDriver };
 //# sourceMappingURL=upstash.mjs.map

package/dist/upstash.mjs.map

@@ -1 +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\tprivate client: Redis;\n\n\tconstructor(url: string, token: string) {\n\t\tthis.client = new Redis({\n\t\t\turl,\n\t\t\ttoken,\n\t\t});\n\t}\n\n\tasync ttl(key: string): Promise<number> {\n\t\tconst ttl = await this.client.ttl(key);\n\n\t\tif (ttl === -2) {\n\t\t\treturn 0; // Key does not exist\n\t\t}\n\n\t\treturn ttl; // Returns TTL in seconds\n\t}\n\n\tasync get<T>(key: string): Promise<T | undefined> {\n\t\tconst v = await this.client.get(key);\n\n\t\tif (v === null) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\treturn v as T;\n\t}\n\n\tasync set<T>(key: string, value: T, ttl = 3600): Promise<void> {\n\t\tawait this.client.set(key, value, { ex: ttl });\n\t}\n\n\tasync delete(key: string): Promise<void> {\n\t\tawait this.client.del(key);\n\t}\n}\n"],"mappings":";;;AAGA,IAAa,eAAb,MAA2C;CAC1C,AAAQ;CAER,YAAYA,KAAaC,OAAe;AACvC,OAAK,SAAS,IAAI,MAAM;GACvB;GACA;EACA;CACD;CAED,MAAM,IAAIC,KAA8B;EACvC,MAAM,MAAM,MAAM,KAAK,OAAO,IAAI,IAAI;AAEtC,MAAI,QAAQ,GACX,QAAO;AAGR,SAAO;CACP;CAED,MAAM,IAAOA,KAAqC;EACjD,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAEpC,MAAI,MAAM,KACT;AAGD,SAAO;CACP;CAED,MAAM,IAAOA,KAAaC,OAAU,MAAM,MAAqB;AAC9D,QAAM,KAAK,OAAO,IAAI,KAAK,OAAO,EAAE,IAAI,IAAK,EAAC;CAC9C;CAED,MAAM,OAAOD,KAA4B;AACxC,QAAM,KAAK,OAAO,IAAI,IAAI;CAC1B;AACD"}
+{"version":3,"file":"upstash.mjs","names":["url: string","token: string","key: string","value: T","upstashCacheDriver: CacheDriver","upstashInsecureCacheDriver: CacheDriver"],"sources":["../src/upstash.ts"],"sourcesContent":["import { Redis } from '@upstash/redis';\nimport type { Cache } from './';\nimport type { CacheDriver } from './registry';\n\nexport class UpstashCache implements Cache {\n\tprivate client: Redis;\n\n\tconstructor(url: string, token: string) {\n\t\tthis.client = new Redis({\n\t\t\turl,\n\t\t\ttoken,\n\t\t});\n\t}\n\n\tasync ttl(key: string): Promise<number> {\n\t\tconst ttl = await this.client.ttl(key);\n\n\t\tif (ttl === -2) {\n\t\t\treturn 0; // Key does not exist\n\t\t}\n\n\t\treturn ttl; // Returns TTL in seconds\n\t}\n\n\tasync get<T>(key: string): Promise<T | undefined> {\n\t\tconst v = await this.client.get(key);\n\n\t\tif (v === null) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\treturn v as T;\n\t}\n\n\tasync set<T>(key: string, value: T, ttl = 3600): Promise<void> {\n\t\tawait this.client.set(key, value, { ex: ttl });\n\t}\n\n\tasync delete(key: string): Promise<void> {\n\t\tawait this.client.del(key);\n\t}\n}\n\n/**\n * The `https://` and `http://` driver.\n *\n * The token travels in the URL's userinfo, because an address and the\n * credential that opens it are one fact — see {@link parseUpstashUrl}. Deployed\n * that is Upstash's host over TLS; locally it is the `serverless-redis-http`\n * proxy in front of a Redis container, and the client cannot tell the\n * difference. That is the whole point of choosing this backend.\n */\nexport const upstashCacheDriver: CacheDriver = {\n\tscheme: 'https:',\n\tcreate: (url) => {\n\t\tconst { endpoint, token } = parseUpstashUrl(url);\n\t\treturn new UpstashCache(endpoint, token);\n\t},\n};\n\n/** The same driver for plain HTTP, which is what the local proxy speaks. */\nexport const upstashInsecureCacheDriver: CacheDriver = {\n\t...upstashCacheDriver,\n\tscheme: 'http:',\n};\n\n/** What an Upstash cache URL addresses: an HTTP endpoint and the token for it. */\nexport interface UpstashAddress {\n\tendpoint: string;\n\ttoken: string;\n}\n\n/**\n * Split a cache URL into what the client takes.\n *\n * `http://:token@localhost:20705` becomes `{ endpoint: 'http://localhost:20705',\n * token }`. Deployed the scheme is `https` and the host is Upstash's; nothing\n * else differs.\n */\nexport function parseUpstashUrl(url: string): UpstashAddress {\n\tconst parsed = new URL(url);\n\tconst token = decodeURIComponent(parsed.password || parsed.username);\n\n\tparsed.username = '';\n\tparsed.password = '';\n\n\treturn {\n\t\t// `origin` drops the trailing slash `toString()` would add, which the\n\t\t// client would otherwise send as part of every path.\n\t\tendpoint: parsed.origin,\n\t\ttoken,\n\t};\n}\n"],"mappings":";;;AAIA,IAAa,eAAb,MAA2C;CAC1C,AAAQ;CAER,YAAYA,KAAaC,OAAe;AACvC,OAAK,SAAS,IAAI,MAAM;GACvB;GACA;EACA;CACD;CAED,MAAM,IAAIC,KAA8B;EACvC,MAAM,MAAM,MAAM,KAAK,OAAO,IAAI,IAAI;AAEtC,MAAI,QAAQ,GACX,QAAO;AAGR,SAAO;CACP;CAED,MAAM,IAAOA,KAAqC;EACjD,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,IAAI;AAEpC,MAAI,MAAM,KACT;AAGD,SAAO;CACP;CAED,MAAM,IAAOA,KAAaC,OAAU,MAAM,MAAqB;AAC9D,QAAM,KAAK,OAAO,IAAI,KAAK,OAAO,EAAE,IAAI,IAAK,EAAC;CAC9C;CAED,MAAM,OAAOD,KAA4B;AACxC,QAAM,KAAK,OAAO,IAAI,IAAI;CAC1B;AACD;;;;;;;;;;AAWD,MAAaE,qBAAkC;CAC9C,QAAQ;CACR,QAAQ,CAAC,QAAQ;EAChB,MAAM,EAAE,UAAU,OAAO,GAAG,gBAAgB,IAAI;AAChD,SAAO,IAAI,aAAa,UAAU;CAClC;AACD;;AAGD,MAAaC,6BAA0C;CACtD,GAAG;CACH,QAAQ;AACR;;;;;;;;AAeD,SAAgB,gBAAgBL,KAA6B;CAC5D,MAAM,SAAS,IAAI,IAAI;CACvB,MAAM,QAAQ,mBAAmB,OAAO,YAAY,OAAO,SAAS;AAEpE,QAAO,WAAW;AAClB,QAAO,WAAW;AAElB,QAAO;EAGN,UAAU,OAAO;EACjB;CACA;AACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/cache",
-  "version": "1.1.2",
+  "version": "10.0.0-alpha.0",
   "description": "Unified cache interface with multiple storage implementations",
   "private": false,
   "type": "module",
@@ -35,6 +35,26 @@
         "default": "./dist/upstash.cjs"
       }
     },
+    "./redis": {
+      "import": {
+        "types": "./dist/redis.d.mts",
+        "default": "./dist/redis.mjs"
+      },
+      "require": {
+        "types": "./dist/redis.d.cts",
+        "default": "./dist/redis.cjs"
+      }
+    },
+    "./postgres": {
+      "import": {
+        "types": "./dist/postgres.d.mts",
+        "default": "./dist/postgres.mjs"
+      },
+      "require": {
+        "types": "./dist/postgres.d.cts",
+        "default": "./dist/postgres.cjs"
+      }
+    },
     "./expo": {
       "import": {
         "types": "./dist/expo.d.mts",
@@ -56,6 +76,9 @@
       }
     }
   },
+  "files": [
+    "dist"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/geekmidas/toolbox"
@@ -70,9 +93,28 @@
   },
   "peerDependencies": {
     "@upstash/redis": "~1.35.1",
-    "expo-secure-store": "^14.2.3"
+    "expo-secure-store": "^14.2.3",
+    "ioredis": "^5.4.0",
+    "pg": "^8.13.0"
   },
   "devDependencies": {
-    "@types/proper-lockfile": "^4.1.4"
+    "@types/pg": "~8.15.5",
+    "@types/proper-lockfile": "^4.1.4",
+    "ioredis": "~5.8.2",
+    "pg": "~8.16.3"
+  },
+  "peerDependenciesMeta": {
+    "@upstash/redis": {
+      "optional": true
+    },
+    "expo-secure-store": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    }
   }
 }

package/CHANGELOG.md

@@ -1,32 +0,0 @@
-# @geekmidas/cache
-
-## 1.1.2
-
-### Patch Changes
-
-- 🐛 [#11](https://github.com/geekmidas/toolbox/pull/11) [`40f4dc0`](https://github.com/geekmidas/toolbox/commit/40f4dc095911b2223a255029d8f776caf7781309) Thanks [@geekmidas](https://github.com/geekmidas)! - Patch release across all packages to realign published versions with the
-  registry. The previous release only published the four packages that had
-  version bumps; the remaining packages failed with "cannot publish over the
-  previously published versions" because their versions were unchanged.
-
-## 1.1.1
-
-### Patch Changes
-
-- 🐛 [`d70c6c0`](https://github.com/geekmidas/toolbox/commit/d70c6c0aeb8a79da2473ac77dbd8255a4a2f5651) Thanks [@geekmidas](https://github.com/geekmidas)! - Fix `package.json` exports so TypeScript declarations resolve correctly under NodeNext/Bundler module resolution. Each subpath export now nests `types` inside its `import`/`require` condition, pointing at the `.d.mts` and `.d.cts` files that `tsdown` actually emits (previously the exports referenced non-existent `.d.ts` files, causing type-resolution failures for consumers). Both ESM (`.mjs`) and CJS (`.cjs`) runtime entry points are preserved. Additionally, `@geekmidas/ui` had `import` paths pointing at `.js` files that were never emitted — those are corrected to `.mjs`.
-
-## 1.1.0
-
-### Minor Changes
-
-- ✨ [`be4f7a9`](https://github.com/geekmidas/toolbox/commit/be4f7a9bd5de7f08adbca582916d6902e0c24de2) Thanks [@geekmidas](https://github.com/geekmidas)! - Add partition support for manifest generation. Users can now group constructs (routes, functions, crons, subscribers) into named partitions by providing a `partition` callback per construct type in the config. Manifests output partitioned fields as `Record<string, T[]>` while remaining flat `T[]` arrays when no partitions are configured.
-
-  Fix mutation type inference in endpoint hooks by using `UseMutationResult` and `UseQueryResult` types directly instead of `ReturnType<typeof useMutation>`, which could resolve to `never` for complex path definitions.
-
-  Add `FileCache` implementation that persists cache entries to a JSON file on disk. Default location is `process.cwd()/.gkm/cache.json`. Uses an in-process mutex combined with `proper-lockfile` for safe concurrent and cross-process writes.
-
-## 1.0.0
-
-### Major Changes
-
-- [`ff7b115`](https://github.com/geekmidas/toolbox/commit/ff7b11599f60f84ac6cdc73714c853ecf786b2e8) Thanks [@geekmidas](https://github.com/geekmidas)! - Version 1 Stable release

package/dist/index-BSYYdwRm.d.cts

@@ -1,36 +0,0 @@
-//#region src/index.d.ts
-declare const getExpirationInSeconds: (expiresAt: string | number | Date | undefined | null) => number;
-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<T>(key: string): Promise<T | undefined>;
-  /**
-   * Sets a value in the cache.
-   *
-   * @param key The key to set the value for.
-   * @param value The value to cache.
-   * @param ttl Optional time-to-live in seconds. If not provided, the value will not expire.
-   */
-  set<T>(key: string, value: T, ttl?: number): Promise<void>;
-  /**
-   * Deletes a value from the cache.
-   *
-   * @param key The key to delete from the cache.
-   */
-  delete(key: string): Promise<void>;
-  /**
-   * 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 0 if the key does not exist.
-   */
-  ttl(key: string): Promise<number>;
-}
-//# sourceMappingURL=index.d.ts.map
-//#endregion
-export { Cache, getExpirationInSeconds };
-//# sourceMappingURL=index-BSYYdwRm.d.cts.map

package/dist/index-BSYYdwRm.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-BSYYdwRm.d.cts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";cAEa,sDACiB;AADjB,UAeI,KAAA,CAfJ;EAeI;;;;;;EAeoC,GAM/B,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAdA,OAcA,CAdQ,CAcR,GAAA,SAAA,CAAA;EAAO;AAQH;;;;;;6BAdE,kBAAkB;;;;;;uBAMxB;;;;;;;oBAQH"}

package/dist/index-Dx96gr-9.d.mts

@@ -1,36 +0,0 @@
-//#region src/index.d.ts
-declare const getExpirationInSeconds: (expiresAt: string | number | Date | undefined | null) => number;
-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<T>(key: string): Promise<T | undefined>;
-  /**
-   * Sets a value in the cache.
-   *
-   * @param key The key to set the value for.
-   * @param value The value to cache.
-   * @param ttl Optional time-to-live in seconds. If not provided, the value will not expire.
-   */
-  set<T>(key: string, value: T, ttl?: number): Promise<void>;
-  /**
-   * Deletes a value from the cache.
-   *
-   * @param key The key to delete from the cache.
-   */
-  delete(key: string): Promise<void>;
-  /**
-   * 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 0 if the key does not exist.
-   */
-  ttl(key: string): Promise<number>;
-}
-//# sourceMappingURL=index.d.ts.map
-//#endregion
-export { Cache, getExpirationInSeconds };
-//# sourceMappingURL=index-Dx96gr-9.d.mts.map

package/dist/index-Dx96gr-9.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-Dx96gr-9.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";cAEa,sDACiB;AADjB,UAeI,KAAA,CAfJ;EAeI;;;;;;EAeoC,GAM/B,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAdA,OAcA,CAdQ,CAcR,GAAA,SAAA,CAAA;EAAO;AAQH;;;;;;6BAdE,kBAAkB;;;;;;uBAMxB;;;;;;;oBAQH"}

package/src/__benchmarks__/memory.bench.ts

@@ -1,51 +0,0 @@
-import { bench, describe } from 'vitest';
-import { InMemoryCache } from '../memory';
-
-describe('InMemoryCache', () => {
-	const cache = new InMemoryCache();
-
-	bench('set with TTL', async () => {
-		await cache.set('key', 'value', 3600);
-	});
-
-	bench('get (cache hit)', async () => {
-		await cache.set('hit-key', 'value', 3600);
-		await cache.get('hit-key');
-	});
-
-	bench('get (cache miss)', async () => {
-		await cache.get('nonexistent-key');
-	});
-
-	bench('delete', async () => {
-		await cache.set('delete-key', 'value', 3600);
-		await cache.delete('delete-key');
-	});
-
-	bench('set + get cycle', async () => {
-		const key = `cycle-${Math.random()}`;
-		await cache.set(key, 'value', 3600);
-		await cache.get(key);
-	});
-});
-
-describe('InMemoryCache - Large Scale', () => {
-	bench('1000 sequential sets', async () => {
-		const cache = new InMemoryCache();
-		for (let i = 0; i < 1000; i++) {
-			await cache.set(`key-${i}`, `value-${i}`, 3600);
-		}
-	});
-
-	bench('1000 sequential gets', async () => {
-		const cache = new InMemoryCache();
-		// Pre-populate
-		for (let i = 0; i < 1000; i++) {
-			await cache.set(`key-${i}`, `value-${i}`, 3600);
-		}
-		// Benchmark gets
-		for (let i = 0; i < 1000; i++) {
-			await cache.get(`key-${i}`);
-		}
-	});
-});