@seayoo-web/gamer-api 2.3.1 → 2.3.3

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

@@ -0,0 +1,7 @@
+import { type EventFeatureBaseConfig } from "./feature.base";
+declare const featureType: "invited_register";
+export type EventFeatureConfigOfInvitedRegister = EventFeatureBaseConfig & {
+    feature_type: typeof featureType;
+};
+export declare const EventFeatureConfigOfInvitedRegisterValidator: import("@seayoo-web/utils").ObjectValidator<EventFeatureConfigOfInvitedRegister, false, false>;
+export {};

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

@@ -0,0 +1,14 @@
+import { type EventFeatureBaseConfig } from "./feature.base";
+declare const featureType: "lottery_draw";
+export interface FeatureLotteryDrawConfig {
+    /** 可开奖起始时间 */
+    draw_not_before: number;
+    /** 可开奖结束时间 */
+    draw_not_after: number;
+}
+export type EventFeatureConfigOfLotteryDraw = EventFeatureBaseConfig & {
+    feature_type: typeof featureType;
+    config: FeatureLotteryDrawConfig;
+};
+export declare const EventFeatureConfigOfLotteryDrawValidator: import("@seayoo-web/utils").ObjectValidator<EventFeatureConfigOfLotteryDraw, false, false>;
+export {};

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

@@ -0,0 +1,7 @@
+import { type EventFeatureBaseConfig } from "./feature.base";
+declare const featureType: "preregister";
+export type EventFeatureConfigOfPreregister = EventFeatureBaseConfig & {
+    feature_type: typeof featureType;
+};
+export declare const EventFeatureConfigOfPreregisterValidator: import("@seayoo-web/utils").ObjectValidator<EventFeatureConfigOfPreregister, false, false>;
+export {};

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

@@ -0,0 +1,31 @@
+import { type QuestObjective } from "../event.enums";
+import { type EventFeatureBaseConfig } from "./feature.base";
+declare const featureType: "quest";
+export interface FeatureQuestConfig {
+    /** 任务目标 */
+    objective: QuestObjective;
+    /** 目标值 */
+    completion_value: number;
+    /** 团队任务配置 */
+    team?: {
+        /** 组队任务 ID */
+        feature_id?: number;
+        /** 目标值 */
+        completion_value: number;
+    };
+    /** 任务专用配置，取决于任务目标类型 */
+    config?: {
+        /** 当任务目标为 community_posts 和 community_comments 有效，表示关联的社区话题，可能无值 */
+        topic_id?: number;
+        /** 参与对局的玩家数量，当任务目标为 player_match_counts 和 player_match_days 有效，不小于 1 */
+        required_players?: number;
+        /** 单日对局次数，当任务目标为 player_match_days 有效，不小于 1 */
+        required_matches?: number;
+    };
+}
+export type EventFeatureConfigOfQuest = EventFeatureBaseConfig & {
+    feature_type: typeof featureType;
+    config: FeatureQuestConfig;
+};
+export declare const EventFeatureConfigOfQuestValidator: import("@seayoo-web/utils").ObjectValidator<EventFeatureConfigOfQuest, false, false>;
+export {};

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

@@ -0,0 +1,7 @@
+import { type EventFeatureBaseConfig } from "./feature.base";
+declare const featureType: "register";
+export type EventFeatureConfigOfRegister = EventFeatureBaseConfig & {
+    feature_type: typeof featureType;
+};
+export declare const EventFeatureConfigOfRegisterValidator: import("@seayoo-web/utils").ObjectValidator<EventFeatureConfigOfRegister, false, false>;
+export {};

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

