@fiado/type-kit 3.120.0 → 3.121.0

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

@@ -0,0 +1,7 @@
+declare const ALLOWED_MFA_TYPES: readonly ["SOFTWARE_TOKEN_MFA"];
+export type AllowedMfaType = (typeof ALLOWED_MFA_TYPES)[number];
+export declare class MfaPoolConfig {
+    requireMfa: boolean;
+    mfaTypes: AllowedMfaType[];
+}
+export {};

package/bin/cognitoBackofficeConnector/dtos/MfaPoolConfig.js

@@ -0,0 +1,36 @@
+"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.MfaPoolConfig = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const MfaTypesRequiresOne_1 = require("../validators/MfaTypesRequiresOne");
+// EMAIL_OTP removido (3.41.0): el cognito-backoffice-connector no provisiona
+// EmailMfaConfiguration a nivel pool (requiere infra SES que no está montada
+// y la integración con messages-lambda aún no tiene diseño). Ver TD-020 +
+// DEC-001 en cognito-backoffice-connector/docs/. Si se reintroduce, agregar
+// 'EMAIL_OTP' a este array.
+const ALLOWED_MFA_TYPES = ['SOFTWARE_TOKEN_MFA'];
+class MfaPoolConfig {
+}
+exports.MfaPoolConfig = MfaPoolConfig;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], MfaPoolConfig.prototype, "requireMfa", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsIn)(ALLOWED_MFA_TYPES, { each: true }),
+    (0, class_validator_1.Validate)(MfaTypesRequiresOne_1.MfaTypesRequiresOne),
+    __metadata("design:type", Array)
+], MfaPoolConfig.prototype, "mfaTypes", void 0);

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

@@ -0,0 +1,20 @@
+import { PoolKind } from '../../rbac/enums/PoolKind';
+/**
+ * Shape del `PoolConfigRow` expuesto al caller (BFF M18 / otros lambdas Fiado).
+ * Refleja la configuración de un Cognito User Pool registrado en la tabla
+ * `PoolConfigs_GT` del lambda `cognito-backoffice-connector`.
+ */
+export declare class PoolConfigResponse {
+    userPoolId: string;
+    userPoolArn: string;
+    region: string;
+    poolKind: PoolKind;
+    displayName: string;
+    appClients: Record<string, {
+        clientId: string;
+        clientName: string;
+    }>;
+    status: 'active' | 'deprecated';
+    createdAt: number;
+    updatedAt: number;
+}

package/bin/cognitoBackofficeConnector/dtos/PoolConfigResponse.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolConfigResponse = void 0;
+/**
+ * Shape del `PoolConfigRow` expuesto al caller (BFF M18 / otros lambdas Fiado).
+ * Refleja la configuración de un Cognito User Pool registrado en la tabla
+ * `PoolConfigs_GT` del lambda `cognito-backoffice-connector`.
+ */
+class PoolConfigResponse {
+}
+exports.PoolConfigResponse = PoolConfigResponse;

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

@@ -0,0 +1,4 @@
+import { PoolConfigResponse } from './PoolConfigResponse';
+export declare class PoolsListResponse {
+    pools: PoolConfigResponse[];
+}

package/bin/cognitoBackofficeConnector/dtos/PoolsListResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolsListResponse = void 0;
+class PoolsListResponse {
+}
+exports.PoolsListResponse = PoolsListResponse;

package/bin/cognitoBackofficeConnector/validators/MfaTypesRequiresOne.d.ts

