@simplysm/service-common 13.0.0-beta.11

package/dist/orm-common/src/types/query-def.d.ts

@@ -0,0 +1,351 @@
+import type { ColumnPrimitive, DataType } from "./column";
+import type { Expr, WhereExpr } from "./expr";
+/**
+ * DB 객체 이름 (테이블, 뷰, 프로시저 등)
+ *
+ * DBMS별 네임스페이스:
+ * - MySQL: `database.name` (schema 무시)
+ * - MSSQL: `database.schema.name` (schema 기본값: dbo)
+ * - PostgreSQL: `schema.name` (database는 connection용)
+ */
+export interface QueryDefObjectName {
+    database?: string;
+    schema?: string;
+    name: string;
+}
+/**
+ * CUD 쿼리의 OUTPUT 절 정의
+ *
+ * INSERT/UPDATE/DELETE 후 반환값 정의
+ */
+export interface CudOutputDef {
+    columns: string[];
+    pkColNames: string[];
+    aiColName?: string;
+}
+/**
+ * SELECT 쿼리 정의
+ *
+ * @property type - 쿼리 타입 ("select")
+ * @property from - FROM 절 (테이블/서브쿼리)
+ * @property as - 테이블 별칭
+ * @property select - SELECT 절 컬럼 매핑
+ * @property distinct - DISTINCT 여부
+ * @property top - TOP N (MSSQL)
+ * @property lock - 락 여부
+ * @property where - WHERE 조건 배열
+ * @property joins - JOIN 정의 배열
+ * @property orderBy - ORDER BY [컬럼, 방향] 배열
+ * @property limit - LIMIT [offset, count]
+ * @property groupBy - GROUP BY 표현식 배열
+ * @property having - HAVING 조건 배열
+ * @property with - 재귀 CTE 정의
+ */
+export interface SelectQueryDef {
+    type: "select";
+    from?: QueryDefObjectName | SelectQueryDef | SelectQueryDef[] | string;
+    as: string;
+    select?: Record<string, Expr>;
+    distinct?: boolean;
+    top?: number;
+    lock?: boolean;
+    where?: WhereExpr[];
+    joins?: SelectQueryDefJoin[];
+    orderBy?: [Expr, ("ASC" | "DESC")?][];
+    limit?: [number, number];
+    groupBy?: Expr[];
+    having?: WhereExpr[];
+    with?: {
+        name: string;
+        base: SelectQueryDef;
+        recursive: SelectQueryDef;
+    };
+}
+/**
+ * JOIN 쿼리 정의
+ *
+ * SelectQueryDef 확장 + isSingle 플래그
+ */
+export interface SelectQueryDefJoin extends SelectQueryDef {
+    /** 단일 결과 여부 (1:1 관계) */
+    isSingle?: boolean;
+}
+/**
+ * INSERT 쿼리 정의
+ *
+ * @property records - 삽입할 레코드 배열
+ * @property overrideIdentity - IDENTITY_INSERT 활성화 여부
+ * @property output - OUTPUT 절 정의
+ */
+export interface InsertQueryDef {
+    type: "insert";
+    table: QueryDefObjectName;
+    records: Record<string, ColumnPrimitive>[];
+    overrideIdentity?: boolean;
+    output?: CudOutputDef;
+}
+/**
+ * 조건부 INSERT 쿼리 정의
+ *
+ * 존재하지 않는 경우에만 삽입
+ */
+export interface InsertIfNotExistsQueryDef {
+    type: "insertIfNotExists";
+    table: QueryDefObjectName;
+    record: Record<string, ColumnPrimitive>;
+    existsSelectQuery: SelectQueryDef;
+    overrideIdentity?: boolean;
+    output?: CudOutputDef;
+}
+/**
+ * INSERT INTO SELECT 쿼리 정의
+ *
+ * 서브쿼리 결과를 삽입
+ */
+export interface InsertIntoQueryDef {
+    type: "insertInto";
+    table: QueryDefObjectName;
+    recordsSelectQuery: SelectQueryDef;
+    overrideIdentity?: boolean;
+    output?: CudOutputDef;
+}
+/**
+ * UPDATE 쿼리 정의
+ *
+ * @property record - 업데이트할 컬럼/값 매핑
+ * @property joins - UPDATE JOIN (지원 시)
+ */
+export interface UpdateQueryDef {
+    type: "update";
+    table: QueryDefObjectName;
+    as: string;
+    record: Record<string, Expr>;
+    top?: number;
+    where?: WhereExpr[];
+    joins?: SelectQueryDefJoin[];
+    limit?: [number, number];
+    output?: CudOutputDef;
+}
+/**
+ * DELETE 쿼리 정의
+ */
+export interface DeleteQueryDef {
+    type: "delete";
+    table: QueryDefObjectName;
+    as: string;
+    top?: number;
+    where?: WhereExpr[];
+    joins?: SelectQueryDefJoin[];
+    limit?: [number, number];
+    output?: CudOutputDef;
+}
+/**
+ * UPSERT 쿼리 정의
+ *
+ * INSERT or UPDATE (MERGE 패턴)
+ */
+export interface UpsertQueryDef {
+    type: "upsert";
+    table: QueryDefObjectName;
+    existsSelectQuery: SelectQueryDef;
+    insertRecord: Record<string, Expr>;
+    updateRecord: Record<string, Expr>;
+    overrideIdentity?: boolean;
+    output?: CudOutputDef;
+}
+/** FK 제약조건 활성화/비활성화 */
+export interface SwitchFkQueryDef {
+    type: "switchFk";
+    table: QueryDefObjectName;
+    switch: "on" | "off";
+}
+/** 스키마 초기화 (모든 객체 삭제) */
+export interface ClearSchemaQueryDef {
+    type: "clearSchema";
+    database: string;
+    schema?: string;
+}
+/** CREATE TABLE */
+export interface CreateTableQueryDef {
+    type: "createTable";
+    table: QueryDefObjectName;
+    columns: {
+        name: string;
+        dataType: DataType;
+        autoIncrement?: boolean;
+        nullable?: boolean;
+        default?: ColumnPrimitive;
+    }[];
+    primaryKey?: string[];
+}
+/** DROP TABLE */
+export interface DropTableQueryDef {
+    type: "dropTable";
+    table: QueryDefObjectName;
+}
+/** RENAME TABLE */
+export interface RenameTableQueryDef {
+    type: "renameTable";
+    table: QueryDefObjectName;
+    newName: string;
+}
+/** TRUNCATE TABLE */
+export interface TruncateQueryDef {
+    type: "truncate";
+    table: QueryDefObjectName;
+}
+/** ADD COLUMN */
+export interface AddColumnQueryDef {
+    type: "addColumn";
+    table: QueryDefObjectName;
+    column: {
+        name: string;
+        dataType: DataType;
+        autoIncrement?: boolean;
+        nullable?: boolean;
+        default?: ColumnPrimitive;
+    };
+}
+/** DROP COLUMN */
+export interface DropColumnQueryDef {
+    type: "dropColumn";
+    table: QueryDefObjectName;
+    column: string;
+}
+/** MODIFY COLUMN (타입/속성 변경) */
+export interface ModifyColumnQueryDef {
+    type: "modifyColumn";
+    table: QueryDefObjectName;
+    column: {
+        name: string;
+        dataType: DataType;
+        autoIncrement?: boolean;
+        nullable?: boolean;
+        default?: ColumnPrimitive;
+    };
+}
+/** RENAME COLUMN */
+export interface RenameColumnQueryDef {
+    type: "renameColumn";
+    table: QueryDefObjectName;
+    column: string;
+    newName: string;
+}
+/** DROP PRIMARY KEY */
+export interface DropPkQueryDef {
+    type: "dropPk";
+    table: QueryDefObjectName;
+}
+/** ADD PRIMARY KEY */
+export interface AddPkQueryDef {
+    type: "addPk";
+    table: QueryDefObjectName;
+    columns: string[];
+}
+/** ADD FOREIGN KEY */
+export interface AddFkQueryDef {
+    type: "addFk";
+    table: QueryDefObjectName;
+    foreignKey: {
+        name: string;
+        fkColumns: string[];
+        targetTable: QueryDefObjectName;
+        targetPkColumns: string[];
+    };
+}
+/** DROP FOREIGN KEY */
+export interface DropFkQueryDef {
+    type: "dropFk";
+    table: QueryDefObjectName;
+    foreignKey: string;
+}
+/** CREATE INDEX */
+export interface AddIdxQueryDef {
+    type: "addIdx";
+    table: QueryDefObjectName;
+    index: {
+        name: string;
+        columns: {
+            name: string;
+            orderBy: "ASC" | "DESC";
+        }[];
+        unique?: boolean;
+    };
+}
+/** DROP INDEX */
+export interface DropIdxQueryDef {
+    type: "dropIdx";
+    table: QueryDefObjectName;
+    index: string;
+}
+/** CREATE VIEW */
+export interface CreateViewQueryDef {
+    type: "createView";
+    view: QueryDefObjectName;
+    queryDef: SelectQueryDef;
+}
+/** DROP VIEW */
+export interface DropViewQueryDef {
+    type: "dropView";
+    view: QueryDefObjectName;
+}
+/** CREATE PROCEDURE */
+export interface CreateProcQueryDef {
+    type: "createProc";
+    procedure: QueryDefObjectName;
+    params?: Array<{
+        name: string;
+        dataType: DataType;
+        nullable?: boolean;
+        default?: unknown;
+    }>;
+    returns?: Array<{
+        name: string;
+        dataType: DataType;
+        nullable?: boolean;
+    }>;
+    query: string;
+}
+/** DROP PROCEDURE */
+export interface DropProcQueryDef {
+    type: "dropProc";
+    procedure: QueryDefObjectName;
+}
+/** EXECUTE PROCEDURE */
+export interface ExecProcQueryDef {
+    type: "execProc";
+    procedure: QueryDefObjectName;
+    params: Record<string, Expr> | undefined;
+}
+/** 스키마 존재 여부 확인 */
+export interface SchemaExistsQueryDef {
+    type: "schemaExists";
+    database: string;
+    schema?: string;
+}
+/**
+ * DDL (Data Definition Language) 타입 상수
+ *
+ * 트랜잭션 내 DDL 차단 및 DDL 타입 검증에 사용
+ * satisfies 키워드로 DdlQueryDef와의 동기화를 컴파일 타임에 검증
+ *
+ * @remarks
+ * switchFk는 DDL이 아니므로 제외 (트랜잭션 내 사용 가능)
+ */
+export declare const DDL_TYPES: readonly ["clearSchema", "createTable", "dropTable", "renameTable", "truncate", "addColumn", "dropColumn", "modifyColumn", "renameColumn", "dropPk", "addPk", "addFk", "dropFk", "addIdx", "dropIdx", "createView", "dropView", "createProc", "dropProc"];
+/** DDL 타입 유니언 */
+export type DdlType = (typeof DDL_TYPES)[number];
+/**
+ * 모든 쿼리 정의 유니언 타입
+ *
+ * DML (SELECT/INSERT/UPDATE/DELETE/UPSERT) +
+ * DDL (Table/Column/PK/FK/Index/View/Procedure) +
+ * Utils (SwitchFk) + Meta (SchemaExists)
+ *
+ * @see {@link SelectQueryDef} SELECT 쿼리
+ * @see {@link InsertQueryDef} INSERT 쿼리
+ * @see {@link UpdateQueryDef} UPDATE 쿼리
+ * @see {@link DeleteQueryDef} DELETE 쿼리
+ */
+export type QueryDef = SelectQueryDef | InsertQueryDef | InsertIfNotExistsQueryDef | InsertIntoQueryDef | UpdateQueryDef | DeleteQueryDef | UpsertQueryDef | ClearSchemaQueryDef | CreateTableQueryDef | DropTableQueryDef | RenameTableQueryDef | TruncateQueryDef | AddColumnQueryDef | DropColumnQueryDef | ModifyColumnQueryDef | RenameColumnQueryDef | DropPkQueryDef | AddPkQueryDef | AddFkQueryDef | DropFkQueryDef | AddIdxQueryDef | DropIdxQueryDef | CreateViewQueryDef | DropViewQueryDef | CreateProcQueryDef | DropProcQueryDef | ExecProcQueryDef | SwitchFkQueryDef | SchemaExistsQueryDef;
+//# sourceMappingURL=query-def.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-def.d.ts","sourceRoot":"","sources":["../../../../../orm-common/src/types/query-def.ts"],"names":[],"mappings":"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"}

