gerdur-core 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.0.3 - 2026-08-30
+
+### Changed
+
+- `getTrackDownloadUrl`: when `media.deezer.com/v1/get_url` returns 403/429/5xx (throttling or a stale license token), re-authenticate and retry with exponential backoff (up to 3×); if it still fails, fall through to the token-free legacy CDN instead of throwing.
+
 ## 1.0.2 - 2026-08-30
 
 ### Fixed

package/dist/lib/get-url.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTrackDownloadUrl = exports.ExpiredTrackToken = exports.GeoBlocked = exports.WrongLicense = void 0;
+const delay_1 = __importDefault(require("delay"));
 const decrypt_1 = require("../lib/decrypt");
 const http_1 = require("../lib/http");
 const request_1 = __importDefault(require("../lib/request"));
@@ -64,21 +65,35 @@ const dzAuthenticate = async () => {
     };
     return user_data;
 };
-const getTrackUrlFromServer = async (track_token, format) => {
+const MEDIA_MAX_RETRIES = 3;
+const getTrackUrlFromServer = async (track_token, format, attempt = 0) => {
     const user = user_data ? user_data : await dzAuthenticate();
     if ((format === 'FLAC' && !user.can_stream_lossless) || (format === 'MP3_320' && !user.can_stream_hq)) {
         throw new WrongLicense(format);
     }
-    const { data } = await request_1.default.post('https://media.deezer.com/v1/get_url', {
-        license_token: user.license_token,
-        media: [
-            {
-                type: 'FULL',
-                formats: [{ format, cipher: 'BF_CBC_STRIPE' }],
-            },
-        ],
-        track_tokens: [track_token],
-    });
+    let data;
+    try {
+        ({ data } = await request_1.default.post('https://media.deezer.com/v1/get_url', {
+            license_token: user.license_token,
+            media: [
+                {
+                    type: 'FULL',
+                    formats: [{ format, cipher: 'BF_CBC_STRIPE' }],
+                },
+            ],
+            track_tokens: [track_token],
+        }));
+    }
+    catch (err) {
+        // media.deezer.com throttles / 5xx / stale license_token — re-auth and back off
+        const status = err instanceof http_1.HttpStatusError ? err.statusCode : 0;
+        if ((status === 403 || status === 429 || status >= 500) && attempt < MEDIA_MAX_RETRIES) {
+            user_data = null;
+            await (0, delay_1.default)(500 * 2 ** attempt + Math.floor(Math.random() * 250));
+            return getTrackUrlFromServer(track_token, format, attempt + 1);
+        }
+        throw err;
+    }
     if (data.data.length > 0) {
         if (data.data[0].errors) {
             const { code } = data.data[0].errors[0];
@@ -103,6 +118,7 @@ const getTrackDownloadUrl = async (track, quality) => {
     let wrongLicense = null;
     let geoBlocked = null;
     let expiredToken = null;
+    let mediaBlocked = null;
     let formatName;
     switch (quality) {
         case 9:
@@ -145,6 +161,10 @@ const getTrackDownloadUrl = async (track, quality) => {
             else if (err instanceof ExpiredTrackToken) {
                 expiredToken = err;
             }
+            else if (err instanceof http_1.HttpStatusError && (err.statusCode === 403 || err.statusCode === 429)) {
+                // media API is throttling this account — try the token-free legacy CDN below
+                mediaBlocked = err;
+            }
             else {
                 throw err;
             }
@@ -172,6 +192,9 @@ const getTrackDownloadUrl = async (track, quality) => {
     if (expiredToken) {
         throw expiredToken;
     }
+    if (mediaBlocked) {
+        throw mediaBlocked;
+    }
     return null;
 };
 exports.getTrackDownloadUrl = getTrackDownloadUrl;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gerdur-core",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Core module for gerdur.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",