maplestory-openapi 3.5.0 → 3.6.0

package/README.md

@@ -113,6 +113,7 @@ This library supports all apis published in the MapleStory OpenAPI official docs
 Some features are supported only in specific regions. Please refer to the official documentation for each region for details.
 
 - KMS: [https://openapi.nexon.com/game/maplestory](https://openapi.nexon.com/game/maplestory)
+- KMS(for Nexon Friends Exclusive APIs): [https://openapi.nexon.com/ko/friends/maplestory](https://openapi.nexon.com/ko/friends/maplestory)
 - TMS: [https://openapi.nexon.com/game/maplestorytw](https://openapi.nexon.com/game/maplestorytw)
 - MSEA: [https://openapi.nexon.com/game/maplestorysea](https://openapi.nexon.com/game/maplestorysea)
 

package/dist/cjs/_virtual/index.js_commonjs-exports2.js

@@ -2,6 +2,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var ieee754 = {};
+var base64Js = {};
 
-exports.__exports = ieee754;
+exports.__exports = base64Js;

package/dist/cjs/_virtual/index.js_commonjs-exports3.js

@@ -2,6 +2,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var base64Js = {};
+var ieee754 = {};
 
-exports.__exports = base64Js;
+exports.__exports = ieee754;

package/dist/cjs/maplestory/api/common/lib.js

@@ -22,5 +22,21 @@ const potentialOptionGradeFromString = (text) => {
     }
     return grade;
 };
+/**
+ * URL에서 Query를 제거합니다.
+ * @param url URL
+ * @example
+ * ```
+ * removeQuery('https://example.com/path?query=123&test=abc') // returns 'https://example.com/path'
+ * ```
+ */
+const removeQuery = (url) => {
+    if (!url) {
+        return url;
+    }
+    const queryIndex = url.indexOf('?');
+    return queryIndex >= 0 ? url.substring(0, queryIndex) : url;
+};
 
 exports.potentialOptionGradeFromString = potentialOptionGradeFromString;
+exports.removeQuery = removeQuery;

package/dist/cjs/maplestory/api/common/mapleStoryApiError.js

@@ -33,6 +33,7 @@ exports.MapleStoryApiErrorCode = void 0;
     MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00009"] = 7] = "OPENAPI00009";
     MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00010"] = 8] = "OPENAPI00010";
     MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00011"] = 9] = "OPENAPI00011";
+    MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00012"] = 10] = "OPENAPI00012";
 })(exports.MapleStoryApiErrorCode || (exports.MapleStoryApiErrorCode = {}));
 const ERROR_MAP = {
     ['OPENAPI00001']: exports.MapleStoryApiErrorCode.OPENAPI00001,
@@ -45,6 +46,7 @@ const ERROR_MAP = {
     ['OPENAPI00009']: exports.MapleStoryApiErrorCode.OPENAPI00009,
     ['OPENAPI00010']: exports.MapleStoryApiErrorCode.OPENAPI00010,
     ['OPENAPI00011']: exports.MapleStoryApiErrorCode.OPENAPI00011,
+    ['OPENAPI00012']: exports.MapleStoryApiErrorCode.OPENAPI00012,
 };
 
 exports.MapleStoryApiError = MapleStoryApiError;

package/dist/cjs/maplestory/api/common/mapleStoryFriendsApi.js

@@ -0,0 +1,120 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var axios = require('axios');
+var dayjs = require('dayjs');
+var timezone = require('../../../node_modules/dayjs/plugin/timezone.js');
+var utc = require('../../../node_modules/dayjs/plugin/utc.js');
+var mapleStoryApiError = require('./mapleStoryApiError.js');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var axios__default = /*#__PURE__*/_interopDefaultLegacy(axios);
+var dayjs__default = /*#__PURE__*/_interopDefaultLegacy(dayjs);
+
+dayjs__default["default"].extend(timezone);
+dayjs__default["default"].extend(utc);
+/**
+ * MapleStory Friends API client.
+ */
+class MapleStoryFriendsApi {
+    accessToken;
+    client;
+    static BASE_URL = 'https://open.api.nexon.com/';
+    static DEFAULT_TIMEOUT = 5000;
+    get timeout() {
+        return this.client.defaults.timeout;
+    }
+    set timeout(value) {
+        this.client.defaults.timeout = value;
+    }
+    constructor(accessToken) {
+        this.accessToken = accessToken;
+        this.client = axios__default["default"].create({
+            baseURL: MapleStoryFriendsApi.BASE_URL,
+            timeout: MapleStoryFriendsApi.DEFAULT_TIMEOUT,
+            headers: {
+                'Authorization': `Bearer ${this.accessToken}`,
+            },
+        });
+        this.client.interceptors.response.use((response) => response, (error) => {
+            if (error instanceof axios.AxiosError) {
+                const errorBody = error.response
+                    .data;
+                throw new mapleStoryApiError.MapleStoryApiError(errorBody);
+            }
+            throw error;
+        });
+    }
+    /**
+     * API 서버의 데이터 갱신 시간에 따라 데이터가 조회 가능한 최신 날짜를 반환합니다.
+     *
+     * @param options
+     */
+    getProperDefaultDateOptions(options) {
+        const { hour, minute, dateOffset } = options;
+        const nowInTimezone = dayjs__default["default"]().utcOffset(this.timezoneOffset);
+        const updateDate = dayjs__default["default"]().utcOffset(this.timezoneOffset).hour(hour).minute(minute);
+        let adjustedDate;
+        if (nowInTimezone.isAfter(updateDate)) {
+            adjustedDate = nowInTimezone;
+        }
+        else {
+            adjustedDate = nowInTimezone.subtract(1, 'day');
+        }
+        adjustedDate = adjustedDate.subtract(dateOffset ?? 0, 'day');
+        return {
+            year: adjustedDate.year(),
+            month: adjustedDate.month() + 1,
+            day: adjustedDate.date(),
+        };
+    }
+    ;
+    /**
+     * 날짜 정보를 API 서버에서 요구하는 포맷으로 변환합니다.
+     *
+     * @param dateOptions 조회 하려는 날짜
+     * @param minDateOptions API 호출 가능한 최소 날짜
+     */
+    toDateString(dateOptions, minDateOptions) {
+        const convert = (dateOptions) => {
+            let year;
+            let month;
+            let day;
+            let d;
+            if (dateOptions instanceof Date) {
+                d = dayjs__default["default"](dateOptions).utcOffset(this.timezoneOffset);
+                year = d.year();
+                month = d.month() + 1;
+                day = d.date();
+            }
+            else {
+                year = dateOptions.year;
+                month = dateOptions.month;
+                day = dateOptions.day;
+                d = dayjs__default["default"](`${year}-${month}-${day}`).utcOffset(this.timezoneOffset);
+            }
+            return {
+                year,
+                month,
+                day,
+                d,
+            };
+        };
+        const { year, month, day, d } = convert(dateOptions);
+        const str = d.format('YYYY-MM-DD');
+        if (minDateOptions) {
+            const { year: minYear, month: minMonth, day: minDay, } = convert(minDateOptions);
+            if (year < minYear ||
+                (year === minYear && month < minMonth) ||
+                (year === minYear && month === minMonth && day < minDay)) {
+                throw new Error(`You can only retrieve data after ${dayjs__default["default"](`${minYear}-${minMonth}-${minDay}`).format('YYYY-MM-DD')}.`);
+            }
+        }
+        return str;
+    }
+    ;
+}
+
+exports.MapleStoryFriendsApi = MapleStoryFriendsApi;

package/dist/cjs/maplestory/api/kms/dto/character/characterBasic.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var characterBasic = require('../../../common/dto/character/characterBasic.js');
+var lib = require('../../../common/lib.js');
 
 /**
  * 캐릭터 기본 정보
@@ -77,7 +78,7 @@ class CharacterBasicDto extends characterBasic.CharacterBasicDto {
         this.characterExp = character_exp;
         this.characterExpRate = character_exp_rate;
         this.characterGuildName = character_guild_name;
-        this.characterImage = character_image;
+        this.characterImage = lib.removeQuery(character_image);
         this.characterDateCreate = character_date_create ? new Date(character_date_create) : null;
         this.accessFlag = access_flag;
         this.liberationQuestClear = liberation_quest_clear;

package/dist/cjs/maplestory/api/kms/kms.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var mapleStoryApi = require('./mapleStoryApi.js');
+var mapleStoryFriendsApi = require('./mapleStoryFriendsApi.js');
 var character = require('./dto/character/character.js');
 var characterAbility = require('./dto/character/characterAbility.js');
 var characterAndroidEquipment = require('./dto/character/characterAndroidEquipment.js');
@@ -55,6 +56,7 @@ var inspectionInfo = require('./dto/inspectionInfo.js');
 
 
 exports.MapleStoryApi = mapleStoryApi.MapleStoryApi;
+exports.MapleStoryFriendsApi = mapleStoryFriendsApi.MapleStoryFriendsApi;
 exports.CharacterDto = character.CharacterDto;
 exports.CharacterAbilityDto = characterAbility.CharacterAbilityDto;
 exports.CharacterAbilityInfoDto = characterAbility.CharacterAbilityInfoDto;

package/dist/cjs/maplestory/api/kms/mapleStoryApi.js

@@ -56,6 +56,7 @@ var achievement = require('./dto/user/achievement.js');
 var characterList = require('./dto/user/characterList.js');
 var characterImage = require('../common/enum/characterImage.js');
 var mapleStoryApi = require('../common/mapleStoryApi.js');
+var lib = require('../common/lib.js');
 var index = require('../../../_virtual/index.js_commonjs-exports.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
@@ -168,7 +169,7 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         if (!basic) {
             return null;
         }
-        const { date, characterImage: path } = basic;
+        const { date, characterImage: characterImage$2 } = basic;
         const action = imageOptions?.action ?? characterImage.CharacterImageAction.Stand1;
         const emotion = imageOptions?.emotion ?? characterImage.CharacterImageEmotion.Default;
         const wmotion = imageOptions?.wmotion ?? characterImage.CharacterImageWeaponMotion.Default;
@@ -178,6 +179,7 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         const height = 300;
         const x = 150;
         const y = 200;
+        const path = lib.removeQuery(characterImage$2);
         const query = {
             action: `${action}.${actionFrame}`,
             emotion: `${emotion}.${emotionFrame}`,

package/dist/cjs/maplestory/api/kms/mapleStoryFriendsApi.js

@@ -0,0 +1,116 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var cubeHistory = require('./dto/history/cubeHistory.js');
+var potentialHistory = require('./dto/history/potentialHistory.js');
+var starforceHistory = require('./dto/history/starforceHistory.js');
+var achievement = require('./dto/user/achievement.js');
+var characterList = require('./dto/user/characterList.js');
+var mapleStoryFriendsApi = require('../common/mapleStoryFriendsApi.js');
+
+/**
+ * MapleStory Friends API client for KMS<br>
+ * This is an implementation of <a href="https://openapi.nexon.com/ko/friends/maplestory/?id=36">MapleStory Friends API</a>
+ */
+class MapleStoryFriendsApi extends mapleStoryFriendsApi.MapleStoryFriendsApi {
+    subUrl = 'maplestory';
+    timezoneOffset = 540;
+    constructor(accessToken) {
+        super(accessToken);
+    }
+    //#region 계정 정보 조회
+    /**
+     * 계정의 보유 캐릭터 목록을 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '캐릭터 목록'을 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     */
+    async getCharacterList() {
+        const path = `${this.subUrl}/v1/character/list`;
+        const { data } = await this.client.get(path);
+        return new characterList.CharacterListDto(data);
+    }
+    /**
+     * 계정의 업적 정보를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '업적 정보'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     */
+    async getAchievement() {
+        const path = `${this.subUrl}/v1/user/achievement`;
+        const { data } = await this.client.get(path);
+        return new achievement.AchievementDto(data);
+    }
+    async getStarforceHistory(count, parameter) {
+        const path = `${this.subUrl}/v1/history/starforce`;
+        const query = {
+            count,
+        };
+        if (typeof parameter === 'string') {
+            query.cursor = parameter;
+        }
+        else if (typeof parameter === 'object' || parameter === undefined) {
+            query.date = this.toDateString(parameter ??
+                this.getProperDefaultDateOptions({
+                    hour: 0,
+                    minute: 0,
+                    dateOffset: 0,
+                }), {
+                year: 2023,
+                month: 12,
+                day: 27,
+            });
+        }
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new starforceHistory.StarforceHistoryResponseDto(data);
+    }
+    async getCubeHistory(count, parameter) {
+        const path = `${this.subUrl}/v1/history/cube`;
+        const query = {
+            count,
+        };
+        if (typeof parameter === 'string') {
+            query.cursor = parameter;
+        }
+        else if (typeof parameter === 'object' || parameter === undefined) {
+            query.date = this.toDateString(parameter ??
+                this.getProperDefaultDateOptions({
+                    hour: 0,
+                    minute: 0,
+                    dateOffset: 0,
+                }));
+        }
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new cubeHistory.CubeHistoryResponseDto(data);
+    }
+    async getPotentialHistory(count, parameter) {
+        const path = `${this.subUrl}/v1/history/potential`;
+        const query = {
+            count,
+        };
+        if (typeof parameter === 'string') {
+            query.cursor = parameter;
+        }
+        else if (typeof parameter === 'object' || parameter === undefined) {
+            query.date = this.toDateString(parameter ??
+                this.getProperDefaultDateOptions({
+                    hour: 0,
+                    minute: 0,
+                    dateOffset: 0,
+                }), {
+                year: 2024,
+                month: 1,
+                day: 25,
+            });
+        }
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new potentialHistory.PotentialHistoryResponseDto(data);
+    }
+}
+
+exports.MapleStoryFriendsApi = MapleStoryFriendsApi;

package/dist/cjs/maplestory/api/msea/dto/character/characterBasic.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var characterBasic = require('../../../common/dto/character/characterBasic.js');
+var lib = require('../../../common/lib.js');
 
 /**
  * Character basic information
@@ -77,7 +78,7 @@ class CharacterBasicDto extends characterBasic.CharacterBasicDto {
         this.characterExp = character_exp;
         this.characterExpRate = character_exp_rate;
         this.characterGuildName = character_guild_name;
-        this.characterImage = character_image;
+        this.characterImage = lib.removeQuery(character_image);
         this.characterDateCreate = character_date_create ? new Date(character_date_create) : null;
         this.accessFlag = access_flag;
         this.liberationQuestClearFlag = liberation_quest_clear_flag;

package/dist/cjs/maplestory/api/msea/mapleStoryApi.js

@@ -32,6 +32,7 @@ var unionArtifact = require('./dto/union/unionArtifact.js');
 var unionRaider = require('./dto/union/unionRaider.js');
 var characterImage = require('../common/enum/characterImage.js');
 var mapleStoryApi = require('../common/mapleStoryApi.js');
+var lib = require('../common/lib.js');
 var index = require('../../../_virtual/index.js_commonjs-exports.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
@@ -114,7 +115,7 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         if (!basic) {
             return null;
         }
-        const { date, characterImage: path } = basic;
+        const { date, characterImage: characterImage$2 } = basic;
         const action = imageOptions?.action ?? characterImage.CharacterImageAction.Stand1;
         const emotion = imageOptions?.emotion ?? characterImage.CharacterImageEmotion.Default;
         const wmotion = imageOptions?.wmotion ?? characterImage.CharacterImageWeaponMotion.Default;
@@ -124,6 +125,7 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         const height = 96;
         const x = imageOptions?.x ?? null;
         const y = imageOptions?.y ?? null;
+        const path = lib.removeQuery(characterImage$2);
         const query = {
             action: `${action}.${actionFrame}`,
             emotion: `${emotion}.${emotionFrame}`,

package/dist/cjs/maplestory/api/tms/dto/character/characterBasic.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var characterBasic = require('../../../common/dto/character/characterBasic.js');
+var lib = require('../../../common/lib.js');
 
 /**
  * 角色基本資訊
@@ -77,7 +78,7 @@ class CharacterBasicDto extends characterBasic.CharacterBasicDto {
         this.characterExp = character_exp;
         this.characterExpRate = character_exp_rate;
         this.characterGuildName = character_guild_name;
-        this.characterImage = character_image;
+        this.characterImage = lib.removeQuery(character_image);
         this.characterDateCreate = character_date_create ? new Date(character_date_create) : null;
         this.accessFlag = access_flag;
         this.liberationQuestClear = liberation_quest_clear;

package/dist/cjs/maplestory/api/tms/mapleStoryApi.js

@@ -32,6 +32,7 @@ var unionArtifact = require('./dto/union/unionArtifact.js');
 var unionRaider = require('./dto/union/unionRaider.js');
 var characterImage = require('../common/enum/characterImage.js');
 var mapleStoryApi = require('../common/mapleStoryApi.js');
+var lib = require('../common/lib.js');
 var index = require('../../../_virtual/index.js_commonjs-exports.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
@@ -114,7 +115,7 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         if (!basic) {
             return null;
         }
-        const { date, characterImage: path } = basic;
+        const { date, characterImage: characterImage$2 } = basic;
         const action = imageOptions?.action ?? characterImage.CharacterImageAction.Stand1;
         const emotion = imageOptions?.emotion ?? characterImage.CharacterImageEmotion.Default;
         const wmotion = imageOptions?.wmotion ?? characterImage.CharacterImageWeaponMotion.Default;
@@ -124,6 +125,7 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         const height = 96;
         const x = imageOptions?.x ?? null;
         const y = imageOptions?.y ?? null;
+        const path = lib.removeQuery(characterImage$2);
         const query = {
             action: `${action}.${actionFrame}`,
             emotion: `${emotion}.${emotionFrame}`,

package/dist/cjs/node_modules/base64-js/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('../../_virtual/index.js_commonjs-exports3.js');
+var index = require('../../_virtual/index.js_commonjs-exports2.js');
 
 index.__exports.byteLength = byteLength;
 index.__exports.toByteArray = toByteArray;

package/dist/cjs/node_modules/buffer/index.js

@@ -3,8 +3,8 @@
 var index = require('../../_virtual/index.js_commonjs-exports.js');
 require('../base64-js/index.js');
 require('../ieee754/index.js');
-var index$1 = require('../../_virtual/index.js_commonjs-exports3.js');
-var index$2 = require('../../_virtual/index.js_commonjs-exports2.js');
+var index$1 = require('../../_virtual/index.js_commonjs-exports2.js');
+var index$2 = require('../../_virtual/index.js_commonjs-exports3.js');
 
 /*!
  * The buffer module from node.js, for the browser.

package/dist/cjs/node_modules/ieee754/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('../../_virtual/index.js_commonjs-exports2.js');
+var index = require('../../_virtual/index.js_commonjs-exports3.js');
 
 /*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */
 

package/dist/esm/_virtual/index.js_commonjs-exports2.js

@@ -1,3 +1,3 @@
-var ieee754 = {};
+var base64Js = {};
 
-export { ieee754 as __exports };
+export { base64Js as __exports };

package/dist/esm/_virtual/index.js_commonjs-exports3.js

@@ -1,3 +1,3 @@
-var base64Js = {};
+var ieee754 = {};
 
-export { base64Js as __exports };
+export { ieee754 as __exports };

package/dist/esm/maplestory/api/common/lib.js

@@ -18,5 +18,20 @@ const potentialOptionGradeFromString = (text) => {
     }
     return grade;
 };
+/**
+ * URL에서 Query를 제거합니다.
+ * @param url URL
+ * @example
+ * ```
+ * removeQuery('https://example.com/path?query=123&test=abc') // returns 'https://example.com/path'
+ * ```
+ */
+const removeQuery = (url) => {
+    if (!url) {
+        return url;
+    }
+    const queryIndex = url.indexOf('?');
+    return queryIndex >= 0 ? url.substring(0, queryIndex) : url;
+};
 
-export { potentialOptionGradeFromString };
+export { potentialOptionGradeFromString, removeQuery };

package/dist/esm/maplestory/api/common/mapleStoryApiError.js

@@ -29,6 +29,7 @@ var MapleStoryApiErrorCode;
     MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00009"] = 7] = "OPENAPI00009";
     MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00010"] = 8] = "OPENAPI00010";
     MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00011"] = 9] = "OPENAPI00011";
+    MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00012"] = 10] = "OPENAPI00012";
 })(MapleStoryApiErrorCode || (MapleStoryApiErrorCode = {}));
 const ERROR_MAP = {
     ['OPENAPI00001']: MapleStoryApiErrorCode.OPENAPI00001,
@@ -41,6 +42,7 @@ const ERROR_MAP = {
     ['OPENAPI00009']: MapleStoryApiErrorCode.OPENAPI00009,
     ['OPENAPI00010']: MapleStoryApiErrorCode.OPENAPI00010,
     ['OPENAPI00011']: MapleStoryApiErrorCode.OPENAPI00011,
+    ['OPENAPI00012']: MapleStoryApiErrorCode.OPENAPI00012,
 };
 
 export { MapleStoryApiError, MapleStoryApiErrorCode };

package/dist/esm/maplestory/api/common/mapleStoryFriendsApi.js

@@ -0,0 +1,111 @@
+import axios, { AxiosError } from 'axios';
+import dayjs from 'dayjs';
+import timezone from '../../../node_modules/dayjs/plugin/timezone.js';
+import utc from '../../../node_modules/dayjs/plugin/utc.js';
+import { MapleStoryApiError } from './mapleStoryApiError.js';
+
+dayjs.extend(timezone);
+dayjs.extend(utc);
+/**
+ * MapleStory Friends API client.
+ */
+class MapleStoryFriendsApi {
+    accessToken;
+    client;
+    static BASE_URL = 'https://open.api.nexon.com/';
+    static DEFAULT_TIMEOUT = 5000;
+    get timeout() {
+        return this.client.defaults.timeout;
+    }
+    set timeout(value) {
+        this.client.defaults.timeout = value;
+    }
+    constructor(accessToken) {
+        this.accessToken = accessToken;
+        this.client = axios.create({
+            baseURL: MapleStoryFriendsApi.BASE_URL,
+            timeout: MapleStoryFriendsApi.DEFAULT_TIMEOUT,
+            headers: {
+                'Authorization': `Bearer ${this.accessToken}`,
+            },
+        });
+        this.client.interceptors.response.use((response) => response, (error) => {
+            if (error instanceof AxiosError) {
+                const errorBody = error.response
+                    .data;
+                throw new MapleStoryApiError(errorBody);
+            }
+            throw error;
+        });
+    }
+    /**
+     * API 서버의 데이터 갱신 시간에 따라 데이터가 조회 가능한 최신 날짜를 반환합니다.
+     *
+     * @param options
+     */
+    getProperDefaultDateOptions(options) {
+        const { hour, minute, dateOffset } = options;
+        const nowInTimezone = dayjs().utcOffset(this.timezoneOffset);
+        const updateDate = dayjs().utcOffset(this.timezoneOffset).hour(hour).minute(minute);
+        let adjustedDate;
+        if (nowInTimezone.isAfter(updateDate)) {
+            adjustedDate = nowInTimezone;
+        }
+        else {
+            adjustedDate = nowInTimezone.subtract(1, 'day');
+        }
+        adjustedDate = adjustedDate.subtract(dateOffset ?? 0, 'day');
+        return {
+            year: adjustedDate.year(),
+            month: adjustedDate.month() + 1,
+            day: adjustedDate.date(),
+        };
+    }
+    ;
+    /**
+     * 날짜 정보를 API 서버에서 요구하는 포맷으로 변환합니다.
+     *
+     * @param dateOptions 조회 하려는 날짜
+     * @param minDateOptions API 호출 가능한 최소 날짜
+     */
+    toDateString(dateOptions, minDateOptions) {
+        const convert = (dateOptions) => {
+            let year;
+            let month;
+            let day;
+            let d;
+            if (dateOptions instanceof Date) {
+                d = dayjs(dateOptions).utcOffset(this.timezoneOffset);
+                year = d.year();
+                month = d.month() + 1;
+                day = d.date();
+            }
+            else {
+                year = dateOptions.year;
+                month = dateOptions.month;
+                day = dateOptions.day;
+                d = dayjs(`${year}-${month}-${day}`).utcOffset(this.timezoneOffset);
+            }
+            return {
+                year,
+                month,
+                day,
+                d,
+            };
+        };
+        const { year, month, day, d } = convert(dateOptions);
+        const str = d.format('YYYY-MM-DD');
+        if (minDateOptions) {
+            const { year: minYear, month: minMonth, day: minDay, } = convert(minDateOptions);
+            if (year < minYear ||
+                (year === minYear && month < minMonth) ||
+                (year === minYear && month === minMonth && day < minDay)) {
+                throw new Error(`You can only retrieve data after ${dayjs(`${minYear}-${minMonth}-${minDay}`).format('YYYY-MM-DD')}.`);
+            }
+        }
+        return str;
+    }
+    ;
+}
+
+export { MapleStoryFriendsApi };

package/dist/esm/maplestory/api/kms/dto/character/characterBasic.js

@@ -1,4 +1,5 @@
 import { CharacterBasicDto as CharacterBasicDto$1 } from '../../../common/dto/character/characterBasic.js';
+import { removeQuery } from '../../../common/lib.js';
 
 /**
  * 캐릭터 기본 정보
@@ -73,7 +74,7 @@ class CharacterBasicDto extends CharacterBasicDto$1 {
         this.characterExp = character_exp;
         this.characterExpRate = character_exp_rate;
         this.characterGuildName = character_guild_name;
-        this.characterImage = character_image;
+        this.characterImage = removeQuery(character_image);
         this.characterDateCreate = character_date_create ? new Date(character_date_create) : null;
         this.accessFlag = access_flag;
         this.liberationQuestClear = liberation_quest_clear;

package/dist/esm/maplestory/api/kms/kms.js

@@ -1,4 +1,5 @@
 export { MapleStoryApi } from './mapleStoryApi.js';
+export { MapleStoryFriendsApi } from './mapleStoryFriendsApi.js';
 export { CharacterDto } from './dto/character/character.js';
 export { CharacterAbilityDto, CharacterAbilityInfoDto, CharacterAbilityPresetDto } from './dto/character/characterAbility.js';
 export { CharacterAndroidCashItemEquipmentColoringPrismDto, CharacterAndroidCashItemEquipmentDto, CharacterAndroidCashItemEquipmentOptionDto, CharacterAndroidEquipmentDto, CharacterAndroidEquipmentFaceDto, CharacterAndroidEquipmentHairDto, CharacterAndroidEquipmentPresetDto, CharacterAndroidEquipmentSkinDto } from './dto/character/characterAndroidEquipment.js';

package/dist/esm/maplestory/api/kms/mapleStoryApi.js

@@ -52,6 +52,7 @@ import { AchievementDto } from './dto/user/achievement.js';
 import { CharacterListDto } from './dto/user/characterList.js';
 import { CharacterImageAction, CharacterImageEmotion, CharacterImageWeaponMotion } from '../common/enum/characterImage.js';
 import { MapleStoryApi as MapleStoryApi$1 } from '../common/mapleStoryApi.js';
+import { removeQuery } from '../common/lib.js';
 import { __exports as buffer } from '../../../_virtual/index.js_commonjs-exports.js';
 
 /**
@@ -159,7 +160,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
         if (!basic) {
             return null;
         }
-        const { date, characterImage: path } = basic;
+        const { date, characterImage } = basic;
         const action = imageOptions?.action ?? CharacterImageAction.Stand1;
         const emotion = imageOptions?.emotion ?? CharacterImageEmotion.Default;
         const wmotion = imageOptions?.wmotion ?? CharacterImageWeaponMotion.Default;
@@ -169,6 +170,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const height = 300;
         const x = 150;
         const y = 200;
+        const path = removeQuery(characterImage);
         const query = {
             action: `${action}.${actionFrame}`,
             emotion: `${emotion}.${emotionFrame}`,

package/dist/esm/maplestory/api/kms/mapleStoryFriendsApi.js

@@ -0,0 +1,112 @@
+import { CubeHistoryResponseDto } from './dto/history/cubeHistory.js';
+import { PotentialHistoryResponseDto } from './dto/history/potentialHistory.js';
+import { StarforceHistoryResponseDto } from './dto/history/starforceHistory.js';
+import { AchievementDto } from './dto/user/achievement.js';
+import { CharacterListDto } from './dto/user/characterList.js';
+import { MapleStoryFriendsApi as MapleStoryFriendsApi$1 } from '../common/mapleStoryFriendsApi.js';
+
+/**
+ * MapleStory Friends API client for KMS<br>
+ * This is an implementation of <a href="https://openapi.nexon.com/ko/friends/maplestory/?id=36">MapleStory Friends API</a>
+ */
+class MapleStoryFriendsApi extends MapleStoryFriendsApi$1 {
+    subUrl = 'maplestory';
+    timezoneOffset = 540;
+    constructor(accessToken) {
+        super(accessToken);
+    }
+    //#region 계정 정보 조회
+    /**
+     * 계정의 보유 캐릭터 목록을 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '캐릭터 목록'을 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     */
+    async getCharacterList() {
+        const path = `${this.subUrl}/v1/character/list`;
+        const { data } = await this.client.get(path);
+        return new CharacterListDto(data);
+    }
+    /**
+     * 계정의 업적 정보를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '업적 정보'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     */
+    async getAchievement() {
+        const path = `${this.subUrl}/v1/user/achievement`;
+        const { data } = await this.client.get(path);
+        return new AchievementDto(data);
+    }
+    async getStarforceHistory(count, parameter) {
+        const path = `${this.subUrl}/v1/history/starforce`;
+        const query = {
+            count,
+        };
+        if (typeof parameter === 'string') {
+            query.cursor = parameter;
+        }
+        else if (typeof parameter === 'object' || parameter === undefined) {
+            query.date = this.toDateString(parameter ??
+                this.getProperDefaultDateOptions({
+                    hour: 0,
+                    minute: 0,
+                    dateOffset: 0,
+                }), {
+                year: 2023,
+                month: 12,
+                day: 27,
+            });
+        }
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new StarforceHistoryResponseDto(data);
+    }
+    async getCubeHistory(count, parameter) {
+        const path = `${this.subUrl}/v1/history/cube`;
+        const query = {
+            count,
+        };
+        if (typeof parameter === 'string') {
+            query.cursor = parameter;
+        }
+        else if (typeof parameter === 'object' || parameter === undefined) {
+            query.date = this.toDateString(parameter ??
+                this.getProperDefaultDateOptions({
+                    hour: 0,
+                    minute: 0,
+                    dateOffset: 0,
+                }));
+        }
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new CubeHistoryResponseDto(data);
+    }
+    async getPotentialHistory(count, parameter) {
+        const path = `${this.subUrl}/v1/history/potential`;
+        const query = {
+            count,
+        };
+        if (typeof parameter === 'string') {
+            query.cursor = parameter;
+        }
+        else if (typeof parameter === 'object' || parameter === undefined) {
+            query.date = this.toDateString(parameter ??
+                this.getProperDefaultDateOptions({
+                    hour: 0,
+                    minute: 0,
+                    dateOffset: 0,
+                }), {
+                year: 2024,
+                month: 1,
+                day: 25,
+            });
+        }
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new PotentialHistoryResponseDto(data);
+    }
+}
+
+export { MapleStoryFriendsApi };

package/dist/esm/maplestory/api/msea/dto/character/characterBasic.js

@@ -1,4 +1,5 @@
 import { CharacterBasicDto as CharacterBasicDto$1 } from '../../../common/dto/character/characterBasic.js';
+import { removeQuery } from '../../../common/lib.js';
 
 /**
  * Character basic information
@@ -73,7 +74,7 @@ class CharacterBasicDto extends CharacterBasicDto$1 {
         this.characterExp = character_exp;
         this.characterExpRate = character_exp_rate;
         this.characterGuildName = character_guild_name;
-        this.characterImage = character_image;
+        this.characterImage = removeQuery(character_image);
         this.characterDateCreate = character_date_create ? new Date(character_date_create) : null;
         this.accessFlag = access_flag;
         this.liberationQuestClearFlag = liberation_quest_clear_flag;

package/dist/esm/maplestory/api/msea/mapleStoryApi.js

@@ -28,6 +28,7 @@ import { UnionArtifactDto } from './dto/union/unionArtifact.js';
 import { UnionRaiderDto } from './dto/union/unionRaider.js';
 import { CharacterImageAction, CharacterImageEmotion, CharacterImageWeaponMotion } from '../common/enum/characterImage.js';
 import { MapleStoryApi as MapleStoryApi$1 } from '../common/mapleStoryApi.js';
+import { removeQuery } from '../common/lib.js';
 import { __exports as buffer } from '../../../_virtual/index.js_commonjs-exports.js';
 
 /**
@@ -106,7 +107,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
         if (!basic) {
             return null;
         }
-        const { date, characterImage: path } = basic;
+        const { date, characterImage } = basic;
         const action = imageOptions?.action ?? CharacterImageAction.Stand1;
         const emotion = imageOptions?.emotion ?? CharacterImageEmotion.Default;
         const wmotion = imageOptions?.wmotion ?? CharacterImageWeaponMotion.Default;
@@ -116,6 +117,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const height = 96;
         const x = imageOptions?.x ?? null;
         const y = imageOptions?.y ?? null;
+        const path = removeQuery(characterImage);
         const query = {
             action: `${action}.${actionFrame}`,
             emotion: `${emotion}.${emotionFrame}`,

package/dist/esm/maplestory/api/tms/dto/character/characterBasic.js

@@ -1,4 +1,5 @@
 import { CharacterBasicDto as CharacterBasicDto$1 } from '../../../common/dto/character/characterBasic.js';
+import { removeQuery } from '../../../common/lib.js';
 
 /**
  * 角色基本資訊
@@ -73,7 +74,7 @@ class CharacterBasicDto extends CharacterBasicDto$1 {
         this.characterExp = character_exp;
         this.characterExpRate = character_exp_rate;
         this.characterGuildName = character_guild_name;
-        this.characterImage = character_image;
+        this.characterImage = removeQuery(character_image);
         this.characterDateCreate = character_date_create ? new Date(character_date_create) : null;
         this.accessFlag = access_flag;
         this.liberationQuestClear = liberation_quest_clear;

package/dist/esm/maplestory/api/tms/mapleStoryApi.js

@@ -28,6 +28,7 @@ import { UnionArtifactDto } from './dto/union/unionArtifact.js';
 import { UnionRaiderDto } from './dto/union/unionRaider.js';
 import { CharacterImageAction, CharacterImageEmotion, CharacterImageWeaponMotion } from '../common/enum/characterImage.js';
 import { MapleStoryApi as MapleStoryApi$1 } from '../common/mapleStoryApi.js';
+import { removeQuery } from '../common/lib.js';
 import { __exports as buffer } from '../../../_virtual/index.js_commonjs-exports.js';
 
 /**
@@ -106,7 +107,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
         if (!basic) {
             return null;
         }
-        const { date, characterImage: path } = basic;
+        const { date, characterImage } = basic;
         const action = imageOptions?.action ?? CharacterImageAction.Stand1;
         const emotion = imageOptions?.emotion ?? CharacterImageEmotion.Default;
         const wmotion = imageOptions?.wmotion ?? CharacterImageWeaponMotion.Default;
@@ -116,6 +117,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const height = 96;
         const x = imageOptions?.x ?? null;
         const y = imageOptions?.y ?? null;
+        const path = removeQuery(characterImage);
         const query = {
             action: `${action}.${actionFrame}`,
             emotion: `${emotion}.${emotionFrame}`,

package/dist/esm/node_modules/base64-js/index.js

@@ -1,5 +1,5 @@
-import { __exports as base64Js } from '../../_virtual/index.js_commonjs-exports3.js';
-export { __exports as default } from '../../_virtual/index.js_commonjs-exports3.js';
+import { __exports as base64Js } from '../../_virtual/index.js_commonjs-exports2.js';
+export { __exports as default } from '../../_virtual/index.js_commonjs-exports2.js';
 
 base64Js.byteLength = byteLength;
 base64Js.toByteArray = toByteArray;

package/dist/esm/node_modules/buffer/index.js

@@ -2,8 +2,8 @@ import { __exports as buffer } from '../../_virtual/index.js_commonjs-exports.js
 export { __exports as default } from '../../_virtual/index.js_commonjs-exports.js';
 import '../base64-js/index.js';
 import '../ieee754/index.js';
-import { __exports as base64Js } from '../../_virtual/index.js_commonjs-exports3.js';
-import { __exports as ieee754 } from '../../_virtual/index.js_commonjs-exports2.js';
+import { __exports as base64Js } from '../../_virtual/index.js_commonjs-exports2.js';
+import { __exports as ieee754 } from '../../_virtual/index.js_commonjs-exports3.js';
 
 /*!
  * The buffer module from node.js, for the browser.

package/dist/esm/node_modules/ieee754/index.js

@@ -1,5 +1,5 @@
-import { __exports as ieee754 } from '../../_virtual/index.js_commonjs-exports2.js';
-export { __exports as default } from '../../_virtual/index.js_commonjs-exports2.js';
+import { __exports as ieee754 } from '../../_virtual/index.js_commonjs-exports3.js';
+export { __exports as default } from '../../_virtual/index.js_commonjs-exports3.js';
 
 /*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */
 

package/dist/index.min.js

@@ -1 +1 @@
-!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("axios"),require("dayjs")):"function"==typeof define&&define.amd?define(["exports","axios","dayjs"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self)["maplestory-openapi"]={},t.axios,t.dayjs)}(this,function(t,e,a){"use strict";function r(t){return t&&"object"==typeof t&&"default"in t?t:{default:t}}var o=r(e),i=r(a),s=("undefined"!=typeof globalThis?globalThis:"undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self&&self,{exports:{}});!function(t){var e,a;t.exports=(e={year:0,month:1,day:2,hour:3,minute:4,second:5},a={},function(t,r,o){var i,s=function(t,e,r){void 0===r&&(r={});var o=new Date(t),i=function(t,e){void 0===e&&(e={});var r=e.timeZoneName||"short",o=t+"|"+r,i=a[o];return i||(i=new Intl.DateTimeFormat("en-US",{hour12:!1,timeZone:t,year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",timeZoneName:r}),a[o]=i),i}(e,r);return i.formatToParts(o)},n=function(t,a){for(var r=s(t,a),i=[],n=0;n<r.length;n+=1){var c=r[n],l=c.type,u=c.value,f=e[l];f>=0&&(i[f]=parseInt(u,10))}var h=i[3],m=24===h?0:h,d=i[0]+"-"+i[1]+"-"+i[2]+" "+m+":"+i[4]+":"+i[5]+":000",E=+t;return(o.utc(d).valueOf()-(E-=E%1e3))/6e4},c=r.prototype;c.tz=function(t,e){void 0===t&&(t=i);var a,r=this.utcOffset(),s=this.toDate(),n=s.toLocaleString("en-US",{timeZone:t}),c=Math.round((s-new Date(n))/1e3/60),l=15*-Math.round(s.getTimezoneOffset()/15)-c;if(Number(l)){if(a=o(n,{locale:this.$L}).$set("millisecond",this.$ms).utcOffset(l,!0),e){var u=a.utcOffset();a=a.add(r-u,"minute")}}else a=this.utcOffset(0,e);return a.$x.$timezone=t,a},c.offsetName=function(t){var e=this.$x.$timezone||o.tz.guess(),a=s(this.valueOf(),e,{timeZoneName:t}).find(function(t){return"timezonename"===t.type.toLowerCase()});return a&&a.value};var l=c.startOf;c.startOf=function(t,e){if(!this.$x||!this.$x.$timezone)return l.call(this,t,e);var a=o(this.format("YYYY-MM-DD HH:mm:ss:SSS"),{locale:this.$L});return l.call(a,t,e).tz(this.$x.$timezone,!0)},o.tz=function(t,e,a){var r=a&&e,s=a||e||i,c=n(+o(),s);if("string"!=typeof t)return o(t).tz(s);var l=function(t,e,a){var r=t-60*e*1e3,o=n(r,a);if(e===o)return[r,e];var i=n(r-=60*(o-e)*1e3,a);return o===i?[r,o]:[t-60*Math.min(o,i)*1e3,Math.max(o,i)]}(o.utc(t,r).valueOf(),c,s),u=l[0],f=l[1],h=o(u).utcOffset(f);return h.$x.$timezone=s,h},o.tz.guess=function(){return Intl.DateTimeFormat().resolvedOptions().timeZone},o.tz.setDefault=function(t){i=t}})}(s);var n=s.exports,c={exports:{}};!function(t){var e,a,r;t.exports=(e="minute",a=/[+-]\d\d(?::?\d\d)?/g,r=/([+-]|\d\d)/g,function(t,o,i){var s=o.prototype;i.utc=function(t){return new o({date:t,utc:!0,args:arguments})},s.utc=function(t){var a=i(this.toDate(),{locale:this.$L,utc:!0});return t?a.add(this.utcOffset(),e):a},s.local=function(){return i(this.toDate(),{locale:this.$L,utc:!1})};var n=s.parse;s.parse=function(t){t.utc&&(this.$u=!0),this.$utils().u(t.$offset)||(this.$offset=t.$offset),n.call(this,t)};var c=s.init;s.init=function(){if(this.$u){var t=this.$d;this.$y=t.getUTCFullYear(),this.$M=t.getUTCMonth(),this.$D=t.getUTCDate(),this.$W=t.getUTCDay(),this.$H=t.getUTCHours(),this.$m=t.getUTCMinutes(),this.$s=t.getUTCSeconds(),this.$ms=t.getUTCMilliseconds()}else c.call(this)};var l=s.utcOffset;s.utcOffset=function(t,o){var i=this.$utils().u;if(i(t))return this.$u?0:i(this.$offset)?l.call(this):this.$offset;if("string"==typeof t&&(t=function(t){void 0===t&&(t="");var e=t.match(a);if(!e)return null;var o=(""+e[0]).match(r)||["-",0,0],i=o[0],s=60*+o[1]+ +o[2];return 0===s?0:"+"===i?s:-s}(t),null===t))return this;var s=Math.abs(t)<=16?60*t:t;if(0===s)return this.utc(o);var n=this.clone();if(o)return n.$offset=s,n.$u=!1,n;var c=this.$u?this.toDate().getTimezoneOffset():-1*this.utcOffset();return(n=this.local().add(s+c,e)).$offset=s,n.$x.$localOffset=c,n};var u=s.format;s.format=function(t){var e=t||(this.$u?"YYYY-MM-DDTHH:mm:ss[Z]":"");return u.call(this,e)},s.valueOf=function(){var t=this.$utils().u(this.$offset)?0:this.$offset+(this.$x.$localOffset||this.$d.getTimezoneOffset());return this.$d.valueOf()-6e4*t},s.isUTC=function(){return!!this.$u},s.toISOString=function(){return this.toDate().toISOString()},s.toString=function(){return this.toDate().toUTCString()};var f=s.toDate;s.toDate=function(t){return"s"===t&&this.$offset?i(this.format("YYYY-MM-DD HH:mm:ss:SSS")).toDate():f.call(this)};var h=s.diff;s.diff=function(t,e,a){if(t&&this.$u===t.$u)return h.call(this,t,e,a);var r=this.local(),o=i(t).local();return h.call(r,o,e,a)}})}(c);var l,u=c.exports;class f extends Error{name="MapleStoryApiError";errorCode;message;constructor(t){const{name:e,message:a}=t.error;super(a),this.errorCode=h[e],this.message=a}}t.MapleStoryApiErrorCode=void 0,(l=t.MapleStoryApiErrorCode||(t.MapleStoryApiErrorCode={}))[l.OPENAPI00001=0]="OPENAPI00001",l[l.OPENAPI00002=1]="OPENAPI00002",l[l.OPENAPI00003=2]="OPENAPI00003",l[l.OPENAPI00004=3]="OPENAPI00004",l[l.OPENAPI00005=4]="OPENAPI00005",l[l.OPENAPI00006=5]="OPENAPI00006",l[l.OPENAPI00007=6]="OPENAPI00007",l[l.OPENAPI00009=7]="OPENAPI00009",l[l.OPENAPI00010=8]="OPENAPI00010",l[l.OPENAPI00011=9]="OPENAPI00011";const h={OPENAPI00001:t.MapleStoryApiErrorCode.OPENAPI00001,OPENAPI00002:t.MapleStoryApiErrorCode.OPENAPI00002,OPENAPI00003:t.MapleStoryApiErrorCode.OPENAPI00003,OPENAPI00004:t.MapleStoryApiErrorCode.OPENAPI00004,OPENAPI00005:t.MapleStoryApiErrorCode.OPENAPI00005,OPENAPI00006:t.MapleStoryApiErrorCode.OPENAPI00006,OPENAPI00007:t.MapleStoryApiErrorCode.OPENAPI00007,OPENAPI00009:t.MapleStoryApiErrorCode.OPENAPI00009,OPENAPI00010:t.MapleStoryApiErrorCode.OPENAPI00010,OPENAPI00011:t.MapleStoryApiErrorCode.OPENAPI00011};i.default.extend(n),i.default.extend(u);class m{apiKey;client;static BASE_URL="https://open.api.nexon.com/";static DEFAULT_TIMEOUT=5e3;get timeout(){return this.client.defaults.timeout}set timeout(t){this.client.defaults.timeout=t}constructor(t){this.apiKey=t,this.client=o.default.create({baseURL:m.BASE_URL,timeout:m.DEFAULT_TIMEOUT,headers:{"x-nxopen-api-key":this.apiKey}}),this.client.interceptors.response.use(t=>t,t=>{if(t instanceof e.AxiosError){const e=t.response.data;throw new f(e)}throw t})}getProperDefaultDateOptions(t){const{hour:e,minute:a,dateOffset:r}=t,o=i.default().utcOffset(this.timezoneOffset),s=i.default().utcOffset(this.timezoneOffset).hour(e).minute(a);let n;return n=o.isAfter(s)?o:o.subtract(1,"day"),n=n.subtract(r??0,"day"),{year:n.year(),month:n.month()+1,day:n.date()}}toDateString(t,e){const a=t=>{let e,a,r,o;return t instanceof Date?(o=i.default(t).utcOffset(this.timezoneOffset),e=o.year(),a=o.month()+1,r=o.date()):(e=t.year,a=t.month,r=t.day,o=i.default(`${e}-${a}-${r}`).utcOffset(this.timezoneOffset)),{year:e,month:a,day:r,d:o}},{year:r,month:o,day:s,d:n}=a(t),c=n.format("YYYY-MM-DD");if(e){const{year:t,month:n,day:c}=a(e);if(r<t||r===t&&o<n||r===t&&o===n&&s<c)throw new Error(`You can only retrieve data after ${i.default(`${t}-${n}-${c}`).format("YYYY-MM-DD")}.`)}return c}isEmptyResponse(t){for(const[e,a]of Object.entries(t))if("date"!==e&&null!=a&&(!Array.isArray(a)||0!==a.length))return!1;return!0}}var d,E,p,A;t.CharacterImageAction=void 0,(d=t.CharacterImageAction||(t.CharacterImageAction={})).Stand1="A00",d.Stand2="A01",d.Walk1="A02",d.Walk2="A03",d.Prone="A04",d.Fly="A05",d.Jump="A06",d.Sit="A07",d.Ladder="A08",d.Rope="A09",d.Heal="A10",d.Alert="A11",d.ProneStab="A12",d.SwingO1="A13",d.SwingO2="A14",d.SwingO3="A15",d.SwingOF="A16",d.SwingP1="A17",d.SwingP2="A18",d.SwingPF="A19",d.SwingT1="A20",d.SwingT2="A21",d.SwingT3="A22",d.SwingTF="A23",d.StabO1="A24",d.StabO2="A25",d.StabOF="A26",d.StabT1="A27",d.StabT2="A28",d.StabTF="A29",d.Shoot1="A30",d.Shoot2="A31",d.ShootF="A32",d.Dead="A33",d.GhostWalk="A34",d.GhostStand="A35",d.GhostJump="A36",d.GhostProneStab="A37",d.GhostLadder="A38",d.GhostRope="A39",d.GhostFly="A40",d.GhostSit="A41",t.CharacterImageEmotion=void 0,(E=t.CharacterImageEmotion||(t.CharacterImageEmotion={})).Default="E00",E.Wink="E01",E.Smile="E02",E.Cry="E03",E.Angry="E04",E.Bewildered="E05",E.Blink="E06",E.Blaze="E07",E.Bowing="E08",E.Cheers="E09",E.Chu="E10",E.Dam="E11",E.Despair="E12",E.Glitter="E13",E.Hit="E14",E.Hot="E15",E.Hum="E16",E.Love="E17",E.Oops="E18",E.Pain="E19",E.Troubled="E20",E.QBlue="E21",E.Shine="E22",E.Stunned="E23",E.Vomit="E24",t.CharacterImageWeaponMotion=void 0,(p=t.CharacterImageWeaponMotion||(t.CharacterImageWeaponMotion={})).Default="W00",p.OneHand="W01",p.TwoHands="W02",p.Gun="W03",p.Nothing="W04",t.PotentialOptionGrade=void 0,(A=t.PotentialOptionGrade||(t.PotentialOptionGrade={}))[A.RARE=0]="RARE",A[A.EPIC=1]="EPIC",A[A.UNIQUE=2]="UNIQUE",A[A.LEGENDARY=3]="LEGENDARY";t.CharacterAbilityDto=class{},t.CharacterAbilityInfoDto=class{},t.CharacterAbilityPresetDto=class{},t.CharacterAndroidCashItemEquipmentColoringPrismDto=class{},t.CharacterAndroidCashItemEquipmentDto=class{},t.CharacterAndroidCashItemEquipmentOptionDto=class{},t.CharacterAndroidEquipmentDto=class{},t.CharacterAndroidEquipmentFaceDto=class{},t.CharacterAndroidEquipmentHairDto=class{},t.CharacterAndroidEquipmentPresetDto=class{},t.CharacterAndroidEquipmentSkinDto=class{},t.CharacterBasicDto=class{get isAccessFlag(){return"true"===this.accessFlag}},t.CharacterBeautyEquipmentDto=class{},t.CharacterBeautyEquipmentFaceDto=class{},t.CharacterBeautyEquipmentHairDto=class{},t.CharacterBeautyEquipmentSkinDto=class{},t.CharacterCashItemEquipmentColoringPrismDto=class{},t.CharacterCashItemEquipmentDto=class{},t.CharacterCashItemEquipmentOptionDto=class{},t.CharacterCashItemEquipmentPresetDto=class{},t.CharacterDojangDto=class{},t.CharacterDto=class{},t.CharacterFinalStatDto=class{},t.CharacterHexaMatrixDto=class{},t.CharacterHexaMatrixEquipmentDto=class{},t.CharacterHexaMatrixEquipmentLinkedSkillDto=class{},t.CharacterHexaMatrixStatCoreDto=class{},t.CharacterHexaMatrixStatDto=class{},t.CharacterHyperStatDto=class{},t.CharacterHyperStatPresetDto=class{},t.CharacterImageDto=class{},t.CharacterItemEquipmentAddOptionDto=class{},t.CharacterItemEquipmentBaseOptionDto=class{},t.CharacterItemEquipmentDragonInfoDto=class{},t.CharacterItemEquipmentDto=class{},t.CharacterItemEquipmentEtcOptionDto=class{},t.CharacterItemEquipmentExceptionalOptionDto=class{},t.CharacterItemEquipmentInfoDto=class{},t.CharacterItemEquipmentMechanicInfoDto=class{},t.CharacterItemEquipmentStarforceOptionDto=class{},t.CharacterItemEquipmentTitleDto=class{},t.CharacterItemEquipmentTotalOptionDto=class{},t.CharacterLinkSkillDto=class{},t.CharacterLinkSkillInfoDto=class{},t.CharacterPetEquipmentAutoSkillDto=class{},t.CharacterPetEquipmentDto=class{},t.CharacterPetEquipmentItemDto=class{},t.CharacterPetEquipmentItemOptionDto=class{},t.CharacterPopularityDto=class{},t.CharacterPropensityDto=class{},t.CharacterSetEffectDto=class{},t.CharacterSetEffectInfoDto=class{},t.CharacterSetEffectOptionFullDto=class{},t.CharacterSetEffectSetDto=class{},t.CharacterSkillDto=class{},t.CharacterSkillInfoDto=class{},t.CharacterStatDto=class{},t.CharacterSymbolEquipmentDto=class{},t.CharacterSymbolEquipmentInfoDto=class{},t.CharacterVMatrixCodeEquipmentDto=class{},t.CharacterVMatrixDto=class{},t.GuildBasicDto=class{},t.GuildDto=class{},t.GuildSkillDto=class{},t.MapleStoryApi=m,t.MapleStoryApiError=f,t.UnionArtifactCrystalDto=class{},t.UnionArtifactDto=class{},t.UnionArtifactEffectDto=class{},t.UnionDto=class{},t.UnionRaiderBlockControlPointDto=class{},t.UnionRaiderBlockDto=class{},t.UnionRaiderBlockPositionDto=class{},t.UnionRaiderDto=class{},t.UnionRaiderInnerStatDto=class{},t.UnionRaiderPresetDto=class{}});
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("axios"),require("dayjs")):"function"==typeof define&&define.amd?define(["exports","axios","dayjs"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self)["maplestory-openapi"]={},t.axios,t.dayjs)}(this,function(t,e,a){"use strict";function r(t){return t&&"object"==typeof t&&"default"in t?t:{default:t}}var o=r(e),i=r(a),s=("undefined"!=typeof globalThis?globalThis:"undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self&&self,{exports:{}});!function(t){var e,a;t.exports=(e={year:0,month:1,day:2,hour:3,minute:4,second:5},a={},function(t,r,o){var i,s=function(t,e,r){void 0===r&&(r={});var o=new Date(t),i=function(t,e){void 0===e&&(e={});var r=e.timeZoneName||"short",o=t+"|"+r,i=a[o];return i||(i=new Intl.DateTimeFormat("en-US",{hour12:!1,timeZone:t,year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",timeZoneName:r}),a[o]=i),i}(e,r);return i.formatToParts(o)},n=function(t,a){for(var r=s(t,a),i=[],n=0;n<r.length;n+=1){var c=r[n],l=c.type,u=c.value,f=e[l];f>=0&&(i[f]=parseInt(u,10))}var h=i[3],m=24===h?0:h,d=i[0]+"-"+i[1]+"-"+i[2]+" "+m+":"+i[4]+":"+i[5]+":000",E=+t;return(o.utc(d).valueOf()-(E-=E%1e3))/6e4},c=r.prototype;c.tz=function(t,e){void 0===t&&(t=i);var a,r=this.utcOffset(),s=this.toDate(),n=s.toLocaleString("en-US",{timeZone:t}),c=Math.round((s-new Date(n))/1e3/60),l=15*-Math.round(s.getTimezoneOffset()/15)-c;if(Number(l)){if(a=o(n,{locale:this.$L}).$set("millisecond",this.$ms).utcOffset(l,!0),e){var u=a.utcOffset();a=a.add(r-u,"minute")}}else a=this.utcOffset(0,e);return a.$x.$timezone=t,a},c.offsetName=function(t){var e=this.$x.$timezone||o.tz.guess(),a=s(this.valueOf(),e,{timeZoneName:t}).find(function(t){return"timezonename"===t.type.toLowerCase()});return a&&a.value};var l=c.startOf;c.startOf=function(t,e){if(!this.$x||!this.$x.$timezone)return l.call(this,t,e);var a=o(this.format("YYYY-MM-DD HH:mm:ss:SSS"),{locale:this.$L});return l.call(a,t,e).tz(this.$x.$timezone,!0)},o.tz=function(t,e,a){var r=a&&e,s=a||e||i,c=n(+o(),s);if("string"!=typeof t)return o(t).tz(s);var l=function(t,e,a){var r=t-60*e*1e3,o=n(r,a);if(e===o)return[r,e];var i=n(r-=60*(o-e)*1e3,a);return o===i?[r,o]:[t-60*Math.min(o,i)*1e3,Math.max(o,i)]}(o.utc(t,r).valueOf(),c,s),u=l[0],f=l[1],h=o(u).utcOffset(f);return h.$x.$timezone=s,h},o.tz.guess=function(){return Intl.DateTimeFormat().resolvedOptions().timeZone},o.tz.setDefault=function(t){i=t}})}(s);var n=s.exports,c={exports:{}};!function(t){var e,a,r;t.exports=(e="minute",a=/[+-]\d\d(?::?\d\d)?/g,r=/([+-]|\d\d)/g,function(t,o,i){var s=o.prototype;i.utc=function(t){return new o({date:t,utc:!0,args:arguments})},s.utc=function(t){var a=i(this.toDate(),{locale:this.$L,utc:!0});return t?a.add(this.utcOffset(),e):a},s.local=function(){return i(this.toDate(),{locale:this.$L,utc:!1})};var n=s.parse;s.parse=function(t){t.utc&&(this.$u=!0),this.$utils().u(t.$offset)||(this.$offset=t.$offset),n.call(this,t)};var c=s.init;s.init=function(){if(this.$u){var t=this.$d;this.$y=t.getUTCFullYear(),this.$M=t.getUTCMonth(),this.$D=t.getUTCDate(),this.$W=t.getUTCDay(),this.$H=t.getUTCHours(),this.$m=t.getUTCMinutes(),this.$s=t.getUTCSeconds(),this.$ms=t.getUTCMilliseconds()}else c.call(this)};var l=s.utcOffset;s.utcOffset=function(t,o){var i=this.$utils().u;if(i(t))return this.$u?0:i(this.$offset)?l.call(this):this.$offset;if("string"==typeof t&&(t=function(t){void 0===t&&(t="");var e=t.match(a);if(!e)return null;var o=(""+e[0]).match(r)||["-",0,0],i=o[0],s=60*+o[1]+ +o[2];return 0===s?0:"+"===i?s:-s}(t),null===t))return this;var s=Math.abs(t)<=16?60*t:t;if(0===s)return this.utc(o);var n=this.clone();if(o)return n.$offset=s,n.$u=!1,n;var c=this.$u?this.toDate().getTimezoneOffset():-1*this.utcOffset();return(n=this.local().add(s+c,e)).$offset=s,n.$x.$localOffset=c,n};var u=s.format;s.format=function(t){var e=t||(this.$u?"YYYY-MM-DDTHH:mm:ss[Z]":"");return u.call(this,e)},s.valueOf=function(){var t=this.$utils().u(this.$offset)?0:this.$offset+(this.$x.$localOffset||this.$d.getTimezoneOffset());return this.$d.valueOf()-6e4*t},s.isUTC=function(){return!!this.$u},s.toISOString=function(){return this.toDate().toISOString()},s.toString=function(){return this.toDate().toUTCString()};var f=s.toDate;s.toDate=function(t){return"s"===t&&this.$offset?i(this.format("YYYY-MM-DD HH:mm:ss:SSS")).toDate():f.call(this)};var h=s.diff;s.diff=function(t,e,a){if(t&&this.$u===t.$u)return h.call(this,t,e,a);var r=this.local(),o=i(t).local();return h.call(r,o,e,a)}})}(c);var l,u=c.exports;class f extends Error{name="MapleStoryApiError";errorCode;message;constructor(t){const{name:e,message:a}=t.error;super(a),this.errorCode=h[e],this.message=a}}t.MapleStoryApiErrorCode=void 0,(l=t.MapleStoryApiErrorCode||(t.MapleStoryApiErrorCode={}))[l.OPENAPI00001=0]="OPENAPI00001",l[l.OPENAPI00002=1]="OPENAPI00002",l[l.OPENAPI00003=2]="OPENAPI00003",l[l.OPENAPI00004=3]="OPENAPI00004",l[l.OPENAPI00005=4]="OPENAPI00005",l[l.OPENAPI00006=5]="OPENAPI00006",l[l.OPENAPI00007=6]="OPENAPI00007",l[l.OPENAPI00009=7]="OPENAPI00009",l[l.OPENAPI00010=8]="OPENAPI00010",l[l.OPENAPI00011=9]="OPENAPI00011",l[l.OPENAPI00012=10]="OPENAPI00012";const h={OPENAPI00001:t.MapleStoryApiErrorCode.OPENAPI00001,OPENAPI00002:t.MapleStoryApiErrorCode.OPENAPI00002,OPENAPI00003:t.MapleStoryApiErrorCode.OPENAPI00003,OPENAPI00004:t.MapleStoryApiErrorCode.OPENAPI00004,OPENAPI00005:t.MapleStoryApiErrorCode.OPENAPI00005,OPENAPI00006:t.MapleStoryApiErrorCode.OPENAPI00006,OPENAPI00007:t.MapleStoryApiErrorCode.OPENAPI00007,OPENAPI00009:t.MapleStoryApiErrorCode.OPENAPI00009,OPENAPI00010:t.MapleStoryApiErrorCode.OPENAPI00010,OPENAPI00011:t.MapleStoryApiErrorCode.OPENAPI00011,OPENAPI00012:t.MapleStoryApiErrorCode.OPENAPI00012};i.default.extend(n),i.default.extend(u);class m{apiKey;client;static BASE_URL="https://open.api.nexon.com/";static DEFAULT_TIMEOUT=5e3;get timeout(){return this.client.defaults.timeout}set timeout(t){this.client.defaults.timeout=t}constructor(t){this.apiKey=t,this.client=o.default.create({baseURL:m.BASE_URL,timeout:m.DEFAULT_TIMEOUT,headers:{"x-nxopen-api-key":this.apiKey}}),this.client.interceptors.response.use(t=>t,t=>{if(t instanceof e.AxiosError){const e=t.response.data;throw new f(e)}throw t})}getProperDefaultDateOptions(t){const{hour:e,minute:a,dateOffset:r}=t,o=i.default().utcOffset(this.timezoneOffset),s=i.default().utcOffset(this.timezoneOffset).hour(e).minute(a);let n;return n=o.isAfter(s)?o:o.subtract(1,"day"),n=n.subtract(r??0,"day"),{year:n.year(),month:n.month()+1,day:n.date()}}toDateString(t,e){const a=t=>{let e,a,r,o;return t instanceof Date?(o=i.default(t).utcOffset(this.timezoneOffset),e=o.year(),a=o.month()+1,r=o.date()):(e=t.year,a=t.month,r=t.day,o=i.default(`${e}-${a}-${r}`).utcOffset(this.timezoneOffset)),{year:e,month:a,day:r,d:o}},{year:r,month:o,day:s,d:n}=a(t),c=n.format("YYYY-MM-DD");if(e){const{year:t,month:n,day:c}=a(e);if(r<t||r===t&&o<n||r===t&&o===n&&s<c)throw new Error(`You can only retrieve data after ${i.default(`${t}-${n}-${c}`).format("YYYY-MM-DD")}.`)}return c}isEmptyResponse(t){for(const[e,a]of Object.entries(t))if("date"!==e&&null!=a&&(!Array.isArray(a)||0!==a.length))return!1;return!0}}var d,E,p,A;t.CharacterImageAction=void 0,(d=t.CharacterImageAction||(t.CharacterImageAction={})).Stand1="A00",d.Stand2="A01",d.Walk1="A02",d.Walk2="A03",d.Prone="A04",d.Fly="A05",d.Jump="A06",d.Sit="A07",d.Ladder="A08",d.Rope="A09",d.Heal="A10",d.Alert="A11",d.ProneStab="A12",d.SwingO1="A13",d.SwingO2="A14",d.SwingO3="A15",d.SwingOF="A16",d.SwingP1="A17",d.SwingP2="A18",d.SwingPF="A19",d.SwingT1="A20",d.SwingT2="A21",d.SwingT3="A22",d.SwingTF="A23",d.StabO1="A24",d.StabO2="A25",d.StabOF="A26",d.StabT1="A27",d.StabT2="A28",d.StabTF="A29",d.Shoot1="A30",d.Shoot2="A31",d.ShootF="A32",d.Dead="A33",d.GhostWalk="A34",d.GhostStand="A35",d.GhostJump="A36",d.GhostProneStab="A37",d.GhostLadder="A38",d.GhostRope="A39",d.GhostFly="A40",d.GhostSit="A41",t.CharacterImageEmotion=void 0,(E=t.CharacterImageEmotion||(t.CharacterImageEmotion={})).Default="E00",E.Wink="E01",E.Smile="E02",E.Cry="E03",E.Angry="E04",E.Bewildered="E05",E.Blink="E06",E.Blaze="E07",E.Bowing="E08",E.Cheers="E09",E.Chu="E10",E.Dam="E11",E.Despair="E12",E.Glitter="E13",E.Hit="E14",E.Hot="E15",E.Hum="E16",E.Love="E17",E.Oops="E18",E.Pain="E19",E.Troubled="E20",E.QBlue="E21",E.Shine="E22",E.Stunned="E23",E.Vomit="E24",t.CharacterImageWeaponMotion=void 0,(p=t.CharacterImageWeaponMotion||(t.CharacterImageWeaponMotion={})).Default="W00",p.OneHand="W01",p.TwoHands="W02",p.Gun="W03",p.Nothing="W04",t.PotentialOptionGrade=void 0,(A=t.PotentialOptionGrade||(t.PotentialOptionGrade={}))[A.RARE=0]="RARE",A[A.EPIC=1]="EPIC",A[A.UNIQUE=2]="UNIQUE",A[A.LEGENDARY=3]="LEGENDARY";t.CharacterAbilityDto=class{},t.CharacterAbilityInfoDto=class{},t.CharacterAbilityPresetDto=class{},t.CharacterAndroidCashItemEquipmentColoringPrismDto=class{},t.CharacterAndroidCashItemEquipmentDto=class{},t.CharacterAndroidCashItemEquipmentOptionDto=class{},t.CharacterAndroidEquipmentDto=class{},t.CharacterAndroidEquipmentFaceDto=class{},t.CharacterAndroidEquipmentHairDto=class{},t.CharacterAndroidEquipmentPresetDto=class{},t.CharacterAndroidEquipmentSkinDto=class{},t.CharacterBasicDto=class{get isAccessFlag(){return"true"===this.accessFlag}},t.CharacterBeautyEquipmentDto=class{},t.CharacterBeautyEquipmentFaceDto=class{},t.CharacterBeautyEquipmentHairDto=class{},t.CharacterBeautyEquipmentSkinDto=class{},t.CharacterCashItemEquipmentColoringPrismDto=class{},t.CharacterCashItemEquipmentDto=class{},t.CharacterCashItemEquipmentOptionDto=class{},t.CharacterCashItemEquipmentPresetDto=class{},t.CharacterDojangDto=class{},t.CharacterDto=class{},t.CharacterFinalStatDto=class{},t.CharacterHexaMatrixDto=class{},t.CharacterHexaMatrixEquipmentDto=class{},t.CharacterHexaMatrixEquipmentLinkedSkillDto=class{},t.CharacterHexaMatrixStatCoreDto=class{},t.CharacterHexaMatrixStatDto=class{},t.CharacterHyperStatDto=class{},t.CharacterHyperStatPresetDto=class{},t.CharacterImageDto=class{},t.CharacterItemEquipmentAddOptionDto=class{},t.CharacterItemEquipmentBaseOptionDto=class{},t.CharacterItemEquipmentDragonInfoDto=class{},t.CharacterItemEquipmentDto=class{},t.CharacterItemEquipmentEtcOptionDto=class{},t.CharacterItemEquipmentExceptionalOptionDto=class{},t.CharacterItemEquipmentInfoDto=class{},t.CharacterItemEquipmentMechanicInfoDto=class{},t.CharacterItemEquipmentStarforceOptionDto=class{},t.CharacterItemEquipmentTitleDto=class{},t.CharacterItemEquipmentTotalOptionDto=class{},t.CharacterLinkSkillDto=class{},t.CharacterLinkSkillInfoDto=class{},t.CharacterPetEquipmentAutoSkillDto=class{},t.CharacterPetEquipmentDto=class{},t.CharacterPetEquipmentItemDto=class{},t.CharacterPetEquipmentItemOptionDto=class{},t.CharacterPopularityDto=class{},t.CharacterPropensityDto=class{},t.CharacterSetEffectDto=class{},t.CharacterSetEffectInfoDto=class{},t.CharacterSetEffectOptionFullDto=class{},t.CharacterSetEffectSetDto=class{},t.CharacterSkillDto=class{},t.CharacterSkillInfoDto=class{},t.CharacterStatDto=class{},t.CharacterSymbolEquipmentDto=class{},t.CharacterSymbolEquipmentInfoDto=class{},t.CharacterVMatrixCodeEquipmentDto=class{},t.CharacterVMatrixDto=class{},t.GuildBasicDto=class{},t.GuildDto=class{},t.GuildSkillDto=class{},t.MapleStoryApi=m,t.MapleStoryApiError=f,t.UnionArtifactCrystalDto=class{},t.UnionArtifactDto=class{},t.UnionArtifactEffectDto=class{},t.UnionDto=class{},t.UnionRaiderBlockControlPointDto=class{},t.UnionRaiderBlockDto=class{},t.UnionRaiderBlockPositionDto=class{},t.UnionRaiderDto=class{},t.UnionRaiderInnerStatDto=class{},t.UnionRaiderPresetDto=class{}});

