maplestory-openapi 3.2.0 → 3.3.0

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

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

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

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

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

@@ -45,11 +45,11 @@ class CharacterImageDto extends characterImage.CharacterImageDto {
      */
     emotionFrame;
     /**
-     * 가로 길이. 배경 크기에 해당함, 96 (default) ~ 1000
+     * 가로 길이. 배경 크기에 해당함
      */
     width;
     /**
-     * 세로 길이. 배경 크기에 해당함, 96 (default) ~ 1000
+     * 세로 길이. 배경 크기에 해당함
      */
     height;
     /**

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

@@ -0,0 +1,62 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * 캐릭터 기타 능력치 영향 요소 정보
+ */
+class CharacterOtherStatDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date;
+    /**
+     * 능력치에 영향을 주는 요소 및 스탯 정보
+     */
+    otherStat;
+    constructor(obj) {
+        const { date, other_stat } = obj;
+        this.date = date ? new Date(date) : null;
+        this.otherStat = other_stat?.map((stat) => new CharacterOtherStatDetailDto(stat)) ?? [];
+    }
+}
+/**
+ * 능력치에 영향을 주는 요소 및 스탯 정보
+ */
+class CharacterOtherStatDetailDto {
+    /**
+     * 스탯 타입
+     */
+    otherStatType;
+    /**
+     * 스탯 정보
+     */
+    statInfo;
+    constructor(obj) {
+        const { other_stat_type, stat_info } = obj;
+        this.otherStatType = other_stat_type;
+        this.statInfo = stat_info.map((info) => new CharacterOtherStatInfoDto(info));
+    }
+}
+/**
+ * 스탯 정보
+ */
+class CharacterOtherStatInfoDto {
+    /**
+     * 스탯 명
+     */
+    statName;
+    /**
+     * 스탯 값
+     */
+    statValue;
+    constructor(obj) {
+        const { stat_name, stat_value } = obj;
+        this.statName = stat_name;
+        this.statValue = stat_value;
+    }
+}
+
+exports.CharacterOtherStatDetailDto = CharacterOtherStatDetailDto;
+exports.CharacterOtherStatDto = CharacterOtherStatDto;
+exports.CharacterOtherStatInfoDto = CharacterOtherStatInfoDto;

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

@@ -0,0 +1,34 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * 캐릭터 링 익스체인지 스킬 등록 장비 정보
+ */
+class CharacterRingExchangeSkillEquipmentDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date;
+    /**
+     * 캐릭터 직업
+     */
+    characterClass;
+    /**
+     * 링 익스체인지에 등록된 특수 반지
+     */
+    specialRingExchangeName;
+    /**
+     * 링 익스체인지에 등록된 특수 반지 레벨
+     */
+    specialRingExchangeLevel;
+    constructor(obj) {
+        const { date, character_class, special_ring_exchange_name, special_ring_exchange_level } = obj;
+        this.date = date ? new Date(date) : null;
+        this.characterClass = character_class ?? '';
+        this.specialRingExchangeName = special_ring_exchange_name ?? null;
+        this.specialRingExchangeLevel = special_ring_exchange_level ?? null;
+    }
+}
+
+exports.CharacterRingExchangeSkillEquipmentDto = CharacterRingExchangeSkillEquipmentDto;

package/dist/cjs/maplestory/api/kms/dto/history/cubeHistory.js

