@contextvm/sdk 0.1.47 → 0.2.0

package/dist/esm/transport/nostr-server/correlation-store.js

@@ -0,0 +1,167 @@
+/**
+ * Internal correlation store for NostrServerTransport.
+ * Provides O(1) routing for responses and progress notifications.
+ *
+ * This module is not exported from the public API.
+ */
+import { DEFAULT_LRU_SIZE } from '@contextvm/sdk/core/constants.js';
+import { LruCache } from '../../core/utils/lru-cache.js';
+/**
+ * Internal store for managing request/response correlation and progress routing.
+ */
+export class CorrelationStore {
+    constructor(options = {}) {
+        const { maxEventRoutes = DEFAULT_LRU_SIZE, maxProgressTokens = DEFAULT_LRU_SIZE, onEventRouteEvicted, } = options;
+        this.eventRoutes = new LruCache(maxEventRoutes, (eventId, route) => {
+            // Clean up progress token mapping when event route is evicted
+            if (route.progressToken) {
+                this.progressTokenToEventId.delete(route.progressToken);
+            }
+            // Clean up client index when event route is evicted
+            const clientSet = this.clientEventIds.get(route.clientPubkey);
+            if (clientSet) {
+                clientSet.delete(eventId);
+                if (clientSet.size === 0) {
+                    this.clientEventIds.delete(route.clientPubkey);
+                }
+            }
+            onEventRouteEvicted === null || onEventRouteEvicted === void 0 ? void 0 : onEventRouteEvicted(eventId, route);
+        });
+        this.progressTokenToEventId = new LruCache(maxProgressTokens);
+        this.clientEventIds = new Map();
+    }
+    /**
+     * Registers a new event route for an incoming request.
+     *
+     * @param eventId The Nostr event ID (used as the request ID)
+     * @param clientPubkey The client's public key
+     * @param originalRequestId The original JSON-RPC request ID
+     * @param progressToken Optional progress token for this request
+     */
+    registerEventRoute(eventId, clientPubkey, originalRequestId, progressToken) {
+        const route = {
+            clientPubkey,
+            originalRequestId,
+            progressToken,
+        };
+        this.eventRoutes.set(eventId, route);
+        // Update client index
+        let clientSet = this.clientEventIds.get(clientPubkey);
+        if (!clientSet) {
+            clientSet = new Set();
+            this.clientEventIds.set(clientPubkey, clientSet);
+        }
+        clientSet.add(eventId);
+        if (progressToken) {
+            this.progressTokenToEventId.set(progressToken, eventId);
+        }
+    }
+    /**
+     * Gets the route for a given event ID.
+     *
+     * @param eventId The Nostr event ID
+     * @returns The event route, or undefined if not found
+     */
+    getEventRoute(eventId) {
+        return this.eventRoutes.get(eventId);
+    }
+    /**
+     * Gets the event ID for a given progress token.
+     *
+     * @param progressToken The progress token
+     * @returns The event ID, or undefined if not found
+     */
+    getEventIdByProgressToken(progressToken) {
+        return this.progressTokenToEventId.get(progressToken);
+    }
+    /**
+     * Removes an event route and its associated progress token mapping.
+     *
+     * @param eventId The Nostr event ID
+     * @returns true if the route was found and removed, false otherwise
+     */
+    removeEventRoute(eventId) {
+        const route = this.eventRoutes.get(eventId);
+        if (!route) {
+            return false;
+        }
+        // Remove progress token mapping if it exists
+        if (route.progressToken) {
+            this.progressTokenToEventId.delete(route.progressToken);
+        }
+        // Remove from client index
+        const clientSet = this.clientEventIds.get(route.clientPubkey);
+        if (clientSet) {
+            clientSet.delete(eventId);
+            if (clientSet.size === 0) {
+                this.clientEventIds.delete(route.clientPubkey);
+            }
+        }
+        // Remove the event route
+        this.eventRoutes.delete(eventId);
+        return true;
+    }
+    /**
+     * Removes all event routes for a specific client.
+     * This is called when a session is evicted or closed.
+     *
+     * @param clientPubkey The client's public key
+     * @returns The number of routes removed
+     */
+    removeRoutesForClient(clientPubkey) {
+        let removed = 0;
+        // Get the set of event IDs for this client (O(1) lookup)
+        const eventIds = this.clientEventIds.get(clientPubkey);
+        if (!eventIds) {
+            return 0;
+        }
+        // Remove each event route (O(k) where k is the number of active requests for this client)
+        const toRemove = Array.from(eventIds);
+        for (const eventId of toRemove) {
+            if (this.removeEventRoute(eventId)) {
+                removed++;
+            }
+        }
+        // The client index should now be empty, but ensure it's cleaned up
+        this.clientEventIds.delete(clientPubkey);
+        return removed;
+    }
+    /**
+     * Checks if an event route exists.
+     *
+     * @param eventId The Nostr event ID
+     * @returns true if the route exists, false otherwise
+     */
+    hasEventRoute(eventId) {
+        return this.eventRoutes.has(eventId);
+    }
+    /**
+     * Checks if a progress token mapping exists.
+     *
+     * @param progressToken The progress token
+     * @returns true if the mapping exists, false otherwise
+     */
+    hasProgressToken(progressToken) {
+        return this.progressTokenToEventId.has(progressToken);
+    }
+    /**
+     * Gets the current number of event routes.
+     */
+    get eventRouteCount() {
+        return this.eventRoutes.size;
+    }
+    /**
+     * Gets the current number of progress token mappings.
+     */
+    get progressTokenCount() {
+        return this.progressTokenToEventId.size;
+    }
+    /**
+     * Clears all event routes and progress token mappings.
+     */
+    clear() {
+        this.eventRoutes.clear();
+        this.progressTokenToEventId.clear();
+    }
+}
+//# sourceMappingURL=correlation-store.js.map

