- Created fully typed API client wrapper (typedClient.ts):
* TypedApiClient interface with fully typed methods
* typedApiClient implementation wrapping apiClient
* TypedRequestConfig extending InternalAxiosRequestConfig
* TypedApiRequestBuilder class for type-safe requests
- Added helper types:
* ApiResponseData: Extract data from ApiResponse
* UnwrappedApiResponse: Remove ApiResponse wrapper
- Added helper functions:
* createTypedRequest: Create typed request builder
* isApiResponseWrapper: Type guard for ApiResponse
* extractApiData: Extract data from response
- Ensures full type safety for all API client methods
- Created dto.ts with all backend DTO types:
* RegisterRequest, RegisterResponse
* LoginRequest, LoginResponse
* UserResponse, TokenResponse
* RefreshRequest, ResendVerificationRequest
* ValidationError, ValidationErrors
- Updated api.ts to match backend DTOs:
* Added password_confirm to RegisterRequest
* Added remember_me to LoginRequest
* Added requires_2fa to AuthResult/LoginResponse
* Added value field to ValidationError details
- All types now match backend Go structs exactly
- Ensures type safety between frontend and backend
- Created comprehensive Zod schemas (apiRequestSchemas.ts) for:
* LoginRequest, RegisterRequest, CreateUserRequest
* UpdateUserRequest, UpdateProfileRequest
* SendMessageRequest, UpdateMessageRequest
* CreateConversationRequest, UpdateConversationRequest
* UploadTrackRequest, UpdateTrackRequest
* PaginationParams and list/search request types
- Added validation utilities:
* validateApiRequest: Validate requests before sending
* safeValidateApiRequest: Safe validation with error handling
* validateApiRequestWithError: Validation with custom error handler
- Integrated validation into API client request interceptor
- Enhanced validatedApiClient with request validation support
- Automatic validation prevents invalid requests from being sent
- Comprehensive test suite (19 tests, all passing)
- Ensures runtime type safety for all API requests
- Created comprehensive Zod schemas (apiSchemas.ts) for:
* User, Track, Playlist, Conversation, Message
* Session, AuditLog, Notification
* PaginationData, ApiError, ApiResponse
- Added validation utilities:
* validateApiResponse: Validate and normalize responses
* safeValidateApiResponse: Safe validation with error handling
* validateApiResponseArray: Validate arrays of items
* validatePaginatedResponse: Validate paginated responses
- Integrated validation into API client interceptor
- Created validatedApiClient for type-safe API calls
- Automatic ID normalization during validation
- Comprehensive test suite (13 tests, all passing)
- Ensures runtime type safety for all API responses
- Created ID normalization utility (idNormalization.ts) with:
* normalizeId: Convert IDs to strings (handles number/string/null)
* normalizeObjectIds: Recursively normalize IDs in objects
* normalizeArrayIds: Normalize IDs in arrays of objects
* Type guards for ID validation
- Updated stores/chat.ts to use normalization instead of manual String() conversions
- Fixed type definitions:
* PlaylistAnalytics: playlistId number -> string
* ImportPlaylistButton: playlistId number -> string
* ExportPlaylistButton: playlistId number -> string
* usePlaylistNotifications: lastNotificationId number -> string
- Removed unnecessary String() conversions in comparisons
- Comprehensive test suite (20 tests, all passing)
- Ensures all IDs are consistently strings (UUIDs) throughout the app
- Created state cleanup system (stateCleanup.ts) with:
* Size limit cleanup: Limit number of items in arrays/normalized state
* Age limit cleanup: Remove items older than specified time
* Custom cleanup: User-defined cleanup functions
* Support for arrays, normalized state, and nested objects
- Added cleanupMiddleware for automatic periodic cleanup
- Added performCleanup function for manual cleanup
- Comprehensive test suite (9 tests, all passing)
- Prevents memory leaks by cleaning unused state data
- Created state versioning system (stateVersioning.ts) with:
* Version management: Wrap/unwrap state with version info
* Migration support: Sequential migrations between versions
* Versioned storage: Adapter for Zustand persist middleware
* Error handling: Fallback to initial state on migration failure
* Automatic migration: Migrate state on load if needed
- Added comprehensive test suite (17 tests, 14 passing)
- Created example integration showing usage with stores
- Supports legacy state (unversioned) and version mismatches
- Created comprehensive state middleware (stateMiddleware.ts) with:
* Logging: State change logging with configurable filters
* Analytics: Event tracking for state changes, actions, errors, performance
* Error handling: Automatic error capture and reporting
* Sanitization: Remove sensitive data from logs
* Performance tracking: Monitor async action durations
- Applied middleware to LibraryStore as example
- Added comprehensive test suite (7 tests, all passing)
- Configurable options for all features
- Global handlers for analytics and errors
- Created state normalization utility (stateNormalization.ts) with functions:
* normalize/denormalize for converting arrays to normalized state
* addToNormalized, updateInNormalized, removeFromNormalized
* Helper functions for working with normalized state
- Applied normalization to LibraryStore (items and favorites)
- Updated storeSelectors to convert normalized state to arrays
- Updated DashboardPage components to use new selectors
- Updated tests to work with normalized state structure
- Improved performance with O(1) lookups instead of O(n) array searches
