@simplysm/service-common 13.0.100 → 14.0.4

package/README.md

@@ -1,111 +1,233 @@
 # @simplysm/service-common
 
-Simplysm package - Service module (common)
+Shared service protocol and types -- binary protocol V2 with chunking, message types, service event definitions.
+
+This package provides the platform-neutral foundation shared by both `@simplysm/service-client` and `@simplysm/service-server`.
+
+## API
+
+| Export | Kind | Category | Description |
+|--------|------|----------|-------------|
+| `PROTOCOL_CONFIG` | const | Protocol | Protocol configuration constants (max size, chunk size, GC interval, expiry) |
+| `ServiceMessage` | type | Protocol | Union of all message types (client + server) |
+| `ServiceServerMessage` | type | Protocol | Union of server-to-client message types |
+| `ServiceServerRawMessage` | type | Protocol | Server raw message (includes progress) |
+| `ServiceClientMessage` | type | Protocol | Union of client-to-server message types |
+| `ServiceProgressMessage` | interface | Protocol | Chunk receive progress notification |
+| `ServiceErrorMessage` | interface | Protocol | Error notification from server |
+| `ServiceAuthMessage` | interface | Protocol | Authentication message from client |
+| `ServiceRequestMessage` | interface | Protocol | Service method request from client |
+| `ServiceResponseMessage` | interface | Protocol | Service method response from server |
+| `ServiceAddEventListenerMessage` | interface | Protocol | Add event listener request |
+| `ServiceRemoveEventListenerMessage` | interface | Protocol | Remove event listener request |
+| `ServiceGetEventListenerInfosMessage` | interface | Protocol | Get event listener info list request |
+| `ServiceEmitEventMessage` | interface | Protocol | Emit event request |
+| `ServiceEventMessage` | interface | Protocol | Event notification from server |
+| `ServiceProtocol` | interface | Protocol | Protocol encoder/decoder interface |
+| `ServiceMessageDecodeResult` | type | Protocol | Decode result (complete or progress) |
+| `createServiceProtocol` | function | Protocol | Create a protocol encoder/decoder instance |
+| `OrmService` | interface | Service Types | ORM service interface (connect, transaction, query) |
+| `DbConnOptions` | type | Service Types | Database connection options |
+| `AutoUpdateService` | interface | Service Types | Auto-update service interface |
+| `ServiceUploadResult` | interface | Types | File upload result |
+| `ServiceEventDef` | interface | Definitions | Event definition created by `defineEvent()` |
+| `defineEvent` | function | Definitions | Define a typed service event |
+
+## Protocol
+
+### PROTOCOL_CONFIG
+
+Protocol configuration constants.
+
+```ts
+import { PROTOCOL_CONFIG } from "@simplysm/service-common";
+```
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `MAX_TOTAL_SIZE` | `number` | `104,857,600` (100 MB) | Maximum message size |
+| `SPLIT_MESSAGE_SIZE` | `number` | `3,145,728` (3 MB) | Chunking threshold -- messages larger than this are split |
+| `CHUNK_SIZE` | `number` | `307,200` (300 KB) | Size of each chunk |
+| `GC_INTERVAL` | `number` | `10,000` (10 s) | Garbage collection interval for incomplete messages |
+| `EXPIRE_TIME` | `number` | `60,000` (60 s) | Expiry time for incomplete chunked messages |
+
+### Message Types
+
+All messages exchanged between client and server are strongly typed.
+
+#### Client-to-Server Messages
+
+| Interface | `name` Field | Description |
+|-----------|-------------|-------------|
+| `ServiceAuthMessage` | `"auth"` | Authenticate with a token string |
+| `ServiceRequestMessage` | `` `${service}.${method}` `` | Call a service method with parameters |
+| `ServiceAddEventListenerMessage` | `"evt:add"` | Register an event listener with key, event name, and filter info |
+| `ServiceRemoveEventListenerMessage` | `"evt:remove"` | Unregister an event listener by key |
+| `ServiceGetEventListenerInfosMessage` | `"evt:gets"` | Query listener info list for an event name |
+| `ServiceEmitEventMessage` | `"evt:emit"` | Emit an event to specific listener keys |
 
