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

package/dist/storage/providers/inMemory/inMemoryProvider.js

@@ -0,0 +1,139 @@
+import { decodeCursor, encodeCursor } from '../../../storage/core/storageValidation.js';
+import { logger } from '../../../utils/internal/logger.js';
+const DEFAULT_LIST_LIMIT = 1000;
+export class InMemoryProvider {
+    store = new Map();
+    getTenantStore(tenantId) {
+        let tenantStore = this.store.get(tenantId);
+        if (!tenantStore) {
+            tenantStore = new Map();
+            this.store.set(tenantId, tenantStore);
+        }
+        return tenantStore;
+    }
+    get(tenantId, key, context) {
+        logger.debug(`[InMemoryProvider] Getting key: ${key} for tenant: ${tenantId}`, context);
+        const tenantStore = this.getTenantStore(tenantId);
+        const entry = tenantStore.get(key);
+        if (!entry) {
+            return Promise.resolve(null);
+        }
+        if (entry.expiresAt && Date.now() > entry.expiresAt) {
+            tenantStore.delete(key);
+            logger.debug(`[InMemoryProvider] Key expired and removed: ${key} for tenant: ${tenantId}`, context);
+            return Promise.resolve(null);
+        }
+        return Promise.resolve(entry.value);
+    }
+    set(tenantId, key, value, context, options) {
+        logger.debug(`[InMemoryProvider] Setting key: ${key} for tenant: ${tenantId}`, context);
+        const tenantStore = this.getTenantStore(tenantId);
+        // Fix: Check for undefined instead of truthy to handle ttl=0 correctly
+        const expiresAt = options?.ttl !== undefined ? Date.now() + options.ttl * 1000 : undefined;
+        tenantStore.set(key, {
+            value,
+            ...(expiresAt !== undefined && { expiresAt }),
+        });
+        return Promise.resolve();
+    }
+    delete(tenantId, key, context) {
+        logger.debug(`[InMemoryProvider] Deleting key: ${key} for tenant: ${tenantId}`, context);
+        const tenantStore = this.getTenantStore(tenantId);
+        return Promise.resolve(tenantStore.delete(key));
+    }
+    list(tenantId, prefix, context, options) {
+        logger.debug(`[InMemoryProvider] Listing keys with prefix: ${prefix} for tenant: ${tenantId}`, {
+            ...context,
+            options,
+        });
+        const tenantStore = this.getTenantStore(tenantId);
+        const now = Date.now();
+        const allKeys = [];
+        // Collect all matching non-expired keys
+        for (const [key, entry] of tenantStore.entries()) {
+            if (key.startsWith(prefix)) {
+                if (entry.expiresAt && now > entry.expiresAt) {
+                    tenantStore.delete(key); // Lazy cleanup
+                }
+                else {
+                    allKeys.push(key);
+                }
+            }
+        }
+        // Sort for consistent pagination
+        allKeys.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 = allKeys.indexOf(lastKey);
+            if (cursorIndex !== -1) {
+                startIndex = cursorIndex + 1;
+            }
+            else {
+                // Key was deleted between pages; resume from the next key after it
+                const insertionPoint = allKeys.findIndex((k) => k > lastKey);
+                startIndex = insertionPoint === -1 ? allKeys.length : insertionPoint;
+            }
+        }
+        const paginatedKeys = allKeys.slice(startIndex, startIndex + limit);
+        const nextCursor = startIndex + limit < allKeys.length && paginatedKeys.length > 0
+            ? encodeCursor(paginatedKeys[paginatedKeys.length - 1], tenantId)
+            : undefined;
+        return Promise.resolve({
+            keys: paginatedKeys,
+            nextCursor,
+        });
+    }
+    async getMany(tenantId, keys, context) {
+        if (keys.length === 0) {
+            return new Map();
+        }
+        logger.debug(`[InMemoryProvider] Getting ${keys.length} keys for tenant: ${tenantId}`, context);
+        // 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);
+            }
+        });
+        logger.debug(`[InMemoryProvider] Retrieved ${results.size}/${keys.length} keys for tenant: ${tenantId}`, context);
+        return results;
+    }
+    async setMany(tenantId, entries, context, options) {
+        if (entries.size === 0) {
+            return;
+        }
+        logger.debug(`[InMemoryProvider] Setting ${entries.size} keys for tenant: ${tenantId}`, context);
+        // 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);
+        logger.debug(`[InMemoryProvider] Successfully set ${entries.size} keys for tenant: ${tenantId}`, context);
+    }
+    async deleteMany(tenantId, keys, context) {
+        if (keys.length === 0) {
+            return 0;
+        }
+        logger.debug(`[InMemoryProvider] Deleting ${keys.length} keys for tenant: ${tenantId}`, context);
+        // Parallel delete for better performance
+        const promises = keys.map((key) => this.delete(tenantId, key, context));
+        const results = await Promise.all(promises);
+        const deletedCount = results.filter((deleted) => deleted).length;
+        logger.debug(`[InMemoryProvider] Deleted ${deletedCount}/${keys.length} keys for tenant: ${tenantId}`, context);
+        return deletedCount;
+    }
+    clear(tenantId, context) {
+        logger.debug(`[InMemoryProvider] Clearing all keys for tenant: ${tenantId}`, context);
+        const tenantStore = this.getTenantStore(tenantId);
+        const count = tenantStore.size;
+        tenantStore.clear();
+        logger.info(`[InMemoryProvider] Cleared ${count} keys for tenant: ${tenantId}`, context);
+        return Promise.resolve(count);
+    }
+}
+//# sourceMappingURL=inMemoryProvider.js.map

