database, server: Simpler and more efficient API

database/lib/musicus_database.dart

@@ -1 +1,2 @@
-export 'src/database.dart';
+export 'src/database.dart';
+export 'src/info.dart';

database/lib/src/database.dart

@@ -2,6 +2,8 @@ import 'dart:math';
 
 import 'package:moor/moor.dart';
 
+import 'info.dart';
+
 part 'database.g.dart';
 
 final _random = Random(DateTime.now().millisecondsSinceEpoch);
@@ -99,6 +101,50 @@ class Database extends _$Database {
     await into(instruments).insert(instrument, orReplace: true);
   }
 
+  /// Retrieve more information on an already queried work.
+  Future<WorkInfo> getWorkInfo(Work work) async {
+    final id = work.id;
+
+    final composers = await composersByWork(id).get();
+    final instruments = await instrumentsByWork(id).get();
+
+    final List<PartInfo> parts = [];
+    for (final part in await workParts(id).get()) {
+      parts.add(PartInfo(
+        work: part,
+        composer: part.composer != null
+            ? await personById(part.composer).getSingle()
+            : null,
+        instruments: await instrumentsByWork(id).get(),
+      ));
+    }
+
+    return WorkInfo(
+      work: work,
+      instruments: instruments,
+      composers: composers,
+      parts: parts,
+    );
+  }
+
+  /// Get all available information on a work.
+  Future<WorkInfo> getWork(int id) async {
+    final work = await workById(id).getSingle();
+    return await getWorkInfo(work);
+  }
+
+  /// Get information on all works written by the person with ID [personId].
+  Future<List<WorkInfo>> getWorks(int personId) async {
+    final works = await worksByComposer(personId).get();
+
+    final List<WorkInfo> result = [];
+    for (final work in works) {
+      result.add(await getWorkInfo(work));
+    }
+
+    return result;
+  }
+
   Future<void> updateWork(WorkData data) async {
     await transaction(() async {
       final workId = data.data.work.id;
@@ -137,4 +183,47 @@ class Database extends _$Database {
       }
     });
   }
+
+  /// Retreive more information on an already queried recording.
+  Future<RecordingInfo> getRecordingInfo(Recording recording) async {
+    final id = recording.id;
+
+    final List<PerformanceInfo> performances = [];
+    for (final performance in await performancesByRecording(id).get()) {
+      performances.add(PerformanceInfo(
+        person: performance.person != null
+            ? await personById(performance.person).getSingle()
+            : null,
+        ensemble: performance.ensemble != null
+            ? await ensembleById(performance.ensemble).getSingle()
+            : null,
+        role: performance.role != null
+            ? await instrumentById(performance.role).getSingle()
+            : null,
+      ));
+    }
+
+    return RecordingInfo(
+      recording: recording,
+      performances: performances,
+    );
+  }
+
+  /// Get all available information on a recording.
+  Future<RecordingInfo> getRecording(int id) async {
+    final recording = await recordingById(id).getSingle();
+    return await getRecordingInfo(recording);
+  }
+
+  /// Get information on all recordings of the work with ID [workId].
+  Future<List<RecordingInfo>> getRecordings(int workId) async {
+    final recordings = await recordingsByWork(workId).get();
+
+    final List<RecordingInfo> result = [];
+    for (final recording in recordings) {
+      result.add(await getRecordingInfo(recording));
+    }
+
+    return result;
+  }
 }

database/lib/src/info.dart

