@fiado/type-kit 3.39.0 → 3.40.0

package/src/remittance/dtos/RemittanceListBeneficiariesResponse.ts

@@ -1,7 +1,7 @@
-import { RemittanceBeneficiary } from "./RemittanceBeneficiary";
-
-export class RemittanceListBeneficiariesResponse {
-    beneficiaries!: RemittanceBeneficiary[];
-    totalActive!: number;
-    maxActive!: number;
-}
+import { RemittanceBeneficiary } from "./RemittanceBeneficiary";
+
+export class RemittanceListBeneficiariesResponse {
+    beneficiaries!: RemittanceBeneficiary[];
+    totalActive!: number;
+    maxActive!: number;
+}

package/src/remittance/dtos/RemittanceOnboardRequest.ts

@@ -1,64 +1,64 @@
-import { IsEmail, IsEnum, IsIn, IsNotEmpty, IsOptional, IsString, Matches, ValidateNested } from "class-validator";
-import { Type } from "class-transformer";
-import { RemittanceAddress } from "./RemittanceAddress";
-import { RemittanceCountryISO } from "../enums/RemittanceCountryISO";
-
-/**
- * Request que el composer en benefits-marketplace envía al connector vía
- * IUnitellerConnectorApi.onboard(). Bajo DP-05 NO incluye questionId/answer/answerHint
- * (el connector los autogenera internamente).
- */
-export class RemittanceOnboardRequest {
-    @IsString()
-    @IsNotEmpty()
-    directoryId!: string;
-
-    @IsEmail()
-    email!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    firstName!: string;
-
-    @IsOptional()
-    @IsString()
-    middleName?: string;
-
-    @IsString()
-    @IsNotEmpty()
-    lastName!: string;
-
-    @IsOptional()
-    @IsString()
-    secondLastName?: string;
-
-    @IsOptional()
-    @IsString()
-    gender?: string;
-
-    @IsString()
-    @Matches(/^\d{8}$/, { message: "birthDate must be MMDDYYYY (8 digits)" })
-    birthDate!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    cellPhone!: string;
-
-    @ValidateNested()
-    @Type(() => RemittanceAddress)
-    address!: RemittanceAddress;
-
-    @IsEnum(RemittanceCountryISO)
-    destinationCountryISOCode!: RemittanceCountryISO;
-
-    @IsOptional()
-    @IsIn(["EN", "ES"])
-    agreementLocale?: "EN" | "ES";
-
-    @IsIn(["YES"])
-    privacyPolicyAgreement!: "YES";
-
-    @IsOptional()
-    @IsString()
-    userIPAddress?: string;
-}
+import { IsEmail, IsEnum, IsIn, IsNotEmpty, IsOptional, IsString, Matches, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+import { RemittanceAddress } from "./RemittanceAddress";
+import { RemittanceCountryISO } from "../enums/RemittanceCountryISO";
+
+/**
+ * Request que el composer en benefits-marketplace envía al connector vía
+ * IUnitellerConnectorApi.onboard(). Bajo DP-05 NO incluye questionId/answer/answerHint
+ * (el connector los autogenera internamente).
+ */
+export class RemittanceOnboardRequest {
+    @IsString()
+    @IsNotEmpty()
+    directoryId!: string;
+
+    @IsEmail()
+    email!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    firstName!: string;
+
+    @IsOptional()
+    @IsString()
+    middleName?: string;
+
+    @IsString()
+    @IsNotEmpty()
+    lastName!: string;
+
+    @IsOptional()
+    @IsString()
+    secondLastName?: string;
+
+    @IsOptional()
+    @IsString()
+    gender?: string;
+
+    @IsString()
+    @Matches(/^\d{8}$/, { message: "birthDate must be MMDDYYYY (8 digits)" })
+    birthDate!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    cellPhone!: string;
+
+    @ValidateNested()
+    @Type(() => RemittanceAddress)
+    address!: RemittanceAddress;
+
+    @IsEnum(RemittanceCountryISO)
+    destinationCountryISOCode!: RemittanceCountryISO;
+
+    @IsOptional()
+    @IsIn(["EN", "ES"])
+    agreementLocale?: "EN" | "ES";
+
+    @IsIn(["YES"])
+    privacyPolicyAgreement!: "YES";
+
+    @IsOptional()
+    @IsString()
+    userIPAddress?: string;
+}

package/src/remittance/dtos/RemittanceOnboardResponse.ts

@@ -1,7 +1,7 @@
-import { RemittanceUserState } from "../enums/RemittanceUserState";
-
-export class RemittanceOnboardResponse {
-    state!: RemittanceUserState;
-    unirUserId!: string;
-    activatedAt?: string;
-}
+import { RemittanceUserState } from "../enums/RemittanceUserState";
+
+export class RemittanceOnboardResponse {
+    state!: RemittanceUserState;
+    unirUserId!: string;
+    activatedAt?: string;
+}

package/src/remittance/dtos/RemittancePayerAdditionalFieldDto.ts

@@ -1,27 +1,27 @@
-/**
- * Campo adicional requerido por un payer/receptionMethod, devuelto por el
- * endpoint público `GET /remittance/payers/{code}/fields?...`.
- *
- * El frontend renderiza un control según `fieldType` y valida con `regex` /
- * `minLen`/`maxLen` antes de submit. El valor capturado se envía al backend
- * como `additionalFieldInfo: [{ name, value }, ...]` en la request de
- * AddBeneficiary o SendMoneyPreview.
- *
- * Ejemplo real (Banco Industrial GTQ Account Credit): 1 field `accountType`
- * dropdown con opciones { key:"01", value:"Checking" }, { key:"02", value:"Savings" }.
- */
-export interface RemittancePayerAdditionalFieldDto {
-    fieldName: string;
-    fieldLabel: string;
-    /** "dropdown" | "text" | "number" | etc. — UI elige control según este valor. */
-    fieldType: string;
-    required: boolean;
-    /** Solo si `fieldType === "dropdown"`. */
-    fieldOptions?: Array<{ key: string; value: string }>;
-    regex?: string;
-    minLen?: number;
-    maxLen?: number;
-    errorMsg?: string;
-    /** Mensaje informativo (no de error) que la UI puede mostrar como helper text. */
-    fieldMsg?: string;
-}
+/**
+ * Campo adicional requerido por un payer/receptionMethod, devuelto por el
+ * endpoint público `GET /remittance/payers/{code}/fields?...`.
+ *
+ * El frontend renderiza un control según `fieldType` y valida con `regex` /
+ * `minLen`/`maxLen` antes de submit. El valor capturado se envía al backend
+ * como `additionalFieldInfo: [{ name, value }, ...]` en la request de
+ * AddBeneficiary o SendMoneyPreview.
+ *
+ * Ejemplo real (Banco Industrial GTQ Account Credit): 1 field `accountType`
+ * dropdown con opciones { key:"01", value:"Checking" }, { key:"02", value:"Savings" }.
+ */
+export interface RemittancePayerAdditionalFieldDto {
+    fieldName: string;
+    fieldLabel: string;
+    /** "dropdown" | "text" | "number" | etc. — UI elige control según este valor. */
+    fieldType: string;
+    required: boolean;
+    /** Solo si `fieldType === "dropdown"`. */
+    fieldOptions?: Array<{ key: string; value: string }>;
+    regex?: string;
+    minLen?: number;
+    maxLen?: number;
+    errorMsg?: string;
+    /** Mensaje informativo (no de error) que la UI puede mostrar como helper text. */
+    fieldMsg?: string;
+}

package/src/remittance/dtos/RemittancePayerBranchDto.ts

@@ -1,29 +1,29 @@
-/**
- * Sucursal de un payer (para método Cash Pickup), devuelta por el endpoint
- * público `GET /remittance/payers/{code}/branches?...`.
- *
- * El frontend la consume en el flow de "Enviar dinero" cuando el beneficiario
- * tiene `receptionMethod === "CASH_PICKUP"` y el payer marca `requiresBranch = true`.
- *
- * Nota de tamaño: un payer puede tener cientos de sucursales (ej. Gyt Continental
- * GT ~300). Diseñar el UI con un buscador local sobre `name`/`address.city`.
- */
-export interface RemittancePayerBranchDto {
-    branchCode: string;
-    name: string;
-    /** Horario de atención en formato libre (ej. "0900AM-0500PM"). */
-    branchHours?: string;
-    phoneNumber?: string;
-    address?: RemittancePayerBranchAddressDto;
-}
-
-export interface RemittancePayerBranchAddressDto {
-    address1?: string;
-    city?: string;
-    /** Código ISO 3166-2 (ej. "GT-GU"). */
-    state?: string;
-    stateName?: string;
-    country?: string;
-    countryISOCode?: string;
-    zipCode?: string;
-}
+/**
+ * Sucursal de un payer (para método Cash Pickup), devuelta por el endpoint
+ * público `GET /remittance/payers/{code}/branches?...`.
+ *
+ * El frontend la consume en el flow de "Enviar dinero" cuando el beneficiario
+ * tiene `receptionMethod === "CASH_PICKUP"` y el payer marca `requiresBranch = true`.
+ *
+ * Nota de tamaño: un payer puede tener cientos de sucursales (ej. Gyt Continental
+ * GT ~300). Diseñar el UI con un buscador local sobre `name`/`address.city`.
+ */
+export interface RemittancePayerBranchDto {
+    branchCode: string;
+    name: string;
+    /** Horario de atención en formato libre (ej. "0900AM-0500PM"). */
+    branchHours?: string;
+    phoneNumber?: string;
+    address?: RemittancePayerBranchAddressDto;
+}
+
+export interface RemittancePayerBranchAddressDto {
+    address1?: string;
+    city?: string;
+    /** Código ISO 3166-2 (ej. "GT-GU"). */
+    state?: string;
+    stateName?: string;
+    country?: string;
+    countryISOCode?: string;
+    zipCode?: string;
+}

package/src/remittance/dtos/RemittancePayerDto.ts

@@ -1,35 +1,35 @@
-import { ReceptionMethod } from "../enums/ReceptionMethod";
-
-/**
- * Payer disponible para un país+currency, devuelto por el endpoint público
- * `GET /remittance/countries/{iso}/payers?currencyISO=XXX`.
- *
- * Lo consume el frontend en Pantalla 9 (Método + Payer) del wizard de agregar
- * beneficiario. Provee toda la metadata necesaria para que la app:
- *  1. Muestre los métodos de recepción soportados por el payer.
- *  2. Decida si el wizard debe mostrar el paso de "selección de sucursal"
- *     (`requiresBranch === true`) o el de "campos adicionales"
- *     (`requiresAdditionalFields === true`).
- *  3. Valide el `accNumber` del lado del cliente con `accNumberRegex` antes
- *     de hacer submit (mejor UX que esperar 400 del backend).
- */
-export interface RemittancePayerDto {
-    /** Código UNIR del payer (ej. "GCA10" Banrural). Usado como `payerCode` en AddBeneficiary. */
-    payerCode: string;
-    /** Nombre legible (ej. "Banrural", "B. Industrial"). */
-    name: string;
-    /** Métodos de recepción soportados por este payer en este país+currency. */
-    receptionMethods: ReceptionMethod[];
-    /** Si true, hay que llamar a `/remittance/payers/{code}/branches` cuando el usuario elige Cash Pickup. */
-    requiresBranch: boolean;
-    /** Si true, hay que llamar a `/remittance/payers/{code}/fields` para conocer campos extra requeridos. */
-    requiresAdditionalFields: boolean;
-    /** Regex de validación del `accNumber` (solo si `receptionMethod` = ACCOUNT_CREDIT). */
-    accNumberRegex?: string;
-    /** Mensaje legible para mostrar al usuario cuando el `accNumber` no pasa el regex. */
-    accNumberHelperText?: string;
-    /** URL absoluta del logo del payer (puede no venir). */
-    logoUrl?: string;
-    /** Orden de aparición sugerido por UNIR (asc). */
-    sortOrder?: number;
-}
+import { ReceptionMethod } from "../enums/ReceptionMethod";
+
+/**
+ * Payer disponible para un país+currency, devuelto por el endpoint público
+ * `GET /remittance/countries/{iso}/payers?currencyISO=XXX`.
+ *
+ * Lo consume el frontend en Pantalla 9 (Método + Payer) del wizard de agregar
+ * beneficiario. Provee toda la metadata necesaria para que la app:
+ *  1. Muestre los métodos de recepción soportados por el payer.
+ *  2. Decida si el wizard debe mostrar el paso de "selección de sucursal"
+ *     (`requiresBranch === true`) o el de "campos adicionales"
+ *     (`requiresAdditionalFields === true`).
+ *  3. Valide el `accNumber` del lado del cliente con `accNumberRegex` antes
+ *     de hacer submit (mejor UX que esperar 400 del backend).
+ */
+export interface RemittancePayerDto {
+    /** Código UNIR del payer (ej. "GCA10" Banrural). Usado como `payerCode` en AddBeneficiary. */
+    payerCode: string;
+    /** Nombre legible (ej. "Banrural", "B. Industrial"). */
+    name: string;
+    /** Métodos de recepción soportados por este payer en este país+currency. */
+    receptionMethods: ReceptionMethod[];
+    /** Si true, hay que llamar a `/remittance/payers/{code}/branches` cuando el usuario elige Cash Pickup. */
+    requiresBranch: boolean;
+    /** Si true, hay que llamar a `/remittance/payers/{code}/fields` para conocer campos extra requeridos. */
+    requiresAdditionalFields: boolean;
+    /** Regex de validación del `accNumber` (solo si `receptionMethod` = ACCOUNT_CREDIT). */
+    accNumberRegex?: string;
+    /** Mensaje legible para mostrar al usuario cuando el `accNumber` no pasa el regex. */
+    accNumberHelperText?: string;
+    /** URL absoluta del logo del payer (puede no venir). */
+    logoUrl?: string;
+    /** Orden de aparición sugerido por UNIR (asc). */
+    sortOrder?: number;
+}

package/src/remittance/dtos/RemittanceQuoteRequest.ts

@@ -1,33 +1,33 @@
-import { IsEnum, IsIn, IsNotEmpty, IsNumber, IsString, Min } from "class-validator";
-import { ReceptionMethod } from "../enums/ReceptionMethod";
-import { RemittanceCountryISO } from "../enums/RemittanceCountryISO";
-
-/**
- * Quote en tiempo real (debounce mientras el usuario escribe).
- * Bajo modelo API Lite (D23-D26) NO incluye fundingMethodType — la fuente es
- * siempre el wallet USD del usuario; el connector mapea a sendingMethodName="Wlp Wallet"
- * internamente.
- */
-export class RemittanceQuoteRequest {
-    @IsEnum(RemittanceCountryISO)
-    destCountry!: RemittanceCountryISO;
-
-    @IsString()
-    @IsNotEmpty()
-    destCurrencyISO!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    payerCode!: string;
-
-    @IsEnum(ReceptionMethod)
-    receptionMethod!: ReceptionMethod;
-
-    @IsNumber({ maxDecimalPlaces: 2 })
-    @Min(1)
-    amount!: number;
-
-    /** "USD" si amount está en origen; ISO destino si está en moneda destino. */
-    @IsIn(["USD", "GTQ", "HNL", "MXN", "NIO"])
-    amountCurrency!: string;
-}
+import { IsEnum, IsIn, IsNotEmpty, IsNumber, IsString, Min } from "class-validator";
+import { ReceptionMethod } from "../enums/ReceptionMethod";
+import { RemittanceCountryISO } from "../enums/RemittanceCountryISO";
+
+/**
+ * Quote en tiempo real (debounce mientras el usuario escribe).
+ * Bajo modelo API Lite (D23-D26) NO incluye fundingMethodType — la fuente es
+ * siempre el wallet USD del usuario; el connector mapea a sendingMethodName="Wlp Wallet"
+ * internamente.
+ */
+export class RemittanceQuoteRequest {
+    @IsEnum(RemittanceCountryISO)
+    destCountry!: RemittanceCountryISO;
+
+    @IsString()
+    @IsNotEmpty()
+    destCurrencyISO!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    payerCode!: string;
+
+    @IsEnum(ReceptionMethod)
+    receptionMethod!: ReceptionMethod;
+
+    @IsNumber({ maxDecimalPlaces: 2 })
+    @Min(1)
+    amount!: number;
+
+    /** "USD" si amount está en origen; ISO destino si está en moneda destino. */
+    @IsIn(["USD", "GTQ", "HNL", "MXN", "NIO"])
+    amountCurrency!: string;
+}

package/src/remittance/dtos/RemittanceQuoteResponse.ts

@@ -1,11 +1,11 @@
-export class RemittanceQuoteResponse {
-    exchangeRate!: number;
-    serviceFee!: number;
-    stateFee!: number;
-    receivedAmount!: number;
-    totalAmount!: number;
-    /** UUID interno (no de UNIR). Solo para tracking en logs, no se reusa en Preview. */
-    quoteId!: string;
-    /** Epoch ms. Sugerencia: re-cotizar tras `expiresAt`. */
-    expiresAt!: number;
-}
+export class RemittanceQuoteResponse {
+    exchangeRate!: number;
+    serviceFee!: number;
+    stateFee!: number;
+    receivedAmount!: number;
+    totalAmount!: number;
+    /** UUID interno (no de UNIR). Solo para tracking en logs, no se reusa en Preview. */
+    quoteId!: string;
+    /** Epoch ms. Sugerencia: re-cotizar tras `expiresAt`. */
+    expiresAt!: number;
+}

package/src/remittance/dtos/RemittanceSecurityQuestionsResponse.ts

@@ -1,14 +1,14 @@
-/**
- * Lista de preguntas de seguridad disponibles para SignUp en UNIR.
- * Endpoint expuesto por compliance — bajo DP-05 el mobile NO consume este endpoint
- * (el connector autogenera la pregunta de seguridad). Mantener por si UNIR cambia
- * el modelo o si compliance requiere mostrarlas en el futuro.
- */
-export class SecurityQuestion {
-    questionId!: number;
-    question!: string;
-}
-
-export class RemittanceSecurityQuestionsResponse {
-    questions!: SecurityQuestion[];
-}
+/**
+ * Lista de preguntas de seguridad disponibles para SignUp en UNIR.
+ * Endpoint expuesto por compliance — bajo DP-05 el mobile NO consume este endpoint
+ * (el connector autogenera la pregunta de seguridad). Mantener por si UNIR cambia
+ * el modelo o si compliance requiere mostrarlas en el futuro.
+ */
+export class SecurityQuestion {
+    questionId!: number;
+    question!: string;
+}
+
+export class RemittanceSecurityQuestionsResponse {
+    questions!: SecurityQuestion[];
+}

package/src/remittance/dtos/RemittanceSendPreviewRequest.ts

@@ -1,18 +1,18 @@
-import { IsIn, IsNotEmpty, IsNumber, IsString, Min } from "class-validator";
-
-/**
- * Preview formal antes del confirm. Bajo API Lite no incluye fundingMethod —
- * el connector usa unirWlpWalletId de RemittanceUsers_GT (capturado en F2).
- */
-export class RemittanceSendPreviewRequest {
-    @IsString()
-    @IsNotEmpty()
-    beneficiaryId!: string;
-
-    @IsNumber({ maxDecimalPlaces: 2 })
-    @Min(1)
-    amount!: number;
-
-    @IsIn(["USD", "GTQ", "HNL", "MXN", "NIO"])
-    amountCurrency!: string;
-}
+import { IsIn, IsNotEmpty, IsNumber, IsString, Min } from "class-validator";
+
+/**
+ * Preview formal antes del confirm. Bajo API Lite no incluye fundingMethod —
+ * el connector usa unirWlpWalletId de RemittanceUsers_GT (capturado en F2).
+ */
+export class RemittanceSendPreviewRequest {
+    @IsString()
+    @IsNotEmpty()
+    beneficiaryId!: string;
+
+    @IsNumber({ maxDecimalPlaces: 2 })
+    @Min(1)
+    amount!: number;
+
+    @IsIn(["USD", "GTQ", "HNL", "MXN", "NIO"])
+    amountCurrency!: string;
+}

package/src/remittance/dtos/RemittanceSendPreviewResponse.ts

@@ -1,19 +1,19 @@
-export interface RemittanceBeneficiaryDisplay {
-    name: string;
-    bank?: string;
-    lastFour?: string;
-}
-
-export class RemittanceSendPreviewResponse {
-    /** transactionInternalReference de UNIR — requerido para el confirm en F6. */
-    previewRef!: string;
-    exchangeRate!: number;
-    serviceFee!: number;
-    stateFee!: number;
-    totalAmount!: number;
-    receivedAmount!: number;
-    receivedCurrency!: string;
-    beneficiaryDisplay!: RemittanceBeneficiaryDisplay;
-    /** Epoch ms. Cache 10 min en RemittanceCache_GT (D-F5.4). */
-    expiresAt!: number;
-}
+export interface RemittanceBeneficiaryDisplay {
+    name: string;
+    bank?: string;
+    lastFour?: string;
+}
+
+export class RemittanceSendPreviewResponse {
+    /** transactionInternalReference de UNIR — requerido para el confirm en F6. */
+    previewRef!: string;
+    exchangeRate!: number;
+    serviceFee!: number;
+    stateFee!: number;
+    totalAmount!: number;
+    receivedAmount!: number;
+    receivedCurrency!: string;
+    beneficiaryDisplay!: RemittanceBeneficiaryDisplay;
+    /** Epoch ms. Cache 10 min en RemittanceCache_GT (D-F5.4). */
+    expiresAt!: number;
+}

package/src/remittance/dtos/RemittanceStateDto.ts

@@ -1,11 +1,11 @@
-/**
- * Estado / departamento del país destino de una remesa.
- * Devuelto por el endpoint público `GET /remittance/countries/{iso}/states`.
- *
- * `stateISO` viene en formato ISO 3166-2 (ej. "GT-GU" Guatemala, "SV-SS" San Salvador,
- * "HN-AT" Atlántida, "NI-MN" Managua).
- */
-export interface RemittanceStateDto {
-    stateISO: string;
-    name: string;
-}
+/**
+ * Estado / departamento del país destino de una remesa.
+ * Devuelto por el endpoint público `GET /remittance/countries/{iso}/states`.
+ *
+ * `stateISO` viene en formato ISO 3166-2 (ej. "GT-GU" Guatemala, "SV-SS" San Salvador,
+ * "HN-AT" Atlántida, "NI-MN" Managua).
+ */
+export interface RemittanceStateDto {
+    stateISO: string;
+    name: string;
+}

package/src/remittance/dtos/RemittanceTransaction.ts

@@ -1,15 +1,15 @@
-import { RemittanceTxStatus } from "../enums/RemittanceTxStatus";
-
-/**
- * Transaction shape cross-lambda. Stub mínimo para F2 (referenciado por
- * RemittanceHomeResponse.recentTransactions). F7 lo extiende con el detalle
- * completo (montos, fees, fechas, receipt, etc.).
- */
-export class RemittanceTransaction {
-    txNumber!: string;
-    beneficiaryName!: string;
-    amountUSD!: number;
-    status!: RemittanceTxStatus;
-    createdAt!: string;
-    destCountryISO?: string;
-}
+import { RemittanceTxStatus } from "../enums/RemittanceTxStatus";
+
+/**
+ * Transaction shape cross-lambda. Stub mínimo para F2 (referenciado por
+ * RemittanceHomeResponse.recentTransactions). F7 lo extiende con el detalle
+ * completo (montos, fees, fechas, receipt, etc.).
+ */
+export class RemittanceTransaction {
+    txNumber!: string;
+    beneficiaryName!: string;
+    amountUSD!: number;
+    status!: RemittanceTxStatus;
+    createdAt!: string;
+    destCountryISO?: string;
+}

package/src/remittance/dtos/RemittanceUpdateBeneficiaryRequest.ts

@@ -1,24 +1,24 @@
-import { IsOptional, IsString, Matches, ValidateNested } from "class-validator";
-import { Type } from "class-transformer";
-import { RemittanceBeneficiaryAddressDTO } from "./RemittanceAddBeneficiaryRequest";
-
-/**
- * UNIR EditBeneficiary permite cambiar campos limitados: nickName, phone, address.
- * NO permite cambiar firstName/lastName/payer/currency.
- * Reflejamos esa restricción aquí — los campos no editables NO aparecen en la request.
- */
-export class RemittanceUpdateBeneficiaryRequest {
-    @IsOptional()
-    @IsString()
-    @Matches(/^\d{7,15}$/, { message: "phone must be 7-15 digits, no country code" })
-    phone?: string;
-
-    @IsOptional()
-    @ValidateNested()
-    @Type(() => RemittanceBeneficiaryAddressDTO)
-    address?: RemittanceBeneficiaryAddressDTO;
-
-    @IsOptional()
-    @IsString()
-    payerBranchCode?: string;
-}
+import { IsOptional, IsString, Matches, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+import { RemittanceBeneficiaryAddressDTO } from "./RemittanceAddBeneficiaryRequest";
+
+/**
+ * UNIR EditBeneficiary permite cambiar campos limitados: nickName, phone, address.
+ * NO permite cambiar firstName/lastName/payer/currency.
+ * Reflejamos esa restricción aquí — los campos no editables NO aparecen en la request.
+ */
+export class RemittanceUpdateBeneficiaryRequest {
+    @IsOptional()
+    @IsString()
+    @Matches(/^\d{7,15}$/, { message: "phone must be 7-15 digits, no country code" })
+    phone?: string;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => RemittanceBeneficiaryAddressDTO)
+    address?: RemittanceBeneficiaryAddressDTO;
+
+    @IsOptional()
+    @IsString()
+    payerBranchCode?: string;
+}