@fiado/type-kit 3.419.0 → 3.420.0

package/_test_/unit/messagesConnector/IsTemplatePlaceholders.test.ts

@@ -0,0 +1,43 @@
+import { IsTemplatePlaceholders } from '../../../src/messagesConnector/validators/IsTemplatePlaceholders';
+
+const validador = new IsTemplatePlaceholders();
+const acepta = (texto: unknown): boolean => validador.validate(texto);
+
+describe('IsTemplatePlaceholders', () => {
+    describe('acepta las dos formas que el renderizador sustituye', () => {
+        it.each([
+            ['sin placeholders', 'Hola, tu credito esta al corriente'],
+            ['forma simple', 'Hola {cliente_nombre}, tu cuota es {monto}'],
+            ['forma doble', 'Hola {{cliente_nombre}}, tu cuota es {{monto}}'],
+            ['las dos mezcladas', 'Hola {{cliente_nombre}}, vence el {fecha_venc}'],
+            ['nombre con digitos y guion bajo', 'Codigo {var1} y {otra_var2}'],
+            ['cadena vacia', ''],
+        ])('%s', (_caso, texto) => {
+            expect(acepta(texto)).toBe(true);
+        });
+    });
+
+    describe('rechaza lo que el renderizador no podria sustituir', () => {
+        it.each([
+            ['placeholder vacio simple', '{}'],
+            ['placeholder vacio doble', '{{}}'],
+            ['nombre con espacio', '{var name}'],
+            ['nombre con guion', '{var-1}'],
+            ['nombre que arranca con digito', '{1var}'],
+            ['apertura sin cierre', 'abc {def'],
+            ['cierre sin apertura', 'abc } def'],
+            ['llave suelta antes de uno valido', '{ {anidado}'],
+            ['doble sin cerrar del todo', '{{a}'],
+            ['no es string', 42],
+            ['nulo', null],
+        ])('%s', (_caso, texto) => {
+            expect(acepta(texto)).toBe(false);
+        });
+    });
+
+    it('el mensaje nombra las dos formas, para que el front sepa cual usar', () => {
+        const mensaje = validador.defaultMessage({ property: 'template' } as never);
+        expect(mensaje).toContain('{nombre}');
+        expect(mensaje).toContain('{{nombre}}');
+    });
+});

package/bin/messagesConnector/validators/IsTemplatePlaceholders.d.ts

