@be-link/ecommerce-client-backend-service-node-sdk 0.1.77 → 0.1.79

package/modules/BaseService.d.ts

@@ -7,8 +7,8 @@ export default abstract class BaseService {
     /** URL一级路径 */
     protected abstract prefixUrl: string;
     /** 子网域名 */
-    protected readonly natDevHost = "https://ecommerce-dev.wejourney.top/client-backend";
-    protected readonly natProdHost = "http://10.1.32.74:8090/client-backend";
+    protected readonly natDevHost = "http://192.168.92.0:8090/client-backend";
+    protected readonly natProdHost = "http://192.168.41.121:8090/client-backend";
     /** 公网域名 */
     protected readonly publicDevHost = "https://ecommerce-dev.wejourney.top/client-backend";
     protected readonly publicProdHost = "";

package/modules/BaseService.js

@@ -12,8 +12,8 @@ const string_1 = require("../utils/string");
 class BaseService {
     constructor() {
         /** 子网域名 */
-        this.natDevHost = 'https://ecommerce-dev.wejourney.top/client-backend';
-        this.natProdHost = 'http://10.1.32.74:8090/client-backend';
+        this.natDevHost = 'http://192.168.92.0:8090/client-backend';
+        this.natProdHost = 'http://192.168.41.121:8090/client-backend';
         /** 公网域名 */
         this.publicDevHost = 'https://ecommerce-dev.wejourney.top/client-backend';
         this.publicProdHost = '';

package/modules/rule/types.d.ts

@@ -3,7 +3,7 @@ export declare namespace RuleService {
     interface Info {
         /** 直播间id */
         liveStreamRoomId: string;
-        /** 规则分类：city-城市、delivery-配送、tag-标签 */
+        /** 规则分类：city-城市、delivery-配送、tag-标签、businessScope-主营业务 */
         cate: string;
         /** 规则值 */
         ruleValue: string;

package/modules/userData/service.d.ts

@@ -6,6 +6,9 @@ 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>;
+    replaceThirdPartyUserIdToUserId(request: UserDataService.Request.ReplaceThirdPartyUserIdToUserId): Promise<UserDataService.Response.ReplaceThirdPartyUserIdToUserId>;
 }
 export declare const userDataService: UserDataServiceClass;
 export default userDataService;

package/modules/userData/service.js

@@ -33,6 +33,15 @@ 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);
+    }
+    replaceThirdPartyUserIdToUserId(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.replaceThirdPartyUserIdToUserId), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('获取用户列表'),
@@ -54,6 +63,21 @@ __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);
+__decorate([
+    (0, tsoa_1.OperationId)('thirdPartyUserId置换userId'),
+    (0, tsoa_1.Post)('replace-third-party-user-id-to-user-id'),
+    __param(0, (0, tsoa_1.Body)())
+], UserDataServiceClass.prototype, "replaceThirdPartyUserIdToUserId", null);
 UserDataServiceClass = __decorate([
     (0, tsoa_1.Route)('userData'),
     (0, tsoa_1.Tags)('UserData')

package/modules/userData/types.d.ts

@@ -93,6 +93,27 @@ export declare namespace UserDataService {
             /** 每页数量，默认20，最大1000 */
             pageSize?: number;
         }
+        /**
+         * 获取用户看播汇总数据
+         */
+        interface GetUserLiveWatchSummary {
+            /** 用户ID */
+            userId: string;
+        }
+        /**
+         * 获取用户看播日历数据
+         */
+        interface GetUserLiveWatchCalendar {
+            /** 用户ID */
+            userId: string;
+        }
+        /**
+         * thirdPartyUserId 置换 userId
+         */
+        interface ReplaceThirdPartyUserIdToUserId {
+            /** 第三方用户ID列表，最大1000个 */
+            thirdPartyUserIds: number[];
+        }
     }
     namespace Response {
         /**
@@ -136,12 +157,87 @@ export declare namespace UserDataService {
          */
         interface ExportLiveRoomUserList extends IBatchExport {
         }
+        /**
+         * 获取用户看播汇总数据响应
+         */
+        interface GetUserLiveWatchSummary {
+            /** 已观看场次（进入过直播间的场次数） */
+            watchedCount: number;
+            /** 已完播场次（观看时长达到完播阈值的场次数） */
+            completedCount: number;
+            /** 总观看时长（分钟），前端展示如 "127.5h" 时可自行换算为小时 */
+            totalWatchDurationMinutes: number;
+        }
+        /**
+         * 获取用户看播日历数据响应
+         */
+        interface GetUserLiveWatchCalendar {
+            /**
+             * 按天的看播记录（长度固定 14）
+             * 排序：可以从近到远或从远到近，自行约定
+             */
+            days: UserLiveWatchDayItem[];
+        }
+        /**
+         * thirdPartyUserId 置换 userId 响应
+         */
+        interface ReplaceThirdPartyUserIdToUserId {
+            [thirdPartyUserId: string]: {
+                userId: string;
+                storeId: string;
+            };
+        }
+    }
+    /**
+     * 用户看播日历 - 单日数据
+     */
+    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>;
+        replaceThirdPartyUserIdToUserId(request: Request.ReplaceThirdPartyUserIdToUserId, req?: FastifyRequest): Promise<Response.ReplaceThirdPartyUserIdToUserId>;
     }
 }
 /**

package/package.json

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

package/types.d.ts

@@ -158,6 +158,8 @@ export interface ViewRecord {
     coverImage: string;
     /** 竖屏直播的封面图 URL。若未设置该参数值，则默认读取 CoverImage 的值。若通过控制台配置竖屏直播封面图且配置成功，则封面图的 URL 无协议头。若通过调用 API 接口配置竖屏直播封面图，则封面图的 URL 有协议头。 */
     verticalCoverImage: string;
+    /** 分享封面，用于门店分享 */
+    shareCover: string;
     /** 观看 URL。 */
     viewUrl: string;
 }