@j0hanz/superfetch 2.1.3 → 2.1.4

package/dist/cache.js

@@ -410,6 +410,30 @@ function appendServerOnClose(server, handler) {
         handler();
     };
 }
+function attachInitializedGate(server) {
+    let initialized = false;
+    const previousInitialized = server.server.oninitialized;
+    server.server.oninitialized = () => {
+        initialized = true;
+        previousInitialized?.();
+    };
+    return () => initialized;
+}
+function getClientResourceCapabilities(server) {
+    const caps = server.server.getClientCapabilities();
+    if (!caps || !isRecord(caps)) {
+        return { listChanged: true, subscribe: true };
+    }
+    const { resources } = caps;
+    if (!isRecord(resources)) {
+        return { listChanged: true, subscribe: true };
+    }
+    const { listChanged, subscribe } = resources;
+    return {
+        listChanged: listChanged === true,
+        subscribe: subscribe === true,
+    };
+}
 function registerResourceSubscriptionHandlers(server) {
     const subscriptions = new Set();
     server.server.setRequestHandler(SubscribeRequestSchema, (request) => {
@@ -438,9 +462,10 @@ function notifyResourceUpdate(server, uri, subscriptions) {
     });
 }
 export function registerCachedContentResource(server) {
+    const isInitialized = attachInitializedGate(server);
     const subscriptions = registerResourceSubscriptionHandlers(server);
     registerCacheContentResource(server);
-    registerCacheUpdateSubscription(server, subscriptions);
+    registerCacheUpdateSubscription(server, subscriptions, isInitialized);
 }
 function buildCachedContentResponse(uri, cacheKey) {
     const cached = requireCacheEntry(cacheKey);
@@ -459,13 +484,18 @@ function registerCacheContentResource(server) {
         return buildCachedContentResponse(uri, cacheKey);
     });
 }
