@frontmcp/sdk 0.6.1 → 0.6.3

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

@@ -1,155 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./store.types"), exports);
-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 +0,0 @@
-{"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.js

@@ -1,194 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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/store/store.helpers.js

@@ -1,67 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useStore = useStore;
-exports.setMany = setMany;
-exports.getMany = getMany;
-const store_registry_1 = require("./store.registry");
-const store_utils_1 = require("./store.utils");
-function useStore(scope, storeName) {
-    const registry = (0, store_registry_1.getRegistryForScope)(scope.id);
-    const driver = registry.ensure(storeName);
-    return function forPrefix(prefix) {
-        return {
-            scope,
-            prefix,
-            storeName,
-            async get(key) {
-                const raw = await driver.get((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
-                return store_utils_1.Json.decode(raw);
-            },
-            async set(key, value, opts) {
-                await driver.set((0, store_utils_1.buildDataKey)(scope, prefix, String(key)), store_utils_1.Json.encode(value), opts);
-            },
-            async del(key) {
-                await driver.del((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
-            },
-            async exists(key) {
-                return driver.exists((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
-            },
-            async incr(key) {
-                return driver.incr((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
-            },
-            async decr(key) {
-                return driver.decr((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
-            },
-            async expire(key, ttlSeconds) {
-                await driver.expire((0, store_utils_1.buildDataKey)(scope, prefix, String(key)), ttlSeconds);
-            },
-            async ttl(key) {
-                return driver.ttl((0, store_utils_1.buildDataKey)(scope, prefix, String(key)));
-            },
-            async publish(channel, message) {
-                return driver.publish((0, store_utils_1.buildChannel)(scope, prefix, channel), message);
-            },
-            async subscribe(channel, handler) {
-                const ch = (0, store_utils_1.buildChannel)(scope, prefix, channel);
-                return driver.subscribe(ch, handler);
-            },
-        };
-    };
-}
-// Batch helpers bound to a store name
-async function setMany(scope, storeName, prefix, entries) {
-    const { ensure } = (0, store_registry_1.getRegistryForScope)(scope.id);
-    const driver = ensure(storeName);
-    await driver.mset(entries.map((e) => ({
-        key: (0, store_utils_1.buildDataKey)(scope, prefix, String(e.key)),
-        value: store_utils_1.Json.encode(e.value),
-        opts: e.opts,
-    })));
-}
-async function getMany(scope, storeName, prefix, keys) {
-    const driver = (0, store_registry_1.getRegistryForScope)(scope.id).ensure(storeName);
-    const fullKeys = keys.map((k) => (0, store_utils_1.buildDataKey)(scope, prefix, String(k)));
-    const res = await driver.mget(fullKeys);
-    return res.map((r) => store_utils_1.Json.decode(r));
-}
-//# sourceMappingURL=store.helpers.js.map

package/src/store/store.helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.helpers.js","sourceRoot":"","sources":["../../../src/store/store.helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AllPrefixes, KeysFor, PrefixStore, SetOptions, ValueFor } from './store.types';\nimport { getRegistryForScope } from './store.registry';\nimport { buildChannel, buildDataKey, Json } from './store.utils';\nimport { Scope } from '../scope/scope.instance';\n\nexport function useStore(scope: Scope, storeName: string) {\n  const registry = getRegistryForScope(scope.id);\n  const driver = registry.ensure(storeName);\n\n  return function forPrefix<P extends AllPrefixes>(prefix: P): PrefixStore<P> {\n    return {\n      scope,\n      prefix,\n      storeName,\n\n      async get<K extends KeysFor<P>>(key: K) {\n        const raw = await driver.get(buildDataKey(scope, prefix, String(key)));\n        return Json.decode<ValueFor<P, K>>(raw);\n      },\n      async set<K extends KeysFor<P>>(key: K, value: ValueFor<P, K>, opts?: SetOptions) {\n        await driver.set(buildDataKey(scope, prefix, String(key)), Json.encode(value), opts);\n      },\n      async del<K extends KeysFor<P>>(key: K) {\n        await driver.del(buildDataKey(scope, prefix, String(key)));\n      },\n      async exists<K extends KeysFor<P>>(key: K) {\n        return driver.exists(buildDataKey(scope, prefix, String(key)));\n      },\n      async incr<K extends KeysFor<P>>(key: K) {\n        return driver.incr(buildDataKey(scope, prefix, String(key)));\n      },\n      async decr<K extends KeysFor<P>>(key: K) {\n        return driver.decr(buildDataKey(scope, prefix, String(key)));\n      },\n      async expire<K extends KeysFor<P>>(key: K, ttlSeconds: number) {\n        await driver.expire(buildDataKey(scope, prefix, String(key)), ttlSeconds);\n      },\n      async ttl<K extends KeysFor<P>>(key: K) {\n        return driver.ttl(buildDataKey(scope, prefix, String(key)));\n      },\n      async publish(channel: string, message: string) {\n        return driver.publish(buildChannel(scope, prefix, channel), message);\n      },\n      async subscribe(channel: string, handler: (message: string) => void) {\n        const ch = buildChannel(scope, prefix, channel);\n        return driver.subscribe(ch, handler);\n      },\n    } satisfies PrefixStore<P>;\n  };\n}\n\n// Batch helpers bound to a store name\nexport async function setMany<P extends AllPrefixes, K extends KeysFor<P>>(\n  scope: Scope,\n  storeName: string,\n  prefix: P,\n  entries: Array<{ key: K; value: ValueFor<P, K>; opts?: SetOptions }>,\n): Promise<void> {\n  const { ensure } = getRegistryForScope(scope.id);\n  const driver = ensure(storeName);\n  await driver.mset(\n    entries.map((e) => ({\n      key: buildDataKey(scope, prefix, String(e.key)),\n      value: Json.encode(e.value),\n      opts: e.opts,\n    })),\n  );\n}\n\nexport async function getMany<P extends AllPrefixes, K extends KeysFor<P>, V = ValueFor<P, K>>(\n  scope: Scope,\n  storeName: string,\n  prefix: P,\n  keys: K[],\n): Promise<Array<V | null>> {\n  const driver = getRegistryForScope(scope.id).ensure(storeName);\n  const fullKeys = keys.map((k) => buildDataKey(scope, prefix, String(k)));\n  const res = await driver.mget(fullKeys);\n  return res.map((r) => Json.decode<V>(r));\n}\n"]}

package/src/store/store.registry.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StoreRegistry = void 0;
-exports.configureStoreRegistryLocator = configureStoreRegistryLocator;
-exports.getRegistryForScope = getRegistryForScope;
-class StoreRegistry {
-    map = new Map();
-    register(name, driver) {
-        this.map.set(name, driver);
-    }
-    get(name) {
-        return this.map.get(name);
-    }
-    ensure(name) {
-        const d = this.map.get(name);
-        if (!d)
-            throw new Error(`No store driver named "${name}"`);
-        return d;
-    }
-    has(name) {
-        return this.map.has(name);
-    }
-    list() {
-        return Array.from(this.map.keys());
-    }
-}
-exports.StoreRegistry = StoreRegistry;
-let locator = null;
-function configureStoreRegistryLocator(l) {
-    locator = l;
-}
-function getRegistryForScope(scopeId) {
-    if (!locator)
-        throw new Error('StoreRegistry locator not configured');
-    return locator(scopeId);
-}
-//# sourceMappingURL=store.registry.js.map

package/src/store/store.registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.registry.js","sourceRoot":"","sources":["../../../src/store/store.registry.ts"],"names":[],"mappings":";;;AA2BA,sEAEC;AACD,kDAGC;AA9BD,MAAa,aAAa;IACP,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;IACtD,QAAQ,CAAC,IAAY,EAAE,MAAmB;QACxC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,CAAC,IAAY;QACjB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,GAAG,CAAC,CAAC;QAC3D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;CACF;AAnBD,sCAmBC;AAGD,IAAI,OAAO,GAAgC,IAAI,CAAC;AAEhD,SAAgB,6BAA6B,CAAC,CAAuB;IACnE,OAAO,GAAG,CAAC,CAAC;AACd,CAAC;AACD,SAAgB,mBAAmB,CAAC,OAAoB;IACtD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACtE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import type { StoreDriver, StoreRegistryInterface } from './store.types';\nimport { Scope } from '../scope';\n\nexport class StoreRegistry implements StoreRegistryInterface {\n  private readonly map = new Map<string, StoreDriver>();\n  register(name: string, driver: StoreDriver): void {\n    this.map.set(name, driver);\n  }\n  get(name: string): StoreDriver | undefined {\n    return this.map.get(name);\n  }\n  ensure(name: string): StoreDriver {\n    const d = this.map.get(name);\n    if (!d) throw new Error(`No store driver named \"${name}\"`);\n    return d;\n  }\n  has(name: string): boolean {\n    return this.map.has(name);\n  }\n  list(): string[] {\n    return Array.from(this.map.keys());\n  }\n}\n\nexport type StoreRegistryLocator = (scopeId: Scope['id']) => StoreRegistryInterface;\nlet locator: StoreRegistryLocator | null = null;\n\nexport function configureStoreRegistryLocator(l: StoreRegistryLocator) {\n  locator = l;\n}\nexport function getRegistryForScope(scopeId: Scope['id']): StoreRegistryInterface {\n  if (!locator) throw new Error('StoreRegistry locator not configured');\n  return locator(scopeId);\n}\n"]}

package/src/store/store.tokens.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.STORE_DRIVER_TOKEN = exports.STORE_SCOPE_RESOLVER_TOKEN = exports.STORE_REGISTRY_LOCATOR_TOKEN = void 0;
-exports.STORE_REGISTRY_LOCATOR_TOKEN = Symbol.for('mcp.store.registry_locator');
-exports.STORE_SCOPE_RESOLVER_TOKEN = Symbol.for('mcp.store.scope_resolver');
-exports.STORE_DRIVER_TOKEN = Symbol.for('mcp.store.driver');
-//# sourceMappingURL=store.tokens.js.map

package/src/store/store.tokens.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.tokens.js","sourceRoot":"","sources":["../../../src/store/store.tokens.ts"],"names":[],"mappings":";;;AAAa,QAAA,4BAA4B,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AACxE,QAAA,0BAA0B,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AACpE,QAAA,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC","sourcesContent":["export const STORE_REGISTRY_LOCATOR_TOKEN = Symbol.for('mcp.store.registry_locator');\nexport const STORE_SCOPE_RESOLVER_TOKEN = Symbol.for('mcp.store.scope_resolver');\nexport const STORE_DRIVER_TOKEN = Symbol.for('mcp.store.driver');\n"]}

package/src/store/store.types.js

@@ -1,11 +0,0 @@
-"use strict";
-// ──────────────────────────────────────────────────────────────────────────────
-// File: store/store.types.ts
-// Purpose: Shared & extendable types for the storage factory
-// Model: Each *scope* owns its own StoreRegistry (no global map in the lib).
-// Host app provides a registry locator (scope -> registry) via configuration.
-// API: useStore(scope, storeName) => (prefix) => PrefixedStore
-// Extendability via declaration merging: `interface McpKVNamespaces {}`
-// ──────────────────────────────────────────────────────────────────────────────
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=store.types.js.map

package/src/store/store.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.types.js","sourceRoot":"","sources":["../../../src/store/store.types.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,6BAA6B;AAC7B,6DAA6D;AAC7D,6EAA6E;AAC7E,8EAA8E;AAC9E,+DAA+D;AAC/D,wEAAwE;AACxE,iFAAiF","sourcesContent":["// ──────────────────────────────────────────────────────────────────────────────\n// File: store/store.types.ts\n// Purpose: Shared & extendable types for the storage factory\n// Model: Each *scope* owns its own StoreRegistry (no global map in the lib).\n// Host app provides a registry locator (scope -> registry) via configuration.\n// API: useStore(scope, storeName) => (prefix) => PrefixedStore\n// Extendability via declaration merging: `interface McpKVNamespaces {}`\n// ──────────────────────────────────────────────────────────────────────────────\n\nimport { Scope } from '../scope/scope.instance';\n\nexport type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue = JsonPrimitive | JsonObject | JsonArray;\n\nexport interface JsonObject {\n  [k: string]: JsonValue;\n}\n\nexport type JsonArray = Array<JsonValue>;\n\n\nexport interface SetOptions {\n  ttlSeconds?: number;\n}\n\nexport interface StoreDriver {\n  connect(): Promise<void>;\n\n  disconnect(): Promise<void>;\n\n  get(key: string): Promise<string | null>;\n\n  set(key: string, value: string, opts?: SetOptions): Promise<void>;\n\n  del(key: string): Promise<void>;\n\n  exists(key: string): Promise<boolean>;\n\n  mget(keys: string[]): Promise<(string | null)[]>;\n\n  mset(entries: Array<{ key: string; value: string; opts?: SetOptions }>): Promise<void>;\n\n  incr(key: string): Promise<number>;\n\n  decr(key: string): Promise<number>;\n\n  expire(key: string, ttlSeconds: number): Promise<void>;\n\n  ttl(key: string): Promise<number | null>;\n\n  publish(channel: string, message: string): Promise<number>;\n\n  subscribe(channel: string, handler: (message: string) => void): Promise<() => Promise<void>>;\n}\n\n// A per-scope registry holds multiple named drivers (memory/redis/etc.)\nexport interface StoreRegistryInterface {\n  register(name: string, driver: StoreDriver): void;\n\n  get(name: string): StoreDriver | undefined;\n\n  ensure(name: string): StoreDriver;\n\n  has(name: string): boolean;\n\n  list(): string[];\n}\n\n// Typed store interface returned by useStore(scope, name)(prefix)\nexport interface PrefixStore<P extends AllPrefixes = string> {\n  readonly scope: Scope;\n  readonly prefix: P;\n  readonly storeName: string;\n\n  get<K extends KeysFor<P>>(key: K): Promise<ValueFor<P, K> | null>;\n\n  set<K extends KeysFor<P>>(key: K, value: ValueFor<P, K>, opts?: SetOptions): Promise<void>;\n\n  del<K extends KeysFor<P>>(key: K): Promise<void>;\n\n  exists<K extends KeysFor<P>>(key: K): Promise<boolean>;\n\n  incr<K extends KeysFor<P>>(key: K): Promise<number>;\n\n  decr<K extends KeysFor<P>>(key: K): Promise<number>;\n\n  expire<K extends KeysFor<P>>(key: K, ttlSeconds: number): Promise<void>;\n\n  ttl<K extends KeysFor<P>>(key: K): Promise<number | null>;\n\n  publish(channel: string, message: string): Promise<number>;\n\n  subscribe(channel: string, handler: (message: string) => void): Promise<() => Promise<void>>;\n}\n\ndeclare global {\n  // Extendable typings via declaration merging\n  export interface McpKVNamespaces {\n    [scope: string]: {\n      [storeName: string]: {\n        [key: string]: unknown;\n      };\n    };\n  }\n}\n\nexport type AllPrefixes = keyof McpKVNamespaces extends never ? string : Extract<keyof McpKVNamespaces, string>;\n\nexport type KeysFor<P> = P extends keyof McpKVNamespaces ? Extract<keyof McpKVNamespaces[P], string> : string;\n\nexport type ValueFor<P, K> = P extends keyof McpKVNamespaces\n  ? K extends keyof McpKVNamespaces[P]\n    ? McpKVNamespaces[P][K]\n    : unknown\n  : unknown;\n"]}

package/src/store/store.utils.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Json = void 0;
-exports.makeScopeSegment = makeScopeSegment;
-exports.buildDataKey = buildDataKey;
-exports.buildChannel = buildChannel;
-function makeScopeSegment(scope) { return String(scope); }
-function buildDataKey(scope, prefix, key) {
-    return `${makeScopeSegment(scope)}:${prefix}${key}`;
-}
-function buildChannel(scope, prefix, channel) {
-    return `${makeScopeSegment(scope)}:${prefix}__ch__:${channel}`;
-}
-exports.Json = {
-    encode(value) { return JSON.stringify(value); },
-    decode(str) { return str == null ? null : JSON.parse(str); },
-};
-//# sourceMappingURL=store.utils.js.map

package/src/store/store.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.utils.js","sourceRoot":"","sources":["../../../src/store/store.utils.ts"],"names":[],"mappings":";;;AAEA,4CAAgF;AAEhF,oCAEC;AAED,oCAEC;AARD,SAAgB,gBAAgB,CAAC,KAAY,IAAY,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEhF,SAAgB,YAAY,CAAC,KAAY,EAAE,MAAc,EAAE,GAAW;IACpE,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;AACtD,CAAC;AAED,SAAgB,YAAY,CAAC,KAAY,EAAE,MAAc,EAAE,OAAe;IACxE,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,MAAM,UAAU,OAAO,EAAE,CAAC;AACjE,CAAC;AAEY,QAAA,IAAI,GAAG;IAClB,MAAM,CAAI,KAAQ,IAAY,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAI,GAAkB,IAAc,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAO,CAAC,CAAC,CAAC;CAChG,CAAC","sourcesContent":["import { Scope } from '../scope/scope.instance';\n\nexport function makeScopeSegment(scope: Scope): string { return String(scope); }\n\nexport function buildDataKey(scope: Scope, prefix: string, key: string): string {\n  return `${makeScopeSegment(scope)}:${prefix}${key}`;\n}\n\nexport function buildChannel(scope: Scope, prefix: string, channel: string): string {\n  return `${makeScopeSegment(scope)}:${prefix}__ch__:${channel}`;\n}\n\nexport const Json = {\n  encode<T>(value: T): string { return JSON.stringify(value); },\n  decode<T>(str: string | null): T | null { return str == null ? null : (JSON.parse(str) as T); },\n};\n"]}