@arplyx/sdk 0.1.0

package/README.md

@@ -0,0 +1,93 @@
+# @arplyx/sdk
+
+SDK oficial de **Arplyx** para Node.js / TypeScript: enviá mensajes y broadcasts de WhatsApp y consultá estados con una API tipada.
+
+## Instalación
+
+```bash
+npm install @arplyx/sdk
+```
+
+Requiere Node.js 18+. Funciona con ESM y CommonJS.
+
+## Uso
+
+```ts
+import { Arplyx, ArplyxError } from '@arplyx/sdk';
+
+const arplyx = new Arplyx({ apiKey: process.env.ARPLYX_API_KEY! });
+
+// Enviar un texto
+const msg = await arplyx.sendMessage({
+  externalId: 'pedido-10045',
+  to: '+5491155551234',
+  text: 'Tu pedido fue confirmado.',
+  channel: 'whatsapp_direct',
+  whatsappAccountId: 'TU_ACCOUNT_ID',
+});
+console.log(msg.messageId, msg.status);
+
+// Consultar estado (por messageId o por tu externalId)
+const status = await arplyx.getMessage('pedido-10045');
+console.log(status.status); // pending | queued | sent | delivered | read | failed
+```
+
+### Plantillas (Meta Official)
+
+```ts
+await arplyx.sendMessage({
+  externalId: 'pedido-10045',
+  to: '+5491155551234',
+  channel: 'whatsapp_meta',
+  template: { name: 'pedido_confirmado', language: 'es_AR', body: ['Juan', '10045'] },
+});
+```
+
+### Broadcast a una lista (planes Basic/Pro)
+
+```ts
+await arplyx.sendBroadcast({
+  externalId: 'promo-junio-2026',
+  listId: 'TU_LIST_ID',
+  channel: 'whatsapp_direct',
+  text: 'Este mes 2x1 en turnos.',
+  whatsappAccountId: 'TU_ACCOUNT_ID',
+});
+```
+
+### Listar cuentas de WhatsApp
+
+```ts
+const accounts = await arplyx.listWhatsappAccounts();
+// accounts[].id se usa como whatsappAccountId al enviar
+```
+
+## Manejo de errores
+
+Las respuestas no-2xx lanzan `ArplyxError`:
+
+```ts
+try {
+  await arplyx.sendMessage({ externalId: 'x', to: '+549...', text: 'hola' });
+} catch (err) {
+  if (err instanceof ArplyxError) {
+    console.error(err.status); // 400, 401, 409, 422, 429, 500…
+    console.error(err.code);   // 'validation_error', 'conflict', 'quota_exceeded'…
+    console.error(err.details); // detalles por campo si es validation_error
+  }
+}
+```
+
+## Idempotencia
+
+Todos los envíos usan tu `externalId` como clave de idempotencia: reintentar con el mismo `externalId` y payload no duplica el envío (devuelve el original). Es seguro reintentar ante timeouts.
+
+## Configuración
+
+| Opción | Requerida | Default |
+|---|---|---|
+| `apiKey` | Sí | — |
+| `baseUrl` | No | `https://api.arplyx.com` |
+| `fetch` | No | `globalThis.fetch` |
+
+Docs de la API: https://docs.arplyx.com/api/ · OpenAPI: https://api.arplyx.com/openapi.yaml

package/dist/index.cjs

