one-lib-4-all

Um gerenciador de pacotes e agregador com dependência zero para bibliotecas @purecore.

Visão Geral

Esta ferramenta permite agregar múltiplos repositórios git em um único objeto importável, mantendo as dependências locais, cacheadas e mínimas.

O Problema que Resolvemos

No desenvolvimento moderno com Node.js/Bun, frequentemente enfrentamos:

1. Inferno de Dependências (Dependency Hell): Instalar uma pequena lib traz centenas de dependências transitivas, aumentando o tamanho do node_modules e introduzindo riscos de segurança.
2. Falta de Controle: Alterações em libs de terceiros podem quebrar seu projeto. Com o one-lib-4-all, você tem o código fonte exato que baixou.
3. Dependência de Registry: Se o npm cair ou um pacote for removido (unpublish), seu build quebra. Aqui, dependemos apenas da disponibilidade do repositório Git.
4. Complexidade de Importação: Gerenciar dezenas de imports separados. Esta ferramenta unifica tudo em um único ponto de entrada.

Como Usar

1. .Crie um arquivo purecore.json na raiz do seu projeto:

   {
     "projects": [
       "[email protected]:suissa/purecore-apify.git",
       "[email protected]:suissa/purecore-reqify.git"
     ]
   }

2. Execute a ferramenta para instalar e gerar os vínculos (bindings).

   bun run src/index.ts install

   (Ou use o binário compilado se disponível)

Funcionalidades

• Cache Local: Repositórios são cacheados em ~/.@purecore/projects. O download só acontece uma vez ou quando explicitamente atualizado.
• Exportação Unificada: Gera um único arquivo TypeScript (purecore_libs/index.ts) exportando todos os módulos definidos.
• Zero Dependências de Runtime: O código gerado depende apenas do código fonte baixado, sem "mágica" ou dependências ocultas do npm.
• Segurança: Você controla exatamente qual código está entrando no seu projeto via Git.