@contextvm/sdk 0.1.1 → 0.1.3

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

@@ -0,0 +1,67 @@
+import type { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+import type { Filter, NostrEvent } from 'nostr-tools';
+import { EncryptionMode, NostrSigner, RelayHandler } from '../core/interfaces.js';
+/**
+ * Base options for configuring Nostr-based transports.
+ */
+export interface BaseNostrTransportOptions {
+    signer: NostrSigner;
+    relayHandler: RelayHandler;
+    encryptionMode?: EncryptionMode;
+}
+/**
+ * Base class for Nostr-based transports that provides common functionality
+ * for managing Nostr connections, event conversion, and message handling.
+ */
+export declare abstract class BaseNostrTransport {
+    protected readonly signer: NostrSigner;
+    protected readonly relayHandler: RelayHandler;
+    protected readonly encryptionMode: EncryptionMode;
+    protected isConnected: boolean;
+    constructor(options: BaseNostrTransportOptions);
+    /**
+     * Connects to the Nostr relay network.
+     */
+    protected connect(): Promise<void>;
+    /**
+     * Disconnects from the Nostr relay network.
+     */
+    protected disconnect(): Promise<void>;
+    /**
+     * Gets the public key from the signer.
+     */
+    protected getPublicKey(): Promise<string>;
+    /**
+     * Sets up a subscription to listen for Nostr events.
+     */
+    protected subscribe(filters: Filter[], onEvent: (event: NostrEvent) => void | Promise<void>): Promise<void>;
+    /**
+     * Converts a Nostr event to an MCP message.
+     */
+    protected convertNostrEventToMcpMessage(event: NostrEvent): JSONRPCMessage;
+    /**
+     * Converts an MCP message to a Nostr event and signs it.
+     */
+    protected createSignedNostrEvent(message: JSONRPCMessage, kind: number, tags?: NostrEvent['tags']): Promise<NostrEvent>;
+    /**
+     * Publishes a signed Nostr event to the relay network.
+     */
+    protected publishEvent(event: NostrEvent): Promise<void>;
+    /**
+     * Creates and publishes a Nostr event for an MCP message.
+     */
+    protected sendMcpMessage(message: JSONRPCMessage, recipientPublicKey: string, kind: number, tags?: NostrEvent['tags'], forceEncryption?: boolean): Promise<string>;
+    /**
+     * Creates subscription filters for listening to messages targeting a specific pubkey.
+     */
+    protected createSubscriptionFilters(targetPubkey: string, additionalFilters?: Partial<Filter>): Filter[];
+    /**
+     * Creates tags for targeting a specific recipient.
+     */
+    protected createRecipientTags(recipientPubkey: string): NostrEvent['tags'];
+    /**
+     * Creates tags for responding to a specific event.
+     */
+    protected createResponseTags(recipientPubkey: string, originalEventId: string): NostrEvent['tags'];
+}
+//# sourceMappingURL=base-nostr-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-nostr-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/base-nostr-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACb,MAAM,uBAAuB,CAAC;AAe/B;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;;GAGG;AACH,8BAAsB,kBAAkB;IACtC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAC9C,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAClD,SAAS,CAAC,WAAW,UAAS;gBAElB,OAAO,EAAE,yBAAyB;IAM9C;;OAEG;cACa,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASxC;;OAEG;cACa,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3C;;OAEG;cACa,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/C;;OAEG;cACa,SAAS,CACvB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACnD,OAAO,CAAC,IAAI,CAAC;IAIhB;;OAEG;IACH,SAAS,CAAC,6BAA6B,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc;IAI1E;;OAEG;cACa,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,GACxB,OAAO,CAAC,UAAU,CAAC;IAMtB;;OAEG;cACa,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D;;OAEG;cACa,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,kBAAkB,EAAE,MAAM,EAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,EACzB,eAAe,CAAC,EAAE,OAAO,GACxB,OAAO,CAAC,MAAM,CAAC;IA0BlB;;OAEG;IACH,SAAS,CAAC,yBAAyB,CACjC,YAAY,EAAE,MAAM,EACpB,iBAAiB,GAAE,OAAO,CAAC,MAAM,CAAM,GACtC,MAAM,EAAE;IAWX;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAK1E;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAC1B,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,GACtB,UAAU,CAAC,MAAM,CAAC;CAOtB"}

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

@@ -0,0 +1,122 @@
+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';
+/**
+ * Base class for Nostr-based transports that provides common functionality
+ * for managing Nostr connections, event conversion, and message handling.
+ */
+export class BaseNostrTransport {
+    constructor(options) {
+        var _a;
+        this.isConnected = false;
+        this.signer = options.signer;
+        this.relayHandler = options.relayHandler;
+        this.encryptionMode = (_a = options.encryptionMode) !== null && _a !== void 0 ? _a : EncryptionMode.OPTIONAL;
+    }
+    /**
+     * Connects to the Nostr relay network.
+     */
+    async connect() {
+        if (this.isConnected) {
+            return;
+        }
+        await this.relayHandler.connect();
+        this.isConnected = true;
+    }
+    /**
+     * Disconnects from the Nostr relay network.
+     */
+    async disconnect() {
+        if (!this.isConnected) {
+            return;
+        }
+        this.relayHandler.unsubscribe();
+        await this.relayHandler.disconnect();
+        this.isConnected = false;
+    }
+    /**
+     * Gets the public key from the signer.
+     */
+    async getPublicKey() {
+        return await this.signer.getPublicKey();
+    }
+    /**
+     * Sets up a subscription to listen for Nostr events.
+     */
+    async subscribe(filters, onEvent) {
+        await this.relayHandler.subscribe(filters, onEvent);
+    }
+    /**
+     * Converts a Nostr event to an MCP message.
+     */
+    convertNostrEventToMcpMessage(event) {
+        return nostrEventToMcpMessage(event);
+    }
+    /**
+     * Converts an MCP message to a Nostr event and signs it.
+     */
+    async createSignedNostrEvent(message, kind, tags) {
+        const pubkey = await this.getPublicKey();
+        const unsignedEvent = mcpToNostrEvent(message, pubkey, kind, tags);
+        return await this.signer.signEvent(unsignedEvent);
+    }
+    /**
+     * Publishes a signed Nostr event to the relay network.
+     */
+    async publishEvent(event) {
+        await this.relayHandler.publish(event);
+    }
+    /**
+     * Creates and publishes a Nostr event for an MCP message.
+     */
+    async sendMcpMessage(message, recipientPublicKey, kind, tags, forceEncryption) {
+        const unencryptedKinds = [
+            SERVER_ANNOUNCEMENT_KIND,
+            TOOLS_LIST_KIND,
+            RESOURCES_LIST_KIND,
+            RESOURCETEMPLATES_LIST_KIND,
+            PROMPTS_LIST_KIND,
+        ];
+        const shouldEncrypt = (!unencryptedKinds.includes(kind) || forceEncryption) &&
+            this.encryptionMode !== EncryptionMode.DISABLED;
+        const event = await this.createSignedNostrEvent(message, kind, tags);
+        if (shouldEncrypt) {
+            const encryptedEvent = encryptMessage(JSON.stringify(event), recipientPublicKey);
+            await this.publishEvent(encryptedEvent);
+        }
+        else {
+            await this.publishEvent(event);
+        }
+        return event.id;
+    }
+    /**
+     * Creates subscription filters for listening to messages targeting a specific pubkey.
+     */
+    createSubscriptionFilters(targetPubkey, additionalFilters = {}) {
+        return [
+            {
+                '#p': [targetPubkey],
+                kinds: [CTXVM_MESSAGES_KIND, GIFT_WRAP_KIND],
+                since: Math.floor(Date.now() / 1000),
+                ...additionalFilters,
+            },
+        ];
+    }
+    /**
+     * Creates tags for targeting a specific recipient.
+     */
+    createRecipientTags(recipientPubkey) {
+        const tags = [[NOSTR_TAGS.PUBKEY, recipientPubkey]];
+        return tags;
+    }
+    /**
+     * Creates tags for responding to a specific event.
+     */
+    createResponseTags(recipientPubkey, originalEventId) {
+        const tags = [
+            [NOSTR_TAGS.PUBKEY, recipientPubkey],
+            [NOSTR_TAGS.EVENT_ID, originalEventId],
+        ];
+        return tags;
+    }
+}
+//# sourceMappingURL=base-nostr-transport.js.map

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

@@ -0,0 +1 @@
+{"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/index.d.ts

@@ -0,0 +1,4 @@
+export * from './nostr-client-transport.js';
+export * from './nostr-server-transport.js';
+export * from './base-nostr-transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC"}

package/dist/esm/transport/index.js

@@ -0,0 +1,4 @@
+export * from './nostr-client-transport.js';
+export * from './nostr-server-transport.js';
+export * from './base-nostr-transport.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC"}

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

@@ -0,0 +1,60 @@
+import { type JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { EncryptionMode, NostrSigner, RelayHandler } from '../core/interfaces.js';
+import { BaseNostrTransport } from './base-nostr-transport.js';
+/**
+ * Options for configuring the NostrClientTransport.
+ */
+export interface NostrTransportOptions {
+    signer: NostrSigner;
+    relayHandler: RelayHandler;
+    serverPubkey: string;
+    encryptionMode?: EncryptionMode;
+}
+/**
+ * A transport layer for CTXVM that uses Nostr events for communication.
+ * It implements the Transport interface from the @modelcontextprotocol/sdk.
+ */
+export declare class NostrClientTransport extends BaseNostrTransport implements Transport {
+    onmessage?: (message: JSONRPCMessage) => void;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    private readonly serverPubkey;
+    private readonly pendingRequestIds;
+    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.
+     */
+    close(): Promise<void>;
+    /**
+     * Sends a JSON-RPC message over the Nostr transport.
+     * @param message The JSON-RPC request or response to send.
+     */
+    send(message: JSONRPCMessage): Promise<void>;
+    /**
+     * Internal method to send a JSON-RPC message and get the resulting event ID.
+     * @param message The JSON-RPC message to send.
+     * @returns The ID of the published Nostr event.
+     */
+    private _sendInternal;
+    /**
+     * Processes incoming Nostr events, routing them to the correct handler.
+     */
+    private processIncomingEvent;
+    /**
+     * Handles response messages by correlating them with pending requests.
+     * @param correlatedEventId The event ID from the 'e' tag.
+     * @param mcpMessage The incoming MCP message.
+     */
+    private handleResponse;
+    /**
+     * Handles notification messages.
+     * @param mcpMessage The incoming MCP message.
+     */
+    private handleNotification;
+}
+//# sourceMappingURL=nostr-client-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nostr-client-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/nostr-client-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACb,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAI/D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;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,CAAc;gBAEpC,OAAO,EAAE,qBAAqB;IAM1C;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC;;;OAGG;IACU,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzD;;;;OAIG;YACW,aAAa;IAW3B;;OAEG;YACW,oBAAoB;IAgClC;;;;OAIG;IACH,OAAO,CAAC,cAAc;IActB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAY3B"}

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

@@ -0,0 +1,116 @@
+import { NotificationSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { CTXVM_MESSAGES_KIND, GIFT_WRAP_KIND, decryptMessage, } from '../core/index.js';
+import { BaseNostrTransport } from './base-nostr-transport.js';
+import { getNostrEventTag } from '../core/utils/serializers.js';
+/**
+ * A transport layer for CTXVM that uses Nostr events for communication.
+ * It implements the Transport interface from the @modelcontextprotocol/sdk.
+ */
+export class NostrClientTransport extends BaseNostrTransport {
+    constructor(options) {
+        super(options);
+        this.serverPubkey = options.serverPubkey;
+        this.pendingRequestIds = new Set();
+    }
+    /**
+     * Starts the transport, connecting to the relay and setting up event listeners.
+     */
+    async start() {
+        await this.connect();
+        const pubkey = await this.getPublicKey();
+        const filters = this.createSubscriptionFilters(pubkey);
+        await this.subscribe(filters, this.processIncomingEvent.bind(this));
+    }
+    /**
+     * Closes the transport, disconnecting from the relay.
+     */
+    async close() {
+        var _a;
+        await this.disconnect();
+        (_a = this.onclose) === null || _a === void 0 ? void 0 : _a.call(this);
+    }
+    /**
+     * Sends a JSON-RPC message over the Nostr transport.
+     * @param message The JSON-RPC request or response to send.
+     */
+    async send(message) {
+        const eventId = await this._sendInternal(message);
+        if (eventId) {
+            this.pendingRequestIds.add(eventId);
+        }
+    }
+    /**
+     * Internal method to send a JSON-RPC message and get the resulting event ID.
+     * @param message The JSON-RPC message to send.
+     * @returns The ID of the published Nostr event.
+     */
+    async _sendInternal(message) {
+        const tags = this.createRecipientTags(this.serverPubkey);
+        return this.sendMcpMessage(message, this.serverPubkey, CTXVM_MESSAGES_KIND, tags);
+    }
+    /**
+     * Processes incoming Nostr events, routing them to the correct handler.
+     */
+    async processIncomingEvent(event) {
+        var _a;
+        try {
+            let nostrEvent = event;
+            // Handle encrypted messages
+            if (event.kind === GIFT_WRAP_KIND) {
+                const secretKey = await this.signer.getSecretKey();
+                if (!secretKey) {
+                    throw new Error('Secret key is not available for decryption.');
+                }
+                const decryptedContent = decryptMessage(event, secretKey);
+                nostrEvent = JSON.parse(decryptedContent);
+            }
+            // Process the resulting event
+            const mcpMessage = this.convertNostrEventToMcpMessage(nostrEvent);
+            const eTag = getNostrEventTag(nostrEvent.tags, 'e');
+            if (eTag) {
+                this.handleResponse(eTag, mcpMessage);
+            }
+            else {
+                this.handleNotification(mcpMessage);
+            }
+        }
+        catch (error) {
+            console.error('Error handling incoming Nostr event:', error);
+            (_a = this.onerror) === null || _a === void 0 ? void 0 : _a.call(this, error instanceof Error
+                ? error
+                : new Error('Failed to handle incoming Nostr event'));
+        }
+    }
+    /**
+     * Handles response messages by correlating them with pending requests.
+     * @param correlatedEventId The event ID from the 'e' tag.
+     * @param mcpMessage The incoming MCP message.
+     */
+    handleResponse(correlatedEventId, mcpMessage) {
+        var _a;
+        if (this.pendingRequestIds.has(correlatedEventId)) {
+            (_a = this.onmessage) === null || _a === void 0 ? void 0 : _a.call(this, mcpMessage);
+            this.pendingRequestIds.delete(correlatedEventId);
+        }
+        else {
+            console.warn(`Received Nostr event with unexpected 'e' tag: ${correlatedEventId}.`);
+        }
+    }
+    /**
+     * Handles notification messages.
+     * @param mcpMessage The incoming MCP message.
+     */
+    handleNotification(mcpMessage) {
+        var _a, _b;
+        try {
+            NotificationSchema.parse(mcpMessage);
+            (_a = this.onmessage) === null || _a === void 0 ? void 0 : _a.call(this, mcpMessage);
+        }
+        catch (error) {
+            (_b = this.onerror) === null || _b === void 0 ? void 0 : _b.call(this, error instanceof Error
+                ? error
+                : new Error('Failed to handle incoming notification'));
+        }
+    }
+}
+//# sourceMappingURL=nostr-client-transport.js.map

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

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

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

@@ -0,0 +1,128 @@
+import { type JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { BaseNostrTransport, BaseNostrTransportOptions } from './base-nostr-transport.js';
+import { EncryptionMode } from '../core/interfaces.js';
+/**
+ * Options for configuring the NostrServerTransport.
+ */
+export interface NostrServerTransportOptions extends BaseNostrTransportOptions {
+    serverInfo?: ServerInfo;
+    isPublicServer?: boolean;
+    allowedPublicKeys?: string[];
+    encryptionMode?: EncryptionMode;
+}
+/**
+ * Information about a server.
+ */
+export interface ServerInfo {
+    name?: string;
+    picture?: string;
+    website?: 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
+ * responses back to the originating clients. It handles all request/response correlation
+ * internally, making it a standalone MCP transport that works over Nostr.
+ */
+export declare class NostrServerTransport extends BaseNostrTransport implements Transport {
+    onmessage?: (message: JSONRPCMessage) => void;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    private readonly clientSessions;
+    private readonly isPublicServer?;
+    private readonly allowedPublicKeys?;
+    private readonly serverInfo?;
+    constructor(options: NostrServerTransportOptions);
+    /**
+     * Starts the transport, connecting to the relay and setting up event listeners
+     * to receive incoming MCP requests.
+     */
+    start(): Promise<void>;
+    /**
+     * Closes the transport, disconnecting from the relay.
+     */
+    close(): Promise<void>;
+    /**
+     * Sends JSON-RPC messages over the Nostr transport.
+     * @param message The JSON-RPC message to send.
+     */
+    send(message: JSONRPCMessage): Promise<void>;
+    /**
+     * Initiates the process of fetching announcement data from the server's internal logic.
+     */
+    private getAnnouncementData;
+    /**
+     * 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.
+     * @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.
+     */
+    private handleIncomingRequest;
+    /**
+     * Handles incoming notifications.
+     * @param session The client session.
+     * @param notification The notification message.
+     */
+    private handleIncomingNotification;
+    /**
+     * Handles response messages by finding the original request and routing back to client.
+     * @param response The JSON-RPC response or error to send.
+     */
+    private handleResponse;
+    /**
+     * Handles notification messages with routing.
+     * @param notification The JSON-RPC notification to send.
+     */
+    private handleNotification;
+    /**
+     * Sends a notification to a specific client by their public key.
+     * @param clientPubkey The public key of the target client.
+     * @param notification The notification message to send.
+     * @returns Promise that resolves when the notification is sent.
+     */
+    sendNotification(clientPubkey: string, notification: JSONRPCMessage, correlatedEventId?: string): Promise<void>;
+    /**
+     * Processes incoming Nostr events, handling decryption and client authorization.
+     * This method centralizes the logic for determining whether to process an event
+     * based on encryption mode and allowed public keys.
+     * @param event The incoming Nostr event.
+     */
+    private processIncomingEvent;
+    /**
+     * Handles encrypted (gift-wrapped) events.
+     * @param event The incoming gift-wrapped Nostr event.
+     */
+    private handleEncryptedEvent;
+    /**
+     * Handles unencrypted events.
+     * @param event The incoming Nostr event.
+     */
+    private handleUnencryptedEvent;
+    /**
+     * Common logic for authorizing and processing an event.
+     * @param event The event to process.
+     * @param isEncrypted Whether the original event was encrypted.
+     */
+    private authorizeAndProcessEvent;
+    /**
+     * Cleans up inactive client sessions based on a timeout.
+     * @param timeoutMs Timeout in milliseconds for considering a session inactive (default: 5 minutes).
+     * @returns The number of sessions that were cleaned up.
+     */
+    cleanupInactiveSessions(timeoutMs?: number): number;
+}
+//# sourceMappingURL=nostr-server-transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nostr-server-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/nostr-server-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAYL,KAAK,cAAc,EAIpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AAanC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD;;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,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD;;;;;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,cAAc,CAAoC;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAW;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;gBAE7B,OAAO,EAAE,2BAA2B;IAOhD;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAanC;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMnC;;;OAGG;IACU,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsB3B;;;;OAIG;YACW,SAAS;IAkDvB;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAoBhC;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAYlC;;;OAGG;YACW,cAAc;IA6E5B;;;OAGG;YACW,kBAAkB;IAiChC;;;;;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;IAQlC;;;OAGG;YACW,oBAAoB;IAwBlC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IA8BhC;;;;OAIG;IACI,uBAAuB,CAAC,SAAS,GAAE,MAAe,GAAG,MAAM;CAgBnE"}