Struct CustomPlugin 

pub struct CustomPlugin { /* private fields */ }

Top-level meta-plugin handle.

Implements uni_plugin::Plugin. Construct via CustomPlugin::new (with a shared PluginRegistry Arc and a Persistence backend) and add to a Uni instance through the host’s register_builtin_plugins flow (crates/uni/src/api/mod.rs).

The plugin owns:

• store — an in-memory DeclaredPluginStore mirroring every declaration, used for dependency analysis and read-side procedures (listDeclared, dropDeclared).
• registry — a shared Arc<PluginRegistry> so the declare* procedures can register synthetic uni_plugin::Plugin values at runtime.
• persistence — the durable backend that replays declarations on CustomPlugin::new.

Implementations

impl CustomPlugin

pub const ID: &'static str = "custom"

Reserved plugin id.

pub fn new( registry: Arc<PluginRegistry>, persistence: Arc<dyn Persistence>, ) -> Result<Self, CustomError>

Construct with the given registry handle and persistence backend.

On construction, the persistence backend is queried for every previously declared plugin and each one is re-installed into store (re-registration into registry happens lazily — the first time the plugin is invoked, or eagerly through Self::reactivate_into_registry).

Errors

Returns CustomError::Persistence if the backend’s load_all fails.

pub fn with_procedure_synthesizer( self, synthesizer: Arc<dyn ProcedureBodySynthesizer>, ) -> Self

Attach a host-side synthesizer so declared procedures (and triggers) can install executable plugins at declare time.

The host (uni-db) calls this immediately after Self::new. Synthesizer-less construction remains valid — declared procedures/triggers are recorded + persisted but not registered as invocable plugins.

pub fn new_in_memory() -> Self

Construct with no persistence (in-memory only) and a fresh PluginRegistry handle.

Used by tests that exercise the meta-plugin in isolation.

pub fn store(&self) -> &Arc<DeclaredPluginStore>

Access the underlying declared-plugin store.

pub fn registry(&self) -> &Arc<PluginRegistry>

Access the shared registry handle.

pub fn reactivate_into_registry(&self) -> Result<(), CustomError>

Replay every persisted declaration into the registry.

Called by the host immediately after Self::new so that declarations survive restart. Skips declarations whose qname is already registered as a native plugin (they remain marked active=false in the store).

Errors

Returns CustomError::Registration on registrar errors other than DuplicateRegistration (which is expected for shadowed declarations and downgrades the record to inactive).

Trait Implementations

impl Debug for CustomPlugin

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Plugin for CustomPlugin

fn manifest(&self) -> &PluginManifest

Static plugin description.

fn register(&self, r: &mut PluginRegistrar<'_>) -> Result<(), PluginError>

Register extension points with the host.

fn init(&self, _cx: &PluginInitContext<'_>) -> Result<(), PluginError>

Optional initialization callback.

fn shutdown(&self)

Optional shutdown callback.