@_nazmiforreal/flutter-ota 0.1.6 → 0.1.7

package/dart-src/packages/cli-tools/test/standalone_backend_test.dart

@@ -1,315 +0,0 @@
-import 'dart:convert' show jsonDecode, jsonEncode, utf8;
-import 'dart:io' show Directory, File;
-import 'dart:typed_data' show Uint8List;
-
-import 'package:archive/archive.dart';
-import 'package:flutter_patcher_cli/flutter_patcher_cli.dart';
-import 'package:http/http.dart' as http;
-import 'package:http/testing.dart' show MockClient;
-import 'package:test/test.dart';
-
-// Stateful in-memory fake of the standalone (self-hosted) REST server.
-class _FakeServer {
-  final Map<String, Map<String, dynamic>> bundles = {};
-  final Map<String, List<int>> storage = {};
-
-  Future<http.Response> handle(http.Request request) async {
-    final path = request.url.path;
-    final method = request.method;
-
-    if (path == '/api/bundles/channels' && method == 'GET') {
-      final channels = bundles.values.map((b) => b['channel'] as String).toSet().toList();
-      return http.Response(jsonEncode({'data': {'channels': channels}}), 200);
-    }
-    if (path == '/api/bundles' && method == 'POST') {
-      final list = jsonDecode(request.body) as List;
-      for (final item in list) {
-        final b = (item as Map).cast<String, dynamic>();
-        bundles[b['id'] as String] = {...b};
-      }
-      return http.Response(jsonEncode({'success': true}), 201);
-    }
-    if (path == '/api/bundles' && method == 'GET') {
-      final channel = request.url.queryParameters['channel'];
-      final enabled = request.url.queryParameters['enabled'];
-      var items = bundles.values.toList();
-      if (channel != null) items = items.where((b) => b['channel'] == channel).toList();
-      if (enabled == 'true') items = items.where((b) => b['enabled'] == true).toList();
-      // Emulate the DB's default id-desc ordering (latest bundle first).
-      items = items.reversed.toList();
-      return http.Response(
-        jsonEncode({
-          'data': items,
-          'pagination': {
-            'total': items.length,
-            'hasNextPage': false,
-            'hasPreviousPage': false,
-            'currentPage': 1,
-            'totalPages': 1,
-            'nextCursor': null,
-            'previousCursor': null,
-          },
-        }),
-        200,
-      );
-    }
-    if (path.startsWith('/api/bundles/') && method == 'PATCH') {
-      final id = path.substring('/api/bundles/'.length);
-      final patch = jsonDecode(request.body) as Map<String, dynamic>;
-      final existing = bundles[id];
-      if (existing == null) return http.Response('{"error":"not found"}', 404);
-      existing.addAll(patch);
-      return http.Response(jsonEncode({'success': true}), 200);
-    }
-    if (path.startsWith('/api/bundles/') && method == 'DELETE') {
-      final id = path.substring('/api/bundles/'.length);
-      bundles.remove(id);
-      return http.Response(jsonEncode({'success': true}), 200);
-    }
-    if (path.startsWith('/api/bundles/') && method == 'GET') {
-      final id = path.substring('/api/bundles/'.length);
-      final b = bundles[id];
-      if (b == null) return http.Response('{"error":"not found"}', 404);
-      return http.Response(jsonEncode(b), 200);
-    }
-    if (path == '/api/upload' && method == 'POST') {
-      final key = request.url.queryParameters['key']!;
-      storage[key] = request.bodyBytes;
-      return http.Response(jsonEncode({'storageUri': 'mem://$key'}), 201);
-    }
-    if (path == '/api/getDownloadUrl' && method == 'POST') {
-      final uri = (jsonDecode(request.body) as Map)['storageUri'] as String;
-      final key = uri.replaceFirst('mem://', '');
-      return http.Response(
-        jsonEncode({'fileUrl': 'http://localhost/mem/$key'}),
-        200,
-      );
-    }
-    if (path == '/api/delete' && method == 'DELETE') {
-      final uri = (jsonDecode(request.body) as Map)['storageUri'] as String;
-      storage.remove(uri.replaceFirst('mem://', ''));
-      return http.Response(jsonEncode({'success': true}), 200);
-    }
-    if (request.url.host == 'localhost' && path.startsWith('/mem/')) {
-      final key = path.substring('/mem/'.length);
-      final bytes = storage[key];
-      if (bytes == null) return http.Response('not found', 404);
-      return http.Response.bytes(bytes, 200);
-    }
-    return http.Response(jsonEncode({'error': 'not found'}), 404);
-  }
-}
-
-void main() {
-  group('cli backends', () {
-    test('standalone backend (self-hosted REST)', () async {
-      final fake = _FakeServer();
-      final client = MockClient(fake.handle);
-      final config = FlutterPatcherConfig(
-        provider: 'standalone',
-        supabase: const SupabaseConfigJson(url: 'https://x.supabase.co'),
-        standalone: StandaloneConfigJson(baseUrl: 'http://localhost'),
-        channel: 'production',
-        platform: 'android',
-        source: './dist',
-      );
-      final backend = resolveBackend(
-        config,
-        standaloneClientFactory: () => client,
-      );
-
-      final source = Directory.systemTemp.createTempSync('fp-src-');
-      File('${source.path}/app.so').writeAsStringSync('fake-libapp-bytes');
-      try {
-        final bundle = await deployBundle(
-          backend,
-          DeployOptions(
-            source: source.path,
-            channel: 'production',
-            platform: 'android',
-            message: 'first',
-            targetAppVersion: '>=1.0.0',
-          ),
-        );
-        expect(bundle.id, isNotEmpty);
-        expect(bundle.storageUri, isNotEmpty);
-        expect(await backend.storage.exists(bundle.storageUri), isTrue);
-
-        final dl = File('${Directory.systemTemp.path}/fp-dl-${bundle.id}.zip');
-        await backend.storage.downloadFile(bundle.storageUri, dl.path);
-        expect(dl.existsSync() && await dl.length() > 0, isTrue);
-        await dl.delete();
-
-        final listed = await listBundles(backend, const ListOptions());
-        expect(listed.data.where((b) => b.id == bundle.id), hasLength(1));
-
-        final live = await getChannel(backend, 'production');
-        expect(live?.id, bundle.id);
-
-        final second = await deployBundle(
-          backend,
-          DeployOptions(
-            source: source.path,
-            channel: 'production',
-            platform: 'android',
-            message: 'second',
-            targetAppVersion: '>=1.0.0',
-          ),
-        );
-        await promoteBundle(backend, second.id, 'production');
-        final disabled = await rollbackChannel(backend, 'production');
-        expect(disabled, second.id);
-
-        await deleteBundle(backend, bundle.id);
-        final afterDelete = await listBundles(
-          backend,
-          const ListOptions(channel: 'production'),
-        );
-        expect(
-          afterDelete.data.where((b) => b.id == bundle.id).isEmpty,
-          isTrue,
-        );
-      } finally {
-        source.deleteSync(recursive: true);
-      }
-    });
-
-    test('standalone backend signs the deployed bundle (md5 fileHash + '
-        'metadata.signature verifiable)', () async {
-      final (privateB64, publicB64) = await generateEd25519KeyPair();
-      final fake = _FakeServer();
-      final client = MockClient(fake.handle);
-      final config = FlutterPatcherConfig(
-        provider: 'standalone',
-        supabase: const SupabaseConfigJson(url: 'https://x.supabase.co'),
-        standalone: StandaloneConfigJson(baseUrl: 'http://localhost'),
-        channel: 'production',
-        platform: 'android',
-        source: './dist',
-      );
-      final backend = resolveBackend(
-        config,
-        standaloneClientFactory: () => client,
-      );
-
-      final source = Directory.systemTemp.createTempSync('fp-src-signed-');
-      File('${source.path}/app.so').writeAsStringSync('fake-libapp-bytes');
-      try {
-        final bundle = await deployBundle(
-          backend,
-          DeployOptions(
-            source: source.path,
-            channel: 'production',
-            platform: 'android',
-            message: 'signed',
-            targetAppVersion: '>=1.0.0',
-            signingKeyBase64: privateB64,
-          ),
-        );
-
-        // fileHash must be a plain MD5 hex (device rejects anything else).
-        expect(bundle.fileHash, matches(RegExp(r'^[0-9a-f]{32}$')));
-        expect(bundle.metadata, isNotNull);
-        final signature = bundle.metadata!.signature;
-        expect(signature, isNotNull);
-        expect(signature, isNotEmpty);
-
-        // The signature verifies over the MD5-hex UTF-8 bytes with the SPKI
-        // public key, exactly as the Android device SDK checks it.
-        final verified = await ed25519Verify(
-          utf8.encode(bundle.fileHash),
-          signature!,
-          publicB64,
-        );
-        expect(verified, isTrue);
-      } finally {
-        source.deleteSync(recursive: true);
-      }
-    });
-
-    test('build + deploy uploads the real patch.zip (no nested-zip mangling)', () async {
-      // 1) Build a synthetic multi-ABI APK in memory.
-      final apk = Archive();
-      for (final abi in const ['arm64-v8a', 'armeabi-v7a', 'x86_64']) {
-        final bytes = utf8.encode('LIBAPP_$abi');
-        apk.addFile(ArchiveFile('lib/$abi/libapp.so', bytes.length, bytes));
-      }
-      final apkDir = Directory.systemTemp.createTempSync('fp-apk-');
-      final apkFile = File('${apkDir.path}/app.apk')
-        ..writeAsBytesSync(Uint8List.fromList(ZipEncoder().encode(apk)));
-
-      // 2) Pack it.
-      final distDir = Directory.systemTemp.createTempSync('fp-dist-');
-      await packPatch(
-        apkPath: apkFile.path,
-        version: '9.9.9',
-        targetVersionCode: 42,
-        out: distDir.path,
-      );
-
-      // 3) Deploy the packed dist/ with a signing key.
-      final (privateB64, publicB64) = await generateEd25519KeyPair();
-      final fake = _FakeServer();
-      final client = MockClient(fake.handle);
-      final config = FlutterPatcherConfig(
-        provider: 'standalone',
-        supabase: const SupabaseConfigJson(url: 'https://x.supabase.co'),
-        standalone: StandaloneConfigJson(baseUrl: 'http://localhost'),
-        channel: 'production',
-        platform: 'android',
-        source: distDir.path,
-      );
-      final backend = resolveBackend(
-        config,
-        standaloneClientFactory: () => client,
-      );
-
-      final bundle = await deployBundle(
-        backend,
-        DeployOptions(
-          source: distDir.path,
-          channel: 'production',
-          platform: 'android',
-          message: 'built',
-          targetAppVersion: '>=1.0.0',
-          signingKeyBase64: privateB64,
-        ),
-      );
-
-      // 4) Download what the device would fetch and make sure it is the
-      //    genuine patch (root manifest.json + per-ABI libapp.so), NOT a
-      //    zip that nests the real patch under dist/patch.zip (the old bug).
-      final dl = File('${distDir.path}/downloaded.zip');
-      await backend.storage.downloadFile(bundle.storageUri, dl.path);
-      final downloaded = ZipDecoder().decodeBytes(dl.readAsBytesSync());
-
-      final names = downloaded.files.map((f) => f.name).toList();
-      expect(names, contains('manifest.json'));
-      expect(names, contains('lib/arm64-v8a/libapp.so'));
-      expect(names, isNot(contains('dist/patch.zip')),
-          reason: 'deploy must upload the real patch, not re-zip the dir');
-
-      final manifest = Map<String, dynamic>.from(
-        jsonDecode(utf8.decode(
-          downloaded.files.firstWhere((f) => f.name == 'manifest.json').content
-              as List<int>,
-        )) as Map,
-      );
-      expect(manifest['schemaVersion'], 2);
-      expect((manifest['lib'] as Map).keys, hasLength(3));
-
-      // 5) signature chain still holds on the deployed bundle.
-      expect(
-        await ed25519Verify(
-          utf8.encode(bundle.fileHash),
-          bundle.metadata!.signature!,
-          publicB64,
-        ),
-        isTrue,
-      );
-
-      apkDir.deleteSync(recursive: true);
-      distDir.deleteSync(recursive: true);
-    });
-  });
-}

