@linktic/validator 1.0.0

package/README.md

@@ -0,0 +1,177 @@
+# @linktic/validator
+
+Libreria de validacion TypeScript con API fluida, zero dependencias y mensajes en espanol configurables.
+
+## Instalacion
+
+```bash
+# pnpm
+pnpm add @linktic/validator
+
+# npm
+npm install @linktic/validator
+
+# yarn
+yarn add @linktic/validator
+```
+
+## Uso basico
+
+```typescript
+import { validate, ValidationError } from '@linktic/validator'
+
+const data = { name: '', email: 'bad', age: 15 }
+const v = validate(data)
+
+v.field('name', 'Nombre').required().string()
+v.field('email', 'Correo').required().email()
+v.field('age', 'Edad').required().number().min(18)
+
+// Opcion A: lanzar error
+try {
+  v.validate()
+} catch (e) {
+  if (e instanceof ValidationError) {
+    console.log(e.errors) // ValidationFieldError[]
+  }
+}
+
+// Opcion B: inspeccionar resultado
+const result = v.getResult()
+if (!result.isValid) {
+  console.log(result.errors)
+}
+```
+
+## Validacion por schema
+
+```typescript
+const v = validate(data)
+
+v.schema({
+  name: { required: true, type: 'string', label: 'Nombre', minLength: 2, maxLength: 100 },
+  email: { required: true, type: 'email', label: 'Correo' },
+  age: { required: true, type: 'number', label: 'Edad', min: 18, max: 120 },
+  role: { required: true, label: 'Rol', enum: ['admin', 'user', 'viewer'] },
+  notes: { required: false, type: 'string', label: 'Notas', maxLength: 500 },
+})
+
+v.validate()
+```
+
+## Campos anidados
+
+```typescript
+const v = validate({ office: { name: 'HQ', classId: '001' } })
+
+v.field('office.name', 'Nombre oficina').required().string()
+v.field('office.classId', 'Clase de oficina').required().string()
+```
+
+## Validadores personalizados
+
+```typescript
+v.field('username', 'Usuario').custom((value) => {
+  if ((value as string).includes(' ')) return 'No puede contener espacios'
+  return true
+})
+```
+
+## Configuracion de mensajes
+
+Por defecto los mensajes vienen en espanol. Puedes personalizarlos:
+
+### Sobrescribir mensajes especificos
+
+```typescript
+import { configure } from '@linktic/validator'
+
+configure({
+  required: (field) => `${field} is required`,
+  email: () => 'Please enter a valid email',
+})
+```
+
+### Reemplazar todos los mensajes (cambio de idioma)
+
+```typescript
+import { setMessages, spanishMessages } from '@linktic/validator'
+import type { ValidationMessageMap } from '@linktic/validator'
+
+const english: ValidationMessageMap = {
+  required: (field) => `${field} is required. Please fill it in.`,
+  pattern: (field, example) => `${field} format is invalid. Expected: ${example}`,
+  maxLength: (field, max, actual) => `${field} exceeds ${max} characters (${actual} entered).`,
+  minLength: (field, min) => `${field} requires at least ${min} characters.`,
+  range: (field, min, max) => `${field} must be between ${min} and ${max}.`,
+  date: (field) => `${field} is not a valid date.`,
+  allowedChars: (field, allowed) => `${field} contains invalid characters. Only: ${allowed}`,
+  email: () => 'The email entered is not valid',
+  string: (field) => `${field} must be text`,
+  number: (field) => `${field} must be a number`,
+  boolean: (field) => `${field} must be true or false`,
+  array: (field) => `${field} must be a list`,
+  object: (field) => `${field} must be an object`,
+  uuid: (field) => `${field} must be a valid identifier`,
+  enum: (field, values) => `${field} must be one of: ${values.join(', ')}`,
+  custom: (field) => `${field} is not valid`,
+}
+
+setMessages(english)
+```
+
+### Restaurar mensajes por defecto
+
+```typescript
+import { resetMessages } from '@linktic/validator'
+
+resetMessages() // Vuelve a espanol
+```
+
+## API de FieldValidator
+
+| Metodo | Descripcion |
+|--------|-------------|
+| `required(msg?)` | Campo obligatorio |
+| `optional()` | Campo opcional (salta validaciones si esta vacio) |
+| `nullable()` | Alias de `optional()` |
+| `string(msg?)` | Debe ser string |
+| `number(msg?)` | Debe ser number |
+| `boolean(msg?)` | Debe ser boolean |
+| `array(msg?)` | Debe ser array |
+| `object(msg?)` | Debe ser objeto (no array) |
+| `date(msg?)` | Debe ser fecha valida |
+| `email(msg?)` | Debe ser email valido |
+| `uuid(msg?)` | Debe ser UUID valido |
+| `type(type, msg?)` | Validar por tipo (`ValidationType`) |
+| `minLength(min, msg?)` | Longitud minima (string/array) |
+| `maxLength(max, msg?)` | Longitud maxima (string/array) |
+| `min(value, msg?)` | Valor minimo (number) |
+| `max(value, msg?)` | Valor maximo (number) |
+| `range(min, max, msg?)` | Rango numerico |
+| `pattern(regex, example?, msg?)` | Validar contra regex |
+| `enum(values, msg?)` | Debe ser uno de los valores |
+| `allowedChars(chars, msg?)` | Solo caracteres permitidos |
+| `custom(fn, msg?)` | Validador personalizado |
+
+## API de Validator
+
+| Metodo | Descripcion |
+|--------|-------------|
+| `field(name, label?)` | Iniciar validacion de un campo |
+| `schema(config)` | Validar con configuracion de schema |
+| `validate()` | Lanzar `ValidationError` si hay errores |
+| `getResult()` | Obtener `{ isValid, errors }` |
+| `getErrors()` | Obtener array de errores |
+| `isValid()` | `true` si no hay errores |
+| `hasErrors()` | `true` si hay errores |
+| `reset()` | Limpiar errores |
+
+## Opciones
+
+```typescript
+const v = validate(data, {
+  stopOnFirstError: true,  // Detener en el primer error por campo
+  throwOnError: true,      // Lanzar inmediatamente al encontrar error (con stopOnFirstError)
+})
+```

