wordeck-native/Tests/UnitTests/MutationEncodingTests.swift
Till JS 9527240bcc feat(offline): text-only Cleanup + ζ-1 Offline-Sync
Drei zusammenhängende Blöcke in einem Commit (Files überlappen sich
zwischen den Themen — sauberer Split nicht ohne Friktion möglich):

1. Wordeck-Text-Only-Cleanup
   Image-Occlusion + Audio-Front-Code raus. Server ist seit Migration
   0004_wordeck_text_only.sql text-only (in Prod waren 0 Karten der
   Typen, 0 Media-Files). Native-Code war Build-11-Altlast.
   - Gelöscht: MediaCache, MediaEnvironment, RemoteImage,
     AudioPlayerButton, MaskEditorView, CardEditorMediaFields,
     CardEditorPayload, Media.swift
   - CardType-Enum auf 5 Werte: basic / basic-reverse / cloze /
     typing / multiple-choice
   - media_refs aus Card, CardCreateBody, CardUpdateBody, call-sites
   - WordeckAPI.uploadMedia / .fetchMedia / .deleteMedia + Single-File-
     makeMultipartBody gestrichen
   - MarketplaceCardConverter ohne Media-Cases
   - CardRenderer ohne imageOcclusionView / audioFrontView

2. AI-Media-Mode raus
   /decks/from-image-Endpoint existiert serverseitig nicht (server
   registriert nur /decks/generate für Text-Prompts). Native-Aufrufe
   wären 404 — toter Code.
   - aiMedia-Case aus DeckEditorView.CreateMode, ModePicker auf
     3 Optionen (Leer / KI / CSV)
   - AIMediaFormSections, MediaFileRow, mediaPickers, thumbnail,
     ingestPhotoItems, handlePDFImport raus
   - generateDeckFromMedia + makeFromImageMultipartBody raus
   - GenerationMediaFile-Struct + PhotosUI-Import + PlatformImage-
     typealias raus
   - NSPhotoLibraryUsageDescription aus project.yml entfernt (es gibt
     keinen Photo-Library-Zugriff mehr)
   - maxMediaFiles/maxImageBytes/maxPDFBytes + inferImageMimeType +
     imageExtension aus DeckEditorHelpers raus

3. ζ-1 Offline-Sync
   Konzept in docs/OFFLINE_SYNC.md. Server-authoritative-FSRS bleibt —
   kein lokales FSRS, nur Snapshot-Modell.
   - Neue SwiftData-Models: CachedCard + CachedDueReview, beide mit
     userId/deckId-Indizes
   - ModelContainer um die zwei Models erweitert (additive Migration,
     sollte automatisch laufen — vor TestFlight verifizieren)
   - DueReview bekommt programmatischen init(review:card:) für die
     Cache-Rekonstruktion
   - DeckListStore.refresh() zieht Cards + Due-Reviews pro Deck
     parallel in einer TaskGroup; applyToCache in drei Helpers
     gesplittet (applyDecks / applyCards / applyDueReviews)
   - Karten: Upsert mit Orphan-Cleanup
   - Due-Reviews: voll ersetzt pro Refresh (Server-`due`-Zeiten
     ändern sich, Merge wäre falsch)
   - StudySession.start() fällt bei Netz-Fehler auf
     CachedDueReview-Snapshot zurück, setzt isOfflineSession-Flag
   - StudySessionView zeigt offline-Banner und am Ende der Session
     einen Hinweis „Weitere Karten erst nach Verbindung verfügbar"
   - AccountView.wipeLocalCache(): DSGVO-Wipe vor signOut() und nach
     deleteAccount → CachedDeck + CachedCard + CachedDueReview +
     PendingGrade werden gelöscht

Plus: Keychain-Test in WordeckNativeTests.swift fix — erwartete
"ev.mana.wordeck", muss seit Cross-App-SSO-Commit 19fee75
ManaSharedKeychainGroup nutzen. Auf Konstant-Reference umgestellt,
damit's nicht wieder driftet.

