@fiado/type-kit 3.57.1 → 3.59.0

package/_test_/unit/cognitoBackofficeConnector/dtos/VerifyPasswordResponse.test.ts

@@ -0,0 +1,32 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { VerifyPasswordResponse } from '../../../../src/cognitoBackofficeConnector/dtos/VerifyPasswordResponse';
+import { CognitoChallengeType } from '../../../../src/cognitoBackofficeConnector/enums/CognitoChallengeType';
+
+describe('VerifyPasswordResponse', () => {
+    it('solo valid (backward-compatible)', async () => {
+        const dto = plainToInstance(VerifyPasswordResponse, { valid: true });
+        expect(await validate(dto)).toEqual([]);
+    });
+
+    it('valid + challenge nativo NEW_PASSWORD_REQUIRED + session', async () => {
+        const dto = plainToInstance(VerifyPasswordResponse, {
+            valid: true,
+            challengeType: CognitoChallengeType.NEW_PASSWORD_REQUIRED,
+            session: 'sess-123',
+            challengeParameters: { USER_ID_FOR_SRP: 'sub' },
+        });
+        expect(await validate(dto)).toEqual([]);
+    });
+
+    it('falla si challengeType no es del enum', async () => {
+        const dto = plainToInstance(VerifyPasswordResponse, { valid: true, challengeType: 'BOGUS' });
+        expect((await validate(dto)).some(e => e.property === 'challengeType')).toBe(true);
+    });
+
+    it('falla si valid no es boolean', async () => {
+        const dto = plainToInstance(VerifyPasswordResponse, { valid: 'yes' });
+        expect((await validate(dto)).some(e => e.property === 'valid')).toBe(true);
+    });
+});

package/bin/cognitoBackofficeConnector/dtos/VerifyPasswordResponse.d.ts

@@ -1,3 +1,18 @@
+import { CognitoChallengeType } from '../enums/CognitoChallengeType';
+/**
+ * Respuesta de `POST /auth/verify-password`.
+ *
+ * `valid` es el único campo siempre presente (consumidores legacy hacen
+ * `const { valid } = ...`). Los campos opcionales surfacean el challenge nativo
+ * que `ADMIN_USER_PASSWORD_AUTH` devuelve sin throw: para un usuario en
+ * `FORCE_CHANGE_PASSWORD`, Cognito responde `ChallengeName:'NEW_PASSWORD_REQUIRED'`
+ * + `Session`, y el caller (rbac) los usa para emitir ese challenge nativo FUERA
+ * de CUSTOM_AUTH en vez de arrancar el MFA (F-12). Backward-compatible: todos los
+ * campos nuevos son opcionales.
+ */
 export declare class VerifyPasswordResponse {
     valid: boolean;
+    challengeType?: CognitoChallengeType;
+    session?: string;
+    challengeParameters?: Record<string, string>;
 }

package/bin/cognitoBackofficeConnector/dtos/VerifyPasswordResponse.js

@@ -12,6 +12,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VerifyPasswordResponse = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const CognitoChallengeType_1 = require("../enums/CognitoChallengeType");
+/**
+ * Respuesta de `POST /auth/verify-password`.
+ *
+ * `valid` es el único campo siempre presente (consumidores legacy hacen
+ * `const { valid } = ...`). Los campos opcionales surfacean el challenge nativo
+ * que `ADMIN_USER_PASSWORD_AUTH` devuelve sin throw: para un usuario en
+ * `FORCE_CHANGE_PASSWORD`, Cognito responde `ChallengeName:'NEW_PASSWORD_REQUIRED'`
+ * + `Session`, y el caller (rbac) los usa para emitir ese challenge nativo FUERA
+ * de CUSTOM_AUTH en vez de arrancar el MFA (F-12). Backward-compatible: todos los
+ * campos nuevos son opcionales.
+ */
 class VerifyPasswordResponse {
 }
 exports.VerifyPasswordResponse = VerifyPasswordResponse;
@@ -20,3 +32,21 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], VerifyPasswordResponse.prototype, "valid", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(CognitoChallengeType_1.CognitoChallengeType),
+    __metadata("design:type", String)
+], VerifyPasswordResponse.prototype, "challengeType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], VerifyPasswordResponse.prototype, "session", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], VerifyPasswordResponse.prototype, "challengeParameters", void 0);

