@_nazmiforreal/flutter-ota 0.1.12 → 0.1.13

package/dart-src/plugins/plugin-core/test/helpers_test.dart

@@ -5,11 +5,17 @@ import 'package:test/test.dart';
 
 void main() {
   group('paginateBundles', () {
-    List<Bundle> makeBundles(int count) =>
-        List.generate(count, (i) => _testBundle(id: 'b-${i.toString().padLeft(3, '0')}'));
+    List<Bundle> makeBundles(int count) => List.generate(
+      count,
+      (i) => _testBundle(id: 'b-${i.toString().padLeft(3, '0')}'),
+    );
 
     test('offset-based first page', () {
-      final result = paginateBundles(bundles: makeBundles(25), limit: 10, offset: 0);
+      final result = paginateBundles(
+        bundles: makeBundles(25),
+        limit: 10,
+        offset: 0,
+      );
       expect(result.data.length, 10);
       expect(result.pagination.total, 25);
       expect(result.pagination.hasNextPage, isTrue);
@@ -20,7 +26,11 @@ void main() {
     });
 
     test('offset-based last page', () {
-      final result = paginateBundles(bundles: makeBundles(25), limit: 10, offset: 20);
+      final result = paginateBundles(
+        bundles: makeBundles(25),
+        limit: 10,
+        offset: 20,
+      );
       expect(result.data.length, 5);
       expect(result.pagination.hasNextPage, isFalse);
       expect(result.pagination.hasPreviousPage, isTrue);
@@ -66,18 +76,20 @@ void main() {
 
   group('filterCompatibleAppVersions', () {
     test('filters and sorts descending', () {
-      final result = filterCompatibleAppVersions(
-        ['^1.0.0', '^2.0.0', '^0.5.0'],
-        '1.3.0',
-      );
+      final result = filterCompatibleAppVersions([
+        '^1.0.0',
+        '^2.0.0',
+        '^0.5.0',
+      ], '1.3.0');
       expect(result, ['^1.0.0']);
     });
 
     test('multiple compatible versions sorted desc', () {
-      final result = filterCompatibleAppVersions(
-        ['>=1.0.0', '>=1.2.0', '>=2.0.0'],
-        '1.5.0',
-      );
+      final result = filterCompatibleAppVersions([
+        '>=1.0.0',
+        '>=1.2.0',
+        '>=2.0.0',
+      ], '1.5.0');
       expect(result, ['>=1.2.0', '>=1.0.0']);
     });
   });
@@ -143,19 +155,31 @@ void main() {
 
   group('compressionFormat', () {
     test('detects zip', () {
-      expect(detectCompressionFormat('bundle.zip').format, CompressionFormat.zip);
+      expect(
+        detectCompressionFormat('bundle.zip').format,
+        CompressionFormat.zip,
+      );
     });
 
     test('detects tar.br', () {
-      expect(detectCompressionFormat('bundle.tar.br').format, CompressionFormat.tarBr);
+      expect(
+        detectCompressionFormat('bundle.tar.br').format,
+        CompressionFormat.tarBr,
+      );
     });
 
     test('detects tar.gz', () {
-      expect(detectCompressionFormat('bundle.tar.gz').format, CompressionFormat.tarGz);
+      expect(
+        detectCompressionFormat('bundle.tar.gz').format,
+        CompressionFormat.tarGz,
+      );
     });
 
     test('defaults to zip', () {
-      expect(detectCompressionFormat('bundle.xyz').format, CompressionFormat.zip);
+      expect(
+        detectCompressionFormat('bundle.xyz').format,
+        CompressionFormat.zip,
+      );
     });
 
     test('getContentType returns mime type for zip', () {
@@ -217,8 +241,8 @@ Bundle _testBundle({String id = 'test-bundle-id'}) {
 
 class _DummyStoragePlugin extends StoragePlugin {
   _DummyStoragePlugin({required bool node, required bool runtime})
-      : _node = node,
-        _runtime = runtime;
+    : _node = node,
+      _runtime = runtime;
 
   final bool _node;
   final bool _runtime;
@@ -231,9 +255,9 @@ class _DummyStoragePlugin extends StoragePlugin {
 
   @override
   StoragePluginProfiles get profiles => StoragePluginProfiles(
-        node: _node ? _DummyNodeStorageProfile() : null,
-        runtime: _runtime ? _DummyRuntimeStorageProfile() : null,
-      );
+    node: _node ? _DummyNodeStorageProfile() : null,
+    runtime: _runtime ? _DummyRuntimeStorageProfile() : null,
+  );
 }
 
 class _DummyNodeStorageProfile extends NodeStorageProfile {

package/dart-src/plugins/plugin-core/test/query_bundles_test.dart

@@ -44,18 +44,42 @@ void main() {
     });
 
     test('eq match', () {
-      expect(bundleIdMatchesFilter('abc', const DatabaseBundleIdFilter(eq: 'abc')), isTrue);
-      expect(bundleIdMatchesFilter('abc', const DatabaseBundleIdFilter(eq: 'def')), isFalse);
+      expect(
+        bundleIdMatchesFilter('abc', const DatabaseBundleIdFilter(eq: 'abc')),
+        isTrue,
+      );
+      expect(
+        bundleIdMatchesFilter('abc', const DatabaseBundleIdFilter(eq: 'def')),
+        isFalse,
+      );
     });
 
     test('gt match', () {
-      expect(bundleIdMatchesFilter('b', const DatabaseBundleIdFilter(gt: 'a')), isTrue);
-      expect(bundleIdMatchesFilter('a', const DatabaseBundleIdFilter(gt: 'b')), isFalse);
+      expect(
+        bundleIdMatchesFilter('b', const DatabaseBundleIdFilter(gt: 'a')),
+        isTrue,
+      );
+      expect(
+        bundleIdMatchesFilter('a', const DatabaseBundleIdFilter(gt: 'b')),
+        isFalse,
+      );
     });
 
     test('in match', () {
-      expect(bundleIdMatchesFilter('a', const DatabaseBundleIdFilter(ins: ['a', 'b'])), isTrue);
-      expect(bundleIdMatchesFilter('c', const DatabaseBundleIdFilter(ins: ['a', 'b'])), isFalse);
+      expect(
+        bundleIdMatchesFilter(
+          'a',
+          const DatabaseBundleIdFilter(ins: ['a', 'b']),
+        ),
+        isTrue,
+      );
+      expect(
+        bundleIdMatchesFilter(
+          'c',
+          const DatabaseBundleIdFilter(ins: ['a', 'b']),
+        ),
+        isFalse,
+      );
     });
 
     test('combined filters', () {
@@ -73,20 +97,56 @@ void main() {
 
     test('filters by channel', () {
       final bundle = _testBundle(channel: 'prod');
-      expect(bundleMatchesQueryWhere(bundle, const DatabaseBundleQueryWhere(channel: 'prod')), isTrue);
-      expect(bundleMatchesQueryWhere(bundle, const DatabaseBundleQueryWhere(channel: 'dev')), isFalse);
+      expect(
+        bundleMatchesQueryWhere(
+          bundle,
+          const DatabaseBundleQueryWhere(channel: 'prod'),
+        ),
+        isTrue,
+      );
+      expect(
+        bundleMatchesQueryWhere(
+          bundle,
+          const DatabaseBundleQueryWhere(channel: 'dev'),
+        ),
+        isFalse,
+      );
     });
 
     test('filters by enabled', () {
       final bundle = _testBundle(enabled: true);
-      expect(bundleMatchesQueryWhere(bundle, const DatabaseBundleQueryWhere(enabled: true)), isTrue);
-      expect(bundleMatchesQueryWhere(bundle, const DatabaseBundleQueryWhere(enabled: false)), isFalse);
+      expect(
+        bundleMatchesQueryWhere(
+          bundle,
+          const DatabaseBundleQueryWhere(enabled: true),
+        ),
+        isTrue,
+      );
+      expect(
+        bundleMatchesQueryWhere(
+          bundle,
+          const DatabaseBundleQueryWhere(enabled: false),
+        ),
+        isFalse,
+      );
     });
 
     test('filters by targetAppVersion null', () {
       final bundle = _testBundle(targetAppVersion: null);
-      expect(bundleMatchesQueryWhere(bundle, const DatabaseBundleQueryWhere(targetAppVersionNotNull: true)), isFalse);
-      expect(bundleMatchesQueryWhere(bundle, const DatabaseBundleQueryWhere(targetAppVersionNotNull: false)), isTrue);
+      expect(
+        bundleMatchesQueryWhere(
+          bundle,
+          const DatabaseBundleQueryWhere(targetAppVersionNotNull: true),
+        ),
+        isFalse,
+      );
+      expect(
+        bundleMatchesQueryWhere(
+          bundle,
+          const DatabaseBundleQueryWhere(targetAppVersionNotNull: false),
+        ),
+        isTrue,
+      );
     });
   });
 
@@ -107,7 +167,10 @@ void main() {
         _testBundle(id: 'a'),
         _testBundle(id: 'b'),
       ];
-      final sorted = sortBundles(bundles, const DatabaseBundleQueryOrder(direction: 'asc'));
+      final sorted = sortBundles(
+        bundles,
+        const DatabaseBundleQueryOrder(direction: 'asc'),
+      );
       expect(sorted.map((b) => b.id).toList(), ['a', 'b', 'c']);
     });
   });

package/dart-src/plugins/plugin-core/test/uuidv7_test.dart

@@ -23,9 +23,14 @@ void main() {
     test('produces valid UUID v7 format', () {
       final uuid = createUUIDv7();
       // 8-4-4-4-12 format
-      expect(uuid, matches(RegExp(
-        r'^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$',
-      )));
+      expect(
+        uuid,
+        matches(
+          RegExp(
+            r'^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$',
+          ),
+        ),
+      );
     });
 
     test('generates unique UUIDs', () {
@@ -60,18 +65,24 @@ void main() {
     test('produces different random bits', () {
       final original = createUUIDv7();
       // Generate a few — at least one should differ in random part
-      final differentFound = List.generate(10, (_) =>
-          createUUIDv7WithSameTimestamp(original))
-          .any((u) => u != original);
+      final differentFound = List.generate(
+        10,
+        (_) => createUUIDv7WithSameTimestamp(original),
+      ).any((u) => u != original);
       expect(differentFound, isTrue);
     });
 
     test('derived UUID still has version 7 and correct variant', () {
       final original = createUUIDv7();
       final derived = createUUIDv7WithSameTimestamp(original);
-      expect(derived, matches(RegExp(
-        r'^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$',
-      )));
+      expect(
+        derived,
+        matches(
+          RegExp(
+            r'^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$',
+          ),
+        ),
+      );
     });
   });
 }

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

@@ -0,0 +1,8 @@
+# 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.

package/dart-src/plugins/pocketbase/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xuelinger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -0,0 +1,54 @@
+# flutter_ota_kit_pocketbase
+
+PocketBase backend plugin for
+[`flutter_ota_kit`](https://github.com/HYPER12755/flutter-ota-kit) — a
+self-hostable code-push (OTA update) toolkit for Flutter Android.
+
+PocketBase is a single-binary, Go-based backend that gives you SQLite,
+auth, file storage, realtime, and an admin UI in one ~15 MB executable.
+This plugin makes PocketBase a drop-in `DatabasePlugin` + `StoragePlugin`
+for `flutter_ota_kit`.
+
+## Install
+
+```yaml
+dependencies:
+  flutter_ota_kit: ^0.1.10
+  flutter_ota_kit_pocketbase: ^0.1.0
+```
+
+## Quick start
+
+```dart
+import 'package:flutter_ota_kit/flutter_ota_kit.dart';
+import 'package:flutter_ota_kit_pocketbase/flutter_ota_kit_pocketbase.dart';
+
+await FlutterPatcher.init(
+  pocketbaseConfig: PocketBaseUpdateConfig(
+    url: 'http://localhost:8090',
+    adminEmail: 'admin@example.com',
+    adminPassword: 'super-secret',
+  ),
+  // ... other FlutterPatcher options
+);
+```
+
+## Start a local PocketBase with the schema pre-installed
+
+```bash
+flutter-ota serve -b pocketbase
+```
+
+This downloads PocketBase (if missing), creates the `bundles` and
+`channels` collections, installs validation hooks, and starts the
+admin UI at `http://localhost:8090/_/`.
+
+## Documentation
+
+- [Backend guide → PocketBase](https://github.com/HYPER12755/flutter-ota-kit/blob/main/doc/backends.md#pocketbase)
+- [API reference](https://github.com/HYPER12755/flutter-ota-kit/blob/main/doc/api-reference.md)
+- [Main README](https://github.com/HYPER12755/flutter-ota-kit)
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dart-src/plugins/pocketbase/example/lib/main.dart

@@ -0,0 +1,62 @@
+// flutter_ota_kit_pocketbase example
+//
+// `flutter_ota_kit_pocketbase` is a PocketBase backend for
+// `flutter_ota_kit`. PocketBase is a single-binary, self-hostable
+// backend (similar to Supabase) that gives you SQLite, auth, file
+// storage, realtime, and an admin UI in one ~15MB Go binary. This
+// plugin makes it a drop-in `DatabasePlugin` + `StoragePlugin`.
+//
+// Pair this with `flutter_ota_kit serve` (cli-tools) to start a local
+// PocketBase instance with the flutter_ota_kit schema pre-installed,
+// plus an admin UI at `http://localhost:8090/_/`.
+//
+// Run: `dart run example/main.dart`
+
+import 'package:flutter_ota_kit_pocketbase/flutter_ota_kit_pocketbase.dart';
+
+void main() {
+  // ── 1. Database config (the `bundles` collection). ──────────────
+  // `url` is the base URL of your PocketBase instance. `adminEmail` /
+  // `adminPassword` are the superuser credentials — used only for
+  // server-side reads/writes against the `bundles` and `channels`
+  // collections.
+  const dbConfig = PocketBaseConfig(
+    url: 'http://localhost:8090',
+    adminEmail: 'admin@example.com',
+    adminPassword: 'super-secret',
+  );
+  print('PocketBase URL: ${dbConfig.url}');
+  print('Bundles collection: ${dbConfig.bundlesCollection}');
+
+  // ── 2. Storage config (the `bundles` file bucket). ───────────────
+  // The `bundlesCollection` is the collection whose records carry the
+  // patch file attachments. The `bundlesBucket` is the file-storage
+  // bucket name within PocketBase.
+  const storageConfig = PocketBaseStorageConfig(
+    url: 'http://localhost:8090',
+    adminEmail: 'admin@example.com',
+    adminPassword: 'super-secret',
+    bundlesCollection: 'bundles',
+    bundlesBucket: 'bundles',
+  );
+  print('Bucket: ${storageConfig.bundlesBucket}');
+
+  // ── 3. Storage URI helpers. ──────────────────────────────────────
+  // Build a `pb://<bucket>/<recordId>/<file>` URI for a given
+  // record+filename. The device SDK understands this format and
+  // downloads via the PocketBase `/api/files/{collection}/{id}/{file}`
+  // endpoint (with a short-lived token).
+  final uri = buildPocketBaseStorageUri(
+    '01a059a6-7d3c-4f3e-8a2c-9c2e3a4b5d6e',
+    'patch.zip',
+  );
+  print('Storage URI: $uri');
+
+  // Round-trip it:
+  final parsed = parsePocketBaseStorageUri(uri);
+  if (parsed != null) {
+    print('Parsed bucket:   ${parsed.bucket}');
+    print('Parsed recordId: ${parsed.recordId}');
+    print('Parsed filename: ${parsed.filename}');
+  }
+}

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

@@ -0,0 +1,28 @@
+/// flutter_ota_kit_pocketbase — PocketBase backend for flutter_ota_kit.
+///
+/// PocketBase is a single-binary, self-hostable backend (similar to Supabase)
+/// that gives you SQLite, auth, file storage, realtime, and an admin UI in
+/// one ~15MB Go binary. This plugin makes it a drop-in `DatabasePlugin` +
+/// `StoragePlugin` for flutter_ota_kit.
+///
+/// Pair this with `flutter_ota_kit serve` (cli-tools) to start a local
+/// PocketBase instance with the flutter_ota_kit schema pre-installed, plus
+/// an admin UI at `http://localhost:8090/_/`.
+library;
+
+export 'src/pocketbase_config.dart';
+export 'src/pocketbase_client.dart'
+    show
+        PocketBaseClient,
+        PocketBaseClientFactory,
+        PocketBaseException,
+        PocketBaseList;
+export 'src/pocketbase_database.dart'
+    show pocketbaseDatabase, PocketBaseDatabaseConfig;
+export 'src/pocketbase_storage.dart'
+    show
+        pocketbaseStorage,
+        PocketBaseStorageConfig,
+        parsePocketBaseStorageUri,
+        buildPocketBaseStorageUri;
+export 'src/pocketbase_bundle_mapper.dart';

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

@@ -0,0 +1,121 @@
+/// Maps PocketBase bundle records to [Bundle] and back.
+library;
+
+import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart';
+import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+    show normalizeMetadata;
+
+/// Row shape of a `bundles` record as stored in PocketBase.
+class PocketBaseBundleRow {
+  PocketBaseBundleRow({
+    required this.id,
+    required this.channel,
+    required this.enabled,
+    required this.platform,
+    required this.shouldForceUpdate,
+    required this.fileHash,
+    required this.storageUri,
+    required this.rolloutCohortCount,
+    this.gitCommitHash,
+    this.message,
+    this.fingerprintHash,
+    this.targetAppVersion,
+    this.manifestStorageUri,
+    this.manifestFileHash,
+    this.assetBaseStorageUri,
+    this.targetCohorts,
+    this.metadata,
+    this.created,
+    this.updated,
+  });
+
+  factory PocketBaseBundleRow.fromJson(Map<String, dynamic> j) =>
+      PocketBaseBundleRow(
+        id: j['id'] as String? ?? '',
+        channel: j['channel'] as String? ?? 'production',
+        enabled: j['enabled'] as bool? ?? true,
+        platform: j['platform'] as String? ?? 'android',
+        shouldForceUpdate: j['should_force_update'] as bool? ?? false,
+        fileHash: j['file_hash'] as String? ?? '',
+        storageUri: j['storage_uri'] as String? ?? '',
+        rolloutCohortCount:
+            (j['rollout_cohort_count'] as num?)?.toInt() ?? 1000,
+        gitCommitHash: j['git_commit_hash'] as String?,
+        message: j['message'] as String?,
+        fingerprintHash: j['fingerprint_hash'] as String?,
+        targetAppVersion: j['target_app_version'] as String?,
+        manifestStorageUri: j['manifest_storage_uri'] as String?,
+        manifestFileHash: j['manifest_file_hash'] as String?,
+        assetBaseStorageUri: j['asset_base_storage_uri'] as String?,
+        targetCohorts: (j['target_cohorts'] as List?)?.cast<String>(),
+        metadata: (j['metadata'] as Map?)?.cast<String, dynamic>(),
+        created: j['created'] as String?,
+        updated: j['updated'] as String?,
+      );
+
+  final String id;
+  final String channel;
+  final bool enabled;
+  final String platform;
+  final bool shouldForceUpdate;
+  final String fileHash;
+  final String storageUri;
+  final int rolloutCohortCount;
+  final String? gitCommitHash;
+  final String? message;
+  final String? fingerprintHash;
+  final String? targetAppVersion;
+  final String? manifestStorageUri;
+  final String? manifestFileHash;
+  final String? assetBaseStorageUri;
+  final List<String>? targetCohorts;
+  final Map<String, dynamic>? metadata;
+  final String? created;
+  final String? updated;
+
+  Map<String, dynamic> toCreateJson() => {
+    'id': id,
+    'channel': channel,
+    'enabled': enabled,
+    'platform': platform,
+    'should_force_update': shouldForceUpdate,
+    'file_hash': fileHash,
+    'storage_uri': storageUri,
+    'rollout_cohort_count': rolloutCohortCount,
+    if (gitCommitHash != null) 'git_commit_hash': gitCommitHash,
+    if (message != null) 'message': message,
+    if (fingerprintHash != null) 'fingerprint_hash': fingerprintHash,
+    if (targetAppVersion != null) 'target_app_version': targetAppVersion,
+    if (manifestStorageUri != null) 'manifest_storage_uri': manifestStorageUri,
+    if (manifestFileHash != null) 'manifest_file_hash': manifestFileHash,
+    if (assetBaseStorageUri != null)
+      'asset_base_storage_uri': assetBaseStorageUri,
+    if (targetCohorts != null) 'target_cohorts': targetCohorts,
+    if (metadata != null) 'metadata': metadata,
+  };
+}
+
+/// Convert a [PocketBaseBundleRow] into a [Bundle].
+Bundle mapRowToBundle(PocketBaseBundleRow row) {
+  final rawMetadata = normalizeMetadata(row.metadata);
+  return Bundle(
+    id: row.id,
+    channel: row.channel,
+    enabled: row.enabled,
+    shouldForceUpdate: row.shouldForceUpdate,
+    fileHash: row.fileHash,
+    gitCommitHash: row.gitCommitHash,
+    message: row.message,
+    platform: Platform.fromValue(row.platform),
+    targetAppVersion: row.targetAppVersion,
+    fingerprintHash: row.fingerprintHash,
+    storageUri: row.storageUri,
+    metadata: rawMetadata != null ? BundleMetadata.fromJson(rawMetadata) : null,
+    manifestStorageUri: row.manifestStorageUri,
+    manifestFileHash: row.manifestFileHash,
+    assetBaseStorageUri: row.assetBaseStorageUri,
+    patches: const [],
+    rolloutCohortCount: row.rolloutCohortCount,
+    targetCohorts: row.targetCohorts,
+  );
+}