@be-link/ecommerce-client-backend-service-node-sdk 0.1.73 → 0.1.74

package/modules/userData/service.d.ts

@@ -6,6 +6,8 @@ declare class UserDataServiceClass extends BaseService implements UserDataServic
     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>;
+    getUserLiveWatchSummary(request: UserDataService.Request.GetUserLiveWatchSummary): Promise<UserDataService.Response.GetUserLiveWatchSummary>;
+    getUserLiveWatchCalendar(request: UserDataService.Request.GetUserLiveWatchCalendar): Promise<UserDataService.Response.GetUserLiveWatchCalendar>;
 }
 export declare const userDataService: UserDataServiceClass;
 export default userDataService;

package/modules/userData/service.js

@@ -33,6 +33,12 @@ let UserDataServiceClass = class UserDataServiceClass extends BaseService_1.defa
     exportLiveRoomUserList(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.exportLiveRoomUserList), request);
     }
+    getUserLiveWatchSummary(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getUserLiveWatchSummary), request);
+    }
+    getUserLiveWatchCalendar(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getUserLiveWatchCalendar), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('获取用户列表'),
@@ -54,6 +60,16 @@ __decorate([
     (0, tsoa_1.Post)('export-live-room-user-list'),
     __param(0, (0, tsoa_1.Body)())
 ], UserDataServiceClass.prototype, "exportLiveRoomUserList", null);
+__decorate([
+    (0, tsoa_1.OperationId)('获取用户看播汇总数据'),
+    (0, tsoa_1.Post)('get-user-live-watch-summary'),
+    __param(0, (0, tsoa_1.Body)())
+], UserDataServiceClass.prototype, "getUserLiveWatchSummary", null);
+__decorate([
+    (0, tsoa_1.OperationId)('获取用户看播日历数据'),
+    (0, tsoa_1.Post)('get-user-live-watch-calendar'),
+    __param(0, (0, tsoa_1.Body)())
+], UserDataServiceClass.prototype, "getUserLiveWatchCalendar", null);
 UserDataServiceClass = __decorate([
     (0, tsoa_1.Route)('userData'),
     (0, tsoa_1.Tags)('UserData')

package/modules/userData/types.d.ts

@@ -93,6 +93,20 @@ export declare namespace UserDataService {
             /** 每页数量，默认20，最大1000 */
             pageSize?: number;
         }
+        /**
+         * 获取用户看播汇总数据
+         */
+        interface GetUserLiveWatchSummary {
+            /** 用户ID */
+            userId: string;
+        }
+        /**
+         * 获取用户看播日历数据
+         */
+        interface GetUserLiveWatchCalendar {
+            /** 用户ID */
+            userId: string;
+        }
     }
     namespace Response {
         /**
@@ -136,12 +150,77 @@ export declare namespace UserDataService {
          */
         interface ExportLiveRoomUserList extends IBatchExport {
         }
+        /**
+         * 获取用户看播汇总数据响应
+         */
+        interface GetUserLiveWatchSummary {
+            /** 已观看场次（进入过直播间的场次数） */
+            watchedCount: number;
+            /** 已完播场次（观看时长达到完播阈值的场次数） */
+            completedCount: number;
+            /** 总观看时长（分钟），前端展示如 "127.5h" 时可自行换算为小时 */
+            totalWatchDurationMinutes: number;
+        }
+        /**
+         * 获取用户看播日历数据响应
+         */
+        interface GetUserLiveWatchCalendar {
+            /**
+             * 按天的看播记录（长度固定 14）
+             * 排序：可以从近到远或从远到近，自行约定
+             */
+            days: UserLiveWatchDayItem[];
+        }
+    }
+    /**
+     * 用户看播日历 - 单日数据
+     */
+    interface UserLiveWatchDayItem {
+        /** 日期字符串，例如 "2026-01-15" */
+        date: string;
+        /** 周几，前端用来展示，例如 "周一"（可选） */
+        weekDay: string;
+        /** 早场记录（实际 9:00~10:15，统计窗口 8:45~11:00） */
+        morningSession: UserLiveWatchSessionItem;
+        /** 午场记录（实际 14:00~15:15，统计窗口 13:45~16:00） */
+        noonSession: UserLiveWatchSessionItem;
+        /** 晚场记录（实际 20:00~21:15，统计窗口 19:45~22:00） */
+        eveningSession: UserLiveWatchSessionItem;
+    }
+    /**
+     * 用户看播日历 - 单场次数据
+     */
+    interface UserLiveWatchSessionItem {
+        /**
+         * 该时间段内选中的直播间ID：
+         * - 有直播且被选中那场 ⇒ 对应 liveStreamRoomId
+         * - NO_LIVE（无直播）时可以不返回或返回空字符串
+         */
+        liveStreamRoomId?: string;
+        /**
+         * 选中直播间名称：
+         * - 有直播且被选中那场 ⇒ 对应名称
+         * - NO_LIVE 时可以不返回或返回空字符串
+         */
+        liveStreamRoomName?: string;
+        /** 用户在该时间段选中直播的观看总时长（分钟，向下取整的整数） */
+        watchMinutes: number;
+        /**
+         * 看播状态（英文枚举，前端根据状态展示对应颜色）：
+         * - COMPLETED   ⇒ 已完成
+         * - INCOMPLETE  ⇒ 未完成（包括 AudienceStatistics 有记录但分钟数为 0 的情况）
+         * - NOT_WATCHED ⇒ 未观看（有直播但用户完全没看，没有任何 AudienceStatistics 记录）
+         * - NO_LIVE     ⇒ 无直播（该时间段内没有任何直播）
+         */
+        status: 'COMPLETED' | 'INCOMPLETE' | 'NOT_WATCHED' | 'NO_LIVE';
     }
     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>;
+        getUserLiveWatchSummary(request: Request.GetUserLiveWatchSummary, req?: FastifyRequest): Promise<Response.GetUserLiveWatchSummary>;
+        getUserLiveWatchCalendar(request: Request.GetUserLiveWatchCalendar, req?: FastifyRequest): Promise<Response.GetUserLiveWatchCalendar>;
     }
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@be-link/ecommerce-client-backend-service-node-sdk",
-  "version": "0.1.73",
+  "version": "0.1.74",
   "description": "EcommerceClientBackendService Node.js SDK",
   "main": "index.js",
   "types": "index.d.ts",