maplestory-openapi 3.7.0 → 3.8.1

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 (84) hide show
  1. package/dist/cjs/index.js +5 -0
  2. package/dist/cjs/maplestory/api/common/dto/character/characterItemEquipment.js +3 -0
  3. package/dist/cjs/maplestory/api/common/dto/union/unionChampion.js +14 -0
  4. package/dist/cjs/maplestory/api/kms/dto/character/characterItemEquipment.js +2 -1
  5. package/dist/cjs/maplestory/api/kms/dto/union/unionChampion.js +8 -3
  6. package/dist/cjs/maplestory/api/kms/mapleStoryApi.js +26 -20
  7. package/dist/cjs/maplestory/api/msea/dto/character/characterAndroidEquipment.js +36 -3
  8. package/dist/cjs/maplestory/api/msea/dto/character/characterBasic.js +4 -10
  9. package/dist/cjs/maplestory/api/msea/dto/character/characterBeautyEquipment.js +24 -2
  10. package/dist/cjs/maplestory/api/msea/dto/character/characterCashItemEquipment.js +17 -1
  11. package/dist/cjs/maplestory/api/msea/dto/character/characterItemEquipment.js +100 -5
  12. package/dist/cjs/maplestory/api/msea/dto/union/unionChampion.js +82 -0
  13. package/dist/cjs/maplestory/api/msea/mapleStoryApi.js +32 -0
  14. package/dist/cjs/maplestory/api/msea/msea.js +5 -0
  15. package/dist/cjs/maplestory/api/tms/dto/character/characterAndroidEquipment.js +36 -3
  16. package/dist/cjs/maplestory/api/tms/dto/character/characterBasic.js +1 -1
  17. package/dist/cjs/maplestory/api/tms/dto/character/characterBeautyEquipment.js +24 -2
  18. package/dist/cjs/maplestory/api/tms/dto/character/characterCashItemEquipment.js +12 -1
  19. package/dist/cjs/maplestory/api/tms/dto/character/characterItemEquipment.js +84 -4
  20. package/dist/cjs/maplestory/api/tms/dto/union/unionChampion.js +79 -0
  21. package/dist/cjs/maplestory/api/tms/mapleStoryApi.js +32 -0
  22. package/dist/cjs/maplestory/api/tms/tms.js +5 -0
  23. package/dist/esm/index.js +2 -1
  24. package/dist/esm/maplestory/api/common/dto/character/characterItemEquipment.js +3 -1
  25. package/dist/esm/maplestory/api/common/dto/union/unionChampion.js +8 -0
  26. package/dist/esm/maplestory/api/kms/dto/character/characterItemEquipment.js +3 -2
  27. package/dist/esm/maplestory/api/kms/dto/union/unionChampion.js +8 -3
  28. package/dist/esm/maplestory/api/kms/mapleStoryApi.js +26 -20
  29. package/dist/esm/maplestory/api/msea/dto/character/characterAndroidEquipment.js +36 -3
  30. package/dist/esm/maplestory/api/msea/dto/character/characterBasic.js +4 -10
  31. package/dist/esm/maplestory/api/msea/dto/character/characterBeautyEquipment.js +24 -2
  32. package/dist/esm/maplestory/api/msea/dto/character/characterCashItemEquipment.js +17 -1
  33. package/dist/esm/maplestory/api/msea/dto/character/characterItemEquipment.js +101 -7
  34. package/dist/esm/maplestory/api/msea/dto/union/unionChampion.js +76 -0
  35. package/dist/esm/maplestory/api/msea/mapleStoryApi.js +32 -0
  36. package/dist/esm/maplestory/api/msea/msea.js +2 -1
  37. package/dist/esm/maplestory/api/tms/dto/character/characterAndroidEquipment.js +36 -3
  38. package/dist/esm/maplestory/api/tms/dto/character/characterBasic.js +1 -1
  39. package/dist/esm/maplestory/api/tms/dto/character/characterBeautyEquipment.js +24 -2
  40. package/dist/esm/maplestory/api/tms/dto/character/characterCashItemEquipment.js +12 -1
  41. package/dist/esm/maplestory/api/tms/dto/character/characterItemEquipment.js +85 -6
  42. package/dist/esm/maplestory/api/tms/dto/union/unionChampion.js +73 -0
  43. package/dist/esm/maplestory/api/tms/mapleStoryApi.js +32 -0
  44. package/dist/esm/maplestory/api/tms/tms.js +2 -1
  45. package/dist/index.min.js +1 -1
  46. package/package.json +1 -1
  47. package/types/index.d.ts +1 -0
  48. package/types/maplestory/api/common/dto/character/characterAndroidEquipment.d.ts +3 -0
  49. package/types/maplestory/api/common/dto/character/characterBasic.d.ts +1 -0
  50. package/types/maplestory/api/common/dto/character/characterBeautyEquipment.d.ts +2 -0
  51. package/types/maplestory/api/common/dto/character/characterCashItemEquipment.d.ts +2 -0
  52. package/types/maplestory/api/common/dto/character/characterItemEquipment.d.ts +15 -0
  53. package/types/maplestory/api/common/dto/union/unionChampion.d.ts +15 -0
  54. package/types/maplestory/api/common/mapleStoryApi.d.ts +2 -0
  55. package/types/maplestory/api/kms/dto/character/characterItemEquipment.d.ts +1 -1
  56. package/types/maplestory/api/kms/dto/union/unionChampion.d.ts +4 -3
  57. package/types/maplestory/api/kms/mapleStoryApi.d.ts +13 -7
  58. package/types/maplestory/api/msea/dto/character/characterAndroidEquipment.d.ts +24 -0
  59. package/types/maplestory/api/msea/dto/character/characterBasic.d.ts +2 -6
  60. package/types/maplestory/api/msea/dto/character/characterBeautyEquipment.d.ts +16 -0
  61. package/types/maplestory/api/msea/dto/character/characterCashItemEquipment.d.ts +12 -0
  62. package/types/maplestory/api/msea/dto/character/characterItemEquipment.d.ts +71 -1
  63. package/types/maplestory/api/msea/dto/union/unionChampion.d.ts +56 -0
  64. package/types/maplestory/api/msea/index.d.ts +1 -0
  65. package/types/maplestory/api/msea/mapleStoryApi.d.ts +12 -0
  66. package/types/maplestory/api/msea/response/character/characterAndroidEquipmentBody.d.ts +3 -0
  67. package/types/maplestory/api/msea/response/character/characterBasicBody.d.ts +1 -1
  68. package/types/maplestory/api/msea/response/character/characterBeautyEquipmentBody.d.ts +2 -0
  69. package/types/maplestory/api/msea/response/character/characterCashItemEquipmentBody.d.ts +2 -0
  70. package/types/maplestory/api/msea/response/character/characterItemEquipmentBody.d.ts +14 -0
  71. package/types/maplestory/api/msea/response/union/unionChampionBody.d.ts +15 -0
  72. package/types/maplestory/api/tms/dto/character/characterAndroidEquipment.d.ts +24 -0
  73. package/types/maplestory/api/tms/dto/character/characterBasic.d.ts +1 -1
  74. package/types/maplestory/api/tms/dto/character/characterBeautyEquipment.d.ts +16 -0
  75. package/types/maplestory/api/tms/dto/character/characterCashItemEquipment.d.ts +8 -0
  76. package/types/maplestory/api/tms/dto/character/characterItemEquipment.d.ts +59 -1
  77. package/types/maplestory/api/tms/dto/union/unionChampion.d.ts +53 -0
  78. package/types/maplestory/api/tms/index.d.ts +1 -0
  79. package/types/maplestory/api/tms/mapleStoryApi.d.ts +12 -0
  80. package/types/maplestory/api/tms/response/character/characterAndroidEquipmentBody.d.ts +3 -0
  81. package/types/maplestory/api/tms/response/character/characterBeautyEquipmentBody.d.ts +2 -0
  82. package/types/maplestory/api/tms/response/character/characterCashItemEquipmentBody.d.ts +1 -0
  83. package/types/maplestory/api/tms/response/character/characterItemEquipmentBody.d.ts +11 -0
  84. package/types/maplestory/api/tms/response/union/unionChampionBody.d.ts +15 -0
