@qntx/nostr 0.8.0 → 0.10.0

package/dist/client.d.mts

@@ -1,2 +1,2 @@
-import { _ as SyncSummary, a as FetchEachOptions, c as PrivateMessageSendResult, d as SendPrivateMessageOptions, f as SubscribeOptions, g as SyncOptions, h as SyncDirectionName, i as ClientOptions, l as PublishOptions, m as SyncDirection, n as ClientError, o as FetchEventsOptions, p as SubscribePrivateMessagesOptions, r as ClientEventMap, s as FetchPrivateMessagesOptions, t as Client, u as ReceivedPrivateMessage } from "./index-Cl_1XdYP.mjs";
+import { _ as SyncSummary, a as FetchEachOptions, c as PrivateMessageSendResult, d as SendPrivateMessageOptions, f as SubscribeOptions, g as SyncOptions, h as SyncDirectionName, i as ClientOptions, l as PublishOptions, m as SyncDirection, n as ClientError, o as FetchEventsOptions, p as SubscribePrivateMessagesOptions, r as ClientEventMap, s as FetchPrivateMessagesOptions, t as Client, u as ReceivedPrivateMessage } from "./index-uCYwXaaP.mjs";
 export { Client, ClientError, type ClientEventMap, type ClientOptions, type FetchEachOptions, type FetchEventsOptions, type FetchPrivateMessagesOptions, type PrivateMessageSendResult, type PublishOptions, type ReceivedPrivateMessage, type SendPrivateMessageOptions, type SubscribeOptions, type SubscribePrivateMessagesOptions, SyncDirection, type SyncDirectionName, type SyncOptions, type SyncSummary };

package/dist/client.mjs

@@ -1,2 +1,2 @@
-import { n as ClientError, r as SyncDirection, t as Client } from "./client-Cj2lUaVh.mjs";
+import { n as ClientError, r as SyncDirection, t as Client } from "./client-CeyDLoyO.mjs";
 export { Client, ClientError, SyncDirection };

package/dist/core.d.mts

@@ -1,9 +1,8 @@
-import { C as isTag, E as tagValue, S as getDTag, T as tagName, _ as Tag, a as isMarkedFailed, b as firstTagValue, c as markUnverified, d as signedMatchesUnsigned, f as sortEvents, g as EventAddress, h as validateSignedEvent, i as getEventHash, l as markVerified, m as validateEvent, n as EventTemplate, o as isReplaceableWinner, p as sortedEvents, r as UnsignedEvent, s as itemCompare, t as Event, u as serializeEvent, v as TagInput, w as parseEventAddress, x as formatEventAddress, y as eventAddress } from "./event-DJeb_DIL.mjs";
-import { a as SigningBackend, c as publicKeyFromHex, i as SecretKeyInput, l as signEvent, n as PublicKey, o as finalizeEvent, r as SecretKey, s as getPublicKey, t as Keys, u as toSecretKey } from "./key-D_5OgGT7.mjs";
-import { n as ProfileMetadata, t as EventBuilder } from "./builder-CTwkB2zM.mjs";
-import { a as getFilterLimit, c as mergeFilters, i as filterFingerprint, n as canonicalizeFilter, o as matchFilter, r as canonicalizeFilters, s as matchFilters, t as Filter } from "./filter-jI_9htF7.mjs";
-import { a as assertSubscriptionId, c as encodeRelayMessage, d as parseRelayMessage, i as SubscriptionId, l as mergeCountHll, n as CountResult, o as createSubscriptionId, r as RelayMessage, s as encodeClientMessage, t as ClientMessage, u as parseClientMessage } from "./message-tclYCVNc.mjs";
-import { i as verifyEvent, n as SerializedEventVerifier, r as createEventVerifier, t as EventVerifier } from "./verifier-CgTFpgsC.mjs";
+import { C as tagName, S as parseEventAddress, _ as eventAddress, a as isMarkedFailed, b as getDTag, c as serializeEvent, d as sortedEvents, f as validateEvent, g as TagInput, h as Tag, i as getEventHash, l as signedMatchesUnsigned, m as EventAddress, n as EventTemplate, o as isReplaceableWinner, p as validateSignedEvent, r as UnsignedEvent, s as itemCompare, t as Event, u as sortEvents, v as firstTagValue, w as tagValue, x as isTag, y as formatEventAddress } from "./event-j3BwI5dF.mjs";
+import { a as SigningBackend, c as publicKeyFromHex, i as SecretKeyInput, l as signEvent, n as PublicKey, o as finalizeEvent, r as SecretKey, s as getPublicKey, t as Keys, u as toSecretKey } from "./key-CyKN1RTi.mjs";
+import { n as ProfileMetadata, t as EventBuilder } from "./builder-GBddxj8i.mjs";
+import { a as getFilterLimit, i as filterFingerprint, n as canonicalizeFilter, o as matchFilter, r as canonicalizeFilters, s as matchFilters, t as Filter } from "./filter-CfEgQBXt.mjs";
+import { a as ClientMessage, c as SubscriptionId, d as encodeClientMessage, f as encodeRelayMessage, h as parseRelayMessage, i as verifyEvent, l as assertSubscriptionId, m as parseClientMessage, n as SerializedEventVerifier, o as CountResult, p as mergeCountHll, r as createEventVerifier, s as RelayMessage, t as EventVerifier, u as createSubscriptionId } from "./verifier-9c-bINrv.mjs";
 import { a as NostrError, i as MessageError, n as EventValidationError, o as UrlError, r as HexError, s as WasmPoisonedError, t as CryptoError } from "./error-BquXDmIN.mjs";
-import { S as SUBSCRIPTION_ID_MAX_CHARS, _ as normalizeURL, a as classifyKind, b as SECRET_KEY_BYTES, c as isRegularKind, d as assertSecretKeyBytes, f as bytesToHex, g as normalizeRelayUrls, h as isHex64, i as KnownKind, l as isReplaceableKind, m as isHex32, n as KindClassification, o as isAddressableKind, p as hexToBytes, r as KindName, s as isEphemeralKind, t as Kind, u as assertHex32, v as EVENT_ID_BYTES, x as SIGNATURE_BYTES, y as PUBLIC_KEY_BYTES } from "./index-DU9tRFTZ.mjs";
-export { type ClientMessage, type CountResult, CryptoError, EVENT_ID_BYTES, type Event, type EventAddress, EventBuilder, type EventTemplate, EventValidationError, type EventVerifier, type Filter, HexError, Keys, Kind, type KindClassification, type KindName, type KnownKind, MessageError, NostrError, PUBLIC_KEY_BYTES, type ProfileMetadata, type PublicKey, type RelayMessage, SECRET_KEY_BYTES, SIGNATURE_BYTES, SUBSCRIPTION_ID_MAX_CHARS, SecretKey, type SecretKeyInput, type SerializedEventVerifier, type SigningBackend, type SubscriptionId, Tag, type TagInput, type UnsignedEvent, UrlError, WasmPoisonedError, assertHex32, assertSecretKeyBytes, assertSubscriptionId, bytesToHex, canonicalizeFilter, canonicalizeFilters, classifyKind, createEventVerifier, createSubscriptionId, encodeClientMessage, encodeRelayMessage, eventAddress, filterFingerprint, finalizeEvent, firstTagValue, formatEventAddress, getDTag, getEventHash, getFilterLimit, getPublicKey, hexToBytes, isAddressableKind, isEphemeralKind, isHex32, isHex64, isMarkedFailed, isRegularKind, isReplaceableKind, isReplaceableWinner, isTag, itemCompare, markUnverified, markVerified, matchFilter, matchFilters, mergeCountHll, mergeFilters, normalizeRelayUrls, normalizeURL, parseClientMessage, parseEventAddress, parseRelayMessage, publicKeyFromHex, serializeEvent, signEvent, signedMatchesUnsigned, sortEvents, sortedEvents, tagName, tagValue, toSecretKey, validateEvent, validateSignedEvent, verifyEvent };
+import { S as SUBSCRIPTION_ID_MAX_CHARS, _ as normalizeURL, a as classifyKind, b as SECRET_KEY_BYTES, c as isRegularKind, d as assertSecretKeyBytes, f as bytesToHex, g as normalizeRelayUrls, h as isHex64, i as KnownKind, l as isReplaceableKind, m as isHex32, n as KindClassification, o as isAddressableKind, p as hexToBytes, r as KindName, s as isEphemeralKind, t as Kind, u as assertHex32, v as EVENT_ID_BYTES, x as SIGNATURE_BYTES, y as PUBLIC_KEY_BYTES } from "./index-Hp26bgYG.mjs";
+export { type ClientMessage, type CountResult, CryptoError, EVENT_ID_BYTES, type Event, type EventAddress, EventBuilder, type EventTemplate, EventValidationError, type EventVerifier, type Filter, HexError, Keys, Kind, type KindClassification, type KindName, type KnownKind, MessageError, NostrError, PUBLIC_KEY_BYTES, type ProfileMetadata, type PublicKey, type RelayMessage, SECRET_KEY_BYTES, SIGNATURE_BYTES, SUBSCRIPTION_ID_MAX_CHARS, SecretKey, type SecretKeyInput, type SerializedEventVerifier, type SigningBackend, type SubscriptionId, Tag, type TagInput, type UnsignedEvent, UrlError, WasmPoisonedError, assertHex32, assertSecretKeyBytes, assertSubscriptionId, bytesToHex, canonicalizeFilter, canonicalizeFilters, classifyKind, createEventVerifier, createSubscriptionId, encodeClientMessage, encodeRelayMessage, eventAddress, filterFingerprint, finalizeEvent, firstTagValue, formatEventAddress, getDTag, getEventHash, getFilterLimit, getPublicKey, hexToBytes, isAddressableKind, isEphemeralKind, isHex32, isHex64, isMarkedFailed, isRegularKind, isReplaceableKind, isReplaceableWinner, isTag, itemCompare, matchFilter, matchFilters, mergeCountHll, normalizeRelayUrls, normalizeURL, parseClientMessage, parseEventAddress, parseRelayMessage, publicKeyFromHex, serializeEvent, signEvent, signedMatchesUnsigned, sortEvents, sortedEvents, tagName, tagValue, toSecretKey, validateEvent, validateSignedEvent, verifyEvent };

package/dist/core.mjs

