@cyanheads/mcp-ts-core 0.1.0-beta.12

package/dist/storage/providers/cloudflare/d1Provider.js

@@ -0,0 +1,347 @@
+import { decodeCursor, encodeCursor } from '../../../storage/core/storageValidation.js';
+import { JsonRpcErrorCode, McpError } from '../../../types-global/errors.js';
+import { ErrorHandler } from '../../../utils/internal/error-handler/errorHandler.js';
+import { logger } from '../../../utils/internal/logger.js';
+const DEFAULT_LIST_LIMIT = 1000;
+/** Escapes SQL LIKE wildcard characters (`%` and `_`) in a prefix string. */
+function escapeLikePattern(prefix) {
+    return prefix.replace(/[%_\\]/g, '\\$&');
+}
+/**
+ * Cloudflare D1 storage provider implementation.
+ *
+ * Features:
+ * - SQL-based key-value storage with multi-tenancy
+ * - TTL support via expires_at column (Unix timestamp in milliseconds)
+ * - Batch operations using D1's batch() API for transactional writes
+ * - Cursor-based pagination with tenant-bound security
+ * - Strong consistency (vs KV's eventual consistency)
+ *
+ * Schema Requirements:
+ * - Table: kv_store (tenant_id, key, value, expires_at)
+ * - See docs/cloudflare-d1-schema.sql for setup
+ *
+ * Performance Characteristics:
+ * - Reads: ~50-100ms (depends on query complexity)
+ * - Writes: ~50-200ms (single), ~100-500ms (batch)
+ * - List operations: Efficient with proper indexes
+ * - Batch operations: 20-100x faster than individual calls
+ */
+export class D1Provider {
+    db;
+    tableName;
+    /**
+     * Creates a new D1Provider instance.
+     *
+     * @param db - The D1Database binding from Cloudflare Workers
+     * @param tableName - The name of the kv_store table (default: 'kv_store')
+     * @throws {McpError} If db is not provided or invalid
+     */
+    static SAFE_TABLE_NAME = /^[a-zA-Z_][a-zA-Z0-9_]{0,63}$/;
+    constructor(db, tableName = 'kv_store') {
+        if (!db) {
+            throw new McpError(JsonRpcErrorCode.ConfigurationError, 'D1Provider requires a valid D1Database instance.');
+        }
+        if (!D1Provider.SAFE_TABLE_NAME.test(tableName)) {
+            throw new McpError(JsonRpcErrorCode.ConfigurationError, `D1Provider tableName must be a valid SQL identifier (letters, digits, underscores; start with letter or underscore; max 64 chars): ${tableName}`);
+        }
+        this.db = db;
+        this.tableName = tableName;
+    }
+    /**
+     * Helper to get current timestamp in milliseconds.
+     */
+    getNow() {
+        return Date.now();
+    }
+    /**
+     * Helper to check if a value has expired based on expires_at timestamp.
+     */
+    isExpired(expiresAt) {
+        if (expiresAt === null)
+            return false;
+        return expiresAt <= this.getNow();
+    }
+    /**
+     * Retrieves a value from the D1 database.
+     * Returns null if the key doesn't exist or has expired.
+     */
+    async get(tenantId, key, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[D1Provider] Getting key: ${key}`, context);
+            const stmt = this.db
+                .prepare(`SELECT value, expires_at FROM ${this.tableName} WHERE tenant_id = ? AND key = ?`)
+                .bind(tenantId, key);
+            const result = await stmt.first();
+            if (!result) {
+                logger.debug(`[D1Provider] Key not found: ${key}`, context);
+                return null;
+            }
+            // Check TTL expiration
+            if (this.isExpired(result.expires_at)) {
+                logger.debug(`[D1Provider] Key expired: ${key}`, context);
+                // Optionally delete expired key (lazy cleanup)
+                await this.delete(tenantId, key, context);
+                return null;
+            }
+            try {
+                return JSON.parse(result.value);
+            }
+            catch (error) {
+                throw new McpError(JsonRpcErrorCode.SerializationError, `[D1Provider] Failed to parse JSON for key: ${key}`, { ...context, error });
+            }
+        }, {
+            operation: 'D1Provider.get',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    /**
+     * Stores a value in the D1 database.
+     * Uses UPSERT (INSERT OR REPLACE) to handle both new and existing keys.
+     */
+    async set(tenantId, key, value, context, options) {
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[D1Provider] Setting key: ${key}`, {
+                ...context,
+                options,
+            });
+            const serializedValue = JSON.stringify(value);
+            let expiresAt = null;
+            // Handle TTL (including ttl=0 for immediate expiration)
+            if (options?.ttl !== undefined) {
+                expiresAt = this.getNow() + options.ttl * 1000;
+            }
+            const stmt = this.db
+                .prepare(`INSERT OR REPLACE INTO ${this.tableName} (tenant_id, key, value, expires_at) VALUES (?, ?, ?, ?)`)
+                .bind(tenantId, key, serializedValue, expiresAt);
+            await stmt.run();
+            logger.debug(`[D1Provider] Successfully set key: ${key}`, context);
+        }, {
+            operation: 'D1Provider.set',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    /**
+     * Deletes a key from the D1 database.
+     * Returns true if the key existed, false otherwise.
+     */
+    async delete(tenantId, key, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[D1Provider] Deleting key: ${key}`, context);
+            const stmt = this.db
+                .prepare(`DELETE FROM ${this.tableName} WHERE tenant_id = ? AND key = ?`)
+                .bind(tenantId, key);
+            const result = await stmt.run();
+            // D1's meta.changes indicates number of rows affected
+            const deleted = (result.meta?.changes ?? 0) > 0;
+            if (deleted) {
+                logger.debug(`[D1Provider] Successfully deleted key: ${key}`, context);
+            }
+            else {
+                logger.debug(`[D1Provider] Key to delete not found: ${key}`, context);
+            }
+            return deleted;
+        }, {
+            operation: 'D1Provider.delete',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    /**
+     * Lists keys matching a prefix with pagination support.
+     * Filters out expired keys based on TTL.
+     */
+    async list(tenantId, prefix, context, options) {
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[D1Provider] Listing keys with prefix: ${prefix}`, {
+                ...context,
+                options,
+            });
+            const limit = options?.limit ?? DEFAULT_LIST_LIMIT;
+            let lastKey;
+            // Decode cursor if provided
+            if (options?.cursor) {
+                try {
+                    lastKey = decodeCursor(options.cursor, tenantId, context);
+                }
+                catch (error) {
+                    throw new McpError(JsonRpcErrorCode.InvalidParams, 'Invalid cursor format or tenant mismatch', { ...context, error });
+                }
+            }
+            // Query with prefix matching and TTL filtering
+            const now = this.getNow();
+            let stmt;
+            if (lastKey) {
+                // Cursor-based pagination: fetch keys after lastKey
+                stmt = this.db
+                    .prepare(`SELECT key FROM ${this.tableName}
+               WHERE tenant_id = ?
+                 AND key LIKE ? ESCAPE '\\'
+                 AND key > ?
+                 AND (expires_at IS NULL OR expires_at > ?)
+               ORDER BY key
+               LIMIT ?`)
+                    .bind(tenantId, `${escapeLikePattern(prefix)}%`, lastKey, now, limit + 1);
+            }
+            else {
+                // Initial page: no cursor
+                stmt = this.db
+                    .prepare(`SELECT key FROM ${this.tableName}
+               WHERE tenant_id = ?
+                 AND key LIKE ? ESCAPE '\\'
+                 AND (expires_at IS NULL OR expires_at > ?)
+               ORDER BY key
+               LIMIT ?`)
+                    .bind(tenantId, `${escapeLikePattern(prefix)}%`, now, limit + 1);
+            }
+            const result = await stmt.all();
+            const rows = result.results ?? [];
+            // Check if there are more results (for pagination)
+            const hasMore = rows.length > limit;
+            const keys = hasMore ? rows.slice(0, limit) : rows;
+            // Generate next cursor if more results exist
+            let nextCursor;
+            if (hasMore && keys.length > 0) {
+                // Use the last key from the results as the cursor
+                nextCursor = encodeCursor(keys[keys.length - 1].key, tenantId);
+            }
+            logger.debug(`[D1Provider] Found ${keys.length} keys with prefix: ${prefix}`, context);
+            return {
+                keys: keys.map((row) => row.key),
+                nextCursor,
+            };
+        }, {
+            operation: 'D1Provider.list',
+            context,
+            input: { tenantId, prefix, options },
+        });
+    }
+    /**
+     * Retrieves multiple values in a single operation.
+     * More efficient than multiple individual get() calls.
+     * Uses SQL IN clause for batch fetching.
+     */
+    async getMany(tenantId, keys, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (keys.length === 0) {
+                return new Map();
+            }
+            logger.debug(`[D1Provider] Getting ${keys.length} keys in batch`, context);
+            // Build SQL IN clause
+            const placeholders = keys.map(() => '?').join(',');
+            const now = this.getNow();
+            const stmt = this.db
+                .prepare(`SELECT key, value, expires_at FROM ${this.tableName}
+             WHERE tenant_id = ?
+               AND key IN (${placeholders})
+               AND (expires_at IS NULL OR expires_at > ?)`)
+                .bind(tenantId, ...keys, now);
+            const result = await stmt.all();
+            const results = new Map();
+            const rows = result.results ?? [];
+            for (const row of rows) {
+                try {
+                    const parsed = JSON.parse(row.value);
+                    results.set(row.key, parsed);
+                }
+                catch (error) {
+                    logger.warning(`[D1Provider] Failed to parse value for key: ${row.key}`, {
+                        ...context,
+                        error,
+                    });
+                    // Skip unparseable values
+                }
+            }
+            return results;
+        }, {
+            operation: 'D1Provider.getMany',
+            context,
+            input: { tenantId, keyCount: keys.length },
+        });
+    }
+    /**
+     * Stores multiple key-value pairs in a single transaction.
+     * Uses D1's batch() API for atomic, transactional writes.
+     * Significantly faster than individual set() calls (20-100x).
+     */
+    async setMany(tenantId, entries, context, options) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (entries.size === 0) {
+                return;
+            }
+            logger.debug(`[D1Provider] Setting ${entries.size} keys in batch`, {
+                ...context,
+                options,
+            });
+            let expiresAt = null;
+            if (options?.ttl !== undefined) {
+                expiresAt = this.getNow() + options.ttl * 1000;
+            }
+            // Prepare batch statements
+            const statements = Array.from(entries.entries()).map(([key, value]) => {
+                const serializedValue = JSON.stringify(value);
+                return this.db
+                    .prepare(`INSERT OR REPLACE INTO ${this.tableName} (tenant_id, key, value, expires_at) VALUES (?, ?, ?, ?)`)
+                    .bind(tenantId, key, serializedValue, expiresAt);
+            });
+            // Execute as a single transaction
+            await this.db.batch(statements);
+            logger.debug(`[D1Provider] Successfully set ${entries.size} keys in batch`, context);
+        }, {
+            operation: 'D1Provider.setMany',
+            context,
+            input: { tenantId, entryCount: entries.size },
+        });
+    }
+    /**
+     * Deletes multiple keys in a single transaction.
+     * Uses D1's batch() API for atomic deletion.
+     * Returns the count of successfully deleted keys.
+     */
+    async deleteMany(tenantId, keys, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (keys.length === 0) {
+                return 0;
+            }
+            logger.debug(`[D1Provider] Deleting ${keys.length} keys in batch`, context);
+            // Prepare batch delete statements
+            const statements = keys.map((key) => this.db
+                .prepare(`DELETE FROM ${this.tableName} WHERE tenant_id = ? AND key = ?`)
+                .bind(tenantId, key));
+            // Execute as a single transaction
+            const results = await this.db.batch(statements);
+            // Count how many rows were actually deleted
+            const deletedCount = results.reduce((count, result) => count + (result.meta?.changes ?? 0), 0);
+            logger.debug(`[D1Provider] Deleted ${deletedCount} of ${keys.length} keys`, context);
+            return deletedCount;
+        }, {
+            operation: 'D1Provider.deleteMany',
+            context,
+            input: { tenantId, keyCount: keys.length },
+        });
+    }
+    /**
+     * Clears all keys for a given tenant.
+     * WARNING: This is a destructive operation that cannot be undone.
+     * Useful for testing or tenant cleanup operations.
+     */
+    async clear(tenantId, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            logger.warning(`[D1Provider] Clearing all keys for tenant: ${tenantId}`, context);
+            const stmt = this.db
+                .prepare(`DELETE FROM ${this.tableName} WHERE tenant_id = ?`)
+                .bind(tenantId);
+            const result = await stmt.run();
+            const deletedCount = result.meta?.changes ?? 0;
+            logger.info(`[D1Provider] Cleared ${deletedCount} keys for tenant: ${tenantId}`, context);
+            return deletedCount;
+        }, {
+            operation: 'D1Provider.clear',
+            context,
+            input: { tenantId },
+        });
+    }
+}
+//# sourceMappingURL=d1Provider.js.map

