maplestory-openapi 3.8.1 → 3.10.0

package/types/maplestory/api/kms/dto/battlePractice/battlePracticeReplayId.d.ts

@@ -0,0 +1,29 @@
+import { BattlePracticeReplayBody, BattlePracticeReplayIdBody } from '../../response/battlePractice/battlePracticeReplayIdBody';
+/**
+ * 연무장 리플레이 식별자 목록
+ */
+export declare class BattlePracticeReplayIdDto {
+    /**
+     * 리플레이 목록
+     */
+    replayList: BattlePracticeReplayIdInfoDto[];
+    constructor(obj: BattlePracticeReplayIdBody);
+}
+/**
+ * 연무장 리플레이 식별자 상세 정보
+ */
+export declare class BattlePracticeReplayIdInfoDto {
+    /**
+     * 기간 번호 (연무장 초기화 시마다 1씩 증가됩니다.)
+     */
+    periodNo: number;
+    /**
+     * 리플레이 등록 일시 (KST)
+     */
+    registerDate: Date;
+    /**
+     * 연무장 리플레이 고유 식별자
+     */
+    replayId: string;
+    constructor(obj: BattlePracticeReplayBody);
+}

package/types/maplestory/api/kms/dto/battlePractice/battlePracticeResult.d.ts

@@ -0,0 +1,77 @@
+import { BattlePracticeResultBody, BattlePracticeSkillStatisticBody } from '../../response/battlePractice/battlePracticeResultBody';
+/**
+ * 연무장 측정 결과 정보
+ */
+export declare class BattlePracticeResultDto {
+    /**
+     * 리플레이 등록 일시 (KST)
+     */
+    registerDate: Date;
+    /**
+     * 총 연무 시간 (ms)
+     */
+    totalPlayTime: number;
+    /**
+     * 총합 데미지
+     */
+    totalDamage: number;
+    /**
+     * 초당 평균 데미지
+     */
+    totalDps: number;
+    /**
+     * 종료 타입 (1:자동 종료, 2:수동 종료, 3:시간 초과, 9:기타 종료)
+     */
+    endType: string;
+    /**
+     * 리플레이 추천 수
+     */
+    likeCount: number;
+    /**
+     * 스킬 단위 전투 분석 정보
+     */
+    skillStatistic: BattlePracticeSkillStatisticDto[];
+    constructor(obj: BattlePracticeResultBody);
+}
+/**
+ * 연무장 스킬 단위 전투 분석 정보
+ */
+export declare class BattlePracticeSkillStatisticDto {
+    /**
+     * 스킬 명
+     */
+    skillName: string;
+    /**
+     * 누적 데미지
+     */
+    damage: number;
+    /**
+     * 데미지 점유율
+     */
+    damagePercent: string;
+    /**
+     * 초당 평균 데미지
+     */
+    dps: number;
+    /**
+     * 사용 횟수
+     */
+    useCount: number;
+    /**
+     * 1회당 평균 데미지
+     */
+    damagePerUse: number;
+    /**
+     * 공격 횟수
+     */
+    attackCount: number;
+    /**
+     * 최대 데미지 (1타)
+     */
+    maxDamage: number;
+    /**
+     * 최소 데미지 (1타)
+     */
+    minDamage: number;
+    constructor(obj: BattlePracticeSkillStatisticBody);
+}

package/types/maplestory/api/kms/dto/battlePractice/battlePracticeSkillTimeline.d.ts

