@qntx/nostr 0.1.0 → 0.2.0

package/dist/index-C0C4e-Gn.d.mts

@@ -1,55 +0,0 @@
-import { t as Event } from "./event-B5D2jxt_.mjs";
-import { t as Filter } from "./filter-DUEKP3q1.mjs";
-import { a as NostrError } from "./error-WEFS-R-4.mjs";
-import { t as Pool } from "./pool-DhRi7l-b.mjs";
-//#region src/relay/error.d.ts
-declare class RelayError extends NostrError {
-  readonly url?: string;
-  constructor(message: string, url?: string);
-}
-declare class RelayConnectionError extends RelayError {}
-declare class RelayPublishError extends RelayError {}
-declare class RelayClosedError extends RelayError {}
-//#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: readonly string[];
-  filters: readonly Filter[];
-  id?: string;
-};
-type FanInOptions = {
-  onevent?: (event: Event) => void;
-  oneose?: () => void;
-  onclose?: (reason: string) => void;
-  signal?: AbortSignal;
-  /** Armed at fan-in only. Never forwarded to relay.subscribe. */
-  eoseTimeoutMs?: number;
-  alreadyHaveEvent?: (id: string) => boolean;
-  receivedEvent?: (id: string) => void;
-  closeOnEose?: boolean;
-  /** Optional. ensureRelay uses Pool.#opts.connectTimeoutMs when omitted. */
-  connectTimeoutMs?: number;
-};
-/**
- * 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: readonly RoutedJob[], opts?: FanInOptions): {
-  close: (reason?: string) => void;
-};
-declare function fetchRouted(pool: Pool, jobs: readonly RoutedJob[], opts?: {
-  timeoutMs?: number;
-  signal?: AbortSignal;
-  connectTimeoutMs?: number;
-}): 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 };
-//# sourceMappingURL=index-C0C4e-Gn.d.mts.map

package/dist/index-DgOugrpF.d.mts

@@ -1,275 +0,0 @@
-import { n as EventTemplate, r as UnsignedEvent, t as Event } from "./event-B5D2jxt_.mjs";
-import { t as EventBuilder } from "./builder-BphJa-Y-.mjs";
-import { t as Filter } from "./filter-DUEKP3q1.mjs";
-import { t as Gossip } from "./gossip-C5RVB1UB.mjs";
-import { a as NostrError } from "./error-WEFS-R-4.mjs";
-import { i as PoolPublishResult, t as Pool, u as WebSocketConstructor } from "./pool-DhRi7l-b.mjs";
-import { a as OutboxFeed, n as Loaders } from "./index-EwL6fHLo.mjs";
-import { t as EventStore } from "./types-Dn24TPFs.mjs";
-import { a as Rumor } from "./nip59-DljW_sYh.mjs";
-import { i as ReplyTo, r as Recipient } from "./nip17-BWq-Kfq5.mjs";
-import { t as NostrSigner } from "./types-BzyADqnw.mjs";
-import { t as StorageError } from "./error-B49rbDzT.mjs";
-//#region src/client/builder.d.ts
-/** Fluent constructor for {@link Client}. */
-declare class ClientBuilder {
-  #private;
-  signer(signer: NostrSigner): this;
-  relays(urls: readonly string[]): this;
-  addRelay(url: string): this;
-  websocketImplementation(impl: WebSocketConstructor): this;
-  verifyEvent(fn: (event: Event) => boolean): this;
-  connectTimeoutMs(ms: number): this;
-  publishTimeoutMs(ms: number): this;
-  automaticAuth(enabled: boolean): this;
-  enableReconnect(enabled: boolean): this;
-  enablePing(enabled: boolean): this;
-  pingIntervalMs(ms: number): this;
-  pingTimeoutMs(ms: number): this;
-  /**
-   * Local event store. Defaults to {@link MemoryEventStore}.
-   * Browser apps that want persistence must pass {@link IndexedDbEventStore} and `await open()`.
-   */
-  storage(store: EventStore): this;
-  /** When false, Client will not auto-write events to storage. Default true. */
-  persistEvents(enabled: boolean): this;
-  gossip(gossip: Gossip): this;
-  onstorageerror(fn: (err: StorageError) => void): this;
-  build(): Client;
-}
-//#endregion
-//#region src/client/types.d.ts
-declare const SyncDirection: {
-  readonly Up: "up";
-  readonly Down: "down";
-  readonly Both: "both";
-};
-type SyncDirectionName = (typeof SyncDirection)[keyof typeof SyncDirection];
-type SyncOptions = {
-  relays?: readonly string[];
-  direction?: SyncDirectionName;
-  /**
-   * Wall-clock deadline for the Negentropy reconciliation session
-   * (`NEG-OPEN` through `NEG-CLOSE`), in milliseconds.
-   * One clock for the whole session — not reset per `NEG-MSG`.
-   * Default: the relay `publishTimeoutMs`.
-   * Upload/download phases reuse this value as their per-call timeout.
-   */
-  timeoutMs?: number;
-  signal?: AbortSignal;
-  dryRun?: boolean;
-  /** When false, skip observe/storage on downloaded events. Default true. */
-  observe?: boolean;
-};
-type SyncSummary = {
-  local: string[];
-  remote: string[];
-  sent: string[];
-  received: string[];
-  sendFailures: Record<string, string>;
-  persistFailures: Record<string, string>;
-};
-type ClientOptions = {
-  signer?: NostrSigner;
-  relays?: readonly string[];
-  websocketImplementation?: WebSocketConstructor;
-  /** Injected EVENT verifier. Default is core BIP-340. */
-  verifyEvent?: (event: Event) => boolean;
-  connectTimeoutMs?: number;
-  publishTimeoutMs?: number;
-  /** When true (default if signer present), answer NIP-42 AUTH automatically. */
-  automaticAuth?: boolean;
-  /** When true (default), relays reconnect with backoff after disconnect. */
-  enableReconnect?: boolean;
-  /** Keepalive ping. Default false. */
-  enablePing?: boolean;
-  pingIntervalMs?: number;
-  pingTimeoutMs?: number;
-  gossip?: Gossip;
-  /**
-   * Local event store. Defaults to {@link MemoryEventStore}.
-   * Browser apps that want persistence must pass {@link IndexedDbEventStore} and `await open()`.
-   */
-  storage?: EventStore;
-  /**
-   * When true (default), every ingested event is written to storage.
-   * Set false to disable automatic persistence while keeping the store for manual use.
-   */
-  persistEvents?: boolean;
-  /**
-   * Storage I/O failures: live `putMany` flush and `fetchEvents({ localFirst: true })` query.
-   * Those paths do not throw.
-   */
-  onstorageerror?: (err: StorageError) => void;
-};
-type FetchEventsOptions = {
-  relays?: string[];
-  timeoutMs?: number;
-  signal?: AbortSignal;
-  gossip?: boolean;
-  /**
-   * When true, query local storage first and merge with network results.
-   * Defaults to false.
-   */
-  localFirst?: boolean;
-  /** When false, skip writing fetched events to storage/observe. Default true. */
-  observe?: boolean;
-};
-type SubscribeOptions = {
-  relays?: string[];
-  onevent?: (event: Event) => void;
-  oneose?: () => void;
-  onclose?: (reason: string) => void;
-  signal?: AbortSignal;
-  id?: string;
-  /**
-   * If set, fire `oneose` once after this many ms if not all relays have EOSEd.
-   * Does not close the subscription.
-   */
-  eoseTimeoutMs?: number;
-  /** Fan out REQs via NIP-65 gossip routes when available. */
-  gossip?: boolean;
-  /** When false, skip writing received events to storage/observe. Default true. */
-  observe?: boolean;
-};
-type PublishOptions = {
-  relays?: string[];
-  timeoutMs?: number;
-  gossip?: boolean;
-  /** When false, skip writing the published event to storage/observe. Default true. */
-  observe?: boolean;
-};
-type SendPrivateMessageOptions = {
-  readonly subject?: string;
-  readonly replyTo?: ReplyTo;
-  readonly created_at?: number;
-  readonly timeoutMs?: number;
-  readonly observe?: boolean;
-};
-type PrivateMessageSendResult = {
-  rumor: Rumor;
-  wraps: ReadonlyArray<{
-    recipient: string;
-    wrap: Event;
-    results: PoolPublishResult[];
-  }>;
-};
-type ReceivedPrivateMessage = {
-  wrap: Event;
-  rumor: Rumor;
-};
-type FetchPrivateMessagesOptions = {
-  readonly since?: number;
-  readonly until?: number;
-  readonly timeoutMs?: number;
-  readonly signal?: AbortSignal;
-  readonly observe?: boolean;
-};
-type SubscribePrivateMessagesOptions = {
-  readonly since?: number;
-  readonly onevent?: (msg: ReceivedPrivateMessage) => void;
-  readonly oneose?: () => void;
-  readonly onclose?: (reason: string) => void;
-  readonly signal?: AbortSignal;
-  readonly eoseTimeoutMs?: number;
-  readonly observe?: boolean;
-};
-/** Client lifecycle, configuration, or abort failure (not cryptographic). */
-declare class ClientError extends NostrError {}
-//#endregion
-//#region src/client/client.d.ts
-/**
- * Layer-5 facade: signer + default relays + pool + loaders + gossip + event store.
- */
-declare class Client {
-  #private;
-  readonly pool: Pool;
-  readonly loaders: Loaders;
-  readonly gossip: Gossip;
-  readonly storage: EventStore;
-  onstorageerror: ((err: StorageError) => void) | null;
-  constructor(opts?: ClientOptions);
-  static builder(): ClientBuilder;
-  get signer(): NostrSigner | undefined;
-  get relays(): readonly string[];
-  get isShutdown(): boolean;
-  setSigner(signer: NostrSigner): void;
-  addRelay(url: string): void;
-  removeRelay(url: string): void;
-  /** Connect all configured relays (best-effort; failures are ignored). */
-  connect(opts?: {
-    signal?: AbortSignal;
-  }): Promise<void>;
-  shutdown(): Promise<void>;
-  /**
-   * Unified ingest pipeline: gossip + replaceable loader cache immediately;
-   * storage writes are coalesced into a single-flight `putMany`.
-   */
-  observe(event: Event): void;
-  /** Observe many events (deduped by id, order preserved) as one persist batch. */
-  observeAll(events: readonly Event[]): void;
-  /**
-   * Explicitly load kind:10002 and kind:10050 lists for pubkeys and feed gossip.
-   * Does not background-fetch unknown authors on every subscribe (predictable DX).
-   */
-  hydrateGossip(pubkeys: readonly string[], opts?: {
-    hints?: string[];
-    force?: boolean;
-  }): Promise<void>;
-  /**
-   * Create an outbox-model feed for the given authors (NIP-65 write relays).
-   * Live events go through {@link observe}; sync persists via applySync.
-   */
-  outbox(opts: {
-    authors: readonly string[];
-    kinds?: readonly number[];
-    onEvent?: (event: Event) => void;
-    maxRelaysPerAuthor?: number;
-  }): OutboxFeed;
-  getPublicKey(): Promise<string>;
-  signEvent(unsigned: UnsignedEvent): Promise<Event>;
-  signEventBuilder(builder: EventBuilder): Promise<Event>;
-  signTemplate(template: EventTemplate): Promise<Event>;
-  /**
-   * Sign (if builder) and publish to relays.
-   * With `gossip: true`, prefers the author's NIP-65 outbox relays, tagged `p`
-   * inboxes, and up to 5 `e`/`a` tag relay hints when known.
-   * On any successful OK, observes the event into storage/gossip.
-   */
-  publish(eventOrBuilder: Event | EventBuilder, opts?: PublishOptions): Promise<PoolPublishResult[]>;
-  /**
-   * Fetch events. With `gossip: true`, routes filters by NIP-65 when possible.
-   * With `localFirst: true`, merges storage hits with network results.
-   */
-  fetchEvents(filter: Filter | Filter[], opts?: FetchEventsOptions): Promise<Event[]>;
-  /**
-   * Query local storage only (no network).
-   */
-  queryLocal(filter: Filter | Filter[]): Promise<Event[]>;
-  subscribe(filter: Filter | Filter[], opts?: SubscribeOptions): {
-    close: (reason?: string) => void;
-  };
-  /** Publish a kind:10050 NIP-17 DM relay list (`relay` tags). Not kind 10002. */
-  setDmRelays(relays: readonly string[], opts?: PublishOptions): Promise<PoolPublishResult[]>;
-  sendPrivateMessage(recipients: string | Recipient | readonly (string | Recipient)[], content: string, opts?: SendPrivateMessageOptions): Promise<PrivateMessageSendResult>;
-  fetchPrivateMessages(opts?: FetchPrivateMessagesOptions): Promise<ReceivedPrivateMessage[]>;
-  subscribePrivateMessages(opts?: SubscribePrivateMessagesOptions): Promise<{
-    close: (reason?: string) => void;
-  }>;
-  /**
-   * NIP-77 sync against one relay: reconcile, then optionally upload
-   * local-only events and/or download remote-only events.
-   * `observe: false` skips putMany and ingestMeta; received ids are still listed.
-   * `persistEvents: false` skips putMany, still ingestMeta when observe is on.
-   */
-  syncToRelay(url: string, filter: Filter, opts?: Omit<SyncOptions, "relays">): Promise<SyncSummary>;
-  /**
-   * NIP-77 sync against the given relays (or Client default relays).
-   * Independent sessions run in parallel. Fulfilled summaries are merged;
-   * if every relay rejects, throws the first rejection in URL order.
-   */
-  sync(filter: Filter, opts?: SyncOptions): Promise<SyncSummary>;
-}
-//#endregion
-export { FetchPrivateMessagesOptions as a, ReceivedPrivateMessage as c, SubscribePrivateMessagesOptions as d, SyncDirection as f, ClientBuilder as g, SyncSummary as h, FetchEventsOptions as i, SendPrivateMessageOptions as l, SyncOptions as m, ClientError as n, PrivateMessageSendResult as o, SyncDirectionName as p, ClientOptions as r, PublishOptions as s, Client as t, SubscribeOptions as u };
-//# sourceMappingURL=index-DgOugrpF.d.mts.map

