alphatheta-connect 0.21.6 → 0.21.8

package/lib/cli.js

@@ -6838,9 +6838,13 @@ async function bringOnline(config) {
         tx.finish();
         throw err;
     }
+    // Stagehand's experimental packet parsing (0x39 mixer state, 0x58 VU) is
+    // gated to Stagehand mode only. In 'active'/passive mode these emitters
+    // behave as they did before Stagehand was added.
+    const stagehandMode = (config === null || config === void 0 ? void 0 : config.connectMethod) === 'stagehand';
     const deviceManager = new devices_1.default(announceSocket);
-    const statusEmitter = new status_1.default(statusSocket);
-    const positionEmitter = new position_1.default(beatSocket);
+    const statusEmitter = new status_1.default(statusSocket, stagehandMode);
+    const positionEmitter = new position_1.default(beatSocket, stagehandMode);
     tx.finish();
     const network = new ProlinkNetwork({
         config,
@@ -9753,7 +9757,7 @@ 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 _StatusEmitter_statusSocket, _StatusEmitter_emitter, _StatusEmitter_mediaSlotQueryLock, _StatusEmitter_handleStatus;
+var _StatusEmitter_statusSocket, _StatusEmitter_emitter, _StatusEmitter_mediaSlotQueryLock, _StatusEmitter_stagehandMode, _StatusEmitter_handleStatus;
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 const async_mutex_1 = __webpack_require__(/*! async-mutex */ "async-mutex");
 const events_1 = __webpack_require__(/*! events */ "events");
@@ -9767,8 +9771,13 @@ const utils_1 = __webpack_require__(/*! ./utils */ "./src/status/utils.ts");
 class StatusEmitter {
     /**
      * @param statusSocket A UDP socket to receive CDJ status packets on
+     * @param stagehandMode Enable Stagehand-only mixer-state parsing. Off by
+     *   default so 'active' and passive connections behave exactly as they did
+     *   before Stagehand was added — the 0x39 layout is reverse-engineered from a
+     *   DJM-A9 and must not be applied to other mixers (e.g. XDJ-AZ) that were
+     *   never captured.
      */
-    constructor(statusSocket) {
+    constructor(statusSocket, stagehandMode = false) {
         _StatusEmitter_statusSocket.set(this, void 0);
         /**
          * The EventEmitter which reports the device status
@@ -9778,6 +9787,11 @@ class StatusEmitter {
          * Lock used to avoid media slot query races
          */
         _StatusEmitter_mediaSlotQueryLock.set(this, new async_mutex_1.Mutex());
+        /**
+         * Whether the experimental Stagehand mixer-state (0x39) parsing is active.
+         * Only true when the network was brought online in 'stagehand' mode.
+         */
+        _StatusEmitter_stagehandMode.set(this, void 0);
         // Bind public event emitter interface. Use explicit generic signatures keyed
         // on StatusEvents rather than `Emitter['on']`: extracting the indexed `on`
         // type out of strict-event-emitter-types degrades to its unique-symbol
@@ -9787,8 +9801,11 @@ 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) {
+            // Stagehand mixer state (type 0x39). Only parsed in Stagehand mode — the
+            // layout is DJM-A9-specific and applying it to other mixers misreads their
+            // faders (NP3-327). In 'active'/passive mode we fall back to the on-air
+            // flag, which is how on-air detection worked before Stagehand.
+            if (__classPrivateFieldGet(this, _StatusEmitter_stagehandMode, "f") && 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);
@@ -9811,6 +9828,7 @@ class StatusEmitter {
             return undefined;
         });
         __classPrivateFieldSet(this, _StatusEmitter_statusSocket, statusSocket, "f");
+        __classPrivateFieldSet(this, _StatusEmitter_stagehandMode, stagehandMode, "f");
         statusSocket.on('message', __classPrivateFieldGet(this, _StatusEmitter_handleStatus, "f"));
     }
     /**
@@ -9842,7 +9860,7 @@ class StatusEmitter {
         return media;
     }
 }
-_StatusEmitter_statusSocket = new WeakMap(), _StatusEmitter_emitter = new WeakMap(), _StatusEmitter_mediaSlotQueryLock = new WeakMap(), _StatusEmitter_handleStatus = new WeakMap();
+_StatusEmitter_statusSocket = new WeakMap(), _StatusEmitter_emitter = new WeakMap(), _StatusEmitter_mediaSlotQueryLock = new WeakMap(), _StatusEmitter_stagehandMode = new WeakMap(), _StatusEmitter_handleStatus = new WeakMap();
 exports["default"] = StatusEmitter;
 
 
@@ -9888,12 +9906,18 @@ exports.makeMediaSlotRequest = makeMediaSlotRequest;
 
 "use strict";
 
+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 _PositionEmitter_emitter, _PositionEmitter_handlePosition;
+var _PositionEmitter_emitter, _PositionEmitter_stagehandMode, _PositionEmitter_handlePosition;
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 const events_1 = __webpack_require__(/*! events */ "events");
 const utils_1 = __webpack_require__(/*! ./utils */ "./src/status/utils.ts");
@@ -9906,19 +9930,25 @@ const utils_1 = __webpack_require__(/*! ./utils */ "./src/status/utils.ts");
 class PositionEmitter {
     /**
      * @param beatSocket A UDP socket to receive position packets on port 50001
+     * @param stagehandMode Enable Stagehand-only VU-meter parsing. Off by default
+     *   so non-Stagehand connections behave as they did before Stagehand.
      */
-    constructor(beatSocket) {
+    constructor(beatSocket, stagehandMode = false) {
         /**
          * The EventEmitter which reports position updates
          */
         _PositionEmitter_emitter.set(this, new events_1.EventEmitter());
+        /**
+         * Whether experimental Stagehand VU-meter (0x58) parsing is active.
+         */
+        _PositionEmitter_stagehandMode.set(this, void 0);
         // Bind public event emitter interface
         this.on = __classPrivateFieldGet(this, _PositionEmitter_emitter, "f").addListener.bind(__classPrivateFieldGet(this, _PositionEmitter_emitter, "f"));
         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) {
+            // Stagehand VU meter (type 0x58) — only parsed in Stagehand mode.
+            if (__classPrivateFieldGet(this, _PositionEmitter_stagehandMode, "f") && message.length >= 11 && message[10] === 0x58) {
                 const vu = (0, utils_1.vuFromPacket)(message);
                 if (vu !== undefined) {
                     __classPrivateFieldGet(this, _PositionEmitter_emitter, "f").emit('vu', vu);
@@ -9930,10 +9960,11 @@ class PositionEmitter {
                 __classPrivateFieldGet(this, _PositionEmitter_emitter, "f").emit('position', position);
             }
         });
+        __classPrivateFieldSet(this, _PositionEmitter_stagehandMode, stagehandMode, "f");
         beatSocket.on('message', __classPrivateFieldGet(this, _PositionEmitter_handlePosition, "f"));
     }
 }
-_PositionEmitter_emitter = new WeakMap(), _PositionEmitter_handlePosition = new WeakMap();
+_PositionEmitter_emitter = new WeakMap(), _PositionEmitter_stagehandMode = new WeakMap(), _PositionEmitter_handlePosition = new WeakMap();
 exports["default"] = PositionEmitter;