chahinebrini 807847381f fix(mail): Junk-Folder IDLE-Gap + Layer 2.6 global Display-Name-Patterns
Task 1 — Junk-Folder Fix:
- noopTimer (alle 2min) ruft jetzt triggerScan(conn) fire-and-forget auf
- Outlook/Hotmail-Mails die direkt in "Junk Email" landen werden damit
  innerhalb von max. 2min erfasst (IDLE hört nur INBOX, kein exists-Event)
- Consent-Guard analog exists-Event: nur wenn conn.consentAt gesetzt

Task 2 — Layer 2.6 global Display-Name-Patterns:
- getMailDisplayNamePatterns(userId) neu in db/domains.ts:
  lädt aus global_mail_display_names (admin-curated, pending Migration)
  + user_custom_domains type=mail_display_name (backward-compat)
  mit try/catch-Fallback bis Schema-Migration deployed ist
- getCustomMailDisplayNames() als @deprecated markiert (bleibt für Übergangszeitraum)
- scan-internal.post.ts: Import auf getMailDisplayNamePatterns umgestellt
- mail-classifier.ts: Layer 2.6 Kommentar von "dead code" auf "live v1.1" aktualisiert

Schema-Migration (global_mail_display_names) ist Aufgabe von rebreak-backend.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-28 16:07:05 +02:00
..

rebreak-imap-idle

Standalone IMAP IDLE Daemon für Rebreak.

Was er macht

  • Hält pro aktiver MailConnection (DB) eine persistente IMAP-IDLE-Session
  • Reagiert in Echtzeit auf EXISTS-Events (neue Mail im Postfach)
  • Feuert bei jedem Event POST /api/mail/scan-internal gegen das lokale Backend
  • Das Backend entscheidet ob und welche Mails gelöscht werden (Gambling-Keywords + Blocklist)
  • Aktualisiert alle 5 min die Connection-Liste (neue User → neue Sessions, entfernte → geschlossen)
  • IDLE wird alle 25 min erneuert (RFC 3501 Server-Timeout liegt bei 29 min)

Env-Vars

Variable Pflicht Beschreibung
DATABASE_URL ja Postgres-Connection-String (Supabase Pooler oder direkt)
ADMIN_SECRET ja Shared Secret für /api/mail/scan-internal Header
ENCRYPTION_KEY ja AES-256 Key (identisch zum Backend-Key, 32+ Zeichen)
BACKEND_URL nein Default: http://127.0.0.1:3016 (staging) / 3015 (prod)
NODE_ENV nein production → BACKEND_URL default port 3015

Lokal starten (Entwicklung)

cd backend/imap-idle
npm install
DATABASE_URL=<...> ADMIN_SECRET=<...> ENCRYPTION_KEY=<...> node index.mjs

Via Infisical (analog zu start-staging.sh):

infisical run --env=staging -- node index.mjs

PM2 (Produktion)

Wird via ecosystem.config.js gestartet — siehe docs/internal/MAIL_DAEMON_DEPLOYMENT.md.

Logs (pm2)

[idle/<email>] connected (imap.gmail.com:993)
[idle/<email>] exists-event received (new mail)
[idle/<email>] scan-triggered → scanned=12 blocked=1
[idle/<email>] idle renewing (25min threshold)
[idle/<email>] reconnecting in 5s (attempt 2)
[idle/db] refreshed — 47 active connections, 47 sessions