@be-link/ecommerce-promotion-service-node-sdk 0.1.61 → 0.1.63

package/enum.d.ts

@@ -537,6 +537,15 @@ export declare namespace ENUM {
             SKIPPED = "\u8DF3\u8FC7",
             NOT_NEEDED = "\u65E0\u9700\u56DE\u6536"
         }
+        /**
+         * 会员权益链路（按用户查可领权益列表是否有促销侧记录；调用方约定传入已是会员的 userId）
+         */
+        enum MEMBER_BENEFIT_CHAIN_TYPE {
+            /** 新会员：有可展示的 MemberBenefitRecord */
+            NEW = "NEW",
+            /** 老会员：无 MemberBenefitRecord（历史开通链路） */
+            LEGACY = "LEGACY"
+        }
     }
     namespace TASK_ENUM {
         /** 任务状态 */

package/enum.js

@@ -608,6 +608,16 @@ var ENUM;
             RECOVERY_STATUS_CHINESE["SKIPPED"] = "\u8DF3\u8FC7";
             RECOVERY_STATUS_CHINESE["NOT_NEEDED"] = "\u65E0\u9700\u56DE\u6536";
         })(RECOVERY_STATUS_CHINESE = MEMBER_ENUM.RECOVERY_STATUS_CHINESE || (MEMBER_ENUM.RECOVERY_STATUS_CHINESE = {}));
