maplestory-openapi 3.4.1 → 3.5.0

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

@@ -11,15 +11,15 @@ export declare class CharacterDojangDto extends base.CharacterDojangDto {
     /**
      * 캐릭터 직업
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * 월드 명
      */
-    worldName: string | null;
+    worldName: string;
     /**
      * 무릉도장 최고 기록 층수
      */
-    dojangBestFloor: number | null;
+    dojangBestFloor: number;
     /**
      * 무릉도장 최고 기록 달성 일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
      */
@@ -27,6 +27,6 @@ export declare class CharacterDojangDto extends base.CharacterDojangDto {
     /**
      * 무릉도장 최고 층수 클리어에 걸린 시간 (초)
      */
-    dojangBestTime: number | null;
+    dojangBestTime: number;
     constructor(obj: CharacterDojangBody);
 }

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

@@ -11,7 +11,7 @@ export declare class CharacterHexaMatrixStatDto extends base.CharacterHexaMatrix
     /**
      * 캐릭터 직업
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * HEXA 스탯 I 코어 정보
      */

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

@@ -11,15 +11,15 @@ export declare class CharacterHyperStatDto extends base.CharacterHyperStatDto {
     /**
      * 캐릭터 직업
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * 적용 중인 프리셋 번호
      */
-    usePresetNo: string | null;
+    usePresetNo: string;
     /**
      * 사용 가능한 최대 하이퍼스탯 포인트
      */
-    useAvailableHyperStat: number | null;
+    useAvailableHyperStat: number;
     /**
      * 프리셋 1번 하이퍼 스탯 정보
      */
@@ -27,7 +27,7 @@ export declare class CharacterHyperStatDto extends base.CharacterHyperStatDto {
     /**
      * 프리셋 1번 하이퍼 스탯 잔여 포인트
      */
-    hyperStatPreset1RemainPoint: number | null;
+    hyperStatPreset1RemainPoint: number;
     /**
      * 프리셋 2번 하이퍼 스탯 정보
      */
@@ -35,7 +35,7 @@ export declare class CharacterHyperStatDto extends base.CharacterHyperStatDto {
     /**
      * 프리셋 2번 하이퍼 스탯 잔여 포인트
      */
-    hyperStatPreset2RemainPoint: number | null;
+    hyperStatPreset2RemainPoint: number;
     /**
      * 프리셋 3번 하이퍼 스탯 정보
      */
@@ -43,7 +43,7 @@ export declare class CharacterHyperStatDto extends base.CharacterHyperStatDto {
     /**
      * 프리셋 3번 하이퍼 스탯 잔여 포인트
      */
-    hyperStatPreset3RemainPoint: number | null;
+    hyperStatPreset3RemainPoint: number;
     constructor(obj: CharacterHyperStatBody);
 }
 /**

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

@@ -11,11 +11,11 @@ export declare class CharacterItemEquipmentDto extends base.CharacterItemEquipme
     /**
      * 캐릭터 성별
      */
-    characterGender: string | null;
+    characterGender: string;
     /**
      * 캐릭터 직업
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * 적용 중인 장비 프리셋 번호
      */

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

@@ -11,7 +11,7 @@ export declare class CharacterLinkSkillDto extends base.CharacterLinkSkillDto {
     /**
      * 캐릭터 직업
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * 링크 스킬 정보
      */

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

@@ -11,26 +11,26 @@ export declare class CharacterPropensityDto extends base.CharacterPropensityDto
     /**
      * 카리스마 레벨
      */
-    charismaLevel: number | null;
+    charismaLevel: number;
     /**
      * 감성 레벨
      */
-    sensibilityLevel: number | null;
+    sensibilityLevel: number;
     /**
      * 통찰력 레벨
      */
-    insightLevel: number | null;
+    insightLevel: number;
     /**
      *  의지 레벨
      */
-    willingnessLevel: number | null;
+    willingnessLevel: number;
     /**
      * 손재주 레벨
      */
-    handicraftLevel: number | null;
+    handicraftLevel: number;
     /**
      * 매력 레벨
      */
-    charmLevel: number | null;
+    charmLevel: number;
     constructor(obj: CharacterPropensityBody);
 }

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

@@ -11,7 +11,7 @@ export declare class CharacterSkillDto extends base.CharacterSkillDto {
     /**
      * 캐릭터 직업
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * 스킬 전직 차수
      */

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

@@ -11,7 +11,7 @@ export declare class CharacterStatDto extends base.CharacterStatDto {
     /**
      * 캐릭터 직업
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * 현재 스탯 정보
      */
@@ -19,7 +19,7 @@ export declare class CharacterStatDto extends base.CharacterStatDto {
     /**
      * 잔여 AP
      */
-    remainAP: number | null;
+    remainAP: number;
     constructor(obj: CharacterStatBody);
 }
 /**

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

@@ -11,7 +11,7 @@ export declare class CharacterSymbolEquipmentDto extends base.CharacterSymbolEqu
     /**
      * 캐릭터 직업
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * 심볼 정보
      */

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

@@ -11,7 +11,7 @@ export declare class CharacterVMatrixDto extends base.CharacterVMatrixDto {
     /**
      * 캐릭터 직업
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * V코어 정보
      */
@@ -19,7 +19,7 @@ export declare class CharacterVMatrixDto extends base.CharacterVMatrixDto {
     /**
      * 캐릭터 잔여 매트릭스 강화 포인트
      */
-    characterVMatrixRemainSlotUpgradePoint: number | null;
+    characterVMatrixRemainSlotUpgradePoint: number;
     constructor(obj: CharacterVMatrixBody);
 }
 /**

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

@@ -70,7 +70,7 @@ export declare class StarforceHistoryDto {
     /**
      * 진행 중인 스타포스 강화 이벤트 정보
      */
-    starforceEventList: StarforceEventDto[] | null;
+    starforceEventList: StarforceEventDto[];
     constructor(obj: StarforceHistoryBody);
 }
 /**
@@ -80,7 +80,7 @@ export declare class StarforceEventDto {
     /**
      * 이벤트 성공 확률
      */
-    successRate: string;
+    successRate: string | null;
     /**
      * 이벤트 파괴 확률 감소율
      */
@@ -88,11 +88,11 @@ export declare class StarforceEventDto {
     /**
      * 이벤트 비용 할인율
      */
-    costDiscountRate: string;
+    costDiscountRate: string | null;
     /**
      * 이벤트 강화 수치 가중값
      */
-    plusValue: string;
+    plusValue: string | null;
     /**
      * 이벤트 적용 강화 시도 가능한 n성 범위
      */

package/types/maplestory/api/kms/dto/union/unionRaider.d.ts

@@ -103,7 +103,7 @@ export declare class UnionRaiderBlockDto extends base.UnionRaiderBlockDto {
     /**
      * 블록 해당 캐릭터 직업
      */
-    blockClass: string;
+    blockClass: string | null;
     /**
      * 블록 해당 캐릭터 레벨
      */

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

@@ -96,7 +96,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterBasic(ocid: string, dateOptions?: DateOptions): Promise<CharacterBasicDto>;
+    getCharacterBasic(ocid: string, dateOptions?: DateOptions): Promise<CharacterBasicDto | null>;
     /**
      * 캐릭터 외형 이미지 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -109,7 +109,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param imageOptions 캐릭터 외형 파라미터
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterImage(ocid: string, imageOptions?: CharacterImageOptions, dateOptions?: DateOptions): Promise<CharacterImageDto>;
+    getCharacterImage(ocid: string, imageOptions?: CharacterImageOptions, dateOptions?: DateOptions): Promise<CharacterImageDto | null>;
     /**
      * 인기도 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -121,7 +121,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterPopularity(ocid: string, dateOptions?: DateOptions): Promise<CharacterPopularityDto>;
+    getCharacterPopularity(ocid: string, dateOptions?: DateOptions): Promise<CharacterPopularityDto | null>;
     /**
      * 종합 능력치 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -133,7 +133,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterStatDto>;
+    getCharacterStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterStatDto | null>;
     /**
      * 하이퍼스탯 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -145,7 +145,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterHyperStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterHyperStatDto>;
+    getCharacterHyperStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterHyperStatDto | null>;
     /**
      * 성향 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -157,7 +157,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterPropensity(ocid: string, dateOptions?: DateOptions): Promise<CharacterPropensityDto>;
+    getCharacterPropensity(ocid: string, dateOptions?: DateOptions): Promise<CharacterPropensityDto | null>;
     /**
      * 어빌리티 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -169,7 +169,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterAbility(ocid: string, dateOptions?: DateOptions): Promise<CharacterAbilityDto>;
+    getCharacterAbility(ocid: string, dateOptions?: DateOptions): Promise<CharacterAbilityDto | null>;
     /**
      * 장착한 장비 중 캐시 장비를 제외한 나머지 장비 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -181,7 +181,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterItemEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterItemEquipmentDto>;
+    getCharacterItemEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterItemEquipmentDto | null>;
     /**
      * 장착한 캐시 장비 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -193,7 +193,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterCashItemEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterCashItemEquipmentDto>;
+    getCharacterCashItemEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterCashItemEquipmentDto | null>;
     /**
      * 장착한 심볼 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -205,7 +205,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterSymbolEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterSymbolEquipmentDto>;
+    getCharacterSymbolEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterSymbolEquipmentDto | null>;
     /**
      * 적용받고 있는 세트 효과 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -217,7 +217,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterSetEffect(ocid: string, dateOptions?: DateOptions): Promise<CharacterSetEffectDto>;
+    getCharacterSetEffect(ocid: string, dateOptions?: DateOptions): Promise<CharacterSetEffectDto | null>;
     /**
      * 장착 중인 헤어, 성형, 피부 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -229,7 +229,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterBeautyEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterBeautyEquipmentDto>;
+    getCharacterBeautyEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterBeautyEquipmentDto | null>;
     /**
      * 장착한 안드로이드 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -241,7 +241,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterAndroidEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterAndroidEquipmentDto>;
+    getCharacterAndroidEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterAndroidEquipmentDto | null>;
     /**
      * 장착한 펫 및 펫 스킬, 장비 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -253,7 +253,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterPetEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterPetEquipmentDto>;
+    getCharacterPetEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterPetEquipmentDto | null>;
     /**
      * 캐릭터 스킬과 하이퍼 스킬 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -266,7 +266,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param characterSkillGrade 조회하고자 하는 전직 차수 <a href="https://openapi.nexon.com/ko/game/maplestory/?id=14">Available values</a>
      *  @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterSkill(ocid: string, characterSkillGrade: string, dateOptions?: DateOptions): Promise<CharacterSkillDto>;
+    getCharacterSkill(ocid: string, characterSkillGrade: string, dateOptions?: DateOptions): Promise<CharacterSkillDto | null>;
     /**
      * 장착 링크 스킬 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -278,7 +278,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterLinkSkill(ocid: string, dateOptions?: DateOptions): Promise<CharacterLinkSkillDto>;
+    getCharacterLinkSkill(ocid: string, dateOptions?: DateOptions): Promise<CharacterLinkSkillDto | null>;
     /**
      * V매트릭스 슬롯 정보와 장착한 V코어 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -290,7 +290,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterVMatrix(ocid: string, dateOptions?: DateOptions): Promise<CharacterVMatrixDto>;
+    getCharacterVMatrix(ocid: string, dateOptions?: DateOptions): Promise<CharacterVMatrixDto | null>;
     /**
      * HEXA 매트릭스에 장착한 HEXA 코어 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -302,7 +302,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterHexaMatrix(ocid: string, dateOptions?: DateOptions): Promise<CharacterHexaMatrixDto>;
+    getCharacterHexaMatrix(ocid: string, dateOptions?: DateOptions): Promise<CharacterHexaMatrixDto | null>;
     /**
      * HEXA 매트릭스에 설정한 HEXA 스탯 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -314,7 +314,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterHexaMatrixStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterHexaMatrixStatDto>;
+    getCharacterHexaMatrixStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterHexaMatrixStatDto | null>;
     /**
      * 캐릭터 무릉도장 최고 기록 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -326,7 +326,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterDojang(ocid: string, dateOptions?: DateOptions): Promise<CharacterDojangDto>;
+    getCharacterDojang(ocid: string, dateOptions?: DateOptions): Promise<CharacterDojangDto | null>;
     /**
      * 능력치에 영향을 주는 요소 중 다른 조회에서 능력치 확인이 어려운 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -338,7 +338,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterOtherStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterOtherStatDto>;
+    getCharacterOtherStat(ocid: string, dateOptions?: DateOptions): Promise<CharacterOtherStatDto | null>;
     /**
      * 링 익스체인지 스킬 등록 장비를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -350,7 +350,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getCharacterRingExchangeSkillEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterRingExchangeSkillEquipmentDto>;
+    getCharacterRingExchangeSkillEquipment(ocid: string, dateOptions?: DateOptions): Promise<CharacterRingExchangeSkillEquipmentDto | null>;
     /**
      * 유니온 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -362,7 +362,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getUnion(ocid: string, dateOptions?: DateOptions): Promise<UnionDto>;
+    getUnion(ocid: string, dateOptions?: DateOptions): Promise<UnionDto | null>;
     /**
      * 유니온 공격대 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -374,11 +374,11 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getUnionRaider(ocid: string, dateOptions?: DateOptions): Promise<UnionRaiderDto>;
+    getUnionRaider(ocid: string, dateOptions?: DateOptions): Promise<UnionRaiderDto | null>;
     /**
      * 유니온 아티팩트 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
-     * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
+     * - 2024년 1월 18일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
@@ -386,12 +386,12 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getUnionArtifact(ocid: string, dateOptions?: DateOptions): Promise<UnionArtifactDto>;
+    getUnionArtifact(ocid: string, dateOptions?: DateOptions): Promise<UnionArtifactDto | null>;
     /**
      * 유니온 챔피언 정보를 조회합니다.<br>
      * 유니온 챔피언 정보는 2025년 2월 20일 메이플스토리 점검 이후 데이터부터 조회 가능합니다.<br>
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
-     * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
+     * - 2025년 2월 20일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
@@ -399,7 +399,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param ocid 캐릭터 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getUnionChampion(ocid: string, dateOptions?: DateOptions): Promise<UnionChampionDto>;
+    getUnionChampion(ocid: string, dateOptions?: DateOptions): Promise<UnionChampionDto | null>;
     /**
      * 길드 식별자(oguild_id) 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -411,7 +411,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param guildName 길드 명
      * @param worldName 월드 명 <a href="https://openapi.nexon.com/game/maplestory/?id=16">Available values</a>
      */
-    getGuild(guildName: string, worldName: string): Promise<GuildDto>;
+    getGuild(guildName: string, worldName: string): Promise<GuildDto | null>;
     /**
      * 길드 기본 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
@@ -423,7 +423,7 @@ export declare class MapleStoryApi extends base.MapleStoryApi {
      * @param guildId 길드 식별자
      * @param dateOptions 조회 기준일 (KST)
      */
-    getGuildBasic(guildId: string, dateOptions?: DateOptions): Promise<GuildBasicDto>;
+    getGuildBasic(guildId: string, dateOptions?: DateOptions): Promise<GuildBasicDto | null>;
     /**
      * 스타포스 강화 결과를 조회합니다.
      * - 스타포스 확률 정보는 최대 5분 후 확인 가능합니다.
@@ -846,9 +846,9 @@ type GuildRankingApiFilterOptions = {
      */
     rankingType: number;
     /**
-     * 캐릭터 식별자
+     * 길드 명
      */
-    ocid?: string;
+    guildName?: string;
     /**
      * 페이지 번호
      */

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

@@ -8,7 +8,7 @@ export type CharacterAndroidEquipmentBody = {
     android_face: CharacterAndroidEquipmentFaceBody | null;
     android_skin: CharacterAndroidEquipmentSkinBody | null;
     android_cash_item_equipment: CharacterAndroidCashItemEquipmentBody[];
-    android_ear_sensor_clip_flag: string | null;
+    android_ear_sensor_clip_flag: string;
     android_gender: string | null;
     android_grade: string | null;
     android_non_humanoid_flag: string | null;

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

@@ -10,7 +10,7 @@ export type CharacterBasicBody = {
     character_exp_rate: string;
     character_guild_name: string | null;
     character_image: string;
-    character_date_create: string;
+    character_date_create: string | null;
     access_flag: 'true' | 'false';
     liberation_quest_clear: string;
 };

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

@@ -1,4 +1,4 @@
 export type CharacterPopularityBody = {
     date: string | null;
-    popularity: number;
+    popularity: number | null;
 };

package/types/maplestory/api/kms/response/union/unionRaiderBody.d.ts

@@ -17,7 +17,7 @@ export type UnionRaiderInnerStatBody = {
 };
 export type UnionRaiderBlockBody = {
     block_type: string;
-    block_class: string;
+    block_class: string | null;
     block_level: string;
     block_control_point: UnionRaiderBlockControlPointBody;
     block_position: UnionRaiderBlockPositionBody[];

package/types/maplestory/api/msea/dto/character/characterAbility.d.ts

@@ -11,7 +11,7 @@ export declare class CharacterAbilityDto extends base.CharacterAbilityDto {
     /**
      * Ability grade
      */
-    abilityGrade: string | null;
+    abilityGrade: string;
     /**
      * Ability information
      */
@@ -19,7 +19,7 @@ export declare class CharacterAbilityDto extends base.CharacterAbilityDto {
     /**
      * Owned Honor EXP
      */
-    remainFame: number | null;
+    remainFame: number;
     /**
      * Active ability preset number
      */

package/types/maplestory/api/msea/dto/character/characterBasic.d.ts

@@ -51,7 +51,7 @@ export declare class CharacterBasicDto extends base.CharacterBasicDto {
     /**
      * Character creation date (SGT, daily data with hours and minutes set to 0)
      */
-    characterDateCreate: Date;
+    characterDateCreate: Date | null;
     /**
      * Login status in the past 7 days (true:logged in, false:not logged in)
      */

package/types/maplestory/api/msea/dto/character/characterCashItemEquipment.d.ts

@@ -11,11 +11,11 @@ export declare class CharacterCashItemEquipmentDto extends base.CharacterCashIte
     /**
      * Character gender
      */
-    characterGender: string | null;
+    characterGender: string;
     /**
      * Character job
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * Character appearance mode (0:Normal mode, 1:Beta for Zero, Dress-up mode for Angelic Buster)
      */
@@ -23,7 +23,7 @@ export declare class CharacterCashItemEquipmentDto extends base.CharacterCashIte
     /**
      * Preset number for equipped cash item
      */
-    presetNo: number | null;
+    presetNo: number;
     /**
      * Equipped cash item
      */

package/types/maplestory/api/msea/dto/character/characterDojang.d.ts

@@ -11,15 +11,15 @@ export declare class CharacterDojangDto extends base.CharacterDojangDto {
     /**
      * Character job
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * World name
      */
-    worldName: string | null;
+    worldName: string;
     /**
      * Highest floor record in Mu Lung Garden
      */
-    dojangBestFloor: number | null;
+    dojangBestFloor: number;
     /**
      * Achievement date of the highest Mu Lung Garden record (SGT, daily data with hours and minutes set to 0)
      */
@@ -27,6 +27,6 @@ export declare class CharacterDojangDto extends base.CharacterDojangDto {
     /**
      * Time taken to clear the highest floor in Mu Lung Garden (in seconds)
      */
-    dojangBestTime: number | null;
+    dojangBestTime: number;
     constructor(obj: CharacterDojangBody);
 }

package/types/maplestory/api/msea/dto/character/characterHexaMatrixStat.d.ts

@@ -11,7 +11,7 @@ export declare class CharacterHexaMatrixStatDto extends base.CharacterHexaMatrix
     /**
      * Character job
      */
-    characterClass: string | null;
+    characterClass: string;
     /**
      * Information for HEXA Stat Node I
      */