@hive-ng/web-sdk 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,1676 @@
+import { Client, Interceptor, Transport } from '@connectrpc/connect';
+import { GenService, GenMessage } from '@bufbuild/protobuf/codegenv2';
+import { Timestamp } from '@bufbuild/protobuf/wkt';
+import { Message } from '@bufbuild/protobuf';
+
+/**
+ * connect 에러 detail에 담기는 구조화 에러 정보.
+ *
+ * @generated from message hiveng.v1.ErrorDetail
+ */
+type ErrorDetail = Message<"hiveng.v1.ErrorDetail"> & {
+    /**
+     * @generated from field: hiveng.v1.ErrorCode code = 1;
+     */
+    code: ErrorCode;
+    /**
+     * 부가 정보 (예: banned_until, maintenance_ends_at 등 — 코드별로 문서화)
+     *
+     * @generated from field: map<string, string> metadata = 2;
+     */
+    metadata: {
+        [key: string]: string;
+    };
+};
+/**
+ * 페이지네이션 요청. page_token은 첫 페이지에서 빈 문자열.
+ *
+ * @generated from message hiveng.v1.PageRequest
+ */
+type PageRequest = Message<"hiveng.v1.PageRequest"> & {
+    /**
+     * @generated from field: int32 page_size = 1;
+     */
+    pageSize: number;
+    /**
+     * @generated from field: string page_token = 2;
+     */
+    pageToken: string;
+};
+/**
+ * 페이지네이션 응답. next_page_token이 빈 문자열이면 마지막 페이지.
+ *
+ * @generated from message hiveng.v1.PageResponse
+ */
+type PageResponse = Message<"hiveng.v1.PageResponse"> & {
+    /**
+     * @generated from field: string next_page_token = 1;
+     */
+    nextPageToken: string;
+    /**
+     * @generated from field: int64 total = 2;
+     */
+    total: bigint;
+};
+/**
+ * 모든 도메인 에러의 단일 코드 체계.
+ * 백엔드는 connect 에러의 detail에 ErrorDetail을 담아 반환하고,
+ * 클라이언트/SDK는 문자열 파싱 없이 이 코드로 분기한다.
+ *
+ * @generated from enum hiveng.v1.ErrorCode
+ */
+declare enum ErrorCode {
+    /**
+     * @generated from enum value: ERROR_CODE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * 공통 (1-99)
+     *
+     * @generated from enum value: ERROR_CODE_INTERNAL = 1;
+     */
+    INTERNAL = 1,
+    /**
+     * @generated from enum value: ERROR_CODE_INVALID_ARGUMENT = 2;
+     */
+    INVALID_ARGUMENT = 2,
+    /**
+     * @generated from enum value: ERROR_CODE_NOT_FOUND = 3;
+     */
+    NOT_FOUND = 3,
+    /**
+     * @generated from enum value: ERROR_CODE_ALREADY_EXISTS = 4;
+     */
+    ALREADY_EXISTS = 4,
+    /**
+     * @generated from enum value: ERROR_CODE_PERMISSION_DENIED = 5;
+     */
+    PERMISSION_DENIED = 5,
+    /**
+     * @generated from enum value: ERROR_CODE_UNAUTHENTICATED = 6;
+     */
+    UNAUTHENTICATED = 6,
+    /**
+     * 게이트 / 접속 (100-199)
+     *
+     * @generated from enum value: ERROR_CODE_MAINTENANCE_IN_PROGRESS = 100;
+     */
+    MAINTENANCE_IN_PROGRESS = 100,
+    /**
+     * @generated from enum value: ERROR_CODE_GEO_BLOCKED = 101;
+     */
+    GEO_BLOCKED = 101,
+    /**
+     * @generated from enum value: ERROR_CODE_CLIENT_VERSION_UNSUPPORTED = 102;
+     */
+    CLIENT_VERSION_UNSUPPORTED = 102,
+    /**
+     * 인증 / 플레이어 (200-299)
+     *
+     * @generated from enum value: ERROR_CODE_PLAYER_BANNED = 200;
+     */
+    PLAYER_BANNED = 200,
+    /**
+     * @generated from enum value: ERROR_CODE_INVALID_PROVIDER_TOKEN = 201;
+     */
+    INVALID_PROVIDER_TOKEN = 201,
+    /**
+     * @generated from enum value: ERROR_CODE_PROVIDER_NOT_ENABLED = 202;
+     */
+    PROVIDER_NOT_ENABLED = 202,
+    /**
+     * @generated from enum value: ERROR_CODE_CREDENTIAL_NOT_CONFIGURED = 203;
+     */
+    CREDENTIAL_NOT_CONFIGURED = 203,
+    /**
+     * @generated from enum value: ERROR_CODE_SESSION_EXPIRED = 204;
+     */
+    SESSION_EXPIRED = 204,
+    /**
+     * @generated from enum value: ERROR_CODE_PLAYER_NOT_FOUND = 205;
+     */
+    PLAYER_NOT_FOUND = 205,
+    /**
+     * 결제 (300-399)
+     *
+     * @generated from enum value: ERROR_CODE_DUPLICATE_RECEIPT = 300;
+     */
+    DUPLICATE_RECEIPT = 300,
+    /**
+     * @generated from enum value: ERROR_CODE_RECEIPT_VERIFICATION_FAILED = 301;
+     */
+    RECEIPT_VERIFICATION_FAILED = 301,
+    /**
+     * @generated from enum value: ERROR_CODE_MARKET_NOT_SUPPORTED = 302;
+     */
+    MARKET_NOT_SUPPORTED = 302,
+    /**
+     * API Key (400-499)
+     *
+     * @generated from enum value: ERROR_CODE_API_KEY_INVALID = 400;
+     */
+    API_KEY_INVALID = 400,
+    /**
+     * @generated from enum value: ERROR_CODE_API_KEY_REVOKED = 401;
+     */
+    API_KEY_REVOKED = 401,
+    /**
+     * @generated from enum value: ERROR_CODE_SERVER_KEY_INVALID = 402;
+     */
+    SERVER_KEY_INVALID = 402,
+    /**
+     * @generated from enum value: ERROR_CODE_SERVER_KEY_REVOKED = 403;
+     */
+    SERVER_KEY_REVOKED = 403,
+    /**
+     * 관리자 / 프로젝트 (500-599)
+     *
+     * @generated from enum value: ERROR_CODE_ADMIN_EMAIL_EXISTS = 500;
+     */
+    ADMIN_EMAIL_EXISTS = 500,
+    /**
+     * @generated from enum value: ERROR_CODE_ADMIN_INVALID_CREDENTIALS = 501;
+     */
+    ADMIN_INVALID_CREDENTIALS = 501,
+    /**
+     * @generated from enum value: ERROR_CODE_PACKAGE_NAME_EXISTS = 502;
+     */
+    PACKAGE_NAME_EXISTS = 502,
+    /**
+     * 우편함 (600-699)
+     *
+     * @generated from enum value: ERROR_CODE_MAIL_NOT_FOUND = 600;
+     */
+    MAIL_NOT_FOUND = 600,
+    /**
+     * @generated from enum value: ERROR_CODE_MAIL_ALREADY_CLAIMED = 601;
+     */
+    MAIL_ALREADY_CLAIMED = 601,
+    /**
+     * @generated from enum value: ERROR_CODE_MAIL_NOT_CLAIMABLE = 602;
+     */
+    MAIL_NOT_CLAIMABLE = 602
+}
+
+/**
+ * 프로젝트 스코프의 플레이어.
+ *
+ * @generated from message hiveng.v1.Player
+ */
+type Player$1 = Message<"hiveng.v1.Player"> & {
+    /**
+     * @generated from field: string player_id = 1;
+     */
+    playerId: string;
+    /**
+     * @generated from field: string project_id = 2;
+     */
+    projectId: string;
+    /**
+     * ISO 3166-1 alpha-2 대문자 (예: "KR")
+     *
+     * @generated from field: string country = 3;
+     */
+    country: string;
+    /**
+     * 이 플레이어에 연결된 로그인 수단들
+     *
+     * @generated from field: repeated hiveng.v1.IdentityProvider providers = 4;
+     */
+    providers: IdentityProvider[];
+    /**
+     * @generated from field: google.protobuf.Timestamp created_at = 5;
+     */
+    createdAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp last_login_at = 6;
+     */
+    lastLoginAt?: Timestamp | undefined;
+    /**
+     * 표시용 닉네임. 신규 플레이어 생성 시 서버가 짧은 기본값을 자동 부여한다.
+     *
+     * @generated from field: string nickname = 7;
+     */
+    nickname: string;
+    /**
+     * @generated from field: string email = 8;
+     */
+    email: string;
+    /**
+     * @generated from field: hiveng.v1.ClientPlatform last_login_platform = 9;
+     */
+    lastLoginPlatform: ClientPlatform;
+};
+/**
+ * 액세스/리프레시 토큰 쌍.
+ *
+ * @generated from message hiveng.v1.TokenPair
+ */
+type TokenPair = Message<"hiveng.v1.TokenPair"> & {
+    /**
+     * @generated from field: string access_token = 1;
+     */
+    accessToken: string;
+    /**
+     * @generated from field: string refresh_token = 2;
+     */
+    refreshToken: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp access_token_expires_at = 3;
+     */
+    accessTokenExpiresAt?: Timestamp | undefined;
+};
+/**
+ * @generated from message hiveng.v1.GetLoginProvidersRequest
+ */
+type GetLoginProvidersRequest = Message<"hiveng.v1.GetLoginProvidersRequest"> & {
+    /**
+     * 테스트용 국가 강제 지정 (선택). 비어 있으면 서버가 IP로 판별.
+     *
+     * @generated from field: string country_override = 1;
+     */
+    countryOverride: string;
+    /**
+     * @generated from field: hiveng.v1.ClientPlatform platform = 2;
+     */
+    platform: ClientPlatform;
+};
+/**
+ * Describes the message hiveng.v1.GetLoginProvidersRequest.
+ * Use `create(GetLoginProvidersRequestSchema)` to create a new message.
+ */
+declare const GetLoginProvidersRequestSchema: GenMessage<GetLoginProvidersRequest>;
+/**
+ * @generated from message hiveng.v1.GetLoginProvidersResponse
+ */
+type GetLoginProvidersResponse = Message<"hiveng.v1.GetLoginProvidersResponse"> & {
+    /**
+     * 순서 = 클라이언트 노출 순서
+     *
+     * @generated from field: repeated hiveng.v1.IdentityProvider providers = 1;
+     */
+    providers: IdentityProvider[];
+    /**
+     * 판별된 국가 (ISO 3166-1 alpha-2)
+     *
+     * @generated from field: string country = 2;
+     */
+    country: string;
+};
+/**
+ * Describes the message hiveng.v1.GetLoginProvidersResponse.
+ * Use `create(GetLoginProvidersResponseSchema)` to create a new message.
+ */
+declare const GetLoginProvidersResponseSchema: GenMessage<GetLoginProvidersResponse>;
+/**
+ * @generated from message hiveng.v1.LoginWithProviderRequest
+ */
+type LoginWithProviderRequest = Message<"hiveng.v1.LoginWithProviderRequest"> & {
+    /**
+     * @generated from field: hiveng.v1.IdentityProvider provider = 1;
+     */
+    provider: IdentityProvider;
+    /**
+     * IdP 발급 토큰. GUEST는 디바이스 식별자.
+     *
+     * @generated from field: string provider_token = 2;
+     */
+    providerToken: string;
+    /**
+     * @generated from field: hiveng.v1.ClientPlatform platform = 3;
+     */
+    platform: ClientPlatform;
+};
+/**
+ * Describes the message hiveng.v1.LoginWithProviderRequest.
+ * Use `create(LoginWithProviderRequestSchema)` to create a new message.
+ */
+declare const LoginWithProviderRequestSchema: GenMessage<LoginWithProviderRequest>;
+/**
+ * @generated from message hiveng.v1.LoginWithProviderResponse
+ */
+type LoginWithProviderResponse = Message<"hiveng.v1.LoginWithProviderResponse"> & {
+    /**
+     * @generated from field: hiveng.v1.Player player = 1;
+     */
+    player?: Player$1 | undefined;
+    /**
+     * @generated from field: hiveng.v1.TokenPair token_pair = 2;
+     */
+    tokenPair?: TokenPair | undefined;
+};
+/**
+ * Describes the message hiveng.v1.LoginWithProviderResponse.
+ * Use `create(LoginWithProviderResponseSchema)` to create a new message.
+ */
+declare const LoginWithProviderResponseSchema: GenMessage<LoginWithProviderResponse>;
+/**
+ * @generated from message hiveng.v1.RefreshTokenRequest
+ */
+type RefreshTokenRequest = Message<"hiveng.v1.RefreshTokenRequest"> & {
+    /**
+     * @generated from field: string refresh_token = 1;
+     */
+    refreshToken: string;
+};
+/**
+ * Describes the message hiveng.v1.RefreshTokenRequest.
+ * Use `create(RefreshTokenRequestSchema)` to create a new message.
+ */
+declare const RefreshTokenRequestSchema: GenMessage<RefreshTokenRequest>;
+/**
+ * @generated from message hiveng.v1.RefreshTokenResponse
+ */
+type RefreshTokenResponse = Message<"hiveng.v1.RefreshTokenResponse"> & {
+    /**
+     * @generated from field: hiveng.v1.TokenPair token_pair = 1;
+     */
+    tokenPair?: TokenPair | undefined;
+};
+/**
+ * Describes the message hiveng.v1.RefreshTokenResponse.
+ * Use `create(RefreshTokenResponseSchema)` to create a new message.
+ */
+declare const RefreshTokenResponseSchema: GenMessage<RefreshTokenResponse>;
+/**
+ * @generated from message hiveng.v1.LogoutRequest
+ */
+type LogoutRequest = Message<"hiveng.v1.LogoutRequest"> & {};
+/**
+ * Describes the message hiveng.v1.LogoutRequest.
+ * Use `create(LogoutRequestSchema)` to create a new message.
+ */
+declare const LogoutRequestSchema: GenMessage<LogoutRequest>;
+/**
+ * @generated from message hiveng.v1.LogoutResponse
+ */
+type LogoutResponse = Message<"hiveng.v1.LogoutResponse"> & {};
+/**
+ * Describes the message hiveng.v1.LogoutResponse.
+ * Use `create(LogoutResponseSchema)` to create a new message.
+ */
+declare const LogoutResponseSchema: GenMessage<LogoutResponse>;
+/**
+ * @generated from message hiveng.v1.GetPlayerRequest
+ */
+type GetPlayerRequest = Message<"hiveng.v1.GetPlayerRequest"> & {};
+/**
+ * Describes the message hiveng.v1.GetPlayerRequest.
+ * Use `create(GetPlayerRequestSchema)` to create a new message.
+ */
+declare const GetPlayerRequestSchema: GenMessage<GetPlayerRequest>;
+/**
+ * @generated from message hiveng.v1.GetPlayerResponse
+ */
+type GetPlayerResponse = Message<"hiveng.v1.GetPlayerResponse"> & {
+    /**
+     * @generated from field: hiveng.v1.Player player = 1;
+     */
+    player?: Player$1 | undefined;
+};
+/**
+ * Describes the message hiveng.v1.GetPlayerResponse.
+ * Use `create(GetPlayerResponseSchema)` to create a new message.
+ */
+declare const GetPlayerResponseSchema: GenMessage<GetPlayerResponse>;
+/**
+ * @generated from message hiveng.v1.UpdateNicknameRequest
+ */
+type UpdateNicknameRequest = Message<"hiveng.v1.UpdateNicknameRequest"> & {
+    /**
+     * @generated from field: string nickname = 1;
+     */
+    nickname: string;
+};
+/**
+ * Describes the message hiveng.v1.UpdateNicknameRequest.
+ * Use `create(UpdateNicknameRequestSchema)` to create a new message.
+ */
+declare const UpdateNicknameRequestSchema: GenMessage<UpdateNicknameRequest>;
+/**
+ * @generated from message hiveng.v1.UpdateNicknameResponse
+ */
+type UpdateNicknameResponse = Message<"hiveng.v1.UpdateNicknameResponse"> & {
+    /**
+     * @generated from field: hiveng.v1.Player player = 1;
+     */
+    player?: Player$1 | undefined;
+};
+/**
+ * Describes the message hiveng.v1.UpdateNicknameResponse.
+ * Use `create(UpdateNicknameResponseSchema)` to create a new message.
+ */
+declare const UpdateNicknameResponseSchema: GenMessage<UpdateNicknameResponse>;
+/**
+ * 로그인 수단 (IdP).
+ *
+ * @generated from enum hiveng.v1.IdentityProvider
+ */
+declare enum IdentityProvider {
+    /**
+     * @generated from enum value: IDENTITY_PROVIDER_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: IDENTITY_PROVIDER_KAKAO = 1;
+     */
+    KAKAO = 1,
+    /**
+     * @generated from enum value: IDENTITY_PROVIDER_NAVER = 2;
+     */
+    NAVER = 2,
+    /**
+     * @generated from enum value: IDENTITY_PROVIDER_GOOGLE = 3;
+     */
+    GOOGLE = 3,
+    /**
+     * @generated from enum value: IDENTITY_PROVIDER_FACEBOOK = 4;
+     */
+    FACEBOOK = 4,
+    /**
+     * @generated from enum value: IDENTITY_PROVIDER_APPLE = 5;
+     */
+    APPLE = 5,
+    /**
+     * @generated from enum value: IDENTITY_PROVIDER_LINE = 6;
+     */
+    LINE = 6,
+    /**
+     * @generated from enum value: IDENTITY_PROVIDER_TRUECALLER = 7;
+     */
+    TRUECALLER = 7,
+    /**
+     * @generated from enum value: IDENTITY_PROVIDER_PHONE_OTP = 8;
+     */
+    PHONE_OTP = 8,
+    /**
+     * @generated from enum value: IDENTITY_PROVIDER_GUEST = 9;
+     */
+    GUEST = 9
+}
+/**
+ * @generated from enum hiveng.v1.ClientPlatform
+ */
+declare enum ClientPlatform {
+    /**
+     * @generated from enum value: CLIENT_PLATFORM_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: CLIENT_PLATFORM_WEB = 1;
+     */
+    WEB = 1,
+    /**
+     * @generated from enum value: CLIENT_PLATFORM_ANDROID = 2;
+     */
+    ANDROID = 2,
+    /**
+     * @generated from enum value: CLIENT_PLATFORM_IOS = 3;
+     */
+    IOS = 3,
+    /**
+     * @generated from enum value: CLIENT_PLATFORM_DESKTOP = 4;
+     */
+    DESKTOP = 4
+}
+/**
+ * 클라이언트 SDK용 인증 서비스.
+ *
+ * @generated from service hiveng.v1.AuthService
+ */
+declare const AuthService: GenService<{
+    /**
+     * auth: api_key
+     * 서버가 요청 IP로 국가를 판별해 해당 국가의 로그인 수단 목록을 반환.
+     *
+     * @generated from rpc hiveng.v1.AuthService.GetLoginProviders
+     */
+    getLoginProviders: {
+        methodKind: "unary";
+        input: typeof GetLoginProvidersRequestSchema;
+        output: typeof GetLoginProvidersResponseSchema;
+    };
+    /**
+     * auth: api_key
+     * IdP 토큰으로 로그인. 게스트는 provider=GUEST, provider_token=디바이스 식별자.
+     * 제재 중이면 ERROR_CODE_PLAYER_BANNED + ErrorDetail(metadata: banned_until 등) 반환.
+     *
+     * @generated from rpc hiveng.v1.AuthService.LoginWithProvider
+     */
+    loginWithProvider: {
+        methodKind: "unary";
+        input: typeof LoginWithProviderRequestSchema;
+        output: typeof LoginWithProviderResponseSchema;
+    };
+    /**
+     * auth: api_key
+     *
+     * @generated from rpc hiveng.v1.AuthService.RefreshToken
+     */
+    refreshToken: {
+        methodKind: "unary";
+        input: typeof RefreshTokenRequestSchema;
+        output: typeof RefreshTokenResponseSchema;
+    };
+    /**
+     * auth: api_key + player_token
+     *
+     * @generated from rpc hiveng.v1.AuthService.Logout
+     */
+    logout: {
+        methodKind: "unary";
+        input: typeof LogoutRequestSchema;
+        output: typeof LogoutResponseSchema;
+    };
+    /**
+     * auth: api_key + player_token
+     *
+     * @generated from rpc hiveng.v1.AuthService.GetPlayer
+     */
+    getPlayer: {
+        methodKind: "unary";
+        input: typeof GetPlayerRequestSchema;
+        output: typeof GetPlayerResponseSchema;
+    };
+    /**
+     * auth: api_key + player_token
+     * 플레이어 본인 닉네임 변경. 빈/형식 위반 시 ERROR_CODE_INVALID_ARGUMENT.
+     *
+     * @generated from rpc hiveng.v1.AuthService.UpdateNickname
+     */
+    updateNickname: {
+        methodKind: "unary";
+        input: typeof UpdateNicknameRequestSchema;
+        output: typeof UpdateNicknameResponseSchema;
+    };
+}>;
+
+declare class HiveNgError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+declare class BannedError extends HiveNgError {
+    readonly reason: string;
+    readonly until?: Date;
+    readonly permanent: boolean;
+    constructor(reason: string, permanent: boolean, until: Date | undefined, message: string);
+}
+declare class MaintenanceError extends HiveNgError {
+    readonly startsAt?: Date;
+    readonly endsAt?: Date;
+    readonly maintenanceMessage: string;
+    constructor(message: string, startsAt: Date | undefined, endsAt: Date | undefined);
+}
+declare function errorDetailOf(err: unknown): ErrorDetail | undefined;
+declare function errorCodeOf(err: unknown): ErrorCode;
+
+interface KeyValueStorage {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+
+type RefreshFn = (refreshToken: string) => Promise<TokenPair>;
+declare class Session {
+    private readonly storage;
+    onCleared?: () => void;
+    onBanned?: (err: BannedError) => void;
+    refreshFn?: RefreshFn;
+    private refreshing?;
+    private refreshError?;
+    constructor(storage: KeyValueStorage);
+    get accessToken(): string | null;
+    get refreshToken(): string | null;
+    save(pair: TokenPair): void;
+    clear(): void;
+    tryRefresh(): Promise<boolean>;
+    consumeRefreshError(): unknown;
+    private doRefresh;
+}
+
+interface Player {
+    playerId: string;
+    projectId: string;
+    country: string;
+    email: string;
+    nickname: string;
+    lastLoginPlatform: string;
+    providers: string[];
+    createdAt?: Date;
+    lastLoginAt?: Date;
+}
+interface LoginProviders {
+    providers: string[];
+    country: string;
+}
+
+type AuthClient = Client<typeof AuthService>;
+declare class AuthApi {
+    private readonly session;
+    private player;
+    private client;
+    constructor(session: Session);
+    bind(client: AuthClient): void;
+    getLoginProviders(countryOverride?: string): Promise<LoginProviders>;
+    loginWithGoogle(idToken: string): Promise<Player>;
+    loginAsGuest(deviceId: string): Promise<Player>;
+    restoreSession(): Promise<Player | null>;
+    getPlayer(): Promise<Player | null>;
+    logout(): Promise<void>;
+    currentPlayer(): Player | null;
+    clearPlayer(): void;
+    private login;
+    private fetchPlayer;
+    private requireClient;
+}
+
+interface TransportFactoryOptions {
+    baseUrl: string;
+    interceptors: Interceptor[];
+}
+type TransportFactory = (options: TransportFactoryOptions) => Transport;
+interface HiveNgConfig {
+    gatewayUrl: string;
+    projectId: string;
+    apiKey: string;
+    clientVersion?: string;
+    language?: string;
+    debug?: boolean;
+    persistSession?: boolean;
+    transportFactory?: TransportFactory;
+}
+
+/**
+ * @generated from message hiveng.v1.Mail
+ */
+type Mail$1 = Message<"hiveng.v1.Mail"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * @generated from field: string mail_id = 2;
+     */
+    mailId: string;
+    /**
+     * @generated from field: string project_id = 3;
+     */
+    projectId: string;
+    /**
+     * @generated from field: hiveng.v1.MailType type = 4;
+     */
+    type: MailType;
+    /**
+     * @generated from field: map<string, string> title = 5;
+     */
+    title: {
+        [key: string]: string;
+    };
+    /**
+     * @generated from field: map<string, string> body = 6;
+     */
+    body: {
+        [key: string]: string;
+    };
+    /**
+     * @generated from field: string sender = 7;
+     */
+    sender: string;
+    /**
+     * @generated from field: map<string, string> reward_preview = 8;
+     */
+    rewardPreview: {
+        [key: string]: string;
+    };
+    /**
+     * @generated from field: bool claimed = 9;
+     */
+    claimed: boolean;
+    /**
+     * @generated from field: google.protobuf.Timestamp claimable_from = 10;
+     */
+    claimableFrom?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp expires_at = 11;
+     */
+    expiresAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp claimed_at = 12;
+     */
+    claimedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp created_at = 13;
+     */
+    createdAt?: Timestamp | undefined;
+    /**
+     * @generated from field: repeated hiveng.v1.MailRewardDisplayItem reward_display = 14;
+     */
+    rewardDisplay: MailRewardDisplayItem$1[];
+};
+/**
+ * @generated from message hiveng.v1.MailRewardDisplayItem
+ */
+type MailRewardDisplayItem$1 = Message<"hiveng.v1.MailRewardDisplayItem"> & {
+    /**
+     * @generated from field: string icon = 1;
+     */
+    icon: string;
+    /**
+     * @generated from field: string label = 2;
+     */
+    label: string;
+    /**
+     * @generated from field: string quantity = 3;
+     */
+    quantity: string;
+};
+/**
+ * @generated from message hiveng.v1.ListMailRequest
+ */
+type ListMailRequest = Message<"hiveng.v1.ListMailRequest"> & {
+    /**
+     * @generated from field: hiveng.v1.PageRequest page = 1;
+     */
+    page?: PageRequest | undefined;
+    /**
+     * @generated from field: bool include_claimed = 2;
+     */
+    includeClaimed: boolean;
+};
+/**
+ * Describes the message hiveng.v1.ListMailRequest.
+ * Use `create(ListMailRequestSchema)` to create a new message.
+ */
+declare const ListMailRequestSchema: GenMessage<ListMailRequest>;
+/**
+ * @generated from message hiveng.v1.ListMailResponse
+ */
+type ListMailResponse = Message<"hiveng.v1.ListMailResponse"> & {
+    /**
+     * @generated from field: repeated hiveng.v1.Mail mail = 1;
+     */
+    mail: Mail$1[];
+    /**
+     * @generated from field: hiveng.v1.PageResponse page = 2;
+     */
+    page?: PageResponse | undefined;
+};
+/**
+ * Describes the message hiveng.v1.ListMailResponse.
+ * Use `create(ListMailResponseSchema)` to create a new message.
+ */
+declare const ListMailResponseSchema: GenMessage<ListMailResponse>;
+/**
+ * @generated from message hiveng.v1.CheckNewMailRequest
+ */
+type CheckNewMailRequest = Message<"hiveng.v1.CheckNewMailRequest"> & {};
+/**
+ * Describes the message hiveng.v1.CheckNewMailRequest.
+ * Use `create(CheckNewMailRequestSchema)` to create a new message.
+ */
+declare const CheckNewMailRequestSchema: GenMessage<CheckNewMailRequest>;
+/**
+ * @generated from message hiveng.v1.CheckNewMailResponse
+ */
+type CheckNewMailResponse = Message<"hiveng.v1.CheckNewMailResponse"> & {
+    /**
+     * @generated from field: bool has_new_mail = 1;
+     */
+    hasNewMail: boolean;
+    /**
+     * @generated from field: int64 unread_count = 2;
+     */
+    unreadCount: bigint;
+};
+/**
+ * Describes the message hiveng.v1.CheckNewMailResponse.
+ * Use `create(CheckNewMailResponseSchema)` to create a new message.
+ */
+declare const CheckNewMailResponseSchema: GenMessage<CheckNewMailResponse>;
+/**
+ * @generated from message hiveng.v1.ClaimMailRequest
+ */
+type ClaimMailRequest = Message<"hiveng.v1.ClaimMailRequest"> & {
+    /**
+     * @generated from field: string mail_recipient_id = 1;
+     */
+    mailRecipientId: string;
+};
+/**
+ * Describes the message hiveng.v1.ClaimMailRequest.
+ * Use `create(ClaimMailRequestSchema)` to create a new message.
+ */
+declare const ClaimMailRequestSchema: GenMessage<ClaimMailRequest>;
+/**
+ * @generated from message hiveng.v1.ClaimMailResponse
+ */
+type ClaimMailResponse = Message<"hiveng.v1.ClaimMailResponse"> & {
+    /**
+     * @generated from field: hiveng.v1.Mail mail = 1;
+     */
+    mail?: Mail$1 | undefined;
+};
+/**
+ * Describes the message hiveng.v1.ClaimMailResponse.
+ * Use `create(ClaimMailResponseSchema)` to create a new message.
+ */
+declare const ClaimMailResponseSchema: GenMessage<ClaimMailResponse>;
+/**
+ * @generated from enum hiveng.v1.MailType
+ */
+declare enum MailType {
+    /**
+     * @generated from enum value: MAIL_TYPE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: MAIL_TYPE_TEXT = 1;
+     */
+    TEXT = 1,
+    /**
+     * @generated from enum value: MAIL_TYPE_ITEM = 2;
+     */
+    ITEM = 2
+}
+/**
+ * @generated from service hiveng.v1.MailboxService
+ */
+declare const MailboxService: GenService<{
+    /**
+     * @generated from rpc hiveng.v1.MailboxService.ListMail
+     */
+    listMail: {
+        methodKind: "unary";
+        input: typeof ListMailRequestSchema;
+        output: typeof ListMailResponseSchema;
+    };
+    /**
+     * @generated from rpc hiveng.v1.MailboxService.CheckNewMail
+     */
+    checkNewMail: {
+        methodKind: "unary";
+        input: typeof CheckNewMailRequestSchema;
+        output: typeof CheckNewMailResponseSchema;
+    };
+    /**
+     * @generated from rpc hiveng.v1.MailboxService.ClaimMail
+     */
+    claimMail: {
+        methodKind: "unary";
+        input: typeof ClaimMailRequestSchema;
+        output: typeof ClaimMailResponseSchema;
+    };
+}>;
+
+interface Mail {
+    id: string;
+    mailId: string;
+    projectId: string;
+    type: MailType;
+    title: string;
+    body: string;
+    sender: string;
+    rewardPreview: Record<string, string>;
+    claimed: boolean;
+    claimableFrom?: Date;
+    expiresAt?: Date;
+    claimedAt?: Date;
+    createdAt?: Date;
+    rewardDisplay: MailRewardDisplayItem[];
+}
+interface MailRewardDisplayItem {
+    icon: string;
+    label: string;
+    quantity: string;
+}
+interface ListMailOptions {
+    pageSize?: number;
+    pageToken?: string;
+    includeClaimed?: boolean;
+}
+interface ListMailResult {
+    mail: Mail[];
+    nextPageToken: string;
+    total: bigint;
+}
+interface CheckNewMailResult {
+    hasNewMail: boolean;
+    unreadCount: bigint;
+}
+type MailboxClient = Client<typeof MailboxService>;
+declare class MailboxApi {
+    private readonly language;
+    private client;
+    constructor(language: string);
+    bind(client: MailboxClient): void;
+    unbind(): void;
+    listMail(options?: ListMailOptions): Promise<ListMailResult>;
+    checkNewMail(): Promise<CheckNewMailResult>;
+    claimMail(mailRecipientId: string): Promise<Mail>;
+    private requireClient;
+}
+
+/**
+ * 공지 1건.
+ *
+ * @generated from message hiveng.v1.Notice
+ */
+type Notice$1 = Message<"hiveng.v1.Notice"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * @generated from field: string project_id = 2;
+     */
+    projectId: string;
+    /**
+     * 제목 (key = BCP-47: "ko", "en", "ja")
+     *
+     * @generated from field: map<string, string> title = 4;
+     */
+    title: {
+        [key: string]: string;
+    };
+    /**
+     * 본문 (key = BCP-47)
+     *
+     * @generated from field: map<string, string> body = 5;
+     */
+    body: {
+        [key: string]: string;
+    };
+    /**
+     * 노출 시작 (UTC)
+     *
+     * @generated from field: google.protobuf.Timestamp starts_at = 6;
+     */
+    startsAt?: Timestamp | undefined;
+    /**
+     * 노출 종료 (UTC)
+     *
+     * @generated from field: google.protobuf.Timestamp ends_at = 7;
+     */
+    endsAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp created_at = 10;
+     */
+    createdAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp updated_at = 11;
+     */
+    updatedAt?: Timestamp | undefined;
+    /**
+     * 조회 노출 횟수
+     *
+     * @generated from field: int64 view_count = 12;
+     */
+    viewCount: bigint;
+};
+/**
+ * @generated from message hiveng.v1.ListActiveNoticesRequest
+ */
+type ListActiveNoticesRequest = Message<"hiveng.v1.ListActiveNoticesRequest"> & {};
+/**
+ * Describes the message hiveng.v1.ListActiveNoticesRequest.
+ * Use `create(ListActiveNoticesRequestSchema)` to create a new message.
+ */
+declare const ListActiveNoticesRequestSchema: GenMessage<ListActiveNoticesRequest>;
+/**
+ * @generated from message hiveng.v1.ListActiveNoticesResponse
+ */
+type ListActiveNoticesResponse = Message<"hiveng.v1.ListActiveNoticesResponse"> & {
+    /**
+     * @generated from field: repeated hiveng.v1.Notice notices = 1;
+     */
+    notices: Notice$1[];
+};
+/**
+ * Describes the message hiveng.v1.ListActiveNoticesResponse.
+ * Use `create(ListActiveNoticesResponseSchema)` to create a new message.
+ */
+declare const ListActiveNoticesResponseSchema: GenMessage<ListActiveNoticesResponse>;
+/**
+ * 클라이언트 SDK용 공지 조회.
+ *
+ * @generated from service hiveng.v1.NoticeService
+ */
+declare const NoticeService: GenService<{
+    /**
+     * auth: api_key
+     * 서버가 기간(starts_at ≤ now < ends_at) 필터링과 생성일 순 정렬을 수행해 반환한다.
+     *
+     * @generated from rpc hiveng.v1.NoticeService.ListActiveNotices
+     */
+    listActiveNotices: {
+        methodKind: "unary";
+        input: typeof ListActiveNoticesRequestSchema;
+        output: typeof ListActiveNoticesResponseSchema;
+    };
+}>;
+
+interface Notice {
+    id: string;
+    projectId: string;
+    title: string;
+    body: string;
+    startsAt?: Date;
+    endsAt?: Date;
+    viewCount: bigint;
+}
+type NoticeClient = Client<typeof NoticeService>;
+declare class NoticeApi {
+    private readonly language;
+    private client;
+    constructor(language: string);
+    bind(client: NoticeClient): void;
+    unbind(): void;
+    listActiveNotices(): Promise<Notice[]>;
+    private requireClient;
+}
+
+/**
+ * 구매 내역.
+ *
+ * @generated from message hiveng.v1.Purchase
+ */
+type Purchase = Message<"hiveng.v1.Purchase"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * @generated from field: string project_id = 2;
+     */
+    projectId: string;
+    /**
+     * @generated from field: string player_id = 3;
+     */
+    playerId: string;
+    /**
+     * @generated from field: hiveng.v1.Market market = 4;
+     */
+    market: Market;
+    /**
+     * @generated from field: string product_id = 5;
+     */
+    productId: string;
+    /**
+     * 통화 최소 단위 금액.
+     *
+     * @generated from field: int64 amount_minor = 6;
+     */
+    amountMinor: bigint;
+    /**
+     * ISO 4217 통화 코드.
+     *
+     * @generated from field: string currency = 7;
+     */
+    currency: string;
+    /**
+     * @generated from field: hiveng.v1.PurchaseStatus status = 8;
+     */
+    status: PurchaseStatus;
+    /**
+     * 마켓 구매 시각 (UTC).
+     *
+     * @generated from field: google.protobuf.Timestamp purchased_at = 9;
+     */
+    purchasedAt?: Timestamp | undefined;
+    /**
+     * 영수증 검증 완료 시각 (UTC). 미검증이면 미설정.
+     *
+     * @generated from field: google.protobuf.Timestamp verified_at = 10;
+     */
+    verifiedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp created_at = 11;
+     */
+    createdAt?: Timestamp | undefined;
+    /**
+     * @generated from field: hiveng.v1.ProductType product_type = 12;
+     */
+    productType: ProductType;
+    /**
+     * @generated from field: string package_name = 13;
+     */
+    packageName: string;
+    /**
+     * @generated from field: string market_order_id = 14;
+     */
+    marketOrderId: string;
+    /**
+     * @generated from field: string purchase_token_hash = 15;
+     */
+    purchaseTokenHash: string;
+    /**
+     * @generated from field: string failure_reason = 16;
+     */
+    failureReason: string;
+    /**
+     * @generated from field: string raw_market_response = 17;
+     */
+    rawMarketResponse: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp requested_at = 18;
+     */
+    requestedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp updated_at = 19;
+     */
+    updatedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: string purchase_intent_id = 20;
+     */
+    purchaseIntentId: string;
+    /**
+     * @generated from field: hiveng.v1.PaymentConsumePolicy consume_policy = 21;
+     */
+    consumePolicy: PaymentConsumePolicy;
+    /**
+     * @generated from field: string consume_status = 22;
+     */
+    consumeStatus: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp consumed_at = 23;
+     */
+    consumedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: hiveng.v1.PaymentGrantMode grant_mode = 24;
+     */
+    grantMode: PaymentGrantMode;
+    /**
+     * @generated from field: string grant_status = 25;
+     */
+    grantStatus: string;
+    /**
+     * @generated from field: google.protobuf.Timestamp grant_delivered_at = 26;
+     */
+    grantDeliveredAt?: Timestamp | undefined;
+};
+/**
+ * @generated from message hiveng.v1.PaymentProduct
+ */
+type PaymentProduct = Message<"hiveng.v1.PaymentProduct"> & {
+    /**
+     * @generated from field: string project_id = 1;
+     */
+    projectId: string;
+    /**
+     * @generated from field: hiveng.v1.Market market = 2;
+     */
+    market: Market;
+    /**
+     * @generated from field: string app_identifier = 3;
+     */
+    appIdentifier: string;
+    /**
+     * @generated from field: string product_id = 4;
+     */
+    productId: string;
+    /**
+     * @generated from field: hiveng.v1.ProductType product_type = 5;
+     */
+    productType: ProductType;
+    /**
+     * @generated from field: string market_status = 6;
+     */
+    marketStatus: string;
+    /**
+     * @generated from field: string title = 7;
+     */
+    title: string;
+    /**
+     * @generated from field: string description = 8;
+     */
+    description: string;
+    /**
+     * @generated from field: hiveng.v1.PaymentConsumePolicy consume_policy = 9;
+     */
+    consumePolicy: PaymentConsumePolicy;
+    /**
+     * @generated from field: hiveng.v1.PaymentGrantMode grant_mode = 10;
+     */
+    grantMode: PaymentGrantMode;
+    /**
+     * @generated from field: bool enabled = 11;
+     */
+    enabled: boolean;
+    /**
+     * @generated from field: google.protobuf.Timestamp last_imported_at = 12;
+     */
+    lastImportedAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp created_at = 13;
+     */
+    createdAt?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp updated_at = 14;
+     */
+    updatedAt?: Timestamp | undefined;
+};
+/**
+ * @generated from message hiveng.v1.ListProductsRequest
+ */
+type ListProductsRequest = Message<"hiveng.v1.ListProductsRequest"> & {
+    /**
+     * @generated from field: hiveng.v1.Market market = 1;
+     */
+    market: Market;
+    /**
+     * @generated from field: string app_identifier = 2;
+     */
+    appIdentifier: string;
+    /**
+     * @generated from field: hiveng.v1.ProductType product_type = 3;
+     */
+    productType: ProductType;
+};
+/**
+ * Describes the message hiveng.v1.ListProductsRequest.
+ * Use `create(ListProductsRequestSchema)` to create a new message.
+ */
+declare const ListProductsRequestSchema: GenMessage<ListProductsRequest>;
+/**
+ * @generated from message hiveng.v1.ListProductsResponse
+ */
+type ListProductsResponse = Message<"hiveng.v1.ListProductsResponse"> & {
+    /**
+     * @generated from field: repeated hiveng.v1.PaymentProduct products = 1;
+     */
+    products: PaymentProduct[];
+};
+/**
+ * Describes the message hiveng.v1.ListProductsResponse.
+ * Use `create(ListProductsResponseSchema)` to create a new message.
+ */
+declare const ListProductsResponseSchema: GenMessage<ListProductsResponse>;
+/**
+ * @generated from message hiveng.v1.StartPurchaseRequest
+ */
+type StartPurchaseRequest = Message<"hiveng.v1.StartPurchaseRequest"> & {
+    /**
+     * @generated from field: hiveng.v1.Market market = 1;
+     */
+    market: Market;
+    /**
+     * @generated from field: string product_id = 2;
+     */
+    productId: string;
+    /**
+     * @generated from field: hiveng.v1.ProductType product_type = 3;
+     */
+    productType: ProductType;
+    /**
+     * @generated from field: string app_identifier = 4;
+     */
+    appIdentifier: string;
+};
+/**
+ * Describes the message hiveng.v1.StartPurchaseRequest.
+ * Use `create(StartPurchaseRequestSchema)` to create a new message.
+ */
+declare const StartPurchaseRequestSchema: GenMessage<StartPurchaseRequest>;
+/**
+ * @generated from message hiveng.v1.StartPurchaseResponse
+ */
+type StartPurchaseResponse = Message<"hiveng.v1.StartPurchaseResponse"> & {
+    /**
+     * @generated from field: string purchase_intent_id = 1;
+     */
+    purchaseIntentId: string;
+};
+/**
+ * Describes the message hiveng.v1.StartPurchaseResponse.
+ * Use `create(StartPurchaseResponseSchema)` to create a new message.
+ */
+declare const StartPurchaseResponseSchema: GenMessage<StartPurchaseResponse>;
+/**
+ * @generated from message hiveng.v1.VerifyPurchaseRequest
+ */
+type VerifyPurchaseRequest = Message<"hiveng.v1.VerifyPurchaseRequest"> & {
+    /**
+     * @generated from field: hiveng.v1.Market market = 1;
+     */
+    market: Market;
+    /**
+     * 마켓별 영수증 원문 (JSON/base64).
+     *
+     * @generated from field: string receipt_payload = 2;
+     */
+    receiptPayload: string;
+    /**
+     * @generated from field: string product_id = 3;
+     */
+    productId: string;
+    /**
+     * @generated from field: hiveng.v1.ProductType product_type = 4;
+     */
+    productType: ProductType;
+    /**
+     * @generated from field: string purchase_token = 5;
+     */
+    purchaseToken: string;
+    /**
+     * @generated from field: string package_name = 6 [deprecated = true];
+     * @deprecated
+     */
+    packageName: string;
+    /**
+     * @generated from field: string app_identifier = 7;
+     */
+    appIdentifier: string;
+    /**
+     * @generated from field: string purchase_intent_id = 8;
+     */
+    purchaseIntentId: string;
+};
+/**
+ * Describes the message hiveng.v1.VerifyPurchaseRequest.
+ * Use `create(VerifyPurchaseRequestSchema)` to create a new message.
+ */
+declare const VerifyPurchaseRequestSchema: GenMessage<VerifyPurchaseRequest>;
+/**
+ * @generated from message hiveng.v1.VerifyPurchaseResponse
+ */
+type VerifyPurchaseResponse = Message<"hiveng.v1.VerifyPurchaseResponse"> & {
+    /**
+     * @generated from field: hiveng.v1.Purchase purchase = 1;
+     */
+    purchase?: Purchase | undefined;
+};
+/**
+ * Describes the message hiveng.v1.VerifyPurchaseResponse.
+ * Use `create(VerifyPurchaseResponseSchema)` to create a new message.
+ */
+declare const VerifyPurchaseResponseSchema: GenMessage<VerifyPurchaseResponse>;
+/**
+ * @generated from message hiveng.v1.PaymentServiceGetPurchaseRequest
+ */
+type PaymentServiceGetPurchaseRequest = Message<"hiveng.v1.PaymentServiceGetPurchaseRequest"> & {
+    /**
+     * @generated from field: string purchase_id = 1;
+     */
+    purchaseId: string;
+};
+/**
+ * Describes the message hiveng.v1.PaymentServiceGetPurchaseRequest.
+ * Use `create(PaymentServiceGetPurchaseRequestSchema)` to create a new message.
+ */
+declare const PaymentServiceGetPurchaseRequestSchema: GenMessage<PaymentServiceGetPurchaseRequest>;
+/**
+ * @generated from message hiveng.v1.PaymentServiceGetPurchaseResponse
+ */
+type PaymentServiceGetPurchaseResponse = Message<"hiveng.v1.PaymentServiceGetPurchaseResponse"> & {
+    /**
+     * @generated from field: hiveng.v1.Purchase purchase = 1;
+     */
+    purchase?: Purchase | undefined;
+};
+/**
+ * Describes the message hiveng.v1.PaymentServiceGetPurchaseResponse.
+ * Use `create(PaymentServiceGetPurchaseResponseSchema)` to create a new message.
+ */
+declare const PaymentServiceGetPurchaseResponseSchema: GenMessage<PaymentServiceGetPurchaseResponse>;
+/**
+ * @generated from message hiveng.v1.ConfirmPaymentGrantDeliveredRequest
+ */
+type ConfirmPaymentGrantDeliveredRequest = Message<"hiveng.v1.ConfirmPaymentGrantDeliveredRequest"> & {
+    /**
+     * @generated from field: string project_id = 1;
+     */
+    projectId: string;
+    /**
+     * @generated from field: string purchase_id = 2;
+     */
+    purchaseId: string;
+    /**
+     * @generated from field: string event_id = 3;
+     */
+    eventId: string;
+};
+/**
+ * Describes the message hiveng.v1.ConfirmPaymentGrantDeliveredRequest.
+ * Use `create(ConfirmPaymentGrantDeliveredRequestSchema)` to create a new message.
+ */
+declare const ConfirmPaymentGrantDeliveredRequestSchema: GenMessage<ConfirmPaymentGrantDeliveredRequest>;
+/**
+ * @generated from message hiveng.v1.ConfirmPaymentGrantDeliveredResponse
+ */
+type ConfirmPaymentGrantDeliveredResponse = Message<"hiveng.v1.ConfirmPaymentGrantDeliveredResponse"> & {
+    /**
+     * @generated from field: hiveng.v1.Purchase purchase = 1;
+     */
+    purchase?: Purchase | undefined;
+};
+/**
+ * Describes the message hiveng.v1.ConfirmPaymentGrantDeliveredResponse.
+ * Use `create(ConfirmPaymentGrantDeliveredResponseSchema)` to create a new message.
+ */
+declare const ConfirmPaymentGrantDeliveredResponseSchema: GenMessage<ConfirmPaymentGrantDeliveredResponse>;
+/**
+ * 결제 마켓.
+ *
+ * @generated from enum hiveng.v1.Market
+ */
+declare enum Market {
+    /**
+     * @generated from enum value: MARKET_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: MARKET_GOOGLE_PLAY = 1;
+     */
+    GOOGLE_PLAY = 1,
+    /**
+     * @generated from enum value: MARKET_APP_STORE = 2;
+     */
+    APP_STORE = 2,
+    /**
+     * @generated from enum value: MARKET_STEAM = 5;
+     */
+    STEAM = 5,
+    /**
+     * @generated from enum value: MARKET_WEB = 6;
+     */
+    WEB = 6
+}
+/**
+ * 구매 상태.
+ *
+ * @generated from enum hiveng.v1.PurchaseStatus
+ */
+declare enum PurchaseStatus {
+    /**
+     * @generated from enum value: PURCHASE_STATUS_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: PURCHASE_STATUS_PENDING = 1;
+     */
+    PENDING = 1,
+    /**
+     * @generated from enum value: PURCHASE_STATUS_VERIFIED = 2;
+     */
+    VERIFIED = 2,
+    /**
+     * @generated from enum value: PURCHASE_STATUS_FAILED = 3;
+     */
+    FAILED = 3,
+    /**
+     * @generated from enum value: PURCHASE_STATUS_REFUNDED = 4;
+     */
+    REFUNDED = 4,
+    /**
+     * @generated from enum value: PURCHASE_STATUS_CANCELED = 5;
+     */
+    CANCELED = 5,
+    /**
+     * @generated from enum value: PURCHASE_STATUS_EXPIRED = 6;
+     */
+    EXPIRED = 6
+}
+/**
+ * @generated from enum hiveng.v1.ProductType
+ */
+declare enum ProductType {
+    /**
+     * @generated from enum value: PRODUCT_TYPE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: PRODUCT_TYPE_ONE_TIME = 1;
+     */
+    ONE_TIME = 1,
+    /**
+     * @generated from enum value: PRODUCT_TYPE_SUBSCRIPTION = 2;
+     */
+    SUBSCRIPTION = 2
+}
+/**
+ * @generated from enum hiveng.v1.PaymentConsumePolicy
+ */
+declare enum PaymentConsumePolicy {
+    /**
+     * @generated from enum value: PAYMENT_CONSUME_POLICY_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: PAYMENT_CONSUME_POLICY_NONE = 1;
+     */
+    NONE = 1,
+    /**
+     * @generated from enum value: PAYMENT_CONSUME_POLICY_CONSUME_AFTER_GRANT = 2;
+     */
+    CONSUME_AFTER_GRANT = 2
+}
+/**
+ * @generated from enum hiveng.v1.PaymentGrantMode
+ */
+declare enum PaymentGrantMode {
+    /**
+     * @generated from enum value: PAYMENT_GRANT_MODE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: PAYMENT_GRANT_MODE_WEBHOOK_REQUIRED = 1;
+     */
+    WEBHOOK_REQUIRED = 1,
+    /**
+     * @generated from enum value: PAYMENT_GRANT_MODE_NO_GRANT = 2;
+     */
+    NO_GRANT = 2,
+    /**
+     * @generated from enum value: PAYMENT_GRANT_MODE_CLIENT_GRANT = 3;
+     */
+    CLIENT_GRANT = 3
+}
+/**
+ * 클라이언트 SDK용 결제 서비스.
+ *
+ * @generated from service hiveng.v1.PaymentService
+ */
+declare const PaymentService: GenService<{
+    /**
+     * 클라이언트에 노출 가능한 상품 목록 조회.
+     * auth: api_key + player_token
+     *
+     * @generated from rpc hiveng.v1.PaymentService.ListProducts
+     */
+    listProducts: {
+        methodKind: "unary";
+        input: typeof ListProductsRequestSchema;
+        output: typeof ListProductsResponseSchema;
+    };
+    /**
+     * 구매 시작 기록. 실제 마켓 결제창을 열기 전에 호출한다.
+     * auth: api_key + player_token
+     *
+     * @generated from rpc hiveng.v1.PaymentService.StartPurchase
+     */
+    startPurchase: {
+        methodKind: "unary";
+        input: typeof StartPurchaseRequestSchema;
+        output: typeof StartPurchaseResponseSchema;
+    };
+    /**
+     * 마켓 영수증 검증. 이미 처리된 영수증이면 ERROR_CODE_DUPLICATE_RECEIPT 반환.
+     * auth: api_key + player_token
+     *
+     * @generated from rpc hiveng.v1.PaymentService.VerifyPurchase
+     */
+    verifyPurchase: {
+        methodKind: "unary";
+        input: typeof VerifyPurchaseRequestSchema;
+        output: typeof VerifyPurchaseResponseSchema;
+    };
+    /**
+     * 로그인 플레이어의 구매 내역 단건 조회.
+     * auth: api_key + player_token
+     *
+     * @generated from rpc hiveng.v1.PaymentService.GetPurchase
+     */
+    getPurchase: {
+        methodKind: "unary";
+        input: typeof PaymentServiceGetPurchaseRequestSchema;
+        output: typeof PaymentServiceGetPurchaseResponseSchema;
+    };
+    /**
+     * 게임 서버 웹훅 지급 완료 확인.
+     * auth: service
+     *
+     * @generated from rpc hiveng.v1.PaymentService.ConfirmPaymentGrantDelivered
+     */
+    confirmPaymentGrantDelivered: {
+        methodKind: "unary";
+        input: typeof ConfirmPaymentGrantDeliveredRequestSchema;
+        output: typeof ConfirmPaymentGrantDeliveredResponseSchema;
+    };
+}>;
+
+interface PaymentPurchase {
+    id: string;
+    projectId: string;
+    playerId: string;
+    market: string;
+    productType: string;
+    productId: string;
+    packageName: string;
+    purchaseIntentId: string;
+    amountMinor: bigint;
+    currency: string;
+    status: string;
+    grantStatus: string;
+    consumeStatus: string;
+    marketOrderId: string;
+    purchasedAt?: Date;
+    verifiedAt?: Date;
+}
+type PaymentClient = Client<typeof PaymentService>;
+declare class PaymentApi {
+    private client;
+    bind(client: PaymentClient): void;
+    unbind(): void;
+    getPurchase(purchaseId: string): Promise<PaymentPurchase>;
+    waitForPaymentGrant(purchaseId: string, timeoutMillis?: number): Promise<PaymentPurchase>;
+    private requireClient;
+}
+
+declare class HiveNgClient {
+    readonly auth: AuthApi;
+    readonly notice: NoticeApi;
+    readonly mailbox: MailboxApi;
+    readonly payment: PaymentApi;
+    private readonly config;
+    private readonly session;
+    private readonly factory;
+    private endpoints;
+    private ready;
+    constructor(config: HiveNgConfig);
+    init(): Promise<void>;
+    isReady(): boolean;
+    endpointFor(domain: string): string | undefined;
+}
+declare function createHiveNg(config: HiveNgConfig): HiveNgClient;
+
+export { BannedError, type CheckNewMailResult, ErrorCode, HiveNgClient, type HiveNgConfig, HiveNgError, IdentityProvider, type ListMailOptions, type ListMailResult, type LoginProviders, type Mail, MailType, MaintenanceError, type Notice, type PaymentPurchase, type Player, type TransportFactory, type TransportFactoryOptions, createHiveNg, errorCodeOf, errorDetailOf };