@qntx/nostr 0.0.1

package/dist/nips/nip05.mjs

@@ -0,0 +1,147 @@
+import { a as isHex32 } from "../util-6tfLQ9JF.mjs";
+import { a as NostrError } from "../error-DZEs5OuZ.mjs";
+import { n as requireGlobalFetch, t as fetchManual } from "../http-D2rhokZo.mjs";
+//#region src/nips/nip05.ts
+/**
+* NIP-05: Mapping Nostr keys to DNS-based internet identifiers
+* @see https://github.com/nostr-protocol/nips/blob/master/05.md
+*/
+/** Root local-part (`_@domain` rendered as just the domain). */
+const NIP05_ROOT_LOCAL = "_";
+const WELL_KNOWN_PATH = "/.well-known/nostr.json";
+var Nip05Error = class extends NostrError {
+	constructor(message, options) {
+		super(message, options);
+	}
+};
+/**
+* Matches optional local@domain.
+* Groups: 1=local (optional), 2=domain.
+*/
+const NIP05_REGEX = /^(?:([\w.+-]+)@)?([\w-]+(?:\.[\w-]+)+)$/;
+function isNip05(value) {
+	return typeof value === "string" && NIP05_REGEX.test(value);
+}
+/**
+* Parse an identifier into local + domain.
+* Accepts `name@domain`, `_@domain`, or bare `domain` (local becomes `_`).
+*/
+function parseNip05(input) {
+	const match = input.trim().match(NIP05_REGEX);
+	if (!match?.[2]) throw new Nip05Error(`invalid NIP-05 identifier: ${input}`);
+	const localRaw = match[1] ?? "_";
+	const local = localRaw.toLowerCase();
+	const domain = match[2].toLowerCase();
+	if (!/^[a-z0-9._-]+$/.test(local)) throw new Nip05Error(`invalid NIP-05 local-part: ${localRaw}`);
+	if (!domain) throw new Nip05Error("NIP-05 domain must not be empty");
+	return {
+		local,
+		domain
+	};
+}
+/** Build the well-known HTTPS URL for an address. */
+function wellKnownUrl(address) {
+	const url = new URL(`https://${address.domain}${WELL_KNOWN_PATH}`);
+	url.searchParams.set("name", address.local);
+	return url.toString();
+}
+function stringUrls(list) {
+	if (!Array.isArray(list)) return void 0;
+	return list.filter((u) => typeof u === "string" && u.length > 0);
+}
+/**
+* Parse nostr.json `nip46`: 46.md appendix `{relays, nostrconnect_url}`.
+* Hex-pubkey maps and other keys are ignored.
+*/
+function parseNip05Nip46(raw) {
+	if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+	const obj = raw;
+	const result = {};
+	if (Array.isArray(obj.relays)) result.relays = stringUrls(obj.relays) ?? [];
+	if (typeof obj.nostrconnect_url === "string" && obj.nostrconnect_url.length > 0) result.nostrconnectUrl = obj.nostrconnect_url;
+	if (result.relays === void 0 && result.nostrconnectUrl === void 0) return;
+	return result;
+}
+/** Parse and validate a nostr.json document body. */
+function parseNip05Document(json) {
+	if (!json || typeof json !== "object") throw new Nip05Error("NIP-05 document must be a JSON object");
+	const raw = json;
+	if (!raw.names || typeof raw.names !== "object" || Array.isArray(raw.names)) throw new Nip05Error("NIP-05 document missing names map");
+	const names = {};
+	for (const [k, v] of Object.entries(raw.names)) {
+		if (typeof v !== "string" || !isHex32(v)) continue;
+		names[k.toLowerCase()] = v.toLowerCase();
+	}
+	let relays;
+	if (raw.relays && typeof raw.relays === "object" && !Array.isArray(raw.relays)) {
+		relays = {};
+		for (const [pk, list] of Object.entries(raw.relays)) {
+			if (!isHex32(pk)) continue;
+			const urls = stringUrls(list);
+			if (urls?.length) relays[pk.toLowerCase()] = urls;
+		}
+	}
+	return {
+		names,
+		relays,
+		nip46: parseNip05Nip46(raw.nip46)
+	};
+}
+/** Resolve local name from an already-parsed document. */
+function lookupFromDocument(doc, address) {
+	const pubkey = doc.names[address.local];
+	if (!pubkey) return void 0;
+	const relays = doc.relays?.[pubkey];
+	return relays?.length ? {
+		pubkey,
+		relays: [...relays]
+	} : { pubkey };
+}
+/**
+* Fetch and parse `/.well-known/nostr.json`.
+* Returns `null` on network/parse failure (does not throw for those).
+* Rejects HTTP redirects (non-200) per NIP-05 security constraints.
+* AbortError rethrows; it is not mapped to `null`.
+*/
+async function queryNip05Document(identifier, opts) {
+	let address;
+	try {
+		address = parseNip05(identifier);
+	} catch {
+		return null;
+	}
+	const url = wellKnownUrl(address);
+	const fetchImpl = opts?.fetch ?? requireGlobalFetch(() => new Nip05Error("no fetch implementation available; pass opts.fetch"));
+	try {
+		const res = await fetchManual(fetchImpl, url, { signal: opts?.signal }, (err) => err instanceof Error ? err : /* @__PURE__ */ new Error("NIP-05 request failed"));
+		if (res.status !== 200) return null;
+		const json = await res.json();
+		return {
+			address,
+			doc: parseNip05Document(json)
+		};
+	} catch (err) {
+		if (err instanceof Error && err.name === "AbortError") throw err;
+		return null;
+	}
+}
+/**
+* Query `/.well-known/nostr.json` for an identifier.
+* Returns `null` on network/parse/lookup failure (does not throw for those).
+* Profile `relays` only. `nip46` is discovery metadata, not a bunker pointer.
+*/
+async function queryProfile(identifier, opts) {
+	const fetched = await queryNip05Document(identifier, opts);
+	if (!fetched) return null;
+	return lookupFromDocument(fetched.doc, fetched.address) ?? null;
+}
+/** True when the identifier resolves to exactly `pubkey`. */
+async function verifyNip05(pubkey, identifier, opts) {
+	if (!isHex32(pubkey)) return false;
+	const profile = await queryProfile(identifier, opts);
+	return profile !== null && profile.pubkey === pubkey.toLowerCase();
+}
+//#endregion
+export { NIP05_REGEX, NIP05_ROOT_LOCAL, Nip05Error, WELL_KNOWN_PATH, isNip05, lookupFromDocument, parseNip05, parseNip05Document, parseNip05Nip46, queryNip05Document, queryProfile, verifyNip05, wellKnownUrl };
+
+//# sourceMappingURL=nip05.mjs.map

