elynn-baileys 1.0.1

package/lib/Utils/text-sticker.js

@@ -0,0 +1,149 @@
+/**
+ * elynn@Changes --- Text Sticker generator.
+ *
+ * Implements WA's "Text Stickers" feature, announced officially on
+ * blog.whatsapp.com (Jan 7 2026, "Level Up Your WhatsApp Group Chats With
+ * New Member Tags, Text Stickers, and More"):
+ *   "you can now turn any word into a sticker by typing your text into
+ *    Sticker Search."
+ *
+ * IMPORTANT — protocol note: WA's "Sticker Search" is a client-side / app
+ * UI feature (local rendering + Meta's closed sticker search index). There
+ * is no dedicated wire-protocol message type for it — the result a user
+ * sends is just a normal stickerMessage (image/webp), identical to what
+ * Baileys already sends via the sticker pack pipeline in messages.js.
+ *
+ * This util renders the *client-side* part ourselves (text -> styled
+ * image -> webp), so elynn-baileys can produce the same end result
+ * (a valid stickerMessage) without depending on WA's internal sticker
+ * search service, which isn't reachable over the protocol Baileys speaks.
+ *
+ * Output of `renderTextSticker()` is a webp Buffer ready to be passed as
+ * the `sticker` field of `sock.sendMessage(jid, { sticker: buffer })`,
+ * exactly like any other sticker in this library.
+ */
+import { Boom } from '@hapi/boom';
+import { getImageProcessingLibrary } from './messages-media.js';
+
+const MAX_TEXT_LENGTH = 60;
+const STICKER_SIZE = 512;
+
+const DEFAULT_STYLE = {
+    backgroundColor: '#FFFFFF',
+    textColor: '#000000',
+    fontFamily: 'sans-serif',
+    fontWeight: 'bold',
+    padding: 48,
+};
+
+/**
+ * Renders a single word/phrase into a square WhatsApp-compatible sticker (webp).
+ *
+ * @param {string} text - The text to render (e.g. a word typed into "Sticker Search").
+ * @param {object} [options]
+ * @param {string} [options.backgroundColor='#FFFFFF'] - CSS color for the sticker background.
+ * @param {string} [options.textColor='#000000'] - CSS color for the text.
+ * @param {string} [options.fontFamily='sans-serif'] - Font family available on the system/canvas.
+ * @param {string} [options.fontWeight='bold'] - CSS font-weight.
+ * @returns {Promise<Buffer>} webp-encoded sticker buffer, ready for sock.sendMessage(jid, { sticker: buffer }).
+ */
+export async function renderTextSticker(text, options = {}) {
+    if (typeof text !== 'string' || !text.trim()) {
+        throw new Boom('text is required to render a text sticker', { statusCode: 400 });
+    }
+    const trimmed = text.trim();
+    if (trimmed.length > MAX_TEXT_LENGTH) {
+        throw new Boom(`text exceeds max length of ${MAX_TEXT_LENGTH} characters`, { statusCode: 400 });
+    }
+
+    const style = { ...DEFAULT_STYLE, ...options };
+
+    // canvas is an existing dependency of this package (see package.json).
+    let canvasLib;
+    try {
+        canvasLib = await import('canvas');
+    } catch {
+        throw new Boom('The "canvas" package is required to render text stickers but is not installed.', { statusCode: 500 });
+    }
+    const { createCanvas } = canvasLib;
+
+    const canvas = createCanvas(STICKER_SIZE, STICKER_SIZE);
+    const ctx = canvas.getContext('2d');
+
+    // Background
+    ctx.fillStyle = style.backgroundColor;
+    ctx.fillRect(0, 0, STICKER_SIZE, STICKER_SIZE);
+
+    // Auto-fit font size so the text (possibly multi-line) fits within the
+    // sticker bounds, shrinking from a large starting size.
+    const maxWidth = STICKER_SIZE - style.padding * 2;
+    const maxHeight = STICKER_SIZE - style.padding * 2;
+    let fontSize = 160;
+    let lines = [trimmed];
+
+    const wrapText = (size) => {
+        ctx.font = `${style.fontWeight} ${size}px ${style.fontFamily}`;
+        const words = trimmed.split(/\s+/);
+        const wrapped = [];
+        let current = '';
+        for (const word of words) {
+            const test = current ? `${current} ${word}` : word;
+            if (ctx.measureText(test).width <= maxWidth || !current) {
+                current = test;
+            } else {
+                wrapped.push(current);
+                current = word;
+            }
+        }
+        if (current) wrapped.push(current);
+        return wrapped;
+    };
+
+    while (fontSize > 24) {
+        lines = wrapText(fontSize);
+        const lineHeight = fontSize * 1.15;
+        const totalHeight = lineHeight * lines.length;
+        const widestLine = Math.max(...lines.map(l => ctx.measureText(l).width));
+        if (totalHeight <= maxHeight && widestLine <= maxWidth) {
+            break;
+        }
+        fontSize -= 4;
+    }
+
+    ctx.font = `${style.fontWeight} ${fontSize}px ${style.fontFamily}`;
+    ctx.fillStyle = style.textColor;
+    ctx.textAlign = 'center';
+    ctx.textBaseline = 'middle';
+
+    const lineHeight = fontSize * 1.15;
+    const startY = STICKER_SIZE / 2 - (lineHeight * (lines.length - 1)) / 2;
+    lines.forEach((line, i) => {
+        ctx.fillText(line, STICKER_SIZE / 2, startY + i * lineHeight);
+    });
+
+    const pngBuffer = canvas.toBuffer('image/png');
+
+    // Convert PNG -> WebP using the same image-processing pipeline the rest
+    // of the library already relies on (sharp / @napi-rs/image), so output
+    // is guaranteed to be a valid WA sticker (webp, <=1MB, 512x512).
+    const lib = await getImageProcessingLibrary();
+    let webpBuffer;
+    if ('sharp' in lib && lib.sharp?.default) {
+        webpBuffer = await lib.sharp.default(pngBuffer)
+            .resize(STICKER_SIZE, STICKER_SIZE, { fit: 'inside' })
+            .webp({ quality: 90 })
+            .toBuffer();
+    } else if ('image' in lib && lib.image?.Transformer) {
+        webpBuffer = await new lib.image.Transformer(pngBuffer)
+            .resize(STICKER_SIZE, STICKER_SIZE)
+            .webp(90);
+    } else {
+        throw new Boom('No image processing library (sharp or @napi-rs/image) available to encode the sticker as WebP.', { statusCode: 500 });
+    }
+
+    if (webpBuffer.length > 1024 * 1024) {
+        throw new Boom('Generated text sticker exceeds the 1MB WhatsApp sticker size limit.', { statusCode: 400 });
+    }
+
+    return webpBuffer;
+}

