@qntx/nostr 0.0.1

package/dist/nips/nip57.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip57.mjs","names":[],"sources":["../../src/nips/nip57.ts"],"sourcesContent":["/**\n * NIP-57 Lightning Zaps — zap request template (kind 9734) and receipt validation (kind 9735).\n * Does not fetch LNURL. Receipt checks never throw.\n *\n * @see https://github.com/nostr-protocol/nips/blob/master/57.md\n */\nimport { sha256 } from \"@noble/hashes/sha2.js\";\nimport { bech32 } from \"@scure/base\";\nimport { EventValidationError } from \"../core/error.ts\";\nimport { validateSignedEvent, type Event, type EventTemplate } from \"../core/event.ts\";\nimport { verifyEvent } from \"../core/key.ts\";\nimport { isAddressableKind, Kind } from \"../core/kind.ts\";\nimport { eventAddress, getDTag, parseEventAddress, Tag } from \"../core/tag.ts\";\nimport { hexToBytes, utf8Encoder } from \"../core/util.ts\";\n\nexport type ProfileZapRequest = {\n  pubkey: string;\n  /** Amount in millisats. */\n  amount: number;\n  relays: readonly string[];\n  comment?: string;\n  lnurl?: string;\n};\n\nexport type EventZapRequest = {\n  event: Event;\n  /** Amount in millisats. */\n  amount: number;\n  relays: readonly string[];\n  comment?: string;\n  lnurl?: string;\n};\n\nexport function makeZapRequest(params: ProfileZapRequest | EventZapRequest): EventTemplate {\n  if (params.relays.length === 0) {\n    throw new EventValidationError(\"relays tag requires one or more URLs\");\n  }\n\n  const recipient = \"event\" in params ? params.event.pubkey : params.pubkey;\n  const tags: Tag[] = [\n    Tag.p(recipient),\n    [\"amount\", params.amount.toString()],\n    [\"relays\", ...params.relays],\n  ];\n\n  if (\"event\" in params) {\n    const { event } = params;\n    tags.push(Tag.e(event.id));\n    if (isAddressableKind(event.kind)) {\n      const d = getDTag(event.tags);\n      if (d === undefined) throw new EventValidationError(\"d tag not found\");\n      const addr = eventAddress(event);\n      if (addr) tags.push([\"a\", addr]);\n    }\n    tags.push([\"k\", event.kind.toString()]);\n  }\n\n  if (params.lnurl) tags.push([\"lnurl\", params.lnurl]);\n\n  return {\n    kind: Kind.ZapRequest,\n    created_at: Math.floor(Date.now() / 1000),\n    content: params.comment ?? \"\",\n    tags,\n  };\n}\n\nexport type ZapReceiptContext = {\n  nostrPubkey: string;\n  lnurl?: string;\n};\n\nexport type ZapReceiptValidation = {\n  valid: boolean;\n  reason?: string;\n  request?: Event;\n  amountMsats?: number;\n};\n\nexport type Bolt11Fields = {\n  amountMsats?: number;\n  descriptionHash?: Uint8Array;\n  paymentHash?: Uint8Array;\n};\n\nfunction firstTagValue(tags: readonly Tag[], name: string): string | undefined {\n  for (const tag of tags) {\n    if (tag[0] === name && tag[1] !== undefined) return tag[1];\n  }\n  return undefined;\n}\n\nfunction bytesEq(a: Uint8Array, b: Uint8Array): boolean {\n  if (a.length !== b.length) return false;\n  let x = 0;\n  for (let i = 0; i < a.length; i++) x |= a[i]! ^ b[i]!;\n  return x === 0;\n}\n\nfunction fail(reason: string): ZapReceiptValidation {\n  return { valid: false, reason };\n}\n\nconst MSATS_PER_BTC = 100_000_000_000;\nconst MSATS_PER_MILLI = 100_000_000;\nconst MSATS_PER_MICRO = 100_000;\nconst MSATS_PER_NANO = 100;\n\n/** Amount is digits after `ln` + currency letters, optional m/u/n/p. Non-integer pico is omitted. */\nfunction amountMsatsFromHrp(hrp: string): number | undefined {\n  if (!hrp.startsWith(\"ln\")) return undefined;\n  let i = 2;\n  while (i < hrp.length) {\n    const c = hrp.charCodeAt(i);\n    if (c < 97 || c > 122) break;\n    i++;\n  }\n  if (i === hrp.length) return undefined;\n  const rest = hrp.slice(i);\n  const m = /^([0-9]+)([munp])?$/.exec(rest);\n  if (!m) return undefined;\n  const n = Number(m[1]);\n  if (!Number.isSafeInteger(n)) return undefined;\n  const mul = m[2];\n  if (mul === undefined) return n * MSATS_PER_BTC;\n  if (mul === \"m\") return n * MSATS_PER_MILLI;\n  if (mul === \"u\") return n * MSATS_PER_MICRO;\n  if (mul === \"n\") return n * MSATS_PER_NANO;\n  // p: 0.1 msat; drop amounts that are not whole millisats\n  if (n % 10 !== 0) return undefined;\n  return n / 10;\n}\n\nfunction parseMsatsTag(value: string): number | undefined {\n  if (!/^[0-9]+$/.test(value)) return undefined;\n  const n = Number(value);\n  return Number.isSafeInteger(n) ? n : undefined;\n}\n\nfunction countTags(tags: readonly Tag[], name: string): number {\n  let n = 0;\n  for (const tag of tags) {\n    if (tag[0] === name) n++;\n  }\n  return n;\n}\n\nfunction hasHexTagValue(tags: readonly Tag[], name: string, value: string): boolean {\n  const needle = value.toLowerCase();\n  for (const tag of tags) {\n    if (tag[0] === name && tag[1] !== undefined && tag[1].toLowerCase() === needle) return true;\n  }\n  return false;\n}\n\nfunction hasAddressTag(tags: readonly Tag[], value: string): boolean {\n  const want = parseEventAddress(value);\n  if (!want) return false;\n  for (const tag of tags) {\n    if (tag[0] !== \"a\" || tag[1] === undefined) continue;\n    const got = parseEventAddress(tag[1]);\n    if (\n      got &&\n      got.kind === want.kind &&\n      got.pubkey === want.pubkey &&\n      got.identifier === want.identifier\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\nconst BOLT11_TIMESTAMP_WORDS = 7;\nconst BOLT11_SIGNATURE_WORDS = 104;\nconst BOLT11_HASH_WORDS = 52;\nconst HASH_BYTES = 32;\n\n/** Decode a BOLT11 invoice. Never throws. Requires a 32-byte payment hash (type 1). */\nexport function parseBolt11(pr: string): Bolt11Fields | undefined {\n  try {\n    // Invoices exceed bech32's default 90-char limit.\n    const { prefix, words } = bech32.decode(pr.toLowerCase() as `${string}1${string}`, false);\n    if (!prefix.startsWith(\"ln\")) return undefined;\n    // timestamp (7) + tagged fields + secp256k1 signature (104)\n    if (words.length < BOLT11_TIMESTAMP_WORDS + BOLT11_SIGNATURE_WORDS) return undefined;\n    const fields: Bolt11Fields = {};\n    const amountMsats = amountMsatsFromHrp(prefix);\n    if (amountMsats !== undefined) fields.amountMsats = amountMsats;\n    const tlvEnd = words.length - BOLT11_SIGNATURE_WORDS;\n    let i = BOLT11_TIMESTAMP_WORDS;\n    while (i + 3 <= tlvEnd) {\n      const type = words[i]!;\n      const dataLen = (words[i + 1]! << 5) | words[i + 2]!;\n      i += 3;\n      if (i + dataLen > tlvEnd) break;\n      const data = words.slice(i, i + dataLen);\n      i += dataLen;\n      if ((type !== 1 && type !== 23) || dataLen !== BOLT11_HASH_WORDS) continue;\n      const bytes = bech32.fromWordsUnsafe(data);\n      if (!bytes || bytes.length !== HASH_BYTES) continue;\n      if (type === 1) fields.paymentHash ??= bytes;\n      else fields.descriptionHash ??= bytes;\n    }\n    if (!fields.paymentHash) return undefined;\n    return fields;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Parse the `description` tag of a kind 9735 receipt as a signed kind 9734. Never throws. */\nexport function parseZapRequestFromReceipt(receipt: Event): Event | undefined {\n  try {\n    const raw = firstTagValue(receipt.tags, \"description\");\n    if (raw === undefined) return undefined;\n    const parsed: unknown = JSON.parse(raw);\n    if (!validateSignedEvent(parsed) || parsed.kind !== Kind.ZapRequest) return undefined;\n    if (!verifyEvent(parsed)) return undefined;\n    return parsed;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Validate a kind 9735 zap receipt. Never throws. */\nexport function validateZapReceipt(receipt: Event, ctx: ZapReceiptContext): ZapReceiptValidation {\n  try {\n    if (receipt.kind !== Kind.Zap || !verifyEvent(receipt)) {\n      return fail(\"invalid receipt\");\n    }\n    if (receipt.pubkey.toLowerCase() !== ctx.nostrPubkey.toLowerCase()) {\n      return fail(\"pubkey mismatch\");\n    }\n\n    const descriptionRaw = firstTagValue(receipt.tags, \"description\");\n    const request = parseZapRequestFromReceipt(receipt);\n    if (descriptionRaw === undefined || !request) return fail(\"invalid zap request\");\n    if (countTags(request.tags, \"p\") !== 1) return fail(\"invalid p count\");\n    if (countTags(request.tags, \"e\") > 1) return fail(\"too many e tags\");\n    if (!firstTagValue(request.tags, \"relays\")) return fail(\"missing relays\");\n\n    for (const tag of request.tags) {\n      if (tag[0] !== \"a\") continue;\n      if (tag[1] === undefined) return fail(\"invalid a\");\n      const parsed = parseEventAddress(tag[1]);\n      if (!parsed || !isAddressableKind(parsed.kind)) return fail(\"invalid a\");\n    }\n\n    // Request P is the LNURL provider (receipt pubkey), not the zap sender.\n    const requestPCount = countTags(request.tags, \"P\");\n    if (requestPCount > 1) return fail(\"too many P tags\");\n    if (requestPCount === 1) {\n      const requestP = firstTagValue(request.tags, \"P\");\n      if (requestP === undefined || requestP.toLowerCase() !== receipt.pubkey.toLowerCase()) {\n        return fail(\"request P mismatch\");\n      }\n    }\n\n    const bolt11Tag = firstTagValue(receipt.tags, \"bolt11\");\n    if (bolt11Tag === undefined) return fail(\"missing bolt11\");\n    const bolt11 = parseBolt11(bolt11Tag);\n    if (!bolt11 || !bolt11.descriptionHash) return fail(\"invalid bolt11\");\n\n    const requestAmount = firstTagValue(request.tags, \"amount\");\n    if (requestAmount !== undefined) {\n      const msats = parseMsatsTag(requestAmount);\n      if (msats === undefined || bolt11.amountMsats !== msats) return fail(\"amount mismatch\");\n    }\n\n    // Hash the tag payload, not JSON.stringify(parsed) (key order may differ).\n    const digest = sha256(utf8Encoder.encode(descriptionRaw));\n    if (!bytesEq(digest, bolt11.descriptionHash)) return fail(\"description hash mismatch\");\n\n    const requestLnurl = firstTagValue(request.tags, \"lnurl\");\n    if (requestLnurl !== undefined && ctx.lnurl !== undefined) {\n      if (requestLnurl.toLowerCase() !== ctx.lnurl.toLowerCase()) return fail(\"lnurl mismatch\");\n    }\n\n    const preimageHex = firstTagValue(receipt.tags, \"preimage\");\n    if (preimageHex !== undefined && bolt11.paymentHash) {\n      let preimage: Uint8Array;\n      try {\n        preimage = hexToBytes(preimageHex);\n      } catch {\n        return fail(\"preimage mismatch\");\n      }\n      if (!bytesEq(sha256(preimage), bolt11.paymentHash)) return fail(\"preimage mismatch\");\n    }\n\n    const recipient = firstTagValue(request.tags, \"p\");\n    if (recipient === undefined || !hasHexTagValue(receipt.tags, \"p\", recipient)) {\n      return fail(\"missing p\");\n    }\n    const requestE = firstTagValue(request.tags, \"e\");\n    if (requestE !== undefined && !hasHexTagValue(receipt.tags, \"e\", requestE)) {\n      return fail(\"missing e\");\n    }\n    for (const tag of request.tags) {\n      if (tag[0] !== \"a\" || tag[1] === undefined) continue;\n      if (!hasAddressTag(receipt.tags, tag[1])) return fail(\"missing a\");\n    }\n\n    // Receipt P is the zap sender (request pubkey). Do not copy request tag P.\n    for (const tag of receipt.tags) {\n      if (tag[0] !== \"P\") continue;\n      if (tag[1] === undefined || tag[1].toLowerCase() !== request.pubkey.toLowerCase()) {\n        return fail(\"receipt P mismatch\");\n      }\n    }\n\n    const amountMsats =\n      bolt11.amountMsats ??\n      (requestAmount !== undefined ? parseMsatsTag(requestAmount) : undefined);\n    return amountMsats === undefined\n      ? { valid: true, request }\n      : { valid: true, request, amountMsats };\n  } catch {\n    return fail(\"invalid receipt\");\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAiCA,SAAgB,eAAe,QAA4D;CACzF,IAAI,OAAO,OAAO,WAAW,GAC3B,MAAM,IAAI,qBAAqB,sCAAsC;CAGvE,MAAM,YAAY,WAAW,SAAS,OAAO,MAAM,SAAS,OAAO;CACnE,MAAM,OAAc;EAClB,IAAI,EAAE,SAAS;EACf,CAAC,UAAU,OAAO,OAAO,SAAS,CAAC;EACnC,CAAC,UAAU,GAAG,OAAO,MAAM;CAC7B;CAEA,IAAI,WAAW,QAAQ;EACrB,MAAM,EAAE,UAAU;EAClB,KAAK,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC;EACzB,IAAI,kBAAkB,MAAM,IAAI,GAAG;GAEjC,IADU,QAAQ,MAAM,IACpB,MAAM,KAAA,GAAW,MAAM,IAAI,qBAAqB,iBAAiB;GACrE,MAAM,OAAO,aAAa,KAAK;GAC/B,IAAI,MAAM,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC;EACjC;EACA,KAAK,KAAK,CAAC,KAAK,MAAM,KAAK,SAAS,CAAC,CAAC;CACxC;CAEA,IAAI,OAAO,OAAO,KAAK,KAAK,CAAC,SAAS,OAAO,KAAK,CAAC;CAEnD,OAAO;EACL,MAAM,KAAK;EACX,YAAY,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;EACxC,SAAS,OAAO,WAAW;EAC3B;CACF;AACF;AAoBA,SAAS,cAAc,MAAsB,MAAkC;CAC7E,KAAK,MAAM,OAAO,MAChB,IAAI,IAAI,OAAO,QAAQ,IAAI,OAAO,KAAA,GAAW,OAAO,IAAI;AAG5D;AAEA,SAAS,QAAQ,GAAe,GAAwB;CACtD,IAAI,EAAE,WAAW,EAAE,QAAQ,OAAO;CAClC,IAAI,IAAI;CACR,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK,KAAK,EAAE,KAAM,EAAE;CAClD,OAAO,MAAM;AACf;AAEA,SAAS,KAAK,QAAsC;CAClD,OAAO;EAAE,OAAO;EAAO;CAAO;AAChC;AAEA,MAAM,gBAAgB;AACtB,MAAM,kBAAkB;AACxB,MAAM,kBAAkB;AACxB,MAAM,iBAAiB;;AAGvB,SAAS,mBAAmB,KAAiC;CAC3D,IAAI,CAAC,IAAI,WAAW,IAAI,GAAG,OAAO,KAAA;CAClC,IAAI,IAAI;CACR,OAAO,IAAI,IAAI,QAAQ;EACrB,MAAM,IAAI,IAAI,WAAW,CAAC;EAC1B,IAAI,IAAI,MAAM,IAAI,KAAK;EACvB;CACF;CACA,IAAI,MAAM,IAAI,QAAQ,OAAO,KAAA;CAC7B,MAAM,OAAO,IAAI,MAAM,CAAC;CACxB,MAAM,IAAI,sBAAsB,KAAK,IAAI;CACzC,IAAI,CAAC,GAAG,OAAO,KAAA;CACf,MAAM,IAAI,OAAO,EAAE,EAAE;CACrB,IAAI,CAAC,OAAO,cAAc,CAAC,GAAG,OAAO,KAAA;CACrC,MAAM,MAAM,EAAE;CACd,IAAI,QAAQ,KAAA,GAAW,OAAO,IAAI;CAClC,IAAI,QAAQ,KAAK,OAAO,IAAI;CAC5B,IAAI,QAAQ,KAAK,OAAO,IAAI;CAC5B,IAAI,QAAQ,KAAK,OAAO,IAAI;CAE5B,IAAI,IAAI,OAAO,GAAG,OAAO,KAAA;CACzB,OAAO,IAAI;AACb;AAEA,SAAS,cAAc,OAAmC;CACxD,IAAI,CAAC,WAAW,KAAK,KAAK,GAAG,OAAO,KAAA;CACpC,MAAM,IAAI,OAAO,KAAK;CACtB,OAAO,OAAO,cAAc,CAAC,IAAI,IAAI,KAAA;AACvC;AAEA,SAAS,UAAU,MAAsB,MAAsB;CAC7D,IAAI,IAAI;CACR,KAAK,MAAM,OAAO,MAChB,IAAI,IAAI,OAAO,MAAM;CAEvB,OAAO;AACT;AAEA,SAAS,eAAe,MAAsB,MAAc,OAAwB;CAClF,MAAM,SAAS,MAAM,YAAY;CACjC,KAAK,MAAM,OAAO,MAChB,IAAI,IAAI,OAAO,QAAQ,IAAI,OAAO,KAAA,KAAa,IAAI,EAAE,CAAC,YAAY,MAAM,QAAQ,OAAO;CAEzF,OAAO;AACT;AAEA,SAAS,cAAc,MAAsB,OAAwB;CACnE,MAAM,OAAO,kBAAkB,KAAK;CACpC,IAAI,CAAC,MAAM,OAAO;CAClB,KAAK,MAAM,OAAO,MAAM;EACtB,IAAI,IAAI,OAAO,OAAO,IAAI,OAAO,KAAA,GAAW;EAC5C,MAAM,MAAM,kBAAkB,IAAI,EAAE;EACpC,IACE,OACA,IAAI,SAAS,KAAK,QAClB,IAAI,WAAW,KAAK,UACpB,IAAI,eAAe,KAAK,YAExB,OAAO;CAEX;CACA,OAAO;AACT;AAEA,MAAM,yBAAyB;AAC/B,MAAM,yBAAyB;AAC/B,MAAM,oBAAoB;AAC1B,MAAM,aAAa;;AAGnB,SAAgB,YAAY,IAAsC;CAChE,IAAI;EAEF,MAAM,EAAE,QAAQ,UAAU,OAAO,OAAO,GAAG,YAAY,GAA4B,KAAK;EACxF,IAAI,CAAC,OAAO,WAAW,IAAI,GAAG,OAAO,KAAA;EAErC,IAAI,MAAM,SAAS,KAAiD,OAAO,KAAA;EAC3E,MAAM,SAAuB,CAAC;EAC9B,MAAM,cAAc,mBAAmB,MAAM;EAC7C,IAAI,gBAAgB,KAAA,GAAW,OAAO,cAAc;EACpD,MAAM,SAAS,MAAM,SAAS;EAC9B,IAAI,IAAI;EACR,OAAO,IAAI,KAAK,QAAQ;GACtB,MAAM,OAAO,MAAM;GACnB,MAAM,UAAW,MAAM,IAAI,MAAO,IAAK,MAAM,IAAI;GACjD,KAAK;GACL,IAAI,IAAI,UAAU,QAAQ;GAC1B,MAAM,OAAO,MAAM,MAAM,GAAG,IAAI,OAAO;GACvC,KAAK;GACL,IAAK,SAAS,KAAK,SAAS,MAAO,YAAY,mBAAmB;GAClE,MAAM,QAAQ,OAAO,gBAAgB,IAAI;GACzC,IAAI,CAAC,SAAS,MAAM,WAAW,YAAY;GAC3C,IAAI,SAAS,GAAG,OAAO,gBAAgB;QAClC,OAAO,oBAAoB;EAClC;EACA,IAAI,CAAC,OAAO,aAAa,OAAO,KAAA;EAChC,OAAO;CACT,QAAQ;EACN;CACF;AACF;;AAGA,SAAgB,2BAA2B,SAAmC;CAC5E,IAAI;EACF,MAAM,MAAM,cAAc,QAAQ,MAAM,aAAa;EACrD,IAAI,QAAQ,KAAA,GAAW,OAAO,KAAA;EAC9B,MAAM,SAAkB,KAAK,MAAM,GAAG;EACtC,IAAI,CAAC,oBAAoB,MAAM,KAAK,OAAO,SAAS,KAAK,YAAY,OAAO,KAAA;EAC5E,IAAI,CAAC,YAAY,MAAM,GAAG,OAAO,KAAA;EACjC,OAAO;CACT,QAAQ;EACN;CACF;AACF;;AAGA,SAAgB,mBAAmB,SAAgB,KAA8C;CAC/F,IAAI;EACF,IAAI,QAAQ,SAAS,KAAK,OAAO,CAAC,YAAY,OAAO,GACnD,OAAO,KAAK,iBAAiB;EAE/B,IAAI,QAAQ,OAAO,YAAY,MAAM,IAAI,YAAY,YAAY,GAC/D,OAAO,KAAK,iBAAiB;EAG/B,MAAM,iBAAiB,cAAc,QAAQ,MAAM,aAAa;EAChE,MAAM,UAAU,2BAA2B,OAAO;EAClD,IAAI,mBAAmB,KAAA,KAAa,CAAC,SAAS,OAAO,KAAK,qBAAqB;EAC/E,IAAI,UAAU,QAAQ,MAAM,GAAG,MAAM,GAAG,OAAO,KAAK,iBAAiB;EACrE,IAAI,UAAU,QAAQ,MAAM,GAAG,IAAI,GAAG,OAAO,KAAK,iBAAiB;EACnE,IAAI,CAAC,cAAc,QAAQ,MAAM,QAAQ,GAAG,OAAO,KAAK,gBAAgB;EAExE,KAAK,MAAM,OAAO,QAAQ,MAAM;GAC9B,IAAI,IAAI,OAAO,KAAK;GACpB,IAAI,IAAI,OAAO,KAAA,GAAW,OAAO,KAAK,WAAW;GACjD,MAAM,SAAS,kBAAkB,IAAI,EAAE;GACvC,IAAI,CAAC,UAAU,CAAC,kBAAkB,OAAO,IAAI,GAAG,OAAO,KAAK,WAAW;EACzE;EAGA,MAAM,gBAAgB,UAAU,QAAQ,MAAM,GAAG;EACjD,IAAI,gBAAgB,GAAG,OAAO,KAAK,iBAAiB;EACpD,IAAI,kBAAkB,GAAG;GACvB,MAAM,WAAW,cAAc,QAAQ,MAAM,GAAG;GAChD,IAAI,aAAa,KAAA,KAAa,SAAS,YAAY,MAAM,QAAQ,OAAO,YAAY,GAClF,OAAO,KAAK,oBAAoB;EAEpC;EAEA,MAAM,YAAY,cAAc,QAAQ,MAAM,QAAQ;EACtD,IAAI,cAAc,KAAA,GAAW,OAAO,KAAK,gBAAgB;EACzD,MAAM,SAAS,YAAY,SAAS;EACpC,IAAI,CAAC,UAAU,CAAC,OAAO,iBAAiB,OAAO,KAAK,gBAAgB;EAEpE,MAAM,gBAAgB,cAAc,QAAQ,MAAM,QAAQ;EAC1D,IAAI,kBAAkB,KAAA,GAAW;GAC/B,MAAM,QAAQ,cAAc,aAAa;GACzC,IAAI,UAAU,KAAA,KAAa,OAAO,gBAAgB,OAAO,OAAO,KAAK,iBAAiB;EACxF;EAIA,IAAI,CAAC,QADU,OAAO,YAAY,OAAO,cAAc,CACrC,GAAG,OAAO,eAAe,GAAG,OAAO,KAAK,2BAA2B;EAErF,MAAM,eAAe,cAAc,QAAQ,MAAM,OAAO;EACxD,IAAI,iBAAiB,KAAA,KAAa,IAAI,UAAU,KAAA,GAC1C;OAAA,aAAa,YAAY,MAAM,IAAI,MAAM,YAAY,GAAG,OAAO,KAAK,gBAAgB;EAAA;EAG1F,MAAM,cAAc,cAAc,QAAQ,MAAM,UAAU;EAC1D,IAAI,gBAAgB,KAAA,KAAa,OAAO,aAAa;GACnD,IAAI;GACJ,IAAI;IACF,WAAW,WAAW,WAAW;GACnC,QAAQ;IACN,OAAO,KAAK,mBAAmB;GACjC;GACA,IAAI,CAAC,QAAQ,OAAO,QAAQ,GAAG,OAAO,WAAW,GAAG,OAAO,KAAK,mBAAmB;EACrF;EAEA,MAAM,YAAY,cAAc,QAAQ,MAAM,GAAG;EACjD,IAAI,cAAc,KAAA,KAAa,CAAC,eAAe,QAAQ,MAAM,KAAK,SAAS,GACzE,OAAO,KAAK,WAAW;EAEzB,MAAM,WAAW,cAAc,QAAQ,MAAM,GAAG;EAChD,IAAI,aAAa,KAAA,KAAa,CAAC,eAAe,QAAQ,MAAM,KAAK,QAAQ,GACvE,OAAO,KAAK,WAAW;EAEzB,KAAK,MAAM,OAAO,QAAQ,MAAM;GAC9B,IAAI,IAAI,OAAO,OAAO,IAAI,OAAO,KAAA,GAAW;GAC5C,IAAI,CAAC,cAAc,QAAQ,MAAM,IAAI,EAAE,GAAG,OAAO,KAAK,WAAW;EACnE;EAGA,KAAK,MAAM,OAAO,QAAQ,MAAM;GAC9B,IAAI,IAAI,OAAO,KAAK;GACpB,IAAI,IAAI,OAAO,KAAA,KAAa,IAAI,EAAE,CAAC,YAAY,MAAM,QAAQ,OAAO,YAAY,GAC9E,OAAO,KAAK,oBAAoB;EAEpC;EAEA,MAAM,cACJ,OAAO,gBACN,kBAAkB,KAAA,IAAY,cAAc,aAAa,IAAI,KAAA;EAChE,OAAO,gBAAgB,KAAA,IACnB;GAAE,OAAO;GAAM;EAAQ,IACvB;GAAE,OAAO;GAAM;GAAS;EAAY;CAC1C,QAAQ;EACN,OAAO,KAAK,iBAAiB;CAC/B;AACF"}

