rekordbox-connect 1.0.0

package/README.md

@@ -0,0 +1,79 @@
+# rekordbox-connect
+
+Library for reading the Rekordbox SQLCipher-encrypted database and emitting events when the library or play history changes. Built to decouple Rekordbox integration out of NowPlaying into a standalone, reusable package.
+
+## Features
+
+- Polls the Rekordbox database file for changes (mtime-based)
+- Typed events: `ready`, `db-changed`, `tracks`, `history`, `error`
+- Incremental history emission (only new plays after start)
+- Uses `better-sqlite3-multiple-ciphers` for SQLCipher support
+- Automatically reads database path and password from Rekordbox `options.json`
+- Decrypts database password using Blowfish encryption
+- Configurable DB path, password, polling interval, track max rows, and history max rows
+
+## Quick Start
+
+```ts
+import { RekordboxConnect } from 'rekordbox-connect';
+
+const rb = new RekordboxConnect({ pollIntervalMs: 2000, maxRows: 5000, historyMaxRows: 100 });
+
+rb.on('ready', (info) => {
+  console.log('Rekordbox ready:', info);
+});
+
+rb.on('db-changed', (change) => {
+  console.log('Database changed:', change);
+});
+
+rb.on('tracks', (payload) => {
+  console.log('Loaded tracks:', payload.count);
+});
+
+rb.on('history', (payload) => {
+  console.log('New plays:', payload.count);
+});
+
+rb.start();
+
+// later
+// rb.stop();
+```
+
+## API
+
+### `new RekordboxConnect(options?)`
+
+Options:
+
+- `dbPath?: string` — Absolute path to the Rekordbox DB. If omitted, read from Rekordbox `options.json`.
+- `dbPassword?: string` — Database password for SQLCipher decryption. If omitted, read and decrypted from Rekordbox `options.json`.
+- `pollIntervalMs?: number` — Milliseconds between file mtime polls. Default `2000`.
+- `maxRows?: number` — Limit for `tracks` emission. Default `5000`.
+- `historyMaxRows?: number` — Limit for `history` emission per poll. Default `100`.
+
+Methods:
+
+- `start()` — Locate/open DB, emit initial `ready`, load tracks/history, and begin polling.
+- `stop()` — Stop polling and close DB handle.
+
+Events:
+
+- `ready` — `{ dbPath, modifiedTime }` when the DB is opened.
+- `db-changed` — `{ dbPath, previousModifiedTime, modifiedTime }` when file mtime increases.
+- `tracks` — `{ dbPath, count, rows }` with a slice of tracks (schema best-effort per Rekordbox version).
+- `history` — `{ dbPath, count, rows, lastRowId }` with new plays since the previous poll.
+- `error` — `(error)` for any recoverable errors.
+
+## Notes
+
+- Rekordbox stores its library as a SQLCipher-encrypted SQLite database. By default, the library reads both the database path and encrypted password from Rekordbox's `options.json` file (located at `~/Library/Application Support/Pioneer/rekordboxAgent/storage/options.json` on macOS).
+- The password is decrypted using Blowfish encryption before opening the database.
+- If `dbPath` and `dbPassword` are not provided, the library automatically locates and reads them from `options.json`.
+- Track schema varies across Rekordbox versions. When unknown, `tracks` emits raw rows from the detected song table (e.g., `djmdSong`). Map to your internal types as needed.
+- History polling is rowid-based: on startup the cursor seeds to the current max rowid, so `history` only emits new plays after the library starts.
+
+## License
+
+See repository license.

package/dist/db.d.ts

@@ -0,0 +1,12 @@
+import type { RekordboxHistoryPayload, RekordboxTracksPayload } from './types';
+export declare class RekordboxDb {
+    private readonly dbPath;
+    private readonly password;
+    private db?;
+    constructor(dbPath: string, password: string);
+    open(): void;
+    close(): void;
+    loadTracks(maxRows?: number): RekordboxTracksPayload | undefined;
+    seedHistoryCursor(): number | undefined;
+    loadNewHistory(sinceRowId: number | undefined, maxRows?: number): RekordboxHistoryPayload | undefined;
+}

package/dist/db.js

