@nostrify/nostrify 0.49.2 → 0.50.0

package/.turbo/turbo-build.log

@@ -1,32 +1,32 @@
 
-> @nostrify/nostrify@0.49.1 build /home/alex/Projects/nostrify/packages/nostrify
+> @nostrify/nostrify@0.50.0 build /home/alex/Projects/nostrify/packages/nostrify
 > npx tsc -p tsconfig.json && node ../../esbuild.config.js --package ./
 
 npm warn Unknown env config "verify-deps-before-run". This will stop working in the next major version of npm.
 npm warn Unknown env config "_jsr-registry". This will stop working in the next major version of npm.
 Building with esbuild...
 
-  dist/NRelay1.js                       8.9kb
-  dist/NSchema.js                       5.7kb
-  dist/NPool.js                         5.4kb
-  dist/test/TestRelayServer.js          4.4kb
-  dist/NSet.js                          4.1kb
-  dist/NConnectSigner.js                3.9kb
-  dist/ln/LNURL.js                      3.3kb
-  dist/NIP98.js                         2.7kb
-  dist/NBrowserSigner.js                2.6kb
-  dist/uploaders/BlossomUploader.js     1.9kb
-  dist/uploaders/NostrBuildUploader.js  1.9kb
-  dist/test/MockRelay.js                1.4kb
-  dist/BunkerURI.js                     1.4kb
-  dist/NKinds.js                        1.1kb
-  dist/NIP05.js                         1.1kb
-  dist/NSecSigner.js                    1.1kb
-  dist/utils/Machina.js                 925b 
-  dist/NCache.js                        828b 
-  dist/mod.js                           815b 
-  dist/test/mod.js                      701b 
+  dist/NRelay1.js                       10.7kb
+  dist/NSchema.js                        8.2kb
+  dist/NPool.js                          5.4kb
+  dist/test/TestRelayServer.js           4.4kb
+  dist/NSet.js                           4.1kb
+  dist/NConnectSigner.js                 3.9kb
+  dist/ln/LNURL.js                       3.3kb
+  dist/NIP98.js                          2.7kb
+  dist/NBrowserSigner.js                 2.6kb
+  dist/uploaders/BlossomUploader.js      1.9kb
+  dist/uploaders/NostrBuildUploader.js   1.9kb
+  dist/test/MockRelay.js                 1.4kb
+  dist/BunkerURI.js                      1.4kb
+  dist/NKinds.js                         1.1kb
+  dist/NIP05.js                          1.1kb
+  dist/NSecSigner.js                     1.1kb
+  dist/utils/Machina.js                  925b 
+  dist/NCache.js                         828b 
+  dist/mod.js                            815b 
+  dist/test/mod.js                       701b 
   ...and 11 more output files...
 
-⚡ Done in 15ms
+⚡ Done in 16ms
 Done!

package/.turbo/turbo-test.log

