maplestory-openapi 1.1.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/README.md +20 -15
  2. package/dist/index.js +4283 -71
  3. package/dist/index.min.js +1 -1
  4. package/dist/index.mjs +4211 -72
  5. package/package.json +4 -3
  6. package/types/index.d.ts +75 -0
  7. package/types/maplestory/api/dto/achievementRankingDto.d.ts +40 -0
  8. package/types/maplestory/api/dto/achievementRankingResponseDto.d.ts +13 -0
  9. package/types/maplestory/api/dto/characterAbilityDto.d.ts +25 -0
  10. package/types/maplestory/api/dto/characterAbilityInfoDto.d.ts +11 -0
  11. package/types/maplestory/api/dto/characterAndroidCashItemEquipmentColoringPrismDto.d.ts +24 -0
  12. package/types/maplestory/api/dto/characterAndroidCashItemEquipmentDto.d.ts +50 -0
  13. package/types/maplestory/api/dto/characterAndroidCashItemEquipmentOptionDto.d.ts +16 -0
  14. package/types/maplestory/api/dto/characterAndroidEquipmentDto.d.ts +51 -0
  15. package/types/maplestory/api/dto/characterAndroidEquipmentFaceDto.d.ts +24 -0
  16. package/types/maplestory/api/dto/characterAndroidEquipmentHairDto.d.ts +24 -0
  17. package/types/maplestory/api/dto/characterBasicDto.d.ts +49 -0
  18. package/types/maplestory/api/dto/characterBeautyEquipmentDto.d.ts +49 -0
  19. package/types/maplestory/api/dto/characterBeautyEquipmentFaceDto.d.ts +24 -0
  20. package/types/maplestory/api/dto/characterBeautyEquipmentHairDto.d.ts +24 -0
  21. package/types/maplestory/api/dto/characterCashItemEquipmentColoringPrismDto.d.ts +24 -0
  22. package/types/maplestory/api/dto/characterCashItemEquipmentDto.d.ts +49 -0
  23. package/types/maplestory/api/dto/characterCashItemEquipmentOptionDto.d.ts +16 -0
  24. package/types/maplestory/api/dto/characterCashItemEquipmentPresetDto.d.ts +54 -0
  25. package/types/maplestory/api/dto/characterDojangDto.d.ts +32 -0
  26. package/types/maplestory/api/dto/characterDto.d.ts +12 -0
  27. package/types/maplestory/api/dto/characterHexaMatrixDto.d.ts +17 -0
  28. package/types/maplestory/api/dto/characterHexaMatrixEquipmentDto.d.ts +25 -0
  29. package/types/maplestory/api/dto/characterHexaMatrixEquipmentLinkedSkillDto.d.ts +12 -0
  30. package/types/maplestory/api/dto/characterHexaMatrixStatCoreDto.d.ts +40 -0
  31. package/types/maplestory/api/dto/characterHexaMatrixStatDto.d.ts +25 -0
  32. package/types/maplestory/api/dto/characterHyperStatDto.d.ts +49 -0
  33. package/types/maplestory/api/dto/characterHyperStatInfoDto.d.ts +24 -0
  34. package/types/maplestory/api/dto/characterItemEquipmentAddOptionDto.d.ts +68 -0
  35. package/types/maplestory/api/dto/characterItemEquipmentBaseOptionDto.d.ts +76 -0
  36. package/types/maplestory/api/dto/characterItemEquipmentDto.d.ts +38 -0
  37. package/types/maplestory/api/dto/characterItemEquipmentEtcOptionDto.d.ts +52 -0
  38. package/types/maplestory/api/dto/characterItemEquipmentExceptionalOptionDto.d.ts +40 -0
  39. package/types/maplestory/api/dto/characterItemEquipmentInfoDto.d.ts +155 -0
  40. package/types/maplestory/api/dto/characterItemEquipmentStarforceOptionDto.d.ts +52 -0
  41. package/types/maplestory/api/dto/characterItemEquipmentTitleDto.d.ts +28 -0
  42. package/types/maplestory/api/dto/characterItemEquipmentTotalOptionDto.d.ts +80 -0
  43. package/types/maplestory/api/dto/characterLinkSkillDto.d.ts +25 -0
  44. package/types/maplestory/api/dto/characterLinkSkillInfoDto.d.ts +28 -0
  45. package/types/maplestory/api/dto/characterPetEquipmentAutoSkillDto.d.ts +24 -0
  46. package/types/maplestory/api/dto/characterPetEquipmentDto.d.ts +116 -0
  47. package/types/maplestory/api/dto/characterPetEquipmentItemDto.d.ts +33 -0
  48. package/types/maplestory/api/dto/characterPetEquipmentItemOptionDto.d.ts +16 -0
  49. package/types/maplestory/api/dto/characterPopularityDto.d.ts +16 -0
  50. package/types/maplestory/api/dto/characterPropensityDto.d.ts +33 -0
  51. package/types/maplestory/api/dto/characterSetEffectDto.d.ts +17 -0
  52. package/types/maplestory/api/dto/characterSetEffectInfoDto.d.ts +21 -0
  53. package/types/maplestory/api/dto/characterSetEffectOptionInfoDto.d.ts +16 -0
  54. package/types/maplestory/api/dto/characterSkillDto.d.ts +25 -0
  55. package/types/maplestory/api/dto/characterSkillInfoDto.d.ts +28 -0
  56. package/types/maplestory/api/dto/characterStatDto.d.ts +27 -0
  57. package/types/maplestory/api/dto/characterSymbolEquipmentDto.d.ts +21 -0
  58. package/types/maplestory/api/dto/characterSymbolEquipmentInfoDto.d.ts +56 -0
  59. package/types/maplestory/api/dto/characterVMatrixCoreEquipmentDto.d.ts +40 -0
  60. package/types/maplestory/api/dto/characterVMatrixDto.d.ts +25 -0
  61. package/types/maplestory/api/dto/cubeHistoryDto.d.ts +18 -18
  62. package/types/maplestory/api/dto/cubeHistoryResponseDto.d.ts +2 -2
  63. package/types/maplestory/api/dto/cubeResultOptionDto.d.ts +1 -1
  64. package/types/maplestory/api/dto/dojangRankingDto.d.ts +44 -0
  65. package/types/maplestory/api/dto/dojangRankingResponseDto.d.ts +13 -0
  66. package/types/maplestory/api/dto/guildBasicDto.d.ts +61 -0
  67. package/types/maplestory/api/dto/guildDto.d.ts +12 -0
  68. package/types/maplestory/api/dto/guildRankingDto.d.ts +40 -0
  69. package/types/maplestory/api/dto/guildRankingResponseDto.d.ts +13 -0
  70. package/types/maplestory/api/dto/guildSkillDto.d.ts +28 -0
  71. package/types/maplestory/api/dto/overallRankingDto.d.ts +48 -0
  72. package/types/maplestory/api/dto/overallRankingResponseDto.d.ts +13 -0
  73. package/types/maplestory/api/dto/theSeedRankingDto.d.ts +44 -0
  74. package/types/maplestory/api/dto/theSeedRankingResponseDto.d.ts +13 -0
  75. package/types/maplestory/api/dto/unionDto.d.ts +20 -0
  76. package/types/maplestory/api/dto/unionRaiderBlockDto.d.ts +30 -0
  77. package/types/maplestory/api/dto/unionRaiderBlockPositionDto.d.ts +16 -0
  78. package/types/maplestory/api/dto/unionRaiderControlPointDto.d.ts +16 -0
  79. package/types/maplestory/api/dto/unionRaiderDto.d.ts +27 -0
  80. package/types/maplestory/api/dto/unionRaiderInnerStatDto.d.ts +16 -0
  81. package/types/maplestory/api/dto/unionRankingDto.d.ts +40 -0
  82. package/types/maplestory/api/dto/unionRankingResponseDto.d.ts +13 -0
  83. package/types/maplestory/api/mapleStoryApi.d.ts +760 -19
  84. package/types/maplestory/api/mapleStoryApiError.d.ts +18 -7
  85. package/types/maplestory/api/response/achievementRankingResponseDtoBody.d.ts +13 -0
  86. package/types/maplestory/api/response/characterAbilityDtoBody.d.ts +12 -0
  87. package/types/maplestory/api/response/characterAndroidEquipmentDtoBody.d.ts +47 -0
  88. package/types/maplestory/api/response/characterBasicDtoBody.d.ts +14 -0
  89. package/types/maplestory/api/response/characterBeautyEquipmentDtoBody.d.ts +24 -0
  90. package/types/maplestory/api/response/characterCashItemEquipmentDtoBody.d.ts +36 -0
  91. package/types/maplestory/api/response/characterDojangDtoBody.d.ts +9 -0
  92. package/types/maplestory/api/response/characterDtoBody.d.ts +4 -0
  93. package/types/maplestory/api/response/characterHexaMatrixDtoBody.d.ts +14 -0
  94. package/types/maplestory/api/response/characterHexaMatrixStatDtoBody.d.ts +17 -0
  95. package/types/maplestory/api/response/characterHyperStatDtoBody.d.ts +19 -0
  96. package/types/maplestory/api/response/characterItemEquipmentDtoBody.d.ts +155 -0
  97. package/types/maplestory/api/response/characterLinkSkillDtoBody.d.ts +14 -0
  98. package/types/maplestory/api/response/characterPetEquipmentDtoBody.d.ts +49 -0
  99. package/types/maplestory/api/response/characterPopularityDtoBody.d.ts +5 -0
  100. package/types/maplestory/api/response/characterPropensityDtoBody.d.ts +10 -0
  101. package/types/maplestory/api/response/characterSetEffectDtoBody.d.ts +14 -0
  102. package/types/maplestory/api/response/characterSkillDtoBody.d.ts +14 -0
  103. package/types/maplestory/api/response/characterStatDtoBody.d.ts +10 -0
  104. package/types/maplestory/api/response/characterSymbolEquipmentDtoBody.d.ts +20 -0
  105. package/types/maplestory/api/response/characterVMatrixDtoBody.d.ts +17 -0
  106. package/types/maplestory/api/response/cubeHistoryDtoBody.d.ts +8 -8
  107. package/types/maplestory/api/response/cubeHistoryResponseDtoBody.d.ts +1 -1
  108. package/types/maplestory/api/response/dojangRankingResponseDtoBody.d.ts +14 -0
  109. package/types/maplestory/api/response/guildBasicDtoBody.d.ts +23 -0
  110. package/types/maplestory/api/response/guildDtoBody.d.ts +4 -0
  111. package/types/maplestory/api/response/guildRankingResponseDtoBody.d.ts +13 -0
  112. package/types/maplestory/api/response/overallRankingResponseDtoBody.d.ts +15 -0
  113. package/types/maplestory/api/response/rankingResponseDtoBody.d.ts +7 -0
  114. package/types/maplestory/api/response/theSeedRankingResponseDtoBody.d.ts +15 -0
  115. package/types/maplestory/api/response/unionDtoBody.d.ts +6 -0
  116. package/types/maplestory/api/response/unionRaiderDtoBody.d.ts +27 -0
  117. package/types/maplestory/api/response/unionRankingResponseDtoBody.d.ts +13 -0