@@ -0,0 +1,17 @@
+import { ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
+/**
+ * Cross-field validator: si `requireMfa: true`, entonces `mfaTypes` debe tener
+ * al menos 1 elemento. Si `requireMfa: false`, `mfaTypes` puede ser vacío.
+ *
+ * Razón: cuando el pool nace con MFA habilitado, el connector llama
+ * `SetUserPoolMfaConfigCommand` con la lista de tipos del DTO. Si el array
+ * llega vacío con `requireMfa: true`, el SDK rechaza con InvalidParameterException
+ * y el pool queda en estado inconsistente (MfaConfiguration:'ON' sin tipos).
+ * Mejor rechazar en validación del DTO antes de tocar AWS.
+ *
+ * Ver pivote v1.4.1 TD-017 cerrado + spec doc §1 R3.
+ */
+export declare class MfaTypesRequiresOne implements ValidatorConstraintInterface {
+    validate(mfaTypes: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/cognitoBackofficeConnector/validators/MfaTypesRequiresOne.js

@@ -0,0 +1,39 @@
+"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.MfaTypesRequiresOne = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Cross-field validator: si `requireMfa: true`, entonces `mfaTypes` debe tener
+ * al menos 1 elemento. Si `requireMfa: false`, `mfaTypes` puede ser vacío.
+ *
+ * Razón: cuando el pool nace con MFA habilitado, el connector llama
+ * `SetUserPoolMfaConfigCommand` con la lista de tipos del DTO. Si el array
+ * llega vacío con `requireMfa: true`, el SDK rechaza con InvalidParameterException
+ * y el pool queda en estado inconsistente (MfaConfiguration:'ON' sin tipos).
+ * Mejor rechazar en validación del DTO antes de tocar AWS.
+ *
+ * Ver pivote v1.4.1 TD-017 cerrado + spec doc §1 R3.
+ */
+let MfaTypesRequiresOne = class MfaTypesRequiresOne {
+    validate(mfaTypes, args) {
+        const obj = args.object;
+        if (obj.requireMfa === true) {
+            return Array.isArray(mfaTypes) && mfaTypes.length >= 1;
+        }
+        // requireMfa: false → cualquier mfaTypes pasa.
+        return true;
+    }
+    defaultMessage() {
+        return 'mfaTypes requiere al menos un tipo cuando requireMfa=true';
+    }
+};
+exports.MfaTypesRequiresOne = MfaTypesRequiresOne;
+exports.MfaTypesRequiresOne = MfaTypesRequiresOne = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'MfaTypesRequiresOneWhenMfaRequired', async: false })
+], MfaTypesRequiresOne);

package/bin/rbac/enums/PoolKind.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tipo de User Pool de Cognito desde la perspectiva del modelo RBAC Fiado.
+ *
+ * Origen: spec del proyecto `cognito-backoffice-connector` (Fase 0, componente 01
+ * documento `docs/superpowers/specs/2026-05-26-cognito-connector-decisiones-pendientes-design.md`).
+ *
+ * Decisión (TD-003): el proyecto converge en estos 2 valores. El documento componente 03
+ * lista 3 valores (incluyendo una variante adicional) pero queda como outlier — la
+ * decisión vigente en los 6 docs restantes y en el plan de implementación es 2 valores:
+ *  - BACKOFFICE_PLATFORM — pool del backoffice de plataforma (cross-tenant)
+ *  - BACKOFFICE_TENANT — pool por tenant (multi-tenant isolation)
+ */
+export declare enum PoolKind {
+    BACKOFFICE_PLATFORM = "BACKOFFICE_PLATFORM",
+    BACKOFFICE_TENANT = "BACKOFFICE_TENANT"
+}

package/bin/rbac/enums/PoolKind.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolKind = void 0;
+/**
+ * Tipo de User Pool de Cognito desde la perspectiva del modelo RBAC Fiado.
+ *
+ * Origen: spec del proyecto `cognito-backoffice-connector` (Fase 0, componente 01
+ * documento `docs/superpowers/specs/2026-05-26-cognito-connector-decisiones-pendientes-design.md`).
+ *
+ * Decisión (TD-003): el proyecto converge en estos 2 valores. El documento componente 03
+ * lista 3 valores (incluyendo una variante adicional) pero queda como outlier — la
+ * decisión vigente en los 6 docs restantes y en el plan de implementación es 2 valores:
+ *  - BACKOFFICE_PLATFORM — pool del backoffice de plataforma (cross-tenant)
+ *  - BACKOFFICE_TENANT — pool por tenant (multi-tenant isolation)
+ */
+var PoolKind;
+(function (PoolKind) {
+    PoolKind["BACKOFFICE_PLATFORM"] = "BACKOFFICE_PLATFORM";
+    PoolKind["BACKOFFICE_TENANT"] = "BACKOFFICE_TENANT";
+})(PoolKind || (exports.PoolKind = PoolKind = {}));

