kundencenter/apps/api/test/mailbox.test.ts
Claude (KI) 914599df50 IMAP-Posteingang: Zuordnung nur mit signiertem Antwort-Bezug, Wiederholung, Dubletten (#107)
- Absender (From) und Ticketnummer im Betreff sind fälschbar und ordnen nicht
  mehr automatisch zu. Ausgehende Ticket-Mails tragen eine Message-ID mit
  Ticket-ID + HMAC (KC_SECRET_KEY); nur Antworten mit gültigem Bezug in
  In-Reply-To/References von einem aktiven Mitglied des aktiven Kunden
  werden angehängt. Alles andere: Posteingang mit vorausgefülltem Vorschlag.
- Fehler einer UID: last_uid bleibt davor stehen, bis zu 5 Wiederholungen,
  danach als nicht verarbeitbar im Posteingang abgelegt (Mail geht nicht
  verloren). UIDVALIDITY wird gespeichert; Wechsel = neuer Startpunkt.
- Verarbeitung je Nachricht in einer Transaktion; Dubletten-Schutz per
  UNIQUE(uid_validity, uid); Ticketnummern über dieselbe Verbindung.
- Posteingang zuweisen/anhängen/ignorieren atomar (kein Doppel-Ticket).
- Migration 039.

Hinweis: neue Mails bekannter Kunden ohne Bezug legen kein Ticket mehr
automatisch an, sondern warten im Posteingang (Vorschlag vorausgefüllt).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 11:24:36 +02:00

50 lines
3.8 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

import { beforeAll, describe, expect, it } from 'vitest';
import { randomUUID } from 'node:crypto';
import { one, query, run } from '../src/core/db.js';
import { processMessage } from '../../worker/src/mailbox.js';
import { ticketReplyMessageId } from '@kc/platform/ticketmail';
import { makeUser } from './helpers.js';
const log = () => undefined;
const mail = (h: Record<string, string>, body = 'Hallo') => Buffer.from(Object.entries({ Date: new Date().toUTCString(), 'Message-ID': `<${randomUUID()}@ext.example>`, ...h }).map(([k, v]) => `${k}: ${v}`).join('\r\n') + '\r\n\r\n' + body);
let org: string; let ticketId: string; let ticketNumber: string;
beforeAll(async () => {
org = randomUUID(); await run("INSERT INTO organizations (id, customer_number, name, customer_type) VALUES (?, 'K-MAIL1', 'Mail AG', 'business')", [org]);
const u = await makeUser({ email: 'kunde@mail.example' }); await run("INSERT INTO memberships (org_id, user_id, role) VALUES (?,?,'owner')", [org, u]);
ticketId = randomUUID(); ticketNumber = 'T-77001';
await run("INSERT INTO tickets (id, number, org_id, subject, status, priority, created_by) VALUES (?,?,?,?, 'pending_customer', 'normal', ?)", [ticketId, ticketNumber, org, 'Problem', u]);
});
const msgs = () => query('SELECT body FROM ticket_messages WHERE ticket_id = ?', [ticketId]);
describe('IMAP-Posteingang (#107)', () => {
it('gefälschter Absender + Ticketnummer im Betreff hängt NICHTS an, landet mit Vorschlag im Posteingang', async () => {
await processMessage(1001, 9, mail({ From: 'kunde@mail.example', To: 'support@x', Subject: `Re: ${ticketNumber} Problem` }, 'gefälscht'), log);
expect(await msgs()).toHaveLength(0);
const r = await one('SELECT status, suggested_ticket_id, suggested_user_id FROM inbox_messages WHERE uid = 1001');
expect(r!.status).toBe('unmatched'); expect(r!.suggested_ticket_id).toBe(ticketId); expect(r!.suggested_user_id).toBeTruthy();
});
it('Antwort mit signiertem Bezug vom Kunden wird angehängt; Wiederholung derselben UID erzeugt keine Dublette', async () => {
const ref = ticketReplyMessageId(ticketId, 'support@flexible-domains.de');
const src = mail({ From: 'Kunde <kunde@mail.example>', To: 'support@x', Subject: 'Re: Ihr Ticket', 'In-Reply-To': ref, References: ref }, 'echte Antwort');
await processMessage(1002, 9, src, log);
await processMessage(1002, 9, src, log); // erneuter Lauf (z. B. nach Abbruch) – keine zweite Nachricht
expect((await msgs()).map((m) => m.body)).toEqual(['echte Antwort']);
expect((await one('SELECT status FROM tickets WHERE id = ?', [ticketId]))!.status).toBe('pending_staff');
});
it('gültiger Bezug, aber fremder Absender oder manipulierte Signatur → Posteingang', async () => {
const ref = ticketReplyMessageId(ticketId, 'support@flexible-domains.de');
await processMessage(1003, 9, mail({ From: 'angreifer@evil.example', Subject: 'Re', 'In-Reply-To': ref }), log);
const forged = ref.replace(/\.([A-Za-z0-9_-]{22})\./, '.AAAAAAAAAAAAAAAAAAAAAA.');
await processMessage(1004, 9, mail({ From: 'kunde@mail.example', Subject: 'Re', 'In-Reply-To': forged }), log);
expect((await msgs())).toHaveLength(1);
expect((await query("SELECT uid FROM inbox_messages WHERE uid IN (1003,1004) AND status = 'unmatched'"))).toHaveLength(2);
});
it('gesperrter Kunde: auch mit gültigem Bezug keine automatische Antwort', async () => {
await run("UPDATE organizations SET status = 'suspended' WHERE id = ?", [org]);
const ref = ticketReplyMessageId(ticketId, 'support@flexible-domains.de');
await processMessage(1005, 9, mail({ From: 'kunde@mail.example', Subject: 'Re', 'In-Reply-To': ref }), log);
expect((await msgs())).toHaveLength(1);
await run("UPDATE organizations SET status = 'active' WHERE id = ?", [org]);
});
});