@ansango/lastfm-api 3.1.3 → 3.2.0

package/dist/utils.js

@@ -33,8 +33,8 @@ export async function parseLastFmResponse(response) {
     if (!response.ok) {
         throw new LastFmApiError(`HTTP Error: ${httpStatus} ${response.statusText}`, httpStatus, typeof body?.error === 'number' ? body.error : undefined);
     }
-    if (body && body.error) {
-        const code = typeof body.error === 'number' ? body.error : undefined;
+    if (body?.error) {
+        const code = typeof body?.error === 'number' ? body.error : undefined;
         throw new LastFmApiError(`Last.fm API Error ${body.error}: ${body.message ?? ''}`.trim(), httpStatus, code);
     }
     return body;
@@ -55,7 +55,7 @@ export function buildUrl(config, method, params = {}) {
         method,
         api_key: config.apiKey,
         format: 'json',
-        ...cleanParams(params)
+        ...cleanParams(params),
     });
     return `${baseUrl}?${urlParams.toString()}`;
 }
@@ -91,35 +91,120 @@ export function buildAuthUrl(config, method, params = {}) {
     const authParams = {
         method,
         api_key: config.apiKey,
-        ...cleanParams(params)
+        ...cleanParams(params),
     };
     const signature = generateSignature(config, authParams);
     const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
     const urlParams = new URLSearchParams({
         ...authParams,
         api_sig: signature,
-        format: 'json'
+        format: 'json',
     });
     return `${baseUrl}?${urlParams.toString()}`;
 }
+// ─────────────────────────────────────────────────────────────────────────────
+// Signed POST transport (issue #68)
+//
+// One reusable signed POST path used by every authenticated write. Services are
+// responsible only for the domain-specific param shape (e.g. indexed keys for
+// batch scrobble). Everything else — session resolution, signature, body
+// encoding, error routing — lives here.
+//
+// Internal on purpose. Do not re-export through the public `exports` map of
+// `package.json`. The issue explicitly requires that this helper is not
+// promoted to a public API of the package.
+// ─────────────────────────────────────────────────────────────────────────────
+/** Last.fm wire fields that the transport always owns. */
+const RESERVED_FIELDS = ['method', 'api_key', 'api_sig', 'format'];
 /**
- * Realiza una petición POST con body URL-encoded
+ * Send a signed POST to the Last.fm API and return the parsed JSON body.
+ *
+ * Behaviour:
+ *
+ * - Reserved fields (`method`, `api_key`, `api_sig`, `format`) are always
+ *   generated internally; any caller-supplied values are silently ignored.
+ * - Signature input is the sorted concatenation of `method`, `api_key`,
+ *   functional params, and `sk` (when required). `format` and `api_sig`
+ *   are never part of the signature input.
+ * - The body is `application/x-www-form-urlencoded` and contains `method`,
+ *   `api_key`, every functional param, optional `sk`, `api_sig`, and
+ *   `format=json`. Nothing goes in the URL.
+ * - Missing `sharedSecret` or required `sk` fail with a sanitized
+ *   `LastFmApiError` (no request values in the message) before any
+ *   `fetch` is issued.
+ * - The response is routed through `parseLastFmResponse`, so HTTP
+ *   failures and Last.fm error envelopes both surface as `LastFmApiError`.
+ *   An empty or non-JSON success body is returned as-is, not as an error.
  */
