maplestory-openapi 3.9.0 → 3.11.0

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

@@ -0,0 +1,156 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * 萌獸 資訊
+ */
+class CharacterFamiliarDto {
+    /**
+     * 要搜尋的日期 (TST，每日資料中的小時與分鐘將顯示為 0)
+     */
+    date;
+    /**
+     * 萌獸 鏈路插槽資訊
+     */
+    familiarLinkSlot;
+    /**
+     * 萌獸 細節
+     */
+    familiarInfo;
+    constructor(obj) {
+        const { date, familiar_link_slot, familiar_info } = obj;
+        this.date = date ? new Date(date) : null;
+        this.familiarLinkSlot = familiar_link_slot.map((x) => new CharacterFamiliarLinkSlotDto(x));
+        this.familiarInfo = familiar_info.map((x) => new CharacterFamiliarInfoDto(x));
+    }
+}
+/**
+ * 萌獸 鏈路插槽資訊
+ */
+class CharacterFamiliarLinkSlotDto {
+    /**
+     * 插槽標識符 (1~3, vip)
+     */
+    slotId;
+    /**
+     * 連結的 萌獸 名稱 (如果插槽中沒有任何關聯，則為 null)
+     */
+    familiarName;
+    /**
+     * 已啟用還是未啟用 (true, false)
+     */
+    activeFlag;
+    /**
+     * 截止日期
+     */
+    expireDate;
+    constructor(obj) {
+        const { slot_id, familiar_name, active_flag, expire_date } = obj;
+        this.slotId = slot_id;
+        this.familiarName = familiar_name;
+        this.activeFlag = active_flag;
+        this.expireDate = expire_date ? new Date(expire_date) : null;
+    }
+}
+/**
+ * 萌獸 細節
+ */
+class CharacterFamiliarInfoDto {
+    /**
+     * 萌獸 名稱
+     */
+    familiarName;
+    /**
+     * 萌獸 暱稱
+     */
+    familiarNickname;
+    /**
+     * 特別與否
+     */
+    familiarSpecialFlag;
+    /**
+     * 萌獸 情況
+     */
+    familiarState;
+    /**
+     * 等級
+     */
+    familiarLevel;
+    /**
+     * 經驗
+     */
+    familiarExp;
+    /**
+     * 具備的技能
+     */
+    skillName;
+    /**
+     * 選項等級
+     */
+    optionLevel;
+    /**
+     * 選項訊息
+     */
+    option;
+    /**
+     * 等級
+     */
+    familiarGrade;
+    /**
+     * 外觀名稱
+     */
+    lookName;
+    /**
+     * 當前是否已被召喚
+     */
+    summonedFlag;
+    /**
+     * 連結槽索引 (1~3, vip, not link)
+     */
+    slotId;
+    constructor(obj) {
+        const { familiar_name, familiar_nickname, familiar_special_flag, familiar_state, familiar_level, familiar_exp, skill_name, option_level, option, familiar_grade, look_name, summoned_flag, slot_id, } = obj;
+        this.familiarName = familiar_name;
+        this.familiarNickname = familiar_nickname;
+        this.familiarSpecialFlag = familiar_special_flag;
+        this.familiarState = familiar_state;
+        this.familiarLevel = familiar_level;
+        this.familiarExp = familiar_exp;
+        this.skillName = skill_name;
+        this.optionLevel = option_level;
+        this.option = option.map((x) => new CharacterFamiliarInfoOptionDto(x));
+        this.familiarGrade = familiar_grade;
+        this.lookName = look_name;
+        this.summonedFlag = summoned_flag;
+        this.slotId = slot_id;
+    }
+}
+/**
+ * 選項訊息
+ */
+class CharacterFamiliarInfoOptionDto {
+    /**
+     * 選項號
+     */
+    optionNo;
+    /**
+     * 選項名稱
+     */
+    optionName;
+    /**
+     * 選擇權價值
+     */
+    optionValue;
+    constructor(obj) {
+        const { option_no, option_name, option_value } = obj;
+        this.optionNo = option_no;
+        this.optionName = option_name;
+        this.optionValue = option_value;
+    }
+}
+
+exports.CharacterFamiliarDto = CharacterFamiliarDto;
+exports.CharacterFamiliarInfoDto = CharacterFamiliarInfoDto;
+exports.CharacterFamiliarInfoOptionDto = CharacterFamiliarInfoOptionDto;
+exports.CharacterFamiliarLinkSlotDto = CharacterFamiliarLinkSlotDto;

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

