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 Function(Uri endpoint); /// Signs in with the web password; null on success, else the reason. typedef ServerSignIn = Future 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 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 Function(String url)? saveServer; final Widget? savedServers; final List serverAddresses; @override State createState() => _OnboardingFlowState(); } class _OnboardingFlowState extends State { 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 _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 _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(), ); } }