@fiado/type-kit 3.611.0 → 3.612.0

package/bin/gsfConnector/validators/IsGsfPrepaymentScheduleProvided.js

@@ -0,0 +1,28 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsGsfPrepaymentScheduleProvided = void 0;
+const class_validator_1 = require("class-validator");
+const GsfOperationEnum_1 = require("../enums/GsfOperationEnum");
+/** Un abono a capital trae la tabla recalculada: sin ella no hay contra qué comparar la reestructura de GSF. */
+let IsGsfPrepaymentScheduleProvided = class IsGsfPrepaymentScheduleProvided {
+    validate(value, args) {
+        if (args.object.operation !== GsfOperationEnum_1.GsfOperationEnum.APPLY_PREPAYMENT) {
+            return true;
+        }
+        const schedule = value?.schedule;
+        return Array.isArray(schedule) && schedule.length > 0;
+    }
+    defaultMessage(args) {
+        return `${args.property}.schedule es obligatorio en APPLY_PREPAYMENT`;
+    }
+};
+exports.IsGsfPrepaymentScheduleProvided = IsGsfPrepaymentScheduleProvided;
+exports.IsGsfPrepaymentScheduleProvided = IsGsfPrepaymentScheduleProvided = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isGsfPrepaymentScheduleProvided', async: false })
+], IsGsfPrepaymentScheduleProvided);

package/bin/index.d.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/bin/index.js

@@ -37,8 +37,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.FiadoIncFavorite = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.MessageMoments = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
-exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.UsMarketGrowthBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = void 0;
-exports.CustomerMessages = exports.TaskManager = exports.LoanRetailAudit = exports.Meetings = exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = void 0;
+exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.GsfConnector = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.UsMarketGrowthBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = void 0;
+exports.CustomerMessages = exports.TaskManager = exports.LoanRetailAudit = exports.Meetings = exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -121,6 +121,7 @@ exports.AiEngine = __importStar(require("./aiEngine"));
 exports.Sentry = __importStar(require("./sentry"));
 exports.CreditStatements = __importStar(require("./credit-statements"));
 exports.CirculoCredito = __importStar(require("./circuloCredito"));
+exports.GsfConnector = __importStar(require("./gsfConnector"));
 exports.MilestoneBusiness = __importStar(require("./milestone-business"));
 exports.Mdm = __importStar(require("./mdm"));
 exports.MessagesConnector = __importStar(require("./messagesConnector"));

package/package.json

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

package/src/gsfConnector/constants/GsfPatterns.ts

@@ -0,0 +1,21 @@
+/** Fecha calendario `YYYY-MM-DD`; `IsGsfCalendarDate` además rechaza días que no existen. */
+export const GSF_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+
+/** Slug de la cuenta de SofomCloud: elige las credenciales del conector. */
+export const GSF_ACCOUNT_PATTERN = /^[a-z][a-z0-9-]*$/;
+export const GSF_ACCOUNT_MAX_LENGTH = 64;
+
+/** RFC de persona física: 13 caracteres. GSF pide 13 en PF. */
+export const GSF_RFC_PF_PATTERN = /^[A-ZÑ&]{4}\d{6}[A-Z0-9]{3}$/;
+
+/** Al menos un carácter que no sea espacio. */
+export const GSF_NOT_BLANK_PATTERN = /\S/;
+
+/** Tope de SQS FIFO para MessageGroupId y MessageDeduplicationId. */
+export const GSF_QUEUE_ID_MAX_LENGTH = 128;
+
+export const GSF_MAX_CENTS = Number.MAX_SAFE_INTEGER;
+export const GSF_MAX_INSTALLMENTS = 1000;
+
+/** Tasa anual máxima en decimal: 100 = 10,000 %. */
+export const GSF_MAX_ANNUAL_RATE = 100;

package/src/gsfConnector/constants/GsfPaymentOperations.ts

