@frontmcp/sdk 0.5.1 → 0.6.1

package/src/store/adapters/store.vercel-kv.adapter.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * Vercel KV Store Adapter
+ *
+ * Store adapter implementation using Vercel KV (edge-compatible REST-based key-value store).
+ * Uses dynamic import to avoid bundling @vercel/kv for non-Vercel deployments.
+ *
+ * @see https://vercel.com/docs/storage/vercel-kv
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopedVercelKvStore = void 0;
+const store_base_adapter_1 = require("./store.base.adapter");
+/**
+ * Vercel KV Store Adapter
+ *
+ * Implements the StoreDriver interface using Vercel KV.
+ * Note: Pub/Sub is not supported by Vercel KV (REST-based).
+ * The base class provides no-op implementations for publish/subscribe.
+ *
+ * @example
+ * ```typescript
+ * const store = new ScopedVercelKvStore({
+ *   url: process.env.KV_REST_API_URL,
+ *   token: process.env.KV_REST_API_TOKEN,
+ *   keyPrefix: 'myapp:',
+ * });
+ * await store.connect();
+ * await store.set('key', 'value', { ttlSeconds: 3600 });
+ * const value = await store.get('key');
+ * ```
+ */
+class ScopedVercelKvStore extends store_base_adapter_1.StoreBaseAdapter {
+    kv = null;
+    opts;
+    constructor(opts = {}) {
+        super();
+        this.opts = opts;
+    }
+    /**
+     * Connect to Vercel KV
+     * Uses dynamic import to avoid bundling @vercel/kv when not used
+     */
+    async connect() {
+        if (this.kv)
+            return;
+        // Dynamic import for tree-shaking
+        const vercelKv = await import('@vercel/kv');
+        const url = this.opts.url || process.env['KV_REST_API_URL'];
+        const token = this.opts.token || process.env['KV_REST_API_TOKEN'];
+        if (!url || !token) {
+            throw new Error('Vercel KV requires url and token. Set KV_REST_API_URL and KV_REST_API_TOKEN environment variables or provide them in config.');
+        }
+        // Cast to our interface to avoid type compatibility issues
+        this.kv = vercelKv.createClient({ url, token });
+    }
+    /**
+     * Disconnect from Vercel KV
+     * Vercel KV uses REST API, so there's no persistent connection to close
+     */
+    async disconnect() {
+        this.kv = null;
+    }
+    ensureConnected() {
+        if (!this.kv) {
+            throw new Error('Vercel KV not connected. Call connect() first.');
+        }
+        return this.kv;
+    }
+    prefixKey(key) {
+        if (!key || key.trim() === '') {
+            throw new Error('[ScopedVercelKvStore] key cannot be empty');
+        }
+        return this.opts.keyPrefix ? `${this.opts.keyPrefix}${key}` : key;
+    }
+    async get(key) {
+        const kv = this.ensureConnected();
+        const result = await kv.get(this.prefixKey(key));
+        return result ?? null;
+    }
+    async set(key, value, opts) {
+        const kv = this.ensureConnected();
+        const prefixedKey = this.prefixKey(key);
+        if (opts?.ttlSeconds && opts.ttlSeconds > 0) {
+            await kv.set(prefixedKey, value, { ex: Math.floor(opts.ttlSeconds) });
+        }
+        else {
+            await kv.set(prefixedKey, value);
+        }
+    }
+    async del(key) {
+        const kv = this.ensureConnected();
+        await kv.del(this.prefixKey(key));
+    }
+    async exists(key) {
+        const kv = this.ensureConnected();
+        const result = await kv.exists(this.prefixKey(key));
+        return result === 1;
+    }
+    /**
+     * Get multiple keys
+     * Uses Vercel KV's mget for efficiency
+     */
+    async mget(keys) {
+        if (!keys.length)
+            return [];
+        const kv = this.ensureConnected();
+        const prefixedKeys = keys.map((k) => this.prefixKey(k));
+        const results = await kv.mget(...prefixedKeys);
+        return results.map((r) => r ?? null);
+    }
+    /**
+     * Set multiple keys
+     * Uses Vercel KV's mset for efficiency (no TTL support in bulk)
+     * Falls back to sequential sets for TTL support
+     */
+    async mset(entries) {
+        if (!entries.length)
+            return;
+        const kv = this.ensureConnected();
+        const hasTtl = entries.some((e) => e.opts?.ttlSeconds && e.opts.ttlSeconds > 0);
+        if (hasTtl) {
+            // Sequential sets to support TTL
+            for (const { key, value, opts } of entries) {
+                await this.set(key, value, opts);
+            }
+        }
+        else {
+            // Bulk set without TTL
+            const kvPairs = {};
+            for (const { key, value } of entries) {
+                kvPairs[this.prefixKey(key)] = value;
+            }
+            await kv.mset(kvPairs);
+        }
+    }
+    async incr(key) {
+        const kv = this.ensureConnected();
+        return kv.incr(this.prefixKey(key));
+    }
+    async decr(key) {
+        const kv = this.ensureConnected();
+        return kv.decr(this.prefixKey(key));
+    }
+    async expire(key, ttlSeconds) {
+        const kv = this.ensureConnected();
+        await kv.expire(this.prefixKey(key), Math.floor(ttlSeconds));
+    }
+    async ttl(key) {
+        const kv = this.ensureConnected();
+        const t = await kv.ttl(this.prefixKey(key));
+        return t < 0 ? null : t;
+    }
+}
+exports.ScopedVercelKvStore = ScopedVercelKvStore;
+//# sourceMappingURL=store.vercel-kv.adapter.js.map

