dnf-api 1.0.0 → 1.0.1

package/package.json

@@ -1,39 +1,39 @@
-{
-  "name": "dnf-api",
-  "version": "1.0.0",
-  "description": "던전 앤 파이터 API",
-  "main": "./dist/index.js",
-  "types": "./dist/src/index.d.ts",
-  "dependencies": {
-    "@types/bun": "1.1.6",
-    "axios": "^0.18.1",
-    "consola": "^2.15.3",
-    "prototype-helper": "^0.4.2",
-    "query-string": "^9.1.1",
-    "undici": "^7.3.0"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^1.9.4",
-    "dotenv": "^16.4.7",
-    "typescript": "5.5.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",
-    "test": "jest"
-  },
-  "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": "1.0.1",
+  "description": "던전 앤 파이터 API",
+  "main": "./dist/index.js",
+  "types": "./dist/src/index.d.ts",
+  "dependencies": {
+    "@types/bun": "1.1.6",
+    "axios": "^0.18.1",
+    "consola": "^2.15.3",
+    "prototype-helper": "^0.4.2",
+    "query-string": "^9.1.1",
+    "undici": "^7.3.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "dotenv": "^16.4.7",
+    "typescript": "5.5.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",
+    "test": "jest"
+  },
+  "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/src/api/items.ts

@@ -1,49 +1,49 @@
-import type * as model from "../model";
-import { type params, query, staticUtil } from "../util";
-
-/**
- * 현재 인게임에서 획득 가능한 아이템의 경우만 검색 가능합니다.
- *
- * @param {string} itemName 검색할 아이템의 명칭
- * @param {string} params 선택적 요청변수의 Object입니다.
- */
-export const item = async (itemName: string, params: params.IItem = {}) => {
-  //   if (params === undefined) params = {};
-  params.itemName = itemName;
-  //   if (query) params.q = query.makeItemQuery(query);
-  //let querystring =
-  const opt = {
-    base: query.UriBuilder(staticUtil.baseUri.Item),
-    params: {
-      ...params,
-      ...(params.hashtag
-        ? { hashtag: query.QueryBuilder(params.hashtag ?? []) }
-        : {}),
-    },
-  };
-  return await query.Request<model.IDnfResponse<model.item.IItem>>(opt);
-};
-/**
- * 해당하는 아이템의 상세정보를 요청합니다.
- *
- * @param {string} itemId 검색할 아이템의 ID
- */
-export const detail = (itemId: string) => {
-  const opt = {
-    base: query.UriBuilder(staticUtil.baseUri.Item, itemId),
-  };
-  return query.Request<model.IDnfResponse<model.item.IDetail>>(opt);
-};
-
-/**
- * 26. 아이템 상점 판매 정보 조회
- * 인게임 백과사전 기준의 상점 판매 95레벨 에픽, 100레벨 이상 유니크, 레전더리, 에픽 장비가 조회 가능 합니다.
- *
- * @param {string} itemId 검색할 아이템의 ID
- */
-// export const shop = (itemId: string) => {
-//   const opt = {
-//     base: query.UriBuilder(staticUtil.BaseUri.Item, itemId),
-//   };
-//   return query.Request<model.item.detail>(opt);
-// };
+import type * as model from "../model";
+import { type params, query, staticUtil } from "../util";
+
+/**
+ * 현재 인게임에서 획득 가능한 아이템의 경우만 검색 가능합니다.
+ *
+ * @param {string} itemName 검색할 아이템의 명칭
+ * @param {string} params 선택적 요청변수의 Object입니다.
+ */
+export const item = async (itemName: string, params: params.IItem = {}) => {
+  //   if (params === undefined) params = {};
+  params.itemName = itemName;
+  //   if (query) params.q = query.makeItemQuery(query);
+  //let querystring =
+  const opt = {
+    base: query.UriBuilder(staticUtil.baseUri.Item),
+    params: {
+      ...params,
+      ...(params.hashtag
+        ? { hashtag: query.QueryBuilder(params.hashtag ?? []) }
+        : {}),
+    },
+  };
+  return await query.Request<model.IDnfResponse<model.item.IItem>>(opt);
+};
+/**
+ * 해당하는 아이템의 상세정보를 요청합니다.
+ *
+ * @param {string} itemId 검색할 아이템의 ID
+ */
+export const detail = (itemId: string) => {
+  const opt = {
+    base: query.UriBuilder(staticUtil.baseUri.Item, itemId),
+  };
+  return query.Request<model.IDnfResponse<model.item.IDetail>>(opt);
+};
+
+/**
+ * 26. 아이템 상점 판매 정보 조회
+ * 인게임 백과사전 기준의 상점 판매 95레벨 에픽, 100레벨 이상 유니크, 레전더리, 에픽 장비가 조회 가능 합니다.
+ *
+ * @param {string} itemId 검색할 아이템의 ID
+ */
+// export const shop = (itemId: string) => {
+//   const opt = {
+//     base: query.UriBuilder(staticUtil.BaseUri.Item, itemId),
+//   };
+//   return query.Request<model.item.detail>(opt);
+// };

package/src/model/character.ts

@@ -1,98 +1,98 @@
-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[];
-}
+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/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/util/params.ts

