@be-link/ecommerce-promotion-service-node-sdk 0.0.1

package/modules/pointsMall/service.js

@@ -0,0 +1,70 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pointsMallService = void 0;
+const tsoa_1 = require("tsoa");
+const http_1 = require("../../utils/http");
+const BaseService_1 = __importDefault(require("../BaseService"));
+let PointsMallService = class PointsMallService extends BaseService_1.default {
+    constructor() {
+        super(...arguments);
+        this.prefixUrl = '/points-mall';
+    }
+    createProduct(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.createProduct), request);
+    }
+    updateProduct(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.updateProduct), request);
+    }
+    batchToggleProductEnabled(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.batchToggleProductEnabled), request);
+    }
+    batchToggleProductOnline(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.batchToggleProductOnline), request);
+    }
+    queryProducts(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.queryProducts), request);
+    }
+};
+__decorate([
+    (0, tsoa_1.OperationId)('创建积分商城商品'),
+    (0, tsoa_1.Post)('create-product'),
+    __param(0, (0, tsoa_1.Body)())
+], PointsMallService.prototype, "createProduct", null);
+__decorate([
+    (0, tsoa_1.OperationId)('编辑积分商城商品'),
+    (0, tsoa_1.Post)('update-product'),
+    __param(0, (0, tsoa_1.Body)())
+], PointsMallService.prototype, "updateProduct", null);
+__decorate([
+    (0, tsoa_1.OperationId)('批量是否开启'),
+    (0, tsoa_1.Post)('batch-toggle-product-enabled'),
+    __param(0, (0, tsoa_1.Body)())
+], PointsMallService.prototype, "batchToggleProductEnabled", null);
+__decorate([
+    (0, tsoa_1.OperationId)('批量是否上下架'),
+    (0, tsoa_1.Post)('batch-toggle-product-online'),
+    __param(0, (0, tsoa_1.Body)())
+], PointsMallService.prototype, "batchToggleProductOnline", null);
+__decorate([
+    (0, tsoa_1.OperationId)('根据条件查询积分商城商品'),
+    (0, tsoa_1.Post)('query-products'),
+    __param(0, (0, tsoa_1.Body)())
+], PointsMallService.prototype, "queryProducts", null);
+PointsMallService = __decorate([
+    (0, tsoa_1.Route)('points-mall'),
+    (0, tsoa_1.Tags)('PointsMall')
+], PointsMallService);
+exports.pointsMallService = new PointsMallService();
+exports.default = exports.pointsMallService;

package/modules/pointsMall/types.d.ts

