feat(examples): add AsyncDemoEndpoint for asynchronous handling

Introduces AsyncDemoEndpoint to demonstrate asynchronous endpoint capabilities within the mega example. This new endpoint simulates async work and provides a clear example of how to implement async functionality in LightAPI. Updates the main application to register the new endpoint and includes usage instructions in the output. These changes enhance the framework's demonstration of async performance features.

Author: iklobato

examples/mega_example.py

@@ -550,6 +550,15 @@ def post(self, request):
         return {"message": f"Hello, {name}!", "timestamp": time.time()}, 201
 
 
+# --- Async Demo Endpoint ---
+class AsyncDemoEndpoint(RestEndpoint):
+    __abstract__ = True
+
+    async def get(self, request):
+        await asyncio.sleep(0.2)  # Simulate async work
+        return {"message": "This is an async endpoint!", "timestamp": time.time()}, 200
+
+
 # --- Main App ---
 def init_database():
     engine = create_engine("sqlite:///mega_example.db")
@@ -625,13 +634,17 @@ class ConfigurableCacheEndpointCustom(ConfigurableCacheEndpoint):
     class HelloWorldEndpointCustom(HelloWorldEndpoint):
         route_patterns = ["/hello"]
 
+    class AsyncDemoEndpointCustom(AsyncDemoEndpoint):
+        route_patterns = ["/async_demo"]
+
     app.register(AuthEndpointCustom)
     app.register(PublicResourceCustom)
     app.register(SecretResourceCustom)
     app.register(UserProfileCustom)
     app.register(WeatherEndpointCustom)
     app.register(ConfigurableCacheEndpointCustom)
     app.register(HelloWorldEndpointCustom)
+    app.register(AsyncDemoEndpointCustom)
     # Add middleware
     app.add_middleware([LoggingMiddleware, CORSMiddleware, RateLimitMiddleware, AuthenticationMiddleware])
     print("Server running at http://localhost:8000")
@@ -657,4 +670,6 @@ class HelloWorldEndpointCustom(HelloWorldEndpoint):
     )
     print("9. Access protected resource:")
     print("   curl -X GET http://localhost:8000/secret -H 'Authorization: Bearer YOUR_TOKEN'")
+    print("10. Async demo endpoint:")
+    print("   curl http://localhost:8000/async_demo")
     app.run(host="localhost", port=8000, debug=True)