@etsoo/appscript 1.5.63 → 1.5.65

package/src/business/ShoppingCart.ts

@@ -1,19 +1,19 @@
 import {
-    DataTypes,
-    IStorage,
-    IdType,
-    NumberUtils,
-    WindowStorage
-} from '@etsoo/shared';
-import { Currency } from './Currency';
+  DataTypes,
+  IStorage,
+  IdType,
+  NumberUtils,
+  WindowStorage
+} from "@etsoo/shared";
+import { Currency } from "./Currency";
 
 /**
  * Shopping cart owner
  * 购物篮所有人
  */
 export type ShoppingCartOwner = DataTypes.IdNameItem & {
-    culture?: string;
-    currency?: Currency;
+  culture?: string;
+  currency?: Currency;
 };
 
 /**
@@ -21,13 +21,13 @@ export type ShoppingCartOwner = DataTypes.IdNameItem & {
  * 购物篮数据
  */
 export type ShoppingCartData<T extends ShoppingCartItem> = {
-    culture: string;
-    currency: Currency;
-    owner: ShoppingCartOwner;
-    items: T[];
-    promotions: ShoppingPromotion[];
-    formData?: any;
-    cache?: Record<string, unknown>;
+  culture: string;
+  currency: Currency;
+  owner: ShoppingCartOwner;
+  items: T[];
+  promotions: ShoppingPromotion[];
+  formData?: any;
+  cache?: Record<string, unknown>;
 };
 
 /**
@@ -35,23 +35,23 @@ export type ShoppingCartData<T extends ShoppingCartItem> = {
  * 购物促销
  */
 export type ShoppingPromotion = {
-    /**
-     * Promotion id
-     * 促销编号
-     */
-    id: number;
-
-    /**
-     * Promotion title
-     * 促销标题
-     */
-    title: string;
-
-    /**
-     * Discount amount
-     * 折扣金额
-     */
-    amount: number;
+  /**
+   * Promotion id
+   * 促销编号
+   */
+  id: number;
+
+  /**
+   * Promotion title
+   * 促销标题
+   */
+  title: string;
+
+  /**
+   * Discount amount
+   * 折扣金额
+   */
+  amount: number;
 };
 
 /**
@@ -59,40 +59,40 @@ export type ShoppingPromotion = {
  * 购物篮基础项目
  */
 export type ShoppingCartItemBase = {
-    /**
-     * Product id
-     * 产品编号
-     */
-    id: IdType;
-
-    /**
-     * Product title, default is name
-     * 产品标题，默认为name
-     */
-    title?: string;
-
-    /**
-     * Sale price
-     * 销售价格
-     */
-    price: number;
-
-    /**
-     * Qty
-     * 数量
-     */
-    qty: number;
-
-    /**
-     * Asset qty
-     */
-    assetQty?: number;
-
-    /**
-     * Product level promotions
-     * 产品层次促销
-     */
-    promotions: ShoppingPromotion[];
+  /**
+   * Product id
+   * 产品编号
+   */
+  id: IdType;
+
+  /**
+   * Product title, default is name
+   * 产品标题，默认为name
+   */
+  title?: string;
+
+  /**
+   * Sale price
+   * 销售价格
+   */
+  price: number;
+
+  /**
+   * Qty
+   * 数量
+   */
+  qty: number;
+
+  /**
+   * Asset qty
+   */
+  assetQty?: number;
+
+  /**
+   * Product level promotions
+   * 产品层次促销
+   */
+  promotions: ShoppingPromotion[];
 };
 
 /**
@@ -100,29 +100,29 @@ export type ShoppingCartItemBase = {
  * 购物篮项目
  */
 export type ShoppingCartItem = ShoppingCartItemBase & {
-    /**
-     * Product name
-     * 产品名称
-     */
-    name: string;
-
-    /**
-     * Current price for cache
-     * 当前缓存价格
-     */
-    currentPrice?: number;
-
-    /**
-     * Subtotal
-     * 小计
-     */
-    subtotal: number;
-
-    /**
-     * Total discount amount
-     * 总折扣金额
-     */
-    discount: number;
+  /**
+   * Product name
+   * 产品名称
+   */
+  name: string;
+
+  /**
+   * Current price for cache
+   * 当前缓存价格
+   */
+  currentPrice?: number;
+
+  /**
+   * Subtotal
+   * 小计
+   */
+  subtotal: number;
+
+  /**
+   * Total discount amount
+   * 总折扣金额
+   */
+  discount: number;
 };
 
 /**
@@ -130,628 +130,618 @@ export type ShoppingCartItem = ShoppingCartItemBase & {
  * 购物篮改变原因
  */
 export type ShoppingCartChangeReason =
