@qntx/nostr 0.0.1

package/dist/message-C_Uj-Y-c.mjs

@@ -0,0 +1,179 @@
+import { i as hexToBytes, r as bytesToHex } from "./util-6tfLQ9JF.mjs";
+import { i as MessageError } from "./error-DZEs5OuZ.mjs";
+import { p as validateSignedEvent } from "./event-CzoQEFMF.mjs";
+//#region src/core/message.ts
+function assertSubscriptionId(id) {
+	if (id.length === 0 || id.length > 64) throw new MessageError(`subscription id length must be 1..64`);
+	return id;
+}
+function createSubscriptionId(id) {
+	if (id !== void 0) return assertSubscriptionId(id);
+	const bytes = /* @__PURE__ */ new Uint8Array(8);
+	crypto.getRandomValues(bytes);
+	return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+const HLL_BYTES = 256;
+const HLL_HEX_LEN = HLL_BYTES * 2;
+const HEX_RE = /^[0-9a-fA-F]+$/;
+/**
+* Register-wise max of NIP-45 HyperLogLog sketches.
+* Output is always lowercase 512 hex. Empty input is the zero sketch (identity).
+*/
+function mergeCountHll(hexes) {
+	const merged = new Uint8Array(HLL_BYTES);
+	for (const hex of hexes) {
+		if (hex.length !== HLL_HEX_LEN || !HEX_RE.test(hex)) throw new MessageError("invalid NIP-45 HLL sketch: expected 512-char hex");
+		const bytes = hexToBytes(hex);
+		for (let i = 0; i < HLL_BYTES; i++) {
+			const b = bytes[i];
+			if (b > merged[i]) merged[i] = b;
+		}
+	}
+	return bytesToHex(merged);
+}
+function encodeClientMessage(message) {
+	return JSON.stringify(message);
+}
+function encodeRelayMessage(message) {
+	return JSON.stringify(message);
+}
+function parseClientMessage(raw) {
+	let data;
+	try {
+		data = JSON.parse(raw);
+	} catch {
+		throw new MessageError("client message is not valid JSON");
+	}
+	if (!Array.isArray(data) || data.length < 1 || typeof data[0] !== "string") throw new MessageError("client message must be a non-empty JSON array");
+	const type = data[0];
+	switch (type) {
+		case "EVENT":
+			if (data.length !== 2 || !validateSignedEvent(data[1])) throw new MessageError("invalid EVENT client message");
+			return ["EVENT", data[1]];
+		case "REQ":
+			if (data.length < 3 || typeof data[1] !== "string") throw new MessageError("invalid REQ client message");
+			return [
+				"REQ",
+				data[1],
+				...data.slice(2)
+			];
+		case "CLOSE":
+			if (data.length !== 2 || typeof data[1] !== "string") throw new MessageError("invalid CLOSE client message");
+			return ["CLOSE", data[1]];
+		case "AUTH":
+			if (data.length !== 2 || !validateSignedEvent(data[1])) throw new MessageError("invalid AUTH client message");
+			return ["AUTH", data[1]];
+		case "COUNT":
+			if (data.length < 3 || typeof data[1] !== "string") throw new MessageError("invalid COUNT client message");
+			return [
+				"COUNT",
+				data[1],
+				...data.slice(2)
+			];
+		case "NEG-OPEN":
+			if (data.length === 5) throw new MessageError("obsolete 5-element NEG-OPEN; expected [NEG-OPEN, id, filter, hex]");
+			if (data.length !== 4 || typeof data[1] !== "string" || !isFilterObject(data[2]) || !isNegHex(data[3])) throw new MessageError("invalid NEG-OPEN client message");
+			return [
+				"NEG-OPEN",
+				data[1],
+				data[2],
+				data[3].toLowerCase()
+			];
+		case "NEG-MSG":
+			if (data.length !== 3 || typeof data[1] !== "string" || !isNegHex(data[2])) throw new MessageError("invalid NEG-MSG client message");
+			return [
+				"NEG-MSG",
+				data[1],
+				data[2].toLowerCase()
+			];
+		case "NEG-CLOSE":
+			if (data.length !== 2 || typeof data[1] !== "string") throw new MessageError("invalid NEG-CLOSE client message");
+			return ["NEG-CLOSE", data[1]];
+		default: throw new MessageError(`unknown client message type: ${type}`);
+	}
+}
+function parseRelayMessage(raw) {
+	let data;
+	try {
+		data = JSON.parse(raw);
+	} catch {
+		throw new MessageError("relay message is not valid JSON");
+	}
+	if (!Array.isArray(data) || data.length < 1 || typeof data[0] !== "string") throw new MessageError("relay message must be a non-empty JSON array");
+	const type = data[0];
+	switch (type) {
+		case "EVENT":
+			if (data.length !== 3 || typeof data[1] !== "string" || !validateSignedEvent(data[2])) throw new MessageError("invalid EVENT relay message");
+			return [
+				"EVENT",
+				data[1],
+				data[2]
+			];
+		case "OK":
+			if (data.length !== 4 || typeof data[1] !== "string" || typeof data[2] !== "boolean" || typeof data[3] !== "string") throw new MessageError("invalid OK relay message");
+			return [
+				"OK",
+				data[1],
+				data[2],
+				data[3]
+			];
+		case "EOSE":
+			if (data.length !== 2 || typeof data[1] !== "string") throw new MessageError("invalid EOSE relay message");
+			return ["EOSE", data[1]];
+		case "CLOSED":
+			if (data.length !== 3 || typeof data[1] !== "string" || typeof data[2] !== "string") throw new MessageError("invalid CLOSED relay message");
+			return [
+				"CLOSED",
+				data[1],
+				data[2]
+			];
+		case "NOTICE":
+			if (data.length !== 2 || typeof data[1] !== "string") throw new MessageError("invalid NOTICE relay message");
+			return ["NOTICE", data[1]];
+		case "AUTH":
+			if (data.length !== 2 || typeof data[1] !== "string") throw new MessageError("invalid AUTH relay message");
+			return ["AUTH", data[1]];
+		case "COUNT": {
+			if (data.length !== 3 || typeof data[1] !== "string" || typeof data[2] !== "object" || data[2] === null || typeof data[2].count !== "number") throw new MessageError("invalid COUNT relay message");
+			const payload = data[2];
+			const result = { count: payload.count };
+			if (typeof payload.approximate === "boolean") result.approximate = payload.approximate;
+			const hll = parseCountHll(payload.hll);
+			if (hll !== void 0) result.hll = hll;
+			return [
+				"COUNT",
+				data[1],
+				result
+			];
+		}
+		case "NEG-MSG":
+			if (data.length !== 3 || typeof data[1] !== "string" || !isNegHex(data[2])) throw new MessageError("invalid NEG-MSG relay message");
+			return [
+				"NEG-MSG",
+				data[1],
+				data[2].toLowerCase()
+			];
+		case "NEG-ERR":
+			if (data.length !== 3 && data.length !== 4 || typeof data[1] !== "string" || typeof data[2] !== "string") throw new MessageError("invalid NEG-ERR relay message");
+			return [
+				"NEG-ERR",
+				data[1],
+				data[2]
+			];
+		default: throw new MessageError(`unknown relay message type: ${type}`);
+	}
+}
+function parseCountHll(value) {
+	if (typeof value !== "string" || value.length !== HLL_HEX_LEN || !HEX_RE.test(value)) return;
+	return value.toLowerCase();
+}
+function isFilterObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNegHex(value) {
+	return typeof value === "string" && value.length > 0 && value.length % 2 === 0 && HEX_RE.test(value);
+}
+//#endregion
+export { mergeCountHll as a, encodeRelayMessage as i, createSubscriptionId as n, parseClientMessage as o, encodeClientMessage as r, parseRelayMessage as s, assertSubscriptionId as t };
+
+//# sourceMappingURL=message-C_Uj-Y-c.mjs.map

package/dist/message-C_Uj-Y-c.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-C_Uj-Y-c.mjs","names":[],"sources":["../src/core/message.ts"],"sourcesContent":["import { MessageError } from \"./error.ts\";\nimport type { Event } from \"./event.ts\";\nimport { validateSignedEvent } from \"./event.ts\";\nimport type { Filter } from \"./filter.ts\";\nimport { SUBSCRIPTION_ID_MAX_CHARS } from \"./limits.ts\";\nimport { bytesToHex, hexToBytes } from \"./util.ts\";\n\nexport type SubscriptionId = string;\n\nexport function assertSubscriptionId(id: string): SubscriptionId {\n  if (id.length === 0 || id.length > SUBSCRIPTION_ID_MAX_CHARS) {\n    throw new MessageError(`subscription id length must be 1..${SUBSCRIPTION_ID_MAX_CHARS}`);\n  }\n  return id;\n}\n\nexport function createSubscriptionId(id?: string): SubscriptionId {\n  if (id !== undefined) return assertSubscriptionId(id);\n  const bytes = new Uint8Array(8);\n  crypto.getRandomValues(bytes);\n  return Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\n/** Client → relay messages (NIP-01 + NIP-42 AUTH + NIP-45 COUNT + NIP-77). */\nexport type ClientMessage =\n  | [\"EVENT\", Event]\n  | [\"REQ\", SubscriptionId, ...Filter[]]\n  | [\"CLOSE\", SubscriptionId]\n  | [\"AUTH\", Event]\n  | [\"COUNT\", SubscriptionId, ...Filter[]]\n  | [\"NEG-OPEN\", SubscriptionId, Filter, string]\n  | [\"NEG-MSG\", SubscriptionId, string]\n  | [\"NEG-CLOSE\", SubscriptionId];\n\n/** Relay → client messages. */\nexport type RelayMessage =\n  | [\"EVENT\", SubscriptionId, Event]\n  | [\"OK\", string, boolean, string]\n  | [\"EOSE\", SubscriptionId]\n  | [\"CLOSED\", SubscriptionId, string]\n  | [\"NOTICE\", string]\n  | [\"AUTH\", string]\n  | [\"COUNT\", SubscriptionId, CountResult]\n  | [\"NEG-MSG\", SubscriptionId, string]\n  | [\"NEG-ERR\", SubscriptionId, string];\n\n/** NIP-45 COUNT reply payload. */\nexport type CountResult = {\n  count: number;\n  approximate?: boolean;\n  /**\n   * Optional 512-char hex HyperLogLog sketch (256 registers).\n   * Merge sketches with `mergeCountHll`. Estimation is unspecified by NIP-45 and not provided.\n   */\n  hll?: string;\n};\n\nconst HLL_BYTES = 256; // 512 hex chars (NIP-45; hex only, not base64)\nconst HLL_HEX_LEN = HLL_BYTES * 2;\nconst HEX_RE = /^[0-9a-fA-F]+$/;\n\n/**\n * Register-wise max of NIP-45 HyperLogLog sketches.\n * Output is always lowercase 512 hex. Empty input is the zero sketch (identity).\n */\nexport function mergeCountHll(hexes: readonly string[]): string {\n  const merged = new Uint8Array(HLL_BYTES);\n  for (const hex of hexes) {\n    if (hex.length !== HLL_HEX_LEN || !HEX_RE.test(hex)) {\n      throw new MessageError(\"invalid NIP-45 HLL sketch: expected 512-char hex\");\n    }\n    const bytes = hexToBytes(hex);\n    for (let i = 0; i < HLL_BYTES; i++) {\n      const b = bytes[i]!;\n      if (b > merged[i]!) merged[i] = b;\n    }\n  }\n  return bytesToHex(merged);\n}\n\nexport function encodeClientMessage(message: ClientMessage): string {\n  return JSON.stringify(message);\n}\n\nexport function encodeRelayMessage(message: RelayMessage): string {\n  return JSON.stringify(message);\n}\n\nexport function parseClientMessage(raw: string): ClientMessage {\n  let data: unknown;\n  try {\n    data = JSON.parse(raw);\n  } catch {\n    throw new MessageError(\"client message is not valid JSON\");\n  }\n  if (!Array.isArray(data) || data.length < 1 || typeof data[0] !== \"string\") {\n    throw new MessageError(\"client message must be a non-empty JSON array\");\n  }\n  const type = data[0];\n  switch (type) {\n    case \"EVENT\": {\n      if (data.length !== 2 || !validateSignedEvent(data[1])) {\n        throw new MessageError(\"invalid EVENT client message\");\n      }\n      return [\"EVENT\", data[1]];\n    }\n    case \"REQ\": {\n      if (data.length < 3 || typeof data[1] !== \"string\") {\n        throw new MessageError(\"invalid REQ client message\");\n      }\n      return [\"REQ\", data[1], ...(data.slice(2) as Filter[])];\n    }\n    case \"CLOSE\": {\n      if (data.length !== 2 || typeof data[1] !== \"string\") {\n        throw new MessageError(\"invalid CLOSE client message\");\n      }\n      return [\"CLOSE\", data[1]];\n    }\n    case \"AUTH\": {\n      if (data.length !== 2 || !validateSignedEvent(data[1])) {\n        throw new MessageError(\"invalid AUTH client message\");\n      }\n      return [\"AUTH\", data[1]];\n    }\n    case \"COUNT\": {\n      if (data.length < 3 || typeof data[1] !== \"string\") {\n        throw new MessageError(\"invalid COUNT client message\");\n      }\n      return [\"COUNT\", data[1], ...(data.slice(2) as Filter[])];\n    }\n    case \"NEG-OPEN\": {\n      if (data.length === 5) {\n        throw new MessageError(\"obsolete 5-element NEG-OPEN; expected [NEG-OPEN, id, filter, hex]\");\n      }\n      if (\n        data.length !== 4 ||\n        typeof data[1] !== \"string\" ||\n        !isFilterObject(data[2]) ||\n        !isNegHex(data[3])\n      ) {\n        throw new MessageError(\"invalid NEG-OPEN client message\");\n      }\n      return [\"NEG-OPEN\", data[1], data[2], data[3].toLowerCase()];\n    }\n    case \"NEG-MSG\": {\n      if (data.length !== 3 || typeof data[1] !== \"string\" || !isNegHex(data[2])) {\n        throw new MessageError(\"invalid NEG-MSG client message\");\n      }\n      return [\"NEG-MSG\", data[1], data[2].toLowerCase()];\n    }\n    case \"NEG-CLOSE\": {\n      if (data.length !== 2 || typeof data[1] !== \"string\") {\n        throw new MessageError(\"invalid NEG-CLOSE client message\");\n      }\n      return [\"NEG-CLOSE\", data[1]];\n    }\n    default:\n      throw new MessageError(`unknown client message type: ${type}`);\n  }\n}\n\nexport function parseRelayMessage(raw: string): RelayMessage {\n  let data: unknown;\n  try {\n    data = JSON.parse(raw);\n  } catch {\n    throw new MessageError(\"relay message is not valid JSON\");\n  }\n  if (!Array.isArray(data) || data.length < 1 || typeof data[0] !== \"string\") {\n    throw new MessageError(\"relay message must be a non-empty JSON array\");\n  }\n  const type = data[0];\n  switch (type) {\n    case \"EVENT\": {\n      if (data.length !== 3 || typeof data[1] !== \"string\" || !validateSignedEvent(data[2])) {\n        throw new MessageError(\"invalid EVENT relay message\");\n      }\n      return [\"EVENT\", data[1], data[2]];\n    }\n    case \"OK\": {\n      if (\n        data.length !== 4 ||\n        typeof data[1] !== \"string\" ||\n        typeof data[2] !== \"boolean\" ||\n        typeof data[3] !== \"string\"\n      ) {\n        throw new MessageError(\"invalid OK relay message\");\n      }\n      return [\"OK\", data[1], data[2], data[3]];\n    }\n    case \"EOSE\": {\n      if (data.length !== 2 || typeof data[1] !== \"string\") {\n        throw new MessageError(\"invalid EOSE relay message\");\n      }\n      return [\"EOSE\", data[1]];\n    }\n    case \"CLOSED\": {\n      if (data.length !== 3 || typeof data[1] !== \"string\" || typeof data[2] !== \"string\") {\n        throw new MessageError(\"invalid CLOSED relay message\");\n      }\n      return [\"CLOSED\", data[1], data[2]];\n    }\n    case \"NOTICE\": {\n      if (data.length !== 2 || typeof data[1] !== \"string\") {\n        throw new MessageError(\"invalid NOTICE relay message\");\n      }\n      return [\"NOTICE\", data[1]];\n    }\n    case \"AUTH\": {\n      if (data.length !== 2 || typeof data[1] !== \"string\") {\n        throw new MessageError(\"invalid AUTH relay message\");\n      }\n      return [\"AUTH\", data[1]];\n    }\n    case \"COUNT\": {\n      if (\n        data.length !== 3 ||\n        typeof data[1] !== \"string\" ||\n        typeof data[2] !== \"object\" ||\n        data[2] === null ||\n        typeof (data[2] as { count?: unknown }).count !== \"number\"\n      ) {\n        throw new MessageError(\"invalid COUNT relay message\");\n      }\n      const payload = data[2] as { count: number; approximate?: unknown; hll?: unknown };\n      const result: CountResult = { count: payload.count };\n      if (typeof payload.approximate === \"boolean\") result.approximate = payload.approximate;\n      const hll = parseCountHll(payload.hll);\n      if (hll !== undefined) result.hll = hll;\n      return [\"COUNT\", data[1], result];\n    }\n    case \"NEG-MSG\": {\n      if (data.length !== 3 || typeof data[1] !== \"string\" || !isNegHex(data[2])) {\n        throw new MessageError(\"invalid NEG-MSG relay message\");\n      }\n      return [\"NEG-MSG\", data[1], data[2].toLowerCase()];\n    }\n    case \"NEG-ERR\": {\n      if (\n        (data.length !== 3 && data.length !== 4) ||\n        typeof data[1] !== \"string\" ||\n        typeof data[2] !== \"string\"\n      ) {\n        throw new MessageError(\"invalid NEG-ERR relay message\");\n      }\n      return [\"NEG-ERR\", data[1], data[2]];\n    }\n    default:\n      throw new MessageError(`unknown relay message type: ${type}`);\n  }\n}\n\nfunction parseCountHll(value: unknown): string | undefined {\n  if (typeof value !== \"string\" || value.length !== HLL_HEX_LEN || !HEX_RE.test(value)) {\n    return undefined;\n  }\n  return value.toLowerCase();\n}\n\nfunction isFilterObject(value: unknown): value is Filter {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isNegHex(value: unknown): value is string {\n  return (\n    typeof value === \"string\" && value.length > 0 && value.length % 2 === 0 && HEX_RE.test(value)\n  );\n}\n"],"mappings":"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"}

