@kuriyona/cecilia 1.0.0 → 2.0.0-beta.1

package/dist/elysia.mjs

@@ -0,0 +1,286 @@
+import { A as getArtistTopSongs, C as getArtist, D as getArtistList, E as getArtistDetail, F as getAlbumPrivileges, I as getAlbumProduct, L as getAlbumSaleBoard, M as getAlbum, N as getAlbumDynamic, O as getArtistMvs, P as getAlbumList, R as getNewestAlbums, S as getSongsDetail, T as getArtistDesc, _ as checkMusic, a as getHotSearches, b as getSimilarSongs, c as searchMultimatch, d as getPlaylistCategories, f as getPlaylistDetail, g as getTopPlaylists, h as getRelatedPlaylists, i as getHotSearchDetail, j as getArtistVideos, k as getArtistSongs, l as getHighQualityPlaylists, m as getPlaylistTracks, n as cloudSearch, o as getSearchSuggest, p as getPlaylistDetailDynamic, r as getDefaultSearchKeyword, s as search, u as getHighQualityTags, v as getLyric, w as getArtistAlbums, x as getSongUrl, y as getLyricNew } from "./src-_5V0pZj_.mjs";
+import { timingSafeEqual } from "node:crypto";
+import { cors } from "@elysiajs/cors";
+import { Elysia, t } from "elysia";
+//#region src/elysia/routes.ts
+/** 入站 Cookie 原样转发给上游，会员态由调用方自带。 */
+const optionsOf = (request) => {
+	const cookie = request.headers.get("cookie");
+	return cookie === null ? void 0 : { cookie };
+};
+/** 逗号分隔的数字 id 列表，`1,2,3`。 */
+const idListSchema = t.String({ pattern: "^[0-9]+(,[0-9]+)*$" });
+const idsOf = (value) => value.split(",").map(Number);
+const pagingSchema = {
+	limit: t.Optional(t.Numeric()),
+	offset: t.Optional(t.Numeric())
+};
+/** 与 src/types/search.ts 的 SearchType 保持同步。 */
+const SEARCH_TYPES = [
+	1,
+	10,
+	100,
+	1e3,
+	1002,
+	1004,
+	1006,
+	1009,
+	1014,
+	2e3
+];
+const searchTypeOf = (value) => value === void 0 ? void 0 : SEARCH_TYPES.find((candidate) => candidate === value);
+/** 白名单外的取值返回 undefined，由调用方回 400。 */
+const pickEnum = (value, allowed) => value === void 0 ? void 0 : allowed.find((candidate) => candidate === value);
+const invalidEnum = (field, allowed) => ({
+	code: 400,
+	message: `${field} 只支持 ${allowed.join(" / ")}`
+});
+const TOP_PLAYLIST_ORDERS = ["hot", "new"];
+const ARTIST_SONG_ORDERS = ["hot", "time"];
+const ALBUM_SALE_TYPES = [
+	"daily",
+	"week",
+	"year",
+	"total"
+];
+const ALBUM_TYPES = ["0", "1"];
+/** Query 里 `albumType` 是字符串，窄化回 0 | 1。 */
+const albumTypeOf = (value) => value === void 0 ? void 0 : value === "0" ? 0 : 1;
+const searchRoutes = (app) => app.get("/search", ({ query, request, set }) => {
+	const type = searchTypeOf(query.type);
+	if (query.type !== void 0 && type === void 0) {
+		set.status = 400;
+		return invalidEnum("type", SEARCH_TYPES);
+	}
+	return search({
+		keywords: query.keywords,
+		type,
+		limit: query.limit,
+		offset: query.offset
+	}, optionsOf(request));
+}, { query: t.Object({
+	keywords: t.String({ minLength: 1 }),
+	type: t.Optional(t.Numeric()),
+	...pagingSchema
+}) }).get("/cloudsearch", ({ query, request, set }) => {
+	const type = searchTypeOf(query.type);
+	if (query.type !== void 0 && type === void 0) {
+		set.status = 400;
+		return invalidEnum("type", SEARCH_TYPES);
+	}
+	return cloudSearch({
+		keywords: query.keywords,
+		type,
+		limit: query.limit,
+		offset: query.offset
+	}, optionsOf(request));
+}, { query: t.Object({
+	keywords: t.String({ minLength: 1 }),
+	type: t.Optional(t.Numeric()),
+	...pagingSchema
+}) }).get("/search/suggest", ({ query, request }) => getSearchSuggest({
+	keywords: query.keywords,
+	mobile: query.mobile
+}, optionsOf(request)), { query: t.Object({
+	keywords: t.Optional(t.String()),
+	mobile: t.Optional(t.BooleanString())
+}) }).get("/search/hot", ({ request }) => getHotSearches(optionsOf(request))).get("/search/hot/detail", ({ request }) => getHotSearchDetail(optionsOf(request))).get("/search/default-keyword", ({ request }) => getDefaultSearchKeyword(optionsOf(request))).get("/search/multimatch", ({ query, request, set }) => {
+	const type = searchTypeOf(query.type);
+	if (query.type !== void 0 && type === void 0) {
+		set.status = 400;
+		return invalidEnum("type", SEARCH_TYPES);
+	}
+	return searchMultimatch({
+		keywords: query.keywords,
+		type
+	}, optionsOf(request));
+}, { query: t.Object({
+	keywords: t.Optional(t.String()),
+	type: t.Optional(t.Numeric())
+}) });
+const songRoutes = (app) => app.get("/song/detail", ({ query, request }) => getSongsDetail(idsOf(query.ids), optionsOf(request)), { query: t.Object({ ids: idListSchema }) }).get("/song/url", ({ query, request }) => getSongUrl({
+	id: idsOf(query.id),
+	br: query.br
+}, optionsOf(request)), { query: t.Object({
+	id: idListSchema,
+	br: t.Optional(t.Numeric())
+}) }).get("/lyric", ({ query, request }) => getLyric(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/lyric/new", ({ query, request }) => getLyricNew(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/check/music", ({ query, request }) => checkMusic({
+	id: query.id,
+	br: query.br
+}, optionsOf(request)), { query: t.Object({
+	id: t.Numeric(),
+	br: t.Optional(t.Numeric())
+}) }).get("/simi/song", ({ query, request }) => getSimilarSongs(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) });
+const playlistRoutes = (app) => app.get("/playlist/detail", ({ query, request }) => getPlaylistDetail(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/playlist/track/all", ({ query, request }) => getPlaylistTracks({
+	id: query.id,
+	limit: query.limit,
+	offset: query.offset
+}, optionsOf(request)), { query: t.Object({
+	id: t.Numeric(),
+	...pagingSchema
+}) }).get("/playlist/detail/dynamic", ({ query, request }) => getPlaylistDetailDynamic(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/playlist/highquality/tags", ({ request }) => getHighQualityTags(optionsOf(request))).get("/playlist/top", ({ query, request, set }) => {
+	const order = pickEnum(query.order, TOP_PLAYLIST_ORDERS);
+	if (query.order !== void 0 && order === void 0) {
+		set.status = 400;
+		return invalidEnum("order", TOP_PLAYLIST_ORDERS);
+	}
+	return getTopPlaylists({
+		cat: query.cat,
+		order,
+		limit: query.limit,
+		offset: query.offset
+	}, optionsOf(request));
+}, { query: t.Object({
+	cat: t.Optional(t.String()),
+	order: t.Optional(t.String()),
+	...pagingSchema
+}) }).get("/playlist/highquality/list", ({ query, request }) => getHighQualityPlaylists({
+	cat: query.cat,
+	limit: query.limit,
+	before: query.before
+}, optionsOf(request)), { query: t.Object({
+	cat: t.Optional(t.String()),
+	limit: t.Optional(t.Numeric()),
+	before: t.Optional(t.Numeric())
+}) }).get("/playlist/catalogue", ({ request }) => getPlaylistCategories(optionsOf(request))).get("/playlist/related", ({ query, request }) => getRelatedPlaylists(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) });
+const artistRoutes = (app) => app.get("/artist", ({ query, request }) => getArtist(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/artist/detail", ({ query, request }) => getArtistDetail(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/artist/songs", ({ query, request, set }) => {
+	const order = pickEnum(query.order, ARTIST_SONG_ORDERS);
+	if (query.order !== void 0 && order === void 0) {
+		set.status = 400;
+		return invalidEnum("order", ARTIST_SONG_ORDERS);
+	}
+	return getArtistSongs({
+		id: query.id,
+		order,
+		limit: query.limit,
+		offset: query.offset
+	}, optionsOf(request));
+}, { query: t.Object({
+	id: t.Numeric(),
+	order: t.Optional(t.String()),
+	...pagingSchema
+}) }).get("/artist/top/song", ({ query, request }) => getArtistTopSongs(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/artist/album", ({ query, request }) => getArtistAlbums({
+	id: query.id,
+	limit: query.limit,
+	offset: query.offset
+}, optionsOf(request)), { query: t.Object({
+	id: t.Numeric(),
+	...pagingSchema
+}) }).get("/artist/list", ({ query, request }) => getArtistList({
+	area: query.area,
+	type: query.type,
+	initial: query.initial,
+	limit: query.limit,
+	offset: query.offset
+}, optionsOf(request)), { query: t.Object({
+	area: t.Optional(t.Numeric()),
+	type: t.Optional(t.Numeric()),
+	initial: t.Optional(t.String()),
+	...pagingSchema
+}) }).get("/artist/desc", ({ query, request }) => getArtistDesc(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/artist/mv", ({ query, request }) => getArtistMvs({
+	id: query.id,
+	limit: query.limit,
+	offset: query.offset
+}, optionsOf(request)), { query: t.Object({
+	id: t.Numeric(),
+	...pagingSchema
+}) }).get("/artist/video", ({ query, request }) => getArtistVideos({
+	id: query.id,
+	size: query.size,
+	cursor: query.cursor,
+	order: query.order
+}, optionsOf(request)), { query: t.Object({
+	id: t.Numeric(),
+	size: t.Optional(t.Numeric()),
+	cursor: t.Optional(t.Numeric()),
+	order: t.Optional(t.Numeric())
+}) });
+const albumRoutes = (app) => app.get("/album", ({ query, request }) => getAlbum(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/album/product", ({ query, request }) => getAlbumProduct(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/album/dynamic", ({ query, request }) => getAlbumDynamic(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/album/sale/board", ({ query, request, set }) => {
+	const albumType = pickEnum(query.albumType, ALBUM_TYPES);
+	if (query.albumType !== void 0 && albumType === void 0) {
+		set.status = 400;
+		return invalidEnum("albumType", ALBUM_TYPES);
+	}
+	const type = pickEnum(query.type, ALBUM_SALE_TYPES);
+	if (query.type !== void 0 && type === void 0) {
+		set.status = 400;
+		return invalidEnum("type", ALBUM_SALE_TYPES);
+	}
+	return getAlbumSaleBoard({
+		albumType: albumTypeOf(albumType),
+		type,
+		year: query.year
+	}, optionsOf(request));
+}, { query: t.Object({
+	albumType: t.Optional(t.String()),
+	type: t.Optional(t.String()),
+	year: t.Optional(t.Numeric())
+}) }).get("/album/privilege", ({ query, request }) => getAlbumPrivileges(query.id, optionsOf(request)), { query: t.Object({ id: t.Numeric() }) }).get("/album/list", ({ query, request }) => getAlbumList({
+	area: query.area,
+	type: query.type,
+	limit: query.limit,
+	offset: query.offset
+}, optionsOf(request)), { query: t.Object({
+	area: t.Optional(t.String()),
+	type: t.Optional(t.String()),
+	...pagingSchema
+}) }).get("/album/new", ({ request }) => getNewestAlbums(optionsOf(request)));
+/** 37 个函数各一条 GET 路由，按 搜索 / 歌曲 / 歌单 / 歌手 / 专辑 依次注册。 */
+const registerRoutes = (app) => albumRoutes(artistRoutes(playlistRoutes(songRoutes(searchRoutes(app)))));
+//#endregion
+//#region src/elysia/app.ts
+/** scheme 大小写不敏感，比较用 timingSafeEqual（长度不等直接 false）。 */
+const isAuthorized = (request, token) => {
+	const header = request.headers.get("authorization");
+	if (header === null) return false;
+	const [scheme, value, ...rest] = header.split(" ");
+	if (rest.length > 0 || scheme?.toLowerCase() !== "bearer" || value === void 0) return false;
+	const expected = Buffer.from(token, "utf8");
+	const actual = Buffer.from(value, "utf8");
+	return expected.length === actual.length && timingSafeEqual(expected, actual);
+};
+/** 中间件风格插件：挂在实例上后，后续注册的路由都要先过鉴权。 */
+const withAuth = (options) => (app) => app.onBeforeHandle(({ request, set }) => {
+	if (isAuthorized(request, options.token)) return;
+	set.status = 401;
+	return {
+		code: 401,
+		message: "Unauthorized"
+	};
+});
+/**
+* 把 37 个 Cecilia 函数各注册成一条 GET 路由，返回可直接 `.use()` 或 `.listen()` 的 Elysia 实例。
+* CORS 先注册（预检早于鉴权短路），再鉴权，最后才是路由。
+*/
+const createApp = (options) => {
+	let app = new Elysia();
+	if (options?.cors !== void 0) app = app.use(cors(options.cors));
+	if (options?.auth !== void 0) app = withAuth(options.auth)(app);
+	return registerRoutes(app);
+};
+//#endregion
+//#region src/elysia/server.ts
+const readPortEnv = () => {
+	const raw = process.env.PORT;
+	if (raw === void 0 || raw === "") return 3e3;
+	const port = Number(raw);
+	if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error(`PORT 环境变量非法: ${raw}`);
+	return port;
+};
+/** 同步返回：Bun 的 listen 是同步的，端口占用会同步抛出。 */
+const startServer = (options) => {
+	if (!("Bun" in globalThis)) throw new Error("@kuriyona/cecilia/elysia 的 startServer 需要 Bun 运行时（例如 bun run server.ts）；Node 下请用 createApp() 自备适配器。");
+	const port = options?.port ?? readPortEnv();
+	const host = options?.host ?? process.env.HOST ?? "127.0.0.1";
+	const app = createApp(options);
+	app.listen({
+		hostname: host,
+		port
+	});
+	return {
+		app,
+		url: app.server?.url.origin ?? `http://${host}:${port}`
+	};
+};
+//#endregion
+export { createApp, startServer };