Version 5.1 release notes | FoalTS

"The Disk and LocalDisk services have a new method mkdirIfNotExists to creates directories. This is useful when using the local file system to ensure that a directory exists before saving files. Otherwise, an error can be thrown when it does not. On cloud storage services such as S3, directories are created automatically when saving files so this method does nothing."

"The Logger service has a new method addErrorContext which works like addLogContext but only for error-level logs. This is useful to add context information that is only relevant for errors (e.g. request body, etc.) without polluting the other log levels. The iteration count of the hashPassword function has been increased to 600,000 to match the latest OWASP recommendations."

Version 5.1 of Foal is now tested against and officially supports Node.js 24. Disk and LocalDisk services add mkdirIfNotExists to create directories on local file systems; cloud storage services like S3 already create directories automatically so the method is a no-op there. The Logger service adds addErrorContext to attach context only to error-level logs. The hashPassword function now uses 600,000 iterations to align with OWASP recommendations. Generated src/index.ts on new projects improves error logging from the main function. AsyncService.run executes functions fully asynchronously in all scenarios. OpenAPI documentation for @PermissionRequired and sub-dependency updates were added.

Read at Foalts