entity-server-client 0.2.4 → 0.2.6

package/src/mixins/identity.ts

@@ -0,0 +1,35 @@
+import type { IdentityRequestOptions } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+
+export function IdentityMixin<
+    TBase extends GConstructor<EntityServerClientBase>,
+>(Base: TBase) {
+    return class IdentityMixinClass extends Base {
+        // ─── 본인인증 ─────────────────────────────────────────────────────────
+
+        /** 본인인증 요청을 생성합니다. */
+        identityRequest(
+            opts: IdentityRequestOptions,
+        ): Promise<{ ok: boolean; data: Record<string, unknown> }> {
+            return this._request("POST", "/v1/identity/request", opts);
+        }
+
+        /** 본인인증 결과를 조회합니다. */
+        identityResult(requestId: string): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }> {
+            return this._request("GET", `/v1/identity/result/${requestId}`);
+        }
+
+        /** CI 해시 중복 여부를 확인합니다. */
+        identityVerifyCI(ciHash: string): Promise<{
+            ok: boolean;
+            data: { exists: boolean; account_seq?: number };
+        }> {
+            return this._request("POST", "/v1/identity/verify-ci", {
+                ci_hash: ciHash,
+            });
+        }
+    };
+}

package/src/mixins/pg.ts

@@ -0,0 +1,58 @@
+import type {
+    PgCreateOrderRequest,
+    PgConfirmPaymentRequest,
+    PgCancelPaymentRequest,
+} from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+
+export function PgMixin<TBase extends GConstructor<EntityServerClientBase>>(
+    Base: TBase,
+) {
+    return class PgMixinClass extends Base {
+        // ─── PG(결제 게이트웨이) ──────────────────────────────────────────────
+
+        /** 결제 주문을 생성합니다. */
+        pgCreateOrder(
+            req: PgCreateOrderRequest,
+        ): Promise<{ ok: boolean; data: Record<string, unknown> }> {
+            return this._request("POST", "/v1/pg/orders", req);
+        }
+
+        /** 주문 정보를 조회합니다. */
+        pgGetOrder(orderId: string): Promise<{
+            ok: boolean;
+            data: Record<string, unknown>;
+        }> {
+            return this._request("GET", `/v1/pg/orders/${orderId}`);
+        }
+
+        /** 결제를 승인합니다. */
+        pgConfirmPayment(
+            req: PgConfirmPaymentRequest,
+        ): Promise<{ ok: boolean; data: Record<string, unknown> }> {
+            return this._request("POST", "/v1/pg/confirm", req);
+        }
+
+        /** 결제를 취소합니다. */
+        pgCancelPayment(
+            orderId: string,
+            req: PgCancelPaymentRequest,
+        ): Promise<{ ok: boolean; data: Record<string, unknown> }> {
+            return this._request(
+                "POST",
+                `/v1/pg/orders/${orderId}/cancel`,
+                req,
+            );
+        }
+
+        /** 결제 상태를 외부 PG와 동기화합니다. */
+        pgSyncPayment(orderId: string): Promise<{ ok: boolean }> {
+            return this._request("POST", `/v1/pg/orders/${orderId}/sync`, {});
+        }
+
+        /** 클라이언트 SDK 설정을 반환합니다 (공개 API, 인증 불필요). */
+        pgConfig(): Promise<{ ok: boolean; data: Record<string, unknown> }> {
+            return this._request("GET", "/v1/pg/config", undefined, false);
+        }
+    };
+}

package/src/mixins/push.ts

