@arisnetxsolutions/qwa-sdk 0.0.1

package/README.md

@@ -0,0 +1,204 @@
+# @arisnetxsolutions/qwa-sdk
+
+SDK oficial para la API de **QOpenWA** — envía mensajes de WhatsApp de forma sencilla, rápida y con tipado completo.
+
+## Instalación
+
+```bash
+npm install @arisnetxsolutions/qwa-sdk
+```
+
+## Modo de uso
+
+### 1. Configuración básica
+
+Importa `QWAClient` y crea una instancia con tus credenciales:
+
+```typescript
+import { QWAClient } from '@arisnetxsolutions/qwa-sdk';
+
+const client = new QWAClient({
+  baseUrl: 'https://api.wa.a.arisnetxsolutions.com',
+  sessionId: 'c7cb0771-3fb8-4fe4-98b8-34c5f294bd80',
+  chatId: '120363040929106526@g.us',
+  apiKey: 'owa_k1_...',
+});
+```
+
+> **💡 Recomendación:** No hardcodees las credenciales. Usa variables de entorno:
+
+```typescript
+const client = new QWAClient({
+  baseUrl: process.env.QWA_BASE_URL!,
+  sessionId: process.env.QWA_SESSION_ID!,
+  chatId: process.env.QWA_CHAT_ID!,
+  apiKey: process.env.QWA_API_KEY!,
+});
+```
+
+### 2. Enviar un mensaje de texto
+
+```typescript
+// Forma explícita (con objeto)
+const result = await client.sendText({
+  text: '¡Hola, mundo! 👋',
+});
+
+console.log(result);
+// ↑ { success: true, message?: string, data?: {...} }
+```
+
+### 3. Shorthand (solo el texto)
+
+Si no necesitas personalizar `chatId` ni `previewUrl`, pasa directamente un `string`:
+
+```typescript
+const result = await client.sendText('¡Hola, mundo! 👋');
+```
+
+El SDK usa automáticamente el `chatId` que configuraste al crear el cliente.
+
+### 4. Enviar a un chat diferente
+
+Puedes sobrescribir el `chatId` por mensaje:
+
+```typescript
+await client.sendText({
+  chatId: '5215512345678@c.us',  // chat específico para este mensaje
+  text: 'Mensaje para otro destino',
+});
+```
+
+### 5. Desactivar vista previa de URLs
+
+```typescript
+await client.sendText({
+  text: 'Visita https://arisnetxsolutions.com',
+  previewUrl: false,  // no mostrar preview del link
+});
+```
+
+### 6. Manejo de errores
+
+El SDK lanza un error `QWAError` cuando la API responde con un código distinto a 2xx:
+
+```typescript
+import { QWAClient, QWAError } from '@arisnetxsolutions/qwa-sdk';
+
+const client = new QWAClient({ ... });
+
+try {
+  const result = await client.sendText('Hola');
+  console.log('✅ Enviado:', result);
+} catch (error) {
+  if (error instanceof QWAError) {
+    console.error('❌ Error de API:', error.message);
+    console.error('   Status:', error.statusCode);
+    console.error('   Body:', error.body);
+  } else {
+    console.error('❌ Error de red:', error);
+  }
+}
+```
+
+### 7. Ejemplo completo (Node.js + variables de entorno)
+
+```typescript
+// app.ts
+import { QWAClient, QWAError } from '@arisnetxsolutions/qwa-sdk';
+
+const client = new QWAClient({
+  baseUrl: process.env.QWA_BASE_URL!,
+  sessionId: process.env.QWA_SESSION_ID!,
+  chatId: process.env.QWA_CHAT_ID!,
+  apiKey: process.env.QWA_API_KEY!,
+});
+
+async function main() {
+  try {
+    const result = await client.sendText(
+      `¡Hola! La hora actual es ${new Date().toLocaleString()}`,
+    );
+    console.log('✅ Mensaje enviado:', result);
+  } catch (error) {
+    if (error instanceof QWAError) {
+      console.error(`❌ [${error.statusCode}] ${error.message}`);
+    } else {
+      console.error('❌ Error inesperado:', error);
+    }
+  }
+}
+
+main();
+```
+
+## API Reference
+
+### `QWAClient`
+
+#### `new QWAClient(config: QWAConfig)`
+
+Crea una nueva instancia del cliente.
+
+| Campo       | Tipo     | Descripción                                      |
+|-------------|----------|--------------------------------------------------|
+| `baseUrl`   | `string` | URL base de la API de QOpenWA                    |
+| `sessionId` | `string` | ID de la sesión de WhatsApp                      |
+| `chatId`    | `string` | ID del chat o grupo de WhatsApp por defecto      |
+| `apiKey`    | `string` | API key para autenticación                       |
+
+> ⚠️ Todos los campos son obligatorios. Si falta alguno, el constructor lanza un error.
+
+#### `sendText(payload: SendTextPayload | string): Promise<QWAResponse>`
+
+Envía un mensaje de texto al chat especificado (o al configurado por defecto).
+
+**Parámetros:**
+
+| Parámetro  | Tipo                        | Descripción                                      |
+|------------|-----------------------------|--------------------------------------------------|
+| `payload`  | `SendTextPayload \| string` | Mensaje a enviar. Acepta objeto o string directo |
+
+**Cuando `payload` es un objeto (`SendTextPayload`):**
+
+| Campo        | Tipo      | Obligatorio | Descripción                                    |
+|-------------|-----------|-------------|------------------------------------------------|
+| `text`      | `string`  | ✅ Sí       | Contenido del mensaje                          |
+| `chatId`    | `string`  | ❌ No       | ID del chat. Si se omite, usa el del config    |
+| `previewUrl`| `boolean` | ❌ No       | Vista previa de URLs. Por defecto: `true`      |
+
+**Respuesta (`QWAResponse`):**
+
+```typescript
+// Éxito
+{ success: true, message?: string, data?: Record<string, unknown> }
+
+// Error
+{ success: false, error: string, code?: string }
+```
+
+### `QWAError`
+
+Error personalizado lanzado cuando la API responde con un código HTTP de error.
+
+| Propiedad    | Tipo     | Descripción                     |
+|-------------|----------|----------------------------------|
+| `message`   | `string` | Descripción del error            |
+| `statusCode`| `number` | Código HTTP de la respuesta      |
+| `body`      | `unknown`| Cuerpo de la respuesta (si aplica) |
+
+## Tipos exportados
+
+```typescript
+import type {
+  QWAConfig,         // Configuración del cliente
+  SendTextPayload,   // Payload para sendText
+  QWAResponse,       // Respuesta exitosa o de error
+  QWASuccessResponse,// Respuesta exitosa
+  QWAErrorResponse,  // Respuesta de error
+} from '@arisnetxsolutions/qwa-sdk';
+```
+
+## Licencia
+
+MIT © Arisnetx Solutions

