@fiado/type-kit 3.42.0 → 3.44.0

package/docs/superpowers/specs/2026-05-22-inversify-v8-migration-design.md

@@ -0,0 +1,191 @@
+# Migración a inversify v8 (última) con soporte gradual de lambdas en v6
+
+Fecha: 2026-05-22
+Estado: diseño aprobado (estrategia), pendiente de revisión del spec
+Versión objetivo: inversify **8.x** (la última, hoy 8.1.0). Se salta v7; se va de v6 directo a v8.
+
+## 1. Contexto y objetivo
+
+Las libs compartidas (`@fiado/api-invoker`, `@fiado/gateway-adapter`,
+`@fiado/http-client`) dependen hoy de `inversify ^6.x` como dependencia normal.
+122 repos de lambdas las consumen y todos declaran `inversify` directamente,
+repartidos entre el major 1 (~80 repos, `^1.x`) y el major 3 (~30, `^3.x`).
+Las libs se publican a npm público (`registry.npmjs.org`).
+
+**Objetivo:** subir las libs a inversify 8 y migrar las 122 lambdas **de forma
+gradual**, manteniendo las lambdas no migradas funcionando en inversify 6,
+incluyendo la capacidad de sacar hotfixes a las libs para esas lambdas v6.
+
+## 2. Restricciones técnicas (la causa raíz)
+
+- **La DI cruza la frontera lib↔lambda.** Cada lambda hace
+  `const c = new Container(); c.load(gatewayAdapterBindings); c.load(apiInvokerBindings)`
+  y además `c.bind("IHttpRequest").to(AxiosHttpRequest)`. Los `ContainerModule`
+  y las clases `@injectable` viajan desde la lib al container de la lambda.
+- **Consecuencia:** el `ContainerModule`/decoradores producidos por la lib y el
+  `Container` de la lambda **deben ser de la misma versión de inversify**.
+  inversify 6 y 8 no se pueden mezclar en un mismo container (cambian la firma
+  del callback de `ContainerModule`, se elimina el namespace `interfaces`, y
+  cambian APIs de binding). Por eso **no existe una sola versión de lib que
+  sirva para ambos** sin un shim frágil.
+- **Atomicidad de la migración por lambda:** una lambda no puede mezclar
+  `gateway-adapter` v6 con `api-invoker` v8. Debe subir **en un solo PR**:
+  `inversify` 6→8 + el set completo de libs que tocan su container
+  (`api-invoker`, `gateway-adapter`, `http-client`).
+- **Ciclo entre libs:** `gateway-adapter` depende de `api-invoker` y
+  `api-invoker` depende de `gateway-adapter`. No se pueden publicar "uno a la
+  vez"; sus majors nuevos se publican coordinados (ver §5).
+- **Libs sin inversify:** `logger` y `type-kit` no usan el container ni
+  decoradores → **no se tocan** en esta migración.
+
+## 3. Estrategia elegida: majors paralelos (dual-track)
+
+Sacar un **major nuevo** de cada lib del set, construido sobre inversify 8.
+Los majors v6 actuales quedan como **línea de mantenimiento** para backports.
+Cada lambda migra cuando le toca, en un PR atómico. Cada container en runtime
+ve **una sola** versión de inversify.
+
+Líneas resultantes por lib (los majors de NUESTRAS libs son independientes del
+número de versión de inversify):
+
+| Lib            | Línea v6 (mantenimiento) | Línea v8 (nueva)     |
+|----------------|--------------------------|----------------------|
+| http-client    | 1.x                      | 2.0.0                |
+| gateway-adapter| 1.x                      | 2.0.0                |
+| api-invoker    | 3.x                      | 4.0.0                |
+| logger         | —  (sin cambio)          | —                    |
+| type-kit       | —  (sin cambio)          | —                    |
+
+(Estrategias descartadas: desacoplar las libs de inversify por completo —
+refactor enorme incompatible con "gradual"; peerDependency + shim dual-API —
+frágil por las diferencias de API entre v6 y v8.)
+
+## 4. Breaking changes confirmados (v6 → v8)
+
+Verificado contra las guías oficiales ([migrating-from-v6](https://inversify.io/docs/guides/migrating-from-v6/)
+y [migrating-from-v7](https://inversify.io/docs/guides/migrating-from-v7/)).
+Lo que toca este código:
+
+1. **`ContainerModule`**: el callback recibe ahora un objeto
+   `ContainerModuleLoadOptions`; se usa `options.bind(...)`. Afecta
+   `apiInvokerBindings` y `gatewayAdapterBindings`.
+   ```ts
+   // v6
+   export const apiInvokerBindings = new ContainerModule((bind: interfaces.Bind) => {
+     bind<IDirectoryApi>("IDirectoryApi").to(DirectoryApi);
+   });
+   // v8
+   export const apiInvokerBindings = new ContainerModule((options) => {
+     options.bind<IDirectoryApi>("IDirectoryApi").to(DirectoryApi);
+   });
+   ```
+2. **Namespace `interfaces` eliminado**: importar los tipos directamente.
+   `interfaces.Context → ResolutionContext`, `interfaces.Factory → Factory`,
+   `interfaces.Newable → Newable`, `interfaces.Request → BindingConstraints`.
+   Afecta `import { ContainerModule, interfaces } from "inversify"`.
+3. **`toAutoFactory` eliminado** → reescribir con `toFactory`:
+   ```ts
+   // v6 (auth-business)
+   .toAutoFactory("EventBridgeMessageSubscriber")
+   // v8
+   .toFactory((ctx) => () => ctx.get("EventBridgeMessageSubscriber"))
+   ```
+   También: `toProvider → toFactory` (con función async),
+   `toConstructor → toConstantValue`, `toFunction → toConstantValue`.
+4. **`container.load()` SIGUE SIENDO SÍNCRONO en v8** (convención "sync-first":
+   el nombre por defecto es sync, el async es `loadAsync()`). Como nuestros
+   módulos de binding son síncronos, **el patrón `const container = new
+   Container(); container.load(...); export { container }` se conserva** — NO
+   hay que volverlo async. (En v7 sí era async; v8 lo revirtió, a nuestro favor.)
+   `container.get()` también sigue síncrono.
+5. **Opciones del `Container`**: `autoBindInjectable → autobind`;
+   `container.createChild()` → `new Container({ parent })`. Revisar usos.
+6. **`@injectable`/`@inject` sin cambios**; nuevo `@injectFromBase` solo si una
+   clase hereda de una base injectable (revisar herencia).
+7. **inversify 8 es ESM-only**, pero proyectos CommonJS lo consumen vía
+   `require(esm)` en **Node 20+**. ⇒ todas las lambdas deben correr en runtime
+   **Node 20.x o superior**. Verificar el runtime de cada lambda antes de migrar.
+
+Entregable de esta fase: un **codemod / guía** reproducible para
+`container.config.ts` (reescritura de `toAutoFactory`, import de `interfaces`,
+firma de `ContainerModule`), ya que el patrón se repite en las 122 lambdas.
+
+## 5. Orden de trabajo en las libs (un proyecto a la vez)
+
+Para cada lib, antes de tocar: `git checkout develop && git pull`.
+
+1. **http-client** (hoja, solo `@injectable` en `AxiosHttpRequest`):
+   migrar a v8, publicar **2.0.0**. dist-tag `latest` → 2.x, `legacy-v6` → 1.x.
+2. **gateway-adapter + api-invoker** (ciclo): migrar el código de ambos a v8 en
+   ramas, desarrollando con enlaces locales (`npm link` / `file:`) para que
+   compilen uno contra otro. Publicar coordinado con prerelease:
+   - `gateway-adapter@2.0.0-rc.0` con dep `@fiado/api-invoker@^4.0.0-rc`
+   - `api-invoker@4.0.0-rc.0` con dep `@fiado/gateway-adapter@^2.0.0-rc`
+   - validar en 1 lambda piloto, luego promover a `2.0.0` / `4.0.0` finales.
+3. **logger / type-kit**: sin cambios.
+
+> **Publicación en espera:** no se publica ninguna lib a npm hasta terminar los
+> cambios y tener el visto bueno explícito del usuario.
+
+## 6. Política de branching y backport (soporte v6)
+
+- Cortar una rama de mantenimiento por línea v6 en el último release v6:
+  `release/3.x` en api-invoker (desde 3.18.0), `release/1.x` en
+  gateway-adapter y http-client. `develop` pasa a ser la línea v8.
+- **Hotfix que toca una lib mientras una lambda sigue en v6:**
+  1. El fix se hace en la línea natural y se hace `git cherry-pick` a la otra.
+     La mayoría de hotfixes (lógica de negocio, no inversify) tienen archivos
+     idénticos entre líneas → cherry-pick limpio.
+  2. Publicar patch en la línea v6 (ej. `3.18.1`) y, si aplica, en la nueva.
+  3. La lambda v6 (pineada `^3.x`) hace `npm update` y recibe el fix: cero
+     cambio de inversify, cero cambio en su `container.config.ts`.
+- **Disciplina clave:** mantener el major nuevo como un **diff quirúrgico** sobre
+  v6 (tocar solo archivos que tocan inversify) para que los cherry-picks no
+  choquen.
+- **Ventana de soporte:** se backportea **solo al último major v6** (api-invoker
+  3.x). Las ~80 lambdas aún en `^1.x` deben consolidarse a `^3` como parte de
+  (o antes de) la migración, porque hoy ya no pueden recibir fixes limpios.
+
+## 7. Playbook de migración por lambda (gradual)
+
+Por cada lambda, en un PR atómico:
+
+1. `inversify` 6→8 y `reflect-metadata` a la versión alineada.
+2. Subir el set de libs nuevas: `api-invoker` `^4`, `gateway-adapter` `^2`,
+   `http-client` `^2`.
+3. Aplicar el codemod/guía a `container.config.ts`: reescribir `toAutoFactory`
+   → `toFactory`, ajustar imports del namespace `interfaces`. El patrón
+   síncrono `export { container }` **no cambia** (load/get siguen sync en v8).
+4. Verificar que el runtime de la lambda sea **Node ≥20** (inversify 8 ESM-only).
+5. Correr tests + smoke test del handler. Merge y deploy.
+
+Las lambdas no migradas siguen en v6 sin cambios.
+
+## 8. Riesgos
+
+- **Divergencia de líneas v6/v8** si el major nuevo refactoriza de más →
+  mitigado con el "diff quirúrgico".
+- **Ciclo api-invoker↔gateway-adapter** en el publish → mitigado con prerelease
+  rc + dist-tags.
+- **Cola de migración larga** (122 lambdas) → mantener línea v6 viva y priorizar
+  consolidar los `^1.x` a `^3.x`.
+- **Runtime Node <20**: inversify 8 es ESM-only; lambdas en Node 18 o menor no
+  podrán hacer `require(esm)`. Mitigación: auditar y subir a Node 20+ el runtime
+  de cada lambda como prerrequisito de su PR de migración.
+- **Saltar v7→v8 directo** acumula breaking changes; mitigado validando lib por
+  lib con su smoke test antes de avanzar. (El cambio más riesgoso de v7 —`load`
+  async— quedó revertido en v8, así que el bootstrap síncrono se conserva.)
+
+## 9. Criterios de éxito
+
+- http-client@2, gateway-adapter@2, api-invoker@4 construidos sobre inversify 8
+  y validados en 1 lambda piloto (publicación pendiente de visto bueno).
+- Línea v6 (`release/*`) capaz de recibir y publicar un hotfix backporteado.
+- Guía/codemod de `container.config.ts` documentada y reutilizable.
+- Lambdas no migradas siguen desplegando sin cambios.
+
+## Seguridad (fuera de alcance, pero a atender)
+
+`fiado-api-invoker/.npmrc` contiene un token de publicación de npm en texto
+plano. Si está versionado, debe **revocarse/rotarse** en npmjs.com y moverse a
+una variable de entorno / secret de CI.

package/package.json

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

package/src/index.ts

@@ -81,4 +81,5 @@ export * as CognitoBackofficeConnector from './cognitoBackofficeConnector';
 // platform-rbac-business — migrar Permission/Scope/AuthContext/RoleAssignmentInfo a `rbac/`).
 export * as PlatformRbac from './platformRbac';
 export * as Remittance from './remittance';
+export * as WalletFunding from './walletFunding';
 export * from './messaging';

package/src/platformRbac/auth/DefineNextChallengeRequest.ts

@@ -0,0 +1,25 @@
+import 'reflect-metadata';
+import { Type } from 'class-transformer';
+import { IsArray, IsBoolean, IsEnum, IsString, ValidateNested } from 'class-validator';
+import { ChallengeNameEnum } from '../enums/ChallengeNameEnum';
+
+export class ChallengeResultEntry {
+    @IsEnum(ChallengeNameEnum)
+    challengeName!: ChallengeNameEnum;
+
+    @IsBoolean()
+    challengeResult!: boolean;
+}
+
+export class DefineNextChallengeRequest {
+    @IsString()
+    cognitoSub!: string;
+
+    @IsBoolean()
+    userNotFound!: boolean;
+
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => ChallengeResultEntry)
+    session!: ChallengeResultEntry[];
+}

package/src/platformRbac/auth/DefineNextChallengeResponse.ts

@@ -0,0 +1,14 @@
+import { IsBoolean, IsEnum, IsOptional } from 'class-validator';
+import { ChallengeNameEnum } from '../enums/ChallengeNameEnum';
+
+export class DefineNextChallengeResponse {
+    @IsOptional()
+    @IsEnum(ChallengeNameEnum)
+    nextChallenge?: ChallengeNameEnum;
+
+    @IsBoolean()
+    issueTokens!: boolean;
+
+    @IsBoolean()
+    failAuthentication!: boolean;
+}

package/src/platformRbac/auth/NewPasswordRequest.ts

@@ -0,0 +1,10 @@
+import { IsString, MinLength } from 'class-validator';
+
+export class NewPasswordRequest {
+    @IsString()
+    cognitoSub!: string;
+
+    @IsString()
+    @MinLength(8)
+    newPassword!: string;
+}

package/src/platformRbac/auth/PrepareChallengeRequest.ts

@@ -0,0 +1,13 @@
+import { IsEmail, IsEnum, IsString } from 'class-validator';
+import { ChallengeNameEnum } from '../enums/ChallengeNameEnum';
+
+export class PrepareChallengeRequest {
+    @IsString()
+    cognitoSub!: string;
+
+    @IsEnum(ChallengeNameEnum)
+    challengeName!: ChallengeNameEnum;
+
+    @IsEmail()
+    email!: string;
+}

package/src/platformRbac/auth/PrepareChallengeResponse.ts

@@ -0,0 +1,9 @@
+import { IsObject, IsString } from 'class-validator';
+
+export class PrepareChallengeResponse {
+    @IsString()
+    publicChallengeParameters!: string;
+
+    @IsObject()
+    privateChallengeParameters!: Record<string, string>;
+}

package/src/platformRbac/auth/ResetPasswordRequest.ts

@@ -0,0 +1,14 @@
+import { IsEmail, IsString, Length, MinLength } from 'class-validator';
+
+export class ResetPasswordRequest {
+    @IsEmail()
+    email!: string;
+
+    @IsString()
+    @Length(6, 6)
+    otpCode!: string;
+
+    @IsString()
+    @MinLength(8)
+    newPassword!: string;
+}

package/src/platformRbac/auth/VerifyChallengeRequest.ts

@@ -0,0 +1,16 @@
+import { IsEnum, IsObject, IsString } from 'class-validator';
+import { ChallengeNameEnum } from '../enums/ChallengeNameEnum';
+
+export class VerifyChallengeRequest {
+    @IsString()
+    cognitoSub!: string;
+
+    @IsEnum(ChallengeNameEnum)
+    challengeName!: ChallengeNameEnum;
+
+    @IsString()
+    challengeAnswer!: string;
+
+    @IsObject()
+    privateChallengeParameters!: Record<string, string>;
+}

package/src/platformRbac/auth/VerifyChallengeResponse.ts

@@ -0,0 +1,6 @@
+import { IsBoolean } from 'class-validator';
+
+export class VerifyChallengeResponse {
+    @IsBoolean()
+    answerCorrect!: boolean;
+}

package/src/platformRbac/enums/ChallengeNameEnum.ts

@@ -0,0 +1,7 @@
+export enum ChallengeNameEnum {
+    PASSWORD = 'PASSWORD',
+    EMAIL_OTP = 'EMAIL_OTP',
+    TOTP = 'TOTP',
+    NEW_PASSWORD_REQUIRED = 'NEW_PASSWORD_REQUIRED',
+    RESET_PASSWORD = 'RESET_PASSWORD',
+}

package/src/platformRbac/enums/MfaMethodEnum.ts

@@ -0,0 +1,4 @@
+export enum MfaMethodEnum {
+    EMAIL_OTP = 'EMAIL_OTP',
+    TOTP = 'TOTP',
+}

package/src/platformRbac/index.ts

@@ -15,3 +15,20 @@ export { PermissionCategory } from './enums/PermissionCategory';
 export type { AuthContext } from './dtos/AuthContext';
 export type { RoleAssignmentInfo } from './dtos/RoleAssignmentInfo';
 export type { PermissionMeta } from './dtos/PermissionMeta';
+
+// Fase 1 — Custom Auth Challenge (Email OTP + TOTP) + MFA self-service.
+// Class values (no type-only) — los DTOs llevan decoradores class-validator y se hidratan con plainToInstance en runtime.
+export * from './enums/MfaMethodEnum';
+export * from './enums/ChallengeNameEnum';
+export * from './auth/DefineNextChallengeRequest';
+export * from './auth/DefineNextChallengeResponse';
+export * from './auth/PrepareChallengeRequest';
+export * from './auth/PrepareChallengeResponse';
+export * from './auth/VerifyChallengeRequest';
+export * from './auth/VerifyChallengeResponse';
+export * from './auth/NewPasswordRequest';
+export * from './auth/ResetPasswordRequest';
+export * from './mfa/EnrollTotpResponse';
+export * from './mfa/VerifyTotpEnrollmentRequest';
+export * from './mfa/ChangeMfaMethodRequest';
+export * from './mfa/MfaStatusResponse';

package/src/platformRbac/mfa/ChangeMfaMethodRequest.ts

@@ -0,0 +1,10 @@
+import { IsEnum, IsString } from 'class-validator';
+import { MfaMethodEnum } from '../enums/MfaMethodEnum';
+
+export class ChangeMfaMethodRequest {
+    @IsEnum(MfaMethodEnum)
+    newMethod!: MfaMethodEnum;
+
+    @IsString()
+    verificationCode!: string;
+}

package/src/platformRbac/mfa/EnrollTotpResponse.ts

@@ -0,0 +1,12 @@
+import { IsString } from 'class-validator';
+
+export class EnrollTotpResponse {
+    @IsString()
+    qrCodeDataUrl!: string;
+
+    @IsString()
+    secret!: string;
+
+    @IsString()
+    issuer!: string;
+}

package/src/platformRbac/mfa/MfaStatusResponse.ts

@@ -0,0 +1,14 @@
+import { IsArray, IsEnum, IsNumber } from 'class-validator';
+import { MfaMethodEnum } from '../enums/MfaMethodEnum';
+
+export class MfaStatusResponse {
+    @IsEnum(MfaMethodEnum)
+    currentMethod!: MfaMethodEnum;
+
+    @IsArray()
+    @IsEnum(MfaMethodEnum, { each: true })
+    availableMethods!: MfaMethodEnum[];
+
+    @IsNumber()
+    recoveryCodesRemaining!: number;
+}

package/src/platformRbac/mfa/VerifyTotpEnrollmentRequest.ts

@@ -0,0 +1,7 @@
+import { IsString, Length } from 'class-validator';
+
+export class VerifyTotpEnrollmentRequest {
+    @IsString()
+    @Length(6, 6)
+    totpCode!: string;
+}

package/src/walletFunding/dtos/AuthorizeWalletFundingRequest.ts

@@ -0,0 +1,18 @@
+import {
+    IsString, IsEnum, IsOptional, IsNumber, IsPositive,
+    Length, Min, Max, IsLatitude, IsLongitude, MaxLength,
+} from "class-validator";
+import { FundingMethodEnum } from "../enums/FundingMethodEnum";
+import { WalletFundingModeEnum } from "../enums/WalletFundingModeEnum";
+
+export class AuthorizeWalletFundingRequest {
+    @IsString() @MaxLength(64) directoryId!: string;
+    @IsEnum(FundingMethodEnum) method!: FundingMethodEnum;
+    @IsEnum(WalletFundingModeEnum) mode!: WalletFundingModeEnum;
+    @IsOptional() @IsNumber() @IsPositive() amount?: number;
+    @IsString() @Length(3, 3) currencyCode!: string;
+    @IsNumber() @Min(1) @Max(30) expirationDays!: number;
+    @IsString() @MaxLength(64) idempotencyKey!: string;
+    @IsOptional() @IsLatitude() latitude?: number;
+    @IsOptional() @IsLongitude() longitude?: number;
+}

package/src/walletFunding/dtos/AuthorizeWalletFundingResponse.ts

@@ -0,0 +1,11 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+import { FundingProviderReferenceData } from "./FundingProviderReferenceData";
+
+export class AuthorizeWalletFundingResponse {
+    status!: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    fundingId?: string;
+    expiresAt?: string;
+    providerData?: FundingProviderReferenceData;
+}

package/src/walletFunding/dtos/CancelFundingReferenceRequest.ts

@@ -0,0 +1,7 @@
+import { IsString, MaxLength } from "class-validator";
+
+export class CancelFundingReferenceRequest {
+    @IsString() @MaxLength(64) fundingId!: string;
+    @IsString() @MaxLength(64) directoryId!: string;
+    @IsString() @MaxLength(64) idempotencyKey!: string;
+}

package/src/walletFunding/dtos/CancelFundingReferenceResponse.ts

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

package/src/walletFunding/dtos/CancelWalletFundingRequest.ts

@@ -0,0 +1,5 @@
+import { IsString, MaxLength } from "class-validator";
+
+export class CancelWalletFundingRequest {
+    @IsString() @MaxLength(64) idempotencyKey!: string;
+}

package/src/walletFunding/dtos/CancelWalletFundingResponse.ts

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

package/src/walletFunding/dtos/CreateFundingReferenceRequest.ts

@@ -0,0 +1,18 @@
+import {
+    IsString, IsEmail, IsEnum, IsOptional, IsNumber, IsPositive,
+    Length, IsDateString, MaxLength,
+} from "class-validator";
+import { WalletFundingModeEnum } from "../enums/WalletFundingModeEnum";
+
+export class CreateFundingReferenceRequest {
+    @IsString() @MaxLength(64) fundingId!: string;
+    @IsString() @MaxLength(64) directoryId!: string;
+    @IsString() @MaxLength(64) walletAccountId!: string;
+    @IsString() @MaxLength(128) name!: string;
+    @IsEmail() email!: string;
+    @IsEnum(WalletFundingModeEnum) mode!: WalletFundingModeEnum;
+    @IsOptional() @IsNumber() @IsPositive() amount?: number;
+    @IsString() @Length(3, 3) currencyCode!: string;
+    @IsDateString() expiresAt!: string;
+    @IsString() @MaxLength(64) idempotencyKey!: string;
+}

package/src/walletFunding/dtos/CreateFundingReferenceResponse.ts

@@ -0,0 +1,11 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+import { FundingProviderReferenceData } from "./FundingProviderReferenceData";
+
+export class CreateFundingReferenceResponse {
+    fundingId!: string;
+    status!: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    expiresAt?: string;
+    providerData?: FundingProviderReferenceData;
+}

package/src/walletFunding/dtos/CreditWalletFundingRequest.ts

@@ -0,0 +1,12 @@
+import { IsString, IsNumber, IsPositive, Length, IsDateString, MaxLength } from "class-validator";
+
+export class CreditWalletFundingRequest {
+    @IsString() @MaxLength(64) directoryId!: string;
+    @IsString() @MaxLength(64) walletAccountId!: string;
+    @IsNumber() @IsPositive() amount!: number;
+    @IsString() @Length(3, 3) currencyCode!: string;
+    @IsString() @MaxLength(32) providerName!: string;
+    @IsString() @MaxLength(128) providerReference!: string;
+    @IsString() @MaxLength(64) providerTxId!: string;
+    @IsDateString() paidAt!: string;
+}

package/src/walletFunding/dtos/CreditWalletFundingResponse.ts

@@ -0,0 +1,9 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+
+export class CreditWalletFundingResponse {
+    status!: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    transactionNumber?: string;
+    noAuthorization?: string;
+}

package/src/walletFunding/dtos/FundingProviderReferenceData.ts

@@ -0,0 +1,10 @@
+export class FundingProviderReferenceItem {
+    reference!: string;
+    centers!: Array<{ name: string; logo: string }>;
+    centerId!: number | string;
+    barcode!: string;
+}
+
+export class FundingProviderReferenceData {
+    references!: FundingProviderReferenceItem[];
+}

package/src/walletFunding/dtos/ListFundingReferencesRequest.ts

@@ -0,0 +1,7 @@
+import { IsString, IsOptional, IsEnum, MaxLength } from "class-validator";
+import { WalletFundingReferenceStatusEnum } from "../enums/WalletFundingReferenceStatusEnum";
+
+export class ListFundingReferencesRequest {
+    @IsString() @MaxLength(64) directoryId!: string;
+    @IsOptional() @IsEnum(WalletFundingReferenceStatusEnum) status?: WalletFundingReferenceStatusEnum;
+}

package/src/walletFunding/dtos/ListFundingReferencesResponse.ts

@@ -0,0 +1,5 @@
+import { WalletFundingReferenceListItem } from "./ListWalletFundingReferencesResponse";
+
+export class ListFundingReferencesResponse {
+    items!: WalletFundingReferenceListItem[];
+}

package/src/walletFunding/dtos/ListWalletFundingReferencesRequest.ts

@@ -0,0 +1,8 @@
+import { IsOptional, IsEnum } from "class-validator";
+import { WalletFundingReferenceStatusEnum } from "../enums/WalletFundingReferenceStatusEnum";
+import { FundingMethodEnum } from "../enums/FundingMethodEnum";
+
+export class ListWalletFundingReferencesRequest {
+    @IsOptional() @IsEnum(WalletFundingReferenceStatusEnum) status?: WalletFundingReferenceStatusEnum;
+    @IsOptional() @IsEnum(FundingMethodEnum) method?: FundingMethodEnum;
+}

package/src/walletFunding/dtos/ListWalletFundingReferencesResponse.ts

@@ -0,0 +1,18 @@
+import { WalletFundingReferenceStatusEnum } from "../enums/WalletFundingReferenceStatusEnum";
+import { WalletFundingModeEnum } from "../enums/WalletFundingModeEnum";
+import { FundingProviderReferenceData } from "./FundingProviderReferenceData";
+
+export class WalletFundingReferenceListItem {
+    fundingId!: string;
+    mode!: WalletFundingModeEnum;
+    amount?: number;
+    currencyCode!: string;
+    status!: WalletFundingReferenceStatusEnum;
+    expiresAt!: string;
+    createdAt!: string;
+    providerData!: FundingProviderReferenceData;
+}
+
+export class ListWalletFundingReferencesResponse {
+    items!: WalletFundingReferenceListItem[];
+}

package/src/walletFunding/dtos/ReverseWalletFundingRequest.ts

@@ -0,0 +1,11 @@
+import { IsString, IsNumber, IsPositive, Length, MaxLength } from "class-validator";
+
+export class ReverseWalletFundingRequest {
+    @IsString() @MaxLength(64) directoryId!: string;
+    @IsString() @MaxLength(64) walletAccountId!: string;
+    @IsNumber() @IsPositive() amount!: number;
+    @IsString() @Length(3, 3) currencyCode!: string;
+    @IsString() @MaxLength(32) providerName!: string;
+    @IsString() @MaxLength(128) providerReference!: string;
+    @IsString() @MaxLength(64) providerTxId!: string;
+}

package/src/walletFunding/dtos/ReverseWalletFundingResponse.ts

@@ -0,0 +1,8 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+
+export class ReverseWalletFundingResponse {
+    status!: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    transactionNumber?: string;
+}

package/src/walletFunding/dtos/ValidateWalletFundingRequest.ts

@@ -0,0 +1,11 @@
+import { IsString, IsNumber, IsPositive, Length, MaxLength } from "class-validator";
+
+export class ValidateWalletFundingRequest {
+    @IsString() @MaxLength(64) directoryId!: string;
+    @IsString() @MaxLength(64) walletAccountId!: string;
+    @IsNumber() @IsPositive() amount!: number;
+    @IsString() @Length(3, 3) currencyCode!: string;
+    @IsString() @MaxLength(32) providerName!: string;
+    @IsString() @MaxLength(128) providerReference!: string;
+    @IsString() @MaxLength(64) providerTxId!: string;
+}

package/src/walletFunding/dtos/ValidateWalletFundingResponse.ts

@@ -0,0 +1,7 @@
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+
+export class ValidateWalletFundingResponse {
+    authorized!: boolean;
+    errorCode?: WalletFundingErrorCodeEnum;
+    message?: string;
+}