package/dist/nips/nip05.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip05.mjs","names":[],"sources":["../../src/nips/nip05.ts"],"sourcesContent":["/**\n * NIP-05: Mapping Nostr keys to DNS-based internet identifiers\n * @see https://github.com/nostr-protocol/nips/blob/master/05.md\n */\nimport { NostrError } from \"../core/error.ts\";\nimport { isHex32 } from \"../core/util.ts\";\nimport { fetchManual, requireGlobalFetch, type ManualFetch } from \"./http.ts\";\nimport type { ProfilePointer } from \"./nip19.ts\";\n\n/** Root local-part (`_@domain` rendered as just the domain). */\nexport const NIP05_ROOT_LOCAL = \"_\";\n\nexport const WELL_KNOWN_PATH = \"/.well-known/nostr.json\";\n\n/**\n * NIP-05 identifier string.\n * - Full: `name@domain`\n * - Root: `domain` or `_@domain`\n */\nexport type Nip05 = string;\n\nexport type Nip05Address = {\n  /** Local part (lowercased). `_` for domain-only identifiers. */\n  local: string;\n  /** Domain (lowercased). */\n  domain: string;\n};\n\n/**\n * 46.md appendix discovery metadata (`{relays, nostrconnect_url}`).\n * Not a bunker pointer.\n */\nexport type Nip05Nip46 = {\n  relays?: string[];\n  nostrconnectUrl?: string;\n};\n\nexport type Nip05Document = {\n  names: Record<string, string>;\n  /** NIP-05 profile relay hints */\n  relays?: Record<string, string[]>;\n  nip46?: Nip05Nip46;\n};\n\nexport type Nip05Fetch = ManualFetch;\n\nexport class Nip05Error extends NostrError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n  }\n}\n\n/**\n * Matches optional local@domain.\n * Groups: 1=local (optional), 2=domain.\n */\nexport const NIP05_REGEX = /^(?:([\\w.+-]+)@)?([\\w-]+(?:\\.[\\w-]+)+)$/;\n\nexport function isNip05(value: unknown): value is string {\n  return typeof value === \"string\" && NIP05_REGEX.test(value);\n}\n\n/**\n * Parse an identifier into local + domain.\n * Accepts `name@domain`, `_@domain`, or bare `domain` (local becomes `_`).\n */\nexport function parseNip05(input: string): Nip05Address {\n  const match = input.trim().match(NIP05_REGEX);\n  if (!match?.[2]) {\n    throw new Nip05Error(`invalid NIP-05 identifier: ${input}`);\n  }\n  const localRaw = match[1] ?? NIP05_ROOT_LOCAL;\n  const local = localRaw.toLowerCase();\n  const domain = match[2].toLowerCase();\n\n  // NIP-05 local-part: a-z0-9-_.\n  if (!/^[a-z0-9._-]+$/.test(local)) {\n    throw new Nip05Error(`invalid NIP-05 local-part: ${localRaw}`);\n  }\n  if (!domain) {\n    throw new Nip05Error(\"NIP-05 domain must not be empty\");\n  }\n\n  return { local, domain };\n}\n\n/** Build the well-known HTTPS URL for an address. */\nexport function wellKnownUrl(address: Nip05Address): string {\n  const url = new URL(`https://${address.domain}${WELL_KNOWN_PATH}`);\n  url.searchParams.set(\"name\", address.local);\n  return url.toString();\n}\n\nfunction stringUrls(list: unknown): string[] | undefined {\n  if (!Array.isArray(list)) return undefined;\n  return list.filter((u): u is string => typeof u === \"string\" && u.length > 0);\n}\n\n/**\n * Parse nostr.json `nip46`: 46.md appendix `{relays, nostrconnect_url}`.\n * Hex-pubkey maps and other keys are ignored.\n */\nexport function parseNip05Nip46(raw: unknown): Nip05Nip46 | undefined {\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) return undefined;\n  const obj = raw as Record<string, unknown>;\n  const result: Nip05Nip46 = {};\n\n  if (Array.isArray(obj.relays)) {\n    result.relays = stringUrls(obj.relays) ?? [];\n  }\n\n  if (typeof obj.nostrconnect_url === \"string\" && obj.nostrconnect_url.length > 0) {\n    result.nostrconnectUrl = obj.nostrconnect_url;\n  }\n\n  if (result.relays === undefined && result.nostrconnectUrl === undefined) {\n    return undefined;\n  }\n  return result;\n}\n\n/** Parse and validate a nostr.json document body. */\nexport function parseNip05Document(json: unknown): Nip05Document {\n  if (!json || typeof json !== \"object\") {\n    throw new Nip05Error(\"NIP-05 document must be a JSON object\");\n  }\n  const raw = json as { names?: unknown; relays?: unknown; nip46?: unknown };\n  if (!raw.names || typeof raw.names !== \"object\" || Array.isArray(raw.names)) {\n    throw new Nip05Error(\"NIP-05 document missing names map\");\n  }\n\n  const names: Record<string, string> = {};\n  for (const [k, v] of Object.entries(raw.names as Record<string, unknown>)) {\n    if (typeof v !== \"string\" || !isHex32(v)) continue;\n    names[k.toLowerCase()] = v.toLowerCase();\n  }\n\n  let relays: Record<string, string[]> | undefined;\n  if (raw.relays && typeof raw.relays === \"object\" && !Array.isArray(raw.relays)) {\n    relays = {};\n    for (const [pk, list] of Object.entries(raw.relays as Record<string, unknown>)) {\n      if (!isHex32(pk)) continue;\n      const urls = stringUrls(list);\n      if (urls?.length) relays[pk.toLowerCase()] = urls;\n    }\n  }\n\n  return { names, relays, nip46: parseNip05Nip46(raw.nip46) };\n}\n\n/** Resolve local name from an already-parsed document. */\nexport function lookupFromDocument(\n  doc: Nip05Document,\n  address: Nip05Address,\n): ProfilePointer | undefined {\n  const pubkey = doc.names[address.local];\n  if (!pubkey) return undefined;\n  const relays = doc.relays?.[pubkey];\n  return relays?.length ? { pubkey, relays: [...relays] } : { pubkey };\n}\n\n/**\n * Fetch and parse `/.well-known/nostr.json`.\n * Returns `null` on network/parse failure (does not throw for those).\n * Rejects HTTP redirects (non-200) per NIP-05 security constraints.\n * AbortError rethrows; it is not mapped to `null`.\n */\nexport async function queryNip05Document(\n  identifier: string,\n  opts?: { fetch?: Nip05Fetch; signal?: AbortSignal },\n): Promise<{ address: Nip05Address; doc: Nip05Document } | null> {\n  let address: Nip05Address;\n  try {\n    address = parseNip05(identifier);\n  } catch {\n    return null;\n  }\n\n  const url = wellKnownUrl(address);\n  const fetchImpl =\n    opts?.fetch ??\n    requireGlobalFetch(() => new Nip05Error(\"no fetch implementation available; pass opts.fetch\"));\n\n  try {\n    const res = await fetchManual(fetchImpl, url, { signal: opts?.signal }, (err) =>\n      err instanceof Error ? err : new Error(\"NIP-05 request failed\"),\n    );\n    // Redirects and errors must not be trusted (NIP-05 security).\n    if (res.status !== 200) return null;\n    const json = await res.json();\n    return { address, doc: parseNip05Document(json) };\n  } catch (err) {\n    if (err instanceof Error && err.name === \"AbortError\") throw err;\n    return null;\n  }\n}\n\n/**\n * Query `/.well-known/nostr.json` for an identifier.\n * Returns `null` on network/parse/lookup failure (does not throw for those).\n * Profile `relays` only. `nip46` is discovery metadata, not a bunker pointer.\n */\nexport async function queryProfile(\n  identifier: string,\n  opts?: { fetch?: Nip05Fetch; signal?: AbortSignal },\n): Promise<ProfilePointer | null> {\n  const fetched = await queryNip05Document(identifier, opts);\n  if (!fetched) return null;\n  return lookupFromDocument(fetched.doc, fetched.address) ?? null;\n}\n\n/** True when the identifier resolves to exactly `pubkey`. */\nexport async function verifyNip05(\n  pubkey: string,\n  identifier: string,\n  opts?: { fetch?: Nip05Fetch; signal?: AbortSignal },\n): Promise<boolean> {\n  if (!isHex32(pubkey)) return false;\n  const profile = await queryProfile(identifier, opts);\n  return profile !== null && profile.pubkey === pubkey.toLowerCase();\n}\n"],"mappings":"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"}

