wireweave 0.3.19 → 0.3.21

package/README.md

@@ -27,10 +27,26 @@ ww.auth.loadFromStorage() || ww.auth.generateKey();
 ww.servers.init();
 ```
 
-`ww` exposes: `pool`, `auth`, `fsm`, `message`, `bans`, `roles`, `settings`, `pages`, `media`, `channels`, `servers`, `chat`, `voice` (lazy via `ensureVoice()`), `setCurrentChannel()`.
+`ww` exposes: `pool`, `auth`, `fsm`, `message`, `bans`, `roles`, `settings`, `pages`, `media`, `channels`, `servers`, `chat`, `voice` (lazy via `ensureVoice()`), `dm` (lazy via `ensureDM()`), `setCurrentChannel()`, `currentChannelId`, `currentServerId`.
 
 every submodule is an `EventTarget`. subscribe with `addEventListener('event', ...)`.
 
+`message` is a standalone in-memory `MessageBus` (bounded ring + typed handler dispatch). It is provided for apps that want a local message store; no other wireweave module depends on it, so ignore it if you don't need it.
+
+### node / non-browser environments
+
+`createWireweave` and `NostrAuth`/`Servers` need a `storage` adapter outside the browser — pass `{ getItem, setItem, removeItem }`. Without it `createWireweave` throws `wireweave: storage required` up front (in the browser it defaults to `localStorage`). On-relay `d`-tags use a frozen `zellous-` prefix and storage keys use `zn_*`; these are published wire/storage contracts kept stable across the rename to wireweave — do not change them without a migration path.
+
+## direct messages (encrypted)
+
+```js
+const dm = ww.ensureDM();              // lazy: needs nostr-tools built with nip44
+dm.subscribe(({ peer, plaintext }) => console.log(peer, plaintext));
+await dm.send(peerPubkey, 'hello');
+```
+
+**Caveat:** nip44 encryption derives a conversation key from your **private key**, so DM requires a privkey-backed signer (`generateKey`/`importKey`). It does **not** work with extension signing (NIP-07), which never exposes the privkey — `dm.send` throws `DM: privkey required` in that case.
+
 ## modules
 
 ```js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wireweave",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "nostr + webrtc voice + data SDK. networking layer for 247420 projects.",
   "type": "module",
   "main": "./src/index.js",

package/src/bans.js

