maplestory-openapi 3.7.0 → 3.8.0

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

@@ -29,6 +29,7 @@ var guild = require('./dto/guild/guild.js');
 var guildBasic = require('./dto/guild/guildBasic.js');
 var union = require('./dto/union/union.js');
 var unionArtifact = require('./dto/union/unionArtifact.js');
+var unionChampion = require('./dto/union/unionChampion.js');
 var unionRaider = require('./dto/union/unionRaider.js');
 var characterImage = require('../common/enum/characterImage.js');
 var mapleStoryApi = require('../common/mapleStoryApi.js');
@@ -819,6 +820,37 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         }
         return new unionArtifact.UnionArtifactDto(data);
     }
+    /**
+     * Retrieves Union Champion information.
+     * - MapleStory game data can be verified approximately 15 minutes after updates.
+     * - Data is available starting from December 18, 2025.
+     * - Historical data can be queried by specifying the desired date, and data from the previous day can be accessed starting at 2 AM the next day. (For example, when querying data for December 22, data from 00:00 to 24:00 on December 22 will be retrieved.)
+     * - Due to game content changes, the ocid may be updated. Please pay attention to this when updating services based on ocid.
+     * - This API provides data for MapleStory SEA.
+     * @param ocid Character identifier
+     * @param dateOptions Reference date for query (SGT)
+     */
+    async getUnionChampion(ocid, dateOptions) {
+        const path = `${this.subUrl}/v1/user/union-champion`;
+        const date = dateOptions
+            ? this.toDateString(dateOptions, {
+                year: 2025,
+                month: 12,
+                day: 18,
+            })
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
+        return new unionChampion.UnionChampionDto(data);
+    }
     //#endregion
     //#region Guild Information Retrieval
     /**

package/dist/cjs/maplestory/api/msea/msea.js

@@ -28,6 +28,7 @@ var guild = require('./dto/guild/guild.js');
 var guildBasic = require('./dto/guild/guildBasic.js');
 var union = require('./dto/union/union.js');
 var unionArtifact = require('./dto/union/unionArtifact.js');
+var unionChampion = require('./dto/union/unionChampion.js');
 var unionRaider = require('./dto/union/unionRaider.js');
 
 
@@ -71,6 +72,7 @@ exports.CharacterItemEquipmentEtcOptionDto = characterItemEquipment.CharacterIte
 exports.CharacterItemEquipmentExceptionalOptionDto = characterItemEquipment.CharacterItemEquipmentExceptionalOptionDto;
 exports.CharacterItemEquipmentInfoDto = characterItemEquipment.CharacterItemEquipmentInfoDto;
 exports.CharacterItemEquipmentMechanicInfoDto = characterItemEquipment.CharacterItemEquipmentMechanicInfoDto;
+exports.CharacterItemEquipmentMedalShapeDto = characterItemEquipment.CharacterItemEquipmentMedalShapeDto;
 exports.CharacterItemEquipmentStarforceOptionDto = characterItemEquipment.CharacterItemEquipmentStarforceOptionDto;
 exports.CharacterItemEquipmentTitleDto = characterItemEquipment.CharacterItemEquipmentTitleDto;
 exports.CharacterItemEquipmentTotalOptionDto = characterItemEquipment.CharacterItemEquipmentTotalOptionDto;
@@ -101,6 +103,9 @@ exports.UnionDto = union.UnionDto;
 exports.UnionArtifactCrystalDto = unionArtifact.UnionArtifactCrystalDto;
 exports.UnionArtifactDto = unionArtifact.UnionArtifactDto;
 exports.UnionArtifactEffectDto = unionArtifact.UnionArtifactEffectDto;
+exports.UnionChampionBadgeInfoDto = unionChampion.UnionChampionBadgeInfoDto;
+exports.UnionChampionDto = unionChampion.UnionChampionDto;
+exports.UnionChampionInfoDto = unionChampion.UnionChampionInfoDto;
 exports.UnionRaiderBlockControlPointDto = unionRaider.UnionRaiderBlockControlPointDto;
 exports.UnionRaiderBlockDto = unionRaider.UnionRaiderBlockDto;
 exports.UnionRaiderBlockPositionDto = unionRaider.UnionRaiderBlockPositionDto;

package/dist/cjs/maplestory/api/tms/dto/character/characterAndroidEquipment.js

@@ -135,13 +135,24 @@ class CharacterAndroidEquipmentFaceDto extends characterAndroidEquipment.Charact
      * 機器人臉型混染顏色比例
      */
     mixRate;
