maplestory-openapi 3.9.0 → 3.11.0

package/dist/esm/maplestory/api/kms/dto/scheduler/schedulerCharacterState.js

@@ -0,0 +1,170 @@
+/**
+ * 캐릭터 스케줄러 정보
+ */
+class SchedulerCharacterStateDto {
+    /**
+     * 조회 기준일 (YYYY-MM-DD)
+     */
+    date;
+    /**
+     * 캐릭터 명
+     */
+    characterName;
+    /**
+     * 월드 명
+     */
+    worldName;
+    /**
+     * 캐릭터 레벨
+     */
+    characterLevel;
+    /**
+     * 캐릭터 직업
+     */
+    characterClass;
+    /**
+     * 일일 콘텐츠 정보
+     */
+    dailyContents;
+    /**
+     * 주간 콘텐츠 정보
+     */
+    weeklyContents;
+    /**
+     * 보스 콘텐츠 정보
+     */
+    bossContents;
+    /**
+     * 주간 보스 처치 완료 횟수
+     */
+    weeklyBossClearCount;
+    /**
+     * 주간 보스 처치 제한 횟수
+     */
+    weeklyBossClearLimitCount;
+    constructor(obj) {
+        this.date = obj.date ? new Date(obj.date) : null;
+        this.characterName = obj.character_name;
+        this.worldName = obj.world_name;
+        this.characterLevel = obj.character_level;
+        this.characterClass = obj.character_class;
+        this.dailyContents = (obj.daily_contents ?? []).map((item) => new SchedulerDailyContentDto(item));
+        this.weeklyContents = (obj.weekly_contents ?? []).map((item) => new SchedulerWeeklyContentDto(item));
+        this.bossContents = (obj.boss_contents ?? []).map((item) => new SchedulerBossContentDto(item));
+        this.weeklyBossClearCount = obj.weekly_boss_clear_count;
+        this.weeklyBossClearLimitCount = obj.weekly_boss_clear_limit_count;
+    }
+}
+/**
+ * 스케줄러 일일 콘텐츠 정보
+ */
+class SchedulerDailyContentDto {
+    /**
+     * 콘텐츠/퀘스트 명
+     */
+    contentName;
+    /**
+     * 타입 ('contents', 'quest')
+     */
+    type;
+    /**
+     * 인게임 스케줄러 등록 여부 (true/false)
+     */
+    registrationFlag;
+    /**
+     * 현재 완료 횟수/점수
+     */
+    nowCount;
+    /**
+     * 최대 완료 가능 횟수/점수
+     */
+    maxCount;
+    /**
+     * 퀘스트인 경우 진행 상태 ("0":기타, "1":진행 중, "2":완료)
+     */
+    questState;
+    constructor(obj) {
+        this.contentName = obj.content_name;
+        this.type = obj.type;
+        this.registrationFlag = obj.registration_flag;
+        this.nowCount = obj.now_count;
+        this.maxCount = obj.max_count;
+        this.questState = obj.quest_state;
+    }
+}
+/**
+ * 스케줄러 주간 콘텐츠 정보
+ */
+class SchedulerWeeklyContentDto {
+    /**
+     * 콘텐츠 명
+     */
+    contentName;
+    /**
+     * 콘텐츠 종류 ('contents', 'quest')
+     */
+    type;
+    /**
+     * 인게임 스케줄러 등록 여부 (true/false)
+     */
+    registrationFlag;
+    /**
+     * 현재 완료 횟수/점수
+     */
+    nowCount;
+    /**
+     * 최대 완료 가능 횟수/점수
+     */
+    maxCount;
+    /**
+     * 퀘스트인 경우 진행 상태 ("0":기타, "1":진행 중, "2":완료)
+     */
+    questState;
+    constructor(obj) {
+        this.contentName = obj.content_name;
+        this.type = obj.type;
+        this.registrationFlag = obj.registration_flag;
+        this.nowCount = obj.now_count;
+        this.maxCount = obj.max_count;
+        this.questState = obj.quest_state;
+    }
+}
+/**
+ * 스케줄러 보스 콘텐츠 정보
+ */
+class SchedulerBossContentDto {
+    /**
+     * 보스 명
+     */
+    contentName;
+    /**
+     * 보스 난이도
+     */
+    difficulty;
+    /**
+     * 보스 초기화 주기
+     */
+    cycle;
+    /**
+     * 리스트 순서
+     */
+    listOrderNo;
+    /**
+     * 인게임 스케줄러 등록 여부 (true/false)
+     */
+    registrationFlag;
+    /**
+     * 완료 여부 (true/false)
+     */
+    completeFlag;
+    constructor(obj) {
+        this.contentName = obj.content_name;
+        this.difficulty = obj.difficulty;
+        this.cycle = obj.cycle;
+        this.listOrderNo = obj.list_order_no;
+        this.registrationFlag = obj.registration_flag;
+        this.completeFlag = obj.complete_flag;
+    }
+}
+
+export { SchedulerBossContentDto, SchedulerCharacterStateDto, SchedulerDailyContentDto, SchedulerWeeklyContentDto };

