@k256/sdk 0.2.1 → 0.3.0

package/dist/leader-ws/index.d.cts

@@ -0,0 +1,337 @@
+/**
+ * Leader Schedule WebSocket message types and interfaces
+ *
+ * The leader-schedule WS uses wincode binary protocol (matching K2 pattern).
+ * Wire format: [1-byte tag][wincode payload]
+ * Every decoded message has:
+ * - type: message type name
+ * - kind: "snapshot" (full state) | "diff" (merge into snapshot) | "event" (append-only)
+ * - key: primary key field for merging (on diff/event types)
+ * - data: typed payload
+ *
+ * @see https://k256.xyz/docs/leader-schedule
+ */
+/**
+ * Leader Schedule WebSocket channels
+ */
+declare const LeaderChannel: {
+    /** Full epoch leader schedule (on connect + epoch change) */
+    readonly LeaderSchedule: "leader_schedule";
+    /** Gossip peers (snapshot on connect, then diffs) */
+    readonly Gossip: "gossip";
+    /** Real-time slot updates with current leader */
+    readonly Slots: "slots";
+    /** Skip events, IP changes, routing health */
+    readonly Alerts: "alerts";
+};
+type LeaderChannelValue = typeof LeaderChannel[keyof typeof LeaderChannel];
+/** All available channels */
+declare const ALL_LEADER_CHANNELS: LeaderChannelValue[];
+/**
+ * Message kind — tells you how to consume the message
+ */
+type MessageKind = 'snapshot' | 'diff' | 'event';
+/** Protocol schema entry (included in subscribed handshake) */
+interface MessageSchemaEntry {
+    type: string;
+    tag: string;
+    kind: MessageKind;
+    key?: string;
+    description: string;
+}
+/** Subscribed response — connection handshake */
+interface LeaderSubscribedMessage {
+    type: 'subscribed';
+    data: {
+        channels: string[];
+        currentSlot: number;
+        epoch: number;
+        schema: MessageSchemaEntry[];
+    };
+}
+/** Full epoch leader schedule (snapshot — replaces previous) */
+interface LeaderScheduleMessage {
+    type: 'leader_schedule';
+    kind: 'snapshot';
+    data: {
+        epoch: number;
+        slotsInEpoch: number;
+        validators: number;
+        schedule: Array<{
+            identity: string;
+            slots: number;
+            slotIndices: number[];
+        }>;
+    };
+}
+/** Gossip peer data */
+interface GossipPeer {
+    identity: string;
+    tpuQuic: string | null;
+    tpuUdp: string | null;
+    tpuForwardsQuic: string | null;
+    tpuForwardsUdp: string | null;
+    tpuVote: string | null;
+    tpuVoteQuic: string | null;
+    gossipAddr: string | null;
+    shredVersion: number;
+    version: string;
+    activatedStake: number;
+    commission: number;
+    isDelinquent: boolean;
+    votePubkey: string;
+    lastVote: number;
+    rootSlot: number;
+    wallclock: number;
+}
+/** Full gossip peer list (snapshot — apply gossip_diff to keep current) */
+interface GossipSnapshotMessage {
+    type: 'gossip_snapshot';
+    kind: 'snapshot';
+    key: 'identity';
+    data: {
+        timestampMs: number;
+        count: number;
+        peers: GossipPeer[];
+    };
+}
+/** Incremental gossip changes (diff — merge into snapshot using identity) */
+interface GossipDiffMessage {
+    type: 'gossip_diff';
+    kind: 'diff';
+    key: 'identity';
+    data: {
+        timestampMs: number;
+        added: GossipPeer[];
+        removed: string[];
+        updated: GossipPeer[];
+    };
+}
+/** Current slot with leader identity (snapshot — each replaces previous) */
+interface SlotUpdateMessage {
+    type: 'slot_update';
+    kind: 'snapshot';
+    data: {
+        slot: number;
+        leader: string;
+        blockHeight: number;
+    };
+}
+/** Routing health summary (snapshot — each replaces previous) */
+interface RoutingHealthMessage {
+    type: 'routing_health';
+    kind: 'snapshot';
+    data: {
+        leadersTotal: number;
+        leadersInGossip: number;
+        leadersMissingGossip: string[];
+        leadersWithoutTpuQuic: string[];
+        leadersDelinquent: string[];
+        coverage: string;
+    };
+}
+/** Block production stats per validator (event — cumulative) */
+interface SkipEventMessage {
+    type: 'skip_event';
+    kind: 'event';
+    key: 'leader';
+    data: {
+        slot: number;
+        leader: string;
+        assigned: number;
+        produced: number;
+    };
+}
+/** Validator IP address change (event) */
+interface IpChangeMessage {
+    type: 'ip_change';
+    kind: 'event';
+    key: 'identity';
+    data: {
+        identity: string;
+        oldIp: string;
+        newIp: string;
+        timestampMs: number;
+    };
+}
+/** Server heartbeat (snapshot — each replaces previous) */
+interface LeaderHeartbeatMessage {
+    type: 'heartbeat';
+    kind: 'snapshot';
+    data: {
+        timestampMs: number;
+        currentSlot: number;
+        connectedClients: number;
+        gossipPeers: number;
+    };
+}
+/** Error from server */
+interface LeaderErrorMessage {
+    type: 'error';
+    data: {
+        message: string;
+    };
+}
+/** Union of all leader-schedule message types */
+type LeaderDecodedMessage = LeaderSubscribedMessage | LeaderScheduleMessage | GossipSnapshotMessage | GossipDiffMessage | SlotUpdateMessage | RoutingHealthMessage | SkipEventMessage | IpChangeMessage | LeaderHeartbeatMessage | LeaderErrorMessage;
+
+/**
+ * Leader Schedule WebSocket Client
+ *
+ * Connects to the K256 leader-schedule service via the Gateway.
+ * Binary mode by default (wincode protocol, matching K2 pattern).
+ * JSON mode opt-in via mode: 'json' (gateway decodes wincode to JSON).
+ *
+ * @example
+ * ```typescript
+ * import { LeaderWebSocketClient } from '@k256/sdk/leader-ws';
+ *
+ * const client = new LeaderWebSocketClient({
+ *   apiKey: 'your-api-key',
+ *   onSlotUpdate: (msg) => console.log('Slot:', msg.data.slot, 'Leader:', msg.data.leader),
+ *   onRoutingHealth: (msg) => console.log('Coverage:', msg.data.coverage),
+ *   onGossipDiff: (msg) => console.log('Peers changed:', msg.data.added.length, 'added'),
+ * });
+ *
+ * await client.connect();
+ * ```
+ */
+
+/**
+ * Connection state
+ */
+type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'closed';
+/**
+ * Leader WebSocket client configuration
+ */
+interface LeaderWebSocketClientConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Gateway URL (default: wss://gateway.k256.xyz/v1/leader-ws) */
+    url?: string;
+    /** Message format: 'binary' (default, efficient) or 'json' (debugging via gateway) */
+    mode?: 'binary' | 'json';
+    /** Channels to subscribe to (default: all channels) */
+    channels?: LeaderChannelValue[];
+    /** Enable automatic reconnection (default: true) */
+    autoReconnect?: boolean;
+    /** Initial reconnect delay in ms (default: 1000) */
+    reconnectDelayMs?: number;
+    /** Max reconnect delay in ms (default: 30000) */
+    maxReconnectDelayMs?: number;
+    /** Max reconnect attempts (default: Infinity) */
+    maxReconnectAttempts?: number;
+    /** Called when connection state changes */
+    onStateChange?: (state: ConnectionState, prevState: ConnectionState) => void;
+    /** Called on successful connection */
+    onConnect?: () => void;
+    /** Called on disconnection */
+    onDisconnect?: (code: number, reason: string, wasClean: boolean) => void;
+    /** Called on reconnection attempt */
+    onReconnecting?: (attempt: number, delayMs: number) => void;
+    /** Called on any error */
+    onError?: (error: LeaderWebSocketError) => void;
+    /** Called on subscription confirmed (includes protocol schema) */
+    onSubscribed?: (msg: LeaderSubscribedMessage) => void;
+    /** Called on full leader schedule (snapshot — replaces previous) */
+    onLeaderSchedule?: (msg: LeaderScheduleMessage) => void;
+    /** Called on full gossip peer snapshot (snapshot — key: identity) */
+    onGossipSnapshot?: (msg: GossipSnapshotMessage) => void;
+    /** Called on gossip diff (diff — merge into snapshot using identity) */
+    onGossipDiff?: (msg: GossipDiffMessage) => void;
+    /** Called on slot update (snapshot — each replaces previous) */
+    onSlotUpdate?: (msg: SlotUpdateMessage) => void;
+    /** Called on routing health (snapshot — each replaces previous) */
+    onRoutingHealth?: (msg: RoutingHealthMessage) => void;
+    /** Called on skip event (event — block production stats) */
+    onSkipEvent?: (msg: SkipEventMessage) => void;
+    /** Called on IP change event */
+    onIpChange?: (msg: IpChangeMessage) => void;
+    /** Called on heartbeat (every 10s) */
+    onHeartbeat?: (msg: LeaderHeartbeatMessage) => void;
+    /** Called on any message (raw) */
+    onMessage?: (msg: LeaderDecodedMessage) => void;
+}
+/**
+ * Error codes for leader WebSocket
+ */
+type LeaderErrorCode = 'CONNECTION_FAILED' | 'CONNECTION_LOST' | 'AUTH_FAILED' | 'SERVER_ERROR' | 'INVALID_MESSAGE' | 'RECONNECT_FAILED';
+/**
+ * WebSocket error with context
+ */
+declare class LeaderWebSocketError extends Error {
+    readonly code: LeaderErrorCode;
+    readonly closeCode?: number | undefined;
+    readonly closeReason?: string | undefined;
+    constructor(code: LeaderErrorCode, message: string, closeCode?: number | undefined, closeReason?: string | undefined);
+    get isRecoverable(): boolean;
+}
+/**
+ * Leader Schedule WebSocket Client
+ *
+ * Connects to the leader-schedule service via the Gateway.
+ * Binary mode by default (wincode protocol). JSON mode opt-in via gateway.
+ * Automatically subscribes to configured channels on connect/reconnect.
+ */
+declare class LeaderWebSocketClient {
+    private ws;
+    private readonly config;
+    private _state;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private isIntentionallyClosed;
+    /** Current connection state */
+    get state(): ConnectionState;
+    /** Whether currently connected */
+    get isConnected(): boolean;
+    constructor(config: LeaderWebSocketClientConfig);
+    /**
+     * Connect to the leader-schedule WebSocket
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the WebSocket
+     */
+    disconnect(): void;
+    /** Handle JSON text frame (from gateway JSON mode) */
+    private handleJsonMessage;
+    /** Dispatch a decoded message to typed callbacks */
+    private dispatchMessage;
+    private setState;
+    private scheduleReconnect;
+    private clearTimers;
+}
+
+/**
+ * Binary message decoder for Leader Schedule WebSocket protocol
+ *
+ * Decodes wincode messages from the leader-schedule server into typed objects.
+ * Matches K2 decoder pattern: manual DataView offset walking, little-endian.
+ *
+ * Wire format: [1 byte MessageType][N bytes wincode payload]
+ */
+
+/** Message type tag constants (must match leader-schedule server protocol.rs) */
+declare const LeaderMessageTag: {
+    readonly Subscribe: 1;
+    readonly Subscribed: 2;
+    readonly LeaderSchedule: 16;
+    readonly GossipSnapshot: 17;
+    readonly GossipDiff: 18;
+    readonly SlotUpdate: 19;
+    readonly RoutingHealth: 20;
+    readonly SkipEvent: 21;
+    readonly IpChange: 22;
+    readonly Heartbeat: 253;
+    readonly Ping: 254;
+    readonly Error: 255;
+};
+/**
+ * Decode a binary WebSocket message from the leader-schedule server.
+ *
+ * @param data - Raw binary data from WebSocket
+ * @returns Decoded message or null if unrecognized type
+ */
+declare function decodeLeaderMessage(data: ArrayBuffer): LeaderDecodedMessage | null;
+
+export { ALL_LEADER_CHANNELS, type ConnectionState, type GossipDiffMessage, type GossipPeer, type GossipSnapshotMessage, type IpChangeMessage, LeaderChannel, type LeaderChannelValue, type LeaderDecodedMessage, type LeaderErrorCode, type LeaderErrorMessage, type LeaderHeartbeatMessage, LeaderMessageTag, type LeaderScheduleMessage, type LeaderSubscribedMessage, LeaderWebSocketClient, type LeaderWebSocketClientConfig, LeaderWebSocketError, type MessageKind, type MessageSchemaEntry, type RoutingHealthMessage, type SkipEventMessage, type SlotUpdateMessage, decodeLeaderMessage };

