@fiado/type-kit 3.232.0 → 3.233.0

package/bin/kyc/dtos/responses/KycPersonData.d.ts

@@ -9,12 +9,24 @@ export declare class KycPersonData {
     curp?: string;
     dateOfBirth?: string;
     /**
-     * Vigencia del documento de identidad (el `expirationDate` que el OCR lee del INE). Aditivo y
-     * opcional: un mensaje viejo sin el campo sigue validando, y un INE cuyo OCR no la resolvió viaja
+     * Vigencia del documento de identidad (el `expirationDate` que lee el OCR). Aditivo y opcional:
+     * un mensaje viejo sin el campo sigue validando, y un documento cuyo OCR no la resolvió viaja
      * sin ella.
      *
-     * Se usa para mostrarle al vendedor con qué documento se verificó al cliente ("INE vigente, vence
-     * 2033"). NO es un gate: quién decide si la identidad es válida es el proveedor, no esta fecha.
+     * Se usa para mostrarle al vendedor con qué documento se verificó al cliente. NO es un gate:
+     * quién decide si la identidad es válida es el proveedor, no esta fecha.
      */
     documentExpiresAt?: string;
+    /**
+     * Tipo de documento con el que se verificó (`national-id`, `passport`, … — el catálogo del
+     * proveedor, sin traducir).
+     *
+     * 🔴 **Sin esto no se puede nombrar el documento sin adivinar.** La vigencia viajaba sola, así que
+     * el consumidor solo podía escribir "INE" a mano — y el flujo acepta más de un tipo. Con un
+     * pasaporte en la mano, el vendedor leía en pantalla un documento que el cliente no traía.
+     *
+     * Aditivo y opcional: los mensajes que no lo traigan siguen validando, y el consumidor debe poder
+     * mostrar el resumen sin él (mejor no nombrar el documento que nombrar el equivocado).
+     */
+    documentType?: string;
 }

package/bin/kyc/dtos/responses/KycPersonData.js

@@ -55,3 +55,9 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], KycPersonData.prototype, "documentExpiresAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycPersonData.prototype, "documentType", void 0);

package/bin/retailCustomer/dtos/RetailCustomer.d.ts

