@be-link/ecommerce-client-backend-service-node-sdk 0.1.90 → 0.1.92

package/consts.d.ts

@@ -0,0 +1,30 @@
+export declare namespace HOTEL_TRAVEL_MQ {
+    /** 酒旅 MQ vhost */
+    const VHOST = "trade";
+    /** 正向订单 MQ */
+    namespace POS {
+        /** 正向订单主题 */
+        const TOPIC = "positive-topic";
+        /** 正向订单路由键 */
+        const ROUTING_KEY: {
+            /** 创建 */
+            readonly CREATE: "order.positive.create";
+            /** 支付成功 */
+            readonly PAY_SUCCESS: "order.positive.pay_success";
+            /** 关闭 */
+            readonly CLOSED: "order.positive.close";
+            /** 定金补全 */
+            readonly DEPOSIT_RESERVE_COMPLETED: "order.positive.deposit_reserve_completed";
+        };
+    }
+    /** 逆向订单 MQ */
+    namespace ROS {
+        /** 逆向订单主题 */
+        const TOPIC = "reverse-topic";
+        /** 逆向订单路由键 */
+        const ROUTING_KEY: {
+            /** 退款成功 */
+            readonly SUCCESS: "order.reverse.success";
+        };
+    }
+}

package/consts.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HOTEL_TRAVEL_MQ = void 0;
+var HOTEL_TRAVEL_MQ;
+(function (HOTEL_TRAVEL_MQ) {
+    /** 酒旅 MQ vhost */
+    HOTEL_TRAVEL_MQ.VHOST = 'trade';
+    /** 正向订单 MQ */
+    let POS;
+    (function (POS) {
+        /** 正向订单主题 */
+        POS.TOPIC = 'positive-topic';
+        /** 正向订单路由键 */
+        POS.ROUTING_KEY = {
+            /** 创建 */
+            CREATE: 'order.positive.create',
+            /** 支付成功 */
+            PAY_SUCCESS: 'order.positive.pay_success',
+            /** 关闭 */
+            CLOSED: 'order.positive.close',
+            /** 定金补全 */
+            DEPOSIT_RESERVE_COMPLETED: 'order.positive.deposit_reserve_completed',
+        };
+    })(POS = HOTEL_TRAVEL_MQ.POS || (HOTEL_TRAVEL_MQ.POS = {}));
+    /** 逆向订单 MQ */
+    let ROS;
+    (function (ROS) {
+        /** 逆向订单主题 */
+        ROS.TOPIC = 'reverse-topic';
+        /** 逆向订单路由键 */
+        ROS.ROUTING_KEY = {
+            /** 退款成功 */
+            SUCCESS: 'order.reverse.success',
+        };
+    })(ROS = HOTEL_TRAVEL_MQ.ROS || (HOTEL_TRAVEL_MQ.ROS = {}));
+})(HOTEL_TRAVEL_MQ || (exports.HOTEL_TRAVEL_MQ = HOTEL_TRAVEL_MQ = {}));

package/index.d.ts

@@ -13,6 +13,8 @@ export { ruleService } from './modules/rule/service';
 export { miniProgramService } from './modules/miniprogram/service';
 export { userDataService } from './modules/userData/service';
 export { ENUM as CLIENT_BACKEND_ENUM } from './enum';
+export { HOTEL_TRAVEL_MQ } from './consts';
+export { destroyHttpAgents } from './utils/http';
 export type { Room, RoomAutoStartConfig, RoomLoopVideo, RoomTag, RoomBindStore } from './types';
 export type { Domain, Current } from './modules/domain/types';
 export type { MiniProgram, Info as MiniProgramInfo } from './modules/miniprogram/types';

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CLIENT_BACKEND_ENUM = exports.userDataService = exports.miniProgramService = exports.ruleService = exports.domainService = exports.dataService = exports.roomDataService = exports.roomService = void 0;
+exports.destroyHttpAgents = exports.HOTEL_TRAVEL_MQ = exports.CLIENT_BACKEND_ENUM = exports.userDataService = exports.miniProgramService = exports.ruleService = exports.domainService = exports.dataService = exports.roomDataService = exports.roomService = void 0;
 var service_1 = require("./modules/room/service");
 Object.defineProperty(exports, "roomService", { enumerable: true, get: function () { return service_1.roomService; } });
 var service_2 = require("./modules/roomData/service");
