maplestory-openapi 1.0.0

package/dist/index.js

@@ -0,0 +1,288 @@
+'use strict';
+
+var axios = require('axios');
+var dayjs = require('dayjs');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var axios__default = /*#__PURE__*/_interopDefaultLegacy(axios);
+var dayjs__default = /*#__PURE__*/_interopDefaultLegacy(dayjs);
+
+exports.PotentialOptionGrade = void 0;
+(function (PotentialOptionGrade) {
+    PotentialOptionGrade[PotentialOptionGrade["RARE"] = 0] = "RARE";
+    PotentialOptionGrade[PotentialOptionGrade["EPIC"] = 1] = "EPIC";
+    PotentialOptionGrade[PotentialOptionGrade["UNIQUE"] = 2] = "UNIQUE";
+    PotentialOptionGrade[PotentialOptionGrade["LEGENDARY"] = 3] = "LEGENDARY";
+})(exports.PotentialOptionGrade || (exports.PotentialOptionGrade = {}));
+/**
+ * 한글로 정의된 잠재옵션 등급을 PotentialOptionGrade으로 변환합니다.
+ *
+ * @param text support only "레어", "에픽", "유니크", "레전드리"
+ */
+const potentialOptionGradeFromString = (text) => {
+    const potentialOptionGradeMap = {
+        '레어': exports.PotentialOptionGrade.RARE,
+        '에픽': exports.PotentialOptionGrade.EPIC,
+        '유니크': exports.PotentialOptionGrade.UNIQUE,
+        '레전드리': exports.PotentialOptionGrade.LEGENDARY,
+    };
+    const grade = potentialOptionGradeMap[text];
+    if (!grade) {
+        throw new TypeError('No enum constant for string: ' + text);
+    }
+    return grade;
+};
+
+/**
+ * 큐브 결과 옵션 정보
+ */
+class CubeResultOptionDto {
+    /**
+     * 옵션 이름
+     */
+    value;
+    /**
+     * 옵션 등급
+     */
+    grade;
+    constructor(obj) {
+        const { value, grade } = obj;
+        this.value = value;
+        this.grade = grade;
+    }
+    get gradeEnum() {
+        return potentialOptionGradeFromString(this.grade);
+    }
+}
+
+/**
+ * 큐브히스토리 정보
+ */
+class CubeHistoryDto {
+    /**
+     * 큐브 사용 내역에 대한 고유 식별자
+     */
+    id;
+    /**
+     * 캐릭터이름
+     */
+    characterName;
+    /**
+     * 월드 이름
+     */
+    worldName;
+    /**
+     * 큐브 사용 날짜
+     */
+    createDate;
+    /**
+     * 사용한 큐브
+     */
+    cubeType;
+    /**
+     * 큐브 사용 결과
+     */
+    itemUpgradeResult;
+    /**
+     * 미라클 타임 적용 여부
+     */
+    miracleTimeFlag;
+    /**
+     * 장비 분류
+     */
+    itemEquipPart;
+    /**
+     * 장비 레벨
+     */
+    itemLevel;
+    /**
+     * 큐브를 사용한 장비
+     */
+    targetItem;
+    /**
+     * 잠재능력 등급
+     */
+    potentialOptionGrade;
+    /**
+     * 에디셔널 잠재능력 등급
+     */
+    additionalPotentialOptionGrade;
+    /**
+     * 천장에 도달하여 확정 등급 상승한 여부
+     */
+    upgradeGuarantee;
+    /**
+     * 현재까지 쌓은 스택
+     */
+    upgradeGuaranteeCount;
+    /**
+     * 큐브 사용 전 잠재능력 옵션
+     */
+    beforePotentialOptions;
+    /**
+     * 큐브 사용 전 에디셔널 잠재능력 옵션
+     */
+    beforeAdditionalPotentialOptions;
+    /**
+     * 큐브 사용 후 잠재능력 옵션
+     */
+    afterPotentialOptions;
+    /**
+     * 큐브 사용 후 에디셔널 잠재능력 옵션
+     */
+    afterAdditionalPotentialOptions;
+    constructor(obj) {
+        const { id, character_name, world_name, create_date, cube_type, item_upgrade_result, miracle_time_flag, item_equip_part, item_level, target_item, potential_option_grade, additional_potential_option_grade, upgradeguarantee, upgradeguaranteecount, before_potential_options, before_additional_potential_options, after_potential_options, after_additional_potential_options } = obj;
+        this.id = id;
+        this.characterName = character_name;
+        this.worldName = world_name;
+        this.createDate = create_date;
+        this.cubeType = cube_type;
+        this.itemUpgradeResult = item_upgrade_result;
+        this.miracleTimeFlag = miracle_time_flag;
+        this.itemEquipPart = item_equip_part;
+        this.itemLevel = item_level;
+        this.targetItem = target_item;
+        this.potentialOptionGrade = potential_option_grade;
+        this.additionalPotentialOptionGrade = additional_potential_option_grade;
+        this.upgradeGuarantee = upgradeguarantee;
+        this.upgradeGuaranteeCount = upgradeguaranteecount;
+        this.beforePotentialOptions = before_potential_options.map(origin => new CubeResultOptionDto(origin));
+        this.beforeAdditionalPotentialOptions = before_additional_potential_options.map(origin => new CubeResultOptionDto(origin));
+        this.afterPotentialOptions = after_potential_options.map(origin => new CubeResultOptionDto(origin));
+        this.afterAdditionalPotentialOptions = after_additional_potential_options.map(origin => new CubeResultOptionDto(origin));
+    }
+    get isItemUpgrade() {
+        return this.itemUpgradeResult === '성공';
+    }
+    get isMiracleTimeFlag() {
+        return this.miracleTimeFlag !== '이벤트 적용되지 않음';
+    }
+    get potentialOptionGradeEnum() {
+        return potentialOptionGradeFromString(this.potentialOptionGrade);
+    }
+    get additionalPotentialOptionGradeEnum() {
+        return potentialOptionGradeFromString(this.additionalPotentialOptionGrade);
+    }
+}
+
+/**
+ * 큐브히스토리 응답 정보
+ */
+class CubeHistoryResponseDto {
+    /**
+     * 결과 건 수
+     */
+    count;
+    /**
+     * 큐브 히스토리
+     */
+    cubeHistories;
+    /**
+     * 페이징 처리를 위한 cursor
+     */
+    nextCursor;
+    constructor(obj) {
+        const { count, cube_histories, next_cursor } = obj;
+        this.count = count;
+        this.cubeHistories = cube_histories.map(origin => new CubeHistoryDto(origin));
+        this.nextCursor = next_cursor;
+    }
+}
+
+/**
+ * MapleStory OpenAPI error.<br>
+ * Please refer to <a href="https://developers.nexon.com/Maplestory/guides">MapleStory API guide</a> for the error details.
+ */
+class MapleStoryApiError extends Error {
+    name = 'MapleStoryApiError';
+    status;
+    message;
+    constructor(params) {
+        const { status, message } = params;
+        super(message);
+        this.status = status;
+        this.message = message;
+    }
+}
+
+var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
+
+var timezone$1 = {exports: {}};
+
+(function (module, exports) {
+!function(t,e){module.exports=e();}(commonjsGlobal,(function(){var t={year:0,month:1,day:2,hour:3,minute:4,second:5},e={};return function(n,i,o){var r,a=function(t,n,i){void 0===i&&(i={});var o=new Date(t),r=function(t,n){void 0===n&&(n={});var i=n.timeZoneName||"short",o=t+"|"+i,r=e[o];return r||(r=new Intl.DateTimeFormat("en-US",{hour12:!1,timeZone:t,year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",timeZoneName:i}),e[o]=r),r}(n,i);return r.formatToParts(o)},u=function(e,n){for(var i=a(e,n),r=[],u=0;u<i.length;u+=1){var f=i[u],s=f.type,m=f.value,c=t[s];c>=0&&(r[c]=parseInt(m,10));}var d=r[3],l=24===d?0:d,h=r[0]+"-"+r[1]+"-"+r[2]+" "+l+":"+r[4]+":"+r[5]+":000",v=+e;return (o.utc(h).valueOf()-(v-=v%1e3))/6e4},f=i.prototype;f.tz=function(t,e){void 0===t&&(t=r);var n=this.utcOffset(),i=this.toDate(),a=i.toLocaleString("en-US",{timeZone:t}),u=Math.round((i-new Date(a))/1e3/60),f=o(a,{locale:this.$L}).$set("millisecond",this.$ms).utcOffset(15*-Math.round(i.getTimezoneOffset()/15)-u,!0);if(e){var s=f.utcOffset();f=f.add(n-s,"minute");}return f.$x.$timezone=t,f},f.offsetName=function(t){var e=this.$x.$timezone||o.tz.guess(),n=a(this.valueOf(),e,{timeZoneName:t}).find((function(t){return "timezonename"===t.type.toLowerCase()}));return n&&n.value};var s=f.startOf;f.startOf=function(t,e){if(!this.$x||!this.$x.$timezone)return s.call(this,t,e);var n=o(this.format("YYYY-MM-DD HH:mm:ss:SSS"),{locale:this.$L});return s.call(n,t,e).tz(this.$x.$timezone,!0)},o.tz=function(t,e,n){var i=n&&e,a=n||e||r,f=u(+o(),a);if("string"!=typeof t)return o(t).tz(a);var s=function(t,e,n){var i=t-60*e*1e3,o=u(i,n);if(e===o)return [i,e];var r=u(i-=60*(o-e)*1e3,n);return o===r?[i,o]:[t-60*Math.min(o,r)*1e3,Math.max(o,r)]}(o.utc(t,i).valueOf(),f,a),m=s[0],c=s[1],d=o(m).utcOffset(c);return d.$x.$timezone=a,d},o.tz.guess=function(){return Intl.DateTimeFormat().resolvedOptions().timeZone},o.tz.setDefault=function(t){r=t;};}}));
+}(timezone$1));
+
+var timezone = timezone$1.exports;
+
+var utc$1 = {exports: {}};
+
+(function (module, exports) {
+!function(t,i){module.exports=i();}(commonjsGlobal,(function(){var t="minute",i=/[+-]\d\d(?::?\d\d)?/g,e=/([+-]|\d\d)/g;return function(s,f,n){var u=f.prototype;n.utc=function(t){var i={date:t,utc:!0,args:arguments};return new f(i)},u.utc=function(i){var e=n(this.toDate(),{locale:this.$L,utc:!0});return i?e.add(this.utcOffset(),t):e},u.local=function(){return n(this.toDate(),{locale:this.$L,utc:!1})};var o=u.parse;u.parse=function(t){t.utc&&(this.$u=!0),this.$utils().u(t.$offset)||(this.$offset=t.$offset),o.call(this,t);};var r=u.init;u.init=function(){if(this.$u){var t=this.$d;this.$y=t.getUTCFullYear(),this.$M=t.getUTCMonth(),this.$D=t.getUTCDate(),this.$W=t.getUTCDay(),this.$H=t.getUTCHours(),this.$m=t.getUTCMinutes(),this.$s=t.getUTCSeconds(),this.$ms=t.getUTCMilliseconds();}else r.call(this);};var a=u.utcOffset;u.utcOffset=function(s,f){var n=this.$utils().u;if(n(s))return this.$u?0:n(this.$offset)?a.call(this):this.$offset;if("string"==typeof s&&(s=function(t){void 0===t&&(t="");var s=t.match(i);if(!s)return null;var f=(""+s[0]).match(e)||["-",0,0],n=f[0],u=60*+f[1]+ +f[2];return 0===u?0:"+"===n?u:-u}(s),null===s))return this;var u=Math.abs(s)<=16?60*s:s,o=this;if(f)return o.$offset=u,o.$u=0===s,o;if(0!==s){var r=this.$u?this.toDate().getTimezoneOffset():-1*this.utcOffset();(o=this.local().add(u+r,t)).$offset=u,o.$x.$localOffset=r;}else o=this.utc();return o};var h=u.format;u.format=function(t){var i=t||(this.$u?"YYYY-MM-DDTHH:mm:ss[Z]":"");return h.call(this,i)},u.valueOf=function(){var t=this.$utils().u(this.$offset)?0:this.$offset+(this.$x.$localOffset||this.$d.getTimezoneOffset());return this.$d.valueOf()-6e4*t},u.isUTC=function(){return !!this.$u},u.toISOString=function(){return this.toDate().toISOString()},u.toString=function(){return this.toDate().toUTCString()};var l=u.toDate;u.toDate=function(t){return "s"===t&&this.$offset?n(this.format("YYYY-MM-DD HH:mm:ss:SSS")).toDate():l.call(this)};var c=u.diff;u.diff=function(t,i,e){if(t&&this.$u===t.$u)return c.call(this,t,i,e);var s=this.local(),f=n(t).local();return c.call(s,f,i,e)};}}));
+}(utc$1));
+
+var utc = utc$1.exports;
+
+dayjs__default["default"].extend(timezone);
+dayjs__default["default"].extend(utc);
+class MapleStoryApi {
+    apiKey;
+    static baseUrl = 'https://public.api.nexon.com/';
+    static kstOffset = 540;
+    timeout;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+        this.timeout = 5000;
+    }
+    async getCubeResult(count, parameter) {
+        const query = {
+            count,
+        };
+        if (typeof parameter === 'string') {
+            query.cursor = parameter;
+        }
+        else if (typeof parameter === 'object') {
+            const { year, month, day } = parameter;
+            if (year <= 2022 && month <= 11 && day < 25) {
+                throw new Error('You can only retrieve data after 2022-11-25.');
+            }
+            const date = dayjs__default["default"](`${year}-${month}-${day}`).utcOffset(MapleStoryApi.kstOffset);
+            query.date = date.format('YYYY-MM-DD');
+        }
+        else {
+            const now = dayjs__default["default"]().utcOffset(MapleStoryApi.kstOffset);
+            query.date = now.format('YYYY-MM-DD');
+        }
+        try {
+            const path = 'openapi/maplestory/v1/cube-use-results';
+            const response = await axios__default["default"].get(path, {
+                baseURL: MapleStoryApi.baseUrl,
+                timeout: this.timeout,
+                headers: this.buildHeaders(),
+                params: query
+            });
+            return new CubeHistoryResponseDto(response.data);
+        }
+        catch (e) {
+            if (e instanceof axios.AxiosError) {
+                const errorBody = e.response.data;
+                throw new MapleStoryApiError(errorBody);
+            }
+            throw e;
+        }
+    }
+    buildHeaders() {
+        return {
+            'authorization': this.apiKey
+        };
+    }
+}
+
+exports.CubeHistoryDto = CubeHistoryDto;
+exports.CubeHistoryResponseDto = CubeHistoryResponseDto;
+exports.CubeResultOptionDto = CubeResultOptionDto;
+exports.MapleStoryApi = MapleStoryApi;
+exports.MapleStoryApiError = MapleStoryApiError;
+exports.potentialOptionGradeFromString = potentialOptionGradeFromString;

package/dist/index.min.js

@@ -0,0 +1 @@
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("axios"),require("dayjs")):"function"==typeof define&&define.amd?define(["exports","axios","dayjs"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self)["maplestory-openapi"]={},t.axios,t.dayjs)}(this,(function(t,e,i){"use strict";function a(t){return t&&"object"==typeof t&&"default"in t?t:{default:t}}var o,n=a(e),r=a(i);t.PotentialOptionGrade=void 0,(o=t.PotentialOptionGrade||(t.PotentialOptionGrade={}))[o.RARE=0]="RARE",o[o.EPIC=1]="EPIC",o[o.UNIQUE=2]="UNIQUE",o[o.LEGENDARY=3]="LEGENDARY";const s=e=>{const i={"레어":t.PotentialOptionGrade.RARE,"에픽":t.PotentialOptionGrade.EPIC,"유니크":t.PotentialOptionGrade.UNIQUE,"레전드리":t.PotentialOptionGrade.LEGENDARY}[e];if(!i)throw new TypeError("No enum constant for string: "+e);return i};class u{value;grade;constructor(t){const{value:e,grade:i}=t;this.value=e,this.grade=i}get gradeEnum(){return s(this.grade)}}class f{id;characterName;worldName;createDate;cubeType;itemUpgradeResult;miracleTimeFlag;itemEquipPart;itemLevel;targetItem;potentialOptionGrade;additionalPotentialOptionGrade;upgradeGuarantee;upgradeGuaranteeCount;beforePotentialOptions;beforeAdditionalPotentialOptions;afterPotentialOptions;afterAdditionalPotentialOptions;constructor(t){const{id:e,character_name:i,world_name:a,create_date:o,cube_type:n,item_upgrade_result:r,miracle_time_flag:s,item_equip_part:f,item_level:l,target_item:c,potential_option_grade:d,additional_potential_option_grade:h,upgradeguarantee:p,upgradeguaranteecount:m,before_potential_options:g,before_additional_potential_options:v,after_potential_options:$,after_additional_potential_options:O}=t;this.id=e,this.characterName=i,this.worldName=a,this.createDate=o,this.cubeType=n,this.itemUpgradeResult=r,this.miracleTimeFlag=s,this.itemEquipPart=f,this.itemLevel=l,this.targetItem=c,this.potentialOptionGrade=d,this.additionalPotentialOptionGrade=h,this.upgradeGuarantee=p,this.upgradeGuaranteeCount=m,this.beforePotentialOptions=g.map((t=>new u(t))),this.beforeAdditionalPotentialOptions=v.map((t=>new u(t))),this.afterPotentialOptions=$.map((t=>new u(t))),this.afterAdditionalPotentialOptions=O.map((t=>new u(t)))}get isItemUpgrade(){return"성공"===this.itemUpgradeResult}get isMiracleTimeFlag(){return"이벤트 적용되지 않음"!==this.miracleTimeFlag}get potentialOptionGradeEnum(){return s(this.potentialOptionGrade)}get additionalPotentialOptionGradeEnum(){return s(this.additionalPotentialOptionGrade)}}class l{count;cubeHistories;nextCursor;constructor(t){const{count:e,cube_histories:i,next_cursor:a}=t;this.count=e,this.cubeHistories=i.map((t=>new f(t))),this.nextCursor=a}}class c extends Error{name="MapleStoryApiError";status;message;constructor(t){const{status:e,message:i}=t;super(i),this.status=e,this.message=i}}"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self&&self;var d={exports:{}};!function(t,e){var i,a;t.exports=(i={year:0,month:1,day:2,hour:3,minute:4,second:5},a={},function(t,e,o){var n,r=function(t,e,i){void 0===i&&(i={});var o=new Date(t),n=function(t,e){void 0===e&&(e={});var i=e.timeZoneName||"short",o=t+"|"+i,n=a[o];return n||(n=new Intl.DateTimeFormat("en-US",{hour12:!1,timeZone:t,year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",timeZoneName:i}),a[o]=n),n}(e,i);return n.formatToParts(o)},s=function(t,e){for(var a=r(t,e),n=[],s=0;s<a.length;s+=1){var u=a[s],f=u.type,l=u.value,c=i[f];c>=0&&(n[c]=parseInt(l,10))}var d=n[3],h=24===d?0:d,p=n[0]+"-"+n[1]+"-"+n[2]+" "+h+":"+n[4]+":"+n[5]+":000",m=+t;return(o.utc(p).valueOf()-(m-=m%1e3))/6e4},u=e.prototype;u.tz=function(t,e){void 0===t&&(t=n);var i=this.utcOffset(),a=this.toDate(),r=a.toLocaleString("en-US",{timeZone:t}),s=Math.round((a-new Date(r))/1e3/60),u=o(r,{locale:this.$L}).$set("millisecond",this.$ms).utcOffset(15*-Math.round(a.getTimezoneOffset()/15)-s,!0);if(e){var f=u.utcOffset();u=u.add(i-f,"minute")}return u.$x.$timezone=t,u},u.offsetName=function(t){var e=this.$x.$timezone||o.tz.guess(),i=r(this.valueOf(),e,{timeZoneName:t}).find((function(t){return"timezonename"===t.type.toLowerCase()}));return i&&i.value};var f=u.startOf;u.startOf=function(t,e){if(!this.$x||!this.$x.$timezone)return f.call(this,t,e);var i=o(this.format("YYYY-MM-DD HH:mm:ss:SSS"),{locale:this.$L});return f.call(i,t,e).tz(this.$x.$timezone,!0)},o.tz=function(t,e,i){var a=i&&e,r=i||e||n,u=s(+o(),r);if("string"!=typeof t)return o(t).tz(r);var f=function(t,e,i){var a=t-60*e*1e3,o=s(a,i);if(e===o)return[a,e];var n=s(a-=60*(o-e)*1e3,i);return o===n?[a,o]:[t-60*Math.min(o,n)*1e3,Math.max(o,n)]}(o.utc(t,a).valueOf(),u,r),l=f[0],c=f[1],d=o(l).utcOffset(c);return d.$x.$timezone=r,d},o.tz.guess=function(){return Intl.DateTimeFormat().resolvedOptions().timeZone},o.tz.setDefault=function(t){n=t}})}(d);var h=d.exports,p={exports:{}};!function(t,e){var i,a,o;t.exports=(i="minute",a=/[+-]\d\d(?::?\d\d)?/g,o=/([+-]|\d\d)/g,function(t,e,n){var r=e.prototype;n.utc=function(t){return new e({date:t,utc:!0,args:arguments})},r.utc=function(t){var e=n(this.toDate(),{locale:this.$L,utc:!0});return t?e.add(this.utcOffset(),i):e},r.local=function(){return n(this.toDate(),{locale:this.$L,utc:!1})};var s=r.parse;r.parse=function(t){t.utc&&(this.$u=!0),this.$utils().u(t.$offset)||(this.$offset=t.$offset),s.call(this,t)};var u=r.init;r.init=function(){if(this.$u){var t=this.$d;this.$y=t.getUTCFullYear(),this.$M=t.getUTCMonth(),this.$D=t.getUTCDate(),this.$W=t.getUTCDay(),this.$H=t.getUTCHours(),this.$m=t.getUTCMinutes(),this.$s=t.getUTCSeconds(),this.$ms=t.getUTCMilliseconds()}else u.call(this)};var f=r.utcOffset;r.utcOffset=function(t,e){var n=this.$utils().u;if(n(t))return this.$u?0:n(this.$offset)?f.call(this):this.$offset;if("string"==typeof t&&(t=function(t){void 0===t&&(t="");var e=t.match(a);if(!e)return null;var i=(""+e[0]).match(o)||["-",0,0],n=i[0],r=60*+i[1]+ +i[2];return 0===r?0:"+"===n?r:-r}(t),null===t))return this;var r=Math.abs(t)<=16?60*t:t,s=this;if(e)return s.$offset=r,s.$u=0===t,s;if(0!==t){var u=this.$u?this.toDate().getTimezoneOffset():-1*this.utcOffset();(s=this.local().add(r+u,i)).$offset=r,s.$x.$localOffset=u}else s=this.utc();return s};var l=r.format;r.format=function(t){var e=t||(this.$u?"YYYY-MM-DDTHH:mm:ss[Z]":"");return l.call(this,e)},r.valueOf=function(){var t=this.$utils().u(this.$offset)?0:this.$offset+(this.$x.$localOffset||this.$d.getTimezoneOffset());return this.$d.valueOf()-6e4*t},r.isUTC=function(){return!!this.$u},r.toISOString=function(){return this.toDate().toISOString()},r.toString=function(){return this.toDate().toUTCString()};var c=r.toDate;r.toDate=function(t){return"s"===t&&this.$offset?n(this.format("YYYY-MM-DD HH:mm:ss:SSS")).toDate():c.call(this)};var d=r.diff;r.diff=function(t,e,i){if(t&&this.$u===t.$u)return d.call(this,t,e,i);var a=this.local(),o=n(t).local();return d.call(a,o,e,i)}})}(p);var m=p.exports;r.default.extend(h),r.default.extend(m);class g{apiKey;static baseUrl="https://public.api.nexon.com/";static kstOffset=540;timeout;constructor(t){this.apiKey=t,this.timeout=5e3}async getCubeResult(t,i){const a={count:t};if("string"==typeof i)a.cursor=i;else if("object"==typeof i){const{year:t,month:e,day:o}=i;if(t<=2022&&e<=11&&o<25)throw new Error("You can only retrieve data after 2022-11-25.");const n=r.default(`${t}-${e}-${o}`).utcOffset(g.kstOffset);a.date=n.format("YYYY-MM-DD")}else{const t=r.default().utcOffset(g.kstOffset);a.date=t.format("YYYY-MM-DD")}try{const t="openapi/maplestory/v1/cube-use-results",e=await n.default.get(t,{baseURL:g.baseUrl,timeout:this.timeout,headers:this.buildHeaders(),params:a});return new l(e.data)}catch(t){if(t instanceof e.AxiosError){const e=t.response.data;throw new c(e)}throw t}}buildHeaders(){return{authorization:this.apiKey}}}t.CubeHistoryDto=f,t.CubeHistoryResponseDto=l,t.CubeResultOptionDto=u,t.MapleStoryApi=g,t.MapleStoryApiError=c,t.potentialOptionGradeFromString=s}));