@@ -0,0 +1,135 @@
+export declare namespace Service {
+    /** 兑换类型 */
+    enum ExchangeType {
+        /** 仅积分 */
+        POINTS_ONLY = "POINTS_ONLY",
+        /** 仅券 */
+        COUPON_ONLY = "COUPON_ONLY",
+        /** 积分+券 */
+        POINTS_AND_COUPON = "POINTS_AND_COUPON",
+        /** 其他 */
+        OTHER = "OTHER"
+    }
+    namespace Entity {
+        /** 商品积分兑换配置 */
+        interface ProductPointExchange {
+            /** 主键ID */
+            id: string;
+            /** 创建时间 */
+            createdAt: number;
+            /** 更新时间 */
+            updatedAt: number;
+            /** 删除时间 */
+            deletedAt: number;
+            /** 商品ID */
+            productId: string;
+            /** 所需券的数量 */
+            couponRequired: number;
+            /** 所需积分的数量 */
+            pointsRequired: number;
+            /** 兑换类型 */
+            exchangeType: ExchangeType;
+            /** 是否开启 */
+            enabled: boolean;
+            /** 是否上架 */
+            online: boolean;
+            /** 排序权重 */
+            sortOrder: number;
+        }
+    }
+    namespace Request {
+        /** 创建积分商城商品 */
+        interface createProduct {
+            /** 商品ID */
+            productId: string;
+            /** 所需券的数量 */
+            couponRequired?: number;
+            /** 所需积分的数量 */
+            pointsRequired?: number;
+            /** 兑换类型 */
+            exchangeType: ExchangeType;
+            /** 是否开启 */
+            enabled?: boolean;
+            /** 是否上架 */
+            online?: boolean;
+            /** 排序权重 */
+            sortOrder: number;
+        }
+        /** 编辑积分商城商品 */
+        interface updateProduct {
+            /** 主键ID */
+            id: string;
+            /** 商品ID */
+            productId?: string;
+            /** 所需券的数量 */
+            couponRequired?: number;
+            /** 所需积分的数量 */
+            pointsRequired?: number;
+            /** 兑换类型 */
+            exchangeType?: ExchangeType;
+            /** 是否开启 */
+            enabled?: boolean;
+            /** 是否上架 */
+            online?: boolean;
+            /** 排序权重 */
+            sortOrder?: number;
+        }
+        /** 批量是否开启 */
+        interface batchToggleProductEnabled {
+            /** 主键ID列表 */
+            ids: string[];
+            /** 是否开启 */
+            enabled: boolean;
+        }
+        /** 批量是否上下架 */
+        interface batchToggleProductOnline {
+            /** 主键ID列表 */
+            ids: string[];
+            /** 是否上架 */
+            online: boolean;
+        }
+        /** 根据条件查询积分商城商品 */
+        interface queryProducts {
+            /** 主键ID */
+            id?: string;
+            /** 是否开启 */
+            enabled?: boolean;
+            /** 是否上架 */
+            online?: boolean;
+            /** 页码 */
+            page?: number;
+            /** 每页数量 */
+            pageSize?: number;
+        }
+    }
+    namespace Response {
+        /** 创建积分商城商品响应 */
+        interface createProduct {
+            /** 主键ID */
+            id: string;
+        }
+        /** 查询积分商城商品响应 */
+        interface queryProducts {
+            /** 商品列表 */
+            items: Entity.ProductPointExchange[];
+            /** 总数 */
+            total: number;
+            /** 当前页码 */
+            page: number;
+            /** 每页数量 */
+            pageSize: number;
+        }
+    }
+    interface PointsMallController {
+        /** 创建积分商城商品 */
+        createProduct(request: Service.Request.createProduct, req: any): Promise<Service.Response.createProduct>;
+        /** 编辑积分商城商品 */
+        updateProduct(request: Service.Request.updateProduct, req: any): Promise<void>;
+        /** 批量是否开启 */
+        batchToggleProductEnabled(request: Service.Request.batchToggleProductEnabled, req: any): Promise<void>;
+        /** 批量是否上下架 */
+        batchToggleProductOnline(request: Service.Request.batchToggleProductOnline, req: any): Promise<void>;
+        /** 根据条件查询积分商城商品 */
+        queryProducts(request: Service.Request.queryProducts, req: any): Promise<Service.Response.queryProducts>;
+    }
+}

package/modules/pointsMall/types.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Service = void 0;
+var Service;
+(function (Service) {
+    // ==================== 枚举类型 ====================
+    /** 兑换类型 */
+    let ExchangeType;
+    (function (ExchangeType) {
+        /** 仅积分 */
+        ExchangeType["POINTS_ONLY"] = "POINTS_ONLY";
+        /** 仅券 */
+        ExchangeType["COUPON_ONLY"] = "COUPON_ONLY";
+        /** 积分+券 */
+        ExchangeType["POINTS_AND_COUPON"] = "POINTS_AND_COUPON";
+        /** 其他 */
+        ExchangeType["OTHER"] = "OTHER";
+    })(ExchangeType = Service.ExchangeType || (Service.ExchangeType = {}));
+})(Service || (exports.Service = Service = {}));

package/modules/pricingCalculation/service.d.ts

@@ -0,0 +1,11 @@
+import { Service } from './types';
+import BaseService from '../BaseService';
+declare class PricingCalculationService extends BaseService implements Service.PricingCalculationController {
+    protected prefixUrl: string;
+    calculateOrderPrice(request: Service.Request.calculateOrderPrice): Promise<Service.Response.calculateOrderPrice>;
+    calculateWithSelectedDiscounts(request: Service.Request.calculateWithSelectedDiscounts): Promise<Service.Response.calculateWithSelectedDiscounts>;
+    calculatePointsMallOrder(request: Service.Request.calculatePointsMallOrder): Promise<Service.Response.calculatePointsMallOrder>;
+    recalculatePointsMallOrder(request: Service.Request.recalculatePointsMallOrder): Promise<Service.Response.recalculatePointsMallOrder>;
+}
+export declare const pricingCalculationService: PricingCalculationService;
+export default pricingCalculationService;

