alphatheta-connect 0.15.0

package/lib/types.js

@@ -0,0 +1,274 @@
+/******/ (() => { // webpackBootstrap
+/******/ 	"use strict";
+/******/ 	var __webpack_modules__ = ({
+
+/***/ "./src/status/types.ts"
+/*!*****************************!*\
+  !*** ./src/status/types.ts ***!
+  \*****************************/
+(__unused_webpack_module, exports) {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.PlayState = exports.StatusFlag = void 0;
+/**
+ * Status flag bitmasks
+ */
+var StatusFlag;
+(function (StatusFlag) {
+    StatusFlag[StatusFlag["OnAir"] = 8] = "OnAir";
+    StatusFlag[StatusFlag["Sync"] = 16] = "Sync";
+    StatusFlag[StatusFlag["Master"] = 32] = "Master";
+    StatusFlag[StatusFlag["Playing"] = 64] = "Playing";
+})(StatusFlag || (exports.StatusFlag = StatusFlag = {}));
+/**
+ * Play state flags
+ */
+var PlayState;
+(function (PlayState) {
+    PlayState[PlayState["Empty"] = 0] = "Empty";
+    PlayState[PlayState["Loading"] = 2] = "Loading";
+    PlayState[PlayState["Playing"] = 3] = "Playing";
+    PlayState[PlayState["Looping"] = 4] = "Looping";
+    PlayState[PlayState["Paused"] = 5] = "Paused";
+    PlayState[PlayState["Cued"] = 6] = "Cued";
+    PlayState[PlayState["Cuing"] = 7] = "Cuing";
+    PlayState[PlayState["PlatterHeld"] = 8] = "PlatterHeld";
+    PlayState[PlayState["Searching"] = 9] = "Searching";
+    PlayState[PlayState["SpunDown"] = 14] = "SpunDown";
+    PlayState[PlayState["Ended"] = 17] = "Ended";
+})(PlayState || (exports.PlayState = PlayState = {}));
+
+
+/***/ },
+
+/***/ "./src/types.ts"
+/*!**********************!*\
+  !*** ./src/types.ts ***!
+  \**********************/
+(__unused_webpack_module, exports, __webpack_require__) {
+
+
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.MixstatusMode = exports.NetworkState = exports.CueColor = exports.HotcueButton = exports.TrackType = exports.MediaSlot = exports.MediaColor = exports.DeviceType = exports.CDJStatus = void 0;
+exports.CDJStatus = __importStar(__webpack_require__(/*! src/status/types */ "./src/status/types.ts"));
+/**
+ * Known device types on the network
+ */
+var DeviceType;
+(function (DeviceType) {
+    DeviceType[DeviceType["CDJ"] = 1] = "CDJ";
+    DeviceType[DeviceType["Mixer"] = 3] = "Mixer";
+    DeviceType[DeviceType["Rekordbox"] = 4] = "Rekordbox";
+})(DeviceType || (exports.DeviceType = DeviceType = {}));
+var MediaColor;
+(function (MediaColor) {
+    MediaColor[MediaColor["Default"] = 0] = "Default";
+    MediaColor[MediaColor["Pink"] = 1] = "Pink";
+    MediaColor[MediaColor["Red"] = 2] = "Red";
+    MediaColor[MediaColor["Orange"] = 3] = "Orange";
+    MediaColor[MediaColor["Yellow"] = 4] = "Yellow";
+    MediaColor[MediaColor["Green"] = 5] = "Green";
+    MediaColor[MediaColor["Aqua"] = 6] = "Aqua";
+    MediaColor[MediaColor["Blue"] = 7] = "Blue";
+    MediaColor[MediaColor["Purple"] = 8] = "Purple";
+})(MediaColor || (exports.MediaColor = MediaColor = {}));
+/**
+ * A slot where media is present on the CDJ
+ */
+var MediaSlot;
+(function (MediaSlot) {
+    MediaSlot[MediaSlot["Empty"] = 0] = "Empty";
+    MediaSlot[MediaSlot["CD"] = 1] = "CD";
+    MediaSlot[MediaSlot["SD"] = 2] = "SD";
+    MediaSlot[MediaSlot["USB"] = 3] = "USB";
+    MediaSlot[MediaSlot["RB"] = 4] = "RB";
+})(MediaSlot || (exports.MediaSlot = MediaSlot = {}));
+/**
+ * Track type flags
+ */
+var TrackType;
+(function (TrackType) {
+    TrackType[TrackType["None"] = 0] = "None";
+    TrackType[TrackType["RB"] = 1] = "RB";
+    TrackType[TrackType["Unanalyzed"] = 2] = "Unanalyzed";
+    TrackType[TrackType["AudioCD"] = 5] = "AudioCD";
+})(TrackType || (exports.TrackType = TrackType = {}));
+/**
+ * A hotcue button label
+ */
+var HotcueButton;
+(function (HotcueButton) {
+    HotcueButton[HotcueButton["A"] = 1] = "A";
+    HotcueButton[HotcueButton["B"] = 2] = "B";
+    HotcueButton[HotcueButton["C"] = 3] = "C";
+    HotcueButton[HotcueButton["D"] = 4] = "D";
+    HotcueButton[HotcueButton["E"] = 5] = "E";
+    HotcueButton[HotcueButton["F"] = 6] = "F";
+    HotcueButton[HotcueButton["G"] = 7] = "G";
+    HotcueButton[HotcueButton["H"] = 8] = "H";
+})(HotcueButton || (exports.HotcueButton = HotcueButton = {}));
+/**
+ * When a custom color is not configured the cue point will be one of these
+ * colors.
+ */
+var CueColor;
+(function (CueColor) {
+    CueColor[CueColor["None"] = 0] = "None";
+    CueColor[CueColor["Blank"] = 21] = "Blank";
+    CueColor[CueColor["Magenta"] = 49] = "Magenta";
+    CueColor[CueColor["Violet"] = 56] = "Violet";
+    CueColor[CueColor["Fuchsia"] = 60] = "Fuchsia";
+    CueColor[CueColor["LightSlateBlue"] = 62] = "LightSlateBlue";
+    CueColor[CueColor["Blue"] = 1] = "Blue";
+    CueColor[CueColor["SteelBlue"] = 5] = "SteelBlue";
+    CueColor[CueColor["Aqua"] = 9] = "Aqua";
+    CueColor[CueColor["SeaGreen"] = 14] = "SeaGreen";
+    CueColor[CueColor["Teal"] = 18] = "Teal";
+    CueColor[CueColor["Green"] = 22] = "Green";
+    CueColor[CueColor["Lime"] = 26] = "Lime";
+    CueColor[CueColor["Olive"] = 30] = "Olive";
+    CueColor[CueColor["Yellow"] = 32] = "Yellow";
+    CueColor[CueColor["Orange"] = 38] = "Orange";
+    CueColor[CueColor["Red"] = 42] = "Red";
+    CueColor[CueColor["Pink"] = 45] = "Pink";
+})(CueColor || (exports.CueColor = CueColor = {}));
+var NetworkState;
+(function (NetworkState) {
+    /**
+     * The network is offline when we don't have an open connection to the network
+     * (no connection to the announcement and or status UDP socket is present).
+     */
+    NetworkState[NetworkState["Offline"] = 0] = "Offline";
+    /**
+     * The network is online when we have opened sockets to the network, but have
+     * not yet started announcing ourselves as a virtual CDJ.
+     */
+    NetworkState[NetworkState["Online"] = 1] = "Online";
+    /**
+     * The network is connected once we have heard from another device on the network
+     */
+    NetworkState[NetworkState["Connected"] = 2] = "Connected";
+    /**
+     * The network may have failed to connect if we aren't able to open the
+     * announcement and or status UDP socket.
+     */
+    NetworkState[NetworkState["Failed"] = 3] = "Failed";
+})(NetworkState || (exports.NetworkState = NetworkState = {}));
+/**
+ * Mixstatus reporting modes specify how the mixstatus processor will determine when a new
+ * track is 'now playing'.
+ */
+var MixstatusMode;
+(function (MixstatusMode) {
+    /**
+     * Tracks will be smartly marked as playing following rules:
+     *
+     * - The track that has been in the play state with the CDJ in the "on air" state
+     *   for the longest period of time (allowing for a configurable length of
+     *   interruption with allowedInterruptBeats) is considered to be the active
+     *   track that incoming tracks will be compared against.
+     *
+     * - A incoming track will immediately be reported as nowPlaying if it is on
+     *   air, playing, and the last active track has been cued.
+     *
+     * - A incoming track will be reported as nowPlaying if the active track has
+     *   not been on air or has not been playing for the configured
+     *   allowedInterruptBeats.
+     *
+     * - A incoming track will be reported as nowPlaying if it has played
+     *   consecutively (with allowedInterruptBeats honored for the incoming track)
+     *   for the configured beatsUntilReported.
+     */
+    MixstatusMode[MixstatusMode["SmartTiming"] = 0] = "SmartTiming";
+    /**
+     * Tracks will not be reported after the beatsUntilReported AND will ONLY
+     * be reported if the other track has gone into a non-playing play state, or
+     * taken off air (when useOnAirStatus is enabled).
+     */
+    MixstatusMode[MixstatusMode["WaitsForSilence"] = 1] = "WaitsForSilence";
+    /**
+     * The track will simply be reported only after the player becomes master.
+     */
+    MixstatusMode[MixstatusMode["FollowsMaster"] = 2] = "FollowsMaster";
+})(MixstatusMode || (exports.MixstatusMode = MixstatusMode = {}));
+
+
+/***/ }
+
+/******/ 	});
+/************************************************************************/
+/******/ 	// The module cache
+/******/ 	var __webpack_module_cache__ = {};
+/******/ 	
+/******/ 	// The require function
+/******/ 	function __webpack_require__(moduleId) {
+/******/ 		// Check if module is in cache
+/******/ 		var cachedModule = __webpack_module_cache__[moduleId];
+/******/ 		if (cachedModule !== undefined) {
+/******/ 			return cachedModule.exports;
+/******/ 		}
+/******/ 		// Check if module exists (development only)
+/******/ 		if (__webpack_modules__[moduleId] === undefined) {
+/******/ 			var e = new Error("Cannot find module '" + moduleId + "'");
+/******/ 			e.code = 'MODULE_NOT_FOUND';
+/******/ 			throw e;
+/******/ 		}
+/******/ 		// Create a new module (and put it into the cache)
+/******/ 		var module = __webpack_module_cache__[moduleId] = {
+/******/ 			// no module.id needed
+/******/ 			// no module.loaded needed
+/******/ 			exports: {}
+/******/ 		};
+/******/ 	
+/******/ 		// Execute the module function
+/******/ 		__webpack_modules__[moduleId].call(module.exports, module, module.exports, __webpack_require__);
+/******/ 	
+/******/ 		// Return the exports of the module
+/******/ 		return module.exports;
+/******/ 	}
+/******/ 	
+/************************************************************************/
+/******/ 	
+/******/ 	// startup
+/******/ 	// Load entry module and return exports
+/******/ 	// This entry module is referenced by other modules so it can't be inlined
+/******/ 	var __webpack_exports__ = __webpack_require__("./src/types.ts");
+/******/ 	module.exports = __webpack_exports__;
+/******/ 	
+/******/ })()
+;
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","mappings":";;;;;;;;;;;;;AAEA;;GAEG;AACH,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,6CAAc;IACd,4CAAa;IACb,gDAAe;IACf,kDAAgB;AAClB,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB;AAED;;GAEG;AACH,IAAY,SAYX;AAZD,WAAY,SAAS;IACnB,2CAAY;IACZ,+CAAc;IACd,+CAAc;IACd,+CAAc;IACd,6CAAa;IACb,yCAAW;IACX,2CAAY;IACZ,uDAAkB;IAClB,mDAAgB;IAChB,kDAAe;IACf,4CAAY;AACd,CAAC,EAZW,SAAS,yBAAT,SAAS,QAYpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACvBD,uGAA8C;AAwB9C;;GAEG;AACH,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,yCAAU;IACV,6CAAY;IACZ,qDAAgB;AAClB,CAAC,EAJW,UAAU,0BAAV,UAAU,QAIrB;AAsED,IAAY,UAUX;AAVD,WAAY,UAAU;IACpB,iDAAc;IACd,2CAAW;IACX,yCAAU;IACV,+CAAa;IACb,+CAAa;IACb,6CAAY;IACZ,2CAAW;IACX,2CAAW;IACX,+CAAa;AACf,CAAC,EAVW,UAAU,0BAAV,UAAU,QAUrB;AAED;;GAEG;AACH,IAAY,SAMX;AAND,WAAY,SAAS;IACnB,2CAAY;IACZ,qCAAS;IACT,qCAAS;IACT,uCAAU;IACV,qCAAS;AACX,CAAC,EANW,SAAS,yBAAT,SAAS,QAMpB;AAED;;GAEG;AACH,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,yCAAW;IACX,qCAAS;IACT,qDAAiB;IACjB,+CAAc;AAChB,CAAC,EALW,SAAS,yBAAT,SAAS,QAKpB;AAgFD;;GAEG;AACH,IAAY,YASX;AATD,WAAY,YAAY;IACtB,yCAAK;IACL,yCAAC;IACD,yCAAC;IACD,yCAAC;IACD,yCAAC;IACD,yCAAC;IACD,yCAAC;IACD,yCAAC;AACH,CAAC,EATW,YAAY,4BAAZ,YAAY,QASvB;AAED;;;GAGG;AACH,IAAY,QAmBX;AAnBD,WAAY,QAAQ;IAClB,uCAAW;IACX,0CAAY;IACZ,8CAAc;IACd,4CAAa;IACb,8CAAc;IACd,4DAAqB;IACrB,uCAAW;IACX,iDAAgB;IAChB,uCAAW;IACX,gDAAe;IACf,wCAAW;IACX,0CAAY;IACZ,wCAAW;IACX,0CAAY;IACZ,4CAAa;IACb,4CAAa;IACb,sCAAU;IACV,wCAAW;AACb,CAAC,EAnBW,QAAQ,wBAAR,QAAQ,QAmBnB;AAoMD,IAAY,YAoBX;AApBD,WAAY,YAAY;IACtB;;;OAGG;IACH,qDAAO;IACP;;;OAGG;IACH,mDAAM;IACN;;OAEG;IACH,yDAAS;IACT;;;OAGG;IACH,mDAAM;AACR,CAAC,EApBW,YAAY,4BAAZ,YAAY,QAoBvB;AAED;;;GAGG;AACH,IAAY,aA+BX;AA/BD,WAAY,aAAa;IACvB;;;;;;;;;;;;;;;;;;OAkBG;IACH,+DAAW;IACX;;;;OAIG;IACH,uEAAe;IACf;;OAEG;IACH,mEAAa;AACf,CAAC,EA/BW,aAAa,6BAAb,aAAa,QA+BxB;;;;;;;UC1fD;UACA;;UAEA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;UACA;;UAEA;UACA;;UAEA;UACA;UACA;;;;UE5BA;UACA;UACA;UACA","sources":["webpack://alphatheta-connect/./src/status/types.ts","webpack://alphatheta-connect/./src/types.ts","webpack://alphatheta-connect/webpack/bootstrap","webpack://alphatheta-connect/webpack/before-startup","webpack://alphatheta-connect/webpack/startup","webpack://alphatheta-connect/webpack/after-startup"],"sourcesContent":["import {DeviceID, MediaSlot, TrackType} from 'src/types';\n\n/**\n * Status flag bitmasks\n */\nexport enum StatusFlag {\n  OnAir = 1 << 3,\n  Sync = 1 << 4,\n  Master = 1 << 5,\n  Playing = 1 << 6,\n}\n\n/**\n * Play state flags\n */\nexport enum PlayState {\n  Empty = 0x00,\n  Loading = 0x02,\n  Playing = 0x03,\n  Looping = 0x04,\n  Paused = 0x05,\n  Cued = 0x06,\n  Cuing = 0x07,\n  PlatterHeld = 0x08,\n  Searching = 0x09,\n  SpunDown = 0x0e,\n  Ended = 0x11,\n}\n\n/**\n * Represents various details about the current state of the CDJ.\n */\nexport interface State {\n  /**\n   * The device reporting this status.\n   */\n  deviceId: number;\n  /**\n   * The ID of the track loaded on the device.\n   *\n   * 0 When no track is loaded.\n   */\n  trackId: number;\n  /**\n   * The device ID the track is loaded from.\n   *\n   * For example if you have two CDJs and you've loaded a track over the 'LINK',\n   * this will be the ID of the player with the USB media device connected to it.\n   */\n  trackDeviceId: DeviceID;\n  /**\n   * The MediaSlot the track is loaded from. For example a SD card or USB device.\n   */\n  trackSlot: MediaSlot;\n  /**\n   * The TrackType of the track, for example a CD or Rekordbox analyzed track.\n   */\n  trackType: TrackType;\n  /**\n   * The current play state of the CDJ.\n   */\n  playState: PlayState;\n  /**\n   * Whether the CDJ is currently reporting itself as 'on-air'.\n   *\n   * This is indicated by the red ring around the platter on the CDJ Nexus models.\n   * A DJM mixer must be ont he network for the CDJ to report this as true.\n   */\n  isOnAir: boolean;\n  /**\n   * Whether the CDJ is synced.\n   */\n  isSync: boolean;\n  /**\n   * Whether the CDJ is the master player.\n   */\n  isMaster: boolean;\n  /**\n   * Whether the CDJ is in an emergency state (emergecy loop / emergency mode\n   * on newer players)\n   */\n  isEmergencyMode: boolean;\n  /**\n   * The BPM of the loaded track. null if no track is loaded or the BPM is unknown.\n   */\n  trackBPM: number | null;\n  /**\n   * The \"effective\" pitch of the plyaer. This is reported anytime the jogwheel is\n   * nudged, the CDJ spins down by pausing with the vinyl stop knob not at 0, or\n   * by holding the platter.\n   */\n  effectivePitch: number;\n  /**\n   * The current slider pitch\n   */\n  sliderPitch: number;\n  /**\n   * The current beat within the measure. 1-4. 0 when no track is loaded.\n   */\n  beatInMeasure: number;\n  /**\n   * Number of beats remaining until the next cue point is reached. Null if there\n   * is no next cue point\n   */\n  beatsUntilCue: number | null;\n  /**\n   * The beat 'timestamp' of the track. Can be used to compute absolute track time\n   * given the slider pitch.\n   */\n  beat: number | null;\n  /**\n   * A counter that increments for every status packet sent.\n   */\n  packetNum: number;\n}\n\n/**\n * Absolute position information from CDJ-3000+ devices.\n * Sent every 30ms on port 50001 while a track is loaded.\n * Provides precise playhead position independent of beat grid.\n */\nexport interface PositionState {\n  /**\n   * The device ID sending this position update.\n   */\n  deviceId: number;\n  /**\n   * Track length in seconds (rounded down to nearest second).\n   */\n  trackLength: number;\n  /**\n   * Absolute playhead position in milliseconds.\n   */\n  playhead: number;\n  /**\n   * Pitch slider value as shown on screen.\n   * For example, 3.26% is represented as 3.26.\n   */\n  pitch: number;\n  /**\n   * Effective BPM (track BPM adjusted by pitch) as shown on screen.\n   * null if BPM is unknown.\n   */\n  bpm: number | null;\n}\n\n/**\n * On-Air status from DJM mixer.\n * Broadcast by the mixer to indicate which channels are currently audible.\n * Supports both 4-channel (DJM-900/1000) and 6-channel (DJM-V10) mixers.\n */\nexport interface OnAirStatus {\n  /**\n   * The mixer device ID (typically 33 / 0x21).\n   */\n  deviceId: number;\n  /**\n   * On-air flags for channels 1-4 (always present).\n   * 0x00 = channel is off-air (silenced)\n   * 0x01 = channel is on-air (audible)\n   */\n  channels: {\n    1: boolean;\n    2: boolean;\n    3: boolean;\n    4: boolean;\n    5?: boolean;\n    6?: boolean;\n  };\n  /**\n   * Whether this is a 6-channel variant (CDJ-3000 + DJM-V10).\n   * Determined by packet subtype (0x00 = 4-channel, 0x03 = 6-channel).\n   */\n  isSixChannel: boolean;\n}\n","import type {Address4} from 'ip-address';\n\nimport type {Playlist, Track} from './entities';\n\nexport * as CDJStatus from 'src/status/types';\n\n/**\n * Re-export various types for the types only compile target\n */\n\nexport type {\n  Album,\n  Artist,\n  Artwork,\n  Color,\n  Genre,\n  Key,\n  Label,\n  Playlist,\n  Track,\n} from './entities';\nexport type {HydrationProgress} from './localdb/rekordbox';\nexport type {MixstatusConfig, MixstatusProcessor} from './mixstatus';\n// Note: ProlinkNetwork is exported as a class from ./network, not re-exported here as type-only\n// to preserve method signatures like close()\nexport type {ConnectedProlinkNetwork, NetworkConfig} from './network';\nexport type {FetchProgress} from './nfs';\n\n/**\n * Known device types on the network\n */\nexport enum DeviceType {\n  CDJ = 0x01,\n  Mixer = 0x03,\n  Rekordbox = 0x04,\n}\n\n/**\n * The 8-bit identifier of the device on the network\n */\nexport type DeviceID = number;\n\n/**\n * Represents a device on the prolink network.\n */\nexport interface Device {\n  name: string;\n  id: DeviceID;\n  type: DeviceType;\n  macAddr: Uint8Array;\n  ip: Address4;\n  lastActive?: Date;\n}\n\n/**\n * Details of a particular media slot on the CDJ\n */\nexport interface MediaSlotInfo {\n  /**\n   * The device the slot physically exists on\n   */\n  deviceId: DeviceID;\n  /**\n   * The slot type\n   */\n  slot: MediaSlot;\n  /**\n   * The name of the media connected\n   */\n  name: string;\n  /**\n   * The rekordbox configured color of the media connected\n   */\n  color: MediaColor;\n  /**\n   * Creation date\n   */\n  createdDate: Date;\n  /**\n   * Number of free bytes available on the media\n   */\n  freeBytes: bigint;\n  /**\n   * Number of bytes used on the media\n   */\n  totalBytes: bigint;\n  /**\n   * Specifies the available tracks type on the media\n   */\n  tracksType: TrackType;\n  /**\n   * Total number of rekordbox tracks on the media. Will be zero if there is\n   * no rekordbox database on the media\n   */\n  trackCount: number;\n  /**\n   * Same as track count, except for playlists\n   */\n  playlistCount: number;\n  /**\n   * True when a rekordbox 'my settings' file has been exported to the media\n   */\n  hasSettings: boolean;\n}\n\nexport enum MediaColor {\n  Default = 0x00,\n  Pink = 0x01,\n  Red = 0x02,\n  Orange = 0x03,\n  Yellow = 0x04,\n  Green = 0x05,\n  Aqua = 0x06,\n  Blue = 0x07,\n  Purple = 0x08,\n}\n\n/**\n * A slot where media is present on the CDJ\n */\nexport enum MediaSlot {\n  Empty = 0x00,\n  CD = 0x01,\n  SD = 0x02,\n  USB = 0x03,\n  RB = 0x04,\n}\n\n/**\n * Track type flags\n */\nexport enum TrackType {\n  None = 0x00,\n  RB = 0x01,\n  Unanalyzed = 0x02,\n  AudioCD = 0x05,\n}\n\n/**\n * A beat grid is a series of offsets from the start of the track. Each offset\n * indicates what count within the measure it is along with the BPM.\n */\nexport type BeatGrid = Array<{\n  /**\n   * Offset from the beginning of track in milliseconds of this beat.\n   */\n  offset: number;\n  /**\n   * The count of this particular beat within the measure\n   */\n  count: 1 | 2 | 3 | 4;\n  /**\n   * The BPM at this beat.\n   */\n  bpm: number;\n}>;\n\n/**\n * A waveform segment contains a height and 'whiteness' value.\n */\ninterface WaveformSegment {\n  /**\n   * The height this segment in the waveform. Ranges from 0 - 31.\n   */\n  height: number;\n  /**\n   * The level of \"whiteness\" of the waveform. 0 being completely blue, and 1\n   * being completely white.\n   */\n  whiteness: number;\n}\n\n/**\n * A HD waveform segment contains the height of the waveform, and it's color\n * represented as RGB values.\n */\ninterface WaveformHDSegment {\n  /**\n   * The height this segment in the waveform. Ranges from 0 - 31.\n   */\n  height: number;\n  /**\n   * the RGB value, each channel ranges from 0-1 for the segment.\n   */\n  color: [number, number, number];\n}\n\n/**\n * The waveform preview will be 400 segments of data.\n */\nexport type WaveformPreview = WaveformSegment[];\n\n/**\n * Detailed waveforms have 150 segments per second of audio (150 'half frames'\n * per second of audio).\n */\nexport type WaveformDetailed = WaveformSegment[];\n\n/**\n * HD waveforms have 150 segments per second of audio (150 'half frames' per\n * second of audio).\n */\nexport type WaveformHD = WaveformHDSegment[];\n\n/**\n * The result of looking up track waveforms\n */\nexport interface Waveforms {\n  /**\n   * The full-size and full-color waveform\n   */\n  waveformHd: WaveformHD;\n\n  // TODO: Add other waveform types\n}\n\n/**\n * A hotcue button label\n */\nexport enum HotcueButton {\n  A = 1,\n  B,\n  C,\n  D,\n  E,\n  F,\n  G,\n  H,\n}\n\n/**\n * When a custom color is not configured the cue point will be one of these\n * colors.\n */\nexport enum CueColor {\n  None = 0x00,\n  Blank = 0x15,\n  Magenta = 0x31,\n  Violet = 0x38,\n  Fuchsia = 0x3c,\n  LightSlateBlue = 0x3e,\n  Blue = 0x01,\n  SteelBlue = 0x05,\n  Aqua = 0x09,\n  SeaGreen = 0x0e,\n  Teal = 0x12,\n  Green = 0x16,\n  Lime = 0x1a,\n  Olive = 0x1e,\n  Yellow = 0x20,\n  Orange = 0x26,\n  Red = 0x2a,\n  Pink = 0x2d,\n}\n\n/**\n * Represents a single cue point. On older exports the label and color may be\n * undefined.\n */\nexport interface CuePoint {\n  type: 'cue_point';\n  /**\n   * Number of milliseconds from the start of the track.\n   */\n  offset: number;\n  /**\n   * The comment associated to the cue point\n   */\n  label?: string;\n  /**\n   * RGB values of the hotcue color\n   */\n  color?: CueColor;\n}\n\ntype BareCuePoint = Omit<CuePoint, 'type'>;\n\n/**\n * A loop, similar to a cue point, but includes a length.\n */\nexport type Loop = BareCuePoint & {\n  type: 'loop';\n  /**\n   * The length in milliseconds of the loop\n   */\n  length: number;\n};\n\n/**\n * A hotcue is like a cue point, but also includes the button it is assigned to.\n */\nexport type Hotcue = BareCuePoint & {\n  type: 'hot_cue';\n  /**\n   * Which hotcue button this hotcue is assigned to.\n   */\n  button: HotcueButton;\n};\n\n/**\n * A hot loop, this is the union of a hotcue and a loop.\n */\nexport type Hotloop = {type: 'hot_loop'} & (Omit<Hotcue, 'type'> & Omit<Loop, 'type'>);\n\nexport type CueAndLoop = CuePoint | Loop | Hotcue | Hotloop;\n\n/**\n * Extended cue with color and comment support (PCO2 tag from rekordbox).\n * Includes additional metadata like RGB colors, comments, and quantized loop information.\n */\nexport interface ExtendedCue {\n  /**\n   * Hot cue number (0 for memory points, 1-8 for hot cues A-H)\n   */\n  hotCue: number;\n  /**\n   * Type of cue: 1 = simple position/cue, 2 = loop\n   */\n  type: 1 | 2;\n  /**\n   * Position in milliseconds from the start of the track\n   */\n  time: number;\n  /**\n   * For loops, the end position in milliseconds\n   */\n  loopTime?: number;\n  /**\n   * Color ID referencing the color table (for memory points/loops)\n   */\n  colorId?: number;\n  /**\n   * Color code for the hot cue palette (0x00 = default green, 0x01-0x3e = palette colors)\n   */\n  colorCode?: number;\n  /**\n   * RGB color values used to illuminate the player's RGB LEDs\n   */\n  colorRgb?: {r: number; g: number; b: number};\n  /**\n   * User-assigned comment text for the cue\n   */\n  comment?: string;\n  /**\n   * For quantized loops, the numerator of the loop size fraction (e.g., 4 for a 4-beat loop)\n   */\n  loopNumerator?: number;\n  /**\n   * For quantized loops, the denominator of the loop size fraction (e.g., 1 for a 4-beat loop)\n   */\n  loopDenominator?: number;\n}\n\n/**\n * A phrase within a track's song structure\n */\nexport interface Phrase {\n  /**\n   * Sequential phrase number starting from 1\n   */\n  index: number;\n  /**\n   * Beat number where this phrase begins\n   */\n  beat: number;\n  /**\n   * Raw phrase kind value from rekordbox\n   */\n  kind: number;\n  /**\n   * Human-readable phrase type (e.g., \"Intro\", \"Verse 1\", \"Chorus\")\n   */\n  phraseType: string;\n  /**\n   * Whether this phrase has a fill-in section (non-zero if present)\n   */\n  fill?: number;\n  /**\n   * Beat number where the fill-in begins (if present)\n   */\n  fillBeat?: number;\n}\n\n/**\n * Song structure / phrase analysis (PSSI tag from rekordbox).\n * Used by CDJ-3000 players for phrase-based navigation and lighting control.\n */\nexport interface SongStructure {\n  /**\n   * Overall mood classification of the track\n   */\n  mood: 'high' | 'mid' | 'low';\n  /**\n   * Stylistic bank assigned for lighting control\n   */\n  bank:\n    | 'default'\n    | 'cool'\n    | 'natural'\n    | 'hot'\n    | 'subtle'\n    | 'warm'\n    | 'vivid'\n    | 'club_1'\n    | 'club_2';\n  /**\n   * Beat number where the last phrase ends (track may continue after this)\n   */\n  endBeat: number;\n  /**\n   * List of identified phrases in the track\n   */\n  phrases: Phrase[];\n}\n\n/**\n * Monochrome waveform preview data (PWAV/PWV2 tags).\n * PWAV contains 400 bytes, PWV2 contains 100 bytes.\n */\nexport interface WaveformPreviewData {\n  /**\n   * Raw waveform data - each byte encodes height and whiteness\n   */\n  data: Uint8Array;\n}\n\n/**\n * Represents the contents of a playlist\n */\nexport interface PlaylistContents {\n  /**\n   * The playlists in this playlist.\n   */\n  playlists: Playlist[];\n  /**\n   * The folders in this playlist.\n   */\n  folders: Playlist[];\n  /**\n   * The tracks in this playlist. This is an AsyncIterator as looking up track\n   * metadata may be slow when connected to the remote database.\n   */\n  tracks: AsyncIterable<Track>;\n  /**\n   * The total number of tracks in this playlist.\n   */\n  totalTracks: number;\n}\n\nexport enum NetworkState {\n  /**\n   * The network is offline when we don't have an open connection to the network\n   * (no connection to the announcement and or status UDP socket is present).\n   */\n  Offline,\n  /**\n   * The network is online when we have opened sockets to the network, but have\n   * not yet started announcing ourselves as a virtual CDJ.\n   */\n  Online,\n  /**\n   * The network is connected once we have heard from another device on the network\n   */\n  Connected,\n  /**\n   * The network may have failed to connect if we aren't able to open the\n   * announcement and or status UDP socket.\n   */\n  Failed,\n}\n\n/**\n * Mixstatus reporting modes specify how the mixstatus processor will determine when a new\n * track is 'now playing'.\n */\nexport enum MixstatusMode {\n  /**\n   * Tracks will be smartly marked as playing following rules:\n   *\n   * - The track that has been in the play state with the CDJ in the \"on air\" state\n   *   for the longest period of time (allowing for a configurable length of\n   *   interruption with allowedInterruptBeats) is considered to be the active\n   *   track that incoming tracks will be compared against.\n   *\n   * - A incoming track will immediately be reported as nowPlaying if it is on\n   *   air, playing, and the last active track has been cued.\n   *\n   * - A incoming track will be reported as nowPlaying if the active track has\n   *   not been on air or has not been playing for the configured\n   *   allowedInterruptBeats.\n   *\n   * - A incoming track will be reported as nowPlaying if it has played\n   *   consecutively (with allowedInterruptBeats honored for the incoming track)\n   *   for the configured beatsUntilReported.\n   */\n  SmartTiming,\n  /**\n   * Tracks will not be reported after the beatsUntilReported AND will ONLY\n   * be reported if the other track has gone into a non-playing play state, or\n   * taken off air (when useOnAirStatus is enabled).\n   */\n  WaitsForSilence,\n  /**\n   * The track will simply be reported only after the player becomes master.\n   */\n  FollowsMaster,\n}\n","// The module cache\nvar __webpack_module_cache__ = {};\n\n// The require function\nfunction __webpack_require__(moduleId) {\n\t// Check if module is in cache\n\tvar cachedModule = __webpack_module_cache__[moduleId];\n\tif (cachedModule !== undefined) {\n\t\treturn cachedModule.exports;\n\t}\n\t// Check if module exists (development only)\n\tif (__webpack_modules__[moduleId] === undefined) {\n\t\tvar e = new Error(\"Cannot find module '\" + moduleId + \"'\");\n\t\te.code = 'MODULE_NOT_FOUND';\n\t\tthrow e;\n\t}\n\t// Create a new module (and put it into the cache)\n\tvar module = __webpack_module_cache__[moduleId] = {\n\t\t// no module.id needed\n\t\t// no module.loaded needed\n\t\texports: {}\n\t};\n\n\t// Execute the module function\n\t__webpack_modules__[moduleId].call(module.exports, module, module.exports, __webpack_require__);\n\n\t// Return the exports of the module\n\treturn module.exports;\n}\n\n","","// startup\n// Load entry module and return exports\n// This entry module is referenced by other modules so it can't be inlined\nvar __webpack_exports__ = __webpack_require__(\"./src/types.ts\");\n",""],"names":[],"ignoreList":[],"sourceRoot":""}

