@arcaelas/whatsapp 1.0.2

package/README.md

@@ -0,0 +1,367 @@
+![Arcaelas Insiders](https://raw.githubusercontent.com/arcaelas/dist/main/banner/svg/dark.svg#gh-dark-mode-only) ![Arcaelas Insiders](https://raw.githubusercontent.com/arcaelas/dist/main/banner/svg/light.svg#gh-light-mode-only)
+
+# @arcaelas/whatsapp
+
+> A **multi‑device**, storage‑agnostic WhatsApp client for Node.js.
+>
+> _Typed end‑to‑end · Sends any media · Zero‑boilerplate API · Written in TypeScript only_
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@arcaelas/whatsapp"><img src="https://img.shields.io/npm/v/@arcaelas/whatsapp?color=cb3837" alt="npm version"></a>
+  <img src="https://img.shields.io/bundlephobia/minzip/@arcaelas/whatsapp?label=gzip" alt="bundle size">
+  <img src="https://img.shields.io/github/license/arcaelas/whatsapp" alt="MIT">
+</p>
+
+---
+
+## Contents
+
+-   [Install](#install)
+-   [Quick Start](#quick-start)
+-   [Zero to Hero Guide](#zero-to-hero-guide)
+
+    -   [1. Create a Store](#1-create-a-store)
+    -   [2. Initialise the client](#2-initialise-the-client)
+    -   [3. Read chats & messages](#3-read-chats--messages)
+    -   [4. Send your first message](#4-send-your-first-message)
+
+-   [Interfaces & Types](#interfaces--types)
+
+    -   [`IWhatsApp`](#iwhatsapp)
+    -   [`Store`](#store)
+
+-   [API Reference](#api-reference)
+
+    -   [Chats](#chats)
+    -   [Messages](#messages)
+    -   [Presence](#presence)
+    -   [Media Helpers](#media-helpers)
+
+-   [Storage Back‑ends](#storage-back‑ends)
+
+    -   [In‑memory](#in‑memory)
+    -   [File‑system](#file‑system)
+    -   [Redis](#redis)
+
+-   [Recipes](#recipes)
+-   [Troubleshooting](#troubleshooting)
+-   [Contributing](#contributing)
+-   [License](#license)
+
+---
+
+## Install
+
+```bash
+# core package
+yarn add @arcaelas/whatsapp
+
+# peer dependency (Baileys – WhatsApp MD layer)
+yarn add @whiskeysockets/baileys
+# plus any media codecs you wish (ffmpeg, sharp, etc.)
+```
+
+> Node 18+ required. Works in ESM & TypeScript projects out of the box.
+
+---
+
+## Quick Start
+
+```ts
+import WhatsApp from '@arcaelas/whatsapp';
+import qrcode from 'qrcode-terminal';
+
+const socket = new WhatsApp({
+    phone: '+01000000000',
+    loginType: 'qr',
+    qr: (buffer) => qrcode.generate(buffer.toString('base64'), { small: true }),
+});
+
+await socket.ready(); // blocks until authenticated
+
+const [chat] = await socket.chats();
+await chat.send('Hello from Arcaelas 🤖');
+```
+
+---
+
+## Zero‑to‑Hero Guide
+
+### 1. Create a Store
+
+The library is **storage‑agnostic**. Implement the minimal `Store` contract once and reuse everywhere.
+
+```ts
+/** Minimal in‑memory store for demos */
+const MemoryStore: Store = {
+    map: new Map<string, string>(),
+
+    has(key) {
+        return this.map.has(key);
+    },
+    get(key) {
+        return JSON.parse(this.map.get(key) ?? 'null');
+    },
+    set(key, value) {
+        if (value == null) return this.delete(key);
+        this.map.set(key, JSON.stringify(value));
+        return true;
+    },
+    delete(key) {
+        return this.map.delete(key);
+    },
+    async *keys() {
+        for (const k of this.map.keys()) yield k;
+    },
+    async *values() {
+        for (const v of this.map.values()) yield JSON.parse(v);
+    },
+    async *entries() {
+        for (const [k, v] of this.map.entries()) yield [k, JSON.parse(v)];
+    },
+    clear() {
+        this.map.clear();
+        return true;
+    },
+};
+```
+
+## Storage Layer
+
+The client is completely storage-agnostic. You may use Redis, filesystem or in-memory persistence. The storage system must implement the `Store` interface.
+
+### Key structure (logical)
+
+```
+account:{phone}:index                           → Account
+account:{phone}:chat:{id}:index                 → Chat
+account:{phone}:chat:{id}:message:{id}:index    → Message
+```
+
+### Directory-style translation
+
+```
+account/
+└── {phone}/
+    ├── index
+    └── chat/
+        └── {id}/
+            ├── index
+            └── message/
+                └── {id}/
+                    └── index
+```
+
+> ✅ Esto permite separar metadatos de contenido, aplicar TTLs, y reducir lecturas innecesarias.
+
+### 2. Initialise the client
+
+```ts
+const socket = new WhatsApp({
+    phone: '+584100000000',
+    loginType: 'code',
+    code: (pairCode) => console.log('Pair with:', pairCode),
+    store: MemoryStore,
+});
+```
+
+### 3. Read chats & messages
+
+```ts
+const chats = await socket.chats();
+for (const chat of chats) {
+    console.log(`📨 ${chat.id} has ${await chat.messages().then((m) => m.length)} messages`);
+}
+```
+
+### 4. Send your first message
+
+```ts
+const [target] = chats;
+await target.send('¡Hola Mundo!', { once: true });
+```
+
+---
+
+## Interfaces & Types
+
+### `IWhatsApp`
+
+```ts
+interface IWhatsApp<T extends 'qr' | 'code'> {
+    phone: string;
+    store?: Store;
+    loginType: T;
+    code: T extends 'code' ? (code: string) => void : never;
+    qr: T extends 'qr' ? (buffer: Buffer) => void : never;
+}
+```
+
+| Field       | Required      | Description                                                                        |
+| ----------- | ------------- | ---------------------------------------------------------------------------------- |
+| `phone`     | ✔             | International format (`+5841…`).                                                   |
+| `store`     | ✖             | Backend persistence (defaults to in‑memory volatile store).                        |
+| `loginType` | ✔             | `'qr'` or `'code'`. Determines which callback is required.                         |
+| `code`      | _Conditional_ | Fired once with the pairing **numeric code** when `loginType === 'code'`.          |
+| `qr`        | _Conditional_ | Fired with a **Buffer JPG/PNG** containing the QR image when `loginType === 'qr'`. |
+
+### `Store`
+
+Contract used everywhere the SDK needs persistence: creds, chats, media pointers… Full JSDoc in `src/types/Store.ts`.
+
+```ts
+interface Store {
+    has(key: string): boolean | Promise<boolean>;
+    get(key: string): any | Promise<any>;
+    set(key: string, value: any): boolean | Promise<boolean>;
+    delete(key: string): boolean | Promise<boolean>;
+    keys(): AsyncGenerator<string>;
+    values(): AsyncGenerator<any>;
+    entries(): AsyncGenerator<[string, any]>;
+    clear(): boolean | Promise<boolean>;
+    scan?(pattern: string): string[] | Promise<string[]>;
+}
+```
+
+---
+
+## API Reference
+
+### Chats
+
+```ts
+socket.chats(): Promise<Chat[]>;
+```
+
+| Method                | Description                                                            |
+| --------------------- | ---------------------------------------------------------------------- |
+| `pin()`               | Pin chat to top.                                                       |
+| `mute()` / `unmute()` | Toggle notifications.                                                  |
+| `seen()`              | Mark as read.                                                          |
+| `presence(state)`     | Update own presence (`available`, `composing`, `recording`, `paused`). |
+| `delete()`            | Remove chat locally.                                                   |
+| `messages()`          | Fetch cached messages (lazy‑loaded).                                   |
+
+### Messages
+
+| Method              | Description                                |
+| ------------------- | ------------------------------------------ |
+| `content()`         | Returns payload: `string` or `Buffer`.     |
+| `reply(body, opts)` | Reply in thread. Supports all media types. |
+| `seen()`            | Mark as read.                              |
+| `delete()`          | Delete for everyone when possible.         |
+| `like(emoji)`       | Simple reaction helper.                    |
+| `forward(chatid)`   | Forward to another chat.                   |
+
+Return type fields:
+
+```ts
+type MessageBase = {
+    id: string;
+    type: 'text' | 'image' | 'audio' | 'video' | 'location';
+    caption?: string;
+    once?: boolean;
+    ptt?: boolean; // push‑to‑talk
+    ptv?: boolean; // video‑note
+};
+```
+
+### Presence
+
+```ts
+await chat.presence('composing'); // typing…
+```
+
+### Media Helpers
+
+All `send()`/`reply()` share the same overload signature:
+
+```ts
+send(body: string | Buffer | { lat: number; lon: number }, opts?: SendOptions): Promise<Message>;
+
+interface SendOptions {
+  type?: "audio" | "video" | "image" | "location";
+  caption?: string; // images
+  ptt?: boolean; // audio
+  ptv?: boolean; // video‑note
+  once?: boolean; // view‑once
+}
+```
+
+---
+
+## Storage Back‑ends
+
+### In‑memory
+
+Use the demo `MemoryStore` from the Zero‑to‑Hero section. Volatile.
+
+### File‑system
+
+```ts
+import fs from 'node:fs/promises';
+
+function FSStore(dir: string): Store {
+    /* … */
+}
+```
+
+Stores everything under `.cache/` exactly like the suggested tree.
+
+### Redis
+
+```ts
+import { createClient } from 'redis';
+
+function RedisStore(client = createClient()): Store {
+    /* … */
+}
+```
+
+Use `SCAN` for iteration and implement `scan(pattern)` via `KEYS`/`SCAN` glob.
+
+---
+
+## Recipes
+
+### Auto‑responder bot
+
+```ts
+socket.on('message', async (msg) => {
+    if (msg.type === 'text' && msg.content().includes('ping')) {
+        await msg.reply('pong 🏓');
+    }
+});
+```
+
+### Send location every hour
+
+```ts
+setInterval(async () => {
+    await chat.send({ lat: 8.3014, lon: -62.7166 }, { type: 'location' });
+}, 3.6e6);
+```
+
+---
+
+## Troubleshooting
+
+| Error                           | Cause & Fix                                                                            |
+| ------------------------------- | -------------------------------------------------------------------------------------- |
+| `401 – Session invalid`         | Credentials expired → re‑authenticate (clear `store` keys for `auth:` prefix).         |
+| `ERR_PACKAGE_PATH_NOT_EXPORTED` | Make sure you import ESM build (`import …`).                                           |
+| `BaileysBoomError 428`          | Connection closed by server – client will auto‑retry; ensure network clock is in sync. |
+
+---
+
+## Contributing
+
+1. Fork → branch → PR (conventional commits).
+2. `yarn lint && yarn test` must pass.
+3. Document new features in this README.
+
+---
+
+## License
+
+MIT — © 2025 [Miguel Alejandro](https://github.com/arcaelas) / Arcaelas Insiders.

package/build/index.d.ts

@@ -0,0 +1,217 @@
+import { Noop } from '@arcaelas/utils';
+import { type Boom } from '@hapi/boom';
+import { Mutex } from 'async-mutex';
+import * as Baileys from 'baileys';
+import EventEmitter from 'node:events';
+import Chat from './model/chat';
+import Message from './model/message';
+import Store, { Engine } from './static/Store';
+interface IWhatsApp<T extends 'qr' | 'code'> {
+    phone: string;
+    store?: Engine;
+    loginType: T;
+    qr: T extends 'qr' ? Noop<[QR: string]> : never;
+    code: T extends 'code' ? Noop<[code: string]> : never;
+}
+interface EventMap {
+    error: [error: Error];
+    open: [];
+    close: [];
+    qr: [qr: string];
+    code: [code: string];
+    'chat:created': [chat: Chat];
+    'chat:updated': [chat: Chat];
+    'chat:deleted': [id: string];
+    'message:created': [message: Message];
+    'message:updated': [message: Message];
+    'message:deleted': [id: string];
+}
+/**
+ * @description
+ * Client for WhatsApp Web.
+ * @example
+ * const client = new WhatsApp({
+ *  phone: '1234567890',
+ *  loginType: 'qr',
+ *  qr: (code) => console.log(code),
+ * });
+ */
+export default class WhatsApp<T extends 'qr' | 'code'> extends EventEmitter<EventMap> {
+    protected readonly options: IWhatsApp<T>;
+    /**
+     * @description
+     * Socket for WhatsApp Web.
+     */
+    protected socket: Baileys.WASocket;
+    /**
+     * @description
+     * Store for WhatsApp Web.
+     */
+    protected store: Store;
+    /**
+     * @description
+     * Mutex, used to prevent concurrent access to the socket.
+     */
+    protected readonly mutex: Mutex;
+    constructor(options: IWhatsApp<T>);
+    /**
+     * @description
+     * Execute a function with the socket and store, means that the function will be executed only when the socket is ready.
+     * @param func Function to execute.
+     * @returns Result of the function.
+     */
+    tick<T extends Noop<[socket: Baileys.WASocket, store: Store], any>>(func: T): Promise<Awaited<ReturnType<T>>>;
+    documents(): Promise<Record<string, any>>;
+    chats(): Promise<Chat[]>;
+    messages(): Promise<Message[]>;
+    /**
+     * @description
+     * Connect to WhatsApp Web.
+     * @returns Promise that resolves to the socket.
+     */
+    protected connect(): Promise<{
+        logger: import("baileys/lib/Utils/logger").ILogger;
+        getOrderDetails: (orderId: string, tokenBase64: string) => Promise<import("baileys/lib/Types").OrderDetails>;
+        getCatalog: ({ jid, limit, cursor }: import("baileys/lib/Types").GetCatalogOptions) => Promise<{
+            products: import("baileys/lib/Types").Product[];
+            nextPageCursor: string | undefined;
+        }>;
+        getCollections: (jid?: string, limit?: number) => Promise<{
+            collections: import("baileys/lib/Types").CatalogCollection[];
+        }>;
+        productCreate: (create: import("baileys/lib/Types").ProductCreate) => Promise<import("baileys/lib/Types").Product>;
+        productDelete: (productIds: string[]) => Promise<{
+            deleted: number;
+        }>;
+        productUpdate: (productId: string, update: import("baileys/lib/Types").ProductUpdate) => Promise<import("baileys/lib/Types").Product>;
+        sendMessageAck: ({ tag, attrs, content }: import("baileys").BinaryNode, errorCode?: number) => Promise<void>;
+        sendRetryRequest: (node: import("baileys").BinaryNode, forceIncludeKeys?: boolean) => Promise<void>;
+        rejectCall: (callId: string, callFrom: string) => Promise<void>;
+        fetchMessageHistory: (count: number, oldestMsgKey: import("baileys/lib/Types").WAMessageKey, oldestMsgTimestamp: number | import("long").default) => Promise<string>;
+        requestPlaceholderResend: (messageKey: import("baileys/lib/Types").WAMessageKey) => Promise<string | undefined>;
+        getPrivacyTokens: (jids: string[]) => Promise<any>;
+        assertSessions: (jids: string[], force: boolean) => Promise<boolean>;
+        relayMessage: (jid: string, message: import("baileys/lib/Types").WAProto.IMessage, { messageId: msgId, participant, additionalAttributes, additionalNodes, useUserDevicesCache, useCachedGroupMetadata, statusJidList }: import("baileys/lib/Types").MessageRelayOptions) => Promise<string>;
+        sendReceipt: (jid: string, participant: string | undefined, messageIds: string[], type: import("baileys/lib/Types").MessageReceiptType) => Promise<void>;
+        sendReceipts: (keys: import("baileys/lib/Types").WAMessageKey[], type: import("baileys/lib/Types").MessageReceiptType) => Promise<void>;
+        readMessages: (keys: import("baileys/lib/Types").WAMessageKey[]) => Promise<void>;
+        refreshMediaConn: (forceGet?: boolean) => Promise<import("baileys/lib/Types").MediaConnInfo>;
+        waUploadToServer: import("baileys/lib/Types").WAMediaUploadFunction;
+        fetchPrivacySettings: (force?: boolean) => Promise<{
+            [_: string]: string;
+        }>;
+        sendPeerDataOperationMessage: (pdoMessage: import("baileys/lib/Types").WAProto.Message.IPeerDataOperationRequestMessage) => Promise<string>;
+        createParticipantNodes: (jids: string[], message: import("baileys/lib/Types").WAProto.IMessage, extraAttrs?: import("baileys").BinaryNode["attrs"]) => Promise<{
+            nodes: import("baileys").BinaryNode[];
+            shouldIncludeDeviceIdentity: boolean;
+        }>;
+        getUSyncDevices: (jids: string[], useCache: boolean, ignoreZeroDevices: boolean) => Promise<import("baileys").JidWithDevice[]>;
+        updateMediaMessage: (message: import("baileys/lib/Types").WAProto.IWebMessageInfo) => Promise<import("baileys/lib/Types").WAProto.IWebMessageInfo>;
+        sendMessage: (jid: string, content: import("baileys/lib/Types").AnyMessageContent, options?: import("baileys/lib/Types").MiscMessageGenerationOptions) => Promise<import("baileys/lib/Types").WAProto.WebMessageInfo | undefined>;
+        groupMetadata: (jid: string) => Promise<import("baileys/lib/Types").GroupMetadata>;
+        groupCreate: (subject: string, participants: string[]) => Promise<import("baileys/lib/Types").GroupMetadata>;
+        groupLeave: (id: string) => Promise<void>;
+        groupUpdateSubject: (jid: string, subject: string) => Promise<void>;
+        groupRequestParticipantsList: (jid: string) => Promise<{
+            [key: string]: string;
+        }[]>;
+        groupRequestParticipantsUpdate: (jid: string, participants: string[], action: "approve" | "reject") => Promise<{
+            status: string;
+            jid: string;
+        }[]>;
+        groupParticipantsUpdate: (jid: string, participants: string[], action: import("baileys/lib/Types").ParticipantAction) => Promise<{
+            status: string;
+            jid: string;
+            content: import("baileys").BinaryNode;
+        }[]>;
+        groupUpdateDescription: (jid: string, description?: string) => Promise<void>;
+        groupInviteCode: (jid: string) => Promise<string | undefined>;
+        groupRevokeInvite: (jid: string) => Promise<string | undefined>;
+        groupAcceptInvite: (code: string) => Promise<string | undefined>;
+        groupRevokeInviteV4: (groupJid: string, invitedJid: string) => Promise<boolean>;
+        groupAcceptInviteV4: (key: string | import("baileys/lib/Types").WAProto.IMessageKey, inviteMessage: import("baileys/lib/Types").WAProto.Message.IGroupInviteMessage) => Promise<any>;
+        groupGetInviteInfo: (code: string) => Promise<import("baileys/lib/Types").GroupMetadata>;
+        groupToggleEphemeral: (jid: string, ephemeralExpiration: number) => Promise<void>;
+        groupSettingUpdate: (jid: string, setting: "announcement" | "not_announcement" | "locked" | "unlocked") => Promise<void>;
+        groupMemberAddMode: (jid: string, mode: "admin_add" | "all_member_add") => Promise<void>;
+        groupJoinApprovalMode: (jid: string, mode: "on" | "off") => Promise<void>;
+        groupFetchAllParticipating: () => Promise<{
+            [_: string]: import("baileys/lib/Types").GroupMetadata;
+        }>;
+        getBotListV2: () => Promise<import("baileys/lib/Types").BotListInfo[]>;
+        processingMutex: {
+            mutex<T_1>(code: () => Promise<T_1> | T_1): Promise<T_1>;
+        };
+        upsertMessage: (msg: import("baileys/lib/Types").WAProto.IWebMessageInfo, type: import("baileys/lib/Types").MessageUpsertType) => Promise<void>;
+        appPatch: (patchCreate: import("baileys/lib/Types").WAPatchCreate) => Promise<void>;
+        sendPresenceUpdate: (type: import("baileys/lib/Types").WAPresence, toJid?: string) => Promise<void>;
+        presenceSubscribe: (toJid: string, tcToken?: Buffer) => Promise<void>;
+        profilePictureUrl: (jid: string, type?: "preview" | "image", timeoutMs?: number) => Promise<string | undefined>;
+        onWhatsApp: (...jids: string[]) => Promise<{
+            jid: string;
+            exists: unknown;
+            lid: unknown;
+        }[] | undefined>;
+        fetchBlocklist: () => Promise<string[]>;
+        fetchStatus: (...jids: string[]) => Promise<import("baileys").USyncQueryResultList[] | undefined>;
+        fetchDisappearingDuration: (...jids: string[]) => Promise<import("baileys").USyncQueryResultList[] | undefined>;
+        updateProfilePicture: (jid: string, content: import("baileys/lib/Types").WAMediaUpload) => Promise<void>;
+        removeProfilePicture: (jid: string) => Promise<void>;
+        updateProfileStatus: (status: string) => Promise<void>;
+        updateProfileName: (name: string) => Promise<void>;
+        updateBlockStatus: (jid: string, action: "block" | "unblock") => Promise<void>;
+        updateCallPrivacy: (value: import("baileys/lib/Types").WAPrivacyCallValue) => Promise<void>;
+        updateMessagesPrivacy: (value: import("baileys/lib/Types").WAPrivacyMessagesValue) => Promise<void>;
+        updateLastSeenPrivacy: (value: import("baileys/lib/Types").WAPrivacyValue) => Promise<void>;
+        updateOnlinePrivacy: (value: import("baileys/lib/Types").WAPrivacyOnlineValue) => Promise<void>;
+        updateProfilePicturePrivacy: (value: import("baileys/lib/Types").WAPrivacyValue) => Promise<void>;
+        updateStatusPrivacy: (value: import("baileys/lib/Types").WAPrivacyValue) => Promise<void>;
+        updateReadReceiptsPrivacy: (value: import("baileys/lib/Types").WAReadReceiptsValue) => Promise<void>;
+        updateGroupsAddPrivacy: (value: import("baileys/lib/Types").WAPrivacyGroupAddValue) => Promise<void>;
+        updateDefaultDisappearingMode: (duration: number) => Promise<void>;
+        getBusinessProfile: (jid: string) => Promise<import("baileys/lib/Types").WABusinessProfile | void>;
+        resyncAppState: (collections: readonly ("critical_block" | "critical_unblock_low" | "regular_high" | "regular_low" | "regular")[], isInitialSync: boolean) => Promise<void>;
+        chatModify: (mod: import("baileys/lib/Types").ChatModification, jid: string) => Promise<void>;
+        cleanDirtyBits: (type: "account_sync" | "groups", fromTimestamp?: number | string) => Promise<void>;
+        addLabel: (jid: string, labels: import("baileys/lib/Types/Label").LabelActionBody) => Promise<void>;
+        addChatLabel: (jid: string, labelId: string) => Promise<void>;
+        removeChatLabel: (jid: string, labelId: string) => Promise<void>;
+        addMessageLabel: (jid: string, messageId: string, labelId: string) => Promise<void>;
+        removeMessageLabel: (jid: string, messageId: string, labelId: string) => Promise<void>;
+        star: (jid: string, messages: {
+            id: string;
+            fromMe?: boolean;
+        }[], star: boolean) => Promise<void>;
+        executeUSyncQuery: (usyncQuery: import("baileys").USyncQuery) => Promise<import("baileys").USyncQueryResult | undefined>;
+        type: "md";
+        ws: import("baileys/lib/Socket/Client").WebSocketClient;
+        ev: import("baileys/lib/Types").BaileysEventEmitter & {
+            process(handler: (events: Partial<import("baileys/lib/Types").BaileysEventMap>) => void | Promise<void>): (() => void);
+            buffer(): void;
+            createBufferedFunction<A extends any[], T_1>(work: (...args: A) => Promise<T_1>): ((...args: A) => Promise<T_1>);
+            flush(force?: boolean): boolean;
+            isBuffering(): boolean;
+        };
+        authState: {
+            creds: import("baileys/lib/Types").AuthenticationCreds;
+            keys: import("baileys/lib/Types").SignalKeyStoreWithTransaction;
+        };
+        signalRepository: import("baileys/lib/Types").SignalRepository;
+        user: import("baileys/lib/Types").Contact | undefined;
+        generateMessageTag: () => string;
+        query: (node: import("baileys").BinaryNode, timeoutMs?: number) => Promise<any>;
+        waitForMessage: <T_1>(msgId: string, timeoutMs?: number | undefined) => Promise<any>;
+        waitForSocketOpen: () => Promise<void>;
+        sendRawMessage: (data: Uint8Array | Buffer) => Promise<void>;
+        sendNode: (frame: import("baileys").BinaryNode) => Promise<void>;
+        logout: (msg?: string) => Promise<void>;
+        end: (error: Error | undefined) => void;
+        onUnexpectedError: (err: Error | import("@hapi/boom").Boom, msg: string) => void;
+        uploadPreKeys: (count?: number) => Promise<void>;
+        uploadPreKeysToServerIfRequired: () => Promise<void>;
+        requestPairingCode: (phoneNumber: string) => Promise<string>;
+        waitForConnectionUpdate: (check: (u: Partial<import("baileys/lib/Types").ConnectionState>) => Promise<boolean | undefined>, timeoutMs?: number) => Promise<void>;
+        sendWAMBuffer: (wamBuffer: Buffer) => Promise<any>;
+    }>;
+}
+export {};

package/build/index.js

@@ -0,0 +1,2 @@
+"use strict";var B=Object.create;var l=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var A=Object.getPrototypeOf,W=Object.prototype.hasOwnProperty;var x=(o,r)=>{for(var t in r)l(o,t,{get:r[t],enumerable:!0})},y=(o,r,t,i)=>{if(r&&typeof r=="object"||typeof r=="function")for(let s of C(r))!W.call(o,s)&&s!==t&&l(o,s,{get:()=>r[s],enumerable:!(i=M(r,s))||i.enumerable});return o};var p=(o,r,t)=>(t=o!=null?B(A(o)):{},y(r||!o||!o.__esModule?l(t,"default",{value:o,enumerable:!0}):t,o)),P=o=>y(l({},"__esModule",{value:!0}),o);var q={};x(q,{default:()=>T});module.exports=P(q);var h=require("@arcaelas/utils"),w=require("async-mutex"),m=p(require("baileys")),f=p(require("node:events")),u=p(require("./model/chat")),g=p(require("./model/message")),k=p(require("./static/Store")),S=p(require("./static/useCache"));class T extends f.default{constructor(t){super({captureRejections:!0});this.options=t;this.store=new Map;this.mutex=new w.Mutex;this.on("error",i=>{this.listenerCount("error")===1&&console.error(i)}),this.store=new k.default(this.options.store??new Map),this.connect()}async tick(t){return this.mutex.acquire().then(()=>t(this.socket,this.store))}async documents(){return await this.tick(async(t,i)=>{const s={};for await(const n of i.document.values())s[n.key]=n.value;return s})}async chats(){return await this.tick(async(t,i)=>{const s=[];for await(const n of i.chat.values())s.push(new u.default(this,n));return s})}async messages(){return await this.tick(async(t,i)=>{const s=[];for await(const n of i.message.values())s.push(new g.default(this,n));return s})}async connect(){const t=(0,h.promify)(),{state:i,save:s}=await(0,S.default)(this.store),{version:n}=await m.fetchLatestBaileysVersion();if(this.socket=m.makeWASocket({version:n,syncFullHistory:!0,browser:m.Browsers.macOS("Descktop"),auth:{creds:i.creds,keys:m.makeCacheableSignalKeyStore(i.keys)},getMessage:async a=>{const e=await this.store.message.get(a.id);return e?e.message:void 0}}),this.socket.ev.process(async a=>{if(a["creds.update"]&&await s(),a["connection.update"]){const{connection:e,lastDisconnect:c}=a["connection.update"];if(e==="open")t.resolve(this.socket);else if(e==="close"&&c?.error?.output?.statusCode!==m.DisconnectReason.loggedOut){t.resolve(await this.connect());return}}await Promise.allSettled([].concat(a["messaging-history.set"]?.chats||[],a["chats.upsert"]||[]).map(async e=>{await this.store.chat.set(e),this.emit("chat:created",new u.default(this,e))})),await Promise.allSettled([].concat(a["chats.update"]||[]).map(async e=>{const c=await this.store.chat.get(e.id);if(c!==null){const d=(0,h.merge)(c,e);await this.store.chat.set(d),this.emit("chat:updated",new u.default(this,d))}}));for(const e of a["chats.delete"]??[])await this.store.chat.delete(e),this.emit("chat:deleted",e);await Promise.allSettled([].concat(a["messages.upsert"]?.messages||[]).map(async e=>{await this.store.message.set(e),this.emit("message:created",new g.default(this,e))})),await Promise.allSettled([].concat(a["messages.update"]||[]).map(async e=>{const c=await this.store.message.get(e.key.id);if(c!==null){const d=(0,h.merge)(c,e);await this.store.message.set(d),this.emit("message:updated",new g.default(this,d))}}))}),await this.socket.waitForSocketOpen(),await(0,h.sleep)(3e3),this.socket.authState.creds.registered)t.resolve(this.socket);else if(this.options.loginType==="code")await this.options.code(await this.socket.requestPairingCode(this.options.phone));else if(this.options.loginType==="qr"){const a=(0,h.promify)(),e=setTimeout(()=>a.reject("QR Timeout"),6e4);this.socket.ev.on("connection.update",async({qr:c})=>{if(c){clearTimeout(e);try{await this.options.qr(c),a.resolve(c)}catch(d){a.reject(d)}}}),await a}return t}}
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["import { merge, Noop, promify, sleep } from '@arcaelas/utils';\nimport { type Boom } from '@hapi/boom';\nimport { Mutex } from 'async-mutex';\nimport * as Baileys from 'baileys';\nimport EventEmitter from 'node:events';\nimport Chat from './model/chat';\nimport Message from './model/message';\nimport Store, { Engine } from './static/Store';\nimport useCache from './static/useCache';\n\ninterface IWhatsApp<T extends 'qr' | 'code'> {\n    phone: string;\n    store?: Engine;\n    loginType: T;\n    qr: T extends 'qr' ? Noop<[QR: string]> : never;\n    code: T extends 'code' ? Noop<[code: string]> : never;\n}\n\ninterface EventMap {\n    error: [error: Error]\n    open: []\n    close: []\n    qr: [qr: string]\n    code: [code: string]\n    'chat:created': [chat: Chat]\n    'chat:updated': [chat: Chat]\n    'chat:deleted': [id: string]\n    'message:created': [message: Message]\n    'message:updated': [message: Message]\n    'message:deleted': [id: string]\n}\n\n/**\n * @description\n * Client for WhatsApp Web.\n * @example\n * const client = new WhatsApp({\n *  phone: '1234567890',\n *  loginType: 'qr',\n *  qr: (code) => console.log(code),\n * });\n */\nexport default class WhatsApp<T extends 'qr' | 'code'> extends EventEmitter<EventMap> {\n    /**\n     * @description\n     * Socket for WhatsApp Web.\n     */\n    protected socket: Baileys.WASocket;\n    /**\n     * @description\n     * Store for WhatsApp Web.\n     */\n    protected store: Store = new Map() as any;\n    /**\n     * @description\n     * Mutex, used to prevent concurrent access to the socket.\n     */\n    protected readonly mutex = new Mutex();\n\n    constructor(protected readonly options: IWhatsApp<T>) {\n        super({ captureRejections: true });\n        this.on('error', (error) => {\n            if (this.listenerCount('error') === 1) {\n                console.error(error);\n            }\n        });\n        this.store = new Store(this.options.store ?? new Map() as any);\n        this.connect();\n    }\n\n    /**\n     * @description\n     * Execute a function with the socket and store, means that the function will be executed only when the socket is ready.\n     * @param func Function to execute.\n     * @returns Result of the function.\n     */\n    async tick<T extends Noop<[socket: Baileys.WASocket, store: Store], any>>(func: T): Promise<Awaited<ReturnType<T>>> {\n        return this.mutex.acquire().then(() => func(this.socket, this.store));\n    }\n\n    async documents(): Promise<Record<string, any>> {\n        return await this.tick(async (_, store) => {\n            const documents: Record<string, any> = {}\n            for await (const document of store.document.values()) {\n                documents[document.key] = document.value;\n            }\n            return documents;\n        });\n    }\n\n    async chats(): Promise<Chat[]> {\n        return await this.tick(async (_, store) => {\n            const chats: Chat[] = [];\n            for await (const chat of store.chat.values()) {\n                chats.push(new Chat(this, chat));\n            }\n            return chats;\n        });\n    }\n\n    async messages(): Promise<Message[]> {\n        return await this.tick(async (_, store) => {\n            const messages: Message[] = [];\n            for await (const message of store.message.values()) {\n                messages.push(new Message(this, message));\n            }\n            return messages;\n        });\n    }\n\n    /**\n     * @description\n     * Connect to WhatsApp Web.\n     * @returns Promise that resolves to the socket.\n     */\n    protected async connect() {\n        const promise = promify<Baileys.WASocket>();\n        const { state, save } = await useCache(this.store);\n        const { version } = await Baileys.fetchLatestBaileysVersion();\n        this.socket = Baileys.makeWASocket({\n            version,\n            syncFullHistory: true,\n            browser: Baileys.Browsers.macOS('Descktop'),\n            auth: {\n                creds: state.creds,\n                keys: Baileys.makeCacheableSignalKeyStore(state.keys),\n            },\n            getMessage: async (key) => {\n                const message = await this.store.message.get(key.id!);\n                return message ? message.message! : undefined;\n            },\n        });\n        this.socket.ev.process(async (event) => {\n            if (event['creds.update']) {\n                await save();\n            }\n            if (event['connection.update']) {\n                const { connection, lastDisconnect } = event['connection.update'];\n                if (connection === 'open') promise.resolve(this.socket);\n                else if (connection === 'close' && (lastDisconnect?.error as Boom)?.output?.statusCode !== Baileys.DisconnectReason.loggedOut) {\n                    promise.resolve(await this.connect());\n                    return\n                }\n            }\n            // prettier-ignore\n            await Promise.allSettled(\n                ([] as Baileys.Chat[])\n                    .concat(event['messaging-history.set']?.chats || [], event['chats.upsert'] || [])\n                    .map(async chat => {\n                        await this.store.chat.set(chat);\n                        this.emit('chat:created', new Chat(this, chat));\n                    })\n            );\n            // prettier-ignore\n            await Promise.allSettled(\n                ([] as Baileys.ChatUpdate[])\n                    .concat(event['chats.update'] || [])\n                    .map(async update => {\n                        const payload = await this.store.chat.get(update.id!);\n                        if (payload !== null) {\n                            const chat = merge(payload, update) as Baileys.Chat;\n                            await this.store.chat.set(chat);\n                            this.emit('chat:updated', new Chat(this, chat));\n                        }\n                    })\n            );\n            for (const key of (event['chats.delete'] ?? []) as string[]) {\n                await this.store.chat.delete(key);\n                this.emit('chat:deleted', key);\n            }\n            // prettier-ignore\n            await Promise.allSettled(\n                ([] as Baileys.WAMessage[])\n                    .concat(event['messages.upsert']?.messages || [])\n                    .map(async message => {\n                        await this.store.message.set(message);\n                        this.emit('message:created', new Message(this, message));\n                    })\n            );\n            // prettier-ignore\n            await Promise.allSettled(\n                ([] as Baileys.WAMessageUpdate[])\n                    .concat(event['messages.update'] || [])\n                    .map(async message => {\n                        const payload = await this.store.message.get(message.key.id!);\n                        if (payload !== null) {\n                            const chat = merge(payload, message) as Baileys.WAProto.WebMessageInfo;\n                            await this.store.message.set(chat);\n                            this.emit('message:updated', new Message(this, chat));\n                        }\n                    })\n            );\n            // TODO: Handle messages.delete\n        })\n\n        await this.socket.waitForSocketOpen();\n        await sleep(3000);\n\n        if (this.socket.authState.creds.registered) {\n            promise.resolve(this.socket);\n        } else if (this.options.loginType === 'code') {\n            await this.options.code(\n                await this.socket.requestPairingCode(this.options.phone)\n            );\n        } else if (this.options.loginType === 'qr') {\n            const _qr = promify<string>();\n            const timeout = setTimeout(() => _qr.reject('QR Timeout'), 60000);\n            this.socket.ev.on('connection.update', async ({ qr }) => {\n                if (qr) {\n                    clearTimeout(timeout);\n                    try {\n                        await this.options.qr(qr);\n                        _qr.resolve(qr);\n                    } catch (error) {\n                        _qr.reject(error);\n                    }\n                }\n            });\n            await _qr;\n        }\n        return promise;\n    }\n}"],
+  "mappings": "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",
+  "names": ["src_exports", "__export", "WhatsApp", "__toCommonJS", "import_utils", "import_async_mutex", "Baileys", "import_node_events", "import_chat", "import_message", "import_Store", "import_useCache", "EventEmitter", "options", "error", "Store", "func", "_", "store", "documents", "document", "chats", "chat", "Chat", "messages", "message", "Message", "promise", "state", "save", "useCache", "version", "key", "event", "connection", "lastDisconnect", "update", "payload", "_qr", "timeout", "qr"]
+}

package/build/model/base.d.ts

@@ -0,0 +1,13 @@
+import { Noop } from '@arcaelas/utils';
+import WhatsApp from 'src';
+type Serialize<T> = {
+    [K in keyof T as T[K] extends Noop ? never : K]: T[K];
+};
+export default class Base<T> {
+    protected readonly $: WhatsApp<'code' | 'qr'>;
+    protected readonly _: Serialize<T>;
+    constructor($: WhatsApp<'code' | 'qr'>, _: Serialize<T>);
+    toJSON(): any;
+    toString(): string;
+}
+export {};