package/bin/rbac/index.d.ts

@@ -0,0 +1 @@
+export * from './enums/PoolKind';

package/bin/rbac/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./enums/PoolKind"), exports);

package/bin/remittance/dtos/internal/RemittanceCreditBackRequest.d.ts

@@ -0,0 +1,28 @@
+import { RemittanceCancelledByEnum } from "../../enums/RemittanceCancelledByEnum";
+import { RemittanceCancelOutcomeEnum } from "../../enums/RemittanceCancelOutcomeEnum";
+import { FeeAbsorbedByEnum } from "../../enums/FeeAbsorbedByEnum";
+/**
+ * Request del credit-back de cancelacion. Lo emite uniteller-connector (cron F8)
+ * hacia el endpoint privado del processor POST remittance/credit-back, SOLO cuando
+ * UNIR confirma el outcome terminal (fondos de vuelta en el Wlp Wallet).
+ */
+export declare class RemittanceCreditBackRequest {
+    /** Llave de idempotencia del credit-back (= marketplaceTransactionNumber). */
+    idempotencyKey: string;
+    /** Transaction number de UNIR (trazabilidad). */
+    transactionNumber: string;
+    /** Tx del processor; sirve de relatedTransactionId del chargeback + correlacion /trx. */
+    marketplaceTransactionNumber: string;
+    /** Para resolver la cuenta CP del usuario (externalAccountId del chargeback). */
+    directoryId: string;
+    /** Monto principal (siempre se acredita). */
+    principalAmount: number;
+    /** Service fee de la remesa (se acredita solo si feeAbsorbedBy = FIADO). */
+    serviceFeeAmount: number;
+    currencyId: string;
+    cancelledBy: RemittanceCancelledByEnum;
+    cancelOutcome: RemittanceCancelOutcomeEnum;
+    feeAbsorbedBy: FeeAbsorbedByEnum;
+    cancelRequestedAt?: string;
+    cancelConfirmedAt?: string;
+}

package/bin/remittance/dtos/internal/RemittanceCreditBackRequest.js

@@ -0,0 +1,80 @@
+"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.RemittanceCreditBackRequest = void 0;
+const class_validator_1 = require("class-validator");
+const RemittanceCancelledByEnum_1 = require("../../enums/RemittanceCancelledByEnum");
+const RemittanceCancelOutcomeEnum_1 = require("../../enums/RemittanceCancelOutcomeEnum");
+const FeeAbsorbedByEnum_1 = require("../../enums/FeeAbsorbedByEnum");
+/**
+ * Request del credit-back de cancelacion. Lo emite uniteller-connector (cron F8)
+ * hacia el endpoint privado del processor POST remittance/credit-back, SOLO cuando
+ * UNIR confirma el outcome terminal (fondos de vuelta en el Wlp Wallet).
+ */
+class RemittanceCreditBackRequest {
+}
+exports.RemittanceCreditBackRequest = RemittanceCreditBackRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "transactionNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "marketplaceTransactionNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], RemittanceCreditBackRequest.prototype, "principalAmount", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], RemittanceCreditBackRequest.prototype, "serviceFeeAmount", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "currencyId", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(RemittanceCancelledByEnum_1.RemittanceCancelledByEnum),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "cancelledBy", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(RemittanceCancelOutcomeEnum_1.RemittanceCancelOutcomeEnum),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "cancelOutcome", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(FeeAbsorbedByEnum_1.FeeAbsorbedByEnum),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "feeAbsorbedBy", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "cancelRequestedAt", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "cancelConfirmedAt", void 0);

