entity-server-client 0.2.4 → 0.2.5

package/dist/EntityServerClient.d.ts

@@ -0,0 +1,203 @@
+import type { EntityHistoryRecord, EntityListParams, EntityListResult, EntityQueryRequest, EntityServerClientOptions, RegisterPushDeviceOptions } from "./types";
+export declare class EntityServerClient {
+    private baseUrl;
+    private token;
+    private apiKey;
+    private hmacSecret;
+    private packetMagicLen;
+    private encryptRequests;
+    private activeTxId;
+    private keepSession;
+    private refreshBuffer;
+    private onTokenRefreshed?;
+    private onSessionExpired?;
+    private _sessionRefreshToken;
+    private _refreshTimer;
+    /**
+     * EntityServerClient 인스턴스를 생성합니다.
+     *
+     * 기본값:
+     * - `baseUrl`: `VITE_ENTITY_SERVER_URL` 또는 `http://localhost:47200`
+     * - `packetMagicLen`: `VITE_ENTITY_SERVER_PACKET_MAGIC_LEN` 또는 `4`
+     */
+    constructor(options?: EntityServerClientOptions);
+    /** baseUrl, token, packetMagicLen, encryptRequests 값을 런타임에 갱신합니다. */
+    configure(options: Partial<EntityServerClientOptions>): void;
+    /** 인증 요청에 사용할 JWT Access Token을 설정합니다. */
+    setToken(token: string): void;
+    /** HMAC 인증용 API Key를 설정합니다. */
+    setApiKey(apiKey: string): void;
+    /** HMAC 인증용 시크릿을 설정합니다. */
+    setHmacSecret(secret: string): void;
+    /** 암호화 패킷 magic 길이(`packet_magic_len`)를 설정합니다. */
+    setPacketMagicLen(length: number): void;
+    /** 현재 암호화 패킷 magic 길이를 반환합니다. */
+    getPacketMagicLen(): number;
+    /** @internal 자동 토큰 갱신 타이머를 시작합니다. */
+    private _scheduleKeepSession;
+    /** @internal 자동 갱신 타이머를 정리합니다. */
+    private _clearRefreshTimer;
+    /**
+     * 세션 유지 타이머를 중지합니다.
+     * `logout()` 호출 시 자동으로 중지되며, 직접 호출이 필요한 경우는 드뭅니다.
+     */
+    stopKeepSession(): void;
+    /**
+     * 서버 헬스 체크를 수행하고 패킷 암호화 활성 여부를 자동으로 감지합니다.
+     *
+     * 서버가 `packet_encryption: true`를 응답하면 이후 모든 요청에 암호화가 자동 적용됩니다.
+     *
+     * ```ts
+     * await client.checkHealth();
+     * await client.login(email, password);
+     * ```
+     */
+    checkHealth(): Promise<{
+        ok: boolean;
+        packet_encryption?: boolean;
+    }>;
+    /** 로그인 후 `access_token`을 내부 상태에 저장합니다. */
+    login(email: string, password: string): Promise<{
+        access_token: string;
+        refresh_token: string;
+        expires_in: number;
+    }>;
+    /** Refresh Token으로 Access Token을 재발급받아 내부 토큰을 교체합니다. */
+    refreshToken(refreshToken: string): Promise<{
+        access_token: string;
+        expires_in: number;
+    }>;
+    /**
+     * 서버에 로그아웃을 요청하고 내부 토큰을 초기화합니다.
+     * refresh_token을 서버에 전달해 무효화합니다.
+     */
+    logout(refreshToken: string): Promise<{
+        ok: boolean;
+    }>;
+    /** 트랜잭션을 시작하고 활성 트랜잭션 ID를 저장합니다. */
+    transStart(): Promise<string>;
+    /** 활성 트랜잭션(또는 전달된 transactionId)을 롤백합니다. */
+    transRollback(transactionId?: string): Promise<{
+        ok: boolean;
+    }>;
+    /**
+     * 활성 트랜잭션(또는 전달된 transactionId)을 커밋합니다.
+     *
+     * @returns `results` 배열: commit된 각 작업의 `entity`, `action`, `seq`
+     */
+    transCommit(transactionId?: string): Promise<{
+        ok: boolean;
+        results: Array<{
+            entity: string;
+            action: string;
+            seq: number;
+        }>;
+    }>;
+    /** 시퀀스 ID로 엔티티 단건을 조회합니다. */
+    get<T = unknown>(entity: string, seq: number, opts?: {
+        skipHooks?: boolean;
+    }): Promise<{
+        ok: boolean;
+        data: T;
+    }>;
+    /** 조건으로 엔티티 단건을 조회합니다. data 컬럼을 완전히 복호화하여 반환합니다. */
+    find<T = unknown>(entity: string, conditions?: Record<string, unknown>, opts?: {
+        skipHooks?: boolean;
+    }): Promise<{
+        ok: boolean;
+        data: T;
+    }>;
+    /** 페이지네이션/정렬/필터 조건으로 엔티티 목록을 조회합니다. */
+    list<T = unknown>(entity: string, params?: EntityListParams): Promise<{
+        ok: boolean;
+        data: EntityListResult<T>;
+    }>;
+    /**
+     * 엔티티 총 건수를 조회합니다.
+     *
+     * @param conditions 필터 조건 (예: `{ status: "active" }`)
+     */
+    count(entity: string, conditions?: Record<string, unknown>): Promise<{
+        ok: boolean;
+        count: number;
+    }>;
+    /**
+     * 커스텀 SQL로 엔티티를 조회합니다.
+     *
+     * SELECT 전용이며 인덱스 테이블만 조회 가능합니다. JOIN 지원.
+     */
+    query<T = unknown>(entity: string, req: EntityQueryRequest): Promise<{
+        ok: boolean;
+        data: {
+            items: T[];
+            count: number;
+        };
+    }>;
+    /** 엔티티 데이터를 생성/수정(Submit)합니다. `seq`가 없으면 INSERT, 있으면 UPDATE입니다. */
+    submit(entity: string, data: Record<string, unknown>, opts?: {
+        transactionId?: string;
+        skipHooks?: boolean;
+    }): Promise<{
+        ok: boolean;
+        seq: number;
+    }>;
+    /** 시퀀스 ID로 엔티티를 삭제합니다(`hard=true`면 하드 삭제, 기본은 소프트 삭제). */
+    delete(entity: string, seq: number, opts?: {
+        transactionId?: string;
+        hard?: boolean;
+        skipHooks?: boolean;
+    }): Promise<{
+        ok: boolean;
+        deleted: number;
+    }>;
+    /** 엔티티 단건의 변경 이력을 조회합니다. */
+    history<T = unknown>(entity: string, seq: number, params?: Pick<EntityListParams, "page" | "limit">): Promise<{
+        ok: boolean;
+        data: EntityListResult<EntityHistoryRecord<T>>;
+    }>;
+    /** 특정 이력 시점으로 엔티티를 롤백합니다. */
+    rollback(entity: string, historySeq: number): Promise<{
+        ok: boolean;
+    }>;
+    /** 푸시 관련 엔티티로 payload를 전송(Submit)합니다. */
+    push(pushEntity: string, payload: Record<string, unknown>, opts?: {
+        transactionId?: string;
+    }): Promise<{
+        ok: boolean;
+        seq: number;
+    }>;
+    /** 푸시 로그 엔티티 목록을 조회합니다. */
+    pushLogList<T = unknown>(params?: EntityListParams): Promise<{
+        ok: boolean;
+        data: EntityListResult<T>;
+    }>;
+    /** 계정의 푸시 디바이스를 등록합니다. */
+    registerPushDevice(accountSeq: number, deviceId: string, pushToken: string, opts?: RegisterPushDeviceOptions): Promise<{
+        ok: boolean;
+        seq: number;
+    }>;
+    /** 디바이스 레코드의 푸시 토큰을 갱신합니다. */
+    updatePushDeviceToken(deviceSeq: number, pushToken: string, opts?: {
+        pushEnabled?: boolean;
+        transactionId?: string;
+    }): Promise<{
+        ok: boolean;
+        seq: number;
+    }>;
+    /** 디바이스의 푸시 수신을 비활성화합니다. */
+    disablePushDevice(deviceSeq: number, opts?: {
+        transactionId?: string;
+    }): Promise<{
+        ok: boolean;
+        seq: number;
+    }>;
+    /**
+     * 요청 바디를 파싱합니다.
+     * `application/octet-stream`이면 XChaCha20-Poly1305 복호화, 그 외는 JSON 파싱합니다.
+     *
+     * @param requireEncrypted `true`이면 암호화된 요청만 허용합니다.
+     */
+    readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+    private get _reqOpts();
+    private request;
+}