+        /**
+         * 会员权益链路（按用户查可领权益列表是否有促销侧记录；调用方约定传入已是会员的 userId）
+         */
+        let MEMBER_BENEFIT_CHAIN_TYPE;
+        (function (MEMBER_BENEFIT_CHAIN_TYPE) {
+            /** 新会员：有可展示的 MemberBenefitRecord */
+            MEMBER_BENEFIT_CHAIN_TYPE["NEW"] = "NEW";
+            /** 老会员：无 MemberBenefitRecord（历史开通链路） */
+            MEMBER_BENEFIT_CHAIN_TYPE["LEGACY"] = "LEGACY";
+        })(MEMBER_BENEFIT_CHAIN_TYPE = MEMBER_ENUM.MEMBER_BENEFIT_CHAIN_TYPE || (MEMBER_ENUM.MEMBER_BENEFIT_CHAIN_TYPE = {}));
     })(MEMBER_ENUM = ENUM.MEMBER_ENUM || (ENUM.MEMBER_ENUM = {}));
     let TASK_ENUM;
     (function (TASK_ENUM) {

package/index.d.ts

@@ -16,4 +16,5 @@ export { memberService } from './modules/member/service';
 export type { Service as MemberServiceTypes } from './modules/member/types';
 export { benefitService } from './modules/benefit/service';
 export type { Service as BenefitServiceTypes } from './modules/benefit/types';
+export { destroyHttpAgents } from './utils/http';
 export { ENUM as PROMOTION_ENUM } from './enum';

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROMOTION_ENUM = exports.benefitService = exports.memberService = exports.taskService = exports.jobService = exports.pointsMallService = exports.pricingCalculationService = exports.configService = exports.couponService = exports.awardService = void 0;
+exports.PROMOTION_ENUM = exports.destroyHttpAgents = exports.benefitService = exports.memberService = exports.taskService = exports.jobService = exports.pointsMallService = exports.pricingCalculationService = exports.configService = exports.couponService = exports.awardService = void 0;
 var service_1 = require("./modules/award/service");
 Object.defineProperty(exports, "awardService", { enumerable: true, get: function () { return service_1.awardService; } });
 var service_2 = require("./modules/coupon/service");
@@ -19,6 +19,8 @@ var service_8 = require("./modules/member/service");
 Object.defineProperty(exports, "memberService", { enumerable: true, get: function () { return service_8.memberService; } });
 var service_9 = require("./modules/benefit/service");
 Object.defineProperty(exports, "benefitService", { enumerable: true, get: function () { return service_9.benefitService; } });
+var http_1 = require("./utils/http");
+Object.defineProperty(exports, "destroyHttpAgents", { enumerable: true, get: function () { return http_1.destroyHttpAgents; } });
 // 服务.模块.枚举名称.枚举值 示例: AWARD_ENUM.DISTRIBUTION_CHANNEL.ORDER
 var enum_1 = require("./enum");
 Object.defineProperty(exports, "PROMOTION_ENUM", { enumerable: true, get: function () { return enum_1.ENUM; } });

package/modules/award/types.d.ts

@@ -149,6 +149,8 @@ export declare namespace Service {
             successCount?: number;
             /** 失败数量 */
             failureCount?: number;
+            /** 实际发放数量（券场景下返回实际发放的券数量） */
+            actualQuantity?: number;
         }
         /** 直播间积分&券发放统计响应 */
         interface queryLiveRoomDistributionStatsResponse {

package/modules/benefit/service.js

@@ -104,17 +104,17 @@ __decorate([
     __param(0, (0, tsoa_1.Body)())
 ], BenefitService.prototype, "listConfigsByTemplate", null);
 __decorate([
-    (0, tsoa_1.OperationId)('查询会员订单权益状态'),
+    (0, tsoa_1.OperationId)('查询会员订单权益状态，给交易侧b端查询使用'),
     (0, tsoa_1.Post)('get-benefit-status'),
     __param(0, (0, tsoa_1.Body)())
 ], BenefitService.prototype, "getBenefitStatus", null);
 __decorate([
-    (0, tsoa_1.OperationId)('按用户查询当前会员权益状态'),
+    (0, tsoa_1.OperationId)('按用户查询当前会员权益状态，给c端查询使用'),
     (0, tsoa_1.Post)('get-benefit-status-by-user-id'),
     __param(0, (0, tsoa_1.Body)())
 ], BenefitService.prototype, "getBenefitStatusByUserId", null);
 __decorate([
-    (0, tsoa_1.OperationId)('按城市查询黑钻模板ID'),
+    (0, tsoa_1.OperationId)('按城市查询黑钻模板ID，给c端查询使用'),
     (0, tsoa_1.Post)('get-black-diamond-template-id-by-city'),
     __param(0, (0, tsoa_1.Body)())
 ], BenefitService.prototype, "getBlackDiamondTemplateIdByCity", null);

package/modules/benefit/types.d.ts

@@ -67,6 +67,62 @@ export declare namespace Service {
             /** 删除时间（时间戳，毫秒，0 表示未删除） */
             deletedAt: number;
         }
+        /** 核销券关联商品快照（商品中心字段裁剪） */
+        interface BenefitVerifyProductSnapshot {
+            productId: string;
+            productName: string;
+            mainImg: string;
+            pickType?: string;
+            dispatchType?: string;
+            status?: string;
+            needVerify?: number;
+            verifyPeriod?: {
+                startDate?: number;
+                endDate?: number;
+                payAfterDay?: number;
+                type?: number;
+            };
+            targetSkuId?: string;
+            targetSkuCode?: string;
+            targetSkuAttrs?: Array<{
+                attrName: string;
+                attrValue: string;
+            }>;
+            price?: number;
+            memberPrice?: number;
+            strikethroughPrice?: number;
+            skuStatus?: string;
+            skuListSummary?: Array<{
+                skuId: string;
+                skuCode: string;
+                attrs: Array<{
+                    attrName: string;
+                    attrValue: string;
+                }>;
+                price: number;
+                memberPrice: number;
+                strikethroughPrice?: number;
+                status: string;
+            }>;
+        }
+        /** 单个候选券对应的商品信息 */
+        interface BenefitCouponVerifyOption {
+            /** 候选券模板ID（用于和商品建立关联） */
+            couponTemplateId: string;
+            product: BenefitVerifyProductSnapshot | null;
+            productFetchError?: string;
+        }
+        /** 一条券权益（N 选 1 核销券）的展示数据 */
+        interface BenefitCouponBenefitDetail {
+            benefitId: string;
+            claimStatus: ENUM.MEMBER_ENUM.BENEFIT_CLAIM_STATUS;
+            /**
+             * 用户已选择的券模板 ID（与领取接口 couponId 一致，未选为空串时不返回）
+             */
+            selectedCouponTemplateId?: string;
+            /** 候选券对应的商品信息 */
+            verifyOptions: BenefitCouponVerifyOption[];
+        }
         /** 会员订单权益状态 */
         interface BenefitStatus {
             /** 积分权益状态 */
@@ -84,13 +140,30 @@ export declare namespace Service {
             hotelTravel?: {
                 status: string;
             };
-            /** 权益领取态列表 */
-            benefitClaims?: Array<{
-                benefitId: string;
-                benefitSubType: ENUM.MEMBER_ENUM.BENEFIT_SUB_TYPE;
-                claimStatus: ENUM.MEMBER_ENUM.BENEFIT_CLAIM_STATUS;
-                selectedCouponId?: string;
-            }>;
+        }
+        /** 按用户查询当前权益状态的列表项（与会员权益列表结构对齐） */
+        interface BenefitStatusByUserIdItem {
+            id: string;
+            bizKey: string;
+            userId: string;
+            orderNo: string;
+            membershipType: string;
+            benefitType: string;
+            benefitSubType: ENUM.MEMBER_ENUM.BENEFIT_SUB_TYPE;
+            status: string;
+            failReason: string;
+            benefitId: string;
+            claimStatus: ENUM.MEMBER_ENUM.BENEFIT_CLAIM_STATUS;
+            selectedCouponId: string;
+            templateId: string;
+            couponCandidateIds: string[];
+            expireAt: number;
+            extra: Record<string, unknown>;
+            createdAt: number;
+            updatedAt: number;
+            deletedAt: number;
+            /** 仅券权益返回：候选券对应商品信息 */
+            verifyOptions?: BenefitCouponVerifyOption[];
         }
     }
     namespace Request {
@@ -312,8 +385,15 @@ export declare namespace Service {
         type listConfigsByTemplate = Entity.BenefitConfig[];
         /** 会员订单权益状态 */
         type getBenefitStatus = Entity.BenefitStatus;
-        /** 按用户查询当前会员权益状态 */
-        type getBenefitStatusByUserId = Entity.BenefitStatus;
+        /** 按用户查询当前会员权益状态（权益列表结构） */
+        interface getBenefitStatusByUserId {
+            orderNo: string;
+            list: Entity.BenefitStatusByUserIdItem[];
+            /**
+             * 权益链路：约定传入已是会员的 userId；list 有数据=新会员，无数据=老会员
+             */
+            memberBenefitChainType: ENUM.MEMBER_ENUM.MEMBER_BENEFIT_CHAIN_TYPE;
+        }
         /** 按城市查询黑钻模板ID */
         interface getBlackDiamondTemplateIdByCity {
             /** 模板ID */

package/modules/member/service.d.ts

@@ -7,6 +7,10 @@ declare class MemberService extends BaseService implements Service.MemberControl
     listBenefitOfficers(request: Service.Request.listBenefitOfficers): Promise<Service.Response.listBenefitOfficers>;
     listClaimableBenefits(request: Service.Request.listClaimableBenefits): Promise<Service.Response.listClaimableBenefits>;
     claimMemberBenefit(request: Service.Request.claimMemberBenefit): Promise<Service.Response.claimMemberBenefit>;
+    triggerMemberPriceOrderCompleted(request: Service.Request.triggerMemberPriceOrderCompleted): Promise<Service.Response.triggerMemberPriceOrderCompleted>;
+    triggerMemberPriceOrderPositiveClosed(request: Service.Request.triggerMemberPriceOrderPositiveClosed): Promise<Service.Response.triggerMemberPriceOrderPositiveClosed>;
+    backfillMemberSavingByDate(request: Service.Request.backfillMemberSavingByDate): Promise<Service.Response.backfillMemberSavingByDate>;
+    getBackfillMemberSavingTaskStatus(request: Service.Request.getBackfillMemberSavingTaskStatus): Promise<Service.Response.getBackfillMemberSavingTaskStatus>;
 }
 export declare const memberService: MemberService;
 export default memberService;

package/modules/member/service.js

@@ -36,6 +36,18 @@ let MemberService = class MemberService extends BaseService_1.default {
     claimMemberBenefit(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.claimMemberBenefit), request);
     }
+    triggerMemberPriceOrderCompleted(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.triggerMemberPriceOrderCompleted), request);
+    }
+    triggerMemberPriceOrderPositiveClosed(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.triggerMemberPriceOrderPositiveClosed), request);
+    }
+    backfillMemberSavingByDate(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.backfillMemberSavingByDate), request);
+    }
+    getBackfillMemberSavingTaskStatus(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getBackfillMemberSavingTaskStatus), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('会员正向触发（mock trade）'),
@@ -62,6 +74,26 @@ __decorate([
     (0, tsoa_1.Post)('claim-member-benefit'),
     __param(0, (0, tsoa_1.Body)())
 ], MemberService.prototype, "claimMemberBenefit", null);
