Merge remote-tracking branch 'origin/main' into feat/integrity-checks-izzy

Signed-off-by: izzy <me@insrt.uk>

mobile/openapi/lib/model/activity_create_dto.dart

@@ -19,8 +19,10 @@ class ActivityCreateDto {
     required this.type,
   });
 
+  /// Album ID
   String albumId;
 
+  /// Asset ID (if activity is for an asset)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -29,6 +31,7 @@ class ActivityCreateDto {
   ///
   String? assetId;
 
+  /// Comment text (required if type is comment)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -37,6 +40,7 @@ class ActivityCreateDto {
   ///
   String? comment;
 
+  /// Activity type (like or comment)
   ReactionType type;
 
   @override

mobile/openapi/lib/model/activity_response_dto.dart

@@ -21,14 +21,19 @@ class ActivityResponseDto {
     required this.user,
   });
 
+  /// Asset ID (if activity is for an asset)
   String? assetId;
 
+  /// Comment text (for comment activities)
   String? comment;
 
+  /// Creation date
   DateTime createdAt;
 
+  /// Activity ID
   String id;
 
+  /// Activity type
   ReactionType type;
 
   UserResponseDto user;

mobile/openapi/lib/model/activity_statistics_response_dto.dart

@@ -17,8 +17,10 @@ class ActivityStatisticsResponseDto {
     required this.likes,
   });
 
+  /// Number of comments
   int comments;
 
+  /// Number of likes
   int likes;
 
   @override

mobile/openapi/lib/model/add_users_dto.dart

@@ -16,6 +16,7 @@ class AddUsersDto {
     this.albumUsers = const [],
   });
 
+  /// Album users to add
   List<AlbumUserAddDto> albumUsers;
 
   @override

mobile/openapi/lib/model/admin_onboarding_update_dto.dart

@@ -16,6 +16,7 @@ class AdminOnboardingUpdateDto {
     required this.isOnboarded,
   });
 
+  /// Is admin onboarded
   bool isOnboarded;
 
   @override

mobile/openapi/lib/model/album_response_dto.dart

@@ -34,22 +34,28 @@ class AlbumResponseDto {
     required this.updatedAt,
   });
 
+  /// Album name
   String albumName;
 
+  /// Thumbnail asset ID
   String? albumThumbnailAssetId;
 
   List<AlbumUserResponseDto> albumUsers;
 
+  /// Number of assets
   int assetCount;
 
   List<AssetResponseDto> assets;
 
   List<ContributorCountResponseDto> contributorCounts;
 
+  /// Creation date
   DateTime createdAt;
 
+  /// Album description
   String description;
 
+  /// End date (latest asset)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -58,12 +64,16 @@ class AlbumResponseDto {
   ///
   DateTime? endDate;
 
+  /// Has shared link
   bool hasSharedLink;
 
+  /// Album ID
   String id;
 
+  /// Activity feed enabled
   bool isActivityEnabled;
 
+  /// Last modified asset timestamp
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -72,6 +82,7 @@ class AlbumResponseDto {
   ///
   DateTime? lastModifiedAssetTimestamp;
 
+  /// Asset sort order
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -82,10 +93,13 @@ class AlbumResponseDto {
 
   UserResponseDto owner;
 
+  /// Owner user ID
   String ownerId;
 
+  /// Is shared album
   bool shared;
 
+  /// Start date (earliest asset)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -94,6 +108,7 @@ class AlbumResponseDto {
   ///
   DateTime? startDate;
 
+  /// Last update date
   DateTime updatedAt;
 
   @override

mobile/openapi/lib/model/album_statistics_response_dto.dart

@@ -18,10 +18,13 @@ class AlbumStatisticsResponseDto {
     required this.shared,
   });
 
+  /// Number of non-shared albums
   int notShared;
 
+  /// Number of owned albums
   int owned;
 
+  /// Number of shared albums
   int shared;
 
   @override

mobile/openapi/lib/model/album_user_add_dto.dart

@@ -17,8 +17,10 @@ class AlbumUserAddDto {
     required this.userId,
   });
 
+  /// Album user role
   AlbumUserRole role;
 
+  /// User ID
   String userId;
 
   @override

mobile/openapi/lib/model/album_user_create_dto.dart

@@ -17,8 +17,10 @@ class AlbumUserCreateDto {
     required this.userId,
   });
 
+  /// Album user role
   AlbumUserRole role;
 
+  /// User ID
   String userId;
 
   @override

mobile/openapi/lib/model/album_user_response_dto.dart

@@ -17,6 +17,7 @@ class AlbumUserResponseDto {
     required this.user,
   });
 
+  /// Album user role
   AlbumUserRole role;
 
   UserResponseDto user;

mobile/openapi/lib/model/album_user_role.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Album user role
 class AlbumUserRole {
   /// Instantiate a new enum with the provided [value].
   const AlbumUserRole._(this.value);

mobile/openapi/lib/model/albums_add_assets_dto.dart

@@ -17,8 +17,10 @@ class AlbumsAddAssetsDto {
     this.assetIds = const [],
   });
 