-function registerCacheUpdateSubscription(server, subscriptions) {
+function registerCacheUpdateSubscription(server, subscriptions, isInitialized) {
     const unsubscribe = onCacheUpdate(({ cacheKey }) => {
-        const resourceUri = toResourceUri(cacheKey);
-        if (!resourceUri)
+        if (!server.isConnected() || !isInitialized())
             return;
-        notifyResourceUpdate(server, resourceUri, subscriptions);
-        if (server.isConnected()) {
+        const { listChanged, subscribe } = getClientResourceCapabilities(server);
+        if (subscribe) {
+            const resourceUri = toResourceUri(cacheKey);
+            if (resourceUri) {
+                notifyResourceUpdate(server, resourceUri, subscriptions);
+            }
+        }
+        if (listChanged) {
             server.sendResourceListChanged();
         }
     });

package/dist/http.d.ts

@@ -4,6 +4,7 @@ interface SessionEntry {
     readonly transport: StreamableHTTPServerTransport;
     createdAt: number;
     lastSeen: number;
+    protocolInitialized: boolean;
 }
 interface McpRequestParams {
     _meta?: Record<string, unknown>;

package/dist/http.js

@@ -988,6 +988,14 @@ function respondServerBusy(res, requestId) {
 function respondBadRequest(res, id) {
     sendJsonRpcErrorOrNoContent(res, -32000, 'Bad Request: Missing session ID or not an initialize request', 400, id);
 }
+function respondSessionNotInitialized(res, requestId) {
+    sendJsonRpcErrorOrNoContent(res, -32000, 'Bad Request: Session not initialized', 400, requestId);
+}
+function isAllowedBeforeInitialized(method) {
+    return (method === 'initialize' ||
+        method === 'notifications/initialized' ||
+        method === 'ping');
+}
 function createTimeoutController() {
     let initTimeout = null;
     return {
@@ -1116,6 +1124,7 @@ async function connectTransportOrThrow({ transport, clearInitTimeout, releaseSlo
         logError('Failed to initialize MCP session', error instanceof Error ? error : undefined);
         throw error;
     }
+    return mcpServer;
 }
 function evictExpiredSessionsWithClose(store) {
     const evicted = store.evictExpired();
@@ -1156,9 +1165,14 @@ function reserveSessionIfPossible({ options, res, requestId, }) {
     }
     return true;
 }
-function resolveExistingSessionTransport(store, sessionId, res, requestId) {
+function resolveExistingSessionTransport(store, sessionId, res, requestId, method) {
     const existingSession = store.get(sessionId);
     if (existingSession) {
+        if (!existingSession.protocolInitialized &&
+            !isAllowedBeforeInitialized(method)) {
+            respondSessionNotInitialized(res, requestId);
+            return null;
+        }
         store.touch(sessionId);
         return existingSession.transport;
     }
@@ -1172,7 +1186,17 @@ function createSessionContext() {
     const transport = createSessionTransport({ tracker, timeoutController });
     return { tracker, timeoutController, transport };
 }
-function finalizeSessionIfValid({ store, transport, tracker, clearInitTimeout, res, requestId, }) {
+function attachSessionInitializedHandler(server, store, sessionId) {
+    const previousInitialized = server.server.oninitialized;
+    server.server.oninitialized = () => {
+        const entry = store.get(sessionId);
+        if (entry) {
+            entry.protocolInitialized = true;
+        }
+        previousInitialized?.();
+    };
+}
+function finalizeSessionIfValid({ store, transport, mcpServer, tracker, clearInitTimeout, res, requestId, }) {
     const { sessionId } = transport;
     if (typeof sessionId !== 'string') {
         clearInitTimeout();
@@ -1184,12 +1208,13 @@ function finalizeSessionIfValid({ store, transport, tracker, clearInitTimeout, r
         store,
         transport,
         sessionId,
+        mcpServer,
         tracker,
         clearInitTimeout,
     });
     return true;
 }
-function finalizeSession({ store, transport, sessionId, tracker, clearInitTimeout, }) {
+function finalizeSession({ store, transport, sessionId, mcpServer, tracker, clearInitTimeout, }) {
     clearInitTimeout();
     tracker.markInitialized();
     tracker.releaseSlot();
@@ -1198,7 +1223,9 @@ function finalizeSession({ store, transport, sessionId, tracker, clearInitTimeou
         transport,
         createdAt: now,
         lastSeen: now,
+        protocolInitialized: false,
     });
+    attachSessionInitializedHandler(mcpServer, store, sessionId);
     const previousOnClose = transport.onclose;
     transport.onclose = composeCloseHandlers(previousOnClose, () => {
         store.remove(sessionId);
@@ -1215,7 +1242,7 @@ async function createAndConnectTransport({ options, res, requestId, }) {
     if (!reserveSessionIfPossible(reserveArgs))
         return null;
     const { tracker, timeoutController, transport } = createSessionContext();
-    await connectTransportOrThrow({
+    const mcpServer = await connectTransportOrThrow({
         transport,
         clearInitTimeout: timeoutController.clear,
         releaseSlot: tracker.releaseSlot,
@@ -1223,6 +1250,7 @@ async function createAndConnectTransport({ options, res, requestId, }) {
     if (!finalizeSessionIfValid({
         store: options.sessionStore,
         transport,
+        mcpServer,
         tracker,
         clearInitTimeout: timeoutController.clear,
         res,
@@ -1235,7 +1263,7 @@ async function createAndConnectTransport({ options, res, requestId, }) {
 export async function resolveTransportForPost({ res, body, sessionId, options, }) {
     const requestId = body.id ?? null;
     if (sessionId) {
-        return resolveExistingSessionTransport(options.sessionStore, sessionId, res, requestId);
+        return resolveExistingSessionTransport(options.sessionStore, sessionId, res, requestId, body.method);
     }
     if (!isInitializeRequest(body)) {
         respondBadRequest(res, requestId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j0hanz/superfetch",
-  "version": "2.1.3",
+  "version": "2.1.4",
   "mcpName": "io.github.j0hanz/superfetch",
   "description": "Intelligent web content fetcher MCP server that converts HTML to clean, AI-readable Markdown",
   "type": "module",
@@ -64,15 +64,15 @@
     "@eslint/js": "^9.39.2",
     "@trivago/prettier-plugin-sort-imports": "^6.0.2",
     "@types/express": "^5.0.6",
-    "@types/node": "^22.19.5",
+    "@types/node": "^22.19.6",
     "eslint": "^9.23.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-de-morgan": "^2.0.0",
     "eslint-plugin-depend": "^1.4.0",
     "eslint-plugin-sonarjs": "^3.0.5",
     "eslint-plugin-unused-imports": "^4.3.0",
-    "knip": "^5.80.2",
-    "prettier": "^3.7.4",
+    "knip": "^5.81.0",
+    "prettier": "^3.8.0",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.53.0"