package/dist/nips/nip10.d.mts

@@ -0,0 +1,43 @@
+import { t as Event, v as Tag } from "../event-B5D2jxt_.mjs";
+import { t as EventBuilder } from "../builder-BphJa-Y-.mjs";
+import { f as ProfilePointer, i as EventPointer, t as AddressPointer } from "../nip19-D7905oIv.mjs";
+//#region src/nips/nip10.d.ts
+type ThreadReferences = {
+  /** Pointer to the root of the thread. */
+  root: EventPointer | undefined;
+  /** Pointer to the parent event this note replies to. */
+  reply: EventPointer | undefined;
+  /** Other e-tagged events (not root/reply). */
+  mentions: EventPointer[];
+  /** Quoted events (`q` tags): event ids or addresses. Discriminate with `"id" in q`. */
+  quotes: Array<EventPointer | AddressPointer>;
+  /** p-tagged profiles involved in the thread. */
+  profiles: ProfilePointer[];
+};
+type ReplyParent = Pick<Event, "id" | "pubkey" | "tags" | "kind">;
+type QuoteInput = string | EventPointer | AddressPointer;
+/**
+ * Parse NIP-10 thread markers and legacy positional e-tags from an event.
+ */
+declare function parseThreadTags(event: Pick<Event, "tags">): ThreadReferences;
+type ReplyTagsOptions = {
+  /** Parent event being replied to. */
+  parent: ReplyParent;
+  /** Optional relay hint for the parent e-tag. */
+  relayHint?: string;
+  /** Quoted events (`q` tags): hex ids, `kind:pubkey:d` coords, or pointers. */
+  quotes?: QuoteInput[];
+};
+/**
+ * Build NIP-10 e/p tags for a reply to `parent`.
+ * Uses marked tags (`root` / `reply`) per preferred modern style.
+ */
+declare function buildReplyTags(opts: ReplyTagsOptions): Tag[];
+/**
+ * Build an {@link EventBuilder} reply with NIP-10 tags.
+ * Lives here (not on EventBuilder) so core does not depend on nips.
+ */
+declare function replyTo(parent: ReplyParent, content: string, opts?: Pick<ReplyTagsOptions, "relayHint" | "quotes">): EventBuilder;
+//#endregion
+export { ReplyTagsOptions, ThreadReferences, buildReplyTags, parseThreadTags, replyTo };
+//# sourceMappingURL=nip10.d.mts.map

package/dist/nips/nip10.mjs

