@fiado/type-kit 3.162.0 → 3.164.0

package/_test_/unit/remittance/resolveExceptionCode.test.ts

@@ -0,0 +1,37 @@
+import { RemittanceExceptionCode } from "../../../src/remittance/enums/RemittanceExceptionCode";
+import {
+    REMITTANCE_EXCEPTION_CATALOG,
+    resolveExceptionCode,
+} from "../../../src/remittance/dtos/RemittanceExceptionCatalog";
+
+describe("resolveExceptionCode", () => {
+    it("HOLD con sub-status de timeout → HOLD_PROVIDER_TIMEOUT", () => {
+        expect(resolveExceptionCode("HOLD", "SENDMONEY_TIMEOUT")).toBe(RemittanceExceptionCode.HOLD_PROVIDER_TIMEOUT);
+    });
+    it("HOLD sin sub-status → HOLD_GENERIC", () => {
+        expect(resolveExceptionCode("HOLD")).toBe(RemittanceExceptionCode.HOLD_GENERIC);
+    });
+    it("CANCELLATION con cancelReason USER_REQUESTED → CANCEL_USER_REQUESTED", () => {
+        expect(resolveExceptionCode("CANCELLATION_IN_PROGRESS", undefined, "USER_REQUESTED")).toBe(RemittanceExceptionCode.CANCEL_USER_REQUESTED);
+    });
+    it("IN_PROCESS → INPROCESS_STALE_24H", () => {
+        expect(resolveExceptionCode("IN_PROCESS")).toBe(RemittanceExceptionCode.INPROCESS_STALE_24H);
+    });
+    it("HOLD con sub-status desconocido → HOLD_GENERIC (no UNKNOWN)", () => {
+        const code = resolveExceptionCode("HOLD", "ZZZ_NUEVO_CODIGO_UNIR");
+        expect(code).toBe(RemittanceExceptionCode.HOLD_GENERIC);
+        expect(REMITTANCE_EXCEPTION_CATALOG[code]).toBeDefined();
+    });
+    it("status totalmente inesperado → UNKNOWN con catálogo definido", () => {
+        const code = resolveExceptionCode("PLASMA");
+        expect(code).toBe(RemittanceExceptionCode.UNKNOWN);
+        expect(REMITTANCE_EXCEPTION_CATALOG[code].motivo.length).toBeGreaterThan(0);
+    });
+    it("todo our-code tiene entrada de catálogo (motivo+acción no vacíos)", () => {
+        for (const code of Object.values(RemittanceExceptionCode)) {
+            const entry = REMITTANCE_EXCEPTION_CATALOG[code];
+            expect(entry?.motivo?.length ?? 0).toBeGreaterThan(0);
+            expect(entry?.accionSugerida?.length ?? 0).toBeGreaterThan(0);
+        }
+    });
+});

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

@@ -0,0 +1,13 @@
+import { RemittanceExceptionCode } from "../enums/RemittanceExceptionCode";
+export interface ExceptionCatalogEntry {
+    motivo: string;
+    accionSugerida: string;
+}
+/** our-code → texto ya traducido (español). El front lo muestra tal cual. */
+export declare const REMITTANCE_EXCEPTION_CATALOG: Record<RemittanceExceptionCode, ExceptionCatalogEntry>;
+/**
+ * Resuelve el our-code a partir del status + los códigos crudos de UNIR.
+ * Fallback por bucket (HOLD_GENERIC / CANCEL_GENERIC / INPROCESS_STALE_24H) y
+ * UNKNOWN para status inesperados. Nunca lanza.
+ */
+export declare function resolveExceptionCode(status: string, unirSubStatus?: string | null, cancelReason?: string | null): RemittanceExceptionCode;