@@ -44,6 +44,10 @@ class CharacterItemEquipmentDto extends characterItemEquipment.CharacterItemEqui
44
44
  * 稱號資訊
45
45
  */
46
46
  title;
47
+ /**
48
+ * 外型設定中已登錄勳章的外型資訊
49
+ */
50
+ medalShape;
47
51
  /**
48
52
  * 龍魔導士的龍道具資訊 (僅在龍魔導士時回應)
49
53
  */
@@ -54,7 +58,7 @@ class CharacterItemEquipmentDto extends characterItemEquipment.CharacterItemEqui
54
58
  mechanicEquipment;
55
59
  constructor(obj) {
56
60
  super();
57
- const { date, character_gender, character_class, preset_no, item_equipment, item_equipment_preset_1, item_equipment_preset_2, item_equipment_preset_3, title, dragon_equipment, mechanic_equipment, } = obj;
61
+ const { date, character_gender, character_class, preset_no, item_equipment, item_equipment_preset_1, item_equipment_preset_2, item_equipment_preset_3, title, medal_shape, dragon_equipment, mechanic_equipment, } = obj;
58
62
  this.date = date ? new Date(date) : null;
59
63
  this.characterGender = character_gender;
60
64
  this.characterClass = character_class;
@@ -67,6 +71,9 @@ class CharacterItemEquipmentDto extends characterItemEquipment.CharacterItemEqui
67
71
  this.itemEquipmentPreset3 =
68
72
  item_equipment_preset_3?.map((equipment) => new CharacterItemEquipmentInfoDto(equipment)) ?? [];
69
73
  this.title = title ? new CharacterItemEquipmentTitleDto(title) : null;
74
+ this.medalShape = medal_shape
75
+ ? new CharacterItemEquipmentMedalShapeDto(medal_shape)
76
+ : null;
70
77
  this.dragonEquipment = dragon_equipment.map((equipment) => new CharacterItemEquipmentDragonInfoDto(equipment));
71
78
  this.mechanicEquipment = mechanic_equipment.map((equipment) => new CharacterItemEquipmentMechanicInfoDto(equipment));
72
79
  }
@@ -140,6 +147,45 @@ class CharacterItemEquipmentTitleDto extends characterItemEquipment.CharacterIte
140
147
  }
141
148
  }
142
149
  }