package/dist/client/hmac.d.ts

@@ -0,0 +1,8 @@
+/**
+ * HMAC-SHA256 서명 헤더를 생성합니다.
+ *
+ * 서명 대상: `METHOD|PATH|TIMESTAMP|NONCE|BODY`
+ *
+ * @returns `X-API-Key`, `X-Timestamp`, `X-Nonce`, `X-Signature` 헤더 객체
+ */
+export declare function buildHmacHeaders(method: string, path: string, bodyBytes: Uint8Array, apiKey: string, hmacSecret: string): Record<string, string>;

package/dist/client/packet.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 패킷 암호화 키를 유도합니다.
+ * - HMAC 모드 (`hmacSecret` 유효 시): HKDF-SHA256(hmac_secret, "entity-server:packet-encryption")
+ * - JWT 모드: SHA-256(jwt_token)
+ */
+export declare function derivePacketKey(hmacSecret: string, token: string): Uint8Array;
+/**
+ * 평문 바이트를 XChaCha20-Poly1305로 암호화합니다.
+ * 포맷: [random_magic:magicLen][random_nonce:24][ciphertext+tag]
+ */
+export declare function encryptPacket(plaintext: Uint8Array, key: Uint8Array, magicLen: number): Uint8Array;
+/**
+ * XChaCha20-Poly1305 패킷을 복호화해 JSON 객체로 변환합니다.
+ * 포맷: [magic:magicLen][nonce:24][ciphertext+tag]
+ */
+export declare function decryptPacket<T>(buffer: ArrayBuffer, key: Uint8Array, magicLen: number): T;
+/**
+ * 요청 바디를 파싱합니다. `application/octet-stream`이면 복호화, 그 외는 JSON 파싱합니다.
+ *
+ * @param requireEncrypted `true`이면 암호화된 요청만 허용합니다.
+ */
+export declare function parseRequestBody<T>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType: string, requireEncrypted: boolean, key: Uint8Array, magicLen: number): T;