package/dist/chunk-5LU5LI4H.js

@@ -0,0 +1,44 @@
+// src/utils.ts
+function interpolate(template, params) {
+  return template.replace(
+    /\{(\w+)\}/g,
+    (_, key) => String(params[key] ?? "")
+  );
+}
+
+// src/messages/es.ts
+var spanishMessages = {
+  required: (campo) => interpolate(
+    "El campo {campo} es obligatorio. Por favor compl\xE9talo para continuar.",
+    { campo }
+  ),
+  pattern: (campo, ejemplo) => interpolate(
+    "El formato de {campo} no es v\xE1lido. Ejemplo esperado: {ejemplo}",
+    { campo, ejemplo }
+  ),
+  maxLength: (campo, max, actual) => interpolate(
+    "{campo} excede el l\xEDmite de {max} caracteres ({actual} ingresados).",
+    { campo, max, actual }
+  ),
+  minLength: (campo, min) => interpolate("{campo} requiere m\xEDnimo {min} caracteres.", { campo, min }),
+  range: (campo, min, max) => interpolate("{campo} debe estar entre {min} y {max}.", { campo, min, max }),
+  date: (campo) => interpolate(
+    "La fecha en {campo} no es v\xE1lida. Formato esperado: DD/MM/AAAA",
+    { campo }
+  ),
+  allowedChars: (campo, permitidos) => interpolate(
+    "{campo} contiene caracteres no permitidos. Solo se aceptan: {permitidos}",
+    { campo, permitidos }
+  ),
+  email: () => "El correo ingresado no es valido",
+  string: (campo) => `${campo} debe ser texto`,
+  number: (campo) => `${campo} debe ser un n\xFAmero`,
+  boolean: (campo) => `${campo} debe ser verdadero o falso`,
+  array: (campo) => `${campo} debe ser una lista`,
+  object: (campo) => `${campo} debe ser un objeto`,
+  uuid: (campo) => `${campo} debe ser un identificador v\xE1lido`,
+  enum: (campo, valores) => `${campo} debe ser uno de: ${valores.join(", ")}`,
+  custom: (campo) => `${campo} no es v\xE1lido`
+};
+
+export { interpolate, spanishMessages };

