refactor(server): stacks (#11453)

* refactor: stacks

* mobile: get it built

* chore: feedback

* fix: sync and duplicates

* mobile: remove old stack reference

* chore: add primary asset id

* revert change to asset entity

* mobile: refactor mobile api

* mobile: sync stack info after creating stack

* mobile: update timeline after deleting stack

* server: update asset updatedAt when stack is deleted

* mobile: simplify action

* mobile: rename to match dto property

* fix: web test

---------

Co-authored-by: Alex <alex.tran1502@gmail.com>

mobile/openapi/lib/api.dart

@@ -54,6 +54,7 @@ part 'api/server_api.dart';
 part 'api/server_info_api.dart';
 part 'api/sessions_api.dart';
 part 'api/shared_links_api.dart';
+part 'api/stacks_api.dart';
 part 'api/sync_api.dart';
 part 'api/system_config_api.dart';
 part 'api/system_metadata_api.dart';
@@ -101,6 +102,7 @@ part 'model/asset_media_size.dart';
 part 'model/asset_media_status.dart';
 part 'model/asset_order.dart';
 part 'model/asset_response_dto.dart';
+part 'model/asset_stack_response_dto.dart';
 part 'model/asset_stats_response_dto.dart';
 part 'model/asset_type_enum.dart';
 part 'model/audio_codec.dart';
@@ -216,6 +218,9 @@ part 'model/shared_link_type.dart';
 part 'model/sign_up_dto.dart';
 part 'model/smart_info_response_dto.dart';
 part 'model/smart_search_dto.dart';
+part 'model/stack_create_dto.dart';
+part 'model/stack_response_dto.dart';
+part 'model/stack_update_dto.dart';
 part 'model/system_config_dto.dart';
 part 'model/system_config_f_fmpeg_dto.dart';
 part 'model/system_config_image_dto.dart';
@@ -251,7 +256,6 @@ part 'model/update_album_user_dto.dart';
 part 'model/update_asset_dto.dart';
 part 'model/update_library_dto.dart';
 part 'model/update_partner_dto.dart';
-part 'model/update_stack_parent_dto.dart';
 part 'model/update_tag_dto.dart';
 part 'model/usage_by_user_dto.dart';
 part 'model/user_admin_create_dto.dart';

mobile/openapi/lib/api/assets_api.dart

@@ -804,45 +804,6 @@ class AssetsApi {
     }
   }
 
-  /// Performs an HTTP 'PUT /assets/stack/parent' operation and returns the [Response].
-  /// Parameters:
-  ///
-  /// * [UpdateStackParentDto] updateStackParentDto (required):
-  Future<Response> updateStackParentWithHttpInfo(UpdateStackParentDto updateStackParentDto,) async {
-    // ignore: prefer_const_declarations
-    final path = r'/assets/stack/parent';
-
-    // ignore: prefer_final_locals
-    Object? postBody = updateStackParentDto;
-
-    final queryParams = <QueryParam>[];
-    final headerParams = <String, String>{};
-    final formParams = <String, String>{};
-
-    const contentTypes = <String>['application/json'];
-
-
-    return apiClient.invokeAPI(
-      path,
-      'PUT',
-      queryParams,
-      postBody,
-      headerParams,
-      formParams,
-      contentTypes.isEmpty ? null : contentTypes.first,
-    );
-  }
-
-  /// Parameters:
-  ///
-  /// * [UpdateStackParentDto] updateStackParentDto (required):
-  Future<void> updateStackParent(UpdateStackParentDto updateStackParentDto,) async {
-    final response = await updateStackParentWithHttpInfo(updateStackParentDto,);
-    if (response.statusCode >= HttpStatus.badRequest) {
-      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
-    }
-  }
-
   /// Performs an HTTP 'POST /assets' operation and returns the [Response].
   /// Parameters:
   ///

mobile/openapi/lib/api/stacks_api.dart

