@_nazmiforreal/flutter-ota 0.1.0 → 0.1.2

package/dart-src/plugins/cloudflare/lib/src/r2_storage_profile.dart

@@ -0,0 +1,110 @@
+import 'package:path/path.dart' show basename;
+
+import 'package:flutter_patcher_plugin_core/flutter_patcher_plugin_core.dart'
+    show
+        NodeStorageProfile,
+        RuntimeStorageProfile,
+        StorageObject,
+        createStorageKeyBuilder,
+        getContentType,
+        parseStorageUri;
+
+import 'r2_config.dart' show R2S3StorageConfig, resolveR2Client;
+import 'r2_s3_client.dart' show R2S3ClientLike, readFileBytes, writeFileBytes;
+
+void _ensureExpectedBucket(String bucket, String bucketName) {
+  if (bucket != bucketName) {
+    throw ArgumentError(
+      'Bucket name mismatch: expected "$bucketName", but found "$bucket".',
+    );
+  }
+}
+
+/// Build the node (deploy/CLI) storage profile for R2 S3.
+NodeStorageProfile createS3StorageProfile(R2S3StorageConfig config) {
+  final R2S3ClientLike client = resolveR2Client(config);
+  final getStorageKey = createStorageKeyBuilder(config.basePath);
+
+  return _R2NodeProfile(client, config, getStorageKey);
+}
+
+/// Build the runtime (update-check) storage profile for R2 S3.
+RuntimeStorageProfile createS3RuntimeStorageProfile(R2S3StorageConfig config) {
+  final R2S3ClientLike client = resolveR2Client(config);
+  return _R2RuntimeProfile(client, config);
+}
+
+class _R2NodeProfile implements NodeStorageProfile {
+  _R2NodeProfile(this._client, this._config, this._getStorageKey);
+
+  final R2S3ClientLike _client;
+  final R2S3StorageConfig _config;
+  final String Function(String, [String, String, String]) _getStorageKey;
+
+  @override
+  Future<Map<String, String>> upload(String key, String filePath) async {
+    final bytes = await readFileBytes(filePath);
+    final contentType = getContentType(filePath);
+    final filename = basename(filePath);
+    final storageKey = _getStorageKey(key, filename);
+
+    await _client.putObject(storageKey, bytes, contentType);
+    return {'storageUri': 'r2://${_config.bucketName}/$storageKey'};
+  }
+
+  @override
+  Future<bool> exists(String storageUri) async {
+    final parsed = parseStorageUri(storageUri, 'r2');
+    _ensureExpectedBucket(parsed.bucket, _config.bucketName);
+    return _client.headObject(parsed.key);
+  }
+
+  @override
+  Future<void> delete(String storageUri) async {
+    final parsed = parseStorageUri(storageUri, 'r2');
+    _ensureExpectedBucket(parsed.bucket, _config.bucketName);
+    await _client.deleteObject(parsed.key);
+  }
+
+  @override
+  Future<void> downloadFile(String storageUri, String filePath) async {
+    final parsed = parseStorageUri(storageUri, 'r2');
+    _ensureExpectedBucket(parsed.bucket, _config.bucketName);
+    final bytes = await _client.getObjectAsBytes(parsed.key);
+    await writeFileBytes(filePath, bytes);
+  }
+
+  @override
+  Future<List<StorageObject>> listObjects([String? prefix]) =>
+      _client.listObjects(prefix);
+
+  @override
+  Future<void> deleteObjects(List<String> keys) =>
+      _client.deleteObjects(keys);
+}
+
+class _R2RuntimeProfile implements RuntimeStorageProfile {
+  _R2RuntimeProfile(this._client, this._config);
+
+  final R2S3ClientLike _client;
+  final R2S3StorageConfig _config;
+
+  @override
+  Future<Map<String, String>> getDownloadUrl(String storageUri) async {
+    final parsed = parseStorageUri(storageUri, 'r2');
+    _ensureExpectedBucket(parsed.bucket, _config.bucketName);
+    final fileUrl = await _client.getSignedUrl(parsed.key);
+    return {'fileUrl': fileUrl};
+  }
+
+  @override
+  Future<String?> readText(String storageUri) async {
+    final parsed = parseStorageUri(storageUri, 'r2');
+    _ensureExpectedBucket(parsed.bucket, _config.bucketName);
+    try {
+      return await _client.getObjectAsString(parsed.key);
+    } catch (_) {
+      return null;
+    }
+  }
+}

