@universal-uploader/core 1.0.0

package/dist/const.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Default chunk size (1 MiB) for stream uploads.
+ * Used as both API default and fallback for invalid chunk sizes.
+ *
+ * 스트림 업로드를 위한 기본 청크 크기(1 MiB)입니다.
+ * API 기본값 및 유효하지 않은 청크 크기에 대한 폴백으로 사용됩니다.
+ */
+export declare const DEFAULT_STREAM_CHUNK_SIZE: number;
+/**
+ * Header keys used for chunked upload metadata.
+ * 청크 업로드 메타데이터에 사용되는 헤더 키입니다.
+ */
+export declare const CHUNK_HEADER_KEYS: {
+    readonly chunkIndex: "X-Chunk-Index";
+    readonly totalChunks: "X-Total-Chunks";
+    readonly chunkSize: "X-Chunk-Size";
+    readonly fileSize: "X-File-Size";
+    readonly fileName: "X-File-Name";
+};

package/dist/createUpload-Bv4Z2y9b.js

@@ -0,0 +1,155 @@
+'use strict';
+
+/**
+ * Utility function to wait for a specific duration.
+ * 지정된 시간만큼 대기하기 위한 유틸리티 함수입니다.
+ */
+const wait = (ms) => new Promise((resolve) => {
+    setTimeout(resolve, ms);
+});
+
+/**
+ * Creates an upload orchestrator around a specific uploader executor.
+ * 특정 업로더 실행기를 중심으로 업로드 오케스트레이터를 생성합니다.
+ */
+const createUpload = (resolveUploadExecutor) => {
+    /**
+     * Orchestrates file upload by selecting the optimal method and managing retries and errors.
+     * 최적의 업로드 방식을 선택하고 재시도 및 에러 처리를 관리하여 파일 업로드를 수행합니다.
+     */
+    const upload = async ({ url, file, options: { method = "auto", ...options } }, retryAttempt = 0) => {
+        const { onComplete, onProgress, onAbort, onRetry, onError, retryCount: retryCountArg = 3, retryDelay = 1000, throwOnError = false, ...restOptions } = options;
+        const retryCount = retryCountArg;
+        /**
+         * Determines whether to throw an error based on configuration.
+         * 구성 설정에 따라 에러를 throw할지 결정합니다.
+         */
+        const shouldThrowError = (e) => {
+            if (typeof throwOnError === "function") {
+                return throwOnError(e);
+            }
+            return Boolean(throwOnError);
+        };
+        /**
+         * Handles user-triggered aborts.
+         * 사용자에 의해 중단된 경우를 처리합니다.
+         */
+        const handleAbort = (e) => {
+            onAbort?.(e);
+            if (shouldThrowError(e)) {
+                throw e;
+            }
+            return {
+                ok: false,
+                total: 0,
+                message: "Aborted by user action",
+                status: "aborted",
+            };
+        };
+        /**
+         * Handles generic errors during upload.
+         * 업로드 중 발생하는 일반적인 에러를 처리합니다.
+         */
+        const handleError = (e) => {
+            onError?.(e);
+            if (shouldThrowError(e)) {
+                throw e;
+            }
+            return { ok: false, total: 0, message: e.message, status: "error" };
+        };
+        const finalOptions = {
+            ...restOptions,
+            onProgress: ({ loaded, total, percentage }) => {
+                onProgress?.({ loaded, total, percentage });
+                if (percentage === 100) {
+                    onComplete?.();
+                }
+            },
+        };
+        const refresh = () => upload({ url, file, options });
+        /**
+         * Attempts to retry an upload operation.
+         * 업로드 작업을 재시도합니다.
+         */
+        const retryUpload = async (uploadArgs) => {
+            const nextRetryAttempt = retryAttempt + 1;
+            const nextRetryDelay = typeof retryDelay === "function"
+                ? retryDelay(nextRetryAttempt)
+                : retryDelay;
+            await wait(nextRetryDelay);
+            const uploadResponse = await upload(uploadArgs, nextRetryAttempt);
+            onRetry?.();
+            return uploadResponse;
+        };
+        /**
+         * Wraps the upload operation with error and retry handling.
+         * 에러 처리 및 재시도 로직으로 업로드 작업을 래핑합니다.
+         */
+        const wrapPromiseErrorHandler = async (uploadResponse) => {
+            const { result: originalResult, actions: originalActions } = uploadResponse;
+            const retriedResult = originalResult
+                .then((uploadResult) => {
+                /**
+                 * fetch resolves for HTTP 4xx/5xx, so stream mode can return { ok: false, status: 'error' }
+                 * without rejecting. We rethrow here to route it through retry/onError handling.
+                 *
+                 * fetch는 HTTP 4xx/5xx에서도 reject하지 않아 stream 모드가 실패 결과를 resolve로 반환할 수 있습니다.
+                 * 그래서 여기서 다시 throw해서 retry/onError 흐름으로 태웁니다.
+                 */
+                if (!uploadResult.ok && uploadResult.status === "error") {
+                    throw new Error(uploadResult.message || "Upload failed");
+                }
+                return uploadResult;
+            })
+                .catch(async (e) => {
+                if (e instanceof DOMException && e.name === "AbortError") {
+                    return handleAbort(e);
+                }
+                if (retryCount > 0) {
+                    const { result: retryResult, actions: retryActions } = await retryUpload({
+                        url,
+                        file,
+                        options: {
+                            ...options,
+                            method,
+                            retryCount: retryCount - 1,
+                        },
+                    });
+                    Object.assign(originalActions, retryActions);
+                    return retryResult;
+                }
+                return handleError(e);
+            });
+            return { result: Promise.resolve(retriedResult), actions: originalActions };
+        };
+        const uploadFile = resolveUploadExecutor({ url, file, options });
+        try {
+            const uploadResult = await wrapPromiseErrorHandler(await uploadFile({
+                url,
+                file,
+                refresh,
+                options: finalOptions,
+            }));
+            return uploadResult;
+        }
+        catch (e) {
+            onError?.(e);
+        }
+        return {
+            result: Promise.resolve({
+                ok: false,
+                total: 0,
+                message: "Unsupported upload method",
+                status: "error",
+            }),
+            actions: {
+                abort: () => null,
+                refresh,
+            },
+        };
+    };
+    return upload;
+};
+
+exports.createUpload = createUpload;
+//# sourceMappingURL=createUpload-Bv4Z2y9b.js.map

