@_nazmiforreal/flutter-ota 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# flutter-patcher (flutter-ota CLI)
+
+Command-line interface for [flutter_patcher](https://github.com/HYPER12755/flutter_patcher) — a self-hosted OTA ("code push") platform for Flutter Android, hot-updater compatible.
+
+## Install
+
+```bash
+npm i -g @_nazmiforreal/flutter-ota
+```
+
+This installs the `flutter-patcher` command. A prebuilt Linux binary ships with the package; on other platforms it falls back to `dart compile exe` (requires the [Dart SDK](https://dart.dev)).
+
+## Usage
+
+```bash
+flutter-patcher --help
+flutter-patcher keys                                              # generate an Ed25519 keypair
+flutter-patcher build -a app-release.apk \
+  --version 1.0.0 --target-version-code 1                        # -> dist/patch.zip (all ABIs)
+flutter-patcher deploy --source dist \
+  --channel production --backend standalone \
+  --key <PRIVATE_KEY_BASE64>                                      # upload + sign a bundle
+```
+
+### Backends
+
+`--backend supabase|postgres|cloudflare|aws|standalone` (or `FLUTTER_PATCHER_BACKEND`).
+Each resolves its own env / `.flutter_patcher.json` config.
+
+### Commands
+
+`init`, `build`, `deploy`, `bundle` (list/delete/promote), `rollback`, `channel`
+(get/set/list), `fingerprint`, `doctor`, `migrate`, `config`, `keys`, `console`,
+`patch`, `mock_server`.
+
+## License
+
+MIT

package/bin/flutter-patcher.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+'use strict';
+
+// Launcher for the flutter_patcher CLI.
+//
+// Resolves the prebuilt Dart binary shipped next to this script (platform
+// specific), falling back to `dart run` when Dart is available and no binary
+// is present. This lets `npm i -g flutter-patcher` work on any machine that
+// either ships a prebuilt binary or has the Dart SDK installed.
+
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const platform =
+  process.platform === 'win32'
+    ? 'windows'
+    : process.platform === 'darwin'
+    ? 'macos'
+    : 'linux';
+const ext = process.platform === 'win32' ? '.exe' : '';
+const binDir = __dirname;
+const binName = `flutter-patcher-${platform}${ext}`;
+const binPath = path.join(binDir, binName);
+
+function run(bin, args) {
+  const res = spawnSync(bin, args, { stdio: 'inherit', windowsHide: false });
+  process.exit(res.status == null ? 1 : res.status);
+}
+
+if (fs.existsSync(binPath)) {
+  run(binPath, process.argv.slice(2));
+  return;
+}
+
+// Fallback: run from source via the Dart SDK (works when this npm package is
+// installed from the monorepo, since the Dart package lives at
+// ../../packages/cli-tools/bin/flutter_patcher.dart).
+const repoEntry = path.join(
+  binDir,
+  '..',
+  '..',
+  '..',
+  'packages',
+  'cli-tools',
+  'bin',
+  'flutter-patcher.dart',
+);
+const dartCheck = spawnSync('dart', ['--version'], { stdio: 'ignore' });
+if (dartCheck.status === 0 && fs.existsSync(repoEntry)) {
+  run('dart', [repoEntry, ...process.argv.slice(2)]);
+  return;
+}
+
+console.error(
+  'flutter-patcher: no prebuilt binary for this platform and Dart SDK not ' +
+    'found. Install Dart (https://dart.dev) or ship a prebuilt binary.',
+);
+process.exit(1);

package/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/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);

package/migrations/supabase/20250516000000_hot-updater_0.18.0.sql

@@ -0,0 +1,194 @@
+
+ALTER TABLE bundles ADD COLUMN IF NOT EXISTS fingerprint_hash text;
+ALTER TABLE bundles ADD COLUMN IF NOT EXISTS metadata JSONB DEFAULT '{}'::jsonb;
+
+ALTER TABLE bundles ADD COLUMN IF NOT EXISTS storage_uri TEXT;
+
+UPDATE bundles
+SET storage_uri = 'supabase-storage://%%BUCKET_NAME%%/' || id || '/bundle.zip'
+WHERE storage_uri IS NULL;
+
+ALTER TABLE bundles ALTER COLUMN storage_uri SET NOT NULL;
+ALTER TABLE bundles ALTER COLUMN target_app_version DROP NOT NULL;
+
+ALTER TABLE bundles ADD CONSTRAINT check_version_or_fingerprint CHECK (
+    (target_app_version IS NOT NULL) OR (fingerprint_hash IS NOT NULL)
+);
+
+CREATE INDEX bundles_fingerprint_hash_idx ON bundles(fingerprint_hash);
+
+DROP FUNCTION IF EXISTS get_update_info;
+
+-- HotUpdater.get_update_info
+CREATE OR REPLACE FUNCTION get_update_info_by_fingerprint_hash (
+    app_platform   platforms,
+    bundle_id  uuid,
+    min_bundle_id uuid,
+    target_channel text,
+    target_fingerprint_hash text
+)
+RETURNS TABLE (
+    id            uuid,
+    should_force_update  boolean,
+    message       text,
+    status        text,
+    storage_uri   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,
+            b.storage_uri
+        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.channel = target_channel
+          AND b.fingerprint_hash = target_fingerprint_hash
+        ORDER BY b.id DESC
+        LIMIT 1
+    ),
+    rollback_candidate AS (
+        SELECT
+            b.id,
+            TRUE AS should_force_update,
+            b.message,
+            'ROLLBACK' AS status,
+            b.storage_uri
+        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.channel = target_channel
+          AND b.fingerprint_hash = target_fingerprint_hash
+        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,
+        NULL          AS storage_uri
+    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.get_update_info
+CREATE OR REPLACE FUNCTION get_update_info_by_app_version (
+    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,
+    storage_uri   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,
+            b.storage_uri
+        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,
+            b.storage_uri
+        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,
+        NULL          AS storage_uri
+    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;
+$$;