gerdur 2.15.0 → 2.16.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 2.16.0 - 2026-08-31
+
+### Changed
+
+- **The CLI starts about twice as fast: ~249 ms → 120 ms** (min of 10 runs;
+  mean 137 ms). Two things were being loaded before they could possibly be
+  needed:
+  - `gerdur-core@^2.20.0` now defers the Spotify SDK and the HTML parser, so
+    `require('gerdur-core')` costs 43 ms instead of 160 ms.
+  - `got` (~53 ms to require) is now loaded on first use rather than at import.
+    Every call site was already inside a function, so this is a pure deferral —
+    but it means `--help`, `gerdur setup`, `--set-arl` and the interactive prompt
+    no longer pay for an HTTP client before you have typed anything.
+
+  Verified against live downloads: a full 320 kbps track (9.19 MB, 226 s,
+  decodes clean under ffmpeg) and a `--preview` clip (480 KB, 30 s).
+
 ## 2.15.0 - 2026-08-31
 
 ### Changed

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "gerdur",
-    "version": "2.15.0",
+    "version": "2.16.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.19.0",
+        "gerdur-core": "^2.20.0",
         "dot-prop": "^6.0.1",
         "got": "^11.8.6",
         "gradient-string": "^2.0.2",

package/dist/src/gerdur.js

@@ -9,7 +9,10 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const commander_1 = require("commander");
 const gradient_string_1 = __importDefault(require("gradient-string"));
-const got_1 = __importDefault(require("got"));
+/* eslint-disable @typescript-eslint/no-var-requires */
+// `got` costs ~53 ms to require and is only needed once a transfer actually
+// starts — deferring it keeps `--help`, setup and the interactive prompt snappy.
+const got = () => require('got');
 const gerdur_core_1 = require("gerdur-core");
 const prompts_1 = __importDefault(require("prompts"));
 const log_update_1 = __importDefault(require("log-update"));
