[core] 2024.8.4

fixes #486

.github/ISSUE_TEMPLATE/bug_report.md

@@ -23,8 +23,8 @@ assignees: ''
 ```
 
 > You can get the WAHA version by calling `GET /api/version` Try to update to
-> [the latest version](https://github.com/devlikeapro/whatsapp-http-api/releases)
-> before creating an issue!
+> [the latest version](https://github.com/devlikeapro/waha/releases) before
+> creating an issue!
 
 **To Reproduce** Steps to reproduce the behavior:
 

.github/clear-gh-runs.sh

@@ -3,7 +3,7 @@
 #
 
 OWNER=devlikeapro
-REPO=whatsapp-http-api-plus
+REPO=waha-plus
 
 # list workflows
 gh api -X GET /repos/$OWNER/$REPO/actions/workflows | jq '.workflows[] | .name,.id'

.github/workflows/build.yaml

@@ -55,6 +55,7 @@ jobs:
           flavor: latest=false
           tags: |
             type=raw,value=${{ matrix.tag }}
+            type=raw,value=${{ matrix.tag }}-{{tag}}
 
       - name: Login to image repository
         if: github.ref_type == 'tag'

.gitignore

@@ -1,12 +1,16 @@
 .yarn
 example.ts
 .*sessions
+.secrets
 tokens
 files
 venv
 .wwebjs_auth
+src/test.ts
+src/test.js
 test.js
 .wwebjs_cache
+src/dashboard
 
 # compiled output
 /dist

.pre-commit-config.yaml

@@ -46,3 +46,15 @@ repos:
               src/structures/.*|
               src/config.service.ts|
           )$
+
+  - repo: local
+    hooks:
+      - id: no-console-log
+        name: No console.log() calls
+        language: pygrep
+        entry: 'console\.log'
+        exclude: |
+          (?x)^(
+              .pre-commit-config.yaml|
+              ^src/core/engines/webjs/session.webjs.core.ts|
+          )$

Dockerfile

@@ -6,35 +6,51 @@ FROM node:${NODE_VERSION} as build
 ENV PUPPETEER_SKIP_DOWNLOAD=True
 
 # npm packages
-RUN apt-get update \
-    && apt-get install -y openssh-client
-RUN apt install openssh-client
-RUN mkdir -p -m 0700 ~/.ssh && ssh-keyscan github.com >> ~/.ssh/known_hosts
-
 WORKDIR /src
 COPY package.json .
 COPY yarn.lock .
 RUN yarn set version 3.6.3
-RUN --mount=type=ssh yarn install
+RUN yarn install
 
 # App
 WORKDIR /src
 ADD . /src
-RUN --mount=type=ssh yarn install
+RUN yarn install
 RUN yarn build && find ./dist -name "*.d.ts" -delete
 
+#
+# Dashboard
+#
+FROM node:${NODE_VERSION} as dashboard
+
+# Download WAHA Dashboard
+ENV WAHA_DASHBOARD_SHA 63fd6e9e23e90f90e8aa0de04feb3f1909f63021
+RUN \
+    wget https://github.com/devlikeapro/dashboard/archive/${WAHA_DASHBOARD_SHA}.zip \
+    && unzip ${WAHA_DASHBOARD_SHA}.zip -d /tmp/dashboard \
+    && mkdir -p /dashboard \
+    && mv /tmp/dashboard/dashboard-${WAHA_DASHBOARD_SHA}/* /dashboard/ \
+    && rm -rf ${WAHA_DASHBOARD_SHA}.zip \
+    && rm -rf /tmp/dashboard/dashboard-${WAHA_DASHBOARD_SHA}
+
 #
 # Final
 #
 FROM node:${NODE_VERSION} as release
 ENV PUPPETEER_SKIP_DOWNLOAD=True
 # Quick fix for memory potential memory leaks
-# https://github.com/devlikeapro/whatsapp-http-api/issues/347
+# https://github.com/devlikeapro/waha/issues/347
 ENV NODE_OPTIONS="--max-old-space-size=16384"
 ARG USE_BROWSER=chromium
 
 RUN echo "USE_BROWSER=$USE_BROWSER"
 
+# Install ffmpeg to generate previews for videos
+RUN apt-get update && apt-get install -y ffmpeg --no-install-recommends && rm -rf /var/lib/apt/lists/*
+
+# Install zip and unzip
+RUN apt-get update && apt-get install -y zip unzip --no-install-recommends && rm -rf /var/lib/apt/lists/*
+
 # Install fonts if using either chromium or chrome
 RUN if [ "$USE_BROWSER" = "chromium" ] || [ "$USE_BROWSER" = "chrome" ]; then \
     apt-get update  \
@@ -55,7 +71,7 @@ RUN if [ "$USE_BROWSER" = "chromium" ]; then \
 # Install Chrome
 # Available versions:
 # https://www.ubuntuupdates.org/package/google_chrome/stable/main/base/google-chrome-stable
-ARG CHROME_VERSION="122.0.6261.128-1"
+ARG CHROME_VERSION="126.0.6478.182-1"
 RUN if [ "$USE_BROWSER" = "chrome" ]; then \
         wget --no-verbose -O /tmp/chrome.deb https://dl.google.com/linux/chrome/deb/pool/main/g/google-chrome-stable/google-chrome-stable_${CHROME_VERSION}_amd64.deb \
           && apt-get update \
@@ -69,6 +85,14 @@ WORKDIR /app
 COPY package.json ./
 COPY --from=build /src/node_modules ./node_modules
 COPY --from=build /src/dist ./dist
+COPY --from=dashboard /dashboard ./dist/dashboard
+
+# Chokidar options to monitor file changes
+ENV CHOKIDAR_USEPOLLING=1
+ENV CHOKIDAR_INTERVAL=5000
+
+# WAHA variables
+ENV WAHA_ZIPPER=ZIPUNZIP
 
 # Run command, etc
 EXPOSE 3000

Makefile

@@ -1,40 +1,41 @@
 build:
-	docker build . -t devlikeapro/whatsapp-http-api
+	docker build . -t devlikeapro/waha
 
 build-chrome:
-	docker build . -t devlikeapro/whatsapp-http-api-plus:chrome --build-arg USE_BROWSER=chrome
+	docker build . -t devlikeapro/waha-plus:chrome --build-arg USE_BROWSER=chrome
 
 build-noweb:
-	docker build . -t devlikeapro/whatsapp-http-api:noweb --build-arg USE_BROWSER=none
+	docker build . -t devlikeapro/waha:noweb --build-arg USE_BROWSER=none
 
 build-all: build build-chrome build-noweb
 
 build-plus:
-	docker build . -t devlikeapro/whatsapp-http-api-plus
+	docker build . -t devlikeapro/waha-plus
 
 build-ssh:
 	# check IMAGE provided
-	@[ "${IMAGE}" ]  || ( echo "Add APP: make build-ssh image=devlikeapro/whatsapp-http-api"; exit 1 );
+	@[ "${IMAGE}" ]  || ( echo "Add APP: make build-ssh image=devlikeapro/waha"; exit 1 );
 	eval $(ssh-agent) && \
 	ssh-add ~/.ssh/id_rsa && \
 	docker buildx build --ssh default=${SSH_AUTH_SOCK} . -t ${IMAGE} --build-arg USE_BROWSER=none
 
 stop:
-	docker stop whatsapp-http-api
+	docker stop waha
 
 clean: stop
 	sudo rm -rf .sessions
 
 push:
-	docker push devlikeapro/whatsapp-http-api
+	docker push devlikeapro/waha
 
 for-swagger:
-	WHATSAPP_SWAGGER_CONFIG_ADVANCED=true npm run start
+	WHATSAPP_SWAGGER_CONFIG_ADVANCED=true . ${NVM_DIR}/nvm.sh && nvm exec yarn start
 
-update-dependencies:
-	. ${NVM_DIR}/nvm.sh && nvm exec yarn up whatsapp-web.js@https://github.com/devlikeapro/whatsapp-web.js#main-fork
-	. ${NVM_DIR}/nvm.sh && nvm exec yarn up @adiwajshing/baileys@github:WhiskeySockets/Baileys
-	. ${NVM_DIR}/nvm.sh && nvm exec yarn up venom-bot
+up-noweb:
+	. ${NVM_DIR}/nvm.sh && nvm exec yarn up @adiwajshing/baileys@github:devlikeapro/Baileys#fork-master-channels
+
+up-webjs:
+	. ${NVM_DIR}/nvm.sh && nvm exec yarn up whatsapp-web.js@github:devlikeapro/whatsapp-web.js#fork-webpack-exodus-channels
 
 start-proxy:
 	docker run --rm -d --name squid-container -e TZ=UTC -p 3128:3128 ubuntu/squid:5.2-22.04_beta

README.md

@@ -1,4 +1,4 @@
-# WhatsApp HTTP API (WAHA)
+# WAHA
 
 <p align="center">
   <img src="./logo.png" style='border-radius: 50%' width='150'/>
@@ -6,7 +6,7 @@
 
 **WAHA** - **W**hats**A**pp **H**TTP **A**PI (REST API) that you can install on your own server and run in less than 5 minutes!
 
-[![Docker Pulls](https://img.shields.io/docker/pulls/devlikeapro/whatsapp-http-api)](https://hub.docker.com/r/devlikeapro/whatsapp-http-api)
+[![Docker Pulls](https://img.shields.io/docker/pulls/devlikeapro/whatsapp-http-api)](https://hub.docker.com/r/devlikeapro/waha)
 
 - Documentation: [https://waha.devlike.pro/](https://waha.devlike.pro/)
 - Swagger Example: [https://waha.devlike.pro/swagger](https://waha.devlike.pro/swagger)
@@ -104,13 +104,13 @@ Assuming you have installed [Docker](https://docs.docker.com/get-docker/), let's
 
 
 ```bash
-docker pull devlikeapro/whatsapp-http-api
+docker pull devlikeapro/waha
 ```
 
 
 ```bash
 docker login -u devlikeapro -p {KEY}
-docker pull devlikeapro/whatsapp-http-api-plus
+docker pull devlikeapro/waha-plus
 docker logout
 ```
 
@@ -121,7 +121,7 @@ Read more about how to get `PASSWORD` for [Plus Version →]({{< relref "plus-ve
 Run WhatsApp HTTP API:
 
 ```bash
-docker run -it --rm -p 3000:3000/tcp --name whatsapp-http-api devlikeapro/whatsapp-http-api
+docker run -it --rm -p 3000:3000/tcp --name waha devlikeapro/waha
 
 # It prints logs and the last line must be
 # WhatsApp HTTP API is running on: http://[::1]:3000

docker-compose.test.yaml

@@ -0,0 +1,114 @@
+services:
+  waha:
+    # Check available Docker images:
+    # https://waha.devlike.pro/docs/how-to/engines/#docker-images
+    image: devlikeapro/waha
+    container_name: waha
+    ports:
+      - '3000:3000/tcp'
+    environment:
+      # Environment variables from https://waha.devlike.pro/docs/how-to/config/
+      # https://docs.webhook.site/
+      - WHATSAPP_HOOK_URL=https://webhook.site/11111111-1111-1111-1111-11111111
+      - WHATSAPP_HOOK_EVENTS=message
+      - WHATSAPP_DEFAULT_ENGINE=WEBJS
+    restart: always
+
+  waha-plus:
+    # Check available Docker images:
+    # https://waha.devlike.pro/docs/how-to/engines/#docker-images
+    image: devlikeapro/waha-plus:chrome
+    container_name: waha-plus
+    ports:
+      - '3000:3000/tcp'
+    volumes:
+      - './.sessions:/app/.sessions'
+    environment:
+      # Environment variables from https://waha.devlike.pro/docs/how-to/config/
+      # - WHATSAPP_RESTART_ALL_SESSIONS=True
+      # - WHATSAPP_HOOK_URL=https://webhook.site/11111111-1111-1111-1111-11111111
+      # - WHATSAPP_HOOK_EVENTS=message
+      # - WHATSAPP_API_HOSTNAME=localhost
+      - WHATSAPP_DEFAULT_ENGINE=WEBJS
+      - WHATSAPP_API_KEY=321
+      # Username and password for Swagger
+      - WHATSAPP_SWAGGER_USERNAME=swagger
+      - WHATSAPP_SWAGGER_PASSWORD=admin
+      # Username and password for WAHA Dashboard
+      # you can use the same username and password for both Swagger and Dashboard
+      # Default - waha / waha
+      - WAHA_DASHBOARD_USERNAME=waha
+      - WAHA_DASHBOARD_PASSWORD=waha
+      # Engine specific environment variables
+      # - WAHA_WEBJS_WEB_VERSION=2.2412.54-videofix
+    restart: always
+
+  waha-plus--mongodb:
+    # Check available Docker images:
+    # https://waha.devlike.pro/docs/how-to/engines/#docker-images
+    image: devlikeapro/waha-plus:chrome
+    container_name: waha-plus--mongodb
+    ports:
+      - '3000:3000/tcp'
+    volumes:
+      - './.sessions:/app/.sessions'
+    environment:
+      # Environment variables from https://waha.devlike.pro/docs/how-to/config/
+      # - WHATSAPP_RESTART_ALL_SESSIONS=True
+      # - WHATSAPP_HOOK_URL=https://webhook.site/11111111-1111-1111-1111-11111111
+      # - WHATSAPP_HOOK_EVENTS=message
+      # - WHATSAPP_API_KEY=321
+      # - WHATSAPP_SWAGGER_USERNAME=admin
+      # - WHATSAPP_SWAGGER_PASSWORD=123
+      # - WAHA_DASHBOARD_USERNAME=admin
+      # - WAHA_DASHBOARD_PASSWORD=123
+      # - WHATSAPP_API_HOSTNAME=localhost
+      - WHATSAPP_DEFAULT_ENGINE=WEBJS
+      - WHATSAPP_SESSIONS_MONGO_URL=mongodb://mongodb:27017
+    restart: always
+
+  # Let's Encrypt + Certbot
+  # https://waha.devlike.pro/docs/how-to/security/#https
+  waha-https--certbot:
+    image: devlikeapro/waha-plus
+    restart: unless-stopped
+    ports:
+      - '3000:3000'
+    volumes:
+      - './.sessions:/app/.sessions'
+      - '/etc/letsencrypt:/etc/letsencrypt'
+    environment:
+      - DOMAIN=waha.example.pro
+      - WHATSAPP_API_HOSTNAME=${DOMAIN}
+      - WAHA_HTTPS_ENABLED=true
+      - WAHA_HTTPS_PATH_KEY=/etc/letsencrypt/live/${DOMAIN}/privkey.pem
+      - WAHA_HTTPS_PATH_CERT=/etc/letsencrypt/live/${DOMAIN}/cert.pem
+      - WAHA_HTTPS_PATH_CA=/etc/letsencrypt/live/${DOMAIN}/chain.pem
+
+  # Self-signed certificates example
+  # https://waha.devlike.pro/docs/how-to/security/#https
+  waha-https--self-signed:
+    image: devlikeapro/waha-plus
+    restart: unless-stopped
+    ports:
+      - '3000:3000'
+    volumes:
+      - './.sessions:/app/.sessions'
+      - './.secrets:/app/.secrets'
+    environment:
+      - WAHA_HTTPS_ENABLED=true
+      - WAHA_HTTPS_PATH_KEY=.secrets/privkey.pem
+      - WAHA_HTTPS_PATH_CERT=.secrets/cert.pem
+      - WAHA_HTTPS_PATH_CA=.secrets/chain.pem
+
+  mongodb:
+    image: mongo
+    container_name: mongodb
+    ports:
+      - '27017:27017/tcp'
+    volumes:
+      - mongodb_data:/data/db
+    restart: always
+
+volumes:
+  mongodb_data: {}

docker-compose.yaml

@@ -1,80 +1,203 @@
-version: '3'
+#
+# https://waha.devlike.pro/docs/how-to/install/
+# Here's we provide a simple example of how to install WAHA using Docker Compose.
+#
+# We're assuming you have Docker and Docker Compose installed.
+# If you don't have Docker Compose installed, you can follow the official guide:
+# https://docs.docker.com/compose/install/
+#
+
 services:
-  whatsapp-http-api:
-    # Check available Docker images:
-    # https://waha.devlike.pro/docs/how-to/engines/#docker-images
-    image: devlikeapro/whatsapp-http-api
-    container_name: whatsapp-http-api
-    ports:
-      - '3000:3000/tcp'
-    environment:
-      # Environment variables from https://waha.devlike.pro/docs/how-to/config/
-      - WHATSAPP_HOOK_URL=https://httpbin.org/post
-      - WHATSAPP_HOOK_EVENTS=message
-      - WHATSAPP_DEFAULT_ENGINE=WEBJS
+  waha:
+    # Always restart the container on failure
     restart: always
 
-  whatsapp-http-api-plus:
-    # Check available Docker images:
+    #
+    # Image
+    #
+    image: devlikeapro/waha-plus:latest # or devlikeapro/waha:latest if you're using WAHA Core
+    #
+    # We strongly recommend using the pinned version of WAHA
+    # https://waha.devlike.pro/docs/how-to/engines/#versions
+    # image: devlikeapro/waha-plus:latest-2024.7.6 # 'latest' is not mistaken here
+    #
+    # Multiple images are available
     # https://waha.devlike.pro/docs/how-to/engines/#docker-images
-    image: devlikeapro/whatsapp-http-api-plus:chrome
-    container_name: whatsapp-http-api-plus
+    # image: devlikeapro/waha-plus:chrome
+    #
+
+    # The first port can be any free port you want
+    # The second port must be the same as WHATSAPP_API_PORT or 3000 by default
+    # Consider using the same port for simplicity
     ports:
       - '3000:3000/tcp'
+      # NOTE: if you're using HTTP, you can use the following port mapping
+      #- '80:3000/tcp'
+      # NOTE: if you're using HTTPS, you can use the following port mapping
+      #- '443:3000/tcp'
+
     volumes:
+      # Store sessions in the .sessions folder (comment it if you're using MongoDB)
+      # Doesn't work with WAHA Core
       - './.sessions:/app/.sessions'
+
+      # https://waha.devlike.pro/docs/how-to/storages/#save-media-files-between-the-container-restarts
+      - './.media:/app/.media'
+
+      # If you're using certbot for HTTPS, you can use the following volume mapping
+      # https://waha.devlike.pro/blog/setting-up-https-for-waha/#lets-encrypt-certbot--waha
+      # - '/etc/letsencrypt:/etc/letsencrypt'
+
+    # WAHA Configuration
+    # https://waha.devlike.pro/docs/how-to/config/
     environment:
-      # Environment variables from https://waha.devlike.pro/docs/how-to/config/
-      # - WHATSAPP_RESTART_ALL_SESSIONS=True
-      # - WHATSAPP_HOOK_URL=https://httpbin.org/post
-      # - WHATSAPP_HOOK_EVENTS=message
-      # - WHATSAPP_API_HOSTNAME=localhost
-      - WHATSAPP_DEFAULT_ENGINE=WEBJS
+      #
+      # Common
+      #
+      # If you know the right URL, you can use it here.
+      # Use any port in WHATSAPP_API_PORT and domain in WHATSAPP_API_HOSTNAME
+      # https://waha.devlike.pro/docs/how-to/config/#common
+      #- WHATSAPP_API_PORT=3000
+      #- WHATSAPP_API_HOSTNAME=localhost
+
+      #
+      # Security
+      #
+      # https://waha.devlike.pro/docs/how-to/security/
+      #
       - WHATSAPP_API_KEY=321
-      # Username and password for Swagger
-      - WHATSAPP_SWAGGER_USERNAME=swagger
-      - WHATSAPP_SWAGGER_PASSWORD=admin
-      # Username and password for WAHA Dashboard
-      # you can use the same username and password for both Swagger and Dashboard
-      # Default - waha / waha
       - WAHA_DASHBOARD_USERNAME=waha
       - WAHA_DASHBOARD_PASSWORD=waha
-      # Engine specific environment variables
-      # - WAHA_WEBJS_WEB_VERSION=2.2412.54-videofix
-    restart: always
+      #- WHATSAPP_SWAGGER_USERNAME=admin
+      #- WHATSAPP_SWAGGER_PASSWORD=admin
 
-  whatsapp-http-api-plus--mongodb:
-    # Check available Docker images:
-    # https://waha.devlike.pro/docs/how-to/engines/#docker-images
-    image: devlikeapro/whatsapp-http-api-plus:chrome
-    container_name: whatsapp-http-api-plus--mongodb
-    ports:
-      - '3000:3000/tcp'
-    volumes:
-      - './.sessions:/app/.sessions'
-    environment:
-      # Environment variables from https://waha.devlike.pro/docs/how-to/config/
-      # - WHATSAPP_RESTART_ALL_SESSIONS=True
-      # - WHATSAPP_HOOK_URL=https://httpbin.org/post
-      # - WHATSAPP_HOOK_EVENTS=message
-      # - WHATSAPP_API_KEY=321
-      # - WHATSAPP_SWAGGER_USERNAME=admin
-      # - WHATSAPP_SWAGGER_PASSWORD=123
-      # - WAHA_DASHBOARD_USERNAME=admin
-      # - WAHA_DASHBOARD_PASSWORD=123
-      # - WHATSAPP_API_HOSTNAME=localhost
+      #
+      # Dashboard
+      #
+      # https://waha.devlike.pro/docs/how-to/waha-dashboard/#configuration
+      # Enabled by default
+      #- WAHA_DASHBOARD_ENABLED=true
+      #- WAHA_DASHBOARD_USERNAME=waha
+      #- WAHA_DASHBOARD_PASSWORD=waha
+
+      #
+      # Logging
+      # https://waha.devlike.pro/docs/how-to/observability/#logging
+      #
+      - WAHA_LOG_FORMAT=PRETTY
+      # Set log format to JSON if you consume logs with log management systems
+      #- WAHA_LOG_FORMAT=JSON
+      - WAHA_LOG_LEVEL=info
+      # If you want to see more logs, you can set the log level to debug
+      #- WAHA_LOG_LEVEL=debug
+      # DEBUG=1 # shortcut for setting log level to debug
+
+      #
+      # Engine
+      #
+      # Choose the right engine for your needs (WEBJS by default)
+      # https://waha.devlike.pro/docs/how-to/engines/
       - WHATSAPP_DEFAULT_ENGINE=WEBJS
-      - WHATSAPP_SESSIONS_MONGO_URL=mongodb://mongodb:27017
-    restart: always
+      # Use NOWEB engine for the fastest performance
+      #- WHATSAPP_DEFAULT_ENGINE=NOWEB
 
-  mongodb:
-    image: mongo
-    container_name: mongodb
-    ports:
-      - '27017:27017/tcp'
-    volumes:
-      - mongodb_data:/data/db
-    restart: always
+      #
+      # Sessions
+      #
+      # https://waha.devlike.pro/docs/how-to/config/#sessions
+      # Restart all sessions when container starts
+      - WHATSAPP_RESTART_ALL_SESSIONS=True
+      # Do not print QR codes in logs
+      - WAHA_PRINT_QR=False
+      #
+      # OR you can specify sessions by name, if you have handful amount of sessions
+      #- WHATSAPP_START_SESSION=session1,session2
+      # Do not use both WHATSAPP_RESTART_ALL_SESSIONS and WHATSAPP_START_SESSION parameters
+      #
 
-volumes:
-  mongodb_data: {}
+      #
+      # Swagger
+      #
+      # https://waha.devlike.pro/docs/how-to/swagger/
+      #- WHATSAPP_SWAGGER_USERNAME=admin
+      #- WHATSAPP_SWAGGER_PASSWORD=admin
+      # Disable Swagger
+      #- WHATSAPP_SWAGGER_ENABLED=false
+      # Enable advanced Swagger configuration
+      #- WHATSAPP_SWAGGER_CONFIG_ADVANCED=true
+      #
+      # Swagger White Label customization
+      # https://waha.devlike.pro/docs/how-to/swagger/#white-label
+      #- WHATSAPP_SWAGGER_TITLE=WAHA API
+      #
+
+      #
+      # Global Proxy Settings
+      # https://waha.devlike.pro/docs/how-to/config/#global-proxy-configuration
+      # You can also set proxy settings for each session later when starting it
+      # https://waha.devlike.pro/docs/how-to/sessions/#configure-proxy
+      #- WHATSAPP_PROXY_SERVER=proxy.example.com:3128
+      #-WHATSAPP_PROXY_SERVER_USERNAME=user
+      #-WHATSAPP_PROXY_SERVER_PASSWORD=pass
+      #
+
+      #
+      # HTTPS Configuration
+      #
+      # https://waha.devlike.pro/docs/how-to/config/#https
+      # Consider using certbot for HTTPS
+      # https://waha.devlike.pro/blog/setting-up-https-for-waha/#lets-encrypt-certbot--waha
+      #- WHATSAPP_API_HOSTNAME=waha.example.pro
+      #- WAHA_HTTPS_ENABLED=true
+      #- WAHA_HTTPS_PATH_KEY=/etc/letsencrypt/live/waha.example.pro/privkey.pem
+      #- WAHA_HTTPS_PATH_CERT=/etc/letsencrypt/live/waha.example.pro/cert.pem \
+      #- WAHA_HTTPS_PATH_CA=/etc/letsencrypt/live/waha.example.pro/chain.pem
+      #
+
+      #
+      # Media Configuration
+      #
+      # https://waha.devlike.pro/docs/how-to/config/#files
+      #
+      # Disable media (images, videos, files) download for incoming messages
+      #- WHATSAPP_DOWNLOAD_MEDIA=false
+      #
+      # Download only specific media types
+      #- WHATSAPP_FILES_MIMETYPES=image/jpeg,image/png
+      #
+      # Set to 0 to keep media files forever
+      # https://waha.devlike.pro/docs/how-to/storages/#save-media-files-between-the-container-restarts
+      - WHATSAPP_FILES_LIFETIME=0
+      - WHATSAPP_FILES_FOLDER=/app/.media
+      #
+      # Keep media files for 180 seconds (3 minutes)
+      #- WHATSAPP_FILES_LIFETIME=180
+      #
+
+      #
+      # Global Webhooks
+      #
+      # https://waha.devlike.pro/docs/how-to/config/#webhooks
+      # https://waha.devlike.pro/docs/how-to/webhooks/
+      #- WHATSAPP_HOOK_URL=https://webhook.site/11111111-1111-1111-1111-11111111
+      #- WHATSAPP_HOOK_EVENTS=session.status,message,message.reaction
+      #
+
+      #
+      # MongoDB Configuration
+      # https://waha.devlike.pro/docs/how-to/storages/#sessions---mongodb
+      #- WHATSAPP_SESSIONS_MONGO_URL=mongodb://mongodb:27017
+      #
+# NOTE: Uncomment this block to run WAHA+ with MongoDB
+#  mongodb:
+#    image: mongo
+#    container_name: mongodb
+#    ports:
+#      - '27017:27017/tcp'
+#    volumes:
+#      - mongodb_data:/data/db
+#    restart: always
+
+# NOTE: Uncomment this block to run WAHA+ with MongoDB
+#volumes:
+#  mongodb_data: {}

