maplestory-openapi 3.4.1 → 3.5.1

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

@@ -52,6 +52,7 @@ import { AchievementDto } from './dto/user/achievement.js';
 import { CharacterListDto } from './dto/user/characterList.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';
 
 /**
@@ -137,6 +138,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 +156,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 } = basic;
         const action = imageOptions?.action ?? CharacterImageAction.Stand1;
         const emotion = imageOptions?.emotion ?? CharacterImageEmotion.Default;
         const wmotion = imageOptions?.wmotion ?? CharacterImageWeaponMotion.Default;
@@ -162,6 +170,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const height = 300;
         const x = 150;
         const y = 200;
+        const path = removeQuery(characterImage);
         const query = {
             action: `${action}.${actionFrame}`,
             emotion: `${emotion}.${emotionFrame}`,
@@ -223,6 +232,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 +264,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 +296,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 +328,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 +360,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 +392,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 +424,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 +456,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 +488,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 +520,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 +552,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 +584,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 +618,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 +650,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 +682,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 +714,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 +746,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 +778,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 +810,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 +842,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 +876,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 +908,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 +928,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 +940,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 +961,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 +973,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 +999,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
                 world_name: worldName,
             },
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new GuildDto(data);
     }
     /**
@@ -947,6 +1031,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 +1202,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

@@ -1,4 +1,5 @@
 import { CharacterBasicDto as CharacterBasicDto$1 } from '../../../common/dto/character/characterBasic.js';
+import { removeQuery } from '../../../common/lib.js';
 
 /**
  * Character basic information
@@ -73,8 +74,8 @@ class CharacterBasicDto extends CharacterBasicDto$1 {
         this.characterExp = character_exp;
         this.characterExpRate = character_exp_rate;
         this.characterGuildName = character_guild_name;
-        this.characterImage = character_image;
-        this.characterDateCreate = new Date(character_date_create);
+        this.characterImage = removeQuery(character_image);
+        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

@@ -28,6 +28,7 @@ import { UnionArtifactDto } from './dto/union/unionArtifact.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';
 
 /**
@@ -85,6 +86,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 +103,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 } = basic;
         const action = imageOptions?.action ?? CharacterImageAction.Stand1;
         const emotion = imageOptions?.emotion ?? CharacterImageEmotion.Default;
         const wmotion = imageOptions?.wmotion ?? CharacterImageWeaponMotion.Default;
@@ -109,6 +117,7 @@ class MapleStoryApi extends MapleStoryApi$1 {
         const height = 96;
         const x = imageOptions?.x ?? null;
         const y = imageOptions?.y ?? null;
+        const path = removeQuery(characterImage);
         const query = {
             action: `${action}.${actionFrame}`,
             emotion: `${emotion}.${emotionFrame}`,
@@ -173,6 +182,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 +213,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 +244,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 +275,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 +306,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 +337,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 +368,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 +399,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 +430,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 +461,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 +492,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 +523,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 +556,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 +587,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 +618,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 +649,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 +680,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 +711,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 +744,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 +775,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 +806,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 +831,9 @@ class MapleStoryApi extends MapleStoryApi$1 {
                 world_name: worldName,
             },
         });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
         return new GuildDto(data);
     }
     /**
@@ -787,6 +862,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

@@ -1,4 +1,5 @@
 import { CharacterBasicDto as CharacterBasicDto$1 } from '../../../common/dto/character/characterBasic.js';
+import { removeQuery } from '../../../common/lib.js';
 
 /**
  * 角色基本資訊
@@ -73,8 +74,8 @@ class CharacterBasicDto extends CharacterBasicDto$1 {
         this.characterExp = character_exp;
         this.characterExpRate = character_exp_rate;
         this.characterGuildName = character_guild_name;
-        this.characterImage = character_image;
-        this.characterDateCreate = new Date(character_date_create);
+        this.characterImage = removeQuery(character_image);
+        this.characterDateCreate = character_date_create ? new Date(character_date_create) : null;
         this.accessFlag = access_flag;
         this.liberationQuestClear = liberation_quest_clear;
     }