@simplysm/service-client 13.0.100 → 14.0.4

package/dist/types/browser-compat.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Cross-environment compatible types for browser globals.
+ * DOM-only 타입(FileList, BlobPart, Worker, Transferable)을 대체하여
+ * Node.js / browser 양쪽 환경에서 typecheck가 통과하도록 한다.
+ */
+/** Blob constructor가 허용하는 데이터 타입 (DOM BlobPart 대체) */
+export type BlobInput = Blob | Uint8Array<ArrayBuffer> | ArrayBuffer | string;
+/**
+ * File 컬렉션 인터페이스 (DOM FileList 대체).
+ * 브라우저 FileList와 구조적으로 호환됨.
+ */
+export interface FileCollection {
+    readonly length: number;
+    item(index: number): File | null;
+    [index: number]: File;
+    [Symbol.iterator](): IterableIterator<File>;
+}
+/**
+ * Web Worker 인터페이스 (DOM Worker 대체).
+ * 브라우저 Worker와 구조적으로 호환됨.
+ */
+export interface WorkerLike {
+    onmessage: ((ev: MessageEvent) => void) | null;
+    postMessage(message: unknown, transfer?: unknown[]): void;
+    terminate(): void;
+}
+/** Web Worker API 지원 여부 확인 */
+export declare function isWorkerSupported(): boolean;
+/** Web Worker 생성 (미지원 환경이면 undefined) */
+export declare function createBrowserWorker(url: URL, options: {
+    type: string;
+}): WorkerLike | undefined;
+//# sourceMappingURL=browser-compat.d.ts.map

package/dist/types/browser-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-compat.d.ts","sourceRoot":"","sources":["..\\..\\src\\types\\browser-compat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/C,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC1D,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,8BAA8B;AAC9B,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,yCAAyC;AACzC,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GACxB,UAAU,GAAG,SAAS,CAOxB"}

package/dist/types/browser-compat.js

@@ -0,0 +1,17 @@
+/**
+ * Cross-environment compatible types for browser globals.
+ * DOM-only 타입(FileList, BlobPart, Worker, Transferable)을 대체하여
+ * Node.js / browser 양쪽 환경에서 typecheck가 통과하도록 한다.
+ */
+/** Web Worker API 지원 여부 확인 */
+export function isWorkerSupported() {
+    return "Worker" in globalThis;
+}
+/** Web Worker 생성 (미지원 환경이면 undefined) */
+export function createBrowserWorker(url, options) {
+    if (!isWorkerSupported())
+        return undefined;
+    const ctor = globalThis["Worker"];
+    return new ctor(url, options);
+}
+//# sourceMappingURL=browser-compat.js.map

package/dist/types/browser-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-compat.js","sourceRoot":"","sources":["..\\..\\src\\types\\browser-compat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,8BAA8B;AAC9B,MAAM,UAAU,iBAAiB;IAC/B,OAAO,QAAQ,IAAI,UAAU,CAAC;AAChC,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,mBAAmB,CACjC,GAAQ,EACR,OAAyB;IAEzB,IAAI,CAAC,iBAAiB,EAAE;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,IAAI,GAAI,UAAsC,CAAC,QAAQ,CAG9C,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAChC,CAAC"}

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 }, 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,YAAY,CAAC,CAAC;IAClE,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.100",
-  "description": "Simplysm package - Service module (client)",
-  "author": "simplysm",
+  "version": "14.0.4",
+  "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.100",
-    "@simplysm/orm-common": "13.0.100",
-    "@simplysm/service-common": "13.0.100"
+    "@simplysm/core-common": "14.0.4",
+    "@simplysm/orm-common": "14.0.4",
+    "@simplysm/service-common": "14.0.4"
   },
   "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

@@ -1,22 +1,23 @@
 import type { Bytes } from "@simplysm/core-common";
 import type { ServiceUploadResult } from "@simplysm/service-common";
+import type { BlobInput, FileCollection } from "../types/browser-compat";
 
 export interface FileClient {
   download(relPath: string): Promise<Bytes>;
   upload(
-    files: File[] | FileList | { name: string; data: BlobPart }[],
+    files: File[] | FileCollection | { name: string; data: BlobInput }[],
     authToken: string,
   ): Promise<ServiceUploadResult[]>;
 }
 
 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
@@ -24,19 +25,19 @@ export function createFileClient(hostUrl: string, clientName: string): FileClien
   }
 
   async function upload(
-    files: File[] | FileList | { name: string; data: BlobPart }[],
+    files: File[] | FileCollection | { name: string; data: BlobInput }[],
     authToken: string,
   ): Promise<ServiceUploadResult[]> {
     const formData = new FormData();
-    const fileList = files instanceof FileList ? Array.from(files) : files;
+    const fileArr = Array.isArray(files) ? files : Array.from(files);
 
-    for (const file of fileList) {
+    for (const file of fileArr) {
       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,10 +52,10 @@ 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();
+    return (await res.json()) as ServiceUploadResult[];
   }
 
   return {

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,21 @@
-// Types
+// 타입
+export * from "./types/browser-compat";
 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";