npm - bajo - Versions diffs - 1.2.9 → 2.0.0 - Mend

bajo 1.2.9 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (166) hide show

package/.jsdoc.conf.json +6 -3
package/README.md +8 -148
package/class/app.js +113 -0
package/{boot/class/bajo-core.js → class/bajo.js} +448 -35
package/{boot/class/error.js → class/base/err.js} +29 -3
package/class/base/log.js +205 -0
package/class/base/plugin.js +177 -0
package/class/base/print.js +272 -0
package/class/helper/bajo.js +344 -0
package/class/helper/plugin.js +169 -0
package/{boot/class/bajo-plugin.js → class/plugin.js} +60 -3
package/docs/App.html +3 -0
package/docs/Bajo.html +15 -0
package/docs/BasePlugin.html +5 -0
package/docs/Err.html +3 -0
package/docs/Log.html +3 -0
package/docs/Plugin.html +3 -0
package/docs/Print.html +3 -0
package/docs/bitcoin.jpeg +0 -0
package/docs/class_app.js.html +116 -0
package/docs/class_bajo.js.html +1100 -0
package/docs/class_base_err.js.html +99 -0
package/docs/class_base_log.js.html +208 -0
package/docs/class_base_plugin.js.html +180 -0
package/docs/class_base_print.js.html +275 -0
package/docs/class_helper_bajo.js.html +347 -0
package/docs/class_helper_plugin.js.html +172 -0
package/docs/class_plugin.js.html +121 -0
package/docs/data/search.json +1 -0
package/docs/fonts/Inconsolata-Regular.ttf +0 -0
package/docs/fonts/OpenSans-Regular.ttf +0 -0
package/docs/fonts/WorkSans-Bold.ttf +0 -0
package/docs/global.html +3 -0
package/docs/index.html +3 -0
package/docs/lib_create-method.js.html +42 -0
package/docs/lib_formats.js.html +68 -0
package/docs/lib_log-levels.js.html +28 -0
package/docs/lib_resolve-path.js.html +30 -0
package/docs/lib_shim.js.html +35 -0
package/docs/module-class_helper_bajo.html +3 -0
package/docs/module-class_helper_plugin.html +3 -0
package/docs/module-lib_create-method.html +3 -0
package/docs/module-lib_formats.html +3 -0
package/docs/module-lib_log-levels.html +3 -0
package/docs/module-lib_resolve-path.html +3 -0
package/docs/module-lib_shim.html +3 -0
package/docs/scripts/core.js +726 -0
package/docs/scripts/core.min.js +23 -0
package/docs/scripts/resize.js +90 -0
package/docs/scripts/search.js +265 -0
package/docs/scripts/search.min.js +6 -0
package/docs/scripts/third-party/Apache-License-2.0.txt +202 -0
package/docs/scripts/third-party/fuse.js +9 -0
package/docs/scripts/third-party/hljs-line-num-original.js +369 -0
package/docs/scripts/third-party/hljs-line-num.js +1 -0
package/docs/scripts/third-party/hljs-original.js +5171 -0
package/docs/scripts/third-party/hljs.js +1 -0
package/docs/scripts/third-party/popper.js +5 -0
package/docs/scripts/third-party/tippy.js +1 -0
package/docs/scripts/third-party/tocbot.js +672 -0
package/docs/scripts/third-party/tocbot.min.js +1 -0
package/docs/styles/clean-jsdoc-theme-base.css +1159 -0
package/docs/styles/clean-jsdoc-theme-dark.css +412 -0
package/docs/styles/clean-jsdoc-theme-light.css +482 -0
package/docs/styles/clean-jsdoc-theme-scrollbar.css +30 -0
package/docs/styles/clean-jsdoc-theme-without-scrollbar.min.css +1 -0
package/docs/styles/clean-jsdoc-theme.min.css +1 -0
package/docs/tutorial-contribution.html +3 -0
package/docs/tutorial-ecosystem.html +3 -0
package/docs/tutorial-getting-started.html +13 -0
package/docs/tutorial-plugin-dev.html +3 -0
package/docs/tutorial-user-guide.html +3 -0
package/lib/create-method.js +39 -0
package/{boot/lib → lib}/formats.js +28 -0
package/{boot/lib → lib}/log-levels.js +16 -0
package/{boot/lib → lib}/parse-args-argv.js +1 -1
package/{boot/lib → lib}/resolve-path.js +12 -0
package/{boot/lib → lib}/shim.js +10 -0
package/misc-docs/bitcoin.jpeg +0 -0
package/misc-docs/contribution.md +20 -0
package/{docs → misc-docs}/ecosystem.md +41 -12
package/misc-docs/getting-started.md +142 -0
package/misc-docs/plugin-dev.md +0 -0
package/misc-docs/toc.json +17 -0
package/misc-docs/user-guide.md +1 -0
package/package.json +14 -13
package/bajoBook/book/doc/.metadata.json +0 -28
package/bajoBook/book/doc/How-to-Make-a-Paper-Boat-564x400@2x.jpg +0 -0
package/bajoBook/book/doc/pages/guides/definition.md +0 -7
package/bajoBook/book/doc/pages/guides/intro.md +0 -3
package/bajoBook/book/doc/pages/guides/setup.md +0 -22
package/bajoBook/book/reference/.metadata.json +0 -152
package/bajoBook/book/reference/concept-leadership-business-with-paper-boats.jpg +0 -0
package/bajoBook/book/reference/pages/configuration/configuration-file.md +0 -52
package/bajoBook/book/reference/pages/helper/break-ns-path.md +0 -24
package/bajoBook/book/reference/pages/helper/build-collections.md +0 -19
package/bajoBook/book/reference/pages/helper/call-helper-or-handler.md +0 -35
package/bajoBook/book/reference/pages/helper/current-loc.md +0 -28
package/bajoBook/book/reference/pages/helper/dayjs.md +0 -13
package/bajoBook/book/reference/pages/helper/defaults-deep.md +0 -29
package/bajoBook/book/reference/pages/helper/dump.md +0 -32
package/bajoBook/book/reference/pages/helper/each-plugins.md +0 -24
package/bajoBook/book/reference/pages/helper/envs.md +0 -11
package/bajoBook/book/reference/pages/helper/error.md +0 -29
package/bajoBook/book/reference/pages/helper/fatal.md +0 -18
package/bajoBook/book/reference/pages/helper/freeze.md +0 -13
package/bajoBook/book/reference/pages/helper/generate-id.md +0 -36
package/bajoBook/book/reference/pages/helper/get-config.md +0 -27
package/bajoBook/book/reference/pages/helper/get-global-module-dir.md +0 -13
package/bajoBook/book/reference/pages/helper/get-helper.md +0 -13
package/bajoBook/book/reference/pages/helper/get-item-by-name.md +0 -13
package/bajoBook/book/reference/pages/helper/get-key-by-value.md +0 -13
package/bajoBook/book/reference/pages/helper/get-module-dir.md +0 -13
package/bajoBook/book/reference/pages/helper/get-plugin-data-dir.md +0 -13
package/bajoBook/book/reference/pages/helper/get-plugin-name.md +0 -13
package/bajoBook/book/reference/pages/helper/get-plugin.md +0 -13
package/bajoBook/book/reference/pages/helper/import-module.md +0 -13
package/bajoBook/book/reference/pages/helper/import-pkg.md +0 -13
package/bajoBook/book/reference/pages/helper/is-empty-dir.md +0 -13
package/bajoBook/book/reference/pages/helper/is-log-in-range.md +0 -13
package/bajoBook/book/reference/pages/helper/is-set.md +0 -13
package/bajoBook/book/reference/pages/helper/is-valid-app.md +0 -13
package/bajoBook/book/reference/pages/helper/is-valid-plugin.md +0 -13
package/bajoBook/book/reference/pages/helper/log-levels.md +0 -13
package/bajoBook/book/reference/pages/helper/log.md +0 -13
package/bajoBook/book/reference/pages/helper/paginate.md +0 -13
package/bajoBook/book/reference/pages/helper/pascal-case.md +0 -13
package/bajoBook/book/reference/pages/helper/print.md +0 -13
package/bajoBook/book/reference/pages/helper/read-config.md +0 -13
package/bajoBook/book/reference/pages/helper/read-json.md +0 -13
package/bajoBook/book/reference/pages/helper/resolve-path.md +0 -13
package/bajoBook/book/reference/pages/helper/resolve-tpl-path.md +0 -13
package/bajoBook/book/reference/pages/helper/run-hook.md +0 -13
package/bajoBook/book/reference/pages/helper/save-as-download.md +0 -13
package/bajoBook/book/reference/pages/helper/titleize.md +0 -13
package/bajoBook/book/reference/pages/helper/white-space.md +0 -13
package/boot/class/app.js +0 -67
package/boot/class/bajo-core/boot-order.js +0 -35
package/boot/class/bajo-core/boot-plugins.js +0 -17
package/boot/class/bajo-core/build-config.js +0 -86
package/boot/class/bajo-core/build-plugins.js +0 -44
package/boot/class/bajo-core/collect-config-handlers.js +0 -20
package/boot/class/bajo-core/exit-handler.js +0 -53
package/boot/class/bajo-core/run-as-applet.js +0 -26
package/boot/class/bajo-plugin/attach-method.js +0 -14
package/boot/class/bajo-plugin/build-config.js +0 -15
package/boot/class/bajo-plugin/check-clash.js +0 -18
package/boot/class/bajo-plugin/check-dependency.js +0 -39
package/boot/class/bajo-plugin/collect-hooks.js +0 -31
package/boot/class/bajo-plugin/run.js +0 -23
package/boot/class/log.js +0 -96
package/boot/class/plugin.js +0 -79
package/boot/class/print.js +0 -153
package/boot/lib/create-method.js +0 -33
package/test/method/isSet.js +0 -43
/package/{bajo → extend/bajo}/intl/en-US.json +0 -0
/package/{bajo → extend/bajo}/intl/id.json +0 -0
/package/{waibuStatic → extend/waibuStatic}/virtual.json +0 -0
/package/{boot/index.js → index.js} +0 -0
/package/{boot/lib → lib}/current-loc.js +0 -0
/package/{boot/lib → lib}/dayjs.js +0 -0
/package/{boot/lib → lib}/import-module.js +0 -0
/package/{boot/lib → lib}/omitted-plugin-keys.js +0 -0
/package/{boot/lib → lib}/parse-env.js +0 -0
/package/{boot/lib → lib}/read-all-configs.js +0 -0
/package/{docs/hook.md → misc-docs/.hook.md} +0 -0

