@questwork/q-utilities 0.1.17 → 0.1.19

package/.github/workflows/publish.yml

@@ -0,0 +1,46 @@
+name: Publish to npm on Tag
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    # environment: production
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Needed to get tag information
+      
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: https://registry.npmjs.org/
+          cache: 'pnpm'
+      
+      - name: Install dependencies
+        run: pnpm install
+      
+      - name: Build
+        run: |
+          BUILD_COMMAND=$(node -p "(require('./package.json').scripts || {}).build")
+          if [ "$BUILD_COMMAND" = "undefined" ]; then
+            echo "::notice::Can't find a build script in package.json, skip."
+          else
+            pnpm run build
+          fi
+      
+      - name: Publish to npm
+        # if: steps.version-check.outputs.should_publish == 'true'
+        run: pnpm publish --no-git-checks --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.QW_NPM_TOKEN }}

package/dist/index.min.cjs

@@ -53,6 +53,7 @@ __webpack_require__.d(__webpack_exports__, {
   AwsStsS3Client: () => (/* reexport */ AwsStsS3Client),
   KeyValueObject: () => (/* reexport */ KeyValueObject),
   Metadata: () => (/* reexport */ Metadata),
+  PushEnvelope: () => (/* reexport */ PushEnvelope),
   QMeta: () => (/* reexport */ QMeta),
   Repo: () => (/* reexport */ Repo),
   Service: () => (/* reexport */ Service),
@@ -61,6 +62,7 @@ __webpack_require__.d(__webpack_exports__, {
   TrackedEntity: () => (/* reexport */ TrackedEntity),
   UniqueKeyGenerator: () => (/* reexport */ UniqueKeyGenerator),
   authorize: () => (/* reexport */ authorize),
+  calculateAge: () => (/* reexport */ calculateAge),
   changeCreatorOwner: () => (/* reexport */ changeCreatorOwner),
   concatStringByArray: () => (/* reexport */ concatStringByArray),
   convertString: () => (/* reexport */ convertString),
@@ -71,6 +73,7 @@ __webpack_require__.d(__webpack_exports__, {
   generalPost: () => (/* reexport */ generalPost),
   getValidation: () => (/* reexport */ getValidation),
   getValueByKeys: () => (/* reexport */ getValueByKeys_getValueByKeys),
+  groupArrayByKey: () => (/* reexport */ groupArrayByKey),
   init: () => (/* reexport */ init),
   initFromArray: () => (/* reexport */ initFromArray),
   initOnlyValidFromArray: () => (/* reexport */ initOnlyValidFromArray),
@@ -82,6 +85,7 @@ __webpack_require__.d(__webpack_exports__, {
   padZeros: () => (/* reexport */ padZeros),
   replacePlaceholders: () => (/* reexport */ replacePlaceholders),
   sanitizeText: () => (/* reexport */ sanitizeText),
+  shuffleArray: () => (/* reexport */ shuffleArray),
   stringFormatter: () => (/* reexport */ stringFormatter),
   stringHelper: () => (/* reexport */ stringHelper),
   tenantPlugin: () => (/* reexport */ tenantPlugin),
@@ -136,6 +140,36 @@ function authorize({ allowCoordinator, allowOwner, query = {}, required, user })
 ;// ./lib/helpers/authorize/index.js
 
 
+;// ./lib/helpers/calculateAge/calculateAge.js
+function calculateAge(timestamp, reference) {
+  const birthDate = new Date(timestamp)
+  const refDate = reference ? new Date(reference) : new Date()
+  // Validate inputs
+  if (isNaN(birthDate.getTime())) {
+    return null
+  }
+  if (isNaN(refDate.getTime())) {
+    return null
+  }
+  if (birthDate > refDate) {
+    return null
+  }
+
+  // Calculate raw difference
+  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
+}
+
+;// ./lib/helpers/calculateAge/index.js
+
+
 ;// ./lib/helpers/changeCreatorOwner/changeCreatorOwner.js
 function changeCreatorOwner(that, { source, target }) {
   if (that.meta) {
@@ -1543,7 +1577,7 @@ function customHandler({ responseHelper, handler, ignoreError = false }) {
       await handler({ req, res })
       await next()
     } catch (err) {
-      if (ignoreError) {
+      if (ignoreError || !responseHelper) {
         await next()
       } else {
         res.status(400).json(responseHelper.standardizeResponse({ err, message: err.message || err }))
@@ -2118,11 +2152,16 @@ class Service {
     return 'Service'
   }
 
-  deleteOne({ id }) {
-    return this.repo.deleteOne({ id })
-      .catch(() => {
-        throw new Error(`Not found for query: ${id}`)
-      })
+  async deleteOne({ id }) {
+    const result = await this.repo.deleteOne({ id })
+    return makeApiResponse({
+      repo: this.repo,
+      result
+    })
+    // return this.repo.delete({ id })
+    //   .catch(() => {
+    //     throw new Error(`Not found for query: ${id}`)
+    //   })
   }
 
   async findAll({ query = {}, systemLog } = {}) {
@@ -2258,6 +2297,23 @@ function _makeService(resource, resourceInfo, UniqueKeyGenerator, GeneralModel)
 
 
 
+;// ./lib/helpers/groupArrayByKey/groupArrayByKey.js
+function groupArrayByKey(arr, key) {
+  if (!key || typeof key !== 'string') {
+    return {}
+  }
+  return arr.reduce((acc, curr) => {
+    if (!acc[curr[key]]) {
+      acc[curr[key]] = 0
+    }
+    acc[curr[key]]++
+    return acc
+  }, {})
+}
+
+;// ./lib/helpers/groupArrayByKey/index.js
+
+
 ;// ./lib/helpers/init/init.js
 function init(_class, options) {
   if (options instanceof _class) {
@@ -2480,6 +2536,19 @@ function sanitizeText(input, options = {}) {
 ;// ./lib/helpers/sanitizeText/index.js
 
 
+;// ./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 j = Math.floor(Math.random() * (i + 1));
+    [arr[i], arr[j]] = [arr[j], arr[i]];
+  }
+  return arr;
+}
+
+;// ./lib/helpers/shuffleArray/index.js
+
+
 ;// ./lib/helpers/stringFormatter/stringFormatter.js
 function stringFormatter(str, delimiter = '_') {
   if (str === null || typeof str === 'undefined' || typeof str.toString === 'undefined') {
@@ -2742,6 +2811,9 @@ function tenantPlugin(schema, options) {
 
 
 
+
+
+
 
 
 
@@ -3274,67 +3346,6 @@ function metadata_mergeValues(existingValue, newValue) {
 
 
 
-;// ./lib/models/qMeta/qMeta.js
-
-
-const updateAllowedProps = [
-  'attributes',
-  'ref'
-]
-
-class QMeta {
-  constructor(options = {}) {
-    options = options || {}
-    this.attributes = KeyValueObject.initOnlyValidFromArray(options.attributes)
-    this.ref = options.ref || {}
-  }
-
-  static get _classname() {
-    return 'QMeta'
-  }
-  static get _superclass() {
-    return 'QMeta'
-  }
-
-  // Class methods
-  static init(options = {}) {
-    if (options instanceof QMeta) {
-      return options
-    }
-    return new QMeta(options)
-  }
-
-  // instance methods
-  addAttribute(obj) {
-    const kvObject = KeyValueObject.init(obj)
-    if (!kvObject) {
-      throw new Error('invalid meta attribute')
-    }
-    this.attributes.push(kvObject)
-    return this
-  }
-
-  update(obj) {
-    Object.keys(obj).forEach((key) => {
-      if (updateAllowedProps.includes(key)) {
-        if (key === 'attributes') {
-          this[key] = KeyValueObject.initOnlyValidFromArray(obj[key])
-        } else {
-          this[key] = obj[key]
-        }
-      }
-    })
-    return this
-  }
-}
-
-
-
-;// ./lib/models/qMeta/index.js
-
-
-
-
 ;// ./lib/models/trackedEntity/trackedEntity.js
 
 
@@ -3477,6 +3488,114 @@ class TrackedEntity {
 
  // Explicit named export (optional)
 
+;// ./lib/models/pushEnvelope/pushEnvelope.js
+
+
+
+
+
+class PushEnvelope extends TrackedEntity {
+  constructor(options) {
+    options = options || {}
+    super(options)
+
+    this.id = options.id
+    this.body = options.body
+    this.data = options.data
+    this.dirty = options.dirty
+    this.metadata = Metadata.initOnlyValidFromArray(options.metadata)
+    this.remarks = KeyValueObject.initOnlyValidFromArray(options.remarks)
+    this.threadID = options.threadID
+    this.title = options.title
+  }
+  static get _classname() {
+    return 'PushEnvelope'
+  }
+  static get _superclass() {
+    return 'PushEnvelope'
+  }
+  static init(options = {}) {
+    return init(this, options)
+  }
+
+  get _classname() {
+    return 'PushEnvelope'
+  }
+
+  get _superclass() {
+    return 'PushEnvelope'
+  }
+
+  get isValid() {
+    return super.isValid && this.data
+  }
+
+}
+
+;// ./lib/models/pushEnvelope/index.js
+
+
+;// ./lib/models/qMeta/qMeta.js
+
+
+const updateAllowedProps = [
+  'attributes',
+  'ref'
+]
+
+class QMeta {
+  constructor(options = {}) {
+    options = options || {}
+    this.attributes = KeyValueObject.initOnlyValidFromArray(options.attributes)
+    this.ref = options.ref || {}
+  }
+
+  static get _classname() {
+    return 'QMeta'
+  }
+  static get _superclass() {
+    return 'QMeta'
+  }
+
+  // Class methods
+  static init(options = {}) {
+    if (options instanceof QMeta) {
+      return options
+    }
+    return new QMeta(options)
+  }
+
+  // instance methods
+  addAttribute(obj) {
+    const kvObject = KeyValueObject.init(obj)
+    if (!kvObject) {
+      throw new Error('invalid meta attribute')
+    }
+    this.attributes.push(kvObject)
+    return this
+  }
+
+  update(obj) {
+    Object.keys(obj).forEach((key) => {
+      if (updateAllowedProps.includes(key)) {
+        if (key === 'attributes') {
+          this[key] = KeyValueObject.initOnlyValidFromArray(obj[key])
+        } else {
+          this[key] = obj[key]
+        }
+      }
+    })
+    return this
+  }
+}
+
+
+
+;// ./lib/models/qMeta/index.js
+
+
+
+
 ;// ./lib/models/tenantAwareEntity/tenantAwareEntity.js
 
 
@@ -3616,6 +3735,7 @@ function _makeSetCode(fieldName, options) {
 
 
 
+
 ;// ./lib/index.js
 
 

package/dist/q-utilities.esm.js

@@ -47,6 +47,36 @@ function authorize({ allowCoordinator, allowOwner, query = {}, required, user })
 ;// ./lib/helpers/authorize/index.js
 
 
+;// ./lib/helpers/calculateAge/calculateAge.js
+function calculateAge(timestamp, reference) {
+  const birthDate = new Date(timestamp)
+  const refDate = reference ? new Date(reference) : new Date()
+  // Validate inputs
+  if (isNaN(birthDate.getTime())) {
+    return null
+  }
+  if (isNaN(refDate.getTime())) {
+    return null
+  }
+  if (birthDate > refDate) {
+    return null
+  }
+
+  // Calculate raw difference
+  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
+}
+
+;// ./lib/helpers/calculateAge/index.js
+
+
 ;// ./lib/helpers/changeCreatorOwner/changeCreatorOwner.js
 function changeCreatorOwner(that, { source, target }) {
   if (that.meta) {
@@ -1454,7 +1484,7 @@ function customHandler({ responseHelper, handler, ignoreError = false }) {
       await handler({ req, res })
       await next()
     } catch (err) {
-      if (ignoreError) {
+      if (ignoreError || !responseHelper) {
         await next()
       } else {
         res.status(400).json(responseHelper.standardizeResponse({ err, message: err.message || err }))
@@ -2029,11 +2059,16 @@ class Service {
     return 'Service'
   }
 
-  deleteOne({ id }) {
-    return this.repo.deleteOne({ id })
-      .catch(() => {
-        throw new Error(`Not found for query: ${id}`)
-      })
+  async deleteOne({ id }) {
+    const result = await this.repo.deleteOne({ id })
+    return makeApiResponse({
+      repo: this.repo,
+      result
+    })
+    // return this.repo.delete({ id })
+    //   .catch(() => {
+    //     throw new Error(`Not found for query: ${id}`)
+    //   })
   }
 
   async findAll({ query = {}, systemLog } = {}) {
@@ -2169,6 +2204,23 @@ function _makeService(resource, resourceInfo, UniqueKeyGenerator, GeneralModel)
 
 
 
+;// ./lib/helpers/groupArrayByKey/groupArrayByKey.js
+function groupArrayByKey(arr, key) {
+  if (!key || typeof key !== 'string') {
+    return {}
+  }
+  return arr.reduce((acc, curr) => {
+    if (!acc[curr[key]]) {
+      acc[curr[key]] = 0
+    }
+    acc[curr[key]]++
+    return acc
+  }, {})
+}
+
+;// ./lib/helpers/groupArrayByKey/index.js
+
+
 ;// ./lib/helpers/init/init.js
 function init(_class, options) {
   if (options instanceof _class) {
@@ -2391,6 +2443,19 @@ function sanitizeText(input, options = {}) {
 ;// ./lib/helpers/sanitizeText/index.js
 
 
+;// ./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 j = Math.floor(Math.random() * (i + 1));
+    [arr[i], arr[j]] = [arr[j], arr[i]];
+  }
+  return arr;
+}
+
+;// ./lib/helpers/shuffleArray/index.js
+
+
 ;// ./lib/helpers/stringFormatter/stringFormatter.js
 function stringFormatter(str, delimiter = '_') {
   if (str === null || typeof str === 'undefined' || typeof str.toString === 'undefined') {
@@ -2653,6 +2718,9 @@ function tenantPlugin(schema, options) {
 
 
 
+
+
+
 
 
 
@@ -3185,67 +3253,6 @@ function metadata_mergeValues(existingValue, newValue) {
 
 
 
-;// ./lib/models/qMeta/qMeta.js
-
-
-const updateAllowedProps = [
-  'attributes',
-  'ref'
-]
-
-class QMeta {
-  constructor(options = {}) {
-    options = options || {}
-    this.attributes = KeyValueObject.initOnlyValidFromArray(options.attributes)
-    this.ref = options.ref || {}
-  }
-
-  static get _classname() {
-    return 'QMeta'
-  }
-  static get _superclass() {
-    return 'QMeta'
-  }
-
-  // Class methods
-  static init(options = {}) {
-    if (options instanceof QMeta) {
-      return options
-    }
-    return new QMeta(options)
-  }
-
-  // instance methods
-  addAttribute(obj) {
-    const kvObject = KeyValueObject.init(obj)
-    if (!kvObject) {
-      throw new Error('invalid meta attribute')
-    }
-    this.attributes.push(kvObject)
-    return this
-  }
-
-  update(obj) {
-    Object.keys(obj).forEach((key) => {
-      if (updateAllowedProps.includes(key)) {
-        if (key === 'attributes') {
-          this[key] = KeyValueObject.initOnlyValidFromArray(obj[key])
-        } else {
-          this[key] = obj[key]
-        }
-      }
-    })
-    return this
-  }
-}
-
-
-
-;// ./lib/models/qMeta/index.js
-
-
-
-
 ;// ./lib/models/trackedEntity/trackedEntity.js
 
 
@@ -3388,6 +3395,114 @@ class TrackedEntity {
 
  // Explicit named export (optional)
 
+;// ./lib/models/pushEnvelope/pushEnvelope.js
+
+
+
+
+
+class PushEnvelope extends TrackedEntity {
+  constructor(options) {
+    options = options || {}
+    super(options)
+
+    this.id = options.id
+    this.body = options.body
+    this.data = options.data
+    this.dirty = options.dirty
+    this.metadata = Metadata.initOnlyValidFromArray(options.metadata)
+    this.remarks = KeyValueObject.initOnlyValidFromArray(options.remarks)
+    this.threadID = options.threadID
+    this.title = options.title
+  }
+  static get _classname() {
+    return 'PushEnvelope'
+  }
+  static get _superclass() {
+    return 'PushEnvelope'
+  }
+  static init(options = {}) {
+    return init(this, options)
+  }
+
+  get _classname() {
+    return 'PushEnvelope'
+  }
+
+  get _superclass() {
+    return 'PushEnvelope'
+  }
+
+  get isValid() {
+    return super.isValid && this.data
+  }
+
+}
+
+;// ./lib/models/pushEnvelope/index.js
+
+
+;// ./lib/models/qMeta/qMeta.js
+
+
+const updateAllowedProps = [
+  'attributes',
+  'ref'
+]
+
+class QMeta {
+  constructor(options = {}) {
+    options = options || {}
+    this.attributes = KeyValueObject.initOnlyValidFromArray(options.attributes)
+    this.ref = options.ref || {}
+  }
+
+  static get _classname() {
+    return 'QMeta'
+  }
+  static get _superclass() {
+    return 'QMeta'
+  }
+
+  // Class methods
+  static init(options = {}) {
+    if (options instanceof QMeta) {
+      return options
+    }
+    return new QMeta(options)
+  }
+
+  // instance methods
+  addAttribute(obj) {
+    const kvObject = KeyValueObject.init(obj)
+    if (!kvObject) {
+      throw new Error('invalid meta attribute')
+    }
+    this.attributes.push(kvObject)
+    return this
+  }
+
+  update(obj) {
+    Object.keys(obj).forEach((key) => {
+      if (updateAllowedProps.includes(key)) {
+        if (key === 'attributes') {
+          this[key] = KeyValueObject.initOnlyValidFromArray(obj[key])
+        } else {
+          this[key] = obj[key]
+        }
+      }
+    })
+    return this
+  }
+}
+
+
+
+;// ./lib/models/qMeta/index.js
+
+
+
+
 ;// ./lib/models/tenantAwareEntity/tenantAwareEntity.js
 
 
@@ -3527,6 +3642,7 @@ function _makeSetCode(fieldName, options) {
 
 
 
+
 ;// ./lib/index.js
 
 
@@ -3534,4 +3650,4 @@ function _makeSetCode(fieldName, options) {
 ;// ./index.js
 
 
-export { ApiResponse, AwsStsS3Client, KeyValueObject, Metadata, QMeta, Repo, Service, TemplateCompiler, TenantAwareEntity, TrackedEntity, UniqueKeyGenerator, authorize, changeCreatorOwner, concatStringByArray, convertString, escapeRegex, expressHelper, extractEmails, formatDate, generalPost, getValidation, getValueByKeys_getValueByKeys as getValueByKeys, init, initFromArray, initOnlyValidFromArray, makeApiResponse, makeService, mergeArraysByKey, objectHelper, pReduce, padZeros, replacePlaceholders, sanitizeText, stringFormatter, stringHelper, tenantPlugin, trackingPlugin };
+export { ApiResponse, AwsStsS3Client, KeyValueObject, Metadata, PushEnvelope, QMeta, Repo, Service, TemplateCompiler, TenantAwareEntity, TrackedEntity, UniqueKeyGenerator, authorize, calculateAge, changeCreatorOwner, concatStringByArray, convertString, escapeRegex, expressHelper, extractEmails, formatDate, generalPost, getValidation, getValueByKeys_getValueByKeys as getValueByKeys, groupArrayByKey, init, initFromArray, initOnlyValidFromArray, makeApiResponse, makeService, mergeArraysByKey, objectHelper, pReduce, padZeros, replacePlaceholders, sanitizeText, shuffleArray, stringFormatter, stringHelper, tenantPlugin, trackingPlugin };

package/dist/q-utilities.min.js

@@ -52,6 +52,7 @@ __webpack_require__.d(__webpack_exports__, {
   AwsStsS3Client: () => (/* reexport */ AwsStsS3Client),
   KeyValueObject: () => (/* reexport */ KeyValueObject),
   Metadata: () => (/* reexport */ Metadata),
+  PushEnvelope: () => (/* reexport */ PushEnvelope),
   QMeta: () => (/* reexport */ QMeta),
   Repo: () => (/* reexport */ Repo),
   Service: () => (/* reexport */ Service),
@@ -60,6 +61,7 @@ __webpack_require__.d(__webpack_exports__, {
   TrackedEntity: () => (/* reexport */ TrackedEntity),
   UniqueKeyGenerator: () => (/* reexport */ UniqueKeyGenerator),
   authorize: () => (/* reexport */ authorize),
+  calculateAge: () => (/* reexport */ calculateAge),
   changeCreatorOwner: () => (/* reexport */ changeCreatorOwner),
   concatStringByArray: () => (/* reexport */ concatStringByArray),
   convertString: () => (/* reexport */ convertString),
@@ -70,6 +72,7 @@ __webpack_require__.d(__webpack_exports__, {
   generalPost: () => (/* reexport */ generalPost),
   getValidation: () => (/* reexport */ getValidation),
   getValueByKeys: () => (/* reexport */ getValueByKeys_getValueByKeys),
+  groupArrayByKey: () => (/* reexport */ groupArrayByKey),
   init: () => (/* reexport */ init),
   initFromArray: () => (/* reexport */ initFromArray),
   initOnlyValidFromArray: () => (/* reexport */ initOnlyValidFromArray),
@@ -81,6 +84,7 @@ __webpack_require__.d(__webpack_exports__, {
   padZeros: () => (/* reexport */ padZeros),
   replacePlaceholders: () => (/* reexport */ replacePlaceholders),
   sanitizeText: () => (/* reexport */ sanitizeText),
+  shuffleArray: () => (/* reexport */ shuffleArray),
   stringFormatter: () => (/* reexport */ stringFormatter),
   stringHelper: () => (/* reexport */ stringHelper),
   tenantPlugin: () => (/* reexport */ tenantPlugin),
@@ -135,6 +139,36 @@ function authorize({ allowCoordinator, allowOwner, query = {}, required, user })
 ;// ./lib/helpers/authorize/index.js
 
 
+;// ./lib/helpers/calculateAge/calculateAge.js
+function calculateAge(timestamp, reference) {
+  const birthDate = new Date(timestamp)
+  const refDate = reference ? new Date(reference) : new Date()
+  // Validate inputs
+  if (isNaN(birthDate.getTime())) {
+    return null
+  }
+  if (isNaN(refDate.getTime())) {
+    return null
+  }
+  if (birthDate > refDate) {
+    return null
+  }
+
+  // Calculate raw difference
+  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
+}
+
+;// ./lib/helpers/calculateAge/index.js
+
+
 ;// ./lib/helpers/changeCreatorOwner/changeCreatorOwner.js
 function changeCreatorOwner(that, { source, target }) {
   if (that.meta) {
@@ -1542,7 +1576,7 @@ function customHandler({ responseHelper, handler, ignoreError = false }) {
       await handler({ req, res })
       await next()
     } catch (err) {
-      if (ignoreError) {
+      if (ignoreError || !responseHelper) {
         await next()
       } else {
         res.status(400).json(responseHelper.standardizeResponse({ err, message: err.message || err }))
@@ -2117,11 +2151,16 @@ class Service {
     return 'Service'
   }
 
-  deleteOne({ id }) {
-    return this.repo.deleteOne({ id })
-      .catch(() => {
-        throw new Error(`Not found for query: ${id}`)
-      })
+  async deleteOne({ id }) {
+    const result = await this.repo.deleteOne({ id })
+    return makeApiResponse({
+      repo: this.repo,
+      result
+    })
+    // return this.repo.delete({ id })
+    //   .catch(() => {
+    //     throw new Error(`Not found for query: ${id}`)
+    //   })
   }
 
   async findAll({ query = {}, systemLog } = {}) {
@@ -2257,6 +2296,23 @@ function _makeService(resource, resourceInfo, UniqueKeyGenerator, GeneralModel)
 
 
 
+;// ./lib/helpers/groupArrayByKey/groupArrayByKey.js
+function groupArrayByKey(arr, key) {
+  if (!key || typeof key !== 'string') {
+    return {}
+  }
+  return arr.reduce((acc, curr) => {
+    if (!acc[curr[key]]) {
+      acc[curr[key]] = 0
+    }
+    acc[curr[key]]++
+    return acc
+  }, {})
+}
+
+;// ./lib/helpers/groupArrayByKey/index.js
+
+
 ;// ./lib/helpers/init/init.js
 function init(_class, options) {
   if (options instanceof _class) {
@@ -2479,6 +2535,19 @@ function sanitizeText(input, options = {}) {
 ;// ./lib/helpers/sanitizeText/index.js
 
 
+;// ./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 j = Math.floor(Math.random() * (i + 1));
+    [arr[i], arr[j]] = [arr[j], arr[i]];
+  }
+  return arr;
+}
+
+;// ./lib/helpers/shuffleArray/index.js
+
+
 ;// ./lib/helpers/stringFormatter/stringFormatter.js
 function stringFormatter(str, delimiter = '_') {
   if (str === null || typeof str === 'undefined' || typeof str.toString === 'undefined') {
@@ -2741,6 +2810,9 @@ function tenantPlugin(schema, options) {
 
 
 
+
+
+
 
 
 
@@ -3273,67 +3345,6 @@ function metadata_mergeValues(existingValue, newValue) {
 
 
 
-;// ./lib/models/qMeta/qMeta.js
-
-
-const updateAllowedProps = [
-  'attributes',
-  'ref'
-]
-
-class QMeta {
-  constructor(options = {}) {
-    options = options || {}
-    this.attributes = KeyValueObject.initOnlyValidFromArray(options.attributes)
-    this.ref = options.ref || {}
-  }
-
-  static get _classname() {
-    return 'QMeta'
-  }
-  static get _superclass() {
-    return 'QMeta'
-  }
-
-  // Class methods
-  static init(options = {}) {
-    if (options instanceof QMeta) {
-      return options
-    }
-    return new QMeta(options)
-  }
-
-  // instance methods
-  addAttribute(obj) {
-    const kvObject = KeyValueObject.init(obj)
-    if (!kvObject) {
-      throw new Error('invalid meta attribute')
-    }
-    this.attributes.push(kvObject)
-    return this
-  }
-
-  update(obj) {
-    Object.keys(obj).forEach((key) => {
-      if (updateAllowedProps.includes(key)) {
-        if (key === 'attributes') {
-          this[key] = KeyValueObject.initOnlyValidFromArray(obj[key])
-        } else {
-          this[key] = obj[key]
-        }
-      }
-    })
-    return this
-  }
-}
-
-
-
-;// ./lib/models/qMeta/index.js
-
-
-
-
 ;// ./lib/models/trackedEntity/trackedEntity.js
 
 
@@ -3476,6 +3487,114 @@ class TrackedEntity {
 
  // Explicit named export (optional)
 
+;// ./lib/models/pushEnvelope/pushEnvelope.js
+
+
+
+
+
+class PushEnvelope extends TrackedEntity {
+  constructor(options) {
+    options = options || {}
+    super(options)
+
+    this.id = options.id
+    this.body = options.body
+    this.data = options.data
+    this.dirty = options.dirty
+    this.metadata = Metadata.initOnlyValidFromArray(options.metadata)
+    this.remarks = KeyValueObject.initOnlyValidFromArray(options.remarks)
+    this.threadID = options.threadID
+    this.title = options.title
+  }
+  static get _classname() {
+    return 'PushEnvelope'
+  }
+  static get _superclass() {
+    return 'PushEnvelope'
+  }
+  static init(options = {}) {
+    return init(this, options)
+  }
+
+  get _classname() {
+    return 'PushEnvelope'
+  }
+
+  get _superclass() {
+    return 'PushEnvelope'
+  }
+
+  get isValid() {
+    return super.isValid && this.data
+  }
+
+}
+
+;// ./lib/models/pushEnvelope/index.js
+
+
+;// ./lib/models/qMeta/qMeta.js
+
+
+const updateAllowedProps = [
+  'attributes',
+  'ref'
+]
+
+class QMeta {
+  constructor(options = {}) {
+    options = options || {}
+    this.attributes = KeyValueObject.initOnlyValidFromArray(options.attributes)
+    this.ref = options.ref || {}
+  }
+
+  static get _classname() {
+    return 'QMeta'
+  }
+  static get _superclass() {
+    return 'QMeta'
+  }
+
+  // Class methods
+  static init(options = {}) {
+    if (options instanceof QMeta) {
+      return options
+    }
+    return new QMeta(options)
+  }
+
+  // instance methods
+  addAttribute(obj) {
+    const kvObject = KeyValueObject.init(obj)
+    if (!kvObject) {
+      throw new Error('invalid meta attribute')
+    }
+    this.attributes.push(kvObject)
+    return this
+  }
+
+  update(obj) {
+    Object.keys(obj).forEach((key) => {
+      if (updateAllowedProps.includes(key)) {
+        if (key === 'attributes') {
+          this[key] = KeyValueObject.initOnlyValidFromArray(obj[key])
+        } else {
+          this[key] = obj[key]
+        }
+      }
+    })
+    return this
+  }
+}
+
+
+
+;// ./lib/models/qMeta/index.js
+
+
+
+
 ;// ./lib/models/tenantAwareEntity/tenantAwareEntity.js
 
 
@@ -3615,6 +3734,7 @@ function _makeSetCode(fieldName, options) {
 
 
 
+
 ;// ./lib/index.js
 
 

package/package.json

@@ -1,7 +1,13 @@
 {
   "name": "@questwork/q-utilities",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Questwork QUtilities",
+  "author": {
+    "name": "Questwork Consulting Limited",
+    "email": "info@questwork.com",
+    "url": "https://questwork.com/"
+  },
+  "license": "MIT",
   "type": "module",
   "exports": {
     ".": {
@@ -10,12 +16,6 @@
       "default": "./dist/q-utilities.min.js"
     }
   },
-  "author": {
-    "name": "Questwork Consulting Limited",
-    "email": "info@questwork.com",
-    "url": "https://questwork.com/"
-  },
-  "license": "MIT",
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.812.0",
     "@aws-sdk/client-sts": "^3.812.0",
@@ -44,6 +44,7 @@
     "build": "cross-env NODE_ENV=production minimize=false gulp",
     "build:wp": "cross-env NODE_ENV=production minimize=false gulp wp",
     "lint": "eslint .",
+    "test:helpers": "NODE_ENV=test mocha --exit 'lib/helpers/test.setup.js' 'lib/helpers/**/*.spec.js'",
     "test:models": "NODE_ENV=test mocha --exit 'lib/models/test.setup.js' 'lib/models/**/*.spec.js'"
   }
 }