@fiado/type-kit 3.227.0 → 3.229.0

package/_test_/unit/identity/PeopleSelfieResponse.test.ts

@@ -0,0 +1,57 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { PeopleSelfieResponse } from '../../../src/identity/index';
+
+describe('PeopleSelfieResponse', () => {
+  const valid = {
+    directoryId: 'dir-1',
+    url: 'https://s3.amazonaws.com/bucket/USER/dir-1/ver-1_MEX_ppl_SELFIE.png?X-Amz-Expires=900',
+    key: 'ver-1_MEX_ppl_SELFIE.png',
+    expiresInSeconds: 900,
+  };
+
+  it('acepta una respuesta de selfie completa', async () => {
+    const dto = plainToInstance(PeopleSelfieResponse, valid, { excludeExtraneousValues: true });
+    const errors = await validate(dto as object);
+
+    expect(errors).toHaveLength(0);
+    expect(dto.directoryId).toBe('dir-1');
+    expect(dto.key).toBe('ver-1_MEX_ppl_SELFIE.png');
+    expect(dto.url).toContain('SELFIE.png');
+    expect(dto.expiresInSeconds).toBe(900);
+  });
+
+  it.each(['directoryId', 'url', 'key'])('rechaza %s vacío', async (campo) => {
+    const dto = plainToInstance(
+      PeopleSelfieResponse,
+      { ...valid, [campo]: '' },
+      { excludeExtraneousValues: true },
+    );
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain(campo);
+  });
+
+  it('rechaza expiresInSeconds no entero', async () => {
+    const dto = plainToInstance(
+      PeopleSelfieResponse,
+      { ...valid, expiresInSeconds: 12.5 },
+      { excludeExtraneousValues: true },
+    );
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain('expiresInSeconds');
+  });
+
+  it('rechaza expiresInSeconds no positivo', async () => {
+    const dto = plainToInstance(
+      PeopleSelfieResponse,
+      { ...valid, expiresInSeconds: 0 },
+      { excludeExtraneousValues: true },
+    );
+    const errors = await validate(dto as object);
+
+    expect(errors.map((e) => e.property)).toContain('expiresInSeconds');
+  });
+});

package/bin/account/dtos/AccountCreateRequest.d.ts