package/dist/index.cjs

@@ -0,0 +1,80 @@
+'use strict';
+
+// src/client.ts
+var QWAClient = class {
+  config;
+  constructor(config) {
+    if (!config.baseUrl) throw new Error("baseUrl is required");
+    if (!config.sessionId) throw new Error("sessionId is required");
+    if (!config.chatId) throw new Error("chatId is required");
+    if (!config.apiKey) throw new Error("apiKey is required");
+    this.config = {
+      ...config,
+      baseUrl: config.baseUrl.replace(/\/+$/, "")
+    };
+  }
+  /**
+   * Get the HTTP headers used for all requests.
+   */
+  get headers() {
+    return {
+      "Content-Type": "application/json",
+      "x-api-key": this.config.apiKey
+    };
+  }
+  /**
+   * Make a POST request to the QOpenWA API.
+   */
+  async post(endpoint, body) {
+    const url = `${this.config.baseUrl}/api/sessions/${this.config.sessionId}${endpoint}`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const errorBody = await response.json().catch(() => ({}));
+      throw new QWAError(
+        `API request failed: ${response.status} ${response.statusText}`,
+        response.status,
+        errorBody
+      );
+    }
+    return response.json();
+  }
+  /**
+   * Send a text message to the configured chat.
+   *
+   * @param payload - The text message payload. If a string is passed, it will be
+   *                  used as the message text with the configured chatId.
+   * @returns The API response.
+   *
+   * @example
+   * ```ts
+   * await client.sendText({ text: 'Hello, World!' });
+   * await client.sendText('Hello, World!'); // shorthand
+   * ```
+   */
+  async sendText(payload) {
+    const normalized = typeof payload === "string" ? { chatId: this.config.chatId, text: payload } : { ...payload, chatId: payload.chatId ?? this.config.chatId };
+    return this.post(
+      "/messages/send-text",
+      normalized
+    );
+  }
+};
+var QWAError = class extends Error {
+  statusCode;
+  body;
+  constructor(message, statusCode, body) {
+    super(message);
+    this.name = "QWAError";
+    this.statusCode = statusCode;
+    this.body = body;
+  }
+};
+
+exports.QWAClient = QWAClient;
+exports.QWAError = QWAError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":";;;AAuBO,IAAM,YAAN,MAAgB;AAAA,EACJ,MAAA;AAAA,EAEjB,YAAY,MAAA,EAAmB;AAC7B,IAAA,IAAI,CAAC,MAAA,CAAO,OAAA,EAAS,MAAM,IAAI,MAAM,qBAAqB,CAAA;AAC1D,IAAA,IAAI,CAAC,MAAA,CAAO,SAAA,EAAW,MAAM,IAAI,MAAM,uBAAuB,CAAA;AAC9D,IAAA,IAAI,CAAC,MAAA,CAAO,MAAA,EAAQ,MAAM,IAAI,MAAM,oBAAoB,CAAA;AACxD,IAAA,IAAI,CAAC,MAAA,CAAO,MAAA,EAAQ,MAAM,IAAI,MAAM,oBAAoB,CAAA;AAGxD,IAAA,IAAA,CAAK,MAAA,GAAS;AAAA,MACZ,GAAG,MAAA;AAAA,MACH,OAAA,EAAS,MAAA,CAAO,OAAA,CAAQ,OAAA,CAAQ,QAAQ,EAAE;AAAA,KAC5C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,IAAY,OAAA,GAAkC;AAC5C,IAAA,OAAO;AAAA,MACL,cAAA,EAAgB,kBAAA;AAAA,MAChB,WAAA,EAAa,KAAK,MAAA,CAAO;AAAA,KAC3B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,IAAA,CACZ,QAAA,EACA,IAAA,EACoB;AACpB,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,IAAA,CAAK,MAAA,CAAO,OAAO,iBAAiB,IAAA,CAAK,MAAA,CAAO,SAAS,CAAA,EAAG,QAAQ,CAAA,CAAA;AAEnF,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,MAChC,MAAA,EAAQ,MAAA;AAAA,MACR,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,KAC1B,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,SAAA,GAAY,MAAM,QAAA,CAAS,IAAA,GAAO,KAAA,CAAM,OAAO,EAAC,CAAE,CAAA;AACxD,MAAA,MAAM,IAAI,QAAA;AAAA,QACR,CAAA,oBAAA,EAAuB,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,SAAS,UAAU,CAAA,CAAA;AAAA,QAC7D,QAAA,CAAS,MAAA;AAAA,QACT;AAAA,OACF;AAAA,IACF;AAEA,IAAA,OAAO,SAAS,IAAA,EAAK;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,SACJ,OAAA,EACsB;AACtB,IAAA,MAAM,UAAA,GACJ,OAAO,OAAA,KAAY,QAAA,GACf,EAAE,MAAA,EAAQ,IAAA,CAAK,OAAO,MAAA,EAAQ,IAAA,EAAM,SAAQ,GAC5C,EAAE,GAAG,OAAA,EAAS,MAAA,EAAQ,QAAQ,MAAA,IAAU,IAAA,CAAK,OAAO,MAAA,EAAO;AAEjE,IAAA,OAAO,IAAA,CAAK,IAAA;AAAA,MACV,qBAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AACF;AAKO,IAAM,QAAA,GAAN,cAAuB,KAAA,CAAM;AAAA,EAClB,UAAA;AAAA,EACA,IAAA;AAAA,EAEhB,WAAA,CAAY,OAAA,EAAiB,UAAA,EAAoB,IAAA,EAAe;AAC9D,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,UAAA;AACZ,IAAA,IAAA,CAAK,UAAA,GAAa,UAAA;AAClB,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF","file":"index.cjs","sourcesContent":["// ═══════════════════════════════════════════════\r\n// QOpenWA Client - Main SDK class\r\n// ═══════════════════════════════════════════════\r\n\r\nimport type { QWAConfig, SendTextPayload, QWAResponse } from './types.js';\r\n\r\n/**\r\n * QOpenWA Client for sending WhatsApp messages.\r\n *\r\n * @example\r\n * ```ts\r\n * import { QWAClient } from '@arisnetxsolutions/qwa-sdk';\r\n *\r\n * const client = new QWAClient({\r\n *   baseUrl: 'https://api.wa.a.arisnetxsolutions.com',\r\n *   sessionId: 'your-session-id',\r\n *   chatId: 'your-chat-id',\r\n *   apiKey: 'your-api-key',\r\n * });\r\n *\r\n * await client.sendText({ text: 'Hello from QWA SDK!' });\r\n * ```\r\n */\r\nexport class QWAClient {\r\n  private readonly config: QWAConfig;\r\n\r\n  constructor(config: QWAConfig) {\r\n    if (!config.baseUrl) throw new Error('baseUrl is required');\r\n    if (!config.sessionId) throw new Error('sessionId is required');\r\n    if (!config.chatId) throw new Error('chatId is required');\r\n    if (!config.apiKey) throw new Error('apiKey is required');\r\n\r\n    // Normalize baseUrl: remove trailing slash\r\n    this.config = {\r\n      ...config,\r\n      baseUrl: config.baseUrl.replace(/\\/+$/, ''),\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Get the HTTP headers used for all requests.\r\n   */\r\n  private get headers(): Record<string, string> {\r\n    return {\r\n      'Content-Type': 'application/json',\r\n      'x-api-key': this.config.apiKey,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Make a POST request to the QOpenWA API.\r\n   */\r\n  private async post<TBody, TResponse>(\r\n    endpoint: string,\r\n    body: TBody,\r\n  ): Promise<TResponse> {\r\n    const url = `${this.config.baseUrl}/api/sessions/${this.config.sessionId}${endpoint}`;\r\n\r\n    const response = await fetch(url, {\r\n      method: 'POST',\r\n      headers: this.headers,\r\n      body: JSON.stringify(body),\r\n    });\r\n\r\n    if (!response.ok) {\r\n      const errorBody = await response.json().catch(() => ({}));\r\n      throw new QWAError(\r\n        `API request failed: ${response.status} ${response.statusText}`,\r\n        response.status,\r\n        errorBody,\r\n      );\r\n    }\r\n\r\n    return response.json() as Promise<TResponse>;\r\n  }\r\n\r\n  /**\r\n   * Send a text message to the configured chat.\r\n   *\r\n   * @param payload - The text message payload. If a string is passed, it will be\r\n   *                  used as the message text with the configured chatId.\r\n   * @returns The API response.\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * await client.sendText({ text: 'Hello, World!' });\r\n   * await client.sendText('Hello, World!'); // shorthand\r\n   * ```\r\n   */\r\n  async sendText(\r\n    payload: SendTextPayload | string,\r\n  ): Promise<QWAResponse> {\r\n    const normalized: SendTextPayload =\r\n      typeof payload === 'string'\r\n        ? { chatId: this.config.chatId, text: payload }\r\n        : { ...payload, chatId: payload.chatId ?? this.config.chatId };\r\n\r\n    return this.post<SendTextPayload, QWAResponse>(\r\n      '/messages/send-text',\r\n      normalized,\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Custom error class for QWA API errors.\r\n */\r\nexport class QWAError extends Error {\r\n  public readonly statusCode: number;\r\n  public readonly body: unknown;\r\n\r\n  constructor(message: string, statusCode: number, body: unknown) {\r\n    super(message);\r\n    this.name = 'QWAError';\r\n    this.statusCode = statusCode;\r\n    this.body = body;\r\n  }\r\n}\r\n"]}

