Contact¶

La entidad Contact representa a cualquier usuario de WhatsApp del que tu sesión tenga conocimiento, ya sea que haya iniciado un chat, aparezca en un grupo o haya sido descubierto vía lookups onWhatsApp. Cada contacto incluye una propiedad eager chat apuntando a su instancia Chat 1:1, de modo que puedes saltar de "quién" a "dónde" sin lookups adicionales.

Contact.get(uid) es el único punto de entrada y despacha según la forma del identificador:

• Teléfono plano (solo dígitos, sin @) → resuelto a través de socket.onWhatsApp(phone).
• JID (<number>@s.whatsapp.net) → buscado en el motor, refrescado desde el socket si falta.
• LID (<number>@lid) → resuelto vía el mapeo persistido LID↔JID.

Importación¶

import { WhatsApp, RedisEngine } from "@arcaelas/whatsapp";
// o
import { WhatsApp, FileSystemEngine } from "@arcaelas/whatsapp";

Usa el constructor vinculado vía wa.Contact. La factory contact(wa) (interna) produce una subclase _Contact vinculada al contexto de WhatsApp: sobre eso operan los delegados estáticos.

Constructor¶

Como Chat, las instancias de Contact no están pensadas para construirse directamente. Provienen de:

• wa.Contact.get(uid) — despacho inteligente por teléfono, JID o LID.
• wa.Contact.list(offset, limit) — lecturas paginadas.
• chat.members() — participantes de grupos.
• Handlers de eventos para contact:created/contact:updated.
• msg.author() — el remitente de un mensaje.

import { WhatsApp, RedisEngine } from "@arcaelas/whatsapp";

const wa = new WhatsApp({
  engine: new RedisEngine({ url: "redis://127.0.0.1:6379" }),
});

await wa.connect();

// Número de teléfono (solo dígitos)
const byPhone = await wa.Contact.get("5215555555555");

// JID
const byJid = await wa.Contact.get("5215555555555@s.whatsapp.net");

// LID (identificador oculto asignado por WhatsApp)
const byLid = await wa.Contact.get("192837465@lid");

console.log(byPhone?.name, byJid?.phone, byLid?.id);

Propiedades¶

Todas las propiedades son getters síncronos sobre la forma interna _raw: IContactRaw, excepto chat, que se hidrata eagerly en la construcción.

IContactRaw¶

export interface IContactRaw {
  id: string;
  lid?: string | null;
  name?: string | null;
  notify?: string | null;
  verified_name?: string | null;
  img_url?: string | null;
  status?: string | null;
}

Propiedad eager chat¶

Contact.chat no es una función, es una instancia wa.Chat completamente construida disponible sincrónicamente. Te permite encadenar llamadas como:

const contact = await wa.Contact.get("5215555555555");
if (contact) {
  await contact.chat.pin(true);
  await contact.chat.typing(true);
  await wa.Message.text(contact.chat.id, "Ready to go!");
  await contact.chat.typing(false);
}

Métodos¶

rename(name: string)¶

Renombra el contacto localmente (solo libreta de direcciones del dispositivo). No se propaga a los servidores de WhatsApp, pero el nuevo valor es visible inmediatamente a través de .name y se persiste vía el motor.

const contact = await wa.Contact.get("5215555555555");
await contact?.rename("Alice Example");

Devuelve true en caso de éxito, false cuando el contacto no puede ser resuelto.

refresh()¶

Re-hidrata photo y content (bio/estado) desde el socket en vivo y reescribe el documento del motor. Devuelve this en caso de éxito, null si no hay socket activo.

const contact = await wa.Contact.get("5215555555555@s.whatsapp.net");
await contact?.refresh();
console.log(contact?.photo, contact?.content);

Estáticos (delegado vía wa.Contact)¶

import { WhatsApp, FileSystemEngine } from "@arcaelas/whatsapp";

const wa = new WhatsApp({
  engine: new FileSystemEngine({ path: "./.whatsapp" }),
});

await wa.connect();

// Delegados de una línea
await wa.Contact.rename("5215555555555", "Alice");
await wa.Contact.refresh("5215555555555@s.whatsapp.net");

// Iterar cada contacto
let offset = 0;
while (true) {
  const batch = await wa.Contact.list(offset, 100);
  if (batch.length === 0) break;
  for (const c of batch) {
    console.log(c.phone, c.name, c.photo ?? "(no photo)");
  }
  offset += batch.length;
}

Rutas de persistencia¶

Los registros relacionados con contactos viven bajo las siguientes claves en el motor configurado:

import { WhatsApp, RedisEngine } from "@arcaelas/whatsapp";

const wa = new WhatsApp({
  engine: new RedisEngine({ url: "redis://127.0.0.1:6379" }),
  autoclean: false, // conservar /contact/*, /lid/*, /chat/* entre relogins
});