@_nazmiforreal/flutter-ota 0.1.26 → 0.1.27

package/dart-src/plugins/cloudflare/test/r2_storage_test.dart

@@ -1,74 +0,0 @@
-import 'dart:io' show Directory, File;
-
-import 'package:flutter_ota_kit_cloudflare/flutter_ota_kit_cloudflare.dart'
-    show r2Storage;
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart'
-    show StoragePlugin;
-import 'package:path/path.dart' show basename;
-import 'package:test/test.dart';
-
-import 'mock_r2_client.dart' show Store, mockR2Config;
-
-void main() {
-  group('cloudflare r2Storage', () {
-    late Store store;
-    late StoragePlugin plugin;
-    late String tmpFile;
-    late String outFile;
-
-    setUp(() {
-      store = Store();
-      plugin = r2Storage(mockR2Config(store));
-      final dir = Directory.systemTemp.createTempSync('fp_r2_').path;
-      tmpFile = '$dir/bundle.zip';
-      File(tmpFile).writeAsBytesSync([1, 2, 3, 4]);
-      outFile = '$dir/out.zip';
-    });
-
-    test('plugin metadata', () {
-      expect(plugin.name, 'r2Storage');
-      expect(plugin.supportedProtocol, 'r2');
-      expect(plugin.profiles.hasNode, isTrue);
-      expect(plugin.profiles.hasRuntime, isTrue);
-    });
-
-    test('node upload + exists + downloadFile + delete', () async {
-      final node = plugin.profiles.node!;
-      final res = await node.upload('v1', tmpFile);
-      expect(res['storageUri'], 'r2://test-bucket/v1/${basename(tmpFile)}');
-      expect(await node.exists(res['storageUri']!), isTrue);
-
-      await node.downloadFile(res['storageUri']!, outFile);
-      expect(File(outFile).readAsBytesSync(), [1, 2, 3, 4]);
-
-      await node.delete(res['storageUri']!);
-      expect(await node.exists(res['storageUri']!), isFalse);
-    });
-
-    test('runtime getDownloadUrl + readText (and missing → null)', () async {
-      final node = plugin.profiles.node!;
-      final runtime = plugin.profiles.runtime!;
-
-      final manifest = '${Directory.systemTemp.path}/fp_manifest.json';
-      File(manifest).writeAsStringSync('{"hello":1}');
-      final uploaded = await node.upload('manifests', manifest);
-
-      final url = await runtime.getDownloadUrl(uploaded['storageUri']!);
-      expect(url['fileUrl'], contains('manifests/'));
-
-      final text = await runtime.readText(uploaded['storageUri']!);
-      expect(text, '{"hello":1}');
-
-      expect(await runtime.readText('r2://test-bucket/missing'), isNull);
-    });
-
-    test('listObjects filters by prefix', () async {
-      final node = plugin.profiles.node!;
-      await node.upload('a', tmpFile);
-      await node.upload('b', tmpFile);
-
-      expect(await node.listObjects(), hasLength(2));
-      expect(await node.listObjects('a/'), hasLength(1));
-    });
-  });
-}

package/dart-src/plugins/plugin-core/CHANGELOG.md

@@ -1,20 +0,0 @@
-## 0.0.10
-
-- Release 2026-09-10
-
-## 0.0.10
-
-- Automated release 2026-09-10
-
-## 0.0.9
-
-- Added comprehensive documentation for all public APIs.
-- Documented `DatabasePlugin`, `StoragePlugin`, `BuildPlugin` interfaces.
-- Documented `HotUpdaterContext` and `StorageResolveContext` schemas.
-- Documented storage URI protocol schemes.
-
-## 0.0.8
-
-- General maintenance.
-
-## 0.0.7

package/dart-src/plugins/plugin-core/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/plugin-core/README.md

