notes_cubit.dart

📁 الملف: notes_cubit.dart

🧠 أولاً: شو هو Cubit أصلاً؟

Cubit = مدير الحالة (State Manager)

Cubit = مدير الحالة (State Manager)

🎯 وظيفته في هذا المشروع:

👉 جلب البيانات
👉 إرسالها للـ UI
👉 التحكم بالحالات (Loading / Success / Error)

📄 الكود كامل

import 'package:flutter_bloc/flutter_bloc.dart';
import '../../domain/entities/note.dart';
import '../../domain/usecases/get_notes_usecase.dart';
import 'notes_state.dart';

class NotesCubit extends Cubit<NotesState> {
  final GetNotesUseCase getNotesUseCase; 
   NotesCubit(
    this.getNotesUseCase,
  ) : super(NotesInitial()); 
  
   Future<void> fetchNotes() async {
    emit(NotesLoading());
    try {
      final notes = await getNotesUseCase();
      emit(NotesLoaded(notes));
    } catch (e) {
      emit(NotesError(e.toString()));
    }
  }
}

import 'package:flutter_bloc/flutter_bloc.dart';
import '../../domain/entities/note.dart';
import '../../domain/usecases/get_notes_usecase.dart';
import 'notes_state.dart';

class NotesCubit extends Cubit<NotesState> {
  final GetNotesUseCase getNotesUseCase; 
   NotesCubit(
    this.getNotesUseCase,
  ) : super(NotesInitial()); 
  
   Future<void> fetchNotes() async {
    emit(NotesLoading());
    try {
      final notes = await getNotesUseCase();
      emit(NotesLoaded(notes));
    } catch (e) {
      emit(NotesError(e.toString()));
    }
  }
}

🔍 الآن نشرح كل جزء بالتفصيل

🧱 1. import flutter_bloc

import 'package:flutter_bloc/flutter_bloc.dart';

import 'package:flutter_bloc/flutter_bloc.dart';

🧠 هذا يجلب:

• Cubit
• Bloc
• أدوات إدارة الحالة

🎯 نحن نستخدم:

Cubit

Cubit

🧱 2. import Note

import '../../domain/entities/note.dart';

import '../../domain/entities/note.dart';

🧠 لماذا؟

👉 لأننا سنرجع:

List<Note>

List<Note>

🧱 3. import UseCase

import '../../domain/usecases/get_notes_usecase.dart';

import '../../domain/usecases/get_notes_usecase.dart';

🧠 هذا أهم import

👉 لأن Cubit لا يتعامل مع Repository
👉 بل يتعامل مع UseCase

🎯 يعني:

Cubit → UseCase

Cubit → UseCase

🧱 4. import state

import 'notes_state.dart';

import 'notes_state.dart';

🧠 هذا يحتوي:

• NotesInitial
• NotesLoading
• NotesLoaded
• NotesError

🎯 Cubit يستخدمه لإخبار UI بالحالة

🧱 5. تعريف الكلاس

class NotesCubit extends Cubit<NotesState>

class NotesCubit extends Cubit<NotesState>

🧠 نشرحها:

🔹 class NotesCubit

👉 هذا كلاس

🔹 extends Cubit<NotesState>

👉 يعني:

هذا الكلاس يرث من Cubit

هذا الكلاس يرث من Cubit

🎯 NotesState

👉 نوع الحالة اللي Cubit يديرها

💥 إذن:

NotesCubit = مدير حالات من نوع NotesState

NotesCubit = مدير حالات من نوع NotesState

🧱 6. المتغير

final GetNotesUseCase getNotesUseCase;

final GetNotesUseCase getNotesUseCase;

🧠 هذا:

👉 object من UseCase

🎯 دوره:

تنفيذ عملية جلب الملاحظات

تنفيذ عملية جلب الملاحظات

💡 final

👉 لا يمكن تغييره

🧱 7. constructor

NotesCubit(
  this.getNotesUseCase,
) : super(NotesInitial());

NotesCubit(
  this.getNotesUseCase,
) : super(NotesInitial());

🧠 نشرحها خطوة خطوة

🔹 this.getNotesUseCase

👉 نمرر UseCase من الخارج

🔥 هذا اسمه:

Dependency Injection

Dependency Injection

💡 لماذا؟

• فصل الطبقات
• اختبار أسهل

🔹 super(NotesInitial())

👉 نحدد الحالة الابتدائية

🎯 يعني:

عند إنشاء Cubit → الحالة = Initial

عند إنشاء Cubit → الحالة = Initial

🧱 8. الدالة fetchNotes 🔥

Future<void> fetchNotes() async

Future<void> fetchNotes() async

🧠 تحليلها:

🔹 Future<void>

👉 دالة غير متزامنة
👉 لا ترجع قيمة

🔹 async

👉 نستخدم await داخلها

🔥 داخل الدالة

🟠 1. emit loading

emit(NotesLoading());

emit(NotesLoading());

🧠 ماذا يحدث؟

👉 Cubit يقول:

أنا الآن أحمل البيانات

أنا الآن أحمل البيانات

🎯 UI سيعرض:

CircularProgressIndicator

CircularProgressIndicator

🟡 2. try

try {

try {

🧠 لماذا؟

👉 لأن API ممكن يفشل

🟢 3. استدعاء UseCase

final notes = await getNotesUseCase();

final notes = await getNotesUseCase();

🔥 أهم سطر

🧠 ماذا يحدث هنا؟

1️⃣ Cubit ينادي:

UseCase

UseCase

2️⃣ UseCase ينادي:

Repository

Repository

3️⃣ Repository ينادي:

DataSource

DataSource

4️⃣ DataSource ينادي:

Supabase

Supabase

5️⃣ يرجع:

List<Note>

List<Note>

💥 السلسلة كاملة

Cubit → UseCase → Repository → DataSource → Supabase

Cubit → UseCase → Repository → DataSource → Supabase

🟣 4. emit success

emit(NotesLoaded(notes));

emit(NotesLoaded(notes));

🧠 ماذا يحدث؟

👉 Cubit يقول:

البيانات وصلت

البيانات وصلت

🎯 UI يعرض القائمة

🔴 5. catch

} catch (e) {

} catch (e) {

🧠 إذا صار خطأ

🔥 مثال:

• لا يوجد إنترنت
• خطأ في Supabase

🔴 6. emit error

emit(NotesError(e.toString()));

emit(NotesError(e.toString()));

🧠 ماذا يحدث؟

👉 إرسال رسالة خطأ

🎯 UI يعرض:

Error message

Error message

🔁 التدفق الكامل

UI → Cubit.fetchNotes()
        ↓
emit(Loading)
        ↓
UseCase()
        ↓
Repository
        ↓
DataSource
        ↓
Supabase
        ↓
رجوع البيانات
        ↓
emit(Loaded)
        ↓
UI يعرض

💥 خلاصة قوية جداً

🎯 Cubit مسؤول عن:

🧠 جملة تحفظها

Cubit controls state, not logic

Cubit controls state, not logic