wa-diff

Tooling to version WhatsApp Web JavaScript bundles and inspect diffs across releases.

What it does

1. Uses @vinikjkkj/wa-fetcher (discoverBundleUrls, URL-only mode) to discover every .js bundle URL referenced by web.whatsapp.com.
2. Saves the collected URLs to urls.json.
3. Exports bundles with wa-export into files/ (flat mode).
4. Runs Prettier on the exported files.

Project files

• main.js: end-to-end runner (fetch URLs, export bundles, format files).
• urls.json: generated list of collected bundle URLs.
• files/: generated exported JavaScript files from wa-export.

Requirements

• Node.js >=20
• npm >=10

Install

npm install

Run

npm run fetch

or:

node main.js

Current export command

The runner executes this logic after generating urls.json:

wa-export urls.json files --workers 50 --flat

Then it formats the output:

prettier --write files --ignore-unknown

NPM scripts

• npm run start: run main.js
• npm run fetch: run main.js
• npm run check: syntax-check main.js
• npm run format: run Prettier on the repo
• npm run format:check: check Prettier formatting

Typical versioning workflow

1. Run npm run fetch.
2. Review changed files in urls.json and files/.
3. Commit the update.
4. Compare commits to analyze WhatsApp bundle changes.

AI-generated release notes

Each commit pushed by the daily workflow gets an automatic GitHub Release summarizing what changed. The summary is produced by Gemini 2.5 Flash from the commit's --stat and git diff -U1 (when small enough), and includes both English and Portuguese versions in collapsible sections.

• Tag format: vYYYY.MM.DD-HHMM (commit timestamp, UTC)
• Generator: .github/scripts/explain_commit.py
• Workflow step lives in .github/workflows/daily-update.yml
• Requires repo secret GEMINI_API_KEY (get one here)

Browse the latest summaries in the Releases tab.

Notes

• This project is intended for analysis/versioning workflows.
• Use responsibly and respect platform terms and applicable laws.