maplestory-openapi 3.7.0 → 3.8.1

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

@@ -44,6 +44,10 @@ class CharacterItemEquipmentDto extends characterItemEquipment.CharacterItemEqui
      * Title information
      */
     title;
+    /**
+     * Medal appearance information registered in the appearance settings
+     */
+    medalShape;
     /**
      * Evan Dragon equipment information (response provided if the character is Evan)
      */
@@ -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));
     }
@@ -103,12 +110,27 @@ class CharacterItemEquipmentTitleDto extends characterItemEquipment.CharacterIte
      * Whether the title option is expired
      */
     isOptionExpired = null;
+    /**
+     * Title equipment name registered in the appearance settings
+     */
+    titleShapeName;
+    /**
+     * Title icon registered in the appearance settings
+     */
+    titleShapeIcon;
+    /**
+     * Title description registered in the appearance settings
+     */
+    titleShapeDescription;
     constructor(obj) {
         super();
-        const { title_name, title_icon, title_description, date_expire, date_option_expire, } = obj;
+        const { title_name, title_icon, title_description, date_expire, date_option_expire, title_shape_name, title_shape_icon, title_shape_description, } = obj;
         this.titleName = title_name;
         this.titleIcon = title_icon;
         this.titleDescription = title_description;
+        this.titleShapeName = title_shape_name;
+        this.titleShapeIcon = title_shape_icon;
+        this.titleShapeDescription = title_shape_description;
         if (date_expire === 'expired') {
             this.isExpired = true;
         }
@@ -125,6 +147,45 @@ class CharacterItemEquipmentTitleDto extends characterItemEquipment.CharacterIte
         }
     }
 }
+/**
+ * Medal appearance information
+ */
+class CharacterItemEquipmentMedalShapeDto extends characterItemEquipment.CharacterItemEquipmentMedalShapeDto {
+    /**
+     * Medal equipment name registered in the appearance settings
+     */
+    medalShapeName;
+    /**
+     * Medal icon registered in the appearance settings
+     */
+    medalShapeIcon;
+    /**
+     * Medal description registered in the appearance settings
+     */
+    medalShapeDescription;
+    /**
+     * Fusion Anvil-applied medal equipment name registered in the appearance settings
+     */
+    medalShapeChangedName;
+    /**
+     * Fusion Anvil-applied medal icon registered in the appearance settings
+     */
+    medalShapeChangedIcon;
+    /**
+     * Fusion Anvil-applied medal description registered in the appearance settings
+     */
+    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;
+    }
+}
 /**
  * Additional equipment options
  */
@@ -704,9 +765,13 @@ class CharacterItemEquipmentDragonInfoDto extends characterItemEquipment.Charact
      * Whether the equipment is expired
      */
     isExpired = null;
+    /**
+     * Freestyle Coupon application status (0:not applied, 1:applied)
+     */
+    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;
@@ -734,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;
         }
@@ -741,6 +807,12 @@ class CharacterItemEquipmentDragonInfoDto extends characterItemEquipment.Charact
             this.dateExpire = date_expire ? new Date(date_expire) : null;
         }
     }
+    /**
+     * Freestyle Coupon application status
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
+    }
 }
 /**
  * Mechanic equipment information
@@ -862,9 +934,13 @@ class CharacterItemEquipmentMechanicInfoDto extends characterItemEquipment.Chara
      * Whether the equipment is expired
      */
     isExpired = null;
+    /**
+     * Freestyle Coupon application status (0:not applied, 1:applied)
+     */
+    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;
@@ -892,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;
         }
@@ -899,6 +976,12 @@ class CharacterItemEquipmentMechanicInfoDto extends characterItemEquipment.Chara
             this.dateExpire = date_expire ? new Date(date_expire) : null;
         }
     }
+    /**
+     * Freestyle Coupon application status
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
+    }
 }
 /**
  * Equipment information
@@ -1060,9 +1143,13 @@ class CharacterItemEquipmentInfoDto extends characterItemEquipment.CharacterItem
      * Whether the equipment is expired
      */
     isExpired = null;
+    /**
+     * Freestyle Coupon application status (0:not applied, 1:applied)
+     */
+    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;
@@ -1100,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;
         }
@@ -1107,6 +1195,12 @@ class CharacterItemEquipmentInfoDto extends characterItemEquipment.CharacterItem
             this.dateExpire = date_expire ? new Date(date_expire) : null;
         }
     }
+    /**
+     * Freestyle Coupon application status
+     */
+    get isFreestyleFlag() {
+        return this.freestyleFlag === '1';
+    }
 }
 
 exports.CharacterItemEquipmentAddOptionDto = CharacterItemEquipmentAddOptionDto;
@@ -1117,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/msea/dto/union/unionChampion.js

@@ -0,0 +1,82 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var unionChampion = require('../../../common/dto/union/unionChampion.js');
+
+/**
+ * Union Champion information
+ */
+class UnionChampionDto extends unionChampion.UnionChampionDto {
+    /**
+     * Reference date for query (SGT, daily data with hours and minutes set to 0)
+     */
+    date;
+    /**
+     * Union Champion information
+     */
+    unionChampion;
+    /**
+     * Champion Insignia effects
+     */
+    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));
+    }
+}
+/**
+ * Champion Insignia effects
+ */
+class UnionChampionBadgeInfoDto extends unionChampion.UnionChampionBadgeInfoDto {
+    /**
+     * Union Champion Insignia effects
+     */
+    stat;
+    constructor(obj) {
+        super();
+        const { stat } = obj;
+        this.stat = stat;
+    }
+}
+/**
+ * Union Champion information
+ */
+class UnionChampionInfoDto extends unionChampion.UnionChampionInfoDto {
+    /**
+     * Union Champion character name
+     */
+    championName;
+    /**
+     * Union Champion slot
+     */
+    championSlot;
+    /**
+     * Union Champion level
+     */
+    championGrade;
+    /**
+     * Union Champion character's job
+     */
+    championClass;
+    /**
+     * Union Champion Insignia information
+     */
+    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/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;