maplestory-openapi 3.4.0 → 3.5.0

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

@@ -137,6 +137,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterBasicDto(data);
     }
     /**
@@ -152,7 +155,11 @@ class MapleStoryApi extends MapleStoryApi$1 {
      * @param dateOptions 조회 기준일 (KST)
      */
     async getCharacterImage(ocid, imageOptions, dateOptions) {
-        const { date, characterImage: path } = await this.getCharacterBasic(ocid, dateOptions);
+        const basic = await this.getCharacterBasic(ocid, dateOptions);
+        if (!basic) {
+            return null;
+        }
+        const { date, characterImage: path } = basic;
         const action = imageOptions?.action ?? CharacterImageAction.Stand1;
         const emotion = imageOptions?.emotion ?? CharacterImageEmotion.Default;
         const wmotion = imageOptions?.wmotion ?? CharacterImageWeaponMotion.Default;
@@ -223,6 +230,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterPopularityDto(data);
     }
     /**
@@ -252,6 +262,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterStatDto(data);
     }
     /**
@@ -281,6 +294,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterHyperStatDto(data);
     }
     /**
@@ -310,6 +326,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterPropensityDto(data);
     }
     /**
@@ -339,6 +358,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterAbilityDto(data);
     }
     /**
@@ -368,6 +390,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterItemEquipmentDto(data);
     }
     /**
@@ -397,6 +422,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterCashItemEquipmentDto(data);
     }
     /**
@@ -426,6 +454,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterSymbolEquipmentDto(data);
     }
     /**
@@ -455,6 +486,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterSetEffectDto(data);
     }
     /**
@@ -484,6 +518,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterBeautyEquipmentDto(data);
     }
     /**
@@ -513,6 +550,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterAndroidEquipmentDto(data);
     }
     /**
@@ -542,6 +582,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterPetEquipmentDto(data);
     }
     /**
@@ -573,6 +616,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterSkillDto(data);
     }
     /**
@@ -602,6 +648,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterLinkSkillDto(data);
     }
     /**
@@ -631,6 +680,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterVMatrixDto(data);
     }
     /**
@@ -660,6 +712,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterHexaMatrixDto(data);
     }
     /**
@@ -689,6 +744,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterHexaMatrixStatDto(data);
     }
     /**
@@ -718,6 +776,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterDojangDto(data);
     }
     /**
@@ -747,6 +808,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterOtherStatDto(data);
     }
     /**
@@ -776,6 +840,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterRingExchangeSkillEquipmentDto(data);
     }
     //#endregion
@@ -807,6 +874,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new UnionDto(data);
     }
     /**
@@ -836,12 +906,15 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new UnionRaiderDto(data);
     }
     /**
      * 유니온 아티팩트 정보를 조회합니다.
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
-     * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
+     * - 2024년 1월 18일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
@@ -853,9 +926,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const path = `${this.subUrl}/v1/user/union-artifact`;
         const date = dateOptions
             ? this.toDateString(dateOptions, {
-                year: 2023,
-                month: 12,
-                day: 21,
+                year: 2024,
+                month: 1,
+                day: 18,
             })
             : undefined;
         const query = {
@@ -865,13 +938,16 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new UnionArtifactDto(data);
     }
     /**
      * 유니온 챔피언 정보를 조회합니다.<br>
      * 유니온 챔피언 정보는 2025년 2월 20일 메이플스토리 점검 이후 데이터부터 조회 가능합니다.<br>
      * - 메이플스토리 게임 데이터는 평균 15분 후 확인 가능합니다.
-     * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
+     * - 2025년 2월 20일 데이터부터 조회할 수 있습니다.
      * - 과거 데이터는 원하는 일자를 입력해 조회할 수 있으며, 전일 데이터는 다음날 오전 2시부터 확인할 수 있습니다. (12월 22일 데이터 조회 시, 22일 00시부터 23일 00시 사이 데이터가 조회 됩니다.)
      * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
      * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
@@ -883,9 +959,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const path = `${this.subUrl}/v1/user/union-champion`;
         const date = dateOptions
             ? this.toDateString(dateOptions, {
-                year: 2023,
-                month: 12,
-                day: 21,
+                year: 2025,
+                month: 2,
+                day: 20,
             })
             : undefined;
         const query = {
@@ -895,6 +971,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new UnionChampionDto(data);
     }
     //#endregion
@@ -918,6 +997,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
                 world_name: worldName,
             },
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new GuildDto(data);
     }
     /**
@@ -947,6 +1029,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new GuildBasicDto(data);
     }
     async getStarforceHistory(count, parameter) {
@@ -1115,10 +1200,10 @@ class MapleStoryApi extends MapleStoryApi$1 {
             ranking_type: 0,
         };
         if (filterOptions) {
-            const { worldName, rankingType, ocid, page } = filterOptions;
+            const { worldName, rankingType, guildName, page } = filterOptions;
             query.world_name = worldName;
             query.ranking_type = rankingType;
-            query.ocid = ocid;
+            query.guild_name = guildName;
             query.page = page;
         }
         const { data } = await this.client.get(path, {

package/dist/esm/maplestory/api/msea/dto/character/characterBasic.js

@@ -74,7 +74,7 @@ class CharacterBasicDto extends CharacterBasicDto$1 {
         this.characterExpRate = character_exp_rate;
         this.characterGuildName = character_guild_name;
         this.characterImage = character_image;
-        this.characterDateCreate = new Date(character_date_create);
+        this.characterDateCreate = character_date_create ? new Date(character_date_create) : null;
         this.accessFlag = access_flag;
         this.liberationQuestClearFlag = liberation_quest_clear_flag;
     }

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

@@ -85,6 +85,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterBasicDto(data);
     }
     /**
@@ -99,7 +102,11 @@ class MapleStoryApi extends MapleStoryApi$1 {
      * @param dateOptions Reference date for query (SGT)
      */
     async getCharacterImage(ocid, imageOptions, dateOptions) {
-        const { date, characterImage: path } = await this.getCharacterBasic(ocid, dateOptions);
+        const basic = await this.getCharacterBasic(ocid, dateOptions);
+        if (!basic) {
+            return null;
+        }
+        const { date, characterImage: path } = basic;
         const action = imageOptions?.action ?? CharacterImageAction.Stand1;
         const emotion = imageOptions?.emotion ?? CharacterImageEmotion.Default;
         const wmotion = imageOptions?.wmotion ?? CharacterImageWeaponMotion.Default;
@@ -173,6 +180,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterPopularityDto(data);
     }
     /**
@@ -201,6 +211,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterStatDto(data);
     }
     /**
@@ -229,6 +242,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterHyperStatDto(data);
     }
     /**
@@ -257,6 +273,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterPropensityDto(data);
     }
     /**
@@ -285,6 +304,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterAbilityDto(data);
     }
     /**
@@ -313,6 +335,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterItemEquipmentDto(data);
     }
     /**
@@ -341,6 +366,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterCashItemEquipmentDto(data);
     }
     /**
@@ -369,6 +397,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterSymbolEquipmentDto(data);
     }
     /**
@@ -397,6 +428,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterSetEffectDto(data);
     }
     /**
@@ -425,6 +459,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterBeautyEquipmentDto(data);
     }
     /**
@@ -453,6 +490,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterAndroidEquipmentDto(data);
     }
     /**
@@ -481,6 +521,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterPetEquipmentDto(data);
     }
     /**
@@ -511,6 +554,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterSkillDto(data);
     }
     /**
@@ -539,6 +585,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterLinkSkillDto(data);
     }
     /**
@@ -567,6 +616,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterVMatrixDto(data);
     }
     /**
@@ -595,6 +647,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterHexaMatrixDto(data);
     }
     /**
@@ -623,6 +678,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterHexaMatrixStatDto(data);
     }
     /**
@@ -651,6 +709,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new CharacterDojangDto(data);
     }
     //#endregion
@@ -681,6 +742,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new UnionDto(data);
     }
     /**
@@ -709,6 +773,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new UnionRaiderDto(data);
     }
     /**
@@ -737,6 +804,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new UnionArtifactDto(data);
     }
     //#endregion
@@ -759,6 +829,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
                 world_name: worldName,
             },
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new GuildDto(data);
     }
     /**
@@ -787,6 +860,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const { data } = await this.client.get(path, {
             params: query,
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new GuildBasicDto(data);
     }
 }

package/dist/esm/maplestory/api/tms/dto/character/characterBasic.js

@@ -74,7 +74,7 @@ class CharacterBasicDto extends CharacterBasicDto$1 {
         this.characterExpRate = character_exp_rate;
         this.characterGuildName = character_guild_name;
         this.characterImage = character_image;
-        this.characterDateCreate = new Date(character_date_create);
+        this.characterDateCreate = character_date_create ? new Date(character_date_create) : null;
         this.accessFlag = access_flag;
         this.liberationQuestClear = liberation_quest_clear;
     }