@fiado/type-kit 2.0.16 → 2.0.17

package/README.md

@@ -1,70 +1,70 @@
-# fiado-type-kit
-
-## Descripción
-**fiado-type-kit** es una biblioteca TypeScript diseñada para facilitar el desarrollo de funciones AWS Lambda al proporcionar un conjunto estructurado de Data Transfer Objects (DTOs), enumeraciones y constantes. Está organizada por dominios específicos (`card`, `account`, `directory`, `otros`) para mejorar la modularidad y la reutilización del código en proyectos de AWS Lambda.
-
-## Estructura del Proyecto
-
-**fiado-type-kit/**  
-📁 `/src` - Contiene el código fuente TypeScript, organizado por dominios.
-  - 📁 `card` - Funciones y tipos relacionados con tarjetas.
-    - 📁 `dtos` - Data Transfer Objects para `card`.
-      - 📄 `cardRequest.dto.ts`
-      - 📄 `cardResponse.dto.ts`
-    - 📁 `enums` - Enumeraciones específicas de `card`.
-      - 📄 `cardType.enum.ts`
-    - 📁 `constants` - Constantes de `card`.
-      - 📄 `cardConstants.ts`
-    - 📄 `index.ts` - Exporta los elementos de `card`.
-  - 📁 `account` - Funciones y tipos relacionados con cuentas.
-    - [Repita la estructura similar a `card`]
-  - 📁 `user` - Funciones y tipos relacionados con usuarios.
-    - [Repita la estructura similar a `card`]
-📁 `/bin` - Contiene los archivos transpilados y listos para producción.
-📁 `/test` - Incluye pruebas para los distintos componentes de la biblioteca.
-📄 `package.json`
-📄 `tsconfig.json`
-📄 `README.md`
-
-## Convenciones de Nombres y Validaciones
-### Convenciones de Nombres para DTOs
-Para mantener la coherencia y claridad en nuestros DTOs (Data Transfer Objects), seguimos una convención de nombres estricta. Los nombres de los archivos DTO deben reflejar claramente su propósito y el dominio al que pertenecen. Por ejemplo, para **card**:
-
-- **Solicitudes**: El nombre debe comenzar con la entidad a la que pertenece, seguir con la acción y terminar con Request. Ejemplo: **CardActivateRequest.ts**, **CardCreateRequest.ts**, **CardUpdateRequest.ts**, **CardDeleteRequest.ts**.
-- **Respuestas**: Debe comenzar con la entidad y terminar con Response. Ejemplo: **CardBalanceResponse.ts**. **CardResponse.ts**
-
-### Uso de class-validator en DTOs
-Al definir DTOs de solicitud, es esencial aplicar validaciones a todas las propiedades de la clase para garantizar que los datos recibidos cumplan con nuestras expectativas y restricciones. Usamos **class-validator** para este propósito:
-
-- **Solicitudes**: Todas las propiedades de las clases de solicitud deben tener decoradores de **class-validator** para validar la entrada.
-- **Respuestas**: Las clases de respuesta no deben incluir validaciones de **class-validator**, ya que son utilizadas solo para enviar datos al cliente.
-
-#### Ejemplo de un DTO de Solicitud con class-validator:
-
-```typescript
-import { IsNotEmpty, IsString, IsNumber } from 'class-validator';
-
-export class CardActivateRequest {
-  @IsNotEmpty()
-  @IsString()
-  readonly userId: string;
-
-  @IsNotEmpty()
-  @IsNumber()
-  readonly cardId: number;
-}
-```
-## Uso
-Para utilizar **fiado-type-kit** en tu proyecto, asegúrate de importar los componentes específicos que necesitas de cada dominio. Por ejemplo:
-
-```typescript
-import { AccountResponse, AccountCreateRequest } from "@fiado/type-kit/bin/account";
-import { CardRequest } from 'fiado-type-kit/dist/card/dtos/cardRequest.dto';
-import { AccountType } from 'fiado-type-kit/dist/account/enums/accountType.enum';
-```
-
-### Instalación 
-Para instalar la biblioteca fiado-type-kit en tu proyecto, ejecuta el siguiente comando usando npm:
-
-npm i @fiado/type-kit
-
+# fiado-type-kit
+
+## Descripción
+**fiado-type-kit** es una biblioteca TypeScript diseñada para facilitar el desarrollo de funciones AWS Lambda al proporcionar un conjunto estructurado de Data Transfer Objects (DTOs), enumeraciones y constantes. Está organizada por dominios específicos (`card`, `account`, `directory`, `otros`) para mejorar la modularidad y la reutilización del código en proyectos de AWS Lambda.
+
+## Estructura del Proyecto
+
+**fiado-type-kit/**  
+📁 `/src` - Contiene el código fuente TypeScript, organizado por dominios.
+  - 📁 `card` - Funciones y tipos relacionados con tarjetas.
+    - 📁 `dtos` - Data Transfer Objects para `card`.
+      - 📄 `cardRequest.dto.ts`
+      - 📄 `cardResponse.dto.ts`
+    - 📁 `enums` - Enumeraciones específicas de `card`.
+      - 📄 `cardType.enum.ts`
+    - 📁 `constants` - Constantes de `card`.
+      - 📄 `cardConstants.ts`
+    - 📄 `index.ts` - Exporta los elementos de `card`.
+  - 📁 `account` - Funciones y tipos relacionados con cuentas.
+    - [Repita la estructura similar a `card`]
+  - 📁 `user` - Funciones y tipos relacionados con usuarios.
+    - [Repita la estructura similar a `card`]
+📁 `/bin` - Contiene los archivos transpilados y listos para producción.
+📁 `/test` - Incluye pruebas para los distintos componentes de la biblioteca.
+📄 `package.json`
+📄 `tsconfig.json`
+📄 `README.md`
+
+## Convenciones de Nombres y Validaciones
+### Convenciones de Nombres para DTOs
+Para mantener la coherencia y claridad en nuestros DTOs (Data Transfer Objects), seguimos una convención de nombres estricta. Los nombres de los archivos DTO deben reflejar claramente su propósito y el dominio al que pertenecen. Por ejemplo, para **card**:
+
+- **Solicitudes**: El nombre debe comenzar con la entidad a la que pertenece, seguir con la acción y terminar con Request. Ejemplo: **CardActivateRequest.ts**, **CardCreateRequest.ts**, **CardUpdateRequest.ts**, **CardDeleteRequest.ts**.
+- **Respuestas**: Debe comenzar con la entidad y terminar con Response. Ejemplo: **CardBalanceResponse.ts**. **CardResponse.ts**
+
+### Uso de class-validator en DTOs
+Al definir DTOs de solicitud, es esencial aplicar validaciones a todas las propiedades de la clase para garantizar que los datos recibidos cumplan con nuestras expectativas y restricciones. Usamos **class-validator** para este propósito:
+
+- **Solicitudes**: Todas las propiedades de las clases de solicitud deben tener decoradores de **class-validator** para validar la entrada.
+- **Respuestas**: Las clases de respuesta no deben incluir validaciones de **class-validator**, ya que son utilizadas solo para enviar datos al cliente.
+
+#### Ejemplo de un DTO de Solicitud con class-validator:
+
+```typescript
+import { IsNotEmpty, IsString, IsNumber } from 'class-validator';
+
+export class CardActivateRequest {
+  @IsNotEmpty()
+  @IsString()
+  readonly userId: string;
+
+  @IsNotEmpty()
+  @IsNumber()
+  readonly cardId: number;
+}
+```
+## Uso
+Para utilizar **fiado-type-kit** en tu proyecto, asegúrate de importar los componentes específicos que necesitas de cada dominio. Por ejemplo:
+
+```typescript
+import { AccountResponse, AccountCreateRequest } from "@fiado/type-kit/bin/account";
+import { CardRequest } from 'fiado-type-kit/dist/card/dtos/cardRequest.dto';
+import { AccountType } from 'fiado-type-kit/dist/account/enums/accountType.enum';
+```
+
+### Instalación 
+Para instalar la biblioteca fiado-type-kit en tu proyecto, ejecuta el siguiente comando usando npm:
+
+npm i @fiado/type-kit
+

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

@@ -15,4 +15,5 @@ export declare class CreateBankAccountUserRequest {
     SSN_ITIN?: string;
     gender?: "M" | "F";
     externalReferenceId?: string;
+    source?: "BACKOFFICE" | "USER_APP" | "API";
 }

package/package.json

@@ -1,24 +1,24 @@
-{
-	"name": "@fiado/type-kit",
-	"version": "2.0.16",
-	"description": "",
-	"main": "bin/index.js",
-	"types": "bin/index.d.ts",
-	"scripts": {
-		"test": "jest",
-		"build": "tsc"
-	},
-	"keywords": [],
-	"author": "Fiado Inc",
-	"license": "ISC",
-	"devDependencies": {
-		"@types/node": "^20.11.20",
-		"install": "^0.13.0",
-		"npm": "^10.4.0",
-		"typescript": "^5.3.3"
-	},
-	"dependencies": {
-		"class-transformer": "^0.5.1",
-		"class-validator": "^0.14.1"
-	}
+{
+	"name": "@fiado/type-kit",
+	"version": "2.0.17",
+	"description": "",
+	"main": "bin/index.js",
+	"types": "bin/index.d.ts",
+	"scripts": {
+		"test": "jest",
+		"build": "tsc"
+	},
+	"keywords": [],
+	"author": "Fiado Inc",
+	"license": "ISC",
+	"devDependencies": {
+		"@types/node": "^20.11.20",
+		"install": "^0.13.0",
+		"npm": "^10.4.0",
+		"typescript": "^5.3.3"
+	},
+	"dependencies": {
+		"class-transformer": "^0.5.1",
+		"class-validator": "^0.14.1"
+	}
 }

package/src/account/dtos/AccountCreateRequest.ts

@@ -1,106 +1,106 @@
-import { IsBoolean, IsDateString, IsEmail, IsEnum, IsOptional, IsString, Length, Matches, ValidateNested } from 'class-validator';
-import { AddressResponse } from "../../address";
-import { CountryId } from "../../country";
-import { regexUuidV4 } from '../../helpers/constans/regex';
-import { TypeOfDirectoryId } from '../../directory';
-import { IsPhoneNumberFiado } from '../../card/validations/IsPhoneNumberConstraint';
-import { IdentificationDocument, SexDocument } from '../../identity';
-import { Profile } from "../../directory/enums/Profile";
-import { AccountLevelEnum } from "../enums/AccountLevelEnum";
-import { Provider } from '../../provider';
-import { Type } from 'class-transformer';
-
-export class AccountCreateRequest {
-
-    @IsString()
-    @Matches(regexUuidV4,
-        {
-            message: 'directoryId must be a valid UUID v4',
-        })
-    directoryId: string;
-
-
-    @IsString()
-    @Matches(regexUuidV4,
-        {
-            message: 'directoryId must be a valid UUID v4',
-        })
-    ownerDirectoryId: string;
-
-    @IsString()
-    @Matches(regexUuidV4,
-        {
-            message: 'peopleId must be a valid UUID v4',
-        })
-    peopleId: string;
-
-    @IsEnum(AccountLevelEnum)
-    accountLevel: AccountLevelEnum;
-
-    @IsEnum(TypeOfDirectoryId)
-    typeOfDirectoryId: string;
-
-    @IsString()
-    latLastNameMaternal: string
-
-    @IsString()
-    latLastNamePaternal: string
-
-    @IsString()
-    latNames: string
-
-    @IsString()
-    countryOfBirth: string
-
-    @IsString()
-    usNames: string
-
-    @IsString()
-    usLastNames: string
-
-    @IsPhoneNumberFiado()
-    phoneNumber: string;
-
-    @IsOptional()
-    @ValidateNested()
-    @Type(() => AddressResponse)
-    address: AddressResponse;
-
-    @IsEmail()
-    email: string;
-
-    @IsDateString()
-    dob: string;
-
-    @IsBoolean()
-    isHost?: boolean;
-
-    @IsOptional()
-    documentInfo?: IdentificationDocument;
-
-    @IsOptional()
-    documentNumber?: string;
-
-    @IsOptional()
-    documentType?: string;
-
-    @IsOptional()
-    @IsEnum(SexDocument)
-    gender: SexDocument;
-
-    @IsEnum(CountryId)
-    countryId: CountryId;
-
-    @IsEnum(Profile)
-    userProfile: Profile;
-
-    @IsEnum(Provider)
-    provider: Provider;
-
-    @IsOptional()
-    SSN_ITIN?: string;
-
-    @IsOptional()
-    externalReferenceId?: string;
-
-}
+import { IsBoolean, IsDateString, IsEmail, IsEnum, IsOptional, IsString, Length, Matches, ValidateNested } from 'class-validator';
+import { AddressResponse } from "../../address";
+import { CountryId } from "../../country";
+import { regexUuidV4 } from '../../helpers/constans/regex';
+import { TypeOfDirectoryId } from '../../directory';
+import { IsPhoneNumberFiado } from '../../card/validations/IsPhoneNumberConstraint';
+import { IdentificationDocument, SexDocument } from '../../identity';
+import { Profile } from "../../directory/enums/Profile";
+import { AccountLevelEnum } from "../enums/AccountLevelEnum";
+import { Provider } from '../../provider';
+import { Type } from 'class-transformer';
+
+export class AccountCreateRequest {
+
+    @IsString()
+    @Matches(regexUuidV4,
+        {
+            message: 'directoryId must be a valid UUID v4',
+        })
+    directoryId: string;
+
+
+    @IsString()
+    @Matches(regexUuidV4,
+        {
+            message: 'directoryId must be a valid UUID v4',
+        })
+    ownerDirectoryId: string;
+
+    @IsString()
+    @Matches(regexUuidV4,
+        {
+            message: 'peopleId must be a valid UUID v4',
+        })
+    peopleId: string;
+
+    @IsEnum(AccountLevelEnum)
+    accountLevel: AccountLevelEnum;
+
+    @IsEnum(TypeOfDirectoryId)
+    typeOfDirectoryId: string;
+
+    @IsString()
+    latLastNameMaternal: string
+
+    @IsString()
+    latLastNamePaternal: string
+
+    @IsString()
+    latNames: string
+
+    @IsString()
+    countryOfBirth: string
+
+    @IsString()
+    usNames: string
+
+    @IsString()
+    usLastNames: string
+
+    @IsPhoneNumberFiado()
+    phoneNumber: string;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => AddressResponse)
+    address: AddressResponse;
+
+    @IsEmail()
+    email: string;
+
+    @IsDateString()
+    dob: string;
+
+    @IsBoolean()
+    isHost?: boolean;
+
+    @IsOptional()
+    documentInfo?: IdentificationDocument;
+
+    @IsOptional()
+    documentNumber?: string;
+
+    @IsOptional()
+    documentType?: string;
+
+    @IsOptional()
+    @IsEnum(SexDocument)
+    gender: SexDocument;
+
+    @IsEnum(CountryId)
+    countryId: CountryId;
+
+    @IsEnum(Profile)
+    userProfile: Profile;
+
+    @IsEnum(Provider)
+    provider: Provider;
+
+    @IsOptional()
+    SSN_ITIN?: string;
+
+    @IsOptional()
+    externalReferenceId?: string;
+
+}

package/src/account/dtos/AccountCreateResponse.ts

@@ -1,11 +1,11 @@
-import {CreateBankAccountUserStatusEnum} from "../enums/CreateBankAccountUserStatusEnum";
-
-export class AccountCreateResponse{
-    id: string;
-    externalId: string;
-    externalUserId: string;
-    externalUserStatus: CreateBankAccountUserStatusEnum;
-    directoryId:string;
-    typeOfDirectoryId:string
-    countryId:string
+import {CreateBankAccountUserStatusEnum} from "../enums/CreateBankAccountUserStatusEnum";
+
+export class AccountCreateResponse{
+    id: string;
+    externalId: string;
+    externalUserId: string;
+    externalUserStatus: CreateBankAccountUserStatusEnum;
+    directoryId:string;
+    typeOfDirectoryId:string
+    countryId:string
 }

package/src/account/dtos/AccountInfo.ts

@@ -1,44 +1,44 @@
-import {IsEnum, IsNumber, IsOptional, IsString, Matches} from "class-validator";
-import {regexUuidV4} from "../../helpers/constans/regex";
-import {AccountEntityStatusEnum} from "../enums/AccountEntityStatusEnum";
-
-export default class AccountInfo {
-    @IsString()
-    @Matches(regexUuidV4,
-        {
-            message: 'directoryId must be a valid UUID v4',
-        })
-    id: string;
-
-    @IsString()
-    @Matches(regexUuidV4,
-        {
-            message: 'directoryId must be a valid UUID v4',
-        })
-    directoryId: string;
-
-    @IsString()
-    currencyId: string;
-
-    @IsNumber()
-    currentBalance: number;
-
-    @IsNumber()
-    availableBalance: number;
-
-    @IsNumber()
-    lockedBalance: number;
-
-    @IsString()
-    accountNumber: string;
-
-    @IsString()
-    routingNumber: string;
-
-    @IsEnum(AccountEntityStatusEnum)
-    status: AccountEntityStatusEnum;
-
-    @IsOptional()
-    @IsString()
-    externalAccountId?: string;
+import {IsEnum, IsNumber, IsOptional, IsString, Matches} from "class-validator";
+import {regexUuidV4} from "../../helpers/constans/regex";
+import {AccountEntityStatusEnum} from "../enums/AccountEntityStatusEnum";
+
+export default class AccountInfo {
+    @IsString()
+    @Matches(regexUuidV4,
+        {
+            message: 'directoryId must be a valid UUID v4',
+        })
+    id: string;
+
+    @IsString()
+    @Matches(regexUuidV4,
+        {
+            message: 'directoryId must be a valid UUID v4',
+        })
+    directoryId: string;
+
+    @IsString()
+    currencyId: string;
+
+    @IsNumber()
+    currentBalance: number;
+
+    @IsNumber()
+    availableBalance: number;
+
+    @IsNumber()
+    lockedBalance: number;
+
+    @IsString()
+    accountNumber: string;
+
+    @IsString()
+    routingNumber: string;
+
+    @IsEnum(AccountEntityStatusEnum)
+    status: AccountEntityStatusEnum;
+
+    @IsOptional()
+    @IsString()
+    externalAccountId?: string;
 }

package/src/account/dtos/AccountUpdateBalanceRequest.ts

@@ -1,12 +1,12 @@
-import {UpdateBalanceOperation} from "./UpdateBalanceOperation";
-import {IsArray, IsOptional, IsString} from "class-validator";
-
-export class AccountUpdateBalanceRequest {
-    @IsArray()
-    operations: UpdateBalanceOperation[];
-
-    // PARA IDENTIFICAR LA TRANSACCION DE COLLECTOR QUE ESTA REALIZANDO LA OPERACION
-    @IsOptional()
-    @IsString()
-    executionId?: string;
+import {UpdateBalanceOperation} from "./UpdateBalanceOperation";
+import {IsArray, IsOptional, IsString} from "class-validator";
+
+export class AccountUpdateBalanceRequest {
+    @IsArray()
+    operations: UpdateBalanceOperation[];
+
+    // PARA IDENTIFICAR LA TRANSACCION DE COLLECTOR QUE ESTA REALIZANDO LA OPERACION
+    @IsOptional()
+    @IsString()
+    executionId?: string;
 }

package/src/account/dtos/AccountUpdateRequest.ts

@@ -1,41 +1,41 @@
-import { IsBoolean, IsEnum, IsOptional, IsString } from "class-validator";
-import { AccountEntityStatusEnum } from "../enums/AccountEntityStatusEnum";
-import { AccountLevelEnum } from "../enums/AccountLevelEnum";
-import {Provider} from "../../provider";
-
-
-
-export class AccountUpdateRequest {
-
-    @IsOptional()
-    @IsEnum(AccountEntityStatusEnum)
-    status?: AccountEntityStatusEnum;
-
-    @IsOptional()
-    @IsEnum(AccountLevelEnum)
-    accountLevel?:AccountLevelEnum;
-
-    @IsOptional()
-    @IsString()
-    externalAccountId?: string;
-
-    @IsOptional()
-    @IsBoolean()
-    isPrincipal?: boolean;
-
-    @IsOptional()
-    @IsBoolean()
-    isHost?: boolean;
-
-    @IsOptional()
-    @IsString()
-    accountNumber?: string;
-
-    @IsOptional()
-    @IsString()
-    routingNumber?: string;
-
-    @IsEnum(Provider)
-    provider: Provider;
-
+import { IsBoolean, IsEnum, IsOptional, IsString } from "class-validator";
+import { AccountEntityStatusEnum } from "../enums/AccountEntityStatusEnum";
+import { AccountLevelEnum } from "../enums/AccountLevelEnum";
+import {Provider} from "../../provider";
+
+
+
+export class AccountUpdateRequest {
+
+    @IsOptional()
+    @IsEnum(AccountEntityStatusEnum)
+    status?: AccountEntityStatusEnum;
+
+    @IsOptional()
+    @IsEnum(AccountLevelEnum)
+    accountLevel?:AccountLevelEnum;
+
+    @IsOptional()
+    @IsString()
+    externalAccountId?: string;
+
+    @IsOptional()
+    @IsBoolean()
+    isPrincipal?: boolean;
+
+    @IsOptional()
+    @IsBoolean()
+    isHost?: boolean;
+
+    @IsOptional()
+    @IsString()
+    accountNumber?: string;
+
+    @IsOptional()
+    @IsString()
+    routingNumber?: string;
+
+    @IsEnum(Provider)
+    provider: Provider;
+
 }

package/src/account/dtos/BankAccountAchTransferRequest.ts

@@ -1,12 +1,12 @@
-import { AchTransferTypeEnum } from "../enums/AchTransferTypeEnum";
-
-export class BankAccountAchTransferRequest {
-    transactionNumber!: string;
-    externalAccountId!: string;
-    externalUserId!: string;
-    externalBankAccountId!: string;
-    achTransferType!: AchTransferTypeEnum;
-    amount!: number;
-    feeAmount?: number;
-    concept?: string;
-}
+import { AchTransferTypeEnum } from "../enums/AchTransferTypeEnum";
+
+export class BankAccountAchTransferRequest {
+    transactionNumber!: string;
+    externalAccountId!: string;
+    externalUserId!: string;
+    externalBankAccountId!: string;
+    achTransferType!: AchTransferTypeEnum;
+    amount!: number;
+    feeAmount?: number;
+    concept?: string;
+}