package/dart-src/plugins/aws/lib/src/aws_lambda_edge_storage.dart

@@ -1,72 +0,0 @@
-import 'package:flutter_patcher_plugin_core/flutter_patcher_plugin_core.dart'
-    show StoragePlugin, StoragePluginHooks;
-
-import 'aws_config.dart' show AwsS3StorageConfig;
-import 'aws_storage.dart' show s3Storage;
-import 'with_cloudfront_signed_url.dart'
-    show WithCloudFrontSignedUrlOptions, withCloudFrontSignedUrl;
-
-/// Configuration for the AWS Lambda@Edge S3 storage plugin.
-///
-/// Combines `S3StorageConfig` (credentials/bucket) with the CloudFront signed
-/// URL options. Faithful port of hot-updater `AwsLambdaEdgeStorageConfig`.
-class AwsLambdaEdgeStorageConfig extends AwsS3StorageConfig {
-  AwsLambdaEdgeStorageConfig({
-    required super.bucketName,
-    required super.region,
-    required super.accessKeyId,
-    required super.secretAccessKey,
-    super.basePath,
-    super.endpoint,
-    super.sessionToken,
-    super.clientFactory,
-    required this.keyPairId,
-    this.publicBaseUrl,
-    this.publicBaseUrlResolver,
-    this.getPrivateKey,
-    this.ssmParameterName,
-    this.ssmRegion,
-    this.expiresSeconds,
-  });
-
-  final String keyPairId;
-  final String? publicBaseUrl;
-  final Future<String> Function()? publicBaseUrlResolver;
-  final Future<String> Function()? getPrivateKey;
-  final String? ssmParameterName;
-  final String? ssmRegion;
-  final int? expiresSeconds;
-
-  WithCloudFrontSignedUrlOptions toSignedUrlOptions() =>
-      WithCloudFrontSignedUrlOptions(
-        keyPairId: keyPairId,
-        publicBaseUrl: publicBaseUrl,
-        publicBaseUrlResolver: publicBaseUrlResolver,
-        getPrivateKey: getPrivateKey,
-        ssmParameterName: ssmParameterName,
-        ssmRegion: ssmRegion,
-        expiresSeconds: expiresSeconds,
-        accessKeyId: accessKeyId,
-        secretAccessKey: secretAccessKey,
-        sessionToken: sessionToken,
-      );
-}
-
-/// AWS Lambda@Edge S3 storage plugin: S3 storage whose `s3://` download URLs
-/// are rewritten as CloudFront signed URLs. Faithful port of
-/// `s3LambdaEdgeStorage.ts` / `awsLambdaEdgeStorage.ts`.
-StoragePlugin s3LambdaEdgeStorage(
-  AwsLambdaEdgeStorageConfig config, [
-  StoragePluginHooks? hooks,
-]) =>
-    withCloudFrontSignedUrl(
-      () => s3Storage(config, hooks),
-      config.toSignedUrlOptions(),
-    )();
-
-/// Alias matching hot-updater's `awsLambdaEdgeStorage` export.
-StoragePlugin awsLambdaEdgeStorage(
-  AwsLambdaEdgeStorageConfig config, [
-  StoragePluginHooks? hooks,
-]) =>
-    s3LambdaEdgeStorage(config, hooks);

