@nostrify/nostrify 0.46.4

package/dist/uploaders/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../uploaders/mod.ts"],"names":[],"mappings":";;;AAAA,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA"}

package/dist/utils/CircularSet.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Like a Circular Buffer, but the values are deduplicated.
+ * Shares the properties of both a Circular Buffer and a Set.
+ */
+export declare class CircularSet<T> {
+    private capacity;
+    private set;
+    constructor(capacity: number);
+    add(item: T): void;
+    has(item: T): boolean;
+    [Symbol.iterator](): Iterator<T>;
+}
+//# sourceMappingURL=CircularSet.d.ts.map

package/dist/utils/CircularSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircularSet.d.ts","sourceRoot":"","sources":["../../utils/CircularSet.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAW,CAAC,CAAC;IAGZ,OAAO,CAAC,QAAQ;IAF5B,OAAO,CAAC,GAAG,CAAS;gBAEA,QAAQ,EAAE,MAAM;IAIpC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAelB,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IAIrB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;CAGjC"}

package/dist/utils/CircularSet.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircularSet = void 0;
+/**
+ * Like a Circular Buffer, but the values are deduplicated.
+ * Shares the properties of both a Circular Buffer and a Set.
+ */
+class CircularSet {
+    capacity;
+    set;
+    constructor(capacity) {
+        this.capacity = capacity;
+        this.set = new Set();
+    }
+    add(item) {
+        if (this.set.has(item)) {
+            return;
+        }
+        if (this.set.size >= this.capacity) {
+            const oldest = this.set.values().next().value;
+            if (oldest) {
+                this.set.delete(oldest);
+            }
+        }
+        this.set.add(item);
+    }
+    has(item) {
+        return this.set.has(item);
+    }
+    [Symbol.iterator]() {
+        return this.set.values();
+    }
+}
+exports.CircularSet = CircularSet;
+//# sourceMappingURL=CircularSet.js.map

package/dist/utils/CircularSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircularSet.js","sourceRoot":"","sources":["../../utils/CircularSet.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,WAAW;IAGF;IAFZ,GAAG,CAAS;IAEpB,YAAoB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAClC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,GAAG,CAAC,IAAO;QACT,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,GAAG,CAAC,IAAO;QACT,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;CACF;AA7BD,kCA6BC"}

package/dist/utils/Machina.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Infinite async generator. Iterates messages pushed to it until closed.
+ * Only one consumer is expected to use a Machina instance at a time.
+ *
+ * @example
+ * ```ts
+ * // Create the Machina instance
+ * const machina = new Machina<string>();
+ *
+ * // Async generator loop
+ * async function getMessages() {
+ *   for await (const msg of machina.stream()) {
+ *     console.log(msg);
+ *   }
+ * }
+ *
+ * // Start the generator
+ * getMessages();
+ *
+ * // Push messages to it
+ * machina.push('hello!');
+ * machina.push('whats up?');
+ * machina.push('greetings');
+ * ```
+ */
+export declare class Machina<T> implements AsyncIterable<T> {
+    #private;
+    constructor(signal?: AbortSignal);
+    /** Get messages as an AsyncIterable. */
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+    /** Push a message into the Machina instance, making it available to the consumer of `stream()`. */
+    push(data: T): void;
+    /** Stops streaming and throws an error to the consumer. */
+    private abort;
+}
+//# sourceMappingURL=Machina.d.ts.map

package/dist/utils/Machina.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Machina.d.ts","sourceRoot":"","sources":["../../utils/Machina.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,OAAO,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;;gBAKrC,MAAM,CAAC,EAAE,WAAW;IAQhC,wCAAwC;IACjC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;IAejD,mGAAmG;IACnG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAKnB,2DAA2D;IAC3D,OAAO,CAAC,KAAK;CAId"}