package/bin/remittance/dtos/RemittanceConfirmRequest.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Sobre pre-armado por el backend (benefits) que el front reenvía **verbatim** al
+ * procesador `POST /benefitsMarketplace/authorize` para confirmar el envío (F6).
+ *
+ * Es un subconjunto de `AuthorizeBenefitsMarketplaceTransactionRequest`: el backend
+ * llena todo lo que deriva del corredor del beneficiario (`leafId`, `productId`,
+ * `amount`, ...) más la taxonomía del marketplace (`benefitId`, `productCatalogId`,
+ * `moduleName`). El front **solo agrega `inputs.idempotencyKey`** (que genera él, 1:1
+ * con el `previewRef`) antes de postear. El front NO debe construir ni decodificar
+ * ninguno de estos campos — los trata como tokens opacos.
+ */
+export interface RemittanceConfirmRequest {
+    /** Producto del catálogo del marketplace (ProductCatalog_GT). Constante para remesas: `INTERNATIONAL_REMITTANCE`. */
+    productCatalogId: string;
+    /** Benefit que aloja remesas en el árbol del marketplace (ej. `ben-7`). */
+    benefitId: string;
+    /** productId del corredor — monto libre (ej. `GT#GCA10#VAR`). */
+    productId: string;
+    /** Módulo conector que ejecuta el pago (`uniteller-connector`). */
+    moduleName: string;
+    /** leafId base64url del corredor: `base64url("<moduleName>::<countryISO>#<payerCode>#<receptionMethodName>")`. */
+    leafId: string;
+    /** Referencia del beneficiario destino (ej. `BENE#1884512`). */
+    reference: string;
+    /** Monto USD total **congelado** a debitar del wallet (== total del preview). */
+    amount: number;
+    /** Moneda de cobro en ISO numérico — siempre USD (`840`) para remesas. */
+    currencyId: string;
+    /** Datos específicos del módulo que el procesador reenvía al connector. */
+    inputs: RemittanceConfirmInputs;
+}
+export interface RemittanceConfirmInputs {
+    /** `transactionInternalReference` de UNIR (sale del preview). Requerido para el confirm. */
+    previewRef: string;
+    /**
+     * Idempotencia del tramo mobile→procesador. **Lo genera el front** en el tap de
+     * confirmar, 1:1 con el `previewRef`: si re-previewa, nuevo `previewRef` ⇒ nuevo
+     * `idempotencyKey`. El backend lo deja vacío en el sobre.
+     */
+    idempotencyKey?: string;
+}

package/bin/remittance/dtos/RemittanceConfirmRequest.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/remittance/dtos/RemittanceSendPreviewResponse.d.ts

@@ -1,3 +1,4 @@
+import { RemittanceConfirmRequest } from "./RemittanceConfirmRequest";
 export interface RemittanceBeneficiaryDisplay {
     name: string;
     bank?: string;
@@ -15,4 +16,18 @@ export declare class RemittanceSendPreviewResponse {
     beneficiaryDisplay: RemittanceBeneficiaryDisplay;
     /** Epoch ms. Cache 10 min en RemittanceCache_GT (D-F5.4). */
     expiresAt: number;
+    /**
+     * serviceId del corredor resuelto por el connector: `<countryISO>#<payerCode>#<receptionMethodName>`
+     * (ej. `GT#GCA10#Cash Pickup`). Insumo para que benefits codifique el `leafId`.
+     * Lo llena el connector; no es para consumo directo del front.
+     */
+    serviceId?: string;
+    /** productId del corredor (monto libre, ej. `GT#GCA10#VAR`). Lo llena el connector. */
+    productId?: string;
+    /**
+     * Sobre pre-armado por benefits que el front reenvía al procesador para confirmar (F6).
+     * Lo completa benefits (encode del `leafId` + taxonomía del marketplace); el connector
+     * lo deja vacío. Ver {@link RemittanceConfirmRequest}.
+     */
+    confirmRequest?: RemittanceConfirmRequest;
 }

package/bin/remittance/dtos/index.d.ts

@@ -10,6 +10,7 @@ export * from "./RemittanceQuoteRequest";
 export * from "./RemittanceQuoteResponse";
 export * from "./RemittanceSendPreviewRequest";
 export * from "./RemittanceSendPreviewResponse";
+export * from "./RemittanceConfirmRequest";
 export * from "./RemittancePayRequest";
 export * from "./RemittancePayResponse";
 export * from "./RemittanceTransaction";

package/bin/remittance/dtos/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./RemittanceQuoteRequest"), exports);
 __exportStar(require("./RemittanceQuoteResponse"), exports);
 __exportStar(require("./RemittanceSendPreviewRequest"), exports);
 __exportStar(require("./RemittanceSendPreviewResponse"), exports);
+__exportStar(require("./RemittanceConfirmRequest"), exports);
 __exportStar(require("./RemittancePayRequest"), exports);
 __exportStar(require("./RemittancePayResponse"), exports);
 __exportStar(require("./RemittanceTransaction"), exports);

package/package.json

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

package/src/cognitoBackofficeConnector/dtos/VerifyPasswordResponse.ts

@@ -1,6 +1,24 @@
-import { Expose } from 'class-transformer';
-import { IsBoolean } from 'class-validator';
-
-export class VerifyPasswordResponse {
-    @Expose() @IsBoolean() valid!: boolean;
-}
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsEnum, IsObject, IsOptional, IsString } from 'class-validator';
+import { CognitoChallengeType } from '../enums/CognitoChallengeType';
+
+/**
+ * Respuesta de `POST /auth/verify-password`.
+ *
+ * `valid` es el único campo siempre presente (consumidores legacy hacen
+ * `const { valid } = ...`). Los campos opcionales surfacean el challenge nativo
+ * que `ADMIN_USER_PASSWORD_AUTH` devuelve sin throw: para un usuario en
+ * `FORCE_CHANGE_PASSWORD`, Cognito responde `ChallengeName:'NEW_PASSWORD_REQUIRED'`
+ * + `Session`, y el caller (rbac) los usa para emitir ese challenge nativo FUERA
+ * de CUSTOM_AUTH en vez de arrancar el MFA (F-12). Backward-compatible: todos los
+ * campos nuevos son opcionales.
+ */
+export class VerifyPasswordResponse {
+    @Expose() @IsBoolean() valid!: boolean;
+
+    @Expose() @IsOptional() @IsEnum(CognitoChallengeType) challengeType?: CognitoChallengeType;
+
+    @Expose() @IsOptional() @IsString() session?: string;
+
+    @Expose() @IsOptional() @IsObject() challengeParameters?: Record<string, string>;
+}

