@stone-wpp/ofc 1.0.3 → 1.0.5

package/README.md

@@ -1,12 +1,12 @@
 <div align="center">
 
-<a href="https://stone-wpp.vercel.app/">
+<a href="https://stone-wpp.squareweb.app/">
   <img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=700&size=31&pause=1000&color=00BFFF&center=true&vCenter=true&width=760&lines=STONE+WPP;DOCUMENTA%C3%87%C3%83O+OFICIAL;CRIADO+POR+DYLAN+MODZ" alt="STONE WPP — Documentação Oficial" />
 </a>
 
 <br>
 
-<a href="https://stone-wpp.vercel.app/">
+<a href="https://stone-wpp.squareweb.app/">
   <img src="https://raw.githubusercontent.com/Yoshirukkj/Download-/main/1b2li6.jpg" alt="Banner oficial Stone WPP — clique para acessar a documentação" width="800" />
 </a>
 
@@ -14,23 +14,23 @@
 
 **STONE WPP — Biblioteca modular para WhatsApp em Node.js**
 
-*Conexão • Autenticação • Mensagens • Botões • Grupos • Canais • Plugins*
+*Conexão • Autenticação • Mensagens • Botões • Grupos • Canais • Extensions*
 
 <br>
 
-<a href="https://www.npmjs.com/package/@stone-wpp/ofc"><img src="https://img.shields.io/npm/v/%40stone-wpp%2Fofc?style=for-the-badge&logo=npm&logoColor=white&label=VERS%C3%83O&color=00BFFF&labelColor=111820" alt="Versão publicada no npm"></a>
+<a href="https://github.com/dylan-Modz/stone-wpp-ofc"><img src="https://img.shields.io/badge/VERS%C3%83O-1.0.5-00BFFF?style=for-the-badge&logo=github&logoColor=white&labelColor=111820" alt="Versão 1.0.5 do código no GitHub"></a>
 <img src="https://img.shields.io/badge/NODE.JS-20%2B-111820?style=for-the-badge&logo=node.js&logoColor=00BFFF" alt="Node.js 20 ou superior">
 <img src="https://img.shields.io/badge/LICENSE-MIT-00BFFF?style=for-the-badge&labelColor=111820" alt="Licença MIT">
 
 <br><br>
 
-<a href="https://stone-wpp.vercel.app/">
+<a href="https://stone-wpp.squareweb.app/">
   <img src="https://img.shields.io/badge/ACESSAR-DOCUMENTA%C3%87%C3%83O%20OFICIAL-00BFFF?style=for-the-badge&labelColor=111820&logo=readthedocs&logoColor=white" alt="ACESSAR DOCUMENTAÇÃO OFICIAL STONE WPP">
 </a>
 
 <br>
 
