@questwork/q-store-model 0.1.35 → 0.1.36

package/dist/index.min.cjs

@@ -57,12 +57,15 @@ __webpack_require__.d(__webpack_exports__, {
   ChainManager: () => (/* reexport */ ChainManager),
   ChainManagerFactory: () => (/* reexport */ ChainManagerFactory),
   ChainTarget: () => (/* reexport */ ChainTarget),
+  CouponManager: () => (/* reexport */ CouponManager),
   CreditNote: () => (/* reexport */ CreditNote),
   CreditNoteLine: () => (/* reexport */ CreditNoteLine),
   CreditNoteRepo: () => (/* reexport */ CreditNoteRepo),
   Currency: () => (/* reexport */ Currency),
   Invoice: () => (/* reexport */ Invoice),
   InvoiceLine: () => (/* reexport */ InvoiceLine),
+  ItemOption: () => (/* reexport */ ItemOption),
+  ItemOptionLocale: () => (/* reexport */ ItemOptionLocale),
   KeyValueObject: () => (/* reexport */ q_utilities_namespaceObject.KeyValueObject),
   Merchandise: () => (/* reexport */ Merchandise),
   PaymentGateway: () => (/* reexport */ PaymentGateway),
@@ -71,9 +74,11 @@ __webpack_require__.d(__webpack_exports__, {
   PriceStrategy: () => (/* reexport */ PriceStrategy),
   Product: () => (/* reexport */ Product),
   Status: () => (/* reexport */ Status),
+  StoreItem: () => (/* reexport */ StoreItem),
   Transaction: () => (/* reexport */ Transaction),
   WalletItem: () => (/* reexport */ WalletItem),
   adminSettle: () => (/* reexport */ adminSettle),
+  calculateByCoupon: () => (/* reexport */ calculateByCoupon),
   calculator: () => (/* reexport */ calculator),
   checkDuplicate: () => (/* reexport */ checkDuplicate),
   convertTimestampToString: () => (/* reexport */ convertTimestampToString),
@@ -109,6 +114,8 @@ __webpack_require__.d(models_namespaceObject, {
   Currency: () => (Currency),
   Invoice: () => (Invoice),
   InvoiceLine: () => (InvoiceLine),
+  ItemOption: () => (ItemOption),
+  ItemOptionLocale: () => (ItemOptionLocale),
   KeyValueObject: () => (q_utilities_namespaceObject.KeyValueObject),
   Merchandise: () => (Merchandise),
   PaymentGateway: () => (PaymentGateway),
@@ -117,6 +124,7 @@ __webpack_require__.d(models_namespaceObject, {
   PriceStrategy: () => (PriceStrategy),
   Product: () => (Product),
   Status: () => (Status),
+  StoreItem: () => (StoreItem),
   Transaction: () => (Transaction),
   WalletItem: () => (WalletItem)
 });
@@ -716,20 +724,83 @@ const stringHelper = {
 
 
 
+;// ./lib/models/itemOption/itemOptionLocale.js
+const itemOptionLocale_updateAllowedProps = [
+  'label',
+  'locale',
+  'value'
+]
+
+class ItemOptionLocale {
+  constructor(options = {}) {
+    options = options || {}
+    this.locale = options.locale
+    this.label = options.label
+    this.value = options.value || ''
+  }
+  static dummyData() {
+    return {
+      // locale: 'zh-hk',
+    }
+  }
+  static init(options = {}) {
+    if (options instanceof this) {
+      return options
+    }
+    const instance = new this(options)
+    return instance.isValid ? instance : null
+  }
+  static initFromArray(arr = []) {
+    if (Array.isArray(arr)) {
+      return arr.map((a) => this.init(a))
+    }
+    return []
+  }
+  static initOnlyValidFromArray(arr = []) {
+    return this.initFromArray(arr).filter((i) => i)
+  }
+  static get _classname() {
+    return 'ItemOptionLocale'
+  }
+  static get _superclass() {
+    return 'ItemOptionLocale'
+  }
+
+  get isValid() {
+    return !!this
+  }
+
+  update(update) {
+    Object.keys(update).forEach((key) => {
+      if (itemOptionLocale_updateAllowedProps.includes(key)) {
+        this[key] = update[key]
+      }
+    })
+    return this
+  }
+}
+
+
+
 ;// ./lib/models/itemOption/itemOption.js
 
 
+
 const itemOption_updateAllowedProps = [
   'description',
   'key',
   'label',
   'type',
-  'value'
+  'value',
+  'locales'
 ]
 
 class ItemOption {
   constructor(options = {}) {
     options = options || {}
+    const { _ItemOptionLocale } = options._constructor || {}
+    this._ItemOptionLocale = _ItemOptionLocale && (_ItemOptionLocale._superclass === ItemOptionLocale._superclass) ? _ItemOptionLocale : ItemOptionLocale
+
     this.approved = options.approved || false
     this.description = options.description
     // this.header = options.header
@@ -737,9 +808,11 @@ class ItemOption {
     this.itemOptionType = options.itemOptionType || 'ItemOption'
     this.key = options.key
     this.label = options.label
+    this.layout = options.layout
     this.required = options.required || false
     this.type = options.type
     this.value = options.value || ''
+    this.locales = this._ItemOptionLocale.initOnlyValidFromArray(options.locales)
   }
   static dummyData() {
     return {
@@ -800,7 +873,12 @@ class ItemOption {
   update(update) {
     Object.keys(update).forEach((key) => {
       if (itemOption_updateAllowedProps.includes(key)) {
-        this[key] = update[key]
+        if (key === 'locales') {
+          this[key] = this._ItemOptionLocale.initOnlyValidFromArray(update[key])
+        } else {
+          this[key] = update[key]
+        }
+        // this[key] = update[key]
       }
     })
     return this
@@ -822,6 +900,7 @@ function itemOption_setCode(options, key) {
 
 
 
+
 ;// ./lib/models/merchandiseOption/merchandiseOption.js
 class MerchandiseOption {
   constructor(options = {}) {
@@ -1131,7 +1210,7 @@ class PriceStrategy {
       acc = acc || matchAnd(key, value, payload)
       // Object.keys(value).forEach((path) => {
       //   const val = lodash.get(payload[key], path)
-      //   acc = acc || matcher(val, value[path])
+      //   acc = acc || _matcher(val, value[path])
       // })
       return acc
     }, false)
@@ -1185,7 +1264,8 @@ class PriceStrategy {
 function matchAnd(key, value, payload) {
   return Object.keys(value).reduce((acc, path) => {
     const val = external_lodash_namespaceObject.get(payload[key], path)
-    acc = acc && matcher(val, value[path])
+    const actions = Object.keys(value[path])
+    acc = acc && _matcher(val, value[path], actions, true)
     return acc
   }, true)
 }
@@ -1196,20 +1276,40 @@ function matchAnd(key, value, payload) {
  * @param {Object} [formula={}] - The formula object to check the value against.
  * @returns {boolean} - Whether the value matches the formula.
  */
-function matcher(val, formula = {}) {
-  const [action] = Object.keys(formula)
+function _matcher(val, formula = {}, actions = [], match = true) {
+  // const actions = Object.keys(formula)
+  if (!match || actions.length === 0) {
+    return match
+  }
+  const action = actions.shift()
+  // const [action] = Object.keys(formula)
   const formulaValue = formula[action]
+  match = _match({ action, formulaValue, val })
+  return _matcher(val, formula, actions, match)
+}
+
+function _match({ action, formulaValue, val }) {
   switch (action) {
+    case 'elemMatch':
     case '$elemMatch': // val is array and formulaValue is object
       return (val || []).some((v) => {
         return (Object.keys(formulaValue)).filter((key) => {
           return Object.prototype.hasOwnProperty.call(v, key) && v[key] === formulaValue[key]
         }).length > 0
       })
+    case 'eq':
     case '$eq':
       return external_lodash_namespaceObject.isEqual(val, formulaValue)
+    case 'gt':
+    case '$gt':
+      return val > formulaValue
+    case 'gte':
+    case '$gte':
+      return val >= formulaValue
     case '$in':
       return formulaValue.includes(val)
+    case '$includes':
+      return val.includes(formulaValue)
     case '$keyValue':
       if (Array.isArray(val)) {
         return (val.find((remark) => {
@@ -1220,6 +1320,15 @@ function matcher(val, formula = {}) {
         return formulaValue.key === val.key && formulaValue.values.includes(val.value)
       }
       return false
+    case 'lt':
+    case '$lt':
+      return val < formulaValue
+    case 'lte':
+    case '$lte':
+      return val <= formulaValue
+    case 'ne':
+    case '$ne':
+      return val !== formulaValue
     default:
       return true
   }
@@ -1273,7 +1382,7 @@ class Price {
       name: 'Standard',
       dateBegin: new Date().valueOf(),
       dateEnd: new Date().valueOf() + 1,
-      priceStrategies: [this._PriceStrategy.dummyData()],
+      priceStrategies: [PriceStrategy.dummyData()],
       // roles: []
       // qtyPerTransaction: QtyPerTransaction.init()
     }
@@ -1431,16 +1540,15 @@ class Price {
 
 
 const product_updateAllowedProps = [
-  'active',
-  'deleted',
+  'couponDetails',
   'description',
   'entitlements',
   'intangible',
   'limitPercentage',
+  'lineOptions',
   'maxPerWallet',
   'name',
   'originalStock',
-  'owner',
   'printable',
   'printLayoutCodes',
   'printLayoutMappingCodes',
@@ -1448,34 +1556,31 @@ const product_updateAllowedProps = [
   // 'productCategoryCodes',
   'productGroupName',
   'productOptions',
-  'remarks',
   'requiredProductCode',
   'stock'
 ]
 
-class Product {
+class Product extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options = {}) {
     options = options || {}
+    super(options)
+
     const { _ItemOption } = options._constructor || {}
     this._ItemOption = _ItemOption && (_ItemOption._superclass === ItemOption) ? _ItemOption : ItemOption
 
     const id = options._id || options.id
     this.id = setId(id)
     this._type = options._type || 'Product'
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
-    this.deleted = options.deleted || false
+
+    this.couponDetails = options.couponDetails
     this.description = options.description || ''
     this.entitlements = options.entitlements // ['freeRegistration'], ['presidentialDinner', 'galaDinner']
     this.intangible = options.intangible || false
     this.limitPercentage = options.limitPercentage || 100
+    this.lineOptions = this._ItemOption.initOnlyValidFromArray(options.lineOptions)
     this.maxPerWallet = options.maxPerWallet || 1
-    this.metadata = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(options.metadata)
-    this.modified = options.modified || (new Date()).valueOf()
     this.name = options.name || ''
     this.originalStock = options.originalStock || 0
-    this.owner = options.owner
     this.printable = options.printable || false
     this.printLayoutCodes = options.printLayoutCodes || []
     // will be not use property 'printLayoutMappingCodes'
@@ -1485,10 +1590,9 @@ class Product {
     this.productCode = product_setCode(options, 'productCode')
     this.productGroupName = (typeof options.productGroupName !== 'undefined') ? options.productGroupName.toUpperCase() : options.productGroupName || 'DEFAULT'
     this.productOptions = this._ItemOption.initOnlyValidFromArray(options.productOptions)
+    this.productType = options.productType || 'Product'
     this.requiredProductCode = options.requiredProductCode
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
     this.stock = options.stock || 0
-    this.tenantCode = options.tenantCode
   }
 
   // class method
@@ -1498,22 +1602,6 @@ class Product {
       tenantCode: 'tenantCode'
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
   static get _classname() {
     return 'Product'
   }
@@ -1523,11 +1611,17 @@ class Product {
 
   // getters
   get isValid() {
-    return !!this.tenantCode && !!this.name
+    return super.isValid && !!this.name
   }
   get isBadge() {
     return this.productGroupName === 'BADGE'
   }
+  get isCoupon() {
+    return this.productGroupName === 'COUPON'
+  }
+  get isItemCoupon() {
+    return this.couponDetails ? this.couponDetails.item : false
+  }
   get isPrintable() {
     return this.printLayoutMappingCodes.length > 0
   }
@@ -1566,6 +1660,12 @@ class Product {
       return acc
     }, { errMsgs: [] })
   }
+  getCode() {
+    return this.productCode
+  }
+  getMetadataValueByKey(key) {
+    return q_utilities_namespaceObject.Metadata.getValueByKey(this.metadata || [], key)
+  }
   getProductOptionByKey(key) {
     const arr = this._ItemOption.getByKey(this.productOptions, key)
     if (arr.length === 1) {
@@ -1576,28 +1676,32 @@ class Product {
   hasStock(qty) {
     return this.stock >= qty
   }
+  isApplicableCoupon(obj) {
+    const { merchandiseCodes = [] } = this.couponDetails || {}
+    return merchandiseCodes.length > 0 ? merchandiseCodes.includes(obj.merchandiseCode) : true
+  }
+  isQualified(data) {
+    const rules = this.getMetadataValueByKey('RULES') || []
+    return (rules.length === 0)
+      ? true
+      : rules.reduce((acc, r) => {
+          return acc || (0,q_utilities_namespaceObject.getValidation)(r, data, _getDataByKey, q_utilities_namespaceObject.KeyValueObject)
+        }, false)
+  }
   isTicket() {
     return false
   }
-  setModified() {
-    this.modified = (new Date()).valueOf()
-    return this
-  }
   update(update) {
     Object.keys(update).forEach((key) => {
       if (product_updateAllowedProps.includes(key)) {
-        if (key === 'metadata') {
-          this[key] = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(update[key])
-        } else  if (key === 'productOptions') {
+        if (key === 'productOptions' || key === 'lineOptions') {
           this[key] = this._ItemOption.initOnlyValidFromArray(update[key])
-        } else if (key === 'remarks') {
-          this[key] = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(update[key])
         } else {
           this[key] = update[key]
         }
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
 }
 
@@ -1616,6 +1720,10 @@ function product_setCode(options, key) {
   return stringHelper.setCode()
 }
 
+function _getDataByKey(key, data) {
+  return (0,q_utilities_namespaceObject.getValueByKeys)(key.split('.'), data)
+}
+
 
 
 ;// ./lib/models/product/productRepo.js
@@ -1655,11 +1763,8 @@ class ProductRepo extends q_utilities_namespaceObject.Repo {
 
 
 
-
 const merchandise_updateAllowedProps = [
-  'active',
   'defaultCurrency',
-  'deleted',
   'description',
   'eventSessionCode',
   'intangible',
@@ -1667,23 +1772,22 @@ const merchandise_updateAllowedProps = [
   'max',
   'merchandiseCategoryCodes',
   'merchandiseOptions',
-  'metadata',
   'name',
   'onlyFor',
-  'owner',
   'prices',
   'pricings',
   'priority',
   'productCodes',
-  'remarks',
   'sku',
   'stock',
   'visibleBy'
 ]
 
-class Merchandise {
+class Merchandise extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options = {}) {
     options = options || {}
+    super(options)
+
     const { _ItemOption, _ItemOptionFillIn, _MerchandiseOption, _Price, _Product } = options._constructor || {}
     this._ItemOption = _ItemOption && (_ItemOption._superclass === ItemOption._superclass) ? _I_ItemOptiontemOptionFillIn : ItemOption
     this._ItemOptionFillIn = _ItemOptionFillIn && (_ItemOptionFillIn._superclass === ItemOptionFillIn._superclass) ? _ItemOptionFillIn : ItemOptionFillIn
@@ -1692,16 +1796,11 @@ class Merchandise {
     this._Product = _Product && (_Product._superclass === Product._superclass) ? _Product : Product
 
     this._products = options._products || []
-    this._tenant = options._tenant
     this._type = options._type || 'Merchandise'
 
     const id = options._id || options.id
     this.id = merchandise_setId(id)
-    this._type = options._type || 'Merchandise'
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
-    this.deleted = options.deleted || false
+
     this.defaultCurrency = options.defaultCurrency || 'HKD'
     this.description = options.description
     this.free = options.free || false
@@ -1710,17 +1809,12 @@ class Merchandise {
     this.merchandiseCategoryCodes = options.merchandiseCategoryCodes || []
     this.merchandiseCode = merchandise_setCode(options, 'merchandiseCode')
     this.merchandiseOptions = initMerchandiseOptions(this, options)
-    this.metadata = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(options.metadata)
-    this.modified = options.modified || (new Date()).valueOf()
     this.name = options.name || ''
-    this.owner = options.owner
     this.prices = this._Price.initOnlyValidFromArray(options.prices)
     this.productCodes = options.productCodes || []
     this.priority = options.priority || 100
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
     this.sku = options.sku || ''
     this.stock = options.stock || 0
-    this.tenantCode = options.tenantCode
   }
 
   // Class Mehtods
@@ -1741,22 +1835,6 @@ class Merchandise {
       tenantCode: '85223977000',
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
   static get _classname() {
     return 'Merchandise'
   }
@@ -1810,7 +1888,7 @@ class Merchandise {
     return this.printOut.isPrintable
   }
   get isValid() {
-    return !!this.tenantCode && !!this.name && (!!this.productCodes && this.productCodes.length > 0)
+    return super.isValid && !!this.name && (!!this.productCodes && this.productCodes.length > 0)
   }
   get products() {
     return this._Product.initOnlyValidFromArray(this._products || [])
@@ -1957,6 +2035,43 @@ class Merchandise {
     }
     return info
   }
+  getBeginAndEndDates() {
+    const dates = {
+      dateBegin: null,
+      dateEnd: null
+    }
+    // BUG this.pricings is undefind
+    return this.pricings.reduce((acc, pricing) => {
+      if (!acc.dateBegin || (pricing.dateBegin > acc.dateBegin)) {
+        acc.dateBegin = pricing.dateBegin
+      }
+
+      if (!acc.dateEnd || (pricing.dateEnd <= acc.dateEnd)) {
+        acc.dateEnd = pricing.dateEnd
+      }
+      return acc
+    }, dates)
+  }
+  getCode() {
+    return this.merchandiseCode
+  }
+  getCurrentPrice() {
+    const timestamp = (new Date()).valueOf()
+    const prices = this.getPricesByTime(timestamp)
+    if (prices.length === 1) {
+      return prices[0]
+    }
+    return null
+  }
+  getCurrentPriceByRoleCodes(roleCodes) {
+    const timestamp = (new Date()).valueOf()
+    let prices = this.getPricesByTime(timestamp)
+    prices = Price.getPricesByRoleCodes(prices, roleCodes)
+    if (prices.length === 1) {
+      return prices[0]
+    }
+    return null
+  }
   getItemOptionInfos(cartItems = []) {
     return cartItems.reduce((acc, cartItem) => {
       const itemOptionFillIns = cartItem.getItemOptionFillIns()
@@ -1983,47 +2098,13 @@ class Merchandise {
     }
     return null
   }
-  getProducts() {
-    return this.products || []
-  }
-  getCurrentPriceByRoleCodes(roleCodes) {
-    const timestamp = (new Date()).valueOf()
-    let prices = this.getPricesByTime(timestamp)
-    prices = Price.getPricesByRoleCodes(prices, roleCodes)
-    if (prices.length === 1) {
-      return prices[0]
-    }
-    return null
-  }
-  getCurrentPrice() {
-    const timestamp = (new Date()).valueOf()
-    const prices = this.getPricesByTime(timestamp)
-    if (prices.length === 1) {
-      return prices[0]
-    }
-    return null
+  getPrices() {
+    return this.prices ? this.prices : []
   }
   getPricesByTime(timestamp) {
     const copyDate = timestamp || (new Date()).valueOf()
     return Price.getPricesByTime(this.prices, copyDate)
   }
-  getBeginAndEndDates() {
-    const dates = {
-      dateBegin: null,
-      dateEnd: null
-    }
-    // BUG this.pricings is undefind
-    return this.pricings.reduce((acc, pricing) => {
-      if (!acc.dateBegin || (pricing.dateBegin > acc.dateBegin)) {
-        acc.dateBegin = pricing.dateBegin
-      }
-
-      if (!acc.dateEnd || (pricing.dateEnd <= acc.dateEnd)) {
-        acc.dateEnd = pricing.dateEnd
-      }
-      return acc
-    }, dates)
-  }
   getPriceByTimeAndRoleCodes(timestamp, roleCodes) {
     let prices = this.getPricesByTime(timestamp)
     prices = Price.getPricesByRoleCodes(prices, roleCodes)
@@ -2032,14 +2113,13 @@ class Merchandise {
     }
     return null
   }
-  getPrices() {
-    return this.prices ? this.prices : []
-  }
-  getRemarksByKey(key) {
-    return q_utilities_namespaceObject.KeyValueObject.getValuesByKey(this.remarks, key)
+  getProducts() {
+    return this.products || []
   }
-  getStock() {
-    return this.stock || 0
+  getProductsMetadataValuesByKey(key) {
+    return this.products.map((p) => {
+      return p.getMetadataValueByKey(key)
+    }).filter((i) => i)
   }
   getProductsQty(qty = 1) {
     return this.productCodes.reduce((acc, productCode) => {
@@ -2051,13 +2131,16 @@ class Merchandise {
       return acc
     }, {})
   }
+  getRemarksByKey(key) {
+    return q_utilities_namespaceObject.KeyValueObject.getValuesByKey(this.remarks, key)
+  }
+  getStock() {
+    return this.stock || 0
+  }
+
   reachLimit(qty) {
     return this.max < qty
   }
-  setModified() {
-    this.modified = (new Date()).valueOf()
-    return this
-  }
   setPrices(prices) {
     if (Array.isArray(prices)) {
       this.prices = Price.initOnlyValidFromArray(prices)
@@ -2071,18 +2154,14 @@ class Merchandise {
           this[key] = this._ItemOption.initOnlyValidFromArray(update[key])
         } else if (key === 'merchandiseOptions' && !!this.tenantCode) {
           this[key] = MerchandiseOption.initOnlyValidFromArray(update[key])
-        } else if (key === 'metadata') {
-          this[key] = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(update[key])
         } else if (key === 'prices') {
           this[key] = Price.initOnlyValidFromArray(update[key])
-        } else if (key === 'remarks') {
-          this[key] = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(update[key])
         } else {
           this[key] = update[key]
         }
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
 }
 
@@ -2602,6 +2681,9 @@ class Status {
   //   this.cancelled = null
   //   return this
   // }
+  unSetOnHold() {
+    this.onHold = null
+  }
   update(update) {
     Object.keys(update).forEach((key) => {
       if (!notUpdateAllowedProps.includes(key)) {
@@ -2623,14 +2705,14 @@ class Status {
 // import { WalletItem } from '../walletItem/index.js'
 
 const cart_updateAllowedProps = [
-  'active',
-  'remarks',
-  'deleted',
+
 ]
 
-class Cart {
+class Cart extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options = {}) {
     options = options || {}
+    super(options)
+
     const { _CartItem, _Merchandise, _Status } = options._constructor || {}
     this._CartItem = _CartItem && (_CartItem._superclass === CartItem._superclass) ? _CartItem : CartItem
     this._Merchandise = _Merchandise && (_Merchandise._superclass === Merchandise._superclass) ? _Merchandise : Merchandise
@@ -2643,18 +2725,9 @@ class Cart {
     this._merchandises = options._merchandises
     this._type = options._type || 'Cart'
     
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
     this.cartCode = cart_setCode(options, 'cartCode')
     this.cartItems = this._CartItem.initOnlyValidFromArray(options.cartItems)
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
-    this.deleted = options.deleted || false
-    this.metadata = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(options.metadata)
-    this.modified = options.modified || (new Date()).valueOf()
-    this.owner = options.owner
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
     this.status = this._Status.init(options.status)
-    this.tenantCode = options.tenantCode
   }
 
   // Class Methods
@@ -2664,22 +2737,6 @@ class Cart {
       tenantCode: 'tenantCode'
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
   static get _classname() {
     return 'Cart'
   }
@@ -2689,7 +2746,7 @@ class Cart {
 
   // getters
   get isValid() {
-    return !!this.tenantCode
+    return super.isValid
   }
   get isActive() {
     return !!this.active
@@ -2805,6 +2862,9 @@ class Cart {
   getCartItemCodes() {
     return this.cartItems.map((cartItem) => cartItem.cartItemCode)
   }
+  getCode() {
+    return this.cartCode
+  }
   getCurrencyCode() {
     return this.cartItems.length > 0
       ? this.cartItems[0].getCurrencyCode()
@@ -2858,10 +2918,6 @@ class Cart {
     this.status.setCompleted()
     return this.setModified()
   }
-  setModified() {
-    this.modified = (new Date()).valueOf()
-    return this
-  }
   updateAvailable({ isCoordinator, selectCartItems }) {
     try {
       if (!isCoordinator) {
@@ -2875,16 +2931,10 @@ class Cart {
   update(update) {
     Object.keys(update).forEach((key) => {
       if (cart_updateAllowedProps.includes(key)) {
-        if (key === 'metadata') {
-          this[key] = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(update[key])
-        } else if (key === 'remarks') {
-          this[key] = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(update[key])
-        } else {
-          this[key] = update[key]
-        }
+        this[key] = update[key]
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
   updateStock() {
     if (this.cartItems.length === 0) {
@@ -2970,22 +3020,20 @@ class CartRepo extends q_utilities_namespaceObject.Repo {
 
 
 const category_updateAllowedProps = [
-  'active',
   'codes',
-  'deleted',
   'description',
   'max',
   'min',
   'name',
-  'owner',
   'priority',
   'productCodes',
-  'remarks',
 ]
 
-class Category {
+class Category extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options) {
     options = options || {}
+    super(options)
+
     const { _Product } = options._constructor || {}
     this._Product = _Product && (_Product._superclass === Product._superclass) ? _Product : Product
 
@@ -2994,22 +3042,15 @@ class Category {
 
     const id = options._id || options.id
     this.id = category_setId(id)
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
+
     this.categoryCode = category_setCode(options, 'categoryCode')
     this.codes = options.codes || []
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
-    this.deleted = options.deleted || false
     this.description = options.description
     this.max = options.max || 1
     this.min = options.min || 0
-    this.modified = options.modified || (new Date()).valueOf()
     this.name = options.name
-    this.owner = options.owner
     this.priority = options.priority || 10
     this.productCodes = options.productCodes || []
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
-    this.tenantCode = options.tenantCode
   }
 
   // class methods
@@ -3019,22 +3060,6 @@ class Category {
       tenantCode: 'tenantCode'
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
   static get _classname() {
     return 'Category'
   }
@@ -3044,29 +3069,20 @@ class Category {
 
   // getters
   get isValid() {
-    return !!this.name && !!this.tenantCode && this.max > this. min
+    return super.isValid && !!this.name && this.max > this. min
   }
   get products() {
     return this._Product.initOnlyValidFromArray(this._products)
   }
 
   // instance methods
-  setModified() {
-    this.modified = (new Date()).valueOf()
-    return this
-  }
-
   update(update) {
     Object.keys(update).forEach((key) => {
       if (category_updateAllowedProps.includes(key)) {
-        if (key === 'remarks') {
-          this[key] = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(update[key])
-        } else {
-          this[key] = update[key]
-        }
+        this[key] = update[key]
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
 }
 
@@ -3123,20 +3139,19 @@ class CategoryRepo extends q_utilities_namespaceObject.Repo {
 
 
 const creditNoteLine_updateAllowedProps = [
-  'active',
   'amount',
   // 'deduction',
-  'deleted',
   'description',
   // 'discount',
   'qty',
-  'remarks',
   // 'unitPrice'
 ]
 
-class CreditNoteLine {
+class CreditNoteLine extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options = {}) {
     options = options || {}
+    super(options)
+
     const { _Amount } = options._constructor || {}
     this._Amount = _Amount && (_Amount._superclass === Amount._superclass) ? _Amount : Amount
 
@@ -3145,21 +3160,14 @@ class CreditNoteLine {
 
     const id = options._id || options.id
     this.id = creditNoteLine_setId(id)
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
+
     this.amount = this._Amount.init(options.amount)
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
     this.creditNoteCode = options.creditNoteCode
     this.creditNoteLineCode = creditNoteLine_setCode(options, 'creditNoteLineCode')
     // this.deduction = this._Amount.init(options.deduction)
-    this.deleted = options.deleted || false
     this.description = options.description
     // this.discount = options.discount || 0
-    this.modified = options.modified || (new Date()).valueOf()
-    this.owner = options.owner
     this.qty = options.qty || 1
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
-    this.tenantCode = options.tenantCode
     // this.unitPrice = Amount.init(options.unitPrice)
   }
 
@@ -3170,22 +3178,6 @@ class CreditNoteLine {
       tenantCode: 'tenantCode'
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
   static get _classname() {
     return 'CreditNoteLine'
   }
@@ -3196,7 +3188,7 @@ class CreditNoteLine {
 
   // getters
   get isValid() {
-    return !!this.creditNoteCode && !!this.tenantCode
+    return super.isValid && !!this.creditNoteCode
   }
 
   // instance methods
@@ -3207,10 +3199,6 @@ class CreditNoteLine {
     }
     return this
   }
-  setModified() {
-    this.modified = (new Date()).valueOf()
-    return this
-  }
 
   update(update) {
     Object.keys(update).forEach((key) => {
@@ -3224,7 +3212,7 @@ class CreditNoteLine {
         }
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
 }
 
@@ -3283,17 +3271,16 @@ class CreditNoteLineRepo extends q_utilities_namespaceObject.Repo {
 
 
 const creditNote_updateAllowedProps = [
-  'active',
-  'deleted',
   'description',
-  'remarks',
   'status'
 ]
 
-class CreditNote {
+class CreditNote extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options = {}) {
     options = options || {}
-    const { _Amount, _CreditNoteLine } = options._constructor || {}
+    super(options)
+
+    const { _Amount, _CreditNoteLine, _Status } = options._constructor || {}
     this._Amount = _Amount && (_Amount._superclass === Amount._superclass) ? _Amount : Amount
     this._CreditNoteLine = _CreditNoteLine && (_CreditNoteLine._superclass === CreditNoteLine._superclass) ? _CreditNoteLine : CreditNoteLine
     this._Status = _Status && (_Status._superclass === Status._superclass) ? _Status : Status
@@ -3302,21 +3289,13 @@ class CreditNote {
 
     const id = options._id || options.id
     this.id = creditNote_setId(id)
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
+
     this.amount = this._Amount.init(options.amount)
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
     this.creditNoteCode = creditNote_setCode(options, 'creditNoteCode')
     this.creditNoteLines = this._CreditNoteLine.initOnlyValidFromArray(options.creditNoteLines)
-    this.deleted = options.deleted || false
     this.description = options.description
     this.invoiceCode = options.invoiceCode
-    this.metadata = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(options.metadata)
-    this.modified = options.modified || (new Date()).valueOf()
-    this.owner = options.owner
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
     this.status = this._Status.init(options.status)
-    this.tenantCode = options.tenantCode
   }
 
   // Class Methods
@@ -3326,22 +3305,6 @@ class CreditNote {
       tenantCode: 'tenantCode'
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
   static get _classname() {
     return 'CreditNote'
   }
@@ -3359,9 +3322,11 @@ class CreditNote {
   }
 
   get isValid() {
-    return !!this.tenantCode && !!this.invoiceCode
+    return super.isValid && !!this.invoiceCode
+  }
+  getCode() {
+    return this.creditNoteCode
   }
-
   setAmount(amount) {
     const a = this_Amount.init(amount)
     if (this.isPending && a) {
@@ -3373,10 +3338,6 @@ class CreditNote {
     this.status.setCompleted()
     return this.setModified()
   }
-  setModified() {
-    this.modified = (new Date()).valueOf()
-    return this
-  }
   setPaid(t) {
     this.status.setPaid(t)
     return this.setModified()
@@ -3386,10 +3347,6 @@ class CreditNote {
       if (creditNote_updateAllowedProps.includes(key)) {
         if (key === 'amount') {
           this[key] = this._Amount.init(update[key])
-        } else if (key === 'metadata') {
-          this[key] = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(update[key])
-        } else if (key === 'remarks') {
-          this[key] = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(update[key])
         } else if (key === 'status') {
           this[key] = this._Status.init(update[key])
         } else {
@@ -3397,7 +3354,7 @@ class CreditNote {
         }
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
 }
 
@@ -3451,35 +3408,27 @@ class CreditNoteRepo extends q_utilities_namespaceObject.Repo {
 
 
 const currency_updateAllowedProps = [
-  'active',
-  'deleted',
   'description',
   'name',
-  'remarks',
   'symbol'
 ]
 
-class Currency {
+class Currency extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options = {}) {
     options = options || {}
+    super(options)
+
     const id = options._id || options.id
     this.id = currency_setId(id)
 
     this._type = options._type || 'Currency'
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
+
     this.code = options.code // 'HKD'
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
     this.currencyCode = currency_setCode(options, 'currencyCode')
-    this.deleted = options.deleted || false
     this.description = options.description
     this.factor = options.factor || 1 // 100
-    this.modified = options.modified || (new Date()).valueOf()
     this.name = options.name
-    this.owner = options.owner
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
     this.symbol = options.symbol || null
-    this.tenantCode = options.tenantCode
     this.unit = options.unit
   }
   static dummyData() {
@@ -3491,22 +3440,6 @@ class Currency {
       unit: 'Cent',
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
   static get _classname() {
     return 'Currency'
   }
@@ -3515,29 +3448,23 @@ class Currency {
   }
 
   get isValid() {
-    return !!this.code && typeof this.factor === 'number' && !!this.name && !!this.unit && !!this.tenantCode
+    return super.isValid && !!this.code && typeof this.factor === 'number' && !!this.name && !!this.unit
   }
 
   fromCurrencyValue(value) {
     return value / this.factor
   }
-
-  setModified() {
-    this.modified = (new Date()).valueOf()
-    return this
+  getCode() {
+    return this.currencyCode
   }
 
   update(update) {
     Object.keys(update).forEach((key) => {
       if (currency_updateAllowedProps.includes(key)) {
-        if (key === 'remarks') {
-          this[key] = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(update[key])
-        } else {
-          this[key] = update[key]
-        }
+        this[key] = update[key]
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
 }
 
@@ -3588,6 +3515,74 @@ class CurrencyRepo extends q_utilities_namespaceObject.Repo {
 
 
 
+;// ./lib/helpers/getPurchaseOptionValue/getPurchaseOptionValue.js
+function getPurchaseOptionValue(options) {
+  const {
+    delimiter = ': ',
+    key,
+    purchaseOptions,
+    tag = 'div'
+  } = options || {}
+  if (!key) {
+    return purchaseOptions.reduce((acc, purchaseOption) => {
+      const arr = _getOnePurchaseOptionValue({
+        delimiter, purchaseOption, tag
+      })
+      if (tag) {
+        acc.push(`<${tag}>${arr.join('')}</${tag}>`)
+      } else {
+        acc.push(`${arr.join('; ')}`)
+      }
+      return acc
+    }, [])
+  }
+  const purchaseOption = (purchaseOptions || []).find((po) => {
+    return !!key && po.key === key
+  })
+  if (!purchaseOption) {
+    return []
+  }
+  return _getOnePurchaseOptionValue({
+    delimiter, purchaseOption, tag
+  })
+}
+
+function _getOnePurchaseOptionValue({
+  delimiter = ': ',
+  purchaseOption,
+  tag = 'div'
+}) {
+  return (purchaseOption.value || []).reduce((acc, val) => {
+    const { label, value = {} } = val || {}
+    const _label = label ?? ''
+    if (Array.isArray(value)) {
+      if (tag) {
+        acc.push(`<${tag}>${_label}${delimiter}${value.join(delimiter)}</${tag}>`)
+      } else {
+        acc.push(`${_label}${delimiter}${value.join(delimiter)}`)
+      }
+    } else if (typeof value === 'object') {
+      Object.keys(value).map((key) => {
+        if (tag) {
+          acc.push(`<${tag}>${key}${delimiter}${value[key]}</${tag}>`)
+        } else {
+          acc.push(`${key}${delimiter}${value[key]}`)
+        }
+      })
+    } else {
+      if (tag) {
+        acc.push(`<${tag}>${_label}${delimiter}${value}</${tag}>`)
+      } else {
+        acc.push(`${_label}${delimiter}${value}`)
+      }
+    }
+
+    return acc
+  }, [])
+}
+
+
+
 ;// ./lib/models/invoiceLine/invoiceLine.js
 
 
@@ -3596,22 +3591,22 @@ class CurrencyRepo extends q_utilities_namespaceObject.Repo {
 
 
 
+
 const invoiceLine_updateAllowedProps = [
-  'active',
   'amount',
   'deduction',
-  'deleted',
   'description',
   'discount',
   'purchaseOptions',
   'qty',
-  'remarks',
   'unitPrice'
 ]
 
-class InvoiceLine {
+class InvoiceLine extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options = {}) {
     options = options || {}
+    super(options)
+
     const { _Amount, _Invoice, _Merchandise, _Status } = options._constructor || {}
     this._Amount = _Amount && (_Amount._superclass === Amount._superclass) ? _Amount : Amount
     this._Invoice = _Invoice && (_Invoice._superclass === Invoice._superclass) ? _Invoice : Invoice
@@ -3624,23 +3619,16 @@ class InvoiceLine {
     const id = options._id || options.id
     this.id = invoiceLine_setId(id)
     this._type = options._type || 'InvoiceLine'
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
     this.amount = this._Amount.init(options.amount)
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
     this.deduction = this._Amount.init(options.deduction)
-    this.deleted = options.deleted || false
     this.description = options.description
     this.discount = options.discount || 0
     this.invoiceCode = options.invoiceCode
     this.invoiceLineCode = invoiceLine_setCode(options, 'invoiceLineCode')
     this.merchandiseCode = options.merchandiseCode
-    this.modified = options.modified || (new Date()).valueOf()
     this.purchaseOptions = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.purchaseOptions)
     this.qty = options.qty || 1
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
     this.status = this._Status.init(options.status)
-    this.tenantCode = options.tenantCode
     this.unitPrice = this._Amount.init(options.unitPrice)
     this.waived = options.waived || 0
   }
@@ -3653,24 +3641,8 @@ class InvoiceLine {
       tenantCode: 'tenantCode'
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
-  static get _classname() {
-    return 'InvoiceLine'
+  static get _classname() {
+    return 'InvoiceLine'
   }
   static get _superclass() {
     return 'InvoiceLine'
@@ -3678,7 +3650,7 @@ class InvoiceLine {
 
   // getters
   get isValid() {
-    return !!this.amount && !!this.invoiceCode && !!this.tenantCode
+    return super.isValid && !!this.amount && !!this.invoiceCode
   }
   get invoice() {
     return this._Invoice.init(this._invoice)
@@ -3688,11 +3660,13 @@ class InvoiceLine {
   }
 
   // instance methods
-  setModified() {
-    this.modified = (new Date()).valueOf()
-    return this
+  getPurchaseOptionValue(options) {
+    const { delimiter, key, tag } = options || {}
+    return getPurchaseOptionValue({
+      key,
+      purchaseOptions: this.purchaseOptions
+    })
   }
-
   update(update) {
     Object.keys(update).forEach((key) => {
       if (invoiceLine_updateAllowedProps.includes(key)) {
@@ -3705,7 +3679,7 @@ class InvoiceLine {
         }
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
 }
 
@@ -3815,45 +3789,38 @@ class Issuer {
 
 
 
+
 // import { Transaction } from '../transaction/index.js'
 
 const walletItem_updateAllowedProps = [
-  'active',
-  'deleted',
-  'owner',
   'purchaseOptions',
   'qty',
-  'remarks',
   'status',
 ]
 
-class WalletItem {
+class WalletItem extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options = {}) {
     options = options || {}
+    super(options)
+
     const { _Product, _Status } = options._constructor || {}
     this._Product = _Product && (_Product._superclass === Product._superclass) ? _Product : Product
     this._Status = _Status && (_Status._superclass === Status._superclass) ? _Status : Status
     // this._Transaction = _Transaction && (_Transaction._superclass === Transaction._superclass) ? _Transaction : Transaction
 
+    this._eventRegistration = options._eventRegistration
+    this._invoiceLine = options._invoiceLine
     this._product = options._product
     this._tenant = options._tenant
     this._transaction = options._transaction
 
     const id = options._id || options.id
     this.id = walletItem_setId(id)
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
-    this.deleted = options.deleted || false
-    this.metadata = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(options.metadata)
-    this.modified = options.modified || (new Date()).valueOf()
-    this.owner = options.owner
+    this.invoiceLineCode = options.invoiceLineCode
     this.productCode = options.productCode
     this.purchaseOptions = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.purchaseOptions)
     this.qty = options.qty || 1
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
     this.status = this._Status.init(options.status)
-    this.tenantCode = options.tenantCode
     this.transactionCode = options.transactionCode
     this.walletItemCode = walletItem_setCode(options, 'walletItemCode')
   }
@@ -3869,22 +3836,7 @@ class WalletItem {
       transactionCode: 'transactionCode'
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
+
   static get _classname() {
     return 'WalletItem'
   }
@@ -3894,11 +3846,14 @@ class WalletItem {
 
   // getters
   get isValid() {
-    return !!this.tenantCode && !!this.productCode
+    return super.isValid && !!this.productCode
   }
   get isAssigned() {
     return this.status.isAssigned
   }
+  get isAvailableCoupon() {
+    return this.isCoupon && !this.isCancelled && !this.isUsed
+  }
   get isCancelled() {
     return this.status.isCancelled
   }
@@ -3908,9 +3863,21 @@ class WalletItem {
   get isConfirmed() {
     return this.status.isConfirmed
   }
+  get isCoupon() {
+    return this.product ? this.product.isCoupon : false
+  }
   get isDelivered() {
     return this.status.isDelivered
   }
+  get isInWallet() {
+    return !this.isCancelled && !this.isRefundRequested
+  }
+  get isItemCoupon() {
+    return this.product ? this.product.isItemCoupon : false
+  }
+  get isOnHold() {
+    return this.status.onHold
+  }
   get isOwned() {
     return (
       !this.isCancelled && !this.isRejected && !this.isRefunded
@@ -3934,6 +3901,9 @@ class WalletItem {
   get isRefunded() {
     return this.status.isRefunded
   }
+  get isRefundRequested() {
+    return this.status.isRefundRequested
+  }
   get isRejected() {
     return this.status.rejected
   }
@@ -3949,6 +3919,10 @@ class WalletItem {
   get isWaived() {
     return this.status.isWaived
   }
+
+  get couponDetails() {
+    return this.product ? this.product.couponDetails : null
+  }
   get product() {
     return this._Product.init(this._product)
   }
@@ -3980,8 +3954,23 @@ class WalletItem {
         return this
     }
   }
+  getCode() {
+    return this.walletItemCode
+  }
+  getPurchaseOptionValue(options) {
+    const { delimiter, key, tag } = options || {}
+    return getPurchaseOptionValue({
+      delimiter,
+      key,
+      purchaseOptions: this.purchaseOptions,
+      tag,
+    })
+  }
+  isApplicableCoupon(obj) {
+    return this.isAvailableCoupon && (this.product ? this.product.isApplicableCoupon(obj) : false)
+  }
   isSameOwner(userId) {
-    return userId
+    return userId && this.owner
       ? (userId === this.owner)
       : false
   }
@@ -3997,8 +3986,8 @@ class WalletItem {
     this.status.setDelivered(value)
     return this
   }
-  setModified() {
-    this.modified = (new Date()).valueOf()
+  setOnHold() {
+    this.status.setOnHold()
     return this
   }
   setPaid() {
@@ -4031,6 +4020,11 @@ class WalletItem {
     // this.statusTimestamp.setUsed()
     return this
   }
+  setUsedCouponFor(walletItemCode) {
+    const _usedFor = q_utilities_namespaceObject.KeyValueObject.foundValueByKey(this.metadata, 'USED_COUPON_FOR') || []
+    _usedFor.push(walletItemCode)
+    this.metadata = q_utilities_namespaceObject.Metadata.insertOrUpdateRecord(this.metadata, 'USED_COUPON_FOR', _usedFor)
+  }
   setWaived() {
     this.status.setWaived()
     return this
@@ -4051,12 +4045,14 @@ class WalletItem {
   //     walletItemCode: this.walletItemCode
   //   }
   // }
+  unSetOnHold() {
+    this.status.unSetOnHold()
+    return this
+  }
   update(update) {
     Object.keys(update).forEach((key) => {
       if (walletItem_updateAllowedProps.includes(key)) {
-        if (key === 'metadata') {
-          this[key] = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(update[key])
-        } else if (key === 'purchaseOptions' || key === 'remarks') {
+        if (key === 'purchaseOptions') {
           this[key] = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(update[key])
         } else if (key === 'status') {
           this[key] = this._Status.init(update[key])
@@ -4065,7 +4061,7 @@ class WalletItem {
         }
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
 }
 
@@ -4121,18 +4117,17 @@ class WalletItemRepo extends q_utilities_namespaceObject.Repo {
 
 
 const transaction_updateAllowedProps = [
-  'active',
   'amount',
   'couponCodes',
-  'deleted',
   // 'refundedAmount',
-  'remarks',
   'status'
 ]
 
-class Transaction {
+class Transaction extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options = {}) {
     options = options || {}
+    super(options)
+
     const { _Amount, _Status, _WalletItem } = options._constructor || {}
     this._Amount = _Amount && (_Amount._superclass === Amount._superclass) ? _Amount : Amount
     this._Status = _Status && (_Status._superclass === Status._superclass) ? _Status : Status
@@ -4148,22 +4143,14 @@ class Transaction {
     const id = options._id || options.id
     this.id = transaction_setId(id)
     this._type = options._type || 'Transaction'
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
+
     this.amount = this._Amount.init(options.amount)
     this.couponCodes = options.couponCodes || []
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
     this.creditNoteCodes = options.creditNoteCodes || []
-    this.deleted = options.deleted || false
     this.invoiceCode = options.invoiceCode
-    this.metadata = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(options.metadata)
-    this.modified = options.modified || (new Date()).valueOf()
-    this.owner = options.owner
     this.paymentGatewayCode = options.paymentGatewayCode
     this.paymentResultRef = options.paymentResultRef
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
     this.status = this._Status.init(options.status)
-    this.tenantCode = options.tenantCode
     this.transactionCode = transaction_setCode(options, 'transactionCode')
   }
 
@@ -4174,22 +4161,6 @@ class Transaction {
       tenantCode: 'tenantCode'
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
   static get _classname() {
     return 'Transaction'
   }
@@ -4199,7 +4170,7 @@ class Transaction {
 
   // getters
   get isValid() {
-    return !!this.tenantCode
+    return super.isValid
   }
   get isActive() {
     return this.active === true
@@ -4338,9 +4309,6 @@ class Transaction {
   setFailed() {
     return this.status.setFailed()
   }
-  setModified() {
-    return this.modified = (new Date()).valueOf()
-  }
   setOnHold() {
     return this.status.setOnHold()
   }
@@ -4397,10 +4365,6 @@ class Transaction {
       if (transaction_updateAllowedProps.includes(key)) {
         if (key === 'amount') {
           this[key] = this._Amount.init(update[key])
-        } else if (key === 'metadata') {
-          this[key] = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(update[key])
-        } else if (key === 'remarks') {
-          this[key] = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(update[key])
         } else if (key === 'status') {
           this[key] = this._Status.init(update[key])
         // } else if (key === 'refundedAmount') {
@@ -4410,7 +4374,7 @@ class Transaction {
         }
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
   // updatePayment(payment = {}) {
   //   this.payments = Payment.updatePaymentItem(this.payments, payment)
@@ -4485,21 +4449,19 @@ class TransactionRepo extends q_utilities_namespaceObject.Repo {
 
 
 const invoice_updateAllowedProps = [
-  'active',
   'checkoutDateTime',
-  'deleted',
   'description',
   'invoiceDate',
   'issuer',
-  'metadata',
-  'remarks',
   'revisionNumber',
   'status'
 ]
 
-class Invoice {
+class Invoice extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options) {
     options = options || {}
+    super(options)
+
     const { _Amount, _Cart, _InvoiceLine, _Issuer, _Status, _Transaction } = options._constructor || {}
     this._Amount = _Amount && (_Amount._superclass === Amount._superclass) ? _Amount : Amount
     this._Cart = _Cart && (_Cart._superclass === Cart._superclass) ? _Cart : Cart
@@ -4515,25 +4477,16 @@ class Invoice {
     const id = options._id || options.id
     this.id = invoice_setId(id)
     this._type = options._type || 'Invoice'
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
     this.amount = this._Amount.init(options.amount)
     this.cartCode = options.cartCode
     this.checkoutDateTime = options.checkoutDateTime || (new Date()).valueOf()
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
-    this.deleted = options.deleted || false
     this.description = options.description
     this.invoiceCode = invoice_setCode(options, 'invoiceCode')
     this.invoiceDate = options.invoiceDate || (new Date()).valueOf()
     this.invoiceNumber = options.invoiceNumber
     this.issuer = this._Issuer.init(options.issuer)
-    this.metadata = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(options.metadata)
-    this.modified = options.modified || (new Date()).valueOf()
-    this.owner = options.owner
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
     this.revisionNumber = options.revisionNumber || 1
     this.status = this._Status.init(options.status)
-    this.tenantCode = options.tenantCode
   }
 
   static dummyData() {
@@ -4541,22 +4494,6 @@ class Invoice {
       tenantCode: 'tenantCode'
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
   static get _classname() {
     return 'Invoice'
   }
@@ -4565,7 +4502,7 @@ class Invoice {
   }
 
   get isValid() {
-    return !!this.tenantCode
+    return super.isValid
   }
   get cart() {
     return this._Cart.init(this._cart)
@@ -4638,7 +4575,9 @@ class Invoice {
   getAmount() {
     return this.amount
   }
-
+  getCode() {
+    return this.invoiceCode
+  }
   getCurrencyCode() {
     return this.amount ? this.amount.getCurrencyCode() : null
   }
@@ -4662,12 +4601,6 @@ class Invoice {
     }
     return this
   }
-
-  setModified() {
-    this.modified = (new Date()).valueOf()
-    return this
-  }
-
   setCompleted() {
     this.status.setCompleted()
     return this.setModified()
@@ -4681,12 +4614,8 @@ class Invoice {
   update(update) {
     Object.keys(update).forEach((key) => {
       if (invoice_updateAllowedProps.includes(key)) {
-        if (key === 'remarks') {
-          this[key] = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(update[key])
-        } else if (key === 'amount') {
+        if (key === 'amount') {
           this[key] = this._Amount.init(update[key])
-        } else if (key === 'metadata') {
-          this[key] = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(update[key])
         } else if (key === 'issuer') {
           this[key] = this._Issuer.init(update[key])
         } else if (key === 'status') {
@@ -4696,7 +4625,7 @@ class Invoice {
         }
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
 }
 
@@ -4751,40 +4680,33 @@ class InvoiceRepo extends q_utilities_namespaceObject.Repo {
 ;// ./lib/models/paymentGateway/paymentGateway.js
 
 
+
 const paymentGateway_updateAllowedProps = [
-  'active',
-  'deleted',
   'label',
   'logoUrl',
   'name',
-  'owner',
   'sandbox',
   'setting'
 ]
 
-
-class PaymentGateway {
+class PaymentGateway extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options = {}) {
     options = options || {}
+    super(options)
+
     const id = options._id || options.id
     this.id = paymentGateway_setId(id)
     this._type = options._type || 'PaymentGateway'
-    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
-    this.deleted = options.deleted || false
+
     this.hasWebhook = options.hasWebhook || false
     this.label = options.label
     this.logoUrl = options.logoUrl
-    this.modified = options.modified || (new Date()).valueOf()
     this.name = options.name || ''
-    this.owner = options.owner
     this.paymentGatewayCode = paymentGateway_setCode(options, 'paymentGatewayCode')
     this.paymentGatewayType = options.paymentGatewayType || 'PaymentGateway'
     this.paymentResultType = options.paymentResultType || 'PaymentResult'
     this.sandbox = options.sandbox || false
     this.setting = options.setting || null
-    this.tenantCode = options.tenantCode
   }
   static dummyData() {
     return {
@@ -4792,22 +4714,6 @@ class PaymentGateway {
       tenantCode: 'tenantCode'
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
   static get _classname() {
     return 'PaymentGateway'
   }
@@ -4817,7 +4723,7 @@ class PaymentGateway {
 
   // getters
   get isValid() {
-    return !!this.name && !!this.tenantCode
+    return super.isValid && !!this.name
   }
 
   // instance methods
@@ -4827,6 +4733,9 @@ class PaymentGateway {
   async getAppPayParams() {
     throw new Error(`${this._classname} subclass should implement getAppPayParams`)
   }
+  getCode() {
+    return this.paymentGatewayCode
+  }
   async updatePayment() {
     throw new Error(`${this._classname} subclass should implement updatePayment`)
   }
@@ -4840,18 +4749,13 @@ class PaymentGateway {
   setCompletedRelatedStatus(status) {
     throw new Error(`${this.name} subclass should implement setCompletedRelatedStatus`)
   }
-
-  setModified() {
-    this.modified = (new Date()).valueOf()
-    return this
-  }
   update(update) {
     Object.keys(update).forEach((key) => {
       if (paymentGateway_updateAllowedProps.includes(key)) {
         this[key] = update[key]
       }
     })
-    return this.setModified()
+    return super.update(update)
   }
 }
 
@@ -4912,9 +4816,11 @@ const paymentResult_updateAllowedProps = [
   'result'
 ]
 
-class PaymentResult {
+class PaymentResult extends q_utilities_namespaceObject.TenantAwareEntity {
   constructor(options = {}) {
     options = options || {}
+    super(options)
+
     const { _Transaction } = options._constructor || {}
     this._Transaction = _Transaction && (_Transaction._superclass === Transaction._superclass) ? _Transaction : Transaction
 
@@ -4923,20 +4829,12 @@ class PaymentResult {
 
     const id = options._id || options.id
     this.id = paymentResult_setId(id)
-    this.active = typeof options.active !== 'undefined' ? !!options.active : true
-    this.created = options.created || (new Date()).valueOf()
-    this.creator = options.creator
-    this.deleted = options.deleted || false
-    this.metadata = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(options.metadata)
-    this.modified = options.modified || (new Date()).valueOf()
-    this.owner = options.owner
+
     this.paymentResultCode = paymentResult_setCode(options, 'paymentResultCode')
     this.paymentResultType = options.paymentResultType || 'PaymentResult'
-    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
     this.result = options.result
     this.resultRef = options.resultRef
     this.resultType = options.resultType
-    this.tenantCode = options.tenantCode
     // this.transaction = this._Transaction.init(options.transaction)
     this.transactionCode = options.transactionCode
   }
@@ -4951,22 +4849,6 @@ class PaymentResult {
       transactionCode: 'transactionCode'
     }
   }
-  static init(options = {}) {
-    if (options instanceof this) {
-      return options
-    }
-    const instance = new this(options)
-    return instance.isValid ? instance : null
-  }
-  static initFromArray(arr = []) {
-    if (Array.isArray(arr)) {
-      return arr.map((a) => this.init(a))
-    }
-    return []
-  }
-  static initOnlyValidFromArray(arr = []) {
-    return this.initFromArray(arr).filter((i) => i)
-  }
   static get _classname() {
     return 'PaymentResult'
   }
@@ -4976,7 +4858,7 @@ class PaymentResult {
 
   // getters
   get isValid() {
-    return !!this.resultType && !!this.tenantCode && !!this.transactionCode
+    return super.isValid && !!this.resultType && !!this.transactionCode
     // return !!this.result && !!this.resultType && !!this.tenantCode
   }
   get amount() {
@@ -4986,7 +4868,7 @@ class PaymentResult {
     throw new Error(`${this._classname} subclass should implement get paymentMethod`)
   }
   get transaction() {
-    return this._transaction.init(this._transaction)
+    return this._Transaction.init(this._transaction)
   }
 
   // instance methods
@@ -5002,71 +4884,288 @@ class PaymentResult {
     return this
   }
 
-  compareStatus(paymentResult) {
-    throw new Error(`${this.paymentResultType} subclass should implement compareStatus`)
-  }
-  getPaidAmount() {
-    throw new Error(`${this.paymentResultType} subclass should implement getPaidAmount`)
-  }
-  getPaidTimestamp() {
-    throw new Error(
-      `${this.paymentResultType} subclass should implement getPaidTimestamp in milliseconds`
-    )
+  compareStatus(paymentResult) {
+    throw new Error(`${this.paymentResultType} subclass should implement compareStatus`)
+  }
+  getCode() {
+    return this.paymentResultCode
+  }
+  getPaidAmount() {
+    throw new Error(`${this.paymentResultType} subclass should implement getPaidAmount`)
+  }
+  getPaidTimestamp() {
+    throw new Error(
+      `${this.paymentResultType} subclass should implement getPaidTimestamp in milliseconds`
+    )
+  }
+  getPaymentCode() {
+    throw new Error(`${this.paymentResultType} subclass should implement getPaymentCode`)
+  }
+  getTransactionStatus() {
+    throw new Error(`${this.paymentResultType} subclass should implement getTransactionStatus`)
+  }
+  handlePayment(payment) {
+    if (!this.isForThisPayment(payment)) {
+      return { payment, err: new Error('the payment result is not for this payment') }
+    }
+    if (!this.isSameAmount(payment)) {
+      return { payment, err: new Error('the amount was not matched') }
+    }
+    try {
+      payment.settled()
+      payment
+        .setPaidAmount(this.getPaidAmount())
+        .setPaidTimestamp(this.getPaidTimestamp())
+        .setPaymentResultCode(this.paymentResultCode)
+      return { payment, err: null }
+    } catch (err) {
+      return { payment, err }
+    }
+  }
+  isForThisPayment(payment) {
+    return this.getPaymentCode() === payment.paymentCode
+  }
+  isSameAmount(payment) {
+    return this.getPaidAmount() === payment.getAmount()
+  }
+  isSuccess() {
+    throw new Error(`${this.paymentResultType} subclass should implement isSuccess`)
+  }
+  setupMetadata() {
+    const amount = this.amount
+    const paymentMethod = this.paymentMethod
+    q_utilities_namespaceObject.Metadata.addItem(this.metadata, 'AMOUNT', amount)
+    q_utilities_namespaceObject.Metadata.addItem(this.metadata, 'PAYMENT_METHOD', paymentMethod)
+    q_utilities_namespaceObject.KeyValueObject.addItem(this.remarks, 'amount', amount)
+    q_utilities_namespaceObject.KeyValueObject.addItem(this.remarks, 'paymentMethod', paymentMethod)
+    return this
+  }
+  setupRemarks() {
+    return this.setupMetadata()
+  }
+  update(update) {
+    Object.keys(update).forEach((key) => {
+      if (paymentResult_updateAllowedProps.includes(key)) {
+        this[key] = update[key]
+      }
+    })
+    return super.update(update)
+  }
+}
+
+function paymentResult_setCode(options, key) {
+  const copyOptions = options || {}
+  if (copyOptions[key]) {
+    return copyOptions[key]
+  }
+  return stringHelper.setCode()
+}
+
+function paymentResult_setId(id) {
+  if (id && typeof id.toString === 'function') {
+    return id.toString()
+  }
+  return id
+}
+
+
+
+;// ./lib/models/paymentResult/paymentResultRepo.js
+
+
+
+class PaymentResultRepo extends q_utilities_namespaceObject.Repo {
+  constructor(options = {}) {
+    options = options || {}
+    super(options)
+    const { _PaymentResult } = options._constructor || {}
+    this._PaymentResult = _PaymentResult && (_PaymentResult._superclass === PaymentResult._superclass) ? _PaymentResult : PaymentResult
+  }
+  static get _classname() {
+    return 'PaymentResultRepo'
+  }
+  init(options) {
+    return this._PaymentResult.init(options)
+  }
+}
+
+
+
+;// ./lib/models/paymentResult/index.js
+
+
+
+
+
+
+;// ./lib/models/status/index.js
+
+
+
+
+
+;// ./lib/models/storeItem/storeItem.js
+
+
+
+
+
+const storeItem_updateAllowedProps = [
+  'active',
+  'deleted',
+  'description',
+  'intangible',
+  'limitPercentage',
+  'lineOptions',
+  'maxPerWallet',
+  'name',
+  'originalStock',
+  'owner',
+  'productOptions',
+  'remarks',
+  'requiredStoreItemCode',
+  'stock'
+]
+
+class StoreItem {
+  constructor(options = {}) {
+    options = options || {}
+    const { _ItemOption } = options._constructor || {}
+    this._ItemOption = _ItemOption && (_ItemOption._superclass === ItemOption) ? _ItemOption : ItemOption
+
+    const id = options._id || options.id
+    this.id = storeItem_setId(id)
+    this._type = options._type || 'StoreItem'
+    this.active = (typeof options.active !== 'undefined') ? !!options.active : true
+    this.created = options.created || (new Date()).valueOf()
+    this.creator = options.creator
+    this.deleted = options.deleted || false
+    this.description = options.description || ''
+    this.intangible = options.intangible || false
+    this.limitPercentage = options.limitPercentage || 100
+    this.lineOptions = this._ItemOption.initOnlyValidFromArray(options.lineOptions)
+    this.maxPerWallet = options.maxPerWallet || 1
+    this.metadata = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(options.metadata)
+    this.modified = options.modified || (new Date()).valueOf()
+    this.name = options.name || ''
+    this.originalStock = options.originalStock || 0
+    this.owner = options.owner
+    this.productCode = storeItem_setCode(options, 'productCode')
+    this.productOptions = this._ItemOption.initOnlyValidFromArray(options.productOptions)
+    this.requiredStoreItemCode = options.requiredStoreItemCode
+    this.remarks = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(options.remarks)
+    this.stock = options.stock || 0
+    this.storeItemType = options.storeItemType || 'StoreItem'
+    this.tenantCode = options.tenantCode
+  }
+
+  // class method
+  static dummyData() {
+    return {
+      name: 'badge',
+      tenantCode: 'tenantCode'
+    }
+  }
+  static init(options = {}) {
+    if (options instanceof this) {
+      return options
+    }
+    const instance = new this(options)
+    return instance.isValid ? instance : null
+  }
+  static initFromArray(arr = []) {
+    if (Array.isArray(arr)) {
+      return arr.map((a) => this.init(a))
+    }
+    return []
+  }
+  static initOnlyValidFromArray(arr = []) {
+    return this.initFromArray(arr).filter((i) => i)
+  }
+  static get _classname() {
+    return 'StoreItem'
+  }
+  static get _superclass() {
+    return 'StoreItem'
+  }
+
+  // getters
+  get isValid() {
+    return !!this.tenantCode && !!this.name
+  }
+  get isReachedLimitPercentage() {
+    return this.soldPercentage >= this.limitPercentage
+  }
+  get soldPercentage() {
+    return ((this.originalStock - this.stock) / this.originalStock) * 100
+  }
+  get summary() {
+    return {
+      product: this,
+      productCode: this.productCode,
+      name: this.name,
+    }
+  }
+
+  // instance methods
+  ableToHave(qty) {
+    return this.maxPerWallet >= qty
+  }
+
+  checkStoreItemItemOptions(itemOptionFillIns = []) {
+    const copyItemOptionsFillIns = ItemOptionFillIn.getItemOptionFillInsByTarget({ itemOptionFillIns, target: 'StoreItem', targetCode: this.productCode })
+    return copyItemOptionsFillIns.reduce((acc, fillIn) => {
+      const key = fillIn.getKey()
+      const itemOption = this.getStoreItemOptionByKey(key)
+      if (!itemOption) {
+        acc.errMsgs.push(`options of the product(${this.productCode}) does not contain key: "${key}"`)
+        return acc
+      }
+      const isValid = itemOption.isValidFillInValue(fillIn.getValue())
+      if (!isValid) {
+        acc.errMsgs.push(`the product(${this.productCode}) option's(${key}) fillInValue is invalid`)
+      }
+      return acc
+    }, { errMsgs: [] })
   }
-  getPaymentCode() {
-    throw new Error(`${this.paymentResultType} subclass should implement getPaymentCode`)
+  getCode() {
+    return this.productCode
   }
-  getTransactionStatus() {
-    throw new Error(`${this.paymentResultType} subclass should implement getTransactionStatus`)
+  getMetadataValueByKey(key) {
+    return q_utilities_namespaceObject.Metadata.getValueByKey(this.metadata || [], key)
   }
-  handlePayment(payment) {
-    if (!this.isForThisPayment(payment)) {
-      return { payment, err: new Error('the payment result is not for this payment') }
-    }
-    if (!this.isSameAmount(payment)) {
-      return { payment, err: new Error('the amount was not matched') }
-    }
-    try {
-      payment.settled()
-      payment
-        .setPaidAmount(this.getPaidAmount())
-        .setPaidTimestamp(this.getPaidTimestamp())
-        .setPaymentResultCode(this.paymentResultCode)
-      return { payment, err: null }
-    } catch (err) {
-      return { payment, err }
+  getStoreItemOptionByKey(key) {
+    const arr = this._ItemOption.getByKey(this.productOptions, key)
+    if (arr.length === 1) {
+      return arr[0]
     }
+    return null
   }
-  isForThisPayment(payment) {
-    return this.getPaymentCode() === payment.paymentCode
+  hasStock(qty) {
+    return this.stock >= qty
   }
-  isSameAmount(payment) {
-    return this.getPaidAmount() === payment.getAmount()
+  isQualified(data) {
+    const rules = this.getMetadataValueByKey('RULES') || []
+    return (rules.length === 0)
+      ? true
+      : rules.reduce((acc, r) => {
+          return acc || (0,q_utilities_namespaceObject.getValidation)(r, data, storeItem_getDataByKey, q_utilities_namespaceObject.KeyValueObject)
+        }, false)
   }
-  isSuccess() {
-    throw new Error(`${this.paymentResultType} subclass should implement isSuccess`)
+  isTicket() {
+    return false
   }
   setModified() {
     this.modified = (new Date()).valueOf()
     return this
   }
-  setupMetadata() {
-    const amount = this.amount
-    const paymentMethod = this.paymentMethod
-    q_utilities_namespaceObject.Metadata.addItem(this.metadata, 'AMOUNT', amount)
-    q_utilities_namespaceObject.Metadata.addItem(this.metadata, 'PAYMENT_METHOD', paymentMethod)
-    q_utilities_namespaceObject.KeyValueObject.addItem(this.remarks, 'amount', amount)
-    q_utilities_namespaceObject.KeyValueObject.addItem(this.remarks, 'paymentMethod', paymentMethod)
-    return this
-  }
-  setupRemarks() {
-    return this.setupMetadata()
-  }
   update(update) {
     Object.keys(update).forEach((key) => {
-      if (paymentResult_updateAllowedProps.includes(key)) {
+      if (storeItem_updateAllowedProps.includes(key)) {
         if (key === 'metadata') {
           this[key] = q_utilities_namespaceObject.Metadata.initOnlyValidFromArray(update[key])
+        } else  if (key === 'productOptions') {
+          this[key] = this._ItemOption.initOnlyValidFromArray(update[key])
         } else if (key === 'remarks') {
           this[key] = q_utilities_namespaceObject.KeyValueObject.initOnlyValidFromArray(update[key])
         } else {
@@ -5078,58 +5177,35 @@ class PaymentResult {
   }
 }
 
-function paymentResult_setCode(options, key) {
-  const copyOptions = options || {}
-  if (copyOptions[key]) {
-    return copyOptions[key]
-  }
-  return stringHelper.setCode()
-}
-
-function paymentResult_setId(id) {
+function storeItem_setId(id) {
   if (id && typeof id.toString === 'function') {
     return id.toString()
   }
   return id
 }
 
-
-
-;// ./lib/models/paymentResult/paymentResultRepo.js
-
-
-
-class PaymentResultRepo extends q_utilities_namespaceObject.Repo {
-  constructor(options = {}) {
-    options = options || {}
-    super(options)
-    const { _PaymentResult } = options._constructor || {}
-    this._PaymentResult = _PaymentResult && (_PaymentResult._superclass === PaymentResult._superclass) ? _PaymentResult : PaymentResult
-  }
-  static get _classname() {
-    return 'PaymentResultRepo'
-  }
-  init(options) {
-    return this._PaymentResult.init(options)
+function storeItem_setCode(options, key) {
+  const copyOptions = options || {}
+  if (copyOptions[key]) {
+    return copyOptions[key]
   }
+  return stringHelper.setCode()
 }
 
-
-
-;// ./lib/models/paymentResult/index.js
-
-
+function storeItem_getDataByKey(key, data) {
+  return (0,q_utilities_namespaceObject.getValueByKeys)(key.split('.'), data)
+}
 
 
 
+;// ./lib/models/storeItem/index.js
 
-;// ./lib/models/status/index.js
 
 
 
+;// ./lib/models/index.js
 
 
-;// ./lib/models/index.js
 
 
 
@@ -5261,6 +5337,34 @@ class Chain {
 
 
 
+;// ./lib/helpers/calculateByCoupon/calculateCoupon.js
+
+function calculateByCoupon({ coupon, price }) {
+  const { couponDetails } = coupon
+  if (!couponDetails) {
+    return 0
+  }
+  const { type, item } = couponDetails
+  if (item) {
+    switch(type) {
+      case ('Percentage'): {
+        return _caculateByPercentage(price, couponDetails)
+      }
+      default: {
+        return 0
+      }
+    }
+  }
+}
+
+function _caculateByPercentage(price, couponDetails) {
+  const { value } = couponDetails
+  return price.value * (value / 100)
+}
+
+
+
+
 ;// ./lib/eventManager/chains/helpers.js
 
 
@@ -5269,6 +5373,7 @@ class Chain {
 
 
 
+
 ;// ./lib/eventManager/chains/chainCategoryLimit.js
 
 
@@ -5388,6 +5493,7 @@ class ChainGetPrice extends Chain {
         // }
       })
       cutEntitlements(lines, entitlements, this.currency.code)
+      // useCoupons(lines, this.currency.code)
       // getAmount()
       await this.next(chainTarget)
     } catch (err) {
@@ -5604,6 +5710,13 @@ function getStrategiesByRestrictions(prices, line, user) {
 }
 
 
+// function useCoupons(lines, currencyCode) {
+//   lines.forEach((line) => {
+
+//   })
+// }
+
+
 
 ;// ./lib/eventManager/chains/ChainGetPriceForGroup.js
 
@@ -5859,7 +5972,7 @@ class ChainMerchandiseLimit extends Chain {
         const stock = merchandise.getStock()
         if (stock === 0) {
           line.disabled = true
-          line.errors.push('Sold out.')
+          line.errors.push('Full.')
         } else {
           const { qty } = updatedItem
           updatedItem.qty = qty > stock ? stock : qty
@@ -5904,7 +6017,7 @@ class ChainProductLimit extends Chain {
           // const newRest = balance - ordered
           if (balance === 0) {
             updatedItem.qty = 0
-            line.errors.push(`"${name}" is out of stock`)
+            // line.errors.push(`"${name}" is out of stock`)
           } else {
             const ordered = (productQty * qty)
             const newBalance = balance - ordered
@@ -6048,22 +6161,141 @@ class ChainPurchaseOptions extends Chain {
             if (required && !value && !notFinishRequired) {
               notFinishRequired = true
               line.validated = false
-              line.errors.push('Need to fill in options.')
+              line.errors.push('Please fill in the option(s).')
             }
             if (validated && !notFinishValidated) {
               notFinishValidated = true
-              line.errors.push('Has not validated options.')
+              line.errors.push('Invalid option(s).')
             }
           })
         })
       })
       await this.next(chainTarget)
     } catch (err) {
-      chainTarget.addException('check product restriction fail', err.message)
+      chainTarget.addException('Check product restriction failed.', err.message)
+      this.exitChain()
+    }
+  }
+}
+
+
+
+;// ./lib/eventManager/chains/chainRelatedCoupons.js
+
+// import { WalletItem } from '../../models/walletItem/index.js'
+
+class ChainRelatedCoupons extends Chain {
+  constructor(options = {}) {
+    super(options)
+    this.autoUseCoupon = options.autoUseCoupon || false
+    this.currency = options.currency
+    this.walletItems = options.walletItems
+  }
+
+  async handleRequest(chainTarget) {
+    try {
+      const { lines, users } = chainTarget
+      // const walletItems = WalletItem.initOnlyValidFromArray(this.walletItems)
+      const couponWalletItems = this.walletItems.filter((i) => i.isCoupon)
+      lines.forEach((line) => {
+        _calculateAmountByCoupons({ line, currencyCode: this.currency.code })
+        _updateRelatedCoupons(line, couponWalletItems, this.autoUseCoupon, this.currency.code)
+      })
+      lines.forEach((line) => {
+        _getAvailableCoupons(line)
+      })
+      await this.next(chainTarget)
+    } catch (err) {
+      chainTarget.addException('calculate categories limit fail', err.message)
       this.exitChain()
     }
   }
 }
+function _calculateAmountByCoupons({ line, currencyCode }) {
+  const { usedCoupons = {}, updatedItem } = line
+  Object.keys(usedCoupons).forEach((key) => {
+    usedCoupons[key].forEach((coupon) => {
+      const obj = _calculateAmountByOneCoupon({ updatedItem, coupon, currencyCode })
+      Object.assign(updatedItem, obj)
+    })
+  })
+}
+
+function _calculateAmountByOneCoupon({ updatedItem, coupon, currencyCode }) {
+  const { couponDetails, walletItemCode } = coupon
+  if (!couponDetails) {
+    return updatedItem
+  }
+  const { price, qty, discount, remarks, subTotal } = updatedItem
+  const _discount = calculateByCoupon({ coupon, price })
+  const discountValue = _discount + discount.value
+  const subTotalValue = subTotal.value > _discount ? subTotal.value - _discount : 0
+  const _usedCoupons = q_utilities_namespaceObject.KeyValueObject.foundValueByKey(remarks, 'USED_ITEM_COUPONS') || []
+  _usedCoupons.push(walletItemCode)
+  return {
+    ...updatedItem,
+    discount: Amount.init({ value: discountValue, currencyCode }),
+    remarks: q_utilities_namespaceObject.KeyValueObject.insertOrUpdateRecord(remarks, 'USED_ITEM_COUPONS', _usedCoupons ),
+    subTotal: Amount.init({ value: subTotalValue, currencyCode })
+  }
+}
+
+
+function _getAvailableCoupons(line) {
+  const { relatedCoupons = [] } = line
+  line.relatedCoupons = relatedCoupons.map((c) => ({
+    ...c,
+    availableCoupons: c.coupons.filter((_c) => (!_c.isOnHold))
+  }))
+}
+
+function _getRelatedCoupons(cartItemLine, couponWalletItems, autoUseCoupon, currencyCode) {
+  const { merchandise, usedCoupons = {}, updatedItem = {} } = cartItemLine
+  const relatedWalletItems = couponWalletItems.filter(
+    item => item.isApplicableCoupon(merchandise) && item.isItemCoupon
+  )
+  // .sort((a, b) => (
+  //   b.couponDetails.value - a.couponDetails.value
+  // ))
+  return relatedWalletItems.reduce((acc, w) => {
+    const productCode = w.product.productCode
+    let exist = acc.find((i) => i.productCode === productCode)
+    const isOnHold = w.isOnHold // max? || only use One Coupon?
+    if (!exist) {
+      exist = {
+        coupons: [],
+        product: w.product,
+        productCode: productCode,
+        usedQty: (usedCoupons[productCode] || []).length
+      }
+      acc.push(exist)
+    }
+    exist.coupons.push(w)
+    const { qty: itemQty, subTotal } = updatedItem
+    if (autoUseCoupon && !isOnHold && exist.usedQty < itemQty && subTotal.value > 0) {
+      // use coupon
+      w.setOnHold()
+      usedCoupons[productCode] = [
+        ...usedCoupons[productCode] || [],
+        w
+      ]
+      const obj = _calculateAmountByOneCoupon({ updatedItem, currencyCode, coupon: w })
+      Object.assign(updatedItem, obj)
+      exist.usedQty = usedCoupons[productCode].length
+    }
+    return acc
+  }, [])
+}
+
+
+function _updateRelatedCoupons(line, couponWalletItems, autoUseCoupon, currencyCode) {
+  if (couponWalletItems.length > 0) {
+    line.relatedCoupons = _getRelatedCoupons(line, couponWalletItems, autoUseCoupon, currencyCode)
+  }
+}
+
+
+
 
 
 
@@ -6079,6 +6311,7 @@ class ChainPurchaseOptions extends Chain {
 
 
 
+
 ;// ./lib/helpers/corHelper/chainException.js
 
 class ChainException {
@@ -6340,6 +6573,7 @@ class ChainManagerFactory {
 
 function _calculateAmountChainsFactory(payload) {
   const {
+    autoUseCoupon,
     categories,
     currency,
     dateTime,
@@ -6363,6 +6597,7 @@ function _calculateAmountChainsFactory(payload) {
     new ChainGetPrice({
       currency, dateTime, entitlements, merchandises
     }),
+    new ChainRelatedCoupons({ currency, autoUseCoupon, walletItems }),
   ]
 }
 
@@ -6504,6 +6739,11 @@ function getFakeClass() {
 
 
 
+;// ./lib/helpers/calculateByCoupon/index.js
+
+
+
+
 ;// ./lib/helpers/corHelper/index.js
 
 
@@ -6511,6 +6751,150 @@ function getFakeClass() {
 
 
 
+;// ./lib/helpers/getRolesChangesRelatedCouponsHelper/getRolesChangesRelatedCouponsHelper.js
+function getRolesChangesRelatedCouponsHelper({ newRoles, originalRoles }) {
+  const couponFromNewRoles = _getCouponsByRoles(newRoles)
+  const couponFromOriginalRoles = _getCouponsByRoles(originalRoles)
+  const allKeys = new Set([
+    ...Object.keys(couponFromNewRoles),
+    ...Object.keys(couponFromOriginalRoles)
+  ])
+  return Array.from(allKeys).reduce((acc, key) => {
+    const newValue = couponFromNewRoles[key] || 0;
+    const originalValue = couponFromOriginalRoles[key] || 0;
+    const delta = newValue - originalValue;
+    if (delta !== 0) {
+      acc.push({
+        key,
+        value: {
+          delta,
+          newValue,
+          originalValue
+        }
+      });
+    }
+    return acc
+  }, [])
+}
+
+
+function _getCouponsByRoles(roles) {
+  return roles.reduce((acc, role) => {
+    const couponCodes = role.getCouponCodes()
+    couponCodes.forEach((c) => {
+      const { key, value } = c
+      acc[key] = acc[key] ? acc[key] + value : value
+    })
+    return acc
+  }, {})
+}
+
+
+
+;// ./lib/helpers/couponManager/couponManager.js
+
+
+
+
+class CouponManager {
+  constructor(options) {
+    this.products = options.products || []
+    this.walletItems = options.walletItems || []
+    this.originalRoles = options.originalRoles || []
+    this.newRoles = options.newRoles || []
+  }
+
+  static init(options = {}) {
+    if (options instanceof this) {
+      return options
+    }
+    const instance = new this(options)
+    return instance.isValid ? instance : null
+  }
+
+  get isValid() {
+    return !!this
+  }
+
+  get couponProducts() {
+    return this.products.filter((p) => p.isCoupon)
+  }
+
+  get couponWalletItems() {
+    return this.walletItems.filter((w) => w.isCoupon)
+  }
+
+  get roleRelatedCoupons() {
+    return getRolesChangesRelatedCouponsHelper({ newRoles: this.newRoles, originalRoles: this.originalRoles })
+  }
+
+
+  get couponItemList() {
+    return this.couponProducts.map((p) => {
+      const relatedWalletItems = this.walletItems.filter(
+        item => item.productCode === p.productCode
+      )
+
+      const usedCoupons = relatedWalletItems.filter(item => item.isUsed)
+      usedCoupons.forEach((c) => {
+        c.useForWalletItems = this.walletItems.filter((item) => (c.useFor || []).includes(item.walletItemCode)) // useFor
+      })
+
+      const availableCoupons = relatedWalletItems.filter(item => !item.isAvailableCoupon)
+
+      const roleBase = q_utilities_namespaceObject.KeyValueObject.foundValueByKey(this.roleRelatedCoupons, p.productCode) || {}
+
+      const remainingQuota = p.maxPerWallet - (usedCoupons.length + availableCoupons.length)
+
+      const { qty, remarks } = _handler({ product: p, availableCoupons, roleBase, remainingQuota })
+
+      return {
+        product: p,
+        usedCoupons,
+        availableCoupons,
+        alreadyHave: usedCoupons.length + availableCoupons.length,
+        maxLimit: p.maxPerWallet,
+        remainingQuota,
+        qty,
+        roleBase,
+        remarks
+      };
+    })
+  }
+
+  setNewRoles() {
+    this.newRoles = newRoles
+  }
+
+}
+
+
+
+
+function _handler({ product, remainingQuota, availableCoupons, roleBase }) {
+  const { delta = 0 } = roleBase
+  const { maxPerWallet } = product
+  let qty = delta
+  const remarks = []
+  if (delta > 0 && maxPerWallet && delta > remainingQuota) {
+    qty = 0
+    remarks.push(`max ${maxPerWallet}`)
+  }
+  if (delta < 0 && maxPerWallet && availableCoupons.length < delta) {
+    qty = availableCoupons.length
+    remarks.push(`only ${availableCoupons.length} could be cancelled`)
+  }
+  return {
+    qty,
+    remarks
+  }
+}
+
+;// ./lib/helpers/couponManager/index.js
+
+
+
+
 ;// ./lib/helpers/dateHelper/handler/handler.js
 class Handler {
   constructor(date) {
@@ -6638,7 +7022,11 @@ function createDate(timestamp) {
     const mthIdx = Number(mthStr) - 1
     return new Date(timestamp.slice(0, 4), mthIdx, timestamp.slice(6, 8))
   }
-  throw new Error('timestamp does not meet the requirements')
+  try {
+    return new Date(timestamp)
+  } catch (e) {
+    throw new Error('timestamp does not meet the requirements')
+  }
 }
 
 function convert(date, dateFormat) {
@@ -6907,6 +7295,8 @@ function isDescendingOrder({ arr = [], key }) {
 
 
 
+
+
 ;// ./lib/index.js
 
 const models = models_namespaceObject