TS Zip Extractor

Esta ferramenta habilita a extração ZIP em ambientes TypeScript e Node.js. Usuários fazem upload de um arquivo ZIP e recebem uma extração hierárquica em disco ou um Manifest programático que lista caminhos de arquivos, tamanhos e tipos MIME para processamento downstream. Destina-se a desenvolvedores, engenheiros de dados, pipelines de build e scripts de automação que consomem ativos comprimidos ou conjuntos de dados.

Conceitualmente, a ferramenta executa uma extração segura e em streaming. Primeiro lê o diretório central para enumerar entradas, valida o cabeçalho PK e sanear cada caminho para evitar Zip Slip. Dependendo da configuração, entradas são transmitidas para memória ou para um diretório de destino, enquanto um manifesto em memória é construído junto com uma tabela de metadados de arquivos.

A saída inclui um manifesto para uso programático e, opcionalmente, um conteúdo extraído para download. Lida com pastas aninhadas, mantém ou normaliza permissões quando suportado e reporta metadados por arquivo como caminho, tamanho e tipo. Isso permite processamento imediato por transformadores, loaders ou etapas de implantação.

O foco está em segurança, eficiência de memória e integração com CI. Suporta senha opcional se a biblioteca subjacente conseguir decifrar ZIPs criptografados, e os resultados são determinísticos entre execuções. Casos de uso: extração de ativos para apps web, preparação de dados para análises e empacotamento pré-implantação em fluxos TS.