Messaging

The session exposes high-level send methods and surfaces delivery progress through the messageState event. You supply the message id; the session tracks its lifecycle.

Direct messages

// You supply the message id and track state via events:
await session.sendDmText('c:<pubkeyhex>', 'hello', 'msg-1');

The message moves through states surfaced via the messageState event:

session.events.on('messageState', (id, state) => updateBubble(id, state));
// 'sending' → 'sent' (RESP_SENT) → 'ack' (PUSH_SEND_CONFIRMED)

Need retries? Use sendDmTextWithRetry:

await session.sendDmTextWithRetry('c:<pubkeyhex>', 'are you there?', 'msg-2');

Channel messages

const { ok, channelHash } = await session.sendChannelText('ch:General', 'hi all');

Optionally attribute heard repeater relays back to your message — this emits the messagePathHeard event:

if (ok && channelHash != null) {
  session.registerChannelSend({ messageId: 'msg-3', channelHash });
}

Reading message history

Messages are kept in the in-memory state model, keyed by conversation:

const messages = session.state.getMessagesForKey('c:<pubkeyhex>');

See Events & state for the full list of readers and events, and the API reference for exact signatures.