package/bin/remittance/dtos/RemittanceExceptionCatalog.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REMITTANCE_EXCEPTION_CATALOG = void 0;
+exports.resolveExceptionCode = resolveExceptionCode;
+const RemittanceExceptionCode_1 = require("../enums/RemittanceExceptionCode");
+/** our-code → texto ya traducido (español). El front lo muestra tal cual. */
+exports.REMITTANCE_EXCEPTION_CATALOG = {
+    [RemittanceExceptionCode_1.RemittanceExceptionCode.HOLD_DISPERSAL_UNCONFIRMED]: {
+        motivo: "El proveedor no ha confirmado la dispersión de fondos.",
+        accionSugerida: "Investigar el estado de la dispersión. Si supera 48h en HOLD, escalar a soporte del proveedor.",
+    },
+    [RemittanceExceptionCode_1.RemittanceExceptionCode.HOLD_PROVIDER_TIMEOUT]: {
+        motivo: "Tiempo de espera agotado con el proveedor · sin confirmar dispersión.",
+        accionSugerida: "Investigar el estado de la transacción. Si supera 48h en HOLD, escalar a soporte del proveedor.",
+    },
+    [RemittanceExceptionCode_1.RemittanceExceptionCode.HOLD_COMPLIANCE_REVIEW]: {
+        motivo: "El proveedor puso la transacción en revisión de cumplimiento.",
+        accionSugerida: "Monitorear. Si el proveedor no libera en 72h, escalar a soporte.",
+    },
+    [RemittanceExceptionCode_1.RemittanceExceptionCode.HOLD_GENERIC]: {
+        motivo: "El proveedor marcó la transacción con un problema.",
+        accionSugerida: "Investigar el estado de la transacción. Si supera 48h en HOLD, escalar a soporte del proveedor.",
+    },
+    [RemittanceExceptionCode_1.RemittanceExceptionCode.CANCEL_USER_REQUESTED]: {
+        motivo: "El cliente canceló la transacción. Esperando que el proveedor confirme la devolución de fondos.",
+        accionSugerida: "Monitorear. La devolución al monedero se dispara automáticamente al confirmar el proveedor. Si supera 72h, escalar a tesorería.",
+    },
+    [RemittanceExceptionCode_1.RemittanceExceptionCode.CANCEL_PROVIDER_INITIATED]: {
+        motivo: "El proveedor inició la cancelación de la transacción.",
+        accionSugerida: "Monitorear la confirmación de devolución. Si supera 72h, escalar a tesorería.",
+    },
+    [RemittanceExceptionCode_1.RemittanceExceptionCode.CANCEL_GENERIC]: {
+        motivo: "Cancelación en proceso. Esperando confirmación del proveedor.",
+        accionSugerida: "Monitorear. Si supera 72h sin confirmación, escalar a tesorería.",
+    },
+    [RemittanceExceptionCode_1.RemittanceExceptionCode.INPROCESS_STALE_24H]: {
+        motivo: "La transacción lleva más de 24h sin avanzar a PAYABLE/PAID.",
+        accionSugerida: "Verificar el sync con el proveedor. Si no responde, escalar a soporte con el número de transacción.",
+    },
+    [RemittanceExceptionCode_1.RemittanceExceptionCode.UNKNOWN]: {
+        motivo: "Situación no catalogada.",
+        accionSugerida: "Revisar manualmente el detalle de la transacción y escalar si aplica.",
+    },
+};
+/**
+ * Mapa de códigos CRUDOS de UNIR (sub-status) → our-code.
+ * Se amplía minando el PDF de UNIR (tarea aparte). Las claves se normalizan a MAYÚSCULAS.
+ */
+const UNIR_HOLD_SUBSTATUS_TO_CODE = {
+    SENDMONEY_TIMEOUT: RemittanceExceptionCode_1.RemittanceExceptionCode.HOLD_PROVIDER_TIMEOUT,
+    TIMEOUT: RemittanceExceptionCode_1.RemittanceExceptionCode.HOLD_PROVIDER_TIMEOUT,
+    DISPERSAL_UNCONFIRMED: RemittanceExceptionCode_1.RemittanceExceptionCode.HOLD_DISPERSAL_UNCONFIRMED,
+    COMPLIANCE_REVIEW: RemittanceExceptionCode_1.RemittanceExceptionCode.HOLD_COMPLIANCE_REVIEW,
+};
+/**
+ * Mapa de cancelReason → our-code.
+ * Incluye tanto los valores reales de RemittanceCancelledByEnum (USER / SYSTEM)
+ * como los códigos semánticos de UNIR (USER_REQUESTED / PROVIDER_INITIATED).
+ */
+const UNIR_CANCEL_REASON_TO_CODE = {
+    // Valores de RemittanceCancelledByEnum
+    USER: RemittanceExceptionCode_1.RemittanceExceptionCode.CANCEL_USER_REQUESTED,
+    SYSTEM: RemittanceExceptionCode_1.RemittanceExceptionCode.CANCEL_GENERIC,
+    // Códigos semánticos de UNIR
+    USER_REQUESTED: RemittanceExceptionCode_1.RemittanceExceptionCode.CANCEL_USER_REQUESTED,
+    PROVIDER_INITIATED: RemittanceExceptionCode_1.RemittanceExceptionCode.CANCEL_PROVIDER_INITIATED,
+};
+/**
+ * Resuelve el our-code a partir del status + los códigos crudos de UNIR.
+ * Fallback por bucket (HOLD_GENERIC / CANCEL_GENERIC / INPROCESS_STALE_24H) y
+ * UNKNOWN para status inesperados. Nunca lanza.
+ */
+function resolveExceptionCode(status, unirSubStatus, cancelReason) {
+    switch (status) {
+        case "HOLD": {
+            const key = (unirSubStatus ?? "").trim().toUpperCase();
+            return UNIR_HOLD_SUBSTATUS_TO_CODE[key] ?? RemittanceExceptionCode_1.RemittanceExceptionCode.HOLD_GENERIC;
+        }
+        case "CANCELLATION_IN_PROGRESS": {
+            const key = (cancelReason ?? "").trim().toUpperCase();
+            return UNIR_CANCEL_REASON_TO_CODE[key] ?? RemittanceExceptionCode_1.RemittanceExceptionCode.CANCEL_GENERIC;
+        }
+        case "IN_PROCESS":
+            return RemittanceExceptionCode_1.RemittanceExceptionCode.INPROCESS_STALE_24H;
+        default:
+            return RemittanceExceptionCode_1.RemittanceExceptionCode.UNKNOWN;
+    }
+}

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

@@ -44,3 +44,4 @@ export * from "./RemittancePricing";
 export * from "./RemittancePromotion";
 export * from "./RemittanceRule";
 export * from "./RemittancePricingTable";
+export * from "./RemittanceExceptionCatalog";

package/bin/remittance/dtos/index.js

@@ -60,3 +60,4 @@ __exportStar(require("./RemittancePricing"), exports);
 __exportStar(require("./RemittancePromotion"), exports);
 __exportStar(require("./RemittanceRule"), exports);
 __exportStar(require("./RemittancePricingTable"), exports);
+__exportStar(require("./RemittanceExceptionCatalog"), exports);

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

@@ -0,0 +1,16 @@
+/**
+ * Códigos propios ("our-code") de excepciones de remesas. Traducimos los códigos
+ * crudos de UNIR a ESTE formato; los crudos NUNCA se exponen. UNKNOWN es el
+ * fallback para sub-status/motivos no catalogados (nuevos o desconocidos).
+ */
+export declare enum RemittanceExceptionCode {
+    HOLD_DISPERSAL_UNCONFIRMED = "HOLD_DISPERSAL_UNCONFIRMED",
+    HOLD_PROVIDER_TIMEOUT = "HOLD_PROVIDER_TIMEOUT",
+    HOLD_COMPLIANCE_REVIEW = "HOLD_COMPLIANCE_REVIEW",
+    HOLD_GENERIC = "HOLD_GENERIC",
+    CANCEL_USER_REQUESTED = "CANCEL_USER_REQUESTED",
+    CANCEL_PROVIDER_INITIATED = "CANCEL_PROVIDER_INITIATED",
+    CANCEL_GENERIC = "CANCEL_GENERIC",
+    INPROCESS_STALE_24H = "INPROCESS_STALE_24H",
+    UNKNOWN = "UNKNOWN"
+}

