novapsis 1.0.0

package/dist/index.mjs

@@ -0,0 +1,339 @@
+import crypto from '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.createHmac("sha256", secret).update(rawBody, "utf8").digest("hex");
+      return crypto.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
+ * ══════════════════════════════════════════════════════════════════════════════
+ */
+
+export { AIService, ContactsService, Novapsis, NovapsisAPIError, OnboardingService, WebhookService, WhatsAppService, index_default as default };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","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"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "novapsis",
+  "version": "1.0.0",
+  "description": "SDK oficial de Novapsis SM para Node.js, Next.js y TypeScript. WhatsApp Cloud API, Onboarding B2B Marca Blanca, CRM y Webhooks HMAC.",
+  "author": "Novapsis Technologies <soporte@novapsis.com> (https://app.novapsis.com)",
+  "license": "MIT",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "novapsis",
+    "whatsapp",
+    "whatsapp-cloud-api",
+    "whatsapp-business",
+    "meta",
+    "crm",
+    "onboarding",
+    "white-label",
+    "webhooks",
+    "ai-agent",
+    "sdk"
+  ],
+  "homepage": "https://app.novapsis.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/novapsis/novapsis-sm.git",
+    "directory": "packages/novapsis-sdk"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.19",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}