package/dist/utils/Machina.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Machina = void 0;
+/**
+ * Infinite async generator. Iterates messages pushed to it until closed.
+ * Only one consumer is expected to use a Machina instance at a time.
+ *
+ * @example
+ * ```ts
+ * // Create the Machina instance
+ * const machina = new Machina<string>();
+ *
+ * // Async generator loop
+ * async function getMessages() {
+ *   for await (const msg of machina.stream()) {
+ *     console.log(msg);
+ *   }
+ * }
+ *
+ * // Start the generator
+ * getMessages();
+ *
+ * // Push messages to it
+ * machina.push('hello!');
+ * machina.push('whats up?');
+ * machina.push('greetings');
+ * ```
+ */
+class Machina {
+    #queue = [];
+    #resolve;
+    #aborted = false;
+    constructor(signal) {
+        if (signal?.aborted) {
+            this.abort();
+        }
+        else {
+            signal?.addEventListener('abort', () => this.abort(), { once: true });
+        }
+    }
+    /** Get messages as an AsyncIterable. */
+    async *[Symbol.asyncIterator]() {
+        while (!this.#aborted) {
+            if (this.#queue.length) {
+                yield this.#queue.shift();
+                continue;
+            }
+            await new Promise((_resolve) => {
+                this.#resolve = _resolve;
+            });
+        }
+        throw new DOMException('The signal has been aborted', 'AbortError');
+    }
+    /** Push a message into the Machina instance, making it available to the consumer of `stream()`. */
+    push(data) {
+        this.#queue.push(data);
+        this.#resolve?.();
+    }
+    /** Stops streaming and throws an error to the consumer. */
+    abort() {
+        this.#aborted = true;
+        this.#resolve?.();
+    }
+}
+exports.Machina = Machina;
+//# sourceMappingURL=Machina.js.map

package/dist/utils/Machina.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Machina.js","sourceRoot":"","sources":["../../utils/Machina.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAa,OAAO;IAClB,MAAM,GAAQ,EAAE,CAAC;IACjB,QAAQ,CAA2B;IACnC,QAAQ,GAAG,KAAK,CAAC;IAEjB,YAAY,MAAoB;QAC9B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACvB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAO,CAAC;gBAC/B,SAAS;YACX,CAAC;YAED,MAAM,IAAI,OAAO,CAAO,CAAC,QAAQ,EAAE,EAAE;gBACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAC3B,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,YAAY,CAAC,6BAA6B,EAAE,YAAY,CAAC,CAAC;IACtE,CAAC;IAED,mGAAmG;IACnG,IAAI,CAAC,IAAO;QACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;IACpB,CAAC;IAED,2DAA2D;IACnD,KAAK;QACX,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;IACpB,CAAC;CACF;AAxCD,0BAwCC"}

package/dist/utils/N64.d.ts

@@ -0,0 +1,9 @@
+import { NostrEvent } from '@nostrify/types';
+/** Nostr base64 helper utilities. */
+export declare class N64 {
+    /** Encode an event as a base64 string. */
+    static encodeEvent(event: NostrEvent): string;
+    /** Decode an event from a base64 string. Validates the event's structure but does not verify its signature. */
+    static decodeEvent(base64: string): NostrEvent;
+}
+//# sourceMappingURL=N64.d.ts.map

package/dist/utils/N64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"N64.d.ts","sourceRoot":"","sources":["../../utils/N64.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK7C,qCAAqC;AACrC,qBAAa,GAAG;IACd,0CAA0C;IAC1C,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAI7C,+GAA+G;IAC/G,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;CAS/C"}

package/dist/utils/N64.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.N64 = void 0;
+const base64_1 = require("@std/encoding/base64");
+const NSchema_1 = require("../NSchema");
+/** Nostr base64 helper utilities. */
+class N64 {
+    /** Encode an event as a base64 string. */
+    static encodeEvent(event) {
+        return (0, base64_1.encodeBase64)(JSON.stringify(event));
+    }
+    /** Decode an event from a base64 string. Validates the event's structure but does not verify its signature. */
+    static decodeEvent(base64) {
+        const bytes = (0, base64_1.decodeBase64)(base64);
+        const text = new TextDecoder().decode(bytes);
+        return NSchema_1.NSchema
+            .json()
+            .pipe(NSchema_1.NSchema.event())
+            .parse(text);
+    }
+}
+exports.N64 = N64;
+//# sourceMappingURL=N64.js.map

package/dist/utils/N64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"N64.js","sourceRoot":"","sources":["../../utils/N64.ts"],"names":[],"mappings":";;;AACA,iDAAkE;AAElE,wCAA0C;AAE1C,qCAAqC;AACrC,MAAa,GAAG;IACd,0CAA0C;IAC1C,MAAM,CAAC,WAAW,CAAC,KAAiB;QAClC,OAAO,IAAA,qBAAY,EAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,+GAA+G;IAC/G,MAAM,CAAC,WAAW,CAAC,MAAc;QAC/B,MAAM,KAAK,GAAG,IAAA,qBAAY,EAAC,MAAM,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE7C,OAAO,iBAAC;aACL,IAAI,EAAE;aACN,IAAI,CAAC,iBAAC,CAAC,KAAK,EAAE,CAAC;aACf,KAAK,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;CACF;AAhBD,kBAgBC"}

