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>

shared-types/test/manga.types.spec.ts

@@ -0,0 +1,173 @@
+/**
+ * @copyright NHCarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import { MangaStatus } from "../src/lib/manga.types";
+import type { Manga, CreateMangaDto, UpdateMangaDto } from "../src/lib/manga.types";
+
+describe("manga Types", () => {
+  describe("mangaStatus enum", () => {
+    it("should have the correct values", () => {
+      expect(MangaStatus.reading).toBe("READING");
+      expect(MangaStatus.completed).toBe("COMPLETED");
+      expect(MangaStatus.wantToRead).toBe("WANT_TO_READ");
+    });
+
+    it("should have all expected enum values", () => {
+      const values = Object.values(MangaStatus);
+      expect(values).toHaveLength(4);
+      expect(values).toContain("READING");
+      expect(values).toContain("COMPLETED");
+      expect(values).toContain("WANT_TO_READ");
+      expect(values).toContain("RETIRED");
+    });
+  });
+
+  describe("manga interface", () => {
+    it("should accept valid manga object with minimal fields", () => {
+      const manga: Manga = {
+        author:    "Tsugumi Ohba",
+        createdAt: new Date("2024-01-15"),
+        dateAdded: new Date("2024-01-15"),
+        id:        "manga123",
+        links:     [],
+        status:    MangaStatus.reading,
+        tags:      [],
+        title:     "Death Note",
+        updatedAt: new Date("2024-01-16"),
+      };
+
+      expect(manga.dateCompleted).toBeUndefined();
+      expect(manga.rating).toBeUndefined();
+      expect(manga.notes).toBeUndefined();
+      expect(manga.coverImage).toBeUndefined();
+    });
+
+    it("should accept valid manga object with all fields", () => {
+      const fullManga: Manga = {
+        author:        "Eiichiro Oda",
+        coverImage:    "https://example.com/onepiece-cover.jpg",
+        createdAt:     new Date("2024-01-01"),
+        dateAdded:     new Date("2024-01-01"),
+        dateCompleted: undefined,
+        id:            "manga456",
+        links:         [
+          { title: "MyAnimeList", url: "https://myanimelist.net/manga/13" },
+          { title: "Official Site", url: "https://one-piece.com" },
+        ],
+
+        notes: "Epic adventure that keeps getting better",
+
+        // Still ongoing
+        rating: 5,
+
+        status: MangaStatus.reading,
+
+        tags:      [ "adventure", "shounen", "pirates", "long-running" ],
+        title:     "One Piece",
+        updatedAt: new Date("2024-02-01"),
+      };
+
+      expect(fullManga.author).toBe("Eiichiro Oda");
+      expect(fullManga.rating).toBe(5);
+      expect(fullManga.tags).toHaveLength(4);
+      expect(fullManga.links).toHaveLength(2);
+    });
+
+    it("should accept completed manga", () => {
+      const completedManga: Manga = {
+        author:        "Hiromu Arakawa",
+        coverImage:    "https://example.com/fma-cover.jpg",
+        createdAt:     new Date("2023-12-01"),
+        dateAdded:     new Date("2023-12-01"),
+        dateCompleted: new Date("2024-01-30"),
+        id:            "manga789",
+        links:         [],
+        notes:         "Perfect from start to finish",
+        rating:        5,
+        status:        MangaStatus.completed,
+        tags:          [ "shounen", "adventure", "alchemy" ],
+        title:         "Fullmetal Alchemist",
+        updatedAt:     new Date("2024-01-30"),
+      };
+
+      expect(completedManga.status).toBe(MangaStatus.completed);
+      expect(completedManga.dateCompleted).toEqual(new Date("2024-01-30"));
+    });
+  });
+
+  describe("createMangaDto interface", () => {
+    it("should accept DTO with required fields only", () => {
+      const createDto: CreateMangaDto = {
+        author: "Hajime Isayama",
+        status: MangaStatus.wantToRead,
+        title:  "Attack on Titan",
+      };
+
+      expect(createDto.rating).toBeUndefined();
+      expect(createDto.notes).toBeUndefined();
+      expect(createDto.coverImage).toBeUndefined();
+      expect(createDto.tags).toBeUndefined();
+      expect(createDto.links).toBeUndefined();
+    });
+
+    it("should accept DTO with all fields", () => {
+      const fullCreateDto: CreateMangaDto = {
+        author:     "Kohei Horikoshi",
+        coverImage: "https://example.com/mha-cover.jpg",
+        links:      [ { title: "Wiki", url: "https://mha.wiki" } ],
+        notes:      "Great superhero manga with unique powers",
+        rating:     4,
+        status:     MangaStatus.reading,
+        tags:       [ "shounen", "superhero", "school" ],
+        title:      "My Hero Academia",
+      };
+
+      expect(fullCreateDto.author).toBe("Kohei Horikoshi");
+      expect(fullCreateDto.rating).toBe(4);
+      expect(fullCreateDto.tags).toEqual([ "shounen", "superhero", "school" ]);
+      expect(fullCreateDto.links).toHaveLength(1);
+    });
+  });
+
+  describe("updateMangaDto type", () => {
+    it("should accept empty update DTO", () => {
+      const emptyUpdate: UpdateMangaDto = {};
+      expect(emptyUpdate).toEqual({});
+    });
+
+    it("should accept partial updates including dateCompleted", () => {
+      const partialUpdate: UpdateMangaDto = {
+        dateCompleted: new Date("2024-02-10"),
+        rating:        4,
+        status:        MangaStatus.completed,
+      };
+
+      expect(partialUpdate.status).toBe(MangaStatus.completed);
+      expect(partialUpdate.dateCompleted).toEqual(new Date("2024-02-10"));
+      expect(partialUpdate.rating).toBe(4);
+      expect(partialUpdate.title).toBeUndefined();
+    });
+
+    it("should accept full update", () => {
+      const fullUpdate: UpdateMangaDto = {
+        author:        "Different Author",
+        coverImage:    "https://example.com/new-manga-cover.jpg",
+        dateCompleted: new Date("2024-02-15"),
+        links:         [ { title: "New Link", url: "https://newlink.com" } ],
+        notes:         "Updated after finishing the series",
+        rating:        3,
+        status:        MangaStatus.completed,
+        tags:          [ "updated", "tags" ],
+        title:         "Updated Manga Title",
+      };
+
+      expect(fullUpdate.title).toBe("Updated Manga Title");
+      expect(fullUpdate.author).toBe("Different Author");
+      expect(fullUpdate.dateCompleted).toEqual(new Date("2024-02-15"));
+      expect(fullUpdate.links).toHaveLength(1);
+    });
+  });
+});