package/dist/storage/providers/inMemory/inMemoryProvider.js.map

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

package/dist/storage/providers/supabase/supabase.types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview This file defines the TypeScript types for the Supabase database schema.
+ * It is used to provide strong typing for the Supabase client.
+ * This could be auto-generated from the database schema in the future.
+ * @module src/storage/providers/supabase/supabase.types
+ */
+export type Json = string | number | boolean | null | {
+    [key: string]: Json | undefined;
+} | Json[];
+export type Database = {
+    public: {
+        Tables: {
+            kv_store: {
+                Row: {
+                    key: string;
+                    value: Json | null;
+                    expires_at: string | null;
+                    tenant_id: string;
+                };
+                Insert: {
+                    key: string;
+                    value: Json | null;
+                    expires_at?: string | null;
+                    tenant_id: string;
+                };
+                Update: {
+                    key?: string;
+                    value?: Json | null;
+                    expires_at?: string | null;
+                    tenant_id?: string;
+                };
+                Relationships: [];
+            };
+        };
+        Views: {
+            [_ in never]: never;
+        };
+        Functions: {
+            [_ in never]: never;
+        };
+        Enums: {
+            [_ in never]: never;
+        };
+        CompositeTypes: {
+            [_ in never]: never;
+        };
+    };
+};
+//# sourceMappingURL=supabase.types.d.ts.map

