foxyzandClaude Opus 5.5
9f2586b7ff
Server and core: version ranges on both sides with a coded refusal; a client id maps to the same member and token for the server's life; a drop is `gone` for a 10-minute grace keeping ready, presence, queue items, relay and avatar; `bye` leaves at once; ordered takeover (seq, replaced/stale); presence joining/in/away/gone with one PresencePolicy; joiners never pause playback and hold a held gate at most ~15 s; state.hold; feed ids, seq and replay; the relay lives through its source's grace and continues on re-dial; queue `by` lasting, auto items and cancel; MediaRef carried; client ids never logged. App: persisted client id and seq; Connection with unstable/lost/ replaced states, backoff with jitter, no lost/back pair per flap; a drop keeps the session (state, player, media, relay source); presence in the strip and members card; sit out = away intent; feed matched by id; auto sit-out (idle when not playing, minimised for a while; never when alone) replaces auto-unready; bye on close and Leave, not on update restart; relay source re-dials through its grace. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
58 lines
2.3 KiB
Dart
58 lines
2.3 KiB
Dart
import 'package:hive_ce/hive.dart';
|
|
|
|
// The `settings` box's layout version and the ordered steps between
|
|
// versions. A step rewrites stored values for a new layout (renamed keys,
|
|
// changed formats); the restructure steps add theirs here.
|
|
|
|
/// The layout this build reads. 1: the layout of 1.2.x, where versioning
|
|
/// starts (a box without a version is at 1). 2: auto sit-out replaces the
|
|
/// idle switch.
|
|
const settingsSchemaVersion = 2;
|
|
|
|
/// The box key holding the stored version.
|
|
const settingsSchemaKey = 'schemaVersion';
|
|
|
|
/// One step: brings a box at `to - 1` to [to].
|
|
class SettingsMigration {
|
|
final int to;
|
|
/// For the log ("settings schema 2: ...").
|
|
final String what;
|
|
final Future<void> Function(Box box) apply;
|
|
const SettingsMigration(this.to, this.what, this.apply);
|
|
}
|
|
|
|
/// Every step in order of [SettingsMigration.to] (2, 3, ...).
|
|
const settingsMigrations = <SettingsMigration>[
|
|
SettingsMigration(2, 'auto sit-out replaces "when idle, sit out instead of just unready"', _autoSitOut),
|
|
];
|
|
|
|
/// 2: `idleSitsOut` only chose between two automatic steps after 10 idle
|
|
/// minutes (unready, or sit out); both are auto sit-out now, on unless
|
|
/// switched off (`autoSitOut`).
|
|
Future<void> _autoSitOut(Box box) async {
|
|
if (!box.containsKey('idleSitsOut')) return;
|
|
await box.delete('idleSitsOut');
|
|
if (!box.containsKey('autoSitOut')) await box.put('autoSitOut', true);
|
|
}
|
|
|
|
/// Runs the [steps] past the box's stored version up to [current], in
|
|
/// order, storing the version after each, then stores [current]. A box
|
|
/// from a newer build (a downgrade) is left as it is. Returns a log line
|
|
/// per step run.
|
|
Future<List<String>> migrateSettings(Box box,
|
|
{List<SettingsMigration> steps = settingsMigrations, int current = settingsSchemaVersion}) async {
|
|
final stored = box.get(settingsSchemaKey);
|
|
var at = stored is int ? stored : 1;
|
|
if (at > current) return ['settings schema $at is newer than this build ($current): left as is'];
|
|
final ran = <String>[];
|
|
for (final step in [...steps]..sort((a, b) => a.to.compareTo(b.to))) {
|
|
if (step.to <= at || step.to > current) continue;
|
|
await step.apply(box);
|
|
at = step.to;
|
|
await box.put(settingsSchemaKey, at);
|
|
ran.add('settings schema ${step.to}: ${step.what}');
|
|
}
|
|
if (stored != current) await box.put(settingsSchemaKey, current);
|
|
return ran;
|
|
}
|