@@ -1,21 +0,0 @@
-# flutter_ota_kit_plugin_core
-
-Internal plugin abstractions shared by the flutter_ota_kit backend plugins
-(`flutter_ota_kit_supabase`, `flutter_ota_kit_postgres`,
-`flutter_ota_kit_cloudflare`, `flutter_ota_kit_aws`).
-
-## What's inside
-
-- The `Database`, `Storage`, and build interfaces that each backend implements.
-- Factory helpers: `createDatabasePlugin`, `createStoragePlugin`,
-  `createBlobDatabasePlugin`.
-- Pagination, content-addressed asset addressing, and storage/bundle layout
-  helpers used to keep all backends wire-compatible with the same bundle schema.
-
-This package is a building block for the concrete backends and the `flutter-ota`
-CLI; application code normally consumes the higher-level `flutter_ota_kit` API
-instead.
-
-## License
-
-MIT.

package/dart-src/plugins/plugin-core/example/lib/main.dart

@@ -1,61 +0,0 @@
-// flutter_ota_kit_plugin_core example
-//
-// `flutter_ota_kit_plugin_core` provides the shared abstractions that
-// every backend plugin is built on top of: `DatabasePlugin`,
-// `StoragePlugin`, `Bundle` filtering, storage-URI parsing, pagination,
-// and the "blob database" factory used by the AWS, Cloudflare, and
-// PocketBase backends.
-//
-// Most apps don't import this package directly; the SDK's update
-// pipeline does. This file shows the standalone helpers so you can
-// use them while writing a custom backend or a CLI tool.
-//
-// Run: `dart run example/main.dart`
-
-import 'package:flutter_ota_kit_plugin_core/flutter_ota_kit_plugin_core.dart';
-
-void main() {
-  // ── 1. Storage URI parser. ───────────────────────────────────────
-  // `parseStorageUri` validates the protocol and returns the bucket +
-  // key. Throws on unknown protocols so misuse is caught early.
-  const supabaseUri =
-      'supabase-storage://flutter-ota-bundles/'
-      '01a059a6/patch.zip';
-  final parsed = parseStorageUri(supabaseUri, 'supabase-storage');
-  print('Parsed protocol: ${parsed.protocol}');
-  print('Parsed bucket:   ${parsed.bucket}');
-  print('Parsed key:      ${parsed.key}');
-
-  // ── 2. Bundle storage keys. ──────────────────────────────────────
-  // `createBundleStorageKey` returns a flat key for the patch blob
-  // inside a storage bucket. The default layout is `{id}/patch.zip`;
-  // for assets it's `{id}/assets/{path}`.
-  final patchKey = createBundleStorageKey('01a059a6');
-  print('Patch key: $patchKey');
-
-  final assetKey = createBundleStorageKey('01a059a6', [
-    'assets',
-    'images',
-    'logo.png',
-  ]);
-  print('Asset key: $assetKey');
-
-  // ── 3. Patch ID helper. ──────────────────────────────────────────
-  // The device SDK reports the currently-installed patch id back to
-  // the server (so the server can compute diffs). For patches with a
-  // base, the id is `{currentId}-h{patchCount}`; for standalone
-  // patches, the id is the current id.
-  final patchId = buildBundlePatchId(
-    '01a059a6-7d3c-4f3e-8a2c-9c2e3a4b5d6e',
-    '00000000-0000-0000-0000-000000000000',
-  );
-  print('Patch id: $patchId');
-
-  // ── 4. Pagination math. ──────────────────────────────────────────
-  // `calculatePagination` returns total/page/hasNext/hasPrev info
-  // used by the CLI's `bundle list` command.
-  final p = calculatePagination(247, limit: 20, offset: 40);
-  print('Page ${p.currentPage} of ${p.totalPages} (${p.total} items)');
-  print('  hasNextPage:     ${p.hasNextPage}');
-  print('  hasPreviousPage: ${p.hasPreviousPage}');
-}

package/dart-src/plugins/plugin-core/pubspec.yaml

@@ -1,23 +0,0 @@
-name: flutter_ota_kit_plugin_core
-description: Plugin core abstractions for flutter_ota_kit — database, storage, and build interfaces.
-version: 0.0.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
-  mime: ^2.0.0
-
-dev_dependencies:
-  test: ^1.25.0
-  lints: ^5.1.0
-
-dependency_overrides:
-  flutter_ota_kit_core:
-    path: ../../packages/core

package/dart-src/plugins/plugin-core/test/asset_storage_layout_test.dart

