@contextvm/sdk 0.1.47 → 0.2.0

package/dist/esm/transport/base-nostr-transport.js

@@ -1,8 +1,10 @@
 import { EncryptionMode, } from '../core/interfaces.js';
 import { CTXVM_MESSAGES_KIND, GIFT_WRAP_KIND, mcpToNostrEvent, NOSTR_TAGS, nostrEventToMcpMessage, encryptMessage, SERVER_ANNOUNCEMENT_KIND, TOOLS_LIST_KIND, RESOURCES_LIST_KIND, RESOURCETEMPLATES_LIST_KIND, PROMPTS_LIST_KIND, } from '../core/index.js';
-import { validateMessage } from '../core/utils/utils.js';
+import { validateMessage, withTimeout } from '../core/utils/utils.js';
 import { createLogger, } from '../core/utils/logger.js';
 import { TaskQueue } from '../core/utils/task-queue.js';
+// Default timeout for network operations (30 seconds)
+const DEFAULT_TIMEOUT_MS = 30000;
 /**
  * Base class for Nostr-based transports that provides common functionality
  * for managing Nostr connections, event conversion, and message handling.
@@ -26,7 +28,7 @@ export class BaseNostrTransport {
             return;
         }
         try {
-            await this.relayHandler.connect();
+            await withTimeout(this.relayHandler.connect(), DEFAULT_TIMEOUT_MS, 'Connection to Nostr relay network timed out');
             this.isConnected = true;
             this.logger.info('Connected to Nostr relays', (_c = (_b = (_a = this.relayHandler).getRelayUrls) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : '');
         }
@@ -42,7 +44,7 @@ export class BaseNostrTransport {
             return;
         }
         try {
-            await this.relayHandler.disconnect();
+            await withTimeout(this.relayHandler.disconnect(), DEFAULT_TIMEOUT_MS, 'Disconnection from Nostr relay network timed out');
             this.isConnected = false;
             this.logger.info('Disconnected from Nostr relay network');
         }
@@ -55,7 +57,7 @@ export class BaseNostrTransport {
      */
     async getPublicKey() {
         try {
-            return await this.signer.getPublicKey();
+            return await withTimeout(this.signer.getPublicKey(), DEFAULT_TIMEOUT_MS, 'Get public key timed out');
         }
         catch (error) {
             this.logAndRethrowError('Failed to get public key from signer', error);
@@ -131,7 +133,7 @@ export class BaseNostrTransport {
         try {
             const pubkey = await this.getPublicKey();
             const unsignedEvent = mcpToNostrEvent(message, pubkey, kind, tags);
-            return await this.signer.signEvent(unsignedEvent);
+            return await withTimeout(this.signer.signEvent(unsignedEvent), DEFAULT_TIMEOUT_MS, 'Sign event timed out');
         }
         catch (error) {
             this.logAndRethrowError('Failed to create signed Nostr event', error, {
@@ -145,7 +147,7 @@ export class BaseNostrTransport {
      */
     async publishEvent(event) {
         try {
-            await this.relayHandler.publish(event);
+            await withTimeout(this.relayHandler.publish(event), DEFAULT_TIMEOUT_MS, 'Publish event timed out');
             this.logger.debug('Published Nostr event', {
                 eventId: event.id,
                 kind: event.kind,

package/dist/esm/transport/base-nostr-transport.js.map

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

package/dist/esm/transport/nostr-client/correlation-store.d.ts

@@ -0,0 +1,60 @@
+import type { JSONRPCResponse } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Represents a pending request waiting for a response from the server.
+ * Tracks the original request ID for response correlation and whether
+ * this is an initialize request.
+ */
+export interface PendingRequest {
+    /** The original JSON-RPC request ID to restore in the response */
+    originalRequestId: string | number | null;
+    /** Whether this request is the initialize handshake */
+    isInitialize: boolean;
+}
+/**
+ * Configuration options for the ClientCorrelationStore.
+ */
+export interface ClientCorrelationStoreOptions {
+    /** Maximum number of pending requests to track (default: 1000) */
+    maxPendingRequests?: number;
+    /** Callback invoked when a request is evicted from the cache */
+    onRequestEvicted?: (eventId: string, request: PendingRequest) => void;
+}
+/**
+ * Manages correlation tracking for client-side request/response pairs.
+ * Uses an LRU cache to prevent memory leaks from abandoned requests.
+ */
+export declare class ClientCorrelationStore {
+    private readonly pendingRequests;
+    constructor(options?: ClientCorrelationStoreOptions);
+    /**
+     * Registers a pending request for correlation tracking.
+     * @param eventId - The Nostr event ID used as the correlation key
+     * @param request - The pending request information
+     */
+    registerRequest(eventId: string, request: PendingRequest): void;
+    /**
+     * Resolves a response by finding and removing the corresponding request.
+     * Restores the original request ID in the response before resolving.
+     * @param eventId - The Nostr event ID of the response
+     * @param response - The JSON-RPC response to resolve
+     * @returns true if the request was found and resolved, false otherwise
+     */
+    resolveResponse(eventId: string, response: JSONRPCResponse): boolean;
+    /**
+     * Checks if a pending request exists for the given event ID.
+     * @param eventId - The Nostr event ID to check
+     * @returns true if a request exists, false otherwise
+     */
+    hasPendingRequest(eventId: string): boolean;
+    /**
+     * Removes a pending request without resolving it.
+     * @param eventId - The Nostr event ID of the request to remove
+     * @returns true if the request was found and removed, false otherwise
+     */
+    removePendingRequest(eventId: string): boolean;
+    /** Gets the current number of pending requests */
+    get pendingRequestCount(): number;
+    /** Clears all pending requests from the store */
+    clear(): void;
+}
+//# sourceMappingURL=correlation-store.d.ts.map

package/dist/esm/transport/nostr-client/correlation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-store.d.ts","sourceRoot":"","sources":["../../../../src/transport/nostr-client/correlation-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAG1E;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,uDAAuD;IACvD,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CACvE;AAED;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2B;gBAE/C,OAAO,GAAE,6BAAkC;IAQvD;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAI/D;;;;;;OAMG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO;IAUpE;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI3C;;;;OAIG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI9C,kDAAkD;IAClD,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAED,iDAAiD;IACjD,KAAK,IAAI,IAAI;CAGd"}

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

@@ -0,0 +1,61 @@
+import { LruCache } from '../../core/utils/lru-cache.js';
+/**
+ * Manages correlation tracking for client-side request/response pairs.
+ * Uses an LRU cache to prevent memory leaks from abandoned requests.
+ */
+export class ClientCorrelationStore {
+    constructor(options = {}) {
+        const { maxPendingRequests = 1000, onRequestEvicted } = options;
+        this.pendingRequests = new LruCache(maxPendingRequests, onRequestEvicted);
+    }
+    /**
+     * Registers a pending request for correlation tracking.
+     * @param eventId - The Nostr event ID used as the correlation key
+     * @param request - The pending request information
+     */
+    registerRequest(eventId, request) {
+        this.pendingRequests.set(eventId, request);
+    }
+    /**
+     * Resolves a response by finding and removing the corresponding request.
+     * Restores the original request ID in the response before resolving.
+     * @param eventId - The Nostr event ID of the response
+     * @param response - The JSON-RPC response to resolve
+     * @returns true if the request was found and resolved, false otherwise
+     */
+    resolveResponse(eventId, response) {
+        const request = this.pendingRequests.get(eventId);
+        if (!request)
+            return false;
+        if (request.originalRequestId !== null) {
+            response.id = request.originalRequestId;
+        }
+        this.pendingRequests.delete(eventId);
+        return true;
+    }
+    /**
+     * Checks if a pending request exists for the given event ID.
+     * @param eventId - The Nostr event ID to check
+     * @returns true if a request exists, false otherwise
+     */
+    hasPendingRequest(eventId) {
+        return this.pendingRequests.has(eventId);
+    }
+    /**
+     * Removes a pending request without resolving it.
+     * @param eventId - The Nostr event ID of the request to remove
+     * @returns true if the request was found and removed, false otherwise
+     */
+    removePendingRequest(eventId) {
+        return this.pendingRequests.delete(eventId);
+    }
+    /** Gets the current number of pending requests */
+    get pendingRequestCount() {
+        return this.pendingRequests.size;
+    }
+    /** Clears all pending requests from the store */
+    clear() {
+        this.pendingRequests.clear();
+    }
+}
+//# sourceMappingURL=correlation-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-store.js","sourceRoot":"","sources":["../../../../src/transport/nostr-client/correlation-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAwBzD;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IAGjC,YAAY,UAAyC,EAAE;QACrD,MAAM,EAAE,kBAAkB,GAAG,IAAI,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;QAChE,IAAI,CAAC,eAAe,GAAG,IAAI,QAAQ,CACjC,kBAAkB,EAClB,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,OAAe,EAAE,OAAuB;QACtD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,eAAe,CAAC,OAAe,EAAE,QAAyB;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,OAAO,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;YACvC,QAAQ,CAAC,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,OAAe;QAC/B,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,oBAAoB,CAAC,OAAe;QAClC,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,kDAAkD;IAClD,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;IACnC,CAAC;IAED,iDAAiD;IACjD,KAAK;QACH,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/esm/transport/nostr-client/stateless-mode-handler.d.ts

@@ -0,0 +1,24 @@
+import type { JSONRPCMessage, JSONRPCResultResponse } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Manages stateless mode emulation for public Nostr servers.
+ * Provides emulated initialize responses for clients that cannot
+ * maintain persistent connections to the server.
+ */
+export declare class StatelessModeHandler {
+    /**
+     * Creates an emulated initialize response for stateless clients.
+     * This response mimics what a real server would return during initialization,
+     * allowing stateless clients to function without maintaining a connection.
+     * @param requestId - The original request ID to include in the response
+     * @returns A JSON-RPC result response with emulated server capabilities
+     */
+    createEmulatedResponse(requestId: string | number): JSONRPCResultResponse;
+    /**
+     * Checks if a message should be handled in stateless mode.
+     * Stateless mode handles special messages that don't require server interaction.
+     * @param message - The JSON-RPC message to check
+     * @returns true if the message should be handled statelessly
+     */
+    shouldHandleStatelessly(message: JSONRPCMessage): boolean;
+}
+//# sourceMappingURL=stateless-mode-handler.d.ts.map

package/dist/esm/transport/nostr-client/stateless-mode-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateless-mode-handler.d.ts","sourceRoot":"","sources":["../../../../src/transport/nostr-client/stateless-mode-handler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EAEd,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAG5C;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B;;;;;;OAMG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,qBAAqB;IA4BzE;;;;;OAKG;IACH,uBAAuB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;CAgB1D"}

package/dist/esm/transport/nostr-client/stateless-mode-handler.js

@@ -0,0 +1,61 @@
+import { INITIALIZE_METHOD, NOTIFICATIONS_INITIALIZED_METHOD, } from '@contextvm/sdk/core/constants.js';
+import { LATEST_PROTOCOL_VERSION } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Manages stateless mode emulation for public Nostr servers.
+ * Provides emulated initialize responses for clients that cannot
+ * maintain persistent connections to the server.
+ */
+export class StatelessModeHandler {
+    /**
+     * Creates an emulated initialize response for stateless clients.
+     * This response mimics what a real server would return during initialization,
+     * allowing stateless clients to function without maintaining a connection.
+     * @param requestId - The original request ID to include in the response
+     * @returns A JSON-RPC result response with emulated server capabilities
+     */
+    createEmulatedResponse(requestId) {
+        const emulatedResult = {
+            protocolVersion: LATEST_PROTOCOL_VERSION,
+            serverInfo: {
+                name: 'Emulated-Stateless-Server',
+                version: '1.0.0',
+            },
+            capabilities: {
+                tools: {
+                    listChanged: true,
+                },
+                prompts: {
+                    listChanged: true,
+                },
+                resources: {
+                    subscribe: true,
+                    listChanged: true,
+                },
+            },
+        };
+        return {
+            jsonrpc: '2.0',
+            id: requestId,
+            result: emulatedResult,
+        };
+    }
+    /**
+     * Checks if a message should be handled in stateless mode.
+     * Stateless mode handles special messages that don't require server interaction.
+     * @param message - The JSON-RPC message to check
+     * @returns true if the message should be handled statelessly
+     */
+    shouldHandleStatelessly(message) {
+        if ('method' in message &&
+            message.method === INITIALIZE_METHOD &&
+            'id' in message) {
+            return true;
+        }
+        if ('method' in message &&
+            message.method === NOTIFICATIONS_INITIALIZED_METHOD) {
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=stateless-mode-handler.js.map

package/dist/esm/transport/nostr-client/stateless-mode-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateless-mode-handler.js","sourceRoot":"","sources":["../../../../src/transport/nostr-client/stateless-mode-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,kCAAkC,CAAC;AAM1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;;;;;OAMG;IACH,sBAAsB,CAAC,SAA0B;QAC/C,MAAM,cAAc,GAAqB;YACvC,eAAe,EAAE,uBAAuB;YACxC,UAAU,EAAE;gBACV,IAAI,EAAE,2BAA2B;gBACjC,OAAO,EAAE,OAAO;aACjB;YACD,YAAY,EAAE;gBACZ,KAAK,EAAE;oBACL,WAAW,EAAE,IAAI;iBAClB;gBACD,OAAO,EAAE;oBACP,WAAW,EAAE,IAAI;iBAClB;gBACD,SAAS,EAAE;oBACT,SAAS,EAAE,IAAI;oBACf,WAAW,EAAE,IAAI;iBAClB;aACF;SACF,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,SAAS;YACb,MAAM,EAAE,cAAc;SACvB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,uBAAuB,CAAC,OAAuB;QAC7C,IACE,QAAQ,IAAI,OAAO;YACnB,OAAO,CAAC,MAAM,KAAK,iBAAiB;YACpC,IAAI,IAAI,OAAO,EACf,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IACE,QAAQ,IAAI,OAAO;YACnB,OAAO,CAAC,MAAM,KAAK,gCAAgC,EACnD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

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

@@ -3,75 +3,99 @@ 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';
+import { ClientCorrelationStore } from './nostr-client/correlation-store.js';
+import { StatelessModeHandler } from './nostr-client/stateless-mode-handler.js';
 /**
  * Options for configuring the NostrClientTransport.
  */
 export interface NostrTransportOptions extends BaseNostrTransportOptions {
+    /** The server's public key for targeting messages */
     serverPubkey: string;
+    /** Whether to operate in stateless mode (emulates server responses) */
     isStateless?: boolean;
+    /** Log level for the transport */
     logLevel?: LogLevel;
 }
 /**
- * A transport layer for CTXVM that uses Nostr events for communication.
- * It implements the Transport interface from the @modelcontextprotocol/sdk.
+ * A client transport layer for CTXVM that uses Nostr events for communication.
+ * Implements the Transport interface from the @modelcontextprotocol/sdk.
+ * Handles request/response correlation and optional stateless mode emulation.
  */
 export declare class NostrClientTransport extends BaseNostrTransport implements Transport {
+    /** Public event handlers required by the Transport interface */
     onmessage?: (message: JSONRPCMessage) => void;
     onclose?: () => void;
     onerror?: (error: Error) => void;
+    /** The server's public key for message targeting */
     private readonly serverPubkey;
-    private readonly pendingRequestIds;
-    private readonly maxPendingRequests;
-    private serverInitializeEvent;
+    /** Manages request/response correlation for pending requests */
+    private readonly correlationStore;
+    /** Handles stateless mode emulation for public servers */
+    private readonly statelessHandler;
+    /** Whether stateless mode is enabled */
     private readonly isStateless;
+    /** The server's initialize event, if received */
+    private serverInitializeEvent;
+    /**
+     * Creates a new NostrClientTransport instance.
+     * @param options - Configuration options for the transport
+     * @throws Error if serverPubkey is not a valid hex public key
+     */
     constructor(options: NostrTransportOptions);
     /**
      * Starts the transport, connecting to the relay and setting up event listeners.
      */
     start(): Promise<void>;
     /**
-     * Closes the transport, disconnecting from the relay.
+     * Closes the transport, disconnecting from the relay and clearing state.
      */
     close(): Promise<void>;
     /**
      * Sends a JSON-RPC message over the Nostr transport.
-     * @param message The JSON-RPC request or response to send.
+     * Handles stateless mode emulation for initialize requests.
+     * @param message - The JSON-RPC request or notification to send
      */
     send(message: JSONRPCMessage): Promise<void>;
     /**
-     * Emulates the server's initialize response for stateless clients.
-     * This method constructs a generic server response and injects it back into the client,
-     * allowing the client to self-initialize without a network roundtrip.
-     * @param requestId The ID of the original initialize request.
+     * Sends a request and registers it for correlation tracking.
+     * @param message - The JSON-RPC message to send
+     * @returns The ID of the published Nostr event
      */
-    private emulateInitializeResponse;
+    private sendRequest;
     /**
-     * Internal method to send a JSON-RPC message and get the resulting event ID.
-     * Registers the event ID before publishing to avoid race conditions in multi-relay setups
-     * where responses may arrive before the publish operation completes.
-     *
-     * @param message The JSON-RPC message to send.
-     * @returns The ID of the published Nostr event.
+     * Emulates the server's initialize response for stateless clients.
+     * @param requestId - The ID of the original initialize request
      */
-    private _sendInternal;
+    private emulateInitializeResponse;
     /**
      * Processes incoming Nostr events, routing them to the correct handler.
+     * @param event - The incoming Nostr event
      */
     private processIncomingEvent;
     /**
-     * Get the server initialize event
+     * Gets the server's initialize event if received.
+     * @returns The server initialize event or undefined
      */
     getServerInitializeEvent(): NostrEvent | undefined;
     /**
      * Handles response messages by correlating them with pending requests.
-     * @param correlatedEventId The event ID from the 'e' tag.
-     * @param mcpMessage The incoming MCP message.
+     * @param correlatedEventId - The Nostr event ID used for correlation
+     * @param mcpMessage - The JSON-RPC response message
      */
     private handleResponse;
     /**
-     * Handles notification messages.
-     * @param mcpMessage The incoming MCP message.
+     * Handles notification messages by validating and forwarding them.
+     * @param mcpMessage - The JSON-RPC notification message
      */
     private handleNotification;
+    /**
+     * Test-only accessor for internal state.
+     * @internal
+     */
+    getInternalStateForTesting(): {
+        correlationStore: ClientCorrelationStore;
+        statelessHandler: StatelessModeHandler;
+        serverInitializeEvent: import("nostr-tools").Event | undefined;
+    };
 }
 //# sourceMappingURL=nostr-client-transport.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"nostr-client-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/nostr-client-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAKpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAM/E,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,yBAAyB;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,oBACX,SAAQ,kBACR,YAAW,SAAS;IAGb,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;IAGxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAQ;IAC3C,OAAO,CAAC,qBAAqB,CAAyB;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;gBAE1B,OAAO,EAAE,qBAAqB;IAkB1C;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCnC;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAcnC;;;OAGG;IACU,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCzD;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAsDjC;;;;;;;OAOG;YACW,aAAa;IA0B3B;;OAEG;YACW,oBAAoB;IAwGlC;;OAEG;IACI,wBAAwB,IAAI,UAAU,GAAG,SAAS;IAIzD;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAiBtB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAuB3B"}
+{"version":3,"file":"nostr-client-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/nostr-client-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAIpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAQ/E,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAGhF;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,yBAAyB;IACtE,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,oBACX,SAAQ,kBACR,YAAW,SAAS;IAEpB,gEAAgE;IACzD,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,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;IACxD,wCAAwC;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,iDAAiD;IACjD,OAAO,CAAC,qBAAqB,CAAyB;IAEtD;;;;OAIG;gBACS,OAAO,EAAE,qBAAqB;IAmB1C;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BnC;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWnC;;;;OAIG;IACU,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BzD;;;;OAIG;YACW,WAAW;IAmBzB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAmBjC;;;OAGG;YACW,oBAAoB;IAqGlC;;;OAGG;IACI,wBAAwB,IAAI,UAAU,GAAG,SAAS;IAIzD;;;;OAIG;IACH,OAAO,CAAC,cAAc;IA2BtB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;;OAGG;IACH,0BAA0B;;;;;CAO3B"}