150
+ /**
151
+ * 外型設定中已登錄勳章的外型資訊
152
+ */
153
+ class CharacterItemEquipmentMedalShapeDto extends characterItemEquipment.CharacterItemEquipmentMedalShapeDto {
154
+ /**
155
+ * 外型設定中已登錄勳章的道具名稱
156
+ */
157
+ medalShapeName;
158
+ /**
159
+ * 外型設定中已登錄勳章的圖示
160
+ */
161
+ medalShapeIcon;
162
+ /**
163
+ * 外型設定中已登錄勳章的描述
164
+ */
165
+ medalShapeDescription;
166
+ /**
167
+ * 外型設定中已登錄勳章的鐵砧套用道具名稱
168
+ */
169
+ medalShapeChangedName;
170
+ /**
171
+ * 外型設定中已登錄勳章的鐵砧套用圖示
172
+ */
173
+ medalShapeChangedIcon;
174
+ /**
175
+ * 外型設定中已登錄勳章的鐵砧套用勳章說明
176
+ */
177
+ medalShapeChangedDescription;
178
+ constructor(obj) {
179
+ super();
180
+ const { medal_shape_name, medal_shape_icon, medal_shape_description, medal_shape_changed_name, medal_shape_changed_icon, medal_shape_changed_description, } = obj;
181
+ this.medalShapeName = medal_shape_name;
182
+ this.medalShapeIcon = medal_shape_icon;
183
+ this.medalShapeDescription = medal_shape_description;
184
+ this.medalShapeChangedName = medal_shape_changed_name;
185
+ this.medalShapeChangedIcon = medal_shape_changed_icon;
186
+ this.medalShapeChangedDescription = medal_shape_changed_description;
187
+ }
188
+ }
143
189
  /**
144
190
  * 附加道具選項
145
191
  */
@@ -719,9 +765,13 @@ class CharacterItemEquipmentDragonInfoDto extends characterItemEquipment.Charact
719
765
  * Whether the equipment is expired
720
766
  */
721
767
  isExpired = null;
768
+ /**
769
+ * 自由造型券 使用狀態(0:未使用,1:已使用)
770
+ */
771
+ freestyleFlag;
722
772
  constructor(obj) {
723
773
  super();
724
- const { item_equipment_part, item_equipment_slot, item_name, item_icon, item_description, item_shape_name, item_shape_icon, item_gender, item_total_option, item_base_option, 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;
774
+ const { item_equipment_part, item_equipment_slot, item_name, item_icon, item_description, item_shape_name, item_shape_icon, item_gender, item_total_option, item_base_option, 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, freestyle_flag, } = obj;
725
775
  this.itemEquipmentPart = item_equipment_part;
726
776
  this.itemEquipmentSlot = item_equipment_slot;
727
777
  this.itemName = item_name;
@@ -749,6 +799,7 @@ class CharacterItemEquipmentDragonInfoDto extends characterItemEquipment.Charact
749
799
  this.starforceScrollFlag = starforce_scroll_flag;
750
800
  this.itemStarforceOption = new CharacterItemEquipmentStarforceOptionDto(item_starforce_option);
751
801
  this.specialRingLevel = special_ring_level;
802
+ this.freestyleFlag = freestyle_flag;
752
803
  if (date_expire === 'expired') {
753
804
  this.isExpired = true;
754
805
  }
@@ -756,6 +807,12 @@ class CharacterItemEquipmentDragonInfoDto extends characterItemEquipment.Charact
756
807
  this.dateExpire = date_expire ? new Date(date_expire) : null;
757
808
  }
758
809
  }
810
+ /**
811
+ * 自由造型券 使用狀態
812
+ */
813
+ get isFreestyleFlag() {
814
+ return this.freestyleFlag === '1';
815
+ }
759
816
  }
760
817
  /**
761
818
  * 機甲戰神道具資訊
@@ -877,9 +934,13 @@ class CharacterItemEquipmentMechanicInfoDto extends characterItemEquipment.Chara
877
934
  * Whether the equipment is expired
878
935
  */
879
936
  isExpired = null;
937
+ /**
938
+ * 自由造型券 使用狀態(0:未使用,1:已使用)
939
+ */
940
+ freestyleFlag;
880
941
  constructor(obj) {
881
942
  super();
882
- const { item_equipment_part, item_equipment_slot, item_name, item_icon, item_description, item_shape_name, item_shape_icon, item_gender, item_total_option, item_base_option, 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;
943
+ const { item_equipment_part, item_equipment_slot, item_name, item_icon, item_description, item_shape_name, item_shape_icon, item_gender, item_total_option, item_base_option, 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, freestyle_flag, } = obj;
883
944
  this.itemEquipmentPart = item_equipment_part;
884
945
  this.itemEquipmentSlot = item_equipment_slot;
885
946
  this.itemName = item_name;
@@ -907,6 +968,7 @@ class CharacterItemEquipmentMechanicInfoDto extends characterItemEquipment.Chara
907
968
  this.starforceScrollFlag = starforce_scroll_flag;
908
969
  this.itemStarforceOption = new CharacterItemEquipmentStarforceOptionDto(item_starforce_option);
909
970
  this.specialRingLevel = special_ring_level;
971
+ this.freestyleFlag = freestyle_flag;
910
972
  if (date_expire === 'expired') {
911
973
  this.isExpired = true;
912
974
  }
@@ -914,6 +976,12 @@ class CharacterItemEquipmentMechanicInfoDto extends characterItemEquipment.Chara
914
976
  this.dateExpire = date_expire ? new Date(date_expire) : null;
915
977
  }
916
978
  }
979
+ /**
980
+ * 自由造型券 使用狀態
981
+ */
982
+ get isFreestyleFlag() {
983
+ return this.freestyleFlag === '1';
984
+ }
917
985
  }