@@ -1,170 +0,0 @@
-import 'package:flutter_ota_kit_plugin_core/src/asset_storage_layout.dart';
-import 'package:flutter_ota_kit_plugin_core/src/bundle_storage_layout.dart';
-import 'package:flutter_ota_kit_plugin_core/src/legacy_asset_storage_layout.dart';
-import 'package:test/test.dart';
-
-void main() {
-  group('assetStorageLayout', () {
-    group('getAssetStorageLayout', () {
-      test('classifies /assets roots as content-addressed storage', () {
-        expect(
-          getAssetStorageLayout('s3://bucket/assets'),
-          'content-addressed',
-        );
-        expect(
-          getAssetStorageLayout('s3://bucket/releases/assets/'),
-          'content-addressed',
-        );
-      });
-
-      test(
-        'classifies non-/assets roots as legacy per-bundle file storage',
-        () {
-          expect(
-            getAssetStorageLayout('s3://bucket/releases/bundle-id/files'),
-            'legacy-files',
-          );
-        },
-      );
-    });
-
-    group('getManifestAssetStoragePath', () {
-      test('resolves content-addressed manifest assets by file hash', () {
-        expect(
-          getManifestAssetStoragePath(
-            assetBaseStorageUri: 's3://bucket/assets',
-            assetPath: 'index.ios.bundle.br',
-            fileHash: 'abcdef',
-          ),
-          'sha256/ab/abcdef.br',
-        );
-      });
-
-      test('resolves legacy manifest assets by manifest-relative path', () {
-        expect(
-          getManifestAssetStoragePath(
-            assetBaseStorageUri: 's3://bucket/releases/bundle-id/files',
-            assetPath: 'assets/logo.png',
-            fileHash: 'abcdef',
-          ),
-          'assets/logo.png',
-        );
-      });
-    });
-
-    group('createStorageUriWithRelativePath', () {
-      test('creates escaped child storage uris', () {
-        expect(
-          createStorageUriWithRelativePath(
-            baseStorageUri: 's3://bucket/releases/assets/',
-            relativePath: 'assets/icon one.png',
-          ),
-          's3://bucket/releases/assets/assets/icon%20one.png',
-        );
-      });
-    });
-
-    group('resolveManifestAssetStorageUri', () {
-      test('resolves manifest asset storage uris through the layout', () {
-        expect(
-          resolveManifestAssetStorageUri(
-            assetBaseStorageUri: 's3://bucket/assets',
-            assetPath: 'assets/logo.png',
-            fileHash: 'abcdef',
-          ),
-          's3://bucket/assets/sha256/ab/abcdef.png',
-        );
-      });
-    });
-
-    group('isBrotliManifestAssetPath', () {
-      test('matches index.*.bundle paths', () {
-        expect(isBrotliManifestAssetPath('index.ios.bundle'), isTrue);
-        expect(
-          isBrotliManifestAssetPath('nested/index.android.bundle'),
-          isTrue,
-        );
-      });
-
-      test('rejects non-index bundle paths', () {
-        expect(isBrotliManifestAssetPath('main.ios.bundle'), isFalse);
-      });
-    });
-
-    group('getManifestAssetDownloadPath', () {
-      test('appends .br to index bundle paths', () {
-        expect(
-          getManifestAssetDownloadPath('index.ios.bundle'),
-          'index.ios.bundle.br',
-        );
-        expect(
-          getManifestAssetDownloadPath('nested/index.android.bundle'),
-          'nested/index.android.bundle.br',
-        );
-      });
-
-      test('passes through non-index bundle paths', () {
-        expect(
-          getManifestAssetDownloadPath('main.ios.bundle'),
-          'main.ios.bundle',
-        );
-      });
-    });
-  });
-
-  group('bundleStorageLayout', () {
-    group('createBundleStorageKey', () {
-      test('stores new bundle artifacts below the bundles namespace', () {
-        expect(createBundleStorageKey('bundle-id'), 'bundles/bundle-id');
-        expect(
-          createBundleStorageKey('bundle-id', ['patches', 'base-id']),
-          'bundles/bundle-id/patches/base-id',
-        );
-      });
-    });
-
-    group('createStorageRootUriWithPath', () {
-      test('derives the shared storage root from bundle URIs', () {
-        expect(
-          createStorageRootUriWithPath(
-            's3://bucket/releases/bundles/bundle-id/manifest.json',
-            'bundle-id',
-            'assets',
-          ),
-          's3://bucket/releases/assets',
-        );
-      });
-
-      test('rejects storage URIs that do not contain the bundle id', () {
-        expect(
-          () => createStorageRootUriWithPath(
-            'https://uploads.example.com/object',
-            'bundle-id',
-            'assets',
-          ),
-          throwsA(isA<StateError>()),
-        );
-      });
-
-      test('preserves encoded storage root segments', () {
-        expect(
-          createStorageRootUriWithPath(
-            's3://bucket/release%20files/bundles/bundle-id/manifest.json',
-            'bundle-id',
-            'assets/sha256',
-          ),
-          's3://bucket/release%20files/assets/sha256',
-        );
-      });
-    });
-  });
-
-  group('legacyAssetStorageLayout', () {
-    test('getLegacyManifestAssetStoragePath returns assetPath unchanged', () {
-      expect(
-        getLegacyManifestAssetStoragePath(assetPath: 'assets/logo.png'),
-        'assets/logo.png',
-      );
-    });
-  });
-}

