@qntx/nostr 0.1.0 → 0.2.0

package/dist/{index-BYMnhRIC.d.mts → index-Ba7bJ7DD.d.mts}

@@ -1,8 +1,19 @@
-import { n as EventTemplate, r as UnsignedEvent, t as Event } from "./event-B5D2jxt_.mjs";
-import { r as SecretKey, t as Keys } from "./key-BiGxGLhg.mjs";
-import { t as Filter } from "./filter-DUEKP3q1.mjs";
-import { t as NostrSigner } from "./types-BzyADqnw.mjs";
-import { n as BunkerPointer, r as ClientMetadata } from "./nip46-C_DoxiS_.mjs";
+import { n as EventTemplate, r as UnsignedEvent, t as Event } from "./event-fU3Y01PR.mjs";
+import { r as SecretKey, t as Keys } from "./key-BlsYhN1V.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";
+//#region src/signer/error.d.ts
+/**
+ * Thrown by a lazy NIP-42 AUTH sign function when no signer is configured at challenge time.
+ * {@link import("../relay/relay.ts").Relay} catches it and ignores the challenge: no AUTH frame is
+ * sent and the connection stays open.
+ */
+declare class NoSignerError extends NostrError {
+  name: string;
+}
+//#endregion
 //#region src/signer/keys.d.ts
 /** Local secret-key signer with NIP-04 (legacy) and NIP-44 support. */
 declare class KeysSigner implements NostrSigner {
@@ -20,18 +31,19 @@ declare class KeysSigner implements NostrSigner {
 //#region src/signer/nip07.d.ts
 /**
  * Minimal NIP-07 provider surface (browser extension `window.nostr`).
+ *
  * @see https://github.com/nostr-protocol/nips/blob/master/07.md
  */
 type WindowNostr = {
-  getPublicKey(): Promise<string>;
-  signEvent(event: EventTemplate): Promise<Event>;
+  getPublicKey: () => Promise<string>;
+  signEvent: (event: EventTemplate) => Promise<Event>;
   nip04?: {
-    encrypt(pubkey: string, plaintext: string): Promise<string>;
-    decrypt(pubkey: string, ciphertext: string): Promise<string>;
+    encrypt: (pubkey: string, plaintext: string) => Promise<string>;
+    decrypt: (pubkey: string, ciphertext: string) => Promise<string>;
   };
   nip44?: {
-    encrypt(pubkey: string, plaintext: string): Promise<string>;
-    decrypt(pubkey: string, ciphertext: string): Promise<string>;
+    encrypt: (pubkey: string, plaintext: string) => Promise<string>;
+    decrypt: (pubkey: string, ciphertext: string) => Promise<string>;
   };
 };
 /** Resolve `window.nostr` / `globalThis.nostr` when present. */
@@ -39,8 +51,8 @@ declare function getWindowNostr(): WindowNostr | undefined;
 /** True when a NIP-07 provider is injected in the current environment. */
 declare function isNip07Available(): boolean;
 /**
- * Signer backed by a NIP-07 browser extension (or any injected provider).
- * Never holds secret keys in-process.
+ * Signer backed by a NIP-07 browser extension (or any injected provider). Never holds secret keys
+ * in-process.
  */
 declare class Nip07Signer implements NostrSigner {
   #private;
@@ -56,56 +68,62 @@ declare class Nip07Signer implements NostrSigner {
 //#region src/signer/nip46.d.ts
 /** Subscribe options used by NIP-46 transport (structural subset of Pool). */
 type Nip46SubscribeOptions = {
-  signal?: AbortSignal;
-  onevent?: (event: Event) => void;
-  onclose?: (reason: string) => void;
+  signal?: AbortSignal | undefined;
+  onevent?: ((event: Event) => void) | undefined;
+  onclose?: ((reason: string) => void) | undefined;
 };
 /**
- * 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).
+ * 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).
  */
 type Nip46Transport = {
-  subscribe(relays: string[], filters: Filter[], opts?: Nip46SubscribeOptions): {
+  subscribe: (relays: string[], filters: Filter[], opts?: Nip46SubscribeOptions) => {
     close: (reason?: string) => void;
   };
-  publish(relays: string[], event: Event): Promise<unknown>;
-  close(urls?: string[]): void;
+  publish: (relays: string[], event: Event) => Promise<ReadonlyArray<{
+    result?: {
+      ok: boolean;
+      message: string;
+    };
+    error?: string;
+  }>>;
+  close: (urls?: string[]) => 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}.
-   */
+  /** Shared transport. When set, the signer does not close it on {@link Nip46Signer.close}. */
   pool?: Nip46Transport;
   /**
-   * Factory for a private transport when `pool` is omitted.
-   * Typical: `() => new Pool({ websocketImplementation, enableReconnect: true })`.
+   * Factory for a private transport when `pool` is omitted. Typical: `() => new Pool({
+   * websocketImplementation, enableReconnect: true })`.
    */
   createPool?: () => Nip46Transport;
   /**
-   * Relays used when the bunker pointer has none, and merged uniquely onto a
-   * nonempty pointer (pointer first).
+   * Relays used when the bunker pointer has none, and merged uniquely onto a nonempty pointer
+   * (pointer first).
    */
   relays?: string[];
-  /**
-   * Bunker connection secret when the pointer or bunker:// URL has none.
-   */
-  secret?: string | null;
+  /** 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;
   /** Called when bunker returns `auth_url` for a pending request. */
   onAuthUrl?: (url: string) => void;
   /** Per-request timeout in ms. Default 30s. */
   timeoutMs?: number;
+  /**
+   * 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;
   /** Requested permissions sent with `connect` (`method[:kind]` list). */
   perms?: string[];
   /** Client metadata sent with bunker-initiated `connect`. */
   metadata?: ClientMetadata;
 };
 /**
- * NIP-46 remote signer (bunker / nostrconnect).
- * Implements {@link NostrSigner}; never holds the remote user's secret key.
- * Network I/O is injected via {@link Nip46Transport} (no relay import).
+ * NIP-46 remote signer (bunker / nostrconnect). Implements {@link NostrSigner}; never holds the
+ * remote user's secret key. Network I/O is injected via {@link Nip46Transport} (no relay import).
  */
 declare class Nip46Signer implements NostrSigner {
   #private;
@@ -113,23 +131,23 @@ declare class Nip46Signer implements NostrSigner {
   get bunker(): Readonly<BunkerPointer>;
   get clientPublicKey(): string;
   /**
-   * Subscribe to an already-known bunker pointer. Does not send the `connect` RPC
-   * (reconnect without a new handshake).
-   * Requires `clientSecretKey` — reconnect must reuse the original client identity.
+   * Subscribe to an already-known bunker pointer. Does not send the `connect` RPC (reconnect
+   * without a new handshake). Requires `clientSecretKey` — reconnect must reuse the original client
+   * identity.
    */
   static fromBunker(pointer: BunkerPointer, opts: Nip46SignerOptions & {
     clientSecretKey: SecretKey | Uint8Array | string;
   }): Nip46Signer;
   /**
-   * Connect using a `bunker://` URL or pre-parsed pointer.
-   * Invalid strings throw. A NIP-05 identifier is not a bunker pointer.
-   * When both pointer and `opts.relays` are nonempty, unique `opts.relays` are appended.
+   * Connect using a `bunker://` URL or pre-parsed pointer. Invalid strings throw. A NIP-05
+   * identifier is not a bunker pointer. When both pointer and `opts.relays` are nonempty, unique
+   * `opts.relays` are appended.
    */
   static connect(input: string | BunkerPointer, opts?: Nip46SignerOptions): Promise<Nip46Signer>;
   /**
-   * Wait for a bunker to complete a client-initiated `nostrconnect://` handshake.
-   * Requires `clientSecretKey` whose pubkey matches the URI client pubkey
-   * (build the URI with {@link createNostrConnectURI} after generating keys).
+   * Wait for a bunker to complete a client-initiated `nostrconnect://` handshake. Requires
+   * `clientSecretKey` whose pubkey matches the URI client pubkey (build the URI with
+   * {@link createNostrConnectURI} after generating keys).
    */
   static fromNostrConnectURI(connectionURI: string, opts: Nip46SignerOptions & {
     clientSecretKey: SecretKey | Uint8Array | string;
@@ -141,10 +159,10 @@ declare class Nip46Signer implements NostrSigner {
     perms?: string[];
   }): Promise<void>;
   /**
-   * Ask the bunker for its preferred relay list and resubscribe when it changes.
-   * Spec result is a JSON array of URLs, or `null` when nothing changes.
+   * Ask the bunker for its preferred relay list and resubscribe when it changes. Spec result is a
+   * JSON array of URLs, or `null` when nothing changes.
    */
-  switchRelays(): Promise<string[] | null>;
+  switchRelays(): Promise<string[] | undefined>;
   /** Courtesy session teardown. Always closes the local signer afterwards. */
   logout(): Promise<void>;
   ping(): Promise<void>;
@@ -157,5 +175,5 @@ declare class Nip46Signer implements NostrSigner {
   close(): Promise<void>;
 }
 //#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 };
-//# sourceMappingURL=index-BYMnhRIC.d.mts.map
+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-Ba7bJ7DD.d.mts.map

package/dist/{index-DaRyjo7O.d.mts → index-Boe8FshM.d.mts}

@@ -11,20 +11,22 @@ declare const SECRET_KEY_BYTES = 32;
 declare const SUBSCRIPTION_ID_MAX_CHARS = 64;
 //#endregion
 //#region src/core/util.d.ts
-declare const utf8Encoder: import("node:util").TextEncoder;
-declare const utf8Decoder: import("node:util").TextDecoder;
 /** Lowercase hex encode. */
 declare function bytesToHex(bytes: Uint8Array): string;
 /** Decode lowercase or mixed-case hex to bytes. */
 declare function hexToBytes(hex: string): Uint8Array;
-/** True when value is a 64-char hex string (any case) — 32 bytes. */
+/** True when value is canonical NIP-01 lowercase hex of 32 bytes (64 chars). */
 declare function isHex32(value: string): boolean;
-/** True when value is a 128-char hex string (any case) — 64 bytes. */
+/** True when value is canonical NIP-01 lowercase hex of 64 bytes (128 chars). */
 declare function isHex64(value: string): boolean;
+/** Caller input of any case: lowercases first, then requires canonical hex shape. */
 declare function assertHex32(value: string, label: string): string;
 declare function assertSecretKeyBytes(bytes: Uint8Array): void;
 /**
- * Normalize a relay URL to a stable form (wss preferred, no trailing slash, sorted query).
+ * Normalize a relay URL to a stable form: `http:`/`https:` are rewritten to `ws:`/`wss:` (a bare
+ * host gets `wss://`), any other scheme throws UrlError. The result has a lowercased host, the
+ * default port removed, duplicate path slashes collapsed, a sorted query, and no fragment. `URL`
+ * serialization keeps a trailing `/` on the root path (`wss://a.example/`).
  */
 declare function normalizeURL(url: string): string;
 //#endregion
@@ -37,7 +39,9 @@ declare function isReplaceableKind(kind: number): boolean;
 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). */
 declare function classifyKind(kind: number): KindClassification;
 /** Kind numbers used by this package. */
 declare const Kind: {
@@ -70,8 +74,10 @@ declare const Kind: {
   readonly EmojiSet: 30030;
   readonly StarterPack: 39089;
 };
+/** Name of a kind constant on {@link Kind}. */
 type KindName = keyof typeof Kind;
+/** Union of the numeric kind values on {@link Kind}. */
 type KnownKind = (typeof Kind)[KindName];
 //#endregion
-export { SUBSCRIPTION_ID_MAX_CHARS as C, SIGNATURE_BYTES as S, utf8Decoder as _, classifyKind as a, PUBLIC_KEY_BYTES as b, isRegularKind as c, assertSecretKeyBytes as d, bytesToHex as f, normalizeURL 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, utf8Encoder as v, SECRET_KEY_BYTES as x, EVENT_ID_BYTES as y };
-//# sourceMappingURL=index-DaRyjo7O.d.mts.map
+export { EVENT_ID_BYTES as _, classifyKind as a, SIGNATURE_BYTES as b, isRegularKind as c, assertSecretKeyBytes as d, bytesToHex as f, normalizeURL 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, PUBLIC_KEY_BYTES as v, SUBSCRIPTION_ID_MAX_CHARS as x, SECRET_KEY_BYTES as y };
+//# sourceMappingURL=index-Boe8FshM.d.mts.map

package/dist/index-CUIvFQdE.d.mts

@@ -0,0 +1,73 @@
+import { t as Event } from "./event-fU3Y01PR.mjs";
+import { t as Filter } from "./filter-C0IMByE3.mjs";
+import { a as NostrError } from "./error-CR8Urc84.mjs";
+import { t as Pool } from "./pool-tEr7c5bG.mjs";
+//#region src/relay/error.d.ts
+/** Base class for relay errors; carries the relay URL when known. */
+declare class RelayError extends NostrError {
+  name: string;
+  readonly url: string | undefined;
+  constructor(message: string, url?: string, options?: ErrorOptions);
+}
+/** A relay connection attempt or socket failed. */
+declare class RelayConnectionError extends RelayError {
+  name: string;
+}
+/** A relay answered an EVENT with `ok: false`. */
+declare class RelayPublishError extends RelayError {
+  name: string;
+}
+/** A subscription was closed by the relay (`CLOSED`) or the socket dropped. */
+declare class RelayClosedError extends RelayError {
+  name: string;
+}
+/** A relay operation exceeded its deadline. */
+declare class RelayTimeoutError extends RelayError {
+  name: string;
+}
+//#endregion
+//#region src/relay/url.d.ts
+/**
+ * True for `ws:` / `http:` URLs that are not `.onion`. Local-network `ws://` is still insecure;
+ * allow those via a trusted set.
+ */
+declare function isInsecureRelayUrl(url: string): boolean;
+//#endregion
+//#region src/relay/fan-in.d.ts
+type RoutedJob = {
+  urls: ReadonlyArray<string>;
+  filters: ReadonlyArray<Filter>;
+  id?: string | undefined;
+};
+type FanInOptions = {
+  /** First receipt only (deduped across jobs). `relayUrl` is the normalized relay URL. */
+  onevent?: ((event: Event, relayUrl: string) => void) | undefined;
+  oneose?: (() => void) | undefined;
+  onclose?: ((reason: string) => void) | undefined;
+  signal?: AbortSignal | undefined;
+  /** Armed at fan-in only. Never forwarded to relay.subscribe. */
+  eoseTimeoutMs?: number | undefined;
+  alreadyHaveEvent?: ((id: string) => boolean) | undefined;
+  /** Every receipt from every relay, including skipped duplicates. */
+  receivedEvent?: ((id: string, relayUrl: string) => void) | undefined;
+  closeOnEose?: boolean | undefined;
+  /** Optional. ensureRelay uses Pool.#opts.connectTimeoutMs when omitted. */
+  connectTimeoutMs?: number | undefined;
+};
+/**
+ * Aggregate EOSE/close across routed jobs. One `seen` set. `pending` counts URL list entries
+ * (duplicates included). `pendingEose` counts unique `jobIndex:url` keys.
+ */
+declare function fanIn(pool: Pool, jobs: ReadonlyArray<RoutedJob>, opts?: FanInOptions): {
+  close: (reason?: string) => void;
+};
+declare function fetchRouted(pool: Pool, jobs: ReadonlyArray<RoutedJob>, opts?: {
+  timeoutMs?: number | undefined;
+  signal?: AbortSignal | undefined;
+  connectTimeoutMs?: number | undefined;
+  /** Every event of every relay batch, including cross-relay duplicates. */
+  onevent?: ((event: Event, relayUrl: string) => void) | undefined;
+}): Promise<Event[]>;
+//#endregion
+export { isInsecureRelayUrl as a, RelayError as c, fetchRouted as i, RelayPublishError as l, RoutedJob as n, RelayClosedError as o, fanIn as r, RelayConnectionError as s, FanInOptions as t, RelayTimeoutError as u };
+//# sourceMappingURL=index-CUIvFQdE.d.mts.map

package/dist/index-JdaS_uce.d.mts

@@ -0,0 +1,207 @@
+import { t as Event } from "./event-fU3Y01PR.mjs";
+import { n as ProfileMetadata } from "./builder-BWn55Paf.mjs";
+import { t as RelayListItem } from "./nip65-DBfh2smt.mjs";
+import { t as Gossip } from "./gossip-BRQwIM_q.mjs";
+import { a as NostrError } from "./error-CR8Urc84.mjs";
+import { t as Pool } from "./pool-tEr7c5bG.mjs";
+import { r as OutboxBound, t as EventStore } from "./types-2pCUprRU.mjs";
+import { t as ReactiveEventStore } from "./reactive-DFpqtIf_.mjs";
+import { i as EventPointer, t as AddressPointer } from "./nip19-BevCJZsp.mjs";
+//#region src/loaders/event.d.ts
+type EventRef = string | EventPointer | AddressPointer;
+/**
+ * Resolve an event reference (hex id, note, nevent, naddr, or pointer object) through the reactive
+ * index, fetching from relays on a miss. The index is the durable store — the loader keeps only
+ * in-flight coalescing, so a miss never blocks a later retry.
+ */
+type EventLoader = {
+  load: (ref: EventRef) => Promise<Event | undefined>;
+};
+//#endregion
+//#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;
+};
+/** `default`: fetch when stale or unfetched; `force`: always fetch; `cache-only`: index only. */
+type LoadStyle = "default" | "force" | "cache-only";
+/** Loads the winning replaceable/addressable event of one kind for a pubkey. */
+type ReplaceableLoader = (pubkey: string, opts?: {
+  hints?: string[] | undefined;
+  style?: LoadStyle | undefined;
+}) => Promise<ReplaceableLoadResult>;
+//#endregion
+//#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;
+};
+type ListLoaderOpts = {
+  hints?: string[] | undefined;
+  style?: LoadStyle | undefined;
+};
+type ListLoaders = {
+  follows: (pubkey: string, opts?: ListLoaderOpts) => Promise<ListResult<string>>;
+  muteList: (pubkey: string, opts?: ListLoaderOpts) => Promise<ListResult<MutedEntity>>;
+  relayList: (pubkey: string, opts?: ListLoaderOpts) => Promise<ListResult<RelayListItem>>;
+  dmRelayList: (pubkey: string, opts?: ListLoaderOpts) => Promise<ListResult<string>>;
+};
+//#endregion
+//#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;
+};
+/** A {@link NostrUser} with no metadata — used when no kind:0 event exists. */
+declare function bareNostrUser(pubkey: string): NostrUser;
+type ProfileLoader = {
+  load: (pubkey: string, opts?: {
+    hints?: string[] | undefined;
+    style?: LoadStyle | undefined;
+  }) => Promise<NostrUser>;
+};
+//#endregion
+//#region src/loaders/outbox.d.ts
+/** Outbox feed lifecycle error (e.g. use after close). */
+declare class OutboxError extends NostrError {
+  name: string;
+}
+/** Options for {@link createOutboxFeed}. */
+type OutboxFeedOptions = {
+  pool: Pool;
+  gossip: Gossip;
+  storage: EventStore;
+  /** Fallback relays when an author has no known outbox routes. */
+  discoveryRelays: ReadonlyArray<string>;
+  authors: ReadonlyArray<string>;
+  /** Event kinds to fetch. Default `[Kind.TextNote]`. */
+  kinds?: ReadonlyArray<number> | undefined;
+  /** Max write-relays to use per author. Default 3. */
+  maxRelaysPerAuthor?: number | undefined;
+  fetchTimeoutMs?: number | undefined;
+  /** Called for live events after observe, and for sync events returned by applySync. */
+  onEvent?: ((event: Event) => void) | undefined;
+  /** Live ingest (e.g. `client.observe`) with the source relay URL. StartLive never putManys. */
+  observe?: ((event: Event, relayUrl: string) => void) | undefined;
+  /**
+   * Every receipt from every relay — live (including duplicates the feed's own dedupe skips) and
+   * sync fetch batches — for seenOn bookkeeping.
+   */
+  seen?: ((event: Event, relayUrl: string) => void) | undefined;
+  /**
+   * Sync path only. Awaited. Return events that should advance bounds. Throw → sync throws, bounds
+   * unchanged.
+   */
+  applySync?: ((events: ReadonlyArray<Event>) => Promise<ReadonlyArray<Event>>) | undefined;
+  /** Load kind:10002 for authors before sync when routes are missing. Requires a relay-list loader. */
+  hydrate?: ((pubkeys: ReadonlyArray<string>) => Promise<void>) | undefined;
+};
+/**
+ * Group authors by outbox relay (discovery fallback). `prefer` reorders existing candidates only;
+ * it never appends a URL that is not already in the author's outbox or discovery list. Returns
+ * Map<relayUrl, authors[]>.
+ */
+declare function groupAuthorsByOutboxRelay(authors: ReadonlyArray<string>, gossip: Gossip, discoveryRelays: ReadonlyArray<string>, maxRelaysPerAuthor?: number, prefer?: ReadonlyArray<string>): Map<string, string[]>;
+/**
+ * Outbox-model feed: history sync + live subscription for a set of authors, routed via NIP-65 write
+ * relays (with discovery fallback).
+ */
+declare class OutboxFeed {
+  #private;
+  constructor(opts: OutboxFeedOptions);
+  get authors(): ReadonlyArray<string>;
+  get kinds(): ReadonlyArray<number>;
+  /** Replace the author set (does not auto-restart live). */
+  setAuthors(authors: ReadonlyArray<string>): void;
+  getBound(pubkey: string, kind: number): OutboxBound | undefined;
+  /** Load NIP-65 relay lists for authors that have no outbox routes yet. */
+  hydrate(): Promise<void>;
+  /** One-shot history pull. Persistence is `applySync`; bounds move only for events it returns. */
+  sync(opts?: {
+    limit?: number | undefined;
+    since?: number | undefined;
+    until?: number | undefined;
+    signal?: AbortSignal | undefined;
+    /** Skip hydrate() even if provided. */
+    skipHydrate?: boolean | undefined;
+  }): Promise<Event[]>;
+  /**
+   * Start a live subscription across outbox relays for the current authors. Closes any previous
+   * live subscription.
+   */
+  startLive(opts?: {
+    signal?: AbortSignal | undefined;
+    since?: number | undefined;
+  }): {
+    close: (reason?: string) => void;
+  };
+  /** Convenience: hydrate + sync + startLive. */
+  start(opts?: {
+    limit?: number | undefined;
+    signal?: AbortSignal | undefined;
+  }): Promise<{
+    close: (reason?: string) => void;
+    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}. */
+type Loaders = {
+  follows: ListLoaders["follows"];
+  muteList: ListLoaders["muteList"];
+  relayList: ListLoaders["relayList"];
+  dmRelayList: ListLoaders["dmRelayList"];
+  profile: ProfileLoader["load"];
+  event: EventLoader["load"];
+  /** Generic replaceable loader for any kind; memoized per kind. */
+  replaceable: (kind: number) => ReplaceableLoader;
+  addRelay: (url: string) => void;
+  removeRelay: (url: string) => void;
+};
+/** Options for {@link createLoaders}. */
+type CreateLoadersOptions = {
+  pool: Pool;
+  relays: ReadonlyArray<string>;
+  /** The reactive index loaders read from and feed fetched events into. */
+  index: ReactiveEventStore;
+  /**
+   * 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;
+};
+/** 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-JdaS_uce.d.mts.map

package/dist/index.d.mts

@@ -1,22 +1,24 @@
-import { C as isTag, E as tagValue, S as getDTag, T as tagName, _ as EventAddress, b as eventAddress, c as itemCompare, d as serializeEvent, f as signedMatchesUnsigned, g as validateSignedEvent, h as validateEvent, i as getEventHash, m as sortedEvents, n as EventTemplate, o as isMarkedVerified, p as sortEvents, r as UnsignedEvent, s as isReplaceableWinner, t as Event, v as Tag, w as parseEventAddress, x as formatEventAddress, y as TagInput } from "./event-B5D2jxt_.mjs";
-import { a as getPublicKey, c as verifyEvent, i as finalizeEvent, n as PublicKey, o as publicKeyFromHex, r as SecretKey, s as signEvent, t as Keys } from "./key-BiGxGLhg.mjs";
-import { n as ProfileMetadata, t as EventBuilder } from "./builder-BphJa-Y-.mjs";
-import { a as filterFingerprint, c as matchFilters, i as cloneFilter, l as mergeFilters, n as canonicalizeFilter, o as getFilterLimit, r as canonicalizeFilters, s as matchFilter, t as Filter } from "./filter-DUEKP3q1.mjs";
-import { a as readRelays, c as writeRelays, i as parseRelayList, n as RelayMarker, o as relayListEventBuilder, r as markerOf, s as relayListToTags, t as RelayListItem } from "./nip65-Di5hZRuV.mjs";
-import { i as RoutedFilter, r as PubkeyRoutes, t as Gossip } from "./gossip-C5RVB1UB.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-DJC-Jz6T.mjs";
-import { a as NostrError, i as MessageError, n as EventValidationError, o as UrlError, r as HexError, s as WasmVerifyPoisonedError, t as CryptoError } from "./error-WEFS-R-4.mjs";
-import { a as PublishResult, c as RelayStatus, i as PoolPublishResult, l as RelayStatusName, m as SubscribeOptions, n as PoolCountResult, o as Relay, p as useWebSocketImplementation, r as PoolOptions, s as RelayOptions, t as Pool } from "./pool-DhRi7l-b.mjs";
-import { C as DataLoader, D as ReplaceableCache, T as LoaderContext, _ as ListResult, a as OutboxFeed, b as LoadStyle, c as groupAuthorsByOutboxRelay, f as NostrUser, i as OutboxError, m as bareNostrUser, n as Loaders, o as OutboxFeedOptions, r as createLoaders, s as createOutboxFeed, v as MutedEntity, w as LoaderError } from "./index-EwL6fHLo.mjs";
-import { _ as neventEncode, a as NAddr, b as npubEncode, c as NPub, d as Note, f as ProfilePointer, g as naddrEncode, i as EventPointer, l as NSec, m as decodeNostrURI, n as Bech32MaxSize, o as NEvent, p as decode, r as DecodedResult, s as NProfile, t as AddressPointer, u as Nip19Error, v as noteEncode, x as nsecEncode, y as nprofileEncode } from "./nip19-D7905oIv.mjs";
-import { i as PutResult, n as NegentropyItem, r as OutboxBound, t as EventStore } from "./types-Dn24TPFs.mjs";
-import { t as NostrSigner } from "./types-BzyADqnw.mjs";
-import { t as StorageError } from "./error-B49rbDzT.mjs";
-import { a as FetchPrivateMessagesOptions, c as ReceivedPrivateMessage, d as SubscribePrivateMessagesOptions, f as SyncDirection, g as ClientBuilder, h as SyncSummary, l as SendPrivateMessageOptions, m as SyncOptions, n as ClientError, o as PrivateMessageSendResult, p as SyncDirectionName, r as ClientOptions, t as Client } from "./index-DgOugrpF.mjs";
-import { C as SUBSCRIPTION_ID_MAX_CHARS, S as SIGNATURE_BYTES, _ as utf8Decoder, a as classifyKind, b as PUBLIC_KEY_BYTES, c as isRegularKind, f as bytesToHex, g as normalizeURL, 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, v as utf8Encoder, x as SECRET_KEY_BYTES, y as EVENT_ID_BYTES } from "./index-DaRyjo7O.mjs";
-import { a as Nip07Signer, c as isNip07Available, i as Nip46Transport, l as KeysSigner, n as Nip46SignerOptions, o as WindowNostr, r as Nip46SubscribeOptions, s as getWindowNostr, t as Nip46Signer } from "./index-BYMnhRIC.mjs";
+import { C as parseEventAddress, S as isTag, T as tagValue, _ as Tag, b as formatEventAddress, d as signedMatchesUnsigned, f as sortEvents, g as EventAddress, h as validateSignedEvent, i as getEventHash, 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 tagName, x as getDTag, y as eventAddress } from "./event-fU3Y01PR.mjs";
+import { a as getPublicKey, c as verifyEvent, i as finalizeEvent, n as PublicKey, o as publicKeyFromHex, r as SecretKey, s as signEvent, t as Keys } from "./key-BlsYhN1V.mjs";
+import { n as ProfileMetadata, t as EventBuilder } from "./builder-BWn55Paf.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-C0IMByE3.mjs";
+import { a as readRelays, c as writeRelays, i as parseRelayList, n as RelayMarker, o as relayListEventBuilder, r as markerOf, s as relayListToTags, t as RelayListItem } from "./nip65-DBfh2smt.mjs";
+import { i as RoutedFilter, r as PubkeyRoutes, t as Gossip } from "./gossip-BRQwIM_q.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-iGPIqnn0.mjs";
+import { a as NostrError, i as MessageError, n as EventValidationError, o as UrlError, r as HexError, s as WasmVerifyPoisonedError, t as CryptoError } from "./error-CR8Urc84.mjs";
+import { a as PoolSubscribeOptions, c as RelayOptions, d as SubscribeOptions, i as PoolPublishResult, l as RelayStatus, n as PoolCountResult, o as PublishResult, r as PoolOptions, s as Relay, t as Pool, u as RelayStatusName } from "./pool-tEr7c5bG.mjs";
+import { i as useWebSocketImplementation } from "./websocket-CmeqvAkp.mjs";
+import { i as PutResult, n as NegentropyItem, r as OutboxBound, t as EventStore } from "./types-2pCUprRU.mjs";
+import { n as ReactiveEventStoreOptions, r as Watch, t as ReactiveEventStore } from "./reactive-DFpqtIf_.mjs";
+import { _ as neventEncode, a as NAddr, b as npubEncode, c as NPub, d as Note, f as ProfilePointer, g as naddrEncode, i as EventPointer, l as NSec, m as decodeNostrURI, n as Bech32MaxSize, o as NEvent, p as decode, r as DecodedResult, s as NProfile, t as AddressPointer, u as Nip19Error, v as noteEncode, x as nsecEncode, y as nprofileEncode } from "./nip19-BevCJZsp.mjs";
+import { _ as ReplaceableLoader, a as OutboxFeed, c as groupAuthorsByOutboxRelay, d as bareNostrUser, g as ReplaceableLoadResult, h as LoadStyle, i as OutboxError, l as NostrUser, m as MutedEntity, n as Loaders, o as OutboxFeedOptions, p as ListResult, r as createLoaders, s as createOutboxFeed } from "./index-JdaS_uce.mjs";
+import { t as NostrSigner } from "./types-CRQEk0Oi.mjs";
+import { t as StorageError } from "./error-BW7re1UN.mjs";
+import { f as SubscribePrivateMessagesOptions, g as SyncSummary, h as SyncOptions, i as ClientOptions, l as ReceivedPrivateMessage, m as SyncDirectionName, n as ClientBuilder, o as FetchPrivateMessagesOptions, p as SyncDirection, r as ClientError, s as PrivateMessageSendResult, t as Client, u as SendPrivateMessageOptions } from "./index-B425CAcQ.mjs";
+import { _ as EVENT_ID_BYTES, a as classifyKind, b as SIGNATURE_BYTES, c as isRegularKind, f as bytesToHex, g as normalizeURL, 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, v as PUBLIC_KEY_BYTES, x as SUBSCRIPTION_ID_MAX_CHARS, y as SECRET_KEY_BYTES } from "./index-Boe8FshM.mjs";
+import { a as Nip07Signer, c as isNip07Available, i as Nip46Transport, l as KeysSigner, n as Nip46SignerOptions, o as WindowNostr, r as Nip46SubscribeOptions, s as getWindowNostr, t as Nip46Signer, u as NoSignerError } from "./index-Ba7bJ7DD.mjs";
 import { ReplyTagsOptions, ThreadReferences, buildReplyTags, parseThreadTags, replyTo } from "./nips/nip10.mjs";
 import { isAuthRequired, makeAuthEvent } from "./nips/nip42.mjs";
-import { a as isInsecureRelayUrl, c as RelayError, l as RelayPublishError, o as RelayClosedError, s as RelayConnectionError } from "./index-C0C4e-Gn.mjs";
-import { n as IndexedDbEventStoreOptions, r as MemoryEventStore, t as IndexedDbEventStore } from "./index-k2YhCgsh.mjs";
-export { type AddressPointer, Bech32MaxSize, Client, ClientBuilder, ClientError, type ClientMessage, type ClientOptions, type CountResult, CryptoError, DataLoader, type DecodedResult, EVENT_ID_BYTES, type Event, type EventAddress, EventBuilder, type EventPointer, type EventStore, type EventTemplate, EventValidationError, type FetchPrivateMessagesOptions, type Filter, Gossip, HexError, IndexedDbEventStore, type IndexedDbEventStoreOptions, Keys, KeysSigner, Kind, type KindClassification, type KindName, type KnownKind, type ListResult, type LoadStyle, LoaderContext, LoaderError, type Loaders, MemoryEventStore, MessageError, type MutedEntity, type NAddr, type NEvent, type NProfile, type NPub, type NSec, type NegentropyItem, Nip07Signer, Nip19Error, Nip46Signer, type Nip46SignerOptions, type Nip46SubscribeOptions, type Nip46Transport, NostrError, type NostrSigner, type NostrUser, type Note, type OutboxBound, OutboxError, OutboxFeed, type OutboxFeedOptions, PUBLIC_KEY_BYTES, Pool, type PoolCountResult, type PoolOptions, type PoolPublishResult, type PrivateMessageSendResult, type ProfileMetadata, type ProfilePointer, type PubkeyRoutes, type PublicKey, type PublishResult, type PutResult, type ReceivedPrivateMessage, Relay, RelayClosedError, RelayConnectionError, RelayError, type RelayListItem, type RelayMarker, type RelayMessage, type RelayOptions, RelayPublishError, RelayStatus, type RelayStatusName, ReplaceableCache, type ReplyTagsOptions, type RoutedFilter, SECRET_KEY_BYTES, SIGNATURE_BYTES, SUBSCRIPTION_ID_MAX_CHARS, SecretKey, type SendPrivateMessageOptions, StorageError, type SubscribeOptions, type SubscribePrivateMessagesOptions, type SubscriptionId, SyncDirection, type SyncDirectionName, type SyncOptions, type SyncSummary, Tag, type TagInput, type ThreadReferences, type UnsignedEvent, UrlError, WasmVerifyPoisonedError, type WindowNostr, assertSubscriptionId, bareNostrUser, buildReplyTags, bytesToHex, canonicalizeFilter, canonicalizeFilters, classifyKind, cloneFilter, createLoaders, createOutboxFeed, createSubscriptionId, decodeNostrURI, encodeClientMessage, encodeRelayMessage, eventAddress, filterFingerprint, finalizeEvent, formatEventAddress, getDTag, getEventHash, getFilterLimit, getPublicKey, getWindowNostr, groupAuthorsByOutboxRelay, hexToBytes, isAddressableKind, isAuthRequired, isEphemeralKind, isHex32, isHex64, isInsecureRelayUrl, isMarkedVerified, isNip07Available, isRegularKind, isReplaceableKind, isReplaceableWinner, isTag, itemCompare, makeAuthEvent, markerOf, matchFilter, matchFilters, mergeCountHll, mergeFilters, naddrEncode, neventEncode, decode as nip19Decode, normalizeURL, noteEncode, nprofileEncode, npubEncode, nsecEncode, parseClientMessage, parseEventAddress, parseRelayList, parseRelayMessage, parseThreadTags, publicKeyFromHex, readRelays, relayListEventBuilder, relayListToTags, replyTo, serializeEvent, signEvent, signedMatchesUnsigned, sortEvents, sortedEvents, tagName, tagValue, useWebSocketImplementation, utf8Decoder, utf8Encoder, validateEvent, validateSignedEvent, verifyEvent, writeRelays };
+import { a as isInsecureRelayUrl, c as RelayError, l as RelayPublishError, o as RelayClosedError, s as RelayConnectionError, u as RelayTimeoutError } from "./index-CUIvFQdE.mjs";
+import { a as IndexedDbEventStoreOptions, i as IndexedDbEventStore, n as SqlValue, o as MemoryEventStore, r as SqliteEventStore, t as SqlDriver } from "./index-BVyfUBuG.mjs";
+export { type AddressPointer, Bech32MaxSize, Client, ClientBuilder, ClientError, type ClientMessage, type ClientOptions, type CountResult, CryptoError, type DecodedResult, EVENT_ID_BYTES, type Event, type EventAddress, EventBuilder, type EventPointer, type EventStore, type EventTemplate, EventValidationError, type FetchPrivateMessagesOptions, type Filter, Gossip, HexError, IndexedDbEventStore, type IndexedDbEventStoreOptions, Keys, KeysSigner, Kind, type KindClassification, type KindName, type KnownKind, type ListResult, type LoadStyle, type Loaders, MemoryEventStore, MessageError, type MutedEntity, type NAddr, type NEvent, type NProfile, type NPub, type NSec, type NegentropyItem, Nip07Signer, Nip19Error, Nip46Signer, type Nip46SignerOptions, type Nip46SubscribeOptions, type Nip46Transport, NoSignerError, NostrError, type NostrSigner, type NostrUser, type Note, type OutboxBound, OutboxError, OutboxFeed, type OutboxFeedOptions, PUBLIC_KEY_BYTES, Pool, type PoolCountResult, type PoolOptions, type PoolPublishResult, type PoolSubscribeOptions, type PrivateMessageSendResult, type ProfileMetadata, type ProfilePointer, type PubkeyRoutes, type PublicKey, type PublishResult, type PutResult, ReactiveEventStore, type ReactiveEventStoreOptions, type ReceivedPrivateMessage, Relay, RelayClosedError, RelayConnectionError, RelayError, type RelayListItem, type RelayMarker, type RelayMessage, type RelayOptions, RelayPublishError, RelayStatus, type RelayStatusName, RelayTimeoutError, type ReplaceableLoadResult, type ReplaceableLoader, type ReplyTagsOptions, type RoutedFilter, SECRET_KEY_BYTES, SIGNATURE_BYTES, SUBSCRIPTION_ID_MAX_CHARS, SecretKey, type SendPrivateMessageOptions, type SqlDriver, type SqlValue, SqliteEventStore, StorageError, type SubscribeOptions, type SubscribePrivateMessagesOptions, type SubscriptionId, SyncDirection, type SyncDirectionName, type SyncOptions, type SyncSummary, Tag, type TagInput, type ThreadReferences, type UnsignedEvent, UrlError, WasmVerifyPoisonedError, type Watch, type WindowNostr, assertSubscriptionId, bareNostrUser, buildReplyTags, bytesToHex, canonicalizeFilter, canonicalizeFilters, classifyKind, createLoaders, createOutboxFeed, createSubscriptionId, decodeNostrURI, encodeClientMessage, encodeRelayMessage, eventAddress, filterFingerprint, finalizeEvent, formatEventAddress, getDTag, getEventHash, getFilterLimit, getPublicKey, getWindowNostr, groupAuthorsByOutboxRelay, hexToBytes, isAddressableKind, isAuthRequired, isEphemeralKind, isHex32, isHex64, isInsecureRelayUrl, isNip07Available, isRegularKind, isReplaceableKind, isReplaceableWinner, isTag, itemCompare, makeAuthEvent, markerOf, matchFilter, matchFilters, mergeCountHll, mergeFilters, naddrEncode, neventEncode, decode as nip19Decode, normalizeURL, noteEncode, nprofileEncode, npubEncode, nsecEncode, parseClientMessage, parseEventAddress, parseRelayList, parseRelayMessage, parseThreadTags, publicKeyFromHex, readRelays, relayListEventBuilder, relayListToTags, replyTo, serializeEvent, signEvent, signedMatchesUnsigned, sortEvents, sortedEvents, tagName, tagValue, useWebSocketImplementation, validateEvent, validateSignedEvent, verifyEvent, writeRelays };