+  /// Album IDs
   List<String> albumIds;
 
+  /// Asset IDs
   List<String> assetIds;
 
   @override

mobile/openapi/lib/model/albums_add_assets_response_dto.dart

@@ -17,6 +17,7 @@ class AlbumsAddAssetsResponseDto {
     required this.success,
   });
 
+  /// Error reason
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -25,6 +26,7 @@ class AlbumsAddAssetsResponseDto {
   ///
   BulkIdErrorReason? error;
 
+  /// Operation success
   bool success;
 
   @override

mobile/openapi/lib/model/albums_response.dart

@@ -16,6 +16,7 @@ class AlbumsResponse {
     this.defaultAssetOrder = AssetOrder.desc,
   });
 
+  /// Default asset order for albums
   AssetOrder defaultAssetOrder;
 
   @override

mobile/openapi/lib/model/albums_update.dart

@@ -16,6 +16,7 @@ class AlbumsUpdate {
     this.defaultAssetOrder,
   });
 
+  /// Default asset order for albums
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/api_key_create_dto.dart

@@ -17,6 +17,7 @@ class APIKeyCreateDto {
     this.permissions = const [],
   });
 
+  /// API key name
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -25,6 +26,7 @@ class APIKeyCreateDto {
   ///
   String? name;
 
+  /// List of permissions
   List<Permission> permissions;
 
   @override

mobile/openapi/lib/model/api_key_create_response_dto.dart

@@ -19,6 +19,7 @@ class APIKeyCreateResponseDto {
 
   APIKeyResponseDto apiKey;
 
+  /// API key secret (only shown once)
   String secret;
 
   @override

mobile/openapi/lib/model/api_key_response_dto.dart

@@ -20,14 +20,19 @@ class APIKeyResponseDto {
     required this.updatedAt,
   });
 
+  /// Creation date
   DateTime createdAt;
 
+  /// API key ID
   String id;
 
+  /// API key name
   String name;
 
+  /// List of permissions
   List<Permission> permissions;
 
+  /// Last update date
   DateTime updatedAt;
 
   @override

mobile/openapi/lib/model/api_key_update_dto.dart

@@ -17,6 +17,7 @@ class APIKeyUpdateDto {
     this.permissions = const [],
   });
 
+  /// API key name
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -25,6 +26,7 @@ class APIKeyUpdateDto {
   ///
   String? name;
 
+  /// List of permissions
   List<Permission> permissions;
 
   @override

mobile/openapi/lib/model/asset_bulk_delete_dto.dart

@@ -17,6 +17,7 @@ class AssetBulkDeleteDto {
     this.ids = const [],
   });
 
+  /// Force delete even if in use
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -25,6 +26,7 @@ class AssetBulkDeleteDto {
   ///
   bool? force;
 
+  /// IDs to process
   List<String> ids;
 
   @override

mobile/openapi/lib/model/asset_bulk_update_dto.dart

@@ -26,6 +26,7 @@ class AssetBulkUpdateDto {
     this.visibility,
   });
 