package/dist/createUpload-Bv4Z2y9b.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUpload-Bv4Z2y9b.js","sources":["../src/utils.ts","../src/createUpload.ts"],"sourcesContent":["/**\n * Utility function to wait for a specific duration.\n * 지정된 시간만큼 대기하기 위한 유틸리티 함수입니다.\n */\nexport const wait = (ms: number) =>\n  new Promise<void>((resolve) => {\n    setTimeout(resolve, ms);\n  });\n","import { wait } from \"./utils\";\nimport { Upload, UploadResponse, UploadResult, OnProgressParams } from \"./types\";\n\ntype UploadExecutor = (\n  args: Upload & { refresh: () => void },\n) => Promise<UploadResponse> | UploadResponse;\n\n/**\n * Creates an upload orchestrator around a specific uploader executor.\n * 특정 업로더 실행기를 중심으로 업로드 오케스트레이터를 생성합니다.\n */\nexport const createUpload = (\n  resolveUploadExecutor: (uploadArgs: Upload) => UploadExecutor,\n) => {\n  /**\n   * Orchestrates file upload by selecting the optimal method and managing retries and errors.\n   * 최적의 업로드 방식을 선택하고 재시도 및 에러 처리를 관리하여 파일 업로드를 수행합니다.\n   */\n  const upload = async (\n    { url, file, options: { method = \"auto\", ...options } }: Upload,\n    retryAttempt = 0,\n  ): Promise<UploadResponse> => {\n    const {\n      onComplete,\n      onProgress,\n      onAbort,\n      onRetry,\n      onError,\n      retryCount: retryCountArg = 3,\n      retryDelay = 1000,\n      throwOnError = false,\n      ...restOptions\n    } = options;\n\n    const retryCount = retryCountArg;\n\n    /**\n     * Determines whether to throw an error based on configuration.\n     * 구성 설정에 따라 에러를 throw할지 결정합니다.\n     */\n    const shouldThrowError = (e: unknown): boolean => {\n      if (typeof throwOnError === \"function\") {\n        return throwOnError(e);\n      }\n\n      return Boolean(throwOnError);\n    };\n\n    /**\n     * Handles user-triggered aborts.\n     * 사용자에 의해 중단된 경우를 처리합니다.\n     */\n    const handleAbort = (e: DOMException): UploadResult => {\n      onAbort?.(e);\n\n      if (shouldThrowError(e)) {\n        throw e;\n      }\n\n      return {\n        ok: false,\n        total: 0,\n        message: \"Aborted by user action\",\n        status: \"aborted\",\n      };\n    };\n\n    /**\n     * Handles generic errors during upload.\n     * 업로드 중 발생하는 일반적인 에러를 처리합니다.\n     */\n    const handleError = (e: Error): UploadResult => {\n      onError?.(e);\n\n      if (shouldThrowError(e)) {\n        throw e;\n      }\n\n      return { ok: false, total: 0, message: e.message, status: \"error\" };\n    };\n\n    const finalOptions = {\n      ...restOptions,\n      onProgress: ({ loaded, total, percentage }: OnProgressParams) => {\n        onProgress?.({ loaded, total, percentage });\n\n        if (percentage === 100) {\n          onComplete?.();\n        }\n      },\n    };\n\n    const refresh = () => upload({ url, file, options });\n\n    /**\n     * Attempts to retry an upload operation.\n     * 업로드 작업을 재시도합니다.\n     */\n    const retryUpload = async (uploadArgs: Upload): Promise<UploadResponse> => {\n      const nextRetryAttempt = retryAttempt + 1;\n\n      const nextRetryDelay =\n        typeof retryDelay === \"function\"\n          ? retryDelay(nextRetryAttempt)\n          : retryDelay;\n\n      await wait(nextRetryDelay);\n\n      const uploadResponse = await upload(uploadArgs, nextRetryAttempt);\n\n      onRetry?.();\n\n      return uploadResponse;\n    };\n\n    /**\n     * Wraps the upload operation with error and retry handling.\n     * 에러 처리 및 재시도 로직으로 업로드 작업을 래핑합니다.\n     */\n    const wrapPromiseErrorHandler = async (\n      uploadResponse: UploadResponse,\n    ): Promise<UploadResponse> => {\n      const { result: originalResult, actions: originalActions } = uploadResponse;\n\n      const retriedResult: Promise<UploadResult> = originalResult\n        .then((uploadResult) => {\n          /**\n           * fetch resolves for HTTP 4xx/5xx, so stream mode can return { ok: false, status: 'error' }\n           * without rejecting. We rethrow here to route it through retry/onError handling.\n           *\n           * fetch는 HTTP 4xx/5xx에서도 reject하지 않아 stream 모드가 실패 결과를 resolve로 반환할 수 있습니다.\n           * 그래서 여기서 다시 throw해서 retry/onError 흐름으로 태웁니다.\n           */\n          if (!uploadResult.ok && uploadResult.status === \"error\") {\n            throw new Error(uploadResult.message || \"Upload failed\");\n          }\n\n          return uploadResult;\n        })\n        .catch(async (e) => {\n          if (e instanceof DOMException && e.name === \"AbortError\") {\n            return handleAbort(e);\n          }\n\n          if (retryCount > 0) {\n            const { result: retryResult, actions: retryActions } =\n              await retryUpload({\n                url,\n                file,\n                options: {\n                  ...options,\n                  method,\n                  retryCount: retryCount - 1,\n                },\n              });\n\n            Object.assign(originalActions, retryActions);\n            return retryResult;\n          }\n\n          return handleError(e as Error);\n        });\n\n      return { result: Promise.resolve(retriedResult), actions: originalActions };\n    };\n\n    const uploadFile = resolveUploadExecutor({ url, file, options });\n\n    try {\n      const uploadResult = await wrapPromiseErrorHandler(\n        await uploadFile({\n          url,\n          file,\n          refresh,\n          options: finalOptions,\n        }),\n      );\n\n      return uploadResult;\n    } catch (e) {\n      onError?.(e as Error);\n    }\n\n    return {\n      result: Promise.resolve({\n        ok: false,\n        total: 0,\n        message: \"Unsupported upload method\",\n        status: \"error\",\n      }),\n      actions: {\n        abort: () => null,\n        refresh,\n      },\n    };\n  };\n\n  return upload;\n};\n"],"names":[],"mappings":";;AAAA;;;AAGG;AACI,MAAM,IAAI,GAAG,CAAC,EAAU,KAC7B,IAAI,OAAO,CAAO,CAAC,OAAO,KAAI;AAC5B,IAAA,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;AACzB,CAAC,CAAC;;ACAJ;;;AAGG;AACI,MAAM,YAAY,GAAG,CAC1B,qBAA6D,KAC3D;AACF;;;AAGG;IACH,MAAM,MAAM,GAAG,OACb,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,EAAU,EAC/D,YAAY,GAAG,CAAC,KACW;AAC3B,QAAA,MAAM,EACJ,UAAU,EACV,UAAU,EACV,OAAO,EACP,OAAO,EACP,OAAO,EACP,UAAU,EAAE,aAAa,GAAG,CAAC,EAC7B,UAAU,GAAG,IAAI,EACjB,YAAY,GAAG,KAAK,EACpB,GAAG,WAAW,EACf,GAAG,OAAO;QAEX,MAAM,UAAU,GAAG,aAAa;AAEhC;;;AAGG;AACH,QAAA,MAAM,gBAAgB,GAAG,CAAC,CAAU,KAAa;AAC/C,YAAA,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE;AACtC,gBAAA,OAAO,YAAY,CAAC,CAAC,CAAC;YACxB;AAEA,YAAA,OAAO,OAAO,CAAC,YAAY,CAAC;AAC9B,QAAA,CAAC;AAED;;;AAGG;AACH,QAAA,MAAM,WAAW,GAAG,CAAC,CAAe,KAAkB;AACpD,YAAA,OAAO,GAAG,CAAC,CAAC;AAEZ,YAAA,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE;AACvB,gBAAA,MAAM,CAAC;YACT;YAEA,OAAO;AACL,gBAAA,EAAE,EAAE,KAAK;AACT,gBAAA,KAAK,EAAE,CAAC;AACR,gBAAA,OAAO,EAAE,wBAAwB;AACjC,gBAAA,MAAM,EAAE,SAAS;aAClB;AACH,QAAA,CAAC;AAED;;;AAGG;AACH,QAAA,MAAM,WAAW,GAAG,CAAC,CAAQ,KAAkB;AAC7C,YAAA,OAAO,GAAG,CAAC,CAAC;AAEZ,YAAA,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE;AACvB,gBAAA,MAAM,CAAC;YACT;AAEA,YAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;AACrE,QAAA,CAAC;AAED,QAAA,MAAM,YAAY,GAAG;AACnB,YAAA,GAAG,WAAW;YACd,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAoB,KAAI;gBAC9D,UAAU,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAE3C,gBAAA,IAAI,UAAU,KAAK,GAAG,EAAE;oBACtB,UAAU,IAAI;gBAChB;YACF,CAAC;SACF;AAED,QAAA,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAEpD;;;AAGG;AACH,QAAA,MAAM,WAAW,GAAG,OAAO,UAAkB,KAA6B;AACxE,YAAA,MAAM,gBAAgB,GAAG,YAAY,GAAG,CAAC;AAEzC,YAAA,MAAM,cAAc,GAClB,OAAO,UAAU,KAAK;AACpB,kBAAE,UAAU,CAAC,gBAAgB;kBAC3B,UAAU;AAEhB,YAAA,MAAM,IAAI,CAAC,cAAc,CAAC;YAE1B,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC;YAEjE,OAAO,IAAI;AAEX,YAAA,OAAO,cAAc;AACvB,QAAA,CAAC;AAED;;;AAGG;AACH,QAAA,MAAM,uBAAuB,GAAG,OAC9B,cAA8B,KACH;YAC3B,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,cAAc;YAE3E,MAAM,aAAa,GAA0B;AAC1C,iBAAA,IAAI,CAAC,CAAC,YAAY,KAAI;AACrB;;;;;;AAMG;gBACH,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,YAAY,CAAC,MAAM,KAAK,OAAO,EAAE;oBACvD,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,OAAO,IAAI,eAAe,CAAC;gBAC1D;AAEA,gBAAA,OAAO,YAAY;AACrB,YAAA,CAAC;AACA,iBAAA,KAAK,CAAC,OAAO,CAAC,KAAI;gBACjB,IAAI,CAAC,YAAY,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE;AACxD,oBAAA,OAAO,WAAW,CAAC,CAAC,CAAC;gBACvB;AAEA,gBAAA,IAAI,UAAU,GAAG,CAAC,EAAE;AAClB,oBAAA,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,GAClD,MAAM,WAAW,CAAC;wBAChB,GAAG;wBACH,IAAI;AACJ,wBAAA,OAAO,EAAE;AACP,4BAAA,GAAG,OAAO;4BACV,MAAM;4BACN,UAAU,EAAE,UAAU,GAAG,CAAC;AAC3B,yBAAA;AACF,qBAAA,CAAC;AAEJ,oBAAA,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;AAC5C,oBAAA,OAAO,WAAW;gBACpB;AAEA,gBAAA,OAAO,WAAW,CAAC,CAAU,CAAC;AAChC,YAAA,CAAC,CAAC;AAEJ,YAAA,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE;AAC7E,QAAA,CAAC;AAED,QAAA,MAAM,UAAU,GAAG,qBAAqB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAEhE,QAAA,IAAI;AACF,YAAA,MAAM,YAAY,GAAG,MAAM,uBAAuB,CAChD,MAAM,UAAU,CAAC;gBACf,GAAG;gBACH,IAAI;gBACJ,OAAO;AACP,gBAAA,OAAO,EAAE,YAAY;AACtB,aAAA,CAAC,CACH;AAED,YAAA,OAAO,YAAY;QACrB;QAAE,OAAO,CAAC,EAAE;AACV,YAAA,OAAO,GAAG,CAAU,CAAC;QACvB;QAEA,OAAO;AACL,YAAA,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;AACtB,gBAAA,EAAE,EAAE,KAAK;AACT,gBAAA,KAAK,EAAE,CAAC;AACR,gBAAA,OAAO,EAAE,2BAA2B;AACpC,gBAAA,MAAM,EAAE,OAAO;aAChB,CAAC;AACF,YAAA,OAAO,EAAE;AACP,gBAAA,KAAK,EAAE,MAAM,IAAI;gBACjB,OAAO;AACR,aAAA;SACF;AACH,IAAA,CAAC;AAED,IAAA,OAAO,MAAM;AACf;;;;"}