package/dist/esm/maplestory/api/kms/dto/union/unionRaider.js

@@ -12,6 +12,18 @@ class UnionRaiderDto extends UnionRaiderDto$1 {
      * 유니온 공격대원 효과
      */
     unionRaiderStat;
+    /**
+     * 적용 중인 유니온 스탯 효과
+     */
+    unionStateStat;
+    /**
+     * 프리셋 별 유니온 스탯 효과
+     */
+    unionStateStatPreset;
+    /**
+     * 총 유니온 포인트
+     */
+    unionMaxPoint;
     /**
      * 유니온 공격대 점령 효과
      */
@@ -50,9 +62,12 @@ class UnionRaiderDto extends UnionRaiderDto$1 {
     unionRaiderPreset5;
     constructor(obj) {
         super();
-        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;
+        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, union_state_stat, union_state_stat_preset, union_max_point, } = obj;
         this.date = date ? new Date(date) : null;
         this.unionRaiderStat = union_raider_stat;
+        this.unionStateStat = union_state_stat;
+        this.unionStateStatPreset = (union_state_stat_preset ?? []).map((preset) => new UnionRaiderStateStatPresetDto(preset));
+        this.unionMaxPoint = union_max_point;
         this.unionOccupiedStat = union_occupied_stat;
         this.unionInnerStat = union_inner_stat.map((stat) => new UnionRaiderInnerStatDto(stat));
         this.unionBlock = union_block.map((block) => new UnionRaiderBlockDto(block));
@@ -167,6 +182,24 @@ class UnionRaiderBlockDto extends UnionRaiderBlockDto$1 {
             : null;
     }
 }
+/**
+ * 유니온 스탯 프리셋 정보
+ */
+class UnionRaiderStateStatPresetDto {
+    /**
+     * 프리셋 번호
+     */
+    presetNo;
+    /**
+     * 유니온 스탯 효과
+     */
+    unionStateStat;
+    constructor(obj) {
+        const { preset_no, union_state_stat } = obj;
+        this.presetNo = preset_no;
+        this.unionStateStat = union_state_stat;
+    }
+}
 /**
  * 유니온 프리셋 정보
  */
@@ -197,4 +230,4 @@ class UnionRaiderPresetDto extends UnionRaiderPresetDto$1 {
     }
 }
 
-export { UnionRaiderBlockControlPointDto, UnionRaiderBlockDto, UnionRaiderBlockPositionDto, UnionRaiderDto, UnionRaiderInnerStatDto, UnionRaiderPresetDto };
+export { UnionRaiderBlockControlPointDto, UnionRaiderBlockDto, UnionRaiderBlockPositionDto, UnionRaiderDto, UnionRaiderInnerStatDto, UnionRaiderPresetDto, UnionRaiderStateStatPresetDto };

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

@@ -1,5 +1,9 @@
 export { MapleStoryApi } from './mapleStoryApi.js';
 export { MapleStoryFriendsApi } from './mapleStoryFriendsApi.js';
