@_nazmiforreal/flutter-ota 0.1.26 → 0.1.28

package/dart-src/root/lib/src/pkg/client/src/server_update_source.dart

@@ -0,0 +1,46 @@
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
+    show PatchInfo, AppUpdateStatus;
+
+/// Rich result of an update check. Returned by every backend source
+/// (`SupabaseUpdateSource`, `PostgresUpdateSource`, `CloudflareUpdateSource`,
+/// `AwsUpdateSource`) so callers can treat all backends uniformly.
+class ServerUpdateResult {
+  const ServerUpdateResult({
+    required this.isUpToDate,
+    this.patch,
+    this.status = AppUpdateStatus.upToDate,
+    this.shouldForceUpdate = false,
+    this.id,
+    this.message,
+    this.gitCommitHash,
+    this.raw = const {},
+  });
+
+  /// No update available (or an explicit up-to-date response).
+  factory ServerUpdateResult.upToDate() =>
+      const ServerUpdateResult(isUpToDate: true);
+
+  final bool isUpToDate;
+
+  /// Installable payload, when an update (or forced rollback) is available.
+  final PatchInfo? patch;
+
+  /// `update` | `rollback` | `upToDate`.
+  final AppUpdateStatus status;
+
+  /// The server wants this applied even if the device would normally skip it.
+  final bool shouldForceUpdate;
+
+  final String? id;
+  final String? message;
+  final String? gitCommitHash;
+
+  /// Backend-specific raw response data not mapped to named fields.
+  ///
+  /// Contains any additional fields returned by the backend that are not
+  /// part of the standard update protocol. Useful for debugging or accessing
+  /// backend-specific metadata.
+  final Map<String, dynamic> raw;
+
+  bool get hasUpdate => !isUpToDate && patch != null;
+}

package/dart-src/{plugins/cloudflare/lib → root/lib/src/pkg/cloudflare}/src/cloudflare_worker_database.dart

@@ -1,4 +1,4 @@
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show createDatabasePlugin;
 
 import 'd1_client.dart' show D1ClientLike;

package/dart-src/{plugins/cloudflare/lib → root/lib/src/pkg/cloudflare}/src/d1_build_where.dart

@@ -1,6 +1,6 @@
 import 'dart:convert' show jsonEncode;
 
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show DatabaseBundleQueryWhere;
 
 /// Result of building a WHERE clause: SQL fragment plus positional params.

package/dart-src/{plugins/cloudflare/lib → root/lib/src/pkg/cloudflare}/src/d1_bundle_mapper.dart

@@ -1,6 +1,6 @@
 import 'dart:convert' show jsonDecode;
 
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
     show
         Bundle,
         BundleMetadata,
@@ -8,12 +8,12 @@ import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
         Platform,
         getBundlePatches;
 
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show buildBundlePatchId, normalizeMetadata;
 // Re-export the shared `buildBundlePatchId` so the cloudflare package's public
 // API still exposes it; `parseMetadata` remains a backward-compatible alias of
 // the shared `normalizeMetadata`.
-export 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+export 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show buildBundlePatchId;
 
 /// Default rollout cohort count — full rollout in the Dart port's per-mille

package/dart-src/{plugins/cloudflare/lib → root/lib/src/pkg/cloudflare}/src/d1_database.dart

@@ -1,4 +1,4 @@
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show createDatabasePlugin;
 
 import 'd1_config.dart' show D1DatabaseConfig, resolveD1Client;

package/dart-src/{plugins/cloudflare/lib → root/lib/src/pkg/cloudflare}/src/d1_database_plugin.dart

@@ -1,6 +1,6 @@
 import 'dart:convert' show jsonEncode;
 
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
     show
         AppVersionGetBundlesArgs,
         Bundle,
@@ -8,7 +8,7 @@ import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
         GetBundlesArgs,
         UpdateInfo,
         UpdateStrategy;
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show
         AbstractDatabasePlugin,
         BundleChange,

package/dart-src/{plugins/cloudflare/lib → root/lib/src/pkg/cloudflare}/src/r2_s3_client.dart

@@ -3,7 +3,7 @@ import 'dart:io' show File;
 import 'dart:typed_data' show Uint8List;
 
 import 'package:crypto/crypto.dart' show Hmac, sha256;
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show StorageObject;
 import 'package:http/http.dart' show Client, Request, Response;
 

package/dart-src/{plugins/cloudflare/lib → root/lib/src/pkg/cloudflare}/src/r2_storage.dart

