vibedate 0.4.1 → 0.6.0

package/dist/index.d.ts

@@ -238,6 +238,119 @@ interface DiscoverySession {
  */
 declare function startDiscovery(opts: DiscoveryOptions): Promise<DiscoverySession>;
 
+/**
+ * A Nostr event, reduced to the fields this module touches. Structurally
+ * compatible with `nostr-tools`'s `Event`, so a finalized/verified event can be
+ * published and a relay-delivered event can be received without conversion.
+ */
+interface RelayEvent {
+    readonly kind: number;
+    /** Sender's secp256k1 (Nostr) pubkey, hex — public; the relay sees it. */
+    readonly pubkey: string;
+    /** Ciphertext for kind-4 DMs; a presence marker for the presence kind. */
+    readonly content: string;
+    readonly tags: readonly (readonly string[])[];
+    readonly created_at: number;
+    readonly id: string;
+    readonly sig: string;
+}
+/** A subscription filter: kinds + a `#t` conversation-tag match. */
+interface RelayFilter {
+    readonly kinds?: readonly number[];
+    readonly '#t'?: readonly string[];
+}
+/**
+ * The injection point between the relay link and the wire. The production
+ * implementation is {@link createNostrPoolTransport} (real wss:// relays via
+ * `nostr-tools` `SimplePool`); tests pass an in-memory fan-out. A real relay
+ * STORES events and replays matching stored events to new subscribers (that
+ * store-and-replay semantics is what makes the presence handshake work across
+ * arrival order) — a faithful mock must do the same.
+ */
+interface RelayTransport {
+    /** Publish a signed event to the relay(s). Fire-and-forget / best-effort. */
+    publish(event: RelayEvent): void;
+    /**
+     * Subscribe to events matching `filter`. Returns an unsubscribe. A faithful
+     * relay replays matching STORED events to a brand-new subscriber before any
+     * future ones, so the presence handshake is order-independent.
+     */
+    subscribe(filter: RelayFilter, onEvent: (event: RelayEvent) => void): () => void;
+    /** Close all relay connections. Idempotent. */
+    close(): void;
+}
+/**
+ * Default public Nostr relays (the public commons — we host none of them).
+ * Overridable via {@link createNostrPoolTransport}. These are well-known,
+ * generally-open relays; any reachable public relay works.
+ */
+declare const DEFAULT_RELAYS: readonly string[];
+/** Kind for encrypted DM payloads — the standard NIP-04 sealed-direct-message kind. */
+declare const VIBEDATE_MESSAGE_KIND = 4;
+/**
+ * Kind for the presence/rendezvous ping (parameterized-replaceable range). Its
+ * content is a constant marker that reveals nothing about the conversation; its
+ * `event.pubkey` is the sender's Nostr key (public by definition), and an
+ * `ed25519` tag binds it to the sender's identity so the receiver only accepts
+ * presence from the peer it expects.
+ */
+declare const VIBEDATE_PRESENCE_KIND = 30078;
+/**
+ * Derive the deterministic conversation tag two peers rendezvous on, from BOTH
+ * ed25519 identity pubkeys (sorted, hashed). Pure: both sides compute it
+ * byte-identically from data each already holds (their own identity + the
+ * peer's advertised pubkey), so NO extra exchange is needed to agree on the
+ * rendezvous point. The hash hides the underlying identities from anyone
+ * scanning the relay by tag.
+ */
+declare function conversationTag(myEd25519Hex: string, peerEd25519Hex: string): string;
+/**
+ * A relay-fallback link with the SAME shape as {@link PeerLink}, so callers can
+ * drop it in wherever a direct P2P link is used (pairing, the `live` chat loop).
+ *
+ * Implemented in v0: `send`/`onMessage`/`onClose`/`close` + `.hello` (text chat
+ * over NIP-04). `sendMedia`/`sendSignal`/`onMedia`/`onSignal` are accepted as
+ * no-ops so the link is type-interchangeable with a direct PeerLink — chunked
+ * media + WebRTC signaling over the relay are `// ponytail:` follow-ups (a relay
+ * link is a fallback for peers who can't connect at all, where plain text chat
+ * is the priority).
+ */
+type NostrRelayLink = PeerLink;
+/** Options for {@link createNostrRelayLink}. */
+interface CreateNostrRelayLinkOptions {
+    /** This peer's Nostr secp256k1 keypair (see {@link loadOrCreateNostrKey}). */
+    readonly myNostr: {
+        readonly sk: Uint8Array;
+        readonly pubkey: string;
+    };
+    /** This peer's ed25519 identity pubkey (hex) — half of the convTag input. */
+    readonly myEd25519Hex: string;
+    /** The REMOTE peer's ed25519 identity pubkey (hex) — the other convTag half. */
+    readonly peerEd25519Hex: string;
+    /** The remote peer's identity, surfaced as the link's `.hello`. */
+    readonly hello: PeerHello;
+    /** The injected relay transport (real pool OR an in-memory mock). */
+    readonly transport: RelayTransport;
+}
+/**
+ * Build a {@link NostrRelayLink} over the injected {@link RelayTransport}. The
+ * link immediately subscribes to the conversation tag and publishes its presence
+ * so the peer can learn this side's Nostr pubkey (the bootstrap for NIP-04).
+ * Resolves once subscribed + presence published. Async only because
+ * `nostr-tools` (NIP-04 + event signing) is lazy-imported on first use.
+ */
+declare function createNostrRelayLink(opts: CreateNostrRelayLinkOptions): Promise<NostrRelayLink>;
+/**
+ * Build a real {@link RelayTransport} over public Nostr relays via
+ * `nostr-tools`'s `SimplePool`. `nostr-tools` (and its WebSocket stack) is
+ * imported lazily here. Async because constructing the pool may need the
+ * lazy module load. The returned transport:
+ *   - `publish` is fire-and-forget (publishes to all relays, awaits none);
+ *   - `subscribe` mirrors `SimplePool.subscribeMany` and returns an unsub;
+ *   - `close` tears the pool down.
+ */
+declare function createNostrPoolTransport(urls?: readonly string[]): Promise<RelayTransport>;
+
 /**
  * Persistent ed25519 identity — binds a handle to a keypair so a peer cannot
  * impersonate it.
@@ -307,6 +420,28 @@ type IdentityVerdict = 'verified' | 'legacy' | 'drop';
  * caller (discovery) turns 'drop' into "never recorded, never paired".
  */
 declare function classifyHelloIdentity(hello: HelloClaims & Partial<IdentityProof>): IdentityVerdict;
+/**
+ * A separate secp256k1 keypair for the Nostr relay fallback (see relay.ts).
+ * Kept DISTINCT from the ed25519 {@link Identity} on purpose: NIP-04 encryption
+ * requires a secp256k1 key, and reusing or deriving the ed25519 key for that
+ * would cross two unrelated cryptographic curves. The private key is persisted
+ * at `<dir>/nostr.json` (mode 0600) and never leaves the file; only the
+ * secp256k1 public key (hex) is ever published on a relay.
+ */
+interface NostrKey {
+    /** 32-byte secp256k1 secret key — the NIP-04 decrypt/encrypt key. Never sent. */
+    readonly sk: Uint8Array;
+    /** secp256k1 public key, hex (64 chars) — safe to publish; the relay sees it. */
+    readonly pubkey: string;
+}
+/**
+ * Load the persistent secp256k1 Nostr key, generating + storing it (mode 0600)
+ * on first use. A missing or corrupt file is (re)generated — never throws on
+ * disk content. Idempotent across runs: same file → same key. `nostr-tools` is
+ * imported LAZILY (only when a key must be generated) so non-relay commands
+ * never pay for the secp256k1 stack.
+ */
+declare function loadOrCreateNostrKey(dir?: string): Promise<NostrKey>;
 
 /**
  * A usage league (volume bucket). `max` is inclusive; the top tier is open-ended
@@ -423,4 +558,4 @@ declare const CANDIDATES: readonly Candidate[];
  */
 declare function matches(myLeague: string, candidates?: readonly Candidate[]): Candidate[];
 
-export { BELOW_LEAGUE, CANDIDATES, type Candidate, DEMO_TOTAL_TOKENS, type DiscoveryOptions, type DiscoverySession, type HelloClaims, type Identity, type IdentityProof, type IdentityVerdict, LEAGUES, LIVE_NOTICE, type League, type LocalUsageSnapshot, type PeerHello, type StoredPeer, TOKENS_ENV, TOPIC_PREFIX, allLeagueNames, canonicalHelloClaims, classifyHelloIdentity, league, leagueIndex, leagueTopic, leaguesWithin, loadOrCreateIdentity, loadPeers, matches, parseHandshake, parseTokensEnv, readUsage, recordPeer, recordPeerMessage, serializeHandshake, signHelloClaims, startDiscovery, verifyHelloClaims };
+export { BELOW_LEAGUE, CANDIDATES, type Candidate, type CreateNostrRelayLinkOptions, DEFAULT_RELAYS, DEMO_TOTAL_TOKENS, type DiscoveryOptions, type DiscoverySession, type HelloClaims, type Identity, type IdentityProof, type IdentityVerdict, LEAGUES, LIVE_NOTICE, type League, type LocalUsageSnapshot, type NostrKey, type NostrRelayLink, type PeerHello, type RelayEvent, type RelayFilter, type RelayTransport, type StoredPeer, TOKENS_ENV, TOPIC_PREFIX, VIBEDATE_MESSAGE_KIND, VIBEDATE_PRESENCE_KIND, allLeagueNames, canonicalHelloClaims, classifyHelloIdentity, conversationTag, createNostrPoolTransport, createNostrRelayLink, league, leagueIndex, leagueTopic, leaguesWithin, loadOrCreateIdentity, loadOrCreateNostrKey, loadPeers, matches, parseHandshake, parseTokensEnv, readUsage, recordPeer, recordPeerMessage, serializeHandshake, signHelloClaims, startDiscovery, verifyHelloClaims };

package/dist/index.js

@@ -1,20 +1,27 @@
 import {
   BELOW_LEAGUE,
   CANDIDATES,
+  DEFAULT_RELAYS,
   DEMO_TOTAL_TOKENS,
   LEAGUES,
   LIVE_NOTICE,
   TOKENS_ENV,
   TOPIC_PREFIX,
+  VIBEDATE_MESSAGE_KIND,
+  VIBEDATE_PRESENCE_KIND,
   allLeagueNames,
   canonicalHelloClaims,
   classifyHelloIdentity,
+  conversationTag,
   createConsentLedger,
+  createNostrPoolTransport,
+  createNostrRelayLink,
   league,
   leagueIndex,
   leagueTopic,
   leaguesWithin,
   loadOrCreateIdentity,
+  loadOrCreateNostrKey,
   loadPeers,
   matches,
   parseHandshake,
@@ -26,24 +33,31 @@ import {
   signHelloClaims,
   startDiscovery,
   verifyHelloClaims
-} from "./chunk-43IYNWES.js";
+} from "./chunk-VZXPYU2C.js";
 export {
   BELOW_LEAGUE,
   CANDIDATES,
+  DEFAULT_RELAYS,
   DEMO_TOTAL_TOKENS,
   LEAGUES,
   LIVE_NOTICE,
   TOKENS_ENV,
   TOPIC_PREFIX,
+  VIBEDATE_MESSAGE_KIND,
+  VIBEDATE_PRESENCE_KIND,
   allLeagueNames,
   canonicalHelloClaims,
   classifyHelloIdentity,
+  conversationTag,
   createConsentLedger,
+  createNostrPoolTransport,
+  createNostrRelayLink,
   league,
   leagueIndex,
   leagueTopic,
   leaguesWithin,
   loadOrCreateIdentity,
+  loadOrCreateNostrKey,
   loadPeers,
   matches,
   parseHandshake,

package/dist/mcp.js

@@ -1,7 +1,7 @@
 import {
   runMcp
-} from "./chunk-ZB56ZBAR.js";
-import "./chunk-43IYNWES.js";
+} from "./chunk-JIBC3OHV.js";
+import "./chunk-VZXPYU2C.js";
 export {
   runMcp
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibedate",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "Dating by tokens — matched by usage league across agentic CLIs. Raw usage stays local; only your league is shared. CLI + local web app + MCP. Local-first.",
   "type": "module",
   "license": "MIT",
@@ -30,7 +30,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@pooriaarab/vibe-core": "^0.3.0",
-    "hyperswarm": "^4.17.0"
+    "hyperswarm": "^4.17.0",
+    "nostr-tools": "^2.24.1"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",