feat: add web backend — Express REST API, WebSocket, full wiring in entry point

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

src/web/api/music.ts

@@ -0,0 +1,90 @@
+import { Router } from "express";
+import type { MusicProvider } from "../../music/provider.js";
+import type { Logger } from "../../logger.js";
+
+export function createMusicRouter(
+  neteaseProvider: MusicProvider,
+  qqProvider: MusicProvider,
+  logger: Logger
+): Router {
+  const router = Router();
+
+  function getProvider(platform?: string): MusicProvider {
+    return platform === "qq" ? qqProvider : neteaseProvider;
+  }
+
+  router.get("/search", async (req, res) => {
+    try {
+      const { q, platform, limit } = req.query;
+      if (!q) {
+        res.status(400).json({ error: "q (query) is required" });
+        return;
+      }
+      const provider = getProvider(platform as string);
+      const result = await provider.search(
+        q as string,
+        parseInt(limit as string) || 20
+      );
+      res.json(result);
+    } catch (err) {
+      logger.error({ err }, "Search failed");
+      res.status(500).json({ error: (err as Error).message });
+    }
+  });
+
+  router.get("/song/:id", async (req, res) => {
+    try {
+      const provider = getProvider(req.query.platform as string);
+      const song = await provider.getSongDetail(req.params.id);
+      if (!song) {
+        res.status(404).json({ error: "Song not found" });
+        return;
+      }
+      res.json(song);
+    } catch (err) {
+      res.status(500).json({ error: (err as Error).message });
+    }
+  });
+
+  router.get("/playlist/:id", async (req, res) => {
+    try {
+      const provider = getProvider(req.query.platform as string);
+      const songs = await provider.getPlaylistSongs(req.params.id);
+      res.json({ songs });
+    } catch (err) {
+      res.status(500).json({ error: (err as Error).message });
+    }
+  });
+
+  router.get("/recommend/playlists", async (req, res) => {
+    try {
+      const provider = getProvider(req.query.platform as string);
+      const playlists = await provider.getRecommendPlaylists();
+      res.json({ playlists });
+    } catch (err) {
+      res.status(500).json({ error: (err as Error).message });
+    }
+  });
+
+  router.get("/album/:id", async (req, res) => {
+    try {
+      const provider = getProvider(req.query.platform as string);
+      const songs = await provider.getAlbumSongs(req.params.id);
+      res.json({ songs });
+    } catch (err) {
+      res.status(500).json({ error: (err as Error).message });
+    }
+  });
+
+  router.get("/lyrics/:id", async (req, res) => {
+    try {
+      const provider = getProvider(req.query.platform as string);
+      const lyrics = await provider.getLyrics(req.params.id);
+      res.json({ lyrics });
+    } catch (err) {
+      res.status(500).json({ error: (err as Error).message });
+    }
+  });
+
+  return router;
+}