lxns-rhythm-api 0.1.0

package/README.md

@@ -0,0 +1,105 @@
+# lxns-sdk
+
+一个用于访问 Lxns API 的轻量 TypeScript SDK。
+
+- 零运行时依赖（仅使用 `ky` 发起请求）。
+- 类型安全：根据传入的 token 自动在 `maimai` 命名空间上暴露 `public` / `dev` / `personal` 子 API。
+- 现代构建（ESM/CJS/类型声明）。
+
+## 安装
+
+```bash
+# npm
+npm i lxns-sdk
+
+# pnpm
+pnpm add lxns-sdk
+
+# yarn
+yarn add lxns-sdk
+```
+
+## 快速开始
+
+```ts
+import { LxnsApiClient } from "lxns-sdk";
+
+// 无 token：仅可用 public API
+const client = new LxnsApiClient();
+const song = await client.maimai.public.getSong(114);
+console.log(song.standard?.master);
+
+// 开发者 API：传入 devAccessToken 后可用 maimai.dev
+const devClient = new LxnsApiClient({
+  devAccessToken: "<your-dev-token>",
+});
+const player = await devClient.maimai.dev.getPlayerByQQ(1507524536);
+console.log(player);
+
+// 个人 API：传入 personalAccessToken 后可用 maimai.personal
+const personalClient = new LxnsApiClient({
+  personalAccessToken: "<your-personal-token>",
+});
+const me = await personalClient.maimai.personal.getPlayer();
+console.log(me);
+```
+
+CommonJS 引用：
+
+```js
+const { LxnsApiClient } = require("lxns-sdk");
+```
+
+## 配置项
+
+构造函数签名：
+
+```ts
+new LxnsApiClient(options?: {
+  personalAccessToken?: string;
+  devAccessToken?: string;
+  baseURL?: string; // 默认：https://maimai.lxns.net/api/v0/
+});
+```
+
+- 当提供 `devAccessToken` 时：
+  - SDK 会在 `maimai.dev` 命名空间下启用开发者接口。
+  - 认证头：`Authorization: <devAccessToken>`。
+  - 基础路径：`<baseURL>/maimai/`。
+- 当提供 `personalAccessToken` 时：
+  - SDK 会在 `maimai.personal` 命名空间下启用个人接口。
+  - 认证头：`X-User-Token: <personalAccessToken>`。
+  - 基础路径：`<baseURL>/user/maimai/`。
+- `public` 始终可用：
+  - 基础路径：`<baseURL>/maimai/`。
+
+> 注意：`baseURL` 默认值为 `https://maimai.lxns.net/api/v0/`。
+
+## API 概览
+
+- `maimai.public`
+  - `getSongList(version?: number, notes?: boolean)`
+  - `getSong(id: number)`
+  - `getAliasList()`
+  - `getCollectionList(type, options)` 等
+- `maimai.dev`（需 `devAccessToken`）
+  - `getPlayer(friendCode)`、`getPlayerByQQ(qq)`、`getBests(...)` 等
+- `maimai.personal`（需 `personalAccessToken`）
+  - `getPlayer()`、`getScores()`、`postScores(scores)` 等
+
+详细定义请参见源码：
+
+- `src/apis/maimai/public.ts`
+- `src/apis/maimai/dev.ts`
+- `src/apis/maimai/personal.ts`
+
+## 构建与测试
+
+```bash
+pnpm run build
+pnpm run test
+```
+
+## 许可
+
+MIT

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var v=Object.create;var o=Object.defineProperty;var P=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var j=Object.getPrototypeOf,R=Object.prototype.hasOwnProperty;var h=(r,e)=>{for(var t in e)o(r,t,{get:e[t],enumerable:!0})},x=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of T(e))!R.call(r,i)&&i!==t&&o(r,i,{get:()=>e[i],enumerable:!(n=P(e,i))||n.enumerable});return r};var C=(r,e,t)=>(t=r!=null?v(j(r)):{},x(e||!r||!r.__esModule?o(t,"default",{value:r,enumerable:!0}):t,r)),A=r=>x(o({},"__esModule",{value:!0}),r);var L={};h(L,{LxnsApiClient:()=>d,MaimaiModels:()=>y});module.exports=A(L);var y={};h(y,{LevelIndex:()=>S});var S=(s=>(s[s.BASIC=0]="BASIC",s[s.ADVANCED=1]="ADVANCED",s[s.EXPERT=2]="EXPERT",s[s.MASTER=3]="MASTER",s[s.RE_MASTER=4]="RE_MASTER",s))(S||{});var u=C(require("ky"),1);var D=["basic","advanced","expert","master","remaster"];function g(r){return r.reduce((e,t)=>(e[D[t.difficulty]]=t,e),{})}var a=class{id;title;artist;genre;version;bpm;difficulties;locked;disabled;rights;constructor(e){this.id=e.id,this.title=e.title,this.artist=e.artist,this.genre=e.genre,this.version=e.version,this.bpm=e.bpm,this.difficulties=e.difficulties,this.locked=e.locked??!1,this.disabled=e.disabled??!1,this.rights=e.rights}get standard(){return this.difficulties.standard.length===0?null:g(this.difficulties.standard)}get dx(){return this.difficulties.dx.length===0?null:g(this.difficulties.dx)}get utage(){return this.difficulties.utage?g(this.difficulties.utage):null}};var l=class{constructor(e){this.http=e}async getSongList(e,t){return this.http.get("song/list?",{searchParams:{version:e,notes:t}}).json()}async getSong(e){let t=await this.http.get(`song/${e}`).json();return new a(t)}async getAliasList(){return this.http.get("alias/list").json()}async getCollectionList(e,t){let n={trophy:"trophies",icon:"icons",plate:"plates",frame:"frames"};return this.http.get(`${e}/list`,{searchParams:{...t}}).json().then(i=>i[n[e]])}async getCollectionInfo(e,t,n){return this.http.get(`${e}/${t}`,{searchParams:{...n}}).json()}async getCollectionGenreList(e){return this.http.get("collection-genre/list",{searchParams:{...e}}).json()}async getCollectionGenreInfo(e,t){return this.http.get(`collection-genre/${e}`,{searchParams:{...t}}).json()}};var c=class{constructor(e){this.http=e}async postPlayer(e){return this.http.post("player",{json:e}).json()}async getPlayer(e){return this.http.get(`player/${e}`).json()}async getPlayerByQQ(e){return this.http.get(`player/qq/${e}`).json()}async getBests(e){return this.http.get(`player/${e}/bests`).json()}async getApBests(e){return this.http.get(`player/${e}/bests/ap`).json()}async getRecents(e){return this.http.get(`player/${e}/recents`).json()}async getAllBestScores(e){return this.http.get(`player/${e}/scores`).json()}async getHeatmap(e){return this.http.get(`player/${e}/heatmap`).json()}async getTrend(e){return this.http.get(`player/${e}/trend`).json()}async getScoreHistory(e){return this.http.get(`player/${e}/score/history`).json()}async getCollectionProgress(e,t,n){return this.http.get(`player/${e}/${t}/${n}`).json()}async postScores(e,t){let n={scores:t};return this.http.post(`player/${e}/scores`,{json:n}).json()}async postHtml(e,t){return this.http.post(`player/${e}/html`,{body:t,headers:{"content-type":"text/plain"}}).json()}};var p=class{constructor(e){this.http=e}async getPlayer(){return this.http.get("player").json()}async getScores(){return this.http.get("scores").json()}async postScores(e){let t={scores:e};return this.http.post("scores",{json:t}).json()}};var d=class{config={baseURL:"https://maimai.lxns.net/api/v0/"};maimai;constructor(e){this.config={baseURL:e?.baseURL??this.config.baseURL,personalAccessToken:e?.personalAccessToken,devAccessToken:e?.devAccessToken};let{baseURL:t,devAccessToken:n,personalAccessToken:i}=this.config,s=u.default.create({prefixUrl:new URL("maimai/",t)}),f=n?u.default.create({prefixUrl:new URL("maimai/",t),headers:{Authorization:n}}):void 0,b=i?u.default.create({prefixUrl:new URL("user/maimai/",t),headers:{"X-User-Token":i}}):void 0,m={public:new l(s)};f&&(m.dev=new c(f)),b&&(m.personal=new p(b)),this.maimai=m}};0&&(module.exports={LxnsApiClient,MaimaiModels});

