@nostrify/nostrify 0.49.1 → 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.8kb
-  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 18ms
+⚡ Done in 16ms
 Done!

package/.turbo/turbo-test.log

@@ -1,113 +1,113 @@
-
-
-> @nostrify/nostrify@0.49.0 test /home/alex/Projects/nostrify/packages/nostrify
-> node --test "**/*.test.ts"
-
-✔ BunkerURI (6.500947ms)
-✔ BunkerURI.fromJSON (0.697366ms)
-✔ NBrowserSigner - without extension (6.845626ms)
-✔ NBrowserSigner - with extension polyfill (145.570371ms)
-✔ NBrowserSigner.nip44 - with extension polyfill (41.798097ms)
-✔ NBrowserSigner.nip04 - with extension polyfill (24.715886ms)
-✔ NBrowserSigner.getRelays - with extension polyfill (1.481235ms)
-✔ NBrowserSigner - missing nip44 support (0.488973ms)
-✔ NBrowserSigner - missing nip04 support (0.305216ms)
-✔ NBrowserSigner - feature detection (0.494443ms)
-✔ NCache (4.851615ms)
-✔ NConnectSigner.signEvent with nip04 encryption (263.040731ms)
-✔ NConnectSigner.signEvent with nip44 encryption (65.206185ms)
-✔ NIP05.lookup (66.927232ms)
-✔ NIP05.lookup with invalid values but valid profile pointer (6.26454ms)
-✔ NIP05.lookup with invalid document (6.817544ms)
-✔ NIP50.parseInput (3.842521ms)
-✔ NIP50.parseInput with negated token (0.457102ms)
-✔ NIP98.template (5.687631ms)
-✔ NIP98.template with payload (26.300896ms)
-✔ NIP98.verify (133.933063ms)
-✔ NIP98.verify fails with missing header (2.675358ms)
-✔ NIP98.verify fails with missing token (1.837347ms)
-✔ NIP98.verify fails with invalid token (1.68541ms)
-✔ NIP98.verify fails with invalid event (22.562873ms)
-✔ NIP98.verify fails with wrong event kind (25.930437ms)
-✔ NIP98.verify fails with wrong request URL (18.756591ms)
-✔ NIP98.verify fails with wrong request method (26.4621ms)
-✔ NIP98.verify fails with expired event (12.038465ms)
-✔ NIP98.verify fails with invalid payload (30.221524ms)
-✔ NIP98Client.fetch - basic GET request (154.787833ms)
-✔ NIP98Client.fetch - POST request with body (47.56551ms)
-✔ NIP98Client.fetch - with Request object input (24.533651ms)
-✔ NIP98Client.fetch - with URL object input (18.555061ms)
-✔ NIP98Client.fetch - uses default fetch when not provided (5.830762ms)
-✔ NIP98Client.fetch - preserves existing headers (7.498448ms)
-✔ NIP98Client.fetch - event can be verified with NIP98.verify (23.18142ms)
-✔ NIP98Client.fetch - handles different HTTP methods (54.413802ms)
-✔ NKinds (2.313314ms)
-✔ NPool.query (304.805977ms)
-✔ NPool.req (71.883744ms)
-✔ NPool.event (36.152295ms)
-✔ NPool.query with eoseTimeout (556.472837ms)
-✔ NPool.query with eoseTimeout disabled (518.148304ms)
-✔ NRelay1.query (214.373313ms)
-✔ NRelay1.query mismatched filter (26.656267ms)
-✔ NRelay1.req (62.61191ms)
-✔ NRelay1.event (15.013378ms)
-﹣ NRelay1 backoff (0.284747ms) # SKIP
-▶ NRelay1 idleTimeout
-  ✔ websocket opens (2.521237ms)
-  ✔ websocket closes after idleTimeout (150.608267ms)
-  ✔ websocket wakes up during activity (18.683393ms)
-✔ NRelay1 idleTimeout (174.927484ms)
-✔ NRelay1.count rejects when the server sends CLOSED (8.603564ms)
-✔ NRelay1 closes when it receives a binary message (6.617717ms)
-✔ n.id (13.522796ms)
-✔ n.bech32 (3.250493ms)
-✔ n.filter (54.632765ms)
-✔ n.event (59.738558ms)
-✔ n.metadata (111.976204ms)
-✔ NSecSigner (139.725132ms)
-✔ NSecSigner.nip44 (46.61682ms)
-✔ NSet (19.968067ms)
-✔ NSet.add (replaceable) (0.543556ms)
-✔ NSet.add (parameterized) (0.852168ms)
-✔ NSet.add (deletion) (0.422317ms)
-✔ Construct a RelayError from the reason message (2.066149ms)
-✔ Throw a new RelayError if the OK message is false (0.523077ms)
-✔ LNURL.fromString (13.596875ms)
-✔ LNURL.fromLightningAddress (1.670752ms)
-✔ LNURL.toString (1.414138ms)
-✔ LNURL.getDetails (125.620408ms)
-✔ LNURL.getInvoice (14.385975ms)
-✔ ErrorRelay (102.691184ms)
-✔ MockRelay (3.336506ms)
-✔ BlossomUploader.upload (643.516025ms)
-✖ NostrBuildUploader.upload (12.243372ms)
-✔ CircularSet (2.656663ms)
-✔ push, iterate, & close (103.126316ms)
-✔ close & reopen (0.403963ms)
-✔ aborts with signal (51.238249ms)
-✔ already aborted signal in constructor (0.399534ms)
-✔ push after abort (0.518148ms)
-✔ multiple messages in queue (0.23852ms)
-✔ N64 (8.766331ms)
-✔ N64.encodeEvent (0.227118ms)
-✔ N64.decodeEvent (1.617352ms)
-ℹ tests 87
-ℹ suites 0
-ℹ pass 85
-ℹ fail 1
-ℹ cancelled 0
-ℹ skipped 1
-ℹ todo 0
-ℹ duration_ms 3151.150695
-
-✖ failing tests:
-
-test at uploaders/NostrBuildUploader.test.ts:12:7
-✖ NostrBuildUploader.upload (12.243372ms)
-  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,17 @@
 # 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
+
+- Simplify NSchema by removing explicit zod type annotations and leveraging type inference
+
 ## 0.49.1
 
 ### 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(