@fiado/type-kit 3.470.0 → 3.471.0

package/_test_/unit/moneyTransfer/accountDtos.test.ts

@@ -0,0 +1,206 @@
+import "reflect-metadata";
+import { plainToInstance } from "class-transformer";
+import { validateSync } from "class-validator";
+import {
+    AccountImpactResponse,
+    AccountListResponse,
+    AccountResponse,
+    AccountWithImpactResponse,
+    CreateAccountRequest,
+    PendingDetailsResponse,
+    SettlementResponse,
+    TransactionDetailResponse,
+    TransferChannelEnum,
+    UpdateAccountRequest,
+} from "../../../src/moneyTransfer";
+
+const propertiesWithErrors = (dto: object) => validateSync(dto).map((error) => error.property);
+
+/** Cuenta destino válida (DEC-041). */
+const CUENTA_COMPLETA = {
+    accountId: "ACC-BANORTE-01",
+    tenantId: "SPEI",
+    channel: TransferChannelEnum.SPEI,
+    account: "072180000123456789",
+    beneficiaryName: "ACME SA DE CV",
+    beneficiaryRfc: "ACM010101AB1",
+    bankName: "Banorte",
+    currency: "MXN",
+    enabled: true,
+};
+
+describe("CreateAccountRequest", () => {
+    it("una cuenta completa pasa la validación", () => {
+        expect(validateSync(plainToInstance(CreateAccountRequest, CUENTA_COMPLETA))).toHaveLength(0);
+    });
+
+    it("beneficiaryRfc es opcional", () => {
+        const { beneficiaryRfc: _omit, ...sinRfc } = CUENTA_COMPLETA;
+        expect(validateSync(plainToInstance(CreateAccountRequest, sinRfc))).toHaveLength(0);
+    });
+
+    it("exige todos los campos obligatorios cuando llega vacía", () => {
+        const props = propertiesWithErrors(plainToInstance(CreateAccountRequest, {}));
+        for (const campo of [
+            "accountId",
+            "tenantId",
+            "channel",
+            "account",
+            "beneficiaryName",
+            "bankName",
+            "currency",
+            "enabled",
+        ]) {
+            expect(props).toContain(campo);
+        }
+    });
+
+    it("rechaza un accountId en minúsculas o con caracteres fuera de [A-Z0-9-]", () => {
+        for (const accountId of ["acc-banorte-01", "ACC BANORTE", "-ACC", "ACC_01"]) {
+            expect(propertiesWithErrors(plainToInstance(CreateAccountRequest, { ...CUENTA_COMPLETA, accountId })))
+                .toContain("accountId");
+        }
+    });
+
+    it("acepta un accountId de 64 chars y rechaza 65", () => {
+        const enElLimite = { ...CUENTA_COMPLETA, accountId: "A".repeat(64) };
+        expect(validateSync(plainToInstance(CreateAccountRequest, enElLimite))).toHaveLength(0);
+
+        const pasado = { ...CUENTA_COMPLETA, accountId: "A".repeat(65) };
+        expect(propertiesWithErrors(plainToInstance(CreateAccountRequest, pasado))).toContain("accountId");
+    });
+
+    it("rechaza un canal fuera de TransferChannelEnum", () => {
+        expect(propertiesWithErrors(plainToInstance(CreateAccountRequest, { ...CUENTA_COMPLETA, channel: "SWIFT" })))
+            .toContain("channel");
+    });
+
+    it("rechaza beneficiaryName > 40, bankName > 60, account > 34 y currency != 3", () => {
+        const dto = plainToInstance(CreateAccountRequest, {
+            ...CUENTA_COMPLETA,
+            beneficiaryName: "N".repeat(41),
+            bankName: "B".repeat(61),
+            account: "9".repeat(35),
+            currency: "MX",
+        });
+        const props = propertiesWithErrors(dto);
+        expect(props).toContain("beneficiaryName");
+        expect(props).toContain("bankName");
+        expect(props).toContain("account");
+        expect(props).toContain("currency");
+    });
+
+    it("rechaza beneficiaryRfc fuera del rango 12-13 chars", () => {
+        for (const beneficiaryRfc of ["CORTO", "R".repeat(14)]) {
+            expect(propertiesWithErrors(plainToInstance(CreateAccountRequest, { ...CUENTA_COMPLETA, beneficiaryRfc })))
+                .toContain("beneficiaryRfc");
+        }
+    });
+});
+
+describe("UpdateAccountRequest", () => {
+    it("un body vacío es válido: todos los campos son opcionales", () => {
+        expect(validateSync(plainToInstance(UpdateAccountRequest, {}))).toHaveLength(0);
+    });
+
+    it("DEC-045: permite mandar solo el número de cuenta corregido", () => {
+        expect(validateSync(plainToInstance(UpdateAccountRequest, { account: "072180000987654321" }))).toHaveLength(0);
+    });
+
+    it("DEC-049: permite deshabilitar mandando solo enabled", () => {
+        expect(validateSync(plainToInstance(UpdateAccountRequest, { enabled: false }))).toHaveLength(0);
+    });
+
+    it("accountId no es una propiedad del DTO: la PK viaja en el path, no en el body", () => {
+        // `accountId` no está declarado ni validado; si alguien lo manda, el DTO no lo reconoce
+        // como campo propio y el manager no lo puede usar para reasignar la PK.
+        const dto = plainToInstance(UpdateAccountRequest, { accountId: "ACC-OTRA-01" });
+        expect(validateSync(dto)).toHaveLength(0);
+        expect(Object.keys(new UpdateAccountRequest())).not.toContain("accountId");
+    });
+
+    it("cuando un campo opcional viene, se valida igual que en el alta", () => {
+        const dto = plainToInstance(UpdateAccountRequest, {
+            channel: "SWIFT",
+            account: "",
+            beneficiaryName: "N".repeat(41),
+            beneficiaryRfc: "CORTO",
+            bankName: "B".repeat(61),
+            currency: "MX",
+            enabled: "si",
+        });
+        const props = propertiesWithErrors(dto);
+        for (const campo of ["channel", "account", "beneficiaryName", "beneficiaryRfc", "bankName", "currency", "enabled"]) {
+            expect(props).toContain(campo);
+        }
+    });
+});
+
+describe("DTOs de respuesta de cuentas", () => {
+    it("AccountResponse es instanciable y lleva la CLABE sin enmascarar", () => {
+        const response = plainToInstance(AccountResponse, {
+            ...CUENTA_COMPLETA,
+            createdBy: "system",
+            updatedBy: "system",
+            createdAt: 1_758_000_000_000,
+            updatedAt: 1_758_000_000_000,
+        });
+        expect(response).toBeInstanceOf(AccountResponse);
+        expect(response.account).toBe(CUENTA_COMPLETA.account);
+        expect(response.channel).toBe(TransferChannelEnum.SPEI);
+    });
+
+    it("AccountListResponse anida AccountResponse y nextToken es opcional", () => {
+        const page = plainToInstance(AccountListResponse, { items: [] });
+        expect(page).toBeInstanceOf(AccountListResponse);
+        expect(page.items).toEqual([]);
+        expect(page.nextToken).toBeUndefined();
+    });
+
+    it("AccountImpactResponse (DEC-050) lleva los 4 contadores del impacto", () => {
+        const impact = plainToInstance(AccountImpactResponse, {
+            products: 2,
+            pendingDetails: 7,
+            pendingAmount: 1500,
+            pendingSettlements: 1,
+        });
+        expect(impact).toBeInstanceOf(AccountImpactResponse);
+        expect(impact.products).toBe(2);
+        expect(impact.pendingDetails).toBe(7);
+        expect(impact.pendingAmount).toBe(1500);
+        expect(impact.pendingSettlements).toBe(1);
+    });
+
+    it("AccountWithImpactResponse compone cuenta + impacto", () => {
+        const dto = plainToInstance(AccountWithImpactResponse, {
+            account: { ...CUENTA_COMPLETA, createdBy: "system", updatedBy: "system", createdAt: 1, updatedAt: 2 },
+            impact: { products: 0, pendingDetails: 0, pendingAmount: 0, pendingSettlements: 0 },
+        });
+        expect(dto).toBeInstanceOf(AccountWithImpactResponse);
+        expect(dto.account.accountId).toBe("ACC-BANORTE-01");
+        expect(dto.impact.products).toBe(0);
+    });
+});
+
+describe("Campos nuevos en los DTOs de respuesta existentes", () => {
+    it("DEC-044: SettlementResponse lleva sentToAccount, opcional", () => {
+        const conCuenta = plainToInstance(SettlementResponse, { sentToAccount: "072180000123456789" });
+        expect(conCuenta.sentToAccount).toBe("072180000123456789");
+        expect(plainToInstance(SettlementResponse, {}).sentToAccount).toBeUndefined();
+    });
+
+    it("DEC-051: TransactionDetailResponse lleva blockedByAccount, opcional", () => {
+        expect(plainToInstance(TransactionDetailResponse, { blockedByAccount: true }).blockedByAccount).toBe(true);
+        expect(plainToInstance(TransactionDetailResponse, {}).blockedByAccount).toBeUndefined();
+    });
+
+    it("PendingDetailsResponse propaga blockedByAccount vía sus items (F9)", () => {
+        const page = plainToInstance(PendingDetailsResponse, {
+            items: [{ transactionNumber: "T-1", blockedByAccount: true }],
+            count: 1,
+            totalAmount: 100,
+        });
+        expect(page).toBeInstanceOf(PendingDetailsResponse);
+        expect(page.items[0].blockedByAccount).toBe(true);
+    });
+});

