@fiado/type-kit 3.422.0 → 3.423.0

package/bin/identity/dtos/PeopleResponse.d.ts

@@ -17,11 +17,39 @@ export declare class PeopleResponse {
     indexName: string | null;
     /**
      * Nombre a imprimir en la tarjeta, derivado de usNames y usLastNames por el
-     * lambda de identidad: MAYUSCULAS sin acentos y maximo 21 caracteres, que es
-     * el limite de name_on_card en Central Payments. Solo de lectura para los
-     * consumidores; se recalcula solo en cada guardado de la persona.
+     * lambda de identidad: MAYUSCULAS y maximo 21 caracteres, que es el limite de
+     * name_on_card en Central Payments.
+     *
+     * Los diacriticos SI se conservan: si el apellido es Peña, viaja Peña. El
+     * conector manda los nombres al proveedor sin plegarlos, asi que plegarlos
+     * aqui alejaria el valor esperado de lo que el proveedor recibio.
+     *
+     * Solo de lectura para los consumidores. Se recalcula en cada guardado que
+     * traiga los DOS nombres de origen; un guardado parcial no lo toca, para no
+     * pisar un valor bueno con uno calculado a medias.
      */
     usName21: string | null;
+    /**
+     * El mismo nombre de usName21, partido en dos, porque es asi como viaja al
+     * proveedor: usName21First va a first_name y usName21Second a last_name, y de
+     * esos dos campos el proveedor DERIVA el nombre que imprime. No hay otro camino
+     * para cambiar lo impreso.
+     *
+     * El corte cae en la frontera entre usNames y usLastNames, NO en una posicion
+     * fija: MARIA CARMEN CRUZ queda como "MARIA CARMEN" y "CRUZ". Ninguna parte
+     * empieza ni termina con espacio, y ninguna parte una palabra al medio salvo
+     * cuando el apellido por si solo ya no cabe en 21.
+     *
+     * Invariante: con las dos partes presentes, usName21First + " " + usName21Second
+     * es exactamente usName21 — el espacio del borde se consume como separador, que
+     * es el mismo que el proveedor intercala al imprimir. De ahi que las dos partes
+     * sumen como maximo 20, no 21. Si una viene vacia, la otra es usName21 completo.
+     *
+     * Son ADITIVOS: usName21 se sigue guardando completo, asi que quien ya lo lee no
+     * necesita cambiar nada.
+     */
+    usName21First: string | null;
+    usName21Second: string | null;
     preferredName: string | null;
     usSuffix: string | null;
     usLastNames: string | null;

package/package.json

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

package/src/identity/dtos/PeopleResponse.ts

@@ -20,11 +20,39 @@ export class PeopleResponse {
     indexName: string | null;
     /**
      * Nombre a imprimir en la tarjeta, derivado de usNames y usLastNames por el
-     * lambda de identidad: MAYUSCULAS sin acentos y maximo 21 caracteres, que es
-     * el limite de name_on_card en Central Payments. Solo de lectura para los
-     * consumidores; se recalcula solo en cada guardado de la persona.
+     * lambda de identidad: MAYUSCULAS y maximo 21 caracteres, que es el limite de
+     * name_on_card en Central Payments.
+     *
+     * Los diacriticos SI se conservan: si el apellido es Peña, viaja Peña. El
+     * conector manda los nombres al proveedor sin plegarlos, asi que plegarlos
+     * aqui alejaria el valor esperado de lo que el proveedor recibio.
+     *
+     * Solo de lectura para los consumidores. Se recalcula en cada guardado que
+     * traiga los DOS nombres de origen; un guardado parcial no lo toca, para no
+     * pisar un valor bueno con uno calculado a medias.
      */
     usName21: string | null;
+    /**
+     * El mismo nombre de usName21, partido en dos, porque es asi como viaja al
+     * proveedor: usName21First va a first_name y usName21Second a last_name, y de
+     * esos dos campos el proveedor DERIVA el nombre que imprime. No hay otro camino
+     * para cambiar lo impreso.
+     *
+     * El corte cae en la frontera entre usNames y usLastNames, NO en una posicion
+     * fija: MARIA CARMEN CRUZ queda como "MARIA CARMEN" y "CRUZ". Ninguna parte
+     * empieza ni termina con espacio, y ninguna parte una palabra al medio salvo
+     * cuando el apellido por si solo ya no cabe en 21.
+     *
+     * Invariante: con las dos partes presentes, usName21First + " " + usName21Second
+     * es exactamente usName21 — el espacio del borde se consume como separador, que
+     * es el mismo que el proveedor intercala al imprimir. De ahi que las dos partes
+     * sumen como maximo 20, no 21. Si una viene vacia, la otra es usName21 completo.
+     *
+     * Son ADITIVOS: usName21 se sigue guardando completo, asi que quien ya lo lee no
+     * necesita cambiar nada.
+     */
+    usName21First: string | null;
+    usName21Second: string | null;
     preferredName: string | null;
     usSuffix: string | null;
     usLastNames: string | null;