package/src/store/adapters/store.vercel-kv.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.vercel-kv.adapter.js","sourceRoot":"","sources":["../../../../src/store/adapters/store.vercel-kv.adapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Vercel KV Store Adapter\n *\n * Store adapter implementation using Vercel KV (edge-compatible REST-based key-value store).\n * Uses dynamic import to avoid bundling @vercel/kv for non-Vercel deployments.\n *\n * @see https://vercel.com/docs/storage/vercel-kv\n */\n\nimport { StoreBaseAdapter } from './store.base.adapter';\nimport type { SetOptions } from '../store.types';\n\n// Interface for the Vercel KV client (matches @vercel/kv API)\ninterface VercelKVClient {\n  get<T = unknown>(key: string): Promise<T | null>;\n  set(key: string, value: unknown, options?: { ex?: number; px?: number }): Promise<void>;\n  del(...keys: string[]): Promise<number>;\n  exists(...keys: string[]): Promise<number>;\n  mget<T = unknown>(...keys: string[]): Promise<(T | null)[]>;\n  mset(data: Record<string, unknown>): Promise<void>;\n  incr(key: string): Promise<number>;\n  decr(key: string): Promise<number>;\n  expire(key: string, seconds: number): Promise<number>;\n  pexpire(key: string, milliseconds: number): Promise<number>;\n  ttl(key: string): Promise<number>;\n}\n\nexport interface VercelKvAdapterOptions {\n  /**\n   * KV REST API URL\n   * @default process.env.KV_REST_API_URL\n   */\n  url?: string;\n\n  /**\n   * KV REST API Token\n   * @default process.env.KV_REST_API_TOKEN\n   */\n  token?: string;\n\n  /**\n   * Key prefix for all keys\n   * @default ''\n   */\n  keyPrefix?: string;\n}\n\n/**\n * Vercel KV Store Adapter\n *\n * Implements the StoreDriver interface using Vercel KV.\n * Note: Pub/Sub is not supported by Vercel KV (REST-based).\n * The base class provides no-op implementations for publish/subscribe.\n *\n * @example\n * ```typescript\n * const store = new ScopedVercelKvStore({\n *   url: process.env.KV_REST_API_URL,\n *   token: process.env.KV_REST_API_TOKEN,\n *   keyPrefix: 'myapp:',\n * });\n * await store.connect();\n * await store.set('key', 'value', { ttlSeconds: 3600 });\n * const value = await store.get('key');\n * ```\n */\nexport class ScopedVercelKvStore extends StoreBaseAdapter {\n  private kv: VercelKVClient | null = null;\n  private readonly opts: VercelKvAdapterOptions;\n\n  constructor(opts: VercelKvAdapterOptions = {}) {\n    super();\n    this.opts = opts;\n  }\n\n  /**\n   * Connect to Vercel KV\n   * Uses dynamic import to avoid bundling @vercel/kv when not used\n   */\n  async connect(): Promise<void> {\n    if (this.kv) return;\n\n    // Dynamic import for tree-shaking\n    const vercelKv = await import('@vercel/kv');\n\n    const url = this.opts.url || process.env['KV_REST_API_URL'];\n    const token = this.opts.token || process.env['KV_REST_API_TOKEN'];\n\n    if (!url || !token) {\n      throw new Error(\n        'Vercel KV requires url and token. Set KV_REST_API_URL and KV_REST_API_TOKEN environment variables or provide them in config.',\n      );\n    }\n\n    // Cast to our interface to avoid type compatibility issues\n    this.kv = vercelKv.createClient({ url, token }) as unknown as VercelKVClient;\n  }\n\n  /**\n   * Disconnect from Vercel KV\n   * Vercel KV uses REST API, so there's no persistent connection to close\n   */\n  async disconnect(): Promise<void> {\n    this.kv = null;\n  }\n\n  private ensureConnected(): VercelKVClient {\n    if (!this.kv) {\n      throw new Error('Vercel KV not connected. Call connect() first.');\n    }\n    return this.kv;\n  }\n\n  private prefixKey(key: string): string {\n    if (!key || key.trim() === '') {\n      throw new Error('[ScopedVercelKvStore] key cannot be empty');\n    }\n    return this.opts.keyPrefix ? `${this.opts.keyPrefix}${key}` : key;\n  }\n\n  async get(key: string): Promise<string | null> {\n    const kv = this.ensureConnected();\n    const result = await kv.get<string>(this.prefixKey(key));\n    return result ?? null;\n  }\n\n  async set(key: string, value: string, opts?: SetOptions): Promise<void> {\n    const kv = this.ensureConnected();\n    const prefixedKey = this.prefixKey(key);\n\n    if (opts?.ttlSeconds && opts.ttlSeconds > 0) {\n      await kv.set(prefixedKey, value, { ex: Math.floor(opts.ttlSeconds) });\n    } else {\n      await kv.set(prefixedKey, value);\n    }\n  }\n\n  async del(key: string): Promise<void> {\n    const kv = this.ensureConnected();\n    await kv.del(this.prefixKey(key));\n  }\n\n  async exists(key: string): Promise<boolean> {\n    const kv = this.ensureConnected();\n    const result = await kv.exists(this.prefixKey(key));\n    return result === 1;\n  }\n\n  /**\n   * Get multiple keys\n   * Uses Vercel KV's mget for efficiency\n   */\n  override async mget(keys: string[]): Promise<(string | null)[]> {\n    if (!keys.length) return [];\n    const kv = this.ensureConnected();\n    const prefixedKeys = keys.map((k) => this.prefixKey(k));\n    const results = await kv.mget<string>(...prefixedKeys);\n    return results.map((r) => r ?? null);\n  }\n\n  /**\n   * Set multiple keys\n   * Uses Vercel KV's mset for efficiency (no TTL support in bulk)\n   * Falls back to sequential sets for TTL support\n   */\n  override async mset(entries: Array<{ key: string; value: string; opts?: SetOptions }>): Promise<void> {\n    if (!entries.length) return;\n\n    const kv = this.ensureConnected();\n    const hasTtl = entries.some((e) => e.opts?.ttlSeconds && e.opts.ttlSeconds > 0);\n\n    if (hasTtl) {\n      // Sequential sets to support TTL\n      for (const { key, value, opts } of entries) {\n        await this.set(key, value, opts);\n      }\n    } else {\n      // Bulk set without TTL\n      const kvPairs: Record<string, string> = {};\n      for (const { key, value } of entries) {\n        kvPairs[this.prefixKey(key)] = value;\n      }\n      await kv.mset(kvPairs);\n    }\n  }\n\n  async incr(key: string): Promise<number> {\n    const kv = this.ensureConnected();\n    return kv.incr(this.prefixKey(key));\n  }\n\n  async decr(key: string): Promise<number> {\n    const kv = this.ensureConnected();\n    return kv.decr(this.prefixKey(key));\n  }\n\n  async expire(key: string, ttlSeconds: number): Promise<void> {\n    const kv = this.ensureConnected();\n    await kv.expire(this.prefixKey(key), Math.floor(ttlSeconds));\n  }\n\n  async ttl(key: string): Promise<number | null> {\n    const kv = this.ensureConnected();\n    const t = await kv.ttl(this.prefixKey(key));\n    return t < 0 ? null : t;\n  }\n\n  // Note: Pub/Sub is not supported by Vercel KV (REST-based)\n  // Base class provides no-op implementations that return 0 for publish\n  // and a no-op unsubscribe function for subscribe\n}\n"]}

