@questwork/q-utilities 0.1.19 → 0.1.21

package/dist/q-utilities.min.js

@@ -48,6 +48,7 @@ __webpack_require__.r(__webpack_exports__);
 
 // EXPORTS
 __webpack_require__.d(__webpack_exports__, {
+  ActionRecord: () => (/* reexport */ ActionRecord),
   ApiResponse: () => (/* reexport */ ApiResponse),
   AwsStsS3Client: () => (/* reexport */ AwsStsS3Client),
   KeyValueObject: () => (/* reexport */ KeyValueObject),
@@ -56,6 +57,8 @@ __webpack_require__.d(__webpack_exports__, {
   QMeta: () => (/* reexport */ QMeta),
   Repo: () => (/* reexport */ Repo),
   Service: () => (/* reexport */ Service),
+  Status: () => (/* reexport */ Status),
+  StatusDocument: () => (/* reexport */ StatusDocument),
   TemplateCompiler: () => (/* reexport */ TemplateCompiler),
   TenantAwareEntity: () => (/* reexport */ TenantAwareEntity),
   TrackedEntity: () => (/* reexport */ TrackedEntity),
@@ -65,6 +68,7 @@ __webpack_require__.d(__webpack_exports__, {
   changeCreatorOwner: () => (/* reexport */ changeCreatorOwner),
   concatStringByArray: () => (/* reexport */ concatStringByArray),
   convertString: () => (/* reexport */ convertString),
+  detectControlCharacters: () => (/* reexport */ detectControlCharacters),
   escapeRegex: () => (/* reexport */ escapeRegex),
   expressHelper: () => (/* reexport */ expressHelper),
   extractEmails: () => (/* reexport */ extractEmails),
@@ -76,12 +80,14 @@ __webpack_require__.d(__webpack_exports__, {
   init: () => (/* reexport */ init),
   initFromArray: () => (/* reexport */ initFromArray),
   initOnlyValidFromArray: () => (/* reexport */ initOnlyValidFromArray),
+  isConvertibleToNumber: () => (/* reexport */ isConvertibleToNumber),
   makeApiResponse: () => (/* reexport */ makeApiResponse),
   makeService: () => (/* reexport */ makeService),
   mergeArraysByKey: () => (/* reexport */ mergeArraysByKey),
   objectHelper: () => (/* reexport */ objectHelper),
   pReduce: () => (/* reexport */ pReduce),
   padZeros: () => (/* reexport */ padZeros),
+  printControlCharReport: () => (/* reexport */ printControlCharReport),
   replacePlaceholders: () => (/* reexport */ replacePlaceholders),
   sanitizeText: () => (/* reexport */ sanitizeText),
   shuffleArray: () => (/* reexport */ shuffleArray),
@@ -116,14 +122,14 @@ function authorize({ allowCoordinator, allowOwner, query = {}, required, user })
     if (query.registrationGroupCode && user.myManagedRegistrationGroupCodes.includes(query.registrationGroupCode)) {
       query.__ALLOW_COORDINATOR = true
     } else {
-        if (!scopes.includes('EVENT')) {
-          query.eventRegistrationCode = user.eventRegistrationCode
-        }
-    }
-  } else {
       if (!scopes.includes('EVENT')) {
         query.eventRegistrationCode = user.eventRegistrationCode
       }
+    }
+  } else {
+    if (!scopes.includes('EVENT')) {
+      query.eventRegistrationCode = user.eventRegistrationCode
+    }
   }
   if (allowOwner) {
     query.__ALLOW_OWNER = true
@@ -155,14 +161,14 @@ function calculateAge(timestamp, reference) {
   }
 
   // Calculate raw difference
-  let age = refDate.getFullYear() - birthDate.getFullYear();
-  const monthDiff = refDate.getMonth() - birthDate.getMonth();
-  
+  let age = refDate.getFullYear() - birthDate.getFullYear()
+  const monthDiff = refDate.getMonth() - birthDate.getMonth()
+
   // Adjust if birthday hasn't occurred yet this year
   if (monthDiff < 0 || (monthDiff === 0 && refDate.getDate() < birthDate.getDate())) {
     age--
   }
-  
+
   return age
 }
 
@@ -192,7 +198,18 @@ function changeCreatorOwner(that, { source, target }) {
 ;// ./lib/helpers/changeCreatorOwner/index.js
 
 
+;// ./lib/helpers/isConvertibleToNumber/isConvertibleToNumber.js
+function isConvertibleToNumber(value) {
+  return value !== null
+    && value !== undefined
+    && typeof value !== 'boolean'
+    && String(value).trim() !== ''
+    && !isNaN(Number(value))
+}
+
 ;// ./lib/helpers/getValidation/getValidation.js
+
+
 function getValidation(rule, data, getDataByKey, KeyValueObject) {
   if (!rule) {
     return true
@@ -206,10 +223,10 @@ function getValidation(rule, data, getDataByKey, KeyValueObject) {
   if (!key && typeof placeholder === 'undefined') {
     switch (valueAttribute) {
       case '$and': {
-        return value['$and'].reduce((acc, item) => (acc && getValidation(item, data, getDataByKey, KeyValueObject)), true)
+        return value.$and.reduce((acc, item) => (acc && getValidation(item, data, getDataByKey, KeyValueObject)), true)
       }
       case '$or': {
-        return value['$or'].reduce((acc, item) => (acc || getValidation(item, data, getDataByKey, KeyValueObject)), false)
+        return value.$or.reduce((acc, item) => (acc || getValidation(item, data, getDataByKey, KeyValueObject)), false)
       }
       default:
         return false
@@ -224,39 +241,53 @@ function getValidation(rule, data, getDataByKey, KeyValueObject) {
   }
 
   switch (valueAttribute) {
+    case '$after': {
+      if (isConvertibleToNumber(value?.$after)) {
+        const _value = Number(String(value?.$after))
+        return Date.now() > _value
+      }
+      return false
+    }
+    case '$before': {
+      if (isConvertibleToNumber(value?.$before)) {
+        const _value = Number(String(value?.$before))
+        return Date.now() < _value
+      }
+      return false
+    }
     case '$empty': {
       const isEmpty = rowValue === null || rowValue === undefined
-      return isEmpty === value['$empty']
+      return isEmpty === value.$empty
     }
     case '$eq': {
-      return rowValue === value['$eq']
+      return rowValue === value.$eq
     }
     case '$gt': {
-      return rowValue > value['$gt']
+      return rowValue > value.$gt
     }
     case '$gte': {
-      return rowValue >= value['$gte']
+      return rowValue >= value.$gte
     }
     case '$hasOverlap': {
-      return _hasOverlap(rowValue, value['$hasOverlap'])
+      return _hasOverlap(rowValue, value.$hasOverlap)
     }
     case '$lt': {
-      return rowValue < value['$lt']
+      return rowValue < value.$lt
     }
     case '$lte': {
-      return rowValue <= value['$lte']
+      return rowValue <= value.$lte
     }
     case '$in': {
       if (Array.isArray(rowValue)) {
-        return !!rowValue.find((e) => (value['$in'].includes(e)))
+        return !!rowValue.find((e) => (value.$in.includes(e)))
       }
       if (typeof rowValue !== 'object') {
-        return !!value['$in'].includes(rowValue)
+        return !!value.$in.includes(rowValue)
       }
       return false
     }
     case '$inValue': {
-      const result = getDataByKey(value['$inValue'], data)
+      const result = getDataByKey(value.$inValue, data)
       const _value = Array.isArray(result) ? result : []
       if (Array.isArray(rowValue)) {
         return !!rowValue.find((e) => (_value.includes(e)))
@@ -267,36 +298,36 @@ function getValidation(rule, data, getDataByKey, KeyValueObject) {
       return false
     }
     case '$ne': {
-      return rowValue !== value['$ne']
+      return rowValue !== value.$ne
     }
     case '$notIn': {
       if (Array.isArray(rowValue)) {
-        return !rowValue.find((e) => (value['$notIn'].includes(e)))
+        return !rowValue.find((e) => (value.$notIn.includes(e)))
       }
       if (typeof rowValue !== 'object') {
-        return !value['$notIn'].includes(rowValue)
+        return !value.$notIn.includes(rowValue)
       }
       return false
     }
     case '$intervalTimeGt': {
       const now = new Date().getTime()
       const timestamp = new Date(rowValue).getTime()
-      return (now - timestamp) > value['$intervalTimeGt']
+      return (now - timestamp) > value.$intervalTimeGt
     }
     case '$intervalTimeLt': {
       const now = new Date().getTime()
       const timestamp = new Date(rowValue).getTime()
-      return (now - timestamp) < value['$intervalTimeLt']
+      return (now - timestamp) < value.$intervalTimeLt
     }
     case '$isToday': {
       const currentDate = new Date()
-      const start = currentDate.setHours(0,0,0,0)
-      const end = currentDate.setHours(23,59,59,59)
+      const start = currentDate.setHours(0, 0, 0, 0)
+      const end = currentDate.setHours(23, 59, 59, 59)
       const dateValue = new Date(rowValue).getTime()
-      return (start <= dateValue && end >= dateValue) === value['$isToday']
+      return (start <= dateValue && end >= dateValue) === value.$isToday
     }
     case '$notInValue': {
-      const result = getDataByKey(value['$notInValue'], data)
+      const result = getDataByKey(value.$notInValue, data)
       const _value = Array.isArray(result) ? result : []
       if (Array.isArray(rowValue)) {
         return !rowValue.find((e) => (_value.includes(e)))
@@ -307,7 +338,7 @@ function getValidation(rule, data, getDataByKey, KeyValueObject) {
       return false
     }
     case '$range': {
-      const [min, max] = value['$range']
+      const [min, max] = value.$range
       if (typeof min === 'number' && typeof max === 'number' && rowValue >= min && rowValue <= max) {
         return true
       }
@@ -316,7 +347,6 @@ function getValidation(rule, data, getDataByKey, KeyValueObject) {
     default:
       return false
   }
-
 }
 
 function _hasOverlap(item1, item2) {
@@ -341,12 +371,11 @@ function _hasOverlap(item1, item2) {
 
 
 ;// ./lib/helpers/formatDate/formatDate.js
-
 function formatDate(date, format) {
   const _date = date && date instanceof Date ? date : new Date(date)
-  const dayMapChi = ['日','一','二','三','四','五','六']
-  const dayMapEng = ['Sunday','Monday','Tuesday','Wednesday','Thursday','Friday','Saturday']
-  const dayMapEngShort = ['Sun','Mon','Tue','Wed','Thu','Fri','Sat']
+  const dayMapChi = ['日', '一', '二', '三', '四', '五', '六']
+  const dayMapEng = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday']
+  const dayMapEngShort = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat']
   const _format = format || 'YYYY/MM/DD hh:mm'
   const e = _date.getDay()
   const ee = dayMapEngShort[e]
@@ -381,13 +410,11 @@ function padding(m) {
   return m < 10 ? `0${m}` : m
 }
 
-
 /* harmony default export */ const formatDate_formatDate = ({
   formatDate
 });
 
 
-
 ;// ./lib/helpers/formatDate/index.js
 
 
@@ -418,7 +445,6 @@ function getValueByKeys_getValueByKeys(keys, data) {
     return _data[firstKey]
   }
   return _data
-
 }
 /* harmony default export */ const getValueByKeys = ({
   getValueByKeys: getValueByKeys_getValueByKeys
@@ -470,6 +496,7 @@ const _FN_NAMES = [
   'map',
   'neq',
   'removeHtml',
+  'sum',
   'toLowerCase',
   'toUpperCase',
 ]
@@ -622,10 +649,12 @@ function _existObject(data, args) {
 
 function _performOperation(arg, value) {
   // the arg is undefined
-  if (arg === undefined && value === undefined) return true
+  if (arg === undefined && value === undefined)
+    return true
 
   // the arg is null
-  if (arg === null && value === null) return true
+  if (arg === null && value === null)
+    return true
 
   // the arg is boolean
   if (typeof arg === 'boolean') {
@@ -701,17 +730,18 @@ function _splitOperator(str) {
   const operators = ['!=', '>=', '<=', '>', '<']
 
   const matchedOp = operators.find((op) => str.startsWith(op))
-  if (!matchedOp) return { operator: null, value: null }
+  if (!matchedOp)
+    return { operator: null, value: null }
 
   const remaining = str.slice(matchedOp.length)
 
   // '>Primary' or '<Primary' is invalid
-  if (/^[a-zA-Z]*$/.test(remaining) && matchedOp !== '!=') {
+  if (/^[a-z]*$/i.test(remaining) && matchedOp !== '!=') {
     return { operator: null, value: null }
   }
 
   // if it is a number it is converted to a number
-  const value = (!Number.isNaN(parseFloat(remaining)) && !Number.isNaN(remaining)) ? Number(remaining) : remaining
+  const value = (!Number.isNaN(Number.parseFloat(remaining)) && !Number.isNaN(remaining)) ? Number(remaining) : remaining
 
   return {
     operator: matchedOp,
@@ -923,11 +953,14 @@ function _isNotEmpty(data, args) {
 }
 
 
+
 ;// ./lib/models/templateCompiler/helpers/_join.js
 function _join(data, delimiter) {
   try {
-    if (data.length === 0) return ''
-    if (data.length === 1) return _stringifyObject(data[0])
+    if (data.length === 0)
+      return ''
+    if (data.length === 1)
+      return _stringifyObject(data[0])
     return data.map((item) => _stringifyObject(item)).join(delimiter)
   } catch (e) {
     throw e
@@ -1074,13 +1107,13 @@ function _removeHtml(html, args) {
 
 function _htmlToPlainText(html, delimiter = '\n') {
   if (typeof delimiter !== 'string') {
-    delimiter = '\n'; // Fallback to default if not a string
+    delimiter = '\n' // Fallback to default if not a string
   }
 
   // First decode HTML entities and normalize whitespace
   const decodedHtml = html
     .replace(/&nbsp;/g, ' ')
-    .replace(/\s+/g, ' ');  // Collapse all whitespace to single spaces
+    .replace(/\s+/g, ' ') // Collapse all whitespace to single spaces
 
   // Process HTML tags
   let text = decodedHtml
@@ -1091,29 +1124,36 @@ function _htmlToPlainText(html, delimiter = '\n') {
     // Remove all other tags
     .replace(/<[^>]+>/g, '')
     // Convert markers to specified delimiter
-    .replace(/~~~+/g, delimiter)
+    .replace(/~{3,}/g, delimiter)
     // Trim and clean whitespace
-    .trim();
+    .trim()
 
   // Special handling for empty delimiter
   if (delimiter === '') {
     // Collapse all whitespace to single space
-    text = text.replace(/\s+/g, ' ');
+    text = text.replace(/\s+/g, ' ')
   } else {
-
-
     // Collapse multiple delimiters to single
-    text = text.replace(new RegExp(`${escapeRegExp(delimiter)}+`, 'g'), delimiter);
+    text = text.replace(new RegExp(`${escapeRegExp(delimiter)}+`, 'g'), delimiter)
     // Remove leading/trailing delimiters
-    text = text.replace(new RegExp(`^${escapeRegExp(delimiter)}|${escapeRegExp(delimiter)}$`, 'g'), '');
+    text = text.replace(new RegExp(`^${escapeRegExp(delimiter)}|${escapeRegExp(delimiter)}$`, 'g'), '')
   }
 
-  return text;
+  return text
 }
 
-
 function escapeRegExp(string) {
-  return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+
+
+;// ./lib/models/templateCompiler/helpers/_sum.js
+function _sum(data, args) {
+  if (Number.isNaN(data) || data === null || (typeof data === 'undefined') || data === '') {
+    return data
+  }
+  return args.reduce((acc, e) => (acc + e), data)
 }
 
 
@@ -1173,6 +1213,7 @@ function _toUpperCase(data, args) {
 
 
 
+
 
 
 ;// ./lib/models/templateCompiler/templateCompiler.js
@@ -1246,6 +1287,9 @@ class TemplateCompiler {
   static removeHtml(data, args) {
     return _removeHtml(data, args)
   }
+  static sum(data, args) {
+    return _sum(data, args)
+  }
   static toLowerCase(data, args) {
     return _toLowerCase(data, args)
   }
@@ -1306,7 +1350,7 @@ function _parseFunction(expression, existFunctionNames) {
 
 function _parseParams(parameters) {
   const _parameters = parameters.trim()
-  const regExp = new RegExp(/^[^\w\d\s]+$/)
+  const regExp = new RegExp(/^[^\w\s]+$/)
   const match = _parameters.match(regExp)
   if (match !== null) {
     return [_parameters.substring(1, _parameters.length - 1)]
@@ -1321,13 +1365,13 @@ function _parseParams(parameters) {
 
 function _splitIgnoringBrackets(input) {
   const regExp2 = new RegExp(/^\d+(\.\d+)?$/)
-  const regExp = new RegExp(/(?![^\[]*\])\s*,\s*/)
+  const regExp = new RegExp(/(?![^[]*\])\s*,\s*/)
   const parts = input.split(regExp)
   return parts.map((part) => {
     const _part = part.trim()
     if (_part !== '' && !!_part.match(regExp2)) {
       // 如果是数字，转换为 num 类型
-      return Number.isNaN(_part) ? _part : parseInt(_part, 10)
+      return Number.isNaN(_part) ? _part : Number.parseInt(_part, 10)
     }
     // 否则当作字符串处理
     return _part
@@ -1340,7 +1384,7 @@ function _parseSinglePart(input) {
       // 去掉双引号，返回
       return input.substring(1, input.length - 1)
     }
-    if (input.startsWith("'") && input.endsWith("'")) {
+    if (input.startsWith('\'') && input.endsWith('\'')) {
       // 去掉双引号，返回
       return input.substring(1, input.length - 1)
     }
@@ -1371,7 +1415,7 @@ function _toBasicType(input) {
     // 去掉双引号，返回
     return input.substring(1, input.length - 1)
   }
-  if (input.startsWith("'") && input.endsWith("'")) {
+  if (input.startsWith('\'') && input.endsWith('\'')) {
     // 去掉双引号，返回
     return input.substring(1, input.length - 1)
   }
@@ -1439,6 +1483,8 @@ function _callFunction(data, functionName, parameters) {
         return _neq(data, parameters)
       case 'removeHtml':
         return _removeHtml(data, parameters)
+      case 'sum':
+        return _sum(data, parameters)
       case 'toLowerCase':
         return _toLowerCase(data)
       case 'toUpperCase':
@@ -1468,14 +1514,14 @@ function concatStringByArray(arrTemplate, data) {
   return arrTemplate.reduce((acc, item) => {
     const { type, value = '', restriction, template, format, showMinutes } = item
     switch (type) {
-      case('array'): {
+      case ('array'): {
         if (getValidation(restriction, data, getValueByKeys_getValueByKeys)) {
           const _value = getValueByKeys_getValueByKeys(value.split('.'), data) || []
           acc += _value.reduce((_acc, item) => {
             return _acc += concatStringByArray(template, item)
           }, '')
         }
-        break 
+        break
       }
       case ('date'): {
         if (getValidation(restriction, data, getValueByKeys_getValueByKeys)) {
@@ -1484,7 +1530,7 @@ function concatStringByArray(arrTemplate, data) {
         }
         break
       }
-      case('ellipsis'): {
+      case ('ellipsis'): {
         if (getValidation(restriction, data, getValueByKeys_getValueByKeys)) {
           const { maxLength } = item
           const _value = getValueByKeys_getValueByKeys(value.split('.'), data) || ''
@@ -1494,15 +1540,15 @@ function concatStringByArray(arrTemplate, data) {
             acc += `${_value.substr(0, maxLength)}...`
           }
         }
-        break 
+        break
       }
-      case('group'): {
+      case ('group'): {
         if (getValidation(restriction, data, getValueByKeys_getValueByKeys)) {
           return concatStringByArray(value, data)
         }
         break
       }
-      case('label'): {
+      case ('label'): {
         if (getValidation(restriction, data, getValueByKeys_getValueByKeys)) {
           acc += (value.toString())
         }
@@ -1515,12 +1561,12 @@ function concatStringByArray(arrTemplate, data) {
         }
         break
       }
-      case('value'): {
+      case ('value'): {
         if (getValidation(restriction, data, getValueByKeys_getValueByKeys)) {
           const _value = getValueByKeys_getValueByKeys(value.split('.'), data) || ''
           acc += (_value.toString())
         }
-        break 
+        break
       }
     }
     return acc
@@ -1531,7 +1577,6 @@ function concatStringByArray(arrTemplate, data) {
 });
 
 
-
 ;// ./lib/helpers/concatStringByArray/index.js
 
 
@@ -1542,7 +1587,7 @@ function convertString(string, patternMatch = /\$\{(.+?)\}/g, value, getValueByK
   if (!string) {
     return ''
   }
-  let _getValueByKeys = typeof getValueByKeys === 'function' ? getValueByKeys : getValueByKeys_getValueByKeys
+  const _getValueByKeys = typeof getValueByKeys === 'function' ? getValueByKeys : getValueByKeys_getValueByKeys
   const reg = new RegExp(patternMatch, 'g')
   return string.replace(reg, (match, key) => {
     const result = _getValueByKeys({ keys: key.split('.'), obj: value })
@@ -1561,9 +1606,110 @@ function convertString(string, patternMatch = /\$\{(.+?)\}/g, value, getValueByK
 ;// ./lib/helpers/convertString/index.js
 
 
+;// ./lib/helpers/detectControlCharacters/detectControlCharacters.js
+/**
+ * Detects and reports hidden/control characters in a string without modifying it.
+ * @param {string} input - The string to analyze.
+ * @param {Object} [options] - Configuration options.
+ * @param {boolean} [options.preserveBasicWhitespace=true] - Whether to consider basic whitespace as valid.
+ * @returns {Object} Report object with detection results.
+ */
+function detectControlCharacters(input, options = {}) {
+  const {
+    preserveBasicWhitespace = true,
+    removeNewlines = false
+  } = options
+
+  if (typeof input !== 'string') {
+    return {
+      hasControlChars: false,
+      matches: [],
+      inputType: typeof input,
+      message: 'Input is not a string'
+    }
+  }
+
+  const matches = []
+  let regex
+
+  if (preserveBasicWhitespace && !removeNewlines) {
+    // Same regex as Phase 1 preserve mode - keep tab (\t), newline (\n), carriage return (\r)
+    regex = /[\x00-\x08\x0B\x0C\x0E-\x1F\x7F-\x9F\u200B-\u200D\uFEFF\u202A-\u202E]/g
+  } else {
+    // Same regex as Phase 1 full removal mode - use consistent escape sequences
+    regex = /[\x00-\x1F\x7F-\x9F\u200B-\u200D\uFEFF\u202A-\u202E]/g
+  }
+
+  // Use a replacer function to capture matches without modifying the string
+  input.replace(regex, (match, offset) => {
+    matches.push({
+      character: match,
+      code: match.charCodeAt(0),
+      hex: '0x' + match.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0'),
+      position: offset,
+      context: getContext(input, offset, 10) // Show surrounding text
+    })
+    return '' // Return empty but we don't use the result
+  })
+
+  return {
+    hasControlChars: matches.length > 0,
+    matches: matches,
+    totalFound: matches.length,
+    inputPreview: input.length > 50 ? input.substring(0, 50) + '...' : input,
+    inputLength: input.length,
+    optionsUsed: { preserveBasicWhitespace },
+    regexPattern: regex.toString()
+  }
+}
+
+/**
+ * Helper function to get context around a match
+ */
+function getContext(str, position, contextLength = 10) {
+  const start = Math.max(0, position - contextLength)
+  const end = Math.min(str.length, position + contextLength + 1)
+  let context = str.substring(start, end)
+  
+  // Replace control characters with their escape sequences for readability
+  context = context.replace(/[\x00-\x1F\x7F-\x9F]/g, (match) => {
+    return '\\u' + match.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0')
+  })
+  
+  return context
+}
+
+/**
+ * Pretty print the detection results to console
+ */
+function printControlCharReport(report) {
+  console.log('=== Control Character Detection Report ===')
+  console.log(`Input: "${report.inputPreview}" (${report.inputLength} chars)`)
+  console.log(`Options: preserveBasicWhitespace = ${report.optionsUsed.preserveBasicWhitespace}`)
+  console.log(`Regex pattern: ${report.regexPattern}`)
+  console.log(`Control characters found: ${report.totalFound}`)
+  
+  if (report.hasControlChars) {
+    console.log('\n📋 Matches found:')
+    report.matches.forEach((match, index) => {
+      console.log(`\n${index + 1}. Character: ${JSON.stringify(match.character)}`)
+      console.log(`   Code: ${match.code} (${match.hex})`)
+      console.log(`   Position: ${match.position}`)
+      console.log(`   Context: "...${match.context}..."`)
+    })
+  } else {
+    console.log('✅ No control characters detected in Phase 1 range')
+  }
+  
+  console.log('=== End Report ===')
+}
+
+;// ./lib/helpers/detectControlCharacters/index.js
+
+
 ;// ./lib/helpers/escapeRegex/escapeRegex.js
 function escapeRegex(string) {
-  return String(string).replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&')
+  return String(string).replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&')
 }
 
 ;// ./lib/helpers/escapeRegex/index.js
@@ -1666,7 +1812,6 @@ function updateOneResult({ responseHelper, service }) {
 
 
 
-
 const expressHelper = {
   customHandler: customHandler,
   findAllResult: findAllResult,
@@ -1682,27 +1827,29 @@ const expressHelper = {
  * @returns {Array} Sorted array of unique, lowercase email addresses
  */
 function extractEmails(dirtyArray) {
-  const emailRegex = /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g
+  const emailRegex = /[\w.%+-]+@[a-z0-9.-]+\.[a-z]{2,}/gi
   const emails = new Set()
 
   // Handle null/undefined input array
-  if (!dirtyArray) return []
+  if (!dirtyArray)
+    return []
 
-  dirtyArray.forEach(entry => {
+  dirtyArray.forEach((entry) => {
     // Skip null, undefined, empty, or whitespace-only entries
-    if (!entry || typeof entry !== 'string' || !entry.trim()) return
+    if (!entry || typeof entry !== 'string' || !entry.trim())
+      return
 
     try {
       const cleanEntry = entry
         .replace(/[\u200B-\u200D\uFEFF\u202A-\u202E]/g, '') // Remove hidden chars
-        .replace(/[<>]/g, ' ')  // Convert email delimiters to spaces
-        .replace(/\s+/g, ' ')   // Collapse multiple whitespace
+        .replace(/[<>]/g, ' ') // Convert email delimiters to spaces
+        .replace(/\s+/g, ' ') // Collapse multiple whitespace
         .trim()
 
       // Extract all email matches
       const matches = cleanEntry.match(emailRegex)
       if (matches) {
-        matches.forEach(email => emails.add(email.toLowerCase())) // Normalize to lowercase
+        matches.forEach((email) => emails.add(email.toLowerCase())) // Normalize to lowercase
       }
     } catch (e) {
       console.warn('Failed to process entry:', entry, e)
@@ -1748,64 +1895,65 @@ const objectHelper = {
   },
   merge,
   set(obj, path, value) {
-    const parts = path.split('.');
-    let current = obj;
+    const parts = path.split('.')
+    let current = obj
 
     // 处理所有中间部分
     for (let i = 0; i < parts.length - 1; i++) {
-      const part = parts[i];
-      let key, index;
+      const part = parts[i]
+      let key, index
 
       // 检查是否是数组索引格式，如key[0]
-      const arrayMatch = part.match(/^(\w+)\[(\d+)\]$/);
+      const arrayMatch = part.match(/^(\w+)\[(\d+)\]$/)
       if (arrayMatch) {
-        key = arrayMatch[1];
-        index = parseInt(arrayMatch[2], 10);
+        key = arrayMatch[1]
+        index = Number.parseInt(arrayMatch[2], 10)
         // 确保当前层级的数组存在
         if (!current[key] || !Array.isArray(current[key])) {
-          current[key] = [];
+          current[key] = []
         }
         // 扩展数组到足够大
         while (current[key].length <= index) {
-          current[key].push(undefined);
+          current[key].push(undefined)
         }
         // 如果当前位置未定义或为null，初始化为对象
         if (current[key][index] == null) {
-          current[key][index] = {};
+          current[key][index] = {}
         }
-        current = current[key][index];
+        current = current[key][index]
       } else {
         // 处理普通属性
         if (!current[part]) {
-          current[part] = {};
+          current[part] = {}
         }
-        current = current[part];
+        current = current[part]
       }
     }
 
     // 处理最后一部分
-    const lastPart = parts[parts.length - 1];
-    const arrayMatch = lastPart.match(/^(\w+)\[(\d+)\]$/);
+    const lastPart = parts[parts.length - 1]
+    const arrayMatch = lastPart.match(/^(\w+)\[(\d+)\]$/)
     if (arrayMatch) {
-      const key = arrayMatch[1];
-      const index = parseInt(arrayMatch[2], 10);
+      const key = arrayMatch[1]
+      const index = Number.parseInt(arrayMatch[2], 10)
       // 确保数组存在
       if (!current[key] || !Array.isArray(current[key])) {
-        current[key] = [];
+        current[key] = []
       }
       // 扩展数组到所需索引
       while (current[key].length <= index) {
-        current[key].push(undefined);
+        current[key].push(undefined)
       }
-      current[key][index] = value;
+      current[key][index] = value
     } else {
-      current[lastPart] = value;
+      current[lastPart] = value
     }
   }
 }
 
 function merge(target, ...sources) {
-  if (!sources.length) return target
+  if (!sources.length)
+    return target
 
   const source = sources.shift() // 取出第一个源对象
 
@@ -1842,28 +1990,28 @@ function _isObject(obj) {
 
 ;// ./lib/helpers/pReduce/pReduce.js
 async function pReduce(iterable, reducer, initialValue) {
-	return new Promise((resolve, reject) => {
-		const iterator = iterable[Symbol.iterator]()
-		let index = 0
+  return new Promise((resolve, reject) => {
+    const iterator = iterable[Symbol.iterator]()
+    let index = 0
 
-		const next = async total => {
-			const element = iterator.next()
+    const next = async (total) => {
+      const element = iterator.next()
 
-			if (element.done) {
-				resolve(total)
-				return
-			}
+      if (element.done) {
+        resolve(total)
+        return
+      }
 
-			try {
-				const [resolvedTotal, resolvedValue] = await Promise.all([total, element.value])
-				next(reducer(resolvedTotal, resolvedValue, index++))
-			} catch (error) {
-				reject(error)
-			}
-		}
+      try {
+        const [resolvedTotal, resolvedValue] = await Promise.all([total, element.value])
+        next(reducer(resolvedTotal, resolvedValue, index++))
+      } catch (error) {
+        reject(error)
+      }
+    }
 
-		next(initialValue)
-	})
+    next(initialValue)
+  })
 }
 
 
@@ -2010,16 +2158,17 @@ class Repo {
     const promise = typeof this.model.saveAll === 'function'
       ? this.model.saveAll({ config, docs })
       : Promise.all(docs.map(async (doc) => {
-        if (doc) {
-          const result = await this.saveOne({ config, doc })
-          isNew = result.isNew
-          const _data = result._data || result.data
-          return _data[0]
-        }
-        return null
-      }))
+          if (doc) {
+            const result = await this.saveOne({ config, doc })
+            isNew = result.isNew
+            const _data = result._data || result.data
+            return _data[0]
+          }
+          return null
+        }))
     return promise.then((savedData) => {
-      if (savedData.length !== 1) isNew = null
+      if (savedData.length !== 1)
+        isNew = null
       const result = {
         data: savedData,
         isNew,
@@ -2353,6 +2502,9 @@ function initOnlyValidFromArray(_class, arr) {
 ;// ./lib/helpers/initOnlyValidFromArray/index.js
 
 
+;// ./lib/helpers/isConvertibleToNumber/index.js
+
+
 ;// ./lib/helpers/mergeArraysByKey/mergeArraysByKey.js
 function mergeArraysByKey(arr1, arr2) {
   // Handle undefined/null inputs by defaulting to empty arrays
@@ -2363,40 +2515,41 @@ function mergeArraysByKey(arr1, arr2) {
 
   // Helper function to merge values based on their type
   const mergeValues = (existingValue, newValue) => {
-    if (existingValue === undefined) return newValue
-    
+    if (existingValue === undefined)
+      return newValue
+
     // Handle arrays by concatenating
     if (Array.isArray(existingValue) && Array.isArray(newValue)) {
       return [...new Set([...existingValue, ...newValue])]
     }
-    
+
     // Handle objects by merging
-    if (typeof existingValue === 'object' && typeof newValue === 'object' && 
-        !Array.isArray(existingValue) && !Array.isArray(newValue)) {
+    if (typeof existingValue === 'object' && typeof newValue === 'object'
+      && !Array.isArray(existingValue) && !Array.isArray(newValue)) {
       return { ...existingValue, ...newValue }
     }
-    
+
     // // Handle numbers by adding
     // if (typeof existingValue === 'number' && typeof newValue === 'number') {
     //   return existingValue
     // }
-    
+
     // // Handle strings by concatenating
     // if (typeof existingValue === 'string' && typeof newValue === 'string') {
     //   return existingValue
     // }
-    
+
     // Default: use the new value
     return newValue
   }
 
   // Process first array
-  safeArr1.forEach(item => {
+  safeArr1.forEach((item) => {
     mergedMap.set(item.key, item.value)
   })
 
   // Process second array and merge values
-  safeArr2.forEach(item => {
+  safeArr2.forEach((item) => {
     const existingValue = mergedMap.get(item.key)
     mergedMap.set(item.key, mergeValues(existingValue, item.value))
   })
@@ -2415,7 +2568,7 @@ function mergeArraysByKey(arr1, arr2) {
 function padZeros(num, minLength = 6) {
   num = num.toString()
   if (num.length < minLength) {
-    return padZeros('0' + num, minLength)
+    return padZeros(`0${num}`, minLength)
   }
   return num
 }
@@ -2435,26 +2588,26 @@ function padZeros(num, minLength = 6) {
 ;// ./lib/helpers/replacePlaceholders/replacePlaceholders.js
 function replacePlaceholders({ content, mapping }) {
   let isObjectMode = false
-  
+
   if (typeof content === 'object' && content !== null) {
     content = JSON.stringify(content)
     isObjectMode = true
   }
 
   // [[ eventRegistration.eventRegistrationCode | 0  ]]
-  const regex = /(\[*)\[\[\s*([\w.\-_]+)(?:\s*\|\s*([^:\]\s]+))?(?:\s*:\s*([^\]\s]+))?\s*\]\](\]*)/g;
+  const regex = /(\[*)\[\[\s*([\w.\-]+)(?:\s*\|\s*([^:\]\s]+))?(?:\s*:\s*([^\]\s]+))?\s*\]\](\]*)/g
 
   const result = content.replace(regex, (match, leadingBrackets, path, defaultValue, type, trailingBrackets) => {
-    
     // Split the path into parts
     const keys = path.trim().split('.')
-    
+
     // Traverse the nested object structure
     let value = mapping
     for (const key of keys) {
       // Handle empty keys (in case of double dots or leading/trailing dots)
-      if (!key) continue
-      
+      if (!key)
+        continue
+
       value = value?.[key]
       if (value === undefined) {
         break
@@ -2462,10 +2615,12 @@ function replacePlaceholders({ content, mapping }) {
     }
 
     // Apply default if missing
-    if (value === undefined) value = defaultValue?.trim();
-    if (value === undefined) return isObjectMode ? undefined : match;
-    
-    value = value !== undefined 
+    if (value === undefined)
+      value = defaultValue?.trim()
+    if (value === undefined)
+      return isObjectMode ? undefined : match
+
+    value = value !== undefined
       ? leadingBrackets + value + trailingBrackets
       : match
 
@@ -2486,10 +2641,11 @@ function replacePlaceholders({ content, mapping }) {
 /**
  * Sanitizes input by removing hidden/control characters with customizable whitespace handling.
  * @param {string} input - The string to sanitize.
- * @param {Object} [options] - Configuration options.
- * @param {boolean} [options.normalizeWhitespace=true] - Collapse multiple spaces/tabs into one space.
- * @param {boolean} [options.removeNewlines=false] - If true, replaces newlines with spaces.
- * @param {boolean} [options.trim=true] - If true, trims leading/trailing whitespace.
+ * @param {object} [options] - Configuration options.
+ * @param {boolean} [options.normalizeWhitespace] - Collapse multiple spaces/tabs into one space.
+ * @param {boolean} [options.removeNewlines] - If true, replaces newlines with spaces.
+ * @param {boolean} [options.trim] - If true, trims leading/trailing whitespace.
+ * @param {boolean} [options.debug] - If true, logs debug information about removed characters.
  * @returns {string} The sanitized string.
  */
 function sanitizeText(input, options = {}) {
@@ -2497,7 +2653,8 @@ function sanitizeText(input, options = {}) {
     normalizeWhitespace = true,
     removeNewlines = false,
     trim = true,
-    preserveBasicWhitespace = true, // new option to keep tabs, newlines if removeNewlines=false
+    preserveBasicWhitespace = true,
+    debug = false, // new option for debugging
   } = options
 
   if (typeof input !== 'string') {
@@ -2506,27 +2663,106 @@ function sanitizeText(input, options = {}) {
 
   let result = input
 
+  if (debug) {
+    console.log('Original input:', JSON.stringify(input))
+    console.log('Options:', { normalizeWhitespace, removeNewlines, trim, preserveBasicWhitespace })
+  }
+
   // Phase 1: Remove all control characters except basic whitespace if requested
   if (preserveBasicWhitespace && !removeNewlines) {
-    // Keep tab (\t), newline (\n), carriage return (\r)
-    result = result.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F-\x9F\u200B-\u200D\uFEFF\u202A-\u202E]/g, '')
+    if (debug) {
+      const before = result
+      const matches = []
+      // Use a replacer function to capture what's being removed
+      result = result.replace(/[\x00-\x08\v\f\x0E-\x1F\x7F-\x9F\u200B-\u200D\uFEFF\u202A-\u202E]/g, (match) => {
+        matches.push({
+          char: match,
+          code: match.charCodeAt(0),
+          hex: `0x${match.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0')}`
+        })
+        return ''
+      })
+      if (matches.length > 0) {
+        console.log('Phase 1 (preserve mode) - Removed characters:')
+        matches.forEach((m) => {
+          console.log(`  - Character: ${JSON.stringify(m.char)}, Code: ${m.code}, Hex: ${m.hex}`)
+        })
+        console.log(`Removed ${matches.length} control character(s)`)
+      } else {
+        console.log('Phase 1 (preserve mode) - No control characters found')
+      }
+    } else {
+      result = result.replace(/[\x00-\x08\v\f\x0E-\x1F\x7F-\x9F\u200B-\u200D\uFEFF\u202A-\u202E]/g, '')
+    }
   } else {
-    // Remove all control characters including basic whitespace
-    result = result.replace(/[\x00-\x1F\x7F-\x9F\u200B-\u200D\uFEFF\u202A-\u202E]/g, '')
+    if (debug) {
+      const before = result
+      const matches = []
+      result = result.replace(/[\x00-\x1F\x7F-\x9F\u200B-\u200D\uFEFF\u202A-\u202E]/g, (match) => {
+        matches.push({
+          char: match,
+          code: match.charCodeAt(0),
+          hex: `0x${match.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0')}`
+        })
+        return ''
+      })
+      if (matches.length > 0) {
+        console.log('Phase 1 (full removal mode) - Removed characters:')
+        matches.forEach((m) => {
+          console.log(`  - Character: ${JSON.stringify(m.char)}, Code: ${m.code}, Hex: ${m.hex}`)
+        })
+        console.log(`Removed ${matches.length} control character(s)`)
+      } else {
+        console.log('Phase 1 (full removal mode) - No control characters found')
+      }
+    } else {
+      result = result.replace(/[\x00-\x1F\x7F-\x9F\u200B-\u200D\uFEFF\u202A-\u202E]/g, '')
+    }
+  }
+
+  if (debug) {
+    console.log('After Phase 1:', JSON.stringify(result))
   }
 
   // Phase 2: Handle whitespace transformations
   if (removeNewlines) {
-    result = result.replace(/[\r\n]+/g, ' ')  // Convert newlines to spaces
+    if (debug) {
+      const before = result
+      result = result.replace(/[\r\n]+/g, ' ')
+      console.log('Phase 2 - Converted newlines to spaces')
+    } else {
+      result = result.replace(/[\r\n]+/g, ' ')
+    }
   }
 
   if (normalizeWhitespace) {
-    result = result.replace(/[ \t]+/g, ' ')  // Collapse spaces/tabs to single space
+    if (debug) {
+      const before = result
+      result = result.replace(/[ \t]+/g, ' ')
+      console.log('Phase 2 - Normalized whitespace')
+    } else {
+      result = result.replace(/[ \t]+/g, ' ')
+    }
+  }
+
+  if (debug) {
+    console.log('After Phase 2:', JSON.stringify(result))
   }
 
   // Phase 3: Final trimming
   if (trim) {
-    result = result.trim()
+    if (debug) {
+      const before = result
+      result = result.trim()
+      console.log('Phase 3 - Trimmed leading/trailing whitespace')
+    } else {
+      result = result.trim()
+    }
+  }
+
+  if (debug) {
+    console.log('Final result:', JSON.stringify(result))
+    console.log('--- Sanitization complete ---')
   }
 
   return result
@@ -2537,12 +2773,12 @@ function sanitizeText(input, options = {}) {
 
 ;// ./lib/helpers/shuffleArray/shuffleArray.js
 function shuffleArray(array) {
-  const arr = [...array];
-  for (let i = arr.length - 1; i >= 0; i--) {  // Changed `i > 0` to `i >= 0`
+  const arr = [...array]
+  for (let i = arr.length - 1; i >= 0; i--) { // Changed `i > 0` to `i >= 0`
     const j = Math.floor(Math.random() * (i + 1));
-    [arr[i], arr[j]] = [arr[j], arr[i]];
+    [arr[i], arr[j]] = [arr[j], arr[i]]
   }
-  return arr;
+  return arr
 }
 
 ;// ./lib/helpers/shuffleArray/index.js
@@ -2604,7 +2840,7 @@ function indexCharset(str) {
   for (let i = 0; i < length; i++) {
     char = str[i]
     byCode[i] = char
-    byChar[char] = i;
+    byChar[char] = i
   }
   return { byCode, byChar, length }
 }
@@ -2635,7 +2871,7 @@ function randomString({ len = 16, pattern = 'a1' } = {}) {
     str += mark
   }
   const chars = [...str]
-  return [...Array(len)].map(i => {
+  return [...new Array(len)].map((i) => {
     return chars[(Math.random() * chars.length) | 0]
   }).join``
 }
@@ -2659,12 +2895,14 @@ function setCode(base = 34) {
 }
 
 function toCamelCase(str) {
-  if (!str) return ''
+  if (!str)
+    return ''
   return str
     .trim()
     .split(/\s+/)
     .map((word, index) => {
-      if (!word) return ''
+      if (!word)
+        return ''
       if (index === 0) {
         return word.toLowerCase()
       }
@@ -2674,7 +2912,8 @@ function toCamelCase(str) {
 }
 
 function toLowerCase(str) {
-  if (!str) return ''
+  if (!str)
+    return ''
   return str
     .trim()
     .toLowerCase()
@@ -2709,7 +2948,7 @@ function trackingPlugin(schema, options) {
   })
 
   // Auto-update hook
-  schema.pre('save', function(next) {
+  schema.pre('save', function (next) {
     this.meta.modified = Date.now()
     next()
   })
@@ -2721,9 +2960,9 @@ function trackingPlugin(schema, options) {
   }, {
     name: 'tracking_status_index',
     background: true,
-    partialFilterExpression: { 
+    partialFilterExpression: {
       'meta.active': true,
-      'meta.deleted': false 
+      'meta.deleted': false
     }
   })
 
@@ -2752,7 +2991,7 @@ function tenantPlugin(schema, options) {
 
   // Add core indexes
   schema.index({
-    'tenantCode': 1
+    tenantCode: 1
   }, {
     name: 'tenant_core_index',
     background: true
@@ -2760,15 +2999,15 @@ function tenantPlugin(schema, options) {
 
   // 1. ENHANCE EXISTING TRACKING INDEXES
   const existingIndexes = schema.indexes()
-  
+
   // Check if tracking_status_index exists
-  const hasTenantStatusIndex = existingIndexes.some(idx => 
+  const hasTenantStatusIndex = existingIndexes.some((idx) =>
     idx.name === 'tenant_status_index' // Check by name for reliability
   )
 
   if (!hasTenantStatusIndex) {
     schema.index({
-      'tenantCode': 1, // Unique field first
+      tenantCode: 1, // Unique field first
       _type: 1, // Low-cardinality field last
     }, {
       name: 'tenant_status_index',
@@ -2776,7 +3015,7 @@ function tenantPlugin(schema, options) {
       partialFilterExpression: {
         '_type': 'Tenant',
         'meta.active': true,
-        'meta.deleted': false 
+        'meta.deleted': false
       }
     })
   }
@@ -2814,6 +3053,8 @@ function tenantPlugin(schema, options) {
 
 
 
+
+
 
 
 
@@ -2872,10 +3113,11 @@ class AwsStsS3Client {
   }
 
   get isExpired() {
-    if (!this.expiration) return true;
-    const now = new Date();
-    const bufferMs = 1 * 60 * 1000; // 一分钟缓冲
-    return now >= new Date(this.expiration.getTime() - bufferMs);
+    if (!this.expiration)
+      return true
+    const now = new Date()
+    const bufferMs = 1 * 60 * 1000 // 一分钟缓冲
+    return now >= new Date(this.expiration.getTime() - bufferMs)
   }
 
   get isValid() {
@@ -2910,7 +3152,7 @@ class AwsStsS3Client {
         throw new Error(`Missing ${component} in AWS awsClientS3 client configuration`)
       }
     }
-    
+
     return true
   }
 
@@ -2920,9 +3162,9 @@ class AwsStsS3Client {
       if (!webIdentityToken) {
         throw new Error('getIdToken function returned empty or invalid token')
       }
-    
+
       const stsClient = new this.awsClientSts.STSClient({ region: this.region })
-      
+
       const stsResponse = await stsClient.send(
         new this.awsClientSts.AssumeRoleWithWebIdentityCommand({
           RoleArn: this.roleArn,
@@ -3229,29 +3471,30 @@ class KeyValueObject {
 }
 
 function _mergeValues(existingValue, newValue) {
-  if (existingValue === undefined) return newValue
-  
+  if (existingValue === undefined)
+    return newValue
+
   // Handle arrays by concatenating
   if (Array.isArray(existingValue) && Array.isArray(newValue)) {
     return [...new Set([...existingValue, ...newValue])]
   }
-  
+
   // Handle objects by merging
-  if (typeof existingValue === 'object' && typeof newValue === 'object' && 
-      !Array.isArray(existingValue) && !Array.isArray(newValue)) {
+  if (typeof existingValue === 'object' && typeof newValue === 'object'
+    && !Array.isArray(existingValue) && !Array.isArray(newValue)) {
     return { ...existingValue, ...newValue }
   }
-  
+
   // // Handle numbers by adding
   // if (typeof existingValue === 'number' && typeof newValue === 'number') {
   //   return existingValue
   // }
-  
+
   // // Handle strings by concatenating
   // if (typeof existingValue === 'string' && typeof newValue === 'string') {
   //   return existingValue
   // }
-  
+
   // Default: use the new value
   return newValue
 }
@@ -3311,29 +3554,30 @@ function metadata_isSame(key1, key2) {
 }
 
 function metadata_mergeValues(existingValue, newValue) {
-  if (existingValue === undefined) return newValue
-  
+  if (existingValue === undefined)
+    return newValue
+
   // Handle arrays by concatenating
   if (Array.isArray(existingValue) && Array.isArray(newValue)) {
     return [...new Set([...existingValue, ...newValue])]
   }
-  
+
   // Handle objects by merging
-  if (typeof existingValue === 'object' && typeof newValue === 'object' && 
-      !Array.isArray(existingValue) && !Array.isArray(newValue)) {
+  if (typeof existingValue === 'object' && typeof newValue === 'object'
+    && !Array.isArray(existingValue) && !Array.isArray(newValue)) {
     return { ...existingValue, ...newValue }
   }
-  
+
   // // Handle numbers by adding
   // if (typeof existingValue === 'number' && typeof newValue === 'number') {
   //   return existingValue
   // }
-  
+
   // // Handle strings by concatenating
   // if (typeof existingValue === 'string' && typeof newValue === 'string') {
   //   return existingValue
   // }
-  
+
   // Default: use the new value
   return newValue
 }
@@ -3354,14 +3598,14 @@ class TrackedEntity {
     const timestamp = Date.now()
     this.meta = {
       active: options.meta?.active ?? options.active ?? true,
-      created: options.meta?.created ?? (options.created 
-      ? new Date(options.created).getTime() 
-      : timestamp),
+      created: options.meta?.created ?? (options.created
+        ? new Date(options.created).getTime()
+        : timestamp),
       creator: options.meta?.creator ?? options.creator ?? '',
       deleted: options.meta?.deleted ?? options.deleted ?? false,
-      modified: options.meta?.modified ?? (options.modified 
-      ? new Date(options.modified).getTime() 
-      : timestamp),
+      modified: options.meta?.modified ?? (options.modified
+        ? new Date(options.modified).getTime()
+        : timestamp),
       owner: options.meta?.owner ?? options.owner ?? '',
     }
 
@@ -3528,7 +3772,6 @@ class PushEnvelope extends TrackedEntity {
   get isValid() {
     return super.isValid && this.data
   }
-
 }
 
 ;// ./lib/models/pushEnvelope/index.js
@@ -3595,6 +3838,191 @@ class QMeta {
 
 
 
+;// ./lib/models/status/actionRecord.js
+
+
+class ActionRecord {
+  constructor(options) {
+    options = options || {}
+
+    const { _Actor } = options._constructor || {}
+    this._Actor = _Actor
+
+    this._actor = options._actor
+
+    this.actorCode = typeof options === 'number' ? null : (options.actorCode || null)
+    this.timestamp = typeof options === 'number' ? options : (options.timestamp || null)
+  }
+
+  static get _classname() {
+    return 'ActionRecord'
+  }
+  static get _superclass() {
+    return 'ActionRecord'
+  }
+  static dummyData() {
+    return {
+      timestamp: (new Date()).valueOf(),
+    }
+  }
+  static init(options = {}) {
+    return init(this, options)
+  }
+
+  get _classname() {
+    return 'ActionRecord'
+  }
+
+  get _superclass() {
+    return 'ActionRecord'
+  }
+
+  get actor() {
+    return this._Actor && typeof this._Actor.init === 'function' ? this._Actor.init(this._actor) : this._actor
+  }
+
+  get isValid() {
+    return !!this.timestamp
+  }
+
+  update(update) {
+    if (typeof update === 'number') {
+      this.timestamp = update
+      return this
+    }
+    Object.keys(update).forEach((key) => {
+      this[key] = update[key]
+    })
+    return this
+  }
+}
+
+;// ./lib/models/status/status.js
+
+
+
+const notUpdateAllowedProps = [
+  'created',
+  // 'statusType'
+]
+
+class Status {
+  constructor(options) {
+    options = options || {}
+
+    const { _ActionRecord } = options._constructor || {}
+    this._ActionRecord = _ActionRecord && (_ActionRecord._superclass === ActionRecord._superclass) ? _ActionRecord : ActionRecord
+
+    this.created = this._ActionRecord.init(options.created || { timestamp: (new Date()).valueOf() })
+    // this.statusType = options.statusType || 'Status'
+  }
+
+  static get _classname() {
+    return 'Status'
+  }
+  static get _superclass() {
+    return 'Status'
+  }
+  static dummyData() {
+    return {}
+  }
+  static init(options = {}) {
+    return init(this, options)
+  }
+  static initFromArray(arr = []) {
+    return initFromArray(this, arr)
+  }
+  static initOnlyValidFromArray(arr = []) {
+    return initOnlyValidFromArray(this, arr)
+  }
+
+  get _classname() {
+    return 'Status'
+  }
+  get _superclass() {
+    return 'Status'
+  }
+  get isCreated() {
+    return this.created?.timestamp !== null
+  }
+  get isValid() {
+    return !!this
+  }
+
+  setValue(t, actorCode, key) {
+    const timestamp = t || Date.now()
+    this[key] = this[key] instanceof this._ActionRecord ? this[key].update({ actorCode, timestamp }) : this._ActionRecord.init({ actorCode, timestamp })
+    return this
+  }
+
+  update(update) {
+    Object.keys(update).forEach((key) => {
+      if (!notUpdateAllowedProps.includes(key)) {
+        this[key] = this[key] instanceof this._ActionRecord ? this[key].update(update[key]) : this._ActionRecord.init(update[key])
+      }
+    })
+    return this
+  }
+}
+
+;// ./lib/models/status/statusDocument.js
+
+
+class StatusDocument extends Status {
+  constructor(options) {
+    options = options || {}
+    super(options)
+
+    this.archived = this._ActionRecord.init(options.archived)
+    this.completed = this._ActionRecord.init(options.completed)
+    this.discarded = this._ActionRecord.init(options.discarded)
+    this.drafted = this._ActionRecord.init(options.drafted)
+    // this.statusType = 'StatusDocument'
+  }
+
+  static get _classname() {
+    return 'StatusDocument'
+  }
+  get _classname() {
+    return 'StatusDocument'
+  }
+  get isArchived() {
+    return this.created?.timestamp !== null
+  }
+  get isCompleted() {
+    return this.completed?.timestamp !== null
+  }
+  get isDiscarded() {
+    return this.discarded?.timestamp !== null
+  }
+  get isDrafted() {
+    return this.drafted?.timestamp !== null
+  }
+  get isValid() {
+    return super.isValid
+  }
+  setArchived(value, actorCode) {
+    // const timestamp = value || Date.now()
+    // this.archived = this.archived instanceof this._ActionRecord ? this.archived.update({ actorCode, timestamp }) : this._ActionRecord.init({ actorCode, timestamp })
+    // return this
+    return this.setValue(value, actorCode, 'archived')
+  }
+  setCompleted(value, actorCode) {
+    return this.setValue(value, actorCode, 'completed')
+  }
+  setDiscarded(value, actorCode) {
+    return this.setValue(value, actorCode, 'discarded')
+  }
+  setDrafted(value, actorCode) {
+    return this.setValue(value, actorCode, 'drafted')
+  }
+}
+
+;// ./lib/models/status/index.js
+
+
+
+
 ;// ./lib/models/tenantAwareEntity/tenantAwareEntity.js
 
 
@@ -3735,6 +4163,7 @@ function _makeSetCode(fieldName, options) {
 
 
 
+
 ;// ./lib/index.js