@arcaelas/whatsapp 1.2.3 → 2.0.0

package/build/esm/store/driver/RedisEngine.js

@@ -0,0 +1,66 @@
+/**
+ * @file store/driver/RedisEngine.ts
+ * @description Engine de persistencia con Redis
+ */
+/**
+ * @description
+ * Engine de persistencia con Redis.
+ * Recibe una conexión existente de ioredis o redis.
+ *
+ * Redis persistence engine.
+ * Receives an existing ioredis or redis connection.
+ *
+ * @example
+ * import Redis from 'ioredis';
+ * const client = new Redis();
+ * const engine = new RedisEngine(client, 'wa:5491112345678');
+ * await engine.set('contact/123', '{"name":"John"}');
+ */
+export class RedisEngine {
+    constructor(_client, _prefix = 'wa:default') {
+        this._client = _client;
+        this._prefix = _prefix;
+    }
+    /** @description Obtiene un valor por su key. / Retrieves a value by its key. */
+    async get(key) {
+        return this._client.get(`${this._prefix}:${key}`);
+    }
+    /**
+     * @description Guarda o elimina un valor. Si value es null, elimina la key y todas las sub-keys con ese prefijo.
+     * Saves or deletes a value. If value is null, deletes the key and all sub-keys matching the prefix.
+     */
+    async set(key, value) {
+        const full_key = `${this._prefix}:${key}`;
+        if (value) {
+            await this._client.set(full_key, value);
+        }
+        else {
+            await this._client.del(full_key);
+            const pattern = `${full_key}/*`;
+            let cursor = '0';
+            do {
+                const [next, batch] = await this._client.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
+                cursor = next;
+                if (batch.length)
+                    await this._client.del(batch);
+            } while (cursor !== '0');
+        }
+    }
+    /**
+     * @description Lista keys bajo un prefijo.
+     * Lists keys under a prefix.
+     * @note Redis SCAN no garantiza orden. / Redis SCAN does not guarantee order.
+     */
+    async list(prefix, offset = 0, limit = 50) {
+        const pattern = `${this._prefix}:${prefix}*`;
+        const keys = [];
+        let cursor = '0';
+        do {
+            const [next, batch] = await this._client.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
+            cursor = next;
+            keys.push(...batch);
+        } while (cursor !== '0' && keys.length < offset + limit + 100);
+        return keys.map((k) => k.slice(this._prefix.length + 1)).slice(offset, offset + limit);
+    }
+}
+//# sourceMappingURL=RedisEngine.js.map

package/build/esm/store/driver/RedisEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisEngine.js","sourceRoot":"","sources":["../../../../src/store/driver/RedisEngine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,WAAW;IACpB,YAA6B,OAAoB,EAAmB,UAAkB,YAAY;QAArE,YAAO,GAAP,OAAO,CAAa;QAAmB,YAAO,GAAP,OAAO,CAAuB;IAAI,CAAC;IAEvG,gFAAgF;IAChF,KAAK,CAAC,GAAG,CAAC,GAAW;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAoB;QACvC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;QAC1C,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,CAAC;YAChC,IAAI,MAAM,GAAG,GAAG,CAAC;YACjB,GAAG,CAAC;gBACA,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;gBACtF,MAAM,GAAG,IAAI,CAAC;gBACd,IAAI,KAAK,CAAC,MAAM;oBAAE,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACpD,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;QAC7B,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE;QAC7C,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,GAAG,CAAC;QAC7C,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,GAAG,CAAC;YACA,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YACtF,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACxB,CAAC,QAAQ,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,GAAG,EAAE;QAC/D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;IAC3F,CAAC;CACJ"}

package/build/esm/store/engine.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @file store/engine.ts
+ * @description Interface Engine - contrato para proveedores de persistencia key-value
+ */
+/**
+ * @description
+ * Interface que define el contrato para proveedores de persistencia.
+ * Almacena texto (JSON stringified con BufferJSON para binarios).
+ *
+ * Interface that defines the contract for persistence providers.
+ * Stores plain text (JSON stringified with BufferJSON for binaries).
+ *
+ * @example
+ * class CustomEngine implements Engine {
+ *   async get(key: string): Promise<string | null> {
+ *     return localStorage.getItem(key);
+ *   }
+ *
+ *   async set(key: string, value: string | null): Promise<void> {
+ *     if (value === null) localStorage.removeItem(key);
+ *     else localStorage.setItem(key, value);
+ *   }
+ *
+ *   async list(prefix: string, offset?: number, limit?: number): Promise<string[]> {
+ *     return Object.keys(localStorage).filter(k => k.startsWith(prefix));
+ *   }
+ * }
+ */
+export interface Engine {
+    /**
+     * @description Obtiene un valor por su key.
+     * Retrieves a value by its key.
+     * @param key Ruta del documento (ej: 'creds', 'contact/123@s.whatsapp.net').
+     * @returns Texto JSON o null si no existe.
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * @description Guarda o elimina un valor. Si value es null, elimina la key y todas las sub-keys recursivamente.
+     * Saves or deletes a value. If value is null, deletes the key and all sub-keys recursively.
+     * @param key Ruta del documento.
+     * @param value Texto a guardar o null para eliminar recursivamente.
+     */
+    set(key: string, value: string | null): Promise<void>;
+    /**
+     * @description Lista keys bajo un prefijo, ordenados por más reciente.
+     * Lists keys under a prefix, ordered by most recent.
+     * @param prefix Prefijo de búsqueda (ej: 'contact/', 'chat/123/message/').
+     * @param offset Inicio de paginación (default: 0).
+     * @param limit Cantidad máxima (default: 50).
+     * @returns Array de keys.
+     */
+    list(prefix: string, offset?: number, limit?: number): Promise<string[]>;
+}

