@nasaspaceflight/atem-connection 3.9.0

package/dist/lib/atemSocket.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AtemSocket = void 0;
+const eventemitter3_1 = require("eventemitter3");
+const atemCommandParser_1 = require("./atemCommandParser");
+const exitHook = require("exit-hook");
+const commands_1 = require("../commands");
+const atem_1 = require("../atem");
+const atemSocketChild_1 = require("./atemSocketChild");
+const packetBuilder_1 = require("./packetBuilder");
+class AtemSocket extends eventemitter3_1.EventEmitter {
+    constructor(options) {
+        super();
+        this._commandParser = new atemCommandParser_1.CommandParser();
+        this._nextPacketTrackingId = 0;
+        this._isDisconnecting = false;
+        this._port = atem_1.DEFAULT_PORT;
+        this._address = options.address;
+        this._port = options.port;
+        this._debugBuffers = options.debugBuffers;
+        this._maxPacketSize = options.maxPacketSize;
+    }
+    async connect(address, port) {
+        this._isDisconnecting = false;
+        if (address) {
+            this._address = address;
+        }
+        if (port) {
+            this._port = port;
+        }
+        if (!this._socketProcess) {
+            this._createSocketProcess();
+            if (this._isDisconnecting || !this._socketProcess) {
+                throw new Error('Disconnecting');
+            }
+        }
+        await this._socketProcess.connect(this._address, this._port);
+    }
+    async destroy() {
+        await this.disconnect();
+        this._socketProcess = undefined;
+        if (this._exitUnsubscribe) {
+            this._exitUnsubscribe();
+            this._exitUnsubscribe = undefined;
+        }
+    }
+    async disconnect() {
+        this._isDisconnecting = true;
+        if (this._socketProcess) {
+            await this._socketProcess.disconnect();
+        }
+    }
+    get nextPacketTrackingId() {
+        if (this._nextPacketTrackingId >= Number.MAX_SAFE_INTEGER) {
+            this._nextPacketTrackingId = 0;
+        }
+        return ++this._nextPacketTrackingId;
+    }
+    async sendCommands(commands) {
+        if (!this._socketProcess)
+            throw new Error('Socket process is not open');
+        const maxPacketSize = this._maxPacketSize - 12; // MTU minus ATEM header
+        const packetBuilder = new packetBuilder_1.PacketBuilder(maxPacketSize, this._commandParser.version);
+        for (const cmd of commands) {
+            packetBuilder.addCommand(cmd);
+        }
+        const packets = packetBuilder.getPackets().map((buffer) => ({
+            payloadLength: buffer.length,
+            payloadHex: buffer.toString('hex'),
+            trackingId: this.nextPacketTrackingId,
+        }));
+        if (this._debugBuffers)
+            this.emit('debug', `PAYLOAD PACKETS ${JSON.stringify(packets)}`);
+        if (packets.length > 0) {
+            this._socketProcess.sendPackets(packets);
+        }
+        return packets.map((packet) => packet.trackingId);
+    }
+    _createSocketProcess() {
+        this._socketProcess = new atemSocketChild_1.AtemSocketChild({
+            address: this._address,
+            port: this._port,
+            debugBuffers: this._debugBuffers,
+        }, async () => {
+            this.emit('disconnect');
+        }, async (message) => {
+            this.emit('info', message);
+        }, async (payload) => {
+            this._parseCommands(Buffer.from(payload));
+        }, async (ids) => {
+            this.emit('ackPackets', ids.map((id) => id.trackingId));
+        });
+        this._exitUnsubscribe = exitHook(() => {
+            this.destroy().catch(() => null);
+        });
+    }
+    _parseCommands(buffer) {
+        const parsedCommands = [];
+        while (buffer.length > 8) {
+            const length = buffer.readUInt16BE(0);
+            const name = buffer.toString('ascii', 4, 8);
+            if (length < 8) {
+                // Commands are never less than 8, as that is the header
+                break;
+            }
+            const cmdConstructor = this._commandParser.commandFromRawName(name);
+            if (cmdConstructor && typeof cmdConstructor.deserialize === 'function') {
+                try {
+                    const cmd = cmdConstructor.deserialize(buffer.subarray(8, length), this._commandParser.version);
+                    if (cmd instanceof commands_1.VersionCommand) {
+                        // init started
+                        this._commandParser.version = cmd.properties.version;
+                    }
+                    parsedCommands.push(cmd);
+                }
+                catch (e) {
+                    this.emit('error', `Failed to deserialize command: ${cmdConstructor.constructor.name}: ${e}`);
+                }
+            }
+            else {
+                this.emit('debug', `Unknown command ${name} (${length}b)`);
+            }
+            // Trim the buffer
+            buffer = buffer.subarray(length);
+        }
+        if (parsedCommands.length > 0) {
+            this.emit('receivedCommands', parsedCommands);
+        }
+        return parsedCommands;
+    }
+}
+exports.AtemSocket = AtemSocket;
+//# sourceMappingURL=atemSocket.js.map