examples/python/README.md

@@ -19,9 +19,9 @@ Download and start WhatsApp HTTP API docker container
 
 ```bash
 # Download the image
-docker pull devlikeapro/whatsapp-http-api
+docker pull devlikeapro/waha
 # Run the docker container
-docker run -it --rm --network=host -e WHATSAPP_HOOK_URL=http://localhost:5000/bot -e "WHATSAPP_HOOK_EVENTS=*" --name whatsapp-http-api devlikeapro/whatsapp-http-api
+docker run -it --rm --network=host -e WHATSAPP_HOOK_URL=http://localhost:5000/bot -e "WHATSAPP_HOOK_EVENTS=*" --name waha devlikeapro/waha
 
 # It prints logs and the last line must be
 # WhatsApp HTTP API is running on: http://[::1]:3000
@@ -36,11 +36,11 @@ commands to download the image
 
 ```bash
 # Download the image
-docker pull devlikeapro/whatsapp-http-api:arm
-# Rename it, so you can use devlikeapro/whatsapp-http-api image in other place
-docker tag devlikeapro/whatsapp-http-api:arm devlikeapro/whatsapp-http-api
+docker pull devlikeapro/waha:arm
+# Rename it, so you can use devlikeapro/waha image in other place
+docker tag devlikeapro/waha:arm devlikeapro/waha
 # Run the docker container
-docker run -it --rm --network=host -e WHATSAPP_HOOK_URL=http://localhost:5000/bot -e "WHATSAPP_HOOK_EVENTS=*" --name whatsapp-http-api devlikeapro/whatsapp-http-api
+docker run -it --rm --network=host -e WHATSAPP_HOOK_URL=http://localhost:5000/bot -e "WHATSAPP_HOOK_EVENTS=*" --name waha devlikeapro/waha
 
 # It prints logs and the last line must be
 # WhatsApp HTTP API is running on: http://[::1]:3000
@@ -79,9 +79,9 @@ set up webhooks and reply to incoming messages.
 
 ```bash
 # Clone the git repository with example
-git clone https://github.com/devlikeapro/whatsapp-http-api.git
+git clone https://github.com/devlikeapro/waha.git
 # Open python example folder
-cd whatsapp-http-api/examples/python
+cd waha/examples/python
 # Install requirements
 python -mpip install -r requirements.txt
 # Run the bot
@@ -106,18 +106,18 @@ Download **WAHA Plus** version:
 
 ```bash
 # Download the image
-docker pull devlikeapro/whatsapp-http-api-plus
+docker pull devlikeapro/waha-plus
 # Run the docker container
-docker run -it --rm --network=host -e WHATSAPP_HOOK_URL=http://localhost:5000/bot -e "WHATSAPP_HOOK_EVENTS=*" --name whatsapp-http-api devlikeapro/whatsapp-http-api-plus
+docker run -it --rm --network=host -e WHATSAPP_HOOK_URL=http://localhost:5000/bot -e "WHATSAPP_HOOK_EVENTS=*" --name waha devlikeapro/waha-plus
 ```
 
 Run the WhatsApp Download Files bot:
 
 ```bash
 # Clone the git repository with example
-git clone https://github.com/devlikeapro/whatsapp-http-api.git
+git clone https://github.com/devlikeapro/waha.git
 # Open python example folder
-cd whatsapp-http-api/examples/python
+cd waha/examples/python
 # Install requirements
 python -mpip install -r requirements.txt
 # Run the bot

package.json

@@ -1,5 +1,5 @@
 {
-  "name": "whatsapp-http-api",
+  "name": "waha",
   "version": "0.0.1",
   "description": "",
   "author": "",
@@ -22,7 +22,7 @@
     "test:e2e": "jest --config ./test/jest-e2e.json"
   },
   "dependencies": {
-    "@adiwajshing/baileys": "github:WhiskeySockets/Baileys",
+    "@adiwajshing/baileys": "github:devlikeapro/Baileys#fork-master-channels",
     "@adiwajshing/keyed-db": "^0.2.4",
     "@nestjs/axios": "^3.0.2",
     "@nestjs/common": "^9.0.9",
@@ -30,25 +30,37 @@
     "@nestjs/core": "^9.0.9",
     "@nestjs/passport": "^9.0.0",
     "@nestjs/platform-express": "^9.0.9",
+    "@nestjs/platform-ws": "^9.0.9",
     "@nestjs/serve-static": "^2.1.3",
     "@nestjs/swagger": "^7.1.11",
     "@nestjs/terminus": "^10.2.3",
+    "@nestjs/websockets": "^9.0.9",
+    "@types/better-sqlite3": "^7.6.10",
     "@types/lodash": "^4.14.194",
     "@types/ws": "^8.5.4",
+    "adm-zip": "0.5.10",
     "async-lock": "^1.4.1",
+    "better-sqlite3": "9.6.0",
     "check-disk-space": "^3.4.0",
-    "class-validator": "^0.12.2",
+    "chokidar": "^3.6.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "0.14.0",
     "del": "^6.0.0",
     "express-basic-auth": "^1.2.1",
     "file-type": "16.5.4",
     "https-proxy-agent": "^7.0.0",
+    "knex": "^3.1.0",
     "libphonenumber-js": "^1.10.36",
     "link-preview-js": "^3.0.4",
     "lodash": "^4.17.21",
     "mime-types": "^2.1.27",
     "mongodb": "^6.3.0",
+    "nestjs-pino": "^4.1.0",
     "passport": "^0.6.0",
     "passport-headerapikey": "^1.2.2",
+    "pino-http": "^10.2.0",
+    "pino-pretty": "^11.2.1",
+    "pretty-bytes": "5.6.0",
     "puppeteer": "^21.0.0",
     "qrcode": "^1.5.1",
     "qrcode-terminal": "^0.12.0",
@@ -57,9 +69,10 @@
     "requestretry": "^4.1.1",
     "rimraf": "^3.0.2",
     "rxjs": "^7.1.0",
+    "sharp": "^0.33.4",
     "swagger-ui-express": "^4.1.4",
     "venom-bot": "5.0.1",
-    "whatsapp-web.js": "https://github.com/devlikeapro/whatsapp-web.js#main-fork-update"
+    "whatsapp-web.js": "github:devlikeapro/whatsapp-web.js#fork-webpack-exodus-channels"
   },
   "devDependencies": {
     "@nestjs/cli": "^9.0.0",

scripts/waha-run.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+set -e
+echo "Starting WAHA..."
+
+docker run -d \
+    --restart=always \
+    --name waha \
+    -p 3000:3000/tcp \
+    -v ./.sessions:/app/.sessions \
+    -v ./.media:/app/.media \
+    --env WHATSAPP_API_KEY=321 \
+    --env WAHA_DASHBOARD_USERNAME=waha \
+    --env WAHA_DASHBOARD_PASSWORD=waha \
+    --env WAHA_LOG_FORMAT=PRETTY \
+    --env WAHA_LOG_LEVEL=info \
+    --env WHATSAPP_DEFAULT_ENGINE=WEBJS \
+    --env WHATSAPP_RESTART_ALL_SESSIONS=True \
+    --env WAHA_PRINT_QR=False \
+    --env WHATSAPP_FILES_LIFETIME=0 \
+    --env WHATSAPP_FILES_FOLDER=/app/.media \
+    devlikeapro/waha-plus:latest
+
+echo "WAHA started."

scripts/waha-update.sh

@@ -0,0 +1,21 @@
+set -e
+echo "Updating WAHA..."
+echo "Logging in to Docker..."
+docker login -u devlikeapro # -p {KEY} - you can hard code key here https://portal.devlike.pro/
+
+echo "Pulling the latest image..."
+docker pull devlikeapro/waha-plus
+
+echo "Logging out of Docker..."
+docker logout
+
+# Just pull if you're using WAHA Core
+# docker pull devlikeapro/waha
+
+echo "Stopping the current container..."
+docker stop waha || true
+echo "Removing the current container..."
+docker rm waha || true
+
+echo "Running WAHA..."
+sh ./waha-run.sh

src/api/BufferJsonReplacerInterceptor.ts

@@ -0,0 +1,34 @@
+import { BufferJSON } from '@adiwajshing/baileys/lib/Utils';
+import {
+  CallHandler,
+  ExecutionContext,
+  Injectable,
+  NestInterceptor,
+  StreamableFile,
+} from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { map } from 'rxjs/operators';
+
+@Injectable()
+export class BufferJsonReplacerInterceptor implements NestInterceptor {
+  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
+    return next.handle().pipe(
+      map((data) => {
+        if (typeof data !== 'object' || data === null) {
+          return data;
+        }
+        // Buffer
+        if (Buffer.isBuffer(data) || data?.data || data?.url) {
+          return data;
+        }
+
+        // StreamableFile
+        if (data instanceof StreamableFile) {
+          return data;
+        }
+
+        return JSON.parse(JSON.stringify(data, BufferJSON.replacer));
+      }),
+    );
+  }
+}

src/api/channels.controller.ts

@@ -0,0 +1,119 @@
+import {
+  Body,
+  Controller,
+  Delete,
+  Get,
+  Param,
+  Post,
+  Query,
+} from '@nestjs/common';
+import { ApiOperation, ApiSecurity, ApiTags } from '@nestjs/swagger';
+import {
+  Channel,
+  CreateChannelRequest,
+  ListChannelsQuery,
+  NewsletterIdApiParam,
+  NewsletterIdOrInviteCodeApiParam,
+} from '@waha/structures/channels.dto';
+
+import { SessionManager } from '../core/abc/manager.abc';
+import { isNewsletter, WhatsappSession } from '../core/abc/session.abc';
+import { SessionApiParam, SessionParam } from './helpers';
+
+@ApiSecurity('api_key')
+@Controller('api/:session/channels')
+@ApiTags('channels')
+export class ChannelsController {
+  constructor(private manager: SessionManager) {}
+
+  @Get('')
+  @SessionApiParam
+  @ApiOperation({ summary: 'Get list of know channels' })
+  async list(
+    @SessionParam session: WhatsappSession,
+    @Query() query: ListChannelsQuery,
+  ): Promise<Channel[]> {
+    return session.channelsList(query);
+  }
+
+  @Post('')
+  @SessionApiParam
+  @ApiOperation({ summary: 'Create a new channel.' })
+  create(
+    @SessionParam session: WhatsappSession,
+    @Body() request: CreateChannelRequest,
+  ): Promise<Channel> {
+    return session.channelsCreateChannel(request);
+  }
+
+  @Delete(':id')
+  @SessionApiParam
+  @NewsletterIdApiParam
+  @ApiOperation({ summary: 'Delete the channel.' })
+  delete(@SessionParam session: WhatsappSession, @Param('id') id: string) {
+    return session.channelsDeleteChannel(id);
+  }
+
+  @Get(':id')
+  @SessionApiParam
+  @NewsletterIdOrInviteCodeApiParam
+  @ApiOperation({
+    summary: 'Get the channel info - either by id @newsletter OR invite code.',
+  })
+  get(
+    @SessionParam session: WhatsappSession,
+    @Param('id') id: string,
+  ): Promise<Channel> {
+    if (isNewsletter(id)) {
+      return session.channelsGetChannel(id);
+    } else {
+      // https://www.whatsapp.com/channel/123 => 123
+      const inviteCode = id.split('/').pop();
+      return session.channelsGetChannelByInviteCode(inviteCode);
+    }
+  }
+
+  @Post('follow')
+  @SessionApiParam
+  @NewsletterIdApiParam
+  @ApiOperation({ summary: 'Follow the channel.' })
+  follow(
+    @SessionParam session: WhatsappSession,
+    @Param('id') id: string,
+  ): Promise<void> {
+    return session.channelsFollowChannel(id);
+  }
+
+  @Post('unfollow')
+  @SessionApiParam
+  @NewsletterIdApiParam
+  @ApiOperation({ summary: 'Unfollow the channel.' })
+  unfollow(
+    @SessionParam session: WhatsappSession,
+    @Param('id') id: string,
+  ): Promise<void> {
+    return session.channelsUnfollowChannel(id);
+  }
+
+  @Post('mute')
+  @SessionApiParam
+  @NewsletterIdApiParam
+  @ApiOperation({ summary: 'Mute the channel.' })
+  mute(
+    @SessionParam session: WhatsappSession,
+    @Param('id') id: string,
+  ): Promise<void> {
+    return session.channelsMuteChannel(id);
+  }
+
+  @Post('unmute')
+  @SessionApiParam
+  @NewsletterIdApiParam
+  @ApiOperation({ summary: 'Unmute the channel.' })
+  unmute(
+    @SessionParam session: WhatsappSession,
+    @Param('id') id: string,
+  ): Promise<void> {
+    return session.channelsUnmuteChannel(id);
+  }
+}

src/api/chats.controller.ts

@@ -7,13 +7,15 @@ import {
   Post,
   Put,
   Query,
+  UsePipes,
+  ValidationPipe,
 } from '@nestjs/common';
 import { ApiOperation, ApiSecurity, ApiTags } from '@nestjs/swagger';
 
 import { SessionManager } from '../core/abc/manager.abc';
 import { WhatsappSession } from '../core/abc/session.abc';
 import { parseBool } from '../helpers';
