tserato 0.1.0 → 0.1.11

package/.github/workflows/release.yml

@@ -0,0 +1,53 @@
+name: Release
+
+on:
+  release:
+    types: [created]
+
+permissions:
+  id-token: write  # Required for OIDC
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org/
+
+      # Ensure npm 11.5.1 or later for trusted publishing
+      - run: npm install -g npm@latest
+
+      - run: node --version && npm --version
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Extract version from git tag
+        id: version
+        run: |
+          TAG="${{ github.event.release.tag_name }}"
+          VERSION="${TAG#v}"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Set package.json version
+        run: |
+          npm version ${{ steps.version.outputs.version }} --no-git-tag-version
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish
+        env:
+          NPM_CONFIG_PROVENANCE: true

package/dist/builder.d.ts

@@ -1,12 +1,13 @@
 import { BaseEncoder } from './encoders/baseEncoder';
 import { Crate } from './model/crate';
+export declare const DEFAULT_SERATO_FOLDER: string;
 export declare class Builder {
     private _encoder?;
     constructor(encoder?: BaseEncoder);
     private static _resolvePath;
     private static _parseCrateNames;
     private _buildCrateFilepath;
-    parseCratesFromRootPath(subcratePath: string): Record<string, Crate>;
+    parseCratesFromRootPath(subcratePath: string): Map<string, Crate>;
     private _buildCratesFromFilepath;
     private _parseCrateTracks;
     private _construct;

package/dist/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAMtC,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,CAAc;gBACnB,OAAO,CAAC,EAAE,WAAW;IAEjC,OAAO,CAAC,MAAM,CAAE,YAAY;IAc5B,OAAO,CAAC,MAAM,CAAE,gBAAgB;IAKhC,OAAO,CAAE,mBAAmB;IAQ5B,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAiBpE,OAAO,CAAC,wBAAwB;IAqBhC,OAAO,CAAE,iBAAiB;IAkB1B,OAAO,CAAC,UAAU;IA2DlB,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,GAAE,MAA8B,EAAE,SAAS,UAAQ;CAO9E"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAItC,eAAO,MAAM,qBAAqB,QAIjC,CAAC;AAEF,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,CAAc;gBACnB,OAAO,CAAC,EAAE,WAAW;IAEjC,OAAO,CAAC,MAAM,CAAE,YAAY;IAc5B,OAAO,CAAC,MAAM,CAAE,gBAAgB;IAKhC,OAAO,CAAE,mBAAmB;IAQ5B,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAoBjE,OAAO,CAAC,wBAAwB;IAsChC,OAAO,CAAE,iBAAiB;IA+B1B,OAAO,CAAC,UAAU;IAwDlB,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,GAAE,MAA8B,EAAE,SAAS,UAAQ,GAAG,IAAI;CAOrF"}

package/dist/builder.js

@@ -33,13 +33,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Builder = void 0;
+exports.Builder = exports.DEFAULT_SERATO_FOLDER = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const crate_1 = require("./model/crate");
 const track_1 = require("./model/track");
 const util_1 = require("./util");