package/dist/nips/nip59.d.mts

@@ -0,0 +1,2 @@
+import { _ as requireNip59Crypto, a as Rumor, b as wrap, c as TimestampRandomize, d as createRumor, f as createSeal, g as requireNip44Decryptor, h as randomPastTimestamp, i as Nip59Error, l as WrapOptions, m as isGiftWrapKind, n as Nip44Decryptor, o as SealOptions, p as eventToJson, r as Nip59Crypto, s as TWO_DAYS_SECS, t as GiftWrapTimestamps, u as createGiftWrap, v as rumorToJson, y as unwrap } from "../nip59-DljW_sYh.mjs";
+export { GiftWrapTimestamps, Nip44Decryptor, Nip59Crypto, Nip59Error, Rumor, SealOptions, TWO_DAYS_SECS, TimestampRandomize, WrapOptions, createGiftWrap, createRumor, createSeal, eventToJson, isGiftWrapKind, randomPastTimestamp, requireNip44Decryptor, requireNip59Crypto, rumorToJson, unwrap, wrap };

package/dist/nips/nip59.mjs

@@ -0,0 +1,171 @@
+import { t as assertHex32 } from "../util-6tfLQ9JF.mjs";
+import { a as NostrError } from "../error-DZEs5OuZ.mjs";
+import { t as Kind } from "../kind-BLl4cLOc.mjs";
+import { f as validateEvent, m as Tag, p as validateSignedEvent, t as getEventHash } from "../event-CzoQEFMF.mjs";
+import { r as finalizeEvent, s as verifyEvent, t as Keys } from "../key-Dn-aX4x4.mjs";
+import { encryptToPubkey } from "./nip44.mjs";
+import { randomBytes } from "@noble/hashes/utils.js";
+//#region src/nips/nip59.ts
+/**
+* NIP-59: Gift Wrap.
+* Rumor → NIP-44 seal (kind 13) → gift wrap (kind 1059).
+* Does not import signer, relay, or client. Crypto is a structural type.
+*
+* @see https://github.com/nostr-protocol/nips/blob/master/59.md
+*/
+var Nip59Error = class extends NostrError {
+	constructor(message, options) {
+		super(message, options);
+	}
+};
+const TWO_DAYS_SECS = 172800;
+function isGiftWrapKind(kind) {
+	return kind === Kind.GiftWrap || kind === Kind.GiftWrapEphemeral;
+}
+/** Narrow a signer-shaped object to {@link Nip59Crypto}, or throw. */
+function requireNip59Crypto(crypto) {
+	const encrypt = crypto.nip44Encrypt;
+	const decrypt = crypto.nip44Decrypt;
+	if (!encrypt || !decrypt) throw new Nip59Error("NIP-44 is required");
+	return {
+		getPublicKey: () => crypto.getPublicKey(),
+		signEvent: (unsigned) => crypto.signEvent(unsigned),
+		nip44Encrypt: (peer, plaintext) => encrypt.call(crypto, peer, plaintext),
+		nip44Decrypt: (peer, payload) => decrypt.call(crypto, peer, payload)
+	};
+}
+function requireNip44Decryptor(crypto) {
+	const decrypt = crypto.nip44Decrypt;
+	if (!decrypt) throw new Nip59Error("NIP-44 is required");
+	return { nip44Decrypt: (peer, payload) => decrypt.call(crypto, peer, payload) };
+}
+function rumorToJson(rumor) {
+	return JSON.stringify({
+		id: rumor.id,
+		pubkey: rumor.pubkey,
+		created_at: rumor.created_at,
+		kind: rumor.kind,
+		tags: rumor.tags,
+		content: rumor.content
+	});
+}
+function eventToJson(event) {
+	return JSON.stringify({
+		id: event.id,
+		pubkey: event.pubkey,
+		created_at: event.created_at,
+		kind: event.kind,
+		tags: event.tags,
+		content: event.content,
+		sig: event.sig
+	});
+}
+function defaultRandomInt(maxExclusive) {
+	if (!Number.isSafeInteger(maxExclusive) || maxExclusive <= 0) throw new Nip59Error("randomInt bound must be a positive integer");
+	const bytes = randomBytes(4);
+	return new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getUint32(0) % maxExclusive;
+}
+function randomPastTimestamp(opts) {
+	return (opts?.now ?? Math.floor(Date.now() / 1e3)) - (opts?.randomInt ?? defaultRandomInt)(TWO_DAYS_SECS);
+}
+function createRumor(pubkey, template) {
+	const unsigned = {
+		kind: template.kind,
+		content: template.content ?? "",
+		tags: template.tags ? [...template.tags] : [],
+		created_at: template.created_at ?? Math.floor(Date.now() / 1e3),
+		pubkey: assertHex32(pubkey, "public key")
+	};
+	return {
+		...unsigned,
+		id: getEventHash(unsigned)
+	};
+}
+async function createSeal(crypto, recipient, rumor, opts) {
+	const sealer = requireNip59Crypto(crypto);
+	const recipientPk = assertHex32(recipient, "public key");
+	let content;
+	try {
+		content = await sealer.nip44Encrypt(recipientPk, rumorToJson(rumor));
+	} catch (error) {
+		throw new Nip59Error("failed to encrypt", { cause: error });
+	}
+	const created_at = opts?.timestamps?.seal ?? (opts?.randomize === "wrap" ? rumor.created_at : randomPastTimestamp(opts));
+	const pubkey = await sealer.getPublicKey();
+	return sealer.signEvent({
+		kind: Kind.Seal,
+		content,
+		created_at,
+		tags: [],
+		pubkey
+	});
+}
+function createGiftWrap(seal, recipient, opts) {
+	const recipientPk = assertHex32(recipient, "public key");
+	const ephemeral = Keys.generate();
+	const content = encryptToPubkey(eventToJson(seal), ephemeral.secretKey.bytes, recipientPk);
+	const created_at = opts?.timestamps?.wrap ?? randomPastTimestamp(opts);
+	const tags = [Tag.p(recipientPk, opts?.relayHint), ...opts?.extraTags ?? []];
+	return finalizeEvent({
+		kind: Kind.GiftWrap,
+		content,
+		created_at,
+		tags
+	}, ephemeral.secretKey);
+}
+async function wrap(crypto, recipient, rumor, opts) {
+	return createGiftWrap(await createSeal(crypto, recipient, rumor, opts), recipient, opts);
+}
+function parseJson(text) {
+	try {
+		return JSON.parse(text);
+	} catch (error) {
+		throw new Nip59Error("invalid JSON", { cause: error });
+	}
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseRumor(value) {
+	if (!isRecord(value)) throw new Nip59Error("invalid rumor");
+	if (Object.hasOwn(value, "sig")) throw new Nip59Error("rumor must be unsigned");
+	const givenId = value.id;
+	if (!validateEvent(value)) throw new Nip59Error("invalid rumor");
+	const unsigned = {
+		kind: value.kind,
+		tags: value.tags,
+		content: value.content,
+		created_at: value.created_at,
+		pubkey: value.pubkey.toLowerCase()
+	};
+	const expected = getEventHash(unsigned);
+	if (typeof givenId === "string" && givenId.toLowerCase() !== expected) throw new Nip59Error("invalid rumor");
+	return {
+		...unsigned,
+		id: expected
+	};
+}
+async function decryptLayer(crypto, peer, payload) {
+	try {
+		return await crypto.nip44Decrypt(peer, payload);
+	} catch (error) {
+		throw new Nip59Error("failed to decrypt", { cause: error });
+	}
+}
+async function unwrap(crypto, giftWrap) {
+	const decryptor = requireNip44Decryptor(crypto);
+	if (!validateSignedEvent(giftWrap) || !isGiftWrapKind(giftWrap.kind)) throw new Nip59Error("expected gift wrap");
+	if (!verifyEvent(giftWrap)) throw new Nip59Error("gift wrap signature");
+	const sealRaw = parseJson(await decryptLayer(decryptor, giftWrap.pubkey, giftWrap.content));
+	if (!validateSignedEvent(sealRaw)) throw new Nip59Error("expected seal");
+	if (sealRaw.kind !== Kind.Seal) throw new Nip59Error("expected seal");
+	if (sealRaw.tags.length !== 0) throw new Nip59Error("seal tags must be empty");
+	if (!verifyEvent(sealRaw)) throw new Nip59Error("seal signature");
+	const rumor = parseRumor(parseJson(await decryptLayer(decryptor, sealRaw.pubkey, sealRaw.content)));
+	if (sealRaw.pubkey.toLowerCase() !== rumor.pubkey.toLowerCase()) throw new Nip59Error("seal pubkey does not match rumor pubkey");
+	return rumor;
+}
+//#endregion
+export { Nip59Error, TWO_DAYS_SECS, createGiftWrap, createRumor, createSeal, eventToJson, isGiftWrapKind, randomPastTimestamp, requireNip44Decryptor, requireNip59Crypto, rumorToJson, unwrap, wrap };
+
+//# sourceMappingURL=nip59.mjs.map

package/dist/nips/nip59.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip59.mjs","names":["TagBuilder"],"sources":["../../src/nips/nip59.ts"],"sourcesContent":["/**\n * NIP-59: Gift Wrap.\n * Rumor → NIP-44 seal (kind 13) → gift wrap (kind 1059).\n * Does not import signer, relay, or client. Crypto is a structural type.\n *\n * @see https://github.com/nostr-protocol/nips/blob/master/59.md\n */\nimport { randomBytes } from \"@noble/hashes/utils.js\";\nimport type { Event, UnsignedEvent } from \"../core/event.ts\";\nimport { getEventHash, validateEvent, validateSignedEvent } from \"../core/event.ts\";\nimport { NostrError } from \"../core/error.ts\";\nimport { Kind } from \"../core/kind.ts\";\nimport { Keys, finalizeEvent, verifyEvent } from \"../core/key.ts\";\nimport type { Tag } from \"../core/tag.ts\";\nimport { Tag as TagBuilder } from \"../core/tag.ts\";\nimport { assertHex32 } from \"../core/util.ts\";\nimport { encryptToPubkey } from \"./nip44.ts\";\n\n/** Unsigned event with a computed id. Never has `sig`. */\nexport type Rumor = UnsignedEvent & {\n  readonly id: string;\n};\n\n/**\n * Structural crypto used by NIP-59.\n * Satisfied by NostrSigner when nip44Encrypt/nip44Decrypt are present.\n * This module must not import src/signer/.\n */\nexport type Nip59Crypto = {\n  getPublicKey(): Promise<string>;\n  signEvent(unsigned: UnsignedEvent): Promise<Event>;\n  nip44Encrypt(peer: string, plaintext: string): Promise<string>;\n  nip44Decrypt(peer: string, payload: string): Promise<string>;\n};\n\nexport type Nip44Decryptor = {\n  nip44Decrypt(peer: string, payload: string): Promise<string>;\n};\n\nexport type GiftWrapTimestamps = {\n  readonly seal: number;\n  readonly wrap: number;\n};\n\n/** `\"wrap\"` randomizes only the gift wrap; `\"seal+wrap\"` (default) randomizes both. */\nexport type TimestampRandomize = \"wrap\" | \"seal+wrap\";\n\nexport type WrapOptions = {\n  /** Unix seconds used as the randomization window end. Default: floor(Date.now()/1000). */\n  readonly now?: number;\n  /** Uniform integer in [0, maxExclusive). Default: CSPRNG via @noble/hashes randomBytes. */\n  readonly randomInt?: (maxExclusive: number) => number;\n  /** When set, used as-is. Overrides now/randomInt for this call. */\n  readonly timestamps?: GiftWrapTimestamps;\n  readonly relayHint?: string;\n  /** Appended after the required wrap `p` tag. Never applied to the seal. */\n  readonly extraTags?: readonly Tag[];\n  /** Default `\"seal+wrap\"` (NIP-59). `\"wrap\"` = only wrap timestamp is randomized; seal uses rumor.created_at. */\n  readonly randomize?: TimestampRandomize;\n};\n\nexport type SealOptions = Pick<WrapOptions, \"now\" | \"randomInt\" | \"timestamps\" | \"randomize\">;\n\nexport class Nip59Error extends NostrError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n  }\n}\n\nexport const TWO_DAYS_SECS = 2 * 24 * 60 * 60;\n\nexport function isGiftWrapKind(kind: number): boolean {\n  return kind === Kind.GiftWrap || kind === Kind.GiftWrapEphemeral;\n}\n\ntype Nip59CryptoInput = {\n  getPublicKey(): Promise<string>;\n  signEvent(unsigned: UnsignedEvent): Promise<Event>;\n  nip44Encrypt?: (peer: string, plaintext: string) => Promise<string>;\n  nip44Decrypt?: (peer: string, payload: string) => Promise<string>;\n};\n\n/** Narrow a signer-shaped object to {@link Nip59Crypto}, or throw. */\nexport function requireNip59Crypto(crypto: Nip59CryptoInput): Nip59Crypto {\n  const encrypt = crypto.nip44Encrypt;\n  const decrypt = crypto.nip44Decrypt;\n  if (!encrypt || !decrypt) {\n    throw new Nip59Error(\"NIP-44 is required\");\n  }\n  return {\n    getPublicKey: () => crypto.getPublicKey(),\n    signEvent: (unsigned) => crypto.signEvent(unsigned),\n    nip44Encrypt: (peer, plaintext) => encrypt.call(crypto, peer, plaintext),\n    nip44Decrypt: (peer, payload) => decrypt.call(crypto, peer, payload),\n  };\n}\n\nexport function requireNip44Decryptor(crypto: {\n  nip44Decrypt?: (peer: string, payload: string) => Promise<string>;\n}): Nip44Decryptor {\n  const decrypt = crypto.nip44Decrypt;\n  if (!decrypt) {\n    throw new Nip59Error(\"NIP-44 is required\");\n  }\n  return {\n    nip44Decrypt: (peer, payload) => decrypt.call(crypto, peer, payload),\n  };\n}\n\nexport function rumorToJson(rumor: Rumor): string {\n  return JSON.stringify({\n    id: rumor.id,\n    pubkey: rumor.pubkey,\n    created_at: rumor.created_at,\n    kind: rumor.kind,\n    tags: rumor.tags,\n    content: rumor.content,\n  });\n}\n\nexport function eventToJson(event: Event): string {\n  return JSON.stringify({\n    id: event.id,\n    pubkey: event.pubkey,\n    created_at: event.created_at,\n    kind: event.kind,\n    tags: event.tags,\n    content: event.content,\n    sig: event.sig,\n  });\n}\n\nfunction defaultRandomInt(maxExclusive: number): number {\n  if (!Number.isSafeInteger(maxExclusive) || maxExclusive <= 0) {\n    throw new Nip59Error(\"randomInt bound must be a positive integer\");\n  }\n  const bytes = randomBytes(4);\n  const n = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getUint32(0);\n  return n % maxExclusive;\n}\n\nexport function randomPastTimestamp(opts?: {\n  now?: number;\n  randomInt?: (maxExclusive: number) => number;\n}): number {\n  const now = opts?.now ?? Math.floor(Date.now() / 1000);\n  const offset = (opts?.randomInt ?? defaultRandomInt)(TWO_DAYS_SECS);\n  return now - offset;\n}\n\nexport function createRumor(\n  pubkey: string,\n  template: {\n    kind: number;\n    content?: string;\n    tags?: readonly Tag[];\n    created_at?: number;\n  },\n): Rumor {\n  const unsigned: UnsignedEvent = {\n    kind: template.kind,\n    content: template.content ?? \"\",\n    tags: template.tags ? [...template.tags] : [],\n    created_at: template.created_at ?? Math.floor(Date.now() / 1000),\n    pubkey: assertHex32(pubkey, \"public key\"),\n  };\n  return { ...unsigned, id: getEventHash(unsigned) };\n}\n\nexport async function createSeal(\n  crypto: Nip59Crypto,\n  recipient: string,\n  rumor: Rumor,\n  opts?: SealOptions,\n): Promise<Event> {\n  const sealer = requireNip59Crypto(crypto);\n  const recipientPk = assertHex32(recipient, \"public key\");\n  let content: string;\n  try {\n    content = await sealer.nip44Encrypt(recipientPk, rumorToJson(rumor));\n  } catch (error) {\n    throw new Nip59Error(\"failed to encrypt\", { cause: error });\n  }\n  const created_at =\n    opts?.timestamps?.seal ??\n    (opts?.randomize === \"wrap\" ? rumor.created_at : randomPastTimestamp(opts));\n  const pubkey = await sealer.getPublicKey();\n  return sealer.signEvent({\n    kind: Kind.Seal,\n    content,\n    created_at,\n    tags: [],\n    pubkey,\n  });\n}\n\nexport function createGiftWrap(seal: Event, recipient: string, opts?: WrapOptions): Event {\n  const recipientPk = assertHex32(recipient, \"public key\");\n  const ephemeral = Keys.generate();\n  const content = encryptToPubkey(eventToJson(seal), ephemeral.secretKey.bytes, recipientPk);\n  const created_at = opts?.timestamps?.wrap ?? randomPastTimestamp(opts);\n  const tags: Tag[] = [TagBuilder.p(recipientPk, opts?.relayHint), ...(opts?.extraTags ?? [])];\n  return finalizeEvent(\n    {\n      kind: Kind.GiftWrap,\n      content,\n      created_at,\n      tags,\n    },\n    ephemeral.secretKey,\n  );\n}\n\nexport async function wrap(\n  crypto: Nip59Crypto,\n  recipient: string,\n  rumor: Rumor,\n  opts?: WrapOptions,\n): Promise<Event> {\n  const seal = await createSeal(crypto, recipient, rumor, opts);\n  return createGiftWrap(seal, recipient, opts);\n}\n\nfunction parseJson(text: string): unknown {\n  try {\n    return JSON.parse(text);\n  } catch (error) {\n    throw new Nip59Error(\"invalid JSON\", { cause: error });\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction parseRumor(value: unknown): Rumor {\n  if (!isRecord(value)) {\n    throw new Nip59Error(\"invalid rumor\");\n  }\n  if (Object.hasOwn(value, \"sig\")) {\n    throw new Nip59Error(\"rumor must be unsigned\");\n  }\n  const givenId = value.id;\n  if (!validateEvent(value)) {\n    throw new Nip59Error(\"invalid rumor\");\n  }\n  const unsigned: UnsignedEvent = {\n    kind: value.kind,\n    tags: value.tags,\n    content: value.content,\n    created_at: value.created_at,\n    pubkey: value.pubkey.toLowerCase(),\n  };\n  const expected = getEventHash(unsigned);\n  if (typeof givenId === \"string\" && givenId.toLowerCase() !== expected) {\n    throw new Nip59Error(\"invalid rumor\");\n  }\n  return { ...unsigned, id: expected };\n}\n\nasync function decryptLayer(\n  crypto: Nip44Decryptor,\n  peer: string,\n  payload: string,\n): Promise<string> {\n  try {\n    return await crypto.nip44Decrypt(peer, payload);\n  } catch (error) {\n    throw new Nip59Error(\"failed to decrypt\", { cause: error });\n  }\n}\n\nexport async function unwrap(crypto: Nip44Decryptor, giftWrap: Event): Promise<Rumor> {\n  const decryptor = requireNip44Decryptor(crypto);\n  if (!validateSignedEvent(giftWrap) || !isGiftWrapKind(giftWrap.kind)) {\n    throw new Nip59Error(\"expected gift wrap\");\n  }\n  if (!verifyEvent(giftWrap)) {\n    throw new Nip59Error(\"gift wrap signature\");\n  }\n\n  const sealJson = await decryptLayer(decryptor, giftWrap.pubkey, giftWrap.content);\n  const sealRaw = parseJson(sealJson);\n  if (!validateSignedEvent(sealRaw)) {\n    throw new Nip59Error(\"expected seal\");\n  }\n  if (sealRaw.kind !== Kind.Seal) {\n    throw new Nip59Error(\"expected seal\");\n  }\n  if (sealRaw.tags.length !== 0) {\n    throw new Nip59Error(\"seal tags must be empty\");\n  }\n  if (!verifyEvent(sealRaw)) {\n    throw new Nip59Error(\"seal signature\");\n  }\n\n  const rumorJson = await decryptLayer(decryptor, sealRaw.pubkey, sealRaw.content);\n  const rumor = parseRumor(parseJson(rumorJson));\n  if (sealRaw.pubkey.toLowerCase() !== rumor.pubkey.toLowerCase()) {\n    throw new Nip59Error(\"seal pubkey does not match rumor pubkey\");\n  }\n  return rumor;\n}\n"],"mappings":"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"}