+    /**
+     * 自由造型券 使用狀態（0：未使用，1：已使用）
+     */
+    freestyleFlag;
     constructor(obj) {
         super();
-        const { face_name, base_color, mix_color, mix_rate } = obj;
+        const { face_name, base_color, mix_color, mix_rate, freestyle_flag } = obj;
         this.faceName = face_name;
         this.baseColor = base_color;
         this.mixColor = mix_color;
         this.mixRate = mix_rate;
+        this.freestyleFlag = freestyle_flag;
+    }
+    /**
+     * 自由造型券 使用狀態
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
     }
 }
 /**
@@ -164,13 +175,24 @@ class CharacterAndroidEquipmentHairDto extends characterAndroidEquipment.Charact
      * 機器人髮型混染顏色比例
      */
     mixRate;
+    /**
+     * 自由造型券 使用狀態（0：未使用，1：已使用）
+     */
+    freestyleFlag;
     constructor(obj) {
         super();
-        const { hair_name, base_color, mix_color, mix_rate } = obj;
+        const { hair_name, base_color, mix_color, mix_rate, freestyle_flag } = obj;
         this.hairName = hair_name;
         this.baseColor = base_color;
         this.mixColor = mix_color;
         this.mixRate = mix_rate;
+        this.freestyleFlag = freestyle_flag;
+    }
+    /**
+     * 自由造型券 使用狀態
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
     }
 }
 /**
@@ -383,9 +405,13 @@ class CharacterAndroidCashItemEquipmentDto extends characterAndroidEquipment.Cha
      * 道具可裝備性別
      */
     androidItemGender;
+    /**
+     * 自由造型券 使用狀態（0：未使用，1：已使用）
+     */
+    freestyleFlag;
     constructor(obj) {
         super();
-        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, android_item_gender, } = obj;
+        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, android_item_gender, freestyle_flag, } = obj;
         this.cashItemEquipmentPart = cash_item_equipment_part;
         this.cashItemEquipmentSlot = cash_item_equipment_slot;
         this.cashItemName = cash_item_name;
@@ -397,6 +423,7 @@ class CharacterAndroidCashItemEquipmentDto extends characterAndroidEquipment.Cha
             ? new CharacterAndroidCashItemEquipmentColoringPrismDto(cash_item_coloring_prism)
             : null;
         this.androidItemGender = android_item_gender;
+        this.freestyleFlag = freestyle_flag;
         if (date_expire === 'expired') {
             this.isExpired = true;
         }
@@ -412,6 +439,12 @@ class CharacterAndroidCashItemEquipmentDto extends characterAndroidEquipment.Cha
                 : null;
         }
     }