package/src/store/index.d.ts

@@ -3,6 +3,8 @@ export * from './store.tokens';
 export * from './store.utils';
 export * from './store.registry';
 export * from './store.helpers';
+export * from './store.factory';
 export * from './adapters/store.base.adapter';
 export * from './adapters/store.redis.adapter';
 export * from './adapters/store.memory.adapter';
+export * from './adapters/store.vercel-kv.adapter';

package/src/store/index.js

@@ -6,7 +6,9 @@ tslib_1.__exportStar(require("./store.tokens"), exports);
 tslib_1.__exportStar(require("./store.utils"), exports);
 tslib_1.__exportStar(require("./store.registry"), exports);
 tslib_1.__exportStar(require("./store.helpers"), exports);
+tslib_1.__exportStar(require("./store.factory"), exports);
 tslib_1.__exportStar(require("./adapters/store.base.adapter"), exports);
 tslib_1.__exportStar(require("./adapters/store.redis.adapter"), exports);
 tslib_1.__exportStar(require("./adapters/store.memory.adapter"), exports);
+tslib_1.__exportStar(require("./adapters/store.vercel-kv.adapter"), exports);
 //# sourceMappingURL=index.js.map

package/src/store/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,yDAA+B;AAC/B,wDAA8B;AAC9B,2DAAiC;AACjC,0DAAgC;AAChC,wEAA8C;AAC9C,yEAA+C;AAC/C,0EAAgD","sourcesContent":["export * from './store.types';\nexport * from './store.tokens';\nexport * from './store.utils';\nexport * from './store.registry';\nexport * from './store.helpers';\nexport * from './adapters/store.base.adapter';\nexport * from './adapters/store.redis.adapter';\nexport * from './adapters/store.memory.adapter';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,yDAA+B;AAC/B,wDAA8B;AAC9B,2DAAiC;AACjC,0DAAgC;AAChC,0DAAgC;AAChC,wEAA8C;AAC9C,yEAA+C;AAC/C,0EAAgD;AAChD,6EAAmD","sourcesContent":["export * from './store.types';\nexport * from './store.tokens';\nexport * from './store.utils';\nexport * from './store.registry';\nexport * from './store.helpers';\nexport * from './store.factory';\nexport * from './adapters/store.base.adapter';\nexport * from './adapters/store.redis.adapter';\nexport * from './adapters/store.memory.adapter';\nexport * from './adapters/store.vercel-kv.adapter';\n"]}

