maplestory-openapi 3.5.1 → 3.7.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/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/characterCashItemEquipment.js

@@ -111,6 +111,34 @@ class CharacterCashItemEquipmentColoringPrismDto extends characterCashItemEquipm
         this.value = value;
     }
 }
+/**
+ * 캐릭터 캐시 장비(무기) 이펙트 프리즘
+ */
+class CharacterCashItemEquipmentEffectPrismDto {
+    /**
+     * 이펙트 프리즘 색상 범위
+     */
+    colorRange;
+    /**
+     * 이펙트 프리즘 색조
+     */
+    hue;
+    /**
+     * 이펙트 프리즘 채도
+     */
+    saturation;
+    /**
+     * 이펙트 프리즘 명도
+     */
+    value;
+    constructor(obj) {
+        const { color_range, hue, saturation, value } = obj;
+        this.colorRange = color_range;
+        this.hue = hue;
+        this.saturation = saturation;
+        this.value = value;
+    }
+}
 /**
  * 캐릭터 캐시 장비 옵션
  */
@@ -182,6 +210,10 @@ class CharacterCashItemEquipmentPresetDto extends characterCashItemEquipment.Cha
      * 캐시 장비 컬러링프리즘 정보
      */
     cashItemColoringPrism;
+    /**
+     * 캐시 장비(무기) 이펙트 프리즘 정보
+     */
+    cashItemEffectPrism;
     /**
      * 아이템 장착 가능 성별
      */
@@ -194,9 +226,13 @@ class CharacterCashItemEquipmentPresetDto extends characterCashItemEquipment.Cha
      * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
      */
     freestyleFlag;