package/lib/utils/converters.d.ts

@@ -0,0 +1,17 @@
+import { WaveformHD } from "../types";
+/**
+ * Extracts a specific bitmask, shifting it to the bitmask.
+ */
+export declare const extractBitMask: (val: number, mask: number) => number;
+/**
+ * Pioneer colors are 3 bits, convert this to a percentage.
+ */
+export declare const extractColor: (val: number, mask: number) => number;
+/**
+ * Utility to generate an filled with byte offsets for each segment
+ */
+export declare const makeOffsetArray: (byteLength: number, segmentSize: number) => number[];
+/**
+ * Convert raw waveform HD data into the structured WaveformHD type
+ */
+export declare const convertWaveformHDData: (data: Buffer) => WaveformHD;

package/lib/utils/index.d.ts

@@ -0,0 +1,28 @@
+import * as ip from 'ip-address';
+import { NetworkInterfaceInfoIPv4 } from 'os';
+import { Device, MediaSlot, TrackType } from "../types";
+/**
+ * Get the byte representation of the device name
+ */
+export declare function buildName(device: Device): Uint8Array;
+/**
+ * Determines the interface that routes the given address by comparing the
+ * masked addresses. This type of information is generally determined through
+ * the kernels routing table, but for sake of cross-platform compatibility, we
+ * do some rudimentary lookup.
+ */
+export declare function getMatchingInterface(ipAddr: ip.Address4): (NetworkInterfaceInfoIPv4 & {
+    name: string;
+}) | null;
+/**
+ * Given a BPM and pitch value, compute how many seconds per beat
+ */
+export declare function bpmToSeconds(bpm: number, pitch: number): number;
+/**
+ * Returns a string representation of a media slot
+ */
+export declare function getSlotName(slot: MediaSlot): string;
+/**
+ * Returns a string representation of a track type
+ */
+export declare function getTrackTypeName(type: TrackType): string;

