@leanmcp/core 0.4.2 → 0.4.4

package/dist/index.d.mts

@@ -576,11 +576,20 @@ interface LeanMCPSessionProviderOptions {
     ttlSeconds?: number;
     logging?: boolean;
     sessionStore?: ISessionStore;
+    /**
+     * Force DynamoDB even when not on Lambda (for local testing with real DynamoDB)
+     */
+    forceDynamoDB?: boolean;
 }
 /**
  * Drop-in replacement for Map<string, StreamableHTTPServerTransport>
  * Provides automatic session persistence for Lambda deployments
  *
+ * Environment auto-detection:
+ * - Local development (default): Uses in-memory session store
+ * - LeanMCP Lambda (LEANMCP_LAMBDA=true): Uses DynamoDB session store
+ * - Explicit override: Pass sessionStore option or forceDynamoDB: true
+ *
  * @example
  * // Before: const transports = new Map<string, StreamableHTTPServerTransport>();
  * // After:  const sessions = new LeanMCPSessionProvider();
@@ -590,7 +599,12 @@ interface LeanMCPSessionProviderOptions {
 declare class LeanMCPSessionProvider {
     private transports;
     private sessionStore;
+    private isUsingDynamoDB;
     constructor(options?: LeanMCPSessionProviderOptions);
+    /**
+     * Check if using DynamoDB (useful for debugging)
+     */
+    get usingDynamoDB(): boolean;
     /**
      * Get transport from memory
      */
@@ -691,6 +705,29 @@ declare class DynamoDBSessionStore implements ISessionStore {
     deleteSession(sessionId: string): Promise<void>;
 }
 
