@qntx/nostr 0.1.0 → 0.2.1

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-D-TK_KJG.d.mts

@@ -0,0 +1,84 @@
+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 { n as Pool } from "./pool-B7p_reAm.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;
+}
+/**
+ * A relay was suspended for delivering more events that fail id/signature verification than its
+ * {@link PoolOptions.invalidEventPolicy} allows. Carries `until`, the epoch-ms time when the relay
+ * may connect again.
+ */
+declare class RelaySuspendedError extends RelayError {
+  name: string;
+  /** Epoch milliseconds when the suspension lifts. */
+  readonly until: number;
+  constructor(url: string, until: number);
+}
+//#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, 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-D-TK_KJG.d.mts.map

package/dist/index-D1bqFHKB.d.mts

@@ -0,0 +1,188 @@
+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";
+//#region src/storage/memory-index.d.ts
+type MemoryIndexOptions = {
+  /**
+   * FIFO cap applied independently to each deletion-state collection: tombstoned event ids, pending
+   * 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;
+  /**
+   * 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
+   * body is evicted, and a re-put of the watermarked id re-inserts it. Default 0 (no watermark
+   * 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;
+  /** Fires after every physical index insert (accept, replace, deletion event). */
+  onInsert?: (event: Event) => void;
+  /** Fires after every physical index remove (replace, delete, evict, remove, clear). */
+  onRemove?: (event: Event) => void;
+};
+/**
+ * Synchronous in-memory event index with NIP-01 replaceable / addressable / ephemeral handling and
+ * NIP-09 deletion (kind 5) application. Shared by {@link MemoryEventStore} (async facade) and
+ * `ReactiveEventStore`.
+ */
+declare class MemoryIndex {
+  #private;
+  constructor(opts?: MemoryIndexOptions);
+  put(raw: Event): PutResult;
+  /** Sequential `put` in input order. */
+  putMany(events: ReadonlyArray<Event>): PutResult[];
+  get(id: string): Event | undefined;
+  /** Current event at a `kind:pubkey:d` coordinate (replaceable or addressable). */
+  getByAddress(address: string): Event | undefined;
+  query(filters: ReadonlyArray<Filter>): Event[];
+  count(filters: ReadonlyArray<Filter>): number;
+  negentropyItems(filter: Filter): NegentropyItem[];
+  /** Remove by id and tombstone (like a local NIP-09). Returns removed count. */
+  remove(ids: ReadonlyArray<string>): number;
+  /**
+   * Remove by id without writing a tombstone (LRU eviction). When the evicted event is the current
+   * winner of a replaceable/addressable address, a `{ id, created_at }` watermark is recorded so
+   * stale versions stay rejected while the body is gone; the watermarks are FIFO-bounded by
+   * `maxWatermarks`.
+   */
+  evict(ids: ReadonlyArray<string>): number;
+  /**
+   * True when the id is tombstoned, or the coordinate has a deletion marker that still covers the
+   * current event at that address: a replacement published after the marker's `until` clears the
+   * deletion. Coordinates are matched on the canonical lowercase pubkey.
+   */
+  isDeleted(idOrAddress: string): boolean;
+  getOutboxBound(pubkey: string, kind: number): OutboxBound | undefined;
+  setOutboxBound(pubkey: string, kind: number, bound: OutboxBound): void;
+  clear(): void;
+  get size(): number;
+}
+//#endregion
+//#region src/storage/memory.d.ts
+/** In-memory event store: async {@link EventStore} facade over the synchronous {@link MemoryIndex}. */
+declare class MemoryEventStore implements EventStore {
+  #private;
+  put(raw: Event): Promise<PutResult>;
+  /** 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>;
+  negentropyItems(filter: Filter): Promise<NegentropyItem[]>;
+  remove(ids: string[]): Promise<number>;
+  getOutboxBound(pubkey: string, kind: number): Promise<OutboxBound | undefined>;
+  setOutboxBound(pubkey: string, kind: number, bound: OutboxBound): Promise<void>;
+  clear(): Promise<void>;
+  get size(): number;
+}
+//#endregion
+//#region src/storage/indexeddb.d.ts
+/** Options for {@link IndexedDbEventStore}. */
+type IndexedDbEventStoreOptions = {
+  /** IndexedDB database name. */
+  dbName?: string;
+};
+/**
+ * Browser IndexedDB event store with the same replaceable / deletion semantics as
+ * {@link MemoryEventStore}. Requires a DOM IndexedDB implementation.
+ *
+ * `open` loads every tombstone and address row into memory. Fine at 10^4 events; tens of MB at 10^5
+ * addressables.
+ */
+declare class IndexedDbEventStore implements EventStore {
+  #private;
+  constructor(opts?: IndexedDbEventStoreOptions);
+  static isAvailable(): boolean;
+  open(): Promise<void>;
+  put(event: Event): Promise<PutResult>;
+  /** 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>;
+  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>;
+  clear(): Promise<void>;
+  close(): void;
+}
+//#endregion
+//#region src/storage/sqlite.d.ts
+/** Value bindable to a SQLite statement parameter. */
+type SqlValue = string | number | null | Uint8Array;
+/**
+ * Minimal async SQLite driver surface.
+ *
+ * `transaction` must serialize `fn` exclusively — no interleaved statements from other callers may
+ * run while the callback transaction is active. It commits when `fn` resolves and rolls back when
+ * `fn` rejects.
+ *
+ * The store always issues statements sequentially — a driver never sees a second `exec`/`run`/`all`
+ * start before the previous one settles, inside or outside a transaction — so drivers need not
+ * support overlapping statements on one connection.
+ *
+ * `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
+ * out-of-band:
+ *
+ * ```ts
+ * const toDriver = (db: SQLiteDatabase): SqlDriver => ({
+ *   exec: (sql) => db.execAsync(sql),
+ *   run: async (sql, params = []) => ({
+ *     changes: (await db.runAsync(sql, [...params])).changes,
+ *   }),
+ *   all: (sql, params = []) => db.getAllAsync(sql, [...params]),
+ *   transaction: async (fn) => {
+ *     let result!: Awaited<ReturnType<typeof fn>>;
+ *     await db.withExclusiveTransactionAsync(async (txn) => {
+ *       result = await fn(toDriver(txn));
+ *     });
+ *     return result;
+ *   },
+ * });
+ * ```
+ */
+type SqlDriver = {
+  /** Execute SQL without parameters (DDL, PRAGMA, multi-statement batches). */
+  exec: (sql: string) => Promise<void>;
+  /** Run a statement; resolves with the number of changed rows. */
+  run: (sql: string, params?: ReadonlyArray<SqlValue>) => Promise<{
+    changes: number;
+  }>;
+  /** Run a query; resolves with all result rows. */
+  all: <Row>(sql: string, params?: ReadonlyArray<SqlValue>) => Promise<Row[]>;
+  /** Run `fn` inside an exclusive transaction; commit on resolve, roll back on reject. */
+  transaction: <T>(fn: (tx: SqlDriver) => Promise<T>) => Promise<T>;
+};
+/**
+ * SQLite-backed {@link EventStore} for React Native (`expo-sqlite`, `op-sqlite`) and desktop
+ * runtimes. Same semantics as {@link MemoryEventStore} and {@link IndexedDbEventStore}: identical
+ * `decidePut` insertion policy, NIP-09 tombstones, and filter handling, with the database — not
+ * in-memory caches — as the source of truth.
+ *
+ * Construct via {@link SqliteEventStore.open}; writes are serialized and run inside an exclusive
+ * driver transaction.
+ */
+declare class SqliteEventStore implements EventStore {
+  #private;
+  private constructor();
+  /** Create the schema on first use and return a ready store. */
+  static open(driver: SqlDriver): Promise<SqliteEventStore>;
+  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>;
+  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>;
+  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

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 PoolPublishResult, c as Relay, d as RelayStatusName, f as SubscribeOptions, i as PoolOptions, l as RelayOptions, n as Pool, o as PoolSubscribeOptions, r as PoolCountResult, s as PublishResult, t as InvalidEventPolicy, u as RelayStatus } from "./pool-B7p_reAm.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-B-CGNDPS.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-BIhSADwK.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, d as RelayTimeoutError, l as RelayPublishError, o as RelayClosedError, s as RelayConnectionError, u as RelaySuspendedError } from "./index-D-TK_KJG.mjs";
+import { a as IndexedDbEventStoreOptions, i as IndexedDbEventStore, n as SqlValue, o as MemoryEventStore, r as SqliteEventStore, t as SqlDriver } from "./index-D1bqFHKB.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, type InvalidEventPolicy, 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, RelaySuspendedError, 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 };