musicbrainz-api 0.21.0 → 0.23.0

package/LICENSE.txt

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright © 2025 Borewit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -116,18 +116,34 @@ MusicBrainz API documentation: [XML Web Service/Version 2 Lookups](https://wiki.
 ### Lookup Function
 
 ```js
-const artist = await mbApi.lookup('artist', 'ab2528d9-719f-4261-8098-21849222a0f2');
+const artist = await mbApi.lookup('artist', 'ab2528d9-719f-4261-8098-21849222a0f2', ['recordings']);
 ```
 
 Arguments:
-- entity: `'area'` | `'artist'` | `'collection'` | `'instrument'` | `'label'` | `'place'` | `'release'` | `'release-group'` | `'recording'` | `'series'` | `'work'` | `'url'` | `'event'`
-- MBID [(MusicBrainz identifier)](https://wiki.musicbrainz.org/MusicBrainz_Identifier)
-- query
+- entity (`string`): `'area'` | `'artist'` | `'collection'` | `'instrument'` | `'label'` | `'place'` | `'release'` | `'release-group'` | `'recording'` | `'series'` | `'work'` | `'url'` | `'event'`
+- MBID (`string`): [(MusicBrainz identifier)](https://wiki.musicbrainz.org/MusicBrainz_Identifier)
+- include arguments (`string[]`), see [Include arguments](#include-arguments)
 
+#### Lookup URLs
 
-| Query argument        | Query value     | 
-|-----------------------|-----------------|  
-| `query.collection`    | Collection MBID |
+There is special method to lookup URL entity / entities by one, or an array of URLs 
+([MusicBrainz documentation](https://musicbrainz.org/doc/MusicBrainz_API#url_(by_text))):
+
+```js
+const urls = await mbApi.lookupUrl(['https://open.spotify.com/track/2AMysGXOe0zzZJMtH3Nizb', 'https://open.spotify.com/track/78Teboqh9lPIxWlIW5RMQL']);
+```
+
+or 
+
+```js
+const url = await mbApi.lookupUrl('https://open.spotify.com/track/2AMysGXOe0zzZJMtH3Nizb']);
+```
+
+Arguments:
+- url (`string` | `string[]`): URL or array of URLs
+- include arguments (`string[]`), see [Include arguments](#include-arguments)
+
+Note that the return type is different, depending on if a single URL or an array of URLs is provided.
 
 ### Browse artist
 
@@ -355,6 +371,82 @@ Search a combination of a release-group and an artist.
 const result = await mbApi.search('release-group', {artist: 'Racine carrée', releasegroup: 'Stromae'});
 ```
 
+## Include arguments
+
+
+### Subqueries
+
+_Include Arguments_ which allow you to request more information to be included about the entity.
+
+| entity           | supported _include arguments_                                              |
+|------------------|----------------------------------------------------------------------------|
+| `area`           |                                                                            |
+| `artist`         | `recordings`, `releases`, `release-groups`, `works`                        |                             
+| `collection`     | `user-collections` (includes private collections, requires authentication) |
+| `event`          |                                                                            |
+| `genre`          |                                                                            |
+| `instrument`     |                                                                            |
+| `label`          | `releases`                                                                 |
+| `place`          |                                                                            |
+| `recording`      | `artists`, `releases`, `release-groups`, `isrcs`, `url-rels`               |
+| `release`        | `artists`, `collections`, `labels`, `recordings`, `release-groups`         |
+| `release-group`  | `artists`, `releases`                                                      |
+| `series`         |                                                                            | 
+| `work`           |                                                                            | 
+| `url`            |                                                                            |
+
+### Arguments which affect subqueries
+
+Some additional _include parameters_ are supported to specify how much of the data about the linked entities should be included:
+
+| _include argument_ | Description                                                                                                                                                                                                           |
+|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `discids`          | include discids for all media in the releases                                                                                                                                                                         |
+| `media`            | include media for all releases, this includes the # of tracks on each medium and its format.                                                                                                                          |                             
+| `isrcs`            | user-collections (includes private collections, requires authentication)include isrcs for all recordings                                                                                                              |
+| `artist-credits`   | include artists credits for all releases and recordings                                                                                                                                                               |
+| `various-artists`  | include only those releases where the artist appears on one of the tracks, but not in the artist credit for the release itself (this is only valid on entity `"artist"` and _include argument_ `"releases request"`). |
+
+### Miscellaneous arguments
+
+| _include argument_          | Description                                                                                                                            |
+|-----------------------------|----------------------------------------------------------------------------------------------------------------------------------------|
+| `aliases`                   | include artist, label, area or work aliases; treat these as a set, as they are not deliberately ordered                                |
+| `annotation`                | include annotation                                                                                                                     |                             
+| `tags`, `ratings`           | include tags and/or ratings for the entity                                                                                             |
+| `user-tags`, `user-ratings` | same as above, but only return the tags and/or ratings submitted by the specified user                                                 |
+| `genres`, `user-genres`     | include genres (tags in the [genres list](https://musicbrainz.org/genres)): either all or the ones submitted by the user, respectively |
+
+### Relationships
+
+You can request relationships with the appropriate includes:
+- `area-rels`
+- `artist-rels`
+- `event-rels`
+- `genre-rels`
+- `instrument-rels`
+- `label-rels`
+- `place-rels`
+- `recording-rels`
+- `release-rels`
+- `release-group-rels`
+- `series-rels`
+- `url-rels`
+- `work-rels`
+
+These will load relationships between the requested entity and the specific entity type. 
+For example, if you request "work-rels" when looking up an artist, 
+you'll get all the relationships between this artist and any works, 
+and if you request "artist-rels" you'll get the relationships between this artist and any other artists. 
+As such, keep in mind requesting "artist-rels" for an artist, "release-rels" for a release, etc. will not load all the relationships for the entity, just the ones to other entities of the same type.
+
+In a release request, you might also be interested on relationships for the recordings linked to the release, or the release group linked to the release, or even for the works linked to those recordings that are linked to the release (for example, to find out who played guitar on a specific track, who wrote the lyrics for the song being performed, or whether the release group is part of a series). Similarly, for a recording request, you might want to get the relationships for any linked works. 
+There are three additional includes for this:
+
+- recording-level-rels
+- release-group-level-rels (for releases only)
+- work-level-rels
+
 # Submitting data via XML POST
 
 [Submitting data via XML POST](https://wiki.musicbrainz.org/Development/XML_Web_Service/Version_2#Submitting_data) may be done using personal MusicBrainz credentials. 
@@ -425,26 +517,40 @@ await mbApi.addSpotifyIdToRecording(recording, '2AMysGXOe0zzZJMtH3Nizb');
 This library also supports the [Cover Art Archive API](https://musicbrainz.org/doc/Cover_Art_Archive/API).
 
 ### Fetch Release Cover Art
+
+#### Fetch available cover art information
+
 ```js
 import { CoverArtArchiveApi } from 'musicbrainz-api';
 
 const coverArtArchiveApiClient = new CoverArtArchiveApi();
 
-async function getReleaseCoverArt(releaseMbid, coverType = '') {
-    try {
-        const coverInfo = await coverArtArchiveApiClient.getReleaseCovers(releaseMbid, coverType);
-        console.log(`Cover info for ${coverType || 'all covers'}`, coverInfo);
-    } catch (error) {
-        console.error(`Failed to fetch ${coverType || 'all covers'}:`, error);
+async function fetchCoverArt(releaseMbid, coverType = '') {
+    const coverInfo = await coverArtArchiveApiClient.getReleaseCovers(releaseMbid);
+    for(const image of coverInfo.images) {
+        console.log(`Cover art front=${image.front} back=${image.back} url=${image.image}`);
     }
 }
 
-(async () => {
-    const releaseMbid = 'your-release-mbid-here';  // Replace with actual MBID
-    await getReleaseCoverArt(releaseMbid); // Get all covers
-    await getReleaseCoverArt(releaseMbid, 'front'); // Get best front cover
-    await getReleaseCoverArt(releaseMbid, 'back'); // Get best back cover
-})();
+fetchCoverArt('976e0677-a480-4a5e-a177-6a86c1900bbf').catch(error => {
+    console.error(`Failed to fetch cover art: ${error.message}`);
+})
+```
+
+#### Fetch front or back cover for a release
+```js
+import { CoverArtArchiveApi } from 'musicbrainz-api';
+
+const coverArtArchiveApiClient = new CoverArtArchiveApi();
+
+async function fetchCoverArt(releaseMbid, coverType = '') {
+    const coverInfo = await coverArtArchiveApiClient.getReleaseCover(releaseMbid, 'front');
+    console.log(`Cover art url=${coverInfo.url}`);
+}
+
+fetchCoverArt('976e0677-a480-4a5e-a177-6a86c1900bbf').catch(error => {
+    console.error(`Failed to fetch cover art: ${error.message}`);
+})
 ```
 
 ### Release Group Cover Art
@@ -453,22 +559,32 @@ import { CoverArtArchiveApi } from 'musicbrainz-api';
 
 const coverArtArchiveApiClient = new CoverArtArchiveApi();
 
-async function getCoverArt(releaseGroupMbid, coverType = '') {
-    try {
-        const coverInfo = await coverArtArchiveApiClient.getReleaseGroupCovers(releaseGroupMbid, coverType);
-        console.log(`Cover info for ${coverType || 'all covers'}`, coverInfo);
-    } catch (error) {
-        console.error(`Failed to fetch ${coverType || 'all covers'}:`, error);
+async function fetchCoverArt(releaseMbid, coverType = '') {
+    const coverInfo = await coverArtArchiveApiClient.getReleaseGroupCovers(releaseMbid);
+    for(const image of coverInfo.images) {
+        console.log(`Cover art front=${image.front} back=${image.back} url=${image.image}`);
     }
 }
 
-(async () => {
-    const releaseGroupMbid = 'your-release-group-mbid-here';  // Replace with actual MBID
-    await getCoverArt(releaseGroupMbid); // Get all covers
-    await getCoverArt(releaseGroupMbid, 'front'); // Get best front cover
-    await getCoverArt(releaseGroupMbid, 'back'); // Get best back cover
-})();
+fetchCoverArt('976e0677-a480-4a5e-a177-6a86c1900bbf').catch(error => {
+    console.error(`Failed to fetch cover art: ${error.message}`);
+})
+```
 
+#### Fetch front or back cover for a release-group
+```js
+import { CoverArtArchiveApi } from 'musicbrainz-api';
+
+const coverArtArchiveApiClient = new CoverArtArchiveApi();
+
+async function fetchCoverArt(releaseMbid, coverType = '') {
+    const coverInfo = await coverArtArchiveApiClient.getReleaseGroupCover(releaseMbid, 'front');
+    console.log(`Cover art url=${coverInfo.url}`);
+}
+
+fetchCoverArt('976e0677-a480-4a5e-a177-6a86c1900bbf').catch(error => {
+    console.error(`Failed to fetch cover art: ${error.message}`);
+})
 ```
 
 ## CommonJS backward compatibility
@@ -505,3 +621,7 @@ async function run() {
 
 run();
 ```
+
+## Licence
+
+This project is licensed under the [MIT License](LICENSE.txt). Feel free to use, modify, and distribute as needed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musicbrainz-api",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "description": "MusicBrainz API client for reading and submitting metadata",
   "exports": {
     "node": {
@@ -90,9 +90,10 @@
     "compile-lib": "tsc -p lib",
     "compile-test": "tsc -p test",
     "compile": "yarn run compile-lib && yarn run compile-test",
-    "lint-md": "remark -u preset-lint-recommended .",
-    "lint-ts": "biome check",
-    "lint": "yarn run lint-md && yarn run lint-ts",
+    "lint:md": "remark -u preset-lint-recommended .",
+    "lint:ts": "biome check",
+    "lint:fix": "biome check --fix",
+    "lint": "yarn run lint:md && yarn run lint:ts",
     "test": "mocha",
     "build": "yarn run clean && yarn run compile",
     "start": "yarn run compile && yarn run lint && yarn run cover-test",
@@ -114,5 +115,5 @@
     ],
     "report-dir": "coverage"
   },
-  "packageManager": "yarn@4.6.0"
+  "packageManager": "yarn@4.9.1"
 }

package/lib/coverartarchive-api.d.ts

@@ -1,48 +0,0 @@
-export type CovertType = 'Front' | 'Back' | 'Booklet' | 'Medium' | 'Obi' | 'Spine' | 'Track' | 'Tray' | 'Sticker' | 'Poster' | 'Liner' | 'Watermark' | 'Raw/Unedited' | 'Matrix/Runout' | 'Top' | 'Bottom' | 'Other';
-export interface IImage {
-    types: CovertType[];
-    front: boolean;
-    back: boolean;
-    edit: number;
-    image: string;
-    comment: string;
-    approved: boolean;
-    id: string;
-    thumbnails: {
-        large: string;
-        small: string;
-        '250': string;
-        '500'?: string;
-        '1200'?: string;
-    };
-}
-export interface ICoverInfo {
-    images: IImage[];
-    release: string;
-}
-export declare class CoverArtArchiveApi {
-    private httpClient;
-    private getJson;
-    /**
-     * Fetch release
-     * @releaseId Release MBID
-     * @param releaseId MusicBrainz Release MBID
-     * @param coverType Cover type
-     */
-    getReleaseCovers(releaseId: string, coverType?: 'front' | 'back'): Promise<ICoverInfo>;
-    /**
-     * Fetch release-group
-     * @releaseGroupId Release-group MBID
-     * @param releaseGroupId MusicBrainz Release Group MBID
-     * @param coverType Cover type
-     */
-    getReleaseGroupCovers(releaseGroupId: string, coverType?: 'front' | 'back'): Promise<ICoverInfo>;
-    /**
-     * Fetch covers
-     * @releaseId MBID
-     * @param releaseId MusicBrainz Release Group MBID
-     * @param releaseType Fetch covers for specific release or release-group
-     * @param coverType Cover type
-     */
-    private getCovers;
-}

package/lib/coverartarchive-api.js

@@ -1,60 +0,0 @@
-/* eslint-disable-next-line */
-import { HttpClient } from "./http-client.js";
-export class CoverArtArchiveApi {
-    constructor() {
-        this.httpClient = new HttpClient({ baseUrl: 'https://coverartarchive.org', userAgent: 'Node.js musicbrains-api', timeout: 20000 });
-    }
-    async getJson(path) {
-        const response = await this.httpClient.get(path, {
-            headers: {
-                Accept: "application/json"
-            }
-        });
-        const contentType = response.headers.get("Content-Type");
-        if (response.status === 404 && contentType?.toLowerCase() !== "application/json") {
-            return {
-                "error": "Not Found",
-                "help": "For usage, please see: https://musicbrainz.org/development/mmd"
-            };
-        }
-        return response.json();
-    }
-    /**
-     * Fetch release
-     * @releaseId Release MBID
-     * @param releaseId MusicBrainz Release MBID
-     * @param coverType Cover type
-     */
-    getReleaseCovers(releaseId, coverType) {
-        return this.getCovers(releaseId, 'release', coverType);
-    }
-    /**
-     * Fetch release-group
-     * @releaseGroupId Release-group MBID
-     * @param releaseGroupId MusicBrainz Release Group MBID
-     * @param coverType Cover type
-     */
-    getReleaseGroupCovers(releaseGroupId, coverType) {
-        return this.getCovers(releaseGroupId, 'release-group', coverType);
-    }
-    /**
-     * Fetch covers
-     * @releaseId MBID
-     * @param releaseId MusicBrainz Release Group MBID
-     * @param releaseType Fetch covers for specific release or release-group
-     * @param coverType Cover type
-     */
-    async getCovers(releaseId, releaseType = 'release', coverType) {
-        const path = [releaseType, releaseId];
-        if (coverType) {
-            path.push(coverType);
-        }
-        const info = await this.getJson(`/${path.join('/')}`);
-        // Hack to correct http addresses into https
-        if (info.release?.startsWith('http:')) {
-            info.release = `https${info.release.substring(4)}`;
-        }
-        return info;
-    }
-}
-//# sourceMappingURL=coverartarchive-api.js.map

package/lib/digest-auth.d.ts

@@ -1,21 +0,0 @@
-export interface ICredentials {
-    username: string;
-    password: string;
-}
-export declare class DigestAuth {
-    private credentials;
-    /**
-     * RFC 2617: handle both MD5 and MD5-sess algorithms.
-     *
-     * If the algorithm directive's value is "MD5" or unspecified, then HA1 is
-     *   HA1=MD5(username:realm:password)
-     * If the algorithm directive's value is "MD5-sess", then HA1 is
-     *   HA1=MD5(MD5(username:realm:password):nonce:cnonce)
-     */
-    static ha1Compute(algorithm: string, user: string, realm: string, pass: string, nonce: string, cnonce: string): string;
-    hasAuth: boolean;
-    sentAuth: boolean;
-    bearerToken: string | null;
-    constructor(credentials: ICredentials);
-    digest(method: string, path: string, authHeader: string): string;
-}

package/lib/digest-auth.js

@@ -1,77 +0,0 @@
-import { v4 as uuidv4 } from 'uuid';
-import sparkMd5 from 'spark-md5';
-const md5 = sparkMd5.hash;
-export class DigestAuth {
-    /**
-     * RFC 2617: handle both MD5 and MD5-sess algorithms.
-     *
-     * If the algorithm directive's value is "MD5" or unspecified, then HA1 is
-     *   HA1=MD5(username:realm:password)
-     * If the algorithm directive's value is "MD5-sess", then HA1 is
-     *   HA1=MD5(MD5(username:realm:password):nonce:cnonce)
-     */
-    static ha1Compute(algorithm, user, realm, pass, nonce, cnonce) {
-        const ha1 = md5(`${user}:${realm}:${pass}`); // lgtm [js/insufficient-password-hash]
-        return algorithm && algorithm.toLowerCase() === 'md5-sess' ? md5(`${ha1}:${nonce}:${cnonce}`) : ha1;
-    }
-    constructor(credentials) {
-        this.credentials = credentials;
-        this.hasAuth = false;
-        this.sentAuth = false;
-        this.bearerToken = null;
-    }
-    digest(method, path, authHeader) {
-        // TODO: More complete implementation of RFC 2617.
-        //   - support qop="auth-int" only
-        //   - handle Authentication-Info (not necessarily?)
-        //   - check challenge.stale (not necessarily?)
-        //   - increase nc (not necessarily?)
-        // For reference:
-        // http://tools.ietf.org/html/rfc2617#section-3
-        // https://github.com/bagder/curl/blob/master/lib/http_digest.c
-        const challenge = {};
-        const re = /([a-z0-9_-]+)=(?:"([^"]+)"|([a-z0-9_-]+))/gi;
-        while (true) {
-            const match = re.exec(authHeader);
-            if (!match) {
-                break;
-            }
-            challenge[match[1]] = match[2] || match[3];
-        }
-        const qop = /(^|,)\s*auth\s*($|,)/.test(challenge.qop) && 'auth';
-        const nc = qop && '00000001';
-        const cnonce = qop && uuidv4().replace(/-/g, '');
-        const ha1 = DigestAuth.ha1Compute(challenge.algorithm, this.credentials.username, challenge.realm, this.credentials.password, challenge.nonce, cnonce);
-        const ha2 = md5(`${method}:${path}`); // lgtm [js/insufficient-password-hash]
-        const digestResponse = qop
-            ? md5(`${ha1}:${challenge.nonce}:${nc}:${cnonce}:${qop}:${ha2}`) // lgtm [js/insufficient-password-hash]
-            : md5(`${ha1}:${challenge.nonce}:${ha2}`); // lgtm [js/insufficient-password-hash]
-        const authValues = {
-            username: this.credentials.username,
-            realm: challenge.realm,
-            nonce: challenge.nonce,
-            uri: path,
-            qop,
-            response: digestResponse,
-            nc,
-            cnonce,
-            algorithm: challenge.algorithm,
-            opaque: challenge.opaque
-        };
-        const parts = [];
-        Object.entries(authValues).forEach(([key, value]) => {
-            if (value) {
-                if (key === 'qop' || key === 'nc' || key === 'algorithm') {
-                    parts.push(`${key}=${value}`);
-                }
-                else {
-                    parts.push(`${key}="${value}"`);
-                }
-            }
-        });
-        const digest = `Digest ${parts.join(', ')}`;
-        this.sentAuth = true;
-        return digest;
-    }
-}
-//# sourceMappingURL=digest-auth.js.map

package/lib/entry-default.d.ts

@@ -1,2 +0,0 @@
-export * from './coverartarchive-api.js';
-export * from './musicbrainz-api.js';

package/lib/entry-default.js

@@ -1,3 +0,0 @@
-export * from './coverartarchive-api.js';
-export * from './musicbrainz-api.js';
-//# sourceMappingURL=entry-default.js.map

package/lib/entry-node.d.ts

@@ -1,2 +0,0 @@
-export * from './coverartarchive-api.js';
-export * from './musicbrainz-api-node.js';

package/lib/entry-node.js

@@ -1,3 +0,0 @@
-export * from './coverartarchive-api.js';
-export * from './musicbrainz-api-node.js';
-//# sourceMappingURL=entry-node.js.map

package/lib/http-client-node.d.ts

@@ -1,11 +0,0 @@
-import { type Cookie } from "tough-cookie";
-import { HttpClient, type IHttpClientOptions } from "./http-client.js";
-export type HttpFormData = {
-    [key: string]: string;
-};
-export declare class HttpClientNode extends HttpClient {
-    private cookieJar;
-    constructor(options: IHttpClientOptions);
-    protected registerCookies(response: Response): Promise<Cookie | undefined>;
-    getCookies(): Promise<string | null>;
-}

package/lib/http-client-node.js

@@ -1,19 +0,0 @@
-import { CookieJar } from "tough-cookie";
-import { HttpClient } from "./http-client.js";
-export class HttpClientNode extends HttpClient {
-    constructor(options) {
-        super(options);
-        this.cookieJar = new CookieJar();
-    }
-    registerCookies(response) {
-        const cookie = response.headers.get('set-cookie');
-        if (cookie) {
-            return this.cookieJar.setCookie(cookie, response.url);
-        }
-        return Promise.resolve(undefined);
-    }
-    getCookies() {
-        return this.cookieJar.getCookieString(this.options.baseUrl); // Get cookies for the request
-    }
-}
-//# sourceMappingURL=http-client-node.js.map

package/lib/http-client.d.ts

@@ -1,27 +0,0 @@
-import type { Cookie } from "tough-cookie";
-export type HttpFormData = {
-    [key: string]: string;
-};
-export interface IHttpClientOptions {
-    baseUrl: string;
-    timeout: number;
-    userAgent: string;
-}
-export interface IFetchOptions {
-    query?: HttpFormData;
-    retryLimit?: number;
-    body?: string;
-    headers?: HeadersInit;
-    followRedirects?: boolean;
-}
-export declare class HttpClient {
-    protected options: IHttpClientOptions;
-    constructor(options: IHttpClientOptions);
-    get(path: string, options?: IFetchOptions): Promise<Response>;
-    post(path: string, options?: IFetchOptions): Promise<Response>;
-    postForm(path: string, formData: HttpFormData, options?: IFetchOptions): Promise<Response>;
-    postJson(path: string, json: Object, options?: IFetchOptions): Promise<Response>;
-    private _fetch;
-    protected registerCookies(response: Response): Promise<Cookie | undefined>;
-    getCookies(): Promise<string | null>;
-}

package/lib/http-client.js

@@ -1,50 +0,0 @@
-export class HttpClient {
-    constructor(options) {
-        this.options = options;
-    }
-    get(path, options) {
-        return this._fetch('get', path, options);
-    }
-    post(path, options) {
-        return this._fetch('post', path, options);
-    }
-    postForm(path, formData, options) {
-        const encodedFormData = new URLSearchParams(formData).toString();
-        return this._fetch('post', path, { ...options, body: encodedFormData, headers: { 'Content-Type': 'application/x-www-form-urlencoded' } });
-    }
-    // biome-ignore lint/complexity/noBannedTypes:
-    postJson(path, json, options) {
-        const encodedJson = JSON.stringify(json);
-        return this._fetch('post', path, { ...options, body: encodedJson, headers: { 'Content-Type': 'application/json.' } });
-    }
-    async _fetch(method, path, options) {
-        if (!options)
-            options = {};
-        let url = `${this.options.baseUrl}/${path}`;
-        if (options.query) {
-            url += `?${new URLSearchParams(options.query)}`;
-        }
-        const cookies = await this.getCookies();
-        const headers = new Headers(options.headers);
-        headers.set('User-Agent', this.options.userAgent);
-        if (cookies !== null) {
-            headers.set('Cookie', cookies);
-        }
-        const response = await fetch(url, {
-            method,
-            ...options,
-            headers,
-            body: options.body,
-            redirect: options.followRedirects === false ? 'manual' : 'follow'
-        });
-        await this.registerCookies(response);
-        return response;
-    }
-    registerCookies(response) {
-        return Promise.resolve(undefined);
-    }
-    async getCookies() {
-        return Promise.resolve(null);
-    }
-}
-//# sourceMappingURL=http-client.js.map

package/lib/musicbrainz-api-node.d.ts

@@ -1,16 +0,0 @@
-export { XmlMetadata } from './xml/xml-metadata.js';
-export { XmlIsrc } from './xml/xml-isrc.js';
-export { XmlIsrcList } from './xml/xml-isrc-list.js';
-export { XmlRecording } from './xml/xml-recording.js';
-import { HttpClientNode } from "./http-client-node.js";
-import { MusicBrainzApi as MusicBrainzApiDefault } from "./musicbrainz-api.js";
-export * from './musicbrainz.types.js';
-export * from './http-client.js';
-export declare class MusicBrainzApi extends MusicBrainzApiDefault {
-    protected initHttpClient(): HttpClientNode;
-    login(): Promise<boolean>;
-    /**
-     * Logout
-     */
-    logout(): Promise<boolean>;
-}