alphatheta-connect 0.19.2 → 0.21.0

package/lib/control/index.d.ts

@@ -6,15 +6,46 @@ interface Options {
     playState: CDJStatus.PlayState.Cued | CDJStatus.PlayState.Playing;
 }
 /**
- * Generates the packet used to control the playstate of CDJs
+ * Generates the packet used to control the playstate of CDJs in active connection mode
  */
 export declare const makePlaystatePacket: ({ hostDevice, device, playState }: Options) => Uint8Array<ArrayBuffer>;
 export default class Control {
     #private;
     constructor(beatSocket: Socket, hostDevice: Device);
     /**
-     * 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.
      */
     setPlayState(device: Device, playState: Options['playState']): Promise<void>;
+    /**
+     * Send Stagehand PLAY command (paired 0x0f and 0x14 packets)
+     */
+    play(device: Device): Promise<void>;
+    /**
+     * Send Stagehand PAUSE command (paired 0x14 packet)
+     */
+    pause(device: Device): Promise<void>;
+    /**
+     * Send Stagehand SEEK forward command
+     * @param press - true to start seek, false to release
+     */
+    seekForward(device: Device, press: boolean): Promise<void>;
+    /**
+     * Send Stagehand SEEK backward command
+     * @param press - true to start seek, false to release
+     */
+    seekBackward(device: Device, press: boolean): Promise<void>;
+    /**
+     * Send Stagehand SKIP track command
+     * @param press - true to start skip, false to release
+     */
+    skip(device: Device, press: boolean): Promise<void>;
+    /**
+     * Send Stagehand preference write command (0x6b packet) to port 50002
+     */
+    setPreference(device: Device, options: {
+        onAir?: 'on' | 'off';
+        quantize?: number;
+    }): Promise<void>;
 }
 export {};

package/lib/control/stagehand.d.ts

@@ -0,0 +1,20 @@
+import { Device } from "../types";
+/**
+ * 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
+ */
+export declare function makeStagehandTransportPacket(hostDevice: Device, op: number, press: boolean, correlationByte: number): Uint8Array;
+/**
+ * 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)
+ */
+export declare function makeStagehandPrefWritePacket(hostDevice: Device, options: {
+    onAir?: 'on' | 'off';
+    quantize?: number;
+}): Uint8Array;

package/lib/entities.d.ts

@@ -1,11 +1,11 @@
-import type { BeatGrid, WaveformHD } from "./types";
 import type { Track as OneLibraryTrack } from 'onelibrary-connect';
+import type { BeatGrid, WaveformHD } from "./types";
 /**
  * Re-export entity types from onelibrary-connect.
  * These types represent what is stored in the rekordbox database.
  */
-export { EntityFK } from 'onelibrary-connect';
 export type { Album, Artist, Artwork, Color, Genre, Key, Label, Playlist, PlaylistEntry, } from 'onelibrary-connect';
+export { EntityFK } from 'onelibrary-connect';
 /**
  * Represents a track with both database fields and ANLZ analysis data.
  *

package/lib/index.d.ts

@@ -3,16 +3,16 @@ export * from './mixstatus';
 export * from './network';
 export { default as PositionEmitter } from './status/position';
 export * from './passive';
+export type { FileReader as ArtworkFileReader, ExtractedArtwork } from './artwork';
 export { extractArtwork, extractArtworkFromDevice, isArtworkExtractionSupported, PictureType, } from './artwork';
-export type { ExtractedArtwork, FileReader as ArtworkFileReader } from './artwork';
-export { extractFullMetadata, extractMetadataFromDevice, isMetadataExtractionSupported, } from './metadata';
 export type { ExtractedMetadata } from './metadata';
+export { extractFullMetadata, extractMetadataFromDevice, isMetadataExtractionSupported, } from './metadata';
+export type { AnlzResolver, AnlzResponse, AnlzResponse2EX, AnlzResponseDAT, AnlzResponseEXT, } from './localdb/rekordbox';
 export { loadAnlz } from './localdb/rekordbox';
 export { fetchFile } from './nfs';
-export type { AnlzResolver, AnlzResponse, AnlzResponse2EX, AnlzResponseDAT, AnlzResponseEXT } from './localdb/rekordbox';
 export type { DatabaseAdapter, DatabasePreference, DatabaseType, PlaylistQueryResult, } from 'onelibrary-connect';
 export { OneLibraryAdapter } from 'onelibrary-connect';
 export type { Category, DeviceProperty, HistorySession, HotCueBankList, MenuItem, MyTag, SortOption, } from 'onelibrary-connect';
-export { noopLogger } from './logger';
 export type { Logger } from './logger';
+export { noopLogger } from './logger';
 export * from './types';