Events & state

You don’t inject events or state — the session creates them and exposes them:

• session.events — a typed emitter. Subscribe with session.events.on('contacts', cb).
• session.state — the in-memory model. Read with session.state.getContacts(), getChannels(), getOwner(), getMessagesForKey(key), and friends.

Subscribe before connecting

Subscribe before driving the transport to connected so you observe the full handshake and initial sync:

import { Ports } from '@andyshinn/meshcore-ts';

session.events.on('owner', (owner) => console.log('this device:', owner?.name));
session.events.on('contacts', (contacts) => persistContacts(contacts));
session.events.on('syncProgress', (p) => console.log(p.phase, p.contacts));

// Named constants are available for every event key — both forms are equivalent:
session.events.on(Ports.EventName.RAW_PACKET, (pkt) => { /* … */ });
// equivalent to: session.events.on('rawPacket', (pkt) => { … })

session.start();
transport.setState('connected');

The events

transportState, rawPacket, channels, channelPresence, syncProgress, contacts, discovered, contactEvicted, contactDiscovered, contactsFull, contactObserved, messages, messageUpserted, messageState, messagePathHeard, owner, radioSettings, repeaterStatus, repeaterTelemetry, pathLearned, deviceIdentity, autoAddConfig, telemetryPolicy, gpsConfig, deviceInfo, deviceCapabilities.

All payloads are exported types — see Ports.EventMap in the API reference.

There is intentionally no generic error event. Specific recoverable conditions get their own dedicated event instead — for example contactsFull fires when the radio’s contact store is full and a new advert could not be auto-added. Adapters can bridge such events onto their own error/toast channel.

rawPacket carries the raw on-air bytes of each received LoRa packet; pair it with decodeOnAirPacket to structurally decode them — see Decoding on-air packets.

What the session can do

Beyond messaging, the session covers contacts & paths (getContactByKey, setContactPath, addContactToRadio, setContactFavourite, …), channels (setChannel, pickFreeSlot, deriveSecret, …), radio/device settings (setRadioParams, setAdvertName, setGpsConfig, reboot, …), time (getDeviceTime / setDeviceTime / syncDeviceTime), device admin & signing (exportPrivateKey, setDevicePin, factoryReset, signData), path diagnostics & raw frames (sendPathDiscoveryReq, sendRawData, …), and repeater administration (repeaterLogin, repeaterSendCli, repeaterTracePath, sendStatusReq, sendTelemetryReq, …).

See the API reference for the complete, typed surface.