+  /// Original date and time
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -34,6 +35,7 @@ class AssetBulkUpdateDto {
   ///
   String? dateTimeOriginal;
 
+  /// Relative time offset in seconds
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -42,6 +44,7 @@ class AssetBulkUpdateDto {
   ///
   num? dateTimeRelative;
 
+  /// Asset description
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -50,10 +53,13 @@ class AssetBulkUpdateDto {
   ///
   String? description;
 
+  /// Duplicate ID
   String? duplicateId;
 
+  /// Asset IDs to update
   List<String> ids;
 
+  /// Mark as favorite
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -62,6 +68,7 @@ class AssetBulkUpdateDto {
   ///
   bool? isFavorite;
 
+  /// Latitude coordinate
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -70,6 +77,7 @@ class AssetBulkUpdateDto {
   ///
   num? latitude;
 
+  /// Longitude coordinate
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -78,6 +86,8 @@ class AssetBulkUpdateDto {
   ///
   num? longitude;
 
+  /// Rating
+  ///
   /// Minimum value: -1
   /// Maximum value: 5
   ///
@@ -88,6 +98,7 @@ class AssetBulkUpdateDto {
   ///
   num? rating;
 
+  /// Time zone (IANA timezone)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -96,6 +107,7 @@ class AssetBulkUpdateDto {
   ///
   String? timeZone;
 
+  /// Asset visibility
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/asset_bulk_upload_check_dto.dart

@@ -16,6 +16,7 @@ class AssetBulkUploadCheckDto {
     this.assets = const [],
   });
 
+  /// Assets to check
   List<AssetBulkUploadCheckItem> assets;
 
   @override

mobile/openapi/lib/model/asset_bulk_upload_check_item.dart

@@ -17,9 +17,10 @@ class AssetBulkUploadCheckItem {
     required this.id,
   });
 
-  /// base64 or hex encoded sha1 hash
+  /// Base64 or hex encoded SHA1 hash
   String checksum;
 
+  /// Asset ID
   String id;
 
   @override

mobile/openapi/lib/model/asset_bulk_upload_check_response_dto.dart

@@ -16,6 +16,7 @@ class AssetBulkUploadCheckResponseDto {
     this.results = const [],
   });
 
+  /// Upload check results
   List<AssetBulkUploadCheckResult> results;
 
   @override

mobile/openapi/lib/model/asset_bulk_upload_check_result.dart

@@ -20,8 +20,10 @@ class AssetBulkUploadCheckResult {
     this.reason,
   });
 
+  /// Upload action
   AssetBulkUploadCheckResultActionEnum action;
 
+  /// Existing asset ID if duplicate
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -30,8 +32,10 @@ class AssetBulkUploadCheckResult {
   ///
   String? assetId;
 
+  /// Asset ID
   String id;
 
+  /// Whether existing asset is trashed
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -40,6 +44,7 @@ class AssetBulkUploadCheckResult {
   ///
   bool? isTrashed;
 
+  /// Rejection reason if rejected
   AssetBulkUploadCheckResultReasonEnum? reason;
 
   @override
@@ -150,7 +155,7 @@ class AssetBulkUploadCheckResult {
   };
 }
 
-
+/// Upload action
 class AssetBulkUploadCheckResultActionEnum {
   /// Instantiate a new enum with the provided [value].
   const AssetBulkUploadCheckResultActionEnum._(this.value);
@@ -224,7 +229,7 @@ class AssetBulkUploadCheckResultActionEnumTypeTransformer {
 }
 
 
-
+/// Rejection reason if rejected
 class AssetBulkUploadCheckResultReasonEnum {
   /// Instantiate a new enum with the provided [value].
   const AssetBulkUploadCheckResultReasonEnum._(this.value);

mobile/openapi/lib/model/asset_copy_dto.dart

@@ -22,18 +22,25 @@ class AssetCopyDto {
     required this.targetId,
   });
 
+  /// Copy album associations
   bool albums;
 
+  /// Copy favorite status
   bool favorite;
 
+  /// Copy shared links
   bool sharedLinks;
 
+  /// Copy sidecar file
   bool sidecar;
 
+  /// Source asset ID
   String sourceId;
 
+  /// Copy stack association
   bool stack;
 
+  /// Target asset ID
   String targetId;
 
   @override

mobile/openapi/lib/model/asset_delta_sync_dto.dart

@@ -17,8 +17,10 @@ class AssetDeltaSyncDto {
     this.userIds = const [],
   });
 
+  /// Sync assets updated after this date
   DateTime updatedAfter;
 
+  /// User IDs to sync
   List<String> userIds;
 
   @override

mobile/openapi/lib/model/asset_delta_sync_response_dto.dart

@@ -18,10 +18,13 @@ class AssetDeltaSyncResponseDto {
     this.upserted = const [],
   });
 
+  /// Deleted asset IDs
   List<String> deleted;
 
+  /// Whether full sync is needed
   bool needsFullSync;
 
+  /// Upserted assets
   List<AssetResponseDto> upserted;
 
   @override

mobile/openapi/lib/model/asset_edit_action.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Type of edit action to perform
 class AssetEditAction {
   /// Instantiate a new enum with the provided [value].
   const AssetEditAction._(this.value);

mobile/openapi/lib/model/asset_edit_action_crop.dart

@@ -17,6 +17,7 @@ class AssetEditActionCrop {
     required this.parameters,
   });
 
+  /// Type of edit action to perform
   AssetEditAction action;
 
   CropParameters parameters;

mobile/openapi/lib/model/asset_edit_action_list_dto.dart

@@ -16,7 +16,7 @@ class AssetEditActionListDto {
     this.edits = const [],
   });
 
-  /// list of edits
+  /// List of edit actions to apply (crop, rotate, or mirror)
   List<AssetEditActionListDtoEditsInner> edits;
 
   @override

mobile/openapi/lib/model/asset_edit_action_list_dto_edits_inner.dart

@@ -17,6 +17,7 @@ class AssetEditActionListDtoEditsInner {
     required this.parameters,
   });
 
+  /// Type of edit action to perform
   AssetEditAction action;
 
   MirrorParameters parameters;

mobile/openapi/lib/model/asset_edit_action_mirror.dart

@@ -17,6 +17,7 @@ class AssetEditActionMirror {
     required this.parameters,
   });
 
+  /// Type of edit action to perform
   AssetEditAction action;
 
   MirrorParameters parameters;

mobile/openapi/lib/model/asset_edit_action_rotate.dart

@@ -17,6 +17,7 @@ class AssetEditActionRotate {
     required this.parameters,
   });
 
+  /// Type of edit action to perform
   AssetEditAction action;
 
   RotateParameters parameters;

mobile/openapi/lib/model/asset_edits_dto.dart

@@ -17,9 +17,10 @@ class AssetEditsDto {
     this.edits = const [],
   });
 
+  /// Asset ID to apply edits to
   String assetId;
 
-  /// list of edits
+  /// List of edit actions to apply (crop, rotate, or mirror)
   List<AssetEditActionListDtoEditsInner> edits;
 
   @override

mobile/openapi/lib/model/asset_face_create_dto.dart

