@unicitylabs/nostr-js-sdk 0.2.1 → 0.2.3

package/README.md

@@ -47,8 +47,15 @@ console.log(keyManager.getPublicKeyHex());
 import { NostrClient, NostrKeyManager } from '@unicitylabs/nostr-sdk';
 
 const keyManager = NostrKeyManager.generate();
+
+// Create client with default options
 const client = new NostrClient(keyManager);
 
+// Or configure with custom options
+const client = new NostrClient(keyManager, {
+  queryTimeoutMs: 15000,  // Increase timeout for slow relays (default: 5000ms)
+});
+
 // Connect to relays
 await client.connect(
   'wss://relay.damus.io',
@@ -58,6 +65,9 @@ await client.connect(
 // Check connection status
 console.log(client.isConnected());
 console.log(client.getConnectedRelays());
+
+// You can also adjust timeout dynamically
+client.setQueryTimeout(30000);  // 30 seconds
 ```
 
 ### Publishing Events
@@ -177,31 +187,24 @@ client.unsubscribe(subId);
 ### Token Transfers
 
 ```typescript
-import { TokenTransferProtocol } from '@unicitylabs/nostr-sdk';
+import { NostrClient, TokenTransferProtocol } from '@unicitylabs/nostr-sdk';
 
-// Create token transfer event
-const event = await TokenTransferProtocol.createTokenTransferEvent(
-  keyManager,
-  recipientPubkey,
-  JSON.stringify({ tokenId: '...', amount: 100 }),
-  100n,  // amount (optional metadata)
-  'UNIT' // symbol (optional metadata)
-);
+// Simple token transfer using NostrClient
+const eventId = await client.sendTokenTransfer(recipientPubkey, tokenJson);
 
-await client.publishEvent(event);
+// Token transfer with metadata
+const eventId = await client.sendTokenTransfer(recipientPubkey, tokenJson, {
+  amount: 100n,
+  symbol: 'UNIT'
+});
 
-// Create token transfer in response to a payment request
+// Token transfer in response to a payment request (with correlation)
 const paymentRequestEventId = '...'; // Event ID of the original payment request
-const event = await TokenTransferProtocol.createTokenTransferEvent(
-  keyManager,
-  recipientPubkey,
-  tokenJson,
-  {
-    amount: 100n,
-    symbol: 'UNIT',
-    replyToEventId: paymentRequestEventId  // Links transfer to the payment request
-  }
-);
+const eventId = await client.sendTokenTransfer(recipientPubkey, tokenJson, {
+  amount: 100n,
+  symbol: 'UNIT',
+  replyToEventId: paymentRequestEventId  // Links transfer to the payment request
+});
 
 // Parse received token transfer
 const tokenJson = await TokenTransferProtocol.parseTokenTransfer(event, keyManager);

package/dist/browser/index.js

@@ -5990,8 +5990,8 @@ var nip17 = /*#__PURE__*/Object.freeze({
 const CONNECTION_TIMEOUT_MS = 30000;
 /** Reconnection delay in milliseconds */
 const RECONNECT_DELAY_MS = 5000;
-/** Query timeout in milliseconds */
-const QUERY_TIMEOUT_MS = 5000;
+/** Default query timeout in milliseconds */
+const DEFAULT_QUERY_TIMEOUT_MS = 5000;
 /**
  * NostrClient provides the main interface for Nostr protocol operations.
  */
@@ -6003,12 +6003,15 @@ class NostrClient {
     pendingOks = new Map();
     subscriptionCounter = 0;
     closed = false;
+    queryTimeoutMs;
     /**
      * Create a NostrClient instance.
      * @param keyManager Key manager with signing keys
+     * @param options Optional configuration options
      */
-    constructor(keyManager) {
+    constructor(keyManager, options) {
         this.keyManager = keyManager;
+        this.queryTimeoutMs = options?.queryTimeoutMs ?? DEFAULT_QUERY_TIMEOUT_MS;
     }
     /**
      * Get the key manager.
@@ -6017,6 +6020,20 @@ class NostrClient {
     getKeyManager() {
         return this.keyManager;
     }
+    /**
+     * Get the current query timeout in milliseconds.
+     * @returns Query timeout in milliseconds
+     */
+    getQueryTimeout() {
+        return this.queryTimeoutMs;
+    }
+    /**
+     * Set the query timeout for nametag lookups and other queries.
+     * @param timeoutMs Timeout in milliseconds
+     */
+    setQueryTimeout(timeoutMs) {
+        this.queryTimeoutMs = timeoutMs;
+    }
     /**
      * Connect to one or more relay WebSocket URLs.
      * @param relayUrls Relay URLs to connect to
@@ -6354,11 +6371,12 @@ class NostrClient {
      * Send a token transfer (encrypted).
      * @param recipientPubkeyHex Recipient's public key (hex)
      * @param tokenJson Token JSON string
+     * @param options Optional parameters (amount, symbol, replyToEventId)
      * @returns Promise that resolves with the event ID
      */
-    async sendTokenTransfer(recipientPubkeyHex, tokenJson) {
+    async sendTokenTransfer(recipientPubkeyHex, tokenJson, options) {
         const TokenTransferProtocol$1 = await Promise.resolve().then(function () { return TokenTransferProtocol; });
-        const event = await TokenTransferProtocol$1.createTokenTransferEvent(this.keyManager, recipientPubkeyHex, tokenJson);
+        const event = await TokenTransferProtocol$1.createTokenTransferEvent(this.keyManager, recipientPubkeyHex, tokenJson, options);
         return this.publishEvent(event);
     }
     /**
@@ -6441,7 +6459,7 @@ class NostrClient {
             const timeoutId = setTimeout(() => {
                 this.unsubscribe(subscriptionId);
                 resolve(null);
-            }, QUERY_TIMEOUT_MS);
+            }, this.queryTimeoutMs);
             let result = null;
             let latestCreatedAt = 0;
             const subscriptionId = this.subscribe(filter, {