package/dist/orm-common/src/utils/result-parser.d.ts

@@ -0,0 +1,38 @@
+import type { ResultMeta } from "../types/db";
+/**
+ * DB 쿼리 결과를 ResultMeta를 통해 TypeScript 객체로 변환
+ *
+ * @param rawResults - DB에서 받은 raw 결과 배열
+ * @param meta - 타입 변환 및 JOIN 구조 정보 (필수)
+ * @returns 타입 변환 및 중첩화된 결과 배열. 입력이 비거나 유효한 결과가 없으면 undefined
+ * @throws 타입 파싱 실패 시 Error
+ *
+ * @remarks
+ * - meta 필수: meta가 없으면 이 함수를 호출할 필요 없음 (입력 = 출력)
+ * - async only: 대용량 처리 시 외부 인터럽트를 위해 동기 버전 미제공
+ * - browser/node 모두 지원: setTimeout(resolve, 0)으로 yield
+ * - 빈 결과 처리: 입력 배열이 비거나, 파싱 후 모든 레코드가 빈 객체인 경우 undefined 반환
+ *
+ * @example
+ * ```typescript
+ * // 1. 단순 타입 파싱
+ * const raw = [{ id: "1", createdAt: "2026-01-07T10:00:00.000Z" }];
+ * const meta = { columns: { id: "number", createdAt: "DateTime" }, joins: {} };
+ * const result = await parseQueryResult(raw, meta);
+ * // [{ id: 1, createdAt: DateTime(...) }]
+ *
+ * // 2. JOIN 결과 중첩화
+ * const raw = [
+ *   { id: 1, name: "User1", "posts.id": 10, "posts.title": "Post1" },
+ *   { id: 1, name: "User1", "posts.id": 11, "posts.title": "Post2" },
+ * ];
+ * const meta = {
+ *   columns: { id: "number", name: "string", "posts.id": "number", "posts.title": "string" },
+ *   joins: { posts: { isSingle: false } }
+ * };
+ * const result = await parseQueryResult(raw, meta);
+ * // [{ id: 1, name: "User1", posts: [{ id: 10, title: "Post1" }, { id: 11, title: "Post2" }] }]
+ * ```
+ */
+export declare function parseQueryResult<T>(rawResults: Record<string, unknown>[], meta: ResultMeta): Promise<T[] | undefined>;
+//# sourceMappingURL=result-parser.d.ts.map

