lxns-rhythm-api 0.1.0 → 0.1.2

package/README.md

@@ -4,7 +4,7 @@
 
 - 零运行时依赖（仅使用 `ky` 发起请求）。
 - 类型安全：根据传入的 token 自动在 `maimai` 命名空间上暴露 `public` / `dev` / `personal` 子 API。
-- 现代构建（ESM/CJS/类型声明）。
+- 现代构建
 
 ## 安装
 
@@ -44,12 +44,6 @@ const me = await personalClient.maimai.personal.getPlayer();
 console.log(me);
 ```
 
-CommonJS 引用：
-
-```js
-const { LxnsApiClient } = require("lxns-sdk");
-```
-
 ## 配置项
 
 构造函数签名：

package/dist/index.js

@@ -1 +1,351 @@
-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};
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/apis/maimai/models.ts
+var models_exports = {};
+__export(models_exports, {
+  LevelIndex: () => LevelIndex
+});
+var LevelIndex = /* @__PURE__ */ ((LevelIndex2) => {
+  LevelIndex2[LevelIndex2["BASIC"] = 0] = "BASIC";
+  LevelIndex2[LevelIndex2["ADVANCED"] = 1] = "ADVANCED";
+  LevelIndex2[LevelIndex2["EXPERT"] = 2] = "EXPERT";
+  LevelIndex2[LevelIndex2["MASTER"] = 3] = "MASTER";
+  LevelIndex2[LevelIndex2["RE_MASTER"] = 4] = "RE_MASTER";
+  return LevelIndex2;
+})(LevelIndex || {});
+
+// src/client/LxnsApiCLient.ts
+import ky from "ky";
+
+// src/apis/maimai/entities/Song.ts
+var LevelArray = [
+  "basic",
+  "advanced",
+  "expert",
+  "master",
+  "remaster"
+];
+function convertDifficulty(difficulty) {
+  return difficulty.reduce(
+    (acc, cur) => {
+      acc[LevelArray[cur.difficulty]] = cur;
+      return acc;
+    },
+    {}
+  );
+}
+var Song = class {
+  id;
+  title;
+  artist;
+  genre;
+  version;
+  bpm;
+  difficulties;
+  locked;
+  disabled;
+  rights;
+  constructor(song) {
+    this.id = song.id;
+    this.title = song.title;
+    this.artist = song.artist;
+    this.genre = song.genre;
+    this.version = song.version;
+    this.bpm = song.bpm;
+    this.difficulties = song.difficulties;
+    this.locked = song.locked ?? false;
+    this.disabled = song.disabled ?? false;
+    this.rights = song.rights;
+  }
+  get standard() {
+    if (this.difficulties.standard.length === 0) return null;
+    return convertDifficulty(this.difficulties.standard);
+  }
+  get dx() {
+    if (this.difficulties.dx.length === 0) return null;
+    return convertDifficulty(this.difficulties.dx);
+  }
+  get utage() {
+    if (!this.difficulties.utage) return null;
+    return convertDifficulty(this.difficulties.utage);
+  }
+};
+
+// src/apis/maimai/public.ts
+var MaimaiPublicApi = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * 获取歌曲列表
+   * @param version 版本，不填写遵循api默认行为
+   * @param notes 是否包含谱面信息，不填写遵循api默认行为
+   * @returns 歌曲列表
+   */
+  async getSongList(version, notes) {
+    return this.http.get("song/list?", { searchParams: { version, notes } }).json();
+  }
+  /**
+   * 获取歌曲信息
+   * @param id 歌曲 ID
+   * @returns 歌曲信息
+   */
+  async getSong(id) {
+    const songInfo = await this.http.get(`song/${id}`).json();
+    return new Song(songInfo);
+  }
+  /**
+   * 获取歌曲别名列表
+   * @returns 歌曲别名列表
+   */
+  async getAliasList() {
+    return this.http.get("alias/list").json();
+  }
+  /**
+   * 获取收藏品列表
+   * @param collectionType trophy | icon | plate | frame
+   * @param options.version 版本，不填写遵循api默认行为
+   * @param options.required 是否包含曲目需求，默认值为 false
+   * @returns 收藏品列表
+   */
+  async getCollectionList(collectionType, options) {
+    const collectionMap = {
+      trophy: "trophies",
+      icon: "icons",
+      plate: "plates",
+      frame: "frames"
+    };
+    return this.http.get(`${collectionType}/list`, { searchParams: { ...options } }).json().then((res) => res[collectionMap[collectionType]]);
+  }
+  /**
+   * 获取收藏品信息
+   * @param collectionType trophy | icon | plate | frame
+   * @param id 收藏品 ID
+   * @param options.version 版本，不填写遵循api默认行为
+   * @returns 收藏品信息
+   */
+  async getCollectionInfo(collectionType, id, options) {
+    return this.http.get(`${collectionType}/${id}`, { searchParams: { ...options } }).json();
+  }
+  /**
+   * 获取收藏品分类列表
+   * @param options.version 版本，不填写遵循api默认行为
+   * @returns 收藏品分类列表
+   */
+  async getCollectionGenreList(options) {
+    return this.http.get("collection-genre/list", { searchParams: { ...options } }).json();
+  }
+  /**
+   * 获取收藏品分类信息
+   * @param id 收藏品分类 ID
+   * @param options.version 版本，不填写遵循api默认行为
+   * @returns 收藏品分类信息
+   */
+  async getCollectionGenreInfo(id, options) {
+    return this.http.get(`collection-genre/${id}`, { searchParams: { ...options } }).json();
+  }
+};
+
+// src/apis/maimai/dev.ts
+var MaimaiDevApi = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * 创建或修改玩家信息
+   * @param body 玩家信息
+   * @returns 玩家信息
+   */
+  async postPlayer(body) {
+    return this.http.post("player", { json: body }).json();
+  }
+  /**
+   * 获取玩家信息（通过好友码）
+   * @param friendCode 好友码
+   * @returns 玩家信息
+   */
+  async getPlayer(friendCode) {
+    return this.http.get(`player/${friendCode}`).json();
+  }
+  /**
+   * 获取玩家信息（通过 QQ 号）
+   * @param qq QQ 号
+   * @returns 玩家信息
+   */
+  async getPlayerByQQ(qq) {
+    return this.http.get(`player/qq/${qq}`).json();
+  }
+  /**
+   * 获取 Best 50（standard 35 + dx 15）
+   * @param friendCode 好友码
+   * @returns Best 50
+   */
+  async getBests(friendCode) {
+    return this.http.get(`player/${friendCode}/bests`).json();
+  }
+  /**
+   * 获取 AP 50
+   * @param friendCode 好友码
+   * @returns AP 50
+   */
+  async getApBests(friendCode) {
+    return this.http.get(`player/${friendCode}/bests/ap`).json();
+  }
+  /**
+   * 获取 Recent 50（仅增量爬取可用）
+   * @param friendCode 好友码
+   * @returns Recent 50
+   */
+  async getRecents(friendCode) {
+    return this.http.get(`player/${friendCode}/recents`).json();
+  }
+  /**
+   * 获取玩家缓存的所有最佳成绩（简化）
+   * @param friendCode 好友码
+   * @returns BestScoreList
+   */
+  async getAllBestScores(friendCode) {
+    return this.http.get(`player/${friendCode}/scores`).json();
+  }
+  /**
+   * 成绩上传热力图（YYYY-MM-DD -> 数量）
+   * @param friendCode 好友码
+   * @returns Heatmap
+   */
+  async getHeatmap(friendCode) {
+    return this.http.get(`player/${friendCode}/heatmap`).json();
+  }
+  /**
+   * DX Rating 趋势
+   * @param friendCode 好友码
+   * @returns TrendList
+   */
+  async getTrend(friendCode) {
+    return this.http.get(`player/${friendCode}/trend`).json();
+  }
+  /**
+   * 成绩游玩历史记录（仅返回带有 play_time 的成绩）
+   * @param friendCode 好友码
+   * @returns 游玩历史记录
+   */
+  async getScoreHistory(friendCode) {
+    return this.http.get(`player/${friendCode}/score/history`).json();
+  }
+  /**
+   * 获取玩家收藏品进度
+   * @param friendCode 好友码
+   * @param collectionType 收藏品类型
+   * @param collectionId 收藏品 ID
+   * @returns 收藏品进度
+   */
+  async getCollectionProgress(friendCode, collectionType, collectionId) {
+    return this.http.get(`player/${friendCode}/${collectionType}/${collectionId}`).json();
+  }
+  /**
+   * 上传玩家成绩
+   * @param friendCode 好友码
+   * @param scores 成绩列表
+   * @returns 上传结果
+   */
+  async postScores(friendCode, scores) {
+    const body = { scores };
+    return this.http.post(`player/${friendCode}/scores`, { json: body }).json();
+  }
+  /**
+   * 通过 NET 的 HTML 源代码上传玩家数据
+   * @param friendCode 好友码
+   * @param htmlSource HTML 源代码
+   * @returns 上传结果
+   */
+  async postHtml(friendCode, htmlSource) {
+    return this.http.post(`player/${friendCode}/html`, {
+      body: htmlSource,
+      headers: { "content-type": "text/plain" }
+    }).json();
+  }
+};
+
+// src/apis/maimai/personal.ts
+var MaimaiPersonalApi = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * 获取玩家信息
+   * GET /api/v0/user/maimai/player
+   * @returns PlayerInfo
+   */
+  async getPlayer() {
+    return this.http.get("player").json();
+  }
+  /**
+   * 获取玩家所有成绩
+   * GET /api/v0/user/maimai/player/scores
+   * @returns PlayerScores
+   */
+  async getScores() {
+    return this.http.get("scores").json();
+  }
+  /**
+   * 上传玩家成绩
+   * POST /api/v0/user/maimai/player/scores
+   * @param scores 成绩列表
+   * @returns 上传结果
+   */
+  async postScores(scores) {
+    const body = { scores };
+    return this.http.post("scores", { json: body }).json();
+  }
+};
+
+// src/client/LxnsApiCLient.ts
+var LxnsApiClient = class {
+  config = {
+    baseURL: "https://maimai.lxns.net/api/v0/"
+  };
+  /**
+   * maimai API
+   */
+  maimai;
+  constructor(config) {
+    this.config = {
+      baseURL: config?.baseURL ?? this.config.baseURL,
+      personalAccessToken: config?.personalAccessToken,
+      devAccessToken: config?.devAccessToken
+    };
+    const { baseURL, devAccessToken, personalAccessToken } = this.config;
+    const httpPublic = ky.create({
+      prefixUrl: new URL("maimai/", baseURL)
+    });
+    const httpDev = devAccessToken ? ky.create({
+      prefixUrl: new URL("maimai/", baseURL),
+      headers: {
+        Authorization: devAccessToken
+      }
+    }) : void 0;
+    const httpPersonal = personalAccessToken ? ky.create({
+      prefixUrl: new URL("user/maimai/", baseURL),
+      headers: {
+        "X-User-Token": personalAccessToken
+      }
+    }) : void 0;
+    const maimai = {
+      public: new MaimaiPublicApi(httpPublic)
+    };
+    if (httpDev) {
+      maimai.dev = new MaimaiDevApi(httpDev);
+    }
+    if (httpPersonal) {
+      maimai.personal = new MaimaiPersonalApi(httpPersonal);
+    }
+    this.maimai = maimai;
+  }
+};
+export {
+  LxnsApiClient,
+  models_exports as MaimaiModels
+};

package/package.json

@@ -2,15 +2,14 @@
   "name": "lxns-rhythm-api",
   "description": "A simple SDK for lxns api.",
   "author": "amatsuka <amatsukamao@qq.com>",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "repository": {
     "type": "git",
     "url": "https://github.com/wsyzxjn/lxns-rhythm-api.git"
   },
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": "./dist/index.js"
     },
     "./package.json": "./package.json"
   },
@@ -21,7 +20,7 @@
     "LICENSE"
   ],
   "type": "module",
-  "main": "./dist/index.cjs",
+  "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "devDependencies": {

package/dist/index.cjs

@@ -1 +0,0 @@
-"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});