@seayoo-web/gamer-api 1.0.0

package/dist/wx.js

@@ -0,0 +1,119 @@
+var a = Object.defineProperty;
+var h = (n, i, e) => i in n ? a(n, i, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[i] = e;
+var o = (n, i, e) => h(n, typeof i != "symbol" ? i + "" : i, e);
+import { NetRequest as k } from "@seayoo-web/request/wx";
+import { G as c, E as u, C as g, c as w, i as x } from "./event-CXcuEQsA.js";
+import { isPlainObject as l } from "@seayoo-web/utils";
+function m(n) {
+  return l(n, "openid", "unionid", "weixin_token");
+}
+class T {
+  /**
+   * 创建 WeixinApi 实例
+   *
+   * @param baseRequest - Gamer 通用的 request 工具实例，baseUrl 仅仅包含 endpoint + version
+   * @param autoLogin - 自动登录函数，由上层组件提供
+   */
+  constructor(i, e) {
+    o(this, "req");
+    o(this, "autoLogin");
+    this.req = i, this.autoLogin = e;
+  }
+  /**
+   * 微信静默登录，获取 weixinToken / openid / unionid，其中 weixinToken 应该被缓存
+   *
+   * 使用场景为：
+   *
+   * - 用户通过任意途径打开小程序的任意页面后，如果本地缓存中不存在微信用户身份信息，则自动调用此 API。
+   * - 调用成功后，应当使用存储能力将 response 中的微信用户身份信息缓存在本地。
+   *
+   * 小程序不应当频繁调用此 API。
+   *
+   * 由于小程序的存储是以用户维度隔离的，每个微信用户在每个小程序下只需要成功调用一次此 API。
+   *
+   * [API文档 weixin/login](https://kdocs.cn/l/cf2mO2uRLqh9?linkname=x17CeNlDQx)
+   *
+   * @param wxcode - 微信小程序调用 wx.login 获得的登录凭证
+   * @param appid - 微信小程序的 Appid，后端 api 可以从请求的 referer 中提取，后续会删除此参数
+   */
+  async login(i, e) {
+    const { data: t, code: s, message: r } = await this.req.post(
+      "weixin/login",
+      { code: i, appid: e },
+      m,
+      {
+        message: !1
+      }
+    );
+    return t ?? { error: s, message: r };
+  }
+  /**
+   * 关联游戏账号
+   *
+   * 用于从游戏内跳转至小程序时，将微信用户身份和游戏内身份关联起来，使得后续的企业微信客服流程能够知道该微信用户在游戏内的身份。
+   *
+   * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=ci73N833Mk
+   *
+   * @param weixinToken 调用 login 后，得到的 Weixin Token
+   * @param gameCode 从游戏内跳转至小程序时，通过请求参数 query 携带的 game_code
+   */
+  async linkPlayer(i, e) {
+    const { ok: t, code: s, message: r } = await this.req.post("weixin/link-player", {
+      weixin_token: i,
+      game_code: e
+    });
+    return t || { error: s, message: r };
+  }
+}
+class L extends c {
+  constructor(e, t) {
+    super(e, (t == null ? void 0 : t.version) || "v1", k);
+    o(this, "weixinToken", "");
+    /** event api 集合 */
+    o(this, "event");
+    /** club api 集合 */
+    o(this, "club");
+    /** weixin api 集合 */
+    o(this, "weixin");
+    const s = this.autoLogin.bind(this);
+    this.event = new u(this.req, s), this.club = new g(this.req, s), this.weixin = new T(this.req, s);
+  }
+  /**设置 Weixin Token，用于后续请求自动置换 Gamer Token */
+  setWeixinToken(e) {
+    return this.weixinToken !== e && (this.weixinToken = e, this.gamerToken = ""), this;
+  }
+  /** 读取设置 wexinToken */
+  getWexinToken() {
+    return this.weixinToken;
+  }
+  /**
+   * 用世游通行证统一登录能力签发的 idToken 和 weixinToken，自动置换 gamerToken，成功后会自动设置后续 Request Headers
+   *
+   * [世游通行证统一登录](https://kdocs.cn/l/cf2mO2uRLqh9?linkname=FJXYgqvLHs)
+   *
+   * [世游通行证统一登录 - 微信小程序](https://365.kdocs.cn/l/ccHVuUs0UsZs)
+   *
+   * - 此方法通常不需要手动调用，在需要登录的接口调用时会自动执行
+   * - 为了提高页面执行速度，可以在 setIdToken + setWeixinToken 后立即调用 autoLogin，比如
+   *
+   * @example
+   * ``` js
+   *  gamerApi.setIdToken("xxxxx").setWeixinToken("yyyyyy").autoLogin()
+   * ```
+   */
+  async autoLogin() {
+    if (this.gamerToken)
+      return !0;
+    if (!this.weixinToken || !this.idToken)
+      return w.error("Missing idToken / weixinToken when call autoLogin()"), !1;
+    const { data: e } = await this.req.post(
+      "login-with-token",
+      { id_token: this.idToken, weixin_token: this.weixinToken },
+      x
+    );
+    return this.gamerToken = (e == null ? void 0 : e.gamer_token) || "", !!this.gamerToken;
+  }
+}
+export {
+  L as GamerApi
+};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@seayoo-web/gamer-api",
+  "description": "agent for gamer api",
+  "version": "1.0.0",
+  "type": "module",
+  "source": "index.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./types/index.d.ts",
+  "files": [
+    "dist",
+    "types",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./wx": {
+      "types": "./types/wx.d.ts",
+      "import": "./dist/wx.js",
+      "default": "./dist/wx.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "author": "web@seayoo.com",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.13.1",
+    "@seayoo-web/request": "^2.0.8",
+    "@seayoo-web/tsconfig": "^1.0.2",
+    "@seayoo-web/utils": "^2.0.1"
+  },
+  "peerDependencies": {
+    "@seayoo-web/request": "^2.0.8",
+    "@seayoo-web/utils": "^2.0.1"
+  },
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint ./src/**/*.ts",
+    "lint:fix": "eslint ./src/**/*.{ts,js} --fix",
+    "prepublish": "pnpm lint:fix && pnpm build"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,29 @@
+import { GamerBaseApi } from "./src/base";
+import { ClubApi } from "./src/club";
+import { EventApi } from "./src/event";
+export declare class GamerApi extends GamerBaseApi {
+    /** event api 集合 */
+    event: EventApi;
+    /** club api 集合 */
+    club: ClubApi;
+    constructor(endpoint: string, option?: {
+        version?: string;
+        eventId?: number;
+    });
+    /**
+     * 用世游通行证统一登录能力签发的 ID Token，自动置换 Gamer Token，成功后会自动设置后续 Request Headers
+     *
+     * [世游通行证统一登录](https://kdocs.cn/l/cf2mO2uRLqh9?linkname=FJXYgqvLHs)
+     *
+     * [世游通行证统一登录 - Web 站点](https://365.kdocs.cn/l/cf57sp1qLlZh)
+     *
+     * - 此方法通常不需要手动调用，在需要登录的接口调用时会自动执行
+     * - 为了提高页面执行速度，可以在 setIdToken 后立即调用 autoLogin，比如
+     *
+     * @example
+     * ``` js
+     *  gamerApi.setIdToken("xxxxx").autoLogin()
+     * ```
+     */
+    autoLogin(): Promise<boolean>;
+}

package/types/src/base.d.ts

@@ -0,0 +1,64 @@
+import type { NetRequestFactory } from "@seayoo-web/request";
+/**
+ * [Gamer 系统架构](https://365.kdocs.cn/l/chWSTMvxyyCW?from=koa)
+ *
+ * [世游用户运营 api 服务](https://365.kdocs.cn/l/cf2mO2uRLqh9)
+ */
+export declare abstract class GamerBaseApi {
+    protected idToken: string;
+    protected gamerToken: string;
+    protected req: ReturnType<NetRequestFactory>;
+    constructor(endpoint: string, version: string, request: NetRequestFactory);
+    /** 设置从登录组件获取的 Id Token，用于后续请求自动置换 Gamer Token */
+    setIdToken(idToken: string): this;
+    /** 读取已经设置的 idToken */
+    getIdToken(): string;
+    /** 读取自动置换的 gamerToken */
+    getGamerToken(): string;
+    /**
+     * 根据 ID Token / Weixin Token 自动置换 Gamer Token
+     *
+     * ⚠️ 此方法需要覆盖，根据不同的场景 token 做具体实现
+     *
+     * [世游通行证的统一登录机制](https://kdocs.cn/l/cf2mO2uRLqh9?linkname=FJXYgqvLHs)
+     */
+    abstract autoLogin(): Promise<boolean>;
+    /**
+     * 获取当前 Session 的信息
+     *
+     * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=OdGVCdQxEu
+     */
+    getSession(): Promise<GamerSession | null>;
+    /**
+     * 根据手机号白名单，检查手机号是否允许登录某个游戏
+     *
+     * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=OWGSPF3Ysl
+     */
+    verifyMobileAllowed(mobile: string): Promise<VerifyMobileResult | null>;
+}
+export declare function isGamerTokenResponse(data: unknown): data is {
+    gamer_token: string;
+};
+interface GamerSession {
+    /** 世游通行证 ID */
+    seayoo_user_id?: string;
+    /** 手机号码（掩码形式） */
+    seayoo_mobile?: string;
+    /** 世游通行证用户实名信息（掩码形式） */
+    seayoo_real_name?: string;
+    /** Combo ID */
+    combo_id?: string;
+    /**
+     * combo_id 背后的 IdP
+     *
+     * 取值参见 [Combo Client REST API 中的 idp](https://kdocs.cn/l/cg0cfHzazsta?linkname=ZVDdf1pe48)，仅当 combo_id 有值时才有值
+     */
+    combo_idp?: string;
+}
+interface VerifyMobileResult {
+    /** 手机号是否允许登录此游戏（游戏 ID 由 Request Header 的 Origin 或 Referer 决定） */
+    allowed: boolean;
+    /** 手机号是否已注册世游通行证 */
+    registered: boolean;
+}
+export {};

package/types/src/club.d.ts

@@ -0,0 +1,67 @@
+import type { AutoLoginHandler } from "./utils";
+import type { NetRequestFactory } from "@seayoo-web/request";
+export declare class ClubApi {
+    private req;
+    private autoLogin;
+    /**
+     * 创建 ClubApi 实例
+     *
+     * @param baseRequest - Gamer 通用的 request 工具实例，baseUrl 仅仅包含 endpoint + version
+     * @param autoLogin - 自动登录函数，由上层组件提供
+     */
+    constructor(baseRequest: ReturnType<NetRequestFactory>, autoLogin: AutoLoginHandler);
+    /**
+     * 获取俱乐部配置
+     *
+     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=tuhsPt3ihp
+     */
+    getClubConfig(): Promise<import("./club.guards").ClubGlobalConfig | null>;
+    /**
+     * 用于游戏内嵌 Web 页面获取当前登录的游戏账号在俱乐部中的信息
+     *
+     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=hIDfaMlT7m
+     */
+    getCurrentPlayer(): Promise<import("./club.guards").ClubPlayer | null>;
+    /**
+     * 获取俱乐部当前关联的所有游戏账号
+     *
+     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=yccPUuagkA
+     */
+    getPlayers(): Promise<import("./club.guards").ClubPlayer[] | null>;
+    /**
+     * 俱乐部关联游戏主账号。在俱乐部查询不到主游戏账号信息时，前端自行调用。
+     *
+     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=SfGAm3mOyp
+     */
+    linkPrimaryPlayer(): Promise<import("./club.guards").ClubPlayer | null>;
+    /**
+     * 获取关联副游戏账号时所需的游戏服务器列表
+     *
+     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=cBqJkplCAN
+     */
+    getSecondaryServers(): Promise<import("./club.guards").Server[]>;
+    /**
+     * 通过角色邮件，向游戏角色发送验证码，用于游戏外关联副游戏账号至俱乐部会员
+     *
+     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=mG7yRPapRv
+     */
+    createLinkSecondaryPlayerOtp(serverId: string, roleId: string): Promise<string | null>;
+    /**
+     * 验证角色邮件收到的验证码
+     *
+     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=BhEdxXC5E4
+     */
+    verifyLinkSecondaryPlayerOtp(ticket: string, otp: string): Promise<import("./club.guards").VerifyLinkSecondaryPlayerOtpResponse | null>;
+    /**
+     * 关联副游戏账号至俱乐部会员，适用于游戏外环境
+     *
+     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=QNi2C2D0vO
+     */
+    linkSecondaryPlayerWithTicket(ticket: string): Promise<import("./club.guards").ClubPlayer | null>;
+    /**
+     * 关联副游戏账号至俱乐部会员，适用于游戏内嵌页环境
+     *
+     * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=QNi2C2D0vO
+     */
+    linkSecondaryPlayerWithIdToken(idToken: string): Promise<import("./club.guards").ClubPlayer | null>;
+}

package/types/src/club.guards.d.ts

@@ -0,0 +1,75 @@
+export interface ClubGlobalConfig {
+    /** 俱乐部默认头像地址 */
+    default_avatar_url: string;
+    /** 俱乐部官方头像库地址 */
+    official_avatar_urls: string[];
+    /** 俱乐部默认昵称 */
+    default_nickname: string;
+    /** 俱乐部默认签名 */
+    default_bio: string;
+    /** 俱乐部默认用户角色头像地址 */
+    default_role_avatar_url: string;
+    /** 俱乐部等级配置 */
+    level_configs: {
+        /** 俱乐部等级 */
+        level: number;
+        /** 等级对应的成长值 */
+        exp: number;
+        /** 俱乐部等级对应的称号 */
+        title: string;
+    }[];
+    /** 俱乐部等级有效期 */
+    level_valid_days: number;
+    /** 俱乐部权益描述 */
+    benefit_description: string;
+    /** 俱乐部成长值描述 */
+    exp_description: string;
+    /** 俱乐部积分规则描述 */
+    credit_description: string;
+    /** 发送角色邮件的频次限制，单位：秒 */
+    send_role_mail_rate_limit: number;
+}
+export declare function isClubConfigResponse(data: unknown): data is ClubGlobalConfig;
+export interface ClubPlayer {
+    /** 俱乐部会员 ID（世游通行证 ID） */
+    member_id: string;
+    /** Combo ID */
+    player_id: string;
+    /** 游戏账号类型 */
+    type: "primary" | "secondary";
+    /** 成长值 */
+    exp: number;
+    /** 等级 */
+    level: number;
+    /** 用户积分余额 */
+    credit: number;
+    /** 月底即将过期积分数量 */
+    credit_expiring: number;
+    /** 等级变动时间 */
+    level_change_time: number;
+    /** 等级过期时间 */
+    level_expire_time: number;
+}
+export declare function isClubPlayerResponse(data: unknown): data is {
+    player: ClubPlayer;
+};
+export declare function isClubPlayersResponse(data: unknown): data is {
+    players: ClubPlayer[];
+};
+export interface Server {
+    server_id: string;
+    server_name: string;
+}
+export declare function isGetSecondaryServersResponse(data: unknown): data is {
+    servers: Server[];
+};
+export declare function isCreateLinkSecondaryPlayerOtpResponse(data: unknown): data is {
+    ticket: string;
+};
+export interface VerifyLinkSecondaryPlayerOtpResponse {
+    role_id: string;
+    role_name: string;
+    server_id: string;
+    server_name: string;
+}
+export declare function isVerifyLinkSecondaryPlayerOtpResponse(data: unknown): data is VerifyLinkSecondaryPlayerOtpResponse;

package/types/src/event.config.d.ts

@@ -0,0 +1,228 @@
+export type EGameItemType = "event_item" | "game_item" | "physical_item" | "weixin_hongbao" | "gift_code" | "lottery_ticket" | "void_item";
+export type EFeatureType = "preregister" | "lottery" | "survey" | "invite" | "share" | "follow" | "weixin_subscribe" | "comment" | "vote" | "cashback" | "gift_code" | "register" | "invited_register" | "claim_rewards" | "quest" | "team" | "lottery_draw";
+export type EQuestObjective = "player_active_points" | "player_login_days" | "order_total_amount" | "community_posts" | "community_comments";
+export interface EventConfig {
+    /** 活动名称 */
+    event_name: string;
+    /** 面向玩家的富文本活动规则 */
+    rules: string;
+    /** 活动开始时间 */
+    since: number;
+    /** 活动结束时间 */
+    until: number;
+    /** 活动访问人数 */
+    visit_count: number;
+    /** 活动下玩法列表 */
+    features: EventFeatureConfig[];
+}
+export declare function isEventConfig(data: unknown): data is EventConfig;
+type EventFeatureConfig = EventFeatureBaseConfig<"preregister", NoopFeatureConfig> | EventFeatureBaseConfig<"lottery", FeatureLotteryConfig> | EventFeatureBaseConfig<"survey", FeatureSurveyConfig> | EventFeatureBaseConfig<"invite", FeatureInviteConfig> | EventFeatureBaseConfig<"share", FeatureShareConfig> | EventFeatureBaseConfig<"follow", FeatureFollowConfig> | EventFeatureBaseConfig<"weixin_subscribe", FeatureSubscribeConfig> | EventFeatureBaseConfig<"comment", FeatureCommentConfig> | EventFeatureBaseConfig<"vote", FeatureVoteConfig> | EventFeatureBaseConfig<"cashback", FeatureCashbackConfig> | EventFeatureBaseConfig<"gift_code", FeatureGiftCodeConfig> | EventFeatureBaseConfig<"register", NoopFeatureConfig> | EventFeatureBaseConfig<"invited_register", NoopFeatureConfig> | EventFeatureBaseConfig<"claim_rewards", NoopFeatureConfig> | EventFeatureBaseConfig<"quest", FeatureQuestConfig> | EventFeatureBaseConfig<"team", FeatureTeamConfig> | EventFeatureBaseConfig<"lottery_draw", FeatureLotteryDrawConfig>;
+interface EventRewardItemConfig {
+    /** 玩法奖励道具 id */
+    reward_item_id: number;
+    /** 玩法奖励道具数量 */
+    reward_amount: number;
+    /** 玩法奖励道具名称 */
+    reward_item_name: string;
+    /** 玩法奖励道具图片地址 */
+    reward_item_icon_url: string;
+    /** 玩法奖励道具描述 */
+    reward_item_desc?: string;
+    /** 玩法奖励道具类型  */
+    reward_item_type: EGameItemType;
+}
+type FeatureReward = {
+    feature_reward_type: "every";
+    reward_details: EventRewardItemConfig[];
+} | {
+    feature_reward_type: "regular";
+    reward_details: {
+        engage_count: number;
+        rewards: EventRewardItemConfig[];
+    }[];
+};
+export type NoopFeatureConfig = {} | null;
+interface EventFeatureBaseConfig<T extends EFeatureType = EFeatureType, C extends object | null = object> {
+    /** 玩法名称 */
+    feature_name: string;
+    /** 玩法 Id */
+    feature_id: number;
+    /** 玩法描述 */
+    description: string;
+    /** 玩法类型 */
+    feature_type: T;
+    /** 玩法配置 */
+    config: C;
+    /** 玩法周期，即每多长时间可参与一次 */
+    cycle: "none" | "daily" | "weekly" | "monthly";
+    /** 允许的最大参与次数 */
+    limit: number;
+    /** 玩法开始时间 */
+    since: number;
+    /** 玩法结束时间 */
+    until: number;
+    /** 参与玩法维度账号类型 user_id（世游通行证 ID / Combo ID） 或 role_id（游戏角色 ID） */
+    engage_account_type: "user_id" | "role_id";
+    /** 玩法参与奖励 */
+    feature_rewards: FeatureReward;
+}
+interface FeatureLotteryItemConfig {
+    /** 抽奖奖励道具 id */
+    reward_item_id: number;
+    /** 抽奖奖励道具名称 */
+    reward_item_name: string;
+    /** 抽奖奖励道具类型   */
+    reward_item_type: Exclude<EGameItemType, "gift_code" | "lottery_ticket">;
+    /** 抽奖奖励道具图片地址 */
+    reward_item_icon_url: string;
+    /** 抽奖奖励道具描述 */
+    reward_item_desc?: string;
+    /** 抽奖奖励道具数量 */
+    reward_amount: number;
+    /** 抽奖奖励道具库存 */
+    reward_remaining_stock: number;
+}
+interface FeatureLotteryConfig {
+    /** 抽奖消耗道具 id */
+    consume_item_id: number;
+    /** 抽奖消耗道具名称 */
+    consume_item_name: number;
+    /** 抽奖消耗道具图片地址 */
+    consume_item_icon_url: string;
+    /** 抽奖消耗道具数量配置 */
+    consume_item_count: number;
+    /** 抽奖消耗道具描述 */
+    consume_item_desc?: string;
+    /** 抽奖配置奖励列表  */
+    rewards: FeatureLotteryItemConfig[];
+}
+interface FeatureSurveyConfig {
+    /** 问卷 ID */
+    survey_id: string;
+    /** 问卷 url 地址 */
+    survey_url: string;
+}
+interface FeatureInviteConfig {
+    /** 邀请玩法配置分享链接 */
+    share_url: string;
+}
+interface FeatureShareConfig {
+    /** 分享玩法配置分享平台 */
+    share_platform: string;
+    /** 分享玩法配置跳转地址 */
+    jump_url?: string;
+    /** 分享玩法分享平台图标 */
+    icon_url?: string;
+}
+interface FeatureFollowConfig {
+    /**
+     * 社交媒体平台的标识
+     *
+     * 比如 "bilibili", "douyin", "xiaohongshu", "weibo", "weixin_official_account", "qq"
+     */
+    platform: string;
+    /** 社交媒体平台 icon */
+    platform_icon?: string;
+    /** 跳转链接 */
+    link?: string;
+    /** 二维码链接地址 */
+    qr_code_url?: string;
+    /** 社交媒体平台描述 */
+    platform_desc?: string;
+}
+interface FeatureSubscribeConfig {
+    /** 一组微信订阅消息模版 ID */
+    weixin_template_ids: string[];
+}
+interface FeatureCommentConfig {
+    /** 活动配置的弹幕信息，用于快捷选择 */
+    comments: string[];
+    /** 发送频率限制，单位：秒 */
+    send_rate: number;
+}
+interface FeatureVoteConfig {
+    /** 关联一个或多个投票玩法 ID */
+    vote_feature_ids: number[];
+    /** 关联一个或多个投稿玩法 ID */
+    submission_feature_ids: number[];
+    /** 入围数量 */
+    finalists_amount: number;
+    /** 选项来源 */
+    source: "system" | "user_submission" | "shortlisted";
+    /** 投票选项配置 */
+    options: FeatureVoteOption[];
+    /** 投票入围后用户可获得的奖励 */
+    rewards: EventRewardItemConfig[];
+}
+interface FeatureVoteOption {
+    /** 选项标识 */
+    sn: string;
+    /** 选项名称 */
+    name: string;
+    /** 选项图片地址 */
+    img_urls?: string[];
+    /** 选项视频地址 */
+    video_urls?: string[];
+    /** 选项描述文本 */
+    descriptions?: string[];
+    /** 跳转地址 */
+    jump_url: string;
+    /** 选项投票数量 */
+    amount: number;
+    /** 选项是否入围 */
+    finalists: boolean;
+    /** 最后投票时间秒级时间戳 */
+    last_vote_time: number;
+}
+interface FeatureCashbackConfig {
+    /** 计算充值总额的开始时间 */
+    order_start_time: number;
+    /** 计算充值总额的结束时间 */
+    order_end_time: number;
+    /** 可领取充值返还奖励的开始时间 */
+    claim_rewards_start_time: number;
+    /** 可领取充值返还奖励的结束时间 */
+    claim_rewards_end_time: number;
+}
+interface FeatureGiftCodeConfig {
+    /** 用于前端显示礼包码兑换后会获得的奖励内容 */
+    gift_items: EventGiftItemConfig[];
+    /** 社媒平台链接 */
+    mp_url?: string;
+    /** 社媒平台二维码 */
+    mp_qrcode_url?: string;
+}
+interface EventGiftItemConfig {
+    /** 用于前端展示的游戏道具名称 */
+    name: string;
+    /** 用于前端展示的游戏道具图片地址 */
+    icon_url: string;
+    /** 用于前端展示的游戏道具数量 */
+    count: number;
+}
+interface FeatureQuestConfig {
+    /** 任务目标 */
+    objective: EQuestObjective;
+    /** 目标值 */
+    completion_value: number;
+    /** 团队任务配置 */
+    team?: {
+        /** 组队任务 ID */
+        feature_id?: number;
+        /** 目标值 */
+        completion_value: number;
+    };
+}
+interface FeatureTeamConfig {
+    /** 队伍最大成员数 */
+    max_members: number;
+    /** 队伍最小成员数 */
+    min_members: number;
+}
+interface FeatureLotteryDrawConfig {
+    /** 可开奖起始时间 */
+    draw_not_before: number;
+    /** 可开奖结束时间 */
+    draw_not_after: number;
+}
+export {};