package/_test_/unit/moneyTransfer/dtos.test.ts

@@ -22,7 +22,7 @@ const propertiesWithErrors = (dto: object) => validateSync(dto).map((error) => e
 const VALID_UUID = "3f6c2c5e-8b1a-4f3e-9d2a-1c4b5e6f7a8b";
 
 const PRODUCTO_COMPLETO = {
-    idProducto: "SPEI-BATCH-001",
+    idProducto: "ACC-BANORTE-01",
     producto: "Dispersión SPEI en lote",
     precio: 0,
     amountType: AmountTypeEnum.VARIABLE,
@@ -39,8 +39,6 @@ const PRODUCTO_COMPLETO = {
     enabled: true,
     channel: TransferChannelEnum.SPEI,
     settlementMode: SettlementModeEnum.BATCH,
-    beneficiaryName: "ACME SA DE CV",
-    beneficiaryRfc: "ACM010101AB1",
     minAmount: 1,
     maxAmount: 50000,
     batchSchedule: { cron: "0 18 * * 1-5", timezone: "America/Mexico_City" },
@@ -131,15 +129,27 @@ describe("MoneyTransferProductRequest", () => {
         expect(propertiesWithErrors(dto)).toContain("batchSchedule");
     });
 
-    it("rechaza beneficiaryRfc fuera de 12-13 chars y beneficiaryName > 40", () => {
+    it("DEC-046: ignora beneficiaryName/beneficiaryRfc, que ya no son del producto", () => {
         const dto = plainToInstance(MoneyTransferProductRequest, {
             ...PRODUCTO_COMPLETO,
             beneficiaryRfc: "CORTO",
             beneficiaryName: "N".repeat(41),
         });
-        const props = propertiesWithErrors(dto);
-        expect(props).toContain("beneficiaryRfc");
-        expect(props).toContain("beneficiaryName");
+        expect(validateSync(dto)).toHaveLength(0);
+    });
+
+    it("DEC-041: idProducto acepta un accountId de hasta 64 chars y rechaza 65", () => {
+        const enElLimite = plainToInstance(MoneyTransferProductRequest, {
+            ...PRODUCTO_COMPLETO,
+            idProducto: "A".repeat(64),
+        });
+        expect(validateSync(enElLimite)).toHaveLength(0);
+
+        const pasado = plainToInstance(MoneyTransferProductRequest, {
+            ...PRODUCTO_COMPLETO,
+            idProducto: "A".repeat(65),
+        });
+        expect(propertiesWithErrors(pasado)).toContain("idProducto");
     });
 
     it("rechaza channel y settlementMode fuera de sus enums", () => {
@@ -175,7 +185,7 @@ describe("MoneyTransferServiceCreateRequest", () => {
         const nested = listError!.children?.[0]?.children?.map((child) => child.property) ?? [];
         expect(nested).toContain("producto");
         expect(nested).toContain("channel");
-        expect(nested).toContain("beneficiaryName");
+        expect(nested).toContain("settlementMode");
     });
 
     it("exige al menos un producto", () => {

package/bin/moneyTransfer/dtos/AccountImpactResponse.d.ts

@@ -0,0 +1,18 @@
+/**
+ * DEC-050: qué se rompe antes de romperlo. Deshabilitar o editar una cuenta NO bloquea aunque haya
+ * folios pendientes o liquidaciones en vuelo — pero el operador tiene que ver el número en el momento
+ * de apretar el botón, no descubrirlo después.
+ *
+ * `pendingSettlements` cuenta liquidaciones en estado NO terminal (CREATED, SCHEDULED, SENDING, FAILED):
+ * esas son las que todavía pueden salir al riel y por lo tanto resolverían la cuenta editada (DEC-042).
+ */
+export declare class AccountImpactResponse {
+    /** Productos del catálogo que referencian esta cuenta por `idProducto`. */
+    products: number;
+    /** Folios en `PENDING_SETTLEMENT` de esta cuenta (GSI `pendingProductId-createdAt-index`). */
+    pendingDetails: number;
+    /** Suma de los montos de esos folios. */
+    pendingAmount: number;
+    /** Liquidaciones en estado no terminal que todavía pueden salir al riel. */
+    pendingSettlements: number;
+}

package/bin/moneyTransfer/dtos/AccountImpactResponse.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountImpactResponse = void 0;
+/**
+ * DEC-050: qué se rompe antes de romperlo. Deshabilitar o editar una cuenta NO bloquea aunque haya
+ * folios pendientes o liquidaciones en vuelo — pero el operador tiene que ver el número en el momento
+ * de apretar el botón, no descubrirlo después.
+ *
+ * `pendingSettlements` cuenta liquidaciones en estado NO terminal (CREATED, SCHEDULED, SENDING, FAILED):
+ * esas son las que todavía pueden salir al riel y por lo tanto resolverían la cuenta editada (DEC-042).
+ */
+class AccountImpactResponse {
+}
+exports.AccountImpactResponse = AccountImpactResponse;

package/bin/moneyTransfer/dtos/AccountListResponse.d.ts

@@ -0,0 +1,6 @@
+import { AccountResponse } from "./AccountResponse";
+/** Página de cuentas de un tenant (GSI `tenantId-createdAt-index`). Paginada por cursor opaco. */
+export declare class AccountListResponse {
+    items: AccountResponse[];
+    nextToken?: string;
+}

package/bin/moneyTransfer/dtos/AccountListResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountListResponse = void 0;
+/** Página de cuentas de un tenant (GSI `tenantId-createdAt-index`). Paginada por cursor opaco. */
+class AccountListResponse {
+}
+exports.AccountListResponse = AccountListResponse;

package/bin/moneyTransfer/dtos/AccountResponse.d.ts

@@ -0,0 +1,23 @@
+import { TransferChannelEnum } from "../enums/TransferChannelEnum";
+/**
+ * Cuenta destino en la respuesta de backoffice. Sin decoradores `class-validator`: el consumidor la
+ * lee tal cual viene por la red. Timestamps en epoch ms.
+ *
+ * `account` (la CLABE) SÍ sale: el operador de backoffice necesita verla para conciliar contra el
+ * estado de cuenta del banco. El enmascarado aplica a los LOGS, no a esta respuesta autenticada.
+ */
+export declare class AccountResponse {
+    accountId: string;
+    tenantId: string;
+    channel: TransferChannelEnum;
+    account: string;
+    beneficiaryName: string;
+    beneficiaryRfc?: string;
+    bankName: string;
+    currency: string;
+    enabled: boolean;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: number;
+    updatedAt: number;
+}

package/bin/moneyTransfer/dtos/AccountResponse.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountResponse = void 0;
+/**
+ * Cuenta destino en la respuesta de backoffice. Sin decoradores `class-validator`: el consumidor la
+ * lee tal cual viene por la red. Timestamps en epoch ms.
+ *
+ * `account` (la CLABE) SÍ sale: el operador de backoffice necesita verla para conciliar contra el
+ * estado de cuenta del banco. El enmascarado aplica a los LOGS, no a esta respuesta autenticada.
+ */
+class AccountResponse {
+}
+exports.AccountResponse = AccountResponse;

package/bin/moneyTransfer/dtos/AccountWithImpactResponse.d.ts

@@ -0,0 +1,11 @@
+import { AccountImpactResponse } from "./AccountImpactResponse";
+import { AccountResponse } from "./AccountResponse";
+/**
+ * Respuesta del `PUT /backoffice/accounts/{accountId}` (DEC-050): la cuenta ya editada, más el impacto
+ * que esa edición tiene. Se devuelve el impacto incluso cuando el operador no consultó
+ * `/impact` antes, que es el caso que hay que cubrir.
+ */
+export declare class AccountWithImpactResponse {
+    account: AccountResponse;
+    impact: AccountImpactResponse;
+}

package/bin/moneyTransfer/dtos/AccountWithImpactResponse.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountWithImpactResponse = void 0;
+/**
+ * Respuesta del `PUT /backoffice/accounts/{accountId}` (DEC-050): la cuenta ya editada, más el impacto
+ * que esa edición tiene. Se devuelve el impacto incluso cuando el operador no consultó
+ * `/impact` antes, que es el caso que hay que cubrir.
+ */
+class AccountWithImpactResponse {
+}
+exports.AccountWithImpactResponse = AccountWithImpactResponse;

package/bin/moneyTransfer/dtos/CreateAccountRequest.d.ts

@@ -0,0 +1,27 @@
+import { TransferChannelEnum } from "../enums/TransferChannelEnum";
+/**
+ * Alta de una cuenta destino (DEC-041). La cuenta vive en `MoneyTransferAccount_GT` y el producto
+ * del catálogo la referencia por `accountId`; el número de cuenta (CLABE en SPEI) es el ÚNICO campo
+ * que cambia cuando el tercero cambia de banco.
+ *
+ * Sin `idempotencyKey` a propósito: el alta ya tiene llave natural (`accountId` repetido → 409) y no
+ * mueve dinero ni lotes, así que el doble click no puede duplicar nada.
+ */
+export declare class CreateAccountRequest {
+    /** Identificador estable y legible, p. ej. `ACC-BANORTE-01`. Es la PK de la tabla. */
+    accountId: string;
+    /** DEC-034: tenant (partner) dueño de la cuenta; = subcategoría del servicio. */
+    tenantId: string;
+    channel: TransferChannelEnum;
+    /** Número de cuenta del riel: CLABE de 18 dígitos en SPEI. El conector lo valida por canal (DEC-053). */
+    account: string;
+    /** Nombre del titular tal como viaja al riel (SPEI acepta máx. 40 chars). */
+    beneficiaryName: string;
+    /** RFC del titular: 12 chars persona moral, 13 persona física. */
+    beneficiaryRfc?: string;
+    /** Nombre del banco, para que el operador reconozca la cuenta en backoffice. */
+    bankName: string;
+    /** ISO 4217 (`MXN`, `USD`). */
+    currency: string;
+    enabled: boolean;
+}

package/bin/moneyTransfer/dtos/CreateAccountRequest.js

@@ -0,0 +1,75 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateAccountRequest = void 0;
+const class_validator_1 = require("class-validator");
+const TransferChannelEnum_1 = require("../enums/TransferChannelEnum");
+/**
+ * Alta de una cuenta destino (DEC-041). La cuenta vive en `MoneyTransferAccount_GT` y el producto
+ * del catálogo la referencia por `accountId`; el número de cuenta (CLABE en SPEI) es el ÚNICO campo
+ * que cambia cuando el tercero cambia de banco.
+ *
+ * Sin `idempotencyKey` a propósito: el alta ya tiene llave natural (`accountId` repetido → 409) y no
+ * mueve dinero ni lotes, así que el doble click no puede duplicar nada.
+ */
+class CreateAccountRequest {
+}
+exports.CreateAccountRequest = CreateAccountRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    (0, class_validator_1.Matches)(/^[A-Z0-9][A-Z0-9-]*$/, { message: "accountId debe ser mayúsculas, dígitos y guiones" }),
+    __metadata("design:type", String)
+], CreateAccountRequest.prototype, "accountId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CreateAccountRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(TransferChannelEnum_1.TransferChannelEnum),
+    __metadata("design:type", String)
+], CreateAccountRequest.prototype, "channel", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(34),
+    __metadata("design:type", String)
+], CreateAccountRequest.prototype, "account", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(40),
+    __metadata("design:type", String)
+], CreateAccountRequest.prototype, "beneficiaryName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(12, 13),
+    __metadata("design:type", String)
+], CreateAccountRequest.prototype, "beneficiaryRfc", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(60),
+    __metadata("design:type", String)
+], CreateAccountRequest.prototype, "bankName", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 3),
+    __metadata("design:type", String)
+], CreateAccountRequest.prototype, "currency", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CreateAccountRequest.prototype, "enabled", void 0);