package/dist/client/request.d.ts

@@ -0,0 +1,16 @@
+export interface RequestOptions {
+    baseUrl: string;
+    token: string;
+    apiKey: string;
+    hmacSecret: string;
+    packetMagicLen: number;
+    encryptRequests: boolean;
+}
+/**
+ * Entity Server에 HTTP 요청을 보냅니다.
+ *
+ * - `encryptRequests` 활성화 시 인증된 POST 바디를 자동 암호화합니다.
+ * - 응답이 `application/octet-stream`이면 자동 복호화합니다.
+ * - JSON 응답의 `ok`가 false이면 에러를 던집니다.
+ */
+export declare function entityRequest<T>(opts: RequestOptions, method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;

package/dist/client/utils.d.ts

@@ -0,0 +1,4 @@
+/** Vite 환경변수(`import.meta.env`)에서 값을 읽습니다. */
+export declare function readEnv(name: string): string | undefined;
+/** 쿼리 파라미터 객체를 URL 쿼리 문자열로 변환합니다. `orderBy` 키는 `order_by`로 변환됩니다. */
+export declare function buildQuery(params: Record<string, unknown>): string;

package/dist/index.d.ts

@@ -1,394 +1,4 @@
-/**
- * 엔티티 목록 조회 파라미터입니다.
- *
- * ```ts
- * client.list("post", {
- *   page: 1, limit: 10,
- *   orderBy: "created_time", orderDir: "DESC",
- *   fields: ["seq", "title", "created_time"],
- *   conditions: { status: "active" },
- * });
- * ```
- */
-export interface EntityListParams {
-    /** 조회 페이지 번호. 기본값: `1` */
-    page?: number;
-    /** 페이지당 레코드 수. 기본값: `20` */
-    limit?: number;
-    /** 정렬 기준 필드명 */
-    orderBy?: string;
-    /** 정렬 방향. 기본값: `"ASC"` */
-    orderDir?: "ASC" | "DESC";
-    /**
-     * 반환할 필드 목록.
-     *
-     * - **미지정 (기본값)**: 엔티티의 인덱스 필드만 반환합니다.
-     *   복호화를 건너뛰기 때문에 **가장 빠릅니다**.
-     * - `["*"]`: 전체 필드 반환 (복호화 수행).
-     * - 필드명 목록: 해당 필드만 반환합니다.
-     *   엔티티 설정에 `index`로 선언된 필드만 지정 가능합니다.
-     *   존재하지 않는 필드명을 지정하면 서버 에러가 발생합니다.
-     * - `seq`, `created_time`, `updated_time`, `license_seq`는 필드에 관계없이 항상 포함됩니다.
-     *
-     * ```ts
-     * // 기본값 (인덱스 필드만, 가장 빠름)
-     * client.list("account")
-     * // 전체 필드
-     * client.list("account", { fields: ["*"] })
-     * // seq, name, email만
-     * client.list("account", { fields: ["seq", "name", "email"] })
-     * ```
-     */
-    fields?: string[];
-    /** 필터 조건. POST body로 전달됩니다. (예: `{ status: "active" }`) */
-    conditions?: Record<string, unknown>;
-}
-/**
- * `query()` 메서드에 전달하는 SQL 쿼리 요청입니다.
- *
- * - `sql`: SELECT 전용 SQL. 인덱스 테이블만 조회 가능하며 JOIN 지원.
- * - `params`: SQL 바인딩 파라미터 (`?` 플레이스홀더 대응).
- * - `limit`: 최대 반환 건수 (최대 1000. 미지정 시 서버 기본값 적용).
- *
- * ```ts
- * client.query("order", {
- *   sql: `SELECT o.seq, o.status, u.name
- *         FROM order o
- *         JOIN account u ON u.data_seq = o.account_seq
- *         WHERE o.status = ?`,
- *   params: ["pending"],
- *   limit: 100,
- * });
- * ```
- */
-export interface EntityQueryRequest {
-    sql: string;
-    params?: unknown[];
-    limit?: number;
-}
-export interface RegisterPushDeviceOptions {
-    platform?: string;
-    deviceType?: string;
-    browser?: string;
-    browserVersion?: string;
-    pushEnabled?: boolean;
-    transactionId?: string;
-}
-/** EntityServerClient 생성/설정 옵션입니다. */
-export interface EntityServerClientOptions {
-    baseUrl?: string;
-    token?: string;
-    packetMagicLen?: number;
-    /**
-     * `true`이면 인증된 POST/PUT 요청 바디를 XChaCha20-Poly1305로 암호화합니다.
-     *
-     * 서버의 `EnablePacketEncryption`이 활성화된 경우 필수로 설정해야 합니다.
-     * 로그인(`login()`)·토큰 갱신(`refreshToken()`)은 인증 전 요청이므로 자동으로 건너뜁니다.
-     *
-     * 기본값: `false`
-     */
-    encryptRequests?: boolean;
-    /**
-     * `true`이면 `login()` 성공 후 Access Token 만료 전에 자동으로 갱신(silent refresh)합니다.
-     * 갱신 시점은 `expires_in - refreshBuffer` 초입니다.
-     *
-     * 갱신 성공 시 `onTokenRefreshed`, 실패 시 `onSessionExpired` 콜백이 호출됩니다.
-     *
-     * 기본값: `false`
-     */
-    keepSession?: boolean;
-    /**
-     * 만료 몇 초 전에 자동 갱신을 시도할지 설정합니다.
-     *
-     * 예: `expires_in = 3600`, `refreshBuffer = 60` → 3540초 후 갱신
-     *
-     * 기본값: `60`
-     */
-    refreshBuffer?: number;
-    /**
-     * 자동 갱신 성공 시 호출되는 콜백입니다.
-     * 새 `access_token`과 `expires_in`이 전달됩니다.
-     * 앱은 이 콜백에서 localStorage 등에 토큰을 저장해야 합니다.
-     */
-    onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
-    /**
-     * 세션 유지 갱신 실패 시 호출되는 콜백입니다.
-     * refresh_token 만료 등으로 재발급이 불가능한 경우입니다.
-     * 앱은 이 콜백에서 로그인 페이지로 이동하는 등의 처리를 해야 합니다.
-     */
-    onSessionExpired?: (error: Error) => void;
-    /**
-     * HMAC 인증용 API Key (`X-API-Key` 헤더).
-     * `hmacSecret`과 함께 설정하면 HMAC 인증 모드로 동작합니다.
-     * **서버 사이드(Node.js 등) 전용. 브라우저에서는 사용하지 마세요.**
-     */
-    apiKey?: string;
-    /**
-     * HMAC 인증 시크릿. `apiKey`와 함께 설정하면 HMAC 인증 모드로 동작합니다.
-     *
-     * 패킷 암호화 키도 이 값에서 HKDF-SHA256으로 유도합니다:
-     * `key = HKDF-SHA256(hmac_secret, info="entity-server:packet-encryption", salt="entity-server:hkdf:v1")`
-     *
-     * **서버 사이드(Node.js 등) 전용. 브라우저에서는 사용하지 마세요.**
-     */
-    hmacSecret?: string;
-}
-/**
- * `list()`, `history()` 응답의 `data` 필드 구조입니다.
- *
- * 서버는 항상 이 구조로 반환합니다:
- * ```json
- * { "ok": true, "data": { "items": [...], "total": 100, "page": 1, "limit": 20 } }
- * ```
- */
-export interface EntityListResult<T = unknown> {
-    items: T[];
-    /** 전체 레코드 수 */
-    total: number;
-    /** 현재 페이지 번호 */
-    page: number;
-    /** 페이지당 레코드 수 */
-    limit: number;
-}
-/**
- * `history()` 응답의 개별 이력 레코드 구조입니다.
- *
- * - `action`: `"INSERT"` | `"UPDATE"` | `"DELETE_SOFT"` | `"DELETE_HARD"` | `"ROLLBACK"`
- * - `data_snapshot`: 변경 당시 엔티티 데이터 스냅샷
- */
-export interface EntityHistoryRecord<T = unknown> {
-    seq: number;
-    action: "INSERT" | "UPDATE" | "DELETE_SOFT" | "DELETE_HARD" | "ROLLBACK" | string;
-    data_snapshot: T | null;
-    changed_by: number | null;
-    changed_time: string;
-}
-export declare class EntityServerClient {
-    private baseUrl;
-    private token;
-    private apiKey;
-    private hmacSecret;
-    private packetMagicLen;
-    private encryptRequests;
-    private activeTxId;
-    private keepSession;
-    private refreshBuffer;
-    private onTokenRefreshed?;
-    private onSessionExpired?;
-    private _sessionRefreshToken;
-    private _refreshTimer;
-    /**
-     * EntityServerClient 인스턴스를 생성합니다.
-     *
-     * 기본값:
-     * - `baseUrl`: `VITE_ENTITY_SERVER_URL` 또는 `http://localhost:47200`
-     * - `packetMagicLen`: `VITE_ENTITY_SERVER_PACKET_MAGIC_LEN` 또는 `4`
-     */
-    constructor(options?: EntityServerClientOptions);
-    /** baseUrl, token, packetMagicLen, encryptRequests 값을 런타임에 갱신합니다. */
-    configure(options: Partial<EntityServerClientOptions>): void;
-    /** 인증 요청에 사용할 JWT Access Token을 설정합니다. */
-    setToken(token: string): void;
-    /** HMAC 인증용 API Key를 설정합니다. */
-    setApiKey(apiKey: string): void;
-    /** HMAC 인증용 시크릿을 설정합니다. */
-    setHmacSecret(secret: string): void;
-    /** 암호화 패킷 magic 길이(`packet_magic_len`)를 설정합니다. */
-    setPacketMagicLen(length: number): void;
-    /** 현재 암호화 패킷 magic 길이를 반환합니다. */
-    getPacketMagicLen(): number;
-    /**
-     * 자동 토큰 갱신 타이머를 시작합니다.
-     * @param refreshToken 갱신에 사용할 Refresh Token
-     * @param expiresIn Access Token의 유효 기간 (초)
-     */
-    private _scheduleKeepSession;
-    /** 자동 갱신 타이머를 정리합니다. */
-    private _clearRefreshTimer;
-    /**
-     * 세션 유지 타이머를 중지합니다.
-     * `logout()` 호출 시 자동으로 중지되므로 직접 호출이 필요한 경우는 드뭅니다.
-     */
-    stopKeepSession(): void;
-    /**
-     * 서버 헬스 체크를 수행하고 패킷 암호화 활성 여부를 자동으로 감지합니다.
-     *
-     * 서버가 `packet_encryption: true`를 응답하면 이후 모든 요청에 암호화가 자동 적용됩니다.
-     * 초기화 직후 또는 로그인 전에 호출하면 암호화 설정을 자동으로 구성할 수 있습니다.
-     *
-     * ```ts
-     * await client.checkHealth();
-     * await client.login(email, password); // 이후 요청은 암호화 자동 적용
-     * ```
-     *
-     * @returns `{ ok: true }` 또는 `{ ok: true, packet_encryption: true }`
-     */
-    checkHealth(): Promise<{
-        ok: boolean;
-        packet_encryption?: boolean;
-    }>;
-    /** 로그인 후 `access_token`을 내부 상태에 저장합니다. */
-    login(email: string, password: string): Promise<{
-        access_token: string;
-        refresh_token: string;
-        expires_in: number;
-    }>;
-    /** Refresh Token으로 Access Token을 재발급받아 내부 토큰을 교체합니다. */
-    refreshToken(refreshToken: string): Promise<{
-        access_token: string;
-        expires_in: number;
-    }>;
-    /**
-     * 서버에 로그아웃을 요청하고 내부 토큰을 초기화합니다.
-     * refresh_token을 서버에 전달해 무효화합니다.
-     */
-    logout(refreshToken: string): Promise<{
-        ok: boolean;
-    }>;
-    /** 트랜잭션을 시작하고 활성 트랜잭션 ID를 저장합니다. */
-    transStart(): Promise<string>;
-    /** 활성 트랜잭션(또는 전달된 transactionId)을 롤백합니다. */
-    transRollback(transactionId?: string): Promise<{
-        ok: boolean;
-    }>;
-    /** 활성 트랜잭션(또는 전달된 transactionId)을 커밋합니다.
-     *
-     * @returns `results` 배열: commit된 각 작업의 `entity`, `action`, `seq`
-     */
-    transCommit(transactionId?: string): Promise<{
-        ok: boolean;
-        results: Array<{
-            entity: string;
-            action: string;
-            seq: number;
-        }>;
-    }>;
-    /** 시퀀스 ID로 엔티티 단건을 조회합니다. */
-    get<T = unknown>(entity: string, seq: number, opts?: {
-        skipHooks?: boolean;
-    }): Promise<{
-        ok: boolean;
-        data: T;
-    }>;
-    /** 조건으로 엔티티 단건을 조회합니다. data 컬럼을 완전히 복호화하여 반환합니다. */
-    find<T = unknown>(entity: string, conditions?: Record<string, unknown>, opts?: {
-        skipHooks?: boolean;
-    }): Promise<{
-        ok: boolean;
-        data: T;
-    }>;
-    /** 페이지네이션/정렬/필터 조건으로 엔티티 목록을 조회합니다. */
-    list<T = unknown>(entity: string, params?: EntityListParams): Promise<{
-        ok: boolean;
-        data: EntityListResult<T>;
-    }>;
-    /**
-     * 엔티티 총 건수를 조회합니다.
-     *
-     * @param conditions 필터 조건 (예: `{ status: "active" }`)
-     */
-    count(entity: string, conditions?: Record<string, unknown>): Promise<{
-        ok: boolean;
-        count: number;
-    }>;
-    /**
-     * 커스텀 SQL로 엔티티를 조회합니다.
-     *
-     * SELECT 전용이며 인덱스 테이블만 조회 가능합니다.
-     * JOIN을 사용해 여러 엔티티를 조합할 수 있습니다.
-     * `entity`는 SQL에 포함된 기본 엔티티명(라우트 경로용)입니다.
-     */
-    query<T = unknown>(entity: string, req: EntityQueryRequest): Promise<{
-        ok: boolean;
-        data: {
-            items: T[];
-            count: number;
-        };
-    }>;
-    /** 엔티티 데이터를 생성/수정(Submit)합니다. `seq`가 없으면 INSERT, 있으면 UPDATE입니다. */
-    submit(entity: string, data: Record<string, unknown>, opts?: {
-        transactionId?: string;
-        skipHooks?: boolean;
-    }): Promise<{
-        ok: boolean;
-        seq: number;
-    }>;
-    /** 시퀀스 ID로 엔티티를 삭제합니다(`hard=true`면 하드 삭제, 기본은 소프트 삭제). */
-    delete(entity: string, seq: number, opts?: {
-        transactionId?: string;
-        hard?: boolean;
-        skipHooks?: boolean;
-    }): Promise<{
-        ok: boolean;
-        deleted: number;
-    }>;
-    /** 엔티티 단건의 변경 이력을 조회합니다. 이력 항목당 `action`, `data_snapshot`, `changed_by`, `changed_time`을 포함합니다. */
-    history<T = unknown>(entity: string, seq: number, params?: Pick<EntityListParams, "page" | "limit">): Promise<{
-        ok: boolean;
-        data: EntityListResult<EntityHistoryRecord<T>>;
-    }>;
-    /** 특정 이력 시점으로 엔티티를 롤백합니다. */
-    rollback(entity: string, historySeq: number): Promise<{
-        ok: boolean;
-    }>;
-    /** 푸시 관련 엔티티로 payload를 전송(Submit)합니다. */
-    push(pushEntity: string, payload: Record<string, unknown>, opts?: {
-        transactionId?: string;
-    }): Promise<{
-        ok: boolean;
-        seq: number;
-    }>;
-    /** 푸시 로그 엔티티 목록을 조회합니다. */
-    pushLogList<T = unknown>(params?: EntityListParams): Promise<{
-        ok: boolean;
-        data: EntityListResult<T>;
-    }>;
-    /** 계정의 푸시 디바이스를 등록합니다. */
-    registerPushDevice(accountSeq: number, deviceId: string, pushToken: string, opts?: RegisterPushDeviceOptions): Promise<{
-        ok: boolean;
-        seq: number;
-    }>;
-    /** 디바이스 레코드의 푸시 토큰을 갱신합니다. */
-    updatePushDeviceToken(deviceSeq: number, pushToken: string, opts?: {
-        pushEnabled?: boolean;
-        transactionId?: string;
-    }): Promise<{
-        ok: boolean;
-        seq: number;
-    }>;
-    /** 디바이스의 푸시 수신을 비활성화합니다. */
-    disablePushDevice(deviceSeq: number, opts?: {
-        transactionId?: string;
-    }): Promise<{
-        ok: boolean;
-        seq: number;
-    }>;
-    /**
-     * 요청 바디를 파싱하고 `application/octet-stream`인 경우 복호화합니다.
-     *
-     * 원시 암호화 payload를 직접 다루는 클라이언트에서 사용합니다.
-     */
-    readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
-    /**
-     * 공통 HTTP 요청 함수입니다.
-     *
-     * - `encryptRequests`가 활성화된 인증 요청의 POST 바디를 자동 암호화합니다.
-     * - 응답이 `application/octet-stream`이면 자동 복호화합니다.
-     * - JSON 응답의 `ok`가 false이면 에러를 던집니다.
-     */
-    private request;
-    /**
-     * 패킷 암호화 키를 유도합니다.
-     * - HMAC 모드 (`hmacSecret` 설정 시): HKDF-SHA256(hmac_secret, "entity-server:packet-encryption")
-     * - JWT 모드: sha256(jwt_token)
-     */
-    private derivePacketKey;
-    /**
-     * 평문 바이트를 XChaCha20-Poly1305로 암호화합니다.
-     * 포맷: [random_magic:packetMagicLen][random_nonce:24][ciphertext+tag]
-     */
-    private encryptPacket;
-    /** 서버의 암호화 패킷을 복호화해 JSON 객체로 변환합니다. */
-    private decryptPacket;
-}
+export * from "./types";
+export * from "./EntityServerClient";
+import { EntityServerClient } from "./EntityServerClient";
 export declare const entityServer: EntityServerClient;