@_nazmiforreal/flutter-ota 0.1.19 → 0.1.20

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

@@ -17,7 +17,7 @@ import 'package:path/path.dart' as p;
 
 /// Default PocketBase version managed by the CLI. Bumped in lockstep with
 /// the rest of the stack.
-const String kDefaultPocketBaseVersion = '0.22.21';
+const String kDefaultPocketBaseVersion = '0.40.3';
 
 /// Where the binary + extracted files live.
 class PocketBaseInstallPaths {

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

@@ -4,9 +4,13 @@
 /// PB reads its data directory from the `--dir` flag (default `./pb_data`).
 /// The CLI's installer pre-creates that directory and copies hooks into
 /// `pb_data/pb_hooks/` before the first start.
+///
+/// A PID file (`pb.pid`) is written to the data directory on start so that
+/// `stop` can find and terminate the process even after the CLI restarts.
 library;
 
 import 'dart:async';
+import 'dart:convert';
 import 'dart:io';
 
 import 'package:path/path.dart' as p;
@@ -18,17 +22,15 @@ class PocketBaseProcess {
   final Directory dataDir;
   final File binaryPath;
 
-  bool get isRunning => true; // Process instance is always present after start.
+  bool get isRunning => true;
 
   int get pid => process.pid;
 
   Future<int> get exitCode => process.exitCode;
 
-  /// Returns the stdout/stderr streams merged.
   Stream<List<int>> get output => process.stdout;
   Stream<List<int>> get errors => process.stderr;
 
-  /// Send SIGINT (Ctrl+C) for a graceful shutdown, then SIGKILL if needed.
   Future<void> stop({Duration timeout = const Duration(seconds: 5)}) async {
     if (Platform.isWindows) {
       process.kill();
@@ -59,6 +61,55 @@ class PocketBaseProcessManager {
   PocketBaseProcess? _process;
   PocketBaseProcess? get process => _process;
 
+  File get pidFile => File(p.join(dataDir.path, 'pb.pid'));
+  File get configFile => File(p.join(dataDir.path, 'pb.json'));
+
+  /// Read the stored PID from the PID file, or -1 if not present.
+  int readPid() {
+    if (!pidFile.existsSync()) return -1;
+    final content = pidFile.readAsStringSync().trim();
+    return int.tryParse(content) ?? -1;
+  }
+
+  /// Check if the process identified by the PID file is still alive.
+  Future<bool> isRunningByPidFile() async {
+    final pid = readPid();
+    if (pid <= 0) return false;
+    try {
+      final result = await Process.run('kill', ['-0', '$pid']);
+      return result.exitCode == 0;
+    } catch (_) {
+      return false;
+    }
+  }
+
+  void _writePidFile(int pid) {
+    pidFile.writeAsStringSync(pid.toString());
+  }
+
+  void _writeConfigFile(int pid) {
+    configFile.writeAsStringSync(jsonEncode({
+      'pid': pid,
+      'host': host,
+      'port': port,
+      'url': 'http://$host:$port',
+    }));
+  }
+
+  Map<String, dynamic>? readConfig() {
+    if (!configFile.existsSync()) return null;
+    try {
+      return jsonDecode(configFile.readAsStringSync()) as Map<String, dynamic>;
+    } catch (_) {
+      return null;
+    }
+  }
+
+  void deletePidFile() {
+    if (pidFile.existsSync()) pidFile.deleteSync();
+    if (configFile.existsSync()) configFile.deleteSync();
+  }
+
   /// Start PB in the background. Returns once PB is listening (or after a
   /// short timeout waiting for it to come up).
   Future<PocketBaseProcess> start({
@@ -82,11 +133,22 @@ class PocketBaseProcessManager {
 
     final mergedEnv = <String, String>{
       ...Platform.environment,
-      if (adminEmail != null) 'PB_ADMIN_EMAIL': adminEmail,
-      if (adminPassword != null) 'PB_ADMIN_PASSWORD': adminPassword,
       ...?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,
+      );
+      if (result.exitCode != 0) {
+        // Non-fatal; serve will continue but schema install may fail.
+      }
+    }
+
     final proc = await Process.start(
       binaryPath.path,
       ['serve', '--http=${host}:$port', '--dir=${dataDir.path}'],
@@ -94,8 +156,10 @@ class PocketBaseProcessManager {
       mode: ProcessStartMode.detached,
     );
 
-    // Wait for the health endpoint to come up (best-effort; fall through
-    // after readyTimeout either way).
+    _writePidFile(proc.pid);
+    _writeConfigFile(proc.pid);
+
+    // Wait for the health endpoint to come up.
     final deadline = DateTime.now().add(readyTimeout);
     while (DateTime.now().isBefore(deadline)) {
       try {
@@ -114,10 +178,41 @@ class PocketBaseProcessManager {
     return _process!;
   }
 
+  /// Stop the running process by sending SIGINT, then SIGKILL if needed.
+  /// Also cleans up the PID file.
   Future<void> stop() async {
+    final proc = _process;
+    if (proc != null) {
+      await proc.stop();
+      _process = null;
+    } else {
+      // Try stopping by PID file (for externally started processes).
+      final pid = readPid();
+      if (pid > 0) {
+        try {
+          Process.killPid(pid, ProcessSignal.sigint);
+          // Give it a moment to shut down gracefully.
+          await Future<void>.delayed(const Duration(seconds: 2));
+          // Force kill if still alive.
+          try {
+            final check = await Process.run('kill', ['-0', '$pid']);
+            if (check.exitCode == 0) {
+              Process.killPid(pid, ProcessSignal.sigkill);
+            }
+          } catch (_) {}
+        } catch (_) {}
+      }
+    }
+    deletePidFile();
+  }
+
+  /// Get combined stdout+stderr log lines from the running process.
+  Stream<String> get logStream async* {
     final proc = _process;
     if (proc == null) return;
-    await proc.stop();
-    _process = null;
+    yield* proc.output
+        .transform(utf8.decoder)
+        .transform(const LineSplitter())
+        .map((line) => '[stdout] $line');
   }
 }

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

@@ -1,19 +1,22 @@
 /// Installs the flutter_ota_kit PocketBase schema (collections, indexes,
-/// default admin) on a running PB instance.
+/// default superuser) on a running PB instance.
 ///
 /// PocketBase is initialized with:
 ///   - `bundles` collection (the OTA bundle metadata)
 ///   - `channels` collection (release channels with a current_bundle pointer)
 ///   - `audit_log` collection (immutable event log)
-///   - `admins` is left to PB's built-in bootstrapping
-///     (set PB_ADMIN_EMAIL + PB_ADMIN_PASSWORD env vars on first start)
+///   - `app_meta` collection (key-value app metadata)
+///   - `bundles_patches` collection (per-bundle patch metadata)
+///   - `users` is PB's built-in auth collection
+///
+/// The first superuser is created via `pocketbase superuser upsert`
+/// before starting the server.
 ///
 /// Idempotent: re-running the installer is a no-op when collections exist.
 library;
 
 import 'dart:convert';
 
-import 'package:flutter_ota_kit_pocketbase/flutter_ota_kit_pocketbase.dart';
 import 'package:http/http.dart' as http;
 
 const _kBundlesCollection = r'''
@@ -95,6 +98,50 @@ const _kAuditLogCollection = r'''
 }
 ''';
 
+const _kBundlePatchesCollection = r'''
+{
+  "name": "bundles_patches",
+  "type": "base",
+  "listRule": null,
+  "viewRule": null,
+  "createRule": null,
+  "updateRule": null,
+  "deleteRule": null,
+  "fields": [
+    {"name": "bundle_id", "type": "text", "required": true, "options": {"max": 64}},
+    {"name": "base_bundle_id", "type": "text", "required": true, "options": {"max": 64}},
+    {"name": "base_file_hash", "type": "text", "required": true, "options": {"max": 128}},
+    {"name": "patch_file_hash", "type": "text", "required": true, "options": {"max": 128}},
+    {"name": "patch_storage_uri", "type": "text", "required": true, "options": {"max": 512}},
+    {"name": "order_index", "type": "number", "options": {"min": 0}},
+    {"name": "artifact", "type": "file", "options": {"maxSelect": 1, "maxSize": 0, "mimeTypes": []}}
+  ],
+  "indexes": [
+    "CREATE INDEX idx_patches_bundle ON bundles_patches (bundle_id)",
+    "CREATE INDEX idx_patches_base ON bundles_patches (base_bundle_id)"
+  ]
+}
+''';
+
+const _kMetaCollection = r'''
+{
+  "name": "app_meta",
+  "type": "base",
+  "listRule": null,
+  "viewRule": null,
+  "createRule": null,
+  "updateRule": null,
+  "deleteRule": null,
+  "fields": [
+    {"name": "key", "type": "text", "required": true, "options": {"min": 1, "max": 128}},
+    {"name": "value", "type": "json"}
+  ],
+  "indexes": [
+    "CREATE UNIQUE INDEX idx_meta_key ON app_meta (key)"
+  ]
+}
+''';
+
 class _RawAdminClient {
   _RawAdminClient(this.baseUrl);
   final String baseUrl;
@@ -102,7 +149,7 @@ class _RawAdminClient {
 
   Future<String> authenticate(String email, String password) async {
     final res = await http.post(
-      Uri.parse('$baseUrl/api/admins/auth-with-password'),
+      Uri.parse('$baseUrl/api/collections/_superusers/auth-with-password'),
       headers: {'content-type': 'application/json'},
       body: jsonEncode({'identity': email, 'password': password}),
     );
@@ -209,6 +256,10 @@ class PocketBaseSchemaInstaller {
     String rename(String json) {
       if (bundlesCollection != 'bundles') {
         json = json.replaceAll('"bundles"', '"$bundlesCollection"');
+        json = json.replaceAll(
+          'bundles_patches',
+          '${bundlesCollection}_patches',
+        );
       }
       if (channelsCollection != 'channels') {
         json = json.replaceAll('"channels"', '"$channelsCollection"');
@@ -219,10 +270,13 @@ class PocketBaseSchemaInstaller {
       return json;
     }
 
+    final patchesCollectionName = '${bundlesCollection}_patches';
     return [
       _CollectionSpec(bundlesCollection, rename(_kBundlesCollection)),
       _CollectionSpec(channelsCollection, rename(_kChannelsCollection)),
       _CollectionSpec(auditLogCollection, rename(_kAuditLogCollection)),
+      _CollectionSpec(patchesCollectionName, rename(_kBundlePatchesCollection)),
+      _CollectionSpec('app_meta', _kMetaCollection),
     ];
   }
 }

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

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

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

@@ -6,6 +6,7 @@
 library;
 
 import 'package:flutter_ota_kit_pocketbase/flutter_ota_kit_pocketbase.dart';
+import 'package:http/http.dart' as http;
 
 class MockPocketBaseClient implements PocketBaseClient {
   MockPocketBaseClient(this.store);
@@ -182,6 +183,154 @@ class MockPocketBaseClient implements PocketBaseClient {
   void close() {
     _closed = true;
   }
+
+  @override
+  Future<Map<String, dynamic>> healthDetailed() async => {
+    'code': 200,
+    'message': 'API is healthy.',
+    'data': {'canBackup': false},
+  };
+
+  @override
+  Future<List<PocketBaseBackup>> listBackups() async => [];
+
+  @override
+  Future<void> createBackup({String? name}) async {}
+
+  @override
+  Future<void> deleteBackup(String key) async {}
+
+  @override
+  Future<void> restoreBackup(String key) async {}
+
+  @override
+  String backupDownloadUrl(String key, String token) => '';
+
+  @override
+  Future<List<Map<String, dynamic>>> listAdmins() async => [];
+
+  @override
+  Future<Map<String, dynamic>> createAdmin({
+    required String email,
+    required String password,
+    required String passwordConfirm,
+  }) async => {'id': 'mock_admin', 'email': email};
+
+  @override
+  Future<Map<String, dynamic>> updateAdmin(
+    String id,
+    Map<String, dynamic> data,
+  ) async => data;
+
+  @override
+  Future<void> deleteAdmin(String id) async {}
+
+  @override
+  Future<List<Map<String, dynamic>>> exportCollection(String collection) async =>
+      [];
+
+  @override
+  Future<void> importCollection(
+    String collection,
+    List<Map<String, dynamic>> records,
+  ) async {}
+
+  @override
+  Future<http.Response> rawRequest(
+    String method,
+    String path, {
+    Map<String, dynamic>? body,
+  }) async => http.Response('{}', 200);
+
+  @override
+  Future<List<int>> downloadFileUnauth(String url) async => [];
+
+  @override
+  Future<Map<String, dynamic>> listLogs({
+    String? filter, String? sort, int page = 1, int perPage = 30,
+  }) async => {'items': [], 'totalItems': 0};
+
+  @override
+  Future<Map<String, dynamic>> getLog(String id) async => {};
+
+  @override
+  Future<List<Map<String, dynamic>>> getLogStats({String? filter}) async => [];
+
+  @override
+  Future<void> truncateLogs() async {}
+
+  @override
+  Future<List<Map<String, dynamic>>> listCollections() async => [];
+
+  @override
+  Future<Map<String, dynamic>> getCollection(String nameOrId) async => {};
+
+  @override
+  Future<Map<String, dynamic>> createCollection(
+    Map<String, dynamic> body,
+  ) async => body;
+
+  @override
+  Future<Map<String, dynamic>> updateCollection(
+    String nameOrId,
+    Map<String, dynamic> body,
+  ) async => body;
+
+  @override
+  Future<void> deleteCollection(String nameOrId) async {}
+
+  @override
+  Future<void> truncateCollection(String nameOrId) async {}
+
+  @override
+  Future<void> importCollections(
+    List<Map<String, dynamic>> collections, {
+    bool deleteMissing = false,
+  }) async {}
+
+  @override
+  Future<void> uploadBackup(List<int> bytes, {String? name}) async {}
+
+  @override
+  Future<List<Map<String, dynamic>>> batch(
+    List<Map<String, dynamic>> requests,
+  ) async => [];
+
+  @override
+  Future<Map<String, dynamic>> listSettings() async => {};
+
+  @override
+  Future<Map<String, dynamic>> updateSettings(
+    Map<String, dynamic> body,
+  ) async => body;
+
+  @override
+  Future<void> testS3(String filesystem) async {}
+
+  @override
+  Future<void> testEmail({
+    required String email,
+    required String template,
+    String? collection,
+  }) async {}
+
+  @override
+  Future<Map<String, dynamic>> runSql(String query) async => {};
+
+  @override
+  Future<List<Map<String, dynamic>>> listCrons() async => [];
+
+  @override
+  Future<void> runCron(String jobId) async {}
+
+  @override
+  Future<Map<String, dynamic>> getCollectionScaffolds() async => {};
+
+  @override
+  Future<List<Map<String, dynamic>>> listOAuth2Providers() async => [];
+
+  @override
+  Future<Map<String, dynamic>> dryRunViewQuery(String query) async => {};
 }
 
 /// In-memory store backing [MockPocketBaseClient].

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

@@ -29,7 +29,7 @@ class _MockPocketBase {
 
   Future<void> _handle(HttpRequest req) async {
     final path = req.uri.path;
-    if (path == '/api/admins/auth-with-password') {
+    if (path == '/api/collections/_superusers/auth-with-password') {
       authCalled = true;
       final body = jsonDecode(await utf8.decoder.bind(req).join()) as Map;
       lastAuthEmail = body['identity'] as String?;
@@ -63,6 +63,14 @@ class _MockPocketBase {
   }
 }
 
+const _allCollections = [
+  'bundles',
+  'channels',
+  'audit_log',
+  'bundles_patches',
+  'app_meta',
+];
+
 void main() {
   late _MockPocketBase mock;
   setUp(() async {
@@ -73,7 +81,7 @@ void main() {
   });
 
   test(
-    'schema installer creates the three collections on a fresh PB',
+    'schema installer creates all five collections on a fresh PB',
     () async {
       final installer = PocketBaseSchemaInstaller(
         url: mock.baseUrl,
@@ -83,24 +91,21 @@ void main() {
       final result = await installer.install();
       expect(mock.authCalled, isTrue);
       expect(mock.lastAuthEmail, 'admin@x.com');
-      expect(result.created, containsAll(['bundles', 'channels', 'audit_log']));
+      expect(result.created, containsAll(_allCollections));
       expect(result.skipped, isEmpty);
-      expect(
-        mock.createdCollections,
-        containsAll(['bundles', 'channels', 'audit_log']),
-      );
+      expect(mock.createdCollections, containsAll(_allCollections));
     },
   );
 
   test('schema installer skips collections that already exist', () async {
-    mock.existingCollections = ['bundles', 'channels', 'audit_log'];
+    mock.existingCollections = _allCollections;
     final installer = PocketBaseSchemaInstaller(
       url: mock.baseUrl,
       adminEmail: 'admin@x.com',
       adminPassword: 'secret',
     );
     final result = await installer.install();
-    expect(result.skipped, containsAll(['bundles', 'channels', 'audit_log']));
+    expect(result.skipped, containsAll(_allCollections));
     expect(result.created, isEmpty);
     expect(mock.createdCollections, isEmpty);
   });

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

@@ -1 +1,6 @@
-## 0.1.4
+## 0.1.6
+
+- Added `gitCommitHash` field to `UpdateInfo` for commit tracking.
+- General maintenance.
+
+## 0.1.5

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

@@ -9,6 +9,7 @@ class UpdateInfo {
   final UpdateStatus status;
   final String? storageUri;
   final String? fileHash;
+  final String? gitCommitHash;
 
   /// Internal rollout metadata; never serialized to update-check clients.
   final int? rolloutCohortCount;
@@ -21,6 +22,7 @@ class UpdateInfo {
     required this.status,
     required this.storageUri,
     required this.fileHash,
+    this.gitCommitHash,
     this.rolloutCohortCount,
     this.targetCohorts,
   });

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

@@ -1 +1,5 @@
-## 0.1.5
+## 0.1.7
+
+- General maintenance.
+
+## 0.1.6

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

@@ -1 +1,5 @@
-## 0.1.5
+## 0.1.7
+
+- General maintenance.
+
+## 0.1.6

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

@@ -1 +1,5 @@
-## 0.0.6
+## 0.0.8
+
+- General maintenance.
+
+## 0.0.7

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

@@ -1 +1,5 @@
-## 0.1.2
+## 0.1.4
+
+- General maintenance.
+
+## 0.1.3

package/dart-src/plugins/pocketbase/lib/flutter_ota_kit_pocketbase.dart

@@ -16,7 +16,8 @@ export 'src/pocketbase_client.dart'
         PocketBaseClient,
         PocketBaseClientFactory,
         PocketBaseException,
-        PocketBaseList;
+        PocketBaseList,
+        PocketBaseBackup;
 export 'src/pocketbase_database.dart'
     show pocketbaseDatabase, PocketBaseDatabaseConfig;
 export 'src/pocketbase_storage.dart'

package/dart-src/plugins/pocketbase/lib/src/pocketbase_bundle_mapper.dart

@@ -96,8 +96,16 @@ class PocketBaseBundleRow {
 }
 
 /// Convert a [PocketBaseBundleRow] into a [Bundle].
-Bundle mapRowToBundle(PocketBaseBundleRow row) {
+///
+/// If [patches] is provided, they are attached as [BundlePatchArtifact]s.
+Bundle mapRowToBundle(
+  PocketBaseBundleRow row, {
+  List<Map<String, dynamic>>? patches,
+}) {
   final rawMetadata = normalizeMetadata(row.metadata);
+  final patchArtifacts = patches
+      ?.map((p) => BundlePatchArtifact.fromJson(p.cast<String, dynamic>()))
+      .toList();
   return Bundle(
     id: row.id,
     channel: row.channel,
@@ -114,7 +122,7 @@ Bundle mapRowToBundle(PocketBaseBundleRow row) {
     manifestStorageUri: row.manifestStorageUri,
     manifestFileHash: row.manifestFileHash,
     assetBaseStorageUri: row.assetBaseStorageUri,
-    patches: const [],
+    patches: patchArtifacts,
     rolloutCohortCount: row.rolloutCohortCount,
     targetCohorts: row.targetCohorts,
   );