@@ -60,6 +60,10 @@ class CharacterPetEquipmentDto extends characterPetEquipment.CharacterPetEquipme
      * 寵物 1 外型圖示
      */
     pet1AppearanceIcon;
+    /**
+     * 寵物1 潛在的
+     */
+    pet1Potential;
     /**
      * 寵物 2 名稱
      */
@@ -108,6 +112,10 @@ class CharacterPetEquipmentDto extends characterPetEquipment.CharacterPetEquipme
      * 寵物 2 外型圖示
      */
     pet2AppearanceIcon;
+    /**
+     * 寵物2 潛在的
+     */
+    pet2Potential;
     /**
      * 寵物 3 名稱
      */
@@ -156,9 +164,13 @@ class CharacterPetEquipmentDto extends characterPetEquipment.CharacterPetEquipme
      * 寵物 3 外型圖示
      */
     pet3AppearanceIcon;
+    /**
+     * 寵物3 潛在的
+     */
+    pet3Potential;
     constructor(obj) {
         super();
-        const { date, pet_1_name, pet_1_nickname, pet_1_icon, pet_1_description, pet_1_equipment, pet_1_auto_skill, pet_1_pet_type, pet_1_skill, pet_1_date_expire, pet_1_appearance, pet_1_appearance_icon, pet_2_name, pet_2_nickname, pet_2_icon, pet_2_description, pet_2_equipment, pet_2_auto_skill, pet_2_pet_type, pet_2_skill, pet_2_date_expire, pet_2_appearance, pet_2_appearance_icon, pet_3_name, pet_3_nickname, pet_3_icon, pet_3_description, pet_3_equipment, pet_3_auto_skill, pet_3_pet_type, pet_3_skill, pet_3_date_expire, pet_3_appearance, pet_3_appearance_icon, } = obj;
+        const { date, pet_1_name, pet_1_nickname, pet_1_icon, pet_1_description, pet_1_equipment, pet_1_auto_skill, pet_1_pet_type, pet_1_skill, pet_1_date_expire, pet_1_appearance, pet_1_appearance_icon, pet_1_potential, pet_2_name, pet_2_nickname, pet_2_icon, pet_2_description, pet_2_equipment, pet_2_auto_skill, pet_2_pet_type, pet_2_skill, pet_2_date_expire, pet_2_appearance, pet_2_appearance_icon, pet_2_potential, pet_3_name, pet_3_nickname, pet_3_icon, pet_3_description, pet_3_equipment, pet_3_auto_skill, pet_3_pet_type, pet_3_skill, pet_3_date_expire, pet_3_appearance, pet_3_appearance_icon, pet_3_potential, } = obj;
         this.date = date ? new Date(date) : null;
         this.pet1Name = pet_1_name;
         this.pet1Nickname = pet_1_nickname;
@@ -174,6 +186,7 @@ class CharacterPetEquipmentDto extends characterPetEquipment.CharacterPetEquipme
         this.pet1Skill = pet_1_skill;
         this.pet1Appearance = pet_1_appearance;
         this.pet1AppearanceIcon = pet_1_appearance_icon;
+        this.pet1Potential = pet_1_potential.map((potential) => new CharacterPetEquipmentPotentialDto(potential));
         this.pet2Name = pet_2_name;
         this.pet2Nickname = pet_2_nickname;
         this.pet2Icon = pet_2_icon;
@@ -188,6 +201,7 @@ class CharacterPetEquipmentDto extends characterPetEquipment.CharacterPetEquipme
         this.pet2Skill = pet_2_skill;
         this.pet2Appearance = pet_2_appearance;
         this.pet2AppearanceIcon = pet_2_appearance_icon;
+        this.pet2Potential = pet_2_potential.map((potential) => new CharacterPetEquipmentPotentialDto(potential));
         this.pet3Name = pet_3_name;
         this.pet3Nickname = pet_3_nickname;
         this.pet3Icon = pet_3_icon;
@@ -202,6 +216,7 @@ class CharacterPetEquipmentDto extends characterPetEquipment.CharacterPetEquipme
         this.pet3Skill = pet_3_skill;
         this.pet3Appearance = pet_3_appearance;
         this.pet3AppearanceIcon = pet_3_appearance_icon;
+        this.pet3Potential = pet_3_potential.map((potential) => new CharacterPetEquipmentPotentialDto(potential));
         if (pet_1_date_expire === 'expired') {
             this.pet1Expired = true;
         }
@@ -325,8 +340,37 @@ class CharacterPetEquipmentItemDto extends characterPetEquipment.CharacterPetEqu
         this.itemShapeIcon = item_shape_icon;
     }
 }