package/dist/index-EwL6fHLo.d.mts

@@ -1,267 +0,0 @@
-import { t as Event } from "./event-B5D2jxt_.mjs";
-import { n as ProfileMetadata } from "./builder-BphJa-Y-.mjs";
-import { t as RelayListItem } from "./nip65-Di5hZRuV.mjs";
-import { t as Gossip } from "./gossip-C5RVB1UB.mjs";
-import { a as NostrError } from "./error-WEFS-R-4.mjs";
-import { t as Pool } from "./pool-DhRi7l-b.mjs";
-import { i as EventPointer, t as AddressPointer } from "./nip19-D7905oIv.mjs";
-import { r as OutboxBound, t as EventStore } from "./types-Dn24TPFs.mjs";
-//#region src/loaders/cache.d.ts
-type ReplaceableKey = {
-  kind: number;
-  pubkey: string;
-  dTag?: string;
-};
-/** In-memory replaceable-event cache used by loaders (no DOM / localStorage). */
-declare class ReplaceableCache {
-  #private;
-  get(spec: ReplaceableKey): {
-    event: Event | null;
-    fetchedAt: number;
-  } | undefined;
-  set(spec: ReplaceableKey, event: Event | null, fetchedAt?: number): void;
-  /** Keep newer event by created_at. */
-  putIfNewer(event: Event, dTag?: string): void;
-  clear(spec?: ReplaceableKey): void;
-  get size(): number;
-}
-//#endregion
-//#region src/loaders/context.d.ts
-type LoaderContextOptions = {
-  pool: Pool;
-  /** Fallback / discovery relays when no per-user routing is known. */
-  relays: readonly string[];
-  cache?: ReplaceableCache;
-  /** Max age (seconds) before a cached replaceable is considered stale. Default 2 days. */
-  staleAfterSec?: number;
-  fetchTimeoutMs?: number;
-};
-/**
- * Explicit dependency bag for loaders — never a module-level singleton.
- */
-declare class LoaderContext {
-  #private;
-  readonly pool: Pool;
-  readonly cache: ReplaceableCache;
-  readonly staleAfterSec: number;
-  readonly fetchTimeoutMs: number;
-  constructor(opts: LoaderContextOptions);
-  /** Snapshot of discovery/fallback relays. */
-  get relays(): readonly string[];
-  addRelay(url: string): void;
-  removeRelay(url: string): void;
-  setRelays(urls: readonly string[]): void;
-  isFresh(fetchedAt: number, now?: number): boolean;
-}
-//#endregion
-//#region src/loaders/dataloader.d.ts
-declare class LoaderError extends NostrError {}
-/** Minimal request coalescer. Batches keys within a microtask; no global state. */
-type BatchLoadFn<K, V> = (keys: readonly K[]) => Promise<readonly (V | Error)[]>;
-type DataLoaderOptions<K, C = K> = {
-  cacheKeyFn?: (key: K) => C;
-  maxBatchSize?: number;
-  /** When false, only coalesces in-flight requests (no durable memoization). Default true. */
-  cache?: boolean;
-};
-declare class DataLoader<K, V, C = K> {
-  #private;
-  constructor(batchLoadFn: BatchLoadFn<K, V>, options?: DataLoaderOptions<K, C>);
-  load(key: K): Promise<V>;
-  clear(key: K): void;
-  clearAll(): void;
-}
-//#endregion
-//#region src/loaders/replaceable.d.ts
-type ReplaceableLoadResult = {
-  event: Event | null;
-  fresh: boolean;
-};
-type LoadStyle = "default" | "force" | "cache-only";
-/**
- * Batch-fetch replaceable events (kind + authors) via the pool, with cache.
- * Durable cache is ReplaceableCache; DataLoader only coalesces in-flight requests.
- */
-declare function createReplaceableLoader(ctx: LoaderContext, kind: number): {
-  load(pubkey: string, opts?: {
-    hints?: string[];
-    style?: LoadStyle;
-  }): Promise<ReplaceableLoadResult>;
-  clear(pubkey?: string): void;
-};
-//#endregion
-//#region src/loaders/lists.d.ts
-type ListResult<T> = {
-  event: Event | null;
-  items: T[];
-  fresh: boolean;
-};
-type MutedEntity = {
-  label: "pubkey";
-  value: string;
-} | {
-  label: "thread";
-  value: string;
-} | {
-  label: "hashtag";
-  value: string;
-} | {
-  label: "word";
-  value: string;
-};
-declare function createListLoaders(ctx: LoaderContext): {
-  follows(pubkey: string, opts?: {
-    hints?: string[];
-    style?: LoadStyle;
-  }): Promise<ListResult<string>>;
-  muteList(pubkey: string, opts?: {
-    hints?: string[];
-    style?: LoadStyle;
-  }): Promise<ListResult<MutedEntity>>;
-  relayList(pubkey: string, opts?: {
-    hints?: string[];
-    style?: LoadStyle;
-  }): Promise<ListResult<RelayListItem>>;
-  dmRelayList(pubkey: string, opts?: {
-    hints?: string[];
-    style?: LoadStyle;
-  }): Promise<ListResult<string>>;
-};
-type ListLoaders = ReturnType<typeof createListLoaders>;
-//#endregion
-//#region src/loaders/profile.d.ts
-type NostrUser = {
-  pubkey: string;
-  npub: string;
-  shortName: string;
-  image?: string;
-  metadata: ProfileMetadata;
-  lastUpdated: number;
-  event: Event | null;
-  fresh: boolean;
-};
-declare function bareNostrUser(pubkey: string): NostrUser;
-declare function createProfileLoader(ctx: LoaderContext): {
-  load(pubkey: string, opts?: {
-    hints?: string[];
-    style?: LoadStyle;
-  }): Promise<NostrUser>;
-};
-type ProfileLoader = ReturnType<typeof createProfileLoader>;
-//#endregion
-//#region src/loaders/event.d.ts
-type EventRef = string | EventPointer | AddressPointer;
-declare function createEventLoader(ctx: LoaderContext): {
-  load(ref: EventRef): Promise<Event | undefined>;
-  clearAll(): void;
-};
-type EventLoader = ReturnType<typeof createEventLoader>;
-//#endregion
-//#region src/loaders/outbox.d.ts
-declare class OutboxError extends NostrError {}
-type OutboxFeedOptions = {
-  pool: Pool;
-  gossip: Gossip;
-  storage: EventStore;
-  /** Fallback relays when an author has no known outbox routes. */
-  discoveryRelays: readonly string[];
-  authors: readonly string[];
-  /** Event kinds to fetch. Default `[Kind.TextNote]`. */
-  kinds?: readonly number[];
-  /** Max write-relays to use per author. Default 3. */
-  maxRelaysPerAuthor?: number;
-  fetchTimeoutMs?: number;
-  /** Called for live events after observe, and for sync events returned by applySync. */
-  onEvent?: (event: Event) => void;
-  /** Live ingest (e.g. `client.observe`). StartLive never putManys. */
-  observe?: (event: Event) => void;
-  /**
-   * Sync path only. Awaited. Return events that should advance bounds.
-   * Throw → sync throws, bounds unchanged.
-   */
-  applySync?: (events: readonly Event[]) => Promise<readonly Event[]>;
-  /**
-   * Load kind:10002 for authors before sync when routes are missing.
-   * Requires a relay-list loader.
-   */
-  hydrate?: (pubkeys: readonly string[]) => Promise<void>;
-};
-/**
- * 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: readonly string[], gossip: Gossip, discoveryRelays: readonly string[], maxRelaysPerAuthor?: number, prefer?: readonly 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(): readonly string[];
-  get kinds(): readonly number[];
-  /** Replace the author set (does not auto-restart live). */
-  setAuthors(authors: readonly 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;
-    since?: number;
-    until?: number;
-    signal?: AbortSignal;
-    /** Skip hydrate() even if provided. */
-    skipHydrate?: boolean;
-  }): Promise<Event[]>;
-  /**
-   * Start a live subscription across outbox relays for the current authors.
-   * Closes any previous live subscription.
-   */
-  startLive(opts?: {
-    signal?: AbortSignal;
-    since?: number;
-  }): {
-    close: (reason?: string) => void;
-  };
-  /** Convenience: hydrate + sync + startLive. */
-  start(opts?: {
-    limit?: number;
-    signal?: AbortSignal;
-  }): 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
-type Loaders = {
-  context: LoaderContext;
-  follows: ListLoaders["follows"];
-  muteList: ListLoaders["muteList"];
-  relayList: ListLoaders["relayList"];
-  dmRelayList: ListLoaders["dmRelayList"];
-  profile: ProfileLoader["load"];
-  event: EventLoader["load"];
-};
-type CreateLoadersOptions = {
-  pool: Pool;
-  relays: readonly string[];
-  cache?: ReplaceableCache;
-  staleAfterSec?: number;
-  fetchTimeoutMs?: number;
-};
-/** Build an instance-scoped loader suite (no module globals). */
-declare function createLoaders(opts: CreateLoadersOptions): Loaders;
-//#endregion
-export { DataLoader as C, ReplaceableCache as D, LoaderContextOptions as E, createReplaceableLoader as S, LoaderContext as T, ListResult as _, OutboxFeed as a, LoadStyle as b, groupAuthorsByOutboxRelay as c, createEventLoader as d, NostrUser as f, ListLoaders as g, createProfileLoader as h, OutboxError as i, EventLoader as l, bareNostrUser as m, Loaders as n, OutboxFeedOptions as o, ProfileLoader as p, createLoaders as r, createOutboxFeed as s, CreateLoadersOptions as t, EventRef as u, MutedEntity as v, LoaderError as w, ReplaceableLoadResult as x, createListLoaders as y };
-//# sourceMappingURL=index-EwL6fHLo.d.mts.map

