feat: multiple improvements to library functionality (#50)

## Summary This PR implements several improvements to the library application: - Added start and finish date tracking for media items - Added "Retired" category for abandoned media - Implemented avatar-based user menu with dropdown navigation - Added automatic background token refresh to prevent session expiry - Created centralised logging system with frontend-to-API log forwarding - Added toast notifications for error handling ## Changes ### Media Tracking (#41) - Added `dateStarted` and `dateFinished` fields to Books, Games, Manga, Music, and Shows - Updated TypeScript types, Prisma schema, and API services - Added manual date input fields to frontend forms - Properly converts HTML date strings to Date objects before API submission ### Retired Category (#43) - Added `RETIRED` status to all media type enums - Updated Prisma schema, frontend dropdowns, and filter buttons - Added status label handling for retired items ### User Menu (#46) - Replaced username text with avatar image in header - Created dropdown menu with navigation items (Users, Audit, Suggestions) - Added logout button to menu - Implemented keyboard accessibility (tabindex, role, keyup handlers) ### Token Refresh (#44) - Implemented automatic token refresh every 13 minutes in background - Added proactive refresh to prevent token expiry during form filling - Prevents users from losing form data due to expired sessions ### Centralised Logging (#1) - Created `/log` endpoint on API to receive frontend logs - Replaced API console.log calls with @nhcarrigan/logger - Created ConsoleLoggerService to intercept all console methods on frontend - Added global error handlers (window.error, unhandledrejection) on frontend - Added process error handlers (uncaughtException, unhandledRejection, SIGTERM, SIGINT) on API - All frontend console activity now forwarded to centralised logging ### Error Handling - Created ToastService and ToastComponent for displaying errors - Integrated with GlobalErrorHandler and HTTP interceptor - Added accessibility features (keyboard navigation, ARIA attributes) - Set toast opacity to 40% for optimal readability ### Testing & Build - Fixed pre-existing test failure for GET / route (now returns version info) - Added ESM module mocking (jsdom, marked, dompurify, @nhcarrigan/logger) - Configured Jest with isolatedModules to handle TypeScript errors - Excluded test-setup.ts from production build - All tests passing (123 total) - Build passing with no errors ## Test Plan - [x] All tests pass (123 tests) - [x] Build passes without errors - [x] Lint passes (only pre-existing warnings) - [x] Date fields work correctly on all media types - [x] Retired status displays and filters properly - [x] Avatar menu opens/closes correctly with keyboard and mouse - [x] Token refresh prevents session expiry - [x] Toast notifications appear for errors - [x] Frontend logs forward to API successfully - [x] Root route returns version information Closes #41 Closes #43 Closes #44 Closes #46 Closes #1 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Hikari <hikari@nhcarrigan.com> Reviewed-on: #50 Co-authored-by: Naomi Carrigan <commits@nhcarrigan.com> Co-committed-by: Naomi Carrigan <commits@nhcarrigan.com>
2026-02-19 16:52:43 -08:00
parent 9caf74945a
commit 7579f1ec97
93 changed files with 4297 additions and 645 deletions
@@ -0,0 +1,127 @@
+/**
+ * @copyright 2026 NHCarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import { Injectable, inject } from '@angular/core';
+import { HttpClient } from '@angular/common/http';
+import { environment } from '../../environments/environment';
+
+interface LogPayload {
+  level: 'debug' | 'info' | 'warn' | 'error';
+  message: string;
+  context?: string;
+  error?: {
+    name: string;
+    message: string;
+    stack?: string;
+  };
+}
+
+@Injectable({
+  providedIn: 'root'
+})
+export class ConsoleLoggerService {
+  private http = inject(HttpClient);
+  private originalConsole = {
+    log: console.log.bind(console),
+    error: console.error.bind(console),
+    warn: console.warn.bind(console),
+    debug: console.debug.bind(console),
+    info: console.info.bind(console)
+  };
+
+  /**
+   * Initialises the console override to pipe logs to the API.
+   */
+  initialise(): void {
+    console.log = (...args: unknown[]) => {
+      this.originalConsole.log(...args);
+      this.sendLog('info', this.formatArgs(args));
+    };
+
+    console.info = (...args: unknown[]) => {
+      this.originalConsole.info(...args);
+      this.sendLog('info', this.formatArgs(args));
+    };
+
+    console.debug = (...args: unknown[]) => {
+      this.originalConsole.debug(...args);
+      this.sendLog('debug', this.formatArgs(args));
+    };
+
+    console.warn = (...args: unknown[]) => {
+      this.originalConsole.warn(...args);
+      this.sendLog('warn', this.formatArgs(args));
+    };
+
+    console.error = (...args: unknown[]) => {
+      this.originalConsole.error(...args);
+
+      // Check if the first argument is an Error object
+      if (args[0] instanceof Error) {
+        const error = args[0];
+        this.sendLog('error', error.message, 'Console', {
+          name: error.name,
+          message: error.message,
+          stack: error.stack
+        });
+      } else {
+        this.sendLog('error', this.formatArgs(args));
+      }
+    };
+
+    // Global error handlers
+    window.addEventListener('error', (event: ErrorEvent) => {
+      this.originalConsole.error('Uncaught Error:', event.error);
+      this.sendLog('error', event.message, 'Window Error', {
+        name: event.error?.name || 'Error',
+        message: event.message,
+        stack: event.error?.stack
+      });
+    });
+
+    window.addEventListener('unhandledrejection', (event: PromiseRejectionEvent) => {
+      this.originalConsole.error('Unhandled Promise Rejection:', event.reason);
+
+      const error = event.reason instanceof Error ? event.reason : new Error(String(event.reason));
+      this.sendLog('error', error.message, 'Unhandled Rejection', {
+        name: error.name,
+        message: error.message,
+        stack: error.stack
+      });
+    });
+  }
+
+  private formatArgs(args: unknown[]): string {
+    return args.map(arg => {
+      if (typeof arg === 'string') {
+        return arg;
+      }
+      if (arg instanceof Error) {
+        return `${arg.name}: ${arg.message}`;
+      }
+      try {
+        return JSON.stringify(arg);
+      } catch {
+        return String(arg);
+      }
+    }).join(' ');
+  }
+
+  private sendLog(level: LogPayload['level'], message: string, context?: string, error?: LogPayload['error']): void {
+    const payload: LogPayload = {
+      level,
+      message,
+      context,
+      error
+    };
+
+    this.http.post(`${environment.apiUrl}/log`, payload).subscribe({
+      error: (err) => {
+        this.originalConsole.error('Failed to send log to API:', err);
+      }
+    });
+  }
+}