@fiado/type-kit 3.611.0 → 3.613.0

package/src/gsfConnector/validators/IsGsfCalendarDate.ts

@@ -0,0 +1,19 @@
+import { ValidatorConstraint, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+import { GSF_DATE_PATTERN } from '../constants/GsfPatterns';
+
+/** `YYYY-MM-DD` de un día que existe: rechaza `2026-02-30` o `2026-13-01`, que el patrón solo no detecta. */
+@ValidatorConstraint({ name: 'isGsfCalendarDate', async: false })
+export class IsGsfCalendarDate implements ValidatorConstraintInterface {
+    validate(value: unknown, _args: ValidationArguments): boolean {
+        if (typeof value !== 'string' || !GSF_DATE_PATTERN.test(value)) {
+            return false;
+        }
+        const [year, month, day] = value.split('-').map(Number);
+        const date = new Date(Date.UTC(year, month - 1, day));
+        return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property} debe ser una fecha YYYY-MM-DD que exista`;
+    }
+}

package/src/gsfConnector/validators/IsGsfPaymentKindForOperation.ts

@@ -0,0 +1,21 @@
+import { ValidatorConstraint, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+import { GSF_PAYMENT_KINDS_BY_OPERATION, GSF_PAYMENT_OPERATIONS, GsfPaymentOperation } from '../constants/GsfPaymentOperations';
+
+/** La clase del pago tiene que corresponder a la operación del mensaje: un abono solo viaja como abono. */
+@ValidatorConstraint({ name: 'isGsfPaymentKindForOperation', async: false })
+export class IsGsfPaymentKindForOperation implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean {
+        const operation = (args.object as { operation?: unknown }).operation;
+        // Sin operación válida el error ya lo marca `operation`. Se compara contra la lista para que
+        // `constructor` o `__proto__` no lean el prototipo del mapa.
+        if (!GSF_PAYMENT_OPERATIONS.includes(operation as GsfPaymentOperation)) {
+            return true;
+        }
+        const kind = (value as { kind?: unknown } | null | undefined)?.kind;
+        return GSF_PAYMENT_KINDS_BY_OPERATION[operation as GsfPaymentOperation].includes(kind as never);
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property}.kind no corresponde a la operación del mensaje`;
+    }
+}

package/src/gsfConnector/validators/IsGsfPrepaymentScheduleProvided.ts

@@ -0,0 +1,18 @@
+import { ValidatorConstraint, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+import { GsfOperationEnum } from '../enums/GsfOperationEnum';
+
+/** Un abono a capital trae la tabla recalculada: sin ella no hay contra qué comparar la reestructura de GSF. */
+@ValidatorConstraint({ name: 'isGsfPrepaymentScheduleProvided', async: false })
+export class IsGsfPrepaymentScheduleProvided implements ValidatorConstraintInterface {
+    validate(value: unknown, args: ValidationArguments): boolean {
+        if ((args.object as { operation?: unknown }).operation !== GsfOperationEnum.APPLY_PREPAYMENT) {
+            return true;
+        }
+        const schedule = (value as { schedule?: unknown } | null | undefined)?.schedule;
+        return Array.isArray(schedule) && schedule.length > 0;
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property}.schedule es obligatorio en APPLY_PREPAYMENT`;
+    }
+}

package/src/index.ts

@@ -80,6 +80,7 @@ export * as AiEngine from './aiEngine';
 export * as Sentry from './sentry';
 export * as CreditStatements from './credit-statements';
 export * as CirculoCredito from './circuloCredito';
+export * as GsfConnector from './gsfConnector';
 export * as MilestoneBusiness from './milestone-business';
 export * as Mdm from './mdm';
 export * as MessagesConnector from './messagesConnector';

package/src/onboarding/events/SponsorChangedEventDetail.ts

@@ -0,0 +1,20 @@
+// Origen de los eventos de EventBridge que publica onboarding-business (bus fiado-directory-events).
+export const ONBOARDING_EVENTS_SOURCE = "fiado.onboarding";
+
+export enum OnboardingEventDetailTypeEnum {
+    /** Cambio del sponsor (quién lo refirió) de un sponsor real a otro. Las asignaciones desde o hacia "NA" no se publican. */
+    SPONSOR_CHANGED = "SponsorChanged",
+}
+
+// `detail` del evento SponsorChanged. Sale del stream de OnboardingUser_GT cuando cambia referralDirectoryId.
+export class SponsorChangedEventDetail {
+    /** eventID del record del stream: un reintento llega con el mismo id y el consumidor lo descarta. */
+    eventId!: string;
+    directoryId!: string;
+    previousSponsorDirectoryId!: string;
+    newSponsorDirectoryId!: string;
+    previousReferralCode!: string;
+    newReferralCode!: string;
+    /** ISO 8601 del momento en que se guardó el cambio. */
+    occurredAt!: string;
+}

package/src/onboarding/index.ts

@@ -11,3 +11,6 @@ export * from './dtos/responses/OnboardingStepsResponse';
 
 // Queue messages
 export * from './dtos/ExpedienteUpdatedMessage';
+
+// Events
+export * from './events/SponsorChangedEventDetail';