@simplysm/service-client 13.0.0-beta.11

package/dist/service-client/src/protocol/client-protocol-wrapper.d.ts

@@ -0,0 +1,23 @@
+import type { Bytes } from "@simplysm/core-common";
+import type { ServiceMessageDecodeResult, ServiceMessage } from "@simplysm/service-common";
+export declare class ClientProtocolWrapper {
+    private readonly _SIZE_THRESHOLD;
+    private readonly _protocol;
+    private static _worker?;
+    private static readonly _workerResolvers;
+    private static _workerAvailable;
+    private static get workerAvailable();
+    private static get worker();
+    /**
+     * Worker에 작업 위임 및 결과 대기
+     * 주의: workerAvailable이 true일 때만 호출해야 함
+     */
+    private _runWorker;
+    encode(uuid: string, message: ServiceMessage): Promise<{
+        chunks: Bytes[];
+        totalSize: number;
+    }>;
+    decode(bytes: Bytes): Promise<ServiceMessageDecodeResult<ServiceMessage>>;
+    private _shouldUseWorkerForEncode;
+}
+//# sourceMappingURL=client-protocol-wrapper.d.ts.map

package/dist/service-client/src/protocol/client-protocol-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-protocol-wrapper.d.ts","sourceRoot":"","sources":["../../../../src/protocol/client-protocol-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG3F,qBAAa,qBAAqB;IAEhC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAa;IAG7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAGnD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAS;IAEhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAUrC;IAGH,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAsB;IAErD,OAAO,CAAC,MAAM,KAAK,eAAe,GAKjC;IAED,OAAO,CAAC,MAAM,KAAK,MAAM,GAkCxB;IAED;;;OAGG;YACW,UAAU;IAUlB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAe9F,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,0BAA0B,CAAC,cAAc,CAAC,CAAC;IAgB/E,OAAO,CAAC,yBAAyB;CAalC"}

package/dist/service-client/src/service-client.d.ts

@@ -0,0 +1,41 @@
+import type { Type } from "@simplysm/core-common";
+import { EventEmitter } from "@simplysm/core-common";
+import type { ServiceEventListener } from "@simplysm/service-common";
+import type { ServiceConnectionConfig } from "./types/connection-config";
+import type { ServiceProgress, ServiceProgressState } from "./types/progress.types";
+interface ServiceClientEvents {
+    "request-progress": ServiceProgressState;
+    "response-progress": ServiceProgressState;
+    "state": "connected" | "closed" | "reconnecting";
+    "reload": Set<string>;
+}
+export declare class ServiceClient extends EventEmitter<ServiceClientEvents> {
+    readonly name: string;
+    readonly options: ServiceConnectionConfig;
+    private readonly _socket;
+    private readonly _transport;
+    private readonly _eventClient;
+    private readonly _fileClient;
+    private _authToken?;
+    get connected(): boolean;
+    get hostUrl(): string;
+    constructor(name: string, options: ServiceConnectionConfig);
+    getService<T>(serviceName: string): RemoteService<T>;
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    send(serviceName: string, methodName: string, params: unknown[], progress?: ServiceProgress): Promise<unknown>;
+    auth(token: string): Promise<void>;
+    addEventListener<T extends ServiceEventListener<unknown, unknown>>(eventType: Type<T>, info: T["$info"], cb: (data: T["$data"]) => PromiseLike<void>): Promise<string>;
+    removeEventListener(key: string): Promise<void>;
+    emitToServer<T extends ServiceEventListener<unknown, unknown>>(eventType: Type<T>, infoSelector: (item: T["$info"]) => boolean, data: T["$data"]): Promise<void>;
+    uploadFile(files: File[] | FileList | {
+        name: string;
+        data: BlobPart;
+    }[]): Promise<import("@simplysm/service-common").ServiceUploadResult[]>;
+    downloadFileBuffer(relPath: string): Promise<import("@simplysm/core-common").Bytes>;
+}
+export type RemoteService<T> = {
+    [K in keyof T]: T[K] extends (...args: infer P) => infer R ? (...args: P) => Promise<Awaited<R>> : never;
+};
+export {};
+//# sourceMappingURL=service-client.d.ts.map