+/**
+ * 寵物 潛在的
+ */
+class CharacterPetEquipmentPotentialDto {
+    /**
+     * 潛在的 步 (1~3, 0:停用)
+     */
+    potentialStep;
+    /**
+     * 潛在的 類型
+     */
+    potentialType;
+    /**
+     * 潛在的 增加 (對於攻擊力/魔法攻擊力以外的其他潛在能力類型，百分比)
+     */
+    potentialIncrease1;
+    /**
+     * 潛在的 增加 2 (如果潛在能力類型為攻擊力/魔法攻擊力，則攻擊力分配給 potential_increase_1，魔法攻擊力分配給 potential_increase_2；如果潛在能力類型為最大生命值/最大魔法值，則最大生命值分配給 potential_increase_1，最大魔法值分配給 potential_increase_2。)
+     */
+    potentialIncrease2;
+    constructor(obj) {
+        const { potential_step, potential_type, potential_increase1, potential_increase2, } = obj;
+        this.potentialStep = potential_step;
+        this.potentialType = potential_type;
+        this.potentialIncrease1 = potential_increase1;
+        this.potentialIncrease2 = potential_increase2;
+    }
+}
 
 exports.CharacterPetEquipmentAutoSkillDto = CharacterPetEquipmentAutoSkillDto;
 exports.CharacterPetEquipmentDto = CharacterPetEquipmentDto;
 exports.CharacterPetEquipmentItemDto = CharacterPetEquipmentItemDto;
 exports.CharacterPetEquipmentItemOptionDto = CharacterPetEquipmentItemOptionDto;
+exports.CharacterPetEquipmentPotentialDto = CharacterPetEquipmentPotentialDto;

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

@@ -4,6 +4,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var axios = require('axios');
 require('../../../node_modules/buffer/index.js');
+var lib = require('../common/lib.js');
 var character = require('./dto/character/character.js');
 var characterAbility = require('./dto/character/characterAbility.js');
 var characterAndroidEquipment = require('./dto/character/characterAndroidEquipment.js');
@@ -11,6 +12,7 @@ var characterBasic = require('./dto/character/characterBasic.js');
 var characterBeautyEquipment = require('./dto/character/characterBeautyEquipment.js');
 var characterCashItemEquipment = require('./dto/character/characterCashItemEquipment.js');
 var characterDojang = require('./dto/character/characterDojang.js');
+var characterFamiliar = require('./dto/character/characterFamiliar.js');
 var characterHexaMatrix = require('./dto/character/characterHexaMatrix.js');
 var characterHexaMatrixStat = require('./dto/character/characterHexaMatrixStat.js');
 var characterHyperStat = require('./dto/character/characterHyperStat.js');
@@ -33,7 +35,6 @@ 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');
-var lib = require('../common/lib.js');
 var index = require('../../../_virtual/index.js_commonjs-exports.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
@@ -725,6 +726,37 @@ class MapleStoryApi extends mapleStoryApi.MapleStoryApi {
         }
         return new characterDojang.CharacterDojangDto(data);
     }