package/dist/storage/providers/cloudflare/d1Provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"d1Provider.js","sourceRoot":"","sources":["../../../../src/storage/providers/cloudflare/d1Provider.ts"],"names":[],"mappings":"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"}

package/dist/storage/providers/cloudflare/kvProvider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Implements the IStorageProvider interface for Cloudflare KV.
+ * @module src/storage/providers/cloudflare/kvProvider
+ */
+import type { KVNamespace } from '@cloudflare/workers-types';
+import type { IStorageProvider, ListOptions, ListResult, StorageOptions } from '../../../storage/core/IStorageProvider.js';
+import type { RequestContext } from '../../../utils/internal/requestContext.js';
+export declare class KvProvider implements IStorageProvider {
+    private readonly kv;
+    constructor(kv: KVNamespace);
+    private getKvKey;
+    get<T>(tenantId: string, key: string, context: RequestContext): Promise<T | null>;
+    set(tenantId: string, key: string, value: unknown, context: RequestContext, options?: StorageOptions): Promise<void>;
+    delete(tenantId: string, key: string, context: RequestContext): Promise<boolean>;
+    list(tenantId: string, prefix: string, context: RequestContext, options?: ListOptions): Promise<ListResult>;
+    getMany<T>(tenantId: string, keys: string[], context: RequestContext): Promise<Map<string, T>>;
+    setMany(tenantId: string, entries: Map<string, unknown>, context: RequestContext, options?: StorageOptions): Promise<void>;
+    deleteMany(tenantId: string, keys: string[], context: RequestContext): Promise<number>;
+    clear(tenantId: string, context: RequestContext): Promise<number>;
+}
+//# sourceMappingURL=kvProvider.d.ts.map