package/dist/index.mjs CHANGED
@@ -33,7 +33,7 @@ const potentialOptionGradeFromString = (text) => {
33
33
  */
34
34
  class CubeResultOptionDto {
35
35
  /**
36
- * 옵션 이름
36
+ * 옵션
37
37
  */
38
38
  value;
39
39
  /**
@@ -51,31 +51,31 @@ class CubeResultOptionDto {
51
51
  }
52
52
 
53
53
  /**
54
- * 큐브히스토리 정보
54
+ * 큐브 히스토리
55
55
  */
56
56
  class CubeHistoryDto {
57
57
  /**
58
- * 큐브 사용 내역에 대한 고유 식별자
58
+ * 큐브 히스토리 식별자
59
59
  */
60
60
  id;
61
61
  /**
62
- * 캐릭터이름
62
+ * 캐릭터 명
63
63
  */
64
64
  characterName;
65
65
  /**
66
- * 월드 이름
66
+ * 월드
67
67
  */
68
68
  worldName;
69
69
  /**
70
- * 큐브 사용 날짜
70
+ * 사용 일시
71
71
  */
72
- createDate;
72
+ dateCreate;
73
73
  /**
74
- * 사용한 큐브
74
+ * 사용 큐브
75
75
  */
76
76
  cubeType;
77
77
  /**
78
- * 큐브 사용 결과
78
+ * 사용 결과
79
79
  */
80
80
  itemUpgradeResult;
81
81
  /**
@@ -85,13 +85,13 @@ class CubeHistoryDto {
85
85
  /**
86
86
  * 장비 분류
87
87
  */
88
- itemEquipPart;
88
+ itemEquipmentPart;
89
89
  /**
90
90
  * 장비 레벨
91
91
  */
92
92
  itemLevel;
93
93
  /**
94
- * 큐브를 사용한 장비
94
+ * 큐브 사용한 장비
95
95
  */
96
96
  targetItem;
97
97
  /**
@@ -111,41 +111,41 @@ class CubeHistoryDto {
111
111
  */
112
112
  upgradeGuaranteeCount;
113
113
  /**
114
- * 큐브 사용 전 잠재능력 옵션
114
+ * 사용 전 잠재능력 옵션
115
115
  */
116
- beforePotentialOptions;
116
+ beforePotentialOption;
117
117
  /**
118
- * 큐브 사용 전 에디셔널 잠재능력 옵션
118
+ * 사용 전 에디셔널 잠재능력 옵션
119
119
  */
120
- beforeAdditionalPotentialOptions;
120
+ beforeAdditionalPotentialOption;
121
121
  /**
122
- * 큐브 사용 후 잠재능력 옵션
122
+ * 사용 후 잠재능력 옵션
123
123
  */
124
- afterPotentialOptions;
124
+ afterPotentialOption;
125
125
  /**
126
- * 큐브 사용 후 에디셔널 잠재능력 옵션
126
+ * 사용 후 에디셔널 잠재능력 옵션
127
127
  */
128
- afterAdditionalPotentialOptions;
128
+ afterAdditionalPotentialOption;
129
129
  constructor(obj) {
130
- const { id, character_name, world_name, create_date, cube_type, item_upgrade_result, miracle_time_flag, item_equip_part, item_level, target_item, potential_option_grade, additional_potential_option_grade, upgradeguarantee, upgradeguaranteecount, before_potential_options, before_additional_potential_options, after_potential_options, after_additional_potential_options } = obj;
130
+ const { id, character_name, world_name, date_create, cube_type, item_upgrade_result, miracle_time_flag, item_equipment_part, item_level, target_item, potential_option_grade, additional_potential_option_grade, upgrade_guarantee, upgrade_guarantee_count, before_potential_option, before_additional_potential_option, after_potential_option, after_additional_potential_option } = obj;
131
131
  this.id = id;
132
132
  this.characterName = character_name;
133
133
  this.worldName = world_name;
134
- this.createDate = create_date;
134
+ this.dateCreate = new Date(date_create);
135
135
  this.cubeType = cube_type;
136
136
  this.itemUpgradeResult = item_upgrade_result;
137
137
  this.miracleTimeFlag = miracle_time_flag;
138
- this.itemEquipPart = item_equip_part;
138
+ this.itemEquipmentPart = item_equipment_part;
139
139
  this.itemLevel = item_level;
140
140
  this.targetItem = target_item;
141
141
  this.potentialOptionGrade = potential_option_grade;
142
142
  this.additionalPotentialOptionGrade = additional_potential_option_grade;
143
- this.upgradeGuarantee = upgradeguarantee;
144
- this.upgradeGuaranteeCount = upgradeguaranteecount;
145
- this.beforePotentialOptions = before_potential_options.map(origin => new CubeResultOptionDto(origin));
146
- this.beforeAdditionalPotentialOptions = before_additional_potential_options.map(origin => new CubeResultOptionDto(origin));
147
- this.afterPotentialOptions = after_potential_options.map(origin => new CubeResultOptionDto(origin));
148
- this.afterAdditionalPotentialOptions = after_additional_potential_options.map(origin => new CubeResultOptionDto(origin));
143
+ this.upgradeGuarantee = upgrade_guarantee;
144
+ this.upgradeGuaranteeCount = upgrade_guarantee_count;
145
+ this.beforePotentialOption = before_potential_option.map(origin => new CubeResultOptionDto(origin));
146
+ this.beforeAdditionalPotentialOption = before_additional_potential_option.map(origin => new CubeResultOptionDto(origin));
147
+ this.afterPotentialOption = after_potential_option.map(origin => new CubeResultOptionDto(origin));
148
+ this.afterAdditionalPotentialOption = after_additional_potential_option.map(origin => new CubeResultOptionDto(origin));
149
149
  }
150
150
  get isItemUpgrade() {
151
151
  return this.itemUpgradeResult === '성공';
@@ -162,7 +162,7 @@ class CubeHistoryDto {
162
162
  }
163
163
 
164
164
  /**
165
- * 큐브히스토리 응답 정보
165
+ * 큐브 히스토리 응답 정보
166
166
  */
167
167
  class CubeHistoryResponseDto {
168
168
  /**
@@ -172,15 +172,15 @@ class CubeHistoryResponseDto {
172
172
  /**
173
173
  * 큐브 히스토리
174
174
  */
175
- cubeHistories;
175
+ cubeHistory;
176
176
  /**
177
177
  * 페이징 처리를 위한 cursor
178
178
  */
179
179
  nextCursor;
180
180
  constructor(obj) {
181
- const { count, cube_histories, next_cursor } = obj;
181
+ const { count, cube_history, next_cursor } = obj;
182
182
  this.count = count;
183
- this.cubeHistories = cube_histories.map(origin => new CubeHistoryDto(origin));
183
+ this.cubeHistory = cube_history.map(origin => new CubeHistoryDto(origin));
184
184
  this.nextCursor = next_cursor;
185
185
  }
186
186
  }
@@ -216,50 +216,3920 @@ class InspectionInfoDto {
216
216
 
217
217
  /**
218
218
  * MapleStory OpenAPI error.<br>
219
- * Please refer to <a href="https://developers.nexon.com/Maplestory/guides">MapleStory API guide</a> for the error details.
219
+ * Please refer to <a href="https://openapi.nexon.com/guide/request-api/">MapleStory API guide</a> for the error details.
220
220
  */
221
221
  class MapleStoryApiError extends Error {
222
222
  name = 'MapleStoryApiError';
223
- status;
223
+ errorCode;
224
224
  message;
225
- constructor(params) {
226
- const { status, message } = params;
225
+ constructor(errorBody) {
226
+ const { name, message } = errorBody.error;
227
227
  super(message);
228
- this.status = status;
228
+ this.errorCode = errorMap[name];
229
229
  this.message = message;
230
230
  }
231
231
  }
232
+ /**
233
+ * MapleStory OpenAPI error codes.<br>
234
+ * Please refer to <a href="https://openapi.nexon.com/guide/request-api/">MapleStory API guide</a> for the error code details.
235
+ */
236
+ var MapleStoryApiErrorCode;
237
+ (function (MapleStoryApiErrorCode) {
238
+ MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00001"] = 0] = "OPENAPI00001";
239
+ MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00002"] = 1] = "OPENAPI00002";
240
+ MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00003"] = 2] = "OPENAPI00003";
241
+ MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00004"] = 3] = "OPENAPI00004";
242
+ MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00005"] = 4] = "OPENAPI00005";
243
+ MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00006"] = 5] = "OPENAPI00006";
244
+ MapleStoryApiErrorCode[MapleStoryApiErrorCode["OPENAPI00007"] = 6] = "OPENAPI00007";
245
+ })(MapleStoryApiErrorCode || (MapleStoryApiErrorCode = {}));
246
+ const errorMap = {
247
+ ['OPENAPI00001']: MapleStoryApiErrorCode.OPENAPI00001,
248
+ ['OPENAPI00002']: MapleStoryApiErrorCode.OPENAPI00002,
249
+ ['OPENAPI00003']: MapleStoryApiErrorCode.OPENAPI00003,
250
+ ['OPENAPI00004']: MapleStoryApiErrorCode.OPENAPI00004,
251
+ ['OPENAPI00005']: MapleStoryApiErrorCode.OPENAPI00005,
252
+ ['OPENAPI00006']: MapleStoryApiErrorCode.OPENAPI00006,
253
+ ['OPENAPI00007']: MapleStoryApiErrorCode.OPENAPI00007,
254
+ };
232
255
 
233
- var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
256
+ /**
257
+ * 캐릭터 식별 정보
258
+ */
259
+ class CharacterDto {
260
+ /**
261
+ * 캐릭터 식별자
262
+ */
263
+ ocid;
264
+ constructor(obj) {
265
+ const { ocid } = obj;
266
+ this.ocid = ocid;
267
+ }
268
+ }
234
269
 
235
- var timezone$1 = {exports: {}};
270
+ /**
271
+ * 캐릭터 기본 정보
272
+ */
273
+ class CharacterBasicDto {
274
+ date;
275
+ /**
276
+ * 캐릭터 명
277
+ */
278
+ characterName;
279
+ /**
280
+ * 월드 명
281
+ */
282
+ worldName;
283
+ /**
284
+ * 캐릭터 성별
285
+ */
286
+ characterGender;
287
+ /**
288
+ * 캐릭터 직업
289
+ */
290
+ characterClass;
291
+ /**
292
+ * 캐릭터 전직 차수
293
+ */
294
+ characterClassLevel;
295
+ /**
296
+ * 캐릭터 레벨
297
+ */
298
+ characterLevel;
299
+ /**
300
+ * 현재 레벨에서 보유한 경험치
301
+ */
302
+ characterExp;
303
+ /**
304
+ * 현재 레벨에서 경험치 퍼센트
305
+ */
306
+ characterExpRate;
307
+ /**
308
+ * 캐릭터 소속 길드 명
309
+ */
310
+ characterGuildName;
311
+ /**
312
+ * 캐릭터 외형 이미지
313
+ */
314
+ characterImage;
315
+ constructor(obj) {
316
+ const { date, character_name, world_name, character_gender, character_class, character_class_level, character_level, character_exp, character_exp_rate, character_guild_name, character_image, } = obj;
317
+ this.date = new Date(date);
318
+ this.characterName = character_name;
319
+ this.worldName = world_name;
320
+ this.characterGender = character_gender;
321
+ this.characterClass = character_class;
322
+ this.characterClassLevel = character_class_level;
323
+ this.characterLevel = character_level;
324
+ this.characterExp = character_exp;
325
+ this.characterExpRate = character_exp_rate;
326
+ this.characterGuildName = character_guild_name;
327
+ this.characterImage = character_image;
328
+ }
329
+ }
236
330
 
237
- (function (module, exports) {
238
- !function(t,e){module.exports=e();}(commonjsGlobal,(function(){var t={year:0,month:1,day:2,hour:3,minute:4,second:5},e={};return function(n,i,o){var r,a=function(t,n,i){void 0===i&&(i={});var o=new Date(t),r=function(t,n){void 0===n&&(n={});var i=n.timeZoneName||"short",o=t+"|"+i,r=e[o];return r||(r=new Intl.DateTimeFormat("en-US",{hour12:!1,timeZone:t,year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",timeZoneName:i}),e[o]=r),r}(n,i);return r.formatToParts(o)},u=function(e,n){for(var i=a(e,n),r=[],u=0;u<i.length;u+=1){var f=i[u],s=f.type,m=f.value,c=t[s];c>=0&&(r[c]=parseInt(m,10));}var d=r[3],l=24===d?0:d,h=r[0]+"-"+r[1]+"-"+r[2]+" "+l+":"+r[4]+":"+r[5]+":000",v=+e;return (o.utc(h).valueOf()-(v-=v%1e3))/6e4},f=i.prototype;f.tz=function(t,e){void 0===t&&(t=r);var n=this.utcOffset(),i=this.toDate(),a=i.toLocaleString("en-US",{timeZone:t}),u=Math.round((i-new Date(a))/1e3/60),f=o(a,{locale:this.$L}).$set("millisecond",this.$ms).utcOffset(15*-Math.round(i.getTimezoneOffset()/15)-u,!0);if(e){var s=f.utcOffset();f=f.add(n-s,"minute");}return f.$x.$timezone=t,f},f.offsetName=function(t){var e=this.$x.$timezone||o.tz.guess(),n=a(this.valueOf(),e,{timeZoneName:t}).find((function(t){return "timezonename"===t.type.toLowerCase()}));return n&&n.value};var s=f.startOf;f.startOf=function(t,e){if(!this.$x||!this.$x.$timezone)return s.call(this,t,e);var n=o(this.format("YYYY-MM-DD HH:mm:ss:SSS"),{locale:this.$L});return s.call(n,t,e).tz(this.$x.$timezone,!0)},o.tz=function(t,e,n){var i=n&&e,a=n||e||r,f=u(+o(),a);if("string"!=typeof t)return o(t).tz(a);var s=function(t,e,n){var i=t-60*e*1e3,o=u(i,n);if(e===o)return [i,e];var r=u(i-=60*(o-e)*1e3,n);return o===r?[i,o]:[t-60*Math.min(o,r)*1e3,Math.max(o,r)]}(o.utc(t,i).valueOf(),f,a),m=s[0],c=s[1],d=o(m).utcOffset(c);return d.$x.$timezone=a,d},o.tz.guess=function(){return Intl.DateTimeFormat().resolvedOptions().timeZone},o.tz.setDefault=function(t){r=t;};}}));
239
- }(timezone$1));
331
+ /**
332
+ * 캐릭터 인기도 정보
333
+ */
334
+ class CharacterPopularityDto {
335
+ /**
336
+ * 조회 기준일
337
+ */
338
+ date;
339
+ /**
340
+ * 캐릭터 인기도
341
+ */
342
+ popularity;
343
+ constructor(obj) {
344
+ const { date, popularity } = obj;
345
+ this.date = new Date(date);
346
+ this.popularity = popularity;
347
+ }
348
+ }
240
349
 
241
- var timezone = timezone$1.exports;
350
+ /**
351
+ * 캐릭터 스탯 정보
352
+ */
353
+ class CharacterStatDto {
354
+ /**
355
+ * 조회 기준일
356
+ */
357
+ date;
358
+ /**
359
+ * 캐릭터 직업
360
+ */
361
+ characterClass;
362
+ /**
363
+ * 현재 스탯 정보
364
+ */
365
+ finalStat;
366
+ /**
367
+ * 잔여 AP
368
+ */
369
+ remainAP;
370
+ constructor(obj) {
371
+ const { date, character_class, final_stat, remain_ap } = obj;
372
+ this.date = new Date(date);
373
+ this.characterClass = character_class;
374
+ this.finalStat = final_stat.map(stat => {
375
+ return {
376
+ statName: stat.stat_name,
377
+ statValue: stat.stat_value
378
+ };
379
+ });
380
+ this.remainAP = remain_ap;
381
+ }
382
+ }
242
383
 
243
- var utc$1 = {exports: {}};
384
+ /**
385
+ * 캐릭터 하이퍼 스탯 상세 정보
386
+ */
387
+ class CharacterHyperStatInfoDto {
388
+ /**
389
+ * 스탯 종류
390
+ */
391
+ statType;
392
+ /**
393
+ * 스탯 투자 포인트
394
+ */
395
+ statPoint;
396
+ /**
397
+ * 스탯 레벨
398
+ */
399
+ statLevel;
400
+ /**
401
+ * 스탯 상승량
402
+ */
403
+ statIncrease;
404
+ constructor(obj) {
405
+ const { stat_type, stat_point, stat_level, stat_increase, } = obj;
406
+ this.statType = stat_type;
407
+ this.statPoint = stat_point;
408
+ this.statLevel = stat_level;
409
+ this.statIncrease = stat_increase;
410
+ }
411
+ }
244
412
 
245
- (function (module, exports) {
246
- !function(t,i){module.exports=i();}(commonjsGlobal,(function(){var t="minute",i=/[+-]\d\d(?::?\d\d)?/g,e=/([+-]|\d\d)/g;return function(s,f,n){var u=f.prototype;n.utc=function(t){var i={date:t,utc:!0,args:arguments};return new f(i)},u.utc=function(i){var e=n(this.toDate(),{locale:this.$L,utc:!0});return i?e.add(this.utcOffset(),t):e},u.local=function(){return n(this.toDate(),{locale:this.$L,utc:!1})};var o=u.parse;u.parse=function(t){t.utc&&(this.$u=!0),this.$utils().u(t.$offset)||(this.$offset=t.$offset),o.call(this,t);};var r=u.init;u.init=function(){if(this.$u){var t=this.$d;this.$y=t.getUTCFullYear(),this.$M=t.getUTCMonth(),this.$D=t.getUTCDate(),this.$W=t.getUTCDay(),this.$H=t.getUTCHours(),this.$m=t.getUTCMinutes(),this.$s=t.getUTCSeconds(),this.$ms=t.getUTCMilliseconds();}else r.call(this);};var a=u.utcOffset;u.utcOffset=function(s,f){var n=this.$utils().u;if(n(s))return this.$u?0:n(this.$offset)?a.call(this):this.$offset;if("string"==typeof s&&(s=function(t){void 0===t&&(t="");var s=t.match(i);if(!s)return null;var f=(""+s[0]).match(e)||["-",0,0],n=f[0],u=60*+f[1]+ +f[2];return 0===u?0:"+"===n?u:-u}(s),null===s))return this;var u=Math.abs(s)<=16?60*s:s,o=this;if(f)return o.$offset=u,o.$u=0===s,o;if(0!==s){var r=this.$u?this.toDate().getTimezoneOffset():-1*this.utcOffset();(o=this.local().add(u+r,t)).$offset=u,o.$x.$localOffset=r;}else o=this.utc();return o};var h=u.format;u.format=function(t){var i=t||(this.$u?"YYYY-MM-DDTHH:mm:ss[Z]":"");return h.call(this,i)},u.valueOf=function(){var t=this.$utils().u(this.$offset)?0:this.$offset+(this.$x.$localOffset||this.$d.getTimezoneOffset());return this.$d.valueOf()-6e4*t},u.isUTC=function(){return !!this.$u},u.toISOString=function(){return this.toDate().toISOString()},u.toString=function(){return this.toDate().toUTCString()};var l=u.toDate;u.toDate=function(t){return "s"===t&&this.$offset?n(this.format("YYYY-MM-DD HH:mm:ss:SSS")).toDate():l.call(this)};var c=u.diff;u.diff=function(t,i,e){if(t&&this.$u===t.$u)return c.call(this,t,i,e);var s=this.local(),f=n(t).local();return c.call(s,f,i,e)};}}));
247
- }(utc$1));
413
+ /**
414
+ * 캐릭터 하이퍼 스탯 정보
415
+ */
416
+ class CharacterHyperStatDto {
417
+ /**
418
+ * 조회 기준일
419
+ */
420
+ date;
421
+ /**
422
+ * 캐릭터 직업
423
+ */
424
+ characterClass;
425
+ /**
426
+ * 적용 중인 프리셋 번호
427
+ */
428
+ usePresetNo;
429
+ /**
430
+ * 사용 가능한 최대 하이퍼스탯 포인트
431
+ */
432
+ useAvailableHyperStat;
433
+ /**
434
+ * 프리셋 1번 하이퍼 스탯 정보
435
+ */
436
+ hyperStatPreset1;
437
+ /**
438
+ * 프리셋 1번 하이퍼 스탯 잔여 포인트
439
+ */
440
+ hyperStatPreset1RemainPoint;
441
+ /**
442
+ * 프리셋 2번 하이퍼 스탯 정보
443
+ */
444
+ hyperStatPreset2;
445
+ /**
446
+ * 프리셋 2번 하이퍼 스탯 잔여 포인트
447
+ */
448
+ hyperStatPreset2RemainPoint;
449
+ /**
450
+ * 프리셋 3번 하이퍼 스탯 정보
451
+ */
452
+ hyperStatPreset3;
453
+ /**
454
+ * 프리셋 3번 하이퍼 스탯 잔여 포인트
455
+ */
456
+ hyperStatPreset3RemainPoint;
457
+ constructor(obj) {
458
+ const { date, character_class, use_preset_no, use_available_hyper_stat, hyper_stat_preset_1, hyper_stat_preset_1_remain_point, hyper_stat_preset_2, hyper_stat_preset_2_remain_point, hyper_stat_preset_3, hyper_stat_preset_3_remain_point, } = obj;
459
+ this.date = new Date(date);
460
+ this.characterClass = character_class;
461
+ this.usePresetNo = use_preset_no;
462
+ this.useAvailableHyperStat = use_available_hyper_stat;
463
+ this.hyperStatPreset1 = hyper_stat_preset_1.map(preset => new CharacterHyperStatInfoDto(preset));
464
+ this.hyperStatPreset1RemainPoint = hyper_stat_preset_1_remain_point;
465
+ this.hyperStatPreset2 = hyper_stat_preset_2.map(preset => new CharacterHyperStatInfoDto(preset));
466
+ this.hyperStatPreset2RemainPoint = hyper_stat_preset_2_remain_point;
467
+ this.hyperStatPreset3 = hyper_stat_preset_3.map(preset => new CharacterHyperStatInfoDto(preset));
468
+ this.hyperStatPreset3RemainPoint = hyper_stat_preset_3_remain_point;
469
+ }
470
+ }
248
471
 
249
- var utc = utc$1.exports;
472
+ /**
473
+ * 캐릭터 성향 정보
474
+ */
475
+ class CharacterPropensityDto {
476
+ date;
477
+ /**
478
+ * 카리스마 레벨
479
+ */
480
+ charismaLevel;
481
+ /**
482
+ * 감성 레벨
483
+ */
484
+ sensibilityLevel;
485
+ /**
486
+ * 통찰력 레벨
487
+ */
488
+ insightLevel;
489
+ /**
490
+ * 의지 레벨
491
+ */
492
+ willingnessLevel;
493
+ /**
494
+ * 손재주 레벨
495
+ */
496
+ handicraftLevel;
497
+ /**
498
+ * 매력 레벨
499
+ */
500
+ charmLevel;
501
+ constructor(obj) {
502
+ const { date, charisma_level, sensibility_level, insight_level, willingness_level, handicraft_level, charm_level, } = obj;
503
+ this.date = new Date(date);
504
+ this.charismaLevel = charisma_level;
505
+ this.sensibilityLevel = sensibility_level;
506
+ this.insightLevel = insight_level;
507
+ this.willingnessLevel = willingness_level;
508
+ this.handicraftLevel = handicraft_level;
509
+ this.charmLevel = charm_level;
510
+ }
511
+ }
250
512
 
251
- dayjs.extend(timezone);
252
- dayjs.extend(utc);
253
- class MapleStoryApi {
254
- apiKey;
255
- static baseUrl = 'https://public.api.nexon.com/';
256
- static kstOffset = 540;
257
- timeout;
258
- constructor(apiKey) {
259
- this.apiKey = apiKey;
260
- this.timeout = 5000;
513
+ /**
514
+ * 캐릭터 어빌리티 상세 정보
515
+ */
516
+ class CharacterAbilityInfoDto {
517
+ abilityNo;
518
+ abilityGrade;
519
+ abilityValue;
520
+ constructor(obj) {
521
+ const { ability_no, ability_grade, ability_value, } = obj;
522
+ this.abilityNo = ability_no;
523
+ this.abilityGrade = ability_grade;
524
+ this.abilityValue = ability_value;
525
+ }
526
+ }
527
+
528
+ /**
529
+ * 캐릭터 어빌리티 정보
530
+ */
531
+ class CharacterAbilityDto {
532
+ /**
533
+ * 조회 기준일
534
+ */
535
+ date;
536
+ /**
537
+ * 어빌리티 등급
538
+ */
539
+ abilityGrade;
540
+ /**
541
+ * 어빌리티 정보
542
+ */
543
+ abilityInfo;
544
+ /**
545
+ * 보유 명성치
546
+ */
547
+ remainFame;
548
+ constructor(obj) {
549
+ const { date, ability_grade, ability_info, remain_fame, } = obj;
550
+ // 날짜는 Date 객체로 변환
551
+ this.date = new Date(date);
552
+ this.abilityGrade = ability_grade;
553
+ this.abilityInfo = ability_info.map(info => new CharacterAbilityInfoDto(info));
554
+ this.remainFame = remain_fame;
555
+ }
556
+ }
557
+
558
+ /**
559
+ * 캐릭터 칭호 아이템 정보
560
+ */
561
+ class CharacterItemEquipmentTitleDto {
562
+ /**
563
+ * 칭호 장비 명
564
+ */
565
+ titleName;
566
+ /**
567
+ * 칭호 아이콘
568
+ */
569
+ titleIcon;
570
+ /**
571
+ * 칭호 설명
572
+ */
573
+ titleDescription;
574
+ /**
575
+ * 칭호 유효 기간
576
+ */
577
+ dateExpire;
578
+ /**
579
+ * 칭호 옵션 유효 기간
580
+ */
581
+ dateOptionExpire;
582
+ constructor(obj) {
583
+ const { title_name, title_icon, title_description, date_expire, date_option_expire, } = obj;
584
+ this.titleName = title_name;
585
+ this.titleIcon = title_icon;
586
+ this.titleDescription = title_description;
587
+ this.dateExpire = new Date(date_expire);
588
+ this.dateOptionExpire = date_option_expire ? new Date(date_option_expire) : undefined;
589
+ }
590
+ }
591
+
592
+ /**
593
+ * 캐릭터 장비 특별 옵션 정보
594
+ */
595
+ class CharacterItemEquipmentExceptionalOptionDto {
596
+ /**
597
+ * STR
598
+ */
599
+ str;
600
+ /**
601
+ * DEX
602
+ */
603
+ dex;
604
+ /**
605
+ * INT
606
+ */
607
+ int;
608
+ /**
609
+ * LUK
610
+ */
611
+ luk;
612
+ /**
613
+ * 최대 HP
614
+ */
615
+ maxHp;
616
+ /**
617
+ * 최대 MP
618
+ */
619
+ maxMp;
620
+ /**
621
+ * 공격력
622
+ */
623
+ attackPower;
624
+ /**
625
+ * 마력
626
+ */
627
+ magicPower;
628
+ constructor(obj) {
629
+ const { str, dex, int, luk, max_hp, max_mp, attack_power, magic_power, } = obj;
630
+ this.str = str;
631
+ this.dex = dex;
632
+ this.int = int;
633
+ this.luk = luk;
634
+ this.maxHp = max_hp;
635
+ this.maxMp = max_mp;
636
+ this.attackPower = attack_power;
637
+ this.magicPower = magic_power;
638
+ }
639
+ }
640
+
641
+ /**
642
+ * 캐릭터 장비 최종 옵션 정보
643
+ */
644
+ class CharacterItemEquipmentTotalOptionDto {
645
+ /**
646
+ * STR
647
+ */
648
+ str;
649
+ /**
650
+ * DEX
651
+ */
652
+ dex;
653
+ /**
654
+ * INT
655
+ */
656
+ int;
657
+ /**
658
+ * LUK
659
+ */
660
+ luk;
661
+ /**
662
+ * 최대 HP
663
+ */
664
+ maxHp;
665
+ /**
666
+ * 최대 MP
667
+ */
668
+ maxMp;
669
+ /**
670
+ * 공격력
671
+ */
672
+ attackPower;
673
+ /**
674
+ * 마력
675
+ */
676
+ magicPower;
677
+ /**
678
+ * 방어력
679
+ */
680
+ armor;
681
+ /**
682
+ * 이동속도
683
+ */
684
+ speed;
685
+ /**
686
+ * 점프력
687
+ */
688
+ jump;
689
+ /**
690
+ * 보스 공격 시 데미지 증가(%)
691
+ */
692
+ bossDamage;
693
+ /**
694
+ * 몬스터 방어율 무시(%)
695
+ */
696
+ ignoreMonsterArmor;
697
+ /**
698
+ * 올스탯(%)
699
+ */
700
+ allStat;
701
+ /**
702
+ * 데미지(%)
703
+ */
704
+ damage;
705
+ /**
706
+ * 착용 레벨 감소
707
+ */
708
+ equipmentLevelDecrease;
709
+ /**
710
+ * 최대 HP(%)
711
+ */
712
+ maxHpRate;
713
+ /**
714
+ * 최대 MP(%)
715
+ */
716
+ maxMpRate;
717
+ constructor(obj) {
718
+ const { str, dex, int, luk, max_hp, max_mp, attack_power, magic_power, armor, speed, jump, boss_damage, ignore_monster_armor, all_stat, damage, equipment_level_decrease, max_hp_rate, max_mp_rate, } = obj;
719
+ this.str = str;
720
+ this.dex = dex;
721
+ this.int = int;
722
+ this.luk = luk;
723
+ this.maxHp = max_hp;
724
+ this.maxMp = max_mp;
725
+ this.attackPower = attack_power;
726
+ this.magicPower = magic_power;
727
+ this.armor = armor;
728
+ this.speed = speed;
729
+ this.jump = jump;
730
+ this.bossDamage = boss_damage;
731
+ this.ignoreMonsterArmor = ignore_monster_armor;
732
+ this.allStat = all_stat;
733
+ this.damage = damage;
734
+ this.equipmentLevelDecrease = equipment_level_decrease;
735
+ this.maxHpRate = max_hp_rate;
736
+ this.maxMpRate = max_mp_rate;
737
+ }
738
+ }
739
+
740
+ /**
741
+ * 캐릭터 장비 기본 옵션 정보
742
+ */
743
+ class CharacterItemEquipmentBaseOptionDto {
744
+ /**
745
+ * STR
746
+ */
747
+ str;
748
+ /**
749
+ * DEX
750
+ */
751
+ dex;
752
+ /**
753
+ * INT
754
+ */
755
+ int;
756
+ /**
757
+ * LUK
758
+ */
759
+ luk;
760
+ /**
761
+ * 최대 HP
762
+ */
763
+ maxHp;
764
+ /**
765
+ * 최대 MP
766
+ */
767
+ maxMp;
768
+ /**
769
+ * 공격력
770
+ */
771
+ attackPower;
772
+ /**
773
+ * 마력
774
+ */
775
+ magicPower;
776
+ /**
777
+ * 방어력
778
+ */
779
+ armor;
780
+ /**
781
+ * 이동속도
782
+ */
783
+ speed;
784
+ /**
785
+ * 점프력
786
+ */
787
+ jump;
788
+ /**
789
+ * 보스 공격 시 데미지 증가(%)
790
+ */
791
+ bossDamage;
792
+ /**
793
+ * 몬스터 방어율 무시(%)
794
+ */
795
+ ignoreMonsterArmor;
796
+ /**
797
+ * 올스탯(%)
798
+ */
799
+ allStat;
800
+ /**
801
+ * 최대 HP(%)
802
+ */
803
+ maxHpRate;
804
+ /**
805
+ * 최대 MP(%)
806
+ */
807
+ maxMpRate;
808
+ /**
809
+ * 기본 착용 레벨
810
+ */
811
+ baseEquipmentLevel;
812
+ constructor(obj) {
813
+ const { str, dex, int, luk, max_hp, max_mp, attack_power, magic_power, armor, speed, jump, boss_damage, ignore_monster_armor, all_stat, max_hp_rate, max_mp_rate, base_equipment_level, } = obj;
814
+ this.str = str;
815
+ this.dex = dex;
816
+ this.int = int;
817
+ this.luk = luk;
818
+ this.maxHp = max_hp;
819
+ this.maxMp = max_mp;
820
+ this.attackPower = attack_power;
821
+ this.magicPower = magic_power;
822
+ this.armor = armor;
823
+ this.speed = speed;
824
+ this.jump = jump;
825
+ this.bossDamage = boss_damage;
826
+ this.ignoreMonsterArmor = ignore_monster_armor;
827
+ this.allStat = all_stat;
828
+ this.maxHpRate = max_hp_rate;
829
+ this.maxMpRate = max_mp_rate;
830
+ this.baseEquipmentLevel = base_equipment_level;
831
+ }
832
+ }
833
+
834
+ /**
835
+ * 캐릭터 장비 추가 옵션 정보
836
+ */
837
+ class CharacterItemEquipmentAddOptionDto {
838
+ /**
839
+ * STR
840
+ */
841
+ str;
842
+ /**
843
+ * DEX
844
+ */
845
+ dex;
846
+ /**
847
+ * INT
848
+ */
849
+ int;
850
+ /**
851
+ * LUK
852
+ */
853
+ luk;
854
+ /**
855
+ * 최대 HP
856
+ */
857
+ maxHp;
858
+ /**
859
+ * 최대 MP
860
+ */
861
+ maxMp;
862
+ /**
863
+ * 공격력
864
+ */
865
+ attackPower;
866
+ /**
867
+ * 마력
868
+ */
869
+ magicPower;
870
+ /**
871
+ * 방어력
872
+ */
873
+ armor;
874
+ /**
875
+ * 이동속도
876
+ */
877
+ speed;
878
+ /**
879
+ * 점프력
880
+ */
881
+ jump;
882
+ /**
883
+ * 보스 공격 시 데미지 증가(%)
884
+ */
885
+ bossDamage;
886
+ /**
887
+ * 데미지(%)
888
+ */
889
+ damage;
890
+ /**
891
+ * 올스탯(%)
892
+ */
893
+ allStat;
894
+ /**
895
+ * 착용 레벨 감소
896
+ */
897
+ equipmentLevelDecrease;
898
+ constructor(obj) {
899
+ const { str, dex, int, luk, max_hp, max_mp, attack_power, magic_power, armor, speed, jump, boss_damage, damage, all_stat, equipment_level_decrease } = obj;
900
+ this.str = str;
901
+ this.dex = dex;
902
+ this.int = int;
903
+ this.luk = luk;
904
+ this.maxHp = max_hp;
905
+ this.maxMp = max_mp;
906
+ this.attackPower = attack_power;
907
+ this.magicPower = magic_power;
908
+ this.armor = armor;
909
+ this.speed = speed;
910
+ this.jump = jump;
911
+ this.bossDamage = boss_damage;
912
+ this.damage = damage;
913
+ this.allStat = all_stat;
914
+ this.equipmentLevelDecrease = equipment_level_decrease;
915
+ }
916
+ }
917
+
918
+ /**
919
+ * 캐릭터 장비 기타 옵션 정보
920
+ */
921
+ class CharacterItemEquipmentEtcOptionDto {
922
+ /**
923
+ * STR
924
+ */
925
+ str;
926
+ /**
927
+ * DEX
928
+ */
929
+ dex;
930
+ /**
931
+ * INT
932
+ */
933
+ int;
934
+ /**
935
+ * LUK
936
+ */
937
+ luk;
938
+ /**
939
+ * 최대 HP
940
+ */
941
+ maxHp;
942
+ /**
943
+ * 최대 MP
944
+ */
945
+ maxMp;
946
+ /**
947
+ * 공격력
948
+ */
949
+ attackPower;
950
+ /**
951
+ * 마력
952
+ */
953
+ magicPower;
954
+ /**
955
+ * 방어력
956
+ */
957
+ armor;
958
+ /**
959
+ * 이동속도
960
+ */
961
+ speed;
962
+ /**
963
+ * 점프력
964
+ */
965
+ jump;
966
+ constructor(obj) {
967
+ const { str, dex, int, luk, max_hp, max_mp, attack_power, magic_power, armor, speed, jump, } = obj;
968
+ this.str = str;
969
+ this.dex = dex;
970
+ this.int = int;
971
+ this.luk = luk;
972
+ this.maxHp = max_hp;
973
+ this.maxMp = max_mp;
974
+ this.attackPower = attack_power;
975
+ this.magicPower = magic_power;
976
+ this.armor = armor;
977
+ this.speed = speed;
978
+ this.jump = jump;
979
+ }
980
+ }
981
+
982
+ /**
983
+ * 캐릭터 장비 스타포스 옵션 정보
984
+ */
985
+ class CharacterItemEquipmentStarforceOptionDto {
986
+ /**
987
+ * STR
988
+ */
989
+ str;
990
+ /**
991
+ * DEX
992
+ */
993
+ dex;
994
+ /**
995
+ * INT
996
+ */
997
+ int;
998
+ /**
999
+ * LUK
1000
+ */
1001
+ luk;
1002
+ /**
1003
+ * 최대 HP
1004
+ */
1005
+ maxHp;
1006
+ /**
1007
+ * 최대 MP
1008
+ */
1009
+ maxMp;
1010
+ /**
1011
+ * 공격력
1012
+ */
1013
+ attackPower;
1014
+ /**
1015
+ * 마력
1016
+ */
1017
+ magicPower;
1018
+ /**
1019
+ * 방어력
1020
+ */
1021
+ armor;
1022
+ /**
1023
+ * 이동속도
1024
+ */
1025
+ speed;
1026
+ /**
1027
+ * 점프력
1028
+ */
1029
+ jump;
1030
+ constructor(obj) {
1031
+ const { str, dex, int, luk, max_hp, max_mp, attack_power, magic_power, armor, speed, jump, } = obj;
1032
+ this.str = str;
1033
+ this.dex = dex;
1034
+ this.int = int;
1035
+ this.luk = luk;
1036
+ this.maxHp = max_hp;
1037
+ this.maxMp = max_mp;
1038
+ this.attackPower = attack_power;
1039
+ this.magicPower = magic_power;
1040
+ this.armor = armor;
1041
+ this.speed = speed;
1042
+ this.jump = jump;
1043
+ }
1044
+ }
1045
+
1046
+ class CharacterItemEquipmentInfoDto {
1047
+ /**
1048
+ * 장비 부위 명
1049
+ */
1050
+ itemEquipmentPart;
1051
+ /**
1052
+ * 장비 슬롯 위치
1053
+ */
1054
+ equipmentSlot;
1055
+ /**
1056
+ * 장비 명
1057
+ */
1058
+ itemName;
1059
+ /**
1060
+ * 장비 아이콘
1061
+ */
1062
+ itemIcon;
1063
+ /**
1064
+ * 장비 설명
1065
+ */
1066
+ itemDescription;
1067
+ /**
1068
+ * 장비 외형
1069
+ */
1070
+ itemShapeName;
1071
+ /**
1072
+ * 장비 외형 아이콘
1073
+ */
1074
+ itemShapeIcon;
1075
+ /**
1076
+ * 전용 성별
1077
+ */
1078
+ gender;
1079
+ /**
1080
+ * 장비 최종 옵션
1081
+ */
1082
+ itemTotalOption;
1083
+ /**
1084
+ * 장비 기본 옵션
1085
+ */
1086
+ itemBaseOption;
1087
+ /**
1088
+ * 잠재능력 등급
1089
+ */
1090
+ potentialOptionGrade;
1091
+ /**
1092
+ * 에디셔널 잠재능력 등급
1093
+ */
1094
+ additionalPotentialOptionGrade;
1095
+ /**
1096
+ * 잠재능력 첫 번째 옵션
1097
+ */
1098
+ potentialOption1;
1099
+ /**
1100
+ * 잠재능력 두 번째 옵션
1101
+ */
1102
+ potentialOption2;
1103
+ /**
1104
+ * 잠재능력 세 번째 옵션
1105
+ */
1106
+ potentialOption3;
1107
+ /**
1108
+ * 에디셔널 잠재능력 첫 번째 옵션
1109
+ */
1110
+ additionalPotentialOption1;
1111
+ /**
1112
+ * 에디셔널 잠재능력 두 번째 옵션
1113
+ */
1114
+ additionalPotentialOption2;
1115
+ /**
1116
+ * 에디셔널 잠재능력 세 번째 옵션
1117
+ */
1118
+ additionalPotentialOption3;
1119
+ /**
1120
+ * 착용 레벨 증가
1121
+ */
1122
+ equipmentLevelIncrease;
1123
+ /**
1124
+ * 장비 특별 옵션
1125
+ */
1126
+ itemExceptionalOption;
1127
+ /**
1128
+ * 장비 추가 옵션
1129
+ */
1130
+ itemAddOption;
1131
+ /**
1132
+ * 성장 경험치
1133
+ */
1134
+ growthExp;
1135
+ /**
1136
+ * 성장 레벨
1137
+ */
1138
+ growthLevel;
1139
+ /**
1140
+ * 업그레이드 횟수
1141
+ */
1142
+ scrollUpgrade;
1143
+ /**
1144
+ * 가위 사용 가능 횟수 (교환 불가 장비, 가위 횟수가 없는 교환 가능 장비는 255)
1145
+ */
1146
+ cuttableCount;
1147
+ /**
1148
+ * 황금 망치 재련 적용 (1:적용, 이외 미 적용)
1149
+ */
1150
+ goldenHammerFlag;
1151
+ /**
1152
+ * 복구 가능 횟수
1153
+ */
1154
+ scrollResilienceCount;
1155
+ /**
1156
+ * 업그레이드 가능 횟수
1157
+ */
1158
+ scrollUpgradeableCount;
1159
+ /**
1160
+ * 소울 명
1161
+ */
1162
+ soulName;
1163
+ /**
1164
+ * 소울 옵션
1165
+ */
1166
+ soulOption;
1167
+ /**
1168
+ * 장비 기타 옵션
1169
+ */
1170
+ itemEtcOption;
1171
+ /**
1172
+ * 강화 단계
1173
+ */
1174
+ starforce;
1175
+ /**
1176
+ * 놀라운 장비 강화 주문서 사용 여부 (0:미사용, 1:사용)
1177
+ */
1178
+ starforceScrollFlag;
1179
+ /**
1180
+ * 장비 스타포스 옵션
1181
+ */
1182
+ itemStarforceOption;
1183
+ /**
1184
+ * 특수 반지 레벨
1185
+ */
1186
+ specialRingLevel;
1187
+ /**
1188
+ * 장비 유효 기간
1189
+ */
1190
+ dateExpire;
1191
+ constructor(obj) {
1192
+ const { item_equipment_part, equipment_slot, item_name, item_icon, item_description, item_shape_name, item_shape_icon, gender, item_total_option, item_base_option, potential_option_grade, additional_potential_option_grade, potential_option_1, potential_option_2, potential_option_3, additional_potential_option_1, additional_potential_option_2, additional_potential_option_3, equipment_level_increase, item_exceptional_option, item_add_option, growth_exp, growth_level, scroll_upgrade, cuttable_count, golden_hammer_flag, scroll_resilience_count, scroll_upgradeable_count, soul_name, soul_option, item_etc_option, starforce, starforce_scroll_flag, item_starforce_option, special_ring_level, date_expire, } = obj;
1193
+ this.itemEquipmentPart = item_equipment_part;
1194
+ this.equipmentSlot = equipment_slot;
1195
+ this.itemName = item_name;
1196
+ this.itemIcon = item_icon;
1197
+ this.itemDescription = item_description;
1198
+ this.itemShapeName = item_shape_name;
1199
+ this.itemShapeIcon = item_shape_icon;
1200
+ this.gender = gender;
1201
+ this.itemTotalOption = new CharacterItemEquipmentTotalOptionDto(item_total_option);
1202
+ this.itemBaseOption = new CharacterItemEquipmentBaseOptionDto(item_base_option);
1203
+ this.potentialOptionGrade = potential_option_grade;
1204
+ this.additionalPotentialOptionGrade = additional_potential_option_grade;
1205
+ this.potentialOption1 = potential_option_1;
1206
+ this.potentialOption2 = potential_option_2;
1207
+ this.potentialOption3 = potential_option_3;
1208
+ this.additionalPotentialOption1 = additional_potential_option_1;
1209
+ this.additionalPotentialOption2 = additional_potential_option_2;
1210
+ this.additionalPotentialOption3 = additional_potential_option_3;
1211
+ this.equipmentLevelIncrease = equipment_level_increase;
1212
+ this.itemExceptionalOption = new CharacterItemEquipmentExceptionalOptionDto(item_exceptional_option);
1213
+ this.itemAddOption = new CharacterItemEquipmentAddOptionDto(item_add_option);
1214
+ this.growthExp = growth_exp;
1215
+ this.growthLevel = growth_level;
1216
+ this.scrollUpgrade = scroll_upgrade;
1217
+ this.cuttableCount = cuttable_count;
1218
+ this.goldenHammerFlag = golden_hammer_flag;
1219
+ this.scrollResilienceCount = scroll_resilience_count;
1220
+ this.scrollUpgradeableCount = scroll_upgradeable_count;
1221
+ this.soulName = soul_name;
1222
+ this.soulOption = soul_option;
1223
+ this.itemEtcOption = new CharacterItemEquipmentEtcOptionDto(item_etc_option);
1224
+ this.starforce = starforce;
1225
+ this.starforceScrollFlag = starforce_scroll_flag;
1226
+ this.itemStarforceOption = new CharacterItemEquipmentStarforceOptionDto(item_starforce_option);
1227
+ this.specialRingLevel = special_ring_level;
1228
+ this.dateExpire = new Date(date_expire);
1229
+ }
1230
+ }
1231
+
1232
+ /**
1233
+ * 캐릭터 장비 아이템 정보
1234
+ */
1235
+ class CharacterItemEquipmentDto {
1236
+ /**
1237
+ * 조회 기준일
1238
+ */
1239
+ date;
1240
+ /**
1241
+ * 캐릭터 성별
1242
+ */
1243
+ characterGender;
1244
+ /**
1245
+ * 캐릭터 직업
1246
+ */
1247
+ characterClass;
1248
+ /**
1249
+ * 장비 정보 배열
1250
+ */
1251
+ itemEquipment;
1252
+ /**
1253
+ * 칭호 정보
1254
+ */
1255
+ title;
1256
+ /**
1257
+ * 에반 드래곤 장비 정보 (에반인 경우 응답)
1258
+ */
1259
+ dragonEquipment;
1260
+ /**
1261
+ * 메카닉 장비 정보 (메카닉인 경우 응답)
1262
+ */
1263
+ mechanicEquipment;
1264
+ constructor(obj) {
1265
+ const { date, character_gender, character_class, item_equipment, title, dragon_equipment, mechanic_equipment, } = obj;
1266
+ this.date = new Date(date);
1267
+ this.characterGender = character_gender;
1268
+ this.characterClass = character_class;
1269
+ this.itemEquipment = item_equipment.map(equipment => new CharacterItemEquipmentInfoDto(equipment));
1270
+ this.title = new CharacterItemEquipmentTitleDto(title);
1271
+ this.dragonEquipment = dragon_equipment ? dragon_equipment.map(equipment => new CharacterItemEquipmentInfoDto(equipment)) : undefined;
1272
+ this.mechanicEquipment = mechanic_equipment ? mechanic_equipment.map(equipment => new CharacterItemEquipmentInfoDto(equipment)) : undefined;
1273
+ }
1274
+ }
1275
+
1276
+ /**
1277
+ * 캐릭터 캐시 장비 옵션
1278
+ */
1279
+ class CharacterCashItemEquipmentOptionDto {
1280
+ /**
1281
+ * 옵션 타입
1282
+ */
1283
+ optionType;
1284
+ /**
1285
+ * 옵션 값
1286
+ */
1287
+ optionValue;
1288
+ constructor(obj) {
1289
+ const { option_type, option_value } = obj;
1290
+ this.optionType = option_type;
1291
+ this.optionValue = option_value;
1292
+ }
1293
+ }
1294
+
1295
+ /**
1296
+ * 캐릭터 캐시 장비 컬러링프리즘
1297
+ */
1298
+ class CharacterCashItemEquipmentColoringPrismDto {
1299
+ /**
1300
+ * 컬러링프리즘 색상 범위
1301
+ */
1302
+ colorRange;
1303
+ /**
1304
+ * 컬러링프리즘 색조
1305
+ */
1306
+ hue;
1307
+ /**
1308
+ * 컬러링프리즘 채도
1309
+ */
1310
+ saturation;
1311
+ /**
1312
+ * 컬러링프리즘 명도
1313
+ */
1314
+ value;
1315
+ constructor(obj) {
1316
+ const { color_range, hue, saturation, value, } = obj;
1317
+ this.colorRange = color_range;
1318
+ this.hue = hue;
1319
+ this.saturation = saturation;
1320
+ this.value = value;
1321
+ }
1322
+ }
1323
+
1324
+ /**
1325
+ * 캐릭터 프리셋 장착 캐시 장비 정보
1326
+ */
1327
+ class CharacterCashItemEquipmentPresetDto {
1328
+ /**
1329
+ * 캐시 장비 부위 명
1330
+ */
1331
+ cashItemEquipmentPart;
1332
+ /**
1333
+ * 캐시 장비 슬롯 위치
1334
+ */
1335
+ cashItemEquipmentSlot;
1336
+ /**
1337
+ * 캐시 장비 명
1338
+ */
1339
+ cashItemName;
1340
+ /**
1341
+ * 캐시 장비 아이콘
1342
+ */
1343
+ cashItemIcon;
1344
+ /**
1345
+ * 캐시 장비 설명
1346
+ */
1347
+ cashItemDescription;
1348
+ /**
1349
+ * 캐시 장비 옵션
1350
+ */
1351
+ cashItemOption;
1352
+ /**
1353
+ * 캐시 장비 유효 기간 (KST)
1354
+ */
1355
+ dateExpire;
1356
+ /**
1357
+ * 캐시 장비 옵션 유효 기간 (KST, 시간 단위 데이터로 분은 일괄 0으로 표기)
1358
+ */
1359
+ dateOptionExpire;
1360
+ /**
1361
+ * 캐시 장비 라벨 정보
1362
+ */
1363
+ cashItemLabel;
1364
+ /**
1365
+ * 캐시 장비 컬러링프리즘 정보
1366
+ */
1367
+ cashItemColoringPrism;
1368
+ /**
1369
+ * 다른 프리셋에서 장비 추가 장착 없이 1번 프리셋의 장비 공유를 비활성화 했는지 여부
1370
+ */
1371
+ basePresetItemDisableFlag;
1372
+ constructor(obj) {
1373
+ const { cash_item_equipment_part, cash_item_equipment_slot, cash_item_name, cash_item_icon, cash_item_description, cash_item_option, date_expire, date_option_expire, cash_item_label, cash_item_coloring_prism, base_preset_item_disable_flag, } = obj;
1374
+ this.cashItemEquipmentPart = cash_item_equipment_part;
1375
+ this.cashItemEquipmentSlot = cash_item_equipment_slot;
1376
+ this.cashItemName = cash_item_name;
1377
+ this.cashItemIcon = cash_item_icon;
1378
+ this.cashItemDescription = cash_item_description;
1379
+ this.cashItemOption = cash_item_option.map(option => new CharacterCashItemEquipmentOptionDto(option));
1380
+ this.dateExpire = date_expire;
1381
+ this.dateOptionExpire = date_option_expire;
1382
+ this.cashItemLabel = cash_item_label;
1383
+ this.cashItemColoringPrism = new CharacterCashItemEquipmentColoringPrismDto(cash_item_coloring_prism);
1384
+ this.basePresetItemDisableFlag = base_preset_item_disable_flag;
1385
+ }
1386
+ }
1387
+
1388
+ /**
1389
+ * 캐릭터 캐시 장비 아이템 정보
1390
+ */
1391
+ class CharacterCashItemEquipmentDto {
1392
+ /**
1393
+ * 조회 기준일
1394
+ */
1395
+ date;
1396
+ /**
1397
+ * 캐릭터 성별
1398
+ */
1399
+ characterGender;
1400
+ /**
1401
+ * 캐릭터 직업
1402
+ */
1403
+ characterClass;
1404
+ /**
1405
+ * 적용 중인 캐시 장비 프리셋 번호
1406
+ */
1407
+ presetNo;
1408
+ /**
1409
+ * 1번 프리셋 장착 캐시 장비 정보
1410
+ */
1411
+ cashItemEquipmentPreset1;
1412
+ /**
1413
+ * 2번 프리셋 장착 캐시 장비 정보
1414
+ */
1415
+ cashItemEquipmentPreset2;
1416
+ /**
1417
+ * 3번 프리셋 장착 캐시 장비 정보
1418
+ */
1419
+ cashItemEquipmentPreset3;
1420
+ /**
1421
+ * 제로인 경우 베타, 엔젤릭버스터인 경우 드레스 업 모드의 1번 프리셋 장착 캐시 장비 정보
1422
+ */
1423
+ additionalCashItemEquipmentPreset1;
1424
+ /**
1425
+ * 제로인 경우 베타, 엔젤릭버스터인 경우 드레스 업 모드의 2번 프리셋 장착 캐시 장비 정보
1426
+ */
1427
+ additionalCashItemEquipmentPreset2;
1428
+ /**
1429
+ * 제로인 경우 베타, 엔젤릭버스터인 경우 드레스 업 모드의 3번 프리셋 장착 캐시 장비 정보
1430
+ */
1431
+ additionalCashItemEquipmentPreset3;
1432
+ constructor(obj) {
1433
+ const { date, character_gender, character_class, preset_no, cash_item_equipment_preset_1, cash_item_equipment_preset_2, cash_item_equipment_preset_3, additional_cash_item_equipment_preset_1, additional_cash_item_equipment_preset_2, additional_cash_item_equipment_preset_3, } = obj;
1434
+ this.date = new Date(date),
1435
+ this.characterGender = character_gender;
1436
+ this.characterClass = character_class;
1437
+ this.presetNo = preset_no;
1438
+ this.cashItemEquipmentPreset1 = cash_item_equipment_preset_1.map(preset => new CharacterCashItemEquipmentPresetDto(preset));
1439
+ this.cashItemEquipmentPreset2 = cash_item_equipment_preset_2.map(preset => new CharacterCashItemEquipmentPresetDto(preset));
1440
+ this.cashItemEquipmentPreset3 = cash_item_equipment_preset_3.map(preset => new CharacterCashItemEquipmentPresetDto(preset));
1441
+ this.additionalCashItemEquipmentPreset1 = additional_cash_item_equipment_preset_1.map(preset => new CharacterCashItemEquipmentPresetDto(preset));
1442
+ this.additionalCashItemEquipmentPreset2 = additional_cash_item_equipment_preset_2.map(preset => new CharacterCashItemEquipmentPresetDto(preset));
1443
+ this.additionalCashItemEquipmentPreset3 = additional_cash_item_equipment_preset_3.map(preset => new CharacterCashItemEquipmentPresetDto(preset));
1444
+ }
1445
+ }
1446
+
1447
+ /**
1448
+ * 캐릭터 심볼 상세 정보
1449
+ */
1450
+ class CharacterSymbolEquipmentInfoDto {
1451
+ /**
1452
+ * 심볼 명
1453
+ */
1454
+ symbolName;
1455
+ /**
1456
+ * 심볼 아이콘
1457
+ */
1458
+ symbolIcon;
1459
+ /**
1460
+ * 심볼 설명
1461
+ */
1462
+ symbolDescription;
1463
+ /**
1464
+ * 심볼로 인한 증가 수치
1465
+ */
1466
+ symbolForce;
1467
+ /**
1468
+ * 심볼 레벨
1469
+ */
1470
+ symbolLevel;
1471
+ /**
1472
+ * 심볼로 증가한 힘
1473
+ */
1474
+ symbolStr;
1475
+ /**
1476
+ * 심볼로 증가한 민첩
1477
+ */
1478
+ symbolDex;
1479
+ /**
1480
+ * 심볼로 증가한 지력
1481
+ */
1482
+ symbolInt;
1483
+ /**
1484
+ * 심볼로 증가한 운
1485
+ */
1486
+ symbolLuk;
1487
+ /**
1488
+ * 심볼로 증가한 체력
1489
+ */
1490
+ symbolHp;
1491
+ /**
1492
+ * 현재 보유 성장치
1493
+ */
1494
+ symbolGrowthCount;
1495
+ /**
1496
+ * 성장 시 필요한 성장치
1497
+ */
1498
+ symbolRequireGrowthCount;
1499
+ constructor(obj) {
1500
+ const { symbol_name, symbol_icon, symbol_description, symbol_force, symbol_level, symbol_str, symbol_dex, symbol_int, symbol_luk, symbol_hp, symbol_growth_count, symbol_require_growth_count, } = obj;
1501
+ this.symbolName = symbol_name;
1502
+ this.symbolIcon = symbol_icon;
1503
+ this.symbolDescription = symbol_description;
1504
+ this.symbolForce = symbol_force;
1505
+ this.symbolLevel = symbol_level;
1506
+ this.symbolStr = symbol_str;
1507
+ this.symbolDex = symbol_dex;
1508
+ this.symbolInt = symbol_int;
1509
+ this.symbolLuk = symbol_luk;
1510
+ this.symbolHp = symbol_hp;
1511
+ this.symbolGrowthCount = symbol_growth_count;
1512
+ this.symbolRequireGrowthCount = symbol_require_growth_count;
1513
+ }
1514
+ }
1515
+
1516
+ /**
1517
+ * 캐릭터 심볼 정보
1518
+ */
1519
+ class CharacterSymbolEquipmentDto {
1520
+ /**
1521
+ * 조회 기준일
1522
+ */
1523
+ date;
1524
+ /**
1525
+ * 캐릭터 직업
1526
+ */
1527
+ characterClass;
1528
+ /**
1529
+ * 심볼 정보
1530
+ */
1531
+ symbol;
1532
+ constructor(obj) {
1533
+ const { date, character_class, symbol } = obj;
1534
+ this.date = new Date(date);
1535
+ this.characterClass = character_class;
1536
+ this.symbol = symbol.map(s => new CharacterSymbolEquipmentInfoDto(s));
1537
+ }
1538
+ }
1539
+
1540
+ /**
1541
+ * 캐릭터 세트 효과 옵션 정보
1542
+ */
1543
+ class CharacterSetEffectOptionInfoDto {
1544
+ /**
1545
+ * 세트 효과 레벨 (장비 수)
1546
+ */
1547
+ setCount;
1548
+ /**
1549
+ * 적용 중인 세트 효과
1550
+ */
1551
+ setOption;
1552
+ constructor(obj) {
1553
+ const { set_count, set_option } = obj;
1554
+ this.setCount = set_count;
1555
+ this.setOption = set_option;
1556
+ }
1557
+ }
1558
+
1559
+ /**
1560
+ * 캐릭터 세트 효과 정보
1561
+ */
1562
+ class CharacterSetEffectInfoDto {
1563
+ /**
1564
+ * 세트 효과 명
1565
+ */
1566
+ setName;
1567
+ /**
1568
+ * 세트 개수 (럭키 아이템 포함)
1569
+ */
1570
+ totalSetCount;
1571
+ /**
1572
+ * 세트 효과 옵션
1573
+ */
1574
+ setEffectInfo;
1575
+ constructor(obj) {
1576
+ const { set_name, total_set_count, set_effect_info } = obj;
1577
+ this.setName = set_name;
1578
+ this.totalSetCount = total_set_count;
1579
+ this.setEffectInfo = set_effect_info.map(info => new CharacterSetEffectOptionInfoDto(info));
1580
+ }
1581
+ }
1582
+
1583
+ /**
1584
+ * 캐릭터 세트 효과 정보
1585
+ */
1586
+ class CharacterSetEffectDto {
1587
+ /**
1588
+ * 조회 기준일
1589
+ */
1590
+ date;
1591
+ /**
1592
+ * 세트 효과 정보
1593
+ */
1594
+ setEffect;
1595
+ constructor(obj) {
1596
+ const { date, set_effect } = obj;
1597
+ this.date = new Date(date);
1598
+ this.setEffect = set_effect.map(effect => new CharacterSetEffectInfoDto(effect));
1599
+ }
1600
+ }
1601
+
1602
+ /**
1603
+ * 캐릭터 헤어 정보
1604
+ */
1605
+ class CharacterBeautyEquipmentHairDto {
1606
+ /**
1607
+ * 헤어 명
1608
+ */
1609
+ hairName;
1610
+ /**
1611
+ * 헤어 베이스 컬러
1612
+ */
1613
+ baseColor;
1614
+ /**
1615
+ * 헤어 믹스 컬러
1616
+ */
1617
+ mixColor;
1618
+ /**
1619
+ * 헤어 믹스 컬러의 염색 비율
1620
+ */
1621
+ mixRate;
1622
+ constructor(obj) {
1623
+ const { hair_name, base_color, mix_color, mix_rate } = obj;
1624
+ this.hairName = hair_name;
1625
+ this.baseColor = base_color;
1626
+ this.mixColor = mix_color;
1627
+ this.mixRate = mix_rate;
1628
+ }
1629
+ }
1630
+
1631
+ /**
1632
+ * 캐릭터 성형 정보
1633
+ */
1634
+ class CharacterBeautyEquipmentFaceDto {
1635
+ /**
1636
+ * 성형 명
1637
+ */
1638
+ faceName;
1639
+ /**
1640
+ * 성형 베이스 컬러
1641
+ */
1642
+ baseColor;
1643
+ /**
1644
+ * 성형 믹스 컬러
1645
+ */
1646
+ mixColor;
1647
+ /**
1648
+ * 성형 믹스 컬러의 염색 비율
1649
+ */
1650
+ mixRate;
1651
+ constructor(obj) {
1652
+ const { face_name, base_color, mix_color, mix_rate } = obj;
1653
+ this.faceName = face_name;
1654
+ this.baseColor = base_color;
1655
+ this.mixColor = mix_color;
1656
+ this.mixRate = mix_rate;
1657
+ }
1658
+ }
1659
+
1660
+ /**
1661
+ * 캐릭터 헤어, 성형, 피부 정보
1662
+ */
1663
+ class CharacterBeautyEquipmentDto {
1664
+ /**
1665
+ * 조회 기준일
1666
+ */
1667
+ date;
1668
+ /**
1669
+ * 캐릭터 성별
1670
+ */
1671
+ characterGender;
1672
+ /**
1673
+ * 캐릭터 직업
1674
+ */
1675
+ characterClass;
1676
+ /**
1677
+ * 캐릭터 헤어 정보<br>
1678
+ * (제로인 경우 알파, 엔젤릭버스터인 경우 일반 모드)
1679
+ */
1680
+ characterHair;
1681
+ /**
1682
+ * 캐릭터 성형 정보<br>
1683
+ * (제로인 경우 알파, 엔젤릭버스터인 경우 일반 모드)
1684
+ */
1685
+ characterFace;
1686
+ /**
1687
+ * 피부 명<br>
1688
+ * (제로인 경우 알파, 엔젤릭버스터인 경우 일반 모드)
1689
+ */
1690
+ characterSkinName;
1691
+ /**
1692
+ * 제로인 경우 베타, 엔젤릭버스터인 경우 드레스 업 모드에 적용 중인 헤어 정보
1693
+ */
1694
+ additionalCharacterHair;
1695
+ /**
1696
+ * 제로인 경우 베타, 엔젤릭버스터인 경우 드레스 업 모드에 적용 중인 성형 정보
1697
+ */
1698
+ additionalCharacterFace;
1699
+ /**
1700
+ * 제로인 경우 베타, 엔젤릭버스터인 경우 드레스 업 모드에 적용 중인 피부 명
1701
+ */
1702
+ additionalCharacterSkinName;
1703
+ constructor(obj) {
1704
+ const { date, character_gender, character_class, character_hair, character_face, character_skin_name, additional_character_hair, additional_character_face, additional_character_skin_name, } = obj;
1705
+ this.date = new Date(date);
1706
+ this.characterGender = character_gender;
1707
+ this.characterClass = character_class;
1708
+ this.characterHair = new CharacterBeautyEquipmentHairDto(character_hair);
1709
+ this.characterFace = new CharacterBeautyEquipmentFaceDto(character_face);
1710
+ this.characterSkinName = character_skin_name;
1711
+ this.additionalCharacterHair = new CharacterBeautyEquipmentHairDto(additional_character_hair);
1712
+ this.additionalCharacterFace = new CharacterBeautyEquipmentFaceDto(additional_character_face);
1713
+ this.additionalCharacterSkinName = additional_character_skin_name;
1714
+ }
1715
+ }
1716
+
1717
+ /**
1718
+ * 캐릭터 안드로이드 성형 정보
1719
+ */
1720
+ class CharacterAndroidEquipmentFaceDto {
1721
+ /**
1722
+ * 안드로이드 성형 명
1723
+ */
1724
+ faceName;
1725
+ /**
1726
+ * 안드로이드 성형 베이스 컬러
1727
+ */
1728
+ baseColor;
1729
+ /**
1730
+ * 안드로이드 성형 믹스 컬러
1731
+ */
1732
+ mixColor;
1733
+ /**
1734
+ * 안드로이드 성형 믹스 컬러의 염색 비율
1735
+ */
1736
+ mixRate;
1737
+ constructor(obj) {
1738
+ const { face_name, base_color, mix_color, mix_rate } = obj;
1739
+ this.faceName = face_name;
1740
+ this.baseColor = base_color;
1741
+ this.mixColor = mix_color;
1742
+ this.mixRate = mix_rate;
1743
+ }
1744
+ }
1745
+
1746
+ /**
1747
+ * 캐릭터 안드로이드 헤어 정보
1748
+ */
1749
+ class CharacterAndroidEquipmentHairDto {
1750
+ /**
1751
+ * 안드로이드 헤어 명
1752
+ */
1753
+ hairName;
1754
+ /**
1755
+ * 안드로이드 헤어 베이스 컬러
1756
+ */
1757
+ baseColor;
1758
+ /**
1759
+ * 안드로이드 헤어 믹스 컬러
1760
+ */
1761
+ mixColor;
1762
+ /**
1763
+ * 안드로이드 헤어 믹스 컬러의 염색 비율
1764
+ */
1765
+ mixRate;
1766
+ constructor(obj) {
1767
+ const { hair_name, base_color, mix_color, mix_rate } = obj;
1768
+ this.hairName = hair_name;
1769
+ this.baseColor = base_color;
1770
+ this.mixColor = mix_color;
1771
+ this.mixRate = mix_rate;
1772
+ }
1773
+ }
1774
+
1775
+ /**
1776
+ * 캐릭터 안드로이드 캐시 아이템 옵션 정보
1777
+ */
1778
+ class CharacterAndroidCashItemEquipmentOptionDto {
1779
+ /**
1780
+ * 옵션 타입
1781
+ */
1782
+ optionType;
1783
+ /**
1784
+ * 옵션 값
1785
+ */
1786
+ optionValue;
1787
+ constructor(obj) {
1788
+ const { option_type, option_value } = obj;
1789
+ this.optionType = option_type;
1790
+ this.optionValue = option_value;
1791
+ }
1792
+ }
1793
+
1794
+ /**
1795
+ * 캐릭터 안드로이드 캐시 아이템 컬러링프리즘 정보
1796
+ */
1797
+ class CharacterAndroidCashItemEquipmentColoringPrismDto {
1798
+ /**
1799
+ * 컬러링프리즘 색상 범위
1800
+ */
1801
+ colorRange;
1802
+ /**
1803
+ * 컬러링프리즘 색조
1804
+ */
1805
+ hue;
1806
+ /**
1807
+ * 컬러링프리즘 채도
1808
+ */
1809
+ saturation;
1810
+ /**
1811
+ * 컬러링프리즘 명도
1812
+ */
1813
+ value;
1814
+ constructor(obj) {
1815
+ const { color_range, hue, saturation, value } = obj;
1816
+ this.colorRange = color_range;
1817
+ this.hue = hue;
1818
+ this.saturation = saturation;
1819
+ this.value = value;
1820
+ }
1821
+ }
1822
+
1823
+ /**
1824
+ * 캐릭터 안드로이드 캐시 아이템 장착 정보
1825
+ */
1826
+ class CharacterAndroidCashItemEquipmentDto {
1827
+ /**
1828
+ * 안드로이드 캐시 아이템 부위 명
1829
+ */
1830
+ cashItemEquipmentPart;
1831
+ /**
1832
+ * 안드로이드 캐시 아이템 슬롯 위치
1833
+ */
1834
+ cashItemEquipmentSlot;
1835
+ /**
1836
+ * 안드로이드 캐시 아이템 명
1837
+ */
1838
+ cashItemName;
1839
+ /**
1840
+ * 안드로이드 캐시 아이템 아이콘
1841
+ */
1842
+ cashItemIcon;
1843
+ /**
1844
+ * 안드로이드 캐시 아이템 설명
1845
+ */
1846
+ cashItemDescription;
1847
+ /**
1848
+ * 안드로이드 캐시 아이템 옵션
1849
+ */
1850
+ cashItemOption;
1851
+ /**
1852
+ * 안드로이드 캐시 아이템 유효 기간 (KST)
1853
+ */
1854
+ dateExpire;
1855
+ /**
1856
+ * 안드로이드 캐시 아이템 옵션 유효 기간 (KST, 시간 단위 데이터로 분은 일괄 0으로 표기)
1857
+ */
1858
+ dateOptionExpire;
1859
+ /**
1860
+ * 안드로이드 캐시 아이템 라벨 정보 (스페셜라벨, 레드라벨, 블랙라벨, 마스터라벨)
1861
+ */
1862
+ cashItemLabel;
1863
+ /**
1864
+ * 안드로이드 캐시 아이템 컬러링프리즘 정보
1865
+ */
1866
+ cashItemColoringPrism;
1867
+ constructor(obj) {
1868
+ const { cash_item_equipment_part, cash_item_equipment_slot, cash_item_name, cash_item_icon, cash_item_description, cash_item_option, date_expire, date_option_expire, cash_item_label, cash_item_coloring_prism, } = obj;
1869
+ this.cashItemEquipmentPart = cash_item_equipment_part;
1870
+ this.cashItemEquipmentSlot = cash_item_equipment_slot;
1871
+ this.cashItemName = cash_item_name;
1872
+ this.cashItemIcon = cash_item_icon;
1873
+ this.cashItemDescription = cash_item_description;
1874
+ this.cashItemOption = cash_item_option.map(option => new CharacterAndroidCashItemEquipmentOptionDto(option));
1875
+ this.dateExpire = new Date(date_expire);
1876
+ this.dateOptionExpire = new Date(date_option_expire);
1877
+ this.cashItemLabel = cash_item_label;
1878
+ this.cashItemColoringPrism = new CharacterAndroidCashItemEquipmentColoringPrismDto(cash_item_coloring_prism);
1879
+ }
1880
+ }
1881
+
1882
+ /**
1883
+ * 캐릭터 안드로이드 장비 정보
1884
+ */
1885
+ class CharacterAndroidEquipmentDto {
1886
+ /**
1887
+ * 조회 기준일
1888
+ */
1889
+ date;
1890
+ /**
1891
+ * 안드로이드 명
1892
+ */
1893
+ androidName;
1894
+ /**
1895
+ * 안드로이드 닉네임
1896
+ */
1897
+ androidNickname;
1898
+ /**
1899
+ * 안드로이드 아이콘
1900
+ */
1901
+ androidIcon;
1902
+ /**
1903
+ * 안드로이드 아이템 설명
1904
+ */
1905
+ androidDescription;
1906
+ /**
1907
+ * 안드로이드 헤어 정보
1908
+ */
1909
+ androidHair;
1910
+ /**
1911
+ * 안드로이드 성형 정보
1912
+ */
1913
+ androidFace;
1914
+ /**
1915
+ * 안드로이드 피부 명
1916
+ */
1917
+ androidSkinName;
1918
+ /**
1919
+ * 안드로이드 캐시 아이템 장착 정보
1920
+ */
1921
+ androidCashItemEquipment;
1922
+ /**
1923
+ * 안드로이드 이어센서 클립 적용 여부
1924
+ */
1925
+ androidEarSensorClipFlag;
1926
+ constructor(obj) {
1927
+ const { date, android_name, android_nickname, android_icon, android_description, android_hair, android_face, android_skin_name, android_cash_item_equipment, android_ear_sensor_clip_flag, } = obj;
1928
+ this.date = new Date(date);
1929
+ this.androidName = android_name;
1930
+ this.androidNickname = android_nickname;
1931
+ this.androidIcon = android_icon;
1932
+ this.androidDescription = android_description;
1933
+ this.androidHair = new CharacterAndroidEquipmentHairDto(android_hair);
1934
+ this.androidFace = new CharacterAndroidEquipmentFaceDto(android_face);
1935
+ this.androidSkinName = android_skin_name;
1936
+ this.androidCashItemEquipment = android_cash_item_equipment.map(equipment => new CharacterAndroidCashItemEquipmentDto(equipment));
1937
+ this.androidEarSensorClipFlag = android_ear_sensor_clip_flag;
1938
+ }
1939
+ }
1940
+
1941
+ /**
1942
+ * 캐릭터 펫 장비 아이템 옵션 정보
1943
+ */
1944
+ class CharacterPetEquipmentItemOptionDto {
1945
+ /**
1946
+ * 옵션 정보
1947
+ */
1948
+ optionType;
1949
+ /**
1950
+ * 옵션 값
1951
+ */
1952
+ optionValue;
1953
+ constructor(obj) {
1954
+ const { option_type, option_value } = obj;
1955
+ this.optionType = option_type;
1956
+ this.optionValue = option_value;
1957
+ }
1958
+ }
1959
+
1960
+ /**
1961
+ * 캐릭터 펫 장비 아이템 정보
1962
+ */
1963
+ class CharacterPetEquipmentItemDto {
1964
+ /**
1965
+ * 아이템 명
1966
+ */
1967
+ itemName;
1968
+ /**
1969
+ * 아이템 아이콘
1970
+ */
1971
+ itemIcon;
1972
+ /**
1973
+ * 아이템 설명
1974
+ */
1975
+ itemDescription;
1976
+ /**
1977
+ * 아이템 표기상 옵션
1978
+ */
1979
+ itemOption;
1980
+ /**
1981
+ * 업그레이드 횟수
1982
+ */
1983
+ scrollUpgrade;
1984
+ /**
1985
+ * 업그레이드 가능 횟수
1986
+ */
1987
+ scrollUpgradeable;
1988
+ constructor(obj) {
1989
+ const { item_name, item_icon, item_description, item_option, scroll_upgrade, scroll_upgradeable, } = obj;
1990
+ this.itemName = item_name;
1991
+ this.itemIcon = item_icon;
1992
+ this.itemDescription = item_description;
1993
+ this.itemOption = item_option.map(option => new CharacterPetEquipmentItemOptionDto(option));
1994
+ this.scrollUpgrade = scroll_upgrade;
1995
+ this.scrollUpgradeable = scroll_upgradeable;
1996
+ }
1997
+ }
1998
+
1999
+ /**
2000
+ * 캐릭터 펫 장비 자동 스킬 정보
2001
+ */
2002
+ class CharacterPetEquipmentAutoSkillDto {
2003
+ /**
2004
+ * 첫 번째 슬롯에 등록된 자동 스킬
2005
+ */
2006
+ skill1;
2007
+ /**
2008
+ * 첫 번째 슬롯에 등록된 자동 아이콘
2009
+ */
2010
+ skill1Icon;
2011
+ /**
2012
+ * 두 번째 슬롯에 등록된 자동 스킬
2013
+ */
2014
+ skill2;
2015
+ /**
2016
+ * 두 번째 슬롯에 등록된 자동 아이콘
2017
+ */
2018
+ skill2Icon;
2019
+ constructor(obj) {
2020
+ const { skill_1, skill_1_icon, skill_2, skill_2_icon, } = obj;
2021
+ this.skill1 = skill_1;
2022
+ this.skill1Icon = skill_1_icon;
2023
+ this.skill2 = skill_2;
2024
+ this.skill2Icon = skill_2_icon;
2025
+ }
2026
+ }
2027
+
2028
+ /**
2029
+ * 캐릭터 펫 장비 정보
2030
+ */
2031
+ class CharacterPetEquipmentDto {
2032
+ /**
2033
+ * 조회 기준일
2034
+ */
2035
+ date;
2036
+ /**
2037
+ * 펫1 명
2038
+ */
2039
+ pet1Name;
2040
+ /**
2041
+ * 펫1 닉네임
2042
+ */
2043
+ pet1Nickname;
2044
+ /**
2045
+ * 펫1 아이콘
2046
+ */
2047
+ pet1Icon;
2048
+ /**
2049
+ * 펫1 설명
2050
+ */
2051
+ pet1Description;
2052
+ /**
2053
+ * 펫1 장착 정보
2054
+ */
2055
+ pet1Equipment;
2056
+ /**
2057
+ * 펫1 펫 버프 자동스킬 정보
2058
+ */
2059
+ pet1AutoSkill;
2060
+ /**
2061
+ * 펫1 원더 펫 종류
2062
+ */
2063
+ pet1PetType;
2064
+ /**
2065
+ * 펫1 펫 보유 스킬
2066
+ */
2067
+ pet1Skill;
2068
+ /**
2069
+ * 펫1 마법의 시간 (KST, 시간 단위 데이터로 분은 일괄 0으로 표기)
2070
+ */
2071
+ pet1DateExpire;
2072
+ /**
2073
+ * 펫2 명
2074
+ */
2075
+ pet2Name;
2076
+ /**
2077
+ * 펫2 닉네임
2078
+ */
2079
+ pet2Nickname;
2080
+ /**
2081
+ * 펫2 아이콘
2082
+ */
2083
+ pet2Icon;
2084
+ /**
2085
+ * 펫2 설명
2086
+ */
2087
+ pet2Description;
2088
+ /**
2089
+ * 펫2 장착 정보
2090
+ */
2091
+ pet2Equipment;
2092
+ /**
2093
+ * 펫2 펫 버프 자동스킬 정보
2094
+ */
2095
+ pet2AutoSkill;
2096
+ /**
2097
+ * 펫2 원더 펫 종류
2098
+ */
2099
+ pet2PetType;
2100
+ /**
2101
+ * 펫2 펫 보유 스킬
2102
+ */
2103
+ pet2Skill;
2104
+ /*
2105
+ * 펫2 마법의 시간 (KST, 시간 단위 데이터로 분은 일괄 0으로 표기)
2106
+ */
2107
+ pet2DateExpire;
2108
+ /**
2109
+ * 펫3 명
2110
+ */
2111
+ pet3Name;
2112
+ /**
2113
+ * 펫3 닉네임
2114
+ */
2115
+ pet3Nickname;
2116
+ /**
2117
+ * 펫3 아이콘
2118
+ */
2119
+ pet3Icon;
2120
+ /**
2121
+ * 펫3 설명
2122
+ */
2123
+ pet3Description;
2124
+ /**
2125
+ * 펫3 장착 정보
2126
+ */
2127
+ pet3Equipment;
2128
+ /**
2129
+ * 펫3 펫 버프 자동스킬 정보
2130
+ */
2131
+ pet3AutoSkill;
2132
+ /**
2133
+ * 펫3 원더 펫 종류
2134
+ */
2135
+ pet3PetType;
2136
+ /**
2137
+ * 펫3 펫 보유 스킬
2138
+ */
2139
+ pet3Skill;
2140
+ /*
2141
+ * 펫3 마법의 시간 (KST, 시간 단위 데이터로 분은 일괄 0으로 표기)
2142
+ */
2143
+ pet3DateExpire;
2144
+ constructor(obj) {
2145
+ const { date, pet_1_name, pet_1_nickname, pet_1_icon, pet_1_description, pet_1_equipment, pet_1_auto_skill, pet_1_pet_type, pet_1_skill, pet_1_date_expire, pet_2_name, pet_2_nickname, pet_2_icon, pet_2_description, pet_2_equipment, pet_2_auto_skill, pet_2_pet_type, pet_2_skill, pet_2_date_expire, pet_3_name, pet_3_nickname, pet_3_icon, pet_3_description, pet_3_equipment, pet_3_auto_skill, pet_3_pet_type, pet_3_skill, pet_3_date_expire, } = obj;
2146
+ this.date = new Date(date);
2147
+ this.pet1Name = pet_1_name;
2148
+ this.pet1Nickname = pet_1_nickname;
2149
+ this.pet1Icon = pet_1_icon;
2150
+ this.pet1Description = pet_1_description;
2151
+ this.pet1Equipment = new CharacterPetEquipmentItemDto(pet_1_equipment);
2152
+ this.pet1AutoSkill = new CharacterPetEquipmentAutoSkillDto(pet_1_auto_skill);
2153
+ this.pet1PetType = pet_1_pet_type;
2154
+ this.pet1Skill = pet_1_skill;
2155
+ this.pet1DateExpire = new Date(pet_1_date_expire);
2156
+ this.pet2Name = pet_2_name;
2157
+ this.pet2Nickname = pet_2_nickname;
2158
+ this.pet2Icon = pet_2_icon;
2159
+ this.pet2Description = pet_2_description;
2160
+ this.pet2Equipment = new CharacterPetEquipmentItemDto(pet_2_equipment);
2161
+ this.pet2AutoSkill = new CharacterPetEquipmentAutoSkillDto(pet_2_auto_skill);
2162
+ this.pet2PetType = pet_2_pet_type;
2163
+ this.pet2Skill = pet_2_skill;
2164
+ this.pet2DateExpire = new Date(pet_2_date_expire);
2165
+ this.pet3Name = pet_3_name;
2166
+ this.pet3Nickname = pet_3_nickname;
2167
+ this.pet3Icon = pet_3_icon;
2168
+ this.pet3Description = pet_3_description;
2169
+ this.pet3Equipment = new CharacterPetEquipmentItemDto(pet_3_equipment);
2170
+ this.pet3AutoSkill = new CharacterPetEquipmentAutoSkillDto(pet_3_auto_skill);
2171
+ this.pet3PetType = pet_3_pet_type;
2172
+ this.pet3Skill = pet_3_skill;
2173
+ this.pet3DateExpire = new Date(pet_3_date_expire);
2174
+ }
2175
+ }
2176
+
2177
+ /**
2178
+ * 캐릭터 스킬 상세 정보
2179
+ */
2180
+ class CharacterSkillInfoDto {
2181
+ /**
2182
+ * 스킬 명
2183
+ */
2184
+ skillName;
2185
+ /**
2186
+ * 스킬 설명
2187
+ */
2188
+ skillDescription;
2189
+ /**
2190
+ * 스킬 레벨
2191
+ */
2192
+ skillLevel;
2193
+ /**
2194
+ * 스킬 레벨 별 효과 설명
2195
+ */
2196
+ skillEffect;
2197
+ /**
2198
+ * 스킬 아이콘
2199
+ */
2200
+ skillIcon;
2201
+ constructor(obj) {
2202
+ const { skill_name, skill_description, skill_level, skill_effect, skill_icon, } = obj;
2203
+ this.skillName = skill_name;
2204
+ this.skillDescription = skill_description;
2205
+ this.skillLevel = skill_level;
2206
+ this.skillEffect = skill_effect;
2207
+ this.skillIcon = skill_icon;
2208
+ }
2209
+ }
2210
+
2211
+ /**
2212
+ * 캐릭터 스킬 정보
2213
+ */
2214
+ class CharacterSkillDto {
2215
+ /**
2216
+ * 조회 기준일
2217
+ */
2218
+ date;
2219
+ /**
2220
+ * 캐릭터 직업
2221
+ */
2222
+ characterClass;
2223
+ /**
2224
+ * 스킬 전직 차수
2225
+ */
2226
+ characterSkillGrade;
2227
+ /**
2228
+ * 스킬 정보
2229
+ */
2230
+ characterSkill;
2231
+ constructor(obj) {
2232
+ const { date, character_class, character_skill_grade, character_skill, } = obj;
2233
+ this.date = new Date(date);
2234
+ this.characterClass = character_class;
2235
+ this.characterSkillGrade = character_skill_grade;
2236
+ this.characterSkill = character_skill.map(skill => new CharacterSkillInfoDto(skill));
2237
+ }
2238
+ }
2239
+
2240
+ /**
2241
+ * 캐릭터 링크 스킬 정보
2242
+ */
2243
+ class CharacterLinkSkillInfoDto {
2244
+ /**
2245
+ * 스킬 명
2246
+ */
2247
+ skillName;
2248
+ /**
2249
+ * 스킬 설명
2250
+ */
2251
+ skillDescription;
2252
+ /**
2253
+ * 스킬 레벨
2254
+ */
2255
+ skillLevel;
2256
+ /**
2257
+ * 스킬 효과
2258
+ */
2259
+ skillEffect;
2260
+ /**
2261
+ * 스킬 아이콘
2262
+ */
2263
+ skillIcon;
2264
+ constructor(obj) {
2265
+ const { skill_name, skill_description, skill_level, skill_effect, skill_icon, } = obj;
2266
+ this.skillName = skill_name;
2267
+ this.skillDescription = skill_description;
2268
+ this.skillLevel = skill_level;
2269
+ this.skillEffect = skill_effect;
2270
+ this.skillIcon = skill_icon;
2271
+ }
2272
+ }
2273
+
2274
+ /**
2275
+ * 캐릭터 링크 스킬 정보
2276
+ */
2277
+ class CharacterLinkSkillDto {
2278
+ /**
2279
+ * 조회 기준일
2280
+ */
2281
+ date;
2282
+ /**
2283
+ * 캐릭터 직업
2284
+ */
2285
+ characterClass;
2286
+ /**
2287
+ * 링크 스킬 정보
2288
+ */
2289
+ characterLinkSkill;
2290
+ /**
2291
+ * 내 링크 스킬 정보
2292
+ */
2293
+ characterOwnedLinkSkill;
2294
+ constructor(obj) {
2295
+ const { date, character_class, character_link_skill, character_owned_link_skill, } = obj;
2296
+ this.date = new Date(date);
2297
+ this.characterClass = character_class;
2298
+ this.characterLinkSkill = new CharacterLinkSkillInfoDto(character_link_skill);
2299
+ this.characterOwnedLinkSkill = new CharacterLinkSkillInfoDto(character_owned_link_skill);
2300
+ }
2301
+ }
2302
+
2303
+ /**
2304
+ * 캐릭터 V코어 정보
2305
+ */
2306
+ class CharacterVMatrixCodeEquipmentDto {
2307
+ /**
2308
+ * 슬롯 인덱스
2309
+ */
2310
+ slotId;
2311
+ /**
2312
+ * 슬롯 레벨
2313
+ */
2314
+ slotLevel;
2315
+ /**
2316
+ * 코어 명
2317
+ */
2318
+ vCoreName;
2319
+ /**
2320
+ * 코어 타입
2321
+ */
2322
+ vCoreType;
2323
+ /**
2324
+ * 코어 레벨
2325
+ */
2326
+ vCoreLevel;
2327
+ /**
2328
+ * 코어에 해당하는 스킬 명
2329
+ */
2330
+ vCoreSkill1;
2331
+ /**
2332
+ * (강화 코어인 경우) 코어에 해당하는 두 번째 스킬 명
2333
+ */
2334
+ vCoreSkill2;
2335
+ /**
2336
+ * (강화 코어인 경우) 코어에 해당하는 세 번째 스킬 명
2337
+ */
2338
+ vCoreSkill3;
2339
+ constructor(obj) {
2340
+ const { slot_id, slot_level, v_core_name, v_core_type, v_core_level, v_core_skill_1, v_core_skill_2, v_core_skill_3, } = obj;
2341
+ this.slotId = slot_id;
2342
+ this.slotLevel = slot_level;
2343
+ this.vCoreName = v_core_name;
2344
+ this.vCoreType = v_core_type;
2345
+ this.vCoreLevel = v_core_level;
2346
+ this.vCoreSkill1 = v_core_skill_1;
2347
+ this.vCoreSkill2 = v_core_skill_2;
2348
+ this.vCoreSkill3 = v_core_skill_3;
2349
+ }
2350
+ }
2351
+
2352
+ /**
2353
+ * 캐릭터 V매트릭스 정보
2354
+ */
2355
+ class CharacterVMatrixDto {
2356
+ /**
2357
+ * 조회 기준일
2358
+ */
2359
+ date;
2360
+ /**
2361
+ * 캐릭터 직업
2362
+ */
2363
+ characterClass;
2364
+ /**
2365
+ * V코어 정보
2366
+ */
2367
+ characterVCoreEquipment;
2368
+ /**
2369
+ * 캐릭터 잔여 매트릭스 강화 포인트
2370
+ */
2371
+ characterVMatrixRemainSlotUpgradePoint;
2372
+ constructor(obj) {
2373
+ const { date, character_class, character_v_core_equipment, character_v_matrix_remain_slot_upgrade_point, } = obj;
2374
+ this.date = new Date(date);
2375
+ this.characterClass = character_class;
2376
+ this.characterVCoreEquipment = character_v_core_equipment.map(equipment => new CharacterVMatrixCodeEquipmentDto(equipment));
2377
+ this.characterVMatrixRemainSlotUpgradePoint = character_v_matrix_remain_slot_upgrade_point;
2378
+ }
2379
+ }
2380
+
2381
+ /**
2382
+ * 연결된 HEXA 스킬 정보
2383
+ */
2384
+ class CharacterHexaMatrixEquipmentLinkedSkillDto {
2385
+ /**
2386
+ * HEXA 스킬 명
2387
+ */
2388
+ hexaSkillId;
2389
+ constructor(obj) {
2390
+ const { hexa_skill_id } = obj;
2391
+ this.hexaSkillId = hexa_skill_id;
2392
+ }
2393
+ }
2394
+
2395
+ /**
2396
+ * 캐릭터 HEXA 코어 정보
2397
+ */
2398
+ class CharacterHexaMatrixEquipmentDto {
2399
+ /**
2400
+ * 코어 명
2401
+ */
2402
+ hexaCoreName;
2403
+ /**
2404
+ * 코어 레벨
2405
+ */
2406
+ hexaCoreLevel;
2407
+ /**
2408
+ * 코어 타입
2409
+ */
2410
+ hexaCoreType;
2411
+ /**
2412
+ * 연결된 스킬 목록
2413
+ */
2414
+ linkedSkill;
2415
+ constructor(obj) {
2416
+ const { hexa_core_name, hexa_core_level, hexa_core_type, linked_skill, } = obj;
2417
+ this.hexaCoreName = hexa_core_name;
2418
+ this.hexaCoreLevel = hexa_core_level;
2419
+ this.hexaCoreType = hexa_core_type;
2420
+ this.linkedSkill = linked_skill.map(skill => new CharacterHexaMatrixEquipmentLinkedSkillDto(skill));
2421
+ }
2422
+ }
2423
+
2424
+ /**
2425
+ * 캐릭터 HEXA 코어 정보
2426
+ */
2427
+ class CharacterHexaMatrixDto {
2428
+ /**
2429
+ * 조회 기준일
2430
+ */
2431
+ date;
2432
+ /**
2433
+ * HEXA 코어 정보
2434
+ */
2435
+ characterHexaCoreEquipment;
2436
+ constructor(obj) {
2437
+ const { date, character_hexa_core_equipment } = obj;
2438
+ this.date = new Date(date);
2439
+ this.characterHexaCoreEquipment = character_hexa_core_equipment.map(equipment => new CharacterHexaMatrixEquipmentDto(equipment));
2440
+ }
2441
+ }
2442
+
2443
+ /**
2444
+ * 캐릭터 도장 정보
2445
+ */
2446
+ class CharacterDojangDto {
2447
+ /**
2448
+ * 조회 기준일
2449
+ */
2450
+ date;
2451
+ /**
2452
+ * 캐릭터 직업
2453
+ */
2454
+ characterClass;
2455
+ /**
2456
+ * 월드 명
2457
+ */
2458
+ worldName;
2459
+ /**
2460
+ * 무릉도장 최고 기록 층수
2461
+ */
2462
+ dojangBestFloor;
2463
+ /**
2464
+ * 무릉도장 최고 기록 달성 일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
2465
+ */
2466
+ dateDojangRecord;
2467
+ /**
2468
+ * 무릉도장 최고 층수 클리어에 걸린 시간 (초)
2469
+ */
2470
+ dojangBestTime;
2471
+ constructor(obj) {
2472
+ const { date, character_class, world_name, dojang_best_floor, date_dojang_record, dojang_best_time, } = obj;
2473
+ this.date = new Date(date);
2474
+ this.characterClass = character_class;
2475
+ this.worldName = world_name;
2476
+ this.dojangBestFloor = dojang_best_floor;
2477
+ this.dateDojangRecord = new Date(date_dojang_record);
2478
+ this.dojangBestTime = dojang_best_time;
2479
+ }
2480
+ }
2481
+
2482
+ /**
2483
+ * 캐릭터 HEXA 스탯 코어 정보
2484
+ */
2485
+ class CharacterHexaMatrixStatCoreDto {
2486
+ /**
2487
+ * 슬롯 인덱스
2488
+ */
2489
+ slotId;
2490
+ /**
2491
+ * 메인 스탯 명
2492
+ */
2493
+ mainStatName;
2494
+ /**
2495
+ * 첫 번째 서브 명
2496
+ */
2497
+ subStatName1;
2498
+ /**
2499
+ * 두 번째 서브 명
2500
+ */
2501
+ subStatName2;
2502
+ /**
2503
+ * 메인 스탯 레벨
2504
+ */
2505
+ mainStatLevel;
2506
+ /**
2507
+ * 첫 번째 서브 레벨
2508
+ */
2509
+ subStatLevel1;
2510
+ /**
2511
+ * 두 번째 서브 레벨
2512
+ */
2513
+ subStatLevel2;
2514
+ /**
2515
+ * 스탯 코어 등급
2516
+ */
2517
+ statGrade;
2518
+ constructor(obj) {
2519
+ const { slot_id, main_stat_name, sub_stat_name_1, sub_stat_name_2, main_stat_level, sub_stat_level_1, sub_stat_level_2, stat_grade, } = obj;
2520
+ this.slotId = slot_id;
2521
+ this.mainStatName = main_stat_name;
2522
+ this.subStatName1 = sub_stat_name_1;
2523
+ this.subStatName2 = sub_stat_name_2;
2524
+ this.mainStatLevel = main_stat_level;
2525
+ this.subStatLevel1 = sub_stat_level_1;
2526
+ this.subStatLevel2 = sub_stat_level_2;
2527
+ this.statGrade = stat_grade;
2528
+ }
2529
+ }
2530
+
2531
+ /**
2532
+ * 캐릭터 HEXA 스탯 코어 정보
2533
+ */
2534
+ class CharacterHexaMatrixStatDto {
2535
+ /**
2536
+ * 조회 기준일
2537
+ */
2538
+ date;
2539
+ /**
2540
+ * 캐릭터 직업
2541
+ */
2542
+ characterClass;
2543
+ /**
2544
+ * HEXA 스탯 코어 정보
2545
+ */
2546
+ characterHexaStatCore;
2547
+ /**
2548
+ * 프리셋 HEXA 스탯 코어 정보
2549
+ */
2550
+ presetHexaStatCore;
2551
+ constructor(obj) {
2552
+ const { date, character_class, character_hexa_stat_core, preset_hexa_stat_core, } = obj;
2553
+ this.date = new Date(date);
2554
+ this.characterClass = character_class;
2555
+ this.characterHexaStatCore = character_hexa_stat_core.map(core => new CharacterHexaMatrixStatCoreDto(core));
2556
+ this.presetHexaStatCore = preset_hexa_stat_core.map(core => new CharacterHexaMatrixStatCoreDto(core));
2557
+ }
2558
+ }
2559
+
2560
+ var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
2561
+
2562
+ var timezone$1 = {exports: {}};
2563
+
2564
+ (function (module, exports) {
2565
+ !function(t,e){module.exports=e();}(commonjsGlobal,(function(){var t={year:0,month:1,day:2,hour:3,minute:4,second:5},e={};return function(n,i,o){var r,a=function(t,n,i){void 0===i&&(i={});var o=new Date(t),r=function(t,n){void 0===n&&(n={});var i=n.timeZoneName||"short",o=t+"|"+i,r=e[o];return r||(r=new Intl.DateTimeFormat("en-US",{hour12:!1,timeZone:t,year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",timeZoneName:i}),e[o]=r),r}(n,i);return r.formatToParts(o)},u=function(e,n){for(var i=a(e,n),r=[],u=0;u<i.length;u+=1){var f=i[u],s=f.type,m=f.value,c=t[s];c>=0&&(r[c]=parseInt(m,10));}var d=r[3],l=24===d?0:d,h=r[0]+"-"+r[1]+"-"+r[2]+" "+l+":"+r[4]+":"+r[5]+":000",v=+e;return (o.utc(h).valueOf()-(v-=v%1e3))/6e4},f=i.prototype;f.tz=function(t,e){void 0===t&&(t=r);var n=this.utcOffset(),i=this.toDate(),a=i.toLocaleString("en-US",{timeZone:t}),u=Math.round((i-new Date(a))/1e3/60),f=o(a,{locale:this.$L}).$set("millisecond",this.$ms).utcOffset(15*-Math.round(i.getTimezoneOffset()/15)-u,!0);if(e){var s=f.utcOffset();f=f.add(n-s,"minute");}return f.$x.$timezone=t,f},f.offsetName=function(t){var e=this.$x.$timezone||o.tz.guess(),n=a(this.valueOf(),e,{timeZoneName:t}).find((function(t){return "timezonename"===t.type.toLowerCase()}));return n&&n.value};var s=f.startOf;f.startOf=function(t,e){if(!this.$x||!this.$x.$timezone)return s.call(this,t,e);var n=o(this.format("YYYY-MM-DD HH:mm:ss:SSS"),{locale:this.$L});return s.call(n,t,e).tz(this.$x.$timezone,!0)},o.tz=function(t,e,n){var i=n&&e,a=n||e||r,f=u(+o(),a);if("string"!=typeof t)return o(t).tz(a);var s=function(t,e,n){var i=t-60*e*1e3,o=u(i,n);if(e===o)return [i,e];var r=u(i-=60*(o-e)*1e3,n);return o===r?[i,o]:[t-60*Math.min(o,r)*1e3,Math.max(o,r)]}(o.utc(t,i).valueOf(),f,a),m=s[0],c=s[1],d=o(m).utcOffset(c);return d.$x.$timezone=a,d},o.tz.guess=function(){return Intl.DateTimeFormat().resolvedOptions().timeZone},o.tz.setDefault=function(t){r=t;};}}));
2566
+ }(timezone$1));
2567
+
2568
+ var timezone = timezone$1.exports;
2569
+
2570
+ var utc$1 = {exports: {}};
2571
+
2572
+ (function (module, exports) {
2573
+ !function(t,i){module.exports=i();}(commonjsGlobal,(function(){var t="minute",i=/[+-]\d\d(?::?\d\d)?/g,e=/([+-]|\d\d)/g;return function(s,f,n){var u=f.prototype;n.utc=function(t){var i={date:t,utc:!0,args:arguments};return new f(i)},u.utc=function(i){var e=n(this.toDate(),{locale:this.$L,utc:!0});return i?e.add(this.utcOffset(),t):e},u.local=function(){return n(this.toDate(),{locale:this.$L,utc:!1})};var o=u.parse;u.parse=function(t){t.utc&&(this.$u=!0),this.$utils().u(t.$offset)||(this.$offset=t.$offset),o.call(this,t);};var r=u.init;u.init=function(){if(this.$u){var t=this.$d;this.$y=t.getUTCFullYear(),this.$M=t.getUTCMonth(),this.$D=t.getUTCDate(),this.$W=t.getUTCDay(),this.$H=t.getUTCHours(),this.$m=t.getUTCMinutes(),this.$s=t.getUTCSeconds(),this.$ms=t.getUTCMilliseconds();}else r.call(this);};var a=u.utcOffset;u.utcOffset=function(s,f){var n=this.$utils().u;if(n(s))return this.$u?0:n(this.$offset)?a.call(this):this.$offset;if("string"==typeof s&&(s=function(t){void 0===t&&(t="");var s=t.match(i);if(!s)return null;var f=(""+s[0]).match(e)||["-",0,0],n=f[0],u=60*+f[1]+ +f[2];return 0===u?0:"+"===n?u:-u}(s),null===s))return this;var u=Math.abs(s)<=16?60*s:s,o=this;if(f)return o.$offset=u,o.$u=0===s,o;if(0!==s){var r=this.$u?this.toDate().getTimezoneOffset():-1*this.utcOffset();(o=this.local().add(u+r,t)).$offset=u,o.$x.$localOffset=r;}else o=this.utc();return o};var h=u.format;u.format=function(t){var i=t||(this.$u?"YYYY-MM-DDTHH:mm:ss[Z]":"");return h.call(this,i)},u.valueOf=function(){var t=this.$utils().u(this.$offset)?0:this.$offset+(this.$x.$localOffset||this.$d.getTimezoneOffset());return this.$d.valueOf()-6e4*t},u.isUTC=function(){return !!this.$u},u.toISOString=function(){return this.toDate().toISOString()},u.toString=function(){return this.toDate().toUTCString()};var l=u.toDate;u.toDate=function(t){return "s"===t&&this.$offset?n(this.format("YYYY-MM-DD HH:mm:ss:SSS")).toDate():l.call(this)};var c=u.diff;u.diff=function(t,i,e){if(t&&this.$u===t.$u)return c.call(this,t,i,e);var s=this.local(),f=n(t).local();return c.call(s,f,i,e)};}}));
2574
+ }(utc$1));
2575
+
2576
+ var utc = utc$1.exports;
2577
+
2578
+ /**
2579
+ * 유니온 정보
2580
+ */
2581
+ class UnionDto {
2582
+ /**
2583
+ * 조회 기준일
2584
+ */
2585
+ date;
2586
+ /**
2587
+ * 유니온 레벨
2588
+ */
2589
+ unionLevel;
2590
+ /**
2591
+ * 유니온 등급
2592
+ */
2593
+ unionGrade;
2594
+ constructor(obj) {
2595
+ const { date, union_level, union_grade, } = obj;
2596
+ this.date = new Date(date);
2597
+ this.unionLevel = union_level;
2598
+ this.unionGrade = union_grade;
2599
+ }
2600
+ }
2601
+
2602
+ /**
2603
+ * 유니온 공격대 배치 정보
2604
+ */
2605
+ class UnionRaiderInnerStatDto {
2606
+ /**
2607
+ * 공격대 배치 위치 (11시 방향부터 시계 방향 순서대로 0~7)
2608
+ */
2609
+ statFieldId;
2610
+ /**
2611
+ * 해당 지역 점령 효과
2612
+ */
2613
+ statFieldEffect;
2614
+ constructor(obj) {
2615
+ const { stat_field_id, stat_field_effect } = obj;
2616
+ this.statFieldId = stat_field_id;
2617
+ this.statFieldEffect = stat_field_effect;
2618
+ }
2619
+ }
2620
+
2621
+ /**
2622
+ * 유니온 블록이 차지하고 있는 영역 좌표들
2623
+ */
2624
+ class UnionRaiderBlockPositionDto {
2625
+ /**
2626
+ * 블록 X좌표
2627
+ */
2628
+ x;
2629
+ /**
2630
+ * 블록 Y좌표
2631
+ */
2632
+ y;
2633
+ constructor(obj) {
2634
+ const { x, y } = obj;
2635
+ this.x = x;
2636
+ this.y = y;
2637
+ }
2638
+ }
2639
+
2640
+ /**
2641
+ * 유니온 블록 기준점 좌표 정보
2642
+ */
2643
+ class UnionRaiderBlockControlPointDto {
2644
+ /**
2645
+ * 블록 기준점 X좌표
2646
+ */
2647
+ x;
2648
+ /**
2649
+ * 블록 기준점 Y좌표
2650
+ */
2651
+ y;
2652
+ constructor(obj) {
2653
+ const { x, y } = obj;
2654
+ this.x = x;
2655
+ this.y = y;
2656
+ }
2657
+ }
2658
+
2659
+ /**
2660
+ * 유니온 블록 정보
2661
+ */
2662
+ class UnionRaiderBlockDto {
2663
+ /**
2664
+ * 블록 모양 (전사, 마법사, 궁수, 도적, 해적, 메이플m, 하이브리드)
2665
+ */
2666
+ blockType;
2667
+ /**
2668
+ * 블록 해당 캐릭터 직업
2669
+ */
2670
+ blockClass;
2671
+ /**
2672
+ * 블록 해당 캐릭터 레벨
2673
+ */
2674
+ blockLevel;
2675
+ /**
2676
+ * 블록 기준점 좌표
2677
+ */
2678
+ blockControlPoint;
2679
+ /**
2680
+ * 블록이 차지하고 있는 영역 좌표들 (null:미 배치 시)
2681
+ */
2682
+ blockPosition;
2683
+ constructor(obj) {
2684
+ const { block_type, block_class, block_level, block_control_point, block_position, } = obj;
2685
+ this.blockType = block_type;
2686
+ this.blockClass = block_class;
2687
+ this.blockLevel = block_level;
2688
+ this.blockControlPoint = new UnionRaiderBlockControlPointDto(block_control_point);
2689
+ this.blockPosition = block_position.map(position => new UnionRaiderBlockPositionDto(position));
2690
+ }
2691
+ }
2692
+
2693
+ /**
2694
+ * 유니온 공격대 정보
2695
+ */
2696
+ class UnionRaiderDto {
2697
+ date;
2698
+ /**
2699
+ * 유니온 공격대원 효과
2700
+ */
2701
+ unionRaiderStat;
2702
+ /**
2703
+ * 유니온 공격대 점령 효과
2704
+ */
2705
+ unionOccupiedStat;
2706
+ /**
2707
+ * 유니온 공격대 배치
2708
+ */
2709
+ unionInnerStat;
2710
+ /**
2711
+ * 유니온 블록 정보
2712
+ */
2713
+ unionBlock;
2714
+ constructor(obj) {
2715
+ const { date, union_raider_stat, union_occupied_stat, union_inner_stat, union_block, } = obj;
2716
+ this.date = new Date(date);
2717
+ this.unionRaiderStat = union_raider_stat;
2718
+ this.unionOccupiedStat = union_occupied_stat;
2719
+ this.unionInnerStat = union_inner_stat.map(stat => new UnionRaiderInnerStatDto(stat));
2720
+ this.unionBlock = union_block.map(block => new UnionRaiderBlockDto(block));
2721
+ }
2722
+ }
2723
+
2724
+ /**
2725
+ * 길드 식별자 정보
2726
+ */
2727
+ class GuildDto {
2728
+ /**
2729
+ * 길드 식별자
2730
+ */
2731
+ oguildId;
2732
+ constructor(obj) {
2733
+ const { oguild_id } = obj;
2734
+ this.oguildId = oguild_id;
2735
+ }
2736
+ }
2737
+
2738
+ /**
2739
+ * 길드 스킬 정보
2740
+ */
2741
+ class GuildSkillDto {
2742
+ /**
2743
+ * 스킬 명
2744
+ */
2745
+ skillName;
2746
+ /**
2747
+ * 스킬 설명
2748
+ */
2749
+ skillDescription;
2750
+ /**
2751
+ * 스킬 레벨
2752
+ */
2753
+ skillLevel;
2754
+ /**
2755
+ * 스킬 레벨 별 효과
2756
+ */
2757
+ skillEffect;
2758
+ /**
2759
+ * 스킬 아이콘
2760
+ */
2761
+ skillIcon;
2762
+ constructor(obj) {
2763
+ const { skill_name, skill_description, skill_level, skill_effect, skill_icon } = obj;
2764
+ this.skillName = skill_name;
2765
+ this.skillDescription = skill_description;
2766
+ this.skillLevel = skill_level;
2767
+ this.skillEffect = skill_effect;
2768
+ this.skillIcon = skill_icon;
2769
+ }
2770
+ }
2771
+
2772
+ /**
2773
+ * 길드 기본 정보
2774
+ */
2775
+ class GuildBasicDto {
2776
+ /**
2777
+ * 조회 기준일
2778
+ */
2779
+ date;
2780
+ /**
2781
+ * 월드 명
2782
+ */
2783
+ worldName;
2784
+ /**
2785
+ * 길드 명
2786
+ */
2787
+ guildName;
2788
+ /**
2789
+ * 길드 레벨
2790
+ */
2791
+ guildLevel;
2792
+ /**
2793
+ * 길드 명성치
2794
+ */
2795
+ guildFame;
2796
+ /**
2797
+ * 길드 포인트(GP)
2798
+ */
2799
+ guildPoint;
2800
+ /**
2801
+ * 길드 마스터 캐릭터 명
2802
+ */
2803
+ guildMasterName;
2804
+ /**
2805
+ * 길드원 수
2806
+ */
2807
+ guildMemberCount;
2808
+ /**
2809
+ * 길드원 목록
2810
+ */
2811
+ guildMember;
2812
+ /**
2813
+ * 길드 스킬 목록
2814
+ */
2815
+ guildSkill;
2816
+ /**
2817
+ * 노블레스 스킬 목록
2818
+ */
2819
+ guildNoblessSkill;
2820
+ /**
2821
+ * 조합형 길드 마크
2822
+ */
2823
+ guildMark;
2824
+ /**
2825
+ * 커스텀 길드 마크 (base64 인코딩 형식)
2826
+ */
2827
+ guildMarkCustom;
2828
+ constructor(obj) {
2829
+ const { date, world_name, guild_name, guild_level, guild_fame, guild_point, guild_master_name, guild_member_count, guild_member, guild_skill, guild_nobless_skill, guild_mark, guild_mark_custom, } = obj;
2830
+ this.date = new Date(date);
2831
+ this.worldName = world_name;
2832
+ this.guildName = guild_name;
2833
+ this.guildLevel = guild_level;
2834
+ this.guildFame = guild_fame;
2835
+ this.guildPoint = guild_point;
2836
+ this.guildMasterName = guild_master_name;
2837
+ this.guildMemberCount = guild_member_count;
2838
+ this.guildMember = guild_member;
2839
+ this.guildSkill = guild_skill.map((skill) => new GuildSkillDto(skill));
2840
+ this.guildNoblessSkill = guild_nobless_skill.map((skill) => new GuildSkillDto(skill));
2841
+ this.guildMark = guild_mark;
2842
+ this.guildMarkCustom = guild_mark_custom;
2843
+ }
2844
+ }
2845
+
2846
+ /**
2847
+ * 종합 랭킹 정보
2848
+ */
2849
+ class OverallRankingDto {
2850
+ /**
2851
+ * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
2852
+ */
2853
+ date;
2854
+ /**
2855
+ * 종합 랭킹 순위
2856
+ */
2857
+ ranking;
2858
+ /**
2859
+ * 캐릭터 명
2860
+ */
2861
+ characterName;
2862
+ /**
2863
+ * 월드 명
2864
+ */
2865
+ worldName;
2866
+ /**
2867
+ * 직업 명
2868
+ */
2869
+ className;
2870
+ /**
2871
+ * 전직 직업 명
2872
+ */
2873
+ subClassName;
2874
+ /**
2875
+ * 캐릭터 레벨
2876
+ */
2877
+ characterLevel;
2878
+ /**
2879
+ * 캐릭터 경험치
2880
+ */
2881
+ characterExp;
2882
+ /**
2883
+ * 캐릭터 인기도
2884
+ */
2885
+ characterPopularity;
2886
+ /**
2887
+ * 길드 명
2888
+ */
2889
+ characterGuildName;
2890
+ constructor(obj) {
2891
+ const { date, ranking, character_name, world_name, class_name, sub_class_name, character_level, character_exp, character_popularity, character_guildname } = obj;
2892
+ this.date = new Date(date);
2893
+ this.ranking = ranking;
2894
+ this.characterName = character_name;
2895
+ this.worldName = world_name;
2896
+ this.className = class_name;
2897
+ this.subClassName = sub_class_name;
2898
+ this.characterLevel = character_level;
2899
+ this.characterExp = character_exp;
2900
+ this.characterPopularity = character_popularity;
2901
+ this.characterGuildName = character_guildname;
2902
+ }
2903
+ }
2904
+
2905
+ /**
2906
+ * 종합 랭킹 응답 정보
2907
+ */
2908
+ class OverallRankingResponseDto {
2909
+ /**
2910
+ * 종합 랭킹 정보
2911
+ */
2912
+ ranking;
2913
+ constructor(obj) {
2914
+ const { ranking } = obj;
2915
+ this.ranking = ranking.map(rank => new OverallRankingDto(rank));
2916
+ }
2917
+ }
2918
+
2919
+ /**
2920
+ * 유니온 랭킹 정보
2921
+ */
2922
+ class UnionRankingDto {
2923
+ /**
2924
+ * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
2925
+ */
2926
+ date;
2927
+ /**
2928
+ * 유니온 랭킹 순위
2929
+ */
2930
+ ranking;
2931
+ /**
2932
+ * 캐릭터 명
2933
+ */
2934
+ characterName;
2935
+ /**
2936
+ * 월드 명
2937
+ */
2938
+ worldName;
2939
+ /**
2940
+ * 직업 명
2941
+ */
2942
+ className;
2943
+ /**
2944
+ * 전직 직업 명
2945
+ */
2946
+ subClassName;
2947
+ /**
2948
+ * 유니온 레벨
2949
+ */
2950
+ unionLevel;
2951
+ /**
2952
+ * 유니온 파워
2953
+ */
2954
+ unionPower;
2955
+ constructor(obj) {
2956
+ const { date, ranking, character_name, world_name, class_name, sub_class_name, union_level, union_power, } = obj;
2957
+ this.date = new Date(date);
2958
+ this.ranking = ranking;
2959
+ this.characterName = character_name;
2960
+ this.worldName = world_name;
2961
+ this.className = class_name;
2962
+ this.subClassName = sub_class_name;
2963
+ this.unionLevel = union_level;
2964
+ this.unionPower = union_power;
2965
+ }
2966
+ }
2967
+
2968
+ /**
2969
+ * 유니온 랭킹 응답 정보
2970
+ */
2971
+ class UnionRankingResponseDto {
2972
+ /**
2973
+ * 유니온 랭킹 정보
2974
+ */
2975
+ ranking;
2976
+ constructor(obj) {
2977
+ const { ranking } = obj;
2978
+ this.ranking = ranking.map(rank => new UnionRankingDto(rank));
2979
+ }
2980
+ }
2981
+
2982
+ /**
2983
+ * 길드 랭킹 정보
2984
+ */
2985
+ class GuildRankingDto {
2986
+ /**
2987
+ * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
2988
+ */
2989
+ date;
2990
+ /**
2991
+ * 길드 랭킹 순위
2992
+ */
2993
+ ranking;
2994
+ /**
2995
+ * 길드 명
2996
+ */
2997
+ guildName;
2998
+ /**
2999
+ * 월드 명
3000
+ */
3001
+ worldName;
3002
+ /**
3003
+ * 길드 레벨
3004
+ */
3005
+ guildLevel;
3006
+ /**
3007
+ * 길드 마스터 캐릭터 명
3008
+ */
3009
+ guildMasterName;
3010
+ /**
3011
+ * 길드 마크
3012
+ */
3013
+ guildMark;
3014
+ /**
3015
+ * 길드 포인트
3016
+ */
3017
+ guildPoint;
3018
+ constructor(obj) {
3019
+ const { date, ranking, guild_name, world_name, guild_level, guild_master_name, guild_mark, guild_point } = obj;
3020
+ this.date = new Date(date);
3021
+ this.ranking = ranking;
3022
+ this.guildName = guild_name;
3023
+ this.worldName = world_name;
3024
+ this.guildLevel = guild_level;
3025
+ this.guildMasterName = guild_master_name;
3026
+ this.guildMark = guild_mark;
3027
+ this.guildPoint = guild_point;
3028
+ }
3029
+ }
3030
+
3031
+ /**
3032
+ * 길드 랭킹 응답 정보
3033
+ */
3034
+ class GuildRankingResponseDto {
3035
+ /**
3036
+ * 길드 랭킹 정보
3037
+ */
3038
+ ranking;
3039
+ constructor(obj) {
3040
+ const { ranking } = obj;
3041
+ this.ranking = ranking.map(rank => new GuildRankingDto(rank));
3042
+ }
3043
+ }
3044
+
3045
+ /**
3046
+ * 무릉도장 랭킹 정보
3047
+ */
3048
+ class DojangRankingDto {
3049
+ /**
3050
+ * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
3051
+ */
3052
+ date;
3053
+ /**
3054
+ * 무릉도장 랭킹 순위
3055
+ */
3056
+ ranking;
3057
+ /**
3058
+ * 캐릭터 명
3059
+ */
3060
+ characterName;
3061
+ /**
3062
+ * 월드 명
3063
+ */
3064
+ worldName;
3065
+ /**
3066
+ * 직업 명
3067
+ */
3068
+ className;
3069
+ /**
3070
+ * 전직 직업 명
3071
+ */
3072
+ subClassName;
3073
+ /**
3074
+ * 캐릭터 레벨
3075
+ */
3076
+ characterLevel;
3077
+ /**
3078
+ * 무릉도장 구간
3079
+ */
3080
+ dojangFloor;
3081
+ /**
3082
+ * 무릉도장 클리어 시간 기록 (초 단위)
3083
+ */
3084
+ dojangTimeRecord;
3085
+ constructor(obj) {
3086
+ const { date, ranking, character_name, world_name, class_name, sub_class_name, character_level, dojang_floor, dojang_time_record } = obj;
3087
+ this.date = new Date(date);
3088
+ this.ranking = ranking;
3089
+ this.characterName = character_name;
3090
+ this.worldName = world_name;
3091
+ this.className = class_name;
3092
+ this.subClassName = sub_class_name;
3093
+ this.characterLevel = character_level;
3094
+ this.dojangFloor = dojang_floor;
3095
+ this.dojangTimeRecord = dojang_time_record;
3096
+ }
3097
+ }
3098
+
3099
+ /**
3100
+ * 무릉도장 랭킹 응답 정보
3101
+ */
3102
+ class DojangRankingResponseDto {
3103
+ /**
3104
+ * 길드 랭킹 정보
3105
+ */
3106
+ ranking;
3107
+ constructor(obj) {
3108
+ const { ranking } = obj;
3109
+ this.ranking = ranking.map(rank => new DojangRankingDto(rank));
3110
+ }
3111
+ }
3112
+
3113
+ /**
3114
+ * 더 시드 랭킹 정보
3115
+ */
3116
+ class TheSeedRankingDto {
3117
+ /**
3118
+ * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
3119
+ */
3120
+ date;
3121
+ /**
3122
+ * 더 시드 랭킹 순위
3123
+ */
3124
+ ranking;
3125
+ /**
3126
+ * 캐릭터 명
3127
+ */
3128
+ characterName;
3129
+ /**
3130
+ * 월드 명
3131
+ */
3132
+ worldName;
3133
+ /**
3134
+ * 직업 명
3135
+ */
3136
+ className;
3137
+ /**
3138
+ * 전직 직업 명
3139
+ */
3140
+ subClassName;
3141
+ /**
3142
+ * 캐릭터 레벨
3143
+ */
3144
+ characterLevel;
3145
+ /**
3146
+ * 더 시드 도달 층
3147
+ */
3148
+ theSeedFloor;
3149
+ /**
3150
+ * 더 시드 클리어 시간 기록 (초 단위)
3151
+ */
3152
+ theSeedTimeRecord;
3153
+ constructor(obj) {
3154
+ const { date, ranking, character_name, world_name, class_name, sub_class_name, character_level, theseed_floor, theseed_time_record } = obj;
3155
+ this.date = new Date(date);
3156
+ this.ranking = ranking;
3157
+ this.characterName = character_name;
3158
+ this.worldName = world_name;
3159
+ this.className = class_name;
3160
+ this.subClassName = sub_class_name;
3161
+ this.characterLevel = character_level;
3162
+ this.theSeedFloor = theseed_floor;
3163
+ this.theSeedTimeRecord = theseed_time_record;
3164
+ }
3165
+ }
3166
+
3167
+ /**
3168
+ * 더 시드 랭킹 응답 정보
3169
+ */
3170
+ class TheSeedRankingResponseDto {
3171
+ /**
3172
+ * 더 시드 랭킹 정보
3173
+ */
3174
+ ranking;
3175
+ constructor(obj) {
3176
+ const { ranking } = obj;
3177
+ this.ranking = ranking.map(rank => new TheSeedRankingDto(rank));
3178
+ }
3179
+ }
3180
+
3181
+ /**
3182
+ * 업적 랭킹 정보
3183
+ */
3184
+ class AchievementRankingDto {
3185
+ /**
3186
+ * 랭킹 업데이트 일자 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
3187
+ */
3188
+ date;
3189
+ /**
3190
+ * 업적 랭킹 순위
3191
+ */
3192
+ ranking;
3193
+ /**
3194
+ * 캐릭터 명
3195
+ */
3196
+ characterName;
3197
+ /**
3198
+ * 월드 명
3199
+ */
3200
+ worldName;
3201
+ /**
3202
+ * 직업 명
3203
+ */
3204
+ className;
3205
+ /**
3206
+ * 전직 직업 명
3207
+ */
3208
+ subClassName;
3209
+ /**
3210
+ * 업적 등급
3211
+ */
3212
+ trophyGrade;
3213
+ /**
3214
+ * 업적 점수
3215
+ */
3216
+ trophyScore;
3217
+ constructor(obj) {
3218
+ const { date, ranking, character_name, world_name, class_name, sub_class_name, trophy_grade, trophy_score } = obj;
3219
+ this.date = new Date(date);
3220
+ this.ranking = ranking;
3221
+ this.characterName = character_name;
3222
+ this.worldName = world_name;
3223
+ this.className = class_name;
3224
+ this.subClassName = sub_class_name;
3225
+ this.trophyGrade = trophy_grade;
3226
+ this.trophyScore = trophy_score;
3227
+ }
3228
+ }
3229
+
3230
+ /**
3231
+ * 업적 랭킹 응답 정보
3232
+ */
3233
+ class AchievementRankingResponseDto {
3234
+ /**
3235
+ * 업적 랭킹 정보
3236
+ */
3237
+ ranking;
3238
+ constructor(obj) {
3239
+ const { ranking } = obj;
3240
+ this.ranking = ranking.map(rank => new AchievementRankingDto(rank));
3241
+ }
3242
+ }
3243
+
3244
+ dayjs.extend(timezone);
3245
+ dayjs.extend(utc);
3246
+ /**
3247
+ * MapleStory OpenAPI client.<br>
3248
+ * This is an implementation of <a href="https://openapi.nexon.com/game/maplestory">MapleStory API</a>
3249
+ */
3250
+ class MapleStoryApi {
3251
+ apiKey;
3252
+ static BASE_URL = 'https://open.api.nexon.com/';
3253
+ static kstOffset = 540;
3254
+ timeout;
3255
+ constructor(apiKey) {
3256
+ this.apiKey = apiKey;
3257
+ this.timeout = 5000;
3258
+ }
3259
+ //#region 캐릭터 정보 조회
3260
+ /**
3261
+ * 캐릭터 식별자(ocid)를 조회합니다.
3262
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3263
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3264
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3265
+ *
3266
+ * @param characterName 캐릭터 명
3267
+ */
3268
+ async getCharacter(characterName) {
3269
+ try {
3270
+ const path = 'maplestory/v1/id';
3271
+ const response = await axios.get(path, {
3272
+ baseURL: MapleStoryApi.BASE_URL,
3273
+ timeout: this.timeout,
3274
+ headers: this.buildHeaders(),
3275
+ params: {
3276
+ character_name: characterName
3277
+ }
3278
+ });
3279
+ return new CharacterDto(response.data);
3280
+ }
3281
+ catch (e) {
3282
+ if (e instanceof AxiosError) {
3283
+ const errorBody = e.response.data;
3284
+ throw new MapleStoryApiError(errorBody);
3285
+ }
3286
+ throw e;
3287
+ }
3288
+ }
3289
+ /**
3290
+ * 기본 정보를 조회합니다.
3291
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3292
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3293
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3294
+ *
3295
+ * @param ocid 캐릭터 식별자
3296
+ * @param dateOptions 조회 기준일 (KST)
3297
+ */
3298
+ async getCharacterBasicInfo(ocid, dateOptions) {
3299
+ const query = {
3300
+ ocid: ocid,
3301
+ date: MapleStoryApi.toDateString({
3302
+ year: 2023,
3303
+ month: 12,
3304
+ day: 21
3305
+ }, dateOptions)
3306
+ };
3307
+ try {
3308
+ const path = 'maplestory/v1/character/basic';
3309
+ const response = await axios.get(path, {
3310
+ baseURL: MapleStoryApi.BASE_URL,
3311
+ timeout: this.timeout,
3312
+ headers: this.buildHeaders(),
3313
+ params: query
3314
+ });
3315
+ return new CharacterBasicDto(response.data);
3316
+ }
3317
+ catch (e) {
3318
+ if (e instanceof AxiosError) {
3319
+ const errorBody = e.response.data;
3320
+ throw new MapleStoryApiError(errorBody);
3321
+ }
3322
+ throw e;
3323
+ }
3324
+ }
3325
+ /**
3326
+ * 인기도 정보를 조회합니다.
3327
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3328
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3329
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3330
+ *
3331
+ * @param ocid 캐릭터 식별자
3332
+ * @param dateOptions 조회 기준일 (KST)
3333
+ */
3334
+ async getCharacterPopularity(ocid, dateOptions) {
3335
+ const query = {
3336
+ ocid: ocid,
3337
+ date: MapleStoryApi.toDateString({
3338
+ year: 2023,
3339
+ month: 12,
3340
+ day: 21
3341
+ }, dateOptions)
3342
+ };
3343
+ try {
3344
+ const path = 'maplestory/v1/character/popularity';
3345
+ const response = await axios.get(path, {
3346
+ baseURL: MapleStoryApi.BASE_URL,
3347
+ timeout: this.timeout,
3348
+ headers: this.buildHeaders(),
3349
+ params: query
3350
+ });
3351
+ return new CharacterPopularityDto(response.data);
3352
+ }
3353
+ catch (e) {
3354
+ if (e instanceof AxiosError) {
3355
+ const errorBody = e.response.data;
3356
+ throw new MapleStoryApiError(errorBody);
3357
+ }
3358
+ throw e;
3359
+ }
3360
+ }
3361
+ /**
3362
+ * 종합 능력치 정보를 조회합니다.
3363
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3364
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3365
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3366
+ *
3367
+ * @param ocid 캐릭터 식별자
3368
+ * @param dateOptions 조회 기준일 (KST)
3369
+ */
3370
+ async getCharacterStat(ocid, dateOptions) {
3371
+ const query = {
3372
+ ocid: ocid,
3373
+ date: MapleStoryApi.toDateString({
3374
+ year: 2023,
3375
+ month: 12,
3376
+ day: 21
3377
+ }, dateOptions)
3378
+ };
3379
+ try {
3380
+ const path = 'maplestory/v1/character/stat';
3381
+ const response = await axios.get(path, {
3382
+ baseURL: MapleStoryApi.BASE_URL,
3383
+ timeout: this.timeout,
3384
+ headers: this.buildHeaders(),
3385
+ params: query
3386
+ });
3387
+ return new CharacterStatDto(response.data);
3388
+ }
3389
+ catch (e) {
3390
+ if (e instanceof AxiosError) {
3391
+ const errorBody = e.response.data;
3392
+ throw new MapleStoryApiError(errorBody);
3393
+ }
3394
+ throw e;
3395
+ }
3396
+ }
3397
+ /**
3398
+ * 하이퍼스탯 정보를 조회합니다.
3399
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3400
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3401
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3402
+ *
3403
+ * @param ocid 캐릭터 식별자
3404
+ * @param dateOptions 조회 기준일 (KST)
3405
+ */
3406
+ async getCharacterHyperStat(ocid, dateOptions) {
3407
+ const query = {
3408
+ ocid: ocid,
3409
+ date: MapleStoryApi.toDateString({
3410
+ year: 2023,
3411
+ month: 12,
3412
+ day: 21
3413
+ }, dateOptions)
3414
+ };
3415
+ try {
3416
+ const path = 'maplestory/v1/character/hyper-stat';
3417
+ const response = await axios.get(path, {
3418
+ baseURL: MapleStoryApi.BASE_URL,
3419
+ timeout: this.timeout,
3420
+ headers: this.buildHeaders(),
3421
+ params: query
3422
+ });
3423
+ return new CharacterHyperStatDto(response.data);
3424
+ }
3425
+ catch (e) {
3426
+ if (e instanceof AxiosError) {
3427
+ const errorBody = e.response.data;
3428
+ throw new MapleStoryApiError(errorBody);
3429
+ }
3430
+ throw e;
3431
+ }
3432
+ }
3433
+ /**
3434
+ * 성향 정보를 조회합니다.
3435
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3436
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3437
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3438
+ *
3439
+ * @param ocid 캐릭터 식별자
3440
+ * @param dateOptions 조회 기준일 (KST)
3441
+ */
3442
+ async getCharacterPropensity(ocid, dateOptions) {
3443
+ const query = {
3444
+ ocid: ocid,
3445
+ date: MapleStoryApi.toDateString({
3446
+ year: 2023,
3447
+ month: 12,
3448
+ day: 21
3449
+ }, dateOptions)
3450
+ };
3451
+ try {
3452
+ const path = 'maplestory/v1/character/propensity';
3453
+ const response = await axios.get(path, {
3454
+ baseURL: MapleStoryApi.BASE_URL,
3455
+ timeout: this.timeout,
3456
+ headers: this.buildHeaders(),
3457
+ params: query
3458
+ });
3459
+ return new CharacterPropensityDto(response.data);
3460
+ }
3461
+ catch (e) {
3462
+ if (e instanceof AxiosError) {
3463
+ const errorBody = e.response.data;
3464
+ throw new MapleStoryApiError(errorBody);
3465
+ }
3466
+ throw e;
3467
+ }
3468
+ }
3469
+ /**
3470
+ * 어빌리티 정보를 조회합니다.
3471
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3472
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3473
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3474
+ *
3475
+ * @param ocid 캐릭터 식별자
3476
+ * @param dateOptions 조회 기준일 (KST)
3477
+ */
3478
+ async getCharacterAbility(ocid, dateOptions) {
3479
+ const query = {
3480
+ ocid: ocid,
3481
+ date: MapleStoryApi.toDateString({
3482
+ year: 2023,
3483
+ month: 12,
3484
+ day: 21
3485
+ }, dateOptions)
3486
+ };
3487
+ try {
3488
+ const path = 'maplestory/v1/character/ability';
3489
+ const response = await axios.get(path, {
3490
+ baseURL: MapleStoryApi.BASE_URL,
3491
+ timeout: this.timeout,
3492
+ headers: this.buildHeaders(),
3493
+ params: query
3494
+ });
3495
+ return new CharacterAbilityDto(response.data);
3496
+ }
3497
+ catch (e) {
3498
+ if (e instanceof AxiosError) {
3499
+ const errorBody = e.response.data;
3500
+ throw new MapleStoryApiError(errorBody);
3501
+ }
3502
+ throw e;
3503
+ }
3504
+ }
3505
+ /**
3506
+ * 장착한 장비 중 캐시 장비를 제외한 나머지 장비 정보를 조회합니다.
3507
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3508
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3509
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3510
+ *
3511
+ * @param ocid 캐릭터 식별자
3512
+ * @param dateOptions 조회 기준일 (KST)
3513
+ */
3514
+ async getCharacterItemEquipment(ocid, dateOptions) {
3515
+ const query = {
3516
+ ocid: ocid,
3517
+ date: MapleStoryApi.toDateString({
3518
+ year: 2023,
3519
+ month: 12,
3520
+ day: 21
3521
+ }, dateOptions)
3522
+ };
3523
+ try {
3524
+ const path = 'maplestory/v1/character/item-equipment';
3525
+ const response = await axios.get(path, {
3526
+ baseURL: MapleStoryApi.BASE_URL,
3527
+ timeout: this.timeout,
3528
+ headers: this.buildHeaders(),
3529
+ params: query
3530
+ });
3531
+ return new CharacterItemEquipmentDto(response.data);
3532
+ }
3533
+ catch (e) {
3534
+ if (e instanceof AxiosError) {
3535
+ const errorBody = e.response.data;
3536
+ throw new MapleStoryApiError(errorBody);
3537
+ }
3538
+ throw e;
3539
+ }
3540
+ }
3541
+ /**
3542
+ * 장착한 캐시 장비 정보를 조회합니다.
3543
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3544
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3545
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3546
+ *
3547
+ * @param ocid 캐릭터 식별자
3548
+ * @param dateOptions 조회 기준일 (KST)
3549
+ */
3550
+ async getCharacterCashItemEquipment(ocid, dateOptions) {
3551
+ const query = {
3552
+ ocid: ocid,
3553
+ date: MapleStoryApi.toDateString({
3554
+ year: 2023,
3555
+ month: 12,
3556
+ day: 21
3557
+ }, dateOptions)
3558
+ };
3559
+ try {
3560
+ const path = 'maplestory/v1/character/cashitem-equipment';
3561
+ const response = await axios.get(path, {
3562
+ baseURL: MapleStoryApi.BASE_URL,
3563
+ timeout: this.timeout,
3564
+ headers: this.buildHeaders(),
3565
+ params: query
3566
+ });
3567
+ return new CharacterCashItemEquipmentDto(response.data);
3568
+ }
3569
+ catch (e) {
3570
+ if (e instanceof AxiosError) {
3571
+ const errorBody = e.response.data;
3572
+ throw new MapleStoryApiError(errorBody);
3573
+ }
3574
+ throw e;
3575
+ }
3576
+ }
3577
+ /**
3578
+ * 장착한 심볼 정보를 조회합니다.
3579
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3580
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3581
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3582
+ *
3583
+ * @param ocid 캐릭터 식별자
3584
+ * @param dateOptions 조회 기준일 (KST)
3585
+ */
3586
+ async getCharacterSymbolEquipment(ocid, dateOptions) {
3587
+ const query = {
3588
+ ocid: ocid,
3589
+ date: MapleStoryApi.toDateString({
3590
+ year: 2023,
3591
+ month: 12,
3592
+ day: 21
3593
+ }, dateOptions)
3594
+ };
3595
+ try {
3596
+ const path = 'maplestory/v1/character/symbol-equipment';
3597
+ const response = await axios.get(path, {
3598
+ baseURL: MapleStoryApi.BASE_URL,
3599
+ timeout: this.timeout,
3600
+ headers: this.buildHeaders(),
3601
+ params: query
3602
+ });
3603
+ return new CharacterSymbolEquipmentDto(response.data);
3604
+ }
3605
+ catch (e) {
3606
+ if (e instanceof AxiosError) {
3607
+ const errorBody = e.response.data;
3608
+ throw new MapleStoryApiError(errorBody);
3609
+ }
3610
+ throw e;
3611
+ }
3612
+ }
3613
+ /**
3614
+ * 적용받고 있는 세트 효과 정보를 조회합니다.
3615
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3616
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3617
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3618
+ *
3619
+ * @param ocid 캐릭터 식별자
3620
+ * @param dateOptions 조회 기준일 (KST)
3621
+ */
3622
+ async getCharacterSetEffect(ocid, dateOptions) {
3623
+ const query = {
3624
+ ocid: ocid,
3625
+ date: MapleStoryApi.toDateString({
3626
+ year: 2023,
3627
+ month: 12,
3628
+ day: 21
3629
+ }, dateOptions)
3630
+ };
3631
+ try {
3632
+ const path = 'maplestory/v1/character/set-effect';
3633
+ const response = await axios.get(path, {
3634
+ baseURL: MapleStoryApi.BASE_URL,
3635
+ timeout: this.timeout,
3636
+ headers: this.buildHeaders(),
3637
+ params: query
3638
+ });
3639
+ return new CharacterSetEffectDto(response.data);
3640
+ }
3641
+ catch (e) {
3642
+ if (e instanceof AxiosError) {
3643
+ const errorBody = e.response.data;
3644
+ throw new MapleStoryApiError(errorBody);
3645
+ }
3646
+ throw e;
3647
+ }
3648
+ }
3649
+ /**
3650
+ * 장착 중인 헤어, 성형, 피부 정보를 조회합니다.
3651
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3652
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3653
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3654
+ *
3655
+ * @param ocid 캐릭터 식별자
3656
+ * @param dateOptions 조회 기준일 (KST)
3657
+ */
3658
+ async getCharacterBeautyEquipment(ocid, dateOptions) {
3659
+ const query = {
3660
+ ocid: ocid,
3661
+ date: MapleStoryApi.toDateString({
3662
+ year: 2023,
3663
+ month: 12,
3664
+ day: 21
3665
+ }, dateOptions)
3666
+ };
3667
+ try {
3668
+ const path = 'maplestory/v1/character/beauty-equipment';
3669
+ const response = await axios.get(path, {
3670
+ baseURL: MapleStoryApi.BASE_URL,
3671
+ timeout: this.timeout,
3672
+ headers: this.buildHeaders(),
3673
+ params: query
3674
+ });
3675
+ return new CharacterBeautyEquipmentDto(response.data);
3676
+ }
3677
+ catch (e) {
3678
+ if (e instanceof AxiosError) {
3679
+ const errorBody = e.response.data;
3680
+ throw new MapleStoryApiError(errorBody);
3681
+ }
3682
+ throw e;
3683
+ }
3684
+ }
3685
+ /**
3686
+ * 장착한 안드로이드 정보를 조회합니다.
3687
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3688
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3689
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3690
+ *
3691
+ * @param ocid 캐릭터 식별자
3692
+ * @param dateOptions 조회 기준일 (KST)
3693
+ */
3694
+ async getCharacterAndroidEquipment(ocid, dateOptions) {
3695
+ const query = {
3696
+ ocid: ocid,
3697
+ date: MapleStoryApi.toDateString({
3698
+ year: 2023,
3699
+ month: 12,
3700
+ day: 21
3701
+ }, dateOptions)
3702
+ };
3703
+ try {
3704
+ const path = 'maplestory/v1/character/android-equipment';
3705
+ const response = await axios.get(path, {
3706
+ baseURL: MapleStoryApi.BASE_URL,
3707
+ timeout: this.timeout,
3708
+ headers: this.buildHeaders(),
3709
+ params: query
3710
+ });
3711
+ return new CharacterAndroidEquipmentDto(response.data);
3712
+ }
3713
+ catch (e) {
3714
+ if (e instanceof AxiosError) {
3715
+ const errorBody = e.response.data;
3716
+ throw new MapleStoryApiError(errorBody);
3717
+ }
3718
+ throw e;
3719
+ }
3720
+ }
3721
+ /**
3722
+ * 장착한 펫 및 펫 스킬, 장비 정보를 조회합니다.
3723
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3724
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3725
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3726
+ *
3727
+ * @param ocid 캐릭터 식별자
3728
+ * @param dateOptions 조회 기준일 (KST)
3729
+ */
3730
+ async getCharacterPetEquipment(ocid, dateOptions) {
3731
+ const query = {
3732
+ ocid: ocid,
3733
+ date: MapleStoryApi.toDateString({
3734
+ year: 2023,
3735
+ month: 12,
3736
+ day: 21
3737
+ }, dateOptions)
3738
+ };
3739
+ try {
3740
+ const path = 'maplestory/v1/character/pet-equipment';
3741
+ const response = await axios.get(path, {
3742
+ baseURL: MapleStoryApi.BASE_URL,
3743
+ timeout: this.timeout,
3744
+ headers: this.buildHeaders(),
3745
+ params: query
3746
+ });
3747
+ return new CharacterPetEquipmentDto(response.data);
3748
+ }
3749
+ catch (e) {
3750
+ if (e instanceof AxiosError) {
3751
+ const errorBody = e.response.data;
3752
+ throw new MapleStoryApiError(errorBody);
3753
+ }
3754
+ throw e;
3755
+ }
3756
+ }
3757
+ /**
3758
+ * 캐릭터 스킬과 하이퍼 스킬 정보를 조회합니다.
3759
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3760
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3761
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3762
+ *
3763
+ * @param ocid 캐릭터 식별자
3764
+ * @param characterSkillGrade 조회하고자 하는 전직 차수
3765
+ * - 0: 0차 스킬 및 제로 공용스킬
3766
+ * - 1: 1차 스킬
3767
+ * - 1.5: 1.5차 스킬
3768
+ * - 2: 2차 스킬
3769
+ * - 2.5: 2.5차 스킬
3770
+ * - 3: 3차 스킬
3771
+ * - 4: 4차 스킬 및 제로 알파/베타 스킬
3772
+ * - hyperpassive: 하이퍼 패시브 스킬
3773
+ * - hyperactive: 하이퍼 액티브 스킬
3774
+ * - 5: 5차 스킬
3775
+ * - 6: 6차 스킬
3776
+ * @param dateOptions 조회 기준일 (KST)
3777
+ */
3778
+ async getCharacterSkill(ocid, characterSkillGrade, dateOptions) {
3779
+ const query = {
3780
+ ocid: ocid,
3781
+ character_skill_grade: '0',
3782
+ date: MapleStoryApi.toDateString({
3783
+ year: 2023,
3784
+ month: 12,
3785
+ day: 21
3786
+ }, dateOptions)
3787
+ };
3788
+ try {
3789
+ const path = 'maplestory/v1/character/skill';
3790
+ const response = await axios.get(path, {
3791
+ baseURL: MapleStoryApi.BASE_URL,
3792
+ timeout: this.timeout,
3793
+ headers: this.buildHeaders(),
3794
+ params: query
3795
+ });
3796
+ return new CharacterSkillDto(response.data);
3797
+ }
3798
+ catch (e) {
3799
+ if (e instanceof AxiosError) {
3800
+ const errorBody = e.response.data;
3801
+ throw new MapleStoryApiError(errorBody);
3802
+ }
3803
+ throw e;
3804
+ }
3805
+ }
3806
+ /**
3807
+ * 장착 링크 스킬 정보를 조회합니다.
3808
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3809
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3810
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3811
+ *
3812
+ * @param ocid 캐릭터 식별자
3813
+ * @param dateOptions 조회 기준일 (KST)
3814
+ */
3815
+ async getCharacterLinkSkill(ocid, dateOptions) {
3816
+ const query = {
3817
+ ocid: ocid,
3818
+ date: MapleStoryApi.toDateString({
3819
+ year: 2023,
3820
+ month: 12,
3821
+ day: 21
3822
+ }, dateOptions)
3823
+ };
3824
+ try {
3825
+ const path = 'maplestory/v1/character/link-skill';
3826
+ const response = await axios.get(path, {
3827
+ baseURL: MapleStoryApi.BASE_URL,
3828
+ timeout: this.timeout,
3829
+ headers: this.buildHeaders(),
3830
+ params: query
3831
+ });
3832
+ return new CharacterLinkSkillDto(response.data);
3833
+ }
3834
+ catch (e) {
3835
+ if (e instanceof AxiosError) {
3836
+ const errorBody = e.response.data;
3837
+ throw new MapleStoryApiError(errorBody);
3838
+ }
3839
+ throw e;
3840
+ }
3841
+ }
3842
+ /**
3843
+ * V매트릭스 슬롯 정보와 장착한 V코어 정보를 조회합니다.
3844
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3845
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3846
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3847
+ *
3848
+ * @param ocid 캐릭터 식별자
3849
+ * @param dateOptions 조회 기준일 (KST)
3850
+ */
3851
+ async getCharacterVMatrix(ocid, dateOptions) {
3852
+ const query = {
3853
+ ocid: ocid,
3854
+ date: MapleStoryApi.toDateString({
3855
+ year: 2023,
3856
+ month: 12,
3857
+ day: 21
3858
+ }, dateOptions)
3859
+ };
3860
+ try {
3861
+ const path = 'maplestory/v1/character/vmatrix';
3862
+ const response = await axios.get(path, {
3863
+ baseURL: MapleStoryApi.BASE_URL,
3864
+ timeout: this.timeout,
3865
+ headers: this.buildHeaders(),
3866
+ params: query
3867
+ });
3868
+ return new CharacterVMatrixDto(response.data);
3869
+ }
3870
+ catch (e) {
3871
+ if (e instanceof AxiosError) {
3872
+ const errorBody = e.response.data;
3873
+ throw new MapleStoryApiError(errorBody);
3874
+ }
3875
+ throw e;
3876
+ }
3877
+ }
3878
+ /**
3879
+ * HEXA 매트릭스에 장착한 HEXA 코어 정보를 조회합니다.
3880
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3881
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3882
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3883
+ *
3884
+ * @param ocid 캐릭터 식별자
3885
+ * @param dateOptions 조회 기준일 (KST)
3886
+ */
3887
+ async getCharacterHexaMatrix(ocid, dateOptions) {
3888
+ const query = {
3889
+ ocid: ocid,
3890
+ date: MapleStoryApi.toDateString({
3891
+ year: 2023,
3892
+ month: 12,
3893
+ day: 21
3894
+ }, dateOptions)
3895
+ };
3896
+ try {
3897
+ const path = 'maplestory/v1/character/hexamatrix';
3898
+ const response = await axios.get(path, {
3899
+ baseURL: MapleStoryApi.BASE_URL,
3900
+ timeout: this.timeout,
3901
+ headers: this.buildHeaders(),
3902
+ params: query
3903
+ });
3904
+ return new CharacterHexaMatrixDto(response.data);
3905
+ }
3906
+ catch (e) {
3907
+ if (e instanceof AxiosError) {
3908
+ const errorBody = e.response.data;
3909
+ throw new MapleStoryApiError(errorBody);
3910
+ }
3911
+ throw e;
3912
+ }
3913
+ }
3914
+ /**
3915
+ * HEXA 매트릭스에 설정한 HEXA 스탯 정보를 조회합니다.
3916
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3917
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3918
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3919
+ *
3920
+ * @param ocid 캐릭터 식별자
3921
+ * @param dateOptions 조회 기준일 (KST)
3922
+ */
3923
+ async getCharacterHexaMatrixStat(ocid, dateOptions) {
3924
+ const query = {
3925
+ ocid: ocid,
3926
+ date: MapleStoryApi.toDateString({
3927
+ year: 2023,
3928
+ month: 12,
3929
+ day: 21
3930
+ }, dateOptions)
3931
+ };
3932
+ try {
3933
+ const path = 'maplestory/v1/character/hexamatrix-stat';
3934
+ const response = await axios.get(path, {
3935
+ baseURL: MapleStoryApi.BASE_URL,
3936
+ timeout: this.timeout,
3937
+ headers: this.buildHeaders(),
3938
+ params: query
3939
+ });
3940
+ return new CharacterHexaMatrixStatDto(response.data);
3941
+ }
3942
+ catch (e) {
3943
+ if (e instanceof AxiosError) {
3944
+ const errorBody = e.response.data;
3945
+ throw new MapleStoryApiError(errorBody);
3946
+ }
3947
+ throw e;
3948
+ }
3949
+ }
3950
+ /**
3951
+ * 캐릭터 무릉도장 최고 기록 정보를 조회합니다.
3952
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3953
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3954
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3955
+ *
3956
+ * @param ocid 캐릭터 식별자
3957
+ * @param dateOptions 조회 기준일 (KST)
3958
+ */
3959
+ async getCharacterDojang(ocid, dateOptions) {
3960
+ const query = {
3961
+ ocid: ocid,
3962
+ date: MapleStoryApi.toDateString({
3963
+ year: 2023,
3964
+ month: 12,
3965
+ day: 21
3966
+ }, dateOptions)
3967
+ };
3968
+ try {
3969
+ const path = 'maplestory/v1/character/dojang';
3970
+ const response = await axios.get(path, {
3971
+ baseURL: MapleStoryApi.BASE_URL,
3972
+ timeout: this.timeout,
3973
+ headers: this.buildHeaders(),
3974
+ params: query
3975
+ });
3976
+ return new CharacterDojangDto(response.data);
3977
+ }
3978
+ catch (e) {
3979
+ if (e instanceof AxiosError) {
3980
+ const errorBody = e.response.data;
3981
+ throw new MapleStoryApiError(errorBody);
3982
+ }
3983
+ throw e;
3984
+ }
3985
+ }
3986
+ //#endregion
3987
+ //#region 유니온 정보 조회
3988
+ /**
3989
+ * 유니온 정보를 조회합니다.
3990
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
3991
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
3992
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
3993
+ *
3994
+ * @param ocid 캐릭터 식별자
3995
+ * @param dateOption 조회 기준일 (KST)
3996
+ */
3997
+ async getUnionInfo(ocid, dateOption) {
3998
+ const query = {
3999
+ ocid: ocid,
4000
+ date: MapleStoryApi.toDateString({
4001
+ year: 2023,
4002
+ month: 12,
4003
+ day: 21
4004
+ }, dateOption)
4005
+ };
4006
+ try {
4007
+ const path = 'maplestory/v1/user/union';
4008
+ const response = await axios.get(path, {
4009
+ baseURL: MapleStoryApi.BASE_URL,
4010
+ timeout: this.timeout,
4011
+ headers: this.buildHeaders(),
4012
+ params: query
4013
+ });
4014
+ return new UnionDto(response.data);
4015
+ }
4016
+ catch (e) {
4017
+ if (e instanceof AxiosError) {
4018
+ const errorBody = e.response.data;
4019
+ throw new MapleStoryApiError(errorBody);
4020
+ }
4021
+ throw e;
4022
+ }
4023
+ }
4024
+ /**
4025
+ * 유니온 공격대 정보를 조회합니다.
4026
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
4027
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다
4028
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
4029
+ *
4030
+ * @param ocid 캐릭터 식별자
4031
+ * @param dateOption 조회 기준일 (KST)
4032
+ */
4033
+ async getUnionRaiderInfo(ocid, dateOption) {
4034
+ ({
4035
+ ocid: ocid,
4036
+ date: MapleStoryApi.toDateString({
4037
+ year: 2023,
4038
+ month: 12,
4039
+ day: 21
4040
+ }, dateOption)
4041
+ });
4042
+ try {
4043
+ const path = 'maplestory/v1/user/union-raider';
4044
+ const response = await axios.get(path, {
4045
+ baseURL: MapleStoryApi.BASE_URL,
4046
+ timeout: this.timeout,
4047
+ headers: this.buildHeaders(),
4048
+ params: {
4049
+ ocid,
4050
+ date: dateOption,
4051
+ }
4052
+ });
4053
+ return new UnionRaiderDto(response.data);
4054
+ }
4055
+ catch (e) {
4056
+ if (e instanceof AxiosError) {
4057
+ const errorBody = e.response.data;
4058
+ throw new MapleStoryApiError(errorBody);
4059
+ }
4060
+ throw e;
4061
+ }
4062
+ }
4063
+ //#endregion
4064
+ //#region 길드 정보 조회
4065
+ /**
4066
+ * 길드 식별자(oguild_id) 정보를 조회합니다.
4067
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
4068
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다.
4069
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
4070
+ *
4071
+ * @param guildName 길드 명
4072
+ * @param worldName 월드 명
4073
+ */
4074
+ async getGuild(guildName, worldName) {
4075
+ try {
4076
+ const path = 'maplestory/v1/guild/id';
4077
+ const response = await axios.get(path, {
4078
+ baseURL: MapleStoryApi.BASE_URL,
4079
+ timeout: this.timeout,
4080
+ headers: this.buildHeaders(),
4081
+ params: {
4082
+ guild_name: guildName,
4083
+ world_name: worldName,
4084
+ },
4085
+ });
4086
+ return new GuildDto(response.data);
4087
+ }
4088
+ catch (e) {
4089
+ if (e instanceof AxiosError) {
4090
+ const errorBody = e.response.data;
4091
+ throw new MapleStoryApiError(errorBody);
4092
+ }
4093
+ throw e;
4094
+ }
4095
+ }
4096
+ /**
4097
+ * 길드 기본 정보를 조회합니다.
4098
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
4099
+ * - 오전 1시부터 전일 데이터 조회가 가능합니다.
4100
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
4101
+ *
4102
+ * @param guildId 길드 식별자
4103
+ * @param dateOptions 조회 기준일 (KST)
4104
+ */
4105
+ async getGuildBasic(guildId, dateOptions) {
4106
+ const query = {
4107
+ oguild_id: guildId,
4108
+ date: MapleStoryApi.toDateString({
4109
+ year: 2023,
4110
+ month: 12,
4111
+ day: 21,
4112
+ }, dateOptions),
4113
+ };
4114
+ try {
4115
+ const path = 'maplestory/v1/guild/basic';
4116
+ const response = await axios.get(path, {
4117
+ baseURL: MapleStoryApi.BASE_URL,
4118
+ timeout: this.timeout,
4119
+ headers: this.buildHeaders(),
4120
+ params: query,
4121
+ });
4122
+ return new GuildBasicDto(response.data);
4123
+ }
4124
+ catch (e) {
4125
+ if (e instanceof AxiosError) {
4126
+ const errorBody = e.response.data;
4127
+ throw new MapleStoryApiError(errorBody);
4128
+ }
4129
+ throw e;
4130
+ }
261
4131
  }
262
- async getCubeResult(count, parameter) {
4132
+ async getCubeHistory(count, parameter) {
263
4133
  const query = {
264
4134
  count,
265
4135
  };
@@ -267,26 +4137,151 @@ class MapleStoryApi {
267
4137
  query.cursor = parameter;
268
4138
  }
269
4139
  else if (typeof parameter === 'object') {
270
- const { year, month, day } = parameter;
271
- if (year <= 2022 && month <= 11 && day < 25) {
272
- throw new Error('You can only retrieve data after 2022-11-25.');
4140
+ query.date = MapleStoryApi.toDateString({
4141
+ year: 2022,
4142
+ month: 11,
4143
+ day: 25
4144
+ }, parameter);
4145
+ }
4146
+ try {
4147
+ const path = 'maplestory/v1/history/cube';
4148
+ const response = await axios.get(path, {
4149
+ baseURL: MapleStoryApi.BASE_URL,
4150
+ timeout: this.timeout,
4151
+ headers: this.buildHeaders(),
4152
+ params: query
4153
+ });
4154
+ return new CubeHistoryResponseDto(response.data);
4155
+ }
4156
+ catch (e) {
4157
+ if (e instanceof AxiosError) {
4158
+ const errorBody = e.response.data;
4159
+ throw new MapleStoryApiError(errorBody);
273
4160
  }
274
- const date = dayjs(`${year}-${month}-${day}`).utcOffset(MapleStoryApi.kstOffset);
275
- query.date = date.format('YYYY-MM-DD');
4161
+ throw e;
276
4162
  }
277
- else {
278
- const now = dayjs().utcOffset(MapleStoryApi.kstOffset);
279
- query.date = now.format('YYYY-MM-DD');
4163
+ }
4164
+ //#endregion
4165
+ //#region 랭킹 정보 조회
4166
+ /**
4167
+ * 종합 랭킹 정보를 조회합니다.
4168
+ * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
4169
+ * - 오전 8시 30분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
4170
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
4171
+ *
4172
+ * @param filterOptions 검색 기준
4173
+ * @param dateOptions 조회 기준일 (KST).
4174
+ *
4175
+ */
4176
+ async getOverallRanking(filterOptions, dateOptions) {
4177
+ const query = {
4178
+ date: MapleStoryApi.toDateString({
4179
+ year: 2023,
4180
+ month: 12,
4181
+ day: 22,
4182
+ }, dateOptions),
4183
+ };
4184
+ if (filterOptions) {
4185
+ const { worldName, worldType, characterClass, ocid, page } = filterOptions;
4186
+ query.world_name = worldName;
4187
+ query.world_type = worldType;
4188
+ query.class = characterClass;
4189
+ query.ocid = ocid;
4190
+ query.page = page;
280
4191
  }
281
4192
  try {
282
- const path = 'openapi/maplestory/v1/cube-use-results';
4193
+ const path = 'maplestory/v1/ranking/overall';
283
4194
  const response = await axios.get(path, {
284
- baseURL: MapleStoryApi.baseUrl,
4195
+ baseURL: MapleStoryApi.BASE_URL,
285
4196
  timeout: this.timeout,
286
4197
  headers: this.buildHeaders(),
287
4198
  params: query
288
4199
  });
289
- return new CubeHistoryResponseDto(response.data);
4200
+ return new OverallRankingResponseDto(response.data);
4201
+ }
4202
+ catch (e) {
4203
+ if (e instanceof AxiosError) {
4204
+ const errorBody = e.response.data;
4205
+ throw new MapleStoryApiError(errorBody);
4206
+ }
4207
+ throw e;
4208
+ }
4209
+ }
4210
+ /**
4211
+ * 유니온 랭킹 정보를 조회합니다.
4212
+ * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
4213
+ * - 오전 8시 30분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
4214
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
4215
+ *
4216
+ * @param filterOptions 검색 기준
4217
+ * @param dateOptions 조회 기준일 (KST)
4218
+ */
4219
+ async getUnionRanking(filterOptions, dateOptions) {
4220
+ const query = {
4221
+ date: MapleStoryApi.toDateString({
4222
+ year: 2023,
4223
+ month: 12,
4224
+ day: 22
4225
+ }, dateOptions)
4226
+ };
4227
+ if (filterOptions) {
4228
+ const { worldName, ocid, page } = filterOptions;
4229
+ query.world_name = worldName;
4230
+ query.ocid = ocid;
4231
+ query.page = page;
4232
+ }
4233
+ try {
4234
+ const path = 'maplestory/v1/ranking/union';
4235
+ const response = await axios.get(path, {
4236
+ baseURL: MapleStoryApi.BASE_URL,
4237
+ timeout: this.timeout,
4238
+ headers: this.buildHeaders(),
4239
+ params: query,
4240
+ });
4241
+ return new UnionRankingResponseDto(response.data);
4242
+ }
4243
+ catch (e) {
4244
+ if (e instanceof AxiosError) {
4245
+ const errorBody = e.response.data;
4246
+ throw new MapleStoryApiError(errorBody);
4247
+ }
4248
+ throw e;
4249
+ }
4250
+ }
4251
+ /**
4252
+ * 길드 랭킹 정보를 조회합니다.
4253
+ * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
4254
+ * - 오전 8시 30분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
4255
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
4256
+ *
4257
+ * @param filterOptions 검색 기준
4258
+ * @param dateOptions 조회 기준일 (KST)
4259
+ */
4260
+ async getGuildRanking(filterOptions, dateOptions) {
4261
+ const query = {
4262
+ date: MapleStoryApi.toDateString({
4263
+ year: 2023,
4264
+ month: 12,
4265
+ day: 22
4266
+ }, dateOptions),
4267
+ ranking_type: 0,
4268
+ };
4269
+ if (filterOptions) {
4270
+ const { worldName, rankingType, ocid, page } = filterOptions;
4271
+ query.world_name = worldName;
4272
+ query.ranking_type = rankingType;
4273
+ query.ocid = ocid;
4274
+ query.page = page;
4275
+ }
4276
+ try {
4277
+ const path = 'maplestory/v1/ranking/guild';
4278
+ const response = await axios.get(path, {
4279
+ baseURL: MapleStoryApi.BASE_URL,
4280
+ timeout: this.timeout,
4281
+ headers: this.buildHeaders(),
4282
+ params: query,
4283
+ });
4284
+ return new GuildRankingResponseDto(response.data);
290
4285
  }
291
4286
  catch (e) {
292
4287
  if (e instanceof AxiosError) {
@@ -296,8 +4291,137 @@ class MapleStoryApi {
296
4291
  throw e;
297
4292
  }
298
4293
  }
4294
+ /**
4295
+ * 무릉도장 랭킹 정보를 조회합니다.
4296
+ * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
4297
+ * - 오전 8시 30분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
4298
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
4299
+ *
4300
+ * @param filterOptions 검색 기준
4301
+ * @param dateOptions 조회 기준일 (KST)
4302
+ */
4303
+ async getDojangRanking(filterOptions, dateOptions) {
4304
+ const query = {
4305
+ date: MapleStoryApi.toDateString({
4306
+ year: 2023,
4307
+ month: 12,
4308
+ day: 22
4309
+ }, dateOptions),
4310
+ difficulty: 0,
4311
+ };
4312
+ if (filterOptions) {
4313
+ const { worldName, difficulty, characterClass, ocid, page } = filterOptions;
4314
+ query.world_name = worldName;
4315
+ query.difficulty = difficulty;
4316
+ query.class = characterClass;
4317
+ query.ocid = ocid;
4318
+ query.page = page;
4319
+ }
4320
+ try {
4321
+ const path = 'maplestory/v1/ranking/dojang';
4322
+ const response = await axios.get(path, {
4323
+ baseURL: MapleStoryApi.BASE_URL,
4324
+ timeout: this.timeout,
4325
+ headers: this.buildHeaders(),
4326
+ params: query
4327
+ });
4328
+ return new DojangRankingResponseDto(response.data);
4329
+ }
4330
+ catch (e) {
4331
+ if (e instanceof AxiosError) {
4332
+ const errorBody = e.response.data;
4333
+ throw new MapleStoryApiError(errorBody);
4334
+ }
4335
+ throw e;
4336
+ }
4337
+ }
4338
+ /**
4339
+ * 더 시드 랭킹 정보를 조회합니다.
4340
+ * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
4341
+ * - 오전 8시 30분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
4342
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
4343
+ *
4344
+ * @param filterOptions 검색 기준
4345
+ * @param dateOptions 조회 기준일 (KST)
4346
+ */
4347
+ async getSeedRanking(filterOptions, dateOptions) {
4348
+ const query = {
4349
+ date: MapleStoryApi.toDateString({
4350
+ year: 2023,
4351
+ month: 12,
4352
+ day: 22
4353
+ }, dateOptions),
4354
+ };
4355
+ if (filterOptions) {
4356
+ const { worldName, ocid, page } = filterOptions;
4357
+ query.world_name = worldName;
4358
+ query.ocid = ocid;
4359
+ query.page = page;
4360
+ }
4361
+ try {
4362
+ const path = 'maplestory/v1/ranking/theseed';
4363
+ const response = await axios.get(path, {
4364
+ baseURL: MapleStoryApi.BASE_URL,
4365
+ timeout: this.timeout,
4366
+ headers: this.buildHeaders(),
4367
+ params: query,
4368
+ });
4369
+ return new TheSeedRankingResponseDto(response.data);
4370
+ }
4371
+ catch (e) {
4372
+ if (e instanceof AxiosError) {
4373
+ const errorBody = e.response.data;
4374
+ throw new MapleStoryApiError(errorBody);
4375
+ }
4376
+ throw e;
4377
+ }
4378
+ }
4379
+ /**
4380
+ * 업적 랭킹 정보를 조회합니다.
4381
+ * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
4382
+ * - 오전 8시 30분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
4383
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
4384
+ *
4385
+ * @param filterOptions 검색 기준
4386
+ * @param dateOptions 조회 기준일 (KST)
4387
+ */
4388
+ async getAchievementRanking(filterOptions, dateOptions) {
4389
+ const query = {
4390
+ date: MapleStoryApi.toDateString({
4391
+ year: 2023,
4392
+ month: 12,
4393
+ day: 22
4394
+ }, dateOptions),
4395
+ };
4396
+ if (filterOptions) {
4397
+ const { ocid, page } = filterOptions;
4398
+ query.ocid = ocid;
4399
+ query.page = page;
4400
+ }
4401
+ try {
4402
+ const path = 'maplestory/v1/ranking/achievement';
4403
+ const response = await axios.get(path, {
4404
+ baseURL: MapleStoryApi.BASE_URL,
4405
+ timeout: this.timeout,
4406
+ headers: this.buildHeaders(),
4407
+ params: query
4408
+ });
4409
+ return new AchievementRankingResponseDto(response.data);
4410
+ }
4411
+ catch (e) {
4412
+ if (e instanceof AxiosError) {
4413
+ const errorBody = e.response.data;
4414
+ throw new MapleStoryApiError(errorBody);
4415
+ }
4416
+ throw e;
4417
+ }
4418
+ }
4419
+ //#endregion
299
4420
  /**
300
4421
  * 서버 점검 정보를 조회합니다.
4422
+ * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
4423
+ * - 오전 8시 30분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
4424
+ * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
301
4425
  */
302
4426
  async getInspectionInfo() {
303
4427
  const xmlBuilder = new xml2js.Builder();
@@ -334,9 +4458,24 @@ class MapleStoryApi {
334
4458
  }
335
4459
  buildHeaders() {
336
4460
  return {
337
- 'authorization': this.apiKey
4461
+ 'x-nxopen-api-key': this.apiKey
338
4462
  };
339
4463
  }
4464
+ static toDateString(minDateOptions, dateOptions) {
4465
+ let date;
4466
+ if (dateOptions) {
4467
+ const { year: minYear, month: minMonth, day: minDay } = minDateOptions;
4468
+ const { year, month, day } = dateOptions;
4469
+ if (year < minYear || (year === minYear && month < minMonth) || (year === minYear && month === minMonth && day < minDay)) {
4470
+ throw new Error(`You can only retrieve data after ${minYear}-${minMonth}-${minDay}.`);
4471
+ }
4472
+ date = dayjs(`${year}-${month}-${day}`).utcOffset(MapleStoryApi.kstOffset);
4473
+ }
4474
+ else {
4475
+ date = dayjs().utcOffset(MapleStoryApi.kstOffset);
4476
+ }
4477
+ return date.format('YYYY-MM-DD');
4478
+ }
340
4479
  }
341
4480
 
342
- export { CubeHistoryDto, CubeHistoryResponseDto, CubeResultOptionDto, InspectionInfoDto, MapleStoryApi, MapleStoryApiError, PotentialOptionGrade, potentialOptionGradeFromString };
4481
+ export { AchievementRankingDto, AchievementRankingResponseDto, CharacterAbilityDto, CharacterAbilityInfoDto, CharacterAndroidCashItemEquipmentColoringPrismDto, CharacterAndroidCashItemEquipmentDto, CharacterAndroidCashItemEquipmentOptionDto, CharacterAndroidEquipmentDto, CharacterAndroidEquipmentFaceDto, CharacterAndroidEquipmentHairDto, CharacterBasicDto, CharacterBeautyEquipmentDto, CharacterBeautyEquipmentFaceDto, CharacterBeautyEquipmentHairDto, CharacterCashItemEquipmentColoringPrismDto, CharacterCashItemEquipmentDto, CharacterCashItemEquipmentOptionDto, CharacterCashItemEquipmentPresetDto, CharacterDojangDto, CharacterDto, CharacterHexaMatrixDto, CharacterHexaMatrixEquipmentDto, CharacterHexaMatrixEquipmentLinkedSkillDto, CharacterHexaMatrixStatCoreDto, CharacterHexaMatrixStatDto, CharacterHyperStatDto, CharacterHyperStatInfoDto, CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto, CharacterLinkSkillDto, CharacterLinkSkillInfoDto, CharacterPetEquipmentAutoSkillDto, CharacterPetEquipmentDto, CharacterPetEquipmentItemDto, CharacterPetEquipmentItemOptionDto, CharacterPopularityDto, CharacterPropensityDto, CharacterSetEffectDto, CharacterSetEffectInfoDto, CharacterSetEffectOptionInfoDto, CharacterSkillDto, CharacterSkillInfoDto, CharacterStatDto, CharacterSymbolEquipmentDto, CharacterSymbolEquipmentInfoDto, CharacterVMatrixCodeEquipmentDto, CharacterVMatrixDto, CubeHistoryDto, CubeHistoryResponseDto, CubeResultOptionDto, DojangRankingDto, DojangRankingResponseDto, GuildBasicDto, GuildDto, GuildRankingDto, GuildRankingResponseDto, GuildSkillDto, InspectionInfoDto, MapleStoryApi, MapleStoryApiError, MapleStoryApiErrorCode, OverallRankingDto, OverallRankingResponseDto, PotentialOptionGrade, TheSeedRankingDto, TheSeedRankingResponseDto, UnionDto, UnionRaiderBlockControlPointDto, UnionRaiderBlockDto, UnionRaiderBlockPositionDto, UnionRaiderDto, UnionRaiderInnerStatDto, UnionRankingDto, UnionRankingResponseDto, potentialOptionGradeFromString };