package/dist/chunk-GGX2GQQ6.cjs

@@ -0,0 +1,47 @@
+'use strict';
+
+// src/utils.ts
+function interpolate(template, params) {
+  return template.replace(
+    /\{(\w+)\}/g,
+    (_, key) => String(params[key] ?? "")
+  );
+}
+
+// src/messages/es.ts
+var spanishMessages = {
+  required: (campo) => interpolate(
+    "El campo {campo} es obligatorio. Por favor compl\xE9talo para continuar.",
+    { campo }
+  ),
+  pattern: (campo, ejemplo) => interpolate(
+    "El formato de {campo} no es v\xE1lido. Ejemplo esperado: {ejemplo}",
+    { campo, ejemplo }
+  ),
+  maxLength: (campo, max, actual) => interpolate(
+    "{campo} excede el l\xEDmite de {max} caracteres ({actual} ingresados).",
+    { campo, max, actual }
+  ),
+  minLength: (campo, min) => interpolate("{campo} requiere m\xEDnimo {min} caracteres.", { campo, min }),
+  range: (campo, min, max) => interpolate("{campo} debe estar entre {min} y {max}.", { campo, min, max }),
+  date: (campo) => interpolate(
+    "La fecha en {campo} no es v\xE1lida. Formato esperado: DD/MM/AAAA",
+    { campo }
+  ),
+  allowedChars: (campo, permitidos) => interpolate(
+    "{campo} contiene caracteres no permitidos. Solo se aceptan: {permitidos}",
+    { campo, permitidos }
+  ),
+  email: () => "El correo ingresado no es valido",
+  string: (campo) => `${campo} debe ser texto`,
+  number: (campo) => `${campo} debe ser un n\xFAmero`,
+  boolean: (campo) => `${campo} debe ser verdadero o falso`,
+  array: (campo) => `${campo} debe ser una lista`,
+  object: (campo) => `${campo} debe ser un objeto`,
+  uuid: (campo) => `${campo} debe ser un identificador v\xE1lido`,
+  enum: (campo, valores) => `${campo} debe ser uno de: ${valores.join(", ")}`,
+  custom: (campo) => `${campo} no es v\xE1lido`
+};
+
+exports.interpolate = interpolate;
+exports.spanishMessages = spanishMessages;

package/dist/es-QPgrpTLv.d.cts

@@ -0,0 +1,22 @@
+interface ValidationMessageMap {
+    required: (campo: string) => string;
+    pattern: (campo: string, ejemplo: string) => string;
+    maxLength: (campo: string, max: number, actual: number) => string;
+    minLength: (campo: string, min: number) => string;
+    range: (campo: string, min: number, max: number) => string;
+    date: (campo: string) => string;
+    allowedChars: (campo: string, permitidos: string) => string;
+    email: () => string;
+    string: (campo: string) => string;
+    number: (campo: string) => string;
+    boolean: (campo: string) => string;
+    array: (campo: string) => string;
+    object: (campo: string) => string;
+    uuid: (campo: string) => string;
+    enum: (campo: string, valores: unknown[]) => string;
+    custom: (campo: string) => string;
+}
+
+declare const spanishMessages: ValidationMessageMap;
+
+export { type ValidationMessageMap as V, spanishMessages as s };

package/dist/es-QPgrpTLv.d.ts

@@ -0,0 +1,22 @@
+interface ValidationMessageMap {
+    required: (campo: string) => string;
+    pattern: (campo: string, ejemplo: string) => string;
+    maxLength: (campo: string, max: number, actual: number) => string;
+    minLength: (campo: string, min: number) => string;
+    range: (campo: string, min: number, max: number) => string;
+    date: (campo: string) => string;
+    allowedChars: (campo: string, permitidos: string) => string;
+    email: () => string;
+    string: (campo: string) => string;
+    number: (campo: string) => string;
+    boolean: (campo: string) => string;
+    array: (campo: string) => string;
+    object: (campo: string) => string;
+    uuid: (campo: string) => string;
+    enum: (campo: string, valores: unknown[]) => string;
+    custom: (campo: string) => string;
+}
+
+declare const spanishMessages: ValidationMessageMap;
+
+export { type ValidationMessageMap as V, spanishMessages as s };