+    /**
+     * 표정 합성 정보
+     */
+    emotion_name;
     constructor(obj) {
         super();
-        const { cash_item_equipment_part, cash_item_equipment_slot, cash_item_name, cash_item_icon, cash_item_description, cash_item_option, date_expire, date_option_expire, cash_item_label, cash_item_coloring_prism, item_gender, skills, freestyle_flag, } = obj;
+        const { cash_item_equipment_part, cash_item_equipment_slot, cash_item_name, cash_item_icon, cash_item_description, cash_item_option, date_expire, date_option_expire, cash_item_label, cash_item_coloring_prism, cash_item_effect_prism, item_gender, skills, freestyle_flag, emotion_name, } = obj;
         this.cashItemEquipmentPart = cash_item_equipment_part;
         this.cashItemEquipmentSlot = cash_item_equipment_slot;
         this.cashItemName = cash_item_name;
@@ -207,9 +243,13 @@ class CharacterCashItemEquipmentPresetDto extends characterCashItemEquipment.Cha
         this.cashItemColoringPrism = cash_item_coloring_prism
             ? new CharacterCashItemEquipmentColoringPrismDto(cash_item_coloring_prism)
             : null;
+        this.cashItemEffectPrism = cash_item_effect_prism
+            ? new CharacterCashItemEquipmentEffectPrismDto(cash_item_effect_prism)
+            : null;
         this.itemGender = item_gender;
         this.skills = skills;
         this.freestyleFlag = freestyle_flag;
+        this.emotion_name = emotion_name;
         if (date_expire === 'expired') {
             this.isExpired = true;
         }
@@ -235,5 +275,6 @@ class CharacterCashItemEquipmentPresetDto extends characterCashItemEquipment.Cha
 
 exports.CharacterCashItemEquipmentColoringPrismDto = CharacterCashItemEquipmentColoringPrismDto;
 exports.CharacterCashItemEquipmentDto = CharacterCashItemEquipmentDto;
+exports.CharacterCashItemEquipmentEffectPrismDto = CharacterCashItemEquipmentEffectPrismDto;
 exports.CharacterCashItemEquipmentOptionDto = CharacterCashItemEquipmentOptionDto;
 exports.CharacterCashItemEquipmentPresetDto = CharacterCashItemEquipmentPresetDto;

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

@@ -44,6 +44,10 @@ class CharacterSymbolEquipmentInfoDto extends characterSymbolEquipment.Character
      * 심볼 설명
      */
     symbolDescription;
+    /**
+     * 심볼 부가 효과 설명
+     */
+    symbolOtherEffectDescription;
     /**
      * 심볼로 인한 증가 수치
      */
@@ -94,10 +98,11 @@ class CharacterSymbolEquipmentInfoDto extends characterSymbolEquipment.Character
     symbolRequireGrowthCount;
     constructor(obj) {
         super();
-        const { symbol_name, symbol_icon, symbol_description, symbol_force, symbol_level, symbol_str, symbol_dex, symbol_int, symbol_luk, symbol_hp, symbol_drop_rate, symbol_meso_rate, symbol_exp_rate, symbol_growth_count, symbol_require_growth_count, } = obj;
+        const { symbol_name, symbol_icon, symbol_description, symbol_other_effect_description, symbol_force, symbol_level, symbol_str, symbol_dex, symbol_int, symbol_luk, symbol_hp, symbol_drop_rate, symbol_meso_rate, symbol_exp_rate, symbol_growth_count, symbol_require_growth_count, } = obj;
         this.symbolName = symbol_name;
         this.symbolIcon = symbol_icon;
         this.symbolDescription = symbol_description;
+        this.symbolOtherEffectDescription = symbol_other_effect_description;
         this.symbolForce = symbol_force;
         this.symbolLevel = symbol_level;
         this.symbolStr = symbol_str;

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

@@ -44,6 +44,7 @@ class CharacterVMatrixCodeEquipmentDto extends characterVMatrix.CharacterVMatrix
     slotId;
     /**
      * 슬롯 레벨
+     * @deprecated 2025년 12월 18일 점검 이후부터 사용하지 않는 항목입니다.
      */
     slotLevel;
     /**
@@ -60,14 +61,17 @@ class CharacterVMatrixCodeEquipmentDto extends characterVMatrix.CharacterVMatrix
     vCoreLevel;
     /**
      * 코어에 해당하는 스킬 명
+     * @deprecated 2025년 12월 18일 점검 이후부터 사용하지 않는 항목입니다.
      */
     vCoreSkill1;
     /**
      * (강화 코어인 경우) 코어에 해당하는 두 번째 스킬 명
+     * @deprecated 2025년 12월 18일 점검 이후부터 사용하지 않는 항목입니다.
      */
     vCoreSkill2;
     /**
      * (강화 코어인 경우) 코어에 해당하는 세 번째 스킬 명
+     * @deprecated 2025년 12월 18일 점검 이후부터 사용하지 않는 항목입니다.
      */
     vCoreSkill3;
     constructor(obj) {

package/dist/cjs/maplestory/api/kms/dto/notice/cashshopNoticeList.js

@@ -27,6 +27,10 @@ class CashshopNoticeListItemDto {
      * 공지 링크
      */
     url;
+    /**
+     * 썸네일 링크
+     */
+    thumbnailUrl;
     /**
      * 공지 식별자
      */
@@ -48,9 +52,10 @@ class CashshopNoticeListItemDto {
      */
     ongoingFlag;
     constructor(obj) {
-        const { title, url, notice_id, date, date_sale_start, date_sale_end, ongoing_flag, } = obj;
+        const { title, url, thumbnail_url, notice_id, date, date_sale_start, date_sale_end, ongoing_flag, } = obj;
         this.title = title;
         this.url = url;
+        this.thumbnailUrl = thumbnail_url;
         this.noticeId = notice_id;
         this.date = new Date(date);
         this.dateSaleStart = date_sale_start ? new Date(date_sale_start) : null;

package/dist/cjs/maplestory/api/kms/dto/notice/eventNoticeList.js

@@ -27,6 +27,10 @@ class EventNoticeListItemDto {
      * 공지 링크
      */
     url;
+    /**
+     * 썸네일 링크
+     */
+    thumbnailUrl;
     /**
      * 공지 식별자
      */
@@ -44,9 +48,10 @@ class EventNoticeListItemDto {
      */
     dateEventEnd;
     constructor(obj) {
-        const { title, url, notice_id, date, date_event_start, date_event_end } = obj;
+        const { title, url, thumbnail_url, notice_id, date, date_event_start, date_event_end } = obj;
         this.title = title;
         this.url = url;
+        this.thumbnailUrl = thumbnail_url;
         this.noticeId = notice_id;
         this.date = new Date(date);
         this.dateEventStart = new Date(date_event_start);

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;
@@ -74,6 +76,7 @@ exports.CharacterBeautyEquipmentHairDto = characterBeautyEquipment.CharacterBeau
 exports.CharacterBeautyEquipmentSkinDto = characterBeautyEquipment.CharacterBeautyEquipmentSkinDto;
 exports.CharacterCashItemEquipmentColoringPrismDto = characterCashItemEquipment.CharacterCashItemEquipmentColoringPrismDto;
 exports.CharacterCashItemEquipmentDto = characterCashItemEquipment.CharacterCashItemEquipmentDto;
+exports.CharacterCashItemEquipmentEffectPrismDto = characterCashItemEquipment.CharacterCashItemEquipmentEffectPrismDto;
 exports.CharacterCashItemEquipmentOptionDto = characterCashItemEquipment.CharacterCashItemEquipmentOptionDto;
 exports.CharacterCashItemEquipmentPresetDto = characterCashItemEquipment.CharacterCashItemEquipmentPresetDto;
 exports.CharacterDojangDto = characterDojang.CharacterDojangDto;

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/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/characterCashItemEquipment.js

@@ -107,6 +107,34 @@ class CharacterCashItemEquipmentColoringPrismDto extends CharacterCashItemEquipm
         this.value = value;
     }
 }
+/**
+ * 캐릭터 캐시 장비(무기) 이펙트 프리즘
+ */
+class CharacterCashItemEquipmentEffectPrismDto {
+    /**
+     * 이펙트 프리즘 색상 범위
+     */
+    colorRange;
+    /**
+     * 이펙트 프리즘 색조
+     */
+    hue;
+    /**
+     * 이펙트 프리즘 채도
+     */
+    saturation;
+    /**
+     * 이펙트 프리즘 명도
+     */
+    value;
+    constructor(obj) {
+        const { color_range, hue, saturation, value } = obj;
+        this.colorRange = color_range;
+        this.hue = hue;
+        this.saturation = saturation;
+        this.value = value;
+    }
+}
 /**
  * 캐릭터 캐시 장비 옵션
  */
@@ -178,6 +206,10 @@ class CharacterCashItemEquipmentPresetDto extends CharacterCashItemEquipmentPres
      * 캐시 장비 컬러링프리즘 정보
      */
     cashItemColoringPrism;
+    /**
+     * 캐시 장비(무기) 이펙트 프리즘 정보
+     */
+    cashItemEffectPrism;
     /**
      * 아이템 장착 가능 성별
      */
@@ -190,9 +222,13 @@ class CharacterCashItemEquipmentPresetDto extends CharacterCashItemEquipmentPres
      * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
      */
     freestyleFlag;
+    /**
+     * 표정 합성 정보
+     */
+    emotion_name;
     constructor(obj) {
         super();
-        const { cash_item_equipment_part, cash_item_equipment_slot, cash_item_name, cash_item_icon, cash_item_description, cash_item_option, date_expire, date_option_expire, cash_item_label, cash_item_coloring_prism, item_gender, skills, freestyle_flag, } = obj;
+        const { cash_item_equipment_part, cash_item_equipment_slot, cash_item_name, cash_item_icon, cash_item_description, cash_item_option, date_expire, date_option_expire, cash_item_label, cash_item_coloring_prism, cash_item_effect_prism, item_gender, skills, freestyle_flag, emotion_name, } = obj;
         this.cashItemEquipmentPart = cash_item_equipment_part;
         this.cashItemEquipmentSlot = cash_item_equipment_slot;
         this.cashItemName = cash_item_name;
@@ -203,9 +239,13 @@ class CharacterCashItemEquipmentPresetDto extends CharacterCashItemEquipmentPres
         this.cashItemColoringPrism = cash_item_coloring_prism
             ? new CharacterCashItemEquipmentColoringPrismDto(cash_item_coloring_prism)
             : null;
+        this.cashItemEffectPrism = cash_item_effect_prism
+            ? new CharacterCashItemEquipmentEffectPrismDto(cash_item_effect_prism)
+            : null;
         this.itemGender = item_gender;
         this.skills = skills;
         this.freestyleFlag = freestyle_flag;
+        this.emotion_name = emotion_name;
         if (date_expire === 'expired') {
             this.isExpired = true;
         }
@@ -229,4 +269,4 @@ class CharacterCashItemEquipmentPresetDto extends CharacterCashItemEquipmentPres
     }
 }
 
-export { CharacterCashItemEquipmentColoringPrismDto, CharacterCashItemEquipmentDto, CharacterCashItemEquipmentOptionDto, CharacterCashItemEquipmentPresetDto };
+export { CharacterCashItemEquipmentColoringPrismDto, CharacterCashItemEquipmentDto, CharacterCashItemEquipmentEffectPrismDto, CharacterCashItemEquipmentOptionDto, CharacterCashItemEquipmentPresetDto };