novapsis 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,331 @@
+/**
+ * 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
+ * ══════════════════════════════════════════════════════════════════════════════
+ */
+interface NovapsisClientOptions {
+    /** Clave de API de Novapsis (empieza por nvs_live_ o nvs_test_) */
+    apiKey: string;
+    /** URL base de la API (por defecto: https://app.novapsis.com) */
+    baseUrl?: string;
+    /** Timeout en milisegundos para peticiones HTTP (por defecto: 15000) */
+    timeoutMs?: number;
+    /** Número máximo de reintentos automáticos ante fallos de red transitorios (por defecto: 2) */
+    maxRetries?: number;
+}
+interface APIResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: any;
+    };
+}
+declare class NovapsisAPIError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details?: any;
+    constructor(message: string, code?: string, status?: number, details?: any);
+}
+interface SendBaseOptions {
+    /** Número destinatario con código de país, sin '+' ni espacios (ej: '34600112233') */
+    to: string;
+    /** UUID de la conexión o Phone Number ID de Meta desde el cual enviar. Si se omite, usa la línea principal. */
+    connectionId?: string;
+}
+interface SendTextOptions extends SendBaseOptions {
+    /** Cuerpo del mensaje de texto */
+    text: string;
+    /** Si es true, genera vista previa de los enlaces web incluidos en el texto */
+    previewUrl?: boolean;
+}
+interface SendImageOptions extends SendBaseOptions {
+    /** URL HTTPS pública de la imagen (JPG, PNG, WebP) */
+    imageUrl: string;
+    /** Pie de foto opcional */
+    caption?: string;
+}
+interface SendAudioOptions extends SendBaseOptions {
+    /** URL HTTPS pública del archivo de audio (MP3, AAC, OGG, M4A) */
+    audioUrl: string;
+}
+interface SendDocumentOptions extends SendBaseOptions {
+    /** URL HTTPS pública del documento o PDF */
+    documentUrl: string;
+    /** Nombre visible del archivo (ej: 'factura_2026.pdf') */
+    filename?: string;
+    /** Descripción o pie opcional */
+    caption?: string;
+}
+interface SendVideoOptions extends SendBaseOptions {
+    /** URL HTTPS pública del video (MP4, 3GP) */
+    videoUrl: string;
+    /** Pie de video opcional */
+    caption?: string;
+}
+interface SendLocationOptions extends SendBaseOptions {
+    /** Coordenada de latitud decimal (ej: 40.416775) */
+    latitude: number | string;
+    /** Coordenada de longitud decimal (ej: -3.703790) */
+    longitude: number | string;
+    /** Nombre del lugar o establecimiento (ej: 'Sede Central Madrid') */
+    name?: string;
+    /** Dirección postal completa */
+    address?: string;
+}
+interface SendContactCardOptions extends SendBaseOptions {
+    /** Nombre completo del contacto a compartir */
+    name: string;
+    /** Número de teléfono del contacto compartido */
+    phone: string;
+}
+interface SendTemplateOptions extends SendBaseOptions {
+    /** Nombre exacto de la plantilla aprobada en Meta */
+    templateName: string;
+    /** Código de idioma (por defecto: 'es') */
+    languageCode?: string;
+    /** Componentes y variables dinámicas de la plantilla */
+    components?: Array<{
+        type: 'header' | 'body' | 'button';
+        sub_type?: string;
+        index?: string | number;
+        parameters?: Array<{
+            type: 'text' | 'image' | 'document' | 'video' | 'currency' | 'date_time';
+            text?: string;
+            [key: string]: any;
+        }>;
+    }>;
+}
+interface SendMessageResult {
+    message_id: string;
+    recipient: string;
+    type: string;
+    status: string;
+    conversation_id: string | null;
+}
+interface WhatsAppConnection {
+    id: string;
+    display_name: string;
+    phone_number: string | null;
+    phone_number_id: string;
+    verified_name: string | null;
+    status: string;
+    webhook_subscribed: boolean;
+}
+interface WhatsAppTemplate {
+    id: string;
+    name: string;
+    category: string;
+    language: string;
+    status: string;
+    components: any[];
+}
+interface CreateOnboardingSessionOptions {
+    /** Nombre de la empresa, cliente o sede a mostrar en la pantalla de conexión */
+    clientName?: string;
+    /** URL de retorno a la que redirigir al usuario cuando vincule su WhatsApp */
+    redirectUrl?: string;
+    /** URL del logotipo de la empresa cliente para marca blanca */
+    logoUrl?: string;
+    /** Color hexadecimal corporativo para la interfaz de conexión (ej: '#0ea5e9') */
+    brandColor?: string;
+    /** Metadata personalizada para tracking en tu CRM */
+    metadata?: Record<string, any>;
+}
+interface OnboardingSession {
+    id: string;
+    session_id: string;
+    session_url: string;
+    status: 'started' | 'completed' | 'expired' | 'failed';
+    expires_at: string;
+    created_at: string;
+}
+type NovapsisWebhookEvent = 'whatsapp.message_received' | 'whatsapp.message_sent' | 'whatsapp.connected' | 'conversation.started' | 'lead.completed' | 'call.completed' | 'review.received' | '*';
+interface CreateWebhookSubscriptionOptions {
+    /** Nombre descriptivo de la suscripción (ej: 'CRM Sincronizador') */
+    name: string;
+    /** URL HTTPS de tu backend que recibirá los eventos POST */
+    url: string;
+    /** Lista de eventos a escuchar */
+    events: NovapsisWebhookEvent[];
+    /** Secreto opcional para firma HMAC. Si se omite, Novapsis generará uno automáticamente. */
+    secret?: string;
+}
+interface WebhookSubscription {
+    id: string;
+    name: string;
+    url: string;
+    events: string[];
+    secret: string;
+    is_active: boolean;
+    created_at: string;
+}
+interface InboundWebhookPayload<T = any> {
+    event: NovapsisWebhookEvent;
+    timestamp: string;
+    organization_id: string;
+    data: T;
+}
+interface UpsertContactOptions {
+    phone: string;
+    name?: string;
+    email?: string;
+    tags?: string[];
+    metadata?: Record<string, any>;
+}
+interface Contact {
+    id: string;
+    phone: string;
+    name: string | null;
+    email: string | null;
+    tags: string[];
+    created_at: string;
+}
+declare class HttpClient {
+    private apiKey;
+    private baseUrl;
+    private timeoutMs;
+    private maxRetries;
+    constructor(options: NovapsisClientOptions);
+    request<T>(method: string, path: string, body?: any, query?: Record<string, string>): Promise<T>;
+}
+/** Servicio para envíos y gestión de WhatsApp Cloud API */
+declare class WhatsAppService {
+    private http;
+    constructor(http: HttpClient);
+    /** Envía un mensaje de texto plano */
+    sendText(options: SendTextOptions): Promise<SendMessageResult>;
+    /** Envía una imagen o fotografía */
+    sendImage(options: SendImageOptions): Promise<SendMessageResult>;
+    /** Envía un archivo de audio o nota de voz */
+    sendAudio(options: SendAudioOptions): Promise<SendMessageResult>;
+    /** Envía un documento (PDF, Word, Excel, etc.) con nombre de archivo personalizado */
+    sendDocument(options: SendDocumentOptions): Promise<SendMessageResult>;
+    /** Envía un video */
+    sendVideo(options: SendVideoOptions): Promise<SendMessageResult>;
+    /** Envía una ubicación con coordenadas y dirección en el mapa */
+    sendLocation(options: SendLocationOptions): Promise<SendMessageResult>;
+    /** Envía una tarjeta de contacto (vCard) interactiva */
+    sendContact(options: SendContactCardOptions): Promise<SendMessageResult>;
+    /** Envía una plantilla oficial aprobada por Meta con variables dinámicas */
+    sendTemplate(options: SendTemplateOptions): Promise<SendMessageResult>;
+    /** Marca un mensaje o chat como leído */
+    markAsRead(options: {
+        to: string;
+        connectionId?: string;
+        messageId?: string;
+    }): Promise<any>;
+    /** Obtiene la lista de líneas y números de WhatsApp conectados en la organización */
+    listConnections(): Promise<WhatsAppConnection[]>;
+    /** Obtiene las plantillas oficiales de Meta aprobadas */
+    getTemplates(): Promise<WhatsAppTemplate[]>;
+    /** Crea una nueva plantilla para enviar a revisión a Meta */
+    createTemplate(options: {
+        name: string;
+        category: 'MARKETING' | 'UTILITY' | 'AUTHENTICATION';
+        bodyText: string;
+    }): Promise<any>;
+    /** Lista las campañas masivas de WhatsApp configuradas */
+    listCampaigns(): Promise<any[]>;
+    /** Ejecuta una campaña masiva */
+    executeCampaign(campaignId: string): Promise<any>;
+}
+/** Servicio para onboarding y conexión de WhatsApp de clientes B2B (Marca Blanca) */
+declare class OnboardingService {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * 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.
+     */
+    createSession(options?: CreateOnboardingSessionOptions): Promise<OnboardingSession>;
+    /** Consulta el estado de una sesión de onboarding por su ID */
+    getSessionStatus(sessionId: string): Promise<OnboardingSession>;
+}
+/** Servicio para gestionar Webhooks salientes en tiempo real */
+declare class WebhookService {
+    private http;
+    constructor(http: HttpClient);
+    /** Suscribe una URL de tu backend para recibir eventos en tiempo real */
+    subscribe(options: CreateWebhookSubscriptionOptions): Promise<WebhookSubscription>;
+    /** Lista todas las suscripciones de webhooks activas */
+    list(): Promise<WebhookSubscription[]>;
+    /** Elimina una suscripción de webhook */
+    delete(webhookId: string): Promise<boolean>;
+    /**
+     * 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: string, signatureHeader: string | null | undefined, secret: string): boolean;
+}
+/** Servicio para gestionar Contactos del CRM */
+declare class ContactsService {
+    private http;
+    constructor(http: HttpClient);
+    /** Lista contactos del CRM */
+    list(): Promise<Contact[]>;
+    /** Crea o actualiza un contacto por número de teléfono */
+    upsert(options: UpsertContactOptions): Promise<Contact>;
+}
+/** Servicio para interactuar con Agentes de Inteligencia Artificial */
+declare class AIService {
+    private http;
+    constructor(http: HttpClient);
+    /** Lista los agentes de IA configurados con sus modelos */
+    listAgents(): Promise<any[]>;
+    /** Ejecuta una consulta contra un agente de IA con su base de conocimiento RAG */
+    execute(options: {
+        agentId: string;
+        message: string;
+    }): Promise<{
+        response: string;
+        tokens_used?: number;
+    }>;
+}
+/**
+ * Cliente oficial de Novapsis SM.
+ * Punto de entrada principal para interactuar con todos los servicios.
+ *
+ * @example
+ * ```typescript
+ * import { Novapsis } from 'novapsis';
+ *
+ * const client = new Novapsis({
+ *   apiKey: 'nvs_live_OfnAAb6sEGztGcdbR5IKnhFpPrDJSTq7',
+ * });
+ *
+ * // Enviar mensaje de texto
+ * await client.whatsapp.sendText({
+ *   to: '34600112233',
+ *   text: '¡Hola desde Novapsis SDK!'
+ * });
+ * ```
+ */
+declare class Novapsis {
+    private http;
+    /** Métodos para envíos y operaciones de WhatsApp */
+    readonly whatsapp: WhatsAppService;
+    /** Métodos para onboarding hosted y vinculación B2B */
+    readonly onboarding: OnboardingService;
+    /** Métodos para suscripción y validación de Webhooks */
+    readonly webhooks: WebhookService;
+    /** Métodos para contactos del CRM */
+    readonly contacts: ContactsService;
+    /** Métodos para Agentes de Inteligencia Artificial */
+    readonly ai: AIService;
+    constructor(options: NovapsisClientOptions);
+}
+
+export { AIService, type APIResponse, type Contact, ContactsService, type CreateOnboardingSessionOptions, type CreateWebhookSubscriptionOptions, type InboundWebhookPayload, Novapsis, NovapsisAPIError, type NovapsisClientOptions, type NovapsisWebhookEvent, OnboardingService, type OnboardingSession, type SendAudioOptions, type SendBaseOptions, type SendContactCardOptions, type SendDocumentOptions, type SendImageOptions, type SendLocationOptions, type SendMessageResult, type SendTemplateOptions, type SendTextOptions, type SendVideoOptions, type UpsertContactOptions, WebhookService, type WebhookSubscription, type WhatsAppConnection, WhatsAppService, type WhatsAppTemplate, Novapsis as default };

package/dist/index.d.ts

@@ -0,0 +1,333 @@
+/**
+ * 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
+ * ══════════════════════════════════════════════════════════════════════════════
+ */
+interface NovapsisClientOptions {
+    /** Clave de API de Novapsis (empieza por nvs_live_ o nvs_test_) */
+    apiKey: string;
+    /** URL base de la API (por defecto: https://app.novapsis.com) */
+    baseUrl?: string;
+    /** Timeout en milisegundos para peticiones HTTP (por defecto: 15000) */
+    timeoutMs?: number;
+    /** Número máximo de reintentos automáticos ante fallos de red transitorios (por defecto: 2) */
+    maxRetries?: number;
+}
+interface APIResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        details?: any;
+    };
+}
+declare class NovapsisAPIError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details?: any;
+    constructor(message: string, code?: string, status?: number, details?: any);
+}
+interface SendBaseOptions {
+    /** Número destinatario con código de país, sin '+' ni espacios (ej: '34600112233') */
+    to: string;
+    /** UUID de la conexión o Phone Number ID de Meta desde el cual enviar. Si se omite, usa la línea principal. */
+    connectionId?: string;
+}
+interface SendTextOptions extends SendBaseOptions {
+    /** Cuerpo del mensaje de texto */
+    text: string;
+    /** Si es true, genera vista previa de los enlaces web incluidos en el texto */
+    previewUrl?: boolean;
+}
+interface SendImageOptions extends SendBaseOptions {
+    /** URL HTTPS pública de la imagen (JPG, PNG, WebP) */
+    imageUrl: string;
+    /** Pie de foto opcional */
+    caption?: string;
+}
+interface SendAudioOptions extends SendBaseOptions {
+    /** URL HTTPS pública del archivo de audio (MP3, AAC, OGG, M4A) */
+    audioUrl: string;
+}
+interface SendDocumentOptions extends SendBaseOptions {
+    /** URL HTTPS pública del documento o PDF */
+    documentUrl: string;
+    /** Nombre visible del archivo (ej: 'factura_2026.pdf') */
+    filename?: string;
+    /** Descripción o pie opcional */
+    caption?: string;
+}
+interface SendVideoOptions extends SendBaseOptions {
+    /** URL HTTPS pública del video (MP4, 3GP) */
+    videoUrl: string;
+    /** Pie de video opcional */
+    caption?: string;
+}
+interface SendLocationOptions extends SendBaseOptions {
+    /** Coordenada de latitud decimal (ej: 40.416775) */
+    latitude: number | string;
+    /** Coordenada de longitud decimal (ej: -3.703790) */
+    longitude: number | string;
+    /** Nombre del lugar o establecimiento (ej: 'Sede Central Madrid') */
+    name?: string;
+    /** Dirección postal completa */
+    address?: string;
+}
+interface SendContactCardOptions extends SendBaseOptions {
+    /** Nombre completo del contacto a compartir */
+    name: string;
+    /** Número de teléfono del contacto compartido */
+    phone: string;
+}
+interface SendTemplateOptions extends SendBaseOptions {
+    /** Nombre exacto de la plantilla aprobada en Meta */
+    templateName: string;
+    /** Código de idioma (por defecto: 'es') */
+    languageCode?: string;
+    /** Componentes y variables dinámicas de la plantilla */
+    components?: Array<{
+        type: 'header' | 'body' | 'button';
+        sub_type?: string;
+        index?: string | number;
+        parameters?: Array<{
+            type: 'text' | 'image' | 'document' | 'video' | 'currency' | 'date_time';
+            text?: string;
+            [key: string]: any;
+        }>;
+    }>;
+}
+interface SendMessageResult {
+    message_id: string;
+    recipient: string;
+    type: string;
+    status: string;
+    conversation_id: string | null;
+}
+interface WhatsAppConnection {
+    id: string;
+    display_name: string;
+    phone_number: string | null;
+    phone_number_id: string;
+    verified_name: string | null;
+    status: string;
+    webhook_subscribed: boolean;
+}
+interface WhatsAppTemplate {
+    id: string;
+    name: string;
+    category: string;
+    language: string;
+    status: string;
+    components: any[];
+}
+interface CreateOnboardingSessionOptions {
+    /** Nombre de la empresa, cliente o sede a mostrar en la pantalla de conexión */
+    clientName?: string;
+    /** URL de retorno a la que redirigir al usuario cuando vincule su WhatsApp */
+    redirectUrl?: string;
+    /** URL del logotipo de la empresa cliente para marca blanca */
+    logoUrl?: string;
+    /** Color hexadecimal corporativo para la interfaz de conexión (ej: '#0ea5e9') */
+    brandColor?: string;
+    /** Metadata personalizada para tracking en tu CRM */
+    metadata?: Record<string, any>;
+}
+interface OnboardingSession {
+    id: string;
+    session_id: string;
+    session_url: string;
+    status: 'started' | 'completed' | 'expired' | 'failed';
+    expires_at: string;
+    created_at: string;
+}
+type NovapsisWebhookEvent = 'whatsapp.message_received' | 'whatsapp.message_sent' | 'whatsapp.connected' | 'conversation.started' | 'lead.completed' | 'call.completed' | 'review.received' | '*';
+interface CreateWebhookSubscriptionOptions {
+    /** Nombre descriptivo de la suscripción (ej: 'CRM Sincronizador') */
+    name: string;
+    /** URL HTTPS de tu backend que recibirá los eventos POST */
+    url: string;
+    /** Lista de eventos a escuchar */
+    events: NovapsisWebhookEvent[];
+    /** Secreto opcional para firma HMAC. Si se omite, Novapsis generará uno automáticamente. */
+    secret?: string;
+}
+interface WebhookSubscription {
+    id: string;
+    name: string;
+    url: string;
+    events: string[];
+    secret: string;
+    is_active: boolean;
+    created_at: string;
+}
+interface InboundWebhookPayload<T = any> {
+    event: NovapsisWebhookEvent;
+    timestamp: string;
+    organization_id: string;
+    data: T;
+}
+interface UpsertContactOptions {
+    phone: string;
+    name?: string;
+    email?: string;
+    tags?: string[];
+    metadata?: Record<string, any>;
+}
+interface Contact {
+    id: string;
+    phone: string;
+    name: string | null;
+    email: string | null;
+    tags: string[];
+    created_at: string;
+}
+declare class HttpClient {
+    private apiKey;
+    private baseUrl;
+    private timeoutMs;
+    private maxRetries;
+    constructor(options: NovapsisClientOptions);
+    request<T>(method: string, path: string, body?: any, query?: Record<string, string>): Promise<T>;
+}
+/** Servicio para envíos y gestión de WhatsApp Cloud API */
+declare class WhatsAppService {
+    private http;
+    constructor(http: HttpClient);
+    /** Envía un mensaje de texto plano */
+    sendText(options: SendTextOptions): Promise<SendMessageResult>;
+    /** Envía una imagen o fotografía */
+    sendImage(options: SendImageOptions): Promise<SendMessageResult>;
+    /** Envía un archivo de audio o nota de voz */
+    sendAudio(options: SendAudioOptions): Promise<SendMessageResult>;
+    /** Envía un documento (PDF, Word, Excel, etc.) con nombre de archivo personalizado */
+    sendDocument(options: SendDocumentOptions): Promise<SendMessageResult>;
+    /** Envía un video */
+    sendVideo(options: SendVideoOptions): Promise<SendMessageResult>;
+    /** Envía una ubicación con coordenadas y dirección en el mapa */
+    sendLocation(options: SendLocationOptions): Promise<SendMessageResult>;
+    /** Envía una tarjeta de contacto (vCard) interactiva */
+    sendContact(options: SendContactCardOptions): Promise<SendMessageResult>;
+    /** Envía una plantilla oficial aprobada por Meta con variables dinámicas */
+    sendTemplate(options: SendTemplateOptions): Promise<SendMessageResult>;
+    /** Marca un mensaje o chat como leído */
+    markAsRead(options: {
+        to: string;
+        connectionId?: string;
+        messageId?: string;
+    }): Promise<any>;
+    /** Obtiene la lista de líneas y números de WhatsApp conectados en la organización */
+    listConnections(): Promise<WhatsAppConnection[]>;
+    /** Obtiene las plantillas oficiales de Meta aprobadas */
+    getTemplates(): Promise<WhatsAppTemplate[]>;
+    /** Crea una nueva plantilla para enviar a revisión a Meta */
+    createTemplate(options: {
+        name: string;
+        category: 'MARKETING' | 'UTILITY' | 'AUTHENTICATION';
+        bodyText: string;
+    }): Promise<any>;
+    /** Lista las campañas masivas de WhatsApp configuradas */
+    listCampaigns(): Promise<any[]>;
+    /** Ejecuta una campaña masiva */
+    executeCampaign(campaignId: string): Promise<any>;
+}
+/** Servicio para onboarding y conexión de WhatsApp de clientes B2B (Marca Blanca) */
+declare class OnboardingService {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * 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.
+     */
+    createSession(options?: CreateOnboardingSessionOptions): Promise<OnboardingSession>;
+    /** Consulta el estado de una sesión de onboarding por su ID */
+    getSessionStatus(sessionId: string): Promise<OnboardingSession>;
+}
+/** Servicio para gestionar Webhooks salientes en tiempo real */
+declare class WebhookService {
+    private http;
+    constructor(http: HttpClient);
+    /** Suscribe una URL de tu backend para recibir eventos en tiempo real */
+    subscribe(options: CreateWebhookSubscriptionOptions): Promise<WebhookSubscription>;
+    /** Lista todas las suscripciones de webhooks activas */
+    list(): Promise<WebhookSubscription[]>;
+    /** Elimina una suscripción de webhook */
+    delete(webhookId: string): Promise<boolean>;
+    /**
+     * 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: string, signatureHeader: string | null | undefined, secret: string): boolean;
+}
+/** Servicio para gestionar Contactos del CRM */
+declare class ContactsService {
+    private http;
+    constructor(http: HttpClient);
+    /** Lista contactos del CRM */
+    list(): Promise<Contact[]>;
+    /** Crea o actualiza un contacto por número de teléfono */
+    upsert(options: UpsertContactOptions): Promise<Contact>;
+}
+/** Servicio para interactuar con Agentes de Inteligencia Artificial */
+declare class AIService {
+    private http;
+    constructor(http: HttpClient);
+    /** Lista los agentes de IA configurados con sus modelos */
+    listAgents(): Promise<any[]>;
+    /** Ejecuta una consulta contra un agente de IA con su base de conocimiento RAG */
+    execute(options: {
+        agentId: string;
+        message: string;
+    }): Promise<{
+        response: string;
+        tokens_used?: number;
+    }>;
+}
+/**
+ * Cliente oficial de Novapsis SM.
+ * Punto de entrada principal para interactuar con todos los servicios.
+ *
+ * @example
+ * ```typescript
+ * import { Novapsis } from 'novapsis';
+ *
+ * const client = new Novapsis({
+ *   apiKey: 'nvs_live_OfnAAb6sEGztGcdbR5IKnhFpPrDJSTq7',
+ * });
+ *
+ * // Enviar mensaje de texto
+ * await client.whatsapp.sendText({
+ *   to: '34600112233',
+ *   text: '¡Hola desde Novapsis SDK!'
+ * });
+ * ```
+ */
+declare class Novapsis {
+    private http;
+    /** Métodos para envíos y operaciones de WhatsApp */
+    readonly whatsapp: WhatsAppService;
+    /** Métodos para onboarding hosted y vinculación B2B */
+    readonly onboarding: OnboardingService;
+    /** Métodos para suscripción y validación de Webhooks */
+    readonly webhooks: WebhookService;
+    /** Métodos para contactos del CRM */
+    readonly contacts: ContactsService;
+    /** Métodos para Agentes de Inteligencia Artificial */
+    readonly ai: AIService;
+    constructor(options: NovapsisClientOptions);
+}
+
+// @ts-ignore
+export = Novapsis;
+export { AIService, type APIResponse, type Contact, ContactsService, type CreateOnboardingSessionOptions, type CreateWebhookSubscriptionOptions, type InboundWebhookPayload, Novapsis, NovapsisAPIError, type NovapsisClientOptions, type NovapsisWebhookEvent, OnboardingService, type OnboardingSession, type SendAudioOptions, type SendBaseOptions, type SendContactCardOptions, type SendDocumentOptions, type SendImageOptions, type SendLocationOptions, type SendMessageResult, type SendTemplateOptions, type SendTextOptions, type SendVideoOptions, type UpsertContactOptions, WebhookService, type WebhookSubscription, type WhatsAppConnection, WhatsAppService, type WhatsAppTemplate };