package/lib/utils/telemetry.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Telemetry utility - Sentry removed, now a no-op implementation.
+ */
+/**
+ * Check if telemetry is enabled - always false now.
+ */
+export declare const isTelemetryEnabled: () => boolean;
+/**
+ * Span status values for telemetry.
+ */
+export declare const SpanStatus: {
+    readonly Ok: "ok";
+    readonly Cancelled: "cancelled";
+    readonly Unknown: "unknown";
+    readonly InvalidArgument: "invalid_argument";
+    readonly DeadlineExceeded: "deadline_exceeded";
+    readonly NotFound: "not_found";
+    readonly AlreadyExists: "already_exists";
+    readonly PermissionDenied: "permission_denied";
+    readonly ResourceExhausted: "resource_exhausted";
+    readonly FailedPrecondition: "failed_precondition";
+    readonly Aborted: "aborted";
+    readonly OutOfRange: "out_of_range";
+    readonly Unimplemented: "unimplemented";
+    readonly InternalError: "internal_error";
+    readonly Unavailable: "unavailable";
+    readonly DataLoss: "data_loss";
+    readonly Unauthenticated: "unauthenticated";
+};
+export type SpanStatusType = (typeof SpanStatus)[keyof typeof SpanStatus];
+/**
+ * Context for starting a child span.
+ */
+export interface SpanContext {
+    name?: string;
+    op?: string;
+    description?: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Interface for span-like objects returned by telemetry functions.
+ */
+export interface TelemetrySpan {
+    startChild(context?: SpanContext): TelemetrySpan;
+    setData(key: string, value: unknown): TelemetrySpan;
+    setTag(key: string, value: string): TelemetrySpan;
+    setStatus(status: SpanStatusType): TelemetrySpan;
+    end(): void;
+    /** @deprecated Use end() instead */
+    finish(): void;
+}
+/**
+ * Initialize telemetry - no-op.
+ */
+export declare function init(_options?: unknown): void;
+/**
+ * Start a transaction/span - returns no-op.
+ */
+export declare function startTransaction(_context: SpanContext): TelemetrySpan;
+/**
+ * Capture an exception - no-op.
+ */
+export declare function captureException(_exception: unknown, _hint?: unknown): string;
+/**
+ * Capture a message - no-op.
+ */
+export declare function captureMessage(_message: string, _level?: unknown): string;
+/**
+ * Set a tag - no-op.
+ */
+export declare function setTag(_key: string, _value: string): void;
+/**
+ * Severity levels for messages.
+ */
+export declare const Severity: {
+    readonly Fatal: "fatal";
+    readonly Error: "error";
+    readonly Warning: "warning";
+    readonly Log: "log";
+    readonly Info: "info";
+    readonly Debug: "debug";
+};

package/lib/utils/udp.d.ts

@@ -0,0 +1,20 @@
+import { BindOptions, Socket } from 'dgram';
+import { AddressInfo } from 'net';
+/**
+ * Async version of upd socket bind
+ */
+export declare function udpBind(conn: Socket, port?: number, address?: string): Promise<AddressInfo>;
+export declare function udpBind(conn: Socket, options: BindOptions): Promise<AddressInfo>;
+/**
+ * Async version of udp socket read
+ */
+export declare function udpRead(conn: Socket): Promise<Buffer<ArrayBufferLike>>;
+/**
+ * Async version of udp socket send
+ */
+export declare function udpSend(conn: Socket, msg: Buffer | string | Uint8Array | any[], port: number, address: string): Promise<number>;
+export declare function udpSend(conn: Socket, msg: Buffer | string | Uint8Array, offset: number, length: number, port: number, address: string): Promise<number>;
+/**
+ * Async version of udp socket close
+ */
+export declare function udpClose(conn: Socket): Promise<unknown>;

package/lib/virtualcdj/index.d.ts

@@ -0,0 +1,33 @@
+import { Socket } from 'dgram';
+import { NetworkInterfaceInfoIPv4 } from 'os';
+import DeviceManager from "../devices";
+import { Device, DeviceID } from "../types";
+/**
+ * Constructs a virtual CDJ Device.
+ *
+ * @param iface - The network interface to use
+ * @param id - The device ID to use
+ * @param name - Optional custom name (defaults to VIRTUAL_CDJ_NAME constant)
+ */
+export declare const getVirtualCDJ: (iface: NetworkInterfaceInfoIPv4, id: DeviceID, name?: string) => Device;
+/**
+ * Returns a mostly empty-state status packet. This is currently used to report
+ * the virtual CDJs status, which *seems* to be required for the CDJ to send
+ * metadata about some unanalyzed mp3 files.
+ */
+export declare function makeStatusPacket(device: Device): Uint8Array;
+/**
+ * constructs the announce packet that is sent on the prolink network to
+ * announce a devices existence.
+ */
+export declare function makeAnnouncePacket(deviceToAnnounce: Device): Uint8Array;
+/**
+ * the announcer service is used to report our fake CDJ to the prolink network,
+ * as if it was a real CDJ.
+ */
+export declare class Announcer {
+    #private;
+    constructor(vcdj: Device, announceSocket: Socket, deviceManager: DeviceManager, iface: NetworkInterfaceInfoIPv4, fullStartup?: boolean);
+    start(): void;
+    stop(): void;
+}

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "alphatheta-connect",
+  "version": "0.15.0",
+  "main": "lib/index.js",
+  "author": "Evan Purkhiser <evanpurkhiser@gmail.com>",
+  "keywords": [
+    "prolink-network",
+    "CDJ",
+    "pioneer",
+    "DJ",
+    "reverse-engineer",
+    "cdj",
+    "djm"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "watch": "webpack --watch",
+    "build": "webpack",
+    "build-docs": "typedoc --out docs src/index.ts",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts tests/**/*.ts",
+    "preversion": "yarn lint; yarn test",
+    "prepare": "ts-patch install -s && npm run build",
+    "prepublishOnly": "npm run build",
+    "release": "node .github/release.js",
+    "release:patch": "node .github/release.js --patch",
+    "release:major": "node .github/release.js --major"
+  },
+  "files": [
+    "lib/"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "bin": {
+    "alphatheta-connect": "./lib/cli.js"
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/lodash": "^4.17.21",
+    "@types/node": "^22.15.29",
+    "@types/promise-retry": "^1.1.6",
+    "@types/promise-timeout": "^1.3.3",
+    "@types/signale": "^1.4.7",
+    "async-mutex": "^0.5.0",
+    "better-sqlite3-multiple-ciphers": "^12.5.0",
+    "iconv-lite": "^0.6.3",
+    "ip-address": "^10.1.0",
+    "js-xdr": "^3.1.2",
+    "kaitai-struct": "^0.11.0",
+    "lodash": "^4.17.21",
+    "lru_map": "^0.4.1",
+    "promise-readable": "^6.0.0",
+    "promise-retry": "^2.0.1",
+    "promise-socket": "^7.0.0",
+    "promise-timeout": "^1.3.0",
+    "strict-event-emitter-types": "^2.0.0"
+  },
+  "optionalDependencies": {
+    "cap": "^0.2.1"
+  },
+  "devDependencies": {
+    "@evanpurkhiser/eslint-config": "^0.27.0",
+    "@types/jest": "^29.5.14",
+    "@types/stream-buffers": "^3.0.8",
+    "@types/webpack": "^5.28.5",
+    "@types/webpack-node-externals": "^3.0.4",
+    "eslint": "^9.39.2",
+    "jest": "^29.7.0",
+    "jest-each": "^29.7.0",
+    "kaitai-struct-loader": "^0.9.0",
+    "loader-utils": "^2.0.4",
+    "prettier": "^3.5.3",
+    "signale": "^1.4.0",
+    "stream-buffers": "^3.0.3",
+    "ts-jest": "^29.4.0",
+    "ts-loader": "^9.5.4",
+    "ts-node": "^10.9.2",
+    "ts-patch": "^3.3.0",
+    "typedoc": "^0.28.5",
+    "typedoc-plugin-missing-exports": "^4.1.0",
+    "typescript": "^5.9.3",
+    "typescript-transform-paths": "^3.5.5",
+    "webpack": "^5.104.1",
+    "webpack-cli": "^6.0.1",
+    "webpack-node-externals": "^3.0.0"
+  },
+  "volta": {
+    "node": "22.11.0",
+    "yarn": "1.22.22"
+  }
+}