@@ -23,20 +23,28 @@ class AssetFaceCreateDto {
     required this.y,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Face bounding box height
   int height;
 
+  /// Image height in pixels
   int imageHeight;
 
+  /// Image width in pixels
   int imageWidth;
 
+  /// Person ID
   String personId;
 
+  /// Face bounding box width
   int width;
 
+  /// Face bounding box X coordinate
   int x;
 
+  /// Face bounding box Y coordinate
   int y;
 
   @override

mobile/openapi/lib/model/asset_face_delete_dto.dart

@@ -16,6 +16,7 @@ class AssetFaceDeleteDto {
     required this.force,
   });
 
+  /// Force delete even if person has other faces
   bool force;
 
   @override

mobile/openapi/lib/model/asset_face_response_dto.dart

@@ -24,22 +24,31 @@ class AssetFaceResponseDto {
     this.sourceType,
   });
 
+  /// Bounding box X1 coordinate
   int boundingBoxX1;
 
+  /// Bounding box X2 coordinate
   int boundingBoxX2;
 
+  /// Bounding box Y1 coordinate
   int boundingBoxY1;
 
+  /// Bounding box Y2 coordinate
   int boundingBoxY2;
 
+  /// Face ID
   String id;
 
+  /// Image height in pixels
   int imageHeight;
 
+  /// Image width in pixels
   int imageWidth;
 
+  /// Person associated with face
   PersonResponseDto? person;
 
+  /// Face detection source type
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/asset_face_update_dto.dart

@@ -16,6 +16,7 @@ class AssetFaceUpdateDto {
     this.data = const [],
   });
 
+  /// Face update items
   List<AssetFaceUpdateItem> data;
 
   @override

mobile/openapi/lib/model/asset_face_update_item.dart

@@ -17,8 +17,10 @@ class AssetFaceUpdateItem {
     required this.personId,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Person ID
   String personId;
 
   @override

mobile/openapi/lib/model/asset_face_without_person_response_dto.dart

@@ -23,20 +23,28 @@ class AssetFaceWithoutPersonResponseDto {
     this.sourceType,
   });
 
+  /// Bounding box X1 coordinate
   int boundingBoxX1;
 
+  /// Bounding box X2 coordinate
   int boundingBoxX2;
 
+  /// Bounding box Y1 coordinate
   int boundingBoxY1;
 
+  /// Bounding box Y2 coordinate
   int boundingBoxY2;
 
+  /// Face ID
   String id;
 
+  /// Image height in pixels
   int imageHeight;
 
+  /// Image width in pixels
   int imageWidth;
 
+  /// Face detection source type
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/asset_full_sync_dto.dart

@@ -19,6 +19,7 @@ class AssetFullSyncDto {
     this.userId,
   });
 
+  /// Last asset ID (pagination)
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -27,11 +28,15 @@ class AssetFullSyncDto {
   ///
   String? lastId;
 
+  /// Maximum number of assets to return
+  ///
   /// Minimum value: 1
   int limit;
 
+  /// Sync assets updated until this date
   DateTime updatedUntil;
 
+  /// Filter by user ID
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/asset_ids_dto.dart

@@ -16,6 +16,7 @@ class AssetIdsDto {
     this.assetIds = const [],
   });
 
+  /// Asset IDs
   List<String> assetIds;
 
   @override

mobile/openapi/lib/model/asset_ids_response_dto.dart

@@ -18,10 +18,13 @@ class AssetIdsResponseDto {
     required this.success,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Error reason if failed
   AssetIdsResponseDtoErrorEnum? error;
 
+  /// Whether operation succeeded
   bool success;
 
   @override
@@ -116,7 +119,7 @@ class AssetIdsResponseDto {
   };
 }
 
-
+/// Error reason if failed
 class AssetIdsResponseDtoErrorEnum {
   /// Instantiate a new enum with the provided [value].
   const AssetIdsResponseDtoErrorEnum._(this.value);

mobile/openapi/lib/model/asset_job_name.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Job name
 class AssetJobName {
   /// Instantiate a new enum with the provided [value].
   const AssetJobName._(this.value);

mobile/openapi/lib/model/asset_jobs_dto.dart

@@ -17,8 +17,10 @@ class AssetJobsDto {
     required this.name,
   });
 
+  /// Asset IDs
   List<String> assetIds;
 
+  /// Job name
   AssetJobName name;
 
   @override

mobile/openapi/lib/model/asset_media_response_dto.dart

@@ -17,8 +17,10 @@ class AssetMediaResponseDto {
     required this.status,
   });
 
+  /// Asset media ID
   String id;
 
+  /// Upload status
   AssetMediaStatus status;
 
   @override

mobile/openapi/lib/model/asset_media_size.dart

