@simplysm/service-client 13.0.99 → 14.0.1

package/dist/types/connection-options.d.ts

@@ -2,7 +2,7 @@ export interface ServiceConnectionOptions {
     port: number;
     host: string;
     ssl?: boolean;
-    /** Set to 0 to disable reconnect; disconnects immediately */
+    /** 0으로 설정하면 재연결을 비활성화하고 즉시 연결을 끊음 */
     maxReconnectCount?: number;
 }
 //# sourceMappingURL=connection-options.d.ts.map

package/dist/types/connection-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-options.d.ts","sourceRoot":"","sources":["..\\..\\src\\types\\connection-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"connection-options.d.ts","sourceRoot":"","sources":["..\\..\\src\\types\\connection-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/types/connection-options.js

@@ -1 +1,2 @@
-//# sourceMappingURL=connection-options.js.map
+export {};
+//# sourceMappingURL=connection-options.js.map

package/dist/types/connection-options.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": [],
-  "mappings": "",
-  "names": []
-}
+{"version":3,"file":"connection-options.js","sourceRoot":"","sources":["..\\..\\src\\types\\connection-options.ts"],"names":[],"mappings":""}

package/dist/types/progress.types.d.ts

@@ -1,6 +1,7 @@
 export interface ServiceProgress {
     request?: (s: ServiceProgressState) => void;
     response?: (s: ServiceProgressState) => void;
+    server?: (s: ServiceProgressState) => void;
 }
 export interface ServiceProgressState {
     uuid: string;

package/dist/types/progress.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progress.types.d.ts","sourceRoot":"","sources":["..\\..\\src\\types\\progress.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"progress.types.d.ts","sourceRoot":"","sources":["..\\..\\src\\types\\progress.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC7C,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/progress.types.js

@@ -1 +1,2 @@
-//# sourceMappingURL=progress.types.js.map
+export {};
+//# sourceMappingURL=progress.types.js.map

package/dist/types/progress.types.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": [],
-  "mappings": "",
-  "names": []
-}
+{"version":3,"file":"progress.types.js","sourceRoot":"","sources":["..\\..\\src\\types\\progress.types.ts"],"names":[],"mappings":""}

package/dist/workers/client-protocol.worker.js

@@ -1,30 +1,44 @@
+/// <reference lib="webworker" />
 import { createServiceProtocol } from "@simplysm/service-common";
 import { transfer } from "@simplysm/core-common";
 const protocol = createServiceProtocol();
 self.onmessage = (event) => {
-  const { id, type, data } = event.data;
-  try {
-    let result;
-    let transferList = [];
-    if (type === "encode") {
-      const { uuid, message } = data;
-      const { chunks } = protocol.encode(uuid, message);
-      result = chunks;
-      transferList = chunks.map((chunk) => chunk.buffer);
-    } else {
-      const bytes = new Uint8Array(data);
-      const decodeResult = protocol.decode(bytes);
-      const encoded = transfer.encode(decodeResult);
-      result = encoded.result;
-      transferList = encoded.transferList;
+    const { id, type, data } = event.data;
+    try {
+        let result;
+        let transferList = [];
+        if (type === "encode") {
+            // [Main -> Worker] 인코딩 요청 (data: { uuid, message })
+            // message는 이미 Plain Object임 (Structured Clone을 통해 전달)
+            const { uuid, message } = data;
+            const { chunks } = protocol.encode(uuid, message);
+            // Buffer[]는 전송 가능하므로 결과로 반환
+            result = chunks;
+            // 결과 chunk의 내부 ArrayBuffer를 전송 목록에 추가
+            transferList = chunks.map((chunk) => chunk.buffer);
+        }
+        else {
+            // [Main -> Worker] 디코딩 요청 (data: Uint8Array)
+            // data는 Uint8Array로 전달됨
+            const bytes = new Uint8Array(data);
+            const decodeResult = protocol.decode(bytes);
+            // 결과 객체를 전송 가능한 형태로 변환 (zero-copy 준비)
+            const encoded = transfer.encode(decodeResult);
+            result = encoded.result;
+            transferList = encoded.transferList;
+        }
+        // [Worker -> Main] 성공 응답
+        self.postMessage({ id, type: "success", result }, { transfer: transferList });
+    }
+    catch (err) {
+        // [Worker -> Main] 에러 응답
+        self.postMessage({
+            id,
+            type: "error",
+            error: err instanceof Error
+                ? { message: err.message, stack: err.stack }
+                : { message: String(err) },
+        });
     }
-    self.postMessage({ id, type: "success", result }, { transfer: transferList });
-  } catch (err) {
-    self.postMessage({
-      id,
-      type: "error",
-      error: err instanceof Error ? { message: err.message, stack: err.stack } : { message: String(err) }
-    });
-  }
 };
-//# sourceMappingURL=client-protocol.worker.js.map
+//# sourceMappingURL=client-protocol.worker.js.map

package/dist/workers/client-protocol.worker.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/workers/client-protocol.worker.ts"],
-  "mappings": "AAEA,SAAS,6BAA6B;AACtC,SAAS,gBAAgB;AAEzB,MAAM,WAAW,sBAAsB;AAEvC,KAAK,YAAY,CAAC,UAAwB;AACxC,QAAM,EAAE,IAAI,MAAM,KAAK,IAAI,MAAM;AAMjC,MAAI;AACF,QAAI;AACJ,QAAI,eAA+B,CAAC;AAEpC,QAAI,SAAS,UAAU;AAGrB,YAAM,EAAE,MAAM,QAAQ,IAAI;AAI1B,YAAM,EAAE,OAAO,IAAI,SAAS,OAAO,MAAM,OAAO;AAGhD,eAAS;AAET,qBAAe,OAAO,IAAI,CAAC,UAAU,MAAM,MAAqB;AAAA,IAClE,OAAO;AAGL,YAAM,QAAQ,IAAI,WAAW,IAAmB;AAChD,YAAM,eAAe,SAAS,OAAO,KAAK;AAG1C,YAAM,UAAU,SAAS,OAAO,YAAY;AAC5C,eAAS,QAAQ;AACjB,qBAAe,QAAQ;AAAA,IACzB;AAGA,SAAK,YAAY,EAAE,IAAI,MAAM,WAAW,OAAO,GAAG,EAAE,UAAU,aAAa,CAAC;AAAA,EAC9E,SAAS,KAAK;AAEZ,SAAK,YAAY;AAAA,MACf;AAAA,MACA,MAAM;AAAA,MACN,OACE,eAAe,QACX,EAAE,SAAS,IAAI,SAAS,OAAO,IAAI,MAAM,IACzC,EAAE,SAAS,OAAO,GAAG,EAAE;AAAA,IAC/B,CAAC;AAAA,EACH;AACF;",
-  "names": []
-}
+{"version":3,"file":"client-protocol.worker.js","sourceRoot":"","sources":["..\\..\\src\\workers\\client-protocol.worker.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAEjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;AAEzC,IAAI,CAAC,SAAS,GAAG,CAAC,KAAmB,EAAE,EAAE;IACvC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,IAIhC,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,MAAe,CAAC;QACpB,IAAI,YAAY,GAAmB,EAAE,CAAC;QAEtC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,oDAAoD;YACpD,sDAAsD;YACtD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAGzB,CAAC;YACF,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAElD,4BAA4B;YAC5B,MAAM,GAAG,MAAM,CAAC;YAChB,sCAAsC;YACtC,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAqB,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,6CAA6C;YAC7C,wBAAwB;YACxB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAmB,CAAC,CAAC;YAClD,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAE5C,sCAAsC;YACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC9C,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YACxB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACtC,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;IAChF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yBAAyB;QACzB,IAAI,CAAC,WAAW,CAAC;YACf,EAAE;YACF,IAAI,EAAE,OAAO;YACb,KAAK,EACH,GAAG,YAAY,KAAK;gBAClB,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE;gBAC5C,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@simplysm/service-client",
-  "version": "13.0.99",
-  "description": "Simplysm package - Service module (client)",
-  "author": "simplysm",
+  "version": "14.0.1",
+  "description": "심플리즘 패키지 - 서비스 (client)",
+  "author": "심플리즘",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -14,18 +14,25 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "src",
-    "docs"
+    "src"
   ],
   "sideEffects": false,
   "dependencies": {
     "consola": "^3.4.2",
-    "@simplysm/core-common": "13.0.99",
-    "@simplysm/service-common": "13.0.99",
-    "@simplysm/orm-common": "13.0.99"
+    "@simplysm/core-common": "14.0.1",
+    "@simplysm/orm-common": "14.0.1",
+    "@simplysm/service-common": "14.0.1"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",
-    "ws": "^8.19.0"
+    "ws": "^8.20.0"
+  },
+  "peerDependencies": {
+    "ws": "^8"
+  },
+  "peerDependenciesMeta": {
+    "ws": {
+      "optional": true
+    }
   }
 }

package/src/features/event-client.ts

@@ -38,13 +38,13 @@ export function createEventClient(transport: ServiceTransport): EventClient {
     const key = Uuid.generate().toString();
     const eventName = eventDef.eventName;
 
-    // Send registration request to server
+    // 서버에 등록 요청 전송
     await transport.send({
       name: "evt:add",
       body: { key, name: eventName, info },
     });
 
-    // Store in local map (for recovery on reconnect)
+    // 로컬 맵에 저장 (재연결 시 복구용)
     listenerMap.set(key, {
       eventName,
       info,
@@ -59,7 +59,7 @@ export function createEventClient(transport: ServiceTransport): EventClient {
     try {
       await transport.send({ name: "evt:remove", body: { key } });
     } catch {
-      // Server auto-cleans event listeners on disconnect; safe to ignore
+      // 서버가 연결 끊김 시 이벤트 리스너를 자동 정리하므로 무시해도 안전함
     }
   }
 
@@ -70,7 +70,7 @@ export function createEventClient(transport: ServiceTransport): EventClient {
   ): Promise<void> {
     const eventName = eventDef.eventName;
 
-    // Send 'gets' request to server to obtain targets
+    // 서버에 'gets' 요청을 보내 대상 목록 조회
     const listenerInfos = (await transport.send({
       name: "evt:gets",
       body: { name: eventName },
@@ -88,21 +88,23 @@ export function createEventClient(transport: ServiceTransport): EventClient {
     }
   }
 
-  // Called on reconnect
+  // 재연결 시 호출
   async function resubscribeAll(): Promise<void> {
-    for (const [key, value] of listenerMap.entries()) {
-      try {
-        await transport.send({
-          name: "evt:add",
-          body: { key, name: value.eventName, info: value.info },
-        });
-      } catch (err) {
-        logger.error("Failed to recover event listener", { err, eventName: value.eventName });
-      }
-    }
+    await Promise.allSettled(
+      Array.from(listenerMap.entries()).map(async ([key, value]) => {
+        try {
+          await transport.send({
+            name: "evt:add",
+            body: { key, name: value.eventName, info: value.info },
+          });
+        } catch (err) {
+          logger.error("이벤트 리스너 복구 실패", { err, eventName: value.eventName });
+        }
+      }),
+    );
   }
 
-  // Dispatch server events to local listeners
+  // 서버 이벤트를 로컬 리스너에 디스패치
   async function executeByKey(keys: string[], data: unknown): Promise<void> {
     for (const key of keys) {
       const entry = listenerMap.get(key);
@@ -110,7 +112,7 @@ export function createEventClient(transport: ServiceTransport): EventClient {
         try {
           await entry.cb(data);
         } catch (err) {
-          logger.error("Event handler error", { err, eventName: entry.eventName });
+          logger.error("이벤트 핸들러 에러", { err, eventName: entry.eventName });
         }
       }
     }

package/src/features/file-client.ts

@@ -11,12 +11,12 @@ export interface FileClient {
 
 export function createFileClient(hostUrl: string, clientName: string): FileClient {
   async function download(relPath: string): Promise<Bytes> {
-    // Build URL
+    // URL 생성
     const url = `${hostUrl}${relPath.startsWith("/") ? "" : "/"}${relPath}`;
 
     const res = await fetch(url);
     if (!res.ok) {
-      throw new Error(`Download failed: ${res.status} ${res.statusText}`);
+      throw new Error(`다운로드 실패: ${res.status} ${res.statusText}`);
     }
 
     // ArrayBuffer -> Uint8Array
@@ -32,11 +32,11 @@ export function createFileClient(hostUrl: string, clientName: string): FileClien
 
     for (const file of fileList) {
       if ("data" in file) {
-        // Custom object ({ name, data })
+        // 커스텀 객체 ({ name, data })
         const blob = file.data instanceof Blob ? file.data : new Blob([file.data]);
         formData.append("files", blob, file.name);
       } else {
-        // Browser File object
+        // 브라우저 File 객체
         formData.append("files", file, file.name);
       }
     }
@@ -51,7 +51,7 @@ export function createFileClient(hostUrl: string, clientName: string): FileClien
     });
 
     if (!res.ok) {
-      throw new Error(`Upload failed: ${res.statusText}`);
+      throw new Error(`업로드 실패: ${res.statusText}`);
     }
 
     return res.json();

package/src/features/orm/orm-client-connector.ts

@@ -22,7 +22,7 @@ export function createOrmClientConnector(serviceClient: ServiceClient): OrmClien
     const info = await executor.getInfo();
     const database = config.dbContextOpt?.database ?? info.database;
     if (database == null || database === "") {
-      throw new Error("database is required");
+      throw new Error("database는 필수입니다.");
     }
     return createDbContext(config.dbContextDef, executor, {
       database,
@@ -44,7 +44,7 @@ export function createOrmClientConnector(serviceClient: ServiceClient): OrmClien
           (err.message.includes("a parent row: a foreign key constraint") ||
             err.message.includes("conflicted with the REFERENCE"))
         ) {
-          throw new Error("Warning! Operation rejected due to related operations. Please check subsequent operations.", { cause: err });
+          throw new Error("경고! 연관된 작업으로 인해 작업이 거부되었습니다. 후속 작업을 확인해 주세요.", { cause: err });
         }
 
         throw err;

package/src/features/orm/orm-client-db-context-executor.ts

@@ -34,7 +34,7 @@ export class OrmClientDbContextExecutor implements DbContextExecutor {
 
   async beginTransaction(isolationLevel?: IsolationLevel): Promise<void> {
     if (this._connId === undefined) {
-      throw new Error("Not connected to the database.");
+      throw new Error("데이터베이스에 연결되지 않았습니다.");
     }
 
     await this._ormService.beginTransaction(this._connId, isolationLevel);
@@ -42,7 +42,7 @@ export class OrmClientDbContextExecutor implements DbContextExecutor {
 
   async commitTransaction(): Promise<void> {
     if (this._connId === undefined) {
-      throw new Error("Not connected to the database.");
+      throw new Error("데이터베이스에 연결되지 않았습니다.");
     }
 
     await this._ormService.commitTransaction(this._connId);
@@ -50,7 +50,7 @@ export class OrmClientDbContextExecutor implements DbContextExecutor {
 
   async rollbackTransaction(): Promise<void> {
     if (this._connId === undefined) {
-      throw new Error("Not connected to the database.");
+      throw new Error("데이터베이스에 연결되지 않았습니다.");
     }
 
     await this._ormService.rollbackTransaction(this._connId);
@@ -58,10 +58,11 @@ export class OrmClientDbContextExecutor implements DbContextExecutor {
 
   async close(): Promise<void> {
     if (this._connId === undefined) {
-      throw new Error("Not connected to the database.");
+      throw new Error("데이터베이스에 연결되지 않았습니다.");
     }
 
     await this._ormService.close(this._connId);
+    this._connId = undefined;
   }
 
   async executeDefs<T = Record<string, unknown>>(
@@ -69,7 +70,7 @@ export class OrmClientDbContextExecutor implements DbContextExecutor {
     options?: (ResultMeta | undefined)[],
   ): Promise<T[][]> {
     if (this._connId === undefined) {
-      throw new Error("Not connected to the database.");
+      throw new Error("데이터베이스에 연결되지 않았습니다.");
     }
 
     return (await this._ormService.executeDefs(this._connId, defs, options)) as T[][];
@@ -77,7 +78,7 @@ export class OrmClientDbContextExecutor implements DbContextExecutor {
 
   async executeParametrized(query: string, params?: unknown[]): Promise<unknown[][]> {
     if (this._connId === undefined) {
-      throw new Error("Not connected to the database.");
+      throw new Error("데이터베이스에 연결되지 않았습니다.");
     }
 
     return this._ormService.executeParametrized(this._connId, query, params);
@@ -89,7 +90,7 @@ export class OrmClientDbContextExecutor implements DbContextExecutor {
     records: Record<string, unknown>[],
   ): Promise<void> {
     if (this._connId === undefined) {
-      throw new Error("Not connected to the database.");
+      throw new Error("데이터베이스에 연결되지 않았습니다.");
     }
 
     return this._ormService.bulkInsert(this._connId, tableName, columnDefs, records);

package/src/index.ts

@@ -1,20 +1,20 @@
-// Types
+// 타입
 export * from "./types/connection-options";
 export * from "./types/progress.types";
 
-// Transport
+// 전송 계층
 export * from "./transport/socket-provider";
 export * from "./transport/service-transport";
 
-// Protocol
+// 프로토콜
 export * from "./protocol/client-protocol-wrapper";
 
-// Features
+// 기능
 export * from "./features/event-client";
 export * from "./features/file-client";
 export * from "./features/orm/orm-connect-options";
 export * from "./features/orm/orm-client-connector";
 export * from "./features/orm/orm-client-db-context-executor";
 
-// Main
+// 메인
 export * from "./service-client";

package/src/protocol/client-protocol-wrapper.ts

@@ -9,19 +9,20 @@ import type {
 export interface ClientProtocolWrapper {
   encode(uuid: string, message: ServiceMessage): Promise<{ chunks: Bytes[]; totalSize: number }>;
   decode(bytes: Bytes): Promise<ServiceMessageDecodeResult<ServiceMessage>>;
+  dispose(): void;
 }
 
-// Shared worker state (singleton pattern)
+// 공유 worker 상태 (싱글턴 패턴)
 let worker: Worker | undefined;
 const workerResolvers = new LazyGcMap<
   string,
   { resolve: (res: unknown) => void; reject: (err: Error) => void }
 >({
-  gcInterval: 5 * 1000, // Check for expired entries every 5s
-  expireTime: 60 * 1000, // Expire after 60s (timeout)
+  gcInterval: 5 * 1000, // 5초마다 만료된 항목 확인
+  expireTime: 60 * 1000, // 60초 후 만료 (타임아웃)
   onExpire: (key, item) => {
-    // Reject on expiry (critical for preventing memory leaks)
-    item.reject(new Error(`Worker task timed out (uuid: ${key})`));
+    // 만료 시 reject (메모리 누수 방지에 필수)
+    item.reject(new Error(`Worker 작업 시간 초과 (uuid: ${key})`));
   },
 });
 
@@ -40,8 +41,8 @@ function getWorker(): Worker | undefined {
   }
 
   if (!worker) {
-    // Modern bundlers (Vite/Esbuild/Webpack) use this syntax to split/load the Worker as a separate file
-    // Note: use relative path instead of import.meta.resolve (Vite compatibility)
+    // 모던 번들러 (Vite/Esbuild/Webpack)가 이 구문을 사용하여 Worker를 별도 파일로 분리/로드함
+    // 참고: import.meta.resolve 대신 상대 경로 사용 (Vite 호환성)
     worker = new Worker(new URL("../workers/client-protocol.worker.ts", import.meta.url), {
       type: "module",
     });
@@ -59,7 +60,7 @@ function getWorker(): Worker | undefined {
         if (type === "success") {
           resolver.resolve(result);
         } else {
-          const err = new Error(error?.message ?? "Unknown worker error");
+          const err = new Error(error?.message ?? "알 수 없는 worker 에러");
           err.stack = error?.stack;
           resolver.reject(err);
         }
@@ -71,8 +72,8 @@ function getWorker(): Worker | undefined {
 }
 
 /**
- * Delegate work to Worker and await result
- * Note: only call when workerAvailable is true
+ * Worker에 작업을 위임하고 결과를 대기
+ * 참고: workerAvailable이 true일 때만 호출할 것
  */
 async function runWorker(
   type: "encode" | "decode",
@@ -83,20 +84,20 @@ async function runWorker(
     const id = Uuid.generate().toString();
 
     workerResolvers.set(id, { resolve, reject });
-    // Called after workerAvailable check, so worker always exists
+    // workerAvailable 확인 후 호출되므로 worker는 항상 존재
     getWorker()!.postMessage({ id, type, data }, { transfer: transferables });
   });
 }
 
 export function createClientProtocolWrapper(protocol: ServiceProtocol): ClientProtocolWrapper {
-  // Threshold: 30KB
+  // 임계값: 30KB
   const SIZE_THRESHOLD = 30 * 1024;
 
   function shouldUseWorkerForEncode(msg: ServiceMessage): boolean {
     if (!("body" in msg)) return false;
     const body = msg.body;
 
-    // Use worker if Uint8Array is present or array length is large
+    // Uint8Array가 있거나 배열 길이가 큰 경우 worker 사용
     if (body instanceof Uint8Array) return true;
     if (typeof body === "string" && body.length > SIZE_THRESHOLD) return true;
     if (Array.isArray(body)) {
@@ -110,14 +111,14 @@ export function createClientProtocolWrapper(protocol: ServiceProtocol): ClientPr
     uuid: string,
     message: ServiceMessage,
   ): Promise<{ chunks: Bytes[]; totalSize: number }> {
-    // Process on main thread if no Worker or small data
+    // Worker가 없거나 데이터가 작으면 메인 스레드에서 처리
     if (!isWorkerAvailable() || !shouldUseWorkerForEncode(message)) {
       return protocol.encode(uuid, message);
     }
 
     // [Worker]
-    // Encode requires sending an object, so Structured Clone occurs.
-    // But the benefit of offloading JSON.stringify cost from the main thread is greater.
+    // 인코딩은 객체 전송이 필요하므로 Structured Clone이 발생함.
+    // 하지만 메인 스레드에서 JSON.stringify 비용을 오프로드하는 이점이 더 큼.
     return (await runWorker("encode", { uuid, message })) as {
       chunks: Bytes[];
       totalSize: number;
@@ -127,21 +128,25 @@ export function createClientProtocolWrapper(protocol: ServiceProtocol): ClientPr
   async function decode(bytes: Bytes): Promise<ServiceMessageDecodeResult<ServiceMessage>> {
     const totalSize = bytes.length;
 
-    // Process on main thread if no Worker or small data
+    // Worker가 없거나 데이터가 작으면 메인 스레드에서 처리
     if (!isWorkerAvailable() || totalSize <= SIZE_THRESHOLD) {
       return protocol.decode(bytes);
     }
 
     // [Worker]
-    // Zero-copy transfer (buffer ownership moves to Worker)
+    // Zero-copy 전송 (버퍼 소유권이 Worker로 이동)
     const rawResult = await runWorker("decode", bytes, [bytes.buffer]);
 
-    // Restore class instances (DateTime, etc.) from Worker's plain object result
+    // Worker의 plain object 결과에서 클래스 인스턴스 복원 (DateTime 등)
     return transfer.decode(rawResult) as ServiceMessageDecodeResult<ServiceMessage>;
   }
 
   return {
     encode,
     decode,
+    dispose() {
+      protocol.dispose();
+      workerResolvers.dispose();
+    },
   };
 }