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

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

@@ -0,0 +1,222 @@
+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 R2_ENVELOPE_VERSION = 1;
+const DEFAULT_LIST_LIMIT = 1000;
+export class R2Provider {
+    bucket;
+    constructor(bucket) {
+        if (!bucket) {
+            throw new McpError(JsonRpcErrorCode.ConfigurationError, 'R2Provider requires a valid R2Bucket instance.');
+        }
+        this.bucket = bucket;
+    }
+    getR2Key(tenantId, key) {
+        return `${tenantId}:${key}`;
+    }
+    buildEnvelope(value, options) {
+        // Fix: Check for undefined instead of truthy to handle ttl=0 correctly
+        const expiresAt = options?.ttl !== undefined ? Date.now() + options.ttl * 1000 : undefined;
+        return {
+            __mcp: {
+                v: R2_ENVELOPE_VERSION,
+                ...(expiresAt !== undefined ? { expiresAt } : {}),
+            },
+            value,
+        };
+    }
+    parseAndValidate(raw, tenantId, key, context) {
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === 'object' && '__mcp' in parsed) {
+                const env = parsed;
+                const expiresAt = env.__mcp?.expiresAt;
+                if (expiresAt && Date.now() > expiresAt) {
+                    // expired
+                    return null;
+                }
+                return env.value;
+            }
+            // legacy: direct value
+            return parsed;
+        }
+        catch (error) {
+            throw new McpError(JsonRpcErrorCode.SerializationError, `[R2Provider] Failed to parse JSON for key: ${this.getR2Key(tenantId, key)}`, { ...context, error });
+        }
+    }
+    async get(tenantId, key, context) {
+        const r2Key = this.getR2Key(tenantId, key);
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[R2Provider] Getting key: ${r2Key}`, context);
+            const object = await this.bucket.get(r2Key);
+            if (object === null) {
+                return null;
+            }
+            const text = await object.text();
+            const value = this.parseAndValidate(text, tenantId, key, context);
+            if (value === null) {
+                // best-effort cleanup if expired
+                await this.bucket.delete(r2Key).catch(() => { });
+                logger.debug(`[R2Provider] Key expired and removed: ${r2Key}`, context);
+            }
+            return value;
+        }, {
+            operation: 'R2Provider.get',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async set(tenantId, key, value, context, options) {
+        const r2Key = this.getR2Key(tenantId, key);
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[R2Provider] Setting key: ${r2Key}`, {
+                ...context,
+                options,
+            });
+            const envelope = this.buildEnvelope(value, options);
+            const body = JSON.stringify(envelope);
+            await this.bucket.put(r2Key, body);
+            logger.debug(`[R2Provider] Successfully set key: ${r2Key}`, context);
+        }, {
+            operation: 'R2Provider.set',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async delete(tenantId, key, context) {
+        const r2Key = this.getR2Key(tenantId, key);
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[R2Provider] Deleting key: ${r2Key}`, context);
+            const head = await this.bucket.head(r2Key);
+            if (head === null) {
+                logger.debug(`[R2Provider] Key to delete not found: ${r2Key}`, context);
+                return false;
+            }
+            await this.bucket.delete(r2Key);
+            logger.debug(`[R2Provider] Successfully deleted key: ${r2Key}`, context);
+            return true;
+        }, {
+            operation: 'R2Provider.delete',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async list(tenantId, prefix, context, options) {
+        const r2Prefix = this.getR2Key(tenantId, prefix);
+        return await ErrorHandler.tryCatch(async () => {
+            logger.debug(`[R2Provider] Listing keys with prefix: ${r2Prefix}`, {
+                ...context,
+                options,
+            });
+            const limit = options?.limit ?? DEFAULT_LIST_LIMIT;
+            const listOptions = {
+                prefix: r2Prefix,
+                limit: limit + 1, // Fetch one extra to determine if there are more
+            };
+            if (options?.cursor) {
+                // Decode tenant-bound cursor to get the native R2 cursor
+                listOptions.cursor = decodeCursor(options.cursor, tenantId, context);
+            }
+            const listed = await this.bucket.list(listOptions);
+            const tenantPrefix = `${tenantId}:`;
+            const keys = listed.objects.map((obj) => obj.key.startsWith(tenantPrefix) ? obj.key.substring(tenantPrefix.length) : obj.key);
+            const hasMore = keys.length > limit;
+            const resultKeys = hasMore ? keys.slice(0, limit) : keys;
+            // Wrap native R2 cursor in tenant-bound envelope
+            const nativeCursor = 'cursor' in listed && listed.truncated ? listed.cursor : undefined;
+            const nextCursor = nativeCursor ? encodeCursor(nativeCursor, tenantId) : undefined;
+            logger.debug(`[R2Provider] Found ${resultKeys.length} keys with prefix: ${r2Prefix}`, context);
+            return {
+                keys: resultKeys,
+                nextCursor,
+            };
+        }, {
+            operation: 'R2Provider.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: 'R2Provider.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: 'R2Provider.setMany',
+            context,
+            input: { tenantId, entryCount: entries.size },
+        });
+    }
+    async deleteMany(tenantId, keys, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (keys.length === 0) {
+                return 0;
+            }
+            logger.debug(`[R2Provider] Batch deleting ${keys.length} keys`, context);
+            const r2Keys = keys.map((key) => this.getR2Key(tenantId, key));
+            await this.bucket.delete(r2Keys);
+            return keys.length;
+        }, {
+            operation: 'R2Provider.deleteMany',
+            context,
+            input: { tenantId, keyCount: keys.length },
+        });
+    }
+    async clear(tenantId, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            const r2Prefix = `${tenantId}:`;
+            let deletedCount = 0;
+            let cursor;
+            let hasMore = true;
+            while (hasMore) {
+                const listOpts = {
+                    prefix: r2Prefix,
+                    limit: 1000,
+                };
+                if (cursor) {
+                    listOpts.cursor = cursor;
+                }
+                const listed = await this.bucket.list(listOpts);
+                const objectKeys = listed.objects.map((obj) => obj.key);
+                if (objectKeys.length > 0) {
+                    await this.bucket.delete(objectKeys);
+                }
+                deletedCount += listed.objects.length;
+                hasMore = listed.truncated;
+                cursor = 'cursor' in listed ? listed.cursor : undefined;
+            }
+            logger.info(`[R2Provider] Cleared ${deletedCount} keys for tenant: ${tenantId}`, context);
+            return deletedCount;
+        }, {
+            operation: 'R2Provider.clear',
+            context,
+            input: { tenantId },
+        });
+    }
+}
+//# sourceMappingURL=r2Provider.js.map

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

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

package/dist/storage/providers/fileSystem/fileSystemProvider.d.ts

@@ -0,0 +1,20 @@
+import type { IStorageProvider, ListOptions, ListResult, StorageOptions } from '../../../storage/core/IStorageProvider.js';
+import type { RequestContext } from '../../../utils/internal/requestContext.js';
+export declare class FileSystemProvider implements IStorageProvider {
+    private readonly storagePath;
+    constructor(storagePath: string);
+    private getTenantPath;
+    private getFilePath;
+    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>;
+    private listFilesRecursively;
+    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=fileSystemProvider.d.ts.map

package/dist/storage/providers/fileSystem/fileSystemProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSystemProvider.d.ts","sourceRoot":"","sources":["../../../../src/storage/providers/fileSystem/fileSystemProvider.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,cAAc,EACf,MAAM,oCAAoC,CAAC;AAI5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAazE,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,WAAW,EAAE,MAAM;IAa/B,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,aAAa;YAYP,gBAAgB;IAmCxB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAsBjF,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;IAiBV,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;YAsBxE,oBAAoB;IAgB5B,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC;IA2DhB,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;IA4BpB,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;IAqBV,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;CAqBxE"}

package/dist/storage/providers/fileSystem/fileSystemProvider.js

@@ -0,0 +1,282 @@
+/**
+ * @fileoverview A filesystem-based storage provider.
+ * Persists data to the local filesystem in a specified directory.
+ * Each key-value pair is stored as a separate JSON file.
+ *
+ * Performance note: List operations with TTL filtering can be slow on large datasets
+ * as each file must be read and parsed to check expiration. Consider implementing
+ * periodic cleanup jobs for production use with large key counts.
+ *
+ * @module src/storage/providers/fileSystem/fileSystemProvider
+ */
+import { existsSync, mkdirSync } from 'node:fs';
+import { readdir, readFile, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+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 { sanitization } from '../../../utils/security/sanitization.js';
+import { isErrorWithCode } from '../../../utils/types/guards.js';
+const DEFAULT_LIST_LIMIT = 1000;
+const FILE_ENVELOPE_VERSION = 1;
+export class FileSystemProvider {
+    storagePath;
+    constructor(storagePath) {
+        if (!storagePath) {
+            throw new McpError(JsonRpcErrorCode.ConfigurationError, 'FileSystemProvider requires a valid storagePath.');
+        }
+        this.storagePath = path.resolve(storagePath);
+        if (!existsSync(this.storagePath)) {
+            mkdirSync(this.storagePath, { recursive: true });
+        }
+    }
+    getTenantPath(tenantId) {
+        const sanitizedTenantId = sanitization.sanitizePath(tenantId, {
+            toPosix: true,
+        }).sanitizedPath;
+        if (sanitizedTenantId.includes('/') || sanitizedTenantId.includes('..')) {
+            throw new McpError(JsonRpcErrorCode.ValidationError, 'Invalid tenantId contains path characters.');
+        }
+        const tenantPath = path.join(this.storagePath, sanitizedTenantId);
+        if (!existsSync(tenantPath)) {
+            mkdirSync(tenantPath, { recursive: true });
+        }
+        return tenantPath;
+    }
+    getFilePath(tenantId, key) {
+        const tenantPath = this.getTenantPath(tenantId);
+        const sanitizedKey = sanitization.sanitizePath(key, {
+            rootDir: tenantPath,
+            toPosix: true,
+        }).sanitizedPath;
+        const filePath = path.join(tenantPath, sanitizedKey);
+        if (!path.resolve(filePath).startsWith(path.resolve(tenantPath))) {
+            throw new McpError(JsonRpcErrorCode.ValidationError, 'Invalid key results in path traversal attempt.');
+        }
+        return filePath;
+    }
+    buildEnvelope(value, options) {
+        // Fix: Check for undefined instead of truthy to handle ttl=0 correctly
+        const expiresAt = options?.ttl !== undefined ? Date.now() + options.ttl * 1000 : undefined;
+        return {
+            __mcp: {
+                v: FILE_ENVELOPE_VERSION,
+                ...(expiresAt !== undefined ? { expiresAt } : {}),
+            },
+            value,
+        };
+    }
+    async parseAndValidate(raw, tenantId, key, filePath, context) {
+        try {
+            const parsed = JSON.parse(raw);
+            // Envelope-aware parsing
+            if (parsed && typeof parsed === 'object' && '__mcp' in parsed) {
+                const env = parsed;
+                const expiresAt = env.__mcp?.expiresAt;
+                if (expiresAt && Date.now() > expiresAt) {
+                    // Expired: best-effort delete and return null
+                    try {
+                        await rm(filePath);
+                    }
+                    catch {
+                        // ignore
+                    }
+                    return null;
+                }
+                return env.value;
+            }
+            // Legacy: return parsed directly
+            return parsed;
+        }
+        catch (error) {
+            throw new McpError(JsonRpcErrorCode.SerializationError, `Failed to parse stored JSON for key "${key}" (tenant "${tenantId}").`, { ...context, error });
+        }
+    }
+    async get(tenantId, key, context) {
+        const filePath = this.getFilePath(tenantId, key);
+        return await ErrorHandler.tryCatch(async () => {
+            try {
+                const data = await readFile(filePath, 'utf-8');
+                return this.parseAndValidate(data, tenantId, key, filePath, context);
+            }
+            catch (error) {
+                if (isErrorWithCode(error) && error.code === 'ENOENT') {
+                    return null; // File not found
+                }
+                throw error; // Re-throw other errors
+            }
+        }, {
+            operation: 'FileSystemProvider.get',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async set(tenantId, key, value, context, options) {
+        const filePath = this.getFilePath(tenantId, key);
+        return await ErrorHandler.tryCatch(async () => {
+            const envelope = this.buildEnvelope(value, options);
+            const content = JSON.stringify(envelope, null, 2);
+            mkdirSync(path.dirname(filePath), { recursive: true });
+            await writeFile(filePath, content, 'utf-8');
+        }, {
+            operation: 'FileSystemProvider.set',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async delete(tenantId, key, context) {
+        const filePath = this.getFilePath(tenantId, key);
+        return await ErrorHandler.tryCatch(async () => {
+            try {
+                await rm(filePath);
+                return true;
+            }
+            catch (error) {
+                if (isErrorWithCode(error) && error.code === 'ENOENT') {
+                    return false; // File didn't exist
+                }
+                throw error;
+            }
+        }, {
+            operation: 'FileSystemProvider.delete',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async listFilesRecursively(dir, baseDir) {
+        const entries = await readdir(dir, { withFileTypes: true });
+        const results = [];
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                results.push(...(await this.listFilesRecursively(fullPath, baseDir)));
+            }
+            else if (entry.isFile()) {
+                const rel = path.relative(baseDir, fullPath);
+                // Normalize to POSIX-style keys for consistency
+                results.push(rel.split(path.sep).join('/'));
+            }
+        }
+        return results;
+    }
+    async list(tenantId, prefix, context, options) {
+        return await ErrorHandler.tryCatch(async () => {
+            const tenantPath = this.getTenantPath(tenantId);
+            const allKeys = await this.listFilesRecursively(tenantPath, tenantPath);
+            const candidateKeys = allKeys.filter((k) => k.startsWith(prefix));
+            // TTL-aware filtering: best-effort; expensive on large stores.
+            const validKeys = [];
+            for (const k of candidateKeys) {
+                const filePath = this.getFilePath(tenantId, k);
+                try {
+                    const raw = await readFile(filePath, 'utf-8');
+                    const value = await this.parseAndValidate(raw, tenantId, k, filePath, context);
+                    if (value !== null) {
+                        validKeys.push(k);
+                    }
+                }
+                catch (_e) { }
+            }
+            // Sort for consistent pagination
+            validKeys.sort();
+            // Apply pagination with opaque cursors
+            const limit = options?.limit ?? DEFAULT_LIST_LIMIT;
+            let startIndex = 0;
+            if (options?.cursor) {
+                // Decode and validate cursor
+                const lastKey = decodeCursor(options.cursor, tenantId, context);
+                const cursorIndex = validKeys.indexOf(lastKey);
+                if (cursorIndex !== -1) {
+                    startIndex = cursorIndex + 1;
+                }
+                else {
+                    // Key was deleted between pages; resume from the next key after it
+                    const insertionPoint = validKeys.findIndex((k) => k > lastKey);
+                    startIndex = insertionPoint === -1 ? validKeys.length : insertionPoint;
+                }
+            }
+            const paginatedKeys = validKeys.slice(startIndex, startIndex + limit);
+            const nextCursor = startIndex + limit < validKeys.length && paginatedKeys.length > 0
+                ? encodeCursor(paginatedKeys[paginatedKeys.length - 1], tenantId)
+                : undefined;
+            return {
+                keys: paginatedKeys,
+                nextCursor,
+            };
+        }, {
+            operation: 'FileSystemProvider.list',
+            context,
+            input: { tenantId, prefix },
+        });
+    }
+    async getMany(tenantId, keys, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (keys.length === 0) {
+                return new Map();
+            }
+            // Parallel fetch for better performance
+            const promises = keys.map((key) => this.get(tenantId, key, context));
+            const values = await Promise.all(promises);
+            const results = new Map();
+            keys.forEach((key, i) => {
+                const value = values[i];
+                if (value !== null) {
+                    results.set(key, value);
+                }
+            });
+            return results;
+        }, {
+            operation: 'FileSystemProvider.getMany',
+            context,
+            input: { tenantId, keyCount: keys.length },
+        });
+    }
+    async setMany(tenantId, entries, context, options) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (entries.size === 0) {
+                return;
+            }
+            // Parallel set for better performance
+            const promises = Array.from(entries.entries()).map(([key, value]) => this.set(tenantId, key, value, context, options));
+            await Promise.all(promises);
+        }, {
+            operation: 'FileSystemProvider.setMany',
+            context,
+            input: { tenantId, entryCount: entries.size },
+        });
+    }
+    async deleteMany(tenantId, keys, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (keys.length === 0) {
+                return 0;
+            }
+            // Parallel delete for better performance
+            const promises = keys.map((key) => this.delete(tenantId, key, context));
+            const results = await Promise.all(promises);
+            return results.filter((deleted) => deleted).length;
+        }, {
+            operation: 'FileSystemProvider.deleteMany',
+            context,
+            input: { tenantId, keyCount: keys.length },
+        });
+    }
+    async clear(tenantId, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            const tenantPath = this.getTenantPath(tenantId);
+            const allKeys = await this.listFilesRecursively(tenantPath, tenantPath);
+            let deletedCount = 0;
+            for (const key of allKeys) {
+                const deleted = await this.delete(tenantId, key, context);
+                if (deleted) {
+                    deletedCount++;
+                }
+            }
+            return deletedCount;
+        }, {
+            operation: 'FileSystemProvider.clear',
+            context,
+            input: { tenantId },
+        });
+    }
+}
+//# sourceMappingURL=fileSystemProvider.js.map

package/dist/storage/providers/fileSystem/fileSystemProvider.js.map

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

package/dist/storage/providers/inMemory/inMemoryProvider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview An in-memory storage provider implementation.
+ * Ideal for development, testing, or scenarios where persistence is not required.
+ * Supports TTL (Time-To-Live) for entries.
+ * @module src/storage/providers/inMemory/inMemoryProvider
+ */
+import type { IStorageProvider, ListOptions, ListResult, StorageOptions } from '../../../storage/core/IStorageProvider.js';
+import type { RequestContext } from '../../../utils/internal/requestContext.js';
+export declare class InMemoryProvider implements IStorageProvider {
+    private readonly store;
+    private getTenantStore;
+    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=inMemoryProvider.d.ts.map

package/dist/storage/providers/inMemory/inMemoryProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemoryProvider.d.ts","sourceRoot":"","sources":["../../../../src/storage/providers/inMemory/inMemoryProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,cAAc,EACf,MAAM,oCAAoC,CAAC;AAG5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AASzE,qBAAa,gBAAiB,YAAW,gBAAgB;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsD;IAE5E,OAAO,CAAC,cAAc;IAStB,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAqBjF,GAAG,CACD,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;IAYhB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAMhF,IAAI,CACF,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC;IAoDhB,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;IA0BpB,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;IAsBV,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB5F,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAQlE"}