@@ -0,0 +1,194 @@
+import { a as isHex32 } from "../util-6tfLQ9JF.mjs";
+import { n as EventValidationError } from "../error-DZEs5OuZ.mjs";
+import { t as Kind } from "../kind-BLl4cLOc.mjs";
+import { g as formatEventAddress, m as Tag, y as parseEventAddress } from "../event-CzoQEFMF.mjs";
+import { t as EventBuilder } from "../builder-q0VsvnYE.mjs";
+//#region src/nips/nip10.ts
+/**
+* NIP-10: Text Notes and Threads
+* @see https://github.com/nostr-protocol/nips/blob/master/10.md
+*/
+function eventPointerFromETag(tag) {
+	if (tag[0] !== "e" || !tag[1] || !isHex32(tag[1])) return void 0;
+	const author = tag[4] && isHex32(tag[4]) ? tag[4].toLowerCase() : tag[3] && isHex32(tag[3]) ? tag[3].toLowerCase() : void 0;
+	return {
+		id: tag[1].toLowerCase(),
+		relays: tag[2] ? [tag[2]] : [],
+		author
+	};
+}
+function quoteFromQTag(tag) {
+	if (tag[0] !== "q" || !tag[1]) return void 0;
+	if (isHex32(tag[1])) {
+		const pointer = {
+			id: tag[1].toLowerCase(),
+			relays: tag[2] ? [tag[2]] : []
+		};
+		if (tag[3] && isHex32(tag[3])) pointer.author = tag[3].toLowerCase();
+		return pointer;
+	}
+	const addr = parseEventAddress(tag[1]);
+	if (!addr) return void 0;
+	return {
+		identifier: addr.identifier,
+		pubkey: addr.pubkey,
+		kind: addr.kind,
+		relays: tag[2] ? [tag[2]] : []
+	};
+}
+function quoteToTag(quote) {
+	if (typeof quote === "string") {
+		if (isHex32(quote)) return { tag: ["q", quote.toLowerCase()] };
+		const addr = parseEventAddress(quote);
+		if (!addr) return void 0;
+		return { tag: ["q", formatEventAddress(addr.kind, addr.pubkey, addr.identifier)] };
+	}
+	if ("id" in quote) {
+		const id = quote.id.toLowerCase();
+		const relay = quote.relays?.[0];
+		const author = quote.author && isHex32(quote.author) ? quote.author.toLowerCase() : void 0;
+		return {
+			tag: author !== void 0 ? [
+				"q",
+				id,
+				relay ?? "",
+				author
+			] : relay ? [
+				"q",
+				id,
+				relay
+			] : ["q", id],
+			author,
+			relay: relay || void 0
+		};
+	}
+	const coord = formatEventAddress(quote.kind, quote.pubkey, quote.identifier);
+	const relay = quote.relays?.[0];
+	return {
+		tag: relay ? [
+			"q",
+			coord,
+			relay
+		] : ["q", coord],
+		author: quote.pubkey,
+		relay: relay || void 0
+	};
+}
+function assertKind1Parent(parent) {
+	if (parent.kind !== Kind.TextNote) throw new EventValidationError("NIP-10 replyTo is for kind 1");
+}
+/**
+* Parse NIP-10 thread markers and legacy positional e-tags from an event.
+*/
+function parseThreadTags(event) {
+	const result = {
+		root: void 0,
+		reply: void 0,
+		mentions: [],
+		quotes: [],
+		profiles: []
+	};
+	let maybeParent;
+	let maybeRoot;
+	for (let i = event.tags.length - 1; i >= 0; i--) {
+		const tag = event.tags[i];
+		if (tag[0] === "e" && tag[1] && isHex32(tag[1])) {
+			const pointer = eventPointerFromETag(tag);
+			const marker = tag[3];
+			if (marker === "root") {
+				result.root = pointer;
+				continue;
+			}
+			if (marker === "reply") {
+				result.reply = pointer;
+				continue;
+			}
+			if (marker && !isHex32(marker)) {
+				result.mentions.push(pointer);
+				continue;
+			}
+			if (!maybeParent) maybeParent = pointer;
+			else maybeRoot = pointer;
+			result.mentions.push(pointer);
+			continue;
+		}
+		if (tag[0] === "q") {
+			const quote = quoteFromQTag(tag);
+			if (quote) result.quotes.push(quote);
+			continue;
+		}
+		if (tag[0] === "p" && tag[1] && isHex32(tag[1])) result.profiles.push({
+			pubkey: tag[1].toLowerCase(),
+			relays: tag[2] ? [tag[2]] : []
+		});
+	}
+	if (!result.root) result.root = maybeRoot ?? maybeParent ?? result.reply;
+	if (!result.reply) result.reply = maybeParent ?? result.root;
+	const drop = new Set([result.root?.id, result.reply?.id].filter((id) => Boolean(id)));
+	result.mentions = result.mentions.filter((m) => !drop.has(m.id));
+	for (const ref of [
+		result.reply,
+		result.root,
+		...result.mentions
+	]) {
+		if (!ref?.author) continue;
+		const author = result.profiles.find((p) => p.pubkey === ref.author);
+		if (!author?.relays?.length) continue;
+		const relays = [...ref.relays ?? []];
+		for (const url of author.relays) if (!relays.includes(url)) relays.push(url);
+		ref.relays = relays;
+	}
+	return result;
+}
+/**
+* Build NIP-10 e/p tags for a reply to `parent`.
+* Uses marked tags (`root` / `reply`) per preferred modern style.
+*/
+function buildReplyTags(opts) {
+	assertKind1Parent(opts.parent);
+	const thread = parseThreadTags(opts.parent);
+	const root = thread.root ?? {
+		id: opts.parent.id,
+		relays: [],
+		author: opts.parent.pubkey
+	};
+	const parentIsRoot = root.id.toLowerCase() === opts.parent.id.toLowerCase();
+	const tags = [];
+	const rootRelay = root.relays?.[0] ?? opts.relayHint ?? "";
+	tags.push(Tag.e(root.id, rootRelay, "root", root.author ?? opts.parent.pubkey));
+	if (!parentIsRoot) tags.push(Tag.e(opts.parent.id, opts.relayHint ?? "", "reply", opts.parent.pubkey));
+	const pSeen = /* @__PURE__ */ new Set();
+	const addP = (pk, relay) => {
+		const key = pk.toLowerCase();
+		if (pSeen.has(key)) return;
+		pSeen.add(key);
+		tags.push(Tag.p(pk, relay || void 0));
+	};
+	if (root.author) addP(root.author, root.relays?.[0]);
+	addP(opts.parent.pubkey, opts.relayHint);
+	for (const p of thread.profiles) addP(p.pubkey, p.relays?.[0]);
+	const qTags = [];
+	for (const quote of opts.quotes ?? []) {
+		const built = quoteToTag(quote);
+		if (!built) continue;
+		if (built.author) addP(built.author, built.relay);
+		qTags.push(built.tag);
+	}
+	tags.push(...qTags);
+	return tags;
+}
+/**
+* Build an {@link EventBuilder} reply with NIP-10 tags.
+* Lives here (not on EventBuilder) so core does not depend on nips.
+*/
+function replyTo(parent, content, opts) {
+	return EventBuilder.textNote(content).tags(buildReplyTags({
+		parent,
+		relayHint: opts?.relayHint,
+		quotes: opts?.quotes
+	}));
+}
+//#endregion
+export { buildReplyTags, parseThreadTags, replyTo };
+
+//# sourceMappingURL=nip10.mjs.map