@@ -1,9 +1,9 @@
 import { C as EVENT_ID_BYTES, D as SUBSCRIPTION_ID_MAX_CHARS, E as SIGNATURE_BYTES, T as SECRET_KEY_BYTES, _ as MessageError, a as hexToBytes, b as WasmPoisonedError, g as HexError, h as EventValidationError, i as bytesToHex, l as normalizeRelayUrls, m as CryptoError, n as assertHex32, o as isHex32, r as assertSecretKeyBytes, s as isHex64, u as normalizeURL, v as NostrError, w as PUBLIC_KEY_BYTES, y as UrlError } from "./util-DMF9AIO0.mjs";
-import { a as isRegularKind, i as isEphemeralKind, n as classifyKind, o as isReplaceableKind, r as isAddressableKind, t as Kind } from "./kind-Cxwhhkx8.mjs";
-import { C as tagValue, S as tagName, _ as firstTagValue, a as isReplaceableWinner, b as isTag, c as markVerified, d as sortEvents, f as sortedEvents, g as eventAddress, h as Tag, l as serializeEvent, m as validateSignedEvent, n as getEventHash, o as itemCompare, p as validateEvent, r as isMarkedFailed, s as markUnverified, u as signedMatchesUnsigned, v as formatEventAddress, x as parseEventAddress, y as getDTag } from "./event-CHf47dPM.mjs";
-import { a as publicKeyFromHex, i as getPublicKey, n as SecretKey, o as signEvent, r as finalizeEvent, s as toSecretKey, t as Keys } from "./key-DnVpchl6.mjs";
-import { n as verifyEvent, t as createEventVerifier } from "./verifier-B51Wkt5H.mjs";
-import { t as EventBuilder } from "./builder-aNU2gGFP.mjs";
-import { a as matchFilter, i as getFilterLimit, n as canonicalizeFilters, o as matchFilters, r as filterFingerprint, s as mergeFilters, t as canonicalizeFilter } from "./filter-BQl3GlHt.mjs";
-import { a as mergeCountHll, i as encodeRelayMessage, n as createSubscriptionId, o as parseClientMessage, r as encodeClientMessage, s as parseRelayMessage, t as assertSubscriptionId } from "./message-oNr7t0SJ.mjs";
-export { CryptoError, EVENT_ID_BYTES, EventBuilder, EventValidationError, HexError, Keys, Kind, MessageError, NostrError, PUBLIC_KEY_BYTES, SECRET_KEY_BYTES, SIGNATURE_BYTES, SUBSCRIPTION_ID_MAX_CHARS, SecretKey, Tag, UrlError, WasmPoisonedError, assertHex32, assertSecretKeyBytes, assertSubscriptionId, bytesToHex, canonicalizeFilter, canonicalizeFilters, classifyKind, createEventVerifier, createSubscriptionId, encodeClientMessage, encodeRelayMessage, eventAddress, filterFingerprint, finalizeEvent, firstTagValue, formatEventAddress, getDTag, getEventHash, getFilterLimit, getPublicKey, hexToBytes, isAddressableKind, isEphemeralKind, isHex32, isHex64, isMarkedFailed, isRegularKind, isReplaceableKind, isReplaceableWinner, isTag, itemCompare, markUnverified, markVerified, matchFilter, matchFilters, mergeCountHll, mergeFilters, normalizeRelayUrls, normalizeURL, parseClientMessage, parseEventAddress, parseRelayMessage, publicKeyFromHex, serializeEvent, signEvent, signedMatchesUnsigned, sortEvents, sortedEvents, tagName, tagValue, toSecretKey, validateEvent, validateSignedEvent, verifyEvent };
+import { a as isRegularKind, i as isEphemeralKind, n as classifyKind, o as isReplaceableKind, r as isAddressableKind, t as Kind } from "./kind-D8fENiiL.mjs";
+import { C as tagName, S as parseEventAddress, _ as eventAddress, a as isReplaceableWinner, b as getDTag, d as signedMatchesUnsigned, f as sortEvents, g as Tag, h as validateSignedEvent, l as serializeEvent, m as validateEvent, n as getEventHash, o as itemCompare, p as sortedEvents, r as isMarkedFailed, v as firstTagValue, w as tagValue, x as isTag, y as formatEventAddress } from "./event-C2eLiPpV.mjs";
+import { a as publicKeyFromHex, i as getPublicKey, n as SecretKey, o as signEvent, r as finalizeEvent, s as toSecretKey, t as Keys } from "./key-DY_HEIpY.mjs";
+import { n as verifyEvent, t as createEventVerifier } from "./verifier-uC_jd-Nw.mjs";
+import { t as EventBuilder } from "./builder-CVRmUeNm.mjs";
+import { a as matchFilter, i as getFilterLimit, n as canonicalizeFilters, o as matchFilters, r as filterFingerprint, t as canonicalizeFilter } from "./filter-TrF2LEoy.mjs";
+import { a as mergeCountHll, i as encodeRelayMessage, n as createSubscriptionId, o as parseClientMessage, r as encodeClientMessage, s as parseRelayMessage, t as assertSubscriptionId } from "./message-Rd5Z_17h.mjs";
+export { CryptoError, EVENT_ID_BYTES, EventBuilder, EventValidationError, HexError, Keys, Kind, MessageError, NostrError, PUBLIC_KEY_BYTES, SECRET_KEY_BYTES, SIGNATURE_BYTES, SUBSCRIPTION_ID_MAX_CHARS, SecretKey, Tag, UrlError, WasmPoisonedError, assertHex32, assertSecretKeyBytes, assertSubscriptionId, bytesToHex, canonicalizeFilter, canonicalizeFilters, classifyKind, createEventVerifier, createSubscriptionId, encodeClientMessage, encodeRelayMessage, eventAddress, filterFingerprint, finalizeEvent, firstTagValue, formatEventAddress, getDTag, getEventHash, getFilterLimit, getPublicKey, hexToBytes, isAddressableKind, isEphemeralKind, isHex32, isHex64, isMarkedFailed, isRegularKind, isReplaceableKind, isReplaceableWinner, isTag, itemCompare, matchFilter, matchFilters, mergeCountHll, normalizeRelayUrls, normalizeURL, parseClientMessage, parseEventAddress, parseRelayMessage, publicKeyFromHex, serializeEvent, signEvent, signedMatchesUnsigned, sortEvents, sortedEvents, tagName, tagValue, toSecretKey, validateEvent, validateSignedEvent, verifyEvent };

package/dist/{event-CHf47dPM.mjs → event-C2eLiPpV.mjs}

@@ -1,5 +1,5 @@
 import { c as isRecord, h as EventValidationError, i as bytesToHex, o as isHex32, p as utf8Encoder, s as isHex64 } from "./util-DMF9AIO0.mjs";
-import { o as isReplaceableKind, r as isAddressableKind } from "./kind-Cxwhhkx8.mjs";
+import { o as isReplaceableKind, r as isAddressableKind } from "./kind-D8fENiiL.mjs";
 import { sha256 } from "@noble/hashes/sha2.js";
 //#region src/core/tag.ts
 /** Type guard: a non-empty array of strings. */