@@ -23,12 +23,14 @@ class AssetMediaSize {
 
   String toJson() => value;
 
+  static const original = AssetMediaSize._(r'original');
   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>[
+    original,
     fullsize,
     preview,
     thumbnail,
@@ -70,6 +72,7 @@ class AssetMediaSizeTypeTransformer {
   AssetMediaSize? decode(dynamic data, {bool allowNull = true}) {
     if (data != null) {
       switch (data) {
+        case r'original': return AssetMediaSize.original;
         case r'fullsize': return AssetMediaSize.fullsize;
         case r'preview': return AssetMediaSize.preview;
         case r'thumbnail': return AssetMediaSize.thumbnail;

mobile/openapi/lib/model/asset_media_status.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Upload status
 class AssetMediaStatus {
   /// Instantiate a new enum with the provided [value].
   const AssetMediaStatus._(this.value);

mobile/openapi/lib/model/asset_metadata_bulk_delete_dto.dart

@@ -16,6 +16,7 @@ class AssetMetadataBulkDeleteDto {
     this.items = const [],
   });
 
+  /// Metadata items to delete
   List<AssetMetadataBulkDeleteItemDto> items;
 
   @override

mobile/openapi/lib/model/asset_metadata_bulk_delete_item_dto.dart

@@ -17,8 +17,10 @@ class AssetMetadataBulkDeleteItemDto {
     required this.key,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Metadata key
   String key;
 
   @override

mobile/openapi/lib/model/asset_metadata_bulk_response_dto.dart

@@ -19,12 +19,16 @@ class AssetMetadataBulkResponseDto {
     required this.value,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Metadata key
   String key;
 
+  /// Last update date
   DateTime updatedAt;
 
+  /// Metadata value (object)
   Object value;
 
   @override

mobile/openapi/lib/model/asset_metadata_bulk_upsert_dto.dart

@@ -16,6 +16,7 @@ class AssetMetadataBulkUpsertDto {
     this.items = const [],
   });
 
+  /// Metadata items to upsert
   List<AssetMetadataBulkUpsertItemDto> items;
 
   @override

mobile/openapi/lib/model/asset_metadata_bulk_upsert_item_dto.dart

@@ -18,10 +18,13 @@ class AssetMetadataBulkUpsertItemDto {
     required this.value,
   });
 
+  /// Asset ID
   String assetId;
 
+  /// Metadata key
   String key;
 
+  /// Metadata value (object)
   Object value;
 
   @override

mobile/openapi/lib/model/asset_metadata_response_dto.dart

@@ -18,10 +18,13 @@ class AssetMetadataResponseDto {
     required this.value,
   });
 
+  /// Metadata key
   String key;
 
+  /// Last update date
   DateTime updatedAt;
 
+  /// Metadata value (object)
   Object value;
 
   @override

mobile/openapi/lib/model/asset_metadata_upsert_dto.dart

@@ -16,6 +16,7 @@ class AssetMetadataUpsertDto {
     this.items = const [],
   });
 
+  /// Metadata items to upsert
   List<AssetMetadataUpsertItemDto> items;
 
   @override

mobile/openapi/lib/model/asset_metadata_upsert_item_dto.dart

@@ -17,8 +17,10 @@ class AssetMetadataUpsertItemDto {
     required this.value,
   });
 
+  /// Metadata key
   String key;
 
+  /// Metadata value (object)
   Object value;
 
   @override

mobile/openapi/lib/model/asset_order.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Asset sort order
 class AssetOrder {
   /// Instantiate a new enum with the provided [value].
   const AssetOrder._(this.value);

mobile/openapi/lib/model/asset_response_dto.dart

@@ -50,18 +50,22 @@ class AssetResponseDto {
     required this.width,
   });
 
-  /// base64 encoded sha1 hash
+  /// Base64 encoded SHA1 hash
   String checksum;
 
   /// The UTC timestamp when the asset was originally uploaded to Immich.
   DateTime createdAt;
 
+  /// Device asset ID
   String deviceAssetId;
 
+  /// Device ID
   String deviceId;
 
+  /// Duplicate group ID
   String? duplicateId;
 
+  /// Video duration (for videos)
   String duration;
 
   ///
@@ -78,31 +82,43 @@ class AssetResponseDto {
   /// The UTC timestamp when the file was last modified on the filesystem. This reflects the last time the physical file was changed, which may be different from when the photo was originally taken.
   DateTime fileModifiedAt;
 
+  /// Whether asset has metadata
   bool hasMetadata;
 
+  /// Asset height
   num? height;
 
+  /// Asset ID
   String id;
 
+  /// Is archived
   bool isArchived;
 
+  /// Is edited
   bool isEdited;
 
+  /// Is favorite
   bool isFavorite;
 
+  /// Is offline
   bool isOffline;
 
+  /// Is trashed
   bool isTrashed;
 
+  /// Library ID
   String? libraryId;
 
+  /// Live photo video ID
   String? livePhotoVideoId;
 
   /// The local date and time when the photo/video was taken, derived from EXIF metadata. This represents the photographer's local time regardless of timezone, stored as a timezone-agnostic timestamp. Used for timeline grouping by \"local\" days and months.
   DateTime localDateTime;
 
+  /// Original file name
   String originalFileName;
 
+  /// Original MIME type
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -111,6 +127,7 @@ class AssetResponseDto {
   ///
   String? originalMimeType;
 
+  /// Original file path
   String originalPath;
 
   ///
@@ -121,10 +138,12 @@ class AssetResponseDto {
   ///
   UserResponseDto? owner;
 
+  /// Owner user ID
   String ownerId;
 
   List<PersonWithFacesResponseDto> people;
 
+  /// Is resized
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -137,8 +156,10 @@ class AssetResponseDto {
 
   List<TagResponseDto> tags;
 
+  /// Thumbhash for thumbnail generation
   String? thumbhash;
 
+  /// Asset type
   AssetTypeEnum type;
 
   List<AssetFaceWithoutPersonResponseDto> unassignedFaces;
@@ -146,8 +167,10 @@ class AssetResponseDto {
   /// The UTC timestamp when the asset record was last updated in the database. This is automatically maintained by the database and reflects when any field in the asset was last modified.
   DateTime updatedAt;
 
+  /// Asset visibility
   AssetVisibility visibility;
 
+  /// Asset width
   num? width;
 
   @override

mobile/openapi/lib/model/asset_stack_response_dto.dart

@@ -18,10 +18,13 @@ class AssetStackResponseDto {
     required this.primaryAssetId,
   });
 
+  /// Number of assets in stack
   int assetCount;
 
+  /// Stack ID
   String id;
 
+  /// Primary asset ID
   String primaryAssetId;
 
   @override

mobile/openapi/lib/model/asset_stats_response_dto.dart

@@ -18,10 +18,13 @@ class AssetStatsResponseDto {
     required this.videos,
   });
 
+  /// Number of images
   int images;
 
+  /// Total number of assets
   int total;
 
+  /// Number of videos
   int videos;
 
   @override

mobile/openapi/lib/model/asset_type_enum.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Asset type
 class AssetTypeEnum {
   /// Instantiate a new enum with the provided [value].
   const AssetTypeEnum._(this.value);

mobile/openapi/lib/model/asset_visibility.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Asset visibility
 class AssetVisibility {
   /// Instantiate a new enum with the provided [value].
   const AssetVisibility._(this.value);

mobile/openapi/lib/model/audio_codec.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Target audio codec
 class AudioCodec {
   /// Instantiate a new enum with the provided [value].
   const AudioCodec._(this.value);

mobile/openapi/lib/model/auth_status_response_dto.dart

@@ -20,6 +20,7 @@ class AuthStatusResponseDto {
     this.pinExpiresAt,
   });
 
+  /// Session expiration date
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -28,12 +29,16 @@ class AuthStatusResponseDto {
   ///
   String? expiresAt;
 
+  /// Is elevated session
   bool isElevated;
 
+  /// Has password set
   bool password;
 
+  /// Has PIN code set
   bool pinCode;
 
+  /// PIN expiration date
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/avatar_update.dart

@@ -16,6 +16,7 @@ class AvatarUpdate {
     this.color,
   });
 
+  /// Avatar color
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/bulk_id_error_reason.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Error reason
 class BulkIdErrorReason {
   /// Instantiate a new enum with the provided [value].
   const BulkIdErrorReason._(this.value);

mobile/openapi/lib/model/bulk_id_response_dto.dart

@@ -18,10 +18,13 @@ class BulkIdResponseDto {
     required this.success,
   });
 
+  /// Error reason if failed
   BulkIdResponseDtoErrorEnum? error;
 
+  /// ID
   String id;
 
+  /// Whether operation succeeded
   bool success;
 
   @override
@@ -116,7 +119,7 @@ class BulkIdResponseDto {
   };
 }
 
-
+/// Error reason if failed
 class BulkIdResponseDtoErrorEnum {
   /// Instantiate a new enum with the provided [value].
   const BulkIdResponseDtoErrorEnum._(this.value);

mobile/openapi/lib/model/bulk_ids_dto.dart

@@ -16,6 +16,7 @@ class BulkIdsDto {
     this.ids = const [],
   });
 
+  /// IDs to process
   List<String> ids;
 
   @override

mobile/openapi/lib/model/cast_response.dart

@@ -16,6 +16,7 @@ class CastResponse {
     this.gCastEnabled = false,
   });
 
+  /// Whether Google Cast is enabled
   bool gCastEnabled;
 
   @override

mobile/openapi/lib/model/cast_update.dart

@@ -16,6 +16,7 @@ class CastUpdate {
     this.gCastEnabled,
   });
 
+  /// Whether Google Cast is enabled
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/change_password_dto.dart

@@ -18,10 +18,13 @@ class ChangePasswordDto {
     required this.password,
   });
 
+  /// Invalidate all other sessions
   bool invalidateSessions;
 
+  /// New password (min 8 characters)
   String newPassword;
 
+  /// Current password
   String password;
 
   @override

mobile/openapi/lib/model/check_existing_assets_dto.dart

@@ -17,8 +17,10 @@ class CheckExistingAssetsDto {
     required this.deviceId,
   });
 
+  /// Device asset IDs to check
   List<String> deviceAssetIds;
 
+  /// Device ID
   String deviceId;
 
   @override

mobile/openapi/lib/model/check_existing_assets_response_dto.dart

@@ -16,6 +16,7 @@ class CheckExistingAssetsResponseDto {
     this.existingIds = const [],
   });
 
+  /// Existing asset IDs
   List<String> existingIds;
 
   @override

mobile/openapi/lib/model/clip_config.dart

@@ -17,8 +17,10 @@ class CLIPConfig {
     required this.modelName,
   });
 
+  /// Whether the task is enabled
   bool enabled;
 
+  /// Name of the model to use
   String modelName;
 
   @override

mobile/openapi/lib/model/colorspace.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Colorspace
 class Colorspace {
   /// Instantiate a new enum with the provided [value].
   const Colorspace._(this.value);

mobile/openapi/lib/model/contributor_count_response_dto.dart

@@ -17,8 +17,10 @@ class ContributorCountResponseDto {
     required this.userId,
   });
 
+  /// Number of assets contributed
   int assetCount;
 
+  /// User ID
   String userId;
 
   @override

mobile/openapi/lib/model/cq_mode.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// CQ mode
 class CQMode {
   /// Instantiate a new enum with the provided [value].
   const CQMode._(this.value);

mobile/openapi/lib/model/create_album_dto.dart

@@ -19,12 +19,16 @@ class CreateAlbumDto {
     this.description,
   });
 
+  /// Album name
   String albumName;
 
+  /// Album users
   List<AlbumUserCreateDto> albumUsers;
 
+  /// Initial asset IDs
   List<String> assetIds;
 
+  /// Album description
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/create_library_dto.dart

@@ -19,10 +19,13 @@ class CreateLibraryDto {
     required this.ownerId,
   });
 