@@ -0,0 +1,156 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Arplyx: () => Arplyx,
+  ArplyxError: () => ArplyxError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var ArplyxError = class _ArplyxError extends Error {
+  /** Código HTTP. */
+  status;
+  /** Código de error de Arplyx (campo `error` del cuerpo). */
+  code;
+  /** Cuerpo crudo de la respuesta. */
+  body;
+  /** Detalles de validación, si `code === 'validation_error'`. */
+  details;
+  constructor(status, body) {
+    const b = body ?? {};
+    const code = typeof b.error === "string" ? b.error : `http_${status}`;
+    const msg = typeof b.message === "string" ? b.message : code;
+    super(`Arplyx ${status} (${code}): ${msg}`);
+    this.name = "ArplyxError";
+    this.status = status;
+    this.code = code;
+    this.body = body;
+    if (Array.isArray(b.details)) {
+      this.details = b.details;
+    }
+    Object.setPrototypeOf(this, _ArplyxError.prototype);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.arplyx.com";
+var Arplyx = class {
+  apiKey;
+  baseUrl;
+  fetchImpl;
+  constructor(options) {
+    if (!options?.apiKey) {
+      throw new Error("Arplyx: falta `apiKey`.");
+    }
+    this.apiKey = options.apiKey;
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    const f = options.fetch ?? globalThis.fetch;
+    if (!f) {
+      throw new Error(
+        "Arplyx: no hay `fetch` disponible. Us\xE1 Node 18+ o pas\xE1 una implementaci\xF3n en `options.fetch`."
+      );
+    }
+    this.fetchImpl = f;
+  }
+  async request(method, path, body) {
+    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        "x-api-key": this.apiKey,
+        "Content-Type": "application/json"
+      },
+      body: body === void 0 ? void 0 : JSON.stringify(body)
+    });
+    const text = await res.text();
+    let data = null;
+    if (text) {
+      try {
+        data = JSON.parse(text);
+      } catch {
+        data = text;
+      }
+    }
+    if (!res.ok) {
+      throw new ArplyxError(res.status, data);
+    }
+    return data;
+  }
+  /** Envía un mensaje de WhatsApp (texto o plantilla). */
+  async sendMessage(input) {
+    if (!input.text && !input.template || input.text && input.template) {
+      throw new Error("Arplyx.sendMessage: indic\xE1 exactamente uno de `text` o `template`.");
+    }
+    const content = input.text ? { type: "text", text: input.text } : {
+      type: "template",
+      template: {
+        name: input.template.name,
+        language: input.template.language,
+        ...input.template.body || input.template.header ? {
+          components: {
+            ...input.template.body ? { body: input.template.body } : {},
+            ...input.template.header ? { header: input.template.header } : {}
+          }
+        } : {}
+      }
+    };
+    return this.request("POST", "/messages", {
+      externalId: input.externalId,
+      to: { type: "phone", phoneE164: input.to },
+      content,
+      ...input.channel ? { channel: input.channel } : {},
+      ...input.whatsappAccountId ? { whatsappAccountId: input.whatsappAccountId } : {},
+      ...input.metadata !== void 0 ? { metadata: input.metadata } : {},
+      ...input.ttlSeconds !== void 0 ? { ttlSeconds: input.ttlSeconds } : {}
+    });
+  }
+  /** Envía un texto a todos los contactos de una lista (planes Basic/Pro). */
+  async sendBroadcast(input) {
+    return this.request("POST", "/messages/broadcast", {
+      externalId: input.externalId,
+      listId: input.listId,
+      channel: input.channel,
+      content: { type: "text", text: input.text },
+      ...input.whatsappAccountId ? { whatsappAccountId: input.whatsappAccountId } : {},
+      ...input.ttlSeconds !== void 0 ? { ttlSeconds: input.ttlSeconds } : {}
+    });
+  }
+  /** Lista las cuentas de WhatsApp del cliente. */
+  async listWhatsappAccounts() {
+    const data = await this.request(
+      "GET",
+      "/whatsapp-accounts"
+    );
+    return data.accounts;
+  }
+  /** Consulta el estado de un mensaje por su `messageId` o tu `externalId`. */
+  async getMessage(idOrExternalId) {
+    return this.request(
+      "GET",
+      `/messages/${encodeURIComponent(idOrExternalId)}`
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Arplyx,
+  ArplyxError
+});

package/dist/index.d.cts