@@ -0,0 +1,16 @@
+import { type EventFeatureBaseConfig } from "./feature.base";
+declare const featureType: "share";
+export interface FeatureShareConfig {
+    /** 分享玩法配置分享平台 */
+    share_platform: string;
+    /** 分享玩法配置跳转地址 */
+    jump_url?: string;
+    /** 分享玩法分享平台图标 */
+    icon_url?: string;
+}
+export type EventFeatureConfigOfShare = EventFeatureBaseConfig & {
+    feature_type: typeof featureType;
+    config: FeatureShareConfig;
+};
+export declare const EventFeatureConfigOfShareValidator: import("@seayoo-web/utils").ObjectValidator<EventFeatureConfigOfShare, false, false>;
+export {};

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

@@ -0,0 +1,12 @@
+import { type EventFeatureBaseConfig } from "./feature.base";
+declare const featureType: "weixin_subscribe";
+export interface FeatureSubscribeConfig {
+    /** 一组微信订阅消息模版 ID */
+    weixin_template_ids: string[];
+}
+export type EventFeatureConfigOfSubscribe = EventFeatureBaseConfig & {
+    feature_type: typeof featureType;
+    config: FeatureSubscribeConfig;
+};
+export declare const EventFeatureConfigOfSubscribeValidator: import("@seayoo-web/utils").ObjectValidator<EventFeatureConfigOfSubscribe, false, false>;
+export {};

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

@@ -0,0 +1,14 @@
+import { type EventFeatureBaseConfig } from "./feature.base";
+declare const featureType: "survey";
+export interface FeatureSurveyConfig {
+    /** 问卷 ID */
+    survey_id: string;
+    /** 问卷 url 地址 */
+    survey_url: string;
+}
+export type EventFeatureConfigOfSurvey = EventFeatureBaseConfig & {
+    feature_type: typeof featureType;
+    config: FeatureSurveyConfig;
+};
+export declare const EventFeatureConfigOfSurveyValidator: import("@seayoo-web/utils").ObjectValidator<EventFeatureConfigOfSurvey, false, false>;
+export {};

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

@@ -0,0 +1,14 @@
+import { type EventFeatureBaseConfig } from "./feature.base";
+declare const featureType: "team";
+export interface FeatureTeamConfig {
+    /** 队伍最大成员数 */
+    max_members: number;
+    /** 队伍最小成员数 */
+    min_members: number;
+}
+export type EventFeatureConfigOfTeam = EventFeatureBaseConfig & {
+    feature_type: typeof featureType;
+    config: FeatureTeamConfig;
+};
+export declare const EventFeatureConfigOfTeamValidator: import("@seayoo-web/utils").ObjectValidator<EventFeatureConfigOfTeam, false, false>;
+export {};

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

@@ -0,0 +1,44 @@
+import { type VoteOptionSource } from "../event.enums";
+import { type EventFeatureBaseConfig } from "./feature.base";
+import { type EventRewardItemConfig } from "./reward";
+declare const featureType: "vote";
+export 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;
+}
+export interface FeatureVoteConfig {
+    /** 关联一个或多个投票玩法 ID */
+    vote_feature_ids: number[];
+    /** 关联一个或多个投稿玩法 ID */
+    submission_feature_ids: number[];
+    /** 入围数量 */
+    finalists_amount: number;
+    /** 选项来源 */
+    source: VoteOptionSource;
+    /** 投票选项配置 */
+    options: FeatureVoteOption[];
+    /** 投票入围后用户可获得的奖励 */
+    rewards: EventRewardItemConfig[];
+}
+export type EventFeatureConfigOfVote = EventFeatureBaseConfig & {
+    feature_type: typeof featureType;
+    config: FeatureVoteConfig;
+};
+export declare const EventFeatureConfigOfVoteValidator: import("@seayoo-web/utils").ObjectValidator<EventFeatureConfigOfVote, false, false>;
+export {};

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

@@ -0,0 +1,23 @@
+import { type EventFeatureConfig } from "./feature";
+export * from "./feature";
+export * from "./reward";
+export interface EventConfig {
+    /** 活动名称 */
+    event_name: string;
+    /** 面向玩家的富文本活动规则 */
+    rules: string;
+    /** 活动开始时间 */
+    since: number;
+    /** 活动结束时间 */
+    until: number;
+    /** 活动访问人数 */
+    visit_count?: number;
+    /** 活动下玩法列表 */
+    features: EventFeatureConfig[];
+}
+export declare const EventConfigValidator: import("@seayoo-web/utils").ObjectValidator<EventConfig, false, false> & {
+    plain: never;
+    optional: never;
+    maybeNull: never;
+    lock: never;
+};

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

