navidrome-mcp 1.0.1

package/dist/types/radio.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Navidrome MCP Server - Radio Data Transfer Objects
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+/** Radio station from Navidrome API */
+export interface RadioStationDTO {
+    /** Unique radio station ID */
+    id: string;
+    /** Stream URL for the radio station */
+    streamUrl: string;
+    /** Station name/title */
+    name: string;
+    /** Optional homepage URL */
+    homePageUrl?: string;
+    /** ISO 8601 timestamp when created */
+    createdAt: string;
+    /** ISO 8601 timestamp when last updated */
+    updatedAt: string;
+}
+/** Request to create a new radio station */
+export interface CreateRadioStationRequest {
+    /** Station name (required) */
+    name: string;
+    /** Stream URL (required) */
+    streamUrl: string;
+    /** Optional homepage URL */
+    homePageUrl?: string;
+}
+/** Response from creating a radio station */
+export interface CreateRadioStationResponse {
+    /** Success status */
+    success: boolean;
+    /** Created radio station */
+    station?: RadioStationDTO;
+    /** Error message if failed */
+    error?: string;
+    /** One-time validation reminder message */
+    validation_reminder?: string;
+}
+/** Response from deleting a radio station */
+export interface DeleteRadioStationResponse {
+    /** Success status */
+    success: boolean;
+    /** ID of deleted station */
+    id?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/** Response from listing radio stations */
+export interface ListRadioStationsResponse {
+    /** Array of radio stations */
+    stations: RadioStationDTO[];
+    /** Total count */
+    total: number;
+    /** One-time tip message */
+    tip?: string;
+}
+/** Radio playback status information */
+export interface RadioPlaybackInfo {
+    /** Whether radio is currently playing */
+    playing: boolean;
+    /** Current radio station info if playing */
+    currentStation?: RadioStationDTO;
+    /** Current stream metadata if available */
+    metadata?: {
+        /** Current track/show title */
+        title?: string;
+        /** Current artist/host */
+        artist?: string;
+        /** Station description */
+        description?: string;
+    };
+}
+/**
+ * External radio station from Radio Browser API
+ */
+export interface ExternalRadioStationDTO {
+    /** Unique station UUID */
+    stationUuid: string;
+    /** Station name */
+    name: string;
+    /** Resolved play URL (preferred over raw URL) */
+    playUrl: string;
+    /** Station homepage URL */
+    homepage?: string;
+    /** Tags/genres for the station */
+    tags: string[];
+    /** Country code (ISO 3166) */
+    countryCode?: string;
+    /** Language codes */
+    languageCodes: string[];
+    /** Audio codec (MP3, AAC, OGG, etc.) */
+    codec?: string;
+    /** Bitrate in kbps */
+    bitrate?: number;
+    /** Whether station uses HLS streaming */
+    hls: boolean;
+    /** Number of votes */
+    votes: number;
+    /** Total click count */
+    clickCount: number;
+    /** Stream validation results (if validated) */
+    validation?: {
+        /** Whether validation was performed */
+        validated: boolean;
+        /** Whether stream passed validation */
+        isValid: boolean;
+        /** Brief validation status */
+        status: string;
+        /** Validation duration in ms */
+        duration?: number;
+    };
+}
+/**
+ * Response from radio station discovery
+ */
+export interface DiscoverRadioStationsResponse {
+    /** Array of discovered stations */
+    stations: ExternalRadioStationDTO[];
+    /** Data source */
+    source: 'radio-browser';
+    /** Mirror server used */
+    mirrorUsed: string;
+    /** Validation summary (if validation was performed) */
+    validationSummary?: {
+        totalStations: number;
+        validatedStations: number;
+        workingStations: number;
+        message: string;
+    };
+}
+/**
+ * Radio filter options for UI pickers
+ */
+export interface RadioFiltersResponse {
+    /** Available tags/genres */
+    tags?: Array<{
+        name: string;
+        stationCount: number;
+    }>;
+    /** Available countries */
+    countries?: Array<{
+        code: string;
+        name: string;
+        stationCount: number;
+    }>;
+    /** Available languages */
+    languages?: Array<{
+        code: string;
+        name: string;
+        stationCount: number;
+    }>;
+    /** Available codecs */
+    codecs?: Array<{
+        name: string;
+        stationCount: number;
+    }>;
+}
+/**
+ * Response from clicking/playing a radio station
+ */
+export interface ClickRadioStationResponse {
+    /** Success status */
+    ok: boolean;
+    /** Canonical play URL */
+    playUrl: string;
+    /** Response message */
+    message: string;
+}
+/**
+ * Response from voting for a radio station
+ */
+export interface VoteRadioStationResponse {
+    /** Success status */
+    ok: boolean;
+    /** Response message */
+    message: string;
+}
+//# sourceMappingURL=radio.d.ts.map

package/dist/types/radio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../src/types/radio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,yBAAyB;IACxC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,6CAA6C;AAC7C,MAAM,WAAW,0BAA0B;IACzC,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,6CAA6C;AAC7C,MAAM,WAAW,0BAA0B;IACzC,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,yBAAyB;IACxC,8BAA8B;IAC9B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE;QACT,+BAA+B;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,0BAA0B;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,0BAA0B;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,GAAG,EAAE,OAAO,CAAC;IACb,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE;QACX,uCAAuC;QACvC,SAAS,EAAE,OAAO,CAAC;QACnB,uCAAuC;QACvC,OAAO,EAAE,OAAO,CAAC;QACjB,8BAA8B;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,gCAAgC;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,mCAAmC;IACnC,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,kBAAkB;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,IAAI,CAAC,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,0BAA0B;IAC1B,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,0BAA0B;IAC1B,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,uBAAuB;IACvB,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,qBAAqB;IACrB,EAAE,EAAE,OAAO,CAAC;IACZ,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,qBAAqB;IACrB,EAAE,EAAE,OAAO,CAAC;IACZ,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/radio.js

@@ -0,0 +1,19 @@
+/**
+ * Navidrome MCP Server - Radio Data Transfer Objects
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+export {};
+//# sourceMappingURL=radio.js.map

package/dist/types/radio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio.js","sourceRoot":"","sources":["../../src/types/radio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/types/tags.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Navidrome MCP Server - Tags Data Transfer Objects
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Clean DTO for tags, representing metadata key-value pairs
+ */
+export interface TagDTO {
+    /** Unique tag ID */
+    id: string;
+    /** Tag name (e.g., "genre", "composer", "label") */
+    tagName: string;
+    /** Tag value */
+    tagValue: string;
+    /** Number of albums with this tag */
+    albumCount: number;
+    /** Number of songs with this tag */
+    songCount: number;
+}
+/**
+ * Response format for listing tags with pagination
+ */
+export interface ListTagsResponse {
+    /** Array of tags */
+    tags: TagDTO[];
+    /** Total number of tags available */
+    total: number;
+    /** Pagination offset used */
+    offset: number;
+    /** Pagination limit used */
+    limit: number;
+}
+/**
+ * Tag distribution analysis for a specific tag name
+ */
+export interface TagDistribution {
+    /** Tag name being analyzed */
+    tagName: string;
+    /** Number of unique values for this tag name */
+    uniqueValues: number;
+    /** Total songs across all values */
+    totalSongs: number;
+    /** Total albums across all values */
+    totalAlbums: number;
+    /** Most common tag value */
+    mostCommon: TagDTO;
+    /** Distribution of values (sorted by usage) */
+    distribution: TagDTO[];
+}
+/**
+ * Response format for tag distribution analysis
+ */
+export interface TagDistributionResponse {
+    /** Array of tag distributions by name */
+    distributions: TagDistribution[];
+    /** Total unique tag names */
+    totalTagNames: number;
+}
+//# sourceMappingURL=tags.d.ts.map

package/dist/types/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/types/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,aAAa,EAAE,eAAe,EAAE,CAAC;IACjC,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/tags.js

@@ -0,0 +1,19 @@
+/**
+ * Navidrome MCP Server - Tags Data Transfer Objects
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+export {};
+//# sourceMappingURL=tags.js.map

package/dist/types/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../src/types/tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/utils/cache.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Navidrome MCP Server - Cache Utility
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+export declare class Cache<T> {
+    private store;
+    private ttl;
+    private cleanupInterval;
+    private cleanupIntervalMs;
+    constructor(ttlSeconds?: number, enableAutoCleanup?: boolean);
+    private startAutoCleanup;
+    private cleanup;
+    set(key: string, value: T): void;
+    get(key: string): T | undefined;
+    clear(): void;
+    delete(key: string): boolean;
+    destroy(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,qBAAa,KAAK,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,eAAe,CAAyC;IAChE,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,UAAU,SAAM,EAAE,iBAAiB,UAAO;IAUtD,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,OAAO;IASf,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAOhC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAY/B,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,OAAO,IAAI,IAAI;CAQhB"}

package/dist/utils/cache.js

@@ -0,0 +1,84 @@
+/**
+ * Navidrome MCP Server - Cache Utility
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+export class Cache {
+    store = new Map();
+    ttl;
+    cleanupInterval = undefined;
+    cleanupIntervalMs;
+    constructor(ttlSeconds = 300, enableAutoCleanup = true) {
+        this.ttl = ttlSeconds * 1000;
+        // Run cleanup every ttl period or at least once per hour
+        this.cleanupIntervalMs = Math.min(this.ttl, 3600000);
+        if (enableAutoCleanup) {
+            this.startAutoCleanup();
+        }
+    }
+    startAutoCleanup() {
+        // Clear any existing interval first
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+        }
+        // Set up periodic cleanup
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, this.cleanupIntervalMs);
+        // Ensure cleanup runs when process exits
+        if (this.cleanupInterval.unref) {
+            this.cleanupInterval.unref(); // Don't keep process alive just for cleanup
+        }
+    }
+    cleanup() {
+        const now = new Date();
+        for (const [key, entry] of this.store.entries()) {
+            if (entry.expiry < now) {
+                this.store.delete(key);
+            }
+        }
+    }
+    set(key, value) {
+        this.store.set(key, {
+            value,
+            expiry: new Date(Date.now() + this.ttl),
+        });
+    }
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return undefined;
+        if (entry.expiry < new Date()) {
+            this.store.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    clear() {
+        this.store.clear();
+    }
+    delete(key) {
+        return this.store.delete(key);
+    }
+    destroy() {
+        // Clean up resources when cache is no longer needed
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        this.store.clear();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,MAAM,OAAO,KAAK;IACR,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IACzC,GAAG,CAAS;IACZ,eAAe,GAA+B,SAAS,CAAC;IACxD,iBAAiB,CAAS;IAElC,YAAY,UAAU,GAAG,GAAG,EAAE,iBAAiB,GAAG,IAAI;QACpD,IAAI,CAAC,GAAG,GAAG,UAAU,GAAG,IAAI,CAAC;QAC7B,yDAAyD;QACzD,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAErD,IAAI,iBAAiB,EAAE,CAAC;YACtB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAEO,gBAAgB;QACtB,oCAAoC;QACpC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACtC,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAE3B,yCAAyC;QACzC,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,4CAA4C;QAC5E,CAAC;IACH,CAAC;IAEO,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAQ;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,OAAO;QACL,oDAAoD;QACpD,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/utils/error-formatter.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Navidrome MCP Server - Error Formatting Utility
+ * Copyright (C) 2025
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Standardized error message formatting utilities
+ * Provides consistent error messages across the MCP application
+ */
+export declare class ErrorFormatter {
+    /**
+     * Extract message from unknown error type
+     */
+    private static extractMessage;
+    /**
+     * Format HTTP request failures (network issues, 404, 500, etc.)
+     */
+    static httpRequest(operation: string, response: Response, errorText?: string): string;
+    /**
+     * Format Subsonic API specific errors
+     */
+    static subsonicApi(response: Response): string;
+    /**
+     * Format Subsonic API response errors (when subsonic-response.status !== 'ok')
+     */
+    static subsonicResponse(errorMessage?: string): string;
+    /**
+     * Format MCP tool execution failures
+     */
+    static toolExecution(toolName: string, error: unknown): string;
+    /**
+     * Format tool parameter validation errors
+     */
+    static toolValidation(toolName: string, field: string, issue: string): string;
+    /**
+     * Format tool resource not found errors
+     */
+    static toolNotFound(resourceType: string, identifier?: string): string;
+    /**
+     * Format unknown tool errors
+     */
+    static toolUnknown(toolName: string): string;
+    /**
+     * Format not found errors
+     */
+    static notFound(resourceType: string, identifier: string): string;
+    /**
+     * Format authentication failures
+     */
+    static authentication(details?: string): string;
+    /**
+     * Format authorization failures
+     */
+    static authorization(operation: string): string;
+    /**
+     * Format Last.fm API errors
+     */
+    static lastfmApi(response: Response): string;
+    /**
+     * Format Last.fm API response errors
+     */
+    static lastfmResponse(message?: string): string;
+    /**
+     * Format Radio Browser API errors
+     */
+    static radioBrowserApi(response: Response): string;
+    /**
+     * Format generic API request errors
+     */
+    static apiRequest(apiName: string, response: Response): string;
+    /**
+     * Format generic API response errors
+     */
+    static apiResponse(apiName: string, message?: string): string;
+    /**
+     * Format configuration validation failures
+     */
+    static configValidation(messages: string[]): string;
+    /**
+     * Format missing configuration errors
+     */
+    static configMissing(service: string, configKey: string): string;
+    /**
+     * Format general operation failures with context
+     */
+    static operationFailed(operation: string, error: unknown): string;
+    /**
+     * Format unknown resource errors (for MCP resources)
+     */
+    static unknownResource(resourceUri: string): string;
+    /**
+     * Format validation stream/URL errors
+     */
+    static streamValidation(url: string, issue: string): string;
+}
+//# sourceMappingURL=error-formatter.d.ts.map

package/dist/utils/error-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.d.ts","sourceRoot":"","sources":["../../src/utils/error-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;GAGG;AAEH,qBAAa,cAAc;IACzB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAM7B;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAKrF;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAI9C;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;IAMtD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM;IAK9D;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI7E;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAKtE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI5C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAMjE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAK/C;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAM/C;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAI5C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAI/C;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAIlD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAI9D;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAM7D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM;IAInD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAMhE;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM;IAKjE;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAInD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAG5D"}