package/bin/moneyTransfer/dtos/MoneyTransferProductRequest.d.ts

@@ -6,9 +6,14 @@ import { BatchScheduleRequest } from "./BatchScheduleRequest";
 /**
  * Producto de un servicio de transferencia de dinero (Centro de Beneficios). Los campos en
  * español espejan el catálogo legacy de pago de servicios; los campos en inglés son la
- * configuración propia del riel (canal, modo de liquidación, beneficiario, lote).
+ * configuración propia del riel (canal, modo de liquidación, lote). El beneficiario ya no vive
+ * acá: se mudó a la cuenta destino (DEC-046).
  */
 export declare class MoneyTransferProductRequest {
+    /**
+     * DEC-041: `idProducto` es el `accountId` de la cuenta destino (`ACC-BANORTE-01`), NO la CLABE.
+     * La CLABE vive en `MoneyTransferAccount_GT` y se resuelve al pagar (F1) y al enviar (F4).
+     */
     idProducto: string;
     producto: string;
     precio: number;
@@ -26,10 +31,6 @@ export declare class MoneyTransferProductRequest {
     enabled: boolean;
     channel: TransferChannelEnum;
     settlementMode: SettlementModeEnum;
-    /** Nombre del beneficiario tal como viaja al riel (SPEI acepta máx. 40 chars). */
-    beneficiaryName: string;
-    /** RFC del beneficiario: 12 chars persona moral, 13 persona física. */
-    beneficiaryRfc?: string;
     minAmount?: number;
     maxAmount?: number;
     /** Requerido operativamente cuando `settlementMode = BATCH`; lo valida el conector. */

package/bin/moneyTransfer/dtos/MoneyTransferProductRequest.js

@@ -20,7 +20,8 @@ const BatchScheduleRequest_1 = require("./BatchScheduleRequest");
 /**
  * Producto de un servicio de transferencia de dinero (Centro de Beneficios). Los campos en
  * español espejan el catálogo legacy de pago de servicios; los campos en inglés son la
- * configuración propia del riel (canal, modo de liquidación, beneficiario, lote).
+ * configuración propia del riel (canal, modo de liquidación, lote). El beneficiario ya no vive
+ * acá: se mudó a la cuenta destino (DEC-046).
  */
 class MoneyTransferProductRequest {
 }
@@ -28,7 +29,7 @@ exports.MoneyTransferProductRequest = MoneyTransferProductRequest;
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
-    (0, class_validator_1.MaxLength)(34),
+    (0, class_validator_1.MaxLength)(64),
     __metadata("design:type", String)
 ], MoneyTransferProductRequest.prototype, "idProducto", void 0);
 __decorate([
@@ -99,18 +100,6 @@ __decorate([
     (0, class_validator_1.IsEnum)(SettlementModeEnum_1.SettlementModeEnum),
     __metadata("design:type", String)
 ], MoneyTransferProductRequest.prototype, "settlementMode", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    (0, class_validator_1.MaxLength)(40),
-    __metadata("design:type", String)
-], MoneyTransferProductRequest.prototype, "beneficiaryName", void 0);
-__decorate([
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.Length)(12, 13),
-    __metadata("design:type", String)
-], MoneyTransferProductRequest.prototype, "beneficiaryRfc", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsNumber)(),

