bvandeusen
4eb9935f8e
Foundation for the provider migrations. cacheFirst<D, T> wraps the drift.watch() + REST cold-cache fallback pattern: yields cached rows when present, kicks off REST fetch + drift populate when empty + online, yields empty when offline. REST failures swallow to empty so callers can surface errors via toast. adapters.dart adds CachedX → XRef extension methods + reverse XRef.toDrift() companions for Artist/Album/Track/Playlist. Adapters accept some loss of server-derived fields (coverUrl, streamUrl, ownerUsername) — UI already handles empty values; cold-cache fallback briefly shows the real values before drift takes over. cache_first_test covers all 4 branches (non-empty, empty+online, empty+offline, REST failure). adapters_test covers basic round-trips. Both safe to run on CI runner — no drift open required. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
110 lines
3.3 KiB
Dart
110 lines
3.3 KiB
Dart
// Drift row → model adapters and reverse-write adapters for populating
|
|
// drift from REST responses (#357 plan C).
|
|
//
|
|
// The cache loses some server-derived fields:
|
|
// - ArtistRef.coverUrl (server computes from most-recent album)
|
|
// - AlbumRef.coverUrl (server-emitted derived path)
|
|
// - TrackRef.streamUrl (could be reconstructed but kept empty for clarity)
|
|
// UI already handles empty coverUrl/streamUrl gracefully. REST cold-cache
|
|
// fallback briefly shows the real values before drift takes over.
|
|
|
|
import 'package:drift/drift.dart' as drift;
|
|
|
|
import '../models/album.dart';
|
|
import '../models/artist.dart';
|
|
import '../models/playlist.dart';
|
|
import '../models/track.dart';
|
|
import 'db.dart';
|
|
|
|
extension CachedArtistAdapter on CachedArtist {
|
|
ArtistRef toRef() => ArtistRef(
|
|
id: id,
|
|
name: name,
|
|
sortName: sortName,
|
|
);
|
|
}
|
|
|
|
extension ArtistRefDriftWrite on ArtistRef {
|
|
CachedArtistsCompanion toDrift() => CachedArtistsCompanion.insert(
|
|
id: id,
|
|
name: name,
|
|
sortName: sortName.isNotEmpty ? sortName : name,
|
|
);
|
|
}
|
|
|
|
extension CachedAlbumAdapter on CachedAlbum {
|
|
/// `artistName` is supplied by the joined CachedArtists row at query time.
|
|
AlbumRef toRef({String artistName = ''}) => AlbumRef(
|
|
id: id,
|
|
title: title,
|
|
sortTitle: sortTitle,
|
|
artistId: artistId,
|
|
artistName: artistName,
|
|
);
|
|
}
|
|
|
|
extension AlbumRefDriftWrite on AlbumRef {
|
|
CachedAlbumsCompanion toDrift() => CachedAlbumsCompanion.insert(
|
|
id: id,
|
|
artistId: artistId,
|
|
title: title,
|
|
sortTitle: sortTitle.isNotEmpty ? sortTitle : title,
|
|
);
|
|
}
|
|
|
|
extension CachedTrackAdapter on CachedTrack {
|
|
/// `artistName` and `albumTitle` come from joined rows.
|
|
TrackRef toRef({String artistName = '', String albumTitle = ''}) => TrackRef(
|
|
id: id,
|
|
title: title,
|
|
albumId: albumId,
|
|
albumTitle: albumTitle,
|
|
artistId: artistId,
|
|
artistName: artistName,
|
|
trackNumber: trackNumber,
|
|
discNumber: discNumber,
|
|
durationSec: durationMs ~/ 1000,
|
|
);
|
|
}
|
|
|
|
extension TrackRefDriftWrite on TrackRef {
|
|
CachedTracksCompanion toDrift() => CachedTracksCompanion.insert(
|
|
id: id,
|
|
albumId: albumId,
|
|
artistId: artistId,
|
|
title: title,
|
|
durationMs: drift.Value(durationSec * 1000),
|
|
trackNumber: drift.Value(trackNumber),
|
|
discNumber: drift.Value(discNumber),
|
|
);
|
|
}
|
|
|
|
extension CachedPlaylistAdapter on CachedPlaylist {
|
|
/// `ownerUsername` is server-derived; cache stores the userId only.
|
|
/// Pass empty unless a join supplies it.
|
|
Playlist toRef({String ownerUsername = ''}) => Playlist(
|
|
id: id,
|
|
userId: userId,
|
|
name: name,
|
|
description: description,
|
|
isPublic: isPublic,
|
|
systemVariant: null, // not tracked in cache
|
|
trackCount: trackCount,
|
|
coverUrl: '', // server-derived; cache doesn't persist
|
|
ownerUsername: ownerUsername,
|
|
createdAt: '',
|
|
updatedAt: '',
|
|
);
|
|
}
|
|
|
|
extension PlaylistDriftWrite on Playlist {
|
|
CachedPlaylistsCompanion toDrift() => CachedPlaylistsCompanion.insert(
|
|
id: id,
|
|
userId: userId,
|
|
name: name,
|
|
description: drift.Value(description),
|
|
isPublic: drift.Value(isPublic),
|
|
trackCount: drift.Value(trackCount),
|
|
);
|
|
}
|