@mcp-ts/sdk 2.2.0 → 2.3.1

package/dist/server/index.d.mts

@@ -31,6 +31,17 @@ interface Session {
     codeVerifier?: string;
     clientId?: string;
 }
+type SessionMutationType = 'create' | 'update' | 'delete';
+interface SessionMutationEvent {
+    type: SessionMutationType;
+    userId: string;
+    sessionId: string;
+    timestamp: number;
+    session?: Session;
+    patch?: Partial<Session>;
+    ttl?: number;
+}
+type SessionMutationListener = (event: SessionMutationEvent) => void | Promise<void>;
 /**
  * Interface for MCP session stores.
  */
@@ -91,6 +102,7 @@ interface SessionStore {
     disconnect(): Promise<void>;
 }
 
+declare function onSessionMutation(listener: SessionMutationListener): () => void;
 /**
  * Global session store instance
  * Uses lazy initialization with a Proxy to handle async setup transparently
@@ -262,4 +274,4 @@ declare function createNextMcpHandler(options?: NextMcpHandlerOptions): {
     POST: (request: Request) => Promise<Response>;
 };
 
-export { type ClientMetadata, McpConnectionEvent, McpObservabilityEvent, McpRpcRequest, McpRpcResponse, type NextMcpHandlerOptions, SSEConnectionManager, type SSEHandlerOptions, type SessionStore, createNextMcpHandler, createSSEHandler, sessions };
+export { type ClientMetadata, McpConnectionEvent, McpObservabilityEvent, McpRpcRequest, McpRpcResponse, type NextMcpHandlerOptions, SSEConnectionManager, type SSEHandlerOptions, type Session, type SessionMutationEvent, type SessionMutationListener, type SessionMutationType, type SessionStore, createNextMcpHandler, createSSEHandler, onSessionMutation, sessions };

package/dist/server/index.d.ts

@@ -31,6 +31,17 @@ interface Session {
     codeVerifier?: string;
     clientId?: string;
 }
+type SessionMutationType = 'create' | 'update' | 'delete';
+interface SessionMutationEvent {
+    type: SessionMutationType;
+    userId: string;
+    sessionId: string;
+    timestamp: number;
+    session?: Session;
+    patch?: Partial<Session>;
+    ttl?: number;
+}
+type SessionMutationListener = (event: SessionMutationEvent) => void | Promise<void>;
 /**
  * Interface for MCP session stores.
  */
@@ -91,6 +102,7 @@ interface SessionStore {
     disconnect(): Promise<void>;
 }
 
+declare function onSessionMutation(listener: SessionMutationListener): () => void;
 /**
  * Global session store instance
  * Uses lazy initialization with a Proxy to handle async setup transparently
@@ -262,4 +274,4 @@ declare function createNextMcpHandler(options?: NextMcpHandlerOptions): {
     POST: (request: Request) => Promise<Response>;
 };
 
-export { type ClientMetadata, McpConnectionEvent, McpObservabilityEvent, McpRpcRequest, McpRpcResponse, type NextMcpHandlerOptions, SSEConnectionManager, type SSEHandlerOptions, type SessionStore, createNextMcpHandler, createSSEHandler, sessions };
+export { type ClientMetadata, McpConnectionEvent, McpObservabilityEvent, McpRpcRequest, McpRpcResponse, type NextMcpHandlerOptions, SSEConnectionManager, type SSEHandlerOptions, type Session, type SessionMutationEvent, type SessionMutationListener, type SessionMutationType, type SessionStore, createNextMcpHandler, createSSEHandler, onSessionMutation, sessions };

package/dist/server/index.js

@@ -1236,6 +1236,59 @@ function warnIfNeonConnectionStringIsInsecure(connectionString) {
 }
 var storageInstance = null;
 var storagePromise = null;
+var sessionMutationListeners = /* @__PURE__ */ new Set();
+function emitSessionMutation(event) {
+  for (const listener of sessionMutationListeners) {
+    try {
+      const result = listener(event);
+      if (result && typeof result.catch === "function") {
+        void result.catch((error) => {
+          console.error("[mcp-ts][Storage] Session mutation listener failed:", error);
+        });
+      }
+    } catch (error) {
+      console.error("[mcp-ts][Storage] Session mutation listener failed:", error);
+    }
+  }
+}
+function createSessionMutationEvent(prop, args) {
+  const timestamp = Date.now();
+  if (prop === "create") {
+    const [session, ttl] = args;
+    if (!session?.userId || !session?.sessionId) return null;
+    return {
+      type: "create",
+      userId: session.userId,
+      sessionId: session.sessionId,
+      session,
+      ttl,
+      timestamp
+    };
+  }
+  if (prop === "update") {
+    const [userId, sessionId, patch, ttl] = args;
+    if (!userId || !sessionId) return null;
+    return {
+      type: "update",
+      userId,
+      sessionId,
+      patch,
+      ttl,
+      timestamp
+    };
+  }
+  if (prop === "delete") {
+    const [userId, sessionId] = args;
+    if (!userId || !sessionId) return null;
+    return {
+      type: "delete",
+      userId,
+      sessionId,
+      timestamp
+    };
+  }
+  return null;
+}
 async function initializeStorage(store) {
   if (typeof store.init === "function") {
     await store.init();
@@ -1373,13 +1426,24 @@ async function getStorage() {
   storageInstance = await storagePromise;
   return storageInstance;
 }
+function onSessionMutation(listener) {
+  sessionMutationListeners.add(listener);
+  return () => {
+    sessionMutationListeners.delete(listener);
+  };
+}
 var sessions = new Proxy({}, {
   get(_target, prop) {
     return async (...args) => {
       const instance = await getStorage();
       const value = instance[prop];
       if (typeof value === "function") {
-        return value.apply(instance, args);
+        const result = await value.apply(instance, args);
+        const event = createSessionMutationEvent(prop, args);
+        if (event) {
+          emitSessionMutation(event);
+        }
+        return result;
       }
       return value;
     };
@@ -3370,6 +3434,7 @@ exports.StorageOAuthClientProvider = StorageOAuthClientProvider;
 exports.UnauthorizedError = UnauthorizedError;
 exports.createNextMcpHandler = createNextMcpHandler;
 exports.createSSEHandler = createSSEHandler;
+exports.onSessionMutation = onSessionMutation;
 exports.sanitizeServerLabel = sanitizeServerLabel;
 exports.sessions = sessions;
 //# sourceMappingURL=index.js.map