package/bin/moneyTransfer/dtos/SettlementResponse.d.ts

@@ -19,6 +19,12 @@ export declare class SettlementResponse {
     scheduledAt?: number;
     /** Id de la transacción en el riel (ACH) o clave de rastreo (SPEI). */
     achTransactionId?: string;
+    /**
+     * DEC-044: cuenta (CLABE) a la que se INTENTÓ enviar este lote, escrita al tomar el lock `SENDING`.
+     * No significa "cuenta que recibió el dinero": la evidencia de dinero movido es este campo + un
+     * estado de la terna SENT/SETTLED/RETURNED + `achTransactionId`.
+     */
+    sentToAccount?: string;
     returnReason?: string;
     lastError?: string;
     /** `true` cuando el envío no obtuvo respuesta concluyente del riel (posible duplicado). */

package/bin/moneyTransfer/dtos/TransactionDetailResponse.d.ts

@@ -19,6 +19,13 @@ export declare class TransactionDetailResponse {
     status: TransactionDetailStatusEnum;
     /** Presente cuando el folio ya fue agrupado en una liquidación. */
     settlementId?: string;
+    /**
+     * DEC-051: `true` cuando la cuenta de este folio no existe o está deshabilitada. El folio se queda
+     * en `PENDING_SETTLEMENT` (DEC-048) y no puede liquidarse hasta que operaciones arregle la cuenta;
+     * sin esta marca quedaría invisible en la cola y se descubriría cuando el usuario reclame.
+     * Solo lo calcula el listado de pendientes de backoffice (F9); en otros contextos viene ausente.
+     */
+    blockedByAccount?: boolean;
     /** Epoch ms. */
     createdAt: number;
 }

package/bin/moneyTransfer/dtos/UpdateAccountRequest.d.ts

@@ -0,0 +1,19 @@
+import { TransferChannelEnum } from "../enums/TransferChannelEnum";
+/**
+ * Edición de una cuenta destino (DEC-045: actualización en el mismo registro, sin versionado).
+ * Todos los campos son opcionales: se envía solo lo que cambia. `accountId` no está porque es la PK
+ * y viaja en el path. `enabled` se cambia acá, sin endpoint propio (evita duplicar la lógica de impacto).
+ *
+ * Sin `idempotencyKey`: la edición es idempotente por naturaleza (escribe el estado deseado).
+ */
+export declare class UpdateAccountRequest {
+    channel?: TransferChannelEnum;
+    /** El campo que hace útil todo este cambio: corregir el número no obliga a tocar ningún producto. */
+    account?: string;
+    beneficiaryName?: string;
+    beneficiaryRfc?: string;
+    bankName?: string;
+    currency?: string;
+    /** DEC-049: nunca se borra una cuenta, solo se deshabilita. */
+    enabled?: boolean;
+}

package/bin/moneyTransfer/dtos/UpdateAccountRequest.js

@@ -0,0 +1,67 @@
+"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;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateAccountRequest = void 0;
+const class_validator_1 = require("class-validator");
+const TransferChannelEnum_1 = require("../enums/TransferChannelEnum");
+/**
+ * Edición de una cuenta destino (DEC-045: actualización en el mismo registro, sin versionado).
+ * Todos los campos son opcionales: se envía solo lo que cambia. `accountId` no está porque es la PK
+ * y viaja en el path. `enabled` se cambia acá, sin endpoint propio (evita duplicar la lógica de impacto).
+ *
+ * Sin `idempotencyKey`: la edición es idempotente por naturaleza (escribe el estado deseado).
+ */
+class UpdateAccountRequest {
+}
+exports.UpdateAccountRequest = UpdateAccountRequest;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(TransferChannelEnum_1.TransferChannelEnum),
+    __metadata("design:type", String)
+], UpdateAccountRequest.prototype, "channel", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(34),
+    __metadata("design:type", String)
+], UpdateAccountRequest.prototype, "account", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(40),
+    __metadata("design:type", String)
+], UpdateAccountRequest.prototype, "beneficiaryName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(12, 13),
+    __metadata("design:type", String)
+], UpdateAccountRequest.prototype, "beneficiaryRfc", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(60),
+    __metadata("design:type", String)
+], UpdateAccountRequest.prototype, "bankName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 3),
+    __metadata("design:type", String)
+], UpdateAccountRequest.prototype, "currency", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateAccountRequest.prototype, "enabled", void 0);