package/dist/orm-common/src/utils/result-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-parser.d.ts","sourceRoot":"","sources":["../../../../../orm-common/src/utils/result-parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAoH9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACrC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAe1B"}

package/dist/protocol/protocol.types.js

@@ -0,0 +1,16 @@
+const PROTOCOL_CONFIG = {
+  /** 최대 메시지 크기 (100MB) */
+  MAX_TOTAL_SIZE: 100 * 1024 * 1024,
+  /** 청킹 임계값 (3MB) */
+  SPLIT_MESSAGE_SIZE: 3 * 1024 * 1024,
+  /** 청크 크기 (300KB) */
+  CHUNK_SIZE: 300 * 1024,
+  /** GC 주기 (10초) */
+  GC_INTERVAL: 10 * 1e3,
+  /** 미완성 메시지 만료 시간 (60초) */
+  EXPIRE_TIME: 60 * 1e3
+};
+export {
+  PROTOCOL_CONFIG
+};
+//# sourceMappingURL=protocol.types.js.map

package/dist/protocol/protocol.types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/protocol/protocol.types.ts"],
+  "sourcesContent": ["// ----------------------------------------------------------------------\n// Protocol Constants\n// ----------------------------------------------------------------------\n\n/** \uC11C\uBE44\uC2A4 \uD504\uB85C\uD1A0\uCF5C \uC124\uC815 */\nexport const PROTOCOL_CONFIG = {\n  /** \uCD5C\uB300 \uBA54\uC2DC\uC9C0 \uD06C\uAE30 (100MB) */\n  MAX_TOTAL_SIZE: 100 * 1024 * 1024,\n  /** \uCCAD\uD0B9 \uC784\uACC4\uAC12 (3MB) */\n  SPLIT_MESSAGE_SIZE: 3 * 1024 * 1024,\n  /** \uCCAD\uD06C \uD06C\uAE30 (300KB) */\n  CHUNK_SIZE: 300 * 1024,\n  /** GC \uC8FC\uAE30 (10\uCD08) */\n  GC_INTERVAL: 10 * 1000,\n  /** \uBBF8\uC644\uC131 \uBA54\uC2DC\uC9C0 \uB9CC\uB8CC \uC2DC\uAC04 (60\uCD08) */\n  EXPIRE_TIME: 60 * 1000,\n} as const;\n\n// ----------------------------------------------------------------------\n// Message Types\n// ----------------------------------------------------------------------\n\nexport type ServiceMessage =\n  | ServiceReloadMessage\n  | ServiceRequestMessage\n  | ServiceAuthMessage\n  | ServiceProgressMessage\n  | ServiceResponseMessage\n  | ServiceErrorMessage\n  | ServiceAddEventListenerMessage\n  | ServiceRemoveEventListenerMessage\n  | ServiceGetEventListenerInfosMessage\n  | ServiceEmitEventMessage\n  | ServiceEventMessage;\n\nexport type ServiceServerMessage =\n  | ServiceReloadMessage // \uC54C\uB9BC\n  | ServiceResponseMessage\n  | ServiceErrorMessage\n  | ServiceEventMessage; // \uC54C\uB9BC\n\nexport type ServiceServerRawMessage = ServiceProgressMessage | ServiceServerMessage;\n\nexport type ServiceClientMessage =\n  | ServiceRequestMessage\n  | ServiceAuthMessage\n  | ServiceAddEventListenerMessage\n  | ServiceRemoveEventListenerMessage\n  | ServiceGetEventListenerInfosMessage\n  | ServiceEmitEventMessage;\n\n// ----------------------------------------------------------------------\n// System \uACF5\uD1B5\n// ----------------------------------------------------------------------\n\n/** \uC11C\uBC84: \uD074\uB77C\uC774\uC5B8\uD2B8\uC5D0\uAC8C reload \uBA85\uB839 */\nexport interface ServiceReloadMessage {\n  name: \"reload\";\n  body: {\n    clientName: string | undefined; // \uD074\uB77C\uC774\uC5B8\uD2B8\uBA85\n    changedFileSet: Set<string>; // \uBCC0\uACBD\uD30C\uC77C\uBAA9\uB85D\n  };\n}\n\n/** \uC11C\uBC84: \uBC1B\uC740 \uBD84\uD560\uBA54\uC2DC\uC9C0\uC5D0 \uB300\uD55C progress \uC54C\uB9BC */\nexport interface ServiceProgressMessage {\n  name: \"progress\";\n  body: {\n    totalSize: number; // \uCD1D \uD06C\uAE30 (Bytes)\n    completedSize: number; // \uC644\uB8CC\uB41C \uD06C\uAE30 (Bytes)\n  };\n}\n\n/** \uC11C\uBC84: \uC5D0\uB7EC \uBC1C\uC0DD \uC54C\uB9BC */\nexport interface ServiceErrorMessage {\n  name: \"error\";\n  body: {\n    name: string;\n    message: string;\n    code: string;\n    stack?: string;\n    detail?: unknown;\n    cause?: unknown;\n  };\n}\n\n/** \uD074\uB77C: \uC778\uC99D \uBA54\uC2DC\uC9C0 */\nexport interface ServiceAuthMessage {\n  name: \"auth\";\n  body: string; // \uD1A0\uD070\n}\n\n// ----------------------------------------------------------------------\n// Service.Method\n// ----------------------------------------------------------------------\n\n/** \uD074\uB77C: ServiceMethod \uC694\uCCAD */\nexport interface ServiceRequestMessage {\n  name: `${string}.${string}`; // ${service}.${method}\n  body: unknown[]; // params\n}\n\n/** \uC11C\uBC84: ServiceMethod \uC751\uB2F5 */\nexport interface ServiceResponseMessage {\n  name: \"response\";\n  body?: unknown; // result\n}\n\n// ----------------------------------------------------------------------\n// \uC774\uBCA4\uD2B8\n// ----------------------------------------------------------------------\n\n/** \uD074\uB77C: \uC774\uBCA4\uD2B8 \uB9AC\uC2A4\uB108 \uB4F1\uB85D */\nexport interface ServiceAddEventListenerMessage {\n  name: \"evt:add\";\n  body: {\n    key: string; // \uB9AC\uC2A4\uB108\uD0A4 (uuid) - \uCC28\uD6C4 removeEventListener\uB97C \uC704\uD574\uC11C\uB77C\uB3C4 \uD544\uC694\uD568\n    name: string; // \uC774\uBCA4\uD2B8\uBA85 (Type.name)\n    info: unknown; // \uC774\uBCA4\uD2B8 \uBC1C\uC0DD\uC2DC, \uB9AC\uC2A4\uB108 \uD544\uD130\uB9C1\uC774 \uAC00\uB2A5\uD558\uB3C4\uB85D \uD558\uAE30 \uC704\uD55C \"\uCD94\uAC00 \uB9AC\uC2A4\uB108 \uC815\uBCF4\"\n  };\n}\n\n/** \uD074\uB77C: \uC774\uBCA4\uD2B8 \uB9AC\uC2A4\uB108 \uC81C\uAC70 */\nexport interface ServiceRemoveEventListenerMessage {\n  name: \"evt:remove\";\n  body: {\n    key: string; // \uB9AC\uC2A4\uB108\uD0A4 (uuid)\n  };\n}\n\n/** \uD074\uB77C: \uC774\uBCA4\uD2B8 \uB9AC\uC2A4\uB108 \uC815\uBCF4 \uBAA9\uB85D \uC694\uCCAD */\nexport interface ServiceGetEventListenerInfosMessage {\n  name: \"evt:gets\";\n  body: {\n    name: string; // \uC774\uBCA4\uD2B8\uBA85\n  };\n}\n\n/** \uD074\uB77C: \uC774\uBCA4\uD2B8 \uBC1C\uC0DD */\nexport interface ServiceEmitEventMessage {\n  name: \"evt:emit\";\n  body: {\n    keys: string[]; // \uB9AC\uC2A4\uB108\uD0A4 \uBAA9\uB85D\n    data: unknown; // \uB370\uC774\uD130\n  };\n}\n\n/** \uC11C\uBC84: \uC774\uBCA4\uD2B8 \uBC1C\uC0DD \uC54C\uB9BC */\nexport interface ServiceEventMessage {\n  name: \"evt:on\";\n  body: {\n    keys: string[]; // \uB9AC\uC2A4\uB108\uD0A4 \uBAA9\uB85D\n    data: unknown; // \uB370\uC774\uD130\n  };\n}\n"],
+  "mappings": "AAKO,MAAM,kBAAkB;AAAA;AAAA,EAE7B,gBAAgB,MAAM,OAAO;AAAA;AAAA,EAE7B,oBAAoB,IAAI,OAAO;AAAA;AAAA,EAE/B,YAAY,MAAM;AAAA;AAAA,EAElB,aAAa,KAAK;AAAA;AAAA,EAElB,aAAa,KAAK;AACpB;",
+  "names": []
+}