package/dist/createUpload-CePIp5sg.js

@@ -0,0 +1,123 @@
+'use strict';
+
+/**
+ * Utility function to wait for a specific duration.
+ * 지정된 시간만큼 대기하기 위한 유틸리티 함수입니다.
+ */
+const wait = (ms) => new Promise((resolve) => {
+    setTimeout(resolve, ms);
+});
+
+/**
+ * Creates an upload orchestrator around a specific uploader executor.
+ */
+const createUpload = (resolveUploadExecutor) => {
+    const upload = async ({ url, file, options: { method = "auto", ...options } }, retryAttempt = 0) => {
+        const { onComplete, onProgress, onAbort, onRetry, onError, retryCount: retryCountArg = 3, retryDelay = 1000, throwOnError = false, ...restOptions } = options;
+        const retryCount = retryCountArg;
+        const shouldThrowError = (e) => {
+            if (typeof throwOnError === "function") {
+                return throwOnError(e);
+            }
+            return Boolean(throwOnError);
+        };
+        const handleAbort = (e) => {
+            onAbort?.(e);
+            if (shouldThrowError(e)) {
+                throw e;
+            }
+            return {
+                ok: false,
+                total: 0,
+                message: "Aborted by user action",
+                status: "aborted",
+            };
+        };
+        const handleError = (e) => {
+            onError?.(e);
+            if (shouldThrowError(e)) {
+                throw e;
+            }
+            return { ok: false, total: 0, message: e.message, status: "error" };
+        };
+        const finalOptions = {
+            ...restOptions,
+            onProgress: ({ loaded, total, percentage }) => {
+                onProgress?.({ loaded, total, percentage });
+                if (percentage === 100) {
+                    onComplete?.();
+                }
+            },
+        };
+        const refresh = () => upload({ url, file, options });
+        const retryUpload = async (uploadArgs) => {
+            const nextRetryAttempt = retryAttempt + 1;
+            const nextRetryDelay = typeof retryDelay === "function"
+                ? retryDelay(nextRetryAttempt)
+                : retryDelay;
+            await wait(nextRetryDelay);
+            const uploadResponse = await upload(uploadArgs, nextRetryAttempt);
+            onRetry?.();
+            return uploadResponse;
+        };
+        const wrapPromiseErrorHandler = async (uploadResponse) => {
+            const { result: originalResult, actions: originalActions } = uploadResponse;
+            const retriedResult = originalResult
+                .then((uploadResult) => {
+                if (!uploadResult.ok && uploadResult.status === "error") {
+                    throw new Error(uploadResult.message || "Upload failed");
+                }
+                return uploadResult;
+            })
+                .catch(async (e) => {
+                if (e instanceof DOMException && e.name === "AbortError") {
+                    return handleAbort(e);
+                }
+                if (retryCount > 0) {
+                    const { result: retryResult, actions: retryActions } = await retryUpload({
+                        url,
+                        file,
+                        options: {
+                            ...options,
+                            method,
+                            retryCount: retryCount - 1,
+                        },
+                    });
+                    Object.assign(originalActions, retryActions);
+                    return retryResult;
+                }
+                return handleError(e);
+            });
+            return { result: Promise.resolve(retriedResult), actions: originalActions };
+        };
+        const uploadFile = resolveUploadExecutor({ url, file, options });
+        try {
+            const uploadResult = await wrapPromiseErrorHandler(await uploadFile({
+                url,
+                file,
+                refresh,
+                options: finalOptions,
+            }));
+            return uploadResult;
+        }
+        catch (e) {
+            onError?.(e);
+        }
+        return {
+            result: Promise.resolve({
+                ok: false,
+                total: 0,
+                message: "Unsupported upload method",
+                status: "error",
+            }),
+            actions: {
+                abort: () => null,
+                refresh,
+            },
+        };
+    };
+    return upload;
+};
+
+exports.createUpload = createUpload;
+//# sourceMappingURL=createUpload-CePIp5sg.js.map