+    /**
+     * 自由造型券 使用狀態
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
+    }
 }
 
 exports.CharacterAndroidCashItemEquipmentColoringPrismDto = CharacterAndroidCashItemEquipmentColoringPrismDto;

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

@@ -62,7 +62,7 @@ class CharacterBasicDto extends characterBasic.CharacterBasicDto {
      */
     accessFlag;
     /**
-     * 解放任務完成狀態 (0：未完成，1：創世武器已解放)
+     * 解放任務完成狀態 (0：未完成，1：創世武器已解放, 2:命運武器第一階段解放)
      */
     liberationQuestClear;
     constructor(obj) {

package/dist/cjs/maplestory/api/tms/dto/character/characterBeautyEquipment.js

@@ -93,13 +93,24 @@ class CharacterBeautyEquipmentFaceDto extends characterBeautyEquipment.Character
      * 臉型混染顏色比例
      */
     mixRate;
+    /**
+     * 自由造型券 使用狀態（0：未使用，1：已使用）
+     */
+    freestyleFlag;
     constructor(obj) {
         super();
-        const { face_name, base_color, mix_color, mix_rate } = obj;
+        const { face_name, base_color, mix_color, mix_rate, freestyle_flag } = obj;
         this.faceName = face_name;
         this.baseColor = base_color;
         this.mixColor = mix_color;
         this.mixRate = mix_rate;
+        this.freestyleFlag = freestyle_flag;
+    }
+    /**
+     * 自由造型券 使用狀態
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
     }
 }
 /**
@@ -122,13 +133,24 @@ class CharacterBeautyEquipmentHairDto extends characterBeautyEquipment.Character
      * 髮型混染顏色比例
      */
     mixRate;
+    /**
+     * 自由造型券 使用狀態（0：未使用，1：已使用）
+     */
+    freestyleFlag;
     constructor(obj) {
         super();
-        const { hair_name, base_color, mix_color, mix_rate } = obj;
+        const { hair_name, base_color, mix_color, mix_rate, freestyle_flag } = obj;
         this.hairName = hair_name;
         this.baseColor = base_color;
         this.mixColor = mix_color;
         this.mixRate = mix_rate;
+        this.freestyleFlag = freestyle_flag;
+    }
+    /**
+     * 自由造型券 使用狀態
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
     }
 }
 /**

package/dist/cjs/maplestory/api/tms/dto/character/characterCashItemEquipment.js

@@ -190,9 +190,13 @@ class CharacterCashItemEquipmentPresetDto extends characterCashItemEquipment.Cha
      * 技能名稱
      */
     skills;
+    /**
+     * 自由造型券 使用狀態（0：未使用，1：已使用）
+     */
+    freestyleFlag;
     constructor(obj) {
         super();
-        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, item_gender, skills, } = obj;
+        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, item_gender, skills, freestyle_flag, } = obj;
         this.cashItemEquipmentPart = cash_item_equipment_part;
         this.cashItemEquipmentSlot = cash_item_equipment_slot;
         this.cashItemName = cash_item_name;
@@ -205,6 +209,7 @@ class CharacterCashItemEquipmentPresetDto extends characterCashItemEquipment.Cha
             : null;
         this.itemGender = item_gender;
         this.skills = skills;
+        this.freestyleFlag = freestyle_flag;
         if (date_expire === 'expired') {
             this.isExpired = true;
         }
@@ -220,6 +225,12 @@ class CharacterCashItemEquipmentPresetDto extends characterCashItemEquipment.Cha
                 : null;
         }
     }
+    /**
+     * 自由造型券 使用狀態
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
+    }
 }
 
 exports.CharacterCashItemEquipmentColoringPrismDto = CharacterCashItemEquipmentColoringPrismDto;

package/dist/cjs/maplestory/api/tms/dto/character/characterItemEquipment.js

@@ -44,6 +44,10 @@ class CharacterItemEquipmentDto extends characterItemEquipment.CharacterItemEqui
      * 稱號資訊
      */
     title;
+    /**
+     * 外型設定中已登錄勳章的外型資訊
+     */
+    medalShape;
     /**
      * 龍魔導士的龍道具資訊 (僅在龍魔導士時回應)
      */
@@ -54,7 +58,7 @@ class CharacterItemEquipmentDto extends characterItemEquipment.CharacterItemEqui
     mechanicEquipment;
     constructor(obj) {
         super();
-        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;
+        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;
         this.date = date ? new Date(date) : null;
         this.characterGender = character_gender;
         this.characterClass = character_class;
@@ -67,6 +71,9 @@ class CharacterItemEquipmentDto extends characterItemEquipment.CharacterItemEqui
         this.itemEquipmentPreset3 =
             item_equipment_preset_3?.map((equipment) => new CharacterItemEquipmentInfoDto(equipment)) ?? [];
         this.title = title ? new CharacterItemEquipmentTitleDto(title) : null;
+        this.medalShape = medal_shape
+            ? new CharacterItemEquipmentMedalShapeDto(medal_shape)
+            : null;
         this.dragonEquipment = dragon_equipment.map((equipment) => new CharacterItemEquipmentDragonInfoDto(equipment));
         this.mechanicEquipment = mechanic_equipment.map((equipment) => new CharacterItemEquipmentMechanicInfoDto(equipment));
     }
@@ -140,6 +147,45 @@ class CharacterItemEquipmentTitleDto extends characterItemEquipment.CharacterIte
         }
     }
 }
