feat(bot): add EN/ES/PT language support in onboarding flow

Replace 2-button interactive picker with 5-language interactive list
(FR, Wolof, EN, ES, PT). WhatsApp buttons are capped at 3, so the
list format is now used throughout the language selection step.

Adds getDefaultTrack() and getSectorConfirmMsg() helpers to map all
5 languages to their respective track IDs and localised confirmations.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

apps/whatsapp-worker/src/handlers/OnboardingHandler.ts

@@ -5,6 +5,14 @@ import { logger } from '../logger';
 import { clearTimeTravelContext } from '../timeTravelContext';
 import { FlowConfigSchema } from '@repo/shared-types';
 
+const LANGUAGE_ROWS = [
+    { id: 'LANG_FR', title: 'Français 🇫🇷' },
+    { id: 'LANG_WO', title: 'Wolof 🇸🇳' },
+    { id: 'LANG_EN', title: 'English 🇬🇧' },
+    { id: 'LANG_ES', title: 'Español 🇪🇸' },
+    { id: 'LANG_PT', title: 'Português 🇧🇷' },
+];
+
 const LEGACY_SECTORS: Array<{ id: string; label: string }> = [
     { id: 'SEC_COMMERCE', label: 'Commerce / Vente' },
     { id: 'SEC_AGRI', label: 'Agriculture / Élevage' },
@@ -25,6 +33,22 @@ function getValidatedConfig(ctx: MessageContext) {
     return parsed.data;
 }
 
+function getDefaultTrack(language: string): string {
+    const map: Record<string, string> = { FR: 'T1-FR', WOLOF: 'T1-WO', EN: 'T1-EN', ES: 'T1-ES', PT: 'T1-PT' };
+    return map[language] ?? 'T1-FR';
+}
+
+function getSectorConfirmMsg(language: string, activity: string): string {
+    const map: Record<string, string> = {
+        FR:    `Secteur noté : *${activity}*`,
+        WOLOF: `Bind nanu la ci: *${activity}*`,
+        EN:    `Sector noted: *${activity}*`,
+        ES:    `Sector registrado: *${activity}*`,
+        PT:    `Setor registrado: *${activity}*`,
+    };
+    return map[language] ?? `Secteur noté : *${activity}*`;
+}
+
 function getSectors(ctx: MessageContext): Array<{ id: string; label: string }> {
     const config = getValidatedConfig(ctx);
     return config?.sectors || LEGACY_SECTORS;
@@ -38,7 +62,7 @@ export class OnboardingHandler implements MessageHandler {
         if (isFuzzyMatch(normalizedText, 'INSCRIPTION') || normalizedText.includes('INSCRI')) return true;
         
         // 2. Language Selection
-        if (normalizedText === 'LANG_FR' || normalizedText === 'LANG_WO') return true;
+        if (['LANG_FR', 'LANG_WO', 'LANG_EN', 'LANG_ES', 'LANG_PT'].includes(normalizedText)) return true;
         
         // 3. Sector Selection (only if not active enrollment)
         const sectors = getSectors(ctx);
@@ -62,16 +86,14 @@ export class OnboardingHandler implements MessageHandler {
             if (user) {
                 // Guard: if user hasn't completed onboarding yet (no activity), skip hard reset
                 if (!user.activity) {
-                    logger.info({ traceId, userId: user.id }, "INSCRIPTION during onboarding — resending language buttons");
-                    bodyText = user.language === 'WOLOF' ? "Tànnal sa làkk :" : "Choisissez votre langue :";
-                    await whatsappQueue.add('send-interactive-buttons', {
+                    logger.info({ traceId, userId: user.id }, "INSCRIPTION during onboarding — resending language list");
+                    await whatsappQueue.add('send-interactive-list', {
                         userId: user.id,
                         organizationId: ctx.organizationId,
-                        bodyText,
-                        buttons: [
-                            { id: 'LANG_FR', title: 'Français 🇫🇷' },
-                            { id: 'LANG_WO', title: 'Wolof 🇸🇳' }
-                        ]
+                        headerText: "XAMLÉ",
+                        bodyText: "Choose your language / Choisissez votre langue / Tànnal sa làkk",
+                        buttonLabel: "Language",
+                        sections: [{ title: "Languages", rows: LANGUAGE_ROWS }]
                     });
                     return true;
                 }
@@ -96,14 +118,13 @@ export class OnboardingHandler implements MessageHandler {
                 bodyText = "Bienvenue ! Choisissez votre langue :";
             }
 
-            await whatsappQueue.add('send-interactive-buttons', {
+            await whatsappQueue.add('send-interactive-list', {
                 userId: user.id,
                 organizationId: ctx.organizationId,
+                headerText: "XAMLÉ",
                 bodyText,
-                buttons: [
-                    { id: 'LANG_FR', title: 'Français 🇫🇷' },
-                    { id: 'LANG_WO', title: 'Wolof 🇸🇳' }
-                ]
+                buttonLabel: "Language",
+                sections: [{ title: "Languages", rows: LANGUAGE_ROWS }]
             });
             return true;
         }
@@ -111,32 +132,31 @@ export class OnboardingHandler implements MessageHandler {
         if (!user) return false;
 
         // --- 2. Language selection ---
-        if (normalizedText === 'LANG_FR' || normalizedText === 'LANG_WO') {
-            const newLang = normalizedText === 'LANG_FR' ? 'FR' : 'WOLOF';
-            user = await prisma.user.update({ where: { id: user.id }, data: { language: newLang } });
-            const promptText = newLang === 'FR' ? "Parfait ! Dans quel domaine te trouves-tu ?" : "Baax na ! Ci ban mbir ngay yëngu ?";
-            
+        const LANG_MAP: Record<string, { lang: 'FR' | 'EN' | 'ES' | 'PT' | 'WOLOF'; sectorPrompt: string; sectorHeader: string; sectorButton: string; sectorOther: string; sectorSection: string }> = {
+            LANG_FR: { lang: 'FR',    sectorPrompt: "Parfait ! Dans quel domaine travailles-tu ?", sectorHeader: "Ton secteur",  sectorButton: "Secteurs", sectorOther: "Autre secteur",  sectorSection: "Liste" },
+            LANG_WO: { lang: 'WOLOF', sectorPrompt: "Baax na ! Ci ban mbir ngay yëngu ?",          sectorHeader: "Sa Mbir",      sectorButton: "Tànn",     sectorOther: "Beneen mbir",    sectorSection: "Mbir"  },
+            LANG_EN: { lang: 'EN',    sectorPrompt: "Great! What sector do you work in?",           sectorHeader: "Your sector",  sectorButton: "Sectors",  sectorOther: "Other sector",   sectorSection: "List"  },
+            LANG_ES: { lang: 'ES',    sectorPrompt: "¡Perfecto! ¿En qué sector trabajas?",          sectorHeader: "Tu sector",    sectorButton: "Sectores", sectorOther: "Otro sector",    sectorSection: "Lista" },
+            LANG_PT: { lang: 'PT',    sectorPrompt: "Ótimo! Em que setor você trabalha?",           sectorHeader: "Seu setor",    sectorButton: "Setores",  sectorOther: "Outro setor",    sectorSection: "Lista" },
+        };
+
+        if (normalizedText in LANG_MAP) {
+            const { lang, sectorPrompt, sectorHeader, sectorButton, sectorOther, sectorSection } = LANG_MAP[normalizedText];
+            user = await prisma.user.update({ where: { id: user.id }, data: { language: lang } });
+
             const sectors = getSectors(ctx);
-            const rows = sectors.map((s) => ({
-                id: s.id,
-                title: s.label
-            }));
-            
-            // Add fallback "Other" if less than 10 sectors (Meta limit is 10 rows per section)
+            const rows = sectors.map((s) => ({ id: s.id, title: s.label }));
             if (rows.length < 10 && !rows.some(r => r.id === 'SEC_AUTRE')) {
-                rows.push({ id: 'SEC_AUTRE', title: newLang === 'FR' ? 'Autre secteur' : 'Beneen mbir' });
+                rows.push({ id: 'SEC_AUTRE', title: sectorOther });
             }
 
             await whatsappQueue.add('send-interactive-list', {
                 userId: user.id,
                 organizationId: ctx.organizationId,
-                headerText: newLang === 'FR' ? "Ton secteur" : "Sa Mbir",
-                bodyText: promptText,
-                buttonLabel: newLang === 'FR' ? "Secteurs" : "Tànn",
-                sections: [{
-                    title: newLang === 'FR' ? 'Liste' : 'Mbir',
-                    rows
-                }]
+                headerText: sectorHeader,
+                bodyText: sectorPrompt,
+                buttonLabel: sectorButton,
+                sections: [{ title: sectorSection, rows }]
             });
             return true;
         }
@@ -147,11 +167,11 @@ export class OnboardingHandler implements MessageHandler {
         if (sector || normalizedText.startsWith('SEC_')) {
             const activity = sector ? sector.label : text.trim();
             user = await prisma.user.update({ where: { id: user.id }, data: { activity } });
-            const msg = user.language === 'FR' ? `Secteur noté : *${activity}*` : `Bind nanu la ci: *${activity}*`;
+            const msg = getSectorConfirmMsg(user.language, activity);
             await whatsappQueue.add('send-message', { userId: user.id, organizationId: ctx.organizationId, text: msg });
 
             const config = getValidatedConfig(ctx);
-            const trackId = config?.defaultTrackId || (user.language === 'FR' ? 'T1-FR' : 'T1-WO');
+            const trackId = config?.defaultTrackId || getDefaultTrack(user.language);
 
             await whatsappQueue.add('enroll-user', { userId: user.id, trackId, organizationId: ctx.organizationId });
             return true;
@@ -160,12 +180,12 @@ export class OnboardingHandler implements MessageHandler {
         // --- 4. Free-text Activity detection ---
         if (!user.activity && text.length > 2) {
             user = await prisma.user.update({ where: { id: user.id }, data: { activity: text.trim() } });
-            const msg = user.language === 'FR' ? `Secteur noté : *${text.trim()}*` : `Bind nanu la ci: *${text.trim()}*`;
+            const msg = getSectorConfirmMsg(user.language, text.trim());
             await whatsappQueue.add('send-message', { userId: user.id, organizationId: ctx.organizationId, text: msg });
-            
+
             const config = getValidatedConfig(ctx);
-            const trackId = config?.defaultTrackId || (user.language === 'FR' ? 'T1-FR' : 'T1-WO');
-            
+            const trackId = config?.defaultTrackId || getDefaultTrack(user.language);
+
             await whatsappQueue.add('enroll-user', { userId: user.id, trackId, organizationId: ctx.organizationId });
             return true;
         }