package/bin/moneyTransfer/index.d.ts

@@ -11,7 +11,13 @@ export * from './dtos/MoneyTransferServiceUpdateRequest';
 export * from './dtos/CreateSettlementRequest';
 export * from './dtos/SettlementActionRequest';
 export * from './dtos/RescheduleSettlementRequest';
+export * from './dtos/CreateAccountRequest';
+export * from './dtos/UpdateAccountRequest';
 export * from './dtos/TransactionDetailResponse';
 export * from './dtos/SettlementResponse';
 export * from './dtos/PendingDetailsResponse';
 export * from './dtos/SettlementListResponse';
+export * from './dtos/AccountResponse';
+export * from './dtos/AccountListResponse';
+export * from './dtos/AccountImpactResponse';
+export * from './dtos/AccountWithImpactResponse';

package/bin/moneyTransfer/index.js

@@ -33,8 +33,14 @@ __exportStar(require("./dtos/MoneyTransferServiceUpdateRequest"), exports);
 __exportStar(require("./dtos/CreateSettlementRequest"), exports);
 __exportStar(require("./dtos/SettlementActionRequest"), exports);
 __exportStar(require("./dtos/RescheduleSettlementRequest"), exports);
+__exportStar(require("./dtos/CreateAccountRequest"), exports);
+__exportStar(require("./dtos/UpdateAccountRequest"), exports);
 //DTOs — responses
 __exportStar(require("./dtos/TransactionDetailResponse"), exports);
 __exportStar(require("./dtos/SettlementResponse"), exports);
 __exportStar(require("./dtos/PendingDetailsResponse"), exports);
 __exportStar(require("./dtos/SettlementListResponse"), exports);
