alphatheta-connect 0.15.0 → 0.18.0

package/README.md

@@ -15,14 +15,18 @@
 
 ---
 
-This library implements the Pioneer PROLINK network protocol + additional
+This library implements the AlphaTheta PROLINK network protocol + additional
 functionality to interact with the prolink network. This library is used as
-part of [Prolink Tools](https://prolink.tools/).
+part of [Now Playing](https://nowplayingapp.com/).
 
 Alternative implementations of the Prolink protocol: [Java](https://github.com/Deep-Symmetry/beat-link), [golang](https://github.com/evanpurkhiser/prolink-go).
 
 ## Features
 
+- **Streaming Service Detection** *(new)* - Detect when tracks are loaded from
+  streaming services (Beatport, Streaming Direct Play, TIDAL, Apple Music) via
+  `MediaSlot` enum. Supports CDJ-3000X CloudDirectPlay streaming features.
+
 - **Support for AlphaTheta Opus Quad, XDJ-RX3, XDJ-RX2, XDJ-RX, and XDJ-XZ** *(new)* -
   Passive mode monitoring via pcap-based packet capture for all-in-one controllers
   where traditional virtual CDJ connection isn't possible.
@@ -46,10 +50,23 @@ Alternative implementations of the Prolink protocol: [Java](https://github.com/D
   sequence for better compatibility with certain device configurations.
   See [FULL_STARTUP.md](docs/FULL_STARTUP.md) for details.
 
+- **Metadata Extraction via NFS** *(new)* - Extract complete track metadata (title,
+  artist, album, BPM, key, artwork) directly from audio files on connected media
+  using partial file reads — only file headers are downloaded, not entire files.
+
+- **3-Band Waveforms & Vocal Detection** *(new)* - Parse `.2EX` analysis files for
+  3-band color waveform preview (PWV6), 3-band color detail waveform (PWV7), and
+  vocal detection config (PWVC).
+
+- **Track Analysis API** *(new)* - Unified `getTrackAnalysis()` method that retrieves
+  all analysis data (extended cues, song structure, waveforms, 3-band waveforms,
+  vocal config) from both EXT and 2EX files in a single call.
+
 - **Extended ANLZ Support** - Full support for rekordbox analysis files including:
   - Extended cues with RGB colors and comments (PCO2)
   - Song structure / phrase analysis for CDJ-3000 (PSSI)
-  - Multiple waveform formats (PWAV, PWV2, PWV3, PWV4, PWV5)
+  - Multiple waveform formats (PWAV, PWV2, PWV3, PWV4, PWV5, PWV6, PWV7)
+  - Vocal detection config (PWVC)
   - See [EXTENDED_ANLZ.md](docs/EXTENDED_ANLZ.md) for details
 
 - **CDJ-3000 Features** - Complete support for CDJ-3000 specific features:
@@ -164,3 +181,12 @@ async function main() {
 - [Deep Symmetry](https://github.com/Deep-Symmetry) - For [crate-digger](https://github.com/Deep-Symmetry/crate-digger) and maintaining comprehensive Pro DJ Link protocol documentation
 - [@henrybetts](https://github.com/henrybetts) and [@flesniak](https://github.com/flesniak) - For reverse-engineering the rekordbox database format
 - [@GreyCat](https://github.com/GreyCat) - For Kaitai Struct expertise and guidance
+
+## Related Projects
+
+- [stagelinq](https://github.com/chrisle/stagelinq) — Denon StageLinq protocol integration
+- [metadata-connect](https://github.com/chrisle/metadata-connect) — Audio metadata extraction with partial file reads
+- [rekordbox-connect](https://github.com/chrisle/rekordbox-connect) — Rekordbox database integration
+- [serato-connect](https://github.com/chrisle/serato-connect) — Serato DJ integration
+
+These libraries power [Now Playing](https://nowplayingapp.com) — a real-time track display app for DJs and streamers.

package/lib/artwork/index.d.ts

@@ -1,3 +1,4 @@
+import { type Logger } from "../logger";
 import { NfsMediaSlot } from "../nfs";
 import { Device } from "../types";
 import { ExtractedArtwork, FileReader } from './types';
@@ -6,4 +7,4 @@ export type { ExtractedArtwork, FileReader } from './types';
 export { PictureType } from './types';
 export declare function isArtworkExtractionSupported(extension: string): boolean;
 export declare function extractArtwork(reader: FileReader): Promise<ExtractedArtwork | null>;
-export declare function extractArtworkFromDevice(device: Device, slot: NfsMediaSlot, filePath: string): Promise<ExtractedArtwork | null>;
+export declare function extractArtworkFromDevice(device: Device, slot: NfsMediaSlot, filePath: string, logger?: Logger): Promise<ExtractedArtwork | null>;