fix(user-management): Expose nested user on OrganizationMembership

src/user-management/fixtures/deactivate-organization-membership.json

@@ -10,5 +10,22 @@
   "directory_managed": false,
   "custom_attributes": {},
   "created_at": "2023-07-18T02:07:19.911Z",
-  "updated_at": "2023-07-18T02:07:19.911Z"
+  "updated_at": "2023-07-18T02:07:19.911Z",
+  "user": {
+    "object": "user",
+    "id": "user_01H5JQDV7R7ATEYZDEG0W5PRYS",
+    "email": "test01@example.com",
+    "name": "Test 01 User",
+    "first_name": "Test 01",
+    "last_name": "User",
+    "created_at": "2023-07-18T02:07:19.911Z",
+    "updated_at": "2023-07-18T02:07:19.911Z",
+    "email_verified": true,
+    "profile_picture_url": "https://example.com/profile_picture.jpg",
+    "last_sign_in_at": "2023-07-18T02:07:19.911Z",
+    "locale": "en-US",
+    "metadata": {
+      "key": "value"
+    }
+  }
 }

src/user-management/fixtures/list-organization-memberships.json

@@ -14,7 +14,24 @@
       "directory_managed": false,
       "custom_attributes": {},
       "created_at": "2023-07-18T02:07:19.911Z",
-      "updated_at": "2023-07-18T02:07:19.911Z"
+      "updated_at": "2023-07-18T02:07:19.911Z",
+      "user": {
+        "object": "user",
+        "id": "user_01H5JQDV7R7ATEYZDEG0W5PRYS",
+        "email": "test01@example.com",
+        "name": "Test 01 User",
+        "first_name": "Test 01",
+        "last_name": "User",
+        "created_at": "2023-07-18T02:07:19.911Z",
+        "updated_at": "2023-07-18T02:07:19.911Z",
+        "email_verified": true,
+        "profile_picture_url": "https://example.com/profile_picture.jpg",
+        "last_sign_in_at": "2023-07-18T02:07:19.911Z",
+        "locale": "en-US",
+        "metadata": {
+          "key": "value"
+        }
+      }
     }
   ],
   "list_metadata": {

src/user-management/fixtures/organization-membership.json

@@ -10,5 +10,22 @@
   "directory_managed": false,
   "custom_attributes": {},
   "created_at": "2023-07-18T02:07:19.911Z",
-  "updated_at": "2023-07-18T02:07:19.911Z"
+  "updated_at": "2023-07-18T02:07:19.911Z",
+  "user": {
+    "object": "user",
+    "id": "user_01H5JQDV7R7ATEYZDEG0W5PRYS",
+    "email": "test01@example.com",
+    "name": "Test 01 User",
+    "first_name": "Test 01",
+    "last_name": "User",
+    "created_at": "2023-07-18T02:07:19.911Z",
+    "updated_at": "2023-07-18T02:07:19.911Z",
+    "email_verified": true,
+    "profile_picture_url": "https://example.com/profile_picture.jpg",
+    "last_sign_in_at": "2023-07-18T02:07:19.911Z",
+    "locale": "en-US",
+    "metadata": {
+      "key": "value"
+    }
+  }
 }

src/user-management/interfaces/organization-membership.interface.ts

@@ -1,4 +1,5 @@
 import { RoleResponse } from '../../roles/interfaces/';
+import { User, UserResponse } from './user.interface';
 
 export type OrganizationMembershipStatus = 'active' | 'inactive' | 'pending';
 
@@ -20,6 +21,11 @@ export interface OrganizationMembership extends BaseOrganizationMembership {
   /** The primary role assigned to the user within the organization. */
   role: RoleResponse;
   roles?: RoleResponse[];
+  /**
+   * The user who holds this membership. Returned by the Organization
+   * Membership API endpoints; absent from event and action payloads.
+   */
+  user?: User;
 }
 
 export type AuthorizationOrganizationMembership = BaseOrganizationMembership;
@@ -40,6 +46,7 @@ export interface BaseOrganizationMembershipResponse {
 export interface OrganizationMembershipResponse extends BaseOrganizationMembershipResponse {
   role: RoleResponse;
   roles?: RoleResponse[];
+  user?: UserResponse;
 }
 
 export type AuthorizationOrganizationMembershipResponse =

src/user-management/serializers/organization-membership.serializer.ts

@@ -4,6 +4,7 @@ import {
   OrganizationMembership,
   OrganizationMembershipResponse,
 } from '../interfaces/organization-membership.interface';
+import { deserializeUser } from './user.serializer';
 
 export const deserializeOrganizationMembership = (
   organizationMembership: OrganizationMembershipResponse,
@@ -20,6 +21,9 @@ export const deserializeOrganizationMembership = (
   role: organizationMembership.role,
   ...(organizationMembership.roles && { roles: organizationMembership.roles }),
   customAttributes: organizationMembership.custom_attributes ?? {},
+  ...(organizationMembership.user && {
+    user: deserializeUser(organizationMembership.user),
+  }),
 });
 
 export const deserializeAuthorizationOrganizationMembership = (

src/user-management/user-management.spec.ts

@@ -2466,8 +2466,28 @@ describe('UserManagement', () => {
         userId: 'user_01H5JQDV7R7ATEYZDEG0W5PRYS',
         organizationId: 'organization_01H5JQDV7R7ATEYZDEG0W5PRYS',
         status: 'active',
+        user: {
+          object: 'user',
+          id: 'user_01H5JQDV7R7ATEYZDEG0W5PRYS',
+          email: 'test01@example.com',
+          emailVerified: true,
+          firstName: 'Test 01',
+          lastName: 'User',
+        },
       });
     });
+
+    it('omits user when the response does not include one', async () => {
+      fetchOnce(
+        { ...organizationMembershipFixture, user: undefined },
+        { status: 200 },
+      );
+      const organizationMembership =
+        await workos.userManagement.getOrganizationMembership(
+          organizationMembershipId,
+        );
+      expect(organizationMembership).not.toHaveProperty('user');
+    });
   });
 
   describe('listOrganizationMemberships', () => {
@@ -2490,6 +2510,10 @@ describe('UserManagement', () => {
             organizationName: 'Example Organization',
             userId: 'user_01H5JQDV7R7ATEYZDEG0W5PRYS',
             status: 'active',
+            user: {
+              id: 'user_01H5JQDV7R7ATEYZDEG0W5PRYS',
+              email: 'test01@example.com',
+            },
           },
         ],
         listMetadata: {