host_extensions/
lib.rs

1//! host-extensions — extension framework for the Polkadot app host bridge.
2//!
3//! Extensions live under `window.host.ext.<namespace>` in the SPA WebView.
4//! First-party extensions reuse the core `hostBridge` channel and
5//! `__hostCall` / `__hostResolve` / `__hostPush` plumbing — they only
6//! contribute a JS injection script that populates `window.host.ext.*`.
7//!
8//! ## Implementing an extension
9//!
10//! 1. Implement [`HostExtension`] — provide a namespace, a channel name, a JS
11//!    injection script, and a message handler.
12//! 2. Register the extension with an [`ExtensionRegistry`].
13//! 3. Call [`ExtensionRegistry::combined_inject_script`] and inject the result
14//!    after `HOST_API_BRIDGE_SCRIPT`.
15//!
16//! See the [extensions guide](../docs/extensions.md) for the full lifecycle,
17//! the JS contract, and the graduation path from `ext.*` to core.
18
19pub mod events;
20pub mod executor_contract;
21pub mod first_party;
22pub mod manifest;
23pub mod protocol;
24pub mod registry;
25pub mod trait_def;
26
27pub use first_party::crdt::CrdtExtension;
28pub use first_party::crdt_runtime::{CrdtRuntime, CrdtRuntimeError, InMemoryCrdtRuntime};
29pub use first_party::data::DataExtension;
30pub use first_party::files::FilesExtension;
31pub use first_party::media::MediaExtension;
32pub use first_party::mesh::MeshExtension;
33pub use first_party::mesh_runtime::{
34    current_time_ms,
35    generate_session_nonce,
36    private_object_result,
37    InMemoryMeshConfig,
38    InMemoryMeshRuntime,
39    MeshPrivateControlWireMessage,
40    MeshPrivateReceiptWireMessage,
41    MeshPrivateWireQuery,
42    MeshRuntime,
43    MeshWireQuery,
44    MeshWireReply,
45    // Wire types and channel constants
46    StoredMeshObject,
47    StoredPrivateMeshObject,
48    MESH_PRIVATE_CONTROL_CHANNEL,
49    MESH_PRIVATE_QUERY_CHANNEL,
50    MESH_PRIVATE_RECEIPT_CHANNEL,
51    MESH_QUERY_CHANNEL,
52    MESH_REPLY_CHANNEL,
53};
54#[cfg(feature = "native-realtime")]
55pub use first_party::native_realtime_support::{
56    init_realtime_transport, RealtimeStatement, RealtimeTransport,
57};
58pub use registry::ExtensionRegistry;
59pub use trait_def::{HostExtension, HostPushEvent};
host_extensions/lib.rs

host_extensions/
lib.rs
