icom-wlan-node 0.1.1 → 0.2.1

package/dist/rig/IcomControl.d.ts

@@ -1,4 +1,4 @@
-import { IcomRigOptions, RigEventEmitter, IcomMode, ConnectorDataMode, SetModeOptions, QueryOptions, SwrReading, AlcReading, WlanLevelReading, LevelMeterReading } from '../types';
+import { IcomRigOptions, RigEventEmitter, IcomMode, ConnectorDataMode, SetModeOptions, QueryOptions, SwrReading, AlcReading, WlanLevelReading, LevelMeterReading, SquelchStatusReading, AudioSquelchReading, OvfStatusReading, PowerLevelReading, CompLevelReading, VoltageReading, CurrentReading, ConnectionState, ConnectionMonitorConfig, ConnectionPhase, ConnectionMetrics } from '../types';
 import { IcomCiv } from './IcomCiv';
 import { IcomAudio } from './IcomAudio';
 export declare class IcomControl {
@@ -14,15 +14,58 @@ export declare class IcomControl {
     private tokenTimer?;
     private civAssembleBuf;
     private meterTimer?;
-    private loginReady;
-    private civReady;
-    private audioReady;
-    private resolveLoginReady;
-    private resolveCivReady;
-    private resolveAudioReady;
+    private connectionSession;
+    private nextSessionId;
+    private abortHandlers;
+    private monitorTimer?;
+    private monitorConfig;
     constructor(options: IcomRigOptions);
     get events(): RigEventEmitter;
+    /**
+     * Transition to a new connection phase with logging
+     * @private
+     */
+    private transitionTo;
+    /**
+     * Validate if a state transition is legal
+     * @private
+     */
+    private canTransitionTo;
+    /**
+     * Abort an ongoing connection attempt by session ID
+     * @private
+     */
+    private abortConnectionAttempt;
+    /**
+     * Connect to the rig
+     * Idempotent: multiple calls during CONNECTING phase are safe
+     * @throws Error if called during DISCONNECTING phase
+     */
     connect(): Promise<void>;
+    /**
+     * Internal connection implementation
+     * Uses local promises to avoid race conditions
+     * Uses phased timeout: 30s for overall, 10s for sub-sessions after login
+     * @param sessionId - Unique session ID to prevent race conditions
+     */
+    private _doConnect;
+    /**
+     * Create local promises for connection readiness
+     * This avoids race conditions with instance variables
+     * @param sessionId - Connection session ID for abort handler tracking
+     */
+    private createReadyPromises;
+    /**
+     * Start unified connection monitoring
+     * Monitors all three sessions from a single timer to avoid race conditions
+     * @private
+     */
+    private startUnifiedMonitoring;
+    /**
+     * Stop unified connection monitoring
+     * @private
+     */
+    private stopUnifiedMonitoring;
     disconnect(): Promise<void>;
     sendCiv(data: Buffer): void;
     /**
@@ -129,6 +172,83 @@ export declare class IcomControl {
      * await rig.setConnectorDataMode('WLAN');
      */
     setConnectorDataMode(mode: ConnectorDataMode | number): Promise<void>;
+    /**
+     * Read squelch status (noise/signal gate state)
+     * @param options - Query options (timeout in ms, default 3000)
+     * @returns Squelch status with raw value and boolean state
+     * @example
+     * const status = await rig.readSquelchStatus({ timeout: 2000 });
+     * if (status) {
+     *   console.log(`Squelch: ${status.isOpen ? 'OPEN' : 'CLOSED'}`);
+     * }
+     */
+    readSquelchStatus(options?: QueryOptions): Promise<SquelchStatusReading | null>;
+    /**
+     * Read audio squelch state
+     * @param options - Query options (timeout in ms, default 3000)
+     * @returns Audio squelch status with raw value and boolean state
+     * @example
+     * const squelch = await rig.readAudioSquelch({ timeout: 2000 });
+     * if (squelch) {
+     *   console.log(`Audio Squelch: ${squelch.isOpen ? 'OPEN' : 'CLOSED'}`);
+     * }
+     */
+    readAudioSquelch(options?: QueryOptions): Promise<AudioSquelchReading | null>;
+    /**
+     * Read OVF (ADC overload) status
+     * @param options - Query options (timeout in ms, default 3000)
+     * @returns OVF status with raw value and boolean overload flag
+     * @example
+     * const ovf = await rig.readOvfStatus({ timeout: 2000 });
+     * if (ovf) {
+     *   console.log(`ADC: ${ovf.isOverload ? '⚠️ OVERLOAD' : '✓ OK'}`);
+     * }
+     */
+    readOvfStatus(options?: QueryOptions): Promise<OvfStatusReading | null>;
+    /**
+     * Read power output level during transmission
+     * @param options - Query options (timeout in ms, default 3000)
+     * @returns Power level with raw value and percentage
+     * @example
+     * const power = await rig.readPowerLevel({ timeout: 2000 });
+     * if (power) {
+     *   console.log(`Power: ${power.percent.toFixed(1)}%`);
+     * }
+     */
+    readPowerLevel(options?: QueryOptions): Promise<PowerLevelReading | null>;
+    /**
+     * Read COMP (voice compression) level during transmission
+     * @param options - Query options (timeout in ms, default 3000)
+     * @returns Compression level with raw value and percentage
+     * @example
+     * const comp = await rig.readCompLevel({ timeout: 2000 });
+     * if (comp) {
+     *   console.log(`COMP: ${comp.percent.toFixed(1)}%`);
+     * }
+     */
+    readCompLevel(options?: QueryOptions): Promise<CompLevelReading | null>;
+    /**
+     * Read power supply voltage
+     * @param options - Query options (timeout in ms, default 3000)
+     * @returns Voltage reading with raw value and volts
+     * @example
+     * const voltage = await rig.readVoltage({ timeout: 2000 });
+     * if (voltage) {
+     *   console.log(`Voltage: ${voltage.volts.toFixed(2)}V`);
+     * }
+     */
+    readVoltage(options?: QueryOptions): Promise<VoltageReading | null>;
+    /**
+     * Read power supply current draw
+     * @param options - Query options (timeout in ms, default 3000)
+     * @returns Current reading with raw value and amperes
+     * @example
+     * const current = await rig.readCurrent({ timeout: 2000 });
+     * if (current) {
+     *   console.log(`Current: ${current.amps.toFixed(2)}A`);
+     * }
+     */
+    readCurrent(options?: QueryOptions): Promise<CurrentReading | null>;
     private static isReplyOf;
     /**
      * Extract meter data from CI-V response frame
@@ -152,4 +272,62 @@ export declare class IcomControl {
     private stopMeterPolling;
     private onAudioData;
     private sendConnectionRequest;
+    /**
+     * Configure unified connection monitoring
+     * @param config - Monitoring configuration options
+     * @example
+     * rig.configureMonitoring({ timeout: 10000, checkInterval: 2000, autoReconnect: true });
+     */
+    configureMonitoring(config: ConnectionMonitorConfig): void;
+    /**
+     * Get current connection state for all sessions
+     * @returns Object with connection state for each session
+     */
+    getConnectionState(): {
+        control: ConnectionState;
+        civ: ConnectionState;
+        audio: ConnectionState;
+    };
+    /**
+     * Check if any session has lost connection
+     * @returns true if any session is disconnected
+     */
+    isAnySessionDisconnected(): boolean;
+    /**
+     * Handle connection lost event from a session
+     * Simplified strategy: any session loss triggers full reconnect
+     * @private
+     */
+    private handleConnectionLost;
+    /**
+     * Schedule a full reconnection (all sessions)
+     * Uses simple while loop with exponential backoff
+     * @private
+     */
+    private scheduleFullReconnect;
+    /**
+     * Connect with timeout (helper for reconnection)
+     * @private
+     */
+    private connectWithTimeout;
+    /**
+     * Sleep helper (returns a Promise)
+     * @private
+     */
+    private sleep;
+    /**
+     * Calculate reconnect delay using exponential backoff
+     * @private
+     */
+    private calculateReconnectDelay;
+    /**
+     * Get current connection phase
+     * @returns Current connection phase (IDLE, CONNECTING, CONNECTED, etc.)
+     */
+    getConnectionPhase(): ConnectionPhase;
+    /**
+     * Get detailed connection metrics for monitoring and diagnostics
+     * @returns Connection metrics including phase, uptime, session states
+     */
+    getConnectionMetrics(): ConnectionMetrics;
 }