@vielhuber/wahelper 1.5.6 → 1.5.8

package/README.md

@@ -55,6 +55,10 @@ npx wahelper \
     --action "fetch_messages" \
     --limit 42
 
+    # view a single message by id
+    --action "view_message" \
+    --id "ABCDEF1234567890"
+
     # send message to user
     --action "send_user" \
     --number "xxxxxxxxxxxx" \
@@ -79,6 +83,9 @@ $wahelper = new wahelper();
 // fetch messages
 $wahelper->fetchMessages(device: 'xxxxxxxxxxxx', limit: 42);
 
+// view a single message by id
+$wahelper->viewMessage(device: 'xxxxxxxxxxxx', id: 'ABCDEF1234567890');
+
 // send message to user
 $wahelper->sendUser(
     device: 'xxxxxxxxxxxx',

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vielhuber/wahelper",
-    "version": "1.5.6",
+    "version": "1.5.8",
     "description": "Lightweight whatsapp integration layer.",
     "main": "wahelper.js",
     "files": [
@@ -26,8 +26,8 @@
         "qrcode-terminal": "^0.12.0"
     },
     "devDependencies": {
-        "@prettier/plugin-php": "^0.24.0",
-        "prettier": "^3.7.4"
+        "@prettier/plugin-php": "^0.25.0",
+        "prettier": "^3.8.3"
     },
     "engines": {
         "node": ">=18"

package/wahelper.js

@@ -55,10 +55,11 @@ export default class wahelper {
             this.args.device === undefined ||
             (this.args.action === 'send_user' && (this.args.number === undefined || this.args.message === undefined)) ||
             (this.args.action === 'send_group' && (this.args.name === undefined || this.args.message === undefined)) ||
+            (this.args.action === 'view_message' && (this.args.id === undefined || this.args.id === '')) ||
             (this.args.action === 'fetch_messages' &&
                 this.args.limit !== undefined &&
                 typeof this.args.limit !== 'number') ||
-            !['fetch_messages', 'send_user', 'send_group'].includes(this.args.action)
+            !['fetch_messages', 'view_message', 'send_user', 'send_group'].includes(this.args.action)
         ) {
             console.error('input missing or unknown action!');
             this.log('⛔input missing or unknown action!');
@@ -106,6 +107,9 @@ export default class wahelper {
                 if (this.args.action === 'fetch_messages') {
                     response = await this.fetchMessages(this.args.limit);
                 }
+                if (this.args.action === 'view_message') {
+                    response = await this.viewMessage(this.args.id);
+                }
                 if (this.args.action === 'send_user') {
                     response = await this.sendMessageToUser(this.args.number, this.args.message, this.args.attachments);
                 }
@@ -155,6 +159,37 @@ export default class wahelper {
         return null;
     }
 
+    async viewMessage(id = null) {
+        // lookup directly from database — no connection to daemon needed
+        try {
+            let message =
+                this.db
+                    .prepare(
+                        `
+							SELECT id, \`from\`, \`to\`, content, media_filename, timestamp
+							FROM messages
+							WHERE id = ?
+							LIMIT 1
+						`
+                    )
+                    .get(id) || null;
+            if (message === null) {
+                console.log('Message not found: ' + id);
+                this.write({ success: false, message: 'message_not_found', data: null }, true);
+                return { content: [{ type: 'text', text: 'Message not found: ' + id }], structuredContent: null };
+            }
+            console.log('Fetched message ' + id + ' from database.');
+            this.write({ success: true, message: 'message_fetched', data: message }, true);
+            return {
+                content: [{ type: 'text', text: 'Fetched message ' + id }],
+                structuredContent: message
+            };
+        } catch (error) {
+            this.log('⛔ Error fetching message from database: ' + error.message + ' (code: ' + error.code + ')');
+        }
+        return null;
+    }
+
     async sendMessageToUser(number = null, message = null, attachments = null) {
         let jid = this.formatNumber(number) + '@s.whatsapp.net';
         this.log('begin send message to user ' + jid);