@frontmcp/sdk 0.6.0 → 0.6.2

package/src/common/types/options/logging.options.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loggingOptionsSchema = exports.LogLevelName = exports.LogLevel = void 0;
-const zod_1 = require("zod");
-const schemas_1 = require("../../schemas");
-var LogLevel;
-(function (LogLevel) {
-    LogLevel[LogLevel["Debug"] = 0] = "Debug";
-    /**
-     * @deprecated use 'Verbose' instead
-     */
-    LogLevel[LogLevel["VERBOSE"] = 1] = "VERBOSE";
-    LogLevel[LogLevel["Verbose"] = 1] = "Verbose";
-    LogLevel[LogLevel["Info"] = 2] = "Info";
-    LogLevel[LogLevel["Warn"] = 3] = "Warn";
-    LogLevel[LogLevel["Error"] = 4] = "Error";
-    LogLevel[LogLevel["Off"] = 100] = "Off";
-})(LogLevel || (exports.LogLevel = LogLevel = {}));
-exports.LogLevelName = {
-    [LogLevel.Debug]: 'debug',
-    [LogLevel.VERBOSE]: 'verbose',
-    [LogLevel.Info]: 'info',
-    [LogLevel.Warn]: 'warn',
-    [LogLevel.Error]: 'error',
-    [LogLevel.Off]: 'off',
-};
-exports.loggingOptionsSchema = zod_1.z.object({
-    level: zod_1.z.nativeEnum(LogLevel).optional().default(LogLevel.Info),
-    prefix: zod_1.z.string().optional(),
-    enableConsole: zod_1.z.boolean().optional().default(true),
-    transports: zod_1.z.array(schemas_1.annotatedFrontMcpLoggerSchema).optional().default([]),
-});
-//# sourceMappingURL=logging.options.js.map