+__decorate([
+    (0, tsoa_1.OperationId)('测试触发会员价订单正向省钱累计'),
+    (0, tsoa_1.Post)('trigger-member-price-order-completed'),
+    __param(0, (0, tsoa_1.Body)())
+], MemberService.prototype, "triggerMemberPriceOrderCompleted", null);
+__decorate([
+    (0, tsoa_1.OperationId)('测试触发会员价订单正向关单省钱冲销'),
+    (0, tsoa_1.Post)('trigger-member-price-order-positive-closed'),
+    __param(0, (0, tsoa_1.Body)())
+], MemberService.prototype, "triggerMemberPriceOrderPositiveClosed", null);
+__decorate([
+    (0, tsoa_1.OperationId)('按完成日回补会员省钱明细（按天异步）'),
+    (0, tsoa_1.Post)('backfill-member-saving-by-date'),
+    __param(0, (0, tsoa_1.Body)())
+], MemberService.prototype, "backfillMemberSavingByDate", null);
+__decorate([
+    (0, tsoa_1.OperationId)('查询会员省钱回补任务状态'),
+    (0, tsoa_1.Post)('get-backfill-member-saving-task-status'),
+    __param(0, (0, tsoa_1.Body)())
+], MemberService.prototype, "getBackfillMemberSavingTaskStatus", null);
 MemberService = __decorate([
     (0, tsoa_1.Route)('member'),
     (0, tsoa_1.Tags)('Member')

package/modules/member/types.d.ts

@@ -127,13 +127,31 @@ export declare namespace Service {
         interface claimMemberBenefit {
             /** 用户ID */
             userId: string;
-            /** 会员订单号 */
-            orderNo: string;
             /** 权益ID */
             benefitId: string;
             /** 券权益选择的券ID */
             couponId?: string;
         }
+        /** 测试触发会员价订单正向省钱累计 */
+        interface triggerMemberPriceOrderCompleted {
+            userId: string;
+            orderNo: string;
+        }
+        /** 测试触发会员价订单正向关单省钱冲销（对齐 trade.order.positive.closed） */
+        interface triggerMemberPriceOrderPositiveClosed {
+            userId: string;
+            orderNo: string;
+        }
+        /**
+         * 按订单完成日回补会员省钱（单日）。建议配置 MEMBER_SAVING_BACKFILL_SECRET，请求头 x-member-saving-backfill-secret
+         */
+        interface backfillMemberSavingByDate {
+            /** 处理日期，YYYYMMDD，例如 20251022 */
+            date: string;
+        }
+        interface getBackfillMemberSavingTaskStatus {
+            taskId: string;
+        }
     }
     namespace Response {
         type triggerMemberOrderPaid = void;
@@ -146,6 +164,70 @@ export declare namespace Service {
         interface claimMemberBenefit {
             claimStatus: string;
         }
+        type triggerMemberPriceOrderCompleted = void;
+        type triggerMemberPriceOrderPositiveClosed = void;
+        interface backfillMemberSavingByDate {
+            taskId: string;
+            date: string;
+            status: 'QUEUED';
+            createdAt: number;
+            /** 存在同日运行中任务时返回，用于提示请求被去重 */
+            activeTaskId?: string;
+        }
+        interface getBackfillMemberSavingTaskStatus {
+            taskId: string;
+            date: string;
+            status: 'QUEUED' | 'RUNNING' | 'SUCCESS' | 'FAILED';
+            createdAt: number;
+            startedAt?: number;
+            finishedAt?: number;
+            progress?: {
+                stage: 'QUERY' | 'WRITE' | 'DONE';
+                day: string;
+                pageIndex: number;
+                pages: number;
+                scanned: number;
+                memberOrders: number;
+                pointsOrders: number;
+                normalOrders: number;
+                aggregatedUsers: number;
+                written: number;
+                failed: number;
+                lastMessage: string;
+                updatedAt: number;
+            };
+            result?: {
+                range: {
+                    start: string;
+                    end: string;
+                };
+                totals: {
+                    scanned: number;
+                    memberOrders: number;
+                    pointsOrders: number;
+                    normalOrders: number;
+                    written: number;
+                    aggregatedUsers: number;
+                    failed: number;
+                    pages: number;
+                };
+                perDay: Array<{
+                    day: string;
+                    scanned: number;
+                    memberOrders: number;
+                    pointsOrders: number;
+                    normalOrders: number;
+                    written: number;
+                    aggregatedUsers: number;
+                    failed: number;
+                    pages: number;
+                }>;
+                failuresTotal: number;
+                failuresTruncated: boolean;
+            };
+            error?: string;
+            activeTaskId?: string;
+        }
     }
     interface MemberController {
         triggerMemberOrderPaid(request: Request.triggerMemberOrderPaid): Promise<Response.triggerMemberOrderPaid>;
@@ -153,5 +235,9 @@ export declare namespace Service {
         listBenefitOfficers(request: Request.listBenefitOfficers): Promise<Response.listBenefitOfficers>;
         listClaimableBenefits(request: Request.listClaimableBenefits): Promise<Response.listClaimableBenefits>;
         claimMemberBenefit(request: Request.claimMemberBenefit): Promise<Response.claimMemberBenefit>;
+        triggerMemberPriceOrderCompleted(request: Request.triggerMemberPriceOrderCompleted): Promise<Response.triggerMemberPriceOrderCompleted>;
+        triggerMemberPriceOrderPositiveClosed(request: Request.triggerMemberPriceOrderPositiveClosed): Promise<Response.triggerMemberPriceOrderPositiveClosed>;
+        backfillMemberSavingByDate(request: Request.backfillMemberSavingByDate): Promise<Response.backfillMemberSavingByDate>;
+        getBackfillMemberSavingTaskStatus(request: Request.getBackfillMemberSavingTaskStatus): Promise<Response.getBackfillMemberSavingTaskStatus>;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@be-link/ecommerce-promotion-service-node-sdk",
-  "version": "0.1.61",
+  "version": "0.1.63",
   "description": "EcommercePromotionService Node.js SDK",
   "main": "index.js",
   "types": "index.d.ts",

package/utils/http.d.ts

@@ -9,3 +9,8 @@ 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>>>;
+/**
+ * 优雅退出时，销毁所有 HTTP/HTTPS Agent 连接池
+ * 确保所有 socket 被正确关闭，防止进程 hang 住
+ */
+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,11 @@ async function callApi(url, request) {
     const responseData = response.data;
     return responseData.data;
 }
+/**
+ * 优雅退出时，销毁所有 HTTP/HTTPS Agent 连接池
+ * 确保所有 socket 被正确关闭，防止进程 hang 住
+ */
+function destroyHttpAgents() {
+    httpAgent.destroy();
+    httpsAgent.destroy();
+}