# 9router-Antigravity Auto Add Bot

Bot otomatis untuk menambahkan akun GSuite ke **9router-Antigravity** via Google OAuth.
Bot Harus Jalan di Host yang sama dengan 9router

## Stack

- **CloakBrowser** — Stealth Chromium (anti bot detection, bypass Google CAPTCHA)
- **Playwright API** compatible
- **Node.js** ESM

## Install

```bash
cd gsuite-auto
npm install
```

Pastikan CloakBrowser binary sudah ter-download. Kalau download otomatis gagal (network/firewall), manual:

1. Download dari https://github.com/CloakHQ/cloakbrowser/releases
2. Extract ke `~/.cloakbrowser/chromium-<version>/`
   - Windows: `C:\Users\<username>\.cloakbrowser\chromium-<version>\`

## Config

### `config.json`

```json
{
  "nineRouter": {
    "url": "http://localhost:20128",
    "password": "123456"
  },
  "accountsFile": "accounts.txt",
  "settings": {
    "headless": true,
    "slowMo": 300,
    "timeout": 60000,
    "delayBetweenAccounts": 5000
  }
}
```

| Key | Description |
|-----|-------------|
| `nineRouter.url` | URL 9router instance |
| `nineRouter.password` | Login password 9router |
| `accountsFile` | File list akun (default: `accounts.txt`) |
| `headless` | `true` = tanpa browser window, `false` = visible |
| `slowMo` | Delay antar action (ms) |
| `timeout` | Max tunggu per step (ms) |
| `delayBetweenAccounts` | Delay antar akun (ms) |

### `accounts.txt`

Format: `email|password` per baris

```
user1@astrora.me|password123
user2@astrora.me|password456
# comment bisa pakai #
baris kosong di-skip
```

Support multiple file untuk batch berbeda:
```
accounts-batch1.txt
accounts-batch2.txt
```

## Usage

```bash
# Normal run (headless dari config.json)
node bot.js

# Force headless via CLI
node bot.js --headless

# Force visible browser
node bot.js --no-headless

# Dry run (test tanpa eksekusi)
node bot.js --dry-run

# Pakai file accounts lain
node bot.js --file accounts-batch2.txt
```

## Flow

```
Untuk SETIAP akun (fresh browser context):
│
├─ 1. Buka browser baru (clean session, ga ada cookie Google lama)
├─ 2. Login 9router
├─ 3. Navigate → Providers → Antigravity
├─ 4. Click "Add"
├─ 5. Click "I Understand, Continue" → buka popup Google OAuth
├─ 6. Force hl=en di URL Google (paksa English UI)
├─ 7. Input email → click Next
│     (multi-bahasa: EN/ID/JA/KO/ZH/FR/ES/DE/RU)
├─ 8. Input password → Enter
│     (multi-bahasa: EN/ID/JA/KO/ZH/FR/ES/DE/RU)
├─ 9. Verify "I understand" (Workspace Terms)
│     → click kalau ada, skip kalau ga ada
├─ 10. Wait consent page → click Sign in/Continue/Allow
│      (multi-bahasa: EN/ID/JA/KO/ZH/FR/ES/DE/RU)
├─ 11. Verify email muncul di Antigravity page
│      (max 3x refresh)
├─ 12. Close browser context
└─ 13. Next akun (fresh context lagi)
```

## Multi-Language Support

Google kadang render UI sesuai bahasa akun, bukan bahasa browser. Bot handle semua variasi:

| Element | Bahasa |
|---------|--------|
| Email input | Email or phone,Alamat email atau nomor telepon,メールアドレスまたは電話番号,이메일 또는 전화번호,电子邮件或电话号码,... |
| Next button | Next,Berikutnya,Lanjut,次へ,다음,下一步,Suivant,Siguiente,Weiter,Далее |
| Password | Enter your password,Masukkan kata sandi Anda,パスワードを入力,비밀번호 입력,输入密码,... |
| Terms | I understand,Saya mengerti,理解しました,이해했습니다,我明白了,... |
| Consent | Sign in,Masuk,ログイン,登录,Se connecter,Iniciar sesión,Anmelden,Войти,... |

Log output nunjukin match yang mana:
```
[>] Email → "Alamat email atau nomor telepon"
[>] Next → "Berikutnya"
[>] OAuth Consent → "Masuk"
```

## Output

| File | Description |
|------|-------------|
| `accounts.txt` | Auto-update — akun yang berhasil dihapus, sisa yang belum |
| `log-YYYY-MM-DD.json` | Hasil detail per akun (success/fail/error) |
| `screenshots/` | Screenshot otomatis kalau error |

## File Structure

```
9router-autobot/
├── bot.js              # Main bot script
├── config.json         # Config (URL, password, settings)
├── accounts.txt        # List akun (email|password)
├── package.json
├── README.md
├── recorded-actions.js # Raw Playwright codegen recording (reference)
├── record.js           # Playwright codegen launcher (untuk re-record)
└── screenshots/        # Error screenshots (auto-generated)
```

## Fitur

- **Fresh context per akun** — session Google ga nyangkut antar akun
- **CloakBrowser stealth** — bypass bot detection Google
- **Multi-language** — handle UI Google dalam bahasa apapun
- **Auto-remove** — akun yang berhasil dihapus dari `accounts.txt`
- **Auto-retry verify** — refresh max 3x kalau email belum muncul
- **Error screenshot** — auto-capture kalau gagal
- **Log harian** — `log-YYYY-MM-DD.json` per run

## Troubleshooting

| Masalah | Solusi |
|---------|--------|
| `CLOAKBROWSER_BINARY_PATH` error | Download manual binary ke `~/.cloakbrowser/` |
| Download binary gagal (network) | Download via browser, extract manual ke `~/.cloakbrowser/chromium-<version>/` |
| Google CAPTCHA di headless | Pastikan pakai CloakBrowser (bukan Playwright biasa) |
| UI Google bahasa lokal | Normal — bot handle multi-bahasa otomatis |
| Email ga verify di page | Bot auto-refresh 3x. Kalau tetap gagal, cek manual |
| `Failed to assign a backend` | Akun sudah ada di 9router atau quota habis |
| Akun 1 berhasil, akun 2 gagal | Normal kalau Terms baru pertama kali — jalankan lagi |
| Popup consent ga ke-click | Cek log, kemungkinan bahasa belum ter-cover |

## Tips

- **Test dulu** dengan `node bot.js --dry-run` sebelum run beneran
- **1 akun dulu** — pastikan flow-nya benar sebelum batch
- **Crash-safe** — bot update `accounts.txt` per akun, jadi restart lanjut dari yang belum selesai
- **Headless** lebih cepat tapi kadang beda behavior — test visible dulu
- **Delay** — kalau sering gagal, naikkan `delayBetweenAccounts` di config