package/dist/message-DJC-Jz6T.d.mts

@@ -0,0 +1,32 @@
+import { t as Event } from "./event-B5D2jxt_.mjs";
+import { t as Filter } from "./filter-DUEKP3q1.mjs";
+//#region src/core/message.d.ts
+type SubscriptionId = string;
+declare function assertSubscriptionId(id: string): SubscriptionId;
+declare function createSubscriptionId(id?: string): SubscriptionId;
+/** Client → relay messages (NIP-01 + NIP-42 AUTH + NIP-45 COUNT + NIP-77). */
+type ClientMessage = ["EVENT", Event] | ["REQ", SubscriptionId, ...Filter[]] | ["CLOSE", SubscriptionId] | ["AUTH", Event] | ["COUNT", SubscriptionId, ...Filter[]] | ["NEG-OPEN", SubscriptionId, Filter, string] | ["NEG-MSG", SubscriptionId, string] | ["NEG-CLOSE", SubscriptionId];
+/** Relay → client messages. */
+type RelayMessage = ["EVENT", SubscriptionId, Event] | ["OK", string, boolean, string] | ["EOSE", SubscriptionId] | ["CLOSED", SubscriptionId, string] | ["NOTICE", string] | ["AUTH", string] | ["COUNT", SubscriptionId, CountResult] | ["NEG-MSG", SubscriptionId, string] | ["NEG-ERR", SubscriptionId, string];
+/** NIP-45 COUNT reply payload. */
+type CountResult = {
+  count: number;
+  approximate?: boolean;
+  /**
+   * Optional 512-char hex HyperLogLog sketch (256 registers).
+   * Merge sketches with `mergeCountHll`. Estimation is unspecified by NIP-45 and not provided.
+   */
+  hll?: string;
+};
+/**
+ * Register-wise max of NIP-45 HyperLogLog sketches.
+ * Output is always lowercase 512 hex. Empty input is the zero sketch (identity).
+ */
+declare function mergeCountHll(hexes: readonly string[]): string;
+declare function encodeClientMessage(message: ClientMessage): string;
+declare function encodeRelayMessage(message: RelayMessage): string;
+declare function parseClientMessage(raw: string): ClientMessage;
+declare function parseRelayMessage(raw: string): RelayMessage;
+//#endregion
+export { assertSubscriptionId as a, encodeRelayMessage as c, parseRelayMessage as d, SubscriptionId as i, mergeCountHll as l, CountResult as n, createSubscriptionId as o, RelayMessage as r, encodeClientMessage as s, ClientMessage as t, parseClientMessage as u };
+//# sourceMappingURL=message-DJC-Jz6T.d.mts.map

