@pulsebeam/peer 0.0.21 → 0.1.0-rc.2

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import { RpcOptions, UnaryCall, ServerStreamingCall } from '@protobuf-ts/runtime-rpc';
 import { MessageType } from '@protobuf-ts/runtime';
+import { PreinitializedMapStore, ReadableAtom } from 'nanostores';
 
 /**
  * @generated from protobuf enum pulsebeam.v1.SdpKind
@@ -26,6 +27,407 @@ declare enum SdpKind {
      */
     ROLLBACK = 4
 }
+/**
+ * @generated from protobuf enum pulsebeam.v1.EventType
+ */
+declare enum EventType {
+    /**
+     * Default value, should always be the first
+     *
+     * @generated from protobuf enum value: UNKNOWN_EVENT = 0;
+     */
+    UNKNOWN_EVENT = 0,
+    /**
+     * --- Error Reporting Events (Range: 1000 - 1099) ---
+     *
+     * Base for error reporting events
+     *
+     * @generated from protobuf enum value: EVENT_ERROR_REPORTING_BASE = 1000;
+     */
+    EVENT_ERROR_REPORTING_BASE = 1000,
+    /**
+     * An error occurred with the signaling connection
+     *
+     * @generated from protobuf enum value: EVENT_ERROR_SIGNALING_CONNECTION_FAILED = 1001;
+     */
+    EVENT_ERROR_SIGNALING_CONNECTION_FAILED = 1001,
+    /**
+     * An error occurred with the ICE connection
+     *
+     * @generated from protobuf enum value: EVENT_ERROR_ICE_CONNECTION_FAILED = 1002;
+     */
+    EVENT_ERROR_ICE_CONNECTION_FAILED = 1002,
+    /**
+     * An error occurred while capturing audio
+     *
+     * @generated from protobuf enum value: EVENT_ERROR_MEDIA_CAPTURE_AUDIO_FAILED = 1003;
+     */
+    EVENT_ERROR_MEDIA_CAPTURE_AUDIO_FAILED = 1003,
+    /**
+     * An error occurred while capturing video
+     *
+     * @generated from protobuf enum value: EVENT_ERROR_MEDIA_CAPTURE_VIDEO_FAILED = 1004;
+     */
+    EVENT_ERROR_MEDIA_CAPTURE_VIDEO_FAILED = 1004,
+    /**
+     * An error occurred while capturing screen
+     *
+     * @generated from protobuf enum value: EVENT_ERROR_MEDIA_CAPTURE_SCREEN_FAILED = 1005;
+     */
+    EVENT_ERROR_MEDIA_CAPTURE_SCREEN_FAILED = 1005,
+    /**
+     * An error occurred during SDP negotiation
+     *
+     * @generated from protobuf enum value: EVENT_ERROR_SDP_NEGOTIATION_FAILED = 1006;
+     */
+    EVENT_ERROR_SDP_NEGOTIATION_FAILED = 1006,
+    /**
+     * A general or uncategorized error
+     *
+     * @generated from protobuf enum value: EVENT_ERROR_OTHER = 1099;
+     */
+    EVENT_ERROR_OTHER = 1099,
+    /**
+     * --- ICE Candidate Events (Range: 2000 - 2099) ---
+     *
+     * Base for ICE candidate related events
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_BASE = 2000;
+     */
+    EVENT_ICE_CANDIDATE_BASE = 2000,
+    /**
+     * ICE gathering process initiated
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_GATHERING_STARTED = 2001;
+     */
+    EVENT_ICE_CANDIDATE_GATHERING_STARTED = 2001,
+    /**
+     * A reflexive ICE candidate was discovered
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_LOCAL_REFLEXIVE_FOUND = 2002;
+     */
+    EVENT_ICE_CANDIDATE_LOCAL_REFLEXIVE_FOUND = 2002,
+    /**
+     * A host ICE candidate was discovered
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_LOCAL_HOST_FOUND = 2003;
+     */
+    EVENT_ICE_CANDIDATE_LOCAL_HOST_FOUND = 2003,
+    /**
+     * A server-reflexive (STUN) ICE candidate was discovered
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_LOCAL_SRFLX_FOUND = 2004;
+     */
+    EVENT_ICE_CANDIDATE_LOCAL_SRFLX_FOUND = 2004,
+    /**
+     * A peer-reflexive ICE candidate was discovered (less common)
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_LOCAL_PRFLX_FOUND = 2005;
+     */
+    EVENT_ICE_CANDIDATE_LOCAL_PRFLX_FOUND = 2005,
+    /**
+     * An ICE candidate from the remote peer was received
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_REMOTE_RECEIVED = 2006;
+     */
+    EVENT_ICE_CANDIDATE_REMOTE_RECEIVED = 2006,
+    /**
+     * A reflexive ICE candidate was discovered
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_REMOTE_REFLEXIVE_FOUND = 2007;
+     */
+    EVENT_ICE_CANDIDATE_REMOTE_REFLEXIVE_FOUND = 2007,
+    /**
+     * A host ICE candidate was discovered
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_REMOTE_HOST_FOUND = 2008;
+     */
+    EVENT_ICE_CANDIDATE_REMOTE_HOST_FOUND = 2008,
+    /**
+     * A server-reflexive (STUN) ICE candidate was discovered
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_REMOTE_SRFLX_FOUND = 2009;
+     */
+    EVENT_ICE_CANDIDATE_REMOTE_SRFLX_FOUND = 2009,
+    /**
+     * A peer-reflexive ICE candidate was discovered (less common)
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_REMOTE_PRFLX_FOUND = 2010;
+     */
+    EVENT_ICE_CANDIDATE_REMOTE_PRFLX_FOUND = 2010,
+    /**
+     * ICE candidate pair succeeded in establishing a connection
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_PAIRING_SUCCESS = 2011;
+     */
+    EVENT_ICE_CANDIDATE_PAIRING_SUCCESS = 2011,
+    /**
+     * ICE candidate pair failed to establish a connection
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_PAIRING_FAILED = 2012;
+     */
+    EVENT_ICE_CANDIDATE_PAIRING_FAILED = 2012,
+    /**
+     * The ICE connection state has changed (e.g., connecting, connected, failed)
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_CONNECTION_STATE_CHANGED = 2013;
+     */
+    EVENT_ICE_CANDIDATE_CONNECTION_STATE_CHANGED = 2013,
+    /**
+     * ICE gathering process finished
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_GATHERING_COMPLETED = 2014;
+     */
+    EVENT_ICE_CANDIDATE_GATHERING_COMPLETED = 2014,
+    /**
+     * The best ICE candidate pair was selected for communication
+     *
+     * @generated from protobuf enum value: EVENT_ICE_CANDIDATE_SELECTED_PAIR = 2015;
+     */
+    EVENT_ICE_CANDIDATE_SELECTED_PAIR = 2015,
+    /**
+     * --- Signaling Events (Range: 3000 - 3099) ---
+     *
+     * Base for signaling related events
+     *
+     * @generated from protobuf enum value: EVENT_SIGNALING_BASE = 3000;
+     */
+    EVENT_SIGNALING_BASE = 3000,
+    /**
+     * A signaling offer (e.g., SDP) was created locally
+     *
+     * @generated from protobuf enum value: EVENT_SIGNALING_OFFER_CREATED = 3001;
+     */
+    EVENT_SIGNALING_OFFER_CREATED = 3001,
+    /**
+     * A signaling offer was sent to the remote peer
+     *
+     * @generated from protobuf enum value: EVENT_SIGNALING_OFFER_SENT = 3002;
+     */
+    EVENT_SIGNALING_OFFER_SENT = 3002,
+    /**
+     * A signaling offer was received from the remote peer
+     *
+     * @generated from protobuf enum value: EVENT_SIGNALING_OFFER_RECEIVED = 3003;
+     */
+    EVENT_SIGNALING_OFFER_RECEIVED = 3003,
+    /**
+     * A signaling answer (e.g., SDP) was created locally
+     *
+     * @generated from protobuf enum value: EVENT_SIGNALING_ANSWER_CREATED = 3004;
+     */
+    EVENT_SIGNALING_ANSWER_CREATED = 3004,
+    /**
+     * A signaling answer was sent to the remote peer
+     *
+     * @generated from protobuf enum value: EVENT_SIGNALING_ANSWER_SENT = 3005;
+     */
+    EVENT_SIGNALING_ANSWER_SENT = 3005,
+    /**
+     * A signaling answer was received from the remote peer
+     *
+     * @generated from protobuf enum value: EVENT_SIGNALING_ANSWER_RECEIVED = 3006;
+     */
+    EVENT_SIGNALING_ANSWER_RECEIVED = 3006,
+    /**
+     * A signal indicating that negotiation is required
+     *
+     * @generated from protobuf enum value: EVENT_SIGNALING_NEGOTIATION_NEEDED = 3007;
+     */
+    EVENT_SIGNALING_NEGOTIATION_NEEDED = 3007,
+    /**
+     * A request to restart ICE negotiation was initiated
+     *
+     * @generated from protobuf enum value: EVENT_SIGNALING_ICE_RESTART_TRIGGERED = 3008;
+     */
+    EVENT_SIGNALING_ICE_RESTART_TRIGGERED = 3008,
+    /**
+     * Signaling connection established
+     *
+     * @generated from protobuf enum value: EVENT_SIGNALING_CONNECTED = 3009;
+     */
+    EVENT_SIGNALING_CONNECTED = 3009,
+    /**
+     * Signaling connection lost
+     *
+     * @generated from protobuf enum value: EVENT_SIGNALING_DISCONNECTED = 3010;
+     */
+    EVENT_SIGNALING_DISCONNECTED = 3010,
+    /**
+     * --- User Interaction Events (Range: 4000 - 4099) ---
+     *
+     * Base for user interaction events
+     *
+     * @generated from protobuf enum value: EVENT_USER_INTERACTION_BASE = 4000;
+     */
+    EVENT_USER_INTERACTION_BASE = 4000,
+    /**
+     * A user joined the communication session
+     *
+     * @generated from protobuf enum value: EVENT_USER_JOINED_SESSION = 4001;
+     */
+    EVENT_USER_JOINED_SESSION = 4001,
+    /**
+     * A user left the communication session
+     *
+     * @generated from protobuf enum value: EVENT_USER_LEFT_SESSION = 4002;
+     */
+    EVENT_USER_LEFT_SESSION = 4002,
+    /**
+     * A user muted their audio
+     *
+     * @generated from protobuf enum value: EVENT_USER_MUTED_AUDIO = 4003;
+     */
+    EVENT_USER_MUTED_AUDIO = 4003,
+    /**
+     * A user unmuted their audio
+     *
+     * @generated from protobuf enum value: EVENT_USER_UNMUTED_AUDIO = 4004;
+     */
+    EVENT_USER_UNMUTED_AUDIO = 4004,
+    /**
+     * A user muted their video
+     *
+     * @generated from protobuf enum value: EVENT_USER_MUTED_VIDEO = 4005;
+     */
+    EVENT_USER_MUTED_VIDEO = 4005,
+    /**
+     * A user unmuted their video
+     *
+     * @generated from protobuf enum value: EVENT_USER_UNMUTED_VIDEO = 4006;
+     */
+    EVENT_USER_UNMUTED_VIDEO = 4006,
+    /**
+     * A user started sharing their screen
+     *
+     * @generated from protobuf enum value: EVENT_USER_SCREEN_SHARE_STARTED = 4007;
+     */
+    EVENT_USER_SCREEN_SHARE_STARTED = 4007,
+    /**
+     * A user stopped sharing their screen
+     *
+     * @generated from protobuf enum value: EVENT_USER_SCREEN_SHARE_STOPPED = 4008;
+     */
+    EVENT_USER_SCREEN_SHARE_STOPPED = 4008,
+    /**
+     * A user sent a text message
+     *
+     * @generated from protobuf enum value: EVENT_USER_INPUT_TEXT_MESSAGE_SENT = 4009;
+     */
+    EVENT_USER_INPUT_TEXT_MESSAGE_SENT = 4009,
+    /**
+     * A user received a text message
+     *
+     * @generated from protobuf enum value: EVENT_USER_INPUT_TEXT_MESSAGE_RECEIVED = 4010;
+     */
+    EVENT_USER_INPUT_TEXT_MESSAGE_RECEIVED = 4010,
+    /**
+     * --- Media Handling Events (Range: 5000 - 5099) ---
+     *
+     * Base for media handling events
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_HANDLING_BASE = 5000;
+     */
+    EVENT_MEDIA_HANDLING_BASE = 5000,
+    /**
+     * A local audio track was added
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_LOCAL_AUDIO_TRACK_ADDED = 5001;
+     */
+    EVENT_MEDIA_LOCAL_AUDIO_TRACK_ADDED = 5001,
+    /**
+     * A local video track was added
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_LOCAL_VIDEO_TRACK_ADDED = 5002;
+     */
+    EVENT_MEDIA_LOCAL_VIDEO_TRACK_ADDED = 5002,
+    /**
+     * A remote audio track was added
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_REMOTE_AUDIO_TRACK_ADDED = 5003;
+     */
+    EVENT_MEDIA_REMOTE_AUDIO_TRACK_ADDED = 5003,
+    /**
+     * A remote video track was added
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_REMOTE_VIDEO_TRACK_ADDED = 5004;
+     */
+    EVENT_MEDIA_REMOTE_VIDEO_TRACK_ADDED = 5004,
+    /**
+     * A local audio track was removed
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_LOCAL_AUDIO_TRACK_REMOVED = 5005;
+     */
+    EVENT_MEDIA_LOCAL_AUDIO_TRACK_REMOVED = 5005,
+    /**
+     * A local video track was removed
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_LOCAL_VIDEO_TRACK_REMOVED = 5006;
+     */
+    EVENT_MEDIA_LOCAL_VIDEO_TRACK_REMOVED = 5006,
+    /**
+     * A remote audio track was removed
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_REMOTE_AUDIO_TRACK_REMOVED = 5007;
+     */
+    EVENT_MEDIA_REMOTE_AUDIO_TRACK_REMOVED = 5007,
+    /**
+     * A remote video track was removed
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_REMOTE_VIDEO_TRACK_REMOVED = 5008;
+     */
+    EVENT_MEDIA_REMOTE_VIDEO_TRACK_REMOVED = 5008,
+    /**
+     * Audio playback started
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_AUDIO_PLAYBACK_STARTED = 5009;
+     */
+    EVENT_MEDIA_AUDIO_PLAYBACK_STARTED = 5009,
+    /**
+     * Video playback started
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_VIDEO_PLAYBACK_STARTED = 5010;
+     */
+    EVENT_MEDIA_VIDEO_PLAYBACK_STARTED = 5010,
+    /**
+     * Audio playback stopped
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_AUDIO_PLAYBACK_STOPPED = 5011;
+     */
+    EVENT_MEDIA_AUDIO_PLAYBACK_STOPPED = 5011,
+    /**
+     * Video playback stopped
+     *
+     * @generated from protobuf enum value: EVENT_MEDIA_VIDEO_PLAYBACK_STOPPED = 5012;
+     */
+    EVENT_MEDIA_VIDEO_PLAYBACK_STOPPED = 5012,
+    /**
+     * --- ICE Connection Type (Range: 6000 - 6099) ---
+     *
+     * @generated from protobuf enum value: CONNECTION_TYPE_UNKNOWN = 6000;
+     */
+    CONNECTION_TYPE_UNKNOWN = 6000,
+    /**
+     * @generated from protobuf enum value: CONNECTION_TYPE_DIRECT = 6001;
+     */
+    CONNECTION_TYPE_DIRECT = 6001,
+    /**
+     * @generated from protobuf enum value: CONNECTION_TYPE_RELAY = 6002;
+     */
+    CONNECTION_TYPE_RELAY = 6002,
+    /**
+     * Server Reflexive
+     *
+     * @generated from protobuf enum value: CONNECTION_TYPE_SRFLX = 6003;
+     */
+    CONNECTION_TYPE_SRFLX = 6003,
+    /**
+     * Peer Reflexive
+     *
+     * @generated from protobuf enum value: CONNECTION_TYPE_PRFLX = 6004;
+     */
+    CONNECTION_TYPE_PRFLX = 6004
+}
 declare class PrepareReq$Type extends MessageType<PrepareReq> {
     constructor();
 }