-Shared protocol and types used by both `@simplysm/service-client` and `@simplysm/service-server`. Provides binary message encoding/decoding, service interface definitions, and event type system.
+#### Server-to-Client Messages
 
-## Installation
+| Interface | `name` Field | Description |
+|-----------|-------------|-------------|
+| `ServiceProgressMessage` | `"progress"` | Chunk receive progress (`totalSize`, `completedSize`) |
+| `ServiceResponseMessage` | `"response"` | Service method return value |
+| `ServiceErrorMessage` | `"error"` | Error with name, message, code, optional stack/detail/cause |
+| `ServiceEventMessage` | `"evt:on"` | Event broadcast to listener keys with data |
 
-```bash
-npm install @simplysm/service-common
+### ServiceProtocol
+
+Binary protocol V2 interface. Header: 28 bytes (UUID 16 + TotalSize 8 + Index 4), body: JSON. Auto-chunks messages exceeding 3 MB into 300 KB chunks. Maximum message size: 100 MB.
+
+```ts
+interface ServiceProtocol {
+  encode(uuid: string, message: ServiceMessage): { chunks: Bytes[]; totalSize: number };
+  decode<T extends ServiceMessage>(bytes: Bytes): ServiceMessageDecodeResult<T>;
+  dispose(): void;
+}
 ```
 
-## API Overview
-
-### Protocol
-| API | Type | Description |
-|-----|------|-------------|
-| `PROTOCOL_CONFIG` | const | Protocol configuration constants (sizes, timeouts) |
-| `ServiceProtocol` | interface | Binary protocol encoder/decoder interface |
-| `createServiceProtocol` | function | Create a protocol instance |
-| `ServiceMessageDecodeResult` | type | Decode result (complete or progress) |
-| `ServiceMessage` | type | Union of all message types |
-| `ServiceServerMessage` | type | Server-to-client message union |
-| `ServiceServerRawMessage` | type | Server messages including progress |
-| `ServiceClientMessage` | type | Client-to-server message union |
-| `ServiceReloadMessage` | interface | Server reload command |
-| `ServiceProgressMessage` | interface | Chunked message progress notification |
-| `ServiceErrorMessage` | interface | Server error notification |
-| `ServiceAuthMessage` | interface | Client authentication message |
-| `ServiceRequestMessage` | interface | Client service method request |
-| `ServiceResponseMessage` | interface | Server method response |
-| `ServiceAddEventListenerMessage` | interface | Client add event listener |
-| `ServiceRemoveEventListenerMessage` | interface | Client remove event listener |
-| `ServiceGetEventListenerInfosMessage` | interface | Client request event listener infos |
-| `ServiceEmitEventMessage` | interface | Client emit event |
-| `ServiceEventMessage` | interface | Server event notification |
-
--> See [docs/protocol.md](./docs/protocol.md) for details.
-
-### Service Types
-| API | Type | Description |
-|-----|------|-------------|
-| `OrmService` | interface | ORM service interface (connect, query, transaction) |
-| `DbConnOptions` | type | Database connection options |
-| `AutoUpdateService` | interface | Auto-update service interface |
-| `SmtpClientSendOption` | interface | Full SMTP send options |
-| `SmtpClientSendByDefaultOption` | interface | SMTP send with server defaults |
-| `SmtpClientSendAttachment` | interface | Email attachment definition |
-| `SmtpClientDefaultOptions` | interface | Default SMTP client config |
-
--> See [docs/service-types.md](./docs/service-types.md) for details.
-
-### Types
-| API | Type | Description |
-|-----|------|-------------|
-| `ServiceUploadResult` | interface | File upload result (path, filename, size) |
-
--> See [docs/events.md](./docs/events.md) for details.
-
-### Event Definition
-| API | Type | Description |
-|-----|------|-------------|
-| `ServiceEventDef` | interface | Type-safe event definition |
-| `defineEvent` | function | Define a service event with typed info and data |
-
--> See [docs/events.md](./docs/events.md) for details.
-
-## Usage Examples
-
-### Define and Use Events
-
-```typescript
-import { defineEvent } from "@simplysm/service-common";
+| Method | Parameters | Return | Description |
+|--------|-----------|--------|-------------|
+| `encode` | `uuid: string`, `message: ServiceMessage` | `{ chunks: Bytes[]; totalSize: number }` | Encode a message into binary chunks |
+| `decode` | `bytes: Bytes` | `ServiceMessageDecodeResult<T>` | Decode received bytes; returns `"complete"` or `"progress"` |
+| `dispose` | -- | `void` | Clean up internal GC timers |
 