package/bin/remittance/enums/RemittanceExceptionCode.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemittanceExceptionCode = void 0;
+/**
+ * Códigos propios ("our-code") de excepciones de remesas. Traducimos los códigos
+ * crudos de UNIR a ESTE formato; los crudos NUNCA se exponen. UNKNOWN es el
+ * fallback para sub-status/motivos no catalogados (nuevos o desconocidos).
+ */
+var RemittanceExceptionCode;
+(function (RemittanceExceptionCode) {
+    // HOLD (el proveedor marcó la tx)
+    RemittanceExceptionCode["HOLD_DISPERSAL_UNCONFIRMED"] = "HOLD_DISPERSAL_UNCONFIRMED";
+    RemittanceExceptionCode["HOLD_PROVIDER_TIMEOUT"] = "HOLD_PROVIDER_TIMEOUT";
+    RemittanceExceptionCode["HOLD_COMPLIANCE_REVIEW"] = "HOLD_COMPLIANCE_REVIEW";
+    RemittanceExceptionCode["HOLD_GENERIC"] = "HOLD_GENERIC";
+    // Cancelación en proceso
+    RemittanceExceptionCode["CANCEL_USER_REQUESTED"] = "CANCEL_USER_REQUESTED";
+    RemittanceExceptionCode["CANCEL_PROVIDER_INITIATED"] = "CANCEL_PROVIDER_INITIATED";
+    RemittanceExceptionCode["CANCEL_GENERIC"] = "CANCEL_GENERIC";
+    // In-process atorada > 24h
+    RemittanceExceptionCode["INPROCESS_STALE_24H"] = "INPROCESS_STALE_24H";
+    // Fallback
+    RemittanceExceptionCode["UNKNOWN"] = "UNKNOWN";
+})(RemittanceExceptionCode || (exports.RemittanceExceptionCode = RemittanceExceptionCode = {}));

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

@@ -22,3 +22,4 @@ export * from "./RuleField";
 export * from "./RuleOperator";
 export * from "./RuleActionType";
 export * from "./AuditResult";
+export * from "./RemittanceExceptionCode";

package/bin/remittance/enums/index.js

@@ -38,3 +38,4 @@ __exportStar(require("./RuleField"), exports);
 __exportStar(require("./RuleOperator"), exports);
 __exportStar(require("./RuleActionType"), exports);
 __exportStar(require("./AuditResult"), exports);
+__exportStar(require("./RemittanceExceptionCode"), exports);

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

@@ -0,0 +1,21 @@
+import { FundingVerificationOutcomeEnum } from "../enums/FundingVerificationOutcomeEnum";
+/**
+ * Request del endpoint privado `POST /funding/apply` del connector.
+ *
+ * Lo invoca `db-conciliacion` cuando la verificación autoritativa (poll al
+ * portal del Proveedor, ~10 min) resuelve. Dispara el acreditamiento diferido:
+ * el webhook `payment` NO acredita — solo deja el pago en IN_VERIFICATION;
+ * este apply es la segunda ejecución (async) que mueve el dinero.
+ */
+export declare class ApplyWalletFundingRequest {
+    providerName: string;
+    providerTxId: string;
+    providerReference: string;
+    directoryId: string;
+    walletAccountId: string;
+    amount: number;
+    currencyCode: string;
+    paidAt: string;
+    /** Resultado de la verificación. APPROVED → acredita (settle); REJECTED → revierte. */
+    outcome: FundingVerificationOutcomeEnum;
+}

package/bin/walletFunding/dtos/ApplyWalletFundingRequest.js

@@ -0,0 +1,68 @@
+"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.ApplyWalletFundingRequest = void 0;
+const class_validator_1 = require("class-validator");
+const FundingVerificationOutcomeEnum_1 = require("../enums/FundingVerificationOutcomeEnum");
+/**
+ * Request del endpoint privado `POST /funding/apply` del connector.
+ *
+ * Lo invoca `db-conciliacion` cuando la verificación autoritativa (poll al
+ * portal del Proveedor, ~10 min) resuelve. Dispara el acreditamiento diferido:
+ * el webhook `payment` NO acredita — solo deja el pago en IN_VERIFICATION;
+ * este apply es la segunda ejecución (async) que mueve el dinero.
+ */
+class ApplyWalletFundingRequest {
+}
+exports.ApplyWalletFundingRequest = ApplyWalletFundingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(32),
+    __metadata("design:type", String)
+], ApplyWalletFundingRequest.prototype, "providerName", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], ApplyWalletFundingRequest.prototype, "providerTxId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], ApplyWalletFundingRequest.prototype, "providerReference", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], ApplyWalletFundingRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], ApplyWalletFundingRequest.prototype, "walletAccountId", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], ApplyWalletFundingRequest.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 3),
+    __metadata("design:type", String)
+], ApplyWalletFundingRequest.prototype, "currencyCode", void 0);
+__decorate([
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], ApplyWalletFundingRequest.prototype, "paidAt", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(FundingVerificationOutcomeEnum_1.FundingVerificationOutcomeEnum),
+    __metadata("design:type", String)
+], ApplyWalletFundingRequest.prototype, "outcome", void 0);

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

@@ -0,0 +1,10 @@
+import { WalletFundingPaymentStatusEnum } from "../enums/WalletFundingPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+export declare class ApplyWalletFundingResponse {
+    /** Estado del pago tras aplicar la verificación: APPLIED (acreditado) o REVERSED. */
+    status: WalletFundingPaymentStatusEnum;
+    /** Folio del processor si se acreditó (idempotente si ya estaba APPLIED). */
+    processorTransactionNumber?: string;
+    errorCode?: WalletFundingErrorCodeEnum;
+    message?: string;
+}

package/bin/walletFunding/dtos/ApplyWalletFundingResponse.js

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

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

@@ -0,0 +1,9 @@
+import { ServiceStateEnum } from "../enums/ServiceStateEnum";
+/** Response de `wallet-funding-rules` (GET /state). Estado del cap + breaker. */
+export declare class GetExposureStateResponse {
+    currentExposureAmount: number;
+    serviceState: ServiceStateEnum;
+    capThreshold: number;
+    alertThreshold: number;
+    reactivationThreshold: number;
+}

package/bin/walletFunding/dtos/GetExposureStateResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetExposureStateResponse = void 0;
+/** Response de `wallet-funding-rules` (GET /state). Estado del cap + breaker. */
+class GetExposureStateResponse {
+}
+exports.GetExposureStateResponse = GetExposureStateResponse;

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

@@ -0,0 +1,10 @@
+/**
+ * Request de `wallet-funding-rules` (POST /release). Lo llama la conciliación
+ * (db-conciliacion) al liquidar el SPEI, o el flujo de rechazo/reverso.
+ * Libera monto de la exposición agregada; puede reactivar el servicio.
+ */
+export declare class ReleaseExposureRequest {
+    amount: number;
+    currencyCode: string;
+    providerTxId?: string;
+}

