alphatheta-connect 0.25.3 → 0.26.0

package/lib/remotedb/fields.d.ts

@@ -65,7 +65,7 @@ export declare const UInt8: {
         data: Buffer;
     };
     type: NumberFieldType;
-    bytesToRead: 1 | 4 | 2;
+    bytesToRead: 1 | 2 | 4;
 };
 /**
  * Field representing a UInt16
@@ -81,7 +81,7 @@ export declare const UInt16: {
         data: Buffer;
     };
     type: NumberFieldType;
-    bytesToRead: 1 | 4 | 2;
+    bytesToRead: 1 | 2 | 4;
 };
 /**
  * Field representing a UInt32
@@ -97,7 +97,7 @@ export declare const UInt32: {
         data: Buffer;
     };
     type: NumberFieldType;
-    bytesToRead: 1 | 4 | 2;
+    bytesToRead: 1 | 2 | 4;
 };
 /**
  * Field representing a null-terminated big endian UTF-16 string
@@ -131,7 +131,7 @@ declare const fieldMap: {
             data: Buffer;
         };
         type: NumberFieldType;
-        bytesToRead: 1 | 4 | 2;
+        bytesToRead: 1 | 2 | 4;
     };
     readonly 16: {
         new (value: number | Buffer): {
@@ -144,7 +144,7 @@ declare const fieldMap: {
             data: Buffer;
         };
         type: NumberFieldType;
-        bytesToRead: 1 | 4 | 2;
+        bytesToRead: 1 | 2 | 4;
     };
     readonly 17: {
         new (value: number | Buffer): {
@@ -157,7 +157,7 @@ declare const fieldMap: {
             data: Buffer;
         };
         type: NumberFieldType;
-        bytesToRead: 1 | 4 | 2;
+        bytesToRead: 1 | 2 | 4;
     };
     readonly 20: typeof Binary;
     readonly 38: typeof String;

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.3",
+  "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",