-// Define a typed event
-const OrderUpdated = defineEvent<
-  { orderId: number },      // TInfo: filter info
-  { status: string }        // TData: event data
->("OrderUpdated");
+### ServiceMessageDecodeResult\<TMessage\>
 
-// Server: emit event
-ctx.socket?.emitEvent(OrderUpdated, { orderId: 123 }, { status: "shipped" });
+```ts
+type ServiceMessageDecodeResult<TMessage extends ServiceMessage> =
+  | { type: "complete"; uuid: string; message: TMessage }
+  | { type: "progress"; uuid: string; totalSize: number; completedSize: number };
+```
 
-// Client: subscribe to event
-await client.addEventListener(OrderUpdated, { orderId: 123 }, (data) => {
-  console.log(data.status); // typed as string
-});
+- `"complete"` -- all chunks received; the full message is available.
+- `"progress"` -- chunked message still in progress.
+
+### createServiceProtocol
+
+```ts
+function createServiceProtocol(): ServiceProtocol;
 ```
 
-### Use Protocol
+Creates a binary protocol V2 encoder/decoder instance.
 
-```typescript
-import { createServiceProtocol } from "@simplysm/service-common";
+## Service Types
 
-const protocol = createServiceProtocol();
+### OrmService
 
-// Encode
-const { chunks, totalSize } = protocol.encode(uuid, {
-  name: "MyService.myMethod",
-  body: [param1, param2],
-});
+ORM service interface. Supports MySQL, MSSQL, and PostgreSQL.
+
+```ts
+interface OrmService {
+  getInfo(opt: DbConnOptions & { configName: string }): Promise<{ dialect: Dialect; database?: string; schema?: string }>;
+  connect(opt: DbConnOptions & { configName: string }): 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>;
+}
+```
+
+| Method | Parameters | Return | Description |
+|--------|-----------|--------|-------------|
+| `getInfo` | `opt: DbConnOptions & { configName: string }` | `Promise<{ dialect; database?; schema? }>` | Get database dialect and schema info |
+| `connect` | `opt: DbConnOptions & { configName: string }` | `Promise<number>` | Open a connection; returns connection ID |
+| `close` | `connId: number` | `Promise<void>` | Close a connection |
+| `beginTransaction` | `connId: number`, `isolationLevel?: IsolationLevel` | `Promise<void>` | Begin a transaction |
+| `commitTransaction` | `connId: number` | `Promise<void>` | Commit the current transaction |
+| `rollbackTransaction` | `connId: number` | `Promise<void>` | Rollback the current transaction |
+| `executeParametrized` | `connId: number`, `query: string`, `params?: unknown[]` | `Promise<unknown[][]>` | Execute a parameterized query |
+| `executeDefs` | `connId: number`, `defs: QueryDef[]`, `options?: (ResultMeta \| undefined)[]` | `Promise<unknown[][]>` | Execute query definitions |
+| `bulkInsert` | `connId: number`, `tableName: string`, `columnDefs: Record<string, ColumnMeta>`, `records: Record<string, unknown>[]` | `Promise<void>` | Bulk insert records |
+
+### DbConnOptions
+
+```ts
+type DbConnOptions = { configName?: string; config?: Record<string, unknown> };
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `configName` | `string?` | Configuration name to look up |
+| `config` | `Record<string, unknown>?` | Inline configuration object |
+
+### AutoUpdateService
+
+Auto-update service interface. Retrieves the latest version information for client applications.
+
+```ts
+interface AutoUpdateService {
+  getLastVersion(platform: string): Promise<{ version: string; downloadPath: string } | undefined>;
+}
+```
+
+| Method | Parameters | Return | Description |
+|--------|-----------|--------|-------------|
+| `getLastVersion` | `platform: string` | `Promise<{ version: string; downloadPath: string } \| undefined>` | Get latest version info for a platform |
+
+## Types
+
+### ServiceUploadResult
+
+File upload result containing server-side storage information.
+
+```ts
+interface ServiceUploadResult {
+  path: string;
+  filename: string;
+  size: number;
+}
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `path` | `string` | Server-side storage path |
+| `filename` | `string` | Original file name |
+| `size` | `number` | File size in bytes |
+
+## Definitions
+
+### ServiceEventDef\<TInfo, TData\>
 
-// Decode
-const result = protocol.decode(receivedBytes);
-if (result.type === "complete") {
-  handleMessage(result.message);
+Event definition created by `defineEvent()`. The `$info` and `$data` fields are type-only markers (not used at runtime).
+
+```ts
+interface ServiceEventDef<TInfo = unknown, TData = unknown> {
+  eventName: string;
+  readonly $info: TInfo;
+  readonly $data: TData;
 }
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `eventName` | `string` | Event name identifier |
+| `$info` | `TInfo` | Type-only marker for listener filter info |
+| `$data` | `TData` | Type-only marker for event payload data |
+
+### defineEvent
+
+```ts
+function defineEvent<TInfo = unknown, TData = unknown>(eventName: string): ServiceEventDef<TInfo, TData>;
+```
 