+__exportStar(require("./dtos/AccountResponse"), exports);
+__exportStar(require("./dtos/AccountListResponse"), exports);
+__exportStar(require("./dtos/AccountImpactResponse"), exports);
+__exportStar(require("./dtos/AccountWithImpactResponse"), exports);

package/package.json

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

package/src/moneyTransfer/dtos/AccountImpactResponse.ts

@@ -0,0 +1,18 @@
+/**
+ * DEC-050: qué se rompe antes de romperlo. Deshabilitar o editar una cuenta NO bloquea aunque haya
+ * folios pendientes o liquidaciones en vuelo — pero el operador tiene que ver el número en el momento
+ * de apretar el botón, no descubrirlo después.
+ *
+ * `pendingSettlements` cuenta liquidaciones en estado NO terminal (CREATED, SCHEDULED, SENDING, FAILED):
+ * esas son las que todavía pueden salir al riel y por lo tanto resolverían la cuenta editada (DEC-042).
+ */
+export class AccountImpactResponse {
+    /** Productos del catálogo que referencian esta cuenta por `idProducto`. */
+    products!: number;
+    /** Folios en `PENDING_SETTLEMENT` de esta cuenta (GSI `pendingProductId-createdAt-index`). */
+    pendingDetails!: number;
+    /** Suma de los montos de esos folios. */
+    pendingAmount!: number;
+    /** Liquidaciones en estado no terminal que todavía pueden salir al riel. */
+    pendingSettlements!: number;
+}

