webcake-storefront-mcp 1.0.3 → 1.1.1

package/dist/persistence/redis.js

@@ -0,0 +1,66 @@
+/**
+ * Lazy, shared ioredis client used as a SHORT-TTL CACHE for OAuth access-token
+ * lookups (access_token → {jwt,wsid}). Returns null when no REDIS_URL is
+ * configured OR ioredis isn't installed — every caller then falls back to going
+ * directly to Postgres (or the in-memory map), so stdio/`npx` users and the
+ * offline `npm run smoke` gate keep working with ZERO infra.
+ *
+ * The cache is intentionally disposable: losing Redis (restart, eviction,
+ * expiry) just adds one Postgres round-trip per /mcp request — never a failure.
+ * We never block startup on the connection and tolerate command errors by
+ * degrading to the source-of-truth store on a per-call basis.
+ *
+ * ioredis is an OPTIONAL, CJS dependency (see package.json), so we require it via
+ * createRequire under ESM/Node16. `new Redis(url)` returns immediately and
+ * connects in the background; commands queue until the socket is up.
+ *
+ * Configure with REDIS_URL (or WEBCAKE_REDIS_URL), e.g. redis://default:pw@host:6379/0
+ */
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+let cached; // undefined = not yet resolved
+function redactUrl(u) {
+    try {
+        const x = new URL(u);
+        if (x.password)
+            x.password = "***";
+        return x.toString();
+    }
+    catch {
+        return "redis";
+    }
+}
+/**
+ * Returns the shared Redis client, or null if Redis isn't configured/available.
+ * Memoized: resolves the connection (or its absence) exactly once per process.
+ */
+export function getRedis() {
+    if (cached !== undefined)
+        return cached;
+    const url = process.env.REDIS_URL || process.env.WEBCAKE_REDIS_URL;
+    if (!url)
+        return (cached = null);
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const mod = require("ioredis");
+        const Redis = mod.default ?? mod;
+        const client = new Redis(url, {
+            maxRetriesPerRequest: 2,
+            enableOfflineQueue: true,
+            // Never let a connection blip crash the process — log and keep retrying.
+            retryStrategy: (times) => Math.min(times * 200, 3000),
+        });
+        client.on("error", (e) => console.error("[redis] error:", e?.message ?? e));
+        console.error(`[redis] OAuth token cache: ${redactUrl(url)}`);
+        cached = client;
+    }
+    catch (e) {
+        console.error("[redis] unavailable, using direct store lookups:", e?.message ?? e);
+        cached = null;
+    }
+    return cached;
+}
+/** True when a Redis cache backend is configured (used for log/diagnostics). */
+export function redisEnabled() {
+    return getRedis() !== null;
+}