@@ -0,0 +1,17 @@
+import { GsfOperationEnum } from '../enums/GsfOperationEnum';
+import { GsfPaymentKindEnum } from '../enums/GsfPaymentKindEnum';
+
+export const GSF_PAYMENT_OPERATIONS = [
+    GsfOperationEnum.APPLY_PAYMENT,
+    GsfOperationEnum.APPLY_PREPAYMENT,
+    GsfOperationEnum.SETTLE_CREDIT,
+] as const;
+
+export type GsfPaymentOperation = (typeof GSF_PAYMENT_OPERATIONS)[number];
+
+/** Clases de pago que admite cada operación. Una liquidación parcial viaja como `APPLY_PAYMENT`. */
+export const GSF_PAYMENT_KINDS_BY_OPERATION: Record<GsfPaymentOperation, readonly GsfPaymentKindEnum[]> = {
+    [GsfOperationEnum.APPLY_PAYMENT]: [GsfPaymentKindEnum.INSTALLMENT, GsfPaymentKindEnum.ADVANCE, GsfPaymentKindEnum.SETTLEMENT],
+    [GsfOperationEnum.APPLY_PREPAYMENT]: [GsfPaymentKindEnum.PREPAYMENT],
+    [GsfOperationEnum.SETTLE_CREDIT]: [GsfPaymentKindEnum.SETTLEMENT],
+};

package/src/gsfConnector/dtos/GsfAddress.ts

@@ -0,0 +1,60 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, Matches } from 'class-validator';
+import { ZIP_CODE_MX_PATTERN } from '../../common/constants/InputPatterns';
+import { GSF_NOT_BLANK_PATTERN } from '../constants/GsfPatterns';
+
+/** Domicilio del cliente con nombres; el conector los traduce a los catálogos de geografía de GSF. */
+export class GsfAddress {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    street: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    externalNumber: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    internalNumber?: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    neighborhood: string;
+
+    @Expose()
+    @Matches(ZIP_CODE_MX_PATTERN)
+    zipCode: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    city: string;
+
+    /** Si falta, el conector usa la ciudad. Vacío no vale: se omite. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    municipality?: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    state: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    country: string;
+}

package/src/gsfConnector/dtos/GsfCreateCreditMessage.ts

@@ -0,0 +1,60 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    ArrayMinSize, ArrayUnique, Equals, IsArray, IsDefined, IsNotEmpty, IsObject, IsString, Matches, MaxLength, ValidateNested,
+} from 'class-validator';
+import { GsfOperationEnum } from '../enums/GsfOperationEnum';
+import { GsfCustomer } from './GsfCustomer';
+import { GsfCreditTerms } from './GsfCreditTerms';
+import { GsfScheduleInstallment } from './GsfScheduleInstallment';
+import { GSF_ACCOUNT_MAX_LENGTH, GSF_ACCOUNT_PATTERN, GSF_NOT_BLANK_PATTERN, GSF_QUEUE_ID_MAX_LENGTH } from '../constants/GsfPatterns';
+
+/**
+ * Mensaje `CREATE_CREDIT` de `GsfSyncQueue.fifo`: el crédito ya está activo en el origen. MessageGroupId =
+ * `externalCreditId`, MessageDeduplicationId = `messageId`.
+ */
+export class GsfCreateCreditMessage {
+    @Expose()
+    @Matches(GSF_ACCOUNT_PATTERN)
+    @MaxLength(GSF_ACCOUNT_MAX_LENGTH)
+    account: string;
+
+    @Expose()
+    @Equals(GsfOperationEnum.CREATE_CREDIT)
+    operation: GsfOperationEnum.CREATE_CREDIT;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    @MaxLength(GSF_QUEUE_ID_MAX_LENGTH)
+    messageId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    @MaxLength(GSF_QUEUE_ID_MAX_LENGTH)
+    externalCreditId: string;
+
+    @Expose()
+    @IsDefined()
+    @IsObject()
+    @ValidateNested()
+    @Type(() => GsfCustomer)
+    customer: GsfCustomer;
+
+    @Expose()
+    @IsDefined()
+    @IsObject()
+    @ValidateNested()
+    @Type(() => GsfCreditTerms)
+    terms: GsfCreditTerms;
+
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayUnique((installment: GsfScheduleInstallment) => installment?.installmentNumber)
+    @ValidateNested({ each: true })
+    @Type(() => GsfScheduleInstallment)
+    expectedSchedule: GsfScheduleInstallment[];
+}

package/src/gsfConnector/dtos/GsfCreditTerms.ts

@@ -0,0 +1,55 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, IsNumber, Max, Min, Validate } from 'class-validator';
+import { GsfPaymentPeriodicityEnum } from '../enums/GsfPaymentPeriodicityEnum';
+import { GSF_MAX_ANNUAL_RATE, GSF_MAX_CENTS, GSF_MAX_INSTALLMENTS } from '../constants/GsfPatterns';
+import { IsGsfCalendarDate } from '../validators/IsGsfCalendarDate';
+
+/** Condiciones del crédito tal como quedaron firmadas. */
+export class GsfCreditTerms {
+    /** Monto que se amortiza, comisiones financiadas incluidas. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    @Max(GSF_MAX_CENTS)
+    amountCents: number;
+
+    @Expose()
+    @IsInt()
+    @Min(1)
+    @Max(GSF_MAX_INSTALLMENTS)
+    installmentCount: number;
+
+    @Expose()
+    @IsEnum(GsfPaymentPeriodicityEnum)
+    periodicity: GsfPaymentPeriodicityEnum;
+
+    /** Tasa anual del contrato en decimal: 2.30 = 230 %. Puede ser 0 por una promoción. */
+    @Expose()
+    @IsNumber({ allowNaN: false, allowInfinity: false })
+    @Min(0)
+    @Max(GSF_MAX_ANNUAL_RATE)
+    annualRate: number;
+
+    /** Entre cuántos periodos divide el origen la tasa anual: 52 si el interés semanal es tasa / 52. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    @Max(365)
+    periodsPerYear: number;
+
+    /** IVA sobre el interés en decimal: 0.16. */
+    @Expose()
+    @IsNumber({ allowNaN: false, allowInfinity: false })
+    @Min(0)
+    @Max(1)
+    ivaRate: number;
+
+    @Expose()
+    @Validate(IsGsfCalendarDate)
+    signedOn: string;
+
+    /** Inicio del calendario de pagos. */
+    @Expose()
+    @Validate(IsGsfCalendarDate)
+    activatedOn: string;
+}

