Add advanced server example for Guacamole-Lite with session recording, webhooks, and error tracking

Author: vadimpronin

README.md

@@ -331,6 +331,19 @@ Each section provides detailed information and examples to help you tailor `guac
 Whether you're integrating with existing Node.js frameworks, handling complex logging requirements, or setting up custom
 callbacks and events, the advanced configuration guide has you covered.
 
+## Production-Ready Example
+
+For enterprise or production environments, we provide a comprehensive example that demonstrates advanced features often
+required in real-world deployments. This example includes:
+
+* **Session Recording & Cloud Upload**: Automatically compressing session recordings and uploading them to AWS S3.
+* **Error Tracking**: Integration with Sentry for centralized error monitoring.
+* **Webhooks**: HTTP callbacks triggered on session open, close, and recording save events.
+* **Graceful Shutdown**: Proper handling of system signals to close connections cleanly.
+* **Dynamic Configuration**: Using token data to dynamically configure file paths.
+
+Check out [examples/advanced_server.js](examples/advanced_server.js) for the complete implementation.
+
 ## Testing
 
 `guacamole-lite` comes with two ways to test:

docs/advanced-configuration.md

@@ -25,6 +25,7 @@
 - [Integration with Node.js Frameworks](#integration-with-nodejs-frameworks)
     - [Considerations for Integration](#considerations-for-integration)
     - [Example of Integrating with Express.js](#example-of-integrating-with-expressjs)
+- [Comprehensive Production Example](#comprehensive-production-example)
 - [Additional Examples and Resources](#additional-examples-and-resources)
     - [Contents of the Examples Directory](#contents-of-the-examples-directory)
 
@@ -1049,6 +1050,20 @@ similar framework, allowing you to leverage the full capabilities of both `guaca
 
 ---
 
+## Comprehensive Production Example
+
+The `examples/advanced_server.js` file provides a blueprint for a robust production server. It goes beyond simple
+configuration and implements custom logic for:
+
+1. **Cloud Storage**: Compressing raw recording files generated by guacd and uploading them to S3.
+2. **Monitoring**: Sending error reports to Sentry with user context.
+3. **Integrations**: Triggering webhooks on your backend when sessions open or close.
+4. **Operational Safety**: Handling process signals for graceful shutdowns.
+
+For details on how to implement these features, review the [Advanced Server Example](../examples/advanced_server.js).
+
+---
+
 ## Additional Examples and Resources
 
 For developers looking to dive deeper into the practical implementation of `guacamole-lite`, the project's `examples`
@@ -1065,6 +1080,8 @@ The `examples` directory within the `guacamole-lite` project contains the follow
 - [basic_server.js](../examples/basic_server.js): Provides a simple example of how to get a `guacamole-lite` server up
   and running with minimal
   configuration.
+- [advanced_server.js](../examples/advanced_server.js): A comprehensive production-ready server implementation featuring
+  S3 recording upload, Sentry error tracking, webhooks, and graceful shutdown.
 - [encrypt_token.js](../examples/encrypt_token.js): Shows how to encrypt a connection token using Node.js, ensuring
   secure transmission of connection
   parameters.