save method

Future<SavedRoomScan> save({
  1. required String name,
  2. required ScanResult scanResult,
  3. File? pdfFile,
  4. File? modelFile,
})

Saves a new scan and copies any provided outputs into the library.

The USDZ is copied immediately so it is no longer dependent on the operating system's temporary-directory retention. A fresh ID is generated for every save.

Implementation

Future<SavedRoomScan> save({
  required String name,
  required ScanResult scanResult,
  File? pdfFile,
  File? modelFile,
}) async {
  final cleanName = name.trim();
  if (cleanName.isEmpty) {
    throw ArgumentError.value(name, 'name', 'A scan name is required.');
  }

  final id = _newId();
  final directory = await _entryDirectory(id);
  await directory.create(recursive: true);
  final createdAt = DateTime.now().toUtc();
  File? savedPdf;
  File? savedModel;

  try {
    if (pdfFile != null) {
      savedPdf = await _copyOutput(pdfFile, directory, 'floor-plan.pdf');
    }
    if (modelFile != null) {
      savedModel = await _copyOutput(modelFile, directory, 'room-model.usdz');
    }
    await _writeRecord(
      directory,
      id: id,
      name: cleanName,
      createdAt: createdAt,
      scanResult: scanResult,
      pdfName: savedPdf?.uri.pathSegments.last,
      modelName: savedModel?.uri.pathSegments.last,
    );
  } catch (_) {
    if (await directory.exists()) await directory.delete(recursive: true);
    rethrow;
  }

  return SavedRoomScan(
    id: id,
    name: cleanName,
    createdAt: createdAt,
    scanResult: scanResult,
    pdfFile: savedPdf,
    modelFile: savedModel,
  );
}