import type { ClubAddress, ClubUserProfile, RedeemParams } from "./club.define";
import type { ClubCreditChangeType, ClubItemType } from "./club.enums";
import type { UgcSocialMedia } from "./event.enums";
import type { AuthToken } from "./token";
import type { RequestInternalError, RequestOptions } from "@seayoo-web/request";
import type { SomePartial } from "@seayoo-web/utils";
export declare class ClubApi {
    private token;
    private req;
    constructor(authToken: AuthToken);
    /**
     * 获取俱乐部配置
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=tuhsPt3ihp
     */
    getConfig(requestOptions?: RequestOptions): Promise<import("./club.define").ClubGlobalConfig | null>;
    /**
     * 用于游戏内嵌 Web 页面和微信小程序获取当前登录的游戏账号在俱乐部中的信息。
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=hIDfaMlT7m
     */
    getCurrentPlayer(requestOptions?: RequestOptions): Promise<import("./club.define").ClubPlayer | {
        message: string;
        error: RequestInternalError | "seayoo_account_already_deleted" | "player_not_found";
    }>;
    /**
     * 俱乐部用户关联游戏账号
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=Dpb9JAKqzG
     */
    linkPlayer(requestOptions?: RequestOptions): Promise<import("./club.define").ClubPlayer | {
        message: string;
        error: RequestInternalError | "seayoo_user_id_has_combo_id" | "combo_id_has_seayoo_user_id";
    }>;
    /**
     * 关联游戏账号
     *
     * https://www.kdocs.cn/l/cpaabaxfsvaj?linkname=awQyxBMqkM
     */
    linkPlayerV2(option: {
        /**
         * 授权类型
         *
         * - `session_seayoo` 通过 gamer 登录后的 session 授权，将 seayoo identity 对应的 combo_id 关联至俱乐部账号（游戏内 | 游戏外）
         * - `session_combo` 通过 gamer 登录后的 session 授权，将 combo identity 对应的 combo_id 关联至俱乐部账号（游戏内，暂不实现）
         */
        grant_type: "session_seayoo" | "session_combo";
    } | {
        /** 授权类型，`ticket` 表示服务端将 ticket 背后缓存的 combo_id 关联至俱乐部账号 */
        grant_type: "ticket";
        /** verify-role-otp 返回的 ticket */
        ticket: string;
    }, requestOptions?: RequestOptions): Promise<true | {
        message: string;
        error: RequestInternalError | "member_not_found" | "unsupported_grant_type" | "invalid_ticket" | "player_not_found" | "player_already_linked" | "player_claimed_by_other_member" | "player_is_seayoo_account" | "should_link_by_seayoo";
    } | null>;
    /**
     * 解除游戏账号关联
     *
     * https://www.kdocs.cn/l/cpaabaxfsvaj?linkname=qCCNWpxpHq
     */
    unlinkPlayer(requestOptions?: RequestOptions): Promise<true | {
        message: string;
        error: RequestInternalError | "member_not_found" | "player_not_found" | "unlink_lockup_not_reached";
    } | null>;
    /**
     * 发送角色验证码
     *
     * https://www.kdocs.cn/l/cpaabaxfsvaj?linkname=m4AMDTqmZs
     */
    sendRoleOtp(option: {
        /** 发送角色邮件验证码的动作，`link-player` 为关联游戏账号 */
        action: "link-player";
        /** 角色 ID */
        role_id: string;
        /** 服务器 ID，混服游戏不需要传该参数 */
        server_id?: string;
    }, requestOptions?: RequestOptions): Promise<true | {
        message: string;
        error: RequestInternalError | "member_not_found" | "role_not_found" | "send_otp_rate_limited";
    } | null>;
    /**
     * 验证角色验证码，返回一次性授权凭证 ticket，用于 link-player(grant_type=ticket)
     *
     * https://www.kdocs.cn/l/cpaabaxfsvaj?linkname=HbCOOTrEbS
     */
    verifyRoleOtp(option: {
        /** 发送角色邮件验证码的动作，`link-player` 为关联游戏账号 */
        action: "link-player";
        /** 验证码 */
        otp: string;
        /** 角色 ID */
        role_id: string;
        /** 服务器 ID，混服游戏不需要传该参数 */
        server_id?: string;
    }, requestOptions?: RequestOptions): Promise<string | {
        message: string;
        error: RequestInternalError | "member_not_found" | "otp_expired" | "otp_not_match" | "otp_too_many_attempts";
    } | null>;
    /**
     * 获取俱乐部关联的游戏账号下的角色列表
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=nwu4FiGM9V
     */
    getRoles(playerId?: string, forceReload?: boolean, requestOptions?: RequestOptions): Promise<import("./club.define").PlayerRole[]>;
    /**
     * 获取俱乐部会员的角色卡片数据
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=A1Wr7kUXnS
     */
    getRoleCard(memberId: string, requestOptions?: RequestOptions): Promise<import("./club.define").PlayerRoleCard | null>;
    /**
     * 设置自己的角色卡片
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=XgMf6OFE5i
     */
    setRoleCard(option: {
        player_id: string;
        server_id: string;
        role_id: string;
    }, requestOptions?: RequestOptions): Promise<import("./club.define").PlayerRoleCard | null>;
    /**
     * 强制刷新自己的角色卡片，从游戏内获取最新数据
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=RPdJquwmgv
     */
    refreshRoleCard(requestOptions?: RequestOptions): Promise<import("./club.define").PlayerRoleCard | null>;
    /**
     * 创建俱乐部账号，重复创建会返回成功
     *
     * 注册成功以后会在当前用户的 session 中记录 seayoo_user_id，供后续使用 club 相关功能（游戏内）
     *
     * https://www.kdocs.cn/l/cpaabaxfsvaj?linkname=SKL4MxaCdK
     */
    registerMember(requestOptions?: RequestOptions): Promise<import("./club.define").ClubMember | {
        message: string;
        error: RequestInternalError;
    }>;
    /**
     * 查询俱乐部账号信息
     *
     * https://www.kdocs.cn/l/cpaabaxfsvaj?linkname=H5t6bq6r2h
     */
    getMember(requestOptions?: RequestOptions): Promise<import("./club.define").ClubMember | {
        message: string;
        error: RequestInternalError;
    } | null>;
    /**
     * 获取俱乐部用户的信息
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=TMWBCFcOr2
     */
    getUserProfile(memberId: string, requestOptions?: RequestOptions): Promise<ClubUserProfile | null>;
    /**
     * 修改自己的俱乐部用户信息
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=Qt822A57jd
     */
    updateUserProfile(option: Partial<ClubUserProfile>, requestOptions?: RequestOptions): Promise<ClubUserProfile | {
        error: "OptionIsEmpty";
        message: string;
    } | {
        message: string;
        error: RequestInternalError | "player_not_found" | "sensitive_nickname" | "sensitive_bio" | "sensitive_avatar";
    }>;
    /**
     * 获取自己的俱乐部收货地址列表
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=NowUIynMVn
     */
    getAddresses(requestOptions?: RequestOptions): Promise<ClubAddress[]>;
    /**
     * 增加俱乐部收货地址
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=TaGIIYDRYA
     */
    addAddress(option: Omit<SomePartial<ClubAddress, "is_default">, "address_id">, requestOptions?: RequestOptions): Promise<ClubAddress | {
        message: string;
        error: RequestInternalError;
    } | null>;
    /**
     * 修改自己的俱乐部收货地址
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=p9FlJhHnWN
     */
    updateAddress(option: SomePartial<ClubAddress, "is_default">, requestOptions?: RequestOptions): Promise<ClubAddress | {
        message: string;
        error: RequestInternalError | "address_not_found";
    }>;
    /**
     * 删除自己的俱乐部收货地址
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=MEEOBdf8rm
     */
    deleteAddress(addressId: number, requestOptions?: RequestOptions): Promise<boolean | null>;
    /**
     * 获取俱乐部积分统计信息
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=x4uxtGstRL
     */
    getUserCredit(option: {
        /** 开始时间的秒时间戳 */
        start_time: number;
        /** 结束时间的秒时间戳 */
        end_time: number;
        /** 游戏账号 ID，游戏外必传 */
        player_id?: string;
    }, requestOptions?: RequestOptions): Promise<import("./club.define").ClubUserCredit | {
        message: string;
        error: RequestInternalError | "player_not_found";
    }>;
    /**
     * 获取自己的俱乐部积分变动记录
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=lQFgF689P8
     */
    getCreditLogs(option: {
        /** 单次获取数量 */
        max_results?: number;
        /** 分页游标；首次请求为空 */
        next_token?: string;
        /** 积分变动类型 */
        change_type?: ClubCreditChangeType;
        /** 开始时间的秒时间戳 */
        start_time: number;
        /** 结束时间的秒时间戳 */
        end_time: number;
        /** 游戏账号 ID，游戏外必传 */
        player_id?: string;
    }, requestOptions?: RequestOptions): Promise<{
        credit_logs: import("./club.define").ClubCreditLog[];
        next_token: string | undefined;
    }>;
    /**
     * 获取自己的俱乐部权益列表
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=UFSDGvqkdV
     */
    getBenefits(requestOptions?: RequestOptions): Promise<import("./club.define").ClubBenefitSummary[]>;
    /**
     * 获取某个权益详细信息
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=XKto0MeaHF
     */
    getBenefit(benefitId: number, requestOptions?: RequestOptions): Promise<import("./club.define").ClubBenefit | null>;
    /**
     * 获取商城商品列表
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=r3vC3PzfMQ
     */
    getProducts(option?: {
        /** 游戏账号 ID，游戏外必传 */
        player_id?: string;
        /** 商品分类 ID */
        catalog_id?: number;
    }, requestOptions?: RequestOptions): Promise<import("./club.define").ClubProduct[]>;
    /**
     * 兑换商城商品
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=LWcMVwX3OY
     */
    redeemProduct(option: {
        /** 商品 ID */
        product_id: number;
        /** 商品数量 */
        quantity: number;
        /** 兑换参数，由 product_id 对应的 item_type 决定 */
        params?: RedeemParams;
        /** 游戏账号 ID，游戏外必传 */
        player_id?: string;
    }, requestOptions?: RequestOptions): Promise<true | {
        message: string;
        error: RequestInternalError | "mall_product_not_found" | "credit_not_found" | "role_not_found" | "player_level_not_enough" | "credit_balance_not_enough" | "redeem_product_quantity_exceeds_limit" | "redeem_quantity_over_stock" | "redeem_quantity_over_daily_limit" | "redeem_quantity_over_month_limit" | "redeem_quantity_over_year_limit" | "redeem_quantity_over_total_limit" | "club_redeem_condition_dissatisfied";
    }>;
    /**
     * 获取兑换记录
     *
     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=Ml6mLgT4cM
     */
    getRedemptions(option: {
        /** 单次获取数量 */
        max_results?: number;
        /** 分页游标；首次请求为空 */
        next_token?: string;
        /** 物品类型 */
        item_type?: ClubItemType;
        /** 游戏账号 ID，游戏外必传 */
        player_id?: string;
    }, requestOptions?: RequestOptions): Promise<{
        redemptions: import("./club.define").Redemption[];
        next_token: string | undefined;
    }>;
    /**
     * 图片预上传地址获取，为 club 服务提供预签名上传 URL，供用户客户端上传图片资源
     *
     * https://www.kdocs.cn/l/cgp4gSBMbOf1?linkname=d4IHcCQu34
     */
    clubUploadImage(option: {
        /** 业务上传范围 */
        scope: "avatar" | "social_homepage";
        /** 当 scope 为 social_homepage 时，此参数为必填项 */
        social_media?: UgcSocialMedia;
        /** 待上传文件的 MIME Type,仅支持上传标准图片格式 image/jpeg 和 image/png */
        content_type: "image/jpeg" | "image/png";
        /** 待上传文件的字节大小，用于限制 S3 上传 */
        content_length: number;
        /** 待上传文件的 SHA-256 哈希值 用于校验上传对象的完整性 */
        content_sha256: string;
    }, requestOptions?: RequestOptions): Promise<{
        existed: boolean;
        image_upload_url: string | undefined;
        image_id: string;
    } | {
        message: string;
        error: RequestInternalError | "address_not_found";
    }>;
}