Log errors

fix #16

.dockerignore

@@ -1,3 +1,4 @@
+Dockerfile
 tokens
 files
 venv

.pre-commit-config.yaml

@@ -0,0 +1,5 @@
+repos:
+  - repo: https://github.com/Lucas-C/pre-commit-hooks-nodejs
+    rev: v1.1.2
+    hooks:
+      - id: markdown-toc

Dockerfile

@@ -19,5 +19,6 @@ RUN npm install
 WORKDIR /app
 ADD . /app
 RUN npm run build
-ENTRYPOINT npm run start:prod
 EXPOSE 3000
+
+CMD npm run start:prod

README.md

@@ -7,6 +7,26 @@ go [through currently supported methods in Swagger](https://allburov.github.io/w
 
 The project is an HTTP API wrapper around https://github.com/orkestral/venom
 
+# Tables of Contents
+
+<!-- toc -->
+
+- [Installation](#installation)
+- [First Steps](#first-steps)
+  * [Run WhatsAPP HTTP API](#run-whatsapp-http-api)
+  * [Create a new session and login](#create-a-new-session-and-login)
+  * [Send a text message](#send-a-text-message)
+- [Receive messages](#receive-messages)
+    + [Python echo server](#python-echo-server)
+- [Environment variables](#environment-variables)
+  * [Common](#common)
+  * [Webhooks](#webhooks)
+  * [File storage](#file-storage)
+- [How to](#how-to)
+  * [How to build the newest Docker image locally](#how-to-build-the-newest-docker-image-locally)
+- [Support](#support)
+
+<!-- tocstop -->
 
 # Installation
 
@@ -42,14 +62,16 @@ support ([yet](https://github.com/allburov/whatsapp-http-api/issues/4)) authoriz
 1. To start a new session you should have your mobile phone with installed WhatsApp application close to you. Please go
    and read how what we'll need to a bit
    later: [How to log in - the instruction on WhatsApp site](https://faq.whatsapp.com/381777293328336/?helpref=hc_fnav)
-2. Open API documentation at http://localhost:3000/
-2. **Start a new session with a name** (you can use `default` for the start)  - find `POST /api/session/start`, click
+1. Open API documentation at http://localhost:3000/
+1. **Start a new session with a name** (you can use `default` for the start)  - find `POST /api/session/start`, click
    on **Try it out**, then **Execute** a bit below.
-3. **Scan QR Code** - find `GET /api/screenshot` and execute it, it'll show you QR code that you must scan with your
+   ![](./docs/images/session-start.png)
+1. **Scan QR Code** - find `GET /api/screenshot` and execute it, it'll show you QR code that you must scan with your
    device.
-4. **Get a screenshot** from Whatsapp again! It'll show you the screenshot of you Whatsapp instance.
-5. If you can get the actual screenshot - then you're ready to start sending messages!
-   ![](./docs/screenshot.png)
+   ![](./docs/images/qr.png)
+1. **Get a screenshot again** - it'll show you the screenshot of you Whatsapp instance. If you can get the actual
+   screenshot - then you're ready to start sending messages!
+   ![](./docs/images/screenshot.png)
 
 ## Send a text message
 
@@ -114,6 +136,7 @@ If you try to send an image the "echo server" will send a path to the downloaded
 - `DEBUG` - show debug and verbose logs, set in any value
 - `WHATSAPP_API_PORT` - listen port for HTTP server (default: `3000`)
 - `WHATSAPP_API_HOSTNAME` - Hostname for HTTP server (default: `localhost`)
+- `WHATSAPP_START_SESSION` - start session with that name right after launching the app
 
 ## Webhooks
 
@@ -135,12 +158,20 @@ All webhooks are disabled by default:
   like `audio,image`).
 - `WHATSAPP_FILES_LIFETIME`- to keep free space files will be removed after this time (default: `180`, in seconds)
 
+# How to
+## How to build the newest Docker image locally
+
+If the changes haven't been released yet from `main` branch - you can build your own version from the git repository
+```bash
+git clone https://github.com/allburov/whatsapp-http-api.git
+cd whatsapp-http-api
+docker build . -t allburov/whatsapp-http-api
+```
+
 # Support
 
 If you want to support the project - you can either:
 
 1. Create a Pull Request for desired functionality
-2. Support [the project one time](https://boosty.to/allburov/single-payment/post/e7db2841-5b53-4e5e-bb37-e0fdcbab8d2b)
-3. Support [the project every month](https://boosty.to/allburov/purchase/1015878)
-4. Support [the project and get access to private telegram channel](https://boosty.to/allburov/purchase/1015879)
+2. Support [the project one time, every month or get access to telegram channel on Boosty](https://boosty.to/allburov)
 

package.json

@@ -13,6 +13,7 @@
     "start:dev": "nest start --watch",
     "start:debug": "nest start --debug --watch",
     "start:prod": "node --unhandled-rejections=none dist/main",
+    "start:prod-exit": "node dist/main",
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
     "test": "jest",
     "test:watch": "jest --watch",

src/api/all.dto.ts

@@ -11,6 +11,11 @@ export class SessionQuery {
     sessionName: string = WHATSAPP_DEFAULT_SESSION_NAME;
 }
 
+export class CheckNumberStatusQuery extends SessionQuery {
+    @IsString()
+    phone: string
+}
+
 export class MessageTextQuery extends SessionQuery {
     @IsString()
     phone: string
@@ -48,6 +53,12 @@ export class MessageText extends ChatRequest {
     text: string;
 }
 
+export class MessageTextButtons extends ChatRequest {
+    text: string;
+    title: string;
+    buttons: any[];
+}
+
 export class MessageReply extends ChatRequest {
     text: string;
     @ApiProperty({

src/api/chatting.controller.ts

@@ -2,6 +2,7 @@ import {Body, Controller, Get, NotImplementedException, Post, Query} from '@nest
 import {ApiOperation, ApiTags} from "@nestjs/swagger";
 import {
     ChatRequest,
+    CheckNumberStatusQuery,
     MessageContactVcard,
     MessageFile,
     MessageImage,
@@ -9,6 +10,7 @@ import {
     MessageLocation,
     MessageReply,
     MessageText,
+    MessageTextButtons,
     MessageTextQuery
 } from "./all.dto";
 import {ensureSuffix, WhatsappSessionManager} from "../whatsapp.service";
@@ -19,6 +21,24 @@ export class ChattingController {
     constructor(private whatsappSessionManager: WhatsappSessionManager) {
     }
 
+    @Get('/checkNumberStatus')
+    @ApiOperation({summary: 'Check number status'})
+    async checkNumberStatus(
+        @Query() request: CheckNumberStatusQuery,
+    ) {
+        const whatsapp = this.whatsappSessionManager.getSession(request.sessionName)
+        try {
+            const result = await whatsapp.checkNumberStatus(ensureSuffix(request.phone))
+            return {numberExists: result['numberExists']}
+        } catch (error) {
+            // We need to "touch" the error in order to get unhandled rejections
+            // It logs out the session and stop the app
+            console.log(typeof error)
+            console.log(error)
+            return {numberExists: false}
+        }
+    }
+
     @Post('/sendContactVcard')
     sendContactVcard(@Body() message: MessageContactVcard) {
         const whatsapp = this.whatsappSessionManager.getSession(message.sessionName)
@@ -41,6 +61,13 @@ export class ChattingController {
         return whatsapp.sendText(ensureSuffix(message.chatId), message.text)
     }
 
+    @Post('/sendTextButtons')
+    @ApiOperation({summary: 'Send a text message with buttons'})
+    sendTextButtons(@Body() message: MessageTextButtons) {
+        const whatsapp = this.whatsappSessionManager.getSession(message.sessionName)
+        return whatsapp.sendButtons(ensureSuffix(message.chatId), message.title, message.buttons, message.text)
+    }
+
     @Post('/sendLocation')
     sendLocation(@Body() message: MessageLocation) {
         const whatsapp = this.whatsappSessionManager.getSession(message.sessionName)

src/config.service.ts

@@ -46,6 +46,10 @@ export class WhatsappConfigService {
         return types ? types.split(',') : null
     }
 
+    get startSession(): string | undefined {
+        return this.configService.get('WHATSAPP_START_SESSION', undefined)
+    }
+
     get(name: string): any {
         return this.configService.get(name)
     }

src/whatsapp.service.ts

@@ -65,7 +65,8 @@ export class WhatsappService {
                     this.saveQRCode(base64Qrimg)
                     this.status = WhatsappStatus.SCAN_QR_CODE
                     console.log('Number of attempts to read the qrcode: ', attempts);
-                    console.log('Terminal qrcode: ', asciiQR);
+                    console.log('Terminal qrcode:');
+                    console.log(asciiQR);
                 },
                 undefined,
                 {
@@ -221,6 +222,9 @@ export class WhatsappSessionManager implements OnApplicationShutdown {
         this.log.setContext('WhatsappSessionManager')
         this.cleanDownloadsFolder(this.config.filesFolder)
         this.sessions = {}
+        if (config.startSession) {
+            this.startSession(config.startSession)
+        }
     }
 
     async startSession(name: string) {
@@ -288,7 +292,7 @@ const SUFFIX_DIRECT_MESSAGE = "@c.us"
  * @param phone
  */
 export function ensureSuffix(phone) {
-    if (phone.endsWith(SUFFIX_DIRECT_MESSAGE)) {
+    if (phone.includes("@")) {
         return phone
     }
     return phone + SUFFIX_DIRECT_MESSAGE