maplestory-openapi 2.4.1 → 2.7.1

package/dist/index.mjs

@@ -7,7 +7,7 @@ var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof win
 var timezone$1 = {exports: {}};
 
 (function (module, exports) {
-!function(t,e){module.exports=e();}(commonjsGlobal,(function(){var t={year:0,month:1,day:2,hour:3,minute:4,second:5},e={};return function(n,i,o){var r,a=function(t,n,i){void 0===i&&(i={});var o=new Date(t),r=function(t,n){void 0===n&&(n={});var i=n.timeZoneName||"short",o=t+"|"+i,r=e[o];return r||(r=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:i}),e[o]=r),r}(n,i);return r.formatToParts(o)},u=function(e,n){for(var i=a(e,n),r=[],u=0;u<i.length;u+=1){var f=i[u],s=f.type,m=f.value,c=t[s];c>=0&&(r[c]=parseInt(m,10));}var d=r[3],l=24===d?0:d,h=r[0]+"-"+r[1]+"-"+r[2]+" "+l+":"+r[4]+":"+r[5]+":000",v=+e;return (o.utc(h).valueOf()-(v-=v%1e3))/6e4},f=i.prototype;f.tz=function(t,e){void 0===t&&(t=r);var n=this.utcOffset(),i=this.toDate(),a=i.toLocaleString("en-US",{timeZone:t}),u=Math.round((i-new Date(a))/1e3/60),f=o(a,{locale:this.$L}).$set("millisecond",this.$ms).utcOffset(15*-Math.round(i.getTimezoneOffset()/15)-u,!0);if(e){var s=f.utcOffset();f=f.add(n-s,"minute");}return f.$x.$timezone=t,f},f.offsetName=function(t){var e=this.$x.$timezone||o.tz.guess(),n=a(this.valueOf(),e,{timeZoneName:t}).find((function(t){return "timezonename"===t.type.toLowerCase()}));return n&&n.value};var s=f.startOf;f.startOf=function(t,e){if(!this.$x||!this.$x.$timezone)return s.call(this,t,e);var n=o(this.format("YYYY-MM-DD HH:mm:ss:SSS"),{locale:this.$L});return s.call(n,t,e).tz(this.$x.$timezone,!0)},o.tz=function(t,e,n){var i=n&&e,a=n||e||r,f=u(+o(),a);if("string"!=typeof t)return o(t).tz(a);var s=function(t,e,n){var i=t-60*e*1e3,o=u(i,n);if(e===o)return [i,e];var r=u(i-=60*(o-e)*1e3,n);return o===r?[i,o]:[t-60*Math.min(o,r)*1e3,Math.max(o,r)]}(o.utc(t,i).valueOf(),f,a),m=s[0],c=s[1],d=o(m).utcOffset(c);return d.$x.$timezone=a,d},o.tz.guess=function(){return Intl.DateTimeFormat().resolvedOptions().timeZone},o.tz.setDefault=function(t){r=t;};}}));
+!function(t,e){module.exports=e();}(commonjsGlobal,(function(){var t={year:0,month:1,day:2,hour:3,minute:4,second:5},e={};return function(n,i,o){var r,a=function(t,n,i){void 0===i&&(i={});var o=new Date(t),r=function(t,n){void 0===n&&(n={});var i=n.timeZoneName||"short",o=t+"|"+i,r=e[o];return r||(r=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:i}),e[o]=r),r}(n,i);return r.formatToParts(o)},u=function(e,n){for(var i=a(e,n),r=[],u=0;u<i.length;u+=1){var f=i[u],s=f.type,m=f.value,c=t[s];c>=0&&(r[c]=parseInt(m,10));}var d=r[3],l=24===d?0:d,h=r[0]+"-"+r[1]+"-"+r[2]+" "+l+":"+r[4]+":"+r[5]+":000",v=+e;return (o.utc(h).valueOf()-(v-=v%1e3))/6e4},f=i.prototype;f.tz=function(t,e){void 0===t&&(t=r);var n,i=this.utcOffset(),a=this.toDate(),u=a.toLocaleString("en-US",{timeZone:t}),f=Math.round((a-new Date(u))/1e3/60),s=15*-Math.round(a.getTimezoneOffset()/15)-f;if(!Number(s))n=this.utcOffset(0,e);else if(n=o(u,{locale:this.$L}).$set("millisecond",this.$ms).utcOffset(s,!0),e){var m=n.utcOffset();n=n.add(i-m,"minute");}return n.$x.$timezone=t,n},f.offsetName=function(t){var e=this.$x.$timezone||o.tz.guess(),n=a(this.valueOf(),e,{timeZoneName:t}).find((function(t){return "timezonename"===t.type.toLowerCase()}));return n&&n.value};var s=f.startOf;f.startOf=function(t,e){if(!this.$x||!this.$x.$timezone)return s.call(this,t,e);var n=o(this.format("YYYY-MM-DD HH:mm:ss:SSS"),{locale:this.$L});return s.call(n,t,e).tz(this.$x.$timezone,!0)},o.tz=function(t,e,n){var i=n&&e,a=n||e||r,f=u(+o(),a);if("string"!=typeof t)return o(t).tz(a);var s=function(t,e,n){var i=t-60*e*1e3,o=u(i,n);if(e===o)return [i,e];var r=u(i-=60*(o-e)*1e3,n);return o===r?[i,o]:[t-60*Math.min(o,r)*1e3,Math.max(o,r)]}(o.utc(t,i).valueOf(),f,a),m=s[0],c=s[1],d=o(m).utcOffset(c);return d.$x.$timezone=a,d},o.tz.guess=function(){return Intl.DateTimeFormat().resolvedOptions().timeZone},o.tz.setDefault=function(t){r=t;};}}));
 }(timezone$1));
 
 var timezone = timezone$1.exports;