@@ -0,0 +1,154 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RekordboxDb = void 0;
+const better_sqlite3_multiple_ciphers_1 = __importDefault(require("better-sqlite3-multiple-ciphers"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const DEFAULT_MAX_ROWS = 5000;
+const DEFAULT_HISTORY_ROWS = 100;
+// Known Rekordbox 6 table names
+const HISTORY_TABLE = 'djmdSongHistory';
+const CONTENT_TABLE = 'djmdContent';
+class RekordboxDb {
+    constructor(dbPath, password) {
+        this.dbPath = dbPath;
+        this.password = password;
+    }
+    open() {
+        this.close();
+        if (!node_fs_1.default.existsSync(this.dbPath)) {
+            throw new Error(`Rekordbox database not found at: ${this.dbPath}`);
+        }
+        this.db = new better_sqlite3_multiple_ciphers_1.default(this.dbPath, { readonly: true });
+        // Configure SQLCipher
+        this.db.pragma(`cipher='sqlcipher'`);
+        this.db.pragma(`legacy=4`);
+        this.db.pragma(`key='${this.password}'`);
+        // Enable reading uncommitted data from WAL (see writes from Rekordbox)
+        this.db.pragma(`read_uncommitted=true`);
+        // Test the connection
+        try {
+            this.db.pragma('cipher_version');
+        }
+        catch (error) {
+            this.db.close();
+            throw new Error('Failed to decrypt Rekordbox database. Invalid password?');
+        }
+    }
+    close() {
+        if (!this.db)
+            return;
+        try {
+            this.db.close();
+        }
+        catch {
+            // ignore close errors
+        }
+        this.db = undefined;
+    }
+    loadTracks(maxRows) {
+        if (!this.db)
+            return;
+        const limit = maxRows ?? DEFAULT_MAX_ROWS;
+        // Query djmdContent with joined metadata (same structure as history query)
+        const query = `
+      SELECT
+        c.ID AS id,
+        c.FolderPath AS filePath,
+        c.Title AS title,
+        c.Subtitle AS subTitle,
+        a.Name AS artist,
+        c.ImagePath AS imagePath,
+        c.BPM AS bpm,
+        c.Rating AS rating,
+        c.ReleaseDate AS releaseDate,
+        c.Length AS length,
+        c.ColorID AS colorId,
+        c.Commnt AS comment,
+        al.Name AS album,
+        la.Name AS label,
+        ge.Name AS genre,
+        k.ScaleName AS key,
+        rmx.Name AS remixer
+      FROM ${CONTENT_TABLE} AS c
+      LEFT JOIN djmdArtist AS a ON c.ArtistID = a.ID
+      LEFT JOIN djmdArtist AS rmx ON c.RemixerID = rmx.ID
+      LEFT JOIN djmdAlbum AS al ON c.AlbumID = al.ID
+      LEFT JOIN djmdLabel AS la ON c.LabelID = la.ID
+      LEFT JOIN djmdGenre AS ge ON c.GenreID = ge.ID
+      LEFT JOIN djmdKey AS k ON c.KeyID = k.ID
+      LIMIT @limit
+    `;
+        try {
+            const rows = this.db.prepare(query).all({ limit });
+            return { dbPath: this.dbPath, count: rows.length, rows };
+        }
+        catch {
+            return { dbPath: this.dbPath, count: 0, rows: [] };
+        }
+    }
+    seedHistoryCursor() {
+        if (!this.db)
+            return undefined;
+        try {
+            const row = this.db.prepare(`SELECT MAX(rowid) as maxRowId FROM ${HISTORY_TABLE}`).get();
+            return row?.maxRowId;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    loadNewHistory(sinceRowId, maxRows) {
+        if (!this.db)
+            return undefined;
+        const limit = maxRows ?? DEFAULT_HISTORY_ROWS;
+        // Query history with joined content and metadata tables
+        const query = `
+      SELECT
+        h.rowid AS rowid,
+        h.ID AS id,
+        h.created_at,
+        c.FolderPath AS filePath,
+        c.Title AS title,
+        c.Subtitle AS subTitle,
+        a.Name AS artist,
+        c.ImagePath AS imagePath,
+        c.BPM AS bpm,
+        c.Rating AS rating,
+        c.ReleaseDate AS releaseDate,
+        c.Length AS length,
+        c.ColorID AS colorId,
+        c.Commnt AS comment,
+        al.Name AS album,
+        la.Name AS label,
+        ge.Name AS genre,
+        k.ScaleName AS key,
+        rmx.Name AS remixer
+      FROM ${HISTORY_TABLE} AS h
+      JOIN ${CONTENT_TABLE} AS c ON h.ContentID = c.ID
+      LEFT JOIN djmdArtist AS a ON c.ArtistID = a.ID
+      LEFT JOIN djmdArtist AS rmx ON c.RemixerID = rmx.ID
+      LEFT JOIN djmdAlbum AS al ON c.AlbumID = al.ID
+      LEFT JOIN djmdLabel AS la ON c.LabelID = la.ID
+      LEFT JOIN djmdGenre AS ge ON c.GenreID = ge.ID
+      LEFT JOIN djmdKey AS k ON c.KeyID = k.ID
+      WHERE h.rowid > @since
+      ORDER BY h.rowid ASC
+      LIMIT @limit
+    `;
+        try {
+            const rows = this.db
+                .prepare(query)
+                .all({ since: sinceRowId ?? 0, limit });
+            const lastRowId = rows.length > 0 ? rows[rows.length - 1].rowid : sinceRowId;
+            return { dbPath: this.dbPath, count: rows.length, rows, lastRowId };
+        }
+        catch {
+            return { dbPath: this.dbPath, count: 0, rows: [], lastRowId: sinceRowId };
+        }
+    }
+}
+exports.RekordboxDb = RekordboxDb;
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":";;;;;;AACA,sGAAkE;AAClE,sDAAyB;AAGzB,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,gCAAgC;AAChC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AACxC,MAAM,aAAa,GAAG,aAAa,CAAC;AAEpC,MAAa,WAAW;IAGtB,YACmB,MAAc,EACd,QAAgB;QADhB,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAQ;IAChC,CAAC;IAEJ,IAAI;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,IAAI,yCAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnE,sBAAsB;QACtB,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC3B,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAEzC,uEAAuE;QACvE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAExC,sBAAsB;QACtB,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO;QACrB,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QACD,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC;IACtB,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO;QAErB,MAAM,KAAK,GAAG,OAAO,IAAI,gBAAgB,CAAC;QAE1C,2EAA2E;QAC3E,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;aAmBL,aAAa;;;;;;;;KAQrB,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAA8B,CAAC;YAChF,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACrD,CAAC;IACH,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,sCAAsC,aAAa,EAAE,CAAC,CAAC,GAAG,EAAuC,CAAC;YAC9H,OAAO,GAAG,EAAE,QAAQ,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,cAAc,CAAC,UAA8B,EAAE,OAAgB;QAC7D,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAE/B,MAAM,KAAK,GAAG,OAAO,IAAI,oBAAoB,CAAC;QAE9C,wDAAwD;QACxD,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;aAqBL,aAAa;aACb,aAAa;;;;;;;;;;KAUrB,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;iBACjB,OAAO,CAAC,KAAK,CAAC;iBACd,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,IAAI,CAAC,EAAE,KAAK,EAAE,CAA8B,CAAC;YAEvE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAS,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;YAEtF,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC;CACF;AAvJD,kCAuJC"}

package/dist/detectDb.d.ts

@@ -0,0 +1,17 @@
+import type { RekordboxOptions } from './types';
+export declare function detectRekordboxDbPath(explicit?: string): string | undefined;
+/**
+ * Get the default options.json path for the current platform
+ */
+export declare function getOptionsPath(): string;
+/**
+ * Read and parse Rekordbox options.json
+ */
+export declare function readRekordboxOptions(): RekordboxOptions;
+/**
+ * Get database path and decrypted password from options.json
+ */
+export declare function getRekordboxConfig(explicitDbPath?: string, explicitPassword?: string): {
+    dbPath: string;
+    password: string;
+};

package/dist/detectDb.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectRekordboxDbPath = detectRekordboxDbPath;
+exports.getOptionsPath = getOptionsPath;
+exports.readRekordboxOptions = readRekordboxOptions;
+exports.getRekordboxConfig = getRekordboxConfig;
+const egoroof_blowfish_1 = __importDefault(require("egoroof-blowfish"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const types_1 = require("./types");
+const SQLITE_EXTENSIONS = ['.db', '.sqlite'];
+function detectRekordboxDbPath(explicit) {
+    if (explicit)
+        return explicit;
+    const candidates = [];
+    const home = node_os_1.default.homedir();
+    if (process.platform === 'darwin') {
+        candidates.push(node_path_1.default.join(home, 'Library', 'Application Support', 'Pioneer', 'rekordbox'), node_path_1.default.join(home, 'Library', 'Pioneer', 'rekordbox'));
+    }
+    else if (process.platform === 'win32') {
+        const appData = process.env.APPDATA || node_path_1.default.join(home, 'AppData', 'Roaming');
+        const localAppData = process.env.LOCALAPPDATA || node_path_1.default.join(home, 'AppData', 'Local');
+        candidates.push(node_path_1.default.join(appData, 'Pioneer', 'rekordbox'), node_path_1.default.join(localAppData, 'Pioneer', 'rekordbox'));
+    }
+    else {
+        // Best-effort guess for Linux/Wine environments
+        candidates.push(node_path_1.default.join(home, '.Pioneer', 'rekordbox'), node_path_1.default.join(home, '.wine', 'drive_c', 'Pioneer', 'rekordbox'));
+    }
+    const dbFiles = discoverDbFiles(candidates);
+    if (dbFiles.length === 0)
+        return undefined;
+    const newest = dbFiles
+        .map((f) => {
+        try {
+            return { f, mtime: node_fs_1.default.statSync(f).mtimeMs };
+        }
+        catch {
+            return { f, mtime: 0 };
+        }
+    })
+        .sort((a, b) => b.mtime - a.mtime)[0];
+    return newest?.f;
+}
+function discoverDbFiles(dirs) {
+    const results = [];
+    for (const dir of dirs) {
+        try {
+            const entries = node_fs_1.default.readdirSync(dir);
+            for (const name of entries) {
+                const ext = node_path_1.default.extname(name).toLowerCase();
+                if (SQLITE_EXTENSIONS.includes(ext) || name.toLowerCase().includes('rekordbox') && ext) {
+                    results.push(node_path_1.default.join(dir, name));
+                }
+            }
+        }
+        catch {
+            // directory may not exist or be unreadable
+        }
+    }
+    return results;
+}
+/**
+ * Get the default options.json path for the current platform
+ */
+function getOptionsPath() {
+    const home = node_os_1.default.homedir();
+    if (process.platform === 'darwin') {
+        return node_path_1.default.join(home, 'Library', 'Application Support', 'Pioneer', 'rekordboxAgent', 'storage', 'options.json');
+    }
+    else if (process.platform === 'win32') {
+        const appData = process.env.APPDATA || node_path_1.default.join(home, 'AppData', 'Roaming');
+        return node_path_1.default.join(appData, 'Pioneer', 'rekordboxAgent', 'storage', 'options.json');
+    }
+    else {
+        // Best-effort guess for Linux/Wine
+        return node_path_1.default.join(home, '.Pioneer', 'rekordboxAgent', 'storage', 'options.json');
+    }
+}
+/**
+ * Read and parse Rekordbox options.json
+ */
+function readRekordboxOptions() {
+    const optionsPath = getOptionsPath();
+    if (!node_fs_1.default.existsSync(optionsPath)) {
+        throw new Error(`Rekordbox options.json not found at: ${optionsPath}`);
+    }
+    const data = node_fs_1.default.readFileSync(optionsPath, 'utf8');
+    return JSON.parse(data);
+}
+/**
+ * Get database path and decrypted password from options.json
+ */
+function getRekordboxConfig(explicitDbPath, explicitPassword) {
+    // Use custom path/password if provided
+    if (explicitDbPath && explicitPassword) {
+        return {
+            dbPath: explicitDbPath,
+            password: explicitPassword,
+        };
+    }
+    const options = readRekordboxOptions();
+    const dbPathOption = options.options.find((opt) => opt[0] === 'db-path');
+    const passwordOption = options.options.find((opt) => opt[0] === 'dp');
+    if (!dbPathOption || !passwordOption) {
+        throw new Error('Could not find database path or password in Rekordbox options');
+    }
+    // Decrypt password using Blowfish
+    const bf = new egoroof_blowfish_1.default(types_1.REKORDBOX_MAGIC, egoroof_blowfish_1.default.MODE.ECB, egoroof_blowfish_1.default.PADDING.PKCS5);
+    const encryptedPassword = Buffer.from(passwordOption[1], 'base64');
+    const decryptedPassword = bf
+        .decode(encryptedPassword, egoroof_blowfish_1.default.TYPE.STRING)
+        .trim();
+    return {
+        dbPath: explicitDbPath || dbPathOption[1],
+        password: explicitPassword || decryptedPassword,
+    };
+}
+//# sourceMappingURL=detectDb.js.map

package/dist/detectDb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectDb.js","sourceRoot":"","sources":["../src/detectDb.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { RekordboxConnect } from './rekordboxConnect';
+export type { RekordboxConnectEvents, RekordboxConnectOptions, RekordboxHistoryPayload, RekordboxOptions, RekordboxReadyInfo, RekordboxTracksPayload } from './types';
+export { REKORDBOX_MAGIC } from './types';
+export { detectRekordboxDbPath, getRekordboxConfig, getOptionsPath, readRekordboxOptions } from './detectDb';

package/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readRekordboxOptions = exports.getOptionsPath = exports.getRekordboxConfig = exports.detectRekordboxDbPath = exports.REKORDBOX_MAGIC = exports.RekordboxConnect = void 0;
+var rekordboxConnect_1 = require("./rekordboxConnect");
+Object.defineProperty(exports, "RekordboxConnect", { enumerable: true, get: function () { return rekordboxConnect_1.RekordboxConnect; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "REKORDBOX_MAGIC", { enumerable: true, get: function () { return types_1.REKORDBOX_MAGIC; } });
+var detectDb_1 = require("./detectDb");
+Object.defineProperty(exports, "detectRekordboxDbPath", { enumerable: true, get: function () { return detectDb_1.detectRekordboxDbPath; } });
+Object.defineProperty(exports, "getRekordboxConfig", { enumerable: true, get: function () { return detectDb_1.getRekordboxConfig; } });
+Object.defineProperty(exports, "getOptionsPath", { enumerable: true, get: function () { return detectDb_1.getOptionsPath; } });
+Object.defineProperty(exports, "readRekordboxOptions", { enumerable: true, get: function () { return detectDb_1.readRekordboxOptions; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AASzB,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AACxB,uCAKoB;AAJhB,iHAAA,qBAAqB,OAAA;AACrB,8GAAA,kBAAkB,OAAA;AAClB,0GAAA,cAAc,OAAA;AACd,gHAAA,oBAAoB,OAAA"}

package/dist/rekordboxConnect.d.ts

@@ -0,0 +1,20 @@
+import type { RekordboxConnectEvents, RekordboxConnectOptions, TypedEmitter } from './types';
+declare const RekordboxConnect_base: {
+    new (): TypedEmitter;
+};
+export declare class RekordboxConnect extends RekordboxConnect_base {
+    private readonly pollIntervalMs;
+    private readonly historyMaxRows?;
+    private readonly explicitDbPath?;
+    private readonly explicitDbPassword?;
+    private dbPath?;
+    private timer?;
+    private db?;
+    private lastHistoryRowId?;
+    constructor(opts?: RekordboxConnectOptions);
+    start(): void;
+    stop(): void;
+    private pollOnce;
+    private loadHistorySafe;
+}
+export type { RekordboxConnectEvents, RekordboxConnectOptions };

package/dist/rekordboxConnect.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RekordboxConnect = void 0;
+const node_events_1 = __importDefault(require("node:events"));
+const db_1 = require("./db");
+const detectDb_1 = require("./detectDb");
+class RekordboxConnect extends node_events_1.default {
+    constructor(opts = {}) {
+        super();
+        this.pollIntervalMs = opts.pollIntervalMs ?? 2000;
+        this.explicitDbPath = opts.dbPath;
+        this.explicitDbPassword = opts.dbPassword;
+        this.historyMaxRows = opts.historyMaxRows;
+    }
+    start() {
+        try {
+            // Get database path and password from options.json or explicit config
+            const { dbPath, password } = (0, detectDb_1.getRekordboxConfig)(this.explicitDbPath, this.explicitDbPassword);
+            this.dbPath = dbPath;
+            this.db = new db_1.RekordboxDb(dbPath, password);
+            this.db.open();
+            this.lastHistoryRowId = this.db.seedHistoryCursor();
+            this.emit('ready', { dbPath: this.dbPath });
+            this.timer = setInterval(() => this.pollOnce(), this.pollIntervalMs);
+        }
+        catch (err) {
+            this.emit('error', err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+        if (this.db) {
+            this.db.close();
+            this.db = undefined;
+        }
+    }
+    pollOnce() {
+        if (!this.dbPath || !this.db)
+            return;
+        try {
+            this.emit('poll');
+            // Always poll history directly - mtime checks are unreliable with SQLite WAL mode
+            this.loadHistorySafe();
+        }
+        catch (err) {
+            this.emit('error', err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    loadHistorySafe() {
+        if (!this.db)
+            return;
+        try {
+            const payload = this.db.loadNewHistory(this.lastHistoryRowId, this.historyMaxRows);
+            if (payload && payload.count > 0) {
+                this.lastHistoryRowId = payload.lastRowId ?? this.lastHistoryRowId;
+                this.emit('history', payload);
+            }
+        }
+        catch (err) {
+            this.emit('error', err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+}
+exports.RekordboxConnect = RekordboxConnect;
+//# sourceMappingURL=rekordboxConnect.js.map

package/dist/rekordboxConnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rekordboxConnect.js","sourceRoot":"","sources":["../src/rekordboxConnect.ts"],"names":[],"mappings":"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"}

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/db.ts","../src/detectdb.ts","../src/index.ts","../src/rekordboxconnect.ts","../src/types.ts"],"version":"5.9.3"}

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+import EventEmitter from 'node:events';
+import type { StrictEventEmitter } from 'strict-event-emitter-types';
+export type RekordboxConnectOptions = {
+    /** Optional absolute path to the Rekordbox SQLite database. If omitted, read from options.json. */
+    dbPath?: string;
+    /** Optional database password for SQLCipher decryption. If omitted, read from options.json. */
+    dbPassword?: string;
+    /** How frequently to poll the DB file modified time (ms). */
+    pollIntervalMs?: number;
+    /** Maximum number of tracks to fetch per emission. */
+    maxRows?: number;
+    /** Maximum number of new history rows to emit per poll. */
+    historyMaxRows?: number;
+};
+/**
+ * Rekordbox options.json structure (partial)
+ */
+export interface RekordboxOptions {
+    options: Array<[string, string]>;
+}
+/**
+ * Magic string for Blowfish password decryption
+ */
+export declare const REKORDBOX_MAGIC = "ZOwUlUZYqe9Rdm6j";
+export type RekordboxReadyInfo = {
+    dbPath: string;
+};
+export type RekordboxTracksPayload = {
+    dbPath: string;
+    count: number;
+    rows: Record<string, unknown>[];
+};
+export type RekordboxHistoryPayload = {
+    dbPath: string;
+    count: number;
+    rows: Record<string, unknown>[];
+    lastRowId?: number;
+};
+export interface RekordboxConnectEvents {
+    ready: (info: RekordboxReadyInfo) => void;
+    poll: () => void;
+    tracks: (payload: RekordboxTracksPayload) => void;
+    history: (payload: RekordboxHistoryPayload) => void;
+    error: (err: Error) => void;
+}
+export type TypedEmitter = StrictEventEmitter<EventEmitter, RekordboxConnectEvents>;

package/dist/types.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REKORDBOX_MAGIC = void 0;
+/**
+ * Magic string for Blowfish password decryption
+ */
+exports.REKORDBOX_MAGIC = 'ZOwUlUZYqe9Rdm6j';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAuBA;;GAEG;AACU,QAAA,eAAe,GAAG,kBAAkB,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "rekordbox-connect",
+  "version": "1.0.0",
+  "description": "Library to read the Rekordbox database and emit change events",
+  "private": false,
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:integration": "vitest run --config vitest.integration.config.mts",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "build": "tsc --build tsconfig.json",
+    "watch": "tsc --build tsconfig.json -w",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm test",
+    "release": "node .github/release.js",
+    "release:patch": "node .github/release.js --patch",
+    "release:major": "node .github/release.js --major"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "better-sqlite3-multiple-ciphers": "^11.7.1",
+    "egoroof-blowfish": "^2.2.2",
+    "strict-event-emitter-types": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.15.29",
+    "@vitest/coverage-v8": "^1.6.0",
+    "prettier": "^3.5.3",
+    "typescript": "^5.9.3",
+    "vitest": "^1.3.0"
+  }
+}