@rempays/shared-core 1.0.2-beta.1

package/dist/facebook-api/facebook.js

@@ -0,0 +1,165 @@
+import { getHttpClient } from "./http";
+export class FacebookApi {
+    static async init() {
+        if (this.token && this.phoneNumberId && this.apiVersion)
+            return;
+        this.token = process.env.FACEBOOK_API_TOKEN || null;
+        this.phoneNumberId = process.env.FACEBOOK_PHONE_NUMBER_ID || null;
+        this.apiVersion = process.env.FACEBOOK_API_VERSION || 'v18.0';
+        if (!this.token || !this.phoneNumberId) {
+            throw new Error("Facebook API environment variables are not properly configured (FACEBOOK_API_TOKEN, FACEBOOK_PHONE_NUMBER_ID)");
+        }
+        try {
+            const mask = (v) => v?.length > 6 ? `${v.slice(0, 3)}***${v.slice(-3)}` : "***";
+            console.log("[layer-core/facebook-api] Config loaded", {
+                phoneNumberId: this.phoneNumberId,
+                apiVersion: this.apiVersion,
+                tokenPreview: mask(this.token),
+            });
+        }
+        catch { }
+    }
+    static async post(path, payload) {
+        await this.init();
+        const url = `https://graph.facebook.com/${this.apiVersion}/${this.phoneNumberId}/${path}`;
+        try {
+            const http = getHttpClient(this.token);
+            const { data } = await http.post(url, payload);
+            return data;
+        }
+        catch (err) {
+            const status = err?.response?.status;
+            const data = err?.response?.data;
+            const msg = `Facebook API error${status ? " " + status : ""}: ${typeof data === "string" ? data : JSON.stringify(data)}`;
+            throw new Error(msg);
+        }
+    }
+    static async sendText(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            recipient_type: "individual",
+            to: params.to,
+            type: "text",
+            text: { body: params.body, preview_url: params.previewUrl ?? true },
+        };
+        return await this.post("messages", payload);
+    }
+    static async sendTemplate(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            to: params.to,
+            type: "template",
+            template: {
+                name: params.name,
+                language: { code: params.languageCode },
+                components: params.components,
+            },
+        };
+        return await this.post("messages", payload);
+    }
+    static async sendInteractiveButtons(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            to: params.to,
+            type: "interactive",
+            interactive: {
+                type: "button",
+                header: params.header,
+                body: { text: params.body },
+                footer: params.footer ? { text: params.footer } : undefined,
+                action: {
+                    buttons: params.buttons.map((b) => ({
+                        type: "reply",
+                        reply: { id: b.id, title: b.title },
+                    })),
+                },
+            },
+        };
+        return await this.post("messages", payload);
+    }
+    static async sendInteractiveList(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            to: params.to,
+            type: "interactive",
+            interactive: {
+                type: "list",
+                body: { text: params.body },
+                action: {
+                    button: params.buttonText,
+                    sections: params.sections.map((section) => ({
+                        title: section.title,
+                        rows: section.rows.map((row) => ({
+                            id: row.id,
+                            title: row.title,
+                            description: row.description,
+                        })),
+                    })),
+                },
+            },
+        };
+        if (params.header) {
+            payload.interactive.header = params.header;
+        }
+        if (params.footer) {
+            payload.interactive.footer = { text: params.footer };
+        }
+        return await this.post("messages", payload);
+    }
+    static async sendImage(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            to: params.to,
+            type: "image",
+            image: { link: params.link, caption: params.caption },
+        };
+        return await this.post("messages", payload);
+    }
+    static async sendDocument(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            to: params.to,
+            type: "document",
+            document: {
+                link: params.link,
+                caption: params.caption,
+                filename: params.filename,
+            },
+        };
+        return await this.post("messages", payload);
+    }
+    static async sendLocation(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            to: params.to,
+            type: "location",
+            location: {
+                latitude: params.latitude,
+                longitude: params.longitude,
+                name: params.name,
+                address: params.address,
+            },
+        };
+        return await this.post("messages", payload);
+    }
+    static async setTyping(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            status: "read",
+            message_id: params.messageId,
+            typing_indicator: { type: "text" },
+        };
+        return await this.post("messages", payload);
+    }
+    static async markAsRead(params) {
+        const payload = {
+            messaging_product: "whatsapp",
+            status: "read",
+            message_id: params.messageId,
+        };
+        return await this.post("messages", payload);
+    }
+}
+FacebookApi.token = null;
+FacebookApi.phoneNumberId = null;
+FacebookApi.apiVersion = null;