-**[📖 Clique aqui para abrir o site completo da documentação](https://stone-wpp.vercel.app/)**
+**[📖 Clique aqui para abrir o site completo da documentação](https://stone-wpp.squareweb.app/)**
 
 <sub>Guias, referências, comandos, explicações e exemplos de uso organizados no site.</sub>
 
@@ -44,9 +44,9 @@ A documentação principal da **Stone WPP** está disponível no nosso site ofic
 
 <div align="center">
 
-### **[🌐 ABRIR DOCUMENTAÇÃO — STONE WPP](https://stone-wpp.vercel.app/)**
+### **[🌐 ABRIR DOCUMENTAÇÃO — STONE WPP](https://stone-wpp.squareweb.app/)**
 
-**https://stone-wpp.vercel.app/**
+**https://stone-wpp.squareweb.app/**
 
 </div>
 
@@ -58,7 +58,7 @@ A documentação principal da **Stone WPP** está disponível no nosso site ofic
 | 🧩 **Botões** | Exemplos e referências das mensagens interativas. |
 | 👥 **Grupos e comunidades** | Operações e gerenciamento. |
 | 📢 **Canais** | Métodos e recursos disponíveis. |
-| ⚙️ **Outros módulos** | API, armazenamento, plugins e funcionalidades relacionadas. |
+| ⚙️ **Outros módulos** | API, DataLayer (armazenamento), Extensions (extensões) e funcionalidades relacionadas. |
 
 > **Importante:** a Stone WPP está em desenvolvimento. Consulte a documentação para conhecer os recursos disponíveis e suas limitações. Nem todas as funções planejadas estão implementadas.
 
@@ -99,7 +99,7 @@ stone.ev.on('connection.update', ({ connection }) => {
 })
 ```
 
-Para entender cada método, opções de conexão, eventos e exemplos, acesse a **[documentação oficial](https://stone-wpp.vercel.app/)**.
+Para entender cada método, opções de conexão, eventos e exemplos, acesse a **[documentação oficial](https://stone-wpp.squareweb.app/)**.
 
 > A Stone WPP é uma **biblioteca**, não um bot pronto. Não possui `npm start` próprio. Proteja suas sessões e credenciais; não as publique em repositórios.
 
@@ -109,7 +109,7 @@ Para entender cada método, opções de conexão, eventos e exemplos, acesse a *
 
 | Recurso | Endereço |
 | :--- | :--- |
-| 📖 **Documentação completa** | **[stone-wpp.vercel.app](https://stone-wpp.vercel.app/)** |
+| 📖 **Documentação completa** | **[stone-wpp.squareweb.app](https://stone-wpp.squareweb.app/)** |
 | 📦 **Pacote npm** | [@stone-wpp/ofc](https://www.npmjs.com/package/@stone-wpp/ofc) |
 | 🛠️ **Código-fonte** | [GitHub — Stone WPP](https://github.com/dylan-Modz/stone-wpp-ofc) |
 | 🐛 **Erros e sugestões** | [GitHub Issues](https://github.com/dylan-Modz/stone-wpp-ofc/issues) |
@@ -134,7 +134,7 @@ Para entender cada método, opções de conexão, eventos e exemplos, acesse a *
 
 <br>
 
-<a href="https://stone-wpp.vercel.app/"><img src="https://img.shields.io/badge/VER%20TODAS%20AS-DOCUMENTA%C3%87%C3%95ES-00BFFF?style=for-the-badge&labelColor=111820" alt="Ver documentação completa"></a>
+<a href="https://stone-wpp.squareweb.app/"><img src="https://img.shields.io/badge/VER%20TODAS%20AS-DOCUMENTA%C3%87%C3%95ES-00BFFF?style=for-the-badge&labelColor=111820" alt="Ver documentação completa"></a>
 
 **STONE WPP • Conecte. Desenvolva. Evolua.**
 

package/lib/Defaults/index.d.ts

@@ -1,4 +1,4 @@
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import type { SocketConfig } from '../Types/index.js';
 export declare const UNAUTHORIZED_CODES: number[];
 export declare const DEFAULT_ORIGIN = "https://web.whatsapp.com";

package/lib/Defaults/index.js

@@ -1,4 +1,4 @@
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import { makeLibSignalRepository } from '../Signal/libsignal.js';
 import { Browsers } from '../Utils/browser-utils.js';
 import logger from '../Utils/logger.js';

package/lib/Signal/Group/sender-key-distribution-message.js

@@ -1,4 +1,4 @@
-import { proto } from '../../../WAProto/index.js';
+import { proto } from '../../../Protocol/index.js';
 import { CiphertextMessage } from './ciphertext-message.js';
 export class SenderKeyDistributionMessage extends CiphertextMessage {
     constructor(id, iteration, chainKey, signatureKey, serialized) {

package/lib/Signal/Group/sender-key-message.js

@@ -1,5 +1,5 @@
 import { calculateSignature, verifySignature } from 'libsignal/src/curve.js';
-import { proto } from '../../../WAProto/index.js';
+import { proto } from '../../../Protocol/index.js';
 import { CiphertextMessage } from './ciphertext-message.js';
 export class SenderKeyMessage extends CiphertextMessage {
     constructor(keyId, iteration, ciphertext, signatureKey, serialized) {

package/lib/Socket/chats.d.ts

@@ -1,5 +1,5 @@
 import { Boom } from '@hapi/boom';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import type { BotListInfo, CacheStore, ChatModification, MessageUpsertType, SocketConfig, WABusinessProfile, WAMediaUpload, WAMessage, WAPatchCreate, WAPresence, WAPrivacyCallValue, WAPrivacyGroupAddValue, WAPrivacyMessagesValue, WAPrivacyOnlineValue, WAPrivacyValue, WAReadReceiptsValue } from '../Types/index.js';
 import type { QuickReplyAction } from '../Types/Bussines.js';
 import type { LabelActionBody } from '../Types/Label.js';

package/lib/Socket/chats.js

@@ -1,6 +1,6 @@
 import NodeCache from '@cacheable/node-cache';
 import { Boom } from '@hapi/boom';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import { DEFAULT_CACHE_TTLS, HISTORY_SYNC_PAUSED_TIMEOUT_MS, PROCESSABLE_HISTORY_TYPES } from '../Defaults/index.js';
 import { ALL_WA_PATCH_NAMES } from '../Types/index.js';
 import { SyncState } from '../Types/State.js';

package/lib/Socket/chats.js.bak

@@ -1,6 +1,6 @@
 import NodeCache from '@cacheable/node-cache';
 import { Boom } from '@hapi/boom';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import { DEFAULT_CACHE_TTLS, HISTORY_SYNC_PAUSED_TIMEOUT_MS, PROCESSABLE_HISTORY_TYPES } from '../Defaults/index.js';
 import { ALL_WA_PATCH_NAMES } from '../Types/index.js';
 import { SyncState } from '../Types/State.js';

package/lib/Socket/communities.d.ts

@@ -1,4 +1,4 @@
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import { type GroupMetadata, type ParticipantAction, type SocketConfig, type WAMessageKey } from '../Types/index.js';
 import { type BinaryNode } from '../WABinary/index.js';
 export declare const makeCommunitiesSocket: (config: SocketConfig) => {

package/lib/Socket/communities.js

@@ -1,4 +1,4 @@
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import { WAMessageStubType } from '../Types/index.js';
 import { generateMessageID, generateMessageIDV2, unixTimestampSeconds } from '../Utils/index.js';
 import logger from '../Utils/logger.js';

package/lib/Socket/groups.d.ts

@@ -1,5 +1,5 @@
 import { Boom } from '@hapi/boom';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import type { GroupMetadata, ParticipantAction, SocketConfig, WAMessageKey } from '../Types/index.js';
 import { type BinaryNode } from '../WABinary/index.js';
 export declare const makeGroupsSocket: (config: SocketConfig) => {

package/lib/Socket/groups.js

@@ -1,5 +1,5 @@
 import { Boom } from '@hapi/boom';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import { WAMessageAddressingMode, WAMessageStubType } from '../Types/index.js';
 import { generateMessageIDV2, unixTimestampSeconds } from '../Utils/index.js';
 import { getBinaryNodeChild, getBinaryNodeChildren, getBinaryNodeChildString, isLidUser, isPnUser, jidEncode, jidNormalizedUser } from '../WABinary/index.js';

package/lib/Socket/index.d.ts

@@ -256,5 +256,5 @@ declare const makeWASocket: (config: UserFacingSocketConfig) => {
     }[] | undefined>;
     fetchAccountReachoutTimelock: () => Promise<import("../index.js").ReachoutTimelockState>;
     fetchNewChatMessageCap: () => Promise<import("../index.js").NewChatMessageCapInfo>;
-};
+} & import('./stone-features.js').StoneAdditionalMethods;
 export default makeWASocket;

package/lib/Socket/index.js

@@ -1,11 +1,13 @@
 import { DEFAULT_CONNECTION_CONFIG } from '../Defaults/index.js';
 import { makeCommunitiesSocket } from './communities.js';
+import { createStoneAdditionalMethods } from './stone-features.js';
 // export the last socket layer
 const makeWASocket = (config) => {
     const newConfig = {
         ...DEFAULT_CONNECTION_CONFIG,
         ...config
     };
-    return makeCommunitiesSocket(newConfig);
+    const socket = makeCommunitiesSocket(newConfig);
+    return Object.assign(socket, createStoneAdditionalMethods(socket));
 };
 export default makeWASocket;

package/lib/Socket/messages-recv.d.ts

@@ -1,7 +1,7 @@
 import NodeCache from '@cacheable/node-cache';
 import { Boom } from '@hapi/boom';
 import Long from 'long';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import type { MessageReceiptType, MessageRelayOptions, NewChatMessageCapInfo, SocketConfig, WAMessage, WAMessageKey } from '../Types/index.js';
 import { type BinaryNode, type JidWithDevice } from '../WABinary/index.js';
 export declare const makeMessagesRecvSocket: (config: SocketConfig) => {

package/lib/Socket/messages-recv.js

@@ -2,7 +2,7 @@ import NodeCache from '@cacheable/node-cache';
 import { Boom } from '@hapi/boom';
 import { randomBytes } from 'crypto';
 import Long from 'long';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import { DEFAULT_CACHE_TTLS, KEY_BUNDLE_TYPE, MIN_PREKEY_COUNT, PLACEHOLDER_MAX_AGE_SECONDS, STATUS_EXPIRY_SECONDS } from '../Defaults/index.js';
 import { ReachoutTimelockEnforcementType, WAMessageStatus, WAMessageStubType } from '../Types/index.js';
 import { ACCOUNT_RESTRICTED_TEXT, aesDecryptCTR, aesEncryptGCM, cleanMessage, Curve, decodeMediaRetryNode, decodeMessageNode, decryptMessageNode, delay, derivePairingCodeKey, encodeBigEndian, encodeSignedDeviceIdentity, extractAddressingContext, extractE2ESessionFromRetryReceipt, getCallStatusFromNode, getHistoryMsg, getNextPreKeys, getStatusFromReceiptType, handleIdentityChange, hkdf, MISSING_KEYS_ERROR_TEXT, NACK_REASONS, NO_MESSAGE_FOUND_ERROR_TEXT, SERVER_ERROR_CODES, toNumber, unixTimestampSeconds, xmppPreKey, xmppSignedPreKey } from '../Utils/index.js';

package/lib/Socket/messages-send.d.ts

@@ -1,6 +1,6 @@
 import NodeCache from '@cacheable/node-cache';
 import { Boom } from '@hapi/boom';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import type { AnyMessageContent, MediaConnInfo, MessageReceiptType, MessageRelayOptions, MiscMessageGenerationOptions, SocketConfig, WAMessage, WAMessageKey } from '../Types/index.js';
 import { MessageRetryManager } from '../Utils/index.js';
 import { type BinaryNode, type JidWithDevice } from '../WABinary/index.js';

package/lib/Socket/messages-send.js

@@ -1,6 +1,6 @@
 import NodeCache from '@cacheable/node-cache';
 import { Boom } from '@hapi/boom';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import { DEFAULT_CACHE_TTLS, WA_DEFAULT_EPHEMERAL } from '../Defaults/index.js';
 import { aggregateMessageKeysNotFromMe, assertMediaContent, assertMeId, bindWaitForEvent, decryptMediaRetryData, DEF_MEDIA_HOST, encodeNewsletterMessage, encodeSignedDeviceIdentity, encodeWAMessage, encryptMediaRetryRequest, extractDeviceJids, generateMessageIDV2, generateParticipantHashV2, generateWAMessage, getStatusCodeForMediaRetry, getUrlFromDirectPath, getWAUploadToServer, MessageRetryManager, normalizeMessageContent, parseAndInjectE2ESessions, unixTimestampSeconds } from '../Utils/index.js';
 import { getUrlInfo } from '../Utils/link-preview.js';

package/lib/Socket/socket.js

@@ -2,7 +2,7 @@ import { Boom } from '@hapi/boom';
 import { randomBytes } from 'crypto';
 import { URL } from 'url';
 import { promisify } from 'util';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import { DEF_CALLBACK_PREFIX, DEF_TAG_PREFIX, INITIAL_PREKEY_COUNT, MIN_PREKEY_COUNT, NOISE_WA_HEADER, PROCESSABLE_HISTORY_TYPES, TimeMs, UPLOAD_TIMEOUT } from '../Defaults/index.js';
 import { QueryIds, ReachoutTimelockEnforcementType } from '../Types/index.js';
 import { DisconnectReason, XWAPaths } from '../Types/index.js';

package/lib/Socket/stone-features.d.ts

@@ -0,0 +1,30 @@
+import type { MiscMessageGenerationOptions, WAMessage, WAMessageKey } from '../Types/index.js'
+import type { Label } from '../Types/Label.js'
+
+export interface StoneAdditionalMethods {
+  /** Pesquisa username pelo USync. Não retorna números de telefone. */
+  queryUsernameExists(username: string, pin?: string): Promise<{ username: string; jid: string; wid: string; exists: true } | null>;
+  /** Cria ou altera uma nota da conta WhatsApp Business via app-state. */
+  setCustomerNote(jid: string, content: string, noteId?: string): Promise<{ id: string; chatId: string; content: string; createdAt: number; type: 'unstructured' }>;
+  /** Exclui a nota de uma conversa; exige id conhecido ou sincronizado. */
+  deleteCustomerNote(jid: string, noteId?: string): Promise<boolean>;
+  /** Nota observada pela sincronização desta conexão; pode ser null mesmo se existir no WhatsApp. */
+  getCustomerNote(jid: string): { id: string; chatId: string; content: string; createdAt: number; type: 'unstructured' } | null;
+  /** Native Flow Pix. Envia a chave, não processa pagamento; depende da conta WhatsApp. */
+  sendPixKeyMessage(
+    jid: string,
+    data: { keyType: 'CPF' | 'CNPJ' | 'PHONE' | 'EMAIL' | 'EVP'; name: string; key: string; instructions?: string },
+    options?: MiscMessageGenerationOptions
+  ): Promise<WAMessage | undefined>;
+  /** Solicitação KeepInChat; exige permissões e mensagem ainda disponível. */
+  keepMessage(jid: string, messageKey: WAMessageKey, keep?: boolean): Promise<string>;
+  /** Edita a etiqueta no app-state do WhatsApp. */
+  editLabel(id: string, updates: { name?: string; color?: number }): Promise<unknown>;
+  /** Exclui uma etiqueta no app-state do WhatsApp. */
+  deleteLabel(id: string): Promise<unknown>;
+  /** Etiquetas observadas pelos eventos labels.edit desta conexão; lista pode ser parcial. */
+  getLabels(): Label[];
+  /** Etiqueta observada no app-state nesta conexão, ou undefined. */
+  getLabelById(id: string): Label | undefined;
+}
+export declare function createStoneAdditionalMethods(socket: unknown): StoneAdditionalMethods

package/lib/Socket/stone-features.js

@@ -0,0 +1,255 @@
+import { randomUUID } from 'node:crypto'
+import { USyncQuery, USyncUser } from '../WAUSync/index.js'
+
+const PIX_KEY_TYPES = new Set(['CPF', 'CNPJ', 'PHONE', 'EMAIL', 'EVP'])
+
+const requireJid = (jid) => {
+  if (typeof jid !== 'string' || !jid.includes('@')) {
+    throw new TypeError('Informe um JID válido')
+  }
+  return jid
+}
+
+const requireId = (id, label = 'ID') => {
+  if (typeof id !== 'string' || !id.trim()) {
+    throw new TypeError(`Informe um ${label} válido`)
+  }
+  return id.trim()
+}
+
+/**
+ * Stone socket extensions. The underlying connection and auth are unchanged.
+ * Methods added here must use the existing WhatsApp transport (never mock success).
+ */
+export function createStoneAdditionalMethods(socket) {
+  const seenLabels = new Map()
+  const seenCustomerNotes = new Map()
+  const customerNoteByChat = new Map()
+
+  socket.ev.on('notes.edit', (note) => {
+    if (!note?.id || !note?.chatId) return
+    if (note.deleted) {
+      seenCustomerNotes.delete(note.id)
+      if (customerNoteByChat.get(note.chatId) === note.id) customerNoteByChat.delete(note.chatId)
+    } else {
+      const updated = {
+        ...(seenCustomerNotes.get(note.id) || {}),
+        id: note.id,
+        chatId: note.chatId,
+        content: note.content ?? '',
+        createdAt: note.createdAt,
+        type: 'unstructured'
+      }
+      seenCustomerNotes.set(note.id, updated)
+      customerNoteByChat.set(note.chatId, note.id)
+    }
+  })
+
+  // labels.edit is emitted from WhatsApp's app-state synchronization.
+  // This is an observed cache, NOT an authoritative account-wide label fetch.
+  socket.ev.on('labels.edit', (label) => {
+    if (!label?.id) return
+    if (label.deleted) {
+      seenLabels.delete(label.id)
+    } else {
+      seenLabels.set(label.id, { ...seenLabels.get(label.id), ...label })
+    }
+  })
+
+  return {
+    /**
+     * Consulta um @username pelo USync do WhatsApp, com PIN opcional.
+     * Não revela nem infere o número de telefone.
+     */
+    async queryUsernameExists(username, pin) {
+      if (typeof username !== 'string') throw new TypeError('Informe o @username')
+      const normalized = username.trim().replace(/^@/, '')
+      if (!/^[A-Za-z0-9_.]{3,30}$/.test(normalized)) {
+        throw new TypeError('Username inválido')
+      }
+      if (pin !== undefined && !/^\d{4}$/.test(pin)) {
+        throw new TypeError('O PIN deve conter exatamente 4 dígitos')
+      }
+      const user = new USyncUser().withUsername(normalized)
+      if (pin !== undefined) user.withUsernameKey(pin)
+      const query = new USyncQuery().withContactProtocol().withUser(user)
+      const response = await socket.executeUSyncQuery(query)
+      const contact = response?.list?.find(entry => entry?.contact === true && typeof entry.id === 'string')
+      return contact ? { username: normalized, jid: contact.id, wid: contact.id, exists: true } : null
+    },
+
+    /**
+     * Cria ou altera uma nota comercial via app-state do WhatsApp.
+     * Receber uma nota depende de a conta oferecer o recurso comercial.
+     */
+    async setCustomerNote(jid, content, noteId) {
+      requireJid(jid)
+      if (jid.endsWith('@g.us') || jid.endsWith('@newsletter')) {
+        throw new TypeError('Notas são permitidas apenas em conversas individuais')
+      }
+      if (typeof content !== 'string' || !content.trim()) {
+        throw new TypeError('Informe o conteúdo da nota')
+      }
+      const id = noteId == null ? customerNoteByChat.get(jid) || randomUUID() : requireId(noteId, 'ID da nota')
+      const existing = seenCustomerNotes.get(id)
+      const createdAt = existing?.createdAt || Math.floor(Date.now() / 1000)
+      const note = { id, chatId: jid, content: content.trim(), createdAt, type: 'unstructured' }
+      await socket.chatModify({ noteEdit: { ...note, deleted: false } }, jid)
+      seenCustomerNotes.set(id, note)
+      customerNoteByChat.set(jid, id)
+      return { ...note }
+    },
+
+    /** Remove uma nota comercial, identificada pelo JID e/ou ID previamente sincronizado. */
+    async deleteCustomerNote(jid, noteId) {
+      requireJid(jid)
+      const id = noteId == null ? customerNoteByChat.get(jid) : requireId(noteId, 'ID da nota')
+      if (!id) throw new Error('Nota não encontrada nesta conexão: informe o ID para excluir')
+      const existing = seenCustomerNotes.get(id)
+      await socket.chatModify({
+        noteEdit: {
+          id, chatId: jid, createdAt: existing?.createdAt || Math.floor(Date.now() / 1000),
+          content: '', deleted: true
+        }
+      }, jid)
+      seenCustomerNotes.delete(id)
+      if (customerNoteByChat.get(jid) === id) customerNoteByChat.delete(jid)
+      return true
+    },
+
+    /**
+     * Nota observada pela sincronização desta conexão ou criada agora.
+     * Retorna null se a nota ainda não tiver sido sincronizada.
+     */
+    getCustomerNote(jid) {
+      requireJid(jid)
+      const id = customerNoteByChat.get(jid)
+      const note = id && seenCustomerNotes.get(id)
+      return note ? { ...note } : null
+    },
+
+    /**
+     * Envia o Native Flow de pagamento Pix para contas WhatsApp compatíveis.
+     * Não efetua nem verifica pagamentos.
+     */
+    async sendPixKeyMessage(jid, data, options = {}) {
+      requireJid(jid)
+      if (!data || typeof data !== 'object') {
+        throw new TypeError('Informe os dados do Pix')
+      }
+      const { keyType, name, key, instructions = '' } = data
+      if (!PIX_KEY_TYPES.has(keyType)) {
+        throw new TypeError('keyType deve ser CPF, CNPJ, PHONE, EMAIL ou EVP')
+      }
+      if (typeof name !== 'string' || !name.trim()) {
+        throw new TypeError('Informe o nome do recebedor')
+      }
+      if (typeof key !== 'string' || !key.trim()) {
+        throw new TypeError('Informe a chave Pix')
+      }
+      if (typeof instructions !== 'string') {
+        throw new TypeError('instructions deve ser texto')
+      }
+      const ref = randomUUID().replace(/-/g, '')
+      const zero = { value: 0, offset: 1 }
+      const payment = {
+        order: {
+          items: [{ name: '', retailer_id: `stone-${ref}`, amount: { ...zero }, quantity: 0 }],
+          order_type: 'ORDER_WITHOUT_AMOUNT',
+          status: 'payment_requested',
+          subtotal: { ...zero }
+        },
+        total_amount: { ...zero },
+        reference_id: ref,
+        payment_settings: [
+          { type: 'pix_static_code', pix_static_code: { key_type: keyType, merchant_name: name.trim(), key: key.trim() } },
+          { type: 'cards', cards: { enabled: false } }
+        ],
+        external_payment_configurations: [
+          { type: 'payment_instruction', payment_instruction: instructions }
+        ],
+        additional_note: '',
+        currency: 'BRL',
+        type: 'physical-goods'
+      }
+      return socket.sendMessage(jid, {
+        interactive: {
+          text: '',
+          buttons: [{ name: 'payment_info', buttonParamsJson: JSON.stringify(payment) }],
+          messageVersion: 1
+        }
+      }, options)
+    },
+
+    /**
+     * Solicita manter/desfazer uma mensagem temporária via KeepInChatMessage.
+     * A confirmação depende do servidor e das permissões da conversa.
+     */
+    async keepMessage(jid, messageKey, keep = true) {
+      requireJid(jid)
+      if (!messageKey || typeof messageKey !== 'object' || !messageKey.id) {
+        throw new TypeError('Informe a chave da mensagem original (messageKey)')
+      }
+      if (messageKey.remoteJid && messageKey.remoteJid !== jid) {
+        throw new TypeError('A mensagem não pertence ao JID informado')
+      }
+      if (typeof keep !== 'boolean') {
+        throw new TypeError('keep deve ser true ou false')
+      }
+      return socket.relayMessage(jid, {
+        keepInChatMessage: {
+          key: messageKey,
+          keepType: keep ? 1 : 2,
+          timestampMs: Date.now()
+        }
+      }, {})
+    },
+
+    /**
+     * Atualiza uma etiqueta usando a app-state API já existente na Stone.
+     */
+    async editLabel(id, updates) {
+      requireId(id, 'ID da etiqueta')
+      if (!updates || typeof updates !== 'object' || Array.isArray(updates)) {
+        throw new TypeError('Informe as alterações da etiqueta')
+      }
+      const { name, color } = updates
+      if (name === undefined && color === undefined) {
+        throw new TypeError('Informe name e/ou color')
+      }
+      if (name !== undefined && (typeof name !== 'string' || !name.trim())) {
+        throw new TypeError('name deve ser texto não vazio')
+      }
+      if (color !== undefined && (!Number.isInteger(color) || color < 0 || color > 19)) {
+        throw new TypeError('color deve ser um inteiro de 0 a 19')
+      }
+      return socket.addLabel('', {
+        id: id.trim(),
+        ...(name === undefined ? {} : { name: name.trim() }),
+        ...(color === undefined ? {} : { color }),
+        deleted: false
+      })
+    },
+
+    /** Exclui uma etiqueta real via app-state. */
+    async deleteLabel(id) {
+      requireId(id, 'ID da etiqueta')
+      return socket.addLabel('', { id: id.trim(), deleted: true })
+    },
+
+    /**
+     * Apenas etiquetas recebidas em eventos labels.edit desde que o socket iniciou.
+     * Não garante listagem completa da conta. Consulte a documentação.
+     */
+    getLabels() {
+      return [...seenLabels.values()].map(label => ({ ...label }))
+    },
+
+    /** Consulta a etiqueta que passou pelo sync desta conexão. */
+    getLabelById(id) {
+      requireId(id, 'ID da etiqueta')
+      const label = seenLabels.get(id.trim())
+      return label ? { ...label } : undefined
+    }
+  }
+}

package/lib/Types/Auth.d.ts

@@ -1,4 +1,4 @@
-import type { proto } from '../../WAProto/index.js';
+import type { proto } from '../../Protocol/index.js';
 import type { Contact } from './Contact.js';
 import type { MinimalMessage } from './Message.js';
 export type KeyPair = {

package/lib/Types/Chat.d.ts

@@ -1,4 +1,4 @@
-import type { proto } from '../../WAProto/index.js';
+import type { proto } from '../../Protocol/index.js';
 import type { AccountSettings } from './Auth.js';
 import type { QuickReplyAction } from './Bussines.js';
 import type { BufferedEventData } from './Events.js';

package/lib/Types/Events.d.ts

@@ -1,5 +1,5 @@
 import type { Boom } from '@hapi/boom';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import type { AuthenticationCreds, LIDMapping } from './Auth.js';
 import type { WACallEvent } from './Call.js';
 import type { Chat, ChatUpdate, PresenceData } from './Chat.js';
@@ -123,6 +123,13 @@ export type StoneWPPEventMap = {
     };
     /** Receive an update on a call, including when the call was received, rejected, accepted */
     call: WACallEvent[];
+    'notes.edit': {
+        id: string;
+        chatId: string;
+        content?: string;
+        createdAt?: number;
+        deleted: boolean;
+    };
     'labels.edit': Label;
     'labels.association': {
         association: LabelAssociation;

package/lib/Types/Events.js

@@ -1,2 +1,2 @@
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 //# sourceMappingURL=Events.js.map

package/lib/Types/Message.d.ts

@@ -1,6 +1,6 @@
 import type { Readable } from 'stream';
 import type { URL } from 'url';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import type { MediaType } from '../Defaults/index.js';
 import type { BinaryNode } from '../WABinary/index.js';
 import type { GroupMetadata } from './GroupMetadata.js';

package/lib/Types/Message.js

@@ -1,4 +1,4 @@
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 // export the WAMessage Prototypes
 export { proto as WAProto };
 export const WAMessageStubType = proto.WebMessageInfo.StubType;

package/lib/Types/Signal.d.ts

@@ -1,4 +1,4 @@
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import type { LIDMappingStore } from '../Signal/lid-mapping.js';
 type DecryptGroupSignalOpts = {
     group: string;

package/lib/Types/Signal.js

@@ -1,2 +1,2 @@
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 //# sourceMappingURL=Signal.js.map

package/lib/Types/Socket.d.ts

@@ -1,6 +1,6 @@
 import type { Agent } from 'https';
 import type { URL } from 'url';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import type { ILogger } from '../Utils/logger.js';
 import type { AuthenticationState, LIDMapping, SignalAuthState, TransactionCapabilityOptions } from './Auth.js';
 import type { GroupMetadata } from './GroupMetadata.js';

package/lib/Types/Socket.js

@@ -1,3 +1,3 @@
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import {} from './Message.js';
 //# sourceMappingURL=Socket.js.map

package/lib/Utils/browser-utils.js

@@ -1,5 +1,5 @@
 import { platform, release } from 'os';
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 const PLATFORM_MAP = {
     aix: 'AIX',
     darwin: 'Mac OS',

package/lib/Utils/chat-utils.d.ts

@@ -1,4 +1,4 @@
-import { proto } from '../../WAProto/index.js';
+import { proto } from '../../Protocol/index.js';
 import type { StoneWPPEventEmitter, ChatModification, ChatMutation, Contact, InitialAppStateSyncOptions, LTHashState, WAPatchCreate, WAPatchName } from '../Types/index.js';
 import { type BinaryNode } from '../WABinary/index.js';
 import type { ILogger } from './logger.js';