package/dist/nips/nip10.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip10.mjs","names":[],"sources":["../../src/nips/nip10.ts"],"sourcesContent":["/**\n * NIP-10: Text Notes and Threads\n * @see https://github.com/nostr-protocol/nips/blob/master/10.md\n */\nimport { EventBuilder } from \"../core/builder.ts\";\nimport { EventValidationError } from \"../core/error.ts\";\nimport type { Event } from \"../core/event.ts\";\nimport { Kind } from \"../core/kind.ts\";\nimport { formatEventAddress, parseEventAddress, Tag } from \"../core/tag.ts\";\nimport { isHex32 } from \"../core/util.ts\";\nimport type { AddressPointer, EventPointer, ProfilePointer } from \"./nip19.ts\";\n\nexport type ThreadReferences = {\n  /** Pointer to the root of the thread. */\n  root: EventPointer | undefined;\n  /** Pointer to the parent event this note replies to. */\n  reply: EventPointer | undefined;\n  /** Other e-tagged events (not root/reply). */\n  mentions: EventPointer[];\n  /** Quoted events (`q` tags): event ids or addresses. Discriminate with `\"id\" in q`. */\n  quotes: Array<EventPointer | AddressPointer>;\n  /** p-tagged profiles involved in the thread. */\n  profiles: ProfilePointer[];\n};\n\ntype ReplyParent = Pick<Event, \"id\" | \"pubkey\" | \"tags\" | \"kind\">;\ntype QuoteInput = string | EventPointer | AddressPointer;\n\nfunction eventPointerFromETag(tag: readonly string[]): EventPointer | undefined {\n  if (tag[0] !== \"e\" || !tag[1] || !isHex32(tag[1])) return undefined;\n  // NIP-10 5-tuple pubkey is index 4; NIP-01 4-tuple pubkey is index 3.\n  const author =\n    tag[4] && isHex32(tag[4])\n      ? tag[4].toLowerCase()\n      : tag[3] && isHex32(tag[3])\n        ? tag[3].toLowerCase()\n        : undefined;\n  return {\n    id: tag[1].toLowerCase(),\n    relays: tag[2] ? [tag[2]] : [],\n    author,\n  };\n}\n\nfunction quoteFromQTag(tag: readonly string[]): EventPointer | AddressPointer | undefined {\n  if (tag[0] !== \"q\" || !tag[1]) return undefined;\n  if (isHex32(tag[1])) {\n    const pointer: EventPointer = {\n      id: tag[1].toLowerCase(),\n      relays: tag[2] ? [tag[2]] : [],\n    };\n    if (tag[3] && isHex32(tag[3])) pointer.author = tag[3].toLowerCase();\n    return pointer;\n  }\n  const addr = parseEventAddress(tag[1]);\n  if (!addr) return undefined;\n  // Address q tags do not use the event-id pubkey slot (index 3).\n  return {\n    identifier: addr.identifier,\n    pubkey: addr.pubkey,\n    kind: addr.kind,\n    relays: tag[2] ? [tag[2]] : [],\n  };\n}\n\nfunction quoteToTag(quote: QuoteInput): { tag: Tag; author?: string; relay?: string } | undefined {\n  if (typeof quote === \"string\") {\n    if (isHex32(quote)) return { tag: [\"q\", quote.toLowerCase()] };\n    const addr = parseEventAddress(quote);\n    if (!addr) return undefined;\n    return { tag: [\"q\", formatEventAddress(addr.kind, addr.pubkey, addr.identifier)] };\n  }\n  if (\"id\" in quote) {\n    const id = quote.id.toLowerCase();\n    const relay = quote.relays?.[0];\n    const author = quote.author && isHex32(quote.author) ? quote.author.toLowerCase() : undefined;\n    const tag: Tag =\n      author !== undefined ? [\"q\", id, relay ?? \"\", author] : relay ? [\"q\", id, relay] : [\"q\", id];\n    return { tag, author, relay: relay || undefined };\n  }\n  const coord = formatEventAddress(quote.kind, quote.pubkey, quote.identifier);\n  const relay = quote.relays?.[0];\n  const tag: Tag = relay ? [\"q\", coord, relay] : [\"q\", coord];\n  return { tag, author: quote.pubkey, relay: relay || undefined };\n}\n\nfunction assertKind1Parent(parent: ReplyParent): void {\n  // NIP-10 is kind 1 only; comments are NIP-22.\n  if (parent.kind !== Kind.TextNote) {\n    throw new EventValidationError(\"NIP-10 replyTo is for kind 1\");\n  }\n}\n\n/**\n * Parse NIP-10 thread markers and legacy positional e-tags from an event.\n */\nexport function parseThreadTags(event: Pick<Event, \"tags\">): ThreadReferences {\n  const result: ThreadReferences = {\n    root: undefined,\n    reply: undefined,\n    mentions: [],\n    quotes: [],\n    profiles: [],\n  };\n\n  let maybeParent: EventPointer | undefined;\n  let maybeRoot: EventPointer | undefined;\n\n  for (let i = event.tags.length - 1; i >= 0; i--) {\n    const tag = event.tags[i]!;\n\n    if (tag[0] === \"e\" && tag[1] && isHex32(tag[1])) {\n      const pointer = eventPointerFromETag(tag)!;\n      const marker = tag[3];\n\n      if (marker === \"root\") {\n        result.root = pointer;\n        continue;\n      }\n      if (marker === \"reply\") {\n        result.reply = pointer;\n        continue;\n      }\n      // Preferred markers are root/reply only. A hex32 at index 3 is NIP-01 pubkey, not a marker.\n      if (marker && !isHex32(marker)) {\n        result.mentions.push(pointer);\n        continue;\n      }\n\n      // Legacy positional: last unmarked is parent, second-to-last is root.\n      if (!maybeParent) maybeParent = pointer;\n      else maybeRoot = pointer;\n      result.mentions.push(pointer);\n      continue;\n    }\n\n    if (tag[0] === \"q\") {\n      const quote = quoteFromQTag(tag);\n      if (quote) result.quotes.push(quote);\n      continue;\n    }\n\n    if (tag[0] === \"p\" && tag[1] && isHex32(tag[1])) {\n      result.profiles.push({\n        pubkey: tag[1].toLowerCase(),\n        relays: tag[2] ? [tag[2]] : [],\n      });\n    }\n  }\n\n  if (!result.root) {\n    result.root = maybeRoot ?? maybeParent ?? result.reply;\n  }\n  if (!result.reply) {\n    result.reply = maybeParent ?? result.root;\n  }\n\n  // Drop root/reply from mentions (by id).\n  const drop = new Set(\n    [result.root?.id, result.reply?.id].filter((id): id is string => Boolean(id)),\n  );\n  result.mentions = result.mentions.filter((m) => !drop.has(m.id));\n\n  // Inherit relay hints from matching p-tags.\n  for (const ref of [result.reply, result.root, ...result.mentions]) {\n    if (!ref?.author) continue;\n    const author = result.profiles.find((p) => p.pubkey === ref.author);\n    if (!author?.relays?.length) continue;\n    const relays = [...(ref.relays ?? [])];\n    for (const url of author.relays) {\n      if (!relays.includes(url)) relays.push(url);\n    }\n    ref.relays = relays;\n  }\n\n  return result;\n}\n\nexport type ReplyTagsOptions = {\n  /** Parent event being replied to. */\n  parent: ReplyParent;\n  /** Optional relay hint for the parent e-tag. */\n  relayHint?: string;\n  /** Quoted events (`q` tags): hex ids, `kind:pubkey:d` coords, or pointers. */\n  quotes?: QuoteInput[];\n};\n\n/**\n * Build NIP-10 e/p tags for a reply to `parent`.\n * Uses marked tags (`root` / `reply`) per preferred modern style.\n */\nexport function buildReplyTags(opts: ReplyTagsOptions): Tag[] {\n  assertKind1Parent(opts.parent);\n  const thread = parseThreadTags(opts.parent);\n  const root = thread.root ?? { id: opts.parent.id, relays: [], author: opts.parent.pubkey };\n  const parentIsRoot = root.id.toLowerCase() === opts.parent.id.toLowerCase();\n\n  const tags: Tag[] = [];\n  const rootRelay = root.relays?.[0] ?? opts.relayHint ?? \"\";\n  tags.push(Tag.e(root.id, rootRelay, \"root\", root.author ?? opts.parent.pubkey));\n\n  if (!parentIsRoot) {\n    tags.push(Tag.e(opts.parent.id, opts.relayHint ?? \"\", \"reply\", opts.parent.pubkey));\n  }\n\n  // Ensure root + parent authors are p-tagged.\n  const pSeen = new Set<string>();\n  const addP = (pk: string, relay?: string) => {\n    const key = pk.toLowerCase();\n    if (pSeen.has(key)) return;\n    pSeen.add(key);\n    tags.push(Tag.p(pk, relay || undefined));\n  };\n  if (root.author) addP(root.author, root.relays?.[0]);\n  addP(opts.parent.pubkey, opts.relayHint);\n  for (const p of thread.profiles) addP(p.pubkey, p.relays?.[0]);\n\n  const qTags: Tag[] = [];\n  for (const quote of opts.quotes ?? []) {\n    const built = quoteToTag(quote);\n    if (!built) continue;\n    if (built.author) addP(built.author, built.relay);\n    qTags.push(built.tag);\n  }\n  tags.push(...qTags);\n\n  return tags;\n}\n\n/**\n * Build an {@link EventBuilder} reply with NIP-10 tags.\n * Lives here (not on EventBuilder) so core does not depend on nips.\n */\nexport function replyTo(\n  parent: ReplyParent,\n  content: string,\n  opts?: Pick<ReplyTagsOptions, \"relayHint\" | \"quotes\">,\n): EventBuilder {\n  return EventBuilder.textNote(content).tags(\n    buildReplyTags({\n      parent,\n      relayHint: opts?.relayHint,\n      quotes: opts?.quotes,\n    }),\n  );\n}\n"],"mappings":"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"}

