@_nazmiforreal/flutter-ota 0.1.20 → 0.1.22

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

@@ -6,14 +6,25 @@ import '../ui/ui.dart';
 /// `flutter-ota rollback` — roll a channel back to a previous bundle.
 class RollbackCommand extends FlutterPatcherCommand {
   RollbackCommand({this.config, this.backendOverride}) {
-    argParser.addOption('backend', abbr: 'b', help: 'Backend provider.');
+    final detected = config?.provider ?? loadConfig()?.provider;
+    argParser.addOption(
+      'backend',
+      abbr: 'b',
+      help: detected != null
+          ? 'Backend provider [detected: $detected].'
+          : 'Backend provider.',
+    );
     argParser.addOption('channel', abbr: 'c', help: 'Channel to roll back.');
     argParser.addOption(
       'bundle-id',
       abbr: 'i',
       help: 'Roll back to this specific bundle id.',
     );
-    argParser.addOption('platform', abbr: 'p', help: 'Platform filter (e.g. android).');
+    argParser.addOption(
+      'platform',
+      abbr: 'p',
+      help: 'Platform filter (e.g. android).',
+    );
   }
 
   final FlutterPatcherConfig? config;
@@ -46,14 +57,12 @@ class RollbackCommand extends FlutterPatcherCommand {
 
     banner('rollback');
     final steps = Steps('rollback');
-    final (disabled, live) = await steps.run('Rolling back channel "$channel"', () async {
+    final (
+      disabled,
+      live,
+    ) = await steps.run('Rolling back channel "$channel"', () async {
       if (bundleId != null && bundleId.isNotEmpty) {
-        return rollbackToBundle(
-          backend,
-          channel,
-          bundleId,
-          platform: platform,
-        );
+        return rollbackToBundle(backend, channel, bundleId, platform: platform);
       }
       final id = await rollbackChannel(backend, channel);
       final nowLive = (await getChannel(backend, channel))?.id ?? '';

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

@@ -22,12 +22,19 @@ class StorageCommand extends FlutterPatcherCommand {
 
   @override
   String get description =>
-      'Inspect and manage bundle storage objects (find / delete orphans).';
+      'Inspect and manage bundle storage objects (list / delete).';
 }
 
 class StorageListCommand extends FlutterPatcherCommand {
   StorageListCommand({this.config, this.backendOverride}) {
-    argParser.addOption('backend', abbr: 'b', help: 'Backend provider.');
+    final detected = config?.provider ?? loadConfig()?.provider;
+    argParser.addOption(
+      'backend',
+      abbr: 'b',
+      help: detected != null
+          ? 'Backend provider [detected: $detected].'
+          : 'Backend provider.',
+    );
     argParser.addOption('prefix', help: 'Key prefix filter (e.g. bundles).');
   }
 
@@ -47,9 +54,12 @@ class StorageListCommand extends FlutterPatcherCommand {
     final prefix = argResults!['prefix'] as String?;
     banner('storage · list');
     final steps = Steps('list');
-    final objects = await steps.run('Listing storage objects', () =>
-        backend.storage.listObjects(
-            prefix == null || prefix.isEmpty ? null : prefix));
+    final objects = await steps.run(
+      'Listing storage objects',
+      () => backend.storage.listObjects(
+        prefix == null || prefix.isEmpty ? null : prefix,
+      ),
+    );
     if (objects.isEmpty) {
       steps.skip('(no objects)');
       steps.summary();
@@ -57,12 +67,7 @@ class StorageListCommand extends FlutterPatcherCommand {
     }
     final rows = <List<String>>[];
     for (final o in objects) {
-      final size = o.size >= 1024 * 1024
-          ? '${(o.size / (1024 * 1024)).toStringAsFixed(2)} MB'
-          : o.size >= 1024
-              ? '${(o.size / 1024).toStringAsFixed(1)} KB'
-              : '${o.size} B';
-      rows.add([cyan(o.key), size]);
+      rows.add([cyan(o.key), humanSize(o.size)]);
     }
     table('${objects.length} objects', ['KEY', 'SIZE'], rows);
     steps.summary();
@@ -71,8 +76,18 @@ class StorageListCommand extends FlutterPatcherCommand {
 
 class StorageDeleteCommand extends FlutterPatcherCommand {
   StorageDeleteCommand({this.config, this.backendOverride}) {
-    argParser.addOption('backend', abbr: 'b', help: 'Backend provider.');
-    argParser.addMultiOption('key', help: 'Storage key to delete (repeatable).');
+    final detected = config?.provider ?? loadConfig()?.provider;
+    argParser.addOption(
+      'backend',
+      abbr: 'b',
+      help: detected != null
+          ? 'Backend provider [detected: $detected].'
+          : 'Backend provider.',
+    );
+    argParser.addMultiOption(
+      'key',
+      help: 'Storage key to delete (repeatable).',
+    );
     argParser.addOption('uri', help: 'Full storage URI to delete.');
   }
 
@@ -101,8 +116,10 @@ class StorageDeleteCommand extends FlutterPatcherCommand {
     banner('storage · delete');
     final steps = Steps('delete');
     if (keys.isNotEmpty) {
-      await steps.run('Deleting ${keys.length} object(s)',
-          () => backend.storage.deleteObjects(keys));
+      await steps.run(
+        'Deleting ${keys.length} object(s)',
+        () => backend.storage.deleteObjects(keys),
+      );
     } else {
       await steps.run('Deleting $uri', () => backend.storage.delete(uri!));
     }

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

@@ -170,9 +170,7 @@ FlutterPatcherConfig? loadConfig() {
           jsonDecode(raw) as Map<String, dynamic>,
         );
       } on FormatException {
-        stderr.writeln(
-          'Warning: invalid config at ${file.path} — ignoring.',
-        );
+        stderr.writeln('Warning: invalid config at ${file.path} — ignoring.');
         return null;
       }
     }
@@ -232,8 +230,6 @@ SupabaseServiceRoleConfig resolveSupabaseConfig(
   String? url,
   String? serviceRoleKey,
   String? anonKey,
-  String? bucket,
-  String? basePath,
   SupabaseClientFactory? clientFactory,
 }) {
   final env = Platform.environment;
@@ -247,8 +243,8 @@ SupabaseServiceRoleConfig resolveSupabaseConfig(
 
   if (resolvedUrl == null || resolvedUrl.isEmpty) {
     throw StateError(
-      'Supabase URL is required. Set it via --url, SUPABASE_URL, or '
-      '`flutter_ota_kit config set supabase.url <url>`.',
+      'Supabase URL is required. Set it via SUPABASE_URL env var, '
+      'or `flutter-ota config set supabase.url <url>`.',
     );
   }
 
@@ -275,8 +271,6 @@ SupabaseStorageConfig resolveSupabaseStorageConfig(
     url: url,
     serviceRoleKey: serviceRoleKey,
     anonKey: anonKey,
-    bucket: bucket,
-    basePath: basePath,
     clientFactory: clientFactory,
   );
   return SupabaseStorageConfig(
@@ -284,12 +278,11 @@ SupabaseStorageConfig resolveSupabaseStorageConfig(
     supabaseServiceRoleKey: db.supabaseServiceRoleKey,
     supabaseAnonKey: db.supabaseAnonKey,
     clientFactory: db.clientFactory,
-    bucketName: db.supabaseServiceRoleKey != null || db.supabaseAnonKey != null
-        ? (bucket ??
-              Platform.environment['SUPABASE_BUCKET'] ??
-              config.supabase.bucket ??
-              'bundles')
-        : (bucket ?? config.supabase.bucket ?? 'bundles'),
+    bucketName:
+        bucket ??
+        Platform.environment['SUPABASE_BUCKET'] ??
+        config.supabase.bucket ??
+        'bundles',
     basePath:
         basePath ??
         Platform.environment['SUPABASE_BASE_PATH'] ??
@@ -387,8 +380,8 @@ PostgresConfig resolvePostgresDatabaseConfig(
 
   if (resolvedHost == null || resolvedHost.isEmpty) {
     throw StateError(
-      'Postgres host is required. Set --pg-host, POSTGRES_HOST, or '
-      '`flutter_ota_kit config set postgres.host <host>`.',
+      'Postgres host is required. Set POSTGRES_HOST env var, '
+      'or `flutter-ota config set postgres.host <host>`.',
     );
   }
 
@@ -765,15 +758,16 @@ PocketBaseDatabaseConfig resolvePocketBaseDatabaseConfig(
 
   if (resolvedUrl == null || resolvedUrl.isEmpty) {
     throw StateError(
-      'PocketBase URL is required. Set --pb-url, POCKETBASE_URL, or '
-      '`flutter_ota_kit config set pocketbase.url <url>`.',
+      'PocketBase URL is required. Set POCKETBASE_URL env var, '
+      'or `flutter-ota config set pocketbase.url <url>`.',
     );
   }
   if (resolvedEmail == null || resolvedPassword == null) {
     throw StateError(
-      'PocketBase admin credentials are required. Set --pb-email, '
-      '--pb-password, POCKETBASE_ADMIN_EMAIL/PASSWORD, or '
-      '`flutter_ota_kit config set pocketbase.*`.',
+      'PocketBase admin credentials are required. Set '
+      'POCKETBASE_ADMIN_EMAIL / POCKETBASE_ADMIN_PASSWORD env vars, or '
+      '`flutter-ota config set pocketbase.adminEmail/<email> '
+      'pocketbase.adminPassword/<password>`.',
     );
   }
 

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

@@ -61,9 +61,7 @@ class ListOptions {
 /// Build the zip, upload it, and register a [Bundle] via the backend.
 Future<Bundle> deployBundle(Backend backend, DeployOptions opts) async {
   if (opts.targetAppVersion != null && opts.fingerprintHash != null) {
-    throw StateError(
-      'Use only one of target-app-version / fingerprint-hash (DB CHECK).',
-    );
+    throw StateError('Use only one of target-app-version / fingerprint-hash.');
   }
   if (opts.targetAppVersion == null && opts.fingerprintHash == null) {
     throw StateError(

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

@@ -16,13 +16,17 @@ import 'dart:io';
 import 'package:path/path.dart' as p;
 
 class PocketBaseProcess {
-  PocketBaseProcess._(this.process, this.dataDir, this.binaryPath);
+  PocketBaseProcess._(this.process, this.dataDir, this.binaryPath)
+    : _exitCodeCompleted = false {
+    process.exitCode.then((_) => _exitCodeCompleted = true);
+  }
 
   final Process process;
   final Directory dataDir;
   final File binaryPath;
+  bool _exitCodeCompleted;
 
-  bool get isRunning => true;
+  bool get isRunning => !_exitCodeCompleted;
 
   int get pid => process.pid;
 
@@ -88,12 +92,14 @@ class PocketBaseProcessManager {
   }
 
   void _writeConfigFile(int pid) {
-    configFile.writeAsStringSync(jsonEncode({
-      'pid': pid,
-      'host': host,
-      'port': port,
-      'url': 'http://$host:$port',
-    }));
+    configFile.writeAsStringSync(
+      jsonEncode({
+        'pid': pid,
+        'host': host,
+        'port': port,
+        'url': 'http://$host:$port',
+      }),
+    );
   }
 
   Map<String, dynamic>? readConfig() {
@@ -131,19 +137,18 @@ class PocketBaseProcessManager {
     final hooksDir = Directory(p.join(dataDir.path, 'pb_hooks'));
     await hooksDir.create(recursive: true);
 
-    final mergedEnv = <String, String>{
-      ...Platform.environment,
-      ...?env,
-    };
+    final mergedEnv = <String, String>{...Platform.environment, ...?env};
 
     // Create superuser if credentials provided (PB 0.40+ doesn't support
     // PB_ADMIN_EMAIL env var, so we use the CLI directly).
     if (adminEmail != null && adminPassword != null) {
-      final result = await Process.run(
-        binaryPath.path,
-        ['superuser', 'upsert', '--dir=${dataDir.path}', adminEmail, adminPassword],
-        environment: mergedEnv,
-      );
+      final result = await Process.run(binaryPath.path, [
+        'superuser',
+        'upsert',
+        '--dir=${dataDir.path}',
+        adminEmail,
+        adminPassword,
+      ], environment: mergedEnv);
       if (result.exitCode != 0) {
         // Non-fatal; serve will continue but schema install may fail.
       }
@@ -214,5 +219,9 @@ class PocketBaseProcessManager {
         .transform(utf8.decoder)
         .transform(const LineSplitter())
         .map((line) => '[stdout] $line');
+    yield* proc.errors
+        .transform(utf8.decoder)
+        .transform(const LineSplitter())
+        .map((line) => '[stderr] $line');
   }
 }

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

@@ -221,7 +221,6 @@ class PocketBaseSchemaInstaller {
     required this.url,
     required this.adminEmail,
     required this.adminPassword,
-    http.Client? httpClient,
     this.bundlesCollection = 'bundles',
     this.channelsCollection = 'channels',
     this.auditLogCollection = 'audit_log',

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

@@ -24,7 +24,9 @@ class FlutterPatcherRunner extends CommandRunner<int> {
     // 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;
+      final cmdName = results.arguments.isNotEmpty
+          ? results.arguments.first
+          : null;
       if (cmdName != null) {
         final cmd = commands[cmdName];
         if (cmd != null && cmd.subcommands.isNotEmpty) {

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

@@ -127,7 +127,8 @@ Future<T> spinner<T>(
     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));
+    if (elapsed < 400)
+      await Future.delayed(Duration(milliseconds: 400 - elapsed));
     timer.cancel();
     sw.stop();
     stdout.write('\r\x1b[K  ${green('✓')} ${done ?? label}\n');
@@ -292,13 +293,11 @@ class Steps {
     _echo('  ${dim('·')} $label');
   }
 
-  /// Print boxed summary: "N applied · N skipped · N errors · TIME"
+  /// Print summary. Always inline — no box for a single line of text.
   void summary() {
     _sw.stop();
     final ms = _sw.elapsedMilliseconds;
-    final time = ms >= 1000
-        ? '${(ms / 1000).toStringAsFixed(1)}s'
-        : '${ms}ms';
+    final time = ms >= 1000 ? '${(ms / 1000).toStringAsFixed(1)}s' : '${ms}ms';
     final parts = <String>[];
     if (_done > 0) parts.add('${_done} completed');
     if (_skipped > 0) parts.add('${_skipped} skipped');
@@ -307,7 +306,7 @@ class Steps {
     }
     if (parts.isEmpty) parts.add('no steps');
     parts.add(time);
-    box('summary', [parts.join('  ·  ')]);
+    _echo('  ${dim(parts.join('  ·  '))}');
   }
 
   /// Run a step that shows a spinner while working, then marks it
@@ -401,9 +400,7 @@ class Steps {
     _activeTimer = null;
     _activeLabel = null;
     if (_colorOn) {
-      stdout.write(
-        '\r\x1b[K  ${success ? green('✓') : red('✗')} $label\n',
-      );
+      stdout.write('\r\x1b[K  ${success ? green('✓') : red('✗')} $label\n');
     }
     if (success) {
       _done++;
@@ -455,9 +452,7 @@ class ProgressBar {
     _spin = (_spin + 1) % _frames.length;
     final pctStr = '${(pct * 100).round()}%'.padLeft(4);
 
-    stdout.write(
-      '\r\x1b[K  ${cyan(_frames[_spin])} $_label  $bar $pctStr',
-    );
+    stdout.write('\r\x1b[K  ${cyan(_frames[_spin])} $_label  $bar $pctStr');
   }
 
   /// Finish: print the final status line. This is intentionally async and
@@ -470,11 +465,10 @@ class ProgressBar {
     _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));
+    if (elapsed < 500)
+      await Future.delayed(Duration(milliseconds: 500 - elapsed));
     final ms = _sw.elapsedMilliseconds;
-    final time = ms >= 1000
-        ? '${(ms / 1000).toStringAsFixed(1)}s'
-        : '${ms}ms';
+    final time = ms >= 1000 ? '${(ms / 1000).toStringAsFixed(1)}s' : '${ms}ms';
     if (_colorOn) {
       stdout.write('\r\x1b[K  ${green('✓')} $_label in $time\n');
     } else {

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

@@ -159,49 +159,49 @@ packages:
       path: "../../plugins/aws"
       relative: true
     source: path
-    version: "0.1.7"
+    version: "0.1.10"
   flutter_ota_kit_cloudflare:
     dependency: "direct main"
     description:
       path: "../../plugins/cloudflare"
       relative: true
     source: path
-    version: "0.1.7"
+    version: "0.1.10"
   flutter_ota_kit_core:
     dependency: "direct main"
     description:
       path: "../core"
       relative: true
     source: path
-    version: "0.1.6"
+    version: "0.1.8"
   flutter_ota_kit_plugin_core:
     dependency: "direct main"
     description:
       path: "../../plugins/plugin-core"
       relative: true
     source: path
-    version: "0.0.8"
+    version: "0.0.10"
   flutter_ota_kit_pocketbase:
     dependency: "direct main"
     description:
       path: "../../plugins/pocketbase"
       relative: true
     source: path
-    version: "0.1.4"
+    version: "0.1.7"
   flutter_ota_kit_postgres:
     dependency: "direct main"
     description:
       path: "../../plugins/postgres"
       relative: true
     source: path
-    version: "0.1.7"
+    version: "0.1.10"
   flutter_ota_kit_supabase:
     dependency: "direct main"
     description:
       path: "../../plugins/supabase"
       relative: true
     source: path
-    version: "0.1.8"
+    version: "0.1.11"
   frontend_server_client:
     dependency: transitive
     description:

package/dart-src/packages/cli-tools/test/mocks/mock_pocketbase_client.dart

@@ -226,8 +226,9 @@ class MockPocketBaseClient implements PocketBaseClient {
   Future<void> deleteAdmin(String id) async {}
 
   @override
-  Future<List<Map<String, dynamic>>> exportCollection(String collection) async =>
-      [];
+  Future<List<Map<String, dynamic>>> exportCollection(
+    String collection,
+  ) async => [];
 
   @override
   Future<void> importCollection(
@@ -247,7 +248,10 @@ class MockPocketBaseClient implements PocketBaseClient {
 
   @override
   Future<Map<String, dynamic>> listLogs({
-    String? filter, String? sort, int page = 1, int perPage = 30,
+    String? filter,
+    String? sort,
+    int page = 1,
+    int perPage = 30,
   }) async => {'items': [], 'totalItems': 0};
 
   @override

package/dart-src/packages/cli-tools/test/pocketbase_schema_test.dart

@@ -80,22 +80,19 @@ void main() {
     await mock.stop();
   });
 
-  test(
-    'schema installer creates all five collections on a fresh PB',
-    () async {
-      final installer = PocketBaseSchemaInstaller(
-        url: mock.baseUrl,
-        adminEmail: 'admin@x.com',
-        adminPassword: 'secret',
-      );
-      final result = await installer.install();
-      expect(mock.authCalled, isTrue);
-      expect(mock.lastAuthEmail, 'admin@x.com');
-      expect(result.created, containsAll(_allCollections));
-      expect(result.skipped, isEmpty);
-      expect(mock.createdCollections, containsAll(_allCollections));
-    },
-  );
+  test('schema installer creates all five collections on a fresh PB', () async {
+    final installer = PocketBaseSchemaInstaller(
+      url: mock.baseUrl,
+      adminEmail: 'admin@x.com',
+      adminPassword: 'secret',
+    );
+    final result = await installer.install();
+    expect(mock.authCalled, isTrue);
+    expect(mock.lastAuthEmail, 'admin@x.com');
+    expect(result.created, containsAll(_allCollections));
+    expect(result.skipped, isEmpty);
+    expect(mock.createdCollections, containsAll(_allCollections));
+  });
 
   test('schema installer skips collections that already exist', () async {
     mock.existingCollections = _allCollections;

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

@@ -1,3 +1,18 @@
+## 0.1.8
+
+- Release 2026-09-10
+
+## 0.1.8
+
+- Automated release 2026-09-10
+
+## 0.1.7
+
+- Added comprehensive documentation for all public APIs.
+- Improved `Bundle` equality and hashCode implementation.
+- Fixed `toSqlJson()` nullable field handling.
+- Added `semver` exports to barrel file.
+
 ## 0.1.6
 
 - Added `gitCommitHash` field to `UpdateInfo` for commit tracking.

package/dart-src/packages/core/lib/flutter_ota_kit_core.dart

@@ -21,6 +21,8 @@ export 'src/update_bundle_params.dart';
 // Algorithms.
 export 'src/rollout.dart';
 export 'src/semver.dart';
+export 'src/semver_range.dart' show satisfies;
+export 'src/semver_version.dart' show SemVer;
 export 'src/uuid.dart';
 
 // Bundle artifact helpers.