package/dist/createUpload-CePIp5sg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUpload-CePIp5sg.js","sources":["../src/utils.ts","../src/createUpload.ts"],"sourcesContent":["/**\n * Utility function to wait for a specific duration.\n * 지정된 시간만큼 대기하기 위한 유틸리티 함수입니다.\n */\nexport const wait = (ms: number) =>\n  new Promise<void>((resolve) => {\n    setTimeout(resolve, ms);\n  });\n","import { wait } from \"./utils\";\nimport { Upload, UploadResponse, UploadResult, OnProgressParams } from \"./types\";\n\ntype UploadExecutor = (\n  args: Upload & { refresh: () => void },\n) => Promise<UploadResponse> | UploadResponse;\n\n/**\n * Creates an upload orchestrator around a specific uploader executor.\n */\nexport const createUpload = (\n  resolveUploadExecutor: (uploadArgs: Upload) => UploadExecutor,\n) => {\n  const upload = async (\n    { url, file, options: { method = \"auto\", ...options } }: Upload,\n    retryAttempt = 0,\n  ): Promise<UploadResponse> => {\n    const {\n      onComplete,\n      onProgress,\n      onAbort,\n      onRetry,\n      onError,\n      retryCount: retryCountArg = 3,\n      retryDelay = 1000,\n      throwOnError = false,\n      ...restOptions\n    } = options;\n\n    const retryCount = retryCountArg;\n\n    const shouldThrowError = (e: unknown): boolean => {\n      if (typeof throwOnError === \"function\") {\n        return throwOnError(e);\n      }\n\n      return Boolean(throwOnError);\n    };\n\n    const handleAbort = (e: DOMException): UploadResult => {\n      onAbort?.(e);\n\n      if (shouldThrowError(e)) {\n        throw e;\n      }\n\n      return {\n        ok: false,\n        total: 0,\n        message: \"Aborted by user action\",\n        status: \"aborted\",\n      };\n    };\n\n    const handleError = (e: Error): UploadResult => {\n      onError?.(e);\n\n      if (shouldThrowError(e)) {\n        throw e;\n      }\n\n      return { ok: false, total: 0, message: e.message, status: \"error\" };\n    };\n\n    const finalOptions = {\n      ...restOptions,\n      onProgress: ({ loaded, total, percentage }: OnProgressParams) => {\n        onProgress?.({ loaded, total, percentage });\n\n        if (percentage === 100) {\n          onComplete?.();\n        }\n      },\n    };\n\n    const refresh = () => upload({ url, file, options });\n\n    const retryUpload = async (uploadArgs: Upload): Promise<UploadResponse> => {\n      const nextRetryAttempt = retryAttempt + 1;\n\n      const nextRetryDelay =\n        typeof retryDelay === \"function\"\n          ? retryDelay(nextRetryAttempt)\n          : retryDelay;\n\n      await wait(nextRetryDelay);\n\n      const uploadResponse = await upload(uploadArgs, nextRetryAttempt);\n\n      onRetry?.();\n\n      return uploadResponse;\n    };\n\n    const wrapPromiseErrorHandler = async (\n      uploadResponse: UploadResponse,\n    ): Promise<UploadResponse> => {\n      const { result: originalResult, actions: originalActions } = uploadResponse;\n\n      const retriedResult: Promise<UploadResult> = originalResult\n        .then((uploadResult) => {\n          if (!uploadResult.ok && uploadResult.status === \"error\") {\n            throw new Error(uploadResult.message || \"Upload failed\");\n          }\n\n          return uploadResult;\n        })\n        .catch(async (e) => {\n          if (e instanceof DOMException && e.name === \"AbortError\") {\n            return handleAbort(e);\n          }\n\n          if (retryCount > 0) {\n            const { result: retryResult, actions: retryActions } =\n              await retryUpload({\n                url,\n                file,\n                options: {\n                  ...options,\n                  method,\n                  retryCount: retryCount - 1,\n                },\n              });\n\n            Object.assign(originalActions, retryActions);\n            return retryResult;\n          }\n\n          return handleError(e as Error);\n        });\n\n      return { result: Promise.resolve(retriedResult), actions: originalActions };\n    };\n\n    const uploadFile = resolveUploadExecutor({ url, file, options });\n\n    try {\n      const uploadResult = await wrapPromiseErrorHandler(\n        await uploadFile({\n          url,\n          file,\n          refresh,\n          options: finalOptions,\n        }),\n      );\n\n      return uploadResult;\n    } catch (e) {\n      onError?.(e as Error);\n    }\n\n    return {\n      result: Promise.resolve({\n        ok: false,\n        total: 0,\n        message: \"Unsupported upload method\",\n        status: \"error\",\n      }),\n      actions: {\n        abort: () => null,\n        refresh,\n      },\n    };\n  };\n\n  return upload;\n};\n"],"names":[],"mappings":"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"}

package/dist/createUpload-DfsX80rY.js

@@ -0,0 +1,121 @@
+/**
+ * Utility function to wait for a specific duration.
+ * 지정된 시간만큼 대기하기 위한 유틸리티 함수입니다.
+ */
+const wait = (ms) => new Promise((resolve) => {
+    setTimeout(resolve, ms);
+});
+
+/**
+ * Creates an upload orchestrator around a specific uploader executor.
+ */
+const createUpload = (resolveUploadExecutor) => {
+    const upload = async ({ url, file, options: { method = "auto", ...options } }, retryAttempt = 0) => {
+        const { onComplete, onProgress, onAbort, onRetry, onError, retryCount: retryCountArg = 3, retryDelay = 1000, throwOnError = false, ...restOptions } = options;
+        const retryCount = retryCountArg;
+        const shouldThrowError = (e) => {
+            if (typeof throwOnError === "function") {
+                return throwOnError(e);
+            }
+            return Boolean(throwOnError);
+        };
+        const handleAbort = (e) => {
+            onAbort?.(e);
+            if (shouldThrowError(e)) {
+                throw e;
+            }
+            return {
+                ok: false,
+                total: 0,
+                message: "Aborted by user action",
+                status: "aborted",
+            };
+        };
+        const handleError = (e) => {
+            onError?.(e);
+            if (shouldThrowError(e)) {
+                throw e;
+            }
+            return { ok: false, total: 0, message: e.message, status: "error" };
+        };
+        const finalOptions = {
+            ...restOptions,
+            onProgress: ({ loaded, total, percentage }) => {
+                onProgress?.({ loaded, total, percentage });
+                if (percentage === 100) {
+                    onComplete?.();
+                }
+            },
+        };
+        const refresh = () => upload({ url, file, options });
+        const retryUpload = async (uploadArgs) => {
+            const nextRetryAttempt = retryAttempt + 1;
+            const nextRetryDelay = typeof retryDelay === "function"
+                ? retryDelay(nextRetryAttempt)
+                : retryDelay;
+            await wait(nextRetryDelay);
+            const uploadResponse = await upload(uploadArgs, nextRetryAttempt);
+            onRetry?.();
+            return uploadResponse;
+        };
+        const wrapPromiseErrorHandler = async (uploadResponse) => {
+            const { result: originalResult, actions: originalActions } = uploadResponse;
+            const retriedResult = originalResult
+                .then((uploadResult) => {
+                if (!uploadResult.ok && uploadResult.status === "error") {
+                    throw new Error(uploadResult.message || "Upload failed");
+                }
+                return uploadResult;
+            })
+                .catch(async (e) => {
+                if (e instanceof DOMException && e.name === "AbortError") {
+                    return handleAbort(e);
+                }
+                if (retryCount > 0) {
+                    const { result: retryResult, actions: retryActions } = await retryUpload({
+                        url,
+                        file,
+                        options: {
+                            ...options,
+                            method,
+                            retryCount: retryCount - 1,
+                        },
+                    });
+                    Object.assign(originalActions, retryActions);
+                    return retryResult;
+                }
+                return handleError(e);
+            });
+            return { result: Promise.resolve(retriedResult), actions: originalActions };
+        };
+        const uploadFile = resolveUploadExecutor({ url, file, options });
+        try {
+            const uploadResult = await wrapPromiseErrorHandler(await uploadFile({
+                url,
+                file,
+                refresh,
+                options: finalOptions,
+            }));
+            return uploadResult;
+        }
+        catch (e) {
+            onError?.(e);
+        }
+        return {
+            result: Promise.resolve({
+                ok: false,
+                total: 0,
+                message: "Unsupported upload method",
+                status: "error",
+            }),
+            actions: {
+                abort: () => null,
+                refresh,
+            },
+        };
+    };
+    return upload;
+};
+
+export { createUpload as c };
+//# sourceMappingURL=createUpload-DfsX80rY.js.map