package/dist/nips/nip11.d.mts

@@ -0,0 +1,43 @@
+import { a as NostrError } from "../error-WEFS-R-4.mjs";
+import { t as ManualFetch } from "../http-6vevbBlu.mjs";
+//#region src/nips/nip11.d.ts
+type Nip11Fetch = ManualFetch;
+type RelayInformation = {
+  name?: string;
+  description?: string;
+  banner?: string;
+  icon?: string;
+  pubkey?: string;
+  self?: string;
+  contact?: string;
+  supported_nips?: number[];
+  software?: string;
+  version?: string;
+  limitation?: {
+    max_message_length?: number;
+    max_subscriptions?: number;
+    max_limit?: number;
+    max_subid_length?: number;
+    max_event_tags?: number;
+    max_content_length?: number;
+    default_limit?: number;
+    auth_required?: boolean;
+    payment_required?: boolean;
+    restricted_writes?: boolean;
+    min_pow_difficulty?: number;
+    created_at_lower_limit?: number;
+    created_at_upper_limit?: number;
+  };
+  payments_url?: string;
+  terms_of_service?: string;
+};
+declare class Nip11Error extends NostrError {}
+/** Convert a relay websocket URL to the HTTP URL that serves the NIP-11 document. */
+declare function relayInfoHttpUrl(wsUrl: string): string;
+declare function fetchRelayInformation(wsUrl: string, opts?: {
+  fetch?: Nip11Fetch;
+  signal?: AbortSignal;
+}): Promise<RelayInformation>;
+//#endregion
+export { Nip11Error, Nip11Fetch, RelayInformation, fetchRelayInformation, relayInfoHttpUrl };
+//# sourceMappingURL=nip11.d.mts.map

package/dist/nips/nip11.mjs