@@ -0,0 +1,48 @@
+import { type UserEngagementData, type EngageReward } from "./event.engage";
+import { type ClaimRewardStatus } from "./event.enums";
+export * from "./event.config";
+export * from "./event.engage";
+export interface VerifyMobileResult {
+    /** 手机号是否允许登录此游戏（游戏 ID 由 Request Header 的 Origin 或 Referer 决定） */
+    allowed: boolean;
+    /** 手机号是否已注册世游通行证 */
+    registered: boolean;
+}
+export declare const VerifyMobileResultValidator: import("@seayoo-web/utils").ObjectValidator<VerifyMobileResult, false, false>;
+export interface UserFeatureStatus {
+    /** 玩法 ID */
+    feature_id: number;
+    /**
+     * 是否可参与玩法。false 代表当前已不可再参与。
+     *
+     * 💡注意这里的语义是已经达到了参与次数的上限，不能再调用 engage，而不是没有资格参与。
+     */
+    can_engage: boolean;
+    /** 是否有已获得但尚未领取的玩法参与奖励 */
+    has_unclaimed_rewards: boolean;
+}
+export declare const UserFeatureStatusValidator: import("@seayoo-web/utils").ObjectValidator<UserFeatureStatus, false, false>;
+export interface EngageResponse {
+    /** 当前参与记录 ID */
+    engagement_id: number;
+    /** 用户玩法参与记录 */
+    engagement?: {
+        engagement_id: number;
+        sequence: number;
+        feature_id: number;
+        /** 附带的数据，由 feature_id 的类型决定 */
+        data?: UserEngagementData;
+    };
+    /** 用户参与玩法得到的奖励 */
+    rewards?: EngageReward[];
+    /** 参与玩法后是否需要微信扫码 */
+    scan?: boolean;
+}
+export declare const EngageResponseValidator: import("@seayoo-web/utils").ObjectValidator<EngageResponse, false, false>;
+export interface ClaimedItem {
+    /** 用户奖励记录 id */
+    reward_id: number;
+    /** 领取后的奖励状态 */
+    reward_status: ClaimRewardStatus;
+}
+export declare const ClaimedItemValidator: import("@seayoo-web/utils").ObjectValidator<ClaimedItem, false, false>;

package/types/src/event.engage/engage.cashback.d.ts

@@ -0,0 +1,9 @@
+export interface CashbackEngagementData {
+    /** 用户充值订单总金额（分） */
+    order_total_amount: `${number}` | number;
+    /** 充值返还的总金额（分） */
+    cashback_total_amount: `${number}` | number;
+    /** 充值返还的总金额所对应的游戏道具数量 */
+    game_item_count: `${number}` | number;
+}
+export declare const CashbackEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<CashbackEngagementData, false, false>;

package/types/src/event.engage/engage.claimActivationKey.d.ts

@@ -0,0 +1,5 @@
+export interface ClaimActivationKeyEngagementData {
+    /** 激活码 */
+    activation_key: string;
+}
+export declare const ClaimActivationKeyEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<ClaimActivationKeyEngagementData, false, false>;

package/types/src/event.engage/engage.comment.d.ts

@@ -0,0 +1,22 @@
+/** 评论玩法的参与记录 */
+export interface CommentEngagement {
+    /** 用户世游通行证 ID */
+    user_id: string;
+    /** 用户昵称 */
+    name: string;
+    /** 用户头像地址 */
+    avatar_url: string;
+    /** 评论信息 */
+    comment: string;
+    /** 用户发布弹幕的视频点 */
+    video_note: number;
+    /** 用户发布弹幕的时间 */
+    created_at: number;
+}
+export declare const CommentEngagementValidator: import("@seayoo-web/utils").ObjectValidator<CommentEngagement, false, false>;
+export interface CommentEngagementParam {
+    /** 用户发送弹幕内容 */
+    comment: string;
+    /** 用户发布弹幕的视频点 */
+    video_note?: number;
+}

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