package/src/moneyTransfer/dtos/AccountListResponse.ts

@@ -0,0 +1,7 @@
+import { AccountResponse } from "./AccountResponse";
+
+/** Página de cuentas de un tenant (GSI `tenantId-createdAt-index`). Paginada por cursor opaco. */
+export class AccountListResponse {
+    items!: AccountResponse[];
+    nextToken?: string;
+}

package/src/moneyTransfer/dtos/AccountResponse.ts

@@ -0,0 +1,24 @@
+import { TransferChannelEnum } from "../enums/TransferChannelEnum";
+
+/**
+ * Cuenta destino en la respuesta de backoffice. Sin decoradores `class-validator`: el consumidor la
+ * lee tal cual viene por la red. Timestamps en epoch ms.
+ *
+ * `account` (la CLABE) SÍ sale: el operador de backoffice necesita verla para conciliar contra el
+ * estado de cuenta del banco. El enmascarado aplica a los LOGS, no a esta respuesta autenticada.
+ */
+export class AccountResponse {
+    accountId!: string;
+    tenantId!: string;
+    channel!: TransferChannelEnum;
+    account!: string;
+    beneficiaryName!: string;
+    beneficiaryRfc?: string;
+    bankName!: string;
+    currency!: string;
+    enabled!: boolean;
+    createdBy!: string;
+    updatedBy!: string;
+    createdAt!: number;
+    updatedAt!: number;
+}

package/src/moneyTransfer/dtos/AccountWithImpactResponse.ts

@@ -0,0 +1,12 @@
+import { AccountImpactResponse } from "./AccountImpactResponse";
+import { AccountResponse } from "./AccountResponse";
+
+/**
+ * Respuesta del `PUT /backoffice/accounts/{accountId}` (DEC-050): la cuenta ya editada, más el impacto
+ * que esa edición tiene. Se devuelve el impacto incluso cuando el operador no consultó
+ * `/impact` antes, que es el caso que hay que cubrir.
+ */
+export class AccountWithImpactResponse {
+    account!: AccountResponse;
+    impact!: AccountImpactResponse;
+}

package/src/moneyTransfer/dtos/CreateAccountRequest.ts

@@ -0,0 +1,60 @@
+import { IsBoolean, IsEnum, IsNotEmpty, IsOptional, IsString, Length, Matches, MaxLength } from "class-validator";
+import { TransferChannelEnum } from "../enums/TransferChannelEnum";
+
+/**
+ * Alta de una cuenta destino (DEC-041). La cuenta vive en `MoneyTransferAccount_GT` y el producto
+ * del catálogo la referencia por `accountId`; el número de cuenta (CLABE en SPEI) es el ÚNICO campo
+ * que cambia cuando el tercero cambia de banco.
+ *
+ * Sin `idempotencyKey` a propósito: el alta ya tiene llave natural (`accountId` repetido → 409) y no
+ * mueve dinero ni lotes, así que el doble click no puede duplicar nada.
+ */
+export class CreateAccountRequest {
+    /** Identificador estable y legible, p. ej. `ACC-BANORTE-01`. Es la PK de la tabla. */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    @Matches(/^[A-Z0-9][A-Z0-9-]*$/, { message: "accountId debe ser mayúsculas, dígitos y guiones" })
+    accountId!: string;
+
+    /** DEC-034: tenant (partner) dueño de la cuenta; = subcategoría del servicio. */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    tenantId!: string;
+
+    @IsEnum(TransferChannelEnum)
+    channel!: TransferChannelEnum;
+
+    /** Número de cuenta del riel: CLABE de 18 dígitos en SPEI. El conector lo valida por canal (DEC-053). */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(34)
+    account!: string;
+
+    /** Nombre del titular tal como viaja al riel (SPEI acepta máx. 40 chars). */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(40)
+    beneficiaryName!: string;
+
+    /** RFC del titular: 12 chars persona moral, 13 persona física. */
+    @IsOptional()
+    @IsString()
+    @Length(12, 13)
+    beneficiaryRfc?: string;
+
+    /** Nombre del banco, para que el operador reconozca la cuenta en backoffice. */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(60)
+    bankName!: string;
+
+    /** ISO 4217 (`MXN`, `USD`). */
+    @IsString()
+    @Length(3, 3)
+    currency!: string;
+
+    @IsBoolean()
+    enabled!: boolean;
+}

package/src/moneyTransfer/dtos/MoneyTransferProductRequest.ts