+/**
+ * 外型設定中已登錄勳章的外型資訊
+ */
+class CharacterItemEquipmentMedalShapeDto extends characterItemEquipment.CharacterItemEquipmentMedalShapeDto {
+    /**
+     * 外型設定中已登錄勳章的道具名稱
+     */
+    medalShapeName;
+    /**
+     * 外型設定中已登錄勳章的圖示
+     */
+    medalShapeIcon;
+    /**
+     * 外型設定中已登錄勳章的描述
+     */
+    medalShapeDescription;
+    /**
+     * 外型設定中已登錄勳章的鐵砧套用道具名稱
+     */
+    medalShapeChangedName;
+    /**
+     * 外型設定中已登錄勳章的鐵砧套用圖示
+     */
+    medalShapeChangedIcon;
+    /**
+     * 外型設定中已登錄勳章的鐵砧套用勳章說明
+     */
+    medalShapeChangedDescription;
+    constructor(obj) {
+        super();
+        const { medal_shape_name, medal_shape_icon, medal_shape_description, medal_shape_changed_name, medal_shape_changed_icon, medal_shape_changed_description, } = obj;
+        this.medalShapeName = medal_shape_name;
+        this.medalShapeIcon = medal_shape_icon;
+        this.medalShapeDescription = medal_shape_description;
+        this.medalShapeChangedName = medal_shape_changed_name;
+        this.medalShapeChangedIcon = medal_shape_changed_icon;
+        this.medalShapeChangedDescription = medal_shape_changed_description;
+    }
+}
 /**
  * 附加道具選項
  */
@@ -719,9 +765,13 @@ class CharacterItemEquipmentDragonInfoDto extends characterItemEquipment.Charact
      * Whether the equipment is expired
      */
     isExpired = null;
+    /**
+     * 自由造型券 使用狀態（0：未使用，1：已使用）
+     */
+    freestyleFlag;
     constructor(obj) {
         super();
-        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;
+        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;
         this.itemEquipmentPart = item_equipment_part;
         this.itemEquipmentSlot = item_equipment_slot;
         this.itemName = item_name;
@@ -749,6 +799,7 @@ class CharacterItemEquipmentDragonInfoDto extends characterItemEquipment.Charact
         this.starforceScrollFlag = starforce_scroll_flag;
         this.itemStarforceOption = new CharacterItemEquipmentStarforceOptionDto(item_starforce_option);
         this.specialRingLevel = special_ring_level;
+        this.freestyleFlag = freestyle_flag;
         if (date_expire === 'expired') {
             this.isExpired = true;
         }
@@ -756,6 +807,12 @@ class CharacterItemEquipmentDragonInfoDto extends characterItemEquipment.Charact
             this.dateExpire = date_expire ? new Date(date_expire) : null;
         }
     }
+    /**
+     * 自由造型券 使用狀態
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
+    }
 }
 /**
  * 機甲戰神道具資訊
@@ -877,9 +934,13 @@ class CharacterItemEquipmentMechanicInfoDto extends characterItemEquipment.Chara
      * Whether the equipment is expired
      */
     isExpired = null;
+    /**
+     * 自由造型券 使用狀態（0：未使用，1：已使用）
+     */
+    freestyleFlag;
     constructor(obj) {
         super();
-        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;
+        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;
         this.itemEquipmentPart = item_equipment_part;
         this.itemEquipmentSlot = item_equipment_slot;
         this.itemName = item_name;
@@ -907,6 +968,7 @@ class CharacterItemEquipmentMechanicInfoDto extends characterItemEquipment.Chara
         this.starforceScrollFlag = starforce_scroll_flag;
         this.itemStarforceOption = new CharacterItemEquipmentStarforceOptionDto(item_starforce_option);
         this.specialRingLevel = special_ring_level;
+        this.freestyleFlag = freestyle_flag;
         if (date_expire === 'expired') {
             this.isExpired = true;
         }
@@ -914,6 +976,12 @@ class CharacterItemEquipmentMechanicInfoDto extends characterItemEquipment.Chara
             this.dateExpire = date_expire ? new Date(date_expire) : null;
         }
     }
+    /**
+     * 自由造型券 使用狀態
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
+    }
 }
 /**
  * 道具資訊
@@ -1075,9 +1143,13 @@ class CharacterItemEquipmentInfoDto extends characterItemEquipment.CharacterItem
      * Whether the equipment is expired
      */
     isExpired = null;