@@ -1,4 +1,4 @@
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show StoragePlugin, createUniversalStoragePlugin;
 
 import 'r2_config.dart' show R2S3StorageConfig;

package/dart-src/{plugins/cloudflare/lib → root/lib/src/pkg/cloudflare}/src/r2_storage_profile.dart

@@ -1,6 +1,6 @@
 import 'package:path/path.dart' show basename;
 
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show
         NodeStorageProfile,
         RuntimeStorageProfile,

package/dart-src/{packages/core/lib → root/lib/src/pkg/core}/src/status.dart

@@ -31,7 +31,7 @@ enum AppUpdateStatus {
   /// Device is already on the latest bundle for its channel/platform.
   upToDate('UP_TO_DATE'),
 
-  /// Device should roll back to a previous bundle.
+  /// Device should roll back to a previous bundle (server signaled rollback).
   rollback('ROLLBACK'),
 
   /// Device should download and install a new bundle.

package/dart-src/{plugins/plugin-core/lib → root/lib/src/pkg/plugin_core}/flutter_ota_kit_plugin_core.dart

@@ -1,7 +1,7 @@
 library;
 
 // Re-export core types for convenience.
-export 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
+export 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
     show Bundle, GetBundlesArgs, Platform, UpdateInfo, semverSatisfies;
 
 // Plugin-core types.

package/dart-src/{plugins/plugin-core/lib → root/lib/src/pkg/plugin_core}/src/create_blob_database_plugin.dart

@@ -1,6 +1,6 @@
 import 'dart:convert';
 
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart';
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart';
 
 import 'bundle_unit_of_work.dart';
 import 'storage_helpers.dart' show updateJsonKeyRegex;

package/dart-src/{plugins/plugin-core/lib → root/lib/src/pkg/plugin_core}/src/filter_compatible_app_versions.dart

@@ -1,4 +1,4 @@
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
     show semverSatisfies;
 
 /// Filter target app versions that are compatible with the current app version.

package/dart-src/{plugins/plugin-core/lib → root/lib/src/pkg/plugin_core}/src/get_update_info.dart

@@ -1,4 +1,4 @@
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart';
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart';
 
 /// Build an [UpdateInfo] response from a [Bundle] and an [UpdateStatus].
 UpdateInfo _makeResponse(Bundle bundle, UpdateStatus status) {

package/dart-src/{plugins/plugin-core/lib → root/lib/src/pkg/plugin_core}/src/request_update_bundle_state.dart

@@ -1,4 +1,4 @@
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart' show Bundle;
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart' show Bundle;
 
 import 'bundle_unit_of_work.dart';
 import 'bundle_unit_of_work_store.dart';

package/dart-src/{plugins/plugin-core/lib → root/lib/src/pkg/plugin_core}/src/resolve_update_info_from_bundles.dart

@@ -1,4 +1,4 @@
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
     show Bundle, GetBundlesArgs, UpdateInfo, nilUuid;
 
 import 'get_update_info.dart' show getUpdateInfo;

package/dart-src/{plugins/plugin-core/lib → root/lib/src/pkg/plugin_core}/src/types.dart

@@ -1,5 +1,5 @@
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart';
-export 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart';
+export 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
     show Bundle, GetBundlesArgs, Platform, UpdateInfo;
 
 // ---------------------------------------------------------------------------

package/dart-src/{plugins/pocketbase/lib → root/lib/src/pkg/pocketbase}/src/pocketbase_bundle_mapper.dart

@@ -1,8 +1,8 @@
 /// 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'
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart';
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show normalizeMetadata;
 
 /// Row shape of a `bundles` record as stored in PocketBase.

package/dart-src/{plugins/pocketbase/lib → root/lib/src/pkg/pocketbase}/src/pocketbase_database.dart

@@ -5,8 +5,8 @@
 /// support, and comprehensive filter operators.
 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';
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart';
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart';
 
 import 'pocketbase_bundle_mapper.dart';
 import 'pocketbase_client.dart';
@@ -75,6 +75,14 @@ class _PocketBaseDatabase implements AbstractDatabasePlugin {
 
   @override
   Future<List<String>> getChannels() async {
+    // Try the dedicated `channels` collection first. It exists (the schema
+    // installer creates it) but is NOT populated by deploy/promote — those only
+    // touch `bundles`. So an empty result here does NOT mean "no channels"; it
+    // means the collection is unused. Fall through to deriving channels from the
+    // bundles themselves (matching Supabase's `get_channels`, which is
+    // bundle-derived). Previously this returned the empty list on success and
+    // never reached the fallback, so `channel list` always showed "(no
+    // channels)" even with live bundles.
     try {
       final res = await client.listRecords<dynamic>(
         config.channelsCollection,
@@ -82,24 +90,27 @@ class _PocketBaseDatabase implements AbstractDatabasePlugin {
         perPage: 200,
         sort: 'name',
       );
-      return res.items
+      final named = res.items
           .map((j) => (j as Map)['name'] as String? ?? '')
           .where((s) => s.isNotEmpty)
           .toList();
+      if (named.isNotEmpty) return named;
     } catch (_) {
-      // Fallback: extract distinct channels from bundles.
-      final res = await client.listRecords<PocketBaseBundleRow>(
-        config.bundlesCollection,
-        PocketBaseBundleRow.fromJson,
-        perPage: 500,
-        sort: '-created',
-      );
-      final channels = <String>{};
-      for (final b in res.items) {
-        if (b.channel.isNotEmpty) channels.add(b.channel);
-      }
-      return channels.toList()..sort();
+      // channels collection may not exist; fall through to bundle-derived.
+    }
+
+    // Fallback: distinct channels from the bundles collection.
+    final res = await client.listRecords<PocketBaseBundleRow>(
+      config.bundlesCollection,
+      PocketBaseBundleRow.fromJson,
+      perPage: 500,
+      sort: '-created',
+    );
+    final channels = <String>{};
+    for (final b in res.items) {
+      if (b.channel.isNotEmpty) channels.add(b.channel);
     }
+    return channels.toList()..sort();
   }
 
   // ----- Single bundle -----

package/dart-src/{plugins/pocketbase/lib → root/lib/src/pkg/pocketbase}/src/pocketbase_storage.dart

@@ -8,7 +8,7 @@ library;
 
 import 'dart:io';
 
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart';
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart';
 
 import 'pocketbase_client.dart';
 

package/dart-src/{plugins/postgres/lib → root/lib/src/pkg/postgres}/src/postgres_bundle_mapper.dart

@@ -2,7 +2,7 @@
 /// (the `mapRowToBundle` / `bundleToRowValues` / `bundleToPatchRows` helpers).
 library;
 
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
     show
         Bundle,
         BundleMetadata,
@@ -14,7 +14,7 @@ import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
         getManifestStorageUri,
         stripBundleArtifactMetadata;
 
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show buildBundlePatchId, normalizeMetadata;
 
 import 'postgres_types.dart';

package/dart-src/{plugins/postgres/lib → root/lib/src/pkg/postgres}/src/postgres_database.dart

@@ -1,9 +1,9 @@
 /// Faithful port of hot-updater `plugins/postgres/src/postgres.ts`.
 library;
 
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
     show Bundle, UpdateInfo;
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show
         AbstractDatabasePlugin,
         BundleChange,

package/dart-src/{plugins/postgres/lib → root/lib/src/pkg/postgres}/src/postgres_get_update_info.dart

@@ -6,7 +6,7 @@
 /// installed (see `supabase/migrations` parity work / Phase 5).
 library;
 
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
     show
         FingerprintGetBundlesArgs,
         GetBundlesArgs,
@@ -14,7 +14,7 @@ import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart'
         UpdateInfo,
         UpdateStatus,
         UpdateStrategy;
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show filterCompatibleAppVersions;
 
 import 'postgres_client.dart';

package/dart-src/{plugins/postgres/lib → root/lib/src/pkg/postgres}/src/postgres_storage.dart

@@ -2,7 +2,7 @@ import 'dart:convert';
 import 'dart:io';
 import 'dart:typed_data';
 
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart';
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart';
 
 import 'postgres_client.dart';
 import 'postgres_config.dart';

package/dart-src/{plugins/postgres/lib → root/lib/src/pkg/postgres}/src/postgres_types.dart

@@ -1,4 +1,4 @@
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart' show Platform;
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart' show Platform;
 
 /// Database row for the `bundles` table (snake_case columns).
 ///

package/dart-src/{plugins/supabase/lib → root/lib/src/pkg/supabase}/src/supabase_bundle_mapper.dart

@@ -1,9 +1,9 @@
 /// Faithful port of hot-updater `plugins/supabase/src/supabaseBundleMapper.ts`.
 library;
 
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart';
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart';
 
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart'
     show buildBundlePatchId, normalizeMetadata;
 
 import 'types.dart';

package/dart-src/{plugins/supabase/lib → root/lib/src/pkg/supabase}/src/supabase_database.dart

@@ -3,8 +3,8 @@ library;
 
 import 'dart:convert';
 
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart';
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart';
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart';
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart';
 
 import 'supabase_bundle_mapper.dart';
 import 'supabase_client_adapter.dart';

package/dart-src/{plugins/supabase/lib → root/lib/src/pkg/supabase}/src/supabase_edge_function_database.dart

@@ -1,7 +1,7 @@
 /// Faithful port of hot-updater `plugins/supabase/src/supabaseEdgeFunctionDatabase.ts`.
 library;
 
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart';
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart';
 
 import 'supabase_database.dart';
 

package/dart-src/{plugins/supabase/lib → root/lib/src/pkg/supabase}/src/supabase_edge_function_storage.dart

@@ -1,7 +1,7 @@
 /// Faithful port of hot-updater `plugins/supabase/src/supabaseEdgeFunctionStorage.ts`.
 library;
 
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart';
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart';
 
 import 'supabase_client_adapter.dart';
 import 'supabase_client_http.dart';

package/dart-src/{plugins/supabase/lib → root/lib/src/pkg/supabase}/src/supabase_storage.dart

@@ -3,7 +3,7 @@ library;
 
 import 'dart:io' as io;
 
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart';
+import 'package:flutter_ota_kit/src/pkg/plugin_core/flutter_ota_kit_plugin_core.dart';
 
 import 'supabase_client_adapter.dart';
 import 'supabase_client_http.dart';

package/dart-src/root/lib/src/pocketbase_update_source.dart

@@ -0,0 +1,107 @@
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
+    show nilUuid, Platform, UpdateStrategy;
+import 'package:flutter_ota_kit/src/pkg/client/flutter_ota_kit_client.dart'
+    show ServerUpdateResult;
+import 'package:flutter_ota_kit/src/pkg/pocketbase/flutter_ota_kit_pocketbase.dart'
+    show
+        pocketbaseDatabase,
+        pocketbaseStorage,
+        PocketBaseConfig,
+        PocketBaseStorageConfig;
+
+import 'shared_update_check.dart';
+
+/// Configuration for a **PocketBase** update source (self-hosted, single binary).
+///
+/// Talks to a PocketBase instance directly over its REST API. The schema must
+/// be installed via `flutter_ota_kit pocketbase serve` (or the equivalent
+/// admin script) before the first device check.
+///
+/// PocketBase is a single-binary Go backend (SQLite + auth + file storage +
+/// realtime + admin UI in ~15MB). It's the recommended option for small teams
+/// that want a Supabase-like experience without a cloud account.
+class PocketBaseUpdateConfig {
+  const PocketBaseUpdateConfig({
+    required this.url,
+    required this.adminEmail,
+    required this.adminPassword,
+    required this.bundlesCollection,
+    required this.bundlesBucket,
+    required this.channel,
+    required this.platform,
+    required this.updateStrategy,
+    this.appVersion,
+    this.fingerprintHash,
+    this.sdkVersion = '1.0.0',
+    this.cohort,
+    this.minBundleId = nilUuid,
+  });
+
+  /// Base URL of the PocketBase instance, e.g. `https://pb.example.com`.
+  final String url;
+
+  /// Admin email (used to mint short-lived file tokens for downloads).
+  final String adminEmail;
+
+  /// Admin password.
+  final String adminPassword;
+
+  /// Name of the PB collection that stores bundle records.
+  final String bundlesCollection;
+
+  /// Name of the PB file storage bucket for bundle artifacts.
+  final String bundlesBucket;
+
+  final String channel;
+  final Platform platform;
+  final UpdateStrategy updateStrategy;
+  final String? appVersion;
+  final String? fingerprintHash;
+  final String sdkVersion;
+  final String? cohort;
+
+  /// Build-time scan floor (mirrors hot-updater's `getMinBundleId()`). Bundles
+  /// with an id older than this are never served.
+  final String minBundleId;
+}
+
+/// Device-side update source backed by a self-hosted PocketBase instance.
+class PocketBaseUpdateSource {
+  const PocketBaseUpdateSource();
+
+  Future<ServerUpdateResult> check(
+    PocketBaseUpdateConfig config, {
+    String? currentBundleId,
+    Duration timeout = const Duration(seconds: 10),
+  }) async {
+    final dbConfig = PocketBaseConfig(
+      url: config.url,
+      adminEmail: config.adminEmail,
+      adminPassword: config.adminPassword,
+      bundlesCollection: config.bundlesCollection,
+    );
+    final storageConfig = PocketBaseStorageConfig(
+      url: config.url,
+      adminEmail: config.adminEmail,
+      adminPassword: config.adminPassword,
+      bundlesCollection: config.bundlesCollection,
+      bundlesBucket: config.bundlesBucket,
+    );
+
+    final db = pocketbaseDatabase(dbConfig)();
+    final storage = pocketbaseStorage(storageConfig);
+
+    return performSharedUpdateCheck(
+      db: db,
+      storage: storage,
+      channel: config.channel,
+      platform: config.platform,
+      updateStrategy: config.updateStrategy,
+      appVersion: config.appVersion,
+      fingerprintHash: config.fingerprintHash,
+      minBundleId: config.minBundleId,
+      currentBundleId: currentBundleId,
+      timeout: timeout,
+    );
+  }
+}

package/dart-src/root/lib/src/postgres_update_source.dart

@@ -0,0 +1,95 @@
+import 'package:flutter_ota_kit/src/pkg/core/flutter_ota_kit_core.dart'
+    show nilUuid, Platform, UpdateStrategy;
+import 'package:flutter_ota_kit/src/pkg/client/flutter_ota_kit_client.dart'
+    show ServerUpdateResult;
+import 'package:flutter_ota_kit/src/pkg/postgres/flutter_ota_kit_postgres.dart'
+    show
+        postgresDatabase,
+        postgresStorage,
+        PostgresConfig,
+        PostgresStorageConfig;
+
+import 'shared_update_check.dart';
+
+/// Configuration for a **Postgres** update source.
+///
+/// Like [SupabaseUpdateConfig], this talks to the backend directly — no separate
+/// server process. The database plugin resolves the bundle metadata and the
+/// storage plugin resolves the download URL. Because Postgres cannot serve bytes
+/// over HTTP itself, [servingBaseUrl] must point at a proxy that reads from the
+/// `flutter_ota_kit_storage` table (or leave it null and let the device read
+/// directly if a PostgREST/HTTP layer is in front of the database).
+class PostgresUpdateConfig {
+  const PostgresUpdateConfig({
+    required this.host,
+    this.port = 5432,
+    required this.database,
+    this.username,
+    this.password,
+    this.sslMode,
+    this.servingBaseUrl,
+    required this.channel,
+    required this.platform,
+    required this.updateStrategy,
+    this.appVersion,
+    this.fingerprintHash,
+    this.sdkVersion = '1.0.0',
+    this.cohort,
+    this.minBundleId = nilUuid,
+  });
+
+  final String host;
+  final int port;
+  final String database;
+  final String? username;
+  final String? password;
+  final Object? sslMode;
+  final String? servingBaseUrl;
+  final String channel;
+  final Platform platform;
+  final UpdateStrategy updateStrategy;
+  final String? appVersion;
+  final String? fingerprintHash;
+  final String sdkVersion;
+  final String? cohort;
+  final String minBundleId;
+}
+
+class PostgresUpdateSource {
+  const PostgresUpdateSource();
+
+  Future<ServerUpdateResult> check(
+    PostgresUpdateConfig config, {
+    String? currentBundleId,
+    Duration timeout = const Duration(seconds: 10),
+  }) async {
+    final dbConfig = PostgresConfig(
+      host: config.host,
+      port: config.port,
+      database: config.database,
+      username: config.username,
+      password: config.password,
+      sslMode: config.sslMode as dynamic,
+    );
+    final storageConfig = PostgresStorageConfig(
+      db: dbConfig,
+      servingBaseUrl: config.servingBaseUrl,
+    );
+
+    final db = postgresDatabase(dbConfig)();
+    final storage = postgresStorage(storageConfig);
+
+    return performSharedUpdateCheck(
+      db: db,
+      storage: storage,
+      channel: config.channel,
+      platform: config.platform,
+      updateStrategy: config.updateStrategy,
+      appVersion: config.appVersion,
+      fingerprintHash: config.fingerprintHash,
+      minBundleId: config.minBundleId,
+      currentBundleId: currentBundleId,
+      timeout: timeout,
+    );
+  }
+}