Integrando a SmartCPF em runtime Bun: guia rápido

// smartcpf.ts — Consulta CPF na SmartCPF v2 usando Bun nativo
// Rode: bun run smartcpf.ts

interface SmartCPFResponse {
  meta: {
    searchType: string;
    consultId: string;
    user: string;
    message: string;
    ip: string;
    success: boolean;
    apiVersion: string;
    date: string;
    executionTimeMs: number;
    balance: number;
  };
  result: {
    cpf: string;
    name: string;
    birthDate: string;
    age: number;
    motherName: string;
    gender: string;
    status: string;
    emails: string[];
    phones: Array<{
      number: string;
      blockedTelemarketing: boolean;
      operator: string;
      type: string;
      whatsapp: boolean;
    }>;
    addresses: Array<{
      zipCode: string;
      street: string;
      number: string;
      complement: string;
      neighborhood: string;
      city: string;
      state: string;
    }>;
  };
  success: boolean;
  errors: Array<{ code: string; message: string }>;
}

interface ConsultaCPFResultado {
  ok: boolean;
  consultId?: string;
  balance?: number;
  cpf?: string;
  name?: string;
  status?: string;
  emails?: string[];
  phones?: string[];
  error?: string;
}

const API_BASE = 'https://api.smartcpf.com.br/v2/individuals';

function limparCPF(cpf: string): string {
  return cpf.replace(/\D/g, '');
}

function validarCPF(cpf: string): boolean {
  const numeros = limparCPF(cpf);
  if (numeros.length !== 11 || /^(\d)\1+$/.test(numeros)) return false;
  let soma = 0;
  for (let i = 0; i < 9; i++) soma += parseInt(numeros[i]) * (10 - i);
  let digito = 11 - (soma % 11);
  if (digito > 9) digito = 0;
  if (digito !== parseInt(numeros[9])) return false;
  soma = 0;
  for (let i = 0; i < 10; i++) soma += parseInt(numeros[i]) * (11 - i);
  digito = 11 - (soma % 11);
  if (digito > 9) digito = 0;
  return digito === parseInt(numeros[10]);
}

async function consultarCPF(cpf: string, apiKey: string, pkg = 'X'): Promise<ConsultaCPFResultado> {
  const cpfLimpo = limparCPF(cpf);
  if (!validarCPF(cpfLimpo)) {
    return { ok: false, error: 'CPF inválido (formato ou dígitos verificadores)' };
  }

  const url = `${API_BASE}/${cpfLimpo}?package=${pkg}`;

  try {
    const response = await fetch(url, {
      method: 'GET',
      headers: {
        'X-API-KEY': apiKey,
        'Accept': 'application/json',
        'User-Agent': 'smartcpf-bun-example/1.0',
      },
    });

    const data: SmartCPFResponse = await response.json();

    if (!response.ok) {
      const msg = data.errors?.[0]?.message || `HTTP ${response.status}`;
      return { ok: false, error: msg };
    }

    if (!data.success) {
      const msg = data.errors?.[0]?.message || 'Erro desconhecido na resposta';
      return { ok: false, error: msg };
    }

    return {
      ok: true,
      consultId: data.meta.consultId,
      balance: data.meta.balance,
      cpf: data.result.cpf,
      name: data.result.name,
      status: data.result.status,
      emails: data.result.emails,
      phones: data.result.phones.map(p => p.number),
    };
  } catch (err) {
    const message = err instanceof Error ? err.message : 'Erro de rede/desconhecido';
    return { ok: false, error: `Falha na requisição: ${message}` };
  }
}

// Exemplo de uso
async function main() {
  const apiKey = process.env.SMARTCPF_API_KEY;
  if (!apiKey) {
    console.error('Defina SMARTCPF_API_KEY no ambiente (.env ou variável de sistema)');
    process.exit(1);
  }

  const cpfTeste = '111.111.111-11'; // CPF de exemplo — substitua pelo real
  const resultado = await consultarCPF(cpfTeste, apiKey);

  if (resultado.ok) {
    console.log('✅ Consulta bem-sucedida');
    console.log(`   ConsultId: ${resultado.consultId}`);
    console.log(`   Saldo restante: ${resultado.balance}`);
    console.log(`   CPF: ${resultado.cpf}`);
    console.log(`   Nome: ${resultado.name}`);
    console.log(`   Status: ${resultado.status}`);
    console.log(`   E-mails: ${resultado.emails?.join(', ') || '—'}`);
    console.log(`   Telefones: ${resultado.phones?.join(', ') || '—'}`);
  } else {
    console.error('❌ Falha:', resultado.error);
  }
}

main();

{
  "meta": {
    "searchType": "CPF G",
    "consultId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "user": "Fulano de Tal",
    "message": "CPF encontrado com sucesso",
    "ip": "127.0.0.1",
    "success": true,
    "apiVersion": "v2",
    "date": "2026-08-17T14:32:10.123Z",
    "executionTimeMs": 74.1,
    "balance": 9.77
  },
  "result": {
    "cpf": "111.111.111-11",
    "name": "João da Silva",
    "birthDate": "10/09/1992",
    "age": 33,
    "motherName": "Maria da Silva",
    "gender": "M",
    "status": "Regular",
    "emails": ["[email protected]"],
    "phones": [
      {
        "number": "(55) 99999-9999",
        "blockedTelemarketing": false,
        "operator": "VIVO",
        "type": "CELULAR",
        "whatsapp": false
      }
    ],
    "addresses": []
  },
  "success": true,
  "errors": []
}