package/dist/index-k2YhCgsh.d.mts

@@ -1,57 +0,0 @@
-import { t as Event } from "./event-B5D2jxt_.mjs";
-import { t as Filter } from "./filter-DUEKP3q1.mjs";
-import { i as PutResult, n as NegentropyItem, r as OutboxBound, t as EventStore } from "./types-Dn24TPFs.mjs";
-//#region src/storage/memory.d.ts
-/**
- * In-memory event store with NIP-01 replaceable / addressable / ephemeral
- * handling and NIP-09 deletion (kind 5) application.
- */
-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: readonly 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
-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: readonly 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
-export { IndexedDbEventStoreOptions as n, MemoryEventStore as r, IndexedDbEventStore as t };
-//# sourceMappingURL=index-k2YhCgsh.d.mts.map

package/dist/key-Dn-aX4x4.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"key-Dn-aX4x4.mjs","names":["#bytes"],"sources":["../src/core/key.ts"],"sourcesContent":["import { schnorr } from \"@noble/curves/secp256k1.js\";\nimport { CryptoError } from \"./error.ts\";\nimport {\n  type Event,\n  type EventTemplate,\n  type UnsignedEvent,\n  getEventHash,\n  isMarkedFailed,\n  isMarkedVerified,\n  markUnverified,\n  markVerified,\n  validateEvent,\n  validateSignedEvent,\n} from \"./event.ts\";\nimport { assertHex32, assertSecretKeyBytes, bytesToHex, hexToBytes } from \"./util.ts\";\n\n/** 32-byte secret key held as bytes; prefer zeroize when done. */\nexport class SecretKey {\n  #bytes: Uint8Array | null;\n\n  private constructor(bytes: Uint8Array) {\n    assertSecretKeyBytes(bytes);\n    this.#bytes = new Uint8Array(bytes);\n  }\n\n  static generate(): SecretKey {\n    return new SecretKey(schnorr.utils.randomSecretKey());\n  }\n\n  static fromBytes(bytes: Uint8Array): SecretKey {\n    return new SecretKey(bytes);\n  }\n\n  static fromHex(hex: string): SecretKey {\n    return new SecretKey(hexToBytes(assertHex32(hex, \"secret key\")));\n  }\n\n  get bytes(): Uint8Array {\n    if (!this.#bytes) throw new CryptoError(\"secret key has been zeroized\");\n    return new Uint8Array(this.#bytes);\n  }\n\n  toHex(): string {\n    return bytesToHex(this.bytes);\n  }\n\n  /** Best-effort wipe of the internal buffer. */\n  zeroize(): void {\n    if (this.#bytes) {\n      this.#bytes.fill(0);\n      this.#bytes = null;\n    }\n  }\n}\n\nexport type PublicKey = string;\n\nexport function publicKeyFromHex(hex: string): PublicKey {\n  return assertHex32(hex, \"public key\");\n}\n\nexport function getPublicKey(secretKey: SecretKey | Uint8Array | string): PublicKey {\n  const bytes =\n    secretKey instanceof SecretKey\n      ? secretKey.bytes\n      : typeof secretKey === \"string\"\n        ? hexToBytes(assertHex32(secretKey, \"secret key\"))\n        : (assertSecretKeyBytes(secretKey), secretKey);\n  return bytesToHex(schnorr.getPublicKey(bytes));\n}\n\n/** Keypair convenience wrapper. */\nexport class Keys {\n  readonly secretKey: SecretKey;\n  readonly publicKey: PublicKey;\n\n  private constructor(secretKey: SecretKey) {\n    this.secretKey = secretKey;\n    this.publicKey = getPublicKey(secretKey);\n  }\n\n  static generate(): Keys {\n    return new Keys(SecretKey.generate());\n  }\n\n  static fromSecretKey(secretKey: SecretKey | Uint8Array | string): Keys {\n    const sk =\n      secretKey instanceof SecretKey\n        ? secretKey\n        : typeof secretKey === \"string\"\n          ? SecretKey.fromHex(secretKey)\n          : SecretKey.fromBytes(secretKey);\n    return new Keys(sk);\n  }\n}\n\nfunction resolveSecretKeyBytes(secretKey: SecretKey | Uint8Array | string): Uint8Array {\n  if (secretKey instanceof SecretKey) return secretKey.bytes;\n  if (typeof secretKey === \"string\") return hexToBytes(assertHex32(secretKey, \"secret key\"));\n  assertSecretKeyBytes(secretKey);\n  return secretKey;\n}\n\n/** Fill pubkey/id/sig on a template and return a signed event. */\nexport function finalizeEvent(\n  template: EventTemplate,\n  secretKey: SecretKey | Uint8Array | string,\n): Event {\n  const sk = resolveSecretKeyBytes(secretKey);\n  const pubkey = bytesToHex(schnorr.getPublicKey(sk));\n  const unsigned: UnsignedEvent = {\n    kind: template.kind,\n    tags: template.tags,\n    content: template.content,\n    created_at: template.created_at,\n    pubkey,\n  };\n  return signEvent(unsigned, sk);\n}\n\n/**\n * Sign an already-assembled unsigned event.\n * Rejects when `unsigned.pubkey` does not match the secret key.\n */\nexport function signEvent(\n  unsigned: UnsignedEvent,\n  secretKey: SecretKey | Uint8Array | string,\n): Event {\n  const sk = resolveSecretKeyBytes(secretKey);\n  if (!validateEvent(unsigned)) {\n    throw new CryptoError(\"cannot sign invalid unsigned event\");\n  }\n\n  const expected = bytesToHex(schnorr.getPublicKey(sk));\n  if (unsigned.pubkey.toLowerCase() !== expected) {\n    throw new CryptoError(\"unsigned event pubkey does not match secret key\");\n  }\n\n  const normalized: UnsignedEvent = {\n    kind: unsigned.kind,\n    tags: unsigned.tags,\n    content: unsigned.content,\n    created_at: unsigned.created_at,\n    pubkey: expected,\n  };\n\n  const id = getEventHash(normalized);\n  const sig = bytesToHex(schnorr.sign(hexToBytes(id), sk));\n  const event: Event = { ...normalized, id, sig };\n  markVerified(event);\n  return event;\n}\n\n/** Verify event id and BIP-340 signature. Uses WeakSet cache (does not mutate the event). */\nexport function verifyEvent(event: Event): boolean {\n  if (isMarkedVerified(event)) return true;\n  if (isMarkedFailed(event)) return false;\n\n  if (!validateSignedEvent(event)) {\n    markUnverified(event);\n    return false;\n  }\n\n  try {\n    const hash = getEventHash(event);\n    if (hash !== event.id.toLowerCase()) {\n      markUnverified(event);\n      return false;\n    }\n    const ok = schnorr.verify(\n      hexToBytes(event.sig.toLowerCase()),\n      hexToBytes(hash),\n      hexToBytes(event.pubkey.toLowerCase()),\n    );\n    if (ok) markVerified(event);\n    else markUnverified(event);\n    return ok;\n  } catch {\n    markUnverified(event);\n    return false;\n  }\n}\n"],"mappings":";;;;;;AAiBA,IAAa,YAAb,MAAa,UAAU;CACrB;CAEA,YAAoB,OAAmB;EACrC,qBAAqB,KAAK;EAC1B,KAAKA,SAAS,IAAI,WAAW,KAAK;CACpC;CAEA,OAAO,WAAsB;EAC3B,OAAO,IAAI,UAAU,QAAQ,MAAM,gBAAgB,CAAC;CACtD;CAEA,OAAO,UAAU,OAA8B;EAC7C,OAAO,IAAI,UAAU,KAAK;CAC5B;CAEA,OAAO,QAAQ,KAAwB;EACrC,OAAO,IAAI,UAAU,WAAW,YAAY,KAAK,YAAY,CAAC,CAAC;CACjE;CAEA,IAAI,QAAoB;EACtB,IAAI,CAAC,KAAKA,QAAQ,MAAM,IAAI,YAAY,8BAA8B;EACtE,OAAO,IAAI,WAAW,KAAKA,MAAM;CACnC;CAEA,QAAgB;EACd,OAAO,WAAW,KAAK,KAAK;CAC9B;;CAGA,UAAgB;EACd,IAAI,KAAKA,QAAQ;GACf,KAAKA,OAAO,KAAK,CAAC;GAClB,KAAKA,SAAS;EAChB;CACF;AACF;AAIA,SAAgB,iBAAiB,KAAwB;CACvD,OAAO,YAAY,KAAK,YAAY;AACtC;AAEA,SAAgB,aAAa,WAAuD;CAClF,MAAM,QACJ,qBAAqB,YACjB,UAAU,QACV,OAAO,cAAc,WACnB,WAAW,YAAY,WAAW,YAAY,CAAC,KAC9C,qBAAqB,SAAS,GAAG;CAC1C,OAAO,WAAW,QAAQ,aAAa,KAAK,CAAC;AAC/C;;AAGA,IAAa,OAAb,MAAa,KAAK;CAChB;CACA;CAEA,YAAoB,WAAsB;EACxC,KAAK,YAAY;EACjB,KAAK,YAAY,aAAa,SAAS;CACzC;CAEA,OAAO,WAAiB;EACtB,OAAO,IAAI,KAAK,UAAU,SAAS,CAAC;CACtC;CAEA,OAAO,cAAc,WAAkD;EACrE,MAAM,KACJ,qBAAqB,YACjB,YACA,OAAO,cAAc,WACnB,UAAU,QAAQ,SAAS,IAC3B,UAAU,UAAU,SAAS;EACrC,OAAO,IAAI,KAAK,EAAE;CACpB;AACF;AAEA,SAAS,sBAAsB,WAAwD;CACrF,IAAI,qBAAqB,WAAW,OAAO,UAAU;CACrD,IAAI,OAAO,cAAc,UAAU,OAAO,WAAW,YAAY,WAAW,YAAY,CAAC;CACzF,qBAAqB,SAAS;CAC9B,OAAO;AACT;;AAGA,SAAgB,cACd,UACA,WACO;CACP,MAAM,KAAK,sBAAsB,SAAS;CAC1C,MAAM,SAAS,WAAW,QAAQ,aAAa,EAAE,CAAC;CAQlD,OAAO,UAAU;EANf,MAAM,SAAS;EACf,MAAM,SAAS;EACf,SAAS,SAAS;EAClB,YAAY,SAAS;EACrB;CAEsB,GAAG,EAAE;AAC/B;;;;;AAMA,SAAgB,UACd,UACA,WACO;CACP,MAAM,KAAK,sBAAsB,SAAS;CAC1C,IAAI,CAAC,cAAc,QAAQ,GACzB,MAAM,IAAI,YAAY,oCAAoC;CAG5D,MAAM,WAAW,WAAW,QAAQ,aAAa,EAAE,CAAC;CACpD,IAAI,SAAS,OAAO,YAAY,MAAM,UACpC,MAAM,IAAI,YAAY,iDAAiD;CAGzE,MAAM,aAA4B;EAChC,MAAM,SAAS;EACf,MAAM,SAAS;EACf,SAAS,SAAS;EAClB,YAAY,SAAS;EACrB,QAAQ;CACV;CAEA,MAAM,KAAK,aAAa,UAAU;CAClC,MAAM,MAAM,WAAW,QAAQ,KAAK,WAAW,EAAE,GAAG,EAAE,CAAC;CACvD,MAAM,QAAe;EAAE,GAAG;EAAY;EAAI;CAAI;CAC9C,aAAa,KAAK;CAClB,OAAO;AACT;;AAGA,SAAgB,YAAY,OAAuB;CACjD,IAAI,iBAAiB,KAAK,GAAG,OAAO;CACpC,IAAI,eAAe,KAAK,GAAG,OAAO;CAElC,IAAI,CAAC,oBAAoB,KAAK,GAAG;EAC/B,eAAe,KAAK;EACpB,OAAO;CACT;CAEA,IAAI;EACF,MAAM,OAAO,aAAa,KAAK;EAC/B,IAAI,SAAS,MAAM,GAAG,YAAY,GAAG;GACnC,eAAe,KAAK;GACpB,OAAO;EACT;EACA,MAAM,KAAK,QAAQ,OACjB,WAAW,MAAM,IAAI,YAAY,CAAC,GAClC,WAAW,IAAI,GACf,WAAW,MAAM,OAAO,YAAY,CAAC,CACvC;EACA,IAAI,IAAI,aAAa,KAAK;OACrB,eAAe,KAAK;EACzB,OAAO;CACT,QAAQ;EACN,eAAe,KAAK;EACpB,OAAO;CACT;AACF"}

