@_nazmiforreal/flutter-ota 0.1.26 → 0.1.28

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

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

@@ -1,62 +0,0 @@
-// 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/pubspec.yaml

@@ -1,26 +0,0 @@
-name: flutter_ota_kit_pocketbase
-description: PocketBase plugin for flutter_ota_kit — local-first self-hostable backend with admin UI, auth, file storage, and realtime.
-version: 0.1.7
-homepage: https://github.com/HYPER12755/flutter-ota-kit
-repository: https://github.com/HYPER12755/flutter-ota-kit
-issue_tracker: https://github.com/HYPER12755/flutter-ota-kit/issues
-documentation: https://github.com/HYPER12755/flutter-ota-kit#readme
-license: MIT
-
-environment:
-  sdk: ">=3.13.2 <4.0.0"
-
-dependencies:
-  flutter_ota_kit_core: ^0.1.8
-  flutter_ota_kit_plugin_core: ^0.0.10
-  http: ^1.2.0
-
-dev_dependencies:
-  test: ^1.25.0
-  lints: ^4.0.0
-
-dependency_overrides:
-  flutter_ota_kit_core:
-    path: ../../packages/core
-  flutter_ota_kit_plugin_core:
-    path: ../plugin-core

package/dart-src/plugins/pocketbase/test/pb_uri_test.dart

@@ -1,12 +0,0 @@
-import 'package:flutter_ota_kit_pocketbase/flutter_ota_kit_pocketbase.dart';
-import 'package:test/test.dart';
-
-void main() {
-  test('buildPocketBaseStorageUri with no bucket parses back', () {
-    final uri = buildPocketBaseStorageUri('abc', 'file.zip');
-    final parsed = parsePocketBaseStorageUri(uri);
-    expect(parsed, isNotNull);
-    expect(parsed!.recordId, 'abc');
-    expect(parsed.filename, 'file.zip');
-  });
-}

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

@@ -1,23 +0,0 @@
-## 0.1.10
-
-- Release 2026-09-10
-
-## 0.1.9
-
-- Release 2026-09-10
-
-## 0.1.9
-
-- Automated release 2026-09-10
-
-## 0.1.8
-
-- Added comprehensive documentation for all public APIs.
-- Improved bundle mapper and database plugin documentation.
-- General maintenance.
-
-## 0.1.7
-
-- General maintenance.
-
-## 0.1.6

package/dart-src/plugins/postgres/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 HYPER12755
-
-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/postgres/README.md

@@ -1,29 +0,0 @@
-# flutter_ota_kit_postgres
-
-Postgres backend for flutter_ota_kit: bundle metadata in a Postgres database and
-artifacts in the bytea-backed storage plugin. Used by the `flutter-ota` CLI and
-the Flutter SDK's `FlutterPatcher.configurePostgres(...)`.
-
-## What's inside
-
-- `postgresDatabase` / `PostgresConfig` — bundle read/write over a Postgres
-  connection.
-- `postgresStorage` / `PostgresStorageConfig` / `resolvePostgresStorageClient` —
-  artifact storage.
-- `getUpdateInfo` — resolve the latest applicable bundle for a device.
-- Row mappers (`PostgresBundleRow`, `PostgresBundlePatchRow`,
-  `bundleToRowValues`, `bundleToPatchRows`) for the `bundles` / `bundle_patches`
-  tables.
-
-## Configuration (environment)
-
-| Variable | Purpose |
-| --- | --- |
-| `DATABASE_URL` | Full Postgres connection string (preferred). |
-| `POSTGRES_HOST` / `POSTGRES_PORT` / `POSTGRES_DB` / `POSTGRES_USER` / `POSTGRES_PASSWORD` / `POSTGRES_SSLMODE` | Individual connection fields. |
-| `POSTGRES_SERVING_BASE_URL` | HTTP proxy/base URL in front of the storage table for artifact downloads. |
-| `POSTGRES_BASE_PATH` | Optional object-key prefix. |
-
-## License
-
-MIT.

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