+export { BattlePracticeCharacterAbilityInfoDto, BattlePracticeCharacterAbilityObjectDto, BattlePracticeCharacterBasicDto, BattlePracticeCharacterBasicStatDto, BattlePracticeCharacterCashItemEquipmentDto, BattlePracticeCharacterCashItemObjectDto, BattlePracticeCharacterCashItemOptionDto, BattlePracticeCharacterFinalStatDto, BattlePracticeCharacterHexaCoreEquipmentDto, BattlePracticeCharacterHexaCoreObjectDto, BattlePracticeCharacterHexaLinkedSkillDto, BattlePracticeCharacterHexaMatrixObjectDto, BattlePracticeCharacterHexaMatrixStatObjectDto, BattlePracticeCharacterHexaStatCoreDto, BattlePracticeCharacterHyperStatDto, BattlePracticeCharacterHyperStatObjectDto, BattlePracticeCharacterInfoDto, BattlePracticeCharacterItemAddOptionDto, BattlePracticeCharacterItemBaseOptionDto, BattlePracticeCharacterItemDragonEquipmentDto, BattlePracticeCharacterItemEquipmentDto, BattlePracticeCharacterItemEquipmentObjectDto, BattlePracticeCharacterItemEtcOptionDto, BattlePracticeCharacterItemExceptionalOptionDto, BattlePracticeCharacterItemMechanicEquipmentDto, BattlePracticeCharacterItemObjectDto, BattlePracticeCharacterItemStarforceOptionDto, BattlePracticeCharacterItemTitleDto, BattlePracticeCharacterItemTotalOptionDto, BattlePracticeCharacterLinkSkillObjectDto, BattlePracticeCharacterOtherStatDetailDto, BattlePracticeCharacterOtherStatDto, BattlePracticeCharacterOtherStatInfoDto, BattlePracticeCharacterPetAutoSkillDto, BattlePracticeCharacterPetEquipmentDto, BattlePracticeCharacterPetEquipmentItemOptionDto, BattlePracticeCharacterPetObjectDto, BattlePracticeCharacterPetiteLunaPetSkillDto, BattlePracticeCharacterPropensityDto, BattlePracticeCharacterRingReserveSkillObjectDto, BattlePracticeCharacterSetEffectDto, BattlePracticeCharacterSetEffectInfoDto, BattlePracticeCharacterSetEffectObjectDto, BattlePracticeCharacterSkillInfoDto, BattlePracticeCharacterSkillObjectDto, BattlePracticeCharacterStatDto, BattlePracticeCharacterSymbolDto, BattlePracticeCharacterSymbolStatDto, BattlePracticeCharacterVCoreDto, BattlePracticeCharacterVMatrixObjectDto, BattlePracticeGuildObjectDto, BattlePracticeGuildSkillDto, BattlePracticeUnionArtifactEffectDto, BattlePracticeUnionArtifactObjectDto, BattlePracticeUnionChampionBadgeDto, BattlePracticeUnionChampionObjectDto, BattlePracticeUnionRaiderObjectDto } from './dto/battlePractice/battlePracticeCharacterInfo.js';
+export { BattlePracticeReplayIdDto, BattlePracticeReplayIdInfoDto } from './dto/battlePractice/battlePracticeReplayId.js';
+export { BattlePracticeResultDto, BattlePracticeSkillStatisticDto } from './dto/battlePractice/battlePracticeResult.js';
+export { BattlePracticeSkillTimelineDto, BattlePracticeSkillTimelineEventDto } from './dto/battlePractice/battlePracticeSkillTimeline.js';
 export { CharacterDto } from './dto/character/character.js';
 export { CharacterAbilityDto, CharacterAbilityInfoDto, CharacterAbilityPresetDto } from './dto/character/characterAbility.js';
 export { CharacterAndroidCashItemEquipmentColoringPrismDto, CharacterAndroidCashItemEquipmentDto, CharacterAndroidCashItemEquipmentOptionDto, CharacterAndroidEquipmentDto, CharacterAndroidEquipmentFaceDto, CharacterAndroidEquipmentHairDto, CharacterAndroidEquipmentPresetDto, CharacterAndroidEquipmentSkinDto } from './dto/character/characterAndroidEquipment.js';
