@simplysm/core-common 13.0.0-beta.1

package/dist/utils/transferable.js

@@ -0,0 +1,153 @@
+import { DateTime } from "../types/date-time";
+import { DateOnly } from "../types/date-only";
+import { Time } from "../types/time";
+import { Uuid } from "../types/uuid";
+function transferableEncode(obj) {
+  const transferList = [];
+  const ancestors = /* @__PURE__ */ new Set();
+  const cache = /* @__PURE__ */ new Map();
+  const result = encodeImpl(obj, transferList, [], ancestors, cache);
+  return { result, transferList };
+}
+function encodeImpl(obj, transferList, path, ancestors, cache) {
+  if (obj == null) return obj;
+  if (typeof obj === "object") {
+    if (ancestors.has(obj)) {
+      const currentPath = path.length > 0 ? path.join(".") : "root";
+      throw new TypeError(`\uC21C\uD658 \uCC38\uC870\uAC00 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4: ${currentPath}`);
+    }
+    const cached = cache.get(obj);
+    if (cached !== void 0) return cached;
+    ancestors.add(obj);
+  }
+  let result;
+  try {
+    if (obj instanceof Uint8Array) {
+      const isSharedArrayBuffer = typeof SharedArrayBuffer !== "undefined" && obj.buffer instanceof SharedArrayBuffer;
+      const buffer = obj.buffer;
+      if (!isSharedArrayBuffer && !transferList.includes(buffer)) {
+        transferList.push(buffer);
+      }
+      result = obj;
+    } else if (obj instanceof Date) {
+      result = { __type__: "Date", data: obj.getTime() };
+    } else if (obj instanceof DateTime) {
+      result = { __type__: "DateTime", data: obj.tick };
+    } else if (obj instanceof DateOnly) {
+      result = { __type__: "DateOnly", data: obj.tick };
+    } else if (obj instanceof Time) {
+      result = { __type__: "Time", data: obj.tick };
+    } else if (obj instanceof Uuid) {
+      result = { __type__: "Uuid", data: obj.toString() };
+    } else if (obj instanceof RegExp) {
+      result = { __type__: "RegExp", data: { source: obj.source, flags: obj.flags } };
+    } else if (obj instanceof Error) {
+      const errObj = obj;
+      result = {
+        __type__: "Error",
+        data: {
+          name: errObj.name,
+          message: errObj.message,
+          stack: errObj.stack,
+          ...errObj.code !== void 0 ? { code: errObj.code } : {},
+          ...errObj.detail !== void 0 ? { detail: encodeImpl(errObj.detail, transferList, [...path, "detail"], ancestors, cache) } : {},
+          ...errObj.cause !== void 0 ? { cause: encodeImpl(errObj.cause, transferList, [...path, "cause"], ancestors, cache) } : {}
+        }
+      };
+    } else if (Array.isArray(obj)) {
+      result = obj.map((item, idx) => encodeImpl(item, transferList, [...path, idx], ancestors, cache));
+    } else if (obj instanceof Map) {
+      let idx = 0;
+      result = new Map(
+        Array.from(obj.entries()).map(([k, v]) => {
+          const keyPath = [...path, `Map[${idx}].key`];
+          const valuePath = [...path, `Map[${idx}].value`];
+          idx++;
+          return [
+            encodeImpl(k, transferList, keyPath, ancestors, cache),
+            encodeImpl(v, transferList, valuePath, ancestors, cache)
+          ];
+        })
+      );
+    } else if (obj instanceof Set) {
+      let idx = 0;
+      result = new Set(
+        Array.from(obj).map((v) => encodeImpl(v, transferList, [...path, `Set[${idx++}]`], ancestors, cache))
+      );
+    } else if (typeof obj === "object") {
+      const res = {};
+      const record = obj;
+      for (const key of Object.keys(record)) {
+        res[key] = encodeImpl(record[key], transferList, [...path, key], ancestors, cache);
+      }
+      result = res;
+    } else {
+      return obj;
+    }
+    if (typeof obj === "object") {
+      cache.set(obj, result);
+    }
+    return result;
+  } finally {
+    if (typeof obj === "object") {
+      ancestors.delete(obj);
+    }
+  }
+}
+function transferableDecode(obj) {
+  if (obj == null) return obj;
+  if (typeof obj === "object" && "__type__" in obj && "data" in obj) {
+    const typed = obj;
+    const data = typed.data;
+    if (typed.__type__ === "Date" && typeof data === "number") return new Date(data);
+    if (typed.__type__ === "DateTime" && typeof data === "number") return new DateTime(data);
+    if (typed.__type__ === "DateOnly" && typeof data === "number") return new DateOnly(data);
+    if (typed.__type__ === "Time" && typeof data === "number") return new Time(data);
+    if (typed.__type__ === "Uuid" && typeof data === "string") return new Uuid(data);
+    if (typed.__type__ === "RegExp" && typeof data === "object" && data !== null) {
+      const regexData = data;
+      return new RegExp(regexData.source, regexData.flags);
+    }
+    if (typed.__type__ === "Error" && typeof data === "object" && data !== null) {
+      const errorData = data;
+      const err = new Error(errorData.message);
+      err.name = errorData.name;
+      err.stack = errorData.stack;
+      if (errorData.code !== void 0) err.code = errorData.code;
+      if (errorData.cause !== void 0) err.cause = transferableDecode(errorData.cause);
+      if (errorData.detail !== void 0) err.detail = transferableDecode(errorData.detail);
+      return err;
+    }
+  }
+  if (Array.isArray(obj)) {
+    return obj.map((item) => transferableDecode(item));
+  }
+  if (obj instanceof Map) {
+    const newMap = /* @__PURE__ */ new Map();
+    for (const [k, v] of obj) {
+      newMap.set(transferableDecode(k), transferableDecode(v));
+    }
+    return newMap;
+  }
+  if (obj instanceof Set) {
+    const newSet = /* @__PURE__ */ new Set();
+    for (const v of obj) {
+      newSet.add(transferableDecode(v));
+    }
+    return newSet;
+  }
+  if (typeof obj === "object") {
+    const record = obj;
+    const result = {};
+    for (const key of Object.keys(record)) {
+      result[key] = transferableDecode(record[key]);
+    }
+    return result;
+  }
+  return obj;
+}
+export {
+  transferableDecode,
+  transferableEncode
+};
+//# sourceMappingURL=transferable.js.map