package/bin/walletFunding/dtos/ReleaseExposureRequest.js

@@ -0,0 +1,37 @@
+"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.ReleaseExposureRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Request de `wallet-funding-rules` (POST /release). Lo llama la conciliación
+ * (db-conciliacion) al liquidar el SPEI, o el flujo de rechazo/reverso.
+ * Libera monto de la exposición agregada; puede reactivar el servicio.
+ */
+class ReleaseExposureRequest {
+}
+exports.ReleaseExposureRequest = ReleaseExposureRequest;
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], ReleaseExposureRequest.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 3),
+    __metadata("design:type", String)
+], ReleaseExposureRequest.prototype, "currencyCode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], ReleaseExposureRequest.prototype, "providerTxId", void 0);

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

@@ -0,0 +1,6 @@
+import { ServiceStateEnum } from "../enums/ServiceStateEnum";
+export declare class ReleaseExposureResponse {
+    released: boolean;
+    /** Estado tras liberar — transiciona a NORMAL si baja del umbral de reactivación. */
+    serviceState: ServiceStateEnum;
+}

package/bin/walletFunding/dtos/ReleaseExposureResponse.js

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

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

@@ -0,0 +1,13 @@
+/**
+ * Request de `wallet-funding-rules` (POST /reserve). Lo llama el processor en
+ * `walletFundingValidate` (cap gate). Reserva monto contra la exposición
+ * agregada FSA de forma atómica (single-region + ConditionExpression).
+ */
+export declare class ReserveExposureRequest {
+    directoryId: string;
+    amount: number;
+    currencyCode: string;
+    providerName: string;
+    /** Idempotencia: referencia/tx del Proveedor para no doble-reservar en reintentos. */
+    providerTxId?: string;
+}

package/bin/walletFunding/dtos/ReserveExposureRequest.js

@@ -0,0 +1,47 @@
+"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.ReserveExposureRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Request de `wallet-funding-rules` (POST /reserve). Lo llama el processor en
+ * `walletFundingValidate` (cap gate). Reserva monto contra la exposición
+ * agregada FSA de forma atómica (single-region + ConditionExpression).
+ */
+class ReserveExposureRequest {
+}
+exports.ReserveExposureRequest = ReserveExposureRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], ReserveExposureRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], ReserveExposureRequest.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 3),
+    __metadata("design:type", String)
+], ReserveExposureRequest.prototype, "currencyCode", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(32),
+    __metadata("design:type", String)
+], ReserveExposureRequest.prototype, "providerName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], ReserveExposureRequest.prototype, "providerTxId", void 0);

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

@@ -0,0 +1,8 @@
+import { ServiceStateEnum } from "../enums/ServiceStateEnum";
+export declare class ReserveExposureResponse {
+    /** true si la reserva pasó el cap; false si excede el cap o el servicio está SUSPENDED. */
+    allowed: boolean;
+    serviceState: ServiceStateEnum;
+    /** Motivo cuando allowed=false (ej. "CAP_REACHED", "SERVICE_SUSPENDED"). */
+    reason?: string;
+}

package/bin/walletFunding/dtos/ReserveExposureResponse.js

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

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

@@ -21,3 +21,10 @@ export * from "./AuthorizeFundingRequest";
 export * from "./AuthorizeFundingResponse";
 export * from "./SettleWalletFundingRequest";
 export * from "./SettleWalletFundingResponse";
+export * from "./ApplyWalletFundingRequest";
+export * from "./ApplyWalletFundingResponse";
+export * from "./ReserveExposureRequest";
+export * from "./ReserveExposureResponse";
+export * from "./ReleaseExposureRequest";
+export * from "./ReleaseExposureResponse";
+export * from "./GetExposureStateResponse";

package/bin/walletFunding/dtos/index.js

@@ -37,3 +37,10 @@ __exportStar(require("./AuthorizeFundingRequest"), exports);
 __exportStar(require("./AuthorizeFundingResponse"), exports);
 __exportStar(require("./SettleWalletFundingRequest"), exports);
 __exportStar(require("./SettleWalletFundingResponse"), exports);
+__exportStar(require("./ApplyWalletFundingRequest"), exports);
+__exportStar(require("./ApplyWalletFundingResponse"), exports);
+__exportStar(require("./ReserveExposureRequest"), exports);
+__exportStar(require("./ReserveExposureResponse"), exports);
+__exportStar(require("./ReleaseExposureRequest"), exports);
+__exportStar(require("./ReleaseExposureResponse"), exports);
+__exportStar(require("./GetExposureStateResponse"), exports);

package/bin/walletFunding/enums/FundingVerificationOutcomeEnum.d.ts

@@ -0,0 +1,6 @@
+export declare enum FundingVerificationOutcomeEnum {
+    /** La verificación autoritativa confirmó el pago en el Proveedor → acreditar. */
+    APPROVED = "APPROVED",
+    /** La verificación determinó que el pago fue rechazado → revertir, no acreditar. */
+    REJECTED = "REJECTED"
+}

package/bin/walletFunding/enums/FundingVerificationOutcomeEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FundingVerificationOutcomeEnum = void 0;
+var FundingVerificationOutcomeEnum;
+(function (FundingVerificationOutcomeEnum) {
+    /** La verificación autoritativa confirmó el pago en el Proveedor → acreditar. */
+    FundingVerificationOutcomeEnum["APPROVED"] = "APPROVED";
+    /** La verificación determinó que el pago fue rechazado → revertir, no acreditar. */
+    FundingVerificationOutcomeEnum["REJECTED"] = "REJECTED";
+})(FundingVerificationOutcomeEnum || (exports.FundingVerificationOutcomeEnum = FundingVerificationOutcomeEnum = {}));

package/bin/walletFunding/enums/ServiceStateEnum.d.ts

@@ -0,0 +1,6 @@
+export declare enum ServiceStateEnum {
+    /** Servicio operando normal — se autorizan nuevos permisos de Cash In. */
+    NORMAL = "NORMAL",
+    /** Cap agregado FSA alcanzado — se rechazan nuevos permisos hasta reactivar. */
+    SUSPENDED = "SUSPENDED"
+}

