nitro-web 0.0.39 → 0.0.41

package/util.js

@@ -1,12 +1,26 @@
-// @ts-nocheck
-import _axios from '@hokify/axios'
+import _axios from 'axios'
 import axiosRetry from 'axios-retry'
 import dateformat from 'dateformat'
 import { loadStripe } from '@stripe/stripe-js/pure.js' // pure removes ping
-export const dateFormat = dateformat
 
+/** @type {{[key: string]: {[key: string]: string|true}}} */
+let queryObjectCache = {}
+
+/** @type {Promise<import('@stripe/stripe-js').Stripe|null>|undefined} */
+let stripeClientCache
+
+/** @type {number|undefined} */
+let scrollbarCache
+
+/** @type {boolean|undefined} */
+let axiosNonce
+
+/**
+ * Returns an address monastery schema which Google autocomplete should return
+ */
 export function addressSchema () {
   // Google autocomplete should return the following object
+  /** @param {any} array @param {object} schema @returns {[]} */
   function arrayWithSchema (array, schema) {
     array.schema = schema
     return array
@@ -37,12 +51,16 @@ export function addressSchema () {
   }
 }
 
+/**
+ * Returns an axios instance
+ * @returns {import('axios').AxiosStatic}
+ */
 export function axios () {
-  // Remove mobile specific protocol and subdomain
-  const clientOrigin = window.document.location.origin.replace(/^(capacitor|https):\/\/(mobile\.)?/, 'https://')
   // axios configurations on the client
-  if (!axios._axiosNonce && typeof window !== 'undefined') {
-    axios._axiosNonce = true
+  if (!axiosNonce && typeof window !== 'undefined') {
+    // Remove mobile specific protocol and subdomain
+    const clientOrigin = window.document.location.origin.replace(/^(capacitor|https):\/\/(mobile\.)?/, 'https://')
+    axiosNonce = true
     _axios.defaults.baseURL = clientOrigin
     _axios.defaults.headers.desktop = true
     _axios.defaults.withCredentials = true
@@ -52,16 +70,24 @@ export function axios () {
   return _axios
 }
 
+/**
+ * Builds the url with params
+ * @param {string} url
+ * @param {{[key: string]: string}} parameters - Key value parameters
+ * @returns {string}, e.g. 'https://example.com?param1=value1&param2=value2'
+ */
 export function buildUrl (url, parameters) {
-  /**
-   * Builds the url with params
-   * @param {string} url - String url
-   * @param {object} parameters - Key value parameters
-   */
   const params = Object.keys(parameters).map((p) => `${encodeURIComponent(p)}=${encodeURIComponent(parameters[p])}`)
   return [url, params.join('&')].join('?')
 }   
 
+/**
+ * Converts a string to camel case
+ * @param {string} str
+ * @param {boolean} [capitaliseFirst] - Capitalise the first letter
+ * @param {boolean} [allowNumber] - Allow numbers
+ * @returns {string}
+ */
 export function camelCase (str, capitaliseFirst, allowNumber) {
   let regex = (capitaliseFirst ? '(?:^[a-z0-9]|' : '(?:') + '[-]+[a-z0-9])'
   return str
@@ -77,20 +103,43 @@ export function camelCase (str, capitaliseFirst, allowNumber) {
     })
 }
 
+/**
+ * Converts camel case to title case
+ * @param {string} str
+ * @param {boolean} [captialiseFirstOnly] - Capitalise the first letter only
+ * @returns {string}
+ */
 export function camelCaseToTitle (str, captialiseFirstOnly) {
   str = str.replace(/([A-Z]+)/g, ' $1').trim()
   if (captialiseFirstOnly) str = str.toLowerCase()
   return ucFirst(str)
 }
 
+/**
+ * Converts camel case to hypen case
+ * @param {string} str
+ * @returns {string}
+ */
 export function camelCaseToHypen (str) {
   return str.replace(/[A-Z]|[0-9]+/g, m => '-' + m.toLowerCase())
 }
 
+/**
+ * Capitalises a string
+ * @param {string} [str]
+ * @returns {string}
+ */
 export function capitalise (str) {
   return (str||'').replace(/(?:^|\s)\S/g, (a) => a.toUpperCase())
 }
 
+/**
+ * Formats a currency string
+ * @param {number} cents
+ * @param {number} [decimals=2]
+ * @param {number} [decimalsMinimum]
+ * @returns {string}
+ */
 export function currency (cents, decimals=2, decimalsMinimum) {
   // Returns a formated currency string
   const num = Number(cents / 100)
@@ -101,75 +150,106 @@ export function currency (cents, decimals=2, decimalsMinimum) {
   })
 }
 
+/**
+ * Converts a currency string to cents
+ * @param {string} currency string, e.g. '$1,234.00'
+ * @returns {string}
+ */
 export function currencyToCents (currency) {
   // Converts '$1,234.00' to '1234.00', then to '123400'
   let currencyString = Number(currency.replace(/[^0-9.]/g, '')).toFixed(2)
   return currencyString.replace(/\./g, '')
 }
 
+/**
+ * Returns a formatted date string
+ * @param {number|Date} date - number can be in seconds or milliseconds (UTC)
+ * @param {string} [format] - e.g. "dd mmmm yy" (https://github.com/felixge/node-dateformat#mask-options)
+ * @param {string} [timezone] - convert a UTC date to a particular timezone.
+ * @returns {string}
+ * 
+ * Note on the timezone conversion:
+ * Timezone conversion relies on parsing the toLocaleString result, e.g. 4/10/2012, 5:10:30 PM.
+ * A older browser may not accept en-US formatted date string to its Date constructor, and it may
+ * return unexpected result (it may ignore daylight saving).
+ */
 export function date (date, format, timezone) {
-  /**
-   * Returns a formatted date
-   * @param {number|Date} date - number can be in seconds or milliseconds (UTC)
-   * @param {string} format - e.g. "dd mmmm yy" (https://github.com/felixge/node-dateformat#mask-options)
-   * @param {string} timezone - convert a UTC date to a particular timezone.
-   *
-   * Note on the timezone conversion:
-   * Timezone conversion relies on parsing the toLocaleString result, e.g. 4/10/2012, 5:10:30 PM.
-   * A older browser may not accept en-US formatted date string to its Date constructor, and it may
-   * return unexpected result (it may ignore daylight saving).
-   */
   if (!date || (!isNumber(date) && !isDate(date))) return 'Date?'
-  else if (isNumber(date) && date < 9999999999) var milliseconds = date * 1000
-  else if (isObject(date)) milliseconds = date.getTime()
-  else milliseconds = date
+
+  // Get the milliseconds
+  let milliseconds = 0
+  if (typeof date === 'number') {
+    if (date < 9999999999) milliseconds = date * 1000
+    else milliseconds = date
+  } else if (isDate(date)) {
+    milliseconds = date.getTime()
+  }
   if (timezone) {
     milliseconds = new Date(new Date(milliseconds).toLocaleString('en-US', { timeZone: timezone })).getTime()
   }
-  return dateFormat(milliseconds, format || 'dS mmmm')
+  return dateformat(milliseconds, format || 'dS mmmm')
 }
 
-export function debounce (func, wait, options) {
-  /**
-   * Creates a debounced function that delays invoking `func` until after `wait`
-   * milliseconds have elapsed since the last time the debounced function was
-   * invoked.
-   * @param {function} func
-   * @param {number} <wait=0> - number of milliseconds to delay
-   * @param {boolean} <options.leading=false> - invoke on the leading edge of the timeout
-   * @param {number} <options.maxWait> - maximum time `func` is allowed to be delayed before it's invoked
-   * @param {boolean} <options.trailing=true> - invoke on the trailing edge of the timeout
-   * @returns {Function}
-   * @see lodash
-   */
-  var lastArgs,
-    lastThis,
-    maxWait,
-    result,
-    timerId,
-    lastCallTime,
-    lastInvokeTime = 0,
-    leading = false,
-    maxing = false,
-    trailing = true
-
-  wait = typeof wait == 'number'? wait : 0
-  if (isObject(options)) {
+/**
+ * Creates a debounced function that delays invoking `func` until after `wait`
+ * milliseconds have elapsed since the last time the debounced function was invoked.
+ *
+ * @param {Function} func - The function to debounce.
+ * @param {number} [wait=0] - Number of milliseconds to delay.
+ * @param {{
+ *   leading?: boolean,  // invoke on the leading edge of the timeout (default: false)
+ *   maxWait?: number,   // maximum time `func` is allowed to be delayed before it's invoked 
+ *   trailing?: boolean, // invoke on the trailing edge of the timeout (default: true)
+ * }} [options] - Options to control behavior.
+ * @returns {(...args: any[]) => any & {
+ *   cancel: () => void, 
+ *   flush: () => any
+ * }} - A new debounced function with `cancel` and `flush` methods.
+ *
+ * @see https://lodash.com/docs/4.17.15#debounce
+ */
+export function debounce(func, wait = 0, options) {
+  /** @type {any[]|undefined} */
+  let lastArgs
+  /** @type {any} */
+  let lastThis
+  /** @type {number|undefined} */
+  let maxWait
+  /** @type {any} */
+  let result
+  /** @type {ReturnType<typeof setTimeout>|undefined} */
+  let timerId
+  /** @type {number|undefined} */
+  let lastCallTime
+  let lastInvokeTime = 0
+  let leading = false
+  let maxing = false
+  let trailing = true
+
+  if (options) {
     leading = !!options.leading
     maxing = 'maxWait' in options
-    maxWait = maxing ? Math.max(typeof options.maxWait == 'number'? options.maxWait : 0, wait) : maxWait
+    maxWait = maxing ? Math.max(typeof options.maxWait === 'number' ? options.maxWait : 0, wait) : undefined
     trailing = 'trailing' in options ? !!options.trailing : trailing
   }
 
+  /**
+   * @param {number} time
+   * @returns {any}
+   */
   function invokeFunc(time) {
-    var args = lastArgs
-    var thisArg = lastThis
+    const args = lastArgs
+    const thisArg = lastThis
     lastArgs = lastThis = undefined
     lastInvokeTime = time
-    result = func.apply(thisArg, args)
+    result = func.apply(thisArg, args ? args : [])
     return result
   }
 
+  /**
+   * @param {number} time
+   * @returns {any}
+   */
   function leadingEdge(time) {
     // Reset any `maxWait` timer.
     lastInvokeTime = time
@@ -179,27 +259,42 @@ export function debounce (func, wait, options) {
     return leading ? invokeFunc(time) : result
   }
 
+  /**
+   * @param {number} time
+   * @returns {number}
+   */
   function remainingWait(time) {
-    var timeSinceLastCall = time - lastCallTime,
-      timeSinceLastInvoke = time - lastInvokeTime,
-      timeWaiting = wait - timeSinceLastCall
+    const timeSinceLastCall = time - (lastCallTime ?? 0)
+    const timeSinceLastInvoke = time - lastInvokeTime
+    const timeWaiting = wait - timeSinceLastCall
     return maxing
-      ? Math.min(timeWaiting, maxWait - timeSinceLastInvoke)
+      ? Math.min(timeWaiting, (maxWait ?? 0) - timeSinceLastInvoke)
       : timeWaiting
   }
 
+  /**
+   * @param {number} time
+   * @returns {boolean}
+   */
   function shouldInvoke(time) {
-    var timeSinceLastCall = time - lastCallTime,
-      timeSinceLastInvoke = time - lastInvokeTime
+    const timeSinceLastCall = time - (lastCallTime ?? 0)
+    const timeSinceLastInvoke = time - lastInvokeTime
     // Either this is the first call, activity has stopped and we're at the
     // trailing edge, the system time has gone backwards and we're treating
     // it as the trailing edge, or we've hit the `maxWait` limit.
-    return (lastCallTime === undefined || (timeSinceLastCall >= wait) ||
-      (timeSinceLastCall < 0) || (maxing && timeSinceLastInvoke >= maxWait))
+    return (
+      lastCallTime === undefined ||
+      timeSinceLastCall >= wait ||
+      timeSinceLastCall < 0 ||
+      (maxing && timeSinceLastInvoke >= (maxWait ?? 0))
+    )
   }
 
+  /**
+   * @returns {any}
+   */
   function timerExpired() {
-    var time = Date.now()
+    const time = Date.now()
     if (shouldInvoke(time)) {
       return trailingEdge(time)
     }
@@ -207,6 +302,10 @@ export function debounce (func, wait, options) {
     timerId = setTimeout(timerExpired, remainingWait(time))
   }
 
+  /**
+   * @param {number} time
+   * @returns {any}
+   */
   function trailingEdge(time) {
     timerId = undefined
     // Only invoke if we have `lastArgs` which means `func` has been
@@ -218,6 +317,10 @@ export function debounce (func, wait, options) {
     return result
   }
 
+  /**
+   * Cancel any pending debounced invocation.
+   * @returns {void}
+   */
   function cancel() {
     if (timerId !== undefined) {
       clearTimeout(timerId)
@@ -226,16 +329,26 @@ export function debounce (func, wait, options) {
     lastArgs = lastCallTime = lastThis = timerId = undefined
   }
 
+  /**
+   * Immediately invoke the debounced function if pending.
+   * @returns {any}
+   */
   function flush() {
     return timerId === undefined ? result : trailingEdge(Date.now())
   }
 
-  function debounced() {
-    var time = Date.now(),
-      isInvoking = shouldInvoke(time)
+  /**
+   * The debounced function.
+   * @this {any}
+   * @param {...any} args
+   * @returns {any}
+   */
+  function debounced(...args) {
+    const time = Date.now()
+    const isInvoking = shouldInvoke(time)
 
-    lastArgs = arguments
-    lastThis = this // eslint-disable-line
+    lastArgs = args
+    lastThis = this
     lastCallTime = time
 
     if (isInvoking) {
@@ -243,10 +356,10 @@ export function debounce (func, wait, options) {
         return leadingEdge(lastCallTime)
       }
       if (maxing) {
-        // Handle invocations in a tight loop.
-        clearTimeout(timerId)
-        timerId = setTimeout(timerExpired, wait)
-        return invokeFunc(lastCallTime)
+      // Handle invocations in a tight loop.
+      clearTimeout(timerId)
+      timerId = setTimeout(timerExpired, wait)
+      return invokeFunc(lastCallTime)
       }
     }
     if (timerId === undefined) {
@@ -254,87 +367,137 @@ export function debounce (func, wait, options) {
     }
     return result
   }
+
   debounced.cancel = cancel
   debounced.flush = flush
   return debounced
 }
 
-export function deepCopy (obj) {
-  // Deep clones an object
+/**
+ * Deep clones an object or array, preserving its type
+ * @template T
+ * @param {T} obj - Object or array to deep clone
+ * @returns {T}
+ */
+export function deepCopy(obj) {
   if (!obj) return obj
-  let obj2 = Array.isArray(obj) ? [] : {}
-  for (let key in obj) {
-    let v = obj[key]
-    obj2[key] = typeof v === 'object' && !isHex24(v) ? deepCopy(v) : v
+  if (typeof obj !== 'object') return obj
+
+  // Create a new instance based on the input type
+  /** @type {any} */
+  const clone = Array.isArray(obj) ? [] : {}
+
+  for (const key in obj) {
+    const value = obj[key]
+    clone[key] = typeof value === 'object' && !isHex24(value) ? deepCopy(value) : value
   }
-  return obj2
+
+  return clone
 }
 
-export function deepFind (obj, path) {
-  // Returns a nested value from a path URI e.g. owner.houses.0.color
+/**
+ * Retrieves a nested value from an object or array from a dot-separated path.
+ * @param {object|any[]} obj - The source object or array.
+ * @param {string} path - Dot-separated path (e.g. "owner.houses.0.color").
+ * @returns {unknown} 
+ */
+export function deepFind(obj, path) {
   if (!obj) return undefined
-  let last
-  let chunks = (path || '').split('.')
+  if (typeof obj !== 'object') return undefined
+
+  const chunks = path.split('.')
+  /** @type {any} */
   let target = obj
-  for (let i = 0, l = chunks.length; i < l; i++) {
-    last = l === i + 1
-    if (!last && !target[chunks[i]]) break
-    else target = target[chunks[i]]
+
+  for (const chunk of chunks) {
+    if (target === null || target === undefined) return undefined
+    target = target[chunk]
   }
-  return last ? target : undefined
+
+  return target
 }
 
-export function deepSave (obj, path, value) {
-  /**
-   * Save a deeply nested value without mutating original object
-   * @param {object} obj
-   * @param {string} path
-   * @param {value|function(current-value) value - pass a function to access the current value
-   * @return new object
-   */
-  if (isArray(obj)) obj = [...obj]
-  else if (isObject(obj)) obj = {...obj}
-  else return undefined
+/**
+ * Saves a deeply nested value without mutating the original object.
+ * @template T
+ * @param {T} obj - The source object or array.
+ * @param {string} path - Dot-separated path to the nested property.
+ * @param {unknown|function} value - The value to set, or a function to compute it from the current value.
+ * @returns {T}
+ */
+export function deepSave(obj, path, value) {
+  if (obj === null || obj === undefined) return obj
 
+  /** @type {any} */
+  let clone = Array.isArray(obj) ? [...obj] : { ...obj }
   let chunks = (path || '').split('.')
-  let target = obj
+  let target = clone
+
   for (let i = 0, l = chunks.length; i < l; i++) {
-    if (l === i + 1) { // Last
-      target[chunks[i]] = isFunction(value) ? value(target[chunks[i]]) : value
-      // console.log(target)
+    const key = chunks[i]
+    const isLast = i === l - 1
+
+    if (isLast) {
+      target[key] = typeof value === 'function' ? value(target[key]) : value
     } else {
-      let isArray = chunks[i + 1].match(/^[0-9]+$/)
-      let parentCopy = isArray ? [...(target[chunks[i]] || [])] : { ...(target[chunks[i]] || {}) }
-      target = target[chunks[i]] = parentCopy
+      const nextIsArray = /^\d+$/.test(chunks[i + 1])
+      const current = target[key]
+
+      // If the next level doesn't exist, create an empty array/object
+      const parentCopy = nextIsArray
+        ? Array.isArray(current) ? [...current] : []
+        : isObject(current) ? { ...current } : {}
+
+      target = target[key] = parentCopy
     }
   }
-  return obj
+
+  return clone
 }
 
+/**
+ * Iterates over an object or array
+ * @param {{[key: string]: any}|[]|null} obj
+ * @param {function} iteratee
+ * @param {object} [context]
+ * @returns {object|[]|null}
+ */
 export function each (obj, iteratee, context) {
   // Similar to the underscore.each method
-  const shallowLen = obj == null ? void 0 : obj['length']
+  const shallowLen = obj === null ? void 0 : obj['length']
   const isArrayLike = typeof shallowLen == 'number' && shallowLen >= 0
-  if (isArrayLike) {
+  if (obj === null) {
+    return null
+  } else if (isArrayLike) {
     for (let i = 0, l = obj.length; i < l; i++) {
-      iteratee.call(context || null, obj[i], i, obj)
+      iteratee.call(context || null, /** @type {any[]} */(obj)[i], i, obj)
     }
   } else {
     for (let key in obj) {
       if (!obj.hasOwnProperty(key)) continue
-      iteratee.call(context || null, obj[key], key, obj)
+      iteratee.call(context || null, /** @type {{[key: string]: any}} */(obj)[key], key, obj)
     }
   }
   return obj
 }
 
+/**
+ * Downloads a file
+ * @param {string|Blob|File} data
+ * @param {string} filename
+ * @param {string} [mime]
+ * @param {string} [bom]
+ * @returns {void}
+ * 
+ * @link https://github.com/kennethjiang/js-file-download
+ */
 export function fileDownload (data, filename, mime, bom) {
-  // @link https://github.com/kennethjiang/js-file-download
+  if (typeof window === 'undefined') return
   let blobData = (typeof bom !== 'undefined') ? [bom, data] : [data]
   let blob = new Blob(blobData, {type: mime || 'application/octet-stream'})
 
-  if (typeof window.navigator.msSaveBlob !== 'undefined') {
-    window.navigator.msSaveBlob(blob, filename)
+  if (typeof /** @type {any} */(window.navigator).msSaveBlob !== 'undefined') {
+    /** @type {any} */(window.navigator).msSaveBlob(blob, filename)
   } else {
     let blobURL = (window.URL && window.URL.createObjectURL)
       ? window.URL.createObjectURL(blob)
@@ -357,12 +520,23 @@ export function fileDownload (data, filename, mime, bom) {
   }
 }
 
+/**
+ * Formats a string into a name
+ * @param {string} string
+ * @param {boolean} [ignoreHyphen]
+ * @returns {string}
+ */
 export function formatName (string, ignoreHyphen) {
   return ignoreHyphen
     ? ucFirst(string.toString().trim())
     : ucFirst(string.toString().trim().replace('-', ' '))
 }
 
+/**
+ * Formats a string into a slug
+ * @param {string} string
+ * @returns {string}
+ */
 export function formatSlug (string) {
   return string
     .toString()
@@ -374,85 +548,101 @@ export function formatSlug (string) {
     .replace(/-+$/, '') // Remove trailing -
 }
 
-export function formData (obj, cfg, fd, pre) {
+/**
+ * Serializes objects to FormData instances
+ * @param {object} obj
+ * @param {{ allowEmptyArrays?: boolean, indices?: boolean, nullsAsUndefineds?: boolean, booleansAsIntegers?: boolean }} [cfg] - config
+ * @param {FormData} [existingFormData]
+ * @param {string} [keyPrefix]
+ * @returns {FormData}
+ * @link https://github.com/therealparmesh/object-to-formdata
+ */
+export function formData (obj, cfg, existingFormData, keyPrefix) {
   /**
    * Serializes objects to FormData instances
-   * @param {object} obj
-   * @param {object} cfg - config, e.g. { allowEmptyArrays: true, indices: true }
-   * @link https://github.com/therealparmesh/object-to-formdata
+   * @param {{[key: string]: any}} obj
+   * @param {{ allowEmptyArrays?: boolean, indices?: boolean, nullsAsUndefineds?: boolean, booleansAsIntegers?: boolean }} [cfg] - config
+   * @param {FormData} [existingFormData]
+   * @param {string} [keyPrefix]
+   * @returns {FormData}
    */
-  const isUndefined = (value) => value === undefined
-  const isNull = (value) => value === null
-  const isBoolean = (value) => typeof value === 'boolean'
-  const isObject = (value) => value === Object(value)
-  const isArray = (value) => Array.isArray(value)
-  const isDate = (value) => value instanceof Date
-
-  const isBlob = (value) =>
-    value && typeof value.size === 'number' && typeof value.type === 'string' && typeof value.slice === 'function'
-
-  const isFile = (value) =>
-    isBlob(value) &&
-    typeof value.name === 'string' &&
-    (typeof value.lastModifiedDate === 'object' || typeof value.lastModified === 'number')
-
-  const serialize = (obj, cfg, fd, pre) => {
+  const serialize = (obj, cfg, existingFormData, keyPrefix='') => {
     cfg = cfg || {}
-    cfg.indices = isUndefined(cfg.indices) ? false : cfg.indices
-    cfg.nullsAsUndefineds = isUndefined(cfg.nullsAsUndefineds) ? false : cfg.nullsAsUndefineds
-    cfg.booleansAsIntegers = isUndefined(cfg.booleansAsIntegers) ? false : cfg.booleansAsIntegers
-    cfg.allowEmptyArrays = isUndefined(cfg.allowEmptyArrays) ? false : cfg.allowEmptyArrays
-    fd = fd || new FormData()
-
-    if (isUndefined(obj)) {
-      return fd
-    } else if (isNull(obj)) {
+    cfg.indices = cfg.indices === undefined ? false : cfg.indices
+    cfg.nullsAsUndefineds = cfg.nullsAsUndefineds === undefined ? false : cfg.nullsAsUndefineds
+    cfg.booleansAsIntegers = cfg.booleansAsIntegers === undefined ? false : cfg.booleansAsIntegers
+    cfg.allowEmptyArrays = cfg.allowEmptyArrays === undefined ? false : cfg.allowEmptyArrays
+    existingFormData = existingFormData || new FormData()
+
+    const isBlob = typeof obj === 'object' && 
+      'size' in obj && typeof obj.size === 'number' && 
+      'type' in obj && typeof obj.type === 'string' && 
+      'slice' in obj && typeof obj.slice === 'function'
+
+    const isFile = isBlob &&
+      'name' in obj && typeof obj.name === 'string' &&
+      (
+        ('lastModifiedDate' in obj && typeof obj.lastModifiedDate === 'object') || 
+        ('lastModified' in obj && typeof obj.lastModified === 'number')
+      )
+
+    if (obj === undefined) {
+      return existingFormData
+    } else if (obj === null) {
       if (!cfg.nullsAsUndefineds) {
-        fd.append(pre, '')
+        existingFormData.append(keyPrefix, '')
       }
-    } else if (isBoolean(obj)) {
+    } else if (typeof obj === 'boolean') {
       if (cfg.booleansAsIntegers) {
-        fd.append(pre, obj ? 1 : 0)
+        existingFormData.append(keyPrefix, obj ? '1' : '0')
       } else {
-        fd.append(pre, obj)
+        existingFormData.append(keyPrefix, obj)
       }
-    } else if (isArray(obj)) {
+    } else if (Array.isArray(obj)) {
       if (obj.length) {
         obj.forEach((value, index) => {
-          const key = pre + '[' + (cfg.indices ? index : '') + ']'
-          serialize(value, cfg, fd, key)
+          const key = keyPrefix + '[' + (cfg.indices ? index : '') + ']'
+          serialize(value, cfg, existingFormData, key)
         })
       } else if (cfg.allowEmptyArrays) {
-        fd.append(pre + '[]', '')
+        existingFormData.append(keyPrefix + '[]', '')
       }
-    } else if (isDate(obj)) {
-      fd.append(pre, obj.toISOString())
-    } else if (isObject(obj) && !isFile(obj) && !isBlob(obj)) {
+    } else if (obj instanceof Date) {
+      existingFormData.append(keyPrefix, obj.toISOString())
+    } else if (obj === Object(obj) && !isFile && !isBlob) {
       Object.keys(obj).forEach((prop) => {
         const value = obj[prop]
-        if (isArray(value)) {
+        if (Array.isArray(value)) {
           while (prop.length > 2 && prop.lastIndexOf('[]') === prop.length - 2) {
             prop = prop.substring(0, prop.length - 2)
           }
         }
-        const key = pre ? pre + '[' + prop + ']' : prop
-        serialize(value, cfg, fd, key)
+        const key = keyPrefix ? keyPrefix + '[' + prop + ']' : prop
+        serialize(value, cfg, existingFormData, key)
       })
     } else {
-      fd.append(pre, obj)
+      existingFormData.append(keyPrefix, /** @type {any} */(obj))
     }
-    return fd
+    return existingFormData
   }
-  return serialize(obj, cfg, fd, pre)
+  return serialize(obj, cfg, existingFormData, keyPrefix)
 }
 
+/**
+ * Returns capitalized full name
+ * @param {{firstName: string, lastName: string}} object
+ * @returns {string}
+ */
 export function fullName (object) {
-  // Returns full name
   return ucFirst(object.firstName) + ' ' + ucFirst(object.lastName)
 }
 
+/**
+ * Splits a full name into first and last names
+ * @param {string} string
+ * @returns {string[]} e.g. ['John', 'Smith']
+ */
 export function fullNameSplit (string) {
-  // Returns [firstName, lastName]
   string = string.trim().replace(/\s+/, ' ')
   if (string.match(/\s/)) {
     return [string.substring(0, string.lastIndexOf(' ')), string.substring(string.lastIndexOf(' ') + 1)]
@@ -461,6 +651,11 @@ export function fullNameSplit (string) {
   }
 }
 
+/**
+ * Returns a list of country options
+ * @param {{ [key: string]: { name: string } }} countries
+ * @returns {{ value: string, label: string, flag: string }[]}
+ */
 export function getCountryOptions (countries) {
   const output = []
   for (const iso in countries) {
@@ -470,6 +665,11 @@ export function getCountryOptions (countries) {
   return output
 }
 
+/**
+ * Returns a list of currency options
+ * @param {{ [iso: string]: { name: string } }} currencies
+ * @returns {{ value: string, label: string }[]}
+ */
 export function getCurrencyOptions (currencies) {
   const output = []
   for (const iso in currencies) {
@@ -482,11 +682,11 @@ export function getCurrencyOptions (currencies) {
 /**
  * Get the width of a prefix
  * @param {string} prefix
- * @param {number} paddingRight
+ * @param {number} [paddingRight=0]
  * @returns {number}
  */
 export function getPrefixWidth (prefix, paddingRight=0) {
-  if (!prefix) return 0
+  if (!prefix || typeof window === 'undefined') return 0
   const span = document.createElement('span')
   span.classList.add('input-prefix')
   span.style.visibility = 'hidden'
@@ -497,8 +697,14 @@ export function getPrefixWidth (prefix, paddingRight=0) {
   return width
 }
 
+/**
+ * Returns a list of project directories
+ * @param {{ join: (...args: string[]) => string }} path - e.g. `import path from 'path'`
+ * @param {string} [pwd]
+ * @returns {object}
+ */
 export function getDirectories (path, pwd) {
-  const _pwd = pwd || process.env.PWD
+  const _pwd = pwd || process.env.PWD || ''
   return {
     clientDir: path.join(_pwd, process.env.clientDir || 'client', '/'),
     componentsDir: path.join(_pwd, process.env.componentsDir || 'components', '/'),
@@ -509,81 +715,125 @@ export function getDirectories (path, pwd) {
   }
 }
 
-export function getLink (obj, query) {
-  /**
-   * @param {object} obj - new query object
-   * @param {object} <query> - current query object, window.location.search used otherwise
-   * @return {string}
-   */
-  let newQueryObj = {...(query||queryObject(window.location.search))}
-  for (let key in obj) {
-    if (!obj[key]) delete newQueryObj[key]
-    else newQueryObj[key] = obj[key]
-  }
-  return queryString(newQueryObj) || '?'
-}
-
+/**
+ * Returns a Stripe client promise
+ * @param {string} stripePublishableKey
+ * @returns {Promise<import('@stripe/stripe-js').Stripe|null>}
+ */
 export function getStripeClientPromise (stripePublishableKey) {
-  return global.stripeClientPromise || (global.stripeClientPromise = loadStripe(stripePublishableKey))
+  return stripeClientCache || (stripeClientCache = loadStripe(stripePublishableKey))
 }
 
+/**
+ * Returns a list of response errors
+ * 
+ * @typedef {{ title: string, detail: string }} NitroError
+ * @typedef {{ toJSON: () => { message: string } }} MongoError
+ * @typedef {{ response: { data: { errors?: NitroError[], error?: string, error_description?: string } } }} AxiosWithErrors
+ * 
+ * @typedef {Error|NitroError[]|MongoError|AxiosWithErrors|string|any} NitroErrorRaw
+ * 
+ * @param {NitroErrorRaw} errs
+ * @returns {NitroError[]}
+ */
 export function getResponseErrors (errs) {
+  // new Error
+  if (errs instanceof Error || errs === null) {
+    console.info('getResponseErrors(): ', errs)
+    return [{ title: 'error', detail: 'Oops there was an error' }]
+
+  // Array of error objects
+  } else if (Array.isArray(errs)) {
+    return errs
+
+  // Mongo errors (when called on the backend, now coming before Axios errors...)
+  } else if (typeof errs === 'object' && 'toJSON' in errs) {
+    return [{ title: 'error', detail: errs.toJSON().message }]
+  
   // Axios response errors
-  if (errs.response && errs.response.data && errs.response.data.errors) {
-    var errors = errs.response.data.errors
-  // Axios response error
-  } else if (errs.response && errs.response.data && errs.response.data.error) {
-    errors = [{ title: errs.response.data.error, detail: errs.response.data.error_description }]
-  // Array
-  } else if (isArray(errs)) {
-    errors = errs
-  // Error object
-  } else if (errs.toJSON) {
-    errors = [{ title: 'error', detail: errs.toJSON().message }]
+  } else if (typeof errs === 'object' && errs?.response?.data?.errors) {
+    return errs.response.data.errors
+
+  // // Axios response error
+  } else if (typeof errs === 'object' && errs?.response?.data?.error) {
+    return [{ title: errs.response.data.error, detail: errs.response.data.error_description || '' }]
+
   // String
   } else if (typeof errs === 'string') {
-    errors = [{ title: 'error', detail: errs }]
+    return [{ title: 'error', detail: errs }]
+
   // Default error message
   } else {
     console.info('getResponseErrors(): ', errs)
-    errors = [{ title: 'error', detail: 'Oops there was an error' }]
+    return [{ title: 'error', detail: 'Oops there was an error' }]
   }
-  return errors
 }
 
-export function inArray (array, key, value) {
-  /**
-   * Property match inside an array of objects
-   * (For a string/number value check just use [].includes(x))
-   * @param {string} <key> - optional to match across on a colleciton of objects
-   * @param {any} value
-   */
-  if (!array || typeof key == 'undefined') return false
-  if (typeof value == 'undefined') return array.includes(key)
-  for (let i = array.length; i--; ) {
-    if (array[i] && array[i].hasOwnProperty(key) && array[i][key] == value) return array[i]
-  }
+/**
+ * Checks if a value is in an array (todo, update this to not use optional key)
+ * @param {any[]} array
+ * @param {unknown} [value]
+ * @param {string} [key] - optional, to match across on a colleciton of objects
+ * @returns {boolean}
+ */
+export function inArray (array, value, key) {
+  if (!array || typeof value == 'undefined') return false
+  else if (typeof key == 'undefined') return array.includes(value)
+  else 
+    for (let i = array.length; i--; ) {
+      if (typeof array[i] === 'object') {
+        /** @type {{[key: string]: unknown}} */
+        const item = array[i]
+        if (key in item && array[i][key] == value) return array[i]
+      }
+    }
   return false
 }
 
+/**
+ * Checks if a variable is an array
+ * @param {unknown} variable
+ * @returns {boolean}
+ */
 export function isArray (variable) {
   return Array.isArray(variable)
 }
 
+/**
+ * Checks if a variable is a date
+ * @param {unknown} variable
+ * @returns {boolean}
+ */
 export function isDate (variable) {
-  return variable && typeof variable.getMonth === 'function'
+  return !!(typeof variable === 'object' && variable && 'getMonth' in variable)
 }
 
+/**
+ * Checks if a variable is defined
+ * @param {unknown} variable
+ * @returns {boolean}
+ */
 export function isDefined (variable) {
   return typeof variable !== 'undefined'
 }
 
+/**
+ * Checks if a variable is an email
+ * @param {string} email
+ * @returns {boolean}
+ */
 export function isEmail (email) {
   // eslint-disable-next-line
   const re = /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/
   return re.test(String(email).toLowerCase())
 }
 
+/**
+ * Checks if an object is empty
+ * @param {{[key: string]: unknown}|null} [obj]
+ * @param {boolean} [truthyValuesOnly]
+ * @returns {boolean}
+ */
 export function isEmpty (obj, truthyValuesOnly) {
   // note req.files doesn't have a hasOwnProperty method
   if (obj === null || typeof obj === 'undefined') return true
@@ -593,10 +843,20 @@ export function isEmpty (obj, truthyValuesOnly) {
   return true
 }
 
+/**
+ * Checks if a variable is a function
+ * @param {unknown} variable
+ * @returns {boolean}
+ */
 export function isFunction (variable) {
   return typeof variable === 'function' ? true : false
 }
 
+/**
+ * Checks if a variable is a hex string
+ * @param {unknown} value
+ * @returns {boolean}
+ */
 export function isHex24 (value) {
   // Fast function to check if the length is exactly 24 and all characters are valid hexadecimal digits
   const str = (value||'').toString()
@@ -616,8 +876,13 @@ export function isHex24 (value) {
   return true
 }
 
+/**
+ * Checks if a variable is a number
+ * @param {unknown} variable
+ * @returns {boolean}
+ */
 export function isNumber (variable) {
-  return !isNaN(parseFloat(variable)) && isFinite(variable)
+  return !isNaN(parseFloat(/** @type {string} */(variable))) && isFinite(/** @type {number} */(variable))
 }
 
 /**
@@ -630,18 +895,40 @@ export function isObject (variable) {
   return variable !== null && typeof variable === 'object' && !(variable instanceof Array) ? true : false
 }
 
+/**
+ * Checks if a variable is a regex
+ * @param {unknown} variable
+ * @returns {boolean}
+ */
 export function isRegex (variable) {
   return variable instanceof RegExp ? true : false
 }
 
+/**
+ * Checks if a variable is a string
+ * @param {unknown} variable
+ * @returns {boolean}
+ */
 export function isString (variable) {
   return typeof variable === 'string' || variable instanceof String ? true : false
 }
 
+/**
+ * Converts the first character of a string to lowercase
+ * @param {string} string
+ * @returns {string}
+ */
 export function lcFirst (string) {
   return string.charAt(0).toLowerCase() + string.slice(1)
 }
 
+/**
+ * Trims a string to a maximum length, and removes any partial words at the end
+ * @param {string} string
+ * @param {number} [len=100]
+ * @param {boolean} [showEllipsis=true]
+ * @returns {string}
+ */
 export function maxLength (string, len, showEllipsis) {
   // Trims to a maximum length, and removes any partial words at the end
   len = len || 100
@@ -655,41 +942,48 @@ export function maxLength (string, len, showEllipsis) {
     + (showEllipsis ? '...' : '')
 }
 
-export function mongoAddKmsToBox (km, bottomLeft, topRight) {
-  /**
-   * Expands a mongodb lat/lng box in kms
-   * @param  {number} km
-   * @param  {Array[lng, lat]|Box} bottomLeft
-   * @param  {Array[lng, lat]} topRight
-   * @return [bottomLeft, topRight]
-   *
-   * Handy box tester
-   * https://www.keene.edu/campus/maps/tool/
-   *
-   * Returned Google places viewport (i.e. `place.geometry.viewport`)
-   * {
-   *   Qa: {g: 174.4438160493033, h: 174.9684260722261} == [btmLng, topLng]
-   *   zb: {g: -37.05901990116617, h: -36.66060184426172} == [btmLat, topLat]
-   * }
-   *
-   * We then convert above into `address.area.bottomLeft|topRight`
-   *
-   * Rangiora box
-   * [[172.5608731356091,-43.34484397837406] (btm left)
-   * [172.6497429548984,-43.28025140057695]] (top right)
-   *
-   * Auckland box
-   * [[174.4438160493033,-37.05901990116617] (btm left)
-   * [174.9684260722261,-36.66060184426172]] (top right)
-   */
-  if (bottomLeft && bottomLeft.bottomLeft) {
-    topRight = bottomLeft.topRight
-    bottomLeft = bottomLeft.bottomLeft
+/**
+ * Expands a mongodb lng/lat box in kms, and returns the expanded box
+ * @typedef {[number, number]} Point - lng/lat
+ * @typedef {{bottomLeft: Point, topRight: Point}} Box
+ * 
+ * @param {number} km
+ * @param {Point|Box} bottomLeftOrBox
+ * @param {Point} [topRight]
+ * @returns {[Point, Point]|null} (e.g. [bottomLeft, topRight])
+ * 
+ * Handy box tester
+ * https://www.keene.edu/campus/maps/tool/
+ *
+ * Returned Google places viewport (i.e. `place.geometry.viewport`)
+ * {
+ *   Qa: {g: 174.4438160493033, h: 174.9684260722261} == [btmLng, topLng]
+ *   zb: {g: -37.05901990116617, h: -36.66060184426172} == [btmLat, topLat]
+ * }
+ *
+ * We then convert above into `address.area.bottomLeft|topRight`
+ *
+ * Rangiora box
+ * [[172.5608731356091,-43.34484397837406] (btm left)
+ * [172.6497429548984,-43.28025140057695]] (top right)
+ *
+ * Auckland box
+ * [[174.4438160493033,-37.05901990116617] (btm left)
+ * [174.9684260722261,-36.66060184426172]] (top right)
+ */
+export function mongoAddKmsToBox (km, bottomLeftOrBox, topRight) {
+  if (typeof bottomLeftOrBox === 'object' && 'bottomLeft' in bottomLeftOrBox) {
+    topRight = bottomLeftOrBox.topRight
+    var bottomLeft = bottomLeftOrBox.bottomLeft
+  } else {
+    bottomLeft = bottomLeftOrBox
   }
   if (!bottomLeft || !topRight) {
     return null
   }
+  /** @param {number} lat @param {number} kms @returns {number} */
   let lat = (lat, kms) => lat + (kms / 6371) * (180 / Math.PI)
+  /** @param {number} lng @param {number} lat @param {number} kms @returns {number} */
   let lng = (lng, lat, kms) => lng + (kms / 6371) * (180 / Math.PI) / Math.cos(lat * Math.PI/180)
   return [
     [lng(bottomLeft[0], bottomLeft[1], -km), lat(bottomLeft[1], -km)],
@@ -697,28 +991,38 @@ export function mongoAddKmsToBox (km, bottomLeft, topRight) {
   ]
 }
 
+/**
+ * Returns a mongo query to find documents within a passed address
+ * @param {{
+ *   area?: {bottomLeft: [number, number], topRight: [number, number]}
+ *   location?: {coordinates: [number, number]}
+ * }} address
+ * @param {number} km
+ * @param {string} prefix
+ * @returns {Object}
+ */
 export function mongoDocWithinPassedAddress (address, km, prefix) {
-  let type = ''
+  // let type = ''
   let areaSize = 5
-  if (type == 'geoNear') {
-    // NOT USING
-    // Must be the first stage in an aggregate pipeline
-    if (address.area) {
-      areaSize = mongoPointDifference(address.area.bottomLeft, address.area.topRight)
-    }
-    // console.log('kms', (areaSize / 2))
-    return {
-      $geoNear: {
-        near: {
-          type: 'Point',
-          coordinates: [address.location.coordinates[0], address.location.coordinates[1]],
-        },
-        distanceField: 'distance',
-        maxDistance: ((areaSize / 2) + km) / 6371,  // km / earth's radius in km = radians
-        spherical: true,
-      },
-    }
-  } else if (address.area) {
+  // if (type == 'geoNear') {
+  //   // NOT USING
+  //   // Must be the first stage in an aggregate pipeline
+  //   if (address.area) {
+  //     areaSize = mongoPointDifference(address.area.bottomLeft, address.area.topRight)
+  //   }
+  //   // console.log('kms', (areaSize / 2))
+  //   return {
+  //     $geoNear: {
+  //       near: {
+  //         type: 'Point',
+  //         coordinates: [address.location.coordinates[0], address.location.coordinates[1]],
+  //       },
+  //       distanceField: 'distance',
+  //       maxDistance: ((areaSize / 2) + km) / 6371,  // km / earth's radius in km = radians
+  //       spherical: true,
+  //     },
+  //   }
+  if ('area' in address && address.area) {
     let box = mongoAddKmsToBox(km, address.area)
     return {
       [`${prefix}location`]: {
@@ -727,7 +1031,7 @@ export function mongoDocWithinPassedAddress (address, km, prefix) {
         },
       },
     }
-  } else {
+  } else if ('location' in address && address.location) {
     return {
       [`${prefix}location`]: {
         $geoWithin: {
@@ -738,17 +1042,20 @@ export function mongoDocWithinPassedAddress (address, km, prefix) {
         },
       },
     }
+  } else {
+    throw new Error('Missing address.location or address.area')
   }
 }
 
+/**
+ * Find the distance in km between to points
+ * @param {number[]} point1 - [lng, lat] ([192.2132.., 212.23323..])
+ * @param {number[]} point2 - [lng, lat] ([192.2132.., 212.23323..])
+ * @return {number} kms
+ */
 export function mongoPointDifference (point1, point2) {
-  /**
-   * Find the distance in km between to points
-   * @param {array} point1 - [192.2132.., 212.23323..]
-   * @param {array} point2 - [192.2132.., 212.23323..]
-   * @return {number} kms
-   */
   let R = 6371 // km
+  /** @param {number} degrees @returns {number} */
   let mongoDegreesToRadians = (degrees) => degrees * (Math.PI / 180)
   let dLat = mongoDegreesToRadians(point2[1]-point1[1])
   let dLon = mongoDegreesToRadians(point2[0]-point1[0])
@@ -759,16 +1066,29 @@ export function mongoPointDifference (point1, point2) {
     Math.sin(dLon/2) * Math.cos(lat1) * Math.cos(lat2)
   let c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1-a))
   let d = R * c
-  return d.toFixed(1)
+  return parseFloat(d.toFixed(1))
 }
 
+/**
+ * Maps over an object
+ * @param {{ [key: string]: any }} object
+ * @param {(value: any, key: string) => any} fn
+ */
 export function objectMap (object, fn) {
+  /** @type {{ [key: string]: any }} */
+  const result = {}
   return Object.keys(object).reduce(function(result, key) {
     result[key] = fn(object[key], key)
     return result
-  }, {})
+  }, result)
 }
 
+/**
+ * Omits fields from an object
+ * @param {{ [key: string]: unknown }} obj
+ * @param {string[]} fields
+ * @returns {{ [key: string]: unknown }}
+ */
 export function omit (obj, fields) {
   const shallowCopy = Object.assign({}, obj)
   for (let i=0; i<fields.length; i+=1) {
@@ -780,40 +1100,63 @@ export function omit (obj, fields) {
 
 /**
  * Updates state from an input event, you can also update deep state properties
- * @param {Event|Array[{string},{string|number|fn}]}
- *   {Event} - pass the event object            e.g. <input onChange={(e) => onChange.call(setState, e)}>
- *   {Array} - pass an array with [path, value] e.g. <input onChange={(e) => onChange.call(setState, e, ['name', 'Joe'])}>
+ * @param {(
+ *   ChangeEvent | // e.g. <input onChange={(e) => onChange.call(setState, e)}>
+ *   PathValue     // e.g. <input onChange={(e) => onChange.call(setState, e, ['address.name', 'Joe'])}> // [id, value]
+ * )} eventOrPathValue
  * @param {Function} [beforeSetState] - optional function to run before setting the state
- * @this {Function} setState
- * @return {Promise({state, chunks, target})}
+ * @returns {Promise<object>}
+ * @this {function}
+ * 
+ * @typedef {import('react').ChangeEvent} ChangeEvent
+ * @typedef {[
+ *   string,           // can be a path (e.g. 'name.first')
+ *   function|unknown, // value or function to set the value to
+ * ]} PathValue
  */
-export function onChange (event, beforeSetState) {
+export function onChange (eventOrPathValue, beforeSetState) {
   if (!isFunction(this)) {
     throw new Error('Missing setState, please either call or bind setState to the function. E.g. onChange.call(setState, e)')
   }
-  let elem = event.target ? event.target : { id: event[0], value: event[1] }
-  let chunks = (elem.id || elem.name).split('.')
-  let value = elem.files
-    ? elem.files[0]
-    : elem.type === 'checkbox'
-      ? elem.checked
-      : isDefined(elem._value) 
-        ? elem._value 
-        : elem.value
-
+  
+  /** @type {unknown|function} */
+  let value
+  /** @type {string[]} */
+  let chunks = []
+  /** @type {boolean} */
+  let hasFiles
+  
+  if (eventOrPathValue instanceof Event && eventOrPathValue.target) {
+    const element = /** @type {HTMLInputElement & {_value?: unknown}} */(eventOrPathValue.target) // we need to assume this is an input
+    chunks = (element.id || element.name).split('.')
+    hasFiles = !!element.files
+    value = element.files
+      ? element.files[0]
+      : typeof element._value !== 'undefined'
+        ? element._value
+        : element.type === 'checkbox'
+          ? element.checked
+          : element.value
+
+  } else if (Array.isArray(eventOrPathValue)) {
+    chunks = eventOrPathValue[0].split('.')
+    value = eventOrPathValue[1]
+  }
+  
   // Removing leading zero(s) on number fields
-  // if (elem.type == 'number' && !isFunction(value) && (value||'').match(/^0+([1-9])/)) {
+  // if (element.type == 'number' && !isFunction(value) && (value||'').match(/^0+([1-9])/)) {
   //   value = value.replace(/^0+([1-9])/, '$1')
   // }
 
   // Update state
   return new Promise((resolve) => {
-    this((state) => {
-      const newState = { ...state, ...(elem.files ? { hasFiles: true } : {}) }
+    this((/** @type object */ state) => {
+      /** @type {{[key: string]: any}} */
+      const newState = { ...state, ...(hasFiles ? { hasFiles } : {}) }
       let target = newState
       for (var i = 0, l = chunks.length; i < l; i++) {
         if (l === i + 1) { // Last
-          target[chunks[i]] = isFunction(value) ? value(state) : value
+          target[chunks[i]] = typeof value === 'function' ? value(state) : value
           // console.log(target)
         } else {
           let isArray = chunks[i + 1].match(/^[0-9]+$/)
@@ -830,97 +1173,118 @@ export function onChange (event, beforeSetState) {
   })
 }
 
-export function pad (num, padLeft, fixedRight) {
-  num = parseFloat(num || 0)
+/**
+ * Pads a number
+ * @param {number} [num=0]
+ * @param {number} [padLeft=0]
+ * @param {number} [fixedRight]
+ * @returns {string}
+ */
+export function pad (num=0, padLeft=0, fixedRight) {
+  num = parseFloat(num + '')
   if (fixedRight || fixedRight === 0) {
-    return num.toFixed(fixedRight).padStart((padLeft||0) + fixedRight + 1, '0')
+    return num.toFixed(fixedRight).padStart(padLeft + fixedRight + 1, '0')
   } else {
     if (padLeft && `${num}`.match('.')) padLeft += (`${num}`.split('.')[1]||'').length + 1
     return `${num}`.padStart(padLeft, '0')
   }
 }
 
+/**
+ * Picks fields from an object
+ * @param {{ [key: string]: any }} obj
+ * @param {string|RegExp|string[]|RegExp[]} keys
+ */
 export function pick (obj, keys) {
   // Similiar to underscore.pick
-  // @param {string[] | regex[]} keys
   if (!isObject(obj) && !isFunction(obj)) return {}
-  keys = toArray(keys)
-  let res = {}
-  for (let key of keys) {
-    if (isString(key) && obj.hasOwnProperty(key)) res[key] = obj[key]
-    if (isRegex(key)) {
+  const keysArr = toArray(keys)
+  /** @type {{ [key: string]: unknown }} */
+  let output = {}
+  for (let key of keysArr) {
+    if (typeof key === 'string' && obj.hasOwnProperty(key)) output[key] = obj[key]
+    else if (key instanceof RegExp ) {
       for (let key2 in obj) {
-        if (obj.hasOwnProperty(key2) && key2.match(key)) res[key2] = obj[key2]
+        if (obj.hasOwnProperty(key2) && key2.match(key)) output[key2] = obj[key2]
       }
     }
   }
-  return res
+  return output
 }
 
-export function queryObject (search, assignTrue) {
-  /*
-    * Parses a query string into an object, or returns the last known matching cache
-    * @param {string} search - location.search or location.href, e.g. '?page=1', 'https://...co.nz?page=1'
-    * @param {boolean} assignTrue - assign true to empty values
-    * @return {object} e.g. { page: 1 }
-    */
-  search = search.replace(/^[^?]+\?/, '?') // remove domain preceeding search string
+/**
+ * 
+ * Parses a query string into an object, or returns the last known matching cache
+ * @param {string} searchString - location.search or location.href, e.g. '?page=1', 'https://...co.nz?page=1'
+ * @param {boolean} [trueDefaults] - assign true to empty values
+ * @returns {{[key: string]: string|true}} - e.g. { page: '1' }
+ * UPDATE: removed array values, e.g. '?page=1&page=2' will return { page: '2' }
+ */
+export function queryObject (searchString, trueDefaults) {
+  searchString = searchString.replace(/^[^?]+\?/, '?') // remove domain preceeding search string
+  const uniqueKey = searchString + (trueDefaults ? '-true' : '')
+  /** @type {{[key: string]: string|true}} */
   let obj = {}
-  if (search === '') return obj
-  if (!queryObject.queryObjectCache) queryObject.queryObjectCache = {}
-  if (queryObject.queryObjectCache[search]) return { ...queryObject.queryObjectCache[search] }
+
+  if (searchString === '') return {}
+  if (!queryObjectCache) queryObjectCache = {}
+  if (queryObjectCache[uniqueKey]) return queryObjectCache[uniqueKey]
 
   // Remove '?', and split each query parameter (ampersand-separated)
-  search = search.slice(1).split('&')
+  const searchParams = searchString.slice(1).split('&')
 
   // Loop through each query paramter
-  search.map(function (part) {
-    part = part.split('=') // Split into key/value
-    let key = part[0]
-    let value = !part[1] && part[1] !== 0 ? (assignTrue ? true : '') : decodeURIComponent(part[1])
-
-    // Key already exists
-    if (obj[key]) {
-      obj[key] = toArray([obj[key]])
-      obj[key].push(value)
+  searchParams.map(function (part) {
+    const partArr = part.split('=') // Split into key/value
+    const key = partArr[0]
+    const isEmpty = !partArr[1] && partArr[1] != '0'
+
+    if (trueDefaults === true) {
+      obj[key] = isEmpty ? true : decodeURIComponent(partArr[1])
     } else {
-      obj[key] = value
+      obj[key] = decodeURIComponent(partArr[1])
     }
   })
 
-  queryObject.queryObjectCache = { [search]: obj }
-  return { ...obj }
+  queryObjectCache[uniqueKey] = obj
+  return obj
 }
 
+/**
+ * Parses an object and returns a query string
+ * @param {{[key: string]: unknown}} [obj] - query object
+ * @returns {string}
+ */
 export function queryString (obj) {
-  /*
-    * Parses an object and returns a query string
-    * @param {object} obj - query object
-    */
-  obj = { ...(obj||{}) }
+  /** @type {{[key: string]: string}} */
+  const newObj = {}
+
   for (let key in obj) {
     if (obj.hasOwnProperty(key)) {
-      if (typeof obj[key] == 'undefined') delete obj[key]
-      else if (!obj[key]) delete obj[key]
+      if (typeof obj[key] == 'undefined' || !obj[key]) continue
+      newObj[key] = obj[key] + ''
     }
   }
-  let qs = new URLSearchParams(obj).toString()
+  let qs = new URLSearchParams(newObj).toString()
   return qs ? `?${qs}` : ''
 }
 
+/**
+ * Axios request to the route
+ * @param {string} route - e.g. 'post /api/user'
+ * @param {{ [key: string]: any }} [data] - payload
+ * @param {{preventDefault?: function}} [event] - event to prevent default
+ * @param {[boolean, (value: boolean) => void]} [isLoading] - [isLoading, setIsLoading]
+ * @returns {Promise<any>}
+ */
 export async function request (route, data, event, isLoading) {
-  /**
-   * Axios request to the route
-   * @param {string} route - e.g. 'post /api/user'
-   * @param {object} <data> - payload
-   * @param {Event} <event> - event to prevent default
-   * @param {array} <isLoading> - [isLoading, setIsLoading]
-   * @return {promise}
-   */
   try {
     if (event?.preventDefault) event.preventDefault()
     const uri = route.replace(/^(post|put|delete|get) /, '')
-    const method = (route.match(/^(post|put|delete|get) /)?.[1] || 'post').trim()
+    const method =
+      /** @type {'post'|'put'|'delete'|'get'} */ (
+      (route.match(/^(post|put|delete|get) /)?.[1] || 'post').trim()
+    )
 
     // show loading
     if (isLoading) {
@@ -932,20 +1296,26 @@ export async function request (route, data, event, isLoading) {
     data = data || {}
     delete data.errors
 
-    // has files, if yes, convert to form data
-    let hasFiles
+    // Find out if the data has files?
+    let hasFiles = false
+    /** @param {unknown} o */
     let recurse = (o) => {
       if (o instanceof File || hasFiles) hasFiles = true
       else if (o && typeof o === 'object') each(o, recurse)
     }
     recurse(data)
-    if (hasFiles) {
-      data = formData(data, { allowEmptyArrays: true, indices: true })
-    }
+
+    // If yes, convert to form data
+    /** @type {FormData|undefined} */
+    const formData2 = hasFiles ? formData(data, { allowEmptyArrays: true, indices: true }) : undefined
 
     // send the request
+    const axiosPromise = (method === 'get' || method === 'delete') 
+      ? axios()[method](uri, { withCredentials: true })
+      : axios()[method](uri, formData2 || data, { withCredentials: true })
+
     const [res] = await Promise.allSettled([
-      axios()[method](uri, data, { withCredentials: true }),
+      axiosPromise,
       setTimeoutPromise(() => {}, 200), // eslint-disable-line
     ])
 
@@ -960,6 +1330,11 @@ export async function request (route, data, event, isLoading) {
   }
 }
 
+/**
+ * Removes undefined from an array or object
+ * @param {[]|{[key: string]: any}} variable
+ * @returns {[]|{[key: string]: any}}
+ */
 export function removeUndefined (variable) {
   // Removes undefined from an array or object
   if (Array.isArray(variable)) {
@@ -968,55 +1343,58 @@ export function removeUndefined (variable) {
     }
   } else {
     Object.keys(variable).forEach((key) => {
-      if (variable[key] === undefined) delete variable[key]
+      if (key in variable && variable[key] === undefined) delete variable[key]
     })
   }
   return variable
 }
 
-export function s3Image (awsUrl, image, size='full', i) {
-  /**
-   * Build image URL from image array or object
-   * @param {string} awsUrl - e.g. 'https://s3.amazonaws.com/...'
-   * @param {array|object} image - file object/array
-   * @param {string} <size> - overrides to 'full' when the image sizes are still processing
-   * @param {integer} <i> - array index
-   */
+/**
+ * Build image URL from image array or object
+ * @typedef {{path: string, bucket: string, base64?: string, date?: number}} Image
+ * @param {string} awsUrl - e.g. 'https://s3.amazonaws.com/...'
+ * @param {Image[]|Image} imageOrArray - file object/array
+ * @param {string} [size] - overrides to 'full' when the image sizes are still processing
+ * @param {number} [i] - array index
+ * @returns {string}
+ */
+export function s3Image (awsUrl, imageOrArray, size='full', i) {
   let lambdaDelay = 7000
   let usingMilliseconds = true
 
-  if (!isObject(image)) image = (image && image[i]) ? image[i] : null
+  const image = /**@type {Image}*/(Array.isArray(imageOrArray) ? imageOrArray[i||0] : imageOrArray)
   if (!image) return ''
   // Alway use preview if available
   if (image.base64) return image.base64
   // Wait a moment before the different sizes are generated by lambda
-  if (((usingMilliseconds ? image.date : image.date * 1000) + lambdaDelay) > new Date()) size = 'full'
+  if (((usingMilliseconds ? (image.date || 0) : (image.date || 0) * 1000) + lambdaDelay) > new Date().getTime()) size = 'full'
   let key = size == 'full' ? image.path : `${size}/${image.path.replace(/^full\/|\.[a-z0-9]{3,4}$/ig, '')}.jpg`
   return awsUrl + image.bucket + '/' + key
 }
 
+/**
+ * Sanitize and encode all HTML in a user-submitted string
+ * @param {string} string
+ * @returns {string}
+ */
 export function sanitizeHTML (string) {
-  /*
-    * Sanitize and encode all HTML in a user-submitted string
-    * (c) 2018 Chris Ferdinandi, MIT License, https://gomakethings.com
-    * @param  {String} str  The user-submitted string
-    * @return {String} str  The sanitized string
-    */
   var temp = document.createElement('div')
   temp.textContent = string
   return temp.innerHTML
 }
 
+/**
+ * Process scrollbar width once.
+ * @param {string} paddingClass - class name to give padding to
+ * @param {string} marginClass - class name to give margin to
+ * @param {number} maxWidth - enclose css in a max-width media query
+ * @returns {number}
+ * 
+ */
 export function scrollbar (paddingClass, marginClass, maxWidth) {
-  /**
-   *  Process scrollbar width once.
-   *  @param {string} paddingClass - class name to give padding to
-   *  @param {string} marginClass - class name to give margin to
-   *  @param {number} maxWidth - enclose css in a max-width media query
-   *  @return width.
-   */
-  if (scrollbar.width || scrollbar.width === 0) {
-    return scrollbar.width
+  if (typeof window === 'undefined') return 0
+  if (scrollbarCache || scrollbarCache === 0) {
+    return scrollbarCache
   }
 
   var outer = document.createElement('div')
@@ -1039,25 +1417,30 @@ export function scrollbar (paddingClass, marginClass, maxWidth) {
   var widthWithScroll = inner.offsetWidth
 
   // Remove divs
-  outer.parentNode.removeChild(outer)
-  scrollbar.width = widthNoScroll - widthWithScroll
+  if (outer.parentNode) outer.parentNode.removeChild(outer)
+  scrollbarCache = widthNoScroll - widthWithScroll
 
-  // Add padding class.
+  // Add padding class. (CHANGED, need to test)
   if (paddingClass || marginClass) {
-    document.head.appendChild( // double check this, was jquery
-      '<style type="text/css">' +
+    const style = document.createElement('style')
+    style.textContent = 
       (maxWidth ? '@media only screen and (max-width: ' + maxWidth + 'px) {' : '') +
-      (paddingClass ? paddingClass + ' {padding-right:' + scrollbar.width + 'px}' : '') +
-      (marginClass ? marginClass + ' {margin-right:' + scrollbar.width + 'px}' : '') +
-      (maxWidth ? '}' : '') +
-      '</style>'
-    )
+      (paddingClass ? paddingClass + ' {padding-right:' + scrollbarCache + 'px}' : '') +
+      (marginClass ? marginClass + ' {margin-right:' + scrollbarCache + 'px}' : '') +
+      (maxWidth ? '}' : '')
+    document.head.appendChild(style)
   }
 
   // return.
-  return scrollbar.width
+  return scrollbarCache
 }
 
+/**
+ * Convert seconds to time
+ * @param {number} seconds
+ * @param {boolean} [padMinute]
+ * @returns {string}
+ */
 export function secondsToTime (seconds, padMinute) {
   seconds = Math.round(seconds)
   let hours = Math.floor(seconds / (60 * 60))
@@ -1067,79 +1450,67 @@ export function secondsToTime (seconds, padMinute) {
   let secs = Math.ceil(divisor_for_seconds)
   let data = {
     h: (hours + ''),
-    m: (minutes + '').padStart(padMinute? 2 : 1, 0),
+    m: (minutes + '').padStart(padMinute ? 2 : 1, '0'),
     s: (secs + ''),
   }
   return data.h + ':' + data.m
 }
 
+/**
+ * Promise wrapper for setTimeout
+ * @param {function} func
+ * @param {number} milliseconds
+ * @returns {Promise<void>}
+ */
 export function setTimeoutPromise (func, milliseconds) {
   return new Promise(function(resolve) {
     setTimeout(() => resolve(func()), milliseconds)
   })
 }
 
+/**
+ * Shows a global error
+ * @param {function} setStore
+ * @param {NitroErrorRaw} errs
+ */
 export function showError (setStore, errs) {
-  /**
-   * Shows a global error
-   * @params {function} setStore
-   * @params {Array|Error|String|Axios Object} errs
-   */
   let detail = getResponseErrors(errs)[0].detail
-  setStore((o) => ({ ...o, message: { type: 'error', text: detail } }))
+  setStore((/** @type {{[key: string]: any}} */o) => ({ ...o, message: { type: 'error', text: detail } }))
 }
 
-export function sortByKey (objects, key) {
-  return objects.sort(function (a, b) {
-    var textA = (a[key] || '').toUpperCase()
-    var textB = (b[key] || '').toUpperCase()
+/**
+ * Sort an array of objects by a key
+ * @param {{[key: string]: any}[]} collection
+ * @param {string} key
+ * @returns {object[]}
+ */
+export function sortByKey (collection, key) {
+  return collection.sort(function (a, b) {
+    var textA = (key in a ? a[key] : '').toUpperCase()
+    var textB = (key in b ? b[key] : '').toUpperCase()
     return textA < textB ? -1 : textA > textB ? 1 : 0
   })
 }
 
-export function sortFromQuery (req, sortMap, sortByDefault='createdAt') {
-  /**
-   *
-   * Return a mongodb sort pipeline stage using approved `req.query.sort-by|sort` values
-   * @param {object} req - requires req.query.sort-by|sort
-   * @param {object} sortMap - e.g. { name: ['user.firstName', ..], .. }
-   * @param {string} <sortDefault> - e.g. 'createdAt' (default)
-   * @return {object} - e.g. { 'user.firstName': -1 }
-   * @see used in karpark
-   */
-  let sort = req.query.sort == 'asc' ? 1 : -1
-  let sortBy = req.query['sort-by']
-  sortByDefault = sortByDefault || 'createdAt'
-
-  // Convert { name: ['user.firstName'] } to { name: { 'user.firstName': 1 }}
-  for (let key in sortMap) {
-    sortMap[key] = sortMap[key].reduce((o, name) => {
-      o[name] = sort
-      return o
-    }, {})
-  }
-
-  if (sortMap[sortBy]) return sortMap[sortBy]
-  else return { [sortByDefault]: sort }
-}
-
-export function throttle (func, wait, options) {
-  /**
+/**
    * Creates a throttled function that only invokes `func` at most once per every `wait` milliseconds
-   * @param {function} func
-   * @param {number} <wait=0> - the number of milliseconds to throttle invocations to
-   * @param {boolean} <options.leading=true> - invoke on the leading edge of the timeout
-   * @param {boolean} <options.trailing=true> - invoke on the trailing edge of the timeout
-   * @returns {Function}
-   * @example const throttled = util.throttle(updatePosition, 100)
-   * @see lodash
-   */
+ * @param {function} func
+ * @param {number} [wait=0] - the number of milliseconds to throttle invocations to
+ * @param {{
+ *    leading?: boolean, // invoke on the leading edge of the timeout
+ *    trailing?: boolean, // invoke on the trailing edge of the timeout
+ * }} [options] - options object
+ * @returns {function}
+ * @example const throttled = util.throttle(updatePosition, 100)
+ * @see lodash
+ */
+export function throttle (func, wait, options) {
   let leading = true
   let trailing = true
   if (typeof func != 'function') {
     throw new TypeError('Expected a function')
   }
-  if (isObject(options)) {
+  if (options) {
     leading = 'leading' in options ? !!options.leading : leading
     trailing = 'trailing' in options ? !!options.trailing : trailing
   }
@@ -1150,18 +1521,80 @@ export function throttle (func, wait, options) {
   })
 }
 
+/**
+ * Convert a variable to an array, if not already an array.
+ * @template T
+ * @param {T | undefined} variable
+ * @returns {(T extends any[] ? T : T[])}
+ */
 export function toArray (variable) {
-  // converts a variable to an array, if not already so
-  if (typeof variable === 'undefined') return []
-  return Array.isArray(variable) ? variable : [variable]
+  if (variable === undefined) {
+    // TypeScript can’t infer conditional return types from runtime empty array
+    // So we force-cast it to the generic fallback type
+    return /** @type {T extends any[] ? T : T[]} */([])
+  }
+  return /** @type {T extends any[] ? T : T[]} */(Array.isArray(variable) ? variable : [variable])
 }
 
+/**
+ * Trim a string and replace multiple newlines with double newlines
+ * @param {string} string
+ * @returns {string}
+ */
 export function trim (string) {
   if (!string || !isString(string)) return ''
   return string.trim().replace(/\n\s+\n/g, '\n\n')
 }
 
+/**
+ * Capitalize the first letter of a string
+ * @param {string} string
+ * @returns {string}
+ */
 export function ucFirst (string) {
   if (!string) return ''
   return string.charAt(0).toUpperCase() + string.slice(1)
-}
+}
+
+
+
+
+//--------------------------------
+/* eslint-disable @typescript-eslint/no-unused-vars */
+
+// const axios2 = axios()
+// const addressSchema2 = addressSchema()
+// const url = buildUrl('https://example.com', { param1: 'value1', param2: 'value2' })
+// const camelCase2 = camelCase('camelCase')
+// const camelCaseToTitle2 = camelCaseToTitle('camelCase')
+// const camelCaseToHypen2 = camelCaseToHypen('camelCase')
+// const capitalise2 = capitalise()
+// const currency2 = currency(1234)
+// const currencyToCents2 = currencyToCents('$12.34')
+// const date2 = date(1234567890)
+// const debounce2 = debounce(() => {}, 1000)
+// const deepCopy2 = deepCopy([])
+// const deepFind2 = deepFind({})
+// const deepSave2 = deepSave({})
+// const each2 = each({})
+// const fileDownload2 = fileDownload('data', 'filename.txt')
+// const formatName2 = formatName('John Smith')
+// const formatSlug2 = formatSlug('John Smith')
+// const formData2 = formData({})
+// const fullName2 = fullName({ firstName: 'John', lastName: 'Smith' })
+// const [firstName, lastName] = fullNameSplit('name')
+// const countries2 = getCountryOptions({ US: { name: 'United States' }, GB: { name: 'United Kingdom' } })
+// const currencies2 = getCurrencyOptions({ USD: { name: 'United States Dollar' }, GBP: { name: 'British Pound' } })
+// const width = getPrefixWidth('£')
+// const directories2 = getDirectories({ join: (...args) => args.join('/') }, 'pwd')
+// const stripeClient = getStripeClientPromise('pk_test')
+// const getResponseErrors2 = getResponseErrors(new Error('test'))
+// const inArray2 = inArray([1, 2, 3], 's')
+// const isArray2 = isArray([1, 2, 3])
+
+// const isObject2 = isObject({})
+
+// const onChange2 = onChange.call(() => {}, { target: {} })
+
+// const queryObject2 = queryObject('?page=1&perPage=10')
+// const queryString2 = queryString({ page: 1, perPage: 10 })