-// Cleanup
-protocol.dispose();
+Define a typed service event for use with the event system.
+
+```ts
+import { defineEvent } from "@simplysm/service-common";
+
+// Define an event with typed info and data
+const MyEvent = defineEvent<{ userId: number }, { message: string }>("MyEvent");
+
+// Server: emit the event
+await server.emitEvent(MyEvent, (info) => info.userId === 123, { message: "hello" });
+
+// Client: subscribe to the event
+await client.addListener(MyEvent, { userId: 123 }, async (data) => {
+  console.log(data.message);
+});
 ```

package/dist/define-event.d.ts

@@ -1,24 +1,24 @@
 /**
- * Event definition created by defineEvent().
- * $info and $data are type-only markers (not used at runtime).
+ * defineEvent()로 생성된 이벤트 정의.
+ * $info와 $data는 타입 전용 마커임 (런타임에서는 사용되지 않음).
  */
 export interface ServiceEventDef<TInfo = unknown, TData = unknown> {
     eventName: string;
-    /** Type extraction only (not used at runtime) */
+    /** 타입 추출 전용 (런타임에서는 사용되지 않음) */
     readonly $info: TInfo;
-    /** Type extraction only (not used at runtime) */
+    /** 타입 추출 전용 (런타임에서는 사용되지 않음) */
     readonly $data: TData;
 }
 /**
- * Define a service event with type-safe info and data.
+ * 타입 안전한 info와 data를 가진 서비스 이벤트를 정의한다.
  *
  * @example
  * const OrderUpdated = defineEvent<{ orderId: number }, { status: string }>("OrderUpdated");
  *
- * // Server emit
+ * // 서버에서 이벤트 발생
  * ctx.socket?.emitEvent(OrderUpdated, { orderId: 123 }, { status: "shipped" });
  *
- * // Client subscribe
+ * // 클라이언트에서 구독
  * await client.addEventListener(OrderUpdated, { orderId: 123 }, (data) => {
  *   console.log(data.status); // typed
  * });

package/dist/define-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-event.d.ts","sourceRoot":"","sources":["..\\src\\define-event.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAC1D,SAAS,EAAE,MAAM,GAChB,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAM/B"}
+{"version":3,"file":"define-event.d.ts","sourceRoot":"","sources":["..\\src\\define-event.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAC1D,SAAS,EAAE,MAAM,GAChB,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAM/B"}

package/dist/define-event.js

@@ -1,11 +1,22 @@
-function defineEvent(eventName) {
-  return {
-    eventName,
-    $info: void 0,
-    $data: void 0
-  };
+/**
+ * 타입 안전한 info와 data를 가진 서비스 이벤트를 정의한다.
+ *
+ * @example
+ * const OrderUpdated = defineEvent<{ orderId: number }, { status: string }>("OrderUpdated");
+ *
+ * // 서버에서 이벤트 발생
+ * ctx.socket?.emitEvent(OrderUpdated, { orderId: 123 }, { status: "shipped" });
+ *
+ * // 클라이언트에서 구독
+ * await client.addEventListener(OrderUpdated, { orderId: 123 }, (data) => {
+ *   console.log(data.status); // typed
+ * });
+ */
+export function defineEvent(eventName) {
+    return {
+        eventName,
+        $info: undefined,
+        $data: undefined,
+    };
 }