package/bin/walletFunding/enums/ServiceStateEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceStateEnum = void 0;
+var ServiceStateEnum;
+(function (ServiceStateEnum) {
+    /** Servicio operando normal — se autorizan nuevos permisos de Cash In. */
+    ServiceStateEnum["NORMAL"] = "NORMAL";
+    /** Cap agregado FSA alcanzado — se rechazan nuevos permisos hasta reactivar. */
+    ServiceStateEnum["SUSPENDED"] = "SUSPENDED";
+})(ServiceStateEnum || (exports.ServiceStateEnum = ServiceStateEnum = {}));

package/bin/walletFunding/enums/WalletFundingPaymentStatusEnum.d.ts

@@ -1,8 +1,12 @@
 export declare enum WalletFundingPaymentStatusEnum {
     /** Webhook consult procesado — pre-check OK, esperando webhook payment. */
     CONSULTED = "CONSULTED",
+    /** Pago recibido (webhook payment), en verificación autoritativa; aún NO acreditado. El webhook lo escribe y termina; el crédito es una invocación async posterior (db-conciliacion → /funding/apply). */
+    IN_VERIFICATION = "IN_VERIFICATION",
     /** Pago aplicado al wallet via processor.credit. */
     APPLIED = "APPLIED",
+    /** Liquidado por el Proveedor a FSA (SPEI recibido); marcado en la conciliación semanal. */
+    SETTLED = "SETTLED",
     /** Pago revertido via processor.reverse. */
     REVERSED = "REVERSED",
     /** Cliente ya gastó el dinero — ops resuelve manualmente. */

package/bin/walletFunding/enums/WalletFundingPaymentStatusEnum.js

@@ -5,8 +5,12 @@ var WalletFundingPaymentStatusEnum;
 (function (WalletFundingPaymentStatusEnum) {
     /** Webhook consult procesado — pre-check OK, esperando webhook payment. */
     WalletFundingPaymentStatusEnum["CONSULTED"] = "CONSULTED";
+    /** Pago recibido (webhook payment), en verificación autoritativa; aún NO acreditado. El webhook lo escribe y termina; el crédito es una invocación async posterior (db-conciliacion → /funding/apply). */
+    WalletFundingPaymentStatusEnum["IN_VERIFICATION"] = "IN_VERIFICATION";
     /** Pago aplicado al wallet via processor.credit. */
     WalletFundingPaymentStatusEnum["APPLIED"] = "APPLIED";
+    /** Liquidado por el Proveedor a FSA (SPEI recibido); marcado en la conciliación semanal. */
+    WalletFundingPaymentStatusEnum["SETTLED"] = "SETTLED";
     /** Pago revertido via processor.reverse. */
     WalletFundingPaymentStatusEnum["REVERSED"] = "REVERSED";
     /** Cliente ya gastó el dinero — ops resuelve manualmente. */

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

@@ -7,3 +7,5 @@ export * from "./WalletFundingRefundReasonEnum";
 export * from "./PaymentCodeTypeEnum";
 export * from "./FundingWebhookTypeEnum";
 export * from "./SettlementErrorCodeEnum";
+export * from "./ServiceStateEnum";
+export * from "./FundingVerificationOutcomeEnum";

package/bin/walletFunding/enums/index.js

@@ -23,3 +23,5 @@ __exportStar(require("./WalletFundingRefundReasonEnum"), exports);
 __exportStar(require("./PaymentCodeTypeEnum"), exports);
 __exportStar(require("./FundingWebhookTypeEnum"), exports);
 __exportStar(require("./SettlementErrorCodeEnum"), exports);
+__exportStar(require("./ServiceStateEnum"), exports);
+__exportStar(require("./FundingVerificationOutcomeEnum"), exports);

package/bin/walletFunding/schemas/AggregateExposureStateSchema.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Schema literal de la tabla DDB `AggregateExposureState_GT`.
+ *
+ * Singleton (pk `AGGREGATE#CASH_IN` / sk `STATE`) que lleva la exposición
+ * agregada de FiadoSA frente al Proveedor y el estado del circuit breaker.
+ *
+ * IMPORTANTE: tabla SINGLE-REGION (una sola réplica). Las escrituras del cap
+ * son UpdateItem con ConditionExpression y deben ser atómicas; una Global
+ * Table multi-región (last-writer-wins) rompería la garantía del cap.
+ *
+ * Owner: wallet-funding-rules-business.
+ */
+export declare const AggregateExposureStateTable: {
+    readonly name: "AggregateExposureState_GT";
+    readonly pk: "pk";
+    readonly sk: "sk";
+    readonly attributes: {
+        readonly pk: "pk";
+        readonly sk: "sk";
+        readonly currentExposureAmount: "currentExposureAmount";
+        readonly serviceState: "serviceState";
+        readonly capThreshold: "capThreshold";
+        readonly alertThreshold: "alertThreshold";
+        readonly reactivationThreshold: "reactivationThreshold";
+        readonly lastCapReachedAt: "lastCapReachedAt";
+        readonly lastAlertSentAt: "lastAlertSentAt";
+        readonly updatedAt: "updatedAt";
+    };
+};
+export type AggregateExposureStateAttribute = typeof AggregateExposureStateTable.attributes[keyof typeof AggregateExposureStateTable.attributes];

package/bin/walletFunding/schemas/AggregateExposureStateSchema.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggregateExposureStateTable = void 0;
+/**
+ * Schema literal de la tabla DDB `AggregateExposureState_GT`.
+ *
+ * Singleton (pk `AGGREGATE#CASH_IN` / sk `STATE`) que lleva la exposición
+ * agregada de FiadoSA frente al Proveedor y el estado del circuit breaker.
+ *
+ * IMPORTANTE: tabla SINGLE-REGION (una sola réplica). Las escrituras del cap
+ * son UpdateItem con ConditionExpression y deben ser atómicas; una Global
+ * Table multi-región (last-writer-wins) rompería la garantía del cap.
+ *
+ * Owner: wallet-funding-rules-business.
+ */
+exports.AggregateExposureStateTable = {
+    name: "AggregateExposureState_GT",
+    pk: "pk",
+    sk: "sk",
+    attributes: {
+        pk: "pk",
+        sk: "sk",
+        currentExposureAmount: "currentExposureAmount",
+        serviceState: "serviceState",
+        capThreshold: "capThreshold",
+        alertThreshold: "alertThreshold",
+        reactivationThreshold: "reactivationThreshold",
+        lastCapReachedAt: "lastCapReachedAt",
+        lastAlertSentAt: "lastAlertSentAt",
+        updatedAt: "updatedAt",
+    },
+};

package/bin/walletFunding/schemas/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./EqualityFundingPaymentSchema";
 export * from "./AccountPagoConfiadoSchema";
+export * from "./AggregateExposureStateSchema";

package/bin/walletFunding/schemas/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./EqualityFundingPaymentSchema"), exports);
 __exportStar(require("./AccountPagoConfiadoSchema"), exports);
+__exportStar(require("./AggregateExposureStateSchema"), exports);

package/package.json

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

package/src/remittance/dtos/RemittanceExceptionCatalog.ts

@@ -0,0 +1,97 @@
+import { RemittanceExceptionCode } from "../enums/RemittanceExceptionCode";
+
+export interface ExceptionCatalogEntry {
+    motivo: string;
+    accionSugerida: string;
+}
+
+/** our-code → texto ya traducido (español). El front lo muestra tal cual. */
+export const REMITTANCE_EXCEPTION_CATALOG: Record<RemittanceExceptionCode, ExceptionCatalogEntry> = {
+    [RemittanceExceptionCode.HOLD_DISPERSAL_UNCONFIRMED]: {
+        motivo: "El proveedor no ha confirmado la dispersión de fondos.",
+        accionSugerida: "Investigar el estado de la dispersión. Si supera 48h en HOLD, escalar a soporte del proveedor.",
+    },
+    [RemittanceExceptionCode.HOLD_PROVIDER_TIMEOUT]: {
+        motivo: "Tiempo de espera agotado con el proveedor · sin confirmar dispersión.",
+        accionSugerida: "Investigar el estado de la transacción. Si supera 48h en HOLD, escalar a soporte del proveedor.",
+    },
+    [RemittanceExceptionCode.HOLD_COMPLIANCE_REVIEW]: {
+        motivo: "El proveedor puso la transacción en revisión de cumplimiento.",
+        accionSugerida: "Monitorear. Si el proveedor no libera en 72h, escalar a soporte.",
+    },
+    [RemittanceExceptionCode.HOLD_GENERIC]: {
+        motivo: "El proveedor marcó la transacción con un problema.",
+        accionSugerida: "Investigar el estado de la transacción. Si supera 48h en HOLD, escalar a soporte del proveedor.",
+    },
+    [RemittanceExceptionCode.CANCEL_USER_REQUESTED]: {
+        motivo: "El cliente canceló la transacción. Esperando que el proveedor confirme la devolución de fondos.",
+        accionSugerida: "Monitorear. La devolución al monedero se dispara automáticamente al confirmar el proveedor. Si supera 72h, escalar a tesorería.",
+    },
+    [RemittanceExceptionCode.CANCEL_PROVIDER_INITIATED]: {
+        motivo: "El proveedor inició la cancelación de la transacción.",
+        accionSugerida: "Monitorear la confirmación de devolución. Si supera 72h, escalar a tesorería.",
+    },
+    [RemittanceExceptionCode.CANCEL_GENERIC]: {
+        motivo: "Cancelación en proceso. Esperando confirmación del proveedor.",
+        accionSugerida: "Monitorear. Si supera 72h sin confirmación, escalar a tesorería.",
+    },
+    [RemittanceExceptionCode.INPROCESS_STALE_24H]: {
+        motivo: "La transacción lleva más de 24h sin avanzar a PAYABLE/PAID.",
+        accionSugerida: "Verificar el sync con el proveedor. Si no responde, escalar a soporte con el número de transacción.",
+    },
+    [RemittanceExceptionCode.UNKNOWN]: {
+        motivo: "Situación no catalogada.",
+        accionSugerida: "Revisar manualmente el detalle de la transacción y escalar si aplica.",
+    },
+};
+
+/**
+ * Mapa de códigos CRUDOS de UNIR (sub-status) → our-code.
+ * Se amplía minando el PDF de UNIR (tarea aparte). Las claves se normalizan a MAYÚSCULAS.
+ */
+const UNIR_HOLD_SUBSTATUS_TO_CODE: Record<string, RemittanceExceptionCode> = {
+    SENDMONEY_TIMEOUT: RemittanceExceptionCode.HOLD_PROVIDER_TIMEOUT,
+    TIMEOUT: RemittanceExceptionCode.HOLD_PROVIDER_TIMEOUT,
+    DISPERSAL_UNCONFIRMED: RemittanceExceptionCode.HOLD_DISPERSAL_UNCONFIRMED,
+    COMPLIANCE_REVIEW: RemittanceExceptionCode.HOLD_COMPLIANCE_REVIEW,
+};
+
+/**
+ * Mapa de cancelReason → our-code.
+ * Incluye tanto los valores reales de RemittanceCancelledByEnum (USER / SYSTEM)
+ * como los códigos semánticos de UNIR (USER_REQUESTED / PROVIDER_INITIATED).
+ */
+const UNIR_CANCEL_REASON_TO_CODE: Record<string, RemittanceExceptionCode> = {
+    // Valores de RemittanceCancelledByEnum
+    USER: RemittanceExceptionCode.CANCEL_USER_REQUESTED,
+    SYSTEM: RemittanceExceptionCode.CANCEL_GENERIC,
+    // Códigos semánticos de UNIR
+    USER_REQUESTED: RemittanceExceptionCode.CANCEL_USER_REQUESTED,
+    PROVIDER_INITIATED: RemittanceExceptionCode.CANCEL_PROVIDER_INITIATED,
+};
+
+/**
+ * Resuelve el our-code a partir del status + los códigos crudos de UNIR.
+ * Fallback por bucket (HOLD_GENERIC / CANCEL_GENERIC / INPROCESS_STALE_24H) y
+ * UNKNOWN para status inesperados. Nunca lanza.
+ */
+export function resolveExceptionCode(
+    status: string,
+    unirSubStatus?: string | null,
+    cancelReason?: string | null,
+): RemittanceExceptionCode {
+    switch (status) {
+        case "HOLD": {
+            const key = (unirSubStatus ?? "").trim().toUpperCase();
+            return UNIR_HOLD_SUBSTATUS_TO_CODE[key] ?? RemittanceExceptionCode.HOLD_GENERIC;
+        }
+        case "CANCELLATION_IN_PROGRESS": {
+            const key = (cancelReason ?? "").trim().toUpperCase();
+            return UNIR_CANCEL_REASON_TO_CODE[key] ?? RemittanceExceptionCode.CANCEL_GENERIC;
+        }
+        case "IN_PROCESS":
+            return RemittanceExceptionCode.INPROCESS_STALE_24H;
+        default:
+            return RemittanceExceptionCode.UNKNOWN;
+    }
+}

package/src/remittance/dtos/index.ts

@@ -44,3 +44,4 @@ export * from "./RemittancePricing";
 export * from "./RemittancePromotion";
 export * from "./RemittanceRule";
 export * from "./RemittancePricingTable";
+export * from "./RemittanceExceptionCatalog";

package/src/remittance/enums/RemittanceExceptionCode.ts

@@ -0,0 +1,20 @@
+/**
+ * Códigos propios ("our-code") de excepciones de remesas. Traducimos los códigos
+ * crudos de UNIR a ESTE formato; los crudos NUNCA se exponen. UNKNOWN es el
+ * fallback para sub-status/motivos no catalogados (nuevos o desconocidos).
+ */
+export enum RemittanceExceptionCode {
+    // HOLD (el proveedor marcó la tx)
+    HOLD_DISPERSAL_UNCONFIRMED = "HOLD_DISPERSAL_UNCONFIRMED",
+    HOLD_PROVIDER_TIMEOUT = "HOLD_PROVIDER_TIMEOUT",
+    HOLD_COMPLIANCE_REVIEW = "HOLD_COMPLIANCE_REVIEW",
+    HOLD_GENERIC = "HOLD_GENERIC",
+    // Cancelación en proceso
+    CANCEL_USER_REQUESTED = "CANCEL_USER_REQUESTED",
+    CANCEL_PROVIDER_INITIATED = "CANCEL_PROVIDER_INITIATED",
+    CANCEL_GENERIC = "CANCEL_GENERIC",
+    // In-process atorada > 24h
+    INPROCESS_STALE_24H = "INPROCESS_STALE_24H",
+    // Fallback
+    UNKNOWN = "UNKNOWN",
+}

package/src/remittance/enums/index.ts

@@ -22,3 +22,4 @@ export * from "./RuleField";
 export * from "./RuleOperator";
 export * from "./RuleActionType";
 export * from "./AuditResult";
+export * from "./RemittanceExceptionCode";

package/src/walletFunding/dtos/ApplyWalletFundingRequest.ts

@@ -0,0 +1,23 @@
+import { IsString, IsNumber, IsPositive, Length, IsDateString, MaxLength, IsEnum } from "class-validator";
+import { FundingVerificationOutcomeEnum } from "../enums/FundingVerificationOutcomeEnum";
+
+/**
+ * Request del endpoint privado `POST /funding/apply` del connector.
+ *
+ * Lo invoca `db-conciliacion` cuando la verificación autoritativa (poll al
+ * portal del Proveedor, ~10 min) resuelve. Dispara el acreditamiento diferido:
+ * el webhook `payment` NO acredita — solo deja el pago en IN_VERIFICATION;
+ * este apply es la segunda ejecución (async) que mueve el dinero.
+ */
+export class ApplyWalletFundingRequest {
+    @IsString() @MaxLength(32) providerName!: string;
+    @IsString() @MaxLength(64) providerTxId!: string;
+    @IsString() @MaxLength(128) providerReference!: string;
+    @IsString() @MaxLength(64) directoryId!: string;
+    @IsString() @MaxLength(64) walletAccountId!: string;
+    @IsNumber() @IsPositive() amount!: number;
+    @IsString() @Length(3, 3) currencyCode!: string;
+    @IsDateString() paidAt!: string;
+    /** Resultado de la verificación. APPROVED → acredita (settle); REJECTED → revierte. */
+    @IsEnum(FundingVerificationOutcomeEnum) outcome!: FundingVerificationOutcomeEnum;
+}

package/src/walletFunding/dtos/ApplyWalletFundingResponse.ts

@@ -0,0 +1,11 @@
+import { WalletFundingPaymentStatusEnum } from "../enums/WalletFundingPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+
+export class ApplyWalletFundingResponse {
+    /** Estado del pago tras aplicar la verificación: APPLIED (acreditado) o REVERSED. */
+    status!: WalletFundingPaymentStatusEnum;
+    /** Folio del processor si se acreditó (idempotente si ya estaba APPLIED). */
+    processorTransactionNumber?: string;
+    errorCode?: WalletFundingErrorCodeEnum;
+    message?: string;
+}

package/src/walletFunding/dtos/GetExposureStateResponse.ts

@@ -0,0 +1,10 @@
+import { ServiceStateEnum } from "../enums/ServiceStateEnum";
+
+/** Response de `wallet-funding-rules` (GET /state). Estado del cap + breaker. */
+export class GetExposureStateResponse {
+    currentExposureAmount!: number;
+    serviceState!: ServiceStateEnum;
+    capThreshold!: number;
+    alertThreshold!: number;
+    reactivationThreshold!: number;
+}

package/src/walletFunding/dtos/ReleaseExposureRequest.ts

@@ -0,0 +1,12 @@
+import { IsString, IsNumber, IsPositive, Length, MaxLength, IsOptional } from "class-validator";
+
+/**
+ * Request de `wallet-funding-rules` (POST /release). Lo llama la conciliación
+ * (db-conciliacion) al liquidar el SPEI, o el flujo de rechazo/reverso.
+ * Libera monto de la exposición agregada; puede reactivar el servicio.
+ */
+export class ReleaseExposureRequest {
+    @IsNumber() @IsPositive() amount!: number;
+    @IsString() @Length(3, 3) currencyCode!: string;
+    @IsOptional() @IsString() @MaxLength(64) providerTxId?: string;
+}

package/src/walletFunding/dtos/ReleaseExposureResponse.ts

@@ -0,0 +1,7 @@
+import { ServiceStateEnum } from "../enums/ServiceStateEnum";
+
+export class ReleaseExposureResponse {
+    released!: boolean;
+    /** Estado tras liberar — transiciona a NORMAL si baja del umbral de reactivación. */
+    serviceState!: ServiceStateEnum;
+}

package/src/walletFunding/dtos/ReserveExposureRequest.ts

@@ -0,0 +1,15 @@
+import { IsString, IsNumber, IsPositive, Length, MaxLength, IsOptional } from "class-validator";
+
+/**
+ * Request de `wallet-funding-rules` (POST /reserve). Lo llama el processor en
+ * `walletFundingValidate` (cap gate). Reserva monto contra la exposición
+ * agregada FSA de forma atómica (single-region + ConditionExpression).
+ */
+export class ReserveExposureRequest {
+    @IsString() @MaxLength(64) directoryId!: string;
+    @IsNumber() @IsPositive() amount!: number;
+    @IsString() @Length(3, 3) currencyCode!: string;
+    @IsString() @MaxLength(32) providerName!: string;
+    /** Idempotencia: referencia/tx del Proveedor para no doble-reservar en reintentos. */
+    @IsOptional() @IsString() @MaxLength(64) providerTxId?: string;
+}

package/src/walletFunding/dtos/ReserveExposureResponse.ts

@@ -0,0 +1,9 @@
+import { ServiceStateEnum } from "../enums/ServiceStateEnum";
+
+export class ReserveExposureResponse {
+    /** true si la reserva pasó el cap; false si excede el cap o el servicio está SUSPENDED. */
+    allowed!: boolean;
+    serviceState!: ServiceStateEnum;
+    /** Motivo cuando allowed=false (ej. "CAP_REACHED", "SERVICE_SUSPENDED"). */
+    reason?: string;
+}

package/src/walletFunding/dtos/index.ts

@@ -21,3 +21,10 @@ export * from "./AuthorizeFundingRequest";
 export * from "./AuthorizeFundingResponse";
 export * from "./SettleWalletFundingRequest";
 export * from "./SettleWalletFundingResponse";
+export * from "./ApplyWalletFundingRequest";
+export * from "./ApplyWalletFundingResponse";
+export * from "./ReserveExposureRequest";
+export * from "./ReserveExposureResponse";
+export * from "./ReleaseExposureRequest";
+export * from "./ReleaseExposureResponse";
+export * from "./GetExposureStateResponse";

package/src/walletFunding/enums/FundingVerificationOutcomeEnum.ts

@@ -0,0 +1,6 @@
+export enum FundingVerificationOutcomeEnum {
+    /** La verificación autoritativa confirmó el pago en el Proveedor → acreditar. */
+    APPROVED = "APPROVED",
+    /** La verificación determinó que el pago fue rechazado → revertir, no acreditar. */
+    REJECTED = "REJECTED",
+}

package/src/walletFunding/enums/ServiceStateEnum.ts

@@ -0,0 +1,6 @@
+export enum ServiceStateEnum {
+    /** Servicio operando normal — se autorizan nuevos permisos de Cash In. */
+    NORMAL = "NORMAL",
+    /** Cap agregado FSA alcanzado — se rechazan nuevos permisos hasta reactivar. */
+    SUSPENDED = "SUSPENDED",
+}

package/src/walletFunding/enums/WalletFundingPaymentStatusEnum.ts

@@ -1,8 +1,12 @@
 export enum WalletFundingPaymentStatusEnum {
     /** Webhook consult procesado — pre-check OK, esperando webhook payment. */
     CONSULTED = "CONSULTED",
+    /** Pago recibido (webhook payment), en verificación autoritativa; aún NO acreditado. El webhook lo escribe y termina; el crédito es una invocación async posterior (db-conciliacion → /funding/apply). */
+    IN_VERIFICATION = "IN_VERIFICATION",
     /** Pago aplicado al wallet via processor.credit. */
     APPLIED = "APPLIED",
+    /** Liquidado por el Proveedor a FSA (SPEI recibido); marcado en la conciliación semanal. */
+    SETTLED = "SETTLED",
     /** Pago revertido via processor.reverse. */
     REVERSED = "REVERSED",
     /** Cliente ya gastó el dinero — ops resuelve manualmente. */

package/src/walletFunding/enums/index.ts

@@ -7,3 +7,5 @@ export * from "./WalletFundingRefundReasonEnum";
 export * from "./PaymentCodeTypeEnum";
 export * from "./FundingWebhookTypeEnum";
 export * from "./SettlementErrorCodeEnum";
+export * from "./ServiceStateEnum";
+export * from "./FundingVerificationOutcomeEnum";

package/src/walletFunding/schemas/AggregateExposureStateSchema.ts

@@ -0,0 +1,32 @@
+/**
+ * Schema literal de la tabla DDB `AggregateExposureState_GT`.
+ *
+ * Singleton (pk `AGGREGATE#CASH_IN` / sk `STATE`) que lleva la exposición
+ * agregada de FiadoSA frente al Proveedor y el estado del circuit breaker.
+ *
+ * IMPORTANTE: tabla SINGLE-REGION (una sola réplica). Las escrituras del cap
+ * son UpdateItem con ConditionExpression y deben ser atómicas; una Global
+ * Table multi-región (last-writer-wins) rompería la garantía del cap.
+ *
+ * Owner: wallet-funding-rules-business.
+ */
+export const AggregateExposureStateTable = {
+    name: "AggregateExposureState_GT",
+    pk: "pk",
+    sk: "sk",
+    attributes: {
+        pk: "pk",
+        sk: "sk",
+        currentExposureAmount: "currentExposureAmount",
+        serviceState: "serviceState",
+        capThreshold: "capThreshold",
+        alertThreshold: "alertThreshold",
+        reactivationThreshold: "reactivationThreshold",
+        lastCapReachedAt: "lastCapReachedAt",
+        lastAlertSentAt: "lastAlertSentAt",
+        updatedAt: "updatedAt",
+    },
+} as const;
+
+export type AggregateExposureStateAttribute =
+    typeof AggregateExposureStateTable.attributes[keyof typeof AggregateExposureStateTable.attributes];

package/src/walletFunding/schemas/index.ts

@@ -1,2 +1,3 @@
 export * from "./EqualityFundingPaymentSchema";
 export * from "./AccountPagoConfiadoSchema";
+export * from "./AggregateExposureStateSchema";