nestjs-env-getter 1.0.0-beta.2 → 1.0.0-beta.3

package/CHANGELOG.md

@@ -7,6 +7,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0-beta.3] - 2025-11-26
+
+### Added
+
+- Improved file watcher resilience: re-establishes the file watcher after each successful update to handle atomic file replacements (e.g., Vault Agent credential rotations).
+
+### Changed
+
+- Increased default `debounceMs` from `200` to `350` ms to reduce noisy re-parses on rapid file updates.
+- Documentation and unit tests updated to cover file replacement and re-establishment behavior.
+
 ## [1.0.0-beta.2] - 2025-10-17
 
 ### Added

package/README.md

@@ -272,7 +272,7 @@ Load and validate configuration from JSON files with automatic file watching and
     { enabled: false },
   );
 
-  // Custom debounce timing (default is 200ms)
+  // Custom debounce timing (default is 350ms)
   const config = this.envGetter.getRequiredConfigFromFile(
     "config.json",
     undefined,
@@ -381,14 +381,14 @@ When the file watcher detects changes, it updates the **same object instance** i
 **File Watcher Options:**
 
 - `enabled` (boolean, default: `true`): Enable or disable automatic file watching
-- `debounceMs` (number, default: `200`): Delay in milliseconds before re-reading the file after a change
+- `debounceMs` (number, default: `350`): Delay in milliseconds before re-reading the file after a change
 
 **Features:**
 
 - ✅ Supports both absolute and relative paths (relative to `process.cwd()`)
 - ✅ Automatic JSON parsing and validation
 - ✅ **Hot-reload with reference preservation** - updates existing object instances in-place
-- ✅ File watching with automatic change detection
+- ✅ File watching with automatic change detection and file replacement support (e.g., Vault agent flow)
 - ✅ Debouncing to prevent excessive re-reads
 - ✅ Class-based validation with constructor pattern
 - ✅ **Graceful error handling for optional configs** - missing files or JSON parsing errors return default values

package/dist/env-getter/env-getter.service.d.ts

@@ -345,6 +345,7 @@ export declare class EnvGetterService implements OnModuleDestroy {
      * Sets up a file watcher for a configuration file.
      * - Watches for file changes and automatically re-reads and updates the cached config.
      * - Applies debouncing to avoid excessive re-reads.
+     * - Re-establishes the watcher after each successful update to handle file replacements (e.g., Vault agent flow).
      * - Emits 'updated' or 'error' events on re-parse.
      * @param filePath - The absolute path to the config file.
      * @param cls - (Optional) A class constructor to validate and instantiate the parsed config.

package/dist/env-getter/env-getter.service.js

@@ -599,6 +599,7 @@ let EnvGetterService = class EnvGetterService {
      * Sets up a file watcher for a configuration file.
      * - Watches for file changes and automatically re-reads and updates the cached config.
      * - Applies debouncing to avoid excessive re-reads.
+     * - Re-establishes the watcher after each successful update to handle file replacements (e.g., Vault agent flow).
      * - Emits 'updated' or 'error' events on re-parse.
      * @param filePath - The absolute path to the config file.
      * @param cls - (Optional) A class constructor to validate and instantiate the parsed config.
@@ -610,20 +611,43 @@ let EnvGetterService = class EnvGetterService {
         var _a, _b, _c;
         const watcherOptions = {
             enabled: (_a = options === null || options === void 0 ? void 0 : options.enabled) !== null && _a !== void 0 ? _a : true,
-            debounceMs: (_b = options === null || options === void 0 ? void 0 : options.debounceMs) !== null && _b !== void 0 ? _b : 200,
+            debounceMs: (_b = options === null || options === void 0 ? void 0 : options.debounceMs) !== null && _b !== void 0 ? _b : 350,
             breakOnError: (_c = options === null || options === void 0 ? void 0 : options.breakOnError) !== null && _c !== void 0 ? _c : true,
         };
-        if (!watcherOptions.enabled || this.fileWatchers.has(filePath))
+        if (!watcherOptions.enabled)
             return;
+        // Close existing watcher if present (for re-establishment)
+        const existingWatcher = this.fileWatchers.get(filePath);
+        if (existingWatcher) {
+            existingWatcher.close();
+            this.fileWatchers.delete(filePath);
+        }
         let debounceTimer = null;
         const watcher = (0, fs_1.watch)(filePath, (eventType) => {
-            if (eventType === "change") {
+            // Handle both "change" and "rename" events to catch file replacements
+            if (eventType === "change" || eventType === "rename") {
                 if (debounceTimer)
                     clearTimeout(debounceTimer);
                 debounceTimer = setTimeout(() => {
+                    // Verify file still exists before attempting to read
+                    if (!(0, fs_1.existsSync)(filePath)) {
+                        // File was deleted, emit error event
+                        const errorEvent = {
+                            filePath,
+                            error: new Error(`Config file '${filePath}' was deleted`),
+                            timestamp: Date.now(),
+                        };
+                        this.events.emit(`error:${filePath}`, errorEvent);
+                        return;
+                    }
                     try {
                         // Re-parse the config (isInitialLoad = false, with breakOnError setting)
                         this.readAndParseConfigFile(filePath, cls, false, watcherOptions.breakOnError, isOptional);
+                        // Close the old watcher
+                        watcher.close();
+                        this.fileWatchers.delete(filePath);
+                        // Re-establish the watcher to handle file replacement scenarios (e.g., Vault agent)
+                        this.setupFileWatcher(filePath, cls, options, isOptional);
                         // Emit file-specific success event
                         const event = {
                             filePath,

package/dist/env-getter/types/file-watcher-options.type.d.ts

@@ -9,7 +9,7 @@ export type FileWatcherOptions = {
     enabled?: boolean;
     /**
      * Debounce delay in milliseconds before re-reading the file after a change is detected.
-     * @default 200
+     * @default 350
      */
     debounceMs?: number;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "nestjs-env-getter",
-    "version": "1.0.0-beta.2",
+    "version": "1.0.0-beta.3",
     "description": "Environment variables getter for Nestjs applications",
     "author": "Ivan Baha",
     "private": false,
@@ -41,24 +41,24 @@
         "dotenv": "^17.2.3"
     },
     "devDependencies": {
-        "@eslint/js": "^9.26.0",
-        "@nestjs/cli": "^11.0.10",
-        "@nestjs/common": "^11.1.6",
-        "@nestjs/core": "^11.1.6",
-        "@nestjs/testing": "^11.1.6",
+        "@eslint/js": "^9.39.1",
+        "@nestjs/cli": "^11.0.12",
+        "@nestjs/common": "^11.1.9",
+        "@nestjs/core": "^11.1.9",
+        "@nestjs/testing": "^11.1.9",
         "@types/jest": "^30.0.0",
-        "@types/node": "^24.7.0",
-        "eslint": "^9.26.0",
+        "@types/node": "^24.10.1",
+        "eslint": "^9.39.1",
         "eslint-config-prettier": "^10.0.3",
-        "eslint-plugin-jsdoc": "^61.0.0",
+        "eslint-plugin-jsdoc": "^61.4.1",
         "eslint-plugin-prettier": "^5.4.0",
-        "globals": "^16.1.0",
+        "globals": "^16.5.0",
         "jest": "^30.2.0",
         "prettier": "^3.5.3",
         "reflect-metadata": "^0.2.2",
         "rxjs": "^7.8.2",
-        "ts-jest": "^29.3.2",
+        "ts-jest": "^29.4.5",
         "typescript": "^5.8.3",
-        "typescript-eslint": "^8.32.0"
+        "typescript-eslint": "^8.48.0"
     }
 }