entity-server-client 0.2.5 → 0.2.6

package/dist/mixins/auth.d.ts

@@ -0,0 +1,167 @@
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+export declare function AuthMixin<TBase extends GConstructor<EntityServerClientBase>>(Base: TBase): {
+    new (...args: any[]): {
+        /**
+         * 서버 헬스 체크를 수행하고 패킷 암호화 활성 여부를 자동으로 감지합니다.
+         *
+         * 서버가 `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;
+        }>;
+        /** 현재 로그인된 사용자 정보를 반환합니다. */
+        me<T = Record<string, unknown>>(): Promise<{
+            ok: boolean;
+            data: T;
+        }>;
+        /** 비밀번호를 변경합니다. */
+        changePassword(currentPasswd: string, newPasswd: string): Promise<{
+            ok: boolean;
+        }>;
+        /** 회원 탈퇴를 요청합니다. */
+        withdraw(passwd?: string): Promise<{
+            ok: boolean;
+        }>;
+        /**
+         * 휴면 계정을 재활성화합니다.
+         * 비밀번호 또는 OAuth(provider + code)로 본인 확인합니다.
+         */
+        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;
+        }>;
+        /** OAuth 프로바이더를 현재 계정에 연동합니다. */
+        oauthLink(provider: string, code: string, state?: string): Promise<{
+            ok: boolean;
+            message: string;
+            provider: string;
+        }>;
+        /** OAuth 프로바이더 연동을 해제합니다. */
+        oauthUnlink(provider: string): Promise<{
+            ok: boolean;
+            message: string;
+            provider: string;
+        }>;
+        /** 현재 계정에 연동된 OAuth 프로바이더 목록을 반환합니다. */
+        oauthProviders(): Promise<{
+            ok: boolean;
+            data: Array<{
+                provider: string;
+                email?: string;
+                linked_at?: string;
+            }>;
+        }>;
+        /** 특정 OAuth 프로바이더의 액세스 토큰을 갱신합니다. */
+        oauthTokenRefresh(provider: string): Promise<{
+            ok: boolean;
+            access_token: string;
+            expires_at?: string;
+        }>;
+        /** 2FA 설정을 시작하고 QR 코드 / 시크릿을 반환합니다. */
+        twoFactorSetup(): Promise<{
+            ok: boolean;
+            setup_token: string;
+            qr_url: string;
+            secret: string;
+        }>;
+        /** TOTP 코드로 2FA 설정을 완료합니다. */
+        twoFactorSetupVerify(code: string, setupToken: string): Promise<{
+            ok: boolean;
+            recovery_codes: string[];
+        }>;
+        /** 2FA를 비활성화합니다. */
+        twoFactorDisable(code: string): Promise<{
+            ok: boolean;
+        }>;
+        /** 2FA 활성화 여부를 조회합니다. */
+        twoFactorStatus(): Promise<{
+            ok: boolean;
+            enabled: boolean;
+        }>;
+        /** 임시 토큰으로 TOTP 코드를 검증하여 최종 JWT를 발급받습니다. */
+        twoFactorVerify(twoFactorToken: string, code: string): Promise<{
+            ok: boolean;
+            access_token: string;
+            refresh_token: string;
+            expires_in: number;
+        }>;
+        /** 복구 코드로 2FA를 우회하여 최종 JWT를 발급받습니다. */
+        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("..").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>;
+    };
+} & TBase;

package/dist/mixins/email.d.ts

@@ -0,0 +1,51 @@
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+export declare function EmailMixin<TBase extends GConstructor<EntityServerClientBase>>(Base: TBase): {
+    new (...args: any[]): {
+        /** 이메일 인증 코드 또는 링크를 발송합니다. */
+        emailVerificationSend(email: string): Promise<{
+            ok: boolean;
+        }>;
+        /** 이메일 인증 코드를 확인합니다. */
+        emailVerificationConfirm(token: string): Promise<{
+            ok: boolean;
+        }>;
+        /** 현재 계정의 이메일 인증 상태를 조회합니다. (JWT 필요) */
+        emailVerificationStatus(): Promise<{
+            ok: boolean;
+            verified: boolean;
+            email?: string;
+        }>;
+        /** 이메일 주소를 변경합니다. (JWT + 인증 코드 필요) */
+        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("..").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>;
+    };
+} & TBase;

package/dist/mixins/entity.d.ts

