@simplysm/service-client 13.0.0-beta.6

package/dist/service-common/src/service-types/smtp-service.types.d.ts

@@ -0,0 +1,55 @@
+import type { Bytes } from "@simplysm/core-common";
+/**
+ * SMTP 서비스 인터페이스
+ *
+ * 이메일 전송 기능을 제공한다.
+ * 직접 SMTP 설정을 전달하거나 서버 설정을 참조하여 전송할 수 있다.
+ */
+export interface SmtpService {
+    /** 직접 SMTP 설정으로 이메일 전송 */
+    send(options: SmtpSendOption): Promise<string>;
+    /** 서버 설정 참조로 이메일 전송 */
+    sendByConfig(configName: string, options: SmtpSendByConfigOption): Promise<string>;
+}
+/**
+ * 이메일 첨부 파일 정보
+ *
+ * content 또는 path 중 하나를 지정해야 한다.
+ */
+export interface SmtpSendAttachment {
+    /** 첨부 파일명 */
+    filename: string;
+    /** 파일 내용 (바이너리) */
+    content?: Bytes;
+    /** 서버 내 파일 경로 */
+    path?: string;
+    /** MIME 타입 (예: "application/pdf") */
+    contentType?: string;
+}
+/** SMTP 연결 옵션 (공통) */
+export interface SmtpConnectionOptions {
+    host: string;
+    port?: number;
+    secure?: boolean;
+    user?: string;
+    pass?: string;
+}
+/** 이메일 내용 옵션 (공통) */
+export interface SmtpEmailContentOptions {
+    to: string;
+    cc?: string;
+    bcc?: string;
+    subject: string;
+    html: string;
+    attachments?: SmtpSendAttachment[];
+}
+export interface SmtpSendByConfigOption extends SmtpEmailContentOptions {
+}
+export interface SmtpSendOption extends SmtpConnectionOptions, SmtpEmailContentOptions {
+    from: string;
+}
+export interface SmtpConfig extends SmtpConnectionOptions {
+    senderName: string;
+    senderEmail?: string;
+}
+//# sourceMappingURL=smtp-service.types.d.ts.map

