alphatheta-connect 0.25.0 → 0.25.2

package/lib/localdb/index.d.ts

@@ -1,4 +1,4 @@
-import { type DatabaseAdapter, type DatabasePreference, type DatabaseType } from 'onelibrary-connect';
+import { type DatabaseAdapter, type DatabasePreference, type DatabaseType, type Track } from 'onelibrary-connect';
 import StrictEventEmitter from 'strict-event-emitter-types';
 import { EventEmitter } from 'events';
 import DeviceManager from "../devices";
@@ -56,6 +56,35 @@ interface DatabaseEvents {
     hydrationDone: (opts: HydrationDoneOpts) => void;
 }
 type Emitter = StrictEventEmitter<EventEmitter, DatabaseEvents>;
+/**
+ * What the player knows about the track it is asking us to look up, used to
+ * check that the row a database hands back is really that track.
+ */
+export interface TrackLookupHint {
+    /**
+     * The track's BPM as reported in the player's status packet (unpitched,
+     * two decimals). `null` when the player did not report one.
+     */
+    trackBPM?: number | null;
+}
+/**
+ * The outcome of {@link LocalDatabase.findTrack}.
+ */
+export type TrackLookup = {
+    /** The database that answered */
+    adapter: DatabaseAdapter;
+    track: Track;
+    /**
+     * Set when answering meant switching the slot to its other database
+     * format: the type the slot is now served from.
+     */
+    switchedTo: DatabaseType | null;
+} | {
+    /** The slot's database, or null when the slot has none loaded */
+    adapter: DatabaseAdapter | null;
+    track: null;
+    switchedTo: null;
+};
 /**
  * The local database is responsible for syncing the remote rekordbox databases
  * of media slots on a device into in-memory sqlite databases.
@@ -82,6 +111,23 @@ declare class LocalDatabase {
      * Disconnects the local database connection for the specified device
      */
     disconnectForDevice(device: Device): void;
+    /**
+     * Looks a track up in the databases of a device slot, checking the answer
+     * against what the player reports.
+     *
+     * A Device Library Plus export carries both `exportLibrary.db` and the
+     * legacy `export.pdb`, and their track IDs are different number spaces. A
+     * player that reads one while we loaded the other resolves most IDs to a
+     * different track and some to nothing at all (NP3-399). So when the active
+     * database has no such row, or its row's BPM is not the BPM the player is
+     * showing, the other format is loaded and asked. If it agrees with the
+     * player, the slot switches to it for every later lookup — artwork,
+     * analysis and the next track all follow the database the player is using.
+     *
+     * When neither database can be confirmed, the active database's row (if any)
+     * is returned as before.
+     */
+    findTrack(deviceId: DeviceID, slot: DatabaseSlot, trackId: number, hint?: TrackLookupHint): Promise<TrackLookup>;
     /**
      * Gets the database adapter for the media metadata in the provided device slot.
      *

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alphatheta-connect",
-  "version": "0.25.0",
+  "version": "0.25.2",
   "main": "lib/index.js",
   "author": "Evan Purkhiser <evanpurkhiser@gmail.com>",
   "contributors": [