package/dart-src/plugins/cloudflare/migrations/0001_hot-updater_init.sql

@@ -0,0 +1,16 @@
+-- Migration number: 0001 	 2025-01-27T08:37:50.374Z
+-- HotUpdater.bundles
+
+CREATE TABLE bundles (
+    id TEXT PRIMARY KEY,
+    platform TEXT NOT NULL CHECK (platform IN ('ios', 'android')),
+    target_app_version TEXT NOT NULL,
+    should_force_update INTEGER NOT NULL CHECK (should_force_update IN (0, 1)),
+    enabled INTEGER NOT NULL CHECK (enabled IN (0, 1)),
+    file_url TEXT NOT NULL,
+    file_hash TEXT NOT NULL,
+    git_commit_hash TEXT,
+    message TEXT
+);
+
+CREATE INDEX bundles_target_app_version_idx ON bundles(target_app_version);

package/dart-src/plugins/cloudflare/migrations/0002_hot-updater_0.13.0.sql

@@ -0,0 +1,8 @@
+-- Migration number: 0002 	 2025-03-07T16:25:12.486Z
+-- HotUpdater.bundles
+
+ALTER TABLE bundles
+ADD COLUMN channel TEXT NOT NULL DEFAULT 'production';
+
+ALTER TABLE bundles
+DROP COLUMN file_url;

package/dart-src/plugins/cloudflare/migrations/0003_hot-updater_0.18.0.sql

@@ -0,0 +1,38 @@
+-- Migration number: 0003 	 2025-05-18T16:25:12.486Z
+-- HotUpdater.bundles
+
+ALTER TABLE bundles ADD COLUMN fingerprint_hash TEXT;
+ALTER TABLE bundles ADD COLUMN storage_uri TEXT;
+ALTER TABLE bundles ADD COLUMN metadata JSONB DEFAULT '{}';
+
+UPDATE bundles
+SET storage_uri = 'r2://%%BUCKET_NAME%%/' || id || '/bundle.zip'
+WHERE storage_uri IS NULL;
+
+CREATE TABLE bundles_temp (
+    id TEXT PRIMARY KEY,
+    platform TEXT NOT NULL,
+    should_force_update INTEGER NOT NULL,
+    enabled INTEGER NOT NULL,
+    file_hash TEXT NOT NULL,
+    git_commit_hash TEXT,
+    message TEXT,
+    channel TEXT NOT NULL DEFAULT 'production',
+    storage_uri TEXT NOT NULL,
+    target_app_version TEXT,
+    fingerprint_hash TEXT,
+    metadata JSONB DEFAULT '{}',
+    CHECK ((target_app_version IS NOT NULL) OR (fingerprint_hash IS NOT NULL))
+);
+
+INSERT INTO bundles_temp 
+SELECT id, platform, should_force_update, enabled, file_hash, git_commit_hash, message, channel, storage_uri, target_app_version, fingerprint_hash, metadata
+FROM bundles;
+
+DROP TABLE bundles;
+
+ALTER TABLE bundles_temp RENAME TO bundles;
+
+CREATE INDEX bundles_target_app_version_idx ON bundles(target_app_version);
+CREATE INDEX bundles_fingerprint_hash_idx ON bundles(fingerprint_hash);
+CREATE INDEX bundles_channel_idx ON bundles(channel);

package/dart-src/plugins/cloudflare/migrations/0004_hot-updater_0.29.0.sql

@@ -0,0 +1,11 @@
+-- Migration number: 0004 	 2025-12-21T00:00:00.000Z
+
+-- HotUpdater.bundles
+
+ALTER TABLE bundles ADD COLUMN rollout_cohort_count INTEGER DEFAULT 1000
+  CHECK (rollout_cohort_count >= 0 AND rollout_cohort_count <= 1000);
+
+CREATE INDEX IF NOT EXISTS bundles_rollout_idx ON bundles(rollout_cohort_count);
+
+-- SQLite doesn't have array type, store as JSON text
+ALTER TABLE bundles ADD COLUMN target_cohorts TEXT;

