maplestory-openapi 2.12.1 → 2.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maplestory-openapi",
-  "version": "2.12.1",
+  "version": "2.13.0",
   "description": "This JavaScript library enables the use of the MapleStory OpenAPI of Nexon.",
   "keywords": [
     "maplestory",

package/types/maplestory/api/mapleStoryApi.d.ts

@@ -41,9 +41,9 @@ import { OverallRankingResponseDto } from './dto/ranking/overallRankingResponseD
 import { TheSeedRankingResponseDto } from './dto/ranking/theSeedRankingResponseDto';
 import { UnionRankingResponseDto } from './dto/ranking/unionRankingResponseDto';
 import { UnionArtifactDto } from './dto/union/unionArtifactDto';
+import { UnionChampionDto } from './dto/union/unionChampionDto';
 import { UnionDto } from './dto/union/unionDto';
 import { UnionRaiderDto } from './dto/union/unionRaiderDto';
-import { UnionChampionDto } from './dto/union/unionChampionDto';
 /**
  * MapleStory OpenAPI client.<br>
  * This is an implementation of <a href="https://openapi.nexon.com/game/maplestory">MapleStory API</a>
@@ -53,7 +53,6 @@ declare class MapleStoryApi {
     private readonly client;
     private static readonly BASE_URL;
     private static readonly DEFAULT_TIMEOUT;
-    private static readonly kstOffset;
     get timeout(): number;
     set timeout(value: number);
     constructor(apiKey: string);
@@ -402,18 +401,16 @@ declare class MapleStoryApi {
     getStarforceHistory(count: number, cursor: string): Promise<StarforceHistoryResponseDto>;
     /**
      * 큐브 사용 결과를 조회합니다.
-     * - 데이터는 매일 오전 4시, 전일 데이터가 갱신됩니다.
-     * - e.g. 오늘 오후 3시 5분 큐브 확률 정보 조회 시, 어제의 큐브 확률 정보 데이터를 조회할 수 있습니다.
-     * - 2022년 11월 25일 데이터부터 조회할 수 있습니다.
+     * - 큐브 확률 정보는 최대 30분 후 확인 가능합니다.
+     * - 큐브 사용 결과는 최근 2년 데이터만 조회 가능합니다.
      *
      * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000)
      */
     getCubeHistory(count: number): Promise<CubeHistoryResponseDto>;
     /**
      * 지목한 날짜의 큐브 사용 결과를 조회합니다.
-     * - 데이터는 매일 오전 4시, 전일 데이터가 갱신됩니다.
-     * - e.g. 오늘 오후 3시 5분 큐브 확률 정보 조회 시, 어제의 큐브 확률 정보 데이터를 조회할 수 있습니다.
-     * - 2022년 11월 25일 데이터부터 조회할 수 있습니다.
+     * - 큐브 확률 정보는 최대 30분 후 확인 가능합니다.
+     * - 큐브 사용 결과는 최근 2년 데이터만 조회 가능합니다.
      *
      * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000)
      * @param dateOptions 조회 기준일 (KST)
@@ -421,9 +418,8 @@ declare class MapleStoryApi {
     getCubeHistory(count: number, dateOptions: DateOptions): Promise<CubeHistoryResponseDto>;
     /**
      * 큐브 사용 결과를 조회합니다.
-     * - 데이터는 매일 오전 4시, 전일 데이터가 갱신됩니다.
-     * - e.g. 오늘 오후 3시 5분 큐브 확률 정보 조회 시, 어제의 큐브 확률 정보 데이터를 조회할 수 있습니다.
-     * - 2022년 11월 25일 데이터부터 조회할 수 있습니다.
+     * - 큐브 확률 정보는 최대 30분 후 확인 가능합니다.
+     * - 큐브 사용 결과는 최근 2년 데이터만 조회 가능합니다.
      *
      * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000)
      * @param cursor 페이징 처리를 위한 cursor
@@ -431,18 +427,16 @@ declare class MapleStoryApi {
     getCubeHistory(count: number, cursor: string): Promise<CubeHistoryResponseDto>;
     /**
      * 잠재능력 재설정 이용 결과를 조회합니다.
-     * - 데이터는 매일 오전 4시, 전일 데이터가 갱신됩니다.
-     * - e.g. 오늘 오후 3시 5분 잠재능력 재설정 정보 조회 시, 어제의 잠재능력 재설정 정보 데이터를 조회할 수 있습니다.
-     * - 2024년 1월 25일 데이터부터 조회할 수 있습니다.
+     * - 잠재능력 재설정 정보는 최대 30분 후 확인 가능합니다.
+     * - 잠재능력 재설정 이용 결과는 2024년 01월 25일 데이터부터 조회 가능하며, 최대 2년동안의 데이터만 제공됩니다.
      *
      * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000)
      */
     getPotentialHistory(count: number): Promise<PotentialHistoryResponseDto>;
     /**
      * 지목한 날짜의 잠재능력 재설정 이용 결과를 조회합니다.
-     * - 데이터는 매일 오전 4시, 전일 데이터가 갱신됩니다.
-     * - e.g. 오늘 오후 3시 5분 잠재능력 재설정 정보 조회 시, 어제의 잠재능력 재설정 정보 데이터를 조회할 수 있습니다.
-     * - 2024년 1월 25일 데이터부터 조회할 수 있습니다.
+     * - 잠재능력 재설정 정보는 최대 30분 후 확인 가능합니다.
+     * - 잠재능력 재설정 이용 결과는 2024년 01월 25일 데이터부터 조회 가능하며, 최대 2년동안의 데이터만 제공됩니다.
      *
      * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000)
      * @param dateOptions 조회 기준일 (KST)
@@ -450,9 +444,8 @@ declare class MapleStoryApi {
     getPotentialHistory(count: number, dateOptions: DateOptions): Promise<PotentialHistoryResponseDto>;
     /**
      * 잠재능력 재설정 이용 결과를 조회합니다.
-     * - 데이터는 매일 오전 4시, 전일 데이터가 갱신됩니다.
-     * - e.g. 오늘 오후 3시 5분 잠재능력 재설정 정보 조회 시, 어제의 잠재능력 재설정 정보 데이터를 조회할 수 있습니다.
-     * - 2024년 1월 25일 데이터부터 조회할 수 있습니다.
+     * - 잠재능력 재설정 정보는 최대 30분 후 확인 가능합니다.
+     * - 잠재능력 재설정 이용 결과는 2024년 01월 25일 데이터부터 조회 가능하며, 최대 2년동안의 데이터만 제공됩니다.
      *
      * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000)
      * @param cursor 페이징 처리를 위한 cursor
@@ -583,21 +576,6 @@ declare class MapleStoryApi {
      * 서버 점검 정보를 조회합니다.
      */
     getInspectionInfo(): Promise<InspectionInfoDto>;
-    /**
-     * API 서버의 데이터 갱신 시간에 따라 데이터가 조회 가능한 최신 날짜를 반환합니다.
-     *
-     * @param options
-     * @private
-     */
-    private static getProperDefaultDateOptions;
-    /**
-     * 날짜 정보를 API 서버에서 요구하는 포맷으로 변환합니다.
-     *
-     * @param minDateOptions API 호출 가능한 최소 날짜
-     * @param dateOptions 조회 하려는 날짜
-     * @private
-     */
-    private static toDateString;
 }
 type CharacterImageOptions = {
     /**