@@ -17,7 +17,13 @@ export declare class AccountCreateRequest {
     usNames: string;
     usLastNames: string;
     phoneNumber: string;
-    address: AddressResponse;
+    /**
+     * Opcional: la apertura MX en LEVEL_1 puede correr sin dirección. Cuando falta, el
+     * emisor debe OMITIR la clave (dejarla undefined, que JSON.stringify elimina del body),
+     * nunca mandarla en `null`: account-fiadosa-business valida contra type-kit v1, donde
+     * `address` lleva @ValidateNested() sin @IsOptional(), y `null` produce un 400.
+     */
+    address?: AddressResponse;
     email: string;
     dob: string;
     isHost?: boolean;

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

@@ -69,6 +69,8 @@ export declare class PeopleResponse {
         MEX_Beneficiaries: boolean;
         MEX_DebitAccount: boolean;
         MEX_DebitAccountWish: boolean;
+        /** true = el step de emisión FIADOSA/Pomelo terminó (cuenta + tarjeta virtual). */
+        MEX_VirtualCard: boolean;
         MEX_FacematchVerified: boolean | null;
         MEX_ProofAddress: boolean;
         MEX_TemplateMatch: boolean;

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

@@ -1,29 +1,16 @@
-import { SelfieSourceEnum } from '../enums/SelfieSourceEnum';
 /**
- * `GET /identities/private/people/{directoryId}/selfie` — la selfie guardada del usuario.
+ * Respuesta del endpoint privado que devuelve la selfie del KYC de un usuario:
+ * el URL presignado de S3 (es el `userPhotoLink` del facematch) + su vigencia.
  *
- * Devuelve una URL firmada temporal, no la imagen. Pensada para alimentar el `userPhotoLink` del
- * facematch de Metamap: se pasa a `buildFacematchSignature` del metamap-connector para obtener el
- * `userPhotoLinkHash`, y el par va en el `metadata` de la verificación con `customInput: true`.
- *
- * Solo responde a usuarios con cuenta (`MEX_DebitAccount` o `USA_DebitAccount`); si no, el endpoint
- * devuelve 401 con code `NO_ACCOUNT`. Si el usuario tiene cuenta pero no hay imagen de selfie,
- * devuelve code `SELFIE_NOT_FOUND`. fiado-identity-lambda.
+ * Versión SIMPLIFICADA (sin `source` / `verificationId` / `lastModified`): el consumidor
+ * solo necesita el URL para el facematch y el nombre del archivo para trazabilidad.
  */
 export declare class PeopleSelfieResponse {
     directoryId: string;
+    /** URL presignado de S3 de la foto de cara (el `userPhotoLink` del facematch). */
+    url: string;
     /** Nombre del archivo en S3, sin el prefijo `USER/{directoryId}/`. */
     key: string;
-    /** Presigned de S3. Es el valor a usar como `userPhotoLink`. */
-    url: string;
-    /**
-     * Vigencia del presigned. La emite fiado-s3-lambda y hoy es 3600; el facematch tiene que
-     * dispararse dentro de esa ventana o Metamap no podrá descargar la foto.
-     */
+    /** Vigencia del presigned URL en segundos. */
     expiresInSeconds: number;
-    /** Verificación de Metamap a la que pertenece la selfie. `null` si no se pudo determinar. */
-    verificationId: string | null;
-    /** Fecha ISO de última modificación del objeto en S3. `null` si S3 no la reportó. */
-    lastModified: string | null;
-    source: SelfieSourceEnum;
 }

package/bin/identity/dtos/PeopleSelfieResponse.js

@@ -1,17 +1,48 @@
 "use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PeopleSelfieResponse = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
 /**
- * `GET /identities/private/people/{directoryId}/selfie` — la selfie guardada del usuario.
+ * Respuesta del endpoint privado que devuelve la selfie del KYC de un usuario:
+ * el URL presignado de S3 (es el `userPhotoLink` del facematch) + su vigencia.
  *
- * Devuelve una URL firmada temporal, no la imagen. Pensada para alimentar el `userPhotoLink` del
- * facematch de Metamap: se pasa a `buildFacematchSignature` del metamap-connector para obtener el
- * `userPhotoLinkHash`, y el par va en el `metadata` de la verificación con `customInput: true`.
- *
- * Solo responde a usuarios con cuenta (`MEX_DebitAccount` o `USA_DebitAccount`); si no, el endpoint
- * devuelve 401 con code `NO_ACCOUNT`. Si el usuario tiene cuenta pero no hay imagen de selfie,
- * devuelve code `SELFIE_NOT_FOUND`. fiado-identity-lambda.
+ * Versión SIMPLIFICADA (sin `source` / `verificationId` / `lastModified`): el consumidor
+ * solo necesita el URL para el facematch y el nombre del archivo para trazabilidad.
  */
 class PeopleSelfieResponse {
 }
 exports.PeopleSelfieResponse = PeopleSelfieResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PeopleSelfieResponse.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PeopleSelfieResponse.prototype, "url", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PeopleSelfieResponse.prototype, "key", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], PeopleSelfieResponse.prototype, "expiresInSeconds", void 0);

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