package/src/gsfConnector/dtos/GsfCustomer.ts

@@ -0,0 +1,60 @@
+import { Expose, Type } from 'class-transformer';
+import { IsDefined, IsNotEmpty, IsObject, IsOptional, IsString, Matches, MaxLength, Validate, ValidateNested } from 'class-validator';
+import { EMAIL_MAX_LENGTH, EMAIL_PATTERN, PHONE_MX_ACCEPTED_PATTERN } from '../../common/constants/InputPatterns';
+import { regexCurp } from '../../helpers/constans/regex';
+import { GsfAddress } from './GsfAddress';
+import { GSF_NOT_BLANK_PATTERN, GSF_RFC_PF_PATTERN } from '../constants/GsfPatterns';
+import { IsGsfCalendarDate } from '../validators/IsGsfCalendarDate';
+
+/** Cliente persona física. Lleva datos personales: nunca se loguea. */
+export class GsfCustomer {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    names: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    paternalLastName: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    maternalLastName?: string;
+
+    @Expose()
+    @Matches(GSF_RFC_PF_PATTERN)
+    rfc: string;
+
+    /** El conector deriva de la CURP el género y el estado de nacimiento. */
+    @Expose()
+    @Matches(regexCurp)
+    curp: string;
+
+    @Expose()
+    @Validate(IsGsfCalendarDate)
+    birthDate: string;
+
+    @Expose()
+    @IsOptional()
+    @Matches(EMAIL_PATTERN)
+    @MaxLength(EMAIL_MAX_LENGTH)
+    email?: string;
+
+    /** 10 dígitos, con o sin `+52`; el conector manda los 10 dígitos. */
+    @Expose()
+    @IsOptional()
+    @Matches(PHONE_MX_ACCEPTED_PATTERN)
+    mobilePhone?: string;
+
+    @Expose()
+    @IsDefined()
+    @IsObject()
+    @ValidateNested()
+    @Type(() => GsfAddress)
+    address: GsfAddress;
+}

package/src/gsfConnector/dtos/GsfExpectedState.ts