package/dist/nips/nip65.d.mts

@@ -0,0 +1,2 @@
+import { a as readRelays, c as writeRelays, i as parseRelayList, n as RelayMarker, o as relayListEventBuilder, r as markerOf, s as relayListToTags, t as RelayListItem } from "../nip65-Di5hZRuV.mjs";
+export { RelayListItem, RelayMarker, markerOf, parseRelayList, readRelays, relayListEventBuilder, relayListToTags, writeRelays };

package/dist/nips/nip65.mjs

@@ -0,0 +1,76 @@
+import { s as normalizeURL } from "../util-6tfLQ9JF.mjs";
+import { n as EventValidationError } from "../error-DZEs5OuZ.mjs";
+import { t as Kind } from "../kind-BLl4cLOc.mjs";
+import { t as EventBuilder } from "../builder-q0VsvnYE.mjs";
+//#region src/nips/nip65.ts
+function markerOf(item) {
+	if (item.read && item.write) return "readwrite";
+	if (item.read) return "read";
+	if (item.write) return "write";
+	return "readwrite";
+}
+/** Parse a kind:10002 NIP-65 event into relay list entries. */
+function parseRelayList(event) {
+	if (event.kind !== Kind.RelayList) throw new EventValidationError(`expected kind ${Kind.RelayList}, got ${event.kind}`);
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const tag of event.tags) {
+		if (tag[0] !== "r" || !tag[1]) continue;
+		let url;
+		try {
+			url = normalizeURL(tag[1]);
+		} catch {
+			continue;
+		}
+		if (seen.has(url)) continue;
+		seen.add(url);
+		const marker = tag[2];
+		if (marker === "read") out.push({
+			url,
+			read: true,
+			write: false
+		});
+		else if (marker === "write") out.push({
+			url,
+			read: false,
+			write: true
+		});
+		else out.push({
+			url,
+			read: true,
+			write: true
+		});
+	}
+	return out;
+}
+/** Encode relay list items as NIP-65 `r` tags. */
+function relayListToTags(items) {
+	return items.map((item) => {
+		if (item.read && item.write) return ["r", item.url];
+		if (item.read) return [
+			"r",
+			item.url,
+			"read"
+		];
+		if (item.write) return [
+			"r",
+			item.url,
+			"write"
+		];
+		return ["r", item.url];
+	});
+}
+/** Build an unsigned kind:10002 EventBuilder from relay list items. */
+function relayListEventBuilder(items) {
+	return new EventBuilder(Kind.RelayList, "").tags(relayListToTags(items));
+}
+function readRelays(items) {
+	return items.filter((i) => i.read).map((i) => i.url);
+}
+function writeRelays(items) {
+	return items.filter((i) => i.write).map((i) => i.url);
+}
+//#endregion
+export { markerOf, parseRelayList, readRelays, relayListEventBuilder, relayListToTags, writeRelays };
+
+//# sourceMappingURL=nip65.mjs.map

