lxns-rhythm-api 0.1.4 → 0.1.8

package/dist/index.js

@@ -4,153 +4,211 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// src/apis/maimai/models.ts
+// src/api/chunithm/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;
+var LevelIndex = /* @__PURE__ */ ((LevelIndex3) => {
+  LevelIndex3[LevelIndex3["BASIC"] = 0] = "BASIC";
+  LevelIndex3[LevelIndex3["ADVANCED"] = 1] = "ADVANCED";
+  LevelIndex3[LevelIndex3["EXPERT"] = 2] = "EXPERT";
+  LevelIndex3[LevelIndex3["MASTER"] = 3] = "MASTER";
+  LevelIndex3[LevelIndex3["ULTIMA"] = 4] = "ULTIMA";
+  LevelIndex3[LevelIndex3["WORLDS_END"] = 5] = "WORLDS_END";
+  return LevelIndex3;
 })(LevelIndex || {});
 
-// src/client/LxnsApiCLient.ts
+// src/api/maimai/models.ts
+var models_exports2 = {};
+__export(models_exports2, {
+  LevelIndex: () => LevelIndex2
+});
+var LevelIndex2 = /* @__PURE__ */ ((LevelIndex3) => {
+  LevelIndex3[LevelIndex3["BASIC"] = 0] = "BASIC";
+  LevelIndex3[LevelIndex3["ADVANCED"] = 1] = "ADVANCED";
+  LevelIndex3[LevelIndex3["EXPERT"] = 2] = "EXPERT";
+  LevelIndex3[LevelIndex3["MASTER"] = 3] = "MASTER";
+  LevelIndex3[LevelIndex3["RE_MASTER"] = 4] = "RE_MASTER";
+  return LevelIndex3;
+})(LevelIndex2 || {});
+
+// src/client/lxns-api-client.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;
+// src/api/chunithm/dev.ts
+var ChunithmDevApi = class {
+  constructor(http) {
+    this.http = http;
   }
-  get standard() {
-    if (this.difficulties.standard.length === 0) return null;
-    return convertDifficulty(this.difficulties.standard);
+  /**
+   * 创建或修改玩家信息
+   */
+  async postPlayer(body) {
+    return this.http.post("player", { json: body }).json();
   }
-  get dx() {
-    if (this.difficulties.dx.length === 0) return null;
-    return convertDifficulty(this.difficulties.dx);
+  /**
+   * 获取玩家信息（通过好友码）
+   */
+  async getPlayer(friendCode) {
+    return this.http.get(`player/${friendCode}`).json();
   }
-  get utage() {
-    if (!this.difficulties.utage) return null;
-    return convertDifficulty(this.difficulties.utage);
+  /**
+   * 获取玩家信息（通过 QQ 号）
+   */
+  async getPlayerByQQ(qq) {
+    return this.http.get(`player/qq/${qq}`).json();
+  }
+  /**
+   * 获取 Best 30（old 15 + new 15）
+   */
+  async getBests(friendCode) {
+    return this.http.get(`player/${friendCode}/bests`).json();
+  }
+  /**
+   * 获取玩家缓存谱面的最佳成绩
+   */
+  async getBest(friendCode, options) {
+    return this.http.get(`player/${friendCode}/best`, {
+      searchParams: {
+        song_id: options.songId,
+        song_name: options.songName,
+        level_index: options.levelIndex
+      }
+    }).json();
+  }
+  /**
+   * 获取玩家缓存的所有最佳成绩（简化）
+   */
+  async getAllBestScores(friendCode) {
+    return this.http.get(`player/${friendCode}/scores`).json();
+  }
+  /**
+   * 获取 Recent 50
+   */
+  async getRecents(friendCode) {
+    return this.http.get(`player/${friendCode}/recents`).json();
+  }
+  /**
+   * 获取成绩游玩历史记录
+   */
+  async getScoreHistory(friendCode, options) {
+    return this.http.get(`player/${friendCode}/score/history`, {
+      searchParams: {
+        song_id: options?.songId,
+        level_index: options?.levelIndex
+      }
+    }).json();
+  }
+  /**
+   * 成绩上传热力图
+   */
+  async getHeatmap(friendCode) {
+    return this.http.get(`player/${friendCode}/heatmap`).json();
+  }
+  /**
+   * Rating 趋势
+   */
+  async getTrend(friendCode, version) {
+    return this.http.get(`player/${friendCode}/trend`, { searchParams: { version } }).json();
+  }
+  /**
+   * 获取玩家收藏品进度
+   */
+  async getCollectionProgress(friendCode, collectionType, collectionId) {
+    return this.http.get(`player/${friendCode}/${collectionType}/${collectionId}`).json();
+  }
+  /**
+   * 上传玩家成绩
+   */
+  async postScores(friendCode, scores) {
+    const body = { scores };
+    return this.http.post(`player/${friendCode}/scores`, { json: body }).json();
+  }
+  /**
+   * 通过 NET 的 HTML 源代码上传玩家数据
+   */
+  async postHtml(friendCode, htmlSource) {
+    return this.http.post(`player/${friendCode}/html`, {
+      body: htmlSource,
+      headers: { "content-type": "text/plain" }
+    }).json();
   }
 };
 
-// src/apis/maimai/public.ts
-var MaimaiPublicApi = class {
+// src/api/chunithm/personal.ts
+var ChunithmPersonalApi = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * 获取玩家信息
+   * GET /api/v0/user/chunithm/player
+   */
+  async getPlayer() {
+    return this.http.get("player").json();
+  }
+  /**
+   * 获取玩家所有成绩
+   * GET /api/v0/user/chunithm/player/scores
+   */
+  async getScores() {
+    return this.http.get("scores").json();
+  }
+  /**
+   * 上传玩家成绩
+   * POST /api/v0/user/chunithm/player/scores
+   */
+  async postScores(scores) {
+    const body = { scores };
+    return this.http.post("scores", { json: body }).json();
+  }
+};
+
+// src/api/chunithm/public.ts
+var ChunithmPublicApi = 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();
+    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);
+  async getSong(id, version) {
+    return this.http.get(`song/${id}`, { searchParams: { version } }).json();
   }
   /**
    * 获取歌曲别名列表
-   * @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) {
+  async getCollectionList(collectionType, version) {
     const collectionMap = {
       trophy: "trophies",
-      icon: "icons",
+      character: "characters",
       plate: "plates",
-      frame: "frames"
+      icon: "icons"
     };
-    return this.http.get(`${collectionType}/list`, { searchParams: { ...options } }).json().then((res) => res[collectionMap[collectionType]]);
+    return this.http.get(`${collectionType}/list`, { searchParams: { version } }).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();
+  async getCollectionInfo(collectionType, id, version) {
+    return this.http.get(`${collectionType}/${id}`, { searchParams: { version } }).json();
   }
 };
 
-// src/apis/maimai/dev.ts
+// src/api/maimai/dev.ts
 var MaimaiDevApi = class {
   constructor(http) {
     this.http = http;
@@ -269,7 +327,7 @@ var MaimaiDevApi = class {
   }
 };
 
-// src/apis/maimai/personal.ts
+// src/api/maimai/personal.ts
 var MaimaiPersonalApi = class {
   constructor(http) {
     this.http = http;
@@ -302,57 +360,318 @@ var MaimaiPersonalApi = class {
   }
 };
 
-// src/client/LxnsApiCLient.ts
-var LxnsApiClient = class {
-  config = {
-    baseURL: "https://maimai.lxns.net/api/v0/"
-  };
+// src/api/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/api/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/lxns-api-error.ts
+var LxnsApiError = class extends Error {
+  code;
+  status;
+  success;
+  data;
+  constructor(payload, status) {
+    super(payload.message ?? `Lxns API unknown error (code: ${payload.code})`);
+    this.name = "LxnsApiError";
+    this.code = payload.code;
+    this.status = status;
+    this.success = payload.success;
+    this.data = payload.data;
+  }
+};
+function isLxnsApiError(error) {
+  return error instanceof LxnsApiError;
+}
+function isNotFoundError(error) {
+  return isLxnsApiError(error) && (error.status ?? error.code) === 404;
+}
+function isAuthError(error) {
+  const code = isLxnsApiError(error) ? error.status ?? error.code : void 0;
+  return code === 401 || code === 403;
+}
+function isRateLimitError(error) {
+  return isLxnsApiError(error) && (error.status ?? error.code) === 429;
+}
+function isServerError(error) {
+  const code = isLxnsApiError(error) ? error.status ?? error.code : void 0;
+  return typeof code === "number" && code >= 500;
+}
+
+// src/client/lxns-api-client.ts
+function parseLxnsJson(text) {
+  const payload = JSON.parse(text);
+  if (payload.success === false) {
+    throw new LxnsApiError(payload);
+  }
+  if (payload.success === true) {
+    return payload.data;
+  }
+  return payload;
+}
+async function wrapKyError(error) {
+  const status = error.response.status;
+  try {
+    const payload = await error.response.clone().json();
+    if (typeof payload.success === "boolean") {
+      throw new LxnsApiError(
+        {
+          success: payload.success,
+          code: payload.code ?? status,
+          message: payload.message ?? error.message,
+          data: payload.data
+        },
+        status
+      );
+    }
+  } catch {
+  }
+  throw new LxnsApiError(
+    {
+      success: false,
+      code: status,
+      message: error.message
+    },
+    status
+  );
+}
+var LxnsApiClient = class _LxnsApiClient {
+  config;
   /**
    * maimai API
    */
   maimai;
+  /**
+   * chunithm API
+   */
+  chunithm;
+  static BASE_OPTIONS = {
+    parseJson: parseLxnsJson,
+    throwHttpErrors: true,
+    hooks: {
+      beforeError: [wrapKyError]
+    }
+  };
+  mountGameApi({
+    public: publicApi,
+    dev,
+    personal,
+    extra
+  }) {
+    const namespace = {
+      public: publicApi,
+      ...extra ?? {}
+    };
+    if (dev) {
+      namespace.dev = dev;
+    }
+    if (personal) {
+      namespace.personal = personal;
+    }
+    return namespace;
+  }
   constructor(config) {
     this.config = {
-      baseURL: config?.baseURL ?? this.config.baseURL,
-      personalAccessToken: config?.personalAccessToken,
-      devAccessToken: config?.devAccessToken
+      ...config,
+      baseURL: config?.baseURL ?? "https://maimai.lxns.net/api/v0/"
     };
     const { baseURL, devAccessToken, personalAccessToken } = this.config;
-    const httpPublic = ky.create({
-      prefixUrl: new URL("maimai/", baseURL)
+    const maimaiHttpPublic = ky.create({
+      prefixUrl: new URL("maimai/", baseURL),
+      ..._LxnsApiClient.BASE_OPTIONS
     });
-    const httpDev = devAccessToken ? ky.create({
+    const maimaiHttpDev = devAccessToken ? ky.create({
       prefixUrl: new URL("maimai/", baseURL),
       headers: {
         Authorization: devAccessToken
-      }
+      },
+      ..._LxnsApiClient.BASE_OPTIONS
     }) : void 0;
-    const httpPersonal = personalAccessToken ? ky.create({
+    const maimaiHttpPersonal = personalAccessToken ? ky.create({
       prefixUrl: new URL("user/maimai/", baseURL),
       headers: {
         "X-User-Token": personalAccessToken
+      },
+      ..._LxnsApiClient.BASE_OPTIONS
+    }) : void 0;
+    this.maimai = this.mountGameApi({
+      public: new MaimaiPublicApi(maimaiHttpPublic),
+      dev: maimaiHttpDev ? new MaimaiDevApi(maimaiHttpDev) : void 0,
+      personal: maimaiHttpPersonal ? new MaimaiPersonalApi(maimaiHttpPersonal) : void 0,
+      extra: {
+        getAsset: async (type, id) => {
+          return new Uint8Array(
+            await ky.get(
+              `https://assets2.lxns.net/maimai/${type}/${id + (type === "music" ? ".mp3" : ".png")}`
+            ).arrayBuffer()
+          );
+        }
       }
+    });
+    const chunithmHttpPublic = ky.create({
+      prefixUrl: new URL("chunithm/", baseURL),
+      ..._LxnsApiClient.BASE_OPTIONS
+    });
+    const chunithmHttpDev = devAccessToken ? ky.create({
+      prefixUrl: new URL("chunithm/", baseURL),
+      headers: {
+        Authorization: devAccessToken
+      },
+      ..._LxnsApiClient.BASE_OPTIONS
     }) : void 0;
-    const maimai = {
-      public: new MaimaiPublicApi(httpPublic),
-      getAsset: async (type, id) => {
-        return Buffer.from(
-          await ky.get(
-            `https://assets2.lxns.net/maimai/${type}/${id + (type === "music" ? ".mp3" : ".png")}`
-          ).arrayBuffer()
-        );
+    const chunithmHttpPersonal = personalAccessToken ? ky.create({
+      prefixUrl: new URL("user/chunithm/", baseURL),
+      headers: {
+        "X-User-Token": personalAccessToken
+      },
+      ..._LxnsApiClient.BASE_OPTIONS
+    }) : void 0;
+    this.chunithm = this.mountGameApi({
+      public: new ChunithmPublicApi(chunithmHttpPublic),
+      dev: chunithmHttpDev ? new ChunithmDevApi(chunithmHttpDev) : void 0,
+      personal: chunithmHttpPersonal ? new ChunithmPersonalApi(chunithmHttpPersonal) : void 0,
+      extra: {
+        getAsset: async (type, id) => {
+          return new Uint8Array(
+            await ky.get(`https://assets2.lxns.net/chunithm/${type}/${id}.png`).arrayBuffer()
+          );
+        }
       }
-    };
-    if (httpDev) {
-      maimai.dev = new MaimaiDevApi(httpDev);
-    }
-    if (httpPersonal) {
-      maimai.personal = new MaimaiPersonalApi(httpPersonal);
-    }
-    this.maimai = maimai;
+    });
   }
 };
 export {
+  models_exports as ChunithmModels,
   LxnsApiClient,
-  models_exports as MaimaiModels
+  LxnsApiError,
+  models_exports2 as MaimaiModels,
+  isAuthError,
+  isLxnsApiError,
+  isNotFoundError,
+  isRateLimitError,
+  isServerError
 };