Pnpm

.eslintrc

@@ -0,0 +1,10 @@
+{
+  "extends": "./node_modules/@kaliber/eslint-plugin/.eslintrc",
+  "rules": {
+    "@kaliber/no-relative-parent-import": "off",
+    "import/no-unresolved": "off"
+  },
+  "settings": {
+    "@kaliber/eslint-plugin/lib/absolute-path-resolver-plugin": null
+  }
+}

bin/get-config.js

@@ -8,13 +8,14 @@ try {
 
   const load = require('../load')
   const config = load(configEnv)
-  const result = path.split('.').reduce((result, part) => result[part], config)
+  const result = path.split('.').reduce((result, part) => result[part], /** @type {any} */ (config))
   process.stdout.write(result)
   process.exit(0)
 } catch (e) {
   exit(e)
 }
 
+/** @arg {any} e */
 function exit(e) {
   console.error(e)
   process.exit(1)

index.js

@@ -6,6 +6,10 @@ const load = require('./load')
 
 module.exports = load(configEnv)
 
+/**
+ * @arg {string} error
+ * @returns {never}
+ */
 function exit(error) {
   console.error(error)
   process.exit(1)

load.js

@@ -1,12 +1,18 @@
-const { resolve } = require('path')
-const fs = require('fs')
+const { resolve } = require('node:path')
+const fs = require('node:fs')
 
-module.exports = function load(configEnv) {
+module.exports = load
+
+/**
+ * @arg {string} configEnv
+ * @returns {unknown}
+ */
+function load(configEnv) {
   const configDir = resolve(process.cwd(), 'config')
   const configFiles = [
     { name: 'default', required: false },
     { name: configEnv, required: true  },
-    { name: 'local'  , required: false }
+    { name: 'local', required: false }
   ]
 
   return configFiles.reduce(
@@ -16,19 +22,22 @@ module.exports = function load(configEnv) {
 
       if (exists) {
         let config
-        try { config = require(configFile) }
-        catch (e) { exit(e) }
+        try { config = require(configFile) } catch (e) { exit(e) }
 
         return mergeDeep(result, config)
       } else {
-        if (required) exit(`Could not find configuration for '${name}'`)
+        if (required) return exit(`Could not find configuration for '${name}'`)
         else return result
       }
     },
-    {}
+    /** @type {Record<string, any>} */ ({})
   )
 }
 
+/**
+ * @arg {Record<string, any>} target
+ * @arg {Record<string, any>} source
+ */
 function mergeDeep(target, source) {
   return Object.keys(source).reduce((result, key) => {
     const targetValue = result[key]
@@ -46,17 +55,44 @@ function mergeDeep(target, source) {
   }, target)
 }
 
+/**
+ * @arg {any} error
+ * @returns {never}
+ */
 function exit(error) {
   console.error(error)
   process.exit(1)
 }
 
+/**
+ * @template A
+ * @template B
+ * @arg {A} x
+ * @arg {B} y
+ * @returns {x is B}
+ */
 function canMerge(x, y) { return (isObject(x) && isObject(y)) || (isArray(x) && isArray(y)) }
+/**
+ * @arg {any} x
+ * @returns {x is Record<string, any> | Array<any>}
+ */
 function shouldClone(x) { return isObject(x) || isArray(x) }
+/**
+ * @arg {any} x
+ * @returns {x is Record<string, any>}
+ */
 function isObject(x) {
   const constructor = getConstructor(x)
   return constructor && constructor instanceof constructor
 }
+/**
+ * @arg {any} x
+ * @returns {x is Array<any>}
+ */
 function isArray(x) { return Array.isArray(x) }
+/** @arg {any} x */
 function getConstructor(x) { return isObjectLike(x) && Object.getPrototypeOf(x).constructor }
+/**
+ * @arg {any} x
+ */
 function isObjectLike(x) { return typeof x === 'object' && x !== null }

package.json

@@ -1,8 +1,18 @@
 {
-  "version": "0.0.8",
+  "version": "0.9.9",
   "name": "@kaliber/config",
   "main": "index.js",
   "description": "Zero dependency, minimal configuration library operating on CONFIG_ENV",
+  "type": "commonjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "index.js",
+    "load.js",
+    "README.md",
+    "bin/get-config.js"
+  ],
   "scripts": {
     "test": "node test/index.js"
   },
@@ -19,5 +29,9 @@
   "license": "MIT",
   "bugs": {
     "url": "https://github.com/kaliberjs/config/issues"
+  },
+  "devDependencies": {
+    "@kaliber/eslint-plugin": "^1.0.0",
+    "@types/node": "^22.0.0"
   }
 }