feat(settings): add endpoint and UI for switching media server

seerr-api.yml

@@ -2290,6 +2290,44 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/JellyfinSettings'
+  /settings/switch-media-server:
+    post:
+      summary: Switch media server
+      tags:
+        - settings
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                targetServerType:
+                  type: string
+                  enum: [jellyfin, emby, plex]
+                  description: Target media server type. Required when switching from Plex (jellyfin or emby) or from Jellyfin/Emby (plex, jellyfin, or emby).
+      responses:
+        '200':
+          description: Media server cleared
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: 'Media server cleared. Restart or reload to configure a new server.'
+        '400':
+          description: No media server is configured
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error:
+                    type: string
+                    example: 'No media server is configured.'
+        '500':
+          description: Failed to switch media server
   /settings/jellyfin/library:
     get:
       summary: Get Jellyfin libraries

server/middleware/deprecation.ts

@@ -20,7 +20,7 @@ export const deprecatedRoute = ({
 }: DeprecationOptions) => {
   return (req: Request, res: Response, next: NextFunction) => {
     logger.warn(
-      `Deprecated API endpoint accessed: ${oldPath} → use ${newPath} instead`,
+      `Deprecated API endpoint accessed: ${oldPath} => use ${newPath} instead`,
       {
         label: 'API Deprecation',
         ip: req.ip,

server/routes/auth.ts

@@ -58,6 +58,47 @@ authRoutes.post('/plex', async (req, res, next) => {
     });
   }
 
+  const mediaServerType = settings.main.mediaServerType;
+
+  if (
+    mediaServerType === MediaServerType.JELLYFIN ||
+    mediaServerType === MediaServerType.EMBY
+  ) {
+    if (!req.user) {
+      return next({
+        status: 401,
+        message: 'Authentication required.',
+      });
+    }
+    if (!req.user.hasPermission(Permission.ADMIN)) {
+      return next({
+        status: 403,
+        message: 'Admin permissions required.',
+      });
+    }
+    try {
+      const plextv = new PlexTvAPI(body.authToken);
+      const account = await plextv.getUser();
+      const admin = await userRepository.findOneOrFail({
+        where: { id: 1 },
+      });
+      admin.plexToken = body.authToken;
+      admin.plexId = account.id;
+      admin.plexUsername = account.username;
+      await userRepository.save(admin);
+      return res.status(200).json({ email: admin.email });
+    } catch (e) {
+      logger.error('Failed to store Plex token for settings', {
+        label: 'API',
+        errorMessage: (e as Error).message,
+      });
+      return next({
+        status: 500,
+        message: 'Unable to validate Plex token.',
+      });
+    }
+  }
+
   if (
     settings.main.mediaServerType != MediaServerType.NOT_CONFIGURED &&
     (settings.main.mediaServerLogin === false ||
@@ -410,9 +451,7 @@ authRoutes.post('/jellyfin', async (req, res, next) => {
       settings.jellyfin.apiKey = apiKey;
       await settings.save();
       startJobs();
-    }
-    // User already exists, let's update their information
-    else if (account.User.Id === user?.jellyfinUserId) {
+    } else if (account.User.Id === user?.jellyfinUserId) {
       logger.info(
         `Found matching ${
           settings.main.mediaServerType === MediaServerType.JELLYFIN
@@ -431,6 +470,13 @@ authRoutes.post('/jellyfin', async (req, res, next) => {
       );
       user.avatar = getUserAvatarUrl(user);
       user.jellyfinUsername = account.User.Name;
+      user.userType =
+        settings.main.mediaServerType === MediaServerType.JELLYFIN
+          ? UserType.JELLYFIN
+          : UserType.EMBY;
+      user.plexId = null;
+      user.plexUsername = null;
+      user.plexToken = null;
 
       if (user.username === account.User.Name) {
         user.username = '';