package/dist/createUpload-DfsX80rY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUpload-DfsX80rY.js","sources":["../src/utils.ts","../src/createUpload.ts"],"sourcesContent":["/**\n * Utility function to wait for a specific duration.\n * 지정된 시간만큼 대기하기 위한 유틸리티 함수입니다.\n */\nexport const wait = (ms: number) =>\n  new Promise<void>((resolve) => {\n    setTimeout(resolve, ms);\n  });\n","import { wait } from \"./utils\";\nimport { Upload, UploadResponse, UploadResult, OnProgressParams } from \"./types\";\n\ntype UploadExecutor = (\n  args: Upload & { refresh: () => void },\n) => Promise<UploadResponse> | UploadResponse;\n\n/**\n * Creates an upload orchestrator around a specific uploader executor.\n */\nexport const createUpload = (\n  resolveUploadExecutor: (uploadArgs: Upload) => UploadExecutor,\n) => {\n  const upload = async (\n    { url, file, options: { method = \"auto\", ...options } }: Upload,\n    retryAttempt = 0,\n  ): Promise<UploadResponse> => {\n    const {\n      onComplete,\n      onProgress,\n      onAbort,\n      onRetry,\n      onError,\n      retryCount: retryCountArg = 3,\n      retryDelay = 1000,\n      throwOnError = false,\n      ...restOptions\n    } = options;\n\n    const retryCount = retryCountArg;\n\n    const shouldThrowError = (e: unknown): boolean => {\n      if (typeof throwOnError === \"function\") {\n        return throwOnError(e);\n      }\n\n      return Boolean(throwOnError);\n    };\n\n    const handleAbort = (e: DOMException): UploadResult => {\n      onAbort?.(e);\n\n      if (shouldThrowError(e)) {\n        throw e;\n      }\n\n      return {\n        ok: false,\n        total: 0,\n        message: \"Aborted by user action\",\n        status: \"aborted\",\n      };\n    };\n\n    const handleError = (e: Error): UploadResult => {\n      onError?.(e);\n\n      if (shouldThrowError(e)) {\n        throw e;\n      }\n\n      return { ok: false, total: 0, message: e.message, status: \"error\" };\n    };\n\n    const finalOptions = {\n      ...restOptions,\n      onProgress: ({ loaded, total, percentage }: OnProgressParams) => {\n        onProgress?.({ loaded, total, percentage });\n\n        if (percentage === 100) {\n          onComplete?.();\n        }\n      },\n    };\n\n    const refresh = () => upload({ url, file, options });\n\n    const retryUpload = async (uploadArgs: Upload): Promise<UploadResponse> => {\n      const nextRetryAttempt = retryAttempt + 1;\n\n      const nextRetryDelay =\n        typeof retryDelay === \"function\"\n          ? retryDelay(nextRetryAttempt)\n          : retryDelay;\n\n      await wait(nextRetryDelay);\n\n      const uploadResponse = await upload(uploadArgs, nextRetryAttempt);\n\n      onRetry?.();\n\n      return uploadResponse;\n    };\n\n    const wrapPromiseErrorHandler = async (\n      uploadResponse: UploadResponse,\n    ): Promise<UploadResponse> => {\n      const { result: originalResult, actions: originalActions } = uploadResponse;\n\n      const retriedResult: Promise<UploadResult> = originalResult\n        .then((uploadResult) => {\n          if (!uploadResult.ok && uploadResult.status === \"error\") {\n            throw new Error(uploadResult.message || \"Upload failed\");\n          }\n\n          return uploadResult;\n        })\n        .catch(async (e) => {\n          if (e instanceof DOMException && e.name === \"AbortError\") {\n            return handleAbort(e);\n          }\n\n          if (retryCount > 0) {\n            const { result: retryResult, actions: retryActions } =\n              await retryUpload({\n                url,\n                file,\n                options: {\n                  ...options,\n                  method,\n                  retryCount: retryCount - 1,\n                },\n              });\n\n            Object.assign(originalActions, retryActions);\n            return retryResult;\n          }\n\n          return handleError(e as Error);\n        });\n\n      return { result: Promise.resolve(retriedResult), actions: originalActions };\n    };\n\n    const uploadFile = resolveUploadExecutor({ url, file, options });\n\n    try {\n      const uploadResult = await wrapPromiseErrorHandler(\n        await uploadFile({\n          url,\n          file,\n          refresh,\n          options: finalOptions,\n        }),\n      );\n\n      return uploadResult;\n    } catch (e) {\n      onError?.(e as Error);\n    }\n\n    return {\n      result: Promise.resolve({\n        ok: false,\n        total: 0,\n        message: \"Unsupported upload method\",\n        status: \"error\",\n      }),\n      actions: {\n        abort: () => null,\n        refresh,\n      },\n    };\n  };\n\n  return upload;\n};\n"],"names":[],"mappings":"AAAA;;;AAGG;AACI,MAAM,IAAI,GAAG,CAAC,EAAU,KAC7B,IAAI,OAAO,CAAO,CAAC,OAAO,KAAI;AAC5B,IAAA,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;AACzB,CAAC,CAAC;;ACAJ;;AAEG;AACI,MAAM,YAAY,GAAG,CAC1B,qBAA6D,KAC3D;IACF,MAAM,MAAM,GAAG,OACb,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,EAAU,EAC/D,YAAY,GAAG,CAAC,KACW;AAC3B,QAAA,MAAM,EACJ,UAAU,EACV,UAAU,EACV,OAAO,EACP,OAAO,EACP,OAAO,EACP,UAAU,EAAE,aAAa,GAAG,CAAC,EAC7B,UAAU,GAAG,IAAI,EACjB,YAAY,GAAG,KAAK,EACpB,GAAG,WAAW,EACf,GAAG,OAAO;QAEX,MAAM,UAAU,GAAG,aAAa;AAEhC,QAAA,MAAM,gBAAgB,GAAG,CAAC,CAAU,KAAa;AAC/C,YAAA,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE;AACtC,gBAAA,OAAO,YAAY,CAAC,CAAC,CAAC;YACxB;AAEA,YAAA,OAAO,OAAO,CAAC,YAAY,CAAC;AAC9B,QAAA,CAAC;AAED,QAAA,MAAM,WAAW,GAAG,CAAC,CAAe,KAAkB;AACpD,YAAA,OAAO,GAAG,CAAC,CAAC;AAEZ,YAAA,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE;AACvB,gBAAA,MAAM,CAAC;YACT;YAEA,OAAO;AACL,gBAAA,EAAE,EAAE,KAAK;AACT,gBAAA,KAAK,EAAE,CAAC;AACR,gBAAA,OAAO,EAAE,wBAAwB;AACjC,gBAAA,MAAM,EAAE,SAAS;aAClB;AACH,QAAA,CAAC;AAED,QAAA,MAAM,WAAW,GAAG,CAAC,CAAQ,KAAkB;AAC7C,YAAA,OAAO,GAAG,CAAC,CAAC;AAEZ,YAAA,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE;AACvB,gBAAA,MAAM,CAAC;YACT;AAEA,YAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;AACrE,QAAA,CAAC;AAED,QAAA,MAAM,YAAY,GAAG;AACnB,YAAA,GAAG,WAAW;YACd,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAoB,KAAI;gBAC9D,UAAU,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAE3C,gBAAA,IAAI,UAAU,KAAK,GAAG,EAAE;oBACtB,UAAU,IAAI;gBAChB;YACF,CAAC;SACF;AAED,QAAA,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAEpD,QAAA,MAAM,WAAW,GAAG,OAAO,UAAkB,KAA6B;AACxE,YAAA,MAAM,gBAAgB,GAAG,YAAY,GAAG,CAAC;AAEzC,YAAA,MAAM,cAAc,GAClB,OAAO,UAAU,KAAK;AACpB,kBAAE,UAAU,CAAC,gBAAgB;kBAC3B,UAAU;AAEhB,YAAA,MAAM,IAAI,CAAC,cAAc,CAAC;YAE1B,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC;YAEjE,OAAO,IAAI;AAEX,YAAA,OAAO,cAAc;AACvB,QAAA,CAAC;AAED,QAAA,MAAM,uBAAuB,GAAG,OAC9B,cAA8B,KACH;YAC3B,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,cAAc;YAE3E,MAAM,aAAa,GAA0B;AAC1C,iBAAA,IAAI,CAAC,CAAC,YAAY,KAAI;gBACrB,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,YAAY,CAAC,MAAM,KAAK,OAAO,EAAE;oBACvD,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,OAAO,IAAI,eAAe,CAAC;gBAC1D;AAEA,gBAAA,OAAO,YAAY;AACrB,YAAA,CAAC;AACA,iBAAA,KAAK,CAAC,OAAO,CAAC,KAAI;gBACjB,IAAI,CAAC,YAAY,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE;AACxD,oBAAA,OAAO,WAAW,CAAC,CAAC,CAAC;gBACvB;AAEA,gBAAA,IAAI,UAAU,GAAG,CAAC,EAAE;AAClB,oBAAA,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,GAClD,MAAM,WAAW,CAAC;wBAChB,GAAG;wBACH,IAAI;AACJ,wBAAA,OAAO,EAAE;AACP,4BAAA,GAAG,OAAO;4BACV,MAAM;4BACN,UAAU,EAAE,UAAU,GAAG,CAAC;AAC3B,yBAAA;AACF,qBAAA,CAAC;AAEJ,oBAAA,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;AAC5C,oBAAA,OAAO,WAAW;gBACpB;AAEA,gBAAA,OAAO,WAAW,CAAC,CAAU,CAAC;AAChC,YAAA,CAAC,CAAC;AAEJ,YAAA,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE;AAC7E,QAAA,CAAC;AAED,QAAA,MAAM,UAAU,GAAG,qBAAqB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAEhE,QAAA,IAAI;AACF,YAAA,MAAM,YAAY,GAAG,MAAM,uBAAuB,CAChD,MAAM,UAAU,CAAC;gBACf,GAAG;gBACH,IAAI;gBACJ,OAAO;AACP,gBAAA,OAAO,EAAE,YAAY;AACtB,aAAA,CAAC,CACH;AAED,YAAA,OAAO,YAAY;QACrB;QAAE,OAAO,CAAC,EAAE;AACV,YAAA,OAAO,GAAG,CAAU,CAAC;QACvB;QAEA,OAAO;AACL,YAAA,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;AACtB,gBAAA,EAAE,EAAE,KAAK;AACT,gBAAA,KAAK,EAAE,CAAC;AACR,gBAAA,OAAO,EAAE,2BAA2B;AACpC,gBAAA,MAAM,EAAE,OAAO;aAChB,CAAC;AACF,YAAA,OAAO,EAAE;AACP,gBAAA,KAAK,EAAE,MAAM,IAAI;gBACjB,OAAO;AACR,aAAA;SACF;AACH,IAAA,CAAC;AAED,IAAA,OAAO,MAAM;AACf;;;;"}

