configate 1.1.0 → 1.2.0

package/README.md

@@ -124,8 +124,10 @@ Do the same for other environments if you need to override more properties for t
 When you need to define secrets in configuration, they should be defined via environment variables.
 
 Create `custom-environment-variables.ts` file in `config` directory and export a `config` object.
+
 - use `process.env` to read environment variables and assign to property in your configuration
-- this file will be merged with other configs as last one so environment variables always have priority
+- this file is merged last within its directory, so its defined values override other files in that directory
+   - when loading multiple directories, later directories can override these values.
 
 ```ts
 // config/custom-environment-variables.ts
@@ -190,6 +192,8 @@ This keeps the base config reusable while still letting you target per-variant o
 
 ### Order of loading configuration files
 
+The following order applies separately within each configuration directory.
+
 ```
 1. default.ext
 2. default-{variant}.ext
@@ -250,6 +254,11 @@ const host = config.database.host;
 
 #### Loading configurations from multiple directories
 
+Directories are fully loaded and merged in `configDirs` order. 
+Values from later directories override matching properties from earlier directories.
+
+For example, a value in the second directory's `default.ts` can override the same property from the first directory's `custom-environment-variables.ts`.
+
 ```ts
 import { loadConfig } from 'configate';
 

package/dist/deepFreezeConfig.js

@@ -4,7 +4,7 @@ import { isObject } from "./common.js";
  */
 export function deepFreezeConfig(config) {
     for (const key in config) {
-        if (isObject(config[key])) {
+        if (isObject(config[key]) || Array.isArray(config[key])) {
             config[key] = deepFreezeConfig(config[key]);
         }
     }

package/dist/importConfigFiles.js

@@ -60,10 +60,17 @@ export async function importConfigFiles({ configDir, environment, variant, fileE
             fileExtensions,
         })
         : {};
+    /** local-{environment}-{variant}.ext **/
+    const localEnvVariantConfig = environment && variant
+        ? await importConfigFile({
+            filePath: `${configDir}/local-${environment}-${variant}`,
+            fileExtensions,
+        })
+        : {};
     /** custom-environment-variables.ext **/
     const customEnvVarsConfig = await importConfigFile({
         filePath: `${configDir}/custom-environment-variables`,
         fileExtensions: fileExtensions.filter((ext) => ext !== 'json'), // JSON not supported because it cannot use `process.env`
     });
-    return deepMerge(structuredClone(defaultConfig), structuredClone(defaultVariantConfig ?? {}), structuredClone(environmentConfig ?? {}), structuredClone(environmentVariantConfig ?? {}), structuredClone(localConfig), structuredClone(localVariantConfig ?? {}), structuredClone(localEnvConfig), structuredClone(customEnvVarsConfig));
+    return deepMerge(structuredClone(defaultConfig), structuredClone(defaultVariantConfig ?? {}), structuredClone(environmentConfig ?? {}), structuredClone(environmentVariantConfig ?? {}), structuredClone(localConfig), structuredClone(localVariantConfig ?? {}), structuredClone(localEnvConfig), structuredClone(localEnvVariantConfig), structuredClone(customEnvVarsConfig));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "configate",
-	"version": "1.1.0",
+	"version": "1.2.0",
 	"type": "module",
 	"description": "Configuration helper for TypeScript applications",
 	"main": "dist/index.js",
@@ -30,6 +30,10 @@
 		"type": "git",
 		"url": "git+https://github.com/mdrobny/configate.git"
 	},
+	"publishConfig": {
+		"registry": "https://registry.npmjs.org",
+		"provenance": true
+	},
 	"keywords": [
 		"config"
 	],
@@ -40,8 +44,18 @@
 	},
 	"homepage": "https://github.com/mdrobny/configate#readme",
 	"devDependencies": {
-		"@biomejs/biome": "2.3.8",
+		"@biomejs/biome": "2.5.13",
 		"@types/node": "^22.10.6",
 		"typescript": "^5.7.3"
+	},
+	"devEngines": {
+		"runtime": {
+			"name": "node",
+			"onFail": "error"
+		},
+		"packageManager": {
+			"name": "npm",
+			"onFail": "error"
+		}
 	}
 }