From 7e377d3e424fb5b2efab0c3e84f01b091cae14f2 Mon Sep 17 00:00:00 2001
From: Jason Rasmussen <jason@rasm.me>
Date: Wed, 10 Sep 2025 15:35:41 -0400
Subject: [PATCH] chore: deprecate (#21791)

---
 mobile/openapi/README.md                      | Bin 40647 -> 40855 bytes
 mobile/openapi/lib/api/assets_api.dart        | Bin 41929 -> 42101 bytes
 mobile/openapi/lib/api/deprecated_api.dart    | Bin 4091 -> 8560 bytes
 open-api/immich-openapi-specs.json            |  11 +++++++----
 open-api/typescript-sdk/src/fetch-client.ts   |   2 +-
 .../src/controllers/asset-media.controller.ts |   5 +++--
 server/src/decorators.ts                      |  15 ++++++++++++---
 7 files changed, 23 insertions(+), 10 deletions(-)

diff --git a/mobile/openapi/README.md b/mobile/openapi/README.md
index 6cd26aefc48c5e7029312be909c5e5979a02d0d4..339ae6ff5dcd2b75d8f4ee740638a6284eaa8226 100644
GIT binary patch
delta 156
zcmX@UmudQbrVX0n7D1^6If==s3MCn-3W>$VsU-^KnI#ztd8y?JX_+~xI$&;oX^BE|
zMq*xiW?s5NW=XL^X3Az$@j{Nt?()KuuZxLtxug~pr6wnqq^3;%BxX*&p^N2J>H(8<
BIXeIV

delta 32
ocmbQfpXvBsrVX0nJVmJmIf==sj>W~PC7Tn)3pqBIDJa$h0Mq*nL;wH)

diff --git a/mobile/openapi/lib/api/assets_api.dart b/mobile/openapi/lib/api/assets_api.dart
index e16ac2f5358a84702dd80c297d5aa38b864d9c05..063f9ea43b47484495f055adec1743ec7d70271f 100644
GIT binary patch
delta 72
zcmX?koayTcrVW21CyPZ{uyH9U=<DlGUgM?BYGR~kpf|Z7rEaplc-SNzwaxs|o}5?}
KZ7xWOv<Co!mlkvY

delta 89
zcmex*g6ZUOrVW21g^E%OauSnM9gB-oOSlvi^!4>8FHf<b9GdDn*<L(sl8)Ns3GMuw
ZU!}$|POcH++I%PG5<3n(n?q9->;Y8iA|?O;

diff --git a/mobile/openapi/lib/api/deprecated_api.dart b/mobile/openapi/lib/api/deprecated_api.dart
index cdcd27750df1c44c6e3631c76021321fff72b96f..9246998ca23296efa996b49aa83d030399e065c6 100644
GIT binary patch
literal 8560
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
G>&Cx{<j9Nw

delta 10
Rcmez1^jm(zPkyFaE&v{|1dadz

diff --git a/open-api/immich-openapi-specs.json b/open-api/immich-openapi-specs.json
index 5a847fc83..7caf21504 100644
--- a/open-api/immich-openapi-specs.json
+++ b/open-api/immich-openapi-specs.json
@@ -2504,7 +2504,8 @@
         "description": "This endpoint requires the `asset.download` permission."
       },
       "put": {
-        "description": "Replace the asset with new file, without changing its id. This endpoint requires the `asset.replace` permission.",
+        "deprecated": true,
+        "description": "This property was deprecated in v1.142.0. Replace the asset with new file, without changing its id. This endpoint requires the `asset.replace` permission.",
         "operationId": "replaceAsset",
         "parameters": [
           {
@@ -2566,12 +2567,14 @@
             "api_key": []
           }
         ],
-        "summary": "replaceAsset",
+        "summary": "Replace the asset with new file, without changing its id",
         "tags": [
-          "Assets"
+          "Assets",
+          "Deprecated"
         ],
         "x-immich-lifecycle": {
-          "addedAt": "v1.106.0"
+          "addedAt": "v1.106.0",
+          "deprecatedAt": "v1.142.0"
         },
         "x-immich-permission": "asset.replace"
       }
diff --git a/open-api/typescript-sdk/src/fetch-client.ts b/open-api/typescript-sdk/src/fetch-client.ts
index 18f70f9ab..bc38a6907 100644
--- a/open-api/typescript-sdk/src/fetch-client.ts
+++ b/open-api/typescript-sdk/src/fetch-client.ts
@@ -2368,7 +2368,7 @@ export function downloadAsset({ id, key, slug }: {
     }));
 }
 /**
- * replaceAsset
+ * Replace the asset with new file, without changing its id
  */
 export function replaceAsset({ id, key, slug, assetMediaReplaceDto }: {
     id: string;
diff --git a/server/src/controllers/asset-media.controller.ts b/server/src/controllers/asset-media.controller.ts
index 171cfe704..688e513b6 100644
--- a/server/src/controllers/asset-media.controller.ts
+++ b/server/src/controllers/asset-media.controller.ts
@@ -96,8 +96,9 @@ export class AssetMediaController {
   @Put(':id/original')
   @UseInterceptors(FileUploadInterceptor)
   @ApiConsumes('multipart/form-data')
-  @EndpointLifecycle({ addedAt: 'v1.106.0' })
-  @ApiOperation({
+  @EndpointLifecycle({
+    addedAt: 'v1.106.0',
+    deprecatedAt: 'v1.142.0',
     summary: 'replaceAsset',
     description: 'Replace the asset with new file, without changing its id',
   })
diff --git a/server/src/decorators.ts b/server/src/decorators.ts
index b88f2d2d7..2f1e76d09 100644
--- a/server/src/decorators.ts
+++ b/server/src/decorators.ts
@@ -1,5 +1,5 @@
 import { SetMetadata, applyDecorators } from '@nestjs/common';
-import { ApiExtension, ApiOperation, ApiProperty, ApiTags } from '@nestjs/swagger';
+import { ApiExtension, ApiOperation, ApiOperationOptions, ApiProperty, ApiTags } from '@nestjs/swagger';
 import _ from 'lodash';
 import { ADDED_IN_PREFIX, DEPRECATED_IN_PREFIX, LIFECYCLE_EXTENSION } from 'src/constants';
 import { ImmichWorker, JobName, MetadataKey, QueueName } from 'src/enum';
@@ -159,12 +159,21 @@ type LifecycleMetadata = {
   deprecatedAt?: LifecycleRelease;
 };
 
-export const EndpointLifecycle = ({ addedAt, deprecatedAt }: LifecycleMetadata) => {
+export const EndpointLifecycle = ({
+  addedAt,
+  deprecatedAt,
+  description,
+  ...options
+}: LifecycleMetadata & ApiOperationOptions) => {
   const decorators: MethodDecorator[] = [ApiExtension(LIFECYCLE_EXTENSION, { addedAt, deprecatedAt })];
   if (deprecatedAt) {
     decorators.push(
       ApiTags('Deprecated'),
-      ApiOperation({ deprecated: true, description: DEPRECATED_IN_PREFIX + deprecatedAt }),
+      ApiOperation({
+        deprecated: true,
+        description: DEPRECATED_IN_PREFIX + deprecatedAt + (description ? `. ${description}` : ''),
+        ...options,
+      }),
     );
   }