package/dist/index.d.cts

@@ -0,0 +1,88 @@
+/** Configuration options for the QOpenWA client */
+interface QWAConfig {
+    /** Base URL of the QOpenWA API (e.g. https://api.wa.a.arisnetxsolutions.com) */
+    baseUrl: string;
+    /** Session identifier */
+    sessionId: string;
+    /** WhatsApp chat/group ID */
+    chatId: string;
+    /** API key for authentication */
+    apiKey: string;
+}
+/** Text message request payload */
+interface SendTextPayload {
+    /** WhatsApp chat/group ID */
+    chatId: string;
+    /** Message text content */
+    text: string;
+    /** Optional: preview URL (default: true) */
+    previewUrl?: boolean;
+}
+/** Generic API success response */
+interface QWASuccessResponse {
+    success: true;
+    message?: string;
+    data?: Record<string, unknown>;
+}
+/** Generic API error response */
+interface QWAErrorResponse {
+    success: false;
+    error: string;
+    code?: string;
+}
+/** Union type for API responses */
+type QWAResponse = QWASuccessResponse | QWAErrorResponse;
+
+/**
+ * QOpenWA Client for sending WhatsApp messages.
+ *
+ * @example
+ * ```ts
+ * import { QWAClient } from '@arisnetxsolutions/qwa-sdk';
+ *
+ * const client = new QWAClient({
+ *   baseUrl: 'https://api.wa.a.arisnetxsolutions.com',
+ *   sessionId: 'your-session-id',
+ *   chatId: 'your-chat-id',
+ *   apiKey: 'your-api-key',
+ * });
+ *
+ * await client.sendText({ text: 'Hello from QWA SDK!' });
+ * ```
+ */
+declare class QWAClient {
+    private readonly config;
+    constructor(config: QWAConfig);
+    /**
+     * Get the HTTP headers used for all requests.
+     */
+    private get headers();
+    /**
+     * Make a POST request to the QOpenWA API.
+     */
+    private post;
+    /**
+     * Send a text message to the configured chat.
+     *
+     * @param payload - The text message payload. If a string is passed, it will be
+     *                  used as the message text with the configured chatId.
+     * @returns The API response.
+     *
+     * @example
+     * ```ts
+     * await client.sendText({ text: 'Hello, World!' });
+     * await client.sendText('Hello, World!'); // shorthand
+     * ```
+     */
+    sendText(payload: SendTextPayload | string): Promise<QWAResponse>;
+}
+/**
+ * Custom error class for QWA API errors.
+ */
+declare class QWAError extends Error {
+    readonly statusCode: number;
+    readonly body: unknown;
+    constructor(message: string, statusCode: number, body: unknown);
+}
+
+export { QWAClient, type QWAConfig, QWAError, type QWAErrorResponse, type QWAResponse, type QWASuccessResponse, type SendTextPayload };

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+/** Configuration options for the QOpenWA client */
+interface QWAConfig {
+    /** Base URL of the QOpenWA API (e.g. https://api.wa.a.arisnetxsolutions.com) */
+    baseUrl: string;
+    /** Session identifier */
+    sessionId: string;
+    /** WhatsApp chat/group ID */
+    chatId: string;
+    /** API key for authentication */
+    apiKey: string;
+}
+/** Text message request payload */
+interface SendTextPayload {
+    /** WhatsApp chat/group ID */
+    chatId: string;
+    /** Message text content */
+    text: string;
+    /** Optional: preview URL (default: true) */
+    previewUrl?: boolean;
+}
+/** Generic API success response */
+interface QWASuccessResponse {
+    success: true;
+    message?: string;
+    data?: Record<string, unknown>;
+}
+/** Generic API error response */
+interface QWAErrorResponse {
+    success: false;
+    error: string;
+    code?: string;
+}
+/** Union type for API responses */
+type QWAResponse = QWASuccessResponse | QWAErrorResponse;
+
+/**
+ * QOpenWA Client for sending WhatsApp messages.
+ *
+ * @example
+ * ```ts
+ * import { QWAClient } from '@arisnetxsolutions/qwa-sdk';
+ *
+ * const client = new QWAClient({
+ *   baseUrl: 'https://api.wa.a.arisnetxsolutions.com',
+ *   sessionId: 'your-session-id',
+ *   chatId: 'your-chat-id',
+ *   apiKey: 'your-api-key',
+ * });
+ *
+ * await client.sendText({ text: 'Hello from QWA SDK!' });
+ * ```
+ */
+declare class QWAClient {
+    private readonly config;
+    constructor(config: QWAConfig);
+    /**
+     * Get the HTTP headers used for all requests.
+     */
+    private get headers();
+    /**
+     * Make a POST request to the QOpenWA API.
+     */
+    private post;
+    /**
+     * Send a text message to the configured chat.
+     *
+     * @param payload - The text message payload. If a string is passed, it will be
+     *                  used as the message text with the configured chatId.
+     * @returns The API response.
+     *
+     * @example
+     * ```ts
+     * await client.sendText({ text: 'Hello, World!' });
+     * await client.sendText('Hello, World!'); // shorthand
+     * ```
+     */
+    sendText(payload: SendTextPayload | string): Promise<QWAResponse>;
+}
+/**
+ * Custom error class for QWA API errors.
+ */
+declare class QWAError extends Error {
+    readonly statusCode: number;
+    readonly body: unknown;
+    constructor(message: string, statusCode: number, body: unknown);
+}
+
+export { QWAClient, type QWAConfig, QWAError, type QWAErrorResponse, type QWAResponse, type QWASuccessResponse, type SendTextPayload };