package/modules/pricingCalculation/service.js

@@ -0,0 +1,62 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pricingCalculationService = void 0;
+const tsoa_1 = require("tsoa");
+const http_1 = require("../../utils/http");
+const BaseService_1 = __importDefault(require("../BaseService"));
+let PricingCalculationService = class PricingCalculationService extends BaseService_1.default {
+    constructor() {
+        super(...arguments);
+        this.prefixUrl = '/pricing-calculation';
+    }
+    calculateOrderPrice(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.calculateOrderPrice), request);
+    }
+    calculateWithSelectedDiscounts(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.calculateWithSelectedDiscounts), request);
+    }
+    calculatePointsMallOrder(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.calculatePointsMallOrder), request);
+    }
+    recalculatePointsMallOrder(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.recalculatePointsMallOrder), request);
+    }
+};
+__decorate([
+    (0, tsoa_1.OperationId)('提单页算价'),
+    (0, tsoa_1.Post)('calculate-order-price'),
+    __param(0, (0, tsoa_1.Body)())
+], PricingCalculationService.prototype, "calculateOrderPrice", null);
+__decorate([
+    (0, tsoa_1.OperationId)('用户手动选择优惠后算价'),
+    (0, tsoa_1.Post)('calculate-with-selected-discounts'),
+    __param(0, (0, tsoa_1.Body)())
+], PricingCalculationService.prototype, "calculateWithSelectedDiscounts", null);
+__decorate([
+    (0, tsoa_1.OperationId)('积分商城提单算价'),
+    (0, tsoa_1.Post)('calculate-points-mall-order'),
+    __param(0, (0, tsoa_1.Body)())
+], PricingCalculationService.prototype, "calculatePointsMallOrder", null);
+__decorate([
+    (0, tsoa_1.OperationId)('积分商城用户选择后再次算价'),
+    (0, tsoa_1.Post)('recalculate-points-mall-order'),
+    __param(0, (0, tsoa_1.Body)())
+], PricingCalculationService.prototype, "recalculatePointsMallOrder", null);
+PricingCalculationService = __decorate([
+    (0, tsoa_1.Route)('pricing-calculation'),
+    (0, tsoa_1.Tags)('PricingCalculation')
+], PricingCalculationService);
+exports.pricingCalculationService = new PricingCalculationService();
+exports.default = exports.pricingCalculationService;

package/modules/pricingCalculation/types.d.ts