package/dist/lib/atemSocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atemSocket.js","sourceRoot":"","sources":["../../src/lib/atemSocket.ts"],"names":[],"mappings":"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"}

package/dist/lib/atemSocketChild.d.ts

@@ -0,0 +1,69 @@
+/// <reference types="node" />
+export declare const COMMAND_CONNECT_HELLO: Buffer;
+export declare enum ConnectionState {
+    Closed = 0,
+    SynSent = 1,
+    Established = 2,
+    /** Disconnected by the user (by calling `disconnect()`) */
+    Disconnected = 3
+}
+export declare enum PacketFlag {
+    AckRequest = 1,
+    NewSessionId = 2,
+    IsRetransmit = 4,
+    RetransmitRequest = 8,
+    AckReply = 16
+}
+export interface OutboundPacketInfo {
+    payloadLength: number;
+    payloadHex: string;
+    trackingId: number;
+}
+export declare class AtemSocketChild {
+    private readonly _debugBuffers;
+    private _connectionState;
+    private _reconnectTimer;
+    private _retransmitTimer;
+    private _nextSendPacketId;
+    private _sessionId;
+    private _address;
+    private _port;
+    private _socket;
+    private _lastReceivedAt;
+    private _lastReceivedPacketId;
+    private _inFlight;
+    private _ackTimer;
+    private _receivedWithoutAck;
+    private readonly onDisconnect;
+    private readonly onLog;
+    private readonly onCommandsReceived;
+    private readonly onPacketsAcknowledged;
+    constructor(options: {
+        address: string;
+        port: number;
+        debugBuffers: boolean;
+    }, onDisconnect: () => Promise<void>, onLog: (message: string) => Promise<void>, onCommandReceived: (payload: Buffer, packetId: number) => Promise<void>, onCommandAcknowledged: (ids: Array<{
+        packetId: number;
+        trackingId: number;
+    }>) => Promise<void>);
+    private startTimers;
+    connect(address: string, port: number): Promise<void>;
+    disconnect(): Promise<void>;
+    private _clearTimers;
+    private restartConnection;
+    private log;
+    sendPackets(packets: OutboundPacketInfo[]): void;
+    private sendPacket;
+    private _recreateSocket;
+    private _closeSocket;
+    private _createSocket;
+    private _isPacketCoveredByAck;
+    private _receivePacket;
+    private _sendPacket;
+    private _sendOrQueueAck;
+    private _sendAck;
+    private _retransmitFrom;
+    private _triggerRetransmitTimer;
+    private _checkForRetransmit;
+}
+//# sourceMappingURL=atemSocketChild.d.ts.map

package/dist/lib/atemSocketChild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atemSocketChild.d.ts","sourceRoot":"","sources":["../../src/lib/atemSocketChild.ts"],"names":[],"mappings":";AAcA,eAAO,MAAM,qBAAqB,QAGhC,CAAA;AAEF,oBAAY,eAAe;IAC1B,MAAM,IAAO;IACb,OAAO,IAAO;IACd,WAAW,IAAO;IAClB,2DAA2D;IAC3D,YAAY,IAAO;CACnB;AAED,oBAAY,UAAU;IACrB,UAAU,IAAO;IACjB,YAAY,IAAO;IACnB,YAAY,IAAO;IACnB,iBAAiB,IAAO;IACxB,QAAQ,KAAO;CACf;AAUD,MAAM,WAAW,kBAAkB;IAClC,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,gBAAgB,CAA4B;IAEpD,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,UAAU,CAAI;IAEtB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,OAAO,CAAQ;IAEvB,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,qBAAqB,CAAI;IACjC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,mBAAmB,CAAI;IAE/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsD;IACzF,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAyE;gBAG9G,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,EACjE,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACjC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EACzC,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EACvE,qBAAqB,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC;IAc/F,OAAO,CAAC,WAAW;IAeN,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASxC,OAAO,CAAC,YAAY;YAWN,iBAAiB;IAyB/B,OAAO,CAAC,GAAG;IAKJ,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAMvD,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,eAAe;YAOT,YAAY;IAgB1B,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,cAAc;IA0EtB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,QAAQ;YAUF,eAAe;IA4B7B,OAAO,CAAC,uBAAuB;YAmBjB,mBAAmB;CAyBjC"}