-    | 'add'
-    | 'clear'
-    | 'remove'
-    | 'title'
-    | 'update';
+  | "add"
+  | "clear"
+  | "remove"
+  | "title"
+  | "update";
 
-const ShoppingCartKeyField = 'ETSOO-CART-KEYS';
+const ShoppingCartKeyField = "ETSOO-CART-KEYS";
 
 /**
  * Shopping cart
  * 购物篮
  */
 export class ShoppingCart<T extends ShoppingCartItem> {
-    /**
-     * Create identifier key
-     * 创建识别键
-     * @param currency Currency
-     * @param culture Culture
-     * @param key Additional key
-     * @returns Result
-     */
-    static createKey(currency: Currency, culture: string, key: string) {
-        return `ETSOO-CART-${culture}-${key}-${currency}`;
-    }
-
-    /**
-     * Clear shopping cart
-     * 清除购物篮
-     * @param identifier Identifier
-     * @param storage Storage
-     */
-    static clear(identifier: string, storage: IStorage) {
-        try {
-            storage.setData(identifier, null);
-            storage.setPersistedData(identifier, null);
-        } catch (error) {
-            console.warn(`ShoppingCart clear ${identifier} error`, error);
-        }
-    }
-
-    /**
-     * Get cart data
-     * 获取购物篮数据
-     * @param storage Storage
-     * @param id Cart id
-     * @returns Result
-     */
-    static getCartData<D extends ShoppingCartItem>(
-        storage: IStorage,
-        id: string
-    ) {
-        try {
-            return (
-                storage.getPersistedObject<ShoppingCartData<D>>(id) ??
-                storage.getObject<ShoppingCartData<D>>(id)
-            );
-        } catch (error) {
-            console.warn(`ShoppingCart getCartData ${id} error`, error);
-        }
-    }
-
-    /**
-     * Owner data
-     * 所有者信息
-     */
-    owner?: ShoppingCartOwner;
-
-    _currency!: Currency;
-
-    /**
-     * ISO currency id
-     * 标准货币编号
-     */
-    get currency() {
-        return this._currency;
-    }
-    private set currency(value: Currency) {
-        this._currency = value;
-    }
-
-    _culture!: string;
-    /**
-     * ISO culture id, like zh-Hans
-     * 标准语言文化编号
-     */
-    get culture() {
-        return this._culture;
-    }
-    private set culture(value: string) {
-        this._culture = value;
-    }
-
-    _items: T[] = [];
-
-    /**
-     * Items
-     * 项目
-     */
-    get items() {
-        return this._items;
-    }
-    private set items(value) {
-        this._items = value;
-    }
-
-    _promotions: ShoppingPromotion[] = [];
-    /**
-     * Order level promotions
-     * 订单层面促销
-     */
-    get promotions() {
-        return this._promotions;
-    }
-    private set promotions(value) {
-        this._promotions = value;
-    }
-
-    /**
-     * Related form data
-     * 关联的表单数据
-     */
-    formData: any;
-
-    /**
-     * Cache
-     * 缓存对象
-     */
-    cache?: Record<string, unknown>;
-
-    _symbol: string | undefined;
-    /**
-     * Currency symbol
-     * 币种符号
-     */
-    get symbol() {
-        return this._symbol;
-    }
-    private set symbol(value: string | undefined) {
-        this._symbol = value;
-    }
-
-    /**
-     * Key for identifier
-     */
-    readonly key: string;
-
-    /**
-     * Cart identifier
-     * 购物篮标识
-     */
-    get identifier() {
-        const o = this.owner;
-        return ShoppingCart.createKey(this.currency, this.culture, this.key);
-    }
-
-    /**
-     * All data keys
-     * 所有的数据键
-     */
-    get keys() {
-        return this.storage.getPersistedData<string[]>(
-            ShoppingCartKeyField,
-            []
-        );
-    }
-    set keys(items: string[]) {
-        this.storage.setPersistedData(ShoppingCartKeyField, items);
-    }
-
-    /**
-     * Lines count
-     * 项目数量
-     */
-    get lines() {
-        return this.items.length;
-    }
-
-    /**
-     * Total qty
-     * 总数量
-     */
-    get totalQty() {
-        return this.items.map((item) => item.qty).sum();
-    }
-
-    /**
-     * Total amount
-     * 总金额
-     */
-    get totalAmount() {
-        const subtotal = this.items
-            .map((item) => item.subtotal - item.discount)
-            .sum();
-
-        const discount = this.promotions.sum('amount');
-
-        return subtotal - discount;
-    }
-
-    /**
-     * Total amount string
-     * 总金额字符串
-     */
-    get totalAmountStr() {
-        return this.formatAmount(this.totalAmount);
-    }
-
-    /**
-     * Cached prices
-     * 缓存的价格
-     */
-    private prices = <Record<T['id'], number>>{};
-
-    /**
-     * Onchange callback
-     * 改变时回调
-     */
-    onChange?: (reason: ShoppingCartChangeReason, changedItems: T[]) => void;
-
-    /**
-     * Constructor
-     * 构造函数
-     * @param key Key for identifier
-     * @param init Currency & culture ISO code array
-     * @param storage Data storage
-     */
-    constructor(key: string, init: [Currency, string], storage?: IStorage);
-
-    /**
-     * Constructor
-     * 构造函数
-     * @param key Key for identifier
-     * @param state Initialization state
-     * @param storage Data storage
-     */
-    constructor(key: string, state: ShoppingCartData<T>, storage?: IStorage);
-
-    /**
-     * Constructor
-     * 构造函数
-     * @param key Key for identifier
-     * @param currency Currency ISO code
-     * @param storage Data storage
-     */
-    constructor(
-        key: string,
-        currencyOrState: [Currency, string] | ShoppingCartData<T>,
-        private readonly storage: IStorage = new WindowStorage()
-    ) {
-        this.key = key;
-
-        if (Array.isArray(currencyOrState)) {
-            this.reset(currencyOrState[0], currencyOrState[1]);
-        } else {
-            this.setCartData(currencyOrState);
-            this.changeCurrency(currencyOrState.currency);
-            this.changeCulture(currencyOrState.culture);
-        }
-    }
-    private getCartData(): ShoppingCartData<T> | undefined {
-        return (
-            this.storage.getPersistedObject(this.identifier) ??
-            this.storage.getObject(this.identifier)
-        );
-    }
-
-    private setCartData(state: ShoppingCartData<T> | undefined) {
-        const {
-            owner,
-            items = [],
-            promotions = [],
-            formData,
-            cache
-        } = state ?? {};
-        this.owner = owner;
-        this.items = items;
-        this.promotions = promotions;
-        this.formData = formData;
-        this.cache = cache;
-    }
-
-    private doChange(reason: ShoppingCartChangeReason, changedItems: T[]) {
-        if (this.onChange) this.onChange(reason, changedItems);
-    }
-
-    /**
-     * Add item
-     * 添加项目
-     * @param item New item
-     */
-    addItem(item: T) {
-        this.addItems([item]);
-    }
-
-    /**
-     * Add items
-     * @param items New items
-     */
-    addItems(items: T[]) {
-        this.items.push(...items);
-        this.doChange('add', items);
-    }
-
-    /**
-     * Cache price
-     * @param id Item id
-     * @param price Price
-     * @param overrideExisting Override existing price
-     */
-    cachePrice(id: T['id'], price: number, overrideExisting: boolean = false) {
-        if (overrideExisting || this.prices[id] == null)
-            this.prices[id] = price;
-    }
-
-    /**
-     * Change currency
-     * @param currency Currency
-     */
-    changeCurrency(currency: Currency) {
-        this.currency = currency;
-        this.symbol = NumberUtils.getCurrencySymbol(this.currency);
-    }
-
-    /**
-     * Change culture
-     * @param culture Culture
-     */
-    changeCulture(culture: string) {
-        this.culture = culture;
-    }
-
-    /**
-     * Clear storage
-     * @param keepOwner Keep owner data
-     */
-    clear(keepOwner?: boolean) {
-        this.items.length = 0;
-        this.promotions.length = 0;
-        this.prices = <Record<T['id'], number>>{};
-        this.cache = undefined;
-
-        if (keepOwner) {
-            this.save();
-        } else {
-            ShoppingCart.clear(this.identifier, this.storage);
-            this.keys.remove(this.identifier);
-        }
-
-        this.doChange('clear', []);
-    }
-
-    /**
-     * Format amount
-     * @param amount Amount
-     * @returns Result
-     */
-    formatAmount(amount: number) {
-        return NumberUtils.formatMoney(amount, this.currency);
-    }
-
-    /**
-     * Get item
-     * @param id Item id
-     * @returns Result
-     */
-    getItem(id: T['id']) {
-        return this.items.find((item) => item.id === id);
-    }
-
-    /**
-     * Push item
-     * 推送项目
-     * @param data Item data
-     * @returns Added or not
-     */
-    pushItem(data: T) {
-        if (this.items.some((item) => item.id === data.id)) {
-            return false;
-        } else {
-            this.addItem(data);
-            return true;
-        }
-    }
-
-    /**
-     * Reset currency and culture
-     * @param currency New currency
-     * @param culture New culture
-     */
-    reset(currency: Currency, culture: string) {
-        this.changeCurrency(currency);
-        this.changeCulture(culture);
-        this.setCartData(this.getCartData());
-    }
-
-    /**
-     * Remove item from the index
-     * @param index Item index
-     */
-    removeItem(index: number) {
-        const removedItems = this.items.splice(index, 1);
-        this.doChange('remove', removedItems);
-    }
-
-    /**
-     * Reset item
-     * @param item Shopping cart item
-     */
-    resetItem(item: ShoppingCartItem) {
-        item.discount = 0;
-        item.currentPrice = undefined;
-        item.promotions = [];
-    }
-
-    /**
-     * Save cart data
-     * @param persisted For persisted storage
-     */
-    save(persisted: boolean = true) {
-        if (this.owner == null) return;
-
-        const { currency, culture, owner, items, promotions, formData, cache } =
-            this;
-        const data: ShoppingCartData<T> = {
-            currency,
-            culture,
-            owner,
-            items,
-            promotions,
-            formData,
-            cache
-        };
-
-        try {
-            if (persisted) {
-                this.storage.setPersistedData(this.identifier, data);
-
-                const keys = this.keys;
-                if (!keys.includes(this.identifier)) {
-                    keys.push(this.identifier);
-                    this.keys = keys;
-                }
-            } else {
-                this.storage.setData(this.identifier, data);
-            }
-        } catch (error) {
-            console.warn(`ShoppingCart save ${this.identifier} error`, error);
-        }
-
-        return data;
-    }
-
-    /**
-     * Trigger update
-     * 触发更新
-     */
-    update() {
-        this.doChange('update', []);
-    }
-
-    /**
-     * Update discount
-     * @param item Shopping cart item
-     */
-    updateDiscount(item: ShoppingCartItem) {
-        item.discount = item.promotions.sum('amount');
-    }
-
-    /**
-     * Update asset item
-     * 更新资产项目
-     * @param id Product id
-     * @param qty Asset qty
-     * @param itemCreator New item creator
-     * @returns Updated or not
-     */
-    updateAssetItem(
-        id: T['id'],
-        assetQty: number | undefined,
-        itemCreator?: () => Omit<
-            T,
-            'id' | 'price' | 'assetQty' | 'subtotal' | 'discount' | 'promotions'
-        >
-    ) {
-        if (assetQty == null || assetQty <= 0) assetQty = 1;
-
-        const index = this.items.findIndex((item) => item.id === id);
-        if (index === -1) {
-            // New
-            if (itemCreator) {
-                const price = this.prices[id];
-                const data = itemCreator();
-                const qty = data.qty;
-                const newItem = {
-                    ...data,
-                    id,
-                    price,
-                    assetQty,
-                    subtotal: price * qty * assetQty,
-                    discount: 0,
-                    promotions: Array<ShoppingPromotion>()
-                } as T;
-                this.addItem(newItem);
-            }
-            return false;
-        } else {
-            // Update
-            const item = this.items[index];
-
-            // Price may be cached first
-            const price = this.prices[id] ?? item.price;
-            const qty = item.qty;
-
-            const newItem = {
-                ...item,
-                price,
-                assetQty,
-                subtotal: price * qty * assetQty,
-                discount: 0
-            };
-            this.items.splice(index, 1, newItem);
-            this.doChange('update', [item, newItem]);
+  /**
+   * Create identifier key
+   * 创建识别键
+   * @param currency Currency
+   * @param culture Culture
+   * @param key Additional key
+   * @returns Result
+   */
+  static createKey(currency: Currency, culture: string, key: string) {
+    return `ETSOO-CART-${culture}-${key}-${currency}`;
+  }
+
+  /**
+   * Clear shopping cart
+   * 清除购物篮
+   * @param identifier Identifier
+   * @param storage Storage
+   */
+  static clear(identifier: string, storage: IStorage) {
+    try {
+      storage.setData(identifier, null);
+      storage.setPersistedData(identifier, null);
+    } catch (error) {
+      console.warn(`ShoppingCart clear ${identifier} error`, error);
+    }
+  }
+
+  /**
+   * Get cart data
+   * 获取购物篮数据
+   * @param storage Storage
+   * @param id Cart id
+   * @returns Result
+   */
+  static getCartData<D extends ShoppingCartItem>(
+    storage: IStorage,
+    id: string
+  ) {
+    try {
+      return (
+        storage.getPersistedObject<ShoppingCartData<D>>(id) ??
+        storage.getObject<ShoppingCartData<D>>(id)
+      );
+    } catch (error) {
+      console.warn(`ShoppingCart getCartData ${id} error`, error);
+    }
+  }
+
+  /**
+   * Owner data
+   * 所有者信息
+   */
+  owner?: ShoppingCartOwner;
+
+  _currency!: Currency;
+
+  /**
+   * ISO currency id
+   * 标准货币编号
+   */
+  get currency() {
+    return this._currency;
+  }
+  private set currency(value: Currency) {
+    this._currency = value;
+  }
+
+  _culture!: string;
+  /**
+   * ISO culture id, like zh-Hans
+   * 标准语言文化编号
+   */
+  get culture() {
+    return this._culture;
+  }
+  private set culture(value: string) {
+    this._culture = value;
+  }
+
+  _items: T[] = [];
+
+  /**
+   * Items
+   * 项目
+   */
+  get items() {
+    return this._items;
+  }
+  private set items(value) {
+    this._items = value;
+  }
+
+  _promotions: ShoppingPromotion[] = [];
+  /**
+   * Order level promotions
+   * 订单层面促销
+   */
+  get promotions() {
+    return this._promotions;
+  }
+  private set promotions(value) {
+    this._promotions = value;
+  }
+
+  /**
+   * Related form data
+   * 关联的表单数据
+   */
+  formData: any;
+
+  /**
+   * Cache
+   * 缓存对象
+   */
+  cache?: Record<string, unknown>;
+
+  _symbol: string | undefined;
+  /**
+   * Currency symbol
+   * 币种符号
+   */
+  get symbol() {
+    return this._symbol;
+  }
+  private set symbol(value: string | undefined) {
+    this._symbol = value;
+  }
+
+  /**
+   * Key for identifier
+   */
+  readonly key: string;
+
+  /**
+   * Cart identifier
+   * 购物篮标识
+   */
+  get identifier() {
+    const o = this.owner;
+    return ShoppingCart.createKey(this.currency, this.culture, this.key);
+  }
+
+  /**
+   * All data keys
+   * 所有的数据键
+   */
+  get keys() {
+    return this.storage.getPersistedData<string[]>(ShoppingCartKeyField, []);
+  }
+  set keys(items: string[]) {
+    this.storage.setPersistedData(ShoppingCartKeyField, items);
+  }
+
+  /**
+   * Lines count
+   * 项目数量
+   */
+  get lines() {
+    return this.items.length;
+  }
+
+  /**
+   * Total qty
+   * 总数量
+   */
+  get totalQty() {
+    return this.items.map((item) => item.qty).sum();
+  }
+
+  /**
+   * Total amount
+   * 总金额
+   */
+  get totalAmount() {
+    const subtotal = this.items
+      .map((item) => item.subtotal - item.discount)
+      .sum();
+
+    const discount = this.promotions.sum("amount");
+
+    return subtotal - discount;
+  }
+
+  /**
+   * Total amount string
+   * 总金额字符串
+   */
+  get totalAmountStr() {
+    return this.formatAmount(this.totalAmount);
+  }
+
+  /**
+   * Cached prices
+   * 缓存的价格
+   */
+  private prices = <Record<T["id"], number>>{};
+
+  /**
+   * Onchange callback
+   * 改变时回调
+   */
+  onChange?: (reason: ShoppingCartChangeReason, changedItems: T[]) => void;
+
+  /**
+   * Constructor
+   * 构造函数
+   * @param key Key for identifier
+   * @param init Currency & culture ISO code array
+   * @param storage Data storage
+   */
+  constructor(key: string, init: [Currency, string], storage?: IStorage);
+
+  /**
+   * Constructor
+   * 构造函数
+   * @param key Key for identifier
+   * @param state Initialization state
+   * @param storage Data storage
+   */
+  constructor(key: string, state: ShoppingCartData<T>, storage?: IStorage);
+
+  /**
+   * Constructor
+   * 构造函数
+   * @param key Key for identifier
+   * @param currency Currency ISO code
+   * @param storage Data storage
+   */
+  constructor(
+    key: string,
+    currencyOrState: [Currency, string] | ShoppingCartData<T>,
+    private readonly storage: IStorage = new WindowStorage()
+  ) {
+    this.key = key;
+
+    if (Array.isArray(currencyOrState)) {
+      this.reset(currencyOrState[0], currencyOrState[1]);
+    } else {
+      this.setCartData(currencyOrState);
+      this.changeCurrency(currencyOrState.currency);
+      this.changeCulture(currencyOrState.culture);
+    }
+  }
+  private getCartData(): ShoppingCartData<T> | undefined {
+    return (
+      this.storage.getPersistedObject(this.identifier) ??
+      this.storage.getObject(this.identifier)
+    );
+  }
+
+  private setCartData(state: ShoppingCartData<T> | undefined) {
+    const { owner, items = [], promotions = [], formData, cache } = state ?? {};
+    this.owner = owner;
+    this.items = items;
+    this.promotions = promotions;
+    this.formData = formData;
+    this.cache = cache;
+  }
+
+  private doChange(reason: ShoppingCartChangeReason, changedItems: T[]) {
+    if (this.onChange) this.onChange(reason, changedItems);
+  }
+
+  /**
+   * Add item
+   * 添加项目
+   * @param item New item
+   */
+  addItem(item: T) {
+    this.addItems([item]);
+  }
+
+  /**
+   * Add items
+   * @param items New items
+   */
+  addItems(items: T[]) {
+    this.items.push(...items);
+    this.doChange("add", items);
+  }
+
+  /**
+   * Cache price
+   * @param id Item id
+   * @param price Price
+   * @param overrideExisting Override existing price
+   */
+  cachePrice(id: T["id"], price: number, overrideExisting: boolean = false) {
+    if (overrideExisting || this.prices[id] == null) this.prices[id] = price;
+  }
+
+  /**
+   * Change currency
+   * @param currency Currency
+   */
+  changeCurrency(currency: Currency) {
+    this.currency = currency;
+    this.symbol = NumberUtils.getCurrencySymbol(this.currency);
+  }
+
+  /**
+   * Change culture
+   * @param culture Culture
+   */
+  changeCulture(culture: string) {
+    this.culture = culture;
+  }
+
+  /**
+   * Clear storage
+   * @param keepOwner Keep owner data
+   */
+  clear(keepOwner?: boolean) {
+    this.items.length = 0;
+    this.promotions.length = 0;
+    this.prices = <Record<T["id"], number>>{};
+    this.cache = undefined;
+
+    if (keepOwner) {
+      this.save();
+    } else {
+      ShoppingCart.clear(this.identifier, this.storage);
+      this.keys.remove(this.identifier);
+    }
+
+    this.doChange("clear", []);
+  }
+
+  /**
+   * Format amount
+   * @param amount Amount
+   * @returns Result
+   */
+  formatAmount(amount: number) {
+    return NumberUtils.formatMoney(amount, this.currency);
+  }
+
+  /**
+   * Get item
+   * @param id Item id
+   * @returns Result
+   */
+  getItem(id: T["id"]) {
+    return this.items.find((item) => item.id === id);
+  }
+
+  /**
+   * Push item
+   * 推送项目
+   * @param data Item data
+   * @returns Added or not
+   */
+  pushItem(data: T) {
+    if (this.items.some((item) => item.id === data.id)) {
+      return false;
+    } else {
+      this.addItem(data);
+      return true;
+    }
+  }
+
+  /**
+   * Reset currency and culture
+   * @param currency New currency
+   * @param culture New culture
+   */
+  reset(currency: Currency, culture: string) {
+    this.changeCurrency(currency);
+    this.changeCulture(culture);
+    this.setCartData(this.getCartData());
+  }
+
+  /**
+   * Remove item from the index
+   * @param index Item index
+   */
+  removeItem(index: number) {
+    const removedItems = this.items.splice(index, 1);
+    this.doChange("remove", removedItems);
+  }
+
+  /**
+   * Reset item
+   * @param item Shopping cart item
+   */
+  resetItem(item: ShoppingCartItem) {
+    item.discount = 0;
+    item.currentPrice = undefined;
+    item.promotions = [];
+  }
+
+  /**
+   * Save cart data
+   * @param persisted For persisted storage
+   */
+  save(persisted: boolean = true) {
+    if (this.owner == null) return;
+
+    const { currency, culture, owner, items, promotions, formData, cache } =
+      this;
+    const data: ShoppingCartData<T> = {
+      currency,
+      culture,
+      owner,
+      items,
+      promotions,
+      formData,
+      cache
+    };
+
+    try {
+      if (persisted) {
+        this.storage.setPersistedData(this.identifier, data);
+
+        const keys = this.keys;
+        if (!keys.includes(this.identifier)) {
+          keys.push(this.identifier);
+          this.keys = keys;
         }
-
-        return true;
-    }
-
-    /**
-     * Update item
-     * 更新项目
-     * @param id Product id
-     * @param qty Qty
-     * @param itemCreator New item creator
-     * @returns Updated or not
-     */
-    updateItem(
-        id: T['id'],
-        qty: number | undefined,
-        itemCreator?: () => Omit<
-            T,
-            'id' | 'price' | 'qty' | 'subtotal' | 'discount' | 'promotions'
-        >
-    ) {
-        const index = this.items.findIndex((item) => item.id === id);
-        if (qty == null) {
-            // Remove the item
-            if (index !== -1) {
-                this.removeItem(index);
-            }
-        } else if (index === -1) {
-            // New
-            if (itemCreator) {
-                const price = this.prices[id];
-                const data = itemCreator();
-                const newItem = {
-                    ...data,
-                    id,
-                    price,
-                    qty,
-                    subtotal: price * qty * (data.assetQty || 1),
-                    discount: 0,
-                    promotions: Array<ShoppingPromotion>()
-                } as T;
-                this.addItem(newItem);
-            }
-            return false;
-        } else {
-            // Update
-            const item = this.items[index];
-
-            // Price may be cached first
-            const price = this.prices[id] ?? item.price;
-            const newItem = {
-                ...item,
-                qty,
-                price,
-                subtotal: price * qty * (item.assetQty || 1),
-                discount: 0
-            };
-            this.items.splice(index, 1, newItem);
-            this.doChange('update', [item, newItem]);
-        }
-
-        return true;
-    }
-
-    /**
-     * Update price
-     * @param id Item id
-     * @param price New price
-     */
-    updatePrice(id: T['id'], price: number) {
-        this.cachePrice(id, price, true);
-
-        const index = this.items.findIndex((item) => item.id === id);
-        if (index !== -1) {
-            const item = this.items[index];
-            const qty = item.qty;
-            const assetQty = item.assetQty || 1;
-            const newItem = {
-                ...item,
-                price,
-                subtotal: price * qty * assetQty
-            };
-            this.items.splice(index, 1, newItem);
-            this.doChange('update', [item, newItem]);
-        }
-    }
-
-    /**
-     * Update title
-     * @param id Item id
-     * @param title New title
-     */
-    updateTitle(id: T['id'], title: string) {
-        const index = this.items.findIndex((item) => item.id === id);
-        if (index !== -1) {
-            const item = this.items[index];
-            const newItem: T = { ...item, title };
-            if (newItem.name === newItem.title) newItem.title = undefined;
-            this.items.splice(index, 1, newItem);
-            this.doChange('title', [item, newItem]);
-        }
-    }
+      } else {
+        this.storage.setData(this.identifier, data);
+      }
+    } catch (error) {
+      console.warn(`ShoppingCart save ${this.identifier} error`, error);
+    }
+
+    return data;
+  }
+
+  /**
+   * Trigger update
+   * 触发更新
+   */
+  update() {
+    this.doChange("update", []);
+  }
+
+  /**
+   * Update discount
+   * @param item Shopping cart item
+   */
+  updateDiscount(item: ShoppingCartItem) {
+    item.discount = item.promotions.sum("amount");
+  }
+
+  /**
+   * Update asset item
+   * 更新资产项目
+   * @param id Product id
+   * @param qty Asset qty
+   * @param itemCreator New item creator
+   * @returns Updated or not
+   */
+  updateAssetItem(
+    id: T["id"],
+    assetQty: number | undefined,
+    itemCreator?: () => Omit<
+      T,
+      "id" | "price" | "assetQty" | "subtotal" | "discount" | "promotions"
+    >
+  ) {
+    if (assetQty == null || assetQty <= 0) assetQty = 1;
+
+    const index = this.items.findIndex((item) => item.id === id);
+    if (index === -1) {
+      // New
+      if (itemCreator) {
+        const price = this.prices[id];
+        const data = itemCreator();
+        const qty = data.qty;
+        const newItem = {
+          ...data,
+          id,
+          price,
+          assetQty,
+          subtotal: price * qty * assetQty,
+          discount: 0,
+          promotions: Array<ShoppingPromotion>()
+        } as T;
+        this.addItem(newItem);
+      }
+      return false;
+    } else {
+      // Update
+      const item = this.items[index];
+
+      // Price may be cached first
+      const price = this.prices[id] ?? item.price;
+      const qty = item.qty;
+
+      const newItem = {
+        ...item,
+        price,
+        assetQty,
+        subtotal: price * qty * assetQty,
+        discount: 0
+      };
+      this.items.splice(index, 1, newItem);
+      this.doChange("update", [item, newItem]);
+    }
+
+    return true;
+  }
+
+  /**
+   * Update item
+   * 更新项目
+   * @param id Product id
+   * @param qty Qty
+   * @param itemCreator New item creator
+   * @returns Updated or not
+   */
+  updateItem(
+    id: T["id"],
+    qty: number | undefined,
+    itemCreator?: () => Omit<
+      T,
+      "id" | "price" | "qty" | "subtotal" | "discount" | "promotions"
+    >
+  ) {
+    const index = this.items.findIndex((item) => item.id === id);
+    if (qty == null) {
+      // Remove the item
+      if (index !== -1) {
+        this.removeItem(index);
+      }
+    } else if (index === -1) {
+      // New
+      if (itemCreator) {
+        const price = this.prices[id];
+        const data = itemCreator();
+        const newItem = {
+          ...data,
+          id,
+          price,
+          qty,
+          subtotal: price * qty * (data.assetQty || 1),
+          discount: 0,
+          promotions: Array<ShoppingPromotion>()
+        } as T;
+        this.addItem(newItem);
+      }
+      return false;
+    } else {
+      // Update
+      const item = this.items[index];
+
+      // Price may be cached first
+      const price = this.prices[id] ?? item.price;
+      const newItem = {
+        ...item,
+        qty,
+        price,
+        subtotal: price * qty * (item.assetQty || 1),
+        discount: 0
+      };
+      this.items.splice(index, 1, newItem);
+      this.doChange("update", [item, newItem]);
+    }
+
+    return true;
+  }
+
+  /**
+   * Update price
+   * @param id Item id
+   * @param price New price
+   */
+  updatePrice(id: T["id"], price: number) {
+    this.cachePrice(id, price, true);
+
+    const index = this.items.findIndex((item) => item.id === id);
+    if (index !== -1) {
+      const item = this.items[index];
+      const qty = item.qty;
+      const assetQty = item.assetQty || 1;
+      const newItem = {
+        ...item,
+        price,
+        subtotal: price * qty * assetQty
+      };
+      this.items.splice(index, 1, newItem);
+      this.doChange("update", [item, newItem]);
+    }
+  }
+
+  /**
+   * Update title
+   * @param id Item id
+   * @param title New title
+   */
+  updateTitle(id: T["id"], title: string) {
+    const index = this.items.findIndex((item) => item.id === id);
+    if (index !== -1) {
+      const item = this.items[index];
+      const newItem: T = { ...item, title };
+      if (newItem.name === newItem.title) newItem.title = undefined;
+      this.items.splice(index, 1, newItem);
+      this.doChange("title", [item, newItem]);
+    }
+  }
 }