@@ -0,0 +1,132 @@
+import type {
+    EntityListParams,
+    EntityListResult,
+    RegisterPushDeviceOptions,
+    PushSendRequest,
+    PushSendAllRequest,
+} from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+
+// entity submit을 가진 base 타입 (EntityMixin 적용 후)
+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 function PushMixin<TBase extends GConstructor<WithSubmit>>(Base: TBase) {
+    return class PushMixinClass extends Base {
+        // ─── 푸시 submit 래퍼 ────────────────────────────────────────────────
+
+        /**
+         * 푸시 관련 엔티티로 payload를 전송(Submit)합니다.
+         * 내부적으로 `submit()` 메서드를 호출합니다.
+         */
+        push(
+            pushEntity: string,
+            payload: Record<string, unknown>,
+            opts: { transactionId?: string } = {},
+        ): Promise<{ ok: boolean; seq: number }> {
+            return this.submit(pushEntity, payload, opts);
+        }
+
+        // ─── 푸시 디바이스 관리 ───────────────────────────────────────────────
+
+        /** 푸시 로그 엔티티 목록을 조회합니다. */
+        pushLogList<T = unknown>(
+            params: EntityListParams = {},
+        ): Promise<{ ok: boolean; data: EntityListResult<T> }> {
+            return this.list<T>("push_log", params);
+        }
+
+        /** 계정의 푸시 디바이스를 등록합니다. */
+        registerPushDevice(
+            accountSeq: number,
+            deviceId: string,
+            pushToken: string,
+            opts: RegisterPushDeviceOptions = {},
+        ): Promise<{ ok: boolean; seq: number }> {
+            const {
+                platform,
+                deviceType,
+                browser,
+                browserVersion,
+                pushEnabled = true,
+                transactionId,
+            } = opts;
+            return this.submit(
+                "account_device",
+                {
+                    id: deviceId,
+                    account_seq: accountSeq,
+                    push_token: pushToken,
+                    push_enabled: pushEnabled,
+                    ...(platform ? { platform } : {}),
+                    ...(deviceType ? { device_type: deviceType } : {}),
+                    ...(browser ? { browser } : {}),
+                    ...(browserVersion
+                        ? { browser_version: browserVersion }
+                        : {}),
+                },
+                { transactionId },
+            );
+        }
+
+        /** 디바이스 레코드의 푸시 토큰을 갱신합니다. */
+        updatePushDeviceToken(
+            deviceSeq: number,
+            pushToken: string,
+            opts: { pushEnabled?: boolean; transactionId?: string } = {},
+        ): Promise<{ ok: boolean; seq: number }> {
+            const { pushEnabled = true, transactionId } = opts;
+            return this.submit(
+                "account_device",
+                {
+                    seq: deviceSeq,
+                    push_token: pushToken,
+                    push_enabled: pushEnabled,
+                },
+                { transactionId },
+            );
+        }
+
+        /** 디바이스의 푸시 수신을 비활성화합니다. */
+        disablePushDevice(
+            deviceSeq: number,
+            opts: { transactionId?: string } = {},
+        ): Promise<{ ok: boolean; seq: number }> {
+            return this.submit(
+                "account_device",
+                { seq: deviceSeq, push_enabled: false },
+                { transactionId: opts.transactionId },
+            );
+        }
+
+        // ─── 푸시 발송 API ────────────────────────────────────────────────────
+
+        /** 특정 계정에 푸시 알림을 발송합니다. */
+        pushSend(req: PushSendRequest): Promise<{ ok: boolean; seq: number }> {
+            return this._request("POST", "/v1/push/send", req);
+        }
+
+        /** 전체 사용자에게 푸시 알림을 발송합니다. */
+        pushSendAll(req: PushSendAllRequest): Promise<{
+            ok: boolean;
+            sent: number;
+            failed: number;
+        }> {
+            return this._request("POST", "/v1/push/send-all", req);
+        }
+
+        /** 푸시 발송 상태를 조회합니다. */
+        pushStatus(seq: number): Promise<{ ok: boolean; status: string }> {
+            return this._request("POST", `/v1/push/status/${seq}`, {});
+        }
+    };
+}

package/src/mixins/sms.ts