@@ -11,10 +15,10 @@ export { CharacterHexaMatrixDto, CharacterHexaMatrixEquipmentDto, CharacterHexaM
 export { CharacterHexaMatrixStatCoreDto, CharacterHexaMatrixStatDto } from './dto/character/characterHexaMatrixStat.js';
 export { CharacterHyperStatDto, CharacterHyperStatPresetDto } from './dto/character/characterHyperStat.js';
 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 { CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentMedalShapeDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTitlePresetDto, 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 { CharacterPetEquipmentAutoSkillDto, CharacterPetEquipmentDto, CharacterPetEquipmentItemDto, CharacterPetEquipmentItemOptionDto, CharacterPetEquipmentPetiteLunaPetSkillDto } from './dto/character/characterPetEquipment.js';
 export { CharacterPopularityDto } from './dto/character/characterPopularity.js';
 export { CharacterPropensityDto } from './dto/character/characterPropensity.js';
 export { CharacterSetEffectDto, CharacterSetEffectInfoDto, CharacterSetEffectOptionFullDto, CharacterSetEffectSetDto } from './dto/character/characterSetEffect.js';
@@ -23,7 +27,7 @@ export { CharacterFinalStatDto, CharacterStatDto } from './dto/character/charact
 export { CharacterSymbolEquipmentDto, CharacterSymbolEquipmentInfoDto } from './dto/character/characterSymbolEquipment.js';
 export { CharacterRingExchangeSkillEquipmentDto } from './dto/character/characterRingExchangeSkillEquipment.js';
 export { CharacterRingReserveSkillEquipmentDto } from './dto/character/characterRingReserveSkillEquipment.js';
-export { CharacterVMatrixCodeEquipmentDto, CharacterVMatrixDto } from './dto/character/characterVMatrix.js';
+export { CharacterVMatrixCodeEquipmentDto, CharacterVMatrixCoreEquipmentPresetDto, CharacterVMatrixDto } from './dto/character/characterVMatrix.js';
 export { GuildDto } from './dto/guild/guild.js';
 export { GuildBasicDto, GuildSkillDto } from './dto/guild/guildBasic.js';
 export { CubeHistoryDto, CubeHistoryResponseDto, CubeResultOptionDto } from './dto/history/cubeHistory.js';
@@ -43,10 +47,11 @@ export { GuildRankingDto, GuildRankingResponseDto } from './dto/ranking/guildRan
 export { OverallRankingDto, OverallRankingResponseDto } from './dto/ranking/overallRanking.js';
 export { TheSeedRankingDto, TheSeedRankingResponseDto } from './dto/ranking/theSeedRanking.js';
 export { UnionRankingDto, UnionRankingResponseDto } from './dto/ranking/unionRanking.js';
+export { SchedulerBossContentDto, SchedulerCharacterStateDto, SchedulerDailyContentDto, SchedulerWeeklyContentDto } from './dto/scheduler/schedulerCharacterState.js';
 export { UnionDto } from './dto/union/union.js';
 export { UnionArtifactCrystalDto, UnionArtifactDto, UnionArtifactEffectDto } from './dto/union/unionArtifact.js';
 export { UnionChampionBadgeInfoDto, UnionChampionDto, UnionChampionInfoDto } from './dto/union/unionChampion.js';
-export { UnionRaiderBlockControlPointDto, UnionRaiderBlockDto, UnionRaiderBlockPositionDto, UnionRaiderDto, UnionRaiderInnerStatDto, UnionRaiderPresetDto } from './dto/union/unionRaider.js';
+export { UnionRaiderBlockControlPointDto, UnionRaiderBlockDto, UnionRaiderBlockPositionDto, UnionRaiderDto, UnionRaiderInnerStatDto, UnionRaiderPresetDto, UnionRaiderStateStatPresetDto } from './dto/union/unionRaider.js';
 export { AchievementAccountListDto, AchievementAchieveDto, AchievementDto } from './dto/user/achievement.js';
 export { CharacterListAccountCharacterDto, CharacterListAccountDto, CharacterListDto } from './dto/user/characterList.js';
 export { InspectionInfoDto } from './dto/inspectionInfo.js';

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

@@ -1,6 +1,10 @@
 import axios from 'axios';
 import '../../../node_modules/buffer/index.js';
 import xml2js from 'xml2js';
+import { BattlePracticeCharacterInfoDto } from './dto/battlePractice/battlePracticeCharacterInfo.js';
+import { BattlePracticeReplayIdDto } from './dto/battlePractice/battlePracticeReplayId.js';
+import { BattlePracticeResultDto } from './dto/battlePractice/battlePracticeResult.js';
+import { BattlePracticeSkillTimelineDto } from './dto/battlePractice/battlePracticeSkillTimeline.js';
 import { CharacterDto } from './dto/character/character.js';
 import { CharacterAbilityDto } from './dto/character/characterAbility.js';
 import { CharacterAndroidEquipmentDto } from './dto/character/characterAndroidEquipment.js';
@@ -31,6 +35,8 @@ import { CubeHistoryResponseDto } from './dto/history/cubeHistory.js';
 import { PotentialHistoryResponseDto } from './dto/history/potentialHistory.js';
 import { StarforceHistoryResponseDto } from './dto/history/starforceHistory.js';
 import { InspectionInfoDto } from './dto/inspectionInfo.js';
+import { removeQuery } from '../common/lib.js';
+import { MapleStoryApi as MapleStoryApi$1 } from '../common/mapleStoryApi.js';
 import { CashshopNoticeDetailDto } from './dto/notice/cashshopNoticeDetail.js';
 import { CashshopNoticeListDto } from './dto/notice/cashshopNoticeList.js';
 import { EventNoticeDetailDto } from './dto/notice/eventNoticeDetail.js';
@@ -45,6 +51,7 @@ import { GuildRankingResponseDto } from './dto/ranking/guildRanking.js';
 import { OverallRankingResponseDto } from './dto/ranking/overallRanking.js';
 import { TheSeedRankingResponseDto } from './dto/ranking/theSeedRanking.js';
 import { UnionRankingResponseDto } from './dto/ranking/unionRanking.js';
+import { SchedulerCharacterStateDto } from './dto/scheduler/schedulerCharacterState.js';
 import { UnionDto } from './dto/union/union.js';
 import { UnionArtifactDto } from './dto/union/unionArtifact.js';
 import { UnionChampionDto } from './dto/union/unionChampion.js';
@@ -52,8 +59,6 @@ import { UnionRaiderDto } from './dto/union/unionRaider.js';
 import { AchievementDto } from './dto/user/achievement.js';
 import { CharacterListDto } from './dto/user/characterList.js';
 import { CharacterImageAction, CharacterImageEmotion, CharacterImageWeaponMotion } from '../common/enum/characterImage.js';
-import { removeQuery } from '../common/lib.js';
-import { MapleStoryApi as MapleStoryApi$1 } from '../common/mapleStoryApi.js';
 import { __exports as buffer } from '../../../_virtual/index.js_commonjs-exports.js';
 
 /**
@@ -1070,6 +1075,105 @@ class MapleStoryApi extends MapleStoryApi$1 {
         }
         return new GuildBasicDto(data);
     }
+    //#endregion
+    //#region 연무장 정보 조회
+    /**
+     * 캐릭터의 연무장 리플레이 식별자를 조회합니다. 리플레이를 등록한 캐릭터에 대해서만 조회가 가능합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     */
+    async getBattlePracticeReplayId(ocid) {
+        const path = `${this.subUrl}/v1/battle-practice/replay-id`;
+        const query = {
+            ocid: ocid,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new BattlePracticeReplayIdDto(data);
+    }
+    /**
+     * 연무장 측정 결과 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param replayId 연무장 리플레이 고유 식별자
+     */
+    async getBattlePracticeResult(replayId) {
+        const path = `${this.subUrl}/v1/battle-practice/result`;
+        const query = {
+            replay_id: replayId,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new BattlePracticeResultDto(data);
+    }
+    /**
+     * 연무장 진행 간 스킬 사용 내역을 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param replayId 연무장 리플레이 고유 식별자
+     * @param pageNo 페이지 번호 (미입력 시 1페이지 조회)
+     */
+    async getBattlePracticeSkillTimeline(replayId, pageNo) {
+        const path = `${this.subUrl}/v1/battle-practice/skill-timeline`;
+        const query = {
+            replay_id: replayId,
+            page_no: pageNo,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new BattlePracticeSkillTimelineDto(data);
+    }
+    /**
+     * 연무장 입장 시의 캐릭터 능력치 관련 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param replayId 연무장 리플레이 고유 식별자
+     */
+    async getBattlePracticeCharacterInfo(replayId) {
+        const path = `${this.subUrl}/v1/battle-practice/character-info`;
+        const query = {
+            replay_id: replayId,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        return new BattlePracticeCharacterInfoDto(data);
+    }
+    //#endregion
+    //#region 스케줄러 정보 조회
+    /**
+     * 캐릭터에 대한 스케줄러의 수행 현황 정보를 조회하는 API입니다.
+     *
+     * @param ocid 캐릭터 식별자
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    async getSchedulerCharacterState(ocid, dateOptions) {
+        const path = `${this.subUrl}/v1/scheduler/character-state`;
+        const date = dateOptions ? this.toDateString(dateOptions) : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
+        return new SchedulerCharacterStateDto(data);
+    }
     async getStarforceHistory(count, parameter) {
         const path = `${this.subUrl}/v1/history/starforce`;
         const query = {
@@ -1146,7 +1250,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
     /**
      * 종합 랭킹 정보를 조회합니다.
      * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
-     * - 오늘의 랭킹 정보는 오전 9시 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
+     * - 오늘의 랭킹 정보는 오전 9시 30분 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
@@ -1156,7 +1260,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
      */
     async getOverallRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
         hour: 9,
-        minute: 0,
+        minute: 30,
         dateOffset: 0,
     })) {
         const path = `${this.subUrl}/v1/ranking/overall`;
@@ -1183,7 +1287,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
     /**
      * 유니온 랭킹 정보를 조회합니다.
      * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
-     * - 오늘의 랭킹 정보는 오전 9시 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
+     * - 오늘의 랭킹 정보는 오전 9시 30분 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
@@ -1192,7 +1296,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
      */
     async getUnionRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
         hour: 9,
-        minute: 0,
+        minute: 30,
         dateOffset: 0,
     })) {
         const path = `${this.subUrl}/v1/ranking/union`;
@@ -1217,7 +1321,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
     /**
      * 길드 랭킹 정보를 조회합니다.
      * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
-     * - 오늘의 랭킹 정보는 오전 9시 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
+     * - 오늘의 랭킹 정보는 오전 9시 30분 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
@@ -1226,7 +1330,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
      */
     async getGuildRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
         hour: 9,
-        minute: 0,
+        minute: 30,
         dateOffset: 0,
     })) {
         const path = `${this.subUrl}/v1/ranking/guild`;
@@ -1253,7 +1357,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
     /**
      * 무릉도장 랭킹 정보를 조회합니다.
      * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
-     * - 오늘의 랭킹 정보는 오전 9시 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
+     * - 오늘의 랭킹 정보는 오전 9시 30분 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
@@ -1262,7 +1366,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
      */
     async getDojangRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
         hour: 9,
-        minute: 0,
+        minute: 30,
         dateOffset: 0,
     })) {
         const path = `${this.subUrl}/v1/ranking/dojang`;
@@ -1290,7 +1394,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
     /**
      * 더 시드 랭킹 정보를 조회합니다.
      * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
-     * - 오늘의 랭킹 정보는 오전 9시 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
+     * - 오늘의 랭킹 정보는 오전 9시 30분 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
@@ -1299,7 +1403,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
      */
     async getSeedRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
         hour: 9,
-        minute: 0,
+        minute: 30,
         dateOffset: 0,
     })) {
         const path = `${this.subUrl}/v1/ranking/theseed`;
@@ -1324,7 +1428,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
     /**
      * 업적 랭킹 정보를 조회합니다.
      * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
-     * - 오늘의 랭킹 정보는 오전 9시 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
+     * - 오늘의 랭킹 정보는 오전 9시 30분 경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
      *
@@ -1333,7 +1437,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
      */
     async getAchievementRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
         hour: 9,
-        minute: 0,
+        minute: 30,
         dateOffset: 0,
     })) {
         const path = `${this.subUrl}/v1/ranking/achievement`;

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

@@ -1,9 +1,9 @@
+import { MapleStoryFriendsApi as MapleStoryFriendsApi$1 } from '../common/mapleStoryFriendsApi.js';
 import { CubeHistoryResponseDto } from './dto/history/cubeHistory.js';
 import { PotentialHistoryResponseDto } from './dto/history/potentialHistory.js';
 import { StarforceHistoryResponseDto } from './dto/history/starforceHistory.js';
 import { AchievementDto } from './dto/user/achievement.js';
 import { CharacterListDto } from './dto/user/characterList.js';
-import { MapleStoryFriendsApi as MapleStoryFriendsApi$1 } from '../common/mapleStoryFriendsApi.js';
 
 /**
  * MapleStory Friends API client for KMS<br>

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

@@ -1,5 +1,6 @@
 import axios from 'axios';
 import '../../../node_modules/buffer/index.js';
+import { removeQuery } from '../common/lib.js';
 import { CharacterDto } from './dto/character/character.js';
 import { CharacterAbilityDto } from './dto/character/characterAbility.js';
 import { CharacterAndroidEquipmentDto } from './dto/character/characterAndroidEquipment.js';
@@ -29,7 +30,6 @@ import { UnionChampionDto } from './dto/union/unionChampion.js';
 import { UnionRaiderDto } from './dto/union/unionRaider.js';
 import { CharacterImageAction, CharacterImageEmotion, CharacterImageWeaponMotion } from '../common/enum/characterImage.js';
 import { MapleStoryApi as MapleStoryApi$1 } from '../common/mapleStoryApi.js';
-import { removeQuery } from '../common/lib.js';
 import { __exports as buffer } from '../../../_virtual/index.js_commonjs-exports.js';
 
 /**