chore

Author: tchapi

docs/api/v1/calendars/shares.md

@@ -35,13 +35,15 @@ Gets a list of all users with whom a specific user calendar is shared.
 	"data": [
 		{
 			"username": "adoe",
+			"user_id": 5,
 			"principal_id": 9,
 			"displayname": "Aiden Doe",
 			"email": "adoe@example.org",
 			"write_access": false
 		},
 		{
 			"username": "jdoe",
+			"user_id": 4,
 			"principal_id": 3,
 			"displayname": "John Doe",
 			"email": "jdoe@example.org",
@@ -101,4 +103,4 @@ or
 	"message": "Invalid Calendar ID/Username",
 	"timestamp": "2026-01-23T15:01:33+01:00"
 }
-```
+```

docs/api/v1/users/all.md

@@ -19,11 +19,12 @@ Gets a list of all available users.
 	"status": "success",
 	"data": [
 		{
+			"user_id": 1,
 			"principal_id": 3,
 			"uri": "principals/jdoe",
 			"username": "jdoe"
 		}
-    ],
+	],
 	"timestamp": "2026-01-23T15:01:33+01:00"
 }
 ```

docs/api/v1/users/details.md

@@ -30,6 +30,7 @@ Gets details about a specific user account.
 {
 	"status": "success",
 	"data": {
+		"user_id": 1,
 		"principal_id": 3,
 		"uri": "principals/jdoe",
 		"username": "jdoe",
@@ -75,4 +76,4 @@ or
 	"status": "error",
 	"message": "User Not Found",
 	"timestamp": "2026-01-23T15:01:33+01:00"
-}
+}

src/Controller/Api/ApiController.php

@@ -569,8 +569,12 @@ public function getUserCalendarsShares(Request $request, int $userId, int $calen
         foreach ($instances as $instance) {
             $principalId = $doctrine->getRepository(Principal::class)->findOneByUri($instance[0]['principalUri']);
 
+            $instanceUsername = mb_substr($instance[0]['principalUri'], strlen(Principal::PREFIX));
+            $instanceUserId = $doctrine->getRepository(User::class)->findOneByUsername($instanceUsername)->getId();
+
             $calendars[] = [
-                'username' => mb_substr($instance[0]['principalUri'], strlen(Principal::PREFIX)),
+                'username' => $instanceUsername,
+                'user_id' => $instanceUserId,
                 'principal_id' => $principalId?->getId() ?? null,
                 'displayname' => $instance['displayName'],
                 'email' => $instance['email'],

tests/Functional/ApiControllerTest.php

@@ -442,6 +442,8 @@ public function testShareUserCalendar(): void
         $this->assertEquals('success', $data['status']);
         $this->assertArrayHasKey('data', $data);
         $this->assertStringContainsString($shareeUsername, $data['data'][0]['username']);
+        $this->assertArrayHasKey('user_id', $data['data'][0]);
+        $this->assertIsNumeric($data['data'][0]['user_id']);
         $this->assertFalse($data['data'][0]['write_access']);
     }