Verifikation:
- xcodebuild iOS-Simulator: BUILD SUCCEEDED
- swiftlint --strict: 0 violations in 68 files
- swiftformat: clean
- 37/37 Tests grün (inkl. fix-Keychain-Test)
- macOS-Build scheitert an pre-existing .topBarTrailing in
  StudySessionView (iOS-only API seit 2026-05-13, nicht durch
  diesen Commit verursacht)

Pflicht-Verifikation vor TestFlight (in PLAN.md verewigt):
- SwiftData-Migration auf Bestandsbuilder
- Offline-Endurance (50+ Karten Flugmodus)
- Logout-Wipe mit Account-Switch
- Cross-Check Web ↔ Native nach Offline-Grade

Diff: 35 files, +869 / -1622, netto ~−750 LOC.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 22:06:41 +02:00

103 lines
3.5 KiB
Swift

import Foundation
import Testing
@testable import WordeckNative
@Suite("Mutation Body Encoding")
struct MutationEncodingTests {
private func encode(_ value: some Encodable) throws -> [String: Any] {
let data = try JSONEncoder().encode(value)
guard let dict = try JSONSerialization.jsonObject(with: data) as? [String: Any] else {
throw EncodeError.notADictionary
}
return dict
}
private enum EncodeError: Error {
case notADictionary
}
@Test("DeckCreateBody nutzt snake_case und lässt nil weg")
func deckCreateBody() throws {
let body = DeckCreateBody(
name: "Spanisch",
description: nil,
color: "#10803D",
category: .language,
visibility: .private
)
let json = try encode(body)
#expect(json["name"] as? String == "Spanisch")
#expect(json["color"] as? String == "#10803D")
#expect(json["category"] as? String == "language")
#expect(json["visibility"] as? String == "private")
// description war nil sollte nicht im JSON sein
#expect(json["description"] == nil)
}
@Test("DeckUpdateBody kann archived: true setzen")
func deckUpdateBodyArchived() throws {
let body = DeckUpdateBody(archived: true)
let json = try encode(body)
#expect(json["archived"] as? Bool == true)
#expect(json["name"] == nil)
}
@Test("CardCreateBody für basic-Type")
func cardCreateBodyBasic() throws {
let body = CardCreateBody(
deckId: "deck_1",
type: .basic,
fields: CardFieldsBuilder.basic(front: "Hallo", back: "Hello")
)
let json = try encode(body)
#expect(json["deck_id"] as? String == "deck_1")
#expect(json["type"] as? String == "basic")
let fields = json["fields"] as? [String: String]
#expect(fields?["front"] == "Hallo")
#expect(fields?["back"] == "Hello")
#expect(json["media_refs"] == nil)
}
@Test("CardCreateBody für basic-reverse Type-Name")
func cardCreateBodyBasicReverse() throws {
let body = CardCreateBody(
deckId: "d",
type: .basicReverse,
fields: CardFieldsBuilder.basic(front: "a", back: "b")
)
let json = try encode(body)
#expect(json["type"] as? String == "basic-reverse")
}
@Test("CardCreateBody für cloze")
func cardCreateBodyCloze() throws {
let body = CardCreateBody(
deckId: "d",
type: .cloze,
fields: CardFieldsBuilder.cloze(text: "Die {{c1::Sonne}} scheint.")
)
let json = try encode(body)
#expect(json["type"] as? String == "cloze")
let fields = json["fields"] as? [String: String]
#expect(fields?["text"] == "Die {{c1::Sonne}} scheint.")
}
@Test("CardCreateBody multiple-choice Type-Name")
func cardCreateBodyMultipleChoice() throws {
let body = CardCreateBody(
deckId: "d",
type: .multipleChoice,
fields: CardFieldsBuilder.multipleChoice(front: "Q", answer: "A")
)
let json = try encode(body)
#expect(json["type"] as? String == "multiple-choice")
}
@Test("CardUpdateBody nur mit fields")
func cardUpdateBodyFieldsOnly() throws {
let body = CardUpdateBody(fields: ["front": "neu"])
let json = try encode(body)
#expect((json["fields"] as? [String: String])?["front"] == "neu")
#expect(json["media_refs"] == nil)
}
}