feat: expose buildUrl method

README.md

@@ -133,3 +133,11 @@ customJSON<T>(method: string, params: Params): Promise<T>
 ```
 
 Allows you to make a custom request to the server and parse the response as JSON.
+
+### `buildUrl`
+
+```ts
+buildUrl(method: string, params: Record<string, unknown>) {
+```
+
+Builds a complete URL for a Subsonic API request with authentication and query parameters.

src/index.ts

@@ -166,7 +166,14 @@ export default class SubsonicAPI {
 		return base;
 	}
 
-	async #request(method: string, params?: Record<string, unknown>) {
+	/**
+ 	* Builds a complete URL for a Subsonic API request with authentication and query parameters.
+ 	*/
+	async buildUrl(method: string, params: Record<string, unknown>) {
+		return this.#buildUrl(method, params);
+	}
+
+	async #buildUrl(method: string, params?: Record<string, unknown>): Promise<URL> {
 		let base = this.baseURL();
 		if (!base.endsWith("rest/")) base += "rest/";
 
@@ -201,6 +208,12 @@ export default class SubsonicAPI {
 			throw new Error("no auth provided");
 		}
 
+		return url
+	}
+
+	async #request(method: string, params?: Record<string, unknown>) {
+		const url = await this.#buildUrl(method, params)
+
 		if (this.#config.post) {
 			const [path, search] = url.toString().split("?");
 			return this.#fetch(path, {