package/src/store/store.factory.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Storage Factory
+ *
+ * Factory functions for creating store drivers and session stores
+ * based on configuration. Supports both Redis and Vercel KV providers.
+ */
+import type { StoreDriver } from './store.types';
+import type { SessionStore } from '../auth/session/transport-session.types';
+import type { FrontMcpLogger } from '../common/interfaces/logger.interface';
+import { type RedisOptions, type PubsubOptions } from '../common/types/options/redis.options';
+/**
+ * Create a store driver based on configuration
+ *
+ * @param options - Storage configuration (Redis or Vercel KV)
+ * @returns A store driver instance (not connected)
+ *
+ * @example Redis
+ * ```typescript
+ * const driver = createStoreDriver({
+ *   provider: 'redis',
+ *   host: 'localhost',
+ *   port: 6379,
+ * });
+ * await driver.connect();
+ * ```
+ *
+ * @example Vercel KV
+ * ```typescript
+ * const driver = createStoreDriver({
+ *   provider: 'vercel-kv',
+ *   // Uses KV_REST_API_URL and KV_REST_API_TOKEN env vars
+ * });
+ * await driver.connect();
+ * ```
+ */
+export declare function createStoreDriver(options: RedisOptions): StoreDriver;
+/**
+ * Create a session store based on configuration
+ *
+ * @param options - Storage configuration (Redis or Vercel KV)
+ * @param logger - Optional logger instance
+ * @returns A session store instance
+ *
+ * @example Redis
+ * ```typescript
+ * const store = await createSessionStore({
+ *   provider: 'redis',
+ *   host: 'localhost',
+ *   port: 6379,
+ * });
+ * ```
+ *
+ * @example Vercel KV
+ * ```typescript
+ * const store = await createSessionStore({
+ *   provider: 'vercel-kv',
+ * });
+ * ```
+ */
+export declare function createSessionStore(options: RedisOptions, logger?: FrontMcpLogger): Promise<SessionStore>;
+/**
+ * Create a session store synchronously (for backwards compatibility)
+ * Note: For Vercel KV, use createSessionStore() instead as it requires async connect
+ *
+ * @param options - Storage configuration (Redis only)
+ * @param logger - Optional logger instance
+ * @returns A session store instance
+ */
+export declare function createSessionStoreSync(options: RedisOptions, logger?: FrontMcpLogger): SessionStore;
+/**
+ * Create a pub/sub store for resource subscriptions
+ *
+ * Pub/Sub requires Redis - Vercel KV does not support pub/sub operations.
+ * Use this when you need resource subscriptions with Vercel KV for sessions.
+ *
+ * @param options - Pub/sub configuration (Redis only)
+ * @returns A Redis store driver with pub/sub support
+ *
+ * @example Hybrid config
+ * ```typescript
+ * // Use Vercel KV for sessions, Redis for pub/sub
+ * const sessionStore = await createSessionStore({ provider: 'vercel-kv' });
+ * const pubsubStore = createPubsubStore({ host: 'localhost', port: 6379 });
+ * ```
+ */
+export declare function createPubsubStore(options: PubsubOptions): StoreDriver;