package/src/common/types/options/logging.options.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logging.options.js","sourceRoot":"","sources":["../../../../../src/common/types/options/logging.options.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,2CAA8D;AAI9D,IAAY,QAWX;AAXD,WAAY,QAAQ;IAClB,yCAAS,CAAA;IACT;;OAEG;IACH,6CAAW,CAAA;IACX,6CAAiB,CAAA;IACjB,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,uCAAS,CAAA;AACX,CAAC,EAXW,QAAQ,wBAAR,QAAQ,QAWnB;AAEY,QAAA,YAAY,GAA6B;IACpD,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IACzB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;IAC7B,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IACvB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IACvB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IACzB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK;CACtB,CAAC;AAaW,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,OAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC/D,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,aAAa,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACnD,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,uCAA6B,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACpC,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { annotatedFrontMcpLoggerSchema } from '../../schemas';\nimport { LogTransportType } from '../../interfaces';\nimport { RawZodShape } from '../common.types';\n\nexport enum LogLevel {\n  Debug = 0,\n  /**\n   * @deprecated use 'Verbose' instead\n   */\n  VERBOSE = 1,\n  Verbose = VERBOSE,\n  Info = 2,\n  Warn = 3,\n  Error = 4,\n  Off = 100, // never log\n}\n\nexport const LogLevelName: Record<LogLevel, string> = {\n  [LogLevel.Debug]: 'debug',\n  [LogLevel.VERBOSE]: 'verbose',\n  [LogLevel.Info]: 'info',\n  [LogLevel.Warn]: 'warn',\n  [LogLevel.Error]: 'error',\n  [LogLevel.Off]: 'off',\n};\n\nexport type LoggingOptions = {\n  level?: LogLevel; // default to 'info'\n  enableConsole?: boolean;\n  prefix?: string;\n  /**\n   * Additional custom LogTransport types to register.\n   * @default []\n   */\n  transports?: LogTransportType[];\n};\n\nexport const loggingOptionsSchema = z.object({\n  level: z.nativeEnum(LogLevel).optional().default(LogLevel.Info),\n  prefix: z.string().optional(),\n  enableConsole: z.boolean().optional().default(true),\n  transports: z.array(annotatedFrontMcpLoggerSchema).optional().default([]),\n} satisfies RawZodShape<LoggingOptions>);\n\nexport type LoggingConfigType = Omit<z.infer<typeof loggingOptionsSchema>, 'transports'>;\n"]}

package/src/common/types/options/redis.options.d.ts

@@ -1,22 +0,0 @@
-import { z } from 'zod';
-/**
- * Shared Redis configuration
- * Used by transport persistence and auth token storage
- */
-export declare const redisOptionsSchema: z.ZodObject<{
-    host: z.ZodString;
-    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    password: z.ZodOptional<z.ZodString>;
-    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-}, z.core.$strip>;
-/**
- * Redis configuration type (with defaults applied)
- */
-export type RedisOptions = z.infer<typeof redisOptionsSchema>;
-/**
- * Redis configuration input type (for user configuration)
- */
-export type RedisOptionsInput = z.input<typeof redisOptionsSchema>;

package/src/common/types/options/redis.options.js

@@ -1,45 +0,0 @@
-"use strict";
-// common/types/options/redis.options.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.redisOptionsSchema = void 0;
-const zod_1 = require("zod");
-/**
- * Shared Redis configuration
- * Used by transport persistence and auth token storage
- */
-exports.redisOptionsSchema = zod_1.z.object({
-    /**
-     * Redis host
-     */
-    host: zod_1.z.string().trim().min(1),
-    /**
-     * Redis port
-     * @default 6379
-     */
-    port: zod_1.z.number().int().positive().max(65535).optional().default(6379),
-    /**
-     * Redis password (optional)
-     */
-    password: zod_1.z.string().optional(),
-    /**
-     * Redis database number
-     * @default 0
-     */
-    db: zod_1.z.number().int().nonnegative().optional().default(0),
-    /**
-     * Enable TLS connection
-     * @default false
-     */
-    tls: zod_1.z.boolean().optional().default(false),
-    /**
-     * Key prefix for all Redis keys
-     * @default 'mcp:'
-     */
-    keyPrefix: zod_1.z.string().optional().default('mcp:'),
-    /**
-     * Default TTL in milliseconds for stored data
-     * @default 3600000 (1 hour)
-     */
-    defaultTtlMs: zod_1.z.number().int().positive().optional().default(3600000),
-});
-//# sourceMappingURL=redis.options.js.map

package/src/common/types/options/redis.options.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"redis.options.js","sourceRoot":"","sources":["../../../../../src/common/types/options/redis.options.ts"],"names":[],"mappings":";AAAA,wCAAwC;;;AAExC,6BAAwB;AAExB;;;GAGG;AACU,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC;;OAEG;IACH,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9B;;;OAGG;IACH,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAErE;;OAEG;IACH,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B;;;OAGG;IACH,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAExD;;;OAGG;IACH,GAAG,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAE1C;;;OAGG;IACH,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IAEhD;;;OAGG;IACH,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;CACtE,CAAC,CAAC","sourcesContent":["// common/types/options/redis.options.ts\n\nimport { z } from 'zod';\n\n/**\n * Shared Redis configuration\n * Used by transport persistence and auth token storage\n */\nexport const redisOptionsSchema = z.object({\n  /**\n   * Redis host\n   */\n  host: z.string().trim().min(1),\n\n  /**\n   * Redis port\n   * @default 6379\n   */\n  port: z.number().int().positive().max(65535).optional().default(6379),\n\n  /**\n   * Redis password (optional)\n   */\n  password: z.string().optional(),\n\n  /**\n   * Redis database number\n   * @default 0\n   */\n  db: z.number().int().nonnegative().optional().default(0),\n\n  /**\n   * Enable TLS connection\n   * @default false\n   */\n  tls: z.boolean().optional().default(false),\n\n  /**\n   * Key prefix for all Redis keys\n   * @default 'mcp:'\n   */\n  keyPrefix: z.string().optional().default('mcp:'),\n\n  /**\n   * Default TTL in milliseconds for stored data\n   * @default 3600000 (1 hour)\n   */\n  defaultTtlMs: z.number().int().positive().optional().default(3600000),\n});\n\n/**\n * Redis configuration type (with defaults applied)\n */\nexport type RedisOptions = z.infer<typeof redisOptionsSchema>;\n\n/**\n * Redis configuration input type (for user configuration)\n */\nexport type RedisOptionsInput = z.input<typeof redisOptionsSchema>;\n"]}