package/dist/index.mjs

@@ -0,0 +1,276 @@
+import axios, { AxiosError } from 'axios';
+import dayjs from 'dayjs';
+
+var PotentialOptionGrade;
+(function (PotentialOptionGrade) {
+    PotentialOptionGrade[PotentialOptionGrade["RARE"] = 0] = "RARE";
+    PotentialOptionGrade[PotentialOptionGrade["EPIC"] = 1] = "EPIC";
+    PotentialOptionGrade[PotentialOptionGrade["UNIQUE"] = 2] = "UNIQUE";
+    PotentialOptionGrade[PotentialOptionGrade["LEGENDARY"] = 3] = "LEGENDARY";
+})(PotentialOptionGrade || (PotentialOptionGrade = {}));
+/**
+ * 한글로 정의된 잠재옵션 등급을 PotentialOptionGrade으로 변환합니다.
+ *
+ * @param text support only "레어", "에픽", "유니크", "레전드리"
+ */
+const potentialOptionGradeFromString = (text) => {
+    const potentialOptionGradeMap = {
+        '레어': PotentialOptionGrade.RARE,
+        '에픽': PotentialOptionGrade.EPIC,
+        '유니크': PotentialOptionGrade.UNIQUE,
+        '레전드리': PotentialOptionGrade.LEGENDARY,
+    };
+    const grade = potentialOptionGradeMap[text];
+    if (!grade) {
+        throw new TypeError('No enum constant for string: ' + text);
+    }
+    return grade;
+};
+
+/**
+ * 큐브 결과 옵션 정보
+ */
+class CubeResultOptionDto {
+    /**
+     * 옵션 이름
+     */
+    value;
+    /**
+     * 옵션 등급
+     */
+    grade;
+    constructor(obj) {
+        const { value, grade } = obj;
+        this.value = value;
+        this.grade = grade;
+    }
+    get gradeEnum() {
+        return potentialOptionGradeFromString(this.grade);
+    }
+}
+
+/**
+ * 큐브히스토리 정보
+ */
+class CubeHistoryDto {
+    /**
+     * 큐브 사용 내역에 대한 고유 식별자
+     */
+    id;
+    /**
+     * 캐릭터이름
+     */
+    characterName;
+    /**
+     * 월드 이름
+     */
+    worldName;
+    /**
+     * 큐브 사용 날짜
+     */
+    createDate;
+    /**
+     * 사용한 큐브
+     */
+    cubeType;
+    /**
+     * 큐브 사용 결과
+     */
+    itemUpgradeResult;
+    /**
+     * 미라클 타임 적용 여부
+     */
+    miracleTimeFlag;
+    /**
+     * 장비 분류
+     */
+    itemEquipPart;
+    /**
+     * 장비 레벨
+     */
+    itemLevel;
+    /**
+     * 큐브를 사용한 장비
+     */
+    targetItem;
+    /**
+     * 잠재능력 등급
+     */
+    potentialOptionGrade;
+    /**
+     * 에디셔널 잠재능력 등급
+     */
+    additionalPotentialOptionGrade;
+    /**
+     * 천장에 도달하여 확정 등급 상승한 여부
+     */
+    upgradeGuarantee;
+    /**
+     * 현재까지 쌓은 스택
+     */
+    upgradeGuaranteeCount;
+    /**
+     * 큐브 사용 전 잠재능력 옵션
+     */
+    beforePotentialOptions;
+    /**
+     * 큐브 사용 전 에디셔널 잠재능력 옵션
+     */
+    beforeAdditionalPotentialOptions;
+    /**
+     * 큐브 사용 후 잠재능력 옵션
+     */
+    afterPotentialOptions;
+    /**
+     * 큐브 사용 후 에디셔널 잠재능력 옵션
+     */
+    afterAdditionalPotentialOptions;
+    constructor(obj) {
+        const { id, character_name, world_name, create_date, cube_type, item_upgrade_result, miracle_time_flag, item_equip_part, item_level, target_item, potential_option_grade, additional_potential_option_grade, upgradeguarantee, upgradeguaranteecount, before_potential_options, before_additional_potential_options, after_potential_options, after_additional_potential_options } = obj;
+        this.id = id;
+        this.characterName = character_name;
+        this.worldName = world_name;
+        this.createDate = create_date;
+        this.cubeType = cube_type;
+        this.itemUpgradeResult = item_upgrade_result;
+        this.miracleTimeFlag = miracle_time_flag;
+        this.itemEquipPart = item_equip_part;
+        this.itemLevel = item_level;
+        this.targetItem = target_item;
+        this.potentialOptionGrade = potential_option_grade;
+        this.additionalPotentialOptionGrade = additional_potential_option_grade;
+        this.upgradeGuarantee = upgradeguarantee;
+        this.upgradeGuaranteeCount = upgradeguaranteecount;
+        this.beforePotentialOptions = before_potential_options.map(origin => new CubeResultOptionDto(origin));
+        this.beforeAdditionalPotentialOptions = before_additional_potential_options.map(origin => new CubeResultOptionDto(origin));
+        this.afterPotentialOptions = after_potential_options.map(origin => new CubeResultOptionDto(origin));
+        this.afterAdditionalPotentialOptions = after_additional_potential_options.map(origin => new CubeResultOptionDto(origin));
+    }
+    get isItemUpgrade() {
+        return this.itemUpgradeResult === '성공';
+    }
+    get isMiracleTimeFlag() {
+        return this.miracleTimeFlag !== '이벤트 적용되지 않음';
+    }
+    get potentialOptionGradeEnum() {
+        return potentialOptionGradeFromString(this.potentialOptionGrade);
+    }
+    get additionalPotentialOptionGradeEnum() {
+        return potentialOptionGradeFromString(this.additionalPotentialOptionGrade);
+    }
+}
+
+/**
+ * 큐브히스토리 응답 정보
+ */
+class CubeHistoryResponseDto {
+    /**
+     * 결과 건 수
+     */
+    count;
+    /**
+     * 큐브 히스토리
+     */
+    cubeHistories;
+    /**
+     * 페이징 처리를 위한 cursor
+     */
+    nextCursor;
+    constructor(obj) {
+        const { count, cube_histories, next_cursor } = obj;
+        this.count = count;
+        this.cubeHistories = cube_histories.map(origin => new CubeHistoryDto(origin));
+        this.nextCursor = next_cursor;
+    }
+}
+
+/**
+ * MapleStory OpenAPI error.<br>
+ * Please refer to <a href="https://developers.nexon.com/Maplestory/guides">MapleStory API guide</a> for the error details.
+ */
+class MapleStoryApiError extends Error {
+    name = 'MapleStoryApiError';
+    status;
+    message;
+    constructor(params) {
+        const { status, message } = params;
+        super(message);
+        this.status = status;
+        this.message = message;
+    }
+}
+
+var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
+
+var timezone$1 = {exports: {}};
+
+(function (module, exports) {
+!function(t,e){module.exports=e();}(commonjsGlobal,(function(){var t={year:0,month:1,day:2,hour:3,minute:4,second:5},e={};return function(n,i,o){var r,a=function(t,n,i){void 0===i&&(i={});var o=new Date(t),r=function(t,n){void 0===n&&(n={});var i=n.timeZoneName||"short",o=t+"|"+i,r=e[o];return r||(r=new Intl.DateTimeFormat("en-US",{hour12:!1,timeZone:t,year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",timeZoneName:i}),e[o]=r),r}(n,i);return r.formatToParts(o)},u=function(e,n){for(var i=a(e,n),r=[],u=0;u<i.length;u+=1){var f=i[u],s=f.type,m=f.value,c=t[s];c>=0&&(r[c]=parseInt(m,10));}var d=r[3],l=24===d?0:d,h=r[0]+"-"+r[1]+"-"+r[2]+" "+l+":"+r[4]+":"+r[5]+":000",v=+e;return (o.utc(h).valueOf()-(v-=v%1e3))/6e4},f=i.prototype;f.tz=function(t,e){void 0===t&&(t=r);var n=this.utcOffset(),i=this.toDate(),a=i.toLocaleString("en-US",{timeZone:t}),u=Math.round((i-new Date(a))/1e3/60),f=o(a,{locale:this.$L}).$set("millisecond",this.$ms).utcOffset(15*-Math.round(i.getTimezoneOffset()/15)-u,!0);if(e){var s=f.utcOffset();f=f.add(n-s,"minute");}return f.$x.$timezone=t,f},f.offsetName=function(t){var e=this.$x.$timezone||o.tz.guess(),n=a(this.valueOf(),e,{timeZoneName:t}).find((function(t){return "timezonename"===t.type.toLowerCase()}));return n&&n.value};var s=f.startOf;f.startOf=function(t,e){if(!this.$x||!this.$x.$timezone)return s.call(this,t,e);var n=o(this.format("YYYY-MM-DD HH:mm:ss:SSS"),{locale:this.$L});return s.call(n,t,e).tz(this.$x.$timezone,!0)},o.tz=function(t,e,n){var i=n&&e,a=n||e||r,f=u(+o(),a);if("string"!=typeof t)return o(t).tz(a);var s=function(t,e,n){var i=t-60*e*1e3,o=u(i,n);if(e===o)return [i,e];var r=u(i-=60*(o-e)*1e3,n);return o===r?[i,o]:[t-60*Math.min(o,r)*1e3,Math.max(o,r)]}(o.utc(t,i).valueOf(),f,a),m=s[0],c=s[1],d=o(m).utcOffset(c);return d.$x.$timezone=a,d},o.tz.guess=function(){return Intl.DateTimeFormat().resolvedOptions().timeZone},o.tz.setDefault=function(t){r=t;};}}));
+}(timezone$1));
+
+var timezone = timezone$1.exports;
+
+var utc$1 = {exports: {}};
+
+(function (module, exports) {
+!function(t,i){module.exports=i();}(commonjsGlobal,(function(){var t="minute",i=/[+-]\d\d(?::?\d\d)?/g,e=/([+-]|\d\d)/g;return function(s,f,n){var u=f.prototype;n.utc=function(t){var i={date:t,utc:!0,args:arguments};return new f(i)},u.utc=function(i){var e=n(this.toDate(),{locale:this.$L,utc:!0});return i?e.add(this.utcOffset(),t):e},u.local=function(){return n(this.toDate(),{locale:this.$L,utc:!1})};var o=u.parse;u.parse=function(t){t.utc&&(this.$u=!0),this.$utils().u(t.$offset)||(this.$offset=t.$offset),o.call(this,t);};var r=u.init;u.init=function(){if(this.$u){var t=this.$d;this.$y=t.getUTCFullYear(),this.$M=t.getUTCMonth(),this.$D=t.getUTCDate(),this.$W=t.getUTCDay(),this.$H=t.getUTCHours(),this.$m=t.getUTCMinutes(),this.$s=t.getUTCSeconds(),this.$ms=t.getUTCMilliseconds();}else r.call(this);};var a=u.utcOffset;u.utcOffset=function(s,f){var n=this.$utils().u;if(n(s))return this.$u?0:n(this.$offset)?a.call(this):this.$offset;if("string"==typeof s&&(s=function(t){void 0===t&&(t="");var s=t.match(i);if(!s)return null;var f=(""+s[0]).match(e)||["-",0,0],n=f[0],u=60*+f[1]+ +f[2];return 0===u?0:"+"===n?u:-u}(s),null===s))return this;var u=Math.abs(s)<=16?60*s:s,o=this;if(f)return o.$offset=u,o.$u=0===s,o;if(0!==s){var r=this.$u?this.toDate().getTimezoneOffset():-1*this.utcOffset();(o=this.local().add(u+r,t)).$offset=u,o.$x.$localOffset=r;}else o=this.utc();return o};var h=u.format;u.format=function(t){var i=t||(this.$u?"YYYY-MM-DDTHH:mm:ss[Z]":"");return h.call(this,i)},u.valueOf=function(){var t=this.$utils().u(this.$offset)?0:this.$offset+(this.$x.$localOffset||this.$d.getTimezoneOffset());return this.$d.valueOf()-6e4*t},u.isUTC=function(){return !!this.$u},u.toISOString=function(){return this.toDate().toISOString()},u.toString=function(){return this.toDate().toUTCString()};var l=u.toDate;u.toDate=function(t){return "s"===t&&this.$offset?n(this.format("YYYY-MM-DD HH:mm:ss:SSS")).toDate():l.call(this)};var c=u.diff;u.diff=function(t,i,e){if(t&&this.$u===t.$u)return c.call(this,t,i,e);var s=this.local(),f=n(t).local();return c.call(s,f,i,e)};}}));
+}(utc$1));
+
+var utc = utc$1.exports;
+
+dayjs.extend(timezone);
+dayjs.extend(utc);
+class MapleStoryApi {
+    apiKey;
+    static baseUrl = 'https://public.api.nexon.com/';
+    static kstOffset = 540;
+    timeout;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+        this.timeout = 5000;
+    }
+    async getCubeResult(count, parameter) {
+        const query = {
+            count,
+        };
+        if (typeof parameter === 'string') {
+            query.cursor = parameter;
+        }
+        else if (typeof parameter === 'object') {
+            const { year, month, day } = parameter;
+            if (year <= 2022 && month <= 11 && day < 25) {
+                throw new Error('You can only retrieve data after 2022-11-25.');
+            }
+            const date = dayjs(`${year}-${month}-${day}`).utcOffset(MapleStoryApi.kstOffset);
+            query.date = date.format('YYYY-MM-DD');
+        }
+        else {
+            const now = dayjs().utcOffset(MapleStoryApi.kstOffset);
+            query.date = now.format('YYYY-MM-DD');
+        }
+        try {
+            const path = 'openapi/maplestory/v1/cube-use-results';
+            const response = await axios.get(path, {
+                baseURL: MapleStoryApi.baseUrl,
+                timeout: this.timeout,
+                headers: this.buildHeaders(),
+                params: query
+            });
+            return new CubeHistoryResponseDto(response.data);
+        }
+        catch (e) {
+            if (e instanceof AxiosError) {
+                const errorBody = e.response.data;
+                throw new MapleStoryApiError(errorBody);
+            }
+            throw e;
+        }
+    }
+    buildHeaders() {
+        return {
+            'authorization': this.apiKey
+        };
+    }
+}
+
+export { CubeHistoryDto, CubeHistoryResponseDto, CubeResultOptionDto, MapleStoryApi, MapleStoryApiError, PotentialOptionGrade, potentialOptionGradeFromString };

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "maplestory-openapi",
+  "version": "1.0.0",
+  "keywords": [
+    "maplestory",
+    "maplestory openapi",
+    "maplestory api",
+    "cube",
+    "nexon",
+    "nexon developers"
+  ],
+  "homepage": "https://github.com/SpiralMoon/maplestory.openapi",
+  "bugs": {
+    "url": "https://github.com/SpiralMoon/maplestory.openapi/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SpiralMoon/maplestory.openapi.git"
+  },
+  "license": "MIT",
+  "author": "SpiralMoon",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/index.js",
+  "unpkg": "dist/index.min.js",
+  "module": "dist/index.mjs",
+  "types": "types/index.d.ts",
+  "files": [
+    "dist",
+    "types"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "js_sample": "node sample/js_sample.js",
+    "prepublishOnly": "npm run build",
+    "test": "uvu -r tsm test",
+    "ts_sample": "ts-node sample/ts_sample.ts",
+    "types": "tsc --noEmit"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "dayjs": "^1.11.10"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^21.1.0",
+    "@rollup/plugin-node-resolve": "13.1.3",
+    "rollup": "2.66.1",
+    "rollup-plugin-terser": "7.0.2",
+    "rollup-plugin-typescript2": "0.27.1",
+    "ts-node": "^10.9.1",
+    "tsm": "2.2.1",
+    "typescript": "^5.2.2",
+    "uvu": "0.5.3"
+  },
+  "engines": {
+    "node": ">=12"
+  },
+  "email": "dev.spiralmoon@gmail.com",
+  "umd:name": "maplestory-openapi"
+}

package/types/index.d.ts

@@ -0,0 +1,6 @@
+export * from './maplestory/api/mapleStoryApi';
+export * from './maplestory/api/mapleStoryApiError';
+export * from './maplestory/api/dto/cubeHistoryDto';
+export * from './maplestory/api/dto/cubeHistoryResponseDto';
+export * from './maplestory/api/dto/cubeResultOptionDto';
+export * from './maplestory/api/dto/potentialOptionGrade';

package/types/maplestory/api/dto/cubeHistoryDto.d.ts

@@ -0,0 +1,86 @@
+import { CubeResultOptionDto } from "./cubeResultOptionDto";
+import { CubeHistoryDtoBody } from "../response/cubeHistoryDtoBody";
+import { PotentialOptionGrade } from "./potentialOptionGrade";
+/**
+ * 큐브히스토리 정보
+ */
+declare class CubeHistoryDto {
+    /**
+     * 큐브 사용 내역에 대한 고유 식별자
+     */
+    id: string;
+    /**
+     * 캐릭터이름
+     */
+    characterName: string;
+    /**
+     * 월드 이름
+     */
+    worldName: string;
+    /**
+     * 큐브 사용 날짜
+     */
+    createDate: string;
+    /**
+     * 사용한 큐브
+     */
+    cubeType: string;
+    /**
+     * 큐브 사용 결과
+     */
+    itemUpgradeResult: string;
+    /**
+     * 미라클 타임 적용 여부
+     */
+    miracleTimeFlag: string;
+    /**
+     * 장비 분류
+     */
+    itemEquipPart: string;
+    /**
+     * 장비 레벨
+     */
+    itemLevel: number;
+    /**
+     * 큐브를 사용한 장비
+     */
+    targetItem: string;
+    /**
+     * 잠재능력 등급
+     */
+    potentialOptionGrade: string;
+    /**
+     * 에디셔널 잠재능력 등급
+     */
+    additionalPotentialOptionGrade: string;
+    /**
+     * 천장에 도달하여 확정 등급 상승한 여부
+     */
+    upgradeGuarantee: boolean;
+    /**
+     * 현재까지 쌓은 스택
+     */
+    upgradeGuaranteeCount: number;
+    /**
+     * 큐브 사용 전 잠재능력 옵션
+     */
+    beforePotentialOptions: CubeResultOptionDto[];
+    /**
+     * 큐브 사용 전 에디셔널 잠재능력 옵션
+     */
+    beforeAdditionalPotentialOptions: CubeResultOptionDto[];
+    /**
+     * 큐브 사용 후 잠재능력 옵션
+     */
+    afterPotentialOptions: CubeResultOptionDto[];
+    /**
+     * 큐브 사용 후 에디셔널 잠재능력 옵션
+     */
+    afterAdditionalPotentialOptions: CubeResultOptionDto[];
+    constructor(obj: CubeHistoryDtoBody);
+    get isItemUpgrade(): boolean;
+    get isMiracleTimeFlag(): boolean;
+    get potentialOptionGradeEnum(): PotentialOptionGrade;
+    get additionalPotentialOptionGradeEnum(): PotentialOptionGrade;
+}
+export { CubeHistoryDto };

package/types/maplestory/api/dto/cubeHistoryResponseDto.d.ts

@@ -0,0 +1,21 @@
+import { CubeHistoryDto } from "./cubeHistoryDto";
+import { CubeHistoryResponseDtoBody } from "../response/cubeHistoryResponseDtoBody";
+/**
+ * 큐브히스토리 응답 정보
+ */
+declare class CubeHistoryResponseDto {
+    /**
+     * 결과 건 수
+     */
+    count: number;
+    /**
+     * 큐브 히스토리
+     */
+    cubeHistories: CubeHistoryDto[];
+    /**
+     * 페이징 처리를 위한 cursor
+     */
+    nextCursor: string;
+    constructor(obj: CubeHistoryResponseDtoBody);
+}
+export { CubeHistoryResponseDto };

package/types/maplestory/api/dto/cubeResultOptionDto.d.ts

@@ -0,0 +1,18 @@
+import { CubeResultOptionDtoBody } from "../response/cubeResultOptionDtoBody";
+import { PotentialOptionGrade } from "./potentialOptionGrade";
+/**
+ * 큐브 결과 옵션 정보
+ */
+declare class CubeResultOptionDto {
+    /**
+     * 옵션 이름
+     */
+    value: string;
+    /**
+     * 옵션 등급
+     */
+    grade: string;
+    constructor(obj: CubeResultOptionDtoBody);
+    get gradeEnum(): PotentialOptionGrade;
+}
+export { CubeResultOptionDto };

package/types/maplestory/api/dto/potentialOptionGrade.d.ts

@@ -0,0 +1,13 @@
+declare enum PotentialOptionGrade {
+    RARE = 0,
+    EPIC = 1,
+    UNIQUE = 2,
+    LEGENDARY = 3
+}
+/**
+ * 한글로 정의된 잠재옵션 등급을 PotentialOptionGrade으로 변환합니다.
+ *
+ * @param text support only "레어", "에픽", "유니크", "레전드리"
+ */
+declare const potentialOptionGradeFromString: (text: string) => PotentialOptionGrade;
+export { PotentialOptionGrade, potentialOptionGradeFromString };

package/types/maplestory/api/mapleStoryApi.d.ts

@@ -0,0 +1,38 @@
+import { CubeHistoryResponseDto } from "./dto/cubeHistoryResponseDto";
+declare class MapleStoryApi {
+    private readonly apiKey;
+    private static baseUrl;
+    private static kstOffset;
+    timeout: number;
+    constructor(apiKey: string);
+    /**
+     * 오늘 날짜의 확률형 아이템 큐브의 사용 결과를 조회합니다.<br>
+     * 데이터는 일단위로 갱신되며, 오전 4시 조회 시 전일 데이터를 조회할 수 있습니다.
+     *
+     * @param count 한번에 가져오려는 결과의 갯수(최소 10, 최대 1000) Default value : 10
+     */
+    getCubeResult(count: number): Promise<CubeHistoryResponseDto>;
+    /**
+     * 지목한 날짜의 확률형 아이템 큐브의 사용 결과를 조회합니다.<br>
+     * 데이터는 일단위로 갱신되며, 오전 4시 조회 시 전일 데이터를 조회할 수 있습니다.
+     *
+     * @param count 한번에 가져오려는 결과의 갯수(최소 10, 최대 1000) Default value : 10
+     * @param dateOptions 조회할 연월일 날짜 정보
+     */
+    getCubeResult(count: number, dateOptions: DateOptions): Promise<CubeHistoryResponseDto>;
+    /**
+     * 확률형 아이템 큐브의 사용 결과를 조회합니다.<br>
+     * 데이터는 일단위로 갱신되며, 오전 4시 조회 시 전일 데이터를 조회할 수 있습니다.
+     *
+     * @param count 한번에 가져오려는 결과의 갯수(최소 10, 최대 1000) Default value : 10
+     * @param cursor
+     */
+    getCubeResult(count: number, cursor: string): Promise<CubeHistoryResponseDto>;
+    private buildHeaders;
+}
+type DateOptions = {
+    year: number;
+    month: number;
+    day: number;
+};
+export { MapleStoryApi };

package/types/maplestory/api/mapleStoryApiError.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MapleStory OpenAPI error.<br>
+ * Please refer to <a href="https://developers.nexon.com/Maplestory/guides">MapleStory API guide</a> for the error details.
+ */
+declare class MapleStoryApiError extends Error {
+    readonly name = "MapleStoryApiError";
+    readonly status: number;
+    readonly message: string;
+    constructor(params: {
+        status: number;
+        message: string;
+    });
+}
+export { MapleStoryApiError };

package/types/maplestory/api/response/cubeHistoryDtoBody.d.ts

@@ -0,0 +1,22 @@
+import { CubeResultOptionDtoBody } from "./cubeResultOptionDtoBody";
+type CubeHistoryDtoBody = {
+    id: string;
+    character_name: string;
+    world_name: string;
+    create_date: string;
+    cube_type: string;
+    item_upgrade_result: string;
+    miracle_time_flag: string;
+    item_equip_part: string;
+    item_level: number;
+    target_item: string;
+    potential_option_grade: string;
+    additional_potential_option_grade: string;
+    upgradeguarantee: boolean;
+    upgradeguaranteecount: number;
+    before_potential_options: CubeResultOptionDtoBody[];
+    before_additional_potential_options: CubeResultOptionDtoBody[];
+    after_potential_options: CubeResultOptionDtoBody[];
+    after_additional_potential_options: CubeResultOptionDtoBody[];
+};
+export type { CubeHistoryDtoBody };

package/types/maplestory/api/response/cubeHistoryResponseDtoBody.d.ts

@@ -0,0 +1,7 @@
+import { CubeHistoryDtoBody } from "./cubeHistoryDtoBody";
+type CubeHistoryResponseDtoBody = {
+    count: number;
+    cube_histories: CubeHistoryDtoBody[];
+    next_cursor: string;
+};
+export type { CubeHistoryResponseDtoBody };

package/types/maplestory/api/response/cubeResultOptionDtoBody.d.ts

@@ -0,0 +1,5 @@
+type CubeResultOptionDtoBody = {
+    value: string;
+    grade: string;
+};
+export type { CubeResultOptionDtoBody };