feat: original-sized previews for non-web-friendly images (#14446)

* feat(server): extract full-size previews from RAW images

* feat(web): load fullsize preview for RAW images when zoomed in

* refactor: tweaks for code review

* refactor: rename "converted" preview/assets to "fullsize"

* feat(web/server): fullsize preview for non-web-friendly images

* feat: tweaks for code review

* feat(server): require ASSET_DOWNLOAD premission for fullsize previews

* test: fix types and interfaces

* chore: gen open-api

* feat(server): keep only essential exif in fullsize preview

* chore: regen openapi

* test: revert unnecessary timeout

* feat: move full-size preview config to standalone entry

* feat(i18n): update en texts

* fix: don't return fullsizePath when disabled

* test: full-size previews

* test(web): full-size previews

* chore: make open-api

* feat(server): redirect to preview/original URL when fullsize thumbnail not available

* fix(server): delete fullsize preview image on thumbnail regen after fullsize preview turned off

* refactor(server): AssetRepository.deleteFiles with Kysely

* fix(server): type of MediaRepository.writeExif

* minor simplification

* minor styling changes and condensed wording

* simplify

* chore: reuild open-api

* test(server): fix media.service tests

* test(web): fix photo-viewer test

* fix(server):  use fullsize image when requested

* fix file path extension

* formatting

* use fullsize when zooming back out or when "display original photos" is enabled

* simplify condition

---------

Co-authored-by: mertalev <101130780+mertalev@users.noreply.github.com>

mobile/openapi/lib/api.dart

@@ -245,6 +245,7 @@ part 'model/system_config_backups_dto.dart';
 part 'model/system_config_dto.dart';
 part 'model/system_config_f_fmpeg_dto.dart';
 part 'model/system_config_faces_dto.dart';
+part 'model/system_config_generated_fullsize_image_dto.dart';
 part 'model/system_config_generated_image_dto.dart';
 part 'model/system_config_image_dto.dart';
 part 'model/system_config_job_dto.dart';

mobile/openapi/lib/api_client.dart

@@ -546,6 +546,8 @@ class ApiClient {
           return SystemConfigFFmpegDto.fromJson(value);
         case 'SystemConfigFacesDto':
           return SystemConfigFacesDto.fromJson(value);
+        case 'SystemConfigGeneratedFullsizeImageDto':
+          return SystemConfigGeneratedFullsizeImageDto.fromJson(value);
         case 'SystemConfigGeneratedImageDto':
           return SystemConfigGeneratedImageDto.fromJson(value);
         case 'SystemConfigImageDto':

mobile/openapi/lib/model/asset_media_size.dart

@@ -23,11 +23,13 @@ class AssetMediaSize {
 
   String toJson() => value;
 
+  static const fullsize = AssetMediaSize._(r'fullsize');
   static const preview = AssetMediaSize._(r'preview');
   static const thumbnail = AssetMediaSize._(r'thumbnail');
 
   /// List of all possible values in this [enum][AssetMediaSize].
   static const values = <AssetMediaSize>[
+    fullsize,
     preview,
     thumbnail,
   ];
@@ -68,6 +70,7 @@ class AssetMediaSizeTypeTransformer {
   AssetMediaSize? decode(dynamic data, {bool allowNull = true}) {
     if (data != null) {
       switch (data) {
+        case r'fullsize': return AssetMediaSize.fullsize;
         case r'preview': return AssetMediaSize.preview;
         case r'thumbnail': return AssetMediaSize.thumbnail;
         default:

mobile/openapi/lib/model/path_type.dart

@@ -24,6 +24,7 @@ class PathType {
   String toJson() => value;
 
   static const original = PathType._(r'original');
+  static const fullsize = PathType._(r'fullsize');
   static const preview = PathType._(r'preview');
   static const thumbnail = PathType._(r'thumbnail');
   static const encodedVideo = PathType._(r'encoded_video');
@@ -34,6 +35,7 @@ class PathType {
   /// List of all possible values in this [enum][PathType].
   static const values = <PathType>[
     original,
+    fullsize,
     preview,
     thumbnail,
     encodedVideo,
@@ -79,6 +81,7 @@ class PathTypeTypeTransformer {
     if (data != null) {
       switch (data) {
         case r'original': return PathType.original;
+        case r'fullsize': return PathType.fullsize;
         case r'preview': return PathType.preview;
         case r'thumbnail': return PathType.thumbnail;
         case r'encoded_video': return PathType.encodedVideo;

mobile/openapi/lib/model/system_config_generated_fullsize_image_dto.dart

@@ -0,0 +1,117 @@
+//
+// AUTO-GENERATED FILE, DO NOT MODIFY!
+//
+// @dart=2.18
+
+// ignore_for_file: unused_element, unused_import
+// ignore_for_file: always_put_required_named_parameters_first
+// ignore_for_file: constant_identifier_names
+// ignore_for_file: lines_longer_than_80_chars
+
+part of openapi.api;
+
+class SystemConfigGeneratedFullsizeImageDto {
+  /// Returns a new [SystemConfigGeneratedFullsizeImageDto] instance.
+  SystemConfigGeneratedFullsizeImageDto({
+    required this.enabled,
+    required this.format,
+    required this.quality,
+  });
+
+  bool enabled;
+
+  ImageFormat format;
+
+  /// Minimum value: 1
+  /// Maximum value: 100
+  int quality;
+
+  @override
+  bool operator ==(Object other) => identical(this, other) || other is SystemConfigGeneratedFullsizeImageDto &&
+    other.enabled == enabled &&
+    other.format == format &&
+    other.quality == quality;
+
+  @override
+  int get hashCode =>
+    // ignore: unnecessary_parenthesis
+    (enabled.hashCode) +
+    (format.hashCode) +
+    (quality.hashCode);
+
+  @override
+  String toString() => 'SystemConfigGeneratedFullsizeImageDto[enabled=$enabled, format=$format, quality=$quality]';
+
+  Map<String, dynamic> toJson() {
+    final json = <String, dynamic>{};
+      json[r'enabled'] = this.enabled;
+      json[r'format'] = this.format;
+      json[r'quality'] = this.quality;
+    return json;
+  }
+
+  /// Returns a new [SystemConfigGeneratedFullsizeImageDto] instance and imports its values from
+  /// [value] if it's a [Map], null otherwise.
+  // ignore: prefer_constructors_over_static_methods
+  static SystemConfigGeneratedFullsizeImageDto? fromJson(dynamic value) {
+    upgradeDto(value, "SystemConfigGeneratedFullsizeImageDto");
+    if (value is Map) {
+      final json = value.cast<String, dynamic>();
+
+      return SystemConfigGeneratedFullsizeImageDto(
+        enabled: mapValueOfType<bool>(json, r'enabled')!,
+        format: ImageFormat.fromJson(json[r'format'])!,
+        quality: mapValueOfType<int>(json, r'quality')!,
+      );
+    }
+    return null;
+  }
+
+  static List<SystemConfigGeneratedFullsizeImageDto> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <SystemConfigGeneratedFullsizeImageDto>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = SystemConfigGeneratedFullsizeImageDto.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+
+  static Map<String, SystemConfigGeneratedFullsizeImageDto> mapFromJson(dynamic json) {
+    final map = <String, SystemConfigGeneratedFullsizeImageDto>{};
+    if (json is Map && json.isNotEmpty) {
+      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
+      for (final entry in json.entries) {
+        final value = SystemConfigGeneratedFullsizeImageDto.fromJson(entry.value);
+        if (value != null) {
+          map[entry.key] = value;
+        }
+      }
+    }
+    return map;
+  }
+
+  // maps a json object with a list of SystemConfigGeneratedFullsizeImageDto-objects as value to a dart map
+  static Map<String, List<SystemConfigGeneratedFullsizeImageDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<SystemConfigGeneratedFullsizeImageDto>>{};
+    if (json is Map && json.isNotEmpty) {
+      // ignore: parameter_assignments
+      json = json.cast<String, dynamic>();
+      for (final entry in json.entries) {
+        map[entry.key] = SystemConfigGeneratedFullsizeImageDto.listFromJson(entry.value, growable: growable,);
+      }
+    }
+    return map;
+  }
+
+  /// The list of required keys that must be present in a JSON.
+  static const requiredKeys = <String>{
+    'enabled',
+    'format',
+    'quality',
+  };
+}
+

mobile/openapi/lib/model/system_config_image_dto.dart

@@ -15,6 +15,7 @@ class SystemConfigImageDto {
   SystemConfigImageDto({
     required this.colorspace,
     required this.extractEmbedded,
+    required this.fullsize,
     required this.preview,
     required this.thumbnail,
   });
@@ -23,6 +24,8 @@ class SystemConfigImageDto {
 
   bool extractEmbedded;
 
+  SystemConfigGeneratedFullsizeImageDto fullsize;
+
   SystemConfigGeneratedImageDto preview;
 
   SystemConfigGeneratedImageDto thumbnail;
@@ -31,6 +34,7 @@ class SystemConfigImageDto {
   bool operator ==(Object other) => identical(this, other) || other is SystemConfigImageDto &&
     other.colorspace == colorspace &&
     other.extractEmbedded == extractEmbedded &&
+    other.fullsize == fullsize &&
     other.preview == preview &&
     other.thumbnail == thumbnail;
 
@@ -39,16 +43,18 @@ class SystemConfigImageDto {
     // ignore: unnecessary_parenthesis
     (colorspace.hashCode) +
     (extractEmbedded.hashCode) +
+    (fullsize.hashCode) +
     (preview.hashCode) +
     (thumbnail.hashCode);
 
   @override
-  String toString() => 'SystemConfigImageDto[colorspace=$colorspace, extractEmbedded=$extractEmbedded, preview=$preview, thumbnail=$thumbnail]';
+  String toString() => 'SystemConfigImageDto[colorspace=$colorspace, extractEmbedded=$extractEmbedded, fullsize=$fullsize, preview=$preview, thumbnail=$thumbnail]';
 
   Map<String, dynamic> toJson() {
     final json = <String, dynamic>{};
       json[r'colorspace'] = this.colorspace;
       json[r'extractEmbedded'] = this.extractEmbedded;
+      json[r'fullsize'] = this.fullsize;
       json[r'preview'] = this.preview;
       json[r'thumbnail'] = this.thumbnail;
     return json;
@@ -65,6 +71,7 @@ class SystemConfigImageDto {
       return SystemConfigImageDto(
         colorspace: Colorspace.fromJson(json[r'colorspace'])!,
         extractEmbedded: mapValueOfType<bool>(json, r'extractEmbedded')!,
+        fullsize: SystemConfigGeneratedFullsizeImageDto.fromJson(json[r'fullsize'])!,
         preview: SystemConfigGeneratedImageDto.fromJson(json[r'preview'])!,
         thumbnail: SystemConfigGeneratedImageDto.fromJson(json[r'thumbnail'])!,
       );
@@ -116,6 +123,7 @@ class SystemConfigImageDto {
   static const requiredKeys = <String>{
     'colorspace',
     'extractEmbedded',
+    'fullsize',
     'preview',
     'thumbnail',
   };