package/dist/utils/transferable.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/transferable.ts"],
+  "sourcesContent": ["import { DateTime } from \"../types/date-time\";\nimport { DateOnly } from \"../types/date-only\";\nimport { Time } from \"../types/time\";\nimport { Uuid } from \"../types/uuid\";\n\n/**\n * Worker \uAC04 \uC804\uC1A1 \uAC00\uB2A5\uD55C \uAC1D\uCCB4 \uD0C0\uC785\n *\n * \uC774 \uCF54\uB4DC\uC5D0\uC11C\uB294 ArrayBuffer\uB9CC \uC0AC\uC6A9\uB429\uB2C8\uB2E4.\n * @see https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Transferable_objects\n */\ntype Transferable = ArrayBuffer;\n\n/**\n * Transferable \uBCC0\uD658 \uC720\uD2F8\uB9AC\uD2F0 \uD568\uC218\n *\n * Worker \uAC04 \uB370\uC774\uD130 \uC804\uC1A1\uC744 \uC704\uD55C \uC9C1\uB82C\uD654/\uC5ED\uC9C1\uB82C\uD654\uB97C \uC218\uD589\uD569\uB2C8\uB2E4.\n * structuredClone\uC774 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uCEE4\uC2A4\uD140 \uD0C0\uC785\uB4E4\uC744 \uCC98\uB9AC\uD569\uB2C8\uB2E4.\n *\n * \uC9C0\uC6D0 \uD0C0\uC785:\n * - Date, DateTime, DateOnly, Time, Uuid, RegExp\n * - Error (cause, code, detail \uD3EC\uD568)\n * - Uint8Array (\uB2E4\uB978 TypedArray\uB294 \uBBF8\uC9C0\uC6D0, \uC77C\uBC18 \uAC1D\uCCB4\uB85C \uCC98\uB9AC\uB428)\n * - Array, Map, Set, \uC77C\uBC18 \uAC1D\uCCB4\n *\n * @note \uC21C\uD658 \uCC38\uC870\uAC00 \uC788\uC73C\uBA74 transferableEncode \uC2DC TypeError \uBC1C\uC0DD (\uACBD\uB85C \uC815\uBCF4 \uD3EC\uD568)\n * @note \uB3D9\uC77C \uAC1D\uCCB4\uAC00 \uC5EC\uB7EC \uACF3\uC5D0\uC11C \uCC38\uC870\uB418\uBA74 \uCE90\uC2DC\uB41C \uC778\uCF54\uB529 \uACB0\uACFC\uB97C \uC7AC\uC0AC\uC6A9\uD569\uB2C8\uB2E4\n *\n * @example\n * // Worker\uB85C \uB370\uC774\uD130 \uC804\uC1A1\n * const { result, transferList } = transferableEncode(data);\n * worker.postMessage(result, transferList);\n *\n * // Worker\uC5D0\uC11C \uB370\uC774\uD130 \uC218\uC2E0\n * const decoded = transferableDecode(event.data);\n */\n\n//#region encode\n\n/**\n * \uC2EC\uD50C\uB9AC\uC998 \uD0C0\uC785\uC744 \uC0AC\uC6A9\uD55C \uAC1D\uCCB4\uB97C \uC77C\uBC18 \uAC1D\uCCB4\uB85C \uBCC0\uD658\n * Worker\uC5D0 \uC804\uC1A1\uD560 \uC218 \uC788\uB294 \uD615\uD0DC\uB85C \uC9C1\uB82C\uD654\n *\n * @throws \uC21C\uD658 \uCC38\uC870 \uAC10\uC9C0 \uC2DC TypeError\n */\nexport function transferableEncode(obj: unknown): {\n  result: unknown;\n  transferList: Transferable[];\n} {\n  const transferList: Transferable[] = [];\n  const ancestors = new Set<object>();\n  const cache = new Map<object, unknown>();\n  const result = encodeImpl(obj, transferList, [], ancestors, cache);\n  return { result, transferList };\n}\n\nfunction encodeImpl(\n  obj: unknown,\n  transferList: Transferable[],\n  path: (string | number)[],\n  ancestors: Set<object>,\n  cache: Map<object, unknown>,\n): unknown {\n  if (obj == null) return obj;\n\n  // \uAC1D\uCCB4 \uD0C0\uC785 \uCC98\uB9AC: \uC21C\uD658 \uAC10\uC9C0 + \uCE90\uC2DC\n  if (typeof obj === \"object\") {\n    // \uC21C\uD658 \uCC38\uC870 \uAC10\uC9C0 (\uD604\uC7AC \uC7AC\uADC0 \uC2A4\uD0DD\uC5D0 \uC788\uB294 \uAC1D\uCCB4)\n    if (ancestors.has(obj)) {\n      const currentPath = path.length > 0 ? path.join(\".\") : \"root\";\n      throw new TypeError(`\uC21C\uD658 \uCC38\uC870\uAC00 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4: ${currentPath}`);\n    }\n\n    // \uCE90\uC2DC \uD788\uD2B8 \u2192 \uC774\uC804 \uC778\uCF54\uB529 \uACB0\uACFC \uC7AC\uC0AC\uC6A9\n    const cached = cache.get(obj);\n    if (cached !== undefined) return cached;\n\n    // \uC7AC\uADC0 \uC2A4\uD0DD\uC5D0 \uCD94\uAC00\n    ancestors.add(obj);\n  }\n\n  let result: unknown;\n\n  try {\n    // 1. Uint8Array\n    if (obj instanceof Uint8Array) {\n      // SharedArrayBuffer\uB294 \uC774\uBBF8 \uACF5\uC720 \uBA54\uBAA8\uB9AC\uC774\uBBC0\uB85C transferList\uC5D0 \uCD94\uAC00\uD558\uC9C0 \uC54A\uC74C\n      // ArrayBuffer\uB9CC transferList\uC5D0 \uCD94\uAC00\n      const isSharedArrayBuffer = typeof SharedArrayBuffer !== \"undefined\" && obj.buffer instanceof SharedArrayBuffer;\n      const buffer = obj.buffer as ArrayBuffer;\n      if (!isSharedArrayBuffer && !transferList.includes(buffer)) {\n        transferList.push(buffer);\n      }\n      result = obj;\n    }\n    // 2. \uD2B9\uC218 \uD0C0\uC785 \uBCC0\uD658 (JSON.stringify \uC5C6\uC774 \uAD6C\uC870\uCCB4\uB85C \uBCC0\uD658)\n    else if (obj instanceof Date) {\n      result = { __type__: \"Date\", data: obj.getTime() };\n    } else if (obj instanceof DateTime) {\n      result = { __type__: \"DateTime\", data: obj.tick };\n    } else if (obj instanceof DateOnly) {\n      result = { __type__: \"DateOnly\", data: obj.tick };\n    } else if (obj instanceof Time) {\n      result = { __type__: \"Time\", data: obj.tick };\n    } else if (obj instanceof Uuid) {\n      result = { __type__: \"Uuid\", data: obj.toString() };\n    } else if (obj instanceof RegExp) {\n      result = { __type__: \"RegExp\", data: { source: obj.source, flags: obj.flags } };\n    } else if (obj instanceof Error) {\n      const errObj = obj as Error & {\n        code?: unknown;\n        detail?: unknown;\n      };\n      result = {\n        __type__: \"Error\",\n        data: {\n          name: errObj.name,\n          message: errObj.message,\n          stack: errObj.stack,\n          ...(errObj.code !== undefined ? { code: errObj.code } : {}),\n          ...(errObj.detail !== undefined\n            ? { detail: encodeImpl(errObj.detail, transferList, [...path, \"detail\"], ancestors, cache) }\n            : {}),\n          ...(errObj.cause !== undefined\n            ? { cause: encodeImpl(errObj.cause, transferList, [...path, \"cause\"], ancestors, cache) }\n            : {}),\n        },\n      };\n    }\n    // 3. \uBC30\uC5F4 \uC7AC\uADC0 \uC21C\uD68C\n    else if (Array.isArray(obj)) {\n      result = obj.map((item, idx) => encodeImpl(item, transferList, [...path, idx], ancestors, cache));\n    }\n    // 4. Map \uC7AC\uADC0 \uC21C\uD68C\n    else if (obj instanceof Map) {\n      let idx = 0;\n      result = new Map(\n        Array.from(obj.entries()).map(([k, v]) => {\n          const keyPath = [...path, `Map[${idx}].key`];\n          const valuePath = [...path, `Map[${idx}].value`];\n          idx++;\n          return [\n            encodeImpl(k, transferList, keyPath, ancestors, cache),\n            encodeImpl(v, transferList, valuePath, ancestors, cache),\n          ];\n        }),\n      );\n    }\n    // 5. Set \uC7AC\uADC0 \uC21C\uD68C\n    else if (obj instanceof Set) {\n      let idx = 0;\n      result = new Set(\n        Array.from(obj).map((v) => encodeImpl(v, transferList, [...path, `Set[${idx++}]`], ancestors, cache)),\n      );\n    }\n    // 6. \uC77C\uBC18 \uAC1D\uCCB4 \uC7AC\uADC0 \uC21C\uD68C\n    else if (typeof obj === \"object\") {\n      const res: Record<string, unknown> = {};\n      const record = obj as Record<string, unknown>;\n      for (const key of Object.keys(record)) {\n        res[key] = encodeImpl(record[key], transferList, [...path, key], ancestors, cache);\n      }\n      result = res;\n    }\n    // 7. \uC6D0\uC2DC \uD0C0\uC785\n    else {\n      return obj;\n    }\n\n    // \uCE90\uC2DC \uC800\uC7A5 (\uC131\uACF5 \uC2DC\uC5D0\uB9CC)\n    if (typeof obj === \"object\") {\n      cache.set(obj, result);\n    }\n\n    return result;\n  } finally {\n    // \uC7AC\uADC0 \uC2A4\uD0DD\uC5D0\uC11C \uC81C\uAC70 (\uC608\uC678 \uC2DC\uC5D0\uB3C4 \uBC18\uB4DC\uC2DC \uC2E4\uD589)\n    if (typeof obj === \"object\") {\n      ancestors.delete(obj);\n    }\n  }\n}\n\n//#endregion\n\n//#region decode\n\n/**\n * serialize \uAC1D\uCCB4\uB97C \uC2EC\uD50C\uB9AC\uC998 \uD0C0\uC785 \uC0AC\uC6A9 \uAC1D\uCCB4\uB85C \uBCC0\uD658\n * Worker\uB85C\uBD80\uD130 \uBC1B\uC740 \uB370\uC774\uD130\uB97C \uC5ED\uC9C1\uB82C\uD654\n */\nexport function transferableDecode(obj: unknown): unknown {\n  if (obj == null) return obj;\n\n  // 1. \uD2B9\uC218 \uD0C0\uC785 \uBCF5\uC6D0\n  if (typeof obj === \"object\" && \"__type__\" in obj && \"data\" in obj) {\n    const typed = obj as { __type__: string; data: unknown };\n    const data = typed.data;\n\n    if (typed.__type__ === \"Date\" && typeof data === \"number\") return new Date(data);\n    if (typed.__type__ === \"DateTime\" && typeof data === \"number\") return new DateTime(data);\n    if (typed.__type__ === \"DateOnly\" && typeof data === \"number\") return new DateOnly(data);\n    if (typed.__type__ === \"Time\" && typeof data === \"number\") return new Time(data);\n    if (typed.__type__ === \"Uuid\" && typeof data === \"string\") return new Uuid(data);\n    if (typed.__type__ === \"RegExp\" && typeof data === \"object\" && data !== null) {\n      const regexData = data as { source: string; flags: string };\n      return new RegExp(regexData.source, regexData.flags);\n    }\n    if (typed.__type__ === \"Error\" && typeof data === \"object\" && data !== null) {\n      const errorData = data as {\n        name: string;\n        message: string;\n        stack?: string;\n        code?: unknown;\n        cause?: unknown;\n        detail?: unknown;\n      };\n      const err = new Error(errorData.message) as Error & {\n        code?: unknown;\n        detail?: unknown;\n      };\n\n      err.name = errorData.name;\n      err.stack = errorData.stack;\n\n      if (errorData.code !== undefined) err.code = errorData.code;\n      if (errorData.cause !== undefined) (err as Error).cause = transferableDecode(errorData.cause);\n      if (errorData.detail !== undefined) err.detail = transferableDecode(errorData.detail);\n      return err;\n    }\n  }\n\n  // 2. \uBC30\uC5F4 \uC7AC\uADC0 (\uC0C8 \uBC30\uC5F4 \uC0DD\uC131)\n  if (Array.isArray(obj)) {\n    return obj.map((item) => transferableDecode(item));\n  }\n\n  // 3. Map \uC7AC\uADC0\n  if (obj instanceof Map) {\n    const newMap = new Map<unknown, unknown>();\n    for (const [k, v] of obj) {\n      newMap.set(transferableDecode(k), transferableDecode(v));\n    }\n    return newMap;\n  }\n\n  // 4. Set \uC7AC\uADC0\n  if (obj instanceof Set) {\n    const newSet = new Set<unknown>();\n    for (const v of obj) {\n      newSet.add(transferableDecode(v));\n    }\n    return newSet;\n  }\n\n  // 5. \uAC1D\uCCB4 \uC7AC\uADC0 (\uC0C8 \uAC1D\uCCB4 \uC0DD\uC131)\n  if (typeof obj === \"object\") {\n    const record = obj as Record<string, unknown>;\n    const result: Record<string, unknown> = {};\n    for (const key of Object.keys(record)) {\n      result[key] = transferableDecode(record[key]);\n    }\n    return result;\n  }\n\n  return obj;\n}\n\n//#endregion\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/utils/wait.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 조건이 참이 될 때까지 대기
+ * @param forwarder 조건 함수
+ * @param milliseconds 체크 간격 (기본: 100ms)
+ * @param maxCount 최대 시도 횟수 (undefined면 무제한)
+ *
+ * @note 조건이 첫 번째 호출에서 true면 즉시 반환됩니다.
+ * @example
+ * // maxCount=3: 최대 3번 조건 확인 후 모두 false면 TimeoutError
+ * await waitUntil(() => someCondition, 100, 3);
+ * @throws TimeoutError 최대 시도 횟수 초과 시
+ */
+export declare function waitUntil(forwarder: () => boolean | Promise<boolean>, milliseconds?: number, maxCount?: number): Promise<void>;
+/**
+ * 지정된 시간만큼 대기
+ * @param millisecond 대기 시간 (ms)
+ */
+export declare function waitTime(millisecond: number): Promise<void>;
+//# sourceMappingURL=wait.d.ts.map

package/dist/utils/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC3C,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjE"}

package/dist/utils/wait.js

@@ -0,0 +1,19 @@
+import { TimeoutError } from "../errors/timeout-error";
+async function waitUntil(forwarder, milliseconds, maxCount) {
+  let count = 0;
+  while (!await forwarder()) {
+    count++;
+    if (maxCount !== void 0 && count >= maxCount) {
+      throw new TimeoutError(count);
+    }
+    await waitTime(milliseconds ?? 100);
+  }
+}
+async function waitTime(millisecond) {
+  return new Promise((resolve) => setTimeout(resolve, millisecond));
+}
+export {
+  waitTime,
+  waitUntil
+};
+//# sourceMappingURL=wait.js.map

package/dist/utils/wait.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/wait.ts"],
+  "sourcesContent": ["/**\n * \uB300\uAE30 \uC720\uD2F8\uB9AC\uD2F0 \uD568\uC218\n */\nimport { TimeoutError } from \"../errors/timeout-error\";\n\n/**\n * \uC870\uAC74\uC774 \uCC38\uC774 \uB420 \uB54C\uAE4C\uC9C0 \uB300\uAE30\n * @param forwarder \uC870\uAC74 \uD568\uC218\n * @param milliseconds \uCCB4\uD06C \uAC04\uACA9 (\uAE30\uBCF8: 100ms)\n * @param maxCount \uCD5C\uB300 \uC2DC\uB3C4 \uD69F\uC218 (undefined\uBA74 \uBB34\uC81C\uD55C)\n *\n * @note \uC870\uAC74\uC774 \uCCAB \uBC88\uC9F8 \uD638\uCD9C\uC5D0\uC11C true\uBA74 \uC989\uC2DC \uBC18\uD658\uB429\uB2C8\uB2E4.\n * @example\n * // maxCount=3: \uCD5C\uB300 3\uBC88 \uC870\uAC74 \uD655\uC778 \uD6C4 \uBAA8\uB450 false\uBA74 TimeoutError\n * await waitUntil(() => someCondition, 100, 3);\n * @throws TimeoutError \uCD5C\uB300 \uC2DC\uB3C4 \uD69F\uC218 \uCD08\uACFC \uC2DC\n */\nexport async function waitUntil(\n  forwarder: () => boolean | Promise<boolean>,\n  milliseconds?: number,\n  maxCount?: number,\n): Promise<void> {\n  let count = 0;\n  while (!(await forwarder())) {\n    count++;\n    if (maxCount !== undefined && count >= maxCount) {\n      throw new TimeoutError(count);\n    }\n\n    await waitTime(milliseconds ?? 100);\n  }\n}\n\n/**\n * \uC9C0\uC815\uB41C \uC2DC\uAC04\uB9CC\uD07C \uB300\uAE30\n * @param millisecond \uB300\uAE30 \uC2DC\uAC04 (ms)\n */\nexport async function waitTime(millisecond: number): Promise<void> {\n  return new Promise<void>((resolve) => setTimeout(resolve, millisecond));\n}\n"],
+  "mappings": "AAGA,SAAS,oBAAoB;AAc7B,eAAsB,UACpB,WACA,cACA,UACe;AACf,MAAI,QAAQ;AACZ,SAAO,CAAE,MAAM,UAAU,GAAI;AAC3B;AACA,QAAI,aAAa,UAAa,SAAS,UAAU;AAC/C,YAAM,IAAI,aAAa,KAAK;AAAA,IAC9B;AAEA,UAAM,SAAS,gBAAgB,GAAG;AAAA,EACpC;AACF;AAMA,eAAsB,SAAS,aAAoC;AACjE,SAAO,IAAI,QAAc,CAAC,YAAY,WAAW,SAAS,WAAW,CAAC;AACxE;",
+  "names": []
+}