package/bin/remittance/dtos/internal/RemittanceCreditBackResponse.d.ts

@@ -0,0 +1,12 @@
+import { RemittanceTxStatus } from "../../enums/RemittanceTxStatus";
+/** Respuesta del credit-back: confirma el credito ejecutado en CP + estado final. */
+export declare class RemittanceCreditBackResponse {
+    /** Estado final de la remesa tras el credit-back (CANCELLED si VOID, REFUND si REFUND). */
+    status: RemittanceTxStatus;
+    /** Monto efectivamente acreditado al cliente. */
+    creditedAmount: number;
+    /** Id del credito generado en CP (chargeback) — para auditoria/conciliacion. */
+    cpCreditTransactionId?: string;
+    /** True si el credit-back ya existia (idempotencia) y no se re-ejecuto. */
+    alreadyProcessed: boolean;
+}

package/bin/remittance/dtos/internal/RemittanceCreditBackResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemittanceCreditBackResponse = void 0;
+/** Respuesta del credit-back: confirma el credito ejecutado en CP + estado final. */
+class RemittanceCreditBackResponse {
+}
+exports.RemittanceCreditBackResponse = RemittanceCreditBackResponse;

package/bin/remittance/enums/FeeAbsorbedByEnum.d.ts

@@ -0,0 +1,4 @@
+export declare enum FeeAbsorbedByEnum {
+    CLIENT = "CLIENT",// User Cancel: el cliente pierde el service fee
+    FIADO = "FIADO"
+}

package/bin/remittance/enums/FeeAbsorbedByEnum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeeAbsorbedByEnum = void 0;
+var FeeAbsorbedByEnum;
+(function (FeeAbsorbedByEnum) {
+    FeeAbsorbedByEnum["CLIENT"] = "CLIENT";
+    FeeAbsorbedByEnum["FIADO"] = "FIADO";
+})(FeeAbsorbedByEnum || (exports.FeeAbsorbedByEnum = FeeAbsorbedByEnum = {}));

package/bin/remittance/enums/RemittanceCancelOutcomeEnum.d.ts

@@ -0,0 +1,4 @@
+export declare enum RemittanceCancelOutcomeEnum {
+    VOID = "VOID",// pre-settlement UNIR → se muestra CANCELLED
+    REFUND = "REFUND"
+}

package/bin/remittance/enums/RemittanceCancelOutcomeEnum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemittanceCancelOutcomeEnum = void 0;
+var RemittanceCancelOutcomeEnum;
+(function (RemittanceCancelOutcomeEnum) {
+    RemittanceCancelOutcomeEnum["VOID"] = "VOID";
+    RemittanceCancelOutcomeEnum["REFUND"] = "REFUND";
+})(RemittanceCancelOutcomeEnum || (exports.RemittanceCancelOutcomeEnum = RemittanceCancelOutcomeEnum = {}));

package/bin/remittance/enums/RemittanceCancelledByEnum.d.ts

@@ -0,0 +1,4 @@
+export declare enum RemittanceCancelledByEnum {
+    USER = "USER",
+    SYSTEM = "SYSTEM"
+}

package/bin/remittance/enums/RemittanceCancelledByEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemittanceCancelledByEnum = void 0;
+var RemittanceCancelledByEnum;
+(function (RemittanceCancelledByEnum) {
+    RemittanceCancelledByEnum["USER"] = "USER";
+    RemittanceCancelledByEnum["SYSTEM"] = "SYSTEM";
+    // FIADO_ERROR — diferido a fase posterior (sin flujo Fiado que cancele en v1).
+})(RemittanceCancelledByEnum || (exports.RemittanceCancelledByEnum = RemittanceCancelledByEnum = {}));

package/bin/remittance/enums/RemittanceTxStatus.d.ts