package/dist/index.js

@@ -0,0 +1,77 @@
+// src/client.ts
+var QWAClient = class {
+  config;
+  constructor(config) {
+    if (!config.baseUrl) throw new Error("baseUrl is required");
+    if (!config.sessionId) throw new Error("sessionId is required");
+    if (!config.chatId) throw new Error("chatId is required");
+    if (!config.apiKey) throw new Error("apiKey is required");
+    this.config = {
+      ...config,
+      baseUrl: config.baseUrl.replace(/\/+$/, "")
+    };
+  }
+  /**
+   * Get the HTTP headers used for all requests.
+   */
+  get headers() {
+    return {
+      "Content-Type": "application/json",
+      "x-api-key": this.config.apiKey
+    };
+  }
+  /**
+   * Make a POST request to the QOpenWA API.
+   */
+  async post(endpoint, body) {
+    const url = `${this.config.baseUrl}/api/sessions/${this.config.sessionId}${endpoint}`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      const errorBody = await response.json().catch(() => ({}));
+      throw new QWAError(
+        `API request failed: ${response.status} ${response.statusText}`,
+        response.status,
+        errorBody
+      );
+    }
+    return response.json();
+  }
+  /**
+   * Send a text message to the configured chat.
+   *
+   * @param payload - The text message payload. If a string is passed, it will be
+   *                  used as the message text with the configured chatId.
+   * @returns The API response.
+   *
+   * @example
+   * ```ts
+   * await client.sendText({ text: 'Hello, World!' });
+   * await client.sendText('Hello, World!'); // shorthand
+   * ```
+   */
+  async sendText(payload) {
+    const normalized = typeof payload === "string" ? { chatId: this.config.chatId, text: payload } : { ...payload, chatId: payload.chatId ?? this.config.chatId };
+    return this.post(
+      "/messages/send-text",
+      normalized
+    );
+  }
+};
+var QWAError = class extends Error {
+  statusCode;
+  body;
+  constructor(message, statusCode, body) {
+    super(message);
+    this.name = "QWAError";
+    this.statusCode = statusCode;
+    this.body = body;
+  }
+};
+
+export { QWAClient, QWAError };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":";AAuBO,IAAM,YAAN,MAAgB;AAAA,EACJ,MAAA;AAAA,EAEjB,YAAY,MAAA,EAAmB;AAC7B,IAAA,IAAI,CAAC,MAAA,CAAO,OAAA,EAAS,MAAM,IAAI,MAAM,qBAAqB,CAAA;AAC1D,IAAA,IAAI,CAAC,MAAA,CAAO,SAAA,EAAW,MAAM,IAAI,MAAM,uBAAuB,CAAA;AAC9D,IAAA,IAAI,CAAC,MAAA,CAAO,MAAA,EAAQ,MAAM,IAAI,MAAM,oBAAoB,CAAA;AACxD,IAAA,IAAI,CAAC,MAAA,CAAO,MAAA,EAAQ,MAAM,IAAI,MAAM,oBAAoB,CAAA;AAGxD,IAAA,IAAA,CAAK,MAAA,GAAS;AAAA,MACZ,GAAG,MAAA;AAAA,MACH,OAAA,EAAS,MAAA,CAAO,OAAA,CAAQ,OAAA,CAAQ,QAAQ,EAAE;AAAA,KAC5C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,IAAY,OAAA,GAAkC;AAC5C,IAAA,OAAO;AAAA,MACL,cAAA,EAAgB,kBAAA;AAAA,MAChB,WAAA,EAAa,KAAK,MAAA,CAAO;AAAA,KAC3B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,IAAA,CACZ,QAAA,EACA,IAAA,EACoB;AACpB,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,IAAA,CAAK,MAAA,CAAO,OAAO,iBAAiB,IAAA,CAAK,MAAA,CAAO,SAAS,CAAA,EAAG,QAAQ,CAAA,CAAA;AAEnF,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,MAChC,MAAA,EAAQ,MAAA;AAAA,MACR,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,KAC1B,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,SAAA,GAAY,MAAM,QAAA,CAAS,IAAA,GAAO,KAAA,CAAM,OAAO,EAAC,CAAE,CAAA;AACxD,MAAA,MAAM,IAAI,QAAA;AAAA,QACR,CAAA,oBAAA,EAAuB,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,SAAS,UAAU,CAAA,CAAA;AAAA,QAC7D,QAAA,CAAS,MAAA;AAAA,QACT;AAAA,OACF;AAAA,IACF;AAEA,IAAA,OAAO,SAAS,IAAA,EAAK;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,SACJ,OAAA,EACsB;AACtB,IAAA,MAAM,UAAA,GACJ,OAAO,OAAA,KAAY,QAAA,GACf,EAAE,MAAA,EAAQ,IAAA,CAAK,OAAO,MAAA,EAAQ,IAAA,EAAM,SAAQ,GAC5C,EAAE,GAAG,OAAA,EAAS,MAAA,EAAQ,QAAQ,MAAA,IAAU,IAAA,CAAK,OAAO,MAAA,EAAO;AAEjE,IAAA,OAAO,IAAA,CAAK,IAAA;AAAA,MACV,qBAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AACF;AAKO,IAAM,QAAA,GAAN,cAAuB,KAAA,CAAM;AAAA,EAClB,UAAA;AAAA,EACA,IAAA;AAAA,EAEhB,WAAA,CAAY,OAAA,EAAiB,UAAA,EAAoB,IAAA,EAAe;AAC9D,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,UAAA;AACZ,IAAA,IAAA,CAAK,UAAA,GAAa,UAAA;AAClB,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF","file":"index.js","sourcesContent":["// ═══════════════════════════════════════════════\r\n// QOpenWA Client - Main SDK class\r\n// ═══════════════════════════════════════════════\r\n\r\nimport type { QWAConfig, SendTextPayload, QWAResponse } from './types.js';\r\n\r\n/**\r\n * QOpenWA Client for sending WhatsApp messages.\r\n *\r\n * @example\r\n * ```ts\r\n * import { QWAClient } from '@arisnetxsolutions/qwa-sdk';\r\n *\r\n * const client = new QWAClient({\r\n *   baseUrl: 'https://api.wa.a.arisnetxsolutions.com',\r\n *   sessionId: 'your-session-id',\r\n *   chatId: 'your-chat-id',\r\n *   apiKey: 'your-api-key',\r\n * });\r\n *\r\n * await client.sendText({ text: 'Hello from QWA SDK!' });\r\n * ```\r\n */\r\nexport class QWAClient {\r\n  private readonly config: QWAConfig;\r\n\r\n  constructor(config: QWAConfig) {\r\n    if (!config.baseUrl) throw new Error('baseUrl is required');\r\n    if (!config.sessionId) throw new Error('sessionId is required');\r\n    if (!config.chatId) throw new Error('chatId is required');\r\n    if (!config.apiKey) throw new Error('apiKey is required');\r\n\r\n    // Normalize baseUrl: remove trailing slash\r\n    this.config = {\r\n      ...config,\r\n      baseUrl: config.baseUrl.replace(/\\/+$/, ''),\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Get the HTTP headers used for all requests.\r\n   */\r\n  private get headers(): Record<string, string> {\r\n    return {\r\n      'Content-Type': 'application/json',\r\n      'x-api-key': this.config.apiKey,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Make a POST request to the QOpenWA API.\r\n   */\r\n  private async post<TBody, TResponse>(\r\n    endpoint: string,\r\n    body: TBody,\r\n  ): Promise<TResponse> {\r\n    const url = `${this.config.baseUrl}/api/sessions/${this.config.sessionId}${endpoint}`;\r\n\r\n    const response = await fetch(url, {\r\n      method: 'POST',\r\n      headers: this.headers,\r\n      body: JSON.stringify(body),\r\n    });\r\n\r\n    if (!response.ok) {\r\n      const errorBody = await response.json().catch(() => ({}));\r\n      throw new QWAError(\r\n        `API request failed: ${response.status} ${response.statusText}`,\r\n        response.status,\r\n        errorBody,\r\n      );\r\n    }\r\n\r\n    return response.json() as Promise<TResponse>;\r\n  }\r\n\r\n  /**\r\n   * Send a text message to the configured chat.\r\n   *\r\n   * @param payload - The text message payload. If a string is passed, it will be\r\n   *                  used as the message text with the configured chatId.\r\n   * @returns The API response.\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * await client.sendText({ text: 'Hello, World!' });\r\n   * await client.sendText('Hello, World!'); // shorthand\r\n   * ```\r\n   */\r\n  async sendText(\r\n    payload: SendTextPayload | string,\r\n  ): Promise<QWAResponse> {\r\n    const normalized: SendTextPayload =\r\n      typeof payload === 'string'\r\n        ? { chatId: this.config.chatId, text: payload }\r\n        : { ...payload, chatId: payload.chatId ?? this.config.chatId };\r\n\r\n    return this.post<SendTextPayload, QWAResponse>(\r\n      '/messages/send-text',\r\n      normalized,\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Custom error class for QWA API errors.\r\n */\r\nexport class QWAError extends Error {\r\n  public readonly statusCode: number;\r\n  public readonly body: unknown;\r\n\r\n  constructor(message: string, statusCode: number, body: unknown) {\r\n    super(message);\r\n    this.name = 'QWAError';\r\n    this.statusCode = statusCode;\r\n    this.body = body;\r\n  }\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@arisnetxsolutions/qwa-sdk",
+  "version": "0.0.1",
+  "description": "SDK para la API de QOpenWA - Envío de mensajes de WhatsApp",
+  "keywords": [
+    "whatsapp",
+    "qopenwa",
+    "sdk",
+    "api",
+    "messages"
+  ],
+  "homepage": "https://github.com/arisnetxsolutions/qwa-sdk#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arisnetxsolutions/qwa-sdk.git"
+  },
+  "license": "MIT",
+  "author": "Arisnetx Solutions",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.2.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}