## Dépannage

---

### Erreurs courantes

---

#### Profil non configuré

```
Error: No profile configured. Run 'rbw config create-profile' first.
```

**Solution** : Créez un profil avec la commande :

```bash
rbw config create-profile
```

#### Erreur d'authentification (401)

```
Error: 401 Unauthorized
```

**Causes possibles** :
- Identifiants expirés ou incorrects
- Clé API révoquée
- Token OAuth expiré

**Solutions** :
- Vérifiez vos identifiants : `rbw config show-profile`
- Mettez à jour le profil : `rbw config update-profile <nom>`
- Pour OAUTH, relancez le flux de connexion

#### Module introuvable (ERR_MODULE_NOT_FOUND)

```
Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'xyz'
```

**Solution** : Réinstallez le package :

```bash
npm install -g rainbow-cli-ng
```

#### Keyring inaccessible

Sur certains systèmes Linux sans session graphique (serveurs CI, conteneurs Docker), le trousseau système peut ne pas être disponible.

**Solution** : Configurez un keyring headless ou utilisez `gnome-keyring` avec D-Bus :

```bash
eval $(gnome-keyring-daemon --start)
export GNOME_KEYRING_CONTROL
```

#### Permission refusée sur la commande rbw

```
permission denied: rbw
```

**Solution** : Vérifiez que le répertoire bin de npm global est dans votre `PATH` :

```bash
npm config get prefix
# Ajoutez <prefix>/bin à votre PATH si nécessaire
```

### Débogage

---

#### Activer les logs détaillés

```bash
rbw --debug <commande>
rbw --verbose <commande>
```

L'option `--debug` affiche les requêtes HTTP, les headers d'authentification (masqués) et les réponses complètes.

#### Écrire les logs dans un fichier

```bash
rbw --log debug.log <commande>
```

Utile pour analyser les problèmes en environnement de production sans surcharger la console.

#### Vérifier la version installée

```bash
rbw --version
```

### Obtenir de l'aide

---

- Aide intégrée : `rbw --help` ou `rbw <commande> --help`
- Documentation en ligne : [developers.openrainbow.com](https://developers.openrainbow.com)
- Support Rainbow : [support@openrainbow.com](mailto:support@openrainbow.com)