package/dist/utils/xml.d.ts

@@ -0,0 +1,36 @@
+/**
+ * XML 변환 유틸리티
+ */
+import type { XmlBuilderOptions } from "fast-xml-parser";
+/**
+ * XML 문자열을 객체로 파싱
+ * @param str XML 문자열
+ * @param options 옵션
+ * @param options.stripTagPrefix 태그 prefix 제거 여부 (namespace)
+ * @returns 파싱된 객체. 구조:
+ *   - 속성: `$` 객체에 그룹화
+ *   - 텍스트 노드: `_` 키에 저장
+ *   - 자식 요소: 배열로 변환 (루트 요소 제외)
+ * @example
+ * xmlParse('<root id="1"><item>hello</item></root>');
+ * // { root: { $: { id: "1" }, item: [{ _: "hello" }] } }
+ */
+export declare function xmlParse(str: string, options?: {
+    stripTagPrefix?: boolean;
+}): unknown;
+/**
+ * 객체를 XML 문자열로 직렬화
+ * @param obj 직렬화할 객체
+ * @param options fast-xml-parser XmlBuilderOptions (선택)
+ * @returns XML 문자열
+ * @example
+ * xmlStringify({
+ *   root: {
+ *     $: { id: "1" },
+ *     item: [{ _: "hello" }, { _: "world" }],
+ *   },
+ * });
+ * // '<root id="1"><item>hello</item><item>world</item></root>'
+ */
+export declare function xmlStringify(obj: unknown, options?: XmlBuilderOptions): string;
+//# sourceMappingURL=xml.d.ts.map