package/src/store/store.factory.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * Storage Factory
+ *
+ * Factory functions for creating store drivers and session stores
+ * based on configuration. Supports both Redis and Vercel KV providers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStoreDriver = createStoreDriver;
+exports.createSessionStore = createSessionStore;
+exports.createSessionStoreSync = createSessionStoreSync;
+exports.createPubsubStore = createPubsubStore;
+const redis_options_1 = require("../common/types/options/redis.options");
+/**
+ * Create a store driver based on configuration
+ *
+ * @param options - Storage configuration (Redis or Vercel KV)
+ * @returns A store driver instance (not connected)
+ *
+ * @example Redis
+ * ```typescript
+ * const driver = createStoreDriver({
+ *   provider: 'redis',
+ *   host: 'localhost',
+ *   port: 6379,
+ * });
+ * await driver.connect();
+ * ```
+ *
+ * @example Vercel KV
+ * ```typescript
+ * const driver = createStoreDriver({
+ *   provider: 'vercel-kv',
+ *   // Uses KV_REST_API_URL and KV_REST_API_TOKEN env vars
+ * });
+ * await driver.connect();
+ * ```
+ */
+function createStoreDriver(options) {
+    if ((0, redis_options_1.isVercelKvProvider)(options)) {
+        return createVercelKvStoreDriver(options);
+    }
+    if ((0, redis_options_1.isRedisProvider)(options)) {
+        return createRedisStoreDriver(options);
+    }
+    // Fallback for legacy format without provider field
+    return createRedisStoreDriver(options);
+}
+/**
+ * Create a Redis store driver
+ */
+function createRedisStoreDriver(options) {
+    // Lazy import to avoid bundling ioredis when not used
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { ScopedRedisStore } = require('./adapters/store.redis.adapter');
+    return new ScopedRedisStore({
+        options: {
+            host: options.host,
+            port: options.port,
+            password: options.password,
+            db: options.db,
+            tls: options.tls ? {} : undefined,
+            keyPrefix: options.keyPrefix,
+        },
+    });
+}
+/**
+ * Create a Vercel KV store driver
+ */
+function createVercelKvStoreDriver(options) {
+    // Lazy import to avoid bundling @vercel/kv when not used
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { ScopedVercelKvStore } = require('./adapters/store.vercel-kv.adapter');
+    return new ScopedVercelKvStore({
+        url: options.url,
+        token: options.token,
+        keyPrefix: options.keyPrefix,
+    });
+}
+/**
+ * Create a session store based on configuration
+ *
+ * @param options - Storage configuration (Redis or Vercel KV)
+ * @param logger - Optional logger instance
+ * @returns A session store instance
+ *
+ * @example Redis
+ * ```typescript
+ * const store = await createSessionStore({
+ *   provider: 'redis',
+ *   host: 'localhost',
+ *   port: 6379,
+ * });
+ * ```
+ *
+ * @example Vercel KV
+ * ```typescript
+ * const store = await createSessionStore({
+ *   provider: 'vercel-kv',
+ * });
+ * ```
+ */
+async function createSessionStore(options, logger) {
+    if ((0, redis_options_1.isVercelKvProvider)(options)) {
+        return createVercelKvSessionStore(options, logger);
+    }
+    if ((0, redis_options_1.isRedisProvider)(options)) {
+        return createRedisSessionStore(options, logger);
+    }
+    // Fallback for legacy format without provider field
+    return createRedisSessionStore(options, logger);
+}
+/**
+ * Create a Redis session store
+ */
+async function createRedisSessionStore(options, logger) {
+    // Lazy require to avoid bundling ioredis when not used
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { RedisSessionStore } = require('../auth/session/redis-session.store');
+    return new RedisSessionStore({
+        host: options.host,
+        port: options.port,
+        password: options.password,
+        db: options.db,
+        tls: options.tls,
+        keyPrefix: options.keyPrefix ? `${options.keyPrefix}session:` : 'mcp:session:',
+        defaultTtlMs: options.defaultTtlMs,
+    }, logger);
+}
+/**
+ * Create a Vercel KV session store
+ */
+async function createVercelKvSessionStore(options, logger) {
+    // Lazy require to avoid bundling @vercel/kv when not used
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { VercelKvSessionStore } = require('../auth/session/vercel-kv-session.store');
+    const store = new VercelKvSessionStore({
+        url: options.url,
+        token: options.token,
+        keyPrefix: options.keyPrefix ? `${options.keyPrefix}session:` : 'mcp:session:',
+        defaultTtlMs: options.defaultTtlMs,
+    }, logger);
+    // Pre-connect for Vercel KV
+    await store.connect();
+    return store;
+}
+/**
+ * Create a session store synchronously (for backwards compatibility)
+ * Note: For Vercel KV, use createSessionStore() instead as it requires async connect
+ *
+ * @param options - Storage configuration (Redis only)
+ * @param logger - Optional logger instance
+ * @returns A session store instance
+ */
+function createSessionStoreSync(options, logger) {
+    if ((0, redis_options_1.isVercelKvProvider)(options)) {
+        throw new Error('Vercel KV session store requires async initialization. Use createSessionStore() instead.');
+    }
+    // Redis only - synchronous creation
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { RedisSessionStore } = require('../auth/session/redis-session.store');
+    const redisOptions = (0, redis_options_1.isRedisProvider)(options) ? options : options;
+    return new RedisSessionStore({
+        host: redisOptions.host,
+        port: redisOptions.port,
+        password: redisOptions.password,
+        db: redisOptions.db,
+        tls: redisOptions.tls,
+        keyPrefix: redisOptions.keyPrefix ? `${redisOptions.keyPrefix}session:` : 'mcp:session:',
+        defaultTtlMs: redisOptions.defaultTtlMs,
+    }, logger);
+}
+/**
+ * Create a pub/sub store for resource subscriptions
+ *
+ * Pub/Sub requires Redis - Vercel KV does not support pub/sub operations.
+ * Use this when you need resource subscriptions with Vercel KV for sessions.
+ *
+ * @param options - Pub/sub configuration (Redis only)
+ * @returns A Redis store driver with pub/sub support
+ *
+ * @example Hybrid config
+ * ```typescript
+ * // Use Vercel KV for sessions, Redis for pub/sub
+ * const sessionStore = await createSessionStore({ provider: 'vercel-kv' });
+ * const pubsubStore = createPubsubStore({ host: 'localhost', port: 6379 });
+ * ```
+ */
+function createPubsubStore(options) {
+    // PubsubOptions only allows Redis provider, so we can safely cast
+    const redisOptions = options;
+    return createRedisStoreDriver(redisOptions);
+}
+//# sourceMappingURL=store.factory.js.map

