bajo 2.19.0 → 2.20.1

package/.github/workflows/test.yml

@@ -0,0 +1,37 @@
+name: Bajo Tests
+
+# Trigger the workflow on pushes or pull requests to the main branch
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test-package:
+    runs-on: ubuntu-latest
+
+    strategy:
+      # Test your package across multiple Node.js versions
+      matrix:
+        node-version: [22.x, 24.x]
+
+    steps:
+      # Step 1: Download the repository code onto the runner machine
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      # Step 2: Set up the specific Node.js version from the matrix
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm' # Speeds up subsequent runs by caching node_modules
+
+      # Step 3: Perform a clean install of your exact dependencies
+      - name: Install dependencies
+        run: npm ci
+
+      # Step 4: Execute the test command defined in package.json
+      - name: Run package tests
+        run: npm test

package/class/_helper.js

@@ -264,6 +264,7 @@ export async function collectConfigHandlers () {
     if (!mod) continue
     if (isFunction(mod)) mod = await mod.call(this.app[camelCase(pkg)])
     if (isPlainObject(mod)) mod = [mod]
+    mod.forEach(m => set(m, 'ns', camelCase(pkg)))
     this.app.configHandlers = this.app.configHandlers.concat(mod)
   }
 }

package/class/app.js

@@ -562,10 +562,13 @@ class App {
   /**
    * Helper method to list all supported config formats.
    *
+   * @method
+   * @param {boolean} [noDot] - If ```true```, it will return the list without dot prefix.
    * @returns {string[]}
    */
-  getConfigFormats = () => {
-    return map(this.configHandlers, 'ext')
+  getConfigFormats = (noDot) => {
+    const formats = map(this.configHandlers, 'ext')
+    return noDot ? formats.map(f => f.slice(1)) : formats
   }
 
   /**

package/class/bajo.js

@@ -77,8 +77,8 @@ class Bajo extends Plugin {
 
     // by defaualt, only these config formats below are supported.
     app.configHandlers = [
-      { ext: '.js', readHandler: this.fromJs },
-      { ext: '.json', readHandler: this.fromJson, writeHandler: this.toJson }
+      { ns: 'bajo', ext: '.js', readHandler: this.fromJs },
+      { ns: 'bajo', ext: '.json', readHandler: this.fromJson, writeHandler: this.toJson }
     ]
 
     this.hooks = []
@@ -843,20 +843,20 @@ class Bajo extends Plugin {
     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.configHandlers, { ext })
-      return await output(await readHandler.call(this.app[ns], file, parserOpts))
+    if (['.js', '.json'].includes(ext)) {
+      const item = find(this.app.configHandlers, { ext })
+      return await output(await item.readHandler.call(this.app[ns], file, parserOpts))
     }
-    if (ext === '.json') return await output(await this.fromJson(file, parserOpts))
     if (!['', '.*'].includes(ext)) {
       const item = find(this.app.configHandlers, { ext })
       if (!item) {
         if (!ignoreError) throw this.error('cantParse%s', file, { code: 'BAJO_CONFIG_NO_PARSER' })
         return await output(defValue)
       }
-      return await output(await item.readHandler.call(this.app[ns], file, parserOpts))
+      return await output(await item.readHandler.call(this.app[item.ns], file, parserOpts))
     }
-    const item = pattern ?? `${fname}.{${map(map(this.app.configHandlers, 'ext'), k => k.slice(1)).join(',')}}`
+    const formats = this.app.getConfigFormats(true)
+    const item = pattern ?? `${fname}.{${formats.join(',')}}`
     const files = await fastGlob(item, globOpts ?? {})
     if (files.length === 0) {
       if (!ignoreError) throw this.error('noConfigFileFound', { code: 'BAJO_CONFIG_FILE_NOT_FOUND' })
@@ -870,7 +870,8 @@ class Bajo extends Plugin {
         if (!ignoreError) throw this.error('cantParse%s', f, { code: 'BAJO_CONFIG_NO_PARSER' })
         continue
       }
-      config = await item.readHandler.call(this.app[ns], f, parserOpts)
+      const _ns = ['.js', '.json'].includes(ext) ? ns : item.ns
+      config = await item.readHandler.call(this.app[_ns], f, parserOpts)
       if (!isEmpty(config)) break
     }
     return await output(config)
@@ -1023,6 +1024,29 @@ class Bajo extends Plugin {
     if (printSaved) print.succeed('savedAs%s', path.resolve(fname), { skipSilence: true })
     return fname
   }
+
+  /**
+   * Read config using all registered config handlers. The first handler that returns a
+   * valid object or array will be used.
+   *
+   * @param {string} input - The input string to be processed by the config handlers.
+   * @param {string[]} [exts] - Optional array of extensions to filter the config handlers. If provided, only handlers with matching extensions will be used.
+   * @param {object} [options={}] - Options to be passed to the config handlers.
+   * @returns {Object|Array|null} The result from the first successful config handler, or null if none succeed.
+   */
+  readAsConfig = async (input, exts, options = {}) => {
+    let result
+    const handlers = exts ? this.app.configHandlers.filter(h => exts.includes(h.ext)) : this.app.configHandlers
+    for (const handler of handlers) {
+      if (result) break
+      try {
+        const resp = await handler.readHandler.call(this.app[handler.ns], input, options)
+        if (isPlainObject(resp) || isArray(resp)) result = resp
+      } catch (err) {
+      }
+    }
+    return result
+  }
 }
 
 export default Bajo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bajo",
-  "version": "2.19.0",
+  "version": "2.20.1",
   "description": "The ultimate framework for whipping up massive apps in no time",
   "main": "index.js",
   "scripts": {
@@ -44,6 +44,7 @@
   "devDependencies": {
     "chai": "^6.2.1",
     "clean-jsdoc-theme": "^4.3.0",
-    "docdash": "^2.0.2"
+    "docdash": "^2.0.2",
+    "mocha": "^11.7.6"
   }
 }

package/wiki/CHANGES.md

@@ -1,5 +1,16 @@
 # Changes
 
+## 2026-06-28
+
+- [2.20.1] Bug fix in ```readConfig()```
+
+## 2026-06-26
+
+- [2.20.0] Add source ```ns``` to the config handlers
+- [2.20.0] Bug fix in ```bajo.readConfig()```
+- [2.20.0] Add ```bajo.readAsConfig()```
+- [2.20.0] Add ```params.noDot``` to the ```app.getConfigFormats()```
+
 ## 2026-06-26
 
 - [2.19.0] Documentation overhaul