-export async function postFetcher(url, body) {
-    const response = await fetch(url, {
-        method: 'POST',
-        headers: {
-            'Content-Type': 'application/x-www-form-urlencoded'
-        },
-        body
-    });
-    if (!response.ok) {
-        throw new Error(`HTTP Error: ${response.status} ${response.statusText}`);
+export async function signedPost(config, method, options) {
+    const requiresSession = options.requiresSession ?? true;
+    // 1. Shared secret must exist before we touch anything.
+    if (!config.sharedSecret) {
+        throw new LastFmApiError('A `sharedSecret` is required for signed methods. Pass `sharedSecret` in the LastFmConfig.', 0);
     }
-    const data = await response.json();
-    if (data.error) {
-        throw new Error(`Last.fm API Error ${data.error}: ${data.message}`);
+    // 2. Coerce params to string and drop undefined/null.
+    const cleanParams = {};
+    for (const [k, v] of Object.entries(options.params)) {
+        if (v !== undefined && v !== null) {
+            cleanParams[k] = String(v);
+        }
     }
-    return data;
+    // 3. Resolve `sk` for session-required methods.
+    if (requiresSession) {
+        const requestSk = cleanParams.sk;
+        const resolvedSk = requestSk ?? config.sessionKey;
+        if (!resolvedSk) {
+            throw new LastFmApiError('A session key (`sk`) is required for this method. Pass `sk` in the request or set `sessionKey` on the LastFmConfig.', 0);
+        }
+        cleanParams.sk = resolvedSk;
+    }
+    // 4. Drop any reserved field the caller tried to inject. The transport
+    //    owns these — they will be set to canonical values below.
+    for (const reserved of RESERVED_FIELDS) {
+        delete cleanParams[reserved];
+    }
+    // 5. Build signature input. Note: `format` and `api_sig` are never part
+    //    of the signature input per the Last.fm contract.
+    const sigInput = {
+        method,
+        api_key: config.apiKey,
+        ...cleanParams,
+    };
+    const sigString = Object.keys(sigInput)
+        .sort()
+        .map((k) => `${k}${sigInput[k]}`)
+        .join('');
+    const api_sig = md5(sigString + config.sharedSecret);
+    // 6. Build body. Order: method, api_key, functional params (incl. sk if
+    //    present), api_sig, format=json. URLSearchParams handles encoding.
+    const body = new URLSearchParams();
+    body.set('method', method);
+    body.set('api_key', config.apiKey);
+    for (const [k, v] of Object.entries(cleanParams)) {
+        body.set(k, v);
+    }
+    body.set('api_sig', api_sig);
+    body.set('format', 'json');
+    // 7. Merge caller `init` safely. The transport owns method, body, and
+    //    Content-Type; signal and other safe headers pass through. Caller
+    //    headers go first so the canonical Content-Type always wins.
+    const callerHeaders = (options.init?.headers ?? {});
+    const finalHeaders = {
+        ...callerHeaders,
+        'Content-Type': 'application/x-www-form-urlencoded',
+    };
+    const finalInit = {
+        ...options.init,
+        method: 'POST',
+        headers: finalHeaders,
+        body: body.toString(),
+    };
+    if (options.init?.signal) {
+        finalInit.signal = options.init.signal;
+    }
+    // 8. Send.
+    const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+    const response = await fetch(baseUrl, finalInit);
+    return (await parseLastFmResponse(response));
 }
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -1,156 +1,169 @@
 {
-  "name": "@ansango/lastfm-api",
-  "version": "3.1.3",
-  "description": "A universal Last.fm API client for Node.js and Browser",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./user": {
-      "import": "./dist/entrypoints/user.js",
-      "types": "./dist/entrypoints/user.d.ts"
-    },
-    "./user/schemas": {
-      "import": "./dist/entrypoints/user.schemas.js",
-      "types": "./dist/entrypoints/user.schemas.d.ts"
-    },
-    "./album": {
-      "import": "./dist/entrypoints/album.js",
-      "types": "./dist/entrypoints/album.d.ts"
-    },
-    "./album/schemas": {
-      "import": "./dist/entrypoints/album.schemas.js",
-      "types": "./dist/entrypoints/album.schemas.d.ts"
-    },
-    "./artist": {
-      "import": "./dist/entrypoints/artist.js",
-      "types": "./dist/entrypoints/artist.d.ts"
-    },
-    "./artist/schemas": {
-      "import": "./dist/entrypoints/artist.schemas.js",
-      "types": "./dist/entrypoints/artist.schemas.d.ts"
-    },
-    "./track": {
-      "import": "./dist/entrypoints/track.js",
-      "types": "./dist/entrypoints/track.d.ts"
-    },
-    "./track/schemas": {
-      "import": "./dist/entrypoints/track.schemas.js",
-      "types": "./dist/entrypoints/track.schemas.d.ts"
-    },
-    "./tag": {
-      "import": "./dist/entrypoints/tag.js",
-      "types": "./dist/entrypoints/tag.d.ts"
-    },
-    "./tag/schemas": {
-      "import": "./dist/entrypoints/tag.schemas.js",
-      "types": "./dist/entrypoints/tag.schemas.d.ts"
-    },
-    "./chart": {
-      "import": "./dist/entrypoints/chart.js",
-      "types": "./dist/entrypoints/chart.d.ts"
-    },
-    "./chart/schemas": {
-      "import": "./dist/entrypoints/chart.schemas.js",
-      "types": "./dist/entrypoints/chart.schemas.d.ts"
-    },
-    "./geo": {
-      "import": "./dist/entrypoints/geo.js",
-      "types": "./dist/entrypoints/geo.d.ts"
-    },
-    "./geo/schemas": {
-      "import": "./dist/entrypoints/geo.schemas.js",
-      "types": "./dist/entrypoints/geo.schemas.d.ts"
-    },
-    "./library": {
-      "import": "./dist/entrypoints/library.js",
-      "types": "./dist/entrypoints/library.d.ts"
-    },
-    "./library/schemas": {
-      "import": "./dist/entrypoints/library.schemas.js",
-      "types": "./dist/entrypoints/library.schemas.d.ts"
-    },
-    "./auth": {
-      "import": "./dist/entrypoints/auth.js",
-      "types": "./dist/entrypoints/auth.d.ts"
-    },
-    "./auth/schemas": {
-      "import": "./dist/entrypoints/auth.schemas.js",
-      "types": "./dist/entrypoints/auth.schemas.d.ts"
-    },
-    "./schemas": {
-      "import": "./dist/entrypoints/base.schemas.js",
-      "types": "./dist/entrypoints/base.schemas.d.ts"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
-  ],
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "scripts": {
-    "build": "rimraf dist && tsc",
-    "clean": "rimraf dist",
-    "dev": "bun run clean && tsc --watch --project tsconfig.dev.json",
-    "test": "bun test-real.ts",
-    "prepublishOnly": "bun run build",
-    "changelog": "bun scripts/changelog.ts",
-    "release": "bun scripts/release.ts",
-    "release:patch": "bun scripts/release.ts patch",
-    "release:minor": "bun scripts/release.ts minor",
-    "release:major": "bun scripts/release.ts major",
-    "release:alpha": "bun scripts/release.ts alpha",
-    "release:beta": "bun scripts/release.ts beta",
-    "gh:release": "bun scripts/github-release.ts"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ansango/lastfm-api.git"
-  },
-  "homepage": "https://github.com/ansango/lastfm-api#readme",
-  "bugs": {
-    "url": "https://github.com/ansango/lastfm-api/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "author": "Anibal Santos",
-  "license": "MIT",
-  "keywords": [
-    "client",
-    "last-fm",
-    "lastfm",
-    "nodejs",
-    "api",
-    "node",
-    "typescript",
-    "browser",
-    "universal",
-    "esm",
-    "zod",
-    "validation"
-  ],
-  "dependencies": {
-    "js-md5": "^0.8.3",
-    "zod": "4.1.12"
-  },
-  "devDependencies": {
-    "@types/node": "^24.10.0",
-    "dotenv": "^17.2.3",
-    "rimraf": "^6.1.0",
-    "typescript": "^5.9.3"
-  },
-  "config": {
-    "commitizen": {
-      "path": "./node_modules/cz-conventional-changelog"
-    }
-  }
+	"name": "@ansango/lastfm-api",
+	"version": "3.2.0",
+	"description": "A universal Last.fm API client for Node.js and Browser",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		},
+		"./user": {
+			"import": "./dist/entrypoints/user.js",
+			"types": "./dist/entrypoints/user.d.ts"
+		},
+		"./user/schemas": {
+			"import": "./dist/entrypoints/user.schemas.js",
+			"types": "./dist/entrypoints/user.schemas.d.ts"
+		},
+		"./album": {
+			"import": "./dist/entrypoints/album.js",
+			"types": "./dist/entrypoints/album.d.ts"
+		},
+		"./album/schemas": {
+			"import": "./dist/entrypoints/album.schemas.js",
+			"types": "./dist/entrypoints/album.schemas.d.ts"
+		},
+		"./artist": {
+			"import": "./dist/entrypoints/artist.js",
+			"types": "./dist/entrypoints/artist.d.ts"
+		},
+		"./artist/schemas": {
+			"import": "./dist/entrypoints/artist.schemas.js",
+			"types": "./dist/entrypoints/artist.schemas.d.ts"
+		},
+		"./track": {
+			"import": "./dist/entrypoints/track.js",
+			"types": "./dist/entrypoints/track.d.ts"
+		},
+		"./track/schemas": {
+			"import": "./dist/entrypoints/track.schemas.js",
+			"types": "./dist/entrypoints/track.schemas.d.ts"
+		},
+		"./tag": {
+			"import": "./dist/entrypoints/tag.js",
+			"types": "./dist/entrypoints/tag.d.ts"
+		},
+		"./tag/schemas": {
+			"import": "./dist/entrypoints/tag.schemas.js",
+			"types": "./dist/entrypoints/tag.schemas.d.ts"
+		},
+		"./chart": {
+			"import": "./dist/entrypoints/chart.js",
+			"types": "./dist/entrypoints/chart.d.ts"
+		},
+		"./chart/schemas": {
+			"import": "./dist/entrypoints/chart.schemas.js",
+			"types": "./dist/entrypoints/chart.schemas.d.ts"
+		},
+		"./geo": {
+			"import": "./dist/entrypoints/geo.js",
+			"types": "./dist/entrypoints/geo.d.ts"
+		},
+		"./geo/schemas": {
+			"import": "./dist/entrypoints/geo.schemas.js",
+			"types": "./dist/entrypoints/geo.schemas.d.ts"
+		},
+		"./library": {
+			"import": "./dist/entrypoints/library.js",
+			"types": "./dist/entrypoints/library.d.ts"
+		},
+		"./library/schemas": {
+			"import": "./dist/entrypoints/library.schemas.js",
+			"types": "./dist/entrypoints/library.schemas.d.ts"
+		},
+		"./auth": {
+			"import": "./dist/entrypoints/auth.js",
+			"types": "./dist/entrypoints/auth.d.ts"
+		},
+		"./auth/schemas": {
+			"import": "./dist/entrypoints/auth.schemas.js",
+			"types": "./dist/entrypoints/auth.schemas.d.ts"
+		},
+		"./schemas": {
+			"import": "./dist/entrypoints/base.schemas.js",
+			"types": "./dist/entrypoints/base.schemas.d.ts"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE",
+		"CHANGELOG.md"
+	],
+	"engines": {
+		"node": ">=20.0.0"
+	},
+	"scripts": {
+		"build": "rimraf dist && tsc",
+		"clean": "rimraf dist",
+		"dev": "bun run clean && tsc --watch --project tsconfig.dev.json",
+		"typecheck": "tsc --noEmit -p tsconfig.test.json",
+		"test": "bun run test:unit",
+		"test:unit": "bun test src/__tests__",
+		"test:integration:live": "bun test-real.ts",
+		"lint": "biome check .",
+		"lint:fix": "biome check --write .",
+		"format": "biome format --write .",
+		"format:check": "biome format .",
+		"prepublishOnly": "bun run build",
+		"changelog": "bun scripts/changelog.ts",
+		"release": "bun scripts/release.ts",
+		"release:patch": "bun scripts/release.ts patch",
+		"release:minor": "bun scripts/release.ts minor",
+		"release:major": "bun scripts/release.ts major",
+		"release:alpha": "bun scripts/release.ts alpha",
+		"release:beta": "bun scripts/release.ts beta",
+		"gh:release": "bun scripts/github-release.ts",
+		"tool:dev": "bun install --cwd tool/api-scalar && bun run --cwd tool/api-scalar dev",
+		"tool:start": "bun install --cwd tool/api-scalar && bun run --cwd tool/api-scalar start",
+		"tool:test": "bun install --cwd tool/api-scalar && bun run --cwd tool/api-scalar test",
+		"tool:typecheck": "bun install --cwd tool/api-scalar && bun run --cwd tool/api-scalar typecheck"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/ansango/lastfm-api.git"
+	},
+	"homepage": "https://github.com/ansango/lastfm-api#readme",
+	"bugs": {
+		"url": "https://github.com/ansango/lastfm-api/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"author": "Anibal Santos",
+	"license": "MIT",
+	"keywords": [
+		"client",
+		"last-fm",
+		"lastfm",
+		"nodejs",
+		"api",
+		"node",
+		"typescript",
+		"browser",
+		"universal",
+		"esm",
+		"zod",
+		"validation"
+	],
+	"dependencies": {
+		"js-md5": "^0.8.3",
+		"zod": "4.1.12"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.5.11",
+		"@types/bun": "^1.4.0",
+		"@types/node": "^24.10.0",
+		"dotenv": "^17.2.3",
+		"rimraf": "^6.1.0",
+		"typescript": "^5.9.3"
+	},
+	"config": {
+		"commitizen": {
+			"path": "./node_modules/cz-conventional-changelog"
+		}
+	}
 }

package/dist/__tests__/utils.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=utils.test.d.ts.map

package/dist/__tests__/utils.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/utils.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/utils.test.js

@@ -1,86 +0,0 @@
-import { test, beforeEach, afterEach, describe } from 'node:test';
-import assert from 'node:assert/strict';
-import { LastFmClient } from '../client.js';
-import { buildUrl, buildAuthUrl } from '../utils.js';
-/**
- * Regression tests for issue #58:
- * `new LastFmClient({ apiKey })` must not throw "Failed to parse URL from
- * undefined" because `buildUrl` / `buildAuthUrl` default `baseUrl`.
- */
-/** Minimal fake artist payload that satisfies the Zod schema. */
-const fakeArtistPayload = {
-    artist: {
-        name: 'Radiohead',
-        mbid: 'a74b1b7f-71a5-4011-9441-d0b5e4122711',
-        url: 'https://www.last.fm/music/Radiohead',
-        image: [],
-        streamable: '0',
-        ontour: '0',
-        stats: {
-            listeners: '1',
-            playcount: '1',
-            userplaycount: '0'
-        },
-        similar: { artist: [] },
-        tags: { tag: [] },
-        bio: {
-            published: '2024-01-01',
-            summary: 'Test',
-            content: 'Test'
-        }
-    }
-};
-describe('issue #58: default baseUrl', () => {
-    const originalFetch = globalThis.fetch;
-    beforeEach(() => {
-        // Mock fetch so the test does not require a real API key.
-        globalThis.fetch = (async (input) => {
-            const url = typeof input === 'string' ? input : input.toString();
-            // Sanity: a syntactically valid URL must be passed to fetch.
-            // Before the fix this would throw "Failed to parse URL from undefined".
-            new URL(url);
-            return new Response(JSON.stringify(fakeArtistPayload), {
-                status: 200,
-                headers: { 'Content-Type': 'application/json' }
-            });
-        });
-    });
-    afterEach(() => {
-        globalThis.fetch = originalFetch;
-    });
-    test('LastFmClient constructed without baseUrl + getInfo does not throw "Failed to parse URL from undefined"', async () => {
-        const client = new LastFmClient({ apiKey: 'test' });
-        const result = await client.artist.getInfo({ artist: 'Radiohead' });
-        assert.equal(result.artist.name, 'Radiohead');
-    });
-    test('buildUrl defaults baseUrl when config.baseUrl is undefined', () => {
-        const config = { apiKey: 'test' };
-        const url = buildUrl(config, 'artist.getInfo', { artist: 'Radiohead' });
-        assert.match(url, /^https:\/\/ws\.audioscrobbler\.com\/2\.0\/\?/);
-        assert.match(url, /method=artist\.getInfo/);
-        assert.match(url, /api_key=test/);
-        // Must not produce the literal "undefined?..." string that caused the original bug.
-        assert.doesNotMatch(url, /^undefined/);
-    });
-    test('buildAuthUrl defaults baseUrl when config.baseUrl is undefined', () => {
-        const config = { apiKey: 'test', sharedSecret: 'secret' };
-        const url = buildAuthUrl(config, 'track.scrobble', {
-            artist: 'Radiohead',
-            track: 'OK Computer',
-            timestamp: 1,
-            sk: 'session'
-        });
-        assert.match(url, /^https:\/\/ws\.audioscrobbler\.com\/2\.0\/\?/);
-        assert.match(url, /api_sig=[a-f0-9]{32}/);
-        assert.doesNotMatch(url, /^undefined/);
-    });
-    test('buildUrl honours an explicit baseUrl when provided', () => {
-        const config = {
-            apiKey: 'test',
-            baseUrl: 'https://example.test/api/'
-        };
-        const url = buildUrl(config, 'artist.getInfo', { artist: 'X' });
-        assert.match(url, /^https:\/\/example\.test\/api\/\?/);
-    });
-});
-//# sourceMappingURL=utils.test.js.map

package/dist/__tests__/utils.test.js.map

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