package/src/common/types/options/server-info.options.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.serverInfoOptionsSchema = void 0;
-const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
-const zod_1 = require("zod");
-exports.serverInfoOptionsSchema = zod_1.z.object({
-    name: zod_1.z.string(),
-    title: zod_1.z.string().optional(),
-    version: zod_1.z.string(),
-    websiteUrl: zod_1.z.string().optional(),
-    icons: zod_1.z.array(types_js_1.IconSchema).optional(),
-});
-//# sourceMappingURL=server-info.options.js.map

package/src/common/types/options/server-info.options.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server-info.options.js","sourceRoot":"","sources":["../../../../../src/common/types/options/server-info.options.ts"],"names":[],"mappings":";;;AAAA,iEAAsE;AACtE,6BAAwB;AAgBX,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,qBAAU,CAAC,CAAC,QAAQ,EAAE;CACG,CAAC,CAAC","sourcesContent":["import { Icon, IconSchema } from '@modelcontextprotocol/sdk/types.js';\nimport { z } from 'zod';\nimport { RawZodShape } from '../common.types';\n\nexport type ServerInfoOptions = {\n  /* The name of the server */\n  name: string;\n  /* The name of the server */\n  title?: string;\n  /* The version of the server */\n  version: string;\n  /* The description of the server*/\n  websiteUrl?: string;\n  icons?: Icon[];\n}\n\n\nexport const serverInfoOptionsSchema = z.object({\n  name: z.string(),\n  title: z.string().optional(),\n  version: z.string(),\n  websiteUrl: z.string().optional(),\n  icons: z.array(IconSchema).optional(),\n} satisfies RawZodShape<ServerInfoOptions>);"]}

package/src/common/types/options/session.options.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sessionOptionsSchema = exports.platformDetectionConfigSchema = exports.platformMappingEntrySchema = void 0;
-const zod_1 = require("zod");
-const session_types_1 = require("../auth/session.types");
-/**
- * Zod schema for platform mapping entry.
- * Note: RegExp cannot be validated by zod, so we use passthrough for pattern.
- */
-exports.platformMappingEntrySchema = zod_1.z.object({
-    pattern: zod_1.z.union([zod_1.z.string(), zod_1.z.instanceof(RegExp)]),
-    platform: session_types_1.aiPlatformTypeSchema,
-});
-/**
- * Zod schema for platform detection configuration.
- */
-exports.platformDetectionConfigSchema = zod_1.z.object({
-    mappings: zod_1.z.array(exports.platformMappingEntrySchema).optional(),
-    customOnly: zod_1.z.boolean().optional().default(false),
-});
-exports.sessionOptionsSchema = zod_1.z.object({
-    sessionMode: zod_1.z
-        .union([zod_1.z.literal('stateful'), zod_1.z.literal('stateless'), zod_1.z.function()])
-        .optional()
-        .default('stateless'),
-    transportIdMode: zod_1.z
-        .union([zod_1.z.literal('uuid'), zod_1.z.literal('jwt'), zod_1.z.function()])
-        .optional()
-        .default('uuid'),
-    platformDetection: exports.platformDetectionConfigSchema.optional(),
-});
-//# sourceMappingURL=session.options.js.map

