@qntx/nostr 0.6.0 → 0.8.0

package/dist/{gossip-oloDMWEj.mjs → gossip-DFxIBlsr.mjs}

@@ -1,7 +1,8 @@
-import { l as normalizeURL } from "./util-LfQirgDk.mjs";
+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-D8Nfoh4K.mjs";
+import { a as isReplaceableWinner } from "./event-CHf47dPM.mjs";
 import { parseRelayList } from "./nips/nip65.mjs";
+import { i as trimOldest, r as touchKey } from "./collections-DtwMc1NU.mjs";
 import { parseDmRelayList } from "./nips/nip17.mjs";
 //#region src/gossip/gossip.ts
 function emptyRoutes() {
@@ -26,7 +27,11 @@ var Gossip = class {
 		this.#maxPubkeys = opts.maxPubkeys ?? 1e4;
 	}
 	/**
-	* Ingest a routing list event. - kind:10002 → write/read (NIP-65) - kind:10050 → dm (NIP-17)
+	* Ingest a routing list event.
+	*
+	* - Kind:10002 → write/read (NIP-65)
+	* - Kind:10050 → dm (NIP-17)
+	*
 	* Returns true if routes for that list type were updated.
 	*/
 	ingest(event) {
@@ -50,7 +55,7 @@ var Gossip = class {
 		}
 		return false;
 	}
-	setRoutes(pubkey, items, updatedAt = Math.floor(Date.now() / 1e3), eventId) {
+	setRoutes(pubkey, items, updatedAt = nowSeconds(), eventId) {
 		const pk = pubkey.toLowerCase();
 		const prev = this.#lookup(pk) ?? emptyRoutes();
 		if (prev.updatedAt > updatedAt) return false;
@@ -70,8 +75,8 @@ var Gossip = class {
 			} catch {
 				continue;
 			}
-			if (item.write && !write.includes(url)) write.push(url);
-			if (item.read && !read.includes(url)) read.push(url);
+			if (item.marker !== "read" && !write.includes(url)) write.push(url);
+			if (item.marker !== "write" && !read.includes(url)) read.push(url);
 		}
 		this.#put(pk, {
 			write: write.slice(0, this.#maxRelays),
@@ -84,7 +89,7 @@ var Gossip = class {
 		});
 		return true;
 	}
-	setDmRoutes(pubkey, relays, updatedAt = Math.floor(Date.now() / 1e3), eventId) {
+	setDmRoutes(pubkey, relays, updatedAt = nowSeconds(), eventId) {
 		const pk = pubkey.toLowerCase();
 		const prev = this.#lookup(pk) ?? emptyRoutes();
 		if (prev.dmUpdatedAt > updatedAt) return false;
@@ -95,16 +100,7 @@ var Gossip = class {
 			created_at: prev.dmUpdatedAt,
 			id: prev.dmListId
 		})) return false;
-		const dm = [];
-		for (const raw of relays) {
-			let url;
-			try {
-				url = normalizeURL(raw);
-			} catch {
-				continue;
-			}
-			if (!dm.includes(url)) dm.push(url);
-		}
+		const dm = normalizeRelayUrls(relays);
 		this.#put(pk, {
 			write: prev.write,
 			read: prev.read,
@@ -137,10 +133,12 @@ var Gossip = class {
 		return this.#routes.size;
 	}
 	/**
-	* Route a user-facing filter into per-relay sub-filters plus leftover. - authors → outbox relays,
-	* filter narrowed per relay's authors - #p only → inbox relays of those pubkeys - neither / all
-	* unrouted → remainder is the original filter - mixed → remainder is the narrowed leftover; all
-	* routed → no remainder
+	* Route a user-facing filter into per-relay sub-filters plus leftover.
+	*
+	* - Authors → outbox relays, filter narrowed per relay's authors
+	* - #p only → inbox relays of those pubkeys
+	* - Neither / all unrouted → remainder is the original filter
+	* - Mixed → remainder is the narrowed leftover; all routed → no remainder
 	*/
 	route(filter) {
 		const authors = filter.authors?.map((a) => a.toLowerCase());
@@ -215,24 +213,16 @@ var Gossip = class {
 	/** Read that refreshes LRU recency. */
 	#lookup(pk) {
 		const routes = this.#routes.get(pk);
-		if (routes !== void 0) {
-			this.#routes.delete(pk);
-			this.#routes.set(pk, routes);
-		}
+		if (routes !== void 0) touchKey(this.#routes, pk, routes);
 		return routes;
 	}
 	/** Write at the newest LRU end, then trim the oldest beyond the cap. */
 	#put(pk, routes) {
-		this.#routes.delete(pk);
-		this.#routes.set(pk, routes);
-		while (this.#routes.size > this.#maxPubkeys) {
-			const oldest = this.#routes.keys().next().value;
-			if (oldest === void 0) break;
-			this.#routes.delete(oldest);
-		}
+		touchKey(this.#routes, pk, routes);
+		trimOldest(this.#routes, this.#maxPubkeys);
 	}
 };
 //#endregion
 export { Gossip as t };
 
-//# sourceMappingURL=gossip-oloDMWEj.mjs.map
+//# sourceMappingURL=gossip-DFxIBlsr.mjs.map

package/dist/gossip-DFxIBlsr.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gossip-DFxIBlsr.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  /** Max relays to keep per direction when ranking. Default 4. */\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-DpIvkBuj.d.mts → gossip-OOeeFzG5.d.mts}

@@ -1,43 +1,46 @@
-import { t as Event } from "./event-fU3Y01PR.mjs";
-import { t as Filter } from "./filter-C0IMByE3.mjs";
-import { t as RelayListItem } from "./nip65-CjgmdpPB.mjs";
+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";
 //#region src/gossip/gossip.d.ts
 /** Relay routing state for one pubkey: NIP-65 outbox/inbox plus NIP-17 DM relays. */
 type PubkeyRoutes = {
   /** Relays the user writes to (outbox). NIP-65. */
-  write: string[];
+  readonly write: ReadonlyArray<string>;
   /** Relays the user reads from (inbox). NIP-65. */
-  read: string[];
+  readonly read: ReadonlyArray<string>;
   /** Relays for NIP-17 gift-wrap delivery. Kind 10050. */
-  dm: string[];
+  readonly dm: ReadonlyArray<string>;
   /** `created_at` of the last accepted kind:10002 list. */
-  updatedAt: number;
+  readonly updatedAt: number;
   /** `created_at` of the last accepted kind:10050 list. */
-  dmUpdatedAt: number;
+  readonly dmUpdatedAt: number;
   /** Event id of the last accepted kind:10002 (NIP-01 equal-timestamp tie-break). */
-  relayListId?: string | undefined;
+  readonly relayListId?: string | undefined;
   /** Event id of the last accepted kind:10050. */
-  dmListId?: string | undefined;
+  readonly dmListId?: string | undefined;
 };
 /** A filter split by gossip routes: per-relay narrowed filters plus the unrouted remainder. */
 type RoutedFilter = {
   /** Url → already-narrowed filter. Empty when nothing routed. */
-  perRelay: Map<string, Filter>;
+  readonly perRelay: ReadonlyMap<string, Filter>;
   /**
-   * Unrouted work for the caller: - no authors and no #p: original filter (today's "generic") -
-   * authors/#p all unrouted: original filter (today's "orphan") - mixed: narrowed leftover (today's
-   * fallback) - all routed: undefined
+   * Unrouted work for the caller:
+   *
+   * - No authors and no #p: original filter ("generic")
+   * - Authors/#p all unrouted: original filter ("orphan")
+   * - Mixed: narrowed leftover ("fallback")
+   * - All routed: undefined
    */
-  remainder?: Filter;
+  readonly remainder?: Filter | undefined;
 };
 type GossipOptions = {
   /** Max relays to keep per direction when ranking. Default 4. */
-  maxRelaysPerPubkey?: number;
+  maxRelaysPerPubkey?: number | undefined;
   /**
    * Max pubkeys with tracked routes; the map is LRU — writes and lookups refresh recency, and
    * inserting beyond the cap drops the oldest entry. Default 10_000.
    */
-  maxPubkeys?: number;
+  maxPubkeys?: number | undefined;
 };
 /**
  * Routing table for NIP-65 (10002) and NIP-17 DM relays (10050). Ingest replaceable list events,
@@ -47,27 +50,33 @@ declare class Gossip {
   #private;
   constructor(opts?: GossipOptions);
   /**
-   * Ingest a routing list event. - kind:10002 → write/read (NIP-65) - kind:10050 → dm (NIP-17)
+   * Ingest a routing list event.
+   *
+   * - Kind:10002 → write/read (NIP-65)
+   * - Kind:10050 → dm (NIP-17)
+   *
    * Returns true if routes for that list type were updated.
    */
   ingest(event: Event): boolean;
-  setRoutes(pubkey: string, items: RelayListItem[], updatedAt?: number, eventId?: string): boolean;
+  setRoutes(pubkey: string, items: ReadonlyArray<RelayListItem>, updatedAt?: number, eventId?: string): boolean;
   setDmRoutes(pubkey: string, relays: ReadonlyArray<string>, updatedAt?: number, eventId?: string): boolean;
-  getRoutes(pubkey: string): PubkeyRoutes | undefined;
-  outboxRelays(pubkey: string): string[];
-  inboxRelays(pubkey: string): string[];
+  getRoutes(pubkey: string): Readonly<PubkeyRoutes> | undefined;
+  outboxRelays(pubkey: string): ReadonlyArray<string>;
+  inboxRelays(pubkey: string): ReadonlyArray<string>;
   /** NIP-17 kind:10050 delivery relays for gift-wraps. */
-  dmRelays(pubkey: string): string[];
+  dmRelays(pubkey: string): ReadonlyArray<string>;
   clear(pubkey?: string): void;
   get size(): number;
   /**
-   * Route a user-facing filter into per-relay sub-filters plus leftover. - authors → outbox relays,
-   * filter narrowed per relay's authors - #p only → inbox relays of those pubkeys - neither / all
-   * unrouted → remainder is the original filter - mixed → remainder is the narrowed leftover; all
-   * routed → no remainder
+   * Route a user-facing filter into per-relay sub-filters plus leftover.
+   *
+   * - Authors → outbox relays, filter narrowed per relay's authors
+   * - #p only → inbox relays of those pubkeys
+   * - Neither / all unrouted → remainder is the original filter
+   * - Mixed → remainder is the narrowed leftover; all routed → no remainder
    */
   route(filter: Filter): RoutedFilter;
 }
 //#endregion
 export { RoutedFilter as i, GossipOptions as n, PubkeyRoutes as r, Gossip as t };
-//# sourceMappingURL=gossip-DpIvkBuj.d.mts.map
+//# sourceMappingURL=gossip-OOeeFzG5.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-DpIvkBuj.mjs";
+import { i as RoutedFilter, n as GossipOptions, r as PubkeyRoutes, t as Gossip } from "./gossip-OOeeFzG5.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-oloDMWEj.mjs";
+import { t as Gossip } from "./gossip-DFxIBlsr.mjs";
 export { Gossip };

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

@@ -1,6 +1,6 @@
-import { t as Event } from "./event-fU3Y01PR.mjs";
-import { t as Filter } from "./filter-C0IMByE3.mjs";
-import { i as PutResult, n as NegentropyItem, r as OutboxBound, t as EventStore } from "./types-2pCUprRU.mjs";
+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";
 //#region src/storage/memory-index.d.ts
 type MemoryIndexOptions = {
   /**
@@ -8,7 +8,7 @@ type MemoryIndexOptions = {
    * e-tag ids, and coordinate tombstones. Default unbounded. Trade-off: once an entry is trimmed, a
    * re-arriving old deleted event or replaceable version can be accepted again.
    */
-  maxTombstones?: number;
+  maxTombstones?: number | undefined;
   /**
    * FIFO cap on replaceable/addressable winner watermarks recorded by {@link evict}. A watermark
    * keeps only `{ id, created_at }` per address so stale versions stay rejected after the winner's
@@ -16,11 +16,11 @@ type MemoryIndexOptions = {
    * retention); callers that evict should pass a bound. Once a watermark is trimmed, an older
    * evicted version can be accepted again — the same trade-off as deletion tombstones.
    */
-  maxWatermarks?: number;
+  maxWatermarks?: number | undefined;
   /** Fires after every physical index insert (accept, replace, deletion event). */
-  onInsert?: (event: Event) => void;
+  onInsert?: ((event: Event) => void) | undefined;
   /** Fires after every physical index remove (replace, delete, evict, remove, clear). */
-  onRemove?: (event: Event) => void;
+  onRemove?: ((event: Event) => void) | undefined;
 };
 /**
  * Synchronous in-memory event index with NIP-01 replaceable / addressable / ephemeral handling and
@@ -68,10 +68,10 @@ declare class MemoryEventStore implements EventStore {
   /** Sequential `put` in input order. No transaction: a throw leaves earlier events applied. */
   putMany(events: ReadonlyArray<Event>): Promise<PutResult[]>;
   get(id: string): Promise<Event | undefined>;
-  query(filters: Filter[]): Promise<Event[]>;
-  count(filters: Filter[]): Promise<number>;
+  query(filters: ReadonlyArray<Filter>): Promise<Event[]>;
+  count(filters: ReadonlyArray<Filter>): Promise<number>;
   negentropyItems(filter: Filter): Promise<NegentropyItem[]>;
-  remove(ids: string[]): Promise<number>;
+  remove(ids: ReadonlyArray<string>): Promise<number>;
   getOutboxBound(pubkey: string, kind: number): Promise<OutboxBound | undefined>;
   setOutboxBound(pubkey: string, kind: number, bound: OutboxBound): Promise<void>;
   clear(): Promise<void>;
@@ -82,7 +82,7 @@ declare class MemoryEventStore implements EventStore {
 /** Options for {@link IndexedDbEventStore}. */
 type IndexedDbEventStoreOptions = {
   /** IndexedDB database name. */
-  dbName?: string;
+  dbName?: string | undefined;
 };
 /**
  * Browser IndexedDB event store with the same replaceable / deletion semantics as
@@ -100,12 +100,12 @@ declare class IndexedDbEventStore implements EventStore {
   /** One readwrite transaction; abort rejects the whole batch with no partial persist. */
   putMany(events: ReadonlyArray<Event>): Promise<PutResult[]>;
   get(id: string): Promise<Event | undefined>;
-  query(filters: Filter[]): Promise<Event[]>;
-  count(filters: Filter[]): Promise<number>;
+  query(filters: ReadonlyArray<Filter>): Promise<Event[]>;
+  count(filters: ReadonlyArray<Filter>): Promise<number>;
   negentropyItems(filter: Filter): Promise<NegentropyItem[]>;
   getOutboxBound(pubkey: string, kind: number): Promise<OutboxBound | undefined>;
   setOutboxBound(pubkey: string, kind: number, bound: OutboxBound): Promise<void>;
-  remove(ids: string[]): Promise<number>;
+  remove(ids: ReadonlyArray<string>): Promise<number>;
   clear(): Promise<void>;
   close(): void;
 }
@@ -175,14 +175,14 @@ declare class SqliteEventStore implements EventStore {
   put(event: Event): Promise<PutResult>;
   putMany(events: ReadonlyArray<Event>): Promise<PutResult[]>;
   get(id: string): Promise<Event | undefined>;
-  query(filters: Filter[]): Promise<Event[]>;
-  count(filters: Filter[]): Promise<number>;
+  query(filters: ReadonlyArray<Filter>): Promise<Event[]>;
+  count(filters: ReadonlyArray<Filter>): Promise<number>;
   negentropyItems(filter: Filter): Promise<NegentropyItem[]>;
   getOutboxBound(pubkey: string, kind: number): Promise<OutboxBound | undefined>;
   setOutboxBound(pubkey: string, kind: number, bound: OutboxBound): Promise<void>;
-  remove(ids: string[]): Promise<number>;
+  remove(ids: ReadonlyArray<string>): Promise<number>;
   clear(): Promise<void>;
 }
 //#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-D1bqFHKB.d.mts.map
+//# sourceMappingURL=index-BxCBX-8R.d.mts.map

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

@@ -1,12 +1,13 @@
-import { t as Event } from "./event-fU3Y01PR.mjs";
-import { n as ProfileMetadata } from "./builder-sSflu6nB.mjs";
-import { t as RelayListItem } from "./nip65-CjgmdpPB.mjs";
-import { t as Gossip } from "./gossip-DpIvkBuj.mjs";
-import { a as NostrError } from "./error-CR8Urc84.mjs";
-import { n as Pool } from "./pool-DBIYMtwy.mjs";
-import { r as OutboxBound, t as EventStore } from "./types-2pCUprRU.mjs";
-import { t as ReactiveEventStore } from "./reactive-7aqeip4A.mjs";
-import { i as EventPointer, t as AddressPointer } from "./nip19-BevCJZsp.mjs";
+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 { 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 { i as EventPointer, t as AddressPointer } from "./nip19-DpPN17bY.mjs";
+import { t as MuteItem } from "./nip51-CR0Q8eym.mjs";
 //#region src/loaders/event.d.ts
 type EventRef = string | EventPointer | AddressPointer;
 /**
@@ -21,8 +22,8 @@ type EventLoader = {
 //#region src/loaders/replaceable.d.ts
 /** Result of a replaceable load: the winning event (or none) and freshness. */
 type ReplaceableLoadResult = {
-  event: Event | undefined;
-  fresh: boolean;
+  readonly event: Event | undefined;
+  readonly fresh: boolean;
 };
 /** `default`: fetch when stale or unfetched; `force`: always fetch; `cache-only`: index only. */
 type LoadStyle = "default" | "force" | "cache-only";
@@ -35,23 +36,9 @@ type ReplaceableLoader = (pubkey: string, opts?: {
 //#region src/loaders/lists.d.ts
 /** Result of a list loader: the source event, its decoded items, and freshness. */
 type ListResult<T> = {
-  event: Event | undefined;
-  items: T[];
-  fresh: boolean;
-};
-/** One muted entity decoded from a kind:10000 mute list. */
-type MutedEntity = {
-  label: "pubkey";
-  value: string;
-} | {
-  label: "thread";
-  value: string;
-} | {
-  label: "hashtag";
-  value: string;
-} | {
-  label: "word";
-  value: string;
+  readonly event: Event | undefined;
+  readonly items: ReadonlyArray<T>;
+  readonly fresh: boolean;
 };
 type ListLoaderOpts = {
   hints?: string[] | undefined;
@@ -59,7 +46,7 @@ type ListLoaderOpts = {
 };
 type ListLoaders = {
   follows: (pubkey: string, opts?: ListLoaderOpts) => Promise<ListResult<string>>;
-  muteList: (pubkey: string, opts?: ListLoaderOpts) => Promise<ListResult<MutedEntity>>;
+  muteList: (pubkey: string, opts?: ListLoaderOpts) => Promise<ListResult<MuteItem>>;
   relayList: (pubkey: string, opts?: ListLoaderOpts) => Promise<ListResult<RelayListItem>>;
   dmRelayList: (pubkey: string, opts?: ListLoaderOpts) => Promise<ListResult<string>>;
 };
@@ -67,14 +54,14 @@ type ListLoaders = {
 //#region src/loaders/profile.d.ts
 /** A profile-card view of a pubkey: identity fields plus the kind:0 event. */
 type NostrUser = {
-  pubkey: string;
-  npub: string;
-  shortName: string;
-  image?: string;
-  metadata: ProfileMetadata;
-  lastUpdated: number;
-  event: Event | undefined;
-  fresh: boolean;
+  readonly pubkey: string;
+  readonly npub: string;
+  readonly shortName: string;
+  readonly image?: string | undefined;
+  readonly metadata: ProfileMetadata;
+  readonly lastUpdated: number;
+  readonly event: Event | undefined;
+  readonly fresh: boolean;
 };
 /** A {@link NostrUser} with no metadata — used when no kind:0 event exists. */
 declare function bareNostrUser(pubkey: string): NostrUser;
@@ -90,7 +77,7 @@ type ProfileLoader = {
 declare class OutboxError extends NostrError {
   name: string;
 }
-/** Options for {@link createOutboxFeed}. */
+/** Options for {@link OutboxFeed}. */
 type OutboxFeedOptions = {
   pool: Pool;
   gossip: Gossip;
@@ -156,21 +143,16 @@ declare class OutboxFeed {
   startLive(opts?: {
     signal?: AbortSignal | undefined;
     since?: number | undefined;
-  }): {
-    close: (reason?: string) => void;
-  };
+  }): Closer;
   /** Convenience: hydrate + sync + startLive. */
   start(opts?: {
     limit?: number | undefined;
     signal?: AbortSignal | undefined;
-  }): Promise<{
-    close: (reason?: string) => void;
+  }): Promise<Closer & {
     events: Event[];
   }>;
   close(): void;
 }
-/** Factory matching other loaders helpers. */
-declare function createOutboxFeed(opts: OutboxFeedOptions): OutboxFeed;
 //#endregion
 //#region src/loaders/index.d.ts
 /** The loader surface returned by {@link createLoaders}. */
@@ -196,12 +178,12 @@ type CreateLoadersOptions = {
    * Inbound-event sink for fetched events; defaults to `index.add`. Client wires its single ingest
    * path so loader fetches get gossip meta and persistence like every other inbound event.
    */
-  ingest?: (event: Event, relayUrl: string) => void;
-  staleAfterSec?: number;
-  fetchTimeoutMs?: number;
+  ingest?: ((event: Event, relayUrl: string) => void) | undefined;
+  staleAfterSec?: number | undefined;
+  fetchTimeoutMs?: number | undefined;
 };
 /** Build an instance-scoped loader suite (no module globals). */
 declare function createLoaders(opts: CreateLoadersOptions): Loaders;
 //#endregion
-export { ReplaceableLoader as _, OutboxFeed as a, groupAuthorsByOutboxRelay as c, bareNostrUser as d, ListLoaders as f, ReplaceableLoadResult as g, LoadStyle as h, OutboxError as i, NostrUser as l, MutedEntity as m, Loaders as n, OutboxFeedOptions as o, ListResult as p, createLoaders as r, createOutboxFeed as s, CreateLoadersOptions as t, ProfileLoader as u, EventLoader as v, EventRef as y };
-//# sourceMappingURL=index-lvXeER5t.d.mts.map
+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

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

@@ -1,9 +1,9 @@
-import { n as EventTemplate, r as UnsignedEvent, t as Event } from "./event-fU3Y01PR.mjs";
-import { r as SecretKey, t as Keys } from "./key-Cv4_pN3x.mjs";
-import { t as Filter } from "./filter-C0IMByE3.mjs";
-import { a as NostrError } from "./error-CR8Urc84.mjs";
-import { t as NostrSigner } from "./types-CRQEk0Oi.mjs";
-import { n as BunkerPointer, r as ClientMetadata } from "./nip46-DDV4dC56.mjs";
+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 { a as NostrError } from "./error-BquXDmIN.mjs";
+import { t as NostrSigner } from "./types-DNmiscfd.mjs";
+import { n as ClientMetadata, t as BunkerPointer } from "./nip46-BHaxC9TZ.mjs";
 //#region src/signer/error.d.ts
 /**
  * Thrown by a lazy NIP-42 AUTH sign function when no signer is configured at challenge time.
@@ -18,7 +18,7 @@ declare class NoSignerError extends NostrError {
 /** Local secret-key signer with NIP-04 (legacy) and NIP-44 support. */
 declare class KeysSigner implements NostrSigner {
   #private;
-  constructor(secretKey: SecretKey | Uint8Array | string | Keys);
+  constructor(secretKey: SecretKeyInput | Keys);
   get keys(): Keys;
   getPublicKey(): Promise<string>;
   signEvent(unsigned: UnsignedEvent): Promise<Event>;
@@ -77,49 +77,47 @@ type Nip46SubscribeOptions = {
  * constructed above the signer layer so `signer` never imports `relay` (ADR-0001).
  */
 type Nip46Transport = {
-  subscribe: (relays: string[], filters: Filter[], opts?: Nip46SubscribeOptions) => {
+  subscribe: (relays: ReadonlyArray<string>, filters: ReadonlyArray<Filter>, opts?: Nip46SubscribeOptions) => {
     close: (reason?: string) => void;
   };
-  publish: (relays: string[], event: Event) => Promise<ReadonlyArray<{
-    result?: {
-      ok: boolean;
-      message: string;
-    };
-    error?: string;
+  publish: (relays: ReadonlyArray<string>, event: Event) => Promise<ReadonlyArray<{
+    readonly status: "ok" | "rejected" | "failed";
+    readonly message?: string;
+    readonly error?: Error;
   }>>;
-  close: (urls?: string[]) => void;
+  close: () => void;
 };
 /** Options for {@link Nip46Signer}: transport, timeouts, and relay hints. */
 type Nip46SignerOptions = {
   /** Shared transport. When set, the signer does not close it on {@link Nip46Signer.close}. */
-  pool?: Nip46Transport;
+  pool?: Nip46Transport | undefined;
   /**
    * Factory for a private transport when `pool` is omitted. Typical: `() => new Pool({
    * websocketImplementation, enableReconnect: true })`.
    */
-  createPool?: () => Nip46Transport;
+  createPool?: (() => Nip46Transport) | undefined;
   /**
    * Relays used when the bunker pointer has none, and merged uniquely onto a nonempty pointer
    * (pointer first).
    */
-  relays?: string[];
+  relays?: ReadonlyArray<string> | undefined;
   /** Bunker connection secret when the pointer or bunker:// URL has none. */
   secret?: string | undefined;
   /** Local client key used to encrypt RPC (not the remote user key). */
-  clientSecretKey?: SecretKey | Uint8Array | string;
+  clientSecretKey?: SecretKeyInput | undefined;
   /** Called when bunker returns `auth_url` for a pending request. */
-  onAuthUrl?: (url: string) => void;
+  onAuthUrl?: ((url: string) => void) | undefined;
   /** Per-request timeout in ms. Default 30s. */
-  timeoutMs?: number;
+  timeoutMs?: number | undefined;
   /**
    * Timeout in ms applied after the bunker replies `auth_url`: the request keeps waiting for the
    * real response until this elapses. Default 300s.
    */
-  authTimeoutMs?: number;
+  authTimeoutMs?: number | undefined;
   /** Requested permissions sent with `connect` (`method[:kind]` list). */
-  perms?: string[];
+  perms?: ReadonlyArray<string> | undefined;
   /** Client metadata sent with bunker-initiated `connect`. */
-  metadata?: ClientMetadata;
+  metadata?: ClientMetadata | undefined;
 };
 /**
  * NIP-46 remote signer (bunker / nostrconnect). Implements {@link NostrSigner}; never holds the
@@ -136,7 +134,7 @@ declare class Nip46Signer implements NostrSigner {
    * identity.
    */
   static fromBunker(pointer: BunkerPointer, opts: Nip46SignerOptions & {
-    clientSecretKey: SecretKey | Uint8Array | string;
+    clientSecretKey: SecretKeyInput;
   }): Nip46Signer;
   /**
    * Connect using a `bunker://` URL or pre-parsed pointer. Invalid strings throw. A NIP-05
@@ -150,13 +148,13 @@ declare class Nip46Signer implements NostrSigner {
    * {@link createNostrConnectURI} after generating keys).
    */
   static fromNostrConnectURI(connectionURI: string, opts: Nip46SignerOptions & {
-    clientSecretKey: SecretKey | Uint8Array | string;
+    clientSecretKey: SecretKeyInput;
     signal?: AbortSignal;
     handshakeTimeoutMs?: number;
   }): Promise<Nip46Signer>;
   connectRemote(overrides?: {
-    metadata?: ClientMetadata;
-    perms?: string[];
+    metadata?: ClientMetadata | undefined;
+    perms?: ReadonlyArray<string> | undefined;
   }): Promise<void>;
   /**
    * Ask the bunker for its preferred relay list and resubscribe when it changes. Spec result is a
@@ -176,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-MxC28S4P.d.mts.map
+//# sourceMappingURL=index-C_w2WfVz.d.mts.map