package/dist/index.d.ts

@@ -0,0 +1,540 @@
+import { KyInstance } from 'ky';
+
+interface Notes {
+    total: number;
+    tap: number;
+    hold: number;
+    slide: number;
+    touch: number;
+    break: number;
+}
+type SongType = "standard" | "dx" | "utage";
+declare enum LevelIndex {
+    BASIC = 0,
+    ADVANCED = 1,
+    EXPERT = 2,
+    MASTER = 3,
+    RE_MASTER = 4
+}
+interface SongDifficulty {
+    /** 类型 */
+    type: SongType;
+    /** 难度 */
+    difficulty: LevelIndex;
+    /** 等级 */
+    level: string;
+    /** 等级值 */
+    level_value: number;
+    /** 谱师 */
+    note_designer: string;
+    /** 版本 */
+    version: number;
+    /** 乐谱 */
+    notes?: Notes;
+}
+interface BuddyNotes {
+    /** 1P 谱面物量 */
+    left: Notes;
+    /** 2P 谱面物量 */
+    right: Notes;
+}
+interface SongDifficultyUtage {
+    /** 谱面属性（汉字） */
+    kanji: string;
+    /** 谱面描述 */
+    description: string;
+    /** 是否为 BUDDY 谱面 */
+    is_buddy: boolean;
+    /** 谱面物量（BUDDY 时为 BuddyNotes） */
+    notes?: Notes | BuddyNotes;
+    /** 以下与 SongDifficulty 相同 */
+    type: SongType;
+    difficulty: LevelIndex;
+    level: string;
+    level_value: number;
+    note_designer: string;
+    version: number;
+}
+interface SongDifficulties {
+    /** 标准 */
+    standard: SongDifficulty[] | [];
+    /** DX */
+    dx: SongDifficulty[] | [];
+    /** 宴会场 */
+    utage?: SongDifficultyUtage[];
+}
+interface Song$1 {
+    /** 歌曲 ID */
+    id: number;
+    /** 歌曲名称 */
+    title: string;
+    /** 歌手 */
+    artist: string;
+    /** 流派 */
+    genre: string;
+    /** BPM */
+    bpm: number;
+    /** 地图 */
+    map?: string;
+    /** 版本 */
+    version: number;
+    /** 权限 */
+    rights?: string;
+    /** 禁用 */
+    disabled?: boolean;
+    /** 难度 */
+    difficulties: SongDifficulties;
+    /** 锁定 */
+    locked?: boolean;
+}
+interface Genre {
+    /** ID */
+    id: number;
+    /** 标题 */
+    title: string;
+    /** 流派 */
+    genre: string;
+}
+interface Version {
+    /** ID */
+    id: number;
+    /** 标题 */
+    title: string;
+    /** 主要版本 ID */
+    version: number;
+}
+interface Alias {
+    /** 歌曲 ID */
+    song_id: number;
+    /** 别名 */
+    aliases: string[] | [];
+}
+interface Player {
+    /** 游戏内名称 */
+    name: string;
+    /** 玩家 DX Rating */
+    rating: number;
+    /** 好友码 */
+    friend_code: number;
+    /** 段位 ID */
+    course_rank: number;
+    /** 阶级 ID */
+    class_rank: number;
+    /** 搭档觉醒数 */
+    star: number;
+    /** 称号（仅上传时可空） */
+    trophy?: Trophy;
+    /** 头像 */
+    icon?: Icon;
+    /** 姓名框 */
+    name_plate?: NamePlate;
+    /** 背景 */
+    frame?: Frame;
+    /** 玩家被同步时的 UTC 时间（仅获取时返回） */
+    upload_time?: string;
+}
+interface Collection {
+    /** 收藏品 ID */
+    id: number;
+    /** 收藏品名称 */
+    name: string;
+    /** 称号颜色（仅玩家称号） */
+    color?: string;
+    /** 收藏品说明 */
+    description?: string;
+    /** 收藏品分类（日文，称号外） */
+    genre?: string;
+    /** 收藏品要求 */
+    required?: CollectionRequired[];
+}
+interface CollectionRequired {
+    /** 要求的谱面难度，长度为 0 时代表任意难度 */
+    difficulties?: LevelIndex[];
+    /** 要求的评级类型 */
+    rate?: RateType;
+    /** 要求的 FULL COMBO 类型 */
+    fc?: FCType;
+    /** 要求的 FULL SYNC 类型 */
+    fs?: FSType;
+    /** 要求的曲目列表 */
+    songs?: CollectionRequiredSong[];
+    /** 要求是否全部完成 */
+    completed?: boolean;
+}
+interface CollectionRequiredSong {
+    /** 曲目 ID */
+    id: number;
+    /** 曲名 */
+    title: string;
+    /** 谱面类型 */
+    type: SongType;
+    /** 要求的曲目是否完成 */
+    completed?: boolean;
+    /** 已完成的难度 */
+    completed_difficulties?: LevelIndex[];
+}
+interface CollectionGenre {
+    /** 收藏品分类 ID */
+    id: number;
+    /** 分类标题 */
+    title: string;
+    /** 分类标题（日文） */
+    genre: string;
+}
+type FCType = "app" | "ap" | "fcp" | "fc";
+type FSType = "fsdp" | "fsd" | "fsp" | "fs" | "sync";
+type RateType = "sssp" | "sss" | "ssp" | "ss" | "sp" | "s" | "aaa" | "aa" | "a" | "bbb" | "bb" | "b" | "c" | "d";
+interface Score {
+    /** 曲目 ID */
+    id: number;
+    /** 曲名（仅获取时返回） */
+    song_name?: string;
+    /** 难度标级，如 14+（仅获取时返回） */
+    level?: string;
+    /** 难度 */
+    level_index: LevelIndex;
+    /** 达成率 */
+    achievements: number;
+    /** FULL COMBO 类型 */
+    fc?: FCType | null;
+    /** FULL SYNC 类型 */
+    fs?: FSType | null;
+    /** DX 分数 */
+    dx_score: number;
+    /** DX 星级，最大值为 5 */
+    dx_star?: number;
+    /** DX Rating（仅获取时返回，计算需向下取整） */
+    dx_rating?: number;
+    /** 评级类型（仅获取时返回） */
+    rate?: RateType;
+    /** 谱面类型 */
+    type: SongType;
+    /** 游玩的 UTC 时间，精确到分钟 */
+    play_time?: string;
+    /** 成绩被同步时的 UTC 时间（仅获取时返回） */
+    upload_time?: string;
+    /** 谱面最后游玩的 UTC 时间（仅获取成绩列表、获取最佳成绩时返回） */
+    last_played_time?: string;
+}
+interface SimpleScore {
+    /** 曲目 ID */
+    id: number;
+    /** 曲名 */
+    song_name: string;
+    /** 难度标级，如 14+ */
+    level: string;
+    /** 难度 */
+    level_index: LevelIndex;
+    /** FULL COMBO 类型 */
+    fc?: FCType | null;
+    /** FULL SYNC 类型 */
+    fs?: FSType | null;
+    /** 评级类型 */
+    rate: RateType;
+    /** 谱面类型 */
+    type: SongType;
+}
+interface RatingTrend {
+    /** 总 DX Rating */
+    total: number;
+    /** 旧版本谱面总 DX Rating */
+    standard: number;
+    /** 现版本谱面总 DX Rating */
+    dx: number;
+    /** 日期 */
+    date: string;
+}
+interface Trophy extends Collection {
+}
+interface Icon extends Collection {
+}
+interface NamePlate extends Collection {
+}
+interface Frame extends Collection {
+}
+
+type models_Alias = Alias;
+type models_BuddyNotes = BuddyNotes;
+type models_Collection = Collection;
+type models_CollectionGenre = CollectionGenre;
+type models_CollectionRequired = CollectionRequired;
+type models_CollectionRequiredSong = CollectionRequiredSong;
+type models_FCType = FCType;
+type models_FSType = FSType;
+type models_Frame = Frame;
+type models_Genre = Genre;
+type models_Icon = Icon;
+type models_LevelIndex = LevelIndex;
+declare const models_LevelIndex: typeof LevelIndex;
+type models_NamePlate = NamePlate;
+type models_Notes = Notes;
+type models_Player = Player;
+type models_RateType = RateType;
+type models_RatingTrend = RatingTrend;
+type models_Score = Score;
+type models_SimpleScore = SimpleScore;
+type models_SongDifficulties = SongDifficulties;
+type models_SongDifficulty = SongDifficulty;
+type models_SongDifficultyUtage = SongDifficultyUtage;
+type models_SongType = SongType;
+type models_Trophy = Trophy;
+type models_Version = Version;
+declare namespace models {
+  export { type models_Alias as Alias, type models_BuddyNotes as BuddyNotes, type models_Collection as Collection, type models_CollectionGenre as CollectionGenre, type models_CollectionRequired as CollectionRequired, type models_CollectionRequiredSong as CollectionRequiredSong, type models_FCType as FCType, type models_FSType as FSType, type models_Frame as Frame, type models_Genre as Genre, type models_Icon as Icon, models_LevelIndex as LevelIndex, type models_NamePlate as NamePlate, type models_Notes as Notes, type models_Player as Player, type models_RateType as RateType, type models_RatingTrend as RatingTrend, type models_Score as Score, type models_SimpleScore as SimpleScore, type Song$1 as Song, type models_SongDifficulties as SongDifficulties, type models_SongDifficulty as SongDifficulty, type models_SongDifficultyUtage as SongDifficultyUtage, type models_SongType as SongType, type models_Trophy as Trophy, type models_Version as Version };
+}
+
+interface SongList {
+    songs: Song$1[];
+    genres: Genre[];
+    versions: Version[];
+}
+interface AliasList {
+    aliases: Alias[];
+}
+interface CollectionGenreList {
+    collectionGenres: CollectionGenre[];
+}
+
+declare class Song implements Song$1 {
+    readonly id: Song$1["id"];
+    readonly title: Song$1["title"];
+    readonly artist: Song$1["artist"];
+    readonly genre: Song$1["genre"];
+    readonly version: Song$1["version"];
+    readonly bpm: Song$1["bpm"];
+    readonly difficulties: Song$1["difficulties"];
+    readonly locked: boolean;
+    readonly disabled: boolean;
+    readonly rights: Song$1["rights"];
+    constructor(song: Song$1);
+    get standard(): Record<"basic" | "advanced" | "expert" | "master" | "remaster", SongDifficulty> | null;
+    get dx(): Record<"basic" | "advanced" | "expert" | "master" | "remaster", SongDifficulty> | null;
+    get utage(): Record<"basic" | "advanced" | "expert" | "master" | "remaster", SongDifficultyUtage> | null;
+}
+
+/**
+ * maimai 公共 API
+ */
+declare class MaimaiPublicApi {
+    private readonly http;
+    constructor(http: KyInstance);
+    /**
+     * 获取歌曲列表
+     * @param version 版本，不填写遵循api默认行为
+     * @param notes 是否包含谱面信息，不填写遵循api默认行为
+     * @returns 歌曲列表
+     */
+    getSongList(version?: number, notes?: boolean): Promise<SongList>;
+    /**
+     * 获取歌曲信息
+     * @param id 歌曲 ID
+     * @returns 歌曲信息
+     */
+    getSong(id: number): Promise<Song>;
+    /**
+     * 获取歌曲别名列表
+     * @returns 歌曲别名列表
+     */
+    getAliasList(): Promise<AliasList>;
+    /**
+     * 获取收藏品列表
+     * @param collectionType trophy | icon | plate | frame
+     * @param options.version 版本，不填写遵循api默认行为
+     * @param options.required 是否包含曲目需求，默认值为 false
+     * @returns 收藏品列表
+     */
+    getCollectionList(collectionType: "trophy" | "icon" | "plate" | "frame", options?: {
+        version?: number;
+        required?: boolean;
+    }): Promise<Collection[] | undefined>;
+    /**
+     * 获取收藏品信息
+     * @param collectionType trophy | icon | plate | frame
+     * @param id 收藏品 ID
+     * @param options.version 版本，不填写遵循api默认行为
+     * @returns 收藏品信息
+     */
+    getCollectionInfo(collectionType: "trophy" | "icon" | "plate" | "frame", id: number, options?: {
+        version?: number;
+    }): Promise<Collection>;
+    /**
+     * 获取收藏品分类列表
+     * @param options.version 版本，不填写遵循api默认行为
+     * @returns 收藏品分类列表
+     */
+    getCollectionGenreList(options?: {
+        version?: number;
+    }): Promise<CollectionGenreList>;
+    /**
+     * 获取收藏品分类信息
+     * @param id 收藏品分类 ID
+     * @param options.version 版本，不填写遵循api默认行为
+     * @returns 收藏品分类信息
+     */
+    getCollectionGenreInfo(id: number, options?: {
+        version?: number;
+    }): Promise<CollectionGenre>;
+}
+
+interface Bests {
+    standard_total: number;
+    dx_total: number;
+    standard: Score[];
+    dx: Score[];
+}
+type RecentList = Score[];
+type BestScoreList = SimpleScore[];
+type Heatmap = Record<string, number>;
+type TrendList = RatingTrend[];
+type ScoreHistory = Score[];
+
+/**
+ * maimai 开发者 API（路径风格，与文档一致，不使用查询参数）
+ */
+declare class MaimaiDevApi {
+    private readonly http;
+    constructor(http: KyInstance);
+    /**
+     * 创建或修改玩家信息
+     * @param body 玩家信息
+     * @returns 玩家信息
+     */
+    postPlayer(body: Player): Promise<Player>;
+    /**
+     * 获取玩家信息（通过好友码）
+     * @param friendCode 好友码
+     * @returns 玩家信息
+     */
+    getPlayer(friendCode: number): Promise<Player>;
+    /**
+     * 获取玩家信息（通过 QQ 号）
+     * @param qq QQ 号
+     * @returns 玩家信息
+     */
+    getPlayerByQQ(qq: number): Promise<Player>;
+    /**
+     * 获取 Best 50（standard 35 + dx 15）
+     * @param friendCode 好友码
+     * @returns Best 50
+     */
+    getBests(friendCode: number): Promise<Bests>;
+    /**
+     * 获取 AP 50
+     * @param friendCode 好友码
+     * @returns AP 50
+     */
+    getApBests(friendCode: number): Promise<Bests>;
+    /**
+     * 获取 Recent 50（仅增量爬取可用）
+     * @param friendCode 好友码
+     * @returns Recent 50
+     */
+    getRecents(friendCode: number): Promise<RecentList>;
+    /**
+     * 获取玩家缓存的所有最佳成绩（简化）
+     * @param friendCode 好友码
+     * @returns BestScoreList
+     */
+    getAllBestScores(friendCode: number): Promise<BestScoreList>;
+    /**
+     * 成绩上传热力图（YYYY-MM-DD -> 数量）
+     * @param friendCode 好友码
+     * @returns Heatmap
+     */
+    getHeatmap(friendCode: number): Promise<Heatmap>;
+    /**
+     * DX Rating 趋势
+     * @param friendCode 好友码
+     * @returns TrendList
+     */
+    getTrend(friendCode: number): Promise<TrendList>;
+    /**
+     * 成绩游玩历史记录（仅返回带有 play_time 的成绩）
+     * @param friendCode 好友码
+     * @returns 游玩历史记录
+     */
+    getScoreHistory(friendCode: number): Promise<ScoreHistory>;
+    /**
+     * 获取玩家收藏品进度
+     * @param friendCode 好友码
+     * @param collectionType 收藏品类型
+     * @param collectionId 收藏品 ID
+     * @returns 收藏品进度
+     */
+    getCollectionProgress(friendCode: number, collectionType: "trophy" | "icon" | "plate" | "frame", collectionId: number): Promise<Collection>;
+    /**
+     * 上传玩家成绩
+     * @param friendCode 好友码
+     * @param scores 成绩列表
+     * @returns 上传结果
+     */
+    postScores(friendCode: number, scores: Score[]): Promise<unknown>;
+    /**
+     * 通过 NET 的 HTML 源代码上传玩家数据
+     * @param friendCode 好友码
+     * @param htmlSource HTML 源代码
+     * @returns 上传结果
+     */
+    postHtml(friendCode: number, htmlSource: string): Promise<unknown>;
+}
+
+type PlayerScores = Score[];
+
+/**
+ * maimai 个人 API（需用户身份，路径遵循文档）
+ */
+declare class MaimaiPersonalApi {
+    private readonly http;
+    constructor(http: KyInstance);
+    /**
+     * 获取玩家信息
+     * GET /api/v0/user/maimai/player
+     * @returns PlayerInfo
+     */
+    getPlayer(): Promise<Player>;
+    /**
+     * 获取玩家所有成绩
+     * GET /api/v0/user/maimai/player/scores
+     * @returns PlayerScores
+     */
+    getScores(): Promise<PlayerScores>;
+    /**
+     * 上传玩家成绩
+     * POST /api/v0/user/maimai/player/scores
+     * @param scores 成绩列表
+     * @returns 上传结果
+     */
+    postScores(scores: Score[]): Promise<unknown>;
+}
+
+type LxnsApiClientTokens = Omit<LxnsApiClientOptions, "baseURL">;
+type Flags = Readonly<LxnsApiClientTokens>;
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type IfDefined<T, Then, Else = {}> = [T] extends [NonNullable<T>] ? Then : Else;
+type MaiMaiOf<O extends Flags> = Simplify<{
+    public: MaimaiPublicApi;
+} & IfDefined<O["devAccessToken"], {
+    dev: MaimaiDevApi;
+}> & IfDefined<O["personalAccessToken"], {
+    personal: MaimaiPersonalApi;
+}>>;
+
+interface LxnsApiClientOptions {
+    personalAccessToken?: string;
+    devAccessToken?: string;
+    baseURL?: string;
+}
+declare class LxnsApiClient<O extends LxnsApiClientOptions> {
+    config: LxnsApiClientOptions & {
+        baseURL: string;
+    };
+    /**
+     * maimai API
+     */
+    readonly maimai: MaiMaiOf<O>;
+    constructor(config?: Readonly<O>);
+}
+
+export { LxnsApiClient, models as MaimaiModels };

