@frontmcp/utils 1.10.16 → 1.11.0-rc.2

package/browser/storage/adapters/cloudflare-kv.mjs

@@ -0,0 +1,149 @@
+// libs/utils/src/storage/adapters/cloudflare-kv.ts
+import { StorageNotSupportedError, StorageOperationError } from "../errors.mjs";
+import { matchesPattern } from "../utils/pattern.mjs";
+import { validateTTL } from "../utils/ttl.mjs";
+import { BaseStorageAdapter } from "./base.mjs";
+var CF_KV_MIN_TTL_SECONDS = 60;
+function literalPrefix(pattern) {
+  const star = pattern.indexOf("*");
+  const q = pattern.indexOf("?");
+  const idx = star === -1 ? q : q === -1 ? star : Math.min(star, q);
+  return idx === -1 ? pattern : pattern.slice(0, idx);
+}
+var CloudflareKvStorageAdapter = class extends BaseStorageAdapter {
+  backendName = "cloudflare-kv";
+  kv;
+  keyPrefix;
+  constructor(options) {
+    super();
+    if (!options?.namespace) {
+      throw new Error(
+        "CloudflareKvStorageAdapter: a bound KV `namespace` is required (resolve it from the Worker `env`)."
+      );
+    }
+    this.kv = options.namespace;
+    this.keyPrefix = options.keyPrefix ?? "";
+  }
+  // \u2500\u2500 Lifecycle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // A KV binding is always available; "connection" is just a readiness flag.
+  async connect() {
+    this.connected = true;
+  }
+  async disconnect() {
+    this.connected = false;
+  }
+  async ping() {
+    if (!this.connected) return false;
+    try {
+      await this.kv.list({ limit: 1 });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  // \u2500\u2500 Core \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  async get(key) {
+    this.ensureConnected();
+    return this.kv.get(this.prefixKey(key), "text");
+  }
+  async doSet(key, value, options) {
+    if (options?.ifNotExists || options?.ifExists) {
+      throw new StorageNotSupportedError(
+        "conditional set (ifNotExists/ifExists)",
+        this.backendName,
+        "Cloudflare KV has no compare-and-set; use a Durable Object for atomic conditional writes."
+      );
+    }
+    const putOptions = options?.ttlSeconds !== void 0 ? { expirationTtl: this.toExpirationTtl(options.ttlSeconds, key) } : void 0;
+    await this.kv.put(this.prefixKey(key), value, putOptions);
+  }
+  async delete(key) {
+    this.ensureConnected();
+    const existed = await this.exists(key);
+    await this.kv.delete(this.prefixKey(key));
+    return existed;
+  }
+  async exists(key) {
+    this.ensureConnected();
+    return await this.kv.get(this.prefixKey(key), "text") !== null;
+  }
+  // \u2500\u2500 TTL \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  async expire(key, ttlSeconds) {
+    this.ensureConnected();
+    const ttl = this.toExpirationTtl(ttlSeconds, key);
+    const value = await this.kv.get(this.prefixKey(key), "text");
+    if (value === null) return false;
+    await this.kv.put(this.prefixKey(key), value, { expirationTtl: ttl });
+    return true;
+  }
+  async ttl(_key) {
+    throw new StorageNotSupportedError(
+      "ttl",
+      this.backendName,
+      "Cloudflare KV does not expose a key's remaining TTL. Track expiry alongside the value if you need it."
+    );
+  }
+  // \u2500\u2500 Enumeration \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  async keys(pattern = "*") {
+    this.ensureConnected();
+    const prefixedPattern = this.prefixKey(pattern);
+    const listPrefix = literalPrefix(prefixedPattern);
+    const out = [];
+    let cursor;
+    do {
+      const page = await this.kv.list({ prefix: listPrefix || void 0, cursor });
+      for (const { name } of page.keys) {
+        if (matchesPattern(name, prefixedPattern)) out.push(this.unprefixKey(name));
+      }
+      cursor = page.list_complete ? void 0 : page.cursor;
+    } while (cursor);
+    return out;
+  }
+  // \u2500\u2500 Atomic (unsupported on KV) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  async incr(key) {
+    return this.incrBy(key, 1);
+  }
+  async decr(key) {
+    return this.incrBy(key, -1);
+  }
+  async incrBy(_key, _amount) {
+    throw new StorageNotSupportedError(
+      "incr/decr/incrBy",
+      this.backendName,
+      "Cloudflare KV has no atomic increment (a get+put is racy under eventual consistency). Use a Durable Object for atomic counters."
+    );
+  }
+  async deleteIfEquals(_key, _expectedValue) {
+    throw new StorageNotSupportedError(
+      "deleteIfEquals",
+      this.backendName,
+      "Cloudflare KV has no compare-and-set; use a Durable Object for an atomic compare-and-delete."
+    );
+  }
+  // \u2500\u2500 Pub/Sub (unsupported) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  getPubSubSuggestion() {
+    return "Cloudflare KV does not support pub/sub. Use a Durable Object (or Queues) for fan-out.";
+  }
+  // \u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  /** Validate + enforce KV's 60s minimum `expirationTtl`. */
+  toExpirationTtl(ttlSeconds, key) {
+    validateTTL(ttlSeconds);
+    if (ttlSeconds < CF_KV_MIN_TTL_SECONDS) {
+      throw new StorageOperationError(
+        "set",
+        key,
+        `cloudflare-kv: expirationTtl must be >= ${CF_KV_MIN_TTL_SECONDS}s (Cloudflare KV minimum); got ${ttlSeconds}s.`
+      );
+    }
+    return ttlSeconds;
+  }
+  prefixKey(key) {
+    return this.keyPrefix + key;
+  }
+  unprefixKey(key) {
+    return this.keyPrefix && key.startsWith(this.keyPrefix) ? key.slice(this.keyPrefix.length) : key;
+  }
+};
+export {
+  CloudflareKvStorageAdapter
+};

