rut-kit

Funciones core para validar, formatear y trabajar con RUTs chilenos. Sin dependencias.

Instalación

npm

npm install rut-kit

pnpm

pnpm add rut-kit

bun

bun add rut-kit

Importación

Importa solo las funciones que necesites:

import { isValidRut, validateRut, formatRut } from "rut-kit"

O todas las funciones disponibles:

import {
  isValidRut,
  validateRut,
  formatRut,
  cleanRut,
  getRutCheckDigit,
  getErrorMessage
} from "rut-kit"

isValidRut()

Retorna true si el RUT es válido, false si no. Útil para validaciones simples donde no necesitas saber el tipo de error.

isValidRut("18.972.631-7")  // true
isValidRut("18972631-7")    // true
isValidRut("189726317")     // true

isValidRut("18.972.631-0")  // false (dígito verificador incorrecto)
isValidRut("18.abc.631-7")  // false (formato inválido)
isValidRut("18,972,631-7")  // false (comas no permitidas)

Validación Estricta

Solo acepta formatos válidos chilenos: 18.972.631-7, 18972631-7, 189726317. Otros separadores son rechazados.

RUT mínimo: Solo acepta RUTs desde 1.000.000 (7 dígitos + verificador).

validateRut()

Valida un RUT y retorna información detallada. Si es válido, incluye el RUT limpio. Si es inválido, indica el tipo de error.

validateRut("18.972.631-7")
// { valid: true, rut: "189726317" }

validateRut("18.972.631-0")
// { valid: false, error: "invalidCheckDigit" }

validateRut("18,972,631-7")
// { valid: false, error: "invalidFormat" }

validateRut("123")
// { valid: false, error: "invalidFormat" }

Tipos de error:

Error	Cuándo ocurre
invalidFormat	Formato no válido, largo incorrecto, o caracteres no permitidos
invalidCheckDigit	Dígito verificador no coincide

Tip: Si necesitas validar RUTs con separadores no estándar (comas, asteriscos), usa cleanRut() primero.

formatRut()

Convierte un RUT al formato especificado. Útil para normalizar RUTs antes de guardar o mostrar.

formatRut("189726317")              // "18972631-7" (default)
formatRut("189726317", "formatted") // "18.972.631-7"
formatRut("189726317", "clean")     // "189726317"

El formato default (sin puntos, con guión) es recomendado para almacenamiento.

cleanRut()

Remueve cualquier carácter no alfanumérico de un RUT. La K se convierte a mayúscula. También elimina ceros iniciales.

cleanRut("18.972.631-7")  // "189726317"
cleanRut("18972631-7")    // "189726317"
cleanRut("33.333.335-k")  // "33333335K"

// Acepta separadores no estándar
cleanRut("18,972,631-7")  // "189726317"
cleanRut("18*972*631*7")  // "189726317"

Permisivo: A diferencia de la validación, cleanRut() acepta cualquier separador. Útil para limpiar datos de Excel, copiar-pegar, etc.

getRutCheckDigit()

Calcula el dígito verificador para un número de RUT (sin el dígito). Útil para generar RUTs válidos en tests.

getRutCheckDigit("18972631")  // "7"
getRutCheckDigit("33333335")  // "K"

getErrorMessage()

Convierte un tipo de error a un mensaje legible. Los mensajes por defecto están en español.

const result = validateRut("18.972.631-0")

if (!result.valid) {
  getErrorMessage(result.error)
  // "Dígito verificador incorrecto"
}

Puedes personalizar los mensajes. Solo incluye los que quieras cambiar:

getErrorMessage(result.error, {
  invalidCheckDigit: "El RUT ingresado no es válido"
})

Mensajes por defecto:

Error	Mensaje
invalidFormat	"Formato de RUT inválido"
invalidCheckDigit	"Dígito verificador incorrecto"