@@ -0,0 +1,46 @@
+import type { SmsSendRequest } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+
+export function SmsMixin<TBase extends GConstructor<EntityServerClientBase>>(
+    Base: TBase,
+) {
+    return class SmsMixinClass extends Base {
+        // ─── SMS 발송 / 인증 ──────────────────────────────────────────────────
+
+        /** SMS를 발송합니다. */
+        smsSend(req: SmsSendRequest): Promise<{ ok: boolean; seq: number }> {
+            return this._request("POST", "/v1/sms/send", req);
+        }
+
+        /** SMS 발송 상태를 조회합니다. */
+        smsStatus(seq: number): Promise<{ ok: boolean; status: string }> {
+            return this._request("GET", `/v1/sms/status/${seq}`);
+        }
+
+        /** SMS 인증 코드를 발송합니다. */
+        smsVerificationSend(
+            phone: string,
+            opts: { purpose?: string } = {},
+        ): Promise<{ ok: boolean }> {
+            return this._request(
+                "POST",
+                "/v1/sms/verification/send",
+                { phone, ...opts },
+                false,
+            );
+        }
+
+        /** SMS 인증 코드를 검증합니다. */
+        smsVerificationVerify(
+            phone: string,
+            code: string,
+        ): Promise<{ ok: boolean; verified: boolean }> {
+            return this._request(
+                "POST",
+                "/v1/sms/verification/verify",
+                { phone, code },
+                false,
+            );
+        }
+    };
+}

package/src/mixins/smtp.ts

@@ -0,0 +1,20 @@
+import type { SmtpSendRequest } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+
+export function SmtpMixin<TBase extends GConstructor<EntityServerClientBase>>(
+    Base: TBase,
+) {
+    return class SmtpMixinClass extends Base {
+        // ─── SMTP 메일 발송 ───────────────────────────────────────────────────
+
+        /** SMTP로 메일을 발송합니다. */
+        smtpSend(req: SmtpSendRequest): Promise<{ ok: boolean; seq: number }> {
+            return this._request("POST", "/v1/smtp/send", req);
+        }
+
+        /** SMTP 발송 상태를 조회합니다. */
+        smtpStatus(seq: number): Promise<{ ok: boolean; status: string }> {
+            return this._request("POST", `/v1/smtp/status/${seq}`, {});
+        }
+    };
+}

package/src/mixins/utils.ts

@@ -0,0 +1,75 @@
+import type { QRCodeOptions, BarcodeOptions } from "../types";
+import type { GConstructor, EntityServerClientBase } from "../client/base";
+
+export function UtilsMixin<TBase extends GConstructor<EntityServerClientBase>>(
+    Base: TBase,
+) {
+    return class UtilsMixinClass extends Base {
+        // ─── Utils (QR / 바코드) ──────────────────────────────────────────────
+
+        /**
+         * 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> {
+            return this._requestBinary("POST", "/v1/utils/qrcode", {
+                content,
+                ...opts,
+            });
+        }
+
+        /**
+         * 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 }> {
+            return this._request("POST", "/v1/utils/qrcode/base64", {
+                content,
+                ...opts,
+            });
+        }
+
+        /** QR 코드를 ASCII 아트 텍스트로 반환합니다. */
+        qrcodeText(
+            content: string,
+            opts: QRCodeOptions = {},
+        ): Promise<{ ok: boolean; text: string }> {
+            return this._request("POST", "/v1/utils/qrcode/text", {
+                content,
+                ...opts,
+            });
+        }
+
+        /**
+         * 바코드 PNG를 생성합니다. `ArrayBuffer`를 반환합니다.
+         *
+         * ```ts
+         * const buf = await client.barcode("1234567890128", { type: "ean13" });
+         * ```
+         */
+        barcode(
+            content: string,
+            opts: BarcodeOptions = {},
+        ): Promise<ArrayBuffer> {
+            return this._requestBinary("POST", "/v1/utils/barcode", {
+                content,
+                ...opts,
+            });
+        }
+    };
+}