ENT-4372 SDK Updates

Greptile Overview

Greptile Summary

This PR refactors organization membership types to separate authorization and user-management concerns. It extracts base interfaces (BaseOrganizationMembership and BaseOrganizationMembershipResponse) and creates authorization-specific types that extend them with optional organizationName. The authorization module now uses its own deserializer instead of depending on the user-management serializer.

Key changes:

• Split OrganizationMembership interface into base and extended versions
• Created authorization-specific AuthorizationOrganizationMembership types with optional organizationName
• Added dedicated deserializer for authorization membership responses
• Updated authorization methods to use new types and deserializer

Breaking change concern: OrganizationMembership in user-management now requires organizationName and role fields (previously optional), which may affect existing code.

Confidence Score: 3/5

• This PR has a potential breaking change that should be verified before merging
• The refactoring is well-structured and improves type separation, but making organizationName and role required fields in the user-management OrganizationMembership interface could break existing code that expects these to be optional
• Pay close attention to src/user-management/interfaces/organization-membership.interface.ts - verify that all code using OrganizationMembership can handle the now-required fields

Important Files Changed

Sequence Diagram

sequenceDiagram
    participant Client
    participant Authorization
    participant API as WorkOS API
    participant Deserializer as AuthorizationOrganizationMembership<br/>Deserializer

    Client->>Authorization: listMembershipsForResource(options)
    Authorization->>API: GET /authorization/resources/{id}/organization_memberships
    API-->>Authorization: AuthorizationOrganizationMembershipListResponse
    Authorization->>Deserializer: deserializeAuthorizationOrganizationMembership()
    Deserializer-->>Authorization: AuthorizationOrganizationMembership[]
    Authorization-->>Client: AuthorizationOrganizationMembershipList

    Note over Deserializer: Maps API response fields:<br/>organization_name -> organizationName<br/>user_id -> userId<br/>organization_id -> organizationId

_{Last reviewed commit: d607e0a}