package/src/common/types/options/session.options.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.options.js","sourceRoot":"","sources":["../../../../../src/common/types/options/session.options.ts"],"names":[],"mappings":";;;AACA,6BAAwB;AACxB,yDAA6E;AA6F7E;;;GAGG;AACU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,EAAE,oCAAoB;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACU,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IACpD,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,kCAA0B,CAAC,CAAC,QAAQ,EAAE;IACxD,UAAU,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAClD,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,WAAW,EAAE,OAAC;SACX,KAAK,CAAC,CAAC,OAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,OAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;SACpE,QAAQ,EAAE;SACV,OAAO,CAAC,WAAW,CAAC;IACvB,eAAe,EAAE,OAAC;SACf,KAAK,CAAC,CAAC,OAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;SAC1D,QAAQ,EAAE;SACV,OAAO,CAAC,MAAM,CAAC;IAClB,iBAAiB,EAAE,qCAA6B,CAAC,QAAQ,EAAE;CACtB,CAAC,CAAC","sourcesContent":["import { RawZodShape } from '../common.types';\nimport { z } from 'zod';\nimport { AIPlatformType, aiPlatformTypeSchema } from '../auth/session.types';\n\nexport type SessionMode = 'stateful' | 'stateless';\nexport type TransportIdMode = 'uuid' | 'jwt';\n\n/**\n * A single platform mapping entry for custom client-to-platform detection.\n */\nexport interface PlatformMappingEntry {\n  /** Pattern to match against clientInfo.name (string for exact match, RegExp for pattern) */\n  pattern: string | RegExp;\n  /** The platform type to assign when pattern matches */\n  platform: AIPlatformType;\n}\n\n/**\n * Configuration for platform detection from MCP client info.\n */\nexport interface PlatformDetectionConfig {\n  /**\n   * Custom mappings to check before default detection.\n   * Mappings are evaluated in order; first match wins.\n   */\n  mappings?: PlatformMappingEntry[];\n  /**\n   * If true, skip default detection when no custom mapping matches.\n   * The platform will be 'unknown' instead of attempting keyword-based detection.\n   * @default false\n   */\n  customOnly?: boolean;\n}\n\nexport type SessionOptions = {\n  /**\n   * Defines how the session lifecycle and nested tokens are managed.\n   *\n   * Modes:\n   * - `'stateful'`: Session and nested tokens are stored in a server-side store (e.g., Redis).\n   * - `'stateless'`: All session data (including nested tokens) is embedded within a signed/encrypted JWT.\n   *\n   * **Behavior:**\n   * - When using `'stateful'`:\n   *   - Nested OAuth tokens are **never exposed** in the JWT.\n   *   - Tokens are encrypted and persisted in Redis under a session key.\n   *   - The client receives only a lightweight reference (session key) instead of full credentials.\n   *   - Results in smaller JWT payloads and reduces token leakage risk.\n   *   - Allows seamless refresh of nested provider tokens without requiring user re-authorization.\n   *   - Recommended for multi-application environments or setups using short-lived OAuth tokens.\n   *\n   * - When using `'stateless'`:\n   *   - Stores all nested tokens directly within the JWT, enabling fully client-managed sessions.\n   *   - Does **not support token refresh** — once a nested provider token expires, re-authorization is required.\n   *   - Simplifies implementation but may degrade UX when tokens are short-lived.\n   *   - Best suited for lightweight or single-application environments where token rotation is less critical.\n   *\n   * @default 'stateful'\n   */\n  sessionMode?: SessionMode | ((issuer: string) => Promise<SessionMode> | SessionMode);\n  /**\n   * Defines how the Transport ID is generated, verified, and used across sessions.\n   *\n   * Modes:\n   * - `'uuid'`: Generates a random UUID per session.\n   * - `'jwt'`: Uses a signed JWT for stateless sessions, signed with a generated session key.\n   *\n   * **Behavior: **\n   * - When using `'jwt'`:\n   *   - Requires an active Redis connection to support distributed, stateless transport sessions.\n   *   - Each token is verified using a generated public key associated with the existing session.\n   *   - Enables access to a streamable HTTP transport session ID.\n   *   - For distributed systems, verification is optimized by checking if the session is already\n   *     verified by an existing live transport ID. This allows fast validation when multiple\n   *     transports are connected to a shared queue (high-availability setup).\n   *   - If the JWT's transport ID is not found on the current worker node, the system attempts\n   *     to connect to the corresponding remote transport in the distributed infrastructure.\n   *\n   * - When using `'uuid'`:\n   *   - Provides a strict, node-bound session transport (single-node mode).\n   *   - Each request verifies the `Authorization` header and searches for a matching transport ID\n   *     derived from the hashed authorization header and the generated transport UUID.\n   *   - If no matching transport ID is found, an error (`TransportNotInitialized`) is thrown.\n   *\n   * @default 'uuid'\n   */\n  transportIdMode?: TransportIdMode | ((issuer: string) => Promise<TransportIdMode> | TransportIdMode);\n\n  /**\n   * Configuration for detecting the AI platform from MCP client info.\n   * Allows custom mappings to override or supplement the default keyword-based detection.\n   */\n  platformDetection?: PlatformDetectionConfig;\n};\n\n/**\n * Zod schema for platform mapping entry.\n * Note: RegExp cannot be validated by zod, so we use passthrough for pattern.\n */\nexport const platformMappingEntrySchema = z.object({\n  pattern: z.union([z.string(), z.instanceof(RegExp)]),\n  platform: aiPlatformTypeSchema,\n});\n\n/**\n * Zod schema for platform detection configuration.\n */\nexport const platformDetectionConfigSchema = z.object({\n  mappings: z.array(platformMappingEntrySchema).optional(),\n  customOnly: z.boolean().optional().default(false),\n});\n\nexport const sessionOptionsSchema = z.object({\n  sessionMode: z\n    .union([z.literal('stateful'), z.literal('stateless'), z.function()])\n    .optional()\n    .default('stateless'),\n  transportIdMode: z\n    .union([z.literal('uuid'), z.literal('jwt'), z.function()])\n    .optional()\n    .default('uuid'),\n  platformDetection: platformDetectionConfigSchema.optional(),\n} satisfies RawZodShape<SessionOptions>);\n"]}

