@frontmcp/plugin-remember 1.8.7 → 1.9.1-rc.1

package/esm/index.mjs

@@ -1,3 +1,6 @@
+var __frontmcpModule = typeof process !== "undefined" && typeof process.getBuiltinModule === "function" ? process.getBuiltinModule("module") : undefined;
+const require = __frontmcpModule ? __frontmcpModule.createRequire(import.meta.url || 'file:///') : undefined;
+// __frontmcpCreateRequire
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -405,6 +408,9 @@ var STORAGE_LAYOUT_VERSION = "v2";
 function encodeKeyPart(value) {
   return encodeURIComponent(value);
 }
+function remainingSeconds(expiresAt, now) {
+  return Math.max(1, Math.ceil((expiresAt - now) / 1e3));
+}
 var RememberAccessor = class {
   store;
   ctx;
@@ -454,16 +460,8 @@ var RememberAccessor = class {
    */
   async get(key, options = {}) {
     const scope = options.scope ?? "session";
-    const storageKey = this.buildStorageKey(key, scope);
-    const raw = await this.store.getValue(storageKey);
-    if (!raw) return options.defaultValue;
-    const entry = this.encryptionEnabled ? await deserializeAndDecrypt(raw, this.getKeySource(scope)) : this.parseEntry(raw);
-    if (!entry) return options.defaultValue;
-    if (entry.expiresAt && Date.now() > entry.expiresAt) {
-      await this.forget(key, { scope });
-      return options.defaultValue;
-    }
-    return entry.value;
+    const entry = await this.readEntry(this.buildStorageKey(key, scope), scope);
+    return entry ? entry.value : options.defaultValue;
   }
   /**
    * Get the full entry including metadata.
@@ -474,16 +472,7 @@ var RememberAccessor = class {
    */
   async getEntry(key, options = {}) {
     const scope = options.scope ?? "session";
-    const storageKey = this.buildStorageKey(key, scope);
-    const raw = await this.store.getValue(storageKey);
-    if (!raw) return void 0;
-    const entry = this.encryptionEnabled ? await deserializeAndDecrypt(raw, this.getKeySource(scope)) : this.parseEntry(raw);
-    if (!entry) return void 0;
-    if (entry.expiresAt && Date.now() > entry.expiresAt) {
-      await this.forget(key, { scope });
-      return void 0;
-    }
-    return entry;
+    return this.readEntry(this.buildStorageKey(key, scope), scope);
   }
   /**
    * Forget (delete) a value from memory.
@@ -497,19 +486,18 @@ var RememberAccessor = class {
     await this.store.delete(storageKey);
   }
   /**
-   * Check if a key is remembered (exists and not expired).
+   * Check if a key is remembered: true exactly when `get()` would return its value.
    *
    * @param key - The key to check
    * @param options - Options (scope)
-   * @returns true if the key exists
+   * @returns true if the key exists and has not expired
    */
   async knows(key, options = {}) {
     const scope = options.scope ?? "session";
-    const storageKey = this.buildStorageKey(key, scope);
-    return this.store.exists(storageKey);
+    return await this.readEntry(this.buildStorageKey(key, scope), scope) !== void 0;
   }
   /**
-   * List all remembered keys for a scope.
+   * List all remembered keys for a scope: the keys `get()` would return a value for.
    *
    * @param options - Options (scope, pattern)
    * @returns Array of keys (without the scope prefix)
@@ -517,13 +505,16 @@ var RememberAccessor = class {
   async list(options = {}) {
     const scope = options.scope ?? "session";
     const scopePrefix = this.buildScopePrefix(scope);
-    const fullPattern = scopePrefix + (options.pattern ?? "*");
-    const keys = await this.store.keys(fullPattern);
-    return keys.map((k) => k.slice(scopePrefix.length));
+    const storageKeys = await this.store.keys(scopePrefix + (options.pattern ?? "*"));
+    const entries = await Promise.all(storageKeys.map((storageKey) => this.readEntry(storageKey, scope)));
+    return storageKeys.filter((_storageKey, index) => entries[index] !== void 0).map((storageKey) => storageKey.slice(scopePrefix.length));
   }
   /**
    * Update an existing entry's value while preserving metadata.
    *
+   * With a `ttl` the entry expires that many seconds from now; without one it keeps its current
+   * expiry, in the store as well, so the store does not keep it past that (rounded up to a second).
+   *
    * @param key - The key to update
    * @param value - The new value
    * @param options - Options (scope, ttl)
@@ -532,15 +523,18 @@ var RememberAccessor = class {
     const scope = options.scope ?? "session";
     const existing = await this.getEntry(key, { scope });
     if (!existing) return false;
+    const now = Date.now();
+    const expiresAt = options.ttl ? now + options.ttl * 1e3 : existing.expiresAt;
     const entry = {
       ...existing,
       value,
-      updatedAt: Date.now(),
-      expiresAt: options.ttl ? Date.now() + options.ttl * 1e3 : existing.expiresAt
+      updatedAt: now,
+      expiresAt
     };
     const storageKey = this.buildStorageKey(key, scope);
     const serialized = this.encryptionEnabled ? await encryptAndSerialize(entry, this.getKeySource(scope)) : JSON.stringify(entry);
-    await this.store.setValue(storageKey, serialized, options.ttl);
+    const storageTtl = options.ttl ?? (expiresAt !== void 0 ? remainingSeconds(expiresAt, now) : void 0);
+    await this.store.setValue(storageKey, serialized, storageTtl);
     return true;
   }
   // ─────────────────────────────────────────────────────────────────────────────
@@ -658,6 +652,19 @@ var RememberAccessor = class {
       toolName: scope === "tool" ? this.toolName : void 0
     });
   }
+  /** The entry stored under `storageKey`, if readable and unexpired; an expired one is deleted. */
+  async readEntry(storageKey, scope) {
+    const stored = await this.store.getValue(storageKey);
+    if (!stored) return void 0;
+    const raw = typeof stored === "string" ? stored : JSON.stringify(stored);
+    const entry = this.encryptionEnabled ? await deserializeAndDecrypt(raw, this.getKeySource(scope)) : this.parseEntry(raw);
+    if (!entry) return void 0;
+    if (entry.expiresAt && Date.now() > entry.expiresAt) {
+      await this.store.delete(storageKey);
+      return void 0;
+    }
+    return entry;
+  }
   /**
    * Parse a JSON entry (when encryption is disabled).
    */
@@ -907,7 +914,7 @@ var RememberRedisProvider = class {
       }
     }
     const fullKey = this.keyPrefix + key;
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     if (ttlSeconds !== void 0 && ttlSeconds > 0) {
       await this.client.set(fullKey, strValue, "EX", ttlSeconds);
     } else {
@@ -922,7 +929,7 @@ var RememberRedisProvider = class {
    */
   async setIfAbsent(key, value, ttlSeconds) {
     const fullKey = this.keyPrefix + key;
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     const result = ttlSeconds !== void 0 && ttlSeconds > 0 ? await this.client.set(fullKey, strValue, "EX", ttlSeconds, "NX") : await this.client.set(fullKey, strValue, "NX");
     return result === "OK";
   }
@@ -999,8 +1006,11 @@ RememberRedisProvider = __decorateClass([
 
 // plugins/plugin-remember/src/providers/remember-vercel-kv.provider.ts
 import { Provider as Provider4, ProviderScope as ProviderScope4 } from "@frontmcp/sdk";
+import { getEnv } from "@frontmcp/utils";
 var RememberVercelKvProvider = class {
-  kv;
+  createClient;
+  connection;
+  client;
   keyPrefix;
   defaultTTL;
   constructor(options = {}) {
@@ -1012,17 +1022,23 @@ var RememberVercelKvProvider = class {
         `RememberVercelKvProvider: Both 'url' and 'token' must be provided together, or neither. Received: url=${hasUrl ? "provided" : "missing"}, token=${hasToken ? "provided" : "missing"}`
       );
     }
-    if (options.url && options.token) {
-      this.kv = vercelKv.createClient({
-        url: options.url,
-        token: options.token
-      });
-    } else {
-      this.kv = vercelKv.kv;
-    }
+    this.createClient = vercelKv.createClient;
+    this.connection = { url: options.url, token: options.token };
     this.keyPrefix = options.keyPrefix ?? "remember:";
     this.defaultTTL = options.defaultTTL;
   }
+  /** Built on first use, like the module's `kv` singleton, which would JSON-parse what it reads. */
+  get kv() {
+    if (!this.client) {
+      const url = this.connection.url ?? getEnv("KV_REST_API_URL");
+      const token = this.connection.token ?? getEnv("KV_REST_API_TOKEN");
+      if (!url || !token) {
+        throw new Error("RememberVercelKvProvider: pass url and token, or set KV_REST_API_URL and KV_REST_API_TOKEN.");
+      }
+      this.client = this.createClient({ url, token, automaticDeserialization: false });
+    }
+    return this.client;
+  }
   prefixKey(key) {
     return `${this.keyPrefix}${key}`;
   }
@@ -1031,7 +1047,7 @@ var RememberVercelKvProvider = class {
    */
   async setValue(key, value, ttlSeconds) {
     const fullKey = this.prefixKey(key);
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     const ttl = ttlSeconds ?? this.defaultTTL;
     if (ttl && ttl > 0) {
       await this.kv.set(fullKey, strValue, { ex: ttl });
@@ -1047,7 +1063,7 @@ var RememberVercelKvProvider = class {
    */
   async setIfAbsent(key, value, ttlSeconds) {
     const fullKey = this.prefixKey(key);
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     const ttl = ttlSeconds ?? this.defaultTTL;
     const result = ttl && ttl > 0 ? await this.kv.set(fullKey, strValue, { nx: true, ex: ttl }) : await this.kv.set(fullKey, strValue, { nx: true });
     return result === "OK";
@@ -1058,15 +1074,12 @@ var RememberVercelKvProvider = class {
   async getValue(key, defaultValue) {
     const fullKey = this.prefixKey(key);
     const raw = await this.kv.get(fullKey);
-    if (raw === null || raw === void 0) return defaultValue;
-    if (typeof raw === "string") {
-      try {
-        return JSON.parse(raw);
-      } catch {
-        return raw;
-      }
+    if (raw === null) return defaultValue;
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
     }
-    return raw;
   }
   /**
    * Delete a key.
@@ -1100,7 +1113,7 @@ var RememberVercelKvProvider = class {
         for (const key of keys) {
           result.push(key.slice(this.keyPrefix.length));
         }
-      } while (cursor !== 0);
+      } while (String(cursor) !== "0");
     } catch {
       try {
         const keys = await this.kv.keys(searchPattern);

package/esm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/plugin-remember",
-  "version": "1.8.7",
+  "version": "1.9.1-rc.1",
   "description": "Remember plugin for FrontMCP - encrypted session memory with approval system for secure tool authorization",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -49,12 +49,12 @@
     }
   },
   "dependencies": {
-    "@frontmcp/sdk": "1.8.7",
-    "@frontmcp/utils": "1.8.7",
+    "@frontmcp/sdk": "1.9.1-rc.1",
+    "@frontmcp/utils": "1.9.1-rc.1",
     "ioredis": "^5.8.0"
   },
   "peerDependencies": {
-    "@frontmcp/lazy-zod": "1.8.7",
+    "@frontmcp/lazy-zod": "1.9.1-rc.1",
     "@vercel/kv": "^2.0.0 || ^3.0.0"
   },
   "peerDependenciesMeta": {

package/index.js

@@ -427,6 +427,9 @@ var STORAGE_LAYOUT_VERSION = "v2";
 function encodeKeyPart(value) {
   return encodeURIComponent(value);
 }
+function remainingSeconds(expiresAt, now) {
+  return Math.max(1, Math.ceil((expiresAt - now) / 1e3));
+}
 var RememberAccessor = class {
   store;
   ctx;
@@ -476,16 +479,8 @@ var RememberAccessor = class {
    */
   async get(key, options = {}) {
     const scope = options.scope ?? "session";
-    const storageKey = this.buildStorageKey(key, scope);
-    const raw = await this.store.getValue(storageKey);
-    if (!raw) return options.defaultValue;
-    const entry = this.encryptionEnabled ? await deserializeAndDecrypt(raw, this.getKeySource(scope)) : this.parseEntry(raw);
-    if (!entry) return options.defaultValue;
-    if (entry.expiresAt && Date.now() > entry.expiresAt) {
-      await this.forget(key, { scope });
-      return options.defaultValue;
-    }
-    return entry.value;
+    const entry = await this.readEntry(this.buildStorageKey(key, scope), scope);
+    return entry ? entry.value : options.defaultValue;
   }
   /**
    * Get the full entry including metadata.
@@ -496,16 +491,7 @@ var RememberAccessor = class {
    */
   async getEntry(key, options = {}) {
     const scope = options.scope ?? "session";
-    const storageKey = this.buildStorageKey(key, scope);
-    const raw = await this.store.getValue(storageKey);
-    if (!raw) return void 0;
-    const entry = this.encryptionEnabled ? await deserializeAndDecrypt(raw, this.getKeySource(scope)) : this.parseEntry(raw);
-    if (!entry) return void 0;
-    if (entry.expiresAt && Date.now() > entry.expiresAt) {
-      await this.forget(key, { scope });
-      return void 0;
-    }
-    return entry;
+    return this.readEntry(this.buildStorageKey(key, scope), scope);
   }
   /**
    * Forget (delete) a value from memory.
@@ -519,19 +505,18 @@ var RememberAccessor = class {
     await this.store.delete(storageKey);
   }
   /**
-   * Check if a key is remembered (exists and not expired).
+   * Check if a key is remembered: true exactly when `get()` would return its value.
    *
    * @param key - The key to check
    * @param options - Options (scope)
-   * @returns true if the key exists
+   * @returns true if the key exists and has not expired
    */
   async knows(key, options = {}) {
     const scope = options.scope ?? "session";
-    const storageKey = this.buildStorageKey(key, scope);
-    return this.store.exists(storageKey);
+    return await this.readEntry(this.buildStorageKey(key, scope), scope) !== void 0;
   }
   /**
-   * List all remembered keys for a scope.
+   * List all remembered keys for a scope: the keys `get()` would return a value for.
    *
    * @param options - Options (scope, pattern)
    * @returns Array of keys (without the scope prefix)
@@ -539,13 +524,16 @@ var RememberAccessor = class {
   async list(options = {}) {
     const scope = options.scope ?? "session";
     const scopePrefix = this.buildScopePrefix(scope);
-    const fullPattern = scopePrefix + (options.pattern ?? "*");
-    const keys = await this.store.keys(fullPattern);
-    return keys.map((k) => k.slice(scopePrefix.length));
+    const storageKeys = await this.store.keys(scopePrefix + (options.pattern ?? "*"));
+    const entries = await Promise.all(storageKeys.map((storageKey) => this.readEntry(storageKey, scope)));
+    return storageKeys.filter((_storageKey, index) => entries[index] !== void 0).map((storageKey) => storageKey.slice(scopePrefix.length));
   }
   /**
    * Update an existing entry's value while preserving metadata.
    *
+   * With a `ttl` the entry expires that many seconds from now; without one it keeps its current
+   * expiry, in the store as well, so the store does not keep it past that (rounded up to a second).
+   *
    * @param key - The key to update
    * @param value - The new value
    * @param options - Options (scope, ttl)
@@ -554,15 +542,18 @@ var RememberAccessor = class {
     const scope = options.scope ?? "session";
     const existing = await this.getEntry(key, { scope });
     if (!existing) return false;
+    const now = Date.now();
+    const expiresAt = options.ttl ? now + options.ttl * 1e3 : existing.expiresAt;
     const entry = {
       ...existing,
       value,
-      updatedAt: Date.now(),
-      expiresAt: options.ttl ? Date.now() + options.ttl * 1e3 : existing.expiresAt
+      updatedAt: now,
+      expiresAt
     };
     const storageKey = this.buildStorageKey(key, scope);
     const serialized = this.encryptionEnabled ? await encryptAndSerialize(entry, this.getKeySource(scope)) : JSON.stringify(entry);
-    await this.store.setValue(storageKey, serialized, options.ttl);
+    const storageTtl = options.ttl ?? (expiresAt !== void 0 ? remainingSeconds(expiresAt, now) : void 0);
+    await this.store.setValue(storageKey, serialized, storageTtl);
     return true;
   }
   // ─────────────────────────────────────────────────────────────────────────────
@@ -680,6 +671,19 @@ var RememberAccessor = class {
       toolName: scope === "tool" ? this.toolName : void 0
     });
   }
+  /** The entry stored under `storageKey`, if readable and unexpired; an expired one is deleted. */
+  async readEntry(storageKey, scope) {
+    const stored = await this.store.getValue(storageKey);
+    if (!stored) return void 0;
+    const raw = typeof stored === "string" ? stored : JSON.stringify(stored);
+    const entry = this.encryptionEnabled ? await deserializeAndDecrypt(raw, this.getKeySource(scope)) : this.parseEntry(raw);
+    if (!entry) return void 0;
+    if (entry.expiresAt && Date.now() > entry.expiresAt) {
+      await this.store.delete(storageKey);
+      return void 0;
+    }
+    return entry;
+  }
   /**
    * Parse a JSON entry (when encryption is disabled).
    */
@@ -929,7 +933,7 @@ var RememberRedisProvider = class {
       }
     }
     const fullKey = this.keyPrefix + key;
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     if (ttlSeconds !== void 0 && ttlSeconds > 0) {
       await this.client.set(fullKey, strValue, "EX", ttlSeconds);
     } else {
@@ -944,7 +948,7 @@ var RememberRedisProvider = class {
    */
   async setIfAbsent(key, value, ttlSeconds) {
     const fullKey = this.keyPrefix + key;
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     const result = ttlSeconds !== void 0 && ttlSeconds > 0 ? await this.client.set(fullKey, strValue, "EX", ttlSeconds, "NX") : await this.client.set(fullKey, strValue, "NX");
     return result === "OK";
   }
@@ -1021,8 +1025,11 @@ RememberRedisProvider = __decorateClass([
 
 // plugins/plugin-remember/src/providers/remember-vercel-kv.provider.ts
 var import_sdk5 = require("@frontmcp/sdk");
+var import_utils3 = require("@frontmcp/utils");
 var RememberVercelKvProvider = class {
-  kv;
+  createClient;
+  connection;
+  client;
   keyPrefix;
   defaultTTL;
   constructor(options = {}) {
@@ -1034,17 +1041,23 @@ var RememberVercelKvProvider = class {
         `RememberVercelKvProvider: Both 'url' and 'token' must be provided together, or neither. Received: url=${hasUrl ? "provided" : "missing"}, token=${hasToken ? "provided" : "missing"}`
       );
     }
-    if (options.url && options.token) {
-      this.kv = vercelKv.createClient({
-        url: options.url,
-        token: options.token
-      });
-    } else {
-      this.kv = vercelKv.kv;
-    }
+    this.createClient = vercelKv.createClient;
+    this.connection = { url: options.url, token: options.token };
     this.keyPrefix = options.keyPrefix ?? "remember:";
     this.defaultTTL = options.defaultTTL;
   }
+  /** Built on first use, like the module's `kv` singleton, which would JSON-parse what it reads. */
+  get kv() {
+    if (!this.client) {
+      const url = this.connection.url ?? (0, import_utils3.getEnv)("KV_REST_API_URL");
+      const token = this.connection.token ?? (0, import_utils3.getEnv)("KV_REST_API_TOKEN");
+      if (!url || !token) {
+        throw new Error("RememberVercelKvProvider: pass url and token, or set KV_REST_API_URL and KV_REST_API_TOKEN.");
+      }
+      this.client = this.createClient({ url, token, automaticDeserialization: false });
+    }
+    return this.client;
+  }
   prefixKey(key) {
     return `${this.keyPrefix}${key}`;
   }
@@ -1053,7 +1066,7 @@ var RememberVercelKvProvider = class {
    */
   async setValue(key, value, ttlSeconds) {
     const fullKey = this.prefixKey(key);
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     const ttl = ttlSeconds ?? this.defaultTTL;
     if (ttl && ttl > 0) {
       await this.kv.set(fullKey, strValue, { ex: ttl });
@@ -1069,7 +1082,7 @@ var RememberVercelKvProvider = class {
    */
   async setIfAbsent(key, value, ttlSeconds) {
     const fullKey = this.prefixKey(key);
-    const strValue = typeof value === "string" ? value : JSON.stringify(value);
+    const strValue = JSON.stringify(value);
     const ttl = ttlSeconds ?? this.defaultTTL;
     const result = ttl && ttl > 0 ? await this.kv.set(fullKey, strValue, { nx: true, ex: ttl }) : await this.kv.set(fullKey, strValue, { nx: true });
     return result === "OK";
@@ -1080,15 +1093,12 @@ var RememberVercelKvProvider = class {
   async getValue(key, defaultValue) {
     const fullKey = this.prefixKey(key);
     const raw = await this.kv.get(fullKey);
-    if (raw === null || raw === void 0) return defaultValue;
-    if (typeof raw === "string") {
-      try {
-        return JSON.parse(raw);
-      } catch {
-        return raw;
-      }
+    if (raw === null) return defaultValue;
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
     }
-    return raw;
   }
   /**
    * Delete a key.
@@ -1122,7 +1132,7 @@ var RememberVercelKvProvider = class {
         for (const key of keys) {
           result.push(key.slice(this.keyPrefix.length));
         }
-      } while (cursor !== 0);
+      } while (String(cursor) !== "0");
     } catch {
       try {
         const keys = await this.kv.keys(searchPattern);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/plugin-remember",
-  "version": "1.8.7",
+  "version": "1.9.1-rc.1",
   "description": "Remember plugin for FrontMCP - encrypted session memory with approval system for secure tool authorization",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -49,12 +49,12 @@
     }
   },
   "dependencies": {
-    "@frontmcp/sdk": "1.8.7",
-    "@frontmcp/utils": "1.8.7",
+    "@frontmcp/sdk": "1.9.1-rc.1",
+    "@frontmcp/utils": "1.9.1-rc.1",
     "ioredis": "^5.8.0"
   },
   "peerDependencies": {
-    "@frontmcp/lazy-zod": "1.8.7",
+    "@frontmcp/lazy-zod": "1.9.1-rc.1",
     "@vercel/kv": "^2.0.0 || ^3.0.0"
   },
   "peerDependenciesMeta": {

package/providers/remember-accessor.provider.d.ts

@@ -66,15 +66,15 @@ export declare class RememberAccessor {
      */
     forget(key: string, options?: RememberForgetOptions): Promise<void>;
     /**
-     * Check if a key is remembered (exists and not expired).
+     * Check if a key is remembered: true exactly when `get()` would return its value.
      *
      * @param key - The key to check
      * @param options - Options (scope)
-     * @returns true if the key exists
+     * @returns true if the key exists and has not expired
      */
     knows(key: string, options?: RememberKnowsOptions): Promise<boolean>;
     /**
-     * List all remembered keys for a scope.
+     * List all remembered keys for a scope: the keys `get()` would return a value for.
      *
      * @param options - Options (scope, pattern)
      * @returns Array of keys (without the scope prefix)
@@ -83,6 +83,9 @@ export declare class RememberAccessor {
     /**
      * Update an existing entry's value while preserving metadata.
      *
+     * With a `ttl` the entry expires that many seconds from now; without one it keeps its current
+     * expiry, in the store as well, so the store does not keep it past that (rounded up to a second).
+     *
      * @param key - The key to update
      * @param value - The new value
      * @param options - Options (scope, ttl)
@@ -149,6 +152,8 @@ export declare class RememberAccessor {
      * Get the encryption key source for a scope.
      */
     private getKeySource;
+    /** The entry stored under `storageKey`, if readable and unexpired; an expired one is deleted. */
+    private readEntry;
     /**
      * Parse a JSON entry (when encryption is disabled).
      */

package/providers/remember-accessor.provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remember-accessor.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-accessor.provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"remember-accessor.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-accessor.provider.ts"],"names":[],"mappings":"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"}

package/providers/remember-vercel-kv.provider.d.ts

@@ -17,10 +17,14 @@ export interface RememberVercelKvProviderOptions {
  * Provides serverless-compatible, edge-ready storage.
  */
 export default class RememberVercelKvProvider implements RememberStoreInterface {
-    private kv;
+    private readonly createClient;
+    private readonly connection;
+    private client?;
     private readonly keyPrefix;
     private readonly defaultTTL?;
     constructor(options?: RememberVercelKvProviderOptions);
+    /** Built on first use, like the module's `kv` singleton, which would JSON-parse what it reads. */
+    private get kv();
     private prefixKey;
     /**
      * Store a value with optional TTL.

package/providers/remember-vercel-kv.provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remember-vercel-kv.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-vercel-kv.provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAezE;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AAMH,MAAM,CAAC,OAAO,OAAO,wBAAyB,YAAW,sBAAsB;IAC7E,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;gBAEzB,OAAO,GAAE,+BAAoC;IA6BzD,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/E;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAarF;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAkBlF;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C;;;OAGG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmC/C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}
+{"version":3,"file":"remember-vercel-kv.provider.d.ts","sourceRoot":"","sources":["../../src/providers/remember-vercel-kv.provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAmBzE;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AAMH,MAAM,CAAC,OAAO,OAAO,wBAAyB,YAAW,sBAAsB;IAC7E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,MAAM,CAAC,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;gBAEzB,OAAO,GAAE,+BAAoC;IAoBzD,kGAAkG;IAClG,OAAO,KAAK,EAAE,GAUb;IAED,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/E;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAarF;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAalF;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C;;;OAGG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmC/C;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}