@_nazmiforreal/flutter-ota 0.1.0 → 0.1.2

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

@@ -0,0 +1,86 @@
+import 'dart:convert';
+import 'dart:io';
+import 'dart:math';
+
+import 'package:archive/archive.dart';
+import 'package:crypto/crypto.dart';
+import 'package:path/path.dart' as p;
+
+/// Hex-encoded SHA-256 of [bytes].
+String sha256Hex(List<int> bytes) => sha256.convert(bytes).toString();
+
+/// Zip [directory] into a temp file and return its path.
+///
+/// File paths inside the archive are relative to [directory], matching
+/// hot-updater's bundle layout.
+Future<String> zipDirectory(String directory) async {
+  final dir = Directory(directory);
+  if (!dir.existsSync()) {
+    throw StateError('Source directory does not exist: $directory');
+  }
+  final archive = Archive();
+  await for (final entity in dir.list(recursive: true)) {
+    if (entity is! File) continue;
+    final relative = p.relative(entity.path, from: dir.path);
+    final bytes = await entity.readAsBytes();
+    archive.addFile(ArchiveFile(relative, bytes.length, bytes));
+  }
+  if (archive.files.isEmpty) {
+    throw StateError('Source directory is empty: $directory');
+  }
+  final encoder = ZipEncoder();
+  final out = encoder.encode(archive);
+  final tmp = File('${Directory.systemTemp.path}/fp_${Random().nextInt(1 << 30)}.zip');
+  await tmp.writeAsBytes(out);
+  return tmp.path;
+}
+
+/// Compute a deterministic fingerprint hash for a directory (used at build time
+/// to stamp the app's runtime fingerprint).
+///
+/// The hash covers every file's relative path + content hash, sorted for
+/// stability, so identical trees always yield the same fingerprint.
+String generateFingerprint(String directory) {
+  final dir = Directory(directory);
+  if (!dir.existsSync()) {
+    throw StateError('Directory does not exist: $directory');
+  }
+  final entries = <String>[];
+  for (final entity in dir.listSync(recursive: true)) {
+    if (entity is! File) continue;
+    final relative = p.relative(entity.path, from: dir.path);
+    final content = File(entity.path).readAsBytesSync();
+    final hash = sha256Hex(content);
+    entries.add('$relative:$hash');
+  }
+  entries.sort();
+  return sha256Hex(utf8.encode(entries.join('\n')));
+}
+
+/// Best-effort git commit hash for a directory.
+Future<String?> gitCommitHash(String directory) async {
+  try {
+    final result = await Process.run(
+      'git',
+      ['rev-parse', 'HEAD'],
+      workingDirectory: directory,
+      runInShell: true,
+    );
+    if (result.exitCode == 0) {
+      return (result.stdout as String).trim();
+    }
+  } catch (_) {
+    // git unavailable — ignore.
+  }
+  return null;
+}
+
+/// Human readable byte size.
+String humanSize(int bytes) {
+  if (bytes < 1024) return '$bytes B';
+  final kb = bytes / 1024;
+  if (kb < 1024) return '${kb.toStringAsFixed(1)} KB';
+  final mb = kb / 1024;
+  if (mb < 1024) return '${mb.toStringAsFixed(1)} MB';
+  return '${(mb / 1024).toStringAsFixed(2)} GB';
+}

package/dart-src/packages/cli-tools/migrations/cloudflare/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/packages/cli-tools/migrations/cloudflare/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/packages/cli-tools/migrations/cloudflare/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/packages/cli-tools/migrations/cloudflare/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/packages/cli-tools/migrations/cloudflare/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/packages/cli-tools/migrations/cloudflare/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/packages/cli-tools/migrations/supabase/20250103114225_init.sql