-import { GetChatMessagesQuery } from '../structures/chats.dto';
+import { GetChatMessagesQuery, GetChatsQuery } from '../structures/chats.dto';
 import { EditMessageRequest } from '../structures/chatting.dto';
 import {
   ChatIdApiParam,
@@ -25,14 +27,18 @@ import {
 @ApiSecurity('api_key')
 @Controller('api/:session/chats')
 @ApiTags('chats')
+@UsePipes(new ValidationPipe({ transform: true }))
 class ChatsController {
   constructor(private manager: SessionManager) {}
 
   @Get('')
   @SessionApiParam
-  @ApiOperation({ summary: 'Get all chats' })
-  getAllChats(@SessionParam session: WhatsappSession) {
-    return session.getChats();
+  @ApiOperation({ summary: 'Get chats' })
+  getChats(
+    @SessionParam session: WhatsappSession,
+    @Query() query: GetChatsQuery,
+  ) {
+    return session.getChats(query);
   }
 
   @Delete(':chatId')
@@ -93,6 +99,28 @@ class ChatsController {
   ) {
     return session.editMessage(chatId, messageId, body);
   }
+
+  @Post(':chatId/archive')
+  @SessionApiParam
+  @ChatIdApiParam
+  @ApiOperation({ summary: 'Archive the chat' })
+  archiveChat(
+    @SessionParam session: WhatsappSession,
+    @Param('chatId') chatId: string,
+  ) {
+    return session.chatsArchiveChat(chatId);
+  }
+
+  @Post(':chatId/unarchive')
+  @SessionApiParam
+  @ChatIdApiParam
+  @ApiOperation({ summary: 'Unarchive the chat' })
+  unarchiveChat(
+    @SessionParam session: WhatsappSession,
+    @Param('chatId') chatId: string,
+  ) {
+    return session.chatsUnarchiveChat(chatId);
+  }
 }
 
 export { ChatsController };

src/api/chatting.controller.ts

@@ -46,7 +46,7 @@ export class ChattingController {
   }
 
   @Get('/sendText')
-  @ApiOperation({ summary: 'Send a text message' })
+  @ApiOperation({ summary: 'Send a text message', deprecated: true })
   sendTextGet(@Query() query: MessageTextQuery) {
     const whatsapp = this.manager.getSession(query.session);
     const msg = new MessageTextRequest();

src/api/exception.filter.ts

@@ -31,7 +31,7 @@ export class AllExceptionsFilter implements ExceptionFilter {
     /**
      * If file not found - we get weird 500 error
      * So we convert that exception manually to 404 and send appropriate JSON response
-     * @issue https://github.com/devlikeapro/whatsapp-http-api/issues/134
+     * @issue https://github.com/devlikeapro/waha/issues/134
      * @solution https://github.com/nestjs/serve-static/issues/139#issuecomment-612429557
      */
     if (exception.code === 'ENOENT') {

src/api/health.controller.ts

@@ -1,5 +1,5 @@
 import { Controller, Get } from '@nestjs/common';
-import { ApiTags } from '@nestjs/swagger';
+import { ApiOperation, ApiTags } from '@nestjs/swagger';
 import { HealthCheck } from '@nestjs/terminus';
 
 import { WAHAHealthCheckService } from '../core/abc/WAHAHealthCheckService';
@@ -11,6 +11,9 @@ export class HealthController {
 
   @Get()
   @HealthCheck()
+  @ApiOperation({
+    summary: 'Check the health of the server, performing all health checks.',
+  })
   async check() {
     return this.wahaHealth.check();
   }

src/api/labels.controller.ts

@@ -0,0 +1,52 @@
+import { Body, Controller, Get, Param, Put } from '@nestjs/common';
+import { ApiOperation, ApiSecurity, ApiTags } from '@nestjs/swagger';
+import { SessionApiParam, SessionParam } from '@waha/api/helpers';
+import { WhatsappSession } from '@waha/core/abc/session.abc';
+import { Label, LabelID, SetLabelsRequest } from '@waha/structures/labels.dto';
+
+import { SessionManager } from '../core/abc/manager.abc';
+
+@ApiSecurity('api_key')
+@Controller('api/:session/labels')
+@ApiTags('labels')
+export class LabelsController {
+  constructor(private manager: SessionManager) {}
+
+  @Get('/')
+  @SessionApiParam
+  @ApiOperation({ summary: 'Get all labels' })
+  getAll(@SessionParam session: WhatsappSession): Promise<Label[]> {
+    return session.getLabels();
+  }
+
+  @Get('/chats/:chatId')
+  @SessionApiParam
+  @ApiOperation({ summary: 'Get labels for the chat' })
+  getChatLabels(
+    @SessionParam session: WhatsappSession,
+    @Param('chatId') chatId: string,
+  ): Promise<Label[]> {
+    return session.getChatLabels(chatId);
+  }
+
+  @Put('/chats/:chatId')
+  @SessionApiParam
+  @ApiOperation({ summary: 'Save labels for the chat' })
+  putChatLabels(
+    @SessionParam session: WhatsappSession,
+    @Param('chatId') chatId: string,
+    @Body() request: SetLabelsRequest,
+  ) {
+    return session.putLabelsToChat(chatId, request.labels);
+  }
+
+  @Get('/:labelId/chats')
+  @SessionApiParam
+  @ApiOperation({ summary: 'Get chats by label' })
+  getChatsByLabel(
+    @SessionParam session: WhatsappSession,
+    @Param('labelId') labelId: string,
+  ) {
+    return session.getChatsByLabelId(labelId);
+  }
+}

src/api/ping.controller.ts

@@ -0,0 +1,13 @@
+import { Controller, Get } from '@nestjs/common';
+import { ApiOperation, ApiTags } from '@nestjs/swagger';
+import { PingResponse } from '@waha/structures/ping.dto';
+
+@Controller('ping')
+@ApiTags('other')
+export class PingController {
+  @Get()
+  @ApiOperation({ summary: 'Ping the server, perform no operations.' })
+  ping(): PingResponse {
+    return { message: 'pong' };
+  }
+}

src/api/sessions.controller.ts

@@ -63,7 +63,7 @@ class SessionsController {
   }
 
   @Get('/')
-  async list(@Query() query: ListSessionsQuery): Promise<SessionInfo[]> {
+  list(@Query() query: ListSessionsQuery): Promise<SessionInfo[]> {
     const all = parseBool(query.all);
     return this.manager.getSessions(all);
   }
@@ -87,7 +87,7 @@ class SessionController {
   @Get('me')
   @SessionApiParam
   @ApiOperation({ summary: 'Get information about the authenticated account' })
-  getMe(@SessionParam session: WhatsappSession): Promise<MeInfo | null> {
+  getMe(@SessionParam session: WhatsappSession): MeInfo | null {
     return session.getSessionMeInfo();
   }
 }

src/api/status.controller.ts

@@ -12,6 +12,7 @@ import { ApiOperation, ApiSecurity, ApiTags } from '@nestjs/swagger';
 import { SessionManager } from '../core/abc/manager.abc';
 import { WhatsappSession } from '../core/abc/session.abc';
 import {
+  DeleteStatusRequest,
   ImageStatus,
   TextStatus,
   VideoStatus,
@@ -64,6 +65,16 @@ class StatusController {
   ) {
     return session.sendVideoStatus(status);
   }
+
+  @Post('delete')
+  @SessionApiParam
+  @ApiOperation({ summary: 'DELETE sent status.' })
+  deleteStatus(
+    @SessionParam session: WhatsappSession,
+    @Body() status: DeleteStatusRequest,
+  ) {
+    return session.deleteStatus(status);
+  }
 }
 
 export { StatusController };

src/api/version.controller.ts

@@ -1,5 +1,10 @@
 import { Controller, Get } from '@nestjs/common';
-import { ApiExtraModels, ApiSecurity, ApiTags } from '@nestjs/swagger';
+import {
+  ApiExtraModels,
+  ApiOperation,
+  ApiSecurity,
+  ApiTags,
+} from '@nestjs/swagger';
 
 import { WAHAEnvironment } from '../structures/environment.dto';
 import { VERSION } from '../version';
@@ -9,6 +14,7 @@ import { VERSION } from '../version';
 @ApiTags('other')
 export class VersionController {
   @Get('')
+  @ApiOperation({ summary: 'Get the version of the server' })
   get(): WAHAEnvironment {
     return VERSION;
   }

src/config.service.ts

@@ -2,9 +2,7 @@ import { Injectable } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
 
 import { parseBool } from './helpers';
-import { WAHAEngine } from './structures/enums.dto';
 import { WebhookConfig } from './structures/webhooks.config.dto';
-import { getEngineName } from './version';
 
 @Injectable()
 export class WhatsappConfigService {
@@ -120,6 +118,14 @@ export class WhatsappConfigService {
     return this.configService.get('WHATSAPP_API_KEY', '');
   }
 
+  getExcludedPaths(): string[] {
+    const value = this.configService.get('WHATSAPP_API_KEY_EXCLUDE_PATH', '');
+    if (!value) {
+      return [];
+    }
+    return value.split(',');
+  }
+
   getHealthMediaFilesThreshold(): number {
     return this.configService.get<number>(
       'WHATSAPP_HEALTH_MEDIA_FILES_THRESHOLD_MB',

src/core/SwaggerConfiguratorCore.ts

@@ -1,13 +1,18 @@
 import { INestApplication } from '@nestjs/common';
 import { DocumentBuilder, OpenAPIObject, SwaggerModule } from '@nestjs/swagger';
 import { DECORATORS } from '@nestjs/swagger/dist/constants';
+import { Logger } from 'nestjs-pino';
 
 import { WhatsappConfigService } from '../config.service';
 import { VERSION } from '../version';
 import { SwaggerConfigServiceCore } from './config/SwaggerConfigServiceCore';
 
 export class SwaggerConfiguratorCore {
-  constructor(protected app: INestApplication) {}
+  protected logger: any;
+
+  constructor(protected app: INestApplication) {
+    this.logger = app.get(Logger);
+  }
 
   get title() {
     return 'WAHA - WhatsApp HTTP API';
@@ -21,11 +26,11 @@ export class SwaggerConfiguratorCore {
       '<ul>' +
       '<li><a href="https://waha.devlike.pro/" target="_blank">Documentation</a></li>' +
       '<li><a href="https://waha.devlike.pro/docs/how-to/engines/#features" target="_blank">Supported features in engines</a></li>' +
-      '<li><a href="https://github.com/devlikeapro/whatsapp-http-api" target="_blank">GitHub - WAHA Core</a></li>' +
-      '<li><a href="https://github.com/devlikeapro/whatsapp-http-api-plu' + // Separate line to pass pre-commit check
+      '<li><a href="https://github.com/devlikeapro/waha" target="_blank">GitHub - WAHA Core</a></li>' +
+      '<li><a href="https://github.com/devlikeapro/waha-plu' + // Separate line to pass pre-commit check
       's" target="_blank">GitHub - WAHA Plus</a></li>' +
-      '<li><b>NEW!</b> - <a href="/dashboard">WAHA Dashboard</a></li>' +
-      '<li><b>NEW!</b> - <a href="https://waha.devlike.pro/docs/how-to/waha-dashboard">WAHA Dashboard Documentation</a></li>' +
+      '<li><a href="/dashboard">WAHA Dashboard</a></li>' +
+      '<li><a href="https://waha.devlike.pro/docs/how-to/waha-dashboard">WAHA Dashboard Documentation</a></li>' +
       '</ul>' +
       '<p>Support the project and get WAHA Plus version!</p>' +
       '<ul>' +
@@ -55,6 +60,7 @@ export class SwaggerConfiguratorCore {
       .addTag('auth', 'Authentication')
       .addTag('screenshot', 'Get screenshot of WhatsApp and show QR code')
       .addTag('chatting', 'Chatting methods')
+      .addTag('channels', 'Channels (newsletters) methods')
       .addTag(
         'status',
         'Status (aka stories) methods. <b>NOWEB</b> engine only!',
@@ -68,6 +74,10 @@ export class SwaggerConfiguratorCore {
       )
       .addTag('groups', `Groups methods.<br>`)
       .addTag('presence', `Presence information`)
+      .addTag(
+        'labels',
+        'Labels - available only for WhatsApp Business accounts',
+      )
       .addTag('other', 'Other methods')
       .addApiKey({
         type: 'apiKey',

src/core/abc/DataStore.ts

@@ -1 +1,3 @@
-export abstract class DataStore {}
+export abstract class DataStore {
+  abstract init(sessionName?: string): Promise<void>;
+}

src/core/abc/manager.abc.ts

@@ -1,7 +1,14 @@
-import { OnApplicationShutdown } from '@nestjs/common';
-
-import { WAHAEngine } from '../../structures/enums.dto';
 import {
+  BeforeApplicationShutdown,
+  OnApplicationShutdown,
+} from '@nestjs/common';
+import { WAHAWebhook } from '@waha/structures/webhooks.dto';
+import { VERSION } from '@waha/version';
+import { EventEmitter } from 'events';
+
+import { WAHAEngine, WAHAEvents } from '../../structures/enums.dto';
+import {
+  MeInfo,
   SessionDTO,
   SessionInfo,
   SessionLogoutRequest,
@@ -13,10 +20,11 @@ import { ISessionConfigRepository } from '../storage/ISessionConfigRepository';
 import { WhatsappSession } from './session.abc';
 import { WebhookConductor } from './webhooks.abc';
 
-export abstract class SessionManager implements OnApplicationShutdown {
+export abstract class SessionManager implements BeforeApplicationShutdown {
   public store: any;
   public sessionAuthRepository: ISessionAuthRepository;
   public sessionConfigRepository: ISessionConfigRepository;
+  public events: EventEmitter;
 
   protected abstract getEngine(engine: WAHAEngine): typeof WhatsappSession;
 
@@ -24,7 +32,7 @@ export abstract class SessionManager implements OnApplicationShutdown {
 
   protected abstract get WebhookConductorClass(): typeof WebhookConductor;
 
-  abstract onApplicationShutdown(signal?: string);
+  abstract beforeApplicationShutdown(signal?: string);
 
   //
   // API Methods
@@ -40,4 +48,19 @@ export abstract class SessionManager implements OnApplicationShutdown {
   abstract getSessionInfo(name: string): Promise<SessionInfo | null>;
 
   abstract getSessions(all: boolean): Promise<SessionInfo[]>;
+
+  handleSessionEvent(event: WAHAEvents, session: WhatsappSession) {
+    return (payload: any) => {
+      const me = session.getSessionMeInfo();
+      const data: WAHAWebhook = {
+        event: event,
+        session: session.name,
+        me: me,
+        payload: payload,
+        engine: session.engine,
+        environment: VERSION,
+      };
+      this.events.emit(event, data);
+    };
+  }
 }

src/core/abc/session.abc.ts

@@ -1,6 +1,14 @@
-import { ConsoleLogger } from '@nestjs/common';
+import {
+  Channel,
+  CreateChannelRequest,
+  ListChannelsQuery,
+} from '@waha/structures/channels.dto';
+import { GetChatsQuery } from '@waha/structures/chats.dto';
+import { Label, LabelID } from '@waha/structures/labels.dto';
+import { LoggerBuilder } from '@waha/utils/logging';
 import { EventEmitter } from 'events';
 import * as fs from 'fs';
+import { Logger } from 'pino';
 import { MessageId } from 'whatsapp-web.js';
 
 import {
@@ -40,6 +48,7 @@ import {
   SessionConfig,
 } from '../../structures/sessions.dto';
 import {
+  DeleteStatusRequest,
   ImageStatus,
   TextStatus,
   VideoStatus,
@@ -74,14 +83,13 @@ export function ensureSuffix(phone) {
 
 export enum WAHAInternalEvent {
   ENGINE_START = 'engine.start',
-  SESSION_STATUS_CHANGED = 'session.status.changed',
 }
 
 export interface SessionParams {
   name: string;
   printQR: boolean;
   mediaManager: MediaManager;
-  log: ConsoleLogger;
+  loggerBuilder: LoggerBuilder;
   sessionStore: DataStore;
   proxyConfig?: ProxyConfig;
   sessionConfig?: SessionConfig;
@@ -94,7 +102,8 @@ export abstract class WhatsappSession {
 
   public name: string;
   protected mediaManager: MediaManager;
-  protected log: ConsoleLogger;
+  public loggerBuilder: LoggerBuilder;
+  protected logger: Logger;
   protected sessionStore: DataStore;
   protected proxyConfig?: ProxyConfig;
   public sessionConfig?: SessionConfig;
@@ -106,7 +115,7 @@ export abstract class WhatsappSession {
   public constructor({
     name,
     printQR,
-    log,
+    loggerBuilder,
     sessionStore,
     proxyConfig,
     mediaManager,
@@ -116,7 +125,8 @@ export abstract class WhatsappSession {
     this.events = new EventEmitter();
     this.name = name;
     this.proxyConfig = proxyConfig;
-    this.log = log;
+    this.loggerBuilder = loggerBuilder;
+    this.logger = loggerBuilder.child({ name: 'WhatsappSession' });
     this.sessionStore = sessionStore;
     this.mediaManager = mediaManager;
     this.sessionConfig = sessionConfig;
@@ -126,7 +136,8 @@ export abstract class WhatsappSession {
 
   protected set status(value: WAHASessionStatus) {
     this._status = value;
-    this.events.emit(WAHAInternalEvent.SESSION_STATUS_CHANGED, value);
+    const body: WASessionStatusBody = { name: this.name, status: value };
+    this.events.emit(WAHAEvents.SESSION_STATUS, body);
   }
 
   public get status() {
@@ -168,7 +179,7 @@ export abstract class WhatsappSession {
   }
 
   protected isDebugEnabled() {
-    return this.log.isLevelEnabled('debug');
+    return this.logger.isLevelEnabled('debug');
   }
 
   /** Start the session */
@@ -184,10 +195,7 @@ export abstract class WhatsappSession {
   ): boolean {
     switch (hook) {
       case WAHAEvents.SESSION_STATUS:
-        this.events.on(WAHAInternalEvent.SESSION_STATUS_CHANGED, (value) => {
-          const body: WASessionStatusBody = { name: this.name, status: value };
-          handler(body);
-        });
+        this.events.on(WAHAEvents.SESSION_STATUS, handler);
         return true;
       default:
         return false;
@@ -221,8 +229,8 @@ export abstract class WhatsappSession {
 
   abstract getScreenshot(): Promise<Buffer>;
 
-  public getSessionMeInfo(): Promise<MeInfo | null> {
-    throw new NotImplementedByEngineError();
+  public getSessionMeInfo(): MeInfo | null {
+    return null;
   }
 
   public getCaptcha(): Promise<QR> {
@@ -285,7 +293,7 @@ export abstract class WhatsappSession {
   /**
    * Chats methods
    */
-  public getChats() {
+  public getChats(query: GetChatsQuery) {
     throw new NotImplementedByEngineError();
   }
 
@@ -317,6 +325,34 @@ export abstract class WhatsappSession {
     throw new NotImplementedByEngineError();
   }
 
+  public chatsArchiveChat(chatId: string): Promise<any> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public chatsUnarchiveChat(chatId: string): Promise<any> {
+    throw new NotImplementedByEngineError();
+  }
+
+  /**
+   * Labels methods
+   */
+
+  public getLabels(): Promise<Label[]> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public getChatsByLabelId(labelId: string) {
+    throw new NotImplementedByEngineError();
+  }
+
+  public getChatLabels(chatId: string): Promise<Label[]> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public putLabelsToChat(chatId: string, labels: LabelID[]) {
+    throw new NotImplementedByEngineError();
+  }
+
   /**
    * Contacts methods
    */
@@ -435,6 +471,47 @@ export abstract class WhatsappSession {
     throw new NotImplementedByEngineError();
   }
 
+  /**
+   * Channels methods
+   */
+  public channelsList(query: ListChannelsQuery): Promise<Channel[]> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsCreateChannel(
+    request: CreateChannelRequest,
+  ): Promise<Channel> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsGetChannel(id: string): Promise<Channel> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsGetChannelByInviteCode(inviteCode: string): Promise<Channel> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsDeleteChannel(id: string): Promise<void> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsFollowChannel(id: string): Promise<void> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsUnfollowChannel(id: string): Promise<void> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsMuteChannel(id: string): Promise<void> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsUnmuteChannel(id: string): Promise<void> {
+    throw new NotImplementedByEngineError();
+  }
+
   /**
    * Status methods
    */
@@ -454,6 +531,10 @@ export abstract class WhatsappSession {
     throw new NotImplementedByEngineError();
   }
 
+  public deleteStatus(request: DeleteStatusRequest) {
+    throw new NotImplementedByEngineError();
+  }
+
   public async getEngineInfo(): Promise<any> {
     return {};
   }
@@ -485,14 +566,22 @@ export abstract class WhatsappSession {
       return;
     }
     if (!qr.raw) {
-      this.log.error(
+      this.logger.error(
         'QR.raw is not available, can not print it in the console',
       );
       return;
     }
-    this.log.log(
+    this.logger.info(
       "You can disable QR in console by setting 'WAHA_PRINT_QR=false' in your environment variables.",
     );
     qrcode.generate(qr.raw, { small: true });
   }
 }
+
+export function isNewsletter(jid: string) {
+  return jid.endsWith('@newsletter');
+}
+
+export function getChannelInviteLink(code: string) {
+  return `https://whatsapp.com/channel/${code}`;
+}

src/core/abc/webhooks.abc.ts

@@ -1,15 +1,19 @@
-import { ConsoleLogger } from '@nestjs/common';
+import { LoggerBuilder } from '@waha/utils/logging';
+import { Logger } from 'pino';
 
 import { WebhookConfig } from '../../structures/webhooks.config.dto';
 import { WhatsappSession } from './session.abc';
 
 export abstract class WebhookSender {
   protected url: string;
+  protected logger: Logger;
+
   constructor(
-    protected log: ConsoleLogger,
+    loggerBuilder: LoggerBuilder,
     protected webhookConfig: WebhookConfig,
   ) {
     this.url = webhookConfig.url;
+    this.logger = loggerBuilder.child({ name: WebhookSender.name });
   }
 
   abstract send(json);

src/core/api/websocket.gateway.core.ts

@@ -0,0 +1,138 @@
+import {
+  BeforeApplicationShutdown,
+  ConsoleLogger,
+  Logger,
+  LoggerService,
+} from '@nestjs/common';
+import { sleep } from '@nestjs/terminus/dist/utils';
+import {
+  OnGatewayConnection,
+  OnGatewayDisconnect,
+  OnGatewayInit,
+  WebSocketGateway,
+  WebSocketServer,
+} from '@nestjs/websockets';
+import { SessionManager } from '@waha/core/abc/manager.abc';
+import { WAHAEvents } from '@waha/structures/enums.dto';
+import { WebsocketHeartbeatJob } from '@waha/utils/WebsocketHeartbeatJob';
+import { WebSocket } from '@waha/utils/ws';
+import { IncomingMessage } from 'http';
+import * as lodash from 'lodash';
+import * as url from 'url';
+import { Server } from 'ws';
+
+@WebSocketGateway({
+  path: '/ws',
+  cors: true,
+})
+export class WebsocketGatewayCore
+  implements
+    OnGatewayInit,
+    OnGatewayConnection,
+    OnGatewayDisconnect,
+    BeforeApplicationShutdown
+{
+  HEARTBEAT_INTERVAL = 10_000;
+
+  @WebSocketServer()
+  server: Server;
+
+  private listeners: Map<WebSocket, { session: string; events: string[] }> =
+    new Map();
+
+  private readonly logger: LoggerService;
+  private heartbeat: WebsocketHeartbeatJob;
+
+  constructor(private manager: SessionManager) {
+    this.logger = new Logger('WebsocketGateway');
+    this.heartbeat = new WebsocketHeartbeatJob(
+      this.logger,
+      this.HEARTBEAT_INTERVAL,
+    );
+  }
+
+  handleConnection(socket: WebSocket, request: IncomingMessage, ...args): any {
+    const random = Math.random().toString(36).substring(7);
+    const id = `wsc_${random}`;
+    socket.id = id;
+    this.logger.debug(`New client connected: ${request.url}`);
+    const params = this.getParams(id, request, socket);
+    if (!params) {
+      return;
+    }
+    const { session, events } = params;
+    this.logger.debug(
+      `Client connected to session: '${session}', events: ${events}, ${id}`,
+    );
+    this.listeners.set(socket, { session, events });
+  }
+
+  private getParams(id: string, request: IncomingMessage, socket: WebSocket) {
+    const query = url.parse(request.url, true).query;
+    const session = (query.session as string) || '*';
+    if (session !== '*') {
+      this.logger.warn(
+        `Only connecting to all sessions is allowed for now, use session=*, ${id}`,
+      );
+      const error =
+        'Only connecting to all sessions is allowed for now, use session=*';
+      socket.close(4001, JSON.stringify({ error }));
+      return null;
+    }
+
+    const events = ((query.events as string) || '*').split(',');
+    if (
+      !lodash.isEqual(events, ['*']) &&
+      !lodash.isEqual(events, [WAHAEvents.SESSION_STATUS])
+    ) {
+      this.logger.warn(
+        `Only \'session.status\' event is allowed for now, use events=session.status or events=*, ${id}`,
+      );
+      const error =
+        "Only 'session.status' event is allowed for now, use events=session.status or events=*";
+      socket.close(4001, JSON.stringify({ error }));
+      return null;
+    }
+    return { session, events };
+  }
+
+  handleDisconnect(socket: WebSocket): any {
+    this.logger.debug(`Client disconnected - ${socket.id}`);
+    this.listeners.delete(socket);
+  }
+
+  async beforeApplicationShutdown(signal?: string) {
+    this.logger.log('Shutting down websocket server');
+    // Allow pending messages to be sent, it can be even 1ms, just to release the event loop
+    await sleep(100);
+    this.server.clients.forEach((options, client) => {
+      client.close(1001, 'Server is shutting down');
+    });
+    // Do not turn off heartbeat service here,
+    // it's responsible for terminating the connection that is not alive
+    this.logger.log('Websocket server is down');
+  }
+
+  afterInit(server: Server) {
+    this.logger.debug('Websocket server initialized');
+    this.manager.events.on(
+      WAHAEvents.SESSION_STATUS,
+      this.sendToAll.bind(this),
+    );
+    this.logger.debug('Subscribed to manager events');
+
+    this.logger.debug('Starting heartbeat service...');
+    this.heartbeat.start(server);
+    this.logger.debug('Heartbeat service started');
+  }
+
+  sendToAll(data: any) {
+    this.listeners.forEach((options, client) => {
+      if (options.events.length === 0) {
+        return;
+      }
+      this.logger.debug('Sending data to client', data);
+      client.send(JSON.stringify(data));
+    });
+  }
+}

src/core/app.module.core.ts

@@ -1,9 +1,20 @@
-import { ConsoleLogger, Module } from '@nestjs/common';
+import { ConsoleLogger, INestApplication, Module } from '@nestjs/common';
 import { ConfigModule } from '@nestjs/config';
+import { APP_INTERCEPTOR } from '@nestjs/core';
 import { PassportModule } from '@nestjs/passport';
 import { ServeStaticModule } from '@nestjs/serve-static';
 import { TerminusModule } from '@nestjs/terminus';
+import { BufferJsonReplacerInterceptor } from '@waha/api/BufferJsonReplacerInterceptor';
+import { ChannelsController } from '@waha/api/channels.controller';
+import { WebsocketGatewayCore } from '@waha/core/api/websocket.gateway.core';
+import {
+  getPinoHttpUseLevel,
+  getPinoLogLevel,
+  getPinoTransport,
+} from '@waha/utils/logging';
+import { LoggerModule } from 'nestjs-pino';
 import { join } from 'path';
+import { Logger } from 'pino';
 
 import { AuthController } from '../api/auth.controller';
 import { ChatsController } from '../api/chats.controller';
@@ -11,6 +22,8 @@ import { ChattingController } from '../api/chatting.controller';
 import { ContactsController } from '../api/contacts.controller';
 import { GroupsController } from '../api/groups.controller';
 import { HealthController } from '../api/health.controller';
+import { LabelsController } from '../api/labels.controller';
+import { PingController } from '../api/ping.controller';
 import { PresenceController } from '../api/presence.controller';
 import { ScreenshotController } from '../api/screenshot.controller';
 import {
@@ -29,6 +42,32 @@ import { WAHAHealthCheckServiceCore } from './health/WAHAHealthCheckServiceCore'
 import { SessionManagerCore } from './manager.core';
 
 export const IMPORTS = [
+  LoggerModule.forRoot({
+    renameContext: 'name',
+    pinoHttp: {
+      quietReqLogger: true,
+      level: getPinoLogLevel(),
+      useLevel: getPinoHttpUseLevel(),
+      transport: getPinoTransport(),
+      autoLogging: {
+        ignore: (req) => {
+          return req.url.startsWith('/dashboard/');
+        },
+      },
+      serializers: {
+        req: (req) => ({
+          id: req.id,
+          method: req.method,
+          url: req.url,
+          query: req.query,
+          params: req.params,
+        }),
+        res: (res) => ({
+          statusCode: res.statusCode,
+        }),
+      },
+    },
+  }),
   ConfigModule.forRoot({
     isGlobal: true,
   }),
@@ -65,13 +104,16 @@ export const CONTROLLERS = [
   SessionController,
   ChattingController,
   ChatsController,
+  ChannelsController,
   StatusController,
+  LabelsController,
   ContactsController,
   GroupsController,
   PresenceController,
   ScreenshotController,
   VersionController,
   HealthController,
+  PingController,
 ];
 const PROVIDERS = [
   {
@@ -82,11 +124,16 @@ const PROVIDERS = [
     provide: WAHAHealthCheckService,
     useClass: WAHAHealthCheckServiceCore,
   },
+  {
+    provide: APP_INTERCEPTOR,
+    useClass: BufferJsonReplacerInterceptor,
+  },
   DashboardConfigServiceCore,
   SwaggerConfigServiceCore,
   WhatsappConfigService,
   EngineConfigService,
   ConsoleLogger,
+  WebsocketGatewayCore,
 ];
 
 @Module({
@@ -96,4 +143,12 @@ const PROVIDERS = [
 })
 export class AppModuleCore {
   constructor(protected config: WhatsappConfigService) {}
+
+  static getHttpsOptions(logger: Logger) {
+    return undefined;
+  }
+
+  static appReady(app: INestApplication, logger: Logger) {
+    return;
+  }
 }

src/core/config/DashboardConfigServiceCore.ts

@@ -1,5 +1,6 @@
-import { Injectable } from '@nestjs/common';
+import { Injectable, Logger } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
+import { InjectPinoLogger, PinoLogger } from 'nestjs-pino';
 
 import { parseBool } from '../../helpers';
 
@@ -7,7 +8,11 @@ import { parseBool } from '../../helpers';
 export class DashboardConfigServiceCore {
   public dashboardUri = '/dashboard';
 
-  constructor(protected configService: ConfigService) {}
+  constructor(
+    protected configService: ConfigService,
+    @InjectPinoLogger('DashboardConfigService')
+    protected logger: PinoLogger,
+  ) {}
 
   get enabled(): boolean {
     const value = this.configService.get('WAHA_DASHBOARD_ENABLED', 'true');

src/core/config/EngineConfigService.ts

@@ -1,4 +1,4 @@
-import { Injectable } from '@nestjs/common';
+import { Injectable, Logger } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
 
 import { parseBool } from '../../helpers';
@@ -7,14 +7,18 @@ import { getEngineName } from '../../version';
 
 @Injectable()
 export class EngineConfigService {
-  constructor(protected configService: ConfigService) {}
+  private logger: Logger;
+
+  constructor(protected configService: ConfigService) {
+    this.logger = new Logger('EngineConfigService');
+  }
 
   getDefaultEngineName(): WAHAEngine {
     const value = getEngineName();
     if (value in WAHAEngine) {
       return WAHAEngine[value];
     }
-    console.log(
+    this.logger.warn(
       `Unknown WhatsApp default engine WHATSAPP_DEFAULT_ENGINE=${value}. Using WEBJS`,
     );
     return WAHAEngine.WEBJS;

src/core/config/SwaggerConfigServiceCore.ts

@@ -1,11 +1,16 @@
 import { Injectable } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
+import { InjectPinoLogger, PinoLogger } from 'nestjs-pino';
 
 import { parseBool } from '../../helpers';
 
 @Injectable()
 export class SwaggerConfigServiceCore {
-  constructor(protected configService: ConfigService) {}
+  constructor(
+    protected configService: ConfigService,
+    @InjectPinoLogger('SwaggerConfigService')
+    protected logger: PinoLogger,
+  ) {}
 
   get advancedConfigEnabled(): boolean {
     const value = this.configService.get(

src/core/engines/noweb/store/IChatRepository.ts

@@ -0,0 +1,17 @@
+import { Chat } from '@adiwajshing/baileys';
+
+export interface IChatRepository {
+  getAll(): Promise<Chat[]>;
+
+  getAllByIds(ids: string[]): Promise<Chat[]>;
+
+  getAllWithMessages(limit?: number, offset?: number): Promise<Chat[]>;
+
+  getById(id: string): Promise<Chat | null>;
+
+  deleteAll(): Promise<void>;
+
+  deleteById(id: string): Promise<void>;
+
+  save(chat: Chat): Promise<void>;
+}

src/core/engines/noweb/store/IContactRepository.ts

@@ -0,0 +1,13 @@
+import { Contact } from '@adiwajshing/baileys';
+
+export interface IContactRepository {
+  getAll(): Promise<Contact[]>;
+
+  getById(id: string): Promise<Contact | null>;
+
+  deleteAll(): Promise<void>;
+
+  deleteById(id: string): Promise<void>;
+
+  save(contact: Contact): Promise<void>;
+}

src/core/engines/noweb/store/ILabelAssociationsRepository.ts

@@ -0,0 +1,19 @@
+import {
+  LabelAssociation,
+  LabelAssociationType,
+} from '@adiwajshing/baileys/lib/Types/LabelAssociation';
+
+export interface ILabelAssociationRepository {
+  deleteOne(association: LabelAssociation): Promise<void>;
+
+  save(association: LabelAssociation): Promise<void>;
+
+  deleteByLabelId(labelId: string): Promise<void>;
+
+  getAssociationsByLabelId(
+    labelId: string,
+    type: LabelAssociationType,
+  ): Promise<LabelAssociation[]>;
+
+  getAssociationsByChatId(chatId: string): Promise<LabelAssociation[]>;
+}

src/core/engines/noweb/store/ILabelsRepository.ts

@@ -0,0 +1,14 @@
+import { Contact } from '@adiwajshing/baileys';
+import { Label } from '@adiwajshing/baileys/lib/Types/Label';
+
+export interface ILabelsRepository {
+  getById(id: string): Promise<Label | null>;
+
+  getAll(): Promise<Label[]>;
+
+  getAllByIds(ids: string[]): Promise<Label[]>;
+
+  deleteById(id: string): Promise<void>;
+
+  save(label: Label): Promise<void>;
+}

src/core/engines/noweb/store/IMessagesRepository.ts

@@ -0,0 +1,17 @@
+export interface IMessagesRepository {
+  deleteAll(): Promise<void>;
+
+  upsert(messages: any[]): Promise<void>;
+
+  upsertOne(message: any): Promise<void>;
+
+  getAllByJid(jid: string, limit: number): Promise<any[]>;
+
+  getByJidById(jid: string, id: string): Promise<any | null>;
+
+  updateByJidAndId(jid: string, id: string, update: any): Promise<boolean>;
+
+  deleteByJidByIds(jid: string, ids: string[]): Promise<void>;
+
+  deleteAllByJid(jid: string): Promise<void>;
+}

src/core/engines/noweb/store/INowebStorage.ts

@@ -0,0 +1,40 @@
+import { WAMessage } from '@adiwajshing/baileys';
+import { LabelAssociation } from '@adiwajshing/baileys/lib/Types/LabelAssociation';
+import { ILabelAssociationRepository } from '@waha/core/engines/noweb/store/ILabelAssociationsRepository';
+import { ILabelsRepository } from '@waha/core/engines/noweb/store/ILabelsRepository';
+
+import { IChatRepository } from './IChatRepository';
+import { IContactRepository } from './IContactRepository';
+import { IMessagesRepository } from './IMessagesRepository';
+
+export abstract class INowebStorage {
+  abstract init(): Promise<void>;
+
+  abstract close(): Promise<void>;
+
+  abstract getContactsRepository(): IContactRepository;
+
+  abstract getChatRepository(): IChatRepository;
+
+  abstract getMessagesRepository(): IMessagesRepository;
+
+  abstract getLabelsRepository(): ILabelsRepository;
+
+  abstract getLabelAssociationRepository(): ILabelAssociationRepository;
+
+  protected getMessagesMetadata(): Map<string, any> {
+    return new Map()
+      .set('jid', (msg: WAMessage) => msg.key.remoteJid)
+      .set('id', (msg: WAMessage) => msg.key.id)
+      .set('messageTimestamp', (msg: WAMessage) => msg.messageTimestamp);
+  }
+
+  protected getLabelAssociationMetadata() {
+    return new Map().set(
+      'id',
+      (a: LabelAssociation) =>
+        // @ts-ignore
+        `${a.type}_${a.labelId}_${a.chatId}_${a.messageId}`,
+    );
+  }
+}

src/core/engines/noweb/store/INowebStore.ts

@@ -0,0 +1,35 @@
+import {
+  BaileysEventEmitter,
+  Chat,
+  Contact,
+  proto,
+} from '@adiwajshing/baileys';
+import { Label } from '@adiwajshing/baileys/lib/Types/Label';
+
+export interface INowebStore {
+  presences: any;
+
+  init(): Promise<void>;
+
+  close(): Promise<void>;
+
+  bind(ev: BaileysEventEmitter, socket: any): void;
+
+  loadMessage(jid: string, id: string): Promise<proto.IWebMessageInfo>;
+
+  getMessagesByJid(chatId: string, limit: number): Promise<any>;
+
+  getChats(limit?: number, offset?: number): Promise<Chat[]>;
+
+  getContacts(): Promise<Contact[]>;
+
+  getContactById(jid: string): Promise<Contact>;
+
+  getLabels(): Promise<Label[]>;
+
+  getLabelById(labelId: string): Promise<Label | null>;
+
+  getChatsByLabelId(labelId: string): Promise<Chat[]>;
+
+  getChatLabels(chatId: string): Promise<Label[]>;
+}

src/core/engines/noweb/store/NowebInMemoryStore.ts

@@ -0,0 +1,71 @@
+import { Chat, Contact, makeInMemoryStore, proto } from '@adiwajshing/baileys';
+import { Label } from '@adiwajshing/baileys/lib/Types/Label';
+import { BadRequestException, ConsoleLogger } from '@nestjs/common';
+
+import { INowebStore } from './INowebStore';
+
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const logger = require('pino')();
+
+export class NowebInMemoryStore implements INowebStore {
+  private store: ReturnType<typeof makeInMemoryStore>;
+  errorMessage =
+    'Enable NOWEB store "config.noweb.store.enabled=True" and "config.noweb.store.full_sync=True" when starting a new session. ' +
+    'Read more: https://waha.devlike.pro/docs/engines/noweb#store';
+
+  constructor() {
+    this.store = makeInMemoryStore({ logger: logger });
+  }
+
+  init(): Promise<void> {
+    return;
+  }
+
+  close(): Promise<void> {
+    return;
+  }
+
+  get presences() {
+    return this.store.presences;
+  }
+
+  bind(ev: any, socket: any) {
+    this.store.bind(ev);
+  }
+
+  loadMessage(jid: string, id: string): Promise<proto.IWebMessageInfo> {
+    return this.store.loadMessage(jid, id);
+  }
+
+  getMessagesByJid(chatId: string, limit: number): Promise<any> {
+    throw new BadRequestException(this.errorMessage);
+  }
+
+  getChats(limit?: number, offset?: number): Promise<Chat[]> {
+    throw new BadRequestException(this.errorMessage);
+  }
+
+  getContacts(): Promise<Contact[]> {
+    throw new BadRequestException(this.errorMessage);
+  }
+
+  getContactById(jid: string): Promise<Contact> {
+    throw new BadRequestException(this.errorMessage);
+  }
+
+  getLabels(): Promise<Label[]> {
+    throw new BadRequestException(this.errorMessage);
+  }
+
+  getLabelById(labelId: string): Promise<Label | null> {
+    throw new BadRequestException(this.errorMessage);
+  }
+
+  getChatsByLabelId(labelId: string): Promise<Chat[]> {
+    throw new BadRequestException(this.errorMessage);
+  }
+
+  getChatLabels(chatId: string): Promise<Label[]> {
+    throw new BadRequestException(this.errorMessage);
+  }
+}

src/core/engines/noweb/store/NowebPersistentStore.ts

@@ -0,0 +1,365 @@
+import {
+  BaileysEventEmitter,
+  Chat,
+  ChatUpdate,
+  Contact,
+  isRealMessage,
+  jidNormalizedUser,
+  proto,
+  updateMessageWithReaction,
+  updateMessageWithReceipt,
+} from '@adiwajshing/baileys';
+import { Label } from '@adiwajshing/baileys/lib/Types/Label';
+import {
+  LabelAssociation,
+  LabelAssociationType,
+} from '@adiwajshing/baileys/lib/Types/LabelAssociation';
+import { ILabelAssociationRepository } from '@waha/core/engines/noweb/store/ILabelAssociationsRepository';
+import { ILabelsRepository } from '@waha/core/engines/noweb/store/ILabelsRepository';
+import { toNumber } from 'lodash';
+import { Logger } from 'pino';
+
+import { toJID } from '../session.noweb.core';
+import { IChatRepository } from './IChatRepository';
+import { IContactRepository } from './IContactRepository';
+import { IMessagesRepository } from './IMessagesRepository';
+import { INowebStorage } from './INowebStorage';
+import { INowebStore } from './INowebStore';
+
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const AsyncLock = require('async-lock');
+
+export class NowebPersistentStore implements INowebStore {
+  private socket: any;
+  private chatRepo: IChatRepository;
+  private contactRepo: IContactRepository;
+  private messagesRepo: IMessagesRepository;
+  private labelsRepo: ILabelsRepository;
+  private labelAssociationsRepo: ILabelAssociationRepository;
+  public presences: any;
+  private lock: any;
+
+  constructor(
+    private logger: Logger,
+    public storage: INowebStorage,
+  ) {
+    this.socket = null;
+    this.chatRepo = storage.getChatRepository();
+    this.contactRepo = storage.getContactsRepository();
+    this.messagesRepo = storage.getMessagesRepository();
+    this.labelsRepo = storage.getLabelsRepository();
+    this.labelAssociationsRepo = storage.getLabelAssociationRepository();
+    this.presences = {};
+    this.lock = new AsyncLock({ maxPending: Infinity });
+  }
+
+  init(): Promise<void> {
+    return this.storage.init();
+  }
+
+  bind(ev: BaileysEventEmitter, socket: any) {
+    // All
+    ev.on('messaging-history.set', (data) => this.onMessagingHistorySet(data));
+    // Messages
+    ev.on('messages.upsert', (data) =>
+      this.withLock('messages', () => this.onMessagesUpsert(data)),
+    );
+    ev.on('messages.update', (data) =>
+      this.withLock('messages', () => this.onMessageUpdate(data)),
+    );
+    ev.on('messages.delete', (data) =>
+      this.withLock('messages', () => this.onMessageDelete(data)),
+    );
+    ev.on('messages.reaction', (data) =>
+      this.withLock('messages', () => this.onMessageReaction(data)),
+    );
+    ev.on('message-receipt.update', (data) =>
+      this.withLock('messages', () => this.onMessageReceiptUpdate(data)),
+    );
+    // Chats
+    ev.on('chats.upsert', (data) =>
+      this.withLock('chats', () => this.onChatUpsert(data)),
+    );
+    ev.on('chats.update', (data) =>
+      this.withLock('chats', () => this.onChatUpdate(data)),
+    );
+    ev.on('chats.delete', (data) =>
+      this.withLock('chats', () => this.onChatDelete(data)),
+    );
+    // Contacts
+    ev.on('contacts.upsert', (data) =>
+      this.withLock('contacts', () => this.onContactsUpsert(data)),
+    );
+    ev.on('contacts.update', (data) =>
+      this.withLock('contacts', () => this.onContactUpdate(data)),
+    );
+    ev.on('labels.edit', (data) => this.onLabelsEdit(data));
+    ev.on('labels.association', ({ association, type }) =>
+      this.onLabelsAssociation(association, type),
+    );
+    // Presence
+    ev.on('presence.update', (data) => this.onPresenceUpdate(data));
+    this.socket = socket;
+  }
+
+  async close(): Promise<void> {
+    await this.storage?.close().catch((error) => {
+      this.logger.warn(`Failed to close storage: ${error}`);
+    });
+    return;
+  }
+
+  private async onMessagingHistorySet(history) {
+    const { contacts, chats, messages, isLatest } = history;
+    if (isLatest) {
+      this.logger.debug(
+        'history sync - clearing all entities, got latest history',
+      );
+      await Promise.all([
+        this.withLock('contacts', () => this.contactRepo.deleteAll()),
+        this.withLock('chats', () => this.chatRepo.deleteAll()),
+        this.withLock('messages', () => this.messagesRepo.deleteAll()),
+      ]);
+    }
+
+    await Promise.all([
+      this.withLock('contacts', async () => {
+        await this.onContactsUpsert(contacts);
+        this.logger.info(`history sync - '${contacts.length}' synced contacts`);
+      }),
+      this.withLock('chats', () => this.onChatUpsert(chats)),
+      this.withLock('messages', () => this.syncMessagesHistory(messages)),
+    ]);
+  }
+
+  private async syncMessagesHistory(messages) {
+    const realMessages = messages.filter(isRealMessage);
+    await this.messagesRepo.upsert(realMessages);
+    this.logger.info(
+      `history sync - '${messages.length}' got messages, '${realMessages.length}' real messages`,
+    );
+  }
+
+  private async onMessagesUpsert(update) {
+    const { messages, type } = update;
+    if (type !== 'notify' && type !== 'append') {
+      this.logger.debug(`unexpected type for messages.upsert: '${type}'`);
+      return;
+    }
+    const realMessages = messages.filter(isRealMessage);
+    await this.messagesRepo.upsert(realMessages);
+    this.logger.debug(
+      `messages.upsert - ${messages.length} got messages, ${realMessages.length} real messages`,
+    );
+  }
+
+  private async onMessageUpdate(updates) {
+    for (const update of updates) {
+      // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+      const jid = jidNormalizedUser(update.key.remoteJid!);
+      const message = await this.messagesRepo.getByJidById(jid, update.key.id);
+      if (!message) {
+        continue;
+      }
+      const fields = { ...update.update };
+      // It can overwrite the key, so we need to delete it
+      delete fields['key'];
+      Object.assign(message, fields);
+      // In case of revoked messages - remove it
+      // TODO: May be we should save the flag instead of completely removing the message
+      const isYetRealMessage =
+        isRealMessage(message, this.socket?.authState?.creds?.me?.id) || false;
+      if (isYetRealMessage) {
+        await this.messagesRepo.upsertOne(message);
+      } else {
+        await this.messagesRepo.deleteByJidByIds(jid, [update.key.id]);
+      }
+    }
+  }
+
+  private async onMessageDelete(item) {
+    if ('all' in item) {
+      await this.messagesRepo.deleteAllByJid(item.jid);
+      return;
+    }
+    const jid = jidNormalizedUser(item.keys[0].remoteJid);
+    const ids = item.keys.map((key) => key.id);
+    await this.messagesRepo.deleteByJidByIds(jid, ids);
+  }
+
+  private async onChatUpsert(chats: Chat[]) {
+    for (const chat of chats) {
+      delete chat['messages'];
+      chat.conversationTimestamp = toNumber(chat.conversationTimestamp);
+      await this.chatRepo.save(chat);
+    }
+    this.logger.info(`history sync - '${chats.length}' synced chats`);
+  }
+
+  private async onChatUpdate(updates: ChatUpdate[]) {
+    for (const update of updates) {
+      const chat = (await this.chatRepo.getById(update.id)) || ({} as Chat);
+      Object.assign(chat, update);
+      chat.conversationTimestamp = toNumber(chat.conversationTimestamp);
+      delete chat['messages'];
+      await this.chatRepo.save(chat);
+    }
+  }
+
+  private async onChatDelete(ids: string[]) {
+    for (const id of ids) {
+      await this.chatRepo.deleteById(id);
+      await this.messagesRepo.deleteAllByJid(id);
+    }
+  }
+
+  private withLock(key, fn) {
+    return this.lock.acquire(key, fn);
+  }
+
+  private async onContactsUpsert(contacts: Contact[]) {
+    for (const update of contacts) {
+      const contact = await this.contactRepo.getById(update.id);
+      // remove undefined from data
+      Object.keys(update).forEach(
+        (key) => update[key] === undefined && delete update[key],
+      );
+      const result = { ...(contact || {}), ...update };
+      await this.contactRepo.save(result);
+    }
+  }
+
+  private async onContactUpdate(updates: Partial<Contact>[]) {
+    for (const update of updates) {
+      const contact = await this.contactRepo.getById(update.id);
+
+      if (!contact) {
+        this.logger.warn(
+          `got update for non-existent contact. update: '${JSON.stringify(
+            update,
+          )}'`,
+        );
+        continue;
+        // TODO: Find contact by hash if not found
+        //  find contact by attrs.hash, when user is not saved as a contact
+        //  check the in-memory for that
+      }
+      Object.assign(contact, update);
+
+      if (update.imgUrl === 'changed') {
+        contact.imgUrl = this.socket
+          ? await this.socket?.profilePictureUrl(contact.id)
+          : undefined;
+      } else if (update.imgUrl === 'removed') {
+        delete contact.imgUrl;
+      }
+      await this.onContactsUpsert([contact]);
+    }
+  }
+
+  private async onMessageReaction(reactions) {
+    for (const { key, reaction } of reactions) {
+      const msg = await this.messagesRepo.getByJidById(key.remoteJid, key.id);
+      if (!msg) {
+        this.logger.warn(
+          `got reaction update for non-existent message. key: '${JSON.stringify(
+            key,
+          )}'`,
+        );
+        continue;
+      }
+      updateMessageWithReaction(msg, reaction);
+      await this.messagesRepo.upsertOne(msg);
+    }
+  }
+
+  private async onMessageReceiptUpdate(updates) {
+    for (const { key, receipt } of updates) {
+      const msg = await this.messagesRepo.getByJidById(key.remoteJid, key.id);
+      if (!msg) {
+        this.logger.warn(
+          `got receipt update for non-existent message. key: '${JSON.stringify(
+            key,
+          )}'`,
+        );
+        continue;
+      }
+      updateMessageWithReceipt(msg, receipt);
+      await this.messagesRepo.upsertOne(msg);
+    }
+  }
+
+  private async onLabelsEdit(label: Label) {
+    if (label.deleted) {
+      await this.labelsRepo.deleteById(label.id);
+      await this.labelAssociationsRepo.deleteByLabelId(label.id);
+    } else {
+      await this.labelsRepo.save(label);
+    }
+  }
+
+  private async onLabelsAssociation(
+    association: LabelAssociation,
+    type: 'add' | 'remove',
+  ) {
+    if (type === 'remove') {
+      await this.labelAssociationsRepo.deleteOne(association);
+    } else {
+      await this.labelAssociationsRepo.save(association);
+    }
+  }
+
+  private async onPresenceUpdate({ id, presences: update }) {
+    this.presences[id] = this.presences[id] || {};
+    Object.assign(this.presences[id], update);
+  }
+
+  async loadMessage(jid: string, id: string) {
+    const data = await this.messagesRepo.getByJidById(jid, id);
+    if (!data) {
+      return null;
+    }
+    return proto.WebMessageInfo.fromObject(data);
+  }
+
+  getMessagesByJid(chatId: string, limit: number) {
+    return this.messagesRepo.getAllByJid(toJID(chatId), toNumber(limit));
+  }
+
+  getChats(limit?: number, offset?: number): Promise<Chat[]> {
+    return this.chatRepo.getAllWithMessages(limit, offset);
+  }
+
+  getContactById(jid) {
+    return this.contactRepo.getById(jid);
+  }
+
+  getContacts() {
+    return this.contactRepo.getAll();
+  }
+
+  getLabels(): Promise<Label[]> {
+    return this.labelsRepo.getAll();
+  }
+
+  getLabelById(labelId: string): Promise<Label | null> {
+    return this.labelsRepo.getById(labelId);
+  }
+
+  async getChatsByLabelId(labelId: string): Promise<Chat[]> {
+    const associations =
+      await this.labelAssociationsRepo.getAssociationsByLabelId(
+        labelId,
+        LabelAssociationType.Chat,
+      );
+    const ids = associations.map((association) => association.chatId);
+    return await this.chatRepo.getAllByIds(ids);
+  }
+
+  async getChatLabels(chatId: string): Promise<Label[]> {
+    const associations =
+      await this.labelAssociationsRepo.getAssociationsByChatId(chatId);
+    const ids = associations.map((association) => association.labelId);
+    return await this.labelsRepo.getAllByIds(ids);
+  }
+}

src/core/engines/noweb/store/NowebStorageFactoryCore.ts

@@ -0,0 +1,9 @@
+import { DataStore } from '../../../abc/DataStore';
+import { INowebStorage } from './INowebStorage';
+import { Sqlite3Storage } from './sqlite3/Sqlite3Storage';
+
+export class NowebStorageFactoryCore {
+  createStorage(store: DataStore, name: string): INowebStorage {
+    return new Sqlite3Storage(':memory:');
+  }
+}

src/core/engines/noweb/store/Schema.ts

@@ -0,0 +1,78 @@
+export class Field {
+  constructor(
+    public fieldName: string,
+    public type: string,
+  ) {}
+}
+
+export class Index {
+  constructor(
+    public name: string,
+    public columns: string[],
+  ) {}
+}
+
+export class Schema {
+  constructor(
+    public name: string,
+    public columns: Field[],
+    public indexes: Index[],
+  ) {}
+}
+
+export const NOWEB_STORE_SCHEMA = [
+  new Schema(
+    'contacts',
+    [new Field('id', 'TEXT'), new Field('data', 'TEXT')],
+    [new Index('contacts_id_index', ['id'])],
+  ),
+  new Schema(
+    'chats',
+    [
+      new Field('id', 'TEXT'),
+      new Field('conversationTimestamp', 'INTEGER'),
+      new Field('data', 'TEXT'),
+    ],
+    [
+      new Index('chats_id_index', ['id']),
+      new Index('chats_conversationTimestamp_index', ['conversationTimestamp']),
+    ],
+  ),
+  new Schema(
+    'messages',
+    [
+      new Field('jid', 'TEXT'),
+      new Field('id', 'TEXT'),
+      new Field('messageTimestamp', 'INTEGER'),
+      new Field('data', 'TEXT'),
+    ],
+    [
+      new Index('messages_id_index', ['id']),
+      new Index('messages_jid_id_index', ['jid', 'id']),
+      new Index('messages_jid_timestamp_index', ['jid', 'messageTimestamp']),
+      new Index('timestamp_index', ['messageTimestamp']),
+    ],
+  ),
+  new Schema(
+    'labels',
+    [new Field('id', 'TEXT'), new Field('data', 'TEXT')],
+    [new Index('labels_id_index', ['id'])],
+  ),
+  new Schema(
+    'labelAssociations',
+    [
+      new Field('id', 'TEXT'),
+      new Field('type', 'TEXT'),
+      new Field('labelId', 'TEXT'),
+      new Field('chatId', 'TEXT'),
+      new Field('messageId', 'TEXT'),
+      new Field('data', 'TEXT'),
+    ],
+    [
+      new Index('label_assoc_id_index', ['id']),
+      new Index('label_assoc_type_label_index', ['type', 'labelId']),
+      new Index('label_assoc_type_chat_index', ['type', 'chatId']),
+      new Index('label_assoc_type_message_index', ['type', 'messageId']),
+    ],
+  ),
+];

src/core/engines/noweb/store/sqlite3/Sqlite3ChatRepository.ts

@@ -0,0 +1,23 @@
+import { Chat } from '@adiwajshing/baileys';
+
+import { IChatRepository } from '../IChatRepository';
+import { Sqlite3KVRepository } from './Sqlite3KVRepository';
+
+export class Sqlite3ChatRepository
+  extends Sqlite3KVRepository<Chat>
+  implements IChatRepository
+{
+  async getAllWithMessages(limit?: number, offset?: number): Promise<Chat[]> {
+    // Get chats with conversationTimestamp is not Null
+    let query = this.select()
+      .whereNotNull('conversationTimestamp')
+      .orderBy('conversationTimestamp', 'desc');
+    if (limit != null) {
+      query = query.limit(limit);
+    }
+    if (offset != null) {
+      query = query.offset(offset);
+    }
+    return await this.all(query);
+  }
+}

src/core/engines/noweb/store/sqlite3/Sqlite3ContactRepository.ts

@@ -0,0 +1,8 @@
+import { Contact } from '@adiwajshing/baileys';
+
+import { IContactRepository } from '../IContactRepository';
+import { Sqlite3KVRepository } from './Sqlite3KVRepository';
+
+export class Sqlite3ContactRepository
+  extends Sqlite3KVRepository<Contact>
+  implements IContactRepository {}

src/core/engines/noweb/store/sqlite3/Sqlite3KVRepository.ts

@@ -0,0 +1,164 @@
+import { BufferJSON } from '@adiwajshing/baileys/lib/Utils';
+import {
+  convertProtobufToPlainObject,
+  replaceLongsWithNumber,
+} from '@waha/core/engines/noweb/utils';
+import { Database } from 'better-sqlite3';
+import Knex from 'knex';
+
+import { Field, Schema } from '../Schema';
+
+/**
+ * Key value repository with extra metadata
+ */
+export class Sqlite3KVRepository<Entity> {
+  private UPSERT_BATCH_SIZE = 100;
+  protected db: Database;
+
+  private readonly metadata: Map<string, (entity: Entity) => any>;
+  protected readonly table: string;
+  private readonly columns: Field[];
+  private knex: Knex.Knex;
+
+  constructor(
+    db: Database,
+    schema: Schema,
+    metadata: Map<string, (entity: Entity) => any> | null = null,
+  ) {
+    this.db = db;
+    this.columns = schema.columns;
+    this.table = schema.name;
+    this.metadata = metadata || new Map();
+
+    // sqlite does not support inserting default values. Set the `useNullAsDefault` flag to hide this warning. (see docs https://knexjs.org/guide/query-builder.html#insert).
+    this.knex = Knex({ client: 'better-sqlite3', useNullAsDefault: true });
+  }
+
+  getAll() {
+    return this.all(this.select());
+  }
+
+  getAllByIds(ids: string[]) {
+    return this.all(this.select().whereIn('id', ids));
+  }
+
+  protected getAllBy(filters: any) {
+    const query = this.select().where(filters);
+    return this.all(query);
+  }
+
+  protected async getBy(filters: any) {
+    const query = this.select().where(filters).limit(1);
+    return this.get(query);
+  }
+
+  private dump(entity: Entity) {
+    const data = {};
+    const raw = convertProtobufToPlainObject(entity);
+    replaceLongsWithNumber(raw);
+    for (const field of this.columns) {
+      const fn = this.metadata.get(field.fieldName);
+      if (fn) {
+        data[field.fieldName] = fn(raw);
+      } else if (field.fieldName == 'data') {
+        data['data'] = JSON.stringify(raw, BufferJSON.replacer);
+      } else {
+        data[field.fieldName] = raw[field.fieldName];
+      }
+    }
+    return data;
+  }
+
+  save(entity: Entity) {
+    return this.upsertOne(entity);
+  }
+
+  async getById(id: string): Promise<Entity | null> {
+    return this.getBy({ id: id });
+  }
+
+  async upsertOne(entity: Entity): Promise<void> {
+    await this.upsertMany([entity]);
+  }
+
+  async upsertMany(entities: Entity[]): Promise<void> {
+    if (entities.length === 0) {
+      return;
+    }
+    const batchSize = this.UPSERT_BATCH_SIZE;
+    for (let i = 0; i < entities.length; i += batchSize) {
+      const batch = entities.slice(i, i + batchSize);
+      await this.upsertBatch(batch);
+    }
+  }
+
+  private async upsertBatch(entities: Entity[]): Promise<void> {
+    const data = entities.map((entity) => this.dump(entity));
+    const keys = this.columns.map((c) => c.fieldName);
+    const values = data.map((d) => Object.values(d)).flat();
+    try {
+      this.db
+        .prepare(
+          `INSERT INTO ${this.table} (${keys.join(', ')})
+           VALUES ${data
+             .map(() => `(${keys.map(() => '?').join(', ')})`)
+             .join(', ')}
+           ON CONFLICT(id) DO UPDATE
+               SET ${keys.map((key) => `${key} = excluded.${key}`).join(', ')}`,
+        )
+        .run(values);
+    } catch (err) {
+      console.error(`Error upserting data: ${err}, values: ${values}`);
+      throw err;
+    }
+  }
+
+  protected async deleteBy(filters: any) {
+    const query = this.delete().where(filters);
+    await this.run(query);
+  }
+
+  async deleteAll() {
+    const query = this.delete();
+    await this.run(query);
+  }
+
+  async deleteById(id: string) {
+    await this.deleteBy({ id: id });
+  }
+
+  /**
+   * SQL helpers
+   */
+
+  protected select() {
+    return this.knex.select().from(this.table);
+  }
+
+  protected delete() {
+    return this.knex.delete().from(this.table);
+  }
+
+  protected async all(query: any) {
+    const sql = query.toSQL().sql;
+    const bind = query.toSQL().bindings;
+    const rows: any[] = this.db.prepare(sql).all(bind);
+    return rows.map((row) => JSON.parse(row.data, BufferJSON.reviver));
+  }
+
+  protected async get(query: any) {
+    const sql = query.toSQL().sql;
+    const bind = query.toSQL().bindings;
+    const row: any = this.db.prepare(sql).get(bind);
+    if (!row) {
+      return null;
+    }
+    return JSON.parse(row.data, BufferJSON.reviver);
+  }
+
+  protected async run(query: any) {
+    const sql = query.toSQL().sql;
+    const bind = query.toSQL().bindings;
+    return this.db.prepare(sql).run(bind);
+  }
+}

src/core/engines/noweb/store/sqlite3/Sqlite3LabelAssociationsRepository.ts

@@ -0,0 +1,40 @@
+import {
+  LabelAssociation,
+  LabelAssociationType,
+} from '@adiwajshing/baileys/lib/Types/LabelAssociation';
+import { ILabelAssociationRepository } from '@waha/core/engines/noweb/store/ILabelAssociationsRepository';
+
+import { Sqlite3KVRepository } from './Sqlite3KVRepository';
+
+export class Sqlite3LabelAssociationsRepository
+  extends Sqlite3KVRepository<LabelAssociation>
+  implements ILabelAssociationRepository
+{
+  async deleteOne(association: LabelAssociation): Promise<void> {
+    await this.deleteBy({
+      type: association.type,
+      chatId: association.chatId,
+      labelId: association.labelId,
+      // @ts-ignore: messageId doesn't existing in ChatLabelAssociation
+      messageId: association.messageId || null,
+    });
+  }
+
+  async deleteByLabelId(labelId: string): Promise<void> {
+    await this.deleteBy({ labelId: labelId });
+  }
+
+  getAssociationsByLabelId(
+    labelId: string,
+    type: LabelAssociationType,
+  ): Promise<LabelAssociation[]> {
+    return this.getAllBy({
+      type: type,
+      labelId: labelId,
+    });
+  }
+
+  getAssociationsByChatId(chatId: string): Promise<LabelAssociation[]> {
+    return this.getAllBy({ chatId: chatId, type: LabelAssociationType.Chat });
+  }
+}

src/core/engines/noweb/store/sqlite3/Sqlite3LabelsRepository.ts

@@ -0,0 +1,8 @@
+import { Label } from '@adiwajshing/baileys/lib/Types/Label';
+import { ILabelsRepository } from '@waha/core/engines/noweb/store/ILabelsRepository';
+
+import { Sqlite3KVRepository } from './Sqlite3KVRepository';
+
+export class Sqlite3LabelsRepository
+  extends Sqlite3KVRepository<Label>
+  implements ILabelsRepository {}

src/core/engines/noweb/store/sqlite3/Sqlite3MessagesRepository.ts

@@ -0,0 +1,48 @@
+import { IMessagesRepository } from '../IMessagesRepository';
+import { Sqlite3KVRepository } from './Sqlite3KVRepository';
+
+export class Sqlite3MessagesRepository
+  extends Sqlite3KVRepository<any>
+  implements IMessagesRepository
+{
+  upsert(messages: any[]): Promise<void> {
+    return this.upsertMany(messages);
+  }
+
+  getAllByJid(jid: string, limit: number): Promise<any[]> {
+    const query = this.select()
+      .where({ jid: jid })
+      .limit(limit)
+      .orderBy('messageTimestamp', 'DESC');
+    return this.all(query);
+  }
+
+  async getByJidById(jid: string, id: string): Promise<any> {
+    return this.getBy({ jid: jid, id: id });
+  }
+
+  async updateByJidAndId(
+    jid: string,
+    id: string,
+    update: any,
+  ): Promise<boolean> {
+    const entity = await this.getByJidById(jid, id);
+    if (!entity) {
+      return false;
+    }
+    Object.assign(entity, update);
+    await this.upsertOne(entity);
+  }
+
+  async deleteByJidByIds(jid: string, ids: string[]): Promise<void> {
+    const query = `DELETE
+                   FROM ${this.table}
+                   WHERE jid = ?
+                     AND id IN (${ids.map(() => '?').join(', ')})`;
+    this.db.prepare(query).run([jid, ...ids]);
+  }
+
+  deleteAllByJid(jid: string): Promise<void> {
+    return this.deleteBy({ jid: jid });
+  }
+}

src/core/engines/noweb/store/sqlite3/Sqlite3SchemaValidation.ts

@@ -0,0 +1,50 @@
+import { Schema } from '../Schema';
+
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const Database = require('better-sqlite3');
+
+export class Sqlite3SchemaValidation {
+  constructor(
+    private table: Schema,
+    private db,
+  ) {}
+
+  validate() {
+    const table = this.table;
+
+    // Check table has the columns
+    const columns = this.db.prepare(`PRAGMA table_info(${table.name})`).all();
+    // Check exact number of columns
+    if (columns.length !== table.columns.length) {
+      throw new Error(
+        `Table '${table.name}' does not have expected number of columns. Expected ${table.columns.length}, got ${columns.length}`,
+      );
+    }
+
+    // Check column + type
+    for (const column of table.columns) {
+      const columnInfo = columns.find((c) => c.name === column.fieldName);
+      if (!columnInfo) {
+        throw new Error(
+          `Table '${table.name}' does not have column '${column.fieldName}'`,
+        );
+      }
+      if (columnInfo.type !== column.type) {
+        throw new Error(
+          `Table '${table.name}' column '${column.fieldName}' has type '${columnInfo.type}' but expected '${column.type}'`,
+        );
+      }
+    }
+
+    // Check table has expected indexes
+    const indexes = this.db.prepare(`PRAGMA index_list(${table.name})`).all();
+    const indexNames = indexes.map((index) => index.name);
+    for (const index of table.indexes) {
+      if (!indexNames.includes(index.name)) {
+        throw new Error(
+          `Table '${table.name}' does not have index '${index.name}'`,
+        );
+      }
+    }
+  }
+}

src/core/engines/noweb/store/sqlite3/Sqlite3Storage.ts

@@ -0,0 +1,150 @@
+import { WAMessage } from '@adiwajshing/baileys';
+import { LabelAssociation } from '@adiwajshing/baileys/lib/Types/LabelAssociation';
+import { ILabelAssociationRepository } from '@waha/core/engines/noweb/store/ILabelAssociationsRepository';
+import { ILabelsRepository } from '@waha/core/engines/noweb/store/ILabelsRepository';
+import { Sqlite3LabelAssociationsRepository } from '@waha/core/engines/noweb/store/sqlite3/Sqlite3LabelAssociationsRepository';
+import { Sqlite3LabelsRepository } from '@waha/core/engines/noweb/store/sqlite3/Sqlite3LabelsRepository';
+
+import { INowebStorage } from '../INowebStorage';
+import { Field, Index, NOWEB_STORE_SCHEMA, Schema } from '../Schema';
+import { Sqlite3ChatRepository } from './Sqlite3ChatRepository';
+import { Sqlite3ContactRepository } from './Sqlite3ContactRepository';
+import { Sqlite3MessagesRepository } from './Sqlite3MessagesRepository';
+import { Sqlite3SchemaValidation } from './Sqlite3SchemaValidation';
+
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const Database = require('better-sqlite3');
+
+export class Sqlite3Storage extends INowebStorage {
+  private readonly db: any;
+  private readonly tables: Schema[];
+
+  constructor(filePath: string) {
+    super();
+    this.db = new Database(filePath);
+    this.tables = NOWEB_STORE_SCHEMA;
+  }
+
+  async init() {
+    this.db.pragma('journal_mode = WAL;');
+    this.migrate();
+    this.validateSchema();
+  }
+
+  private migrate() {
+    this.migration0001init();
+  }
+
+  private validateSchema() {
+    for (const table of this.tables) {
+      new Sqlite3SchemaValidation(table, this.db).validate();
+    }
+  }
+
+  private migration0001init() {
+    // Contacts
+    this.db.exec(
+      'CREATE TABLE IF NOT EXISTS contacts (id TEXT PRIMARY KEY, data TEXT)',
+    );
+    this.db.exec(
+      'CREATE UNIQUE INDEX IF NOT EXISTS contacts_id_index ON contacts (id)',
+    );
+
+    // Chats
+    this.db.exec(
+      'CREATE TABLE IF NOT EXISTS chats (id TEXT PRIMARY KEY, conversationTimestamp INTEGER, data TEXT)',
+    );
+    this.db.exec(
+      'CREATE UNIQUE INDEX IF NOT EXISTS chats_id_index ON chats (id)',
+    );
+    this.db.exec(
+      'CREATE INDEX IF NOT EXISTS chats_conversationTimestamp_index ON chats (conversationTimestamp)',
+    );
+
+    // Messages
+    this.db.exec(
+      'CREATE TABLE IF NOT EXISTS messages (jid TEXT, id TEXT, messageTimestamp INTEGER, data TEXT)',
+    );
+    this.db.exec(
+      'CREATE UNIQUE INDEX IF NOT EXISTS messages_id_index ON messages (id)',
+    );
+    this.db.exec(
+      'CREATE INDEX IF NOT EXISTS messages_jid_id_index ON messages (jid, id)',
+    );
+    this.db.exec(
+      'CREATE INDEX IF NOT EXISTS messages_jid_timestamp_index ON messages (jid, messageTimestamp)',
+    );
+    this.db.exec(
+      'CREATE INDEX IF NOT EXISTS timestamp_index ON messages (messageTimestamp)',
+    );
+
+    //
+    // Labels
+    //
+    this.db.exec(
+      'CREATE TABLE IF NOT EXISTS labels (id TEXT PRIMARY KEY, data TEXT)',
+    );
+    this.db.exec(
+      'CREATE UNIQUE INDEX IF NOT EXISTS labels_id_index ON labels (id)',
+    );
+
+    // Label associations
+    this.db.exec(
+      'CREATE TABLE IF NOT EXISTS labelAssociations (id TEXT PRIMARY KEY, type TEXT, labelId TEXT, chatId TEXT, messageId TEXT, data TEXT)',
+    );
+    this.db.exec(
+      'CREATE UNIQUE INDEX IF NOT EXISTS label_assoc_id_index ON labelAssociations (id)',
+    );
+    this.db.exec(
+      'CREATE INDEX IF NOT EXISTS label_assoc_type_label_index ON labelAssociations (type, labelId)',
+    );
+    this.db.exec(
+      'CREATE INDEX IF NOT EXISTS label_assoc_type_chat_index ON labelAssociations (type, chatId)',
+    );
+    this.db.exec(
+      'CREATE INDEX IF NOT EXISTS label_assoc_type_message_index ON labelAssociations (type, messageId)',
+    );
+  }
+
+  async close() {
+    this.db.close();
+  }
+
+  getContactsRepository() {
+    return new Sqlite3ContactRepository(this.db, this.getSchema('contacts'));
+  }
+
+  getChatRepository() {
+    return new Sqlite3ChatRepository(this.db, this.getSchema('chats'));
+  }
+
+  getLabelsRepository(): ILabelsRepository {
+    return new Sqlite3LabelsRepository(this.db, this.getSchema('labels'));
+  }
+
+  getLabelAssociationRepository(): ILabelAssociationRepository {
+    const metadata = this.getLabelAssociationMetadata();
+    return new Sqlite3LabelAssociationsRepository(
+      this.db,
+      this.getSchema('labelAssociations'),
+      metadata,
+    );
+  }
+
+  getMessagesRepository() {
+    const metadata = this.getMessagesMetadata();
+    return new Sqlite3MessagesRepository(
+      this.db,
+      this.getSchema('messages'),
+      metadata,
+    );
+  }
+
+  getSchema(name: string) {
+    const schema = this.tables.find((table) => table.name === name);
+    if (!schema) {
+      throw new Error(`Schema not found: ${name}`);
+    }
+    return schema;
+  }
+}

src/core/engines/noweb/utils.ts

@@ -12,3 +12,74 @@ export function extractMediaContent(
     content?.stickerMessage;
   return mediaContent;
 }
+
+interface Long {
+  low: number;
+  high: number;
+  unsigned: boolean;
+
+  toNumber?(): number;
+}
+
+type AnyObject = { [key: string]: any };
+
+export const replaceLongsWithNumber = (obj: AnyObject): void => {
+  for (const key in obj) {
+    if (obj.hasOwnProperty(key)) {
+      if (isObjectALong(obj[key])) {
+        obj[key] = toNumber(obj[key]);
+      } else if (typeof obj[key] === 'object' && obj[key] !== null) {
+        replaceLongsWithNumber(obj[key]);
+      }
+    }
+  }
+};
+
+export function convertProtobufToPlainObject(obj: any): any {
+  if (typeof obj !== 'object' || obj === null) {
+    return obj;
+  }
+
+  // Ignore Buffer
+  if (
+    Buffer.isBuffer(obj) ||
+    obj?.type == 'Buffer' ||
+    obj instanceof Uint8Array
+  ) {
+    return obj;
+  }
+
+  // Remove empty array
+  if (Array.isArray(obj) && obj.length === 0) {
+    return undefined;
+  }
+
+  if (Array.isArray(obj)) {
+    return obj.map((item) => convertProtobufToPlainObject(item));
+  }
+
+  const plainObject: any = {};
+
+  Object.keys(obj).forEach((key) => {
+    const value = obj[key];
+    plainObject[key] = convertProtobufToPlainObject(value);
+  });
+
+  return { ...plainObject };
+}
+
+const isObjectALong = (value: any): value is Long => {
+  return (
+    value &&
+    typeof value === 'object' &&
+    'low' in value &&
+    'high' in value &&
+    'unsigned' in value
+  );
+};
+
+const toNumber = (longValue: Long): number => {
+  const { low, high, unsigned } = longValue;
+  const result = unsigned ? low >>> 0 : low + high * 0x100000000;
+  return result;
+};

src/core/engines/venom/session.venom.core.ts

@@ -69,7 +69,7 @@ export class WhatsappSessionVenomCore extends WhatsappSession {
       this.qr.save(base64Qrimg, urlCode);
       this.printQR(this.qr);
       this.status = WAHASessionStatus.SCAN_QR_CODE;
-      this.log.debug('Number of attempts to read the qrcode: ', attempts);
+      this.logger.debug('Number of attempts to read the qrcode: ', attempts);
     };
   }
 
@@ -79,7 +79,7 @@ export class WhatsappSessionVenomCore extends WhatsappSession {
       this.whatsapp = await this.buildClient();
     } catch (error) {
       this.status = WAHASessionStatus.FAILED;
-      this.log.error(error);
+      this.logger.error(error);
       this.qr.save('');
       return;
     }
@@ -90,8 +90,9 @@ export class WhatsappSessionVenomCore extends WhatsappSession {
   }
 
   async stop() {
-    await this.whatsapp.close();
     this.status = WAHASessionStatus.STOPPED;
+    this.events.removeAllListeners();
+    await this.whatsapp.close();
   }
 
   subscribeEngineEvent(event: WAHAEvents | string, handler: (message) => void) {

src/core/engines/webjs/2.2412.54.html

@@ -1,535 +0,0 @@
-<!doctype html>
-<html class="no-js" dir="ltr" loc="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
-    <title>WhatsApp Web</title>
-    <meta name="viewport" content="width=device-width" />
-    <meta name="google" content="notranslate" />
-    <meta name="format-detection" content="telephone=no" />
-    <meta
-      name="description"
-      content="Quickly send and receive WhatsApp messages right from your computer."
-    />
-    <meta
-      name="og:description"
-      content="Quickly send and receive WhatsApp messages right from your computer."
-    />
-    <meta name="og:url" content="https://web.whatsapp.com/" />
-    <meta name="og:title" content="WhatsApp Web" />
-    <meta
-      name="og:image"
-      content="https://static.facebook.com/images/whatsapp/www/whatsapp-promo.png"
-    />
-    <link
-      id="favicon"
-      rel="shortcut icon"
-      href="/img/favicon/1x/favicon.png"
-      type="image/png"
-    />
-    <link
-      rel="apple-touch-icon"
-      sizes="192x192"
-      href="/apple-touch-icon.png"
-      type="image/png"
-    />
-    <meta
-      name="theme-color"
-      content="#111b21"
-      media="(prefers-color-scheme: dark)"
-    />
-    <meta name="theme-color" content="#f0f2f5" />
-    <link
-      id="whatsapp-pwa-manifest-link"
-      rel="manifest"
-      href="/manifest.json"
-      crossorigin="use-credentials"
-    />
-    <style>
-      #initial_startup {
-        --startup-background: #f0f2f5;
-        --startup-background-rgb: 240, 242, 245;
-        --startup-icon: #bbc5cb;
-        --secondary-lighter: #8696a0;
-        --primary-title: #41525d;
-        --progress-primary: #00c298;
-        --progress-background: #e9edef;
-      }
-      .dark #initial_startup {
-        --startup-background: #111b21;
-        --startup-background-rgb: 17, 27, 33;
-        --startup-icon: #676f73;
-        --primary-title: rgba(233, 237, 239, 0.88);
-        --secondary-lighter: #667781;
-        --progress-primary: #0b846d;
-        --progress-background: #233138;
-      }
-      #app,
-      body,
-      html {
-        width: 100%;
-        height: 100%;
-        padding: 0;
-        margin: 0;
-        overflow: hidden;
-      }
-      #app {
-        position: absolute;
-        top: 0;
-        left: 0;
-      }
-      #initial_startup {
-        position: fixed;
-        top: 0;
-        left: 0;
-        display: flex;
-        flex-direction: column;
-        align-items: center;
-        justify-content: center;
-        width: 100%;
-        height: 100%;
-        user-select: none;
-        background-color: var(--startup-background);
-      }
-      #initial_startup .graphic {
-        margin-top: -40px;
-        color: var(--startup-icon);
-      }
-      #initial_startup .graphic .resume-logo {
-        transform: translateX(calc(50% - 52px / 2));
-      }
-      #initial_startup .graphic::after {
-        position: relative;
-        top: -100%;
-        left: calc(50% - 72px * 2 - 72px / 2);
-        display: block;
-        width: calc(72px * 3);
-        height: 100%;
-        content: '';
-        background: linear-gradient(
-          to right,
-          rgba(var(--startup-background-rgb), 0.5) 0,
-          rgba(var(--startup-background-rgb), 0.5) 33.33%,
-          rgba(var(--startup-background-rgb), 0) 44.1%,
-          rgba(var(--startup-background-rgb), 0) 55.8%,
-          rgba(var(--startup-background-rgb), 0.5) 66.66%,
-          rgba(var(--startup-background-rgb), 0.5) 100%
-        );
-        opacity: 1;
-        animation: shimmer 1.5s linear 0.6s infinite;
-      }
-      html[dir='rtl'] #initial_startup .graphic::after {
-        animation-direction: reverse;
-      }
-      @keyframes shimmer {
-        from {
-          left: calc(50% - 72px * 2 - 72px / 2);
-        }
-        to {
-          left: calc(50% - 72px / 2);
-        }
-      }
-      #initial_startup .progress {
-        position: relative;
-        width: 420px;
-        height: 3px;
-        margin-top: 40px;
-      }
-      #initial_startup .progress progress {
-        vertical-align: top;
-      }
-      #initial_startup .main {
-        margin-top: 40px;
-        font-size: 17px;
-        color: var(--primary-title);
-      }
-      #initial_startup .secondary {
-        margin-top: 12px;
-        font-size: 14px;
-        color: var(--secondary-lighter);
-      }
-      #initial_startup .secondary span {
-        display: inline-block;
-        margin-bottom: 2px;
-        vertical-align: middle;
-      }
-      progress {
-        -webkit-appearance: none;
-        appearance: none;
-        width: 100%;
-        height: 3px;
-        margin: 0;
-        color: var(--progress-primary);
-        background-color: var(--progress-background);
-        border: none;
-      }
-      progress[value]::-webkit-progress-bar {
-        background-color: var(--progress-background);
-      }
-      progress[value]::-moz-progress-bar,
-      progress[value]::-webkit-progress-value {
-        background-color: var(--progress-primary);
-        transition: width 0.45s ease;
-      }
-    </style>
-    <link
-      href="/stylex-f0601c57714fe972a8c4d2c2562f8082.css"
-      rel="stylesheet"
-    />
-    <link href="/app-6113f1562d101247269b.css" rel="stylesheet" />
-  </head>
-  <body class="web">
-    <script
-      data-binary-transparency-hash-key="inline-js-d11c72a06542fc3b43af600028cf0f996e4b9b178dfa047e18730efaf74aab0b"
-    >
-      try {
-        var systemThemeDark,
-          theme = window.localStorage.getItem('theme'),
-          systemThemeMode = window.localStorage.getItem('system-theme-mode');
-        if (('true' === systemThemeMode || !theme) && window.matchMedia) {
-          var systemTheme = window.matchMedia('(prefers-color-scheme: dark)');
-          systemThemeDark = systemTheme && systemTheme.matches;
-        }
-        var darkTheme = '"dark"' === theme || Boolean(systemThemeDark);
-        darkTheme && document.body.classList.add('dark');
-      } catch (e) {}
-    </script>
-    <div id="app"></div>
-    <div id="hard_expire_time" data-time="1719543128.405"></div>
-    <div id="initial_startup">
-      <div class="graphic">
-        <span
-          ><svg width="250" height="52" xmlns="http://www.w3.org/2000/svg">
-            <path
-              class="resume-logo"
-              d="M37.7 31.2c-.6-.4-3.8-2-4.4-2.1-.6-.2-1-.4-1.4.3l-2 2.5c-.4.4-.8.5-1.5.2-.6-.3-2.7-1-5.1-3.2-2-1.7-3.2-3.8-3.6-4.5-.4-.6 0-1 .3-1.3l1-1.1.6-1.1c.2-.4 0-.8 0-1.1l-2-4.8c-.6-1.3-1.1-1-1.5-1.1h-1.2c-.5 0-1.2.1-1.8.8-.5.6-2.2 2.2-2.2 5.3 0 3.2 2.3 6.3 2.6 6.7.3.4 4.6 7 11 9.7l3.7 1.4c1.5.5 3 .4 4 .2 1.3-.1 3.9-1.5 4.4-3 .5-1.5.5-2.8.4-3-.2-.4-.6-.5-1.3-.8M26 47.2c-3.9 0-7.6-1-11-3l-.7-.4-8.1 2L8.4 38l-.6-.8A21.4 21.4 0 0126 4.4a21.3 21.3 0 0121.4 21.4c0 11.8-9.6 21.4-21.4 21.4M44.2 7.6a25.8 25.8 0 00-40.6 31L0 52l13.7-3.6A25.8 25.8 0 0044.3 7.5"
-              fill="currentColor"
-            ></path></svg
-        ></span>
-      </div>
-      <div class="progress">
-        <progress value="0" max="100" dir="ltr"></progress>
-      </div>
-      <div class="main">WhatsApp</div>
-      <div class="secondary">
-        <span
-          ><svg width="10" height="12" xmlns="http://www.w3.org/2000/svg">
-            <path
-              d="M5 1.6c1.4 0 2.5 1 2.6 2.4v1.5h.2c.5 0 1 .4 1 1V10c0 .6-.5 1-1 1H2.3a1 1 0 01-1.1-1V6.5c0-.6.5-1 1-1h.2V4.2c0-1.4 1-2.5 2.4-2.6H5zm0 1.2c-.7 0-1.3.6-1.3 1.3v1.4h2.6V4.2c0-.7-.4-1.2-1-1.3H5z"
-              fill="currentColor"
-            ></path>
-          </svg> </span
-        >&nbsp;End-to-end encrypted
-      </div>
-    </div>
-    <link
-      rel="preload"
-      crossorigin="anonymous"
-      as="fetch"
-      href="/binary-transparency-manifest-2.2412.54.json"
-      id="binary-transparency-manifest-preload"
-    />
-    <script src="/libsignal-protocol-ee5b8ba.min.js"></script>
-    <script defer="defer" src="/runtime.295f0230b6dbd8983513.js"></script>
-    <script
-      data-binary-transparency-hash-key="inline-js-cdf06293c99d00ee0c1bc0fcfdbd76a7ae9aef6290926dbff0cba3a7994b7fca"
-    >
-      /*! Copyright (c) 2024 WhatsApp Inc. All Rights Reserved. */
-      (self.webpackChunkwhatsapp_web_client =
-        self.webpackChunkwhatsapp_web_client || []).push([
-        [5617],
-        {
-          307914: (e) => {
-            e.exports = function (e) {
-              return e && e.__esModule ? e : { default: e };
-            };
-          },
-          595318: (e) => {
-            (e.exports = function (e) {
-              return e && e.__esModule ? e : { default: e };
-            }),
-              (e.exports.default = e.exports),
-              (e.exports.__esModule = !0);
-          },
-          415227: (e, t) => {
-            'use strict';
-            Object.defineProperty(t, '__esModule', { value: !0 }),
-              (t.default = function (e) {
-                const t = new Error(e);
-                if (void 0 === t.stack)
-                  try {
-                    throw t;
-                  } catch (e) {}
-                return t;
-              });
-          },
-          670983: (e, t, r) => {
-            'use strict';
-            var n = r(307914);
-            Object.defineProperty(t, '__esModule', { value: !0 }),
-              (t.default = function (e) {
-                let t =
-                  arguments.length > 1 && void 0 !== arguments[1]
-                    ? arguments[1]
-                    : '?';
-                if (null == e)
-                  throw (0, o.default)('Unexpected null or undefined: ' + t);
-                return e;
-              });
-            var o = n(r(415227));
-          },
-          250473: (e, t, r) => {
-            'use strict';
-            Object.defineProperty(t, '__esModule', { value: !0 }),
-              (t.UNIQUE_UPLOADS_ALLOWED_BEFORE_THROTTLE =
-                t.TICKET_URL =
-                t.CLB_URL =
-                t.CLB_TOKEN =
-                t.CLB_CHECK_URL =
-                  void 0);
-            var n = r(508247);
-            (t.CLB_CHECK_URL =
-              'https://crashlogs.whatsapp.net/wa_fls_upload_check'),
-              (t.CLB_TOKEN =
-                '1063127757113399|745146ffa34413f9dbb5469f5370b7af'),
-              (t.CLB_URL = 'https://crashlogs.whatsapp.net/wa_clb_data');
-            const o = n.DYN_ORIGIN + 'web-contact-us';
-            (t.TICKET_URL = o), (t.UNIQUE_UPLOADS_ALLOWED_BEFORE_THROTTLE = 0);
-          },
-          207024: (e, t, r) => {
-            'use strict';
-            var n = r(595318);
-            Object.defineProperty(t, '__esModule', { value: !0 }),
-              (t.getDistribution = function () {
-                let e = 'unknown';
-                return (e = 'prod'), 'web_prod';
-              }),
-              (t.getLogUserAgent = function (e) {
-                let t,
-                  { appVersion: r, browser: n, device: o } = e;
-                return (t = 'Web/' + n), `WhatsApp/${r} ${t} Device/${o}`;
-              }),
-              n(r(472514)),
-              n(r(556869));
-          },
-          794858: (e, t, r) => {
-            'use strict';
-            var n = r(595318),
-              o = n(r(670983)),
-              a = r(508247),
-              s = r(250473),
-              c = r(207024),
-              _ = n(r(174285)),
-              u = r(425017);
-            function i(e) {
-              !(function (e, t) {
-                const r = window.navigator.userAgent;
-                if (r === p && e.includes('getElementsByTagName')) return;
-                const n = new FormData(),
-                  i = new Blob([e], { type: 'text/plain' });
-                n.append(
-                  'from_jid',
-                  (function () {
-                    if (f) return f;
-                    try {
-                      (f = JSON.parse(
-                        (0, o.default)(_.default, 'localStorage').getItem(
-                          d.UNKNOWN_ID,
-                        ),
-                      )),
-                        f && (f = f.replace('-', ''));
-                    } catch (e) {}
-                    if (!f) {
-                      f = 'unknown' + Math.floor(1e10 * Math.random());
-                      const e = f;
-                      try {
-                        (0, o.default)(_.default, 'localStorage').setItem(
-                          d.UNKNOWN_ID,
-                          JSON.stringify(e),
-                        );
-                      } catch (e) {}
-                    }
-                    return (0, o.default)(f, 'id');
-                  })(),
-                ),
-                  n.append(
-                    'agent',
-                    (0, c.getLogUserAgent)(
-                      (0, u.parseUASimple)(r, a.VERSION_BASE),
-                    ),
-                  ),
-                  n.append('file', i, 'logs.txt'),
-                  n.append('tags', 'load');
-                const l = new XMLHttpRequest(),
-                  I =
-                    s.CLB_URL +
-                    '?access_token=' +
-                    encodeURIComponent(s.CLB_TOKEN);
-                l.open('POST', I, !0), l.send(n);
-              })(e);
-            }
-            function l(e) {
-              let { error: t, reason: r, stack: n } = e;
-              const o = new Date().toISOString();
-              return `${o}: error: ${t}\n${o}: reason for logs: ${r}\n${o}: userAgent: ${window.navigator.userAgent}\n${n}`;
-            }
-            null == window.onerror &&
-              (window.onerror = function (e, t, r) {
-                const n = t.split('?')[0];
-                return "Uncaught SyntaxError: Unexpected token '<'" === e
-                  ? ((function (e) {
-                      i(
-                        l({
-                          error: 'failed to load a js or css bundle',
-                          reason: `failed to load [${e
-                            .split('/')[3]
-                            .replace(/^\//, '')}]`,
-                          stack: '',
-                        }),
-                      );
-                    })(n),
-                    !0)
-                  : (i(
-                      l({
-                        error: e,
-                        reason: `Error at [${n}:${r}]`,
-                        stack: '',
-                      }),
-                    ),
-                    !1);
-              });
-            const d = { UNKNOWN_ID: a.UNKNOWN_ID },
-              p =
-                'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.113 Safari/537.36';
-            let f;
-          },
-          425017: (e, t) => {
-            'use strict';
-            function r(e) {
-              return e.includes('windows')
-                ? 'Windows'
-                : e.includes('mac')
-                  ? 'Mac OS'
-                  : e.includes('linux')
-                    ? 'Linux'
-                    : 'Unparsed';
-            }
-            Object.defineProperty(t, '__esModule', { value: !0 }),
-              (t.parseUASimple = function (e, t) {
-                const n = e.toLowerCase();
-                return { browser: s(n), device: r(n), appVersion: t };
-              });
-            const n = /(chrome|firefox)\/([\w\.]+)/i,
-              o = /(edge|opr)\/([\w\.]+)/i,
-              a = {
-                chrome: 'Chrome',
-                edge: 'Edge',
-                opr: 'Opera',
-                firefox: 'Firefox',
-              };
-            function s(e) {
-              const t = e.match(o) || e.match(n);
-              return null == t ? 'Unparsed' : `${a[t[1]]} ${t[2]}`;
-            }
-          },
-          174285: (e, t) => {
-            'use strict';
-            let r;
-            Object.defineProperty(t, '__esModule', { value: !0 }),
-              (t.default = void 0);
-            try {
-              r = window.localStorage;
-            } catch (e) {}
-            var n = r;
-            t.default = n;
-          },
-          508247: (e, t) => {
-            'use strict';
-            Object.defineProperty(t, '__esModule', { value: !0 }),
-              (t.WS_ORIGIN =
-                t.WEB_PUBLIC_PATH =
-                t.VERSION_TERTIARY =
-                t.VERSION_STR =
-                t.VERSION_SECONDARY =
-                t.VERSION_PRIMARY =
-                t.VERSION_BASE =
-                t.USER_TIMINGS =
-                t.UNKNOWN_ID =
-                t.LOCALHOST_ENV_CONFIG =
-                t.HASH_PLACEHOLDER =
-                t.FLB_PLATFORM =
-                t.FB_APP_ID =
-                t.DYN_ORIGIN =
-                t.DIFF_VERSION =
-                t.DIFF_ID =
-                t.BUILD_URL =
-                t.BUILD_TIMESTAMP =
-                t.BUILD_ID =
-                  void 0);
-            t.DIFF_ID = '';
-            (t.DIFF_VERSION = ''),
-              (t.LOCALHOST_ENV_CONFIG = !1),
-              (t.HASH_PLACEHOLDER = '507042ed75b89fb00e8ef35da3541122cbc261e6'),
-              (t.VERSION_PRIMARY = '2'),
-              (t.VERSION_SECONDARY = '2412'),
-              (t.VERSION_TERTIARY = '54'),
-              (t.VERSION_BASE = '2.2412.54'),
-              (t.VERSION_STR = '2.2412.54'),
-              (t.DYN_ORIGIN = 'https://web.whatsapp.com/'),
-              (t.WS_ORIGIN = ''),
-              (t.FLB_PLATFORM = 'web'),
-              (t.FB_APP_ID = ''),
-              (t.UNKNOWN_ID = 'WAUnknownID'),
-              (t.BUILD_ID = '583059957'),
-              (t.BUILD_TIMESTAMP = 'March 29, 2024'),
-              (t.WEB_PUBLIC_PATH = '/'),
-              (t.BUILD_URL = 'https://web.whatsapp.com/'),
-              (t.USER_TIMINGS = !1);
-          },
-          472514: (e, t) => {
-            'use strict';
-            Object.defineProperty(t, '__esModule', { value: !0 }),
-              (t.default = function (e) {
-                return e.default;
-              });
-          },
-          556869: (e, t) => {
-            'use strict';
-            Object.defineProperty(t, '__esModule', { value: !0 }),
-              (t.default = function e(t) {
-                const r = new Error(t);
-                if (void 0 === r.stack)
-                  try {
-                    throw e;
-                  } catch (e) {}
-                return r;
-              });
-          },
-        },
-        (e) => {
-          'use strict';
-          e((e.s = 794858));
-        },
-      ]);
-    </script>
-    <script defer="defer" src="/vendor1~app.264a01b6133c4a120327.js"></script>
-    <script defer="defer" src="/app.2c7f8dd150ae88037cde.js"></script>
-    <script
-      data-binary-transparency-hash-key="inline-js-9c8cd3d0f4d5af8c7f5cd1c45208edd308bfe472e353a50e4cbacbf6cb58627c"
-    >
-      ((i) => {
-        const l = document.getElementById(i);
-        l &&
-          fetch(l.href)
-            .then((b) => b.text())
-            .then((code) => {
-              const script = document.createElement('script');
-              script.id = 'binary-transparency-manifest';
-              script.type = 'application/json';
-              script.innerHTML = code;
-              document.body.append(script);
-            });
-      })('binary-transparency-manifest-preload');
-    </script>
-  </body>
-</html>

src/core/engines/webjs/WahaInjected.js

@@ -0,0 +1,15 @@
+exports.LoadUtils = () => {
+  window.WAHA = {};
+
+  window.WAHA.getChats = async (limit, offset) => {
+    let chats = window.Store.Chat.getModelsArray();
+    if (limit || offset) {
+      offset = offset || 0;
+      limit = limit || Infinity;
+      chats = chats.slice(offset, offset + limit);
+    }
+
+    const chatPromises = chats.map((chat) => window.WWebJS.getChatModel(chat));
+    return await Promise.all(chatPromises);
+  };
+};

src/core/engines/webjs/WebjsClient.ts

@@ -0,0 +1,38 @@
+import { Client } from 'whatsapp-web.js';
+
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { LoadUtils } = require('./WahaInjected');
+
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const ChatFactory = require('whatsapp-web.js/src/factories/ChatFactory');
+
+export class WebjsClient extends Client {
+  async inject() {
+    // Even tho this.inject is not defined as interface in Client.ts
+    // We can still call and override it
+    // @ts-ignore
+    await super.inject();
+    //Load util functions (serializers, helper functions)
+    await this.pupPage.evaluate(LoadUtils);
+  }
+
+  async getChats(limit?: number, offset?: number) {
+    if (limit == null && offset == null) {
+      return await super.getChats();
+    }
+    return await this.getChats2(limit, offset);
+  }
+
+  private async getChats2(limit?: number, offset?: number) {
+    const chats = await this.pupPage.evaluate(
+      async (limit, offset) => {
+        // @ts-ignore
+        return await window.WAHA.getChats(limit, offset);
+      },
+      limit,
+      offset,
+    );
+
+    return chats.map((chat) => ChatFactory.create(this, chat));
+  }
+}

src/core/engines/webjs/session.webjs.core.ts

@@ -1,17 +1,25 @@
 import { UnprocessableEntityException } from '@nestjs/common/exceptions/unprocessable-entity.exception';
+import { IEngineMediaProcessor } from '@waha/core/abc/media.abc';
 import {
-  Chat,
-  Client,
-  ClientOptions,
-  Contact,
-  Events,
-  GroupChat,
-  Location,
-  Message,
-  Reaction,
-} from 'whatsapp-web.js';
-import { Message as MessageInstance } from 'whatsapp-web.js/src/structures';
-
+  getChannelInviteLink,
+  WAHAInternalEvent,
+  WhatsappSession,
+} from '@waha/core/abc/session.abc';
+import { WebjsClient } from '@waha/core/engines/webjs/WebjsClient';
+import {
+  AvailableInPlusVersion,
+  NotImplementedByEngineError,
+} from '@waha/core/exceptions';
+import { QR } from '@waha/core/QR';
+import { parseBool } from '@waha/helpers';
+import { CallData } from '@waha/structures/calls.dto';
+import {
+  Channel,
+  ChannelRole,
+  CreateChannelRequest,
+  ListChannelsQuery,
+} from '@waha/structures/channels.dto';
+import { ChatArchiveEvent, GetChatsQuery } from '@waha/structures/chats.dto';
 import {
   ChatRequest,
   CheckNumberStatusQuery,
@@ -27,8 +35,8 @@ import {
   MessageVoiceRequest,
   SendSeenRequest,
   WANumberExistResult,
-} from '../../../structures/chatting.dto';
-import { ContactQuery, ContactRequest } from '../../../structures/contacts.dto';
+} from '@waha/structures/chatting.dto';
+import { ContactQuery, ContactRequest } from '@waha/structures/contacts.dto';
 import {
   ACK_UNKNOWN,
   SECOND,
@@ -37,32 +45,35 @@ import {
   WAHAPresenceStatus,
   WAHASessionStatus,
   WAMessageAck,
-} from '../../../structures/enums.dto';
+} from '@waha/structures/enums.dto';
 import {
   CreateGroupRequest,
   ParticipantsRequest,
   SettingsSecurityChangeInfo,
-} from '../../../structures/groups.dto';
+} from '@waha/structures/groups.dto';
+import { Label, LabelID } from '@waha/structures/labels.dto';
+import { WAMessage, WAMessageReaction } from '@waha/structures/responses.dto';
+import { MeInfo } from '@waha/structures/sessions.dto';
+import { WAMessageRevokedBody } from '@waha/structures/webhooks.dto';
+import { SingleDelayedJobRunner } from '@waha/utils/SingleDelayedJobRunner';
 import {
-  WAMessage,
-  WAMessageReaction,
-} from '../../../structures/responses.dto';
-import { MeInfo } from '../../../structures/sessions.dto';
-import { WAMessageRevokedBody } from '../../../structures/webhooks.dto';
-import { IEngineMediaProcessor } from '../../abc/media.abc';
-import { WAHAInternalEvent, WhatsappSession } from '../../abc/session.abc';
-import {
-  AvailableInPlusVersion,
-  NotImplementedByEngineError,
-} from '../../exceptions';
-import { QR } from '../../QR';
+  Call,
+  Channel as WEBJSChannel,
+  Chat,
+  ClientOptions,
+  Contact,
+  Events,
+  GroupChat,
+  Label as WEBJSLabel,
+  Location,
+  Message,
+  Reaction,
+} from 'whatsapp-web.js';
+import { Message as MessageInstance } from 'whatsapp-web.js/src/structures';
 
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const QRCode = require('qrcode');
 
-// eslint-disable-next-line @typescript-eslint/no-var-requires
-const qrcode = require('qrcode-terminal');
-
 export interface WebJSConfig {
   webVersion?: string;
 }
@@ -73,16 +84,23 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
   engine = WAHAEngine.WEBJS;
   protected engineConfig?: WebJSConfig;
 
-  private startTimeoutId: null | ReturnType<typeof setTimeout> = null;
+  private startDelayedJob: SingleDelayedJobRunner;
   private shouldRestart: boolean;
 
-  whatsapp: Client;
+  whatsapp: WebjsClient;
   protected qr: QR;
 
   public constructor(config) {
     super(config);
     this.qr = new QR();
     this.shouldRestart = true;
+
+    // Restart job if session failed
+    this.startDelayedJob = new SingleDelayedJobRunner(
+      'start-engine',
+      this.START_ATTEMPT_DELAY_SECONDS * SECOND,
+      this.logger,
+    );
   }
 
   /**
@@ -94,8 +112,9 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
 
   protected getClientOptions(): ClientOptions {
     const path = this.getClassDirName();
-    const webVersion = this.engineConfig?.webVersion || '2.2412.54';
-    this.log.debug(`Using web version: '${webVersion}'`);
+    const webVersion =
+      this.engineConfig?.webVersion || '2.3000.1014522270-alpha';
+    // this.log.debug(`Using web version: '${webVersion}'`);
     return {
       puppeteer: {
         headless: true,
@@ -105,9 +124,9 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
       },
       webVersion: webVersion,
       webVersionCache: {
-        type: 'local',
-        path: path,
-        strict: true,
+        type: 'none',
+        // path: path,
+        // strict: true,
       },
     };
   }
@@ -115,28 +134,26 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
   protected async buildClient() {
     const clientOptions = this.getClientOptions();
     this.addProxyConfig(clientOptions);
-    return new Client(clientOptions);
+    return new WebjsClient(clientOptions);
   }
 
   private restartClient() {
     if (!this.shouldRestart) {
-      this.log.debug("Shouldn't restart the client, ignoring restart request");
+      this.logger.debug(
+        'Should not restart the client, ignoring restart request',
+      );
       return;
     }
 
-    if (this.startTimeoutId) {
-      const msg =
-        'Request to restart is already in progress, ignoring restart request';
-      this.log.warn(msg);
-      return;
-    }
-    this.log.log(
-      `Setting up client start in ${this.START_ATTEMPT_DELAY_SECONDS} seconds...`,
-    );
-    this.startTimeoutId = setTimeout(() => {
-      this.startTimeoutId = undefined;
-      this.start();
-    }, this.START_ATTEMPT_DELAY_SECONDS * SECOND);
+    this.startDelayedJob.schedule(async () => {
+      if (!this.shouldRestart) {
+        this.logger.warn(
+          'Should not restart the client, ignoring restart request',
+        );
+        return;
+      }
+      await this.start();
+    });
   }
 
   protected addProxyConfig(clientOptions: ClientOptions) {
@@ -166,21 +183,21 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
         // Listen for browser disconnected event
         this.whatsapp.pupBrowser.on('disconnected', () => {
           this.status = WAHASessionStatus.FAILED;
-          this.log.error('The browser has been disconnected');
+          this.logger.error('The browser has been disconnected');
           this.restartClient();
         });
         // Listen for page close event
         this.whatsapp.pupPage.on('close', () => {
           this.status = WAHASessionStatus.FAILED;
-          this.log.error('The WhatsApp Web page has been closed');
+          this.logger.error('The WhatsApp Web page has been closed');
           this.restartClient();
         });
 
         // Listen for page error event
         if (this.isDebugEnabled()) {
-          this.log.debug("Logging 'console' event for web page");
+          this.logger.debug("Logging 'console' event for web page");
           this.whatsapp.pupPage.on('console', (msg) =>
-            this.log.debug(`WEBJS page log: ${msg.text()}`),
+            this.logger.debug(`WEBJS page log: ${msg.text()}`),
           );
           this.whatsapp.pupPage.evaluate(() =>
             console.log(`url is ${location.href}`),
@@ -189,7 +206,7 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
       })
       .catch((error) => {
         this.status = WAHASessionStatus.FAILED;
-        this.log.error(error);
+        this.logger.error(error);
         this.restartClient();
         return;
       });
@@ -209,32 +226,32 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
   async stop() {
     this.shouldRestart = false;
     this.status = WAHASessionStatus.STOPPED;
+    this.events.removeAllListeners();
     await this.end();
   }
 
   private async end() {
     try {
       this.whatsapp?.removeAllListeners();
-      clearInterval(this.startTimeoutId);
+      this.startDelayedJob.cancel();
       this.whatsapp?.destroy().catch((error) => {
-        this.log.debug('Failed to destroy the client', error);
+        this.logger.debug('Failed to destroy the client', error);
       });
     } catch (error) {
-      this.log.error(error);
+      this.logger.error(error);
     }
   }
 
-  async getSessionMeInfo(): Promise<MeInfo | null> {
+  getSessionMeInfo(): MeInfo | null {
     const clientInfo = this.whatsapp?.info;
     if (!clientInfo) {
       return null;
     }
     const wid = clientInfo.wid;
-    const meInfo: MeInfo = {
-      id: wid._serialized,
-      pushName: clientInfo.pushname,
+    return {
+      id: wid?._serialized,
+      pushName: clientInfo?.pushname,
     };
-    return meInfo;
   }
 
   protected listenEngineEventsInDebugMode() {
@@ -244,14 +261,14 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
       const event = Events[key];
       this.whatsapp.on(event, (...data: any[]) => {
         const log = { event: event, data: data };
-        this.log.debug(`WEBJS event: ${JSON.stringify(log)}`);
+        this.logger.debug({ event: log }, `WEBJS event`);
       });
     }
   }
 
   protected listenConnectionEvents() {
     this.whatsapp.on(Events.QR_RECEIVED, async (qr) => {
-      this.log.debug('QR received');
+      this.logger.debug('QR received');
       // Convert to image and save
       const url = await QRCode.toDataURL(qr);
       this.qr.save(url, qr);
@@ -262,13 +279,25 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
     this.whatsapp.on(Events.READY, () => {
       this.status = WAHASessionStatus.WORKING;
       this.qr.save('');
-      this.log.log(`Session '${this.name}' has been authenticated!`);
+      this.logger.info(`Session '${this.name}' is ready!`);
+    });
+
+    this.whatsapp.on(Events.AUTHENTICATED, () => {
+      this.status = WAHASessionStatus.WORKING;
+      this.qr.save('');
+      this.logger.info(`Session '${this.name}' has been authenticated!`);
+    });
+
+    this.whatsapp.on(Events.AUTHENTICATION_FAILURE, () => {
+      this.status = WAHASessionStatus.FAILED;
+      this.qr.save('');
+      this.logger.info(`Session '${this.name}' has been disconnected!`);
     });
 
     this.whatsapp.on(Events.DISCONNECTED, () => {
       this.status = WAHASessionStatus.FAILED;
       this.qr.save('');
-      this.log.log(`Session '${this.name}' has been disconnected!`);
+      this.logger.info(`Session '${this.name}' has been disconnected!`);
     });
   }
 
@@ -416,11 +445,12 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
   /**
    * Chats methods
    */
-  getChats() {
-    return this.whatsapp.getChats();
+  getChats(query: GetChatsQuery) {
+    return this.whatsapp.getChats(query.limit, query.offset);
   }
 
   async getChatMessages(chatId: string, limit: number, downloadMedia: boolean) {
+    downloadMedia = parseBool(downloadMedia);
     const chat: Chat = await this.whatsapp.getChatById(
       this.ensureSuffix(chatId),
     );
@@ -446,6 +476,52 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
     return chat.clearMessages();
   }
 
+  public chatsArchiveChat(chatId: string): Promise<any> {
+    const id = this.ensureSuffix(chatId);
+    return this.whatsapp.archiveChat(id);
+  }
+
+  public chatsUnarchiveChat(chatId: string): Promise<any> {
+    const id = this.ensureSuffix(chatId);
+    return this.whatsapp.unarchiveChat(id);
+  }
+
+  /**
+   *
+   * Label methods
+   */
+
+  public async getLabels(): Promise<Label[]> {
+    const labels = await this.whatsapp.getLabels();
+    return labels.map(this.toLabel);
+  }
+
+  public getChatsByLabelId(labelId: string) {
+    return this.whatsapp.getChatsByLabelId(labelId);
+  }
+
+  public async getChatLabels(chatId: string): Promise<Label[]> {
+    const id = this.ensureSuffix(chatId);
+    const labels = await this.whatsapp.getChatLabels(id);
+    return labels.map(this.toLabel);
+  }
+
+  public async putLabelsToChat(chatId: string, labels: LabelID[]) {
+    const labelIds = labels.map((label) => label.id);
+    const chatIds = [this.ensureSuffix(chatId)];
+    await this.whatsapp.addOrRemoveLabels(labelIds, chatIds);
+  }
+
+  protected toLabel(label: WEBJSLabel): Label {
+    const color = label.colorIndex;
+    return {
+      id: label.id,
+      name: label.name,
+      color: color,
+      colorHex: Label.toHex(color),
+    };
+  }
+
   /**
    * Contacts methods
    */
@@ -606,6 +682,109 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
     return groupChat.demoteParticipants(participantIds);
   }
 
+  /**
+   * Channels methods
+   */
+  protected ChatToChannel(chat: WEBJSChannel): Channel {
+    // @ts-ignore
+    const metadata = chat.channelMetadata;
+    let role = metadata.membershipType.toUpperCase();
+    if (role === 'VIEWER') {
+      role = ChannelRole.GUEST;
+    }
+    return {
+      id: chat.id._serialized,
+      name: chat.name,
+      description: chat.description,
+      invite: getChannelInviteLink(metadata.inviteCode),
+      preview: null,
+      picture: null,
+      verified: metadata.verified,
+      role: role,
+    };
+  }
+
+  protected ChannelMetadataToChannel(metadata: any): Channel {
+    let role = metadata.membershipType.toUpperCase();
+    if (role === 'VIEWER') {
+      role = ChannelRole.GUEST;
+    }
+    return {
+      id: metadata.id,
+      name: metadata.titleMetadata.title,
+      description: metadata.descriptionMetadata.description,
+      invite: metadata.inviteLink,
+      preview: metadata.pictureUrl,
+      picture: metadata.pictureUrl,
+      verified: metadata.isVerified,
+      role: role,
+    };
+  }
+
+  public async channelsList(query: ListChannelsQuery): Promise<Channel[]> {
+    const data = await this.whatsapp.getChannels();
+    let channels = data.map(this.ChatToChannel);
+    if (query.role) {
+      // @ts-ignore
+      channels = channels.filter((channel) => channel.role === query.role);
+    }
+
+    const promises = channels.map(async (channel) =>
+      this.whatsapp.getProfilePicUrl(channel.id),
+    );
+    const pictures = await Promise.all(promises);
+    channels = channels.map((channel, index) => {
+      channel.picture = pictures[index] || null;
+      channel.preview = channel.picture;
+      return channel;
+    });
+    return channels;
+  }
+
+  public channelsCreateChannel(
+    request: CreateChannelRequest,
+  ): Promise<Channel> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public async channelsGetChannel(id: string): Promise<Channel> {
+    return await this.channelsGetChannelByInviteCode(id);
+  }
+
+  public async channelsGetChannelByInviteCode(
+    inviteCode: string,
+  ): Promise<Channel> {
+    const metadata = await this.whatsapp.getChannelByInviteCode(inviteCode);
+    const channel = this.ChannelMetadataToChannel(metadata);
+    channel.preview =
+      (await this.whatsapp.getProfilePicUrl(channel.id)) || null;
+    channel.picture = channel.preview;
+    return channel;
+  }
+
+  public channelsDeleteChannel(id: string): Promise<void> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsFollowChannel(id: string): Promise<void> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsUnfollowChannel(id: string): Promise<void> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsMuteChannel(id: string): Promise<void> {
+    throw new NotImplementedByEngineError();
+  }
+
+  public channelsUnmuteChannel(id: string): Promise<void> {
+    throw new NotImplementedByEngineError();
+  }
+
+  /**
+   * Presences methods
+   */
   public async setPresence(presence: WAHAPresenceStatus, chatId?: string) {
     let chat: Chat;
     switch (presence) {
@@ -686,6 +865,28 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
       case WAHAEvents.GROUP_LEAVE:
         this.whatsapp.on(Events.GROUP_LEAVE, handler);
         return true;
+      case WAHAEvents.CHAT_ARCHIVE:
+        this.whatsapp.on('chat_archived', (chat, archived, _) => {
+          const body: ChatArchiveEvent = {
+            id: chat.id._serialized,
+            archived: archived,
+            timestamp: chat.timestamp,
+          };
+          handler(body);
+        });
+        return true;
+      case WAHAEvents.CALL_RECEIVED:
+        this.whatsapp.on('call', (call: Call) => {
+          const body: CallData = {
+            id: call.id,
+            from: call.from,
+            timestamp: call.timestamp,
+            isVideo: call.isVideo,
+            isGroup: call.isGroup,
+          };
+          handler(body);
+        });
+        return true;
       default:
         return false;
     }
@@ -696,8 +897,8 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
       try {
         message = await this.downloadMedia(message);
       } catch (e) {
-        this.log.error('Failed when tried to download media for a message');
-        this.log.error(e, e.stack);
+        this.logger.error('Failed when tried to download media for a message');
+        this.logger.error(e, e.stack);
       }
     }
     return await this.toWAMessage(message);
@@ -744,6 +945,7 @@ export class WhatsappSessionWebJSCore extends WhatsappSession {
   }
 
   public async getEngineInfo() {
+    // Add 1 seconds timeout
     return {
       WWebVersion: await this.whatsapp?.getWWebVersion(),
       state: await this.whatsapp?.getState(),

src/core/manager.core.ts

@@ -5,10 +5,17 @@ import {
   NotFoundException,
   UnprocessableEntityException,
 } from '@nestjs/common';
+import { getPinoLogLevel, LoggerBuilder } from '@waha/utils/logging';
+import { promiseTimeout } from '@waha/utils/promiseTimeout';
+import { EventEmitter } from 'events';
+import { PinoLogger } from 'nestjs-pino';
 
 import { WhatsappConfigService } from '../config.service';
-import { getLogLevels } from '../helpers';
-import { WAHAEngine, WAHASessionStatus } from '../structures/enums.dto';
+import {
+  WAHAEngine,
+  WAHAEvents,
+  WAHASessionStatus,
+} from '../structures/enums.dto';
 import {
   ProxyConfig,
   SessionDTO,
@@ -40,10 +47,6 @@ export class OnlyDefaultSessionIsAllowed extends UnprocessableEntityException {
   }
 }
 
-export function buildLogger(name: string, levels: LogLevel[]) {
-  return new ConsoleLogger(name, { logLevels: levels });
-}
-
 @Injectable()
 export class SessionManagerCore extends SessionManager {
   private session?: WhatsappSession;
@@ -55,12 +58,12 @@ export class SessionManagerCore extends SessionManager {
 
   constructor(
     private config: WhatsappConfigService,
-    private log: ConsoleLogger,
     private engineConfigService: EngineConfigService,
+    private log: PinoLogger,
   ) {
     super();
-
-    this.log.setContext('SessionManager');
+    this.events = new EventEmitter();
+    this.log.setContext(SessionManagerCore.name);
     this.session = undefined;
     const engineName = this.engineConfigService.getDefaultEngineName();
     this.EngineClass = this.getEngine(engineName);
@@ -95,7 +98,7 @@ export class SessionManagerCore extends SessionManager {
     }
   }
 
-  async onApplicationShutdown(signal?: string) {
+  async beforeApplicationShutdown(signal?: string) {
     if (!this.session) {
       return;
     }
@@ -114,20 +117,21 @@ export class SessionManagerCore extends SessionManager {
     }
 
     const name = request.name;
-    this.log.log(`'${name}' - starting session...`);
-    const levels = getLogLevels(request.config?.debug);
-    const log = buildLogger(`WhatsappSession - ${name}`, levels);
+    this.log.info(`'${name}' - starting session...`);
     const mediaManager = new CoreMediaManager(
       new MediaStorageCore(),
       this.config.mimetypes,
     );
-    const webhookLog = buildLogger(`Webhook - ${name}`, levels);
-    const webhook = new this.WebhookConductorClass(webhookLog);
+    const logger = this.log.logger.child({ session: name });
+    logger.level = getPinoLogLevel(request.config?.debug);
+    const loggerBuilder: LoggerBuilder = logger;
+
+    const webhook = new this.WebhookConductorClass(loggerBuilder);
     const proxyConfig = this.getProxyConfig(request);
     const sessionConfig: SessionParams = {
       name,
       mediaManager,
-      log,
+      loggerBuilder,
       printQR: this.engineConfigService.shouldPrintQR,
       sessionStore: this.store,
       proxyConfig: proxyConfig,
@@ -142,6 +146,12 @@ export class SessionManagerCore extends SessionManager {
     const webhooks = this.getWebhooks(request);
     webhook.configure(session, webhooks);
 
+    // configure events
+    session.events.on(
+      WAHAEvents.SESSION_STATUS,
+      this.handleSessionEvent(WAHAEvents.SESSION_STATUS, session),
+    );
+
     // start session
     await session.start();
     return {
@@ -186,10 +196,10 @@ export class SessionManagerCore extends SessionManager {
     this.onlyDefault(request.name);
 
     const name = request.name;
-    this.log.log(`Stopping ${name} session...`);
+    this.log.info(`Stopping ${name} session...`);
     const session = this.getSession(name);
     await session.stop();
-    this.log.log(`"${name}" has been stopped.`);
+    this.log.info(`"${name}" has been stopped.`);
     this.session = undefined;
   }
 
@@ -198,7 +208,7 @@ export class SessionManagerCore extends SessionManager {
     this.onlyDefault(request.name);
     this.stop({ name: name, logout: false })
       .then(() => {
-        this.log.log(`Session '${name}' has been stopped.`);
+        this.log.info(`Session '${name}' has been stopped.`);
       })
       .catch((err) => {
         this.log.error(
@@ -234,10 +244,22 @@ export class SessionManagerCore extends SessionManager {
         },
       ];
     }
-    const me = await this.session.getSessionMeInfo().catch((err) => null);
+    const me = this.session.getSessionMeInfo();
+    // Get engine info
+    let engineInfo = {};
+    if (this.session) {
+      try {
+        engineInfo = await promiseTimeout(10, this.session.getEngineInfo());
+      } catch (e) {
+        this.log.warn(
+          { session: this.session },
+          'Error while getting engine info',
+        );
+      }
+    }
     const engine = {
       engine: this.session?.engine,
-      ...(await this.session?.getEngineInfo().catch((err) => ({}))),
+      ...engineInfo,
     };
     return [
       {

src/core/storage/LocalSessionConfigRepository.ts

@@ -52,8 +52,7 @@ export class LocalSessionConfigRepository extends ISessionConfigRepository {
   }
 
   private getFilePath(sessionName): string {
-    const folder = this.store.getSessionDirectory(sessionName);
-    return path.join(folder, this.FILENAME);
+    return this.store.getFilePath(sessionName, this.FILENAME);
   }
 
   async delete(sessionName: string): Promise<void> {

src/core/storage/LocalStore.ts

@@ -17,4 +17,9 @@ export abstract class LocalStore extends DataStore {
    * Get the directory where the session data is stored
    */
   abstract getSessionDirectory(name: string): string;
+
+  /**
+   * Get the file path for a session
+   */
+  abstract getFilePath(session: string, file: string): string;
 }

src/core/storage/LocalStoreCore.ts

@@ -45,6 +45,10 @@ export class LocalStoreCore extends LocalStore {
     return this.getDirectoryPath(name);
   }
 
+  getFilePath(session: string, file: string): string {
+    return path.join(this.getSessionDirectory(session), file);
+  }
+
   protected getDirectoryPath(name: string): string {
     const suffix = crypto.createHash('md5').update(name).digest('hex');
     return path.join(this.getEngineDirectory(), `${name}-${suffix}`);

src/core/webhooks.core.ts

@@ -7,30 +7,36 @@ import { VERSION } from '../version';
 import { WAHAInternalEvent, WhatsappSession } from './abc/session.abc';
 import { WebhookConductor, WebhookSender } from './abc/webhooks.abc';
 import request = require('request');
+import { LoggerBuilder } from '@waha/utils/logging';
+import { Logger } from 'pino';
 
 export class WebhookSenderCore extends WebhookSender {
   send(json) {
-    this.log.log(`Sending POST to ${this.url}...`);
-    this.log.verbose(`POST DATA: ${JSON.stringify(json)}`);
+    this.logger.info({ url: this.url }, `Sending POST ...`);
+    this.logger.debug({ data: json }, `POST DATA`);
 
     request.post(this.url, { json: json }, (error, res, body) => {
       if (error) {
-        this.log.error(error);
+        this.logger.error(error);
         return;
       }
-      this.log.log(`POST request was sent with status code: ${res.statusCode}`);
-      this.log.debug(`Response: ${body}`);
+      this.logger.info(
+        `POST request was sent with status code: ${res.statusCode}`,
+      );
+      this.logger.debug({ body: body }, `Response`);
     });
   }
 }
 
 export class WebhookConductorCore implements WebhookConductor {
-  constructor(protected log: ConsoleLogger) {
-    this.log = log;
+  private logger: Logger;
+
+  constructor(protected loggerBuilder: LoggerBuilder) {
+    this.logger = loggerBuilder.child({ name: WebhookConductor.name });
   }
 
   protected buildSender(webhookConfig: WebhookConfig): WebhookSender {
-    return new WebhookSenderCore(this.log, webhookConfig);
+    return new WebhookSenderCore(this.loggerBuilder, webhookConfig);
   }
 
   private getSuitableEvents(events: WAHAEvents[] | string[]): WAHAEvents[] {
@@ -47,7 +53,7 @@ export class WebhookConductorCore implements WebhookConductor {
     for (const event of events) {
       // @ts-ignore
       if (!allEvents.includes(event)) {
-        this.log.error(`Unknown event for webhook: '${event}'`);
+        this.logger.error(`Unknown event for webhook: '${event}'`);
         continue;
       }
       rightEvents.push(event);
@@ -70,7 +76,7 @@ export class WebhookConductorCore implements WebhookConductor {
     }
 
     const url = webhook.url;
-    this.log.log(`Configuring webhooks for ${url}...`);
+    this.logger.info(`Configuring webhooks for ${url}...`);
     const events = this.getSuitableEvents(webhook.events);
     const sender = this.buildSender(webhook);
     for (const event of events) {
@@ -93,14 +99,14 @@ export class WebhookConductorCore implements WebhookConductor {
             url,
           );
           if (!found) {
-            this.log.error(
+            this.logger.error(
               `Engine does not support webhook event: '${event}' for url '${url}'`,
             );
           }
         });
       }
     }
-    this.log.log(`Webhooks were configured for ${url}.`);
+    this.logger.info(`Webhooks were configured for ${url}.`);
   }
 
   private configureSingleEvent(
@@ -117,7 +123,7 @@ export class WebhookConductorCore implements WebhookConductor {
     if (!found) {
       return false;
     }
-    this.log.log(`Event '${event}' is enabled for url: ${url}`);
+    this.logger.info(`Event '${event}' is enabled for url: ${url}`);
     return true;
   }
 
@@ -127,7 +133,7 @@ export class WebhookConductorCore implements WebhookConductor {
     data: any,
     sender: WebhookSender,
   ) {
-    const me = await session.getSessionMeInfo().catch((err) => null);
+    const me = session.getSessionMeInfo();
     const json: WAHAWebhook = {
       event: event,
       session: session.name,

src/dashboard/index.html

@@ -1,289 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Dashboard | WAHA</title>
-    <link rel="icon" href="./favicon.ico" />
-    <style>
-      :root {
-        --surface-card: #1f2937;
-        --surface-border: #374151;
-        --card-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
-      }
-
-      body,
-      html {
-        height: 100%;
-        padding: 0;
-        margin: 0;
-      }
-
-      * {
-        box-sizing: border-box;
-      }
-
-      .bg-image {
-        /* The image used */
-        background-image: url('./waha-dashboard.png');
-
-        /* Add the blur effect */
-        filter: blur(2px);
-        -webkit-filter: blur(2px);
-
-        /* Full height */
-        height: 100%;
-
-        /* Center and scale the image nicely */
-        background-position: center;
-        background-repeat: no-repeat;
-        background-size: cover;
-      }
-
-      body {
-        background-color: #111827;
-        color: rgba(255, 255, 255, 0.87);
-      }
-
-      svg {
-        width: 100px;
-        height: 100px;
-      }
-
-      .message {
-        font-size: 20px;
-        margin: 20px;
-      }
-
-      a {
-        color: rgb(158, 158, 255);
-        text-decoration-color: rgb(158, 158, 255);
-      }
-
-      .upgrade-link {
-        text-decoration: none;
-        font-size: 1.5rem;
-      }
-
-      .link-button {
-        background-color: #4ade80;
-        padding: 10px 20px;
-        border-radius: 5px;
-        color: #052e16;
-        text-decoration: none;
-        margin-top: 50px;
-      }
-
-      .card {
-        min-width: 25rem;
-        background: var(--surface-card);
-        border: 1px solid var(--surface-border);
-        box-shadow: var(--card-shadow);
-        padding: 2rem;
-        border-radius: 12px;
-        position: absolute;
-        top: 50%;
-        left: 50%;
-        transform: translate(-50%, -50%);
-        z-index: 2;
-        text-align: center;
-      }
-    </style>
-  </head>
-  <body>
-    <div class="bg-image"></div>
-    <div class="card">
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        xmlns:xlink="http://www.w3.org/1999/xlink"
-        version="1.1"
-        width="1080"
-        height="1080"
-        viewBox="0 0 1080 1080"
-        xml:space="preserve"
-      >
-        <desc>Created with Fabric.js 5.2.4</desc>
-        <defs></defs>
-        <g
-          transform="matrix(1 0 0 1 540 540)"
-          id="c3cb5d1b-8350-492a-8567-8c1ee2307b9a"
-        ></g>
-        <g
-          transform="matrix(1 0 0 1 540 540)"
-          id="054ae9ae-db12-4435-8648-8bfb02267690"
-        >
-          <rect
-            style="
-              stroke: none;
-              stroke-width: 1;
-              stroke-dasharray: none;
-              stroke-linecap: butt;
-              stroke-dashoffset: 0;
-              stroke-linejoin: miter;
-              stroke-miterlimit: 4;
-              fill: rgb(255, 255, 255);
-              fill-rule: nonzero;
-              opacity: 1;
-              visibility: hidden;
-            "
-            vector-effect="non-scaling-stroke"
-            x="-540"
-            y="-540"
-            rx="0"
-            ry="0"
-            width="1080"
-            height="1080"
-          />
-        </g>
-        <g transform="matrix(1 0 0 1 540 540)">
-          <rect
-            style="
-              stroke: none;
-              stroke-width: 1;
-              stroke-dasharray: none;
-              stroke-linecap: butt;
-              stroke-dashoffset: 0;
-              stroke-linejoin: miter;
-              stroke-miterlimit: 4;
-              fill: rgb(255, 255, 255);
-              fill-rule: nonzero;
-              opacity: 1;
-              visibility: hidden;
-            "
-            vector-effect="non-scaling-stroke"
-            x="-540"
-            y="-540"
-            rx="0"
-            ry="0"
-            width="1080"
-            height="1080"
-          />
-        </g>
-        <g transform="matrix(2.02 0 0 2.02 540 540)">
-          <rect
-            style="
-              stroke: none;
-              stroke-width: 1;
-              stroke-dasharray: none;
-              stroke-linecap: butt;
-              stroke-dashoffset: 0;
-              stroke-linejoin: miter;
-              stroke-miterlimit: 4;
-              fill: rgb(255, 255, 255);
-              fill-rule: nonzero;
-              opacity: 1;
-              visibility: hidden;
-            "
-            vector-effect="non-scaling-stroke"
-            x="-540"
-            y="-540"
-            rx="0"
-            ry="0"
-            width="1080"
-            height="1080"
-          />
-        </g>
-        <g transform="matrix(3.68 0 0 3.68 540.38 540.48)">
-          <path
-            style="
-              stroke: none;
-              stroke-width: 1;
-              stroke-dasharray: none;
-              stroke-linecap: butt;
-              stroke-dashoffset: 0;
-              stroke-linejoin: miter;
-              stroke-miterlimit: 4;
-              fill: rgb(74, 173, 32);
-              fill-rule: nonzero;
-              opacity: 1;
-            "
-            vector-effect="non-scaling-stroke"
-            transform=" translate(-392.21, -570.16)"
-            d="M 392.26 705.96 C 376.77 705.96 361.28999999999996 706.0400000000001 345.8 705.95 C 318.16 705.7900000000001 297.6 685.2700000000001 297.22 657.57 C 297.15000000000003 652.24 297.07000000000005 646.9100000000001 297.25 641.59 C 297.36 638.23 296.3 636.6 292.72 636.89 C 290.24 637.09 287.73 636.98 285.23 636.9 C 277.1 636.63 271.70000000000005 631.65 271.38 623.49 C 271.06 615.1800000000001 271.06 606.83 271.37 598.52 C 271.69 590.05 277.04 585.23 285.58 585.01 C 297.21 584.72 297.19 584.72 297.21999999999997 573.01 C 297.22999999999996 567.36 297.14 561.72 297.97999999999996 556.0699999999999 C 301.25999999999993 533.93 320.72999999999996 516.4599999999999 343.09 516.04 C 355.07 515.81 367.07 515.86 379.04999999999995 516.02 C 382.72999999999996 516.0699999999999 384.02 514.87 383.96 511.15 C 383.77 500.65999999999997 383.76 490.16999999999996 383.96999999999997 479.67999999999995 C 384.04999999999995 476.00999999999993 382.96 473.65999999999997 379.92999999999995 471.37999999999994 C 372.23999999999995 465.5799999999999 369.78 456.25999999999993 373.06999999999994 447.7199999999999 C 376.18999999999994 439.5999999999999 385.13999999999993 433.7399999999999 393.4599999999999 434.3599999999999 C 402.63999999999993 435.0399999999999 410.43999999999994 441.3499999999999 412.4599999999999 450.2199999999999 C 414.4799999999999 459.0299999999999 411.7099999999999 466.4299999999999 404.4699999999999 471.7899999999999 C 401.8699999999999 473.7199999999999 400.9199999999999 475.69999999999993 400.9699999999999 478.8299999999999 C 401.1199999999999 489.1499999999999 401.2499999999999 499.4799999999999 400.9299999999999 509.79999999999995 C 400.7899999999999 514.5 402.0299999999999 516.24 406.9999999999999 516.0799999999999 C 417.8099999999999 515.7299999999999 428.6399999999999 515.91 439.4699999999999 515.9899999999999 C 466.5199999999999 516.2099999999999 486.7199999999999 536.2299999999999 487.2399999999999 563.3 C 487.3399999999999 568.29 487.2599999999999 573.29 487.2799999999999 578.29 C 487.2999999999999 585 487.3099999999999 585 493.7899999999999 585.02 C 495.94999999999993 585.03 498.1199999999999 584.96 500.2799999999999 585.06 C 507.94999999999993 585.43 512.9999999999999 590.42 513.1499999999999 598.1199999999999 C 513.3199999999998 606.6099999999999 513.3099999999998 615.1099999999999 513.1599999999999 623.5999999999999 C 513.0299999999999 631.3599999999999 508.1999999999999 636.31 500.47999999999985 636.8699999999999 C 498.15999999999985 637.0399999999998 495.77999999999986 637.2199999999999 493.49999999999983 636.8899999999999 C 488.1999999999998 636.1299999999999 486.86999999999983 638.5399999999998 487.1999999999998 643.3999999999999 C 487.54999999999984 648.5399999999998 487.3499999999998 653.7199999999999 487.23999999999984 658.8799999999999 C 486.67999999999984 685.6599999999999 466.4599999999998 705.7399999999999 439.71999999999986 705.9599999999999 C 423.9 706.06 408.08 705.95 392.26 705.96 z"
-            stroke-linecap="round"
-          />
-        </g>
-        <g transform="matrix(-3.68 0 0 -3.68 546.38 845.01)">
-          <path
-            style="
-              stroke: none;
-              stroke-width: 1;
-              stroke-dasharray: none;
-              stroke-linecap: butt;
-              stroke-dashoffset: 0;
-              stroke-linejoin: miter;
-              stroke-miterlimit: 4;
-              fill: rgb(56, 134, 22);
-              fill-rule: nonzero;
-              opacity: 1;
-            "
-            vector-effect="non-scaling-stroke"
-            transform=" translate(-394.07, -654.42)"
-            d="M 394.26 632.93 C 404.75 632.93 415.23 632.9 425.71999999999997 632.9399999999999 C 431.92999999999995 632.9599999999999 433.52 634.7399999999999 432.90999999999997 640.7099999999999 C 430.99999999999994 659.66 414.40999999999997 675.2199999999999 395.38 675.91 C 376.87 676.5799999999999 359.57 662.65 356 644.1899999999999 C 355.72 642.7199999999999 355.33 641.26 355.19 639.78 C 354.71 634.9 356.32 633.01 361.3 632.97 C 372.29 632.87 383.28 632.93 394.26 632.93 z"
-            stroke-linecap="round"
-          />
-        </g>
-        <g transform="matrix(3.68 0 0 3.68 673.99 594.08)">
-          <path
-            style="
-              stroke: none;
-              stroke-width: 1;
-              stroke-dasharray: none;
-              stroke-linecap: butt;
-              stroke-dashoffset: 0;
-              stroke-linejoin: miter;
-              stroke-miterlimit: 4;
-              fill: rgb(56, 135, 22);
-              fill-rule: nonzero;
-              opacity: 1;
-            "
-            vector-effect="non-scaling-stroke"
-            transform=" translate(-428.75, -584.99)"
-            d="M 428.83 602 C 419.12 601.96 411.59999999999997 594.6 411.53 585.07 C 411.46999999999997 575.4100000000001 419.21 567.9100000000001 429.16999999999996 567.98 C 438.33 568.0500000000001 445.93999999999994 575.71 445.97999999999996 584.91 C 446.02 594.33 438.29 602.04 428.83 602 z"
-            stroke-linecap="round"
-          />
-        </g>
-        <g transform="matrix(3.68 0 0 3.68 406.92 594.18)">
-          <path
-            style="
-              stroke: none;
-              stroke-width: 1;
-              stroke-dasharray: none;
-              stroke-linecap: butt;
-              stroke-dashoffset: 0;
-              stroke-linejoin: miter;
-              stroke-miterlimit: 4;
-              fill: rgb(56, 135, 22);
-              fill-rule: nonzero;
-              opacity: 1;
-            "
-            vector-effect="non-scaling-stroke"
-            transform=" translate(-356.06, -584.99)"
-            d="M 339.05 584.57 C 339.19 574.94 346.67 567.84 356.53000000000003 567.99 C 366.26000000000005 568.14 373.21000000000004 575.46 373.07000000000005 585.42 C 372.94000000000005 595.16 365.62000000000006 602.13 355.68000000000006 602 C 346.04 601.87 338.91 594.4 339.05 584.57 z"
-            stroke-linecap="round"
-          />
-        </g>
-      </svg>
-
-      <div class="message">
-        Sorry,
-        <a
-          href="https://waha.devlike.pro/docs/how-to/waha-dashboard"
-          target="_blank"
-          >WAHA Dashboard</a
-        >
-        is not available in <strong>WAHA Core</strong> version.
-        <br />
-        Please consider upgrading to <strong>WAHA Plus</strong>.
-      </div>
-      <div style="margin-top: 2rem; margin-bottom: 1rem">
-        <a
-          class="upgrade-link link-button"
-          href="https://waha.devlike.pro/docs/how-to/plus-version/"
-          target="_blank"
-          >Upgrade to WAHA Plus</a
-        >
-      </div>
-    </div>
-  </body>
-</html>

src/helpers.ts

@@ -1,5 +1,3 @@
-import { LogLevel } from '@nestjs/common';
-
 function parseBool(value: any): boolean {
   if (typeof value === 'boolean') {
     return value;
@@ -37,11 +35,4 @@ function splitAt(str: string, index) {
   return [fst.join(''), snd.join('')];
 }
 
-function getLogLevels(debug: boolean): LogLevel[] {
-  const enableDebug = process.env.DEBUG != undefined || debug;
-  return enableDebug
-    ? ['log', 'error', 'warn', 'debug', 'verbose']
-    : ['log', 'error', 'warn'];
-}
-
-export { flipObject, getLogLevels, parseBool, splitAt };
+export { flipObject, parseBool, splitAt };

src/main.ts

@@ -1,26 +1,40 @@
 import { NestFactory } from '@nestjs/core';
+import { WsAdapter } from '@nestjs/platform-ws';
+import {
+  getNestJSLogLevels,
+  getPinoLogLevel,
+  getPinoTransport,
+} from '@waha/utils/logging';
 import { json, urlencoded } from 'express';
+import { Logger as NestJSPinoLogger } from 'nestjs-pino';
+import { LoggerErrorInterceptor } from 'nestjs-pino';
+import { Logger } from 'pino';
+import pino from 'pino';
 
 import { AllExceptionsFilter } from './api/exception.filter';
 import { WhatsappConfigService } from './config.service';
 import { AppModuleCore } from './core/app.module.core';
 import { SwaggerConfiguratorCore } from './core/SwaggerConfiguratorCore';
-import { getLogLevels } from './helpers';
 import { WAHA_WEBHOOKS } from './structures/webhooks.dto';
 import { getWAHAVersion, VERSION, WAHAVersion } from './version';
 
-console.log('NODE - Catching unhandled exceptions enabled');
+const logger: Logger = pino({
+  level: getPinoLogLevel(),
+  transport: getPinoTransport(),
+}).child({ name: 'Bootstrap' });
+
+logger.info('NODE - Catching unhandled exceptions enabled');
 process.on('unhandledRejection', (reason, promise) => {
-  console.error('Unhandled Rejection at:', promise, 'reason:', reason);
+  logger.error('Unhandled Rejection at:', promise, 'reason:', reason);
   // @ts-ignore
-  console.error(reason.stack);
+  logger.error(reason.stack);
 });
 
 async function loadModules(): Promise<
   [typeof AppModuleCore, typeof SwaggerConfiguratorCore]
 > {
   const version = getWAHAVersion();
-  console.log(`WAHA (WhatsApp HTTP API) - Running ${version} version...`);
+  logger.info(`WAHA (WhatsApp HTTP API) - Running ${version} version...`);
 
   if (version === WAHAVersion.CORE) {
     const { AppModuleCore } = await import('./core/app.module.core');
@@ -40,26 +54,39 @@ async function loadModules(): Promise<
 
 async function bootstrap() {
   const [AppModule, SwaggerModule] = await loadModules();
+  const httpsOptions = AppModule.getHttpsOptions(logger);
   const app = await NestFactory.create(AppModule, {
-    logger: getLogLevels(false),
+    logger: getNestJSLogLevels(),
+    httpsOptions: httpsOptions,
+    bufferLogs: true,
   });
+  app.useLogger(app.get(NestJSPinoLogger));
+
+  // Print original stack, not pino one
+  // https://github.com/iamolegga/nestjs-pino?tab=readme-ov-file#expose-stack-trace-and-error-class-in-err-property
+  app.useGlobalInterceptors(new LoggerErrorInterceptor());
 
   app.enableShutdownHooks();
   app.useGlobalFilters(new AllExceptionsFilter());
   app.enableCors();
+  // Ideally, we should apply it globally.
+  // but for now we added it ValidationPipe on Controller or endpoint level
+  // app.useGlobalPipes(new ValidationPipe({ transform: true }));
 
   // Allow to send big body - for images and attachments
   app.use(json({ limit: '50mb' }));
   app.use(urlencoded({ limit: '50mb', extended: false }));
+  app.useWebSocketAdapter(new WsAdapter(app));
 
   // Configure swagger
   const swaggerConfigurator = new SwaggerModule(app);
   swaggerConfigurator.configure(WAHA_WEBHOOKS);
 
+  AppModule.appReady(app, logger);
   const config = app.get(WhatsappConfigService);
   await app.listen(config.port);
-  console.log(`WhatsApp HTTP API is running on: ${await app.getUrl()}`);
-  console.log(`Environment:`, VERSION);
+  logger.info(`WhatsApp HTTP API is running on: ${await app.getUrl()}`);
+  logger.info(VERSION, 'Environment');
 }
 
 bootstrap();

src/structures/calls.dto.ts

@@ -0,0 +1,26 @@
+/**
+ * Events
+ */
+import { ApiProperty } from '@nestjs/swagger';
+import { ChatIdProperty } from '@waha/structures/properties.dto';
+
+function CallIdProperty() {
+  return ApiProperty({
+    description: 'Call ID',
+    example: 'ABCDEFGABCDEFGABCDEFGABCDEFG',
+  });
+}
+
+export class CallData {
+  @CallIdProperty()
+  id: string;
+
+  @ChatIdProperty()
+  from?: string;
+
+  timestamp: number;
+
+  isVideo: boolean;
+
+  isGroup: boolean;
+}

src/structures/channels.dto.ts

@@ -0,0 +1,94 @@
+import { ApiParam, ApiProperty, getSchemaPath } from '@nestjs/swagger';
+import { BinaryFile, RemoteFile } from '@waha/structures/files.dto';
+
+export class CreateChannelRequest {
+  @ApiProperty({
+    example: 'Channel Name',
+  })
+  name: string;
+
+  @ApiProperty({
+    example: 'Channel Description',
+  })
+  description?: string;
+
+  @ApiProperty({
+    oneOf: [
+      { $ref: getSchemaPath(RemoteFile) },
+      { $ref: getSchemaPath(BinaryFile) },
+    ],
+  })
+  picture?: RemoteFile | BinaryFile;
+}
+
+export enum ChannelRole {
+  OWNER = 'OWNER',
+  ADMIN = 'ADMIN',
+  SUBSCRIBER = 'SUBSCRIBER',
+  GUEST = 'GUEST',
+}
+
+export enum ChannelRoleFilter {
+  OWNER = ChannelRole.OWNER,
+  ADMIN = ChannelRole.ADMIN,
+  SUBSCRIBER = ChannelRole.SUBSCRIBER,
+}
+
+export class ListChannelsQuery {
+  role?: ChannelRoleFilter;
+}
+
+export class Channel {
+  @ApiProperty({
+    description: 'Newsletter id',
+    example: '123123123123@newsletter',
+  })
+  id: string;
+
+  name: string;
+
+  description?: string;
+
+  @ApiProperty({
+    description: 'Invite link',
+    example: 'https://www.whatsapp.com/channel/111111111111111111111111',
+  })
+  invite: string;
+
+  @ApiProperty({
+    description: "Preview for channel's picture",
+    example: 'https://mmg.whatsapp.net/m1/v/t24/An&_nc_cat=10',
+  })
+  preview?: string;
+
+  @ApiProperty({
+    description: "Channel's picture",
+    example: 'https://mmg.whatsapp.net/m1/v/t24/An&_nc_cat=10',
+  })
+  picture?: string;
+
+  verified: boolean;
+
+  role: ChannelRole;
+}
+
+export const NewsletterIdApiParam = ApiParam({
+  name: 'id',
+  required: true,
+  type: 'string',
+  schema: {
+    default: '123123123@newsletter',
+  },
+  description: 'WhatsApp Channel ID',
+});
+
+export const NewsletterIdOrInviteCodeApiParam = ApiParam({
+  name: 'id',
+  required: true,
+  type: 'string',
+  schema: {
+    default: '123123123@newsletter',
+  },
+  description:
+    'WhatsApp Channel ID or invite code from invite link https://www.whatsapp.com/channel/11111',
+});

src/structures/chats.dto.ts

@@ -1,6 +1,9 @@
 import { ApiProperty } from '@nestjs/swagger';
+import { ChatIdProperty } from '@waha/structures/properties.dto';
+import { Type } from 'class-transformer';
+import { IsNumber, IsOptional } from 'class-validator';
 
-import { SessionBaseRequest, SessionQuery } from './base.dto';
+import { SessionQuery } from './base.dto';
 
 /**
  * Queries
@@ -8,6 +11,7 @@ import { SessionBaseRequest, SessionQuery } from './base.dto';
 
 export class GetChatMessagesQuery extends SessionQuery {
   limit: number = 100;
+
   @ApiProperty({
     example: true,
     required: false,
@@ -16,6 +20,27 @@ export class GetChatMessagesQuery extends SessionQuery {
   downloadMedia: boolean = true;
 }
 
+export class GetChatsQuery {
+  @IsNumber()
+  @IsOptional()
+  @Type(() => Number)
+  limit?: number;
+
+  @IsNumber()
+  @IsOptional()
+  @Type(() => Number)
+  offset?: number;
+}
+
 /**
- * Requests
+ * Events
  */
+
+export class ChatArchiveEvent {
+  @ChatIdProperty()
+  id: string;
+
+  archived: boolean;
+
+  timestamp: number;
+}

src/structures/enums.dto.ts

@@ -13,6 +13,14 @@ export enum WAHAEvents {
   PRESENCE_UPDATE = 'presence.update',
   POLL_VOTE = 'poll.vote',
   POLL_VOTE_FAILED = 'poll.vote.failed',
+  CHAT_ARCHIVE = 'chat.archive',
+  CALL_RECEIVED = 'call.received',
+  CALL_ACCEPTED = 'call.accepted',
+  CALL_REJECTED = 'call.rejected',
+  LABEL_UPSERT = 'label.upsert',
+  LABEL_DELETED = 'label.deleted',
+  LABEL_CHAT_ADDED = 'label.chat.added',
+  LABEL_CHAT_DELETED = 'label.chat.deleted',
 }
 
 export enum WAHASessionStatus {
@@ -27,7 +35,6 @@ export enum WAHAEngine {
   VENOM = 'VENOM',
   WEBJS = 'WEBJS',
   NOWEB = 'NOWEB',
-  MOBILE = 'MOBILE',
 }
 
 export enum WAHAPresenceStatus {

src/structures/environment.dto.ts

@@ -2,7 +2,7 @@ import { ApiProperty } from '@nestjs/swagger';
 
 export class WAHAEnvironment {
   @ApiProperty({
-    example: '2029.10.29',
+    example: 'YYYY.MM.BUILD',
   })
   version: string;
 

src/structures/files.dto.ts

@@ -20,7 +20,8 @@ export class RemoteFile {
 
   @ApiProperty({
     example:
-      'https://github.com/devlikeapro/whatsapp-http-api/raw/core/examples/dev.likeapro.jpg',
+      process.env.WHATSAPP_SWAGGER_JPG_EXAMPLE_URL ||
+      'https://github.com/devlikeapro/waha/raw/core/examples/dev.likeapro.jpg',
   })
   url: string;
 }
@@ -73,7 +74,8 @@ export class VoiceRemoteFile {
 
   @ApiProperty({
     example:
-      'https://github.com/devlikeapro/whatsapp-http-api/raw/core/examples/dev.likeapro.opus',
+      process.env.WHATSAPP_SWAGGER_OPUS_EXAMPLE_URL ||
+      'https://github.com/devlikeapro/waha/raw/core/examples/dev.likeapro.opus',
   })
   url: string;
 }
@@ -110,7 +112,8 @@ export class VideoRemoteFile {
 
   @ApiProperty({
     example:
-      'https://github.com/devlikeapro/whatsapp-http-api/raw/core/examples/video.mp4',
+      process.env.WHATSAPP_SWAGGER_VIDEO_EXAMPLE_URL ||
+      'https://github.com/devlikeapro/waha/raw/core/examples/video.mp4',
   })
   url: string;
 }

src/structures/labels.dto.ts

@@ -0,0 +1,85 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { ChatIdProperty } from '@waha/structures/properties.dto';
+
+const Colors = [
+  '#ff9485',
+  '#64c4ff',
+  '#ffd429',
+  '#dfaef0',
+  '#99b6c1',
+  '#55ccb3',
+  '#ff9dff',
+  '#d3a91d',
+  '#6d7cce',
+  '#d7e752',
+  '#00d0e2',
+  '#ffc5c7',
+  '#93ceac',
+  '#f74848',
+  '#00a0f2',
+  '#83e422',
+  '#ffaf04',
+  '#b5ebff',
+  '#9ba6ff',
+  '#9368cf',
+];
+
+export class Label {
+  @ApiProperty({
+    example: '1',
+    description: 'Label ID',
+  })
+  id: string;
+
+  @ApiProperty({
+    example: 'Lead',
+    description: 'Label name',
+  })
+  name: string;
+
+  @ApiProperty({
+    example: 0,
+    description: 'Internal color number, not hex',
+  })
+  color: number;
+
+  @ApiProperty({
+    example: '#ff9485',
+    description: 'Color in hex',
+  })
+  colorHex: string;
+
+  static toHex(color: number) {
+    if (color >= Colors.length) {
+      return '#000000';
+    }
+    return Colors[color];
+  }
+}
+
+export class LabelID {
+  @ApiProperty({
+    example: '1',
+    description: 'Label ID',
+  })
+  id: string;
+}
+
+export class SetLabelsRequest {
+  labels: LabelID[];
+}
+
+export class LabelChatAssociation {
+  @ApiProperty({
+    example: '1',
+    description: 'Label ID',
+  })
+  labelId: string;
+
+  label: Label | null;
+
+  @ChatIdProperty({
+    description: 'Chat ID',
+  })
+  chatId: string;
+}

src/structures/ping.dto.ts

@@ -0,0 +1,3 @@
+export class PingResponse {
+  message: string = 'pong';
+}

src/structures/sessions.dto.ts

@@ -37,6 +37,26 @@ export class ProxyConfig {
   password?: string;
 }
 
+export class NowebStoreConfig {
+  @ApiProperty({
+    description:
+      'Enable or disable the store for contacts, chats, and messages.',
+  })
+  enabled: boolean = false;
+
+  @ApiProperty({
+    description:
+      'Enable full sync on session initialization (when scanning QR code).\n' +
+      'Full sync will download all contacts, chats, and messages from the phone.\n' +
+      'If disabled, only messages early than 90 days will be downloaded and some contacts may be missing.',
+  })
+  fullSync: boolean = false;
+}
+
+export class NowebConfig {
+  store?: NowebStoreConfig;
+}
+
 export class SessionConfig {
   webhooks?: WebhookConfig[];
 
@@ -46,6 +66,16 @@ export class SessionConfig {
   proxy?: ProxyConfig;
 
   debug: boolean = false;
+
+  @ApiProperty({
+    example: {
+      store: {
+        enabled: true,
+        fullSync: false,
+      },
+    },
+  })
+  noweb?: NowebConfig;
 }
 
 export class SessionStartRequest {

src/structures/status.dto.ts

@@ -19,7 +19,7 @@ class StatusRequest {
 }
 
 export class TextStatus extends StatusRequest {
-  text = 'Have a look! https://waha.devlike.pro/';
+  text = 'Have a look! https://github.com/';
   backgroundColor = '#38b42f';
   font = 1;
 }
@@ -62,3 +62,11 @@ export class VideoStatus extends StatusRequest {
 
   caption: string;
 }
+
+export class DeleteStatusRequest extends StatusRequest {
+  @ApiProperty({
+    description: 'status message id',
+    example: 'AAAAAAAAAAAAAAAAA',
+  })
+  id: string;
+}

src/structures/webhooks.config.dto.ts

@@ -32,8 +32,10 @@ export class HmacConfiguration {
 
 export class WebhookConfig {
   @ApiProperty({
-    example: 'https://httpbin.org/post',
+    example: 'https://webhook.site/11111111-1111-1111-1111-11111111',
     required: true,
+    description:
+      'You can use https://docs.webhook.site/ to test webhooks and see the payload',
   })
   url: string;
 

src/structures/webhooks.dto.ts

@@ -1,5 +1,8 @@
 import { ApiProperty } from '@nestjs/swagger';
+import { CallData } from '@waha/structures/calls.dto';
+import { Label, LabelChatAssociation } from '@waha/structures/labels.dto';
 
+import { ChatArchiveEvent } from './chats.dto';
 import { MessageDestination } from './chatting.dto';
 import {
   WAHAEngine,
@@ -87,6 +90,7 @@ export class WAMessageRevokedBody {
   after?: WAMessage;
   before?: WAMessage;
 }
+
 export class WASessionStatusBody {
   @ApiProperty({
     example: 'default',
@@ -118,6 +122,7 @@ export class WAHAWebhook {
     // eslint-disable-next-line @typescript-eslint/ban-types
     | object;
 }
+
 class WAHAWebhookSessionStatus extends WAHAWebhook {
   @ApiProperty({
     description: 'The event is triggered when the session status changes.',
@@ -230,6 +235,82 @@ class WAHAWebhookPollVoteFailed extends WAHAWebhook {
   payload: PollVotePayload;
 }
 
+class WAHAWebhookChatArchive extends WAHAWebhook {
+  @ApiProperty({
+    description:
+      'The event is triggered when the chat is archived or unarchived',
+  })
+  event = WAHAEvents.CHAT_ARCHIVE;
+
+  payload: ChatArchiveEvent;
+}
+
+class WAHAWebhookCallReceived extends WAHAWebhook {
+  @ApiProperty({
+    description:
+      'The event is triggered when the call is received by the user.',
+  })
+  event = WAHAEvents.CALL_RECEIVED;
+
+  payload: CallData;
+}
+
+class WAHAWebhookCallAccepted extends WAHAWebhook {
+  @ApiProperty({
+    description:
+      'The event is triggered when the call is accepted by the user.',
+  })
+  event = WAHAEvents.CALL_ACCEPTED;
+
+  payload: CallData;
+}
+
+class WAHAWebhookCallRejected extends WAHAWebhook {
+  @ApiProperty({
+    description:
+      'The event is triggered when the call is rejected by the user.',
+  })
+  event = WAHAEvents.CALL_REJECTED;
+
+  payload: CallData;
+}
+
+class WAHAWebhookLabelUpsert extends WAHAWebhook {
+  @ApiProperty({
+    description: 'The event is triggered when a label is created or updated',
+  })
+  event = WAHAEvents.LABEL_UPSERT;
+
+  payload: Label;
+}
+
+class WAHAWebhookLabelDeleted extends WAHAWebhook {
+  @ApiProperty({
+    description: 'The event is triggered when a label is deleted',
+  })
+  event = WAHAEvents.LABEL_DELETED;
+
+  payload: Label;
+}
+
+class WAHAWebhookLabelChatAdded extends WAHAWebhook {
+  @ApiProperty({
+    description: 'The event is triggered when a label is added to a chat',
+  })
+  event = WAHAEvents.LABEL_CHAT_ADDED;
+
+  payload: LabelChatAssociation;
+}
+
+class WAHAWebhookLabelChatDeleted extends WAHAWebhook {
+  @ApiProperty({
+    description: 'The event is triggered when a label is deleted from a chat',
+  })
+  event = WAHAEvents.LABEL_CHAT_DELETED;
+
+  payload: LabelChatAssociation;
+}
+
 const WAHA_WEBHOOKS = [
   WAHAWebhookSessionStatus,
   WAHAWebhookMessage,
@@ -243,5 +324,13 @@ const WAHA_WEBHOOKS = [
   WAHAWebhookPresenceUpdate,
   WAHAWebhookPollVote,
   WAHAWebhookPollVoteFailed,
+  WAHAWebhookChatArchive,
+  WAHAWebhookCallReceived,
+  WAHAWebhookCallAccepted,
+  WAHAWebhookCallRejected,
+  WAHAWebhookLabelUpsert,
+  WAHAWebhookLabelDeleted,
+  WAHAWebhookLabelChatAdded,
+  WAHAWebhookLabelChatDeleted,
 ];
 export { WAHA_WEBHOOKS };

src/utils/SingleDelayedJobRunner.ts

@@ -0,0 +1,55 @@
+import { Logger } from 'pino';
+
+type FunctionNoArgs = () => Promise<any>;
+
+/**
+ * Run a job (function) after a delay,
+ * but make sure we run exactly ONE job at the same time
+ */
+export class SingleDelayedJobRunner {
+  private timeout: NodeJS.Timeout;
+  private logger: Logger;
+
+  constructor(
+    private name: string,
+    private timeoutMs: number,
+    logger: Logger,
+    private warningOverride: boolean = false,
+  ) {
+    this.logger = logger.child({
+      job: name,
+      class: SingleDelayedJobRunner.name,
+    });
+  }
+
+  schedule(fn: FunctionNoArgs): boolean {
+    if (this.timeout) {
+      const msg = `Job has been started before, do not schedule it again`;
+      this.log(this.warningOverride, msg);
+      return false;
+    }
+
+    this.timeout = setTimeout(() => {
+      this.logger.debug(`Running job...`);
+      fn().finally(() => {
+        this.logger.debug(`Job finished`);
+        this.timeout = null;
+      });
+    }, this.timeoutMs);
+    this.logger.info(`Job scheduled with timeout ${this.timeoutMs} ms`);
+    return true;
+  }
+
+  cancel() {
+    clearTimeout(this.timeout);
+    this.logger.info(`Job cancelled`);
+  }
+
+  private log(warning: boolean, msg: string) {
+    if (warning) {
+      this.logger.warn(msg);
+    } else {
+      this.logger.info(msg);
+    }
+  }
+}

src/utils/SinglePeriodicJobRunner.ts

@@ -0,0 +1,64 @@
+import { Logger } from 'pino';
+
+type FunctionNoArgs = () => Promise<any>;
+
+/**
+ * Run a job (function) in some interval,
+ * but make sure we run exactly ONE job at the same time
+ */
+export class SinglePeriodicJobRunner {
+  private interval: NodeJS.Timeout;
+  private isWorking: boolean = false;
+  private logger: Logger;
+
+  constructor(
+    private name: string,
+    private intervalMs: number,
+    logger: Logger,
+    private warningOverlap: boolean = true,
+    private warningOverride: boolean = false,
+  ) {
+    this.logger = logger.child({
+      job: name,
+      class: SinglePeriodicJobRunner.name,
+    });
+  }
+
+  start(fn: FunctionNoArgs): boolean {
+    if (this.interval) {
+      const msg = `Job has been started before, do not schedule it again`;
+      this.log(this.warningOverride, msg);
+      return false;
+    }
+
+    this.interval = setInterval(() => {
+      if (this.isWorking) {
+        const msg = `Job is already running, skipping this run`;
+        this.log(this.warningOverlap, msg);
+        return;
+      }
+
+      this.isWorking = true;
+      this.logger.debug('Running job...');
+      fn().finally(() => {
+        this.isWorking = false;
+        this.logger.debug(`Job finished`);
+      });
+    }, this.intervalMs);
+    this.logger.info(`Job started with interval ${this.intervalMs} ms`);
+    return true;
+  }
+
+  stop() {
+    clearInterval(this.interval);
+    this.logger.info(`Job stopped`);
+  }
+
+  private log(warning: boolean, msg) {
+    if (warning) {
+      this.logger.warn(msg);
+    } else {
+      this.logger.info(msg);
+    }
+  }
+}

src/utils/WebsocketHeartbeatJob.ts

@@ -0,0 +1,45 @@
+import { LoggerService } from '@nestjs/common';
+import { WebSocket } from '@waha/utils/ws';
+import { WebSocketServer } from 'ws';
+
+export class WebsocketHeartbeatJob {
+  private interval: ReturnType<typeof setInterval>;
+
+  constructor(
+    private logger: LoggerService,
+    private intervalTime: number = 10_000,
+  ) {}
+
+  start(server: WebSocketServer) {
+    server.on('connection', (ws: WebSocket) => {
+      ws.isAlive = true;
+      ws.on('pong', this.onPong(ws));
+    });
+
+    this.interval = setInterval(() => {
+      server.clients.forEach((client: WebSocket) => {
+        if (client.isAlive === false) {
+          this.logger.debug(
+            `Terminating client connection due to heartbeat timeout, ${client.id}`,
+          );
+          return client.terminate();
+        }
+
+        client.isAlive = false;
+        this.logger.debug(`Sending heartbeat (ping) to ${client.id}`);
+        client.ping();
+      });
+    }, this.intervalTime);
+  }
+
+  stop() {
+    clearInterval(this.interval);
+  }
+
+  private onPong(ws: WebSocket) {
+    return (event: any) => {
+      ws.isAlive = true;
+      this.logger.debug(`Heartbeat (pong) received from ${ws.id}`);
+    };
+  }
+}

src/utils/logging.ts

@@ -0,0 +1,73 @@
+import { LogLevel } from '@nestjs/common';
+import { ChildLoggerOptions, Level, LevelWithSilent, Logger } from 'pino';
+
+export interface LoggerBuilder {
+  child(bindings: Record<string, any>, options?: ChildLoggerOptions): Logger;
+}
+
+function getNestJSLogLevels(): LogLevel[] {
+  const level = getPinoLogLevel();
+  switch (level) {
+    case 'trace':
+      return ['error', 'warn', 'log', 'debug', 'verbose'];
+    case 'debug':
+      return ['error', 'warn', 'log', 'debug'];
+    case 'info':
+      return ['error', 'warn', 'log'];
+    case 'warn':
+      return ['error', 'warn'];
+    case 'error':
+      return ['error', 'warn'];
+    default:
+      return ['error', 'warn', 'log'];
+  }
+}
+
+export function getPinoLogLevel(debug: boolean = false): Level {
+  const enableDebug = process.env.DEBUG != undefined || debug;
+  if (enableDebug) {
+    return 'debug';
+  }
+  return getDefaultPinoLogLevel();
+}
+
+export function getPinoHttpUseLevel(): LevelWithSilent {
+  const levels = ['fatal', 'error', 'warn', 'info', 'debug', 'trace'];
+  const level = (process.env.WAHA_HTTP_LOG_LEVEL || 'info').toLowerCase();
+  if (!levels.includes(level)) {
+    console.error(
+      `Unknown ${process.env.WAHA_HTTP_LOG_LEVEL}' value for WAHA_HTTP_LOG_LEVEL`,
+    );
+    return 'info';
+  }
+  return level as LevelWithSilent;
+}
+
+export function getDefaultPinoLogLevel(): Level {
+  const logLevel = (process.env.WAHA_LOG_LEVEL || 'info').toLowerCase();
+  const levels = ['fatal', 'error', 'warn', 'info', 'debug', 'trace'];
+  if (!levels.includes(logLevel)) {
+    console.error(
+      `Unknown ${process.env.WAHA_LOG_LEVEL}' value for WAHA_LOG_LEVEL`,
+    );
+    return 'info';
+  }
+  return logLevel as Level;
+}
+
+export function getPinoTransport() {
+  const logFormat = (process.env.WAHA_LOG_FORMAT || 'PRETTY').toUpperCase();
+  if (logFormat == 'JSON') {
+    return undefined;
+  }
+  return {
+    target: 'pino-pretty',
+    options: {
+      singleLine: true,
+      colorize: true,
+      messageFormat: '{if session} session:{session} - {end}{msg}',
+    },
+  };
+}
+
+export { getNestJSLogLevels };

src/utils/promiseTimeout.ts

@@ -32,3 +32,7 @@ export const promiseTimeout = function (
     ),
   ]).finally(() => clearTimeout(timer));
 };
+
+export async function sleep(ms: number) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

src/utils/ws.ts

@@ -0,0 +1,6 @@
+import { WebSocket as WSWebSocket } from 'ws';
+
+export interface WebSocket extends WSWebSocket {
+  id?: string;
+  isAlive?: boolean;
+}

src/version.ts

@@ -33,7 +33,7 @@ export function getEngineName(): string {
 }
 
 export const VERSION: WAHAEnvironment = {
-  version: '2024.5.14',
+  version: '2024.8.4',
   engine: getEngineName(),
   tier: getWAHAVersion(),
   browser: getBrowserExecutablePath(),

tsconfig.json

@@ -9,7 +9,10 @@
     "target": "es2017",
     "sourceMap": true,
     "outDir": "./dist",
-    "baseUrl": "./",
+    "baseUrl": "./src",
+    "paths": {
+      "@waha/*": ["*"]
+    },
     "incremental": true,
     "resolveJsonModule": true,
     "skipLibCheck": true