Greptile Summary

• Auto-generates UUID v4-based idempotency keys with workos-python- prefix for audit log events when not provided
• Implements retry logic with exponential backoff for status codes 408, 500, 502, 504, network errors, and timeouts (max 3 retries, opt-in via retry_config parameter)
• Changes create_event return type from None to AuditLogEventResponse with success field

Confidence Score: 5/5

• This PR is safe to merge with minimal risk.
• The implementation is well-tested with comprehensive test coverage for both sync and async retry logic, follows existing patterns in the codebase, maintains backward compatibility by defaulting retry to opt-in (None by default), and the idempotency key auto-generation prevents duplicate events while allowing user override.
• No files require special attention.

Important Files Changed

Sequence Diagram

sequenceDiagram
 participant User
 participant AuditLogs
 participant HTTPClient
 participant API
 User->>AuditLogs: "create_event(org_id, event)"
 AuditLogs->>AuditLogs: "Generate idempotency key if not provided"
 AuditLogs->>HTTPClient: "request with retry configuration"
 
 loop Retry up to 3 times
 HTTPClient->>API: "POST audit logs events"
 alt Status 200
 API-->>HTTPClient: "Response body"
 HTTPClient-->>AuditLogs: "Return JSON"
 else Status 408, 500, 502, or 504
 API-->>HTTPClient: "Error response"
 HTTPClient->>HTTPClient: "Wait with exponential backoff"
 else Network or Timeout Error
 HTTPClient->>HTTPClient: "Wait with exponential backoff"
 end
 end
 
 AuditLogs->>AuditLogs: "Parse to AuditLogEventResponse"
 AuditLogs-->>User: "Return response object"