@be-link/ecommerce-client-backend-service-node-sdk 0.1.70 → 0.1.72

package/modules/data/service.d.ts

@@ -34,6 +34,11 @@ declare class DataServiceClass extends BaseService implements DataService.BaseCo
     compensateUserLastWatchTime(request: DataService.Request.CompensateUserLastWatchTime): Promise<DataService.Response.CompensateUserLastWatchTime>;
     /** 同步观众统计数据 */
     syncAudienceStatistics(): Promise<void>;
+    /** 同步回放观众统计（每天0点：开播日期前天/昨天的直播间回放三字段） */
+    syncReplayAudienceStatistics(): Promise<void>;
+    /** 补偿指定直播间的回放观众统计（拉火山回放写回放三字段，用于手动补偿） */
+    compensateReplayAudienceStatistics(request: DataService.Request.CompensateReplayAudienceStatistics): Promise<void>;
+    batchCompensateReplayAudienceStatistics(request: DataService.Request.BatchCompensateReplayAudienceStatistics): Promise<void>;
     /** 每日更新用户首次看播时间 */
     dailyUpdateUserFirstWatchTime(): Promise<void>;
     /** 每小时更新用户首次消费时间 */

package/modules/data/service.js

@@ -89,6 +89,17 @@ let DataServiceClass = class DataServiceClass extends BaseService_1.default {
     syncAudienceStatistics() {
         return (0, http_1.callApi)(this.getApiUrl(this.syncAudienceStatistics), undefined);
     }
+    /** 同步回放观众统计（每天0点：开播日期前天/昨天的直播间回放三字段） */
+    syncReplayAudienceStatistics() {
+        return (0, http_1.callApi)(this.getApiUrl(this.syncReplayAudienceStatistics), undefined);
+    }
+    /** 补偿指定直播间的回放观众统计（拉火山回放写回放三字段，用于手动补偿） */
+    compensateReplayAudienceStatistics(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.compensateReplayAudienceStatistics), request);
+    }
+    batchCompensateReplayAudienceStatistics(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.batchCompensateReplayAudienceStatistics), request);
+    }
     /** 每日更新用户首次看播时间 */
     dailyUpdateUserFirstWatchTime() {
         return (0, http_1.callApi)(this.getApiUrl(this.dailyUpdateUserFirstWatchTime), undefined);
@@ -193,6 +204,20 @@ __decorate([
     (0, tsoa_1.OperationId)('同步观众统计数据'),
     (0, tsoa_1.Post)('sync-audience-statistics')
 ], DataServiceClass.prototype, "syncAudienceStatistics", null);
+__decorate([
+    (0, tsoa_1.OperationId)('同步回放观众统计'),
+    (0, tsoa_1.Post)('sync-replay-audience-statistics')
+], DataServiceClass.prototype, "syncReplayAudienceStatistics", null);
+__decorate([
+    (0, tsoa_1.OperationId)('补偿回放观众统计'),
+    (0, tsoa_1.Post)('compensate-replay-audience-statistics'),
+    __param(0, (0, tsoa_1.Body)())
+], DataServiceClass.prototype, "compensateReplayAudienceStatistics", null);
+__decorate([
+    (0, tsoa_1.OperationId)('批量补偿回放观众统计'),
+    (0, tsoa_1.Post)('batch-compensate-replay-audience-statistics'),
+    __param(0, (0, tsoa_1.Body)())
+], DataServiceClass.prototype, "batchCompensateReplayAudienceStatistics", null);
 __decorate([
     (0, tsoa_1.OperationId)('每日更新用户首次看播时间'),
     (0, tsoa_1.Post)('daily-update-user-first-watch-time')

package/modules/data/types.d.ts

@@ -186,6 +186,24 @@ export declare namespace DataService {
             /** 直播间id */
             liveStreamRoomId: string;
         }
+        /**
+         * 补偿指定直播间的回放观众统计（拉火山回放写回放三字段）
+         */
+        interface CompensateReplayAudienceStatistics {
+            /** 直播间id */
+            liveStreamRoomId: string;
+        }
+        /**
+         * 批量补偿回放观众统计（按时间范围查询直播间）
+         */
+        interface BatchCompensateReplayAudienceStatistics {
+            /** 开始时间（秒级时间戳） */
+            startTime: number;
+            /** 结束时间（秒级时间戳） */
+            endTime: number;
+            /** 批次大小（保留兼容性，实际串行执行） */
+            batchSize?: number;
+        }
         /**
          * 每日对账任务
          */
@@ -269,6 +287,15 @@ export declare namespace DataService {
             /** 执行结果消息 */
             message: string;
         }
+        /**
+         * 手动补偿更新用户最后看播时间响应
+         */
+        interface CompensateUserLastWatchTime {
+            /** 是否成功 */
+            success: boolean;
+            /** 执行结果消息 */
+            message: string;
+        }
     }
     interface BaseController {
         userLiveStreamRelation(request: Request.UserLiveStreamRelation, req?: FastifyRequest): Promise<void>;
@@ -289,6 +316,9 @@ export declare namespace DataService {
         initUserExtraInfoSevenDaysAmount(req?: FastifyRequest): Promise<void>;
         compensateUserLastWatchTime(request: Request.CompensateUserLastWatchTime, req?: FastifyRequest): Promise<Response.CompensateUserLastWatchTime>;
         syncAudienceStatistics(): Promise<void>;
+        syncReplayAudienceStatistics(): Promise<void>;
+        compensateReplayAudienceStatistics(request: Request.CompensateReplayAudienceStatistics, req?: FastifyRequest): Promise<void>;
+        batchCompensateReplayAudienceStatistics(request: Request.BatchCompensateReplayAudienceStatistics, req?: FastifyRequest): Promise<void>;
         dailyUpdateUserFirstWatchTime(req?: FastifyRequest): Promise<void>;
         hourlyUpdateUserFirstConsumptionTime(req?: FastifyRequest): Promise<void>;
         dailyReconciliation(request?: Request.DailyReconciliation, req?: FastifyRequest): Promise<void>;

package/modules/room/types.d.ts

@@ -279,6 +279,8 @@ export declare namespace RoomService {
             liveStartTime: string;
             /** 看播时长 (格式 "X小时X分" 或 "X分钟") */
             watchDuration: string;
+            /** 回放时长 (格式 "X小时X分" 或 "X分钟") */
+            replayWatchDuration: string;
             /** 首次进入时间 (格式 "YYYY-MM-DD HH:mm:ss") */
             firstEntryTime: string;
             /** 最后进入时间 (格式 "YYYY-MM-DD HH:mm:ss") */

package/modules/userData/service.d.ts

@@ -4,6 +4,8 @@ declare class UserDataServiceClass extends BaseService implements UserDataServic
     protected prefixUrl: string;
     getUserList(request: UserDataService.Request.GetUserList): Promise<UserDataService.Response.GetUserList>;
     exportUserList(request: UserDataService.Request.ExportUserList): Promise<UserDataService.Response.ExportUserList>;
+    getLiveRoomUserList(request: UserDataService.Request.GetLiveRoomUserList): Promise<UserDataService.Response.GetLiveRoomUserList>;
+    exportLiveRoomUserList(request: UserDataService.Request.ExportLiveRoomUserList): Promise<UserDataService.Response.ExportLiveRoomUserList>;
 }
 export declare const userDataService: UserDataServiceClass;
 export default userDataService;

package/modules/userData/service.js

@@ -27,6 +27,12 @@ let UserDataServiceClass = class UserDataServiceClass extends BaseService_1.defa
     exportUserList(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.exportUserList), request);
     }
+    getLiveRoomUserList(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getLiveRoomUserList), request);
+    }
+    exportLiveRoomUserList(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.exportLiveRoomUserList), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('获取用户列表'),
@@ -38,6 +44,16 @@ __decorate([
     (0, tsoa_1.Post)('export-user-list'),
     __param(0, (0, tsoa_1.Body)())
 ], UserDataServiceClass.prototype, "exportUserList", null);
