Patch Changes

• fix: retry fs.lstat on transient EBUSY errors instead of emitting a spurious remove event (fixes #223, #44). The retry count is controlled by the WATCHPACK_RETRIES environment variable (default: 3; set to 0 or "false" to disable retrying). (by @alexander-akait in #293)

• Improve perfomance for ignored and improve perfomance for reduce plan. (by @alexander-akait in #289)

• perf: speed up ignored matchers (~35–45% faster on POSIX paths) and reducePlan (~20–40% faster on medium and large plans). Also adds a tinybench suite under bench/ and a CodSpeed GitHub Actions workflow to catch future regressions. (by @alexander-akait in #287)

• fix: don't log "Watchpack Error (initial scan)" for unreadable entries inside a watched parent directory, e.g. pagefile.sys on WSL or /efi on Linux (fixes #187). EACCES / ENODEV (and EINVAL on Windows) errors are now handled like EPERM / ENOENT / EBUSY: the entry is recorded as missing and the scan continues silently. (by @alexander-akait in #298)

• fix: prevent unbounded watcher growth when a symlinked directory points back to one of its own ancestors (e.g. a/b/loop -> ..) with followSymlinks: true. Such symlinks are now recorded as plain entries instead of being descended into; symlinks pointing outside the watched tree (#231) behave as before. (by @alexander-akait in #297)

Fixes

• typo in typescript types

Features

• Added types

Fixes

• Node.js v24+ changed permission access error codes

Bugfixes

• ignore listening for the directory itself to be deleted

Performance

• limit the number of concurrently open file watchers on macOS

Bugfixes

• handle empty strings and arrays in ignored

Bugfixes

• do not report directory as initial missing on the second watch

Bugfixes

• respect filesystem accuracy more accurately

Bugfixes

• report time info for directories correctly

Features

• allow to grab separate file and directory time info objects
• allow functions passed to the ignored option

Bugfixes

• ignore EACCESS errors during initial scan

Performance

• improve performance of watcher update

Contributing

• CI tests node.js 17 too