@@ -38,6 +38,8 @@ export declare class PeopleUpdateRequest {
     tenantId?: string | null;
     USA_DebitAccount?: boolean;
     MEX_DebitAccount?: boolean;
+    /** true = el step de emisión FIADOSA/Pomelo terminó (cuenta + tarjeta virtual). */
+    MEX_VirtualCard?: boolean;
     MEX_CreditClient?: boolean;
     MEX_CreditAdditional?: boolean;
     magicNumber?: boolean;

package/bin/identity/index.d.ts

@@ -10,6 +10,7 @@ export * from './dtos/UploadDocumentFile';
 export * from './dtos/PeopleSelfVerifiedRequest';
 export * from './dtos/AgentDocumentKeyResponse';
 export * from './dtos/DocumentUploadResponse';
+export * from './dtos/PeopleSelfieResponse';
 export * from './enums/IdentificationDocumentStatus';
 export * from './enums/SexDocument';
 export * from './enums/InfoSelfVerifiedStatus';

package/bin/identity/index.js

@@ -27,6 +27,7 @@ __exportStar(require("./dtos/UploadDocumentFile"), exports);
 __exportStar(require("./dtos/PeopleSelfVerifiedRequest"), exports);
 __exportStar(require("./dtos/AgentDocumentKeyResponse"), exports);
 __exportStar(require("./dtos/DocumentUploadResponse"), exports);
+__exportStar(require("./dtos/PeopleSelfieResponse"), exports);
 //enums
 __exportStar(require("./enums/IdentificationDocumentStatus"), exports);
 __exportStar(require("./enums/SexDocument"), exports);

package/package.json

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

package/src/account/dtos/AccountCreateRequest.ts

@@ -61,10 +61,16 @@ export class AccountCreateRequest {
     @IsPhoneNumberFiado()
     phoneNumber: string;
 
+    /**
+     * Opcional: la apertura MX en LEVEL_1 puede correr sin dirección. Cuando falta, el
+     * emisor debe OMITIR la clave (dejarla undefined, que JSON.stringify elimina del body),
+     * nunca mandarla en `null`: account-fiadosa-business valida contra type-kit v1, donde
+     * `address` lleva @ValidateNested() sin @IsOptional(), y `null` produce un 400.
+     */
     @IsOptional()
     @ValidateNested()
     @Type(() => AddressResponse)
-    address: AddressResponse;
+    address?: AddressResponse;
 
     @IsEmail()
     email: string;

package/src/identity/dtos/PeopleResponse.ts

@@ -72,6 +72,8 @@ export class PeopleResponse {
         MEX_Beneficiaries:boolean;
         MEX_DebitAccount:boolean;
         MEX_DebitAccountWish:boolean;
+        /** true = el step de emisión FIADOSA/Pomelo terminó (cuenta + tarjeta virtual). */
+        MEX_VirtualCard:boolean;
         MEX_FacematchVerified:boolean| null;
         MEX_ProofAddress:boolean;
         MEX_TemplateMatch:boolean;

package/src/identity/dtos/PeopleSelfieResponse.ts

@@ -0,0 +1,26 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsPositive, IsString } from 'class-validator';
+
+/**
+ * Respuesta del endpoint privado que devuelve la selfie del KYC de un usuario:
+ * el URL presignado de S3 (es el `userPhotoLink` del facematch) + su vigencia.
+ *
+ * Versión SIMPLIFICADA (sin `source` / `verificationId` / `lastModified`): el consumidor
+ * solo necesita el URL para el facematch y el nombre del archivo para trazabilidad.
+ */
+export class PeopleSelfieResponse {
+    @Expose() @IsString() @IsNotEmpty()
+    directoryId!: string;
+
+    /** URL presignado de S3 de la foto de cara (el `userPhotoLink` del facematch). */
+    @Expose() @IsString() @IsNotEmpty()
+    url!: string;
+
+    /** Nombre del archivo en S3, sin el prefijo `USER/{directoryId}/`. */
+    @Expose() @IsString() @IsNotEmpty()
+    key!: string;
+
+    /** Vigencia del presigned URL en segundos. */
+    @Expose() @IsInt() @IsPositive()
+    expiresInSeconds!: number;
+}

package/src/identity/dtos/PeopleUpdateRequest.ts

@@ -43,6 +43,8 @@ export class PeopleUpdateRequest {
     tenantId?: string | null;
     USA_DebitAccount?: boolean;
     MEX_DebitAccount?: boolean;
+    /** true = el step de emisión FIADOSA/Pomelo terminó (cuenta + tarjeta virtual). */
+    MEX_VirtualCard?: boolean;
     MEX_CreditClient?: boolean;
     MEX_CreditAdditional?: boolean;
     magicNumber?: boolean;

package/src/identity/index.ts

@@ -12,6 +12,7 @@ export * from './dtos/UploadDocumentFile';
 export * from './dtos/PeopleSelfVerifiedRequest';
 export * from './dtos/AgentDocumentKeyResponse';
 export * from './dtos/DocumentUploadResponse';
+export * from './dtos/PeopleSelfieResponse';
 
 
 //enums