+__decorate([
+    (0, tsoa_1.OperationId)('获取直播间用户列表'),
+    (0, tsoa_1.Post)('get-live-room-user-list'),
+    __param(0, (0, tsoa_1.Body)())
+], UserDataServiceClass.prototype, "getLiveRoomUserList", null);
+__decorate([
+    (0, tsoa_1.OperationId)('导出直播间用户列表'),
+    (0, tsoa_1.Post)('export-live-room-user-list'),
+    __param(0, (0, tsoa_1.Body)())
+], UserDataServiceClass.prototype, "exportLiveRoomUserList", null);
 UserDataServiceClass = __decorate([
     (0, tsoa_1.Route)('userData'),
     (0, tsoa_1.Tags)('UserData')

package/modules/userData/types.d.ts

@@ -51,6 +51,48 @@ export declare namespace UserDataService {
          */
         interface ExportUserList extends GetUserList {
         }
+        /**
+         * 获取直播间用户列表
+         */
+        interface GetLiveRoomUserList {
+            /** 直播间ID */
+            liveStreamRoomId: string;
+            /** 门店ID列表（支持多选） */
+            storeIds?: string[];
+            /** 用户ID */
+            userId?: string;
+            /** 用户ID列表 */
+            userIds?: string[];
+            /** 用户昵称（支持模糊匹配） */
+            nickname?: string;
+            /** 会员等级 */
+            memberLevel?: string;
+            /** 页码，从0开始 */
+            pageIndex: number;
+            /** 每页数量，默认20，最大1000 */
+            pageSize?: number;
+        }
+        /**
+         * 导出直播间用户列表
+         */
+        interface ExportLiveRoomUserList {
+            /** 直播间ID */
+            liveStreamRoomId: string;
+            /** 门店ID列表（支持多选） */
+            storeIds?: string[];
+            /** 用户ID */
+            userId?: string;
+            /** 用户ID列表 */
+            userIds?: string[];
+            /** 用户昵称（支持模糊匹配） */
+            nickname?: string;
+            /** 会员等级 */
+            memberLevel?: string;
+            /** 页码，从0开始 */
+            pageIndex: number;
+            /** 每页数量，默认20，最大1000 */
+            pageSize?: number;
+        }
     }
     namespace Response {
         /**
@@ -76,10 +118,30 @@ export declare namespace UserDataService {
          */
         interface ExportUserList extends IBatchExport {
         }
+        /**
+         * 获取直播间用户列表响应
+         */
+        interface GetLiveRoomUserList {
+            /** 总条数 */
+            total: number;
+            /** 当前页 */
+            pageIndex: number;
+            /** 每页数量 */
+            pageSize: number;
+            /** 用户列表 */
+            list: LiveRoomUserItem[];
+        }
+        /**
+         * 导出直播间用户列表响应
+         */
+        interface ExportLiveRoomUserList extends IBatchExport {
+        }
     }
     interface BaseController {
         getUserList(request: Request.GetUserList, req?: FastifyRequest): Promise<Response.GetUserList>;
         exportUserList(request: Request.ExportUserList, req?: FastifyRequest): Promise<Response.ExportUserList>;
+        getLiveRoomUserList(request: Request.GetLiveRoomUserList, req?: FastifyRequest): Promise<Response.GetLiveRoomUserList>;
+        exportLiveRoomUserList(request: Request.ExportLiveRoomUserList, req?: FastifyRequest): Promise<Response.ExportLiveRoomUserList>;
     }
 }
 /**
@@ -163,3 +225,52 @@ export interface UserInfo {
     /** 更新时间（时间戳） */
     updatedAt: number;
 }