+    /**
+     * 自由造型券 使用狀態（0：未使用，1：已使用）
+     */
+    freestyleFlag;
     constructor(obj) {
         super();
-        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;
+        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;
         this.itemEquipmentPart = item_equipment_part;
         this.itemEquipmentSlot = item_equipment_slot;
         this.itemName = item_name;
@@ -1115,6 +1187,7 @@ class CharacterItemEquipmentInfoDto extends characterItemEquipment.CharacterItem
         this.starforceScrollFlag = starforce_scroll_flag;
         this.itemStarforceOption = new CharacterItemEquipmentStarforceOptionDto(item_starforce_option);
         this.specialRingLevel = special_ring_level;
+        this.freestyleFlag = freestyle_flag;
         if (date_expire === 'expired') {
             this.isExpired = true;
         }
@@ -1122,6 +1195,12 @@ class CharacterItemEquipmentInfoDto extends characterItemEquipment.CharacterItem
             this.dateExpire = date_expire ? new Date(date_expire) : null;
         }
     }
+    /**
+     * 自由造型券 使用狀態
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
+    }
 }
 
 exports.CharacterItemEquipmentAddOptionDto = CharacterItemEquipmentAddOptionDto;
@@ -1132,6 +1211,7 @@ exports.CharacterItemEquipmentEtcOptionDto = CharacterItemEquipmentEtcOptionDto;
 exports.CharacterItemEquipmentExceptionalOptionDto = CharacterItemEquipmentExceptionalOptionDto;
 exports.CharacterItemEquipmentInfoDto = CharacterItemEquipmentInfoDto;
 exports.CharacterItemEquipmentMechanicInfoDto = CharacterItemEquipmentMechanicInfoDto;
+exports.CharacterItemEquipmentMedalShapeDto = CharacterItemEquipmentMedalShapeDto;
 exports.CharacterItemEquipmentStarforceOptionDto = CharacterItemEquipmentStarforceOptionDto;
 exports.CharacterItemEquipmentTitleDto = CharacterItemEquipmentTitleDto;
 exports.CharacterItemEquipmentTotalOptionDto = CharacterItemEquipmentTotalOptionDto;

package/dist/cjs/maplestory/api/tms/dto/union/unionChampion.js

@@ -0,0 +1,79 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var unionChampion = require('../../../common/dto/union/unionChampion.js');
+
+/**
+ * 聯盟冠軍資訊
+ */
+class UnionChampionDto extends unionChampion.UnionChampionDto {
+    date;
+    /**
+     * 聯盟冠軍資訊
+     */
+    unionChampion;
+    /**
+     * 冠軍徽章效果
+     */
+    championBadgeTotalInfo;
+    constructor(obj) {
+        super();
+        const { date, union_champion, champion_badge_total_info } = obj;
+        this.date = date ? new Date(date) : null;
+        this.unionChampion = union_champion.map((info) => new UnionChampionInfoDto(info));
+        this.championBadgeTotalInfo = champion_badge_total_info.map((info) => new UnionChampionBadgeInfoDto(info));
+    }
+}
+/**
+ * 聯盟冠軍徽章資訊
+ */
+class UnionChampionBadgeInfoDto extends unionChampion.UnionChampionBadgeInfoDto {
+    /**
+     * 聯盟冠軍徽章資訊
+     */
+    stat;
+    constructor(obj) {
+        super();
+        const { stat } = obj;
+        this.stat = stat;
+    }
+}
+/**
+ * 聯盟冠軍資訊
+ */
+class UnionChampionInfoDto extends unionChampion.UnionChampionInfoDto {
+    /**
+     * 聯盟冠軍角色名稱
+     */
+    championName;
+    /**
+     * 聯盟冠軍欄位
+     */
+    championSlot;
+    /**
+     * 聯盟冠軍等級
+     */
+    championGrade;
+    /**
+     * 聯盟冠軍角色職業
+     */
+    championClass;
+    /**
+     * 聯盟冠軍徽章資訊
+     */
+    championBadgeInfo;
+    constructor(obj) {
+        super();
+        const { champion_name, champion_slot, champion_grade, champion_class, champion_badge_info, } = obj;
+        this.championName = champion_name;
+        this.championSlot = champion_slot;
+        this.championGrade = champion_grade;
+        this.championClass = champion_class;
+        this.championBadgeInfo = champion_badge_info.map((info) => new UnionChampionBadgeInfoDto(info));
+    }
+}
+
+exports.UnionChampionBadgeInfoDto = UnionChampionBadgeInfoDto;
+exports.UnionChampionDto = UnionChampionDto;
+exports.UnionChampionInfoDto = UnionChampionInfoDto;

