Cloud Storage — رفع الملفات وتنزيلها

import 'package:firebase_storage/firebase_storage.dart';

// مرجع الجذر
final storageRef = FirebaseStorage.instance.ref();

// مرجع لمسار متداخل
final imageRef = storageRef.child('users/uid123/avatar.jpg');

// أو بناء المسار الكامل مباشرةً
final fileRef = FirebaseStorage.instance.ref('uploads/documents/resume.pdf');

import 'dart:io';
import 'package:firebase_storage/firebase_storage.dart';

Future<String> uploadImageFile(File imageFile, String userId) async {
  // بناء مسار تخزين فريد
  final fileName = '${DateTime.now().millisecondsSinceEpoch}.jpg';
  final ref = FirebaseStorage.instance.ref('avatars/$userId/$fileName');

  // تعيين بيانات وصفية اختيارية
  final metadata = SettableMetadata(
    contentType: 'image/jpeg',
    customMetadata: {'uploadedBy': userId},
  );

  // بدء الرفع — تعيد UploadTask
  final uploadTask = ref.putFile(imageFile, metadata);

  // انتظار الاكتمال والحصول على TaskSnapshot
  final snapshot = await uploadTask;

  // استرداد رابط التنزيل العام
  final downloadUrl = await snapshot.ref.getDownloadURL();
  return downloadUrl;
}

import 'dart:typed_data';
import 'package:firebase_storage/firebase_storage.dart';

Future<String> uploadBytes(Uint8List bytes, String path) async {
  final ref = FirebaseStorage.instance.ref(path);

  final metadata = SettableMetadata(contentType: 'image/png');
  final uploadTask = ref.putData(bytes, metadata);

  final snapshot = await uploadTask;
  return await snapshot.ref.getDownloadURL();
}

class UploadProgressWidget extends StatefulWidget {
  final File file;
  const UploadProgressWidget({super.key, required this.file});

  @override
  State<UploadProgressWidget> createState() => _UploadProgressWidgetState();
}

class _UploadProgressWidgetState extends State<UploadProgressWidget> {
  double _progress = 0.0;
  String _status = 'Idle';
  String? _downloadUrl;

  Future<void> _startUpload() async {
    final ref = FirebaseStorage.instance
        .ref('uploads/${DateTime.now().millisecondsSinceEpoch}.jpg');

    final task = ref.putFile(widget.file);

    // الاستماع إلى snapshotEvents لمتابعة التقدم
    task.snapshotEvents.listen((TaskSnapshot snapshot) {
      if (!mounted) return;
      setState(() {
        _progress = snapshot.bytesTransferred / snapshot.totalBytes;
        _status = snapshot.state == TaskState.running
            ? 'جاري الرفع...'
            : snapshot.state.name;
      });
    });

    // انتظار المهمة للحصول على اللقطة النهائية
    final finalSnapshot = await task;
    final url = await finalSnapshot.ref.getDownloadURL();
    if (mounted) {
      setState(() {
        _downloadUrl = url;
        _status = 'تم';
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      mainAxisAlignment: MainAxisAlignment.center,
      children: [
        Text('الحالة: $_status'),
        const SizedBox(height: 8),
        LinearProgressIndicator(value: _progress),
        const SizedBox(height: 8),
        if (_downloadUrl != null)
          Image.network(_downloadUrl!, height: 200),
        const SizedBox(height: 16),
        ElevatedButton(
          onPressed: _startUpload,
          child: const Text('رفع الملف'),
        ),
      ],
    );
  }
}

Future<void> loadAvatar(String userId) async {
  try {
    final ref = FirebaseStorage.instance.ref('avatars/$userId/avatar.jpg');
    final url = await ref.getDownloadURL();
    // url هو رابط HTTPS كامل — استخدمه في أي مكان
    print('رابط الصورة الشخصية: $url');
  } on FirebaseException catch (e) {
    if (e.code == 'object-not-found') {
      print('لم يتم رفع صورة شخصية بعد.');
    } else {
      rethrow;
    }
  }
}

Future<Uint8List?> downloadBytes(String storagePath) async {
  final ref = FirebaseStorage.instance.ref(storagePath);
  // تعيد null إذا لم يكن الملف موجوداً؛ مرر حد أقصى للبايتات
  final Uint8List? data = await ref.getData(10 * 1024 * 1024); // حد 10 ميغابايت
  return data;
}