package/dist/utils/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/utils/xml.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAarF;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAS9E"}

package/dist/utils/xml.js

@@ -0,0 +1,51 @@
+import { XMLBuilder, XMLParser } from "fast-xml-parser";
+function xmlParse(str, options) {
+  const result = new XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: "",
+    attributesGroupName: "$",
+    parseAttributeValue: false,
+    parseTagValue: false,
+    textNodeName: "_",
+    isArray: (_tagName, jPath, _isLeafNode, isAttribute) => {
+      return !isAttribute && jPath.split(".").length > 1;
+    }
+  }).parse(str);
+  return (options == null ? void 0 : options.stripTagPrefix) ? stripTagPrefix(result) : result;
+}
+function xmlStringify(obj, options) {
+  return new XMLBuilder({
+    ignoreAttributes: false,
+    attributeNamePrefix: "",
+    attributesGroupName: "$",
+    suppressBooleanAttributes: false,
+    textNodeName: "_",
+    ...options
+  }).build(obj);
+}
+function stripTagPrefix(obj) {
+  if (Array.isArray(obj)) {
+    return obj.map((item) => stripTagPrefix(item));
+  }
+  if (typeof obj === "object" && obj !== null) {
+    const newObj = {};
+    const record = obj;
+    for (const key of Object.keys(record)) {
+      const value = record[key];
+      if (key === "$") {
+        newObj[key] = value;
+      } else {
+        const colonIndex = key.indexOf(":");
+        const cleanKey = colonIndex !== -1 ? key.slice(colonIndex + 1) : key;
+        newObj[cleanKey] = stripTagPrefix(value);
+      }
+    }
+    return newObj;
+  }
+  return obj;
+}
+export {
+  xmlParse,
+  xmlStringify
+};
+//# sourceMappingURL=xml.js.map