@@ -0,0 +1,45 @@
+import { BattlePracticeSkillTimelineBody, BattlePracticeSkillTimelineEventBody } from '../../response/battlePractice/battlePracticeSkillTimelineBody';
+/**
+ * 연무장 스킬 사용 내역
+ */
+export declare class BattlePracticeSkillTimelineDto {
+    /**
+     * 조회된 페이지 번호
+     */
+    pageNo: number;
+    /**
+     * 전체 페이지 번호
+     */
+    totalPageNo: number;
+    /**
+     * 스킬 타임라인 정보
+     */
+    skillTimeline: BattlePracticeSkillTimelineEventDto[];
+    constructor(obj: BattlePracticeSkillTimelineBody);
+}
+/**
+ * 연무장 스킬 타임라인
+ */
+export declare class BattlePracticeSkillTimelineEventDto {
+    /**
+     * 연무 시작 후 경과 시간 (ms)
+     */
+    elapseTime: number;
+    /**
+     * 사용한 스킬 명
+     */
+    skillName: string;
+    /**
+     * 헥사 스킬 특성 여부 (0:그 외 스킬, 1:오리진 스킬, 2:어센트 스킬)
+     */
+    hexaSkillSpecificityFlag: string;
+    /**
+     * 시퀀스 명
+     */
+    sequenceName: string | null;
+    /**
+     * 시퀀스 키
+     */
+    sequenceKey: string | null;
+    constructor(obj: BattlePracticeSkillTimelineEventBody);
+}

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

@@ -226,5 +226,9 @@ export declare class CharacterPetEquipmentItemDto extends base.CharacterPetEquip
      * 아이템 외형 아이콘
      */
     itemShapeIcon: string | null;
+    /**
+     * 아이템 만료시간 (KST, 분 단위는 일괄 0으로 표기, null:무제한, -1:미착용)
+     */
+    itemDateExpire: Date | null;
     constructor(obj: CharacterPetEquipmentItemBody);
 }

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

@@ -0,0 +1,31 @@
+import { CharacterRingReserveSkillEquipmentBody } from '../../response/character/characterRingReserveSkillEquipmentBody';
+/**
+ * 캐릭터 예비 특수 반지 장착 정보
+ */
+export declare class CharacterRingReserveSkillEquipmentDto {
+    /**
+     * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
+     */
+    date: Date | null;
+    /**
+     * 캐릭터 직업
+     */
+    characterClass: string;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지
+     */
+    specialRingReserveName: string | null;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 레벨
+     */
+    specialRingReserveLevel: number | null;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 아이콘
+     */
+    specialRingReserveIcon: string | null;
+    /**
+     * 예비 특수 반지 슬롯에 장착한 특수 반지 설명
+     */
+    specialRingReserveDescription: string | null;
+    constructor(obj: CharacterRingReserveSkillEquipmentBody);
+}

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

