Enhanced #

• Enhanced Debugging: Setup process now uses verbose output by default for better troubleshooting
• Improved Error Messages: More detailed error messages with comprehensive troubleshooting guidance including:
  • Common setup issues and their solutions
  • Node.js and npm verification commands
  • Network connectivity and permissions troubleshooting
  • Manual installation instructions
• Verbose Logging: Enhanced verbose output for availability checks and npm operations
• Process Output Capture: Added detailed logging of npm command output for debugging setup issues

Technical Improvements #

• Enhanced _isPugAvailable() method with verbose logging capabilities
• Improved npm installation output capture and display
• Better error context for setup failures with actionable troubleshooting steps

Added #

• Comprehensive Auto-Cleanup System: Automatic cleanup mechanisms for crash recovery and orphaned process management
• Signal Handlers: Automatic registration of SIGINT and SIGTERM handlers for graceful shutdown
• Process Monitoring: Health checks monitor server responsiveness and automatically restart failed servers
• PID File Management: Server processes are tracked with PID files for cleanup after crashes
• Orphan Detection: Automatically detects and cleans up orphaned resources from previous runs
• Resource Tracking: Comprehensive tracking of temporary files, sockets, and processes for cleanup
• Crash Recovery: Automatic server restart on communication failures

Changed #

• Socket Connection: Improved Unix domain socket connection handling with better error recovery
• Cleanup Timing: Orphan cleanup is now scheduled after server startup to prevent interference
• Script File Management: Temporary script files older than 1 hour are automatically cleaned up
• Error Handling: Enhanced error handling for socket communication with automatic restart capability

Technical Improvements #

• Added health monitoring with 30-second intervals for server responsiveness
• Implemented smart cleanup that only removes old files (1+ hours) to avoid conflicts
• Enhanced process detection and safe termination for both Unix and Windows systems
• Improved socket file management with in-use detection
• Added comprehensive emergency cleanup for unexpected shutdowns
• Better separation of concerns between server management and cleanup operations

Documentation #

• Added "Auto-Cleanup and Crash Recovery" section to README
• Documented built-in safety features and automatic error recovery
• Added examples of proper resource management patterns
• Removed manual cleanup script documentation (library handles everything automatically)

Changed #

• Embedded JavaScript Scripts: Node.js scripts are now embedded directly in the Dart code as string constants
• Improved Compilation Support: Package now works correctly when compiled, as scripts are no longer external files
• Enhanced Reliability: Eliminated dependency on external script files that could be missing in compiled environments

Technical Improvements #

• JavaScript scripts (pug_server.js and pug_fallback.js) are now embedded as constants in embedded_scripts.dart
• Temporary script files are created in the working directory to maintain access to local node_modules
• Automatic cleanup of temporary script files on server shutdown
• Removed unused internal variables and improved code quality

Added #

• Singleton Pattern: Global pug instance for convenient access
• Automatic Setup: Pug.js installation and initialization happens automatically on first use
• Simplified API: No need to manually check availability or call setup
• dispose() method as alias for shutdown() with cleaner semantics
• New PugInstance class wrapping the static PugServer methods
• Automatic initialization tracking to prevent redundant setup calls
• Node.js/npm requirement warning: Added explicit warning in installation documentation

Changed #

• BREAKING: Primary API is now the global pug instance instead of static PugServer methods
• BREAKING: Teardown method renamed from shutdown() to dispose()
• BREAKING: PugServer class is no longer exported - users must use the pug singleton
• BREAKING: setup() and isAvailable() methods are now private - setup is fully automatic
• Default setup now happens silently (non-verbose) for better user experience
• Improved documentation with singleton pattern examples
• Updated quick start guide to show zero-configuration usage
• Simplified example files to demonstrate automatic setup
• Updated all tests to use new singleton API

Removed #

• BREAKING: Manual setup documentation section (setup is now automatic)
• BREAKING: Public access to setup() and isAvailable() methods
• BREAKING: Direct access to PugServer static methods
• Setup example file (replaced with automatic setup demonstration)

Improved #

• User experience: Just import and use pug.render() - no setup required
• API consistency: Single instance pattern matches common Dart conventions
• Resource management: Clearer separation between dispose and automatic restart
• Documentation clarity: Removed confusing manual setup options

Migration Guide #

// Old API (no longer available)
if (!await PugServer.isAvailable()) {
  await PugServer.setup();
}
final html = await PugServer.render('h1 Hello');
await PugServer.shutdown();

// New API (only way to use the library)
final html = await pug.render('h1 Hello');
await pug.dispose();

Added #

• Initial release of pug_dart
• High-performance persistent Node.js server with Unix domain sockets
• Support for PugServer.render() - render Pug template strings
• Support for PugServer.renderFile() - render Pug template files using File objects
• Support for PugServer.compile() - compile and render templates in one step
• Support for PugServer.compileFile() - compile and render files in one step
• Automatic Pug.js installation via PugServer.setup()
• Availability checking with PugServer.isAvailable()
• Graceful server shutdown with PugServer.shutdown()
• Type-safe error handling with FileSystemException for file errors and PugServerException for Pug errors
• Cross-platform support (Linux/macOS with Unix sockets, Windows with process fallback)
• Comprehensive test suite with 12 passing tests
• Complete documentation and examples
• Support for all Pug.js features and options

Features #

• Performance: 10-50x faster than process-per-request after initial startup
• Type Safety: Uses dart:io File objects for file operations
• Error Handling: Detailed error messages with appropriate exception types
• Resource Management: Automatic server lifecycle management
• No Port Conflicts: Uses Unix domain sockets instead of network ports
• Auto Setup: Automatically installs Pug.js if needed