@kuriyona/cecilia 0.2.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 };

package/dist/index.cjs

@@ -2,89 +2,44 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-//#region src/utils/mergeLyricTimelines.ts
-function mergeLyricTimelines(original, translation) {
-	const originalMap = /* @__PURE__ */ new Map();
-	for (const item of original) originalMap.set(item.time, item.text);
-	const translationMap = /* @__PURE__ */ new Map();
-	for (const item of translation) translationMap.set(item.time, item.text);
-	const allTimes = /* @__PURE__ */ new Set();
-	for (const item of original) allTimes.add(item.time);
-	for (const item of translation) allTimes.add(item.time);
-	const sortedTimes = [...allTimes].sort((a, b) => a - b);
-	const result = [];
-	let lastOriginal;
-	let lastTranslation;
-	for (const time of sortedTimes) {
-		if (originalMap.has(time)) lastOriginal = originalMap.get(time);
-		if (translationMap.has(time)) lastTranslation = translationMap.get(time);
-		result.push({
-			time,
-			text: lastOriginal ?? "",
-			...lastTranslation !== void 0 ? { translation: lastTranslation } : {}
-		});
-	}
-	return result;
-}
-//#endregion
-//#region src/index.ts
-const BASE_URL = "https://music.163.com/api/";
-const getPlaylistDetail = async (id) => {
-	const data = await (await fetch(`${BASE_URL}/v6/playlist/detail?id=${id}`)).json();
-	return {
-		id: data.playlist.id,
-		name: data.playlist.name,
-		coverImgId: data.playlist.coverImgId,
-		coverImgUrl: data.playlist.coverImgUrl,
-		userId: data.playlist.userId,
-		createTime: data.playlist.createTime,
-		songs: data.playlist.trackIds.map((t) => ({
-			id: t.id,
-			addTime: t.at
-		}))
-	};
-};
-const parseLrc = (lrc) => lrc.split("\n").filter((l) => l.startsWith("[")).map((l) => {
-	const match = l.match(/^\[(\d{2}):(\d{2}(?:\.\d{2,3})?)\](.*)/);
-	if (!match) return null;
-	const minutes = parseInt(match[1], 10);
-	const seconds = parseFloat(match[2]);
-	return {
-		time: minutes * 60 + seconds,
-		text: match[3].trim()
-	};
-}).filter((e) => e !== null);
-const getLyric = async (id) => {
-	const data = await (await fetch(`${BASE_URL}/song/lyric?id=${id}&lv=-1&tv=-1`)).json();
-	return {
-		lines: mergeLyricTimelines(parseLrc(data.lrc.lyric), data.tlyric?.lyric ? parseLrc(data.tlyric.lyric) : []),
-		...data.transUser ? { translator: data.transUser } : {}
-	};
-};
-const getSongsDetail = async (ids) => {
-	const query = JSON.stringify(ids.map((id) => ({ id })));
-	return (await (await fetch(`${BASE_URL}/v3/song/detail?c=${query}`)).json()).songs.map((s) => ({
-		id: s.id,
-		name: s.name,
-		artists: s.ar.map((a) => ({
-			id: a.id,
-			name: a.name
-		})),
-		album: {
-			id: s.al.id,
-			name: s.al.name,
-			picUrl: s.al.picUrl
-		},
-		duration: s.dt
-	}));
-};
-var src_default = {
-	getPlaylistDetail,
-	getLyric,
-	getSongsDetail
-};
-//#endregion
-exports.default = src_default;
-exports.getLyric = getLyric;
-exports.getPlaylistDetail = getPlaylistDetail;
-exports.getSongsDetail = getSongsDetail;
+const require_src = require("./src-BoyQdkLi.cjs");
+exports.NeteaseApiError = require_src.NeteaseApiError;
+exports.checkMusic = require_src.checkMusic;
+exports.cloudSearch = require_src.cloudSearch;
+exports.default = require_src.src_default;
+exports.getAlbum = require_src.getAlbum;
+exports.getAlbumDynamic = require_src.getAlbumDynamic;
+exports.getAlbumList = require_src.getAlbumList;
+exports.getAlbumPrivileges = require_src.getAlbumPrivileges;
+exports.getAlbumProduct = require_src.getAlbumProduct;
+exports.getAlbumSaleBoard = require_src.getAlbumSaleBoard;
+exports.getArtist = require_src.getArtist;
+exports.getArtistAlbums = require_src.getArtistAlbums;
+exports.getArtistDesc = require_src.getArtistDesc;
+exports.getArtistDetail = require_src.getArtistDetail;
+exports.getArtistList = require_src.getArtistList;
+exports.getArtistMvs = require_src.getArtistMvs;
+exports.getArtistSongs = require_src.getArtistSongs;
+exports.getArtistTopSongs = require_src.getArtistTopSongs;
+exports.getArtistVideos = require_src.getArtistVideos;
+exports.getDefaultSearchKeyword = require_src.getDefaultSearchKeyword;
+exports.getHighQualityPlaylists = require_src.getHighQualityPlaylists;
+exports.getHighQualityTags = require_src.getHighQualityTags;
+exports.getHotSearchDetail = require_src.getHotSearchDetail;
+exports.getHotSearches = require_src.getHotSearches;
+exports.getLyric = require_src.getLyric;
+exports.getLyricNew = require_src.getLyricNew;
+exports.getNewestAlbums = require_src.getNewestAlbums;
+exports.getPlaylistCategories = require_src.getPlaylistCategories;
+exports.getPlaylistDetail = require_src.getPlaylistDetail;
+exports.getPlaylistDetailDynamic = require_src.getPlaylistDetailDynamic;
+exports.getPlaylistTracks = require_src.getPlaylistTracks;
+exports.getRelatedPlaylists = require_src.getRelatedPlaylists;
+exports.getSearchSuggest = require_src.getSearchSuggest;
+exports.getSimilarSongs = require_src.getSimilarSongs;
+exports.getSongUrl = require_src.getSongUrl;
+exports.getSongsDetail = require_src.getSongsDetail;
+exports.getTopPlaylists = require_src.getTopPlaylists;
+exports.request = require_src.request;
+exports.search = require_src.search;
+exports.searchMultimatch = require_src.searchMultimatch;