@fiado/type-kit 3.617.0 → 3.619.0

package/_test_/unit/account/BankAccountMCSendTransfer.test.ts

@@ -0,0 +1,43 @@
+import 'reflect-metadata';
+import { BankAccountMCSendTransferRequest, BankAccountMCSendTransferResponse } from '../../../src/account/index';
+import { TransactionStatusEnum } from '../../../src/transaction';
+
+/**
+ * MC Send directo a una tarjeta del programa (CARD_PUSH_FUNDS): el request admite el cd_ del
+ * beneficiario y entonces email y teléfono dejan de ser obligatorios; la respuesta expone el id
+ * de la network transfer de CP (mt_) además de los tx_.
+ */
+describe('BankAccountMCSendTransferRequest', () => {
+  it('acepta un push directo a tarjeta sin email ni teléfono del beneficiario', () => {
+    const request: BankAccountMCSendTransferRequest = {
+      transactionNumber: 'T1',
+      amount: 1,
+      externalAccountId: 'cd_origen',
+      beneficiaryExternalAccountId: 'cd_destino',
+    };
+    expect(request.beneficiaryExternalAccountId).toBe('cd_destino');
+    expect(request.beneficiaryEmail).toBeUndefined();
+  });
+
+  it('sigue aceptando la intención por email y teléfono', () => {
+    const request: BankAccountMCSendTransferRequest = {
+      transactionNumber: 'T2',
+      amount: 1,
+      beneficiaryEmail: 'a@b.com',
+      beneficiaryPhoneNumber: '3055550100',
+    };
+    expect(request.beneficiaryExternalAccountId).toBeUndefined();
+  });
+});
+
+describe('BankAccountMCSendTransferResponse', () => {
+  it('expone externalTransferId (mt_) junto a externalTransactionId (tx_)', () => {
+    const response: BankAccountMCSendTransferResponse = {
+      externalTransactionId: 'tx_1|tx_2',
+      externalTransferId: 'mt_1',
+      transactionStatus: TransactionStatusEnum.COMPLETED,
+      transactionNumber: 'T1',
+    };
+    expect(response.externalTransferId).toBe('mt_1');
+  });
+});

package/_test_/unit/collection/authorizeCollectionMovementRequest.test.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { AuthorizeCollectionMovementRequest } from '../../../src/collection/index';
+
+const VALID = {
+    executionId: 'exec-1',
+    directoryId: 'dir-1',
+    provider: 'wallet',
+    mechanism: 'MXN_DIRECT',
+    amount: 100,
+    currencyId: 'MXN',
+};
+
+async function invalidProperties(body: Record<string, unknown>): Promise<string[]> {
+    const dto = plainToInstance(AuthorizeCollectionMovementRequest, body);
+    return (await validate(dto as object)).map((e) => e.property);
+}
+
+describe('AuthorizeCollectionMovementRequest.tenantId', () => {
+    it('acepta el request sin tenantId', async () => {
+        expect(await invalidProperties(VALID)).toEqual([]);
+    });
+
+    it('acepta el tenant SOFOM del intento de cobro', async () => {
+        expect(await invalidProperties({ ...VALID, tenantId: 'surekeep' })).toEqual([]);
+    });
+
+    it('rechaza tenantId vacío o no string', async () => {
+        expect(await invalidProperties({ ...VALID, tenantId: '' })).toEqual(['tenantId']);
+        expect(await invalidProperties({ ...VALID, tenantId: 42 })).toEqual(['tenantId']);
+    });
+});

package/_test_/unit/reconciliation/reconciliationCatalogs.test.ts

@@ -106,6 +106,15 @@ describe('catálogos de reconciliation', () => {
         expect(RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND]).toBe(404);
     });
 
