Que fait raffle-winner-picker ?
Sélectionne aléatoirement des gagnants à partir de listes, feuilles de calcul ou Google Sheets pour des jeux concours, tirages au sort et loteries. Garantit une sélection équitable, impartiale et transparente.
Fonctionnalités
- Sélection aléatoire : Utilise un générateur de nombres aléatoires cryptographiquement sécurisé (CSPRNG) pour garantir l'équité.
- Sources de données : Prend en charge les listes, les fichiers CSV, les tableurs Excel et Google Sheets.
- Transparence : Fournit des logs détaillés et une preuve de la sélection pour chaque tirage.
- Personnalisation : Permet de configurer le nombre de gagnants, les exclusions, et les critères de filtrage.
- Intégration : Fonctionne avec des agents IA comme Claude Code, Cursor et Codex.
Installation
npm install composiohq/raffle-winner-picker
Utilisation
const RaffleWinnerPicker = require('composiohq/raffle-winner-picker');
const picker = new RaffleWinnerPicker({
source: 'google-sheets',
sheetId: 'VOTRE_ID_DE_FEUILLE',
column: 'A',
winnersCount: 3
});
const winners = picker.pick();
console.log('Gagnants :', winners);
Configuration
| Variable d'environnement | Description | Valeur par défaut |
|---|---|---|
GOOGLE_SHEETS_API_KEY | Clé API pour Google Sheets | (aucune) |
RAFFLE_SEED | Graine optionnelle pour le générateur aléatoire | (aléatoire) |
Documentation
Pour plus de détails, consultez la documentation complète.