package/dist/utils/mod.d.ts

@@ -0,0 +1,3 @@
+export { Machina } from './Machina';
+export { N64 } from './N64';
+//# sourceMappingURL=mod.d.ts.map

package/dist/utils/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../utils/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC"}

package/dist/utils/mod.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.N64 = exports.Machina = void 0;
+var Machina_1 = require("./Machina");
+Object.defineProperty(exports, "Machina", { enumerable: true, get: function () { return Machina_1.Machina; } });
+var N64_1 = require("./N64");
+Object.defineProperty(exports, "N64", { enumerable: true, get: function () { return N64_1.N64; } });
+//# sourceMappingURL=mod.js.map

package/dist/utils/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../utils/mod.ts"],"names":[],"mappings":";;;AAAA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,6BAA4B;AAAnB,0FAAA,GAAG,OAAA"}

package/ln/LNURL.test.ts

@@ -0,0 +1,87 @@
+import { assertEquals } from '@std/assert';
+
+import { LNURL } from './LNURL.ts';
+
+// deno-lint-ignore require-await
+const mockFetch: typeof globalThis.fetch = async (input, init) => {
+  const { url } = new Request(input, init);
+  switch (url) {
+    case 'https://getalby.com/.well-known/lnurlp/alexgleason':
+      return new Response(JSON.stringify({
+        status: 'OK',
+        tag: 'payRequest',
+        commentAllowed: 255,
+        callback: 'https://getalby.com/lnurlp/alexgleason/callback',
+        metadata: '[["text/identifier","alexgleason@getalby.com"],["text/plain","Sats for alexgleason"]]',
+        minSendable: 1000,
+        maxSendable: 100000000,
+        payerData: {
+          name: { mandatory: false },
+          email: { mandatory: false },
+          pubkey: { mandatory: false },
+        },
+        nostrPubkey: '79f00d3f5a19ec806189fcab03c1be4ff81d18ee4f653c88fac41fe03570f432',
+        allowsNostr: true,
+      }));
+    case 'https://getalby.com/lnurlp/alexgleason/callback?amount=1000&lnurl=lnurl1dp68gurn8ghj7em9w3skccne9e3k7mf09emk2mrv944kummhdchkcmn4wfk8qtmpd3jhsemvv4shxmmw5uhvxu':
+      return new Response(JSON.stringify({
+        status: 'OK',
+        successAction: { tag: 'message', message: 'Thanks, sats received!' },
+        verify: 'https://getalby.com/lnurlp/alexgleason/verify/sMgdHth68xnS5H1tJtL4kh3T',
+        routes: [],
+        pr:
+          'lnbc10n1pj6a3pmpp54wsjl3nscygnfsf6uy08cnlf94t64a7cr0pt3t6nmdzm4kq8x6yshp5nf3ugrnz5d5fc5avnrzu8m9ae3e7p4v82cyhtf425dmtv8fn755qcqzzsxqyz5vqsp5m9d6yrj9mu5wwk3kxfdn4hwwmztdjqvdc3z5402gwdc6janx4ltq9qyyssq36wz68vj35pr39e8hkq0ldfauglqfsfyw9u0u4v4dmy7hvg20244jm69ja4g0cmwzxxgmzrqqsgeenxzmsqwhpfrzk7dvezd60u0qcqpd6nhs7',
+      }));
+    default:
+      throw new Error(`Unexpected URL: ${url}`);
+  }
+};
+
+Deno.test('LNURL', async (t) => {
+  await t.step('fromString', () => {
+    const lnurl = LNURL.fromString(
+      'lnurl1dp68gurn8ghj7em9w3skccne9e3k7mf09emk2mrv944kummhdchkcmn4wfk8qtmpd3jhsemvv4shxmmw5uhvxu',
+    );
+    assertEquals(lnurl.url.toString(), 'https://getalby.com/.well-known/lnurlp/alexgleason');
+  });
+
+  await t.step('fromLightningAddress', () => {
+    const lnurl = LNURL.fromLightningAddress('alexgleason@getalby.com');
+    assertEquals(lnurl.url.toString(), 'https://getalby.com/.well-known/lnurlp/alexgleason');
+  });
+
+  await t.step('toString', () => {
+    const lnurl = new LNURL(new URL('https://getalby.com/.well-known/lnurlp/alexgleason'));
+    assertEquals(
+      lnurl.toString(),
+      'lnurl1dp68gurn8ghj7em9w3skccne9e3k7mf09emk2mrv944kummhdchkcmn4wfk8qtmpd3jhsemvv4shxmmw5uhvxu',
+    );
+  });
+
+  await t.step('getDetails', async () => {
+    const lnurl = new LNURL(new URL('https://getalby.com/.well-known/lnurlp/alexgleason'), { fetch: mockFetch });
+    const details = await lnurl.getDetails();
+
+    assertEquals(details, {
+      tag: 'payRequest',
+      commentAllowed: 255,
+      callback: 'https://getalby.com/lnurlp/alexgleason/callback',
+      metadata: '[["text/identifier","alexgleason@getalby.com"],["text/plain","Sats for alexgleason"]]',
+      minSendable: 1000,
+      maxSendable: 100000000,
+      nostrPubkey: '79f00d3f5a19ec806189fcab03c1be4ff81d18ee4f653c88fac41fe03570f432',
+      allowsNostr: true,
+    });
+  });
+
+  await t.step('getInvoice', async () => {
+    const lnurl = new LNURL(new URL('https://getalby.com/.well-known/lnurlp/alexgleason'), { fetch: mockFetch });
+    const invoice = await lnurl.getInvoice({ amount: 1000 });
+
+    assertEquals(invoice, {
+      pr:
+        'lnbc10n1pj6a3pmpp54wsjl3nscygnfsf6uy08cnlf94t64a7cr0pt3t6nmdzm4kq8x6yshp5nf3ugrnz5d5fc5avnrzu8m9ae3e7p4v82cyhtf425dmtv8fn755qcqzzsxqyz5vqsp5m9d6yrj9mu5wwk3kxfdn4hwwmztdjqvdc3z5402gwdc6janx4ltq9qyyssq36wz68vj35pr39e8hkq0ldfauglqfsfyw9u0u4v4dmy7hvg20244jm69ja4g0cmwzxxgmzrqqsgeenxzmsqwhpfrzk7dvezd60u0qcqpd6nhs7',
+      routes: [],
+    });
+  });
+});

