alphatheta-connect 0.25.2 → 0.26.0

package/lib/virtualcdj/stagehand.d.ts

@@ -11,9 +11,19 @@ export declare enum StagehandStartupStage {
     KeepAlive = 6
 }
 /**
- * Generates a randomized MAC address with the AlphaTheta OUI (c8:3d:fc).
+ * The protocol-layer MAC a Stagehand device embeds in its 0x02 claim and 0x06
+ * keep-alive: the AlphaTheta OUI (c8:3d:fc) followed by the low three bytes of
+ * the interface's own MAC.
+ *
+ * This must stay stable for the life of the host. A CDJ-3000 records a peer by
+ * the identity in its claim, and once it holds a record for our IP it ignores
+ * later claims from the same IP that carry a different MAC or device number:
+ * the new peer never receives the unicast status/position stream. Observed on
+ * emulated CDJ-3000 firmware 3.20: a freshly randomized identity on every
+ * connect() was served once and then never again until the player rebooted,
+ * while the previously registered identity kept being served immediately.
  */
-export declare function generateStagehandMac(): Uint8Array;
+export declare function getStagehandMac(iface: NetworkInterfaceInfoIPv4): Uint8Array;
 /**
  * Generates a random Stagehand device ID in the observed range of 141 to 211.
  */
@@ -24,7 +34,7 @@ export declare function generateStagehandDeviceId(): number;
  * @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
+ * @param macAddr - The protocol-layer MAC (defaults to one derived from iface)
  */
 export declare const getVirtualStagehand: (iface: NetworkInterfaceInfoIPv4, id?: DeviceID, name?: string, macAddr?: Uint8Array<ArrayBufferLike>) => Device;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alphatheta-connect",
-  "version": "0.25.2",
+  "version": "0.26.0",
   "main": "lib/index.js",
   "author": "Evan Purkhiser <evanpurkhiser@gmail.com>",
   "contributors": [
@@ -32,6 +32,8 @@
     "build": "webpack",
     "build-docs": "typedoc --out docs src/index.ts",
     "test": "jest",
+    "build-examples": "webpack --config webpack.examples.config.ts",
+    "stagehand": "npm run build-examples && node lib/examples/stagehand-monitor.js",
     "lint": "eslint src/**/*.ts tests/**/*.ts",
     "preversion": "yarn lint; yarn test",
     "prepare": "ts-patch install -s && npm run build",
@@ -114,5 +116,9 @@
   },
   "resolutions": {
     "nan": "^2.28.0"
+  },
+  "allowScripts": {
+    "better-sqlite3-multiple-ciphers": true,
+    "cap": true
   }
 }