// lib/services/local_storage_service.dart import 'dart:io'; import 'dart:convert'; import 'package:flutter/foundation.dart'; import 'package:path_provider/path_provider.dart'; import 'package:permission_handler/permission_handler.dart'; import 'package:path/path.dart' as p; // --- ADDED: Import dio for downloading --- import 'package:dio/dio.dart'; import '../models/air_installation_data.dart'; import '../models/air_collection_data.dart'; import '../models/tarball_data.dart'; import '../models/in_situ_sampling_data.dart'; import '../models/river_in_situ_sampling_data.dart'; /// A comprehensive service for handling all local data storage for offline submissions. class LocalStorageService { // ======================================================================= // Part 1: Public Storage Setup // ======================================================================= Future _requestPermissions() async { var status = await Permission.manageExternalStorage.request(); return status.isGranted; } // --- MODIFIED: This method now accepts a serverName to create a server-specific root directory. --- Future _getPublicMMSV4Directory({required String serverName}) async { if (await _requestPermissions()) { final Directory? externalDir = await getExternalStorageDirectory(); if (externalDir != null) { final publicRootPath = externalDir.path.split('/Android/')[0]; // Create a subdirectory for the specific server configuration. // If serverName is empty, it returns the root MMSV4 folder. final mmsv4Dir = Directory(p.join(publicRootPath, 'MMSV4', serverName)); if (!await mmsv4Dir.exists()) { await mmsv4Dir.create(recursive: true); } return mmsv4Dir; } } debugPrint("LocalStorageService: Manage External Storage permission was not granted."); return null; } // --- ADDED: A public method to retrieve the root log directory. --- Future getLogDirectory({required String serverName, required String module, required String subModule}) async { final mmsv4Dir = await _getPublicMMSV4Directory(serverName: serverName); if (mmsv4Dir == null) return null; final logDir = Directory(p.join(mmsv4Dir.path, module, subModule)); if (!await logDir.exists()) { await logDir.create(recursive: true); } return logDir; } // ======================================================================= // Part 2: Air Manual Sampling Methods (LOGGING RESTORED) // ======================================================================= // --- MODIFIED: Method now requires serverName to get the correct base directory. --- Future _getAirManualBaseDir({required String serverName}) async { final mmsv4Dir = await _getPublicMMSV4Directory(serverName: serverName); if (mmsv4Dir == null) return null; final airDir = Directory(p.join(mmsv4Dir.path, 'air', 'air_manual_sampling')); if (!await airDir.exists()) { await airDir.create(recursive: true); } return airDir; } /// Saves or updates an air sampling record, including copying all associated images to permanent local storage. // --- MODIFIED: Method now requires serverName. --- Future saveAirSamplingRecord(Map data, String refID, {required String serverName}) async { final baseDir = await _getAirManualBaseDir(serverName: serverName); if (baseDir == null) { debugPrint("Could not get public storage directory for Air Manual. Check permissions."); return null; } try { final eventDir = Directory(p.join(baseDir.path, refID)); if (!await eventDir.exists()) { await eventDir.create(recursive: true); } // Helper function to copy a file and return its new, permanent path Future copyImageToLocal(dynamic imageFile) async { if (imageFile is! File) return null; // Gracefully handle non-File types try { // Check if the file is already in the permanent directory to avoid re-copying if (p.dirname(imageFile.path) == eventDir.path) { return imageFile.path; } final String fileName = p.basename(imageFile.path); final File newFile = await imageFile.copy(p.join(eventDir.path, fileName)); return newFile.path; } catch (e) { debugPrint("Error copying file ${imageFile.path}: $e"); return null; } } // Create a mutable copy of the data map to avoid modifying the original final Map serializableData = Map.from(data); // --- MODIFIED: Inject the server name into the data being saved. --- serializableData['serverConfigName'] = serverName; // Define the keys for installation images to look for in the map final installationImageKeys = ['imageFront', 'imageBack', 'imageLeft', 'imageRight', 'optionalImage1', 'optionalImage2', 'optionalImage3', 'optionalImage4']; // Process top-level (installation) images for (final key in installationImageKeys) { // Check if the key exists and the value is a File object if (serializableData.containsKey(key) && serializableData[key] is File) { final newPath = await copyImageToLocal(serializableData[key]); serializableData['${key}Path'] = newPath; // Creates 'imageFrontPath', etc. // Note: DO NOT remove the original key here if it holds a File object. // The copy is needed for local storage/DB logging, but the File object must stay // on the key if other process calls `toMap()` again. // However, based on the previous logic, we rely on the caller passing a map // that separates File objects from paths for DB logging. } } // Process nested collection images, if they exist if (serializableData['collectionData'] is Map) { final collectionMap = Map.from(serializableData['collectionData']); final collectionImageKeys = ['imageFront', 'imageBack', 'imageLeft', 'imageRight', 'imageChart', 'imageFilterPaper', 'optionalImage1', 'optionalImage2', 'optionalImage3', 'optionalImage4']; for (final key in collectionImageKeys) { if (collectionMap.containsKey(key) && collectionMap[key] is File) { final newPath = await copyImageToLocal(collectionMap[key]); collectionMap['${key}Path'] = newPath; } } serializableData['collectionData'] = collectionMap; } // CRITICAL FIX: Ensure the JSON data only contains serializable (non-File) objects // We must strip the File objects before encoding, as they have now been copied. final Map finalData = Map.from(serializableData); // Recursive helper to remove File objects before JSON encoding void cleanMap(Map map) { map.removeWhere((key, value) => value is File); map.forEach((key, value) { if (value is Map) cleanMap(value as Map); }); } // Since the caller (_toMapForLocalSave) only passes a map with File objects on the image keys, // and paths on the *Path keys*, simply removing the File keys and encoding is sufficient. finalData.removeWhere((key, value) => value is File); if (finalData.containsKey('collectionData') && finalData['collectionData'] is Map) { cleanMap(finalData['collectionData'] as Map); } final jsonFile = File(p.join(eventDir.path, 'data.json')); await jsonFile.writeAsString(jsonEncode(finalData)); debugPrint("Air sampling log and images saved to: ${eventDir.path}"); return eventDir.path; } catch (e, s) { debugPrint("Error saving air sampling log to local storage: $e"); debugPrint("Stack trace: $s"); return null; } } // --- MODIFIED: This method now scans all server subdirectories to find all logs. --- Future>> getAllAirSamplingLogs() async { final mmsv4Root = await _getPublicMMSV4Directory(serverName: ''); // Get root MMSV4 without a server subfolder if (mmsv4Root == null || !await mmsv4Root.exists()) return []; final List> allLogs = []; final serverDirs = mmsv4Root.listSync().whereType(); for (var serverDir in serverDirs) { final baseDir = Directory(p.join(serverDir.path, 'air', 'air_manual_sampling')); if (!await baseDir.exists()) continue; try { final entities = baseDir.listSync(); for (var entity in entities) { if (entity is Directory) { final jsonFile = File(p.join(entity.path, 'data.json')); if (await jsonFile.exists()) { final content = await jsonFile.readAsString(); final data = jsonDecode(content) as Map; data['logDirectory'] = entity.path; allLogs.add(data); } } } } catch (e) { debugPrint("Error reading air logs from ${baseDir.path}: $e"); } } return allLogs; } // ======================================================================= // Part 3: Tarball Specific Methods (LOGGING RESTORED) // ======================================================================= Future _getTarballBaseDir({required String serverName}) async { final mmsv4Dir = await _getPublicMMSV4Directory(serverName: serverName); if (mmsv4Dir == null) return null; final tarballDir = Directory(p.join(mmsv4Dir.path, 'marine', 'marine_tarball_sampling')); if (!await tarballDir.exists()) { await tarballDir.create(recursive: true); } return tarballDir; } Future saveTarballSamplingData(TarballSamplingData data, {required String serverName}) async { final baseDir = await _getTarballBaseDir(serverName: serverName); if (baseDir == null) { debugPrint("Could not get public storage directory. Check permissions."); return null; } try { final stationCode = data.selectedStation?['tbl_station_code'] ?? 'UNKNOWN_STATION'; final timestamp = "${data.samplingDate}_${data.samplingTime?.replaceAll(':', '-')}"; final eventFolderName = "${stationCode}_$timestamp"; final eventDir = Directory(p.join(baseDir.path, eventFolderName)); if (!await eventDir.exists()) { await eventDir.create(recursive: true); } final Map jsonData = { ...data.toFormData(), 'submissionStatus': data.submissionStatus, 'submissionMessage': data.submissionMessage, 'reportId': data.reportId }; jsonData['serverConfigName'] = serverName; jsonData['selectedStation'] = data.selectedStation; final imageFiles = data.toImageFiles(); for (var entry in imageFiles.entries) { final File? imageFile = entry.value; if (imageFile != null) { final String originalFileName = p.basename(imageFile.path); final File newFile = await imageFile.copy(p.join(eventDir.path, originalFileName)); jsonData[entry.key] = newFile.path; } } final jsonFile = File(p.join(eventDir.path, 'data.json')); await jsonFile.writeAsString(jsonEncode(jsonData)); debugPrint("Tarball log saved to: ${jsonFile.path}"); return eventDir.path; } catch (e) { debugPrint("Error saving tarball log to local storage: $e"); return null; } } Future>> getAllTarballLogs() async { final mmsv4Root = await _getPublicMMSV4Directory(serverName: ''); if (mmsv4Root == null || !await mmsv4Root.exists()) return []; final List> allLogs = []; final serverDirs = mmsv4Root.listSync().whereType(); for (var serverDir in serverDirs) { final baseDir = Directory(p.join(serverDir.path, 'marine', 'marine_tarball_sampling')); if (!await baseDir.exists()) continue; try { final entities = baseDir.listSync(); for (var entity in entities) { if (entity is Directory) { final jsonFile = File(p.join(entity.path, 'data.json')); if (await jsonFile.exists()) { final content = await jsonFile.readAsString(); final data = jsonDecode(content) as Map; data['logDirectory'] = entity.path; allLogs.add(data); } } } } catch (e) { debugPrint("Error reading tarball logs from ${baseDir.path}: $e"); } } return allLogs; } Future updateTarballLog(Map updatedLogData) async { final logDir = updatedLogData['logDirectory']; if (logDir == null) { debugPrint("Cannot update log: logDirectory key is missing."); return; } try { final jsonFile = File(p.join(logDir, 'data.json')); if (await jsonFile.exists()) { updatedLogData.remove('isResubmitting'); await jsonFile.writeAsString(jsonEncode(updatedLogData)); debugPrint("Log updated successfully at: ${jsonFile.path}"); } } catch (e) { debugPrint("Error updating tarball log: $e"); } } // ======================================================================= // Part 4: Marine In-Situ Specific Methods (LOGGING RESTORED) // ======================================================================= // --- MODIFIED: Removed leading underscore to make the method public --- Future getInSituBaseDir({required String serverName}) async { final mmsv4Dir = await _getPublicMMSV4Directory(serverName: serverName); if (mmsv4Dir == null) return null; final inSituDir = Directory(p.join(mmsv4Dir.path, 'marine', 'marine_in_situ_sampling')); if (!await inSituDir.exists()) { await inSituDir.create(recursive: true); } return inSituDir; } Future saveInSituSamplingData(InSituSamplingData data, {required String serverName}) async { final baseDir = await getInSituBaseDir(serverName: serverName); if (baseDir == null) { debugPrint("Could not get public storage directory for In-Situ. Check permissions."); return null; } try { final stationCode = data.selectedStation?['man_station_code'] ?? 'UNKNOWN_STATION'; final timestamp = "${data.samplingDate}_${data.samplingTime?.replaceAll(':', '-')}"; final eventFolderName = "${stationCode}_$timestamp"; final eventDir = Directory(p.join(baseDir.path, eventFolderName)); if (!await eventDir.exists()) { await eventDir.create(recursive: true); } final Map jsonData = { ...data.toApiFormData(), 'submissionStatus': data.submissionStatus, 'submissionMessage': data.submissionMessage, 'reportId': data.reportId }; jsonData['serverConfigName'] = serverName; jsonData['selectedStation'] = data.selectedStation; final imageFiles = data.toApiImageFiles(); for (var entry in imageFiles.entries) { final File? imageFile = entry.value; if (imageFile != null) { final String originalFileName = p.basename(imageFile.path); final File newFile = await imageFile.copy(p.join(eventDir.path, originalFileName)); jsonData[entry.key] = newFile.path; } } final jsonFile = File(p.join(eventDir.path, 'data.json')); await jsonFile.writeAsString(jsonEncode(jsonData)); debugPrint("In-Situ log saved to: ${jsonFile.path}"); return eventDir.path; } catch (e) { debugPrint("Error saving In-Situ log to local storage: $e"); return null; } } Future>> getAllInSituLogs() async { final mmsv4Root = await _getPublicMMSV4Directory(serverName: ''); if (mmsv4Root == null || !await mmsv4Root.exists()) return []; final List> allLogs = []; final serverDirs = mmsv4Root.listSync().whereType(); for (var serverDir in serverDirs) { final baseDir = Directory(p.join(serverDir.path, 'marine', 'marine_in_situ_sampling')); if (!await baseDir.exists()) continue; try { final entities = baseDir.listSync(); for (var entity in entities) { if (entity is Directory) { final jsonFile = File(p.join(entity.path, 'data.json')); if (await jsonFile.exists()) { final content = await jsonFile.readAsString(); final data = jsonDecode(content) as Map; data['logDirectory'] = entity.path; allLogs.add(data); } } } } catch (e) { debugPrint("Error reading in-situ logs from ${baseDir.path}: $e"); } } return allLogs; } Future updateInSituLog(Map updatedLogData) async { final logDir = updatedLogData['logDirectory']; if (logDir == null) { debugPrint("Cannot update log: logDirectory key is missing."); return; } try { final jsonFile = File(p.join(logDir, 'data.json')); if (await jsonFile.exists()) { updatedLogData.remove('isResubmitting'); await jsonFile.writeAsString(jsonEncode(updatedLogData)); debugPrint("Log updated successfully at: ${jsonFile.path}"); } } catch (e) { debugPrint("Error updating in-situ log: $e"); } } // ======================================================================= // Part 5: River In-Situ Specific Methods (LOGGING RESTORED) // ======================================================================= Future getRiverInSituBaseDir(String? samplingType, {required String serverName}) async { final mmsv4Dir = await _getPublicMMSV4Directory(serverName: serverName); if (mmsv4Dir == null) return null; String subfolderName; if (samplingType == 'Schedule' || samplingType == 'Triennial') { subfolderName = samplingType!; } else { subfolderName = 'Others'; } final inSituDir = Directory(p.join(mmsv4Dir.path, 'river', 'river_in_situ_sampling', subfolderName)); if (!await inSituDir.exists()) { await inSituDir.create(recursive: true); } return inSituDir; } Future saveRiverInSituSamplingData(RiverInSituSamplingData data, {required String serverName}) async { final baseDir = await getRiverInSituBaseDir(data.samplingType, serverName: serverName); if (baseDir == null) { debugPrint("Could not get public storage directory for River In-Situ. Check permissions."); return null; } try { final stationCode = data.selectedStation?['sampling_station_code'] ?? 'UNKNOWN_STATION'; final timestamp = "${data.samplingDate}_${data.samplingTime?.replaceAll(':', '-')}"; final eventFolderName = "${stationCode}_$timestamp"; final eventDir = Directory(p.join(baseDir.path, eventFolderName)); if (!await eventDir.exists()) { await eventDir.create(recursive: true); } final Map jsonData = { ...data.toApiFormData(), 'submissionStatus': data.submissionStatus, 'submissionMessage': data.submissionMessage, 'reportId': data.reportId }; jsonData['serverConfigName'] = serverName; jsonData['selectedStation'] = data.selectedStation; final imageFiles = data.toApiImageFiles(); for (var entry in imageFiles.entries) { final File? imageFile = entry.value; if (imageFile != null) { final String originalFileName = p.basename(imageFile.path); final File newFile = await imageFile.copy(p.join(eventDir.path, originalFileName)); jsonData[entry.key] = newFile.path; } } final jsonFile = File(p.join(eventDir.path, 'data.json')); await jsonFile.writeAsString(jsonEncode(jsonData)); debugPrint("River In-Situ log saved to: ${jsonFile.path}"); return eventDir.path; } catch (e) { debugPrint("Error saving River In-Situ log to local storage: $e"); return null; } } Future>> getAllRiverInSituLogs() async { final mmsv4Root = await _getPublicMMSV4Directory(serverName: ''); if (mmsv4Root == null || !await mmsv4Root.exists()) return []; final List> allLogs = []; final serverDirs = mmsv4Root.listSync().whereType(); for (var serverDir in serverDirs) { final topLevelDir = Directory(p.join(serverDir.path, 'river', 'river_in_situ_sampling')); if (!await topLevelDir.exists()) continue; try { final typeSubfolders = topLevelDir.listSync(); for (var typeSubfolder in typeSubfolders) { if (typeSubfolder is Directory) { final eventFolders = typeSubfolder.listSync(); for (var eventFolder in eventFolders) { if (eventFolder is Directory) { final jsonFile = File(p.join(eventFolder.path, 'data.json')); if (await jsonFile.exists()) { final content = await jsonFile.readAsString(); final data = jsonDecode(content) as Map; data['logDirectory'] = eventFolder.path; allLogs.add(data); } } } } } } catch (e) { debugPrint("Error getting all river in-situ logs from ${topLevelDir.path}: $e"); } } return allLogs; } Future updateRiverInSituLog(Map updatedLogData) async { final logDir = updatedLogData['logDirectory']; if (logDir == null) { debugPrint("Cannot update log: logDirectory key is missing."); return; } try { final jsonFile = File(p.join(logDir, 'data.json')); if (await jsonFile.exists()) { updatedLogData.remove('isResubmitting'); await jsonFile.writeAsString(jsonEncode(updatedLogData)); debugPrint("Log updated successfully at: ${jsonFile.path}"); } } catch (e) { debugPrint("Error updating river in-situ log: $e"); } } // ======================================================================= // --- ADDED: Part 6: Info Centre Document Management --- // ======================================================================= final Dio _dio = Dio(); /// Gets the directory for storing Info Centre documents, creating it if it doesn't exist. Future _getInfoCentreDocumentsDirectory() async { // We use serverName: '' to ensure documents are stored in a common root MMSV4 folder, not server-specific ones. final mmsv4Dir = await _getPublicMMSV4Directory(serverName: ''); if (mmsv4Dir == null) return null; final docDir = Directory(p.join(mmsv4Dir.path, 'info_centre_documents')); if (!await docDir.exists()) { await docDir.create(recursive: true); } return docDir; } /// Constructs the full local file path for a given document URL. Future getLocalDocumentPath(String docUrl) async { final docDir = await _getInfoCentreDocumentsDirectory(); if (docDir == null) return null; final fileName = p.basename(docUrl); return p.join(docDir.path, fileName); } /// Checks if a document has already been downloaded. Future isDocumentDownloaded(String docUrl) async { final filePath = await getLocalDocumentPath(docUrl); if (filePath == null) return false; return await File(filePath).exists(); } /// Downloads a document from a URL and saves it to the local `MMSV4/info_centre_documents` folder. Future downloadDocument({ required String docUrl, required Function(double) onReceiveProgress, }) async { final filePath = await getLocalDocumentPath(docUrl); if (filePath == null) { throw Exception("Could not get local storage path. Check permissions."); } try { await _dio.download( docUrl, filePath, onReceiveProgress: (received, total) { if (total != -1) { onReceiveProgress(received / total); } }, ); } catch (e) { // If the download fails, delete the partially downloaded file to prevent corruption. final file = File(filePath); if (await file.exists()) { await file.delete(); } throw Exception("Download failed: $e"); } } }