package/dist/createUpload-wm9hFbGi.js

@@ -0,0 +1,153 @@
+/**
+ * Utility function to wait for a specific duration.
+ * 지정된 시간만큼 대기하기 위한 유틸리티 함수입니다.
+ */
+const wait = (ms) => new Promise((resolve) => {
+    setTimeout(resolve, ms);
+});
+
+/**
+ * Creates an upload orchestrator around a specific uploader executor.
+ * 특정 업로더 실행기를 중심으로 업로드 오케스트레이터를 생성합니다.
+ */
+const createUpload = (resolveUploadExecutor) => {
+    /**
+     * Orchestrates file upload by selecting the optimal method and managing retries and errors.
+     * 최적의 업로드 방식을 선택하고 재시도 및 에러 처리를 관리하여 파일 업로드를 수행합니다.
+     */
+    const upload = async ({ url, file, options: { method = "auto", ...options } }, retryAttempt = 0) => {
+        const { onComplete, onProgress, onAbort, onRetry, onError, retryCount: retryCountArg = 3, retryDelay = 1000, throwOnError = false, ...restOptions } = options;
+        const retryCount = retryCountArg;
+        /**
+         * Determines whether to throw an error based on configuration.
+         * 구성 설정에 따라 에러를 throw할지 결정합니다.
+         */
+        const shouldThrowError = (e) => {
+            if (typeof throwOnError === "function") {
+                return throwOnError(e);
+            }
+            return Boolean(throwOnError);
+        };
+        /**
+         * Handles user-triggered aborts.
+         * 사용자에 의해 중단된 경우를 처리합니다.
+         */
+        const handleAbort = (e) => {
+            onAbort?.(e);
+            if (shouldThrowError(e)) {
+                throw e;
+            }
+            return {
+                ok: false,
+                total: 0,
+                message: "Aborted by user action",
+                status: "aborted",
+            };
+        };
+        /**
+         * Handles generic errors during upload.
+         * 업로드 중 발생하는 일반적인 에러를 처리합니다.
+         */
+        const handleError = (e) => {
+            onError?.(e);
+            if (shouldThrowError(e)) {
+                throw e;
+            }
+            return { ok: false, total: 0, message: e.message, status: "error" };
+        };
+        const finalOptions = {
+            ...restOptions,
+            onProgress: ({ loaded, total, percentage }) => {
+                onProgress?.({ loaded, total, percentage });
+                if (percentage === 100) {
+                    onComplete?.();
+                }
+            },
+        };
+        const refresh = () => upload({ url, file, options });
+        /**
+         * Attempts to retry an upload operation.
+         * 업로드 작업을 재시도합니다.
+         */
+        const retryUpload = async (uploadArgs) => {
+            const nextRetryAttempt = retryAttempt + 1;
+            const nextRetryDelay = typeof retryDelay === "function"
+                ? retryDelay(nextRetryAttempt)
+                : retryDelay;
+            await wait(nextRetryDelay);
+            const uploadResponse = await upload(uploadArgs, nextRetryAttempt);
+            onRetry?.();
+            return uploadResponse;
+        };
+        /**
+         * Wraps the upload operation with error and retry handling.
+         * 에러 처리 및 재시도 로직으로 업로드 작업을 래핑합니다.
+         */
+        const wrapPromiseErrorHandler = async (uploadResponse) => {
+            const { result: originalResult, actions: originalActions } = uploadResponse;
+            const retriedResult = originalResult
+                .then((uploadResult) => {
+                /**
+                 * fetch resolves for HTTP 4xx/5xx, so stream mode can return { ok: false, status: 'error' }
+                 * without rejecting. We rethrow here to route it through retry/onError handling.
+                 *
+                 * fetch는 HTTP 4xx/5xx에서도 reject하지 않아 stream 모드가 실패 결과를 resolve로 반환할 수 있습니다.
+                 * 그래서 여기서 다시 throw해서 retry/onError 흐름으로 태웁니다.
+                 */
+                if (!uploadResult.ok && uploadResult.status === "error") {
+                    throw new Error(uploadResult.message || "Upload failed");
+                }
+                return uploadResult;
+            })
+                .catch(async (e) => {
+                if (e instanceof DOMException && e.name === "AbortError") {
+                    return handleAbort(e);
+                }
+                if (retryCount > 0) {
+                    const { result: retryResult, actions: retryActions } = await retryUpload({
+                        url,
+                        file,
+                        options: {
+                            ...options,
+                            method,
+                            retryCount: retryCount - 1,
+                        },
+                    });
+                    Object.assign(originalActions, retryActions);
+                    return retryResult;
+                }
+                return handleError(e);
+            });
+            return { result: Promise.resolve(retriedResult), actions: originalActions };
+        };
+        const uploadFile = resolveUploadExecutor({ url, file, options });
+        try {
+            const uploadResult = await wrapPromiseErrorHandler(await uploadFile({
+                url,
+                file,
+                refresh,
+                options: finalOptions,
+            }));
+            return uploadResult;
+        }
+        catch (e) {
+            onError?.(e);
+        }
+        return {
+            result: Promise.resolve({
+                ok: false,
+                total: 0,
+                message: "Unsupported upload method",
+                status: "error",
+            }),
+            actions: {
+                abort: () => null,
+                refresh,
+            },
+        };
+    };
+    return upload;
+};
+
+export { createUpload as c };
+//# sourceMappingURL=createUpload-wm9hFbGi.js.map

