@geekmidas/cache 10.0.0-alpha.9 → 10.0.0-alpha.91

package/dist/redis.d.cts

@@ -1,9 +1,7 @@
-import { Cache, CacheDriver } from "./index-CNQ50bVk.cjs";
+import { r as CacheDriver, t as Cache } from "./index-BbdGhmWP.cjs";
 import { Redis } from "ioredis";
-
 //#region src/redis.d.ts
-
-declare class RedisCache implements Cache {
+export declare class RedisCache implements Cache {
   private readonly client;
   constructor(client: Redis);
   get<T>(key: string): Promise<T | undefined>;
@@ -22,10 +20,8 @@ declare class RedisCache implements Cache {
  * lazy boundary: an app caching in Postgres never imports
  * `@geekmidas/cache/redis`, and so never resolves it.
  */
-declare const redisCacheDriver: CacheDriver;
+export declare const redisCacheDriver: CacheDriver;
 /** The TLS form. ElastiCache Serverless requires it; the same client handles both. */
-declare const redissCacheDriver: CacheDriver;
-//# sourceMappingURL=redis.d.ts.map
+export declare const redissCacheDriver: CacheDriver;
 //#endregion
-export { RedisCache, redisCacheDriver, redissCacheDriver };
 //# sourceMappingURL=redis.d.cts.map

package/dist/redis.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"redis.d.cts","names":[],"sources":["../src/redis.ts"],"sourcesContent":[],"mappings":";;;;;cAmBa,UAAA,YAAsB;;sBACG;uBAEV,QAAQ;6BAcF,kBAAkB;uBAWxB;oBAIH;;;;;;;;;;;;;cAsBZ,kBAAkB;;cAMlB,mBAAmB"}
+{"version":3,"file":"redis.d.cts","names":[],"sources":["../src/redis.ts"],"mappings":";;;qBAoBa,sBAAsB;mBACL;EAA7B,YAA6B,QAAQ;EAE/B,IAAI,GAAG,cAAc,QAAQ;EAgB7B,IAAI,GAAG,aAAa,OAAO,GAAG,eAAe;EAa7C,OAAO,cAAc;EAMrB,IAAI,cAAc;;;;;;;;;;;;;qBAsBZ,kBAAkB;;qBAMlB,mBAAmB"}

package/dist/redis.d.mts

@@ -1,9 +1,7 @@
-import { Cache, CacheDriver } from "./index-1sNRIo6N.mjs";
+import { r as CacheDriver, t as Cache } from "./index-BbdGhmWP.mjs";
 import { Redis } from "ioredis";
-
 //#region src/redis.d.ts
-
-declare class RedisCache implements Cache {
+export declare class RedisCache implements Cache {
   private readonly client;
   constructor(client: Redis);
   get<T>(key: string): Promise<T | undefined>;
@@ -22,10 +20,8 @@ declare class RedisCache implements Cache {
  * lazy boundary: an app caching in Postgres never imports
  * `@geekmidas/cache/redis`, and so never resolves it.
  */
-declare const redisCacheDriver: CacheDriver;
+export declare const redisCacheDriver: CacheDriver;
 /** The TLS form. ElastiCache Serverless requires it; the same client handles both. */
-declare const redissCacheDriver: CacheDriver;
-//# sourceMappingURL=redis.d.ts.map
+export declare const redissCacheDriver: CacheDriver;
 //#endregion
-export { RedisCache, redisCacheDriver, redissCacheDriver };
 //# sourceMappingURL=redis.d.mts.map

package/dist/redis.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"redis.d.mts","names":[],"sources":["../src/redis.ts"],"sourcesContent":[],"mappings":";;;;;cAmBa,UAAA,YAAsB;;sBACG;uBAEV,QAAQ;6BAcF,kBAAkB;uBAWxB;oBAIH;;;;;;;;;;;;;cAsBZ,kBAAkB;;cAMlB,mBAAmB"}
+{"version":3,"file":"redis.d.mts","names":[],"sources":["../src/redis.ts"],"mappings":";;;qBAoBa,sBAAsB;mBACL;EAA7B,YAA6B,QAAQ;EAE/B,IAAI,GAAG,cAAc,QAAQ;EAgB7B,IAAI,GAAG,aAAa,OAAO,GAAG,eAAe;EAa7C,OAAO,cAAc;EAMrB,IAAI,cAAc;;;;;;;;;;;;;qBAsBZ,kBAAkB;;qBAMlB,mBAAmB"}

package/dist/redis.mjs

@@ -1,29 +1,50 @@
+import { traceCache } from "./telemetry.mjs";
 import { Redis } from "ioredis";
-
 //#region src/redis.ts
+/**
+* A cache over the Redis wire protocol — ElastiCache, Valkey, or a Redis you run.
+*
+* The sibling of the Upstash client rather than a replacement for it. Upstash
+* speaks HTTP, which is what makes it reachable from a Lambda with no VPC and
+* no connection pool; this speaks the wire protocol, which is what ElastiCache
+* offers and what a container next to your app is cheapest on.
+*
+* Choosing one is a deployment decision, and the local target follows it: pick
+* `elasticache` and dev runs plain Redis, pick `upstash` and dev runs the HTTP
+* proxy in front of it. Either way dev and prod speak the same protocol, which
+* is the property that matters — a cache that behaves differently in the two
+* places is worse than a slower one.
+*/
 var RedisCache = class {
+	client;
 	constructor(client) {
 		this.client = client;
 	}
 	async get(key) {
-		const value = await this.client.get(key);
-		if (value === null) return void 0;
-		try {
-			return JSON.parse(value);
-		} catch {
-			return value;
-		}
+		return traceCache("redis", "get", async () => {
+			const value = await this.client.get(key);
+			if (value === null) return void 0;
+			try {
+				return JSON.parse(value);
+			} catch {
+				return value;
+			}
+		});
 	}
 	async set(key, value, ttl) {
-		const encoded = JSON.stringify(value);
-		if (ttl === void 0) {
-			await this.client.set(key, encoded);
-			return;
-		}
-		await this.client.set(key, encoded, "EX", ttl);
+		return traceCache("redis", "set", async () => {
+			const encoded = JSON.stringify(value);
+			if (ttl === void 0) {
+				await this.client.set(key, encoded);
+				return;
+			}
+			await this.client.set(key, encoded, "EX", ttl);
+		});
 	}
 	async delete(key) {
-		await this.client.del(key);
+		return traceCache("redis", "delete", async () => {
+			await this.client.del(key);
+		});
 	}
 	async ttl(key) {
 		const seconds = await this.client.ttl(key);
@@ -54,14 +75,11 @@ const clients = /* @__PURE__ */ new Map();
 function clientFor(url) {
 	const existing = clients.get(url);
 	if (existing) return existing;
-	const client = new Redis(url, {
-		maxRetriesPerRequest: 2,
-		enableOfflineQueue: false
-	});
+	const client = new Redis(url, { maxRetriesPerRequest: 2 });
 	clients.set(url, client);
 	return client;
 }
-
 //#endregion
 export { RedisCache, redisCacheDriver, redissCacheDriver };
+
 //# sourceMappingURL=redis.mjs.map

package/dist/redis.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"redis.mjs","names":["client: Redis","key: string","value: T","ttl?: number","redisCacheDriver: CacheDriver","redissCacheDriver: CacheDriver","url: string"],"sources":["../src/redis.ts"],"sourcesContent":["/**\n * A cache over the Redis wire protocol — ElastiCache, Valkey, or a Redis you run.\n *\n * The sibling of the Upstash client rather than a replacement for it. Upstash\n * speaks HTTP, which is what makes it reachable from a Lambda with no VPC and\n * no connection pool; this speaks the wire protocol, which is what ElastiCache\n * offers and what a container next to your app is cheapest on.\n *\n * Choosing one is a deployment decision, and the local target follows it: pick\n * `elasticache` and dev runs plain Redis, pick `upstash` and dev runs the HTTP\n * proxy in front of it. Either way dev and prod speak the same protocol, which\n * is the property that matters — a cache that behaves differently in the two\n * places is worse than a slower one.\n */\n\nimport { Redis } from 'ioredis';\nimport type { Cache } from './index';\nimport type { CacheDriver } from './registry';\n\nexport class RedisCache implements Cache {\n\tconstructor(private readonly client: Redis) {}\n\n\tasync get<T>(key: string): Promise<T | undefined> {\n\t\tconst value = await this.client.get(key);\n\t\tif (value === null) return undefined;\n\n\t\ttry {\n\t\t\treturn JSON.parse(value) as T;\n\t\t} catch {\n\t\t\t// Written by something that did not go through `set`. Returning the\n\t\t\t// raw string is more useful than throwing on a value somebody put\n\t\t\t// there on purpose.\n\t\t\treturn value as unknown as T;\n\t\t}\n\t}\n\n\tasync set<T>(key: string, value: T, ttl?: number): Promise<void> {\n\t\tconst encoded = JSON.stringify(value);\n\n\t\tif (ttl === undefined) {\n\t\t\tawait this.client.set(key, encoded);\n\t\t\treturn;\n\t\t}\n\n\t\tawait this.client.set(key, encoded, 'EX', ttl);\n\t}\n\n\tasync delete(key: string): Promise<void> {\n\t\tawait this.client.del(key);\n\t}\n\n\tasync ttl(key: string): Promise<number> {\n\t\tconst seconds = await this.client.ttl(key);\n\n\t\t// Redis reports -2 for a key that does not exist and -1 for one with no\n\t\t// expiry. The interface says zero for a missing key, and \"never expires\"\n\t\t// has no time left to report either — so both become zero rather than\n\t\t// leaking sentinel values a caller would have to know about.\n\t\treturn seconds < 0 ? 0 : seconds;\n\t}\n}\n\n/**\n * The `redis://` and `rediss://` driver.\n *\n * One client per URL for the life of the process — a Redis connection is a\n * socket, and opening one per cache call is the thing that makes people\n * conclude a cache is not worth having.\n *\n * `ioredis` is imported at the top of this module because the *module* is the\n * lazy boundary: an app caching in Postgres never imports\n * `@geekmidas/cache/redis`, and so never resolves it.\n */\nexport const redisCacheDriver: CacheDriver = {\n\tscheme: 'redis:',\n\tcreate: (url) => new RedisCache(clientFor(url)),\n};\n\n/** The TLS form. ElastiCache Serverless requires it; the same client handles both. */\nexport const redissCacheDriver: CacheDriver = {\n\tscheme: 'rediss:',\n\tcreate: (url) => new RedisCache(clientFor(url)),\n};\n\nconst clients = new Map<string, Redis>();\n\nfunction clientFor(url: string): Redis {\n\tconst existing = clients.get(url);\n\tif (existing) return existing;\n\n\tconst client = new Redis(url, {\n\t\t// A cache miss is recoverable and a hung request is not. Failing fast and\n\t\t// letting the caller treat it as a miss is the behaviour a cache should\n\t\t// have; retrying forever turns a degraded cache into a degraded app.\n\t\tmaxRetriesPerRequest: 2,\n\t\tenableOfflineQueue: false,\n\t});\n\n\tclients.set(url, client);\n\n\treturn client;\n}\n"],"mappings":";;;AAmBA,IAAa,aAAb,MAAyC;CACxC,YAA6BA,QAAe;EAAf;CAAiB;CAE9C,MAAM,IAAOC,KAAqC;EACjD,MAAM,QAAQ,MAAM,KAAK,OAAO,IAAI,IAAI;AACxC,MAAI,UAAU,KAAM;AAEpB,MAAI;AACH,UAAO,KAAK,MAAM,MAAM;EACxB,QAAO;AAIP,UAAO;EACP;CACD;CAED,MAAM,IAAOA,KAAaC,OAAUC,KAA6B;EAChE,MAAM,UAAU,KAAK,UAAU,MAAM;AAErC,MAAI,gBAAmB;AACtB,SAAM,KAAK,OAAO,IAAI,KAAK,QAAQ;AACnC;EACA;AAED,QAAM,KAAK,OAAO,IAAI,KAAK,SAAS,MAAM,IAAI;CAC9C;CAED,MAAM,OAAOF,KAA4B;AACxC,QAAM,KAAK,OAAO,IAAI,IAAI;CAC1B;CAED,MAAM,IAAIA,KAA8B;EACvC,MAAM,UAAU,MAAM,KAAK,OAAO,IAAI,IAAI;AAM1C,SAAO,UAAU,IAAI,IAAI;CACzB;AACD;;;;;;;;;;;;AAaD,MAAaG,mBAAgC;CAC5C,QAAQ;CACR,QAAQ,CAAC,QAAQ,IAAI,WAAW,UAAU,IAAI;AAC9C;;AAGD,MAAaC,oBAAiC;CAC7C,QAAQ;CACR,QAAQ,CAAC,QAAQ,IAAI,WAAW,UAAU,IAAI;AAC9C;AAED,MAAM,0BAAU,IAAI;AAEpB,SAAS,UAAUC,KAAoB;CACtC,MAAM,WAAW,QAAQ,IAAI,IAAI;AACjC,KAAI,SAAU,QAAO;CAErB,MAAM,SAAS,IAAI,MAAM,KAAK;EAI7B,sBAAsB;EACtB,oBAAoB;CACpB;AAED,SAAQ,IAAI,KAAK,OAAO;AAExB,QAAO;AACP"}
+{"version":3,"file":"redis.mjs","names":[],"sources":["../src/redis.ts"],"sourcesContent":["/**\n * A cache over the Redis wire protocol — ElastiCache, Valkey, or a Redis you run.\n *\n * The sibling of the Upstash client rather than a replacement for it. Upstash\n * speaks HTTP, which is what makes it reachable from a Lambda with no VPC and\n * no connection pool; this speaks the wire protocol, which is what ElastiCache\n * offers and what a container next to your app is cheapest on.\n *\n * Choosing one is a deployment decision, and the local target follows it: pick\n * `elasticache` and dev runs plain Redis, pick `upstash` and dev runs the HTTP\n * proxy in front of it. Either way dev and prod speak the same protocol, which\n * is the property that matters — a cache that behaves differently in the two\n * places is worse than a slower one.\n */\n\nimport { Redis } from 'ioredis';\nimport type { Cache } from './index';\nimport type { CacheDriver } from './registry';\nimport { traceCache } from './telemetry';\n\nexport class RedisCache implements Cache {\n\tconstructor(private readonly client: Redis) {}\n\n\tasync get<T>(key: string): Promise<T | undefined> {\n\t\treturn traceCache('redis', 'get', async () => {\n\t\t\tconst value = await this.client.get(key);\n\t\t\tif (value === null) return undefined;\n\n\t\t\ttry {\n\t\t\t\treturn JSON.parse(value) as T;\n\t\t\t} catch {\n\t\t\t\t// Written by something that did not go through `set`. Returning the\n\t\t\t\t// raw string is more useful than throwing on a value somebody put\n\t\t\t\t// there on purpose.\n\t\t\t\treturn value as unknown as T;\n\t\t\t}\n\t\t});\n\t}\n\n\tasync set<T>(key: string, value: T, ttl?: number): Promise<void> {\n\t\treturn traceCache('redis', 'set', async () => {\n\t\t\tconst encoded = JSON.stringify(value);\n\n\t\t\tif (ttl === undefined) {\n\t\t\t\tawait this.client.set(key, encoded);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tawait this.client.set(key, encoded, 'EX', ttl);\n\t\t});\n\t}\n\n\tasync delete(key: string): Promise<void> {\n\t\treturn traceCache('redis', 'delete', async () => {\n\t\t\tawait this.client.del(key);\n\t\t});\n\t}\n\n\tasync ttl(key: string): Promise<number> {\n\t\tconst seconds = await this.client.ttl(key);\n\n\t\t// Redis reports -2 for a key that does not exist and -1 for one with no\n\t\t// expiry. The interface says zero for a missing key, and \"never expires\"\n\t\t// has no time left to report either — so both become zero rather than\n\t\t// leaking sentinel values a caller would have to know about.\n\t\treturn seconds < 0 ? 0 : seconds;\n\t}\n}\n\n/**\n * The `redis://` and `rediss://` driver.\n *\n * One client per URL for the life of the process — a Redis connection is a\n * socket, and opening one per cache call is the thing that makes people\n * conclude a cache is not worth having.\n *\n * `ioredis` is imported at the top of this module because the *module* is the\n * lazy boundary: an app caching in Postgres never imports\n * `@geekmidas/cache/redis`, and so never resolves it.\n */\nexport const redisCacheDriver: CacheDriver = {\n\tscheme: 'redis:',\n\tcreate: (url) => new RedisCache(clientFor(url)),\n};\n\n/** The TLS form. ElastiCache Serverless requires it; the same client handles both. */\nexport const redissCacheDriver: CacheDriver = {\n\tscheme: 'rediss:',\n\tcreate: (url) => new RedisCache(clientFor(url)),\n};\n\nconst clients = new Map<string, Redis>();\n\nfunction clientFor(url: string): Redis {\n\tconst existing = clients.get(url);\n\tif (existing) return existing;\n\n\tconst client = new Redis(url, {\n\t\t// A cache miss is recoverable and a hung request is not. Failing fast and\n\t\t// letting the caller treat it as a miss is the behaviour a cache should\n\t\t// have; retrying forever turns a degraded cache into a degraded app.\n\t\t//\n\t\t// The offline queue stays on: the socket connects after the constructor\n\t\t// returns, so without it the first command of every fresh client — every\n\t\t// cold start — is rejected before the connection has had a chance. The\n\t\t// retry bound above is what keeps a queued command from waiting forever.\n\t\tmaxRetriesPerRequest: 2,\n\t});\n\n\tclients.set(url, client);\n\n\treturn client;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,IAAa,aAAb,MAAyC;CACX;CAA7B,YAAY,QAAgC;EAAf,KAAA,SAAA;CAAgB;CAE7C,MAAM,IAAO,KAAqC;EACjD,OAAO,WAAW,SAAS,OAAO,YAAY;GAC7C,MAAM,QAAQ,MAAM,KAAK,OAAO,IAAI,GAAG;GACvC,IAAI,UAAU,MAAM,OAAO,KAAA;GAE3B,IAAI;IACH,OAAO,KAAK,MAAM,KAAK;GACxB,QAAQ;IAIP,OAAO;GACR;EACD,CAAC;CACF;CAEA,MAAM,IAAO,KAAa,OAAU,KAA6B;EAChE,OAAO,WAAW,SAAS,OAAO,YAAY;GAC7C,MAAM,UAAU,KAAK,UAAU,KAAK;GAEpC,IAAI,QAAQ,KAAA,GAAW;IACtB,MAAM,KAAK,OAAO,IAAI,KAAK,OAAO;IAClC;GACD;GAEA,MAAM,KAAK,OAAO,IAAI,KAAK,SAAS,MAAM,GAAG;EAC9C,CAAC;CACF;CAEA,MAAM,OAAO,KAA4B;EACxC,OAAO,WAAW,SAAS,UAAU,YAAY;GAChD,MAAM,KAAK,OAAO,IAAI,GAAG;EAC1B,CAAC;CACF;CAEA,MAAM,IAAI,KAA8B;EACvC,MAAM,UAAU,MAAM,KAAK,OAAO,IAAI,GAAG;EAMzC,OAAO,UAAU,IAAI,IAAI;CAC1B;AACD;;;;;;;;;;;;AAaA,MAAa,mBAAgC;CAC5C,QAAQ;CACR,SAAS,QAAQ,IAAI,WAAW,UAAU,GAAG,CAAC;AAC/C;;AAGA,MAAa,oBAAiC;CAC7C,QAAQ;CACR,SAAS,QAAQ,IAAI,WAAW,UAAU,GAAG,CAAC;AAC/C;AAEA,MAAM,0BAAU,IAAI,IAAmB;AAEvC,SAAS,UAAU,KAAoB;CACtC,MAAM,WAAW,QAAQ,IAAI,GAAG;CAChC,IAAI,UAAU,OAAO;CAErB,MAAM,SAAS,IAAI,MAAM,KAAK,EAS7B,sBAAsB,EACvB,CAAC;CAED,QAAQ,IAAI,KAAK,MAAM;CAEvB,OAAO;AACR"}

package/dist/registry.cjs

@@ -1,6 +1,48 @@
-const require_registry = require('./registry-CITg73zW.cjs');
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#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 {
+	url;
+	scheme;
+	registered;
+	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
+exports.UnregisteredCacheScheme = UnregisteredCacheScheme;
+exports.createCacheClient = createCacheClient;
+exports.registerCacheDriver = registerCacheDriver;
+exports.registeredCacheSchemes = registeredCacheSchemes;
 
-exports.UnregisteredCacheScheme = require_registry.UnregisteredCacheScheme;
-exports.createCacheClient = require_registry.createCacheClient;
-exports.registerCacheDriver = require_registry.registerCacheDriver;
-exports.registeredCacheSchemes = require_registry.registeredCacheSchemes;
+//# sourceMappingURL=registry.cjs.map

package/dist/registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.cjs","names":[],"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,IAAyB;;AAG7C,SAAgB,oBAAoB,QAA2B;CAC9D,QAAQ,IAAI,OAAO,QAAQ,MAAM;AAClC;;AAGA,SAAgB,yBAAmC;CAClD,OAAO,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,KAAK;AACjC;;;;;;;;AASA,SAAgB,kBAAkB,KAAoB;CACrD,MAAM,SAAS,SAAS,GAAG;CAC3B,MAAM,SAAS,QAAQ,IAAI,MAAM;CAEjC,IAAI,CAAC,QACJ,MAAM,IAAI,wBAAwB,KAAK,QAAQ,uBAAuB,CAAC;CAGxE,OAAO,OAAO,OAAO,GAAG;AACzB;;AAGA,IAAa,0BAAb,cAA6C,MAAM;CAExC;CACA;CACA;CAHV,YACC,KACA,QACA,YACC;EACD,MACC,4BAA4B,OAAO,QACjC,WAAW,SACT,eAAe,WAAW,KAAK,IAAI,EAAE,KACrC,4BACH,wHAEF;EAXS,KAAA,MAAA;EACA,KAAA,SAAA;EACA,KAAA,aAAA;EAUT,KAAK,OAAO;CACb;AACD;AAEA,SAAS,SAAS,KAAqB;CACtC,MAAM,YAAY,IAAI,QAAQ,GAAG;CACjC,OAAO,cAAc,KAAK,KAAK,IAAI,MAAM,GAAG,YAAY,CAAC;AAC1D"}

package/dist/registry.d.cts

@@ -1,2 +1,2 @@
-import { CacheDriver, UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes } from "./index-CNQ50bVk.cjs";
+import { a as createCacheClient, i as UnregisteredCacheScheme, o as registerCacheDriver, r as CacheDriver, s as registeredCacheSchemes } from "./index-BbdGhmWP.cjs";
 export { CacheDriver, UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes };

package/dist/registry.d.mts

@@ -1,2 +1,2 @@
-import { CacheDriver, UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes } from "./index-1sNRIo6N.mjs";
+import { a as createCacheClient, i as UnregisteredCacheScheme, o as registerCacheDriver, r as CacheDriver, s as registeredCacheSchemes } from "./index-BbdGhmWP.mjs";
 export { CacheDriver, UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes };

package/dist/registry.mjs

@@ -1,3 +1,44 @@
-import { UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes } from "./registry-CT0b-rjB.mjs";
+//#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 {
+	url;
+	scheme;
+	registered;
+	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 };
 
-export { UnregisteredCacheScheme, createCacheClient, registerCacheDriver, registeredCacheSchemes };
+//# sourceMappingURL=registry.mjs.map

package/dist/registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.mjs","names":[],"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,IAAyB;;AAG7C,SAAgB,oBAAoB,QAA2B;CAC9D,QAAQ,IAAI,OAAO,QAAQ,MAAM;AAClC;;AAGA,SAAgB,yBAAmC;CAClD,OAAO,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,KAAK;AACjC;;;;;;;;AASA,SAAgB,kBAAkB,KAAoB;CACrD,MAAM,SAAS,SAAS,GAAG;CAC3B,MAAM,SAAS,QAAQ,IAAI,MAAM;CAEjC,IAAI,CAAC,QACJ,MAAM,IAAI,wBAAwB,KAAK,QAAQ,uBAAuB,CAAC;CAGxE,OAAO,OAAO,OAAO,GAAG;AACzB;;AAGA,IAAa,0BAAb,cAA6C,MAAM;CAExC;CACA;CACA;CAHV,YACC,KACA,QACA,YACC;EACD,MACC,4BAA4B,OAAO,QACjC,WAAW,SACT,eAAe,WAAW,KAAK,IAAI,EAAE,KACrC,4BACH,wHAEF;EAXS,KAAA,MAAA;EACA,KAAA,SAAA;EACA,KAAA,aAAA;EAUT,KAAK,OAAO;CACb;AACD;AAEA,SAAS,SAAS,KAAqB;CACtC,MAAM,YAAY,IAAI,QAAQ,GAAG;CACjC,OAAO,cAAc,KAAK,KAAK,IAAI,MAAM,GAAG,YAAY,CAAC;AAC1D"}

package/dist/{chunk-CUT6urMc.cjs → rolldown-runtime-VH7oDXx4.cjs}

@@ -1,4 +1,4 @@
-//#region rolldown:runtime
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -15,16 +15,14 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
-
 //#endregion
-
-Object.defineProperty(exports, '__toESM', {
-  enumerable: true,
-  get: function () {
-    return __toESM;
-  }
-});
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});

package/dist/telemetry.cjs

@@ -0,0 +1,38 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _opentelemetry_api = require("@opentelemetry/api");
+//#region src/telemetry.ts
+/**
+* A span per cache call, through the global OpenTelemetry tracer — a no-op
+* without a registered provider.
+*
+* `cache.get`, `cache.set` and `cache.delete`, each with the backend as
+* `db.system` and, on a read, whether it hit. Never the key or the value: a key
+* often names a user, and a value is whatever was cached.
+*
+* @module
+*/
+/** Run `fn` inside a `cache.<operation>` span for a backend. */
+async function traceCache(system, operation, fn) {
+	const span = _opentelemetry_api.trace.getTracer("@geekmidas/cache").startSpan(`cache.${operation}`, {
+		kind: _opentelemetry_api.SpanKind.CLIENT,
+		attributes: {
+			"db.system": system,
+			"cache.operation": operation
+		}
+	});
+	try {
+		const result = await fn();
+		if (operation === "get") span.setAttribute("cache.hit", result !== void 0);
+		return result;
+	} catch (error) {
+		if (error instanceof Error) span.recordException(error);
+		span.setStatus({ code: _opentelemetry_api.SpanStatusCode.ERROR });
+		throw error;
+	} finally {
+		span.end();
+	}
+}
+//#endregion
+exports.traceCache = traceCache;
+
+//# sourceMappingURL=telemetry.cjs.map

package/dist/telemetry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.cjs","names":["trace","SpanKind","SpanStatusCode"],"sources":["../src/telemetry.ts"],"sourcesContent":["/**\n * A span per cache call, through the global OpenTelemetry tracer — a no-op\n * without a registered provider.\n *\n * `cache.get`, `cache.set` and `cache.delete`, each with the backend as\n * `db.system` and, on a read, whether it hit. Never the key or the value: a key\n * often names a user, and a value is whatever was cached.\n *\n * @module\n */\nimport { SpanKind, SpanStatusCode, trace } from '@opentelemetry/api';\n\nexport type CacheOperation = 'get' | 'set' | 'delete';\n\n/** Run `fn` inside a `cache.<operation>` span for a backend. */\nexport async function traceCache<T>(\n\tsystem: string,\n\toperation: CacheOperation,\n\tfn: () => Promise<T>,\n): Promise<T> {\n\tconst span = trace\n\t\t.getTracer('@geekmidas/cache')\n\t\t.startSpan(`cache.${operation}`, {\n\t\t\tkind: SpanKind.CLIENT,\n\t\t\tattributes: { 'db.system': system, 'cache.operation': operation },\n\t\t});\n\ttry {\n\t\tconst result = await fn();\n\t\tif (operation === 'get')\n\t\t\tspan.setAttribute('cache.hit', result !== undefined);\n\t\treturn result;\n\t} catch (error) {\n\t\tif (error instanceof Error) span.recordException(error);\n\t\tspan.setStatus({ code: SpanStatusCode.ERROR });\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,eAAsB,WACrB,QACA,WACA,IACa;CACb,MAAM,OAAOA,mBAAAA,MACX,UAAU,kBAAkB,CAAC,CAC7B,UAAU,SAAS,aAAa;EAChC,MAAMC,mBAAAA,SAAS;EACf,YAAY;GAAE,aAAa;GAAQ,mBAAmB;EAAU;CACjE,CAAC;CACF,IAAI;EACH,MAAM,SAAS,MAAM,GAAG;EACxB,IAAI,cAAc,OACjB,KAAK,aAAa,aAAa,WAAW,KAAA,CAAS;EACpD,OAAO;CACR,SAAS,OAAO;EACf,IAAI,iBAAiB,OAAO,KAAK,gBAAgB,KAAK;EACtD,KAAK,UAAU,EAAE,MAAMC,mBAAAA,eAAe,MAAM,CAAC;EAC7C,MAAM;CACP,UAAU;EACT,KAAK,IAAI;CACV;AACD"}

package/dist/telemetry.d.cts

@@ -0,0 +1,6 @@
+//#region src/telemetry.d.ts
+export type CacheOperation = 'get' | 'set' | 'delete';
+/** Run `fn` inside a `cache.<operation>` span for a backend. */
+export declare function traceCache<T>(system: string, operation: CacheOperation, fn: () => Promise<T>): Promise<T>;
+//#endregion
+//# sourceMappingURL=telemetry.d.cts.map

package/dist/telemetry.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.cts","names":[],"sources":["../src/telemetry.ts"],"mappings":";YAYY;;wBAGU,WAAW,GAChC,gBACA,WAAW,gBACX,UAAU,QAAQ,KAChB,QAAQ"}

package/dist/telemetry.d.mts

@@ -0,0 +1,6 @@
+//#region src/telemetry.d.ts
+export type CacheOperation = 'get' | 'set' | 'delete';
+/** Run `fn` inside a `cache.<operation>` span for a backend. */
+export declare function traceCache<T>(system: string, operation: CacheOperation, fn: () => Promise<T>): Promise<T>;
+//#endregion
+//# sourceMappingURL=telemetry.d.mts.map

package/dist/telemetry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.mts","names":[],"sources":["../src/telemetry.ts"],"mappings":";YAYY;;wBAGU,WAAW,GAChC,gBACA,WAAW,gBACX,UAAU,QAAQ,KAChB,QAAQ"}

package/dist/telemetry.mjs

@@ -0,0 +1,37 @@
+import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
+//#region src/telemetry.ts
+/**
+* A span per cache call, through the global OpenTelemetry tracer — a no-op
+* without a registered provider.
+*
+* `cache.get`, `cache.set` and `cache.delete`, each with the backend as
+* `db.system` and, on a read, whether it hit. Never the key or the value: a key
+* often names a user, and a value is whatever was cached.
+*
+* @module
+*/
+/** Run `fn` inside a `cache.<operation>` span for a backend. */
+async function traceCache(system, operation, fn) {
+	const span = trace.getTracer("@geekmidas/cache").startSpan(`cache.${operation}`, {
+		kind: SpanKind.CLIENT,
+		attributes: {
+			"db.system": system,
+			"cache.operation": operation
+		}
+	});
+	try {
+		const result = await fn();
+		if (operation === "get") span.setAttribute("cache.hit", result !== void 0);
+		return result;
+	} catch (error) {
+		if (error instanceof Error) span.recordException(error);
+		span.setStatus({ code: SpanStatusCode.ERROR });
+		throw error;
+	} finally {
+		span.end();
+	}
+}
+//#endregion
+export { traceCache };
+
+//# sourceMappingURL=telemetry.mjs.map

package/dist/telemetry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.mjs","names":[],"sources":["../src/telemetry.ts"],"sourcesContent":["/**\n * A span per cache call, through the global OpenTelemetry tracer — a no-op\n * without a registered provider.\n *\n * `cache.get`, `cache.set` and `cache.delete`, each with the backend as\n * `db.system` and, on a read, whether it hit. Never the key or the value: a key\n * often names a user, and a value is whatever was cached.\n *\n * @module\n */\nimport { SpanKind, SpanStatusCode, trace } from '@opentelemetry/api';\n\nexport type CacheOperation = 'get' | 'set' | 'delete';\n\n/** Run `fn` inside a `cache.<operation>` span for a backend. */\nexport async function traceCache<T>(\n\tsystem: string,\n\toperation: CacheOperation,\n\tfn: () => Promise<T>,\n): Promise<T> {\n\tconst span = trace\n\t\t.getTracer('@geekmidas/cache')\n\t\t.startSpan(`cache.${operation}`, {\n\t\t\tkind: SpanKind.CLIENT,\n\t\t\tattributes: { 'db.system': system, 'cache.operation': operation },\n\t\t});\n\ttry {\n\t\tconst result = await fn();\n\t\tif (operation === 'get')\n\t\t\tspan.setAttribute('cache.hit', result !== undefined);\n\t\treturn result;\n\t} catch (error) {\n\t\tif (error instanceof Error) span.recordException(error);\n\t\tspan.setStatus({ code: SpanStatusCode.ERROR });\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,eAAsB,WACrB,QACA,WACA,IACa;CACb,MAAM,OAAO,MACX,UAAU,kBAAkB,CAAC,CAC7B,UAAU,SAAS,aAAa;EAChC,MAAM,SAAS;EACf,YAAY;GAAE,aAAa;GAAQ,mBAAmB;EAAU;CACjE,CAAC;CACF,IAAI;EACH,MAAM,SAAS,MAAM,GAAG;EACxB,IAAI,cAAc,OACjB,KAAK,aAAa,aAAa,WAAW,KAAA,CAAS;EACpD,OAAO;CACR,SAAS,OAAO;EACf,IAAI,iBAAiB,OAAO,KAAK,gBAAgB,KAAK;EACtD,KAAK,UAAU,EAAE,MAAM,eAAe,MAAM,CAAC;EAC7C,MAAM;CACP,UAAU;EACT,KAAK,IAAI;CACV;AACD"}

package/dist/upstash.cjs

@@ -1,11 +1,10 @@
-const require_chunk = require('./chunk-CUT6urMc.cjs');
-const __upstash_redis = require_chunk.__toESM(require("@upstash/redis"));
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _upstash_redis = require("@upstash/redis");
 //#region src/upstash.ts
 var UpstashCache = class {
 	client;
 	constructor(url, token) {
-		this.client = new __upstash_redis.Redis({
+		this.client = new _upstash_redis.Redis({
 			url,
 			token
 		});
@@ -17,7 +16,7 @@ var UpstashCache = class {
 	}
 	async get(key) {
 		const v = await this.client.get(key);
-		if (v === null) return void 0;
+		if (v === null) return;
 		return v;
 	}
 	async set(key, value, ttl = 3600) {
@@ -65,10 +64,10 @@ function parseUpstashUrl(url) {
 		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","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"}
+{"version":3,"file":"upstash.cjs","names":["Redis"],"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;CAEA,YAAY,KAAa,OAAe;EACvC,KAAK,SAAS,IAAIA,eAAAA,MAAM;GACvB;GACA;EACD,CAAC;CACF;CAEA,MAAM,IAAI,KAA8B;EACvC,MAAM,MAAM,MAAM,KAAK,OAAO,IAAI,GAAG;EAErC,IAAI,QAAQ,IACX,OAAO;EAGR,OAAO;CACR;CAEA,MAAM,IAAO,KAAqC;EACjD,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,GAAG;EAEnC,IAAI,MAAM,MACT;EAGD,OAAO;CACR;CAEA,MAAM,IAAO,KAAa,OAAU,MAAM,MAAqB;EAC9D,MAAM,KAAK,OAAO,IAAI,KAAK,OAAO,EAAE,IAAI,IAAI,CAAC;CAC9C;CAEA,MAAM,OAAO,KAA4B;EACxC,MAAM,KAAK,OAAO,IAAI,GAAG;CAC1B;AACD;;;;;;;;;;AAWA,MAAa,qBAAkC;CAC9C,QAAQ;CACR,SAAS,QAAQ;EAChB,MAAM,EAAE,UAAU,UAAU,gBAAgB,GAAG;EAC/C,OAAO,IAAI,aAAa,UAAU,KAAK;CACxC;AACD;;AAGA,MAAa,6BAA0C;CACtD,GAAG;CACH,QAAQ;AACT;;;;;;;;AAeA,SAAgB,gBAAgB,KAA6B;CAC5D,MAAM,SAAS,IAAI,IAAI,GAAG;CAC1B,MAAM,QAAQ,mBAAmB,OAAO,YAAY,OAAO,QAAQ;CAEnE,OAAO,WAAW;CAClB,OAAO,WAAW;CAElB,OAAO;EAGN,UAAU,OAAO;EACjB;CACD;AACD"}

package/dist/upstash.d.cts

@@ -1,7 +1,6 @@
-import { Cache, CacheDriver } from "./index-CNQ50bVk.cjs";
-
+import { r as CacheDriver, t as Cache } from "./index-BbdGhmWP.cjs";
 //#region src/upstash.d.ts
-declare class UpstashCache implements Cache {
+export declare class UpstashCache implements Cache {
   private client;
   constructor(url: string, token: string);
   ttl(key: string): Promise<number>;
@@ -18,11 +17,11 @@ declare class UpstashCache implements Cache {
  * 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;
+export declare const upstashCacheDriver: CacheDriver;
 /** The same driver for plain HTTP, which is what the local proxy speaks. */
-declare const upstashInsecureCacheDriver: CacheDriver;
+export declare const upstashInsecureCacheDriver: CacheDriver;
 /** What an Upstash cache URL addresses: an HTTP endpoint and the token for it. */
-interface UpstashAddress {
+export interface UpstashAddress {
   endpoint: string;
   token: string;
 }
@@ -33,8 +32,6 @@ interface UpstashAddress {
  * 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
+export declare function parseUpstashUrl(url: string): UpstashAddress;
 //#endregion
-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":";;;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"}
+{"version":3,"file":"upstash.d.cts","names":[],"sources":["../src/upstash.ts"],"mappings":";;qBAIa,wBAAwB;UAC5B;EAER,YAAY,aAAa;EAOnB,IAAI,cAAc;EAUlB,IAAI,GAAG,cAAc,QAAQ;EAU7B,IAAI,GAAG,aAAa,OAAO,GAAG,eAAa;EAI3C,OAAO,cAAc;;;;;;;;;;;qBAcf,oBAAoB;;qBASpB,4BAA4B;;iBAMxB;EAChB;EACA;;;;;;;;;wBAUe,gBAAgB,cAAc"}

package/dist/upstash.d.mts

@@ -1,7 +1,6 @@
-import { Cache, CacheDriver } from "./index-1sNRIo6N.mjs";
-
+import { r as CacheDriver, t as Cache } from "./index-BbdGhmWP.mjs";
 //#region src/upstash.d.ts
-declare class UpstashCache implements Cache {
+export declare class UpstashCache implements Cache {
   private client;
   constructor(url: string, token: string);
   ttl(key: string): Promise<number>;
@@ -18,11 +17,11 @@ declare class UpstashCache implements Cache {
  * 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;
+export declare const upstashCacheDriver: CacheDriver;
 /** The same driver for plain HTTP, which is what the local proxy speaks. */
-declare const upstashInsecureCacheDriver: CacheDriver;
+export declare const upstashInsecureCacheDriver: CacheDriver;
 /** What an Upstash cache URL addresses: an HTTP endpoint and the token for it. */
-interface UpstashAddress {
+export interface UpstashAddress {
   endpoint: string;
   token: string;
 }
@@ -33,8 +32,6 @@ interface UpstashAddress {
  * 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
+export declare function parseUpstashUrl(url: string): UpstashAddress;
 //#endregion
-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":";;;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"}
+{"version":3,"file":"upstash.d.mts","names":[],"sources":["../src/upstash.ts"],"mappings":";;qBAIa,wBAAwB;UAC5B;EAER,YAAY,aAAa;EAOnB,IAAI,cAAc;EAUlB,IAAI,GAAG,cAAc,QAAQ;EAU7B,IAAI,GAAG,aAAa,OAAO,GAAG,eAAa;EAI3C,OAAO,cAAc;;;;;;;;;;;qBAcf,oBAAoB;;qBASpB,4BAA4B;;iBAMxB;EAChB;EACA;;;;;;;;;wBAUe,gBAAgB,cAAc"}

package/dist/upstash.mjs

@@ -1,5 +1,4 @@
 import { Redis } from "@upstash/redis";
-
 //#region src/upstash.ts
 var UpstashCache = class {
 	client;
@@ -16,7 +15,7 @@ var UpstashCache = class {
 	}
 	async get(key) {
 		const v = await this.client.get(key);
-		if (v === null) return void 0;
+		if (v === null) return;
 		return v;
 	}
 	async set(key, value, ttl = 3600) {
@@ -64,7 +63,7 @@ function parseUpstashUrl(url) {
 		token
 	};
 }
-
 //#endregion
 export { UpstashCache, parseUpstashUrl, upstashCacheDriver, upstashInsecureCacheDriver };
+
 //# sourceMappingURL=upstash.mjs.map