918
986
  /**
919
987
  * 道具資訊
@@ -1075,9 +1143,13 @@ class CharacterItemEquipmentInfoDto extends characterItemEquipment.CharacterItem
1075
1143
  * Whether the equipment is expired
1076
1144
  */
1077
1145
  isExpired = null;
1146
+ /**
1147
+ * 自由造型券 使用狀態(0:未使用,1:已使用)
1148
+ */
1149
+ freestyleFlag;
1078
1150
  constructor(obj) {
1079
1151
  super();
1080
- const { item_equipment_part, item_equipment_slot, item_name, item_icon, item_description, item_shape_name, item_shape_icon, item_gender, item_total_option, item_base_option, potential_option_flag, additional_potential_option_flag, 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;
1152
+ const { item_equipment_part, item_equipment_slot, item_name, item_icon, item_description, item_shape_name, item_shape_icon, item_gender, item_total_option, item_base_option, potential_option_flag, additional_potential_option_flag, 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, freestyle_flag, } = obj;
1081
1153
  this.itemEquipmentPart = item_equipment_part;
1082
1154
  this.itemEquipmentSlot = item_equipment_slot;
1083
1155
  this.itemName = item_name;
@@ -1115,6 +1187,7 @@ class CharacterItemEquipmentInfoDto extends characterItemEquipment.CharacterItem
1115
1187
  this.starforceScrollFlag = starforce_scroll_flag;
1116
1188
  this.itemStarforceOption = new CharacterItemEquipmentStarforceOptionDto(item_starforce_option);
1117
1189
  this.specialRingLevel = special_ring_level;
1190
+ this.freestyleFlag = freestyle_flag;
1118
1191
  if (date_expire === 'expired') {
1119
1192
  this.isExpired = true;
1120
1193
  }
@@ -1122,6 +1195,12 @@ class CharacterItemEquipmentInfoDto extends characterItemEquipment.CharacterItem
1122
1195
  this.dateExpire = date_expire ? new Date(date_expire) : null;
1123
1196
  }
1124
1197
  }
1198
+ /**
1199
+ * 自由造型券 使用狀態
1200
+ */
1201
+ get isFreestyleFlag() {
1202
+ return this.freestyleFlag === '1';
1203
+ }
1125
1204
  }
1126
1205
 
1127
1206
  exports.CharacterItemEquipmentAddOptionDto = CharacterItemEquipmentAddOptionDto;
@@ -1132,6 +1211,7 @@ exports.CharacterItemEquipmentEtcOptionDto = CharacterItemEquipmentEtcOptionDto;
1132
1211
  exports.CharacterItemEquipmentExceptionalOptionDto = CharacterItemEquipmentExceptionalOptionDto;
1133
1212
  exports.CharacterItemEquipmentInfoDto = CharacterItemEquipmentInfoDto;
1134
1213
  exports.CharacterItemEquipmentMechanicInfoDto = CharacterItemEquipmentMechanicInfoDto;
1214
+ exports.CharacterItemEquipmentMedalShapeDto = CharacterItemEquipmentMedalShapeDto;
1135
1215
  exports.CharacterItemEquipmentStarforceOptionDto = CharacterItemEquipmentStarforceOptionDto;
1136
1216
  exports.CharacterItemEquipmentTitleDto = CharacterItemEquipmentTitleDto;
1137
1217
  exports.CharacterItemEquipmentTotalOptionDto = CharacterItemEquipmentTotalOptionDto;
@@ -0,0 +1,79 @@
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, '__esModule', { value: true });
4
+
5
+ var unionChampion = require('../../../common/dto/union/unionChampion.js');
6
+
7
+ /**
8
+ * 聯盟冠軍資訊
9
+ */
10
+ class UnionChampionDto extends unionChampion.UnionChampionDto {
11
+ date;
12
+ /**
13
+ * 聯盟冠軍資訊
14
+ */
15
+ unionChampion;
16
+ /**
17
+ * 冠軍徽章效果
18
+ */
19
+ championBadgeTotalInfo;
20
+ constructor(obj) {
21
+ super();
22
+ const { date, union_champion, champion_badge_total_info } = obj;
23
+ this.date = date ? new Date(date) : null;
24
+ this.unionChampion = union_champion.map((info) => new UnionChampionInfoDto(info));
25
+ this.championBadgeTotalInfo = champion_badge_total_info.map((info) => new UnionChampionBadgeInfoDto(info));
26
+ }
27
+ }
28
+ /**
29
+ * 聯盟冠軍徽章資訊
30
+ */
31
+ class UnionChampionBadgeInfoDto extends unionChampion.UnionChampionBadgeInfoDto {
32
+ /**
33
+ * 聯盟冠軍徽章資訊
34
+ */
35
+ stat;
36
+ constructor(obj) {
37
+ super();
38
+ const { stat } = obj;
39
+ this.stat = stat;
40
+ }
41
+ }
42
+ /**
43
+ * 聯盟冠軍資訊
44
+ */
45
+ class UnionChampionInfoDto extends unionChampion.UnionChampionInfoDto {
46
+ /**
47
+ * 聯盟冠軍角色名稱
48
+ */
49
+ championName;
50
+ /**
51
+ * 聯盟冠軍欄位
52
+ */
53
+ championSlot;
54
+ /**
55
+ * 聯盟冠軍等級
56
+ */
57
+ championGrade;
58
+ /**
59
+ * 聯盟冠軍角色職業
60
+ */
61
+ championClass;
62
+ /**
63
+ * 聯盟冠軍徽章資訊
64
+ */
65
+ championBadgeInfo;
66
+ constructor(obj) {
67
+ super();
68
+ const { champion_name, champion_slot, champion_grade, champion_class, champion_badge_info, } = obj;
69
+ this.championName = champion_name;
70
+ this.championSlot = champion_slot;
71
+ this.championGrade = champion_grade;
72
+ this.championClass = champion_class;
73
+ this.championBadgeInfo = champion_badge_info.map((info) => new UnionChampionBadgeInfoDto(info));
74
+ }
75
+ }
76
+
77
+ exports.UnionChampionBadgeInfoDto = UnionChampionBadgeInfoDto;
78
+ exports.UnionChampionDto = UnionChampionDto;
79
+ exports.UnionChampionInfoDto = UnionChampionInfoDto;
@@ -29,6 +29,7 @@ var guild = require('./dto/guild/guild.js');
29
29
  var guildBasic = require('./dto/guild/guildBasic.js');