@@ -3,6 +3,7 @@ export declare enum RemittanceTxStatus {
     PAYABLE = "PAYABLE",
     PAID = "PAID",
     HOLD = "HOLD",
+    CANCELLATION_IN_PROGRESS = "CANCELLATION_IN_PROGRESS",// intermedio: cancel aceptado, esperando settlement + credit-back
     CANCELLED = "CANCELLED",
     REFUND = "REFUND"
 }

package/bin/remittance/enums/RemittanceTxStatus.js

@@ -7,6 +7,7 @@ var RemittanceTxStatus;
     RemittanceTxStatus["PAYABLE"] = "PAYABLE";
     RemittanceTxStatus["PAID"] = "PAID";
     RemittanceTxStatus["HOLD"] = "HOLD";
+    RemittanceTxStatus["CANCELLATION_IN_PROGRESS"] = "CANCELLATION_IN_PROGRESS";
     RemittanceTxStatus["CANCELLED"] = "CANCELLED";
     RemittanceTxStatus["REFUND"] = "REFUND";
 })(RemittanceTxStatus || (exports.RemittanceTxStatus = RemittanceTxStatus = {}));

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

@@ -2,3 +2,6 @@ export * from "./ReceptionMethod";
 export * from "./RemittanceTxStatus";
 export * from "./RemittanceCountryISO";
 export * from "./RemittanceUserState";
+export * from "./RemittanceCancelledByEnum";
+export * from "./RemittanceCancelOutcomeEnum";
+export * from "./FeeAbsorbedByEnum";

package/bin/remittance/enums/index.js

@@ -18,3 +18,6 @@ __exportStar(require("./ReceptionMethod"), exports);
 __exportStar(require("./RemittanceTxStatus"), exports);
 __exportStar(require("./RemittanceCountryISO"), exports);
 __exportStar(require("./RemittanceUserState"), exports);
+__exportStar(require("./RemittanceCancelledByEnum"), exports);
+__exportStar(require("./RemittanceCancelOutcomeEnum"), exports);
+__exportStar(require("./FeeAbsorbedByEnum"), exports);

package/bin/remittance/index.d.ts

@@ -1,2 +1,4 @@
 export * from "./enums";
 export * from "./dtos";
+export * from "./dtos/internal/RemittanceCreditBackRequest";
+export * from "./dtos/internal/RemittanceCreditBackResponse";

package/bin/remittance/index.js

@@ -18,3 +18,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./enums"), exports);
 // DTOs
 __exportStar(require("./dtos"), exports);
+__exportStar(require("./dtos/internal/RemittanceCreditBackRequest"), exports);
+__exportStar(require("./dtos/internal/RemittanceCreditBackResponse"), exports);

package/bin/walletFunding/dtos/CancelFundingReferenceRequest.d.ts

@@ -0,0 +1,5 @@
+export declare class CancelFundingReferenceRequest {
+    fundingId: string;
+    directoryId: string;
+    idempotencyKey: string;
+}

package/bin/walletFunding/dtos/CancelFundingReferenceRequest.js

@@ -0,0 +1,31 @@
+"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.CancelFundingReferenceRequest = void 0;
+const class_validator_1 = require("class-validator");
+class CancelFundingReferenceRequest {
+}
+exports.CancelFundingReferenceRequest = CancelFundingReferenceRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "fundingId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.d.ts

@@ -0,0 +1,7 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+export declare class CancelFundingReferenceResponse {
+    fundingId: string;
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+}

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelFundingReferenceResponse = void 0;
+class CancelFundingReferenceResponse {
+}
+exports.CancelFundingReferenceResponse = CancelFundingReferenceResponse;

package/bin/walletFunding/dtos/CancelFundingRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Request del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `fundingId` viaja en el path, `directoryId` se resuelve del JWT.
+ * `providerModuleName` permite al marketplace rutear al publisher correcto
+ * sin tener que persistir el mapping (el wallet-app sabe el moduleName
+ * porque vino en la respuesta del authorize).
+ */
+export declare class CancelFundingRequest {
+    idempotencyKey: string;
+    providerModuleName: string;
+}