package/dist/facebook-api/http.d.ts

@@ -0,0 +1,2 @@
+import { AxiosInstance } from 'axios';
+export declare function getHttpClient(token: string): AxiosInstance;

package/dist/facebook-api/http.js

@@ -0,0 +1,14 @@
+import axios from 'axios';
+let client = null;
+export function getHttpClient(token) {
+    if (client)
+        return client;
+    client = axios.create({
+        timeout: 10000,
+        headers: {
+            'Authorization': `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    return client;
+}

package/dist/facebook-api/index.d.ts

@@ -0,0 +1,2 @@
+export { FacebookApi } from './facebook';
+export type { SendTextParams, SendTemplateParams, SendInteractiveParams, SendInteractiveListParams, SendImageParams, SendDocumentParams, SendLocationParams, SetTypingParams, MarkAsReadParams, } from './facebook';

package/dist/facebook-api/index.js

@@ -0,0 +1 @@
+export { FacebookApi } from './facebook';

package/dist/http/client.d.ts

@@ -0,0 +1,17 @@
+import { AxiosInstance, AxiosRequestConfig, CreateAxiosDefaults } from 'axios';
+export interface HttpClientConfig extends CreateAxiosDefaults {
+    token?: string;
+}
+export declare class HttpClient {
+    private client;
+    constructor(config?: HttpClientConfig);
+    getInstance(): AxiosInstance;
+    setAuthToken(token: string): void;
+    removeAuthToken(): void;
+    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    patch<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<T>;
+    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<T>;
+}
+export declare function createHttpClient(config?: HttpClientConfig): HttpClient;

package/dist/http/client.js

@@ -0,0 +1,46 @@
+import axios from 'axios';
+export class HttpClient {
+    constructor(config = {}) {
+        const { token, ...axiosConfig } = config;
+        this.client = axios.create({
+            timeout: 10000,
+            headers: {
+                ...(token && { 'Authorization': `Bearer ${token}` }),
+                'Content-Type': 'application/json',
+            },
+            ...axiosConfig,
+        });
+    }
+    getInstance() {
+        return this.client;
+    }
+    setAuthToken(token) {
+        this.client.defaults.headers.common['Authorization'] = `Bearer ${token}`;
+    }
+    removeAuthToken() {
+        delete this.client.defaults.headers.common['Authorization'];
+    }
+    async get(url, config) {
+        const response = await this.client.get(url, config);
+        return response.data;
+    }
+    async post(url, data, config) {
+        const response = await this.client.post(url, data, config);
+        return response.data;
+    }
+    async put(url, data, config) {
+        const response = await this.client.put(url, data, config);
+        return response.data;
+    }
+    async patch(url, data, config) {
+        const response = await this.client.patch(url, data, config);
+        return response.data;
+    }
+    async delete(url, config) {
+        const response = await this.client.delete(url, config);
+        return response.data;
+    }
+}
+export function createHttpClient(config) {
+    return new HttpClient(config);
+}

package/dist/http/index.d.ts

@@ -0,0 +1,2 @@
+export { HttpClient, createHttpClient } from './client';
+export type { HttpClientConfig } from './client';

package/dist/http/index.js

@@ -0,0 +1 @@
+export { HttpClient, createHttpClient } from './client';

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './cognito/index';
+export * from './auth/index';
+export * from './s3/index';
+export * from './textract/index';
+export * from './facebook-api/index';
+export * from './dynamodb/index';
+export * from './http/index';

package/dist/index.js

@@ -0,0 +1,8 @@
+// Export all modules
+export * from './cognito/index';
+export * from './auth/index';
+export * from './s3/index';
+export * from './textract/index';
+export * from './facebook-api/index';
+export * from './dynamodb/index';
+export * from './http/index';

package/dist/s3/index.d.ts

@@ -0,0 +1 @@
+export * from './s3.service';

package/dist/s3/index.js

@@ -0,0 +1 @@
+export * from './s3.service';

package/dist/s3/s3.service.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Servicio para manejar archivos en S3
+ * Usado para almacenar documentos antes de procesarlos con Textract
+ */
+export declare class S3Service {
+    private static readonly client;
+    private static readonly BUCKET_NAME;
+    /**
+     * Sube un archivo a S3 desde un buffer o URL
+     */
+    static uploadFile(params: {
+        key: string;
+        body: Buffer | Uint8Array | string;
+        contentType?: string;
+        metadata?: Record<string, string>;
+    }): Promise<string>;
+    /**
+     * Descarga un archivo de S3
+     */
+    static downloadFile(key: string): Promise<Buffer>;
+    /**
+     * Genera una key única para un documento
+     */
+    static generateDocumentKey(params: {
+        chatId: string;
+        messageId: string;
+        extension?: string;
+    }): string;
+}

package/dist/s3/s3.service.js

@@ -0,0 +1,60 @@
+import { S3Client, PutObjectCommand, GetObjectCommand } from '@aws-sdk/client-s3';
+/**
+ * Servicio para manejar archivos en S3
+ * Usado para almacenar documentos antes de procesarlos con Textract
+ */
+export class S3Service {
+    /**
+     * Sube un archivo a S3 desde un buffer o URL
+     */
+    static async uploadFile(params) {
+        try {
+            const command = new PutObjectCommand({
+                Bucket: this.BUCKET_NAME,
+                Key: params.key,
+                Body: params.body,
+                ContentType: params.contentType || 'application/octet-stream',
+                Metadata: params.metadata || {},
+            });
+            await this.client.send(command);
+            return `s3://${this.BUCKET_NAME}/${params.key}`;
+        }
+        catch (error) {
+            throw new Error(`Failed to upload file to S3: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Descarga un archivo de S3
+     */
+    static async downloadFile(key) {
+        try {
+            const command = new GetObjectCommand({
+                Bucket: this.BUCKET_NAME,
+                Key: key,
+            });
+            const response = await this.client.send(command);
+            const chunks = [];
+            if (response.Body) {
+                for await (const chunk of response.Body) {
+                    chunks.push(chunk);
+                }
+            }
+            return Buffer.concat(chunks);
+        }
+        catch (error) {
+            throw new Error(`Failed to download file from S3: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Genera una key única para un documento
+     */
+    static generateDocumentKey(params) {
+        const timestamp = Date.now();
+        const extension = params.extension ? `.${params.extension}` : '';
+        return `chats/${params.chatId}/messages/${params.messageId}-${timestamp}${extension}`;
+    }
+}
+S3Service.client = new S3Client({
+    region: process.env['AWS_REGION'] || 'us-east-1',
+});
+S3Service.BUCKET_NAME = process.env['S3_DOCUMENTS_BUCKET'] || 'rempays-documents';

package/dist/textract/index.d.ts

@@ -0,0 +1 @@
+export * from './textract.service';

package/dist/textract/index.js

@@ -0,0 +1 @@
+export * from './textract.service';

package/dist/textract/textract.service.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Servicio para extraer texto de documentos usando AWS Textract
+ */
+export declare class TextractService {
+    private static readonly client;
+    /**
+     * Analiza un documento desde S3 y extrae el texto
+     */
+    static analyzeDocumentFromS3(s3Bucket: string, s3Key: string): Promise<string>;
+    /**
+     * Analiza un documento desde bytes (para imágenes/documentos directos)
+     */
+    static analyzeDocumentFromBytes(bytes: Uint8Array): Promise<string>;
+}

package/dist/textract/textract.service.js

@@ -0,0 +1,63 @@
+import { TextractClient, AnalyzeDocumentCommand } from '@aws-sdk/client-textract';
+/**
+ * Servicio para extraer texto de documentos usando AWS Textract
+ */
+export class TextractService {
+    /**
+     * Analiza un documento desde S3 y extrae el texto
+     */
+    static async analyzeDocumentFromS3(s3Bucket, s3Key) {
+        try {
+            const command = new AnalyzeDocumentCommand({
+                Document: {
+                    S3Object: {
+                        Bucket: s3Bucket,
+                        Name: s3Key,
+                    },
+                },
+                FeatureTypes: ['FORMS', 'TABLES'],
+            });
+            const response = await this.client.send(command);
+            // Extraer texto de los bloques
+            if (!response.Blocks) {
+                return '';
+            }
+            const textBlocks = response.Blocks
+                .filter(block => block.BlockType === 'LINE' && block.Text)
+                .map(block => block.Text || '')
+                .join('\n');
+            return textBlocks;
+        }
+        catch (error) {
+            throw new Error(`Failed to analyze document with Textract: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Analiza un documento desde bytes (para imágenes/documentos directos)
+     */
+    static async analyzeDocumentFromBytes(bytes) {
+        try {
+            const command = new AnalyzeDocumentCommand({
+                Document: {
+                    Bytes: bytes,
+                },
+                FeatureTypes: ['FORMS', 'TABLES'],
+            });
+            const response = await this.client.send(command);
+            if (!response.Blocks) {
+                return '';
+            }
+            const textBlocks = response.Blocks
+                .filter(block => block.BlockType === 'LINE' && block.Text)
+                .map(block => block.Text || '')
+                .join('\n');
+            return textBlocks;
+        }
+        catch (error) {
+            throw new Error(`Failed to analyze document with Textract: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+TextractService.client = new TextractClient({
+    region: process.env['AWS_REGION'] || 'us-east-1',
+});

package/package.json

@@ -0,0 +1,103 @@
+{
+    "name": "@rempays/shared-core",
+    "version": "1.0.2-beta.1",
+    "description": "Core utilities layer for RemPays platform with AWS services integration (Cognito, S3, Secrets Manager, Textract, Facebook API, DynamoDB)",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "type": "module",
+    "private": false,
+    "author": "RemPays Team",
+    "license": "UNLICENSED",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/REMpays/shared-core.git"
+    },
+    "bugs": {
+        "url": "https://github.com/REMpays/shared-core/issues"
+    },
+    "homepage": "https://github.com/REMpays/shared-core#readme",
+    "keywords": [
+        "aws",
+        "cognito",
+        "auth",
+        "jwt",
+        "s3",
+        "textract",
+        "dynamodb",
+        "facebook-api",
+        "whatsapp",
+        "lambda",
+        "serverless",
+        "rempays"
+    ],
+    "engines": {
+        "node": ">=18.0.0",
+        "npm": ">=9.0.0"
+    },
+    "scripts": {
+        "build": "tsc",
+        "build:watch": "tsc --watch",
+        "prepublishOnly": "npm run build",
+        "dev": "tsc --watch"
+    },
+    "dependencies": {
+        "@aws-sdk/client-cognito-identity-provider": "^3.454.0",
+        "@aws-sdk/client-dynamodb": "^3.454.0",
+        "@aws-sdk/client-s3": "^3.454.0",
+        "@aws-sdk/client-textract": "^3.454.0",
+        "@aws-sdk/util-dynamodb": "^3.454.0",
+        "axios": "^1.7.7"
+    },
+    "devDependencies": {
+        "@types/node": "^20.11.0",
+        "typescript": "^5.3.0"
+    },
+    "files": [
+        "dist/**/*",
+        "README.md",
+        "LICENSE"
+    ],
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        },
+        "./cognito": {
+            "import": "./dist/cognito/index.js",
+            "types": "./dist/cognito/index.d.ts"
+        },
+        "./auth": {
+            "import": "./dist/auth/index.js",
+            "types": "./dist/auth/index.d.ts"
+        },
+        "./s3": {
+            "import": "./dist/s3/index.js",
+            "types": "./dist/s3/index.d.ts"
+        },
+        "./secrets": {
+            "import": "./dist/secrets/index.js",
+            "types": "./dist/secrets/index.d.ts"
+        },
+        "./textract": {
+            "import": "./dist/textract/index.js",
+            "types": "./dist/textract/index.d.ts"
+        },
+        "./facebook-api": {
+            "import": "./dist/facebook-api/index.js",
+            "types": "./dist/facebook-api/index.d.ts"
+        },
+        "./dynamodb": {
+            "import": "./dist/dynamodb/index.js",
+            "types": "./dist/dynamodb/index.d.ts"
+        },
+        "./http": {
+            "import": "./dist/http/index.js",
+            "types": "./dist/http/index.d.ts"
+        },
+        "./package.json": "./package.json"
+    },
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    }
+}