package/dist/nip17-BWq-Kfq5.d.mts

@@ -0,0 +1,38 @@
+import { t as Event, v as Tag } from "./event-B5D2jxt_.mjs";
+import { t as EventBuilder } from "./builder-BphJa-Y-.mjs";
+import { a as NostrError } from "./error-WEFS-R-4.mjs";
+import { a as Rumor, l as WrapOptions, r as Nip59Crypto } from "./nip59-DljW_sYh.mjs";
+//#region src/nips/nip17.d.ts
+declare class Nip17Error extends NostrError {
+  constructor(message: string, options?: ErrorOptions);
+}
+type Recipient = {
+  readonly pubkey: string;
+  readonly relayHint?: string;
+};
+type ReplyTo = {
+  readonly id: string;
+  readonly relayHint?: string;
+};
+type ChatMessageOptions = {
+  readonly created_at?: number;
+  readonly subject?: string;
+  readonly replyTo?: ReplyTo;
+};
+/** Parse kind:10050 DM relay list (`["relay", url]` tags). */
+declare function parseDmRelayList(event: Pick<Event, "kind" | "tags">): string[];
+/** Encode DM relay URLs as NIP-17 `relay` tags. */
+declare function dmRelayListToTags(relays: readonly string[]): Tag[];
+/** Build an unsigned kind:10050 EventBuilder. */
+declare function dmRelayListEventBuilder(relays: readonly string[]): EventBuilder;
+/** Accept a hex pubkey, a Recipient, or a readonly array of either. Dedup by pubkey. */
+declare function normalizeRecipients(input: string | Recipient | readonly (string | Recipient)[]): Recipient[];
+declare function buildChatMessageRumor(senderPubkey: string, recipients: readonly Recipient[], content: string, opts?: ChatMessageOptions): Rumor;
+declare function wrapDirectMessage(crypto: Nip59Crypto, recipients: readonly Recipient[], rumor: Rumor, opts?: Pick<WrapOptions, "now" | "randomInt" | "timestamps" | "randomize">): Promise<ReadonlyArray<{
+  recipient: string;
+  wrap: Event;
+}>>;
+declare function requireDmRelays(pubkey: string, relays: readonly string[]): string[];
+//#endregion
+export { buildChatMessageRumor as a, normalizeRecipients as c, wrapDirectMessage as d, ReplyTo as i, parseDmRelayList as l, Nip17Error as n, dmRelayListEventBuilder as o, Recipient as r, dmRelayListToTags as s, ChatMessageOptions as t, requireDmRelays as u };
+//# sourceMappingURL=nip17-BWq-Kfq5.d.mts.map