package/dist/createUpload-wm9hFbGi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUpload-wm9hFbGi.js","sources":["../src/utils.ts","../src/createUpload.ts"],"sourcesContent":["/**\n * Utility function to wait for a specific duration.\n * 지정된 시간만큼 대기하기 위한 유틸리티 함수입니다.\n */\nexport const wait = (ms: number) =>\n  new Promise<void>((resolve) => {\n    setTimeout(resolve, ms);\n  });\n","import { wait } from \"./utils\";\nimport { Upload, UploadResponse, UploadResult, OnProgressParams } from \"./types\";\n\ntype UploadExecutor = (\n  args: Upload & { refresh: () => void },\n) => Promise<UploadResponse> | UploadResponse;\n\n/**\n * Creates an upload orchestrator around a specific uploader executor.\n * 특정 업로더 실행기를 중심으로 업로드 오케스트레이터를 생성합니다.\n */\nexport const createUpload = (\n  resolveUploadExecutor: (uploadArgs: Upload) => UploadExecutor,\n) => {\n  /**\n   * Orchestrates file upload by selecting the optimal method and managing retries and errors.\n   * 최적의 업로드 방식을 선택하고 재시도 및 에러 처리를 관리하여 파일 업로드를 수행합니다.\n   */\n  const upload = async (\n    { url, file, options: { method = \"auto\", ...options } }: Upload,\n    retryAttempt = 0,\n  ): Promise<UploadResponse> => {\n    const {\n      onComplete,\n      onProgress,\n      onAbort,\n      onRetry,\n      onError,\n      retryCount: retryCountArg = 3,\n      retryDelay = 1000,\n      throwOnError = false,\n      ...restOptions\n    } = options;\n\n    const retryCount = retryCountArg;\n\n    /**\n     * Determines whether to throw an error based on configuration.\n     * 구성 설정에 따라 에러를 throw할지 결정합니다.\n     */\n    const shouldThrowError = (e: unknown): boolean => {\n      if (typeof throwOnError === \"function\") {\n        return throwOnError(e);\n      }\n\n      return Boolean(throwOnError);\n    };\n\n    /**\n     * Handles user-triggered aborts.\n     * 사용자에 의해 중단된 경우를 처리합니다.\n     */\n    const handleAbort = (e: DOMException): UploadResult => {\n      onAbort?.(e);\n\n      if (shouldThrowError(e)) {\n        throw e;\n      }\n\n      return {\n        ok: false,\n        total: 0,\n        message: \"Aborted by user action\",\n        status: \"aborted\",\n      };\n    };\n\n    /**\n     * Handles generic errors during upload.\n     * 업로드 중 발생하는 일반적인 에러를 처리합니다.\n     */\n    const handleError = (e: Error): UploadResult => {\n      onError?.(e);\n\n      if (shouldThrowError(e)) {\n        throw e;\n      }\n\n      return { ok: false, total: 0, message: e.message, status: \"error\" };\n    };\n\n    const finalOptions = {\n      ...restOptions,\n      onProgress: ({ loaded, total, percentage }: OnProgressParams) => {\n        onProgress?.({ loaded, total, percentage });\n\n        if (percentage === 100) {\n          onComplete?.();\n        }\n      },\n    };\n\n    const refresh = () => upload({ url, file, options });\n\n    /**\n     * Attempts to retry an upload operation.\n     * 업로드 작업을 재시도합니다.\n     */\n    const retryUpload = async (uploadArgs: Upload): Promise<UploadResponse> => {\n      const nextRetryAttempt = retryAttempt + 1;\n\n      const nextRetryDelay =\n        typeof retryDelay === \"function\"\n          ? retryDelay(nextRetryAttempt)\n          : retryDelay;\n\n      await wait(nextRetryDelay);\n\n      const uploadResponse = await upload(uploadArgs, nextRetryAttempt);\n\n      onRetry?.();\n\n      return uploadResponse;\n    };\n\n    /**\n     * Wraps the upload operation with error and retry handling.\n     * 에러 처리 및 재시도 로직으로 업로드 작업을 래핑합니다.\n     */\n    const wrapPromiseErrorHandler = async (\n      uploadResponse: UploadResponse,\n    ): Promise<UploadResponse> => {\n      const { result: originalResult, actions: originalActions } = uploadResponse;\n\n      const retriedResult: Promise<UploadResult> = originalResult\n        .then((uploadResult) => {\n          /**\n           * fetch resolves for HTTP 4xx/5xx, so stream mode can return { ok: false, status: 'error' }\n           * without rejecting. We rethrow here to route it through retry/onError handling.\n           *\n           * fetch는 HTTP 4xx/5xx에서도 reject하지 않아 stream 모드가 실패 결과를 resolve로 반환할 수 있습니다.\n           * 그래서 여기서 다시 throw해서 retry/onError 흐름으로 태웁니다.\n           */\n          if (!uploadResult.ok && uploadResult.status === \"error\") {\n            throw new Error(uploadResult.message || \"Upload failed\");\n          }\n\n          return uploadResult;\n        })\n        .catch(async (e) => {\n          if (e instanceof DOMException && e.name === \"AbortError\") {\n            return handleAbort(e);\n          }\n\n          if (retryCount > 0) {\n            const { result: retryResult, actions: retryActions } =\n              await retryUpload({\n                url,\n                file,\n                options: {\n                  ...options,\n                  method,\n                  retryCount: retryCount - 1,\n                },\n              });\n\n            Object.assign(originalActions, retryActions);\n            return retryResult;\n          }\n\n          return handleError(e as Error);\n        });\n\n      return { result: Promise.resolve(retriedResult), actions: originalActions };\n    };\n\n    const uploadFile = resolveUploadExecutor({ url, file, options });\n\n    try {\n      const uploadResult = await wrapPromiseErrorHandler(\n        await uploadFile({\n          url,\n          file,\n          refresh,\n          options: finalOptions,\n        }),\n      );\n\n      return uploadResult;\n    } catch (e) {\n      onError?.(e as Error);\n    }\n\n    return {\n      result: Promise.resolve({\n        ok: false,\n        total: 0,\n        message: \"Unsupported upload method\",\n        status: \"error\",\n      }),\n      actions: {\n        abort: () => null,\n        refresh,\n      },\n    };\n  };\n\n  return upload;\n};\n"],"names":[],"mappings":"AAAA;;;AAGG;AACI,MAAM,IAAI,GAAG,CAAC,EAAU,KAC7B,IAAI,OAAO,CAAO,CAAC,OAAO,KAAI;AAC5B,IAAA,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;AACzB,CAAC,CAAC;;ACAJ;;;AAGG;AACI,MAAM,YAAY,GAAG,CAC1B,qBAA6D,KAC3D;AACF;;;AAGG;IACH,MAAM,MAAM,GAAG,OACb,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,EAAU,EAC/D,YAAY,GAAG,CAAC,KACW;AAC3B,QAAA,MAAM,EACJ,UAAU,EACV,UAAU,EACV,OAAO,EACP,OAAO,EACP,OAAO,EACP,UAAU,EAAE,aAAa,GAAG,CAAC,EAC7B,UAAU,GAAG,IAAI,EACjB,YAAY,GAAG,KAAK,EACpB,GAAG,WAAW,EACf,GAAG,OAAO;QAEX,MAAM,UAAU,GAAG,aAAa;AAEhC;;;AAGG;AACH,QAAA,MAAM,gBAAgB,GAAG,CAAC,CAAU,KAAa;AAC/C,YAAA,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE;AACtC,gBAAA,OAAO,YAAY,CAAC,CAAC,CAAC;YACxB;AAEA,YAAA,OAAO,OAAO,CAAC,YAAY,CAAC;AAC9B,QAAA,CAAC;AAED;;;AAGG;AACH,QAAA,MAAM,WAAW,GAAG,CAAC,CAAe,KAAkB;AACpD,YAAA,OAAO,GAAG,CAAC,CAAC;AAEZ,YAAA,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE;AACvB,gBAAA,MAAM,CAAC;YACT;YAEA,OAAO;AACL,gBAAA,EAAE,EAAE,KAAK;AACT,gBAAA,KAAK,EAAE,CAAC;AACR,gBAAA,OAAO,EAAE,wBAAwB;AACjC,gBAAA,MAAM,EAAE,SAAS;aAClB;AACH,QAAA,CAAC;AAED;;;AAGG;AACH,QAAA,MAAM,WAAW,GAAG,CAAC,CAAQ,KAAkB;AAC7C,YAAA,OAAO,GAAG,CAAC,CAAC;AAEZ,YAAA,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE;AACvB,gBAAA,MAAM,CAAC;YACT;AAEA,YAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;AACrE,QAAA,CAAC;AAED,QAAA,MAAM,YAAY,GAAG;AACnB,YAAA,GAAG,WAAW;YACd,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAoB,KAAI;gBAC9D,UAAU,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAE3C,gBAAA,IAAI,UAAU,KAAK,GAAG,EAAE;oBACtB,UAAU,IAAI;gBAChB;YACF,CAAC;SACF;AAED,QAAA,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAEpD;;;AAGG;AACH,QAAA,MAAM,WAAW,GAAG,OAAO,UAAkB,KAA6B;AACxE,YAAA,MAAM,gBAAgB,GAAG,YAAY,GAAG,CAAC;AAEzC,YAAA,MAAM,cAAc,GAClB,OAAO,UAAU,KAAK;AACpB,kBAAE,UAAU,CAAC,gBAAgB;kBAC3B,UAAU;AAEhB,YAAA,MAAM,IAAI,CAAC,cAAc,CAAC;YAE1B,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAAC;YAEjE,OAAO,IAAI;AAEX,YAAA,OAAO,cAAc;AACvB,QAAA,CAAC;AAED;;;AAGG;AACH,QAAA,MAAM,uBAAuB,GAAG,OAC9B,cAA8B,KACH;YAC3B,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,cAAc;YAE3E,MAAM,aAAa,GAA0B;AAC1C,iBAAA,IAAI,CAAC,CAAC,YAAY,KAAI;AACrB;;;;;;AAMG;gBACH,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,YAAY,CAAC,MAAM,KAAK,OAAO,EAAE;oBACvD,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,OAAO,IAAI,eAAe,CAAC;gBAC1D;AAEA,gBAAA,OAAO,YAAY;AACrB,YAAA,CAAC;AACA,iBAAA,KAAK,CAAC,OAAO,CAAC,KAAI;gBACjB,IAAI,CAAC,YAAY,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE;AACxD,oBAAA,OAAO,WAAW,CAAC,CAAC,CAAC;gBACvB;AAEA,gBAAA,IAAI,UAAU,GAAG,CAAC,EAAE;AAClB,oBAAA,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,GAClD,MAAM,WAAW,CAAC;wBAChB,GAAG;wBACH,IAAI;AACJ,wBAAA,OAAO,EAAE;AACP,4BAAA,GAAG,OAAO;4BACV,MAAM;4BACN,UAAU,EAAE,UAAU,GAAG,CAAC;AAC3B,yBAAA;AACF,qBAAA,CAAC;AAEJ,oBAAA,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC;AAC5C,oBAAA,OAAO,WAAW;gBACpB;AAEA,gBAAA,OAAO,WAAW,CAAC,CAAU,CAAC;AAChC,YAAA,CAAC,CAAC;AAEJ,YAAA,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE;AAC7E,QAAA,CAAC;AAED,QAAA,MAAM,UAAU,GAAG,qBAAqB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAEhE,QAAA,IAAI;AACF,YAAA,MAAM,YAAY,GAAG,MAAM,uBAAuB,CAChD,MAAM,UAAU,CAAC;gBACf,GAAG;gBACH,IAAI;gBACJ,OAAO;AACP,gBAAA,OAAO,EAAE,YAAY;AACtB,aAAA,CAAC,CACH;AAED,YAAA,OAAO,YAAY;QACrB;QAAE,OAAO,CAAC,EAAE;AACV,YAAA,OAAO,GAAG,CAAU,CAAC;QACvB;QAEA,OAAO;AACL,YAAA,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;AACtB,gBAAA,EAAE,EAAE,KAAK;AACT,gBAAA,KAAK,EAAE,CAAC;AACR,gBAAA,OAAO,EAAE,2BAA2B;AACpC,gBAAA,MAAM,EAAE,OAAO;aAChB,CAAC;AACF,YAAA,OAAO,EAAE;AACP,gBAAA,KAAK,EAAE,MAAM,IAAI;gBACjB,OAAO;AACR,aAAA;SACF;AACH,IAAA,CAAC;AAED,IAAA,OAAO,MAAM;AACf;;;;"}