feat: add route to fetch user by jellyfin id (#2074)

Co-authored-by: gauthier-th <mail@gauthierth.fr>

Author: fredrikburmester

seerr-api.yml

@@ -4449,6 +4449,29 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/User'
+  /user/jellyfin/{jellyfinUserId}:
+    get:
+      summary: Get user by Jellyfin user ID
+      description: |
+        Retrieves user details by Jellyfin user ID in a JSON object. Returns filtered data based on the caller's permissions.
+      tags:
+        - users
+      parameters:
+        - in: path
+          name: jellyfinUserId
+          required: true
+          schema:
+            type: string
+          description: The Jellyfin user ID (32-character hexadecimal string)
+      responses:
+        '200':
+          description: User details in JSON
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/User'
+        '404':
+          description: User not found
   /user/{userId}/requests:
     get:
       summary: Get requests for a specific user

server/routes/user/index.ts

@@ -420,6 +420,30 @@ router.get<{ id: string }>('/:id', async (req, res, next) => {
   }
 });
 
+router.get<{ jellyfinUserId: string }>(
+  '/jellyfin/:jellyfinUserId',
+  async (req, res, next) => {
+    try {
+      const userRepository = getRepository(User);
+
+      const jellyfinUserId = normalizeJellyfinGuid(req.params.jellyfinUserId);
+      if (!jellyfinUserId) {
+        return next({ status: 400, message: 'Invalid Jellyfin User ID.' });
+      }
+
+      const user = await userRepository.findOneOrFail({
+        where: { jellyfinUserId },
+      });
+
+      return res
+        .status(200)
+        .json(user.filter(req.user?.hasPermission(Permission.MANAGE_USERS)));
+    } catch {
+      next({ status: 404, message: 'User not found.' });
+    }
+  }
+);
+
 router.use('/:id/settings', userSettingsRoutes);
 
 router.get<{ id: string }, UserRequestsResponse>(