dnf-api 2.0.3 → 3.0.0

package/dist/util/config.d.ts

@@ -7,6 +7,7 @@ export interface IConfig {
     responseHeader: boolean;
     showURL: boolean;
     maxRequestsPerSecond: number;
+    maxRequestsPerMinute: number;
 }
 export declare const config: IConfig;
 /**

package/dist/util/query.d.ts

@@ -11,12 +11,6 @@ export interface RequestOptions {
  * @returns 결합된 URI 경로
  */
 export declare function UriBuilder(...args: (string | number)[]): string;
-/**
- * 쿼리 문자열을 빌드합니다.
- * @param query 쿼리 배열
- * @returns 쿼리 문자열
- */
-export declare function QueryBuilder(query: (string | number)[]): string;
 /**
  * 던전앤파이터 API 서버에 요청을 보내는 함수입니다.
  * @param opt 요청 옵션
@@ -32,7 +26,6 @@ export declare function Request<T>(opt?: RequestOptions, method?: "GET" | "POST"
 export declare function makeItemQuery(query: string): string;
 declare const _default: {
     UriBuilder: typeof UriBuilder;
-    QueryBuilder: typeof QueryBuilder;
     Request: typeof Request;
     makeItemQuery: typeof makeItemQuery;
 };

package/dist/util/queue.d.ts

@@ -1,14 +1,22 @@
 export declare class RequestQueue {
     private queue;
     private processing;
-    private requestCount;
-    private lastResetTime;
+    private secondTimestamps;
+    private minuteTimestamps;
     /**
      * 큐에 요청을 추가합니다.
      * @param task 실행할 비동기 작업
      * @returns 작업 결과 Promise
      */
     add<T>(task: () => Promise<T>): Promise<T>;
+    /**
+     * 슬라이딩 윈도우 기반으로 대기 시간을 계산합니다.
+     */
+    private getWaitTime;
+    /**
+     * 요청 타임스탬프를 기록합니다.
+     */
+    private recordRequest;
     /**
      * 큐를 처리합니다.
      */