package/dist/utils/xml.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/xml.ts"],
+  "sourcesContent": ["/**\n * XML \uBCC0\uD658 \uC720\uD2F8\uB9AC\uD2F0\n */\nimport type { XmlBuilderOptions } from \"fast-xml-parser\";\nimport { XMLBuilder, XMLParser } from \"fast-xml-parser\";\n\n//#region parse\n\n/**\n * XML \uBB38\uC790\uC5F4\uC744 \uAC1D\uCCB4\uB85C \uD30C\uC2F1\n * @param str XML \uBB38\uC790\uC5F4\n * @param options \uC635\uC158\n * @param options.stripTagPrefix \uD0DC\uADF8 prefix \uC81C\uAC70 \uC5EC\uBD80 (namespace)\n * @returns \uD30C\uC2F1\uB41C \uAC1D\uCCB4. \uAD6C\uC870:\n *   - \uC18D\uC131: `$` \uAC1D\uCCB4\uC5D0 \uADF8\uB8F9\uD654\n *   - \uD14D\uC2A4\uD2B8 \uB178\uB4DC: `_` \uD0A4\uC5D0 \uC800\uC7A5\n *   - \uC790\uC2DD \uC694\uC18C: \uBC30\uC5F4\uB85C \uBCC0\uD658 (\uB8E8\uD2B8 \uC694\uC18C \uC81C\uC678)\n * @example\n * xmlParse('<root id=\"1\"><item>hello</item></root>');\n * // { root: { $: { id: \"1\" }, item: [{ _: \"hello\" }] } }\n */\nexport function xmlParse(str: string, options?: { stripTagPrefix?: boolean }): unknown {\n  const result = new XMLParser({\n    ignoreAttributes: false,\n    attributeNamePrefix: \"\",\n    attributesGroupName: \"$\",\n    parseAttributeValue: false,\n    parseTagValue: false,\n    textNodeName: \"_\",\n    isArray: (_tagName: string, jPath: string, _isLeafNode: boolean, isAttribute: boolean) => {\n      return !isAttribute && jPath.split(\".\").length > 1;\n    },\n  }).parse(str) as unknown;\n  return options?.stripTagPrefix ? stripTagPrefix(result) : result;\n}\n\n//#endregion\n\n//#region stringify\n\n/**\n * \uAC1D\uCCB4\uB97C XML \uBB38\uC790\uC5F4\uB85C \uC9C1\uB82C\uD654\n * @param obj \uC9C1\uB82C\uD654\uD560 \uAC1D\uCCB4\n * @param options fast-xml-parser XmlBuilderOptions (\uC120\uD0DD)\n * @returns XML \uBB38\uC790\uC5F4\n * @example\n * xmlStringify({\n *   root: {\n *     $: { id: \"1\" },\n *     item: [{ _: \"hello\" }, { _: \"world\" }],\n *   },\n * });\n * // '<root id=\"1\"><item>hello</item><item>world</item></root>'\n */\nexport function xmlStringify(obj: unknown, options?: XmlBuilderOptions): string {\n  return new XMLBuilder({\n    ignoreAttributes: false,\n    attributeNamePrefix: \"\",\n    attributesGroupName: \"$\",\n    suppressBooleanAttributes: false,\n    textNodeName: \"_\",\n    ...options,\n  }).build(obj);\n}\n\n//#endregion\n\n//#region private\n\n/**\n * \uD0DC\uADF8 \uC774\uB984\uC5D0\uC11C namespace prefix \uC81C\uAC70\n * @note XML \uD30C\uC2F1 \uACB0\uACFC\uC5D0\uC11C \"ns:tag\" \uD615\uD0DC\uC758 namespace prefix\uB97C \uC81C\uAC70\uD558\uC5EC \uD0DC\uADF8 \uC774\uB984\uB9CC \uB0A8\uAE34\uB2E4.\n *       \uC774\uB97C \uD1B5\uD574 namespace\uB97C \uACE0\uB824\uD558\uC9C0 \uC54A\uACE0 \uC77C\uAD00\uB41C \uBC29\uC2DD\uC73C\uB85C XML \uB370\uC774\uD130\uC5D0 \uC811\uADFC\uD560 \uC218 \uC788\uB2E4.\n *       \uB2E8, \uC18D\uC131(attribute)\uC740 prefix\uB97C \uC720\uC9C0\uD55C\uB2E4.\n */\nfunction stripTagPrefix(obj: unknown): unknown {\n  if (Array.isArray(obj)) {\n    return obj.map((item) => stripTagPrefix(item));\n  }\n\n  if (typeof obj === \"object\" && obj !== null) {\n    const newObj: Record<string, unknown> = {};\n    const record = obj as Record<string, unknown>;\n\n    for (const key of Object.keys(record)) {\n      const value = record[key];\n\n      // Attribute\uB294 prefix\uB97C \uC81C\uAC70\uD558\uBA74 \uC548 \uB41C\uB2E4.\n      if (key === \"$\") {\n        newObj[key] = value;\n      } else {\n        // \uD0DC\uADF8 \uC774\uB984\uC5D0\uC11C\uB9CC \uCCAB \uBC88\uC9F8 \":\"\uC744 \uAE30\uC900\uC73C\uB85C prefix \uC81C\uAC70\n        const colonIndex = key.indexOf(\":\");\n        const cleanKey = colonIndex !== -1 ? key.slice(colonIndex + 1) : key;\n        newObj[cleanKey] = stripTagPrefix(value);\n      }\n    }\n\n    return newObj;\n  }\n\n  return obj;\n}\n\n//#endregion\n"],
+  "mappings": "AAIA,SAAS,YAAY,iBAAiB;AAiB/B,SAAS,SAAS,KAAa,SAAiD;AACrF,QAAM,SAAS,IAAI,UAAU;AAAA,IAC3B,kBAAkB;AAAA,IAClB,qBAAqB;AAAA,IACrB,qBAAqB;AAAA,IACrB,qBAAqB;AAAA,IACrB,eAAe;AAAA,IACf,cAAc;AAAA,IACd,SAAS,CAAC,UAAkB,OAAe,aAAsB,gBAAyB;AACxF,aAAO,CAAC,eAAe,MAAM,MAAM,GAAG,EAAE,SAAS;AAAA,IACnD;AAAA,EACF,CAAC,EAAE,MAAM,GAAG;AACZ,UAAO,mCAAS,kBAAiB,eAAe,MAAM,IAAI;AAC5D;AAoBO,SAAS,aAAa,KAAc,SAAqC;AAC9E,SAAO,IAAI,WAAW;AAAA,IACpB,kBAAkB;AAAA,IAClB,qBAAqB;AAAA,IACrB,qBAAqB;AAAA,IACrB,2BAA2B;AAAA,IAC3B,cAAc;AAAA,IACd,GAAG;AAAA,EACL,CAAC,EAAE,MAAM,GAAG;AACd;AAYA,SAAS,eAAe,KAAuB;AAC7C,MAAI,MAAM,QAAQ,GAAG,GAAG;AACtB,WAAO,IAAI,IAAI,CAAC,SAAS,eAAe,IAAI,CAAC;AAAA,EAC/C;AAEA,MAAI,OAAO,QAAQ,YAAY,QAAQ,MAAM;AAC3C,UAAM,SAAkC,CAAC;AACzC,UAAM,SAAS;AAEf,eAAW,OAAO,OAAO,KAAK,MAAM,GAAG;AACrC,YAAM,QAAQ,OAAO,GAAG;AAGxB,UAAI,QAAQ,KAAK;AACf,eAAO,GAAG,IAAI;AAAA,MAChB,OAAO;AAEL,cAAM,aAAa,IAAI,QAAQ,GAAG;AAClC,cAAM,WAAW,eAAe,KAAK,IAAI,MAAM,aAAa,CAAC,IAAI;AACjE,eAAO,QAAQ,IAAI,eAAe,KAAK;AAAA,MACzC;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;",
+  "names": []
+}

