@rempays/shared-core 1.0.2-beta.1 → 1.0.2-beta.10

package/README.md

@@ -1,346 +1,212 @@
 # @rempays/shared-core
 
-Core utilities layer for RemPays platform with AWS services integration (Cognito, Auth, S3, Textract, Facebook API, HTTP Client).
+Librería de utilidades core para la plataforma RemPays con integración de servicios AWS (Cognito, Auth, S3, Textract, Facebook API, HTTP Client, DynamoDB).
 
-## Installation
+## Instalación
 
 ```bash
 npm install @rempays/shared-core
 ```
 
-## Modules
+## Módulos
 
-### 1. Cognito Service
+Este paquete proporciona múltiples servicios organizados por funcionalidad. Cada módulo tiene su propia documentación detallada:
 
-Authentication and user management with AWS Cognito.
+### Autenticación y Autorización
+- **[Cognito](src/cognito/README.md)** - Autenticación y gestión de usuarios con AWS Cognito
+- **[Auth/JWT Validator](src/auth/README.md)** - Validación de tokens JWT para Lambda Authorizers
 
-```typescript
-import { CognitoService } from '@rempays/shared-core/cognito';
+### Almacenamiento y Datos
+- **[DynamoDB - Chat Service](src/dynamodb/modules/chat/README.md)** - Gestión de chats y mensajes
+- **[DynamoDB - System Prompt Service](src/dynamodb/modules/system-prompt/README.md)** - Prompts del sistema versionados
+- **[S3](src/s3/README.md)** - Operaciones de almacenamiento de archivos
 
-const cognito = new CognitoService({
-  userPoolId: 'us-east-1_xxxxx',
-  clientId: 'xxxxx',
-  region: 'us-east-1'
-});
+### APIs Externas
+- **[Facebook API (WhatsApp)](src/facebook-api/README.md)** - Integración con WhatsApp Business API
+- **[HTTP Client](src/http/README.md)** - Cliente HTTP genérico con soporte de autenticación
 
-// Register user
-const result = await cognito.signUp({
-  phoneNumber: '+1234567890',
-  email: 'user@example.com',
-  password: 'SecurePass123'
-});
+### Procesamiento de Documentos
+- **[Textract](src/textract/README.md)** - Extracción de texto de documentos
 
-// Confirm registration with OTP
-await cognito.confirmSignUp('+1234567890', '123456');
+## Inicio Rápido
 
-// Sign in with custom auth
-const authResponse = await cognito.signInCustomAuth({
-  phoneNumber: '+1234567890'
-});
+### Autenticación
 
-// Verify OTP code
-const tokens = await cognito.respondToAuthChallenge({
-  phoneNumber: '+1234567890',
-  code: '123456',
-  session: authResponse.session
-});
+```typescript
+import { CognitoService } from '@rempays/shared-core/cognito';
+import { JwtValidator } from '@rempays/shared-core/auth';
 
-// Get user info
-const user = await cognito.getUser(tokens.accessToken!);
+// Registro y login de usuarios
+const cognito = new CognitoService({
+    userPoolId: process.env.COGNITO_USER_POOL_ID!,
+    clientId: process.env.COGNITO_CLIENT_ID!,
+    region: 'us-east-1',
+});
 
