@fiado/type-kit 3.176.0 → 3.178.0

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/RemittanceSegment.ts

@@ -1,148 +1,148 @@
-import { Type } from "class-transformer";
-import {
-    IsArray,
-    IsEnum,
-    IsInt,
-    IsOptional,
-    IsString,
-    IsUUID,
-    Length,
-    Min,
-    ValidateNested,
-} from "class-validator";
-import { SegmentMemberType } from "../enums/SegmentMemberType";
-
-/**
- * DTOs de Segmentos (Dashboard Ops · Configuración §2, EP-22..25 + catalog + search).
- *
- * Un segmento es una colección EXPLÍCITA de clientes: referencias a grupos
- * (Group_GT) y tags (UserTags_GT) por id + individuos (override por cliente).
- * Dueño de la tabla: remittance-business (RemittanceSegments_GT).
- *
- * "Clientes" del segmento = intersección con RemittanceUsers_GT (usuarios de
- * remesas que caen en el segmento), NO la membresía Fiado-wide del picker.
- */
-
-/** Referencia de composición: un grupo (Group_GT.id) o un tag (UserTags_GT.tag). */
-export class SegmentMember {
-    @IsEnum(SegmentMemberType)
-    type!: SegmentMemberType;
-
-    /** Group_GT.id (p. ej. "CELULARES") o el tag (p. ej. "VIPS"). */
-    @IsString()
-    @Length(1, 100)
-    id!: string;
-}
-
-/** Individuo agregado explícitamente (la llave es directoryId; peopleId informativo). */
-export class SegmentIndividual {
-    @IsUUID("4")
-    directoryId!: string;
-
-    @IsOptional()
-    @IsUUID("4")
-    peopleId?: string;
-
-    /** Snapshot de display (se pinta sin lookup). */
-    @IsString()
-    @Length(1, 200)
-    name!: string;
-}
-
-/** Body de EP-23 POST /backoffice/config/segments. */
-export class CreateSegmentRequest {
-    @IsString()
-    @Length(3, 100)
-    name!: string;
-
-    @IsArray()
-    @ValidateNested({ each: true })
-    @Type(() => SegmentMember)
-    members!: SegmentMember[];
-
-    @IsArray()
-    @ValidateNested({ each: true })
-    @Type(() => SegmentIndividual)
-    individuals!: SegmentIndividual[];
-
-    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
-    @IsOptional()
-    @IsInt()
-    @Min(0)
-    priority?: number;
-}
-
-/** Body de EP-24 PUT /backoffice/config/segments/{id} (reemplazo completo). */
-export class UpdateSegmentRequest {
-    @IsString()
-    @Length(3, 100)
-    name!: string;
-
-    @IsArray()
-    @ValidateNested({ each: true })
-    @Type(() => SegmentMember)
-    members!: SegmentMember[];
-
-    @IsArray()
-    @ValidateNested({ each: true })
-    @Type(() => SegmentIndividual)
-    individuals!: SegmentIndividual[];
-
-    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
-    @IsOptional()
-    @IsInt()
-    @Min(0)
-    priority?: number;
-}
-
-/** Segmento completo (response). Métricas null = nunca calculadas. */
-export class Segment {
-    id!: string;
-    name!: string;
-    /** true solo en ESTANDAR (catch-all: composición bloqueada, no eliminable). */
-    isDefault!: boolean;
-    members!: SegmentMember[];
-    individuals!: SegmentIndividual[];
-    /** # de RemittanceUsers en el segmento (intersección con remesas). */
-    clientCount!: number | null;
-    /** Σ amountUSD del mes calendario de esos users (sin CANCELLED/REFUND). */
-    volMonthUSD!: number | null;
-    lastCalculatedAt!: string | null;
-    createdAt!: string;
-    updatedAt!: string;
-    createdBy!: string;
-    updatedBy!: string;
-    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
-    priority?: number;
-}
-
-/** Response de EP-22 GET /backoffice/config/segments. */
-export class SegmentListResponse {
-    items!: Segment[];
-}
-
-/** Response de POST /backoffice/config/segments/{id}/recalcular. */
-export class RecalculateSegmentResponse {
-    id!: string;
-    clientCount!: number;
-    volMonthUSD!: number;
-    lastCalculatedAt!: string;
-}
-
-/** Item del picker DISPONIBLES (EP-32 catalog). `count` = membresía Fiado-wide. */
-export class SegmentCatalogItem {
-    type!: SegmentMemberType;
-    id!: string;
-    name!: string;
-    count!: number;
-}
-
-/** Response de GET /backoffice/config/segments/catalog. */
-export class SegmentCatalogResponse {
-    items!: SegmentCatalogItem[];
-}
-
-/** Response de GET /backoffice/config/segments/search-individual?q= (cap 20). */
-export class SearchIndividualResponse {
-    items!: SegmentIndividual[];
-}
+import { Type } from "class-transformer";
+import {
+    IsArray,
+    IsEnum,
+    IsInt,
+    IsOptional,
+    IsString,
+    IsUUID,
+    Length,
+    Min,
+    ValidateNested,
+} from "class-validator";
+import { SegmentMemberType } from "../enums/SegmentMemberType";
+
+/**
+ * DTOs de Segmentos (Dashboard Ops · Configuración §2, EP-22..25 + catalog + search).
+ *
+ * Un segmento es una colección EXPLÍCITA de clientes: referencias a grupos
+ * (Group_GT) y tags (UserTags_GT) por id + individuos (override por cliente).
+ * Dueño de la tabla: remittance-business (RemittanceSegments_GT).
+ *
+ * "Clientes" del segmento = intersección con RemittanceUsers_GT (usuarios de
+ * remesas que caen en el segmento), NO la membresía Fiado-wide del picker.
+ */
+
+/** Referencia de composición: un grupo (Group_GT.id) o un tag (UserTags_GT.tag). */
+export class SegmentMember {
+    @IsEnum(SegmentMemberType)
+    type!: SegmentMemberType;
+
+    /** Group_GT.id (p. ej. "CELULARES") o el tag (p. ej. "VIPS"). */
+    @IsString()
+    @Length(1, 100)
+    id!: string;
+}
+
+/** Individuo agregado explícitamente (la llave es directoryId; peopleId informativo). */
+export class SegmentIndividual {
+    @IsUUID("4")
+    directoryId!: string;
+
+    @IsOptional()
+    @IsUUID("4")
+    peopleId?: string;
+
+    /** Snapshot de display (se pinta sin lookup). */
+    @IsString()
+    @Length(1, 200)
+    name!: string;
+}
+
+/** Body de EP-23 POST /backoffice/config/segments. */
+export class CreateSegmentRequest {
+    @IsString()
+    @Length(3, 100)
+    name!: string;
+
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => SegmentMember)
+    members!: SegmentMember[];
+
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => SegmentIndividual)
+    individuals!: SegmentIndividual[];
+
+    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    priority?: number;
+}
+
+/** Body de EP-24 PUT /backoffice/config/segments/{id} (reemplazo completo). */
+export class UpdateSegmentRequest {
+    @IsString()
+    @Length(3, 100)
+    name!: string;
+
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => SegmentMember)
+    members!: SegmentMember[];
+
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => SegmentIndividual)
+    individuals!: SegmentIndividual[];
+
+    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    priority?: number;
+}
+
+/** Segmento completo (response). Métricas null = nunca calculadas. */
+export class Segment {
+    id!: string;
+    name!: string;
+    /** true solo en ESTANDAR (catch-all: composición bloqueada, no eliminable). */
+    isDefault!: boolean;
+    members!: SegmentMember[];
+    individuals!: SegmentIndividual[];
+    /** # de RemittanceUsers en el segmento (intersección con remesas). */
+    clientCount!: number | null;
+    /** Σ amountUSD del mes calendario de esos users (sin CANCELLED/REFUND). */
+    volMonthUSD!: number | null;
+    lastCalculatedAt!: string | null;
+    createdAt!: string;
+    updatedAt!: string;
+    createdBy!: string;
+    updatedBy!: string;
+    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
+    priority?: number;
+}
+
+/** Response de EP-22 GET /backoffice/config/segments. */
+export class SegmentListResponse {
+    items!: Segment[];
+}
+
+/** Response de POST /backoffice/config/segments/{id}/recalcular. */
+export class RecalculateSegmentResponse {
+    id!: string;
+    clientCount!: number;
+    volMonthUSD!: number;
+    lastCalculatedAt!: string;
+}
+
+/** Item del picker DISPONIBLES (EP-32 catalog). `count` = membresía Fiado-wide. */
+export class SegmentCatalogItem {
+    type!: SegmentMemberType;
+    id!: string;
+    name!: string;
+    count!: number;
+}
+
+/** Response de GET /backoffice/config/segments/catalog. */
+export class SegmentCatalogResponse {
+    items!: SegmentCatalogItem[];
+}
+
+/** Response de GET /backoffice/config/segments/search-individual?q= (cap 20). */
+export class SearchIndividualResponse {
+    items!: SegmentIndividual[];
+}