package/dist/zip/sd-zip.d.ts

@@ -0,0 +1,80 @@
+import type { Bytes } from "../common.types";
+export interface ZipArchiveProgress {
+    fileName: string;
+    totalSize: number;
+    extractedSize: number;
+}
+/**
+ * ZIP 아카이브 처리 클래스
+ *
+ * ZIP 파일의 읽기, 쓰기, 압축/해제를 처리합니다.
+ * 내부 캐시를 사용하여 동일 파일의 중복 압축 해제를 방지합니다.
+ *
+ * @example
+ * // ZIP 파일 읽기
+ * await using archive = new ZipArchive(zipBytes);
+ * const content = await archive.get("file.txt");
+ *
+ * @example
+ * // ZIP 파일 생성
+ * await using archive = new ZipArchive();
+ * archive.write("file.txt", textBytes);
+ * archive.write("data.json", jsonBytes);
+ * const zipBytes = await archive.compress();
+ *
+ * @example
+ * // 전체 압축 해제 (진행률 표시)
+ * await using archive = new ZipArchive(zipBytes);
+ * const files = await archive.extractAll((progress) => {
+ *   console.log(`${progress.fileName}: ${progress.extractedSize}/${progress.totalSize}`);
+ * });
+ */
+export declare class ZipArchive {
+    private readonly _reader?;
+    private readonly _cache;
+    private _entries?;
+    /**
+     * ZipArchive 생성
+     * @param data ZIP 데이터 (생략 시 새 아카이브 생성)
+     */
+    constructor(data?: Blob | Bytes);
+    private _getEntries;
+    /**
+     * 모든 파일을 압축 해제
+     * @param progressCallback 진행률 콜백
+     */
+    extractAll(progressCallback?: (progress: ZipArchiveProgress) => void): Promise<Map<string, Bytes | undefined>>;
+    /**
+     * 특정 파일 압축 해제
+     * @param fileName 파일 이름
+     */
+    get(fileName: string): Promise<Bytes | undefined>;
+    /**
+     * 파일 존재 여부 확인
+     * @param fileName 파일 이름
+     */
+    exists(fileName: string): Promise<boolean>;
+    /**
+     * 파일 쓰기 (캐시에 저장)
+     * @param fileName 파일 이름
+     * @param bytes 파일 내용
+     */
+    write(fileName: string, bytes: Bytes): void;
+    /**
+     * 캐시된 파일들을 ZIP으로 압축
+     *
+     * @remarks
+     * 내부적으로 `extractAll()`을 호출하여 모든 파일을 메모리에 로드한 후 압축합니다.
+     * 대용량 ZIP 파일의 경우 메모리 사용량에 주의가 필요합니다.
+     */
+    compress(): Promise<Bytes>;
+    /**
+     * 리더 닫기 및 캐시 정리
+     */
+    close(): Promise<void>;
+    /**
+     * await using 지원
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=sd-zip.d.ts.map

package/dist/zip/sd-zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-zip.d.ts","sourceRoot":"","sources":["../../src/zip/sd-zip.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,CAA6D;IAE9E;;;OAGG;gBACS,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK;YAUjB,WAAW;IAQzB;;;OAGG;IACG,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;IAkDpH;;;OAGG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAwBvD;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBhD;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAM3C;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;IAiBhC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7C"}

package/dist/zip/sd-zip.js

@@ -0,0 +1,153 @@
+import { BlobReader, Uint8ArrayReader, Uint8ArrayWriter, ZipReader, ZipWriter } from "@zip.js/zip.js";
+class ZipArchive {
+  _reader;
+  _cache = /* @__PURE__ */ new Map();
+  _entries;
+  /**
+   * ZipArchive 생성
+   * @param data ZIP 데이터 (생략 시 새 아카이브 생성)
+   */
+  constructor(data) {
+    if (!data) return;
+    if (data instanceof Uint8Array) {
+      this._reader = new ZipReader(new Uint8ArrayReader(data));
+    } else {
+      this._reader = new ZipReader(new BlobReader(data));
+    }
+  }
+  async _getEntries() {
+    if (this._entries == null && this._reader != null) {
+      this._entries = await this._reader.getEntries();
+    }
+    return this._entries;
+  }
+  //#region extractAll
+  /**
+   * 모든 파일을 압축 해제
+   * @param progressCallback 진행률 콜백
+   */
+  async extractAll(progressCallback) {
+    const entries = await this._getEntries();
+    if (entries == null) return this._cache;
+    const totalSize = entries.filter((e) => !e.directory).reduce((acc, e) => acc + e.uncompressedSize, 0);
+    let totalExtracted = 0;
+    for (const entry of entries) {
+      if (entry.directory) continue;
+      progressCallback == null ? void 0 : progressCallback({
+        fileName: entry.filename,
+        totalSize,
+        extractedSize: totalExtracted
+      });
+      const entryBytes = this._cache.get(entry.filename) ?? await entry.getData(new Uint8ArrayWriter(), {
+        onprogress: (extracted) => {
+          const currentTotal = totalExtracted + extracted;
+          progressCallback == null ? void 0 : progressCallback({
+            fileName: entry.filename,
+            totalSize,
+            extractedSize: currentTotal
+          });
+          return void 0;
+        }
+      });
+      this._cache.set(entry.filename, entryBytes);
+      totalExtracted += entry.uncompressedSize;
+      progressCallback == null ? void 0 : progressCallback({
+        fileName: entry.filename,
+        totalSize,
+        extractedSize: totalExtracted
+      });
+    }
+    return this._cache;
+  }
+  //#endregion
+  //#region get
+  /**
+   * 특정 파일 압축 해제
+   * @param fileName 파일 이름
+   */
+  async get(fileName) {
+    if (this._cache.has(fileName)) {
+      return this._cache.get(fileName);
+    }
+    const entries = await this._getEntries();
+    if (entries == null) {
+      this._cache.set(fileName, void 0);
+      return void 0;
+    }
+    const entry = entries.find((item) => item.filename === fileName);
+    if (!entry) {
+      this._cache.set(fileName, void 0);
+      return void 0;
+    }
+    const bytes = await entry.getData(new Uint8ArrayWriter());
+    this._cache.set(fileName, bytes);
+    return bytes;
+  }
+  //#endregion
+  //#region exists
+  /**
+   * 파일 존재 여부 확인
+   * @param fileName 파일 이름
+   */
+  async exists(fileName) {
+    if (this._cache.has(fileName)) {
+      return this._cache.get(fileName) != null;
+    }
+    const entries = await this._getEntries();
+    if (entries == null) {
+      return false;
+    }
+    const entry = entries.find((item) => item.filename === fileName);
+    return entry !== void 0;
+  }
+  //#endregion
+  //#region write
+  /**
+   * 파일 쓰기 (캐시에 저장)
+   * @param fileName 파일 이름
+   * @param bytes 파일 내용
+   */
+  write(fileName, bytes) {
+    this._cache.set(fileName, bytes);
+  }
+  //#endregion
+  //#region compress
+  /**
+   * 캐시된 파일들을 ZIP으로 압축
+   *
+   * @remarks
+   * 내부적으로 `extractAll()`을 호출하여 모든 파일을 메모리에 로드한 후 압축합니다.
+   * 대용량 ZIP 파일의 경우 메모리 사용량에 주의가 필요합니다.
+   */
+  async compress() {
+    const fileMap = await this.extractAll();
+    const writer = new ZipWriter(new Uint8ArrayWriter());
+    for (const key of fileMap.keys()) {
+      const fileBytes = fileMap.get(key);
+      if (!fileBytes) continue;
+      await writer.add(key, new Uint8ArrayReader(fileBytes));
+    }
+    return writer.close();
+  }
+  //#endregion
+  //#region close
+  /**
+   * 리더 닫기 및 캐시 정리
+   */
+  async close() {
+    var _a;
+    await ((_a = this._reader) == null ? void 0 : _a.close());
+    this._cache.clear();
+  }
+  /**
+   * await using 지원
+   */
+  async [Symbol.asyncDispose]() {
+    await this.close();
+  }
+  //#endregion
+}
+export {
+  ZipArchive
+};
+//# sourceMappingURL=sd-zip.js.map