@@ -0,0 +1,99 @@
+import { a as NostrError } from "../error-DZEs5OuZ.mjs";
+import { n as requireGlobalFetch, t as fetchManual } from "../http-D2rhokZo.mjs";
+//#region src/nips/nip11.ts
+/**
+* NIP-11: Relay Information Document
+* @see https://github.com/nostr-protocol/nips/blob/master/11.md
+*/
+const ACCEPT = "application/nostr+json";
+const STRING_FIELDS = [
+	"name",
+	"description",
+	"banner",
+	"icon",
+	"pubkey",
+	"self",
+	"contact",
+	"software",
+	"version",
+	"payments_url",
+	"terms_of_service"
+];
+const LIMITATION_NUMBERS = [
+	"max_message_length",
+	"max_subscriptions",
+	"max_limit",
+	"max_subid_length",
+	"max_event_tags",
+	"max_content_length",
+	"min_pow_difficulty",
+	"created_at_lower_limit",
+	"created_at_upper_limit",
+	"default_limit"
+];
+const LIMITATION_BOOLEANS = [
+	"auth_required",
+	"payment_required",
+	"restricted_writes"
+];
+var Nip11Error = class extends NostrError {};
+/** Convert a relay websocket URL to the HTTP URL that serves the NIP-11 document. */
+function relayInfoHttpUrl(wsUrl) {
+	let url;
+	try {
+		url = new URL(wsUrl);
+	} catch (cause) {
+		throw new Nip11Error(`invalid relay URL: ${wsUrl}`, { cause: cause instanceof Error ? cause : void 0 });
+	}
+	if (url.protocol === "wss:") url.protocol = "https:";
+	else if (url.protocol === "ws:") url.protocol = "http:";
+	else if (url.protocol !== "https:" && url.protocol !== "http:") throw new Nip11Error(`unsupported relay URL scheme: ${url.protocol}`);
+	return url.toString();
+}
+function isNonNegativeInteger(value) {
+	return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function parseRelayInformation(json) {
+	if (json === null || typeof json !== "object" || Array.isArray(json)) throw new Nip11Error("relay information document must be a JSON object");
+	const raw = json;
+	const info = {};
+	for (const key of STRING_FIELDS) {
+		const value = raw[key];
+		if (typeof value === "string") info[key] = value;
+	}
+	if (Array.isArray(raw.supported_nips)) info.supported_nips = raw.supported_nips.filter(isNonNegativeInteger);
+	if (raw.limitation && typeof raw.limitation === "object" && !Array.isArray(raw.limitation)) {
+		const rawLim = raw.limitation;
+		const limitation = {};
+		for (const key of LIMITATION_NUMBERS) {
+			const value = rawLim[key];
+			if (isNonNegativeInteger(value)) limitation[key] = value;
+		}
+		for (const key of LIMITATION_BOOLEANS) {
+			const value = rawLim[key];
+			if (typeof value === "boolean") limitation[key] = value;
+		}
+		if (Object.keys(limitation).length > 0) info.limitation = limitation;
+	}
+	return info;
+}
+async function fetchRelayInformation(wsUrl, opts) {
+	const httpUrl = relayInfoHttpUrl(wsUrl);
+	const fetchImpl = opts?.fetch ?? requireGlobalFetch(() => new Nip11Error("no fetch implementation available; pass opts.fetch"));
+	const res = await fetchManual(fetchImpl, httpUrl, {
+		headers: { Accept: ACCEPT },
+		signal: opts?.signal
+	}, (cause) => new Nip11Error(`relay information request failed: ${httpUrl}`, { cause: cause instanceof Error ? cause : void 0 }));
+	if (!res.ok) throw new Nip11Error(`relay information request failed: HTTP ${res.status}`);
+	let json;
+	try {
+		json = await res.json();
+	} catch (cause) {
+		throw new Nip11Error("relay information document is not valid JSON", { cause: cause instanceof Error ? cause : void 0 });
+	}
+	return parseRelayInformation(json);
+}
+//#endregion
+export { Nip11Error, fetchRelayInformation, relayInfoHttpUrl };
+
+//# sourceMappingURL=nip11.mjs.map

package/dist/nips/nip11.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip11.mjs","names":[],"sources":["../../src/nips/nip11.ts"],"sourcesContent":["/**\n * NIP-11: Relay Information Document\n * @see https://github.com/nostr-protocol/nips/blob/master/11.md\n */\nimport { NostrError } from \"../core/error.ts\";\nimport { fetchManual, requireGlobalFetch, type ManualFetch } from \"./http.ts\";\n\nconst ACCEPT = \"application/nostr+json\";\n\nconst STRING_FIELDS = [\n  \"name\",\n  \"description\",\n  \"banner\",\n  \"icon\",\n  \"pubkey\",\n  \"self\",\n  \"contact\",\n  \"software\",\n  \"version\",\n  \"payments_url\",\n  \"terms_of_service\",\n] as const;\n\nconst LIMITATION_NUMBERS = [\n  \"max_message_length\",\n  \"max_subscriptions\",\n  \"max_limit\",\n  \"max_subid_length\",\n  \"max_event_tags\",\n  \"max_content_length\",\n  \"min_pow_difficulty\",\n  \"created_at_lower_limit\",\n  \"created_at_upper_limit\",\n  \"default_limit\",\n] as const;\n\nconst LIMITATION_BOOLEANS = [\"auth_required\", \"payment_required\", \"restricted_writes\"] as const;\n\nexport type Nip11Fetch = ManualFetch;\n\nexport type RelayInformation = {\n  name?: string;\n  description?: string;\n  banner?: string;\n  icon?: string;\n  pubkey?: string;\n  self?: string;\n  contact?: string;\n  supported_nips?: number[];\n  software?: string;\n  version?: string;\n  limitation?: {\n    max_message_length?: number;\n    max_subscriptions?: number;\n    max_limit?: number;\n    max_subid_length?: number;\n    max_event_tags?: number;\n    max_content_length?: number;\n    default_limit?: number;\n    auth_required?: boolean;\n    payment_required?: boolean;\n    restricted_writes?: boolean;\n    min_pow_difficulty?: number;\n    created_at_lower_limit?: number;\n    created_at_upper_limit?: number;\n  };\n  payments_url?: string;\n  terms_of_service?: string;\n};\n\nexport class Nip11Error extends NostrError {}\n\n/** Convert a relay websocket URL to the HTTP URL that serves the NIP-11 document. */\nexport function relayInfoHttpUrl(wsUrl: string): string {\n  let url: URL;\n  try {\n    url = new URL(wsUrl);\n  } catch (cause) {\n    throw new Nip11Error(`invalid relay URL: ${wsUrl}`, {\n      cause: cause instanceof Error ? cause : undefined,\n    });\n  }\n\n  if (url.protocol === \"wss:\") url.protocol = \"https:\";\n  else if (url.protocol === \"ws:\") url.protocol = \"http:\";\n  else if (url.protocol !== \"https:\" && url.protocol !== \"http:\") {\n    throw new Nip11Error(`unsupported relay URL scheme: ${url.protocol}`);\n  }\n\n  return url.toString();\n}\n\nfunction isNonNegativeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isInteger(value) && value >= 0;\n}\n\nfunction parseRelayInformation(json: unknown): RelayInformation {\n  if (json === null || typeof json !== \"object\" || Array.isArray(json)) {\n    throw new Nip11Error(\"relay information document must be a JSON object\");\n  }\n  const raw = json as Record<string, unknown>;\n  const info: RelayInformation = {};\n\n  for (const key of STRING_FIELDS) {\n    const value = raw[key];\n    if (typeof value === \"string\") info[key] = value;\n  }\n\n  if (Array.isArray(raw.supported_nips)) {\n    info.supported_nips = raw.supported_nips.filter(isNonNegativeInteger);\n  }\n\n  if (raw.limitation && typeof raw.limitation === \"object\" && !Array.isArray(raw.limitation)) {\n    const rawLim = raw.limitation as Record<string, unknown>;\n    const limitation: NonNullable<RelayInformation[\"limitation\"]> = {};\n    for (const key of LIMITATION_NUMBERS) {\n      const value = rawLim[key];\n      if (isNonNegativeInteger(value)) limitation[key] = value;\n    }\n    for (const key of LIMITATION_BOOLEANS) {\n      const value = rawLim[key];\n      if (typeof value === \"boolean\") limitation[key] = value;\n    }\n    if (Object.keys(limitation).length > 0) info.limitation = limitation;\n  }\n\n  return info;\n}\n\nexport async function fetchRelayInformation(\n  wsUrl: string,\n  opts?: { fetch?: Nip11Fetch; signal?: AbortSignal },\n): Promise<RelayInformation> {\n  const httpUrl = relayInfoHttpUrl(wsUrl);\n  const fetchImpl =\n    opts?.fetch ??\n    requireGlobalFetch(() => new Nip11Error(\"no fetch implementation available; pass opts.fetch\"));\n\n  const res = await fetchManual(\n    fetchImpl,\n    httpUrl,\n    { headers: { Accept: ACCEPT }, signal: opts?.signal },\n    (cause) =>\n      new Nip11Error(`relay information request failed: ${httpUrl}`, {\n        cause: cause instanceof Error ? cause : undefined,\n      }),\n  );\n\n  if (!res.ok) {\n    throw new Nip11Error(`relay information request failed: HTTP ${res.status}`);\n  }\n\n  let json: unknown;\n  try {\n    json = await res.json();\n  } catch (cause) {\n    throw new Nip11Error(\"relay information document is not valid JSON\", {\n      cause: cause instanceof Error ? cause : undefined,\n    });\n  }\n\n  return parseRelayInformation(json);\n}\n"],"mappings":";;;;;;;AAOA,MAAM,SAAS;AAEf,MAAM,gBAAgB;CACpB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAM,qBAAqB;CACzB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAM,sBAAsB;CAAC;CAAiB;CAAoB;AAAmB;AAkCrF,IAAa,aAAb,cAAgC,WAAW,CAAC;;AAG5C,SAAgB,iBAAiB,OAAuB;CACtD,IAAI;CACJ,IAAI;EACF,MAAM,IAAI,IAAI,KAAK;CACrB,SAAS,OAAO;EACd,MAAM,IAAI,WAAW,sBAAsB,SAAS,EAClD,OAAO,iBAAiB,QAAQ,QAAQ,KAAA,EAC1C,CAAC;CACH;CAEA,IAAI,IAAI,aAAa,QAAQ,IAAI,WAAW;MACvC,IAAI,IAAI,aAAa,OAAO,IAAI,WAAW;MAC3C,IAAI,IAAI,aAAa,YAAY,IAAI,aAAa,SACrD,MAAM,IAAI,WAAW,iCAAiC,IAAI,UAAU;CAGtE,OAAO,IAAI,SAAS;AACtB;AAEA,SAAS,qBAAqB,OAAiC;CAC7D,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK,KAAK,SAAS;AAC1E;AAEA,SAAS,sBAAsB,MAAiC;CAC9D,IAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,GACjE,MAAM,IAAI,WAAW,kDAAkD;CAEzE,MAAM,MAAM;CACZ,MAAM,OAAyB,CAAC;CAEhC,KAAK,MAAM,OAAO,eAAe;EAC/B,MAAM,QAAQ,IAAI;EAClB,IAAI,OAAO,UAAU,UAAU,KAAK,OAAO;CAC7C;CAEA,IAAI,MAAM,QAAQ,IAAI,cAAc,GAClC,KAAK,iBAAiB,IAAI,eAAe,OAAO,oBAAoB;CAGtE,IAAI,IAAI,cAAc,OAAO,IAAI,eAAe,YAAY,CAAC,MAAM,QAAQ,IAAI,UAAU,GAAG;EAC1F,MAAM,SAAS,IAAI;EACnB,MAAM,aAA0D,CAAC;EACjE,KAAK,MAAM,OAAO,oBAAoB;GACpC,MAAM,QAAQ,OAAO;GACrB,IAAI,qBAAqB,KAAK,GAAG,WAAW,OAAO;EACrD;EACA,KAAK,MAAM,OAAO,qBAAqB;GACrC,MAAM,QAAQ,OAAO;GACrB,IAAI,OAAO,UAAU,WAAW,WAAW,OAAO;EACpD;EACA,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC,SAAS,GAAG,KAAK,aAAa;CAC5D;CAEA,OAAO;AACT;AAEA,eAAsB,sBACpB,OACA,MAC2B;CAC3B,MAAM,UAAU,iBAAiB,KAAK;CACtC,MAAM,YACJ,MAAM,SACN,yBAAyB,IAAI,WAAW,oDAAoD,CAAC;CAE/F,MAAM,MAAM,MAAM,YAChB,WACA,SACA;EAAE,SAAS,EAAE,QAAQ,OAAO;EAAG,QAAQ,MAAM;CAAO,IACnD,UACC,IAAI,WAAW,qCAAqC,WAAW,EAC7D,OAAO,iBAAiB,QAAQ,QAAQ,KAAA,EAC1C,CAAC,CACL;CAEA,IAAI,CAAC,IAAI,IACP,MAAM,IAAI,WAAW,0CAA0C,IAAI,QAAQ;CAG7E,IAAI;CACJ,IAAI;EACF,OAAO,MAAM,IAAI,KAAK;CACxB,SAAS,OAAO;EACd,MAAM,IAAI,WAAW,gDAAgD,EACnE,OAAO,iBAAiB,QAAQ,QAAQ,KAAA,EAC1C,CAAC;CACH;CAEA,OAAO,sBAAsB,IAAI;AACnC"}

package/dist/nips/nip13.d.mts

@@ -0,0 +1,23 @@
+import { r as UnsignedEvent } from "../event-B5D2jxt_.mjs";
+import { a as NostrError } from "../error-WEFS-R-4.mjs";
+//#region src/nips/nip13.d.ts
+declare class Nip13Error extends NostrError {
+  constructor(message: string, options?: ErrorOptions);
+}
+type MinePowOptions = {
+  /** Yield to the event loop after this many hashes. Default 1000. */
+  yieldEvery?: number;
+  signal?: AbortSignal;
+};
+/** Leading zero bits of a hex event id or raw sha256 bytes. */
+declare function getPow(idOrHash: string | Uint8Array): number;
+/**
+ * Returns a new unsigned event with nonce tag and computed id.
+ * Does not mutate input. Yields every `yieldEvery` hashes.
+ */
+declare function minePow(unsigned: UnsignedEvent, difficulty: number, opts?: MinePowOptions): Promise<UnsignedEvent & {
+  id: string;
+}>;
+//#endregion
+export { MinePowOptions, Nip13Error, getPow, minePow };
+//# sourceMappingURL=nip13.d.mts.map