package/src/remittance/dtos/RemittanceSendPreviewRequest.ts

@@ -1,24 +1,24 @@
-import { IsIn, IsNotEmpty, IsNumber, IsOptional, IsString, Length, 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;
-
-    /** Fase B: código de promo tecleado en la app (habilita SOLO esa promo). Inerte hasta que la app lo mande. */
-    @IsOptional()
-    @IsString()
-    @Length(3, 30)
-    promoCode?: string;
-}
+import { IsIn, IsNotEmpty, IsNumber, IsOptional, IsString, Length, 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;
+
+    /** Fase B: código de promo tecleado en la app (habilita SOLO esa promo). Inerte hasta que la app lo mande. */
+    @IsOptional()
+    @IsString()
+    @Length(3, 30)
+    promoCode?: string;
+}

package/src/remittance/dtos/RemittanceSendPreviewResponse.ts

@@ -1,36 +1,36 @@
-import { RemittanceConfirmRequest } from "./RemittanceConfirmRequest";
-
-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;
-
-    /**
-     * serviceId del corredor resuelto por el connector: `<countryISO>#<payerCode>#<receptionMethodName>`
-     * (ej. `GT#GCA10#Cash Pickup`). Insumo para que benefits codifique el `leafId`.
-     * Lo llena el connector; no es para consumo directo del front.
-     */
-    serviceId?: string;
-    /** productId del corredor (monto libre, ej. `GT#GCA10#VAR`). Lo llena el connector. */
-    productId?: string;
-    /**
-     * Sobre pre-armado por benefits que el front reenvía al procesador para confirmar (F6).
-     * Lo completa benefits (encode del `leafId` + taxonomía del marketplace); el connector
-     * lo deja vacío. Ver {@link RemittanceConfirmRequest}.
-     */
-    confirmRequest?: RemittanceConfirmRequest;
-}
+import { RemittanceConfirmRequest } from "./RemittanceConfirmRequest";
+
+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;
+
+    /**
+     * serviceId del corredor resuelto por el connector: `<countryISO>#<payerCode>#<receptionMethodName>`
+     * (ej. `GT#GCA10#Cash Pickup`). Insumo para que benefits codifique el `leafId`.
+     * Lo llena el connector; no es para consumo directo del front.
+     */
+    serviceId?: string;
+    /** productId del corredor (monto libre, ej. `GT#GCA10#VAR`). Lo llena el connector. */
+    productId?: string;
+    /**
+     * Sobre pre-armado por benefits que el front reenvía al procesador para confirmar (F6).
+     * Lo completa benefits (encode del `leafId` + taxonomía del marketplace); el connector
+     * lo deja vacío. Ver {@link RemittanceConfirmRequest}.
+     */
+    confirmRequest?: RemittanceConfirmRequest;
+}