package/dist/leader-ws/index.d.ts

@@ -0,0 +1,337 @@
+/**
+ * Leader Schedule WebSocket message types and interfaces
+ *
+ * The leader-schedule WS uses wincode binary protocol (matching K2 pattern).
+ * Wire format: [1-byte tag][wincode payload]
+ * Every decoded message has:
+ * - type: message type name
+ * - kind: "snapshot" (full state) | "diff" (merge into snapshot) | "event" (append-only)
+ * - key: primary key field for merging (on diff/event types)
+ * - data: typed payload
+ *
+ * @see https://k256.xyz/docs/leader-schedule
+ */
+/**
+ * Leader Schedule WebSocket channels
+ */
+declare const LeaderChannel: {
+    /** Full epoch leader schedule (on connect + epoch change) */
+    readonly LeaderSchedule: "leader_schedule";
+    /** Gossip peers (snapshot on connect, then diffs) */
+    readonly Gossip: "gossip";
+    /** Real-time slot updates with current leader */
+    readonly Slots: "slots";
+    /** Skip events, IP changes, routing health */
+    readonly Alerts: "alerts";
+};
+type LeaderChannelValue = typeof LeaderChannel[keyof typeof LeaderChannel];
+/** All available channels */
+declare const ALL_LEADER_CHANNELS: LeaderChannelValue[];
+/**
+ * Message kind — tells you how to consume the message
+ */
+type MessageKind = 'snapshot' | 'diff' | 'event';
+/** Protocol schema entry (included in subscribed handshake) */
+interface MessageSchemaEntry {
+    type: string;
+    tag: string;
+    kind: MessageKind;
+    key?: string;
+    description: string;
+}
+/** Subscribed response — connection handshake */
+interface LeaderSubscribedMessage {
+    type: 'subscribed';
+    data: {
+        channels: string[];
+        currentSlot: number;
+        epoch: number;
+        schema: MessageSchemaEntry[];
+    };
+}
+/** Full epoch leader schedule (snapshot — replaces previous) */
+interface LeaderScheduleMessage {
+    type: 'leader_schedule';
+    kind: 'snapshot';
+    data: {
+        epoch: number;
+        slotsInEpoch: number;
+        validators: number;
+        schedule: Array<{
+            identity: string;
+            slots: number;
+            slotIndices: number[];
+        }>;
+    };
+}
+/** Gossip peer data */
+interface GossipPeer {
+    identity: string;
+    tpuQuic: string | null;
+    tpuUdp: string | null;
+    tpuForwardsQuic: string | null;
+    tpuForwardsUdp: string | null;
+    tpuVote: string | null;
+    tpuVoteQuic: string | null;
+    gossipAddr: string | null;
+    shredVersion: number;
+    version: string;
+    activatedStake: number;
+    commission: number;
+    isDelinquent: boolean;
+    votePubkey: string;
+    lastVote: number;
+    rootSlot: number;
+    wallclock: number;
+}
+/** Full gossip peer list (snapshot — apply gossip_diff to keep current) */
+interface GossipSnapshotMessage {
+    type: 'gossip_snapshot';
+    kind: 'snapshot';
+    key: 'identity';
+    data: {
+        timestampMs: number;
+        count: number;
+        peers: GossipPeer[];
+    };
+}
+/** Incremental gossip changes (diff — merge into snapshot using identity) */
+interface GossipDiffMessage {
+    type: 'gossip_diff';
+    kind: 'diff';
+    key: 'identity';
+    data: {
+        timestampMs: number;
+        added: GossipPeer[];
+        removed: string[];
+        updated: GossipPeer[];
+    };
+}
+/** Current slot with leader identity (snapshot — each replaces previous) */
+interface SlotUpdateMessage {
+    type: 'slot_update';
+    kind: 'snapshot';
+    data: {
+        slot: number;
+        leader: string;
+        blockHeight: number;
+    };
+}
+/** Routing health summary (snapshot — each replaces previous) */
+interface RoutingHealthMessage {
+    type: 'routing_health';
+    kind: 'snapshot';
+    data: {
+        leadersTotal: number;
+        leadersInGossip: number;
+        leadersMissingGossip: string[];
+        leadersWithoutTpuQuic: string[];
+        leadersDelinquent: string[];
+        coverage: string;
+    };
+}
+/** Block production stats per validator (event — cumulative) */
+interface SkipEventMessage {
+    type: 'skip_event';
+    kind: 'event';
+    key: 'leader';
+    data: {
+        slot: number;
+        leader: string;
+        assigned: number;
+        produced: number;
+    };
+}
+/** Validator IP address change (event) */
+interface IpChangeMessage {
+    type: 'ip_change';
+    kind: 'event';
+    key: 'identity';
+    data: {
+        identity: string;
+        oldIp: string;
+        newIp: string;
+        timestampMs: number;
+    };
+}
+/** Server heartbeat (snapshot — each replaces previous) */
+interface LeaderHeartbeatMessage {
+    type: 'heartbeat';
+    kind: 'snapshot';
+    data: {
+        timestampMs: number;
+        currentSlot: number;
+        connectedClients: number;
+        gossipPeers: number;
+    };
+}
+/** Error from server */
+interface LeaderErrorMessage {
+    type: 'error';
+    data: {
+        message: string;
+    };
+}
+/** Union of all leader-schedule message types */
+type LeaderDecodedMessage = LeaderSubscribedMessage | LeaderScheduleMessage | GossipSnapshotMessage | GossipDiffMessage | SlotUpdateMessage | RoutingHealthMessage | SkipEventMessage | IpChangeMessage | LeaderHeartbeatMessage | LeaderErrorMessage;
+
+/**
+ * Leader Schedule WebSocket Client
+ *
+ * Connects to the K256 leader-schedule service via the Gateway.
+ * Binary mode by default (wincode protocol, matching K2 pattern).
+ * JSON mode opt-in via mode: 'json' (gateway decodes wincode to JSON).
+ *
+ * @example
+ * ```typescript
+ * import { LeaderWebSocketClient } from '@k256/sdk/leader-ws';
+ *
+ * const client = new LeaderWebSocketClient({
+ *   apiKey: 'your-api-key',
+ *   onSlotUpdate: (msg) => console.log('Slot:', msg.data.slot, 'Leader:', msg.data.leader),
+ *   onRoutingHealth: (msg) => console.log('Coverage:', msg.data.coverage),
+ *   onGossipDiff: (msg) => console.log('Peers changed:', msg.data.added.length, 'added'),
+ * });
+ *
+ * await client.connect();
+ * ```
+ */
+
+/**
+ * Connection state
+ */
+type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'closed';
+/**
+ * Leader WebSocket client configuration
+ */
+interface LeaderWebSocketClientConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Gateway URL (default: wss://gateway.k256.xyz/v1/leader-ws) */
+    url?: string;
+    /** Message format: 'binary' (default, efficient) or 'json' (debugging via gateway) */
+    mode?: 'binary' | 'json';
+    /** Channels to subscribe to (default: all channels) */
+    channels?: LeaderChannelValue[];
+    /** Enable automatic reconnection (default: true) */
+    autoReconnect?: boolean;
+    /** Initial reconnect delay in ms (default: 1000) */
+    reconnectDelayMs?: number;
+    /** Max reconnect delay in ms (default: 30000) */
+    maxReconnectDelayMs?: number;
+    /** Max reconnect attempts (default: Infinity) */
+    maxReconnectAttempts?: number;
+    /** Called when connection state changes */
+    onStateChange?: (state: ConnectionState, prevState: ConnectionState) => void;
+    /** Called on successful connection */
+    onConnect?: () => void;
+    /** Called on disconnection */
+    onDisconnect?: (code: number, reason: string, wasClean: boolean) => void;
+    /** Called on reconnection attempt */
+    onReconnecting?: (attempt: number, delayMs: number) => void;
+    /** Called on any error */
+    onError?: (error: LeaderWebSocketError) => void;
+    /** Called on subscription confirmed (includes protocol schema) */
+    onSubscribed?: (msg: LeaderSubscribedMessage) => void;
+    /** Called on full leader schedule (snapshot — replaces previous) */
+    onLeaderSchedule?: (msg: LeaderScheduleMessage) => void;
+    /** Called on full gossip peer snapshot (snapshot — key: identity) */
+    onGossipSnapshot?: (msg: GossipSnapshotMessage) => void;
+    /** Called on gossip diff (diff — merge into snapshot using identity) */
+    onGossipDiff?: (msg: GossipDiffMessage) => void;
+    /** Called on slot update (snapshot — each replaces previous) */
+    onSlotUpdate?: (msg: SlotUpdateMessage) => void;
+    /** Called on routing health (snapshot — each replaces previous) */
+    onRoutingHealth?: (msg: RoutingHealthMessage) => void;
+    /** Called on skip event (event — block production stats) */
+    onSkipEvent?: (msg: SkipEventMessage) => void;
+    /** Called on IP change event */
+    onIpChange?: (msg: IpChangeMessage) => void;
+    /** Called on heartbeat (every 10s) */
+    onHeartbeat?: (msg: LeaderHeartbeatMessage) => void;
+    /** Called on any message (raw) */
+    onMessage?: (msg: LeaderDecodedMessage) => void;
+}
+/**
+ * Error codes for leader WebSocket
+ */
+type LeaderErrorCode = 'CONNECTION_FAILED' | 'CONNECTION_LOST' | 'AUTH_FAILED' | 'SERVER_ERROR' | 'INVALID_MESSAGE' | 'RECONNECT_FAILED';
+/**
+ * WebSocket error with context
+ */
+declare class LeaderWebSocketError extends Error {
+    readonly code: LeaderErrorCode;
+    readonly closeCode?: number | undefined;
+    readonly closeReason?: string | undefined;
+    constructor(code: LeaderErrorCode, message: string, closeCode?: number | undefined, closeReason?: string | undefined);
+    get isRecoverable(): boolean;
+}
+/**
+ * Leader Schedule WebSocket Client
+ *
+ * Connects to the leader-schedule service via the Gateway.
+ * Binary mode by default (wincode protocol). JSON mode opt-in via gateway.
+ * Automatically subscribes to configured channels on connect/reconnect.
+ */
+declare class LeaderWebSocketClient {
+    private ws;
+    private readonly config;
+    private _state;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private isIntentionallyClosed;
+    /** Current connection state */
+    get state(): ConnectionState;
+    /** Whether currently connected */
+    get isConnected(): boolean;
+    constructor(config: LeaderWebSocketClientConfig);
+    /**
+     * Connect to the leader-schedule WebSocket
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the WebSocket
+     */
+    disconnect(): void;
+    /** Handle JSON text frame (from gateway JSON mode) */
+    private handleJsonMessage;
+    /** Dispatch a decoded message to typed callbacks */
+    private dispatchMessage;
+    private setState;
+    private scheduleReconnect;
+    private clearTimers;
+}
+
+/**
+ * Binary message decoder for Leader Schedule WebSocket protocol
+ *
+ * Decodes wincode messages from the leader-schedule server into typed objects.
+ * Matches K2 decoder pattern: manual DataView offset walking, little-endian.
+ *
+ * Wire format: [1 byte MessageType][N bytes wincode payload]
+ */
+
+/** Message type tag constants (must match leader-schedule server protocol.rs) */
+declare const LeaderMessageTag: {
+    readonly Subscribe: 1;
+    readonly Subscribed: 2;
+    readonly LeaderSchedule: 16;
+    readonly GossipSnapshot: 17;
+    readonly GossipDiff: 18;
+    readonly SlotUpdate: 19;
+    readonly RoutingHealth: 20;
+    readonly SkipEvent: 21;
+    readonly IpChange: 22;
+    readonly Heartbeat: 253;
+    readonly Ping: 254;
+    readonly Error: 255;
+};
+/**
+ * Decode a binary WebSocket message from the leader-schedule server.
+ *
+ * @param data - Raw binary data from WebSocket
+ * @returns Decoded message or null if unrecognized type
+ */
+declare function decodeLeaderMessage(data: ArrayBuffer): LeaderDecodedMessage | null;
+
+export { ALL_LEADER_CHANNELS, type ConnectionState, type GossipDiffMessage, type GossipPeer, type GossipSnapshotMessage, type IpChangeMessage, LeaderChannel, type LeaderChannelValue, type LeaderDecodedMessage, type LeaderErrorCode, type LeaderErrorMessage, type LeaderHeartbeatMessage, LeaderMessageTag, type LeaderScheduleMessage, type LeaderSubscribedMessage, LeaderWebSocketClient, type LeaderWebSocketClientConfig, LeaderWebSocketError, type MessageKind, type MessageSchemaEntry, type RoutingHealthMessage, type SkipEventMessage, type SlotUpdateMessage, decodeLeaderMessage };