refactor(server): device info service (#1071)

* refactor(server): device info service * use upsertDeviceInfo in mobile app * fix: return types and dedupe code Co-authored-by: Fynn Petersen-Frey <zoodyy@users.noreply.github.com>
2025-10-29 17:40:28 +00:00 · 2022-12-08 10:57:07 -05:00
parent b8e26a2112
commit cefdd86b7f
23 changed files with 468 additions and 443 deletions
--- a/mobile/lib/modules/backup/services/backup.service.dart
+++ b/mobile/lib/modules/backup/services/backup.service.dart
@@ -376,8 +376,8 @@ class BackupService {
    DeviceTypeEnum deviceType,
  ) async {
    try {
-      var updatedDeviceInfo = await _apiService.deviceInfoApi.updateDeviceInfo(
-        UpdateDeviceInfoDto(
+      var updatedDeviceInfo = await _apiService.deviceInfoApi.upsertDeviceInfo(
+        UpsertDeviceInfoDto(
          deviceId: deviceId,
          deviceType: deviceType,
          isAutoBackup: status,
--- a/mobile/lib/modules/login/providers/authentication.provider.dart
+++ b/mobile/lib/modules/login/providers/authentication.provider.dart
@@ -210,8 +210,8 @@ class AuthenticationNotifier extends StateNotifier<AuthenticationState> {
    // Register device info
    try {
      DeviceInfoResponseDto? deviceInfo =
-          await _apiService.deviceInfoApi.createDeviceInfo(
-        CreateDeviceInfoDto(
+          await _apiService.deviceInfoApi.upsertDeviceInfo(
+        UpsertDeviceInfoDto(
          deviceId: state.deviceId,
          deviceType: state.deviceType,
        ),
--- a/mobile/openapi/.openapi-generator/FILES
+++ b/mobile/openapi/.openapi-generator/FILES
@@ -24,7 +24,6 @@ doc/CheckDuplicateAssetResponseDto.md
 doc/CheckExistingAssetsDto.md
 doc/CheckExistingAssetsResponseDto.md
 doc/CreateAlbumDto.md
-doc/CreateDeviceInfoDto.md
 doc/CreateProfileImageResponseDto.md
 doc/CreateTagDto.md
 doc/CreateUserDto.md
@@ -72,9 +71,9 @@ doc/ThumbnailFormat.md
 doc/TimeGroupEnum.md
 doc/UpdateAlbumDto.md
 doc/UpdateAssetDto.md
-doc/UpdateDeviceInfoDto.md
 doc/UpdateTagDto.md
 doc/UpdateUserDto.md
+doc/UpsertDeviceInfoDto.md
 doc/UsageByUserDto.md
 doc/UserApi.md
 doc/UserCountResponseDto.md
@@ -118,7 +117,6 @@ lib/model/check_duplicate_asset_response_dto.dart
 lib/model/check_existing_assets_dto.dart
 lib/model/check_existing_assets_response_dto.dart
 lib/model/create_album_dto.dart
-lib/model/create_device_info_dto.dart
 lib/model/create_profile_image_response_dto.dart
 lib/model/create_tag_dto.dart
 lib/model/create_user_dto.dart
@@ -160,9 +158,9 @@ lib/model/thumbnail_format.dart
 lib/model/time_group_enum.dart
 lib/model/update_album_dto.dart
 lib/model/update_asset_dto.dart
-lib/model/update_device_info_dto.dart
 lib/model/update_tag_dto.dart
 lib/model/update_user_dto.dart
+lib/model/upsert_device_info_dto.dart
 lib/model/usage_by_user_dto.dart
 lib/model/user_count_response_dto.dart
 lib/model/user_response_dto.dart
@@ -189,7 +187,6 @@ test/check_duplicate_asset_response_dto_test.dart
 test/check_existing_assets_dto_test.dart
 test/check_existing_assets_response_dto_test.dart
 test/create_album_dto_test.dart
-test/create_device_info_dto_test.dart
 test/create_profile_image_response_dto_test.dart
 test/create_tag_dto_test.dart
 test/create_user_dto_test.dart
@@ -237,9 +234,9 @@ test/thumbnail_format_test.dart
 test/time_group_enum_test.dart
 test/update_album_dto_test.dart
 test/update_asset_dto_test.dart
-test/update_device_info_dto_test.dart
 test/update_tag_dto_test.dart
 test/update_user_dto_test.dart
+test/upsert_device_info_dto_test.dart
 test/usage_by_user_dto_test.dart
 test/user_api_test.dart
 test/user_count_response_dto_test.dart
--- a/mobile/openapi/README.md
+++ b/mobile/openapi/README.md
@@ -101,6 +101,7 @@ Class | Method | HTTP request | Description
 *AuthenticationApi* | [**validateAccessToken**](doc//AuthenticationApi.md#validateaccesstoken) | **POST** /auth/validateToken | 
 *DeviceInfoApi* | [**createDeviceInfo**](doc//DeviceInfoApi.md#createdeviceinfo) | **POST** /device-info | 
 *DeviceInfoApi* | [**updateDeviceInfo**](doc//DeviceInfoApi.md#updatedeviceinfo) | **PATCH** /device-info | 
+*DeviceInfoApi* | [**upsertDeviceInfo**](doc//DeviceInfoApi.md#upsertdeviceinfo) | **PUT** /device-info | 
 *JobApi* | [**getAllJobsStatus**](doc//JobApi.md#getalljobsstatus) | **GET** /jobs | 
 *JobApi* | [**getJobStatus**](doc//JobApi.md#getjobstatus) | **GET** /jobs/{jobId} | 
 *JobApi* | [**sendJobCommand**](doc//JobApi.md#sendjobcommand) | **PUT** /jobs/{jobId} | 
@@ -149,7 +150,6 @@ Class | Method | HTTP request | Description
 - [CheckExistingAssetsDto](doc//CheckExistingAssetsDto.md)
 - [CheckExistingAssetsResponseDto](doc//CheckExistingAssetsResponseDto.md)
 - [CreateAlbumDto](doc//CreateAlbumDto.md)
- - [CreateDeviceInfoDto](doc//CreateDeviceInfoDto.md)
 - [CreateProfileImageResponseDto](doc//CreateProfileImageResponseDto.md)
 - [CreateTagDto](doc//CreateTagDto.md)
 - [CreateUserDto](doc//CreateUserDto.md)
@@ -191,9 +191,9 @@ Class | Method | HTTP request | Description
 - [TimeGroupEnum](doc//TimeGroupEnum.md)
 - [UpdateAlbumDto](doc//UpdateAlbumDto.md)
 - [UpdateAssetDto](doc//UpdateAssetDto.md)
- - [UpdateDeviceInfoDto](doc//UpdateDeviceInfoDto.md)
 - [UpdateTagDto](doc//UpdateTagDto.md)
 - [UpdateUserDto](doc//UpdateUserDto.md)
+ - [UpsertDeviceInfoDto](doc//UpsertDeviceInfoDto.md)
 - [UsageByUserDto](doc//UsageByUserDto.md)
 - [UserCountResponseDto](doc//UserCountResponseDto.md)
 - [UserResponseDto](doc//UserResponseDto.md)
--- a/mobile/openapi/doc/DeviceInfoApi.md
+++ b/mobile/openapi/doc/DeviceInfoApi.md
@@ -11,13 +11,16 @@ Method | HTTP request | Description
 ------------- | ------------- | -------------
 [**createDeviceInfo**](DeviceInfoApi.md#createdeviceinfo) | **POST** /device-info | 
 [**updateDeviceInfo**](DeviceInfoApi.md#updatedeviceinfo) | **PATCH** /device-info | 
+[**upsertDeviceInfo**](DeviceInfoApi.md#upsertdeviceinfo) | **PUT** /device-info | 


 # **createDeviceInfo**
-> DeviceInfoResponseDto createDeviceInfo(createDeviceInfoDto)
+> DeviceInfoResponseDto createDeviceInfo(upsertDeviceInfoDto)



+@deprecated
+
 ### Example
 ```dart
 import 'package:openapi/api.dart';
@@ -29,10 +32,10 @@ import 'package:openapi/api.dart';
 //defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken(yourTokenGeneratorFunction);

 final api_instance = DeviceInfoApi();
-final createDeviceInfoDto = CreateDeviceInfoDto(); // CreateDeviceInfoDto | 
+final upsertDeviceInfoDto = UpsertDeviceInfoDto(); // UpsertDeviceInfoDto | 

 try {
-    final result = api_instance.createDeviceInfo(createDeviceInfoDto);
+    final result = api_instance.createDeviceInfo(upsertDeviceInfoDto);
    print(result);
 } catch (e) {
    print('Exception when calling DeviceInfoApi->createDeviceInfo: $e\n');
@@ -43,7 +46,7 @@ try {

 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **createDeviceInfoDto** | [**CreateDeviceInfoDto**](CreateDeviceInfoDto.md)|  | 
+ **upsertDeviceInfoDto** | [**UpsertDeviceInfoDto**](UpsertDeviceInfoDto.md)|  | 

 ### Return type

@@ -61,10 +64,12 @@ Name | Type | Description  | Notes
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)

 # **updateDeviceInfo**
-> DeviceInfoResponseDto updateDeviceInfo(updateDeviceInfoDto)
+> DeviceInfoResponseDto updateDeviceInfo(upsertDeviceInfoDto)



+@deprecated
+
 ### Example
 ```dart
 import 'package:openapi/api.dart';
@@ -76,10 +81,10 @@ import 'package:openapi/api.dart';
 //defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken(yourTokenGeneratorFunction);

 final api_instance = DeviceInfoApi();
-final updateDeviceInfoDto = UpdateDeviceInfoDto(); // UpdateDeviceInfoDto | 
+final upsertDeviceInfoDto = UpsertDeviceInfoDto(); // UpsertDeviceInfoDto | 

 try {
-    final result = api_instance.updateDeviceInfo(updateDeviceInfoDto);
+    final result = api_instance.updateDeviceInfo(upsertDeviceInfoDto);
    print(result);
 } catch (e) {
    print('Exception when calling DeviceInfoApi->updateDeviceInfo: $e\n');
@@ -90,7 +95,54 @@ try {

 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **updateDeviceInfoDto** | [**UpdateDeviceInfoDto**](UpdateDeviceInfoDto.md)|  | 
+ **upsertDeviceInfoDto** | [**UpsertDeviceInfoDto**](UpsertDeviceInfoDto.md)|  | 
+
+### Return type
+
+[**DeviceInfoResponseDto**](DeviceInfoResponseDto.md)
+
+### Authorization
+
+[bearer](../README.md#bearer)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **upsertDeviceInfo**
+> DeviceInfoResponseDto upsertDeviceInfo(upsertDeviceInfoDto)
+
+
+
+### Example
+```dart
+import 'package:openapi/api.dart';
+// TODO Configure HTTP Bearer authorization: bearer
+// Case 1. Use String Token
+//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken('YOUR_ACCESS_TOKEN');
+// Case 2. Use Function which generate token.
+// String yourTokenGeneratorFunction() { ... }
+//defaultApiClient.getAuthentication<HttpBearerAuth>('bearer').setAccessToken(yourTokenGeneratorFunction);
+
+final api_instance = DeviceInfoApi();
+final upsertDeviceInfoDto = UpsertDeviceInfoDto(); // UpsertDeviceInfoDto | 
+
+try {
+    final result = api_instance.upsertDeviceInfo(upsertDeviceInfoDto);
+    print(result);
+} catch (e) {
+    print('Exception when calling DeviceInfoApi->upsertDeviceInfo: $e\n');
+}
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **upsertDeviceInfoDto** | [**UpsertDeviceInfoDto**](UpsertDeviceInfoDto.md)|  | 

 ### Return type

--- a/mobile/openapi/doc/UpdateDeviceInfoDto.md
+++ b/mobile/openapi/doc/UpdateDeviceInfoDto.md
@@ -1,17 +0,0 @@
-# openapi.model.UpdateDeviceInfoDto
-
-## Load the model package
-```dart
-import 'package:openapi/api.dart';
-```
-
-## Properties
-Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
-**deviceType** | [**DeviceTypeEnum**](DeviceTypeEnum.md) |  | 
-**deviceId** | **String** |  | 
-**isAutoBackup** | **bool** |  | [optional] 
-
-[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
-
-
--- a/mobile/openapi/doc/UpsertDeviceInfoDto.md
+++ b/mobile/openapi/doc/UpsertDeviceInfoDto.md
@@ -1,4 +1,4 @@
-# openapi.model.CreateDeviceInfoDto
+# openapi.model.UpsertDeviceInfoDto

 ## Load the model package
 ```dart
--- a/mobile/openapi/lib/api.dart
+++ b/mobile/openapi/lib/api.dart
@@ -56,7 +56,6 @@ part 'model/check_duplicate_asset_response_dto.dart';
 part 'model/check_existing_assets_dto.dart';
 part 'model/check_existing_assets_response_dto.dart';
 part 'model/create_album_dto.dart';
-part 'model/create_device_info_dto.dart';
 part 'model/create_profile_image_response_dto.dart';
 part 'model/create_tag_dto.dart';
 part 'model/create_user_dto.dart';
@@ -98,9 +97,9 @@ part 'model/thumbnail_format.dart';
 part 'model/time_group_enum.dart';
 part 'model/update_album_dto.dart';
 part 'model/update_asset_dto.dart';
-part 'model/update_device_info_dto.dart';
 part 'model/update_tag_dto.dart';
 part 'model/update_user_dto.dart';
+part 'model/upsert_device_info_dto.dart';
 part 'model/usage_by_user_dto.dart';
 part 'model/user_count_response_dto.dart';
 part 'model/user_response_dto.dart';
--- a/mobile/openapi/lib/api/device_info_api.dart
+++ b/mobile/openapi/lib/api/device_info_api.dart
@@ -16,16 +16,21 @@ class DeviceInfoApi {

  final ApiClient apiClient;

-  /// Performs an HTTP 'POST /device-info' operation and returns the [Response].
+  /// 
+  ///
+  /// @deprecated
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
  /// Parameters:
  ///
-  /// * [CreateDeviceInfoDto] createDeviceInfoDto (required):
-  Future<Response> createDeviceInfoWithHttpInfo(CreateDeviceInfoDto createDeviceInfoDto,) async {
+  /// * [UpsertDeviceInfoDto] upsertDeviceInfoDto (required):
+  Future<Response> createDeviceInfoWithHttpInfo(UpsertDeviceInfoDto upsertDeviceInfoDto,) async {
    // ignore: prefer_const_declarations
    final path = r'/device-info';

    // ignore: prefer_final_locals
-    Object? postBody = createDeviceInfoDto;
+    Object? postBody = upsertDeviceInfoDto;

    final queryParams = <QueryParam>[];
    final headerParams = <String, String>{};
@@ -45,11 +50,15 @@ class DeviceInfoApi {
    );
  }

+  /// 
+  ///
+  /// @deprecated
+  ///
  /// Parameters:
  ///
-  /// * [CreateDeviceInfoDto] createDeviceInfoDto (required):
-  Future<DeviceInfoResponseDto?> createDeviceInfo(CreateDeviceInfoDto createDeviceInfoDto,) async {
-    final response = await createDeviceInfoWithHttpInfo(createDeviceInfoDto,);
+  /// * [UpsertDeviceInfoDto] upsertDeviceInfoDto (required):
+  Future<DeviceInfoResponseDto?> createDeviceInfo(UpsertDeviceInfoDto upsertDeviceInfoDto,) async {
+    final response = await createDeviceInfoWithHttpInfo(upsertDeviceInfoDto,);
    if (response.statusCode >= HttpStatus.badRequest) {
      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
    }
@@ -63,16 +72,21 @@ class DeviceInfoApi {
    return null;
  }

-  /// Performs an HTTP 'PATCH /device-info' operation and returns the [Response].
+  /// 
+  ///
+  /// @deprecated
+  ///
+  /// Note: This method returns the HTTP [Response].
+  ///
  /// Parameters:
  ///
-  /// * [UpdateDeviceInfoDto] updateDeviceInfoDto (required):
-  Future<Response> updateDeviceInfoWithHttpInfo(UpdateDeviceInfoDto updateDeviceInfoDto,) async {
+  /// * [UpsertDeviceInfoDto] upsertDeviceInfoDto (required):
+  Future<Response> updateDeviceInfoWithHttpInfo(UpsertDeviceInfoDto upsertDeviceInfoDto,) async {
    // ignore: prefer_const_declarations
    final path = r'/device-info';

    // ignore: prefer_final_locals
-    Object? postBody = updateDeviceInfoDto;
+    Object? postBody = upsertDeviceInfoDto;

    final queryParams = <QueryParam>[];
    final headerParams = <String, String>{};
@@ -92,11 +106,62 @@ class DeviceInfoApi {
    );
  }

+  /// 
+  ///
+  /// @deprecated
+  ///
  /// Parameters:
  ///
-  /// * [UpdateDeviceInfoDto] updateDeviceInfoDto (required):
-  Future<DeviceInfoResponseDto?> updateDeviceInfo(UpdateDeviceInfoDto updateDeviceInfoDto,) async {
-    final response = await updateDeviceInfoWithHttpInfo(updateDeviceInfoDto,);
+  /// * [UpsertDeviceInfoDto] upsertDeviceInfoDto (required):
+  Future<DeviceInfoResponseDto?> updateDeviceInfo(UpsertDeviceInfoDto upsertDeviceInfoDto,) async {
+    final response = await updateDeviceInfoWithHttpInfo(upsertDeviceInfoDto,);
+    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), 'DeviceInfoResponseDto',) as DeviceInfoResponseDto;
+    
+    }
+    return null;
+  }
+
+  /// Performs an HTTP 'PUT /device-info' operation and returns the [Response].
+  /// Parameters:
+  ///
+  /// * [UpsertDeviceInfoDto] upsertDeviceInfoDto (required):
+  Future<Response> upsertDeviceInfoWithHttpInfo(UpsertDeviceInfoDto upsertDeviceInfoDto,) async {
+    // ignore: prefer_const_declarations
+    final path = r'/device-info';
+
+    // ignore: prefer_final_locals
+    Object? postBody = upsertDeviceInfoDto;
+
+    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:
+  ///
+  /// * [UpsertDeviceInfoDto] upsertDeviceInfoDto (required):
+  Future<DeviceInfoResponseDto?> upsertDeviceInfo(UpsertDeviceInfoDto upsertDeviceInfoDto,) async {
+    final response = await upsertDeviceInfoWithHttpInfo(upsertDeviceInfoDto,);
    if (response.statusCode >= HttpStatus.badRequest) {
      throw ApiException(response.statusCode, await _decodeBodyBytes(response));
    }
--- a/mobile/openapi/lib/api_client.dart
+++ b/mobile/openapi/lib/api_client.dart
@@ -228,8 +228,6 @@ class ApiClient {
          return CheckExistingAssetsResponseDto.fromJson(value);
        case 'CreateAlbumDto':
          return CreateAlbumDto.fromJson(value);
-        case 'CreateDeviceInfoDto':
-          return CreateDeviceInfoDto.fromJson(value);
        case 'CreateProfileImageResponseDto':
          return CreateProfileImageResponseDto.fromJson(value);
        case 'CreateTagDto':
@@ -312,12 +310,12 @@ class ApiClient {
          return UpdateAlbumDto.fromJson(value);
        case 'UpdateAssetDto':
          return UpdateAssetDto.fromJson(value);
-        case 'UpdateDeviceInfoDto':
-          return UpdateDeviceInfoDto.fromJson(value);
        case 'UpdateTagDto':
          return UpdateTagDto.fromJson(value);
        case 'UpdateUserDto':
          return UpdateUserDto.fromJson(value);
+        case 'UpsertDeviceInfoDto':
+          return UpsertDeviceInfoDto.fromJson(value);
        case 'UsageByUserDto':
          return UsageByUserDto.fromJson(value);
        case 'UserCountResponseDto':
--- a/mobile/openapi/lib/model/create_device_info_dto.dart
+++ b/mobile/openapi/lib/model/create_device_info_dto.dart
@@ -1,136 +0,0 @@
-//
-// AUTO-GENERATED FILE, DO NOT MODIFY!
-//
-// @dart=2.12
-
-// 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 CreateDeviceInfoDto {
-  /// Returns a new [CreateDeviceInfoDto] instance.
-  CreateDeviceInfoDto({
-    required this.deviceType,
-    required this.deviceId,
-    this.isAutoBackup,
-  });
-
-  DeviceTypeEnum deviceType;
-
-  String deviceId;
-
-  ///
-  /// 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? isAutoBackup;
-
-  @override
-  bool operator ==(Object other) => identical(this, other) || other is CreateDeviceInfoDto &&
-     other.deviceType == deviceType &&
-     other.deviceId == deviceId &&
-     other.isAutoBackup == isAutoBackup;
-
-  @override
-  int get hashCode =>
-    // ignore: unnecessary_parenthesis
-    (deviceType.hashCode) +
-    (deviceId.hashCode) +
-    (isAutoBackup == null ? 0 : isAutoBackup!.hashCode);
-
-  @override
-  String toString() => 'CreateDeviceInfoDto[deviceType=$deviceType, deviceId=$deviceId, isAutoBackup=$isAutoBackup]';
-
-  Map<String, dynamic> toJson() {
-    final _json = <String, dynamic>{};
-      _json[r'deviceType'] = deviceType;
-      _json[r'deviceId'] = deviceId;
-    if (isAutoBackup != null) {
-      _json[r'isAutoBackup'] = isAutoBackup;
-    } else {
-      _json[r'isAutoBackup'] = null;
-    }
-    return _json;
-  }
-
-  /// Returns a new [CreateDeviceInfoDto] instance and imports its values from
-  /// [value] if it's a [Map], null otherwise.
-  // ignore: prefer_constructors_over_static_methods
-  static CreateDeviceInfoDto? fromJson(dynamic value) {
-    if (value is Map) {
-      final json = value.cast<String, dynamic>();
-
-      // Ensure that the map contains the required keys.
-      // Note 1: the values aren't checked for validity beyond being non-null.
-      // Note 2: this code is stripped in release mode!
-      assert(() {
-        requiredKeys.forEach((key) {
-          assert(json.containsKey(key), 'Required key "CreateDeviceInfoDto[$key]" is missing from JSON.');
-          assert(json[key] != null, 'Required key "CreateDeviceInfoDto[$key]" has a null value in JSON.');
-        });
-        return true;
-      }());
-
-      return CreateDeviceInfoDto(
-        deviceType: DeviceTypeEnum.fromJson(json[r'deviceType'])!,
-        deviceId: mapValueOfType<String>(json, r'deviceId')!,
-        isAutoBackup: mapValueOfType<bool>(json, r'isAutoBackup'),
-      );
-    }
-    return null;
-  }
-
-  static List<CreateDeviceInfoDto>? listFromJson(dynamic json, {bool growable = false,}) {
-    final result = <CreateDeviceInfoDto>[];
-    if (json is List && json.isNotEmpty) {
-      for (final row in json) {
-        final value = CreateDeviceInfoDto.fromJson(row);
-        if (value != null) {
-          result.add(value);
-        }
-      }
-    }
-    return result.toList(growable: growable);
-  }
-
-  static Map<String, CreateDeviceInfoDto> mapFromJson(dynamic json) {
-    final map = <String, CreateDeviceInfoDto>{};
-    if (json is Map && json.isNotEmpty) {
-      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
-      for (final entry in json.entries) {
-        final value = CreateDeviceInfoDto.fromJson(entry.value);
-        if (value != null) {
-          map[entry.key] = value;
-        }
-      }
-    }
-    return map;
-  }
-
-  // maps a json object with a list of CreateDeviceInfoDto-objects as value to a dart map
-  static Map<String, List<CreateDeviceInfoDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
-    final map = <String, List<CreateDeviceInfoDto>>{};
-    if (json is Map && json.isNotEmpty) {
-      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
-      for (final entry in json.entries) {
-        final value = CreateDeviceInfoDto.listFromJson(entry.value, growable: growable,);
-        if (value != null) {
-          map[entry.key] = value;
-        }
-      }
-    }
-    return map;
-  }
-
-  /// The list of required keys that must be present in a JSON.
-  static const requiredKeys = <String>{
-    'deviceType',
-    'deviceId',
-  };
-}
-
--- a/mobile/openapi/lib/model/upsert_device_info_dto.dart
+++ b/mobile/openapi/lib/model/upsert_device_info_dto.dart
@@ -10,9 +10,9 @@

 part of openapi.api;

-class UpdateDeviceInfoDto {
-  /// Returns a new [UpdateDeviceInfoDto] instance.
-  UpdateDeviceInfoDto({
+class UpsertDeviceInfoDto {
+  /// Returns a new [UpsertDeviceInfoDto] instance.
+  UpsertDeviceInfoDto({
    required this.deviceType,
    required this.deviceId,
    this.isAutoBackup,
@@ -31,7 +31,7 @@ class UpdateDeviceInfoDto {
  bool? isAutoBackup;

  @override
-  bool operator ==(Object other) => identical(this, other) || other is UpdateDeviceInfoDto &&
+  bool operator ==(Object other) => identical(this, other) || other is UpsertDeviceInfoDto &&
     other.deviceType == deviceType &&
     other.deviceId == deviceId &&
     other.isAutoBackup == isAutoBackup;
@@ -44,7 +44,7 @@ class UpdateDeviceInfoDto {
    (isAutoBackup == null ? 0 : isAutoBackup!.hashCode);

  @override
-  String toString() => 'UpdateDeviceInfoDto[deviceType=$deviceType, deviceId=$deviceId, isAutoBackup=$isAutoBackup]';
+  String toString() => 'UpsertDeviceInfoDto[deviceType=$deviceType, deviceId=$deviceId, isAutoBackup=$isAutoBackup]';

  Map<String, dynamic> toJson() {
    final _json = <String, dynamic>{};
@@ -58,10 +58,10 @@ class UpdateDeviceInfoDto {
    return _json;
  }

-  /// Returns a new [UpdateDeviceInfoDto] instance and imports its values from
+  /// Returns a new [UpsertDeviceInfoDto] instance and imports its values from
  /// [value] if it's a [Map], null otherwise.
  // ignore: prefer_constructors_over_static_methods
-  static UpdateDeviceInfoDto? fromJson(dynamic value) {
+  static UpsertDeviceInfoDto? fromJson(dynamic value) {
    if (value is Map) {
      final json = value.cast<String, dynamic>();

@@ -70,13 +70,13 @@ class UpdateDeviceInfoDto {
      // Note 2: this code is stripped in release mode!
      assert(() {
        requiredKeys.forEach((key) {
-          assert(json.containsKey(key), 'Required key "UpdateDeviceInfoDto[$key]" is missing from JSON.');
-          assert(json[key] != null, 'Required key "UpdateDeviceInfoDto[$key]" has a null value in JSON.');
+          assert(json.containsKey(key), 'Required key "UpsertDeviceInfoDto[$key]" is missing from JSON.');
+          assert(json[key] != null, 'Required key "UpsertDeviceInfoDto[$key]" has a null value in JSON.');
        });
        return true;
      }());

-      return UpdateDeviceInfoDto(
+      return UpsertDeviceInfoDto(
        deviceType: DeviceTypeEnum.fromJson(json[r'deviceType'])!,
        deviceId: mapValueOfType<String>(json, r'deviceId')!,
        isAutoBackup: mapValueOfType<bool>(json, r'isAutoBackup'),
@@ -85,11 +85,11 @@ class UpdateDeviceInfoDto {
    return null;
  }

-  static List<UpdateDeviceInfoDto>? listFromJson(dynamic json, {bool growable = false,}) {
-    final result = <UpdateDeviceInfoDto>[];
+  static List<UpsertDeviceInfoDto>? listFromJson(dynamic json, {bool growable = false,}) {
+    final result = <UpsertDeviceInfoDto>[];
    if (json is List && json.isNotEmpty) {
      for (final row in json) {
-        final value = UpdateDeviceInfoDto.fromJson(row);
+        final value = UpsertDeviceInfoDto.fromJson(row);
        if (value != null) {
          result.add(value);
        }
@@ -98,12 +98,12 @@ class UpdateDeviceInfoDto {
    return result.toList(growable: growable);
  }

-  static Map<String, UpdateDeviceInfoDto> mapFromJson(dynamic json) {
-    final map = <String, UpdateDeviceInfoDto>{};
+  static Map<String, UpsertDeviceInfoDto> mapFromJson(dynamic json) {
+    final map = <String, UpsertDeviceInfoDto>{};
    if (json is Map && json.isNotEmpty) {
      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
      for (final entry in json.entries) {
-        final value = UpdateDeviceInfoDto.fromJson(entry.value);
+        final value = UpsertDeviceInfoDto.fromJson(entry.value);
        if (value != null) {
          map[entry.key] = value;
        }
@@ -112,13 +112,13 @@ class UpdateDeviceInfoDto {
    return map;
  }

-  // maps a json object with a list of UpdateDeviceInfoDto-objects as value to a dart map
-  static Map<String, List<UpdateDeviceInfoDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
-    final map = <String, List<UpdateDeviceInfoDto>>{};
+  // maps a json object with a list of UpsertDeviceInfoDto-objects as value to a dart map
+  static Map<String, List<UpsertDeviceInfoDto>> mapListFromJson(dynamic json, {bool growable = false,}) {
+    final map = <String, List<UpsertDeviceInfoDto>>{};
    if (json is Map && json.isNotEmpty) {
      json = json.cast<String, dynamic>(); // ignore: parameter_assignments
      for (final entry in json.entries) {
-        final value = UpdateDeviceInfoDto.listFromJson(entry.value, growable: growable,);
+        final value = UpsertDeviceInfoDto.listFromJson(entry.value, growable: growable,);
        if (value != null) {
          map[entry.key] = value;
        }
--- a/mobile/openapi/test/device_info_api_test.dart
+++ b/mobile/openapi/test/device_info_api_test.dart
@@ -17,15 +17,28 @@ void main() {
  // final instance = DeviceInfoApi();

  group('tests for DeviceInfoApi', () {
-    //Future<DeviceInfoResponseDto> createDeviceInfo(CreateDeviceInfoDto createDeviceInfoDto) async
+    // 
+    //
+    // @deprecated
+    //
+    //Future<DeviceInfoResponseDto> createDeviceInfo(UpsertDeviceInfoDto upsertDeviceInfoDto) async
    test('test createDeviceInfo', () async {
      // TODO
    });

-    //Future<DeviceInfoResponseDto> updateDeviceInfo(UpdateDeviceInfoDto updateDeviceInfoDto) async
+    // 
+    //
+    // @deprecated
+    //
+    //Future<DeviceInfoResponseDto> updateDeviceInfo(UpsertDeviceInfoDto upsertDeviceInfoDto) async
    test('test updateDeviceInfo', () async {
      // TODO
    });

+    //Future<DeviceInfoResponseDto> upsertDeviceInfo(UpsertDeviceInfoDto upsertDeviceInfoDto) async
+    test('test upsertDeviceInfo', () async {
+      // TODO
+    });
+
  });
 }
--- a/mobile/openapi/test/update_device_info_dto_test.dart
+++ b/mobile/openapi/test/update_device_info_dto_test.dart
@@ -1,37 +0,0 @@
-//
-// AUTO-GENERATED FILE, DO NOT MODIFY!
-//
-// @dart=2.12
-
-// 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
-
-import 'package:openapi/api.dart';
-import 'package:test/test.dart';
-
-// tests for UpdateDeviceInfoDto
-void main() {
-  // final instance = UpdateDeviceInfoDto();
-
-  group('test UpdateDeviceInfoDto', () {
-    // DeviceTypeEnum deviceType
-    test('to test the property `deviceType`', () async {
-      // TODO
-    });
-
-    // String deviceId
-    test('to test the property `deviceId`', () async {
-      // TODO
-    });
-
-    // bool isAutoBackup
-    test('to test the property `isAutoBackup`', () async {
-      // TODO
-    });
-
-
-  });
-
-}
--- a/mobile/openapi/test/upsert_device_info_dto_test.dart
+++ b/mobile/openapi/test/upsert_device_info_dto_test.dart
@@ -11,11 +11,11 @@
 import 'package:openapi/api.dart';
 import 'package:test/test.dart';

-// tests for CreateDeviceInfoDto
+// tests for UpsertDeviceInfoDto
 void main() {
-  // final instance = CreateDeviceInfoDto();
+  // final instance = UpsertDeviceInfoDto();

-  group('test CreateDeviceInfoDto', () {
+  group('test UpsertDeviceInfoDto', () {
    // DeviceTypeEnum deviceType
    test('to test the property `deviceType`', () async {
      // TODO