package/ln/LNURL.ts

@@ -0,0 +1,146 @@
+import { NostrEvent } from "@nostrify/types";
+import { bech32 } from "@scure/base";
+
+import { LNURLCallback } from "./types/LNURLCallback";
+import { LNURLDetails } from "./types/LNURLDetails";
+
+import { NSchema as n, z } from "../NSchema";
+
+/**
+ * Represents an LNURL, with methods to fetch details and generate invoices.
+ */
+export class LNURL {
+  /** Underlying HTTP(s) URL of the user. */
+  readonly url: URL;
+  /** Fetch function to use for HTTP requests. */
+  private fetch: typeof globalThis.fetch;
+
+  constructor(
+    /** Underlying HTTP(s) URL of the user. */
+    url: URL,
+    /** Options for the LNURL class. */
+    opts?: {
+      /** Fetch function to use for HTTP requests. */
+      fetch: typeof globalThis.fetch;
+    },
+  ) {
+    this.url = url;
+    this.fetch = opts?.fetch ?? globalThis.fetch.bind(globalThis);
+  }
+
+  /**
+   * Create an LNURL object from a bech32 `lnurl1...` string.
+   * Throws if the value is not a valid lnurl.
+   */
+  static fromString(
+    value: string,
+    opts?: { fetch: typeof globalThis.fetch },
+  ): LNURL {
+    if (!n.bech32().safeParse(value).success) {
+      throw new Error('Expected a bech32 string starting with "lnurl1"');
+    }
+
+    const { prefix, words } = bech32.decode(
+      value as `${string}1${string}`,
+      20000,
+    );
+
+    if (prefix !== "lnurl") {
+      throw new Error('Expected a bech32 string starting with "lnurl1"');
+    }
+
+    const data = bech32.fromWords(words);
+    const url = new URL(new TextDecoder().decode(data));
+
+    return new LNURL(url, opts);
+  }
+
+  /**
+   * Create an LNURL object from a lightning address (email-like format).
+   * Throws if the value is not a valid lightning address.
+   */
+  static fromLightningAddress(
+    ln: string,
+    opts?: { fetch: typeof globalThis.fetch },
+  ): LNURL {
+    if (!z.string().email().safeParse(ln).success) {
+      throw new Error(
+        'Expected a lightning address in email-like format (eg "example@getalby.com")',
+      );
+    }
+
+    const [name, host] = ln.split("@");
+    const url = new URL(`/.well-known/lnurlp/${name}`, `https://${host}`);
+
+    return new LNURL(url, opts);
+  }
+
+  /** Returns the LNURL object as a bech32-encoded `lnurl1...` string. */
+  toString(): `lnurl1${string}` {
+    const data = new TextEncoder().encode(this.url.toString());
+    const words = bech32.toWords(data);
+    return bech32.encode("lnurl", words, 20000);
+  }
+
+  /** Resolve an LNURL to its details. */
+  async getDetails(opts?: { signal?: AbortSignal }): Promise<LNURLDetails> {
+    const response = await this.fetch(this.url, opts);
+    const json = await response.json();
+    return LNURL.lnurlDetailsSchema().parse(json);
+  }
+
+  /** Generate an LNURL invoice from the params. */
+  async getInvoice(opts: {
+    /** Amount in millisatoshis to send to the user. */
+    amount: number;
+    /** NIP-57 Zap Request (kind 9734) event. */
+    nostr?: NostrEvent;
+    /** Signal to abort the request. */
+    signal?: AbortSignal;
+  }): Promise<LNURLCallback> {
+    const details = await this.getDetails(opts);
+    const callback = new URL(details.callback);
+
+    callback.searchParams.set("amount", opts.amount.toString());
+    callback.searchParams.set("lnurl", this.toString());
+
+    if (opts.nostr) {
+      callback.searchParams.set("nostr", JSON.stringify(opts.nostr));
+    }
+
+    const response = await this.fetch(callback, opts);
+    const json = await response.json();
+
+    return LNURL.lnurlCallbackSchema().parse(json);
+  }
+
+  /** LNURL response schema. */
+  static lnurlDetailsSchema(): z.ZodType<LNURLDetails> {
+    return z.object({
+      allowsNostr: z.boolean().optional(),
+      callback: z.string().url(),
+      commentAllowed: z.number().nonnegative().int().optional(),
+      maxSendable: z.number().positive().int(),
+      minSendable: z.number().positive().int(),
+      metadata: z.string(),
+      nostrPubkey: n.id().optional(),
+      tag: z.literal("payRequest"),
+    }).superRefine((details, ctx) => {
+      if (details.minSendable > details.maxSendable) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          message: "minSendable must be less than or equal to maxSendable",
+          path: ["minSendable"],
+        });
+      }
+    }) as z.ZodType<LNURLDetails>;
+  }
+
+  /** LNURL callback schema. */
+  static lnurlCallbackSchema(): z.ZodType<LNURLCallback> {
+    return z.object({
+      pr: n.bech32("lnbc"),
+      routes: z.tuple([]),
+    }) as unknown as z.ZodType<LNURLCallback>;
+  }
+}