-// Refresh token
-const newTokens = await cognito.refreshToken({
-  refreshToken: tokens.refreshToken!
+// Validación de JWT para authorizers
+const validator = new JwtValidator({
+    region: 'us-east-1',
+    userPoolId: process.env.USER_POOL_ID!,
 });
 ```
 
-### 2. JWT Validator (Auth)
-
-Validate Cognito JWT tokens for Lambda Authorizers.
+### Servicios de DynamoDB
 
 ```typescript
-import { JwtValidator } from '@rempays/shared-core/auth';
+import { ChatService, SystemPromptService } from '@rempays/shared-core/dynamodb';
 
-const validator = new JwtValidator({
-  region: 'us-east-1',
-  userPoolId: 'us-east-1_xxxxx'
-});
+// Gestión de chats
+const chatService = new ChatService();
+await chatService.createChat({...});
+await chatService.getLastMessages('chat-123', 10);
 
-// Validate token from Authorization header
-const decoded = await validator.validateFromHeader(event.headers.Authorization);
-// Returns: { sub, username, exp, iat, token_use, ... }
-
-// Or validate token directly
-const token = 'eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...';
-const decoded = await validator.validate(token);
-
-// Use in Lambda Authorizer
-export const handler = async (event: any) => {
-  try {
-    const decoded = await validator.validateFromHeader(event.headers.Authorization);
-    return generateAllowPolicy(decoded.sub, event.methodArn, decoded);
-  } catch (error) {
-    return generateDenyPolicy('user', event.methodArn);
-  }
-};
+// Prompts del sistema
+const promptService = new SystemPromptService();
+const prompt = await promptService.getLatestActivePrompt('welcome');
 ```
 
-### 3. HTTP Client
-
-Generic HTTP client built on axios with authentication support.
+### Mensajería WhatsApp
 
 ```typescript
-import { createHttpClient, HttpClient } from '@rempays/shared-core/http';
-
-// Create basic client
-const client = createHttpClient();
+import { FacebookApi } from '@rempays/shared-core/facebook-api';
 
-// Create client with auth token
-const authClient = createHttpClient({
-  token: 'your-bearer-token',
-  baseURL: 'https://api.example.com',
-  timeout: 5000
+await FacebookApi.sendText({
+    to: '+1234567890',
+    body: '¡Hola desde WhatsApp!',
 });
 
-// Use convenience methods
-const data = await client.get('/users');
-await client.post('/users', { name: 'John' });
-await client.put('/users/1', { name: 'Jane' });
-await client.delete('/users/1');
-
-// Manage auth token dynamically
-authClient.setAuthToken('new-token');
-authClient.removeAuthToken();
-
-// Access underlying axios instance
-const axiosInstance = client.getInstance();
+await FacebookApi.sendInteractiveButtons({
+    to: '+1234567890',
+    body: 'Elige una opción:',
+    buttons: [
+        { type: 'reply', id: 'opt1', title: 'Opción 1' },
+        { type: 'reply', id: 'opt2', title: 'Opción 2' },
+    ],
+});
 ```
 
-### 4. S3 Service
-
-File operations with AWS S3.
+### Almacenamiento y Procesamiento de Archivos
 
 ```typescript
 import { S3Service } from '@rempays/shared-core/s3';
+import { TextractService } from '@rempays/shared-core/textract';
 
-// Upload file
+// Subir archivo
 const s3Uri = await S3Service.uploadFile({
-  key: 'documents/file.pdf',
-  body: buffer,
-  contentType: 'application/pdf',
-  metadata: { userId: '123' }
+    key: 'documents/file.pdf',
+    body: buffer,
+    contentType: 'application/pdf',
 });
 
-// Download file
-const fileBuffer = await S3Service.downloadFile('documents/file.pdf');
-
-// Generate document key
-const key = S3Service.generateDocumentKey({
-  chatId: 'chat123',
-  messageId: 'msg456',
-  extension: 'pdf'
-});
+// Extraer texto
+const text = await TextractService.analyzeDocumentFromS3(
+    'my-bucket',
+    'documents/file.pdf'
+);
 ```
 
-### 5. Textract Service
-
-Extract text from documents using AWS Textract.
+### Cliente HTTP
 
 ```typescript
-import { TextractService } from '@rempays/shared-core/textract';
+import { createHttpClient } from '@rempays/shared-core/http';
 
-// Analyze document from S3
-const text = await TextractService.analyzeDocumentFromS3('my-bucket', 'document.pdf');
+const client = createHttpClient({
+    baseURL: 'https://api.example.com',
+    token: 'bearer-token',
+});
 
-// Analyze document from bytes
-const imageBytes = new Uint8Array(buffer);
-const extractedText = await TextractService.analyzeDocumentFromBytes(imageBytes);
+const data = await client.get('/users');
+await client.post('/users', { name: 'John' });
 ```
 
-### 6. Facebook API (WhatsApp)
+## Variables de Entorno
 
-Send messages via WhatsApp Business API.
+### Requeridas
 
-```typescript
-import { FacebookApi } from '@rempays/shared-core/facebook-api';
+```bash
+# AWS
+AWS_REGION=us-east-1
 
-// Send text message
-await FacebookApi.sendText({
-  to: '+1234567890',
-  body: 'Hello from RemPays!',
-  previewUrl: true
-});
+# Cognito
+COGNITO_USER_POOL_ID=us-east-1_XXXXXXXXX
+COGNITO_CLIENT_ID=XXXXXXXXXXXXXXXXXXXXXXXXXX
 
-// Send template
-await FacebookApi.sendTemplate({
-  to: '+1234567890',
-  name: 'welcome_template',
-  languageCode: 'en',
-  components: []
-});
+# DynamoDB
+DYNAMODB_CHAT_TABLE=rempays-chats
+DYNAMODB_SYSTEM_PROMPT_TABLE=rempays-system-prompts
 
-// Send interactive buttons
-await FacebookApi.sendInteractiveButtons({
-  to: '+1234567890',
-  body: 'Choose an option:',
-  buttons: [
-    { type: 'reply', id: 'opt1', title: 'Option 1' },
-    { type: 'reply', id: 'opt2', title: 'Option 2' }
-  ]
-});
+# Facebook API (WhatsApp)
+FACEBOOK_API_TOKEN=your_facebook_token
+FACEBOOK_PHONE_NUMBER_ID=your_phone_number_id
+FACEBOOK_API_VERSION=v18.0  # Opcional
 
-// Send interactive list
-await FacebookApi.sendInteractiveList({
-  to: '+1234567890',
-  body: 'Select from menu:',
-  buttonText: 'View Menu',
-  sections: [
-    {
-      title: 'Main Options',
-      rows: [
-        { id: '1', title: 'Option 1', description: 'Description 1' },
-        { id: '2', title: 'Option 2', description: 'Description 2' }
-      ]
-    }
-  ]
-});
+# S3
+S3_BUCKET_NAME=your-bucket-name
+```
 
-// Send image
-await FacebookApi.sendImage({
-  to: '+1234567890',
-  link: 'https://example.com/image.jpg',
-  caption: 'Check this out!'
-});
+## Documentación de Módulos
 
-// Send document
-await FacebookApi.sendDocument({
-  to: '+1234567890',
-  link: 'https://example.com/document.pdf',
-  filename: 'invoice.pdf',
-  caption: 'Your invoice'
-});
+Para documentación detallada, ejemplos y referencia de API, consulta el README de cada módulo:
 
-// Mark as read
-await FacebookApi.markAsRead({ messageId: 'msg_id' });
-```
+- [Cognito Service](src/cognito/README.md) - Flujos completos de autenticación
+- [JWT Validator](src/auth/README.md) - Implementación de Lambda authorizer
+- [Chat Service](src/dynamodb/modules/chat/README.md) - Gestión de chats y mensajes
+- [System Prompt Service](src/dynamodb/modules/system-prompt/README.md) - Versionado de prompts
+- [S3 Service](src/s3/README.md) - Subida/descarga de archivos
+- [Textract Service](src/textract/README.md) - Extracción de texto de documentos
+- [Facebook API](src/facebook-api/README.md) - Mensajería WhatsApp
+- [HTTP Client](src/http/README.md) - Peticiones HTTP genéricas
 
-## Environment Variables
+## Permisos IAM
 
-### Cognito
-```bash
-COGNITO_USER_POOL_ID=us-east-1_XXXXXXXXX
-COGNITO_CLIENT_ID=XXXXXXXXXXXXXXXXXXXXXXXXXX
-AWS_REGION=us-east-1
-```
+Cada servicio requiere permisos IAM específicos. Consulta la documentación de cada módulo para requisitos detallados de permisos.
 
-### Facebook API (WhatsApp)
-```bash
-FACEBOOK_API_TOKEN=your_facebook_token
-FACEBOOK_PHONE_NUMBER_ID=your_phone_number_id
-FACEBOOK_API_VERSION=v18.0  # Optional, defaults to v18.0
-```
-
-## Available Methods Summary
-
-### CognitoService
-- `signUp(params)` - Register new user
-- `confirmSignUp(phoneNumber, code)` - Confirm registration with OTP
-- `signInCustomAuth(params)` - Sign in with custom authentication
-- `signInSRP(params)` - Sign in with SRP
-- `respondToAuthChallenge(params)` - Verify OTP code
-- `refreshToken(params)` - Refresh access tokens
-- `getUser(accessToken)` - Get authenticated user info
-- `adminGetUser(phoneNumber)` - Get user info (admin)
-- `adminInitiateAuth(phoneNumber)` - Initiate auth as admin
-
-### JwtValidator
-- `validate(token)` - Validate JWT token
-- `validateFromHeader(authHeader)` - Validate token from Authorization header
-- `extractToken(authHeader)` - Extract token from Bearer header
-
-### HttpClient
-- `get<T>(url, config?)` - GET request
-- `post<T>(url, data?, config?)` - POST request
-- `put<T>(url, data?, config?)` - PUT request
-- `patch<T>(url, data?, config?)` - PATCH request
-- `delete<T>(url, config?)` - DELETE request
-- `setAuthToken(token)` - Set Bearer token
-- `removeAuthToken()` - Remove Bearer token
-- `getInstance()` - Get axios instance
-
-### S3Service
-- `uploadFile(params)` - Upload file to S3
-- `downloadFile(key)` - Download file from S3
-- `generateDocumentKey(params)` - Generate unique document key
-
-### TextractService
-- `analyzeDocumentFromS3(bucket, key)` - Extract text from S3 document
-- `analyzeDocumentFromBytes(bytes)` - Extract text from byte array
-
-### FacebookApi
-- `sendText(params)` - Send text message
-- `sendTemplate(params)` - Send template message
-- `sendInteractiveButtons(params)` - Send interactive buttons
-- `sendInteractiveList(params)` - Send interactive list
-- `sendImage(params)` - Send image
-- `sendDocument(params)` - Send document
-- `sendLocation(params)` - Send location
-- `markAsRead(params)` - Mark message as read
-- `setTyping(params)` - Set typing indicator
-
-## IAM Permissions Required
-
-Your Lambda or application needs these permissions:
+### Resumen de Permisos Mínimos
 
 ```json
 {
-  "Version": "2012-10-17",
-  "Statement": [
-    {
-      "Effect": "Allow",
-      "Action": [
-        "cognito-idp:SignUp",
-        "cognito-idp:ConfirmSignUp",
-        "cognito-idp:InitiateAuth",
-        "cognito-idp:RespondToAuthChallenge",
-        "cognito-idp:GetUser",
-        "cognito-idp:AdminGetUser",
-        "cognito-idp:AdminInitiateAuth"
-      ],
-      "Resource": "arn:aws:cognito-idp:REGION:ACCOUNT_ID:userpool/USER_POOL_ID"
-    },
-    {
-      "Effect": "Allow",
-      "Action": [
-        "s3:GetObject",
-        "s3:PutObject"
-      ],
-      "Resource": "arn:aws:s3:::YOUR_BUCKET/*"
-    },
-    {
-      "Effect": "Allow",
-      "Action": [
-        "textract:AnalyzeDocument"
-      ],
-      "Resource": "*"
-    }
-  ]
+    "Version": "2012-10-17",
+    "Statement": [
+        {
+            "Effect": "Allow",
+            "Action": [
+                "cognito-idp:*",
+                "dynamodb:*",
+                "s3:GetObject",
+                "s3:PutObject",
+                "textract:AnalyzeDocument"
+            ],
+            "Resource": "*"
+        }
+    ]
 }
 ```
 
-## Development
+## Desarrollo
 
 ```bash
-# Install dependencies
+# Instalar dependencias
 npm install
 
 # Build
 npm run build
 
-# Watch mode
+# Modo watch
 npm run dev
 ```
 
-## License
+## Publicación
+
+Este paquete usa versionado y publicación automatizados:
+
+- **Releases beta**: Push a rama `develop` → publica tag `@beta`
+- **Releases producción**: Push a rama `main` → publica tag `@latest`
+
+Instalar versión beta:
+```bash
+npm install @rempays/shared-core@beta
+```
+
+## Licencia
 
 UNLICENSED

package/dist/auth/authorizer-example.js

@@ -1,18 +1,21 @@
+"use strict";
 /**
  * Ejemplo de uso del JwtValidator en un Lambda Authorizer
  *
  * Este archivo es solo de referencia, no se exporta en el paquete
  */
-import { JwtValidator } from './jwt-validator';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = void 0;
+const jwt_validator_1 = require("./jwt-validator");
 // Configuración del validador
-const validator = new JwtValidator({
+const validator = new jwt_validator_1.JwtValidator({
     region: process.env.AWS_REGION || 'us-east-1',
     userPoolId: process.env.USER_POOL_ID,
 });
 /**
  * Lambda Authorizer Handler
  */
-export const handler = async (event) => {
+const handler = async (event) => {
     try {
         // Extraer y validar el token
         const token = event.headers?.Authorization || event.headers?.authorization;
@@ -26,6 +29,7 @@ export const handler = async (event) => {
         return generatePolicy('user', 'Deny', event.methodArn);
     }
 };
+exports.handler = handler;
 /**
  * Genera una policy de IAM para API Gateway
  */

package/dist/auth/index.js

@@ -1 +1,5 @@
-export { JwtValidator } from './jwt-validator';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JwtValidator = void 0;
+var jwt_validator_1 = require("./jwt-validator");
+Object.defineProperty(exports, "JwtValidator", { enumerable: true, get: function () { return jwt_validator_1.JwtValidator; } });

package/dist/auth/jwt-validator.js

@@ -1,5 +1,8 @@
-import { createHttpClient } from '../http/client';
-export class JwtValidator {
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JwtValidator = void 0;
+const client_1 = require("../http/client");
+class JwtValidator {
     constructor(config) {
         this.jwksCache = null;
         this.config = config;
@@ -60,7 +63,7 @@ export class JwtValidator {
             return this.jwksCache;
         }
         const jwksUrl = `${this.issuer}/.well-known/jwks.json`;
-        const httpClient = createHttpClient();
+        const httpClient = (0, client_1.createHttpClient)();
         this.jwksCache = await httpClient.get(jwksUrl);
         return this.jwksCache;
     }
@@ -99,3 +102,4 @@ export class JwtValidator {
         return this.validate(token);
     }
 }
+exports.JwtValidator = JwtValidator;

package/dist/auth/types.js

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

package/dist/cognito/cognito.service.js

@@ -1,8 +1,11 @@
-import { CognitoIdentityProviderClient, SignUpCommand, InitiateAuthCommand, RespondToAuthChallengeCommand, ConfirmSignUpCommand, GetUserCommand, AdminGetUserCommand, AdminInitiateAuthCommand, AuthFlowType, ChallengeNameType, } from '@aws-sdk/client-cognito-identity-provider';
-export class CognitoService {
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CognitoService = void 0;
+const client_cognito_identity_provider_1 = require("@aws-sdk/client-cognito-identity-provider");
+class CognitoService {
     constructor(config) {
         this.config = config;
-        this.client = new CognitoIdentityProviderClient({
+        this.client = new client_cognito_identity_provider_1.CognitoIdentityProviderClient({
             region: config.region,
         });
     }
@@ -17,7 +20,7 @@ export class CognitoService {
         if (email) {
             userAttributes.push({ Name: 'email', Value: email });
         }
-        const command = new SignUpCommand({
+        const command = new client_cognito_identity_provider_1.SignUpCommand({
             ClientId: this.config.clientId,
             Username: phoneNumber,
             Password: password,
@@ -33,7 +36,7 @@ export class CognitoService {
      * Confirma el registro de un usuario con el código OTP
      */
     async confirmSignUp(phoneNumber, code) {
-        const command = new ConfirmSignUpCommand({
+        const command = new client_cognito_identity_provider_1.ConfirmSignUpCommand({
             ClientId: this.config.clientId,
             Username: phoneNumber,
             ConfirmationCode: code,
@@ -45,9 +48,9 @@ export class CognitoService {
      */
     async signInCustomAuth(params) {
         const { phoneNumber } = params;
-        const command = new InitiateAuthCommand({
+        const command = new client_cognito_identity_provider_1.InitiateAuthCommand({
             ClientId: this.config.clientId,
-            AuthFlow: AuthFlowType.CUSTOM_AUTH,
+            AuthFlow: client_cognito_identity_provider_1.AuthFlowType.CUSTOM_AUTH,
             AuthParameters: {
                 USERNAME: phoneNumber,
             },
@@ -64,9 +67,9 @@ export class CognitoService {
      */
     async signInSRP(params) {
         const { phoneNumber } = params;
-        const command = new InitiateAuthCommand({
+        const command = new client_cognito_identity_provider_1.InitiateAuthCommand({
             ClientId: this.config.clientId,
-            AuthFlow: AuthFlowType.USER_SRP_AUTH,
+            AuthFlow: client_cognito_identity_provider_1.AuthFlowType.USER_SRP_AUTH,
             AuthParameters: {
                 USERNAME: phoneNumber,
             },
@@ -86,9 +89,9 @@ export class CognitoService {
      */
     async respondToAuthChallenge(params) {
         const { phoneNumber, code, session } = params;
-        const command = new RespondToAuthChallengeCommand({
+        const command = new client_cognito_identity_provider_1.RespondToAuthChallengeCommand({
             ClientId: this.config.clientId,
-            ChallengeName: ChallengeNameType.CUSTOM_CHALLENGE,
+            ChallengeName: client_cognito_identity_provider_1.ChallengeNameType.CUSTOM_CHALLENGE,
             Session: session,
             ChallengeResponses: {
                 USERNAME: phoneNumber,
@@ -109,9 +112,9 @@ export class CognitoService {
      */
     async refreshToken(params) {
         const { refreshToken } = params;
-        const command = new InitiateAuthCommand({
+        const command = new client_cognito_identity_provider_1.InitiateAuthCommand({
             ClientId: this.config.clientId,
-            AuthFlow: AuthFlowType.REFRESH_TOKEN_AUTH,
+            AuthFlow: client_cognito_identity_provider_1.AuthFlowType.REFRESH_TOKEN_AUTH,
             AuthParameters: {
                 REFRESH_TOKEN: refreshToken,
             },
@@ -126,7 +129,7 @@ export class CognitoService {
      * Obtiene información del usuario autenticado usando el access token
      */
     async getUser(accessToken) {
-        const command = new GetUserCommand({
+        const command = new client_cognito_identity_provider_1.GetUserCommand({
             AccessToken: accessToken,
         });
         const response = await this.client.send(command);
@@ -142,7 +145,7 @@ export class CognitoService {
      * Obtiene información del usuario por username (requiere permisos de admin)
      */
     async adminGetUser(phoneNumber) {
-        const command = new AdminGetUserCommand({
+        const command = new client_cognito_identity_provider_1.AdminGetUserCommand({
             UserPoolId: this.config.userPoolId,
             Username: phoneNumber,
         });
@@ -159,10 +162,10 @@ export class CognitoService {
      * Inicia autenticación como admin (útil para backend)
      */
     async adminInitiateAuth(phoneNumber) {
-        const command = new AdminInitiateAuthCommand({
+        const command = new client_cognito_identity_provider_1.AdminInitiateAuthCommand({
             UserPoolId: this.config.userPoolId,
             ClientId: this.config.clientId,
-            AuthFlow: AuthFlowType.CUSTOM_AUTH,
+            AuthFlow: client_cognito_identity_provider_1.AuthFlowType.CUSTOM_AUTH,
             AuthParameters: {
                 USERNAME: phoneNumber,
             },
@@ -178,3 +181,4 @@ export class CognitoService {
         };
     }
 }
+exports.CognitoService = CognitoService;