package/src/store/store.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.factory.js","sourceRoot":"","sources":["../../../src/store/store.factory.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Storage Factory\n *\n * Factory functions for creating store drivers and session stores\n * based on configuration. Supports both Redis and Vercel KV providers.\n */\n\nimport type { StoreDriver } from './store.types';\nimport type { SessionStore } from '../auth/session/transport-session.types';\nimport type { FrontMcpLogger } from '../common/interfaces/logger.interface';\nimport {\n  type RedisOptions,\n  type RedisProviderOptions,\n  type VercelKvProviderOptions,\n  type PubsubOptions,\n  isRedisProvider,\n  isVercelKvProvider,\n} from '../common/types/options/redis.options';\n\n/**\n * Create a store driver based on configuration\n *\n * @param options - Storage configuration (Redis or Vercel KV)\n * @returns A store driver instance (not connected)\n *\n * @example Redis\n * ```typescript\n * const driver = createStoreDriver({\n *   provider: 'redis',\n *   host: 'localhost',\n *   port: 6379,\n * });\n * await driver.connect();\n * ```\n *\n * @example Vercel KV\n * ```typescript\n * const driver = createStoreDriver({\n *   provider: 'vercel-kv',\n *   // Uses KV_REST_API_URL and KV_REST_API_TOKEN env vars\n * });\n * await driver.connect();\n * ```\n */\nexport function createStoreDriver(options: RedisOptions): StoreDriver {\n  if (isVercelKvProvider(options)) {\n    return createVercelKvStoreDriver(options);\n  }\n\n  if (isRedisProvider(options)) {\n    return createRedisStoreDriver(options);\n  }\n\n  // Fallback for legacy format without provider field\n  return createRedisStoreDriver(options as RedisProviderOptions);\n}\n\n/**\n * Create a Redis store driver\n */\nfunction createRedisStoreDriver(options: RedisProviderOptions): StoreDriver {\n  // Lazy import to avoid bundling ioredis when not used\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const { ScopedRedisStore } = require('./adapters/store.redis.adapter');\n\n  return new ScopedRedisStore({\n    options: {\n      host: options.host,\n      port: options.port,\n      password: options.password,\n      db: options.db,\n      tls: options.tls ? {} : undefined,\n      keyPrefix: options.keyPrefix,\n    },\n  });\n}\n\n/**\n * Create a Vercel KV store driver\n */\nfunction createVercelKvStoreDriver(options: VercelKvProviderOptions): StoreDriver {\n  // Lazy import to avoid bundling @vercel/kv when not used\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const { ScopedVercelKvStore } = require('./adapters/store.vercel-kv.adapter');\n\n  return new ScopedVercelKvStore({\n    url: options.url,\n    token: options.token,\n    keyPrefix: options.keyPrefix,\n  });\n}\n\n/**\n * Create a session store based on configuration\n *\n * @param options - Storage configuration (Redis or Vercel KV)\n * @param logger - Optional logger instance\n * @returns A session store instance\n *\n * @example Redis\n * ```typescript\n * const store = await createSessionStore({\n *   provider: 'redis',\n *   host: 'localhost',\n *   port: 6379,\n * });\n * ```\n *\n * @example Vercel KV\n * ```typescript\n * const store = await createSessionStore({\n *   provider: 'vercel-kv',\n * });\n * ```\n */\nexport async function createSessionStore(options: RedisOptions, logger?: FrontMcpLogger): Promise<SessionStore> {\n  if (isVercelKvProvider(options)) {\n    return createVercelKvSessionStore(options, logger);\n  }\n\n  if (isRedisProvider(options)) {\n    return createRedisSessionStore(options, logger);\n  }\n\n  // Fallback for legacy format without provider field\n  return createRedisSessionStore(options as RedisProviderOptions, logger);\n}\n\n/**\n * Create a Redis session store\n */\nasync function createRedisSessionStore(options: RedisProviderOptions, logger?: FrontMcpLogger): Promise<SessionStore> {\n  // Lazy require to avoid bundling ioredis when not used\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const { RedisSessionStore } = require('../auth/session/redis-session.store');\n\n  return new RedisSessionStore(\n    {\n      host: options.host,\n      port: options.port,\n      password: options.password,\n      db: options.db,\n      tls: options.tls,\n      keyPrefix: options.keyPrefix ? `${options.keyPrefix}session:` : 'mcp:session:',\n      defaultTtlMs: options.defaultTtlMs,\n    },\n    logger,\n  );\n}\n\n/**\n * Create a Vercel KV session store\n */\nasync function createVercelKvSessionStore(\n  options: VercelKvProviderOptions,\n  logger?: FrontMcpLogger,\n): Promise<SessionStore> {\n  // Lazy require to avoid bundling @vercel/kv when not used\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const { VercelKvSessionStore } = require('../auth/session/vercel-kv-session.store');\n\n  const store = new VercelKvSessionStore(\n    {\n      url: options.url,\n      token: options.token,\n      keyPrefix: options.keyPrefix ? `${options.keyPrefix}session:` : 'mcp:session:',\n      defaultTtlMs: options.defaultTtlMs,\n    },\n    logger,\n  );\n\n  // Pre-connect for Vercel KV\n  await store.connect();\n\n  return store;\n}\n\n/**\n * Create a session store synchronously (for backwards compatibility)\n * Note: For Vercel KV, use createSessionStore() instead as it requires async connect\n *\n * @param options - Storage configuration (Redis only)\n * @param logger - Optional logger instance\n * @returns A session store instance\n */\nexport function createSessionStoreSync(options: RedisOptions, logger?: FrontMcpLogger): SessionStore {\n  if (isVercelKvProvider(options)) {\n    throw new Error('Vercel KV session store requires async initialization. Use createSessionStore() instead.');\n  }\n\n  // Redis only - synchronous creation\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const { RedisSessionStore } = require('../auth/session/redis-session.store');\n  const redisOptions = isRedisProvider(options) ? options : (options as RedisProviderOptions);\n\n  return new RedisSessionStore(\n    {\n      host: redisOptions.host,\n      port: redisOptions.port,\n      password: redisOptions.password,\n      db: redisOptions.db,\n      tls: redisOptions.tls,\n      keyPrefix: redisOptions.keyPrefix ? `${redisOptions.keyPrefix}session:` : 'mcp:session:',\n      defaultTtlMs: redisOptions.defaultTtlMs,\n    },\n    logger,\n  );\n}\n\n/**\n * Create a pub/sub store for resource subscriptions\n *\n * Pub/Sub requires Redis - Vercel KV does not support pub/sub operations.\n * Use this when you need resource subscriptions with Vercel KV for sessions.\n *\n * @param options - Pub/sub configuration (Redis only)\n * @returns A Redis store driver with pub/sub support\n *\n * @example Hybrid config\n * ```typescript\n * // Use Vercel KV for sessions, Redis for pub/sub\n * const sessionStore = await createSessionStore({ provider: 'vercel-kv' });\n * const pubsubStore = createPubsubStore({ host: 'localhost', port: 6379 });\n * ```\n */\nexport function createPubsubStore(options: PubsubOptions): StoreDriver {\n  // PubsubOptions only allows Redis provider, so we can safely cast\n  const redisOptions = options as RedisProviderOptions;\n  return createRedisStoreDriver(redisOptions);\n}\n"]}

package/src/tool/flows/call-tool.flow.d.ts

@@ -1,31 +1,32 @@
 import { FlowBase, FlowRunOptions, ToolContext, ToolEntry } from '../../common';
 import { z } from 'zod';
 import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import { type ToolResponseContent } from '@frontmcp/uipack/adapters';
 declare const inputSchema: z.ZodObject<{
     request: z.ZodObject<{
         method: z.ZodLiteral<"tools/call">;
         params: z.ZodObject<{
-            task: z.ZodOptional<z.ZodObject<{
-                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
-                pollInterval: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$loose>>;
             _meta: z.ZodOptional<z.ZodObject<{
                 progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
                     taskId: z.ZodString;
-                }, z.core.$loose>>;
+                }, z.core.$strip>>;
             }, z.core.$loose>>;
+            task: z.ZodOptional<z.ZodObject<{
+                ttl: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
             name: z.ZodString;
             arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$loose>;
+        }, z.core.$strip>;
     }, z.core.$strip>;
     ctx: z.ZodAny;
 }, z.core.$strip>;
 declare const outputSchema: z.ZodObject<{
     _meta: z.ZodOptional<z.ZodObject<{
+        progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
         "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
             taskId: z.ZodString;
-        }, z.core.$loose>>;
+        }, z.core.$strip>>;
     }, z.core.$loose>>;
     content: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"text">;