package/src/remittance/dtos/RemittanceSmsRequest.ts

@@ -1,16 +1,16 @@
-import { IsIn, IsOptional, IsString, Matches } from "class-validator";
-
-/**
- * SMS al beneficiario sobre una tx (F7). Si `phone` no viene, el connector usa
- * el del beneficiario asociado a la tx. Max 3 SMS por tx (rate limit local).
- */
-export class RemittanceSmsRequest {
-    @IsOptional()
-    @IsString()
-    @Matches(/^\+?[0-9]{7,15}$/)
-    phone?: string;
-
-    @IsOptional()
-    @IsIn(["EN", "ES"])
-    locale?: "EN" | "ES";
-}
+import { IsIn, IsOptional, IsString, Matches } from "class-validator";
+
+/**
+ * SMS al beneficiario sobre una tx (F7). Si `phone` no viene, el connector usa
+ * el del beneficiario asociado a la tx. Max 3 SMS por tx (rate limit local).
+ */
+export class RemittanceSmsRequest {
+    @IsOptional()
+    @IsString()
+    @Matches(/^\+?[0-9]{7,15}$/)
+    phone?: string;
+
+    @IsOptional()
+    @IsIn(["EN", "ES"])
+    locale?: "EN" | "ES";
+}

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,26 +1,26 @@
-import { RemittanceTxStatus } from "../enums/RemittanceTxStatus";
-
-/**
- * Transaction shape cross-lambda. Stub mínimo en F2 (referenciado por
- * RemittanceHomeResponse.recentTransactions); extendido en F7 con los campos
- * del historial — todos opcionales para no romper a los consumidores de F2.
- */
-export class RemittanceTransaction {
-    txNumber!: string;
-    beneficiaryName!: string;
-    amountUSD!: number;
-    status!: RemittanceTxStatus;
-    createdAt!: string;
-    destCountryISO?: string;
-    // F7 — historial
-    beneficiaryId?: string;
-    receivedAmount?: number;
-    receivedCurrency?: string;
-    exchangeRate?: number;
-    serviceFee?: number;
-    totalAmount?: number;
-    receptionMethod?: string;
-    payerName?: string;
-    availableDate?: string;
-    updatedAt?: string;
-}
+import { RemittanceTxStatus } from "../enums/RemittanceTxStatus";
+
+/**
+ * Transaction shape cross-lambda. Stub mínimo en F2 (referenciado por
+ * RemittanceHomeResponse.recentTransactions); extendido en F7 con los campos
+ * del historial — todos opcionales para no romper a los consumidores de F2.
+ */
+export class RemittanceTransaction {
+    txNumber!: string;
+    beneficiaryName!: string;
+    amountUSD!: number;
+    status!: RemittanceTxStatus;
+    createdAt!: string;
+    destCountryISO?: string;
+    // F7 — historial
+    beneficiaryId?: string;
+    receivedAmount?: number;
+    receivedCurrency?: string;
+    exchangeRate?: number;
+    serviceFee?: number;
+    totalAmount?: number;
+    receptionMethod?: string;
+    payerName?: string;
+    availableDate?: string;
+    updatedAt?: string;
+}