@@ -0,0 +1,228 @@
+-- HotUpdater.bundles
+
+CREATE TYPE platforms AS ENUM ('ios', 'android');
+
+CREATE TABLE bundles (
+    id uuid PRIMARY KEY,
+    platform platforms NOT NULL,
+    target_app_version text NOT NULL,
+    should_force_update boolean NOT NULL,
+    enabled boolean NOT NULL,
+    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);
+
+
+-- HotUpdater.get_update_info
+
+CREATE OR REPLACE FUNCTION get_update_info (
+    app_platform   platforms,
+    app_version text,
+    bundle_id  uuid
+)
+RETURNS TABLE (
+    id            uuid,
+    should_force_update  boolean,
+    file_url      text,
+    file_hash     text,
+    status        text
+)
+LANGUAGE plpgsql
+AS
+$$
+DECLARE
+    NIL_UUID CONSTANT uuid := '00000000-0000-0000-0000-000000000000';
+BEGIN
+    RETURN QUERY
+    WITH rollback_candidate AS (
+        SELECT
+            b.id,
+            -- If status is 'ROLLBACK', should_force_update is always TRUE
+            TRUE AS should_force_update,
+            b.file_url,
+            b.file_hash,
+            'ROLLBACK' AS status
+        FROM bundles b
+        WHERE b.enabled = TRUE
+          AND b.platform = app_platform
+          AND b.id < bundle_id
+        ORDER BY b.id DESC
+        LIMIT 1
+    ),
+    update_candidate AS (
+        SELECT
+            b.id,
+            b.should_force_update,
+            b.file_url,
+            b.file_hash,
+            'UPDATE' AS status
+        FROM bundles b
+        WHERE b.enabled = TRUE
+          AND b.platform = app_platform
+          AND b.id >= bundle_id
+          AND semver_satisfies(b.target_app_version, app_version)
+        ORDER BY b.id DESC
+        LIMIT 1
+    ),
+    final_result AS (
+        SELECT *
+        FROM update_candidate
+
+        UNION ALL
+
+        SELECT *
+        FROM rollback_candidate
+        WHERE NOT EXISTS (SELECT 1 FROM update_candidate)
+    )
+    SELECT *
+    FROM final_result WHERE final_result.id != bundle_id
+
+    UNION ALL
+    /*
+      When there are no final results and bundle_id != NIL_UUID,
+      add one fallback row.
+      This fallback row is also ROLLBACK so shouldForceUpdate = TRUE.
+    */
+    SELECT
+        NIL_UUID      AS id,
+        TRUE          AS should_force_update,  -- Always TRUE
+        NULL          AS file_url,
+        NULL          AS file_hash,
+        'ROLLBACK'    AS status
+    WHERE (SELECT COUNT(*) FROM final_result) = 0
+      AND bundle_id != NIL_UUID;
+
+END;
+$$;
+
+-- HotUpdater.semver_satisfies
+
+CREATE OR REPLACE FUNCTION semver_satisfies(range_expression TEXT, version TEXT)
+RETURNS BOOLEAN AS $$
+DECLARE
+    version_parts TEXT[];
+    version_major INT;
+    version_minor INT;
+    version_patch INT;
+    satisfies BOOLEAN := FALSE;
+BEGIN
+    -- Split the version into major, minor, and patch
+    version_parts := string_to_array(version, '.');
+    version_major := version_parts[1]::INT;
+    version_minor := version_parts[2]::INT;
+    version_patch := version_parts[3]::INT;
+
+    -- Parse range expression and evaluate
+    IF range_expression ~ '^\d+\.\d+\.\d+$' THEN
+        -- Exact match
+        satisfies := (range_expression = version);
+
+    ELSIF range_expression = '*' THEN
+        -- Matches any version
+        satisfies := TRUE;
+
+    ELSIF range_expression ~ '^\d+\.x\.x$' THEN
+        -- Matches major.x.x
+        DECLARE
+            major_range INT := split_part(range_expression, '.', 1)::INT;
+        BEGIN
+            satisfies := (version_major = major_range);
+        END;
+
+    ELSIF range_expression ~ '^\d+\.\d+\.x$' THEN
+        -- Matches major.minor.x
+        DECLARE
+            major_range INT := split_part(range_expression, '.', 1)::INT;
+            minor_range INT := split_part(range_expression, '.', 2)::INT;
+        BEGIN
+            satisfies := (version_major = major_range AND version_minor = minor_range);
+        END;
+
+    ELSIF range_expression ~ '^\d+\.\d+$' THEN
+        -- Matches major.minor
+        DECLARE
+            major_range INT := split_part(range_expression, '.', 1)::INT;
+            minor_range INT := split_part(range_expression, '.', 2)::INT;
+        BEGIN
+            satisfies := (version_major = major_range AND version_minor = minor_range);
+        END;
+
+    ELSIF range_expression ~ '^\d+\.\d+\.\d+ - \d+\.\d+\.\d+$' THEN
+        -- Matches range e.g., 1.2.3 - 1.2.7
+        DECLARE
+            lower_bound TEXT := split_part(range_expression, ' - ', 1);
+            upper_bound TEXT := split_part(range_expression, ' - ', 2);
+        BEGIN
+            satisfies := (version >= lower_bound AND version <= upper_bound);
+        END;
+
+    ELSIF range_expression ~ '^>=\d+\.\d+\.\d+ <\d+\.\d+\.\d+$' THEN
+        -- Matches range with inequalities
+        DECLARE
+            lower_bound TEXT := regexp_replace(range_expression, '>=([\d\.]+) <.*', '\1');
+            upper_bound TEXT := regexp_replace(range_expression, '.*<([\d\.]+)', '\1');
+        BEGIN
+            satisfies := (version >= lower_bound AND version < upper_bound);
+        END;
+
+    ELSIF range_expression ~ '^~\d+\.\d+\.\d+$' THEN
+        -- Matches ~1.2.3 (>=1.2.3 <1.3.0)
+        DECLARE
+            lower_bound TEXT := regexp_replace(range_expression, '~', '');
+            upper_bound_major INT := split_part(lower_bound, '.', 1)::INT;
+            upper_bound_minor INT := split_part(lower_bound, '.', 2)::INT + 1;
+            upper_bound TEXT := upper_bound_major || '.' || upper_bound_minor || '.0';
+        BEGIN
+            satisfies := (version >= lower_bound AND version < upper_bound);
+        END;
+
+    ELSIF range_expression ~ '^\^\d+\.\d+\.\d+$' THEN
+        -- Matches ^1.2.3 (>=1.2.3 <2.0.0)
+        DECLARE
+            lower_bound TEXT := regexp_replace(range_expression, '\^', '');
+            upper_bound_major INT := split_part(lower_bound, '.', 1)::INT + 1;
+            upper_bound TEXT := upper_bound_major || '.0.0';
+        BEGIN
+            satisfies := (version >= lower_bound AND version < upper_bound);
+        END;
+
+    -- [Added] 1) Single major version pattern '^(\d+)$'
+    ELSIF range_expression ~ '^\d+$' THEN
+        /*
+            e.g.) "1" is interpreted as (>=1.0.0 <2.0.0) in semver range
+                  "2" would be interpreted as (>=2.0.0 <3.0.0)
+         */
+        DECLARE
+            major_range INT := range_expression::INT;
+            lower_bound TEXT := major_range || '.0.0';
+            upper_bound TEXT := (major_range + 1) || '.0.0';
+        BEGIN
+            satisfies := (version >= lower_bound AND version < upper_bound);
+        END;
+
+    -- [Added] 2) major.x pattern '^(\d+)\.x$'
+    ELSIF range_expression ~ '^\d+\.x$' THEN
+        /*
+            e.g.) "2.x" => as long as major=2 matches, any minor and patch is OK
+                  effectively works like (>=2.0.0 <3.0.0)
+         */
+        DECLARE
+            major_range INT := split_part(range_expression, '.', 1)::INT;
+            lower_bound TEXT := major_range || '.0.0';
+            upper_bound TEXT := (major_range + 1) || '.0.0';
+        BEGIN
+            satisfies := (version >= lower_bound AND version < upper_bound);
+        END;
+
+    ELSE
+        RAISE EXCEPTION 'Unsupported range expression: %', range_expression;
+    END IF;
+
+    RETURN satisfies;
+END;
+$$ LANGUAGE plpgsql;
+