@@ -369,7 +372,7 @@ const startDownload = async (saveLayout, url, skipPrompt) => {
             console.log(signale_1.default.info(`Downloading episode: ${episode.EPISODE_TITLE}`));
             if (options.overwrite || !(0, fs_1.existsSync)(dest)) {
                 (0, fs_1.mkdirSync)(dir, { recursive: true });
-                const { body } = await (0, got_1.default)(episode.EPISODE_DIRECT_STREAM_URL, { responseType: 'buffer' });
+                const { body } = await got()(episode.EPISODE_DIRECT_STREAM_URL, { responseType: 'buffer' });
                 (0, fs_1.writeFileSync)(dest, body);
             }
             console.log(signale_1.default.success(`Saved ${dest}`));

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

@@ -1,12 +1,12 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.downloadTrackToFile = exports.getTaggedTrack = exports.getTrackBuffer = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
-const got_1 = __importDefault(require("got"));
+/* eslint-disable @typescript-eslint/no-var-requires */
+// `got` costs ~53 ms to require and is only needed once a transfer actually
+// starts — deferring it keeps `--help`, setup and the interactive prompt snappy.
+const got = () => require('got');
 const gerdur_core_1 = require("gerdur-core");
 const decrypt_1 = require("./decrypt");
 const util_1 = require("./util");
@@ -48,7 +48,10 @@ const fetchDecryptTag = async (track, quality, options) => {
         if (!trackData) {
             continue;
         }
-        const { body } = await (0, got_1.default)(trackData.trackUrl, { responseType: 'buffer', agent: { http: gerdur_core_1.httpAgent, https: gerdur_core_1.httpsAgent } });
+        const { body } = await got()(trackData.trackUrl, {
+            responseType: 'buffer',
+            agent: { http: gerdur_core_1.httpAgent, https: gerdur_core_1.httpsAgent },
+        });
         const decrypted = trackData.isEncrypted ? (0, decrypt_1.decryptDownload)(body, track.SNG_ID) : body;
         return (0, gerdur_core_1.addTrackTags)(decrypted, track, tagOptions(options));
     }

package/dist/src/lib/auto-updater.js

@@ -4,7 +4,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs_1 = require("fs");
-const got_1 = __importDefault(require("got"));
+/* eslint-disable @typescript-eslint/no-var-requires */
+// `got` costs ~53 ms to require and is only needed once a transfer actually
+// starts — deferring it keeps `--help`, setup and the interactive prompt snappy.
+const got = () => require('got');
 const adm_zip_1 = __importDefault(require("adm-zip"));
 const chalk_1 = __importDefault(require("chalk"));
 const log_update_1 = __importDefault(require("log-update"));
@@ -12,7 +15,7 @@ const signale_1 = __importDefault(require("./signale"));
 const util_1 = require("./util");
 const updateCheck = async (pkg) => {
     const beta = pkg.version.includes('beta');
-    const releases = await (0, got_1.default)('https://api.github.com/repos/soulwax/gerdur/releases').json();
+    const releases = await got()('https://api.github.com/repos/soulwax/gerdur/releases').json();
     const data = releases.filter((r) => r.prerelease === beta)[0];
     if (data.tag_name > pkg.version) {
         return data;
@@ -51,7 +54,7 @@ const updateBinary = async (pkg) => {
             console.log(`  Downloading ${asset.browser_download_url}`);
             const bar = (0, util_1.progressBar)(asset.size, 40);
             const humanSizeTotal = (asset.size / 1024 / 1024).toFixed(2);
-            const { body } = await (0, got_1.default)(asset.browser_download_url, { responseType: 'buffer' }).on('downloadProgress', ({ transferred }) => {
+            const { body } = await got()(asset.browser_download_url, { responseType: 'buffer' }).on('downloadProgress', ({ transferred }) => {
                 (0, log_update_1.default)(`  ${bar(transferred)} | ${humanSizeTotal}MiB`);
             });
             log_update_1.default.done();

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

@@ -3,7 +3,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const got_1 = __importDefault(require("got"));
+/* eslint-disable @typescript-eslint/no-var-requires */
+// `got` costs ~53 ms to require and is only needed once a transfer actually
+// starts — deferring it keeps `--help`, setup and the interactive prompt snappy.
+const got = () => require('got');
 const stream_1 = __importDefault(require("stream"));
 const fs_1 = require("fs");
 const util_1 = require("util");
@@ -127,7 +130,7 @@ const downloadTrack = async ({ track, quality, info, coverSizes, path, totalTrac
         const bar = (0, util_2.progressBar)(fileSize, 40);
         const humanSizeTotal = (fileSize / 1024 / 1024).toFixed(2);
         let transferredLast = downloaded;
-        await pipeline(got_1.default
+        await pipeline(got()
             .stream(trackData.trackUrl, {
             responseType: 'buffer',
             headers,

package/dist/src/lib/email-login.js

@@ -1,11 +1,11 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loginWithEmail = void 0;
 const crypto_1 = require("crypto");
-const got_1 = __importDefault(require("got"));
+/* eslint-disable @typescript-eslint/no-var-requires */
+// `got` costs ~53 ms to require and is only needed once a transfer actually
+// starts — deferring it keeps `--help`, setup and the interactive prompt snappy.
+const got = () => require('got');
 /**
  * Email/password -> arl login for Deezer.
  *
@@ -55,7 +55,7 @@ const loginWithEmail = async (email, password) => {
     const jar = new Map();
     try {
         // 1. Bootstrap a session so Deezer sets an initial sid cookie.
-        const boot = await (0, got_1.default)('https://www.deezer.com', {
+        const boot = await got()('https://www.deezer.com', {
             method: 'POST',
             headers: { 'User-Agent': UA },
             timeout: { request: 15000 },
@@ -67,7 +67,7 @@ const loginWithEmail = async (email, password) => {
         const passwordHash = md5(password);
         const hash = md5([CLIENT_ID, email, passwordHash, CLIENT_SECRET].join(''));
         let accessToken = null;
-        const auth = await (0, got_1.default)('https://connect.deezer.com/oauth/user_auth.php', {
+        const auth = await got()('https://connect.deezer.com/oauth/user_auth.php', {
             searchParams: { app_id: CLIENT_ID, login: email, password: passwordHash, hash },
             headers: { 'User-Agent': UA, cookie: cookieHeader(jar) },
             responseType: 'json',
@@ -83,7 +83,7 @@ const loginWithEmail = async (email, password) => {
             return { ok: false, reason: 'wrong-credentials', message: 'Login failed — check your email and password.' };
         }
         // 3. Read the arl for the now-authenticated session.
-        const arlResp = await (0, got_1.default)('https://www.deezer.com/ajax/gw-light.php', {
+        const arlResp = await got()('https://www.deezer.com/ajax/gw-light.php', {
             searchParams: { method: 'user.getArl', input: 3, api_version: '1.0', api_token: 'null' },
             headers: { 'User-Agent': UA, cookie: cookieHeader(jar) },
             responseType: 'json',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gerdur",
-  "version": "2.15.0",
+  "version": "2.16.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.19.0",
+    "gerdur-core": "^2.20.0",
     "dot-prop": "^6.0.1",
     "got": "^11.8.6",
     "gradient-string": "^2.0.2",