@@ -1,113 +1,113 @@
-
-
-> @nostrify/nostrify@0.49.1 test /home/alex/Projects/nostrify/packages/nostrify
-> node --test "**/*.test.ts"
-
-✔ BunkerURI (2.855929ms)
-✔ BunkerURI.fromJSON (0.647302ms)
-✔ NBrowserSigner - without extension (5.614283ms)
-✔ NBrowserSigner - with extension polyfill (162.64428ms)
-✔ NBrowserSigner.nip44 - with extension polyfill (35.751206ms)
-✔ NBrowserSigner.nip04 - with extension polyfill (24.897688ms)
-✔ NBrowserSigner.getRelays - with extension polyfill (1.639964ms)
-✔ NBrowserSigner - missing nip44 support (0.681486ms)
-✔ NBrowserSigner - missing nip04 support (0.334181ms)
-✔ NBrowserSigner - feature detection (2.345656ms)
-✔ NCache (4.846063ms)
-✔ NConnectSigner.signEvent with nip04 encryption (284.998411ms)
-✔ NConnectSigner.signEvent with nip44 encryption (79.574293ms)
-✔ NIP05.lookup (94.266524ms)
-✔ NIP05.lookup with invalid values but valid profile pointer (6.109077ms)
-✔ NIP05.lookup with invalid document (7.362813ms)
-✔ NIP50.parseInput (6.692668ms)
-✔ NIP50.parseInput with negated token (0.459908ms)
-✔ NIP98.template (7.800118ms)
-✔ NIP98.template with payload (57.504461ms)
-✔ NIP98.verify (167.402989ms)
-✔ NIP98.verify fails with missing header (1.462579ms)
-✔ NIP98.verify fails with missing token (1.026357ms)
-✔ NIP98.verify fails with invalid token (1.318398ms)
-✔ NIP98.verify fails with invalid event (15.517318ms)
-✔ NIP98.verify fails with wrong event kind (15.461533ms)
-✔ NIP98.verify fails with wrong request URL (12.774894ms)
-✔ NIP98.verify fails with wrong request method (15.755518ms)
-✔ NIP98.verify fails with expired event (11.549622ms)
-✔ NIP98.verify fails with invalid payload (25.108065ms)
-✔ NIP98Client.fetch - basic GET request (152.34065ms)
-✔ NIP98Client.fetch - POST request with body (48.046766ms)
-✔ NIP98Client.fetch - with Request object input (22.539248ms)
-✔ NIP98Client.fetch - with URL object input (14.907818ms)
-✔ NIP98Client.fetch - uses default fetch when not provided (11.87691ms)
-✔ NIP98Client.fetch - preserves existing headers (16.091842ms)
-✔ NIP98Client.fetch - event can be verified with NIP98.verify (20.434596ms)
-✔ NIP98Client.fetch - handles different HTTP methods (54.082414ms)
-✔ NKinds (5.032997ms)
-✔ NPool.query (378.702333ms)
-✔ NPool.req (77.556426ms)
-✔ NPool.event (32.572729ms)
-✔ NPool.query with eoseTimeout (559.204759ms)
-✔ NPool.query with eoseTimeout disabled (519.68897ms)
-✔ NRelay1.query (226.319484ms)
-✔ NRelay1.query mismatched filter (27.633319ms)
-✔ NRelay1.req (66.241496ms)
-✔ NRelay1.event (12.452346ms)
-﹣ NRelay1 backoff (0.21217ms) # SKIP
-▶ NRelay1 idleTimeout
-  ✔ websocket opens (2.256778ms)
-  ✔ websocket closes after idleTimeout (150.482082ms)
-  ✔ websocket wakes up during activity (17.379211ms)
-✔ NRelay1 idleTimeout (173.173788ms)
-✔ NRelay1.count rejects when the server sends CLOSED (7.752588ms)
-✔ NRelay1 closes when it receives a binary message (5.304398ms)
-✔ n.id (11.977479ms)
-✔ n.bech32 (4.31372ms)
-✔ n.filter (83.609146ms)
-✔ n.event (39.732538ms)
-✔ n.metadata (67.78575ms)
-✔ NSecSigner (134.833466ms)
-✔ NSecSigner.nip44 (39.725124ms)
-✔ NSet (26.167433ms)
-✔ NSet.add (replaceable) (0.555688ms)
-✔ NSet.add (parameterized) (0.859632ms)
-✔ NSet.add (deletion) (0.659384ms)
-✔ Construct a RelayError from the reason message (2.48014ms)
-✔ Throw a new RelayError if the OK message is false (0.480627ms)
-✔ LNURL.fromString (7.853168ms)
-✔ LNURL.fromLightningAddress (1.565174ms)
-✔ LNURL.toString (1.207389ms)
-✔ LNURL.getDetails (61.890516ms)
-✔ LNURL.getInvoice (12.594574ms)
-✔ ErrorRelay (89.704386ms)
-✔ MockRelay (5.643569ms)
-✔ BlossomUploader.upload (685.760126ms)
-✖ NostrBuildUploader.upload (25.389164ms)
-✔ CircularSet (2.759166ms)
-✔ push, iterate, & close (103.744176ms)
-✔ close & reopen (0.695512ms)
-✔ aborts with signal (51.384223ms)
-✔ already aborted signal in constructor (0.622785ms)
-✔ push after abort (0.654174ms)
-✔ multiple messages in queue (0.316858ms)
-✔ N64 (18.170805ms)
-✔ N64.encodeEvent (0.414843ms)
-✔ N64.decodeEvent (4.505341ms)
-ℹ tests 87
-ℹ suites 0
-ℹ pass 85
-ℹ fail 1
-ℹ cancelled 0
-ℹ skipped 1
-ℹ todo 0
-ℹ duration_ms 3425.548766
-
-✖ failing tests:
-
-test at uploaders/NostrBuildUploader.test.ts:12:7
-✖ NostrBuildUploader.upload (25.389164ms)
-  Error: nostr.build with default uploader requires a secret key to be configured
-      at TestContext.<anonymous> (file:///home/alex/Projects/nostrify/packages/nostrify/uploaders/NostrBuildUploader.test.ts:25:13)
-      at process.processTicksAndRejections (node:internal/process/task_queues:104:5)
-      at async Test.run (node:internal/test_runner/test:1102:7)
-      at async startSubtestAfterBootstrap (node:internal/test_runner/harness:358:3)
-      at async file:///home/alex/Projects/nostrify/packages/nostrify/uploaders/NostrBuildUploader.test.ts:12:1
- ELIFECYCLE  Test failed. See above for more details.
+
+> @nostrify/nostrify@0.49.2 test /home/alex/Projects/nostrify/packages/nostrify
+> node --test "**/*.test.ts"
+
+✔ BunkerURI (3.395047ms)
+✔ BunkerURI.fromJSON (0.74187ms)
+✔ NBrowserSigner - without extension (6.198276ms)
+✔ NBrowserSigner - with extension polyfill (190.009587ms)
+✔ NBrowserSigner.nip44 - with extension polyfill (37.935911ms)
+✔ NBrowserSigner.nip04 - with extension polyfill (25.129052ms)
+✔ NBrowserSigner.getRelays - with extension polyfill (2.053194ms)
+✔ NBrowserSigner - missing nip44 support (0.917462ms)
+✔ NBrowserSigner - missing nip04 support (0.459447ms)
+✔ NBrowserSigner - feature detection (0.765374ms)
+✔ NCache (12.840903ms)
+✔ NConnectSigner.signEvent with nip04 encryption (271.624777ms)
+✔ NConnectSigner.signEvent with nip44 encryption (71.743781ms)
+✔ NIP05.lookup (136.606498ms)
+✔ NIP05.lookup with invalid values but valid profile pointer (26.791359ms)
+✔ NIP05.lookup with invalid document (12.007099ms)
+✔ NIP50.parseInput (3.937501ms)
+✔ NIP50.parseInput with negated token (0.560007ms)
+✔ NIP98.template (6.37427ms)
+✔ NIP98.template with payload (26.999101ms)
+✔ NIP98.verify (179.4453ms)
+✔ NIP98.verify fails with missing header (3.242699ms)
+✔ NIP98.verify fails with missing token (1.904625ms)
+✔ NIP98.verify fails with invalid token (2.465312ms)
+✔ NIP98.verify fails with invalid event (22.614687ms)
+✔ NIP98.verify fails with wrong event kind (32.449507ms)
+✔ NIP98.verify fails with wrong request URL (21.092385ms)
+✔ NIP98.verify fails with wrong request method (29.362892ms)
+✔ NIP98.verify fails with expired event (18.052067ms)
+✔ NIP98.verify fails with invalid payload (31.823746ms)
+✔ NIP98Client.fetch - basic GET request (203.916982ms)
+✔ NIP98Client.fetch - POST request with body (53.60961ms)
+✔ NIP98Client.fetch - with Request object input (20.893399ms)
+✔ NIP98Client.fetch - with URL object input (11.890279ms)
+✔ NIP98Client.fetch - uses default fetch when not provided (9.503144ms)
+✔ NIP98Client.fetch - preserves existing headers (14.925967ms)
+✔ NIP98Client.fetch - event can be verified with NIP98.verify (24.239093ms)
+✔ NIP98Client.fetch - handles different HTTP methods (62.95163ms)
+✔ NKinds (2.673706ms)
+✔ NPool.query (340.485108ms)
+✔ NPool.req (83.109821ms)
+✔ NPool.event (39.765323ms)
+✔ NPool.query with eoseTimeout (589.053675ms)
+✔ NPool.query with eoseTimeout disabled (517.784379ms)
+✔ NRelay1.query (327.416455ms)
+✔ NRelay1.query with NIP-50 search preserves relay order (54.456828ms)
+✔ NRelay1.query mismatched filter (24.4706ms)
+✔ NRelay1.req (70.307922ms)
+✔ NRelay1.event (25.854061ms)
+﹣ NRelay1 backoff (0.278776ms) # SKIP
+▶ NRelay1 idleTimeout
+  ✔ websocket opens (2.814902ms)
+  ✔ websocket closes after idleTimeout (150.342419ms)
+  ✔ websocket wakes up during activity (16.192178ms)
+✔ NRelay1 idleTimeout (172.377473ms)
+✔ NRelay1.count rejects when the server sends CLOSED (6.414255ms)
+✔ NRelay1 closes when it receives a binary message (4.879718ms)
+✔ n.id (13.224767ms)
+✔ n.bech32 (4.952717ms)
+✔ n.filter (59.599323ms)
+✔ n.event (50.481827ms)
+✔ n.metadata (79.798873ms)
+✔ NSecSigner (174.438973ms)
+✔ NSecSigner.nip44 (40.880438ms)
+✔ NSet (32.904085ms)
+✔ NSet.add (replaceable) (0.611303ms)
+✔ NSet.add (parameterized) (0.78409ms)
+✔ NSet.add (deletion) (0.528828ms)
+✔ Construct a RelayError from the reason message (2.522901ms)
+✔ Throw a new RelayError if the OK message is false (0.555108ms)
+✔ LNURL.fromString (9.215922ms)
+✔ LNURL.fromLightningAddress (2.004964ms)
+✔ LNURL.toString (0.956956ms)
+✔ LNURL.getDetails (77.433128ms)
+✔ LNURL.getInvoice (11.77437ms)
+✔ ErrorRelay (108.988137ms)
+✔ MockRelay (4.248918ms)
+✔ BlossomUploader.upload (667.499053ms)
+✖ NostrBuildUploader.upload (15.830003ms)
+✔ CircularSet (3.14234ms)
+✔ push, iterate, & close (103.279174ms)
+✔ close & reopen (0.623095ms)
+✔ aborts with signal (51.133076ms)
+✔ already aborted signal in constructor (0.404423ms)
+✔ push after abort (0.54578ms)
+✔ multiple messages in queue (0.272634ms)
+✔ N64 (11.53621ms)
+✔ N64.encodeEvent (0.261664ms)
+✔ N64.decodeEvent (2.938024ms)
+ℹ tests 88
+ℹ suites 0
+ℹ pass 86
+ℹ fail 1
+ℹ cancelled 0
+ℹ skipped 1
+ℹ todo 0
+ℹ duration_ms 3268.962193
+
+✖ failing tests:
+
+test at uploaders/NostrBuildUploader.test.ts:12:7
+✖ NostrBuildUploader.upload (15.830003ms)
+  Error: nostr.build with default uploader requires a secret key to be configured
+      at TestContext.<anonymous> (file:///home/alex/Projects/nostrify/packages/nostrify/uploaders/NostrBuildUploader.test.ts:25:13)
+      at process.processTicksAndRejections (node:internal/process/task_queues:104:5)
+      at async Test.run (node:internal/test_runner/test:1102:7)
+      at async startSubtestAfterBootstrap (node:internal/test_runner/harness:358:3)
+      at async file:///home/alex/Projects/nostrify/packages/nostrify/uploaders/NostrBuildUploader.test.ts:12:1
+ ELIFECYCLE  Test failed. See above for more details.

package/.turbo/turbo-typecheck.log

@@ -1,5 +1,5 @@
 
-> @nostrify/nostrify@0.49.1 typecheck /home/alex/Projects/nostrify/packages/nostrify
+> @nostrify/nostrify@0.50.0 typecheck /home/alex/Projects/nostrify/packages/nostrify
 > npx tsc --noEmit
 
 npm warn Unknown env config "verify-deps-before-run". This will stop working in the next major version of npm.

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.50.0
+
+### Minor Changes
+
+- Add NIP-11 relay information document support to NRelay1 with `getRelayInfo()` method and `NSchema.relayInfo()` validation schema. Fix NRelay1.query to preserve relay-provided ordering for NIP-50 search filters instead of sorting by created_at.
+
 ## 0.49.2
 
 ### Patch Changes

package/NRelay1.test.ts

@@ -36,6 +36,38 @@ await test("NRelay1.query", async () => {
   clearTimeout(tid);
 });
 
+await test("NRelay1.query with NIP-50 search preserves relay order", async () => {
+  // Create events with different timestamps. The relay will send them
+  // in "relevance" order (oldest first), not chronological order.
+  const sk = generateSecretKey();
+  const oldest = genEvent({ kind: 1, content: "most relevant", created_at: 1000 }, sk);
+  const middle = genEvent({ kind: 1, content: "somewhat relevant", created_at: 2000 }, sk);
+  const newest = genEvent({ kind: 1, content: "least relevant", created_at: 3000 }, sk);
+
+  // Relay sends in relevance order: oldest, middle, newest.
+  // Without the fix, NSet would sort them newest-first by created_at.
+  await using server = await TestRelayServer.create({
+    handleMessage(socket, msg) {
+      if (msg[0] === "REQ") {
+        const [, subId] = msg;
+        socket.send(JSON.stringify(["EVENT", subId, oldest]));
+        socket.send(JSON.stringify(["EVENT", subId, middle]));
+        socket.send(JSON.stringify(["EVENT", subId, newest]));
+        socket.send(JSON.stringify(["EOSE", subId]));
+      }
+    },
+  });
+
+  await using relay = new NRelay1(server.url);
+  const events = await relay.query([{ kinds: [1], search: "relevant" }]);
+
+  deepStrictEqual(events.length, 3);
+  // Results should preserve relay order (relevance), not be sorted by created_at.
+  deepStrictEqual(events[0].id, oldest.id);
+  deepStrictEqual(events[1].id, middle.id);
+  deepStrictEqual(events[2].id, newest.id);
+});
+
 await test("NRelay1.query mismatched filter", async () => {
   await using server = await TestRelayServer.create({
     handleMessage(socket, msg) {

package/NRelay1.ts

@@ -10,6 +10,7 @@ import type {
   NostrRelayMsg,
   NostrRelayNOTICE,
   NostrRelayOK,
+  NostrRelayInfo,
   NRelay,
 } from '@nostrify/types';
 import { getFilterLimit, matchFilters, verifyEvent as _verifyEvent } from 'nostr-tools';
@@ -28,7 +29,7 @@ type EventMap = {
   notice: NostrRelayNOTICE;
 };
 
-/** Options used for constructing an `NRelay1` instance. */
+  /** Options used for constructing an `NRelay1` instance. */
 export interface NRelay1Opts {
   /** Respond to `AUTH` challenges by producing a signed kind `22242` event. */
   auth?(challenge: string): Promise<NostrEvent>;
@@ -40,6 +41,8 @@ export interface NRelay1Opts {
   verifyEvent?(event: NostrEvent): boolean;
   /** Logger callback. */
   log?(log: NRelay1Log): void;
+  /** Custom fetch function for retrieving NIP-11 relay information. Default: `globalThis.fetch`. */
+  fetch?: typeof globalThis.fetch;
 }
 
 export interface NRelay1Log {
@@ -58,6 +61,7 @@ export class NRelay1 implements NRelay {
   private controller = new AbortController();
   private url: string;
   private opts: NRelay1Opts;
+  private relayInfoPromise?: Promise<NostrRelayInfo | undefined>;
 
   private ee = new EventTarget();
 
@@ -76,6 +80,69 @@ export class NRelay1 implements NRelay {
     this.maybeStartIdleTimer();
   }
 
+  /** Fetch the NIP-11 relay information document. */
+  private async fetchRelayInfo(opts?: { signal?: AbortSignal }): Promise<NostrRelayInfo | undefined> {
+    try {
+      const { fetch: fetchFn = globalThis.fetch } = this.opts;
+      const { signal } = opts || {};
+      
+      const httpUrl = this.url.replace(/^wss?:\/\//, (match) => 
+        match === 'ws://' ? 'http://' : 'https://'
+      );
+      
+      const response = await fetchFn(httpUrl, {
+        headers: { Accept: 'application/nostr+json' },
+        signal,
+      });
+      
+      if (!response.ok) {
+        this.log({
+          level: 'warn',
+          ns: 'relay.nip11',
+          status: response.status,
+          message: 'Failed to fetch relay info',
+        });
+        return undefined;
+      }
+      
+      const data = await response.json();
+      const result = n.relayInfo().safeParse(data);
+      
+      if (!result.success) {
+        this.log({
+          level: 'warn',
+          ns: 'relay.nip11',
+          error: result.error,
+          message: 'Invalid relay info format',
+        });
+        return undefined;
+      }
+      
+      this.log({
+        level: 'debug',
+        ns: 'relay.nip11',
+        message: 'Successfully fetched relay info',
+      });
+      return result.data as NostrRelayInfo;
+    } catch (error) {
+      this.log({
+        level: 'warn',
+        ns: 'relay.nip11',
+        error: error instanceof Error ? error : new Error(String(error)),
+        message: 'Error fetching relay info',
+      });
+      return undefined;
+    }
+  }
+
+  /** Get the NIP-11 relay information document. Fetches on first call and caches the result. */
+  async getRelayInfo(opts?: { signal?: AbortSignal }): Promise<NostrRelayInfo | undefined> {
+    if (!this.relayInfoPromise) {
+      this.relayInfoPromise = this.fetchRelayInfo(opts);
+    }
+    return this.relayInfoPromise;
+  }
+
   /** Create (and open) a WebSocket connection with automatic reconnect. */
   private createSocket(): Websocket {
     const { backoff = new ExponentialBackoff(1000) } = this.opts;
@@ -255,7 +322,8 @@ export class NRelay1 implements NRelay {
     filters: NostrFilter[],
     opts?: { signal?: AbortSignal },
   ): Promise<NostrEvent[]> {
-    const events = new NSet();
+    const map = new Map<string, NostrEvent>();
+    const events = new NSet(map);
 
     const limit = filters.reduce(
       (result, filter) => result + getFilterLimit(filter),
@@ -273,7 +341,12 @@ export class NRelay1 implements NRelay {
       }
     }
 
-    return [...events];
+    // Don't sort results of search filters.
+    if (filters.some((filter) => typeof filter.search === 'string')) {
+      return [...map.values()];
+    } else {
+      return [...events];
+    }
   }
 
   async event(

package/NSchema.ts

@@ -217,6 +217,51 @@ class NSchema {
     });
   }
 
+  /** NIP-11 Relay Information Document schema. */
+  static relayInfo() {
+    return z.looseObject({
+      name: z.string().optional().catch(undefined),
+      description: z.string().optional().catch(undefined),
+      pubkey: NSchema.id().optional().catch(undefined),
+      contact: z.string().optional().catch(undefined),
+      supported_nips: z.number().int().nonnegative().array().optional().catch(undefined),
+      software: z.string().optional().catch(undefined),
+      version: z.string().optional().catch(undefined),
+      limitation: z.looseObject({
+        max_message_length: z.number().int().nonnegative().optional().catch(undefined),
+        max_subscriptions: z.number().int().nonnegative().optional().catch(undefined),
+        max_filters: z.number().int().nonnegative().optional().catch(undefined),
+        max_limit: z.number().int().nonnegative().optional().catch(undefined),
+        max_subid_length: z.number().int().nonnegative().optional().catch(undefined),
+        max_event_tags: z.number().int().nonnegative().optional().catch(undefined),
+        max_content_length: z.number().int().nonnegative().optional().catch(undefined),
+        min_pow_difficulty: z.number().int().nonnegative().optional().catch(undefined),
+        auth_required: z.boolean().optional().catch(undefined),
+        payment_required: z.boolean().optional().catch(undefined),
+        restricted_writes: z.boolean().optional().catch(undefined),
+        created_at_lower_limit: z.number().int().nonnegative().optional().catch(undefined),
+        created_at_upper_limit: z.number().int().nonnegative().optional().catch(undefined),
+      }).optional().catch(undefined),
+      retention: z.array(z.object({
+        time: z.number().int().nullable(),
+        count: z.number().int().nonnegative().optional(),
+        kinds: z.number().int().nonnegative().array().optional(),
+      })).optional().catch(undefined),
+      relay_countries: z.string().array().optional().catch(undefined),
+      language_tags: z.string().array().optional().catch(undefined),
+      tags: z.string().array().optional().catch(undefined),
+      posting_policy: z.string().optional().catch(undefined),
+      payments_url: z.string().optional().catch(undefined),
+      fees: z.record(z.string(), z.array(z.object({
+        amount: z.number(),
+        unit: z.string(),
+        period: z.number().int().nonnegative().optional(),
+        kinds: z.number().int().nonnegative().array().optional(),
+      }))).optional().catch(undefined),
+      icon: z.string().optional().catch(undefined),
+    });
+  }
+
   /** NIP-46 request content schema. */
   static connectRequest() {
     return z.object({

package/dist/NRelay1.d.ts

@@ -1,4 +1,4 @@
-import type { NostrClientMsg, NostrClientREQ, NostrEvent, NostrFilter, NostrRelayCLOSED, NostrRelayEOSE, NostrRelayEVENT, NostrRelayMsg, NRelay } from '@nostrify/types';
+import type { NostrClientMsg, NostrClientREQ, NostrEvent, NostrFilter, NostrRelayCLOSED, NostrRelayEOSE, NostrRelayEVENT, NostrRelayMsg, NostrRelayInfo, NRelay } from '@nostrify/types';
 import { Websocket } from 'websocket-ts';
 import type { Backoff } from 'websocket-ts';
 /** Options used for constructing an `NRelay1` instance. */
@@ -13,6 +13,8 @@ export interface NRelay1Opts {
     verifyEvent?(event: NostrEvent): boolean;
     /** Logger callback. */
     log?(log: NRelay1Log): void;
+    /** Custom fetch function for retrieving NIP-11 relay information. Default: `globalThis.fetch`. */
+    fetch?: typeof globalThis.fetch;
 }
 export interface NRelay1Log {
     level: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal' | 'critical';
@@ -30,10 +32,17 @@ export declare class NRelay1 implements NRelay {
     private controller;
     private url;
     private opts;
+    private relayInfoPromise?;
     private ee;
     get subscriptions(): readonly NostrClientREQ[];
     private log;
     constructor(url: string, opts?: NRelay1Opts);
+    /** Fetch the NIP-11 relay information document. */
+    private fetchRelayInfo;
+    /** Get the NIP-11 relay information document. Fetches on first call and caches the result. */
+    getRelayInfo(opts?: {
+        signal?: AbortSignal;
+    }): Promise<NostrRelayInfo | undefined>;
     /** Create (and open) a WebSocket connection with automatic reconnect. */
     private createSocket;
     /** Handle a NIP-01 relay message. */

package/dist/NRelay1.d.ts.map

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