@@ -0,0 +1,298 @@
+//
+// 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 StacksApi {
+  StacksApi([ApiClient? apiClient]) : apiClient = apiClient ?? defaultApiClient;
+
+  final ApiClient apiClient;
+
+  /// Performs an HTTP 'POST /stacks' operation and returns the [Response].
+  /// Parameters:
+  ///
+  /// * [StackCreateDto] stackCreateDto (required):
+  Future<Response> createStackWithHttpInfo(StackCreateDto stackCreateDto,) async {
+    // ignore: prefer_const_declarations
+    final path = r'/stacks';
+
+    // ignore: prefer_final_locals
+    Object? postBody = stackCreateDto;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>['application/json'];
+
+
+    return apiClient.invokeAPI(
+      path,
+      'POST',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Parameters:
+  ///
+  /// * [StackCreateDto] stackCreateDto (required):
+  Future<StackResponseDto?> createStack(StackCreateDto stackCreateDto,) async {
+    final response = await createStackWithHttpInfo(stackCreateDto,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'StackResponseDto',) as StackResponseDto;
+    
+    }
+    return null;
+  }
+
+  /// Performs an HTTP 'DELETE /stacks/{id}' operation and returns the [Response].
+  /// Parameters:
+  ///
+  /// * [String] id (required):
+  Future<Response> deleteStackWithHttpInfo(String id,) async {
+    // ignore: prefer_const_declarations
+    final path = r'/stacks/{id}'
+      .replaceAll('{id}', id);
+
+    // ignore: prefer_final_locals
+    Object? postBody;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>[];
+
+
+    return apiClient.invokeAPI(
+      path,
+      'DELETE',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Parameters:
+  ///
+  /// * [String] id (required):
+  Future<void> deleteStack(String id,) async {
+    final response = await deleteStackWithHttpInfo(id,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+  }
+
+  /// Performs an HTTP 'DELETE /stacks' operation and returns the [Response].
+  /// Parameters:
+  ///
+  /// * [BulkIdsDto] bulkIdsDto (required):
+  Future<Response> deleteStacksWithHttpInfo(BulkIdsDto bulkIdsDto,) async {
+    // ignore: prefer_const_declarations
+    final path = r'/stacks';
+
+    // ignore: prefer_final_locals
+    Object? postBody = bulkIdsDto;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>['application/json'];
+
+
+    return apiClient.invokeAPI(
+      path,
+      'DELETE',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Parameters:
+  ///
+  /// * [BulkIdsDto] bulkIdsDto (required):
+  Future<void> deleteStacks(BulkIdsDto bulkIdsDto,) async {
+    final response = await deleteStacksWithHttpInfo(bulkIdsDto,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+  }
+
+  /// Performs an HTTP 'GET /stacks/{id}' operation and returns the [Response].
+  /// Parameters:
+  ///
+  /// * [String] id (required):
+  Future<Response> getStackWithHttpInfo(String id,) async {
+    // ignore: prefer_const_declarations
+    final path = r'/stacks/{id}'
+      .replaceAll('{id}', id);
+
+    // ignore: prefer_final_locals
+    Object? postBody;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>[];
+
+
+    return apiClient.invokeAPI(
+      path,
+      'GET',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Parameters:
+  ///
+  /// * [String] id (required):
+  Future<StackResponseDto?> getStack(String id,) async {
+    final response = await getStackWithHttpInfo(id,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'StackResponseDto',) as StackResponseDto;
+    
+    }
+    return null;
+  }
+
+  /// Performs an HTTP 'GET /stacks' operation and returns the [Response].
+  /// Parameters:
+  ///
+  /// * [String] primaryAssetId:
+  Future<Response> searchStacksWithHttpInfo({ String? primaryAssetId, }) async {
+    // ignore: prefer_const_declarations
+    final path = r'/stacks';
+
+    // ignore: prefer_final_locals
+    Object? postBody;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    if (primaryAssetId != null) {
+      queryParams.addAll(_queryParams('', 'primaryAssetId', primaryAssetId));
+    }
+
+    const contentTypes = <String>[];
+
+
+    return apiClient.invokeAPI(
+      path,
+      'GET',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Parameters:
+  ///
+  /// * [String] primaryAssetId:
+  Future<List<StackResponseDto>?> searchStacks({ String? primaryAssetId, }) async {
+    final response = await searchStacksWithHttpInfo( primaryAssetId: primaryAssetId, );
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      final responseBody = await _decodeBodyBytes(response);
+      return (await apiClient.deserializeAsync(responseBody, 'List<StackResponseDto>') as List)
+        .cast<StackResponseDto>()
+        .toList(growable: false);
+
+    }
+    return null;
+  }
+
+  /// Performs an HTTP 'PUT /stacks/{id}' operation and returns the [Response].
+  /// Parameters:
+  ///
+  /// * [String] id (required):
+  ///
+  /// * [StackUpdateDto] stackUpdateDto (required):
+  Future<Response> updateStackWithHttpInfo(String id, StackUpdateDto stackUpdateDto,) async {
+    // ignore: prefer_const_declarations
+    final path = r'/stacks/{id}'
+      .replaceAll('{id}', id);
+
+    // ignore: prefer_final_locals
+    Object? postBody = stackUpdateDto;
+
+    final queryParams = <QueryParam>[];
+    final headerParams = <String, String>{};
+    final formParams = <String, String>{};
+
+    const contentTypes = <String>['application/json'];
+
+
+    return apiClient.invokeAPI(
+      path,
+      'PUT',
+      queryParams,
+      postBody,
+      headerParams,
+      formParams,
+      contentTypes.isEmpty ? null : contentTypes.first,
+    );
+  }
+
+  /// Parameters:
+  ///
+  /// * [String] id (required):
+  ///
+  /// * [StackUpdateDto] stackUpdateDto (required):
+  Future<StackResponseDto?> updateStack(String id, StackUpdateDto stackUpdateDto,) async {
+    final response = await updateStackWithHttpInfo(id, stackUpdateDto,);
+    if (response.statusCode >= HttpStatus.badRequest) {
+      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
+    }
+    // When a remote server returns no body with a status of 204, we shall not decode it.
+    // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
+    // FormatException when trying to decode an empty string.
+    if (response.body.isNotEmpty && response.statusCode != HttpStatus.noContent) {
+      return await apiClient.deserializeAsync(await _decodeBodyBytes(response), 'StackResponseDto',) as StackResponseDto;
+    
+    }
+    return null;
+  }
+}

mobile/openapi/lib/api_client.dart

@@ -259,6 +259,8 @@ class ApiClient {
           return AssetOrderTypeTransformer().decode(value);
         case 'AssetResponseDto':
           return AssetResponseDto.fromJson(value);
+        case 'AssetStackResponseDto':
+          return AssetStackResponseDto.fromJson(value);
         case 'AssetStatsResponseDto':
           return AssetStatsResponseDto.fromJson(value);
         case 'AssetTypeEnum':
@@ -489,6 +491,12 @@ class ApiClient {
           return SmartInfoResponseDto.fromJson(value);
         case 'SmartSearchDto':
           return SmartSearchDto.fromJson(value);
+        case 'StackCreateDto':
+          return StackCreateDto.fromJson(value);
+        case 'StackResponseDto':
+          return StackResponseDto.fromJson(value);
+        case 'StackUpdateDto':
+          return StackUpdateDto.fromJson(value);
         case 'SystemConfigDto':
           return SystemConfigDto.fromJson(value);
         case 'SystemConfigFFmpegDto':
@@ -559,8 +567,6 @@ class ApiClient {
           return UpdateLibraryDto.fromJson(value);
         case 'UpdatePartnerDto':
           return UpdatePartnerDto.fromJson(value);
-        case 'UpdateStackParentDto':
-          return UpdateStackParentDto.fromJson(value);
         case 'UpdateTagDto':
           return UpdateTagDto.fromJson(value);
         case 'UsageByUserDto':

mobile/openapi/lib/model/asset_bulk_update_dto.dart

@@ -21,8 +21,6 @@ class AssetBulkUpdateDto {
     this.latitude,
     this.longitude,
     this.rating,
-    this.removeParent,
-    this.stackParentId,
   });
 
   ///
@@ -79,22 +77,6 @@ class AssetBulkUpdateDto {
   ///
   num? rating;
 
-  ///
-  /// 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
-  /// source code must fall back to having a nullable type.
-  /// Consider adding a "default:" property in the specification file to hide this note.
-  ///
-  bool? removeParent;
-
-  ///
-  /// 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
-  /// source code must fall back to having a nullable type.
-  /// Consider adding a "default:" property in the specification file to hide this note.
-  ///
-  String? stackParentId;
-
   @override
   bool operator ==(Object other) => identical(this, other) || other is AssetBulkUpdateDto &&
     other.dateTimeOriginal == dateTimeOriginal &&
@@ -104,9 +86,7 @@ class AssetBulkUpdateDto {
     other.isFavorite == isFavorite &&
     other.latitude == latitude &&
     other.longitude == longitude &&
-    other.rating == rating &&
-    other.removeParent == removeParent &&
-    other.stackParentId == stackParentId;
+    other.rating == rating;
 
   @override
   int get hashCode =>
@@ -118,12 +98,10 @@ class AssetBulkUpdateDto {
     (isFavorite == null ? 0 : isFavorite!.hashCode) +
     (latitude == null ? 0 : latitude!.hashCode) +
     (longitude == null ? 0 : longitude!.hashCode) +
-    (rating == null ? 0 : rating!.hashCode) +
-    (removeParent == null ? 0 : removeParent!.hashCode) +
-    (stackParentId == null ? 0 : stackParentId!.hashCode);
+    (rating == null ? 0 : rating!.hashCode);
 
   @override
-  String toString() => 'AssetBulkUpdateDto[dateTimeOriginal=$dateTimeOriginal, duplicateId=$duplicateId, ids=$ids, isArchived=$isArchived, isFavorite=$isFavorite, latitude=$latitude, longitude=$longitude, rating=$rating, removeParent=$removeParent, stackParentId=$stackParentId]';
+  String toString() => 'AssetBulkUpdateDto[dateTimeOriginal=$dateTimeOriginal, duplicateId=$duplicateId, ids=$ids, isArchived=$isArchived, isFavorite=$isFavorite, latitude=$latitude, longitude=$longitude, rating=$rating]';
 
   Map<String, dynamic> toJson() {
     final json = <String, dynamic>{};
@@ -163,16 +141,6 @@ class AssetBulkUpdateDto {
     } else {
     //  json[r'rating'] = null;
     }
-    if (this.removeParent != null) {
-      json[r'removeParent'] = this.removeParent;
-    } else {
-    //  json[r'removeParent'] = null;
-    }
-    if (this.stackParentId != null) {
-      json[r'stackParentId'] = this.stackParentId;
-    } else {
-    //  json[r'stackParentId'] = null;
-    }
     return json;
   }
 
@@ -194,8 +162,6 @@ class AssetBulkUpdateDto {
         latitude: num.parse('${json[r'latitude']}'),
         longitude: num.parse('${json[r'longitude']}'),
         rating: num.parse('${json[r'rating']}'),
-        removeParent: mapValueOfType<bool>(json, r'removeParent'),
-        stackParentId: mapValueOfType<String>(json, r'stackParentId'),
       );
     }
     return null;

mobile/openapi/lib/model/asset_response_dto.dart

@@ -38,9 +38,7 @@ class AssetResponseDto {
     this.people = const [],
     required this.resized,
     this.smartInfo,
-    this.stack = const [],
-    required this.stackCount,
-    this.stackParentId,
+    this.stack,
     this.tags = const [],
     required this.thumbhash,
     required this.type,
@@ -124,11 +122,7 @@ class AssetResponseDto {
   ///
   SmartInfoResponseDto? smartInfo;
 
-  List<AssetResponseDto> stack;
-
-  int? stackCount;
-
-  String? stackParentId;
+  AssetStackResponseDto? stack;
 
   List<TagResponseDto> tags;
 
@@ -167,9 +161,7 @@ class AssetResponseDto {
     _deepEquality.equals(other.people, people) &&
     other.resized == resized &&
     other.smartInfo == smartInfo &&
-    _deepEquality.equals(other.stack, stack) &&
-    other.stackCount == stackCount &&
-    other.stackParentId == stackParentId &&
+    other.stack == stack &&
     _deepEquality.equals(other.tags, tags) &&
     other.thumbhash == thumbhash &&
     other.type == type &&
@@ -204,9 +196,7 @@ class AssetResponseDto {
     (people.hashCode) +
     (resized.hashCode) +
     (smartInfo == null ? 0 : smartInfo!.hashCode) +
-    (stack.hashCode) +
-    (stackCount == null ? 0 : stackCount!.hashCode) +
-    (stackParentId == null ? 0 : stackParentId!.hashCode) +
+    (stack == null ? 0 : stack!.hashCode) +
     (tags.hashCode) +
     (thumbhash == null ? 0 : thumbhash!.hashCode) +
     (type.hashCode) +
@@ -214,7 +204,7 @@ class AssetResponseDto {
     (updatedAt.hashCode);
 
   @override
-  String toString() => 'AssetResponseDto[checksum=$checksum, deviceAssetId=$deviceAssetId, deviceId=$deviceId, duplicateId=$duplicateId, duration=$duration, exifInfo=$exifInfo, fileCreatedAt=$fileCreatedAt, fileModifiedAt=$fileModifiedAt, hasMetadata=$hasMetadata, id=$id, isArchived=$isArchived, isFavorite=$isFavorite, isOffline=$isOffline, isTrashed=$isTrashed, libraryId=$libraryId, livePhotoVideoId=$livePhotoVideoId, localDateTime=$localDateTime, originalFileName=$originalFileName, originalMimeType=$originalMimeType, originalPath=$originalPath, owner=$owner, ownerId=$ownerId, people=$people, resized=$resized, smartInfo=$smartInfo, stack=$stack, stackCount=$stackCount, stackParentId=$stackParentId, tags=$tags, thumbhash=$thumbhash, type=$type, unassignedFaces=$unassignedFaces, updatedAt=$updatedAt]';
+  String toString() => 'AssetResponseDto[checksum=$checksum, deviceAssetId=$deviceAssetId, deviceId=$deviceId, duplicateId=$duplicateId, duration=$duration, exifInfo=$exifInfo, fileCreatedAt=$fileCreatedAt, fileModifiedAt=$fileModifiedAt, hasMetadata=$hasMetadata, id=$id, isArchived=$isArchived, isFavorite=$isFavorite, isOffline=$isOffline, isTrashed=$isTrashed, libraryId=$libraryId, livePhotoVideoId=$livePhotoVideoId, localDateTime=$localDateTime, originalFileName=$originalFileName, originalMimeType=$originalMimeType, originalPath=$originalPath, owner=$owner, ownerId=$ownerId, people=$people, resized=$resized, smartInfo=$smartInfo, stack=$stack, tags=$tags, thumbhash=$thumbhash, type=$type, unassignedFaces=$unassignedFaces, updatedAt=$updatedAt]';
 
   Map<String, dynamic> toJson() {
     final json = <String, dynamic>{};
@@ -271,16 +261,10 @@ class AssetResponseDto {
     } else {
     //  json[r'smartInfo'] = null;
     }
+    if (this.stack != null) {
       json[r'stack'] = this.stack;
-    if (this.stackCount != null) {
-      json[r'stackCount'] = this.stackCount;
     } else {
-    //  json[r'stackCount'] = null;
-    }
-    if (this.stackParentId != null) {
-      json[r'stackParentId'] = this.stackParentId;
-    } else {
-    //  json[r'stackParentId'] = null;
+    //  json[r'stack'] = null;
     }
       json[r'tags'] = this.tags;
     if (this.thumbhash != null) {
@@ -327,9 +311,7 @@ class AssetResponseDto {
         people: PersonWithFacesResponseDto.listFromJson(json[r'people']),
         resized: mapValueOfType<bool>(json, r'resized')!,
         smartInfo: SmartInfoResponseDto.fromJson(json[r'smartInfo']),
-        stack: AssetResponseDto.listFromJson(json[r'stack']),
-        stackCount: mapValueOfType<int>(json, r'stackCount'),
-        stackParentId: mapValueOfType<String>(json, r'stackParentId'),
+        stack: AssetStackResponseDto.fromJson(json[r'stack']),
         tags: TagResponseDto.listFromJson(json[r'tags']),
         thumbhash: mapValueOfType<String>(json, r'thumbhash'),
         type: AssetTypeEnum.fromJson(json[r'type'])!,
@@ -399,7 +381,6 @@ class AssetResponseDto {
     'originalPath',
     'ownerId',
     'resized',
-    'stackCount',
     'thumbhash',
     'type',
     'updatedAt',

mobile/openapi/lib/model/asset_stack_response_dto.dart

@@ -0,0 +1,114 @@
+//
+// 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 AssetStackResponseDto {
+  /// Returns a new [AssetStackResponseDto] instance.
+  AssetStackResponseDto({
+    required this.assetCount,
+    required this.id,
+    required this.primaryAssetId,
+  });
+
+  int assetCount;
+
+  String id;
+
+  String primaryAssetId;
+
+  @override
+  bool operator ==(Object other) => identical(this, other) || other is AssetStackResponseDto &&
+    other.assetCount == assetCount &&
+    other.id == id &&
+    other.primaryAssetId == primaryAssetId;
+
+  @override
+  int get hashCode =>
+    // ignore: unnecessary_parenthesis
+    (assetCount.hashCode) +
+    (id.hashCode) +
+    (primaryAssetId.hashCode);
+
+  @override
+  String toString() => 'AssetStackResponseDto[assetCount=$assetCount, id=$id, primaryAssetId=$primaryAssetId]';
+
+  Map<String, dynamic> toJson() {
+    final json = <String, dynamic>{};
+      json[r'assetCount'] = this.assetCount;
+      json[r'id'] = this.id;
+      json[r'primaryAssetId'] = this.primaryAssetId;
+    return json;
+  }
+
+  /// Returns a new [AssetStackResponseDto] instance and imports its values from
+  /// [value] if it's a [Map], null otherwise.
+  // ignore: prefer_constructors_over_static_methods
+  static AssetStackResponseDto? fromJson(dynamic value) {
+    if (value is Map) {
+      final json = value.cast<String, dynamic>();
+
+      return AssetStackResponseDto(
+        assetCount: mapValueOfType<int>(json, r'assetCount')!,
+        id: mapValueOfType<String>(json, r'id')!,
+        primaryAssetId: mapValueOfType<String>(json, r'primaryAssetId')!,
+      );
+    }
+    return null;
+  }
+
+  static List<AssetStackResponseDto> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <AssetStackResponseDto>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = AssetStackResponseDto.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+
+  static Map<String, AssetStackResponseDto> mapFromJson(dynamic json) {
+    final map = <String, AssetStackResponseDto>{};
+    if (json is Map && json.isNotEmpty) {
+      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
+      for (final entry in json.entries) {
+        final value = AssetStackResponseDto.fromJson(entry.value);
+        if (value != null) {
+          map[entry.key] = value;
+        }
+      }
+    }
+    return map;
+  }
+
+  // maps a json object with a list of AssetStackResponseDto-objects as value to a dart map
+  static Map<String, List<AssetStackResponseDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<AssetStackResponseDto>>{};
+    if (json is Map && json.isNotEmpty) {
+      // ignore: parameter_assignments
+      json = json.cast<String, dynamic>();
+      for (final entry in json.entries) {
+        map[entry.key] = AssetStackResponseDto.listFromJson(entry.value, growable: growable,);
+      }
+    }
+    return map;
+  }
+
+  /// The list of required keys that must be present in a JSON.
+  static const requiredKeys = <String>{
+    'assetCount',
+    'id',
+    'primaryAssetId',
+  };
+}
+

mobile/openapi/lib/model/permission.dart

@@ -82,6 +82,10 @@ class Permission {
   static const sharedLinkPeriodRead = Permission._(r'sharedLink.read');
   static const sharedLinkPeriodUpdate = Permission._(r'sharedLink.update');
   static const sharedLinkPeriodDelete = Permission._(r'sharedLink.delete');
+  static const stackPeriodCreate = Permission._(r'stack.create');
+  static const stackPeriodRead = Permission._(r'stack.read');
+  static const stackPeriodUpdate = Permission._(r'stack.update');
+  static const stackPeriodDelete = Permission._(r'stack.delete');
   static const systemConfigPeriodRead = Permission._(r'systemConfig.read');
   static const systemConfigPeriodUpdate = Permission._(r'systemConfig.update');
   static const systemMetadataPeriodRead = Permission._(r'systemMetadata.read');
@@ -156,6 +160,10 @@ class Permission {
     sharedLinkPeriodRead,
     sharedLinkPeriodUpdate,
     sharedLinkPeriodDelete,
+    stackPeriodCreate,
+    stackPeriodRead,
+    stackPeriodUpdate,
+    stackPeriodDelete,
     systemConfigPeriodRead,
     systemConfigPeriodUpdate,
     systemMetadataPeriodRead,
@@ -265,6 +273,10 @@ class PermissionTypeTransformer {
         case r'sharedLink.read': return Permission.sharedLinkPeriodRead;
         case r'sharedLink.update': return Permission.sharedLinkPeriodUpdate;
         case r'sharedLink.delete': return Permission.sharedLinkPeriodDelete;
+        case r'stack.create': return Permission.stackPeriodCreate;
+        case r'stack.read': return Permission.stackPeriodRead;
+        case r'stack.update': return Permission.stackPeriodUpdate;
+        case r'stack.delete': return Permission.stackPeriodDelete;
         case r'systemConfig.read': return Permission.systemConfigPeriodRead;
         case r'systemConfig.update': return Permission.systemConfigPeriodUpdate;
         case r'systemMetadata.read': return Permission.systemMetadataPeriodRead;

mobile/openapi/lib/model/stack_create_dto.dart

@@ -0,0 +1,101 @@
+//
+// 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 StackCreateDto {
+  /// Returns a new [StackCreateDto] instance.
+  StackCreateDto({
+    this.assetIds = const [],
+  });
+
+  /// first asset becomes the primary
+  List<String> assetIds;
+
+  @override
+  bool operator ==(Object other) => identical(this, other) || other is StackCreateDto &&
+    _deepEquality.equals(other.assetIds, assetIds);
+
+  @override
+  int get hashCode =>
+    // ignore: unnecessary_parenthesis
+    (assetIds.hashCode);
+
+  @override
+  String toString() => 'StackCreateDto[assetIds=$assetIds]';
+
+  Map<String, dynamic> toJson() {
+    final json = <String, dynamic>{};
+      json[r'assetIds'] = this.assetIds;
+    return json;
+  }
+
+  /// Returns a new [StackCreateDto] instance and imports its values from
+  /// [value] if it's a [Map], null otherwise.
+  // ignore: prefer_constructors_over_static_methods
+  static StackCreateDto? fromJson(dynamic value) {
+    if (value is Map) {
+      final json = value.cast<String, dynamic>();
+
+      return StackCreateDto(
+        assetIds: json[r'assetIds'] is Iterable
+            ? (json[r'assetIds'] as Iterable).cast<String>().toList(growable: false)
+            : const [],
+      );
+    }
+    return null;
+  }
+
+  static List<StackCreateDto> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <StackCreateDto>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = StackCreateDto.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+
+  static Map<String, StackCreateDto> mapFromJson(dynamic json) {
+    final map = <String, StackCreateDto>{};
+    if (json is Map && json.isNotEmpty) {
+      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
+      for (final entry in json.entries) {
+        final value = StackCreateDto.fromJson(entry.value);
+        if (value != null) {
+          map[entry.key] = value;
+        }
+      }
+    }
+    return map;
+  }
+
+  // maps a json object with a list of StackCreateDto-objects as value to a dart map
+  static Map<String, List<StackCreateDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<StackCreateDto>>{};
+    if (json is Map && json.isNotEmpty) {
+      // ignore: parameter_assignments
+      json = json.cast<String, dynamic>();
+      for (final entry in json.entries) {
+        map[entry.key] = StackCreateDto.listFromJson(entry.value, growable: growable,);
+      }
+    }
+    return map;
+  }
+
+  /// The list of required keys that must be present in a JSON.
+  static const requiredKeys = <String>{
+    'assetIds',
+  };
+}
+

mobile/openapi/lib/model/stack_response_dto.dart

@@ -0,0 +1,114 @@
+//
+// 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 StackResponseDto {
+  /// Returns a new [StackResponseDto] instance.
+  StackResponseDto({
+    this.assets = const [],
+    required this.id,
+    required this.primaryAssetId,
+  });
+
+  List<AssetResponseDto> assets;
+
+  String id;
+
+  String primaryAssetId;
+
+  @override
+  bool operator ==(Object other) => identical(this, other) || other is StackResponseDto &&
+    _deepEquality.equals(other.assets, assets) &&
+    other.id == id &&
+    other.primaryAssetId == primaryAssetId;
+
+  @override
+  int get hashCode =>
+    // ignore: unnecessary_parenthesis
+    (assets.hashCode) +
+    (id.hashCode) +
+    (primaryAssetId.hashCode);
+
+  @override
+  String toString() => 'StackResponseDto[assets=$assets, id=$id, primaryAssetId=$primaryAssetId]';
+
+  Map<String, dynamic> toJson() {
+    final json = <String, dynamic>{};
+      json[r'assets'] = this.assets;
+      json[r'id'] = this.id;
+      json[r'primaryAssetId'] = this.primaryAssetId;
+    return json;
+  }
+
+  /// Returns a new [StackResponseDto] instance and imports its values from
+  /// [value] if it's a [Map], null otherwise.
+  // ignore: prefer_constructors_over_static_methods
+  static StackResponseDto? fromJson(dynamic value) {
+    if (value is Map) {
+      final json = value.cast<String, dynamic>();
+
+      return StackResponseDto(
+        assets: AssetResponseDto.listFromJson(json[r'assets']),
+        id: mapValueOfType<String>(json, r'id')!,
+        primaryAssetId: mapValueOfType<String>(json, r'primaryAssetId')!,
+      );
+    }
+    return null;
+  }
+
+  static List<StackResponseDto> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <StackResponseDto>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = StackResponseDto.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+
+  static Map<String, StackResponseDto> mapFromJson(dynamic json) {
+    final map = <String, StackResponseDto>{};
+    if (json is Map && json.isNotEmpty) {
+      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
+      for (final entry in json.entries) {
+        final value = StackResponseDto.fromJson(entry.value);
+        if (value != null) {
+          map[entry.key] = value;
+        }
+      }
+    }
+    return map;
+  }
+
+  // maps a json object with a list of StackResponseDto-objects as value to a dart map
+  static Map<String, List<StackResponseDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<StackResponseDto>>{};
+    if (json is Map && json.isNotEmpty) {
+      // ignore: parameter_assignments
+      json = json.cast<String, dynamic>();
+      for (final entry in json.entries) {
+        map[entry.key] = StackResponseDto.listFromJson(entry.value, growable: growable,);
+      }
+    }
+    return map;
+  }
+
+  /// The list of required keys that must be present in a JSON.
+  static const requiredKeys = <String>{
+    'assets',
+    'id',
+    'primaryAssetId',
+  };
+}
+

mobile/openapi/lib/model/stack_update_dto.dart

@@ -0,0 +1,107 @@
+//
+// 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 StackUpdateDto {
+  /// Returns a new [StackUpdateDto] instance.
+  StackUpdateDto({
+    this.primaryAssetId,
+  });
+
+  ///
+  /// 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
+  /// source code must fall back to having a nullable type.
+  /// Consider adding a "default:" property in the specification file to hide this note.
+  ///
+  String? primaryAssetId;
+
+  @override
+  bool operator ==(Object other) => identical(this, other) || other is StackUpdateDto &&
+    other.primaryAssetId == primaryAssetId;
+
+  @override
+  int get hashCode =>
+    // ignore: unnecessary_parenthesis
+    (primaryAssetId == null ? 0 : primaryAssetId!.hashCode);
+
+  @override
+  String toString() => 'StackUpdateDto[primaryAssetId=$primaryAssetId]';
+
+  Map<String, dynamic> toJson() {
+    final json = <String, dynamic>{};
+    if (this.primaryAssetId != null) {
+      json[r'primaryAssetId'] = this.primaryAssetId;
+    } else {
+    //  json[r'primaryAssetId'] = null;
+    }
+    return json;
+  }
+
+  /// Returns a new [StackUpdateDto] instance and imports its values from
+  /// [value] if it's a [Map], null otherwise.
+  // ignore: prefer_constructors_over_static_methods
+  static StackUpdateDto? fromJson(dynamic value) {
+    if (value is Map) {
+      final json = value.cast<String, dynamic>();
+
+      return StackUpdateDto(
+        primaryAssetId: mapValueOfType<String>(json, r'primaryAssetId'),
+      );
+    }
+    return null;
+  }
+
+  static List<StackUpdateDto> listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <StackUpdateDto>[];
+    if (json is List && json.isNotEmpty) {
+      for (final row in json) {
+        final value = StackUpdateDto.fromJson(row);
+        if (value != null) {
+          result.add(value);
+        }
+      }
+    }
+    return result.toList(growable: growable);
+  }
+
+  static Map<String, StackUpdateDto> mapFromJson(dynamic json) {
+    final map = <String, StackUpdateDto>{};
+    if (json is Map && json.isNotEmpty) {
+      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
+      for (final entry in json.entries) {
+        final value = StackUpdateDto.fromJson(entry.value);
+        if (value != null) {
+          map[entry.key] = value;
+        }
+      }
+    }
+    return map;
+  }
+
+  // maps a json object with a list of StackUpdateDto-objects as value to a dart map
+  static Map<String, List<StackUpdateDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<StackUpdateDto>>{};
+    if (json is Map && json.isNotEmpty) {
+      // ignore: parameter_assignments
+      json = json.cast<String, dynamic>();
+      for (final entry in json.entries) {
+        map[entry.key] = StackUpdateDto.listFromJson(entry.value, growable: growable,);
+      }
+    }
+    return map;
+  }
+
+  /// The list of required keys that must be present in a JSON.
+  static const requiredKeys = <String>{
+  };
+}
+

mobile/openapi/lib/model/update_stack_parent_dto.dart

@@ -1,106 +0,0 @@
-//
-// 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 UpdateStackParentDto {
-  /// Returns a new [UpdateStackParentDto] instance.
-  UpdateStackParentDto({
-    required this.newParentId,
-    required this.oldParentId,
-  });
-
-  String newParentId;
-
-  String oldParentId;
-
-  @override
-  bool operator ==(Object other) => identical(this, other) || other is UpdateStackParentDto &&
-    other.newParentId == newParentId &&
-    other.oldParentId == oldParentId;
-
-  @override
-  int get hashCode =>
-    // ignore: unnecessary_parenthesis
-    (newParentId.hashCode) +
-    (oldParentId.hashCode);
-
-  @override
-  String toString() => 'UpdateStackParentDto[newParentId=$newParentId, oldParentId=$oldParentId]';
-
-  Map<String, dynamic> toJson() {
-    final json = <String, dynamic>{};
-      json[r'newParentId'] = this.newParentId;
-      json[r'oldParentId'] = this.oldParentId;
-    return json;
-  }
-
-  /// Returns a new [UpdateStackParentDto] instance and imports its values from
-  /// [value] if it's a [Map], null otherwise.
-  // ignore: prefer_constructors_over_static_methods
-  static UpdateStackParentDto? fromJson(dynamic value) {
-    if (value is Map) {
-      final json = value.cast<String, dynamic>();
-
-      return UpdateStackParentDto(
-        newParentId: mapValueOfType<String>(json, r'newParentId')!,
-        oldParentId: mapValueOfType<String>(json, r'oldParentId')!,
-      );
-    }
-    return null;
-  }
-
-  static List<UpdateStackParentDto> listFromJson(dynamic json, {bool growable = false,}) {
-    final result = <UpdateStackParentDto>[];
-    if (json is List && json.isNotEmpty) {
-      for (final row in json) {
-        final value = UpdateStackParentDto.fromJson(row);
-        if (value != null) {
-          result.add(value);
-        }
-      }
-    }
-    return result.toList(growable: growable);
-  }
-
-  static Map<String, UpdateStackParentDto> mapFromJson(dynamic json) {
-    final map = <String, UpdateStackParentDto>{};
-    if (json is Map && json.isNotEmpty) {
-      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
-      for (final entry in json.entries) {
-        final value = UpdateStackParentDto.fromJson(entry.value);
-        if (value != null) {
-          map[entry.key] = value;
-        }
-      }
-    }
-    return map;
-  }
-
-  // maps a json object with a list of UpdateStackParentDto-objects as value to a dart map
-  static Map<String, List<UpdateStackParentDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
-    final map = <String, List<UpdateStackParentDto>>{};
-    if (json is Map && json.isNotEmpty) {
-      // ignore: parameter_assignments
-      json = json.cast<String, dynamic>();
-      for (final entry in json.entries) {
-        map[entry.key] = UpdateStackParentDto.listFromJson(entry.value, growable: growable,);
-      }
-    }
-    return map;
-  }
-
-  /// The list of required keys that must be present in a JSON.
-  static const requiredKeys = <String>{
-    'newParentId',
-    'oldParentId',
-  };
-}
-