@@ -16,10 +16,6 @@ class CubeHistoryDto {
      * 캐릭터 명
      */
     characterName;
-    /**
-     * 월드 명
-     */
-    worldName;
     /**
      * 사용 일시
      */
@@ -81,10 +77,9 @@ class CubeHistoryDto {
      */
     afterAdditionalPotentialOption;
     constructor(obj) {
-        const { id, character_name, world_name, date_create, cube_type, item_upgrade_result, miracle_time_flag, item_equipment_part, item_level, target_item, potential_option_grade, additional_potential_option_grade, upgrade_guarantee, upgrade_guarantee_count, before_potential_option, before_additional_potential_option, after_potential_option, after_additional_potential_option, } = obj;
+        const { id, character_name, date_create, cube_type, item_upgrade_result, miracle_time_flag, item_equipment_part, item_level, target_item, potential_option_grade, additional_potential_option_grade, upgrade_guarantee, upgrade_guarantee_count, before_potential_option, before_additional_potential_option, after_potential_option, after_additional_potential_option, } = obj;
         this.id = id;
         this.characterName = character_name;
-        this.worldName = world_name;
         this.dateCreate = new Date(date_create);
         this.cubeType = cube_type;
         this.itemUpgradeResult = item_upgrade_result;

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

@@ -16,6 +16,7 @@ var characterHyperStat = require('./dto/character/characterHyperStat.js');
 var characterImage = require('./dto/character/characterImage.js');
 var characterItemEquipment = require('./dto/character/characterItemEquipment.js');
 var characterLinkSkill = require('./dto/character/characterLinkSkill.js');
+var characterOtherStat = require('./dto/character/characterOtherStat.js');
 var characterPetEquipment = require('./dto/character/characterPetEquipment.js');
 var characterPopularity = require('./dto/character/characterPopularity.js');
 var characterPropensity = require('./dto/character/characterPropensity.js');
@@ -98,6 +99,9 @@ exports.CharacterItemEquipmentTitleDto = characterItemEquipment.CharacterItemEqu
 exports.CharacterItemEquipmentTotalOptionDto = characterItemEquipment.CharacterItemEquipmentTotalOptionDto;
 exports.CharacterLinkSkillDto = characterLinkSkill.CharacterLinkSkillDto;
 exports.CharacterLinkSkillInfoDto = characterLinkSkill.CharacterLinkSkillInfoDto;
+exports.CharacterOtherStatDetailDto = characterOtherStat.CharacterOtherStatDetailDto;
+exports.CharacterOtherStatDto = characterOtherStat.CharacterOtherStatDto;
+exports.CharacterOtherStatInfoDto = characterOtherStat.CharacterOtherStatInfoDto;
 exports.CharacterPetEquipmentAutoSkillDto = characterPetEquipment.CharacterPetEquipmentAutoSkillDto;
 exports.CharacterPetEquipmentDto = characterPetEquipment.CharacterPetEquipmentDto;
 exports.CharacterPetEquipmentItemDto = characterPetEquipment.CharacterPetEquipmentItemDto;

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

@@ -18,9 +18,11 @@ var characterHyperStat = require('./dto/character/characterHyperStat.js');
 var characterImage$1 = require('./dto/character/characterImage.js');
 var characterItemEquipment = require('./dto/character/characterItemEquipment.js');
 var characterLinkSkill = require('./dto/character/characterLinkSkill.js');
+var characterOtherStat = require('./dto/character/characterOtherStat.js');
 var characterPetEquipment = require('./dto/character/characterPetEquipment.js');
 var characterPopularity = require('./dto/character/characterPopularity.js');
 var characterPropensity = require('./dto/character/characterPropensity.js');
+var characterRingExchangeSkillEquipment = require('./dto/character/characterRingExchangeSkillEquipment.js');
 var characterSetEffect = require('./dto/character/characterSetEffect.js');
 var characterSkill = require('./dto/character/characterSkill.js');
 var characterStat = require('./dto/character/characterStat.js');
@@ -96,7 +98,7 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         const { data } = await this.client.get(path);
         return new achievement.AchievementDto(data);
     }
-    //#endregin
+    //#endregion
     //#region 캐릭터 정보 조회
     /**
      * 캐릭터 식별자(ocid)를 조회합니다.
@@ -165,18 +167,14 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         const wmotion = imageOptions?.wmotion ?? characterImage.CharacterImageWeaponMotion.Default;
         const actionFrame = imageOptions?.actionFrame ?? 0;
         const emotionFrame = imageOptions?.emotionFrame ?? 0;
-        const width = 96;
-        const height = 96;
-        const x = imageOptions?.x ?? null;
-        const y = imageOptions?.y ?? null;
+        const width = 300;
+        const height = 300;
+        const x = 150;
+        const y = 200;
         const query = {
             action: `${action}.${actionFrame}`,
             emotion: `${emotion}.${emotionFrame}`,
             wmotion,
-            width,
-            height,
-            x,
-            y,
         };
         const urlImageToBase64 = async (path, query) => {
             const { data, headers } = await axios__default["default"].get(path, {
@@ -731,6 +729,64 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         });
         return new characterDojang.CharacterDojangDto(data);
     }
+    /**
+     * 능력치에 영향을 주는 요소 중 다른 조회에서 능력치 확인이 어려운 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 2025년 8월 21일 데이터부터 조회할 수 있습니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    async getCharacterOtherStat(ocid, dateOptions) {
+        const path = `${this.subUrl}/v1/character/other-stat`;
+        const date = dateOptions
+            ? this.toDateString(dateOptions, {
+                year: 2025,
+                month: 8,
+                day: 21,
+            })
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new characterOtherStat.CharacterOtherStatDto(data);
+    }
+    /**
+     * 링 익스체인지 스킬 등록 장비를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 2025년 8월 21일 데이터부터 조회할 수 있습니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (8월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    async getCharacterRingExchangeSkillEquipment(ocid, dateOptions) {
+        const path = `${this.subUrl}/v1/character/ring-exchange-skill-equipment`;
+        const date = dateOptions
+            ? this.toDateString(dateOptions, {
+                year: 2025,
+                month: 8,
+                day: 21,
+            })
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new characterRingExchangeSkillEquipment.CharacterRingExchangeSkillEquipmentDto(data);
+    }
     //#endregion
     //#region 유니온 정보 조회
     /**

package/dist/cjs/node_modules/base64-js/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');
 
 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-exports2.js');
-var index$2 = require('../../_virtual/index.js_commonjs-exports3.js');
+var index$1 = require('../../_virtual/index.js_commonjs-exports3.js');
+var index$2 = require('../../_virtual/index.js_commonjs-exports2.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-exports3.js');
+var index = require('../../_virtual/index.js_commonjs-exports2.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 base64Js = {};
+var ieee754 = {};
 
-export { base64Js as __exports };
+export { ieee754 as __exports };

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

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

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

@@ -41,11 +41,11 @@ class CharacterImageDto extends CharacterImageDto$1 {
      */
     emotionFrame;
     /**
-     * 가로 길이. 배경 크기에 해당함, 96 (default) ~ 1000
+     * 가로 길이. 배경 크기에 해당함
      */
     width;
     /**
-     * 세로 길이. 배경 크기에 해당함, 96 (default) ~ 1000
+     * 세로 길이. 배경 크기에 해당함
      */
     height;
     /**

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

@@ -0,0 +1,56 @@
+/**
+ * 캐릭터 기타 능력치 영향 요소 정보
+ */
+class CharacterOtherStatDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date;
+    /**
+     * 능력치에 영향을 주는 요소 및 스탯 정보
+     */
+    otherStat;
+    constructor(obj) {
+        const { date, other_stat } = obj;
+        this.date = date ? new Date(date) : null;
+        this.otherStat = other_stat?.map((stat) => new CharacterOtherStatDetailDto(stat)) ?? [];
+    }
+}
+/**
+ * 능력치에 영향을 주는 요소 및 스탯 정보
+ */
+class CharacterOtherStatDetailDto {
+    /**
+     * 스탯 타입
+     */
+    otherStatType;
+    /**
+     * 스탯 정보
+     */
+    statInfo;
+    constructor(obj) {
+        const { other_stat_type, stat_info } = obj;
+        this.otherStatType = other_stat_type;
+        this.statInfo = stat_info.map((info) => new CharacterOtherStatInfoDto(info));
+    }
+}
+/**
+ * 스탯 정보
+ */
+class CharacterOtherStatInfoDto {
+    /**
+     * 스탯 명
+     */
+    statName;
+    /**
+     * 스탯 값
+     */
+    statValue;
+    constructor(obj) {
+        const { stat_name, stat_value } = obj;
+        this.statName = stat_name;
+        this.statValue = stat_value;
+    }
+}
+
+export { CharacterOtherStatDetailDto, CharacterOtherStatDto, CharacterOtherStatInfoDto };

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

@@ -0,0 +1,30 @@
+/**
+ * 캐릭터 링 익스체인지 스킬 등록 장비 정보
+ */
+class CharacterRingExchangeSkillEquipmentDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date;
+    /**
+     * 캐릭터 직업
+     */
+    characterClass;
+    /**
+     * 링 익스체인지에 등록된 특수 반지
+     */
+    specialRingExchangeName;
+    /**
+     * 링 익스체인지에 등록된 특수 반지 레벨
+     */
+    specialRingExchangeLevel;
+    constructor(obj) {
+        const { date, character_class, special_ring_exchange_name, special_ring_exchange_level } = obj;
+        this.date = date ? new Date(date) : null;
+        this.characterClass = character_class ?? '';
+        this.specialRingExchangeName = special_ring_exchange_name ?? null;
+        this.specialRingExchangeLevel = special_ring_exchange_level ?? null;
+    }
+}
+
+export { CharacterRingExchangeSkillEquipmentDto };