+  /// Exclusion patterns (max 128)
   Set<String> exclusionPatterns;
 
+  /// Import paths (max 128)
   Set<String> importPaths;
 
+  /// Library name
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -31,6 +34,7 @@ class CreateLibraryDto {
   ///
   String? name;
 
+  /// Owner user ID
   String ownerId;
 
   @override

mobile/openapi/lib/model/create_profile_image_response_dto.dart

@@ -18,10 +18,13 @@ class CreateProfileImageResponseDto {
     required this.userId,
   });
 
+  /// Profile image change date
   DateTime profileChangedAt;
 
+  /// Profile image file path
   String profileImagePath;
 
+  /// User ID
   String userId;
 
   @override

mobile/openapi/lib/model/database_backup_config.dart

@@ -18,10 +18,14 @@ class DatabaseBackupConfig {
     required this.keepLastAmount,
   });
 
+  /// Cron expression
   String cronExpression;
 
+  /// Enabled
   bool enabled;
 
+  /// Keep last amount
+  ///
   /// Minimum value: 1
   num keepLastAmount;
 

mobile/openapi/lib/model/download_archive_info.dart

@@ -17,8 +17,10 @@ class DownloadArchiveInfo {
     required this.size,
   });
 
+  /// Asset IDs in this archive
   List<String> assetIds;
 
