jaxl-python 0.0.48__tar.gz → 0.0.49__tar.gz

{jaxl_python-0.0.48 → jaxl_python-0.0.49}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jaxl-python
-Version: 0.0.48
+Version: 0.0.49
 Summary: Official Python SDK and CLI for interfacing with the Jaxl API. Manage calls, messages, IVRs, devices, teams, payments, campaigns, streaming transcriptions and AI Agents. Built on OpenAPI, it offers both generated API clients and Pythonic wrappers for ease of use.
 Home-page: https://github.com/jaxl-innovations-private-limited/jaxl-python
 Download-URL: https://github.com/jaxl-innovations-private-limited/jaxl-python/archive/main.zip

{jaxl_python-0.0.48 → jaxl_python-0.0.49}/jaxl/api/base.py

@@ -182,6 +182,32 @@ class BaseJaxlApp:
     def websocket_routes(self) -> List[Tuple[str, WebsocketRouteFunc]]:
         return []
 
+    # pylint: disable=no-self-use,unused-argument
+    async def on_startup(self) -> None:
+        """Invoked ONCE, on the server's startup event, before any call.
+
+        This is the first point at which a running event loop exists —
+        ``__init__`` runs while the app object is constructed, which
+        happens synchronously before the server starts, so background
+        tasks cannot be scheduled there.
+
+        Use it to warm anything that would otherwise be paid on the
+        critical path of the first call: connection pools, model
+        clients, caches, on-disk asset checks. Keep it non-blocking and
+        never raise — an exception here is logged and ignored so a slow
+        or failing warm-up can never stop the server from serving.
+        """
+        return None
+
+    # pylint: disable=no-self-use,unused-argument
+    async def on_shutdown(self) -> None:
+        """Invoked ONCE, on the server's shutdown event.
+
+        Counterpart to :meth:`on_startup` — release anything it warmed
+        (open sockets, background tasks). Never raise.
+        """
+        return None
+
     # pylint: disable=no-self-use,unused-argument
     async def handle_configure(self, req: JaxlWebhookRequest) -> HANDLER_RESPONSE:
         """Invoked when a phone number gets assigned to IVR."""

{jaxl_python-0.0.48 → jaxl_python-0.0.49}/jaxl/api/client/_scm_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.0.48'
-__version_tuple__ = version_tuple = (0, 0, 48)
+__version__ = version = '0.0.49'
+__version_tuple__ = version_tuple = (0, 0, 49)

{jaxl_python-0.0.48 → jaxl_python-0.0.49}/jaxl/api/resources/apps.py

@@ -382,6 +382,26 @@ def _start_server(
             finally:
                 await app.on_stream_disconnect(call_id)
 
+    async def _on_startup() -> None:
+        """Give the app its ONE pre-traffic moment with a live event
+        loop. The app object is constructed synchronously before the
+        server starts, so `__init__` cannot schedule background work —
+        this is where a pool/cache/client warm-up belongs. Guarded: a
+        slow or failing warm-up must never stop the server serving."""
+        try:
+            await app.on_startup()
+        except Exception as exc:  # pylint: disable=broad-exception-caught
+            logger.exception(f"on_startup failed, continuing: {exc!r}")
+
+    async def _on_shutdown() -> None:
+        try:
+            await app.on_shutdown()
+        except Exception as exc:  # pylint: disable=broad-exception-caught
+            logger.exception(f"on_shutdown failed, continuing: {exc!r}")
+
+    server.add_event_handler("startup", _on_startup)
+    server.add_event_handler("shutdown", _on_shutdown)
+
     for config, func in app.api_routes():
         server.add_api_route(
             path=config[0],

{jaxl_python-0.0.48 → jaxl_python-0.0.49}/jaxl_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jaxl-python
-Version: 0.0.48
+Version: 0.0.49
 Summary: Official Python SDK and CLI for interfacing with the Jaxl API. Manage calls, messages, IVRs, devices, teams, payments, campaigns, streaming transcriptions and AI Agents. Built on OpenAPI, it offers both generated API clients and Pythonic wrappers for ease of use.
 Home-page: https://github.com/jaxl-innovations-private-limited/jaxl-python
 Download-URL: https://github.com/jaxl-innovations-private-limited/jaxl-python/archive/main.zip