package/dist/kind-BLl4cLOc.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"kind-BLl4cLOc.mjs","names":[],"sources":["../src/core/kind.ts"],"sourcesContent":["/** NIP-01 regular: stored by relays. */\nexport function isRegularKind(kind: number): boolean {\n  return kind === 1 || kind === 2 || (kind >= 4 && kind < 45) || (kind >= 1000 && kind < 10000);\n}\n\n/** Replaceable: latest per (pubkey, kind) wins. */\nexport function isReplaceableKind(kind: number): boolean {\n  return kind === 0 || kind === 3 || (kind >= 10000 && kind < 20000);\n}\n\n/** Ephemeral: not expected to be stored. */\nexport function isEphemeralKind(kind: number): boolean {\n  return kind >= 20000 && kind < 30000;\n}\n\n/** Addressable (parameterized replaceable): latest per (pubkey, kind, d-tag) wins. */\nexport function isAddressableKind(kind: number): boolean {\n  return kind >= 30000 && kind < 40000;\n}\n\nexport type KindClassification =\n  | \"regular\"\n  | \"replaceable\"\n  | \"ephemeral\"\n  | \"addressable\"\n  | \"unknown\";\n\nexport function classifyKind(kind: number): KindClassification {\n  if (isRegularKind(kind)) return \"regular\";\n  if (isReplaceableKind(kind)) return \"replaceable\";\n  if (isEphemeralKind(kind)) return \"ephemeral\";\n  if (isAddressableKind(kind)) return \"addressable\";\n  return \"unknown\";\n}\n\n/** Kind numbers used by this package. */\nexport const Kind = {\n  Metadata: 0,\n  TextNote: 1,\n  Contacts: 3,\n  EventDeletion: 5,\n  Repost: 6,\n  Reaction: 7,\n  Seal: 13,\n  PrivateDirectMessage: 14,\n  GenericRepost: 16,\n  GiftWrap: 1059,\n  ZapRequest: 9734,\n  Zap: 9735,\n  MuteList: 10000,\n  PinList: 10001,\n  RelayList: 10002,\n  BookmarkList: 10003,\n  FavoriteRelays: 10012,\n  UserEmojiList: 10030,\n  DirectMessageRelaysList: 10050,\n  BlossomServerList: 10063,\n  GiftWrapEphemeral: 21059,\n  ClientAuth: 22242,\n  NostrConnect: 24133,\n  BlobsAuth: 24242,\n  HttpAuth: 27235,\n  RelaySets: 30002,\n  EmojiSet: 30030,\n  StarterPack: 39089,\n} as const;\n\nexport type KindName = keyof typeof Kind;\nexport type KnownKind = (typeof Kind)[KindName];\n"],"mappings":";;AACA,SAAgB,cAAc,MAAuB;CACnD,OAAO,SAAS,KAAK,SAAS,KAAM,QAAQ,KAAK,OAAO,MAAQ,QAAQ,OAAQ,OAAO;AACzF;;AAGA,SAAgB,kBAAkB,MAAuB;CACvD,OAAO,SAAS,KAAK,SAAS,KAAM,QAAQ,OAAS,OAAO;AAC9D;;AAGA,SAAgB,gBAAgB,MAAuB;CACrD,OAAO,QAAQ,OAAS,OAAO;AACjC;;AAGA,SAAgB,kBAAkB,MAAuB;CACvD,OAAO,QAAQ,OAAS,OAAO;AACjC;AASA,SAAgB,aAAa,MAAkC;CAC7D,IAAI,cAAc,IAAI,GAAG,OAAO;CAChC,IAAI,kBAAkB,IAAI,GAAG,OAAO;CACpC,IAAI,gBAAgB,IAAI,GAAG,OAAO;CAClC,IAAI,kBAAkB,IAAI,GAAG,OAAO;CACpC,OAAO;AACT;;AAGA,MAAa,OAAO;CAClB,UAAU;CACV,UAAU;CACV,UAAU;CACV,eAAe;CACf,QAAQ;CACR,UAAU;CACV,MAAM;CACN,sBAAsB;CACtB,eAAe;CACf,UAAU;CACV,YAAY;CACZ,KAAK;CACL,UAAU;CACV,SAAS;CACT,WAAW;CACX,cAAc;CACd,gBAAgB;CAChB,eAAe;CACf,yBAAyB;CACzB,mBAAmB;CACnB,mBAAmB;CACnB,YAAY;CACZ,cAAc;CACd,WAAW;CACX,UAAU;CACV,WAAW;CACX,UAAU;CACV,aAAa;AACf"}