@@ -69,8 +69,8 @@ export class Bans extends EventTarget {
           const data = this.store.get(serverId) || { banned: [], timeouts: {} };
           if (parsed.ns === 'ban' && pubkey && !data.banned.includes(pubkey)) data.banned.push(pubkey);
           else if (parsed.ns === 'timeout' && pubkey) {
-            const parsed = JSON.parse(event.content);
-            if (parsed.expiry > Math.floor(Date.now() / 1000)) (data.timeouts = data.timeouts || {})[pubkey] = { expiry: parsed.expiry };
+            const body = JSON.parse(event.content);
+            if (body.expiry > Math.floor(Date.now() / 1000)) (data.timeouts = data.timeouts || {})[pubkey] = { expiry: body.expiry };
             else if (data.timeouts?.[pubkey]) delete data.timeouts[pubkey];
           }
           this.store.set(serverId, data);

package/src/channels.js

@@ -72,6 +72,14 @@ export class Channels extends EventTarget {
     await this._publish(); this._emit('updated', { channels: this.channels, categories: this.categories });
   }
 
+  // Per-channel metadata patch — used for topic, voiceMode, and any future
+  // server-published channel-scoped configuration. Owner-only.
+  async update(id, patch) {
+    if (!patch || typeof patch !== 'object') return;
+    this.channels = this.channels.map(c => c.id === id ? { ...c, ...patch } : c);
+    await this._publish(); this._emit('updated', { channels: this.channels, categories: this.categories });
+  }
+
   async remove(id) {
     this.channels = this.channels.filter(c => c.id !== id);
     await this._publish(); this._emit('updated', { channels: this.channels, categories: this.categories });

package/src/data.js

@@ -72,6 +72,7 @@ export class DataSession extends EventTarget {
     this._stopHeartbeat();
     for (const pk of Array.from(this.peers.keys())) this._closePeer(pk);
     this.peers.clear();
+    for (const pk of Object.keys(this.retrySchedule)) this._cancelReconnect(pk);
     if (this.roomId) {
       this.pool.unsubscribe('data-presence-' + this.roomId);
       this.pool.unsubscribe('data-signals-' + this.roomId);

package/src/dtag.js

@@ -1,13 +1,19 @@
 const NAMESPACES = new Set(['ban', 'timeout', 'kick', 'page', 'channels', 'roles', 'settings']);
 
+// Frozen on-relay wire prefix. The brand is now wireweave but deployed events
+// carry 'zellous-' d-tags, so this is a published-contract constant — do not
+// rename it without a migration path. parseDtag derives its slice offset from
+// PREFIX.length so the literal and the offset can never drift apart.
+const PREFIX = 'zellous-';
+
 export const dtag = (ns, ...parts) => {
   if (!NAMESPACES.has(ns)) throw new Error('dtag: unknown namespace ' + ns);
-  return ['zellous-' + ns, ...parts].join(':');
+  return [PREFIX + ns, ...parts].join(':');
 };
 
 export const parseDtag = (s) => {
-  if (typeof s !== 'string' || !s.startsWith('zellous-')) return null;
-  const parts = s.slice(8).split(':');
+  if (typeof s !== 'string' || !s.startsWith(PREFIX)) return null;
+  const parts = s.slice(PREFIX.length).split(':');
   const ns = parts.shift();
   if (!NAMESPACES.has(ns)) return null;
   return { ns, parts };

package/src/voice.js

@@ -103,6 +103,7 @@ export class VoiceSession extends EventTarget {
     this._sfuStop();
     for (const pk of Array.from(this.peers.keys())) this._closePeer(pk);
     this.peers.clear();
+    for (const pk of Object.keys(this.retrySchedule)) this._cancelReconnect(pk);
     if (this._activityTimer) { clearInterval(this._activityTimer); this._activityTimer = null; }
     if (this._activeAnalyzers) { for (const k of Array.from(this._activeAnalyzers.keys())) this._detachAnalyzer(k); }
     if (this._outboundRec) { try { this._outboundRec.rec.stop(); } catch {} this._outboundRec = null; }
@@ -453,14 +454,17 @@ export class VoiceSession extends EventTarget {
     }
     if (data.action === 'leave') {
       this.participants.delete(shortId);
+      this.sfu.pubkeyByShortId?.delete(shortId);
       this._closePeer(event.pubkey);
       if (this.sfu.hub === event.pubkey) this._sfuOnHubLost();
     }
     else if (!this.participants.has(shortId)) {
       this.participants.set(shortId, { identity: data.name || event.pubkey.slice(0, 8), isSpeaking: false, isMuted: false, isLocal: false, hasVideo: false, connectionQuality: 'connecting' });
+      if (this.sfu.pubkeyByShortId) this.sfu.pubkeyByShortId.set(shortId, event.pubkey);
       this._sfuMaybeElect();
       this._maybeConnect(event.pubkey);
     } else {
+      if (this.sfu.pubkeyByShortId && !this.sfu.pubkeyByShortId.has(shortId)) this.sfu.pubkeyByShortId.set(shortId, event.pubkey);
       this._sfuMaybeElect();
       if (this._sfuShouldHaveConnectionTo(event.pubkey) && !this.peers.has(event.pubkey)) this._maybeConnect(event.pubkey);
     }
@@ -690,6 +694,7 @@ export class VoiceSession extends EventTarget {
     this.sfu.lastSwitch = 0;
     this.sfu.capacityMatrix = new Map();
     this.sfu.reflexiveByPeer = new Map();
+    this.sfu.pubkeyByShortId = new Map();
     this._sfuStopStats();
     this.sfu.statsInterval = setInterval(() => this._sfuPoll(), 2500);
   }
@@ -818,6 +823,7 @@ export class VoiceSession extends EventTarget {
     this.sfu.hub = top.pubkey;
     this.sfu.warmBackup = (runnerUp && runnerUp.pubkey !== top.pubkey) ? runnerUp.pubkey : null;
     this.sfu.lastSwitch = Date.now();
+    try { this.sfu.actor?.send({ type: 'elect' }); } catch {}
     this.sfu.actor?.send({ type: 'elected' });
     this._emit('hub-changed', { hub: top.pubkey, previous: previousHub, score: top.score, uplink: top.uplink });
 
@@ -832,11 +838,13 @@ export class VoiceSession extends EventTarget {
   // - Else: keep PCs only to hub + warm backup.
   _sfuApplyTopology(hubPk) {
     if (hubPk === this.auth.pubkey) {
-      for (const peerPk of this.participants.keys()) {
-        // participants keys are shortIds; iterate via known peer pubkeys from rttMatrix instead.
-      }
-      // Use capacityMatrix + presence-known pubkeys as the participant list.
+      // Hub connects to every known participant. Build the pubkey set from
+      // every available source — pubkeyByShortId (presence-derived), peers,
+      // capacityMatrix, rttMatrix — because at the moment of the very first
+      // election the matrices may not be populated yet.
       const known = new Set();
+      if (this.sfu.pubkeyByShortId) for (const pk of this.sfu.pubkeyByShortId.values()) known.add(pk);
+      for (const pk of this.peers.keys()) known.add(pk);
       for (const pk of this.sfu.capacityMatrix?.keys() || []) known.add(pk);
       for (const pk of this.sfu.rttMatrix.keys()) known.add(pk);
       for (const pk of known) {
@@ -908,6 +916,7 @@ export class VoiceSession extends EventTarget {
     this.sfu.hub = promote;
     this.sfu.warmBackup = null;
     this.sfu.lastSwitch = Date.now();
+    try { this.sfu.actor?.send({ type: 'elect' }); } catch {}
     this.sfu.actor?.send({ type: 'elected' });
     this._emit('hub-changed', { hub: promote, previous: lost, reason: 'failover' });
     if (promote === this.auth.pubkey) this._sfuBecomeHub();

package/src/wireweave.js

@@ -11,6 +11,7 @@ import { createRoles } from './roles.js';
 import { createSettings } from './settings.js';
 import { createMedia } from './media.js';
 import { createPages } from './pages.js';
+import { createDM } from './dm.js';
 import { register } from './debug.js';
 
 export const createWireweave = ({
@@ -76,10 +77,21 @@ export const createWireweave = ({
 
   const setCurrentChannel = (id) => { currentChannelId = id; if (id) chat.loadHistory(id); };
 
+  // DM is lazy: nip44 encryption requires a privkey-backed signer (not extension)
+  // and nostr-tools built with nip44. Constructing it eagerly would throw for
+  // builds without nip44, so we defer to first use — mirrors ensureVoice.
+  let dm = null;
+  const ensureDM = () => {
+    if (!dm) dm = createDM({ relayPool: pool, auth, nostrTools });
+    return dm;
+  };
+
   const api = {
     pool, auth, fsm, message, bans, roles, settings, pages, media, channels, servers, chat,
     get voice() { return voice; },
     ensureVoice,
+    get dm() { return dm; },
+    ensureDM,
     setCurrentChannel,
     get currentChannelId() { return currentChannelId; },
     get currentServerId() { return servers.currentServerId; }