@@ -0,0 +1,49 @@
+import { type CashbackEngagementData } from "./engage.cashback";
+import { type ClaimActivationKeyEngagementData } from "./engage.claimActivationKey";
+import { type GiftCodeEngagementData } from "./engage.giftcode";
+import { type InviteEngagementData } from "./engage.invite";
+import { type LotteryEngagementData } from "./engage.lottery";
+import { type LotteryDrawEngagementData } from "./engage.lotteryDraw";
+import { type PreregisterEngagementData } from "./engage.preregister";
+import { type QuestEngagementData } from "./engage.quest";
+import { type ShareEngagementData } from "./engage.share";
+import { type WeixinSubscribeEngagementData } from "./engage.subscribe";
+import { type SurveyEngagementData } from "./engage.survey";
+import { type TeamEngagementData } from "./engage.team";
+import { type VoteEngagementData } from "./engage.vote";
+export * from "./engage.cashback";
+export * from "./engage.comment";
+export * from "./engage.giftcode";
+export * from "./engage.invite";
+export * from "./engage.lottery";
+export * from "./engage.lotteryDraw";
+export * from "./engage.preregister";
+export * from "./engage.quest";
+export * from "./engage.share";
+export * from "./engage.subscribe";
+export * from "./engage.survey";
+export * from "./engage.team";
+export * from "./engage.vote";
+export * from "./engage.claimActivationKey";
+export type EmptyObject = Record<string | number | symbol, never>;
+export type UserEngagementData = PreregisterEngagementData | LotteryEngagementData | SurveyEngagementData | InviteEngagementData | ShareEngagementData | VoteEngagementData | WeixinSubscribeEngagementData | CashbackEngagementData | GiftCodeEngagementData | TeamEngagementData | QuestEngagementData | LotteryDrawEngagementData | ClaimActivationKeyEngagementData | EmptyObject;
+export declare const UserEngagementDataValidator: import("@seayoo-web/utils").UnionValidator<[import("@seayoo-web/utils").ObjectValidator<{
+    platforms: string[];
+}, false, false>, import("@seayoo-web/utils").ObjectValidator<LotteryEngagementData, false, false>, import("@seayoo-web/utils").ObjectValidator<{
+    serial_number: number;
+}, false, false>, import("@seayoo-web/utils").ObjectValidator<InviteEngagementData, false, false>, import("@seayoo-web/utils").ObjectValidator<ShareEngagementData, false, false>, import("@seayoo-web/utils").ObjectValidator<VoteEngagementData, false, false>, import("@seayoo-web/utils").ObjectValidator<WeixinSubscribeEngagementData, false, false>, import("@seayoo-web/utils").ObjectValidator<CashbackEngagementData, false, false>, import("@seayoo-web/utils").ObjectValidator<GiftCodeEngagementData, false, false>, import("@seayoo-web/utils").ObjectValidator<TeamEngagementData, false, false>, import("@seayoo-web/utils").ObjectValidator<QuestEngagementData, false, false>, import("@seayoo-web/utils").ObjectValidator<{
+    tickets: ({
+        ticket: /*elided*/ any;
+        status: /*elided*/ any;
+    } | {
+        ticket: /*elided*/ any;
+        status: /*elided*/ any;
+        reward: /*elided*/ any;
+    })[];
+}, false, false>, import("@seayoo-web/utils").ObjectValidator<ClaimActivationKeyEngagementData, false, false>, import("@seayoo-web/utils").CustomValidator<EmptyObject, false, false>], false, false> & {
+    optional: never;
+    maybeNull: never;
+    key: never;
+    satisfies: never;
+    lock: never;
+};