package/lib/Utils/use-multi-file-auth-state.d.ts

@@ -0,0 +1,11 @@
+export function useMultiFileAuthState(folder: any): Promise<{
+    state: {
+        creds: any;
+        keys: {
+            get: (type: any, ids: any) => Promise<{}>;
+            set: (data: any) => Promise<void>;
+        };
+    };
+    saveCreds: () => Promise<any>;
+}>;
+//# sourceMappingURL=use-multi-file-auth-state.d.ts.map

package/lib/Utils/use-multi-file-auth-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-multi-file-auth-state.d.ts","sourceRoot":"","sources":["../../src/Utils/use-multi-file-auth-state.js"],"names":[],"mappings":"AA2BO;;;;;;;;;GA4FN"}

package/lib/Utils/use-multi-file-auth-state.js

@@ -0,0 +1,121 @@
+import { Mutex } from 'async-mutex';
+import { mkdir, readFile, stat, unlink, writeFile } from 'fs/promises';
+import { join } from 'path';
+import { proto } from '../../WAProto/index.js';
+import { initAuthCreds } from './auth-utils.js';
+import { BufferJSON } from './generics.js';
+// We need to lock files due to the fact that we are using async functions to read and write files
+// https://github.com/WhiskeySockets/Baileys/issues/794
+// https://github.com/nodejs/node/issues/26338
+// Use a Map to store mutexes for each file path
+const fileLocks = new Map();
+// Get or create a mutex for a specific file path
+const getFileLock = (path) => {
+    let mutex = fileLocks.get(path);
+    if (!mutex) {
+        mutex = new Mutex();
+        fileLocks.set(path, mutex);
+    }
+    return mutex;
+};
+/**
+ * stores the full authentication state in a single folder.
+ * Far more efficient than singlefileauthstate
+ *
+ * Again, I wouldn't endorse this for any production level use other than perhaps a bot.
+ * Would recommend writing an auth state for use with a proper SQL or No-SQL DB
+ * */
+export const useMultiFileAuthState = async (folder) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const writeData = async (data, file) => {
+        const filePath = join(folder, fixFileName(file));
+        const mutex = getFileLock(filePath);
+        return mutex.acquire().then(async (release) => {
+            try {
+                await writeFile(filePath, JSON.stringify(data, BufferJSON.replacer));
+            }
+            finally {
+                release();
+            }
+        });
+    };
+    const readData = async (file) => {
+        try {
+            const filePath = join(folder, fixFileName(file));
+            const mutex = getFileLock(filePath);
+            return await mutex.acquire().then(async (release) => {
+                try {
+                    const data = await readFile(filePath, { encoding: 'utf-8' });
+                    return JSON.parse(data, BufferJSON.reviver);
+                }
+                finally {
+                    release();
+                }
+            });
+        }
+        catch (error) {
+            return null;
+        }
+    };
+    const removeData = async (file) => {
+        try {
+            const filePath = join(folder, fixFileName(file));
+            const mutex = getFileLock(filePath);
+            return mutex.acquire().then(async (release) => {
+                try {
+                    await unlink(filePath);
+                }
+                catch {
+                }
+                finally {
+                    release();
+                }
+            });
+        }
+        catch { }
+    };
+    const folderInfo = await stat(folder).catch(() => { });
+    if (folderInfo) {
+        if (!folderInfo.isDirectory()) {
+            throw new Error(`found something that is not a directory at ${folder}, either delete it or specify a different location`);
+        }
+    }
+    else {
+        await mkdir(folder, { recursive: true });
+    }
+    const fixFileName = (file) => file?.replace(/\//g, '__')?.replace(/:/g, '-');
+    const creds = (await readData('creds.json')) || initAuthCreds();
+    return {
+        state: {
+            creds,
+            keys: {
+                get: async (type, ids) => {
+                    const data = {};
+                    await Promise.all(ids.map(async (id) => {
+                        let value = await readData(`${type}-${id}.json`);
+                        if (type === 'app-state-sync-key' && value) {
+                            value = proto.Message.AppStateSyncKeyData.fromObject(value);
+                        }
+                        data[id] = value;
+                    }));
+                    return data;
+                },
+                set: async (data) => {
+                    const tasks = [];
+                    for (const category in data) {
+                        for (const id in data[category]) {
+                            const value = data[category][id];
+                            const file = `${category}-${id}.json`;
+                            tasks.push(value ? writeData(value, file) : removeData(file));
+                        }
+                    }
+                    await Promise.all(tasks);
+                }
+            }
+        },
+        saveCreds: async () => {
+            return writeData(creds, 'creds.json');
+        }
+    };
+};
+//# sourceMappingURL=use-multi-file-auth-state.js.map