+/**
+ * 直播间用户列表项
+ */
+export interface LiveRoomUserItem {
+    /** 用户ID */
+    userId: string;
+    /** 用户头像 */
+    avatar: string;
+    /** 昵称 */
+    nickname: string;
+    /** 用户状态（正常 / 禁用 / 拉黑等） */
+    status: string;
+    /** 会员等级 */
+    memberLevel: string;
+    /** 所属门店ID */
+    storeId: string;
+    /** 所属门店名称 */
+    storeName: string;
+    /** 是否完播（观看时长 >= 60分钟，不含回放） */
+    isCompleted: boolean;
+    /** 本场直播观看时长（分钟） */
+    liveWatchDuration: string;
+    /** 直播中消费金额（元） */
+    liveConsumeAmount: number;
+    /** 本场回放观看时长（分钟） */
+    replayWatchDuration: string;
+    /** 回放消费金额（元） */
+    replayConsumeAmount: number;
+    /** 累计消费金额（支付总额 - 退款总额，元） */
+    totalConsumeAmount: number;
+    /** 首次进入直播间时间（毫秒时间戳） */
+    firstEnterTime: number;
+    /** 最后进入直播间时间（毫秒时间戳） */
+    lastEnterTime: number;
+    /** 授权手机号（用户详情授权） */
+    bindPhone: string;
+    /** 提货手机号（用户详情手机号） */
+    phone: string;
+    /** 最近一笔未退款订单支付时间（毫秒时间戳） */
+    latestValidPayTime: number;
+    /** 市场经理 */
+    marketManager: string;
+    /** 市场经理ID */
+    marketManagerId: string;
+    /** 直播间名称 */
+    liveStreamRoomName: string;
+    /** 直播间ID */
+    liveStreamRoomId: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@be-link/ecommerce-client-backend-service-node-sdk",
-  "version": "0.1.70",
+  "version": "0.1.72",
   "description": "EcommerceClientBackendService Node.js SDK",
   "main": "index.js",
   "types": "index.d.ts",
@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@be-link/ecommerce-volcengine-open-api-sdk": "1.0.11",
-    "@be-link/ecommerce-user-service-node-sdk": "0.1.80",
+    "@be-link/ecommerce-user-service-node-sdk": "0.1.81",
     "@fastify/request-context": "6.2.1",
     "axios": "1.13.2",
     "axios-retry": "4.0.0",