package/dart-src/plugins/aws/test/aws_lambda_edge_storage_test.dart

@@ -1,190 +0,0 @@
-import 'dart:convert' show base64, base64Decode, utf8;
-import 'dart:math' show Random;
-import 'dart:typed_data' show Uint8List;
-
-import 'package:asn1lib/asn1lib.dart';
-import 'package:flutter_patcher_aws/flutter_patcher_aws.dart'
-    show
-        AwsLambdaEdgeStorageConfig,
-        cloudfrontSignedUrl,
-        s3LambdaEdgeStorage,
-        verifyCloudfrontSignedUrl;
-import 'package:flutter_patcher_plugin_core/flutter_patcher_plugin_core.dart'
-    show RuntimeStorageProfile;
-import 'package:pointycastle/export.dart'
-    show
-        FortunaRandom,
-        KeyParameter,
-        ParametersWithRandom,
-        RSAKeyGenerator,
-        RSAKeyGeneratorParameters,
-        RSAPrivateKey,
-        RSAPublicKey;
-import 'package:test/test.dart';
-
-import 'mock_aws_s3_client.dart' show MockAwsS3Client, Store;
-
-List<int> _b64urlDecode(String s) {
-  final normalized = s.replaceAll('-', '+').replaceAll('_', '/');
-  final padded = normalized.padRight(
-    normalized.length + (4 - normalized.length % 4) % 4,
-    '=',
-  );
-  return base64Decode(padded);
-}
-
-String _wrapPem(String label, String b64) {
-  final chunks = <String>[];
-  for (var i = 0; i < b64.length; i += 64) {
-    chunks.add(b64.substring(i, i + 64 > b64.length ? b64.length : i + 64));
-  }
-  return '-----BEGIN $label-----\n${chunks.join('\n')}\n-----END $label-----\n';
-}
-
-String _encodePrivatePkcs1(RSAPrivateKey k, RSAPublicKey pub) {
-  final p = k.p!;
-  final q = k.q!;
-  final d = k.privateExponent!;
-  final dP = d % (p - BigInt.one);
-  final dQ = d % (q - BigInt.one);
-  final qInv = q.modInverse(p);
-  final seq = ASN1Sequence();
-  seq.add(ASN1Integer(BigInt.zero));
-  seq.add(ASN1Integer(k.modulus!));
-  seq.add(ASN1Integer(pub.exponent!));
-  seq.add(ASN1Integer(d));
-  seq.add(ASN1Integer(p));
-  seq.add(ASN1Integer(q));
-  seq.add(ASN1Integer(dP));
-  seq.add(ASN1Integer(dQ));
-  seq.add(ASN1Integer(qInv));
-  return _wrapPem('RSA PRIVATE KEY', base64.encode(seq.encodedBytes));
-}
-
-String _encodePublic(RSAPublicKey pub) {
-  final keySeq = ASN1Sequence();
-  keySeq.add(ASN1Integer(pub.modulus!));
-  keySeq.add(ASN1Integer(pub.exponent!));
-  final spki = ASN1Sequence();
-  final alg = ASN1Sequence();
-  alg.add(ASN1ObjectIdentifier.fromComponents([1, 2, 840, 113549, 1, 1, 1]));
-  alg.add(ASN1Null());
-  spki.add(alg);
-  spki.add(ASN1BitString(keySeq.encodedBytes));
-  return _wrapPem('PUBLIC KEY', base64.encode(spki.encodedBytes));
-}
-
-(String, String) _generateKeyPair() {
-  final rng = FortunaRandom();
-  final seedSource = Random.secure();
-  rng.seed(
-    KeyParameter(
-      Uint8List.fromList(
-        List<int>.generate(32, (_) => seedSource.nextInt(256)),
-      ),
-    ),
-  );
-  final kg = RSAKeyGenerator()
-    ..init(
-      ParametersWithRandom(
-        RSAKeyGeneratorParameters(BigInt.from(65537), 2048, 12),
-        rng,
-      ),
-    );
-  final pair = kg.generateKeyPair();
-  final priv = pair.privateKey as RSAPrivateKey;
-  final pub = pair.publicKey as RSAPublicKey;
-  return (_encodePrivatePkcs1(priv, pub), _encodePublic(pub));
-}
-
-AwsLambdaEdgeStorageConfig _edgeConfig(
-  Store store,
-  String privatePem, {
-  String? publicBaseUrl,
-  Future<String> Function()? publicBaseUrlResolver,
-}) =>
-    AwsLambdaEdgeStorageConfig(
-      bucketName: 'test-bucket',
-      region: 'us-east-1',
-      accessKeyId: 'ak',
-      secretAccessKey: 'sk',
-      keyPairId: 'KP123',
-      publicBaseUrl: publicBaseUrl,
-      publicBaseUrlResolver: publicBaseUrlResolver,
-      getPrivateKey: () async => privatePem,
-      clientFactory: (_) => MockAwsS3Client(store),
-    );
-
-void main() {
-  group('aws cloudfront signed url', () {
-    final (privatePem, publicPem) = _generateKeyPair();
-
-    test('cloudfrontSignedUrl round-trips and verifies', () {
-      const url = 'https://cdn.example.com/bundles/x.zip';
-      final signed = cloudfrontSignedUrl(
-        url: url,
-        keyPairId: 'KP123',
-        privateKeyPem: privatePem,
-        dateLessThan: DateTime.now().add(const Duration(days: 365)),
-      );
-      expect(signed, contains('Policy='));
-      expect(signed, contains('Signature='));
-      expect(signed, contains('Key-Pair-Id=KP123'));
-      expect(
-        verifyCloudfrontSignedUrl(signedUrl: signed, publicKeyPem: publicPem),
-        isTrue,
-      );
-
-      final uri = Uri.parse(signed);
-      final policyJson = utf8.decode(_b64urlDecode(uri.queryParameters['Policy']!));
-      expect(policyJson, contains(url));
-    });
-
-    test('s3LambdaEdgeStorage signs s3 download urls', () async {
-      final store = Store();
-      final plugin = s3LambdaEdgeStorage(
-        _edgeConfig(store, privatePem, publicBaseUrl: 'https://cdn.example.com'),
-      );
-      final RuntimeStorageProfile runtime = plugin.profiles.runtime!;
-
-      final res = await runtime.getDownloadUrl('s3://test-bucket/bundles/x.zip');
-      final fileUrl = res['fileUrl']!;
-      expect(fileUrl, contains('Key-Pair-Id=KP123'));
-      expect(
-        verifyCloudfrontSignedUrl(signedUrl: fileUrl, publicKeyPem: publicPem),
-        isTrue,
-      );
-
-      final uri = Uri.parse(fileUrl);
-      final policy = utf8.decode(_b64urlDecode(uri.queryParameters['Policy']!));
-      expect(policy, contains('https://cdn.example.com/bundles/x.zip'));
-    });
-
-    test('s3LambdaEdgeStorage resolves publicBaseUrl via function', () async {
-      final store = Store();
-      final plugin = s3LambdaEdgeStorage(
-        _edgeConfig(
-          store,
-          privatePem,
-          publicBaseUrlResolver: () async => 'https://edge.acme.dev',
-        ),
-      );
-      final runtime = plugin.profiles.runtime!;
-      final res = await runtime.getDownloadUrl('s3://test-bucket/a.zip');
-      expect(
-        verifyCloudfrontSignedUrl(
-          signedUrl: res['fileUrl']!,
-          publicKeyPem: publicPem,
-        ),
-        isTrue,
-      );
-      expect(res['fileUrl'], contains('https://edge.acme.dev/a.zip'));
-    });
-
-    test('plugin name carries WithCloudFrontSignedUrl suffix', () {
-      final store = Store();
-      final plugin = s3LambdaEdgeStorage(_edgeConfig(store, privatePem));
-      expect(plugin.name, 's3StorageWithCloudFrontSignedUrl');
-    });
-  });
-}