package/types/src/event.engage/engage.giftcode.d.ts

@@ -0,0 +1,5 @@
+export interface GiftCodeEngagementData {
+    /** 礼包码 */
+    gift_code: string;
+}
+export declare const GiftCodeEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<GiftCodeEngagementData, false, false>;

package/types/src/event.engage/engage.invite.d.ts

@@ -0,0 +1,9 @@
+export interface InviteEngagementData {
+    /** 被邀请人的世游通行证 ID */
+    user_id: string;
+    /** 被邀请人昵称 */
+    name?: string;
+    /** 被邀请人头像地址 */
+    avatar_url?: string;
+}
+export declare const InviteEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<InviteEngagementData, false, false>;

package/types/src/event.engage/engage.lottery.d.ts

@@ -0,0 +1,9 @@
+export interface LotteryEngagementData {
+    /** 用户抽奖次数 */
+    lottery_count: number;
+}
+export declare const LotteryEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<LotteryEngagementData, false, false>;
+export interface LotteryEngagementParam {
+    /** 用户抽奖次数 */
+    lottery_count: number;
+}

package/types/src/event.engage/engage.lotteryDraw.d.ts

@@ -0,0 +1,40 @@
+import { type InferType } from "@seayoo-web/utils";
+import { LotteryTicketStatus, type LotteryDrawAction } from "../event.enums";
+import { type UserReward } from "./engage.lotteryDraw.reward";
+export * from "./engage.lotteryDraw.reward";
+declare const noRewardStatus: import("@seayoo-web/utils").StringValidator<"unknown" | "pending", false, false>;
+export type LotteryDrawTicket = {
+    /** 抽奖券 */
+    ticket: string;
+    /** 抽奖券状态 */
+    status: InferType<typeof noRewardStatus>;
+} | {
+    /** 抽奖券 */
+    ticket: string;
+    /** 抽奖券状态 */
+    status: Exclude<LotteryTicketStatus, InferType<typeof noRewardStatus>>;
+    /** 抽奖券奖励物品，status = drawn 时 reward_id = 0 */
+    reward: UserReward;
+};
+export interface LotteryDrawEngagementData {
+    tickets: LotteryDrawTicket[];
+}
+export declare const LotteryDrawEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<{
+    tickets: ({
+        ticket: /*elided*/ any;
+        status: /*elided*/ any;
+    } | {
+        ticket: /*elided*/ any;
+        status: /*elided*/ any;
+        reward: /*elided*/ any;
+    })[];
+}, false, false>;
+export type LotteryDrawEngagementParam = {
+    /** 参与抽奖券的动作类型 */
+    action: Exclude<LotteryDrawAction, typeof LotteryDrawAction.Claim>;
+} | {
+    /** 参与抽奖券的动作类型 */
+    action: typeof LotteryDrawAction.Claim;
+    /** 抽奖券 */
+    ticket: string;
+};

package/types/src/event.engage/engage.lotteryDraw.reward.d.ts

@@ -0,0 +1,38 @@
+import { type ClaimRewardStatus, type FeatureType, type GamerItemType, type RewardSource } from "../event.enums";
+export interface UserReward {
+    /** 用户奖励记录 id */
+    reward_id: number;
+    /** 奖励道具 id */
+    reward_item_id: number;
+    /** 产生奖励的来源 */
+    reward_source: RewardSource;
+    /** 奖励道具名称 */
+    reward_item_name: string;
+    /** 奖励道具类型  */
+    reward_item_type: GamerItemType;
+    /** 奖励道具图片地址 */
+    reward_item_icon_url: string;
+    /** 奖励道具描述 */
+    reward_item_desc?: string;
+    /** 奖励道具评级，用于前端展示 */
+    reward_item_rating: number;
+    /** 奖励道具数量 */
+    reward_amount: number;
+    /** 奖励状态 */
+    reward_status: ClaimRewardStatus;
+    /** 活动 ID */
+    event_id: number;
+    /** 活动名称 */
+    event_name: string;
+    /** 活动玩法 ID */
+    feature_id: number;
+    /** 参与记录 ID */
+    engagement_id: number;
+    /** 玩法类型 */
+    feature_type: FeatureType;
+    /** 领奖时间 */
+    receive_time: number;
+    /** 提供额外扩展信息，比如收获地址等 */
+    extra_data?: Record<string, unknown>;
+}
+export declare const UserRewardValidator: import("@seayoo-web/utils").ObjectValidator<UserReward, false, false>;

