alphatheta-connect 0.19.2 → 0.21.0

package/lib/index.js

@@ -74,26 +74,30 @@ async function extractArtworkFromDevice(device, slot, filePath, logger = logger_
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.extractFromAiff = extractFromAiff;
-const id3_1 = __webpack_require__(/*! ./id3 */ "./src/artwork/parsers/id3.ts");
 const reader_1 = __webpack_require__(/*! ../reader */ "./src/artwork/reader.ts");
+const id3_1 = __webpack_require__(/*! ./id3 */ "./src/artwork/parsers/id3.ts");
 async function extractFromAiff(reader) {
     const header = await reader.read(0, 12);
-    if (header.length < 12 || header.toString('ascii', 0, 4) !== 'FORM')
+    if (header.length < 12 || header.toString('ascii', 0, 4) !== 'FORM') {
         return null;
+    }
     const formType = header.toString('ascii', 8, 12);
-    if (formType !== 'AIFF' && formType !== 'AIFC')
+    if (formType !== 'AIFF' && formType !== 'AIFC') {
         return null;
+    }
     const formSize = header.readUInt32BE(4);
     const fileEnd = Math.min(8 + formSize, reader.size);
     let offset = 12;
     while (offset + 8 < fileEnd) {
         const chunkHeader = await reader.read(offset, 8);
-        if (chunkHeader.length < 8)
+        if (chunkHeader.length < 8) {
             break;
+        }
         const chunkId = chunkHeader.toString('ascii', 0, 4);
         const chunkSize = chunkHeader.readUInt32BE(4);
-        if (chunkSize <= 0 || offset + 8 + chunkSize > fileEnd)
+        if (chunkSize <= 0 || offset + 8 + chunkSize > fileEnd) {
             break;
+        }
         if (chunkId === 'ID3 ' || chunkId === 'id3 ') {
             const id3Data = await reader.read(offset + 8, chunkSize);
             const id3Reader = (0, reader_1.createBufferReader)(id3Data, 'mp3');
@@ -120,32 +124,37 @@ exports.extractFromFlac = extractFromFlac;
 const types_1 = __webpack_require__(/*! ../types */ "./src/artwork/types.ts");
 const utils_1 = __webpack_require__(/*! ./utils */ "./src/artwork/parsers/utils.ts");
 function parsePictureBlock(data) {
-    if (data.length < 32)
+    if (data.length < 32) {
         return null;
+    }
     let offset = 0;
     const pictureType = data.readUInt32BE(offset);
     offset += 4;
     const mimeLength = data.readUInt32BE(offset);
     offset += 4;
-    if (offset + mimeLength > data.length)
+    if (offset + mimeLength > data.length) {
         return null;
+    }
     const mimeType = data.toString('utf8', offset, offset + mimeLength);
     offset += mimeLength;
     const descLength = data.readUInt32BE(offset);
     offset += 4 + descLength;
-    if (offset + 16 > data.length)
+    if (offset + 16 > data.length) {
         return null;
+    }
     const width = data.readUInt32BE(offset);
     offset += 4;
     const height = data.readUInt32BE(offset);
     offset += 4 + 8; // Skip depth and colors
     const imageLength = data.readUInt32BE(offset);
     offset += 4;
-    if (offset + imageLength > data.length)
+    if (offset + imageLength > data.length) {
         return null;
+    }
     const imageData = data.subarray(offset, offset + imageLength);
-    if (imageData.length === 0)
+    if (imageData.length === 0) {
         return null;
+    }
     return {
         data: imageData,
         mimeType: (0, utils_1.normalizeMimeType)(mimeType),
@@ -156,29 +165,34 @@ function parsePictureBlock(data) {
 }
 async function extractFromFlac(reader) {
     const signature = await reader.read(0, 4);
-    if (signature.toString('ascii') !== 'fLaC')
+    if (signature.toString('ascii') !== 'fLaC') {
         return null;
+    }
     let offset = 4;
     let isLastBlock = false;
     let frontCover = null;
     let anyArtwork = null;
     while (!isLastBlock && offset < reader.size) {
         const blockHeader = await reader.read(offset, 4);
-        if (blockHeader.length < 4)
+        if (blockHeader.length < 4) {
             break;
+        }
         isLastBlock = (blockHeader[0] & 0x80) !== 0;
         const blockType = blockHeader[0] & 0x7f;
         const blockLength = (blockHeader[1] << 16) | (blockHeader[2] << 8) | blockHeader[3];
-        if (blockLength <= 0 || offset + 4 + blockLength > reader.size)
+        if (blockLength <= 0 || offset + 4 + blockLength > reader.size) {
             break;
+        }
         if (blockType === 6 /* MetadataBlockType.PICTURE */) {
             const pictureData = await reader.read(offset + 4, blockLength);
             const artwork = parsePictureBlock(pictureData);
             if (artwork) {
-                if (artwork.pictureType === types_1.PictureType.FrontCover)
+                if (artwork.pictureType === types_1.PictureType.FrontCover) {
                     frontCover = artwork;
-                else if (!anyArtwork)
+                }
+                else if (!anyArtwork) {
                     anyArtwork = artwork;
+                }
             }
         }
         offset += 4 + blockLength;
@@ -212,14 +226,16 @@ function readNullTerminatedString(buffer, offset, encoding) {
     let end = offset;
     if (isUtf16) {
         while (end < buffer.length - 1) {
-            if (buffer[end] === 0 && buffer[end + 1] === 0)
+            if (buffer[end] === 0 && buffer[end + 1] === 0) {
                 break;
+            }
             end += 2;
         }
     }
     else {
-        while (end < buffer.length && buffer[end] !== 0)
+        while (end < buffer.length && buffer[end] !== 0) {
             end++;
+        }
     }
     let value;
     if (encoding === 'utf16be') {
@@ -237,56 +253,70 @@ function readNullTerminatedString(buffer, offset, encoding) {
 }
 function getTextEncoding(encodingByte) {
     switch (encodingByte) {
-        case 0: return 'latin1';
-        case 1: return 'utf16le';
-        case 2: return 'utf16be';
-        case 3: return 'utf8';
-        default: return 'latin1';
+        case 0:
+            return 'latin1';
+        case 1:
+            return 'utf16le';
+        case 2:
+            return 'utf16be';
+        case 3:
+            return 'utf8';
+        default:
+            return 'latin1';
     }
 }
 function parseApicFrame(data) {
-    if (data.length < 4)
+    if (data.length < 4) {
         return null;
+    }
     let offset = 0;
     const encodingByte = data[offset++];
     let encoding = getTextEncoding(encodingByte);
     if (encodingByte === 1 && data.length > offset + 2) {
         const bom = data.readUInt16BE(offset);
-        if (bom === 0xfeff)
+        if (bom === 0xfeff) {
             encoding = 'utf16be';
-        else if (bom === 0xfffe)
+        }
+        else if (bom === 0xfffe) {
             encoding = 'utf16le';
+        }
     }
     const mimeResult = readNullTerminatedString(data, offset, 'latin1');
     const mimeType = mimeResult.value;
     offset += mimeResult.bytesConsumed;
-    if (offset >= data.length)
+    if (offset >= data.length) {
         return null;
+    }
     const pictureType = data[offset++];
-    if (offset >= data.length)
+    if (offset >= data.length) {
         return null;
+    }
     const descResult = readNullTerminatedString(data, offset, encoding);
     offset += descResult.bytesConsumed;
-    if (offset >= data.length)
+    if (offset >= data.length) {
         return null;
+    }
     const imageData = data.subarray(offset);
-    if (imageData.length === 0)
+    if (imageData.length === 0) {
         return null;
+    }
     const detectedType = (0, utils_1.detectImageType)(imageData);
     const finalMimeType = detectedType !== null && detectedType !== void 0 ? detectedType : (mimeType.includes('png') ? 'image/png' : 'image/jpeg');
     return { data: imageData, mimeType: finalMimeType, pictureType };
 }
 async function extractFromMp3(reader) {
     const header = await reader.read(0, 10);
-    if (header.length < 10 || header.toString('ascii', 0, 3) !== 'ID3')
+    if (header.length < 10 || header.toString('ascii', 0, 3) !== 'ID3') {
         return null;
+    }
     const majorVersion = header[3];
     const flags = header[5];
     const tagSize = readSyncsafe(header, 6);
     let extendedHeaderSize = 0;
     if (flags & 0x40) {
         const extHeader = await reader.read(10, 4);
-        extendedHeaderSize = majorVersion === 4 ? readSyncsafe(extHeader, 0) : extHeader.readUInt32BE(0);
+        extendedHeaderSize =
+            majorVersion === 4 ? readSyncsafe(extHeader, 0) : extHeader.readUInt32BE(0);
     }
     const tagData = await reader.read(10 + extendedHeaderSize, tagSize - extendedHeaderSize);
     let offset = 0;
@@ -294,29 +324,37 @@ async function extractFromMp3(reader) {
     let frontCover = null;
     let anyArtwork = null;
     while (offset < tagData.length - frameHeaderSize) {
-        if (tagData[offset] === 0)
+        if (tagData[offset] === 0) {
             break;
+        }
         let frameId;
         let frameSize;
         if (majorVersion >= 3) {
             frameId = tagData.toString('ascii', offset, offset + 4);
-            frameSize = majorVersion === 4 ? readSyncsafe(tagData, offset + 4) : tagData.readUInt32BE(offset + 4);
+            frameSize =
+                majorVersion === 4
+                    ? readSyncsafe(tagData, offset + 4)
+                    : tagData.readUInt32BE(offset + 4);
         }
         else {
             frameId = tagData.toString('ascii', offset, offset + 3);
-            frameSize = (tagData[offset + 3] << 16) | (tagData[offset + 4] << 8) | tagData[offset + 5];
+            frameSize =
+                (tagData[offset + 3] << 16) | (tagData[offset + 4] << 8) | tagData[offset + 5];
         }
-        if (frameSize <= 0 || frameSize > tagData.length - offset)
+        if (frameSize <= 0 || frameSize > tagData.length - offset) {
             break;
+        }
         const frameIdNormalized = majorVersion >= 3 ? frameId : frameId === 'PIC' ? 'APIC' : frameId;
         if (frameIdNormalized === 'APIC') {
             const frameData = tagData.subarray(offset + frameHeaderSize, offset + frameHeaderSize + frameSize);
             const artwork = parseApicFrame(frameData);
             if (artwork) {
-                if (artwork.pictureType === types_1.PictureType.FrontCover)
+                if (artwork.pictureType === types_1.PictureType.FrontCover) {
                     frontCover = artwork;
-                else if (!anyArtwork)
+                }
+                else if (!anyArtwork) {
                     anyArtwork = artwork;
+                }
             }
         }
         offset += frameHeaderSize + frameSize;
@@ -336,15 +374,15 @@ async function extractFromMp3(reader) {
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.normalizeMimeType = exports.detectImageType = exports.extractFromAiff = exports.extractFromFlac = exports.extractFromMp4 = exports.extractFromMp3 = void 0;
+exports.normalizeMimeType = exports.detectImageType = exports.extractFromMp4 = exports.extractFromMp3 = exports.extractFromFlac = exports.extractFromAiff = void 0;
+var aiff_1 = __webpack_require__(/*! ./aiff */ "./src/artwork/parsers/aiff.ts");
+Object.defineProperty(exports, "extractFromAiff", ({ enumerable: true, get: function () { return aiff_1.extractFromAiff; } }));
+var flac_1 = __webpack_require__(/*! ./flac */ "./src/artwork/parsers/flac.ts");
+Object.defineProperty(exports, "extractFromFlac", ({ enumerable: true, get: function () { return flac_1.extractFromFlac; } }));
 var id3_1 = __webpack_require__(/*! ./id3 */ "./src/artwork/parsers/id3.ts");
 Object.defineProperty(exports, "extractFromMp3", ({ enumerable: true, get: function () { return id3_1.extractFromMp3; } }));
 var mp4_1 = __webpack_require__(/*! ./mp4 */ "./src/artwork/parsers/mp4.ts");
 Object.defineProperty(exports, "extractFromMp4", ({ enumerable: true, get: function () { return mp4_1.extractFromMp4; } }));
-var flac_1 = __webpack_require__(/*! ./flac */ "./src/artwork/parsers/flac.ts");
-Object.defineProperty(exports, "extractFromFlac", ({ enumerable: true, get: function () { return flac_1.extractFromFlac; } }));
-var aiff_1 = __webpack_require__(/*! ./aiff */ "./src/artwork/parsers/aiff.ts");
-Object.defineProperty(exports, "extractFromAiff", ({ enumerable: true, get: function () { return aiff_1.extractFromAiff; } }));
 var utils_1 = __webpack_require__(/*! ./utils */ "./src/artwork/parsers/utils.ts");
 Object.defineProperty(exports, "detectImageType", ({ enumerable: true, get: function () { return utils_1.detectImageType; } }));
 Object.defineProperty(exports, "normalizeMimeType", ({ enumerable: true, get: function () { return utils_1.normalizeMimeType; } }));
@@ -365,30 +403,37 @@ exports.extractFromMp4 = extractFromMp4;
 const types_1 = __webpack_require__(/*! ../types */ "./src/artwork/types.ts");
 const utils_1 = __webpack_require__(/*! ./utils */ "./src/artwork/parsers/utils.ts");
 async function readAtomHeader(reader, offset) {
-    if (offset + 8 > reader.size)
+    if (offset + 8 > reader.size) {
         return null;
+    }
     const header = await reader.read(offset, 8);
     const size = header.readUInt32BE(0);
     const type = header.toString('ascii', 4, 8);
     if (size === 1) {
-        if (offset + 16 > reader.size)
+        if (offset + 16 > reader.size) {
             return null;
+        }
         const extHeader = await reader.read(offset + 8, 8);
         const extSize = Number(extHeader.readBigUInt64BE(0));
         return { size: extSize, type, headerSize: 16 };
     }
-    if (size === 0)
+    if (size === 0) {
         return { size: reader.size - offset, type, headerSize: 8 };
+    }
     return { size, type, headerSize: 8 };
 }
 async function findAtom(reader, startOffset, endOffset, targetType) {
     let offset = startOffset;
     while (offset < endOffset) {
         const header = await readAtomHeader(reader, offset);
-        if (!header || header.size <= 0)
+        if (!header || header.size <= 0) {
             break;
+        }
         if (header.type === targetType) {
-            return { dataOffset: offset + header.headerSize, dataSize: header.size - header.headerSize };
+            return {
+                dataOffset: offset + header.headerSize,
+                dataSize: header.size - header.headerSize,
+            };
         }
         offset += header.size;
     }
@@ -399,35 +444,43 @@ async function findMoovAtom(reader) {
 }
 async function findCoverArtData(reader, moovOffset, moovSize) {
     const udta = await findAtom(reader, moovOffset, moovOffset + moovSize, 'udta');
-    if (!udta)
+    if (!udta) {
         return null;
+    }
     const meta = await findAtom(reader, udta.dataOffset, udta.dataOffset + udta.dataSize, 'meta');
-    if (!meta)
+    if (!meta) {
         return null;
+    }
     const metaDataStart = meta.dataOffset + 4;
     const metaDataEnd = meta.dataOffset + meta.dataSize;
     const ilst = await findAtom(reader, metaDataStart, metaDataEnd, 'ilst');
-    if (!ilst)
+    if (!ilst) {
         return null;
+    }
     const covr = await findAtom(reader, ilst.dataOffset, ilst.dataOffset + ilst.dataSize, 'covr');
-    if (!covr)
+    if (!covr) {
         return null;
+    }
     const data = await findAtom(reader, covr.dataOffset, covr.dataOffset + covr.dataSize, 'data');
-    if (!data || data.dataSize < 8)
+    if (!data || data.dataSize < 8) {
         return null;
+    }
     return reader.read(data.dataOffset + 8, data.dataSize - 8);
 }
 async function extractFromMp4(reader) {
     var _a;
     const ftypHeader = await reader.read(0, 8);
-    if (ftypHeader.length < 8 || ftypHeader.toString('ascii', 4, 8) !== 'ftyp')
+    if (ftypHeader.length < 8 || ftypHeader.toString('ascii', 4, 8) !== 'ftyp') {
         return null;
+    }
     const moov = await findMoovAtom(reader);
-    if (!moov)
+    if (!moov) {
         return null;
+    }
     const imageData = await findCoverArtData(reader, moov.dataOffset, moov.dataSize);
-    if (!imageData || imageData.length === 0)
+    if (!imageData || imageData.length === 0) {
         return null;
+    }
     const mimeType = (_a = (0, utils_1.detectImageType)(imageData)) !== null && _a !== void 0 ? _a : 'image/jpeg';
     return { data: imageData, mimeType, pictureType: types_1.PictureType.FrontCover };
 }
@@ -447,22 +500,28 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.detectImageType = detectImageType;
 exports.normalizeMimeType = normalizeMimeType;
 function detectImageType(data) {
-    if (data.length < 4)
+    if (data.length < 4) {
         return null;
-    if (data[0] === 0xff && data[1] === 0xd8 && data[2] === 0xff)
+    }
+    if (data[0] === 0xff && data[1] === 0xd8 && data[2] === 0xff) {
         return 'image/jpeg';
-    if (data[0] === 0x89 && data.toString('ascii', 1, 4) === 'PNG')
+    }
+    if (data[0] === 0x89 && data.toString('ascii', 1, 4) === 'PNG') {
         return 'image/png';
-    if (data.toString('ascii', 0, 3) === 'GIF')
+    }
+    if (data.toString('ascii', 0, 3) === 'GIF') {
         return 'image/gif';
+    }
     return null;
 }
 function normalizeMimeType(mimeType) {
     const lower = mimeType.toLowerCase();
-    if (lower.includes('png'))
+    if (lower.includes('png')) {
         return 'image/png';
-    if (lower.includes('gif'))
+    }
+    if (lower.includes('gif')) {
         return 'image/gif';
+    }
     return 'image/jpeg';
 }
 
@@ -639,19 +698,20 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _Control_hostDevice, _Control_beatSocket;
+var _Control_hostDevice, _Control_beatSocket, _Control_correlationByte;
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.makePlaystatePacket = void 0;
 const constants_1 = __webpack_require__(/*! src/constants */ "./src/constants.ts");
 const types_1 = __webpack_require__(/*! src/types */ "./src/types.ts");
 const utils_1 = __webpack_require__(/*! src/utils */ "./src/utils/index.ts");
 const udp_1 = __webpack_require__(/*! src/utils/udp */ "./src/utils/udp.ts");
+const stagehand_1 = __webpack_require__(/*! ./stagehand */ "./src/control/stagehand.ts");
 const STATE_MAP = {
     [types_1.CDJStatus.PlayState.Cued]: 0x01,
     [types_1.CDJStatus.PlayState.Playing]: 0x00,
 };
 /**
- * Generates the packet used to control the playstate of CDJs
+ * Generates the packet used to control the playstate of CDJs in active connection mode
  */
 const makePlaystatePacket = ({ hostDevice, device, playState }) => Uint8Array.from([
     ...constants_1.PROLINK_HEADER,
@@ -672,21 +732,174 @@ class Control {
          * The socket used to send control packets
          */
         _Control_beatSocket.set(this, void 0);
+        /**
+         * Randomized correlation byte per session for Stagehand commands
+         */
+        _Control_correlationByte.set(this, void 0);
         __classPrivateFieldSet(this, _Control_beatSocket, beatSocket, "f");
         __classPrivateFieldSet(this, _Control_hostDevice, hostDevice, "f");
+        __classPrivateFieldSet(this, _Control_correlationByte, Math.floor(Math.random() * 256), "f");
     }
     /**
-     * Start or stop a CDJ on the network
+     * Start or stop a CDJ on the network.
+     * Delegates automatically to Stagehand-specific transport control if connected in Stagehand mode.
      */
     async setPlayState(device, playState) {
+        if (__classPrivateFieldGet(this, _Control_hostDevice, "f").type === types_1.DeviceType.Stagehand) {
+            if (playState === types_1.CDJStatus.PlayState.Playing) {
+                await this.play(device);
+            }
+            else {
+                await this.pause(device);
+            }
+            return;
+        }
         const packet = (0, exports.makePlaystatePacket)({ hostDevice: __classPrivateFieldGet(this, _Control_hostDevice, "f"), device, playState });
         await (0, udp_1.udpSend)(__classPrivateFieldGet(this, _Control_beatSocket, "f"), packet, constants_1.BEAT_PORT, device.ip.address);
     }
+    /**
+     * Send Stagehand PLAY command (paired 0x0f and 0x14 packets)
+     */
+    async play(device) {
+        const p1 = (0, stagehand_1.makeStagehandTransportPacket)(__classPrivateFieldGet(this, _Control_hostDevice, "f"), 0x0f, true, __classPrivateFieldGet(this, _Control_correlationByte, "f"));
+        const p2 = (0, stagehand_1.makeStagehandTransportPacket)(__classPrivateFieldGet(this, _Control_hostDevice, "f"), 0x14, true, __classPrivateFieldGet(this, _Control_correlationByte, "f"));
+        await (0, udp_1.udpSend)(__classPrivateFieldGet(this, _Control_beatSocket, "f"), p1, constants_1.BEAT_PORT, device.ip.address);
+        await (0, udp_1.udpSend)(__classPrivateFieldGet(this, _Control_beatSocket, "f"), p2, constants_1.BEAT_PORT, device.ip.address);
+    }
+    /**
+     * Send Stagehand PAUSE command (paired 0x14 packet)
+     */
+    async pause(device) {
+        const p = (0, stagehand_1.makeStagehandTransportPacket)(__classPrivateFieldGet(this, _Control_hostDevice, "f"), 0x14, false, __classPrivateFieldGet(this, _Control_correlationByte, "f"));
+        await (0, udp_1.udpSend)(__classPrivateFieldGet(this, _Control_beatSocket, "f"), p, constants_1.BEAT_PORT, device.ip.address);
+    }
+    /**
+     * Send Stagehand SEEK forward command
+     * @param press - true to start seek, false to release
+     */
+    async seekForward(device, press) {
+        const p = (0, stagehand_1.makeStagehandTransportPacket)(__classPrivateFieldGet(this, _Control_hostDevice, "f"), 0x1a, press, __classPrivateFieldGet(this, _Control_correlationByte, "f"));
+        await (0, udp_1.udpSend)(__classPrivateFieldGet(this, _Control_beatSocket, "f"), p, constants_1.BEAT_PORT, device.ip.address);
+    }
+    /**
+     * Send Stagehand SEEK backward command
+     * @param press - true to start seek, false to release
+     */
+    async seekBackward(device, press) {
+        const p = (0, stagehand_1.makeStagehandTransportPacket)(__classPrivateFieldGet(this, _Control_hostDevice, "f"), 0x1b, press, __classPrivateFieldGet(this, _Control_correlationByte, "f"));
+        await (0, udp_1.udpSend)(__classPrivateFieldGet(this, _Control_beatSocket, "f"), p, constants_1.BEAT_PORT, device.ip.address);
+    }
+    /**
+     * Send Stagehand SKIP track command
+     * @param press - true to start skip, false to release
+     */
+    async skip(device, press) {
+        const p = (0, stagehand_1.makeStagehandTransportPacket)(__classPrivateFieldGet(this, _Control_hostDevice, "f"), 0x18, press, __classPrivateFieldGet(this, _Control_correlationByte, "f"));
+        await (0, udp_1.udpSend)(__classPrivateFieldGet(this, _Control_beatSocket, "f"), p, constants_1.BEAT_PORT, device.ip.address);
+    }
+    /**
+     * Send Stagehand preference write command (0x6b packet) to port 50002
+     */
+    async setPreference(device, options) {
+        const p = (0, stagehand_1.makeStagehandPrefWritePacket)(__classPrivateFieldGet(this, _Control_hostDevice, "f"), options);
+        await (0, udp_1.udpSend)(__classPrivateFieldGet(this, _Control_beatSocket, "f"), p, constants_1.STATUS_PORT, device.ip.address);
+    }
 }
-_Control_hostDevice = new WeakMap(), _Control_beatSocket = new WeakMap();
+_Control_hostDevice = new WeakMap(), _Control_beatSocket = new WeakMap(), _Control_correlationByte = new WeakMap();
 exports["default"] = Control;
 
 
+/***/ },
+
+/***/ "./src/control/stagehand.ts"
+/*!**********************************!*\
+  !*** ./src/control/stagehand.ts ***!
+  \**********************************/
+(__unused_webpack_module, exports, __webpack_require__) {
+
+"use strict";
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.makeStagehandTransportPacket = makeStagehandTransportPacket;
+exports.makeStagehandPrefWritePacket = makeStagehandPrefWritePacket;
+const constants_1 = __webpack_require__(/*! src/constants */ "./src/constants.ts");
+const utils_1 = __webpack_require__(/*! src/utils */ "./src/utils/index.ts");
+/**
+ * Generates a Stagehand transport control packet (0x07, 56 bytes)
+ *
+ * @param hostDevice - The Stagehand device posing as sender
+ * @param op - The command opcode (e.g. 0x0f, 0x14, 0x18, 0x1a, 0x1b)
+ * @param press - Whether the action is press (true) or release (false)
+ * @param correlationByte - The randomized per-session correlation byte
+ */
+function makeStagehandTransportPacket(hostDevice, op, press, correlationByte) {
+    const packet = new Uint8Array(56);
+    // 0-9: magic header
+    packet.set(constants_1.PROLINK_HEADER, 0);
+    // 10: opcode 0x07
+    packet[10] = 0x07;
+    // 11-30: device name
+    packet.set((0, utils_1.buildName)(hostDevice), 11);
+    // 31: 0x01
+    packet[31] = 0x01;
+    // 32: 0x03
+    packet[32] = 0x03;
+    // 33: per-session correlation byte
+    packet[33] = correlationByte;
+    // 34-35: remaining length 0x0030 (48 bytes)
+    packet[34] = 0x00;
+    packet[35] = 0x30;
+    // 40: Stagehand sub-id 0x3a
+    packet[40] = 0x3a;
+    // 44: command opcode
+    packet[44] = op;
+    // 46: press/release flag
+    packet[46] = press ? 0x01 : 0x00;
+    return packet;
+}
+/**
+ * Generates a Stagehand preference write packet (0x6b, 124 bytes)
+ *
+ * @param hostDevice - The Stagehand device posing as sender
+ * @param options - The preferences to write (onAir, quantize)
+ */
+function makeStagehandPrefWritePacket(hostDevice, options) {
+    const packet = new Uint8Array(124);
+    // 0-9: magic header
+    packet.set(constants_1.PROLINK_HEADER, 0);
+    // 10: opcode 0x6b
+    packet[10] = 0x6b;
+    // 11-30: device name
+    const name = (0, utils_1.buildName)(hostDevice);
+    // Trailing byte 30 (which is offset 30, meaning index 19 of name) is set to 0x03
+    name[19] = 0x03;
+    packet.set(name, 11);
+    // 31: 0x01 (subscription-id-a constant)
+    packet[31] = 0x01;
+    // 32: 0x03 (constant)
+    packet[32] = 0x03;
+    // 33: Stagehand sub-id constant 0x3a
+    packet[33] = 0x3a;
+    // 34-35: body length 0x0050 (80 bytes)
+    packet[34] = 0x00;
+    packet[35] = 0x50;
+    // 36: transaction flag (0x01 = write)
+    packet[36] = 0x01;
+    // 44: on_air slot (0x80 = OFF, 0x81 = ON, 0x00 = untouched)
+    if (options.onAir === 'on') {
+        packet[44] = 0x81;
+    }
+    else if (options.onAir === 'off') {
+        packet[44] = 0x80;
+    }
+    // 60: quantize slot (0x80 | enum_index, e.g. 0x81, 0x82 etc.)
+    if (options.quantize !== undefined) {
+        packet[60] = 0x80 | options.quantize;
+    }
+    return packet;
+}
+
+
 /***/ },
 
 /***/ "./src/db/getArtworkFromFile.ts"
@@ -1840,10 +2053,6 @@ function deviceFromPacket(packet) {
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.EntityFK = void 0;
-/**
- * Re-export entity types from onelibrary-connect.
- * These types represent what is stored in the rekordbox database.
- */
 var onelibrary_connect_1 = __webpack_require__(/*! onelibrary-connect */ "onelibrary-connect");
 Object.defineProperty(exports, "EntityFK", ({ enumerable: true, get: function () { return onelibrary_connect_1.EntityFK; } }));
 
@@ -1884,25 +2093,21 @@ var position_1 = __webpack_require__(/*! ./status/position */ "./src/status/posi
 Object.defineProperty(exports, "PositionEmitter", ({ enumerable: true, get: function () { return __importDefault(position_1).default; } }));
 // Passive mode (pcap-based monitoring without announcing a VCDJ)
 __exportStar(__webpack_require__(/*! ./passive */ "./src/passive/index.ts"), exports);
-// Artwork extraction
 var artwork_1 = __webpack_require__(/*! ./artwork */ "./src/artwork/index.ts");
 Object.defineProperty(exports, "extractArtwork", ({ enumerable: true, get: function () { return artwork_1.extractArtwork; } }));
 Object.defineProperty(exports, "extractArtworkFromDevice", ({ enumerable: true, get: function () { return artwork_1.extractArtworkFromDevice; } }));
 Object.defineProperty(exports, "isArtworkExtractionSupported", ({ enumerable: true, get: function () { return artwork_1.isArtworkExtractionSupported; } }));
 Object.defineProperty(exports, "PictureType", ({ enumerable: true, get: function () { return artwork_1.PictureType; } }));
-// Full metadata extraction (title, artist, album, BPM, key, genre, artwork)
 var metadata_1 = __webpack_require__(/*! ./metadata */ "./src/metadata.ts");
 Object.defineProperty(exports, "extractFullMetadata", ({ enumerable: true, get: function () { return metadata_1.extractFullMetadata; } }));
 Object.defineProperty(exports, "extractMetadataFromDevice", ({ enumerable: true, get: function () { return metadata_1.extractMetadataFromDevice; } }));
 Object.defineProperty(exports, "isMetadataExtractionSupported", ({ enumerable: true, get: function () { return metadata_1.isMetadataExtractionSupported; } }));
-// ANLZ file loading (for analysis data: beat grid, cues, phrases, waveforms)
 var rekordbox_1 = __webpack_require__(/*! ./localdb/rekordbox */ "./src/localdb/rekordbox.ts");
 Object.defineProperty(exports, "loadAnlz", ({ enumerable: true, get: function () { return rekordbox_1.loadAnlz; } }));
 var nfs_1 = __webpack_require__(/*! ./nfs */ "./src/nfs/index.ts");
 Object.defineProperty(exports, "fetchFile", ({ enumerable: true, get: function () { return nfs_1.fetchFile; } }));
 var onelibrary_connect_1 = __webpack_require__(/*! onelibrary-connect */ "onelibrary-connect");
 Object.defineProperty(exports, "OneLibraryAdapter", ({ enumerable: true, get: function () { return onelibrary_connect_1.OneLibraryAdapter; } }));
-// Logger interface for pluggable logging
 var logger_1 = __webpack_require__(/*! ./logger */ "./src/logger.ts");
 Object.defineProperty(exports, "noopLogger", ({ enumerable: true, get: function () { return logger_1.noopLogger; } }));
 // Types are exported last to avoid overwriting values with type-only exports
@@ -6161,8 +6366,8 @@ exports.extractFullMetadata = extractFullMetadata;
 exports.isMetadataExtractionSupported = isMetadataExtractionSupported;
 exports.extractMetadataFromDevice = extractMetadataFromDevice;
 const metadata_connect_1 = __webpack_require__(/*! metadata-connect */ "metadata-connect");
-const nfs_1 = __webpack_require__(/*! ./nfs */ "./src/nfs/index.ts");
 const reader_1 = __webpack_require__(/*! ./artwork/reader */ "./src/artwork/reader.ts");
+const nfs_1 = __webpack_require__(/*! ./nfs */ "./src/nfs/index.ts");
 /**
  * Extract full metadata from an audio file using a FileReader.
  *
@@ -6653,14 +6858,15 @@ var _ProlinkNetwork_state, _ProlinkNetwork_announceSocket, _ProlinkNetwork_beatS
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.ProlinkNetwork = void 0;
 exports.bringOnline = bringOnline;
+exports.bringOnlineStagehand = bringOnlineStagehand;
 const crypto_1 = __webpack_require__(/*! crypto */ "crypto");
 const dgram_1 = __importDefault(__webpack_require__(/*! dgram */ "dgram"));
 const constants_1 = __webpack_require__(/*! src/constants */ "./src/constants.ts");
 const control_1 = __importDefault(__webpack_require__(/*! src/control */ "./src/control/index.ts"));
 const db_1 = __importDefault(__webpack_require__(/*! src/db */ "./src/db/index.ts"));
 const devices_1 = __importDefault(__webpack_require__(/*! src/devices */ "./src/devices/index.ts"));
-const logger_1 = __webpack_require__(/*! src/logger */ "./src/logger.ts");
 const localdb_1 = __importDefault(__webpack_require__(/*! src/localdb */ "./src/localdb/index.ts"));
+const logger_1 = __webpack_require__(/*! src/logger */ "./src/logger.ts");
 const mixstatus_1 = __webpack_require__(/*! src/mixstatus */ "./src/mixstatus/index.ts");
 const remotedb_1 = __importDefault(__webpack_require__(/*! src/remotedb */ "./src/remotedb/index.ts"));
 const status_1 = __importDefault(__webpack_require__(/*! src/status */ "./src/status/index.ts"));
@@ -6715,6 +6921,17 @@ async function bringOnline(config) {
     });
     return network;
 }
+/**
+ * Brings the Prolink network online using the Pioneer Stagehand connection method.
+ *
+ * This connects to the network as a non-player Stagehand device using its abbreviated handshake.
+ */
+async function bringOnlineStagehand(config) {
+    return bringOnline({
+        ...config,
+        connectMethod: 'stagehand',
+    });
+}
 class ProlinkNetwork {
     /**
      * @internal
@@ -6764,6 +6981,7 @@ class ProlinkNetwork {
      * Defaults the Virtual CDJ ID to 7.
      */
     async autoconfigFromPeers() {
+        var _a;
         const tx = Telemetry.startTransaction({ name: 'autoConfigure' });
         // wait for first device to appear on the network
         const firstDevice = await new Promise(resolve => __classPrivateFieldGet(this, _ProlinkNetwork_deviceManager, "f").once('connected', resolve));
@@ -6779,7 +6997,10 @@ class ProlinkNetwork {
             tx.finish();
             throw new Error('Unable to determine network interface');
         }
-        __classPrivateFieldSet(this, _ProlinkNetwork_config, { ...__classPrivateFieldGet(this, _ProlinkNetwork_config, "f"), vcdjId: constants_1.DEFAULT_VCDJ_ID, iface }, "f");
+        const defaultId = ((_a = __classPrivateFieldGet(this, _ProlinkNetwork_config, "f")) === null || _a === void 0 ? void 0 : _a.connectMethod) === 'stagehand'
+            ? (0, virtualcdj_1.generateStagehandDeviceId)()
+            : constants_1.DEFAULT_VCDJ_ID;
+        __classPrivateFieldSet(this, _ProlinkNetwork_config, { ...__classPrivateFieldGet(this, _ProlinkNetwork_config, "f"), vcdjId: defaultId, iface }, "f");
         tx.finish();
     }
     /**
@@ -6789,23 +7010,34 @@ class ProlinkNetwork {
      * or manual configuration). This will then initialize all the network services.
      */
     connect() {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e, _f;
         if (__classPrivateFieldGet(this, _ProlinkNetwork_config, "f") === null) {
             throw new Error(connectErrorHelp);
         }
         const tx = Telemetry.startTransaction({ name: 'connect' });
-        // Create VCDJ for the interface's broadcast address
-        const vcdj = (0, virtualcdj_1.getVirtualCDJ)(__classPrivateFieldGet(this, _ProlinkNetwork_config, "f").iface, __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").vcdjId, __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").vcdjName);
-        // Update device manager to filter out our VCDJ name
-        if (__classPrivateFieldGet(this, _ProlinkNetwork_config, "f").vcdjName !== undefined) {
-            __classPrivateFieldGet(this, _ProlinkNetwork_deviceManager, "f").reconfigure({ vcdjName: __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").vcdjName });
+        const connectMethod = (_a = __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").connectMethod) !== null && _a !== void 0 ? _a : 'active';
+        const vcdjId = (_b = __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").vcdjId) !== null && _b !== void 0 ? _b : (connectMethod === 'stagehand' ? (0, virtualcdj_1.generateStagehandDeviceId)() : constants_1.DEFAULT_VCDJ_ID);
+        const vcdjName = (_c = __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").vcdjName) !== null && _c !== void 0 ? _c : (connectMethod === 'stagehand' ? 'Stagehand' : undefined);
+        // Create VCDJ or Stagehand device
+        const vcdj = connectMethod === 'stagehand'
+            ? (0, virtualcdj_1.getVirtualStagehand)(__classPrivateFieldGet(this, _ProlinkNetwork_config, "f").iface, vcdjId, vcdjName)
+            : (0, virtualcdj_1.getVirtualCDJ)(__classPrivateFieldGet(this, _ProlinkNetwork_config, "f").iface, vcdjId, vcdjName);
+        // Update device manager to filter out our device name
+        if (vcdjName !== undefined) {
+            __classPrivateFieldGet(this, _ProlinkNetwork_deviceManager, "f").reconfigure({ vcdjName });
         }
         // Start announcing
-        const announcer = new virtualcdj_1.Announcer(vcdj, __classPrivateFieldGet(this, _ProlinkNetwork_announceSocket, "f"), this.deviceManager, __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").iface, (_a = __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").fullStartup) !== null && _a !== void 0 ? _a : false, (_b = __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").announceToStagehand) !== null && _b !== void 0 ? _b : false, __classPrivateFieldGet(this, _ProlinkNetwork_logger, "f"));
+        let announcer;
+        if (connectMethod === 'stagehand') {
+            announcer = new virtualcdj_1.StagehandAnnouncer(vcdj, __classPrivateFieldGet(this, _ProlinkNetwork_announceSocket, "f"), this.deviceManager, __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").iface, __classPrivateFieldGet(this, _ProlinkNetwork_logger, "f"));
+        }
+        else {
+            announcer = new virtualcdj_1.Announcer(vcdj, __classPrivateFieldGet(this, _ProlinkNetwork_announceSocket, "f"), this.deviceManager, __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").iface, (_d = __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").fullStartup) !== null && _d !== void 0 ? _d : false, (_e = __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").announceToStagehand) !== null && _e !== void 0 ? _e : false, __classPrivateFieldGet(this, _ProlinkNetwork_logger, "f"));
+        }
         announcer.start();
         // Create remote and local databases
         const remotedb = new remotedb_1.default(__classPrivateFieldGet(this, _ProlinkNetwork_deviceManager, "f"), vcdj);
-        const localdb = new localdb_1.default(vcdj, __classPrivateFieldGet(this, _ProlinkNetwork_deviceManager, "f"), __classPrivateFieldGet(this, _ProlinkNetwork_statusEmitter, "f"), (_c = __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").databasePreference) !== null && _c !== void 0 ? _c : 'auto');
+        const localdb = new localdb_1.default(vcdj, __classPrivateFieldGet(this, _ProlinkNetwork_deviceManager, "f"), __classPrivateFieldGet(this, _ProlinkNetwork_statusEmitter, "f"), (_f = __classPrivateFieldGet(this, _ProlinkNetwork_config, "f").databasePreference) !== null && _f !== void 0 ? _f : 'auto');
         // Create unified database
         const database = new db_1.default(localdb, remotedb, __classPrivateFieldGet(this, _ProlinkNetwork_deviceManager, "f"));
         // Create controller service
@@ -10601,11 +10833,11 @@ exports["default"] = RemoteDatabase;
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.Message = void 0;
-const telemetry_1 = __webpack_require__(/*! src/utils/telemetry */ "./src/utils/telemetry.ts");
 const constants_1 = __webpack_require__(/*! src/remotedb/constants */ "./src/remotedb/constants.ts");
 const fields_1 = __webpack_require__(/*! src/remotedb/fields */ "./src/remotedb/fields.ts");
 const response_1 = __webpack_require__(/*! src/remotedb/message/response */ "./src/remotedb/message/response.ts");
 const types_1 = __webpack_require__(/*! src/remotedb/message/types */ "./src/remotedb/message/types.ts");
+const telemetry_1 = __webpack_require__(/*! src/utils/telemetry */ "./src/utils/telemetry.ts");
 /**
  * Argument types are used in argument list fields. This is essentially
  * duplicating the field type, but has different values for whatever reason.
@@ -11685,6 +11917,13 @@ class StatusEmitter {
         this.off = __classPrivateFieldGet(this, _StatusEmitter_emitter, "f").removeListener.bind(__classPrivateFieldGet(this, _StatusEmitter_emitter, "f"));
         this.once = __classPrivateFieldGet(this, _StatusEmitter_emitter, "f").once.bind(__classPrivateFieldGet(this, _StatusEmitter_emitter, "f"));
         _StatusEmitter_handleStatus.set(this, (message) => {
+            // Stagehand mixer state (type 0x39)
+            if (message.length >= 11 && message[10] === 0x39) {
+                const mixerState = (0, utils_1.mixerStateFromPacket)(message);
+                if (mixerState !== undefined) {
+                    return __classPrivateFieldGet(this, _StatusEmitter_emitter, "f").emit('mixerState', mixerState);
+                }
+            }
             const status = (0, utils_1.statusFromPacket)(message);
             if (status !== undefined) {
                 return __classPrivateFieldGet(this, _StatusEmitter_emitter, "f").emit('status', status);
@@ -11808,6 +12047,14 @@ class PositionEmitter {
         this.off = __classPrivateFieldGet(this, _PositionEmitter_emitter, "f").removeListener.bind(__classPrivateFieldGet(this, _PositionEmitter_emitter, "f"));
         this.once = __classPrivateFieldGet(this, _PositionEmitter_emitter, "f").once.bind(__classPrivateFieldGet(this, _PositionEmitter_emitter, "f"));
         _PositionEmitter_handlePosition.set(this, (message) => {
+            // Stagehand VU meter (type 0x58)
+            if (message.length >= 11 && message[10] === 0x58) {
+                const vu = (0, utils_1.vuFromPacket)(message);
+                if (vu !== undefined) {
+                    __classPrivateFieldGet(this, _PositionEmitter_emitter, "f").emit('vu', vu);
+                    return;
+                }
+            }
             const position = (0, utils_1.positionFromPacket)(message);
             if (position !== undefined) {
                 __classPrivateFieldGet(this, _PositionEmitter_emitter, "f").emit('position', position);
@@ -11876,6 +12123,8 @@ exports.statusFromPacket = statusFromPacket;
 exports.mediaSlotFromPacket = mediaSlotFromPacket;
 exports.positionFromPacket = positionFromPacket;
 exports.onAirFromPacket = onAirFromPacket;
+exports.mixerStateFromPacket = mixerStateFromPacket;
+exports.vuFromPacket = vuFromPacket;
 const constants_1 = __webpack_require__(/*! src/constants */ "./src/constants.ts");
 const types_1 = __webpack_require__(/*! src/types */ "./src/types.ts");
 const MAX_INT32 = Math.pow(2, 32) - 1;
@@ -12058,6 +12307,83 @@ function onAirFromPacket(packet) {
     }
     return undefined;
 }
+/**
+ * Parse unicast mixer state packet from DJM-A9 (packet type 0x39 on port 50002).
+ */
+function mixerStateFromPacket(packet) {
+    if (packet.indexOf(constants_1.PROLINK_HEADER) !== 0) {
+        return undefined;
+    }
+    // Verify packet type 0x39
+    if (packet[10] !== 0x39) {
+        return undefined;
+    }
+    if (packet.length < 266) {
+        return undefined;
+    }
+    const deviceName = packet.slice(11, 30).toString().replace(/\0/g, '').trim();
+    const crossfader = packet[180];
+    const channels = {};
+    for (let ch = 1; ch <= 4; ch++) {
+        const offset = 36 + (ch - 1) * 24;
+        let crossfaderAssign = 'thru';
+        const assignVal = packet[offset + 12];
+        if (assignVal === 0x01) {
+            crossfaderAssign = 'A';
+        }
+        else if (assignVal === 0x02) {
+            crossfaderAssign = 'B';
+        }
+        channels[ch] = {
+            trim: packet[offset + 1],
+            eqHi: packet[offset + 3],
+            eqMid: packet[offset + 4],
+            eqLow: packet[offset + 6],
+            colorFx: packet[offset + 7],
+            fader: packet[offset + 11],
+            crossfaderAssign,
+        };
+    }
+    return {
+        deviceId: 33, // Mixers are typically device 33 on ProDJLink
+        deviceName,
+        channels,
+        crossfader,
+    };
+}
+/**
+ * Parse unicast VU meter packet from DJM-A9 (packet type 0x58 on port 50001).
+ * Contains 15 sample-tuples (16-bit BE left/right levels) per channel.
+ */
+function vuFromPacket(packet) {
+    if (packet.indexOf(constants_1.PROLINK_HEADER) !== 0) {
+        return undefined;
+    }
+    // Verify packet type 0x58
+    if (packet[10] !== 0x58) {
+        return undefined;
+    }
+    if (packet.length < 584) {
+        return undefined;
+    }
+    const channels = {};
+    for (let ch = 1; ch <= 4; ch++) {
+        const chOffset = 44 + (ch - 1) * 60; // 15 frames * 4 bytes per frame = 60 bytes
+        const frames = [];
+        for (let i = 0; i < 15; i++) {
+            const frameOffset = chOffset + i * 4;
+            frames.push({
+                left: packet.readUInt16BE(frameOffset),
+                right: packet.readUInt16BE(frameOffset + 2),
+            });
+        }
+        channels[ch] = frames;
+    }
+    return {
+        deviceId: 33, // Mixers are typically device 33 on ProDJLink
+        channels,
+    };
+}
 
 
 /***/ },
@@ -12114,6 +12440,7 @@ var DeviceType;
     DeviceType[DeviceType["CDJ"] = 1] = "CDJ";
     DeviceType[DeviceType["Mixer"] = 3] = "Mixer";
     DeviceType[DeviceType["Rekordbox"] = 4] = "Rekordbox";
+    DeviceType[DeviceType["Stagehand"] = 5] = "Stagehand";
 })(DeviceType || (exports.DeviceType = DeviceType = {}));
 var MediaColor;
 (function (MediaColor) {
@@ -12154,9 +12481,6 @@ var TrackType;
     TrackType[TrackType["AudioCD"] = 5] = "AudioCD";
     TrackType[TrackType["Streaming"] = 6] = "Streaming";
 })(TrackType || (exports.TrackType = TrackType = {}));
-/**
- * Re-export cue types from onelibrary-connect
- */
 var onelibrary_connect_1 = __webpack_require__(/*! onelibrary-connect */ "onelibrary-connect");
 Object.defineProperty(exports, "CueColor", ({ enumerable: true, get: function () { return onelibrary_connect_1.CueColor; } }));
 Object.defineProperty(exports, "HotcueButton", ({ enumerable: true, get: function () { return onelibrary_connect_1.HotcueButton; } }));
@@ -12613,6 +12937,9 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -13105,6 +13432,271 @@ _Announcer_announceSocket = new WeakMap(), _Announcer_deviceManager = new WeakMa
     // Then schedule regular keep-alives
     __classPrivateFieldSet(this, _Announcer_intervalHandle, setInterval(sendKeepAlive, constants_1.ANNOUNCE_INTERVAL), "f");
 };
+__exportStar(__webpack_require__(/*! ./stagehand */ "./src/virtualcdj/stagehand.ts"), exports);
+
+
+/***/ },
+
+/***/ "./src/virtualcdj/stagehand.ts"
+/*!*************************************!*\
+  !*** ./src/virtualcdj/stagehand.ts ***!
+  \*************************************/
+(__unused_webpack_module, exports, __webpack_require__) {
+
+"use strict";
+
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _StagehandAnnouncer_instances, _StagehandAnnouncer_announceSocket, _StagehandAnnouncer_vcdj, _StagehandAnnouncer_intervalHandle, _StagehandAnnouncer_currentStage, _StagehandAnnouncer_stageCounter, _StagehandAnnouncer_iface, _StagehandAnnouncer_logger, _StagehandAnnouncer_onStartupComplete, _StagehandAnnouncer_mac, _StagehandAnnouncer_startStartup, _StagehandAnnouncer_sendPacket, _StagehandAnnouncer_sendStagePackets, _StagehandAnnouncer_advanceStage, _StagehandAnnouncer_startKeepAlive;
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.StagehandAnnouncer = exports.getVirtualStagehand = exports.StagehandStartupStage = exports.STAGEHAND_KEEP_ALIVE_INTERVAL = exports.STAGEHAND_STARTUP_INTERVAL = void 0;
+exports.generateStagehandMac = generateStagehandMac;
+exports.generateStagehandDeviceId = generateStagehandDeviceId;
+exports.makeStagehand0aPacket = makeStagehand0aPacket;
+exports.makeStagehand02Packet = makeStagehand02Packet;
+exports.makeStagehand06Packet = makeStagehand06Packet;
+const ip = __importStar(__webpack_require__(/*! ip-address */ "ip-address"));
+const constants_1 = __webpack_require__(/*! src/constants */ "./src/constants.ts");
+const logger_1 = __webpack_require__(/*! src/logger */ "./src/logger.ts");
+const types_1 = __webpack_require__(/*! src/types */ "./src/types.ts");
+const utils_1 = __webpack_require__(/*! src/utils */ "./src/utils/index.ts");
+exports.STAGEHAND_STARTUP_INTERVAL = 305;
+exports.STAGEHAND_KEEP_ALIVE_INTERVAL = 2000;
+var StagehandStartupStage;
+(function (StagehandStartupStage) {
+    StagehandStartupStage[StagehandStartupStage["InitialAnnounce"] = 10] = "InitialAnnounce";
+    StagehandStartupStage[StagehandStartupStage["SecondStageClaim"] = 2] = "SecondStageClaim";
+    StagehandStartupStage[StagehandStartupStage["KeepAlive"] = 6] = "KeepAlive";
+})(StagehandStartupStage || (exports.StagehandStartupStage = StagehandStartupStage = {}));
+/**
+ * Generates a randomized MAC address with the AlphaTheta OUI (c8:3d:fc).
+ */
+function generateStagehandMac() {
+    const mac = new Uint8Array(6);
+    mac[0] = 0xc8;
+    mac[1] = 0x3d;
+    mac[2] = 0xfc;
+    mac[3] = Math.floor(Math.random() * 256);
+    mac[4] = Math.floor(Math.random() * 256);
+    mac[5] = Math.floor(Math.random() * 256);
+    return mac;
+}
+/**
+ * Generates a random Stagehand device ID in the observed range of 141 to 211.
+ */
+function generateStagehandDeviceId() {
+    return Math.floor(Math.random() * (211 - 141 + 1)) + 141;
+}
+/**
+ * Constructs a virtual Stagehand Device.
+ *
+ * @param iface - The network interface to use
+ * @param id - The device ID to use (defaults to random Stagehand ID)
+ * @param name - The device name (defaults to 'Stagehand')
+ * @param macAddr - The optional randomized MAC address
+ */
+const getVirtualStagehand = (iface, id = generateStagehandDeviceId(), name = 'Stagehand', macAddr = generateStagehandMac()) => ({
+    id,
+    name,
+    type: types_1.DeviceType.Stagehand,
+    ip: new ip.Address4(iface.address),
+    macAddr,
+});
+exports.getVirtualStagehand = getVirtualStagehand;
+/**
+ * Build Stagehand stage 0x0a packet: Initial announcement.
+ * Sent 3 times at 305ms intervals.
+ */
+function makeStagehand0aPacket(device) {
+    const parts = [
+        ...constants_1.PROLINK_HEADER, // 10 bytes
+        ...[0x0a, 0x00], // 2 bytes packet type (0x0a)
+        ...(0, utils_1.buildName)(device), // 20 bytes device name
+        ...[0x01, 0x03], // 2 bytes protocol / structure bytes
+        ...[0x00, 0x25], // 2 bytes packet length (37)
+        ...[types_1.DeviceType.Stagehand], // 1 byte device type (0x05)
+    ];
+    return Uint8Array.from(parts);
+}
+/**
+ * Build Stagehand stage 0x02 packet: Second-stage device number claim.
+ * Sent 3 times at 305ms intervals with counter N (1, 2, 3).
+ */
+function makeStagehand02Packet(device, mac, counter) {
+    const parts = [
+        ...constants_1.PROLINK_HEADER, // 10 bytes
+        ...[0x02, 0x00], // 2 bytes packet type (0x02)
+        ...(0, utils_1.buildName)(device), // 20 bytes device name
+        ...[0x01, 0x03], // 2 bytes protocol / structure bytes
+        ...[0x00, 0x32], // 2 bytes packet length (50)
+        ...device.ip.toArray(), // 4 bytes IP
+        ...mac, // 6 bytes identifier
+        ...[0x3a], // 1 byte constant
+        ...[counter], // 1 byte counter
+        ...[types_1.DeviceType.Stagehand], // 1 byte device type (0x05)
+        ...[0x01], // 1 byte constant
+    ];
+    return Uint8Array.from(parts);
+}
+/**
+ * Build Stagehand stage 0x06 packet: Keep-alive.
+ * Sent every 2.0s after startup complete.
+ */
+function makeStagehand06Packet(device, mac) {
+    const parts = [
+        ...constants_1.PROLINK_HEADER, // 10 bytes
+        ...[0x06, 0x00], // 2 bytes packet type (0x06)
+        ...(0, utils_1.buildName)(device), // 20 bytes device name
+        ...[0x01, 0x03], // 2 bytes protocol / structure bytes
+        ...[0x00, 0x36], // 2 bytes packet length (54)
+        ...[device.id], // 1 byte device number
+        ...[0x01], // 1 byte constant
+        ...mac, // 6 bytes identifier
+        ...device.ip.toArray(), // 4 bytes IP
+        ...[0x01, 0x00, 0x00, 0x00], // 4 bytes constant
+        ...[types_1.DeviceType.Stagehand], // 1 byte device-type (0x05)
+        ...[0x20], // 1 byte trailing byte
+    ];
+    return Uint8Array.from(parts);
+}
+class StagehandAnnouncer {
+    constructor(vcdj, announceSocket, deviceManager, iface, logger = logger_1.noopLogger) {
+        _StagehandAnnouncer_instances.add(this);
+        _StagehandAnnouncer_announceSocket.set(this, void 0);
+        _StagehandAnnouncer_vcdj.set(this, void 0);
+        _StagehandAnnouncer_intervalHandle.set(this, void 0);
+        _StagehandAnnouncer_currentStage.set(this, StagehandStartupStage.InitialAnnounce);
+        _StagehandAnnouncer_stageCounter.set(this, 0);
+        _StagehandAnnouncer_iface.set(this, void 0);
+        _StagehandAnnouncer_logger.set(this, void 0);
+        _StagehandAnnouncer_onStartupComplete.set(this, void 0);
+        _StagehandAnnouncer_mac.set(this, void 0);
+        __classPrivateFieldSet(this, _StagehandAnnouncer_vcdj, vcdj, "f");
+        __classPrivateFieldSet(this, _StagehandAnnouncer_announceSocket, announceSocket, "f");
+        __classPrivateFieldSet(this, _StagehandAnnouncer_iface, iface, "f");
+        __classPrivateFieldSet(this, _StagehandAnnouncer_logger, logger, "f");
+        __classPrivateFieldSet(this, _StagehandAnnouncer_mac, vcdj.macAddr, "f");
+    }
+    get ready() {
+        if (__classPrivateFieldGet(this, _StagehandAnnouncer_currentStage, "f") === StagehandStartupStage.KeepAlive) {
+            return Promise.resolve();
+        }
+        return new Promise(resolve => {
+            __classPrivateFieldSet(this, _StagehandAnnouncer_onStartupComplete, resolve, "f");
+        });
+    }
+    start() {
+        __classPrivateFieldGet(this, _StagehandAnnouncer_logger, "f").info(`Starting Stagehand announcer: device name "${__classPrivateFieldGet(this, _StagehandAnnouncer_vcdj, "f").name}", ID ${__classPrivateFieldGet(this, _StagehandAnnouncer_vcdj, "f").id}`);
+        __classPrivateFieldGet(this, _StagehandAnnouncer_instances, "m", _StagehandAnnouncer_startStartup).call(this);
+    }
+    stop() {
+        __classPrivateFieldGet(this, _StagehandAnnouncer_logger, "f").info('Stopping Stagehand announcer');
+        if (__classPrivateFieldGet(this, _StagehandAnnouncer_intervalHandle, "f") !== undefined) {
+            clearInterval(__classPrivateFieldGet(this, _StagehandAnnouncer_intervalHandle, "f"));
+            clearTimeout(__classPrivateFieldGet(this, _StagehandAnnouncer_intervalHandle, "f"));
+            __classPrivateFieldSet(this, _StagehandAnnouncer_intervalHandle, undefined, "f");
+        }
+    }
+}
+exports.StagehandAnnouncer = StagehandAnnouncer;
+_StagehandAnnouncer_announceSocket = new WeakMap(), _StagehandAnnouncer_vcdj = new WeakMap(), _StagehandAnnouncer_intervalHandle = new WeakMap(), _StagehandAnnouncer_currentStage = new WeakMap(), _StagehandAnnouncer_stageCounter = new WeakMap(), _StagehandAnnouncer_iface = new WeakMap(), _StagehandAnnouncer_logger = new WeakMap(), _StagehandAnnouncer_onStartupComplete = new WeakMap(), _StagehandAnnouncer_mac = new WeakMap(), _StagehandAnnouncer_instances = new WeakSet(), _StagehandAnnouncer_startStartup = function _StagehandAnnouncer_startStartup() {
+    __classPrivateFieldSet(this, _StagehandAnnouncer_currentStage, StagehandStartupStage.InitialAnnounce, "f");
+    __classPrivateFieldSet(this, _StagehandAnnouncer_stageCounter, 0, "f");
+    __classPrivateFieldGet(this, _StagehandAnnouncer_instances, "m", _StagehandAnnouncer_sendStagePackets).call(this);
+}, _StagehandAnnouncer_sendPacket = function _StagehandAnnouncer_sendPacket(packet) {
+    const broadcastAddr = (0, utils_1.getBroadcastAddress)(__classPrivateFieldGet(this, _StagehandAnnouncer_iface, "f"));
+    __classPrivateFieldGet(this, _StagehandAnnouncer_announceSocket, "f").send(packet, constants_1.ANNOUNCE_PORT, broadcastAddr);
+}, _StagehandAnnouncer_sendStagePackets = function _StagehandAnnouncer_sendStagePackets() {
+    var _a;
+    var _b;
+    __classPrivateFieldSet(this, _StagehandAnnouncer_stageCounter, (_b = __classPrivateFieldGet(this, _StagehandAnnouncer_stageCounter, "f"), _b++, _b), "f");
+    let packet;
+    switch (__classPrivateFieldGet(this, _StagehandAnnouncer_currentStage, "f")) {
+        case StagehandStartupStage.InitialAnnounce:
+            packet = makeStagehand0aPacket(__classPrivateFieldGet(this, _StagehandAnnouncer_vcdj, "f"));
+            __classPrivateFieldGet(this, _StagehandAnnouncer_logger, "f").debug(`Stagehand sending stage 0x0a (announce) packet ${__classPrivateFieldGet(this, _StagehandAnnouncer_stageCounter, "f")}/3`);
+            break;
+        case StagehandStartupStage.SecondStageClaim:
+            packet = makeStagehand02Packet(__classPrivateFieldGet(this, _StagehandAnnouncer_vcdj, "f"), __classPrivateFieldGet(this, _StagehandAnnouncer_mac, "f"), __classPrivateFieldGet(this, _StagehandAnnouncer_stageCounter, "f"));
+            __classPrivateFieldGet(this, _StagehandAnnouncer_logger, "f").debug(`Stagehand sending stage 0x02 (claim) packet ${__classPrivateFieldGet(this, _StagehandAnnouncer_stageCounter, "f")}/3`);
+            break;
+        case StagehandStartupStage.KeepAlive:
+            __classPrivateFieldGet(this, _StagehandAnnouncer_logger, "f").info('Stagehand join sequence complete, transitioning to keep-alive');
+            __classPrivateFieldGet(this, _StagehandAnnouncer_instances, "m", _StagehandAnnouncer_startKeepAlive).call(this);
+            (_a = __classPrivateFieldGet(this, _StagehandAnnouncer_onStartupComplete, "f")) === null || _a === void 0 ? void 0 : _a.call(this);
+            __classPrivateFieldSet(this, _StagehandAnnouncer_onStartupComplete, undefined, "f");
+            return;
+    }
+    __classPrivateFieldGet(this, _StagehandAnnouncer_instances, "m", _StagehandAnnouncer_sendPacket).call(this, packet);
+    if (__classPrivateFieldGet(this, _StagehandAnnouncer_stageCounter, "f") >= 3) {
+        __classPrivateFieldGet(this, _StagehandAnnouncer_instances, "m", _StagehandAnnouncer_advanceStage).call(this);
+    }
+    __classPrivateFieldSet(this, _StagehandAnnouncer_intervalHandle, setTimeout(() => __classPrivateFieldGet(this, _StagehandAnnouncer_instances, "m", _StagehandAnnouncer_sendStagePackets).call(this), exports.STAGEHAND_STARTUP_INTERVAL), "f");
+}, _StagehandAnnouncer_advanceStage = function _StagehandAnnouncer_advanceStage() {
+    __classPrivateFieldSet(this, _StagehandAnnouncer_stageCounter, 0, "f");
+    switch (__classPrivateFieldGet(this, _StagehandAnnouncer_currentStage, "f")) {
+        case StagehandStartupStage.InitialAnnounce:
+            __classPrivateFieldSet(this, _StagehandAnnouncer_currentStage, StagehandStartupStage.SecondStageClaim, "f");
+            break;
+        case StagehandStartupStage.SecondStageClaim:
+            __classPrivateFieldSet(this, _StagehandAnnouncer_currentStage, StagehandStartupStage.KeepAlive, "f");
+            break;
+    }
+}, _StagehandAnnouncer_startKeepAlive = function _StagehandAnnouncer_startKeepAlive() {
+    if (__classPrivateFieldGet(this, _StagehandAnnouncer_intervalHandle, "f")) {
+        clearTimeout(__classPrivateFieldGet(this, _StagehandAnnouncer_intervalHandle, "f"));
+        __classPrivateFieldSet(this, _StagehandAnnouncer_intervalHandle, undefined, "f");
+    }
+    const sendKeepAlive = () => {
+        const packet = makeStagehand06Packet(__classPrivateFieldGet(this, _StagehandAnnouncer_vcdj, "f"), __classPrivateFieldGet(this, _StagehandAnnouncer_mac, "f"));
+        __classPrivateFieldGet(this, _StagehandAnnouncer_logger, "f").debug('Stagehand sending keep-alive packet');
+        __classPrivateFieldGet(this, _StagehandAnnouncer_instances, "m", _StagehandAnnouncer_sendPacket).call(this, packet);
+    };
+    sendKeepAlive();
+    __classPrivateFieldSet(this, _StagehandAnnouncer_intervalHandle, setInterval(sendKeepAlive, exports.STAGEHAND_KEEP_ALIVE_INTERVAL), "f");
+};
 
 
 /***/ },