maidraw 0.11.14 → 0.12.0

package/dist/chu/index.d.ts

@@ -1,16 +1,14 @@
-import Bunyan from "bunyan";
 import * as database from "./lib/database";
 import * as chart from "./painter/chart";
 import * as bests from "./painter/best50";
 import * as adapter from "./lib/adapter";
 import * as lxns from "./lib/adapter/lxns";
 import * as kamaiTachi from "./lib/adapter/kamaiTachi";
-export declare class Chuni {
-    static logger: Bunyan;
-}
+import * as types from "./type";
 export declare namespace Chuni {
+    export import Types = types;
     export import Database = database.Database;
-    export import ScoreTrackerAdapter = adapter.ScoreTrackerAdapter;
+    export import ChunithmScoreAdapter = adapter.ChunithmScoreAdapter;
     namespace Adapters {
         export import KamaiTachi = kamaiTachi.KamaiTachi;
         export import LXNS = lxns.LXNS;

package/dist/chu/index.js

@@ -22,54 +22,20 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Chuni = void 0;
-const bunyan_1 = __importDefault(require("bunyan"));
 const database = __importStar(require("./lib/database"));
 const chart = __importStar(require("./painter/chart"));
 const bests = __importStar(require("./painter/best50"));
 const adapter = __importStar(require("./lib/adapter"));
 const lxns = __importStar(require("./lib/adapter/lxns"));
 const kamaiTachi = __importStar(require("./lib/adapter/kamaiTachi"));
-class Chuni {
-    static logger = new bunyan_1.default({
-        name: "maidraw.chuni",
-        streams: [
-            {
-                stream: process.stdout,
-                level: (() => {
-                    switch (process.env.LOG_LEVEL) {
-                        case "trace":
-                            return bunyan_1.default.TRACE;
-                        case "debug":
-                            return bunyan_1.default.DEBUG;
-                        case "info":
-                            return bunyan_1.default.INFO;
-                        case "warn":
-                            return bunyan_1.default.WARN;
-                        case "error":
-                            return bunyan_1.default.ERROR;
-                        case "fatal":
-                            return bunyan_1.default.FATAL;
-                        default:
-                            return bunyan_1.default.INFO;
-                    }
-                })(),
-            },
-            {
-                stream: process.stderr,
-                level: bunyan_1.default.ERROR,
-            },
-        ],
-    });
-}
-exports.Chuni = Chuni;
+const types = __importStar(require("./type"));
+var Chuni;
 (function (Chuni) {
+    Chuni.Types = types;
     Chuni.Database = database.Database;
-    Chuni.ScoreTrackerAdapter = adapter.ScoreTrackerAdapter;
+    Chuni.ChunithmScoreAdapter = adapter.ChunithmScoreAdapter;
     let Adapters;
     (function (Adapters) {
         Adapters.KamaiTachi = kamaiTachi.KamaiTachi;

package/dist/chu/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chu/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oDAA4B;AAE5B,yDAA2C;AAE3C,uDAAyC;AACzC,wDAA0C;AAE1C,uDAAyC;AACzC,yDAA2C;AAC3C,qEAAuD;AAEvD,MAAa,KAAK;IACP,MAAM,CAAC,MAAM,GAAG,IAAI,gBAAM,CAAC;QAC9B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE;YACL;gBACI,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,CAAC,GAAG,EAAE;oBACT,QAAQ,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;wBAC5B,KAAK,OAAO;4BACR,OAAO,gBAAM,CAAC,KAAK,CAAC;wBACxB,KAAK,OAAO;4BACR,OAAO,gBAAM,CAAC,KAAK,CAAC;wBACxB,KAAK,MAAM;4BACP,OAAO,gBAAM,CAAC,IAAI,CAAC;wBACvB,KAAK,MAAM;4BACP,OAAO,gBAAM,CAAC,IAAI,CAAC;wBACvB,KAAK,OAAO;4BACR,OAAO,gBAAM,CAAC,KAAK,CAAC;wBACxB,KAAK,OAAO;4BACR,OAAO,gBAAM,CAAC,KAAK,CAAC;wBACxB;4BACI,OAAO,gBAAM,CAAC,IAAI,CAAC;oBAC3B,CAAC;gBACL,CAAC,CAAC,EAAE;aACP;YACD;gBACI,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,gBAAM,CAAC,KAAK;aACtB;SACJ;KACJ,CAAC,CAAC;;AA9BP,sBA+BC;AAED,WAAiB,KAAK;IACJ,cAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAE7B,yBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAChE,IAAiB,QAAQ,CAGxB;IAHD,WAAiB,QAAQ;QACP,mBAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACnC,aAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACnC,CAAC,EAHgB,QAAQ,GAAR,cAAQ,KAAR,cAAQ,QAGxB;IAED,IAAiB,QAAQ,CAGxB;IAHD,WAAiB,QAAQ;QACP,eAAM,GAAG,KAAK,CAAC,aAAa,CAAC;QAC7B,cAAK,GAAG,KAAK,CAAC,YAAY,CAAC;IAC7C,CAAC,EAHgB,QAAQ,GAAR,cAAQ,KAAR,cAAQ,QAGxB;AACL,CAAC,EAbgB,KAAK,qBAAL,KAAK,QAarB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chu/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,yDAA2C;AAE3C,uDAAyC;AACzC,wDAA0C;AAE1C,uDAAyC;AACzC,yDAA2C;AAC3C,qEAAuD;AAEvD,8CAAgC;AAEhC,IAAiB,KAAK,CAerB;AAfD,WAAiB,KAAK;IACJ,WAAK,GAAG,KAAK,CAAC;IAEd,cAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAE7B,0BAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAClE,IAAiB,QAAQ,CAGxB;IAHD,WAAiB,QAAQ;QACP,mBAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACnC,aAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACnC,CAAC,EAHgB,QAAQ,GAAR,cAAQ,KAAR,cAAQ,QAGxB;IAED,IAAiB,QAAQ,CAGxB;IAHD,WAAiB,QAAQ;QACP,eAAM,GAAG,KAAK,CAAC,aAAa,CAAC;QAC7B,cAAK,GAAG,KAAK,CAAC,YAAY,CAAC;IAC7C,CAAC,EAHgB,QAAQ,GAAR,cAAQ,KAAR,cAAQ,QAGxB;AACL,CAAC,EAfgB,KAAK,qBAAL,KAAK,QAerB"}

package/dist/chu/lib/adapter/index.d.ts

@@ -1,39 +1,53 @@
 import { IScore } from "../../type";
-import axios, { AxiosInstance } from "axios";
-export declare abstract class ScoreTrackerAdapter {
-    private static _cache;
-    protected get cache(): import("memory-cache").CacheClass<unknown, unknown>;
-    protected axios: AxiosInstance;
-    constructor({ baseURL }?: {
-        baseURL?: string;
-    });
-    private readonly MAX_LOG_LENGTH;
-    protected get<T>(endpoint: string, data?: any, 
-    /**
-     * Cache TTL in milliseconds. Defaults to 30 minutes.
-     */
-    cacheTTL?: number, options?: axios.AxiosRequestConfig): Promise<T | undefined>;
-    protected post<T>(endpoint: string, data?: any): Promise<T | undefined>;
-    abstract getPlayerRecent40(username: string): Promise<{
+import { BaseScoreAdapter } from "../../../lib/adapter";
+import Util from "../../../lib/util";
+type IBaseResponseData = {
+    unknown: null;
+};
+type IRecent40ResponseData = IBaseResponseData & {
+    success: {
         recent: IScore[];
         best: IScore[];
-    } | null>;
-    abstract getPlayerBest50(username: string): Promise<{
+    };
+};
+type IBest50ResponseData = IBaseResponseData & {
+    success: {
         new: IScore[];
         old: IScore[];
         best?: IScore[];
-    } | null>;
-    abstract getPlayerInfo(username: string, type: "new" | "recents"): Promise<{
+    };
+};
+type IProfileResponseData = IBaseResponseData & {
+    success: {
         name: string;
         rating: number;
-    } | null>;
-    abstract getPlayerProfilePicture(username: string): Promise<Buffer | null>;
-    abstract getPlayerScore(username: string, chartId: number): Promise<{
+    };
+};
+type IProfilePictureResponseData = IBaseResponseData & {
+    success: Buffer;
+};
+type IScoreResponseData = IBaseResponseData & {
+    success: {
         basic: IScore | null;
         advanced: IScore | null;
         expert: IScore | null;
         master: IScore | null;
         ultima: IScore | null;
         worldsEnd: IScore | null;
-    }>;
+    };
+};
+type IResponseData = {
+    recent40: IRecent40ResponseData;
+    best50: IBest50ResponseData;
+    profile: IProfileResponseData;
+    profilePicture: IProfilePictureResponseData;
+    score: IScoreResponseData;
+};
+export declare abstract class ChunithmScoreAdapter<IExtraReturnTypes extends Partial<Record<keyof IResponseData, Record<string, unknown>>> = {}> extends BaseScoreAdapter {
+    abstract getPlayerRecent40(username: string): Promise<Util.ResponseOf<Util.MergeExtraTypes<IResponseData, IExtraReturnTypes>["recent40"]>>;
+    abstract getPlayerBest50(username: string): Promise<Util.ResponseOf<Util.MergeExtraTypes<IResponseData, IExtraReturnTypes>["best50"]>>;
+    abstract getPlayerInfo(username: string, type: "new" | "recents"): Promise<Util.ResponseOf<Util.MergeExtraTypes<IResponseData, IExtraReturnTypes>["profile"]>>;
+    abstract getPlayerProfilePicture(username: string): Promise<Util.ResponseOf<Util.MergeExtraTypes<IResponseData, IExtraReturnTypes>["profilePicture"]>>;
+    abstract getPlayerScore(username: string, chartId: number): Promise<Util.ResponseOf<Util.MergeExtraTypes<IResponseData, IExtraReturnTypes>["score"]>>;
 }
+export {};

package/dist/chu/lib/adapter/index.js

@@ -1,69 +1,8 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ScoreTrackerAdapter = void 0;
-const chu_1 = require("../..");
-const axios_1 = __importDefault(require("axios"));
-const memory_cache_1 = require("memory-cache");
-class ScoreTrackerAdapter {
-    static _cache = new memory_cache_1.Cache();
-    get cache() {
-        return ScoreTrackerAdapter._cache;
-    }
-    axios;
-    constructor({ baseURL } = {}) {
-        this.axios = axios_1.default.create({ baseURL });
-    }
-    MAX_LOG_LENGTH = 1000;
-    async get(endpoint, data, 
-    /**
-     * Cache TTL in milliseconds. Defaults to 30 minutes.
-     */
-    cacheTTL = 30 * 60 * 1000, options = {}) {
-        const cacheKey = `${this.axios.defaults.baseURL}${endpoint}${data
-            ? `-${JSON.stringify(data).substring(0, this.MAX_LOG_LENGTH)}`
-            : ""}`;
-        if (cacheTTL > 0) {
-            const cacheContent = await this.cache.get(cacheKey);
-            if (cacheContent) {
-                chu_1.Chuni.logger.trace(`GET ${endpoint}${data
-                    ? ` ${JSON.stringify(data).substring(0, this.MAX_LOG_LENGTH)}`
-                    : ""}, cache HIT`);
-                return cacheContent;
-            }
-        }
-        const beginTimestamp = Date.now();
-        const res = await this.axios
-            .get(endpoint, { params: data, ...options })
-            .then(async (r) => {
-            if (cacheTTL > 0) {
-                await this.cache.put(cacheKey, r.data, cacheTTL);
-            }
-            return r.data;
-        })
-            .catch((e) => {
-            return e.response?.data || e;
-        });
-        const timeDifference = Date.now() - beginTimestamp;
-        chu_1.Chuni.logger.trace(`GET ${endpoint}${data
-            ? ` ${JSON.stringify(data).substring(0, this.MAX_LOG_LENGTH)}`
-            : ""}, cache MISS, took ${timeDifference}ms`);
-        return res;
-    }
-    async post(endpoint, data) {
-        const beginTimestamp = Date.now();
-        const res = await this.axios
-            .post(endpoint, data)
-            .then((r) => r.data)
-            .catch((e) => e.response?.data);
-        const timeDifference = Date.now() - beginTimestamp;
-        chu_1.Chuni.logger.trace(`POST ${endpoint}${data
-            ? ` ${JSON.stringify(data).substring(0, this.MAX_LOG_LENGTH)}`
-            : ""}, took ${timeDifference}ms`);
-        return res;
-    }
+exports.ChunithmScoreAdapter = void 0;
+const adapter_1 = require("../../../lib/adapter");
+class ChunithmScoreAdapter extends adapter_1.BaseScoreAdapter {
 }
-exports.ScoreTrackerAdapter = ScoreTrackerAdapter;
+exports.ChunithmScoreAdapter = ChunithmScoreAdapter;
 //# sourceMappingURL=index.js.map

package/dist/chu/lib/adapter/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/chu/lib/adapter/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/chu/lib/adapter/index.ts"],"names":[],"mappings":";;;AACA,kDAAwD;AAgDxD,MAAsB,oBAIpB,SAAQ,0BAAgB;CAyCzB;AA7CD,oDA6CC"}

package/dist/chu/lib/adapter/kamaiTachi/index.d.ts

@@ -1,18 +1,52 @@
-import { ScoreTrackerAdapter } from "..";
+import { ChunithmScoreAdapter } from "..";
 import { IScore } from "../../../type";
-export declare class KamaiTachi extends ScoreTrackerAdapter {
+type IBest50ResponseData = {
+    "invalid-user": {
+        username: string;
+    };
+};
+type IRecent40ResponseData = IBest50ResponseData & {};
+type IProfileResponseData = IBest50ResponseData & {
+    "invalid-type": {
+        type: string;
+    };
+};
+type IProfilePictureResponseData = IBest50ResponseData & {};
+type IScoreResponseData = IBest50ResponseData & {};
+type IResponseData = {
+    recent40: IRecent40ResponseData;
+    best50: IBest50ResponseData;
+    profile: IProfileResponseData;
+    profilePicture: IProfilePictureResponseData;
+    score: IScoreResponseData;
+};
+export declare class KamaiTachi extends ChunithmScoreAdapter<IResponseData> {
     private readonly CURRENT_VERSION;
     constructor({ baseURL, currentVersion, }?: {
         baseURL?: string;
         currentVersion?: KamaiTachi.EGameVersions;
     });
     getPlayerScore(username: string, chartId: number): Promise<{
-        basic: IScore | null;
-        advanced: IScore | null;
-        expert: IScore | null;
-        master: IScore | null;
-        ultima: IScore | null;
-        worldsEnd: IScore | null;
+        readonly status: "invalid-user";
+        readonly message: string;
+        readonly data: {
+            readonly username: string;
+        };
+    } | {
+        readonly status: "unknown";
+        readonly message: string;
+        readonly data: null;
+    } | {
+        readonly status: "success";
+        readonly message: "";
+        readonly data: {
+            readonly basic: IScore | null;
+            readonly advanced: IScore | null;
+            readonly expert: IScore | null;
+            readonly master: IScore | null;
+            readonly ultima: IScore | null;
+            readonly worldsEnd: IScore | null;
+        };
     }>;
     getPlayerPB(userId: string): Promise<KamaiTachi.IResponse<{
         charts: KamaiTachi.IChart[];
@@ -29,20 +63,82 @@ export declare class KamaiTachi extends ScoreTrackerAdapter {
     private toMaiDrawScore;
     private getDatabaseVersion;
     getPlayerBest50(userId: string, currentVersion?: KamaiTachi.EGameVersions, omnimix?: boolean): Promise<{
-        new: IScore[];
-        old: IScore[];
-        best: IScore[];
-    } | null>;
+        readonly status: "invalid-user";
+        readonly message: string;
+        readonly data: {
+            readonly username: string;
+        };
+    } | {
+        readonly status: "unknown";
+        readonly message: string;
+        readonly data: null;
+    } | {
+        readonly status: "success";
+        readonly message: "";
+        readonly data: {
+            readonly new: IScore[];
+            readonly old: IScore[];
+            readonly best: IScore[];
+        };
+    }>;
     getPlayerRecent40(userId: string, currentVersion?: KamaiTachi.EGameVersions, omnimix?: boolean): Promise<{
-        recent: IScore[];
-        best: IScore[];
-    } | null>;
+        readonly status: "invalid-user";
+        readonly message: string;
+        readonly data: {
+            readonly username: string;
+        };
+    } | {
+        readonly status: "unknown";
+        readonly message: string;
+        readonly data: null;
+    } | {
+        readonly status: "success";
+        readonly message: "";
+        readonly data: {
+            readonly recent: IScore[];
+            readonly best: IScore[];
+        };
+    }>;
     getPlayerInfo(userId: string, type: "new" | "recents"): Promise<{
-        name: string;
-        rating: number;
-    } | null>;
+        readonly status: "invalid-user";
+        readonly message: string;
+        readonly data: {
+            readonly username: string;
+        };
+    } | {
+        readonly status: "unknown";
+        readonly message: string;
+        readonly data: null;
+    } | {
+        readonly status: "success";
+        readonly message: "";
+        readonly data: {
+            readonly name: string;
+            readonly rating: number;
+        };
+    } | {
+        readonly status: "invalid-type";
+        readonly message: string;
+        readonly data: {
+            readonly type: string;
+        };
+    }>;
     private getPlayerProfileRaw;
-    getPlayerProfilePicture(userId: string): Promise<Buffer | null>;
+    getPlayerProfilePicture(userId: string): Promise<{
+        readonly status: "invalid-user";
+        readonly message: string;
+        readonly data: {
+            readonly username: string;
+        };
+    } | {
+        readonly status: "unknown";
+        readonly message: string;
+        readonly data: null;
+    } | {
+        readonly status: "success";
+        readonly message: "";
+        readonly data: Buffer;
+    }>;
     chunithm(): KamaiTachi;
     plus(): KamaiTachi;
     air(): KamaiTachi;
@@ -67,12 +163,21 @@ export declare class KamaiTachi extends ScoreTrackerAdapter {
     xverse(): KamaiTachi;
 }
 export declare namespace KamaiTachi {
-    interface IResponse<T> {
+    interface IBaseResponse {
         success: boolean;
         description: string;
+    }
+    export interface ISuccessResponse<T> extends IBaseResponse {
+        success: true;
+        description: string;
         body: T;
     }
-    interface IChart {
+    export interface IFailureResponse extends IBaseResponse {
+        success: false;
+        description: string;
+    }
+    export type IResponse<T> = ISuccessResponse<T> | IFailureResponse;
+    export interface IChart {
         chartID: string;
         data: {
             inGameID: number;
@@ -85,7 +190,7 @@ export declare namespace KamaiTachi {
         songID: number;
         versions: string[];
     }
-    interface ISong {
+    export interface ISong {
         altTitles: string[];
         artist: string;
         data: {
@@ -96,7 +201,7 @@ export declare namespace KamaiTachi {
         searchTerms: string[];
         title: string;
     }
-    interface IScore {
+    export interface IScore {
         chartID: string;
         userID: number;
         calculatedData: {
@@ -139,7 +244,7 @@ export declare namespace KamaiTachi {
         timeAchieved: number;
         service: string;
     }
-    interface IPb {
+    export interface IPb {
         chartID: string;
         userID: number;
         calculatedData: {
@@ -187,7 +292,7 @@ export declare namespace KamaiTachi {
             scoreID: string;
         }[];
     }
-    enum EGameVersions {
+    export enum EGameVersions {
         CHUNITHM_XVERSE = "CHUNITHM X-VERSE",
         CHUNITHM_VERSE = "CHUNITHM VERSE",
         CHUNITHM_LUMINOUS_PLUS = "CHUNITHM LUMINOUS PLUS",
@@ -218,5 +323,7 @@ export declare namespace KamaiTachi {
      * @param b Game version.
      * @returns positive if a is newer, negative if b is newer, 0 if they are the same.
      */
-    function compareGameVersions(a: EGameVersions, b: EGameVersions): number;
+    export function compareGameVersions(a: EGameVersions, b: EGameVersions): number;
+    export {};
 }
+export {};