package/ln/mod.ts

@@ -0,0 +1,4 @@
+export { LNURL } from './LNURL';
+
+export type { LNURLCallback } from './types/LNURLCallback';
+export type { LNURLDetails } from './types/LNURLDetails';

package/ln/types/LNURLCallback.ts

@@ -0,0 +1,7 @@
+/** LNURL callback response, as defined by LUD-06. */
+export interface LNURLCallback {
+  /** bech32-serialized lightning invoice. */
+  pr: `lnbc1${string}`;
+  /** An empty array. */
+  routes: [];
+}

package/ln/types/LNURLDetails.ts

@@ -0,0 +1,19 @@
+/** LNURL `payRequest` details, as defined by LUD-06. Includes additional properties from NIP-57. */
+export interface LNURLDetails {
+  /** Whether the LN SERVICE supports NIP-57 Lightning Zaps. */
+  allowsNostr?: boolean;
+  /** The URL from LN SERVICE which will accept the pay request parameters. */
+  callback: string;
+  /** The number of characters accepted for the `comment` query parameter on subsequent callback. (Should be interpreted as 0 if not provided). */
+  commentAllowed?: number;
+  /** Max millisatoshi amount LN SERVICE is willing to receive. */
+  maxSendable: number;
+  /** Min millisatoshi amount LN SERVICE is willing to receive, can not be less than 1 or more than `maxSendable`. */
+  minSendable: number;
+  /** Metadata json which must be presented as raw string here, this is required to pass signature verification at a later step. */
+  metadata: string;
+  /** The Nostr pubkey LN SERVICE will use to sign zap receipt events. Clients will use this to validate zap receipts. */
+  nostrPubkey?: string;
+  /** Type of LNURL. */
+  tag: 'payRequest';
+}