@@ -0,0 +1,219 @@
+import { ENUM } from '../../enum';
+export declare namespace Service {
+    namespace Entity {
+        /** 商品信息 */
+        interface ProductItem {
+            /** 商品ID */
+            productId: string;
+            /** 商品名称 */
+            productName?: string;
+            /** 商品数量 */
+            quantity: number;
+            /** 商品单价（分） */
+            unitPrice: number;
+            /** SKU ID */
+            skuId?: string;
+            /** SKU信息 */
+            skuInfo?: any;
+        }
+        /** 优惠券信息 */
+        interface CouponInfo {
+            /** 用户券ID */
+            userCouponId: string;
+            /** 券模板ID */
+            couponId: string;
+            /** 券码 */
+            couponCode: string;
+            /** 券名称 */
+            couponName: string;
+            /** 券类型 */
+            couponType: ENUM.PRICING_CALCULATION_ENUM.CouponType;
+            /** 优惠金额（分） */
+            discountAmount: number;
+            /** 生效时间 */
+            effectAt: number;
+            /** 过期时间 */
+            expireAt: number;
+            /** 优惠规则描述 */
+            ruleDescription?: string;
+            /** 最优选中 */
+            isSelected?: boolean;
+        }
+        /** 积分抵扣规则 */
+        interface PointsDeductionRule {
+            /** 是否可用积分 */
+            available: boolean;
+            /** 用户可用积分 */
+            userAvailablePoints: number;
+            /** 本单最多可用积分 */
+            maxUsablePoints: number;
+            /** 本单最少可用积分 */
+            minUsablePoints: number;
+            /** 积分抵扣比例（如：10积分=1元，则值为10） */
+            pointsToMoneyRatio: number;
+            /** 积分抵扣规则描述 */
+            ruleDescription?: string;
+        }
+        /** 优惠券分组统计 */
+        interface CouponGroupStats {
+            /** 券类型 */
+            couponType: ENUM.PRICING_CALCULATION_ENUM.CouponType;
+            /** 该类型券可用数量 */
+            count?: number;
+            /** 最优选中数量 */
+            selectedCount: number;
+        }
+    }
+    namespace Request {
+        /** 提单页算价 */
+        interface calculateOrderPrice {
+            /** 用户ID */
+            userId: string;
+            /** 商品ID */
+            productId: string;
+            /** 商品数量 */
+            quantity: number;
+            /** SKU ID */
+            skuId: string;
+            /** 订单来源 */
+            source: ENUM.PRICING_CALCULATION_ENUM.OrderSource;
+        }
+        /** 用户手动选择优惠后算价 */
+        interface calculateWithSelectedDiscounts {
+            /** 用户ID */
+            userId: string;
+            /** 商品ID */
+            productId: string;
+            /** 商品数量 */
+            quantity: number;
+            /** SKU ID */
+            skuId: string;
+            /** 选择的优惠券券码列表 */
+            selectedCouponCodes?: string[];
+            /** 使用的积分数量 */
+            pointsToUse?: number;
+        }
+        /** 积分商城提单算价 */
+        interface calculatePointsMallOrder {
+            /** 商品ID */
+            productId: string;
+            /** 用户ID */
+            userId: string;
+            /** 商品数量 */
+            quantity: number;
+            /** SKU ID */
+            skuId: string;
+        }
+        /** 积分商城用户选择后再次算价 */
+        interface recalculatePointsMallOrder {
+            /** 用户ID */
+            userId: string;
+            /** 商品ID */
+            productId: string;
+            /** SKU ID */
+            skuId: string;
+            /** 商品数量 */
+            quantity: number;
+            /** 用户选择优惠券 */
+            selectedCouponStats: Entity.CouponGroupStats[];
+            /** 使用的积分数量 */
+            pointsToUse?: number;
+        }
+    }
+    namespace Response {
+        /** 提单页算价响应 */
+        interface calculateOrderPrice {
+            /** 商品原价总计（分） */
+            originalAmount: number;
+            /** 总优惠金额（分） */
+            totalDiscountAmount: number;
+            /** 优惠后金额（分） */
+            discountedAmount: number;
+            /** 最高抵扣金额（分） */
+            pointsMaxDeductionAmount: number;
+            /** 剩余待支付金额（分） */
+            remainingAmount: number;
+            /** 最优优惠券组合 */
+            /** 积分抵扣规则 */
+            pointsDeductionRule: Entity.PointsDeductionRule;
+            /** 用户所有可用优惠券列表 */
+            availableCoupons?: Entity.CouponInfo[];
+        }
+        /** 优惠明细项 */
+        interface DiscountDetailItem {
+            /** 优惠类型（coupon-优惠券、points-积分） */
+            type: string;
+            /** 优惠名称 */
+            name: string;
+            /** 优惠金额（分） */
+            amount: number;
+            /** 明细ID（如券码、积分记录ID） */
+            detailId?: string;
+        }
+        /** 用户手动选择优惠后算价响应 */
+        interface calculateWithSelectedDiscounts {
+            /** 订单原价（分） */
+            originalAmount: number;
+            /** 券优惠金额（分） */
+            couponDiscountAmount: number;
+            /** 积分抵扣金额（分） */
+            pointsDeductionAmount: number;
+            /** 总优惠金额（分） */
+            totalDiscountAmount: number;
+            /** 最终待支付金额（分） */
+            finalPayableAmount: number;
+            /** 实际使用的积分数量 */
+            actualUsedPoints: number;
+            /** 使用的优惠券列表 */
+            usedCoupons: Entity.CouponInfo[];
+            /** 是否有效（优惠券或积分是否可用） */
+            isValid: boolean;
+            /** 无效原因（如果无效） */
+            invalidReason?: string;
+        }
+        /** 积分商城提单算价响应 */
+        interface calculatePointsMallOrder {
+            /** 商品ID */
+            productId: string;
+            /** SKU ID */
+            skuId: string;
+            /** 商品数量 */
+            quantity: number;
+            /** 兑换所需积分 */
+            requiredPoints: number;
+            /** 兑换所需优惠券数量 */
+            requiredCoupons: number;
+            /** 用户可用优惠券分组统计 */
+            availableCouponStats: Entity.CouponGroupStats[];
+            /** 用户可用积分数量 */
+            userAvailablePoints?: number;
+        }
+        /** 积分商城用户选择后再次算价响应 */
+        interface recalculatePointsMallOrder {
+            /** 商品ID */
+            productId: string;
+            /** SKU ID */
+            skuId: string;
+            /** 商品数量 */
+            quantity: number;
+            /** 兑换所需积分 */
+            requiredPoints: number;
+            /** 兑换所需优惠券数量 */
+            requiredCoupons: number;
+            /** 使用积分数量 */
+            usedPoints: number;
+            /** 使用兑换券明细列表 */
+            usedCoupons: Entity.CouponInfo[];
+        }
+    }
+    interface PricingCalculationController {
+        /** 提单页算价 */
+        calculateOrderPrice(request: Service.Request.calculateOrderPrice, req: any): Promise<Service.Response.calculateOrderPrice>;
+        /** 用户手动选择优惠后算价 */
+        calculateWithSelectedDiscounts(request: Service.Request.calculateWithSelectedDiscounts, req: any): Promise<Service.Response.calculateWithSelectedDiscounts>;
+        /** 积分商城提单算价 */
+        calculatePointsMallOrder(request: Service.Request.calculatePointsMallOrder, req: any): Promise<Service.Response.calculatePointsMallOrder>;
+        /** 积分商城用户选择后再次算价 */
+        recalculatePointsMallOrder(request: Service.Request.recalculatePointsMallOrder, req: any): Promise<Service.Response.recalculatePointsMallOrder>;
+    }
+}