@@ -0,0 +1,143 @@
+/** Canal de envío. `whatsapp_direct` requiere `whatsappAccountId`. */
+type Channel = 'whatsapp_meta' | 'whatsapp_direct';
+/** Estados del ciclo de vida de un mensaje. */
+type MessageState = 'pending' | 'queued' | 'sent' | 'delivered' | 'read' | 'failed';
+interface TemplateInput {
+    /** Nombre de la plantilla aprobada en tu WhatsApp Manager. */
+    name: string;
+    /** Código de idioma, ej: `es_AR`. */
+    language: string;
+    /** Variables del cuerpo (`{{1}}`, `{{2}}`…) en orden. */
+    body?: string[];
+    /** Variables del header, si la plantilla las usa. */
+    header?: string[];
+}
+interface SendMessageInput {
+    /** Tu identificador único e idempotente del envío (1–200 chars). */
+    externalId: string;
+    /** Destinatario en formato E.164, ej: `+5491155551234`. */
+    to: string;
+    /** Cuerpo del mensaje de texto. Excluyente con `template`. */
+    text?: string;
+    /** Plantilla de Meta (solo `whatsapp_meta`). Excluyente con `text`. */
+    template?: TemplateInput;
+    /** Default: `whatsapp_meta`. */
+    channel?: Channel;
+    /** UUID de la cuenta. Obligatorio para `whatsapp_direct`. */
+    whatsappAccountId?: string;
+    /** Datos arbitrarios tuyos; se guardan junto al mensaje. */
+    metadata?: Record<string, unknown> | null;
+    /** Vigencia en cola (s). Default 604800 (7d), máx 2592000 (30d). */
+    ttlSeconds?: number;
+}
+interface SendBroadcastInput {
+    /** Tu identificador único e idempotente del broadcast. */
+    externalId: string;
+    /** UUID de la lista de contactos (sección Listas del portal). */
+    listId: string;
+    /** Cuerpo del mensaje (solo texto). */
+    text: string;
+    /** Canal: sin default, es obligatorio. */
+    channel: Channel;
+    /** UUID de la cuenta. Obligatorio para `whatsapp_direct`. */
+    whatsappAccountId?: string;
+    ttlSeconds?: number;
+}
+interface MessageResponse {
+    messageId: string;
+    externalId: string;
+    status: MessageState;
+    queued: boolean;
+}
+interface BroadcastResponse {
+    broadcastId: string;
+    externalId: string;
+    listId: string;
+    messageCount: number;
+    status: string;
+}
+interface MessageStatus {
+    messageId: string;
+    externalId: string;
+    recipient: string;
+    channel: Channel;
+    status: MessageState;
+    attemptCount: number;
+    lastErrorCode: string | null;
+    broadcastId: string | null;
+    createdAt: string;
+    sentAt: string | null;
+    deliveredAt: string | null;
+    failedAt: string | null;
+}
+interface WhatsAppAccount {
+    /** Se usa como `whatsappAccountId` al enviar. */
+    id: string;
+    type: string;
+    status: string;
+    phoneNumber: string | null;
+    displayName: string | null;
+    connectedAt: string | null;
+}
+
+interface ArplyxOptions {
+    /** API key de Arplyx (`ak_live_…`). Se genera en Portal → API Keys. */
+    apiKey: string;
+    /** Base URL. Default: `https://api.arplyx.com`. */
+    baseUrl?: string;
+    /** Implementación de fetch a usar (default: el `fetch` global, Node 18+). */
+    fetch?: typeof fetch;
+}
+/**
+ * Cliente de la API de Arplyx.
+ *
+ * ```ts
+ * const arplyx = new Arplyx({ apiKey: process.env.ARPLYX_API_KEY! });
+ * await arplyx.sendMessage({
+ *   externalId: 'pedido-10045',
+ *   to: '+5491155551234',
+ *   text: 'Tu pedido fue confirmado',
+ *   channel: 'whatsapp_direct',
+ *   whatsappAccountId: '...',
+ * });
+ * ```
+ */
+declare class Arplyx {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(options: ArplyxOptions);
+    private request;
+    /** Envía un mensaje de WhatsApp (texto o plantilla). */
+    sendMessage(input: SendMessageInput): Promise<MessageResponse>;
+    /** Envía un texto a todos los contactos de una lista (planes Basic/Pro). */
+    sendBroadcast(input: SendBroadcastInput): Promise<BroadcastResponse>;
+    /** Lista las cuentas de WhatsApp del cliente. */
+    listWhatsappAccounts(): Promise<WhatsAppAccount[]>;
+    /** Consulta el estado de un mensaje por su `messageId` o tu `externalId`. */
+    getMessage(idOrExternalId: string): Promise<MessageStatus>;
+}
+
+/** Detalle de un error de validación (`400 validation_error`). */
+interface ValidationDetail {
+    path: string;
+    message: string;
+}
+/**
+ * Error devuelto por la API de Arplyx (respuesta HTTP no-2xx).
+ * `code` es el campo `error` del cuerpo (ej: `validation_error`, `conflict`,
+ * `quota_exceeded`, `invalid_whatsapp_account`, `templates_not_available`…).
+ */
+declare class ArplyxError extends Error {
+    /** Código HTTP. */
+    readonly status: number;
+    /** Código de error de Arplyx (campo `error` del cuerpo). */
+    readonly code: string;
+    /** Cuerpo crudo de la respuesta. */
+    readonly body: unknown;
+    /** Detalles de validación, si `code === 'validation_error'`. */
+    readonly details?: ValidationDetail[];
+    constructor(status: number, body: unknown);
+}
+
+export { Arplyx, ArplyxError, type ArplyxOptions, type BroadcastResponse, type Channel, type MessageResponse, type MessageState, type MessageStatus, type SendBroadcastInput, type SendMessageInput, type TemplateInput, type ValidationDetail, type WhatsAppAccount };