+/**
+ * In-memory session store for local development
+ * Sessions are stored in memory and lost when the process restarts
+ *
+ * This is the default for local development - no external dependencies needed
+ */
+declare class InMemorySessionStore implements ISessionStore {
+    private sessions;
+    sessionExists(sessionId: string): Promise<boolean>;
+    createSession(sessionId: string, data?: Record<string, any>): Promise<void>;
+    getSession(sessionId: string): Promise<SessionData | null>;
+    updateSession(sessionId: string, updates: Partial<SessionData>): Promise<void>;
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Get number of sessions (useful for debugging)
+     */
+    get size(): number;
+    /**
+     * Clear all sessions (useful for testing)
+     */
+    clear(): void;
+}
+
 interface MCPServerOptions {
     servicesDir: string;
     port?: number;
@@ -928,4 +965,4 @@ declare class MCPServerRuntime {
  */
 declare function startMCPServer(options: MCPServerOptions): Promise<MCPServerRuntime>;
 
-export { Auth, type AuthErrorOptions, type AuthErrorResult, type AuthOptions, DEFAULT_TABLE_NAME, DEFAULT_TTL_SECONDS, Deprecated, DynamoDBSessionStore, type HTTPServerAuthOptions, type HTTPServerInput, type HTTPServerOptions, type ISessionStore, LeanMCPSessionProvider, type LeanMCPSessionProviderOptions, LogLevel, type LogPayload, Logger, type LoggerHandler, type LoggerOptions, MCPServer, type MCPServerConstructorOptions, type MCPServerFactory, type MCPServerOptions, MCPServerRuntime, Optional, Prompt, type PromptOptions, type ProtectedResourceMetadata, Render, Resource, type ResourceOptions, SchemaConstraint, type SecurityScheme, type SessionData, Tool, type ToolOptions, UI, UserEnvs, classToJsonSchema, classToJsonSchemaWithConstraints, createAuthError, createHTTPServer, createProtectedResourceMetadata, defaultLogger, extractBearerToken, getDecoratedMethods, getMethodMetadata, isAuthError, startMCPServer, validateNonEmpty, validatePath, validatePort, validateServiceName, validateUrl };
+export { Auth, type AuthErrorOptions, type AuthErrorResult, type AuthOptions, DEFAULT_TABLE_NAME, DEFAULT_TTL_SECONDS, Deprecated, DynamoDBSessionStore, type HTTPServerAuthOptions, type HTTPServerInput, type HTTPServerOptions, type ISessionStore, InMemorySessionStore, LeanMCPSessionProvider, type LeanMCPSessionProviderOptions, LogLevel, type LogPayload, Logger, type LoggerHandler, type LoggerOptions, MCPServer, type MCPServerConstructorOptions, type MCPServerFactory, type MCPServerOptions, MCPServerRuntime, Optional, Prompt, type PromptOptions, type ProtectedResourceMetadata, Render, Resource, type ResourceOptions, SchemaConstraint, type SecurityScheme, type SessionData, Tool, type ToolOptions, UI, UserEnvs, classToJsonSchema, classToJsonSchemaWithConstraints, createAuthError, createHTTPServer, createProtectedResourceMetadata, defaultLogger, extractBearerToken, getDecoratedMethods, getMethodMetadata, isAuthError, startMCPServer, validateNonEmpty, validatePath, validatePort, validateServiceName, validateUrl };

package/dist/index.d.ts

@@ -576,11 +576,20 @@ interface LeanMCPSessionProviderOptions {
     ttlSeconds?: number;
     logging?: boolean;
     sessionStore?: ISessionStore;
+    /**
+     * Force DynamoDB even when not on Lambda (for local testing with real DynamoDB)
+     */
+    forceDynamoDB?: boolean;
 }
 /**
  * Drop-in replacement for Map<string, StreamableHTTPServerTransport>
  * Provides automatic session persistence for Lambda deployments
  *
+ * Environment auto-detection:
+ * - Local development (default): Uses in-memory session store
+ * - LeanMCP Lambda (LEANMCP_LAMBDA=true): Uses DynamoDB session store
+ * - Explicit override: Pass sessionStore option or forceDynamoDB: true
+ *
  * @example
  * // Before: const transports = new Map<string, StreamableHTTPServerTransport>();
  * // After:  const sessions = new LeanMCPSessionProvider();
@@ -590,7 +599,12 @@ interface LeanMCPSessionProviderOptions {
 declare class LeanMCPSessionProvider {
     private transports;
     private sessionStore;
+    private isUsingDynamoDB;
     constructor(options?: LeanMCPSessionProviderOptions);
+    /**
+     * Check if using DynamoDB (useful for debugging)
+     */
+    get usingDynamoDB(): boolean;
     /**
      * Get transport from memory
      */
@@ -691,6 +705,29 @@ declare class DynamoDBSessionStore implements ISessionStore {
     deleteSession(sessionId: string): Promise<void>;
 }
 
+/**
+ * In-memory session store for local development
+ * Sessions are stored in memory and lost when the process restarts
+ *
+ * This is the default for local development - no external dependencies needed
+ */
+declare class InMemorySessionStore implements ISessionStore {
+    private sessions;
+    sessionExists(sessionId: string): Promise<boolean>;
+    createSession(sessionId: string, data?: Record<string, any>): Promise<void>;
+    getSession(sessionId: string): Promise<SessionData | null>;
+    updateSession(sessionId: string, updates: Partial<SessionData>): Promise<void>;
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Get number of sessions (useful for debugging)
+     */
+    get size(): number;
+    /**
+     * Clear all sessions (useful for testing)
+     */
+    clear(): void;
+}
+
 interface MCPServerOptions {
     servicesDir: string;
     port?: number;
@@ -928,4 +965,4 @@ declare class MCPServerRuntime {
  */
 declare function startMCPServer(options: MCPServerOptions): Promise<MCPServerRuntime>;
 
-export { Auth, type AuthErrorOptions, type AuthErrorResult, type AuthOptions, DEFAULT_TABLE_NAME, DEFAULT_TTL_SECONDS, Deprecated, DynamoDBSessionStore, type HTTPServerAuthOptions, type HTTPServerInput, type HTTPServerOptions, type ISessionStore, LeanMCPSessionProvider, type LeanMCPSessionProviderOptions, LogLevel, type LogPayload, Logger, type LoggerHandler, type LoggerOptions, MCPServer, type MCPServerConstructorOptions, type MCPServerFactory, type MCPServerOptions, MCPServerRuntime, Optional, Prompt, type PromptOptions, type ProtectedResourceMetadata, Render, Resource, type ResourceOptions, SchemaConstraint, type SecurityScheme, type SessionData, Tool, type ToolOptions, UI, UserEnvs, classToJsonSchema, classToJsonSchemaWithConstraints, createAuthError, createHTTPServer, createProtectedResourceMetadata, defaultLogger, extractBearerToken, getDecoratedMethods, getMethodMetadata, isAuthError, startMCPServer, validateNonEmpty, validatePath, validatePort, validateServiceName, validateUrl };
+export { Auth, type AuthErrorOptions, type AuthErrorResult, type AuthOptions, DEFAULT_TABLE_NAME, DEFAULT_TTL_SECONDS, Deprecated, DynamoDBSessionStore, type HTTPServerAuthOptions, type HTTPServerInput, type HTTPServerOptions, type ISessionStore, InMemorySessionStore, LeanMCPSessionProvider, type LeanMCPSessionProviderOptions, LogLevel, type LogPayload, Logger, type LoggerHandler, type LoggerOptions, MCPServer, type MCPServerConstructorOptions, type MCPServerFactory, type MCPServerOptions, MCPServerRuntime, Optional, Prompt, type PromptOptions, type ProtectedResourceMetadata, Render, Resource, type ResourceOptions, SchemaConstraint, type SecurityScheme, type SessionData, Tool, type ToolOptions, UI, UserEnvs, classToJsonSchema, classToJsonSchemaWithConstraints, createAuthError, createHTTPServer, createProtectedResourceMetadata, defaultLogger, extractBearerToken, getDecoratedMethods, getMethodMetadata, isAuthError, startMCPServer, validateNonEmpty, validatePath, validatePort, validateServiceName, validateUrl };

package/dist/index.js

@@ -1065,7 +1065,12 @@ async function createHTTPServer(serverInput, options) {
             }, "onsessioninitialized")
           });
           transports[sessionId] = transport;
-          logger.info(`Transport stored for session: ${sessionId}`);
+          const webTransport = transport._webStandardTransport;
+          if (webTransport) {
+            webTransport._initialized = true;
+            webTransport.sessionId = sessionId;
+            logger.info(`Transport initialized flag set for session: ${sessionId}`);
+          }
           transport.onclose = async () => {
             if (transport.sessionId) {
               delete transports[transport.sessionId];
@@ -1374,6 +1379,59 @@ var init_session_store = __esm({
   }
 });
 
+// src/inmemory-session-store.ts
+var InMemorySessionStore;
+var init_inmemory_session_store = __esm({
+  "src/inmemory-session-store.ts"() {
+    "use strict";
+    InMemorySessionStore = class {
+      static {
+        __name(this, "InMemorySessionStore");
+      }
+      sessions = /* @__PURE__ */ new Map();
+      async sessionExists(sessionId) {
+        return this.sessions.has(sessionId);
+      }
+      async createSession(sessionId, data) {
+        const now = /* @__PURE__ */ new Date();
+        this.sessions.set(sessionId, {
+          sessionId,
+          createdAt: now,
+          updatedAt: now,
+          data: data || {}
+        });
+      }
+      async getSession(sessionId) {
+        return this.sessions.get(sessionId) ?? null;
+      }
+      async updateSession(sessionId, updates) {
+        const existing = this.sessions.get(sessionId);
+        if (!existing) return;
+        this.sessions.set(sessionId, {
+          ...existing,
+          ...updates,
+          updatedAt: /* @__PURE__ */ new Date()
+        });
+      }
+      async deleteSession(sessionId) {
+        this.sessions.delete(sessionId);
+      }
+      /**
+      * Get number of sessions (useful for debugging)
+      */
+      get size() {
+        return this.sessions.size;
+      }
+      /**
+      * Clear all sessions (useful for testing)
+      */
+      clear() {
+        this.sessions.clear();
+      }
+    };
+  }
+});
+
 // src/session-provider.ts
 var import_streamableHttp, LeanMCPSessionProvider;
 var init_session_provider = __esm({
@@ -1381,25 +1439,44 @@ var init_session_provider = __esm({
     "use strict";
     import_streamableHttp = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
     init_dynamodb_session_store();
+    init_inmemory_session_store();
     LeanMCPSessionProvider = class {
       static {
         __name(this, "LeanMCPSessionProvider");
       }
       transports = /* @__PURE__ */ new Map();
       sessionStore;
+      isUsingDynamoDB;
       constructor(options) {
         if (options?.sessionStore) {
           this.sessionStore = options.sessionStore;
-        } else {
+          this.isUsingDynamoDB = false;
+        } else if (options?.forceDynamoDB || process.env.LEANMCP_LAMBDA === "true") {
           this.sessionStore = new DynamoDBSessionStore({
             tableName: options?.tableName,
             region: options?.region,
             ttlSeconds: options?.ttlSeconds,
             logging: options?.logging
           });
+          this.isUsingDynamoDB = true;
+          if (options?.logging) {
+            console.log("[LeanMCPSessionProvider] Using DynamoDB session store");
+          }
+        } else {
+          this.sessionStore = new InMemorySessionStore();
+          this.isUsingDynamoDB = false;
+          if (options?.logging) {
+            console.log("[LeanMCPSessionProvider] Using in-memory session store (local dev mode)");
+          }
         }
       }
       /**
+      * Check if using DynamoDB (useful for debugging)
+      */
+      get usingDynamoDB() {
+        return this.isUsingDynamoDB;
+      }
+      /**
       * Get transport from memory
       */
       get(sessionId) {
@@ -1429,7 +1506,7 @@ var init_session_provider = __esm({
       /**
       * Get or recreate transport for a session
       * This is the key method for Lambda support - handles container recycling
-      * 
+      *
       * @param sessionId - Session ID to get or recreate
       * @param serverFactory - Factory function to create fresh MCP server instances
       * @param transportOptions - Optional callbacks for transport lifecycle events
@@ -1447,6 +1524,12 @@ var init_session_provider = __esm({
             transportOptions?.onsessioninitialized?.(sid);
           }, "onsessioninitialized")
         });
+        this.transports.set(sessionId, transport);
+        const webTransport = transport._webStandardTransport;
+        if (webTransport) {
+          webTransport._initialized = true;
+          webTransport.sessionId = sessionId;
+        }
         transport.onclose = () => {
           this.transports.delete(sessionId);
           transportOptions?.onclose?.();
@@ -1512,6 +1595,7 @@ __export(index_exports, {
   DEFAULT_TTL_SECONDS: () => DEFAULT_TTL_SECONDS,
   Deprecated: () => Deprecated,
   DynamoDBSessionStore: () => DynamoDBSessionStore,
+  InMemorySessionStore: () => InMemorySessionStore,
   LeanMCPSessionProvider: () => LeanMCPSessionProvider,
   LogLevel: () => LogLevel,
   Logger: () => Logger,
@@ -1568,6 +1652,7 @@ var init_index = __esm({
     init_session_store();
     init_session_provider();
     init_dynamodb_session_store();
+    init_inmemory_session_store();
     init_decorators();
     init_schema_generator();
     init_logger();
@@ -2574,6 +2659,7 @@ init_index();
   DEFAULT_TTL_SECONDS,
   Deprecated,
   DynamoDBSessionStore,
+  InMemorySessionStore,
   LeanMCPSessionProvider,
   LogLevel,
   Logger,

package/dist/index.mjs

@@ -763,7 +763,12 @@ async function createHTTPServer(serverInput, options) {
             }, "onsessioninitialized")
           });
           transports[sessionId] = transport;
-          logger.info(`Transport stored for session: ${sessionId}`);
+          const webTransport = transport._webStandardTransport;
+          if (webTransport) {
+            webTransport._initialized = true;
+            webTransport.sessionId = sessionId;
+            logger.info(`Transport initialized flag set for session: ${sessionId}`);
+          }
           transport.onclose = async () => {
             if (transport.sessionId) {
               delete transports[transport.sessionId];
@@ -1051,25 +1056,92 @@ __name(createProtectedResourceMetadata, "createProtectedResourceMetadata");
 
 // src/session-provider.ts
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+
+// src/inmemory-session-store.ts
+var InMemorySessionStore = class {
+  static {
+    __name(this, "InMemorySessionStore");
+  }
+  sessions = /* @__PURE__ */ new Map();
+  async sessionExists(sessionId) {
+    return this.sessions.has(sessionId);
+  }
+  async createSession(sessionId, data) {
+    const now = /* @__PURE__ */ new Date();
+    this.sessions.set(sessionId, {
+      sessionId,
+      createdAt: now,
+      updatedAt: now,
+      data: data || {}
+    });
+  }
+  async getSession(sessionId) {
+    return this.sessions.get(sessionId) ?? null;
+  }
+  async updateSession(sessionId, updates) {
+    const existing = this.sessions.get(sessionId);
+    if (!existing) return;
+    this.sessions.set(sessionId, {
+      ...existing,
+      ...updates,
+      updatedAt: /* @__PURE__ */ new Date()
+    });
+  }
+  async deleteSession(sessionId) {
+    this.sessions.delete(sessionId);
+  }
+  /**
+  * Get number of sessions (useful for debugging)
+  */
+  get size() {
+    return this.sessions.size;
+  }
+  /**
+  * Clear all sessions (useful for testing)
+  */
+  clear() {
+    this.sessions.clear();
+  }
+};
+
+// src/session-provider.ts
 var LeanMCPSessionProvider = class {
   static {
     __name(this, "LeanMCPSessionProvider");
   }
   transports = /* @__PURE__ */ new Map();
   sessionStore;
+  isUsingDynamoDB;
   constructor(options) {
     if (options?.sessionStore) {
       this.sessionStore = options.sessionStore;
-    } else {
+      this.isUsingDynamoDB = false;
+    } else if (options?.forceDynamoDB || process.env.LEANMCP_LAMBDA === "true") {
       this.sessionStore = new DynamoDBSessionStore({
         tableName: options?.tableName,
         region: options?.region,
         ttlSeconds: options?.ttlSeconds,
         logging: options?.logging
       });
+      this.isUsingDynamoDB = true;
+      if (options?.logging) {
+        console.log("[LeanMCPSessionProvider] Using DynamoDB session store");
+      }
+    } else {
+      this.sessionStore = new InMemorySessionStore();
+      this.isUsingDynamoDB = false;
+      if (options?.logging) {
+        console.log("[LeanMCPSessionProvider] Using in-memory session store (local dev mode)");
+      }
     }
   }
   /**
+  * Check if using DynamoDB (useful for debugging)
+  */
+  get usingDynamoDB() {
+    return this.isUsingDynamoDB;
+  }
+  /**
   * Get transport from memory
   */
   get(sessionId) {
@@ -1099,7 +1171,7 @@ var LeanMCPSessionProvider = class {
   /**
   * Get or recreate transport for a session
   * This is the key method for Lambda support - handles container recycling
-  * 
+  *
   * @param sessionId - Session ID to get or recreate
   * @param serverFactory - Factory function to create fresh MCP server instances
   * @param transportOptions - Optional callbacks for transport lifecycle events
@@ -1117,6 +1189,12 @@ var LeanMCPSessionProvider = class {
         transportOptions?.onsessioninitialized?.(sid);
       }, "onsessioninitialized")
     });
+    this.transports.set(sessionId, transport);
+    const webTransport = transport._webStandardTransport;
+    if (webTransport) {
+      webTransport._initialized = true;
+      webTransport.sessionId = sessionId;
+    }
     transport.onclose = () => {
       this.transports.delete(sessionId);
       transportOptions?.onclose?.();
@@ -2177,6 +2255,7 @@ export {
   DEFAULT_TTL_SECONDS,
   Deprecated,
   DynamoDBSessionStore,
+  InMemorySessionStore,
   LeanMCPSessionProvider,
   LogLevel,
   Logger,

package/package.json

@@ -1,78 +1,78 @@
-{
-  "name": "@leanmcp/core",
-  "version": "0.4.2",
-  "description": "Core library implementing decorators, reflection, and MCP runtime server",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.mjs"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
-    "test": "jest --passWithNoTests",
-    "test:watch": "jest --watch"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "@aws-sdk/client-dynamodb": "^3.700.0",
-    "@aws-sdk/lib-dynamodb": "^3.700.0",
-    "ajv": "^8.12.0",
-    "chokidar": "^4.0.0",
-    "dotenv": "^16.3.1",
-    "reflect-metadata": "^0.2.1"
-  },
-  "peerDependencies": {
-    "cors": "^2.8.5",
-    "express": "^5.0.0",
-    "@leanmcp/auth": "^0.4.0"
-  },
-  "peerDependenciesMeta": {
-    "express": {
-      "optional": true
-    },
-    "cors": {
-      "optional": true
-    },
-    "@leanmcp/auth": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/cors": "^2.8.0",
-    "@types/express": "^5.0.0",
-    "@types/node": "^20.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/LeanMCP/leanmcp-sdk.git",
-    "directory": "packages/core"
-  },
-  "homepage": "https://github.com/LeanMCP/leanmcp-sdk#readme",
-  "bugs": {
-    "url": "https://github.com/LeanMCP/leanmcp-sdk/issues"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "typescript",
-    "decorators",
-    "server",
-    "runtime"
-  ],
-  "author": "LeanMCP <admin@leanmcp.com>",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@leanmcp/core",
+  "version": "0.4.4",
+  "description": "Core library implementing decorators, reflection, and MCP runtime server",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@aws-sdk/client-dynamodb": "^3.700.0",
+    "@aws-sdk/lib-dynamodb": "^3.700.0",
+    "ajv": "^8.12.0",
+    "chokidar": "^4.0.0",
+    "dotenv": "^16.3.1",
+    "reflect-metadata": "^0.2.1"
+  },
+  "peerDependencies": {
+    "cors": "^2.8.5",
+    "express": "^5.0.0",
+    "@leanmcp/auth": "^0.4.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "cors": {
+      "optional": true
+    },
+    "@leanmcp/auth": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.0",
+    "@types/express": "^5.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LeanMCP/leanmcp-sdk.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/LeanMCP/leanmcp-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/LeanMCP/leanmcp-sdk/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "typescript",
+    "decorators",
+    "server",
+    "runtime"
+  ],
+  "author": "LeanMCP <admin@leanmcp.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}