@@ -0,0 +1,119 @@
+import type { EntityHistoryRecord, EntityListParams, EntityListResult, EntityQueryRequest } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+export declare function EntityMixin<TBase extends GConstructor<EntityServerClientBase>>(Base: TBase): {
+    new (...args: any[]): {
+        /** 트랜잭션을 시작하고 활성 트랜잭션 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;
+        }>;
+        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("..").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>;
+    };
+} & TBase;

package/dist/mixins/file.d.ts

@@ -0,0 +1,78 @@
+import type { FileMeta, FileUploadOptions } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+export declare function FileMixin<TBase extends GConstructor<EntityServerClientBase>>(Base: TBase): {
+    new (...args: any[]): {
+        /**
+         * 파일을 업로드합니다. (multipart/form-data)
+         *
+         * ```ts
+         * const input = document.querySelector('input[type="file"]');
+         * const result = await client.fileUpload("product", input.files[0]);
+         * console.log(result.data.uuid);
+         * ```
+         */
+        fileUpload(entity: string, file: File | Blob, opts?: FileUploadOptions): Promise<{
+            ok: boolean;
+            uuid: string;
+            data: FileMeta;
+        }>;
+        /** 파일을 다운로드합니다. `ArrayBuffer`를 반환합니다. */
+        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: FileMeta[];
+                total: number;
+            };
+        }>;
+        /** 파일 메타 정보를 조회합니다. */
+        fileMeta(entity: string, uuid: string): Promise<{
+            ok: boolean;
+            data: FileMeta;
+        }>;
+        /** 임시 파일 접근 토큰을 발급합니다. */
+        fileToken(uuid: string): Promise<{
+            ok: boolean;
+            token: string;
+        }>;
+        /** 파일 인라인 뷰 URL을 반환합니다. (fetch 없음, URL 조합만) */
+        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("..").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>;
+    };
+} & TBase;

package/dist/mixins/identity.d.ts

@@ -0,0 +1,52 @@
+import type { IdentityRequestOptions } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+export declare function IdentityMixin<TBase extends GConstructor<EntityServerClientBase>>(Base: TBase): {
+    new (...args: any[]): {
+        /** 본인인증 요청을 생성합니다. */
+        identityRequest(opts: IdentityRequestOptions): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        /** 본인인증 결과를 조회합니다. */
+        identityResult(requestId: string): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        /** CI 해시 중복 여부를 확인합니다. */
+        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("..").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>;
+    };
+} & TBase;

package/dist/mixins/pg.d.ts

@@ -0,0 +1,63 @@
+import type { PgCreateOrderRequest, PgConfirmPaymentRequest, PgCancelPaymentRequest } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+export declare function PgMixin<TBase extends GConstructor<EntityServerClientBase>>(Base: TBase): {
+    new (...args: any[]): {
+        /** 결제 주문을 생성합니다. */
+        pgCreateOrder(req: PgCreateOrderRequest): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        /** 주문 정보를 조회합니다. */
+        pgGetOrder(orderId: string): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        /** 결제를 승인합니다. */
+        pgConfirmPayment(req: PgConfirmPaymentRequest): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        /** 결제를 취소합니다. */
+        pgCancelPayment(orderId: string, req: PgCancelPaymentRequest): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }>;
+        /** 결제 상태를 외부 PG와 동기화합니다. */
+        pgSyncPayment(orderId: string): Promise<{
+            ok: boolean;
+        }>;
+        /** 클라이언트 SDK 설정을 반환합니다 (공개 API, 인증 불필요). */
+        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("..").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>;
+    };
+} & TBase;

package/dist/mixins/push.d.ts

@@ -0,0 +1,110 @@
+import type { EntityListParams, EntityListResult, RegisterPushDeviceOptions, PushSendRequest, PushSendAllRequest } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+type WithSubmit = EntityServerClientBase & {
+    submit(entity: string, data: Record<string, unknown>, opts?: {
+        transactionId?: string;
+        skipHooks?: boolean;
+    }): Promise<{
+        ok: boolean;
+        seq: number;
+    }>;
+    list<T = unknown>(entity: string, params?: EntityListParams): Promise<{
+        ok: boolean;
+        data: EntityListResult<T>;
+    }>;
+};
+export declare function PushMixin<TBase extends GConstructor<WithSubmit>>(Base: TBase): {
+    new (...args: any[]): {
+        /**
+         * 푸시 관련 엔티티로 payload를 전송(Submit)합니다.
+         * 내부적으로 `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;
+        }>;
+        /** 특정 계정에 푸시 알림을 발송합니다. */
+        pushSend(req: PushSendRequest): Promise<{
+            ok: boolean;
+            seq: number;
+        }>;
+        /** 전체 사용자에게 푸시 알림을 발송합니다. */
+        pushSendAll(req: 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("..").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?: EntityListParams): Promise<{
+            ok: boolean;
+            data: EntityListResult<T>;
+        }>;
+    };
+} & TBase;
+export {};