package/dist/nips/nip65.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip65.mjs","names":[],"sources":["../../src/nips/nip65.ts"],"sourcesContent":["import type { Event } from \"../core/event.ts\";\nimport { EventValidationError } from \"../core/error.ts\";\nimport { Kind } from \"../core/kind.ts\";\nimport type { Tag } from \"../core/tag.ts\";\nimport { EventBuilder } from \"../core/builder.ts\";\nimport { normalizeURL } from \"../core/util.ts\";\n\nexport type RelayMarker = \"read\" | \"write\" | \"readwrite\";\n\nexport type RelayListItem = {\n  url: string;\n  read: boolean;\n  write: boolean;\n};\n\nexport function markerOf(item: RelayListItem): RelayMarker {\n  if (item.read && item.write) return \"readwrite\";\n  if (item.read) return \"read\";\n  if (item.write) return \"write\";\n  return \"readwrite\";\n}\n\n/** Parse a kind:10002 NIP-65 event into relay list entries. */\nexport function parseRelayList(event: Event): RelayListItem[] {\n  if (event.kind !== Kind.RelayList) {\n    throw new EventValidationError(`expected kind ${Kind.RelayList}, got ${event.kind}`);\n  }\n  const out: RelayListItem[] = [];\n  const seen = new Set<string>();\n\n  for (const tag of event.tags) {\n    if (tag[0] !== \"r\" || !tag[1]) continue;\n    let url: string;\n    try {\n      url = normalizeURL(tag[1]);\n    } catch {\n      continue;\n    }\n    if (seen.has(url)) continue;\n    seen.add(url);\n\n    const marker = tag[2];\n    if (marker === \"read\") {\n      out.push({ url, read: true, write: false });\n    } else if (marker === \"write\") {\n      out.push({ url, read: false, write: true });\n    } else {\n      out.push({ url, read: true, write: true });\n    }\n  }\n  return out;\n}\n\n/** Encode relay list items as NIP-65 `r` tags. */\nexport function relayListToTags(items: RelayListItem[]): Tag[] {\n  return items.map((item) => {\n    if (item.read && item.write) return [\"r\", item.url];\n    if (item.read) return [\"r\", item.url, \"read\"];\n    if (item.write) return [\"r\", item.url, \"write\"];\n    return [\"r\", item.url];\n  });\n}\n\n/** Build an unsigned kind:10002 EventBuilder from relay list items. */\nexport function relayListEventBuilder(items: RelayListItem[]): EventBuilder {\n  return new EventBuilder(Kind.RelayList, \"\").tags(relayListToTags(items));\n}\n\nexport function readRelays(items: RelayListItem[]): string[] {\n  return items.filter((i) => i.read).map((i) => i.url);\n}\n\nexport function writeRelays(items: RelayListItem[]): string[] {\n  return items.filter((i) => i.write).map((i) => i.url);\n}\n"],"mappings":";;;;;AAeA,SAAgB,SAAS,MAAkC;CACzD,IAAI,KAAK,QAAQ,KAAK,OAAO,OAAO;CACpC,IAAI,KAAK,MAAM,OAAO;CACtB,IAAI,KAAK,OAAO,OAAO;CACvB,OAAO;AACT;;AAGA,SAAgB,eAAe,OAA+B;CAC5D,IAAI,MAAM,SAAS,KAAK,WACtB,MAAM,IAAI,qBAAqB,iBAAiB,KAAK,UAAU,QAAQ,MAAM,MAAM;CAErF,MAAM,MAAuB,CAAC;CAC9B,MAAM,uBAAO,IAAI,IAAY;CAE7B,KAAK,MAAM,OAAO,MAAM,MAAM;EAC5B,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,IAAI;EAC/B,IAAI;EACJ,IAAI;GACF,MAAM,aAAa,IAAI,EAAE;EAC3B,QAAQ;GACN;EACF;EACA,IAAI,KAAK,IAAI,GAAG,GAAG;EACnB,KAAK,IAAI,GAAG;EAEZ,MAAM,SAAS,IAAI;EACnB,IAAI,WAAW,QACb,IAAI,KAAK;GAAE;GAAK,MAAM;GAAM,OAAO;EAAM,CAAC;OACrC,IAAI,WAAW,SACpB,IAAI,KAAK;GAAE;GAAK,MAAM;GAAO,OAAO;EAAK,CAAC;OAE1C,IAAI,KAAK;GAAE;GAAK,MAAM;GAAM,OAAO;EAAK,CAAC;CAE7C;CACA,OAAO;AACT;;AAGA,SAAgB,gBAAgB,OAA+B;CAC7D,OAAO,MAAM,KAAK,SAAS;EACzB,IAAI,KAAK,QAAQ,KAAK,OAAO,OAAO,CAAC,KAAK,KAAK,GAAG;EAClD,IAAI,KAAK,MAAM,OAAO;GAAC;GAAK,KAAK;GAAK;EAAM;EAC5C,IAAI,KAAK,OAAO,OAAO;GAAC;GAAK,KAAK;GAAK;EAAO;EAC9C,OAAO,CAAC,KAAK,KAAK,GAAG;CACvB,CAAC;AACH;;AAGA,SAAgB,sBAAsB,OAAsC;CAC1E,OAAO,IAAI,aAAa,KAAK,WAAW,EAAE,CAAC,CAAC,KAAK,gBAAgB,KAAK,CAAC;AACzE;AAEA,SAAgB,WAAW,OAAkC;CAC3D,OAAO,MAAM,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,MAAM,EAAE,GAAG;AACrD;AAEA,SAAgB,YAAY,OAAkC;CAC5D,OAAO,MAAM,QAAQ,MAAM,EAAE,KAAK,CAAC,CAAC,KAAK,MAAM,EAAE,GAAG;AACtD"}

package/dist/nips/nip77.d.mts

@@ -0,0 +1,2 @@
+import { a as NegentropyStorageVector, c as ReconcileOutcome, d as storageFromItems, i as Negentropy, l as runNegSession, n as MAX_NEG_ROUNDS, o as Nip77Error, r as NegItem, s as PROTOCOL_VERSION, t as DEFAULT_FRAME_SIZE_LIMIT, u as storageFromEvents } from "../nip77-ByxlgoQO.mjs";
+export { DEFAULT_FRAME_SIZE_LIMIT, MAX_NEG_ROUNDS, NegItem, Negentropy, NegentropyStorageVector, Nip77Error, PROTOCOL_VERSION, ReconcileOutcome, runNegSession, storageFromEvents, storageFromItems };