30
30
  var union = require('./dto/union/union.js');
31
31
  var unionArtifact = require('./dto/union/unionArtifact.js');
32
+ var unionChampion = require('./dto/union/unionChampion.js');
32
33
  var unionRaider = require('./dto/union/unionRaider.js');
33
34
  var characterImage = require('../common/enum/characterImage.js');
34
35
  var mapleStoryApi = require('../common/mapleStoryApi.js');
@@ -819,6 +820,37 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
819
820
  }
820
821
  return new unionArtifact.UnionArtifactDto(data);
821
822
  }
823
+ /**
824
+ * 查詢聯盟冠軍資訊。
825
+ * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
826
+ * - 您可以從 2025 年 12 月 18 日起搜尋資料。
827
+ * - 您可以輸入所需日期以搜尋過往資料。前一日的資料將於翌日凌晨 2:00 起提供。(當您搜尋 10 月 15 日的資料時,將會擷取從 15 日 00:00 到 16 日 00:00 的資料。)
828
+ * - 由於遊戲內容變動,OCID 可能會有所變更。在更新以 OCID 為基礎的服務時,請務必留意。
829
+ * - 此 API 提供來自楓之谷台灣的資料。
830
+ * @param ocid 角色辨識器
831
+ * @param dateOptions 要搜尋的日期 (TST)
832
+ */
833
+ async getUnionChampion(ocid, dateOptions) {
834
+ const path = `${this.subUrl}/v1/user/union-champion`;
835
+ const date = dateOptions
836
+ ? this.toDateString(dateOptions, {
837
+ year: 2025,
838
+ month: 12,
839
+ day: 18,
840
+ })
841
+ : undefined;
842
+ const query = {
843
+ ocid: ocid,
844
+ date: date,
845
+ };
846
+ const { data } = await this.client.get(path, {
847
+ params: query,
848
+ });
849
+ if (this.isEmptyResponse(data)) {
850
+ return null;
851
+ }
852
+ return new unionChampion.UnionChampionDto(data);
853
+ }
822
854
  //#endregion
823
855
  //#region 檢視公會資訊