@@ -7,7 +7,6 @@ import {
     IsNumber,
     IsOptional,
     IsString,
-    Length,
     MaxLength,
     Min,
     ValidateNested,
@@ -21,12 +20,17 @@ import { BatchScheduleRequest } from "./BatchScheduleRequest";
 /**
  * Producto de un servicio de transferencia de dinero (Centro de Beneficios). Los campos en
  * español espejan el catálogo legacy de pago de servicios; los campos en inglés son la
- * configuración propia del riel (canal, modo de liquidación, beneficiario, lote).
+ * configuración propia del riel (canal, modo de liquidación, lote). El beneficiario ya no vive
+ * acá: se mudó a la cuenta destino (DEC-046).
  */
 export class MoneyTransferProductRequest {
+    /**
+     * DEC-041: `idProducto` es el `accountId` de la cuenta destino (`ACC-BANORTE-01`), NO la CLABE.
+     * La CLABE vive en `MoneyTransferAccount_GT` y se resuelve al pagar (F1) y al enviar (F4).
+     */
     @IsString()
     @IsNotEmpty()
-    @MaxLength(34)
+    @MaxLength(64)
     idProducto!: string;
 
     @IsString()
@@ -81,17 +85,9 @@ export class MoneyTransferProductRequest {
     @IsEnum(SettlementModeEnum)
     settlementMode!: SettlementModeEnum;
 
-    /** Nombre del beneficiario tal como viaja al riel (SPEI acepta máx. 40 chars). */
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(40)
-    beneficiaryName!: string;
-
-    /** RFC del beneficiario: 12 chars persona moral, 13 persona física. */
-    @IsOptional()
-    @IsString()
-    @Length(12, 13)
-    beneficiaryRfc?: string;
+    // DEC-046: `beneficiaryName` y `beneficiaryRfc` se mudaron a la cuenta (`MoneyTransferAccount_GT`).
+    // Son atributos del titular de la cuenta, no del producto: tenerlos acá permitía que dos productos
+    // a la misma cuenta divergieran en el titular sin que nada lo impidiera.
 
     @IsOptional()
     @IsNumber()

package/src/moneyTransfer/dtos/SettlementResponse.ts

@@ -20,6 +20,12 @@ export class SettlementResponse {
     scheduledAt?: number;
     /** Id de la transacción en el riel (ACH) o clave de rastreo (SPEI). */
     achTransactionId?: string;
+    /**
+     * DEC-044: cuenta (CLABE) a la que se INTENTÓ enviar este lote, escrita al tomar el lock `SENDING`.
+     * No significa "cuenta que recibió el dinero": la evidencia de dinero movido es este campo + un
+     * estado de la terna SENT/SETTLED/RETURNED + `achTransactionId`.
+     */
+    sentToAccount?: string;
     returnReason?: string;
     lastError?: string;
     /** `true` cuando el envío no obtuvo respuesta concluyente del riel (posible duplicado). */

package/src/moneyTransfer/dtos/TransactionDetailResponse.ts

@@ -20,6 +20,13 @@ export class TransactionDetailResponse {
     status!: TransactionDetailStatusEnum;
     /** Presente cuando el folio ya fue agrupado en una liquidación. */
     settlementId?: string;
+    /**
+     * DEC-051: `true` cuando la cuenta de este folio no existe o está deshabilitada. El folio se queda
+     * en `PENDING_SETTLEMENT` (DEC-048) y no puede liquidarse hasta que operaciones arregle la cuenta;
+     * sin esta marca quedaría invisible en la cola y se descubriría cuando el usuario reclame.
+     * Solo lo calcula el listado de pendientes de backoffice (F9); en otros contextos viene ausente.
+     */
+    blockedByAccount?: boolean;
     /** Epoch ms. */
     createdAt!: number;
 }

package/src/moneyTransfer/dtos/UpdateAccountRequest.ts

@@ -0,0 +1,49 @@
+import { IsBoolean, IsEnum, IsNotEmpty, IsOptional, IsString, Length, MaxLength } from "class-validator";
+import { TransferChannelEnum } from "../enums/TransferChannelEnum";
+
+/**
+ * Edición de una cuenta destino (DEC-045: actualización en el mismo registro, sin versionado).
+ * Todos los campos son opcionales: se envía solo lo que cambia. `accountId` no está porque es la PK
+ * y viaja en el path. `enabled` se cambia acá, sin endpoint propio (evita duplicar la lógica de impacto).
+ *
+ * Sin `idempotencyKey`: la edición es idempotente por naturaleza (escribe el estado deseado).
+ */
+export class UpdateAccountRequest {
+    @IsOptional()
+    @IsEnum(TransferChannelEnum)
+    channel?: TransferChannelEnum;
+
+    /** El campo que hace útil todo este cambio: corregir el número no obliga a tocar ningún producto. */
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(34)
+    account?: string;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(40)
+    beneficiaryName?: string;
+
+    @IsOptional()
+    @IsString()
+    @Length(12, 13)
+    beneficiaryRfc?: string;
+
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(60)
+    bankName?: string;
+
+    @IsOptional()
+    @IsString()
+    @Length(3, 3)
+    currency?: string;
+
+    /** DEC-049: nunca se borra una cuenta, solo se deshabilita. */
+    @IsOptional()
+    @IsBoolean()
+    enabled?: boolean;
+}

package/src/moneyTransfer/index.ts

@@ -19,9 +19,15 @@ export * from './dtos/MoneyTransferServiceUpdateRequest';
 export * from './dtos/CreateSettlementRequest';
 export * from './dtos/SettlementActionRequest';
 export * from './dtos/RescheduleSettlementRequest';
+export * from './dtos/CreateAccountRequest';
+export * from './dtos/UpdateAccountRequest';
 
 //DTOs — responses
 export * from './dtos/TransactionDetailResponse';
 export * from './dtos/SettlementResponse';
 export * from './dtos/PendingDetailsResponse';
 export * from './dtos/SettlementListResponse';
+export * from './dtos/AccountResponse';
+export * from './dtos/AccountListResponse';
+export * from './dtos/AccountImpactResponse';
+export * from './dtos/AccountWithImpactResponse';