@@ -22,7 +22,7 @@ export declare class StarforceHistoryDto {
     /**
      * 스타 캐치
      */
-    starCatchResult: string;
+    starCatchResult: string | null;
     /**
      * 슈페리얼 장비
      */

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

@@ -1,5 +1,9 @@
 export * from './mapleStoryApi';
 export * from './mapleStoryFriendsApi';
+export * from './dto/battlePractice/battlePracticeCharacterInfo';
+export * from './dto/battlePractice/battlePracticeReplayId';
+export * from './dto/battlePractice/battlePracticeResult';
+export * from './dto/battlePractice/battlePracticeSkillTimeline';
 export * from './dto/character/character';
 export * from './dto/character/characterAbility';
 export * from './dto/character/characterAndroidEquipment';
@@ -21,6 +25,8 @@ export * from './dto/character/characterSetEffect';
 export * from './dto/character/characterSkill';
 export * from './dto/character/characterStat';
 export * from './dto/character/characterSymbolEquipment';
+export * from './dto/character/characterRingExchangeSkillEquipment';
+export * from './dto/character/characterRingReserveSkillEquipment';
 export * from './dto/character/characterVMatrix';
 export * from './dto/guild/guild';
 export * from './dto/guild/guildBasic';

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

@@ -1,3 +1,7 @@
+import { BattlePracticeCharacterInfoDto } from './dto/battlePractice/battlePracticeCharacterInfo';
+import { BattlePracticeReplayIdDto } from './dto/battlePractice/battlePracticeReplayId';
+import { BattlePracticeResultDto } from './dto/battlePractice/battlePracticeResult';
+import { BattlePracticeSkillTimelineDto } from './dto/battlePractice/battlePracticeSkillTimeline';
 import { CharacterDto } from './dto/character/character';
 import { CharacterAbilityDto } from './dto/character/characterAbility';
 import { CharacterAndroidEquipmentDto } from './dto/character/characterAndroidEquipment';
@@ -16,6 +20,7 @@ import { CharacterPetEquipmentDto } from './dto/character/characterPetEquipment'
 import { CharacterPopularityDto } from './dto/character/characterPopularity';
 import { CharacterPropensityDto } from './dto/character/characterPropensity';
 import { CharacterRingExchangeSkillEquipmentDto } from './dto/character/characterRingExchangeSkillEquipment';
+import { CharacterRingReserveSkillEquipmentDto } from './dto/character/characterRingReserveSkillEquipment';
 import { CharacterSetEffectDto } from './dto/character/characterSetEffect';
 import { CharacterSkillDto } from './dto/character/characterSkill';
 import { CharacterStatDto } from './dto/character/characterStat';
@@ -342,7 +347,8 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
     /**
      * 링 익스체인지 스킬 등록 장비를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
-     * - 2025년 8월 21일 데이터부터 조회할 수 있습니다.
+     * - 2025년 08월 21일부터 2026년 3월 18일까지의 데이터를 조회할 수 있습니다.
+     * - 2026년 3월 19일부터는 예비 특수 반지 장착 정보 조회를 사용해주세요.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (8월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
@@ -351,6 +357,18 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param dateOptions 조회 기준일 (KST)
      */
     getCharacterRingExchangeSkillEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterRingExchangeSkillEquipmentDto | null>;
+    /**
+     * 예비 특수 반지 장착 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 2026년 3월 19일 데이터부터 조회할 수 있습니다.
+     * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (3월 20일 데이터 조회 시, 20일 00시부터 21일 00시 사이 데이터가 조회 됩니다.)
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     * @param dateOptions 조회 기준일 (KST)
+     */
+    getCharacterRingReserveSkillEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterRingReserveSkillEquipmentDto | null>;
     /**
      * 유니온 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -424,6 +442,43 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param dateOptions 조회 기준일 (KST)
      */
     getGuildBasic(guildId: string, dateOptions?: DateOptions): Promise<GuildBasicDto | null>;
+    /**
+     * 캐릭터의 연무장 리플레이 식별자를 조회합니다. 리플레이를 등록한 캐릭터에 대해서만 조회가 가능합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param ocid 캐릭터 식별자
+     */
+    getBattlePracticeReplayId(ocid: string): Promise<BattlePracticeReplayIdDto>;
+    /**
+     * 연무장 측정 결과 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param replayId 연무장 리플레이 고유 식별자
+     */
+    getBattlePracticeResult(replayId: string): Promise<BattlePracticeResultDto>;
+    /**
+     * 연무장 진행 간 스킬 사용 내역을 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param replayId 연무장 리플레이 고유 식별자
+     * @param pageNo 페이지 번호 (미입력 시 1페이지 조회)
+     */
+    getBattlePracticeSkillTimeline(replayId: string, pageNo?: number): Promise<BattlePracticeSkillTimelineDto>;
+    /**
+     * 연무장 입장 시의 캐릭터 능력치 관련 정보를 조회합니다.
+     * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
+     * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
+     * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
+     *
+     * @param replayId 연무장 리플레이 고유 식별자
+     */
+    getBattlePracticeCharacterInfo(replayId: string): Promise<BattlePracticeCharacterInfoDto>;
     /**
      * 스타포스 강화 결과를 조회합니다.
      * - 스타포스 확률 정보는 최대 5분 후 확인 가능합니다.