package/dist/esm/transport/nostr-server/correlation-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-store.js","sourceRoot":"","sources":["../../../../src/transport/nostr-server/correlation-store.ts"],"names":[],"mappings":"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"}

package/dist/esm/transport/nostr-server/session-store.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Internal session store for NostrServerTransport.
+ * Manages client sessions with LRU eviction.
+ *
+ * This module is not exported from the public API.
+ */
+/**
+ * Represents a connected client session.
+ * Simplified from the original design - correlation data is now
+ * managed separately by CorrelationStore.
+ */
+export interface ClientSession {
+    /** Whether the client has completed the initialize handshake */
+    isInitialized: boolean;
+    /** Whether this session uses encryption */
+    isEncrypted: boolean;
+    /** Timestamp of the last activity from this client */
+    lastActivity: number;
+}
+/**
+ * Options for configuring the SessionStore.
+ */
+export interface SessionStoreOptions {
+    /** Maximum number of sessions to keep in memory */
+    maxSessions?: number;
+    /** Callback invoked when a session is evicted */
+    onSessionEvicted?: (clientPubkey: string, session: ClientSession) => void;
+}
+/**
+ * Internal store for managing client sessions.
+ *
+ * This class maintains an LRU cache of client sessions, automatically
+ * evicting the least recently used sessions when the capacity is reached.
+ *
+ * Session data is kept minimal - correlation data (request IDs, progress tokens)
+ * is managed separately by CorrelationStore for better separation of concerns.
+ */
+export declare class SessionStore {
+    private readonly sessions;
+    constructor(options?: SessionStoreOptions);
+    /**
+     * Gets or creates a session for a client.
+     *
+     * @param clientPubkey The client's public key
+     * @param isEncrypted Whether the session uses encryption
+     * @returns The client session
+     */
+    getOrCreateSession(clientPubkey: string, isEncrypted: boolean): ClientSession;
+    /**
+     * Gets a session for a client without creating one if it doesn't exist.
+     *
+     * @param clientPubkey The client's public key
+     * @returns The client session, or undefined if not found
+     */
+    getSession(clientPubkey: string): ClientSession | undefined;
+    /**
+     * Updates the last activity timestamp for a session.
+     *
+     * @param clientPubkey The client's public key
+     * @returns true if the session was found and updated, false otherwise
+     */
+    updateActivity(clientPubkey: string): boolean;
+    /**
+     * Marks a session as initialized.
+     *
+     * @param clientPubkey The client's public key
+     * @returns true if the session was found and updated, false otherwise
+     */
+    markInitialized(clientPubkey: string): boolean;
+    /**
+     * Checks if a session exists.
+     *
+     * @param clientPubkey The client's public key
+     * @returns true if the session exists, false otherwise
+     */
+    hasSession(clientPubkey: string): boolean;
+    /**
+     * Removes a session.
+     *
+     * @param clientPubkey The client's public key
+     * @returns true if the session was found and removed, false otherwise
+     */
+    removeSession(clientPubkey: string): boolean;
+    /**
+     * Gets all sessions.
+     *
+     * @returns An iterable of [clientPubkey, session] tuples
+     */
+    getAllSessions(): IterableIterator<[string, ClientSession]>;
+    /**
+     * Gets the number of active sessions.
+     */
+    get sessionCount(): number;
+    /**
+     * Clears all sessions.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=session-store.d.ts.map

package/dist/esm/transport/nostr-server/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../../src/transport/nostr-server/session-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,aAAa,EAAE,OAAO,CAAC;IACvB,2CAA2C;IAC3C,WAAW,EAAE,OAAO,CAAC;IACrB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;CAC3E;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;gBAEvC,OAAO,GAAE,mBAAwB;IAW7C;;;;;;OAMG;IACH,kBAAkB,CAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,OAAO,GACnB,aAAa;IAkBhB;;;;;OAKG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI3D;;;;;OAKG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAS7C;;;;;OAKG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAS9C;;;;;OAKG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;OAKG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAI5C;;;;OAIG;IACH,cAAc,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAI3D;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/esm/transport/nostr-server/session-store.js

@@ -0,0 +1,123 @@
+/**
+ * Internal session store for NostrServerTransport.
+ * Manages client sessions with LRU eviction.
+ *
+ * This module is not exported from the public API.
+ */
+import { DEFAULT_LRU_SIZE } from '@contextvm/sdk/core/constants.js';
+import { LruCache } from '../../core/utils/lru-cache.js';
+/**
+ * Internal store for managing client sessions.
+ *
+ * This class maintains an LRU cache of client sessions, automatically
+ * evicting the least recently used sessions when the capacity is reached.
+ *
+ * Session data is kept minimal - correlation data (request IDs, progress tokens)
+ * is managed separately by CorrelationStore for better separation of concerns.
+ */
+export class SessionStore {
+    constructor(options = {}) {
+        const { maxSessions = DEFAULT_LRU_SIZE, onSessionEvicted } = options;
+        this.sessions = new LruCache(maxSessions, (clientPubkey, session) => {
+            onSessionEvicted === null || onSessionEvicted === void 0 ? void 0 : onSessionEvicted(clientPubkey, session);
+        });
+    }
+    /**
+     * Gets or creates a session for a client.
+     *
+     * @param clientPubkey The client's public key
+     * @param isEncrypted Whether the session uses encryption
+     * @returns The client session
+     */
+    getOrCreateSession(clientPubkey, isEncrypted) {
+        const existing = this.sessions.get(clientPubkey);
+        if (existing) {
+            // Update encryption mode in case it changed
+            existing.isEncrypted = isEncrypted;
+            return existing;
+        }
+        const newSession = {
+            isInitialized: false,
+            isEncrypted,
+            lastActivity: Date.now(),
+        };
+        this.sessions.set(clientPubkey, newSession);
+        return newSession;
+    }
+    /**
+     * Gets a session for a client without creating one if it doesn't exist.
+     *
+     * @param clientPubkey The client's public key
+     * @returns The client session, or undefined if not found
+     */
+    getSession(clientPubkey) {
+        return this.sessions.get(clientPubkey);
+    }
+    /**
+     * Updates the last activity timestamp for a session.
+     *
+     * @param clientPubkey The client's public key
+     * @returns true if the session was found and updated, false otherwise
+     */
+    updateActivity(clientPubkey) {
+        const session = this.sessions.get(clientPubkey);
+        if (session) {
+            session.lastActivity = Date.now();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Marks a session as initialized.
+     *
+     * @param clientPubkey The client's public key
+     * @returns true if the session was found and updated, false otherwise
+     */
+    markInitialized(clientPubkey) {
+        const session = this.sessions.get(clientPubkey);
+        if (session) {
+            session.isInitialized = true;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Checks if a session exists.
+     *
+     * @param clientPubkey The client's public key
+     * @returns true if the session exists, false otherwise
+     */
+    hasSession(clientPubkey) {
+        return this.sessions.has(clientPubkey);
+    }
+    /**
+     * Removes a session.
+     *
+     * @param clientPubkey The client's public key
+     * @returns true if the session was found and removed, false otherwise
+     */
+    removeSession(clientPubkey) {
+        return this.sessions.delete(clientPubkey);
+    }
+    /**
+     * Gets all sessions.
+     *
+     * @returns An iterable of [clientPubkey, session] tuples
+     */
+    getAllSessions() {
+        return this.sessions.entries();
+    }
+    /**
+     * Gets the number of active sessions.
+     */
+    get sessionCount() {
+        return this.sessions.size;
+    }
+    /**
+     * Clears all sessions.
+     */
+    clear() {
+        this.sessions.clear();
+    }
+}
+//# sourceMappingURL=session-store.js.map

package/dist/esm/transport/nostr-server/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../../../src/transport/nostr-server/session-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AA0BzD;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IAGvB,YAAY,UAA+B,EAAE;QAC3C,MAAM,EAAE,WAAW,GAAG,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;QAErE,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAC1B,WAAW,EACX,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE;YACxB,gBAAgB,aAAhB,gBAAgB,uBAAhB,gBAAgB,CAAG,YAAY,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,kBAAkB,CAChB,YAAoB,EACpB,WAAoB;QAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,4CAA4C;YAC5C,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;YACnC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAkB;YAChC,aAAa,EAAE,KAAK;YACpB,WAAW;YACX,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;SACzB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,YAAoB;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,YAAoB;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,YAAoB;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,YAAoB;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,YAAoB;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/esm/transport/nostr-server-transport.d.ts

@@ -3,16 +3,10 @@ import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import { BaseNostrTransport, BaseNostrTransportOptions } from './base-nostr-transport.js';
 import { NostrEvent } from 'nostr-tools';
 import { LogLevel } from '../core/utils/logger.js';
-/**
- * Represents a capability exclusion pattern that can bypass whitelisting.
- * Can be either a method-only pattern (e.g., 'tools/list') or a method + name pattern (e.g., 'tools/call, get_weather').
- */
-export interface CapabilityExclusion {
-    /** The JSON-RPC method to exclude from whitelisting (e.g., 'tools/call', 'tools/list') */
-    method: string;
-    /** Optional capability name to specifically exclude (e.g., 'get_weather') */
-    name?: string;
-}
+import { CorrelationStore } from './nostr-server/correlation-store.js';
+import { SessionStore } from './nostr-server/session-store.js';
+import { CapabilityExclusion } from './nostr-server/authorization-policy.js';
+import { ServerInfo } from './nostr-server/announcement-manager.js';
 /**
  * Options for configuring the NostrServerTransport.
  */
@@ -30,15 +24,6 @@ export interface NostrServerTransportOptions extends BaseNostrTransportOptions {
      */
     injectClientPubkey?: boolean;
 }
-/**
- * Information about a server.
- */
-export interface ServerInfo {
-    name?: string;
-    picture?: string;
-    website?: string;
-    about?: string;
-}
 /**
  * A server-side transport layer for CTXVM that uses Nostr events for communication.
  * This transport listens for incoming MCP requests via Nostr events and can send
@@ -49,24 +34,12 @@ export declare class NostrServerTransport extends BaseNostrTransport implements
     onmessage?: (message: JSONRPCMessage) => void;
     onclose?: () => void;
     onerror?: (error: Error) => void;
-    private readonly clientSessions;
-    private readonly eventIdToClient;
-    private readonly maxSessions;
-    private readonly isPublicServer?;
-    private readonly allowedPublicKeys?;
-    private readonly excludedCapabilities?;
-    private readonly serverInfo?;
+    private readonly sessionStore;
+    private readonly correlationStore;
+    private readonly authorizationPolicy;
+    private readonly announcementManager;
     private readonly injectClientPubkey;
-    private isInitialized;
-    private initializationPromise?;
-    private initializationResolver?;
-    private cachedCommonTags?;
     constructor(options: NostrServerTransportOptions);
-    /**
-     * Generates common tags from server information for use in Nostr events.
-     * @returns Array of tag arrays for Nostr events.
-     */
-    private generateCommonTags;
     /**
      * Starts the transport, connecting to the relay and setting up event listeners
      * to receive incoming MCP requests.
@@ -89,42 +62,23 @@ export declare class NostrServerTransport extends BaseNostrTransport implements
      * @returns Promise that resolves to an array of deletion events that were published.
      */
     deleteAnnouncement(reason?: string): Promise<NostrEvent[]>;
-    /**
-     * Initiates the process of fetching announcement data from the server's internal logic.
-     * This method now properly handles the initialization handshake by first sending
-     * the initialize request, waiting for the response, and then proceeding with other announcements.
-     */
-    private getAnnouncementData;
-    /**
-     * Waits for the server to be initialized with a timeout.
-     * @returns Promise that resolves when initialized or after 10-second timeout.
-     * The method will always resolve, allowing announcements to proceed.
-     */
-    private waitForInitialization;
-    /**
-     * Handles the JSON-RPC responses for public server announcements and publishes
-     * them as Nostr events to the configured relays.
-     * @param message The JSON-RPC response containing the announcement data.
-     */
-    private announcer;
     /**
      * Gets or creates a client session with proper initialization.
      * @param clientPubkey The client's public key.
-     * @param now Current timestamp.
      * @param isEncrypted Whether the session uses encryption.
      * @returns The client session.
      */
     private getOrCreateClientSession;
     /**
      * Handles incoming requests with correlation tracking.
-     * @param session The client session.
      * @param eventId The Nostr event ID.
      * @param request The request message.
+     * @param clientPubkey The client's public key.
      */
     private handleIncomingRequest;
     /**
      * Handles incoming notifications.
-     * @param session The client session.
+     * @param clientPubkey The client's public key.
      * @param notification The notification message.
      */
     private handleIncomingNotification;
@@ -162,13 +116,6 @@ export declare class NostrServerTransport extends BaseNostrTransport implements
      * @param event The incoming Nostr event.
      */
     private handleUnencryptedEvent;
-    /**
-     * Checks if a capability is excluded from whitelisting requirements.
-     * @param method The JSON-RPC method (e.g., 'tools/call', 'tools/list')
-     * @param name Optional capability name for method-specific exclusions (e.g., 'get_weather')
-     * @returns true if the capability should bypass whitelisting, false otherwise
-     */
-    private isCapabilityExcluded;
     /**
      * Authorizes and processes an incoming Nostr event, handling message validation,
      * client authorization, session management, and optional client public key injection.
@@ -176,5 +123,13 @@ export declare class NostrServerTransport extends BaseNostrTransport implements
      * @param isEncrypted Whether the original event was encrypted.
      */
     private authorizeAndProcessEvent;
+    /**
+     * Test-only accessor for internal state.
+     * @internal
+     */
+    getInternalStateForTesting(): {
+        sessionStore: SessionStore;
+        correlationStore: CorrelationStore;
+    };
 }
 //# sourceMappingURL=nostr-server-transport.d.ts.map

package/dist/esm/transport/nostr-server-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nostr-server-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/nostr-server-transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nostr-server-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/nostr-server-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,cAAc,EAMpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AASnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAiB,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAEL,mBAAmB,EACpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAEL,UAAU,EACX,MAAM,wCAAwC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,yBAAyB;IAC5E,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,uFAAuF;IACvF,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC7C,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;GAKG;AACH,qBAAa,oBACX,SAAQ,kBACR,YAAW,SAAS;IAEb,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAExC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;gBAEjC,OAAO,EAAE,2BAA2B;IAmDhD;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCnC;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBnC;;;OAGG;IACU,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD;;;;;;OAMG;IACU,kBAAkB,CAC7B,MAAM,GAAE,MAA0B,GACjC,OAAO,CAAC,UAAU,EAAE,CAAC;IAIxB;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAYlC;;;OAGG;YACW,cAAc;IA+D5B;;;OAGG;YACW,kBAAkB;IAiEhC;;;;;OAKG;IACU,gBAAgB,CAC3B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,cAAc,EAC5B,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC;IAqBhB;;;;;OAKG;YACW,oBAAoB;IAkBlC;;;OAGG;YACW,oBAAoB;IA8BlC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IA4FhC;;;OAGG;IACH,0BAA0B;;;;CAM3B"}