@fiado/type-kit 3.161.0 → 3.163.0

package/src/remittance/dtos/RemittancePromotion.ts

@@ -1,162 +1,162 @@
-import { Type } from "class-transformer";
-import {
-    IsEnum,
-    IsInt,
-    IsNumber,
-    IsOptional,
-    IsString,
-    Length,
-    Matches,
-    Max,
-    MaxLength,
-    Min,
-    ValidateNested,
-} from "class-validator";
-import { FeeEffectMode } from "../enums/FeeEffectMode";
-import { FxEffectMode } from "../enums/FxEffectMode";
-import { PromotionActivation } from "../enums/PromotionActivation";
-import { PromotionKind } from "../enums/PromotionKind";
-import { PromotionStatus } from "../enums/PromotionStatus";
-import { RemittanceCorridor } from "../enums/RemittanceCorridor";
-
-/**
- * DTOs de Promociones (Dashboard Ops · Variables Operativas §2).
- *
- * UniTeller NO participa (no hay motor de promos en API Lite): toda la lógica
- * vive en Fiado. Una promo es un OVERRIDE de Precio Base (markup y/o fee) para
- * una audiencia (corridor × segmento × cohort, null = Cualquiera) y vigencia.
- * Dueño de la tabla: remittance-business (RemittancePromotions_GT). La
- * resolución en send-time (capas: base → PRICE_CHANGE → mejor-para-el-cliente)
- * es Fase B — estos DTOs cubren la config.
- */
-
-const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
-
-/** Audiencia: null en una dimensión = "Cualquiera". */
-export class PromotionAudience {
-    @IsOptional()
-    @IsEnum(RemittanceCorridor)
-    corridor?: RemittanceCorridor | null;
-
-    @IsOptional()
-    @IsString()
-    @Length(1, 100)
-    segmentId?: string | null;
-
-    @IsOptional()
-    @IsString()
-    @Length(1, 100)
-    cohortId?: string | null;
-}
-
-/** Efecto FX (spread): DELTA suma bps CON SIGNO al markup base; ABSOLUTE lo reemplaza. */
-export class FxEffect {
-    @IsEnum(FxEffectMode)
-    mode!: FxEffectMode;
-
-    /** bps con signo. Ignorado si mode=NONE (mandar 0). */
-    @IsInt()
-    @Min(-500)
-    @Max(500)
-    valueBps!: number;
-}
-
-/** Efecto fee: ABSOLUTE = $; DELTA = ±$; PERCENTAGE = −% del fee (0-100). */
-export class FeeEffect {
-    @IsEnum(FeeEffectMode)
-    mode!: FeeEffectMode;
-
-    @IsNumber()
-    @Min(-100)
-    @Max(100)
-    value!: number;
-}
-
-export class CreatePromotionRequest {
-    @IsString()
-    @Length(3, 100)
-    name!: string;
-
-    @IsEnum(PromotionKind)
-    kind!: PromotionKind;
-
-    @IsEnum(PromotionActivation)
-    activation!: PromotionActivation;
-
-    /** Requerido si activation=CODE (regla en manager); único case-insensitive. */
-    @IsOptional()
-    @IsString()
-    @Length(3, 30)
-    @Matches(/^[A-Z0-9_-]+$/i)
-    code?: string | null;
-
-    @ValidateNested()
-    @Type(() => PromotionAudience)
-    audience!: PromotionAudience;
-
-    /** ISO date (YYYY-MM-DD). */
-    @IsString()
-    @Matches(ISO_DATE)
-    effectiveFrom!: string;
-
-    /** ISO date; null/ausente = permanente (∞). */
-    @IsOptional()
-    @IsString()
-    @Matches(ISO_DATE)
-    effectiveTo?: string | null;
-
-    @ValidateNested()
-    @Type(() => FxEffect)
-    fxEffect!: FxEffect;
-
-    @ValidateNested()
-    @Type(() => FeeEffect)
-    feeEffect!: FeeEffect;
-
-    @IsOptional()
-    @IsString()
-    @MaxLength(500)
-    notes?: string | null;
-}
-
-/** PUT — reemplazo completo (mismos campos que create). */
-export class UpdatePromotionRequest extends CreatePromotionRequest {
-}
-
-/** Promoción completa (response de list/create/update). */
-export class Promotion {
-    id!: string;
-    name!: string;
-    kind!: PromotionKind;
-    activation!: PromotionActivation;
-    code!: string | null;
-    audience!: { corridor: RemittanceCorridor | null; segmentId: string | null; cohortId: string | null };
-    /** Display: nombres resueltos de segmento/cohort (null = "Cualquiera" o no resoluble). */
-    audienceDisplay!: { corridor: string | null; segmentName: string | null; cohortName: string | null };
-    effectiveFrom!: string;
-    effectiveTo!: string | null;
-    fxEffect!: { mode: FxEffectMode; valueBps: number };
-    feeEffect!: { mode: FeeEffectMode; value: number };
-    /** Derivado de la vigencia vs hoy (UTC). */
-    status!: PromotionStatus;
-    /** Legible para la columna EFECTO: "MU −30 bps + Fee = $0". */
-    effectSummary!: string;
-    notes!: string | null;
-    createdAt!: string;
-    updatedAt!: string;
-    createdBy!: string;
-    updatedBy!: string;
-}
-
-/** Response de GET /backoffice/pricing/promotions. */
-export class PromotionListResponse {
-    items!: Promotion[];
-}
-
-/** Response de GET /backoffice/pricing/promotions/reach. */
-export class PromotionReachResponse {
-    /** Clientes en la intersección corridor × segmento × cohort. */
-    reach!: number;
-    /** Universo (todos los RemittanceUsers) — para el % del picker. */
-    total!: number;
-}
+import { Type } from "class-transformer";
+import {
+    IsEnum,
+    IsInt,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Length,
+    Matches,
+    Max,
+    MaxLength,
+    Min,
+    ValidateNested,
+} from "class-validator";
+import { FeeEffectMode } from "../enums/FeeEffectMode";
+import { FxEffectMode } from "../enums/FxEffectMode";
+import { PromotionActivation } from "../enums/PromotionActivation";
+import { PromotionKind } from "../enums/PromotionKind";
+import { PromotionStatus } from "../enums/PromotionStatus";
+import { RemittanceCorridor } from "../enums/RemittanceCorridor";
+
+/**
+ * DTOs de Promociones (Dashboard Ops · Variables Operativas §2).
+ *
+ * UniTeller NO participa (no hay motor de promos en API Lite): toda la lógica
+ * vive en Fiado. Una promo es un OVERRIDE de Precio Base (markup y/o fee) para
+ * una audiencia (corridor × segmento × cohort, null = Cualquiera) y vigencia.
+ * Dueño de la tabla: remittance-business (RemittancePromotions_GT). La
+ * resolución en send-time (capas: base → PRICE_CHANGE → mejor-para-el-cliente)
+ * es Fase B — estos DTOs cubren la config.
+ */
+
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+
+/** Audiencia: null en una dimensión = "Cualquiera". */
+export class PromotionAudience {
+    @IsOptional()
+    @IsEnum(RemittanceCorridor)
+    corridor?: RemittanceCorridor | null;
+
+    @IsOptional()
+    @IsString()
+    @Length(1, 100)
+    segmentId?: string | null;
+
+    @IsOptional()
+    @IsString()
+    @Length(1, 100)
+    cohortId?: string | null;
+}
+
+/** Efecto FX (spread): DELTA suma bps CON SIGNO al markup base; ABSOLUTE lo reemplaza. */
+export class FxEffect {
+    @IsEnum(FxEffectMode)
+    mode!: FxEffectMode;
+
+    /** bps con signo. Ignorado si mode=NONE (mandar 0). */
+    @IsInt()
+    @Min(-500)
+    @Max(500)
+    valueBps!: number;
+}
+
+/** Efecto fee: ABSOLUTE = $; DELTA = ±$; PERCENTAGE = −% del fee (0-100). */
+export class FeeEffect {
+    @IsEnum(FeeEffectMode)
+    mode!: FeeEffectMode;
+
+    @IsNumber()
+    @Min(-100)
+    @Max(100)
+    value!: number;
+}
+
+export class CreatePromotionRequest {
+    @IsString()
+    @Length(3, 100)
+    name!: string;
+
+    @IsEnum(PromotionKind)
+    kind!: PromotionKind;
+
+    @IsEnum(PromotionActivation)
+    activation!: PromotionActivation;
+
+    /** Requerido si activation=CODE (regla en manager); único case-insensitive. */
+    @IsOptional()
+    @IsString()
+    @Length(3, 30)
+    @Matches(/^[A-Z0-9_-]+$/i)
+    code?: string | null;
+
+    @ValidateNested()
+    @Type(() => PromotionAudience)
+    audience!: PromotionAudience;
+
+    /** ISO date (YYYY-MM-DD). */
+    @IsString()
+    @Matches(ISO_DATE)
+    effectiveFrom!: string;
+
+    /** ISO date; null/ausente = permanente (∞). */
+    @IsOptional()
+    @IsString()
+    @Matches(ISO_DATE)
+    effectiveTo?: string | null;
+
+    @ValidateNested()
+    @Type(() => FxEffect)
+    fxEffect!: FxEffect;
+
+    @ValidateNested()
+    @Type(() => FeeEffect)
+    feeEffect!: FeeEffect;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    notes?: string | null;
+}
+
+/** PUT — reemplazo completo (mismos campos que create). */
+export class UpdatePromotionRequest extends CreatePromotionRequest {
+}
+
+/** Promoción completa (response de list/create/update). */
+export class Promotion {
+    id!: string;
+    name!: string;
+    kind!: PromotionKind;
+    activation!: PromotionActivation;
+    code!: string | null;
+    audience!: { corridor: RemittanceCorridor | null; segmentId: string | null; cohortId: string | null };
+    /** Display: nombres resueltos de segmento/cohort (null = "Cualquiera" o no resoluble). */
+    audienceDisplay!: { corridor: string | null; segmentName: string | null; cohortName: string | null };
+    effectiveFrom!: string;
+    effectiveTo!: string | null;
+    fxEffect!: { mode: FxEffectMode; valueBps: number };
+    feeEffect!: { mode: FeeEffectMode; value: number };
+    /** Derivado de la vigencia vs hoy (UTC). */
+    status!: PromotionStatus;
+    /** Legible para la columna EFECTO: "MU −30 bps + Fee = $0". */
+    effectSummary!: string;
+    notes!: string | null;
+    createdAt!: string;
+    updatedAt!: string;
+    createdBy!: string;
+    updatedBy!: string;
+}
+
+/** Response de GET /backoffice/pricing/promotions. */
+export class PromotionListResponse {
+    items!: Promotion[];
+}
+
+/** Response de GET /backoffice/pricing/promotions/reach. */
+export class PromotionReachResponse {
+    /** Clientes en la intersección corridor × segmento × cohort. */
+    reach!: number;
+    /** Universo (todos los RemittanceUsers) — para el % del picker. */
+    total!: number;
+}