package/lib/Utils/use-multi-file-auth-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-multi-file-auth-state.js","sourceRoot":"","sources":["../../src/Utils/use-multi-file-auth-state.js"],"names":[],"mappings":"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"}

package/lib/Utils/use-single-file-auth-state.d.ts

@@ -0,0 +1,11 @@
+export function useSingleFileAuthState(fileName: any): Promise<{
+    state: {
+        creds: any;
+        keys: {
+            get: (type: any, ids: any) => {};
+            set: (data: any) => void;
+        };
+    };
+    saveCreds: () => void;
+}>;
+//# sourceMappingURL=use-single-file-auth-state.d.ts.map

package/lib/Utils/use-single-file-auth-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-single-file-auth-state.d.ts","sourceRoot":"","sources":["../../src/Utils/use-single-file-auth-state.js"],"names":[],"mappings":"AAUO;;;;;;;;;GA+FN"}

package/lib/Utils/use-single-file-auth-state.js

@@ -0,0 +1,109 @@
+import { readFile, rename, stat, writeFile } from 'fs/promises';
+import { DEFAULT_CACHE_TTLS } from '../Defaults/index.js';
+import { proto } from '../../WAProto/index.js';
+import { initAuthCreds } from './auth-utils.js';
+import { BufferJSON } from './generics.js';
+import { LRUCache } from 'lru-cache';
+import { Mutex } from 'async-mutex';
+// Lia@Changes 25-03-26 --- Add useSingleFileAuthState with integrated cache
+const FLUSH_TIMEOUT_MS = 3000;
+// Lia@Changes 22-04-26 --- Enhanced useSingleFileAuthState with LRUCache
+export const useSingleFileAuthState = async (fileName) => {
+    const cache = new LRUCache({
+        max: 20000,
+        ttl: 1000 * DEFAULT_CACHE_TTLS.SIGNAL_STORE,
+        updateAgeOnGet: false,
+        updateAgeOnHas: false,
+        ttlAutopurge: true
+    });
+    // Lia@Changes 26-04-26 --- Add mutex for prevent race condition
+    const mutex = new Mutex();
+    let fileData = {};
+    let isLoaded = false;
+    let flushTimeout = null;
+    const loadKey = async () => {
+        return await mutex.runExclusive(async () => {
+            if (isLoaded)
+                return;
+            try {
+                const data = JSON.parse(await readFile(fileName, 'utf-8'), BufferJSON.reviver);
+                fileData = data || {};
+                for (const [keyName, value] of Object.entries(fileData)) {
+                    cache.set(keyName, value);
+                }
+            }
+            catch {
+                fileData = {};
+            }
+            isLoaded = true;
+        });
+    };
+    const flushKey = () => {
+        if (flushTimeout)
+            return;
+        flushTimeout = setTimeout(async () => {
+            flushTimeout = null;
+            await mutex.runExclusive(async () => {
+                try {
+                    const tempFile = fileName + '.temp';
+                    await writeFile(tempFile, JSON.stringify(fileData, BufferJSON.replacer));
+                    await rename(tempFile, fileName);
+                }
+                catch { }
+            });
+        }, FLUSH_TIMEOUT_MS);
+    };
+    const writeKey = (keyName, value) => {
+        cache.set(keyName, value);
+        fileData[keyName] = value;
+        flushKey();
+    };
+    const removeKey = (keyName) => {
+        cache.delete(keyName);
+        delete fileData[keyName];
+        flushKey();
+    };
+    const fileInfo = await stat(fileName).catch(() => null);
+    if (!fileInfo) {
+        await writeFile(fileName, '{}');
+    }
+    else if (!fileInfo.isFile()) {
+        throw new Error(`found something that is not a file at ${fileName}, either delete it or specify a different location`);
+    }
+    await loadKey();
+    const creds = fileData['creds'] || initAuthCreds();
+    return {
+        state: {
+            creds,
+            keys: {
+                get: (type, ids) => {
+                    const data = {};
+                    for (const id of ids) {
+                        const keyName = type + id;
+                        let value = cache.get(keyName);
+                        if (value === undefined && fileData[keyName] !== undefined) {
+                            value = fileData[keyName];
+                            cache.set(keyName, value);
+                        }
+                        if (type === 'app-state-sync-key' && value) {
+                            value = proto.Message.AppStateSyncKeyData.fromObject(value);
+                        }
+                        data[id] = value;
+                    }
+                    return data;
+                },
+                set: (data) => {
+                    for (const category in data) {
+                        for (const id in data[category]) {
+                            const keyName = category + id;
+                            const value = data[category][id];
+                            value ? writeKey(keyName, value) : removeKey(keyName);
+                        }
+                    }
+                }
+            }
+        },
+        saveCreds: () => writeKey('creds', creds)
+    };
+};
+//# sourceMappingURL=use-single-file-auth-state.js.map