package/dart-src/plugins/cloudflare/migrations/0005_hot-updater_0.31.0.sql

@@ -0,0 +1,24 @@
+-- Migration number: 0005 	 2026-04-22T00:00:00.000Z
+
+-- HotUpdater.bundle_artifact_columns
+
+ALTER TABLE bundles ADD COLUMN manifest_storage_uri TEXT;
+ALTER TABLE bundles ADD COLUMN manifest_file_hash TEXT;
+ALTER TABLE bundles ADD COLUMN asset_base_storage_uri TEXT;
+
+CREATE TABLE bundle_patches (
+    id TEXT PRIMARY KEY,
+    bundle_id TEXT NOT NULL,
+    base_bundle_id TEXT NOT NULL,
+    base_file_hash TEXT NOT NULL,
+    patch_file_hash TEXT NOT NULL,
+    patch_storage_uri TEXT NOT NULL,
+    order_index INTEGER NOT NULL DEFAULT 0,
+    FOREIGN KEY (bundle_id) REFERENCES bundles(id) ON DELETE CASCADE,
+    FOREIGN KEY (base_bundle_id) REFERENCES bundles(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS bundle_patches_bundle_id_idx
+    ON bundle_patches(bundle_id);
+CREATE INDEX IF NOT EXISTS bundle_patches_base_bundle_id_idx
+    ON bundle_patches(base_bundle_id);

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

@@ -0,0 +1,20 @@
+name: flutter_patcher_cloudflare
+description: Cloudflare D1 + R2 storage plugins for flutter_patcher (faithful port of hot-updater plugins/cloudflare).
+version: 0.1.0
+publish_to: none
+
+environment:
+  sdk: ">=3.3.0 <4.0.0"
+
+dependencies:
+  flutter_patcher_core:
+    path: ../../packages/core
+  flutter_patcher_plugin_core:
+    path: ../../plugins/plugin-core
+  crypto: ^3.0.0
+  http: ^1.2.0
+  path: ^1.9.0
+
+dev_dependencies:
+  test: ^1.25.0
+  lints: ^4.0.0

package/dart-src/plugins/cloudflare/sql/bundles.sql

@@ -0,0 +1,42 @@
+-- HotUpdater.bundles
+
+CREATE TABLE bundles (
+    id TEXT PRIMARY KEY,
+    platform TEXT NOT NULL CHECK (platform IN ('ios', 'android')),
+    target_app_version TEXT,
+    should_force_update INTEGER NOT NULL CHECK (should_force_update IN (0, 1)),
+    enabled INTEGER NOT NULL CHECK (enabled IN (0, 1)),
+    file_hash TEXT NOT NULL,
+    git_commit_hash TEXT,
+    message TEXT,
+    channel TEXT NOT NULL DEFAULT 'production',
+    storage_uri TEXT NOT NULL,
+    fingerprint_hash TEXT,
+    metadata JSONB DEFAULT '{}',
+    manifest_storage_uri TEXT,
+    manifest_file_hash TEXT,
+    asset_base_storage_uri TEXT,
+    rollout_cohort_count INTEGER DEFAULT 1000
+      CHECK (rollout_cohort_count >= 0 AND rollout_cohort_count <= 1000),
+    target_cohorts TEXT,
+    CHECK ((target_app_version IS NOT NULL) OR (fingerprint_hash IS NOT NULL))
+);
+
+CREATE TABLE bundle_patches (
+    id TEXT PRIMARY KEY,
+    bundle_id TEXT NOT NULL,
+    base_bundle_id TEXT NOT NULL,
+    base_file_hash TEXT NOT NULL,
+    patch_file_hash TEXT NOT NULL,
+    patch_storage_uri TEXT NOT NULL,
+    order_index INTEGER NOT NULL DEFAULT 0,
+    FOREIGN KEY (bundle_id) REFERENCES bundles(id) ON DELETE CASCADE,
+    FOREIGN KEY (base_bundle_id) REFERENCES bundles(id) ON DELETE CASCADE
+);
+
+CREATE INDEX bundles_target_app_version_idx ON bundles(target_app_version);
+CREATE INDEX bundles_fingerprint_hash_idx ON bundles(fingerprint_hash);
+CREATE INDEX bundles_channel_idx ON bundles(channel);
+CREATE INDEX bundles_rollout_idx ON bundles(rollout_cohort_count);
+CREATE INDEX bundle_patches_bundle_id_idx ON bundle_patches(bundle_id);
+CREATE INDEX bundle_patches_base_bundle_id_idx ON bundle_patches(base_bundle_id);

package/dart-src/plugins/plugin-core/lib/flutter_patcher_plugin_core.dart

@@ -0,0 +1,42 @@
+library;
+
+// Re-export core types for convenience.
+export 'package:flutter_patcher_core/flutter_patcher_core.dart'
+    show
+        Bundle,
+        GetBundlesArgs,
+        Platform,
+        UpdateInfo,
+        semverSatisfies;
+
+// Plugin-core types.
+export 'src/types.dart';
+
+// Helpers.
+export 'src/calculate_pagination.dart';
+export 'src/query_bundles.dart';
+export 'src/paginate_bundles.dart';
+export 'src/filter_compatible_app_versions.dart';
+export 'src/parse_storage_uri.dart';
+export 'src/content_addressed_assets.dart';
+export 'src/compression_format.dart';
+export 'src/storage_profile.dart';
+export 'src/create_storage_key_builder.dart';
+export 'src/is_object.dart';
+export 'src/asset_storage_layout.dart';
+export 'src/bundle_storage_layout.dart';
+export 'src/legacy_asset_storage_layout.dart';
+
+// Factories.
+export 'src/bundle_unit_of_work.dart';
+export 'src/bundle_unit_of_work_store.dart'
+    show getRequestBundleUnitOfWork, clearUnitOfWorkStore;
+export 'src/request_update_bundle_state.dart';
+export 'src/create_database_plugin.dart';
+export 'src/create_blob_database_plugin.dart';
+export 'src/create_storage_plugin.dart';
+export 'src/generate_min_bundle_id.dart';
+export 'src/uuidv7.dart';
+export 'src/get_update_info.dart';
+export 'src/resolve_update_info_from_bundles.dart';
+export 'src/resolve_update_info_from_bundles.dart';

package/dart-src/plugins/plugin-core/lib/src/asset_storage_layout.dart

@@ -0,0 +1,94 @@
+import 'content_addressed_assets.dart' show getContentAddressedAssetStoragePath;
+import 'legacy_asset_storage_layout.dart' show getLegacyManifestAssetStoragePath;
+
+/// The two supported asset storage layout strategies.
+typedef AssetStorageLayout = String;
+
+const String assetLayoutContentAddressed = 'content-addressed';
+const String assetLayoutLegacyFiles = 'legacy-files';
+
+/// Whether [assetPath] is a brotli-compressed manifest path
+/// (e.g. `index.android.bundle` → `index.android.bundle.br`).
+bool isBrotliManifestAssetPath(String assetPath) {
+  return RegExp(r'(^|/)index\.[^/]+\.bundle$')
+      .hasMatch(assetPath.replaceAll('\\', '/'));
+}
+
+/// Append `.br` to brotli manifest asset paths, pass through otherwise.
+String getManifestAssetDownloadPath(String assetPath) {
+  return isBrotliManifestAssetPath(assetPath) ? '$assetPath.br' : assetPath;
+}
+
+/// Build a full storage URI by joining a base URI with a relative path.
+///
+/// Segments of [relativePath] are percent-encoded individually.
+String createStorageUriWithRelativePath({
+  required String baseStorageUri,
+  required String relativePath,
+}) {
+  final storageUrl = Uri.parse(baseStorageUri);
+  final normalizedBasePath =
+      storageUrl.path.replaceAll(RegExp(r'/+$'), '');
+  final normalizedRelativePath = relativePath
+      .replaceAll('\\', '/')
+      .split('/')
+      .where((s) => s.isNotEmpty)
+      .map(Uri.encodeComponent)
+      .join('/');
+
+  return storageUrl
+      .replace(path: '$normalizedBasePath/$normalizedRelativePath')
+      .toString();
+}
+
+/// Determine the asset storage layout from the base URI.
+///
+/// Returns `'content-addressed'` if the URI path ends with `/assets`,
+/// otherwise `'legacy-files'`.
+AssetStorageLayout getAssetStorageLayout(String assetBaseStorageUri) {
+  final pathname =
+      Uri.parse(assetBaseStorageUri).path.replaceAll(RegExp(r'/+$'), '');
+  return pathname.endsWith('/assets') || pathname == '/assets'
+      ? assetLayoutContentAddressed
+      : assetLayoutLegacyFiles;
+}
+
+/// Convenience check: is the base URI using content-addressed layout?
+bool isContentAddressedAssetBaseStorageUri(String assetBaseStorageUri) {
+  return getAssetStorageLayout(assetBaseStorageUri) ==
+      assetLayoutContentAddressed;
+}
+
+/// Compute the storage path for a manifest asset, dispatching on layout.
+String getManifestAssetStoragePath({
+  required String assetBaseStorageUri,
+  required String assetPath,
+  required String fileHash,
+}) {
+  final layout = getAssetStorageLayout(assetBaseStorageUri);
+
+  if (layout == assetLayoutContentAddressed) {
+    return getContentAddressedAssetStoragePath(
+      assetPath: assetPath,
+      fileHash: fileHash,
+    );
+  }
+
+  return getLegacyManifestAssetStoragePath(assetPath: assetPath);
+}
+
+/// Build a full storage URI for a manifest asset.
+String resolveManifestAssetStorageUri({
+  required String assetBaseStorageUri,
+  required String assetPath,
+  required String fileHash,
+}) {
+  return createStorageUriWithRelativePath(
+    baseStorageUri: assetBaseStorageUri,
+    relativePath: getManifestAssetStoragePath(
+      assetBaseStorageUri: assetBaseStorageUri,
+      assetPath: assetPath,
+      fileHash: fileHash,
+    ),
+  );
+}

package/dart-src/plugins/plugin-core/lib/src/bundle_storage_layout.dart

@@ -0,0 +1,44 @@
+/// The top-level prefix for bundle storage keys.
+const String bundleStoragePrefix = 'bundles';
+
+/// Build a storage key for a bundle, e.g. `bundles/<bundleId>/patch.zip`.
+String createBundleStorageKey(String bundleId, [List<String> relativePaths = const []]) {
+  return [bundleStoragePrefix, bundleId, ...relativePaths]
+      .where((s) => s.isNotEmpty)
+      .join('/');
+}
+
+/// Replace the bundle-id segment in a storage URI with a relative path.
+///
+/// For example, given a storage URI containing `.../bundles/<bundleId>/patch.zip`
+/// and a [relativePath] of `files/manifest.json`, this returns a URI pointing
+/// to `.../files/manifest.json`.
+String createStorageRootUriWithPath(
+  String storageUri,
+  String bundleId,
+  String relativePath,
+) {
+  final storageUrl = Uri.parse(storageUri);
+  final segments = storageUrl.path.split('/').where((s) => s.isNotEmpty).toList();
+  final bundleIndex = segments.lastIndexOf(bundleId);
+  if (bundleIndex < 0) {
+    throw StateError(
+      'Storage URI does not contain bundle id: $bundleId',
+    );
+  }
+
+  final rootSegments = segments.sublist(0, bundleIndex);
+  if (rootSegments.isNotEmpty && rootSegments.last == bundleStoragePrefix) {
+    rootSegments.removeLast();
+  }
+
+  final relativeSegments = relativePath
+      .split('/')
+      .where((s) => s.isNotEmpty)
+      .map(Uri.encodeComponent)
+      .toList();
+
+  return storageUrl
+      .replace(path: '/${[...rootSegments, ...relativeSegments].join('/')}')
+      .toString();
+}