@@ -1,10 +1,11 @@
 import { ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
 /**
- * Valida que un string solo contenga placeholders bien formados `{varName}` donde
- * `varName` matchea `^[a-zA-Z][a-zA-Z0-9_]*$`. Rechaza:
+ * Valida que un string solo contenga placeholders bien formados, en cualquiera de las dos
+ * formas del catalogo: `{varName}` o `{{varName}}`, con `varName` matcheando
+ * `^[a-zA-Z][a-zA-Z0-9_]*$`. Rechaza:
  *  - Placeholders con espacios o caracteres invalidos (`{var name}`, `{var-1}`).
- *  - Llaves sin balancear (`abc {def`, `abc } def`, `{ {nested}` ).
- *  - Placeholders vacios (`{}`).
+ *  - Llaves sin balancear (`abc {def`, `abc } def`, `{ {nested}`).
+ *  - Placeholders vacios (`{}`, `{{}}`).
  * Acepta texto sin placeholders en absoluto.
  *
  * Uso en DTOs: `@Validate(IsTemplatePlaceholders)` sobre un campo string.

package/bin/messagesConnector/validators/IsTemplatePlaceholders.js

@@ -10,11 +10,17 @@ exports.IsTemplatePlaceholders = void 0;
 const class_validator_1 = require("class-validator");
 const VALID_PLACEHOLDER = /^[a-zA-Z][a-zA-Z0-9_]*$/;
 /**
- * Valida que un string solo contenga placeholders bien formados `{varName}` donde
- * `varName` matchea `^[a-zA-Z][a-zA-Z0-9_]*$`. Rechaza:
+ * Las DOS formas que el renderizador sustituye: doble `{{monto}}` y simple `{monto}`.
+ * La doble va primero para que no gane el `{monto}` interno, igual que alla.
+ */
+const PLACEHOLDER_PATTERN = /\{\{([^{}]*)\}\}|\{([^{}]*)\}/g;
+/**
+ * Valida que un string solo contenga placeholders bien formados, en cualquiera de las dos
+ * formas del catalogo: `{varName}` o `{{varName}}`, con `varName` matcheando
+ * `^[a-zA-Z][a-zA-Z0-9_]*$`. Rechaza:
  *  - Placeholders con espacios o caracteres invalidos (`{var name}`, `{var-1}`).
- *  - Llaves sin balancear (`abc {def`, `abc } def`, `{ {nested}` ).
- *  - Placeholders vacios (`{}`).
+ *  - Llaves sin balancear (`abc {def`, `abc } def`, `{ {nested}`).
+ *  - Placeholders vacios (`{}`, `{{}}`).
  * Acepta texto sin placeholders en absoluto.
  *
  * Uso en DTOs: `@Validate(IsTemplatePlaceholders)` sobre un campo string.
@@ -23,33 +29,20 @@ let IsTemplatePlaceholders = class IsTemplatePlaceholders {
     validate(value) {
         if (typeof value !== 'string')
             return false;
-        // Detectar llaves desbalanceadas con un single-pass.
-        let depth = 0;
-        for (const ch of value) {
-            if (ch === '{') {
-                if (depth > 0)
-                    return false; // anidado no permitido
-                depth = 1;
-            }
-            else if (ch === '}') {
-                if (depth === 0)
-                    return false; // cierre sin apertura
-                depth = 0;
-            }
-        }
-        if (depth !== 0)
-            return false; // apertura sin cierre
-        // Validar que cada `{...}` matchea el regex.
-        const matches = value.match(/\{([^}]*)\}/g) ?? [];
-        for (const raw of matches) {
-            const inner = raw.slice(1, -1);
-            if (!VALID_PLACEHOLDER.test(inner))
-                return false;
-        }
-        return true;
+        // Se consumen los placeholders bien formados; lo que sobra no puede tener llaves.
+        let wellFormed = true;
+        const leftover = value.replace(PLACEHOLDER_PATTERN, (_match, doubleName, singleName) => {
+            const name = doubleName ?? singleName ?? '';
+            if (!VALID_PLACEHOLDER.test(name))
+                wellFormed = false;
+            return '';
+        });
+        if (!wellFormed)
+            return false;
+        return !leftover.includes('{') && !leftover.includes('}');
     }
     defaultMessage(args) {
-        return `${args.property} contiene placeholders mal formados; debe seguir el patron {nombre} con nombre = [a-zA-Z][a-zA-Z0-9_]*`;
+        return `${args.property} contiene placeholders mal formados; debe seguir el patron {nombre} o {{nombre}} con nombre = [a-zA-Z][a-zA-Z0-9_]*`;
     }
 };
 exports.IsTemplatePlaceholders = IsTemplatePlaceholders;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.419.0",
+  "version": "3.420.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/messagesConnector/validators/IsTemplatePlaceholders.ts

@@ -3,11 +3,18 @@ import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments
 const VALID_PLACEHOLDER = /^[a-zA-Z][a-zA-Z0-9_]*$/;
 
 /**
- * Valida que un string solo contenga placeholders bien formados `{varName}` donde
- * `varName` matchea `^[a-zA-Z][a-zA-Z0-9_]*$`. Rechaza:
+ * Las DOS formas que el renderizador sustituye: doble `{{monto}}` y simple `{monto}`.
+ * La doble va primero para que no gane el `{monto}` interno, igual que alla.
+ */
+const PLACEHOLDER_PATTERN = /\{\{([^{}]*)\}\}|\{([^{}]*)\}/g;
+
+/**
+ * Valida que un string solo contenga placeholders bien formados, en cualquiera de las dos
+ * formas del catalogo: `{varName}` o `{{varName}}`, con `varName` matcheando
+ * `^[a-zA-Z][a-zA-Z0-9_]*$`. Rechaza:
  *  - Placeholders con espacios o caracteres invalidos (`{var name}`, `{var-1}`).
- *  - Llaves sin balancear (`abc {def`, `abc } def`, `{ {nested}` ).
- *  - Placeholders vacios (`{}`).
+ *  - Llaves sin balancear (`abc {def`, `abc } def`, `{ {nested}`).
+ *  - Placeholders vacios (`{}`, `{{}}`).
  * Acepta texto sin placeholders en absoluto.
  *
  * Uso en DTOs: `@Validate(IsTemplatePlaceholders)` sobre un campo string.
@@ -17,29 +24,19 @@ export class IsTemplatePlaceholders implements ValidatorConstraintInterface {
     validate(value: unknown): boolean {
         if (typeof value !== 'string') return false;
 
-        // Detectar llaves desbalanceadas con un single-pass.
-        let depth = 0;
-        for (const ch of value) {
-            if (ch === '{') {
-                if (depth > 0) return false; // anidado no permitido
-                depth = 1;
-            } else if (ch === '}') {
-                if (depth === 0) return false; // cierre sin apertura
-                depth = 0;
-            }
-        }
-        if (depth !== 0) return false; // apertura sin cierre
+        // Se consumen los placeholders bien formados; lo que sobra no puede tener llaves.
+        let wellFormed = true;
+        const leftover = value.replace(PLACEHOLDER_PATTERN, (_match, doubleName?: string, singleName?: string) => {
+            const name = doubleName ?? singleName ?? '';
+            if (!VALID_PLACEHOLDER.test(name)) wellFormed = false;
+            return '';
+        });
+        if (!wellFormed) return false;
 
-        // Validar que cada `{...}` matchea el regex.
-        const matches = value.match(/\{([^}]*)\}/g) ?? [];
-        for (const raw of matches) {
-            const inner = raw.slice(1, -1);
-            if (!VALID_PLACEHOLDER.test(inner)) return false;
-        }
-        return true;
+        return !leftover.includes('{') && !leftover.includes('}');
     }
 
     defaultMessage(args: ValidationArguments): string {
-        return `${args.property} contiene placeholders mal formados; debe seguir el patron {nombre} con nombre = [a-zA-Z][a-zA-Z0-9_]*`;
+        return `${args.property} contiene placeholders mal formados; debe seguir el patron {nombre} o {{nombre}} con nombre = [a-zA-Z][a-zA-Z0-9_]*`;
     }
 }