package/types/src/event.engage/engage.preregister.d.ts

@@ -0,0 +1,11 @@
+export interface PreregisterEngagementData {
+    /** 用户预约平台 */
+    platforms: string[];
+}
+export declare const PreregisterEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<{
+    platforms: string[];
+}, false, false>;
+export interface PreregisterEngagementParam {
+    /** 用户预约平台 */
+    platforms: string[];
+}

package/types/src/event.engage/engage.quest.d.ts

@@ -0,0 +1,28 @@
+import { type QuestObjective } from "../event.enums";
+export interface QuestEngagementData {
+    /** 任务目标 */
+    objective: QuestObjective;
+    /** 个人任务进度值 */
+    progress: number;
+    /** 个人任务目标值 */
+    completion_value?: number;
+    /** 组队任务进度信息 */
+    team?: {
+        /** 进度值 */
+        progress: number;
+        /** 目标值 */
+        completion_value?: number;
+        /** 队伍信息 */
+        players: {
+            /** 用户 id，含当前用户 */
+            user_id: number;
+            /** 角色名 */
+            role_name: string;
+            /** 是否为队长 */
+            is_leader: boolean;
+            /** 进度值 */
+            progress?: number;
+        }[];
+    };
+}
+export declare const QuestEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<QuestEngagementData, false, false>;

package/types/src/event.engage/engage.share.d.ts

@@ -0,0 +1,9 @@
+export interface ShareEngagementData {
+    /** 用户分享到对应的平台 */
+    platform: string;
+}
+export declare const ShareEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<ShareEngagementData, false, false>;
+export interface ShareEngagementParam {
+    /** 用户分享到对应的平台 */
+    platform: string;
+}

package/types/src/event.engage/engage.subscribe.d.ts

@@ -0,0 +1,14 @@
+export interface WeixinSubscribeEngagementData {
+    weixin_openid: string;
+}
+export declare const WeixinSubscribeEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<WeixinSubscribeEngagementData, false, false>;
+export interface SubscribeEngagementParam {
+    /**
+     * 小程序调用 wx.requestSubscribeMessage 并收到 success 回调后，得到的订阅结果。
+     *
+     * - key 为模版 ID
+     *
+     * - value 为订阅结果。示例 `accept` `reject` `ban` `filter`
+     */
+    subscribe_results: Record<string, string>;
+}

package/types/src/event.engage/engage.survey.d.ts

@@ -0,0 +1,7 @@
+export interface SurveyEngagementData {
+    /** 用户填写问卷流水号 */
+    serial_number: number;
+}
+export declare const SurveyEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<{
+    serial_number: number;
+}, false, false>;

package/types/src/event.engage/engage.team.d.ts