package/src/remittance/dtos/RemittanceTransactionDetail.ts

@@ -1,23 +1,23 @@
-import { RemittanceTransaction } from "./RemittanceTransaction";
-
-/**
- * Detalle de una tx (F7): snapshot local + freshness de UNIR TransactionDetail.
- * Si UNIR no respondió al momento del GET, los campos unir* vienen ausentes y
- * el status es el último conocido localmente (detail tolerante a fallos UNIR).
- */
-export class RemittanceTransactionDetail extends RemittanceTransaction {
-    /** transactionStatus crudo de UNIR (p.ej. "HOLD", "CANCEL"). */
-    unirStatusRaw?: string;
-    /** txSubStatus de UNIR (p.ej. "HOLD_FOR_REVIEWED,BSA_HOLD"). */
-    unirSubStatus?: string;
-    /** txDisplayStatus de UNIR (p.ej. "IN PROCESS"). */
-    unirDisplayStatus?: string;
-    /** MMDDYYYYHH24MISS de UNIR. */
-    transactionCreateDate?: string;
-    transactionPayableDate?: string;
-    stateFee?: number;
-    payerBranchName?: string;
-    marketplaceTransactionNumber?: string;
-    cancelReason?: string;
-    cancelledAt?: string;
-}
+import { RemittanceTransaction } from "./RemittanceTransaction";
+
+/**
+ * Detalle de una tx (F7): snapshot local + freshness de UNIR TransactionDetail.
+ * Si UNIR no respondió al momento del GET, los campos unir* vienen ausentes y
+ * el status es el último conocido localmente (detail tolerante a fallos UNIR).
+ */
+export class RemittanceTransactionDetail extends RemittanceTransaction {
+    /** transactionStatus crudo de UNIR (p.ej. "HOLD", "CANCEL"). */
+    unirStatusRaw?: string;
+    /** txSubStatus de UNIR (p.ej. "HOLD_FOR_REVIEWED,BSA_HOLD"). */
+    unirSubStatus?: string;
+    /** txDisplayStatus de UNIR (p.ej. "IN PROCESS"). */
+    unirDisplayStatus?: string;
+    /** MMDDYYYYHH24MISS de UNIR. */
+    transactionCreateDate?: string;
+    transactionPayableDate?: string;
+    stateFee?: number;
+    payerBranchName?: string;
+    marketplaceTransactionNumber?: string;
+    cancelReason?: string;
+    cancelledAt?: string;
+}