@@ -1,67 +0,0 @@
-// flutter_ota_kit_postgres example
-//
-// `flutter_ota_kit_postgres` is a Postgres backend for `flutter_ota_kit`.
-// It provides a `postgresDatabase` factory and a `postgresStorage`
-// factory that talk to a vanilla Postgres database (no Supabase, no
-// Cloudflare — just `pg`).
-//
-// Most apps don't import this package directly; they wire it through
-// `flutter_ota_kit.configurePostgres(...)` in their app boot path. This
-// file shows the low-level config types in case you're writing a custom
-// server, a migration script, or a CLI extension.
-//
-// Run: `dart run example/main.dart`
-
-import 'package:flutter_ota_kit_postgres/flutter_ota_kit_postgres.dart';
-import 'package:flutter_ota_kit_core/flutter_ota_kit_core.dart';
-
-void main() {
-  // ── 1. Database config (vanilla Postgres connection). ─────────────
-  // `PostgresConfig` is a thin wrapper around the `postgres` package
-  // connection parameters. The `host`/`port`/`database` triple is the
-  // canonical form; username/password are required for non-trust auth.
-  const dbConfig = PostgresConfig(
-    host: 'db.example.com',
-    port: 5432,
-    database: 'ota',
-    username: 'ota',
-    password: 'secret',
-  );
-  print('Postgres: ${dbConfig.host}:${dbConfig.port}/${dbConfig.database}');
-
-  // ── 2. Storage config (for storing patch blobs). ──────────────────
-  // The `servingBaseUrl` is the public-facing URL that the device SDK
-  // can use to download patches. Omit it only if you proxy the
-  // download through your own update-check endpoint.
-  const storageConfig = PostgresStorageConfig(
-    db: dbConfig,
-    servingBaseUrl: 'https://cdn.example.com/flutter-ota',
-  );
-  print('Serving base URL: ${storageConfig.servingBaseUrl}');
-
-  // ── 3. Row-to-Bundle mapping (server-side helper). ────────────────
-  // Use this when reading bundles from a custom query and passing them
-  // to the SDK's `PatchInfo.fromJson`. The mapper handles both
-  // camelCase and snake_case column names.
-  const row = PostgresBundleRow(
-    id: '01a059a6-7d3c-4f3e-8a2c-9c2e3a4b5d6e',
-    channel: 'production',
-    enabled: true,
-    shouldForceUpdate: false,
-    fileHash: '7c4a8d09ca3762af61e59520943dc26494f8941b',
-    platform: Platform.android,
-    storageUri:
-        'postgres-blob://flutter-ota-bundles/'
-        '01a059a6/patch.zip',
-    targetAppVersion: '1.0.0',
-    rolloutCohortCount: 100,
-  );
-  final bundle = mapRowToBundle(row);
-  print('Mapped bundle: ${bundle.id} (${bundle.storageUri})');
-
-  // ── 4. Bundle → SQL values (for inserts/updates). ────────────────
-  // Returns snake_case column→value maps ready to feed to a `pg` query.
-  final values = bundleToRowValues(bundle);
-  print('SQL column count: ${values.length}');
-  print('  file_hash = ${values['file_hash']}');
-}

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

@@ -1,26 +0,0 @@
-name: flutter_ota_kit_postgres
-description: Postgres plugin for flutter_ota_kit — database backend.
-version: 0.1.10
-homepage: https://github.com/HYPER12755/flutter-ota-kit
-repository: https://github.com/HYPER12755/flutter-ota-kit
-issue_tracker: https://github.com/HYPER12755/flutter-ota-kit/issues
-documentation: https://github.com/HYPER12755/flutter-ota-kit#readme
-license: MIT
-
-environment:
-  sdk: ">=3.13.2 <4.0.0"
-
-dependencies:
-  flutter_ota_kit_core: ^0.1.8
-  flutter_ota_kit_plugin_core: ^0.0.10
-  postgres: ^3.4.0
-
-dev_dependencies:
-  test: ^1.25.0
-  lints: ^4.0.0
-
-dependency_overrides:
-  flutter_ota_kit_core:
-    path: ../../packages/core
-  flutter_ota_kit_plugin_core:
-    path: ../plugin-core

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

@@ -1,45 +0,0 @@
--- HotUpdater.bundles
-
-CREATE TYPE platforms AS ENUM ('ios', 'android');
-
-CREATE TABLE bundles (
-    id uuid PRIMARY KEY,
-    platform platforms NOT NULL,
-    should_force_update boolean NOT NULL,
-    enabled boolean 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,
-    CONSTRAINT check_version_or_fingerprint CHECK (
-        (target_app_version IS NOT NULL) OR (fingerprint_hash IS NOT NULL)
-    ),
-    metadata jsonb DEFAULT '{}'::jsonb,
-    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[]
-);
-
-CREATE TABLE bundle_patches (
-    id text PRIMARY KEY,
-    bundle_id uuid NOT NULL REFERENCES bundles(id) ON DELETE CASCADE,
-    base_bundle_id uuid NOT NULL REFERENCES bundles(id) ON DELETE CASCADE,
-    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
-);
-
-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 bundles_target_cohorts_idx ON bundles USING GIN (target_cohorts);
-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/postgres/sql/get_target_app_version_list.sql

@@ -1,21 +0,0 @@
--- 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;
-$$;

package/dart-src/plugins/postgres/sql/get_update_info.spec.ts