package/dist/esm/maplestory/api/kms/dto/history/cubeHistory.js

@@ -12,10 +12,6 @@ class CubeHistoryDto {
      * 캐릭터 명
      */
     characterName;
-    /**
-     * 월드 명
-     */
-    worldName;
     /**
      * 사용 일시
      */
@@ -77,10 +73,9 @@ class CubeHistoryDto {
      */
     afterAdditionalPotentialOption;
     constructor(obj) {
-        const { id, character_name, world_name, date_create, cube_type, item_upgrade_result, miracle_time_flag, item_equipment_part, item_level, target_item, potential_option_grade, additional_potential_option_grade, upgrade_guarantee, upgrade_guarantee_count, before_potential_option, before_additional_potential_option, after_potential_option, after_additional_potential_option, } = obj;
+        const { id, character_name, date_create, cube_type, item_upgrade_result, miracle_time_flag, item_equipment_part, item_level, target_item, potential_option_grade, additional_potential_option_grade, upgrade_guarantee, upgrade_guarantee_count, before_potential_option, before_additional_potential_option, after_potential_option, after_additional_potential_option, } = obj;
         this.id = id;
         this.characterName = character_name;
-        this.worldName = world_name;
         this.dateCreate = new Date(date_create);
         this.cubeType = cube_type;
         this.itemUpgradeResult = item_upgrade_result;

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

@@ -12,6 +12,7 @@ export { CharacterHyperStatDto, CharacterHyperStatPresetDto } from './dto/charac
 export { CharacterImageDto } from './dto/character/characterImage.js';
 export { CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentMedalShapeDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto } from './dto/character/characterItemEquipment.js';
 export { CharacterLinkSkillDto, CharacterLinkSkillInfoDto } from './dto/character/characterLinkSkill.js';
+export { CharacterOtherStatDetailDto, CharacterOtherStatDto, CharacterOtherStatInfoDto } from './dto/character/characterOtherStat.js';
 export { CharacterPetEquipmentAutoSkillDto, CharacterPetEquipmentDto, CharacterPetEquipmentItemDto, CharacterPetEquipmentItemOptionDto } from './dto/character/characterPetEquipment.js';
 export { CharacterPopularityDto } from './dto/character/characterPopularity.js';
 export { CharacterPropensityDto } from './dto/character/characterPropensity.js';

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

@@ -14,9 +14,11 @@ import { CharacterHyperStatDto } from './dto/character/characterHyperStat.js';
 import { CharacterImageDto } from './dto/character/characterImage.js';
 import { CharacterItemEquipmentDto } from './dto/character/characterItemEquipment.js';
 import { CharacterLinkSkillDto } from './dto/character/characterLinkSkill.js';
+import { CharacterOtherStatDto } from './dto/character/characterOtherStat.js';
 import { CharacterPetEquipmentDto } from './dto/character/characterPetEquipment.js';
 import { CharacterPopularityDto } from './dto/character/characterPopularity.js';
 import { CharacterPropensityDto } from './dto/character/characterPropensity.js';
+import { CharacterRingExchangeSkillEquipmentDto } from './dto/character/characterRingExchangeSkillEquipment.js';
 import { CharacterSetEffectDto } from './dto/character/characterSetEffect.js';
 import { CharacterSkillDto } from './dto/character/characterSkill.js';
 import { CharacterStatDto } from './dto/character/characterStat.js';
@@ -87,7 +89,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path);
         return new AchievementDto(data);
     }
-    //#endregin
+    //#endregion
     //#region 캐릭터 정보 조회
     /**
      * 캐릭터 식별자(ocid)를 조회합니다.
@@ -156,18 +158,14 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const wmotion = imageOptions?.wmotion ?? CharacterImageWeaponMotion.Default;
         const actionFrame = imageOptions?.actionFrame ?? 0;
         const emotionFrame = imageOptions?.emotionFrame ?? 0;
-        const width = 96;
-        const height = 96;
-        const x = imageOptions?.x ?? null;
-        const y = imageOptions?.y ?? null;
+        const width = 300;
+        const height = 300;
+        const x = 150;
+        const y = 200;
         const query = {
             action: `${action}.${actionFrame}`,
             emotion: `${emotion}.${emotionFrame}`,
             wmotion,
-            width,
-            height,
-            x,
-            y,
         };
         const urlImageToBase64 = async (path, query) => {
             const { data, headers } = await axios.get(path, {
@@ -722,6 +720,64 @@ class MapleStoryApi extends MapleStoryApi$1 {
         });
         return new CharacterDojangDto(data);
     }
+    /**
+     * 능력치에 영향을 주는 요소 중 다른 조회에서 능력치 확인이 어려운 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 2025년 8월 21일 데이터부터 조회할 수 있습니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    async getCharacterOtherStat(ocid, dateOptions) {
+        const path = `${this.subUrl}/v1/character/other-stat`;
+        const date = dateOptions
+            ? this.toDateString(dateOptions, {
+                year: 2025,
+                month: 8,
+                day: 21,
+            })
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new CharacterOtherStatDto(data);
+    }
+    /**
+     * 링 익스체인지 스킬 등록 장비를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 2025년 8월 21일 데이터부터 조회할 수 있습니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (8월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    async getCharacterRingExchangeSkillEquipment(ocid, dateOptions) {
+        const path = `${this.subUrl}/v1/character/ring-exchange-skill-equipment`;
+        const date = dateOptions
+            ? this.toDateString(dateOptions, {
+                year: 2025,
+                month: 8,
+                day: 21,
+            })
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new CharacterRingExchangeSkillEquipmentDto(data);
+    }
     //#endregion
     //#region 유니온 정보 조회
     /**

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

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

package/package.json

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

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

@@ -120,21 +120,5 @@ type CharacterImageOptions = {
      * Character emotion frame
      */
     emotionFrame?: number;
-    /**
-     * Horizontal length (corresponding to the background size, 96 (default) ~ 1000)
-     */
-    width?: number;
-    /**
-     * Vertical length (corresponding to the background size, 96 (default) ~ 1000)
-     */
-    height?: number;
-    /**
-     * Horizontal coordinate of the character (coordinate range 0 < x < width, 0 is the left starting point)
-     */
-    x?: number;
-    /**
-     * Vertical coordinate of the character (coordinate range 0 < y < height, 0 is the top starting point)
-     */
-    y?: number;
 };
 export {};

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