+  /// Archive size in bytes
   int size;
 
   @override

mobile/openapi/lib/model/download_info_dto.dart

@@ -19,6 +19,7 @@ class DownloadInfoDto {
     this.userId,
   });
 
+  /// Album ID to download
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -27,6 +28,8 @@ class DownloadInfoDto {
   ///
   String? albumId;
 
+  /// Archive size limit in bytes
+  ///
   /// Minimum value: 1
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
@@ -36,8 +39,10 @@ class DownloadInfoDto {
   ///
   int? archiveSize;
 
+  /// Asset IDs to download
   List<String> assetIds;
 
+  /// User ID to download assets from
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/download_response.dart

@@ -17,8 +17,10 @@ class DownloadResponse {
     this.includeEmbeddedVideos = false,
   });
 
+  /// Maximum archive size in bytes
   int archiveSize;
 
+  /// Whether to include embedded videos in downloads
   bool includeEmbeddedVideos;
 
   @override

mobile/openapi/lib/model/download_response_dto.dart

@@ -17,8 +17,10 @@ class DownloadResponseDto {
     required this.totalSize,
   });
 
+  /// Archive information
   List<DownloadArchiveInfo> archives;
 
+  /// Total size in bytes
   int totalSize;
 
   @override

mobile/openapi/lib/model/download_update.dart

@@ -17,6 +17,8 @@ class DownloadUpdate {
     this.includeEmbeddedVideos,
   });
 
+  /// Maximum archive size in bytes
+  ///
   /// Minimum value: 1
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
@@ -26,6 +28,7 @@ class DownloadUpdate {
   ///
   int? archiveSize;
 
+  /// Whether to include embedded videos in downloads
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/duplicate_detection_config.dart

@@ -17,8 +17,11 @@ class DuplicateDetectionConfig {
     required this.maxDistance,
   });
 
+  /// Whether the task is enabled
   bool enabled;
 
+  /// Maximum distance threshold for duplicate detection
+  ///
   /// Minimum value: 0.001
   /// Maximum value: 0.1
   double maxDistance;

mobile/openapi/lib/model/duplicate_response_dto.dart