@@ -102,7 +102,7 @@ class CharacterAbilityDto {
     constructor(obj) {
         const { date, ability_grade, ability_info, remain_fame, preset_no, ability_preset_1, ability_preset_2, ability_preset_3, } = obj;
         // 날짜는 Date 객체로 변환
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.abilityGrade = ability_grade;
         this.abilityInfo = ability_info.map((info) => new CharacterAbilityInfoDto(info));
         this.remainFame = remain_fame;
@@ -435,7 +435,7 @@ class CharacterAndroidEquipmentDto {
     androidPreset3;
     constructor(obj) {
         const { date, android_name, android_nickname, android_icon, android_description, android_hair, android_face, android_skin_name, android_cash_item_equipment, android_ear_sensor_clip_flag, android_gender, android_grade, android_non_humanoid_flag, android_shop_usable_flag, preset_no, android_preset_1, android_preset_2, android_preset_3, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.androidName = android_name;
         this.androidNickname = android_nickname;
         this.androidIcon = android_icon;
@@ -501,9 +501,21 @@ class CharacterBasicDto {
      * 캐릭터 외형 이미지
      */
     characterImage;
+    /**
+     * 캐릭터 생성일
+     */
+    characterDateCreate;
+    /**
+     * 최근 7일간 접속 여부
+     */
+    accessFlag;
+    /**
+     * 해방 퀘스트 완료 여부
+     */
+    liberationQuestClearFlag;
     constructor(obj) {
-        const { date, character_name, world_name, character_gender, character_class, character_class_level, character_level, character_exp, character_exp_rate, character_guild_name, character_image, } = obj;
-        this.date = new Date(date);
+        const { date, character_name, world_name, character_gender, character_class, character_class_level, character_level, character_exp, character_exp_rate, character_guild_name, character_image, character_date_create, access_flag, liberation_quest_clear_flag, } = obj;
+        this.date = date ? new Date(date) : null;
         this.characterName = character_name;
         this.worldName = world_name;
         this.characterGender = character_gender;
@@ -514,6 +526,21 @@ class CharacterBasicDto {
         this.characterExpRate = character_exp_rate;
         this.characterGuildName = character_guild_name;
         this.characterImage = character_image;
+        this.characterDateCreate = new Date(character_date_create);
+        this.accessFlag = access_flag;
+        this.liberationQuestClearFlag = liberation_quest_clear_flag;
+    }
+    /**
+     * 최근 7일간 접속 여부
+     */
+    get isAccessFlag() {
+        return this.accessFlag === 'true';
+    }
+    /**
+     * 해방 퀘스트 완료 여부
+     */
+    get isLiberationQuestClearFlag() {
+        return this.liberationQuestClearFlag === 'true';
     }
 }
 
@@ -620,7 +647,7 @@ class CharacterBeautyEquipmentDto {
     additionalCharacterSkinName;
     constructor(obj) {
         const { date, character_gender, character_class, character_hair, character_face, character_skin_name, additional_character_hair, additional_character_face, additional_character_skin_name, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterGender = character_gender;
         this.characterClass = character_class;
         this.characterHair = new CharacterBeautyEquipmentHairDto(character_hair);
@@ -804,7 +831,7 @@ class CharacterCashItemEquipmentDto {
     additionalCashItemEquipmentPreset3;
     constructor(obj) {
         const { date, character_gender, character_class, preset_no, cash_item_equipment_base, cash_item_equipment_preset_1, cash_item_equipment_preset_2, cash_item_equipment_preset_3, additional_cash_item_equipment_base, additional_cash_item_equipment_preset_1, additional_cash_item_equipment_preset_2, additional_cash_item_equipment_preset_3, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterGender = character_gender;
         this.characterClass = character_class;
         this.presetNo = preset_no;
@@ -853,7 +880,7 @@ class CharacterDojangDto {
     dojangBestTime;
     constructor(obj) {
         const { date, character_class, world_name, dojang_best_floor, date_dojang_record, dojang_best_time, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterClass = character_class;
         this.worldName = world_name;
         this.dojangBestFloor = dojang_best_floor;
@@ -935,7 +962,7 @@ class CharacterHexaMatrixDto {
     characterHexaCoreEquipment;
     constructor(obj) {
         const { date, character_hexa_core_equipment } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterHexaCoreEquipment = character_hexa_core_equipment.map((equipment) => new CharacterHexaMatrixEquipmentDto(equipment));
     }
 }
@@ -1011,7 +1038,7 @@ class CharacterHexaMatrixStatDto {
     presetHexaStatCore;
     constructor(obj) {
         const { date, character_class, character_hexa_stat_core, preset_hexa_stat_core, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterClass = character_class;
         this.characterHexaStatCore = character_hexa_stat_core.map((core) => new CharacterHexaMatrixStatCoreDto(core));
         this.presetHexaStatCore = preset_hexa_stat_core.map((core) => new CharacterHexaMatrixStatCoreDto(core));
@@ -1093,7 +1120,7 @@ class CharacterHyperStatDto {
     hyperStatPreset3RemainPoint;
     constructor(obj) {
         const { date, character_class, use_preset_no, use_available_hyper_stat, hyper_stat_preset_1, hyper_stat_preset_1_remain_point, hyper_stat_preset_2, hyper_stat_preset_2_remain_point, hyper_stat_preset_3, hyper_stat_preset_3_remain_point, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterClass = character_class;
         this.usePresetNo = use_preset_no;
         this.useAvailableHyperStat = use_available_hyper_stat;
@@ -2142,7 +2169,7 @@ class CharacterItemEquipmentDto {
     mechanicEquipment;
     constructor(obj) {
         const { date, character_gender, character_class, preset_no, item_equipment, item_equipment_preset_1, item_equipment_preset_2, item_equipment_preset_3, title, dragon_equipment, mechanic_equipment, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterGender = character_gender;
         this.characterClass = character_class;
         this.presetNo = preset_no;
@@ -2176,16 +2203,21 @@ class CharacterLinkSkillInfoDto {
      * 스킬 효과
      */
     skillEffect;
+    /**
+     * 다음 레벨의 스킬 효과
+     */
+    skillEffectNext;
     /**
      * 스킬 아이콘
      */
     skillIcon;
     constructor(obj) {
-        const { skill_name, skill_description, skill_level, skill_effect, skill_icon, } = obj;
+        const { skill_name, skill_description, skill_level, skill_effect, skill_effect_next, skill_icon, } = obj;
         this.skillName = skill_name;
         this.skillDescription = skill_description;
         this.skillLevel = skill_level;
         this.skillEffect = skill_effect;
+        this.skillEffectNext = skill_effect_next;
         this.skillIcon = skill_icon;
     }
 }
@@ -2236,7 +2268,7 @@ class CharacterLinkSkillDto {
     characterOwnedLinkSkillPreset3;
     constructor(obj) {
         const { date, character_class, character_link_skill, character_link_skill_preset_1, character_link_skill_preset_2, character_link_skill_preset_3, character_owned_link_skill, character_owned_link_skill_preset_1, character_owned_link_skill_preset_2, character_owned_link_skill_preset_3, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterClass = character_class;
         this.characterLinkSkill = character_link_skill.map((skill) => new CharacterLinkSkillInfoDto(skill));
         this.characterLinkSkillPreset1 = character_link_skill_preset_1.map((skill) => new CharacterLinkSkillInfoDto(skill));
@@ -2249,6 +2281,73 @@ class CharacterLinkSkillDto {
     }
 }
 
+/**
+ * 캐릭터 정보
+ */
+class CharacterListAccountCharacterDto {
+    /**
+     * 캐릭터 식별자
+     */
+    ocid;
+    /**
+     * 캐릭터 명
+     */
+    characterName;
+    /**
+     * 월드 명
+     */
+    worldName;
+    /**
+     * 캐릭터 직업
+     */
+    characterClass;
+    /**
+     * 캐릭터 레벨
+     */
+    characterLevel;
+    constructor(obj) {
+        const { ocid, character_name, world_name, character_class, character_level, } = obj;
+        this.ocid = ocid;
+        this.characterName = character_name;
+        this.worldName = world_name;
+        this.characterClass = character_class;
+        this.characterLevel = character_level;
+    }
+}
+
+/**
+ * 메이플스토리 계정
+ */
+class CharacterListAccountDto {
+    /**
+     * 메이플스토리 계정 식별자
+     */
+    accountId;
+    /**
+     * 캐릭터 목록
+     */
+    characterList;
+    constructor(obj) {
+        const { account_id, character_list } = obj;
+        this.accountId = account_id;
+        this.characterList = character_list.map(character => new CharacterListAccountCharacterDto(character));
+    }
+}
+
+/**
+ * 계정의 보유 캐릭터 목록
+ */
+class CharacterListDto {
+    /**
+     * 메이플스토리 계정 목록
+     */
+    accountList;
+    constructor(obj) {
+        const { account_list } = obj;
+        this.accountList = account_list.map(account => new CharacterListAccountDto(account));
+    }
+}
+
 /**
  * 캐릭터 펫 장비 자동 스킬 정보
  */
@@ -2488,7 +2587,7 @@ class CharacterPetEquipmentDto {
     pet3AppearanceIcon;
     constructor(obj) {
         const { date, pet_1_name, pet_1_nickname, pet_1_icon, pet_1_description, pet_1_equipment, pet_1_auto_skill, pet_1_pet_type, pet_1_skill, pet_1_date_expire, pet_1_appearance, pet_1_appearance_icon, pet_2_name, pet_2_nickname, pet_2_icon, pet_2_description, pet_2_equipment, pet_2_auto_skill, pet_2_pet_type, pet_2_skill, pet_2_date_expire, pet_2_appearance, pet_2_appearance_icon, pet_3_name, pet_3_nickname, pet_3_icon, pet_3_description, pet_3_equipment, pet_3_auto_skill, pet_3_pet_type, pet_3_skill, pet_3_date_expire, pet_3_appearance, pet_3_appearance_icon, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.pet1Name = pet_1_name;
         this.pet1Nickname = pet_1_nickname;
         this.pet1Icon = pet_1_icon;
@@ -2539,7 +2638,7 @@ class CharacterPopularityDto {
     popularity;
     constructor(obj) {
         const { date, popularity } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.popularity = popularity;
     }
 }
@@ -2575,7 +2674,7 @@ class CharacterPropensityDto {
     charmLevel;
     constructor(obj) {
         const { date, charisma_level, sensibility_level, insight_level, willingness_level, handicraft_level, charm_level, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.charismaLevel = charisma_level;
         this.sensibilityLevel = sensibility_level;
         this.insightLevel = insight_level;
@@ -2586,15 +2685,15 @@ class CharacterPropensityDto {
 }
 
 /**
- * 캐릭터 세트 효과 옵션 정보
+ * 적용 중인 세트 효과 정보
  */
-class CharacterSetEffectOptionInfoDto {
+class CharacterSetEffectInfoDto {
     /**
      * 세트 효과 레벨 (장비 수)
      */
     setCount;
     /**
-     * 적용 중인 세트 효과
+     * 세트 효과
      */
     setOption;
     constructor(obj) {
@@ -2605,9 +2704,28 @@ class CharacterSetEffectOptionInfoDto {
 }
 
 /**
- * 캐릭터 세트 효과 정보
+ * 모든 세트 효과 정보
  */
-class CharacterSetEffectInfoDto {
+class CharacterSetEffectOptionFullDto {
+    /**
+     * 세트 효과 레벨 (장비 수)
+     */
+    setCount;
+    /**
+     * 세트 효과
+     */
+    setOption;
+    constructor(obj) {
+        const { set_count, set_option } = obj;
+        this.setCount = set_count;
+        this.setOption = set_option;
+    }
+}
+
+/**
+ * 세트 효과 정보
+ */
+class CharacterSetEffectSetDto {
     /**
      * 세트 효과 명
      */
@@ -2617,14 +2735,19 @@ class CharacterSetEffectInfoDto {
      */
     totalSetCount;
     /**
-     * 세트 효과 옵션
+     * 적용 중인 세트 효과 정보
      */
     setEffectInfo;
+    /**
+     * 모든 세트 효과 정보
+     */
+    setOptionFull;
     constructor(obj) {
-        const { set_name, total_set_count, set_effect_info } = obj;
+        const { set_name, total_set_count, set_effect_info, set_option_full } = obj;
         this.setName = set_name;
         this.totalSetCount = total_set_count;
-        this.setEffectInfo = set_effect_info.map((info) => new CharacterSetEffectOptionInfoDto(info));
+        this.setEffectInfo = set_effect_info.map((info) => new CharacterSetEffectInfoDto(info));
+        this.setOptionFull = set_option_full.map((info) => new CharacterSetEffectOptionFullDto(info));
     }
 }
 
@@ -2642,8 +2765,8 @@ class CharacterSetEffectDto {
     setEffect;
     constructor(obj) {
         const { date, set_effect } = obj;
-        this.date = new Date(date);
-        this.setEffect = set_effect.map((effect) => new CharacterSetEffectInfoDto(effect));
+        this.date = date ? new Date(date) : null;
+        this.setEffect = set_effect.map((effect) => new CharacterSetEffectSetDto(effect));
     }
 }
 
@@ -2667,16 +2790,21 @@ class CharacterSkillInfoDto {
      * 스킬 레벨 별 효과 설명
      */
     skillEffect;
+    /**
+     * 다음 스킬 레벨 효과 설명
+     */
+    skillEffectNext;
     /**
      * 스킬 아이콘
      */
     skillIcon;
     constructor(obj) {
-        const { skill_name, skill_description, skill_level, skill_effect, skill_icon, } = obj;
+        const { skill_name, skill_description, skill_level, skill_effect, skill_effect_next, skill_icon, } = obj;
         this.skillName = skill_name;
         this.skillDescription = skill_description;
         this.skillLevel = skill_level;
         this.skillEffect = skill_effect;
+        this.skillEffectNext = skill_effect_next;
         this.skillIcon = skill_icon;
     }
 }
@@ -2703,7 +2831,7 @@ class CharacterSkillDto {
     characterSkill;
     constructor(obj) {
         const { date, character_class, character_skill_grade, character_skill } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterClass = character_class;
         this.characterSkillGrade = character_skill_grade;
         this.characterSkill = character_skill.map((skill) => new CharacterSkillInfoDto(skill));
@@ -2732,7 +2860,7 @@ class CharacterStatDto {
     remainAP;
     constructor(obj) {
         const { date, character_class, final_stat, remain_ap } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterClass = character_class;
         this.finalStat = final_stat.map((stat) => {
             return {
@@ -2831,7 +2959,7 @@ class CharacterSymbolEquipmentDto {
     symbol;
     constructor(obj) {
         const { date, character_class, symbol } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterClass = character_class;
         this.symbol = symbol.map((s) => new CharacterSymbolEquipmentInfoDto(s));
     }
@@ -2908,7 +3036,7 @@ class CharacterVMatrixDto {
     characterVMatrixRemainSlotUpgradePoint;
     constructor(obj) {
         const { date, character_class, character_v_core_equipment, character_v_matrix_remain_slot_upgrade_point, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.characterClass = character_class;
         this.characterVCoreEquipment = character_v_core_equipment.map((equipment) => new CharacterVMatrixCodeEquipmentDto(equipment));
         this.characterVMatrixRemainSlotUpgradePoint =
@@ -2998,17 +3126,9 @@ class GuildBasicDto {
      * 노블레스 스킬 목록
      */
     guildNoblesseSkill;
-    /**
-     * 조합형 길드 마크
-     */
-    guildMark;
-    /**
-     * 커스텀 길드 마크 (base64 인코딩 형식)
-     */
-    guildMarkCustom;
     constructor(obj) {
-        const { date, world_name, guild_name, guild_level, guild_fame, guild_point, guild_master_name, guild_member_count, guild_member, guild_skill, guild_noblesse_skill, guild_mark, guild_mark_custom, } = obj;
-        this.date = new Date(date);
+        const { date, world_name, guild_name, guild_level, guild_fame, guild_point, guild_master_name, guild_member_count, guild_member, guild_skill, guild_noblesse_skill, } = obj;
+        this.date = date ? new Date(date) : null;
         this.worldName = world_name;
         this.guildName = guild_name;
         this.guildLevel = guild_level;
@@ -3019,8 +3139,6 @@ class GuildBasicDto {
         this.guildMember = guild_member;
         this.guildSkill = guild_skill.map((skill) => new GuildSkillDto(skill));
         this.guildNoblesseSkill = guild_noblesse_skill.map((skill) => new GuildSkillDto(skill));
-        this.guildMark = guild_mark;
-        this.guildMarkCustom = guild_mark_custom;
     }
 }
 
@@ -3494,7 +3612,7 @@ class StarforceHistoryDto {
         this.worldName = world_name;
         this.targetItem = target_item;
         this.dateCreate = new Date(date_create);
-        this.starforceEventList = starforce_event_list.map((event) => new StarforceEventDto(event));
+        this.starforceEventList = starforce_event_list?.map((event) => new StarforceEventDto(event)) ?? null;
     }
 }
 
@@ -3552,213 +3670,563 @@ class InspectionInfoDto {
 }
 
 /**
- * 업적 랭킹 정보
+ * 캐시샵 공지 상세
  */
-class AchievementRankingDto {
-    /**
-     * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
-     */
-    date;
+class CashshopNoticeDetailDto {
     /**
-     * 업적 랭킹 순위
+     * 공지 제목
      */
-    ranking;
+    title;
     /**
-     * 캐릭터 명
+     * 공지 링크
      */
-    characterName;
+    url;
     /**
-     * 월드 명
+     * 공지 본문
      */
-    worldName;
+    contents;
     /**
-     * 직업 명
+     * 공지 등록일
      */
-    className;
+    date;
     /**
-     * 전직 직업 명
+     * 판매 시작일
      */
-    subClassName;
+    dateSaleStart;
     /**
-     * 업적 등급
+     * 판매 종료일
      */
-    trophyGrade;
+    dateSaleEnd;
     /**
-     * 업적 점수
+     * 상시 판매 여부 (true - 상시)
      */
-    trophyScore;
+    ongoingFlag;
     constructor(obj) {
-        const { date, ranking, character_name, world_name, class_name, sub_class_name, trophy_grade, trophy_score, } = obj;
+        const { title, url, contents, date, date_sale_start, date_sale_end, ongoing_flag } = obj;
+        this.title = title;
+        this.url = url;
+        this.contents = contents;
         this.date = new Date(date);
-        this.ranking = ranking;
-        this.characterName = character_name;
-        this.worldName = world_name;
-        this.className = class_name;
-        this.subClassName = sub_class_name;
-        this.trophyGrade = trophy_grade;
-        this.trophyScore = trophy_score;
+        this.dateSaleStart = date_sale_start ? new Date(date_sale_start) : null;
+        this.dateSaleEnd = date_sale_end ? new Date(date_sale_end) : null;
+        this.ongoingFlag = ongoing_flag;
     }
-}
-
-/**
- * 업적 랭킹 응답 정보
- */
-class AchievementRankingResponseDto {
     /**
-     * 업적 랭킹 정보
+     * 상시 판매 여부 (true - 상시)
      */
-    ranking;
-    constructor(obj) {
-        const { ranking } = obj;
-        this.ranking = ranking.map((rank) => new AchievementRankingDto(rank));
+    get isOnGoing() {
+        return this.ongoingFlag === 'true';
     }
 }
 
 /**
- * 무릉도장 랭킹 정보
+ * 캐시샵 공지
  */
-class DojangRankingDto {
-    /**
-     * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
-     */
-    date;
-    /**
-     * 무릉도장 랭킹 순위
-     */
-    ranking;
+class CashshopNoticeListItemDto {
     /**
-     * 캐릭터 명
+     * 공지 제목
      */
-    characterName;
+    title;
     /**
-     * 월드 명
+     * 공지 링크
      */
-    worldName;
+    url;
     /**
-     * 직업 명
+     * 공지 식별자
      */
-    className;
+    noticeId;
     /**
-     * 전직 직업 명
+     * 공지 등록일
      */
-    subClassName;
+    date;
     /**
-     * 캐릭터 레벨
+     * 판매 시작일
      */
-    characterLevel;
+    dateSaleStart;
     /**
-     * 무릉도장 구간
+     * 판매 종료일
      */
-    dojangFloor;
+    dateSaleEnd;
     /**
-     * 무릉도장 클리어 시간 기록 (초 단위)
+     * 상시 판매 여부 (true - 상시)
      */
-    dojangTimeRecord;
+    ongoingFlag;
     constructor(obj) {
-        const { date, ranking, character_name, world_name, class_name, sub_class_name, character_level, dojang_floor, dojang_time_record, } = obj;
+        const { title, url, notice_id, date, date_sale_start, date_sale_end, ongoing_flag } = obj;
+        this.title = title;
+        this.url = url;
+        this.noticeId = notice_id;
         this.date = new Date(date);
-        this.ranking = ranking;
-        this.characterName = character_name;
-        this.worldName = world_name;
-        this.className = class_name;
-        this.subClassName = sub_class_name;
-        this.characterLevel = character_level;
-        this.dojangFloor = dojang_floor;
-        this.dojangTimeRecord = dojang_time_record;
+        this.dateSaleStart = date_sale_start ? new Date(date_sale_start) : null;
+        this.dateSaleEnd = date_sale_end ? new Date(date_sale_end) : null;
+        this.ongoingFlag = ongoing_flag;
+    }
+    /**
+     * 상시 판매 여부 (true - 상시)
+     */
+    get isOnGoing() {
+        return this.ongoingFlag === 'true';
     }
 }
 
 /**
- * 무릉도장 랭킹 응답 정보
+ * 캐시샵 공지 목록
  */
-class DojangRankingResponseDto {
+class CashshopNoticeListDto {
     /**
-     * 길드 랭킹 정보
+     * 공지 목록
      */
-    ranking;
+    cashshopNotice;
     constructor(obj) {
-        const { ranking } = obj;
-        this.ranking = ranking.map((rank) => new DojangRankingDto(rank));
+        const { cashshop_notice } = obj;
+        this.cashshopNotice = cashshop_notice.map(notice => new CashshopNoticeListItemDto(notice));
     }
 }
 
 /**
- * 길드 랭킹 정보
+ * 진행 중 이벤트 상세
  */
-class GuildRankingDto {
+class EventNoticeDetailDto {
     /**
-     * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     * 공지 제목
+     */
+    title;
+    /**
+     * 공지 링크
+     */
+    url;
+    /**
+     * 공지 본문
+     */
+    contents;
+    /**
+     * 공지 등록일
      */
     date;
     /**
-     * 길드 랭킹 순위
+     * 이벤트 시작일
      */
-    ranking;
+    dateEventStart;
     /**
-     * 길드 명
+     * 이벤트 종료일
      */
-    guildName;
+    dateEventEnd;
+    constructor(obj) {
+        const { title, url, contents, date, date_event_start, date_event_end } = obj;
+        this.title = title;
+        this.url = url;
+        this.contents = contents;
+        this.date = new Date(date);
+        this.dateEventStart = new Date(date_event_start);
+        this.dateEventEnd = new Date(date_event_end);
+    }
+}
+
+/**
+ * 진행 중 이벤트 공지
+ */
+class EventNoticeListItemDto {
     /**
-     * 월드 명
+     * 공지 제목
      */
-    worldName;
+    title;
     /**
-     * 길드 레벨
+     * 공지 링크
      */
-    guildLevel;
+    url;
     /**
-     * 길드 마스터 캐릭터 명
+     * 공지 식별자
      */
-    guildMasterName;
+    noticeId;
     /**
-     * 길드 마크
+     * 공지 등록일
      */
-    guildMark;
+    date;
     /**
-     * 길드 포인트
+     * 이벤트 시작일
      */
-    guildPoint;
+    dateEventStart;
+    /**
+     * 이벤트 종료일
+     */
+    dateEventEnd;
     constructor(obj) {
-        const { date, ranking, guild_name, world_name, guild_level, guild_master_name, guild_mark, guild_point, } = obj;
+        const { title, url, notice_id, date, date_event_start, date_event_end } = obj;
+        this.title = title;
+        this.url = url;
+        this.noticeId = notice_id;
         this.date = new Date(date);
-        this.ranking = ranking;
-        this.guildName = guild_name;
-        this.worldName = world_name;
-        this.guildLevel = guild_level;
-        this.guildMasterName = guild_master_name;
-        this.guildMark = guild_mark;
-        this.guildPoint = guild_point;
+        this.dateEventStart = new Date(date_event_start);
+        this.dateEventEnd = new Date(date_event_end);
     }
 }
 
 /**
- * 길드 랭킹 응답 정보
+ * 진행 중 이벤트 공지 목록
  */
-class GuildRankingResponseDto {
+class EventNoticeListDto {
     /**
-     * 길드 랭킹 정보
+     * 공지 목록
      */
-    ranking;
+    eventNotice;
     constructor(obj) {
-        const { ranking } = obj;
-        this.ranking = ranking.map((rank) => new GuildRankingDto(rank));
+        const { event_notice } = obj;
+        this.eventNotice = event_notice.map(notice => new EventNoticeListItemDto(notice));
     }
 }
 
 /**
- * 종합 랭킹 정보
+ * 공지사항 상세
  */
-class OverallRankingDto {
+class NoticeDetailDto {
     /**
-     * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     * 공지 제목
      */
-    date;
+    title;
     /**
-     * 종합 랭킹 순위
+     * 공지 링크
      */
-    ranking;
+    url;
     /**
-     * 캐릭터 명
+     * 공지 본문
+     */
+    contents;
+    /**
+     * 공지 등록일
+     */
+    date;
+    constructor(obj) {
+        const { title, url, contents, date } = obj;
+        this.title = title;
+        this.url = url;
+        this.contents = contents;
+        this.date = new Date(date);
+    }
+}
+
+/**
+ * 공지사항
+ */
+class NoticeListItemDto {
+    /**
+     * 공지 제목
+     */
+    title;
+    /**
+     * 공지 링크
+     */
+    url;
+    /**
+     * 공지 식별자
+     */
+    noticeId;
+    /**
+     * 공지 등록일
+     */
+    date;
+    constructor(obj) {
+        const { title, url, notice_id, date } = obj;
+        this.title = title;
+        this.url = url;
+        this.noticeId = notice_id;
+        this.date = new Date(date);
+    }
+}
+
+/**
+ * 공지사항 목록
+ */
+class NoticeListDto {
+    /**
+     * 공지 목록
+     */
+    notice;
+    constructor(obj) {
+        const { notice } = obj;
+        this.notice = notice.map(notice => new NoticeListItemDto(notice));
+    }
+}
+
+/**
+ * 업데이트 상세
+ */
+class UpdateNoticeDetailDto {
+    /**
+     * 공지 제목
+     */
+    title;
+    /**
+     * 공지 링크
+     */
+    url;
+    /**
+     * 공지 본문
+     */
+    contents;
+    /**
+     * 공지 등록일
+     */
+    date;
+    constructor(obj) {
+        const { title, url, contents, date } = obj;
+        this.title = title;
+        this.url = url;
+        this.contents = contents;
+        this.date = new Date(date);
+    }
+}
+
+/**
+ * 업데이트 공지
+ */
+class UpdateNoticeListItemDto {
+    /**
+     * 공지 제목
+     */
+    title;
+    /**
+     * 공지 링크
+     */
+    url;
+    /**
+     * 공지 식별자
+     */
+    noticeId;
+    /**
+     * 공지 등록일
+     */
+    date;
+    constructor(obj) {
+        const { title, url, notice_id, date } = obj;
+        this.title = title;
+        this.url = url;
+        this.noticeId = notice_id;
+        this.date = new Date(date);
+    }
+}
+
+/**
+ * 업데이트 목록
+ */
+class UpdateNoticeListDto {
+    /**
+     * 공지 목록
+     */
+    updateNotice;
+    constructor(obj) {
+        const { update_notice } = obj;
+        this.updateNotice = update_notice.map(notice => new UpdateNoticeListItemDto(notice));
+    }
+}
+
+/**
+ * 업적 랭킹 정보
+ */
+class AchievementRankingDto {
+    /**
+     * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date;
+    /**
+     * 업적 랭킹 순위
+     */
+    ranking;
+    /**
+     * 캐릭터 명
+     */
+    characterName;
+    /**
+     * 월드 명
+     */
+    worldName;
+    /**
+     * 직업 명
+     */
+    className;
+    /**
+     * 전직 직업 명
+     */
+    subClassName;
+    /**
+     * 업적 등급
+     */
+    trophyGrade;
+    /**
+     * 업적 점수
+     */
+    trophyScore;
+    constructor(obj) {
+        const { date, ranking, character_name, world_name, class_name, sub_class_name, trophy_grade, trophy_score, } = obj;
+        this.date = new Date(date);
+        this.ranking = ranking;
+        this.characterName = character_name;
+        this.worldName = world_name;
+        this.className = class_name;
+        this.subClassName = sub_class_name;
+        this.trophyGrade = trophy_grade;
+        this.trophyScore = trophy_score;
+    }
+}
+
+/**
+ * 업적 랭킹 응답 정보
+ */
+class AchievementRankingResponseDto {
+    /**
+     * 업적 랭킹 정보
+     */
+    ranking;
+    constructor(obj) {
+        const { ranking } = obj;
+        this.ranking = ranking.map((rank) => new AchievementRankingDto(rank));
+    }
+}
+
+/**
+ * 무릉도장 랭킹 정보
+ */
+class DojangRankingDto {
+    /**
+     * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date;
+    /**
+     * 무릉도장 랭킹 순위
+     */
+    ranking;
+    /**
+     * 캐릭터 명
+     */
+    characterName;
+    /**
+     * 월드 명
+     */
+    worldName;
+    /**
+     * 직업 명
+     */
+    className;
+    /**
+     * 전직 직업 명
+     */
+    subClassName;
+    /**
+     * 캐릭터 레벨
+     */
+    characterLevel;
+    /**
+     * 무릉도장 구간
+     */
+    dojangFloor;
+    /**
+     * 무릉도장 클리어 시간 기록 (초 단위)
+     */
+    dojangTimeRecord;
+    constructor(obj) {
+        const { date, ranking, character_name, world_name, class_name, sub_class_name, character_level, dojang_floor, dojang_time_record, } = obj;
+        this.date = new Date(date);
+        this.ranking = ranking;
+        this.characterName = character_name;
+        this.worldName = world_name;
+        this.className = class_name;
+        this.subClassName = sub_class_name;
+        this.characterLevel = character_level;
+        this.dojangFloor = dojang_floor;
+        this.dojangTimeRecord = dojang_time_record;
+    }
+}
+
+/**
+ * 무릉도장 랭킹 응답 정보
+ */
+class DojangRankingResponseDto {
+    /**
+     * 길드 랭킹 정보
+     */
+    ranking;
+    constructor(obj) {
+        const { ranking } = obj;
+        this.ranking = ranking.map((rank) => new DojangRankingDto(rank));
+    }
+}
+
+/**
+ * 길드 랭킹 정보
+ */
+class GuildRankingDto {
+    /**
+     * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date;
+    /**
+     * 길드 랭킹 순위
+     */
+    ranking;
+    /**
+     * 길드 명
+     */
+    guildName;
+    /**
+     * 월드 명
+     */
+    worldName;
+    /**
+     * 길드 레벨
+     */
+    guildLevel;
+    /**
+     * 길드 마스터 캐릭터 명
+     */
+    guildMasterName;
+    /**
+     * 길드 마크
+     */
+    guildMark;
+    /**
+     * 길드 포인트
+     */
+    guildPoint;
+    constructor(obj) {
+        const { date, ranking, guild_name, world_name, guild_level, guild_master_name, guild_mark, guild_point, } = obj;
+        this.date = new Date(date);
+        this.ranking = ranking;
+        this.guildName = guild_name;
+        this.worldName = world_name;
+        this.guildLevel = guild_level;
+        this.guildMasterName = guild_master_name;
+        this.guildMark = guild_mark;
+        this.guildPoint = guild_point;
+    }
+}
+
+/**
+ * 길드 랭킹 응답 정보
+ */
+class GuildRankingResponseDto {
+    /**
+     * 길드 랭킹 정보
+     */
+    ranking;
+    constructor(obj) {
+        const { ranking } = obj;
+        this.ranking = ranking.map((rank) => new GuildRankingDto(rank));
+    }
+}
+
+/**
+ * 종합 랭킹 정보
+ */
+class OverallRankingDto {
+    /**
+     * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date;
+    /**
+     * 종합 랭킹 순위
+     */
+    ranking;
+    /**
+     * 캐릭터 명
      */
     characterName;
     /**
@@ -4034,7 +4502,7 @@ class UnionArtifactDto {
     unionArtifactRemainAp;
     constructor(obj) {
         const { date, union_artifact_effect, union_artifact_crystal, union_artifact_remain_ap, } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.unionArtifactEffect = union_artifact_effect.map((effect) => new UnionArtifactEffectDto(effect));
         this.unionArtifactCrystal = union_artifact_crystal.map((crystal) => new UnionArtifactCrystalDto(crystal));
         this.unionArtifactRemainAp = union_artifact_remain_ap;
@@ -4071,7 +4539,7 @@ class UnionDto {
     unionArtifactPoint;
     constructor(obj) {
         const { date, union_level, union_grade, union_artifact_level, union_artifact_exp, union_artifact_point } = obj;
-        this.date = new Date(date);
+        this.date = date ? new Date(date) : null;
         this.unionLevel = union_level;
         this.unionGrade = union_grade;
         this.unionArtifactLevel = union_artifact_level;
@@ -4159,17 +4627,46 @@ class UnionRaiderBlockDto {
  */
 class UnionRaiderInnerStatDto {
     /**
-     * 공격대 배치 위치 (11시 방향부터 시계 방향 순서대로 0~7)
+     * 공격대 배치 위치 (11시 방향부터 시계 방향 순서대로 0~7)
+     */
+    statFieldId;
+    /**
+     * 해당 지역 점령 효과
+     */
+    statFieldEffect;
+    constructor(obj) {
+        const { stat_field_id, stat_field_effect } = obj;
+        this.statFieldId = stat_field_id;
+        this.statFieldEffect = stat_field_effect;
+    }
+}
+
+/**
+ * 유니온 프리셋 정보
+ */
+class UnionRaiderPresetDto {
+    /**
+     * 유니온 공격대원 효과
+     */
+    unionRaiderStat;
+    /**
+     * 유니온 공격대 점령 효과
+     */
+    unionOccupiedStat;
+    /**
+     * 유니온 공격대 배치
      */
-    statFieldId;
+    unionInnerStat;
     /**
-     * 해당 지역 점령 효과
+     * 유니온 블록 정보
      */
-    statFieldEffect;
+    unionBlock;
     constructor(obj) {
-        const { stat_field_id, stat_field_effect } = obj;
-        this.statFieldId = stat_field_id;
-        this.statFieldEffect = stat_field_effect;
+        const { union_raider_stat, union_occupied_stat, union_inner_stat, union_block, } = obj;
+        this.unionRaiderStat = union_raider_stat;
+        this.unionOccupiedStat = union_occupied_stat;
+        this.unionInnerStat = union_inner_stat.map((stat) => new UnionRaiderInnerStatDto(stat));
+        this.unionBlock = union_block.map((block) => new UnionRaiderBlockDto(block));
     }
 }
 
@@ -4194,13 +4691,53 @@ class UnionRaiderDto {
      * 유니온 블록 정보
      */
     unionBlock;
+    /**
+     * 적용 중인 프리셋 번호
+     */
+    usePresetNo;
+    /**
+     * 유니온 프리셋 1번 정보
+     */
+    unionRaiderPreset1;
+    /**
+     * 유니온 프리셋 2번 정보
+     */
+    unionRaiderPreset2;
+    /**
+     * 유니온 프리셋 3번 정보
+     */
+    unionRaiderPreset3;
+    /**
+     * 유니온 프리셋 4번 정보
+     */
+    unionRaiderPreset4;
+    /**
+     * 유니온 프리셋 5번 정보
+     */
+    unionRaiderPreset5;
     constructor(obj) {
-        const { date, union_raider_stat, union_occupied_stat, union_inner_stat, union_block, } = obj;
-        this.date = new Date(date);
+        const { date, union_raider_stat, union_occupied_stat, union_inner_stat, union_block, use_preset_no, union_raider_preset_1, union_raider_preset_2, union_raider_preset_3, union_raider_preset_4, union_raider_preset_5, } = obj;
+        this.date = date ? new Date(date) : null;
         this.unionRaiderStat = union_raider_stat;
         this.unionOccupiedStat = union_occupied_stat;
         this.unionInnerStat = union_inner_stat.map((stat) => new UnionRaiderInnerStatDto(stat));
         this.unionBlock = union_block.map((block) => new UnionRaiderBlockDto(block));
+        this.usePresetNo = use_preset_no;
+        this.unionRaiderPreset1 = union_raider_preset_1
+            ? new UnionRaiderPresetDto(union_raider_preset_1)
+            : null;
+        this.unionRaiderPreset2 = union_raider_preset_2
+            ? new UnionRaiderPresetDto(union_raider_preset_2)
+            : null;
+        this.unionRaiderPreset3 = union_raider_preset_3
+            ? new UnionRaiderPresetDto(union_raider_preset_3)
+            : null;
+        this.unionRaiderPreset4 = union_raider_preset_4
+            ? new UnionRaiderPresetDto(union_raider_preset_4)
+            : null;
+        this.unionRaiderPreset5 = union_raider_preset_5
+            ? new UnionRaiderPresetDto(union_raider_preset_5)
+            : null;
     }
 }
 
@@ -4234,6 +4771,7 @@ var MapleStoryApiErrorCode;
     MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00007"] = 6] = "OPENAPI00007";
     MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00009"] = 7] = "OPENAPI00009";
     MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00010"] = 8] = "OPENAPI00010";
+    MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00011"] = 9] = "OPENAPI00011";
 })(MapleStoryApiErrorCode || (MapleStoryApiErrorCode = {}));
 const errorMap = {
     ['OPENAPI00001']: MapleStoryApiErrorCode.OPENAPI00001,
@@ -4245,6 +4783,7 @@ const errorMap = {
     ['OPENAPI00007']: MapleStoryApiErrorCode.OPENAPI00007,
     ['OPENAPI00009']: MapleStoryApiErrorCode.OPENAPI00009,
     ['OPENAPI00010']: MapleStoryApiErrorCode.OPENAPI00010,
+    ['OPENAPI00011']: MapleStoryApiErrorCode.OPENAPI00011,
 };
 
 dayjs.extend(timezone);
@@ -4285,8 +4824,9 @@ class MapleStoryApi {
     //#region 캐릭터 정보 조회
     /**
      * 캐릭터 식별자(ocid)를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param characterName    캐릭터 명
@@ -4300,28 +4840,39 @@ class MapleStoryApi {
         });
         return new CharacterDto(data);
     }
+    /**
+     * 계정의 보유 캐릭터 목록을 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     */
+    async getCharacterList() {
+        const path = 'maplestory/v1/character/list';
+        const { data } = await this.client.get(path);
+        return new CharacterListDto(data);
+    }
     /**
      * 기본 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterBasic(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterBasic(ocid, dateOptions) {
         const path = 'maplestory/v1/character/basic';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4330,26 +4881,26 @@ class MapleStoryApi {
     }
     /**
      * 인기도 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterPopularity(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterPopularity(ocid, dateOptions) {
         const path = 'maplestory/v1/character/popularity';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4358,26 +4909,26 @@ class MapleStoryApi {
     }
     /**
      * 종합 능력치 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterStat(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterStat(ocid, dateOptions) {
         const path = 'maplestory/v1/character/stat';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4386,26 +4937,26 @@ class MapleStoryApi {
     }
     /**
      * 하이퍼스탯 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterHyperStat(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterHyperStat(ocid, dateOptions) {
         const path = 'maplestory/v1/character/hyper-stat';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4414,26 +4965,26 @@ class MapleStoryApi {
     }
     /**
      * 성향 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterPropensity(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterPropensity(ocid, dateOptions) {
         const path = 'maplestory/v1/character/propensity';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4442,26 +4993,26 @@ class MapleStoryApi {
     }
     /**
      * 어빌리티 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterAbility(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterAbility(ocid, dateOptions) {
         const path = 'maplestory/v1/character/ability';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4470,26 +5021,26 @@ class MapleStoryApi {
     }
     /**
      * 장착한 장비 중 캐시 장비를 제외한 나머지 장비 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterItemEquipment(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterItemEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/item-equipment';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4498,26 +5049,26 @@ class MapleStoryApi {
     }
     /**
      * 장착한 캐시 장비 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterCashItemEquipment(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterCashItemEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/cashitem-equipment';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4526,26 +5077,26 @@ class MapleStoryApi {
     }
     /**
      * 장착한 심볼 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterSymbolEquipment(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterSymbolEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/symbol-equipment';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4554,26 +5105,26 @@ class MapleStoryApi {
     }
     /**
      * 적용받고 있는 세트 효과 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterSetEffect(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterSetEffect(ocid, dateOptions) {
         const path = 'maplestory/v1/character/set-effect';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4582,26 +5133,23 @@ class MapleStoryApi {
     }
     /**
      * 장착 중인 헤어, 성형, 피부 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterBeautyEquipment(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterBeautyEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/beauty-equipment';
         const query = {
             ocid: ocid,
-            date: MapleStoryApi.toDateString({
+            date: dateOptions ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions) : undefined,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4610,26 +5158,26 @@ class MapleStoryApi {
     }
     /**
      * 장착한 안드로이드 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterAndroidEquipment(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterAndroidEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/android-equipment';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4638,26 +5186,26 @@ class MapleStoryApi {
     }
     /**
      * 장착한 펫 및 펫 스킬, 장비 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterPetEquipment(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterPetEquipment(ocid, dateOptions) {
         const path = 'maplestory/v1/character/pet-equipment';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4666,8 +5214,9 @@ class MapleStoryApi {
     }
     /**
      * 캐릭터 스킬과 하이퍼 스킬 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
@@ -4685,20 +5234,19 @@ class MapleStoryApi {
      *  - 6: 6차 스킬
      *  @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterSkill(ocid, characterSkillGrade, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterSkill(ocid, characterSkillGrade, dateOptions) {
         const path = 'maplestory/v1/character/skill';
-        const query = {
-            ocid: ocid,
-            character_skill_grade: characterSkillGrade,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            character_skill_grade: characterSkillGrade,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4707,26 +5255,26 @@ class MapleStoryApi {
     }
     /**
      * 장착 링크 스킬 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterLinkSkill(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterLinkSkill(ocid, dateOptions) {
         const path = 'maplestory/v1/character/link-skill';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4735,26 +5283,26 @@ class MapleStoryApi {
     }
     /**
      * V매트릭스 슬롯 정보와 장착한 V코어 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterVMatrix(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterVMatrix(ocid, dateOptions) {
         const path = 'maplestory/v1/character/vmatrix';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4763,26 +5311,26 @@ class MapleStoryApi {
     }
     /**
      * HEXA 매트릭스에 장착한 HEXA 코어 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterHexaMatrix(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterHexaMatrix(ocid, dateOptions) {
         const path = 'maplestory/v1/character/hexamatrix';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4791,26 +5339,26 @@ class MapleStoryApi {
     }
     /**
      * HEXA 매트릭스에 설정한 HEXA 스탯 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterHexaMatrixStat(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterHexaMatrixStat(ocid, dateOptions) {
         const path = 'maplestory/v1/character/hexamatrix-stat';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4819,26 +5367,26 @@ class MapleStoryApi {
     }
     /**
      * 캐릭터 무릉도장 최고 기록 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 캐릭터 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getCharacterDojang(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getCharacterDojang(ocid, dateOptions) {
         const path = 'maplestory/v1/character/dojang';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4849,26 +5397,26 @@ class MapleStoryApi {
     //#region 유니온 정보 조회
     /**
      * 유니온 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 유니온 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getUnion(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getUnion(ocid, dateOptions) {
         const path = 'maplestory/v1/user/union';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4877,26 +5425,26 @@ class MapleStoryApi {
     }
     /**
      * 유니온 공격대 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 유니온 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getUnionRaider(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getUnionRaider(ocid, dateOptions) {
         const path = 'maplestory/v1/user/union-raider';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4905,26 +5453,26 @@ class MapleStoryApi {
     }
     /**
      * 유니온 아티팩트 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 유니온 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.)
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getUnionArtifact(ocid, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getUnionArtifact(ocid, dateOptions) {
         const path = 'maplestory/v1/user/union-artifact';
-        const query = {
-            ocid: ocid,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4935,8 +5483,9 @@ class MapleStoryApi {
     //#region 길드 정보 조회
     /**
      * 길드 식별자(oguild_id) 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 길드 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.).
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param guildName 길드 명
@@ -4954,26 +5503,26 @@ class MapleStoryApi {
     }
     /**
      * 길드 기본 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 길드 정보 조회 API는 일자별 데이터로 매일 오전 1시부터 전일 데이터 조회가 가능합니다. (예를 들어, 12월 22일 데이터를 조회하면 22일 00시부터 23일의 00시 사이의 데이터가 조회됩니다.).
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      *
      * @param guildId 길드 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    async getGuildBasic(guildId, dateOptions = MapleStoryApi.getProperDefaultDateOptions({
-        hour: 1,
-        minute: 0,
-        dateOffset: 1,
-    })) {
+    async getGuildBasic(guildId, dateOptions) {
         const path = 'maplestory/v1/guild/basic';
-        const query = {
-            oguild_id: guildId,
-            date: MapleStoryApi.toDateString({
+        const date = dateOptions
+            ? MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
                 day: 21,
-            }, dateOptions),
+            }, dateOptions)
+            : undefined;
+        const query = {
+            oguild_id: guildId,
+            date: date,
         };
         const { data } = await this.client.get(path, {
             params: query,
@@ -4988,7 +5537,7 @@ class MapleStoryApi {
         if (typeof parameter === 'string') {
             query.cursor = parameter;
         }
-        else if (typeof parameter === 'object') {
+        else if (typeof parameter === 'object' || parameter === undefined) {
             query.date = MapleStoryApi.toDateString({
                 year: 2023,
                 month: 12,
@@ -5263,6 +5812,120 @@ class MapleStoryApi {
         return new AchievementRankingResponseDto(data);
     }
     //#endregion
+    //#region 공지 정보 조회
+    /**
+     * 메이플스토리 공지사항에 최근 등록된 게시글 20개를 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     */
+    async getNoticeList() {
+        const path = 'maplestory/v1/notice';
+        const { data } = await this.client.get(path);
+        return new NoticeListDto(data);
+    }
+    /**
+     * 메이플스토리 공지사항 게시글 세부 사항을 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     * @param noticeId 공지 식별자
+     */
+    async getNoticeDetail(noticeId) {
+        const path = 'maplestory/v1/notice/detail';
+        const query = {
+            notice_id: noticeId,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new NoticeDetailDto(data);
+    }
+    /**
+     * 메이플스토리 업데이트에 최근 등록된 게시글 20개를 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     */
+    async getUpdateNoticeList() {
+        const path = 'maplestory/v1/notice-update';
+        const { data } = await this.client.get(path);
+        return new UpdateNoticeListDto(data);
+    }
+    /**
+     * 메이플스토리 업데이트 게시글 세부 사항을 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     * @param noticeId 공지 식별자
+     */
+    async getUpdateNoticeDetail(noticeId) {
+        const path = 'maplestory/v1/notice-update/detail';
+        const query = {
+            notice_id: noticeId,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new UpdateNoticeDetailDto(data);
+    }
+    /**
+     * 메이플스토리 진행 중 이벤트에 최근 등록된 공지사항 20개를 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     */
+    async getEventNoticeList() {
+        const path = 'maplestory/v1/notice-event';
+        const { data } = await this.client.get(path);
+        return new EventNoticeListDto(data);
+    }
+    /**
+     * 메이플스토리 진행 중 이벤트 게시글 세부 사항을 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     * @param noticeId 공지 식별자
+     */
+    async getEventNoticeDetail(noticeId) {
+        const path = 'maplestory/v1/notice-event/detail';
+        const query = {
+            notice_id: noticeId,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new EventNoticeDetailDto(data);
+    }
+    /**
+     * 메이플스토리 캐시샵 공지에 최근 등록된 공지사항 20개를 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     */
+    async getCashshopNoticeList() {
+        const path = 'maplestory/v1/notice-cashshop';
+        const { data } = await this.client.get(path);
+        return new CashshopNoticeListDto(data);
+    }
+    /**
+     * 메이플스토리 캐시샵 공지 게시글 세부 사항을 조회합니다.
+     *
+     * - 공지 정보 API는 데이터 최신화(공지 내용 수정/ 업데이트 고려)를 위해 실시간 조회 또는 최소 일배치 작업을 권장합니다.
+     * - 실시간으로 정보를 제공하지 않는 경우, 신규/수정 공지 내용이 반영되지 않을 수 있으니 서비스 이용 유저에게 홈페이지 공지 사항을 확인하라는 가이드를 제공해주세요.
+     * @param noticeId 공지 식별자
+     */
+    async getCashshopNoticeDetail(noticeId) {
+        const path = 'maplestory/v1/notice-cashshop/detail';
+        const query = {
+            notice_id: noticeId,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new CashshopNoticeDetailDto(data);
+    }
+    //#endregion
     /**
      * 서버 점검 정보를 조회합니다.
      */
@@ -5347,4 +6010,4 @@ class MapleStoryApi {
     }
 }
 
-export { AchievementRankingDto, AchievementRankingResponseDto, CharacterAbilityDto, CharacterAbilityInfoDto, CharacterAbilityPresetDto, CharacterAndroidCashItemEquipmentColoringPrismDto, CharacterAndroidCashItemEquipmentDto, CharacterAndroidCashItemEquipmentOptionDto, CharacterAndroidEquipmentDto, CharacterAndroidEquipmentFaceDto, CharacterAndroidEquipmentHairDto, CharacterAndroidEquipmentPresetDto, CharacterBasicDto, CharacterBeautyEquipmentDto, CharacterBeautyEquipmentFaceDto, CharacterBeautyEquipmentHairDto, CharacterCashItemEquipmentColoringPrismDto, CharacterCashItemEquipmentDto, CharacterCashItemEquipmentOptionDto, CharacterCashItemEquipmentPresetDto, CharacterDojangDto, CharacterDto, CharacterHexaMatrixDto, CharacterHexaMatrixEquipmentDto, CharacterHexaMatrixEquipmentLinkedSkillDto, CharacterHexaMatrixStatCoreDto, CharacterHexaMatrixStatDto, CharacterHyperStatDto, CharacterHyperStatPresetDto, CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto, CharacterLinkSkillDto, CharacterLinkSkillInfoDto, CharacterPetEquipmentAutoSkillDto, CharacterPetEquipmentDto, CharacterPetEquipmentItemDto, CharacterPetEquipmentItemOptionDto, CharacterPopularityDto, CharacterPropensityDto, CharacterSetEffectDto, CharacterSetEffectInfoDto, CharacterSetEffectOptionInfoDto, CharacterSkillDto, CharacterSkillInfoDto, CharacterStatDto, CharacterSymbolEquipmentDto, CharacterSymbolEquipmentInfoDto, CharacterVMatrixCodeEquipmentDto, CharacterVMatrixDto, CubeHistoryDto, CubeHistoryResponseDto, CubeResultOptionDto, DojangRankingDto, DojangRankingResponseDto, GuildBasicDto, GuildDto, GuildRankingDto, GuildRankingResponseDto, GuildSkillDto, InspectionInfoDto, MapleStoryApi, MapleStoryApiError, MapleStoryApiErrorCode, OverallRankingDto, OverallRankingResponseDto, PotentialHistoryDto, PotentialHistoryResponseDto, PotentialOptionGrade, PotentialResultOptionDto, StarforceEventDto, StarforceHistoryDto, StarforceHistoryResponseDto, TheSeedRankingDto, TheSeedRankingResponseDto, UnionArtifactCrystalDto, UnionArtifactDto, UnionArtifactEffectDto, UnionDto, UnionRaiderBlockControlPointDto, UnionRaiderBlockDto, UnionRaiderBlockPositionDto, UnionRaiderDto, UnionRaiderInnerStatDto, UnionRankingDto, UnionRankingResponseDto, potentialOptionGradeFromString };
+export { AchievementRankingDto, AchievementRankingResponseDto, CashshopNoticeDetailDto, CashshopNoticeListDto, CashshopNoticeListItemDto, CharacterAbilityDto, CharacterAbilityInfoDto, CharacterAbilityPresetDto, CharacterAndroidCashItemEquipmentColoringPrismDto, CharacterAndroidCashItemEquipmentDto, CharacterAndroidCashItemEquipmentOptionDto, CharacterAndroidEquipmentDto, CharacterAndroidEquipmentFaceDto, CharacterAndroidEquipmentHairDto, CharacterAndroidEquipmentPresetDto, CharacterBasicDto, CharacterBeautyEquipmentDto, CharacterBeautyEquipmentFaceDto, CharacterBeautyEquipmentHairDto, CharacterCashItemEquipmentColoringPrismDto, CharacterCashItemEquipmentDto, CharacterCashItemEquipmentOptionDto, CharacterCashItemEquipmentPresetDto, CharacterDojangDto, CharacterDto, CharacterHexaMatrixDto, CharacterHexaMatrixEquipmentDto, CharacterHexaMatrixEquipmentLinkedSkillDto, CharacterHexaMatrixStatCoreDto, CharacterHexaMatrixStatDto, CharacterHyperStatDto, CharacterHyperStatPresetDto, CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto, CharacterLinkSkillDto, CharacterLinkSkillInfoDto, CharacterListAccountCharacterDto, CharacterListAccountDto, CharacterListDto, CharacterPetEquipmentAutoSkillDto, CharacterPetEquipmentDto, CharacterPetEquipmentItemDto, CharacterPetEquipmentItemOptionDto, CharacterPopularityDto, CharacterPropensityDto, CharacterSetEffectDto, CharacterSetEffectInfoDto, CharacterSetEffectOptionFullDto, CharacterSetEffectSetDto, CharacterSkillDto, CharacterSkillInfoDto, CharacterStatDto, CharacterSymbolEquipmentDto, CharacterSymbolEquipmentInfoDto, CharacterVMatrixCodeEquipmentDto, CharacterVMatrixDto, CubeHistoryDto, CubeHistoryResponseDto, CubeResultOptionDto, DojangRankingDto, DojangRankingResponseDto, EventNoticeDetailDto, EventNoticeListDto, EventNoticeListItemDto, GuildBasicDto, GuildDto, GuildRankingDto, GuildRankingResponseDto, GuildSkillDto, InspectionInfoDto, MapleStoryApi, MapleStoryApiError, MapleStoryApiErrorCode, NoticeDetailDto, NoticeListDto, NoticeListItemDto, OverallRankingDto, OverallRankingResponseDto, PotentialHistoryDto, PotentialHistoryResponseDto, PotentialOptionGrade, PotentialResultOptionDto, StarforceEventDto, StarforceHistoryDto, StarforceHistoryResponseDto, TheSeedRankingDto, TheSeedRankingResponseDto, UnionArtifactCrystalDto, UnionArtifactDto, UnionArtifactEffectDto, UnionDto, UnionRaiderBlockControlPointDto, UnionRaiderBlockDto, UnionRaiderBlockPositionDto, UnionRaiderDto, UnionRaiderInnerStatDto, UnionRaiderPresetDto, UnionRankingDto, UnionRankingResponseDto, UpdateNoticeDetailDto, UpdateNoticeListDto, UpdateNoticeListItemDto, potentialOptionGradeFromString };