@@ -41,11 +41,11 @@ export declare class CharacterImageDto extends base.CharacterImageDto {
      */
     emotionFrame: number | null;
     /**
-     * 가로 길이. 배경 크기에 해당함, 96 (default) ~ 1000
+     * 가로 길이. 배경 크기에 해당함
      */
     width: number;
     /**
-     * 세로 길이. 배경 크기에 해당함, 96 (default) ~ 1000
+     * 세로 길이. 배경 크기에 해당함
      */
     height: number;
     /**

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

@@ -0,0 +1,43 @@
+import { CharacterOtherStatBody, CharacterOtherStatDetailBody, CharacterOtherStatInfoBody } from '../../response/character/characterOtherStatBody';
+/**
+ * 캐릭터 기타 능력치 영향 요소 정보
+ */
+export declare class CharacterOtherStatDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date: Date | null;
+    /**
+     * 능력치에 영향을 주는 요소 및 스탯 정보
+     */
+    otherStat: CharacterOtherStatDetailDto[];
+    constructor(obj: CharacterOtherStatBody);
+}
+/**
+ * 능력치에 영향을 주는 요소 및 스탯 정보
+ */
+export declare class CharacterOtherStatDetailDto {
+    /**
+     * 스탯 타입
+     */
+    otherStatType: string;
+    /**
+     * 스탯 정보
+     */
+    statInfo: CharacterOtherStatInfoDto[];
+    constructor(obj: CharacterOtherStatDetailBody);
+}
+/**
+ * 스탯 정보
+ */
+export declare class CharacterOtherStatInfoDto {
+    /**
+     * 스탯 명
+     */
+    statName: string;
+    /**
+     * 스탯 값
+     */
+    statValue: string;
+    constructor(obj: CharacterOtherStatInfoBody);
+}

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

