alphatheta-connect 0.23.2 → 0.25.1

package/lib/constants.d.ts

@@ -1,8 +1,10 @@
 /**
  * The default virtual CDJ ID to use.
  *
- * This particular ID is out of the 1-6 range, thus will not be able to request
- * metadata via the remotedb for CDJs.
+ * Out of the 1-6 player range, so it can never collide with a real CDJ.
+ * Remotedb metadata still works from here: the 1-6 restriction applies to the
+ * device-ID byte inside remotedb messages, which RemoteDatabase picks
+ * per-connection independently of the announced ID.
  */
 export declare const DEFAULT_VCDJ_ID = 7;
 /**

package/lib/db/getMetadata.d.ts

@@ -1,5 +1,6 @@
 import { Track } from "../entities";
 import LocalDatabase from "../localdb";
+import { DatabaseType } from "../localdb/database-adapter";
 import RemoteDatabase from "../remotedb";
 import { Device, DeviceID, MediaSlot, TrackType } from "../types";
 import { TelemetrySpan as Span } from "../utils/telemetry";
@@ -20,6 +21,12 @@ export interface Options {
      * The track id to retrieve metadata for
      */
     trackId: number;
+    /**
+     * The track's BPM as the player reports it in its status packet, when known.
+     * Used to check that the local database row for `trackId` is really the
+     * track the player is showing (see {@link LocalDatabase.findTrack}).
+     */
+    trackBPM?: number | null;
     /**
      * The Sentry transaction span
      */
@@ -43,9 +50,15 @@ export type LocalMiss =
 export type LocalResult = {
     track: Track;
     miss: null;
+    /**
+     * Set when the slot had to switch to its other database format to
+     * answer: the format it is now served from.
+     */
+    switchedTo: DatabaseType | null;
 } | {
     track: null;
     miss: LocalMiss;
+    switchedTo: null;
 };
 export declare function viaRemote(remote: RemoteDatabase, opts: Required<Options>): Promise<Track<import("../entities").EntityFK.WithRelations> | null>;
 export declare function viaLocal(local: LocalDatabase, device: Device, opts: Required<Options>): Promise<LocalResult>;

package/lib/index.d.ts

@@ -13,8 +13,8 @@ export { fetchFile } from './nfs';
 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 type { DeviceLike, PickDeviceIdOptions } from './virtualcdj/device-id';
-export { DEFAULT_MIXER_PLAYER_CEILING, MAX_DEVICE_ID, MIXER_PLAYER_CEILING, pickAvailableDeviceId, playerNumberCeiling, REMOTEDB_MAX_DEVICE_ID, } from './virtualcdj/device-id';
+export type { DeviceLike, PickDeviceIdOptions, QueryIdDeviceLike, } from './virtualcdj/device-id';
+export { DEFAULT_MIXER_PLAYER_CEILING, MAX_DEVICE_ID, MIXER_PLAYER_CEILING, pickAvailableDeviceId, pickRemoteDbQueryId, playerNumberCeiling, REMOTEDB_MAX_DEVICE_ID, } from './virtualcdj/device-id';
 export type { Logger } from './logger';
 export { noopLogger } from './logger';
 export * from './types';