gerdur 2.11.2 → 2.12.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 2.12.0 - 2026-08-31
+
+### Changed
+
+- **Downloads no longer hold the track in memory.** The final stage was
+  temp file -> `readFileSync` -> `addTrackTags` (which allocates the file again,
+  plus another copy to strip Deezer's existing tag) -> `writeFileSync`. It is now
+  a single streamed pass — **temp file -> decrypt -> tag -> destination** — using
+  `gerdur-core@2.15.0`'s `resolveTagModel` + `createTagStream`. Peak memory per
+  concurrent download drops from ~2-3x the track size to roughly a couple of
+  2048-byte stripes plus the cover art, which matters most with `-c 8` on FLAC.
+  Output is byte-identical.
+- The intermediate `.dec` temp file is gone — decryption is now a stage in that
+  same pipeline rather than a separate pass over the whole file.
+- Tracks are written to `<name>.part` and renamed on success, so an interrupted
+  or failed run can no longer leave a half-written file where a real track
+  should be.
+
+Verified end to end against live downloads: MP3 (ID3v2.3, all frames, 324 kbps)
+and FLAC (STREAMINFO / SEEKTABLE / VORBIS_COMMENT / 2x PICTURE / PADDING, 16-bit
+44.1 kHz) both decode with zero errors under ffmpeg.
+
 ## 2.11.2 - 2026-08-31
 
 ### Changed

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "gerdur",
-    "version": "2.11.2",
+    "version": "2.12.0",
     "description": "Command-line music downloader for Deezer (Spotify/Tidal links resolved via ISRC matching) with automatic MP3/FLAC tagging, synced lyrics and a side-effect-free programmatic API.",
     "keywords": [
         "deezer",
@@ -63,7 +63,7 @@
         "adm-zip": "^0.5.16",
         "chalk": "^4.1.2",
         "commander": "^9.5.0",
-        "gerdur-core": "^2.13.0",
+        "gerdur-core": "^2.15.0",
         "dot-prop": "^6.0.1",
         "got": "^11.8.6",
         "gradient-string": "^2.0.2",

package/dist/src/lib/download-track.js

@@ -13,7 +13,6 @@ const log_update_1 = __importDefault(require("log-update"));
 const chalk_1 = __importDefault(require("chalk"));
 const signale_1 = __importDefault(require("../lib/signale"));
 const util_2 = require("./util");
-const decrypt_1 = require("./decrypt");
 const pipeline = (0, util_1.promisify)(stream_1.default.pipeline);
 const simulate = process.env.SIMULATE;
 /** media-API format string -> gerdur's numeric quality */
@@ -142,17 +141,6 @@ const downloadTrack = async ({ track, quality, info, coverSizes, path, totalTrac
                 (0, log_update_1.default)(signale_1.default.info(`Downloading ${track.SNG_TITLE} ${message}\n  ${bar(transferred)} | ${humanSizeTotal}MiB`));
             }
         }), (0, fs_1.createWriteStream)(tmpfile, { flags: 'a', autoClose: true }));
-        let outFile;
-        if (trackData.isEncrypted) {
-            (0, log_update_1.default)(signale_1.default.pending('Decrypting ' + track.SNG_TITLE + ' by ' + track.ART_NAME));
-            const decfile = tmpfile + '.dec';
-            await (0, decrypt_1.decryptFileToFile)(tmpfile, decfile, track.SNG_ID); // streamed — ~one stripe in memory
-            outFile = (0, fs_1.readFileSync)(decfile);
-            (0, fs_1.unlinkSync)(decfile);
-        }
-        else {
-            outFile = (0, fs_1.readFileSync)(tmpfile);
-        }
         let enrichedCover;
         if (enrich && track.ISRC && !simulate) {
             try {
@@ -167,12 +155,12 @@ const downloadTrack = async ({ track, quality, info, coverSizes, path, totalTrac
             }
         }
         (0, log_update_1.default)(signale_1.default.pending('Tagging ' + track.SNG_TITLE + ' by ' + track.ART_NAME));
-        const { buffer: trackWithMetadata, model } = await (0, gerdur_core_1.addTrackTags)(outFile, track, {
+        // Resolve the metadata first, without touching the audio — the tags are then
+        // written by a stream, so the track is never held in memory.
+        const model = await (0, gerdur_core_1.resolveTagModel)(track, {
             coverSize,
             ...(enrichedCover ? { cover: enrichedCover } : {}),
         });
-        // Delete temporary file now
-        (0, fs_1.unlinkSync)(tmpfile);
         (0, log_update_1.default)(signale_1.default.pending('Saving ' + track.SNG_TITLE + ' by ' + track.ART_NAME));
         if (!simulate) {
             // Create directory if not exists
@@ -180,12 +168,32 @@ const downloadTrack = async ({ track, quality, info, coverSizes, path, totalTrac
             if (!(0, fs_1.existsSync)(dir)) {
                 (0, fs_1.mkdirSync)(dir, { recursive: true });
             }
-            // Save file to disk
-            (0, fs_1.writeFileSync)(savePath, trackWithMetadata);
+            // One pass: temp file -> decrypt -> tag -> destination. Peak memory is a
+            // couple of stripes plus the cover, instead of the whole track two or
+            // three times over. `.part` then rename so an interrupted run never
+            // leaves a half-written track behind.
+            const partPath = savePath + '.part';
+            const stages = [(0, fs_1.createReadStream)(tmpfile)];
+            if (trackData.isEncrypted) {
+                stages.push((0, gerdur_core_1.createDecryptStream)(track.SNG_ID));
+            }
+            stages.push((0, gerdur_core_1.createTagStream)(model), (0, fs_1.createWriteStream)(partPath));
+            try {
+                await pipeline(...stages);
+            }
+            catch (err) {
+                if ((0, fs_1.existsSync)(partPath)) {
+                    (0, fs_1.unlinkSync)(partPath);
+                }
+                throw err;
+            }
+            (0, fs_1.renameSync)(partPath, savePath);
             if (lrc !== false && model.lyricsSynced) {
                 (0, fs_1.writeFileSync)(savePath.replace(/\.(mp3|flac)$/i, '.lrc'), model.lyricsSynced);
             }
         }
+        // Delete temporary file now
+        (0, fs_1.unlinkSync)(tmpfile);
         // Print sucess info
         (0, log_update_1.default)(signale_1.default.success(`${isFallback ? chalk_1.default.yellow('[Fallback] ') : ''}${track.SNG_TITLE} by ${track.ART_NAME}`));
         log_update_1.default.done();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gerdur",
-  "version": "2.11.2",
+  "version": "2.12.0",
   "description": "Command-line music downloader for Deezer (Spotify/Tidal links resolved via ISRC matching) with automatic MP3/FLAC tagging, synced lyrics and a side-effect-free programmatic API.",
   "keywords": [
     "deezer",
@@ -63,7 +63,7 @@
     "adm-zip": "^0.5.16",
     "chalk": "^4.1.2",
     "commander": "^9.5.0",
-    "gerdur-core": "^2.13.0",
+    "gerdur-core": "^2.15.0",
     "dot-prop": "^6.0.1",
     "got": "^11.8.6",
     "gradient-string": "^2.0.2",