package/dist/service-client/src/service-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-client.d.ts","sourceRoot":"","sources":["../../../src/service-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAQpF,UAAU,mBAAmB;IAC3B,kBAAkB,EAAE,oBAAoB,CAAC;IACzC,mBAAmB,EAAE,oBAAoB,CAAC;IAC1C,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,cAAc,CAAC;IACjD,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,qBAAa,aAAc,SAAQ,YAAY,CAAC,mBAAmB,CAAC;aAmBhD,IAAI,EAAE,MAAM;aACZ,OAAO,EAAE,uBAAuB;IAlBlD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,OAAO,CAAC,UAAU,CAAC,CAAS;IAG5B,IAAI,SAAS,YAEZ;IACD,IAAI,OAAO,WAGV;gBAGiB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,uBAAuB;IAoClD,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC;IAW9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB9G,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,gBAAgB,CAAC,CAAC,SAAS,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,EACrE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAClB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,EAChB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,GAC1C,OAAO,CAAC,MAAM,CAAC;IAKZ,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,YAAY,CAAC,CAAC,SAAS,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,EACjE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAClB,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,OAAO,EAC3C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,GACf,OAAO,CAAC,IAAI,CAAC;IAIV,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,QAAQ,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,EAAE;IAOxE,kBAAkB,CAAC,OAAO,EAAE,MAAM;CAGzC;AAGD,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CACzG,CAAC"}

package/dist/service-client/src/transport/service-transport.d.ts

@@ -0,0 +1,24 @@
+import { EventEmitter } from "@simplysm/core-common";
+import type { ServiceClientMessage } from "@simplysm/service-common";
+import type { ServiceProgress } from "../types/progress.types";
+import type { SocketProvider } from "./socket-provider";
+interface ServiceTransportEvents {
+    reload: Set<string>;
+    event: {
+        keys: string[];
+        data: unknown;
+    };
+}
+export declare class ServiceTransport extends EventEmitter<ServiceTransportEvents> {
+    private readonly _socket;
+    private readonly _protocol;
+    private readonly _pendingRequests;
+    private readonly _responseProgressTotalSize;
+    constructor(_socket: SocketProvider);
+    send(message: ServiceClientMessage, progress?: ServiceProgress): Promise<unknown>;
+    private _onMessage;
+    private _cancelAllRequests;
+    private _toError;
+}
+export {};
+//# sourceMappingURL=service-transport.d.ts.map

package/dist/service-client/src/transport/service-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-transport.d.ts","sourceRoot":"","sources":["../../../../src/transport/service-transport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAQ,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAA+C,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAElH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,UAAU,sBAAsB;IAC9B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1C;AAED,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IAe5D,OAAO,CAAC,QAAQ,CAAC,OAAO;IAdpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAEzD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAO7B;IAGJ,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAA6B;gBAE3C,OAAO,EAAE,cAAc;IAa9C,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;YAoCzE,UAAU;IAiExB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,QAAQ;CAKjB"}

package/dist/service-client/src/transport/socket-provider.d.ts

@@ -0,0 +1,31 @@
+import type { Bytes } from "@simplysm/core-common";
+import { EventEmitter } from "@simplysm/core-common";
+interface SocketProviderEvents {
+    message: Bytes;
+    state: "connected" | "closed" | "reconnecting";
+}
+export declare class SocketProvider extends EventEmitter<SocketProviderEvents> {
+    private readonly _url;
+    readonly clientName: string;
+    private readonly _maxReconnectCount;
+    private readonly _HEARTBEAT_TIMEOUT;
+    private readonly _HEARTBEAT_INTERVAL;
+    private readonly _RECONNECT_DELAY;
+    private readonly _PING_PACKET;
+    private _ws?;
+    private _isManualClose;
+    private _reconnectCount;
+    private _heartbeatTimer?;
+    private _lastHeartbeatTime;
+    get connected(): boolean;
+    constructor(_url: string, clientName: string, _maxReconnectCount: number);
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    send(data: Bytes): Promise<void>;
+    private _createSocket;
+    private _tryReconnect;
+    private _startHeartbeat;
+    private _stopHeartbeat;
+}
+export {};
+//# sourceMappingURL=socket-provider.d.ts.map