package/package.json

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

package/types/maplestory/api/common/lib.d.ts

@@ -5,3 +5,12 @@ import { PotentialOptionGrade } from './enum/potentialOptionGrade';
  * @param text support only "레어", "에픽", "유니크", "레전드리"
  */
 export declare const potentialOptionGradeFromString: (text: string) => PotentialOptionGrade;
+/**
+ * URL에서 Query를 제거합니다.
+ * @param url URL
+ * @example
+ * ```
+ * removeQuery('https://example.com/path?query=123&test=abc') // returns 'https://example.com/path'
+ * ```
+ */
+export declare const removeQuery: (url: string) => string;

package/types/maplestory/api/common/mapleStoryApiError.d.ts

@@ -23,5 +23,6 @@ export declare enum MapleStoryApiErrorCode {
     OPENAPI00007 = 6,
     OPENAPI00009 = 7,
     OPENAPI00010 = 8,
-    OPENAPI00011 = 9
+    OPENAPI00011 = 9,
+    OPENAPI00012 = 10
 }

package/types/maplestory/api/common/mapleStoryFriendsApi.d.ts

@@ -0,0 +1,49 @@
+import { Axios } from 'axios';
+/**
+ * MapleStory Friends API client.
+ */
+export declare abstract class MapleStoryFriendsApi {
+    private readonly accessToken;
+    protected readonly client: Axios;
+    private static readonly BASE_URL;
+    private static readonly DEFAULT_TIMEOUT;
+    protected abstract subUrl: string;
+    protected abstract timezoneOffset: number;
+    get timeout(): number;
+    set timeout(value: number);
+    constructor(accessToken: string);
+    /**
+     * API 서버의 데이터 갱신 시간에 따라 데이터가 조회 가능한 최신 날짜를 반환합니다.
+     *
+     * @param options
+     */
+    protected getProperDefaultDateOptions(options: LatestApiUpdateTimeOptions): DateOptions;
+    /**
+     * 날짜 정보를 API 서버에서 요구하는 포맷으로 변환합니다.
+     *
+     * @param dateOptions 조회 하려는 날짜
+     * @param minDateOptions API 호출 가능한 최소 날짜
+     */
+    protected toDateString(dateOptions: DateOptions, minDateOptions?: DateOptions): string | never;
+}
+/**
+ * API 서버의 데이터 갱신 시각과 조회 가능한 최근 날짜와 현재 날짜와의 차이
+ */
+type LatestApiUpdateTimeOptions = {
+    hour: number;
+    minute: number;
+    dateOffset?: number;
+};
+type YMD = {
+    year: number;
+    month: number;
+    day: number;
+};
+/**
+ * 날짜 옵션
+ * - Date 객체 또는 YMD 형식의 객체를 사용할 수 있습니다.
+ * - 날짜는 해당 서비스 지역의 표준 시를 사용 합니다.
+ * - Date 객체의 offset이 해당 서비스 지역의 offset과 다를 경우 자동으로 변환 됩니다.
+ */
+export type DateOptions = YMD | Date;
+export {};

