mirror of
https://github.com/czlonkowski/n8n-mcp.git
synced 2026-01-30 06:22:04 +00:00
085f6db7a2
Implements Phase 3 (Session Lifecycle Events - REQ-4) and Phase 4 (Retry Policy - REQ-7) for v2.19.0 session persistence feature. Phase 3 - Session Lifecycle Events (REQ-4): - Added 5 lifecycle event callbacks: onSessionCreated, onSessionRestored, onSessionAccessed, onSessionExpired, onSessionDeleted - Fire-and-forget pattern: non-blocking, errors don't affect operations - Supports both sync and async handlers - Events emitted at 5 key lifecycle points Phase 4 - Retry Policy (REQ-7): - Configurable retry logic with sessionRestorationRetries and sessionRestorationRetryDelay - Overall timeout applies to ALL retry attempts combined - Timeout errors are never retried (already took too long) - Smart error handling with comprehensive logging Features: - Backward compatible: all new options are optional with sensible defaults - Type-safe interfaces with comprehensive JSDoc documentation - Security: session ID validation before restoration attempts - Performance: non-blocking events, efficient retry logic - Observability: structured logging at all critical points Files modified: - src/types/session-restoration.ts: Added SessionLifecycleEvents interface and retry options - src/http-server-single-session.ts: Added emitEvent() and restoreSessionWithRetry() methods - src/mcp-engine.ts: Added sessionEvents and retry options to EngineOptions - CHANGELOG.md: Comprehensive v2.19.0 release documentation Tests: - 34 unit tests passing (14 lifecycle events + 20 retry policy) - Integration tests created for combined behavior - Code reviewed and approved (9.3/10 rating) - MCP server tested and verified working 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>