824
856
  /**
@@ -28,6 +28,7 @@ var guild = require('./dto/guild/guild.js');
28
28
  var guildBasic = require('./dto/guild/guildBasic.js');
29
29
  var union = require('./dto/union/union.js');
30
30
  var unionArtifact = require('./dto/union/unionArtifact.js');
31
+ var unionChampion = require('./dto/union/unionChampion.js');
31
32
  var unionRaider = require('./dto/union/unionRaider.js');
32
33
 
33
34
 
@@ -71,6 +72,7 @@ exports.CharacterItemEquipmentEtcOptionDto = characterItemEquipment.CharacterIte
71
72
  exports.CharacterItemEquipmentExceptionalOptionDto = characterItemEquipment.CharacterItemEquipmentExceptionalOptionDto;
72
73
  exports.CharacterItemEquipmentInfoDto = characterItemEquipment.CharacterItemEquipmentInfoDto;
73
74
  exports.CharacterItemEquipmentMechanicInfoDto = characterItemEquipment.CharacterItemEquipmentMechanicInfoDto;
75
+ exports.CharacterItemEquipmentMedalShapeDto = characterItemEquipment.CharacterItemEquipmentMedalShapeDto;
74
76
  exports.CharacterItemEquipmentStarforceOptionDto = characterItemEquipment.CharacterItemEquipmentStarforceOptionDto;
75
77
  exports.CharacterItemEquipmentTitleDto = characterItemEquipment.CharacterItemEquipmentTitleDto;
76
78
  exports.CharacterItemEquipmentTotalOptionDto = characterItemEquipment.CharacterItemEquipmentTotalOptionDto;
@@ -101,6 +103,9 @@ exports.UnionDto = union.UnionDto;
101
103
  exports.UnionArtifactCrystalDto = unionArtifact.UnionArtifactCrystalDto;
102
104
  exports.UnionArtifactDto = unionArtifact.UnionArtifactDto;
103
105
  exports.UnionArtifactEffectDto = unionArtifact.UnionArtifactEffectDto;
106
+ exports.UnionChampionBadgeInfoDto = unionChampion.UnionChampionBadgeInfoDto;
107
+ exports.UnionChampionDto = unionChampion.UnionChampionDto;
108
+ exports.UnionChampionInfoDto = unionChampion.UnionChampionInfoDto;
104
109
  exports.UnionRaiderBlockControlPointDto = unionRaider.UnionRaiderBlockControlPointDto;
105
110
  exports.UnionRaiderBlockDto = unionRaider.UnionRaiderBlockDto;
106
111
  exports.UnionRaiderBlockPositionDto = unionRaider.UnionRaiderBlockPositionDto;
package/dist/esm/index.js CHANGED
@@ -13,7 +13,7 @@ export { CharacterHexaMatrixDto, CharacterHexaMatrixEquipmentDto, CharacterHexaM
13
13
  export { CharacterHexaMatrixStatCoreDto, CharacterHexaMatrixStatDto } from './maplestory/api/common/dto/character/characterHexaMatrixStat.js';
14
14
  export { CharacterHyperStatDto, CharacterHyperStatPresetDto } from './maplestory/api/common/dto/character/characterHyperStat.js';
15
15
  export { CharacterImageDto } from './maplestory/api/common/dto/character/characterImage.js';
16
- export { CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto } from './maplestory/api/common/dto/character/characterItemEquipment.js';
16
+ export { CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentMedalShapeDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto } from './maplestory/api/common/dto/character/characterItemEquipment.js';
17
17
  export { CharacterLinkSkillDto, CharacterLinkSkillInfoDto } from './maplestory/api/common/dto/character/characterLinkSkill.js';
18
18
  export { CharacterPetEquipmentAutoSkillDto, CharacterPetEquipmentDto, CharacterPetEquipmentItemDto, CharacterPetEquipmentItemOptionDto } from './maplestory/api/common/dto/character/characterPetEquipment.js';
19
19
  export { CharacterPopularityDto } from './maplestory/api/common/dto/character/characterPopularity.js';
@@ -27,4 +27,5 @@ export { GuildDto } from './maplestory/api/common/dto/guild/guild.js';
27
27
  export { GuildBasicDto, GuildSkillDto } from './maplestory/api/common/dto/guild/guildBasic.js';
28
28
  export { UnionDto } from './maplestory/api/common/dto/union/union.js';
29
29
  export { UnionArtifactCrystalDto, UnionArtifactDto, UnionArtifactEffectDto } from './maplestory/api/common/dto/union/unionArtifact.js';
30
+ export { UnionChampionBadgeInfoDto, UnionChampionDto, UnionChampionInfoDto } from './maplestory/api/common/dto/union/unionChampion.js';
30
31
  export { UnionRaiderBlockControlPointDto, UnionRaiderBlockDto, UnionRaiderBlockPositionDto, UnionRaiderDto, UnionRaiderInnerStatDto, UnionRaiderPresetDto } from './maplestory/api/common/dto/union/unionRaider.js';
@@ -14,6 +14,8 @@ class CharacterItemEquipmentStarforceOptionDto {
14
14
  }
15
15
  class CharacterItemEquipmentTotalOptionDto {
16
16
  }
17
+ class CharacterItemEquipmentMedalShapeDto {
18
+ }
17
19
  class CharacterItemEquipmentDragonInfoDto {
18
20
  }
19
21
  class CharacterItemEquipmentMechanicInfoDto {
@@ -21,4 +23,4 @@ class CharacterItemEquipmentMechanicInfoDto {
21
23
  class CharacterItemEquipmentInfoDto {
22
24
  }
23
25
 
24
- export { CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto };
26
+ export { CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentMedalShapeDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto };
@@ -0,0 +1,8 @@
1
+ class UnionChampionDto {
2
+ }
3
+ class UnionChampionBadgeInfoDto {
4
+ }
5
+ class UnionChampionInfoDto {
6
+ }
7
+
8
+ export { UnionChampionBadgeInfoDto, UnionChampionDto, UnionChampionInfoDto };
@@ -1,4 +1,4 @@
1
- import { CharacterItemEquipmentDto as CharacterItemEquipmentDto$1, CharacterItemEquipmentTitleDto as CharacterItemEquipmentTitleDto$1, CharacterItemEquipmentAddOptionDto as CharacterItemEquipmentAddOptionDto$1, CharacterItemEquipmentBaseOptionDto as CharacterItemEquipmentBaseOptionDto$1, CharacterItemEquipmentEtcOptionDto as CharacterItemEquipmentEtcOptionDto$1, CharacterItemEquipmentExceptionalOptionDto as CharacterItemEquipmentExceptionalOptionDto$1, CharacterItemEquipmentStarforceOptionDto as CharacterItemEquipmentStarforceOptionDto$1, CharacterItemEquipmentTotalOptionDto as CharacterItemEquipmentTotalOptionDto$1, CharacterItemEquipmentDragonInfoDto as CharacterItemEquipmentDragonInfoDto$1, CharacterItemEquipmentMechanicInfoDto as CharacterItemEquipmentMechanicInfoDto$1, CharacterItemEquipmentInfoDto as CharacterItemEquipmentInfoDto$1 } from '../../../common/dto/character/characterItemEquipment.js';
1
+ import { CharacterItemEquipmentDto as CharacterItemEquipmentDto$1, CharacterItemEquipmentTitleDto as CharacterItemEquipmentTitleDto$1, CharacterItemEquipmentMedalShapeDto as CharacterItemEquipmentMedalShapeDto$1, CharacterItemEquipmentAddOptionDto as CharacterItemEquipmentAddOptionDto$1, CharacterItemEquipmentBaseOptionDto as CharacterItemEquipmentBaseOptionDto$1, CharacterItemEquipmentEtcOptionDto as CharacterItemEquipmentEtcOptionDto$1, CharacterItemEquipmentExceptionalOptionDto as CharacterItemEquipmentExceptionalOptionDto$1, CharacterItemEquipmentStarforceOptionDto as CharacterItemEquipmentStarforceOptionDto$1, CharacterItemEquipmentTotalOptionDto as CharacterItemEquipmentTotalOptionDto$1, CharacterItemEquipmentDragonInfoDto as CharacterItemEquipmentDragonInfoDto$1, CharacterItemEquipmentMechanicInfoDto as CharacterItemEquipmentMechanicInfoDto$1, CharacterItemEquipmentInfoDto as CharacterItemEquipmentInfoDto$1 } from '../../../common/dto/character/characterItemEquipment.js';
2
2
 
3
3
  /**
4
4
  * 캐릭터 장비 아이템 정보
@@ -146,7 +146,7 @@ class CharacterItemEquipmentTitleDto extends CharacterItemEquipmentTitleDto$1 {
146
146
  /**
147
147
  * 캐릭터 외형 설정에 등록한 훈장 외형 정보
148
148
  */
