nostr-websocket-utils 0.3.17 → 0.3.18

package/dist/nips/nip-44.js

@@ -0,0 +1,134 @@
+/**
+ * @file NIP-44: Versioned Encrypted Payloads
+ * @module nips/nip-44
+ * @see https://github.com/nostr-protocol/nips/blob/master/44.md
+ *
+ * NIP-44 replaces NIP-04 with a modern encryption scheme using
+ * ChaCha20 + HMAC-SHA256. This module provides DM-level helpers
+ * that parallel the NIP-04 module (nip-04.ts).
+ */
+import { nip44, hexToBytes, getPublicKeySync } from 'nostr-crypto-utils';
+/**
+ * Kind value for NIP-44 encrypted direct messages (gift-wrapped DMs use kind 14,
+ * but for parity with NIP-04 kind 4 usage, callers may choose their own kind).
+ * NIP-44 itself is a payload format, not a kind — the kind depends on the use case.
+ * We default to kind 44 as a convenience constant; callers should override as needed.
+ */
+export const ENCRYPTED_DM_KIND_44 = 44;
+/**
+ * Creates a NIP-44 conversation key from a sender's private key and recipient's public key.
+ * This key is symmetric and reusable for all messages in the conversation.
+ * @param senderPrivkeyHex - Sender's private key in hex
+ * @param recipientPubkeyHex - Recipient's public key in hex
+ * @returns Conversation key as Uint8Array
+ */
+export function getConversationKey(senderPrivkeyHex, recipientPubkeyHex) {
+    const privkeyBytes = hexToBytes(senderPrivkeyHex);
+    return nip44.getConversationKey(privkeyBytes, recipientPubkeyHex);
+}
+/**
+ * Encrypts a message using NIP-44
+ * @param plaintext - Message content to encrypt
+ * @param senderPrivkeyHex - Sender's private key in hex
+ * @param recipientPubkeyHex - Recipient's public key in hex
+ * @returns Encrypted payload string (base64)
+ */
+export function encryptNip44(plaintext, senderPrivkeyHex, recipientPubkeyHex) {
+    const conversationKey = getConversationKey(senderPrivkeyHex, recipientPubkeyHex);
+    return nip44.encrypt(plaintext, conversationKey);
+}
+/**
+ * Decrypts a NIP-44 encrypted payload
+ * @param payload - Encrypted payload string (base64)
+ * @param recipientPrivkeyHex - Recipient's private key in hex
+ * @param senderPubkeyHex - Sender's public key in hex
+ * @returns Decrypted plaintext
+ */
+export function decryptNip44(payload, recipientPrivkeyHex, senderPubkeyHex) {
+    const conversationKey = getConversationKey(recipientPrivkeyHex, senderPubkeyHex);
+    return nip44.decrypt(payload, conversationKey);
+}
+/**
+ * Creates an encrypted direct message event using NIP-44
+ * @param content - Message content to encrypt
+ * @param recipientPubkey - Recipient's public key (hex)
+ * @param senderPrivkey - Sender's private key (hex)
+ * @param tags - Additional tags for the event
+ * @param kind - Event kind (defaults to ENCRYPTED_DM_KIND_44)
+ * @returns Encrypted message event as NostrWSMessage
+ */
+export function createEncryptedDM44(content, recipientPubkey, senderPrivkey, tags = [], kind = ENCRYPTED_DM_KIND_44) {
+    try {
+        const encryptedContent = encryptNip44(content, senderPrivkey, recipientPubkey);
+        const senderPubkey = getPublicKeySync(senderPrivkey);
+        return ['EVENT', {
+                kind,
+                pubkey: senderPubkey,
+                content: encryptedContent,
+                tags: [
+                    ['p', recipientPubkey],
+                    ...tags
+                ]
+            }];
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        throw new Error(`Failed to create NIP-44 encrypted DM: ${errorMessage}`);
+    }
+}
+/**
+ * Decrypts a received direct message event encrypted with NIP-44
+ * @param message - Received message
+ * @param recipientPrivkey - Recipient's private key (hex)
+ * @param senderPubkey - Sender's public key (hex)
+ * @param logger - Logger instance
+ * @returns Decrypted message content
+ */
+export function decryptDM44(message, recipientPrivkey, senderPubkey, logger) {
+    try {
+        if (!Array.isArray(message) || message[0] !== 'EVENT') {
+            throw new Error('Invalid message format');
+        }
+        const event = message[1];
+        return decryptNip44(event.content, recipientPrivkey, senderPubkey);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger.error('Failed to decrypt NIP-44 DM:', errorMessage);
+        throw new Error(`Failed to decrypt NIP-44 DM: ${errorMessage}`);
+    }
+}
+/**
+ * Validates a NIP-44 encrypted DM event format
+ * @param message - Message to validate
+ * @param logger - Logger instance
+ * @returns True if message follows NIP-44 encrypted DM format
+ */
+export function validateEncryptedDM44(message, logger) {
+    try {
+        if (!Array.isArray(message) || message[0] !== 'EVENT') {
+            logger.debug('Invalid message format');
+            return false;
+        }
+        const event = message[1];
+        if (!event.content || typeof event.content !== 'string') {
+            logger.debug('Missing or invalid content');
+            return false;
+        }
+        if (!Array.isArray(event.tags)) {
+            logger.debug('Missing tags array');
+            return false;
+        }
+        const recipientTag = event.tags.find((tag) => Array.isArray(tag) && tag[0] === 'p' && tag[1]);
+        if (!recipientTag) {
+            logger.debug('Missing recipient tag');
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        logger.error('Error validating NIP-44 encrypted DM:', error);
+        return false;
+    }
+}
+//# sourceMappingURL=nip-44.js.map

package/dist/nips/nip-44.js.map

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

package/dist/nips/nip-46.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @file NIP-46: Nostr Connect / Remote Signing Transport
+ * @module nips/nip-46
+ * @see https://github.com/nostr-protocol/nips/blob/master/46.md
+ *
+ * nostr-crypto-utils provides the NIP-46 protocol layer (crypto, encoding,
+ * message formatting) but has no I/O. This module adds the WebSocket relay
+ * transport on top — subscribing for kind 24133 responses, publishing
+ * wrapped requests, and correlating request/response pairs.
+ */
+import { nip46 } from 'nostr-crypto-utils';
+import type { Nip46Session, Nip46Request, Nip46Response, SignedNostrEvent, BunkerURI } from 'nostr-crypto-utils';
+import { NostrWSClient } from '../core/client.js';
+import type { NostrWSMessage } from '../types/messages.js';
+/**
+ * Options for creating a NIP-46 transport
+ */
+export interface Nip46TransportOptions {
+    /** Timeout for waiting for a response (ms). Defaults to 60000 (60s). */
+    timeout?: number;
+}
+/**
+ * Result of sending a NIP-46 request
+ */
+export interface Nip46TransportResult {
+    /** The JSON-RPC response from the remote signer */
+    response: Nip46Response;
+    /** The raw kind 24133 event that carried the response */
+    rawEvent: SignedNostrEvent;
+}
+/**
+ * A thin transport layer that bridges nostr-crypto-utils NIP-46 protocol
+ * with the WebSocket relay infrastructure in this library.
+ *
+ * Usage:
+ * ```ts
+ * const client = new NostrWSClient(['wss://relay.example.com']);
+ * await client.connect();
+ *
+ * const session = nip46.createSession(remotePubkey);
+ * const transport = new Nip46Transport(client, session);
+ *
+ * // Send a connect request
+ * const connectReq = nip46.connectRequest(remotePubkey, secret);
+ * const result = await transport.sendRequest(connectReq);
+ * ```
+ */
+export declare class Nip46Transport {
+    private client;
+    private session;
+    private timeout;
+    constructor(client: NostrWSClient, session: Nip46Session, options?: Nip46TransportOptions);
+    /**
+     * Subscribe for NIP-46 response events addressed to our ephemeral pubkey.
+     * This sends a REQ message to the relay with the appropriate filter.
+     * @param subscriptionId - Subscription ID for the REQ message
+     * @param since - Optional since timestamp for the filter
+     * @returns The subscription message that was sent
+     */
+    subscribe(subscriptionId: string, since?: number): Promise<NostrWSMessage>;
+    /**
+     * Wrap and publish a NIP-46 request as a kind 24133 event.
+     * @param request - NIP-46 JSON-RPC request
+     * @returns The signed kind 24133 event that was published
+     */
+    publishRequest(request: Nip46Request): Promise<SignedNostrEvent>;
+    /**
+     * Attempt to unwrap a kind 24133 event into a NIP-46 request or response.
+     * Returns null if the event is not kind 24133 or decryption fails.
+     * @param event - A signed Nostr event
+     * @returns Decrypted NIP-46 payload, or null on failure
+     */
+    unwrapEvent(event: SignedNostrEvent): Nip46Request | Nip46Response | null;
+    /**
+     * Get the NIP-46 response filter for this session.
+     * Useful for manual subscription management.
+     * @param since - Optional since timestamp
+     * @returns Filter object for kind 24133 events tagged to our pubkey
+     */
+    getResponseFilter(since?: number): {
+        kinds: number[];
+        '#p': string[];
+        since?: number;
+    };
+    /**
+     * Get the current session (read-only info).
+     * @returns The session's client and remote pubkeys
+     */
+    getSessionInfo(): {
+        clientPubkey: string;
+        remotePubkey: string;
+    };
+}
+/** Parse a bunker:// URI */
+export declare const parseBunkerURI: (uri: string) => BunkerURI;
+/** Create a bunker:// URI */
+export declare const createBunkerURI: (remotePubkey: string, relays: string[], secret?: string) => string;
+/** Validate a bunker:// URI */
+export declare const validateBunkerURI: typeof nip46.validateBunkerURI;
+/** Create a new NIP-46 session */
+export declare const createNip46Session: typeof nip46.createSession;
+/** Restore a NIP-46 session */
+export declare const restoreNip46Session: typeof nip46.restoreSession;
+/** Create a 'connect' request */
+export declare const connectRequest: typeof nip46.connectRequest;
+/** Create a 'ping' request */
+export declare const pingRequest: typeof nip46.pingRequest;
+/** Create a 'get_public_key' request */
+export declare const getPublicKeyRequest: typeof nip46.getPublicKeyRequest;
+/** Create a 'sign_event' request */
+export declare const signEventRequest: typeof nip46.signEventRequest;
+//# sourceMappingURL=nip-46.d.ts.map

package/dist/nips/nip-46.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip-46.d.ts","sourceRoot":"","sources":["../../src/nips/nip-46.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,QAAQ,EAAE,aAAa,CAAC;IACxB,yDAAyD;IACzD,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAGtB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,qBAA0B;IAOrC;;;;;;OAMG;IACG,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAWhF;;;;OAIG;IACG,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAatE;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,GAAG,aAAa,GAAG,IAAI;IAUzE;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAItF;;;OAGG;IACH,cAAc,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;CAGjE;AAKD,4BAA4B;AAC5B,eAAO,MAAM,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAgC,CAAC;AAE/E,6BAA6B;AAC7B,eAAO,MAAM,eAAe,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,MAA8B,CAAC;AAE1H,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,EAAE,OAAO,KAAK,CAAC,iBAA2C,CAAC;AAEzF,kCAAkC;AAClC,eAAO,MAAM,kBAAkB,EAAE,OAAO,KAAK,CAAC,aAAmC,CAAC;AAElF,+BAA+B;AAC/B,eAAO,MAAM,mBAAmB,EAAE,OAAO,KAAK,CAAC,cAAqC,CAAC;AAErF,iCAAiC;AACjC,eAAO,MAAM,cAAc,EAAE,OAAO,KAAK,CAAC,cAAqC,CAAC;AAEhF,8BAA8B;AAC9B,eAAO,MAAM,WAAW,EAAE,OAAO,KAAK,CAAC,WAA+B,CAAC;AAEvE,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,EAAE,OAAO,KAAK,CAAC,mBAA+C,CAAC;AAE/F,oCAAoC;AACpC,eAAO,MAAM,gBAAgB,EAAE,OAAO,KAAK,CAAC,gBAAyC,CAAC"}

package/dist/nips/nip-46.js

@@ -0,0 +1,119 @@
+/**
+ * @file NIP-46: Nostr Connect / Remote Signing Transport
+ * @module nips/nip-46
+ * @see https://github.com/nostr-protocol/nips/blob/master/46.md
+ *
+ * nostr-crypto-utils provides the NIP-46 protocol layer (crypto, encoding,
+ * message formatting) but has no I/O. This module adds the WebSocket relay
+ * transport on top — subscribing for kind 24133 responses, publishing
+ * wrapped requests, and correlating request/response pairs.
+ */
+import { nip46 } from 'nostr-crypto-utils';
+import { getLogger } from '../utils/logger.js';
+const logger = getLogger('NIP-46');
+/**
+ * A thin transport layer that bridges nostr-crypto-utils NIP-46 protocol
+ * with the WebSocket relay infrastructure in this library.
+ *
+ * Usage:
+ * ```ts
+ * const client = new NostrWSClient(['wss://relay.example.com']);
+ * await client.connect();
+ *
+ * const session = nip46.createSession(remotePubkey);
+ * const transport = new Nip46Transport(client, session);
+ *
+ * // Send a connect request
+ * const connectReq = nip46.connectRequest(remotePubkey, secret);
+ * const result = await transport.sendRequest(connectReq);
+ * ```
+ */
+export class Nip46Transport {
+    constructor(client, session, options = {}) {
+        this.client = client;
+        this.session = session;
+        this.timeout = options.timeout ?? 60000;
+    }
+    /**
+     * Subscribe for NIP-46 response events addressed to our ephemeral pubkey.
+     * This sends a REQ message to the relay with the appropriate filter.
+     * @param subscriptionId - Subscription ID for the REQ message
+     * @param since - Optional since timestamp for the filter
+     * @returns The subscription message that was sent
+     */
+    async subscribe(subscriptionId, since) {
+        const filter = nip46.createResponseFilter(this.session.clientPubkey, since);
+        const message = ['REQ', {
+                subscription_id: subscriptionId,
+                filters: [filter]
+            }];
+        await this.client.sendMessage(message);
+        logger.debug({ subscriptionId, filter }, 'Subscribed for NIP-46 responses');
+        return message;
+    }
+    /**
+     * Wrap and publish a NIP-46 request as a kind 24133 event.
+     * @param request - NIP-46 JSON-RPC request
+     * @returns The signed kind 24133 event that was published
+     */
+    async publishRequest(request) {
+        const event = await nip46.wrapEvent(request, this.session, this.session.remotePubkey);
+        const message = ['EVENT', event];
+        await this.client.sendMessage(message);
+        logger.debug({ requestId: request.id, method: request.method }, 'Published NIP-46 request');
+        return event;
+    }
+    /**
+     * Attempt to unwrap a kind 24133 event into a NIP-46 request or response.
+     * Returns null if the event is not kind 24133 or decryption fails.
+     * @param event - A signed Nostr event
+     * @returns Decrypted NIP-46 payload, or null on failure
+     */
+    unwrapEvent(event) {
+        try {
+            return nip46.unwrapEvent(event, this.session);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            logger.debug({ error: errorMessage }, 'Failed to unwrap NIP-46 event');
+            return null;
+        }
+    }
+    /**
+     * Get the NIP-46 response filter for this session.
+     * Useful for manual subscription management.
+     * @param since - Optional since timestamp
+     * @returns Filter object for kind 24133 events tagged to our pubkey
+     */
+    getResponseFilter(since) {
+        return nip46.createResponseFilter(this.session.clientPubkey, since);
+    }
+    /**
+     * Get the current session (read-only info).
+     * @returns The session's client and remote pubkeys
+     */
+    getSessionInfo() {
+        return nip46.getSessionInfo(this.session);
+    }
+}
+// ─── Convenience re-exports from nostr-crypto-utils ─────────────────────────
+// These let consumers access NIP-46 protocol helpers without a separate import.
+/** Parse a bunker:// URI */
+export const parseBunkerURI = nip46.parseBunkerURI;
+/** Create a bunker:// URI */
+export const createBunkerURI = nip46.createBunkerURI;
+/** Validate a bunker:// URI */
+export const validateBunkerURI = nip46.validateBunkerURI;
+/** Create a new NIP-46 session */
+export const createNip46Session = nip46.createSession;
+/** Restore a NIP-46 session */
+export const restoreNip46Session = nip46.restoreSession;
+/** Create a 'connect' request */
+export const connectRequest = nip46.connectRequest;
+/** Create a 'ping' request */
+export const pingRequest = nip46.pingRequest;
+/** Create a 'get_public_key' request */
+export const getPublicKeyRequest = nip46.getPublicKeyRequest;
+/** Create a 'sign_event' request */
+export const signEventRequest = nip46.signEventRequest;
+//# sourceMappingURL=nip-46.js.map

package/dist/nips/nip-46.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nostr-websocket-utils",
-  "version": "0.3.17",
+  "version": "0.3.18",
   "description": "Robust WebSocket utilities for Nostr applications with automatic reconnection, supporting both ESM and CommonJS. Features channel-based messaging, heartbeat monitoring, message queueing, and comprehensive error handling with type-safe handlers.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/index.js",
@@ -22,7 +22,7 @@
   "scripts": {
     "build": "npm run build:ts && npm run build:browser",
     "build:ts": "tsc && tsc -p tsconfig.cjs.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
-    "build:browser": "webpack",
+    "build:browser": "node esbuild.browser.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
@@ -61,7 +61,7 @@
   "homepage": "https://github.com/HumanjavaEnterprises/nostr-websocket-utils#readme",
   "dependencies": {
     "@types/uuid": "^10.0.0",
-    "nostr-crypto-utils": "^0.4.10",
+    "nostr-crypto-utils": "^0.5.1",
     "pino": "^8.21.0",
     "uuid": "^11.1.0",
     "ws": "^8.19.0"
@@ -73,16 +73,12 @@
     "@typescript-eslint/eslint-plugin": "^8.56.0",
     "@typescript-eslint/parser": "^8.56.0",
     "@vitest/coverage-v8": "^3.2.4",
+    "esbuild": "^0.27.3",
     "eslint": "^10.0.0",
-    "terser-webpack-plugin": "^5.3.16",
-    "ts-loader": "^9.5.4",
     "typedoc": "^0.28.17",
     "typedoc-plugin-markdown": "^4.10.0",
     "typescript": "^5.9.3",
-    "vitest": "^3.2.4",
-    "webpack": "^5.105.2",
-    "webpack-bundle-analyzer": "^4.10.1",
-    "webpack-cli": "^5.1.4"
+    "vitest": "^3.2.4"
   },
   "files": [
     "dist",