novapsis 1.0.0

package/LICENSE

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Vercel, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,211 @@
+# ⚡ novapsis (SDK Oficial)
+
+> SDK oficial de **Novapsis SM** para Node.js, Next.js, Express, NestJS y TypeScript. Conecta WhatsApp Business Cloud API, Onboarding Hosted B2B (Marca Blanca), CRM, Agentes de IA y Verificación HMAC de Webhooks en minutos.
+
+[![npm version](https://img.shields.io/npm/v/novapsis.svg)](https://www.npmjs.com/package/novapsis)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 📦 Instalación
+
+```bash
+# Con pnpm (recomendado)
+pnpm add novapsis
+
+# Con npm
+npm install novapsis
+
+# Con yarn
+yarn add novapsis
+```
+
+---
+
+## 🚀 Inicio Rápido
+
+Obtén tu API Key (`nvs_live_...` o `nvs_test_...`) desde el panel de control de [Novapsis SM](https://app.novapsis.com).
+
+```typescript
+import { Novapsis } from 'novapsis';
+
+const novapsis = new Novapsis({
+  apiKey: process.env.NOVAPSIS_API_KEY!,
+});
+```
+
+---
+
+## 📱 1. Envío de Mensajes por WhatsApp
+
+### Mensaje de Texto
+```typescript
+await novapsis.whatsapp.sendText({
+  to: '34600112233', // Teléfono internacional sin '+' ni espacios
+  text: '¡Hola! Tu pedido ha sido confirmado con éxito.',
+});
+```
+
+### Documentos / Facturas PDF
+```typescript
+await novapsis.whatsapp.sendDocument({
+  to: '34600112233',
+  documentUrl: 'https://tu-dominio.com/factura-1024.pdf',
+  filename: 'factura_1024.pdf',
+  caption: 'Adjuntamos tu factura correspondiente a este mes.',
+});
+```
+
+### Imágenes y Multimedia
+```typescript
+// Imagen
+await novapsis.whatsapp.sendImage({
+  to: '34600112233',
+  imageUrl: 'https://tu-dominio.com/promo.png',
+  caption: '🔥 Descuento especial exclusivo para ti.',
+});
+
+// Audio / Nota de Voz
+await novapsis.whatsapp.sendAudio({
+  to: '34600112233',
+  audioUrl: 'https://tu-dominio.com/audio.mp3',
+});
+
+// Ubicación en el Mapa
+await novapsis.whatsapp.sendLocation({
+  to: '34600112233',
+  latitude: 40.416775,
+  longitude: -3.703790,
+  name: 'Oficina Central Madrid',
+  address: 'Calle Gran Vía 28, Madrid, España',
+});
+```
+
+### Plantillas Oficiales de Meta (Templates)
+```typescript
+await novapsis.whatsapp.sendTemplate({
+  to: '34600112233',
+  templateName: 'recordatorio_cita',
+  languageCode: 'es',
+  components: [
+    {
+      type: 'body',
+      parameters: [
+        { type: 'text', text: 'Carlos' },
+        { type: 'text', text: 'Mañana a las 10:00 AM' },
+      ],
+    },
+  ],
+});
+```
+
+---
+
+## 🏢 2. Multi-Tenant y Sedes (B2B Tech Provider)
+
+Si tienes un CRM o plataforma multi-tenant y quieres que tus clientes o sedes conecten su propio número de WhatsApp con su cuenta de Meta:
+
+```typescript
+// 1. Genera una sesión de conexión hosted
+const session = await novapsis.onboarding.createSession({
+  clientName: 'Sede Barcelona',
+  redirectUrl: 'https://tu-crm.com/sedes/12/whatsapp-callback',
+  logoUrl: 'https://tu-crm.com/logo.png', // Marca blanca (Plan PRO)
+  brandColor: '#0ea5e9',                // Marca blanca (Plan PRO)
+  metadata: { sede_id: 'sede_12' },
+});
+
+// 2. Abre session.session_url en un modal o ventana popup en tu frontend
+console.log(session.session_url);
+```
+
+Cuando envíes mensajes para esa sede, solo pasa el `connectionId`:
+```typescript
+await novapsis.whatsapp.sendText({
+  connectionId: 'UUID_DE_LA_SEDE',
+  to: '34600112233',
+  text: 'Hola desde la Sede Barcelona.',
+});
+```
+
+---
+
+## 🔒 3. Webhooks & Verificación HMAC
+
+Garantiza que todos los webhooks entrantes son 100% legítimos y no han sido manipulados:
+
+### En Next.js (App Router: `app/api/webhooks/novapsis/route.ts`)
+```typescript
+import { NextResponse } from 'next/server';
+import { Novapsis } from 'novapsis';
+
+const novapsis = new Novapsis({
+  apiKey: process.env.NOVAPSIS_API_KEY!,
+});
+
+export async function POST(req: Request) {
+  const rawBody = await req.text();
+  const signature = req.headers.get('x-novapsis-signature');
+
+  // Validar firma criptográfica
+  const isValid = novapsis.webhooks.verifySignature(
+    rawBody,
+    signature,
+    process.env.NOVAPSIS_WEBHOOK_SECRET!
+  );
+
+  if (!isValid) {
+    return NextResponse.json({ error: 'Firma inválida' }, { status: 401 });
+  }
+
+  const payload = JSON.parse(rawBody);
+
+  if (payload.event === 'whatsapp.message_received') {
+    const { connection_id, external_user_id, content, media_url } = payload.data;
+    console.log(`Mensaje de ${external_user_id} recibido: ${content}`);
+  }
+
+  return NextResponse.json({ ok: true });
+}
+```
+
+---
+
+## 🤖 4. Agentes de Inteligencia Artificial (RAG)
+
+```typescript
+const result = await novapsis.ai.execute({
+  agentId: 'ag_prod_consultas_ia',
+  message: '¿Cuáles son los horarios de atención al cliente?',
+});
+
+console.log(result.response);
+```
+
+---
+
+## 🛡️ Manejo de Errores Tipado
+
+```typescript
+import { Novapsis, NovapsisAPIError } from 'novapsis';
+
+try {
+  await novapsis.whatsapp.sendText({
+    to: '34600112233',
+    text: 'Hola',
+  });
+} catch (error) {
+  if (error instanceof NovapsisAPIError) {
+    console.error(`Error de API [${error.code}] (HTTP ${error.status}):`, error.message);
+    console.error('Detalles:', error.details);
+  } else {
+    console.error('Error inesperado:', error);
+  }
+}
+```
+
+---
+
+## 📄 Licencia
+
+MIT © [Novapsis Technologies](https://app.novapsis.com)

package/dist/index.cjs

@@ -0,0 +1,354 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var crypto = require('crypto');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var crypto__default = /*#__PURE__*/_interopDefault(crypto);
+
+// src/index.ts
+var NovapsisAPIError = class extends Error {
+  code;
+  status;
+  details;
+  constructor(message, code = "API_ERROR", status = 500, details) {
+    super(message);
+    this.name = "NovapsisAPIError";
+    this.code = code;
+    this.status = status;
+    this.details = details;
+  }
+};
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  timeoutMs;
+  maxRetries;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = (options.baseUrl || "https://app.novapsis.com").replace(/\/+$/, "");
+    this.timeoutMs = options.timeoutMs || 15e3;
+    this.maxRetries = options.maxRetries ?? 2;
+  }
+  async request(method, path, body, query) {
+    let url = `${this.baseUrl}/api/v1${path.startsWith("/") ? path : `/${path}`}`;
+    if (query && Object.keys(query).length > 0) {
+      const qs = new URLSearchParams(query).toString();
+      url += `?${qs}`;
+    }
+    let lastError = null;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+      try {
+        const response = await fetch(url, {
+          method,
+          headers: {
+            "Authorization": `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+            "User-Agent": "Novapsis-SDK-Node/1.0.0"
+          },
+          body: body ? JSON.stringify(body) : void 0,
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        const data = await response.json().catch(() => ({
+          success: false,
+          error: { code: "INVALID_JSON_RESPONSE", message: `HTTP ${response.status} Sin cuerpo JSON v\xE1lido.` }
+        }));
+        if (!response.ok || !data.success) {
+          throw new NovapsisAPIError(
+            data.error?.message || `Error en petici\xF3n HTTP ${response.status}`,
+            data.error?.code || `HTTP_${response.status}`,
+            response.status,
+            data.error?.details
+          );
+        }
+        return data.data;
+      } catch (err) {
+        clearTimeout(timeoutId);
+        lastError = err;
+        if (err instanceof NovapsisAPIError && err.status >= 400 && err.status < 500) {
+          throw err;
+        }
+        if (attempt === this.maxRetries) {
+          break;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 300 * Math.pow(3, attempt)));
+      }
+    }
+    throw lastError || new NovapsisAPIError("Error de red al comunicarse con Novapsis API", "NETWORK_ERROR", 0);
+  }
+};
+var WhatsAppService = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Envía un mensaje de texto plano */
+  async sendText(options) {
+    return this.http.request("POST", "/whatsapp/messages", {
+      recipient: options.to,
+      connection_id: options.connectionId,
+      type: "text",
+      text: options.text
+    });
+  }
+  /** Envía una imagen o fotografía */
+  async sendImage(options) {
+    return this.http.request("POST", "/whatsapp/messages", {
+      recipient: options.to,
+      connection_id: options.connectionId,
+      type: "image",
+      media_url: options.imageUrl,
+      caption: options.caption
+    });
+  }
+  /** Envía un archivo de audio o nota de voz */
+  async sendAudio(options) {
+    return this.http.request("POST", "/whatsapp/messages", {
+      recipient: options.to,
+      connection_id: options.connectionId,
+      type: "audio",
+      media_url: options.audioUrl
+    });
+  }
+  /** Envía un documento (PDF, Word, Excel, etc.) con nombre de archivo personalizado */
+  async sendDocument(options) {
+    return this.http.request("POST", "/whatsapp/messages", {
+      recipient: options.to,
+      connection_id: options.connectionId,
+      type: "document",
+      media_url: options.documentUrl,
+      filename: options.filename,
+      caption: options.caption
+    });
+  }
+  /** Envía un video */
+  async sendVideo(options) {
+    return this.http.request("POST", "/whatsapp/messages", {
+      recipient: options.to,
+      connection_id: options.connectionId,
+      type: "video",
+      media_url: options.videoUrl,
+      caption: options.caption
+    });
+  }
+  /** Envía una ubicación con coordenadas y dirección en el mapa */
+  async sendLocation(options) {
+    return this.http.request("POST", "/whatsapp/messages", {
+      recipient: options.to,
+      connection_id: options.connectionId,
+      type: "location",
+      latitude: options.latitude,
+      longitude: options.longitude,
+      location_name: options.name,
+      location_address: options.address
+    });
+  }
+  /** Envía una tarjeta de contacto (vCard) interactiva */
+  async sendContact(options) {
+    return this.http.request("POST", "/whatsapp/messages", {
+      recipient: options.to,
+      connection_id: options.connectionId,
+      type: "contacts",
+      contact_name: options.name,
+      contact_phone: options.phone
+    });
+  }
+  /** Envía una plantilla oficial aprobada por Meta con variables dinámicas */
+  async sendTemplate(options) {
+    return this.http.request("POST", "/whatsapp/messages", {
+      recipient: options.to,
+      connection_id: options.connectionId,
+      type: "template",
+      template_name: options.templateName,
+      language_code: options.languageCode || "es",
+      components: options.components || []
+    });
+  }
+  /** Marca un mensaje o chat como leído */
+  async markAsRead(options) {
+    return this.http.request("POST", "/whatsapp/messages", {
+      recipient: options.to,
+      connection_id: options.connectionId,
+      type: "mark_read",
+      message_id: options.messageId
+    });
+  }
+  /** Obtiene la lista de líneas y números de WhatsApp conectados en la organización */
+  async listConnections() {
+    const res = await this.http.request("GET", "/whatsapp/connections");
+    return res.connections;
+  }
+  /** Obtiene las plantillas oficiales de Meta aprobadas */
+  async getTemplates() {
+    const res = await this.http.request("GET", "/whatsapp/templates");
+    return res.templates;
+  }
+  /** Crea una nueva plantilla para enviar a revisión a Meta */
+  async createTemplate(options) {
+    return this.http.request("POST", "/whatsapp/templates", {
+      name: options.name,
+      category: options.category,
+      components: [{ type: "BODY", text: options.bodyText }]
+    });
+  }
+  /** Lista las campañas masivas de WhatsApp configuradas */
+  async listCampaigns() {
+    const res = await this.http.request("GET", "/whatsapp/campaigns");
+    return res.campaigns;
+  }
+  /** Ejecuta una campaña masiva */
+  async executeCampaign(campaignId) {
+    return this.http.request("POST", `/whatsapp/campaigns/${campaignId}/execute`);
+  }
+};
+var OnboardingService = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Crea una sesión de conexión hosted para que un cliente o sede vincule su WhatsApp.
+   * Devuelve `session_url` que puedes abrir en un modal o popup en tu CRM.
+   */
+  async createSession(options = {}) {
+    return this.http.request("POST", "/onboarding/sessions", {
+      client_name: options.clientName,
+      redirect_url: options.redirectUrl,
+      logo_url: options.logoUrl,
+      brand_color: options.brandColor,
+      metadata: options.metadata
+    });
+  }
+  /** Consulta el estado de una sesión de onboarding por su ID */
+  async getSessionStatus(sessionId) {
+    return this.http.request("GET", `/onboarding/sessions/${sessionId}`);
+  }
+};
+var WebhookService = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Suscribe una URL de tu backend para recibir eventos en tiempo real */
+  async subscribe(options) {
+    return this.http.request("POST", "/webhooks/subscriptions", {
+      name: options.name,
+      url: options.url,
+      events: options.events,
+      secret: options.secret,
+      is_active: true
+    });
+  }
+  /** Lista todas las suscripciones de webhooks activas */
+  async list() {
+    const res = await this.http.request("GET", "/webhooks/subscriptions");
+    return res.subscriptions;
+  }
+  /** Elimina una suscripción de webhook */
+  async delete(webhookId) {
+    const res = await this.http.request("DELETE", `/webhooks/subscriptions/${webhookId}`);
+    return res.success;
+  }
+  /**
+   * Valida la firma criptográfica HMAC SHA-256 de un webhook recibido de Novapsis SM.
+   * Evita ataques de suplantación garantizando que la petición proviene de Novapsis.
+   *
+   * @param rawBody - El cuerpo crudo recibido en el request (string sin parsear)
+   * @param signatureHeader - El header 'X-Novapsis-Signature'
+   * @param secret - Tu secreto de webhook de Novapsis
+   */
+  verifySignature(rawBody, signatureHeader, secret) {
+    if (!signatureHeader || !secret || !rawBody) return false;
+    try {
+      const computed = crypto__default.default.createHmac("sha256", secret).update(rawBody, "utf8").digest("hex");
+      return crypto__default.default.timingSafeEqual(Buffer.from(computed), Buffer.from(signatureHeader));
+    } catch {
+      return false;
+    }
+  }
+};
+var ContactsService = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Lista contactos del CRM */
+  async list() {
+    const res = await this.http.request("GET", "/contacts");
+    return res.contacts;
+  }
+  /** Crea o actualiza un contacto por número de teléfono */
+  async upsert(options) {
+    return this.http.request("POST", "/contacts", options);
+  }
+};
+var AIService = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Lista los agentes de IA configurados con sus modelos */
+  async listAgents() {
+    const res = await this.http.request("GET", "/ai/agents");
+    return res.agents;
+  }
+  /** Ejecuta una consulta contra un agente de IA con su base de conocimiento RAG */
+  async execute(options) {
+    return this.http.request("POST", `/ai/agents/${options.agentId}/execute`, {
+      message: options.message
+    });
+  }
+};
+var Novapsis = class {
+  http;
+  /** Métodos para envíos y operaciones de WhatsApp */
+  whatsapp;
+  /** Métodos para onboarding hosted y vinculación B2B */
+  onboarding;
+  /** Métodos para suscripción y validación de Webhooks */
+  webhooks;
+  /** Métodos para contactos del CRM */
+  contacts;
+  /** Métodos para Agentes de Inteligencia Artificial */
+  ai;
+  constructor(options) {
+    if (!options.apiKey) {
+      throw new NovapsisAPIError("Se requiere una apiKey v\xE1lida para inicializar el cliente de Novapsis.", "CONFIG_ERROR", 400);
+    }
+    this.http = new HttpClient(options);
+    this.whatsapp = new WhatsAppService(this.http);
+    this.onboarding = new OnboardingService(this.http);
+    this.webhooks = new WebhookService(this.http);
+    this.contacts = new ContactsService(this.http);
+    this.ai = new AIService(this.http);
+  }
+};
+var index_default = Novapsis;
+/**
+ * novapsis - Official TypeScript / JavaScript SDK
+ * ══════════════════════════════════════════════════════════════════════════════
+ * Official SDK for Novapsis SM.
+ * Universal typed client for WhatsApp Business Cloud API, Hosted Onboarding,
+ * CRM, AI Agents and HMAC Webhook Verification.
+ *
+ * @version 1.0.0
+ * @author Novapsis Technologies
+ * @license MIT
+ * ══════════════════════════════════════════════════════════════════════════════
+ */
+
+exports.AIService = AIService;
+exports.ContactsService = ContactsService;
+exports.Novapsis = Novapsis;
+exports.NovapsisAPIError = NovapsisAPIError;
+exports.OnboardingService = OnboardingService;
+exports.WebhookService = WebhookService;
+exports.WhatsAppService = WhatsAppService;
+exports.default = index_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["crypto"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * novapsis - Official TypeScript / JavaScript SDK\n * ══════════════════════════════════════════════════════════════════════════════\n * Official SDK for Novapsis SM.\n * Universal typed client for WhatsApp Business Cloud API, Hosted Onboarding,\n * CRM, AI Agents and HMAC Webhook Verification.\n *\n * @version 1.0.0\n * @author Novapsis Technologies\n * @license MIT\n * ══════════════════════════════════════════════════════════════════════════════\n */\n\nimport crypto from 'crypto';\n\n// ── TYPES & DEFINITIONS ──────────────────────────────────────────────────────\n\nexport interface NovapsisClientOptions {\n  /** Clave de API de Novapsis (empieza por nvs_live_ o nvs_test_) */\n  apiKey: string;\n  /** URL base de la API (por defecto: https://app.novapsis.com) */\n  baseUrl?: string;\n  /** Timeout en milisegundos para peticiones HTTP (por defecto: 15000) */\n  timeoutMs?: number;\n  /** Número máximo de reintentos automáticos ante fallos de red transitorios (por defecto: 2) */\n  maxRetries?: number;\n}\n\nexport interface APIResponse<T = any> {\n  success: boolean;\n  data?: T;\n  error?: {\n    code: string;\n    message: string;\n    details?: any;\n  };\n}\n\nexport class NovapsisAPIError extends Error {\n  public readonly code: string;\n  public readonly status: number;\n  public readonly details?: any;\n\n  constructor(message: string, code = 'API_ERROR', status = 500, details?: any) {\n    super(message);\n    this.name = 'NovapsisAPIError';\n    this.code = code;\n    this.status = status;\n    this.details = details;\n  }\n}\n\n// ── WHATSAPP TYPES ───────────────────────────────────────────────────────────\n\nexport interface SendBaseOptions {\n  /** Número destinatario con código de país, sin '+' ni espacios (ej: '34600112233') */\n  to: string;\n  /** UUID de la conexión o Phone Number ID de Meta desde el cual enviar. Si se omite, usa la línea principal. */\n  connectionId?: string;\n}\n\nexport interface SendTextOptions extends SendBaseOptions {\n  /** Cuerpo del mensaje de texto */\n  text: string;\n  /** Si es true, genera vista previa de los enlaces web incluidos en el texto */\n  previewUrl?: boolean;\n}\n\nexport interface SendImageOptions extends SendBaseOptions {\n  /** URL HTTPS pública de la imagen (JPG, PNG, WebP) */\n  imageUrl: string;\n  /** Pie de foto opcional */\n  caption?: string;\n}\n\nexport interface SendAudioOptions extends SendBaseOptions {\n  /** URL HTTPS pública del archivo de audio (MP3, AAC, OGG, M4A) */\n  audioUrl: string;\n}\n\nexport interface SendDocumentOptions extends SendBaseOptions {\n  /** URL HTTPS pública del documento o PDF */\n  documentUrl: string;\n  /** Nombre visible del archivo (ej: 'factura_2026.pdf') */\n  filename?: string;\n  /** Descripción o pie opcional */\n  caption?: string;\n}\n\nexport interface SendVideoOptions extends SendBaseOptions {\n  /** URL HTTPS pública del video (MP4, 3GP) */\n  videoUrl: string;\n  /** Pie de video opcional */\n  caption?: string;\n}\n\nexport interface SendLocationOptions extends SendBaseOptions {\n  /** Coordenada de latitud decimal (ej: 40.416775) */\n  latitude: number | string;\n  /** Coordenada de longitud decimal (ej: -3.703790) */\n  longitude: number | string;\n  /** Nombre del lugar o establecimiento (ej: 'Sede Central Madrid') */\n  name?: string;\n  /** Dirección postal completa */\n  address?: string;\n}\n\nexport interface SendContactCardOptions extends SendBaseOptions {\n  /** Nombre completo del contacto a compartir */\n  name: string;\n  /** Número de teléfono del contacto compartido */\n  phone: string;\n}\n\nexport interface SendTemplateOptions extends SendBaseOptions {\n  /** Nombre exacto de la plantilla aprobada en Meta */\n  templateName: string;\n  /** Código de idioma (por defecto: 'es') */\n  languageCode?: string;\n  /** Componentes y variables dinámicas de la plantilla */\n  components?: Array<{\n    type: 'header' | 'body' | 'button';\n    sub_type?: string;\n    index?: string | number;\n    parameters?: Array<{\n      type: 'text' | 'image' | 'document' | 'video' | 'currency' | 'date_time';\n      text?: string;\n      [key: string]: any;\n    }>;\n  }>;\n}\n\nexport interface SendMessageResult {\n  message_id: string;\n  recipient: string;\n  type: string;\n  status: string;\n  conversation_id: string | null;\n}\n\nexport interface WhatsAppConnection {\n  id: string;\n  display_name: string;\n  phone_number: string | null;\n  phone_number_id: string;\n  verified_name: string | null;\n  status: string;\n  webhook_subscribed: boolean;\n}\n\nexport interface WhatsAppTemplate {\n  id: string;\n  name: string;\n  category: string;\n  language: string;\n  status: string;\n  components: any[];\n}\n\n// ── ONBOARDING TYPES ─────────────────────────────────────────────────────────\n\nexport interface CreateOnboardingSessionOptions {\n  /** Nombre de la empresa, cliente o sede a mostrar en la pantalla de conexión */\n  clientName?: string;\n  /** URL de retorno a la que redirigir al usuario cuando vincule su WhatsApp */\n  redirectUrl?: string;\n  /** URL del logotipo de la empresa cliente para marca blanca */\n  logoUrl?: string;\n  /** Color hexadecimal corporativo para la interfaz de conexión (ej: '#0ea5e9') */\n  brandColor?: string;\n  /** Metadata personalizada para tracking en tu CRM */\n  metadata?: Record<string, any>;\n}\n\nexport interface OnboardingSession {\n  id: string;\n  session_id: string;\n  session_url: string;\n  status: 'started' | 'completed' | 'expired' | 'failed';\n  expires_at: string;\n  created_at: string;\n}\n\n// ── WEBHOOK TYPES ────────────────────────────────────────────────────────────\n\nexport type NovapsisWebhookEvent =\n  | 'whatsapp.message_received'\n  | 'whatsapp.message_sent'\n  | 'whatsapp.connected'\n  | 'conversation.started'\n  | 'lead.completed'\n  | 'call.completed'\n  | 'review.received'\n  | '*';\n\nexport interface CreateWebhookSubscriptionOptions {\n  /** Nombre descriptivo de la suscripción (ej: 'CRM Sincronizador') */\n  name: string;\n  /** URL HTTPS de tu backend que recibirá los eventos POST */\n  url: string;\n  /** Lista de eventos a escuchar */\n  events: NovapsisWebhookEvent[];\n  /** Secreto opcional para firma HMAC. Si se omite, Novapsis generará uno automáticamente. */\n  secret?: string;\n}\n\nexport interface WebhookSubscription {\n  id: string;\n  name: string;\n  url: string;\n  events: string[];\n  secret: string;\n  is_active: boolean;\n  created_at: string;\n}\n\nexport interface InboundWebhookPayload<T = any> {\n  event: NovapsisWebhookEvent;\n  timestamp: string;\n  organization_id: string;\n  data: T;\n}\n\n// ── CRM & CONTACTS TYPES ─────────────────────────────────────────────────────\n\nexport interface UpsertContactOptions {\n  phone: string;\n  name?: string;\n  email?: string;\n  tags?: string[];\n  metadata?: Record<string, any>;\n}\n\nexport interface Contact {\n  id: string;\n  phone: string;\n  name: string | null;\n  email: string | null;\n  tags: string[];\n  created_at: string;\n}\n\n// ── INTERNAL HTTP CLIENT ────────────────────────────────────────────────────\n\nclass HttpClient {\n  private apiKey: string;\n  private baseUrl: string;\n  private timeoutMs: number;\n  private maxRetries: number;\n\n  constructor(options: NovapsisClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = (options.baseUrl || 'https://app.novapsis.com').replace(/\\/+$/, '');\n    this.timeoutMs = options.timeoutMs || 15000;\n    this.maxRetries = options.maxRetries ?? 2;\n  }\n\n  async request<T>(method: string, path: string, body?: any, query?: Record<string, string>): Promise<T> {\n    let url = `${this.baseUrl}/api/v1${path.startsWith('/') ? path : `/${path}`}`;\n    if (query && Object.keys(query).length > 0) {\n      const qs = new URLSearchParams(query).toString();\n      url += `?${qs}`;\n    }\n\n    let lastError: Error | null = null;\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);\n\n      try {\n        const response = await fetch(url, {\n          method,\n          headers: {\n            'Authorization': `Bearer ${this.apiKey}`,\n            'Content-Type': 'application/json',\n            'User-Agent': 'Novapsis-SDK-Node/1.0.0',\n          },\n          body: body ? JSON.stringify(body) : undefined,\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        const data: APIResponse<T> = await response.json().catch(() => ({\n          success: false,\n          error: { code: 'INVALID_JSON_RESPONSE', message: `HTTP ${response.status} Sin cuerpo JSON válido.` },\n        }));\n\n        if (!response.ok || !data.success) {\n          throw new NovapsisAPIError(\n            data.error?.message || `Error en petición HTTP ${response.status}`,\n            data.error?.code || `HTTP_${response.status}`,\n            response.status,\n            data.error?.details\n          );\n        }\n\n        return data.data as T;\n      } catch (err: any) {\n        clearTimeout(timeoutId);\n        lastError = err;\n\n        // No reintentar errores de validación de cliente 4xx\n        if (err instanceof NovapsisAPIError && err.status >= 400 && err.status < 500) {\n          throw err;\n        }\n\n        // Si es el último intento, lanzar el error\n        if (attempt === this.maxRetries) {\n          break;\n        }\n\n        // Backoff exponencial: 300ms, 900ms...\n        await new Promise((resolve) => setTimeout(resolve, 300 * Math.pow(3, attempt)));\n      }\n    }\n\n    throw lastError || new NovapsisAPIError('Error de red al comunicarse con Novapsis API', 'NETWORK_ERROR', 0);\n  }\n}\n\n// ── SDK SERVICES ────────────────────────────────────────────────────────────\n\n/** Servicio para envíos y gestión de WhatsApp Cloud API */\nexport class WhatsAppService {\n  constructor(private http: HttpClient) {}\n\n  /** Envía un mensaje de texto plano */\n  async sendText(options: SendTextOptions): Promise<SendMessageResult> {\n    return this.http.request<SendMessageResult>('POST', '/whatsapp/messages', {\n      recipient: options.to,\n      connection_id: options.connectionId,\n      type: 'text',\n      text: options.text,\n    });\n  }\n\n  /** Envía una imagen o fotografía */\n  async sendImage(options: SendImageOptions): Promise<SendMessageResult> {\n    return this.http.request<SendMessageResult>('POST', '/whatsapp/messages', {\n      recipient: options.to,\n      connection_id: options.connectionId,\n      type: 'image',\n      media_url: options.imageUrl,\n      caption: options.caption,\n    });\n  }\n\n  /** Envía un archivo de audio o nota de voz */\n  async sendAudio(options: SendAudioOptions): Promise<SendMessageResult> {\n    return this.http.request<SendMessageResult>('POST', '/whatsapp/messages', {\n      recipient: options.to,\n      connection_id: options.connectionId,\n      type: 'audio',\n      media_url: options.audioUrl,\n    });\n  }\n\n  /** Envía un documento (PDF, Word, Excel, etc.) con nombre de archivo personalizado */\n  async sendDocument(options: SendDocumentOptions): Promise<SendMessageResult> {\n    return this.http.request<SendMessageResult>('POST', '/whatsapp/messages', {\n      recipient: options.to,\n      connection_id: options.connectionId,\n      type: 'document',\n      media_url: options.documentUrl,\n      filename: options.filename,\n      caption: options.caption,\n    });\n  }\n\n  /** Envía un video */\n  async sendVideo(options: SendVideoOptions): Promise<SendMessageResult> {\n    return this.http.request<SendMessageResult>('POST', '/whatsapp/messages', {\n      recipient: options.to,\n      connection_id: options.connectionId,\n      type: 'video',\n      media_url: options.videoUrl,\n      caption: options.caption,\n    });\n  }\n\n  /** Envía una ubicación con coordenadas y dirección en el mapa */\n  async sendLocation(options: SendLocationOptions): Promise<SendMessageResult> {\n    return this.http.request<SendMessageResult>('POST', '/whatsapp/messages', {\n      recipient: options.to,\n      connection_id: options.connectionId,\n      type: 'location',\n      latitude: options.latitude,\n      longitude: options.longitude,\n      location_name: options.name,\n      location_address: options.address,\n    });\n  }\n\n  /** Envía una tarjeta de contacto (vCard) interactiva */\n  async sendContact(options: SendContactCardOptions): Promise<SendMessageResult> {\n    return this.http.request<SendMessageResult>('POST', '/whatsapp/messages', {\n      recipient: options.to,\n      connection_id: options.connectionId,\n      type: 'contacts',\n      contact_name: options.name,\n      contact_phone: options.phone,\n    });\n  }\n\n  /** Envía una plantilla oficial aprobada por Meta con variables dinámicas */\n  async sendTemplate(options: SendTemplateOptions): Promise<SendMessageResult> {\n    return this.http.request<SendMessageResult>('POST', '/whatsapp/messages', {\n      recipient: options.to,\n      connection_id: options.connectionId,\n      type: 'template',\n      template_name: options.templateName,\n      language_code: options.languageCode || 'es',\n      components: options.components || [],\n    });\n  }\n\n  /** Marca un mensaje o chat como leído */\n  async markAsRead(options: { to: string; connectionId?: string; messageId?: string }): Promise<any> {\n    return this.http.request('POST', '/whatsapp/messages', {\n      recipient: options.to,\n      connection_id: options.connectionId,\n      type: 'mark_read',\n      message_id: options.messageId,\n    });\n  }\n\n  /** Obtiene la lista de líneas y números de WhatsApp conectados en la organización */\n  async listConnections(): Promise<WhatsAppConnection[]> {\n    const res = await this.http.request<{ connections: WhatsAppConnection[] }>('GET', '/whatsapp/connections');\n    return res.connections;\n  }\n\n  /** Obtiene las plantillas oficiales de Meta aprobadas */\n  async getTemplates(): Promise<WhatsAppTemplate[]> {\n    const res = await this.http.request<{ templates: WhatsAppTemplate[] }>('GET', '/whatsapp/templates');\n    return res.templates;\n  }\n\n  /** Crea una nueva plantilla para enviar a revisión a Meta */\n  async createTemplate(options: {\n    name: string;\n    category: 'MARKETING' | 'UTILITY' | 'AUTHENTICATION';\n    bodyText: string;\n  }): Promise<any> {\n    return this.http.request('POST', '/whatsapp/templates', {\n      name: options.name,\n      category: options.category,\n      components: [{ type: 'BODY', text: options.bodyText }],\n    });\n  }\n\n  /** Lista las campañas masivas de WhatsApp configuradas */\n  async listCampaigns(): Promise<any[]> {\n    const res = await this.http.request<{ campaigns: any[] }>('GET', '/whatsapp/campaigns');\n    return res.campaigns;\n  }\n\n  /** Ejecuta una campaña masiva */\n  async executeCampaign(campaignId: string): Promise<any> {\n    return this.http.request('POST', `/whatsapp/campaigns/${campaignId}/execute`);\n  }\n}\n\n/** Servicio para onboarding y conexión de WhatsApp de clientes B2B (Marca Blanca) */\nexport class OnboardingService {\n  constructor(private http: HttpClient) {}\n\n  /**\n   * Crea una sesión de conexión hosted para que un cliente o sede vincule su WhatsApp.\n   * Devuelve `session_url` que puedes abrir en un modal o popup en tu CRM.\n   */\n  async createSession(options: CreateOnboardingSessionOptions = {}): Promise<OnboardingSession> {\n    return this.http.request<OnboardingSession>('POST', '/onboarding/sessions', {\n      client_name: options.clientName,\n      redirect_url: options.redirectUrl,\n      logo_url: options.logoUrl,\n      brand_color: options.brandColor,\n      metadata: options.metadata,\n    });\n  }\n\n  /** Consulta el estado de una sesión de onboarding por su ID */\n  async getSessionStatus(sessionId: string): Promise<OnboardingSession> {\n    return this.http.request<OnboardingSession>('GET', `/onboarding/sessions/${sessionId}`);\n  }\n}\n\n/** Servicio para gestionar Webhooks salientes en tiempo real */\nexport class WebhookService {\n  constructor(private http: HttpClient) {}\n\n  /** Suscribe una URL de tu backend para recibir eventos en tiempo real */\n  async subscribe(options: CreateWebhookSubscriptionOptions): Promise<WebhookSubscription> {\n    return this.http.request<WebhookSubscription>('POST', '/webhooks/subscriptions', {\n      name: options.name,\n      url: options.url,\n      events: options.events,\n      secret: options.secret,\n      is_active: true,\n    });\n  }\n\n  /** Lista todas las suscripciones de webhooks activas */\n  async list(): Promise<WebhookSubscription[]> {\n    const res = await this.http.request<{ subscriptions: WebhookSubscription[] }>('GET', '/webhooks/subscriptions');\n    return res.subscriptions;\n  }\n\n  /** Elimina una suscripción de webhook */\n  async delete(webhookId: string): Promise<boolean> {\n    const res = await this.http.request<{ success: boolean }>('DELETE', `/webhooks/subscriptions/${webhookId}`);\n    return res.success;\n  }\n\n  /**\n   * Valida la firma criptográfica HMAC SHA-256 de un webhook recibido de Novapsis SM.\n   * Evita ataques de suplantación garantizando que la petición proviene de Novapsis.\n   *\n   * @param rawBody - El cuerpo crudo recibido en el request (string sin parsear)\n   * @param signatureHeader - El header 'X-Novapsis-Signature'\n   * @param secret - Tu secreto de webhook de Novapsis\n   */\n  verifySignature(rawBody: string, signatureHeader: string | null | undefined, secret: string): boolean {\n    if (!signatureHeader || !secret || !rawBody) return false;\n    try {\n      const computed = crypto.createHmac('sha256', secret).update(rawBody, 'utf8').digest('hex');\n      return crypto.timingSafeEqual(Buffer.from(computed), Buffer.from(signatureHeader));\n    } catch {\n      return false;\n    }\n  }\n}\n\n/** Servicio para gestionar Contactos del CRM */\nexport class ContactsService {\n  constructor(private http: HttpClient) {}\n\n  /** Lista contactos del CRM */\n  async list(): Promise<Contact[]> {\n    const res = await this.http.request<{ contacts: Contact[] }>('GET', '/contacts');\n    return res.contacts;\n  }\n\n  /** Crea o actualiza un contacto por número de teléfono */\n  async upsert(options: UpsertContactOptions): Promise<Contact> {\n    return this.http.request<Contact>('POST', '/contacts', options);\n  }\n}\n\n/** Servicio para interactuar con Agentes de Inteligencia Artificial */\nexport class AIService {\n  constructor(private http: HttpClient) {}\n\n  /** Lista los agentes de IA configurados con sus modelos */\n  async listAgents(): Promise<any[]> {\n    const res = await this.http.request<{ agents: any[] }>('GET', '/ai/agents');\n    return res.agents;\n  }\n\n  /** Ejecuta una consulta contra un agente de IA con su base de conocimiento RAG */\n  async execute(options: { agentId: string; message: string }): Promise<{ response: string; tokens_used?: number }> {\n    return this.http.request('POST', `/ai/agents/${options.agentId}/execute`, {\n      message: options.message,\n    });\n  }\n}\n\n// ── MAIN CLIENT ─────────────────────────────────────────────────────────────\n\n/**\n * Cliente oficial de Novapsis SM.\n * Punto de entrada principal para interactuar con todos los servicios.\n *\n * @example\n * ```typescript\n * import { Novapsis } from 'novapsis';\n *\n * const client = new Novapsis({\n *   apiKey: 'nvs_live_OfnAAb6sEGztGcdbR5IKnhFpPrDJSTq7',\n * });\n *\n * // Enviar mensaje de texto\n * await client.whatsapp.sendText({\n *   to: '34600112233',\n *   text: '¡Hola desde Novapsis SDK!'\n * });\n * ```\n */\nexport class Novapsis {\n  private http: HttpClient;\n\n  /** Métodos para envíos y operaciones de WhatsApp */\n  public readonly whatsapp: WhatsAppService;\n  /** Métodos para onboarding hosted y vinculación B2B */\n  public readonly onboarding: OnboardingService;\n  /** Métodos para suscripción y validación de Webhooks */\n  public readonly webhooks: WebhookService;\n  /** Métodos para contactos del CRM */\n  public readonly contacts: ContactsService;\n  /** Métodos para Agentes de Inteligencia Artificial */\n  public readonly ai: AIService;\n\n  constructor(options: NovapsisClientOptions) {\n    if (!options.apiKey) {\n      throw new NovapsisAPIError('Se requiere una apiKey válida para inicializar el cliente de Novapsis.', 'CONFIG_ERROR', 400);\n    }\n    this.http = new HttpClient(options);\n    this.whatsapp = new WhatsAppService(this.http);\n    this.onboarding = new OnboardingService(this.http);\n    this.webhooks = new WebhookService(this.http);\n    this.contacts = new ContactsService(this.http);\n    this.ai = new AIService(this.http);\n  }\n}\n\n// Default export\nexport default Novapsis;\n"]}