@@ -17,8 +17,10 @@ class DuplicateResponseDto {
     required this.duplicateId,
   });
 
+  /// Duplicate assets
   List<AssetResponseDto> assets;
 
+  /// Duplicate group ID
   String duplicateId;
 
   @override

mobile/openapi/lib/model/email_notifications_response.dart

@@ -18,10 +18,13 @@ class EmailNotificationsResponse {
     required this.enabled,
   });
 
+  /// Whether to receive email notifications for album invites
   bool albumInvite;
 
+  /// Whether to receive email notifications for album updates
   bool albumUpdate;
 
+  /// Whether email notifications are enabled
   bool enabled;
 
   @override

mobile/openapi/lib/model/email_notifications_update.dart

@@ -18,6 +18,7 @@ class EmailNotificationsUpdate {
     this.enabled,
   });
 
+  /// Whether to receive email notifications for album invites
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -26,6 +27,7 @@ class EmailNotificationsUpdate {
   ///
   bool? albumInvite;
 
+  /// Whether to receive email notifications for album updates
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -34,6 +36,7 @@ class EmailNotificationsUpdate {
   ///
   bool? albumUpdate;
 
+  /// Whether email notifications are enabled
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/exif_response_dto.dart

@@ -37,48 +37,70 @@ class ExifResponseDto {
     this.timeZone,
   });
 
+  /// City name
   String? city;
 
+  /// Country name
   String? country;
 
+  /// Original date/time
   DateTime? dateTimeOriginal;
 
+  /// Image description
   String? description;
 
+  /// Image height in pixels
   num? exifImageHeight;
 
+  /// Image width in pixels
   num? exifImageWidth;
 
+  /// Exposure time
   String? exposureTime;
 
+  /// F-number (aperture)
   num? fNumber;
 
+  /// File size in bytes
   int? fileSizeInByte;
 
+  /// Focal length in mm
   num? focalLength;
 
+  /// ISO sensitivity
   num? iso;
 
+  /// GPS latitude
   num? latitude;
 
+  /// Lens model
   String? lensModel;
 
+  /// GPS longitude
   num? longitude;
 
+  /// Camera make
   String? make;
 
+  /// Camera model
   String? model;
 
+  /// Modification date/time
   DateTime? modifyDate;
 
+  /// Image orientation
   String? orientation;
 
+  /// Projection type
   String? projectionType;
 
+  /// Rating
   num? rating;
 
+  /// State/province name
   String? state;
 
+  /// Time zone
   String? timeZone;
 
   @override

mobile/openapi/lib/model/face_dto.dart

@@ -16,6 +16,7 @@ class FaceDto {
     required this.id,
   });
 
+  /// Face ID
   String id;
 
   @override

mobile/openapi/lib/model/facial_recognition_config.dart

@@ -20,19 +20,27 @@ class FacialRecognitionConfig {
     required this.modelName,
   });
 
+  /// Whether the task is enabled
   bool enabled;
 
+  /// Maximum distance threshold for face recognition
+  ///
   /// Minimum value: 0.1
   /// Maximum value: 2
   double maxDistance;
 
+  /// Minimum number of faces required for recognition
+  ///
   /// Minimum value: 1
   int minFaces;
 
+  /// Minimum confidence score for face detection
+  ///
   /// Minimum value: 0.1
   /// Maximum value: 1
   double minScore;
 
+  /// Name of the model to use
   String modelName;
 
   @override

mobile/openapi/lib/model/folders_response.dart

@@ -17,8 +17,10 @@ class FoldersResponse {
     this.sidebarWeb = false,
   });
 
+  /// Whether folders are enabled
   bool enabled;
 
+  /// Whether folders appear in web sidebar
   bool sidebarWeb;
 
   @override

mobile/openapi/lib/model/folders_update.dart

@@ -17,6 +17,7 @@ class FoldersUpdate {
     this.sidebarWeb,
   });
 
+  /// Whether folders are enabled
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated
@@ -25,6 +26,7 @@ class FoldersUpdate {
   ///
   bool? enabled;
 
+  /// Whether folders appear in web sidebar
   ///
   /// Please note: This property should have been non-nullable! Since the specification file
   /// does not include a default value (using the "default:" property), however, the generated

mobile/openapi/lib/model/image_format.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Image format
 class ImageFormat {
   /// Instantiate a new enum with the provided [value].
   const ImageFormat._(this.value);

mobile/openapi/lib/model/job_create_dto.dart

@@ -16,6 +16,7 @@ class JobCreateDto {
     required this.name,
   });
 
+  /// Job name
   ManualJobName name;
 
   @override

mobile/openapi/lib/model/job_name.dart

@@ -10,7 +10,7 @@
 
 part of openapi.api;
 
-
+/// Job name
 class JobName {
   /// Instantiate a new enum with the provided [value].
   const JobName._(this.value);

mobile/openapi/lib/model/job_settings_dto.dart

@@ -16,6 +16,8 @@ class JobSettingsDto {
     required this.concurrency,
   });
 
+  /// Concurrency
+  ///
   /// Minimum value: 1
   int concurrency;