@ezychat/wa 0.1.65 → 0.1.67

package/dist/baileys/adapter.d.ts

@@ -93,6 +93,7 @@ export declare class BaileysAdapter extends EventEmitter implements WaAdapter {
     downloadMedia(messageId: string): Promise<Buffer | null>;
     getGroupInfo(groupJid: string): Promise<WaGroupInfo>;
     checkNumber(phone: string): Promise<string | null>;
+    setBlocked(jid: string, blocked: boolean): Promise<void>;
     getAbout(jid: string): Promise<string | null>;
     getProfilePicture(jid: string): Promise<string | null>;
 }

package/dist/baileys/adapter.js

@@ -630,7 +630,9 @@ export class BaileysAdapter extends EventEmitter {
         return { id, timestamp: toMs(res.messageTimestamp) };
     }
     sendText(chatJid, text, opts) {
-        return this.send(chatJid, { text }, opts);
+        // A tag is `@<number>` in the text plus the member's address in `mentions` (contextInfo).
+        const mentions = opts?.mentions?.length ? { mentions: [...opts.mentions] } : {};
+        return this.send(chatJid, { text, ...mentions }, opts);
     }
     sendMedia(chatJid, file, opts) {
         const { buffer, mime, fileName, caption } = file;
@@ -713,6 +715,12 @@ export class BaileysAdapter extends EventEmitter {
         this.logger.info({ found: jid !== null }, 'number check');
         return jid;
     }
+    async setBlocked(jid, blocked) {
+        const sock = this.requireOpen();
+        await sock.updateBlockStatus(jid, blocked ? 'block' : 'unblock');
+        // The action only, never the number.
+        this.logger.info({ blocked }, 'block status');
+    }
     async getAbout(jid) {
         if (!this.sock || this._status.state !== 'open')
             throw new WaUnavailableError();

package/dist/fake/fake-adapter.d.ts

@@ -8,6 +8,8 @@ export interface FakeSentRecord {
     id: string;
     /** Reply options as the real adapter would receive them. */
     reply?: WaSendOptions;
+    /** Text sends: the members tagged (WhatsApp mentions). */
+    mentions?: string[];
 }
 /**
  * In-memory WaAdapter for tests and `--fake-wa` dev mode. Never touches the network.
@@ -107,6 +109,9 @@ export declare class FakeWaAdapter extends EventEmitter implements WaAdapter {
     getGroupInfo(groupJid: string): Promise<WaGroupInfo>;
     getAbout(jid: string): Promise<string | null>;
     checkNumber(phone: string): Promise<string | null>;
+    /** Numbers blocked through `setBlocked` (test helper reads it). */
+    readonly blocked: Set<string>;
+    setBlocked(jid: string, blocked: boolean): Promise<void>;
     /** checkNumber answers null for this number (every other valid number has an account). */
     setNotOnWhatsApp(phone: string): void;
     /** Make the next getAbout calls fail, as a WhatsApp request error would. */

package/dist/fake/fake-adapter.js

@@ -138,7 +138,13 @@ export class FakeWaAdapter extends EventEmitter {
     async sendText(chatJid, text, opts) {
         this.beforeSend();
         const id = `${this.idPrefix}-OUT-${FAKE_RUN}-${++this.outCounter}`;
-        this.sent.push({ chatJid, text, id, ...(opts?.quotedId ? { reply: opts } : {}) });
+        this.sent.push({
+            chatJid,
+            text,
+            id,
+            ...(opts?.quotedId ? { reply: opts } : {}),
+            ...(opts?.mentions?.length ? { mentions: [...opts.mentions] } : {}),
+        });
         return this.afterSend(chatJid, id);
     }
     async sendMedia(chatJid, file, opts) {
@@ -205,6 +211,16 @@ export class FakeWaAdapter extends EventEmitter {
             return Promise.resolve(null);
         return Promise.resolve(`${phone}@s.whatsapp.net`);
     }
+    /** Numbers blocked through `setBlocked` (test helper reads it). */
+    blocked = new Set();
+    async setBlocked(jid, blocked) {
+        if (this._status.state !== 'open')
+            throw new WaUnavailableError();
+        if (blocked)
+            this.blocked.add(jid);
+        else
+            this.blocked.delete(jid);
+    }
     /** checkNumber answers null for this number (every other valid number has an account). */
     setNotOnWhatsApp(phone) {
         this.notOnWhatsApp.add(phone);

package/dist/types.d.ts

@@ -134,6 +134,11 @@ export interface WaSendOptions {
     quotedId?: string;
     /** Used when the quoted message is no longer in the adapter's live cache. */
     quoted?: WaQuotedRef;
+    /**
+     * Text sends in groups: the members tagged in the text (each written as `@<user part of the JID>`).
+     * Only for adapters with `capabilities.mentions`.
+     */
+    mentions?: string[];
 }
 /** The message a reaction points at: WhatsApp matches it by chat, id, side and group author. */
 export interface WaReactionTarget {
@@ -179,6 +184,18 @@ export interface WaCapabilities {
     templates: boolean;
     /** Receives messages at a public https address (a webhook over Phone access / the tunnel). */
     needsPublicUrl: boolean;
+    /**
+     * Blocks and unblocks numbers (`setBlocked`). Optional so adapters written before WhatsApp Safety
+     * keep compiling: absent = cannot block.
+     */
+    block?: boolean;
+    /**
+     * Blocking works only within this many hours of the number's last message (Business API: 24);
+     * null or absent: any time.
+     */
+    blockWindowHours?: number | null;
+    /** Sends WhatsApp mentions (`WaSendOptions.mentions`); absent: no. */
+    mentions?: boolean;
 }
 /** The capabilities of an adapter that declares none: a phone linked by QR (Baileys, the fake). */
 export declare const LINKED_PHONE_CAPABILITIES: WaCapabilities;
@@ -244,6 +261,11 @@ export interface WaAdapter {
      * JID, or null when it has none. Throws WaUnavailableError when offline.
      */
     checkNumber(phone: string): Promise<string | null>;
+    /**
+     * Block (true) or unblock a number (adapters with `capabilities.block`): it can no longer message
+     * this number. Throws WaUnavailableError when offline.
+     */
+    setBlocked?(jid: string, blocked: boolean): Promise<void>;
     /** Resolve existing local phone/LID mappings only; must not query WhatsApp. */
     getContactAliases(jids: string[]): Promise<WaContactAlias[]>;
 }

package/dist/types.js

@@ -6,6 +6,9 @@ export const LINKED_PHONE_CAPABILITIES = Object.freeze({
     replyWindowHours: null,
     templates: false,
     needsPublicUrl: false,
+    block: true,
+    blockWindowHours: null,
+    mentions: true,
 });
 export class WaUnavailableError extends Error {
     code = 'wa_unavailable';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ezychat/wa",
-  "version": "0.1.65",
+  "version": "0.1.67",
   "type": "module",
   "description": "EzyChat core: WhatsApp adapter interface, Baileys adapter and fake adapter.",
   "license": "MIT",
@@ -37,7 +37,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ezychat/shared": "0.1.65",
+    "@ezychat/shared": "0.1.67",
     "baileys": "^7.0.0-rc14",
     "pino": "^10.4.0",
     "qrcode": "^1.5.4"