@@ -19,8 +27,10 @@ export declare class RequestQueue {
      */
     get status(): {
         queueLength: number;
-        requestCount: number;
-        maxRequestsPerSecond: number;
+        requestsInLastSecond: number;
+        requestsInLastMinute: number;
+        maxPerSecond: number;
+        maxPerMinute: number;
     };
     /**
      * 큐를 초기화합니다.

package/package.json

@@ -1,40 +1,41 @@
-{
-  "name": "dnf-api",
-  "version": "2.0.3",
-  "description": "던전 앤 파이터 API",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/src/index.d.ts",
-  "dependencies": {
-    "consola": "^3.4.2",
-    "prototype-helper": "^1.2.0"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.1.6",
-    "@biomejs/biome": "^2.3.10",
-    "dotenv": "^17.2.3",
-    "typescript": "5.9.3"
-  },
-  "scripts": {
-    "dev": "bun --watch test.ts",
-    "bundle": "tsc --declaration --emitDeclarationOnly --outDir dist && bun build src/index.ts --minify --target=bun --outfile dist/index.js",
-    "dev:test": "bun --watch test.ts",
-    "lint": "biome lint ./src",
-    "lint:fix": "biome lint --write ./src",
-    "format": "biome format --write ./src",
-    "check": "biome check ./src",
-    "check:fix": "biome check --write ./src"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/k22pr/dnf-api.git"
-  },
-  "keywords": ["dnf"],
-  "author": "서버지기",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/k22pr/dnf-api/issues"
-  },
-  "homepage": "https://github.com/k22pr/dnf-api#readme"
-}
+{
+  "name": "dnf-api",
+  "version": "3.0.0",
+  "description": "던전 앤 파이터 API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "dependencies": {
+    "consola": "^3.4.2",
+    "prototype-helper": "^1.2.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.6",
+    "dotenv": "^17.2.3",
+    "oxfmt": "^0.42.0",
+    "oxlint": "^1.57.0",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "dev": "bun --watch test.ts",
+    "bundle": "bun x rimraf dist && tsc --declaration --emitDeclarationOnly --outDir dist && bun build src/index.ts --minify --target=bun --outfile dist/index.js",
+    "dev:test": "bun --watch test.ts",
+    "lint": "oxlint ./src",
+    "lint:fix": "oxlint --fix ./src",
+    "format": "oxfmt --write ./src",
+    "format:check": "oxfmt --check ./src"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/k22pr/dnf-api.git"
+  },
+  "keywords": ["dnf"],
+  "author": "서버지기",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/k22pr/dnf-api/issues"
+  },
+  "homepage": "https://github.com/k22pr/dnf-api#readme"
+}

package/dist/src/api/auction.d.ts

@@ -1,24 +0,0 @@
-import type * as model from "../model";
-import { type params } from "../util";
-/**
- * 경매장에 등록된 아이템을 "아이템 이름"을 기준으로 받아옵니다
- *
- * @param {string} itemName 검색할 아이템의 이름입니다.
- * @param {object} params 선택적 요청변수의 Object입니다.
- */
-export declare const itemName: (itemName: string, params?: params.IAuction) => Promise<model.IDnfResponse<model.IRows<model.auction.IAuction>>>;
-/**
- * 경매장에 등록된 아이템을 "아이템 아이디"을 기준으로 받아옵니다
- *
- * @param {string} itemID 검색할 아이템의 ID입니다.
- * @param {object} params 선택적 요청변수의 Object입니다.
- */
-export declare const itemId: (itemId: string, params?: params.IAuction) => Promise<model.IDnfResponse<model.IRows<model.auction.IAuction>>>;
-/**
- * 경매장에 등록된 경매장번호로 받아옵니다.
- *
- * @param {Number} auctionNo 검색할 경매장 번호입니다.
- */
-export declare const no: (auctionNo: number) => Promise<model.IDnfResponse<model.auction.IAuction>>;
-export declare const auctionSoldName: (itemName: string, params?: params.IActionSoldOption) => Promise<model.IDnfResponse<model.IRows<model.auction.IAuctionSolid>>>;
-export declare const auctionSoldId: (itemId: string, params?: params.IActionSoldOption) => Promise<model.IDnfResponse<model.IRows<model.auction.IAuctionSolid>>>;

package/dist/src/api/characters.d.ts

@@ -1,32 +0,0 @@
-import type * as model from "../model";
-import { type params, staticUtil } from "../util";
-/**
- * 서버 이름과 캐릭터 닉네임을 입력하여 해당 캐릭터를 검색합니다.
- *
- * @param {staticUtil.server} [serverId=""] 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} [characterName=""] 검색할 캐릭터의 이름입니다.
- * @param {object} [params={}] 선택적 요청변수의 Object입니다.
- */
-export declare const characterName: (serverId: staticUtil.server, characterName: string, params?: params.ICharParams) => Promise<model.IDnfResponse<model.IRows<model.char.ICharacter>>>;
-/**
- * 캐릭터 ID를 입력하여 해당 캐릭터 정보를 받아옵니다
- *
- * @param {staticUtil.server} serverId 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} characterId 검색할 캐릭터의 ID입니다.
- */
-export declare const characterId: (serverId: staticUtil.server, characterId: string) => Promise<model.IDnfResponse<model.char.IInfo>>;
-/**
- * 캐릭터 ID를 입력하여 해당 캐릭터의 타임라인 정보를 검색합니다.
- *
- * @param {staticUtil.server} serverId 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} characterId 검색할 캐릭터의 ID입니다.
- * @param {object} params 선택적 요청변수의 Object입니다.
- */
-export declare const timeline: (serverId: staticUtil.server, characterId: string, params?: params.ITimeLine) => Promise<model.IDnfResponse<model.char.ITimeline>>;
-/**
- * 캐릭터 ID를 입력하여 해당 캐릭터의 능력치 정보를 검색합니다.
- *
- * @param {staticUtil.server} serverId 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} characterId 검색할 캐릭터의 ID입니다.
- */
-export declare const status: (serverId: staticUtil.server, characterId: string) => Promise<model.IDnfResponse<model.char.ICharacterStatus>>;

package/dist/src/api/characters.equip.d.ts

@@ -1,29 +0,0 @@
-import { staticUtil } from "../util";
-/**
- * 해당 캐릭터가 장착한 장비 정보를 받아옵니다.
- *
- * @param {staticUtil.server} serverId 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} characterId 검색할 캐릭터의 ID입니다.
- */
-export declare const equipment: (serverId: staticUtil.server, characterId: string) => Promise<import("../model").IDnfResponse<unknown>>;
-/**
- * 해당 캐릭터가 장착한 아바타 정보를 받아옵니다.
- *
- * @param {staticUtil.server} serverId 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} characterId 검색할 캐릭터의 ID입니다.
- */
-export declare const avatar: (serverId: staticUtil.server, characterId: string) => Promise<import("../model").IDnfResponse<unknown>>;
-/**
- * 해당 캐릭터가 장착한 크리쳐 정보를 받아옵니다.
- *
- * @param {staticUtil.server} serverId 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} characterId 검색할 캐릭터의 ID입니다.
- */
-export declare const creature: (serverId: staticUtil.server, characterId: string) => Promise<import("../model").IDnfResponse<unknown>>;
-/**
- * 해당 캐릭터가 장착한 휘장 정보를 받아옵니다.
- *
- * @param {staticUtil.server} serverId 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} characterId 검색할 캐릭터의 ID입니다.
- */
-export declare const flag: (serverId: staticUtil.server, characterId: string) => Promise<import("../model").IDnfResponse<unknown>>;

package/dist/src/api/characters.skill.d.ts

@@ -1,29 +0,0 @@
-import { staticUtil } from "../util";
-/**
- *  아이템 및 장비를 통한 스킬 강화 제외 입니다.
- *
- * @param {staticUtil.server} serverId 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} characterId 검색할 캐릭터의 ID입니다.
- */
-export declare const style: (serverId: staticUtil.server, characterId: string) => Promise<import("../model").IDnfResponse<unknown>>;
-/**
- * 캐릭터 '버프 스킬 강화 장착 장비'(스위칭) 를 조회합니다.
- *
- * @param {staticUtil.server} serverId 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} characterId 검색할 캐릭터의 ID입니다.
- */
-export declare const equipment: (serverId: staticUtil.server, characterId: string) => Promise<import("../model").IDnfResponse<unknown>>;
-/**
- * 캐릭터 '버프 스킬 강화 장착 아바타'(스위칭) 를 조회합니다.
- *
- * @param {staticUtil.server} serverId 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} characterId 검색할 캐릭터의 ID입니다.
- */
-export declare const avatar: (serverId: staticUtil.server, characterId: string) => Promise<import("../model").IDnfResponse<unknown>>;
-/**
- * 캐릭터 '버프 스킬 강화 장착 크리쳐'(스위칭) 를 조회합니다.
- *
- * @param {staticUtil.server} serverId 캐릭터가 존재하는 서버의 이름입니다.
- * @param {string} characterId 검색할 캐릭터의 ID입니다.
- */
-export declare const creature: (serverId: staticUtil.server, characterId: string) => Promise<import("../model").IDnfResponse<unknown>>;

package/dist/src/api/index.d.ts

@@ -1,9 +0,0 @@
-import * as action from "./auction";
-import * as characters from "./characters";
-import * as equip from "./characters.equip";
-import * as skill from "./characters.skill";
-import * as item from "./items";
-import * as multi from "./multi";
-import * as server from "./server";
-import * as setItem from "./setitems";
-export { action, equip, skill, characters, item, setItem, server, multi };

package/dist/src/api/items.d.ts

@@ -1,21 +0,0 @@
-import type * as model from "../model";
-import { type params } from "../util";
-/**
- * 현재 인게임에서 획득 가능한 아이템의 경우만 검색 가능합니다.
- *
- * @param {string} itemName 검색할 아이템의 명칭
- * @param {string} params 선택적 요청변수의 Object입니다.
- */
-export declare const item: (itemName: string, params?: params.IItem) => Promise<model.IDnfResponse<model.item.IItem>>;
-/**
- * 해당하는 아이템의 상세정보를 요청합니다.
- *
- * @param {string} itemId 검색할 아이템의 ID
- */
-export declare const detail: (itemId: string) => Promise<model.IDnfResponse<model.item.IDetail>>;
-/**
- * 26. 아이템 상점 판매 정보 조회
- * 인게임 백과사전 기준의 상점 판매 95레벨 에픽, 100레벨 이상 유니크, 레전더리, 에픽 장비가 조회 가능 합니다.
- *
- * @param {string} itemId 검색할 아이템의 ID
- */

package/dist/src/api/multi.d.ts

@@ -1,7 +0,0 @@
-import type * as model from "../model";
-/**
- * 해당하는 아이템의 상세정보를 요청합니다.
- *
- * @param {string} itemId 검색할 아이템의 ID
- */
-export declare const items: (itemIdList: string[]) => Promise<model.IDnfResponse<model.IRows<model.item.IDetail>>>;

package/dist/src/api/server.d.ts

@@ -1,2 +0,0 @@
-import type * as Model from "../model";
-export declare const List: () => Promise<Model.IDnfResponse<Model.IServer[]>>;

package/dist/src/api/setitems.d.ts

@@ -1,15 +0,0 @@
-import type * as Model from "../model";
-import { type params } from "../util";
-/**
- * 세트 아이템 정보를 세트의 이름으로 검색합니다.
- *
- * @param {string} setItemName 세트 아이템의 이름입니다.
- * @param {object} params 선택적 요청변수의 Object입니다.
- */
-export declare const setitem: (setItemName: string, params?: params.ISetItem) => Promise<Model.IDnfResponse<Model.setItem.ISetItem[]>>;
-/**
- * 세트 ID로 세트 아이템 정보를 받아옵니다.
- *
- * @param {string} setItemId 세트 아이템의 ID입니다.
- */
-export declare const detail: (setItemId: string) => Promise<Model.IDnfResponse<Model.setItem.IDetail>>;

package/dist/src/index.d.ts

@@ -1,14 +0,0 @@
-import * as request from "./api";
-import * as model from "./model/index";
-import * as util from "./util";
-import config from "./util/config";
-import * as params from "./util/params";
-import * as query from "./util/query";
-import * as staticUtil from "./util/static";
-export default class DnfApi {
-    util: typeof util;
-    request: typeof request;
-}
-declare const ServerNames: typeof util.staticUtil.server;
-declare const RarityNames: typeof util.staticUtil.rarity;
-export { request as api, request, config, staticUtil, ServerNames, RarityNames, query, params, model, };

package/dist/src/model/auction.d.ts

@@ -1,47 +0,0 @@
-/** 경매장 아이템 인터페이스 */
-export interface IAuction {
-    auctionNo: number;
-    regDate: Date;
-    expireDate: Date;
-    itemId: string;
-    itemName: string;
-    itemAvailableLevel: number;
-    itemRarity: string;
-    itemTypeId: string;
-    itemType: string;
-    itemTypeDetailId: string;
-    itemTypeDetail: string;
-    refine: number;
-    reinforce: number;
-    amplificationName: string;
-    fame: number;
-    count: number;
-    regCount: number;
-    price: number;
-    currentPrice: number;
-    unitPrice: number;
-    averagePrice: number;
-    upgrade?: number;
-    upgradeMax?: number;
-}
-/** 판매 완료 아이템 인터페이스 */
-export interface IAuctionSolid {
-    soldDate: string;
-    itemId: string;
-    itemName: string;
-    itemAvailableLevel: number;
-    itemRarity: string;
-    itemTypeId: string;
-    itemType: string;
-    itemTypeDetailId: string;
-    itemTypeDetail: string;
-    refine: number;
-    reinforce: number;
-    amplificationName: string | null;
-    fame: number;
-    count: number;
-    price: number;
-    unitPrice: number;
-    upgrade?: number;
-    upgradeMax?: number;
-}

package/dist/src/model/character.d.ts

@@ -1,91 +0,0 @@
-import type { staticUtil } from "../util";
-import type { INameValue } from "./";
-/** 캐릭터 정보 인터페이스 */
-export interface ICharacter {
-    serverId: staticUtil.server;
-    characterId: string;
-    characterName: string;
-    level: number;
-    jobId: string;
-    jobGrowId: string;
-    jobName: string;
-    jobGrowName: string;
-    fame: number;
-}
-/** 캐릭터 상세 정보 인터페이스 */
-export interface IInfo {
-    serverId: staticUtil.server;
-    characterId: string;
-    characterName: string;
-    level: number;
-    jobId: string;
-    jobGrowId: string;
-    jobName: string;
-    jobGrowName: string;
-    fame: number;
-    adventureName: string;
-    guildId: string | null;
-    guildName: string | null;
-}
-/** 캐릭터 타임라인 인터페이스 */
-export interface ITimeline {
-    serverId: staticUtil.server;
-    characterId: string;
-    characterName: string;
-    level: number;
-    jobId: string;
-    jobGrowId: string;
-    jobName: string;
-    jobGrowName: string;
-    adventureName: string;
-    guildId: string;
-    guildName: string;
-    timeline: {
-        date: {
-            start: Date;
-            end: Date;
-        };
-        next: string;
-        rows: ITimeLineRow[];
-    };
-}
-/** 타임라인 행 인터페이스 */
-export interface ITimeLineRow {
-    code: number;
-    name: string;
-    date: string;
-    data: ITimeLineRowData;
-}
-/** 타임라인 행 데이터 인터페이스 */
-export interface ITimeLineRowData {
-    itemId: string;
-    itemName: string;
-    itemRarity: staticUtil.rarity;
-    channelName: string;
-    channelNo: number;
-    dungeonName: string;
-    mistGear: boolean;
-}
-/** 캐릭터 상태 인터페이스 */
-export interface ICharacterStatus {
-    serverId: staticUtil.server;
-    characterId: string;
-    characterName: string;
-    level: number;
-    jobId: string;
-    jobGrowId: string;
-    jobName: string;
-    jobGrowName: string;
-    fame: number;
-    adventureName: string;
-    guildId: string | null;
-    guildName: string | null;
-    buff: IBuff[];
-    status: INameValue[];
-}
-/** 버프 정보 인터페이스 */
-export interface IBuff {
-    name: string;
-    level?: number;
-    status: INameValue[];
-}

package/dist/src/model/index.d.ts

@@ -1,39 +0,0 @@
-import * as auction from "./auction";
-import * as char from "./character";
-import * as item from "./item";
-import * as setItem from "./setitem";
-export { char, item, setItem, auction };
-/** 에러 응답 인터페이스 */
-export interface IDnfErrorResponse {
-    url: string;
-    status: number;
-    statusText: string;
-    code: string;
-    message: string;
-}
-/** 성공 응답 인터페이스 */
-export interface IDnfSuccess<T> {
-    data: T;
-    error?: never;
-}
-/** 에러 정보 인터페이스 */
-export interface IDnfError {
-    data?: never;
-    error: IDnfErrorResponse;
-}
-/** 응답 타입(합성 타입) */
-export type IDnfResponse<T> = IDnfSuccess<T> | IDnfError;
-/** 행 배열 인터페이스 */
-export interface IRows<T> {
-    rows: T[];
-}
-/** 서버 정보 인터페이스 */
-export interface IServer {
-    serverId: string;
-    serverName: string;
-}
-/** 이름-값 쌍 인터페이스 */
-export interface INameValue {
-    name: string;
-    value: string | number;
-}

package/dist/src/model/item.d.ts

@@ -1,103 +0,0 @@
-import type * as Static from "../util/static";
-import type { INameValue } from "./";
-export declare enum ItemDetailKind {
-    Material = "material",
-    Equip = "equip"
-}
-/** 아이템 인터페이스 */
-export interface IItem {
-    itemId: string;
-    itemName: string;
-    itemRarity: Static.rarity;
-    itemType: string;
-    itemTypeDetail: string;
-    itemAvailableLevel: number;
-}
-/** 아이템 상세 인터페이스(합성 타입) */
-export type IDetail = IMaterialDetail | IEquipDetail;
-/** 재료 아이템 상세 인터페이스 */
-export interface IMaterialDetail {
-    kind: ItemDetailKind.Material;
-    itemId: string;
-    itemName: string;
-    itemRarity: string;
-    itemTypeId: string;
-    itemType: string;
-    itemTypeDetailId: string;
-    itemTypeDetail: string;
-    itemAvailableLevel: number;
-    itemExplain: string;
-    itemExplainDetail: string;
-    itemFlavorText: string;
-    fame: number;
-    setItemId: string | null;
-    setItemName: string | null;
-    obtainInfo: IObtainInfo;
-}
-/** 장비 아이템 상세 인터페이스 */
-export interface IEquipDetail {
-    kind: ItemDetailKind.Equip;
-    itemId: string;
-    itemName: string;
-    itemRarity: string;
-    itemTypeId: string;
-    itemType: string;
-    itemTypeDetailId: string;
-    itemTypeDetail: string;
-    itemAvailableLevel: number;
-    itemExplain: string;
-    itemExplainDetail: string;
-    itemFlavorText: string;
-    fame: number;
-    setItemId: string | null;
-    setItemName: string | null;
-    itemStatus: INameValue[];
-    tune: ITune;
-    itemBuff: IItemBuff;
-    hashtag: string[];
-    obtainInfo: IObtainInfoDetail;
-}
-/** 튠 정보 인터페이스 */
-export interface ITune {
-    level: number;
-    setPoint: number;
-}
-/** 아이템 버프 인터페이스 */
-export interface IItemBuff {
-    explain: string;
-    explainDetail: string;
-    reinforceSkill: any[];
-    status: any | null;
-}
-/** 획득 정보 인터페이스 */
-export interface IObtainInfo {
-    dungeon: string | null;
-    shop: IShopInfo[];
-}
-/** 획득 상세 정보 인터페이스 */
-export interface IObtainInfoDetail {
-    dungeon: IDungeon[];
-    shop: IShopDetail[];
-}
-/** 던전 정보 인터페이스 */
-export interface IDungeon {
-    type: string;
-    rows: IDungeonRow[];
-}
-/** 던전 행 인터페이스 */
-export interface IDungeonRow {
-    name: string;
-}
-/** 상점 정보 인터페이스 */
-export interface IShopInfo {
-    type: string;
-}
-/** 상점 상세 정보 인터페이스 */
-export interface IShopDetail {
-    rows: IShopRow[];
-}
-/** 상점 행 인터페이스 */
-export interface IShopRow {
-    name: string;
-    details: string[];
-}

package/dist/src/model/setitem.d.ts

@@ -1,32 +0,0 @@
-/** 세트 아이템 인터페이스 */
-export interface ISetItem {
-    setItemId: string;
-    setItemName: string;
-}
-/** 세트 아이템 상세 인터페이스 */
-export interface IDetail {
-    setItemId: string;
-    setItemName: string;
-    setItems: [
-        {
-            slotId: string;
-            slotName: string;
-            itemId: string;
-            itemName: string;
-            itemRarity: string;
-        }
-    ];
-    setItemOption: [
-        {
-            optionNo: number;
-            explain: string;
-            detailExplain: string;
-            status: [
-                {
-                    name: string;
-                    value: number;
-                }
-            ];
-        }
-    ];
-}