drasi-plugin-sdk 0.4.3

SDK for building Drasi plugins (sources, reactions, bootstrappers)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

// Copyright 2025 The Drasi Authors.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

//! FFI layer for cdylib dynamic plugin loading.
//!
//! This module provides the `#[repr(C)]` types, vtable structs, and vtable
//! generation functions needed to wrap DrasiLib `Source`/`Reaction`/`BootstrapProvider`
//! trait implementations into stable C ABI entry points for cross-cdylib communication.
//!
//! # Module Structure
//!
//! - [`types`] — Core FFI-safe primitives (FfiStr, FfiResult, enums, etc.)
//! - [`callbacks`] — Log and lifecycle callback types
//! - [`vtables`] — `#[repr(C)]` vtable structs for all component types
//! - [`metadata`] — Plugin metadata for version validation at load time
//! - [`state_store_proxy`] — Plugin-side `StateStoreProvider` impl over vtable
//! - [`bootstrap_proxy`] — Plugin-side `BootstrapProvider` impl over vtable
//! - [`vtable_gen`] — Functions that wrap trait impls into vtables

pub mod bootstrap_proxy;
pub mod callbacks;
pub mod identity;
pub mod identity_proxy;
pub mod metadata;
pub mod state_store_proxy;
pub mod tracing_bridge;
pub mod types;
pub mod vtable_gen;
pub mod vtables;

// Re-export commonly used types at the ffi module level
pub use callbacks::{
    FfiLifecycleEvent, FfiLifecycleEventType, FfiLogEntry, FfiLogLevel, LifecycleCallbackFn,
    LogCallbackFn,
};
pub use metadata::{
    PluginMetadata, BUILD_TIMESTAMP, FFI_SDK_VERSION, GIT_COMMIT_SHA, TARGET_TRIPLE,
};
pub use types::{
    catch_panic_ffi, now_us, AsyncExecutorFn, FfiChangeOp, FfiComponentStatus, FfiCreateResult,
    FfiDispatchMode, FfiGetResult, FfiOwnedStr, FfiResult, FfiStr, FfiStringArray, SendMutPtr,
    SendPtr,
};
pub use vtable_gen::{
    build_bootstrap_plugin_vtable, build_bootstrap_provider_vtable, build_reaction_plugin_vtable,
    build_reaction_vtable, build_reaction_vtable_from_boxed, build_source_plugin_vtable,
    build_source_vtable, build_source_vtable_from_boxed, current_instance_log_ctx,
    InstanceLogContext,
};
pub use vtables::{
    BootstrapPluginVtable, BootstrapProviderVtable, FfiBootstrapEvent, FfiBootstrapPushCallbackFn,
    FfiBootstrapReceiver, FfiBootstrapSender, FfiChangePushCallbackFn, FfiChangeReceiver,
    FfiPluginRegistration, FfiResultPushCallbackFn, FfiRuntimeContext, FfiSourceEvent,
    FfiSubscriptionResponse, ReactionPluginVtable, ReactionVtable, SourcePluginVtable,
    SourceVtable, StateStoreVtable,
};

pub use bootstrap_proxy::FfiBootstrapProviderProxy;
pub use identity::{
    credentials_to_ffi, FfiCredentialType, FfiCredentials, FfiCredentialsResult,
    IdentityProviderVtable,
};
pub use identity_proxy::FfiIdentityProviderProxy;
pub use state_store_proxy::FfiStateStoreProxy;