package/dist/cjs/maplestory/api/tms/mapleStoryApi.js

@@ -29,6 +29,7 @@ var guild = require('./dto/guild/guild.js');
 var guildBasic = require('./dto/guild/guildBasic.js');
 var union = require('./dto/union/union.js');
 var unionArtifact = require('./dto/union/unionArtifact.js');
+var unionChampion = require('./dto/union/unionChampion.js');
 var unionRaider = require('./dto/union/unionRaider.js');
 var characterImage = require('../common/enum/characterImage.js');
 var mapleStoryApi = require('../common/mapleStoryApi.js');
@@ -819,6 +820,37 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         }
         return new unionArtifact.UnionArtifactDto(data);
     }
+    /**
+     * 查詢聯盟冠軍資訊。
+     * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
+     * - 您可以從 2025 年 12 月 18 日起搜尋資料。
+     * - 您可以輸入所需日期以搜尋過往資料。前一日的資料將於翌日凌晨 2:00 起提供。(當您搜尋 10 月 15 日的資料時，將會擷取從 15 日 00:00 到 16 日 00:00 的資料。)
+     * - 由於遊戲內容變動，OCID 可能會有所變更。在更新以 OCID 為基礎的服務時，請務必留意。
+     * - 此 API 提供來自楓之谷台灣的資料。
+     * @param ocid 角色辨識器
+     * @param dateOptions 要搜尋的日期 (TST)
+     */
+    async getUnionChampion(ocid, dateOptions) {
+        const path = `${this.subUrl}/v1/user/union-champion`;
+        const date = dateOptions
+            ? this.toDateString(dateOptions, {
+                year: 2025,
+                month: 12,
+                day: 18,
+            })
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
+        return new unionChampion.UnionChampionDto(data);
+    }
     //#endregion
     //#region 檢視公會資訊
     /**

package/dist/cjs/maplestory/api/tms/tms.js

@@ -28,6 +28,7 @@ var guild = require('./dto/guild/guild.js');
 var guildBasic = require('./dto/guild/guildBasic.js');
 var union = require('./dto/union/union.js');
 var unionArtifact = require('./dto/union/unionArtifact.js');
+var unionChampion = require('./dto/union/unionChampion.js');
 var unionRaider = require('./dto/union/unionRaider.js');
 
 
@@ -71,6 +72,7 @@ exports.CharacterItemEquipmentEtcOptionDto = characterItemEquipment.CharacterIte
 exports.CharacterItemEquipmentExceptionalOptionDto = characterItemEquipment.CharacterItemEquipmentExceptionalOptionDto;
 exports.CharacterItemEquipmentInfoDto = characterItemEquipment.CharacterItemEquipmentInfoDto;
 exports.CharacterItemEquipmentMechanicInfoDto = characterItemEquipment.CharacterItemEquipmentMechanicInfoDto;
+exports.CharacterItemEquipmentMedalShapeDto = characterItemEquipment.CharacterItemEquipmentMedalShapeDto;
 exports.CharacterItemEquipmentStarforceOptionDto = characterItemEquipment.CharacterItemEquipmentStarforceOptionDto;
 exports.CharacterItemEquipmentTitleDto = characterItemEquipment.CharacterItemEquipmentTitleDto;
 exports.CharacterItemEquipmentTotalOptionDto = characterItemEquipment.CharacterItemEquipmentTotalOptionDto;
@@ -101,6 +103,9 @@ exports.UnionDto = union.UnionDto;
 exports.UnionArtifactCrystalDto = unionArtifact.UnionArtifactCrystalDto;
 exports.UnionArtifactDto = unionArtifact.UnionArtifactDto;
 exports.UnionArtifactEffectDto = unionArtifact.UnionArtifactEffectDto;
+exports.UnionChampionBadgeInfoDto = unionChampion.UnionChampionBadgeInfoDto;
+exports.UnionChampionDto = unionChampion.UnionChampionDto;
+exports.UnionChampionInfoDto = unionChampion.UnionChampionInfoDto;
 exports.UnionRaiderBlockControlPointDto = unionRaider.UnionRaiderBlockControlPointDto;
 exports.UnionRaiderBlockDto = unionRaider.UnionRaiderBlockDto;
 exports.UnionRaiderBlockPositionDto = unionRaider.UnionRaiderBlockPositionDto;

package/dist/esm/index.js

@@ -13,7 +13,7 @@ export { CharacterHexaMatrixDto, CharacterHexaMatrixEquipmentDto, CharacterHexaM
 export { CharacterHexaMatrixStatCoreDto, CharacterHexaMatrixStatDto } from './maplestory/api/common/dto/character/characterHexaMatrixStat.js';
 export { CharacterHyperStatDto, CharacterHyperStatPresetDto } from './maplestory/api/common/dto/character/characterHyperStat.js';
 export { CharacterImageDto } from './maplestory/api/common/dto/character/characterImage.js';
-export { CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto } from './maplestory/api/common/dto/character/characterItemEquipment.js';
+export { CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentMedalShapeDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto } from './maplestory/api/common/dto/character/characterItemEquipment.js';
 export { CharacterLinkSkillDto, CharacterLinkSkillInfoDto } from './maplestory/api/common/dto/character/characterLinkSkill.js';
 export { CharacterPetEquipmentAutoSkillDto, CharacterPetEquipmentDto, CharacterPetEquipmentItemDto, CharacterPetEquipmentItemOptionDto } from './maplestory/api/common/dto/character/characterPetEquipment.js';
 export { CharacterPopularityDto } from './maplestory/api/common/dto/character/characterPopularity.js';
@@ -27,4 +27,5 @@ export { GuildDto } from './maplestory/api/common/dto/guild/guild.js';
 export { GuildBasicDto, GuildSkillDto } from './maplestory/api/common/dto/guild/guildBasic.js';
 export { UnionDto } from './maplestory/api/common/dto/union/union.js';
 export { UnionArtifactCrystalDto, UnionArtifactDto, UnionArtifactEffectDto } from './maplestory/api/common/dto/union/unionArtifact.js';
+export { UnionChampionBadgeInfoDto, UnionChampionDto, UnionChampionInfoDto } from './maplestory/api/common/dto/union/unionChampion.js';
 export { UnionRaiderBlockControlPointDto, UnionRaiderBlockDto, UnionRaiderBlockPositionDto, UnionRaiderDto, UnionRaiderInnerStatDto, UnionRaiderPresetDto } from './maplestory/api/common/dto/union/unionRaider.js';

package/dist/esm/maplestory/api/common/dto/character/characterItemEquipment.js

@@ -14,6 +14,8 @@ class CharacterItemEquipmentStarforceOptionDto {
 }
 class CharacterItemEquipmentTotalOptionDto {
 }
+class CharacterItemEquipmentMedalShapeDto {
+}
 class CharacterItemEquipmentDragonInfoDto {
 }
 class CharacterItemEquipmentMechanicInfoDto {
@@ -21,4 +23,4 @@ class CharacterItemEquipmentMechanicInfoDto {
 class CharacterItemEquipmentInfoDto {
 }
 
-export { CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto };
+export { CharacterItemEquipmentAddOptionDto, CharacterItemEquipmentBaseOptionDto, CharacterItemEquipmentDragonInfoDto, CharacterItemEquipmentDto, CharacterItemEquipmentEtcOptionDto, CharacterItemEquipmentExceptionalOptionDto, CharacterItemEquipmentInfoDto, CharacterItemEquipmentMechanicInfoDto, CharacterItemEquipmentMedalShapeDto, CharacterItemEquipmentStarforceOptionDto, CharacterItemEquipmentTitleDto, CharacterItemEquipmentTotalOptionDto };

package/dist/esm/maplestory/api/common/dto/union/unionChampion.js

@@ -0,0 +1,8 @@
+class UnionChampionDto {
+}
+class UnionChampionBadgeInfoDto {
+}
+class UnionChampionInfoDto {
+}
+
+export { UnionChampionBadgeInfoDto, UnionChampionDto, UnionChampionInfoDto };