package/bin/walletFunding/dtos/CancelFundingRequest.js

@@ -0,0 +1,33 @@
+"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.CancelFundingRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Request del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `fundingId` viaja en el path, `directoryId` se resuelve del JWT.
+ * `providerModuleName` permite al marketplace rutear al publisher correcto
+ * sin tener que persistir el mapping (el wallet-app sabe el moduleName
+ * porque vino en la respuesta del authorize).
+ */
+class CancelFundingRequest {
+}
+exports.CancelFundingRequest = CancelFundingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], CancelFundingRequest.prototype, "providerModuleName", void 0);

package/bin/walletFunding/dtos/CancelFundingResponse.d.ts

@@ -0,0 +1,14 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+/**
+ * Response del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
+ * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
+ * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
+ */
+export declare class CancelFundingResponse {
+    fundingId: string;
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    message?: string;
+}

package/bin/walletFunding/dtos/CancelFundingResponse.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelFundingResponse = void 0;
+/**
+ * Response del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
+ * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
+ * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
+ */
+class CancelFundingResponse {
+}
+exports.CancelFundingResponse = CancelFundingResponse;

package/bin/walletFunding/dtos/CancelWalletFundingRequest.d.ts

@@ -0,0 +1,3 @@
+export declare class CancelWalletFundingRequest {
+    idempotencyKey: string;
+}

package/bin/walletFunding/dtos/CancelWalletFundingRequest.js

@@ -0,0 +1,21 @@
+"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.CancelWalletFundingRequest = void 0;
+const class_validator_1 = require("class-validator");
+class CancelWalletFundingRequest {
+}
+exports.CancelWalletFundingRequest = CancelWalletFundingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelWalletFundingRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelWalletFundingResponse.d.ts

@@ -0,0 +1,7 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+export declare class CancelWalletFundingResponse {
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    fundingId?: string;
+}

package/bin/walletFunding/dtos/CancelWalletFundingResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelWalletFundingResponse = void 0;
+class CancelWalletFundingResponse {
+}
+exports.CancelWalletFundingResponse = CancelWalletFundingResponse;

package/package.json

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

package/src/remittance/dtos/internal/RemittanceCreditBackRequest.ts

@@ -0,0 +1,61 @@
+import { IsString, IsNotEmpty, IsNumber, IsEnum, IsOptional, IsPositive } from "class-validator";
+import { RemittanceCancelledByEnum } from "../../enums/RemittanceCancelledByEnum";
+import { RemittanceCancelOutcomeEnum } from "../../enums/RemittanceCancelOutcomeEnum";
+import { FeeAbsorbedByEnum } from "../../enums/FeeAbsorbedByEnum";
+
+/**
+ * Request del credit-back de cancelacion. Lo emite uniteller-connector (cron F8)
+ * hacia el endpoint privado del processor POST remittance/credit-back, SOLO cuando
+ * UNIR confirma el outcome terminal (fondos de vuelta en el Wlp Wallet).
+ */
+export class RemittanceCreditBackRequest {
+    /** Llave de idempotencia del credit-back (= marketplaceTransactionNumber). */
+    @IsString()
+    @IsNotEmpty()
+    idempotencyKey: string;
+
+    /** Transaction number de UNIR (trazabilidad). */
+    @IsString()
+    @IsNotEmpty()
+    transactionNumber: string;
+
+    /** Tx del processor; sirve de relatedTransactionId del chargeback + correlacion /trx. */
+    @IsString()
+    @IsNotEmpty()
+    marketplaceTransactionNumber: string;
+
+    /** Para resolver la cuenta CP del usuario (externalAccountId del chargeback). */
+    @IsString()
+    @IsNotEmpty()
+    directoryId: string;
+
+    /** Monto principal (siempre se acredita). */
+    @IsNumber()
+    @IsPositive()
+    principalAmount: number;
+
+    /** Service fee de la remesa (se acredita solo si feeAbsorbedBy = FIADO). */
+    @IsNumber()
+    serviceFeeAmount: number;
+
+    @IsString()
+    @IsNotEmpty()
+    currencyId: string;
+
+    @IsEnum(RemittanceCancelledByEnum)
+    cancelledBy: RemittanceCancelledByEnum;
+
+    @IsEnum(RemittanceCancelOutcomeEnum)
+    cancelOutcome: RemittanceCancelOutcomeEnum;
+
+    @IsEnum(FeeAbsorbedByEnum)
+    feeAbsorbedBy: FeeAbsorbedByEnum;
+
+    @IsString()
+    @IsOptional()
+    cancelRequestedAt?: string;
+
+    @IsString()
+    @IsOptional()
+    cancelConfirmedAt?: string;
+}

