Files
pipelines/app/lib/features/settings/ntfy_settings_controller.dart
T
alan 498c6f17a6 Add server notification settings with app checkboxes
Persist three global ntfy switches in server_settings: run_finished
(default on: auto-mode runs notify on success, read inside the
transition transaction; on/off modes unchanged), chat_needs_you
(default on: gates chat question/approval alerts) and
chat_reply_finished (default off: one alert per finished assistant
turn). Expose notification_settings / set_notification_settings over
the websocket protocol, add a Phone notifications section with
Material and Cupertino checkboxes in Settings, document the settings,
and keep the cli, tui, stage and pipeline test packages from
inheriting a real ntfy configuration.
2026-10-30 21:36:27 +00:00

118 lines
3.2 KiB
Dart

import 'package:flutter/foundation.dart';
import '../../core/api_gateway.dart';
/// One server-side ntfy notification choice, in the server's wire key.
class NtfySetting {
const NtfySetting(this.key, this.label);
final String key;
final String label;
}
/// The server's global notification choices, in display order.
const ntfySettings = <NtfySetting>[
NtfySetting('run_finished', 'Run finished'),
NtfySetting('chat_needs_you', 'Chat needs your answer or approval'),
NtfySetting('chat_reply_finished', 'Chat reply finished'),
];
/// Loads and changes the server's ntfy notification settings through the
/// shared gateway (`notification_settings` / `set_notification_settings`).
///
/// A toggle shows the new value at once and is reverted, with the server's
/// refusal as [error], when the write fails. Every reply carries all keys, so
/// the stored result always replaces the local copy.
class NtfySettingsController extends ChangeNotifier {
NtfySettingsController(this.gateway);
final ApiGateway gateway;
Map<String, bool>? _values;
bool _loading = false;
String? _saving;
String _error = '';
bool _disposed = false;
/// The stored values, or null before the first successful load.
Map<String, bool>? get values => _values;
bool get loading => _loading;
/// The key whose change is being written, if any.
String? get saving => _saving;
String get error => _error;
/// Whether the checkboxes accept a change now.
bool get enabled => _values != null && !_loading && _saving == null;
Future<void> load() async {
if (_loading) return;
_loading = true;
_error = '';
_notify();
try {
final reply = await gateway.call('notification_settings');
_values = _decode(reply);
} catch (error) {
_error = 'Could not load notification settings: $error';
} finally {
_loading = false;
_notify();
}
}
Future<void> toggle(String key, bool value) async {
final current = _values;
if (current == null || !enabled) return;
final previous = current[key];
_values = {...current, key: value};
_saving = key;
_error = '';
_notify();
try {
final reply = await gateway.call('set_notification_settings', {
'notification_settings': {key: value},
});
_values = _decode(reply);
} catch (error) {
final reverted = {...?_values};
if (previous == null) {
reverted.remove(key);
} else {
reverted[key] = previous;
}
_values = reverted;
_error = 'Could not save: $error';
} finally {
_saving = null;
_notify();
}
}
static Map<String, bool> _decode(JsonMap reply) {
final raw = reply['notification_settings'];
if (raw is! Map) {
throw const FormatException('the reply carried no notification settings');
}
final result = <String, bool>{};
for (final setting in ntfySettings) {
final value = raw[setting.key];
if (value is! bool) {
throw FormatException('the reply is missing ${setting.key}');
}
result[setting.key] = value;
}
return result;
}
void _notify() {
if (!_disposed) notifyListeners();
}
@override
void dispose() {
_disposed = true;
super.dispose();
}
}