package/lib/Utils/use-single-file-auth-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-single-file-auth-state.js","sourceRoot":"","sources":["../../src/Utils/use-single-file-auth-state.js"],"names":[],"mappings":"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"}

package/lib/Utils/use-sqlite-auth-state.d.ts

@@ -0,0 +1,11 @@
+export function useSqliteAuthState(opts: any): Promise<{
+    state: {
+        creds: any;
+        keys: {
+            get: (type: any, ids: any) => Promise<{}>;
+            set: (data: any) => Promise<void>;
+        };
+    };
+    saveCreds: () => Promise<void>;
+}>;
+//# sourceMappingURL=use-sqlite-auth-state.d.ts.map

package/lib/Utils/use-sqlite-auth-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sqlite-auth-state.d.ts","sourceRoot":"","sources":["../../src/Utils/use-sqlite-auth-state.js"],"names":[],"mappings":"AAgCA;;;;;;;;;GA2EC"}

package/lib/Utils/use-sqlite-auth-state.js

@@ -0,0 +1,109 @@
+import { mkdir, readFile, stat, unlink, writeFile } from 'fs/promises';
+import { join } from 'path';
+import { proto } from '../../WAProto/index.js';
+import { initAuthCreds } from './auth-utils.js';
+import { BufferJSON } from './generics.js';
+async function loadBetterSqlite3() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = (await import('better-sqlite3'));
+        return mod.default ?? mod;
+    }
+    catch (err) {
+        const helpful = new Error('`better-sqlite3` is required for `useSqliteAuthState`. Install it as a peer dependency: `npm install better-sqlite3` (or `yarn add better-sqlite3`).');
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        helpful.cause = err;
+        throw helpful;
+    }
+}
+const CREDS_ROW_KEY = '__creds__';
+const CREATE_SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS creds (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+CREATE TABLE IF NOT EXISTS signal_keys (
+  type TEXT NOT NULL,
+  id TEXT NOT NULL,
+  value TEXT NOT NULL,
+  PRIMARY KEY (type, id)
+);
+CREATE INDEX IF NOT EXISTS signal_keys_type_idx ON signal_keys(type);
+`;
+export async function useSqliteAuthState(opts) {
+    let db;
+    if (opts.database) {
+        db = opts.database;
+    }
+    else {
+        const Database = await loadBetterSqlite3();
+        db = new Database(opts.dbPath);
+    }
+    // WAL mode allows concurrent reads alongside a single writer; matches
+    // what SQLite recommends for read-heavy workloads with sporadic writes.
+    db.pragma('journal_mode = WAL');
+    db.pragma('synchronous = NORMAL');
+    db.exec(CREATE_SCHEMA_SQL);
+    const stmts = {
+        credsSelect: db.prepare('SELECT value FROM creds WHERE key = ?'),
+        credsUpsert: db.prepare('INSERT INTO creds (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value'),
+        keySelect: db.prepare('SELECT value FROM signal_keys WHERE type = ? AND id = ?'),
+        keyUpsert: db.prepare('INSERT INTO signal_keys (type, id, value) VALUES (?, ?, ?) ON CONFLICT(type, id) DO UPDATE SET value = excluded.value'),
+        keyDelete: db.prepare('DELETE FROM signal_keys WHERE type = ? AND id = ?'),
+        keyListIds: db.prepare('SELECT id FROM signal_keys WHERE type = ?'),
+        keyList: db.prepare('SELECT id, value FROM signal_keys WHERE type = ?'),
+        clearKeys: db.prepare('DELETE FROM signal_keys')
+    };
+    const loadCreds = () => {
+        const row = stmts.credsSelect.get(CREDS_ROW_KEY);
+        if (!row)
+            return initAuthCreds();
+        return JSON.parse(row.value, BufferJSON.reviver);
+    };
+    const persistCreds = (creds) => {
+        stmts.credsUpsert.run(CREDS_ROW_KEY, JSON.stringify(creds, BufferJSON.replacer));
+    };
+    const creds = loadCreds();
+    return {
+        state: {
+            creds,
+            keys: {
+                get: async (type, ids) => {
+                    const data = {};
+                    for (const id of ids) {
+                        const row = stmts.keySelect.get(type, id);
+                        if (row) {
+                            let value = JSON.parse(row.value, BufferJSON.reviver);
+                            if (type === 'app-state-sync-key' && value) {
+                                value = proto.Message.AppStateSyncKeyData.fromObject(value);
+                            }
+                            data[id] = value;
+                        }
+                    }
+                    return data;
+                },
+                set: async (data) => {
+                    const writeTx = db.transaction(() => {
+                        for (const category in data) {
+                            for (const id in data[category]) {
+                                const value = data[category][id];
+                                if (value) {
+                                    const stringified = JSON.stringify(value, BufferJSON.replacer);
+                                    stmts.keyUpsert.run(category, id, stringified);
+                                }
+                                else {
+                                    stmts.keyDelete.run(category, id);
+                                }
+                            }
+                        }
+                    });
+                    writeTx();
+                }
+            }
+        },
+        saveCreds: async () => {
+            persistCreds(creds);
+        }
+    };
+}
+//# sourceMappingURL=use-sqlite-auth-state.js.map

package/lib/Utils/use-sqlite-auth-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sqlite-auth-state.js","sourceRoot":"","sources":["../../src/Utils/use-sqlite-auth-state.js"],"names":[],"mappings":"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"}

package/lib/Utils/validate-connection.d.ts

@@ -0,0 +1,44 @@
+export function generateLoginNode(userJid: any, config: any): proto.ClientPayload;
+export function generateRegistrationNode({ registrationId, signedPreKey, signedIdentityKey }: {
+    registrationId: any;
+    signedPreKey: any;
+    signedIdentityKey: any;
+}, config: any): proto.ClientPayload;
+export function configureSuccessfulPairing(stanza: any, { advSecretKey, signedIdentityKey, signalIdentities }: {
+    advSecretKey: any;
+    signedIdentityKey: any;
+    signalIdentities: any;
+}): {
+    creds: {
+        account: proto.ADVSignedDeviceIdentity;
+        me: {
+            id: any;
+            name: any;
+            lid: any;
+        };
+        signalIdentities: any[];
+        platform: any;
+    };
+    reply: {
+        tag: string;
+        attrs: {
+            to: string;
+            type: string;
+            id: any;
+        };
+        content: {
+            tag: string;
+            attrs: {};
+            content: {
+                tag: string;
+                attrs: {
+                    'key-index': string;
+                };
+                content: any;
+            }[];
+        }[];
+    };
+};
+export function encodeSignedDeviceIdentity(account: any, includeSignatureKey: any): any;
+import { proto } from '../../WAProto/index.js';
+//# sourceMappingURL=validate-connection.d.ts.map

package/lib/Utils/validate-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-connection.d.ts","sourceRoot":"","sources":["../../src/Utils/validate-connection.js"],"names":[],"mappings":"AAmDO,kFAYN;AAMM;;;;qCAkDN;AACM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwEN;AACM,wFAQN;sBAvMqB,wBAAwB"}