package/build/esm/store/engine.js

@@ -0,0 +1,6 @@
+/**
+ * @file store/engine.ts
+ * @description Interface Engine - contrato para proveedores de persistencia key-value
+ */
+export {};
+//# sourceMappingURL=engine.js.map

package/build/{store → esm/store}/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/store/engine.ts"],"names":[],"mappings":";AAAA;;;GAGG"}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/store/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/build/esm/store/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file store/index.ts
+ * @description Exportaciones del módulo de persistencia
+ */
+export { FileEngine } from '../store/driver/FileEngine';
+export { RedisEngine } from '../store/driver/RedisEngine';
+export type { RedisClient } from '../store/driver/RedisEngine';
+export type { Engine } from '../store/engine';

package/build/esm/store/index.js

@@ -0,0 +1,7 @@
+/**
+ * @file store/index.ts
+ * @description Exportaciones del módulo de persistencia
+ */
+export { FileEngine } from '../store/driver/FileEngine';
+export { RedisEngine } from '../store/driver/RedisEngine';
+//# sourceMappingURL=index.js.map

package/build/esm/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -1,61 +1,73 @@
 {
-    "license": "ISC",
-    "version": "1.2.3",
-    "name": "@arcaelas/whatsapp",
-    "homepage": "https://github.com/arcaelas/whatsapp",
-    "description": "A small box of tools, which are implemented in different factions of the library.",
-    "keywords": [
-        "whatsapp",
-        "tools",
-        "arcaelas",
-        "arcaelas insiders",
-        "arcaelas-insiders",
-        "javascript"
-    ],
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/arcaelas/whatsapp.git"
-    },
-    "bugs": {
-        "email": "community@arcaelas.com",
-        "url": "https://github.com/arcaelas/whatsapp/issues"
-    },
-    "main": "build/index.js",
-    "files": [
-        "build/",
-        "*.md",
-        "*.json"
-    ],
-    "author": {
-        "name": "Arcaelas Insiders",
-        "email": "comunity@arcaelas.com",
-        "url": "https://github.com/arcaelas"
-    },
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org/"
-    },
-    "scripts": {
-        "build": "tsc && node esbuild.js",
-        "prepublishOnly": "yarn build && npm version patch",
-        "commit": "npm publish --access=public",
-        "postpublish": "rm -rf build"
-    },
-    "devDependencies": {
-        "@types/node": "^25.0.3",
-        "@types/qrcode": "^1.5.6",
-        "esbuild": "^0.17.18",
-        "typescript": "^5.0.4"
-    },
-    "dependencies": {
-        "@arcaelas/dynamite": "^1.0.9",
-        "@arcaelas/utils": "^2.0.5",
-        "@aws-sdk/client-s3": "^3.958.0",
-        "@hapi/boom": "^10.0.1",
-        "baileys": "6.7.18",
-        "node-cache": "^5.1.2",
-        "pino": "^10.1.0",
-        "pino-pretty": "^13.1.3",
-        "qrcode": "^1.5.4"
+  "name": "@arcaelas/whatsapp",
+  "version": "2.0.0",
+  "description": "A small box of tools, which are implemented in different factions of the library.",
+  "license": "ISC",
+  "main": "./build/cjs/index.js",
+  "module": "./build/esm/index.js",
+  "types": "./build/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/esm/index.d.ts",
+      "import": "./build/esm/index.js",
+      "require": "./build/cjs/index.js"
     }
+  },
+  "author": {
+    "name": "Arcaelas Insiders",
+    "email": "comunity@arcaelas.com",
+    "url": "https://github.com/arcaelas"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arcaelas/whatsapp.git"
+  },
+  "bugs": {
+    "email": "community@arcaelas.com",
+    "url": "https://github.com/arcaelas/whatsapp/issues"
+  },
+  "homepage": "https://github.com/arcaelas/whatsapp",
+  "keywords": [
+    "whatsapp",
+    "tools",
+    "arcaelas",
+    "arcaelas insiders",
+    "arcaelas-insiders",
+    "javascript"
+  ],
+  "files": [
+    "build/"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build:esm": "tsc --module ESNext --moduleResolution bundler --outDir build/esm && tsc-alias --outDir build/esm && echo '{\"type\":\"module\"}' > build/esm/package.json",
+    "build:cjs": "tsc --module commonjs --moduleResolution node --outDir build/cjs && tsc-alias --outDir build/cjs && echo '{\"type\":\"commonjs\"}' > build/cjs/package.json",
+    "build": "yarn build:esm && yarn build:cjs",
+    "docs": "mkdocs gh-deploy --force",
+    "lint": "eslint src/ --fix",
+    "release": "npm version minor && yarn build && npm publish --access public",
+    "postpublish": "rm -rf build/"
+  },
+  "dependencies": {
+    "@arcaelas/dynamite": "^1.0.9",
+    "@arcaelas/utils": "^2.0.5",
+    "@hapi/boom": "^10.0.1",
+    "baileys": "7.0.0-rc.9",
+    "pino": "^10.1.0",
+    "pino-pretty": "^13.1.3",
+    "qrcode": "^1.5.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^25.0.3",
+    "@types/qrcode": "^1.5.6",
+    "eslint": "^9.0.0",
+    "prettier": "^3.0.0",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.0.4",
+    "typescript-eslint": "^8.0.0"
+  }
 }