+    /**
+     * 檢視萌獸資訊。
+     * - 楓之谷遊戲資料平均在 15 分鐘後即可使用。
+     * - 您可以從 2025 年 10 月 15 日起搜尋資料。
+     * - 您可以輸入所需日期以搜尋過往資料。前一日的資料將於翌日凌晨 2:00 起提供。(當您搜尋 10 月 15 日的資料時，將會擷取從 15 日 00:00 到 16 日 00:00 的資料。)
+     * - 由於遊戲內容變動，OCID 可能會有所變更。在更新以 OCID 為基礎的服務時，請務必留意。
+     * - 此 API 提供來自楓之谷台灣的資料。
+     * @param ocid 角色辨識器
+     * @param dateOptions 要搜尋的日期 (TST)
+     */
+    async getCharacterFamiliar(ocid, dateOptions) {
+        const path = `${this.subUrl}/v1/character/familiar`;
+        const date = dateOptions
+            ? this.toDateString(dateOptions, {
+                year: 2025,
+                month: 10,
+                day: 15,
+            })
+            : undefined;
+        const query = {
+            ocid: ocid,
+            date: date,
+        };
+        const { data } = await this.client.get(path, {
+            params: query,
+        });
+        if (this.isEmptyResponse(data)) {
+            return null;
+        }
+        return new characterFamiliar.CharacterFamiliarDto(data);
+    }
     //#endregion
     //#region 檢視聯盟資訊
     /**

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

@@ -10,6 +10,7 @@ var characterBasic = require('./dto/character/characterBasic.js');
 var characterBeautyEquipment = require('./dto/character/characterBeautyEquipment.js');
 var characterCashItemEquipment = require('./dto/character/characterCashItemEquipment.js');
 var characterDojang = require('./dto/character/characterDojang.js');
+var characterFamiliar = require('./dto/character/characterFamiliar.js');
 var characterHexaMatrix = require('./dto/character/characterHexaMatrix.js');
 var characterHexaMatrixStat = require('./dto/character/characterHexaMatrixStat.js');
 var characterHyperStat = require('./dto/character/characterHyperStat.js');
@@ -56,6 +57,10 @@ exports.CharacterCashItemEquipmentDto = characterCashItemEquipment.CharacterCash
 exports.CharacterCashItemEquipmentOptionDto = characterCashItemEquipment.CharacterCashItemEquipmentOptionDto;
 exports.CharacterCashItemEquipmentPresetDto = characterCashItemEquipment.CharacterCashItemEquipmentPresetDto;
 exports.CharacterDojangDto = characterDojang.CharacterDojangDto;
+exports.CharacterFamiliarDto = characterFamiliar.CharacterFamiliarDto;
+exports.CharacterFamiliarInfoDto = characterFamiliar.CharacterFamiliarInfoDto;
+exports.CharacterFamiliarInfoOptionDto = characterFamiliar.CharacterFamiliarInfoOptionDto;
+exports.CharacterFamiliarLinkSlotDto = characterFamiliar.CharacterFamiliarLinkSlotDto;
 exports.CharacterHexaMatrixDto = characterHexaMatrix.CharacterHexaMatrixDto;
 exports.CharacterHexaMatrixEquipmentDto = characterHexaMatrix.CharacterHexaMatrixEquipmentDto;
 exports.CharacterHexaMatrixEquipmentLinkedSkillDto = characterHexaMatrix.CharacterHexaMatrixEquipmentLinkedSkillDto;
@@ -82,6 +87,7 @@ exports.CharacterPetEquipmentAutoSkillDto = characterPetEquipment.CharacterPetEq
 exports.CharacterPetEquipmentDto = characterPetEquipment.CharacterPetEquipmentDto;
 exports.CharacterPetEquipmentItemDto = characterPetEquipment.CharacterPetEquipmentItemDto;
 exports.CharacterPetEquipmentItemOptionDto = characterPetEquipment.CharacterPetEquipmentItemOptionDto;
+exports.CharacterPetEquipmentPotentialDto = characterPetEquipment.CharacterPetEquipmentPotentialDto;
 exports.CharacterPopularityDto = characterPopularity.CharacterPopularityDto;
 exports.CharacterPropensityDto = characterPropensity.CharacterPropensityDto;
 exports.CharacterSetEffectDto = characterSetEffect.CharacterSetEffectDto;

package/dist/cjs/node_modules/base64-js/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('../../_virtual/index.js_commonjs-exports3.js');
+var index = require('../../_virtual/index.js_commonjs-exports2.js');
 
 index.__exports.byteLength = byteLength;
 index.__exports.toByteArray = toByteArray;

package/dist/cjs/node_modules/buffer/index.js

@@ -3,8 +3,8 @@
 var index = require('../../_virtual/index.js_commonjs-exports.js');
 require('../base64-js/index.js');
 require('../ieee754/index.js');
-var index$1 = require('../../_virtual/index.js_commonjs-exports3.js');
-var index$2 = require('../../_virtual/index.js_commonjs-exports2.js');
+var index$1 = require('../../_virtual/index.js_commonjs-exports2.js');
+var index$2 = require('../../_virtual/index.js_commonjs-exports3.js');
 
 /*!
  * The buffer module from node.js, for the browser.

package/dist/cjs/node_modules/ieee754/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('../../_virtual/index.js_commonjs-exports2.js');
+var index = require('../../_virtual/index.js_commonjs-exports3.js');
 
 /*! ieee754. BSD-3-Clause License. Feross Aboukhadijeh <https://feross.org/opensource> */
 

package/dist/esm/_virtual/index.js_commonjs-exports2.js

@@ -1,3 +1,3 @@
-var ieee754 = {};
+var base64Js = {};
 
-export { ieee754 as __exports };
+export { base64Js as __exports };

package/dist/esm/_virtual/index.js_commonjs-exports3.js

@@ -1,3 +1,3 @@
-var base64Js = {};
+var ieee754 = {};
 
-export { base64Js as __exports };
+export { ieee754 as __exports };