استراتيجيات ترحيل قاعدة البيانات عبر جميع حلول التخزين

Future<Database> openAppDatabase() async {
  return openDatabase(
    'app.db',
    version: 3,
    onCreate: (db, version) async {
      // إنشاء المخطط الأحدث دائمًا
      await db.execute('''
        CREATE TABLE notes (
          id      INTEGER PRIMARY KEY AUTOINCREMENT,
          title   TEXT    NOT NULL,
          body    TEXT    NOT NULL,
          pinned  INTEGER NOT NULL DEFAULT 0,
          color   TEXT    NOT NULL DEFAULT '#FFFFFF'
        )
      ''');
    },
    onUpgrade: (db, oldVersion, newVersion) async {
      // تطبيق كل خطوة ترحيل بالتتابع
      if (oldVersion < 2) {
        // v1 -> v2: إضافة علامة التثبيت
        await db.execute(
          'ALTER TABLE notes ADD COLUMN pinned INTEGER NOT NULL DEFAULT 0',
        );
      }
      if (oldVersion < 3) {
        // v2 -> v3: إضافة عمود اللون
        await db.execute(
          "ALTER TABLE notes ADD COLUMN color TEXT NOT NULL DEFAULT '#FFFFFF'",
        );
      }
    },
  );
}

@DriftDatabase(tables: [Notes, Tags])
class AppDatabase extends _$AppDatabase {
  AppDatabase(QueryExecutor e) : super(e);

  @override
  int get schemaVersion => 3;

  @override
  MigrationStrategy get migration => MigrationStrategy(
    onCreate: (Migrator m) async {
      await m.createAll(); // إنشاء كل الجداول بأحدث مخطط
    },
    onUpgrade: (Migrator m, int from, int to) async {
      if (from < 2) {
        // إضافة جدول Tags المُقدَّم في v2
        await m.createTable(tags);
      }
      if (from < 3) {
        // إضافة عمود archivedAt قابل للنلية في Notes في v3
        await m.addColumn(notes, notes.archivedAt);
      }
    },
    beforeOpen: (OpenedDatabase details) async {
      // تفعيل المفاتيح الأجنبية عند كل فتح (SQLite تعطّلها افتراضيًا)
      await customStatement('PRAGMA foreign_keys = ON');
    },
  );
}

// الإصدار 1 من النموذج — حقلان
@HiveType(typeId: 0)
class UserProfile extends HiveObject {
  @HiveField(0)
  String name;

  @HiveField(1)
  String email;

  UserProfile({required this.name, required this.email});
}

// الإصدار 2 — إضافة bio؛ الحقل(2) آمن للإضافة،
// السجلات الموجودة تقرأ null وتحصل على القيمة الافتراضية
@HiveType(typeId: 0)
class UserProfile extends HiveObject {
  @HiveField(0)
  String name;

  @HiveField(1)
  String email;

  @HiveField(2)
  String bio; // حقل جديد — القيمة الافتراضية تُعيَّن في read() للمحول

  UserProfile({required this.name, required this.email, this.bio = ''});
}

// إعادة توليد المحول مع build_runner:
// flutter pub run build_runner build --delete-conflicting-outputs
// طريقة read() للمحول المُولَّد تضع null كقيمة افتراضية للحقول المفقودة تلقائيًا.

Future<void> migratePreferences() async {
  final prefs = await SharedPreferences.getInstance();

  const migrationKey = 'prefs_migration_version';
  final currentMigration = prefs.getInt(migrationKey) ?? 0;

  if (currentMigration < 1) {
    // v0 -> v1: إعادة تسمية 'user_name' إلى 'display_name'
    final oldValue = prefs.getString('user_name');
    if (oldValue != null) {
      await prefs.setString('display_name', oldValue);
      await prefs.remove('user_name');
    }
    await prefs.setInt(migrationKey, 1);
  }

  if (currentMigration < 2) {
    // v1 -> v2: ترحيل boolean 'dark_mode' إلى string 'theme_mode'
    final darkMode = prefs.getBool('dark_mode');
    if (darkMode != null) {
      await prefs.setString('theme_mode', darkMode ? 'dark' : 'light');
      await prefs.remove('dark_mode');
    }
    await prefs.setInt(migrationKey, 2);
  }
}