149
- class CharacterItemEquipmentMedalShapeDto {
149
+ class CharacterItemEquipmentMedalShapeDto extends CharacterItemEquipmentMedalShapeDto$1 {
150
150
  /**
151
151
  * 외형 설정에 등록한 훈장 장비 명
152
152
  */
@@ -172,6 +172,7 @@ class CharacterItemEquipmentMedalShapeDto {
172
172
  */
173
173
  medalShapeChangedDescription;
174
174
  constructor(obj) {
175
+ super();
175
176
  const { medal_shape_name, medal_shape_icon, medal_shape_description, medal_shape_changed_name, medal_shape_changed_icon, medal_shape_changed_description, } = obj;
176
177
  this.medalShapeName = medal_shape_name;
177
178
  this.medalShapeIcon = medal_shape_icon;
@@ -1,7 +1,9 @@
1
+ import { UnionChampionDto as UnionChampionDto$1, UnionChampionBadgeInfoDto as UnionChampionBadgeInfoDto$1, UnionChampionInfoDto as UnionChampionInfoDto$1 } from '../../../common/dto/union/unionChampion.js';
2
+
1
3
  /**
2
4
  * 유니온 챔피언 정보
3
5
  */
4
- class UnionChampionDto {
6
+ class UnionChampionDto extends UnionChampionDto$1 {
5
7
  /**
6
8
  * 조회 기준일 (KST, 일 단위 데이터로 시, 분은 일괄 0으로 표기)
7
9
  */
@@ -15,6 +17,7 @@ class UnionChampionDto {
15
17
  */
16
18
  championBadgeTotalInfo;
17
19
  constructor(obj) {
20
+ super();
18
21
  const { date, union_champion, champion_badge_total_info } = obj;
19
22
  this.date = date ? new Date(date) : null;
20
23
  this.unionChampion = union_champion.map((info) => new UnionChampionInfoDto(info));
@@ -24,12 +27,13 @@ class UnionChampionDto {
24
27
  /**
25
28
  * 유니온 챔피언 휘장 정보
26
29
  */
27
- class UnionChampionBadgeInfoDto {
30
+ class UnionChampionBadgeInfoDto extends UnionChampionBadgeInfoDto$1 {
28
31
  /**
29
32
  * 유니온 챔피언 휘장 효과
30
33
  */
31
34
  stat;
32
35
  constructor(obj) {
36
+ super();
33
37
  const { stat } = obj;
34
38
  this.stat = stat;
35
39
  }
@@ -37,7 +41,7 @@ class UnionChampionBadgeInfoDto {
37
41
  /**
38
42
  * 유니온 챔피언 상세 정보
39
43
  */
40
- class UnionChampionInfoDto {
44
+ class UnionChampionInfoDto extends UnionChampionInfoDto$1 {
41
45
  /**
42
46
  * 유니온 챔피언 캐릭터 명
43
47
  */
@@ -59,6 +63,7 @@ class UnionChampionInfoDto {
59
63
  */
60
64
  championBadgeInfo;
61
65
  constructor(obj) {
66
+ super();
62
67
  const { champion_name, champion_slot, champion_grade, champion_class, champion_badge_info, } = obj;
63
68
  this.championName = champion_name;
64
69
  this.championSlot = champion_slot;
@@ -51,8 +51,8 @@ import { UnionRaiderDto } from './dto/union/unionRaider.js';
51
51
  import { AchievementDto } from './dto/user/achievement.js';
52
52
  import { CharacterListDto } from './dto/user/characterList.js';
53
53
  import { CharacterImageAction, CharacterImageEmotion, CharacterImageWeaponMotion } from '../common/enum/characterImage.js';
54
- import { MapleStoryApi as MapleStoryApi$1 } from '../common/mapleStoryApi.js';
55
54
  import { removeQuery } from '../common/lib.js';
55
+ import { MapleStoryApi as MapleStoryApi$1 } from '../common/mapleStoryApi.js';
56
56
  import { __exports as buffer } from '../../../_virtual/index.js_commonjs-exports.js';
57
57
 
58
58
  /**
@@ -1111,17 +1111,18 @@ class MapleStoryApi extends MapleStoryApi$1 {
1111
1111
  //#region 랭킹 정보 조회
1112
1112
  /**
1113
1113
  * 종합 랭킹 정보를 조회합니다.
1114
- * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
1115
- * - 오전 830분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
1114
+ * - 2023년 12월 21일 데이터부터 조회할 수 있습니다.
1115
+ * - 오늘의 랭킹 정보는 오전 9경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
1116
1116
  * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
1117
+ * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
1117
1118
  *
1118
1119
  * @param filterOptions 검색 기준
1119
1120
  * @param dateOptions 조회 기준일 (KST).
1120
1121
  *
1121
1122
  */
1122
1123
  async getOverallRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
1123
- hour: 8,
1124
- minute: 30,
1124
+ hour: 9,
1125
+ minute: 0,
1125
1126
  dateOffset: 0,
1126
1127
  })) {
1127
1128
  const path = `${this.subUrl}/v1/ranking/overall`;
@@ -1148,15 +1149,16 @@ class MapleStoryApi extends MapleStoryApi$1 {
1148
1149
  /**
1149
1150
  * 유니온 랭킹 정보를 조회합니다.
1150
1151
  * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
1151
- * - 오전 830분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
1152
+ * - 오늘의 랭킹 정보는 오전 9경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
1152
1153
  * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
1154
+ * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
1153
1155
  *
1154
1156
  * @param filterOptions 검색 기준
1155
1157
  * @param dateOptions 조회 기준일 (KST)
1156
1158
  */
1157
1159
  async getUnionRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
1158
- hour: 8,
1159
- minute: 30,
1160
+ hour: 9,
1161
+ minute: 0,
1160
1162
  dateOffset: 0,
1161
1163
  })) {
1162
1164
  const path = `${this.subUrl}/v1/ranking/union`;
@@ -1181,15 +1183,16 @@ class MapleStoryApi extends MapleStoryApi$1 {
1181
1183
  /**
1182
1184
  * 길드 랭킹 정보를 조회합니다.
1183
1185
  * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
1184
- * - 오전 830분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
1186
+ * - 오늘의 랭킹 정보는 오전 9경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
1185
1187
  * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
1188
+ * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
1186
1189
  *
1187
1190
  * @param filterOptions 검색 기준
1188
1191
  * @param dateOptions 조회 기준일 (KST)
1189
1192
  */
1190
1193
  async getGuildRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
1191
- hour: 8,
1192
- minute: 30,
1194
+ hour: 9,
1195
+ minute: 0,
1193
1196
  dateOffset: 0,
1194
1197
  })) {
1195
1198
  const path = `${this.subUrl}/v1/ranking/guild`;
@@ -1216,15 +1219,16 @@ class MapleStoryApi extends MapleStoryApi$1 {
1216
1219
  /**
1217
1220
  * 무릉도장 랭킹 정보를 조회합니다.
1218
1221
  * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
1219
- * - 오전 830분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
1222
+ * - 오늘의 랭킹 정보는 오전 9경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
1220
1223
  * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
1224
+ * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
1221
1225
  *
1222
1226
  * @param filterOptions 검색 기준
1223
1227
  * @param dateOptions 조회 기준일 (KST)
1224
1228
  */
1225
1229
  async getDojangRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
1226
- hour: 8,
1227
- minute: 30,
1230
+ hour: 9,
1231
+ minute: 0,
1228
1232
  dateOffset: 0,
1229
1233
  })) {
1230
1234
  const path = `${this.subUrl}/v1/ranking/dojang`;
@@ -1252,15 +1256,16 @@ class MapleStoryApi extends MapleStoryApi$1 {
1252
1256
  /**
1253
1257
  * 더 시드 랭킹 정보를 조회합니다.
1254
1258
  * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
1255
- * - 오전 830분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
1259
+ * - 오늘의 랭킹 정보는 오전 9경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
1256
1260
  * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
1261
+ * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
1257
1262
  *
1258
1263
  * @param filterOptions 검색 기준
1259
1264
  * @param dateOptions 조회 기준일 (KST)
1260
1265
  */
1261
1266
  async getSeedRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
1262
- hour: 8,
1263
- minute: 30,
1267
+ hour: 9,
1268
+ minute: 0,
1264
1269
  dateOffset: 0,
1265
1270
  })) {
1266
1271
  const path = `${this.subUrl}/v1/ranking/theseed`;
@@ -1285,15 +1290,16 @@ class MapleStoryApi extends MapleStoryApi$1 {
1285
1290
  /**
1286
1291
  * 업적 랭킹 정보를 조회합니다.
1287
1292
  * - 2023년 12월 22일 데이터부터 조회할 수 있습니다.
1288
- * - 오전 830분부터 오늘의 랭킹 정보를 조회할 수 있습니다.
1293
+ * - 오늘의 랭킹 정보는 오전 9경부터 조회가 가능합니다. 상황에 따라 시간이 더 소요될 수 있습니다.
1289
1294
  * - 게임 콘텐츠 변경으로 ocid가 변경될 수 있습니다. ocid 기반 서비스 갱신 시 유의해 주시길 바랍니다.
1295
+ * - 해당 API는 메이플스토리 한국의 데이터가 제공됩니다.
1290
1296
  *
1291
1297
  * @param filterOptions 검색 기준
1292
1298
  * @param dateOptions 조회 기준일 (KST)
1293
1299
  */
1294
1300
  async getAchievementRanking(filterOptions, dateOptions = this.getProperDefaultDateOptions({
1295
- hour: 8,
1296
- minute: 30,
1301
+ hour: 9,
1302
+ minute: 0,
1297
1303
  dateOffset: 0,
1298
1304
  })) {
1299
1305
  const path = `${this.subUrl}/v1/ranking/achievement`;