@be-link/ecommerce-promotion-service-node-sdk 0.1.60 → 0.1.62

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/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/types.d.ts

@@ -127,8 +127,6 @@ export declare namespace Service {
         interface claimMemberBenefit {
             /** 用户ID */
             userId: string;
-            /** 会员订单号 */
-            orderNo: string;
             /** 权益ID */
             benefitId: string;
             /** 券权益选择的券ID */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@be-link/ecommerce-promotion-service-node-sdk",
-  "version": "0.1.60",
+  "version": "0.1.62",
   "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();
+}