package/dist/service-client/src/transport/socket-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-provider.d.ts","sourceRoot":"","sources":["../../../../src/transport/socket-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAA6B,MAAM,uBAAuB,CAAC;AAKhF,UAAU,oBAAoB;IAC5B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,cAAc,CAAC;CAChD;AAED,qBAAa,cAAe,SAAQ,YAAY,CAAC,oBAAoB,CAAC;IAqBlE,OAAO,CAAC,QAAQ,CAAC,IAAI;aACL,UAAU,EAAE,MAAM;IAClC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IArBrC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IAGzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IAGvD,OAAO,CAAC,GAAG,CAAC,CAAY;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,eAAe,CAAC,CAAiC;IACzD,OAAO,CAAC,kBAAkB,CAAc;IAExC,IAAI,SAAS,IAAI,OAAO,CAEvB;gBAGkB,IAAI,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM;IAKvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAexB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;YAaxB,aAAa;YAuDb,aAAa;IA6B3B,OAAO,CAAC,eAAe;IAkDvB,OAAO,CAAC,cAAc;CAMvB"}

package/dist/service-client/src/types/connection-config.d.ts

@@ -0,0 +1,8 @@
+export interface ServiceConnectionConfig {
+    port: number;
+    host: string;
+    ssl?: boolean;
+    /** 0 입력시 reconnect안함. 바로 끊김 */
+    maxReconnectCount?: number;
+}
+//# sourceMappingURL=connection-config.d.ts.map

package/dist/service-client/src/types/connection-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-config.d.ts","sourceRoot":"","sources":["../../../../src/types/connection-config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,+BAA+B;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/service-client/src/types/progress.types.d.ts

@@ -0,0 +1,10 @@
+export interface ServiceProgress {
+    request?: (s: ServiceProgressState) => void;
+    response?: (s: ServiceProgressState) => void;
+}
+export interface ServiceProgressState {
+    uuid: string;
+    totalSize: number;
+    completedSize: number;
+}
+//# sourceMappingURL=progress.types.d.ts.map

package/dist/service-client/src/types/progress.types.d.ts.map

@@ -0,0 +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"}

package/dist/service-client/src/workers/client-protocol.worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client-protocol.worker.d.ts.map

package/dist/service-client/src/workers/client-protocol.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-protocol.worker.d.ts","sourceRoot":"","sources":["../../../../src/workers/client-protocol.worker.ts"],"names":[],"mappings":""}

package/dist/service-client.js

