entity-server-client 0.2.4 → 0.2.6

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 {};

package/dist/mixins/sms.d.ts

@@ -0,0 +1,55 @@
+import type { SmsSendRequest } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+export declare function SmsMixin<TBase extends GConstructor<EntityServerClientBase>>(Base: TBase): {
+    new (...args: any[]): {
+        /** SMS를 발송합니다. */
+        smsSend(req: SmsSendRequest): Promise<{
+            ok: boolean;
+            seq: number;
+        }>;
+        /** SMS 발송 상태를 조회합니다. */
+        smsStatus(seq: number): Promise<{
+            ok: boolean;
+            status: string;
+        }>;
+        /** SMS 인증 코드를 발송합니다. */
+        smsVerificationSend(phone: string, opts?: {
+            purpose?: string;
+        }): Promise<{
+            ok: boolean;
+        }>;
+        /** SMS 인증 코드를 검증합니다. */
+        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("..").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/smtp.d.ts

@@ -0,0 +1,44 @@
+import type { SmtpSendRequest } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+export declare function SmtpMixin<TBase extends GConstructor<EntityServerClientBase>>(Base: TBase): {
+    new (...args: any[]): {
+        /** SMTP로 메일을 발송합니다. */
+        smtpSend(req: SmtpSendRequest): Promise<{
+            ok: boolean;
+            seq: number;
+        }>;
+        /** SMTP 발송 상태를 조회합니다. */
+        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("..").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/utils.d.ts

@@ -0,0 +1,70 @@
+import type { QRCodeOptions, BarcodeOptions } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+export declare function UtilsMixin<TBase extends GConstructor<EntityServerClientBase>>(Base: TBase): {
+    new (...args: any[]): {
+        /**
+         * QR 코드 PNG를 생성합니다. `ArrayBuffer`를 반환합니다.
+         *
+         * ```ts
+         * const buf = await client.qrcode("https://example.com");
+         * const blob = new Blob([buf], { type: "image/png" });
+         * img.src = URL.createObjectURL(blob);
+         * ```
+         */
+        qrcode(content: string, opts?: QRCodeOptions): Promise<ArrayBuffer>;
+        /**
+         * QR 코드를 base64/data URI JSON으로 반환합니다.
+         *
+         * ```ts
+         * const { data_uri } = await client.qrcodeBase64("https://example.com");
+         * img.src = data_uri;
+         * ```
+         */
+        qrcodeBase64(content: string, opts?: QRCodeOptions): Promise<{
+            ok: boolean;
+            data: string;
+            data_uri: string;
+        }>;
+        /** QR 코드를 ASCII 아트 텍스트로 반환합니다. */
+        qrcodeText(content: string, opts?: QRCodeOptions): Promise<{
+            ok: boolean;
+            text: string;
+        }>;
+        /**
+         * 바코드 PNG를 생성합니다. `ArrayBuffer`를 반환합니다.
+         *
+         * ```ts
+         * const buf = await client.barcode("1234567890128", { type: "ean13" });
+         * ```
+         */
+        barcode(content: string, opts?: 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("..").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;