Added integration with the Events API endpoints

[blobaugh]

Description

Added integration with the Events API endpoints

[greptile-apps]

Greptile Overview

Summary

This PR successfully integrates the WorkOS Events API by adding a comprehensive Events class, Event resource model, and thorough test coverage. The implementation follows security best practices with robust input validation and parameter sanitization.

Key Changes:

• Events.php: New API client class with listEvents() and getEventsByType() methods, comprehensive parameter validation, and event type whitelisting
• Event.php: Resource model with getter methods, event type checking helpers (isUserEvent(), isAuthenticationEvent(), etc.), and utility functions
• EventsTest.php: Complete test suite covering happy paths, parameter validation, error handling, and resource functionality
• WorkOS.php: Minor formatting improvement (added blank line)

Security Features:

• Input validation and sanitization for all parameters
• Event type validation against hardcoded whitelist
• Parameter length limits to prevent abuse
• Proper exception handling with structured error messages

The implementation is well-structured, follows existing codebase patterns, and includes comprehensive error handling. All custom security rules are properly followed.

Confidence Score: 5/5

• This PR is safe to merge with no security or functionality concerns
• Score reflects thorough input validation, comprehensive test coverage, adherence to security best practices, and consistent code patterns. No logical errors, security vulnerabilities, or breaking changes identified.
• No files require special attention

Important Files Changed

File Analysis

Filename	Score	Overview
lib/Events.php	5/5	New Events API integration class with robust input validation, event type whitelisting, and comprehensive parameter sanitization
lib/Resource/Event.php	5/5	Event resource model with getter methods, type checking helpers, and utility functions for working with event data
tests/WorkOS/EventsTest.php	5/5	Comprehensive test suite covering Events API functionality, parameter validation, error handling, and Event resource methods

Sequence Diagram

sequenceDiagram
    participant Client as PHP Application
    participant Events as Events Class
    participant Validation as Parameter Validation
    participant API as WorkOS API
    participant Resource as Event Resource

    Client->>Events: listEvents($params)
    Events->>Validation: validateAndSanitizeParams($params)
    
    alt Invalid Parameters
        Validation-->>Events: BadRequestException
        Events-->>Client: Exception thrown
    else Valid Parameters
        Validation-->>Events: Sanitized parameters
        
        alt Array events parameter
            Events->>Events: implode(',', $params['events'])
        end
        
        Events->>API: Client::request('GET', 'events', null, $params)
        API-->>Events: API Response (JSON)
        Events-->>Client: Raw API response array
        
        opt Creating Event Resources
            Client->>Resource: Event::constructFromResponse($eventData)
            Resource-->>Client: Event object with helper methods
        end
    end

    Note over Client,Resource: Alternative flow: getEventsByType()
    Client->>Events: getEventsByType($eventTypes, $params)
    Events->>Events: validateEventTypes($eventTypes)
    
    alt Invalid Event Types
        Events-->>Client: BadRequestException
    else Valid Event Types
        Events->>Events: listEvents($params)
        Events-->>Client: Filtered events response
    end

Loading

_{4 files reviewed, no comments}

_{Edit Code Review Bot Settings | Greptile}