@@ -450,6 +852,111 @@ interface AckRange {
  * @generated MessageType for protobuf message pulsebeam.v1.AckRange
  */
 declare const AckRange: AckRange$Type;
+declare class AnalyticsReportReq$Type extends MessageType<AnalyticsReportReq> {
+    constructor();
+}
+/**
+ * @generated from protobuf message pulsebeam.v1.AnalyticsReportReq
+ */
+interface AnalyticsReportReq {
+    /**
+     * @generated from protobuf field: repeated pulsebeam.v1.AnalyticsEvent events = 1;
+     */
+    events: AnalyticsEvent[];
+}
+/**
+ * @generated MessageType for protobuf message pulsebeam.v1.AnalyticsReportReq
+ */
+declare const AnalyticsReportReq: AnalyticsReportReq$Type;
+declare class AnalyticsEvent$Type extends MessageType<AnalyticsEvent> {
+    constructor();
+}
+/**
+ * @generated from protobuf message pulsebeam.v1.AnalyticsEvent
+ */
+interface AnalyticsEvent {
+    /**
+     * @generated from protobuf field: pulsebeam.v1.AnalyticsTags tags = 1;
+     */
+    tags?: AnalyticsTags;
+    /**
+     * @generated from protobuf field: repeated pulsebeam.v1.AnalyticsMetrics metrics = 2;
+     */
+    metrics: AnalyticsMetrics[];
+}
+/**
+ * @generated MessageType for protobuf message pulsebeam.v1.AnalyticsEvent
+ */
+declare const AnalyticsEvent: AnalyticsEvent$Type;
+declare class AnalyticsTags$Type extends MessageType<AnalyticsTags> {
+    constructor();
+}
+/**
+ * @generated from protobuf message pulsebeam.v1.AnalyticsTags
+ */
+interface AnalyticsTags {
+    /**
+     * @generated from protobuf field: pulsebeam.v1.PeerInfo src = 1;
+     */
+    src?: PeerInfo;
+    /**
+     * @generated from protobuf field: pulsebeam.v1.PeerInfo dst = 2;
+     */
+    dst?: PeerInfo;
+}
+/**
+ * @generated MessageType for protobuf message pulsebeam.v1.AnalyticsTags
+ */
+declare const AnalyticsTags: AnalyticsTags$Type;
+declare class AnalyticsMetrics$Type extends MessageType<AnalyticsMetrics> {
+    constructor();
+}
+/**
+ * "scaled" = trunc(X * 10^3)
+ *
+ * @generated from protobuf message pulsebeam.v1.AnalyticsMetrics
+ */
+interface AnalyticsMetrics {
+    /**
+     * @generated from protobuf field: sint64 timestamp_us = 1;
+     */
+    timestampUs: bigint;
+    /**
+     * @generated from protobuf field: optional pulsebeam.v1.EventType event_type = 2;
+     */
+    eventType?: EventType;
+    /**
+     * The overall derived quality score:
+     * - 80-100: excellent
+     * - 60-79: good
+     * - 40-59: fair
+     * - 20-39: poor
+     * - 0-19: bad
+     *
+     * @generated from protobuf field: optional sint64 quality_score = 3;
+     */
+    qualityScore?: bigint;
+    /**
+     * @generated from protobuf field: optional sint64 rtt_us = 4;
+     */
+    rttUs?: bigint;
+}
+/**
+ * @generated MessageType for protobuf message pulsebeam.v1.AnalyticsMetrics
+ */
+declare const AnalyticsMetrics: AnalyticsMetrics$Type;
+declare class AnalyticsReportResp$Type extends MessageType<AnalyticsReportResp> {
+    constructor();
+}
+/**
+ * @generated from protobuf message pulsebeam.v1.AnalyticsReportResp
+ */
+interface AnalyticsReportResp {
+}
+/**
+ * @generated MessageType for protobuf message pulsebeam.v1.AnalyticsReportResp
+ */
+declare const AnalyticsReportResp: AnalyticsReportResp$Type;
 
 /**
  * @generated from protobuf service pulsebeam.v1.Signaling
@@ -467,6 +974,10 @@ interface ISignalingClient {
      * @generated from protobuf rpc: Recv(pulsebeam.v1.RecvReq) returns (stream pulsebeam.v1.RecvResp);
      */
     recv(input: RecvReq, options?: RpcOptions): ServerStreamingCall<RecvReq, RecvResp>;
+    /**
+     * @generated from protobuf rpc: AnalyticsReport(pulsebeam.v1.AnalyticsReportReq) returns (pulsebeam.v1.AnalyticsReportResp);
+     */
+    analyticsReport(input: AnalyticsReportReq, options?: RpcOptions): UnaryCall<AnalyticsReportReq, AnalyticsReportResp>;
 }
 
 type LogObj = Record<string, unknown>;