@@ -65,8 +65,10 @@ function parseEventAddress(value) {
 	if (first <= 0) return;
 	const second = value.indexOf(":", first + 1);
 	if (second === -1) return;
-	const kind = Number(value.slice(0, first));
-	if (!Number.isInteger(kind) || kind < 0 || kind > 65535) return;
+	const kindText = value.slice(0, first);
+	if (!/^\d{1,5}$/.test(kindText)) return;
+	const kind = Number(kindText);
+	if (kind > 65535) return;
 	const pubkey = value.slice(first + 1, second).toLowerCase();
 	if (!isHex32(pubkey)) return;
 	return {
@@ -132,6 +134,14 @@ function validateSignedEvent(event) {
 */
 function serializeEvent(event) {
 	if (!validateEvent(event)) throw new EventValidationError("cannot serialize event with invalid shape");
+	return serializeValidatedEvent(event);
+}
+/**
+* Canonical serialization for an event already known valid (after {@link validateEvent} or
+* {@link validateSignedEvent}); identical output to {@link serializeEvent} without re-walking the
+* structural checks.
+*/
+function serializeValidatedEvent(event) {
 	return JSON.stringify([
 		0,
 		event.pubkey,
@@ -197,6 +207,6 @@ function signedMatchesUnsigned(signed, unsigned) {
 	return true;
 }
 //#endregion
-export { tagValue as C, tagName as S, firstTagValue as _, isReplaceableWinner as a, isTag as b, markVerified as c, sortEvents as d, sortedEvents as f, eventAddress as g, Tag as h, isMarkedVerified as i, serializeEvent as l, validateSignedEvent as m, getEventHash as n, itemCompare as o, validateEvent as p, isMarkedFailed as r, markUnverified as s, compareEventsDesc as t, signedMatchesUnsigned as u, formatEventAddress as v, parseEventAddress as x, getDTag as y };
+export { tagName as C, parseEventAddress as S, eventAddress as _, isReplaceableWinner as a, getDTag as b, markVerified as c, signedMatchesUnsigned as d, sortEvents as f, Tag as g, validateSignedEvent as h, isMarkedVerified as i, serializeEvent as l, validateEvent as m, getEventHash as n, itemCompare as o, sortedEvents as p, isMarkedFailed as r, markUnverified as s, compareEventsDesc as t, serializeValidatedEvent as u, firstTagValue as v, tagValue as w, isTag as x, formatEventAddress as y };
 
-//# sourceMappingURL=event-CHf47dPM.mjs.map
+//# sourceMappingURL=event-C2eLiPpV.mjs.map

package/dist/event-C2eLiPpV.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-C2eLiPpV.mjs","names":[],"sources":["../src/core/tag.ts","../src/core/event.ts"],"sourcesContent":["import { isAddressableKind, isReplaceableKind } from \"./kind.ts\";\nimport { isHex32 } from \"./util.ts\";\n\n/** A NIP-01 tag: first element is the name, rest are values. */\nexport type Tag = ReadonlyArray<string>;\n\n/** Mutable tag builder input. */\nexport type TagInput = string[];\n\n/** Type guard: a non-empty array of strings. */\nexport function isTag(value: unknown): value is Tag {\n  if (!Array.isArray(value) || value.length === 0) {\n    return false;\n  }\n  for (const item of value) {\n    if (typeof item !== \"string\") {\n      return false;\n    }\n  }\n  return true;\n}\n\n/** First element of a tag (its name). */\nexport function tagName(tag: Tag): string {\n  return tag[0] ?? \"\";\n}\n\n/** Second element of a tag (its primary value), or undefined for a bare name tag. */\nexport function tagValue(tag: Tag): string | undefined {\n  return tag[1];\n}\n\n/** Construct common tags. */\nexport const Tag = {\n  e(id: string, relay?: string, marker?: string, pubkey?: string): Tag {\n    const t: string[] = [\"e\", id.toLowerCase()];\n    if (relay !== undefined) {\n      t.push(relay);\n    }\n    if (marker !== undefined) {\n      t.push(marker);\n    }\n    if (pubkey !== undefined) {\n      t.push(pubkey.toLowerCase());\n    }\n    return t;\n  },\n  p(pubkey: string, relay?: string, petname?: string): Tag {\n    const t: string[] = [\"p\", pubkey.toLowerCase()];\n    if (relay !== undefined) {\n      t.push(relay);\n    }\n    if (petname !== undefined) {\n      t.push(petname);\n    }\n    return t;\n  },\n  a(coordinate: string, relay?: string): Tag {\n    const t: string[] = [\"a\", coordinate];\n    if (relay !== undefined) {\n      t.push(relay);\n    }\n    return t;\n  },\n  d(identifier: string): Tag {\n    return [\"d\", identifier];\n  },\n  t(hashtag: string): Tag {\n    return [\"t\", hashtag];\n  },\n  r(url: string, marker?: string): Tag {\n    const t: string[] = [\"r\", url];\n    if (marker !== undefined) {\n      t.push(marker);\n    }\n    return t;\n  },\n  k(kind: number | string): Tag {\n    return [\"k\", String(kind)];\n  },\n} as const;\n\n/** First tag value with the given name, or undefined when no such tag has a value. */\nexport function firstTagValue(tags: ReadonlyArray<Tag>, name: string): string | undefined {\n  for (const tag of tags) {\n    if (tag[0] === name && tag[1] !== undefined) {\n      return tag[1];\n    }\n  }\n  return undefined;\n}\n\n/** First `d` tag value on an event, if any. */\nexport function getDTag(tags: ReadonlyArray<Tag>): string | undefined {\n  return firstTagValue(tags, \"d\");\n}\n\n/** NIP-01 `a` tag: `kind:pubkey:identifier` (identifier may be empty and may contain extra colons). */\nexport type EventAddress = {\n  kind: number;\n  pubkey: string;\n  identifier: string;\n};\n\n/** Parse a NIP-01 addressable/replaceable coordinate. */\nexport function parseEventAddress(value: string): EventAddress | undefined {\n  const first = value.indexOf(\":\");\n  if (first <= 0) {\n    return undefined;\n  }\n  const second = value.indexOf(\":\", first + 1);\n  if (second === -1) {\n    return undefined;\n  }\n  const kindText = value.slice(0, first);\n  // Strict decimal: Number() also accepts \"1e4\", \"0x10\", \" 1\", \"+1\" — none are NIP-19 kinds.\n  if (!/^\\d{1,5}$/.test(kindText)) {\n    return undefined;\n  }\n  const kind = Number(kindText);\n  if (kind > 65535) {\n    return undefined;\n  }\n  const pubkey = value.slice(first + 1, second).toLowerCase();\n  if (!isHex32(pubkey)) {\n    return undefined;\n  }\n  return { kind, pubkey, identifier: value.slice(second + 1) };\n}\n\n/** Format an address as a `kind:pubkey:dTag` coordinate string. */\nexport function formatEventAddress(kind: number, pubkey: string, identifier = \"\"): string {\n  return `${kind}:${pubkey.toLowerCase()}:${identifier}`;\n}\n\n/**\n * Coordinate for replaceable (`kind:pubkey:`) and addressable (`kind:pubkey:d`) events. Undefined\n * for regular/ephemeral kinds.\n */\nexport function eventAddress(event: {\n  kind: number;\n  pubkey: string;\n  tags: ReadonlyArray<Tag>;\n}): string | undefined {\n  if (isAddressableKind(event.kind)) {\n    return formatEventAddress(event.kind, event.pubkey, getDTag(event.tags) ?? \"\");\n  }\n  if (isReplaceableKind(event.kind)) {\n    return formatEventAddress(event.kind, event.pubkey, \"\");\n  }\n  return undefined;\n}\n","import { sha256 } from \"@noble/hashes/sha2.js\";\n\nimport { EventValidationError } from \"./error.ts\";\nimport type { Tag } from \"./tag.ts\";\nimport { isTag } from \"./tag.ts\";\nimport { isHex32, isHex64, isRecord, utf8Encoder, bytesToHex } from \"./util.ts\";\n\n/** Wire event template before pubkey/id/sig. */\nexport type EventTemplate = {\n  readonly kind: number;\n  readonly tags: ReadonlyArray<Tag>;\n  readonly content: string;\n  readonly created_at: number;\n};\n\n/** Event with pubkey, ready to hash and sign. */\nexport type UnsignedEvent = EventTemplate & {\n  readonly pubkey: string;\n};\n\n/**\n * Fully formed NIP-01 event (JSON-friendly plain object). Fields are readonly at the type level;\n * wire interop remains plain JSON.\n */\nexport type Event = UnsignedEvent & {\n  readonly id: string;\n  readonly sig: string;\n};\n\n/** Cache of events whose signatures have been verified successfully. */\nconst verifiedEvents = new WeakSet<Event>();\n\n/** Cache of events known to fail verification. */\nconst failedEvents = new WeakSet<Event>();\n\nexport function markVerified(event: Event): void {\n  verifiedEvents.add(event);\n  failedEvents.delete(event);\n}\n\nexport function markUnverified(event: Event): void {\n  failedEvents.add(event);\n  verifiedEvents.delete(event);\n}\n\nexport function isMarkedVerified(event: Event): boolean {\n  return verifiedEvents.has(event);\n}\n\nexport function isMarkedFailed(event: Event): boolean {\n  return failedEvents.has(event);\n}\n\n/** Structural validation of an unsigned event (no crypto). */\nexport function validateEvent(event: unknown): event is UnsignedEvent {\n  if (!isRecord(event)) {\n    return false;\n  }\n  if (\n    typeof event[\"kind\"] !== \"number\" ||\n    !Number.isInteger(event[\"kind\"]) ||\n    event[\"kind\"] < 0 ||\n    event[\"kind\"] > 65535\n  ) {\n    return false;\n  }\n  if (typeof event[\"content\"] !== \"string\") {\n    return false;\n  }\n  if (typeof event[\"created_at\"] !== \"number\" || !Number.isInteger(event[\"created_at\"])) {\n    return false;\n  }\n  if (typeof event[\"pubkey\"] !== \"string\" || !isHex32(event[\"pubkey\"])) {\n    return false;\n  }\n  if (!Array.isArray(event[\"tags\"])) {\n    return false;\n  }\n  for (const tag of event[\"tags\"]) {\n    if (!isTag(tag)) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/** Structural validation of a full event including id and sig hex shape. */\nexport function validateSignedEvent(event: unknown): event is Event {\n  if (!validateEvent(event)) {\n    return false;\n  }\n  const e = event as Record<string, unknown>;\n  if (typeof e[\"id\"] !== \"string\" || !isHex32(e[\"id\"])) {\n    return false;\n  }\n  if (typeof e[\"sig\"] !== \"string\" || !isHex64(e[\"sig\"])) {\n    return false;\n  }\n  return true;\n}\n\n/**\n * Canonical NIP-01 serialization used for hashing: JSON array `[0, pubkey, created_at, kind, tags,\n * content]` with no extra whitespace.\n */\nexport function serializeEvent(event: UnsignedEvent): string {\n  if (!validateEvent(event)) {\n    throw new EventValidationError(\"cannot serialize event with invalid shape\");\n  }\n  return serializeValidatedEvent(event);\n}\n\n/**\n * Canonical serialization for an event already known valid (after {@link validateEvent} or\n * {@link validateSignedEvent}); identical output to {@link serializeEvent} without re-walking the\n * structural checks.\n */\nexport function serializeValidatedEvent(event: UnsignedEvent): string {\n  return JSON.stringify([0, event.pubkey, event.created_at, event.kind, event.tags, event.content]);\n}\n\n/** SHA-256 of the canonical serialization, lowercase hex. */\nexport function getEventHash(event: UnsignedEvent): string {\n  const serialized = serializeEvent(event);\n  return bytesToHex(sha256(utf8Encoder.encode(serialized)));\n}\n\n/** Id tie-break: plain code-unit order (ids are canonical lowercase hex, so `<` is lexical). */\nfunction compareIds(a: { id: string }, b: { id: string }): number {\n  if (a.id < b.id) {\n    return -1;\n  }\n  if (a.id > b.id) {\n    return 1;\n  }\n  return 0;\n}\n\n/**\n * NIP-01 newest-first order: `created_at` descending, then `id` in plain code-unit order (ids are\n * canonical lowercase hex, so `<` is lexical order).\n */\nexport function compareEventsDesc(\n  a: { id: string; created_at: number },\n  b: { id: string; created_at: number },\n): number {\n  if (a.created_at !== b.created_at) {\n    return b.created_at - a.created_at;\n  }\n  return compareIds(a, b);\n}\n\n/**\n * Sort events reverse-chronologically by `created_at`, then by `id` lexicographically. Mutates and\n * returns the array.\n */\nexport function sortEvents(events: Event[]): Event[] {\n  return events.sort(compareEventsDesc);\n}\n\n/** Non-mutating sort; returns a new array. */\nexport function sortedEvents(events: ReadonlyArray<Event>): Event[] {\n  return [...events].sort(compareEventsDesc);\n}\n\n/**\n * Negentropy item order: `created_at` ascending, then `id` lexicographic (`<`/`>`). Time axis is\n * opposite {@link sortEvents}; id tie-break is the same direction.\n */\nexport function itemCompare(\n  a: { id: string; created_at: number },\n  b: { id: string; created_at: number },\n): number {\n  if (a.created_at !== b.created_at) {\n    return a.created_at - b.created_at;\n  }\n  return compareIds(a, b);\n}\n\n/**\n * NIP-01 replaceable/addressable winner: higher `created_at`, or equal timestamp and\n * lexicographically lower `id`.\n */\nexport function isReplaceableWinner(\n  candidate: { created_at: number; id: string },\n  incumbent: { created_at: number; id: string },\n): boolean {\n  if (candidate.created_at !== incumbent.created_at) {\n    return candidate.created_at > incumbent.created_at;\n  }\n  return candidate.id < incumbent.id;\n}\n\n/** True when a signed event is the signed form of `unsigned` (kind/tags/content/time/pubkey). */\nexport function signedMatchesUnsigned(signed: Event, unsigned: UnsignedEvent): boolean {\n  if (signed.kind !== unsigned.kind) {\n    return false;\n  }\n  if (signed.content !== unsigned.content) {\n    return false;\n  }\n  if (signed.created_at !== unsigned.created_at) {\n    return false;\n  }\n  if (JSON.stringify(signed.tags) !== JSON.stringify(unsigned.tags)) {\n    return false;\n  }\n  if (unsigned.pubkey && signed.pubkey.toLowerCase() !== unsigned.pubkey.toLowerCase()) {\n    return false;\n  }\n  return true;\n}\n"],"mappings":"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"}

package/dist/{event-DJeb_DIL.d.mts → event-j3BwI5dF.d.mts}

@@ -63,8 +63,6 @@ type Event = UnsignedEvent & {
   readonly id: string;
   readonly sig: string;
 };
-declare function markVerified(event: Event): void;
-declare function markUnverified(event: Event): void;
 declare function isMarkedFailed(event: Event): boolean;
 /** Structural validation of an unsigned event (no crypto). */
 declare function validateEvent(event: unknown): event is UnsignedEvent;
@@ -109,5 +107,5 @@ declare function isReplaceableWinner(candidate: {
 /** True when a signed event is the signed form of `unsigned` (kind/tags/content/time/pubkey). */
 declare function signedMatchesUnsigned(signed: Event, unsigned: UnsignedEvent): boolean;
 //#endregion
-export { isTag as C, tagValue as E, getDTag as S, tagName as T, Tag as _, isMarkedFailed as a, firstTagValue as b, markUnverified as c, signedMatchesUnsigned as d, sortEvents as f, EventAddress as g, validateSignedEvent as h, getEventHash as i, markVerified as l, validateEvent as m, EventTemplate as n, isReplaceableWinner as o, sortedEvents as p, UnsignedEvent as r, itemCompare as s, Event as t, serializeEvent as u, TagInput as v, parseEventAddress as w, formatEventAddress as x, eventAddress as y };
-//# sourceMappingURL=event-DJeb_DIL.d.mts.map
+export { tagName as C, parseEventAddress as S, eventAddress as _, isMarkedFailed as a, getDTag as b, serializeEvent as c, sortedEvents as d, validateEvent as f, TagInput as g, Tag as h, getEventHash as i, signedMatchesUnsigned as l, EventAddress as m, EventTemplate as n, isReplaceableWinner as o, validateSignedEvent as p, UnsignedEvent as r, itemCompare as s, Event as t, sortEvents as u, firstTagValue as v, tagValue as w, isTag as x, formatEventAddress as y };
+//# sourceMappingURL=event-j3BwI5dF.d.mts.map

package/dist/{filter-jI_9htF7.d.mts → filter-CfEgQBXt.d.mts}

@@ -1,4 +1,4 @@
-import { t as Event } from "./event-DJeb_DIL.mjs";
+import { t as Event } from "./event-j3BwI5dF.mjs";
 //#region src/core/filter.d.ts
 /** NIP-01 filter object (immutable-friendly; callers may still pass plain objects). */
 type Filter = {
@@ -16,8 +16,6 @@ type Filter = {
 declare function matchFilter(filter: Filter, event: Event): boolean;
 /** True when the event matches any of the filters (NIP-01 OR semantics). */
 declare function matchFilters(filters: ReadonlyArray<Filter>, event: Event): boolean;
-/** Merge filters by unioning list fields; returns a new plain object. */
-declare function mergeFilters(...filters: Filter[]): Filter;
 /**
  * Intrinsic upper bound implied by the filter alone. Returns a positive integer, or `Infinity` when
  * unbounded.
@@ -33,5 +31,5 @@ declare function canonicalizeFilters(filters: ReadonlyArray<Filter>): Filter[];
  */
 declare function filterFingerprint(filters: ReadonlyArray<Filter>): string;
 //#endregion
-export { getFilterLimit as a, mergeFilters as c, filterFingerprint as i, canonicalizeFilter as n, matchFilter as o, canonicalizeFilters as r, matchFilters as s, Filter as t };
-//# sourceMappingURL=filter-jI_9htF7.d.mts.map
+export { getFilterLimit as a, filterFingerprint as i, canonicalizeFilter as n, matchFilter as o, canonicalizeFilters as r, matchFilters as s, Filter as t };
+//# sourceMappingURL=filter-CfEgQBXt.d.mts.map

package/dist/{filter-BQl3GlHt.mjs → filter-TrF2LEoy.mjs}

@@ -1,4 +1,4 @@
-import { o as isReplaceableKind, r as isAddressableKind } from "./kind-Cxwhhkx8.mjs";
+import { o as isReplaceableKind, r as isAddressableKind } from "./kind-D8fENiiL.mjs";
 //#region src/core/filter.ts
 /** Local NIP-01 match. `search` is ignored; relays interpret NIP-50. */
 function matchFilter(filter, event) {
@@ -27,39 +27,6 @@ function matchFilters(filters, event) {
 	for (const filter of filters) if (matchFilter(filter, event)) return true;
 	return false;
 }
-/** Merge filters by unioning list fields; returns a new plain object. */
-function mergeFilters(...filters) {
-	const result = {};
-	const mergeList = (property, values) => {
-		if (values === void 0) return;
-		const existing = result[property];
-		const list = Array.isArray(existing) ? [...existing] : [];
-		for (const value of values) if (!list.includes(value)) list.push(value);
-		result[property] = list;
-	};
-	const mergeMax = (property, value) => {
-		if (value === void 0) return;
-		const prev = result[property];
-		if (typeof prev !== "number" || value > prev) result[property] = value;
-	};
-	for (const filter of filters) {
-		mergeList("ids", filter.ids);
-		mergeList("authors", filter.authors);
-		mergeList("kinds", filter.kinds);
-		for (const key of Object.keys(filter)) {
-			if (!key.startsWith("#")) continue;
-			mergeList(key, filter[key]);
-		}
-		mergeMax("limit", filter.limit);
-		mergeMax("until", filter.until);
-		if (filter.since !== void 0) {
-			const prev = result["since"];
-			if (typeof prev !== "number" || filter.since < prev) result["since"] = filter.since;
-		}
-		if (filter.search !== void 0) result["search"] = filter.search;
-	}
-	return result;
-}
 /**
 * Intrinsic upper bound implied by the filter alone. Returns a positive integer, or `Infinity` when
 * unbounded.
@@ -115,6 +82,6 @@ function filterFingerprint(filters) {
 	return `[${parts.join(",")}]`;
 }
 //#endregion
-export { matchFilter as a, getFilterLimit as i, canonicalizeFilters as n, matchFilters as o, filterFingerprint as r, mergeFilters as s, canonicalizeFilter as t };
+export { matchFilter as a, getFilterLimit as i, canonicalizeFilters as n, matchFilters as o, filterFingerprint as r, canonicalizeFilter as t };
 
-//# sourceMappingURL=filter-BQl3GlHt.mjs.map
+//# sourceMappingURL=filter-TrF2LEoy.mjs.map

package/dist/filter-TrF2LEoy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-TrF2LEoy.mjs","names":[],"sources":["../src/core/filter.ts"],"sourcesContent":["import type { Event } from \"./event.ts\";\nimport { isAddressableKind, isReplaceableKind } from \"./kind.ts\";\n\n/** NIP-01 filter object (immutable-friendly; callers may still pass plain objects). */\nexport type Filter = {\n  readonly ids?: ReadonlyArray<string> | undefined;\n  readonly kinds?: ReadonlyArray<number> | undefined;\n  readonly authors?: ReadonlyArray<string> | undefined;\n  readonly since?: number | undefined;\n  readonly until?: number | undefined;\n  readonly limit?: number | undefined;\n  /** NIP-50 full-text search. Relays interpret this. Local `matchFilter` / `query` ignore it. */\n  readonly search?: string | undefined;\n  readonly [key: `#${string}`]: ReadonlyArray<string> | undefined;\n};\n\n/** Local NIP-01 match. `search` is ignored; relays interpret NIP-50. */\nexport function matchFilter(filter: Filter, event: Event): boolean {\n  if (filter.ids && !filter.ids.some((id) => id.toLowerCase() === event.id)) {\n    return false;\n  }\n  if (filter.kinds && !filter.kinds.includes(event.kind)) {\n    return false;\n  }\n  if (filter.authors && !filter.authors.some((pk) => pk.toLowerCase() === event.pubkey)) {\n    return false;\n  }\n\n  for (const key of Object.keys(filter)) {\n    if (!key.startsWith(\"#\")) {\n      continue;\n    }\n    const tagName = key.slice(1);\n    const values = filter[`#${tagName}`];\n    if (!values) {\n      continue;\n    }\n    const hexTag = tagName === \"e\" || tagName === \"p\";\n    const hit = event.tags.some((tag) => {\n      const [tagKey, tagValue] = tag;\n      if (tagKey !== tagName || tagValue === undefined) {\n        return false;\n      }\n      if (hexTag) {\n        return values.some((v) => v.toLowerCase() === tagValue.toLowerCase());\n      }\n      return values.includes(tagValue);\n    });\n    if (!hit) {\n      return false;\n    }\n  }\n\n  if (filter.since !== undefined && event.created_at < filter.since) {\n    return false;\n  }\n  if (filter.until !== undefined && event.created_at > filter.until) {\n    return false;\n  }\n\n  return true;\n}\n\n/** True when the event matches any of the filters (NIP-01 OR semantics). */\nexport function matchFilters(filters: ReadonlyArray<Filter>, event: Event): boolean {\n  for (const filter of filters) {\n    if (matchFilter(filter, event)) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Intrinsic upper bound implied by the filter alone. Returns a positive integer, or `Infinity` when\n * unbounded.\n */\nexport function getFilterLimit(filter: Filter): number {\n  if (filter.ids && filter.ids.length === 0) {\n    return 0;\n  }\n  if (filter.kinds && filter.kinds.length === 0) {\n    return 0;\n  }\n  if (filter.authors && filter.authors.length === 0) {\n    return 0;\n  }\n\n  let limit = Number.POSITIVE_INFINITY;\n  if (filter.ids) {\n    limit = Math.min(limit, filter.ids.length);\n  }\n  if (filter.limit !== undefined) {\n    limit = Math.min(limit, filter.limit);\n  }\n\n  if (filter.kinds && filter.authors) {\n    const allReplaceable = filter.kinds.every((k) => isReplaceableKind(k) || isAddressableKind(k));\n    if (allReplaceable) {\n      const dTags = filter[\"#d\"];\n      const perAuthor = dTags && dTags.length > 0 ? dTags.length : 1;\n      limit = Math.min(limit, filter.authors.length * filter.kinds.length * perAuthor);\n    }\n  }\n\n  return limit;\n}\n\nconst HEX_LIST_KEYS = new Set([\"ids\", \"authors\", \"#e\", \"#p\"]);\n\n/** Lowercase hex lists and sort every array. Omits undefined so `[]` stays distinct from missing. */\nexport function canonicalizeFilter(filter: Filter): Filter {\n  const raw = filter as Record<string, unknown>;\n  const out: Record<string, unknown> = {};\n  for (const key of Object.keys(raw).sort()) {\n    const value = raw[key];\n    // omit undefined so a missing key is not `[]` / null\n    if (value === undefined) {\n      continue;\n    }\n    if (Array.isArray(value)) {\n      if (HEX_LIST_KEYS.has(key)) {\n        out[key] = value.map((v) => String(v).toLowerCase()).sort();\n      } else if (key === \"kinds\") {\n        out[key] = value.map(Number).sort((a, b) => a - b);\n      } else {\n        out[key] = value.map(String).sort();\n      }\n    } else {\n      out[key] = value;\n    }\n  }\n  // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- built key by key above; the record is filter-shaped by construction\n  return out as Filter;\n}\n\n/** Apply {@link canonicalizeFilter} to each filter. */\nexport function canonicalizeFilters(filters: ReadonlyArray<Filter>): Filter[] {\n  return filters.map(canonicalizeFilter);\n}\n\n/**\n * Canonical identity for live REQ coalescing. Relays treat a missing list key as unconstrained and\n * `[]` as match-nothing.\n */\nexport function filterFingerprint(filters: ReadonlyArray<Filter>): string {\n  const parts = filters.map((filter) => JSON.stringify(canonicalizeFilter(filter)));\n  parts.sort();\n  return `[${parts.join(\",\")}]`;\n}\n"],"mappings":"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"}

package/dist/{gossip-DFxIBlsr.mjs → gossip-5ezg0Quo.mjs}

@@ -1,6 +1,6 @@
 import { d as nowSeconds, l as normalizeRelayUrls, u as normalizeURL } from "./util-DMF9AIO0.mjs";
-import { t as Kind } from "./kind-Cxwhhkx8.mjs";
-import { a as isReplaceableWinner } from "./event-CHf47dPM.mjs";
+import { t as Kind } from "./kind-D8fENiiL.mjs";
+import { a as isReplaceableWinner } from "./event-C2eLiPpV.mjs";
 import { parseRelayList } from "./nips/nip65.mjs";
 import { i as trimOldest, r as touchKey } from "./collections-DtwMc1NU.mjs";
 import { parseDmRelayList } from "./nips/nip17.mjs";
@@ -225,4 +225,4 @@ var Gossip = class {
 //#endregion
 export { Gossip as t };
 
-//# sourceMappingURL=gossip-DFxIBlsr.mjs.map
+//# sourceMappingURL=gossip-5ezg0Quo.mjs.map

package/dist/gossip-5ezg0Quo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gossip-5ezg0Quo.mjs","names":[],"sources":["../src/gossip/gossip.ts"],"sourcesContent":["import { touchKey, trimOldest } from \"../core/collections.ts\";\nimport type { Event } from \"../core/event.ts\";\nimport { isReplaceableWinner } from \"../core/event.ts\";\nimport type { Filter } from \"../core/filter.ts\";\nimport { Kind } from \"../core/kind.ts\";\nimport { normalizeRelayUrls, normalizeURL, nowSeconds } from \"../core/util.ts\";\nimport { parseDmRelayList } from \"../nips/nip17.ts\";\nimport { parseRelayList } from \"../nips/nip65.ts\";\nimport type { RelayListItem } from \"../nips/nip65.ts\";\n\n/** Relay routing state for one pubkey: NIP-65 outbox/inbox plus NIP-17 DM relays. */\nexport type PubkeyRoutes = {\n  /** Relays the user writes to (outbox). NIP-65. */\n  readonly write: ReadonlyArray<string>;\n  /** Relays the user reads from (inbox). NIP-65. */\n  readonly read: ReadonlyArray<string>;\n  /** Relays for NIP-17 gift-wrap delivery. Kind 10050. */\n  readonly dm: ReadonlyArray<string>;\n  /** `created_at` of the last accepted kind:10002 list. */\n  readonly updatedAt: number;\n  /** `created_at` of the last accepted kind:10050 list. */\n  readonly dmUpdatedAt: number;\n  /** Event id of the last accepted kind:10002 (NIP-01 equal-timestamp tie-break). */\n  readonly relayListId?: string | undefined;\n  /** Event id of the last accepted kind:10050. */\n  readonly dmListId?: string | undefined;\n};\n\n/** A filter split by gossip routes: per-relay narrowed filters plus the unrouted remainder. */\nexport type RoutedFilter = {\n  /** Url → already-narrowed filter. Empty when nothing routed. */\n  readonly perRelay: ReadonlyMap<string, Filter>;\n  /**\n   * Unrouted work for the caller:\n   *\n   * - No authors and no #p: original filter (\"generic\")\n   * - Authors/#p all unrouted: original filter (\"orphan\")\n   * - Mixed: narrowed leftover (\"fallback\")\n   * - All routed: undefined\n   */\n  readonly remainder?: Filter | undefined;\n};\n\nexport type GossipOptions = {\n  /**\n   * Max relays kept per direction; the first N in list order win (NIP-65 defines no ranking).\n   * Default 4.\n   */\n  maxRelaysPerPubkey?: number | undefined;\n  /**\n   * Max pubkeys with tracked routes; the map is LRU — writes and lookups refresh recency, and\n   * inserting beyond the cap drops the oldest entry. Default 10_000.\n   */\n  maxPubkeys?: number | undefined;\n};\n\nfunction emptyRoutes(): PubkeyRoutes {\n  return {\n    write: [],\n    read: [],\n    dm: [],\n    updatedAt: 0,\n    dmUpdatedAt: 0,\n  };\n}\n\n/**\n * Routing table for NIP-65 (10002) and NIP-17 DM relays (10050). Ingest replaceable list events,\n * then route filters into per-relay REQs.\n */\nexport class Gossip {\n  readonly #routes = new Map<string, PubkeyRoutes>();\n  readonly #maxRelays: number;\n  readonly #maxPubkeys: number;\n\n  constructor(opts: GossipOptions = {}) {\n    this.#maxRelays = opts.maxRelaysPerPubkey ?? 4;\n    this.#maxPubkeys = opts.maxPubkeys ?? 10_000;\n  }\n\n  /**\n   * Ingest a routing list event.\n   *\n   * - Kind:10002 → write/read (NIP-65)\n   * - Kind:10050 → dm (NIP-17)\n   *\n   * Returns true if routes for that list type were updated.\n   */\n  ingest(event: Event): boolean {\n    if (event.kind === Kind.RelayList) {\n      let items: RelayListItem[];\n      try {\n        items = parseRelayList(event);\n      } catch {\n        return false;\n      }\n      return this.setRoutes(event.pubkey, items, event.created_at, event.id);\n    }\n    if (event.kind === Kind.DirectMessageRelaysList) {\n      let relays: string[];\n      try {\n        relays = parseDmRelayList(event);\n      } catch {\n        return false;\n      }\n      return this.setDmRoutes(event.pubkey, relays, event.created_at, event.id);\n    }\n    return false;\n  }\n\n  setRoutes(\n    pubkey: string,\n    items: ReadonlyArray<RelayListItem>,\n    updatedAt: number = nowSeconds(),\n    eventId?: string,\n  ): boolean {\n    const pk = pubkey.toLowerCase();\n    const prev = this.#lookup(pk) ?? emptyRoutes();\n    if (prev.updatedAt > updatedAt) {\n      return false;\n    }\n    if (\n      eventId !== undefined &&\n      prev.relayListId !== undefined &&\n      prev.updatedAt === updatedAt &&\n      !isReplaceableWinner(\n        { created_at: updatedAt, id: eventId },\n        { created_at: prev.updatedAt, id: prev.relayListId },\n      )\n    ) {\n      return false;\n    }\n\n    const write: string[] = [];\n    const read: string[] = [];\n    for (const item of items) {\n      let url: string;\n      try {\n        url = normalizeURL(item.url);\n      } catch {\n        continue;\n      }\n      if (item.marker !== \"read\" && !write.includes(url)) {\n        write.push(url);\n      }\n      if (item.marker !== \"write\" && !read.includes(url)) {\n        read.push(url);\n      }\n    }\n\n    this.#put(pk, {\n      write: write.slice(0, this.#maxRelays),\n      read: read.slice(0, this.#maxRelays),\n      dm: prev.dm,\n      updatedAt,\n      dmUpdatedAt: prev.dmUpdatedAt,\n      relayListId: eventId ?? prev.relayListId,\n      dmListId: prev.dmListId,\n    });\n    return true;\n  }\n\n  setDmRoutes(\n    pubkey: string,\n    relays: ReadonlyArray<string>,\n    updatedAt: number = nowSeconds(),\n    eventId?: string,\n  ): boolean {\n    const pk = pubkey.toLowerCase();\n    const prev = this.#lookup(pk) ?? emptyRoutes();\n    if (prev.dmUpdatedAt > updatedAt) {\n      return false;\n    }\n    if (\n      eventId !== undefined &&\n      prev.dmListId !== undefined &&\n      prev.dmUpdatedAt === updatedAt &&\n      !isReplaceableWinner(\n        { created_at: updatedAt, id: eventId },\n        { created_at: prev.dmUpdatedAt, id: prev.dmListId },\n      )\n    ) {\n      return false;\n    }\n\n    const dm = normalizeRelayUrls(relays);\n\n    this.#put(pk, {\n      write: prev.write,\n      read: prev.read,\n      dm: dm.slice(0, this.#maxRelays),\n      updatedAt: prev.updatedAt,\n      dmUpdatedAt: updatedAt,\n      relayListId: prev.relayListId,\n      dmListId: eventId ?? prev.dmListId,\n    });\n    return true;\n  }\n\n  getRoutes(pubkey: string): Readonly<PubkeyRoutes> | undefined {\n    return this.#lookup(pubkey.toLowerCase());\n  }\n\n  outboxRelays(pubkey: string): ReadonlyArray<string> {\n    return this.#lookup(pubkey.toLowerCase())?.write ?? [];\n  }\n\n  inboxRelays(pubkey: string): ReadonlyArray<string> {\n    return this.#lookup(pubkey.toLowerCase())?.read ?? [];\n  }\n\n  /** NIP-17 kind:10050 delivery relays for gift-wraps. */\n  dmRelays(pubkey: string): ReadonlyArray<string> {\n    return this.#lookup(pubkey.toLowerCase())?.dm ?? [];\n  }\n\n  clear(pubkey?: string): void {\n    if (pubkey !== undefined && pubkey !== \"\") {\n      this.#routes.delete(pubkey.toLowerCase());\n    } else {\n      this.#routes.clear();\n    }\n  }\n\n  get size(): number {\n    return this.#routes.size;\n  }\n\n  /**\n   * Route a user-facing filter into per-relay sub-filters plus leftover.\n   *\n   * - Authors → outbox relays, filter narrowed per relay's authors\n   * - #p only → inbox relays of those pubkeys\n   * - Neither / all unrouted → remainder is the original filter\n   * - Mixed → remainder is the narrowed leftover; all routed → no remainder\n   */\n  route(filter: Filter): RoutedFilter {\n    const authors = filter.authors?.map((a) => a.toLowerCase());\n    const pTags = filter[\"#p\"]?.map((p) => p.toLowerCase());\n\n    if ((!authors || authors.length === 0) && (!pTags || pTags.length === 0)) {\n      return { perRelay: new Map(), remainder: filter };\n    }\n\n    if (authors && authors.length > 0 && (!pTags || pTags.length === 0)) {\n      return this.#breakAuthors(filter, authors, \"write\");\n    }\n\n    if (pTags && pTags.length > 0 && (!authors || authors.length === 0)) {\n      const { authors: _authors, ...base } = filter;\n      return this.#breakAuthors(base, pTags, \"read\", (b, pubkeys) => ({ ...b, \"#p\": pubkeys }));\n    }\n\n    // both authors and #p: send full filter to union of routes\n    const unionKeys = new Set([...(authors ?? []), ...(pTags ?? [])]);\n    const relays = new Set<string>();\n    let anyUnrouted = false;\n    for (const pk of unionKeys) {\n      const r = this.#lookup(pk);\n      const urls = r ? [...r.write, ...r.read] : [];\n      if (urls.length === 0) {\n        anyUnrouted = true;\n        continue;\n      }\n      for (const u of urls) {\n        relays.add(u);\n      }\n    }\n    if (relays.size === 0) {\n      return { perRelay: new Map(), remainder: filter };\n    }\n    const map = new Map<string, Filter>();\n    for (const url of relays) {\n      map.set(url, { ...filter });\n    }\n    return anyUnrouted ? { perRelay: map, remainder: filter } : { perRelay: map };\n  }\n\n  #breakAuthors(\n    filter: Filter,\n    pubkeys: string[],\n    direction: \"read\" | \"write\",\n    narrow: (base: Filter, pubkeys: string[]) => Filter = (base, pks) => ({\n      ...base,\n      authors: pks,\n    }),\n  ): RoutedFilter {\n    const perRelay = new Map<string, string[]>();\n    const unrouted: string[] = [];\n    let anyRoute = false;\n\n    for (const pk of pubkeys) {\n      const routes = this.#lookup(pk);\n      const urls = direction === \"write\" ? routes?.write : routes?.read;\n      if (!urls || urls.length === 0) {\n        unrouted.push(pk);\n        continue;\n      }\n      anyRoute = true;\n      for (const url of urls) {\n        const list = perRelay.get(url) ?? [];\n        list.push(pk);\n        perRelay.set(url, list);\n      }\n    }\n\n    if (!anyRoute) {\n      return { perRelay: new Map(), remainder: filter };\n    }\n\n    const map = new Map<string, Filter>();\n    for (const [url, pks] of perRelay) {\n      map.set(url, narrow(filter, pks));\n    }\n    return unrouted.length > 0\n      ? { perRelay: map, remainder: narrow(filter, unrouted) }\n      : { perRelay: map };\n  }\n\n  /** Read that refreshes LRU recency. */\n  #lookup(pk: string): PubkeyRoutes | undefined {\n    const routes = this.#routes.get(pk);\n    if (routes !== undefined) {\n      touchKey(this.#routes, pk, routes);\n    }\n    return routes;\n  }\n\n  /** Write at the newest LRU end, then trim the oldest beyond the cap. */\n  #put(pk: string, routes: PubkeyRoutes): void {\n    touchKey(this.#routes, pk, routes);\n    trimOldest(this.#routes, this.#maxPubkeys);\n  }\n}\n"],"mappings":"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"}

package/dist/{gossip-OOeeFzG5.d.mts → gossip-BWb9HmfK.d.mts}

@@ -1,6 +1,6 @@
-import { t as Event } from "./event-DJeb_DIL.mjs";
-import { t as Filter } from "./filter-jI_9htF7.mjs";
-import { t as RelayListItem } from "./nip65-D1fbmhOg.mjs";
+import { t as Event } from "./event-j3BwI5dF.mjs";
+import { t as Filter } from "./filter-CfEgQBXt.mjs";
+import { t as RelayListItem } from "./nip65-BL79HI8N.mjs";
 //#region src/gossip/gossip.d.ts
 /** Relay routing state for one pubkey: NIP-65 outbox/inbox plus NIP-17 DM relays. */
 type PubkeyRoutes = {
@@ -34,7 +34,10 @@ type RoutedFilter = {
   readonly remainder?: Filter | undefined;
 };
 type GossipOptions = {
-  /** Max relays to keep per direction when ranking. Default 4. */
+  /**
+   * Max relays kept per direction; the first N in list order win (NIP-65 defines no ranking).
+   * Default 4.
+   */
   maxRelaysPerPubkey?: number | undefined;
   /**
    * Max pubkeys with tracked routes; the map is LRU — writes and lookups refresh recency, and
@@ -79,4 +82,4 @@ declare class Gossip {
 }
 //#endregion
 export { RoutedFilter as i, GossipOptions as n, PubkeyRoutes as r, Gossip as t };
-//# sourceMappingURL=gossip-OOeeFzG5.d.mts.map
+//# sourceMappingURL=gossip-BWb9HmfK.d.mts.map

package/dist/gossip.d.mts

@@ -1,3 +1,3 @@
-import { i as RoutedFilter, n as GossipOptions, r as PubkeyRoutes, t as Gossip } from "./gossip-OOeeFzG5.mjs";
+import { i as RoutedFilter, n as GossipOptions, r as PubkeyRoutes, t as Gossip } from "./gossip-BWb9HmfK.mjs";
 import "./index-CaxrMD1A.mjs";
 export { Gossip, type GossipOptions, type PubkeyRoutes, type RoutedFilter };

package/dist/gossip.mjs

@@ -1,2 +1,2 @@
-import { t as Gossip } from "./gossip-DFxIBlsr.mjs";
+import { t as Gossip } from "./gossip-5ezg0Quo.mjs";
 export { Gossip };

package/dist/http-CuazNRIP.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"http-CuazNRIP.mjs","names":[],"sources":["../src/nips/http.ts"],"sourcesContent":["/**\n * Shared nips HTTP primitive. Not a pack entry (core has zero network). Callers never pass\n * `redirect`; sendManual always sets `\"manual\"`.\n */\n\nexport type ManualFetch = (\n  url: string,\n  init?: {\n    method?: string;\n    headers?: Record<string, string>;\n    // oxlint-disable-next-line no-restricted-types -- mirrors RequestInit.body, which is nullable\n    body?: Blob | FormData | string | null;\n    signal?: AbortSignal | undefined;\n  },\n) => Promise<{\n  ok: boolean;\n  status: number;\n  // oxlint-disable-next-line no-restricted-types -- mirrors Headers.get, which returns null\n  headers: { get: (name: string) => string | null };\n  json: () => Promise<unknown>;\n  arrayBuffer: () => Promise<ArrayBuffer>;\n}>;\n\ntype ManualInit = NonNullable<Parameters<ManualFetch>[1]>;\n\nexport function requireGlobalFetch(missing: () => Error): ManualFetch {\n  if (typeof globalThis.fetch !== \"function\") {\n    throw missing();\n  }\n  const fetchImpl = globalThis.fetch.bind(globalThis);\n  // RequestInit.signal is AbortSignal | null and rejects explicit undefined under\n  // exactOptionalPropertyTypes; normalize it for the real fetch.\n  return async (url, init) =>\n    fetchImpl(url, init === undefined ? init : { ...init, signal: init.signal ?? null });\n}\n\n/** Always sets redirect:manual. Shared by fetchManual and headStatus. */\nexport async function sendManual(\n  fetchImpl: ManualFetch,\n  url: string,\n  init: ManualInit,\n): Promise<Awaited<ReturnType<ManualFetch>>> {\n  return fetchImpl(url, { ...init, redirect: \"manual\" } as Parameters<ManualFetch>[1]);\n}\n\nexport async function fetchManual(\n  fetchImpl: ManualFetch,\n  url: string,\n  init: ManualInit,\n  wrapNetwork: (err: unknown) => Error,\n): Promise<Awaited<ReturnType<ManualFetch>>> {\n  try {\n    return await sendManual(fetchImpl, url, init);\n  } catch (error) {\n    if (error instanceof Error && error.name === \"AbortError\") {\n      throw error;\n    }\n    throw wrapNetwork(error);\n  }\n}\n"],"mappings":";AAyBA,SAAgB,mBAAmB,SAAmC;CACpE,IAAI,OAAO,WAAW,UAAU,YAC9B,MAAM,QAAQ;CAEhB,MAAM,YAAY,WAAW,MAAM,KAAK,UAAU;CAGlD,OAAO,OAAO,KAAK,SACjB,UAAU,KAAK,SAAS,KAAA,IAAY,OAAO;EAAE,GAAG;EAAM,QAAQ,KAAK,UAAU;CAAK,CAAC;AACvF;;AAGA,eAAsB,WACpB,WACA,KACA,MAC2C;CAC3C,OAAO,UAAU,KAAK;EAAE,GAAG;EAAM,UAAU;CAAS,CAA+B;AACrF;AAEA,eAAsB,YACpB,WACA,KACA,MACA,aAC2C;CAC3C,IAAI;EACF,OAAO,MAAM,WAAW,WAAW,KAAK,IAAI;CAC9C,SAAS,OAAO;EACd,IAAI,iBAAiB,SAAS,MAAM,SAAS,cAC3C,MAAM;EAER,MAAM,YAAY,KAAK;CACzB;AACF"}
+{"version":3,"file":"http-CuazNRIP.mjs","names":[],"sources":["../src/nips/http.ts"],"sourcesContent":["/**\n * Shared nips HTTP primitive. Not a pack entry (core has zero network). Callers never pass\n * `redirect`; sendManual always sets `\"manual\"`.\n */\n\nexport type ManualFetchInit = {\n  method?: string;\n  headers?: Record<string, string>;\n  // oxlint-disable-next-line no-restricted-types -- mirrors RequestInit.body, which is nullable\n  body?: Blob | FormData | string | null;\n  signal?: AbortSignal | undefined;\n  /**\n   * Always `\"manual\"`: NIP-05, NIP-11 and Blossom responses must never be followed through\n   * redirects. Adapters must forward this to their underlying fetch implementation.\n   */\n  redirect: \"manual\";\n};\n\nexport type ManualFetch = (\n  url: string,\n  init?: ManualFetchInit,\n) => Promise<{\n  ok: boolean;\n  status: number;\n  // oxlint-disable-next-line no-restricted-types -- mirrors Headers.get, which returns null\n  headers: { get: (name: string) => string | null };\n  json: () => Promise<unknown>;\n  arrayBuffer: () => Promise<ArrayBuffer>;\n}>;\n\ntype ManualInit = Omit<ManualFetchInit, \"redirect\">;\n\nexport function requireGlobalFetch(missing: () => Error): ManualFetch {\n  if (typeof globalThis.fetch !== \"function\") {\n    throw missing();\n  }\n  const fetchImpl = globalThis.fetch.bind(globalThis);\n  // RequestInit.signal is AbortSignal | null and rejects explicit undefined under\n  // exactOptionalPropertyTypes; normalize it for the real fetch.\n  return async (url, init) =>\n    fetchImpl(url, init === undefined ? init : { ...init, signal: init.signal ?? null });\n}\n\n/** Always sets redirect:manual. Shared by fetchManual and headStatus. */\nexport async function sendManual(\n  fetchImpl: ManualFetch,\n  url: string,\n  init: ManualInit,\n): Promise<Awaited<ReturnType<ManualFetch>>> {\n  return fetchImpl(url, { ...init, redirect: \"manual\" });\n}\n\nexport async function fetchManual(\n  fetchImpl: ManualFetch,\n  url: string,\n  init: ManualInit,\n  wrapNetwork: (err: unknown) => Error,\n): Promise<Awaited<ReturnType<ManualFetch>>> {\n  try {\n    return await sendManual(fetchImpl, url, init);\n  } catch (error) {\n    if (error instanceof Error && error.name === \"AbortError\") {\n      throw error;\n    }\n    throw wrapNetwork(error);\n  }\n}\n"],"mappings":";AAgCA,SAAgB,mBAAmB,SAAmC;CACpE,IAAI,OAAO,WAAW,UAAU,YAC9B,MAAM,QAAQ;CAEhB,MAAM,YAAY,WAAW,MAAM,KAAK,UAAU;CAGlD,OAAO,OAAO,KAAK,SACjB,UAAU,KAAK,SAAS,KAAA,IAAY,OAAO;EAAE,GAAG;EAAM,QAAQ,KAAK,UAAU;CAAK,CAAC;AACvF;;AAGA,eAAsB,WACpB,WACA,KACA,MAC2C;CAC3C,OAAO,UAAU,KAAK;EAAE,GAAG;EAAM,UAAU;CAAS,CAAC;AACvD;AAEA,eAAsB,YACpB,WACA,KACA,MACA,aAC2C;CAC3C,IAAI;EACF,OAAO,MAAM,WAAW,WAAW,KAAK,IAAI;CAC9C,SAAS,OAAO;EACd,IAAI,iBAAiB,SAAS,MAAM,SAAS,cAC3C,MAAM;EAER,MAAM,YAAY,KAAK;CACzB;AACF"}

package/dist/{http-C4HwIu4B.d.mts → http-kwWG-V1X.d.mts}

@@ -3,12 +3,18 @@
  * Shared nips HTTP primitive. Not a pack entry (core has zero network). Callers never pass
  * `redirect`; sendManual always sets `"manual"`.
  */
-type ManualFetch = (url: string, init?: {
+type ManualFetchInit = {
   method?: string;
   headers?: Record<string, string>;
   body?: Blob | FormData | string | null;
   signal?: AbortSignal | undefined;
-}) => Promise<{
+  /**
+   * Always `"manual"`: NIP-05, NIP-11 and Blossom responses must never be followed through
+   * redirects. Adapters must forward this to their underlying fetch implementation.
+   */
+  redirect: "manual";
+};
+type ManualFetch = (url: string, init?: ManualFetchInit) => Promise<{
   ok: boolean;
   status: number;
   headers: {
@@ -19,4 +25,4 @@ type ManualFetch = (url: string, init?: {
 }>;
 //#endregion
 export { ManualFetch as t };
-//# sourceMappingURL=http-C4HwIu4B.d.mts.map
+//# sourceMappingURL=http-kwWG-V1X.d.mts.map

package/dist/{index-CPVEyzNX.d.mts → index-B1fLejg4.d.mts}

@@ -1,13 +1,13 @@
-import { t as Event } from "./event-DJeb_DIL.mjs";
-import { n as ProfileMetadata } from "./builder-CTwkB2zM.mjs";
-import { t as RelayListItem } from "./nip65-D1fbmhOg.mjs";
-import { t as Gossip } from "./gossip-OOeeFzG5.mjs";
+import { t as Event } from "./event-j3BwI5dF.mjs";
+import { n as ProfileMetadata } from "./builder-GBddxj8i.mjs";
+import { t as RelayListItem } from "./nip65-BL79HI8N.mjs";
+import { t as Gossip } from "./gossip-BWb9HmfK.mjs";
 import { a as NostrError } from "./error-BquXDmIN.mjs";
-import { _ as Closer, n as Pool } from "./pool-CqQvUnsq.mjs";
-import { r as OutboxBound, t as EventStore } from "./types-BacwnDtU.mjs";
-import { t as ReactiveEventStore } from "./reactive-gGqUrzW8.mjs";
+import { _ as Closer, n as Pool } from "./pool-Bfe3Tu40.mjs";
+import { r as OutboxBound, t as EventStore } from "./types-Ccox7-5v.mjs";
+import { t as ReactiveEventStore } from "./reactive-X4p6nABy.mjs";
 import { i as EventPointer, t as AddressPointer } from "./nip19-DpPN17bY.mjs";
-import { t as MuteItem } from "./nip51-CR0Q8eym.mjs";
+import { t as MuteItem } from "./nip51-O_vhOiK2.mjs";
 //#region src/loaders/event.d.ts
 type EventRef = string | EventPointer | AddressPointer;
 /**
@@ -186,4 +186,4 @@ type CreateLoadersOptions = {
 declare function createLoaders(opts: CreateLoadersOptions): Loaders;
 //#endregion
 export { EventRef as _, OutboxFeed as a, NostrUser as c, ListLoaders as d, ListResult as f, EventLoader as g, ReplaceableLoader as h, OutboxError as i, ProfileLoader as l, ReplaceableLoadResult as m, Loaders as n, OutboxFeedOptions as o, LoadStyle as p, createLoaders as r, groupAuthorsByOutboxRelay as s, CreateLoadersOptions as t, bareNostrUser as u };
-//# sourceMappingURL=index-CPVEyzNX.d.mts.map
+//# sourceMappingURL=index-B1fLejg4.d.mts.map

package/dist/{index-C_w2WfVz.d.mts → index-C0mFpelb.d.mts}

@@ -1,8 +1,8 @@
-import { n as EventTemplate, r as UnsignedEvent, t as Event } from "./event-DJeb_DIL.mjs";
-import { i as SecretKeyInput, t as Keys } from "./key-D_5OgGT7.mjs";
-import { t as Filter } from "./filter-jI_9htF7.mjs";
+import { n as EventTemplate, r as UnsignedEvent, t as Event } from "./event-j3BwI5dF.mjs";
+import { i as SecretKeyInput, t as Keys } from "./key-CyKN1RTi.mjs";
+import { t as Filter } from "./filter-CfEgQBXt.mjs";
 import { a as NostrError } from "./error-BquXDmIN.mjs";
-import { t as NostrSigner } from "./types-DNmiscfd.mjs";
+import { t as NostrSigner } from "./types-BJ4wZ7JJ.mjs";
 import { n as ClientMetadata, t as BunkerPointer } from "./nip46-BHaxC9TZ.mjs";
 //#region src/signer/error.d.ts
 /**
@@ -74,7 +74,7 @@ type Nip46SubscribeOptions = {
 };
 /**
  * Structural relay transport for NIP-46 RPC. Satisfied by {@link import("../relay/pool.ts").Pool};
- * constructed above the signer layer so `signer` never imports `relay` (ADR-0001).
+ * constructed above the signer layer so `signer` never imports `relay` (see AGENTS.md).
  */
 type Nip46Transport = {
   subscribe: (relays: ReadonlyArray<string>, filters: ReadonlyArray<Filter>, opts?: Nip46SubscribeOptions) => {
@@ -174,4 +174,4 @@ declare class Nip46Signer implements NostrSigner {
 }
 //#endregion
 export { Nip07Signer as a, isNip07Available as c, Nip46Transport as i, KeysSigner as l, Nip46SignerOptions as n, WindowNostr as o, Nip46SubscribeOptions as r, getWindowNostr as s, Nip46Signer as t, NoSignerError as u };
-//# sourceMappingURL=index-C_w2WfVz.d.mts.map
+//# sourceMappingURL=index-C0mFpelb.d.mts.map

package/dist/{index-DyKwQnbt.d.mts → index-CLJEKFGd.d.mts}

@@ -1,7 +1,7 @@
-import { t as Event } from "./event-DJeb_DIL.mjs";
-import { t as Filter } from "./filter-jI_9htF7.mjs";
+import { t as Event } from "./event-j3BwI5dF.mjs";
+import { t as Filter } from "./filter-CfEgQBXt.mjs";
 import { a as NostrError } from "./error-BquXDmIN.mjs";
-import { _ as Closer, n as Pool } from "./pool-CqQvUnsq.mjs";
+import { _ as Closer, n as Pool } from "./pool-Bfe3Tu40.mjs";
 //#region src/relay/error.d.ts
 /** Base class for relay errors; carries the relay URL when known. */
 declare class RelayError extends NostrError {
@@ -79,4 +79,4 @@ declare function fetchRouted(pool: Pool, jobs: ReadonlyArray<RoutedJob>, opts?:
 }): Promise<Event[]>;
 //#endregion
 export { isInsecureRelayUrl as a, RelayError as c, RelayTimeoutError as d, fetchRouted as i, RelayPublishError as l, RoutedJob as n, RelayClosedError as o, fanIn as r, RelayConnectionError as s, FanInOptions as t, RelaySuspendedError as u };
-//# sourceMappingURL=index-DyKwQnbt.d.mts.map
+//# sourceMappingURL=index-CLJEKFGd.d.mts.map

package/dist/{index-BxCBX-8R.d.mts → index-CoX7SnO7.d.mts}

@@ -1,6 +1,6 @@
-import { t as Event } from "./event-DJeb_DIL.mjs";
-import { t as Filter } from "./filter-jI_9htF7.mjs";
-import { i as PutResult, n as NegentropyItem, r as OutboxBound, t as EventStore } from "./types-BacwnDtU.mjs";
+import { t as Event } from "./event-j3BwI5dF.mjs";
+import { t as Filter } from "./filter-CfEgQBXt.mjs";
+import { i as PutResult, n as NegentropyItem, r as OutboxBound, t as EventStore } from "./types-Ccox7-5v.mjs";
 //#region src/storage/memory-index.d.ts
 type MemoryIndexOptions = {
   /**
@@ -124,6 +124,9 @@ type SqlValue = string | number | null | Uint8Array;
  * start before the previous one settles, inside or outside a transaction — so drivers need not
  * support overlapping statements on one connection.
  *
+ * The store does not rely on per-connection PRAGMAs: tag rows are deleted explicitly, so `PRAGMA
+ * foreign_keys` may be off on any connection (including transaction connections).
+ *
  * `expo-sqlite` maps onto this interface without changes to query code. Note that
  * `withExclusiveTransactionAsync` resolves `void` and statements inside the exclusive transaction
  * must run on the `txn` connection passed to its callback, not on `db` — the result is captured
@@ -185,4 +188,4 @@ declare class SqliteEventStore implements EventStore {
 }
 //#endregion
 export { IndexedDbEventStoreOptions as a, MemoryIndexOptions as c, IndexedDbEventStore as i, SqlValue as n, MemoryEventStore as o, SqliteEventStore as r, MemoryIndex as s, SqlDriver as t };
-//# sourceMappingURL=index-BxCBX-8R.d.mts.map
+//# sourceMappingURL=index-CoX7SnO7.d.mts.map

package/dist/{index-DU9tRFTZ.d.mts → index-Hp26bgYG.d.mts}

@@ -36,7 +36,10 @@ declare function normalizeURL(url: string): string;
 declare function normalizeRelayUrls(urls: Iterable<string>): string[];
 //#endregion
 //#region src/core/kind.d.ts
-/** NIP-01 regular: stored by relays. */
+/**
+ * NIP-01 regular ranges verbatim; kinds outside every defined range are still stored like regular
+ * events (see {@link classifyKind}).
+ */
 declare function isRegularKind(kind: number): boolean;
 /** Replaceable: latest per (pubkey, kind) wins. */
 declare function isReplaceableKind(kind: number): boolean;
@@ -45,8 +48,12 @@ declare function isEphemeralKind(kind: number): boolean;
 /** Addressable (parameterized replaceable): latest per (pubkey, kind, d-tag) wins. */
 declare function isAddressableKind(kind: number): boolean;
 /** NIP-01 kind classes: regular / replaceable / ephemeral / addressable. */
-type KindClassification = "regular" | "replaceable" | "ephemeral" | "addressable" | "unknown";
-/** Classify a kind number into its NIP-01 storage class (`"unknown"` outside all ranges). */
+type KindClassification = "regular" | "replaceable" | "ephemeral" | "addressable";
+/**
+ * Classify a kind number into its NIP-01 storage class. NIP-01 leaves kinds 45–999 and 40000+
+ * undefined (rather than forbidden); relays store them like regular events, so they classify
+ * `"regular"` here even though {@link isRegularKind} returns false for them.
+ */
 declare function classifyKind(kind: number): KindClassification;
 /** Kind numbers used by this package. */
 declare const Kind: {
@@ -85,4 +92,4 @@ type KindName = keyof typeof Kind;
 type KnownKind = (typeof Kind)[KindName];
 //#endregion
 export { SUBSCRIPTION_ID_MAX_CHARS as S, normalizeURL as _, classifyKind as a, SECRET_KEY_BYTES as b, isRegularKind as c, assertSecretKeyBytes as d, bytesToHex as f, normalizeRelayUrls as g, isHex64 as h, KnownKind as i, isReplaceableKind as l, isHex32 as m, KindClassification as n, isAddressableKind as o, hexToBytes as p, KindName as r, isEphemeralKind as s, Kind as t, assertHex32 as u, EVENT_ID_BYTES as v, SIGNATURE_BYTES as x, PUBLIC_KEY_BYTES as y };
-//# sourceMappingURL=index-DU9tRFTZ.d.mts.map
+//# sourceMappingURL=index-Hp26bgYG.d.mts.map

package/dist/{index-Cl_1XdYP.d.mts → index-uCYwXaaP.d.mts}

@@ -1,15 +1,15 @@
-import { n as EventTemplate, r as UnsignedEvent, t as Event } from "./event-DJeb_DIL.mjs";
-import { t as EventBuilder } from "./builder-CTwkB2zM.mjs";
-import { t as Filter } from "./filter-jI_9htF7.mjs";
-import { t as Gossip } from "./gossip-OOeeFzG5.mjs";
+import { n as EventTemplate, r as UnsignedEvent, t as Event } from "./event-j3BwI5dF.mjs";
+import { t as EventBuilder } from "./builder-GBddxj8i.mjs";
+import { t as Filter } from "./filter-CfEgQBXt.mjs";
+import { t as Gossip } from "./gossip-BWb9HmfK.mjs";
 import { a as NostrError } from "./error-BquXDmIN.mjs";
-import { _ as Closer, a as PoolFetchResult, n as Pool, o as PoolOptions, s as PoolPublishResult } from "./pool-CqQvUnsq.mjs";
-import { t as EventStore } from "./types-BacwnDtU.mjs";
-import { t as ReactiveEventStore } from "./reactive-gGqUrzW8.mjs";
-import { a as OutboxFeed, n as Loaders } from "./index-CPVEyzNX.mjs";
-import { a as Rumor } from "./nip59-C-RWFQIv.mjs";
-import { i as ReplyTo, r as Recipient } from "./nip17-B5WgW4C4.mjs";
-import { t as NostrSigner } from "./types-DNmiscfd.mjs";
+import { _ as Closer, a as PoolFetchResult, n as Pool, o as PoolOptions, s as PoolPublishResult } from "./pool-Bfe3Tu40.mjs";
+import { t as EventStore } from "./types-Ccox7-5v.mjs";
+import { t as ReactiveEventStore } from "./reactive-X4p6nABy.mjs";
+import { a as OutboxFeed, n as Loaders } from "./index-B1fLejg4.mjs";
+import { a as Rumor } from "./nip59-CdDoJptA.mjs";
+import { i as ReplyTo, r as Recipient } from "./nip17-B7MI82Iq.mjs";
+import { t as NostrSigner } from "./types-BJ4wZ7JJ.mjs";
 import { t as StorageError } from "./error-BD_0QFKT.mjs";
 //#region src/client/types.d.ts
 /** Direction of a {@link Client.sync} run: upload, download, or both. */
@@ -215,9 +215,17 @@ declare class Client {
    * function.
    */
   on<K extends keyof ClientEventMap>(type: K, listener: (err: ClientEventMap[K]) => void): () => void;
-  /** Ingest one inbound event: index (with relay URL) → meta → persistence. */
+  /**
+   * Ingest one inbound event: index (with relay URL) → meta → persistence. The event must carry a
+   * valid signature; {@link EventValidationError} is thrown otherwise. Events delivered by relay
+   * subscriptions are already verified, so this is a WeakSet cache hit on those paths.
+   */
   observe(event: Event, relayUrl?: string): void;
-  /** Ingest many events (deduped by id, order preserved) as one persist batch. */
+  /**
+   * Ingest many events (deduped by id, order preserved) as one persist batch. Every event must
+   * carry a valid signature — all are verified before anything is ingested, so a batch is
+   * all-or-nothing.
+   */
   observeAll(events: ReadonlyArray<Event>): void;
   /**
    * Explicitly load kind:10002 and kind:10050 lists for pubkeys and feed gossip. Does not
@@ -282,4 +290,4 @@ declare class Client {
 }
 //#endregion
 export { SyncSummary as _, FetchEachOptions as a, PrivateMessageSendResult as c, SendPrivateMessageOptions as d, SubscribeOptions as f, SyncOptions as g, SyncDirectionName as h, ClientOptions as i, PublishOptions as l, SyncDirection as m, ClientError as n, FetchEventsOptions as o, SubscribePrivateMessagesOptions as p, ClientEventMap as r, FetchPrivateMessagesOptions as s, Client as t, ReceivedPrivateMessage as u };
-//# sourceMappingURL=index-Cl_1XdYP.d.mts.map
+//# sourceMappingURL=index-uCYwXaaP.d.mts.map