package/src/remittance/dtos/internal/RemittanceCreditBackResponse.ts

@@ -0,0 +1,13 @@
+import { RemittanceTxStatus } from "../../enums/RemittanceTxStatus";
+
+/** Respuesta del credit-back: confirma el credito ejecutado en CP + estado final. */
+export class RemittanceCreditBackResponse {
+    /** Estado final de la remesa tras el credit-back (CANCELLED si VOID, REFUND si REFUND). */
+    status: RemittanceTxStatus;
+    /** Monto efectivamente acreditado al cliente. */
+    creditedAmount: number;
+    /** Id del credito generado en CP (chargeback) — para auditoria/conciliacion. */
+    cpCreditTransactionId?: string;
+    /** True si el credit-back ya existia (idempotencia) y no se re-ejecuto. */
+    alreadyProcessed: boolean;
+}

package/src/remittance/enums/FeeAbsorbedByEnum.ts

@@ -0,0 +1,4 @@
+export enum FeeAbsorbedByEnum {
+    CLIENT = "CLIENT", // User Cancel: el cliente pierde el service fee
+    FIADO = "FIADO",   // System Cancel: Fiado absorbe el fee
+}

package/src/remittance/enums/RemittanceCancelOutcomeEnum.ts

@@ -0,0 +1,4 @@
+export enum RemittanceCancelOutcomeEnum {
+    VOID = "VOID",     // pre-settlement UNIR → se muestra CANCELLED
+    REFUND = "REFUND", // post-settlement UNIR
+}

package/src/remittance/enums/RemittanceCancelledByEnum.ts

@@ -0,0 +1,5 @@
+export enum RemittanceCancelledByEnum {
+    USER = "USER",
+    SYSTEM = "SYSTEM",
+    // FIADO_ERROR — diferido a fase posterior (sin flujo Fiado que cancele en v1).
+}

package/src/remittance/enums/RemittanceTxStatus.ts

@@ -3,6 +3,7 @@ export enum RemittanceTxStatus {
     PAYABLE = "PAYABLE",
     PAID = "PAID",
     HOLD = "HOLD",
+    CANCELLATION_IN_PROGRESS = "CANCELLATION_IN_PROGRESS", // intermedio: cancel aceptado, esperando settlement + credit-back
     CANCELLED = "CANCELLED",
     REFUND = "REFUND",
 }

package/src/remittance/enums/index.ts

@@ -2,3 +2,6 @@ export * from "./ReceptionMethod";
 export * from "./RemittanceTxStatus";
 export * from "./RemittanceCountryISO";
 export * from "./RemittanceUserState";
+export * from "./RemittanceCancelledByEnum";
+export * from "./RemittanceCancelOutcomeEnum";
+export * from "./FeeAbsorbedByEnum";

package/src/remittance/index.ts

@@ -2,3 +2,5 @@
 export * from "./enums";
 // DTOs
 export * from "./dtos";
+export * from "./dtos/internal/RemittanceCreditBackRequest";
+export * from "./dtos/internal/RemittanceCreditBackResponse";