@fiado/type-kit 2.1.39 → 2.1.41

package/README.md

@@ -1,70 +1,572 @@
-# fiado-type-kit
+<div align="center">
 
-## 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.
+# Fiado Type Kit
 
-## Estructura del Proyecto
+### Biblioteca de DTOs, Enums y Tipos Compartidos para el Ecosistema Fiado
+
+[![npm](https://img.shields.io/badge/npm-@fiado/type--kit-CB3837?logo=npm&logoColor=white)](https://www.npmjs.com/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![class-validator](https://img.shields.io/badge/class--validator-0.14.x-green)](https://github.com/typestack/class-validator)
+
+</div>
+
+---
+
+## Tabla de Contenidos
+
+- [Descripcion General](#descripcion-general)
+- [Arquitectura](#arquitectura)
+- [Instalacion](#instalacion)
+- [Dominios Disponibles](#dominios-disponibles)
+- [Uso](#uso)
+- [Convenciones de Desarrollo](#convenciones-de-desarrollo)
+- [Estructura de Modulos](#estructura-de-modulos)
+- [Tipos Especiales](#tipos-especiales)
+- [Dependencias](#dependencias)
+
+---
+
+## Descripcion General
+
+`@fiado/type-kit` es la **biblioteca central de tipos** del ecosistema Fiado que proporciona:
+
+- **DTOs (Data Transfer Objects)**: Clases tipadas para requests y responses de APIs
+- **Enums**: Enumeraciones para estados, tipos y categorias del negocio
+- **Entities**: Entidades base para modelos de datos
+- **Interfaces**: Contratos compartidos entre microservicios
+- **Validaciones**: Decoradores de `class-validator` para validacion de entrada
+
+### Proposito
+
+En una arquitectura de microservicios, es fundamental mantener **consistencia en los tipos de datos** que se intercambian entre servicios. Esta biblioteca:
+
+- **Centraliza** todas las definiciones de tipos en un solo lugar
+- **Garantiza** que todos los microservicios usen las mismas estructuras
+- **Facilita** la validacion de datos de entrada con decoradores
+- **Reduce** duplicacion de codigo entre proyectos
+
+---
+
+## Arquitectura
+
+```
+                    +------------------+
+                    |  @fiado/type-kit |
+                    +--------+---------+
+                             |
+        +--------------------+--------------------+
+        |                    |                    |
+        v                    v                    v
++---------------+    +---------------+    +---------------+
+| Lambda Card   |    | Lambda Account|    | Lambda Trans  |
+| Microservice  |    | Microservice  |    | Microservice  |
++---------------+    +---------------+    +---------------+
+        |                    |                    |
+        +--------------------+--------------------+
+                             |
+                             v
+                    +------------------+
+                    |   API Gateway    |
+                    +------------------+
+```
+
+### Flujo de Tipos
+
+1. **Request**: Cliente envia datos -> API Gateway -> Lambda valida con DTOs de Request
+2. **Procesamiento**: Lambda usa Enums y Entities para logica de negocio
+3. **Response**: Lambda retorna datos usando DTOs de Response -> Cliente
+
+---
+
+## Instalacion
+
+```bash
+npm install @fiado/type-kit
+```
+
+### Peer Dependencies
+
+Esta biblioteca no tiene peer dependencies, pero utiliza internamente:
+
+```json
+{
+  "class-transformer": "^0.5.1",
+  "class-validator": "^0.14.2"
+}
+```
+
+---
+
+## Dominios Disponibles
+
+La biblioteca esta organizada en **60+ dominios** que cubren todas las areas del negocio:
+
+### Servicios Core
+
+| Dominio | Descripcion | Contenido |
+|---------|-------------|-----------|
+| `account` | Cuentas bancarias y operaciones | 44 DTOs, 12 Enums |
+| `card` | Tarjetas fisicas y virtuales | 40 DTOs, 26 Enums |
+| `transaction` | Transacciones y movimientos | 24 DTOs, 6 Enums |
+| `directory` | Directorios de usuarios | 8 DTOs, 6 Enums |
+| `identity` | Verificacion de identidad (KYC) | 7 DTOs, 8 Enums |
+| `authentication` | Autenticacion y sesiones | 10 DTOs |
+
+### Servicios de Pago
+
+| Dominio | Descripcion | Contenido |
+|---------|-------------|-----------|
+| `transactionProcessor` | Procesamiento de transacciones | 39 DTOs, 7 Enums |
+| `centralPayments` | Pagos centralizados | 14 DTOs/Enums |
+| `stpSpei` | Transferencias SPEI | 10 DTOs/Enums |
+| `servicePayment` | Pago de servicios | 4 DTOs/Enums |
+| `collector` | Cobranza | 14 DTOs/Enums |
+
+### Servicios de Usuario
+
+| Dominio | Descripcion | Contenido |
+|---------|-------------|-----------|
+| `beneficiary` | Beneficiarios de transferencias | 5 DTOs/Enums |
+| `bankAccount` | Cuentas bancarias externas | 10 DTOs/Enums |
+| `address` | Direcciones | 24 DTOs/Enums |
+| `contactInfo` | Informacion de contacto | 9 DTOs/Enums |
+| `group` | Grupos de usuarios | 11 DTOs/Enums |
+| `role` | Roles y permisos | 9 DTOs/Enums |
+
+### Servicios de Riesgo
 
-**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:
+| Dominio | Descripcion | Contenido |
+|---------|-------------|-----------|
+| `riskProfile` | Perfiles de riesgo | 13 DTOs, 10 Enums |
+| `fraudPreventionEngine` | Prevencion de fraude | 5 DTOs/Enums |
+| `blacklist` | Listas negras | 5 DTOs/Enums |
+
+### Servicios de Negocio
+
+| Dominio | Descripcion | Contenido |
+|---------|-------------|-----------|
+| `issuanceBusiness` | Emision de tarjetas | 6 DTOs/Enums |
+| `pricelist` | Listas de precios | 9 DTOs/Enums |
+| `services` | Catalogo de servicios | 18 DTOs/Enums |
+| `productCatalog` | Catalogo de productos | 7 DTOs/Enums |
+| `contract` | Contratos | 3 DTOs/Enums |
+| `creditContract` | Contratos de credito | 3 DTOs/Enums |
+
+### Servicios de Comunicacion
+
+| Dominio | Descripcion | Contenido |
+|---------|-------------|-----------|
+| `notificationMessages` | Mensajes y notificaciones | 4 DTOs, 2 Enums |
+| `notificationWS` | WebSocket notifications | 2 DTOs/Enums |
+| `helpdesk` | Soporte al cliente | 3 DTOs/Enums |
+
+### Servicios de Infraestructura
+
+| Dominio | Descripcion | Contenido |
+|---------|-------------|-----------|
+| `header` | Token payload de JWT | TokenPayload |
+| `eventBridge` | Mensajes de EventBridge | EventBridgeMessageRequest |
+| `genericMessage` | Mensajes genericos | GenericMessageSourceEnum |
+| `apiResponse` | Respuesta estandar de API | FiadoApiResponse |
+| `queue` | Tipos de colas | 1 DTO |
+
+### Otros Dominios
+
+| Dominio | Descripcion |
+|---------|-------------|
+| `activity` | Actividades de usuario |
+| `app` | Configuracion de aplicacion |
+| `auth` | Autorizacion |
+| `bbvaRst` | Integracion BBVA |
+| `cnbv` | Reportes CNBV |
+| `cognitoConnector` | Integracion Cognito |
+| `country` | Paises y regiones |
+| `currency` | Monedas |
+| `device` | Dispositivos |
+| `exchangeRate` | Tipos de cambio |
+| `observations` | Observaciones KYC |
+| `p2pContact` | Contactos P2P |
+| `provider` | Proveedores |
+| `sessionActivity` | Actividad de sesion |
+| `stpAccount` | Cuentas STP |
+
+---
+
+## Uso
+
+### Importacion por Dominio (Recomendado)
+
+```typescript
+// Importar desde el dominio especifico
+import { 
+    AccountCreateRequest, 
+    AccountCreateResponse,
+    AccountLevelEnum,
+    BankAccountTypeEnum 
+} from "@fiado/type-kit/bin/account";
+
+import { 
+    CardActivateRequest,
+    CardResponse,
+    CardType,
+    CardIssuanceStatus 
+} from "@fiado/type-kit/bin/card";
+
+import { 
+    TransactionCreateRequest,
+    TransactionStatusEnum,
+    OperationEnum 
+} from "@fiado/type-kit/bin/transaction";
+```
+
+### Importacion con Namespace
 
 ```typescript
-import { IsNotEmpty, IsString, IsNumber } from 'class-validator';
+import { Account, Card, Transaction } from "@fiado/type-kit";
+
+// Usar con namespace
+const request: Account.AccountCreateRequest = { ... };
+const cardType: Card.CardType = Card.CardType.VIRTUAL;
+const status: Transaction.TransactionStatusEnum = Transaction.TransactionStatusEnum.COMPLETED;
+```
+
+### Ejemplo: Crear una Cuenta
+
+```typescript
+import { 
+    AccountCreateRequest, 
+    AccountCreateResponse,
+    BankAccountTypeEnum,
+    AccountLevelEnum 
+} from "@fiado/type-kit/bin/account";
+
+async function createAccount(data: AccountCreateRequest): Promise<AccountCreateResponse> {
+    // Validar que el tipo de cuenta sea valido
+    if (data.accountType === BankAccountTypeEnum.SAVINGS) {
+        // Logica para cuenta de ahorro
+    }
+    
+    // Verificar nivel de cuenta
+    if (data.level === AccountLevelEnum.LEVEL_2) {
+        // Requiere verificacion adicional
+    }
+    
+    return { accountId: "...", status: "CREATED" };
+}
+```
+
+### Ejemplo: Procesar Transaccion
+
+```typescript
+import { 
+    TransactionCreateRequest,
+    TransactionCreateResponse,
+    TransactionStatusEnum,
+    OperationEnum 
+} from "@fiado/type-kit/bin/transaction";
+
+async function processTransaction(
+    request: TransactionCreateRequest
+): Promise<TransactionCreateResponse> {
+    
+    if (request.operation === OperationEnum.CREDIT) {
+        // Procesar credito
+    } else if (request.operation === OperationEnum.DEBIT) {
+        // Procesar debito
+    }
+    
+    return {
+        transactionId: "...",
+        status: TransactionStatusEnum.COMPLETED
+    };
+}
+```
+
+### Ejemplo: Validar Request con class-validator
+
+```typescript
+import { validate } from 'class-validator';
+import { plainToClass } from 'class-transformer';
+import { CardActivateRequest } from "@fiado/type-kit/bin/card";
+
+async function validateRequest(body: any): Promise<CardActivateRequest> {
+    const request = plainToClass(CardActivateRequest, body);
+    const errors = await validate(request);
+    
+    if (errors.length > 0) {
+        throw new Error(`Validation failed: ${errors.map(e => e.toString()).join(', ')}`);
+    }
+    
+    return request;
+}
+```
+
+---
+
+## Convenciones de Desarrollo
+
+### Nomenclatura de DTOs
+
+| Tipo | Patron | Ejemplo |
+|------|--------|---------|
+| **Request** | `{Entity}{Action}Request` | `CardActivateRequest`, `AccountCreateRequest` |
+| **Response** | `{Entity}{Action}Response` | `CardBalanceResponse`, `AccountCreateResponse` |
+| **Query** | `{Entity}QueryParams` | `TransactionQueryParams` |
+| **Item** | `{Entity}Item` | `TransactionItem`, `PocketItem` |
+
+### Nomenclatura de Enums
+
+| Tipo | Patron | Ejemplo |
+|------|--------|---------|
+| **Status** | `{Entity}StatusEnum` | `CardIssuanceStatus`, `TransactionStatusEnum` |
+| **Type** | `{Entity}TypeEnum` | `BankAccountTypeEnum`, `CardType` |
+| **Operation** | `{Action}Enum` | `OperationEnum`, `PocketOperationTypeEnum` |
+
+### Validaciones con class-validator
+
+**Requests**: DEBEN incluir decoradores de validacion
+
+```typescript
+import { IsNotEmpty, IsString, IsNumber, IsEnum, IsOptional } from 'class-validator';
 
 export class CardActivateRequest {
-  @IsNotEmpty()
-  @IsString()
-  readonly userId: string;
+    @IsNotEmpty()
+    @IsString()
+    readonly cardId: string;
+
+    @IsNotEmpty()
+    @IsString()
+    readonly userId: string;
 
-  @IsNotEmpty()
-  @IsNumber()
-  readonly cardId: number;
+    @IsOptional()
+    @IsEnum(ActivationMethod)
+    readonly method?: ActivationMethod;
 }
 ```
-## Uso
-Para utilizar **fiado-type-kit** en tu proyecto, asegúrate de importar los componentes específicos que necesitas de cada dominio. Por ejemplo:
+
+**Responses**: NO deben incluir validaciones
 
 ```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';
+export class CardActivateResponse {
+    cardId: string;
+    status: CardIssuanceStatus;
+    activatedAt: string;
+}
+```
+
+### Estructura de Modulo
+
+Cada dominio sigue esta estructura:
+
+```
+{domain}/
+├── dtos/                    # Data Transfer Objects
+│   ├── {Entity}Request.ts
+│   ├── {Entity}Response.ts
+│   └── Internal/            # DTOs internos (opcional)
+├── enums/                   # Enumeraciones
+│   ├── {Entity}StatusEnum.ts
+│   └── {Entity}TypeEnum.ts
+├── entities/                # Entidades base (opcional)
+│   └── {Entity}EntityBase.ts
+├── constants/               # Constantes (opcional)
+│   └── {entity}Constants.ts
+└── index.ts                 # Exportaciones del modulo
 ```
 
-### Instalación 
-Para instalar la biblioteca fiado-type-kit en tu proyecto, ejecuta el siguiente comando usando npm:
+---
+
+## Estructura de Modulos
+
+### Ejemplo: Modulo Account
+
+```
+account/
+├── dtos/
+│   ├── AccountCreateRequest.ts
+│   ├── AccountCreateResponse.ts
+│   ├── AccountUpdateRequest.ts
+│   ├── GetAccountResponse.ts
+│   ├── GetAccountBalanceResponse.ts
+│   ├── BankAccountP2pTransferRequest.ts
+│   ├── BankAccountP2pTransferResponse.ts
+│   ├── SPEITransferCreateRequest.ts
+│   ├── SPEITransferResponse.ts
+│   └── ... (44 DTOs total)
+├── entities/
+│   ├── AccountEntityBase.ts
+│   └── BankInfo.ts
+├── enums/
+│   ├── AccountEntityStatusEnum.ts
+│   ├── BankAccountTypeEnum.ts
+│   ├── AccountLevelEnum.ts
+│   ├── SpeiTransferStatusEnum.ts
+│   └── ... (12 Enums total)
+└── index.ts
+```
+
+### Ejemplo: Modulo Card
+
+```
+card/
+├── dtos/
+│   ├── CardActivateRequest.ts
+│   ├── CardApplicationRequest.ts
+│   ├── CardUpdateRequest.ts
+│   ├── CardResponse.ts
+│   ├── CardBalanceResponse.ts
+│   ├── CardSensitiveInformationResponse.ts
+│   └── Internal/
+│       ├── CreateBankAccountCardRequest.ts
+│       ├── CreateBankAccountCardResponse.ts
+│       ├── ActivateBankAccountCardRequest.ts
+│       └── ... (DTOs internos)
+├── enums/
+│   ├── CardType.ts
+│   ├── CardIssuanceStatus.ts
+│   ├── Brand.ts
+│   ├── VirtualOrPhysical.ts
+│   ├── ShippingStatus.ts
+│   └── issuance/
+│       ├── KycStatus.ts
+│       ├── UserStatus.ts
+│       └── IssuanceFlow.ts
+├── validations/
+│   └── cardValidations.ts
+└── index.ts
+```
+
+---
+
+## Tipos Especiales
+
+### TokenPayload
+
+Interface para el payload del token JWT de Cognito:
+
+```typescript
+import { TokenPayload } from "@fiado/type-kit/bin/header";
+
+interface TokenPayload {
+    directoryId: string;           // ID del directorio
+    typeOfDirectoryId: TypeOfDirectoryId;
+    peopleId: string | null;       // ID de persona
+    sub: string;                   // Subject (Cognito user ID)
+    app: string;                   // Aplicacion origen
+    issuer: string;                // Emisor del token
+    scope: string;                 // Scope del token
+    phoneNumber?: string | null;   // Telefono
+    status: Status | null;         // Estado del usuario
+    id: string;                    // ID interno
+    profileId?: string | null;     // ID de perfil
+    email?: string | null;         // Email
+    event_id?: string;             // ID de evento
+    sponsorDirectoryId?: string | null; // Sponsor
+}
+```
+
+### FiadoApiResponse
+
+Interface estandar para respuestas de API:
+
+```typescript
+import FiadoApiResponse from "@fiado/type-kit/bin/apiResponse";
+
+interface FiadoApiResponse<T> {
+    data: T;                    // Datos de respuesta
+    date: string | null;        // Timestamp
+    code: string | null;        // Codigo de respuesta
+    msg: string | null;         // Mensaje
+    description: string | null; // Descripcion
+}
+```
+
+### EventBridgeMessageRequest
+
+Clase para mensajes de EventBridge:
+
+```typescript
+import { EventBridgeMessageRequest } from "@fiado/type-kit/bin/eventBridge";
+
+class EventBridgeMessageRequest<T> extends GenericMessageRequest<T> {
+    // Hereda propiedades de GenericMessageRequest
+    // - source: GenericMessageSourceEnum
+    // - payload: T
+    // - eventType: string
+}
+```
+
+---
+
+## Dependencias
+
+### Runtime
+
+| Dependencia | Version | Proposito |
+|-------------|---------|-----------|
+| `class-transformer` | ^0.5.1 | Transformacion de objetos planos a clases |
+| `class-validator` | ^0.14.2 | Validacion de DTOs con decoradores |
+
+### Desarrollo
+
+| Dependencia | Version | Proposito |
+|-------------|---------|-----------|
+| `@types/node` | ^20.11.20 | Tipos de Node.js |
+| `typescript` | ^5.3.3 | Compilador TypeScript |
+
+---
+
+## Compilacion y Publicacion
+
+### Build
+
+```bash
+npm run build
+```
+
+Genera archivos `.js` y `.d.ts` en el directorio `bin/`.
+
+### Test
+
+```bash
+npm test
+```
+
+### Publicacion
+
+```bash
+npm version patch|minor|major
+npm publish
+```
+
+---
+
+## Estructura del Proyecto
+
+```
+fiado-type-kit/
+├── src/                        # Codigo fuente
+│   ├── index.ts                # Exportaciones principales
+│   ├── account/                # Dominio Account (59 items)
+│   ├── card/                   # Dominio Card (69 items)
+│   ├── transaction/            # Dominio Transaction (31 items)
+│   ├── transactionProcessor/   # Dominio TransactionProcessor (47 items)
+│   ├── directory/              # Dominio Directory (15 items)
+│   ├── identity/               # Dominio Identity (16 items)
+│   ├── riskProfile/            # Dominio RiskProfile (24 items)
+│   ├── ... (60+ dominios)
+│   └── header/                 # TokenPayload
+├── bin/                        # Archivos compilados
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+---
+
+<div align="center">
+
+**Fiado Inc.** | @fiado/type-kit v2.1.40
 
-npm i @fiado/type-kit
+</div>
 

package/bin/card/validations/CardUpdateKeyConstraint.js

@@ -6,7 +6,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IsValueValid = exports.CardUpdateKeyConstraint = exports.IsReasonRequiredForCancelledStatusConstraint = void 0;
+exports.CardUpdateKeyConstraint = exports.IsReasonRequiredForCancelledStatusConstraint = void 0;
+exports.IsValueValid = IsValueValid;
 const class_validator_1 = require("class-validator");
 const Status_1 = require("../enums/Status");
 const UpdateKey_1 = require("../enums/UpdateKey");
@@ -70,4 +71,3 @@ function IsValueValid(validationOptions) {
         });
     };
 }
-exports.IsValueValid = IsValueValid;

package/bin/card/validations/IsPhoneNumberConstraint.js

@@ -6,7 +6,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IsPhoneNumberFiado = exports.IsPhoneNumberConstraint = void 0;
+exports.IsPhoneNumberConstraint = void 0;
+exports.IsPhoneNumberFiado = IsPhoneNumberFiado;
 const class_validator_1 = require("class-validator");
 const regex_1 = require("../../helpers/constans/regex");
 let IsPhoneNumberConstraint = class IsPhoneNumberConstraint {
@@ -36,4 +37,3 @@ function IsPhoneNumberFiado(validationOptions) {
         });
     };
 }
-exports.IsPhoneNumberFiado = IsPhoneNumberFiado;

package/bin/index.d.ts

@@ -54,3 +54,4 @@ export * as Cnbv from './cnbv';
 export * as PayrollBusiness from './payroll-business';
 export * as Event from './event';
 export * as NotificationWS from './notificationWS';
+export * as ZendeskMessaging from './zendeskMessaging';

package/bin/index.js

@@ -15,16 +15,26 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.App = exports.Address = exports.Beneficiary = exports.Activity = exports.Account = exports.Crypto = void 0;
-exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = void 0;
+exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.Activity = __importStar(require("./activity"));
@@ -81,3 +91,4 @@ exports.Cnbv = __importStar(require("./cnbv"));
 exports.PayrollBusiness = __importStar(require("./payroll-business"));
 exports.Event = __importStar(require("./event"));
 exports.NotificationWS = __importStar(require("./notificationWS"));
+exports.ZendeskMessaging = __importStar(require("./zendeskMessaging"));

package/bin/transactionProcessor/enums/AsyncTxStatusEnum.d.ts

@@ -2,5 +2,6 @@ export declare enum AsyncTxStatusEnum {
     PENDING = "PENDING",
     CANCELLED = "CANCELLED",
     RETURNED = "RETURNED",
-    APPROVED = "APPROVED"
+    APPROVED = "APPROVED",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR"
 }

package/bin/transactionProcessor/enums/AsyncTxStatusEnum.js

@@ -7,4 +7,5 @@ var AsyncTxStatusEnum;
     AsyncTxStatusEnum["CANCELLED"] = "CANCELLED";
     AsyncTxStatusEnum["RETURNED"] = "RETURNED";
     AsyncTxStatusEnum["APPROVED"] = "APPROVED";
+    AsyncTxStatusEnum["TIMEOUT_ERROR"] = "TIMEOUT_ERROR";
 })(AsyncTxStatusEnum || (exports.AsyncTxStatusEnum = AsyncTxStatusEnum = {}));

package/bin/zendeskMessaging/index.d.ts

@@ -0,0 +1,3 @@
+export * from './interfaces/IZendeskWebhook';
+export * from './interfaces/INormalizedNotificationEvent';
+export * from './interfaces/ISunshineConversations';

package/bin/zendeskMessaging/index.js

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

package/bin/zendeskMessaging/interfaces/INormalizedNotificationEvent.d.ts

@@ -0,0 +1,21 @@
+export interface INormalizedNotificationEvent {
+    eventType: 'SUPPORT_MESSAGE_RECEIVED';
+    source: 'ZENDESK_MESSAGING';
+    timestamp: string;
+    correlationId: string;
+    payload: {
+        userId: string;
+        peopleId?: string;
+        message: {
+            conversationId: string;
+            preview: string;
+            senderType: 'AGENT' | 'BOT' | 'SYSTEM';
+            senderName: string;
+        };
+    };
+    metadata: {
+        zendeskEventId: string;
+        zendeskMessageId: string;
+        priority: 'NORMAL' | 'HIGH';
+    };
+}

package/bin/zendeskMessaging/interfaces/INormalizedNotificationEvent.js

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

package/bin/zendeskMessaging/interfaces/ISunshineConversations.d.ts

@@ -0,0 +1,15 @@
+export interface ISunshineConversationParticipant {
+    id: string;
+    userId: string;
+    unreadCount?: number;
+    userExternalId?: string;
+    lastRead?: string;
+}
+export interface ISunshineUser {
+    id: string;
+    externalId?: string;
+    signedUpAt?: string;
+    profile?: {
+        locale?: string;
+    };
+}

package/bin/zendeskMessaging/interfaces/ISunshineConversations.js

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

package/bin/zendeskMessaging/interfaces/IZendeskWebhook.d.ts

@@ -0,0 +1,51 @@
+export interface IZendeskMessagingWebhookPayload {
+    app: {
+        id: string;
+    };
+    webhook: {
+        id: string;
+        version: string;
+    };
+    events: IZendeskMessagingEvent[];
+}
+export interface IZendeskMessagingEvent {
+    id: string;
+    type: string;
+    createdAt: string;
+    payload: {
+        conversation: {
+            id: string;
+            type: string;
+        };
+        message: IZendeskMessage;
+        user?: IZendeskUser;
+    };
+}
+export interface IZendeskMessage {
+    id: string;
+    received: string;
+    content: {
+        type: string;
+        text?: string;
+    };
+    author: {
+        type: 'user' | 'business';
+        userId?: string;
+        displayName?: string;
+    };
+    source?: {
+        type: string;
+        integrationId?: string;
+    };
+}
+export interface IZendeskUser {
+    id: string;
+    externalId?: string;
+    signedUpAt?: string;
+    profile?: {
+        givenName?: string;
+        surname?: string;
+        email?: string;
+        locale?: string;
+    };
+}

package/bin/zendeskMessaging/interfaces/IZendeskWebhook.js

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

package/package.json

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

package/src/index.ts

@@ -54,3 +54,4 @@ export * as Cnbv from './cnbv';
 export * as PayrollBusiness from './payroll-business';
 export * as Event from './event';
 export * as NotificationWS from './notificationWS';
+export * as ZendeskMessaging from './zendeskMessaging';

package/src/transactionProcessor/enums/AsyncTxStatusEnum.ts

@@ -3,4 +3,5 @@ export enum AsyncTxStatusEnum {
     CANCELLED = "CANCELLED",
     RETURNED = "RETURNED",
     APPROVED = "APPROVED",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR",
 }

package/src/zendeskMessaging/index.ts

@@ -0,0 +1,3 @@
+export * from './interfaces/IZendeskWebhook';
+export * from './interfaces/INormalizedNotificationEvent';
+export * from './interfaces/ISunshineConversations';

package/src/zendeskMessaging/interfaces/INormalizedNotificationEvent.ts

@@ -0,0 +1,21 @@
+export interface INormalizedNotificationEvent {
+    eventType: 'SUPPORT_MESSAGE_RECEIVED';
+    source: 'ZENDESK_MESSAGING';
+    timestamp: string;
+    correlationId: string;
+    payload: {
+        userId: string;
+        peopleId?: string;
+        message: {
+            conversationId: string;
+            preview: string;
+            senderType: 'AGENT' | 'BOT' | 'SYSTEM';
+            senderName: string;
+        };
+    };
+    metadata: {
+        zendeskEventId: string;
+        zendeskMessageId: string;
+        priority: 'NORMAL' | 'HIGH';
+    };
+}

package/src/zendeskMessaging/interfaces/ISunshineConversations.ts

@@ -0,0 +1,14 @@
+export interface ISunshineConversationParticipant {
+    id: string;
+    userId: string;
+    unreadCount?: number;
+    userExternalId?: string;
+    lastRead?: string;
+}
+
+export interface ISunshineUser {
+    id: string;
+    externalId?: string;
+    signedUpAt?: string;
+    profile?: { locale?: string };
+}

package/src/zendeskMessaging/interfaces/IZendeskWebhook.ts

@@ -0,0 +1,40 @@
+export interface IZendeskMessagingWebhookPayload {
+    app: { id: string };
+    webhook: { id: string; version: string };
+    events: IZendeskMessagingEvent[];
+}
+
+export interface IZendeskMessagingEvent {
+    id: string;
+    type: string;
+    createdAt: string;
+    payload: {
+        conversation: { id: string; type: string };
+        message: IZendeskMessage;
+        user?: IZendeskUser;
+    };
+}
+
+export interface IZendeskMessage {
+    id: string;
+    received: string;
+    content: { type: string; text?: string };
+    author: {
+        type: 'user' | 'business';
+        userId?: string;
+        displayName?: string;
+    };
+    source?: { type: string; integrationId?: string };
+}
+
+export interface IZendeskUser {
+    id: string;
+    externalId?: string;
+    signedUpAt?: string;
+    profile?: {
+        givenName?: string;
+        surname?: string;
+        email?: string;
+        locale?: string;
+    };
+}

package/bin/bankAccount/dtos/ExternalAccountType.d.ts

@@ -1,4 +0,0 @@
-export declare class ExternalAccountType {
-    id?: number;
-    name?: string;
-}

package/bin/bankAccount/dtos/ExternalAccountType.js

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

package/bin/centralPayments/dtos/CentralPaymentsDocumentImages.d.ts

@@ -1,6 +0,0 @@
-import { DocumentSideEnum } from "../../identity";
-export declare class CentralPaymentsDocumentImages {
-    side: DocumentSideEnum;
-    url: string;
-    extension: string;
-}

package/bin/centralPayments/dtos/CentralPaymentsDocumentImages.js

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

package/bin/centralPayments/dtos/CentralPaymentsDocumentUploadRequest.d.ts

@@ -1,6 +0,0 @@
-import { IdentificationDocument } from "../../identity";
-import { CentralPaymentsDocumentImages } from "./CentralPaymentsDocumentImages";
-export declare class CentralPaymentsDocumentUploadRequest {
-    documentInfo: IdentificationDocument;
-    documentImages: CentralPaymentsDocumentImages[];
-}

package/bin/centralPayments/dtos/CentralPaymentsDocumentUploadRequest.js

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

package/bin/cognitoConnector/dtos/SignUpBackofficeRequest.d.ts

@@ -1,13 +0,0 @@
-export declare class SignUpBackofficeRequest {
-    name: string;
-    phoneNumber: string;
-    countryOfBirth: string;
-    MEX_DebitAccountWish: boolean;
-    USA_DebitAccountWish: boolean;
-    countryOfDomicile: string;
-    myReferralCode?: string;
-    referralCode?: string;
-    groupId?: string;
-    isAgent: boolean;
-    agentGroupId?: string;
-}

package/bin/cognitoConnector/dtos/SignUpBackofficeRequest.js

@@ -1,71 +0,0 @@
-"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.SignUpBackofficeRequest = void 0;
-const class_validator_1 = require("class-validator");
-class SignUpBackofficeRequest {
-}
-exports.SignUpBackofficeRequest = SignUpBackofficeRequest;
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", String)
-], SignUpBackofficeRequest.prototype, "name", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", String)
-], SignUpBackofficeRequest.prototype, "phoneNumber", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", String)
-], SignUpBackofficeRequest.prototype, "countryOfBirth", void 0);
-__decorate([
-    (0, class_validator_1.IsBoolean)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", Boolean)
-], SignUpBackofficeRequest.prototype, "MEX_DebitAccountWish", void 0);
-__decorate([
-    (0, class_validator_1.IsBoolean)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", Boolean)
-], SignUpBackofficeRequest.prototype, "USA_DebitAccountWish", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", String)
-], SignUpBackofficeRequest.prototype, "countryOfDomicile", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsOptional)(),
-    __metadata("design:type", String)
-], SignUpBackofficeRequest.prototype, "myReferralCode", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsOptional)(),
-    __metadata("design:type", String)
-], SignUpBackofficeRequest.prototype, "referralCode", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsOptional)(),
-    __metadata("design:type", String)
-], SignUpBackofficeRequest.prototype, "groupId", void 0);
-__decorate([
-    (0, class_validator_1.IsBoolean)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", Boolean)
-], SignUpBackofficeRequest.prototype, "isAgent", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsOptional)(),
-    __metadata("design:type", String)
-], SignUpBackofficeRequest.prototype, "agentGroupId", void 0);

package/bin/pricelist/dtos/GetPriceListDirectoriesResponse.d.ts

@@ -1,28 +0,0 @@
-import { Company } from "../../company";
-import { Provider } from "../../provider";
-import { ServiceTypeEnum } from "../../services";
-import { ServiceRecurrenceEnum } from "../../services/enums/ServiceRecurrenceEnum";
-export declare class GetPriceListDirectoriesResponse {
-    serviceId: string;
-    company: Company;
-    provider: Provider;
-    type: ServiceTypeEnum;
-    basePrice: number;
-    recurrence: ServiceRecurrenceEnum;
-    currencyId: string;
-    fees: any;
-    taxes: any;
-    globalDiscounts: {
-        discountType: string;
-        discountValue: number;
-    }[];
-    directories: {
-        directoryId: string;
-        appliedDiscounts: {
-            discountType: string;
-            discountValue: number;
-            source: string;
-            referenceId: string;
-        }[];
-    }[];
-}

package/bin/pricelist/dtos/GetPriceListDirectoriesResponse.js

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

package/bin/services/dtos/GetMembershipListAppResponse.d.ts

@@ -1,4 +0,0 @@
-export declare class GetServiceListAppResponse {
-    items: any[];
-    index: string | null;
-}

package/bin/services/dtos/GetMembershipListAppResponse.js

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

package/bin/services/dtos/GetServiceMembershipListAResponse.d.ts

@@ -1,4 +0,0 @@
-export declare class GetServiceMembershipListAResponse {
-    items: any[];
-    index: string | null;
-}

package/bin/services/dtos/GetServiceMembershipListAResponse.js

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

package/bin/services/enums/ServiceProviderEnum.d.ts

@@ -1,5 +0,0 @@
-export declare enum ServiceProviderEnum {
-    CP = "CP",
-    TERN = "TERN",
-    PAGOCONFIADO = "PAGOCONFIADO"
-}

package/bin/services/enums/ServiceProviderEnum.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServiceProviderEnum = void 0;
-var ServiceProviderEnum;
-(function (ServiceProviderEnum) {
-    ServiceProviderEnum["CP"] = "CP";
-    ServiceProviderEnum["TERN"] = "TERN";
-    ServiceProviderEnum["PAGOCONFIADO"] = "PAGOCONFIADO";
-})(ServiceProviderEnum || (exports.ServiceProviderEnum = ServiceProviderEnum = {}));