@@ -0,0 +1,53 @@
+import { type TeamAction, type TeamVisibility } from "../event.enums";
+/** 组队玩法的参与记录 */
+export interface TeamEngagement {
+    /** 组队码 */
+    team_code: string;
+    /** 队长角色名称 */
+    leader_name: string;
+    /** 队员数量 */
+    total_members: number;
+}
+export declare const TeamEngagementValidator: import("@seayoo-web/utils").ObjectValidator<TeamEngagement, false, false>;
+export interface TeamMember {
+    /** 是否为队长 */
+    is_leader: boolean;
+    /** 是否为当前登录用户 */
+    is_myself?: boolean;
+    /** 角色名 */
+    role_name: string;
+    /** 服务器名 */
+    server_name: string;
+}
+export declare const TeamMemberValidator: import("@seayoo-web/utils").ObjectValidator<TeamMember, false, false>;
+export interface TeamEngagementData {
+    /** 组队码 */
+    team_code: string;
+    /** 队伍可见性 */
+    visibility: TeamVisibility;
+    /** 队员信息 */
+    members: TeamMember[];
+}
+export declare const TeamEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<TeamEngagementData, false, false>;
+export type TeamEngagementParam = {
+    /** 操作类型 */
+    action: typeof TeamAction.ChangeVisibility;
+    /** 组队码 */
+    team_code: string;
+    /** 设置队伍的可见性 */
+    visibility: TeamVisibility;
+} | {
+    /** 操作类型 */
+    action: typeof TeamAction.Assemble;
+    /** 设置队伍的可见性 */
+    visibility?: TeamVisibility;
+} | {
+    action: typeof TeamAction.Join | typeof TeamAction.Disband;
+    /** 组队码 */
+    team_code: string;
+} | {
+    /** 操作类型 */
+    action: typeof TeamAction.Query;
+    /** 组队码 */
+    team_code?: string;
+};

package/types/src/event.engage/engage.vote.d.ts

@@ -0,0 +1,9 @@
+export interface VoteEngagementData {
+    /** 用户投票选项 */
+    option_sn: string;
+}
+export declare const VoteEngagementDataValidator: import("@seayoo-web/utils").ObjectValidator<VoteEngagementData, false, false>;
+export interface VoteEngagementParam {
+    /** 选项的 sn */
+    option_sn: string;
+}

package/types/src/event.engage/reward.d.ts

@@ -0,0 +1,52 @@
+import { RewardItemType, type RewardSource, type RewardStatusSuffix } from "../event.enums";
+import { type UserEngagementData } from "./engage";
+export interface Reward {
+    /** 用户奖励记录 id */
+    reward_id: number;
+    /** 奖励道具 id */
+    reward_item_id: number;
+    /** 奖励道具类型  */
+    reward_item_type: RewardItemType;
+    /** 奖励道具数量 */
+    reward_count: number;
+    /** 奖励状态 */
+    reward_status: RewardStatusSuffix;
+    /** 奖励来源 */
+    reward_source: RewardSource;
+    /** 奖励道具名称 */
+    reward_item_name: string;
+    /** 奖励道具图片地址 */
+    reward_item_icon_url: string;
+    /** 奖励道具描述 */
+    reward_item_desc?: string;
+    /** 奖励道具评级，用于前端展示 */
+    reward_item_rating: number;
+    /** 领奖时间 */
+    receive_time: number;
+    /** 提供额外扩展信息 */
+    extra_data?: UserEngagementData | Record<string, unknown>;
+}
+export declare const RewardValidator: import("@seayoo-web/utils").ObjectValidator<Reward, false, false>;
+export interface EngageReward {
+    /** 用户奖励记录 id（微信红包类型奖励需要前端请求一次领奖 api） */
+    reward_id: number;
+    /** 奖励道具 id */
+    reward_item_id: number;
+    /** 奖励道具名称 */
+    reward_item_name: string;
+    /** 奖励道具类型 */
+    reward_item_type: RewardItemType;
+    /** 奖励道具图片地址 */
+    reward_item_icon_url: string;
+    /** 奖励道具描述 */
+    reward_item_desc?: string;
+    /** 奖励道具数量 */
+    reward_amount: number;
+    /** 奖励状态 */
+    reward_status: RewardStatusSuffix;
+    /** 产生奖励的来源 */
+    reward_source: RewardSource;
+    /** 提供额外扩展信息，例如：礼包码的值等 */
+    extra_data?: Record<string, unknown>;
+}
+export declare const EngageRewardValidator: import("@seayoo-web/utils").ObjectValidator<EngageReward, false, false>;