@be-link/ecommerce-client-backend-service-node-sdk 0.1.58 → 0.1.60

package/modules/data/types.d.ts

@@ -142,8 +142,10 @@ export declare namespace DataService {
             userId?: string;
             /** 页码，从0开始 */
             pageIndex: number;
-            /** 每页数量，默认20，最大100 */
+            /** 每页数量，默认20，最大1000 */
             pageSize?: number;
+            /** 累计观看时长最小值（毫秒），筛选观看时长大于等于该值的观众 */
+            minCumulativeViewDuration?: number;
         }
         /**
          * 直播间统计查询

package/modules/room/service.d.ts

@@ -21,6 +21,7 @@ declare class RoomServiceClass extends BaseService implements RoomService.BaseCo
     storeLiveStreamRule(request: RoomService.Request.StoreLiveStreamRule): Promise<RoomService.Response.StoreLiveStreamRule>;
     searchByName(request: RoomService.Request.SearchByName): Promise<RoomService.Response.SearchByName>;
     getBasicInfo(request: RoomService.Request.GetBasicInfo): Promise<RoomService.Response.GetBasicInfo>;
+    userViewDetail(request: RoomService.Request.UserViewDetail): Promise<RoomService.Response.UserViewDetail>;
 }
 export declare const roomService: RoomServiceClass;
 export default roomService;

package/modules/room/service.js

@@ -69,6 +69,9 @@ let RoomServiceClass = class RoomServiceClass extends BaseService_1.default {
     getBasicInfo(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.getBasicInfo), request);
     }
+    userViewDetail(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.userViewDetail), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('同步活动'),
@@ -145,6 +148,11 @@ __decorate([
     (0, tsoa_1.Post)('get-basic-info'),
     __param(0, (0, tsoa_1.Body)())
 ], RoomServiceClass.prototype, "getBasicInfo", null);
+__decorate([
+    (0, tsoa_1.OperationId)('用户直播间观看详情查询'),
+    (0, tsoa_1.Post)('user-view-detail'),
+    __param(0, (0, tsoa_1.Body)())
+], RoomServiceClass.prototype, "userViewDetail", null);
 RoomServiceClass = __decorate([
     (0, tsoa_1.Route)('room'),
     (0, tsoa_1.Tags)('Room')

package/modules/room/types.d.ts

@@ -120,6 +120,25 @@ export declare namespace RoomService {
             /** 直播间ID列表 */
             ids: string[];
         }
+        /**
+         * 用户直播间观看详情查询
+         */
+        interface UserViewDetail {
+            /** 用户ID，必填 */
+            userId: string;
+            /** 直播开始时间-起（毫秒时间戳），选填 */
+            startTime?: number;
+            /** 直播开始时间-止（毫秒时间戳），选填 */
+            endTime?: number;
+            /** 直播间标题（模糊搜索），选填 */
+            liveTitle?: string;
+            /** 直播间ID（精准匹配），选填 */
+            liveStreamRoomId?: string;
+            /** 页码，从 0 开始，默认 0 */
+            pageIndex: number;
+            /** 每页数量 */
+            pageSize: number;
+        }
     }
     namespace Response {
         /**
@@ -229,6 +248,46 @@ export declare namespace RoomService {
         interface GetBasicInfo {
             list: RoomBasicInfo[];
         }
+        /**
+         * 用户直播间观看详情项
+         */
+        interface UserViewDetailItem {
+            /** 直播间 ID */
+            liveStreamRoomId: string;
+            /** 直播间标题 */
+            liveTitle: string;
+            /** 直播开始时间 (格式 "YYYY-MM-DD HH:mm:ss") */
+            liveStartTime: string;
+            /** 看播时长 (格式 "X小时X分" 或 "X分钟") */
+            watchDuration: string;
+            /** 首次进入时间 (格式 "YYYY-MM-DD HH:mm:ss") */
+            firstEntryTime: string;
+            /** 最后进入时间 (格式 "YYYY-MM-DD HH:mm:ss") */
+            lastEntryTime: string;
+            /** 是否完播 (枚举值："是" / "否") */
+            isCompleted: string;
+            /** 获得积分 (仅限直播营销活动积分) */
+            earnedPoints: number;
+            /** 获得券 (张数) */
+            earnedCoupons: number;
+            /** 下单笔数 */
+            orderCount: number;
+            /** 直播间下单金额 (元) */
+            orderAmount: number;
+            /** 7天累计下单金额 (元) */
+            totalSevenOrderAmount: number;
+            /** 最近下单时间 (格式 "YYYY-MM-DD HH:mm:ss") */
+            lastOrderTime: string;
+            /** 评论数 */
+            commentCount: number;
+        }
+        /**
+         * 用户直播间观看详情响应
+         */
+        interface UserViewDetail {
+            list: UserViewDetailItem[];
+            total: number;
+        }
     }
     interface BaseController {
         sync(request: ListActivityAPIRequest): Promise<ListActivityAPIResponse>;
@@ -255,5 +314,9 @@ export declare namespace RoomService {
          * 根据房间ID批量获取简要信息
          */
         getBasicInfo(request: Request.GetBasicInfo, req?: FastifyRequest): Promise<Response.GetBasicInfo>;
+        /**
+         * 用户直播间观看详情查询
+         */
+        userViewDetail(request: Request.UserViewDetail, req?: FastifyRequest): Promise<Response.UserViewDetail>;
     }
 }

package/package.json

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