package/browser/storage/adapters/filesystem.mjs

@@ -0,0 +1,279 @@
+// libs/utils/src/storage/adapters/filesystem.ts
+import { BaseStorageAdapter } from "./base.mjs";
+import { StorageOperationError } from "../errors.mjs";
+import { globToRegex } from "../utils/pattern.mjs";
+import { writeFile, readdir, unlink, fileExists, ensureDir, mkdir, rename, readJSON } from "../../fs/index.mjs";
+import { randomBytes, bytesToHex } from "../../crypto/index.mjs";
+var FileSystemStorageAdapter = class extends BaseStorageAdapter {
+  backendName = "filesystem";
+  baseDir;
+  extension;
+  dirMode;
+  fileMode;
+  constructor(options) {
+    super();
+    this.baseDir = options.baseDir;
+    this.extension = options.extension ?? ".json";
+    this.dirMode = options.dirMode ?? 448;
+    this.fileMode = options.fileMode ?? 384;
+  }
+  // ============================================
+  // Connection Lifecycle
+  // ============================================
+  async connect() {
+    if (this.connected) return;
+    await ensureDir(this.baseDir);
+    try {
+      await mkdir(this.baseDir, { recursive: true, mode: this.dirMode });
+    } catch {
+    }
+    this.connected = true;
+  }
+  async disconnect() {
+    if (!this.connected) return;
+    this.connected = false;
+  }
+  async ping() {
+    if (!this.connected) return false;
+    try {
+      return await fileExists(this.baseDir);
+    } catch {
+      return false;
+    }
+  }
+  // ============================================
+  // Core Operations
+  // ============================================
+  async get(key) {
+    this.ensureConnected();
+    const filePath = this.keyToPath(key);
+    try {
+      const entry = await readJSON(filePath);
+      if (!entry) return null;
+      if (entry.expiresAt && Date.now() >= entry.expiresAt) {
+        await this.deleteFile(filePath);
+        return null;
+      }
+      return entry.value;
+    } catch (e) {
+      const error = e;
+      if (error.code === "ENOENT") {
+        return null;
+      }
+      throw e;
+    }
+  }
+  async doSet(key, value, options) {
+    const filePath = this.keyToPath(key);
+    const existingEntry = await this.readEntry(filePath);
+    const exists = existingEntry !== null && !this.isExpired(existingEntry);
+    if (options?.ifNotExists && exists) {
+      return;
+    }
+    if (options?.ifExists && !exists) {
+      return;
+    }
+    const entry = { value };
+    if (options?.ttlSeconds) {
+      entry.expiresAt = Date.now() + options.ttlSeconds * 1e3;
+    }
+    await this.atomicWrite(filePath, entry);
+  }
+  async delete(key) {
+    this.ensureConnected();
+    const filePath = this.keyToPath(key);
+    return this.deleteFile(filePath);
+  }
+  async exists(key) {
+    this.ensureConnected();
+    const filePath = this.keyToPath(key);
+    try {
+      const entry = await this.readEntry(filePath);
+      if (!entry) return false;
+      if (this.isExpired(entry)) {
+        await this.deleteFile(filePath);
+        return false;
+      }
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  // ============================================
+  // TTL Operations
+  // ============================================
+  async expire(key, ttlSeconds) {
+    this.ensureConnected();
+    const filePath = this.keyToPath(key);
+    const entry = await this.readEntry(filePath);
+    if (!entry || this.isExpired(entry)) {
+      return false;
+    }
+    entry.expiresAt = Date.now() + ttlSeconds * 1e3;
+    await this.atomicWrite(filePath, entry);
+    return true;
+  }
+  async ttl(key) {
+    this.ensureConnected();
+    const filePath = this.keyToPath(key);
+    const entry = await this.readEntry(filePath);
+    if (!entry) return null;
+    if (this.isExpired(entry)) {
+      await this.deleteFile(filePath);
+      return null;
+    }
+    if (entry.expiresAt === void 0) {
+      return -1;
+    }
+    return Math.max(0, Math.ceil((entry.expiresAt - Date.now()) / 1e3));
+  }
+  // ============================================
+  // Key Enumeration
+  // ============================================
+  async keys(pattern = "*") {
+    this.ensureConnected();
+    const regex = globToRegex(pattern);
+    const result = [];
+    try {
+      const files = await readdir(this.baseDir);
+      for (const file of files) {
+        if (!file.endsWith(this.extension)) continue;
+        const key = this.pathToKey(file);
+        if (!regex.test(key)) continue;
+        const filePath = this.keyToPath(key);
+        const entry = await this.readEntry(filePath);
+        if (entry && !this.isExpired(entry)) {
+          result.push(key);
+        } else if (entry && this.isExpired(entry)) {
+          await this.deleteFile(filePath);
+        }
+      }
+    } catch (e) {
+      const error = e;
+      if (error.code === "ENOENT") {
+        return [];
+      }
+      throw e;
+    }
+    return result;
+  }
+  // ============================================
+  // Atomic Operations
+  // ============================================
+  async incr(key) {
+    return this.incrBy(key, 1);
+  }
+  async decr(key) {
+    return this.incrBy(key, -1);
+  }
+  async incrBy(key, amount) {
+    this.ensureConnected();
+    const filePath = this.keyToPath(key);
+    const entry = await this.readEntry(filePath);
+    let currentValue = 0;
+    if (entry && !this.isExpired(entry)) {
+      const parsed = parseInt(entry.value, 10);
+      if (isNaN(parsed)) {
+        throw new StorageOperationError("incrBy", key, "Value is not an integer");
+      }
+      currentValue = parsed;
+    }
+    const newValue = currentValue + amount;
+    const newEntry = { value: String(newValue) };
+    if (entry?.expiresAt && !this.isExpired(entry)) {
+      newEntry.expiresAt = entry.expiresAt;
+    }
+    await this.atomicWrite(filePath, newEntry);
+    return newValue;
+  }
+  // ============================================
+  // Internal Helpers
+  // ============================================
+  /**
+   * Convert a storage key to a file path.
+   * Sanitizes the key to be filesystem-safe.
+   */
+  keyToPath(key) {
+    const safeKey = this.encodeKey(key);
+    return `${this.baseDir}/${safeKey}${this.extension}`;
+  }
+  /**
+   * Convert a filename back to a storage key.
+   */
+  pathToKey(filename) {
+    const safeKey = filename.slice(0, -this.extension.length);
+    return this.decodeKey(safeKey);
+  }
+  /**
+   * Encode a key to be filesystem-safe.
+   * Uses URL encoding to handle special characters.
+   */
+  encodeKey(key) {
+    return encodeURIComponent(key).replace(/\./g, "%2E");
+  }
+  /**
+   * Decode a filesystem-safe key back to original.
+   */
+  decodeKey(encoded) {
+    return decodeURIComponent(encoded);
+  }
+  /**
+   * Read an entry from a file.
+   */
+  async readEntry(filePath) {
+    try {
+      return await readJSON(filePath);
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Check if an entry is expired.
+   */
+  isExpired(entry) {
+    return entry.expiresAt !== void 0 && Date.now() >= entry.expiresAt;
+  }
+  /**
+   * Delete a file, returning true if it existed.
+   */
+  async deleteFile(filePath) {
+    try {
+      await unlink(filePath);
+      return true;
+    } catch (e) {
+      const error = e;
+      if (error.code === "ENOENT") {
+        return false;
+      }
+      throw e;
+    }
+  }
+  /**
+   * Atomic write: write to temp file then rename.
+   * This ensures we don't corrupt the file if write is interrupted.
+   */
+  async atomicWrite(filePath, entry) {
+    const tempSuffix = bytesToHex(randomBytes(8));
+    const tempPath = `${filePath}.${tempSuffix}.tmp`;
+    try {
+      const content = JSON.stringify(entry, null, 2);
+      await writeFile(tempPath, content, { mode: this.fileMode });
+      await rename(tempPath, filePath);
+    } catch (e) {
+      try {
+        await unlink(tempPath);
+      } catch {
+      }
+      throw e;
+    }
+  }
+  /**
+   * Get suggestion message for pub/sub not supported error.
+   */
+  getPubSubSuggestion() {
+    return "FileSystem adapter does not support pub/sub. Use Redis or Memory adapter for pub/sub support.";
+  }
+};
+export {
+  FileSystemStorageAdapter
+};

package/browser/storage/adapters/index.mjs

@@ -0,0 +1,23 @@
+// libs/utils/src/storage/adapters/index.ts
+import { BaseStorageAdapter } from "./base.mjs";
+import { MemoryStorageAdapter } from "./memory.mjs";
+import { RedisStorageAdapter, createRedisClient } from "./redis.mjs";
+import { VercelKvStorageAdapter, createVercelKvClient } from "./vercel-kv.mjs";
+import { UpstashStorageAdapter } from "./upstash.mjs";
+import { CloudflareKvStorageAdapter } from "./cloudflare-kv.mjs";
+import { FileSystemStorageAdapter } from "./filesystem.mjs";
+import { LocalStorageAdapter } from "./localstorage.mjs";
+import { IndexedDBStorageAdapter } from "./indexeddb.mjs";
+export {
+  BaseStorageAdapter,
+  CloudflareKvStorageAdapter,
+  FileSystemStorageAdapter,
+  IndexedDBStorageAdapter,
+  LocalStorageAdapter,
+  MemoryStorageAdapter,
+  RedisStorageAdapter,
+  UpstashStorageAdapter,
+  VercelKvStorageAdapter,
+  createRedisClient,
+  createVercelKvClient
+};

package/browser/storage/adapters/indexeddb.mjs

@@ -0,0 +1,198 @@
+// libs/utils/src/storage/adapters/indexeddb.ts
+import { BaseStorageAdapter } from "./base.mjs";
+import { matchesPattern } from "../utils/pattern.mjs";
+var IndexedDBStorageAdapter = class extends BaseStorageAdapter {
+  backendName = "indexeddb";
+  dbName;
+  storeName;
+  prefix;
+  db = null;
+  constructor(options) {
+    super();
+    this.dbName = options?.dbName ?? "frontmcp";
+    this.storeName = options?.storeName ?? "kv";
+    this.prefix = options?.prefix ?? "frontmcp:";
+  }
+  assertAvailable() {
+    if (typeof indexedDB === "undefined") {
+      throw new Error("IndexedDB is not available in this environment");
+    }
+  }
+  key(k) {
+    return `${this.prefix}${k}`;
+  }
+  stripPrefix(fullKey) {
+    return fullKey.slice(this.prefix.length);
+  }
+  // ============================================
+  // Connection Lifecycle
+  // ============================================
+  async connect() {
+    this.assertAvailable();
+    if (this.db) {
+      this.connected = true;
+      return;
+    }
+    this.db = await new Promise((resolve, reject) => {
+      const request = indexedDB.open(this.dbName, 1);
+      request.onupgradeneeded = () => {
+        const db = request.result;
+        if (!db.objectStoreNames.contains(this.storeName)) {
+          db.createObjectStore(this.storeName, { keyPath: "k" });
+        }
+      };
+      request.onsuccess = () => resolve(request.result);
+      request.onerror = () => reject(request.error);
+    });
+    this.connected = true;
+  }
+  async disconnect() {
+    if (this.db) {
+      this.db.close();
+      this.db = null;
+    }
+    this.connected = false;
+  }
+  async ping() {
+    return this.db !== null && this.connected;
+  }
+  // ============================================
+  // Internal Helpers
+  // ============================================
+  getStore(mode) {
+    if (!this.db) {
+      throw new Error("IndexedDB adapter is not connected. Call connect() first.");
+    }
+    const tx = this.db.transaction(this.storeName, mode);
+    return tx.objectStore(this.storeName);
+  }
+  idbRequest(request) {
+    return new Promise((resolve, reject) => {
+      request.onsuccess = () => resolve(request.result);
+      request.onerror = () => reject(request.error);
+    });
+  }
+  idbTransaction(store) {
+    return new Promise((resolve, reject) => {
+      const tx = store.transaction;
+      tx.oncomplete = () => resolve();
+      tx.onerror = () => reject(tx.error);
+    });
+  }
+  // ============================================
+  // Core Operations
+  // ============================================
+  async get(key) {
+    this.ensureConnected();
+    const store = this.getStore("readonly");
+    const entry = await this.idbRequest(store.get(this.key(key)));
+    if (!entry) return null;
+    if (entry.e && entry.e < Date.now()) {
+      const writeStore = this.getStore("readwrite");
+      writeStore.delete(this.key(key));
+      return null;
+    }
+    return entry.v;
+  }
+  async doSet(key, value, options) {
+    if (options?.ifNotExists) {
+      const existing = await this.get(key);
+      if (existing !== null) return;
+    }
+    if (options?.ifExists) {
+      const existing = await this.get(key);
+      if (existing === null) return;
+    }
+    const entry = { k: this.key(key), v: value };
+    if (options?.ttlSeconds) {
+      entry.e = Date.now() + options.ttlSeconds * 1e3;
+    }
+    const store = this.getStore("readwrite");
+    await this.idbRequest(store.put(entry));
+  }
+  async delete(key) {
+    this.ensureConnected();
+    const existing = await this.get(key);
+    if (existing === null) return false;
+    const store = this.getStore("readwrite");
+    await this.idbRequest(store.delete(this.key(key)));
+    return true;
+  }
+  async exists(key) {
+    return await this.get(key) !== null;
+  }
+  // ============================================
+  // TTL Operations
+  // ============================================
+  async expire(key, ttlSeconds) {
+    this.ensureConnected();
+    const value = await this.get(key);
+    if (value === null) return false;
+    await this.doSet(key, value, { ttlSeconds });
+    return true;
+  }
+  async ttl(key) {
+    this.ensureConnected();
+    const store = this.getStore("readonly");
+    const entry = await this.idbRequest(store.get(this.key(key)));
+    if (!entry) return null;
+    if (entry.e) {
+      const remaining = Math.ceil((entry.e - Date.now()) / 1e3);
+      return remaining > 0 ? remaining : null;
+    }
+    return -1;
+  }
+  // ============================================
+  // Key Enumeration
+  // ============================================
+  async keys(pattern) {
+    this.ensureConnected();
+    const store = this.getStore("readonly");
+    const allKeys = await this.idbRequest(store.getAllKeys());
+    const now = Date.now();
+    const result = [];
+    for (const fullKey of allKeys) {
+      const keyStr = String(fullKey);
+      if (!keyStr.startsWith(this.prefix)) continue;
+      const key = this.stripPrefix(keyStr);
+      if (pattern && pattern !== "*" && !this.matchPattern(key, pattern)) continue;
+      const entry = await this.idbRequest(store.get(keyStr));
+      if (entry && (!entry.e || entry.e >= now)) {
+        result.push(key);
+      }
+    }
+    return result;
+  }
+  // ============================================
+  // Atomic Operations
+  // ============================================
+  async incr(key) {
+    return this.incrBy(key, 1);
+  }
+  async decr(key) {
+    return this.incrBy(key, -1);
+  }
+  /**
+   * Increment by amount. NOT atomic \u2014 uses read-then-write which can race
+   * under concurrent access (e.g., multiple browser tabs).
+   */
+  async incrBy(key, amount) {
+    this.ensureConnected();
+    const current = await this.get(key);
+    const value = current !== null ? parseInt(current, 10) + amount : amount;
+    if (Number.isNaN(value)) {
+      throw new Error(`Value at "${key}" is not an integer`);
+    }
+    await this.doSet(key, String(value));
+    return value;
+  }
+  // ============================================
+  // Pattern Matching
+  // ============================================
+  matchPattern(key, pattern) {
+    return matchesPattern(key, pattern);
+  }
+};
+export {
+  IndexedDBStorageAdapter
+};