package/dist/nip19-D7905oIv.d.mts

@@ -0,0 +1,63 @@
+import { a as NostrError } from "./error-WEFS-R-4.mjs";
+//#region src/nips/nip19.d.ts
+type NProfile = `nprofile1${string}`;
+type NEvent = `nevent1${string}`;
+type NAddr = `naddr1${string}`;
+type NSec = `nsec1${string}`;
+type NPub = `npub1${string}`;
+type Note = `note1${string}`;
+declare const Bech32MaxSize = 5000;
+type ProfilePointer = {
+  pubkey: string;
+  relays?: string[];
+};
+type EventPointer = {
+  id: string;
+  relays?: string[];
+  author?: string;
+  kind?: number;
+};
+type AddressPointer = {
+  identifier: string;
+  pubkey: string;
+  kind: number;
+  relays?: string[];
+};
+type DecodedResult = {
+  type: "nprofile";
+  data: ProfilePointer;
+} | {
+  type: "nevent";
+  data: EventPointer;
+} | {
+  type: "naddr";
+  data: AddressPointer;
+} | {
+  type: "nsec";
+  data: Uint8Array;
+} | {
+  type: "npub";
+  data: string;
+} | {
+  type: "note";
+  data: string;
+};
+declare class Nip19Error extends NostrError {
+  constructor(message: string);
+}
+declare function encodeBytes<Prefix extends string>(prefix: Prefix, bytes: Uint8Array): `${Prefix}1${string}`;
+declare function nsecEncode(key: Uint8Array): NSec;
+declare function npubEncode(hex: string): NPub;
+declare function noteEncode(hex: string): Note;
+declare function nprofileEncode(profile: ProfilePointer): NProfile;
+declare function neventEncode(event: EventPointer): NEvent;
+declare function naddrEncode(addr: AddressPointer): NAddr;
+declare function decode(code: string): DecodedResult;
+/** Decode `nostr:` URI or bare bech32; returns invalid sentinel instead of throwing. */
+declare function decodeNostrURI(nip19code: string): DecodedResult | {
+  type: "invalid";
+  data: null;
+};
+//#endregion
+export { neventEncode as _, NAddr as a, npubEncode as b, NPub as c, Note as d, ProfilePointer as f, naddrEncode as g, encodeBytes as h, EventPointer as i, NSec as l, decodeNostrURI as m, Bech32MaxSize as n, NEvent as o, decode as p, DecodedResult as r, NProfile as s, AddressPointer as t, Nip19Error as u, noteEncode as v, nsecEncode as x, nprofileEncode as y };
+//# sourceMappingURL=nip19-D7905oIv.d.mts.map