package/dist/index.d.ts

@@ -0,0 +1,143 @@
+/** Canal de envío. `whatsapp_direct` requiere `whatsappAccountId`. */
+type Channel = 'whatsapp_meta' | 'whatsapp_direct';
+/** Estados del ciclo de vida de un mensaje. */
+type MessageState = 'pending' | 'queued' | 'sent' | 'delivered' | 'read' | 'failed';
+interface TemplateInput {
+    /** Nombre de la plantilla aprobada en tu WhatsApp Manager. */
+    name: string;
+    /** Código de idioma, ej: `es_AR`. */
+    language: string;
+    /** Variables del cuerpo (`{{1}}`, `{{2}}`…) en orden. */
+    body?: string[];
+    /** Variables del header, si la plantilla las usa. */
+    header?: string[];
+}
+interface SendMessageInput {
+    /** Tu identificador único e idempotente del envío (1–200 chars). */
+    externalId: string;
+    /** Destinatario en formato E.164, ej: `+5491155551234`. */
+    to: string;
+    /** Cuerpo del mensaje de texto. Excluyente con `template`. */
+    text?: string;
+    /** Plantilla de Meta (solo `whatsapp_meta`). Excluyente con `text`. */
+    template?: TemplateInput;
+    /** Default: `whatsapp_meta`. */
+    channel?: Channel;
+    /** UUID de la cuenta. Obligatorio para `whatsapp_direct`. */
+    whatsappAccountId?: string;
+    /** Datos arbitrarios tuyos; se guardan junto al mensaje. */
+    metadata?: Record<string, unknown> | null;
+    /** Vigencia en cola (s). Default 604800 (7d), máx 2592000 (30d). */
+    ttlSeconds?: number;
+}
+interface SendBroadcastInput {
+    /** Tu identificador único e idempotente del broadcast. */
+    externalId: string;
+    /** UUID de la lista de contactos (sección Listas del portal). */
+    listId: string;
+    /** Cuerpo del mensaje (solo texto). */
+    text: string;
+    /** Canal: sin default, es obligatorio. */
+    channel: Channel;
+    /** UUID de la cuenta. Obligatorio para `whatsapp_direct`. */
+    whatsappAccountId?: string;
+    ttlSeconds?: number;
+}
+interface MessageResponse {
+    messageId: string;
+    externalId: string;
+    status: MessageState;
+    queued: boolean;
+}
+interface BroadcastResponse {
+    broadcastId: string;
+    externalId: string;
+    listId: string;
+    messageCount: number;
+    status: string;
+}
+interface MessageStatus {
+    messageId: string;
+    externalId: string;
+    recipient: string;
+    channel: Channel;
+    status: MessageState;
+    attemptCount: number;
+    lastErrorCode: string | null;
+    broadcastId: string | null;
+    createdAt: string;
+    sentAt: string | null;
+    deliveredAt: string | null;
+    failedAt: string | null;
+}
+interface WhatsAppAccount {
+    /** Se usa como `whatsappAccountId` al enviar. */
+    id: string;
+    type: string;
+    status: string;
+    phoneNumber: string | null;
+    displayName: string | null;
+    connectedAt: string | null;
+}
+
+interface ArplyxOptions {
+    /** API key de Arplyx (`ak_live_…`). Se genera en Portal → API Keys. */
+    apiKey: string;
+    /** Base URL. Default: `https://api.arplyx.com`. */
+    baseUrl?: string;
+    /** Implementación de fetch a usar (default: el `fetch` global, Node 18+). */
+    fetch?: typeof fetch;
+}
+/**
+ * Cliente de la API de Arplyx.
+ *
+ * ```ts
+ * const arplyx = new Arplyx({ apiKey: process.env.ARPLYX_API_KEY! });
+ * await arplyx.sendMessage({
+ *   externalId: 'pedido-10045',
+ *   to: '+5491155551234',
+ *   text: 'Tu pedido fue confirmado',
+ *   channel: 'whatsapp_direct',
+ *   whatsappAccountId: '...',
+ * });
+ * ```
+ */
+declare class Arplyx {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(options: ArplyxOptions);
+    private request;
+    /** Envía un mensaje de WhatsApp (texto o plantilla). */
+    sendMessage(input: SendMessageInput): Promise<MessageResponse>;
+    /** Envía un texto a todos los contactos de una lista (planes Basic/Pro). */
+    sendBroadcast(input: SendBroadcastInput): Promise<BroadcastResponse>;
+    /** Lista las cuentas de WhatsApp del cliente. */
+    listWhatsappAccounts(): Promise<WhatsAppAccount[]>;
+    /** Consulta el estado de un mensaje por su `messageId` o tu `externalId`. */
+    getMessage(idOrExternalId: string): Promise<MessageStatus>;
+}
+
+/** Detalle de un error de validación (`400 validation_error`). */
+interface ValidationDetail {
+    path: string;
+    message: string;
+}
+/**
+ * Error devuelto por la API de Arplyx (respuesta HTTP no-2xx).
+ * `code` es el campo `error` del cuerpo (ej: `validation_error`, `conflict`,
+ * `quota_exceeded`, `invalid_whatsapp_account`, `templates_not_available`…).
+ */
+declare class ArplyxError extends Error {
+    /** Código HTTP. */
+    readonly status: number;
+    /** Código de error de Arplyx (campo `error` del cuerpo). */
+    readonly code: string;
+    /** Cuerpo crudo de la respuesta. */
+    readonly body: unknown;
+    /** Detalles de validación, si `code === 'validation_error'`. */
+    readonly details?: ValidationDetail[];
+    constructor(status: number, body: unknown);
+}
+
+export { Arplyx, ArplyxError, type ArplyxOptions, type BroadcastResponse, type Channel, type MessageResponse, type MessageState, type MessageStatus, type SendBroadcastInput, type SendMessageInput, type TemplateInput, type ValidationDetail, type WhatsAppAccount };

