Greptile Overview

Greptile Summary

This PR adds support for multiple roles by introducing an optional roles array property to directory users and SSO profiles. The existing singular role field is preserved for backward compatibility.

Key changes:

• Added optional roles?: RoleResponse[] field to DirectoryUser, DirectoryUserResponse, Profile, and ProfileResponse interfaces
• Updated serializers to properly map the roles field between API responses and client objects
• Updated all test fixtures and snapshots to include the new roles array alongside the existing role field
• The implementation maintains backward compatibility by keeping both role (singular) and roles (array) as optional fields

Implementation notes:

• The serializers correctly handle the optional roles field by passing it through unchanged (no transformation needed since RoleResponse structure is the same in both formats)
• Event interfaces automatically inherit the new field through the DirectoryUser and DirectoryUserResponse types
• Test coverage includes both directory sync and SSO flows with role data

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• The changes are straightforward, well-tested, and maintain backward compatibility. The implementation follows existing patterns in the codebase, properly updates both interfaces and serializers, includes comprehensive test coverage with updated snapshots, and doesn't introduce any security concerns or breaking changes.
• No files require special attention

Important Files Changed

File Analysis

Sequence Diagram

sequenceDiagram
    participant API as WorkOS API
    participant Serializer as Serializer Layer
    participant Client as Client Application
    
    Note over API,Client: Directory Sync Flow
    API->>Serializer: DirectoryUserResponse<br/>{role, roles, ...}
    Serializer->>Client: DirectoryUser<br/>{role, roles, ...}
    
    Note over API,Client: SSO Profile Flow
    API->>Serializer: ProfileResponse<br/>{role, roles, ...}
    Serializer->>Client: Profile<br/>{role, roles, ...}
    
    Note over Client: Both role (singular) and<br/>roles (array) are now<br/>available to support<br/>multiple roles