package/docs/class_bajo.js.html ADDED Viewed

@@ -0,0 +1,1100 @@
+<!DOCTYPE html><html lang="en" style="font-size:16px"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Source: class/bajo.js</title><!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]--><script src="scripts/third-party/hljs.js" defer="defer"></script><script src="scripts/third-party/hljs-line-num.js" defer="defer"></script><script src="scripts/third-party/popper.js" defer="defer"></script><script src="scripts/third-party/tippy.js" defer="defer"></script><script src="scripts/third-party/tocbot.min.js"></script><script>var baseURL="/",locationPathname="";baseURL=(locationPathname=document.location.pathname).substr(0,locationPathname.lastIndexOf("/")+1)</script><link rel="stylesheet" href="styles/clean-jsdoc-theme.min.css"><svg aria-hidden="true" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="display:none"><defs><symbol id="copy-icon" viewbox="0 0 488.3 488.3"><g><path d="M314.25,85.4h-227c-21.3,0-38.6,17.3-38.6,38.6v325.7c0,21.3,17.3,38.6,38.6,38.6h227c21.3,0,38.6-17.3,38.6-38.6V124    C352.75,102.7,335.45,85.4,314.25,85.4z M325.75,449.6c0,6.4-5.2,11.6-11.6,11.6h-227c-6.4,0-11.6-5.2-11.6-11.6V124    c0-6.4,5.2-11.6,11.6-11.6h227c6.4,0,11.6,5.2,11.6,11.6V449.6z"/><path d="M401.05,0h-227c-21.3,0-38.6,17.3-38.6,38.6c0,7.5,6,13.5,13.5,13.5s13.5-6,13.5-13.5c0-6.4,5.2-11.6,11.6-11.6h227    c6.4,0,11.6,5.2,11.6,11.6v325.7c0,6.4-5.2,11.6-11.6,11.6c-7.5,0-13.5,6-13.5,13.5s6,13.5,13.5,13.5c21.3,0,38.6-17.3,38.6-38.6    V38.6C439.65,17.3,422.35,0,401.05,0z"/></g></symbol><symbol id="search-icon" viewBox="0 0 512 512"><g><g><path d="M225.474,0C101.151,0,0,101.151,0,225.474c0,124.33,101.151,225.474,225.474,225.474    c124.33,0,225.474-101.144,225.474-225.474C450.948,101.151,349.804,0,225.474,0z M225.474,409.323    c-101.373,0-183.848-82.475-183.848-183.848S124.101,41.626,225.474,41.626s183.848,82.475,183.848,183.848    S326.847,409.323,225.474,409.323z"/></g></g><g><g><path d="M505.902,476.472L386.574,357.144c-8.131-8.131-21.299-8.131-29.43,0c-8.131,8.124-8.131,21.306,0,29.43l119.328,119.328    c4.065,4.065,9.387,6.098,14.715,6.098c5.321,0,10.649-2.033,14.715-6.098C514.033,497.778,514.033,484.596,505.902,476.472z"/></g></g></symbol><symbol id="font-size-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11.246 15H4.754l-2 5H.6L7 4h2l6.4 16h-2.154l-2-5zm-.8-2L8 6.885 5.554 13h4.892zM21 12.535V12h2v8h-2v-.535a4 4 0 1 1 0-6.93zM19 18a2 2 0 1 0 0-4 2 2 0 0 0 0 4z"/></symbol><symbol id="add-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11 11V5h2v6h6v2h-6v6h-2v-6H5v-2z"/></symbol><symbol id="minus-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M5 11h14v2H5z"/></symbol><symbol id="dark-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M10 7a7 7 0 0 0 12 4.9v.1c0 5.523-4.477 10-10 10S2 17.523 2 12 6.477 2 12 2h.1A6.979 6.979 0 0 0 10 7zm-6 5a8 8 0 0 0 15.062 3.762A9 9 0 0 1 8.238 4.938 7.999 7.999 0 0 0 4 12z"/></symbol><symbol id="light-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 18a6 6 0 1 1 0-12 6 6 0 0 1 0 12zm0-2a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM11 1h2v3h-2V1zm0 19h2v3h-2v-3zM3.515 4.929l1.414-1.414L7.05 5.636 5.636 7.05 3.515 4.93zM16.95 18.364l1.414-1.414 2.121 2.121-1.414 1.414-2.121-2.121zm2.121-14.85l1.414 1.415-2.121 2.121-1.414-1.414 2.121-2.121zM5.636 16.95l1.414 1.414-2.121 2.121-1.414-1.414 2.121-2.121zM23 11v2h-3v-2h3zM4 11v2H1v-2h3z"/></symbol><symbol id="reset-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M18.537 19.567A9.961 9.961 0 0 1 12 22C6.477 22 2 17.523 2 12S6.477 2 12 2s10 4.477 10 10c0 2.136-.67 4.116-1.81 5.74L17 12h3a8 8 0 1 0-2.46 5.772l.997 1.795z"/></symbol><symbol id="down-icon" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M12.7803 6.21967C13.0732 6.51256 13.0732 6.98744 12.7803 7.28033L8.53033 11.5303C8.23744 11.8232 7.76256 11.8232 7.46967 11.5303L3.21967 7.28033C2.92678 6.98744 2.92678 6.51256 3.21967 6.21967C3.51256 5.92678 3.98744 5.92678 4.28033 6.21967L8 9.93934L11.7197 6.21967C12.0126 5.92678 12.4874 5.92678 12.7803 6.21967Z"></path></symbol><symbol id="codepen-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M16.5 13.202L13 15.535v3.596L19.197 15 16.5 13.202zM14.697 12L12 10.202 9.303 12 12 13.798 14.697 12zM20 10.869L18.303 12 20 13.131V10.87zM19.197 9L13 4.869v3.596l3.5 2.333L19.197 9zM7.5 10.798L11 8.465V4.869L4.803 9 7.5 10.798zM4.803 15L11 19.131v-3.596l-3.5-2.333L4.803 15zM4 13.131L5.697 12 4 10.869v2.262zM2 9a1 1 0 0 1 .445-.832l9-6a1 1 0 0 1 1.11 0l9 6A1 1 0 0 1 22 9v6a1 1 0 0 1-.445.832l-9 6a1 1 0 0 1-1.11 0l-9-6A1 1 0 0 1 2 15V9z"/></symbol><symbol id="close-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 10.586l4.95-4.95 1.414 1.414-4.95 4.95 4.95 4.95-1.414 1.414-4.95-4.95-4.95 4.95-1.414-1.414 4.95-4.95-4.95-4.95L7.05 5.636z"/></symbol><symbol id="menu-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M3 4h18v2H3V4zm0 7h18v2H3v-2zm0 7h18v2H3v-2z"/></symbol></defs></svg></head><body data-theme="light"><div class="sidebar-container"><div class="sidebar" id="sidebar"><a href="/" class="sidebar-title sidebar-title-anchor">Bajo Framework</a><div class="sidebar-items-container"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-class_helper_bajo.html">class/helper/bajo</a></div><div class="sidebar-section-children"><a href="module-class_helper_plugin.html">class/helper/plugin</a></div><div class="sidebar-section-children"><a href="module-lib_create-method.html">lib/create-method</a></div><div class="sidebar-section-children"><a href="module-lib_formats.html">lib/formats</a></div><div class="sidebar-section-children"><a href="module-lib_log-levels.html">lib/log-levels</a></div><div class="sidebar-section-children"><a href="module-lib_resolve-path.html">lib/resolve-path</a></div><div class="sidebar-section-children"><a href="module-lib_shim.html">lib/shim</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="App.html">App</a></div><div class="sidebar-section-children"><a href="Bajo.html">Bajo</a></div><div class="sidebar-section-children"><a href="BasePlugin.html">BasePlugin</a></div><div class="sidebar-section-children"><a href="Err.html">Err</a></div><div class="sidebar-section-children"><a href="Log.html">Log</a></div><div class="sidebar-section-children"><a href="Plugin.html">Plugin</a></div><div class="sidebar-section-children"><a href="Print.html">Print</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-tutorials"><div>Tutorials</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="tutorial-contribution.html">Contribution</a></div><div class="sidebar-section-children"><a href="tutorial-ecosystem.html">Ecosystem</a></div><div class="sidebar-section-children"><a href="tutorial-getting-started.html">Getting Started</a></div><div class="sidebar-section-children"><a href="tutorial-plugin-dev.html">Plugin Development</a></div><div class="sidebar-section-children"><a href="tutorial-user-guide.html">User Guide</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#NsPathType">NsPathType</a></div><div class="sidebar-section-children"><a href="global.html#ObjectFormatType">ObjectFormatType</a></div></div></div></div></div><div class="navbar-container" id="VuAckcnZhf"><nav class="navbar"><div class="navbar-left-items"><div class="navbar-item"><a id="" href="https://bajo.app" target="">Bajo.app</a></div><div class="navbar-item"><a id="" href="https://www.npmjs.com/package/bajo" target="">NPM</a></div><div class="navbar-item"><a id="" href="https://github.com/ardhi/bajo" target="">Github</a></div></div><div class="navbar-right-items"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#dark-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div><nav></nav></nav></div><div class="toc-container"><div class="toc-content"><span class="bold">On this page</span><div id="eed4d2a0bfd64539bb9df78095dec881"></div></div></div><div class="body-wrapper"><div class="main-content"><div class="main-wrapper"><section id="source-page" class="source-page"><header><h1 id="title" class="has-anchor">class_bajo.js</h1></header><article><pre class="prettyprint source lang-js"><code>import Plugin from './plugin.js'
+import BasePlugin from './base/plugin.js'
+import increment from 'add-filename-increment'
+import fs from 'fs-extra'
+import path from 'path'
+import os from 'os'
+import ms from 'ms'
+import dotenvParseVariables from 'dotenv-parse-variables'
+import emptyDir from 'empty-dir'
+import lodash from 'lodash'
+import currentLoc from '../lib/current-loc.js'
+import { createRequire } from 'module'
+import getGlobalPath from 'get-global-path'
+import { customAlphabet } from 'nanoid'
+import fastGlob from 'fast-glob'
+import querystring from 'querystring'
+import deepFreeze from 'deep-freeze-strict'
+import resolvePath from '../lib/resolve-path.js'
+import importModule from '../lib/import-module.js'
+import logLevels from '../lib/log-levels.js'
+import { types as formatTypes, formats } from '../lib/formats.js'
+const require = createRequire(import.meta.url)
+const {
+  isFunction, map, isObject,
+  trim, filter, isEmpty, orderBy, pullAt, find, camelCase, isNumber,
+  cloneDeep, isPlainObject, isArray, isString, set, omit, keys, indexOf,
+  last, get, has, values, dropRight, pick
+} = lodash
+/**
+ * The Core. The main engine. The one and only plugin that control app's boot process and
+ * making sure all other plugins working smoothly.
+ *
+ * @class
+ */
+class Bajo extends BasePlugin {
+  /**
+   * @param {Object} app
+   * @param {Object} app - App instance reference. Usefull to call app method inside a plugin
+   */
+  constructor (app) {
+    super('bajo', app)
+    /**
+     * Date/time when your app start
+     * @type {Date}
+     */
+    this.runAt = new Date()
+    /**
+     * Your main namespace. And yes, you suppose NOT to change this
+     *
+     * @type {string}
+     */
+    this.mainNs = 'main'
+    /**
+     * Storage for applets
+     *
+     * @type {Array}
+     */
+    this.applets = []
+    /**
+     * List of all loaded plugin's package names
+     *
+     * @type {Array}
+     */
+    this.pluginPkgs = []
+    /**
+     * List of all loaded plugin's names
+     *
+     * @type {Array}
+     */
+    this.pluginNames = []
+    /**
+     * Storage for config handlers. By default there are only two handlers available: ```.js```
+     * and ```.json```.
+     *
+     * Use plugin to add more type - e.g: {@link https://github.com/ardhi/bajo-config|bajo-config}
+     * lets you to use ```.yaml``` and ```.toml```
+     *
+     * @type {Array}
+     */
+    this.configHandlers = [
+      { ext: '.js', readHandler: this._defConfigHandler },
+      { ext: '.json', readHandler: this.readJson }
+    ]
+    this.whiteSpace = [' ', '\t', '\n', '\r']
+    this.envs = { dev: 'development', staging: 'staging', prod: 'production' }
+    this.lib.Plugin = Plugin
+  }
+  async _defConfigHandler (file, opts = {}) {
+    let mod = await importModule(file)
+    if (isFunction(mod)) mod = await mod.call(this, opts)
+    return mod
+  }
+  /**
+   * Resolve file name to filesystem's path. Windows path separator ```\```
+   * is normalized to Unix's ```/```
+   *
+   * @method
+   * @param {string} file - File to resolve
+   * @param {boolean} [asFileUrl=false] - Return as file URL format ```file:///&lt;name>```
+   * @returns {string}
+   */
+  resolvePath = (file, asFileUrl) => {
+    return resolvePath(file, asFileUrl)
+  }
+  /**
+   * Freeze object
+   *
+   * @method
+   * @param {Object} obj - Object
+   * @param {boolean} [shallow=false] - If true (default), deep freeze object
+   */
+  freeze = (obj, shallow) => {
+    if (shallow) Object.freeze(obj)
+    else deepFreeze(obj)
+  }
+  setImmediate = async () => {
+    return new Promise((resolve) => {
+      setImmediate(() => resolve())
+    })
+  }
+  breakNsPathFromFile = ({ file, dir, baseNs, suffix = '', getType } = {}) => {
+    let item = file.replace(dir + suffix, '')
+    let type
+    if (getType) {
+      const items = item.split('/')
+      type = items.shift()
+      item = items.join('/')
+    }
+    item = item.slice(0, item.length - path.extname(item).length)
+    let [name, _path] = item.split('@')
+    if (!_path) {
+      _path = name
+      name = baseNs
+    }
+    _path = camelCase(_path)
+    const names = map(name.split('.'), n => camelCase(n))
+    const [ns, subNs] = names
+    return { ns, subNs, path: _path, fullNs: names.join('.'), type }
+  }
+  buildNsPath = ({ ns = '', subNs, subSubNs, path } = {}) => {
+    if (subNs) ns += '.' + subNs
+    if (subSubNs) ns += '.' + subSubNs
+    return `${ns}:${path}`
+  }
+  /**
+   * Object returned by {@link BajoCore#breakNsPath|breakNsPath}
+   *
+   * @typedef {Object} NsPathType
+   * @property {string} ns - Namespace
+   * @property {string} [subNs] - Sub namespace
+   * @property {string} [subSubNs] - Sub of sub namespace
+   * @property {string} path - Path without query string or hash
+   * @property {string} fullPath - Full path, including query string and hash
+   */
+  /**
+   * Break name to its namespace &amp; path infos
+   *
+   * @method
+   * @param {string} name - Name to break
+   * @param {boolean} [checkNs=true] - If true (default), namespace will be checked for its validity
+   * @returns {NsPathType}
+   */
+  breakNsPath = (name = '', checkNs = true) => {
+    let [ns, ...path] = name.split(':')
+    const fullNs = ns
+    let subNs
+    let subSubNs
+    path = path.join(':')
+    if (path.startsWith('//')) {
+      return { path: name } // for: http:// etc
+    }
+    [ns, subNs, subSubNs] = ns.split('.')
+    if (checkNs) {
+      if (!this.app[ns]) {
+        const plugin = this.getPlugin(ns)
+        if (plugin) ns = plugin.name
+      }
+      if (!this.app[ns]) throw this.error('unknownPluginOrNotLoaded%s')
+    }
+    let qs
+    [path, qs] = path.split('?')
+    qs = querystring.parse(qs) ?? {}
+    // normalize path
+    const parts = path.split('/')
+    const realParts = []
+    const params = {}
+    for (const idx in parts) {
+      const part = parts[idx]
+      if (part[0] !== ':' || part.indexOf('|') === -1) {
+        realParts.push(part)
+        continue
+      }
+      const [key, val] = part.split('|')
+      parts[idx] = key
+      params[key.slice(1)] = val
+      realParts.push(val)
+    }
+    path = parts.join('/')
+    const realPath = realParts.join('/')
+    let fullPath = path
+    if (!isEmpty(qs)) fullPath += ('?' + querystring.stringify(qs, null, null, { encodeURIComponent: (text) => (text) }))
+    let realFullPath = realPath
+    if (!isEmpty(qs)) realFullPath += ('?' + querystring.stringify(qs, null, null, { encodeURIComponent: (text) => (text) }))
+    return { ns, path, subNs, subSubNs, qs, fullPath, fullNs, realPath, realFullPath }
+  }
+  /**
+   * Method to transform an array or object from config into an array of collection safely.
+   *
+   * Emitted hooks:
+   * 1. ```{ns}:beforeBuildCollection (container)``` - called before collection is built
+   * 2. ```{ns}:afterBuildCollection (container, items)``` - called after collection is built
+   *
+   * @method
+   * @async
+   * @param {Object} options - Options
+   * @param {string} [options.ns] - Namespace. If not provided, defaults to ```bajo```
+   * @param {function} [options.handler] - Handler to call while building the collection item
+   * @param {Array} [options.dupChecks=[]] - Array of keys to check for duplicates
+   * @param {string} options.container - Key used as container name
+   * @param {boolean} [options.useDefaultName=true] - If true (default) and ```name``` key is not provided, returned collection will be named ```default```
+   * @returns {Array} The collection
+   */
+  buildCollections = async (options = {}) => {
+    let { ns, handler, dupChecks = [], container, useDefaultName } = options
+    useDefaultName = useDefaultName ?? true
+    if (!ns) ns = this.name
+    const cfg = this.app[ns].getConfig()
+    let items = get(cfg, container, [])
+    if (!isArray(items)) items = [items]
+    this.app[ns].log.trace('collecting%s', this.app[ns].print.write(container))
+    await this.runHook(`${ns}:${camelCase('beforeBuildCollection')}`, container)
+    const deleted = []
+    for (const index in items) {
+      const item = items[index]
+      if (useDefaultName) {
+        if (!has(item, 'name')) {
+          if (find(items, { name: 'default' })) throw this.app[ns].error('collExists%s', 'default')
+          else item.name = 'default'
+        }
+      }
+      this.app[ns].log.trace('- %s', item.name)
+      const result = await handler.call(this.app[ns], { item, index, cfg })
+      if (result) items[index] = result
+      else if (result === false) deleted.push(index)
+      if (this.app.bajo.applet &amp;&amp; item.skipOnTool &amp;&amp; !deleted.includes(index)) deleted.push(index)
+    }
+    if (deleted.length > 0) pullAt(items, deleted)
+    // check for duplicity
+    if (dupChecks.length > 0) {
+      const checkers = []
+      for (const c of items) {
+        const checker = JSON.stringify(pick(c, dupChecks))
+        if (checkers.includes(checker)) this.app[ns].fatal('oneOrMoreSharedTheSame%s%s', container, this.join(dupChecks.filter(i => !isFunction(i))))
+      }
+    }
+    await this.runHook(`${ns}:${camelCase('afterBuildCollection')}`, container, items)
+    this.app[ns].log.debug('collected%s%d', this.app[ns].print.write(container), items.length)
+    return items
+  }
+  /**
+   * Calling any plugin's method by its name. Name format: ```ns:methodName```.
+   * - If name is a string, the corresponding plugin's method will be called with passed args as its parameters
+   * - If name is a plugin instance, this will be used as the scope instead. The first args is now the handler name and the rest are its parameters
+   * - If name is a function, this function will be run under scope with the remaining args
+   * - If name is an object and has ```handler``` key in it, this function handler will be instead
+   *
+   * @method
+   * @async
+   * @param {(string|Object|function)} name - Method's name, function handler, plain object or plugin instance
+   * @param  {...any} [args] - One or more arguments passed as parameter to the handler
+   * @returns {any} Returned value
+   */
+  callHandler = async (item, ...args) => {
+    let result
+    let scope = this
+    if (item instanceof Plugin) {
+      scope = item
+      item = args.shift()
+    }
+    const bajo = scope.app.bajo
+    if (isString(item)) {
+      if (item.startsWith('applet:') &amp;&amp; bajo.applets.length > 0) {
+        const [, ns, path] = item.split(':')
+        const applet = find(bajo.applets, a => (a.ns === ns || a.alias === ns))
+        if (applet) result = await bajo.runApplet(applet, path, ...args)
+      } else {
+        const [ns, method, ...params] = item.split(':')
+        const fn = bajo.getMethod(`${ns}:${method}`)
+        if (fn) {
+          if (params.length > 0) args.unshift(...params)
+          result = await fn(...args)
+        }
+      }
+    } else if (isFunction(item)) {
+      result = await item.call(scope, ...args)
+    } else if (isPlainObject(item) &amp;&amp; isFunction(item.handler)) {
+      result = await item.handler.call(scope, ...args)
+    }
+    return result
+  }
+  /**
+   * This function iterates through all loaded plugins and call the provided handler scoped as the running plugin.
+   * And an object with the following key serves as its parameter:
+   *
+   * - ```file```: file matched the glob pattern
+   * - ```dir```: plugin's base directory
+   *
+   * @method
+   * @async
+   * @param {function} handler - Function handler. Can be an async function. Scoped to the running plugin
+   * @param {(string|Object)} [options={}] - Options. If a string is provided, it serves as the glob pattern, otherwise:
+   * @param {(string|Array)} [options.glob] - Glob pattern. If provided,
+   * @param {boolean} [options.useBajo=false] - If true, add ```bajo``` to the running plugins too
+   * @param {string} [options.prefix=''] - Prepend glob pattern with prefix
+   * @param {boolean} [options.noUnderscore=true] - If true (default), matched file with name starts with underscore is ignored
+   * @param {any} [options.returnItems] - If true, each value of returned handler call will be saved as an object with running plugin name as its keys
+   * @returns {any}
+   */
+  eachPlugins = async (handler, options = {}) => {
+    if (typeof options === 'string') options = { glob: options }
+    const result = {}
+    const pluginPkgs = cloneDeep(this.app.bajo.pluginPkgs) ?? []
+    const { glob, useBajo, prefix = '', noUnderscore = true, returnItems } = options
+    if (useBajo) pluginPkgs.unshift('bajo')
+    for (const pkgName of pluginPkgs) {
+      const ns = camelCase(pkgName)
+      let r
+      if (glob) {
+        const base = prefix === '' ? `${this.app[ns].dir.pkg}/extend` : `${this.app[ns].dir.pkg}/extend/${prefix}`
+        let opts = isString(glob) ? { pattern: [glob] } : glob
+        let pattern = opts.pattern ?? []
+        if (isString(pattern)) pattern = [pattern]
+        opts = omit(opts, ['pattern'])
+        for (const i in pattern) {
+          if (!path.isAbsolute(pattern[i])) pattern[i] = `${base}/${pattern[i]}`
+        }
+        const files = await fastGlob(pattern, opts)
+        for (const f of files) {
+          if (path.basename(f)[0] === '_' &amp;&amp; noUnderscore) continue
+          const resp = await handler.call(this.app[ns], { file: f, dir: base })
+          if (resp === false) break
+          else if (resp === undefined) continue
+          else {
+            result[ns] = result[ns] ?? {}
+            result[ns][f] = resp
+          }
+        }
+      } else {
+        r = await handler.call(this.app[ns], { dir: this.app[ns].dir.pkg })
+        if (r === false) break
+        else if (r === undefined) continue
+        else result[ns] = r
+      }
+    }
+    if (returnItems) {
+      const data = []
+      for (const r in result) {
+        for (const f in result[r]) {
+          data.push(result[r][f])
+        }
+      }
+      return data
+    }
+    return result
+  }
+  /**
+   * Object returned by {@link BajoCore#getUnitFormat|getUnitFormat}
+   *
+   * @typedef {Object} ObjectFormatType
+   * @property {string} unitSys - Unit system
+   * @property {Object} format - Format object
+   */
+  /**
+   * Get unit format
+   *
+   * @method
+   * @param {Object} [options={}] - Options
+   * @param {string} [options.lang] - Language to use. Defaults to the one you set in config
+   * @param {string} [options.unitSys] - Unit system to use. Defaults to language's unit system or ```metric``` if unspecified
+   * @returns {ObjectFormatType} - Returned value
+   */
+  getUnitFormat = (options = {}) => {
+    const lang = options.lang ?? this.config.lang
+    let unitSys = options.unitSys ?? this.config.intl.unitSys[lang] ?? 'metric'
+    if (!['imperial', 'nautical', 'metric'].includes(unitSys)) unitSys = 'metric'
+    return { unitSys, format: formats[unitSys] }
+  }
+  /**
+   * Format value by type
+   *
+   * @method
+   * @param {string} type - Format type. See {@link FormatType} for acceptable values
+   * @param {any} value - Value to format
+   * @param {string} [dataType] - Value's data type. See {@link DataType} for acceptable values
+   * @param {Object} [options={}] - Options
+   * @param {boolean} [options.withUnit=true] - Return with its unit appended
+   * @param {string} [options.lang] - Format value according to this language. Defaults to the one you set in config
+   * @returns {(Array|string)} Return string if ```withUnit``` is true. Otherwise is an array of ```[value, unit, separator]```
+   */
+  formatByType = (type, value, dataType, options = {}) => {
+    const { defaultsDeep } = this.lib.aneka
+    const { format } = this.getUnitFormat(options)
+    const { withUnit = true } = options
+    const lang = options.lang ?? this.config.lang
+    value = format[`${type}Fn`](value)
+    const unit = format[`${type}Unit`]
+    const sep = format[`${type}UnitSep`] ?? ' '
+    if (!withUnit) return [value, unit, sep]
+    const setting = defaultsDeep(options[dataType], this.config.intl.format[dataType])
+    value = new Intl.NumberFormat(lang, setting).format(value)
+    return `${value}${sep}${unit}`
+  }
+  /**
+   * Format value
+   *
+   * @method
+   * @param {any} value - Value to format
+   * @param {string} [type] - Data type to use. See {@link DataType} for acceptable values. If not provided, return the untouched value
+   * @param {Object} [options={}] - Options
+   * @param {string} [options.emptyValue=''] - Empty value to use if function resulted empty. Defaults to the one from your config
+   * @param {boolean} [options.withUnit=true] - Return with its unit appended
+   * @param {string} [options.lang] - Format value according to this language. Defaults to the one you set in config
+   * @param {string} [options.latitude] - If Bajo Spatial is loaded and data type is a double or float, then format it as latitude in degree, minute, second
+   * @param {string} [options.longitude] - If Bajo Spatial is loaded and data type is a double or float, then format it as longitude in degree, minute, second
+   * @returns {string} Formatted value
+   */
+  format = (value, type, options = {}) => {
+    const { defaultsDeep } = this.lib.aneka
+    const { format } = this.config.intl
+    const { emptyValue = format.emptyValue } = options
+    const lang = options.lang ?? this.config.lang
+    options.withUnit = options.withUnit ?? true
+    let valueFormatted
+    if ([undefined, null, ''].includes(value)) return emptyValue
+    if (type === 'auto') {
+      if (value instanceof Date) type = 'datetime'
+    }
+    if (['float', 'double'].includes(type) &amp;&amp; this.app.bajoSpatial) {
+      const { latToDms, lngToDms } = this.app.bajoSpatial.lib.anekaSpatial
+      if (options.latitude) return latToDms(value)
+      if (options.longitude) return lngToDms(value)
+    }
+    if (['integer', 'smallint', 'float', 'double'].includes(type)) {
+      value = ['integer', 'smallint'].includes(type) ? parseInt(value) : parseFloat(value)
+      if (isNaN(value)) return emptyValue
+      for (const u of formatTypes) {
+        if (options[u]) valueFormatted = this.formatByType(u, value, type, options)
+      }
+    }
+    if (['integer', 'smallint'].includes(type)) {
+      const setting = defaultsDeep(options.integer, format.integer)
+      value = new Intl.NumberFormat(lang, setting).format(Math.round(value))
+      return valueFormatted &amp;&amp; options.withUnit ? valueFormatted : value
+    }
+    if (['float', 'double'].includes(type)) {
+      const setting = defaultsDeep(options[type], format[type])
+      value = new Intl.NumberFormat(lang, setting).format(value)
+      return valueFormatted &amp;&amp; options.withUnit ? valueFormatted : value
+    }
+    if (['datetime', 'date'].includes(type)) {
+      const setting = defaultsDeep(options[type], format[type])
+      return new Intl.DateTimeFormat(lang, setting).format(new Date(value))
+    }
+    if (['time'].includes(type)) {
+      const setting = defaultsDeep(options.time, format.time)
+      return new Intl.DateTimeFormat(lang, setting).format(new Date(`1970-01-01T${value}Z`))
+    }
+    if (['array'].includes(type)) return value.join(', ')
+    if (['object'].includes(type)) return JSON.stringify(value)
+    return value
+  }
+  /**
+   * Generate unique random characters that can be used as ID. Use {@link https://github.com/ai/nanoid|nanoid} under the hood
+   *
+   * @method
+   * @param {(boolean|string|Object)} [options={}] - Options. If set to ```true``` or ```alpha```, it will generate alphaphet only characters. If set to ```int```, it will generate integer only characters. Otherwise:
+   * @param {string} [options.pattern] - Character pattern to use. Defaults to all available alphanumeric characters
+   * @param {number} [options.length=13] - Length of resulted characters
+   * @param {string} [options.case] - If set to ```lower``` to use lower cased pattern only. For upper cased pattern, set it to ```upper```
+   * @param {boolean} [options.returnInstance] - Set to ```true``` to return {@link https://github.com/ai/nanoid|nanoid} instance instead of string
+   * @returns {(string|Object)} Return string or instance of {@link https://github.com/ai/nanoid|nanoid}
+   */
+  generateId = (options = {}) => {
+    let type
+    if (options === true) options = 'alpha'
+    if (options === 'int') {
+      type = options
+      options = { pattern: '0123456789', length: 15 }
+    } else if (options === 'alpha') {
+      type = options
+      options = { pattern: 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ', length: 15 }
+    }
+    let { pattern, length = 13, returnInstance } = options
+    pattern = pattern ?? 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'
+    if (options.case === 'lower') pattern = pattern.toLowerCase()
+    else if (options.case === 'upper') pattern = pattern.toUpperCase()
+    const nid = customAlphabet(pattern, length)
+    if (returnInstance) return nid
+    const value = nid()
+    return type === 'int' ? parseInt(value) : value
+  }
+  /**
+   * Get NPM global module directory
+   *
+   * @method
+   * @param {string} [pkgName] - If provided, return this package global directory. Otherwise the npm global module directory
+   * @param {boolean} [silent=true] - Set to ```false``` to throw exception in case of error. Otherwise silently returns undefined
+   * @returns {string}
+   */
+  getGlobalModuleDir = (pkgName, silent = true) => {
+    let nodeModulesDir = process.env.BAJO_GLOBAL_MODULE_DIR
+    if (!nodeModulesDir) {
+      const npmPath = getGlobalPath('npm')
+      if (!npmPath) {
+        if (silent) return
+        throw this.error('cantLocateNpmGlobalDir', { code: 'BAJO_CANT_LOCATE_NPM_GLOBAL_DIR' })
+      }
+      nodeModulesDir = dropRight(resolvePath(npmPath).split('/'), 1).join('/')
+      process.env.BAJO_GLOBAL_MODULE_DIR = nodeModulesDir
+    }
+    if (!pkgName) return nodeModulesDir
+    const dir = `${nodeModulesDir}/${pkgName}`
+    if (!fs.existsSync(dir)) {
+      if (silent) return
+      throw this.error('cantLocateGlobalDir%s', pkgName, { code: 'BAJO_CANT_LOCATE_MODULE_GLOBAL_DIR' })
+    }
+    return dir
+  }
+  /**
+   * Get class method by name
+   *
+   * @method
+   * @param {string} name - Name in format ```ns:methodName```
+   * @param {boolean} [thrown=true] - If ```true``` (default), throw exceptiom in case of error
+   * @returns {function} Class method
+   */
+  getMethod = (name = '', thrown = true) => {
+    const { ns, path } = this.breakNsPath(name)
+    const method = get(this.app, `${ns}.${path}`)
+    if (method &amp;&amp; isFunction(method)) return method
+    if (thrown) throw this.error('cantFindMethod%s', name)
+  }
+  /**
+   * Find item deep in paths
+   *
+   * @method
+   * @param {string} item - Item to find
+   * @param {Array} paths - Array of path to look for
+   * @returns {string}
+   */
+  findDeep = (item, paths) => {
+    let dir
+    for (const p of paths) {
+      const d = `${p}/${item}`
+      if (fs.existsSync(d)) {
+        dir = d
+        break
+      }
+    }
+    return dir
+  }
+  /**
+   * Get module directory, locally and globally
+   *
+   * @method
+   * @param {string} pkgName - Package name to find
+   * @param {*} base - Provide base name if ```pkgName``` is a module under ```base```'s package name
+   * @returns {string} Return absolute package directory
+   */
+  getModuleDir = (pkgName, base) => {
+    if (pkgName === 'main') return resolvePath(this.app.dir)
+    if (base === 'main') base = this.app.dir
+    else if (this &amp;&amp; this.app &amp;&amp; this.app[base]) base = this.app[base].pkgName
+    const pkgPath = pkgName + '/package.json'
+    const paths = require.resolve.paths(pkgPath)
+    const gdir = this.getGlobalModuleDir()
+    paths.unshift(gdir)
+    paths.unshift(resolvePath(path.join(this.app.dir, 'node_modules')))
+    let dir = this.findDeep(pkgPath, paths)
+    if (base &amp;&amp; !dir) dir = this.findDeep(`${base}/node_modules/${pkgPath}`, paths)
+    if (!dir) return null
+    return resolvePath(path.dirname(dir))
+  }
+  /**
+   * Get plugin data directory
+   *
+   * @method
+   * @param {string} name - Plugin name (namespace) or alias
+   * @param {boolean} [ensureDir=true] - Set ```true``` (default) to ensure directory is existed
+   * @returns {string}
+   */
+  getPluginDataDir = (name, ensureDir = true) => {
+    const plugin = this.getPlugin(name)
+    const dir = `${this.app.bajo.dir.data}/plugins/${plugin.name}`
+    if (ensureDir) fs.ensureDirSync(dir)
+    return dir
+  }
+  /**
+   * Resolve file path from:
+   *
+   * - local/absolute file
+   * - ns based path (```myPlugin:/path/to/file.txt```)
+   *
+   * @method
+   * @param {string} file - File path, see above for supported types
+   * @returns {string} Resolved file path
+   */
+  getPluginFile = (file) => {
+    if (!this) return file
+    if (file[0] === '.') file = `${currentLoc(import.meta).dir}/${trim(file.slice(1), '/')}`
+    if (file.includes(':')) {
+      if (file.slice(1, 2) === ':') return file // windows fs
+      const { ns, path } = this.breakNsPath(file)
+      if (ns !== 'file' &amp;&amp; this &amp;&amp; this.app &amp;&amp; this.app[ns] &amp;&amp; ns.length > 1) {
+        file = `${this.app[ns].dir.pkg}${path}`
+      }
+    }
+    return file
+  }
+  /**
+   * Get plugin by name
+   *
+   * @method
+   * @param {string} name - Plugin name/namespace or alias
+   * @param {boolean} [silent] - If ```true```, silently return undefined even on error
+   * @returns {Object} Plugin object
+   */
+  getPlugin = (name, silent) => {
+    if (!this.app[name]) {
+      // alias?
+      let plugin
+      for (const key in this.app) {
+        const item = this.app[key]
+        if (item instanceof Plugin &amp;&amp; (item.alias === name || item.pkgName === name)) {
+          plugin = item
+          break
+        }
+      }
+      if (!plugin) {
+        if (silent) return false
+        throw this.error('pluginWithNameAliasNotLoaded%s', name)
+      }
+      name = plugin.name
+    }
+    return this.app[name]
+  }
+  /**
+   * Import file/module from any loaded plugins
+   *
+   * Your plugin structure:
+   * ```
+   * |- src
+   * |  |- lib
+   * |  |  |- my-module.js
+   * |- index.js
+   * |- package.json
+   * ```
+   *
+   * Inside your app/plugin:
+   * ```javascript
+   * const { importModule } = this.app.bajo
+   * const myModule = await importModule('myPlugin:/src/lib/my-module.js')
+   * ```
+   * @method
+   * @async
+   * @param {string} file - File in format ```ns:&lt;ns based file path>```
+   * @param {Object} [options={}] - Options
+   * @param {boolean} [options.asDefaultImport=true] - If ```true``` (default), return default imported module
+   * @param {boolean} [options.asHandler] - If ```true```, return as a {@link HandlerType|handler}
+   * @param {boolean} [options.noCache] - If ```true```, always import as a fresh copy
+   * @returns {(function|Object)}
+   */
+  importModule = async (file, { asDefaultImport, asHandler, noCache } = {}) => {
+    return await importModule.call(this, file, { asDefaultImport, asHandler, noCache })
+  }
+  /**
+   * Import one or more package belongs to a plugin
+   *
+   * Example: you want to import packages ```delay``` and ```chalk``` from ```bajo``` namespace and use it inside your app/plugin
+   *
+   * ```javascript
+   * const { importPkg } from this.app.bajo
+   * const [delay, chalk] = await importPkg('bajo:delay', 'bajo:chalk')
+   *
+   * await delay(1000)
+   * ...
+   * ```
+   *
+   * @method
+   * @async
+   * @param {...any} pkgs - One or more packages in format ```ns:packageName```
+   * @returns {(Object|Array)} Depends on how many parameters are provided, it should return the named package or an array of packages
+   */
+  importPkg = async (...pkgs) => {
+    const { defaultsDeep } = this.lib.aneka
+    const result = {}
+    const notFound = []
+    let opts = { returnDefault: true, thrownNotFound: false }
+    if (isPlainObject(last(pkgs))) {
+      opts = defaultsDeep(pkgs.pop(), opts)
+    }
+    for (let pkg of pkgs) {
+      if (pkg.indexOf(':') === -1) pkg = `bajo:${pkg}`
+      const { ns, path: name } = this.breakNsPath(pkg)
+      const dir = this.getModuleDir(name, ns)
+      if (!dir) {
+        notFound.push(pkg)
+        continue
+      }
+      const p = this.readJson(`${dir}/package.json`, opts.thrownNotFound)
+      const mainFileOrg = dir + '/' + (p.main ?? get(p, 'exports.default', 'index.js'))
+      let mainFile = resolvePath(mainFileOrg, os.platform() === 'win32')
+      if (isEmpty(path.extname(mainFile))) {
+        if (fs.existsSync(`${mainFileOrg}/index.js`)) mainFile += '/index.js'
+        else mainFile += '.js'
+      }
+      if (opts.noCache) mainFile += `?_=${Date.now()}`
+      let mod = await import(mainFile)
+      if (opts.returnDefault &amp;&amp; has(mod, 'default')) {
+        mod = mod.default
+        if (opts.returnDefault &amp;&amp; has(mod, 'default')) mod = mod.default
+      }
+      result[name] = mod
+    }
+    if (notFound.length > 0) throw this.error('cantFind%s', this.join(notFound))
+    if (pkgs.length === 1) return result[keys(result)[0]]
+    if (opts.asObject) return result
+    return values(result)
+  }
+  /**
+   * Check whether directory is empty or not. More info please {@link https://github.com/gulpjs/empty-dir|check here}.
+   *
+   * @method
+   * @async
+   * @param {string} dir - Directory to check. Can be a ns based directory too!
+   * @param {function} filterFn - Filter function to filter out files that cause false positives.
+   * @returns {boolean}
+   */
+  isEmptyDir = async (dir, filterFn) => {
+    dir = resolvePath(this.getPluginFile(dir))
+    await fs.exists(dir)
+    return await emptyDir(dir, filterFn)
+  }
+  /**
+   * Check whether log level is within log's app current level
+   *
+   * @method
+   * @param {string} level - Level to check. See {@link LogLevelsType} for more
+   * @returns {boolean}
+   */
+  isLogInRange = (level) => {
+    const levels = keys(logLevels)
+    const logLevel = indexOf(levels, this.app.bajo.config.log.level)
+    return indexOf(levels, level) >= logLevel
+  }
+  isValidAppPlugin = (file, type, returnPkg) => {
+    if (isObject(file)) return get(file, 'bajo.type') === type
+    file = resolvePath(file)
+    if (path.basename(file) !== 'package.json') file += '/package.json'
+    try {
+      const pkg = fs.readJsonSync(file)
+      const valid = get(pkg, 'bajo.type') === type
+      if (valid) return returnPkg ? pkg : valid
+      return false
+    } catch (err) {
+      return false
+    }
+  }
+  /**
+   * Check whether directory is a valid Bajo app
+   *
+   * @method
+   * @param {string} dir - Directory to check
+   * @param {boolean} [returnPkg] - Set ```true``` to return its package.json content
+   * @returns {(boolean|Object)}
+   */
+  isValidApp = (dir, returnPkg) => {
+    if (!dir) dir = this.app.dir
+    return this.isValidAppPlugin(dir, 'app', returnPkg)
+  }
+  /**
+   * Check whether directory is a valid Bajo plugin
+   *
+   * @method
+   * @param {string} dir - Directory to check
+   * @param {boolean} [returnPkg] - Set ```true``` to return its package.json content
+   * @returns {(boolean|Object)}
+   */
+  isValidPlugin = (dir, returnPkg) => {
+    if (!dir) dir = this.app.dir
+    return this.isValidAppPlugin(dir, 'plugin', returnPkg)
+  }
+  join = (array, sep) => {
+    const { isSet } = this.lib.aneka
+    const translate = val => {
+      if (this &amp;&amp; this.print) return this.print.write(val).toLowerCase()
+      return val
+    }
+    if (array.length === 0) return translate('none')
+    if (array.length === 1) return array[0]
+    if (isSet(sep) &amp;&amp; !isPlainObject(sep)) return array.join(sep)
+    let { separator = ', ', joiner = 'and' } = sep ?? {}
+    joiner = translate(joiner)
+    const last = (array.pop() ?? '').trim()
+    return array.map(a => (a + '').trim()).join(separator) + ` ${joiner} ${last}`
+  }
+  /**
+   * Return its numeric portion of a value
+   *
+   * @method
+   * @param {string} [value=''] - Value to get its numeric portion
+   * @param {string} [defUnit=''] - Default unit if value doesn't have one
+   * @returns {string}
+   */
+  numUnit = (value = '', defUnit = '') => {
+    const num = value.match(/\d+/g)
+    const unit = value.match(/[a-zA-Z]+/g)
+    return `${num[0]}${isEmpty(unit) ? defUnit : unit[0]}`
+  }
+  /**
+   * Parse duration to its millisecond value. Use {@link https://github.com/vercel/ms|ms} under the hood
+   *
+   * @method
+   * @param {(number|string)} dur - If string is given, parse this to its millisecond value. Otherwise return as is
+   * @returns {number}
+   */
+  parseDur = (dur) => {
+    return isNumber(dur) ? dur : ms(dur)
+  }
+  /**
+   * Parse datetime string as Javascript object. Please visit {@link https://day.js.org|dayjs} for valid formats and more infos
+   *
+   * @method
+   * @param {string} dt - Datetime string
+   * @returns {Object} Javascript object
+   */
+  parseDt = (dt) => {
+    const value = this.lib.dayjs(dt)
+    if (!value.isValid()) throw this.error('dtUnparsable%s', dt)
+    return value.toDate()
+  }
+  /**
+   * Parse an object and optionally normalize its values recursively. Use {@link https://github.com/ladjs/dotenv-parse-variables}
+   * to parse values, so please have a visit to know how it works
+   *
+   * If ```options.parseValue``` is ```true```, any key ends with ```Dur``` and ```Dt``` will
+   * also be parsed as millisecond and Javascript datetime accordingly
+   *
+   * @method
+   * @param {(Object|string)} input - If string is given, parse it first using JSON.parse
+   * @param {Object} [options={}] - Options
+   * @param {boolean} [options.silent=true] - If ```true``` (default), exception are not thrown and silently ignored
+   * @param {boolean} [options.parseValue=false] - If ```true```, values will be parsed &amp; normalized
+   * @param {string} [options.lang] - If provided, use this language instead of the one in config
+   * @returns {Object}
+   */
+  parseObject = (input, options = {}) => {
+    const { silent = true, parseValue = false, lang, ns } = options
+    const { isSet } = this.lib.aneka
+    const translate = (item) => {
+      const scope = ns ? this.app[ns] : this
+      const [text, ...args] = item.split('|')
+      return scope.print.write(text, ...args, { lang })
+    }
+    const statics = ['*']
+    if (isString(input)) {
+      try {
+        input = JSON.parse(input)
+      } catch (err) {
+        if (silent) input = {}
+        else throw err
+      }
+    }
+    let obj = cloneDeep(input)
+    const keys = Object.keys(obj)
+    const mutated = []
+    keys.forEach(k => {
+      let v = obj[k]
+      if (isPlainObject(v)) obj[k] = this.parseObject(v, options)
+      else if (isArray(v)) {
+        v.forEach((i, idx) => {
+          if (isPlainObject(i)) obj[k][idx] = this.parseObject(i, options)
+          else if (statics.includes(i)) obj[k][idx] = i
+          else if (parseValue) obj[k][idx] = dotenvParseVariables(set({}, 'item', obj[k][idx]), { assignToProcessEnv: false }).item
+          if (isArray(obj[k][idx])) obj[k][idx] = obj[k][idx].map(item => typeof item === 'string' ? item.trim() : item)
+        })
+      } else if (isSet(v)) {
+        if (isString(v) &amp;&amp; v.startsWith('t:') &amp;&amp; lang) v = translate(v.slice(2))
+        try {
+          if (statics.includes(v)) obj[k] = v
+          else if (k.startsWith('t:') &amp;&amp; isString(v)) {
+            const newK = k.slice(2)
+            if (lang) obj[newK] = translate(v)
+            else obj[newK] = v
+            mutated.push(k)
+          } else if (parseValue) {
+            obj[k] = dotenvParseVariables(set({}, 'item', v), { assignToProcessEnv: false }).item
+            if (isArray(obj[k])) obj[k] = obj[k].map(item => typeof item === 'string' ? item.trim() : item)
+          }
+          if (k.slice(-3) === 'Dur') obj[k] = this.parseDur(v)
+          if (k.slice(-2) === 'Dt') obj[k] = this.parseDt(v)
+        } catch (err) {
+          obj[k] = undefined
+          if (!silent) throw err
+        }
+      }
+    })
+    if (mutated.length > 0) obj = omit(obj, mutated)
+    return obj
+  }
+  pick = (obj, items, excludeUnset) => {
+    const { isSet } = this.lib.aneka
+    const result = {}
+    for (const item of items) {
+      const [k, nk] = item.split(':')
+      if (excludeUnset &amp;&amp; !isSet(obj[k])) continue
+      result[nk ?? k] = obj[k]
+    }
+    return result
+  }
+  /**
+   * Read and parse file as config object. Supported types: ```.js``` and ```.json```.
+   * More supports can be added using plugin. {@link https://github.com/ardhi/bajo-config|bajo-config} gives you additional supports for ```.yml```, ```.yaml``` and ```.toml``` file
+   *
+   * If file extension is ```.*```, it will be auto detected and parsed accordingly
+   *
+   * @method
+   * @async
+   * @param {string} file - File to read and parse
+   * @param {Object} [options={}] - Options
+   * @param {boolean} [options.ignoreError] - Any exception will be silently discarded
+   * @param {string} [options.ns] - If given, use this as the scope
+   * @param {string} [options.pattern] - If given and auto detection is on (extension is ```.*```), it will be used for instead the default one
+   * @param {Object} [options.globOptions={}] - {@link https://github.com/mrmlnc/fast-glob|fast-glob} options
+   * @param {Object} [options.defValue={}] - Default value to use if value returned empty
+   * @param {Object} [options.opts={}] - Parser setting
+   * @returns {Object}
+   */
+  readConfig = async (file, { ns, pattern, globOptions = {}, ignoreError, defValue = {}, opts = {} } = {}) => {
+    if (!ns) ns = this.name
+    file = resolvePath(this.getPluginFile(file))
+    let ext = path.extname(file)
+    const fname = path.dirname(file) + '/' + path.basename(file, ext)
+    ext = ext.toLowerCase()
+    if (ext === '.js') {
+      const { readHandler } = find(this.app.bajo.configHandlers, { ext })
+      return this.parseObject(await readHandler.call(this.app[ns], file, opts))
+    }
+    if (ext === '.json') return await this.readJson(file)
+    if (!['', '.*'].includes(ext)) {
+      const item = find(this.app.bajo.configHandlers, { ext })
+      if (!item) {
+        if (!ignoreError) throw this.error('cantParse%s', file, { code: 'BAJO_CONFIG_NO_PARSER' })
+        return this.parseObject(defValue)
+      }
+      return this.parseObject(await item.readHandler.call(this.app[ns], file, opts))
+    }
+    const item = pattern ?? `${fname}.{${map(map(this.app.bajo.configHandlers, 'ext'), k => k.slice(1)).join(',')}}`
+    const files = await fastGlob(item, globOptions)
+    if (files.length === 0) {
+      if (!ignoreError) throw this.error('noConfigFileFound', { code: 'BAJO_CONFIG_FILE_NOT_FOUND' })
+      return this.parseObject(defValue)
+    }
+    let config = defValue
+    for (const f of files) {
+      const ext = path.extname(f).toLowerCase()
+      const item = find(this.app.bajo.configHandlers, { ext })
+      if (!item) {
+        if (!ignoreError) throw this.error('cantParse%s', f, { code: 'BAJO_CONFIG_NO_PARSER' })
+        continue
+      }
+      config = await item.readHandler.call(this.app[ns], f, opts)
+      if (!isEmpty(config)) break
+    }
+    return this.parseObject(config)
+  }
+  /**
+   * Read and parse json file
+   *
+   * @method
+   * @param {string} file - File to read
+   * @param {boolean} [thrownNotFound=false] - If ```true```, silently ignore if file is not found
+   * @returns {Object}
+   */
+  readJson = (file, thrownNotFound = false) => {
+    if (isPlainObject(thrownNotFound)) thrownNotFound = false
+    if (!fs.existsSync(file) &amp;&amp; thrownNotFound) throw this.error('notFound%s%s', this.print.write('file'), file)
+    let resp
+    try {
+      resp = fs.readFileSync(file, 'utf8')
+    } catch (err) {}
+    if (isEmpty(resp)) return resp
+    return this.parseObject(JSON.parse(resp))
+  }
+  /**
+   * Run named hook
+   *
+   * @method
+   * @async
+   * @param {string} hookName - ns based hook name
+   * @param  {...any} [args] - Argument passed to the hook function
+   * @returns {Array} Array of hook execution results
+   */
+  runHook = async (hookName, ...args) => {
+    const [ns, path] = (hookName ?? '').split(':')
+    let fns = filter(this.app.bajo.hooks, { ns, path })
+    if (isEmpty(fns)) return []
+    fns = orderBy(fns, ['level'])
+    const results = []
+    for (const i in fns) {
+      const fn = fns[i]
+      const scope = this.app[fn.src]
+      const res = await fn.handler.call(scope, ...args)
+      results.push({
+        hook: hookName,
+        resp: res
+      })
+      if (this.config.log.traceHook) scope.log.trace('hookExecuted%s', hookName)
+    }
+    return results
+  }
+  /**
+   * Save item as file in Bajo's download directory. That is a directory inside your
+   * Bajo plugin's data directory.
+   *
+   * If file exists already, file will automatically be
+   * renamed incrementally.
+   *
+   * @method
+   * @async
+   * @param {string} file - File name
+   * @param {Object} item - Item to save
+   * @param {boolean} [printSaved=true] - Print info on screen
+   * @returns {string} Full file path
+   */
+  saveAsDownload = async (file, item, printSaved = true) => {
+    const { print, getPluginDataDir } = this.app.bajo
+    const fname = increment(`${getPluginDataDir(this.name)}/download/${trim(file, '/')}`, { fs: true })
+    const dir = path.dirname(fname)
+    if (!fs.existsSync(dir)) fs.ensureDirSync(dir)
+    await fs.writeFile(fname, item, 'utf8')
+    if (printSaved) print.succeed('savedAs%s', path.resolve(fname), { skipSilence: true })
+    return fname
+  }
+}
+export default Bajo
+</code></pre></article></section></div></div></div><div class="search-container" id="PkfLWpAbet" style="display:none"><div class="wrapper" id="iCxFxjkHbP"><button class="icon-button search-close-button" id="VjLlGakifb" aria-label="close search"><svg><use xlink:href="#close-icon"></use></svg></button><div class="search-box-c"><svg><use xlink:href="#search-icon"></use></svg> <input type="text" id="vpcKVYIppa" class="search-input" placeholder="Search..." autofocus></div><div class="search-result-c" id="fWwVHRuDuN"><span class="search-result-c-text">Type anything to view search result</span></div></div></div><div class="mobile-menu-icon-container"><button class="icon-button" id="mobile-menu" data-isopen="false" aria-label="menu"><svg><use xlink:href="#menu-icon"></use></svg></button></div><div id="mobile-sidebar" class="mobile-sidebar-container"><div class="mobile-sidebar-wrapper"><a href="/" class="sidebar-title sidebar-title-anchor">Bajo Framework</a><div class="mobile-nav-links"><div class="navbar-item"><a id="" href="https://bajo.app" target="">Bajo.app</a></div><div class="navbar-item"><a id="" href="https://www.npmjs.com/package/bajo" target="">NPM</a></div><div class="navbar-item"><a id="" href="https://github.com/ardhi/bajo" target="">Github</a></div></div><div class="mobile-sidebar-items-c"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-class_helper_bajo.html">class/helper/bajo</a></div><div class="sidebar-section-children"><a href="module-class_helper_plugin.html">class/helper/plugin</a></div><div class="sidebar-section-children"><a href="module-lib_create-method.html">lib/create-method</a></div><div class="sidebar-section-children"><a href="module-lib_formats.html">lib/formats</a></div><div class="sidebar-section-children"><a href="module-lib_log-levels.html">lib/log-levels</a></div><div class="sidebar-section-children"><a href="module-lib_resolve-path.html">lib/resolve-path</a></div><div class="sidebar-section-children"><a href="module-lib_shim.html">lib/shim</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="App.html">App</a></div><div class="sidebar-section-children"><a href="Bajo.html">Bajo</a></div><div class="sidebar-section-children"><a href="BasePlugin.html">BasePlugin</a></div><div class="sidebar-section-children"><a href="Err.html">Err</a></div><div class="sidebar-section-children"><a href="Log.html">Log</a></div><div class="sidebar-section-children"><a href="Plugin.html">Plugin</a></div><div class="sidebar-section-children"><a href="Print.html">Print</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-tutorials"><div>Tutorials</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="tutorial-contribution.html">Contribution</a></div><div class="sidebar-section-children"><a href="tutorial-ecosystem.html">Ecosystem</a></div><div class="sidebar-section-children"><a href="tutorial-getting-started.html">Getting Started</a></div><div class="sidebar-section-children"><a href="tutorial-plugin-dev.html">Plugin Development</a></div><div class="sidebar-section-children"><a href="tutorial-user-guide.html">User Guide</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#NsPathType">NsPathType</a></div><div class="sidebar-section-children"><a href="global.html#ObjectFormatType">ObjectFormatType</a></div></div></div><div class="mobile-navbar-actions"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#dark-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div></div></div><script type="text/javascript" src="scripts/core.min.js"></script><script src="scripts/search.min.js" defer="defer"></script><script src="scripts/third-party/fuse.js" defer="defer"></script><script type="text/javascript">var tocbotInstance=tocbot.init({tocSelector:"#eed4d2a0bfd64539bb9df78095dec881",contentSelector:".main-content",headingSelector:"h1, h2, h3",hasInnerContainers:!0,scrollContainer:".main-content",headingsOffset:130,onClick:bringLinkToView})</script></body></html>