package/src/common/types/options/transport.options.js

@@ -1,121 +0,0 @@
-"use strict";
-// common/types/options/transport.options.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.transportOptionsSchema = exports.transportPersistenceConfigSchema = void 0;
-const zod_1 = require("zod");
-const redis_options_1 = require("./redis.options");
-const session_options_1 = require("./session.options");
-// ============================================
-// TRANSPORT PERSISTENCE (from auth.transport.recreation)
-// ============================================
-/**
- * Transport persistence configuration
- * Enables session persistence to Redis and automatic transport recreation after server restart
- */
-exports.transportPersistenceConfigSchema = zod_1.z.object({
-    /**
-     * Enable transport persistence to Redis
-     * When enabled, sessions are persisted to Redis and transports can be recreated after restart
-     * @default false
-     */
-    enabled: zod_1.z.boolean().default(false),
-    /**
-     * Redis configuration for session storage
-     * If omitted when enabled=true, uses top-level redis config
-     * Note: Validation for redis presence happens at runtime when persistence is used
-     */
-    redis: redis_options_1.redisOptionsSchema.optional(),
-    /**
-     * Default TTL for stored session metadata (milliseconds)
-     * @default 3600000 (1 hour)
-     */
-    defaultTtlMs: zod_1.z.number().int().positive().default(3600000),
-});
-// ============================================
-// TRANSPORT OPTIONS (unified config)
-// ============================================
-/**
- * Transport options schema
- * Consolidates transport protocol config + session lifecycle config
- */
-exports.transportOptionsSchema = zod_1.z.object({
-    // ============================================
-    // Session Lifecycle (from session.options.ts)
-    // ============================================
-    /**
-     * Defines how the session lifecycle and nested tokens are managed.
-     *
-     * Modes:
-     * - `'stateful'`: Session and nested tokens are stored in a server-side store (e.g., Redis).
-     * - `'stateless'`: All session data (including nested tokens) is embedded within a signed/encrypted JWT.
-     *
-     * @default 'stateful'
-     */
-    sessionMode: zod_1.z
-        .union([zod_1.z.literal('stateful'), zod_1.z.literal('stateless'), zod_1.z.function()])
-        .optional()
-        .default('stateful'),
-    /**
-     * Defines how the Transport ID is generated, verified, and used across sessions.
-     *
-     * Modes:
-     * - `'uuid'`: Generates a random UUID per session.
-     * - `'jwt'`: Uses a signed JWT for stateless sessions, signed with a generated session key.
-     *
-     * @default 'uuid'
-     */
-    transportIdMode: zod_1.z
-        .union([zod_1.z.literal('uuid'), zod_1.z.literal('jwt'), zod_1.z.function()])
-        .optional()
-        .default('uuid'),
-    /**
-     * Configuration for detecting the AI platform from MCP client info.
-     * Allows custom mappings to override or supplement the default keyword-based detection.
-     */
-    platformDetection: session_options_1.platformDetectionConfigSchema.optional(),
-    // ============================================
-    // Transport Protocols (from auth.transport)
-    // ============================================
-    /**
-     * Enable legacy SSE transport (old HTTP+SSE protocol)
-     * @default false
-     */
-    enableLegacySSE: zod_1.z.boolean().default(false),
-    /**
-     * Enable SSE listener for server-initiated messages (GET /mcp with Accept: text/event-stream)
-     * @default true
-     */
-    enableSseListener: zod_1.z.boolean().default(true),
-    /**
-     * Enable streamable HTTP transport (POST with SSE response)
-     * @default true
-     */
-    enableStreamableHttp: zod_1.z.boolean().default(true),
-    /**
-     * Enable stateless HTTP mode (requests without session ID)
-     * When enabled, allows requests without prior initialize
-     * Uses shared singleton transport for anonymous, per-token singleton for authenticated
-     * @default false
-     */
-    enableStatelessHttp: zod_1.z.boolean().default(false),
-    /**
-     * Enable stateful HTTP transport (JSON-only responses)
-     * @default false
-     */
-    enableStatefulHttp: zod_1.z.boolean().default(false),
-    /**
-     * Require session ID for streamable HTTP (non-stateless mode)
-     * When false, streamable HTTP requests don't require prior initialize
-     * @default true
-     */
-    requireSessionForStreamable: zod_1.z.boolean().default(true),
-    // ============================================
-    // Transport Persistence
-    // ============================================
-    /**
-     * Transport persistence configuration
-     * When enabled, sessions are persisted to Redis and transports can be recreated after server restart
-     */
-    persistence: exports.transportPersistenceConfigSchema.optional(),
-});
-//# sourceMappingURL=transport.options.js.map

