chore: updare readme

Signed-off-by: tunnckoCore <[email protected]>

Author: tunnckoCore

README.md

@@ -7,25 +7,33 @@
 > A Node.js module for parsing form data, especially file uploads.
 
 [![Code style][codestyle-img]][codestyle-url]
-[![codecoverage][codecov-img]][codecov-url]
+<!-- [![codecoverage][codecov-img]][codecov-url] -->
 [![linux build status][linux-build-img]][build-url]
 [![windows build status][windows-build-img]][build-url]
 [![macos build status][macos-build-img]][build-url]
 
 If you have any _how-to_ kind of questions, please read the [Contributing
 Guide][contributing-url] and [Code of Conduct][code_of_conduct-url]
 documents.<br /> For bugs reports and feature requests, [please create an
-issue][open-issue-url] or ping [@tunnckoCore / @3a1FcBx0](https://twitter.com/3a1FcBx0)
+issue][open-issue-url] or ping [@wgw_eth / @wgw_lol](https://twitter.com/wgw_eth)
 at Twitter.
 
 [![Conventional Commits][ccommits-img]][ccommits-url]
 [![Minimum Required Nodejs][nodejs-img]][npmv-url]
 [![Tidelift Subscription][tidelift-img]][tidelift-url]
 [![Buy me a Kofi][kofi-img]][kofi-url]
-[![Renovate App Status][renovateapp-img]][renovateapp-url]
+<!-- [![Renovate App Status][renovateapp-img]][renovateapp-url] -->
 [![Make A Pull Request][prs-welcome-img]][prs-welcome-url]
 
-This project is [semantically versioned](https://semver.org) and available as
+This project is [semantically versioned](https://semver.org) and if you want support in migrating between versions you can schedule us for training or support us through donations, so we can prioritize.
+
+> [!CAUTION]
+> As of April 2025, old versions like v1 and v2 are still the most used, while they are deperecated for years -- they are also vulnerable to attacks if you are not implementing it properly. **Please upgrade!** We are here to help, and AI Editors & Agents could help a lot in such codemod-like migrations.
+
+> [!TIP]
+> If you are starting a fresh project, you can check out the `formidable-mini` which is a super minimal version of Formidable (not quite configurable yet, but when it does it could become the basis for `formidable@v4`), using web standards like FormData API and File API, and you can use it to stream uploads directly to S3 or other such services.
+
+<!-- This project is [semantically versioned](https://semver.org) and available as
 part of the [Tidelift Subscription][tidelift-url] for professional grade
 assurances, enhanced support and security.
 [Learn more.](https://tidelift.com/subscription/pkg/npm-formidable?utm_source=npm-formidable&utm_medium=referral&utm_campaign=enterprise)
@@ -34,14 +42,15 @@ _The maintainers of `formidable` and thousands of other packages are working
 with Tidelift to deliver commercial support and maintenance for the Open Source
 dependencies you use to build your applications. Save time, reduce risk, and
 improve code health, while paying the maintainers of the exact dependencies you
-use._
+use._ -->
 
 [![][npm-weekly-img]][npmv-url] [![][npm-monthly-img]][npmv-url]
 [![][npm-yearly-img]][npmv-url] [![][npm-alltime-img]][npmv-url]
 
 ## Project Status: Maintained
 
-_Check [VERSION NOTES](https://github.com/node-formidable/formidable/blob/master/VERSION_NOTES.md) for more information on v1, v2, and v3 plans, NPM dist-tags and branches._
+> [!NOTE]
+> Check [VERSION NOTES](https://github.com/node-formidable/formidable/blob/master/VERSION_NOTES.md) for more information on v1, v2, and v3 plans, NPM dist-tags and branches._
 
 This module was initially developed by
 [**@felixge**](https://github.com/felixge) for
@@ -70,9 +79,8 @@ rules, like enabling Two-Factor Auth in your npm and GitHub accounts.
 
 This package is a dual ESM/commonjs package.
 
-This project requires `Node.js >= 10.13`. Install it using
-[yarn](https://yarnpkg.com) or [npm](https://npmjs.com).<br /> _We highly
-recommend to use Yarn when you think to contribute to this project._
+> [!NOTE]
+> This project requires `Node.js >= 20`. Install it using [yarn](https://yarnpkg.com) or [npm](https://npmjs.com).<br /> _We highly recommend to use Yarn when you think to contribute to this project._
 
 This is a low-level package, and if you're using a high-level framework it _may_
 already be included. Check the examples below and the [examples/](https://github.com/node-formidable/formidable/tree/master/examples) folder.
@@ -425,12 +433,12 @@ multipart stream. Doing so will disable any `'field'` / `'file'` events
 processing which would occur otherwise, making you fully responsible for
 handling the processing.
 
-About `uploadDir`, given the following directory structure 
+About `uploadDir`, given the following directory structure
 ```
 project-name
 ├── src
 │   └── server.js
-│       
+│
 └── uploads
     └── image.jpg
 ```
@@ -620,7 +628,7 @@ export interface File {
 
   // The name this file had according to the uploading client.
   file.originalFilename: string | null;
-  
+
   // calculated based on options provided
   file.newFilename: string | null;
 
@@ -670,7 +678,7 @@ file system.
 
 ```js
 form.on('fileBegin', (formName, file) => {
-    // accessible here 
+    // accessible here
     // formName the name in the form (<input name="thisname" type="file">) or http filename for octetstream
     // file.originalFilename http filename or null if there was a parsing error
     // file.newFilename generated hexoid or what options.filename returned
@@ -759,7 +767,7 @@ form.parse(request, async (error, fieldsMultiple, files) => {
         //...
     }
     const fieldsSingle = firstValues(form, fieldsMultiple);
-    
+
     const expectedBooleans = ['checkbox1', 'wantsNewsLetter', 'hasACar'];
     const fieldsWithBooleans = readBooleans(fieldsSingle, expectedBooleans);
     // ...

README_pt_BR.md

@@ -9,7 +9,6 @@
 [![Code style][codestyle-img]][codestyle-url]
 [![codecoverage][codecov-img]][codecov-url]
 [![linux build status][linux-build-img]][build-url]
-[![windows build status][windows-build-img]][build-url]
 [![macos build status][macos-build-img]][build-url]
 
 Se você tiver qualquer tipo de pergunta sobre _como_ fazer, por favor leia o [Contributing
@@ -71,7 +70,7 @@ Este projeto requer `Node.js >= 10.13`. Instale-o usando
 [yarn](https://yarnpkg.com) ou [npm](https://npmjs.com).<br /> _Nós altamente
 recomendamos usar o Yarn quando pensar em contribuir para este projeto._
 
-Este é um pacote de baixo nível e, se você estiver usando uma estrutura de alto nível, _pode_ já estar incluído. Verifique os exemplos 
+Este é um pacote de baixo nível e, se você estiver usando uma estrutura de alto nível, _pode_ já estar incluído. Verifique os exemplos
 abaixo e a pasta [examples/](https://github.com/node-formidable/formidable/tree/master/examples).
 
 ```
@@ -83,7 +82,7 @@ npm install formidable@v2
 npm install formidable@v3
 ```
 
-_**Nota:** Em um futuro próximo, a v3 será publicada na dist-tag `latest` do NPM. 
+_**Nota:** Em um futuro próximo, a v3 será publicada na dist-tag `latest` do NPM.
 Versões futuras não prontas serão publicadas nas dist-tags `*-next` para a versão correspondente._
 
 
@@ -206,7 +205,7 @@ app.on('error', (err) => {
 app.use(async (ctx, next) => {
   if (ctx.url === '/api/upload' && ctx.method.toLowerCase() === 'post') {
     const form = formidable({});
-    
+
      // não muito elegante, mas é por enquanto se você não quiser usar `koa-better-body`
      // ou outros middlewares.
     await new Promise((resolve, reject) => {
@@ -359,7 +358,7 @@ form.bytesExpected;
 
 #### `options.filter`  **{function}** function ({name, originalFilename, mimetype}) -> boolean
 
-**Observação:** use uma variável externa para cancelar todos os uploads no primeiro erro 
+**Observação:** use uma variável externa para cancelar todos os uploads no primeiro erro
 
 ```js
 const options = {
@@ -385,16 +384,16 @@ form.parse(req, (err, fields, files) => {
 });
 ```
 
-Você pode substituir esse método se estiver interessado em acessar diretamente o 
-fluxo de várias partes. Fazer isso desativará qualquer processamento de eventos `'field'` / `'file'` 
+Você pode substituir esse método se estiver interessado em acessar diretamente o
+fluxo de várias partes. Fazer isso desativará qualquer processamento de eventos `'field'` / `'file'`
 que ocorreria de outra forma, tornando você totalmente responsável por lidar com o processamento.
 
 Sobre `uploadDir`, dada a seguinte estrutura de diretório
 ```
 project-name
 ├── src
 │   └── server.js
-│       
+│
 └── uploads
     └── image.jpg
 ```
@@ -424,7 +423,7 @@ createNecessaryDirectoriesSync(`${uploadPath}/x`);
 ```
 
 
-No exemplo abaixo, escutamos alguns eventos e os direcionamos para o ouvinte `data`, para 
+No exemplo abaixo, escutamos alguns eventos e os direcionamos para o ouvinte `data`, para
 que você possa fazer o que quiser lá, com base em se é antes do arquivo ser emitido, o valor do
 cabeçalho, o nome do cabeçalho, no campo , em arquivo e etc.
 
@@ -514,7 +513,7 @@ form.parse(req, (error, fields, files) => {
 `this`, para que você possa testar seu plugin mais tarde de forma independente e mais fácil.
 
 Se você quiser desabilitar alguns recursos de análise do Formidable, você pode desabilitar
-o plugin que corresponde ao analisador. Por exemplo, se você deseja desabilitar a análise de 
+o plugin que corresponde ao analisador. Por exemplo, se você deseja desabilitar a análise de
 várias partes (para que o [src/parsers/Multipart.js](./src/parsers/Multipart.js)
 que é usado em [src/plugins/multipart.js](./src/plugins/multipart.js)), então
 você pode removê-lo do `options.enabledPlugins`, assim
@@ -530,8 +529,8 @@ const form = formidable({
 **Esteja ciente** de que a ordem _PODE_ ser importante também. Os nomes correspondem 1:1 a
 arquivos na pasta [src/plugins/](./src/plugins).
 
-Solicitações pull para novos plug-ins integrados PODEM ser aceitas - por exemplo, analisador de 
-querystring mais avançado. Adicione seu plugin como um novo arquivo na pasta `src/plugins/` (em letras minúsculas) e 
+Solicitações pull para novos plug-ins integrados PODEM ser aceitas - por exemplo, analisador de
+querystring mais avançado. Adicione seu plugin como um novo arquivo na pasta `src/plugins/` (em letras minúsculas) e
 siga como os outros plugins são feitos.
 
 ### form.onPart
@@ -581,7 +580,7 @@ export interface File {
 
   // O nome que este arquivo tinha de acordo com o cliente de upload.
   file.originalFilename: string | null;
-  
+
   // calculado com base nas opções fornecidas.
   file.newFilename: string | null;
 
@@ -600,7 +599,7 @@ export interface File {
 
 #### file.toJSON()
 
-Este método retorna uma representação JSON do arquivo, permitindo que você `JSON.stringify()` 
+Este método retorna uma representação JSON do arquivo, permitindo que você `JSON.stringify()`
 o arquivo que é útil para registrar e responder a solicitações.
 
 ### Eventos
@@ -623,7 +622,7 @@ form.on('field', (name, value) => {});
 
 #### `'fileBegin'`
 
-Emitido sempre que um novo arquivo é detectado no fluxo de upload. 
+Emitido sempre que um novo arquivo é detectado no fluxo de upload.
 Use este evento se desejar transmitir o arquivo para outro lugar enquanto armazena o upload no sistema de arquivos.
 
 ```js
@@ -652,7 +651,7 @@ form.on('file', (formname, file) => {
 
 #### `'error'`
 
-Emitido quando há um erro no processamento do formulário recebido. Uma solicitação que 
+Emitido quando há um erro no processamento do formulário recebido. Uma solicitação que
 apresenta um erro é pausada automaticamente, você terá que chamar manualmente
 `request.resume()` se você quiser que a requisição continue disparando eventos `'data'`.
 
@@ -675,7 +674,7 @@ form.on('aborted', () => {});
 
 #### `'end'`
 
-Emitido quando toda a solicitação foi recebida e todos os arquivos contidos foram 
+Emitido quando toda a solicitação foi recebida e todos os arquivos contidos foram
 liberados para o disco. Este é um ótimo lugar para você enviar sua resposta.
 
 ```js
@@ -718,7 +717,7 @@ form.parse(request, async (error, fieldsMultiple, files) => {
         //...
     }
     const fieldsSingle = firstValues(form, fieldsMultiple);
-    
+
     const expectedBooleans = ['checkbox1', 'wantsNewsLetter', 'hasACar'];
     const fieldsWithBooleans = readBooleans(fieldsSingle, expectedBooleans);
     // ...
@@ -736,7 +735,7 @@ form.parse(request, async (error, fieldsMultiple, files) => {
 
 ## Contribuindo
 
-Se a documentação não estiver clara ou tiver um erro de digitação, clique no botão `Edit` da página (ícone de lápis) e sugira uma correção. 
+Se a documentação não estiver clara ou tiver um erro de digitação, clique no botão `Edit` da página (ícone de lápis) e sugira uma correção.
 Se você gostaria de nos ajudar a corrigir
 um bug ou adicionar um novo recurso, verifique nosso [Contributing
 Guide][contribuindo-url]. Pull requests são bem-vindos!
@@ -834,8 +833,7 @@ Formidable é licenciado sob a [MIT License][license-url].
 [kofi-url]: https://ko-fi.com/tunnckoCore/commissions
 [kofi-img]: https://badgen.net/badge/ko-fi/support/29abe0c2?cache=300&icon=https://rawcdn.githack.com/tunnckoCore/badgen-icons/f8264c6414e0bec449dd86f2241d50a9b89a1203/icons/kofi.svg
 
-[linux-build-img]: https://badgen.net/github/checks/node-formidable/formidable/master/ubuntu?cache=300&label=linux%20build&icon=github
-[macos-build-img]: https://badgen.net/github/checks/node-formidable/formidable/master/macos?cache=300&label=macos%20build&icon=github
-[windows-build-img]: https://badgen.net/github/checks/node-formidable/formidable/master/windows?cache=300&label=windows%20build&icon=github
-[build-url]: https://github.com/node-formidable/formidable/actions?query=workflow%3Anodejs
+[linux-build-img]: https://badgen.net/github/checks/node-formidable/formidable/master?cache=30&label=linux%20build&icon=github
+[macos-build-img]: https://badgen.net/github/checks/node-formidable/formidable/master?cache=30&label=macos%20build&icon=github
+[build-url]: https://github.com/node-formidable/formidable/actions
 <!-- prettier-ignore-end -->

package.json

@@ -63,7 +63,7 @@
     "test-specific": "node --disable-warning=ExperimentalWarning --experimental-vm-modules ./node_modules/jest/bin/jest.js --testPathPattern=test/standalone/keep-alive-error.test.js",
     "test": "npm run test-specific && npm run test-jest && npm run test-node",
     "test-jest": "node --disable-warning=ExperimentalWarning --experimental-vm-modules ./node_modules/jest/bin/jest.js --testPathPattern=test/ --coverage",
-    "test-node": "node --disable-warning=ExperimentalWarning --test test-node/**/*.test.js",
+    "test-node": "node --disable-warning=ExperimentalWarning --test --experimental-test-coverage test-node/**/*.test.js",
     "pretest:ci": "yarn run pretest",
     "test:ci": "node --disable-warning=ExperimentalWarning --experimental-vm-modules node_modules/.bin/nyc jest --testPathPattern=test/ --coverage && node --disable-warning=ExperimentalWarning --experimental-vm-modules node_modules/.bin/nyc node --test test-node/"
   },