package/dist/protocol/service-protocol.js

@@ -0,0 +1,134 @@
+import "@simplysm/core-common";
+import { ArgumentError, jsonStringify, jsonParse, LazyGcMap, Uuid, bytesConcat } from "@simplysm/core-common";
+import { PROTOCOL_CONFIG } from "./protocol.types";
+class ServiceProtocol {
+  // -------------------------------------------------------------------
+  // Encoding
+  // -------------------------------------------------------------------
+  /**
+   * 메시지 인코딩 (필요 시 자동 분할)
+   */
+  encode(uuid, message) {
+    const msgJson = jsonStringify([message.name, ..."body" in message ? [message.body] : []]);
+    const msgBytes = new TextEncoder().encode(msgJson);
+    const totalSize = msgBytes.length;
+    if (totalSize > PROTOCOL_CONFIG.MAX_TOTAL_SIZE) {
+      throw new ArgumentError("\uBA54\uC2DC\uC9C0 \uD06C\uAE30\uAC00 \uC81C\uD55C\uC744 \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.", {
+        totalSize,
+        maxSize: PROTOCOL_CONFIG.MAX_TOTAL_SIZE
+      });
+    }
+    if (totalSize <= PROTOCOL_CONFIG.SPLIT_MESSAGE_SIZE) {
+      return { chunks: [this._encode({ uuid, totalSize, index: 0 }, msgBytes)], totalSize };
+    }
+    const chunks = [];
+    let offset = 0;
+    let index = 0;
+    while (offset < totalSize) {
+      const chunkBodyBytes = msgBytes.subarray(offset, offset + PROTOCOL_CONFIG.CHUNK_SIZE);
+      const chunk = this._encode({ uuid, totalSize, index }, chunkBodyBytes);
+      chunks.push(chunk);
+      offset += PROTOCOL_CONFIG.CHUNK_SIZE;
+      index++;
+    }
+    return { chunks, totalSize };
+  }
+  /**
+   * 메시지 청크 인코딩 (헤더 + 바디)
+   *
+   * 헤더 구조 (28 bytes, Big Endian):
+   * ```
+   * Offset  Size  Field
+   * ------  ----  -----
+   *   0     16    UUID (binary)
+   *  16      8    TotalSize (uint64)
+   *  24      4    Index (uint32)
+   * ```
+   */
+  _encode(header, bodyBytes) {
+    const headerBytes = new Uint8Array(28);
+    const uuidBytes = new Uuid(header.uuid).toBytes();
+    headerBytes.set(uuidBytes, 0);
+    const headerView = new DataView(headerBytes.buffer, headerBytes.byteOffset, headerBytes.byteLength);
+    headerView.setBigUint64(16, BigInt(header.totalSize), false);
+    headerView.setUint32(24, header.index, false);
+    return bytesConcat([headerBytes, ...bodyBytes ? [bodyBytes] : []]);
+  }
+  // -------------------------------------------------------------------
+  // Decoding
+  // -------------------------------------------------------------------
+  _accumulator = new LazyGcMap({
+    gcInterval: PROTOCOL_CONFIG.GC_INTERVAL,
+    expireTime: PROTOCOL_CONFIG.EXPIRE_TIME
+  });
+  /**
+   * 프로토콜 인스턴스를 정리한다.
+   *
+   * 내부 청크 누적기의 GC 타이머를 해제하고 메모리를 정리한다.
+   * 프로토콜 인스턴스 사용이 끝나면 반드시 호출해야 한다.
+   */
+  dispose() {
+    this._accumulator.dispose();
+  }
+  /**
+   * 메시지 디코딩 (분할 패킷 자동 조립)
+   */
+  decode(bytes) {
+    if (bytes.length < 28) {
+      throw new ArgumentError("\uBC84\uD37C \uD06C\uAE30\uAC00 \uD5E4\uB354 \uD06C\uAE30\uBCF4\uB2E4 \uC791\uC2B5\uB2C8\uB2E4.", {
+        bufferSize: bytes.length,
+        minimumSize: 28
+      });
+    }
+    const uuidBytes = bytes.subarray(0, 16);
+    const uuid = Uuid.fromBytes(uuidBytes).toString();
+    const headerView = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const totalSize = Number(headerView.getBigUint64(16, false));
+    const index = headerView.getUint32(24, false);
+    if (totalSize > PROTOCOL_CONFIG.MAX_TOTAL_SIZE) {
+      throw new ArgumentError("\uBA54\uC2DC\uC9C0 \uD06C\uAE30\uAC00 \uC81C\uD55C\uC744 \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.", {
+        totalSize,
+        maxSize: PROTOCOL_CONFIG.MAX_TOTAL_SIZE
+      });
+    }
+    const bodyBytes = bytes.subarray(28);
+    const accItem = this._accumulator.getOrCreate(uuid, () => ({
+      totalSize,
+      completedSize: 0,
+      chunks: []
+    }));
+    if (accItem.chunks[index] == null) {
+      accItem.chunks[index] = bodyBytes;
+      accItem.completedSize += bodyBytes.length;
+    }
+    if (accItem.completedSize < accItem.totalSize) {
+      return {
+        type: "progress",
+        uuid,
+        totalSize,
+        completedSize: accItem.completedSize
+      };
+    } else {
+      this._accumulator.delete(uuid);
+      const resultBytes = bytesConcat(accItem.chunks.filterExists());
+      let messageArr;
+      try {
+        messageArr = jsonParse(new TextDecoder().decode(resultBytes));
+      } catch (err) {
+        throw new ArgumentError("\uBA54\uC2DC\uC9C0 \uB514\uCF54\uB529\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", { uuid, cause: err });
+      }
+      return {
+        type: "complete",
+        uuid,
+        message: {
+          name: messageArr[0],
+          body: messageArr[1]
+        }
+      };
+    }
+  }
+}
+export {
+  ServiceProtocol
+};
+//# sourceMappingURL=service-protocol.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/protocol/service-protocol.ts"],
+  "sourcesContent": ["import type { Bytes } from \"@simplysm/core-common\";\nimport \"@simplysm/core-common\";\nimport { ArgumentError, jsonStringify, jsonParse, LazyGcMap, Uuid, bytesConcat } from \"@simplysm/core-common\";\nimport { PROTOCOL_CONFIG, type ServiceMessage } from \"./protocol.types\";\n\n/**\n * \uC11C\uBE44\uC2A4 \uD504\uB85C\uD1A0\uCF5C \uC778\uCF54\uB354/\uB514\uCF54\uB354\n *\n * Binary Protocol V2:\n * - Header: 28 bytes (UUID 16 + TotalSize 8 + Index 4)\n * - Body: JSON\n * - \uC790\uB3D9 \uCCAD\uD0B9: 3MB \uCD08\uACFC \uC2DC 300KB \uB2E8\uC704 \uBD84\uD560\n * - \uCD5C\uB300 \uBA54\uC2DC\uC9C0: 100MB\n */\nexport class ServiceProtocol {\n  // -------------------------------------------------------------------\n  // Encoding\n  // -------------------------------------------------------------------\n\n  /**\n   * \uBA54\uC2DC\uC9C0 \uC778\uCF54\uB529 (\uD544\uC694 \uC2DC \uC790\uB3D9 \uBD84\uD560)\n   */\n  encode(uuid: string, message: ServiceMessage): { chunks: Bytes[]; totalSize: number } {\n    const msgJson = jsonStringify([message.name, ...(\"body\" in message ? [message.body] : [])]);\n    const msgBytes = new TextEncoder().encode(msgJson);\n\n    const totalSize = msgBytes.length;\n\n    // \uC804\uCCB4 \uC0AC\uC774\uC988 \uC81C\uD55C \uCCB4\uD06C (\uAC00\uC7A5 \uBA3C\uC800 \uC218\uD589)\n    if (totalSize > PROTOCOL_CONFIG.MAX_TOTAL_SIZE) {\n      throw new ArgumentError(\"\uBA54\uC2DC\uC9C0 \uD06C\uAE30\uAC00 \uC81C\uD55C\uC744 \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.\", {\n        totalSize,\n        maxSize: PROTOCOL_CONFIG.MAX_TOTAL_SIZE,\n      });\n    }\n\n    // \uC0AC\uC774\uC988\uAC00 \uC791\uC73C\uBA74 \uADF8\uB300\uB85C \uBC18\uD658\n    if (totalSize <= PROTOCOL_CONFIG.SPLIT_MESSAGE_SIZE) {\n      return { chunks: [this._encode({ uuid, totalSize, index: 0 }, msgBytes)], totalSize };\n    }\n\n    // \uBD84\uD560 \uCC98\uB9AC\n    const chunks: Bytes[] = [];\n    let offset = 0;\n    let index = 0;\n\n    while (offset < totalSize) {\n      const chunkBodyBytes = msgBytes.subarray(offset, offset + PROTOCOL_CONFIG.CHUNK_SIZE);\n\n      const chunk = this._encode({ uuid, totalSize, index }, chunkBodyBytes);\n      chunks.push(chunk);\n\n      offset += PROTOCOL_CONFIG.CHUNK_SIZE;\n      index++;\n    }\n\n    return { chunks, totalSize };\n  }\n\n  /**\n   * \uBA54\uC2DC\uC9C0 \uCCAD\uD06C \uC778\uCF54\uB529 (\uD5E4\uB354 + \uBC14\uB514)\n   *\n   * \uD5E4\uB354 \uAD6C\uC870 (28 bytes, Big Endian):\n   * ```\n   * Offset  Size  Field\n   * ------  ----  -----\n   *   0     16    UUID (binary)\n   *  16      8    TotalSize (uint64)\n   *  24      4    Index (uint32)\n   * ```\n   */\n  private _encode(\n    header: {\n      uuid: string;\n      totalSize: number;\n      index: number;\n    },\n    bodyBytes?: Bytes,\n  ): Bytes {\n    const headerBytes = new Uint8Array(28);\n\n    // UUID (0-15)\n    const uuidBytes = new Uuid(header.uuid).toBytes();\n    headerBytes.set(uuidBytes, 0);\n\n    // TotalSize (16-23), Index (24-27)\n    const headerView = new DataView(headerBytes.buffer, headerBytes.byteOffset, headerBytes.byteLength);\n    headerView.setBigUint64(16, BigInt(header.totalSize), false);\n    headerView.setUint32(24, header.index, false);\n\n    return bytesConcat([headerBytes, ...(bodyBytes ? [bodyBytes] : [])]);\n  }\n\n  // -------------------------------------------------------------------\n  // Decoding\n  // -------------------------------------------------------------------\n\n  private readonly _accumulator = new LazyGcMap<\n    string,\n    {\n      totalSize: number;\n      completedSize: number;\n      chunks: (Bytes | undefined)[];\n    }\n  >({\n    gcInterval: PROTOCOL_CONFIG.GC_INTERVAL,\n    expireTime: PROTOCOL_CONFIG.EXPIRE_TIME,\n  });\n\n  /**\n   * \uD504\uB85C\uD1A0\uCF5C \uC778\uC2A4\uD134\uC2A4\uB97C \uC815\uB9AC\uD55C\uB2E4.\n   *\n   * \uB0B4\uBD80 \uCCAD\uD06C \uB204\uC801\uAE30\uC758 GC \uD0C0\uC774\uBA38\uB97C \uD574\uC81C\uD558\uACE0 \uBA54\uBAA8\uB9AC\uB97C \uC815\uB9AC\uD55C\uB2E4.\n   * \uD504\uB85C\uD1A0\uCF5C \uC778\uC2A4\uD134\uC2A4 \uC0AC\uC6A9\uC774 \uB05D\uB098\uBA74 \uBC18\uB4DC\uC2DC \uD638\uCD9C\uD574\uC57C \uD55C\uB2E4.\n   */\n  dispose(): void {\n    this._accumulator.dispose();\n  }\n\n  /**\n   * \uBA54\uC2DC\uC9C0 \uB514\uCF54\uB529 (\uBD84\uD560 \uD328\uD0B7 \uC790\uB3D9 \uC870\uB9BD)\n   */\n  decode<T extends ServiceMessage>(bytes: Bytes): ServiceMessageDecodeResult<T> {\n    if (bytes.length < 28) {\n      throw new ArgumentError(\"\uBC84\uD37C \uD06C\uAE30\uAC00 \uD5E4\uB354 \uD06C\uAE30\uBCF4\uB2E4 \uC791\uC2B5\uB2C8\uB2E4.\", {\n        bufferSize: bytes.length,\n        minimumSize: 28,\n      });\n    }\n\n    // 1. \uD5E4\uB354 \uC77D\uAE30\n\n    // UUID\n    const uuidBytes = bytes.subarray(0, 16);\n    const uuid = Uuid.fromBytes(uuidBytes).toString();\n\n    // TOTAL_SIZE, INDEX\n    const headerView = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n    const totalSize = Number(headerView.getBigUint64(16, false));\n    const index = headerView.getUint32(24, false);\n\n    // \uC804\uCCB4 \uC0AC\uC774\uC988 \uC81C\uD55C \uCCB4\uD06C (\uAC00\uC7A5 \uBA3C\uC800 \uC218\uD589)\n    if (totalSize > PROTOCOL_CONFIG.MAX_TOTAL_SIZE) {\n      throw new ArgumentError(\"\uBA54\uC2DC\uC9C0 \uD06C\uAE30\uAC00 \uC81C\uD55C\uC744 \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.\", {\n        totalSize,\n        maxSize: PROTOCOL_CONFIG.MAX_TOTAL_SIZE,\n      });\n    }\n\n    const bodyBytes = bytes.subarray(28);\n\n    const accItem = this._accumulator.getOrCreate(uuid, () => ({\n      totalSize,\n      completedSize: 0,\n      chunks: [],\n    }));\n    if (accItem.chunks[index] == null) {\n      // \uD328\uD0B7\uC911\uBCF5 \uBC29\uC5B4\n      accItem.chunks[index] = bodyBytes;\n      accItem.completedSize += bodyBytes.length;\n    }\n\n    if (accItem.completedSize < accItem.totalSize) {\n      return {\n        type: \"progress\",\n        uuid: uuid,\n        totalSize: totalSize,\n        completedSize: accItem.completedSize,\n      };\n    } else {\n      this._accumulator.delete(uuid); // \uBA54\uBAA8\uB9AC \uD574\uC81C\n\n      const resultBytes = bytesConcat(accItem.chunks.filterExists());\n      let messageArr: [string, unknown];\n      try {\n        messageArr = jsonParse<[string, unknown]>(new TextDecoder().decode(resultBytes));\n      } catch (err) {\n        throw new ArgumentError(\"\uBA54\uC2DC\uC9C0 \uB514\uCF54\uB529\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.\", { uuid, cause: err });\n      }\n      return {\n        type: \"complete\",\n        uuid: uuid,\n        message: {\n          name: messageArr[0],\n          body: messageArr[1],\n        } as T,\n      };\n    }\n  }\n}\n\n/**\n * \uBA54\uC2DC\uC9C0 \uB514\uCF54\uB529 \uACB0\uACFC \uD0C0\uC785 (\uC720\uB2C8\uC628)\n *\n * - `type: \"complete\"`: \uBAA8\uB4E0 \uCCAD\uD06C\uAC00 \uC218\uC2E0\uB418\uC5B4 \uBA54\uC2DC\uC9C0 \uC870\uB9BD\uC774 \uC644\uB8CC\uB428\n * - `type: \"progress\"`: \uBD84\uD560 \uBA54\uC2DC\uC9C0 \uC218\uC2E0 \uC911 (\uC77C\uBD80 \uCCAD\uD06C\uB9CC \uB3C4\uCC29)\n */\nexport type ServiceMessageDecodeResult<T extends ServiceMessage> =\n  | { type: \"complete\"; uuid: string; message: T }\n  | { type: \"progress\"; uuid: string; totalSize: number; completedSize: number };\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":["../../../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"}