@@ -0,0 +1,25 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMinSize, ArrayUnique, IsArray, IsInt, IsOptional, Max, Min, ValidateNested } from 'class-validator';
+import { GsfScheduleInstallment } from './GsfScheduleInstallment';
+import { GSF_MAX_CENTS } from '../constants/GsfPatterns';
+
+/** Cómo debe quedar el crédito en GSF después del pago, según el origen. */
+export class GsfExpectedState {
+    /** Capital pendiente del crédito después del pago. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(GSF_MAX_CENTS)
+    principalAfterCents?: number;
+
+    /** Cuotas que el pago recalculó (abono a capital), con sus importes nuevos. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayUnique((installment: GsfScheduleInstallment) => installment?.installmentNumber)
+    @ValidateNested({ each: true })
+    @Type(() => GsfScheduleInstallment)
+    schedule?: GsfScheduleInstallment[];
+}

package/src/gsfConnector/dtos/GsfPayment.ts

@@ -0,0 +1,57 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, IsNotEmpty, IsOptional, IsString, Matches, Max, Min, Validate } from 'class-validator';
+import { GsfPaymentKindEnum } from '../enums/GsfPaymentKindEnum';
+import { GsfPaymentChannelEnum } from '../enums/GsfPaymentChannelEnum';
+import { GSF_MAX_CENTS, GSF_NOT_BLANK_PATTERN } from '../constants/GsfPatterns';
+import { IsGsfCalendarDate } from '../validators/IsGsfCalendarDate';
+
+/** Un pago ya aplicado en el sistema de origen. */
+export class GsfPayment {
+    /** Id del pago en el origen: el conector no aplica dos veces el mismo. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    externalPaymentId: string;
+
+    @Expose()
+    @IsEnum(GsfPaymentKindEnum)
+    kind: GsfPaymentKindEnum;
+
+    @Expose()
+    @IsEnum(GsfPaymentChannelEnum)
+    channel: GsfPaymentChannelEnum;
+
+    @Expose()
+    @IsInt()
+    @Min(1)
+    @Max(GSF_MAX_CENTS)
+    amountCents: number;
+
+    /** Día del pago en la zona del origen. */
+    @Expose()
+    @Validate(IsGsfCalendarDate)
+    appliedOn: string;
+
+    /** Desglose que aplicó el origen; sirve para conciliar. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(GSF_MAX_CENTS)
+    capitalCents?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(GSF_MAX_CENTS)
+    interestCents?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(GSF_MAX_CENTS)
+    ivaCents?: number;
+}

package/src/gsfConnector/dtos/GsfPaymentMessage.ts

@@ -0,0 +1,58 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    IsDefined, IsIn, IsNotEmpty, IsObject, IsString, Matches, MaxLength, Validate, ValidateIf, ValidateNested,
+} from 'class-validator';
+import { GsfOperationEnum } from '../enums/GsfOperationEnum';
+import { GsfPayment } from './GsfPayment';
+import { GsfExpectedState } from './GsfExpectedState';
+import { GSF_PAYMENT_OPERATIONS, GsfPaymentOperation } from '../constants/GsfPaymentOperations';
+import { GSF_ACCOUNT_MAX_LENGTH, GSF_ACCOUNT_PATTERN, GSF_NOT_BLANK_PATTERN, GSF_QUEUE_ID_MAX_LENGTH } from '../constants/GsfPatterns';
+import { IsGsfPaymentKindForOperation } from '../validators/IsGsfPaymentKindForOperation';
+import { IsGsfPrepaymentScheduleProvided } from '../validators/IsGsfPrepaymentScheduleProvided';
+
+/**
+ * Mensaje de pago de `GsfSyncQueue.fifo`: `APPLY_PAYMENT`, `APPLY_PREPAYMENT` o `SETTLE_CREDIT`. Llega
+ * después del `CREATE_CREDIT` del mismo crédito porque comparten MessageGroupId (`externalCreditId`).
+ */
+export class GsfPaymentMessage {
+    @Expose()
+    @Matches(GSF_ACCOUNT_PATTERN)
+    @MaxLength(GSF_ACCOUNT_MAX_LENGTH)
+    account: string;
+
+    @Expose()
+    @IsIn([...GSF_PAYMENT_OPERATIONS])
+    operation: GsfPaymentOperation;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    @MaxLength(GSF_QUEUE_ID_MAX_LENGTH)
+    messageId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(GSF_NOT_BLANK_PATTERN)
+    @MaxLength(GSF_QUEUE_ID_MAX_LENGTH)
+    externalCreditId: string;
+
+    @Expose()
+    @IsDefined()
+    @IsObject()
+    @ValidateNested()
+    @Type(() => GsfPayment)
+    @Validate(IsGsfPaymentKindForOperation)
+    payment: GsfPayment;
+
+    /** Obligatorio en `APPLY_PREPAYMENT`, con la tabla recalculada. */
+    @Expose()
+    @ValidateIf((message: GsfPaymentMessage) => message.operation === GsfOperationEnum.APPLY_PREPAYMENT || message.expected != null)
+    @IsDefined()
+    @IsObject()
+    @ValidateNested()
+    @Type(() => GsfExpectedState)
+    @Validate(IsGsfPrepaymentScheduleProvided)
+    expected?: GsfExpectedState;
+}

package/src/gsfConnector/dtos/GsfScheduleInstallment.ts

@@ -0,0 +1,41 @@
+import { Expose } from 'class-transformer';
+import { IsInt, Max, Min, Validate } from 'class-validator';
+import { GSF_MAX_CENTS, GSF_MAX_INSTALLMENTS } from '../constants/GsfPatterns';
+import { IsGsfCalendarDate } from '../validators/IsGsfCalendarDate';
+
+/** Una cuota como la calculó el sistema de origen; el conector la compara contra la de GSF. */
+export class GsfScheduleInstallment {
+    @Expose()
+    @IsInt()
+    @Min(1)
+    @Max(GSF_MAX_INSTALLMENTS)
+    installmentNumber: number;
+
+    @Expose()
+    @Validate(IsGsfCalendarDate)
+    dueDate: string;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    @Max(GSF_MAX_CENTS)
+    capitalCents: number;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    @Max(GSF_MAX_CENTS)
+    interestCents: number;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    @Max(GSF_MAX_CENTS)
+    ivaCents: number;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    @Max(GSF_MAX_CENTS)
+    totalCents: number;
+}

package/src/gsfConnector/enums/GsfOperationEnum.ts

@@ -0,0 +1,11 @@
+/** Operación que pide un mensaje de `GsfSyncQueue.fifo`. */
+export enum GsfOperationEnum {
+    /** Alta del cliente y del crédito ya activo, con la tabla que se espera ver en GSF. */
+    CREATE_CREDIT = 'CREATE_CREDIT',
+    /** Pago de una cuota, adelanto de cuotas o liquidación parcial. */
+    APPLY_PAYMENT = 'APPLY_PAYMENT',
+    /** Abono a capital: GSF reestructura la tabla y se compara con la esperada. */
+    APPLY_PREPAYMENT = 'APPLY_PREPAYMENT',
+    /** Pago que liquida el crédito. */
+    SETTLE_CREDIT = 'SETTLE_CREDIT',
+}

package/src/gsfConnector/enums/GsfPaymentChannelEnum.ts

@@ -0,0 +1,11 @@
+/** Por dónde entró el dinero de un pago. */
+export enum GsfPaymentChannelEnum {
+    /** Cargo automático a la tarjeta del cliente. */
+    AUTOMATIC_CARD_CHARGE = 'AUTOMATIC_CARD_CHARGE',
+    /** Efectivo en ventanilla o caja. */
+    CASH = 'CASH',
+    /** Tarjeta en ventanilla o caja. */
+    CARD = 'CARD',
+    /** Transferencia bancaria. */
+    WIRE_TRANSFER = 'WIRE_TRANSFER',
+}

package/src/gsfConnector/enums/GsfPaymentKindEnum.ts

@@ -0,0 +1,11 @@
+/** Para qué se aplicó un pago en el sistema de origen. */
+export enum GsfPaymentKindEnum {
+    /** Cuota del periodo. */
+    INSTALLMENT = 'INSTALLMENT',
+    /** Cuotas futuras cubiertas tal cual: la tabla no cambia. */
+    ADVANCE = 'ADVANCE',
+    /** Abono a capital: baja las cuotas restantes. */
+    PREPAYMENT = 'PREPAYMENT',
+    /** Liquidación del crédito. */
+    SETTLEMENT = 'SETTLEMENT',
+}

package/src/gsfConnector/enums/GsfPaymentPeriodicityEnum.ts

@@ -0,0 +1,6 @@
+/** Periodicidad de las cuotas del crédito. */
+export enum GsfPaymentPeriodicityEnum {
+    WEEKLY = 'WEEKLY',
+    BIWEEKLY = 'BIWEEKLY',
+    MONTHLY = 'MONTHLY',
+}

package/src/gsfConnector/index.ts

@@ -0,0 +1,24 @@
+// Enums
+export * from './enums/GsfOperationEnum';
+export * from './enums/GsfPaymentKindEnum';
+export * from './enums/GsfPaymentChannelEnum';
+export * from './enums/GsfPaymentPeriodicityEnum';
+
+// Constants
+export * from './constants/GsfPatterns';
+export * from './constants/GsfPaymentOperations';
+
+// Validators
+export * from './validators/IsGsfCalendarDate';
+export * from './validators/IsGsfPaymentKindForOperation';
+export * from './validators/IsGsfPrepaymentScheduleProvided';
+
+// DTOs del mensaje de GsfSyncQueue.fifo
+export * from './dtos/GsfAddress';
+export * from './dtos/GsfCustomer';
+export * from './dtos/GsfScheduleInstallment';
+export * from './dtos/GsfCreditTerms';
+export * from './dtos/GsfPayment';
+export * from './dtos/GsfExpectedState';
+export * from './dtos/GsfCreateCreditMessage';
+export * from './dtos/GsfPaymentMessage';

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`;
+    }
+}