package/dist/lib/atemSocketChild.js

@@ -0,0 +1,347 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AtemSocketChild = exports.PacketFlag = exports.ConnectionState = exports.COMMAND_CONNECT_HELLO = void 0;
+/**
+ * Note: this file wants as few imports as possible, as it gets loaded in a worker-thread and may require its own webpack bundle
+ */
+const dgram_1 = require("dgram");
+const perf_hooks_1 = require("perf_hooks");
+const IN_FLIGHT_TIMEOUT = 60; // ms
+const CONNECTION_TIMEOUT = 5000; // ms
+const CONNECTION_RETRY_INTERVAL = 1000; // ms
+const RETRANSMIT_INTERVAL = 10; // ms
+const MAX_PACKET_RETRIES = 10;
+const MAX_PACKET_ID = 1 << 15; // Atem expects 15 not 16 bits before wrapping
+const MAX_PACKET_PER_ACK = 16;
+exports.COMMAND_CONNECT_HELLO = Buffer.from([
+    0x10, 0x14, 0x53, 0xab, 0x00, 0x00, 0x00, 0x00, 0x00, 0x3a, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00,
+]);
+var ConnectionState;
+(function (ConnectionState) {
+    ConnectionState[ConnectionState["Closed"] = 0] = "Closed";
+    ConnectionState[ConnectionState["SynSent"] = 1] = "SynSent";
+    ConnectionState[ConnectionState["Established"] = 2] = "Established";
+    /** Disconnected by the user (by calling `disconnect()`) */
+    ConnectionState[ConnectionState["Disconnected"] = 3] = "Disconnected";
+})(ConnectionState = exports.ConnectionState || (exports.ConnectionState = {}));
+var PacketFlag;
+(function (PacketFlag) {
+    PacketFlag[PacketFlag["AckRequest"] = 1] = "AckRequest";
+    PacketFlag[PacketFlag["NewSessionId"] = 2] = "NewSessionId";
+    PacketFlag[PacketFlag["IsRetransmit"] = 4] = "IsRetransmit";
+    PacketFlag[PacketFlag["RetransmitRequest"] = 8] = "RetransmitRequest";
+    PacketFlag[PacketFlag["AckReply"] = 16] = "AckReply";
+})(PacketFlag = exports.PacketFlag || (exports.PacketFlag = {}));
+class AtemSocketChild {
+    constructor(options, onDisconnect, onLog, onCommandReceived, onCommandAcknowledged) {
+        this._connectionState = ConnectionState.Closed;
+        this._nextSendPacketId = 1;
+        this._sessionId = 0;
+        this._lastReceivedAt = perf_hooks_1.performance.now();
+        this._lastReceivedPacketId = 0;
+        this._inFlight = [];
+        this._receivedWithoutAck = 0;
+        this._debugBuffers = options.debugBuffers;
+        this._address = options.address;
+        this._port = options.port;
+        this.onDisconnect = onDisconnect;
+        this.onLog = onLog;
+        this.onCommandsReceived = onCommandReceived;
+        this.onPacketsAcknowledged = onCommandAcknowledged;
+        this._socket = this._createSocket();
+    }
+    startTimers() {
+        if (!this._reconnectTimer) {
+            this._reconnectTimer = setInterval(() => {
+                if (this._lastReceivedAt + CONNECTION_TIMEOUT > perf_hooks_1.performance.now()) {
+                    // We heard from the atem recently
+                    return;
+                }
+                this.restartConnection().catch((e) => {
+                    this.log(`Reconnect failed: ${e}`);
+                });
+            }, CONNECTION_RETRY_INTERVAL);
+        }
+    }
+    async connect(address, port) {
+        this._address = address;
+        this._port = port;
+        return this.restartConnection();
+    }
+    async disconnect() {
+        this._clearTimers();
+        return this._closeSocket().then(async () => {
+            this._connectionState = ConnectionState.Disconnected;
+            return this.onDisconnect();
+        });
+    }
+    _clearTimers() {
+        if (this._retransmitTimer) {
+            clearTimeout(this._retransmitTimer);
+            this._retransmitTimer = undefined;
+        }
+        if (this._reconnectTimer) {
+            clearInterval(this._reconnectTimer);
+            this._reconnectTimer = undefined;
+        }
+    }
+    async restartConnection() {
+        this._clearTimers();
+        // This includes a 'disconnect'
+        if (this._connectionState === ConnectionState.Established) {
+            this._connectionState = ConnectionState.Closed;
+            this._recreateSocket();
+            await this.onDisconnect();
+        }
+        else if (this._connectionState === ConnectionState.Disconnected) {
+            this._createSocket();
+        }
+        // Reset connection
+        this._nextSendPacketId = 1;
+        this._sessionId = 0;
+        this._inFlight = [];
+        this.log('reconnect');
+        this.startTimers();
+        // Try doing reconnect
+        this._sendPacket(exports.COMMAND_CONNECT_HELLO);
+        this._connectionState = ConnectionState.SynSent;
+    }
+    log(message) {
+        // tslint:disable-next-line: no-floating-promises
+        void this.onLog(message);
+    }
+    sendPackets(packets) {
+        for (const packet of packets) {
+            this.sendPacket(packet.payloadLength, packet.payloadHex, packet.trackingId);
+        }
+    }
+    sendPacket(payloadLength, payloadHex, trackingId) {
+        const packetId = this._nextSendPacketId++;
+        if (this._nextSendPacketId >= MAX_PACKET_ID)
+            this._nextSendPacketId = 0;
+        const opcode = PacketFlag.AckRequest << 11;
+        const buffer = Buffer.alloc(12 + payloadLength, 0);
+        buffer.writeUInt16BE(opcode | (payloadLength + 12), 0); // Opcode & Length
+        buffer.writeUInt16BE(this._sessionId, 2);
+        buffer.writeUInt16BE(packetId, 10);
+        buffer.write(payloadHex, 12, payloadLength, 'hex');
+        this._sendPacket(buffer);
+        this._inFlight.push({
+            packetId,
+            trackingId,
+            lastSent: perf_hooks_1.performance.now(),
+            payload: buffer,
+            resent: 0,
+        });
+        this._triggerRetransmitTimer();
+    }
+    _recreateSocket() {
+        this._closeSocket().catch((_err) => {
+            // do nothing because it always resolves
+        });
+        return this._createSocket();
+    }
+    async _closeSocket() {
+        if (this._ackTimer) {
+            clearTimeout(this._ackTimer);
+            delete this._ackTimer;
+        }
+        return new Promise((resolve) => {
+            try {
+                this._socket.close(() => resolve());
+            }
+            catch (err) {
+                this.log(`Error closing socket: ${err}`);
+                resolve();
+            }
+        });
+    }
+    _createSocket() {
+        this._socket = (0, dgram_1.createSocket)('udp4');
+        this._socket.bind();
+        this._socket.on('message', (packet, rinfo) => this._receivePacket(packet, rinfo));
+        this._socket.on('error', (err) => {
+            this.log(`Connection error: ${err}`);
+            if (this._connectionState === ConnectionState.Established) {
+                // If connection is open, then restart. Otherwise the reconnectTimer will handle it
+                this.restartConnection().catch((e) => {
+                    this.log(`Failed to restartConnection: ${e?.message ?? e}`);
+                });
+            }
+        });
+        return this._socket;
+    }
+    _isPacketCoveredByAck(ackId, packetId) {
+        const tolerance = MAX_PACKET_ID / 2;
+        const pktIsShortlyBefore = packetId < ackId && packetId + tolerance > ackId;
+        const pktIsShortlyAfter = packetId > ackId && packetId < ackId + tolerance;
+        const pktIsBeforeWrap = packetId > ackId + tolerance;
+        return packetId === ackId || ((pktIsShortlyBefore || pktIsBeforeWrap) && !pktIsShortlyAfter);
+    }
+    _receivePacket(packet, rinfo) {
+        if (this._debugBuffers)
+            this.log(`RECV ${packet.toString('hex')}`);
+        this._lastReceivedAt = perf_hooks_1.performance.now();
+        const length = packet.readUInt16BE(0) & 0x07ff;
+        if (length !== rinfo.size)
+            return;
+        const flags = packet.readUInt8(0) >> 3;
+        this._sessionId = packet.readUInt16BE(2);
+        const remotePacketId = packet.readUInt16BE(10);
+        // Send hello answer packet when receive connect flags
+        if (flags & PacketFlag.NewSessionId) {
+            this._connectionState = ConnectionState.Established;
+            this._lastReceivedPacketId = remotePacketId;
+            this._sendAck(remotePacketId);
+            return;
+        }
+        const ps = [];
+        if (this._connectionState === ConnectionState.Established) {
+            // Device asked for retransmit
+            if (flags & PacketFlag.RetransmitRequest) {
+                const fromPacketId = packet.readUInt16BE(6);
+                this.log(`Retransmit request: ${fromPacketId}`);
+                ps.push(this._retransmitFrom(fromPacketId));
+            }
+            // Got a packet that needs an ack
+            if (flags & PacketFlag.AckRequest) {
+                // Check if it next in the sequence
+                if (remotePacketId === (this._lastReceivedPacketId + 1) % MAX_PACKET_ID) {
+                    this._lastReceivedPacketId = remotePacketId;
+                    this._sendOrQueueAck();
+                    // It might have commands
+                    if (length > 12) {
+                        ps.push(this.onCommandsReceived(packet.subarray(12), remotePacketId));
+                    }
+                }
+                else if (this._isPacketCoveredByAck(this._lastReceivedPacketId, remotePacketId)) {
+                    // We got a retransmit of something we have already acked, so reack it
+                    this._sendOrQueueAck();
+                }
+            }
+            // Device ack'ed our packet
+            if (flags & PacketFlag.AckReply) {
+                const ackPacketId = packet.readUInt16BE(4);
+                const ackedCommands = [];
+                this._inFlight = this._inFlight.filter((pkt) => {
+                    if (this._isPacketCoveredByAck(ackPacketId, pkt.packetId)) {
+                        ackedCommands.push({
+                            packetId: pkt.packetId,
+                            trackingId: pkt.trackingId,
+                        });
+                        return false;
+                    }
+                    else {
+                        // Not acked yet
+                        return true;
+                    }
+                });
+                this._triggerRetransmitTimer();
+                ps.push(this.onPacketsAcknowledged(ackedCommands));
+                // this.log(`${Date.now()} Got ack ${ackPacketId} Remaining=${this._inFlight.length}`)
+            }
+        }
+        Promise.all(ps).catch((e) => {
+            this.log(`Failed to receivePacket: ${e?.message ?? e}`);
+        });
+    }
+    _sendPacket(packet) {
+        if (this._debugBuffers)
+            this.log(`SEND ${packet.toString('hex')}`);
+        this._socket.send(packet, 0, packet.length, this._port, this._address);
+    }
+    _sendOrQueueAck() {
+        this._receivedWithoutAck++;
+        if (this._receivedWithoutAck >= MAX_PACKET_PER_ACK) {
+            this._receivedWithoutAck = 0;
+            if (this._ackTimer) {
+                clearTimeout(this._ackTimer);
+                delete this._ackTimer;
+            }
+            this._sendAck(this._lastReceivedPacketId);
+        }
+        else if (!this._ackTimer) {
+            this._ackTimer = setTimeout(() => {
+                delete this._ackTimer;
+                this._receivedWithoutAck = 0;
+                this._sendAck(this._lastReceivedPacketId);
+            }, 5);
+        }
+    }
+    _sendAck(packetId) {
+        const opcode = PacketFlag.AckReply << 11;
+        const length = 12;
+        const buffer = Buffer.alloc(length, 0);
+        buffer.writeUInt16BE(opcode | length, 0);
+        buffer.writeUInt16BE(this._sessionId, 2);
+        buffer.writeUInt16BE(packetId, 4);
+        this._sendPacket(buffer);
+    }
+    async _retransmitFrom(fromId) {
+        // this.log(`Resending from ${fromId} to ${this._inFlight.length > 0 ? this._inFlight[this._inFlight.length - 1].packetId : '-'}`)
+        // The atem will ask for MAX_PACKET_ID to be retransmitted when it really wants 0
+        fromId = fromId % MAX_PACKET_ID;
+        const fromIndex = this._inFlight.findIndex((pkt) => pkt.packetId === fromId);
+        if (fromIndex === -1) {
+            // fromId is not inflight, so we cannot resend. only fix is to abort
+            this.log(`Unable to resend: ${fromId}`);
+            await this.restartConnection();
+        }
+        else {
+            this.log(`Resending from ${fromId} to ${this._inFlight[this._inFlight.length - 1].packetId}`);
+            // Resend from the requested
+            const now = perf_hooks_1.performance.now();
+            for (let i = fromIndex; i < this._inFlight.length; i++) {
+                const sentPacket = this._inFlight[i];
+                if (sentPacket.packetId === fromId || !this._isPacketCoveredByAck(fromId, sentPacket.packetId)) {
+                    sentPacket.lastSent = now;
+                    sentPacket.resent++;
+                    // this.log(`${Date.now()} Resending ${sentPacket.packetId} Last=${this._nextSendPacketId - 1}`)
+                    this._sendPacket(sentPacket.payload);
+                }
+            }
+        }
+    }
+    _triggerRetransmitTimer() {
+        if (!this._inFlight.length) {
+            if (this._retransmitTimer) {
+                clearTimeout(this._retransmitTimer);
+                delete this._retransmitTimer;
+            }
+            return;
+        }
+        if (!this._retransmitTimer) {
+            this._retransmitTimer = setTimeout(() => {
+                delete this._retransmitTimer;
+                this._checkForRetransmit().catch((e) => {
+                    this.log(`Failed to retransmit: ${e?.message ?? e}`);
+                });
+            }, RETRANSMIT_INTERVAL);
+        }
+    }
+    async _checkForRetransmit() {
+        if (!this._inFlight.length)
+            return;
+        this._triggerRetransmitTimer();
+        const now = perf_hooks_1.performance.now();
+        for (const sentPacket of this._inFlight) {
+            if (sentPacket.lastSent + IN_FLIGHT_TIMEOUT < now) {
+                if (sentPacket.resent <= MAX_PACKET_RETRIES &&
+                    this._isPacketCoveredByAck(this._nextSendPacketId, sentPacket.packetId)) {
+                    this.log(`Retransmit from timeout: ${sentPacket.packetId}`);
+                    // Retransmit the packet and anything after it
+                    return this._retransmitFrom(sentPacket.packetId);
+                }
+                else {
+                    // A packet has timed out, so we need to reset to avoid getting stuck
+                    this.log(`Packet timed out: ${sentPacket.packetId}`);
+                    return this.restartConnection();
+                }
+            }
+        }
+        return Promise.resolve();
+    }
+}
+exports.AtemSocketChild = AtemSocketChild;
+//# sourceMappingURL=atemSocketChild.js.map

