mcl-axios-kit 0.0.1 → 0.0.3

package/dist/McAxios.js

@@ -1,6 +1,6 @@
 import axios from "axios";
 import McRequest from "./McRequest";
-import { ERROR_HANDLER_KEY, METHOD_META_KEY, PATH_PARAMS_KEY, REQUEST_KEY, RESPONSE_TYPE_KEY, SUCCESS_HANDLER_KEY } from "./McAxiosAnnotations";
+import { ERROR_HANDLER_KEY, METHOD_META_KEY, PATH_PARAMS_KEY, REQUEST_KEY, RESPONSE_TYPE_KEY, SUCCESS_HANDLER_KEY, FORMDATA_KEY } from "./McAxiosAnnotations";
 export default class McAxios {
     _axios;
     constructor() {
@@ -23,6 +23,7 @@ export default class McAxios {
             const errorHandler = Reflect.getMetadata(ERROR_HANDLER_KEY, proto, name);
             const requestBody = Reflect.getMetadata(REQUEST_KEY, proto, name);
             const responseType = Reflect.getMetadata(RESPONSE_TYPE_KEY, proto, name);
+            const formData = Reflect.getMetadata(FORMDATA_KEY, proto, name);
             const pathParams = Reflect.getMetadata(PATH_PARAMS_KEY, proto, name) || {};
             Object.defineProperty(this, name, {
                 // biome-ignore lint/suspicious/noExplicitAny: <explanation>
@@ -33,6 +34,30 @@ export default class McAxios {
                         const value = encodeURIComponent(args[index]);
                         url = url.replace(`{${key}}`, value);
                     }
+                    if (method === "MULTIPART") {
+                        const data = formData !== undefined ? args[formData] : undefined;
+                        try {
+                            const response = await this._axios
+                                .request({
+                                method: "POST",
+                                url,
+                                data,
+                                headers: { "Content-Type": "multipart/form-data" },
+                            })
+                                .catch((err) => {
+                                throw err;
+                            });
+                            if (successHandler)
+                                return successHandler(response);
+                            if (responseType)
+                                return new responseType(response);
+                            return response.data;
+                        }
+                        catch (reqErr) {
+                            const err = errorHandler ? errorHandler(reqErr) : reqErr;
+                            throw reqErr;
+                        }
+                    }
                     const request = requestBody !== undefined ? args[requestBody] : undefined;
                     if (request !== undefined && request instanceof McRequest === false) {
                         const err = new Error("Request 형식이 잘못 되었습니다.");

package/dist/McAxiosAnnotations.d.ts

@@ -6,13 +6,16 @@ export declare const RESPONSE_TYPE_KEY: unique symbol;
 export declare const PATH_PARAMS_KEY: unique symbol;
 export declare const SUCCESS_HANDLER_KEY: unique symbol;
 export declare const ERROR_HANDLER_KEY: unique symbol;
+export declare const FORMDATA_KEY: unique symbol;
 declare const McAxiosAnnotations: {
     GET: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
     POST: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
     PUT: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
     DELETE: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
+    MULTIPART: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
     PATCH: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
     Request: (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
+    FormData: (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
     Path: (name: string) => (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
     Success: (fn: Function) => (target: any, propertyKey: string) => void;
     Error: (fn: Function) => (target: any, propertyKey: string) => void;

package/dist/McAxiosAnnotations.js

@@ -6,6 +6,7 @@ export const RESPONSE_TYPE_KEY = Symbol("mc:responseType");
 export const PATH_PARAMS_KEY = Symbol("mc:pathParams");
 export const SUCCESS_HANDLER_KEY = Symbol("mc:successHandler");
 export const ERROR_HANDLER_KEY = Symbol("mc:errorHandler");
+export const FORMDATA_KEY = Symbol("mc:formdata");
 const McAxiosAnnotations = {
     // biome-ignore lint/suspicious/noExplicitAny: <explanation>
     GET: (url, type) => {
@@ -24,6 +25,10 @@ const McAxiosAnnotations = {
         return createDecorator("DELETE", url, type);
     },
     // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+    MULTIPART: (url, type) => {
+        return createDecorator("MULTIPART", url, type);
+    },
+    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
     PATCH: (url, type) => {
         return createDecorator("PATCH", url, type);
     },
@@ -31,6 +36,10 @@ const McAxiosAnnotations = {
     Request: (target, propertyKey, parameterIndex) => {
         Reflect.defineMetadata(REQUEST_KEY, parameterIndex, target, propertyKey);
     },
+    // biome-ignore lint/complexity/noBannedTypes: <explanation>
+    FormData: (target, propertyKey, parameterIndex) => {
+        Reflect.defineMetadata(FORMDATA_KEY, parameterIndex, target, propertyKey);
+    },
     Path: (name) => {
         // biome-ignore lint/complexity/noBannedTypes: <explanation>
         return (target, propertyKey, parameterIndex) => {

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import McAxiosOrigin from './McAxios';
+import McAxiosManager from './McAxiosManager';
+import McAxiosAnnotations from './McAxiosAnnotations';
+import McDataAnnotations from './McDataAnnotations';
+import McRequest from './McRequest';
+import McResponse from './McResponse';
+/**
+ * 2. McAxios 클래스에 다른 클래스들을 정적(static) 속성으로 결합합니다.
+ * 이렇게 하면 McAxios.Manager와 같은 방식으로 접근이 가능해집니다.
+ */
+declare const McAxios: typeof McAxiosOrigin & {
+    Manager: typeof McAxiosManager;
+    AxiosAnnotations: {
+        GET: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
+        POST: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
+        PUT: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
+        DELETE: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
+        MULTIPART: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
+        PATCH: (url: string, type: new (res: any) => any) => (target: any, propertyKey: string) => void;
+        Request: (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
+        FormData: (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
+        Path: (name: string) => (target: Object, propertyKey: string | symbol, parameterIndex: number) => void;
+        Success: (fn: Function) => (target: any, propertyKey: string) => void;
+        Error: (fn: Function) => (target: any, propertyKey: string) => void;
+    };
+    DataAnnotations: {
+        Entity: <T extends {
+            new (...args: any[]): {};
+        }>(constructor: T) => T;
+        Serialize: (jsonKey: string) => (target: any, propertyKey: string) => void;
+        Field: (type: any, path?: string, defaultValue?: any) => (target: any, propertyKey: string) => void;
+        ArrayField: (type: any, path?: string, defaultValue?: any) => (target: any, propertyKey: string) => void;
+    };
+    Request: typeof McRequest;
+    Response: typeof McResponse;
+};
+export default McAxios;
+export { McAxios, McAxiosManager, McAxiosAnnotations, McDataAnnotations, McRequest, McResponse };

package/dist/index.js

@@ -0,0 +1,23 @@
+// 1. 모든 클래스를 가져옵니다.
+// (각 파일들이 export default로 되어 있다고 가정합니다.)
+import McAxiosOrigin from './McAxios';
+import McAxiosManager from './McAxiosManager';
+import McAxiosAnnotations from './McAxiosAnnotations';
+import McDataAnnotations from './McDataAnnotations';
+import McRequest from './McRequest';
+import McResponse from './McResponse';
+/**
+ * 2. McAxios 클래스에 다른 클래스들을 정적(static) 속성으로 결합합니다.
+ * 이렇게 하면 McAxios.Manager와 같은 방식으로 접근이 가능해집니다.
+ */
+const McAxios = Object.assign(McAxiosOrigin, {
+    Manager: McAxiosManager,
+    AxiosAnnotations: McAxiosAnnotations,
+    DataAnnotations: McDataAnnotations,
+    Request: McRequest,
+    Response: McResponse,
+});
+// 3. 통합된 McAxios를 default로 내보냅니다.
+export default McAxios;
+// 4. 필요한 경우 { McAxiosManager } 처럼 별도로 쓰고 싶을 때를 대비한 Named Export
+export { McAxios, McAxiosManager, McAxiosAnnotations, McDataAnnotations, McRequest, McResponse };

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "mcl-axios-kit",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "McL에서 Axios를 활용해 API를 보다 효율적이고 깔끔하게 활용할 수 있도록 구현된 Kit",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.js"
     }
   },
   "files": [

package/dist/McSerializable.js

@@ -1 +0,0 @@
-"use strict";