ff0f812e00
Pure Dart A1a artifact domain slice mirroring web/src/artifacts.js and artifactNavigation.js: record parsing, capture facts, stage/visit grouping, public attribution, kind vocabulary, summaries, viewer paging and safe artifact url resolution. Tests mirror the domain directory; nothing is wired into a screen or transport.
68 lines
2.5 KiB
Dart
68 lines
2.5 KiB
Dart
import '../../../core/api_gateway.dart';
|
|
import 'artifact_record.dart';
|
|
|
|
/// Parses one step's recorded artifact list. An absent, null or malformed list
|
|
/// yields no records; the capture state (and its unavailable wording) is
|
|
/// reported by `artifact_capture.dart`, never treated as an empty capture here.
|
|
List<ArtifactRecord> artifactsOf(JsonMap step) {
|
|
final value = step['artifacts'];
|
|
if (value is! List) return const <ArtifactRecord>[];
|
|
return <ArtifactRecord>[
|
|
for (final item in value)
|
|
if (item is Map) ArtifactRecord.fromJson(Map<String, dynamic>.from(item)),
|
|
];
|
|
}
|
|
|
|
/// The html names a visit's session-export repairs produced.
|
|
Set<String> repairArtifactNames(JsonMap step) {
|
|
final value = step['session_export_repairs'];
|
|
if (value is! List) return const <String>{};
|
|
return <String>{
|
|
for (final entry in value)
|
|
if (entry is Map &&
|
|
entry['html'] is String &&
|
|
'${entry['html']}'.trim().isNotEmpty)
|
|
'${entry['html']}',
|
|
};
|
|
}
|
|
|
|
/// The artifacts of one visit as presented: the recorded files with the retired
|
|
/// markdown session export filtered out. Duplicate names are kept because an
|
|
/// artifact's identity is its recorded url, not its name.
|
|
List<ArtifactRecord> presentedArtifacts(Iterable<ArtifactRecord> artifacts) {
|
|
return <ArtifactRecord>[
|
|
for (final artifact in artifacts)
|
|
if (!artifact.isLegacySessionMarkdown) artifact,
|
|
];
|
|
}
|
|
|
|
/// A visit's stage-produced artifacts: everything except the turn-owned files
|
|
/// and repaired session exports. Order is preserved.
|
|
List<ArtifactRecord> stageArtifactsFrom(
|
|
Iterable<ArtifactRecord> artifacts, {
|
|
Set<String> repairs = const <String>{},
|
|
}) {
|
|
return <ArtifactRecord>[
|
|
for (final artifact in presentedArtifacts(artifacts))
|
|
if (!artifact.isSystem && !repairs.contains(artifact.name)) artifact,
|
|
];
|
|
}
|
|
|
|
/// A visit's system files and repaired exports, in recorded order.
|
|
List<ArtifactRecord> systemArtifactsFrom(
|
|
Iterable<ArtifactRecord> artifacts, {
|
|
Set<String> repairs = const <String>{},
|
|
}) {
|
|
return <ArtifactRecord>[
|
|
for (final artifact in presentedArtifacts(artifacts))
|
|
if (artifact.isSystem || repairs.contains(artifact.name)) artifact,
|
|
];
|
|
}
|
|
|
|
/// Convenience for callers holding a raw step rather than parsed records.
|
|
List<ArtifactRecord> stageArtifacts(JsonMap step) =>
|
|
stageArtifactsFrom(artifactsOf(step), repairs: repairArtifactNames(step));
|
|
|
|
List<ArtifactRecord> systemArtifacts(JsonMap step) =>
|
|
systemArtifactsFrom(artifactsOf(step), repairs: repairArtifactNames(step));
|