package/dart-src/plugins/plugin-core/test/bundle_unit_of_work_store_test.dart

@@ -1,74 +0,0 @@
-import 'package:flutter_ota_kit_plugin_core/src/bundle_unit_of_work.dart';
-import 'package:flutter_ota_kit_plugin_core/src/bundle_unit_of_work_store.dart';
-import 'package:test/test.dart';
-
-void main() {
-  setUp(() {
-    clearUnitOfWorkStore();
-  });
-
-  group('isUnitOfWorkContext', () {
-    test('returns true for Map<String, Object?>', () {
-      expect(isUnitOfWorkContext(<String, Object?>{}), isTrue);
-    });
-
-    test('returns false for null', () {
-      expect(isUnitOfWorkContext(null), isFalse);
-    });
-
-    test('returns false for non-map', () {
-      expect(isUnitOfWorkContext('string'), isFalse);
-      expect(isUnitOfWorkContext(42), isFalse);
-    });
-
-    test('returns false for wrong map type', () {
-      // Dart generics are covariant, so Map<String, int> IS Map<String, Object?>
-      // Only key-type mismatches fail the check
-      expect(isUnitOfWorkContext(<int, Object?>{}), isFalse);
-      expect(isUnitOfWorkContext(<int, String>{}), isFalse);
-    });
-  });
-
-  group('getRequestBundleUnitOfWork', () {
-    test('returns null for null context', () {
-      expect(getRequestBundleUnitOfWork(null), isNull);
-    });
-
-    test('returns null for invalid context', () {
-      expect(getRequestBundleUnitOfWork('not a map'), isNull);
-    });
-
-    test('creates new UoW for valid context', () {
-      final context = <String, Object?>{};
-      final uow1 = getRequestBundleUnitOfWork(context);
-      expect(uow1, isA<BundleUnitOfWork>());
-    });
-
-    test('returns same UoW for same context (identity)', () {
-      final context = <String, Object?>{};
-      final uow1 = getRequestBundleUnitOfWork(context);
-      final uow2 = getRequestBundleUnitOfWork(context);
-      expect(identical(uow1, uow2), isTrue);
-    });
-
-    test('returns different UoW for different contexts', () {
-      final ctx1 = <String, Object?>{};
-      final ctx2 = <String, Object?>{};
-      final uow1 = getRequestBundleUnitOfWork(ctx1);
-      final uow2 = getRequestBundleUnitOfWork(ctx2);
-      expect(identical(uow1, uow2), isFalse);
-    });
-  });
-
-  group('clearUnitOfWorkStore', () {
-    test('removes all entries', () {
-      final ctx = <String, Object?>{};
-      final uow = getRequestBundleUnitOfWork(ctx);
-      expect(uow, isNotNull);
-      clearUnitOfWorkStore();
-      // After clearing, a new UoW should be created for the same context
-      final uow2 = getRequestBundleUnitOfWork(ctx);
-      expect(identical(uow, uow2), isFalse);
-    });
-  });
-}