feat: extend message types and introduce FFI bridge for custom store backends via SqliteStore rename

Author: krypton-byte

Cargo.lock

@@ -26,3 +26,9 @@ tracing = "0.1.41"
 tracing-subscriber = { version = "0.3.19", features = ["env-filter", "fmt"] }
 chrono = "0.4.44"
 infer = { git = "https://github.com/bojand/infer", branch = "master" }
+libloading = "0.8"
+serde_json = "1"
+bincode = "1"
+bytes = "1"
+serde = { version = "1", features = ["derive"] }
+wacore-appstate = { path = "libs/whatsapp-rust/wacore/appstate" }

Cargo.toml

@@ -89,12 +89,12 @@ uv run maturin build --release
 
 ```python
 import asyncio
-from tryx.backend import SqliteBackend
+from tryx.backend import SqliteStore
 from tryx.client import Tryx, TryxClient
 from tryx.events import EvMessage
 from tryx.waproto.whatsapp_pb2 import Message
 
-backend = SqliteBackend("whatsapp.db")
+backend = SqliteStore("whatsapp.db")
 app = Tryx(backend)
 
 @app.on(EvMessage)

README.md

@@ -34,9 +34,9 @@ Tryx follows the WhatsApp multi-device pairing flow. The first run links a sessi
 Use a stable backend path:
 
 ```python
-from tryx.backend import SqliteBackend
+from tryx.backend import SqliteStore
 
-backend = SqliteBackend("/srv/tryx/session.db")
+backend = SqliteStore("/srv/tryx/session.db")
 ```
 
 If the same backend path is reused, you usually do not need to pair again.

docs/getting-started/authentication.md

@@ -40,9 +40,9 @@ Typical wheel output appears under `target/wheels/`.
 
 ```python
 from tryx.client import Tryx, TryxClient
-from tryx.backend import SqliteBackend
+from tryx.backend import SqliteStore
 
-backend = SqliteBackend("whatsapp.db")
+backend = SqliteStore("whatsapp.db")
 app = Tryx(backend)
 client = app.get_client()
 print(type(client).__name__)

docs/getting-started/installation.md

@@ -10,12 +10,12 @@ Build and run a minimal echo client, then expand it safely.
 ```python
 import asyncio
 
-from tryx.backend import SqliteBackend
+from tryx.backend import SqliteStore
 from tryx.client import Tryx, TryxClient
 from tryx.events import EvMessage
 from tryx.waproto.whatsapp_pb2 import Message
 
-backend = SqliteBackend("whatsapp.db")
+backend = SqliteStore("whatsapp.db")
 app = Tryx(backend)
 
 
@@ -68,10 +68,10 @@ if __name__ == "__main__":
 For quick scripts without manual event loop management:
 
 ```python
-from tryx.backend import SqliteBackend
+from tryx.backend import SqliteStore
 from tryx.client import Tryx
 
-app = Tryx(SqliteBackend("whatsapp.db"))
+app = Tryx(SqliteStore("whatsapp.db"))
 app.run_blocking()
 ```
 

docs/getting-started/quickstart.md

@@ -13,11 +13,11 @@ Build a command-driven automation that stays maintainable as command count grows
 ```python
 import asyncio
 
-from tryx.backend import SqliteBackend
+from tryx.backend import SqliteStore
 from tryx.client import Tryx, TryxClient
 from tryx.events import EvMessage
 
-backend = SqliteBackend("whatsapp.db")
+backend = SqliteStore("whatsapp.db")
 app = Tryx(backend)
 
 

docs/tutorials/command-bot.md

@@ -16,7 +16,7 @@
 
 import segno
 
-from tryx.backend import SqliteBackend
+from tryx.backend import SqliteStore
 from tryx.client import Tryx, TryxClient
 from tryx.events import EvMessage, EvPairingQrCode, EvPushNameUpdate, EvUserAboutUpdate
 
@@ -41,7 +41,7 @@ def _download() -> bytes:
     return await asyncio.to_thread(_download)
 
 
-backend = SqliteBackend(DB_PATH)
+backend = SqliteStore(DB_PATH)
 app = Tryx(backend)
 
 

examples/command_bot.py

@@ -1,18 +1,34 @@
 """Backend interfaces for Tryx runtime state storage."""
 
 from abc import ABC
+from typing import Optional
 
 class BackendBase(ABC):
     """Base class for all backend implementations used by Tryx."""
 
-class SqliteBackend(BackendBase):
-    """SQLite-backed backend implementation.
+class SqliteStore(BackendBase):
+    """SQLite-backed storage implementation.
 
     Use this backend to persist session and app-state data in a local file.
     """
 
     path: str
 
     def __init__(self, path: str) -> None:
-        """Create a SQLite backend bound to a database file path."""
+        """Create a SQLite storage backend bound to a database file path."""
         ...
+
+
+from typing import Protocol, runtime_checkable
+
+@runtime_checkable
+class FfiStoreProtocol(Protocol):
+    """
+    Protocol defining an external FFI store via duck typing.
+    Any Python object with `lib_path` and `config_json` attributes
+    will be dynamically accepted by Tryx as an FFI store backend.
+    """
+    @property
+    def lib_path(self) -> str: ...
+    @property
+    def config_json(self) -> str: ...