entity-server-client 0.2.5 → 0.2.6

package/dist/EntityServerClient.d.ts

@@ -1,203 +1,709 @@
-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;
+/**
+ * @file EntityServerClient.ts
+ * Mixin 패턴으로 구성된 EntityServerClient.
+ *
+ * 절(section)별 구현:
+ *   src/client/base.ts      — 상태·생성자·공통 헬퍼
+ *   src/mixins/auth.ts      — 인증 (로그인/로그아웃/2FA/OAuth 등)
+ *   src/mixins/entity.ts    — 트랜잭션 & 엔티티 CRUD
+ *   src/mixins/push.ts      — 푸시 디바이스 관리 & 발송
+ *   src/mixins/email.ts     — 이메일 인증/변경
+ *   src/mixins/sms.ts       — SMS 발송/인증
+ *   src/mixins/smtp.ts      — SMTP 메일 발송
+ *   src/mixins/alimtalk.ts  — 알림톡/친구톡
+ *   src/mixins/pg.ts        — PG 결제 게이트웨이
+ *   src/mixins/file.ts      — 파일 스토리지
+ *   src/mixins/identity.ts  — 본인인증
+ *   src/mixins/utils.ts     — QR코드/바코드
+ */
+import { EntityServerClientBase } from "./client/base";
+declare const EntityServerClient_base: {
+    new (...args: any[]): {
+        qrcode(content: string, opts?: import("./types").QRCodeOptions): Promise<ArrayBuffer>;
+        qrcodeBase64(content: string, opts?: import("./types").QRCodeOptions): Promise<{
+            ok: boolean;
+            data: string;
+            data_uri: string;
+        }>;
+        qrcodeText(content: string, opts?: import("./types").QRCodeOptions): Promise<{
+            ok: boolean;
+            text: string;
+        }>;
+        barcode(content: string, opts?: import("./types").BarcodeOptions): Promise<ArrayBuffer>;
+        baseUrl: string;
+        token: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        configure(options: Partial<import("./types").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request").RequestOptions;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+    };
+} & {
+    new (...args: any[]): {
+        identityRequest(opts: import("./types").IdentityRequestOptions): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        identityResult(requestId: string): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        identityVerifyCI(ciHash: string): Promise<{
+            ok: boolean;
+            data: {
+                exists: boolean;
+                account_seq?: number;
+            };
+        }>;
+        baseUrl: string;
+        token: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        configure(options: Partial<import("./types").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request").RequestOptions;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+    };
+} & {
+    new (...args: any[]): {
+        fileUpload(entity: string, file: File | Blob, opts?: import("./types").FileUploadOptions): Promise<{
+            ok: boolean;
+            uuid: string;
+            data: import("./types").FileMeta;
+        }>;
+        fileDownload(entity: string, uuid: string): Promise<ArrayBuffer>;
+        fileDelete(entity: string, uuid: string): Promise<{
+            ok: boolean;
+            uuid: string;
+            deleted: boolean;
+        }>;
+        fileList(entity: string, opts?: {
+            refSeq?: number;
+        }): Promise<{
+            ok: boolean;
+            data: {
+                items: import("./types").FileMeta[];
+                total: number;
+            };
+        }>;
+        fileMeta(entity: string, uuid: string): Promise<{
+            ok: boolean;
+            data: import("./types").FileMeta;
+        }>;
+        fileToken(uuid: string): Promise<{
+            ok: boolean;
+            token: string;
+        }>;
+        fileUrl(uuid: string): string;
+        baseUrl: string;
+        token: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        configure(options: Partial<import("./types").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request").RequestOptions;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+    };
+} & {
+    new (...args: any[]): {
+        pgCreateOrder(req: import("./types").PgCreateOrderRequest): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        pgGetOrder(orderId: string): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        pgConfirmPayment(req: import("./types").PgConfirmPaymentRequest): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        pgCancelPayment(orderId: string, req: import("./types").PgCancelPaymentRequest): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        pgSyncPayment(orderId: string): Promise<{
+            ok: boolean;
+        }>;
+        pgConfig(): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        baseUrl: string;
+        token: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        configure(options: Partial<import("./types").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request").RequestOptions;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+    };
+} & {
+    new (...args: any[]): {
+        alimtalkSend(req: import("./types").AlimtalkSendRequest): Promise<{
+            message: string;
+        }>;
+        alimtalkStatus(seq: number): Promise<{
+            ok: boolean;
+            status: string;
+        }>;
+        alimtalkTemplates(): Promise<{
+            templates: {
+                code: string;
+                name: string;
+                content: string;
+            }[];
+            count: number;
+        }>;
+        friendtalkSend(req: import("./types").FriendtalkSendRequest): Promise<{
+            message: string;
+        }>;
+        baseUrl: string;
+        token: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        configure(options: Partial<import("./types").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request").RequestOptions;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+    };
+} & {
+    new (...args: any[]): {
+        smtpSend(req: import("./types").SmtpSendRequest): Promise<{
+            ok: boolean;
+            seq: number;
+        }>;
+        smtpStatus(seq: number): Promise<{
+            ok: boolean;
+            status: string;
+        }>;
+        baseUrl: string;
+        token: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        configure(options: Partial<import("./types").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request").RequestOptions;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+    };
+} & {
+    new (...args: any[]): {
+        smsSend(req: import("./types").SmsSendRequest): Promise<{
+            ok: boolean;
+            seq: number;
+        }>;
+        smsStatus(seq: number): Promise<{
+            ok: boolean;
+            status: string;
+        }>;
+        smsVerificationSend(phone: string, opts?: {
+            purpose?: string;
+        }): Promise<{
+            ok: boolean;
+        }>;
+        smsVerificationVerify(phone: string, code: string): Promise<{
+            ok: boolean;
+            verified: boolean;
+        }>;
+        baseUrl: string;
+        token: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        configure(options: Partial<import("./types").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request").RequestOptions;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+    };
+} & {
+    new (...args: any[]): {
+        emailVerificationSend(email: string): Promise<{
+            ok: boolean;
+        }>;
+        emailVerificationConfirm(token: string): Promise<{
+            ok: boolean;
+        }>;
+        emailVerificationStatus(): Promise<{
+            ok: boolean;
+            verified: boolean;
+            email?: string;
+        }>;
+        emailChange(newEmail: string, code?: string): Promise<{
+            ok: boolean;
+        }>;
+        baseUrl: string;
+        token: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        configure(options: Partial<import("./types").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request").RequestOptions;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+    };
+} & {
+    new (...args: any[]): {
+        push(pushEntity: string, payload: Record<string, unknown>, opts?: {
+            transactionId?: string;
+        }): Promise<{
+            ok: boolean;
+            seq: number;
+        }>;
+        pushLogList<T = unknown>(params?: import("./types").EntityListParams): Promise<{
+            ok: boolean;
+            data: import("./types").EntityListResult<T>;
+        }>;
+        registerPushDevice(accountSeq: number, deviceId: string, pushToken: string, opts?: import("./types").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;
         }>;
-    }>;
-    /** 시퀀스 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[];
+        pushSend(req: import("./types").PushSendRequest): Promise<{
+            ok: boolean;
+            seq: number;
+        }>;
+        pushSendAll(req: import("./types").PushSendAllRequest): Promise<{
+            ok: boolean;
+            sent: number;
+            failed: number;
+        }>;
+        pushStatus(seq: number): Promise<{
+            ok: boolean;
+            status: string;
+        }>;
+        baseUrl: string;
+        token: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        configure(options: Partial<import("./types").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request").RequestOptions;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+        submit(entity: string, data: Record<string, unknown>, opts?: {
+            transactionId?: string;
+            skipHooks?: boolean;
+        }): Promise<{
+            ok: boolean;
+            seq: number;
+        }>;
+        list<T = unknown>(entity: string, params?: import("./types").EntityListParams): Promise<{
+            ok: boolean;
+            data: import("./types").EntityListResult<T>;
+        }>;
+    };
+} & {
+    new (...args: any[]): {
+        transStart(): Promise<string>;
+        transRollback(transactionId?: string): Promise<{
+            ok: boolean;
+        }>;
+        transCommit(transactionId?: string): Promise<{
+            ok: boolean;
+            results: {
+                entity: string;
+                action: string;
+                seq: number;
+            }[];
+        }>;
+        get<T = unknown>(entity: string, seq: number, opts?: {
+            skipHooks?: boolean;
+        }): Promise<{
+            ok: boolean;
+            data: T;
+        }>;
+        find<T = unknown>(entity: string, conditions?: Record<string, unknown>, opts?: {
+            skipHooks?: boolean;
+        }): Promise<{
+            ok: boolean;
+            data: T;
+        }>;
+        list<T = unknown>(entity: string, params?: import("./types").EntityListParams): Promise<{
+            ok: boolean;
+            data: import("./types").EntityListResult<T>;
+        }>;
+        count(entity: string, conditions?: Record<string, unknown>): Promise<{
+            ok: boolean;
             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;
+        }>;
+        query<T = unknown>(entity: string, req: import("./types").EntityQueryRequest): Promise<{
+            ok: boolean;
+            data: {
+                items: T[];
+                count: number;
+            };
+        }>;
+        submit(entity: string, data: Record<string, unknown>, opts?: {
+            transactionId?: string;
+            skipHooks?: boolean;
+        }): Promise<{
+            ok: boolean;
+            seq: number;
+        }>;
+        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<import("./types").EntityListParams, "page" | "limit">): Promise<{
+            ok: boolean;
+            data: import("./types").EntityListResult<import("./types").EntityHistoryRecord<T>>;
+        }>;
+        rollback(entity: string, historySeq: number): Promise<{
+            ok: boolean;
+        }>;
+        baseUrl: string;
+        token: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        configure(options: Partial<import("./types").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request").RequestOptions;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+    };
+} & {
+    new (...args: any[]): {
+        checkHealth(): Promise<{
+            ok: boolean;
+            packet_encryption?: boolean;
+        }>;
+        login(email: string, password: string): Promise<{
+            access_token: string;
+            refresh_token: string;
+            expires_in: number;
+        }>;
+        refreshToken(refreshToken: string): Promise<{
+            access_token: string;
+            expires_in: number;
+        }>;
+        logout(refreshToken: string): Promise<{
+            ok: boolean;
+        }>;
+        me<T = Record<string, unknown>>(): Promise<{
+            ok: boolean;
+            data: T;
+        }>;
+        changePassword(currentPasswd: string, newPasswd: string): Promise<{
+            ok: boolean;
+        }>;
+        withdraw(passwd?: string): Promise<{
+            ok: boolean;
+        }>;
+        reactivate(params: {
+            email: string;
+            passwd?: string;
+            provider?: string;
+            code?: string;
+        }): Promise<{
+            access_token: string;
+            refresh_token: string;
+            expires_in: number;
+        }>;
+        passwordResetRequest(email: string): Promise<{
+            ok: boolean;
+        }>;
+        passwordResetConfirm(token: string, newPasswd: string): Promise<{
+            ok: boolean;
+        }>;
+        oauthLink(provider: string, code: string, state?: string): Promise<{
+            ok: boolean;
+            message: string;
+            provider: string;
+        }>;
+        oauthUnlink(provider: string): Promise<{
+            ok: boolean;
+            message: string;
+            provider: string;
+        }>;
+        oauthProviders(): Promise<{
+            ok: boolean;
+            data: {
+                provider: string;
+                email?: string;
+                linked_at?: string;
+            }[];
+        }>;
+        oauthTokenRefresh(provider: string): Promise<{
+            ok: boolean;
+            access_token: string;
+            expires_at?: string;
+        }>;
+        twoFactorSetup(): Promise<{
+            ok: boolean;
+            setup_token: string;
+            qr_url: string;
+            secret: string;
+        }>;
+        twoFactorSetupVerify(code: string, setupToken: string): Promise<{
+            ok: boolean;
+            recovery_codes: string[];
+        }>;
+        twoFactorDisable(code: string): Promise<{
+            ok: boolean;
+        }>;
+        twoFactorStatus(): Promise<{
+            ok: boolean;
+            enabled: boolean;
+        }>;
+        twoFactorVerify(twoFactorToken: string, code: string): Promise<{
+            ok: boolean;
+            access_token: string;
+            refresh_token: string;
+            expires_in: number;
+        }>;
+        twoFactorRecovery(twoFactorToken: string, recoveryCode: string): Promise<{
+            ok: boolean;
+            access_token: string;
+            refresh_token: string;
+            expires_in: number;
+        }>;
+        twoFactorRegenerateRecovery(code: string): Promise<{
+            ok: boolean;
+            recovery_codes: string[];
+        }>;
+        baseUrl: string;
+        token: string;
+        apiKey: string;
+        hmacSecret: string;
+        encryptRequests: boolean;
+        activeTxId: string | null;
+        keepSession: boolean;
+        refreshBuffer: number;
+        onTokenRefreshed?: (accessToken: string, expiresIn: number) => void;
+        onSessionExpired?: (error: Error) => void;
+        _sessionRefreshToken: string | null;
+        _refreshTimer: ReturnType<typeof setTimeout> | null;
+        configure(options: Partial<import("./types").EntityServerClientOptions>): void;
+        setToken(token: string): void;
+        setApiKey(apiKey: string): void;
+        setHmacSecret(secret: string): void;
+        setEncryptRequests(value: boolean): void;
+        _scheduleKeepSession(refreshToken: string, expiresIn: number, refreshFn: (rt: string) => Promise<{
+            access_token: string;
+            expires_in: number;
+        }>): void;
+        _clearRefreshTimer(): void;
+        stopKeepSession(): void;
+        readRequestBody<T = Record<string, unknown>>(body: ArrayBuffer | Uint8Array | string | T | null | undefined, contentType?: string, requireEncrypted?: boolean): T;
+        get _reqOpts(): import("./client/request").RequestOptions;
+        _request<T>(method: string, path: string, body?: unknown, withAuth?: boolean, extraHeaders?: Record<string, string>): Promise<T>;
+        _requestBinary(method: string, path: string, body?: unknown, withAuth?: boolean): Promise<ArrayBuffer>;
+        _requestForm<T>(method: string, path: string, form: FormData, withAuth?: boolean): Promise<T>;
+    };
+} & typeof EntityServerClientBase;
+export declare class EntityServerClient extends EntityServerClient_base {
 }
+export {};