@@ -1,171 +0,0 @@
-import { PGlite } from "@electric-sql/pglite";
-import {
-  type Bundle,
-  type GetBundlesArgs,
-  NIL_UUID,
-  type UpdateInfo,
-} from "@hot-updater/core";
-import { filterCompatibleAppVersions } from "@hot-updater/js";
-import { setupGetUpdateInfoTestSuite } from "@hot-updater/test-utils";
-import camelcaseKeys from "camelcase-keys";
-import { afterAll, beforeEach, describe } from "vitest";
-
-import { prepareSql } from "./prepareSql";
-
-const createInsertBundleQuery = (bundle: Bundle) => {
-  const rolloutCohortCount = bundle.rolloutCohortCount ?? 1000;
-  const targetCohorts = bundle.targetCohorts
-    ? `ARRAY[${bundle.targetCohorts.map((id) => `'${id}'`).join(",")}]::TEXT[]`
-    : "NULL";
-
-  return `
-    INSERT INTO bundles (
-      id, file_hash, platform, target_app_version,
-      should_force_update, enabled, git_commit_hash, message, channel, storage_uri, fingerprint_hash,
-      rollout_cohort_count, target_cohorts
-    ) VALUES (
-      '${bundle.id}',
-      '${bundle.fileHash}',
-      '${bundle.platform}',
-      ${bundle.targetAppVersion ? `'${bundle.targetAppVersion}'` : "null"},
-      ${bundle.shouldForceUpdate},
-      ${bundle.enabled},
-      ${bundle.gitCommitHash ? `'${bundle.gitCommitHash}'` : "null"},
-      ${bundle.message ? `'${bundle.message}'` : "null"},
-      '${bundle.channel}',
-      '${bundle.storageUri}',
-      ${bundle.fingerprintHash ? `'${bundle.fingerprintHash}'` : "null"},
-      ${rolloutCohortCount},
-      ${targetCohorts}
-    ) ON CONFLICT (id) DO UPDATE SET
-      file_hash = EXCLUDED.file_hash,
-      platform = EXCLUDED.platform,
-      target_app_version = EXCLUDED.target_app_version,
-      should_force_update = EXCLUDED.should_force_update,
-      enabled = EXCLUDED.enabled,
-      git_commit_hash = EXCLUDED.git_commit_hash,
-      message = EXCLUDED.message,
-      channel = EXCLUDED.channel,
-      storage_uri = EXCLUDED.storage_uri,
-      fingerprint_hash = EXCLUDED.fingerprint_hash,
-      rollout_cohort_count = EXCLUDED.rollout_cohort_count,
-      target_cohorts = EXCLUDED.target_cohorts;
-  `;
-};
-
-const createGetUpdateInfo =
-  (db: PGlite) =>
-  async (
-    bundles: Bundle[],
-    args: GetBundlesArgs,
-  ): Promise<UpdateInfo | null> => {
-    const {
-      bundleId,
-      platform,
-      minBundleId = NIL_UUID,
-      channel = "production",
-      _updateStrategy,
-    } = args;
-    await db.exec(createInsertBundleQuerys(bundles));
-
-    if (_updateStrategy === "fingerprint") {
-      const fingerprintHash = args.fingerprintHash;
-      const cohort = args.cohort;
-      const cohortSql = cohort ? `'${cohort}'` : "NULL";
-      const result = await db.query<{
-        id: string;
-        should_force_update: boolean;
-        message: string;
-        status: string;
-        storage_uri: string | null;
-        file_hash: string | null;
-      }>(
-        `
-      SELECT * FROM get_update_info_by_fingerprint_hash(
-        '${platform}',
-        '${bundleId}',
-        '${minBundleId}',
-        '${channel}',
-        '${fingerprintHash}',
-        ${cohortSql}
-      );
-      `,
-      );
-
-      if (!result.rows[0]) {
-        return null;
-      }
-
-      const row = result.rows[0];
-      return camelcaseKeys(row) as UpdateInfo;
-    }
-
-    const appVersion = args.appVersion;
-    const { rows: appVersionList } = await db.query<{
-      target_app_version: string;
-    }>(
-      `
-      SELECT target_app_version FROM get_target_app_version_list('${platform}', '${minBundleId}');
-      `,
-    );
-
-    const targetAppVersionList = filterCompatibleAppVersions(
-      appVersionList?.map((group) => group.target_app_version) ?? [],
-      appVersion,
-    );
-
-    const cohort = args.cohort;
-    const cohortSql = cohort ? `'${cohort}'` : "NULL";
-    const result = await db.query<{
-      id: string;
-      should_force_update: boolean;
-      message: string;
-      status: string;
-      storage_uri: string | null;
-      file_hash: string | null;
-    }>(
-      `
-      SELECT * FROM get_update_info_by_app_version(
-        '${platform}',
-        '${appVersion}',
-        '${bundleId}',
-        '${minBundleId ?? NIL_UUID}',
-        '${channel}',
-        ARRAY[${targetAppVersionList.map((v) => `'${v}'`).join(",")}]::text[],
-        ${cohortSql}
-      );
-      `,
-    );
-
-    if (!result.rows[0]) {
-      return null;
-    }
-
-    const row = result.rows[0];
-    return camelcaseKeys(row) as UpdateInfo;
-  };
-
-const createInsertBundleQuerys = (bundles: Bundle[]) => {
-  return bundles.map(createInsertBundleQuery).join("\n");
-};
-
-const db = new PGlite();
-
-const sql = await prepareSql();
-await db.exec(sql);
-const getUpdateInfo = createGetUpdateInfo(db);
-
-describe("getUpdateInfo", () => {
-  beforeEach(async () => {
-    await db.exec("DELETE FROM bundle_patches");
-    await db.exec("DELETE FROM bundles");
-  });
-
-  afterAll(async () => {
-    await db.close();
-  });
-
-  setupGetUpdateInfoTestSuite({
-    getUpdateInfo: getUpdateInfo,
-  });
-});