package/dart-src/packages/cli-tools/migrations/supabase/20250314000000_hot-updater_0.13.0.sql

@@ -0,0 +1,134 @@
+-- HotUpdater.semver_satisfies
+DROP FUNCTION IF EXISTS semver_satisfies;
+
+-- HotUpdater.get_update_info
+DROP FUNCTION IF EXISTS get_update_info;
+
+-- HotUpdater.get_update_info
+CREATE OR REPLACE FUNCTION get_update_info (
+    app_platform   platforms,
+    app_version text,
+    bundle_id  uuid,
+    min_bundle_id uuid,
+    target_channel text,
+    target_app_version_list text[]
+)
+RETURNS TABLE (
+    id            uuid,
+    should_force_update  boolean,
+    message       text,
+    status        text
+)
+LANGUAGE plpgsql
+AS
+$$
+DECLARE
+    NIL_UUID CONSTANT uuid := '00000000-0000-0000-0000-000000000000';
+BEGIN
+    RETURN QUERY
+    WITH update_candidate AS (
+        SELECT
+            b.id,
+            b.should_force_update,
+            b.message,
+            'UPDATE' AS status
+        FROM bundles b
+        WHERE b.enabled = TRUE
+          AND b.platform = app_platform
+          AND b.id >= bundle_id
+          AND b.id > min_bundle_id
+          AND b.target_app_version IN (SELECT unnest(target_app_version_list))
+          AND b.channel = target_channel
+        ORDER BY b.id DESC
+        LIMIT 1
+    ),
+    rollback_candidate AS (
+        SELECT
+            b.id,
+            TRUE AS should_force_update,
+            b.message,
+            'ROLLBACK' AS status
+        FROM bundles b
+        WHERE b.enabled = TRUE
+          AND b.platform = app_platform
+          AND b.id < bundle_id
+          AND b.id > min_bundle_id
+        ORDER BY b.id DESC
+        LIMIT 1
+    ),
+    final_result AS (
+        SELECT * FROM update_candidate
+        UNION ALL
+        SELECT * FROM rollback_candidate
+        WHERE NOT EXISTS (SELECT 1 FROM update_candidate)
+    )
+    SELECT *
+    FROM final_result
+    WHERE final_result.id != bundle_id
+
+    UNION ALL
+
+    SELECT
+        NIL_UUID      AS id,
+        TRUE          AS should_force_update,
+        NULL          AS message,
+        'ROLLBACK'    AS status
+    WHERE (SELECT COUNT(*) FROM final_result) = 0
+      AND bundle_id != NIL_UUID
+      AND bundle_id > min_bundle_id
+      AND NOT EXISTS (
+          SELECT 1
+          FROM bundles b
+          WHERE b.id = bundle_id
+            AND b.enabled = TRUE
+            AND b.platform = app_platform
+      );
+END;
+$$;
+
+-- HotUpdater.bundles
+ALTER TABLE bundles
+ADD COLUMN channel text NOT NULL DEFAULT 'production';
+
+ALTER TABLE bundles
+DROP COLUMN file_url;
+
+-- HotUpdater.get_target_app_version_list
+
+CREATE OR REPLACE FUNCTION get_target_app_version_list (
+    app_platform platforms,
+    min_bundle_id uuid
+)
+RETURNS TABLE (
+    target_app_version text
+)
+LANGUAGE plpgsql
+AS
+$$
+BEGIN
+    RETURN QUERY
+    SELECT b.target_app_version
+    FROM bundles b 
+    WHERE b.platform = app_platform
+    AND b.id >= min_bundle_id
+    GROUP BY b.target_app_version;
+END;
+$$;
+
+-- HotUpdater.get_channels
+CREATE OR REPLACE FUNCTION get_channels ()
+RETURNS TABLE (
+    channel text
+)
+LANGUAGE plpgsql
+AS
+$$
+BEGIN
+    RETURN QUERY
+    SELECT b.channel
+    FROM bundles b 
+    GROUP BY b.channel;
+END;
+$$;
+
+CREATE INDEX bundles_channel_idx ON bundles(channel);