package/dist/storage/providers/supabase/supabase.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.types.d.ts","sourceRoot":"","sources":["../../../../src/storage/providers/supabase/supabase.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,GAAG,IAAI,EAAE,CAAC;AAEnG,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE;QACN,MAAM,EAAE;YACN,QAAQ,EAAE;gBACR,GAAG,EAAE;oBACH,GAAG,EAAE,MAAM,CAAC;oBACZ,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;oBACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;oBAC1B,SAAS,EAAE,MAAM,CAAC;iBACnB,CAAC;gBACF,MAAM,EAAE;oBACN,GAAG,EAAE,MAAM,CAAC;oBACZ,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;oBACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;oBAC3B,SAAS,EAAE,MAAM,CAAC;iBACnB,CAAC;gBACF,MAAM,EAAE;oBACN,GAAG,CAAC,EAAE,MAAM,CAAC;oBACb,KAAK,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;oBACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;oBAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;iBACpB,CAAC;gBACF,aAAa,EAAE,EAAE,CAAC;aACnB,CAAC;SACH,CAAC;QACF,KAAK,EAAE;aACJ,CAAC,IAAI,KAAK,GAAG,KAAK;SACpB,CAAC;QACF,SAAS,EAAE;aACR,CAAC,IAAI,KAAK,GAAG,KAAK;SACpB,CAAC;QACF,KAAK,EAAE;aACJ,CAAC,IAAI,KAAK,GAAG,KAAK;SACpB,CAAC;QACF,cAAc,EAAE;aACb,CAAC,IAAI,KAAK,GAAG,KAAK;SACpB,CAAC;KACH,CAAC;CACH,CAAC"}

package/dist/storage/providers/supabase/supabase.types.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview This file defines the TypeScript types for the Supabase database schema.
+ * It is used to provide strong typing for the Supabase client.
+ * This could be auto-generated from the database schema in the future.
+ * @module src/storage/providers/supabase/supabase.types
+ */
+export {};
+//# sourceMappingURL=supabase.types.js.map