@@ -82,6 +83,10 @@ declare const outputSchema: z.ZodObject<{
             src: z.ZodString;
             mimeType: z.ZodOptional<z.ZodString>;
             sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            theme: z.ZodOptional<z.ZodEnum<{
+                light: "light";
+                dark: "dark";
+            }>>;
         }, z.core.$strip>>>;
         name: z.ZodString;
         title: z.ZodOptional<z.ZodString>;
@@ -118,22 +123,15 @@ declare const stateSchema: z.ZodObject<{
         arguments: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
     }, z.core.$loose>;
     authInfo: z.ZodType<AuthInfo>;
-    tool: z.ZodCustom<ToolEntry<Readonly<{
-        [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    }>, import("../../common").ToolOutputType, unknown, unknown>, ToolEntry<Readonly<{
-        [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    }>, import("../../common").ToolOutputType, unknown, unknown>>;
-    toolContext: z.ZodCustom<ToolContext<Readonly<{
-        [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    }>, import("../../common").ToolOutputType, unknown, unknown>, ToolContext<Readonly<{
-        [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    }>, import("../../common").ToolOutputType, unknown, unknown>>;
+    tool: z.ZodCustom<ToolEntry<import("../../common").ToolInputType, import("../../common").ToolOutputType, unknown, unknown>, ToolEntry<import("../../common").ToolInputType, import("../../common").ToolOutputType, unknown, unknown>>;
+    toolContext: z.ZodCustom<ToolContext<import("../../common").ToolInputType, import("../../common").ToolOutputType, unknown, unknown>, ToolContext<import("../../common").ToolInputType, import("../../common").ToolOutputType, unknown, unknown>>;
     rawOutput: z.ZodOptional<z.ZodAny>;
     output: z.ZodObject<{
         _meta: z.ZodOptional<z.ZodObject<{
+            progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
             "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
                 taskId: z.ZodString;
-            }, z.core.$loose>>;
+            }, z.core.$strip>>;
         }, z.core.$loose>>;
         content: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             type: z.ZodLiteral<"text">;
@@ -190,6 +188,10 @@ declare const stateSchema: z.ZodObject<{
                 src: z.ZodString;
                 mimeType: z.ZodOptional<z.ZodString>;
                 sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                theme: z.ZodOptional<z.ZodEnum<{
+                    light: "light";
+                    dark: "dark";
+                }>>;
             }, z.core.$strip>>>;
             name: z.ZodString;
             title: z.ZodOptional<z.ZodString>;
@@ -221,11 +223,13 @@ declare const stateSchema: z.ZodObject<{
         isError: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>;
     _toolOwnerId: z.ZodOptional<z.ZodString>;
+    uiResult: z.ZodType<ToolResponseContent | undefined>;
+    uiMeta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 declare const plan: {
     readonly pre: ["parseInput", "findTool", "checkToolAuthorization", "createToolCallContext", "acquireQuota", "acquireSemaphore"];
     readonly execute: ["validateInput", "execute", "validateOutput"];
-    readonly finalize: ["releaseSemaphore", "releaseQuota", "finalize"];
+    readonly finalize: ["releaseSemaphore", "releaseQuota", "applyUI", "finalize"];
 };
 declare global {
     interface ExtendFlows {
@@ -255,6 +259,21 @@ export default class CallToolFlow extends FlowBase<typeof name> {
     validateOutput(): Promise<void>;
     releaseSemaphore(): Promise<void>;
     releaseQuota(): Promise<void>;
+    /**
+     * Apply UI rendering to the tool response.
+     * This stage handles all UI-related logic including platform detection,
+     * serving mode resolution, and content formatting.
+     */
+    applyUI(): Promise<void>;
+    /**
+     * Finalize the tool response.
+     * Validates output, applies UI result from applyUI stage, and sends the response.
+     *
+     * Note: This stage runs even when execute fails (as part of cleanup).
+     * If rawOutput is undefined, it means an error occurred during execution
+     * and the error will be propagated by the flow framework - we should not
+     * throw a new error here.
+     */
     finalize(): Promise<void>;
 }
 export {};