feat(database): add logoUrl field to existing sources

- New migration to add logoUrl field to sources collection
- Uses Clearbit Logo API to generate logo URLs based on source website URLs
- Updates 66 files, adds 1 new migration file

Author: fulleni

lib/src/database/migrations/20251024000000_add_logo_url_to_sources.dart

@@ -0,0 +1,66 @@
+import 'package:flutter_news_app_api_server_full_source_code/src/database/migration.dart';
+import 'package:logging/logging.dart';
+import 'package:mongo_dart/mongo_dart.dart';
+
+/// Migration to add the `logoUrl` field to existing `sources` documents.
+class AddLogoUrlToSources extends Migration {
+  /// {@macro add_logo_url_to_sources}
+  AddLogoUrlToSources()
+    : super(
+        prDate: '20251024000000',
+        prId: '60',
+        prSummary:
+            'Adds the required `logoUrl` field to all existing '
+            'documents in the `sources` collection to align with the '
+            'core v1.3.0 model update.',
+      );
+
+  @override
+  Future<void> up(Db db, Logger log) async {
+    final collection = db.collection('sources');
+    final sourcesToUpdate = await collection
+        .find(where.notExists('logoUrl'))
+        .toList();
+
+    if (sourcesToUpdate.isEmpty) {
+      log.info('No sources found needing a logoUrl. Migration is up to date.');
+      return;
+    }
+
+    log.info(
+      'Found ${sourcesToUpdate.length} sources to update with a logoUrl.',
+    );
+    var count = 0;
+    for (final source in sourcesToUpdate) {
+      final sourceUrl = source['url'] as String?;
+      if (sourceUrl != null && sourceUrl.isNotEmpty) {
+        try {
+          final host = Uri.parse(sourceUrl).host;
+          final logoUrl = 'https://logo.clearbit.com/$host?size=200';
+          await collection.updateOne(
+            where.id(source['_id'] as ObjectId),
+            modify.set('logoUrl', logoUrl),
+          );
+          count++;
+        } catch (e) {
+          log.warning(
+            'Could not parse URL for source ${source['_id']}: $sourceUrl',
+          );
+        }
+      }
+    }
+    log.info('Updated $count sources with a new logoUrl.');
+  }
+
+  @override
+  Future<void> down(Db db, Logger log) async {
+    final collection = db.collection('sources');
+    await collection.updateMany(
+      where.exists('logoUrl'),
+      modify.unset('logoUrl'),
+    );
+    log.info(
+      'Removed "logoUrl" field from all documents in the sources collection.',
+    );
+  }
+}

lib/src/database/migrations/all_migrations.dart

@@ -1,5 +1,6 @@
 import 'package:flutter_news_app_api_server_full_source_code/src/database/migration.dart';
 import 'package:flutter_news_app_api_server_full_source_code/src/database/migrations/20250924084800__refactor_ad_config_to_role_based.dart';
+import 'package:flutter_news_app_api_server_full_source_code/src/database/migrations/20251024000000_add_logo_url_to_sources.dart';
 import 'package:flutter_news_app_api_server_full_source_code/src/database/migrations/20251013000056_add_saved_filters_to_user_preferences.dart';
 import 'package:flutter_news_app_api_server_full_source_code/src/database/migrations/20251013000057_add_saved_filters_to_remote_config.dart';
 import 'package:flutter_news_app_api_server_full_source_code/src/services/database_migration_service.dart'
@@ -14,4 +15,5 @@ final List<Migration> allMigrations = [
   RefactorAdConfigToRoleBased(),
   AddSavedFiltersToUserPreferences(),
   AddSavedFiltersToRemoteConfig(),
+  AddLogoUrlToSources(),
 ];