@meltstudio/config-loader 3.7.0 → 3.7.1

package/README.md

@@ -68,6 +68,37 @@ yarn add @meltstudio/config-loader
 
 Requires Node.js >= 20.
 
+## Watch Mode
+
+Automatically reload config when files change. Watchers use `.unref()` so they don't prevent the process from exiting.
+
+```typescript
+const watcher = c
+  .schema({
+    port: c.number({ env: "PORT", defaultValue: 3000 }),
+    host: c.string({ defaultValue: "localhost" }),
+  })
+  .watch(
+    { env: true, args: false, files: "./config.yaml" },
+    {
+      onChange: (newConfig, oldConfig, changes) => {
+        for (const change of changes) {
+          console.log(
+            `${change.path}: ${String(change.oldValue)} → ${String(change.newValue)}`,
+          );
+        }
+      },
+      onError: (err) => console.error("Reload failed:", err.message),
+    },
+  );
+
+// Access current config anytime
+console.log(watcher.config.port);
+
+// Stop watching
+watcher.close();
+```
+
 ## Documentation
 
 See the **[full documentation](https://meltstudio.github.io/config-loader/)** for:

package/dist/index.js

@@ -1258,6 +1258,7 @@ function createWatcher(schema2, sources, options) {
     if (closed) return;
     try {
       clearFileCache();
+      clearEnvFileCache();
       const settings = new settings_default(schema2, sources);
       const newConfig = settings.get();
       const changes = diffConfig(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meltstudio/config-loader",
-  "version": "3.7.0",
+  "version": "3.7.1",
   "description": "Type-safe configuration loader with full TypeScript inference. Load from YAML, JSON, TOML, .env, environment variables, and CLI args.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",