@_nazmiforreal/flutter-ota 0.1.16 → 0.1.17

package/dart-src/packages/cli-tools/.dart_tool/package_graph.json

@@ -30,7 +30,7 @@
     },
     {
       "name": "flutter_ota_kit_pocketbase",
-      "version": "0.1.0",
+      "version": "0.1.2",
       "dependencies": [
         "flutter_ota_kit_core",
         "flutter_ota_kit_plugin_core",
@@ -39,7 +39,7 @@
     },
     {
       "name": "flutter_ota_kit_aws",
-      "version": "0.1.3",
+      "version": "0.1.5",
       "dependencies": [
         "asn1lib",
         "crypto",
@@ -52,7 +52,7 @@
     },
     {
       "name": "flutter_ota_kit_cloudflare",
-      "version": "0.1.3",
+      "version": "0.1.5",
       "dependencies": [
         "crypto",
         "flutter_ota_kit_core",
@@ -63,7 +63,7 @@
     },
     {
       "name": "flutter_ota_kit_postgres",
-      "version": "0.1.3",
+      "version": "0.1.5",
       "dependencies": [
         "flutter_ota_kit_core",
         "flutter_ota_kit_plugin_core",
@@ -72,7 +72,7 @@
     },
     {
       "name": "flutter_ota_kit_supabase",
-      "version": "0.1.4",
+      "version": "0.1.6",
       "dependencies": [
         "flutter_ota_kit_core",
         "flutter_ota_kit_plugin_core",
@@ -82,7 +82,7 @@
     },
     {
       "name": "flutter_ota_kit_plugin_core",
-      "version": "0.0.4",
+      "version": "0.0.6",
       "dependencies": [
         "flutter_ota_kit_core",
         "mime"
@@ -90,7 +90,7 @@
     },
     {
       "name": "flutter_ota_kit_core",
-      "version": "0.1.2",
+      "version": "0.1.4",
       "dependencies": []
     },
     {

package/dart-src/packages/cli-tools/lib/flutter_ota_kit_cli.dart

@@ -81,9 +81,209 @@ Future<int> run(List<String> args) async {
     final result = await runner.run(args);
     return result ?? 0;
   } on UsageException catch (e) {
+    final msg = e.message;
+
+    // Missing subcommand → show the command's own help + suggestions.
+    if (msg.startsWith('Missing subcommand')) {
+      final match = RegExp(r'"flutter-ota (\w+)"').firstMatch(msg);
+      if (match != null) {
+        final cmd = runner.commands[match.group(1)];
+        if (cmd != null) {
+          _printMissingSubcommand(cmd);
+          return 0;
+        }
+      }
+    }
+
+    // No command given → show top-level help.
+    if (msg.contains('No command specified')) {
+      runner.printUsage();
+      return 0;
+    }
+
+    // Unknown command → fuzzy-match and suggest.
+    final unknownMatch =
+        RegExp(r'Could not find a command named "?(\w+)"?').firstMatch(msg);
+    if (unknownMatch != null) {
+      final typed = unknownMatch.group(1)!;
+      _printUnknownCommand(runner, typed);
+      return 64;
+    }
+
+    // Unknown subcommand → suggest closest subcommand.
+    final subMatch = RegExp(
+      r'Could not find a subcommand named "?(\w+)"? for "?flutter-ota (\w+)"?',
+    ).firstMatch(msg);
+    if (subMatch != null) {
+      final subTyped = subMatch.group(1)!;
+      final parentName = subMatch.group(2)!;
+      final parentCmd = runner.commands[parentName];
+      if (parentCmd != null) {
+        _printUnknownSubcommand(parentCmd, subTyped);
+        return 64;
+      }
+    }
+
+    // Fallback — show the raw error + usage.
     stderr.writeln(e.message);
     stderr.writeln('');
     stderr.writeln(e.usage);
     return 64;
   }
 }
+
+/// Show a helpful "unknown command" message with fuzzy-match suggestions.
+void _printUnknownCommand(FlutterPatcherRunner runner, String typed) {
+  final commands = runner.commands.keys.toList();
+
+  // Exact prefix match (e.g. "bund" → "bundle").
+  final prefixMatches = commands.where((c) => c.startsWith(typed)).toList();
+
+  // Levenshtein-based fuzzy match for short typos.
+  final fuzzyMatches = <String>[];
+  for (final c in commands) {
+    if (prefixMatches.contains(c)) continue;
+    if (_levenshtein(typed, c) <= 2) {
+      fuzzyMatches.add(c);
+    }
+  }
+
+  // Subcommand matching (e.g. "bundle lis" → suggest "list").
+  final subMatch = RegExp(r'^(\w+)\s+(\w+)$').firstMatch(typed);
+  String? parentCmd;
+  String? subTyped;
+  if (subMatch != null) {
+    parentCmd = subMatch.group(1);
+    subTyped = subMatch.group(2);
+  }
+  // Also try if typed is just the first part.
+  if (parentCmd != null && !commands.contains(parentCmd)) {
+    // Check if parentCmd is a fuzzy match for a real command.
+    final parentFuzzy = commands.where((c) {
+      if (c == parentCmd) return true;
+      return _levenshtein(parentCmd!, c) <= 2;
+    }).toList();
+    if (parentFuzzy.isNotEmpty) {
+      parentCmd = parentFuzzy.first;
+    }
+  }
+
+  stderr.writeln('');
+  stderr.writeln('  ${_red('✗')} Unknown command: ${_red(typed)}');
+  stderr.writeln('');
+
+  if (prefixMatches.isNotEmpty || fuzzyMatches.isNotEmpty) {
+    final suggestions = [...prefixMatches, ...fuzzyMatches];
+    stderr.writeln('  ${_cyan('Did you mean?')}');
+    for (final s in suggestions.take(3)) {
+      stderr.writeln('    ${_green(s)}');
+    }
+    stderr.writeln('');
+
+    // If it looks like "parent sub" but the sub is wrong, show sub help.
+    if (parentCmd != null && subTyped != null) {
+      final cmd = runner.commands[parentCmd];
+      if (cmd != null && cmd.subcommands.isNotEmpty) {
+        // Find closest subcommand.
+        final subNames = cmd.subcommands.keys.toList();
+        final subSuggestion = subNames
+            .where((s) => s.startsWith(subTyped!) || _levenshtein(subTyped!, s) <= 2)
+            .toList();
+        if (subSuggestion.isNotEmpty) {
+          stderr.writeln('  ${_cyan('Did you mean?')} $parentCmd ${_green(subSuggestion.first)}');
+          stderr.writeln('');
+        }
+        cmd.printUsage();
+        return;
+      }
+    }
+
+    // Show top-level help.
+    runner.printUsage();
+    return;
+  }
+
+  // No close matches — show all available commands.
+  runner.printUsage();
+}
+
+/// Show a helpful "unknown subcommand" message with suggestions.
+void _printUnknownSubcommand(Command<int> parent, String typed) {
+  final subNames = parent.subcommands.keys.toList();
+
+  // Find closest subcommands.
+  final suggestions = subNames
+      .where((s) => s.startsWith(typed) || _levenshtein(typed, s) <= 2)
+      .toList();
+
+  stderr.writeln('');
+  stderr.writeln(
+    '  ${_red('✗')} Unknown subcommand: ${_red(typed)} for ${_cyan('flutter-ota ${parent.name}')}',
+  );
+  stderr.writeln('');
+
+  if (suggestions.isNotEmpty) {
+    stderr.writeln('  ${_cyan('Did you mean?')}');
+    for (final s in suggestions.take(3)) {
+      stderr.writeln('    ${_green(s)}');
+    }
+    stderr.writeln('');
+  }
+
+  parent.printUsage();
+}
+
+/// Show a helpful "missing subcommand" message with all subcommand suggestions.
+void _printMissingSubcommand(Command<int> parent) {
+  final subNames = parent.subcommands.keys.toList()..sort();
+
+  stderr.writeln('');
+  stderr.writeln(
+    '  ${_red('✗')} Missing subcommand for ${_cyan('flutter-ota ${parent.name}')}',
+  );
+  stderr.writeln('');
+
+  if (subNames.isNotEmpty) {
+    stderr.writeln('  ${_cyan('Did you mean?')}');
+    for (final s in subNames) {
+      stderr.writeln('    ${_green('${parent.name} $s')}');
+    }
+    stderr.writeln('');
+  }
+
+  parent.printUsage();
+}
+
+// ── Minimal Levenshtein distance ──────────────────────────────────────────────
+
+int _levenshtein(String a, String b) {
+  if (a.isEmpty) return b.length;
+  if (b.isEmpty) return a.length;
+  final dp = List.generate(a.length + 1, (i) => List.filled(b.length + 1, 0));
+  for (var i = 0; i <= a.length; i++) dp[i][0] = i;
+  for (var j = 0; j <= b.length; j++) dp[0][j] = j;
+  for (var i = 1; i <= a.length; i++) {
+    for (var j = 1; j <= b.length; j++) {
+      final cost = a[i - 1] == b[j - 1] ? 0 : 1;
+      dp[i][j] = [
+        dp[i - 1][j] + 1,
+        dp[i][j - 1] + 1,
+        dp[i - 1][j - 1] + cost,
+      ].reduce((a, b) => a < b ? a : b);
+    }
+  }
+  return dp[a.length][b.length];
+}
+
+// ── Minimal inline color helpers (stderr-safe, TTY-aware) ────────────────────
+
+bool get _noColor {
+  final v = Platform.environment['NO_COLOR'];
+  return v != null && v.isNotEmpty;
+}
+
+bool get _colorOn => !_noColor && stderr.hasTerminal && stderr.supportsAnsiEscapes;
+
+String _red(String s) => _colorOn ? '\x1b[31m$s\x1b[0m' : s;
+String _green(String s) => _colorOn ? '\x1b[32m$s\x1b[0m' : s;
+String _cyan(String s) => _colorOn ? '\x1b[36m$s\x1b[0m' : s;

package/dart-src/packages/cli-tools/lib/src/commands/bundle.dart

@@ -59,27 +59,6 @@ class BundleCommand extends FlutterPatcherCommand {
   @override
   String get description =>
       'Manage bundles (list / show / delete / disable / enable / force / promote).';
-
-  @override
-  Future<int> run() => runGuarded(() async {
-    print(description);
-    print('');
-    print('Subcommands:');
-    print(
-      '  list                 List bundles (filters: --channel/-c, --platform/-p, --enabled, --limit/-l)',
-    );
-    print('  show --id <id>        Show a single bundle\'s details');
-    print('  delete --id <id>      Delete a bundle');
-    print('  disable --id <id>     Disable a bundle (stop serving it)');
-    print('  enable --id <id>      Enable a bundle');
-    print(
-      '  force --id <id>       Force an update onto clients (--off to clear)',
-    );
-    print('  promote --id <id> -c  Promote a bundle to a channel');
-    print(
-      '  update --id <id> ...  Edit metadata (--message/--target-version/--enabled/--force)',
-    );
-  });
 }
 
 class BundleListCommand extends FlutterPatcherCommand {

package/dart-src/packages/cli-tools/lib/src/commands/channel.dart

@@ -24,16 +24,6 @@ class ChannelCommand extends FlutterPatcherCommand {
 
   @override
   String get description => 'Manage channels (list / get / set).';
-
-  @override
-  Future<int> run() => runGuarded(() async {
-    print(description);
-    print('');
-    print('Subcommands:');
-    print('  list              List channels');
-    print('  get <channel>     Show the live bundle for a channel');
-    print('  set <c> <id>      Promote a bundle to a channel');
-  });
 }
 
 class ChannelListCommand extends FlutterPatcherCommand {

package/dart-src/packages/cli-tools/lib/src/commands/config_command.dart

@@ -18,17 +18,6 @@ class ConfigCommand extends FlutterPatcherCommand {
 
   @override
   String get description => 'Get, set, or list configuration values.';
-
-  @override
-  Future<int> run() => runGuarded(() async {
-    // No subcommand selected.
-    print(description);
-    print('');
-    print('Subcommands:');
-    print('  get <key>');
-    print('  set <key> <value>');
-    print('  list');
-  });
 }
 
 Map<String, dynamic> _loadProjectJson() {
@@ -59,6 +48,7 @@ class ConfigGetCommand extends FlutterPatcherCommand {
 
   @override
   Future<int> run() => runGuarded(() async {
+    ui.banner('config · get');
     final key = argResults!['key'] as String? ??
         (argResults!.rest.isNotEmpty ? argResults!.rest.first : null);
     if (key == null || key.isEmpty) {
@@ -66,7 +56,7 @@ class ConfigGetCommand extends FlutterPatcherCommand {
     }
     final value = readPath(_loadProjectJson(), key);
     if (value == null) {
-      stderr.writeln('(not set)');
+      ui.warn('(not set)');
       return;
     }
     stdout.writeln(

package/dart-src/packages/cli-tools/lib/src/commands/console.dart

@@ -39,6 +39,7 @@ class ConsoleCommand extends FlutterPatcherCommand {
       return;
     }
     if (argResults!['open'] as bool) {
+      banner('console · open');
       step('Launching console...');
       final process = await Process.start(
         'flutter',
@@ -47,7 +48,8 @@ class ConsoleCommand extends FlutterPatcherCommand {
         runInShell: true,
         mode: ProcessStartMode.inheritStdio,
       );
-      exitCode = await process.exitCode;
+      final code = await process.exitCode;
+      if (code != 0) err('flutter run exited with code $code');
       return;
     }
     banner('console');

package/dart-src/packages/cli-tools/lib/src/commands/deploy.dart

@@ -73,11 +73,7 @@ class DeployCommand extends FlutterPatcherCommand {
     final bundleId = argResults!['bundle-id'] as String?;
 
     banner('deploy');
-    stdout.writeln(
-      '  ${gray('channel')}  ${cyan(channel)}   '
-      '${gray('platform')}  ${cyan(platform)}   '
-      '${gray('source')}  ${dim(source)}',
-    );
+    info('channel ${cyan(channel)}  platform ${cyan(platform)}  source ${dim(source)}');
 
     final bundle = await spinner(
       () => deployBundle(

package/dart-src/packages/cli-tools/lib/src/commands/fingerprint.dart

@@ -1,7 +1,5 @@
-import 'dart:io';
-
-
 import '../cli_base.dart';
+import '../ui/ui.dart';
 import '../util.dart';
 
 /// `flutter_ota_kit fingerprint` — compute a build-time fingerprint hash.
@@ -24,8 +22,9 @@ class FingerprintCommand extends FlutterPatcherCommand {
 
   @override
   Future<int> run() => runGuarded(() async {
+    banner(name);
     final source = argResults!['source'] as String;
     final hash = generateFingerprint(source);
-    stdout.writeln(hash);
+    box('fingerprint', [kv('source', source), kv('hash', hash)]);
   });
 }

package/dart-src/packages/cli-tools/lib/src/commands/init.dart

@@ -248,10 +248,8 @@ class InitCommand extends FlutterPatcherCommand {
     step('Wrote ${file.path}');
 
     if (global) {
-      stdout.writeln(
-        '  ${yellow('⚠')} Secrets are stored in plaintext under ~/.flutter_ota_kit. '
-        'Restrict permissions and use a secrets manager in production.',
-      );
+      warn('Secrets are stored in plaintext under ~/.flutter_ota_kit. '
+          'Restrict permissions and use a secrets manager in production.');
       return;
     }
 
@@ -259,35 +257,23 @@ class InitCommand extends FlutterPatcherCommand {
     await _scaffoldProject(cfg, provider);
 
     stdout.writeln();
-    stdout.writeln(cyan('Next steps:'));
-    stdout.writeln('  1. ${dim('flutter pub get')}');
-    stdout.writeln(
-      '  2. In lib/main.dart call ${green('await setupFlutterOta();')} '
-      'right after WidgetsFlutterBinding.ensureInitialized() (before runApp).',
-    );
-    stdout.writeln(
-      '     A `.env` scaffold was written — put secrets there, then build with '
-      '`--dart-define-from-file=.env` (environment overrides config).',
-    );
+    stdout.writeln('  ${cyan('Next steps:')}');
+    step('1. ${dim('flutter pub get')}');
+    step('2. In lib/main.dart call ${green('await setupFlutterOta();')} '
+        'right after WidgetsFlutterBinding.ensureInitialized() (before runApp). '
+        'A `.env` scaffold was written — put secrets there, then build with '
+        '`--dart-define-from-file=.env` (environment overrides config).');
     if (provider == 'supabase') {
-      stdout.writeln(
-        '  3. Provision the backend once: ${dim('flutter-ota migrate supabase')}',
-      );
+      step('3. Provision the backend once: ${dim('flutter-ota migrate supabase')}');
     } else if (provider == 'postgres') {
-      stdout.writeln(
-        '  3. Provision the backend: ${dim('flutter-ota migrate postgres')}',
-      );
+      step('3. Provision the backend: ${dim('flutter-ota migrate postgres')}');
     } else if (provider == 'pocketbase') {
-      stdout.writeln(
-        '  3. Install PocketBase + provision the schema: '
-        '${dim('flutter-ota pocketbase install')} then '
-        '${dim('flutter-ota pocketbase serve')}.',
-      );
+      step('3. Install PocketBase + provision the schema: '
+          '${dim('flutter-ota pocketbase install')} then '
+          '${dim('flutter-ota pocketbase serve')}.');
     }
-    stdout.writeln(
-      '  4. Build a patch: ${dim('flutter-ota build --name 1.0.1')} '
-      'then ${dim('flutter-ota deploy')}',
-    );
+    step('4. Build a patch: ${dim('flutter-ota build --name 1.0.1')} '
+        'then ${dim('flutter-ota deploy')}');
   });
 
   /// Generate the integration files (pubspec dep, manifest permission, setup dart
@@ -306,9 +292,7 @@ class InitCommand extends FlutterPatcherCommand {
   void _addPubDependency() {
     final pubspec = File('pubspec.yaml');
     if (!pubspec.existsSync()) {
-      stdout.writeln(
-        yellow('  ⚠ pubspec.yaml not found; skipping dependency injection.'),
-      );
+      warn('pubspec.yaml not found; skipping dependency injection.');
       return;
     }
     var content = pubspec.readAsStringSync();
@@ -320,11 +304,7 @@ class InitCommand extends FlutterPatcherCommand {
     final marker = '\ndependencies:';
     final idx = content.indexOf(marker);
     if (idx == -1) {
-      stdout.writeln(
-        yellow(
-          '  ⚠ could not find a `dependencies:` block; add `flutter_ota_kit` manually.',
-        ),
-      );
+      warn('Could not find a `dependencies:` block; add `flutter_ota_kit` manually.');
       return;
     }
     final insertAt = idx + marker.length;
@@ -336,11 +316,7 @@ class InitCommand extends FlutterPatcherCommand {
   void _addInternetPermission() {
     final mf = File('android/app/src/main/AndroidManifest.xml');
     if (!mf.existsSync()) {
-      stdout.writeln(
-        yellow(
-          '  ⚠ AndroidManifest.xml not found; skipping INTERNET permission.',
-        ),
-      );
+      warn('AndroidManifest.xml not found; skipping INTERNET permission.');
       return;
     }
     var content = mf.readAsStringSync();
@@ -350,11 +326,7 @@ class InitCommand extends FlutterPatcherCommand {
     }
     final match = RegExp(r'<manifest[^>]*>').firstMatch(content);
     if (match == null) {
-      stdout.writeln(
-        yellow(
-          '  ⚠ could not locate <manifest> tag; add INTERNET permission manually.',
-        ),
-      );
+      warn('Could not locate <manifest> tag; add INTERNET permission manually.');
       return;
     }
     final insertAt = match.end;

package/dart-src/packages/cli-tools/lib/src/commands/keys.dart

@@ -1,7 +1,5 @@
 import 'dart:convert';
 
-
-import '../backend.dart';
 import '../cli_base.dart';
 import '../config.dart';
 import '../sign.dart';
@@ -9,13 +7,10 @@ import '../ui/ui.dart';
 
 /// `flutter_ota_kit keys` — generate an Ed25519 keypair for bundle signing.
 class KeysCommand extends FlutterPatcherCommand {
-  KeysCommand({this.config, this.backendOverride}) {
+  KeysCommand() {
     argParser.addFlag('save', help: 'Persist the public key into the project config.');
   }
 
-  final FlutterPatcherConfig? config;
-  final Backend? backendOverride;
-
   @override
   String get name => 'keys';
 

package/dart-src/packages/cli-tools/lib/src/commands/pocketbase.dart

@@ -202,6 +202,7 @@ class PocketBaseStopCommand extends FlutterPatcherCommand {
 
   @override
   Future<int> run() => runGuarded(() async {
+    banner('pocketbase · stop');
     step('Use Ctrl+C on the running serve process to stop PocketBase.');
     return;
   });
@@ -216,6 +217,7 @@ class PocketBaseStatusCommand extends FlutterPatcherCommand {
 
   @override
   Future<int> run() => runGuarded(() async {
+    banner('pocketbase · status');
     final paths = PocketBaseInstallPaths.resolve();
     final exists = await paths.binaryPath.exists();
     if (exists) {

package/dart-src/packages/cli-tools/lib/src/pocketbase/installer.dart

@@ -9,7 +9,6 @@
 /// windows/amd64. Other combinations fall back to a helpful error.
 library;
 
-import 'dart:async';
 import 'dart:io';
 
 import 'package:archive/archive.dart';

package/dart-src/packages/cli-tools/lib/src/pocketbase/schema_installer.dart

@@ -232,6 +232,3 @@ class _CollectionSpec {
   final String name;
   final String schema;
 }
-
-/// Re-export so callers can use the typed client as well.
-typedef PocketBaseBackend = PocketBaseClient;

package/dart-src/packages/cli-tools/lib/src/runner.dart

@@ -18,8 +18,22 @@ class FlutterPatcherRunner extends CommandRunner<int> {
   }
 
   @override
-  Future<int?> runCommand(ArgResults results) {
+  Future<int?> runCommand(ArgResults results) async {
     verboseMode = results['verbose'] as bool? ?? false;
+
+    // Intercept missing subcommand for parent commands so we show our
+    // colored usage text instead of the args package's plain text.
+    if (results.command == null && results.rest.isEmpty) {
+      final cmdName = results.arguments.isNotEmpty ? results.arguments.first : null;
+      if (cmdName != null) {
+        final cmd = commands[cmdName];
+        if (cmd != null && cmd.subcommands.isNotEmpty) {
+          cmd.printUsage();
+          return 0;
+        }
+      }
+    }
+
     return super.runCommand(results);
   }
 

package/dart-src/packages/cli-tools/lib/src/ui/ui.dart

@@ -99,6 +99,8 @@ void banner(String name) {
 void step(String msg) => _echo('  ${green('✓')} $msg');
 void warn(String msg) => _echo('  ${yellow('⚠')} ${yellow(msg)}');
 void err(String msg) => _echo('  ${red('✗')} ${red(msg)}');
+void info(String msg) => _echo('  ${blue('ℹ')} $msg');
+void active(String msg) => _echo('  ${cyan('⠹')} $msg');
 
 // ── Spinner ──────────────────────────────────────────────────────────────────
 
@@ -116,13 +118,18 @@ Future<T> spinner<T>(
     return r;
   }
   var i = 0;
+  final sw = Stopwatch()..start();
   final timer = Timer.periodic(const Duration(milliseconds: 80), (_) {
     i = (i + 1) % _frames.length;
     stdout.write('\r\x1b[K  ${cyan(_frames[i])} $label');
   });
   try {
     final r = await task();
+    // Keep spinner visible for at least 400ms so fast ops are readable.
+    final elapsed = sw.elapsedMilliseconds;
+    if (elapsed < 400) await Future.delayed(Duration(milliseconds: 400 - elapsed));
     timer.cancel();
+    sw.stop();
     stdout.write('\r\x1b[K  ${green('✓')} ${done ?? label}\n');
     return r;
   } catch (e) {
@@ -232,12 +239,12 @@ void box(String title, List<String> lines) {
   final leftDashes = math.max(1, totalDashes ~/ 2);
   final rightDashes = totalDashes - leftDashes;
 
-  _echo('╭${'─' * leftDashes}$titleText${'─' * rightDashes}╮');
+  _echo('┌${'─' * leftDashes}$titleText${'─' * rightDashes}┐');
   for (final l in wrapped) {
     final pad = math.max(0, inner - _dispWidth(l));
     _echo('│ $l${' ' * pad} │');
   }
-  _echo('╰${'─' * (width - 2)}╯');
+  _echo('└${'─' * (width - 2)}┘');
 }
 
 // ── Steps ────────────────────────────────────────────────────────────────────
@@ -304,9 +311,9 @@ class Steps {
 
 // ── Progress Bar (thin, single-line) ────────────────────────────────────────
 
-/// Thin single-line progress bar with spinner, label, bar, percent, and time.
+/// Braille single-line progress bar with spinner, label, bar, and time.
 ///
-/// Renders as: `⠹ Label  ████░░░░ 50% 1.3s`
+/// Renders as: `⠹ Label  ⣿⣿⣿⣀⣀⣀ 50%`
 /// On finish: `✓ Label in 1.3s`
 class ProgressBar {
   ProgressBar(this.total, this.label);
@@ -335,11 +342,11 @@ class ProgressBar {
 
     final pct = total > 0 ? (_current / total).clamp(0.0, 1.0) : 1.0;
 
-    // Thin bar: width scales to terminal, max 20 chars.
+    // Braille bar: width scales to terminal, max 20 chars.
     final barW = math.min(20, math.max(8, _cols - 40));
     final filled = (barW * pct).round();
     final empty = barW - filled;
-    final bar = '${yellow('█' * filled)}${gray('░' * empty)}';
+    final bar = '${yellow('⣿' * filled)}${gray('⣀' * empty)}';
 
     _spin = (_spin + 1) % _frames.length;
     final pctStr = '${(pct * 100).round()}%'.padLeft(4);
@@ -349,10 +356,17 @@ class ProgressBar {
     );
   }
 
-  void _finish() {
+  /// Finish: print the final status line. This is intentionally async and
+  /// fire-and-forget (called without `await` from [update] and [close]).
+  /// The 500ms delay keeps fast ops readable; if the process exits early,
+  /// the final line may not print — acceptable for a CLI progress aid.
+  void _finish() async {
     if (_closed) return;
     _closed = true;
     _sw.stop();
+    // Keep bar visible for at least 500ms so fast ops are readable.
+    final elapsed = _sw.elapsedMilliseconds;
+    if (elapsed < 500) await Future.delayed(Duration(milliseconds: 500 - elapsed));
     final ms = _sw.elapsedMilliseconds;
     final time = ms >= 1000
         ? '${(ms / 1000).toStringAsFixed(1)}s'

package/dart-src/packages/cli-tools/pubspec.lock

@@ -159,49 +159,49 @@ packages:
       path: "../../plugins/aws"
       relative: true
     source: path
-    version: "0.1.3"
+    version: "0.1.5"
   flutter_ota_kit_cloudflare:
     dependency: "direct main"
     description:
       path: "../../plugins/cloudflare"
       relative: true
     source: path
-    version: "0.1.3"
+    version: "0.1.5"
   flutter_ota_kit_core:
     dependency: "direct main"
     description:
       path: "../core"
       relative: true
     source: path
-    version: "0.1.2"
+    version: "0.1.4"
   flutter_ota_kit_plugin_core:
     dependency: "direct main"
     description:
       path: "../../plugins/plugin-core"
       relative: true
     source: path
-    version: "0.0.4"
+    version: "0.0.6"
   flutter_ota_kit_pocketbase:
     dependency: "direct main"
     description:
       path: "../../plugins/pocketbase"
       relative: true
     source: path
-    version: "0.1.0"
+    version: "0.1.2"
   flutter_ota_kit_postgres:
     dependency: "direct main"
     description:
       path: "../../plugins/postgres"
       relative: true
     source: path
-    version: "0.1.3"
+    version: "0.1.5"
   flutter_ota_kit_supabase:
     dependency: "direct main"
     description:
       path: "../../plugins/supabase"
       relative: true
     source: path
-    version: "0.1.4"
+    version: "0.1.6"
   frontend_server_client:
     dependency: transitive
     description:

package/dart-src/packages/core/CHANGELOG.md

@@ -1,12 +1 @@
-## 0.1.2
-
-- Add dartdoc on internal API surfaces (10/10 pana dartdoc coverage).
-
-## 0.1.1
-
-- Fix `<id>` angle bracket in dartdoc (`bundle.dart:23`) being interpreted as HTML by Markdown renderers.
-- Repository moved to `https://github.com/HYPER12755/flutter-ota-kit`.
-
-## 0.1.0
-
-- Initial release of `flutter_ota_kit_core` as part of the flutter_ota_kit OTA toolkit.
+## 0.1.4

package/dart-src/packages/core/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 xuelinger
+Copyright (c) 2026 HYPER12755
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dart-src/packages/core/pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_ota_kit_core
 description: Core data model, rollout cohorts, and shared utilities for flutter_ota_kit — Dart translation of hot-updater's packages/core.
-version: 0.1.2
+version: 0.1.4
 homepage: https://github.com/HYPER12755/flutter-ota-kit
 repository: https://github.com/HYPER12755/flutter-ota-kit
 issue_tracker: https://github.com/HYPER12755/flutter-ota-kit/issues

package/dart-src/plugins/aws/CHANGELOG.md

@@ -1,18 +1 @@
-## 0.1.3
-
-- Add dartdoc on internal API surfaces (10/10 pana dartdoc coverage).
-
-## 0.1.2
-
-- Bump `pointycastle` to `^4.0.0` (API-compatible, security update).
-- Add `withCloudFrontSignedUrl` helper for time-limited download URLs.
-- Add `defaultAwsCloudFrontClientFactory` export.
-- Repository moved to `https://github.com/HYPER12755/flutter-ota-kit`.
-
-## 0.1.1
-
-- Initial test release of the AWS S3 + CloudFront storage plugin.
-
-## 0.1.0
-
-- Initial release of `flutter_ota_kit_aws` as part of the flutter_ota_kit OTA toolkit.
+## 0.1.5

package/dart-src/plugins/aws/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 xuelinger
+Copyright (c) 2026 HYPER12755
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dart-src/plugins/aws/pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_ota_kit_aws
 description: AWS S3 storage + S3/DynamoDB database plugins for flutter_ota_kit (faithful port of hot-updater plugins/aws).
-version: 0.1.3
+version: 0.1.5
 homepage: https://github.com/HYPER12755/flutter-ota-kit
 repository: https://github.com/HYPER12755/flutter-ota-kit
 issue_tracker: https://github.com/HYPER12755/flutter-ota-kit/issues

package/dart-src/plugins/cloudflare/CHANGELOG.md

@@ -1,18 +1 @@
-## 0.1.3
-
-- Add dartdoc on internal API surfaces (10/10 pana dartdoc coverage).
-
-## 0.1.2
-
-- Add `parseMetadata` / `parseTargetCohorts` exports from the D1 bundle
-  mapper for writing custom Cloudflare Worker logic.
-- Add `defaultRolloutCohortCount` export.
-- Repository moved to `https://github.com/HYPER12755/flutter-ota-kit`.
-
-## 0.1.1
-
-- Initial test release of the Cloudflare D1 + R2 storage plugin.
-
-## 0.1.0
-
-- Initial release of `flutter_ota_kit_cloudflare` as part of the flutter_ota_kit OTA toolkit.
+## 0.1.5

package/dart-src/plugins/cloudflare/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 xuelinger
+Copyright (c) 2026 HYPER12755
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dart-src/plugins/cloudflare/pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_ota_kit_cloudflare
 description: Cloudflare D1 + R2 storage plugins for flutter_ota_kit (faithful port of hot-updater plugins/cloudflare).
-version: 0.1.3
+version: 0.1.5
 homepage: https://github.com/HYPER12755/flutter-ota-kit
 repository: https://github.com/HYPER12755/flutter-ota-kit
 issue_tracker: https://github.com/HYPER12755/flutter-ota-kit/issues

package/dart-src/plugins/plugin-core/CHANGELOG.md

@@ -1,17 +1 @@
-## 0.0.4
-
-- Add dartdoc on internal API surfaces (10/10 pana dartdoc coverage).
-
-## 0.0.3
-
-- Bump `mime` constraint to `^2.0.0` (now used for asset content-type detection).
-- Add `parseStorageUri` + `ParsedStorageUri` exports for the storage URI helpers.
-- Repository moved to `https://github.com/HYPER12755/flutter-ota-kit`.
-
-## 0.0.2
-
-- Initial release of `flutter_ota_kit_plugin_core` as part of the flutter_ota_kit OTA toolkit.
-
-## 0.0.1
-
-- Pre-release of the plugin core abstractions.
+## 0.0.6

package/dart-src/plugins/plugin-core/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 xuelinger
+Copyright (c) 2026 HYPER12755
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dart-src/plugins/plugin-core/pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_ota_kit_plugin_core
 description: Plugin core abstractions for flutter_ota_kit — database, storage, and build interfaces.
-version: 0.0.4
+version: 0.0.6
 homepage: https://github.com/HYPER12755/flutter-ota-kit
 repository: https://github.com/HYPER12755/flutter-ota-kit
 issue_tracker: https://github.com/HYPER12755/flutter-ota-kit/issues

package/dart-src/plugins/pocketbase/CHANGELOG.md

@@ -1,8 +1 @@
-# Changelog
-
-## 0.1.0
-
-- Initial release of `flutter_ota_kit_pocketbase` — PocketBase
-  database + storage plugins for the flutter_ota_kit OTA toolkit.
-  See the [PocketBase backend guide](https://github.com/HYPER12755/flutter-ota-kit/blob/main/doc/backends.md#pocketbase)
-  for usage.
+## 0.1.2

package/dart-src/plugins/pocketbase/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 xuelinger
+Copyright (c) 2026 HYPER12755
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dart-src/plugins/pocketbase/pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_ota_kit_pocketbase
 description: PocketBase plugin for flutter_ota_kit — local-first self-hostable backend with admin UI, auth, file storage, and realtime.
-version: 0.1.0
+version: 0.1.2
 homepage: https://github.com/HYPER12755/flutter-ota-kit
 repository: https://github.com/HYPER12755/flutter-ota-kit
 issue_tracker: https://github.com/HYPER12755/flutter-ota-kit/issues

package/dart-src/plugins/postgres/CHANGELOG.md

@@ -1,19 +1 @@
-## 0.1.3
-
-- Add dartdoc on internal API surfaces (10/10 pana dartdoc coverage).
-
-## 0.1.2
-
-- Add `PostgresBundleRow` + `mapRowToBundle` exports for writing custom server
-  tooling on top of `flutter_ota_kit_postgres`.
-- Repository moved to `https://github.com/HYPER12755/flutter-ota-kit`.
-
-## 0.1.1
-
-- Throw a clear `StateError` from `getDownloadUrl` when no `servingBaseUrl`
-  is configured (previously the URL silently failed).
-- Remove dead `IS NULL` filter paths in `_buildWhere`.
-
-## 0.1.0
-
-- Initial release of `flutter_ota_kit_postgres` as part of the flutter_ota_kit OTA toolkit.
+## 0.1.5

package/dart-src/plugins/postgres/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 xuelinger
+Copyright (c) 2026 HYPER12755
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dart-src/plugins/postgres/pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_ota_kit_postgres
 description: Postgres plugin for flutter_ota_kit — database backend.
-version: 0.1.3
+version: 0.1.5
 homepage: https://github.com/HYPER12755/flutter-ota-kit
 repository: https://github.com/HYPER12755/flutter-ota-kit
 issue_tracker: https://github.com/HYPER12755/flutter-ota-kit/issues

package/dart-src/plugins/supabase/CHANGELOG.md

@@ -1,23 +1 @@
-## 0.1.4
-
-- Add dartdoc on internal API surfaces (10/10 pana dartdoc coverage).
-
-## 0.1.3
-
-- Export `SupabaseBundleRow` and `mapRowToBundle` for writing custom server
-  tooling on top of `flutter_ota_kit_supabase`.
-- Repository moved to `https://github.com/HYPER12755/flutter-ota-kit`.
-
-## 0.1.2
-
-- Add edge-function database + storage variants (`supabaseEdgeFunctionDatabase`,
-  `supabaseEdgeFunctionStorage`).
-- Add `createSupabaseSignedUrlBatcher` for signed-URL time-bounded downloads.
-
-## 0.1.1
-
-- Initial test release of the Supabase storage plugin.
-
-## 0.1.0
-
-- Initial release of `flutter_ota_kit_supabase` as part of the flutter_ota_kit OTA toolkit.
+## 0.1.6

package/dart-src/plugins/supabase/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 xuelinger
+Copyright (c) 2026 HYPER12755
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dart-src/plugins/supabase/pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_ota_kit_supabase
 description: Supabase plugin for flutter_ota_kit — database + storage backends.
-version: 0.1.4
+version: 0.1.6
 homepage: https://github.com/HYPER12755/flutter-ota-kit
 repository: https://github.com/HYPER12755/flutter-ota-kit
 issue_tracker: https://github.com/HYPER12755/flutter-ota-kit/issues

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@_nazmiforreal/flutter-ota",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "Command-line interface for flutter_ota_kit — an OTA code-push tool for Flutter, hot-updater compatible.",
   "bin": {
     "flutter-ota": "./bin/flutter-ota.js"