{"_id":"@boruto_vk7/gerador-sensi","name":"@boruto_vk7/gerador-sensi","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@boruto_vk7/gerador-sensi","version":"1.0.0","description":"Gerador Inteligente de Sensibilidade para Free Fire - Integrado com AnTuTu","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","dev":"ts-node src/index.ts","test":"echo \"Tests pending\" && exit 0"},"keywords":["free-fire","sensibilidade","sensi","antutu","gerador","ff","gaming","sensitivity"],"author":{"name":"Boruto_vk7"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Boruto_vk7/gerador-sensi.git"},"bugs":{"url":"https://github.com/Boruto_vk7/gerador-sensi/issues"},"homepage":"https://github.com/Boruto_vk7/gerador-sensi#readme","dependencies":{"axios":"^1.7.0","cheerio":"^1.0.0-rc.12"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0","ts-node":"^10.9.0"},"engines":{"node":">=14.0.0"},"_id":"@boruto_vk7/gerador-sensi@1.0.0","_nodeVersion":"22.13.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-YVs7bKOYJKFfy/wObB6ajKh/mK8Dm4MKg30Rmm45SzhLDbczA79WlNwGkj1vHt/U3ePv5nBF4UuB5HiKFwnnpQ==","shasum":"242c12c0e88899a56f3cf90b4e1c0943c0f5b275","tarball":"https://registry.npmjs.org/@boruto_vk7/gerador-sensi/-/gerador-sensi-1.0.0.tgz","fileCount":9,"unpackedSize":49050,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCl/czFPyshGRFFdD9/oNXcHSpnbl/OY4BBSI8BPD12mAIgT34qtGH/sATAgGlSSYZAVdJ46hSnbuu+Mycmj21nMYQ="}]},"_npmUser":{"name":"eduh_dev021","email":"kentakakura021028@gmail.com"},"directories":{},"maintainers":[{"name":"eduh_dev021","email":"kentakakura021028@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gerador-sensi_1.0.0_1780643890712_0.7049127491924558"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-05T07:18:10.606Z","1.0.0":"2026-06-05T07:18:10.871Z","modified":"2026-06-05T07:18:11.108Z"},"maintainers":[{"name":"eduh_dev021","email":"kentakakura021028@gmail.com"}],"description":"Gerador Inteligente de Sensibilidade para Free Fire - Integrado com AnTuTu","homepage":"https://github.com/Boruto_vk7/gerador-sensi#readme","keywords":["free-fire","sensibilidade","sensi","antutu","gerador","ff","gaming","sensitivity"],"repository":{"type":"git","url":"git+https://github.com/Boruto_vk7/gerador-sensi.git"},"author":{"name":"Boruto_vk7"},"bugs":{"url":"https://github.com/Boruto_vk7/gerador-sensi/issues"},"license":"MIT","readme":"# @boruto_vk7/gerador-sensi\n\n[![npm version](https://img.shields.io/npm/v/@boruto_vk7/gerador-sensi.svg)](https://www.npmjs.com/package/@boruto_vk7/gerador-sensi)\n[![npm downloads](https://img.shields.io/npm/dm/@boruto_vk7/gerador-sensi.svg)](https://www.npmjs.com/package/@boruto_vk7/gerador-sensi)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**Gerador Inteligente de Sensibilidade para Free Fire** — Calcula automaticamente a melhor configuração de sensibilidade baseado no desempenho real do seu dispositivo (AnTuTu), estilo de jogo e preferências pessoais.\n\n## 🎯 Características\n\n- **🔍 Integração com AnTuTu**: Busca dados reais de performance do seu dispositivo\n- **🎮 3 Estilos de Jogo**: Agressivo, Equilibrado e Sniper\n- **📊 Cálculo Inteligente**: Algoritmo baseado em AnTuTu score, não em categorias genéricas\n- **⚡ Cache Automático**: Reduz requisições ao AnTuTu com cache de 1 hora\n- **🔎 Busca Avançada**: Procure por marca, faixa de AnTuTu ou veja o ranking top\n- **📱 Suporte Universal**: Funciona com qualquer dispositivo Android/iOS\n- **🚀 TypeScript**: Tipos completos e IntelliSense\n- **📦 Zero Dependências Externas**: Apenas axios e cheerio\n\n## 📦 Instalação\n\n```bash\nnpm install @boruto_vk7/gerador-sensi\n```\n\nOu com yarn:\n\n```bash\nyarn add @boruto_vk7/gerador-sensi\n```\n\n## 🚀 Uso Rápido\n\n### Gerar Sensibilidade para um Dispositivo\n\n```javascript\nimport SensitivityGenerator from '@boruto_vk7/gerador-sensi';\n\n// Gerar sensibilidade equilibrada para Samsung A15\nconst result = await SensitivityGenerator.generate('Samsung A15', 'balanced');\n\nconsole.log(result);\n// {\n//   device: 'Samsung Galaxy A15',\n//   antutu: 350000,\n//   category: 'intermediate',\n//   dpi: 650,\n//   general: 160,\n//   redDot: 170,\n//   scope2x: 160,\n//   scope4x: 170,\n//   awm: 120,\n//   freeCamera: 140,\n//   style: 'balanced',\n//   timestamp: '2026-06-05T...'\n// }\n```\n\n### Gerar Múltiplas Variações\n\n```javascript\n// Gerar os 3 estilos (agressivo, equilibrado, sniper)\nconst variations = await SensitivityGenerator.generateVariations('iPhone 13');\n\nvariations.forEach((v) => {\n  console.log(`${v.style}: Geral=${v.general}, Câmera=${v.freeCamera}`);\n});\n// aggressive: Geral=185, Câmera=160\n// balanced: Geral=175, Câmera=140\n// sniper: Geral=160, Câmera=130\n```\n\n### Buscar Informações do Dispositivo\n\n```javascript\n// Obter informações completas do dispositivo\nconst device = await SensitivityGenerator.getDeviceInfo('Samsung A15');\n\nconsole.log(device);\n// {\n//   rank: 45,\n//   name: 'Samsung Galaxy A15',\n//   soc: 'Exynos 1280',\n//   cpu: 285000,\n//   gpu: 95000,\n//   mem: 45000,\n//   ux: 65000,\n//   totalScore: 490000\n// }\n```\n\n### Ver Melhores Dispositivos\n\n```javascript\n// Top 10 dispositivos\nconst topDevices = await SensitivityGenerator.getBestDevices(10);\n\ntopDevices.forEach((device, i) => {\n  console.log(`${i + 1}. ${device.name} - AnTuTu: ${device.totalScore}`);\n});\n// 1. Red Magic 11 Pro - AnTuTu: 3964036\n// 2. OPPO Find X9 Ultra - AnTuTu: 3876104\n// 3. HONOR WIN - AnTuTu: 3764432\n// ...\n```\n\n### Buscar por Marca\n\n```javascript\n// Todos os Samsung no ranking\nconst samsungs = await SensitivityGenerator.getDevicesByBrand('Samsung', 20);\n\nsamsungs.forEach((device) => {\n  console.log(`${device.name}: ${device.totalScore}`);\n});\n```\n\n### Buscar por Faixa de AnTuTu\n\n```javascript\n// Dispositivos intermediários (200k - 400k)\nconst intermediate = await SensitivityGenerator.getDevicesByScoreRange(200000, 400000);\n\nconsole.log(`Encontrados ${intermediate.length} dispositivos intermediários`);\n```\n\n### Gerar com AnTuTu Manual\n\n```javascript\n// Se você já sabe o AnTuTu do seu celular\nconst result = SensitivityGenerator.generateManual(350000, 'balanced');\n\nconsole.log(result);\n// {\n//   device: 'Manual',\n//   antutu: 350000,\n//   category: 'intermediate',\n//   dpi: 650,\n//   general: 160,\n//   ...\n// }\n```\n\n## 📚 API Completa\n\n### `generate(deviceName, style?)`\n\nGera sensibilidade para um dispositivo específico.\n\n**Parâmetros:**\n- `deviceName` (string): Nome do dispositivo (ex: \"Samsung A15\", \"iPhone 13\")\n- `style` (string, opcional): \"aggressive\" | \"balanced\" | \"sniper\" (padrão: \"balanced\")\n\n**Retorna:** `Promise<SensitivityResult | null>`\n\n---\n\n### `generateVariations(deviceName)`\n\nGera as 3 variações de estilo para um dispositivo.\n\n**Parâmetros:**\n- `deviceName` (string): Nome do dispositivo\n\n**Retorna:** `Promise<SensitivityResult[] | null>`\n\n---\n\n### `generateManual(antutu, style?)`\n\nGera sensibilidade com AnTuTu manual (sem buscar no site).\n\n**Parâmetros:**\n- `antutu` (number): Score do AnTuTu\n- `style` (string, opcional): \"aggressive\" | \"balanced\" | \"sniper\" (padrão: \"balanced\")\n\n**Retorna:** `SensitivityResult`\n\n---\n\n### `getDeviceInfo(deviceName)`\n\nBusca informações completas de um dispositivo.\n\n**Parâmetros:**\n- `deviceName` (string): Nome do dispositivo\n\n**Retorna:** `Promise<DeviceInfo | null>`\n\n---\n\n### `getTopDevices(limit?)`\n\nObtém os melhores dispositivos do ranking do AnTuTu.\n\n**Parâmetros:**\n- `limit` (number, opcional): Quantidade de dispositivos (padrão: 50)\n\n**Retorna:** `Promise<DeviceInfo[] | null>`\n\n---\n\n### `getBestDevices(limit?)`\n\nAlias para `getTopDevices()`.\n\n**Parâmetros:**\n- `limit` (number, opcional): Quantidade de dispositivos (padrão: 10)\n\n**Retorna:** `Promise<DeviceInfo[] | null>`\n\n---\n\n### `getDevicesByBrand(brand, limit?)`\n\nBusca dispositivos de uma marca específica.\n\n**Parâmetros:**\n- `brand` (string): Nome da marca (ex: \"Samsung\", \"iPhone\", \"Redmi\")\n- `limit` (number, opcional): Quantidade de dispositivos (padrão: 20)\n\n**Retorna:** `Promise<DeviceInfo[]>`\n\n---\n\n### `getDevicesByScoreRange(minScore, maxScore)`\n\nBusca dispositivos em uma faixa de AnTuTu.\n\n**Parâmetros:**\n- `minScore` (number): Score mínimo\n- `maxScore` (number): Score máximo\n\n**Retorna:** `Promise<DeviceInfo[]>`\n\n---\n\n## 📊 Tipos TypeScript\n\n### `SensitivityResult`\n\n```typescript\ninterface SensitivityResult {\n  device: string;\n  antutu: number;\n  category: 'basic' | 'intermediate' | 'good' | 'top' | 'ultra';\n  dpi: number;\n  general: number;\n  redDot: number;\n  scope2x: number;\n  scope4x: number;\n  awm: number;\n  freeCamera: number;\n  style: 'aggressive' | 'balanced' | 'sniper';\n  timestamp: string;\n}\n```\n\n### `DeviceInfo`\n\n```typescript\ninterface DeviceInfo {\n  rank: number;\n  name: string;\n  soc: string;\n  cpu: number;\n  gpu: number;\n  mem: number;\n  ux: number;\n  totalScore: number;\n}\n```\n\n---\n\n## 🎮 Entendendo os Estilos\n\n### Agressivo\n- **Ideal para**: Jogadores que gostam de rotação rápida e movimento constante\n- **Características**: Geral e Câmera Livre aumentados\n- **Quando usar**: Modo Squad, combates próximos\n\n### Equilibrado\n- **Ideal para**: Maioria dos jogadores\n- **Características**: Balanço entre precisão e velocidade\n- **Quando usar**: Todos os modos\n\n### Sniper\n- **Ideal para**: Jogadores que focam em precisão\n- **Características**: Miras curtas reduzidas, 4x e AWM aumentados\n- **Quando usar**: Modo Sniper, combates à distância\n\n---\n\n## 🔧 Categorias de Dispositivos\n\n| Categoria | AnTuTu | Exemplo |\n|-----------|--------|---------|\n| **Basic** | < 200k | Moto E6, Samsung A02 |\n| **Intermediate** | 200k - 400k | Samsung A15, Redmi 9 |\n| **Good** | 400k - 600k | Samsung A52, iPhone 11 |\n| **Top** | 600k - 800k | Samsung S22, iPhone 13 |\n| **Ultra** | > 800k | Red Magic 11, iPhone 15 Pro |\n\n---\n\n## 💡 Exemplos Práticos\n\n### Exemplo 1: Encontrar Melhor Dispositivo\n\n```javascript\nconst topDevices = await SensitivityGenerator.getBestDevices(5);\nconst best = topDevices[0];\n\nconst sensi = await SensitivityGenerator.generate(best.name, 'aggressive');\nconsole.log(`Melhor dispositivo: ${best.name}`);\nconsole.log(`Sensibilidade recomendada: ${sensi.general}`);\n```\n\n### Exemplo 2: Comparar Estilos\n\n```javascript\nconst variations = await SensitivityGenerator.generateVariations('iPhone 13');\n\nconsole.log('Comparação de Estilos:');\nvariations.forEach((v) => {\n  console.log(`\n${v.style.toUpperCase()}:\n  Geral: ${v.general}\n  Ponto: ${v.redDot}\n  2x: ${v.scope2x}\n  4x: ${v.scope4x}\n  AWM: ${v.awm}\n  Câmera: ${v.freeCamera}\n  `);\n});\n```\n\n### Exemplo 3: Buscar Dispositivos em Faixa\n\n```javascript\n// Encontrar dispositivos intermediários\nconst devices = await SensitivityGenerator.getDevicesByScoreRange(200000, 400000);\n\nconsole.log(`Dispositivos intermediários encontrados: ${devices.length}`);\n\n// Gerar sensi para cada um\nfor (const device of devices.slice(0, 5)) {\n  const sensi = await SensitivityGenerator.generate(device.name);\n  console.log(`${device.name}: Geral=${sensi.general}`);\n}\n```\n\n---\n\n## ⚙️ Configuração Avançada\n\n### Cache\n\nO módulo usa cache automático de 1 hora para reduzir requisições ao AnTuTu.\n\n```javascript\n// Limpar cache (se necessário)\n// Nota: Não há método público, mas o cache expira automaticamente\n```\n\n### Timeout\n\nAs requisições têm timeout de 10 segundos.\n\n---\n\n## 🐛 Troubleshooting\n\n### \"Dispositivo não encontrado\"\n\n- Verifique o nome exato do dispositivo (ex: \"Samsung Galaxy A15\" em vez de \"Samsung A15\")\n- Tente buscar por marca com `getDevicesByBrand()`\n- Use `getBestDevices()` para ver dispositivos disponíveis\n\n### \"Erro ao buscar AnTuTu\"\n\n- Verifique sua conexão com a internet\n- O site do AnTuTu pode estar indisponível temporariamente\n- Tente novamente em alguns minutos\n\n### Resultados inconsistentes\n\n- O cache expira a cada 1 hora\n- Os dados do AnTuTu são atualizados mensalmente\n- Resultados podem variar com base na versão do AnTuTu\n\n---\n\n## 📈 Performance\n\n- **Primeira requisição**: ~2-3 segundos (busca no AnTuTu)\n- **Requisições em cache**: ~10ms (cache local)\n- **Cache TTL**: 1 hora\n\n---\n\n## 🤝 Contribuindo\n\nContribuições são bem-vindas! Por favor:\n\n1. Fork o repositório\n2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)\n3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)\n4. Push para a branch (`git push origin feature/AmazingFeature`)\n5. Abra um Pull Request\n\n---\n\n## 📝 Licença\n\nEste projeto está licenciado sob a Licença MIT — veja o arquivo [LICENSE](LICENSE) para detalhes.\n\n---\n\n## 🙏 Agradecimentos\n\n- [AnTuTu](https://www.antutu.com/) pelos dados de performance\n- [Mobileverso](https://mobileverso.com.br/) pela inspiração\n- Comunidade Free Fire por feedback e testes\n\n---\n\n## 📞 Suporte\n\n- 📧 Email: boruto_vk7@gmail.com\n- 🐛 Issues: [GitHub Issues](https://github.com/Boruto_vk7/gerador-sensi/issues)\n- 💬 Discussões: [GitHub Discussions](https://github.com/Boruto_vk7/gerador-sensi/discussions)\n\n---\n\n## 🔗 Links Úteis\n\n- [Documentação do AnTuTu](https://www.antutu.com/)\n- [Guia de Sensibilidade Free Fire](https://mobileverso.com.br/freefire/dpi-para-free-fire)\n- [Comunidade Free Fire](https://www.reddit.com/r/FreeFire/)\n\n---\n\n**Desenvolvido com ❤️ para a comunidade Free Fire**\n\nv1.0.0 • MIT License • 2026\n","readmeFilename":"README.md","_rev":"1-865ac8fcc1f4e8dc8ade75db4e93cf97"}