dnf-api 1.0.6 → 1.1.0

package/src/model/item.ts

@@ -1,117 +1,117 @@
-import type * as Static from "../util/static";
-import type { INameValue } from "./";
-
-export 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[];
-}
+import type * as Static from "../util/static";
+import type { INameValue } from "./";
+
+export 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/src/model/setitem.ts

@@ -1,33 +1,33 @@
-/** 세트 아이템 인터페이스 */
-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;
-        }
-      ];
-    }
-  ];
-}
+/** 세트 아이템 인터페이스 */
+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;
+        },
+      ];
+    },
+  ];
+}

package/src/util/config.ts

@@ -1,20 +1,43 @@
-export interface IConfig {
-  key: string | undefined;
-  hideOnErrorApiKey: boolean;
-  hideKeyText: string;
-  timeout: number;
-  returnJSON: boolean;
-  responseHeader: boolean;
-  showURL: boolean;
-}
-// biome-ignore lint/style/useConst: <explanation>
-let defaultConfig: IConfig = {
-  key: "",
-  hideOnErrorApiKey: true,
-  hideKeyText: "{HIDE_KEY}",
-  timeout: 5000,
-  returnJSON: false,
-  responseHeader: false,
-  showURL: false,
-};
-export default defaultConfig;
+// 설정 인터페이스
+export interface IConfig {
+  key: string;
+  hideOnErrorApiKey: boolean;
+  hideKeyText: string;
+  timeout: number;
+  returnJSON: boolean;
+  responseHeader: boolean;
+  showURL: boolean;
+  maxRequestsPerSecond: number;
+}
+
+// 기본 설정값
+const defaultConfig: IConfig = {
+  key: "",
+  hideOnErrorApiKey: true,
+  hideKeyText: "{HIDE_KEY}",
+  timeout: 5000,
+  returnJSON: false,
+  responseHeader: false,
+  showURL: false,
+  maxRequestsPerSecond: 1000,
+};
+
+// 현재 설정 (복사본)
+export const config: IConfig = { ...defaultConfig };
+
+/**
+ * 설정을 업데이트합니다.
+ * @param newConfig 업데이트할 설정 값
+ */
+export function setConfig(newConfig: Partial<IConfig>): void {
+  Object.assign(config, newConfig);
+}
+
+/**
+ * 설정을 기본값으로 초기화합니다.
+ */
+export function resetConfig(): void {
+  Object.assign(config, defaultConfig);
+}
+
+export default config;

package/src/util/index.ts

@@ -1,6 +1,17 @@
-import config from "./config";
-import * as params from "./params";
-import query from "./query";
-import * as staticUtil from "./static";
-
-export { config, query, staticUtil, params };
+import config, { setConfig, resetConfig } from "./config";
+import * as params from "./params";
+import query from "./query";
+import { requestQueue } from "./queue";
+import { createRequest } from "./request-helper";
+import * as staticUtil from "./static";
+
+export {
+  config,
+  setConfig,
+  resetConfig,
+  query,
+  staticUtil,
+  params,
+  createRequest,
+  requestQueue,
+};

package/src/util/params.ts