package/dist/nip46-C_DoxiS_.d.mts

@@ -0,0 +1,51 @@
+import { a as NostrError } from "./error-WEFS-R-4.mjs";
+//#region src/nips/nip46.d.ts
+declare const BUNKER_REGEX: RegExp;
+type BunkerPointer = {
+  /** Remote signer / bunker public key (hex). */
+  pubkey: string;
+  relays: string[];
+  secret: string | null;
+};
+type ClientMetadata = {
+  name?: string;
+  url?: string;
+  image?: string;
+};
+type NostrConnectParams = {
+  clientPubkey: string;
+  relays: string[];
+  secret: string;
+  perms?: string[];
+} & ClientMetadata;
+type Nip46Request = {
+  id: string;
+  method: string;
+  params: string[];
+};
+type Nip46Response = {
+  id: string;
+  result?: string;
+  error?: string;
+};
+declare class Nip46Error extends NostrError {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** Encode a bunker pointer as `bunker://…`. */
+declare function toBunkerURL(pointer: BunkerPointer): string;
+/**
+ * Parse a `bunker://` URL into a pointer.
+ * Returns null when the input is not a bunker URL (including NIP-05 identifiers).
+ */
+declare function parseBunkerURL(input: string): BunkerPointer | null;
+/** Build a client-initiated `nostrconnect://` URI. */
+declare function createNostrConnectURI(params: NostrConnectParams): string;
+/** Parse a `nostrconnect://` URI. */
+declare function parseNostrConnectURI(uri: string): NostrConnectParams;
+declare function encodeNip46Request(req: Nip46Request): string;
+declare function decodeNip46Request(json: string): Nip46Request;
+declare function encodeNip46Response(res: Nip46Response): string;
+declare function decodeNip46Response(json: string): Nip46Response;
+//#endregion
+export { Nip46Request as a, createNostrConnectURI as c, encodeNip46Request as d, encodeNip46Response as f, toBunkerURL as h, Nip46Error as i, decodeNip46Request as l, parseNostrConnectURI as m, BunkerPointer as n, Nip46Response as o, parseBunkerURL as p, ClientMetadata as r, NostrConnectParams as s, BUNKER_REGEX as t, decodeNip46Response as u };
+//# sourceMappingURL=nip46-C_DoxiS_.d.mts.map

package/dist/nip59-DljW_sYh.d.mts

@@ -0,0 +1,76 @@
+import { r as UnsignedEvent, t as Event, v as Tag } from "./event-B5D2jxt_.mjs";
+import { a as NostrError } from "./error-WEFS-R-4.mjs";
+//#region src/nips/nip59.d.ts
+/** Unsigned event with a computed id. Never has `sig`. */
+type Rumor = UnsignedEvent & {
+  readonly id: string;
+};
+/**
+ * Structural crypto used by NIP-59.
+ * Satisfied by NostrSigner when nip44Encrypt/nip44Decrypt are present.
+ * This module must not import src/signer/.
+ */
+type Nip59Crypto = {
+  getPublicKey(): Promise<string>;
+  signEvent(unsigned: UnsignedEvent): Promise<Event>;
+  nip44Encrypt(peer: string, plaintext: string): Promise<string>;
+  nip44Decrypt(peer: string, payload: string): Promise<string>;
+};
+type Nip44Decryptor = {
+  nip44Decrypt(peer: string, payload: string): Promise<string>;
+};
+type GiftWrapTimestamps = {
+  readonly seal: number;
+  readonly wrap: number;
+};
+/** `"wrap"` randomizes only the gift wrap; `"seal+wrap"` (default) randomizes both. */
+type TimestampRandomize = "wrap" | "seal+wrap";
+type WrapOptions = {
+  /** Unix seconds used as the randomization window end. Default: floor(Date.now()/1000). */
+  readonly now?: number;
+  /** Uniform integer in [0, maxExclusive). Default: CSPRNG via @noble/hashes randomBytes. */
+  readonly randomInt?: (maxExclusive: number) => number;
+  /** When set, used as-is. Overrides now/randomInt for this call. */
+  readonly timestamps?: GiftWrapTimestamps;
+  readonly relayHint?: string;
+  /** Appended after the required wrap `p` tag. Never applied to the seal. */
+  readonly extraTags?: readonly Tag[];
+  /** Default `"seal+wrap"` (NIP-59). `"wrap"` = only wrap timestamp is randomized; seal uses rumor.created_at. */
+  readonly randomize?: TimestampRandomize;
+};
+type SealOptions = Pick<WrapOptions, "now" | "randomInt" | "timestamps" | "randomize">;
+declare class Nip59Error extends NostrError {
+  constructor(message: string, options?: ErrorOptions);
+}
+declare const TWO_DAYS_SECS: number;
+declare function isGiftWrapKind(kind: number): boolean;
+type Nip59CryptoInput = {
+  getPublicKey(): Promise<string>;
+  signEvent(unsigned: UnsignedEvent): Promise<Event>;
+  nip44Encrypt?: (peer: string, plaintext: string) => Promise<string>;
+  nip44Decrypt?: (peer: string, payload: string) => Promise<string>;
+};
+/** Narrow a signer-shaped object to {@link Nip59Crypto}, or throw. */
+declare function requireNip59Crypto(crypto: Nip59CryptoInput): Nip59Crypto;
+declare function requireNip44Decryptor(crypto: {
+  nip44Decrypt?: (peer: string, payload: string) => Promise<string>;
+}): Nip44Decryptor;
+declare function rumorToJson(rumor: Rumor): string;
+declare function eventToJson(event: Event): string;
+declare function randomPastTimestamp(opts?: {
+  now?: number;
+  randomInt?: (maxExclusive: number) => number;
+}): number;
+declare function createRumor(pubkey: string, template: {
+  kind: number;
+  content?: string;
+  tags?: readonly Tag[];
+  created_at?: number;
+}): Rumor;
+declare function createSeal(crypto: Nip59Crypto, recipient: string, rumor: Rumor, opts?: SealOptions): Promise<Event>;
+declare function createGiftWrap(seal: Event, recipient: string, opts?: WrapOptions): Event;
+declare function wrap(crypto: Nip59Crypto, recipient: string, rumor: Rumor, opts?: WrapOptions): Promise<Event>;
+declare function unwrap(crypto: Nip44Decryptor, giftWrap: Event): Promise<Rumor>;
+//#endregion
+export { requireNip59Crypto as _, Rumor as a, wrap as b, TimestampRandomize as c, createRumor as d, createSeal as f, requireNip44Decryptor as g, randomPastTimestamp as h, Nip59Error as i, WrapOptions as l, isGiftWrapKind as m, Nip44Decryptor as n, SealOptions as o, eventToJson as p, Nip59Crypto as r, TWO_DAYS_SECS as s, GiftWrapTimestamps as t, createGiftWrap as u, rumorToJson as v, unwrap as y };
+//# sourceMappingURL=nip59-DljW_sYh.d.mts.map

package/dist/nip65-Di5hZRuV.d.mts

@@ -0,0 +1,21 @@
+import { t as Event, v as Tag } from "./event-B5D2jxt_.mjs";
+import { t as EventBuilder } from "./builder-BphJa-Y-.mjs";
+//#region src/nips/nip65.d.ts
+type RelayMarker = "read" | "write" | "readwrite";
+type RelayListItem = {
+  url: string;
+  read: boolean;
+  write: boolean;
+};
+declare function markerOf(item: RelayListItem): RelayMarker;
+/** Parse a kind:10002 NIP-65 event into relay list entries. */
+declare function parseRelayList(event: Event): RelayListItem[];
+/** Encode relay list items as NIP-65 `r` tags. */
+declare function relayListToTags(items: RelayListItem[]): Tag[];
+/** Build an unsigned kind:10002 EventBuilder from relay list items. */
+declare function relayListEventBuilder(items: RelayListItem[]): EventBuilder;
+declare function readRelays(items: RelayListItem[]): string[];
+declare function writeRelays(items: RelayListItem[]): string[];
+//#endregion
+export { readRelays as a, writeRelays as c, parseRelayList as i, RelayMarker as n, relayListEventBuilder as o, markerOf as r, relayListToTags as s, RelayListItem as t };
+//# sourceMappingURL=nip65-Di5hZRuV.d.mts.map

package/dist/nip77-ByxlgoQO.d.mts

@@ -0,0 +1,55 @@
+import { t as Event } from "./event-B5D2jxt_.mjs";
+import { a as NostrError } from "./error-WEFS-R-4.mjs";
+//#region src/nips/nip77.d.ts
+declare const PROTOCOL_VERSION = 97;
+declare const DEFAULT_FRAME_SIZE_LIMIT = 60000;
+declare const MAX_NEG_ROUNDS = 1024;
+declare class Nip77Error extends NostrError {
+  constructor(message: string, options?: ErrorOptions);
+}
+type NegItem = {
+  timestamp: number;
+  id: Uint8Array;
+};
+type ReconcileOutcome = {
+  /** Event ids the local side holds that the peer does not. */
+  have: string[];
+  /** Event ids the peer holds that the local side does not. */
+  need: string[];
+  /** Next NEG-MSG hex, or null when the session converged. */
+  nextMessage: string | null;
+};
+declare class NegentropyStorageVector {
+  #private;
+  insert(timestamp: number, id: string): void;
+  seal(): void;
+  size(): number;
+  iterate(begin: number, end: number, cb: (item: NegItem, i: number) => boolean): void;
+  findLowerBound(begin: number, end: number, bound: NegItem): number;
+  fingerprint(begin: number, end: number): Uint8Array;
+}
+declare function storageFromItems(items: readonly {
+  id: string;
+  created_at: number;
+}[]): NegentropyStorageVector;
+declare function storageFromEvents(events: readonly Pick<Event, "id" | "created_at">[]): NegentropyStorageVector;
+declare class Negentropy {
+  #private;
+  constructor(storage: NegentropyStorageVector, frameSizeLimit?: number);
+  initiate(): string;
+  reconcile(queryMsg: string): ReconcileOutcome;
+}
+/** Drive initiate/reconcile until nextMessage is null. Transport-free. */
+declare function runNegSession(opts: {
+  storage: NegentropyStorageVector;
+  frameSizeLimit?: number;
+  openingSend: (hex: string) => void;
+  msgSend: (hex: string) => void;
+  next: () => Promise<string>;
+}): Promise<{
+  have: string[];
+  need: string[];
+}>;
+//#endregion
+export { NegentropyStorageVector as a, ReconcileOutcome as c, storageFromItems as d, Negentropy as i, runNegSession as l, MAX_NEG_ROUNDS as n, Nip77Error as o, NegItem as r, PROTOCOL_VERSION as s, DEFAULT_FRAME_SIZE_LIMIT as t, storageFromEvents as u };
+//# sourceMappingURL=nip77-ByxlgoQO.d.mts.map

package/dist/nips/blossom.d.mts

@@ -0,0 +1,93 @@
+import { n as EventTemplate, t as Event } from "../event-B5D2jxt_.mjs";
+import { t as EventBuilder } from "../builder-BphJa-Y-.mjs";
+import { a as NostrError } from "../error-WEFS-R-4.mjs";
+import { t as ManualFetch } from "../http-6vevbBlu.mjs";
+//#region src/nips/blossom.d.ts
+type BlobDescriptor = {
+  url: string;
+  sha256: string;
+  size: number;
+  type?: string;
+  uploaded?: number;
+};
+type BlossomFetch = ManualFetch;
+/** Signs a kind 24242 auth template (draft; pubkey is filled by the signer). */
+type BlossomSign = (template: EventTemplate) => Promise<Event>;
+/** BUD-11 `t` verbs. Mirror reuses `upload`; there is no `t=mirror`. */
+type BlossomAuthVerb = "upload" | "delete" | "list" | "get" | "media";
+declare class BlossomError extends NostrError {
+  readonly status?: number;
+  constructor(message: string, options?: ErrorOptions & {
+    status?: number;
+  });
+}
+/** Last 64-char hex in the URL path (extension ignored). Null if none or the URL is invalid. */
+declare function getHashFromURL(url: string | URL): string | null;
+declare function sha256Blob(data: Blob | ArrayBuffer | Uint8Array): Promise<string>;
+/** True when `sha256Blob(data)` equals the expected hex (any case). */
+declare function verifyBlob(data: Blob | ArrayBuffer | Uint8Array, sha256Hex: string): Promise<boolean>;
+/**
+ * `Nostr ` + base64url(utf8 JSON), padding stripped.
+ * NIP-98 uses standard base64; mixing them is a 401.
+ */
+declare function encodeAuthorizationHeader(event: Event): string;
+declare function createAuthTemplate(verb: BlossomAuthVerb, opts?: {
+  sha256?: string;
+  expiration?: number;
+  message?: string;
+}): EventTemplate;
+declare function createUploadAuth(sign: BlossomSign, file: Blob, opts?: {
+  message?: string;
+  expiration?: number;
+}): Promise<Event>;
+declare function upload(server: string, file: Blob, auth: Event, opts?: {
+  fetch?: BlossomFetch;
+  signal?: AbortSignal;
+}): Promise<BlobDescriptor>;
+declare function listBlobs(server: string, pubkey: string, auth: Event | undefined, opts?: {
+  fetch?: BlossomFetch;
+  signal?: AbortSignal;
+}): Promise<BlobDescriptor[]>;
+declare function deleteBlob(server: string, sha256Hex: string, auth: Event, opts?: {
+  fetch?: BlossomFetch;
+  signal?: AbortSignal;
+}): Promise<void>;
+declare function mirrorBlob(server: string, blob: BlobDescriptor, opts: {
+  auth: Event;
+  fetch?: BlossomFetch;
+  signal?: AbortSignal;
+}): Promise<BlobDescriptor>;
+/** BUD-06 preflight. Does not PUT the body. */
+declare function checkUpload(server: string, file: Blob, auth: Event, opts?: {
+  fetch?: BlossomFetch;
+  signal?: AbortSignal;
+}): Promise<void>;
+/** Strict HEAD probe. 2xx → true. 404 → false. Other HTTP (including 405) / network → throw BlossomError. AbortError propagates. No GET fallback. */
+declare function blobExists(server: string, sha256Hex: string, opts?: {
+  fetch?: BlossomFetch;
+  signal?: AbortSignal;
+}): Promise<boolean>;
+/** GET body, then verifyBlob. Non-2xx or sha256 mismatch → throw BlossomError. */
+declare function getBlob(server: string, sha256Hex: string, opts?: {
+  fetch?: BlossomFetch;
+  signal?: AbortSignal;
+}): Promise<Uint8Array>;
+/**
+ * If `url` is not available, try `servers` for the same hash (NIP-B7 SHOULD).
+ * Never throws on HTTP status. AbortError still throws.
+ * Returns the original URL when no hash, original still available, or nothing else responds.
+ */
+declare function healBlobUrl(url: string, servers: readonly string[], opts?: {
+  fetch?: BlossomFetch;
+  signal?: AbortSignal;
+}): Promise<string>;
+/** PUT /upload to each server in order until one descriptor succeeds. */
+declare function uploadToServers(servers: readonly string[], file: Blob, auth: Event, opts?: {
+  fetch?: BlossomFetch;
+  signal?: AbortSignal;
+}): Promise<BlobDescriptor>;
+declare function blossomServerListEventBuilder(servers: readonly string[]): EventBuilder;
+declare function parseBlossomServerList(event: Pick<Event, "kind" | "tags">): string[];
+//#endregion
+export { BlobDescriptor, BlossomAuthVerb, BlossomError, BlossomFetch, BlossomSign, blobExists, blossomServerListEventBuilder, checkUpload, createAuthTemplate, createUploadAuth, deleteBlob, encodeAuthorizationHeader, getBlob, getHashFromURL, healBlobUrl, listBlobs, mirrorBlob, parseBlossomServerList, sha256Blob, upload, uploadToServers, verifyBlob };
+//# sourceMappingURL=blossom.d.mts.map