alphatheta-connect 0.26.1 → 0.27.0

package/lib/control/index.d.ts

@@ -1,5 +1,7 @@
 import { Socket } from 'dgram';
 import { CDJStatus, Device } from "../types";
+import { LoadSource } from './load';
+export { LoadSource, makeLoadTrackPacket } from './load';
 interface Options {
     hostDevice: Device;
     device: Device;
@@ -11,7 +13,22 @@ interface Options {
 export declare const makePlaystatePacket: ({ hostDevice, device, playState }: Options) => Uint8Array<ArrayBuffer>;
 export default class Control {
     #private;
-    constructor(beatSocket: Socket, hostDevice: Device);
+    constructor(beatSocket: Socket, hostDevice: Device, statusSocket?: Socket | null);
+    /**
+     * Send one Stagehand transport packet (0x07) carrying `op` with the press /
+     * release flag, for opcodes the named methods do not cover.
+     */
+    transport(device: Device, op: number, press: boolean): Promise<void>;
+    /**
+     * Tell a player to load a track, as rekordbox does when a row is dragged
+     * onto a deck: the Load Track command (0x19) from our status port to the
+     * player's. The player answers 0x1a and the load shows in its next status.
+     *
+     * `source` names where the track lives: a device number and its slot (a
+     * player's USB or SD, or the rekordbox slot of a library served over the
+     * link).
+     */
+    loadTrack(device: Device, trackId: number, source: LoadSource): Promise<void>;
     /**
      * Start or stop a CDJ on the network.
      * Delegates automatically to Stagehand-specific transport control if connected in Stagehand mode.
@@ -48,4 +65,3 @@ export default class Control {
         quantize?: number;
     }): Promise<void>;
 }
-export {};

package/lib/control/load.d.ts

@@ -0,0 +1,29 @@
+import { Device, MediaSlot, TrackType } from "../types";
+/**
+ * Where the track a Load Track command names lives: the device holding the
+ * media, its slot, and the track type as the player's status reports it.
+ */
+export interface LoadSource {
+    deviceId: number;
+    slot: MediaSlot;
+    trackType?: TrackType;
+}
+/**
+ * Byte length of a Load Track command.
+ */
+export declare const LOAD_TRACK_LENGTH = 88;
+/**
+ * Generates the Load Track command (0x19, 88 bytes), unicast to a player's
+ * status port.
+ *
+ * Byte for byte what rekordbox 7.2 sends a CDJ-3000 (captured 2026-09-13 and
+ * verified live on two CDJ-3000s): the status-style header with a 20-byte
+ * name, `01 01`, our device number, the length `0034` of what follows, our
+ * number again, then the source device, slot and track type, the track ID
+ * big-endian, `32` at 0x33, the destination player counted from zero at
+ * 0x40, and `32` at 0x4b.
+ *
+ * A player only honours the command from the address its keep-alives
+ * announced and from port 50002.
+ */
+export declare function makeLoadTrackPacket(hostDevice: Device, device: Device, trackId: number, source: LoadSource): Uint8Array;

package/lib/control/stagehand.d.ts

@@ -1,15 +1,25 @@
 import { Device } from "../types";
 /**
- * Generates a Stagehand transport control packet (0x07, 56 bytes)
+ * Generates a Stagehand transport control packet (0x07, 48 bytes).
+ *
+ * Byte for byte what the iPad app sends a CDJ-3000 (captured 2026-05-23,
+ * `stagehand-allproto-20260523T142615.pcap`, pinned in the tests): the
+ * unicast header `03 01 00`, a byte that varies per command, the length
+ * `0030`, then `3a`, `01`, the opcode and the press flag each in their own
+ * 16-bit slot.
  *
  * @param hostDevice - The Stagehand device posing as sender
- * @param op - The command opcode (e.g. 0x0f, 0x14, 0x18, 0x1a, 0x1b)
+ * @param op - The command opcode (e.g. 0x0f, 0x14, 0x18, 0x19, 0x1a, 0x1b)
  * @param press - Whether the action is press (true) or release (false)
- * @param correlationByte - The randomized per-session correlation byte
+ * @param correlationByte - The per-session correlation byte
  */
 export declare function makeStagehandTransportPacket(hostDevice: Device, op: number, press: boolean, correlationByte: number): Uint8Array;
 /**
- * Generates a Stagehand preference write packet (0x6b, 124 bytes)
+ * Generates a Stagehand preference write packet (0x6b, 116 bytes).
+ *
+ * As captured from the iPad app (same capture as the transport packet): the
+ * unicast header `03 01 00 3a`, the length `0050`, the write flag, then the
+ * preference slots.
  *
  * @param hostDevice - The Stagehand device posing as sender
  * @param options - The preferences to write (onAir, quantize)

package/lib/index.d.ts

@@ -1,6 +1,11 @@
+export type { LoadSource } from './control';
+export { default as Control } from './control';
 export * from './entities';
 export * from './mixstatus';
 export * from './network';
+export * from './remote';
+export * from './remote/hue';
+export { createServer as createRemoteServer } from './remote/server';
 export { default as PositionEmitter } from './status/position';
 export * from './passive';
 export type { FileReader as ArtworkFileReader, ExtractedArtwork } from './artwork';