package/dist/index.js

@@ -0,0 +1 @@
+var h=Object.defineProperty;var x=(s,e)=>{for(var t in e)h(s,t,{get:e[t],enumerable:!0})};var b={};x(b,{LevelIndex:()=>f});var f=(r=>(r[r.BASIC=0]="BASIC",r[r.ADVANCED=1]="ADVANCED",r[r.EXPERT=2]="EXPERT",r[r.MASTER=3]="MASTER",r[r.RE_MASTER=4]="RE_MASTER",r))(f||{});import d from"ky";var S=["basic","advanced","expert","master","remaster"];function u(s){return s.reduce((e,t)=>(e[S[t.difficulty]]=t,e),{})}var o=class{id;title;artist;genre;version;bpm;difficulties;locked;disabled;rights;constructor(e){this.id=e.id,this.title=e.title,this.artist=e.artist,this.genre=e.genre,this.version=e.version,this.bpm=e.bpm,this.difficulties=e.difficulties,this.locked=e.locked??!1,this.disabled=e.disabled??!1,this.rights=e.rights}get standard(){return this.difficulties.standard.length===0?null:u(this.difficulties.standard)}get dx(){return this.difficulties.dx.length===0?null:u(this.difficulties.dx)}get utage(){return this.difficulties.utage?u(this.difficulties.utage):null}};var a=class{constructor(e){this.http=e}async getSongList(e,t){return this.http.get("song/list?",{searchParams:{version:e,notes:t}}).json()}async getSong(e){let t=await this.http.get(`song/${e}`).json();return new o(t)}async getAliasList(){return this.http.get("alias/list").json()}async getCollectionList(e,t){let n={trophy:"trophies",icon:"icons",plate:"plates",frame:"frames"};return this.http.get(`${e}/list`,{searchParams:{...t}}).json().then(i=>i[n[e]])}async getCollectionInfo(e,t,n){return this.http.get(`${e}/${t}`,{searchParams:{...n}}).json()}async getCollectionGenreList(e){return this.http.get("collection-genre/list",{searchParams:{...e}}).json()}async getCollectionGenreInfo(e,t){return this.http.get(`collection-genre/${e}`,{searchParams:{...t}}).json()}};var l=class{constructor(e){this.http=e}async postPlayer(e){return this.http.post("player",{json:e}).json()}async getPlayer(e){return this.http.get(`player/${e}`).json()}async getPlayerByQQ(e){return this.http.get(`player/qq/${e}`).json()}async getBests(e){return this.http.get(`player/${e}/bests`).json()}async getApBests(e){return this.http.get(`player/${e}/bests/ap`).json()}async getRecents(e){return this.http.get(`player/${e}/recents`).json()}async getAllBestScores(e){return this.http.get(`player/${e}/scores`).json()}async getHeatmap(e){return this.http.get(`player/${e}/heatmap`).json()}async getTrend(e){return this.http.get(`player/${e}/trend`).json()}async getScoreHistory(e){return this.http.get(`player/${e}/score/history`).json()}async getCollectionProgress(e,t,n){return this.http.get(`player/${e}/${t}/${n}`).json()}async postScores(e,t){let n={scores:t};return this.http.post(`player/${e}/scores`,{json:n}).json()}async postHtml(e,t){return this.http.post(`player/${e}/html`,{body:t,headers:{"content-type":"text/plain"}}).json()}};var c=class{constructor(e){this.http=e}async getPlayer(){return this.http.get("player").json()}async getScores(){return this.http.get("scores").json()}async postScores(e){let t={scores:e};return this.http.post("scores",{json:t}).json()}};var m=class{config={baseURL:"https://maimai.lxns.net/api/v0/"};maimai;constructor(e){this.config={baseURL:e?.baseURL??this.config.baseURL,personalAccessToken:e?.personalAccessToken,devAccessToken:e?.devAccessToken};let{baseURL:t,devAccessToken:n,personalAccessToken:i}=this.config,r=d.create({prefixUrl:new URL("maimai/",t)}),y=n?d.create({prefixUrl:new URL("maimai/",t),headers:{Authorization:n}}):void 0,g=i?d.create({prefixUrl:new URL("user/maimai/",t),headers:{"X-User-Token":i}}):void 0,p={public:new a(r)};y&&(p.dev=new l(y)),g&&(p.personal=new c(g)),this.maimai=p}};export{m as LxnsApiClient,b as MaimaiModels};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "lxns-rhythm-api",
+  "description": "A simple SDK for lxns api.",
+  "author": "amatsuka <amatsukamao@qq.com>",
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wsyzxjn/lxns-rhythm-api.git"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "devDependencies": {
+    "@types/node": "^24.5.1",
+    "@typescript-eslint/eslint-plugin": "^8.44.0",
+    "@typescript-eslint/parser": "^8.44.0",
+    "cross-env": "^10.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.6.2",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "ky": "^1.10.0"
+  },
+  "scripts": {
+    "lint": "eslint --ext .ts,.js src",
+    "prettier": "prettier --write 'src/**/*.ts'",
+    "test": "tsx tests/index.ts",
+    "build": "tsup",
+    "build:production": "cross-env NODE_ENV=production tsup"
+  }
+}