@@ -0,0 +1,114 @@
+import { createConsola } from "consola";
+import { EventEmitter } from "@simplysm/core-common";
+import { ServiceTransport } from "./transport/service-transport";
+import { SocketProvider } from "./transport/socket-provider";
+import { EventClient } from "./features/event-client";
+import { FileClient } from "./features/file-client";
+const logger = createConsola().withTag("service-client:ServiceClient");
+class ServiceClient extends EventEmitter {
+  constructor(name, options) {
+    super();
+    this.name = name;
+    this.options = options;
+    const wsProtocol = options.ssl ? "wss" : "ws";
+    const wsUrl = `${wsProtocol}://${options.host}:${options.port}/ws`;
+    this._socket = new SocketProvider(wsUrl, this.name, this.options.maxReconnectCount ?? 10);
+    this._transport = new ServiceTransport(this._socket);
+    this._eventClient = new EventClient(this._transport);
+    this._fileClient = new FileClient(this.hostUrl, this.name);
+    this._socket.on("state", async (state) => {
+      this.emit("state", state);
+      if (state === "connected") {
+        try {
+          if (this._authToken != null) {
+            await this.auth(this._authToken);
+          }
+          await this._eventClient.reRegisterAll();
+        } catch (err) {
+          logger.error("\uC774\uBCA4\uD2B8 \uB9AC\uC2A4\uB108 \uBCF5\uAD6C \uC2E4\uD328", err);
+        }
+      }
+    });
+    this._transport.on("reload", (changedFiles) => {
+      this.emit("reload", changedFiles);
+    });
+  }
+  // 모듈들
+  _socket;
+  _transport;
+  _eventClient;
+  _fileClient;
+  _authToken;
+  // 상태 접근자
+  get connected() {
+    return this._socket.connected;
+  }
+  get hostUrl() {
+    const hostProtocol = this.options.ssl ? "https" : "http";
+    return `${hostProtocol}://${this.options.host}:${this.options.port}`;
+  }
+  // 타입 안전성을 위한 Proxy 생성 메소드
+  getService(serviceName) {
+    return new Proxy({}, {
+      get: (_target, prop) => {
+        const methodName = String(prop);
+        return async (...params) => {
+          return this.send(serviceName, methodName, params);
+        };
+      }
+    });
+  }
+  async connect() {
+    await this._socket.connect();
+  }
+  async close() {
+    await this._socket.close();
+  }
+  async send(serviceName, methodName, params, progress) {
+    return this._transport.send(
+      {
+        name: `${serviceName}.${methodName}`,
+        body: params
+      },
+      {
+        request: (state) => {
+          var _a;
+          this.emit("request-progress", state);
+          (_a = progress == null ? void 0 : progress.request) == null ? void 0 : _a.call(progress, state);
+        },
+        response: (state) => {
+          var _a;
+          this.emit("response-progress", state);
+          (_a = progress == null ? void 0 : progress.response) == null ? void 0 : _a.call(progress, state);
+        }
+      }
+    );
+  }
+  async auth(token) {
+    await this._transport.send({ name: "auth", body: token });
+    this._authToken = token;
+  }
+  async addEventListener(eventType, info, cb) {
+    if (!this.connected) throw new Error("\uC11C\uBC84\uC640 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
+    return this._eventClient.addListener(eventType, info, cb);
+  }
+  async removeEventListener(key) {
+    await this._eventClient.removeListener(key);
+  }
+  async emitToServer(eventType, infoSelector, data) {
+    await this._eventClient.emitToServer(eventType, infoSelector, data);
+  }
+  async uploadFile(files) {
+    if (this._authToken == null) {
+      throw new Error("\uC778\uC99D \uD1A0\uD070\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uD30C\uC77C \uC5C5\uB85C\uB4DC\uB97C \uC704\uD574\uC11C\uB294 \uBA3C\uC800 auth()\uB97C \uD638\uCD9C\uD558\uC5EC \uC778\uC99D\uD574\uC57C \uD569\uB2C8\uB2E4.");
+    }
+    return this._fileClient.upload(files, this._authToken);
+  }
+  async downloadFileBuffer(relPath) {
+    return this._fileClient.download(relPath);
+  }
+}
+export {
+  ServiceClient
+};
+//# sourceMappingURL=service-client.js.map

package/dist/service-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/service-client.ts"],
+  "sourcesContent": ["import { createConsola } from \"consola\";\nimport type { Type } from \"@simplysm/core-common\";\nimport { EventEmitter } from \"@simplysm/core-common\";\nimport type { ServiceEventListener } from \"@simplysm/service-common\";\n\nimport type { ServiceConnectionConfig } from \"./types/connection-config\";\nimport type { ServiceProgress, ServiceProgressState } from \"./types/progress.types\";\nimport { ServiceTransport } from \"./transport/service-transport\";\nimport { SocketProvider } from \"./transport/socket-provider\";\nimport { EventClient } from \"./features/event-client\";\nimport { FileClient } from \"./features/file-client\";\n\nconst logger = createConsola().withTag(\"service-client:ServiceClient\");\n\ninterface ServiceClientEvents {\n  \"request-progress\": ServiceProgressState;\n  \"response-progress\": ServiceProgressState;\n  \"state\": \"connected\" | \"closed\" | \"reconnecting\";\n  \"reload\": Set<string>;\n}\n\nexport class ServiceClient extends EventEmitter<ServiceClientEvents> {\n  // \uBAA8\uB4C8\uB4E4\n  private readonly _socket: SocketProvider;\n  private readonly _transport: ServiceTransport;\n  private readonly _eventClient: EventClient;\n  private readonly _fileClient: FileClient;\n\n  private _authToken?: string;\n\n  // \uC0C1\uD0DC \uC811\uADFC\uC790\n  get connected() {\n    return this._socket.connected;\n  }\n  get hostUrl() {\n    const hostProtocol = this.options.ssl ? \"https\" : \"http\";\n    return `${hostProtocol}://${this.options.host}:${this.options.port}`;\n  }\n\n  constructor(\n    public readonly name: string,\n    public readonly options: ServiceConnectionConfig,\n  ) {\n    super();\n\n    const wsProtocol = options.ssl ? \"wss\" : \"ws\";\n    const wsUrl = `${wsProtocol}://${options.host}:${options.port}/ws`;\n\n    // \uBAA8\uB4C8 \uCD08\uAE30\uD654\n    this._socket = new SocketProvider(wsUrl, this.name, this.options.maxReconnectCount ?? 10);\n    this._transport = new ServiceTransport(this._socket);\n    this._eventClient = new EventClient(this._transport);\n    this._fileClient = new FileClient(this.hostUrl, this.name);\n\n    // \uC774\uBCA4\uD2B8 \uBC14\uC778\uB529\n    this._socket.on(\"state\", async (state) => {\n      this.emit(\"state\", state);\n\n      // \uC7AC\uC5F0\uACB0 \uC2DC \uC774\uBCA4\uD2B8 \uB9AC\uC2A4\uB108 \uC790\uB3D9 \uBCF5\uAD6C\n      if (state === \"connected\") {\n        try {\n          if (this._authToken != null) {\n            await this.auth(this._authToken); // \uC7AC\uC778\uC99D\n          }\n          await this._eventClient.reRegisterAll();\n        } catch (err) {\n          logger.error(\"\uC774\uBCA4\uD2B8 \uB9AC\uC2A4\uB108 \uBCF5\uAD6C \uC2E4\uD328\", err);\n        }\n      }\n    });\n\n    this._transport.on(\"reload\", (changedFiles) => {\n      this.emit(\"reload\", changedFiles);\n    });\n  }\n\n  // \uD0C0\uC785 \uC548\uC804\uC131\uC744 \uC704\uD55C Proxy \uC0DD\uC131 \uBA54\uC18C\uB4DC\n  getService<T>(serviceName: string): RemoteService<T> {\n    return new Proxy({} as RemoteService<T>, {\n      get: (_target, prop) => {\n        const methodName = String(prop);\n        return async (...params: unknown[]) => {\n          return this.send(serviceName, methodName, params);\n        };\n      },\n    });\n  }\n\n  async connect(): Promise<void> {\n    await this._socket.connect();\n  }\n\n  async close(): Promise<void> {\n    await this._socket.close();\n  }\n\n  async send(serviceName: string, methodName: string, params: unknown[], progress?: ServiceProgress): Promise<unknown> {\n    return this._transport.send(\n      {\n        name: `${serviceName}.${methodName}`,\n        body: params,\n      },\n      {\n        request: (state) => {\n          this.emit(\"request-progress\", state);\n          progress?.request?.(state);\n        },\n        response: (state) => {\n          this.emit(\"response-progress\", state);\n          progress?.response?.(state);\n        },\n      },\n    );\n  }\n\n  async auth(token: string): Promise<void> {\n    await this._transport.send({ name: \"auth\", body: token });\n    this._authToken = token;\n  }\n\n  async addEventListener<T extends ServiceEventListener<unknown, unknown>>(\n    eventType: Type<T>,\n    info: T[\"$info\"],\n    cb: (data: T[\"$data\"]) => PromiseLike<void>,\n  ): Promise<string> {\n    if (!this.connected) throw new Error(\"\uC11C\uBC84\uC640 \uC5F0\uACB0\uB418\uC5B4\uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.\");\n    return this._eventClient.addListener(eventType, info, cb);\n  }\n\n  async removeEventListener(key: string): Promise<void> {\n    await this._eventClient.removeListener(key);\n  }\n\n  async emitToServer<T extends ServiceEventListener<unknown, unknown>>(\n    eventType: Type<T>,\n    infoSelector: (item: T[\"$info\"]) => boolean,\n    data: T[\"$data\"],\n  ): Promise<void> {\n    await this._eventClient.emitToServer(eventType, infoSelector, data);\n  }\n\n  async uploadFile(files: File[] | FileList | { name: string; data: BlobPart }[]) {\n    if (this._authToken == null) {\n      throw new Error(\"\uC778\uC99D \uD1A0\uD070\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uD30C\uC77C \uC5C5\uB85C\uB4DC\uB97C \uC704\uD574\uC11C\uB294 \uBA3C\uC800 auth()\uB97C \uD638\uCD9C\uD558\uC5EC \uC778\uC99D\uD574\uC57C \uD569\uB2C8\uB2E4.\");\n    }\n    return this._fileClient.upload(files, this._authToken);\n  }\n\n  async downloadFileBuffer(relPath: string) {\n    return this._fileClient.download(relPath);\n  }\n}\n\n// T\uC758 \uBAA8\uB4E0 \uBA54\uC18C\uB4DC \uBC18\uD658\uD615\uC744 Promise\uB85C \uAC10\uC2F8\uC8FC\uB294 \uD0C0\uC785 \uBCC0\uD658\uAE30\nexport type RemoteService<T> = {\n  [K in keyof T]: T[K] extends (...args: infer P) => infer R ? (...args: P) => Promise<Awaited<R>> : never; // \uD568\uC218\uAC00 \uC544\uB2CC \uD504\uB85C\uD37C\uD2F0\uB294 \uC548\uC500\n};\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,8 @@
+export * from "./protocol/protocol.types";
+export * from "./protocol/service-protocol";
+export * from "./service-types/orm-service.types";
+export * from "./service-types/crypto-service.types";
+export * from "./service-types/auto-update-service.types";
+export * from "./service-types/smtp-service.types";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../service-common/src/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAG5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AAGnD,cAAc,SAAS,CAAC"}

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

@@ -0,0 +1,100 @@
+/** 서비스 프로토콜 설정 */
+export declare const PROTOCOL_CONFIG: {
+    /** 최대 메시지 크기 (100MB) */
+    readonly MAX_TOTAL_SIZE: number;
+    /** 청킹 임계값 (3MB) */
+    readonly SPLIT_MESSAGE_SIZE: number;
+    /** 청크 크기 (300KB) */
+    readonly CHUNK_SIZE: number;
+    /** GC 주기 (10초) */
+    readonly GC_INTERVAL: number;
+    /** 미완성 메시지 만료 시간 (60초) */
+    readonly EXPIRE_TIME: number;
+};
+export type ServiceMessage = ServiceReloadMessage | ServiceRequestMessage | ServiceAuthMessage | ServiceProgressMessage | ServiceResponseMessage | ServiceErrorMessage | ServiceAddEventListenerMessage | ServiceRemoveEventListenerMessage | ServiceGetEventListenerInfosMessage | ServiceEmitEventMessage | ServiceEventMessage;
+export type ServiceServerMessage = ServiceReloadMessage | ServiceResponseMessage | ServiceErrorMessage | ServiceEventMessage;
+export type ServiceServerRawMessage = ServiceProgressMessage | ServiceServerMessage;
+export type ServiceClientMessage = ServiceRequestMessage | ServiceAuthMessage | ServiceAddEventListenerMessage | ServiceRemoveEventListenerMessage | ServiceGetEventListenerInfosMessage | ServiceEmitEventMessage;
+/** 서버: 클라이언트에게 reload 명령 */
+export interface ServiceReloadMessage {
+    name: "reload";
+    body: {
+        clientName: string | undefined;
+        changedFileSet: Set<string>;
+    };
+}
+/** 서버: 받은 분할메시지에 대한 progress 알림 */
+export interface ServiceProgressMessage {
+    name: "progress";
+    body: {
+        totalSize: number;
+        completedSize: number;
+    };
+}
+/** 서버: 에러 발생 알림 */
+export interface ServiceErrorMessage {
+    name: "error";
+    body: {
+        name: string;
+        message: string;
+        code: string;
+        stack?: string;
+        detail?: unknown;
+        cause?: unknown;
+    };
+}
+/** 클라: 인증 메시지 */
+export interface ServiceAuthMessage {
+    name: "auth";
+    body: string;
+}
+/** 클라: ServiceMethod 요청 */
+export interface ServiceRequestMessage {
+    name: `${string}.${string}`;
+    body: unknown[];
+}
+/** 서버: ServiceMethod 응답 */
+export interface ServiceResponseMessage {
+    name: "response";
+    body?: unknown;
+}
+/** 클라: 이벤트 리스너 등록 */
+export interface ServiceAddEventListenerMessage {
+    name: "evt:add";
+    body: {
+        key: string;
+        name: string;
+        info: unknown;
+    };
+}
+/** 클라: 이벤트 리스너 제거 */
+export interface ServiceRemoveEventListenerMessage {
+    name: "evt:remove";
+    body: {
+        key: string;
+    };
+}
+/** 클라: 이벤트 리스너 정보 목록 요청 */
+export interface ServiceGetEventListenerInfosMessage {
+    name: "evt:gets";
+    body: {
+        name: string;
+    };
+}
+/** 클라: 이벤트 발생 */
+export interface ServiceEmitEventMessage {
+    name: "evt:emit";
+    body: {
+        keys: string[];
+        data: unknown;
+    };
+}
+/** 서버: 이벤트 발생 알림 */
+export interface ServiceEventMessage {
+    name: "evt:on";
+    body: {
+        keys: string[];
+        data: unknown;
+    };
+}
+//# sourceMappingURL=protocol.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.types.d.ts","sourceRoot":"","sources":["../../../../../service-common/src/protocol/protocol.types.ts"],"names":[],"mappings":"AAIA,kBAAkB;AAClB,eAAO,MAAM,eAAe;IAC1B,wBAAwB;;IAExB,mBAAmB;;IAEnB,oBAAoB;;IAEpB,kBAAkB;;IAElB,0BAA0B;;CAElB,CAAC;AAMX,MAAM,MAAM,cAAc,GACtB,oBAAoB,GACpB,qBAAqB,GACrB,kBAAkB,GAClB,sBAAsB,GACtB,sBAAsB,GACtB,mBAAmB,GACnB,8BAA8B,GAC9B,iCAAiC,GACjC,mCAAmC,GACnC,uBAAuB,GACvB,mBAAmB,CAAC;AAExB,MAAM,MAAM,oBAAoB,GAC5B,oBAAoB,GACpB,sBAAsB,GACtB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAEpF,MAAM,MAAM,oBAAoB,GAC5B,qBAAqB,GACrB,kBAAkB,GAClB,8BAA8B,GAC9B,iCAAiC,GACjC,mCAAmC,GACnC,uBAAuB,CAAC;AAM5B,4BAA4B;AAC5B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;KAC7B,CAAC;CACH;AAED,mCAAmC;AACnC,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,mBAAmB;AACnB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED,iBAAiB;AACjB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,2BAA2B;AAC3B,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,2BAA2B;AAC3B,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD,qBAAqB;AACrB,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;CACH;AAED,qBAAqB;AACrB,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,2BAA2B;AAC3B,MAAM,WAAW,mCAAmC;IAClD,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,iBAAiB;AACjB,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;CACH;AAED,oBAAoB;AACpB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;CACH"}

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

@@ -0,0 +1,63 @@
+import type { Bytes } from "@simplysm/core-common";
+import "@simplysm/core-common";
+import { type ServiceMessage } from "./protocol.types";
+/**
+ * 서비스 프로토콜 인코더/디코더
+ *
+ * Binary Protocol V2:
+ * - Header: 28 bytes (UUID 16 + TotalSize 8 + Index 4)
+ * - Body: JSON
+ * - 자동 청킹: 3MB 초과 시 300KB 단위 분할
+ * - 최대 메시지: 100MB
+ */
+export declare class ServiceProtocol {
+    /**
+     * 메시지 인코딩 (필요 시 자동 분할)
+     */
+    encode(uuid: string, message: ServiceMessage): {
+        chunks: Bytes[];
+        totalSize: number;
+    };
+    /**
+     * 메시지 청크 인코딩 (헤더 + 바디)
+     *
+     * 헤더 구조 (28 bytes, Big Endian):
+     * ```
+     * Offset  Size  Field
+     * ------  ----  -----
+     *   0     16    UUID (binary)
+     *  16      8    TotalSize (uint64)
+     *  24      4    Index (uint32)
+     * ```
+     */
+    private _encode;
+    private readonly _accumulator;
+    /**
+     * 프로토콜 인스턴스를 정리한다.
+     *
+     * 내부 청크 누적기의 GC 타이머를 해제하고 메모리를 정리한다.
+     * 프로토콜 인스턴스 사용이 끝나면 반드시 호출해야 한다.
+     */
+    dispose(): void;
+    /**
+     * 메시지 디코딩 (분할 패킷 자동 조립)
+     */
+    decode<T extends ServiceMessage>(bytes: Bytes): ServiceMessageDecodeResult<T>;
+}
+/**
+ * 메시지 디코딩 결과 타입 (유니온)
+ *
+ * - `type: "complete"`: 모든 청크가 수신되어 메시지 조립이 완료됨
+ * - `type: "progress"`: 분할 메시지 수신 중 (일부 청크만 도착)
+ */
+export type ServiceMessageDecodeResult<T extends ServiceMessage> = {
+    type: "complete";
+    uuid: string;
+    message: T;
+} | {
+    type: "progress";
+    uuid: string;
+    totalSize: number;
+    completedSize: number;
+};
+//# sourceMappingURL=service-protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-protocol.d.ts","sourceRoot":"","sources":["../../../../../service-common/src/protocol/service-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,uBAAuB,CAAC;AAE/B,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAK1B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAqCrF;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,OAAO;IA0Bf,OAAO,CAAC,QAAQ,CAAC,YAAY,CAU1B;IAEH;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,0BAA0B,CAAC,CAAC,CAAC;CAmE9E;AAED;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,cAAc,IAC3D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * 자동 업데이트 서비스 인터페이스
+ *
+ * 클라이언트 애플리케이션의 최신 버전 정보를 조회한다.
+ */
+export interface AutoUpdateService {
+    /**
+     * 지정된 플랫폼의 최신 버전 정보를 조회한다.
+     * @param platform 대상 플랫폼 (예: "win32", "darwin", "linux")
+     * @returns 최신 버전 정보. 버전이 없으면 undefined
+     */
+    getLastVersion(platform: string): Promise<{
+        version: string;
+        downloadPath: string;
+    } | undefined>;
+}
+//# sourceMappingURL=auto-update-service.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auto-update-service.types.d.ts","sourceRoot":"","sources":["../../../../../service-common/src/service-types/auto-update-service.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CACrC;QACE,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,GACD,SAAS,CACZ,CAAC;CACH"}

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

@@ -0,0 +1,22 @@
+import type { Bytes } from "@simplysm/core-common";
+/**
+ * 암호화 서비스 인터페이스
+ *
+ * SHA256 해시 및 AES 대칭키 암호화/복호화 기능을 제공한다.
+ */
+export interface CryptoService {
+    /** SHA256 해시 생성 */
+    encrypt(data: string | Bytes): Promise<string>;
+    /** AES 암호화 */
+    encryptAes(data: Bytes): Promise<string>;
+    /** AES 복호화 */
+    decryptAes(encText: string): Promise<Bytes>;
+}
+/**
+ * 암호화 서비스 설정
+ */
+export interface CryptoConfig {
+    /** AES 암호화 키 */
+    key: string;
+}
+//# sourceMappingURL=crypto-service.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-service.types.d.ts","sourceRoot":"","sources":["../../../../../service-common/src/service-types/crypto-service.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,cAAc;IACd,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,cAAc;IACd,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;CACb"}

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

@@ -0,0 +1,30 @@
+import type { Dialect, IsolationLevel, QueryDef, ColumnMeta, ResultMeta } from "@simplysm/orm-common";
+/**
+ * ORM 서비스 인터페이스
+ *
+ * 데이터베이스 연결, 트랜잭션 관리, 쿼리 실행 기능을 제공한다.
+ * MySQL, MSSQL, PostgreSQL을 지원한다.
+ */
+export interface OrmService {
+    getInfo(opt: DbConnOptions & {
+        configName: string;
+    }): Promise<{
+        dialect: Dialect;
+        database?: string;
+        schema?: string;
+    }>;
+    connect(opt: Record<string, unknown>): Promise<number>;
+    close(connId: number): Promise<void>;
+    beginTransaction(connId: number, isolationLevel?: IsolationLevel): Promise<void>;
+    commitTransaction(connId: number): Promise<void>;
+    rollbackTransaction(connId: number): Promise<void>;
+    executeParametrized(connId: number, query: string, params?: unknown[]): Promise<unknown[][]>;
+    executeDefs(connId: number, defs: QueryDef[], options?: (ResultMeta | undefined)[]): Promise<unknown[][]>;
+    bulkInsert(connId: number, tableName: string, columnDefs: Record<string, ColumnMeta>, records: Record<string, unknown>[]): Promise<void>;
+}
+/** 데이터베이스 연결 옵션 */
+export type DbConnOptions = {
+    configName?: string;
+    config?: Record<string, unknown>;
+};
+//# sourceMappingURL=orm-service.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orm-service.types.d.ts","sourceRoot":"","sources":["../../../../../service-common/src/service-types/orm-service.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEtG;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC5D,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjF,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE7F,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE1G,UAAU,CACR,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,mBAAmB;AACnB,MAAM,MAAM,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC"}