-export {
-  defineEvent
-};
-//# sourceMappingURL=define-event.js.map
+//# sourceMappingURL=define-event.js.map

package/dist/define-event.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/define-event.ts"],
-  "mappings": "AA0BO,SAAS,YACd,WAC+B;AAC/B,SAAO;AAAA,IACL;AAAA,IACA,OAAO;AAAA,IACP,OAAO;AAAA,EACT;AACF;",
-  "names": []
-}
+{"version":3,"file":"define-event.js","sourceRoot":"","sources":["..\\src\\define-event.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CACzB,SAAiB;IAEjB,OAAO;QACL,SAAS;QACT,KAAK,EAAE,SAA6B;QACpC,KAAK,EAAE,SAA6B;KACrC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -2,7 +2,6 @@ export * from "./protocol/protocol.types";
 export * from "./protocol/create-service-protocol";
 export * from "./service-types/orm-service.types";
 export * from "./service-types/auto-update-service.types";
-export * from "./service-types/smtp-client-service.types";
 export * from "./types";
 export * from "./define-event";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AAGnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAG1D,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AAGnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAE1D,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,8 +1,11 @@
+// 프로토콜
 export * from "./protocol/protocol.types.js";
 export * from "./protocol/create-service-protocol.js";
+// 서비스 타입
 export * from "./service-types/orm-service.types.js";
 export * from "./service-types/auto-update-service.types.js";
-export * from "./service-types/smtp-client-service.types.js";
+// 타입
 export * from "./types.js";
+// 정의
 export * from "./define-event.js";
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/index.ts"],
-  "mappings": "AACA,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;AACd,cAAc;AAGd,cAAc;AAGd,cAAc;",
-  "names": []
-}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AAAA,OAAO;AACP,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AAEnD,SAAS;AACT,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAC1D,KAAK;AACL,cAAc,SAAS,CAAC;AAExB,KAAK;AACL,cAAc,gBAAgB,CAAC"}

package/dist/protocol/create-service-protocol.d.ts

@@ -2,39 +2,39 @@ import type { Bytes } from "@simplysm/core-common";
 import "@simplysm/core-common";
 import { type ServiceMessage } from "./protocol.types";
 /**
- * Service protocol interface
+ * 서비스 프로토콜 인터페이스
  *
- * Binary Protocol V2:
- * - Header: 28 bytes (UUID 16 + TotalSize 8 + Index 4)
- * - Body: JSON
- * - Auto chunking: splits into 300KB chunks when exceeding 3MB
- * - Max message size: 100MB
+ * 바이너리 프로토콜 V2:
+ * - 헤더: 28바이트 (UUID 16 + TotalSize 8 + Index 4)
+ * - 본문: JSON
+ * - 자동 청킹: 3MB 초과 시 300KB 청크로 분할
+ * - 최대 메시지 크기: 100MB
  */
 export interface ServiceProtocol {
     /**
-     * Encode a message (auto-split if needed)
+     * 메시지를 인코딩한다 (필요 시 자동 분할)
      */
     encode(uuid: string, message: ServiceMessage): {
         chunks: Bytes[];
         totalSize: number;
     };
     /**
-     * Decode a message (auto-reassemble chunked packets)
+     * 메시지를 디코딩한다 (청크 패킷 자동 재조립)
      */
     decode<T extends ServiceMessage>(bytes: Bytes): ServiceMessageDecodeResult<T>;
     /**
-     * Dispose the protocol instance.
+     * 프로토콜 인스턴스를 해제한다.
      *
-     * Releases the internal chunk accumulator's GC timer and frees memory.
-     * Must be called when the protocol instance is no longer needed.
+     * 내부 청크 누적기의 GC 타이머를 해제하고 메모리를 반환한다.
+     * 프로토콜 인스턴스가 더 이상 필요하지 않을 때 반드시 호출해야 한다.
      */
     dispose(): void;
 }
 /**
- * Message decode result type (union)
+ * 메시지 디코딩 결과 타입 (유니언)
  *
- * - `type: "complete"`: all chunks received and message reassembly is complete
- * - `type: "progress"`: chunked message in progress (only some chunks arrived)
+ * - `type: "complete"`: 모든 청크를 수신하여 메시지 재조립이 완료됨
+ * - `type: "progress"`: 청크 메시지 진행 중 (일부 청크만 도착)
  */
 export type ServiceMessageDecodeResult<TMessage extends ServiceMessage> = {
     type: "complete";
@@ -47,13 +47,13 @@ export type ServiceMessageDecodeResult<TMessage extends ServiceMessage> = {
     completedSize: number;
 };
 /**
- * Create a service protocol encoder/decoder
+ * 서비스 프로토콜 인코더/디코더를 생성한다
  *
- * Binary Protocol V2:
- * - Header: 28 bytes (UUID 16 + TotalSize 8 + Index 4)
- * - Body: JSON
- * - Auto chunking: splits into 300KB chunks when exceeding 3MB
- * - Max message size: 100MB
+ * 바이너리 프로토콜 V2:
+ * - 헤더: 28바이트 (UUID 16 + TotalSize 8 + Index 4)
+ * - 본문: JSON
+ * - 자동 청킹: 3MB 초과 시 300KB 청크로 분할
+ * - 최대 메시지 크기: 100MB
  */
 export declare function createServiceProtocol(): ServiceProtocol;
 //# sourceMappingURL=create-service-protocol.d.ts.map

package/dist/protocol/create-service-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-service-protocol.d.ts","sourceRoot":"","sources":["..\\..\\src\\protocol\\create-service-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,uBAAuB,CAAC;AAQ/B,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAEtF;;OAEG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,0BAA0B,CAAC,CAAC,CAAC,CAAC;IAE9E;;;;;OAKG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,CAAC,QAAQ,SAAS,cAAc,IAClE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CA6KvD"}
+{"version":3,"file":"create-service-protocol.d.ts","sourceRoot":"","sources":["..\\..\\src\\protocol\\create-service-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,uBAAuB,CAAC;AAQ/B,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAEtF;;OAEG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,0BAA0B,CAAC,CAAC,CAAC,CAAC;IAE9E;;;;;OAKG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,CAAC,QAAQ,SAAS,cAAc,IAClE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAqLvD"}