@@ -17,4 +17,8 @@ var service_7 = require("./modules/userData/service");
 Object.defineProperty(exports, "userDataService", { enumerable: true, get: function () { return service_7.userDataService; } });
 var enum_1 = require("./enum");
 Object.defineProperty(exports, "CLIENT_BACKEND_ENUM", { enumerable: true, get: function () { return enum_1.ENUM; } });
+var consts_1 = require("./consts");
+Object.defineProperty(exports, "HOTEL_TRAVEL_MQ", { enumerable: true, get: function () { return consts_1.HOTEL_TRAVEL_MQ; } });
+var http_1 = require("./utils/http");
+Object.defineProperty(exports, "destroyHttpAgents", { enumerable: true, get: function () { return http_1.destroyHttpAgents; } });
 // 服务.模块.枚举名称.枚举值 示例: DEMO_ENUM.ORDER_ENUM.STATUS.PENDING

package/modules/data/service.d.ts

@@ -40,6 +40,10 @@ declare class DataServiceClass extends BaseService implements DataService.BaseCo
     syncPreviewAudienceStatistics(): Promise<void>;
     /** 从订单服务同步 trade_order（定时调度：order_change_log 扫单回写） */
     syncTradeOrderFromOrderService(): Promise<void>;
+    /** 定时校准酒旅用户累计消费金额（脏用户集合回查） */
+    syncHotelTravelUserConsumptionAmount(request?: DataService.Request.SyncHotelTravelUserConsumptionAmount): Promise<void>;
+    /** 一次性历史回填酒旅用户累计消费金额（支持 userId 游标断点续传） */
+    backfillHotelTravelUserConsumptionAmount(request?: DataService.Request.BackfillHotelTravelUserConsumptionAmount): Promise<void>;
     /** 补偿指定直播间的回放观众统计（拉火山回放写回放三字段，用于手动补偿） */
     compensateReplayAudienceStatistics(request: DataService.Request.CompensateReplayAudienceStatistics): Promise<void>;
     batchCompensateReplayAudienceStatistics(request: DataService.Request.BatchCompensateReplayAudienceStatistics): Promise<void>;

package/modules/data/service.js

@@ -101,6 +101,14 @@ let DataServiceClass = class DataServiceClass extends BaseService_1.default {
     syncTradeOrderFromOrderService() {
         return (0, http_1.callApi)(this.getApiUrl(this.syncTradeOrderFromOrderService), undefined);
     }
+    /** 定时校准酒旅用户累计消费金额（脏用户集合回查） */
+    syncHotelTravelUserConsumptionAmount(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.syncHotelTravelUserConsumptionAmount), request);
+    }
+    /** 一次性历史回填酒旅用户累计消费金额（支持 userId 游标断点续传） */
+    backfillHotelTravelUserConsumptionAmount(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.backfillHotelTravelUserConsumptionAmount), request);
+    }
     /** 补偿指定直播间的回放观众统计（拉火山回放写回放三字段，用于手动补偿） */
     compensateReplayAudienceStatistics(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.compensateReplayAudienceStatistics), request);
@@ -254,6 +262,16 @@ __decorate([
     (0, tsoa_1.OperationId)('从订单服务同步 trade_order'),
     (0, tsoa_1.Post)('sync-trade-order-from-order-service')
 ], DataServiceClass.prototype, "syncTradeOrderFromOrderService", null);