@@ -490,6 +1001,184 @@ declare class Logger {
     sub(name: string, obj?: LogObj): Logger;
 }
 
+/**
+ * asleep is an async version of setTimeout with abortable signal.
+ * the function will resolve to false when aborted, meaning the delay will
+ * be less than the expected.
+ */
+declare function asleep(ms: number, signal?: AbortSignal): Promise<boolean>;
+
+declare const defaultAsleep: typeof asleep;
+declare const defaultRandUint32: (reserved: number) => number;
+declare const defaultIsRecoverable: (_err: unknown) => boolean;
+declare class Queue {
+    private map;
+    private emitted;
+    private unreliable;
+    private processing;
+    private readonly logger;
+    onmsg: (_: Message) => Promise<void>;
+    constructor(logger: Logger);
+    enqueue(msg: Message): void;
+    processNext(): Promise<void>;
+}
+interface TransportOptions {
+    readonly enableDiscovery: boolean;
+    readonly groupId: string;
+    readonly peerId: string;
+    readonly logger: Logger;
+    readonly asleep?: typeof defaultAsleep;
+    readonly randUint32?: typeof defaultRandUint32;
+    readonly isRecoverable?: typeof defaultIsRecoverable;
+}
+declare class Transport {
+    private readonly client;
+    readonly opts: TransportOptions;
+    readonly info: PeerInfo;
+    private streams;
+    private abort;
+    readonly logger: Logger;
+    readonly asleep: typeof defaultAsleep;
+    private readonly randUint32;
+    private readonly isRecoverable;
+    onstream: (_: Stream) => void;
+    onclosed: (_reason: string) => void;
+    constructor(client: ISignalingClient, opts: TransportOptions);
+    listen(): Promise<void>;
+    close(reason?: string): Promise<void>;
+    private handleControlMessage;
+    private handleMessages;
+    removeStream(stream: Stream): void;
+    connect(otherGroupId: string, otherPeerId: string, signal: AbortSignal): Promise<void>;
+    send(signal: AbortSignal, msg: Message): Promise<void>;
+    reportAnalytics(event: AnalyticsReportReq): Promise<void>;
+}
+declare class Stream {
+    private readonly transport;
+    readonly info: PeerInfo;
+    readonly other: PeerInfo;
+    readonly logger: Logger;
+    private abort;
+    recvq: Queue;
+    private lastSeqnum;
+    onsignal: (_: Signal) => Promise<void>;
+    onclosed: (_reason: string) => void;
+    constructor(transport: Transport, info: PeerInfo, other: PeerInfo, logger: Logger);
+    createSignal(...signals: AbortSignal[]): AbortSignal;
+    enqueue(msg: Message): void;
+    send(payload: MessagePayload, reliable: boolean, signal?: AbortSignal): Promise<void>;
+    private handleMessage;
+    close(reason?: string, skipBye?: boolean): Promise<void>;
+}
+
+/**
+ * The Session class is a wrapper around RTCPeerConnection designed to manage
+ *  WebRTC connections, signaling, and ICE candidates. It handles negotiation,
+ *  ICE restarts, signaling messages, and connection lifecycle events.
+ */
+declare class Session {
+    private readonly stream;
+    private pc;
+    private makingOffer;
+    private impolite;
+    private pendingCandidates;
+    private iceBatcher;
+    private readonly logger;
+    private abort;
+    private generationCounter;
+    private iceRestartCount;
+    private lastIceRestart;
+    private timers;
+    private _closeReason?;
+    private _connectionState;
+    private internalDataChannel;
+    private _metrics;
+    /**
+     * See {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/ondatachannel}
+     */
+    ondatachannel: RTCPeerConnection["ondatachannel"];
+    /**
+     * See {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/onconnectionstatechange}
+     */
+    onconnectionstatechange: RTCPeerConnection["onconnectionstatechange"];
+    /**
+     * Callback invoked when a new media track is added to the connection.
+     * See {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/ontrack}
+     */
+    ontrack: RTCPeerConnection["ontrack"];
+    /**
+     * Adds a media track to the connection.
+     * See {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/addTrack}
+     * @returns {RTCRtpSender} the newly created track
+     */
+    addTrack(track: MediaStreamTrack, ...streams: MediaStream[]): RTCRtpSender;
+    /**
+     * The getSenders() method of the RTCPeerConnection interface returns an array of RTCRtpSender objects,
+     * each of which represents the RTP sender responsible for transmitting one track's data.
+     * A sender object provides methods and properties for examining and controlling the encoding and transmission of the track's data.
+     * See {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/getSenders}
+     * @returns {RTCRtpSender[]}
+     */
+    getSenders(): RTCRtpSender[];
+    /**
+     * Removes a media track from the connection.
+     * See {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/removeTrack}
+     * @returns {void}
+     */
+    removeTrack(sender: RTCRtpSender): void;
+    /**
+     * Creates a data channel (useful for sending arbitrary data) through the connection.
+     * See {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/createDataChannel}
+     */
+    createDataChannel(...args: Parameters<RTCPeerConnection["createDataChannel"]>): RTCDataChannel;
+    getStats(...args: Parameters<RTCPeerConnection["getStats"]>): Promise<RTCStatsReport>;
+    /**
+     * Returns the current connection state of the underlying RTCPeerConnection
+     * See {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/connectionState}
+     * @returns {RTCPeerConnectionState}
+     */
+    get connectionState(): RTCPeerConnectionState;
+    /**
+     * If reason is available, returns the reason for the session being closed.
+     * @returns {string | undefined}
+     */
+    get closeReason(): string | undefined;
+    /**
+     * Retrieves the identifier of the other peer.
+     * @returns {string}
+     */
+    get other(): PeerInfo;
+    /**
+     * Closes the session, aborts pending tasks, and cleans up resources.
+     * Publishes events and logs.
+     * @param {string} [reason] - (optional) Your reason for closing the session.
+     * @returns {void}
+     * @example mysession.close("Normal closure");
+     */
+    close(reason?: string): void;
+    /**
+     * Creates a Session with the provided stream and
+     *  configs. Sets up event handlers, signaling, and ICE candidate
+     *  management.
+     * See {@link Session} For class responsibilities
+     * @param stream Represents the transport stream for signaling messages.
+     * @param config Configuration object for the RTCPeerConnection.
+     */
+    constructor(stream: Stream, config: RTCConfiguration);
+    private recordEvent;
+    collectMetrics(): Promise<AnalyticsEvent>;
+    private onnegotiationneeded;
+    private sendLocalIceCandidates;
+    /** internal @private */
+    private setConnectionState;
+    private setLocalDescription;
+    private triggerIceRestart;
+    private sendSignal;
+    private handleSignal;
+    private addCandidates;
+    private checkPendingCandidates;
+}
+
 /**
  * A high-level API for managing the peer-to-peer WebRTC connection. Provides
  *  access to lower-level {@link RTCPeerConnection} functionality. Including
@@ -586,6 +1275,11 @@ interface PeerOptionsFull {
      * @type {string} token
      */
     token: string;