package/dist/index.js

@@ -0,0 +1,128 @@
+// src/errors.ts
+var ArplyxError = class _ArplyxError extends Error {
+  /** Código HTTP. */
+  status;
+  /** Código de error de Arplyx (campo `error` del cuerpo). */
+  code;
+  /** Cuerpo crudo de la respuesta. */
+  body;
+  /** Detalles de validación, si `code === 'validation_error'`. */
+  details;
+  constructor(status, body) {
+    const b = body ?? {};
+    const code = typeof b.error === "string" ? b.error : `http_${status}`;
+    const msg = typeof b.message === "string" ? b.message : code;
+    super(`Arplyx ${status} (${code}): ${msg}`);
+    this.name = "ArplyxError";
+    this.status = status;
+    this.code = code;
+    this.body = body;
+    if (Array.isArray(b.details)) {
+      this.details = b.details;
+    }
+    Object.setPrototypeOf(this, _ArplyxError.prototype);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.arplyx.com";
+var Arplyx = class {
+  apiKey;
+  baseUrl;
+  fetchImpl;
+  constructor(options) {
+    if (!options?.apiKey) {
+      throw new Error("Arplyx: falta `apiKey`.");
+    }
+    this.apiKey = options.apiKey;
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    const f = options.fetch ?? globalThis.fetch;
+    if (!f) {
+      throw new Error(
+        "Arplyx: no hay `fetch` disponible. Us\xE1 Node 18+ o pas\xE1 una implementaci\xF3n en `options.fetch`."
+      );
+    }
+    this.fetchImpl = f;
+  }
+  async request(method, path, body) {
+    const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        "x-api-key": this.apiKey,
+        "Content-Type": "application/json"
+      },
+      body: body === void 0 ? void 0 : JSON.stringify(body)
+    });
+    const text = await res.text();
+    let data = null;
+    if (text) {
+      try {
+        data = JSON.parse(text);
+      } catch {
+        data = text;
+      }
+    }
+    if (!res.ok) {
+      throw new ArplyxError(res.status, data);
+    }
+    return data;
+  }
+  /** Envía un mensaje de WhatsApp (texto o plantilla). */
+  async sendMessage(input) {
+    if (!input.text && !input.template || input.text && input.template) {
+      throw new Error("Arplyx.sendMessage: indic\xE1 exactamente uno de `text` o `template`.");
+    }
+    const content = input.text ? { type: "text", text: input.text } : {
+      type: "template",
+      template: {
+        name: input.template.name,
+        language: input.template.language,
+        ...input.template.body || input.template.header ? {
+          components: {
+            ...input.template.body ? { body: input.template.body } : {},
+            ...input.template.header ? { header: input.template.header } : {}
+          }
+        } : {}
+      }
+    };
+    return this.request("POST", "/messages", {
+      externalId: input.externalId,
+      to: { type: "phone", phoneE164: input.to },
+      content,
+      ...input.channel ? { channel: input.channel } : {},
+      ...input.whatsappAccountId ? { whatsappAccountId: input.whatsappAccountId } : {},
+      ...input.metadata !== void 0 ? { metadata: input.metadata } : {},
+      ...input.ttlSeconds !== void 0 ? { ttlSeconds: input.ttlSeconds } : {}
+    });
+  }
+  /** Envía un texto a todos los contactos de una lista (planes Basic/Pro). */
+  async sendBroadcast(input) {
+    return this.request("POST", "/messages/broadcast", {
+      externalId: input.externalId,
+      listId: input.listId,
+      channel: input.channel,
+      content: { type: "text", text: input.text },
+      ...input.whatsappAccountId ? { whatsappAccountId: input.whatsappAccountId } : {},
+      ...input.ttlSeconds !== void 0 ? { ttlSeconds: input.ttlSeconds } : {}
+    });
+  }
+  /** Lista las cuentas de WhatsApp del cliente. */
+  async listWhatsappAccounts() {
+    const data = await this.request(
+      "GET",
+      "/whatsapp-accounts"
+    );
+    return data.accounts;
+  }
+  /** Consulta el estado de un mensaje por su `messageId` o tu `externalId`. */
+  async getMessage(idOrExternalId) {
+    return this.request(
+      "GET",
+      `/messages/${encodeURIComponent(idOrExternalId)}`
+    );
+  }
+};
+export {
+  Arplyx,
+  ArplyxError
+};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@arplyx/sdk",
+  "version": "0.1.0",
+  "description": "SDK oficial de Arplyx: enviá mensajes y broadcasts de WhatsApp y consultá estados desde Node/TypeScript.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://docs.arplyx.com/api/",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "arplyx",
+    "whatsapp",
+    "whatsapp-api",
+    "sdk",
+    "mensajeria",
+    "broadcasts"
+  ],
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  }
+}