@@ -1,82 +1,95 @@
-import type * as staticUtil from "./static";
-export interface QueryOptions<T = any> {
-  base: string;
-  params?: T;
-}
-export interface ICharParams {
-  characterName?: string;
-  jobId?: string;
-  jobGrowId?: string;
-  isAllJobGrow?: boolean;
-  wordType?: staticUtil.charactersWordType;
-  limit?: number;
-}
-
-export interface ITimeLine {
-  serverId?: staticUtil.server;
-  characterId?: string;
-  startDate?: Date;
-  endDate?: Date;
-  limit?: number;
-  code?: string[];
-  next?: string;
-}
-
-export interface IAuction {
-  limit?: number;
-  sort?: IAuctionSort;
-  itemId?: string;
-  itemName?: string;
-  wordType?: staticUtil.auctionWordType;
-  wordShort?: boolean;
-  q?: IAuctionQuery;
-}
-export interface IAuctionSort {
-  unitPrice?: staticUtil.sort;
-  reinforce?: staticUtil.sort;
-  auctionNo?: staticUtil.sort;
-}
-export interface IAuctionQuery {
-  minLevel?: number;
-  maxLevel?: number;
-  raity?: staticUtil.rarity;
-  reinforceTypeId: staticUtil.reinforceType;
-  minReinforce?: number;
-  maxReinforce?: number;
-  minRefine?: number;
-  maxRefine?: number;
-  minFame?: number;
-  maxFame?: number;
-}
-
-export interface IActionSoldOption {
-  limit?: number;
-  wordType?: staticUtil.auctionWordType;
-  wordShort?: boolean;
-  itemId?: string;
-  itemName?: string;
-  sort?: IAuctionSort;
-}
-
-export interface IItem {
-  limit?: number;
-  itemName?: string;
-  hashtag?: string[];
-  wordType?: staticUtil.auctionWordType;
-  q?: IItemQuery;
-}
-export interface IItemQuery {
-  minLevel?: number;
-  maxLevel?: number;
-  rarity?: staticUtil.rarity;
-  // trade?: boolean;
-}
-
-export interface ISetItem {
-  setItemName?: string;
-  limit?: number;
-  wordType?: staticUtil.auctionWordType;
-}
-export interface ISkill {
-  jobGrowId: string;
-}
+import type * as staticUtil from "./static";
+
+// 기본 파라미터 타입
+export type ParamValue = string | number | boolean | undefined;
+
+// 인덱스 시그니처가 있는 기본 인터페이스
+export interface BaseParams {
+  [key: string]: ParamValue | ParamValue[] | object | undefined;
+}
+
+export interface QueryOptions<T = BaseParams> {
+  base: string;
+  params?: T;
+}
+
+export interface ICharParams extends BaseParams {
+  characterName?: string;
+  jobId?: string;
+  jobGrowId?: string;
+  isAllJobGrow?: boolean;
+  wordType?: staticUtil.charactersWordType;
+  limit?: number;
+}
+
+export interface ITimeLine extends BaseParams {
+  serverId?: staticUtil.server;
+  characterId?: string;
+  startDate?: Date;
+  endDate?: Date;
+  limit?: number;
+  code?: string[];
+  next?: string;
+}
+
+export interface IAuction extends BaseParams {
+  limit?: number;
+  sort?: IAuctionSort;
+  itemId?: string;
+  itemName?: string;
+  wordType?: staticUtil.auctionWordType;
+  wordShort?: boolean;
+  q?: IAuctionQuery;
+}
+
+export interface IAuctionSort {
+  unitPrice?: staticUtil.sort;
+  reinforce?: staticUtil.sort;
+  auctionNo?: staticUtil.sort;
+}
+
+export interface IAuctionQuery {
+  minLevel?: number;
+  maxLevel?: number;
+  raity?: staticUtil.rarity;
+  reinforceTypeId: staticUtil.reinforceType;
+  minReinforce?: number;
+  maxReinforce?: number;
+  minRefine?: number;
+  maxRefine?: number;
+  minFame?: number;
+  maxFame?: number;
+}
+
+export interface IActionSoldOption extends BaseParams {
+  limit?: number;
+  wordType?: staticUtil.auctionWordType;
+  wordShort?: boolean;
+  itemId?: string;
+  itemName?: string;
+  sort?: IAuctionSort;
+}
+
+export interface IItem extends BaseParams {
+  limit?: number;
+  itemName?: string;
+  hashtag?: string[];
+  wordType?: staticUtil.auctionWordType;
+  q?: IItemQuery;
+}
+
+export interface IItemQuery {
+  minLevel?: number;
+  maxLevel?: number;
+  rarity?: staticUtil.rarity;
+}
+
+export interface ISetItem extends BaseParams {
+  setItemName?: string;
+  limit?: number;
+  wordType?: staticUtil.auctionWordType;
+}
+
+export interface ISkill extends BaseParams {
+  jobGrowId: string;
+}