package/src/remittance/dtos/RemittanceConfirmRequest.ts

@@ -0,0 +1,42 @@
+/**
+ * Sobre pre-armado por el backend (benefits) que el front reenvía **verbatim** al
+ * procesador `POST /benefitsMarketplace/authorize` para confirmar el envío (F6).
+ *
+ * Es un subconjunto de `AuthorizeBenefitsMarketplaceTransactionRequest`: el backend
+ * llena todo lo que deriva del corredor del beneficiario (`leafId`, `productId`,
+ * `amount`, ...) más la taxonomía del marketplace (`benefitId`, `productCatalogId`,
+ * `moduleName`). El front **solo agrega `inputs.idempotencyKey`** (que genera él, 1:1
+ * con el `previewRef`) antes de postear. El front NO debe construir ni decodificar
+ * ninguno de estos campos — los trata como tokens opacos.
+ */
+export interface RemittanceConfirmRequest {
+    /** Producto del catálogo del marketplace (ProductCatalog_GT). Constante para remesas: `INTERNATIONAL_REMITTANCE`. */
+    productCatalogId: string;
+    /** Benefit que aloja remesas en el árbol del marketplace (ej. `ben-7`). */
+    benefitId: string;
+    /** productId del corredor — monto libre (ej. `GT#GCA10#VAR`). */
+    productId: string;
+    /** Módulo conector que ejecuta el pago (`uniteller-connector`). */
+    moduleName: string;
+    /** leafId base64url del corredor: `base64url("<moduleName>::<countryISO>#<payerCode>#<receptionMethodName>")`. */
+    leafId: string;
+    /** Referencia del beneficiario destino (ej. `BENE#1884512`). */
+    reference: string;
+    /** Monto USD total **congelado** a debitar del wallet (== total del preview). */
+    amount: number;
+    /** Moneda de cobro en ISO numérico — siempre USD (`840`) para remesas. */
+    currencyId: string;
+    /** Datos específicos del módulo que el procesador reenvía al connector. */
+    inputs: RemittanceConfirmInputs;
+}
+
+export interface RemittanceConfirmInputs {
+    /** `transactionInternalReference` de UNIR (sale del preview). Requerido para el confirm. */
+    previewRef: string;
+    /**
+     * Idempotencia del tramo mobile→procesador. **Lo genera el front** en el tap de
+     * confirmar, 1:1 con el `previewRef`: si re-previewa, nuevo `previewRef` ⇒ nuevo
+     * `idempotencyKey`. El backend lo deja vacío en el sobre.
+     */
+    idempotencyKey?: string;
+}

package/src/remittance/dtos/RemittanceSendPreviewResponse.ts

@@ -1,3 +1,5 @@
+import { RemittanceConfirmRequest } from "./RemittanceConfirmRequest";
+
 export interface RemittanceBeneficiaryDisplay {
     name: string;
     bank?: string;
@@ -16,4 +18,19 @@ export class RemittanceSendPreviewResponse {
     beneficiaryDisplay!: RemittanceBeneficiaryDisplay;
     /** Epoch ms. Cache 10 min en RemittanceCache_GT (D-F5.4). */
     expiresAt!: number;
+
+    /**
+     * serviceId del corredor resuelto por el connector: `<countryISO>#<payerCode>#<receptionMethodName>`
+     * (ej. `GT#GCA10#Cash Pickup`). Insumo para que benefits codifique el `leafId`.
+     * Lo llena el connector; no es para consumo directo del front.
+     */
+    serviceId?: string;
+    /** productId del corredor (monto libre, ej. `GT#GCA10#VAR`). Lo llena el connector. */
+    productId?: string;
+    /**
+     * Sobre pre-armado por benefits que el front reenvía al procesador para confirmar (F6).
+     * Lo completa benefits (encode del `leafId` + taxonomía del marketplace); el connector
+     * lo deja vacío. Ver {@link RemittanceConfirmRequest}.
+     */
+    confirmRequest?: RemittanceConfirmRequest;
 }

package/src/remittance/dtos/index.ts

@@ -10,6 +10,7 @@ export * from "./RemittanceQuoteRequest";
 export * from "./RemittanceQuoteResponse";
 export * from "./RemittanceSendPreviewRequest";
 export * from "./RemittanceSendPreviewResponse";
+export * from "./RemittanceConfirmRequest";
 export * from "./RemittancePayRequest";
 export * from "./RemittancePayResponse";
 export * from "./RemittanceTransaction";