package/dist/storage/providers/cloudflare/kvProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kvProvider.d.ts","sourceRoot":"","sources":["../../../../src/storage/providers/cloudflare/kvProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,cAAc,EACf,MAAM,oCAAoC,CAAC;AAK5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIzE,qBAAa,UAAW,YAAW,gBAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;gBAErB,EAAE,EAAE,WAAW;IAU3B,OAAO,CAAC,QAAQ;IAIV,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAwBjF,GAAG,CACP,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IA2BV,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBhF,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC;IA+ChB,OAAO,CAAC,CAAC,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IA6BpB,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAoBV,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBtF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAoCxE"}

package/dist/storage/providers/cloudflare/kvProvider.js

@@ -0,0 +1,183 @@
+import { decodeCursor, encodeCursor } from '../../../storage/core/storageValidation.js';
+import { JsonRpcErrorCode, McpError } from '../../../types-global/errors.js';
+import { ErrorHandler } from '../../../utils/internal/error-handler/errorHandler.js';
+import { logger } from '../../../utils/internal/logger.js';
+const DEFAULT_LIST_LIMIT = 1000;
+export class KvProvider {
+    kv;
+    constructor(kv) {
+        if (!kv) {
+            throw new McpError(JsonRpcErrorCode.ConfigurationError, 'KvProvider requires a valid KVNamespace instance.');
+        }
+        this.kv = kv;
+    }
+    getKvKey(tenantId, key) {
+        return `${tenantId}:${key}`;
+    }
+    async get(tenantId, key, context) {
+        const kvKey = this.getKvKey(tenantId, key);
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[KvProvider] Getting key: ${kvKey}`, context);
+            try {
+                const result = await this.kv.get(kvKey, 'json');
+                return result; // null indicates not found
+            }
+            catch (error) {
+                throw new McpError(JsonRpcErrorCode.SerializationError, `[KvProvider] Failed to parse JSON for key: ${kvKey}`, { ...context, error });
+            }
+        }, {
+            operation: 'KvProvider.get',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async set(tenantId, key, value, context, options) {
+        const kvKey = this.getKvKey(tenantId, key);
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[KvProvider] Setting key: ${kvKey}`, {
+                ...context,
+                options,
+            });
+            const valueToStore = JSON.stringify(value);
+            const putOptions = {};
+            if (options?.ttl !== undefined) {
+                // Cloudflare KV requires expirationTtl >= 60 seconds
+                putOptions.expirationTtl = Math.max(options.ttl, 60);
+            }
+            await this.kv.put(kvKey, valueToStore, putOptions);
+            logger.debug(`[KvProvider] Successfully set key: ${kvKey}`, context);
+        }, {
+            operation: 'KvProvider.set',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async delete(tenantId, key, context) {
+        const kvKey = this.getKvKey(tenantId, key);
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[KvProvider] Deleting key: ${kvKey}`, context);
+            // KV delete is idempotent — no need to check existence first
+            await this.kv.delete(kvKey);
+            logger.debug(`[KvProvider] Successfully deleted key: ${kvKey}`, context);
+            return true;
+        }, {
+            operation: 'KvProvider.delete',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async list(tenantId, prefix, context, options) {
+        const kvPrefix = this.getKvKey(tenantId, prefix);
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[KvProvider] Listing keys with prefix: ${kvPrefix}`, {
+                ...context,
+                options,
+            });
+            const limit = options?.limit ?? DEFAULT_LIST_LIMIT;
+            const listOptions = {
+                prefix: kvPrefix,
+                limit,
+            };
+            if (options?.cursor) {
+                // Decode tenant-bound cursor to get the native KV cursor
+                listOptions.cursor = decodeCursor(options.cursor, tenantId, context);
+            }
+            const listed = await this.kv.list(listOptions);
+            const tenantPrefix = `${tenantId}:`;
+            const keys = listed.keys.map((keyInfo) => keyInfo.name.startsWith(tenantPrefix)
+                ? keyInfo.name.substring(tenantPrefix.length)
+                : keyInfo.name);
+            // Wrap native KV cursor in tenant-bound envelope
+            const nativeCursor = 'cursor' in listed && !listed.list_complete ? listed.cursor : undefined;
+            const nextCursor = nativeCursor ? encodeCursor(nativeCursor, tenantId) : undefined;
+            logger.debug(`[KvProvider] Found ${keys.length} keys with prefix: ${kvPrefix}`, context);
+            return {
+                keys,
+                nextCursor,
+            };
+        }, {
+            operation: 'KvProvider.list',
+            context,
+            input: { tenantId, prefix, options },
+        });
+    }
+    async getMany(tenantId, keys, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (keys.length === 0) {
+                return new Map();
+            }
+            const entries = await Promise.all(keys.map(async (key) => {
+                const value = await this.get(tenantId, key, context);
+                return [key, value];
+            }));
+            const results = new Map();
+            for (const [key, value] of entries) {
+                if (value !== null) {
+                    results.set(key, value);
+                }
+            }
+            return results;
+        }, {
+            operation: 'KvProvider.getMany',
+            context,
+            input: { tenantId, keyCount: keys.length },
+        });
+    }
+    async setMany(tenantId, entries, context, options) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (entries.size === 0) {
+                return;
+            }
+            const promises = Array.from(entries.entries()).map(([key, value]) => this.set(tenantId, key, value, context, options));
+            await Promise.all(promises);
+        }, {
+            operation: 'KvProvider.setMany',
+            context,
+            input: { tenantId, entryCount: entries.size },
+        });
+    }
+    async deleteMany(tenantId, keys, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (keys.length === 0) {
+                return 0;
+            }
+            const promises = keys.map((key) => this.delete(tenantId, key, context));
+            const results = await Promise.all(promises);
+            return results.filter((deleted) => deleted).length;
+        }, {
+            operation: 'KvProvider.deleteMany',
+            context,
+            input: { tenantId, keyCount: keys.length },
+        });
+    }
+    async clear(tenantId, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            const kvPrefix = `${tenantId}:`;
+            let deletedCount = 0;
+            let cursor;
+            let listComplete = false;
+            while (!listComplete) {
+                const listOpts = {
+                    prefix: kvPrefix,
+                    limit: 1000,
+                };
+                if (cursor) {
+                    listOpts.cursor = cursor;
+                }
+                const listed = await this.kv.list(listOpts);
+                const deletePromises = listed.keys.map((keyInfo) => this.kv.delete(keyInfo.name));
+                await Promise.all(deletePromises);
+                deletedCount += listed.keys.length;
+                listComplete = listed.list_complete;
+                cursor = 'cursor' in listed ? listed.cursor : undefined;
+            }
+            logger.info(`[KvProvider] Cleared ${deletedCount} keys for tenant: ${tenantId}`, context);
+            return deletedCount;
+        }, {
+            operation: 'KvProvider.clear',
+            context,
+            input: { tenantId },
+        });
+    }
+}
+//# sourceMappingURL=kvProvider.js.map