+    it('codes del feed genérico con su status', () => {
+        expect(Object.values(ReconciliationFeedErrorCodeEnum).sort()).toEqual(
+            ['FEED_CONCEPT_NOT_SUPPORTED', 'FEED_RECORD_NOT_FOUND', 'FEED_SOURCE_UNAVAILABLE', 'INVALID_FEED_QUERY'],
+        );
+        expect(RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum.FEED_CONCEPT_NOT_SUPPORTED]).toBe(400);
+        expect(RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum.INVALID_FEED_QUERY]).toBe(400);
+        expect(RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum.FEED_SOURCE_UNAVAILABLE]).toBe(502);
+    });
+
     it('nombres de los eventos que publica y consume el motor', () => {
         expect(RECONCILIATION_EVENTS_SOURCE).toBe('fiado.reconciliation');
         expect(ReconciliationEventDetailTypeEnum.RECONCILIATION_ITEM_MATCHED).toBe('reconciliation.ReconciliationItemMatched');

package/bin/account/dtos/BankAccountMCSendTransferRequest.d.ts

@@ -1,10 +1,16 @@
 export declare class BankAccountMCSendTransferRequest {
     transactionNumber: string;
     amount: number;
-    beneficiaryEmail: string;
-    beneficiaryPhoneNumber: string;
+    /** Intención por email/teléfono: obligatorios salvo que venga beneficiaryExternalAccountId. */
+    beneficiaryEmail?: string;
+    beneficiaryPhoneNumber?: string;
     beneficiaryName?: string;
     beneficiaryLastName?: string;
     concept?: string;
     externalAccountId?: string;
+    /**
+     * Push directo a una tarjeta del mismo programa (CARD_PUSH_FUNDS): cd_ de la tarjeta del
+     * beneficiario, usuario de Fiado. Si viene, CP acredita en la misma llamada sin intención.
+     */
+    beneficiaryExternalAccountId?: string;
 }

package/bin/account/dtos/BankAccountMCSendTransferResponse.d.ts

@@ -1,6 +1,9 @@
 import { TransactionStatusEnum } from "../../transaction";
 export declare class BankAccountMCSendTransferResponse {
+    /** Ids tx_ de los movimientos contables en CP, unidos por "|". */
     externalTransactionId: string;
+    /** Id mt_ de la network transfer en CP: sirve para consultar, cancelar o auditar el envío. */
+    externalTransferId?: string;
     transactionStatus: TransactionStatusEnum;
     transactionNumber: string;
 }

package/bin/collection/dtos/AuthorizeCollectionMovementRequest.d.ts

@@ -11,6 +11,7 @@ export declare class AuthorizeCollectionMovementRequest {
     intentId?: string;
     chargeId?: string;
     holdTxId?: string;
+    tenantId?: string;
     /**
      * Tarifa con la que se registra el cobro. Presente, el movimiento deja además una transacción
      * Fiado: asiento contable, historial visible para el cliente y comisión declarada. Ausente, el

package/bin/collection/dtos/AuthorizeCollectionMovementRequest.js

@@ -57,6 +57,12 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], AuthorizeCollectionMovementRequest.prototype, "holdTxId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "tenantId", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),

package/bin/reconciliation/constants/reconciliationErrorHttpStatus.d.ts

@@ -1,6 +1,10 @@
 import { ReconciliationErrorCodeEnum as C } from '../enums/ReconciliationErrorCodeEnum';
-import { ReconciliationFeedErrorCodeEnum } from '../enums/ReconciliationFeedErrorCodeEnum';
 /** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio · 502 falló el dueño del dinero. */
 export declare const RECONCILIATION_ERROR_HTTP_STATUS: Readonly<Record<C, 404 | 409 | 422 | 502>>;
-/** Status HTTP de los codes del feed genérico. */
-export declare const RECONCILIATION_FEED_ERROR_HTTP_STATUS: Readonly<Record<ReconciliationFeedErrorCodeEnum, 404>>;
+/** Status HTTP de los codes del feed genérico: 400 request inválido · 404 no existe · 502 falló la fuente. */
+export declare const RECONCILIATION_FEED_ERROR_HTTP_STATUS: {
+    readonly FEED_RECORD_NOT_FOUND: 404;
+    readonly FEED_CONCEPT_NOT_SUPPORTED: 400;
+    readonly INVALID_FEED_QUERY: 400;
+    readonly FEED_SOURCE_UNAVAILABLE: 502;
+};

package/bin/reconciliation/constants/reconciliationErrorHttpStatus.js

@@ -17,7 +17,10 @@ exports.RECONCILIATION_ERROR_HTTP_STATUS = {
     [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ITEM_ADJUSTED]: 409,
     [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.AUTHOR_NOT_ALLOWED]: 422,
 };
-/** Status HTTP de los codes del feed genérico. */
+/** Status HTTP de los codes del feed genérico: 400 request inválido · 404 no existe · 502 falló la fuente. */
 exports.RECONCILIATION_FEED_ERROR_HTTP_STATUS = {
     [ReconciliationFeedErrorCodeEnum_1.ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND]: 404,
+    [ReconciliationFeedErrorCodeEnum_1.ReconciliationFeedErrorCodeEnum.FEED_CONCEPT_NOT_SUPPORTED]: 400,
+    [ReconciliationFeedErrorCodeEnum_1.ReconciliationFeedErrorCodeEnum.INVALID_FEED_QUERY]: 400,
+    [ReconciliationFeedErrorCodeEnum_1.ReconciliationFeedErrorCodeEnum.FEED_SOURCE_UNAVAILABLE]: 502,
 };

package/bin/reconciliation/enums/ReconciliationFeedErrorCodeEnum.d.ts

@@ -1,4 +1,7 @@
 /** Codes del feed genérico que implementa cada dueño del dato. */
 export declare enum ReconciliationFeedErrorCodeEnum {
-    FEED_RECORD_NOT_FOUND = "FEED_RECORD_NOT_FOUND"
+    FEED_RECORD_NOT_FOUND = "FEED_RECORD_NOT_FOUND",
+    FEED_CONCEPT_NOT_SUPPORTED = "FEED_CONCEPT_NOT_SUPPORTED",
+    INVALID_FEED_QUERY = "INVALID_FEED_QUERY",
+    FEED_SOURCE_UNAVAILABLE = "FEED_SOURCE_UNAVAILABLE"
 }

package/bin/reconciliation/enums/ReconciliationFeedErrorCodeEnum.js

@@ -5,4 +5,7 @@ exports.ReconciliationFeedErrorCodeEnum = void 0;
 var ReconciliationFeedErrorCodeEnum;
 (function (ReconciliationFeedErrorCodeEnum) {
     ReconciliationFeedErrorCodeEnum["FEED_RECORD_NOT_FOUND"] = "FEED_RECORD_NOT_FOUND";
+    ReconciliationFeedErrorCodeEnum["FEED_CONCEPT_NOT_SUPPORTED"] = "FEED_CONCEPT_NOT_SUPPORTED";
+    ReconciliationFeedErrorCodeEnum["INVALID_FEED_QUERY"] = "INVALID_FEED_QUERY";
+    ReconciliationFeedErrorCodeEnum["FEED_SOURCE_UNAVAILABLE"] = "FEED_SOURCE_UNAVAILABLE";
 })(ReconciliationFeedErrorCodeEnum || (exports.ReconciliationFeedErrorCodeEnum = ReconciliationFeedErrorCodeEnum = {}));

package/package.json

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

package/src/account/dtos/BankAccountMCSendTransferRequest.ts

@@ -1,10 +1,16 @@
 export class BankAccountMCSendTransferRequest {
     transactionNumber!: string;
     amount!: number;
-    beneficiaryEmail!: string;
-    beneficiaryPhoneNumber!: string;
+    /** Intención por email/teléfono: obligatorios salvo que venga beneficiaryExternalAccountId. */
+    beneficiaryEmail?: string;
+    beneficiaryPhoneNumber?: string;
     beneficiaryName?: string;
     beneficiaryLastName?: string;
     concept?: string;
     externalAccountId?: string;
+    /**
+     * Push directo a una tarjeta del mismo programa (CARD_PUSH_FUNDS): cd_ de la tarjeta del
+     * beneficiario, usuario de Fiado. Si viene, CP acredita en la misma llamada sin intención.
+     */
+    beneficiaryExternalAccountId?: string;
 }

package/src/account/dtos/BankAccountMCSendTransferResponse.ts

@@ -1,7 +1,10 @@
 import { TransactionStatusEnum } from "../../transaction";
 
 export class BankAccountMCSendTransferResponse {
+    /** Ids tx_ de los movimientos contables en CP, unidos por "|". */
     externalTransactionId!: string;
+    /** Id mt_ de la network transfer en CP: sirve para consultar, cancelar o auditar el envío. */
+    externalTransferId?: string;
     transactionStatus!: TransactionStatusEnum;
     transactionNumber!: string;
 }

package/src/collection/dtos/AuthorizeCollectionMovementRequest.ts

@@ -1,4 +1,4 @@
-import { IsString, IsEnum, IsOptional, ValidateNested, IsNumber, IsBoolean } from 'class-validator';
+import { IsString, IsEnum, IsOptional, ValidateNested, IsNumber, IsBoolean, IsNotEmpty } from 'class-validator';
 import { Type } from 'class-transformer';
 import { MechanismType } from '../enums/MechanismType';
 import { CurrencyId } from '../../currency/enums/CurrencyId';
@@ -14,6 +14,8 @@ export class AuthorizeCollectionMovementRequest {
   @IsOptional() @IsString() intentId?: string;
   @IsOptional() @IsString() chargeId?: string;
   @IsOptional() @IsString() holdTxId?: string;
+  // Tenant SOFOM del intento de cobro; transaction-processor lo asienta como `sofomTenantId`.
+  @IsOptional() @IsString() @IsNotEmpty() tenantId?: string;
 
   /**
    * Tarifa con la que se registra el cobro. Presente, el movimiento deja además una transacción

package/src/reconciliation/constants/reconciliationErrorHttpStatus.ts

@@ -16,7 +16,10 @@ export const RECONCILIATION_ERROR_HTTP_STATUS: Readonly<Record<C, 404 | 409 | 42
     [C.AUTHOR_NOT_ALLOWED]: 422,
 };
 
-/** Status HTTP de los codes del feed genérico. */
-export const RECONCILIATION_FEED_ERROR_HTTP_STATUS: Readonly<Record<ReconciliationFeedErrorCodeEnum, 404>> = {
+/** Status HTTP de los codes del feed genérico: 400 request inválido · 404 no existe · 502 falló la fuente. */
+export const RECONCILIATION_FEED_ERROR_HTTP_STATUS = {
     [ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND]: 404,
-};
+    [ReconciliationFeedErrorCodeEnum.FEED_CONCEPT_NOT_SUPPORTED]: 400,
+    [ReconciliationFeedErrorCodeEnum.INVALID_FEED_QUERY]: 400,
+    [ReconciliationFeedErrorCodeEnum.FEED_SOURCE_UNAVAILABLE]: 502,
+} as const satisfies Readonly<Record<ReconciliationFeedErrorCodeEnum, 400 | 404 | 502>>;

package/src/reconciliation/enums/ReconciliationFeedErrorCodeEnum.ts

@@ -1,4 +1,7 @@
 /** Codes del feed genérico que implementa cada dueño del dato. */
 export enum ReconciliationFeedErrorCodeEnum {
     FEED_RECORD_NOT_FOUND = 'FEED_RECORD_NOT_FOUND',
+    FEED_CONCEPT_NOT_SUPPORTED = 'FEED_CONCEPT_NOT_SUPPORTED',
+    INVALID_FEED_QUERY = 'INVALID_FEED_QUERY',
+    FEED_SOURCE_UNAVAILABLE = 'FEED_SOURCE_UNAVAILABLE',
 }