@@ -0,0 +1,23 @@
+import { CharacterRingExchangeSkillEquipmentBody } from '../../response/character/characterRingExchangeSkillEquipmentBody';
+/**
+ * 캐릭터 링 익스체인지 스킬 등록 장비 정보
+ */
+export declare class CharacterRingExchangeSkillEquipmentDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date: Date | null;
+    /**
+     * 캐릭터 직업
+     */
+    characterClass: string;
+    /**
+     * 링 익스체인지에 등록된 특수 반지
+     */
+    specialRingExchangeName: string | null;
+    /**
+     * 링 익스체인지에 등록된 특수 반지 레벨
+     */
+    specialRingExchangeLevel: number | null;
+    constructor(obj: CharacterRingExchangeSkillEquipmentBody);
+}

package/types/maplestory/api/kms/dto/history/cubeHistory.d.ts

@@ -12,10 +12,6 @@ export declare class CubeHistoryDto {
      * 캐릭터 명
      */
     characterName: string;
-    /**
-     * 월드 명
-     */
-    worldName: string;
     /**
      * 사용 일시
      */

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

@@ -12,6 +12,7 @@ export * from './dto/character/characterHyperStat';
 export * from './dto/character/characterImage';
 export * from './dto/character/characterItemEquipment';
 export * from './dto/character/characterLinkSkill';
+export * from './dto/character/characterOtherStat';
 export * from './dto/character/characterPetEquipment';
 export * from './dto/character/characterPopularity';
 export * from './dto/character/characterPropensity';

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

@@ -11,9 +11,11 @@ import { CharacterHyperStatDto } from './dto/character/characterHyperStat';
 import { CharacterImageDto } from './dto/character/characterImage';
 import { CharacterItemEquipmentDto } from './dto/character/characterItemEquipment';
 import { CharacterLinkSkillDto } from './dto/character/characterLinkSkill';
+import { CharacterOtherStatDto } from './dto/character/characterOtherStat';
 import { CharacterPetEquipmentDto } from './dto/character/characterPetEquipment';
 import { CharacterPopularityDto } from './dto/character/characterPopularity';
 import { CharacterPropensityDto } from './dto/character/characterPropensity';
+import { CharacterRingExchangeSkillEquipmentDto } from './dto/character/characterRingExchangeSkillEquipment';
 import { CharacterSetEffectDto } from './dto/character/characterSetEffect';
 import { CharacterSkillDto } from './dto/character/characterSkill';
 import { CharacterStatDto } from './dto/character/characterStat';
@@ -325,6 +327,30 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param dateOptions 조회 기준일 (KST)
      */
     getCharacterDojang(ocid: string, dateOptions?: DateOptions): Promise<CharacterDojangDto>;
+    /**
+     * 능력치에 영향을 주는 요소 중 다른 조회에서 능력치 확인이 어려운 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 2025년 8월 21일 데이터부터 조회할 수 있습니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    getCharacterOtherStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterOtherStatDto>;
+    /**
+     * 링 익스체인지 스킬 등록 장비를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 2025년 8월 21일 데이터부터 조회할 수 있습니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (8월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    getCharacterRingExchangeSkillEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterRingExchangeSkillEquipmentDto>;
     /**
      * 유니온 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -623,22 +649,6 @@ type CharacterImageOptions = {
      * 캐릭터 감정표현 프레임
      */
     emotionFrame?: number;
-    /**
-     * 가로 길이. 배경 크기에 해당함, 96 (default) ~ 1000
-     */
-    width?: number;
-    /**
-     * 세로 길이. 배경 크기에 해당함, 96 (default) ~ 1000
-     */
-    height?: number;
-    /**
-     * 캐릭터의 가로 좌표
-     */
-    x?: number;
-    /**
-     * 캐릭터의 세로 좌표.
-     */
-    y?: number;
 };
 type OverallRankingApiFilterOptions = {
     /**

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

@@ -0,0 +1,12 @@
+export interface CharacterOtherStatBody {
+    date: string | null;
+    other_stat: CharacterOtherStatDetailBody[] | null;
+}
+export interface CharacterOtherStatDetailBody {
+    other_stat_type: string;
+    stat_info: CharacterOtherStatInfoBody[];
+}
+export interface CharacterOtherStatInfoBody {
+    stat_name: string;
+    stat_value: string;
+}

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

@@ -0,0 +1,6 @@
+export interface CharacterRingExchangeSkillEquipmentBody {
+    date?: string;
+    character_class?: string;
+    special_ring_exchange_name?: string;
+    special_ring_exchange_level?: number;
+}

package/types/maplestory/api/kms/response/history/cubeHistoryBody.d.ts

@@ -5,7 +5,6 @@ export type CubeResultOptionBody = {
 export type CubeHistoryBody = {
     id: string;
     character_name: string;
-    world_name: string;
     date_create: string;
     cube_type: string;
     item_upgrade_result: string;