updatePubspecAssets method

Future<void> updatePubspecAssets({ required String clientAssetPath, required List<String> requiredExtraAssets, })

Rewrites the flutter.assets list in pubspec.yaml so that exactly one branding folder (the active client's) and the runtime env file are registered. The default client's fallback env entry is preserved.

Implementation

Future<void> updatePubspecAssets({
  required String clientAssetPath,
  required List<String> requiredExtraAssets,
}) async {
  final file = File(p.join(projectDir, 'pubspec.yaml'));
  if (!file.existsSync()) {
    throw BuildException(
      'pubspec.yaml not found at project root.',
      fix:
          'Ensure you are running the command from a valid Flutter project root.',
    );
  }

  try {
    final content = await file.readAsString();
    final editor = YamlEditor(content);

    final yaml = loadYaml(content);
    final currentAssets =
        (yaml['flutter']?['assets'] as YamlList?)?.toList() ?? [];

    final newAssets = currentAssets
        .map((a) => a.toString())
        .where((asset) => !_isManagedAsset(asset))
        .toList();

    final branding = 'assets/branding/$clientAssetPath/';
    if (!newAssets.contains(branding)) newAssets.add(branding);
    for (final asset in requiredExtraAssets) {
      if (!newAssets.contains(asset)) newAssets.add(asset);
    }

    editor.update(['flutter', 'assets'], newAssets);
    await file.writeAsString(editor.toString());
  } catch (e, s) {
    throw BuildException(
      'Failed to update assets in pubspec.yaml',
      fix:
          'Check if pubspec.yaml has valid syntax and a "flutter:" key defined.',
      originalStackTrace: s,
    );
  }
}