package/dist/storage/providers/supabase/supabase.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.types.js","sourceRoot":"","sources":["../../../../src/storage/providers/supabase/supabase.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/storage/providers/supabase/supabaseProvider.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview A Supabase-based storage provider.
+ * Persists data to a specified table in a Supabase PostgreSQL database.
+ * Assumes a table with columns: `key` (text), `value` (jsonb), and `expires_at` (timestamptz).
+ * @module src/storage/providers/supabase/supabaseProvider
+ */
+import type { SupabaseClient } from '@supabase/supabase-js';
+import type { IStorageProvider, ListOptions, ListResult, StorageOptions } from '../../../storage/core/IStorageProvider.js';
+import type { Database } from '../../../storage/providers/supabase/supabase.types.js';
+import type { RequestContext } from '../../../utils/internal/requestContext.js';
+export declare class SupabaseProvider implements IStorageProvider {
+    private readonly client;
+    constructor(client: SupabaseClient<Database>);
+    private getClient;
+    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=supabaseProvider.d.ts.map

package/dist/storage/providers/supabase/supabaseProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabaseProvider.d.ts","sourceRoot":"","sources":["../../../../src/storage/providers/supabase/supabaseProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,cAAc,EACf,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAQ,MAAM,gDAAgD,CAAC;AAGrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAUzE,qBAAa,gBAAiB,YAAW,gBAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC;IAE7D,OAAO,CAAC,SAAS;IAIX,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAqCjF,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;IA4BV,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBhF,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;IAmCpB,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;IAgCV,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBtF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAsBxE"}

package/dist/storage/providers/supabase/supabaseProvider.js

@@ -0,0 +1,209 @@
+import { decodeCursor, encodeCursor } from '../../../storage/core/storageValidation.js';
+import { ErrorHandler } from '../../../utils/internal/error-handler/errorHandler.js';
+import { logger } from '../../../utils/internal/logger.js';
+const TABLE_NAME = 'kv_store';
+const DEFAULT_LIST_LIMIT = 1000;
+/** Escapes SQL LIKE wildcard characters (`%` and `_`) in a prefix string. */
+function escapeLikePattern(prefix) {
+    return prefix.replace(/[%_\\]/g, '\\$&');
+}
+export class SupabaseProvider {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    getClient() {
+        return this.client;
+    }
+    async get(tenantId, key, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            const { data, error } = await this.getClient()
+                .from(TABLE_NAME)
+                .select('value, expires_at')
+                .eq('tenant_id', tenantId)
+                .eq('key', key)
+                .single();
+            if (error) {
+                if (error.code === 'PGRST116') {
+                    // "Not found" error code from PostgREST
+                    return null;
+                }
+                throw error;
+            }
+            if (data.expires_at && new Date(data.expires_at).getTime() < Date.now()) {
+                await this.delete(tenantId, key, context);
+                logger.debug(`[SupabaseProvider] Key expired and removed: ${key} for tenant: ${tenantId}`, context);
+                return null;
+            }
+            return data.value;
+        }, {
+            operation: 'SupabaseProvider.get',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async set(tenantId, key, value, context, options) {
+        return await ErrorHandler.tryCatch(async () => {
+            // Fix: Check for undefined instead of truthy to handle ttl=0 correctly
+            const expires_at = options?.ttl !== undefined
+                ? new Date(Date.now() + options.ttl * 1000).toISOString()
+                : null;
+            const { error } = await this.getClient()
+                .from(TABLE_NAME)
+                .upsert({
+                tenant_id: tenantId,
+                key,
+                value: value,
+                expires_at,
+            });
+            if (error)
+                throw error;
+        }, {
+            operation: 'SupabaseProvider.set',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async delete(tenantId, key, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            const { error, count } = await this.getClient()
+                .from(TABLE_NAME)
+                .delete({ count: 'exact' })
+                .eq('tenant_id', tenantId)
+                .eq('key', key);
+            if (error)
+                throw error;
+            return (count ?? 0) > 0;
+        }, {
+            operation: 'SupabaseProvider.delete',
+            context,
+            input: { tenantId, key },
+        });
+    }
+    async list(tenantId, prefix, context, options) {
+        return await ErrorHandler.tryCatch(async () => {
+            const now = new Date().toISOString();
+            const limit = options?.limit ?? DEFAULT_LIST_LIMIT;
+            let query = this.getClient()
+                .from(TABLE_NAME)
+                .select('key')
+                .eq('tenant_id', tenantId)
+                .like('key', `${escapeLikePattern(prefix)}%`)
+                .or(`expires_at.is.null,expires_at.gt.${now}`)
+                .order('key', { ascending: true })
+                .limit(limit + 1); // Fetch one extra to determine if there are more results
+            // Apply cursor-based pagination with opaque cursors
+            if (options?.cursor) {
+                // Decode and validate cursor
+                const lastKey = decodeCursor(options.cursor, tenantId, context);
+                query = query.gt('key', lastKey);
+            }
+            const { data, error } = await query;
+            if (error)
+                throw error;
+            const keys = data?.map((item) => item.key) ?? [];
+            const hasMore = keys.length > limit;
+            const resultKeys = hasMore ? keys.slice(0, limit) : keys;
+            const nextCursor = hasMore && resultKeys.length > 0
+                ? encodeCursor(resultKeys[resultKeys.length - 1], tenantId)
+                : undefined;
+            return {
+                keys: resultKeys,
+                nextCursor,
+            };
+        }, {
+            operation: 'SupabaseProvider.list',
+            context,
+            input: { tenantId, prefix, options },
+        });
+    }
+    async getMany(tenantId, keys, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (keys.length === 0) {
+                return new Map();
+            }
+            const { data, error } = await this.getClient()
+                .from(TABLE_NAME)
+                .select('key, value, expires_at')
+                .eq('tenant_id', tenantId)
+                .in('key', keys);
+            if (error)
+                throw error;
+            const results = new Map();
+            for (const row of data ?? []) {
+                if (!row.expires_at || new Date(row.expires_at).getTime() >= Date.now()) {
+                    results.set(row.key, row.value);
+                }
+                else {
+                    // Clean up expired entries
+                    await this.delete(tenantId, row.key, context);
+                }
+            }
+            return results;
+        }, {
+            operation: 'SupabaseProvider.getMany',
+            context,
+            input: { tenantId, keyCount: keys.length },
+        });
+    }
+    async setMany(tenantId, entries, context, options) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (entries.size === 0) {
+                return;
+            }
+            // Fix: Check for undefined instead of truthy to handle ttl=0 correctly
+            const expires_at = options?.ttl !== undefined
+                ? new Date(Date.now() + options.ttl * 1000).toISOString()
+                : null;
+            const rows = Array.from(entries.entries()).map(([key, value]) => ({
+                tenant_id: tenantId,
+                key,
+                value: value,
+                expires_at,
+            }));
+            const { error } = await this.getClient().from(TABLE_NAME).upsert(rows);
+            if (error)
+                throw error;
+        }, {
+            operation: 'SupabaseProvider.setMany',
+            context,
+            input: { tenantId, entryCount: entries.size },
+        });
+    }
+    async deleteMany(tenantId, keys, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            if (keys.length === 0) {
+                return 0;
+            }
+            const { error, count } = await this.getClient()
+                .from(TABLE_NAME)
+                .delete({ count: 'exact' })
+                .eq('tenant_id', tenantId)
+                .in('key', keys);
+            if (error)
+                throw error;
+            return count ?? 0;
+        }, {
+            operation: 'SupabaseProvider.deleteMany',
+            context,
+            input: { tenantId, keyCount: keys.length },
+        });
+    }
+    async clear(tenantId, context) {
+        return await ErrorHandler.tryCatch(async () => {
+            const { error, count } = await this.getClient()
+                .from(TABLE_NAME)
+                .delete({ count: 'exact' })
+                .eq('tenant_id', tenantId);
+            if (error)
+                throw error;
+            logger.info(`[SupabaseProvider] Cleared ${count ?? 0} keys for tenant: ${tenantId}`, context);
+            return count ?? 0;
+        }, {
+            operation: 'SupabaseProvider.clear',
+            context,
+            input: { tenantId },
+        });
+    }
+}
+//# sourceMappingURL=supabaseProvider.js.map