package/modules/pricingCalculation/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@be-link/ecommerce-promotion-service-node-sdk",
+  "version": "0.0.1",
+  "description": "EcommercePromotionService Node.js SDK",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "author": "",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@fastify/request-context": "6.2.1",
+    "axios": "1.13.2",
+    "axios-retry": "4.0.0",
+    "uuid": "9.0.1"
+  },
+  "devDependencies": {
+    "tsoa": "^6.6.0"
+  },
+  "scripts": {
+    "build": "rm -rf ./dist && tsc && cp package.json README.md ./dist/ 2>/dev/null || true",
+    "test": "jest",
+    "swagger": "tsoa spec",
+    "build:swagger": "npm run swagger && npm run build && npm run swagger",
+    "generate:service": "node scripts/generate-service.js"
+  }
+}

package/utils/env.d.ts

@@ -0,0 +1,12 @@
+declare class EnvUtils {
+    /**
+     * 判断是否为生产环境
+     */
+    isProduction(): boolean;
+    /**
+     * 获取环境变量
+     */
+    getEnv(key: string, defaultValue?: string): string | undefined;
+}
+declare const envUtils: EnvUtils;
+export default envUtils;

package/utils/env.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class EnvUtils {
+    /**
+     * 判断是否为生产环境
+     */
+    isProduction() {
+        return process.env.NODE_ENV === 'prod';
+    }
+    /**
+     * 获取环境变量
+     */
+    getEnv(key, defaultValue) {
+        return process.env[key] || defaultValue;
+    }
+}
+const envUtils = new EnvUtils();
+exports.default = envUtils;

package/utils/http.d.ts

@@ -0,0 +1,7 @@
+declare module '@fastify/request-context' {
+    interface RequestContextData {
+        requestId?: string;
+        traceMessageId?: string;
+    }
+}
+export declare function callApi<T extends (...args: any[]) => Promise<any>>(url: string, request?: Parameters<T>[0]): Promise<Awaited<ReturnType<T>>>;