package/dart-src/plugins/standalone/lib/flutter_patcher_standalone.dart

@@ -1,12 +0,0 @@
-export 'src/standalone_config.dart'
-    show
-        StandaloneClientFactory,
-        StandaloneRepositoryConfig,
-        StandaloneRepositoryRoutes,
-        StandaloneStorageConfig,
-        StandaloneStorageRoutes,
-        buildPath,
-        joinUrl,
-        mergeHeaders;
-export 'src/standalone_database.dart' show standaloneRepository;
-export 'src/standalone_storage.dart' show standaloneStorage;

package/dart-src/plugins/standalone/lib/src/standalone_config.dart

@@ -1,107 +0,0 @@
-import 'dart:convert' show jsonEncode;
-
-import 'package:http/http.dart' as http;
-import 'package:http/http.dart';
-
-/// A factory that returns the [http.Client] used by standalone plugins.
-///
-/// Injectable so tests can supply a mock client.
-typedef StandaloneClientFactory = Client Function();
-
-/// Configuration for the standalone repository (the database half of the
-/// self-hosted backend).
-class StandaloneRepositoryConfig {
-  const StandaloneRepositoryConfig({
-    required this.baseUrl,
-    this.commonHeaders,
-    this.routes,
-    this.clientFactory,
-  });
-
-  final String baseUrl;
-  final Map<String, String>? commonHeaders;
-  final StandaloneRepositoryRoutes? routes;
-  final StandaloneClientFactory? clientFactory;
-}
-
-/// Overridable route templates for the repository REST contract.
-class StandaloneRepositoryRoutes {
-  const StandaloneRepositoryRoutes({
-    this.create = '/api/bundles',
-    this.list = '/api/bundles',
-    this.channels = '/api/bundles/channels',
-    this.retrieve = '/api/bundles/:id',
-    this.update = '/api/bundles/:id',
-    this.delete = '/api/bundles/:id',
-  });
-
-  final String create;
-  final String list;
-  final String channels;
-  final String retrieve;
-  final String update;
-  final String delete;
-}
-
-/// Configuration for the standalone storage (the storage half of the
-/// self-hosted backend).
-class StandaloneStorageConfig {
-  const StandaloneStorageConfig({
-    required this.baseUrl,
-    this.commonHeaders,
-    this.routes,
-    this.clientFactory,
-  });
-
-  final String baseUrl;
-  final Map<String, String>? commonHeaders;
-  final StandaloneStorageRoutes? routes;
-  final StandaloneClientFactory? clientFactory;
-}
-
-/// Overridable route templates for the storage REST contract.
-class StandaloneStorageRoutes {
-  const StandaloneStorageRoutes({
-    this.upload = '/api/upload',
-    this.getDownloadUrl = '/api/getDownloadUrl',
-    this.delete = '/api/delete',
-    this.readText = '/api/readText',
-    this.list = '/api/list',
-    this.serveFile = '/api/_file',
-  });
-
-  final String upload;
-  final String getDownloadUrl;
-  final String delete;
-  final String readText;
-  final String list;
-  final String serveFile;
-}
-
-/// Build a request path from a route template that may contain `:id`.
-String buildPath(String template, {String? id}) {
-  var path = template;
-  if (id != null) path = path.replaceAll(':id', id);
-  return path;
-}
-
-/// Join [baseUrl] and [path], ensuring exactly one `/` between them.
-String joinUrl(String baseUrl, String path) {
-  final base = baseUrl.endsWith('/') ? baseUrl.substring(0, baseUrl.length - 1) : baseUrl;
-  final p = path.startsWith('/') ? path : '/$path';
-  return '$base$p';
-}
-
-/// Merge [commonHeaders] with extra per-request headers.
-Map<String, String> mergeHeaders(
-  Map<String, String>? common,
-  Map<String, String>? extra,
-) {
-  final result = <String, String>{};
-  if (common != null) result.addAll(common);
-  if (extra != null) result.addAll(extra);
-  return result;
-}
-
-/// Envelope helper: standalone create expects `[bundle]`.
-String encodeBundleList(Map<String, dynamic> bundle) => jsonEncode([bundle]);