Add debug mode setting with toggle in admin settings

- Add debugMode field to database schema
- Add debugMode to runtime config and settings
- Add toggle in admin settings page
- Make all debug logging conditional on debugMode flag
- Pass debug flag to LidarrClient

Run: docker compose exec app npx prisma db push

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: oxon1um

app/api/search/artist/[artistId]/route.ts

@@ -18,20 +18,20 @@ export async function GET(req: NextRequest, { params }: { params: Promise<{ arti
       return jsonError("Lidarr is not configured", 500);
     }
 
-    const lidarr = new LidarrClient(config.lidarrUrl, config.lidarrApiKey);
+    const lidarr = new LidarrClient(config.lidarrUrl, config.lidarrApiKey, config.debugMode);
 
     // Debug: log what we're looking up
-    console.log("[artist-detail] Looking up artistId:", artistId);
+    if (config.debugMode) console.log("[artist-detail] Looking up artistId:", artistId);
 
     // Get artist details from lookup
     const artist = await lidarr.getArtistByForeignId(artistId);
-    console.log("[artist-detail] Artist result:", artist);
+    if (config.debugMode) console.log("[artist-detail] Artist result:", artist);
 
     // Get albums (from lookup or from existing library)
     const albums = await lidarr.getAlbumsByArtistForeignId(artistId);
-    console.log("[artist-detail] Albums result:", JSON.stringify(albums, null, 2));
+    if (config.debugMode) console.log("[artist-detail] Albums result:", JSON.stringify(albums, null, 2));
     const existingAlbums = await lidarr.getExistingArtistAlbums(artistId);
-    console.log("[artist-detail] Existing albums:", JSON.stringify(existingAlbums, null, 2));
+    if (config.debugMode) console.log("[artist-detail] Existing albums:", JSON.stringify(existingAlbums, null, 2));
 
     // Mark which albums are already in the library
     const existingAlbumIds = new Set(existingAlbums.map((a) => a.foreignAlbumId));

app/api/settings/route.ts

@@ -18,6 +18,7 @@ const settingsSchema = z.object({
   lidarrMetadataProfileId: z.number().int().positive().nullable().optional(),
   lidarrMonitorMode: z.string().min(1).nullable().optional(),
   requestAutoApprove: z.boolean().optional(),
+  debugMode: z.boolean().optional(),
   testJellyfin: z.boolean().optional(),
   testLidarr: z.boolean().optional()
 });
@@ -93,6 +94,9 @@ export async function PUT(req: NextRequest) {
     if (Object.prototype.hasOwnProperty.call(payload, "requestAutoApprove")) {
       updateInput.requestAutoApprove = payload.requestAutoApprove;
     }
+    if (Object.prototype.hasOwnProperty.call(payload, "debugMode")) {
+      updateInput.debugMode = payload.debugMode;
+    }
 
     if (
       Object.prototype.hasOwnProperty.call(payload, "lidarrApiKey") &&

components/admin-settings-form.tsx

@@ -17,6 +17,7 @@ type SettingsPayload = {
   lidarrMetadataProfileId: number | null;
   lidarrMonitorMode: string;
   requestAutoApprove: boolean;
+  debugMode: boolean;
 };
 
 type PasswordPayload = {
@@ -35,7 +36,8 @@ const defaultState: SettingsPayload = {
   lidarrQualityProfileId: null,
   lidarrMetadataProfileId: null,
   lidarrMonitorMode: "all",
-  requestAutoApprove: true
+  requestAutoApprove: true,
+  debugMode: false
 };
 
 const defaultPasswordState: PasswordPayload = {
@@ -85,7 +87,8 @@ export function AdminSettingsForm() {
     lidarrQualityProfileId: state.lidarrQualityProfileId,
     lidarrMetadataProfileId: state.lidarrMetadataProfileId,
     lidarrMonitorMode: state.lidarrMonitorMode?.trim() ? state.lidarrMonitorMode.trim() : "all",
-    requestAutoApprove: state.requestAutoApprove
+    requestAutoApprove: state.requestAutoApprove,
+    debugMode: state.debugMode
   });
 
   const sendUpdate = async (extra?: { testJellyfin?: boolean; testLidarr?: boolean }) => {
@@ -401,6 +404,31 @@ export function AdminSettingsForm() {
           </span>
         </button>
 
+        {/* Debug Mode Toggle */}
+        <button
+          type="button"
+          aria-pressed={state.debugMode}
+          onClick={() =>
+            setState((prev) => ({ ...prev, debugMode: !prev.debugMode }))
+          }
+          className="flex w-full items-center gap-4 rounded-2xl border border-white/[0.08] bg-panel-2/30 p-5 text-left text-sm text-muted transition hover:border-white/[0.15] focus-visible:outline-none focus-visible:ring-4 focus-visible:ring-[rgba(86,177,255,0.15)]"
+        >
+          <span
+            className={`flex h-6 w-6 shrink-0 items-center justify-center rounded-lg border transition-all ${
+              state.debugMode
+                ? "border-accent/60 bg-accent/20 text-accent"
+                : "border-white/[0.15] bg-transparent text-transparent"
+            }`}
+            aria-hidden
+          >
+            <IconCheck className="h-4 w-4" />
+          </span>
+          <span className="leading-none">
+            <span className="font-medium text-text">Debug mode</span>
+            <span className="ml-2 text-xs text-muted">(Enable verbose logging)</span>
+          </span>
+        </button>
+
         {/* Password Section */}
         {canManagePassword ? (
           <section className="space-y-4 rounded-2xl border border-white/[0.08] bg-panel-2/30 p-5">

lib/lidarr/client.ts

@@ -179,7 +179,8 @@ const normalizeSong = (raw: unknown): LidarrSongSearchResult | null => {
 export class LidarrClient {
   constructor(
     private readonly baseUrl: string,
-    private readonly apiKey: string
+    private readonly apiKey: string,
+    private readonly debug: boolean = false
   ) {}
 
   private async request<T>(path: string, init?: RequestInit): Promise<T> {
@@ -274,18 +275,18 @@ export class LidarrClient {
   async getArtistByForeignId(foreignArtistId: string): Promise<LidarrArtist | null> {
     // First try: check if artist is already in the library
     const existingArtist = await this.getExistingArtistByForeignId(foreignArtistId);
-    console.log("[lidarr] getArtistByForeignId - existing artist:", existingArtist ? { id: existingArtist.id, name: existingArtist.artistName, imagesCount: existingArtist.images?.length } : null);
+    if (this.debug) console.log("[lidarr] getArtistByForeignId - existing artist:", existingArtist ? { id: existingArtist.id, name: existingArtist.artistName, imagesCount: existingArtist.images?.length } : null);
     if (existingArtist) return existingArtist;
 
     // Second try: search by term using the foreignArtistId
     const encoded = encodeURIComponent(foreignArtistId);
     const searchResults = await this.tryRequest<LidarrArtist[]>(`/api/v1/artist/lookup?term=${encoded}`);
-    console.log("[lidarr] getArtistByForeignId - search results:", searchResults?.length ?? 0, "artists");
+    if (this.debug) console.log("[lidarr] getArtistByForeignId - search results:", searchResults?.length ?? 0, "artists");
 
     // Filter results to find matching artist by foreignArtistId
     if (searchResults && searchResults.length > 0) {
       const match = searchResults.find((a) => a.foreignArtistId === foreignArtistId);
-      console.log("[lidarr] getArtistByForeignId - matched artist:", match ? { name: match.artistName, imagesCount: match.images?.length } : null);
+      if (this.debug) console.log("[lidarr] getArtistByForeignId - matched artist:", match ? { name: match.artistName, imagesCount: match.images?.length } : null);
       if (match) return match;
       // Return first result if no exact match
       return searchResults[0];
@@ -298,34 +299,34 @@ export class LidarrClient {
     // First try: search by term
     const encoded = encodeURIComponent(foreignArtistId);
     let albums = await this.tryRequest<LidarrArtistAlbum[]>(`/api/v1/album/lookup?term=${encoded}`);
-    console.log("[lidarr] getAlbumsByArtistForeignId - search results:", albums?.length ?? 0, "albums");
+    if (this.debug) console.log("[lidarr] getAlbumsByArtistForeignId - search results:", albums?.length ?? 0, "albums");
 
     // Filter to only albums matching the foreignArtistId
     if (albums && albums.length > 0) {
       const matching = albums.filter((a) => a.foreignArtistId === foreignArtistId);
-      console.log("[lidarr] getAlbumsByArtistForeignId - filtered by foreignArtistId:", matching.length, "albums");
+      if (this.debug) console.log("[lidarr] getAlbumsByArtistForeignId - filtered by foreignArtistId:", matching.length, "albums");
       if (matching.length > 0) return matching;
     }
 
     if (!albums || albums.length === 0) {
-      console.log("[lidarr] getAlbumsByArtistForeignId - no albums from search, trying fallback");
+      if (this.debug) console.log("[lidarr] getAlbumsByArtistForeignId - no albums from search, trying fallback");
       // Fallback: search by artist name in existing albums
       const artist = await this.getArtistByForeignId(foreignArtistId);
       if (!artist) {
-        console.log("[lidarr] getAlbumsByArtistForeignId - no artist found for fallback");
+        if (this.debug) console.log("[lidarr] getAlbumsByArtistForeignId - no artist found for fallback");
         return [];
       }
 
-      console.log("[lidarr] getAlbumsByArtistForeignId - fallback artist:", artist.artistName);
+      if (this.debug) console.log("[lidarr] getAlbumsByArtistForeignId - fallback artist:", artist.artistName);
       const allAlbums = await this.tryRequest<LidarrArtistAlbum[]>("/api/v1/album");
-      console.log("[lidarr] getAlbumsByArtistForeignId - all albums in library:", allAlbums?.length ?? 0);
+      if (this.debug) console.log("[lidarr] getAlbumsByArtistForeignId - all albums in library:", allAlbums?.length ?? 0);
 
       if (!allAlbums) return [];
 
       const filtered = allAlbums.filter(
         (album) => album.artistName?.toLowerCase() === artist.artistName.toLowerCase()
       );
-      console.log("[lidarr] getAlbumsByArtistForeignId - fallback filtered:", filtered.length, "albums");
+      if (this.debug) console.log("[lidarr] getAlbumsByArtistForeignId - fallback filtered:", filtered.length, "albums");
       return filtered;
     }
 

lib/settings/store.ts

@@ -15,6 +15,7 @@ export type RuntimeConfig = {
   lidarrMetadataProfileId: number | null;
   lidarrMonitorMode: string;
   requestAutoApprove: boolean;
+  debugMode: boolean;
 };
 
 const fromAppConfig = async (config: AppConfig): Promise<RuntimeConfig> => {
@@ -37,7 +38,8 @@ const fromAppConfig = async (config: AppConfig): Promise<RuntimeConfig> => {
     lidarrQualityProfileId: config.lidarrQualityProfileId,
     lidarrMetadataProfileId: config.lidarrMetadataProfileId,
     lidarrMonitorMode: config.lidarrMonitorMode ?? "all",
-    requestAutoApprove: config.requestAutoApprove
+    requestAutoApprove: config.requestAutoApprove,
+    debugMode: config.debugMode ?? false
   };
 };
 
@@ -55,7 +57,8 @@ export const getRuntimeConfig = async (): Promise<RuntimeConfig> => {
     lidarrQualityProfileId: env.lidarrQualityProfileId ?? base.lidarrQualityProfileId,
     lidarrMetadataProfileId: env.lidarrMetadataProfileId ?? base.lidarrMetadataProfileId,
     lidarrMonitorMode: env.lidarrMonitorMode ?? base.lidarrMonitorMode,
-    requestAutoApprove: env.requestAutoApprove ?? base.requestAutoApprove
+    requestAutoApprove: env.requestAutoApprove ?? base.requestAutoApprove,
+    debugMode: base.debugMode
   };
 };
 
@@ -70,6 +73,7 @@ export type UpdateConfigInput = {
   lidarrMetadataProfileId?: number | null;
   lidarrMonitorMode?: string | null;
   requestAutoApprove?: boolean;
+  debugMode?: boolean;
 };
 
 export const updateConfig = async (input: UpdateConfigInput): Promise<RuntimeConfig> => {
@@ -111,6 +115,9 @@ export const updateConfig = async (input: UpdateConfigInput): Promise<RuntimeCon
   if (Object.prototype.hasOwnProperty.call(input, "requestAutoApprove")) {
     updateData.requestAutoApprove = input.requestAutoApprove;
   }
+  if (Object.prototype.hasOwnProperty.call(input, "debugMode")) {
+    updateData.debugMode = input.debugMode;
+  }
 
   await prisma.appConfig.update({
     where: { id: 1 },

prisma/schema.prisma

@@ -98,6 +98,7 @@ model AppConfig {
   lidarrMetadataProfileId  Int?
   lidarrMonitorMode        String?  @default("all")
   requestAutoApprove       Boolean  @default(true)
+  debugMode                Boolean  @default(false)
   createdAt                DateTime @default(now())
   updatedAt                DateTime @updatedAt
 }