App

If app runs in applet mode, this will be the applet's name

Applets

Program arguments

$ node index.js arg1 arg2
...
console.log(this.args) // it should print: ['arg1', 'arg2']

Program options.

• Dash (-) breaks the string into object keys
• While colon (:) is used as namespace separator. If no namespace found, it is saved under _ key.

Values are parsed automatically. See dotenv-parse-variables for details.

$ node index.js --my-name-first=John --my-name-last=Doe --my-birthDay=secret --nameSpace:path-subPath=true
...
// {
//   _: {
//    my: {
//       name: { first: 'John', last: 'Doe' },
//       birthDay: 'secret'
//     }
//   },
//   nameSpace: { path: { subPath: true } }
// }

Config handlers.

By default, there are two built-in handlers available: .js and .json. Use plugins to add more, e.g bajo-config lets you to use .yaml/.yml and .toml

Environment variables. Support dotenv (.env) file too!

• Underscore (_) translates key to camel-cased one
• Double underscores (__) breaks the key into object keys
• While dot (.) is used as namespace separator. If no namespace found, it is saved under _ key.

Values are also parsed automatically using dotenv-parse-variables.

Example:

• MY_KEY=secret → { _: { myKey: 'secret' } }
• MY_KEY__SUB_KEY=supersecret → { _: { myKey: { subKey: 'supersecret' } } }
• MY_NS.MY_NAME=John → { myNs: { myName: 'John' } }

Helper method to list all supported config formats

Gives you direct access to the most commonly used 3rd party library in a Bajo based app. No manual import necessary, always available, anywhere, anytime!

Example:

const { camelCase, kebabCase } = this.app.lib._
console.log(camelCase('Elit commodo sit et aliqua'))

Instance of system log

All plugin's class definitions are saved here as key-value pairs with plugin name as its key. The special key base is for Base's class so anytime you want to create your own plugin, just use something like this:

class MyPlugin extends this.app.pluginClass.base {
  ... your class
}

List of all loaded plugin's package names

Date/time when your app start

App environments

Your main namespace. And yes, you suppose to NOT CHANGE this

Add and save plugin and it's class definition (if provided)

Booting the app.

Dumping variable on screen. Like console.log but with max 10 depth.

Terminate the app and back to console

Get all loaded plugin namesspaces

Load internationalization & languages files for particular plugin

Translate text and interpolate with given args.

There is a shortcut to this method attached on all plugins. You'll normally call that shorcut instead of this method, because it is bound to plugin's name already

... within your main plugin
const translated = this.app.t('main', 'My cute cat is %s', 'purring')
// or
const translated = this.t('My cute cat is %s', 'purring')