+    /**
+     * By default, client analytics is enabled. To opt out, set this field to true.
+     * @type {boolean} disableAnalytics
+     */
+    disableAnalytics?: boolean;
     /**
      * (Optional) Base URL for API calls. Defaults to using our servers: "https://cloud.pulsebeam.dev/twirp".
      * @type {string | undefined} [baseUrl]
@@ -625,9 +1319,10 @@ type PeerState = "new" | "closed";
  * Peer is a mediator for signaling, connecting, and managing sessions.
  */
 declare class Peer {
+    private readonly opts;
     private transport;
     private readonly logger;
-    private sessions;
+    private _sessions;
     private _state;
     /**
      * Callback invoked when a new session is established.
@@ -650,6 +1345,7 @@ declare class Peer {
      * @param isRecoverable Function to determine if an error is recoverable.
      */
     constructor(logger: Logger, client: ISignalingClient, opts: PeerOptionsFull, isRecoverable: (_err: unknown) => boolean);
+    get sessions(): Session[];
     /**
      * Starts the peer, making it ready to establish connections.
      * Peers must be started before a connection can occur.
@@ -658,6 +1354,7 @@ declare class Peer {
      * @throws {Error} When the peer was previously closed.
      */
     start(): void;
+    analyticsLoop(): Promise<void>;
     /**
      * Closes the peer. Releases associated resources.
      * Signals to the AbortController passed to connect if connect was called.
@@ -699,4 +1396,33 @@ declare class Peer {
  */
 declare function createPeer(opts: PeerOptions): Promise<Peer>;
 
-export { type ISession, Peer, PeerInfo, type PeerOptions, type PeerOptionsFull, type PeerState, createPeer };
+type Value = string | number | undefined;
+type Key = string;
+type KVStore = Record<Key, Value>;
+interface RemotePeer {
+    info: PeerInfo;
+    streams: MediaStream[];
+    state: RTCPeerConnectionState;
+}
+declare class PeerStore {
+    readonly peer: Peer;
+    static readonly KV_NAMESPACE = "__crdt_kv";
+    readonly $kv: PreinitializedMapStore<KVStore> & object;
+    readonly $streams: PreinitializedMapStore<Record<string, MediaStream | undefined>> & object;
+    readonly $remotePeers: ReadableAtom<Record<string, RemotePeer>>;
+    readonly $state: ReadableAtom<PeerState>;
+    private readonly $_remotePeers;
+    private readonly $_state;
+    private readonly crdtStore;
+    private replicaId;
+    private sendChannels;
+    constructor(peer: Peer);
+    close(): void;
+    mute(disabled: boolean): void;
+    private set;
+    private notifyPeer;
+    private notifyPeers;
+    private receiveUpdate;
+}
+
+export { type ISession, type KVStore, type Key, Peer, PeerInfo, type PeerOptions, type PeerOptionsFull, type PeerState, PeerStore, type RemotePeer, type Value, createPeer };