package/dist/storage/providers/cloudflare/kvProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kvProvider.js","sourceRoot":"","sources":["../../../../src/storage/providers/cloudflare/kvProvider.ts"],"names":[],"mappings":"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"}

package/dist/storage/providers/cloudflare/r2Provider.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Implements the IStorageProvider interface for Cloudflare R2.
+ *
+ * Performance note: TTL filtering in list operations is not applied at the R2 API level.
+ * Expired entries are only removed on get operations. For large datasets, consider
+ * implementing periodic cleanup jobs to remove expired entries.
+ *
+ * @module src/storage/providers/cloudflare/r2Provider
+ */
+import type { R2Bucket } from '@cloudflare/workers-types';
+import type { IStorageProvider, ListOptions, ListResult, StorageOptions } from '../../../storage/core/IStorageProvider.js';
+import type { RequestContext } from '../../../utils/internal/requestContext.js';
+export declare class R2Provider implements IStorageProvider {
+    private readonly bucket;
+    constructor(bucket: R2Bucket);
+    private getR2Key;
+    private buildEnvelope;
+    private parseAndValidate;
+    get<T>(tenantId: string, key: string, context: RequestContext): Promise<T | null>;
+    set(tenantId: string, key: string, value: unknown, context: RequestContext, options?: StorageOptions): Promise<void>;
+    delete(tenantId: string, key: string, context: RequestContext): Promise<boolean>;
+    list(tenantId: string, prefix: string, context: RequestContext, options?: ListOptions): Promise<ListResult>;
+    getMany<T>(tenantId: string, keys: string[], context: RequestContext): Promise<Map<string, T>>;
+    setMany(tenantId: string, entries: Map<string, unknown>, context: RequestContext, options?: StorageOptions): Promise<void>;
+    deleteMany(tenantId: string, keys: string[], context: RequestContext): Promise<number>;
+    clear(tenantId: string, context: RequestContext): Promise<number>;
+}
+//# sourceMappingURL=r2Provider.d.ts.map

package/dist/storage/providers/cloudflare/r2Provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2Provider.d.ts","sourceRoot":"","sources":["../../../../src/storage/providers/cloudflare/r2Provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,cAAc,EACf,MAAM,oCAAoC,CAAC;AAK5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAUzE,qBAAa,UAAW,YAAW,gBAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAEtB,MAAM,EAAE,QAAQ;IAU5B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,gBAAgB;IA4BlB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA0BjF,GAAG,CACP,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAqBV,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBhF,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC;IAiDhB,OAAO,CAAC,CAAC,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IA6BpB,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAoBV,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBtF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAsCxE"}