@@ -1,81 +1,81 @@
-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;
-}
-
-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 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;
+}
+
+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;
+}

package/src/util/query.ts

@@ -1,103 +1,93 @@
-import consola from "consola";
-import querystring from "query-string";
-import { request } from "undici";
-
-import type * as model from "../model";
-import * as Util from "./";
-
-const apiUrl = new URL("https://api.neople.co.kr");
-// const client = new Client("https://api.neople.co.kr", {
-//   connectTimeout: Util.Config.timeout,
-//   // allowH2: true,
-// });
-
-const sender = async <T>(path: string, method: "GET" | "POST", query: any) => {
-  // const res = await client.request<model.DnfResponse<T>>({
-  // const res = await client.request<T>({
-  //   path,
-  //   method,
-  //   query,
-  // });
-  apiUrl.pathname = path;
-  apiUrl.search = querystring.stringify(query);
-
-  const res = await request<model.IDnfResponse<T>>(apiUrl.href, {
-    method,
-  });
-  return res;
-};
-const showUrl = (url: string): string => {
-  if (Util.config.key) {
-    return url?.replace(Util.config.key, Util.config.hideKeyText);
-  } else {
-    return url;
-  }
-};
-
-// biome-ignore lint/complexity/noStaticOnlyClass: <explanation>
-export default class Request {
-  public static UriBuilder(...args: any[]): string {
-    return args.join("/");
-  }
-  public static QueryBuilder(query: string[] | number[]): string {
-    const qString: string[] = [];
-    for (const key in query) {
-      qString.push(`${key}:${query[key]},`);
-    }
-    return qString.join(",");
-  }
-
-  /**
-   *  던전앤파이터 API 서버에 응답을 요청하는 함수 입니다.
-   * 해당 함수를 직접 호출 하는것을 권장하지 않습니다.
-   *
-   * @param {object} opt (요청을 보낼 Parameter값)
-   * @returns
-   */
-  public static async Request<T>(
-    opt: any = {},
-    method: "GET" | "POST" = "GET"
-  ): Promise<model.IDnfResponse<T>> {
-    if (!Util.config.key || Util.config.key === "") {
-      consola.error("Please change to your api key. ");
-    }
-
-    if (opt.params === undefined) opt.params = {};
-    if (opt.params.q) opt.params.q = Request.QueryBuilder(opt.params.q);
-
-    opt.params.apikey = Util.config.key;
-
-    if (Util.config.showURL)
-      consola.log(
-        "request url:",
-        showUrl(`${opt.base}?${querystring.stringify(opt.params)}`)
-      );
-
-    const res = await sender<model.IDnfResponse<T>>(
-      opt.base,
-      method,
-      opt.params
-    );
-    if (res.statusCode !== 200) {
-      const resBody = (await res.body.json()) as model.IDnfResponse<T>;
-      const error: model.IDnfErrorResponse = {
-        url: showUrl(opt.url ?? ""),
-        status: res.statusCode || 0,
-        statusText: "",
-        code: resBody.error?.code || "",
-        message: resBody.error?.message || "",
-      };
-      return { error };
-    } else {
-      const resBody = (await res.body.json()) as T;
-      return {
-        data: resBody,
-      };
-    }
-  }
-
-  public static makeItemQuery(query: any) {
-    //  return JSON.stringify(query).replace(/\"|\{|\}/gi, "");
-    return encodeURI(query);
-  }
-}
+import consola from "consola";
+import querystring from "query-string";
+import { request } from "undici";
+
+import type * as model from "../model";
+import * as Util from "./";
+
+const apiUrl = new URL("https://api.neople.co.kr");
+// const client = new Client("https://api.neople.co.kr", {
+//   connectTimeout: Util.Config.timeout,
+//   // allowH2: true,
+// });
+
+const sender = async <T>(path: string, method: "GET" | "POST", query: any) => {
+  apiUrl.pathname = path;
+  apiUrl.search = querystring.stringify(query);
+  const res = await request<model.IDnfResponse<T>>(apiUrl.href, {
+    method,
+  });
+  return res;
+};
+
+const showUrl = (url: string): string => {
+  if (Util.config.key) {
+    return url?.replace(Util.config.key, Util.config.hideKeyText);
+  } else {
+    return url;
+  }
+};
+
+// biome-ignore lint/complexity/noStaticOnlyClass: <explanation>
+export default class Request {
+  public static UriBuilder(...args: any[]): string {
+    return args.join("/");
+  }
+  public static QueryBuilder(query: string[] | number[]): string {
+    const qString: string[] = [];
+    for (const key in query) {
+      qString.push(`${key}:${query[key]},`);
+    }
+    return qString.join(",");
+  }
+
+  /**
+   *  던전앤파이터 API 서버에 응답을 요청하는 함수 입니다.
+   * 해당 함수를 직접 호출 하는것을 권장하지 않습니다.
+   *
+   * @param {object} opt (요청을 보낼 Parameter값)
+   * @returns
+   */
+  public static async Request<T>(
+    opt: any = {},
+    method: "GET" | "POST" = "GET"
+  ): Promise<model.IDnfResponse<T>> {
+    if (!Util.config.key || Util.config.key === "") {
+      consola.error("Please change to your api key. ");
+    }
+
+    if (opt.params === undefined) opt.params = {};
+    if (opt.params.q) opt.params.q = Request.QueryBuilder(opt.params.q);
+
+    opt.params.apikey = Util.config.key;
+
+    if (Util.config.showURL)
+      consola.log(
+        "request url:",
+        showUrl(`${opt.base}?${querystring.stringify(opt.params)}`)
+      );
+
+    const res = await sender<T>(opt.base, method, opt.params);
+    if (res.statusCode !== 200) {
+      const resBody = (await res.body.json()) as model.IDnfResponse<T>;
+      const error: model.IDnfErrorResponse = {
+        url: showUrl(opt.url ?? ""),
+        status: res.statusCode || 0,
+        statusText: "",
+        code: resBody.error?.code || "",
+        message: resBody.error?.message || "",
+      };
+      return { error };
+    } else {
+      const resBody = (await res.body.json()) as T;
+      return {
+        data: resBody,
+      };
+    }
+  }
+
+  public static makeItemQuery(query: any) {
+    //  return JSON.stringify(query).replace(/\"|\{|\}/gi, "");
+    return encodeURI(query);
+  }
+}