package/types/maplestory/api/kms/index.d.ts

@@ -1,4 +1,5 @@
 export * from './mapleStoryApi';
+export * from './mapleStoryFriendsApi';
 export * from './dto/character/character';
 export * from './dto/character/characterAbility';
 export * from './dto/character/characterAndroidEquipment';

package/types/maplestory/api/kms/mapleStoryFriendsApi.d.ts

@@ -0,0 +1,115 @@
+import { CubeHistoryResponseDto } from './dto/history/cubeHistory';
+import { PotentialHistoryResponseDto } from './dto/history/potentialHistory';
+import { StarforceHistoryResponseDto } from './dto/history/starforceHistory';
+import { AchievementDto } from './dto/user/achievement';
+import { CharacterListDto } from './dto/user/characterList';
+import { DateOptions } from '../common/mapleStoryFriendsApi';
+import * as base from '../common/mapleStoryFriendsApi';
+/**
+ * MapleStory Friends API client for KMS<br>
+ * This is an implementation of <a href="https://openapi.nexon.com/ko/friends/maplestory/?id=36">MapleStory Friends API</a>
+ */
+export declare class MapleStoryFriendsApi extends base.MapleStoryFriendsApi {
+    protected subUrl: string;
+    protected timezoneOffset: number;
+    constructor(accessToken: string);
+    /**
+     * 계정의 보유 캐릭터 목록을 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '캐릭터 목록'을 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     */
+    getCharacterList(): Promise<CharacterListDto>;
+    /**
+     * 계정의 업적 정보를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '업적 정보'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     */
+    getAchievement(): Promise<AchievementDto>;
+    /**
+     * 스타포스 강화 결과를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '스타포스 강화 결과'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     * - 스타포스 확률 정보는 최대 5분 후 확인 가능합니다.
+     * - 스타포스 강화 결과는 2023년 12월 27일 데이터부터 조회 가능하며, 최대 2년동안의 데이터만 제공됩니다.
+     * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000)
+     */
+    getStarforceHistory(count: number): Promise<StarforceHistoryResponseDto>;
+    /**
+     * 지목한 날짜의 스타포스 강화 결과를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '스타포스 강화 결과'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     * - 스타포스 확률 정보는 최대 5분 후 확인 가능합니다.
+     * - 스타포스 강화 결과는 2023년 12월 27일 데이터부터 조회 가능하며, 최대 2년동안의 데이터만 제공됩니다.
+     * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000)
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    getStarforceHistory(count: number, dateOptions: DateOptions): Promise<StarforceHistoryResponseDto>;
+    /**
+     * 스타포스 강화 결과를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '스타포스 강화 결과'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     * - 스타포스 확률 정보는 최대 5분 후 확인 가능합니다.
+     * - 스타포스 강화 결과는 2023년 12월 27일 데이터부터 조회 가능하며, 최대 2년동안의 데이터만 제공됩니다.
+     * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000)
+     * @param cursor 페이징 처리를 위한 cursor
+     */
+    getStarforceHistory(count: number, cursor: string): Promise<StarforceHistoryResponseDto>;
+    /**
+     * 큐브 사용 결과를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '큐브 사용 결과'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     * - 큐브 확률 정보는 최대 30분 후 확인 가능합니다.
+     * - 큐브 사용 결과는 최근 2년 데이터만 조회 가능합니다.
+     * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000). 옵션 재설정을 3회 진행한 결과가 포함될 경우 입력한 count보다 적은 수로 조회될 수 있습니다.
+     */
+    getCubeHistory(count: number): Promise<CubeHistoryResponseDto>;
+    /**
+     * 지목한 날짜의 큐브 사용 결과를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '큐브 사용 결과'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     * - 큐브 확률 정보는 최대 30분 후 확인 가능합니다.
+     * - 큐브 사용 결과는 최근 2년 데이터만 조회 가능합니다.
+     * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000). 옵션 재설정을 3회 진행한 결과가 포함될 경우 입력한 count보다 적은 수로 조회될 수 있습니다.
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    getCubeHistory(count: number, dateOptions: DateOptions): Promise<CubeHistoryResponseDto>;
+    /**
+     * 큐브 사용 결과를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '큐브 사용 결과'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     * - 큐브 확률 정보는 최대 30분 후 확인 가능합니다.
+     * - 큐브 사용 결과는 최근 2년 데이터만 조회 가능합니다.
+     * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000). 옵션 재설정을 3회 진행한 결과가 포함될 경우 입력한 count보다 적은 수로 조회될 수 있습니다.
+     * @param cursor 페이징 처리를 위한 cursor
+     */
+    getCubeHistory(count: number, cursor: string): Promise<CubeHistoryResponseDto>;
+    /**
+     * 잠재능력 재설정 이용 결과를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '잠재능력 재설정 이용 결과'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     * - 잠재능력 재설정 정보는 최대 30분 후 확인 가능합니다.
+     * - 잠재능력 재설정 이용 결과는 2024년 01월 25일 데이터부터 조회 가능하며, 최대 2년동안의 데이터만 제공됩니다.
+     * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000). 옵션 재설정을 3회 진행한 결과가 포함될 경우 입력한 count보다 적은 수로 조회될 수 있습니다.
+     */
+    getPotentialHistory(count: number): Promise<PotentialHistoryResponseDto>;
+    /**
+     * 지목한 날짜의 잠재능력 재설정 이용 결과를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '잠재능력 재설정 이용 결과'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     * - 잠재능력 재설정 정보는 최대 30분 후 확인 가능합니다.
+     * - 잠재능력 재설정 이용 결과는 2024년 01월 25일 데이터부터 조회 가능하며, 최대 2년동안의 데이터만 제공됩니다.
+     * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000). 옵션 재설정을 3회 진행한 결과가 포함될 경우 입력한 count보다 적은 수로 조회될 수 있습니다.
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    getPotentialHistory(count: number, dateOptions: DateOptions): Promise<PotentialHistoryResponseDto>;
+    /**
+     * 잠재능력 재설정 이용 결과를 조회합니다.
+     * - 이 항목을 조회하시려면 NEXON Open ID 클라이언트 설정에서 '잠재능력 재설정 이용 결과'를 활용 데이터 항목으로 선택해주세요.
+     * - 이후 자세한 데이터 호출 및 활용 방법은 <a href="https://openapi.nexon.com/ko/open-id/development-guide/">NEXON Open ID 개발 가이드 문서</a>를 참조해주세요.
+     * - 잠재능력 재설정 정보는 최대 30분 후 확인 가능합니다.
+     * - 잠재능력 재설정 이용 결과는 2024년 01월 25일 데이터부터 조회 가능하며, 최대 2년동안의 데이터만 제공됩니다.
+     * @param count 한번에 가져오려는 결과의 개수(최소 10, 최대 1000). 옵션 재설정을 3회 진행한 결과가 포함될 경우 입력한 count보다 적은 수로 조회될 수 있습니다.
+     * @param cursor 페이징 처리를 위한 cursor
+     */
+    getPotentialHistory(count: number, cursor: string): Promise<PotentialHistoryResponseDto>;
+}