@@ -31,6 +31,8 @@ export declare class RetailCustomer {
     birthDate?: string;
     /** Vigencia del documento con el que se verificó la identidad (OCR del INE). Informativo. */
     documentExpiresAt?: string;
+    /** Tipo de documento con el que se verificó (`national-id`, `passport`, …). Informativo. */
+    documentType?: string;
     fiadoDirectoryId: string | null;
     fiadoPeopleId: string | null;
     pcfAccountId: string | null;

package/bin/retailCustomer/dtos/RetailCustomer.js

@@ -101,6 +101,12 @@ __decorate([
     (0, class_validator_1.Matches)(regex_1.regexIso8601Date, { message: 'documentExpiresAt debe ser una fecha ISO 8601' }),
     __metadata("design:type", String)
 ], RetailCustomer.prototype, "documentExpiresAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailCustomer.prototype, "documentType", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.d.ts

@@ -23,6 +23,12 @@ export declare class UpsertCustomerFromKycRequest {
      * NO es un gate de nada: quién valida la identidad es el proveedor de KYC.
      */
     documentExpiresAt?: string;
+    /**
+     * Tipo de documento con el que se verificó (`national-id`, `passport`, … — catálogo crudo del
+     * proveedor). Acompaña a la vigencia: sin él, la pantalla no puede nombrar el documento y termina
+     * asumiendo INE, aunque el flujo acepte otros. Informativo, NO es un gate.
+     */
+    documentType?: string;
     rfc?: string;
     email?: string;
     /** Score de confianza que devuelve Metamap junto con el resultado del KYC (F1 §3.5). */

package/bin/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.js

@@ -73,6 +73,12 @@ __decorate([
     (0, class_validator_1.Matches)(regex_1.regexIso8601Date, { message: 'documentExpiresAt debe ser una fecha ISO 8601' }),
     __metadata("design:type", String)
 ], UpsertCustomerFromKycRequest.prototype, "documentExpiresAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "documentType", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/retailCustomer/dtos/responses/CustomerResponse.d.ts

@@ -24,8 +24,14 @@ export interface CustomerResponse {
     rfc: string | null;
     email: string | null;
     birthDate: string | null;
-    /** Vigencia del documento de identidad con el que se verificó al cliente (OCR del INE). */
+    /** Vigencia del documento de identidad con el que se verificó al cliente (la lee el OCR). */
     documentExpiresAt: string | null;
+    /**
+     * Tipo de documento con el que se verificó (`national-id`, `passport`, … — catálogo crudo del
+     * proveedor). Sin él, el consumidor no puede nombrar el documento y termina asumiendo INE,
+     * aunque el flujo acepte otros.
+     */
+    documentType: string | null;
     fiadoDirectoryId: string | null;
     fiadoPeopleId: string | null;
     pcfAccountId: string | null;

package/package.json

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

package/src/kyc/dtos/responses/KycPersonData.ts

@@ -22,13 +22,27 @@ export class KycPersonData {
     dateOfBirth?: string;
 
     /**
-     * Vigencia del documento de identidad (el `expirationDate` que el OCR lee del INE). Aditivo y
-     * opcional: un mensaje viejo sin el campo sigue validando, y un INE cuyo OCR no la resolvió viaja
+     * Vigencia del documento de identidad (el `expirationDate` que lee el OCR). Aditivo y opcional:
+     * un mensaje viejo sin el campo sigue validando, y un documento cuyo OCR no la resolvió viaja
      * sin ella.
      *
-     * Se usa para mostrarle al vendedor con qué documento se verificó al cliente ("INE vigente, vence
-     * 2033"). NO es un gate: quién decide si la identidad es válida es el proveedor, no esta fecha.
+     * Se usa para mostrarle al vendedor con qué documento se verificó al cliente. NO es un gate:
+     * quién decide si la identidad es válida es el proveedor, no esta fecha.
      */
     @Expose() @IsOptional() @IsString()
     documentExpiresAt?: string;
+
+    /**
+     * Tipo de documento con el que se verificó (`national-id`, `passport`, … — el catálogo del
+     * proveedor, sin traducir).
+     *
+     * 🔴 **Sin esto no se puede nombrar el documento sin adivinar.** La vigencia viajaba sola, así que
+     * el consumidor solo podía escribir "INE" a mano — y el flujo acepta más de un tipo. Con un
+     * pasaporte en la mano, el vendedor leía en pantalla un documento que el cliente no traía.
+     *
+     * Aditivo y opcional: los mensajes que no lo traigan siguen validando, y el consumidor debe poder
+     * mostrar el resumen sin él (mejor no nombrar el documento que nombrar el equivocado).
+     */
+    @Expose() @IsOptional() @IsString()
+    documentType?: string;
 }

package/src/retailCustomer/dtos/RetailCustomer.ts

@@ -92,6 +92,10 @@ export class RetailCustomer {
     @Matches(regexIso8601Date, { message: 'documentExpiresAt debe ser una fecha ISO 8601' })
     documentExpiresAt?: string;
 
+    /** Tipo de documento con el que se verificó (`national-id`, `passport`, …). Informativo. */
+    @Expose() @IsOptional() @IsString()
+    documentType?: string;
+
     @Expose()
     @IsOptional()
     @IsString()

package/src/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.ts

@@ -74,6 +74,14 @@ export class UpsertCustomerFromKycRequest {
     @Matches(regexIso8601Date, { message: 'documentExpiresAt debe ser una fecha ISO 8601' })
     documentExpiresAt?: string;
 
+    /**
+     * Tipo de documento con el que se verificó (`national-id`, `passport`, … — catálogo crudo del
+     * proveedor). Acompaña a la vigencia: sin él, la pantalla no puede nombrar el documento y termina
+     * asumiendo INE, aunque el flujo acepte otros. Informativo, NO es un gate.
+     */
+    @Expose() @IsOptional() @IsString()
+    documentType?: string;
+
     @Expose()
     @IsOptional()
     @IsString()

package/src/retailCustomer/dtos/responses/CustomerResponse.ts

@@ -25,8 +25,14 @@ export interface CustomerResponse {
     rfc: string | null;
     email: string | null;
     birthDate: string | null;
-    /** Vigencia del documento de identidad con el que se verificó al cliente (OCR del INE). */
+    /** Vigencia del documento de identidad con el que se verificó al cliente (la lee el OCR). */
     documentExpiresAt: string | null;
+    /**
+     * Tipo de documento con el que se verificó (`national-id`, `passport`, … — catálogo crudo del
+     * proveedor). Sin él, el consumidor no puede nombrar el documento y termina asumiendo INE,
+     * aunque el flujo acepte otros.
+     */
+    documentType: string | null;
     fiadoDirectoryId: string | null;
     fiadoPeopleId: string | null;
     pcfAccountId: string | null;