package/dist/storage/providers/supabase/supabaseProvider.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Test utilities for MCP server development.
+ * Provides `createMockContext()` for testing tool and resource handlers
+ * against the unified Context interface.
+ * @module src/testing/index
+ */
+import type { CreateMessageResult, ElicitResult, SamplingMessage } from '@modelcontextprotocol/sdk/types.js';
+import type { z } from 'zod';
+import type { AuthContext, Context, SamplingOpts } from '../context.js';
+export interface MockContextOptions {
+    /** Auth context. */
+    auth?: AuthContext;
+    /** Mock elicitation handler. */
+    elicit?: (message: string, schema: z.ZodObject<z.ZodRawShape>) => Promise<ElicitResult>;
+    /** Enable task progress (creates a mock ContextProgress). */
+    progress?: boolean;
+    /** Request ID override. Defaults to 'test-request-id'. */
+    requestId?: string;
+    /** Mock sampling handler. */
+    sample?: (messages: SamplingMessage[], opts?: SamplingOpts) => Promise<CreateMessageResult>;
+    /** Custom AbortSignal. Defaults to a fresh AbortController's signal. */
+    signal?: AbortSignal;
+    /** Tenant ID. Enables ctx.state operations when provided. */
+    tenantId?: string;
+    /** Resource URI for resource handler testing. */
+    uri?: URL;
+}
+/**
+ * Creates a mock Context for testing tool and resource handlers.
+ *
+ * @example
+ * ```ts
+ * // Minimal — works for most tests
+ * const ctx = createMockContext();
+ *
+ * // With tenant (for tools that use ctx.state)
+ * const ctx = createMockContext({ tenantId: 'test-tenant' });
+ *
+ * // With sampling capability
+ * const ctx = createMockContext({
+ *   sample: vi.fn().mockResolvedValue({
+ *     role: 'assistant',
+ *     content: { type: 'text', text: 'Response' },
+ *     model: 'test',
+ *   }),
+ * });
+ *
+ * // With task progress
+ * const ctx = createMockContext({ progress: true });
+ * ```
+ */
+export declare function createMockContext(options?: MockContextOptions): Context;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACZ,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,WAAW,EACX,OAAO,EAIP,YAAY,EACb,MAAM,cAAc,CAAC;AAMtB,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,gCAAgC;IAChC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACxF,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5F,wEAAwE;IACxE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAwGD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAkB3E"}

