@pisell/pisellos 0.10.28 → 0.10.29

package/dist/server/modules/order/types.d.ts

@@ -75,6 +75,10 @@ export interface OrderProductBundleItem {
     extension_type?: string;
     /** 选项 */
     option?: unknown[];
+    /** 套餐子商品备注快照 */
+    note?: string | Record<string, unknown> | null;
+    /** 兼容已经规范化的商品备注字段 */
+    product_note?: string | Record<string, unknown> | null;
 }
 /** 商品行 metadata，常含 unique_identification_number */
 export interface OrderProductMetadata {
@@ -108,6 +112,10 @@ export interface OrderProductLineItem {
     product_title?: OrderProductTitleSnapshot | string | null;
     /** 商品封面图 */
     product_cover?: string | null;
+    /** 商品备注快照 */
+    note?: string | Record<string, unknown> | null;
+    /** 兼容已经规范化的商品备注字段 */
+    product_note?: string | Record<string, unknown> | null;
     /** 多规格 ID。来源：Detail.product_variant_id */
     product_variant_id?: number;
     /**
@@ -262,6 +270,23 @@ export interface OrderPaymentItem {
     /** 元数据；三方支付成功后可含 unique_payment_number */
     metadata?: OrderPaymentMetadata | null;
 }
+/** 订单退款记录（仅使用真实退款记录构造退款历史） */
+export interface OrderRefundItem {
+    order_refund_id?: number | string;
+    refund_number?: string;
+    order_payment_id?: number | string;
+    payment_id?: number | string;
+    amount?: OrderMoneyString | number;
+    refund_amount?: OrderMoneyString | number;
+    total_amount?: OrderMoneyString | number;
+    status?: string;
+    refund_time?: string | null;
+    refunded_at?: string | null;
+    created_at?: string | null;
+    updated_at?: string | null;
+    payment?: Partial<OrderPaymentItem> & Record<string, unknown>;
+    [key: string]: unknown;
+}
 /**
  * 订单附加费（3.6 surcharges）
  */
@@ -284,6 +309,8 @@ export interface OrderSurchargeItem {
     amount: OrderMoneyString;
 }
 export interface OrderSummary {
+    /** 兼容部分历史详情把支付状态放在 summary 中 */
+    payment_status?: OrderPaymentStatus;
     /** 商品总数量。来源：Order.product_quantity */
     product_quantity?: number;
     /** 商品原价总额。来源：Order.product_original_amount */
@@ -316,6 +343,16 @@ export interface OrderSummary {
     rounding_amount?: OrderMoneyString;
     /** 支付手续费。来源：Order.pay_service_charge_amount */
     pay_service_charge_amount?: OrderMoneyString;
+    /** 已应用到订单的支付金额。来源：Order.order_paid_amount */
+    order_paid_amount?: OrderMoneyString;
+    /** 顾客实际支付金额。来源：Order.customer_paid_amount */
+    customer_paid_amount?: OrderMoneyString;
+    /** 已退款总金额。来源：Order.total_refund_amount */
+    total_refund_amount?: OrderMoneyString;
+    /** 税种名称。来源：Order.tax_title */
+    tax_title?: string;
+    /** 是否含税 0/1。来源：Order.is_price_include_tax */
+    is_price_include_tax?: 0 | 1;
 }
 /**
  * 订单数据结构（Server 侧对齐《统一 Sales 数据协议》）
@@ -395,6 +432,8 @@ export interface OrderData {
     bookings?: OrderBookingItem[];
     /** 支付数组 */
     payments?: OrderPaymentItem[];
+    /** 真实退款记录数组 */
+    refunds?: OrderRefundItem[];
     /** 附加费数组 */
     surcharges?: OrderSurchargeItem[];
     /** 整单/订单级折扣列表（结构与 3.3.1 商品折扣项一致时可复用） */
@@ -407,6 +446,17 @@ export interface OrderData {
     contacts_info?: unknown[];
     /** 订单级主体参数 */
     holder?: Record<string, unknown> | null;
+    /** 订单前端扩展快照 */
+    order_meta_list?: {
+        point_cards_snapshot?: Array<{
+            id: number | string;
+            tag: 'point_card';
+            product_id?: number | string;
+            product_name: string;
+            par_value: string;
+            used_par_value: string;
+        }>;
+    };
     /**
      * 金额汇总（仅输出）。
      * 由服务端 OrderV2Service::computeOrderSummaryData() 生成；离线可按同算法本地计算。

package/dist/server/modules/order/types.js

@@ -78,6 +78,8 @@
  * 支付记录（3.5 payments）
  */
 
+/** 订单退款记录（仅使用真实退款记录构造退款历史） */
+
 // ─────────────────────────────────────────────────────────────────
 // 3.6 surcharges
 // ─────────────────────────────────────────────────────────────────

package/dist/server/modules/products/index.d.ts

@@ -25,6 +25,7 @@ export declare class ProductsModule extends BaseModule implements Module {
     private quotationBridgeLoadedKey?;
     private quotationBridgeRefreshPromise?;
     private quotationBridgeRefreshKey?;
+    private quotationBridgeUpdatedCallback?;
     private quotationScheduleCache;
     private quotationScheduleCacheSource;
     private quotationScheduleCacheLoaded;
@@ -72,6 +73,7 @@ export declare class ProductsModule extends BaseModule implements Module {
         scheduleModule?: any;
         channel?: string;
         customer_id?: number | string;
+        onQuotationUpdated?: () => void;
     }): Promise<void>;
     /**
      * 刷新桥接器内的报价单列表。
@@ -87,8 +89,8 @@ export declare class ProductsModule extends BaseModule implements Module {
     private buildBundleGroupPriceData;
     /**
      * 获取应用了价格的商品列表（带缓存）
-     * 使用日期作为缓存 key，同一天的商品价格会被缓存
-     * 缓存的是已经应用了价格的完整商品列表，避免重复转换
+     * 使用时间、客户、策略、商品范围和语言作为缓存 key
+     * 缓存的是已经应用了价格与多语言的完整商品列表，避免重复转换
      * @param schedule_date 日期
      * @param extraContext 额外的上下文数据（可选，由 Server 层传入）
      * @param options 可选参数
@@ -181,7 +183,9 @@ export declare class ProductsModule extends BaseModule implements Module {
     /**
      * 通过 ProductDataSource SSE 加载完整商品列表
      */
-    loadProductsByServer(): Promise<any>;
+    loadProductsByServer(options?: {
+        trigger?: string;
+    }): Promise<any>;
     /**
      * 纯请求方法：通过 HTTP 接口获取商品列表（无副作用，不触发事件、不写 IndexDB）
      * @param params 查询参数
@@ -331,7 +335,9 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 拿到完整数据后一次性替换 store，清除价格缓存，触发 onProductsSyncCompleted
      * @returns 刷新后的商品列表
      */
-    silentRefresh(): Promise<ProductData[]>;
+    silentRefresh(options?: {
+        trigger?: string;
+    }): Promise<ProductData[]>;
     /**
      * 销毁同步资源（取消 pubsub 订阅、清除定时器）
      */