Files
pipelines/app/lib/features/onboarding/onboarding_flow.dart
T

305 lines
8.8 KiB
Dart

import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import '../../core/session/server_session.dart';
import '../../core/transport/server_url.dart';
import '../../core/servers/server_probe.dart';
import '../../ui/adaptive/host.dart';
/// Reaches a server and reports what it says about this device's session.
typedef ServerCheck = Future<SessionState> Function(Uri endpoint);
/// Signs in with the web password; null on success, else the reason.
typedef ServerSignIn = Future<String?> Function(Uri endpoint, String password);
/// The phone's first run: which server, then its password. Both are kept, so
/// later launches open the app directly.
class OnboardingFlow extends StatefulWidget {
const OnboardingFlow({
super.key,
required this.onDone,
this.initialServer = '',
this.startAtPassword = false,
this.check = ServerSession.check,
this.signIn = ServerSession.signIn,
this.saveServer,
this.savedServers,
this.serverAddresses = const [],
});
/// Called with the signed-in server's endpoint.
final ValueChanged<Uri> onDone;
/// Pre-filled server address (the saved one, or the build's default).
final String initialServer;
/// The saved session was refused: only the password is asked again.
final bool startAtPassword;
final ServerCheck check;
final ServerSignIn signIn;
final Future<void> Function(String url)? saveServer;
final Widget? savedServers;
final List<Uri> serverAddresses;
@override
State<OnboardingFlow> createState() => _OnboardingFlowState();
}
class _OnboardingFlowState extends State<OnboardingFlow> {
late final TextEditingController _server = TextEditingController(
text: widget.initialServer,
);
final TextEditingController _password = TextEditingController();
late bool _passwordStep = widget.startAtPassword;
Uri? _endpoint;
bool _busy = false;
String? _error;
@override
void initState() {
super.initState();
if (widget.startAtPassword) _endpoint = _parse(widget.initialServer);
}
@override
void dispose() {
_server.dispose();
_password.dispose();
super.dispose();
}
Uri? _parse(String text) {
try {
return Uri.parse(ServerUrl.validate(text).wsUrl);
} on FormatException {
return null;
}
}
Future<void> _continue() async {
String? problem;
Uri? endpoint;
try {
endpoint = Uri.parse(ServerUrl.validate(_server.text).wsUrl);
} on FormatException catch (error) {
problem = error.message;
}
if (endpoint == null) {
setState(() => _error = problem);
return;
}
setState(() {
_busy = true;
_error = null;
});
final candidates = [
endpoint,
if (widget.serverAddresses.contains(endpoint))
...widget.serverAddresses.where((candidate) => candidate != endpoint),
];
final result = await probeServerAddresses(
candidates,
check: widget.check,
isCurrent: () => mounted,
);
endpoint = result.endpoint;
final state = result.state;
if (!mounted) return;
if (state == SessionState.unreachable) {
setState(() {
_busy = false;
_error = 'Could not reach that server. Check the address and network.';
});
return;
}
try {
await widget.saveServer?.call(endpoint.toString());
} catch (error) {
if (mounted) {
setState(() {
_busy = false;
_error = '$error';
});
}
return;
}
if (!mounted) return;
if (state == SessionState.signedIn) {
widget.onDone(endpoint);
return;
}
setState(() {
_busy = false;
_endpoint = endpoint;
_passwordStep = true;
});
}
Future<void> _signIn() async {
final endpoint = _endpoint;
if (endpoint == null || _password.text.isEmpty) return;
setState(() {
_busy = true;
_error = null;
});
final error = await widget.signIn(endpoint, _password.text);
if (!mounted) return;
if (error != null) {
setState(() {
_busy = false;
_error = error;
});
return;
}
widget.onDone(endpoint);
}
void _back() => setState(() {
_passwordStep = false;
_error = null;
_password.clear();
});
@override
Widget build(BuildContext context) {
final cupertino = usesCupertinoHost(context);
final title = _passwordStep ? 'Sign in' : 'Connect to Pipelines';
final lead = _passwordStep
? 'Enter the password chosen when Pipelines was installed on '
'${_endpoint?.host ?? 'the server'}.'
: 'Enter the address of your Pipelines server, for example '
'wss://server.example/connect.';
final field = _passwordStep
? _field(
cupertino,
key: const Key('onboarding-password'),
controller: _password,
hint: 'Password',
obscure: true,
onSubmitted: _signIn,
)
: _field(
cupertino,
key: const Key('onboarding-server'),
controller: _server,
hint: 'wss://server/connect',
keyboard: TextInputType.url,
onSubmitted: _continue,
);
final action = _passwordStep ? _signIn : _continue;
final label = _passwordStep ? 'Sign in' : 'Continue';
final button = cupertino
? CupertinoButton.filled(
key: const Key('onboarding-next'),
onPressed: _busy ? null : action,
child: _busy ? const CupertinoActivityIndicator() : Text(label),
)
: FilledButton(
key: const Key('onboarding-next'),
onPressed: _busy ? null : action,
child: _busy
? const SizedBox(
width: 18,
height: 18,
child: CircularProgressIndicator(strokeWidth: 2),
)
: Text(label),
);
final errorColor = cupertino
? CupertinoColors.systemRed.resolveFrom(context)
: Theme.of(context).colorScheme.error;
final body = SafeArea(
child: Center(
child: SingleChildScrollView(
padding: const EdgeInsets.all(24),
child: ConstrainedBox(
constraints: const BoxConstraints(maxWidth: 420),
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
Text(
title,
style: cupertino
? CupertinoTheme.of(
context,
).textTheme.navLargeTitleTextStyle
: Theme.of(context).textTheme.headlineSmall,
),
const SizedBox(height: 8),
Text(lead),
const SizedBox(height: 24),
field,
if (_error != null) ...[
const SizedBox(height: 8),
Text(
_error!,
key: const Key('onboarding-error'),
style: TextStyle(color: errorColor),
),
],
const SizedBox(height: 16),
button,
if (_passwordStep && !widget.startAtPassword) ...[
const SizedBox(height: 8),
cupertino
? CupertinoButton(
onPressed: _busy ? null : _back,
child: const Text('Change server'),
)
: TextButton(
onPressed: _busy ? null : _back,
child: const Text('Change server'),
),
],
if (widget.savedServers != null) ...[
const SizedBox(height: 24),
widget.savedServers!,
],
],
),
),
),
),
);
return cupertino
? CupertinoPageScaffold(child: body)
: Scaffold(body: body);
}
Widget _field(
bool cupertino, {
required Key key,
required TextEditingController controller,
required String hint,
required VoidCallback onSubmitted,
bool obscure = false,
TextInputType? keyboard,
}) {
if (cupertino) {
return CupertinoTextField(
key: key,
controller: controller,
placeholder: hint,
obscureText: obscure,
autocorrect: false,
keyboardType: keyboard,
autofocus: true,
onSubmitted: (_) => onSubmitted(),
);
}
return TextField(
key: key,
controller: controller,
obscureText: obscure,
autocorrect: false,
keyboardType: keyboard,
autofocus: true,
decoration: InputDecoration(
labelText: hint,
border: const OutlineInputBorder(),
),
onSubmitted: (_) => onSubmitted(),
);
}
}