@pisell/pisellos 0.10.7 → 0.10.9

package/lib/modules/Order/types.d.ts

@@ -1,7 +1,7 @@
 import { CartItem } from '../Cart/types';
 import type { DiscountModule } from '../Discount';
 import type { RulesModule } from '../Rules';
-import type { Discount } from '../Discount/types';
+import type { Discount, VirtualCurrencyAsset } from '../Discount/types';
 import type { UnavailableReason } from '../Rules/types';
 import type { SubmitPayloadEnhancer } from './utils';
 import type { PaymentItem } from '../Payment/types';
@@ -194,6 +194,7 @@ export interface OrderProduct extends OrderProductIdentity {
     gift_card?: number;
     selling_price: string;
     original_price: string;
+    payment_price?: string;
     tax_fee: string;
     is_charge_tax: number;
     discount_list: OrderProductDiscountItem[];
@@ -275,6 +276,7 @@ export interface OrderTempOrder {
     products: OrderProduct[];
     bookings: any[];
     payments: any[];
+    refunds?: any[];
     surcharges: any[];
     discount_list?: any[];
     relation_forms: any[];
@@ -312,6 +314,7 @@ export interface OrderState {
     syncState?: OrderSyncState;
     discountList: any[];
     availableWalletIds?: number[];
+    virtualCurrencyList?: VirtualCurrencyAsset[];
     discount: DiscountModule | null;
     rules: RulesModule | null;
 }
@@ -321,6 +324,24 @@ export interface ReplaceTempOrderOptions {
     saveDraft?: boolean;
 }
 export type AddProductBookingInput = Record<string, any>;
+/**
+ * 添加商品行时的顺序控制。
+ * 默认追加到 products 尾部；预约数量同步可插入到既有预约组的最新行之后，
+ * 避免步进器修改数量改变该组展示位置。
+ */
+export interface AddProductToOrderOptions {
+    insertAfterProductUid?: string;
+}
+/**
+ * 删除商品后的可选位置保持策略。
+ * 预约合并行减量时仍删除最新真实行，再把剩余代表行移动到被删除代表行原位置。
+ */
+export interface RemoveProductsFromOrderOptions {
+    preserveDisplayPosition?: {
+        remainingProductUid: string;
+        anchorProductUid: string;
+    };
+}
 /** 更新购物车行：仅传 SKU 时命中同 SKU 第一行；多行同 SKU 须传 unique_identification_number / 选项指纹等 */
 export interface UpdateOrderProductParams {
     product_id: number | null;
@@ -691,6 +712,8 @@ export interface OrderModuleAPI {
     addNewOrder: () => Promise<OrderTempOrder>;
     restoreOrder: () => OrderTempOrder;
     getOrderProducts: () => OrderProduct[];
+    getVirtualCurrencyList: () => VirtualCurrencyAsset[];
+    clearOrderForSettlementSwitch: () => Promise<OrderTempOrder>;
     getOrderSummary: () => Promise<OrderSummary>;
     recalculateSummary: (options?: {
         createIfMissing?: boolean;
@@ -726,17 +749,22 @@ export interface OrderModuleAPI {
     updateTempOrderCustomer: (customer: UpdateTempOrderCustomerInput) => OrderSnapshot['customer'];
     updateTempOrderBuzzer: (buzzer: string) => string;
     updateTempOrderContactsInfo: (contactsInfo: Record<string, any> | null) => Record<string, any> | null;
-    addProductToOrder: (product: Partial<OrderProduct> & OrderProductIdentity, booking?: AddProductBookingInput) => Promise<OrderProduct[]>;
+    addProductToOrder: (product: Partial<OrderProduct> & OrderProductIdentity, booking?: AddProductBookingInput, options?: AddProductToOrderOptions) => Promise<OrderProduct[]>;
     updateOrderProduct: (params: UpdateOrderProductParams) => Promise<OrderProduct[]>;
     /** 批量更新购物车行，末尾仅触发一次促销重算与 summary 刷新 */
     updateOrderProducts: (paramsList: UpdateOrderProductParams[]) => Promise<OrderProduct[]>;
     updateOrderProductQuantity: (params: UpdateOrderProductQuantityParams) => Promise<OrderProduct[]>;
     updateOrderBooking: (params: UpdateOrderBookingParams) => any[];
-    removeProductFromOrder: (identity: OrderProductIdentity) => Promise<OrderProduct[]>;
+    removeProductFromOrder: (identity: OrderProductIdentity, options?: RemoveProductsFromOrderOptions) => Promise<OrderProduct[]>;
     /** 批量删除购物车行，末尾仅触发一次促销重算与 summary 刷新 */
-    removeProductsFromOrder: (identities: OrderProductIdentity[]) => Promise<OrderProduct[]>;
+    removeProductsFromOrder: (identities: OrderProductIdentity[], options?: RemoveProductsFromOrderOptions) => Promise<OrderProduct[]>;
     /** 在显式开启时保存当前 tempOrder 的 sessionStorage 会话快照。 */
     persistTempOrder: () => void;
+    /**
+     * 删除当前 cacheId 的 tempOrder 会话快照，并阻止当前模块实例再次写入。
+     * 新模块实例初始化时会按 otherParams 重新启用持久化。
+     */
+    clearSessionStoragePersistedTempOrder: () => void;
     /** 取出一次待恢复的 sessionStorage tempOrder 快照。 */
     consumeSessionStorageRestore: () => Record<string, any> | null;
     /**

package/lib/modules/Order/utils/discountProductLineIdentity.d.ts

@@ -0,0 +1,45 @@
+import type { OrderTempOrder } from '../types';
+/**
+ * 商品券拆行的身份与回并工具。
+ *
+ * 背景：
+ * Rules.calcDiscount 应用 good_pass 时，会把一个数量行拆成若干「用券行」和
+ * 「普通余量行」。Rules 返回的拆分行可能复制同一份
+ * metadata.unique_identification_number，进而造成：
+ * - 按 UID 删除时同时命中多行；
+ * - UI 把不同券行视为同一个商品；
+ * - 后续商品更新无法准确定位目标行。
+ *
+ * 处理原则：
+ * 1. 拆分后每一行必须拥有独立 UID；
+ * 2. 原始拆分来源仅记录在 tempOrder._extend.productsByUid 的运行态索引中，
+ *    不写入商品 metadata，不污染提交协议；
+ * 3. 券被移除后，只回并被本工具确认来自同一折扣拆分源的行；
+ * 4. 预约、赠品、促销、手动折扣、备注、称重、holder 和已落库行均为硬边界。
+ *
+ * 两个导出函数都会原地更新 tempOrder。调用顺序必须是：
+ * ensureUniqueProductLineUids -> consolidateDiscountFreeProductLines。
+ */
+/** productsByUid 运行态记录中用于关联同一次折扣拆分的字段。 */
+export declare const DISCOUNT_SPLIT_ORIGIN_UID_KEY = "discountSplitOriginUid";
+/**
+ * 修复 Rules 折扣拆行复制 UID 的问题，并为拆分行记录共同来源。
+ *
+ * 第一条商品保留原 UID，后续重复行生成新 UUID；对应的 productsByUid.runtime
+ * 会复制原行 runtime（包括 origin），以保证删除、编辑及展示字段回读仍可工作。
+ *
+ * 没有 UID 的裸商品不会被补写 UID。这是为了兼容 Rules/mock 的历史协议形状；
+ * 正常 Order 写路径会在 normalize 阶段提前创建 UID。
+ */
+export declare function ensureUniqueProductLineUids(tempOrder: OrderTempOrder): void;
+/**
+ * 把券移除后已经恢复原价的同源折扣拆分行重新合并。
+ *
+ * 此函数刻意不执行通用的「同 SKU 合并」：没有 discountSplitOriginUid 的普通行
+ * 可能是业务 hook、导入订单或其它流程主动拆开的，不能在折扣重算时擅自合并。
+ *
+ * payment_price、tax_fee、surcharge_fee 属于 summary 计算层的派生值。券行与普通行
+ * 在回并前可能暂时不同，因此它们不参与 mergeKey；原始价格、SKU/option/bundle
+ * 结构以及税务/商品类型配置仍参与比较，防止不同商品语义被误合并。
+ */
+export declare function consolidateDiscountFreeProductLines(tempOrder: OrderTempOrder): void;

package/lib/modules/Order/utils/discountProductLineIdentity.js

@@ -0,0 +1,170 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Order/utils/discountProductLineIdentity.ts
+var discountProductLineIdentity_exports = {};
+__export(discountProductLineIdentity_exports, {
+  DISCOUNT_SPLIT_ORIGIN_UID_KEY: () => DISCOUNT_SPLIT_ORIGIN_UID_KEY,
+  consolidateDiscountFreeProductLines: () => consolidateDiscountFreeProductLines,
+  ensureUniqueProductLineUids: () => ensureUniqueProductLineUids
+});
+module.exports = __toCommonJS(discountProductLineIdentity_exports);
+var import_lodash_es = require("lodash-es");
+var import_utils = require("../../../solution/ScanOrder/utils");
+var import_orderCollectionIdentity = require("./orderCollectionIdentity");
+var DISCOUNT_SPLIT_ORIGIN_UID_KEY = "discountSplitOriginUid";
+function getProductLineUid(product) {
+  var _a;
+  if (!product || typeof product !== "object")
+    return null;
+  const uid = ((_a = product.metadata) == null ? void 0 : _a.unique_identification_number) ?? product.unique_identification_number;
+  if (uid === void 0 || uid === null || uid === "")
+    return null;
+  return String(uid);
+}
+function getProductSkuOptions(product) {
+  var _a;
+  return Array.isArray((_a = product.product_sku) == null ? void 0 : _a.option) ? product.product_sku.option : [];
+}
+function hasProductLineNote(product) {
+  return typeof product.note === "string" && product.note.trim().length > 0;
+}
+function isManualProductDiscountLine(product) {
+  var _a, _b;
+  return ((_a = product.metadata) == null ? void 0 : _a.is_manual_discount) === true || ((_b = product.metadata) == null ? void 0 : _b.is_manual_discount) === 1 || (product.discount_list || []).some((item) => (item == null ? void 0 : item.type) === "product");
+}
+function ensureProductsByUid(tempOrder) {
+  if (!tempOrder._extend || typeof tempOrder._extend !== "object") {
+    tempOrder._extend = { productsByUid: {} };
+  }
+  if (!tempOrder._extend.productsByUid) {
+    tempOrder._extend.productsByUid = {};
+  }
+  return tempOrder._extend.productsByUid;
+}
+function ensureUniqueProductLineUids(tempOrder) {
+  const usedUids = /* @__PURE__ */ new Set();
+  const productsByUid = ensureProductsByUid(tempOrder);
+  tempOrder.products = (tempOrder.products || []).map((product) => {
+    const sourceUid = getProductLineUid(product);
+    if (!sourceUid)
+      return product;
+    if (!usedUids.has(sourceUid)) {
+      usedUids.add(sourceUid);
+      return product;
+    }
+    let splitUid = (0, import_orderCollectionIdentity.createUuidV4)();
+    while (usedUids.has(splitUid)) {
+      splitUid = (0, import_orderCollectionIdentity.createUuidV4)();
+    }
+    product.metadata = {
+      ...product.metadata || {},
+      unique_identification_number: splitUid
+    };
+    const sourceRuntime = productsByUid[sourceUid] || {};
+    const discountSplitOriginUid = String(
+      sourceRuntime[DISCOUNT_SPLIT_ORIGIN_UID_KEY] || sourceUid
+    );
+    productsByUid[sourceUid] = {
+      ...sourceRuntime,
+      [DISCOUNT_SPLIT_ORIGIN_UID_KEY]: discountSplitOriginUid
+    };
+    productsByUid[splitUid] = {
+      ...(0, import_lodash_es.cloneDeep)(sourceRuntime),
+      [DISCOUNT_SPLIT_ORIGIN_UID_KEY]: discountSplitOriginUid
+    };
+    usedUids.add(splitUid);
+    return product;
+  });
+}
+function consolidateDiscountFreeProductLines(tempOrder) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
+  const consolidatedProducts = [];
+  const productIndexByKey = /* @__PURE__ */ new Map();
+  for (const product of tempOrder.products || []) {
+    const productBundle = Array.isArray(product.product_bundle) ? product.product_bundle : [];
+    const hasDiscount = (product.discount_list || []).length > 0 || productBundle.some((bundle) => ((bundle == null ? void 0 : bundle.discount_list) || []).length > 0);
+    const bookingUid = product.booking_uid ?? ((_a = product.metadata) == null ? void 0 : _a.booking_uid);
+    const bookingId = product.booking_id ?? ((_b = product.metadata) == null ? void 0 : _b.booking_id);
+    const orderDetailId = product.order_detail_id ?? product.orderDetailId;
+    const holderId = product.holder_id ?? ((_c = product.metadata) == null ? void 0 : _c.holder_id);
+    const hasMergeBoundary = hasDiscount || Boolean(((_d = product.metadata) == null ? void 0 : _d._giftInfo) || product._giftInfo) || Boolean((_e = product.metadata) == null ? void 0 : _e._promotion) || isManualProductDiscountLine(product) || hasProductLineNote(product) || Number(((_f = product.product_sku) == null ? void 0 : _f.open_sold_weight) || 0) === 1 || ((_g = product.metadata) == null ? void 0 : _g.is_edit_for_runtime) === true || bookingId !== void 0 && bookingId !== null && bookingId !== 0 && bookingId !== "0" || bookingUid !== void 0 && bookingUid !== null && String(bookingUid) !== "" || holderId !== void 0 && holderId !== null && String(holderId) !== "" || orderDetailId !== void 0 && orderDetailId !== null && orderDetailId !== "";
+    if (hasMergeBoundary) {
+      consolidatedProducts.push(product);
+      continue;
+    }
+    const productUid = getProductLineUid(product);
+    const discountSplitOriginUid = productUid ? (_j = (_i = (_h = tempOrder._extend) == null ? void 0 : _h.productsByUid) == null ? void 0 : _i[productUid]) == null ? void 0 : _j[DISCOUNT_SPLIT_ORIGIN_UID_KEY] : void 0;
+    if (!discountSplitOriginUid) {
+      consolidatedProducts.push(product);
+      continue;
+    }
+    const fingerprint = (0, import_utils.buildProductLineFingerprint)(
+      getProductSkuOptions(product),
+      productBundle
+    );
+    const priceSignature = JSON.stringify({
+      selling_price: String(product.selling_price ?? ""),
+      original_price: String(product.original_price ?? ""),
+      custom_price: String(product.custom_price ?? ""),
+      is_charge_tax: Number(product.is_charge_tax ?? 0),
+      gift_card: Number(product.gift_card ?? 0),
+      bundle_edit: Number(product.bundle_edit ?? 0),
+      price_schema_version: ((_k = product.metadata) == null ? void 0 : _k.price_schema_version) ?? "",
+      source_product_price: String(((_l = product.metadata) == null ? void 0 : _l.source_product_price) ?? ""),
+      main_product_selling_price: String(
+        ((_m = product.metadata) == null ? void 0 : _m.main_product_selling_price) ?? ""
+      ),
+      main_product_original_price: String(
+        ((_n = product.metadata) == null ? void 0 : _n.main_product_original_price) ?? ""
+      ),
+      bundle: productBundle.map((bundle) => ({
+        bundle_id: (bundle == null ? void 0 : bundle.bundle_id) ?? (bundle == null ? void 0 : bundle.id) ?? "",
+        product_id: (bundle == null ? void 0 : bundle.bundle_product_id) ?? (bundle == null ? void 0 : bundle._bundle_product_id) ?? (bundle == null ? void 0 : bundle.product_id) ?? "",
+        product_variant_id: (bundle == null ? void 0 : bundle.bundle_variant_id) ?? (bundle == null ? void 0 : bundle.variant_id) ?? (bundle == null ? void 0 : bundle.product_variant_id) ?? 0,
+        price: String((bundle == null ? void 0 : bundle.price) ?? ""),
+        original_price: String((bundle == null ? void 0 : bundle.original_price) ?? ""),
+        bundle_selling_price: String((bundle == null ? void 0 : bundle.bundle_selling_price) ?? "")
+      }))
+    });
+    const mergeKey = [
+      discountSplitOriginUid,
+      product.product_id,
+      product.product_variant_id ?? 0,
+      fingerprint,
+      priceSignature
+    ].join("#");
+    const matchedIndex = productIndexByKey.get(mergeKey);
+    if (matchedIndex === void 0) {
+      productIndexByKey.set(mergeKey, consolidatedProducts.length);
+      consolidatedProducts.push(product);
+      continue;
+    }
+    const matchedProduct = consolidatedProducts[matchedIndex];
+    matchedProduct.num = (0, import_utils.getSafeProductNum)(
+      Number(matchedProduct.num || 0) + Number(product.num || 0)
+    );
+  }
+  tempOrder.products = consolidatedProducts;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DISCOUNT_SPLIT_ORIGIN_UID_KEY,
+  consolidateDiscountFreeProductLines,
+  ensureUniqueProductLineUids
+});

package/lib/modules/Order/utils/virtualSettlement.d.ts

@@ -0,0 +1,56 @@
+import type { OrderProduct, OrderTempOrder } from '../types';
+export interface SelectedSettlementSnapshot extends Record<string, any> {
+    settlement_type: 'legal_currency' | 'virtual_currency';
+    currency_product_id?: number;
+    price: string | number;
+    unit_label?: any;
+    symbol?: any;
+    amount_format?: string;
+}
+export interface LegalCurrencySnapshot {
+    currency_code: string;
+    currency_symbol: string;
+    currency_format: string;
+}
+export declare function resolveSettlementDisplayValue(value: unknown): string;
+export declare class OrderSettlementConflictError extends Error {
+    readonly currentSettlementKey: string;
+    readonly incomingSettlementKey: string;
+    readonly code = "ORDER_SETTLEMENT_CONFLICT";
+    constructor(currentSettlementKey: string, incomingSettlementKey: string);
+}
+export declare class VirtualCurrencyAssetNotFoundError extends Error {
+    readonly currencyProductId: number;
+    readonly code = "VIRTUAL_CURRENCY_ASSET_NOT_FOUND";
+    constructor(currencyProductId: number);
+}
+export declare class VirtualCurrencyBalanceError extends Error {
+    readonly balance: string;
+    readonly requiredAmount: string;
+    readonly code = "VIRTUAL_CURRENCY_BALANCE_INSUFFICIENT";
+    constructor(balance: string, requiredAmount: string);
+}
+export declare function getSelectedSettlementSnapshot(product: Partial<OrderProduct> | null | undefined): SelectedSettlementSnapshot | null;
+export declare function getTempOrderSettlementSnapshot(tempOrder: OrderTempOrder | null | undefined): SelectedSettlementSnapshot | null;
+export declare function isVirtualSettlementProduct(product: Partial<OrderProduct> | null | undefined): boolean;
+export declare function getSettlementKey(snapshot: SelectedSettlementSnapshot | null | undefined): string | null;
+export declare function getTempOrderSettlementKey(tempOrder: OrderTempOrder | null | undefined): string | null;
+export declare function isVirtualSettlementOrder(tempOrder: OrderTempOrder | null | undefined): boolean;
+/**
+ * 详情展示识别同时支持已提交订单的 currency_settlement_config。
+ * cart_settlement_* 是交易过程内部状态，服务端详情不保证返回。
+ */
+export declare function isVirtualSettlementDisplayOrder(tempOrder: OrderTempOrder | null | undefined): boolean;
+/**
+ * 将购物车锁定的结算单位提升为订单级状态。
+ * 商品行快照只负责价格归一化；展示与提交统一读取 tempOrder.currency_*。
+ */
+export declare function applyTempOrderSettlementState(tempOrder: OrderTempOrder, snapshot: SelectedSettlementSnapshot): void;
+/** 清空购物车结算锁，并恢复进入虚拟币结算前的店铺法币。 */
+export declare function releaseTempOrderSettlementState(tempOrder: OrderTempOrder): void;
+/**
+ * 将已选择虚拟币的订单商品行固化为最终价语义。
+ * 函数幂等，可安全用于加车、合并、hydrate 和提交前兜底。
+ */
+export declare function normalizeVirtualSettlementOrderProduct<T extends Partial<OrderProduct>>(product: T): T;
+export declare function normalizeVirtualSettlementProducts<T extends Partial<OrderProduct>>(products: T[]): T[];

package/lib/modules/Order/utils/virtualSettlement.js

@@ -0,0 +1,300 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Order/utils/virtualSettlement.ts
+var virtualSettlement_exports = {};
+__export(virtualSettlement_exports, {
+  OrderSettlementConflictError: () => OrderSettlementConflictError,
+  VirtualCurrencyAssetNotFoundError: () => VirtualCurrencyAssetNotFoundError,
+  VirtualCurrencyBalanceError: () => VirtualCurrencyBalanceError,
+  applyTempOrderSettlementState: () => applyTempOrderSettlementState,
+  getSelectedSettlementSnapshot: () => getSelectedSettlementSnapshot,
+  getSettlementKey: () => getSettlementKey,
+  getTempOrderSettlementKey: () => getTempOrderSettlementKey,
+  getTempOrderSettlementSnapshot: () => getTempOrderSettlementSnapshot,
+  isVirtualSettlementDisplayOrder: () => isVirtualSettlementDisplayOrder,
+  isVirtualSettlementOrder: () => isVirtualSettlementOrder,
+  isVirtualSettlementProduct: () => isVirtualSettlementProduct,
+  normalizeVirtualSettlementOrderProduct: () => normalizeVirtualSettlementOrderProduct,
+  normalizeVirtualSettlementProducts: () => normalizeVirtualSettlementProducts,
+  releaseTempOrderSettlementState: () => releaseTempOrderSettlementState,
+  resolveSettlementDisplayValue: () => resolveSettlementDisplayValue
+});
+module.exports = __toCommonJS(virtualSettlement_exports);
+var import_decimal = __toESM(require("decimal.js"));
+function resolveSettlementDisplayValue(value) {
+  if (value === void 0 || value === null)
+    return "";
+  if (typeof value === "string" || typeof value === "number") {
+    return String(value);
+  }
+  const localized = value;
+  return String(
+    localized.auto ?? localized.default ?? localized.original ?? localized.en ?? localized["zh-CN"] ?? localized["zh-HK"] ?? ""
+  );
+}
+var OrderSettlementConflictError = class extends Error {
+  constructor(currentSettlementKey, incomingSettlementKey) {
+    super("Different currencies and WalletPass units cannot be mixed in one cart.");
+    this.currentSettlementKey = currentSettlementKey;
+    this.incomingSettlementKey = incomingSettlementKey;
+    this.code = "ORDER_SETTLEMENT_CONFLICT";
+    this.name = "OrderSettlementConflictError";
+  }
+};
+var VirtualCurrencyAssetNotFoundError = class extends Error {
+  constructor(currencyProductId) {
+    super("No matching virtual currency card is available.");
+    this.currencyProductId = currencyProductId;
+    this.code = "VIRTUAL_CURRENCY_ASSET_NOT_FOUND";
+    this.name = "VirtualCurrencyAssetNotFoundError";
+  }
+};
+var VirtualCurrencyBalanceError = class extends Error {
+  constructor(balance, requiredAmount) {
+    super("Insufficient virtual currency balance.");
+    this.balance = balance;
+    this.requiredAmount = requiredAmount;
+    this.code = "VIRTUAL_CURRENCY_BALANCE_INSUFFICIENT";
+    this.name = "VirtualCurrencyBalanceError";
+  }
+};
+function getSelectedSettlementSnapshot(product) {
+  var _a;
+  const snapshot = (_a = product == null ? void 0 : product.metadata) == null ? void 0 : _a.selected_settlement_snapshot;
+  if (!snapshot || typeof snapshot !== "object")
+    return null;
+  if (snapshot.settlement_type !== "legal_currency" && snapshot.settlement_type !== "virtual_currency") {
+    return null;
+  }
+  return snapshot;
+}
+function getTempOrderSettlementSnapshot(tempOrder) {
+  var _a, _b;
+  const snapshot = (_a = tempOrder == null ? void 0 : tempOrder.metadata) == null ? void 0 : _a.cart_settlement_snapshot;
+  if (snapshot && typeof snapshot === "object" && (snapshot.settlement_type === "legal_currency" || snapshot.settlement_type === "virtual_currency")) {
+    return snapshot;
+  }
+  return getSelectedSettlementSnapshot((_b = tempOrder == null ? void 0 : tempOrder.products) == null ? void 0 : _b[0]);
+}
+function isVirtualSettlementProduct(product) {
+  var _a;
+  return ((_a = getSelectedSettlementSnapshot(product)) == null ? void 0 : _a.settlement_type) === "virtual_currency";
+}
+function getSettlementKey(snapshot) {
+  if (!snapshot)
+    return null;
+  if (snapshot.settlement_type === "legal_currency")
+    return "legal_currency";
+  const currencyProductId = Number(snapshot.currency_product_id);
+  return Number.isFinite(currencyProductId) && currencyProductId > 0 ? `virtual_currency:${currencyProductId}` : null;
+}
+function getTempOrderSettlementKey(tempOrder) {
+  var _a, _b;
+  if (!((_a = tempOrder == null ? void 0 : tempOrder.products) == null ? void 0 : _a.length))
+    return null;
+  const storedKey = (_b = tempOrder.metadata) == null ? void 0 : _b.cart_settlement_key;
+  if (typeof storedKey === "string" && storedKey)
+    return storedKey;
+  return getSettlementKey(getTempOrderSettlementSnapshot(tempOrder)) || "legal_currency";
+}
+function isVirtualSettlementOrder(tempOrder) {
+  var _a;
+  return ((_a = getTempOrderSettlementKey(tempOrder)) == null ? void 0 : _a.startsWith("virtual_currency:")) === true;
+}
+function isVirtualSettlementDisplayOrder(tempOrder) {
+  var _a, _b;
+  return ((_b = (_a = tempOrder == null ? void 0 : tempOrder.metadata) == null ? void 0 : _a.currency_settlement_config) == null ? void 0 : _b.settlement_type) === "virtual_currency" || isVirtualSettlementOrder(tempOrder);
+}
+function getLegalCurrencySnapshot(tempOrder) {
+  var _a;
+  const snapshot = (_a = tempOrder.metadata) == null ? void 0 : _a.legal_currency_snapshot;
+  if (!snapshot || typeof snapshot !== "object")
+    return null;
+  return {
+    currency_code: String(snapshot.currency_code || ""),
+    currency_symbol: String(snapshot.currency_symbol || ""),
+    currency_format: String(snapshot.currency_format || "symbol_first")
+  };
+}
+function captureLegalCurrencySnapshot(tempOrder) {
+  tempOrder.metadata = tempOrder.metadata || {};
+  if (getLegalCurrencySnapshot(tempOrder))
+    return;
+  tempOrder.metadata.legal_currency_snapshot = {
+    currency_code: String(tempOrder.currency_code || ""),
+    currency_symbol: String(tempOrder.currency_symbol || ""),
+    currency_format: String(tempOrder.currency_format || "symbol_first")
+  };
+}
+function applyTempOrderSettlementState(tempOrder, snapshot) {
+  tempOrder.metadata = tempOrder.metadata || {};
+  const settlementKey = getSettlementKey(snapshot) || "legal_currency";
+  if (snapshot.settlement_type === "virtual_currency") {
+    captureLegalCurrencySnapshot(tempOrder);
+    const currencyProductId = Number(snapshot.currency_product_id);
+    tempOrder.metadata.currency_settlement_config = {
+      settlement_type: "virtual_currency",
+      settlement_ids: Number.isFinite(currencyProductId) && currencyProductId > 0 ? [currencyProductId] : []
+    };
+  } else {
+    delete tempOrder.metadata.currency_settlement_config;
+  }
+  tempOrder.metadata.cart_settlement_key = settlementKey;
+  tempOrder.metadata.cart_settlement_snapshot = { ...snapshot };
+  tempOrder.currency_code = resolveSettlementDisplayValue(snapshot.unit_label) || tempOrder.currency_code;
+  tempOrder.currency_symbol = resolveSettlementDisplayValue(snapshot.symbol) || tempOrder.currency_symbol;
+  tempOrder.currency_format = String(
+    snapshot.amount_format || tempOrder.currency_format || "symbol_first"
+  );
+}
+function releaseTempOrderSettlementState(tempOrder) {
+  tempOrder.metadata = tempOrder.metadata || {};
+  const legalCurrency = getLegalCurrencySnapshot(tempOrder);
+  if (legalCurrency) {
+    tempOrder.currency_code = legalCurrency.currency_code;
+    tempOrder.currency_symbol = legalCurrency.currency_symbol;
+    tempOrder.currency_format = legalCurrency.currency_format;
+  }
+  delete tempOrder.metadata.cart_settlement_key;
+  delete tempOrder.metadata.cart_settlement_snapshot;
+  delete tempOrder.metadata.currency_settlement_config;
+}
+function toMoney(value) {
+  try {
+    return new import_decimal.default(String(value ?? 0)).toDecimalPlaces(2).toFixed(2);
+  } catch {
+    return "0.00";
+  }
+}
+function zeroOptions(options) {
+  if (!Array.isArray(options))
+    return [];
+  return options.map((option) => ({
+    ...option,
+    add_price: 0
+  }));
+}
+function zeroBundles(bundles) {
+  if (!Array.isArray(bundles))
+    return [];
+  return bundles.map((bundle) => ({
+    ...bundle,
+    price: 0,
+    custom_price: 0,
+    bundle_selling_price: 0,
+    bundle_payment_price: 0,
+    surcharge_fee: 0,
+    tax_fee: 0,
+    original_tax_fee: 0,
+    is_charge_tax: 0,
+    discount_list: [],
+    relation_surcharge_ids: [],
+    option: zeroOptions(bundle == null ? void 0 : bundle.option),
+    metadata: {
+      ...(bundle == null ? void 0 : bundle.metadata) || {},
+      surcharge_fee: "0.00",
+      relation_surcharge_ids: [],
+      product_discount_difference: "",
+      tax_fee_rounding_remainder: "0.00",
+      surcharge_rounding_remainder: "0.00"
+    }
+  }));
+}
+function normalizeVirtualSettlementOrderProduct(product) {
+  var _a;
+  const snapshot = getSelectedSettlementSnapshot(product);
+  if ((snapshot == null ? void 0 : snapshot.settlement_type) !== "virtual_currency")
+    return product;
+  const virtualPrice = toMoney(snapshot.price);
+  const metadata = {
+    ...product.metadata || {},
+    source_product_price: virtualPrice,
+    main_product_original_price: virtualPrice,
+    main_product_selling_price: virtualPrice,
+    main_product_attached_bundle_selling_price: virtualPrice,
+    main_product_attached_bundle_payment_price: virtualPrice,
+    main_product_attached_bundle_surcharge_fee: "0.00",
+    main_product_attached_bundle_tax_fee: "0.00",
+    surcharge_rounding_remainder: "0.00",
+    tax_fee_rounding_remainder: "0.00",
+    relation_surcharge_ids: [],
+    average_discount_amount_rate: "1",
+    product_discount_difference: "",
+    discountable_flag: 0,
+    price_schema_version: 2,
+    selected_settlement_snapshot: {
+      ...snapshot,
+      price: virtualPrice
+    }
+  };
+  return {
+    ...product,
+    selling_price: virtualPrice,
+    original_price: virtualPrice,
+    payment_price: virtualPrice,
+    discount_list: [],
+    is_charge_tax: 0,
+    tax_fee: "0.00",
+    original_tax_fee: 0,
+    tax_fee_rounding_remainder: 0,
+    original_tax_fee_rounding_remainder: 0,
+    surcharge_fee: "0.00",
+    surcharge_rounding_remainder: 0,
+    relation_surcharge_ids: [],
+    product_sku: {
+      ...product.product_sku || {},
+      option: zeroOptions((_a = product.product_sku) == null ? void 0 : _a.option)
+    },
+    product_bundle: zeroBundles(product.product_bundle),
+    metadata
+  };
+}
+function normalizeVirtualSettlementProducts(products) {
+  return (products || []).map(
+    (product) => normalizeVirtualSettlementOrderProduct(product)
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  OrderSettlementConflictError,
+  VirtualCurrencyAssetNotFoundError,
+  VirtualCurrencyBalanceError,
+  applyTempOrderSettlementState,
+  getSelectedSettlementSnapshot,
+  getSettlementKey,
+  getTempOrderSettlementKey,
+  getTempOrderSettlementSnapshot,
+  isVirtualSettlementDisplayOrder,
+  isVirtualSettlementOrder,
+  isVirtualSettlementProduct,
+  normalizeVirtualSettlementOrderProduct,
+  normalizeVirtualSettlementProducts,
+  releaseTempOrderSettlementState,
+  resolveSettlementDisplayValue
+});