package/src/common/types/options/transport.options.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transport.options.js","sourceRoot":"","sources":["../../../../../src/common/types/options/transport.options.ts"],"names":[],"mappings":";AAAA,4CAA4C;;;AAE5C,6BAAwB;AACxB,mDAAqD;AACrD,uDAO2B;AAK3B,+CAA+C;AAC/C,yDAAyD;AACzD,+CAA+C;AAE/C;;;GAGG;AACU,QAAA,gCAAgC,GAAG,OAAC,CAAC,MAAM,CAAC;IACvD;;;;OAIG;IACH,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEnC;;;;OAIG;IACH,KAAK,EAAE,kCAAkB,CAAC,QAAQ,EAAE;IAEpC;;;OAGG;IACH,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;CAC3D,CAAC,CAAC;AAEH,+CAA+C;AAC/C,qCAAqC;AACrC,+CAA+C;AAE/C;;;GAGG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,+CAA+C;IAC/C,8CAA8C;IAC9C,+CAA+C;IAE/C;;;;;;;;OAQG;IACH,WAAW,EAAE,OAAC;SACX,KAAK,CAAC,CAAC,OAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,OAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;SACpE,QAAQ,EAAE;SACV,OAAO,CAAC,UAAU,CAAC;IAEtB;;;;;;;;OAQG;IACH,eAAe,EAAE,OAAC;SACf,KAAK,CAAC,CAAC,OAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;SAC1D,QAAQ,EAAE;SACV,OAAO,CAAC,MAAM,CAAC;IAElB;;;OAGG;IACH,iBAAiB,EAAE,+CAA6B,CAAC,QAAQ,EAAE;IAE3D,+CAA+C;IAC/C,4CAA4C;IAC5C,+CAA+C;IAE/C;;;OAGG;IACH,eAAe,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAE3C;;;OAGG;IACH,iBAAiB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAE5C;;;OAGG;IACH,oBAAoB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAE/C;;;;;OAKG;IACH,mBAAmB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAE/C;;;OAGG;IACH,kBAAkB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAE9C;;;;OAIG;IACH,2BAA2B,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAEtD,+CAA+C;IAC/C,wBAAwB;IACxB,+CAA+C;IAE/C;;;OAGG;IACH,WAAW,EAAE,wCAAgC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC","sourcesContent":["// common/types/options/transport.options.ts\n\nimport { z } from 'zod';\nimport { redisOptionsSchema } from './redis.options';\nimport {\n  SessionMode,\n  TransportIdMode,\n  PlatformMappingEntry,\n  PlatformDetectionConfig,\n  platformMappingEntrySchema,\n  platformDetectionConfigSchema,\n} from './session.options';\n\n// Re-export session types for convenience (these are the canonical definitions)\nexport type { SessionMode, TransportIdMode, PlatformMappingEntry, PlatformDetectionConfig };\n\n// ============================================\n// TRANSPORT PERSISTENCE (from auth.transport.recreation)\n// ============================================\n\n/**\n * Transport persistence configuration\n * Enables session persistence to Redis and automatic transport recreation after server restart\n */\nexport const transportPersistenceConfigSchema = z.object({\n  /**\n   * Enable transport persistence to Redis\n   * When enabled, sessions are persisted to Redis and transports can be recreated after restart\n   * @default false\n   */\n  enabled: z.boolean().default(false),\n\n  /**\n   * Redis configuration for session storage\n   * If omitted when enabled=true, uses top-level redis config\n   * Note: Validation for redis presence happens at runtime when persistence is used\n   */\n  redis: redisOptionsSchema.optional(),\n\n  /**\n   * Default TTL for stored session metadata (milliseconds)\n   * @default 3600000 (1 hour)\n   */\n  defaultTtlMs: z.number().int().positive().default(3600000),\n});\n\n// ============================================\n// TRANSPORT OPTIONS (unified config)\n// ============================================\n\n/**\n * Transport options schema\n * Consolidates transport protocol config + session lifecycle config\n */\nexport const transportOptionsSchema = z.object({\n  // ============================================\n  // Session Lifecycle (from session.options.ts)\n  // ============================================\n\n  /**\n   * Defines how the session lifecycle and nested tokens are managed.\n   *\n   * Modes:\n   * - `'stateful'`: Session and nested tokens are stored in a server-side store (e.g., Redis).\n   * - `'stateless'`: All session data (including nested tokens) is embedded within a signed/encrypted JWT.\n   *\n   * @default 'stateful'\n   */\n  sessionMode: z\n    .union([z.literal('stateful'), z.literal('stateless'), z.function()])\n    .optional()\n    .default('stateful'),\n\n  /**\n   * Defines how the Transport ID is generated, verified, and used across sessions.\n   *\n   * Modes:\n   * - `'uuid'`: Generates a random UUID per session.\n   * - `'jwt'`: Uses a signed JWT for stateless sessions, signed with a generated session key.\n   *\n   * @default 'uuid'\n   */\n  transportIdMode: z\n    .union([z.literal('uuid'), z.literal('jwt'), z.function()])\n    .optional()\n    .default('uuid'),\n\n  /**\n   * Configuration for detecting the AI platform from MCP client info.\n   * Allows custom mappings to override or supplement the default keyword-based detection.\n   */\n  platformDetection: platformDetectionConfigSchema.optional(),\n\n  // ============================================\n  // Transport Protocols (from auth.transport)\n  // ============================================\n\n  /**\n   * Enable legacy SSE transport (old HTTP+SSE protocol)\n   * @default false\n   */\n  enableLegacySSE: z.boolean().default(false),\n\n  /**\n   * Enable SSE listener for server-initiated messages (GET /mcp with Accept: text/event-stream)\n   * @default true\n   */\n  enableSseListener: z.boolean().default(true),\n\n  /**\n   * Enable streamable HTTP transport (POST with SSE response)\n   * @default true\n   */\n  enableStreamableHttp: z.boolean().default(true),\n\n  /**\n   * Enable stateless HTTP mode (requests without session ID)\n   * When enabled, allows requests without prior initialize\n   * Uses shared singleton transport for anonymous, per-token singleton for authenticated\n   * @default false\n   */\n  enableStatelessHttp: z.boolean().default(false),\n\n  /**\n   * Enable stateful HTTP transport (JSON-only responses)\n   * @default false\n   */\n  enableStatefulHttp: z.boolean().default(false),\n\n  /**\n   * Require session ID for streamable HTTP (non-stateless mode)\n   * When false, streamable HTTP requests don't require prior initialize\n   * @default true\n   */\n  requireSessionForStreamable: z.boolean().default(true),\n\n  // ============================================\n  // Transport Persistence\n  // ============================================\n\n  /**\n   * Transport persistence configuration\n   * When enabled, sessions are persisted to Redis and transports can be recreated after server restart\n   */\n  persistence: transportPersistenceConfigSchema.optional(),\n});\n\n// ============================================\n// TYPE EXPORTS\n// ============================================\n\n/**\n * Transport options type (with defaults applied)\n */\nexport type TransportOptions = z.infer<typeof transportOptionsSchema>;\n\n/**\n * Transport options input type (for user configuration)\n */\nexport type TransportOptionsInput = z.input<typeof transportOptionsSchema>;\n\n/**\n * Transport persistence configuration type\n */\nexport type TransportPersistenceConfig = z.infer<typeof transportPersistenceConfigSchema>;\n\n/**\n * Transport persistence configuration input type\n */\nexport type TransportPersistenceConfigInput = z.input<typeof transportPersistenceConfigSchema>;\n\n/**\n * Platform detection configuration type\n */\nexport type PlatformDetectionConfigType = z.infer<typeof platformDetectionConfigSchema>;\n"]}