package/dist/zip/sd-zip.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/zip/sd-zip.ts"],
+  "sourcesContent": ["/**\n * ZIP \uD30C\uC77C \uCC98\uB9AC \uC720\uD2F8\uB9AC\uD2F0\n */\nimport type { FileEntry } from \"@zip.js/zip.js\";\nimport { BlobReader, Uint8ArrayReader, Uint8ArrayWriter, ZipReader, ZipWriter } from \"@zip.js/zip.js\";\nimport type { Bytes } from \"../common.types\";\n\nexport interface ZipArchiveProgress {\n  fileName: string;\n  totalSize: number;\n  extractedSize: number;\n}\n\n/**\n * ZIP \uC544\uCE74\uC774\uBE0C \uCC98\uB9AC \uD074\uB798\uC2A4\n *\n * ZIP \uD30C\uC77C\uC758 \uC77D\uAE30, \uC4F0\uAE30, \uC555\uCD95/\uD574\uC81C\uB97C \uCC98\uB9AC\uD569\uB2C8\uB2E4.\n * \uB0B4\uBD80 \uCE90\uC2DC\uB97C \uC0AC\uC6A9\uD558\uC5EC \uB3D9\uC77C \uD30C\uC77C\uC758 \uC911\uBCF5 \uC555\uCD95 \uD574\uC81C\uB97C \uBC29\uC9C0\uD569\uB2C8\uB2E4.\n *\n * @example\n * // ZIP \uD30C\uC77C \uC77D\uAE30\n * await using archive = new ZipArchive(zipBytes);\n * const content = await archive.get(\"file.txt\");\n *\n * @example\n * // ZIP \uD30C\uC77C \uC0DD\uC131\n * await using archive = new ZipArchive();\n * archive.write(\"file.txt\", textBytes);\n * archive.write(\"data.json\", jsonBytes);\n * const zipBytes = await archive.compress();\n *\n * @example\n * // \uC804\uCCB4 \uC555\uCD95 \uD574\uC81C (\uC9C4\uD589\uB960 \uD45C\uC2DC)\n * await using archive = new ZipArchive(zipBytes);\n * const files = await archive.extractAll((progress) => {\n *   console.log(`${progress.fileName}: ${progress.extractedSize}/${progress.totalSize}`);\n * });\n */\nexport class ZipArchive {\n  private readonly _reader?: ZipReader<Blob | Bytes>;\n  private readonly _cache = new Map<string, Bytes | undefined>();\n  private _entries?: Awaited<ReturnType<ZipReader<Blob | Bytes>[\"getEntries\"]>>;\n\n  /**\n   * ZipArchive \uC0DD\uC131\n   * @param data ZIP \uB370\uC774\uD130 (\uC0DD\uB7B5 \uC2DC \uC0C8 \uC544\uCE74\uC774\uBE0C \uC0DD\uC131)\n   */\n  constructor(data?: Blob | Bytes) {\n    if (!data) return;\n\n    if (data instanceof Uint8Array) {\n      this._reader = new ZipReader(new Uint8ArrayReader(data));\n    } else {\n      this._reader = new ZipReader(new BlobReader(data));\n    }\n  }\n\n  private async _getEntries() {\n    if (this._entries == null && this._reader != null) {\n      this._entries = await this._reader.getEntries();\n    }\n    return this._entries;\n  }\n\n  //#region extractAll\n  /**\n   * \uBAA8\uB4E0 \uD30C\uC77C\uC744 \uC555\uCD95 \uD574\uC81C\n   * @param progressCallback \uC9C4\uD589\uB960 \uCF5C\uBC31\n   */\n  async extractAll(progressCallback?: (progress: ZipArchiveProgress) => void): Promise<Map<string, Bytes | undefined>> {\n    const entries = await this._getEntries();\n    if (entries == null) return this._cache;\n\n    // \uC555\uCD95 \uD574\uC81C \uB300\uC0C1 \uD06C\uAE30 \uCD1D\uD569 \uACC4\uC0B0\n    const totalSize = entries.filter((e) => !e.directory).reduce((acc, e) => acc + e.uncompressedSize, 0);\n\n    let totalExtracted = 0;\n    for (const entry of entries) {\n      if (entry.directory) continue;\n\n      progressCallback?.({\n        fileName: entry.filename,\n        totalSize: totalSize,\n        extractedSize: totalExtracted,\n      });\n\n      const entryBytes =\n        this._cache.get(entry.filename) ??\n        (await entry.getData(new Uint8ArrayWriter(), {\n          onprogress: (extracted) => {\n            const currentTotal = totalExtracted + extracted;\n\n            progressCallback?.({\n              fileName: entry.filename,\n              totalSize: totalSize,\n              extractedSize: currentTotal,\n            });\n\n            return undefined;\n          },\n        }));\n\n      this._cache.set(entry.filename, entryBytes);\n\n      // \uAC1C\uBCC4 \uD30C\uC77C\uC774 \uB05D\uB098\uBA74 \uB204\uC801 \uCC98\uB9AC\n      totalExtracted += entry.uncompressedSize;\n\n      progressCallback?.({\n        fileName: entry.filename,\n        totalSize: totalSize,\n        extractedSize: totalExtracted,\n      });\n    }\n\n    return this._cache;\n  }\n  //#endregion\n\n  //#region get\n  /**\n   * \uD2B9\uC815 \uD30C\uC77C \uC555\uCD95 \uD574\uC81C\n   * @param fileName \uD30C\uC77C \uC774\uB984\n   */\n  async get(fileName: string): Promise<Bytes | undefined> {\n    if (this._cache.has(fileName)) {\n      return this._cache.get(fileName);\n    }\n\n    const entries = await this._getEntries();\n    if (entries == null) {\n      this._cache.set(fileName, undefined);\n      return undefined;\n    }\n\n    const entry = entries.find((item) => item.filename === fileName) as FileEntry | undefined;\n    if (!entry) {\n      this._cache.set(fileName, undefined);\n      return undefined;\n    }\n\n    const bytes = await entry.getData(new Uint8ArrayWriter());\n    this._cache.set(fileName, bytes);\n    return bytes;\n  }\n  //#endregion\n\n  //#region exists\n  /**\n   * \uD30C\uC77C \uC874\uC7AC \uC5EC\uBD80 \uD655\uC778\n   * @param fileName \uD30C\uC77C \uC774\uB984\n   */\n  async exists(fileName: string): Promise<boolean> {\n    if (this._cache.has(fileName)) {\n      return this._cache.get(fileName) != null;\n    }\n\n    const entries = await this._getEntries();\n    if (entries == null) {\n      return false;\n    }\n\n    const entry = entries.find((item) => item.filename === fileName) as FileEntry | undefined;\n    return entry !== undefined;\n  }\n  //#endregion\n\n  //#region write\n  /**\n   * \uD30C\uC77C \uC4F0\uAE30 (\uCE90\uC2DC\uC5D0 \uC800\uC7A5)\n   * @param fileName \uD30C\uC77C \uC774\uB984\n   * @param bytes \uD30C\uC77C \uB0B4\uC6A9\n   */\n  write(fileName: string, bytes: Bytes): void {\n    this._cache.set(fileName, bytes);\n  }\n  //#endregion\n\n  //#region compress\n  /**\n   * \uCE90\uC2DC\uB41C \uD30C\uC77C\uB4E4\uC744 ZIP\uC73C\uB85C \uC555\uCD95\n   *\n   * @remarks\n   * \uB0B4\uBD80\uC801\uC73C\uB85C `extractAll()`\uC744 \uD638\uCD9C\uD558\uC5EC \uBAA8\uB4E0 \uD30C\uC77C\uC744 \uBA54\uBAA8\uB9AC\uC5D0 \uB85C\uB4DC\uD55C \uD6C4 \uC555\uCD95\uD569\uB2C8\uB2E4.\n   * \uB300\uC6A9\uB7C9 ZIP \uD30C\uC77C\uC758 \uACBD\uC6B0 \uBA54\uBAA8\uB9AC \uC0AC\uC6A9\uB7C9\uC5D0 \uC8FC\uC758\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.\n   */\n  async compress(): Promise<Bytes> {\n    const fileMap = await this.extractAll();\n\n    const writer = new ZipWriter(new Uint8ArrayWriter());\n\n    for (const key of fileMap.keys()) {\n      const fileBytes = fileMap.get(key);\n      if (!fileBytes) continue;\n\n      await writer.add(key, new Uint8ArrayReader(fileBytes));\n    }\n\n    return writer.close();\n  }\n  //#endregion\n\n  //#region close\n  /**\n   * \uB9AC\uB354 \uB2EB\uAE30 \uBC0F \uCE90\uC2DC \uC815\uB9AC\n   */\n  async close(): Promise<void> {\n    await this._reader?.close();\n    this._cache.clear();\n  }\n\n  /**\n   * await using \uC9C0\uC6D0\n   */\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.close();\n  }\n  //#endregion\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@simplysm/core-common",
+  "version": "13.0.0-beta.1",
+  "description": "심플리즘 패키지 - 코어 모듈 (common)",
+  "author": "김석래",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kslhunter/simplysm.git",
+    "directory": "packages/core-common"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": [
+    "./src/extensions/arr-ext.ts",
+    "./src/extensions/map-ext.ts",
+    "./src/extensions/set-ext.ts",
+    "./src/index.ts",
+    "./dist/extensions/arr-ext.js",
+    "./dist/extensions/map-ext.js",
+    "./dist/extensions/set-ext.js",
+    "./dist/index.js"
+  ],
+  "dependencies": {
+    "@zip.js/zip.js": "^2.8.15",
+    "consola": "^3.4.2",
+    "fast-xml-parser": "^5.3.3",
+    "yaml": "^2.8.2"
+  }
+}