@@ -0,0 +1,149 @@
+import 'database.dart';
+
+/// A bundle of all available information on a work part.
+class PartInfo {
+  /// The work part itself.
+  final Work work;
+
+  /// A list of instruments.
+  ///
+  /// This will include the instruments, that are specific to this part.
+  final List<Instrument> instruments;
+
+  /// The composer of this part.
+  /// 
+  /// This is null, if this part doesn't have a specific composer.
+  final Person composer;
+
+  PartInfo({
+    this.work,
+    this.instruments,
+    this.composer,
+  });
+
+  factory PartInfo.fromJson(Map<String, dynamic> json) => PartInfo(
+        work: Work.fromJson(json['work']),
+        instruments: json['instruments']
+            .map<Instrument>((j) => Instrument.fromJson(j))
+            .toList(),
+        composer:
+            json['composer'] != null ? Person.fromJson(json['composer']) : null,
+      );
+
+  Map<String, dynamic> toJson() => {
+        'work': work.toJson(),
+        'instruments': instruments.map((i) => i.toJson()).toList(),
+        'composers': composer?.toJson(),
+      };
+}
+
+/// A bundle information on a work.
+///
+/// This includes all available information except for recordings of this work.
+class WorkInfo {
+  /// The work itself.
+  final Work work;
+
+  /// A list of instruments.
+  /// 
+  /// This will not the include the instruments, that are specific to the work
+  /// parts.
+  final List<Instrument> instruments;
+
+  /// A list of persons, which will include all part composers.
+  final List<Person> composers;
+
+  /// All available information on the work parts.
+  final List<PartInfo> parts;
+
+  WorkInfo({
+    this.work,
+    this.instruments,
+    this.composers,
+    this.parts,
+  });
+
+  factory WorkInfo.fromJson(Map<String, dynamic> json) => WorkInfo(
+        work: Work.fromJson(json['work']),
+        instruments: json['instruments']
+            .map<Instrument>((j) => Instrument.fromJson(j))
+            .toList(),
+        composers:
+            json['composers'].map<Person>((j) => Person.fromJson(j)).toList(),
+        parts:
+            json['parts'].map<WorkInfo>((j) => WorkInfo.fromJson(j)).toList(),
+      );
+
+  Map<String, dynamic> toJson() => {
+        'work': work.toJson(),
+        'instruments': instruments.map((i) => i.toJson()).toList(),
+        'composers': composers.map((c) => c.toJson()).toList(),
+        'parts': parts.map((c) => c.toJson()).toList(),
+      };
+}
+
+/// All available information on a performance within a recording.
+class PerformanceInfo {
+  /// The performing person.
+  ///
+  /// This will be null, if this is an ensemble.
+  final Person person;
+
+  /// The performing ensemble.
+  ///
+  /// This will be null, if this is a person.
+  final Ensemble ensemble;
+
+  /// The instrument/role or null.
+  final Instrument role;
+
+  PerformanceInfo({
+    this.person,
+    this.ensemble,
+    this.role,
+  });
+
+  factory PerformanceInfo.fromJson(Map<String, dynamic> json) =>
+      PerformanceInfo(
+        person: json['person'] != null ? Person.fromJson(json['person']) : null,
+        ensemble: json['ensemble'] != null
+            ? Ensemble.fromJson(json['ensemble'])
+            : null,
+        role: json['role'] != null ? Instrument.fromJson(json['role']) : null,
+      );
+
+  Map<String, dynamic> toJson() => {
+        'person': person?.toJson(),
+        'ensemble': ensemble?.toJson(),
+        'role': role?.toJson(),
+      };
+}
+
+/// All available information on a recording.
+///
+/// This doesn't include the recorded work, because probably it's already
+/// available.
+class RecordingInfo {
+  /// The recording itself.
+  final Recording recording;
+
+  /// Information on the performances within this recording.
+  final List<PerformanceInfo> performances;
+
+  RecordingInfo({
+    this.recording,
+    this.performances,
+  });
+
+  factory RecordingInfo.fromJson(Map<String, dynamic> json) => RecordingInfo(
+        recording: Recording.fromJson(json['recording']),
+        performances: json['performances']
+            .map<PerformanceInfo>((j) => PerformanceInfo.fromJson(j))
+            .toList(),
+      );
+
+  Map<String, dynamic> toJson() => {
+        'recording': recording.toJson(),
+        'performances': performances.map((p) => p.toJson()).toList(),
+      };
+}