package/dist/testing/index.js

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Test utilities for MCP server development.
+ * Provides `createMockContext()` for testing tool and resource handlers
+ * against the unified Context interface.
+ * @module src/testing/index
+ */
+// ---------------------------------------------------------------------------
+// Mock implementations
+// ---------------------------------------------------------------------------
+function createMockLogger() {
+    const calls = [];
+    const logFn = (level) => (msg, data) => {
+        calls.push({ level, msg, data });
+    };
+    return {
+        calls,
+        debug: logFn('debug'),
+        info: logFn('info'),
+        notice: logFn('notice'),
+        warning: logFn('warning'),
+        error: (msg, _error, data) => {
+            calls.push({ level: 'error', msg, data });
+        },
+    };
+}
+function createMockState(tenantId) {
+    const store = new Map();
+    const requireTenant = () => {
+        if (!tenantId) {
+            throw new Error('tenantId required for state operations');
+        }
+    };
+    return {
+        get(key) {
+            requireTenant();
+            return Promise.resolve(store.get(key) ?? null);
+        },
+        set(key, value) {
+            requireTenant();
+            store.set(key, value);
+            return Promise.resolve();
+        },
+        delete(key) {
+            requireTenant();
+            store.delete(key);
+            return Promise.resolve();
+        },
+        list(prefix) {
+            requireTenant();
+            const items = [];
+            for (const [key, value] of store) {
+                if (!prefix || key.startsWith(prefix)) {
+                    items.push({ key, value });
+                }
+            }
+            return Promise.resolve({ items });
+        },
+    };
+}
+function createMockProgress() {
+    const state = { _total: 0, _completed: 0, _messages: [] };
+    return {
+        get _total() {
+            return state._total;
+        },
+        get _completed() {
+            return state._completed;
+        },
+        get _messages() {
+            return state._messages;
+        },
+        setTotal(n) {
+            state._total = n;
+            state._completed = 0;
+            return Promise.resolve();
+        },
+        increment(amount = 1) {
+            state._completed = Math.min(state._completed + amount, state._total || state._completed + amount);
+            return Promise.resolve();
+        },
+        update(message) {
+            state._messages.push(message);
+            return Promise.resolve();
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates a mock Context for testing tool and resource handlers.
+ *
+ * @example
+ * ```ts
+ * // Minimal — works for most tests
+ * const ctx = createMockContext();
+ *
+ * // With tenant (for tools that use ctx.state)
+ * const ctx = createMockContext({ tenantId: 'test-tenant' });
+ *
+ * // With sampling capability
+ * const ctx = createMockContext({
+ *   sample: vi.fn().mockResolvedValue({
+ *     role: 'assistant',
+ *     content: { type: 'text', text: 'Response' },
+ *     model: 'test',
+ *   }),
+ * });
+ *
+ * // With task progress
+ * const ctx = createMockContext({ progress: true });
+ * ```
+ */
+export function createMockContext(options = {}) {
+    const log = createMockLogger();
+    const state = createMockState(options.tenantId);
+    const progress = options.progress ? createMockProgress() : undefined;
+    return {
+        requestId: options.requestId ?? 'test-request-id',
+        timestamp: new Date().toISOString(),
+        log,
+        state,
+        signal: options.signal ?? new AbortController().signal,
+        tenantId: options.tenantId,
+        auth: options.auth,
+        elicit: options.elicit,
+        sample: options.sample,
+        progress,
+        uri: options.uri,
+    };
+}
+//# sourceMappingURL=index.js.map