package/src/remittance/dtos/RemittanceTransactionReceipt.ts

@@ -1,21 +1,21 @@
-/**
- * Recibo de una tx (F7). `htmlReceipt` viene de UNIR TransactionReceipt con
- * projectionType "HTML-APP" (campo UNIR `htmlReciept`, sic). El front lo
- * renderiza en un WebView; los campos estructurados son para el header nativo.
- */
-export class RemittanceTransactionReceipt {
-    txNumber!: string;
-    htmlReceipt?: string;
-    disclaimer?: string;
-    transactionStatus?: string;
-    /** MMDDYYYYHH24MISS de UNIR. */
-    transactionCreateDate?: string;
-    /** MMDDYYYY de UNIR. */
-    transactionPayableDate?: string;
-    transactionAmount?: number;
-    totalTransactionAmount?: number;
-    serviceFee?: number;
-    stateFee?: string;
-    exchangeRate?: number;
-    payingAmount?: number;
-}
+/**
+ * Recibo de una tx (F7). `htmlReceipt` viene de UNIR TransactionReceipt con
+ * projectionType "HTML-APP" (campo UNIR `htmlReciept`, sic). El front lo
+ * renderiza en un WebView; los campos estructurados son para el header nativo.
+ */
+export class RemittanceTransactionReceipt {
+    txNumber!: string;
+    htmlReceipt?: string;
+    disclaimer?: string;
+    transactionStatus?: string;
+    /** MMDDYYYYHH24MISS de UNIR. */
+    transactionCreateDate?: string;
+    /** MMDDYYYY de UNIR. */
+    transactionPayableDate?: string;
+    transactionAmount?: number;
+    totalTransactionAmount?: number;
+    serviceFee?: number;
+    stateFee?: string;
+    exchangeRate?: number;
+    payingAmount?: number;
+}