package/src/remittance/dtos/RemittanceQuoteRequest.ts

@@ -1,33 +1,39 @@
-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, IsOptional, IsString, Length, 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;
+
+    /** 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/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/RemittanceRule.ts

@@ -1,114 +1,114 @@
-import { Type } from "class-transformer";
-import {
-    IsBoolean,
-    IsEnum,
-    IsNumber,
-    IsOptional,
-    IsString,
-    Length,
-    MaxLength,
-    ValidateNested,
-} from "class-validator";
-import { RuleActionType } from "../enums/RuleActionType";
-import { RuleCategory } from "../enums/RuleCategory";
-import { RuleField } from "../enums/RuleField";
-import { RuleOperator } from "../enums/RuleOperator";
-import { RemittanceCorridor } from "../enums/RemittanceCorridor";
-
-/**
- * DTOs de Reglas (Dashboard Ops · Variables Operativas §3). Barandas del pricing:
- * CAP (fuerza al límite / bloquea save), VALIDATION (bloquea save), ALARM (notifica
- * a un comité). Dueño de la tabla: remittance-business (RemittanceRules_GT). La
- * coherencia campo×categoría×acción es cross-field → la valida el manager, no
- * class-validator. El enforcement POR TX (clamps) es Fase B; Fase A = al guardar config.
- */
-
-/** Alcance: campo AUSENTE = "aplica a todas" (mockup: "Vacío en una dimensión = aplica a todas"). */
-export class RuleScope {
-    @IsOptional()
-    @IsEnum(RemittanceCorridor)
-    corridor?: RemittanceCorridor;
-
-    @IsOptional()
-    @IsString()
-    @Length(1, 100)
-    segmentId?: string;
-}
-
-export class CreateRuleRequest {
-    @IsString()
-    @Length(3, 100)
-    name!: string;
-
-    @IsEnum(RuleCategory)
-    category!: RuleCategory;
-
-    @IsBoolean()
-    active!: boolean;
-
-    @IsEnum(RuleField)
-    conditionField!: RuleField;
-
-    @IsEnum(RuleOperator)
-    conditionOp!: RuleOperator;
-
-    @IsNumber()
-    conditionValue!: number;
-
-    @IsEnum(RuleActionType)
-    actionType!: RuleActionType;
-
-    /** Requerido si actionType=NOTIFY (regla en el manager); id de RemittanceCommittees_GT. */
-    @IsOptional()
-    @IsString()
-    @Length(1, 100)
-    committeeId?: string;
-
-    @IsOptional()
-    @IsString()
-    @MaxLength(300)
-    actionMessage?: string;
-
-    @ValidateNested()
-    @Type(() => RuleScope)
-    scope!: RuleScope;
-
-    @IsOptional()
-    @IsString()
-    @MaxLength(500)
-    description?: string;
-}
-
-/** PUT — reemplazo completo (incluye el toggle `active`). */
-export class UpdateRuleRequest extends CreateRuleRequest {
-}
-
-/** Regla completa (response). */
-export class Rule {
-    id!: string;
-    name!: string;
-    category!: RuleCategory;
-    active!: boolean;
-    description!: string | null;
-    conditionField!: RuleField;
-    conditionOp!: RuleOperator;
-    conditionValue!: number;
-    actionType!: RuleActionType;
-    committeeId!: string | null;
-    /** Display resuelto del comité (null si no NOTIFY o no resoluble). */
-    committeeName!: string | null;
-    actionMessage!: string | null;
-    scope!: { corridor: RemittanceCorridor | null; segmentId: string | null };
-    /** Display resuelto del segmento del alcance. */
-    scopeSegmentName!: string | null;
-    /** Disparos del mes corriente (0 si el contador es de un mes anterior). Columna DISP.(MES). */
-    triggersMonth!: number;
-    createdAt!: string;
-    updatedAt!: string;
-    createdBy!: string;
-    updatedBy!: string;
-}
-
-export class RuleListResponse {
-    items!: Rule[];
-}
+import { Type } from "class-transformer";
+import {
+    IsBoolean,
+    IsEnum,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Length,
+    MaxLength,
+    ValidateNested,
+} from "class-validator";
+import { RuleActionType } from "../enums/RuleActionType";
+import { RuleCategory } from "../enums/RuleCategory";
+import { RuleField } from "../enums/RuleField";
+import { RuleOperator } from "../enums/RuleOperator";
+import { RemittanceCorridor } from "../enums/RemittanceCorridor";
+
+/**
+ * DTOs de Reglas (Dashboard Ops · Variables Operativas §3). Barandas del pricing:
+ * CAP (fuerza al límite / bloquea save), VALIDATION (bloquea save), ALARM (notifica
+ * a un comité). Dueño de la tabla: remittance-business (RemittanceRules_GT). La
+ * coherencia campo×categoría×acción es cross-field → la valida el manager, no
+ * class-validator. El enforcement POR TX (clamps) es Fase B; Fase A = al guardar config.
+ */
+
+/** Alcance: campo AUSENTE = "aplica a todas" (mockup: "Vacío en una dimensión = aplica a todas"). */
+export class RuleScope {
+    @IsOptional()
+    @IsEnum(RemittanceCorridor)
+    corridor?: RemittanceCorridor;
+
+    @IsOptional()
+    @IsString()
+    @Length(1, 100)
+    segmentId?: string;
+}
+
+export class CreateRuleRequest {
+    @IsString()
+    @Length(3, 100)
+    name!: string;
+
+    @IsEnum(RuleCategory)
+    category!: RuleCategory;
+
+    @IsBoolean()
+    active!: boolean;
+
+    @IsEnum(RuleField)
+    conditionField!: RuleField;
+
+    @IsEnum(RuleOperator)
+    conditionOp!: RuleOperator;
+
+    @IsNumber()
+    conditionValue!: number;
+
+    @IsEnum(RuleActionType)
+    actionType!: RuleActionType;
+
+    /** Requerido si actionType=NOTIFY (regla en el manager); id de RemittanceCommittees_GT. */
+    @IsOptional()
+    @IsString()
+    @Length(1, 100)
+    committeeId?: string;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(300)
+    actionMessage?: string;
+
+    @ValidateNested()
+    @Type(() => RuleScope)
+    scope!: RuleScope;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    description?: string;
+}
+
+/** PUT — reemplazo completo (incluye el toggle `active`). */
+export class UpdateRuleRequest extends CreateRuleRequest {
+}
+
+/** Regla completa (response). */
+export class Rule {
+    id!: string;
+    name!: string;
+    category!: RuleCategory;
+    active!: boolean;
+    description!: string | null;
+    conditionField!: RuleField;
+    conditionOp!: RuleOperator;
+    conditionValue!: number;
+    actionType!: RuleActionType;
+    committeeId!: string | null;
+    /** Display resuelto del comité (null si no NOTIFY o no resoluble). */
+    committeeName!: string | null;
+    actionMessage!: string | null;
+    scope!: { corridor: RemittanceCorridor | null; segmentId: string | null };
+    /** Display resuelto del segmento del alcance. */
+    scopeSegmentName!: string | null;
+    /** Disparos del mes corriente (0 si el contador es de un mes anterior). Columna DISP.(MES). */
+    triggersMonth!: number;
+    createdAt!: string;
+    updatedAt!: string;
+    createdBy!: string;
+    updatedBy!: string;
+}
+
+export class RuleListResponse {
+    items!: Rule[];
+}

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[];
+}