package/mod.ts

@@ -0,0 +1,16 @@
+export { BunkerURI } from './BunkerURI';
+export { NBrowserSigner } from './NBrowserSigner';
+export { NCache } from './NCache';
+export { NConnectSigner, type NConnectSignerOpts } from './NConnectSigner';
+export { NIP05 } from './NIP05';
+export { NIP50 } from './NIP50';
+export { NIP98 } from './NIP98';
+export { NKinds } from './NKinds';
+export { NPool, type NPoolOpts } from './NPool';
+export { NRelay1, type NRelay1Opts } from './NRelay1';
+export { NSchema } from './NSchema';
+export { NSecSigner } from './NSecSigner';
+export { NSet } from './NSet';
+export { RelayError } from './RelayError';
+
+export type * from '@nostrify/types';

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@nostrify/nostrify",
+  "version": "0.46.4",
+  "exports": {
+    ".": "./mod.ts",
+    "./ln": "./ln/mod.ts",
+    "./test": "./test/mod.ts",
+    "./uploaders": "./uploaders/mod.ts",
+    "./utils": "./utils/mod.ts"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "ws": "^8.18.3",
+    "@nostrify/types": "0.36.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}

package/test/ErrorRelay.test.ts

@@ -0,0 +1,19 @@
+import { genEvent } from '@nostrify/nostrify/test';
+import { assertRejects } from '@std/assert';
+
+import { ErrorRelay } from './ErrorRelay.ts';
+
+Deno.test('ErrorRelay', async () => {
+  const store = new ErrorRelay();
+  await assertRejects(() => store.event(genEvent()));
+  await assertRejects(() => store.query([]));
+  await assertRejects(() => store.count([]));
+  await assertRejects(() => store.remove([]));
+  await assertRejects(() => store.close());
+
+  await assertRejects(async () => {
+    for await (const _ of store.req([])) {
+      // Do nothing.
+    }
+  });
+});

package/test/ErrorRelay.ts

@@ -0,0 +1,40 @@
+// deno-lint-ignore-file require-await require-yield
+import {
+  NostrEvent,
+  NostrFilter,
+  NostrRelayCLOSED,
+  NostrRelayCOUNT,
+  NostrRelayEOSE,
+  NostrRelayEVENT,
+  NRelay,
+} from '@nostrify/types';
+
+/** A relay storage class that intentionally throws errors for every method. */
+export class ErrorRelay implements NRelay {
+  async *req(
+    _filters: NostrFilter[],
+    _opts?: { signal?: AbortSignal },
+  ): AsyncIterable<NostrRelayEVENT | NostrRelayEOSE | NostrRelayCLOSED> {
+    throw new Error('This error is intentional.');
+  }
+
+  async event(_event: NostrEvent, _opts?: { signal?: AbortSignal }): Promise<void> {
+    throw new Error('This error is intentional.');
+  }
+
+  async query(_filters: NostrFilter[], _opts?: { signal?: AbortSignal }): Promise<NostrEvent[]> {
+    throw new Error('This error is intentional.');
+  }
+
+  async count(_filters: NostrFilter[], _opts?: { signal?: AbortSignal }): Promise<NostrRelayCOUNT[2]> {
+    throw new Error('This error is intentional.');
+  }
+
+  async remove(_filters: NostrFilter[], _opts?: { signal?: AbortSignal }): Promise<void> {
+    throw new Error('This error is intentional.');
+  }
+
+  async close(): Promise<void> {
+    throw new Error('This error is intentional.');
+  }
+}

package/test/MockRelay.test.ts

@@ -0,0 +1,20 @@
+import { assertEquals } from '@std/assert';
+
+import { MockRelay } from './MockRelay.ts';
+
+import event1 from '../../../fixtures/event-1.json' with { type: 'json' };
+
+Deno.test('MockRelay', async () => {
+  const relay = new MockRelay();
+
+  assertEquals(await relay.count([{ ids: [event1.id] }]), { count: 0, approximate: false });
+
+  await relay.event(event1);
+
+  assertEquals(await relay.count([{ ids: [event1.id] }]), { count: 1, approximate: false });
+
+  const result = await relay.query([{ ids: [event1.id] }]);
+  assertEquals(result[0], event1);
+
+  assertEquals(relay.subs.size, 0); // cleanup
+});