package/dist/service-common/src/service-types/smtp-service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp-service.types.d.ts","sourceRoot":"","sources":["../../../../../service-common/src/service-types/smtp-service.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,uBAAuB;IACvB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpF;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sBAAsB;AACtB,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAqB;AACrB,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;CAAG;AAE1E,MAAM,WAAW,cAAe,SAAQ,qBAAqB,EAAE,uBAAuB;IACpF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAW,SAAQ,qBAAqB;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/service-common/src/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 이벤트 리스너 타입 정의용 추상 클래스
+ *
+ * - 상속만 하면 됨 (프로퍼티 구현 불필요)
+ * - $info, $data는 타입 추출용 (런타임 미사용)
+ * - eventName은 mangle 안전한 이벤트 식별자
+ *
+ * @example
+ * export class SharedDataChangeEvent extends ServiceEventListener<
+ *   { name: string; filter: unknown },
+ *   (string | number)[] | undefined
+ * > {
+ *   readonly eventName = "SharedDataChangeEvent";
+ * }
+ *
+ * // 클라이언트에서 사용
+ * await client.addEventListener(
+ *   SharedDataChangeEvent,
+ *   { name: "test", filter: null },
+ *   (data) => console.log(data)
+ * );
+ */
+export declare abstract class ServiceEventListener<TInfo, TData> {
+    /** mangle 안전한 이벤트 식별자 (상속 시 필수 구현) */
+    abstract readonly eventName: string;
+    /** 타입 추출용 (런타임 미사용) */
+    readonly $info: TInfo;
+    readonly $data: TData;
+}
+/**
+ * 파일 업로드 결과
+ *
+ * 서버에 업로드된 파일의 정보를 담는다.
+ */
+export interface ServiceUploadResult {
+    /** 서버 내 저장 경로 */
+    path: string;
+    /** 원본 파일명 */
+    filename: string;
+    /** 파일 크기 (bytes) */
+    size: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/service-common/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../service-common/src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8BAAsB,oBAAoB,CAAC,KAAK,EAAE,KAAK;IACrD,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAEpC,uBAAuB;IACvB,SAAiB,KAAK,EAAE,KAAK,CAAC;IAC9B,SAAiB,KAAK,EAAE,KAAK,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/transport/service-transport.js

@@ -0,0 +1,112 @@
+import { EventEmitter, Uuid } from "@simplysm/core-common";
+import { ClientProtocolWrapper } from "../protocol/client-protocol-wrapper";
+class ServiceTransport extends EventEmitter {
+  constructor(_socket) {
+    super();
+    this._socket = _socket;
+    this._socket.on("message", this._onMessage.bind(this));
+    this._socket.on("state", (state) => {
+      if (state === "closed" || state === "reconnecting") {
+        this._cancelAllRequests("Socket connection lost");
+      }
+    });
+  }
+  _protocol = new ClientProtocolWrapper();
+  _pendingRequests = /* @__PURE__ */ new Map();
+  // 응답 progress의 totalSize 저장 (complete 시 100% emit용)
+  _responseProgressTotalSize = /* @__PURE__ */ new Map();
+  async send(message, progress) {
+    var _a, _b;
+    const uuid = Uuid.new().toString();
+    const responsePromise = new Promise((resolve, reject) => {
+      this._pendingRequests.set(uuid, { resolve, reject, progress });
+    });
+    try {
+      const { chunks, totalSize } = await this._protocol.encode(uuid, message);
+      if (chunks.length > 1) {
+        (_a = progress == null ? void 0 : progress.request) == null ? void 0 : _a.call(progress, {
+          uuid,
+          totalSize,
+          completedSize: 0
+        });
+      }
+      for (const chunk of chunks) {
+        await this._socket.send(chunk);
+      }
+    } catch (err) {
+      (_b = this._pendingRequests.get(uuid)) == null ? void 0 : _b.reject(err);
+      this._pendingRequests.delete(uuid);
+      throw err;
+    }
+    return responsePromise;
+  }
+  async _onMessage(buf) {
+    var _a, _b, _c, _d, _e, _f;
+    const decoded = await this._protocol.decode(buf);
+    const listenerInfo = this._pendingRequests.get(decoded.uuid);
+    try {
+      if (decoded.type === "progress") {
+        this._responseProgressTotalSize.set(decoded.uuid, decoded.totalSize);
+        (_b = (_a = listenerInfo == null ? void 0 : listenerInfo.progress) == null ? void 0 : _a.response) == null ? void 0 : _b.call(_a, {
+          uuid: decoded.uuid,
+          totalSize: decoded.totalSize,
+          completedSize: decoded.completedSize
+        });
+      } else {
+        if (decoded.message.name === "progress") {
+          const body = decoded.message.body;
+          (_d = (_c = listenerInfo == null ? void 0 : listenerInfo.progress) == null ? void 0 : _c.request) == null ? void 0 : _d.call(_c, {
+            uuid: decoded.uuid,
+            totalSize: body.totalSize,
+            completedSize: body.completedSize
+          });
+        } else if (decoded.message.name === "response") {
+          const totalSize = this._responseProgressTotalSize.get(decoded.uuid);
+          if (totalSize != null) {
+            this._responseProgressTotalSize.delete(decoded.uuid);
+            (_f = (_e = listenerInfo == null ? void 0 : listenerInfo.progress) == null ? void 0 : _e.response) == null ? void 0 : _f.call(_e, {
+              uuid: decoded.uuid,
+              totalSize,
+              completedSize: totalSize
+            });
+          }
+          this._pendingRequests.delete(decoded.uuid);
+          listenerInfo == null ? void 0 : listenerInfo.resolve(decoded.message.body);
+        } else if (decoded.message.name === "error") {
+          this._responseProgressTotalSize.delete(decoded.uuid);
+          this._pendingRequests.delete(decoded.uuid);
+          listenerInfo == null ? void 0 : listenerInfo.reject(this._toError(decoded.message.body));
+        } else if (decoded.message.name === "reload") {
+          const body = decoded.message.body;
+          if (this._socket.clientName === body.clientName) {
+            this.emit("reload", body.changedFileSet);
+          }
+        } else if (decoded.message.name === "evt:on") {
+          const body = decoded.message.body;
+          this.emit("event", { keys: body.keys, data: body.data });
+        } else {
+          throw new Error("\uC694\uCCAD\uC774 \uC798 \uBABB \uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
+        }
+      }
+    } catch (err) {
+      listenerInfo == null ? void 0 : listenerInfo.reject(err instanceof Error ? err : new Error(String(err)));
+    }
+  }
+  // 모든 대기 요청 취소 처리
+  _cancelAllRequests(reason) {
+    for (const listenerInfo of this._pendingRequests.values()) {
+      listenerInfo.reject(new Error(`Request canceled: ${reason}`));
+    }
+    this._pendingRequests.clear();
+    this._responseProgressTotalSize.clear();
+  }
+  _toError(body) {
+    let err = new Error(body.message);
+    err = Object.assign(err, body);
+    return err;
+  }
+}
+export {
+  ServiceTransport
+};
+//# sourceMappingURL=service-transport.js.map

package/dist/transport/service-transport.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/transport/service-transport.ts"],
+  "sourcesContent": ["import type { Bytes } from \"@simplysm/core-common\";\nimport { EventEmitter, Uuid } from \"@simplysm/core-common\";\nimport type { ServiceErrorMessage, ServiceResponseMessage, ServiceClientMessage } from \"@simplysm/service-common\";\nimport { ClientProtocolWrapper } from \"../protocol/client-protocol-wrapper\";\nimport type { ServiceProgress } from \"../types/progress.types\";\nimport type { SocketProvider } from \"./socket-provider\";\n\ninterface ServiceTransportEvents {\n  reload: Set<string>;\n  event: { keys: string[]; data: unknown };\n}\n\nexport class ServiceTransport extends EventEmitter<ServiceTransportEvents> {\n  private readonly _protocol = new ClientProtocolWrapper();\n\n  private readonly _pendingRequests = new Map<\n    string,\n    {\n      resolve: (msg: ServiceResponseMessage) => void;\n      reject: (err: Error) => void;\n      progress?: ServiceProgress;\n    }\n  >();\n\n  // \uC751\uB2F5 progress\uC758 totalSize \uC800\uC7A5 (complete \uC2DC 100% emit\uC6A9)\n  private readonly _responseProgressTotalSize = new Map<string, number>();\n\n  constructor(private readonly _socket: SocketProvider) {\n    super();\n\n    this._socket.on(\"message\", this._onMessage.bind(this));\n\n    // \uC18C\uCF13\uC774 \uB04A\uAE30\uBA74 \uB300\uAE30 \uC911\uC778 \uBAA8\uB4E0 \uC694\uCCAD\uC744 \uC5D0\uB7EC \uCC98\uB9AC\uD558\uC5EC \uBA54\uBAA8\uB9AC \uD574\uC81C\n    this._socket.on(\"state\", (state) => {\n      if (state === \"closed\" || state === \"reconnecting\") {\n        this._cancelAllRequests(\"Socket connection lost\");\n      }\n    });\n  }\n\n  async send(message: ServiceClientMessage, progress?: ServiceProgress): Promise<unknown> {\n    const uuid = Uuid.new().toString();\n\n    // \uC751\uB2F5 \uB300\uAE30 \uC2DC\uC791 (\uC694\uCCAD \uBCF4\uB0B4\uAE30 \uC804\uC5D0 \uB9AC\uC2A4\uB108\uB97C \uBA3C\uC800 \uB4F1\uB85D\uD574\uC57C \uC548\uC804\uD568)\n    const responsePromise = new Promise((resolve, reject) => {\n      this._pendingRequests.set(uuid, { resolve, reject, progress });\n    });\n\n    // \uC694\uCCAD \uC804\uC1A1\n    try {\n      const { chunks, totalSize } = await this._protocol.encode(uuid, message);\n\n      // \uC9C4\uD589\uB960 \uCD08\uAE30\uD654\n      if (chunks.length > 1) {\n        progress?.request?.({\n          uuid,\n          totalSize,\n          completedSize: 0,\n        });\n      }\n\n      // \uC804\uC1A1\n      for (const chunk of chunks) {\n        await this._socket.send(chunk);\n      }\n    } catch (err) {\n      // \uC804\uC1A1 \uC2E4\uD328 \uC2DC \uC989\uC2DC \uC815\uB9AC\n      this._pendingRequests.get(uuid)?.reject(err as Error);\n      this._pendingRequests.delete(uuid);\n      throw err;\n    }\n\n    // \uC751\uB2F5 \uACB0\uACFC \uBC18\uD658\n    return responsePromise;\n  }\n\n  private async _onMessage(buf: Bytes): Promise<void> {\n    const decoded = await this._protocol.decode(buf);\n\n    const listenerInfo = this._pendingRequests.get(decoded.uuid);\n\n    try {\n      if (decoded.type === \"progress\") {\n        // totalSize \uAE30\uC5B5 (complete \uC2DC 100% emit\uC6A9)\n        this._responseProgressTotalSize.set(decoded.uuid, decoded.totalSize);\n\n        listenerInfo?.progress?.response?.({\n          uuid: decoded.uuid,\n          totalSize: decoded.totalSize,\n          completedSize: decoded.completedSize,\n        });\n      } else {\n        if (decoded.message.name === \"progress\") {\n          const body = decoded.message.body as { totalSize: number; completedSize: number };\n          listenerInfo?.progress?.request?.({\n            uuid: decoded.uuid,\n            totalSize: body.totalSize,\n            completedSize: body.completedSize,\n          });\n        } else if (decoded.message.name === \"response\") {\n          // split\uB41C \uBA54\uC2DC\uC9C0\uC600\uC73C\uBA74 100% progress emit\n          const totalSize = this._responseProgressTotalSize.get(decoded.uuid);\n          if (totalSize != null) {\n            this._responseProgressTotalSize.delete(decoded.uuid);\n            listenerInfo?.progress?.response?.({\n              uuid: decoded.uuid,\n              totalSize,\n              completedSize: totalSize,\n            });\n          }\n\n          // \uC751\uB2F5\uC744 \uBC1B\uC558\uC73C\uBBC0\uB85C Map\uC5D0\uC11C \uC81C\uAC70\n          this._pendingRequests.delete(decoded.uuid);\n\n          listenerInfo?.resolve(decoded.message.body as ServiceResponseMessage);\n        } else if (decoded.message.name === \"error\") {\n          // progress totalSize \uC815\uB9AC\n          this._responseProgressTotalSize.delete(decoded.uuid);\n\n          // \uC5D0\uB7EC\uB97C \uBC1B\uC558\uC73C\uBBC0\uB85C Map\uC5D0\uC11C \uC81C\uAC70\n          this._pendingRequests.delete(decoded.uuid);\n\n          listenerInfo?.reject(this._toError(decoded.message.body));\n        } else if (decoded.message.name === \"reload\") {\n          const body = decoded.message.body as { clientName: string; changedFileSet: Set<string> };\n          if (this._socket.clientName === body.clientName) {\n            this.emit(\"reload\", body.changedFileSet);\n          }\n        } else if (decoded.message.name === \"evt:on\") {\n          const body = decoded.message.body as { keys: string[]; data: unknown };\n          this.emit(\"event\", { keys: body.keys, data: body.data });\n        } else {\n          throw new Error(\"\uC694\uCCAD\uC774 \uC798 \uBABB \uB418\uC5C8\uC2B5\uB2C8\uB2E4.\");\n        }\n      }\n    } catch (err) {\n      listenerInfo?.reject(err instanceof Error ? err : new Error(String(err)));\n    }\n  }\n\n  // \uBAA8\uB4E0 \uB300\uAE30 \uC694\uCCAD \uCDE8\uC18C \uCC98\uB9AC\n  private _cancelAllRequests(reason: string): void {\n    for (const listenerInfo of this._pendingRequests.values()) {\n      listenerInfo.reject(new Error(`Request canceled: ${reason}`));\n    }\n    this._pendingRequests.clear();\n    this._responseProgressTotalSize.clear();\n  }\n\n  private _toError(body: ServiceErrorMessage[\"body\"]): Error {\n    let err = new Error(body.message);\n    err = Object.assign(err, body);\n    return err;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/transport/socket-provider.js

@@ -0,0 +1,170 @@
+import { EventEmitter, Uuid, waitUntil, waitTime } from "@simplysm/core-common";
+import { createConsola } from "consola";
+const logger = createConsola().withTag("service-client:SocketProvider");
+class SocketProvider extends EventEmitter {
+  constructor(_url, clientName, _maxReconnectCount) {
+    super();
+    this._url = _url;
+    this.clientName = clientName;
+    this._maxReconnectCount = _maxReconnectCount;
+  }
+  // 설정상수
+  _HEARTBEAT_TIMEOUT = 3e4;
+  // 30초간 아무런 메시지가 없으면 끊김으로 간주
+  _HEARTBEAT_INTERVAL = 5e3;
+  // 5초마다 핑 전송
+  _RECONNECT_DELAY = 3e3;
+  // 3초마다 재연결 시도
+  // 1바이트 버퍼 미리 생성 (메모리 절약)
+  _PING_PACKET = new Uint8Array([1]);
+  // 상태
+  _ws;
+  _isManualClose = false;
+  _reconnectCount = 0;
+  _heartbeatTimer;
+  _lastHeartbeatTime = Date.now();
+  get connected() {
+    var _a;
+    return ((_a = this._ws) == null ? void 0 : _a.readyState) === WebSocket.OPEN;
+  }
+  async connect() {
+    if (this.connected) return;
+    this._isManualClose = false;
+    try {
+      await this._createSocket();
+      this._startHeartbeat();
+      this._reconnectCount = 0;
+      this.emit("state", "connected");
+    } catch (err) {
+      throw err;
+    }
+  }
+  async close() {
+    this._isManualClose = true;
+    this._stopHeartbeat();
+    const ws = this._ws;
+    if (ws != null) {
+      ws.close();
+      await waitUntil(() => ws.readyState === WebSocket.CLOSED, 100, 30).catch(() => {
+      });
+    }
+    this.emit("state", "closed");
+  }
+  async send(data) {
+    try {
+      await waitUntil(() => this.connected, void 0, 50);
+    } catch {
+      throw new Error("\uC11C\uBC84\uC640 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC778\uD130\uB137 \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uC138\uC694.");
+    }
+    const ws = this._ws;
+    if (ws == null) {
+      throw new Error("WebSocket\uC774 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
+    }
+    ws.send(data);
+  }
+  async _createSocket() {
+    const clientId = Uuid.new().toString();
+    const params = new URLSearchParams({
+      ver: "2",
+      clientId,
+      clientName: this.clientName
+    });
+    await new Promise((resolve, reject) => {
+      const ws = new WebSocket(`${this._url}?${params.toString()}`);
+      ws.binaryType = "arraybuffer";
+      ws.onopen = () => {
+        this._ws = ws;
+        resolve();
+      };
+      ws.onerror = (event) => {
+        if (!this.connected) {
+          const errorEvent = event;
+          const msg = errorEvent.message;
+          reject(new Error(msg));
+        }
+      };
+    });
+    const currentWs = this._ws;
+    if (currentWs == null) {
+      throw new Error("WebSocket \uCD08\uAE30\uD654 \uC2E4\uD328");
+    }
+    currentWs.onmessage = (event) => {
+      this._lastHeartbeatTime = Date.now();
+      const data = event.data;
+      const bytes = new Uint8Array(data);
+      if (bytes.length === 1 && bytes[0] === 2) return;
+      this.emit("message", bytes);
+    };
+    currentWs.onclose = async () => {
+      this._stopHeartbeat();
+      if (!this._isManualClose) {
+        await this._tryReconnect();
+      }
+    };
+  }
+  async _tryReconnect() {
+    while (this._reconnectCount < this._maxReconnectCount) {
+      this._reconnectCount++;
+      this.emit("state", "reconnecting");
+      logger.warn("WebSocket \uC5F0\uACB0 \uB04A\uAE40. \uC7AC\uC5F0\uACB0 \uC2DC\uB3C4...", {
+        reconnectCount: this._reconnectCount,
+        maxReconnectCount: this._maxReconnectCount
+      });
+      await waitTime(this._RECONNECT_DELAY);
+      try {
+        await this._createSocket();
+        this._startHeartbeat();
+        this._reconnectCount = 0;
+        this.emit("state", "connected");
+        logger.info("WebSocket \uC7AC\uC5F0\uACB0 \uC131\uACF5");
+        return;
+      } catch {
+      }
+    }
+    logger.error("\uC7AC\uC5F0\uACB0 \uC2DC\uB3C4 \uD69F\uC218 \uCD08\uACFC. \uC5F0\uACB0\uC744 \uD3EC\uAE30\uD569\uB2C8\uB2E4.");
+    this.emit("state", "closed");
+  }
+  _startHeartbeat() {
+    this._stopHeartbeat();
+    this._lastHeartbeatTime = Date.now();
+    this._heartbeatTimer = setInterval(() => {
+      if (Date.now() - this._lastHeartbeatTime > this._HEARTBEAT_TIMEOUT) {
+        logger.warn("Heartbeat Timeout. Connection lost.");
+        this._stopHeartbeat();
+        if (this._ws != null) {
+          const tempWs = this._ws;
+          this._ws = void 0;
+          tempWs.onclose = null;
+          tempWs.onerror = null;
+          tempWs.onmessage = null;
+          try {
+            tempWs.close();
+          } catch {
+          }
+          if (!this._isManualClose) {
+            void this._tryReconnect();
+          }
+        }
+        return;
+      }
+      const ws = this._ws;
+      if (this.connected && ws != null) {
+        try {
+          ws.send(this._PING_PACKET);
+        } catch (err) {
+          logger.warn("Ping send failed", err);
+        }
+      }
+    }, this._HEARTBEAT_INTERVAL);
+  }
+  _stopHeartbeat() {
+    if (this._heartbeatTimer != null) {
+      clearInterval(this._heartbeatTimer);
+      this._heartbeatTimer = void 0;
+    }
+  }
+}
+export {
+  SocketProvider
+};
+//# sourceMappingURL=socket-provider.js.map

package/dist/transport/socket-provider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/transport/socket-provider.ts"],
+  "sourcesContent": ["import type { Bytes } from \"@simplysm/core-common\";\nimport { EventEmitter, Uuid, waitUntil, waitTime } from \"@simplysm/core-common\";\nimport { createConsola } from \"consola\";\n\nconst logger = createConsola().withTag(\"service-client:SocketProvider\");\n\ninterface SocketProviderEvents {\n  message: Bytes;\n  state: \"connected\" | \"closed\" | \"reconnecting\";\n}\n\nexport class SocketProvider extends EventEmitter<SocketProviderEvents> {\n  // \uC124\uC815\uC0C1\uC218\n  private readonly _HEARTBEAT_TIMEOUT = 30000; // 30\uCD08\uAC04 \uC544\uBB34\uB7F0 \uBA54\uC2DC\uC9C0\uAC00 \uC5C6\uC73C\uBA74 \uB04A\uAE40\uC73C\uB85C \uAC04\uC8FC\n  private readonly _HEARTBEAT_INTERVAL = 5000; // 5\uCD08\uB9C8\uB2E4 \uD551 \uC804\uC1A1\n  private readonly _RECONNECT_DELAY = 3000; // 3\uCD08\uB9C8\uB2E4 \uC7AC\uC5F0\uACB0 \uC2DC\uB3C4\n\n  // 1\uBC14\uC774\uD2B8 \uBC84\uD37C \uBBF8\uB9AC \uC0DD\uC131 (\uBA54\uBAA8\uB9AC \uC808\uC57D)\n  private readonly _PING_PACKET = new Uint8Array([0x01]);\n\n  // \uC0C1\uD0DC\n  private _ws?: WebSocket;\n  private _isManualClose = false;\n  private _reconnectCount = 0;\n  private _heartbeatTimer?: ReturnType<typeof setInterval>;\n  private _lastHeartbeatTime = Date.now();\n\n  get connected(): boolean {\n    return this._ws?.readyState === WebSocket.OPEN;\n  }\n\n  constructor(\n    private readonly _url: string,\n    public readonly clientName: string,\n    private readonly _maxReconnectCount: number,\n  ) {\n    super();\n  }\n\n  async connect(): Promise<void> {\n    if (this.connected) return;\n    this._isManualClose = false;\n\n    try {\n      await this._createSocket();\n      this._startHeartbeat();\n      this._reconnectCount = 0; // \uC5F0\uACB0 \uC131\uACF5 \uC2DC \uCE74\uC6B4\uD2B8 \uCD08\uAE30\uD654\n      this.emit(\"state\", \"connected\");\n    } catch (err) {\n      // \uCD5C\uCD08 \uC5F0\uACB0 \uC2E4\uD328\uB294 \uC5D0\uB7EC\uB97C \uB358\uC9D0 (\uD638\uCD9C\uC790\uAC00 \uC54C \uC218 \uC788\uAC8C)\n      throw err;\n    }\n  }\n\n  async close(): Promise<void> {\n    this._isManualClose = true;\n    this._stopHeartbeat();\n    const ws = this._ws;\n    if (ws != null) {\n      ws.close();\n      // \uC644\uC804\uD788 \uB2EB\uD790 \uB54C\uAE4C\uC9C0 \uB300\uAE30 (Graceful Shutdown)\n      await waitUntil(() => ws.readyState === WebSocket.CLOSED, 100, 30).catch(() => {});\n    }\n    this.emit(\"state\", \"closed\");\n  }\n\n  async send(data: Bytes): Promise<void> {\n    try {\n      await waitUntil(() => this.connected, undefined, 50);\n    } catch {\n      throw new Error(\"\uC11C\uBC84\uC640 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC778\uD130\uB137 \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uC138\uC694.\");\n    }\n    const ws = this._ws;\n    if (ws == null) {\n      throw new Error(\"WebSocket\uC774 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.\");\n    }\n    ws.send(data);\n  }\n\n  private async _createSocket(): Promise<void> {\n    const clientId = Uuid.new().toString();\n    const params = new URLSearchParams({\n      ver: \"2\",\n      clientId,\n      clientName: this.clientName,\n    });\n\n    await new Promise<void>((resolve, reject) => {\n      const ws = new WebSocket(`${this._url}?${params.toString()}`);\n      ws.binaryType = \"arraybuffer\";\n\n      ws.onopen = () => {\n        this._ws = ws;\n        resolve();\n      };\n\n      ws.onerror = (event: Event) => {\n        // \uC5F0\uACB0 \uC911 \uC5D0\uB7EC \uBC1C\uC0DD \uC2DC reject\n        if (!this.connected) {\n          const errorEvent = event as ErrorEvent;\n          const msg = errorEvent.message;\n          reject(new Error(msg));\n        }\n      };\n    });\n\n    // \uC774 \uC2DC\uC810\uC5D0\uC11C this._ws\uB294 \uD56D\uC0C1 \uD560\uB2F9\uB418\uC5B4 \uC788\uC74C (ws.onopen\uC5D0\uC11C \uD560\uB2F9)\n    const currentWs = this._ws;\n    if (currentWs == null) {\n      throw new Error(\"WebSocket \uCD08\uAE30\uD654 \uC2E4\uD328\");\n    }\n\n    currentWs.onmessage = (event) => {\n      this._lastHeartbeatTime = Date.now(); // \uD558\uD2B8\uBE44\uD2B8 \uAC31\uC2E0\n\n      const data = event.data as ArrayBuffer;\n      const bytes = new Uint8Array(data);\n\n      // Raw Ping/Pong \uCC98\uB9AC (\uAC00\uC7A5 \uBA3C\uC800 \uCCB4\uD06C)\n      // 1\uBC14\uC774\uD2B8\uC774\uACE0 \uCCAB \uBC14\uC774\uD2B8\uAC00 0x02(Pong)\uC774\uBA74 \uBB34\uC2DC\n      // (\uD558\uD2B8\uBE44\uD2B8 \uD0C0\uC784\uC2A4\uD0EC\uD504\uB9CC \uAC31\uC2E0\uD558\uACE0 \uB05D\uB0C4)\n      if (bytes.length === 1 && bytes[0] === 0x02) return;\n\n      this.emit(\"message\", bytes);\n    };\n\n    currentWs.onclose = async () => {\n      this._stopHeartbeat();\n      if (!this._isManualClose) {\n        await this._tryReconnect();\n      }\n    };\n  }\n\n  private async _tryReconnect(): Promise<void> {\n    // \uB8E8\uD504 \uAE30\uBC18 \uC7AC\uC5F0\uACB0 (\uC7AC\uADC0 \uB300\uC2E0 \uC0AC\uC6A9\uD558\uC5EC \uC2A4\uD0DD \uC548\uC804\uC131 \uD655\uBCF4)\n    while (this._reconnectCount < this._maxReconnectCount) {\n      this._reconnectCount++;\n      this.emit(\"state\", \"reconnecting\");\n      logger.warn(\"WebSocket \uC5F0\uACB0 \uB04A\uAE40. \uC7AC\uC5F0\uACB0 \uC2DC\uB3C4...\", {\n        reconnectCount: this._reconnectCount,\n        maxReconnectCount: this._maxReconnectCount,\n      });\n\n      await waitTime(this._RECONNECT_DELAY);\n\n      try {\n        await this._createSocket();\n        this._startHeartbeat();\n        this._reconnectCount = 0;\n        this.emit(\"state\", \"connected\"); // \uC7AC\uC5F0\uACB0 \uC131\uACF5 \uC54C\uB9BC\n        logger.info(\"WebSocket \uC7AC\uC5F0\uACB0 \uC131\uACF5\");\n        return; // \uC7AC\uC5F0\uACB0 \uC131\uACF5 \uC2DC \uC885\uB8CC\n      } catch {\n        // \uC2E4\uD328 \uC2DC \uB8E8\uD504 \uACC4\uC18D\n      }\n    }\n\n    // \uCD5C\uB300 \uC7AC\uC2DC\uB3C4 \uD69F\uC218 \uCD08\uACFC\n    logger.error(\"\uC7AC\uC5F0\uACB0 \uC2DC\uB3C4 \uD69F\uC218 \uCD08\uACFC. \uC5F0\uACB0\uC744 \uD3EC\uAE30\uD569\uB2C8\uB2E4.\");\n    this.emit(\"state\", \"closed\");\n  }\n\n  private _startHeartbeat(): void {\n    this._stopHeartbeat();\n    this._lastHeartbeatTime = Date.now();\n\n    this._heartbeatTimer = setInterval(() => {\n      // \uD0C0\uC784\uC544\uC6C3 \uCCB4\uD06C\n      if (Date.now() - this._lastHeartbeatTime > this._HEARTBEAT_TIMEOUT) {\n        logger.warn(\"Heartbeat Timeout. Connection lost.\");\n\n        // \uD0C0\uC784\uC544\uC6C3\uC774 \uBC1C\uC0DD\uD588\uC73C\uBBC0\uB85C \uC989\uC2DC \uD0C0\uC774\uBA38\uB97C \uBA48\uCDB0\uC11C \uBC18\uBCF5 \uC2E4\uD589\uC744 \uB9C9\uC2B5\uB2C8\uB2E4.\n        this._stopHeartbeat();\n\n        // \uC18C\uCF13\uC774 \uB2EB\uD788\uAE30\uB97C \uAE30\uB2E4\uB9AC\uC9C0 \uB9D0\uACE0(onclose \uBBF8\uBC1C\uC0DD \uB300\uBE44), \uAC15\uC81C\uB85C \uC815\uB9AC \uD6C4 \uC7AC\uC5F0\uACB0\uD569\uB2C8\uB2E4.\n        if (this._ws != null) {\n          const tempWs = this._ws;\n          this._ws = undefined; // \uC5F0\uACB0 \uC0C1\uD0DC \uB04A\uAE40\uC73C\uB85C \uAC04\uC8FC\n\n          // \uAE30\uC874 \uC18C\uCF13\uC758 \uC774\uBCA4\uD2B8 \uD578\uB4E4\uB7EC \uC81C\uAC70\n          // \uB4A4\uB2A6\uAC8C \uBC1C\uC0DD\uD55C onclose\uC5D0 \uB530\uB978 \uC911\uBCF5 \uC7AC\uC5F0\uACB0 \uBC29\uC9C0\n          tempWs.onclose = null;\n          tempWs.onerror = null;\n          tempWs.onmessage = null;\n\n          // \uC18C\uCF13 \uB2EB\uAE30 \uC2DC\uB3C4 (\uC5D0\uB7EC \uBB34\uC2DC)\n          try {\n            tempWs.close();\n          } catch {\n            // ignore\n          }\n\n          // \uC218\uB3D9 \uC885\uB8CC\uAC00 \uC544\uB2C8\uB77C\uBA74 \uC7AC\uC5F0\uACB0 \uB85C\uC9C1 \uAC15\uC81C \uC2E4\uD589\n          if (!this._isManualClose) {\n            void this._tryReconnect();\n          }\n        }\n        return;\n      }\n\n      // ping \uC804\uC1A1\n      const ws = this._ws;\n      if (this.connected && ws != null) {\n        try {\n          ws.send(this._PING_PACKET);\n        } catch (err) {\n          logger.warn(\"Ping send failed\", err);\n        }\n      }\n    }, this._HEARTBEAT_INTERVAL);\n  }\n\n  private _stopHeartbeat(): void {\n    if (this._heartbeatTimer != null) {\n      clearInterval(this._heartbeatTimer);\n      this._heartbeatTimer = undefined;\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/types/connection-config.js

@@ -0,0 +1 @@
+//# sourceMappingURL=connection-config.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/types/progress.types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=progress.types.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

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

@@ -0,0 +1,30 @@
+import { ServiceProtocol } from "@simplysm/service-common";
+import { transferableEncode } from "@simplysm/core-common";
+const protocol = new ServiceProtocol();
+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 = transferableEncode(decodeResult);
+      result = encoded.result;
+      transferList = encoded.transferList;
+    }
+    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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/workers/client-protocol.worker.ts"],
+  "sourcesContent": ["/// <reference lib=\"webworker\" />\n\nimport { ServiceProtocol } from \"@simplysm/service-common\";\nimport { transferableEncode } from \"@simplysm/core-common\";\n\nconst protocol = new ServiceProtocol();\n\nself.onmessage = (event: MessageEvent) => {\n  const { id, type, data } = event.data as {\n    id: string;\n    type: \"encode\" | \"decode\";\n    data: unknown;\n  };\n\n  try {\n    let result: unknown;\n    let transferList: Transferable[] = [];\n\n    if (type === \"encode\") {\n      // [Main -> Worker] \uC778\uCF54\uB529 \uC694\uCCAD (data: { uuid, message })\n      // message\uB294 \uC774\uBBF8 Plain Object\uB85C \uB118\uC5B4\uC634 (Structured Clone)\n      const { uuid, message } = data as {\n        uuid: string;\n        message: Parameters<ServiceProtocol[\"encode\"]>[1];\n      };\n      const { chunks } = protocol.encode(uuid, message);\n\n      // Buffer[]\uB294 \uC804\uC1A1 \uAC00\uB2A5\uD558\uBBC0\uB85C \uACB0\uACFC\uB85C \uBC18\uD658\n      result = chunks;\n      // \uACB0\uACFC\uBB3C \uCCAD\uD06C\uB4E4\uC758 \uB0B4\uBD80 ArrayBuffer\uB97C \uC18C\uC720\uAD8C \uC774\uC804 \uBAA9\uB85D\uC5D0 \uCD94\uAC00\n      transferList = chunks.map((chunk) => chunk.buffer as ArrayBuffer);\n    } else {\n      // [Main -> Worker] \uB514\uCF54\uB529 \uC694\uCCAD (data: Uint8Array)\n      // data\uB294 Uint8Array\uB85C \uB118\uC5B4\uC634\n      const bytes = new Uint8Array(data as ArrayBuffer);\n      const decodeResult = protocol.decode(bytes);\n\n      // \uACB0\uACFC\uBB3C(\uAC1D\uCCB4)\uC744 \uC804\uC1A1 \uAC00\uB2A5\uD55C \uD615\uD0DC\uB85C \uBCC0\uD658 (Zero-Copy \uC900\uBE44)\n      const encoded = transferableEncode(decodeResult);\n      result = encoded.result;\n      transferList = encoded.transferList;\n    }\n\n    // [Worker -> Main] \uC131\uACF5 \uC751\uB2F5\n    self.postMessage({ id, type: \"success\", result }, { transfer: transferList });\n  } catch (err) {\n    // [Worker -> Main] \uC5D0\uB7EC \uC751\uB2F5\n    self.postMessage({\n      id,\n      type: \"error\",\n      error: err instanceof Error ? { message: err.message, stack: err.stack } : { message: String(err) },\n    });\n  }\n};\n"],
+  "mappings": "AAEA,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AAEnC,MAAM,WAAW,IAAI,gBAAgB;AAErC,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,mBAAmB,YAAY;AAC/C,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,OAAO,eAAe,QAAQ,EAAE,SAAS,IAAI,SAAS,OAAO,IAAI,MAAM,IAAI,EAAE,SAAS,OAAO,GAAG,EAAE;AAAA,IACpG,CAAC;AAAA,EACH;AACF;",
+  "names": []
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@simplysm/service-client",
+  "sideEffects": false,
+  "version": "13.0.0-beta.6",
+  "description": "심플리즘 패키지 - 서비스 모듈 (client)",
+  "author": "김석래",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kslhunter/simplysm.git",
+    "directory": "packages/service-client"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@simplysm/core-common": "workspace:*",
+    "@simplysm/orm-common": "workspace:*",
+    "@simplysm/service-common": "workspace:*",
+    "consola": "^3.4.2"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1",
+    "ws": "^8.19.0"
+  }
+}

package/src/features/event-client.ts

@@ -0,0 +1,102 @@
+import type { Type } from "@simplysm/core-common";
+import { Uuid } from "@simplysm/core-common";
+import type { ServiceEventListener } from "@simplysm/service-common";
+import type { ServiceTransport } from "../transport/service-transport";
+import { createConsola } from "consola";
+
+const logger = createConsola().withTag("service-client:EventClient");
+
+export class EventClient {
+  private readonly _listenerMap = new Map<
+    string,
+    { eventName: string; info: unknown; cb: (data: unknown) => PromiseLike<void> | void }
+  >();
+
+  constructor(private readonly _transport: ServiceTransport) {
+    this._transport.on("event", async ({ keys, data }) => {
+      await this._executeByKey(keys, data);
+    });
+  }
+
+  async addListener<T extends ServiceEventListener<unknown, unknown>>(
+    eventListenerType: Type<T>,
+    info: T["$info"],
+    cb: (data: T["$data"]) => PromiseLike<void>,
+  ): Promise<string> {
+    const key = Uuid.new().toString();
+    // mangle 안전한 이벤트명 사용
+    const eventName = eventListenerType.prototype.eventName;
+
+    // 서버에 등록 요청
+    await this._transport.send({
+      name: "evt:add",
+      body: { key, name: eventName, info },
+    });
+
+    // 로컬 맵에 저장 (재연결 시 복구용)
+    this._listenerMap.set(key, {
+      eventName,
+      info,
+      cb,
+    });
+
+    return key;
+  }
+
+  async removeListener(key: string): Promise<void> {
+    await this._transport.send({ name: "evt:remove", body: { key } });
+    this._listenerMap.delete(key);
+  }
+
+  async emitToServer<T extends ServiceEventListener<unknown, unknown>>(
+    eventType: Type<T>,
+    infoSelector: (item: T["$info"]) => boolean,
+    data: T["$data"],
+  ): Promise<void> {
+    // mangle 안전한 이벤트명 사용
+    const eventName = eventType.prototype.eventName;
+
+    // 서버에 'gets' 요청을 보내 타겟을 확보
+    const listenerInfos = (await this._transport.send({
+      name: "evt:gets",
+      body: { name: eventName },
+    })) as { key: string; info: T["$info"] }[];
+
+    const targetKeys = listenerInfos.filter((item) => infoSelector(item.info)).map((item) => item.key);
+
+    if (targetKeys.length > 0) {
+      await this._transport.send({
+        name: "evt:emit",
+        body: { keys: targetKeys, data },
+      });
+    }
+  }
+
+  // 재연결 시 호출됨
+  async reRegisterAll(): Promise<void> {
+    for (const [key, value] of this._listenerMap.entries()) {
+      try {
+        await this._transport.send({
+          name: "evt:add",
+          body: { key, name: value.eventName, info: value.info },
+        });
+      } catch (err) {
+        logger.error("이벤트 리스너 복구 실패", { err, eventName: value.eventName });
+      }
+    }
+  }
+
+  // 서버에서 온 이벤트를 로컬 리스너에게 분배
+  private async _executeByKey(keys: string[], data: unknown): Promise<void> {
+    for (const key of keys) {
+      const entry = this._listenerMap.get(key);
+      if (entry != null) {
+        try {
+          await entry.cb(data);
+        } catch (err) {
+          logger.error("이벤트 핸들러 오류", { err, eventName: entry.eventName });
+        }
+      }
+    }
+  }
+}