maplestory-openapi 3.5.1 → 3.7.0

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

@@ -40,6 +40,10 @@ class CharacterSymbolEquipmentInfoDto extends CharacterSymbolEquipmentInfoDto$1
      * 심볼 설명
      */
     symbolDescription;
+    /**
+     * 심볼 부가 효과 설명
+     */
+    symbolOtherEffectDescription;
     /**
      * 심볼로 인한 증가 수치
      */
@@ -90,10 +94,11 @@ class CharacterSymbolEquipmentInfoDto extends CharacterSymbolEquipmentInfoDto$1
     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/esm/maplestory/api/kms/dto/character/characterVMatrix.js

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

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

@@ -23,6 +23,10 @@ class CashshopNoticeListItemDto {
      * 공지 링크
      */
     url;
+    /**
+     * 썸네일 링크
+     */
+    thumbnailUrl;
     /**
      * 공지 식별자
      */
@@ -44,9 +48,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/esm/maplestory/api/kms/dto/notice/eventNoticeList.js

@@ -23,6 +23,10 @@ class EventNoticeListItemDto {
      * 공지 링크
      */
     url;
+    /**
+     * 썸네일 링크
+     */
+    thumbnailUrl;
     /**
      * 공지 식별자
      */
@@ -40,9 +44,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/esm/maplestory/api/kms/kms.js

@@ -1,10 +1,11 @@
 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';
 export { CharacterBasicDto } from './dto/character/characterBasic.js';
 export { CharacterBeautyEquipmentDto, CharacterBeautyEquipmentFaceDto, CharacterBeautyEquipmentHairDto, CharacterBeautyEquipmentSkinDto } from './dto/character/characterBeautyEquipment.js';
-export { CharacterCashItemEquipmentColoringPrismDto, CharacterCashItemEquipmentDto, CharacterCashItemEquipmentOptionDto, CharacterCashItemEquipmentPresetDto } from './dto/character/characterCashItemEquipment.js';
+export { CharacterCashItemEquipmentColoringPrismDto, CharacterCashItemEquipmentDto, CharacterCashItemEquipmentEffectPrismDto, CharacterCashItemEquipmentOptionDto, CharacterCashItemEquipmentPresetDto } from './dto/character/characterCashItemEquipment.js';
 export { CharacterDojangDto } from './dto/character/characterDojang.js';
 export { CharacterHexaMatrixDto, CharacterHexaMatrixEquipmentDto, CharacterHexaMatrixEquipmentLinkedSkillDto } from './dto/character/characterHexaMatrix.js';
 export { CharacterHexaMatrixStatCoreDto, CharacterHexaMatrixStatDto } from './dto/character/characterHexaMatrixStat.js';

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/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.1",
+  "version": "3.7.0",
   "description": "This JavaScript library enables the use of the MapleStory OpenAPI of Nexon.",
   "keywords": [
     "maplestory",

package/types/maplestory/api/common/dto/character/characterVMatrix.d.ts

@@ -10,7 +10,7 @@ export declare abstract class CharacterVMatrixCodeEquipmentDto {
     abstract vCoreName: string | null;
     abstract vCoreType: string | null;
     abstract vCoreLevel: number;
-    abstract vCoreSkill1: string;
+    abstract vCoreSkill1: string | null;
     abstract vCoreSkill2: string | null;
     abstract vCoreSkill3: string | null;
 }

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/dto/character/characterCashItemEquipment.d.ts

@@ -1,5 +1,5 @@
 import * as base from '../../../common/dto/character/characterCashItemEquipment';
-import { CharacterCashItemEquipmentBody, CharacterCashItemEquipmentColoringPrismBody, CharacterCashItemEquipmentOptionBody, CharacterCashItemEquipmentPresetBody } from '../../response/character/characterCashItemEquipmentBody';
+import { CharacterCashItemEquipmentBody, CharacterCashItemEquipmentColoringPrismBody, CharacterCashItemEquipmentEffectPrismBody, CharacterCashItemEquipmentOptionBody, CharacterCashItemEquipmentPresetBody } from '../../response/character/characterCashItemEquipmentBody';
 /**
  * 캐릭터 캐시 장비 아이템 정보
  */
@@ -80,6 +80,28 @@ export declare class CharacterCashItemEquipmentColoringPrismDto extends base.Cha
     value: number;
     constructor(obj: CharacterCashItemEquipmentColoringPrismBody);
 }
+/**
+ * 캐릭터 캐시 장비(무기) 이펙트 프리즘
+ */
+export declare class CharacterCashItemEquipmentEffectPrismDto {
+    /**
+     * 이펙트 프리즘 색상 범위
+     */
+    colorRange: string;
+    /**
+     * 이펙트 프리즘 색조
+     */
+    hue: number;
+    /**
+     * 이펙트 프리즘 채도
+     */
+    saturation: number;
+    /**
+     * 이펙트 프리즘 명도
+     */
+    value: number;
+    constructor(obj: CharacterCashItemEquipmentEffectPrismBody);
+}
 /**
  * 캐릭터 캐시 장비 옵션
  */
@@ -146,6 +168,10 @@ export declare class CharacterCashItemEquipmentPresetDto extends base.CharacterC
      * 캐시 장비 컬러링프리즘 정보
      */
     cashItemColoringPrism: CharacterCashItemEquipmentColoringPrismDto | null;
+    /**
+     * 캐시 장비(무기) 이펙트 프리즘 정보
+     */
+    cashItemEffectPrism: CharacterCashItemEquipmentEffectPrismDto | null;
     /**
      * 아이템 장착 가능 성별
      */
@@ -158,6 +184,10 @@ export declare class CharacterCashItemEquipmentPresetDto extends base.CharacterC
      * 프리스타일 쿠폰 적용 여부 (0:미적용, 1:적용)
      */
     freestyleFlag: string | null;
+    /**
+     * 표정 합성 정보
+     */
+    emotion_name: string | null;
     constructor(obj: CharacterCashItemEquipmentPresetBody);
     /**
      * 프리스타일 쿠폰 적용 여부

package/types/maplestory/api/kms/dto/character/characterSymbolEquipment.d.ts

@@ -34,6 +34,10 @@ export declare class CharacterSymbolEquipmentInfoDto extends base.CharacterSymbo
      * 심볼 설명
      */
     symbolDescription: string;
+    /**
+     * 심볼 부가 효과 설명
+     */
+    symbolOtherEffectDescription: string | null;
     /**
      * 심볼로 인한 증가 수치
      */

package/types/maplestory/api/kms/dto/character/characterVMatrix.d.ts

@@ -32,6 +32,7 @@ export declare class CharacterVMatrixCodeEquipmentDto extends base.CharacterVMat
     slotId: string;
     /**
      * 슬롯 레벨
+     * @deprecated 2025년 12월 18일 점검 이후부터 사용하지 않는 항목입니다.
      */
     slotLevel: number;
     /**
@@ -48,14 +49,17 @@ export declare class CharacterVMatrixCodeEquipmentDto extends base.CharacterVMat
     vCoreLevel: number;
     /**
      * 코어에 해당하는 스킬 명
+     * @deprecated 2025년 12월 18일 점검 이후부터 사용하지 않는 항목입니다.
      */
-    vCoreSkill1: string;
+    vCoreSkill1: string | null;
     /**
      * (강화 코어인 경우) 코어에 해당하는 두 번째 스킬 명
+     * @deprecated 2025년 12월 18일 점검 이후부터 사용하지 않는 항목입니다.
      */
     vCoreSkill2: string | null;
     /**
      * (강화 코어인 경우) 코어에 해당하는 세 번째 스킬 명
+     * @deprecated 2025년 12월 18일 점검 이후부터 사용하지 않는 항목입니다.
      */
     vCoreSkill3: string | null;
     constructor(obj: CharacterVMatrixCoreEquipmentDtoBody);

package/types/maplestory/api/kms/dto/notice/cashshopNoticeList.d.ts

@@ -21,6 +21,10 @@ export declare class CashshopNoticeListItemDto {
      * 공지 링크
      */
     url: string;
+    /**
+     * 썸네일 링크
+     */
+    thumbnailUrl: string;
     /**
      * 공지 식별자
      */

package/types/maplestory/api/kms/dto/notice/eventNoticeList.d.ts

@@ -21,6 +21,10 @@ export declare class EventNoticeListItemDto {
      * 공지 링크
      */
     url: string;
+    /**
+     * 썸네일 링크
+     */
+    thumbnailUrl: string;
     /**
      * 공지 식별자
      */

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>;
+}

package/types/maplestory/api/kms/response/character/characterCashItemEquipmentBody.d.ts

@@ -24,9 +24,11 @@ export type CharacterCashItemEquipmentPresetBody = {
     date_option_expire: string | null;
     cash_item_label: string | null;
     cash_item_coloring_prism: CharacterCashItemEquipmentColoringPrismBody | null;
+    cash_item_effect_prism: CharacterCashItemEquipmentEffectPrismBody | null;
     item_gender: string | null;
     skills: string[];
     freestyle_flag: string | null;
+    emotion_name: string | null;
 };
 export type CharacterCashItemEquipmentOptionBody = {
     option_type: string;
@@ -38,3 +40,9 @@ export type CharacterCashItemEquipmentColoringPrismBody = {
     saturation: number;
     value: number;
 };
+export type CharacterCashItemEquipmentEffectPrismBody = {
+    color_range: string;
+    hue: number;
+    saturation: number;
+    value: number;
+};

package/types/maplestory/api/kms/response/character/characterSymbolEquipmentBody.d.ts

@@ -7,6 +7,7 @@ export type CharacterSymbolEquipmentInfoBody = {
     symbol_name: string;
     symbol_icon: string;
     symbol_description: string;
+    symbol_other_effect_description: string | null;
     symbol_force: string;
     symbol_level: number;
     symbol_str: string;