# Someshwar AI WhatsApp Messenger requirements

## Runtime

- Node.js 18 or newer
- npm
- PostgreSQL 13 or newer (the configured database user must be allowed to create `DB_NAME`)
- A public HTTPS URL for production Meta WhatsApp webhook callbacks

## External services

- Meta WhatsApp Cloud API app, phone number, Phone Number ID, access token, and webhook verification token for each client
- Groq API key and model for clients that enable AI replies
- SMTP credentials for the password-reset email feature

## Environment variables

Required to run the application:

```env
PORT=3000
NODE_ENV=development

DB_HOST=localhost
DB_PORT=5432
DB_NAME=someshwar_ai
DB_USER=postgres
DB_PASSWORD=your_postgres_password

AUTH_JWT_SECRET=replace_with_a_long_random_secret
WA_VERIFY_TOKEN=your_meta_webhook_verify_token
```

Required only for password-reset emails:

```env
COMPANY_EMAIL=your_smtp_email
COMPANY_PASS=your_smtp_password
```

The webhook verification token is read from `.env`. WhatsApp access credentials and Groq settings are managed per client in the application after sign-in.

## Install and run

```bash
npm install
npm run db:setup
npm run dev
```

Use `npm start` to run without Nodemon. The database setup command creates the configured PostgreSQL database if it does not exist and imports `src/db/schema.sql`.

## Node.js packages

All application dependencies are declared in `package.json` and installed through `npm install`. Key packages include Express, PostgreSQL (`pg`), Socket.IO, Axios, Multer, Nodemailer, bcryptjs, and Node Cron.