@datoteca/cl

Generador de datos de prueba realistas y culturalmente correctos para Chile — determinístico por seed. Parte del proyecto Datoteca.

RUT con dígito verificador matemáticamente válido, comunas reales (SUBDERE), dinero formateado en es-CL — pensado para dominios donde el formato importa, como fintech y banca. Complementa a librerías generalistas como Faker, no las reemplaza: Datoteca se enfoca en el detalle específico de cada país.

Instalación

npm install @datoteca/cl

@datoteca/core (PRNG y helpers compartidos) se instala automáticamente como dependencia — no hace falta agregarlo a mano.

Uso

Instancia Datoteca con una seed. Sin estado global: la misma seed, en el mismo orden de llamadas, siempre produce el mismo resultado.

import { Datoteca } from '@datoteca/cl';

const dl = new Datoteca({ seed: 123 });

dl.rut(); // "12345678-9"
dl.persona.nombreCompleto(); // "María González Soto"
dl.direccion.direccionCompleta(); // "Los Aromos 482, Providencia"
dl.telefono.movil(); // "+56 9 1234 5678"
dl.dinero.clp(); // "$45.000"

RUT con distintas opciones de formato:

dl.rut(); // "12345678-9"    (format: 'dash', default)
dl.rut({ format: 'dots' }); // "12.345.678-9"
dl.rut({ format: 'raw' }); // "123456789"
dl.rut({ dv: false }); // "12345678"     (sin dígito verificador)

rut() en la raíz genera persona natural. Para distinguir explícitamente entre persona natural y empresa (el SII asigna RUT de personas jurídicas desde el 50.000.000):

dl.persona.rut(); // "12345678-9"    (rango persona natural: 1.000.000-25.000.000)
dl.empresa.rut(); // "76543210-K"    (rango empresa: 50.000.000-99.999.999)

Dígito verificador de forma independiente (método estático, no requiere seed) y dinero con rango personalizado:

Datoteca.calcularDV(12345678); // "5"

dl.dinero.clp({ min: 10_000, max: 200_000 });
dl.dinero.uf(); // "UF 1.234,56"

dl.dinero.clpNumero(); // 45000       (number, sin formatear)
dl.dinero.ufNumero(); // 1234.56     (number, hasta 2 decimales)

Namespaces

| Namespace | Métodos | | --- | --- | | raíz | rut(options?) (persona natural), Datoteca.calcularDV(numero) | | persona | rut(options?), nombre(), apellido(), nombreCompleto() | | direccion | comuna(), calle(), direccionCompleta() | | telefono | movil(), fijo() | | dinero | clp(options?), uf(options?), clpNumero(options?), ufNumero(options?) | | banco | nombre(), cuenta() | | empresa | rut(options?), razonSocial(), giro() |

Documentación completa, roadmap y guía de contribución en el repo principal.

Licencia

MIT — ver LICENSE.