package/dist/lib/atemSocketChild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atemSocketChild.js","sourceRoot":"","sources":["../../src/lib/atemSocketChild.ts"],"names":[],"mappings":"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"}

package/dist/lib/atemUtil.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="node" />
+import type { IDeserializedCommand, ISerializableCommand } from '../commands';
+export { getVideoModeInfo } from './videoMode';
+export declare function bufToBase64String(buffer: Buffer, start: number, length: number): string;
+export declare function bufToNullTerminatedString(buffer: Buffer, start: number, length: number): string;
+export declare function UInt16BEToDecibel(input: number): number;
+export declare function DecibelToUInt16BE(input: number): number;
+export declare function IntToBalance(input: number): number;
+export declare function BalanceToInt(input: number): number;
+export declare function padToMultiple(val: number, multiple: number): number;
+export declare function getComponents(val: number): number[];
+export declare function combineComponents(vals: number[]): number;
+export declare function commandStringify(command: IDeserializedCommand | ISerializableCommand): string;
+export declare function omit<T, K extends keyof T>(o: T, ...keys: K[]): Omit<T, K>;
+export declare function assertNever(_val: never): void;
+export declare function isRunningInTests(): boolean;
+//# sourceMappingURL=atemUtil.d.ts.map

package/dist/lib/atemUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atemUtil.d.ts","sourceRoot":"","sources":["../../src/lib/atemUtil.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI/F;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlD;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAQnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAMxD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB,GAAG,MAAM,CAE7F;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAMzE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAE7C;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}