-const DEFAULT_SERATO_FOLDER = path.join(process.env.HOME || process.cwd(), 'Music', '_Serato_');
+exports.DEFAULT_SERATO_FOLDER = path.join(process.env.HOME ?? process.cwd(), 'Music', '_Serato_');
 class Builder {
     constructor(encoder) { this._encoder = encoder; }
     static *_resolvePath(root) {
@@ -49,9 +49,8 @@ class Builder {
             const [crate, p] = stack.pop();
             let newPath = p + `${crate.name}%%`;
             const children = crate.children;
-            if (children && children.length) {
-                for (const child of children)
-                    stack.push([child, newPath]);
+            for (const child of children.values()) {
+                stack.push([child, newPath]);
             }
             yield [crate, newPath.replace(/%%$/, '') + '.crate'];
         }
@@ -70,63 +69,67 @@ class Builder {
         }
     }
     parseCratesFromRootPath(subcratePath) {
-        const result = {};
-        const entries = fs.readdirSync(subcratePath);
-        for (const name of entries) {
-            if (!name.endsWith('crate'))
+        // map from top-level crate name to crate
+        const topLevelCrateMap = new Map();
+        for (const entry of fs.readdirSync(subcratePath, { withFileTypes: true })) {
+            if (!entry.isFile() || !entry.name.endsWith("crate")) {
                 continue;
-            const full = path.join(subcratePath, name);
-            const crate = this._buildCratesFromFilepath(full);
-            if (result[crate.name]) {
-                const merged_crate = crate.plus(result[crate.name]);
-                result[crate.name] = merged_crate;
             }
-            else {
-                result[crate.name] = crate;
+            const fullPath = path.join(subcratePath, entry.name);
+            const crate = this._buildCratesFromFilepath(fullPath, topLevelCrateMap);
+            if (!topLevelCrateMap.has(crate.name)) {
+                topLevelCrateMap.set(crate.name, crate);
             }
         }
-        return result;
+        return topLevelCrateMap;
     }
-    _buildCratesFromFilepath(filepath) {
+    _buildCratesFromFilepath(filepath, topLevelCrateMap) {
         const crateNames = Array.from(Builder._parseCrateNames(filepath));
-        let childCrate = null;
-        let crate = null;
-        for (const crateName of crateNames.reverse()) {
-            if (childCrate == null) {
-                crate = new crate_1.Crate(crateName);
-                for (const filePath of this._parseCrateTracks(filepath)) {
-                    const t = track_1.Track.fromPath(filePath);
-                    crate.addTrack(t);
-                }
-                childCrate = crate;
-            }
-            else {
-                crate = new crate_1.Crate(crateName, [childCrate]);
-                childCrate = crate;
+        if (crateNames.length === 0) {
+            throw new Error(`No crates parsed from ${filepath}`);
+        }
+        const tracks = [];
+        for (const p of this._parseCrateTracks(filepath)) {
+            tracks.push(track_1.Track.fromPath(p));
+        }
+        let root = topLevelCrateMap.get(crateNames[0]);
+        if (!root) {
+            root = new crate_1.Crate(crateNames[0]);
+        }
+        let current = root;
+        for (const crateName of crateNames.slice(1)) {
+            let nextCrate = current.children.get(crateName);
+            if (!nextCrate) {
+                nextCrate = new crate_1.Crate(crateName);
+                current.children.set(crateName, nextCrate);
             }
+            current = nextCrate;
+        }
+        for (const track of tracks) {
+            current.addTrack(track);
         }
-        if (!crate)
-            throw new Error(`no crates parsed from ${filepath}`);
-        return crate;
+        return root;
     }
     *_parseCrateTracks(filepath) {
         let buffer = fs.readFileSync(filepath);
-        buffer = Buffer.from(buffer);
+        const OTRK = Buffer.from("otrk", "utf8");
+        const PTRK = Buffer.from("ptrk", "utf8");
         while (buffer.length > 0) {
-            const otrkIdx = buffer.indexOf(Buffer.from('otrk'));
+            const otrkIdx = buffer.indexOf(OTRK);
             if (otrkIdx < 0)
                 break;
-            const ptrkIdx = buffer.indexOf(Buffer.from('ptrk'), otrkIdx);
+            const ptrkIdx = buffer.indexOf(PTRK);
             if (ptrkIdx < 0)
                 break;
             const ptrkSection = buffer.slice(ptrkIdx);
             const trackNameLength = ptrkSection.readUInt32BE(4);
             const trackNameEncoded = ptrkSection.slice(8, 8 + trackNameLength);
             let filePath = (0, util_1.seratoDecode)(trackNameEncoded);
-            if (!filePath.startsWith('/'))
-                filePath = '/' + filePath;
+            if (!filePath.startsWith("/")) {
+                filePath = "/" + filePath;
+            }
             yield filePath;
-            buffer = ptrkSection.slice(8 + trackNameLength);
+            buffer = buffer.slice(ptrkIdx + 8 + trackNameLength);
         }
     }
     _construct(crate) {
@@ -155,27 +158,25 @@ class Builder {
         const columnSection = (0, util_1.concatBytes)(parts);
         // ----- PLAYLIST SECTION -----
         const playlistParts = [];
-        if (crate.tracks) {
-            for (const track of crate.tracks) {
-                if (this._encoder) {
-                    this._encoder.write(track);
-                }
-                const absoluteTrackPath = path.resolve(track.path);
-                const otrkSize = (0, util_1.intToBytes)(absoluteTrackPath.length * 2 + 8, 4);
-                const ptrkSize = (0, util_1.intToBytes)(absoluteTrackPath.length * 2, 4);
-                playlistParts.push((0, util_1.latin1Encode)("otrk"));
-                playlistParts.push(otrkSize);
-                playlistParts.push((0, util_1.latin1Encode)("ptrk"));
-                playlistParts.push(ptrkSize);
-                playlistParts.push((0, util_1.seratoEncode)(absoluteTrackPath));
+        for (const track of crate.tracks) {
+            if (this._encoder) {
+                this._encoder.write(track);
             }
+            const absoluteTrackPath = path.resolve(track.path);
+            const otrkSize = (0, util_1.intToBytes)(absoluteTrackPath.length * 2 + 8, 4);
+            const ptrkSize = (0, util_1.intToBytes)(absoluteTrackPath.length * 2, 4);
+            playlistParts.push((0, util_1.latin1Encode)("otrk"));
+            playlistParts.push(otrkSize);
+            playlistParts.push((0, util_1.latin1Encode)("ptrk"));
+            playlistParts.push(ptrkSize);
+            playlistParts.push((0, util_1.seratoEncode)(absoluteTrackPath));
         }
         const playlistSection = (0, util_1.concatBytes)(playlistParts);
         // ----- FINAL CONTENTS -----
         const contents = (0, util_1.concatBytes)([header, columnSection, playlistSection]);
         return contents;
     }
-    save(root, savePath = DEFAULT_SERATO_FOLDER, overwrite = false) {
+    save(root, savePath = exports.DEFAULT_SERATO_FOLDER, overwrite = false) {
         for (const [crate, filepath] of this._buildCrateFilepath(root, savePath)) {
             if (fs.existsSync(filepath) && !overwrite)
                 continue;

package/dist/encoders/v2/v2Mp3Encoder.d.ts

@@ -1,11 +1,13 @@
 import { HotCue } from '../../../src/model/hotCue';
 import { Track } from '../../model/track';
 import { BaseEncoder } from '../baseEncoder';
+import { TrackMeta } from '../../model/trackMeta';
 export declare class V2Mp3Encoder extends BaseEncoder {
     get tagName(): string;
     get tagVersion(): Buffer;
     get markersName(): string;
     write(track: Track): void;
+    readMetaData(track: Track): TrackMeta;
     readCues(track: Track): HotCue[];
     private _decode;
     private _removeNullPadding;

package/dist/encoders/v2/v2Mp3Encoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v2Mp3Encoder.d.ts","sourceRoot":"","sources":["../../../src/encoders/v2/v2Mp3Encoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAiC7C,qBAAa,YAAa,SAAQ,WAAW;IAE3C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAKzB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE;IAoBhC,OAAO,CAAE,OAAO;IAmDhB,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,MAAM;IAkCd,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;CASvB"}
+{"version":3,"file":"v2Mp3Encoder.d.ts","sourceRoot":"","sources":["../../../src/encoders/v2/v2Mp3Encoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI7C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AA8BlD,qBAAa,YAAa,SAAQ,WAAW;IAE3C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAKzB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS;IAcrC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE;IAoBhC,OAAO,CAAE,OAAO;IAmDhB,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,MAAM;IAkCd,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,cAAc;CASvB"}

package/dist/encoders/v2/v2Mp3Encoder.js

@@ -49,6 +49,17 @@ class V2Mp3Encoder extends baseEncoder_1.BaseEncoder {
         const payload = this._encode(track);
         this._write(track, payload);
     }
+    readMetaData(track) {
+        const buffer = fs.readFileSync(track.path.toString());
+        const mp3tag = new mp3tag_js_1.default(buffer, true);
+        mp3tag.read();
+        const v2 = mp3tag.tags.v2;
+        return {
+            title: v2?.TIT2,
+            artist: v2?.TPE1,
+            album: v2?.TALB
+        };
+    }
     readCues(track) {
         // Read the buffer of an audio file
         const buffer = fs.readFileSync(track.path.toString());
@@ -56,7 +67,7 @@ class V2Mp3Encoder extends baseEncoder_1.BaseEncoder {
         const mp3tag = new mp3tag_js_1.default(buffer, true);
         mp3tag.read();
         const geob = mp3tag.tags.v2?.GEOB;
-        if (!geob || !geob) {
+        if (!geob) {
             return [];
         }
         const data = Buffer.from(geob[0].object);

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-export { Builder } from './builder';
+export { Builder, DEFAULT_SERATO_FOLDER } from './builder';
 export { V2Mp3Encoder } from './encoders/v2/v2Mp3Encoder';
 export { Crate } from './model/crate';
 export { Track } from './model/track';
+export { TrackMeta } from './model/trackMeta';
 export { HotCue } from './model/hotCue';
 export { HotCueType } from './model/hotCueType';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HotCueType = exports.HotCue = exports.Track = exports.Crate = exports.V2Mp3Encoder = exports.Builder = void 0;
+exports.HotCueType = exports.HotCue = exports.Track = exports.Crate = exports.V2Mp3Encoder = exports.DEFAULT_SERATO_FOLDER = exports.Builder = void 0;
 var builder_1 = require("./builder");
 Object.defineProperty(exports, "Builder", { enumerable: true, get: function () { return builder_1.Builder; } });
+Object.defineProperty(exports, "DEFAULT_SERATO_FOLDER", { enumerable: true, get: function () { return builder_1.DEFAULT_SERATO_FOLDER; } });
 var v2Mp3Encoder_1 = require("./encoders/v2/v2Mp3Encoder");
 Object.defineProperty(exports, "V2Mp3Encoder", { enumerable: true, get: function () { return v2Mp3Encoder_1.V2Mp3Encoder; } });
 var crate_1 = require("./model/crate");

package/dist/model/crate.d.ts

@@ -3,13 +3,11 @@ export declare class Crate {
     private _children;
     readonly name: string;
     private _tracks;
-    constructor(name: string, children?: Crate[]);
-    get children(): Crate[];
+    constructor(name: string, children?: Map<string, Crate>);
+    get children(): Map<string, Crate>;
     get tracks(): Set<Track>;
     addTrack(track: Track): void;
     toString(): string;
-    plus(other: Crate): Crate;
-    deepCopy(memodict?: Map<any, any>): Crate;
     equals(other: Crate): boolean;
 }
 //# sourceMappingURL=crate.d.ts.map

package/dist/model/crate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crate.d.ts","sourceRoot":"","sources":["../../src/model/crate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,qBAAa,KAAK;IAChB,OAAO,CAAC,SAAS,CAAU;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,OAAO,CAAa;gBAEhB,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,KAAK,EAAO;IAMhD,IAAI,QAAQ,IAAI,KAAK,EAAE,CAEtB;IAED,IAAI,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAEvB;IAED,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAO5B,QAAQ,IAAI,MAAM;IAQlB,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAazB,QAAQ,CAAC,QAAQ,gBAAsB,GAAG,KAAK;IAa/C,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;CAqB9B"}
+{"version":3,"file":"crate.d.ts","sourceRoot":"","sources":["../../src/model/crate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC,qBAAa,KAAK;IAChB,OAAO,CAAC,SAAS,CAAqB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,OAAO,CAAa;gBAEhB,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAMvD,IAAI,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAEjC;IAED,IAAI,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAEvB;IAED,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAO5B,QAAQ,IAAI,MAAM;IAQlB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;CAiB9B"}

package/dist/model/crate.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Crate = void 0;
 const util_1 = require("../util");
 class Crate {
-    constructor(name, children = []) {
-        this._children = [...children];
+    constructor(name, children) {
+        this._children = children ?? new Map();
         this.name = (0, util_1.sanitizeFilename)(name);
         this._tracks = new Set();
     }
@@ -26,48 +26,18 @@ class Crate {
     [Symbol.for("nodejs.util.inspect.custom")]() {
         return this.toString();
     }
-    plus(other) {
-        if (this.name !== other.name) {
-            throw new Error("Cannot merge crates with different names");
-        }
-        const childrenCopy = [...this._children, ...other._children].map((c) => c.deepCopy());
-        const merged = new Crate(this.name, childrenCopy);
-        const allTracks = new Set([...this._tracks, ...other._tracks]);
-        for (const track of allTracks) {
-            merged.addTrack(track);
-        }
-        return merged;
-    }
-    deepCopy(memodict = new Map()) {
-        if (memodict.has(this)) {
-            return memodict.get(this);
-        }
-        const childrenCopy = this._children.map((c) => c.deepCopy(memodict));
-        const copy = new Crate(this.name, childrenCopy);
-        memodict.set(this, copy);
-        for (const track of this._tracks) {
-            copy.addTrack(track);
-        }
-        return copy;
-    }
     equals(other) {
         if (this.name !== other.name)
             return false;
         if (this._tracks.size !== other._tracks.size)
             return false;
-        // compare tracks by reference equality (like Python set)
-        for (const track of this._tracks) {
-            if (!other._tracks.has(track))
+        for (const [name, child] of this.children) {
+            const otherChild = other.children.get(name);
+            if (!otherChild) {
                 return false;
-        }
-        if (this._children.length || other._children.length) {
-            const sortedChildren = [...this._children].sort((a, b) => a._tracks.size - b._tracks.size);
-            const sortedOtherChildren = [...other._children].sort((a, b) => a._tracks.size - b._tracks.size);
-            if (sortedChildren.length !== sortedOtherChildren.length)
+            }
+            if (!child.equals(otherChild)) {
                 return false;
-            for (let i = 0; i < sortedChildren.length; i++) {
-                if (!sortedChildren[i].equals(sortedOtherChildren[i]))
-                    return false;
             }
         }
         return true;

package/dist/model/track.d.ts

@@ -1,5 +1,6 @@
 import { HotCue } from './hotCue';
 import { Tempo } from './tempo';
+import { TrackMeta } from './trackMeta';
 export declare class Track {
     path: string;
     trackId: string;
@@ -11,6 +12,7 @@ export declare class Track {
     beatgrid: Tempo[];
     hotCues: HotCue[];
     cueLoops: HotCue[];
+    trackMeta: TrackMeta | null;
     constructor(trackPath: string, params?: {
         trackId?: string;
         averageBpm?: number;
@@ -21,9 +23,11 @@ export declare class Track {
         beatgrid?: Tempo[];
         hotCues?: HotCue[];
         cueLoops?: HotCue[];
+        trackMeta?: TrackMeta;
     });
     static fromPath(trackPath: string, userRoot?: string): Track;
     addBeatgridMarker(tempo: Tempo): void;
     addHotCue(hotCue: HotCue): void;
+    addTrackMeta(trackMeta: TrackMeta): void;
 }
 //# sourceMappingURL=track.d.ts.map

package/dist/model/track.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../../src/model/track.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,qBAAa,KAAK;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;gBAGjB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KAChB;IAeR,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK;IAK5D,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAehC"}
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../../src/model/track.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,qBAAa,KAAK;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;gBAG1B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,CAAC,EAAE,SAAS,CAAC;KAClB;IAgBR,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK;IAQ5D,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAgB/B,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;CAGzC"}

package/dist/model/track.js

@@ -48,9 +48,12 @@ class Track {
         this.beatgrid = params.beatgrid ?? [];
         this.hotCues = params.hotCues ?? [];
         this.cueLoops = params.cueLoops ?? [];
+        this.trackMeta = params.trackMeta ?? null;
     }
     static fromPath(trackPath, userRoot) {
-        const resolved = userRoot ? path.resolve(userRoot, trackPath) : path.resolve(trackPath);
+        const resolved = userRoot != null
+            ? path.resolve(userRoot, trackPath)
+            : path.resolve(trackPath);
         return new Track(resolved);
     }
     addBeatgridMarker(tempo) {
@@ -71,5 +74,8 @@ class Track {
             this.hotCues.splice(atIndex, 0, hotCue);
         }
     }
+    addTrackMeta(trackMeta) {
+        this.trackMeta = trackMeta;
+    }
 }
 exports.Track = Track;

package/dist/model/trackMeta.d.ts

@@ -0,0 +1,7 @@
+export interface TrackMeta {
+    title?: string;
+    artist?: string;
+    album?: string;
+    fileExtension?: string;
+}
+//# sourceMappingURL=trackMeta.d.ts.map

package/dist/model/trackMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackMeta.d.ts","sourceRoot":"","sources":["../../src/model/trackMeta.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB"}

package/dist/model/trackMeta.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/util.d.ts

@@ -1,6 +1,6 @@
 import { Buffer } from 'buffer';
 export declare function splitString(input: Buffer, after?: number, delimiter?: Buffer): Buffer;
-export declare function seratoDecode(s: Buffer): string;
+export declare function seratoDecode(buffer: Buffer): string;
 export declare function concatBytes(arrays: Uint8Array[]): Uint8Array;
 export declare function latin1Encode(str: string): Uint8Array;
 export declare function intToBytes(value: number, length: number): Uint8Array;

package/dist/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,EAAE,SAAS,GAAE,MAA0B,GAAG,MAAM,CAY5G;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CA2B9C;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAS5D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAOpE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAWlD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,qBAAa,mBAAoB,SAAQ,KAAK;CAAG"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,EAAE,SAAS,GAAE,MAA0B,GAAG,MAAM,CAY5G;AAGD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAenD;AAGD,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAS5D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAOpE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAWlD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,qBAAa,mBAAoB,SAAQ,KAAK;CAAG"}

package/dist/util.js

@@ -24,35 +24,17 @@ function splitString(input, after = 72, delimiter = buffer_1.Buffer.from('\n'))
         return acc;
     }, []));
 }
-function seratoDecode(s) {
-    // Decodes Serato 4-byte blocks into UTF-16-encoded string
-    const out = [];
-    for (let i = 0; i < s.length; i += 4) {
-        const block = s.slice(i, i + 4);
-        if (block.length < 4)
-            break;
-        const w = block.readUInt8(0);
-        const x = block.readUInt8(1);
-        const y = block.readUInt8(2);
-        const z = block.readUInt8(3);
-        const c = (z & 0x7F) | ((y & 0x01) << 7);
-        const b = ((y & 0x7F) >> 1) | ((x & 0x03) << 6);
-        const a = ((x & 0x7F) >> 2) | ((w & 0x07) << 5);
-        out.push(a, b, c);
+function seratoDecode(buffer) {
+    let result = "";
+    for (let i = 0; i + 1 < buffer.length; i += 2) {
+        // Take 2 bytes
+        const chunk = buffer.slice(i, i + 2);
+        // Reverse bytes (Python: chunk[::-1])
+        const reversed = buffer_1.Buffer.from([chunk[1], chunk[0]]);
+        // Decode as UTF-16LE (Node uses LE explicitly)
+        result += reversed.toString("utf16le");
     }
-    // Interpret as UTF-16-BE pairs
-    // Convert bytes to string by grouping into 2-byte code units
-    const bytes = buffer_1.Buffer.from(out);
-    let str = '';
-    for (let i = 0; i < bytes.length; i += 2) {
-        const hi = bytes[i];
-        const lo = (i + 1) < bytes.length ? bytes[i + 1] : 0;
-        const code = (hi << 8) | lo;
-        if (code === 0)
-            break;
-        str += String.fromCharCode(code);
-    }
-    return str;
+    return result;
 }
 function concatBytes(arrays) {
     const totalLength = arrays.reduce((sum, a) => sum + a.length, 0);

package/eslint.config.js

@@ -0,0 +1,50 @@
+// eslint.config.js
+const tsParser = require("@typescript-eslint/parser");
+const tsPlugin = require("@typescript-eslint/eslint-plugin");
+
+module.exports = [
+  {
+    ignores: [
+      "node_modules/**",
+      "dist/**",
+      "build/**",
+      "*.log",
+      "*.tmp",
+      "*.tsbuildinfo",
+      ".vscode/**",
+      ".idea/**",
+       "eslint.config.js"
+    ]
+  },
+  {
+    files: ["**/*.ts"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: "latest",
+        sourceType: "module",
+        project: "./tsconfig.json",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tsPlugin
+    },
+    rules: {
+      "@typescript-eslint/no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
+      "@typescript-eslint/no-floating-promises": "error",
+      "@typescript-eslint/explicit-function-return-type": "warn",
+      "@typescript-eslint/strict-boolean-expressions": "warn"
+    }
+  },
+  {
+    files: ["**/*.js"],
+    languageOptions: {
+      ecmaVersion: "latest",
+      sourceType: "module"
+    },
+    rules: {
+      "no-unused-vars": "warn",
+      "no-undef": "error"
+    }
+  }
+];

package/package.json

@@ -1,24 +1,28 @@
 {
   "name": "tserato",
-  "version": "0.1.0",
+  "version": "0.1.11",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "commonjs",
   "scripts": {
-    "build": "tsc"
+    "build": "tsc",
+    "lint": "eslint . --ext .ts"
   },
   "repository": {
     "type": "git",
     "url": "https://github.com/laker-93/tserato.git"
   },
   "devDependencies": {
+    "@eslint/eslintrc": "^3.3.3",
     "@types/node": "^24.5.1",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "eslint": "^9.39.2",
     "typescript": "^5.3.3",
     "vitest": "^0.34.6"
   },
   "dependencies": {
     "base-64": "^1.0.0",
-    "mp3tag.js": "^3.14.1",
-    "node-id3": "^0.2.6"
+    "mp3tag.js": "^3.14.1"
   }
 }