+__decorate([
+    (0, tsoa_1.OperationId)('定时校准酒旅用户累计消费金额'),
+    (0, tsoa_1.Post)('sync-hotel-travel-user-consumption-amount'),
+    __param(0, (0, tsoa_1.Body)())
+], DataServiceClass.prototype, "syncHotelTravelUserConsumptionAmount", null);
+__decorate([
+    (0, tsoa_1.OperationId)('一次性历史回填酒旅用户累计消费金额'),
+    (0, tsoa_1.Post)('backfill-hotel-travel-user-consumption-amount'),
+    __param(0, (0, tsoa_1.Body)())
+], DataServiceClass.prototype, "backfillHotelTravelUserConsumptionAmount", null);
 __decorate([
     (0, tsoa_1.OperationId)('补偿回放观众统计'),
     (0, tsoa_1.Post)('compensate-replay-audience-statistics'),

package/modules/data/types.d.ts

@@ -211,6 +211,22 @@ export declare namespace DataService {
             /** 目标对账日期（ISO 8601格式，如 "2024-01-15"），不传则对账昨天 */
             targetDate?: string;
         }
+        /**
+         * 定时校准酒旅用户累计消费金额（脏用户集合回查）
+         */
+        interface SyncHotelTravelUserConsumptionAmount {
+            /** 单次处理用户数（默认500，最大5000） */
+            batchSize?: number;
+        }
+        /**
+         * 一次性历史回填酒旅用户累计消费金额（支持 userId 游标断点续传）
+         */
+        interface BackfillHotelTravelUserConsumptionAmount {
+            /** 单次分页大小（默认500，最大5000） */
+            pageSize?: number;
+            /** 起始 userId（断点续传游标） */
+            startUserId?: string;
+        }
         /**
          * 批量更新用户消费数据（从CSV文件）
          */
@@ -302,6 +318,33 @@ export declare namespace DataService {
             message: string;
         }
     }
+    /**
+     * 直播间统计缓存结构（Redis）
+     */
+    interface LiveStreamRoomStatisticsCache {
+        /** 直播间id */
+        liveStreamRoomId: string;
+        /** 交易总金额（待支付金额+实收金额、含退款金额） */
+        gmv?: number;
+        /** 实收金额：支付成功且未退款金额 */
+        actualReceivedAmount?: number;
+        /** 退款金额 */
+        refundAmount?: number;
+        /** 待支付金额 */
+        pendingPaymentAmount?: number;
+        /** 成交订单数 */
+        transactOrderCount?: number;
+        /** 商品销售量 */
+        salesVolume?: number;
+        /** 待支付份数 */
+        pendingSalesVolume?: number;
+        /** 下单人数（去重） */
+        orderUserCount?: number;
+        /** 退款人数（去重） */
+        refundUserCount?: number;
+        /** 酒旅预计尾款（单位：分） */
+        hotelTravelEstimatedFinalPayment?: number;
+    }
     interface BaseController {
         userLiveStreamRelation(request: Request.UserLiveStreamRelation, req?: FastifyRequest): Promise<void>;
         getUserViewDuration(request: Request.UserViewDuration, req?: FastifyRequest): Promise<Response.UserViewDuration>;
@@ -324,6 +367,8 @@ export declare namespace DataService {
         syncReplayAudienceStatistics(): Promise<void>;
         syncPreviewAudienceStatistics(): Promise<void>;
         syncTradeOrderFromOrderService(): Promise<void>;
+        syncHotelTravelUserConsumptionAmount(request?: Request.SyncHotelTravelUserConsumptionAmount, req?: FastifyRequest): Promise<void>;
+        backfillHotelTravelUserConsumptionAmount(request?: Request.BackfillHotelTravelUserConsumptionAmount, req?: FastifyRequest): Promise<void>;
         compensateReplayAudienceStatistics(request: Request.CompensateReplayAudienceStatistics, req?: FastifyRequest): Promise<void>;
         batchCompensateReplayAudienceStatistics(request: Request.BatchCompensateReplayAudienceStatistics, req?: FastifyRequest): Promise<void>;
         dailyUpdateUserFirstWatchTime(req?: FastifyRequest): Promise<void>;
@@ -405,6 +450,10 @@ export interface RoomStatistics {
     salesVolume: number;
     /** 待支付份数 */
     pendingSalesVolume: number;
+    /** 开通会员卡份数 */
+    memberCardPaidOrderCount: number;
+    /** 酒旅预计尾款（单位：分） */
+    hotelTravelEstimatedFinalPayment: number;
 }
 export interface Product {
     /** 直播间id */

package/modules/roomData/types.d.ts

@@ -126,6 +126,7 @@ export declare namespace RoomDataService {
             productImage: string;
             actualQuantity: number;
             price: number;
+            remainAmount: number;
         }
         interface ProductSalesRanking {
             list: ProductSalesItem[];
@@ -214,6 +215,9 @@ export declare namespace StoreAnalysisService {
         interface StoreAnalysisItem {
             storeId: string;
             storeName: string;
+            province: string;
+            city: string;
+            area: string;
             storeAddress: string;
             viewerCount: number;
             orderUserCount: number;

package/modules/rule/types.d.ts

@@ -3,7 +3,7 @@ export declare namespace RuleService {
     interface Info {
         /** 直播间id */
         liveStreamRoomId: string;
-        /** 规则分类：city-城市、delivery-配送、tag-标签、businessScope-主营业务 */
+        /** 规则分类：city-城市、delivery-配送、urbanDelivery-仓配方式(城配/非城配)、newbieLivePeriodInRoomStart-新手开播期是否覆盖直播开始时间、tag-标签、businessScope-主营业务 */
         cate: string;
         /** 规则值 */
         ruleValue: string;

package/modules/userData/types.d.ts

@@ -40,6 +40,10 @@ export declare namespace UserDataService {
             lastWatchTimeRange?: number[];
             /** 累计消费金额范围（分）[最小值, 最大值] */
             accumulatedConsumptionAmountRange?: number[];
+            /** 总累计消费金额范围（分）[最小值, 最大值] */
+            totalAccumulatedConsumptionAmountRange?: number[];
+            /** 酒旅累计消费金额范围（分）[最小值, 最大值] */
+            hotelTravelAccumulatedConsumptionAmountRange?: number[];
             /** 最近消费时间范围（毫秒）[开始时间, 结束时间] */
             lastConsumptionTimeRange?: number[];
             /** 每页数量，默认20 */
@@ -72,6 +76,12 @@ export declare namespace UserDataService {
             nickname?: string;
             /** 会员等级 */
             memberLevel?: string;
+            /** 电商累计消费金额范围（分）[最小值, 最大值] */
+            accumulatedConsumptionAmountRange?: number[];
+            /** 总累计消费金额范围（分）[最小值, 最大值] */
+            totalAccumulatedConsumptionAmountRange?: number[];
+            /** 酒旅累计消费金额范围（分）[最小值, 最大值] */
+            hotelTravelAccumulatedConsumptionAmountRange?: number[];
             /** 页码，从0开始 */
             pageIndex: number;
             /** 每页数量，默认20，最大1000 */
@@ -93,6 +103,12 @@ export declare namespace UserDataService {
             nickname?: string;
             /** 会员等级 */
             memberLevel?: string;
+            /** 电商累计消费金额范围（分）[最小值, 最大值] */
+            accumulatedConsumptionAmountRange?: number[];
+            /** 总累计消费金额范围（分）[最小值, 最大值] */
+            totalAccumulatedConsumptionAmountRange?: number[];
+            /** 酒旅累计消费金额范围（分）[最小值, 最大值] */
+            hotelTravelAccumulatedConsumptionAmountRange?: number[];
             /** 页码，从0开始 */
             pageIndex: number;
             /** 每页数量，默认20，最大1000 */
@@ -353,6 +369,10 @@ export interface UserInfo {
     lastWatchTime: string;
     /** 累计消费金额（元） */
     accumulatedConsumptionAmount: number;
+    /** 总累计消费金额（元） */
+    totalAccumulatedConsumptionAmount: number;
+    /** 酒旅累计消费金额（元） */
+    hotelTravelAccumulatedConsumptionAmount: number;
     /** 累计退款金额（元） */
     accumulatedRefundAmount: number;
     /** 7天累计消费金额（元） */
@@ -398,6 +418,12 @@ export interface LiveRoomUserItem {
     replayConsumeAmount: number;
     /** 累计消费金额（支付总额 - 退款总额，元） */
     totalConsumeAmount: number;
+    /** 电商累计消费金额（元） */
+    accumulatedConsumptionAmount: number;
+    /** 总累计消费金额（元） */
+    totalAccumulatedConsumptionAmount: number;
+    /** 酒旅累计消费金额（元） */
+    hotelTravelAccumulatedConsumptionAmount: number;
     /** 首次进入直播间时间（毫秒时间戳） */
     firstEnterTime: number;
     /** 最后进入直播间时间（毫秒时间戳） */

package/package.json

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

package/utils/http.d.ts

@@ -9,3 +9,4 @@ declare module '@fastify/request-context' {
     }
 }
 export declare function callApi<T extends (...args: any[]) => Promise<any>>(url: string, request?: Parameters<T>[0]): Promise<Awaited<ReturnType<T>>>;
+export declare function destroyHttpAgents(): void;

package/utils/http.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.callApi = callApi;
+exports.destroyHttpAgents = destroyHttpAgents;
 const axios_1 = __importDefault(require("axios"));
 const uuid_1 = require("uuid");
 const axios_retry_1 = __importDefault(require("axios-retry"));
@@ -106,3 +107,7 @@ async function callApi(url, request) {
     const responseData = response.data;
     return responseData.data;
 }
+function destroyHttpAgents() {
+    httpAgent.destroy();
+    httpsAgent.destroy();
+}