Skip to main content

Crate uni_plugin_host

Crate uni_plugin_host 

Source
Expand description

§uni-plugin-host

Host-side runtime for the uni-db plugin framework. This crate holds the reusable engine implementations that the uni-db API crate wires into Uni/Session/Transaction:

  • trigger dispatch + mutation-event extraction (triggers)
  • change-data-capture runtime (cdc_runtime)
  • background-job scheduler (scheduler, scheduler_persistence)
  • meta-plugin system-label persistence (persistence)
  • synthetic declared-procedure host (synthetic_procedure)
  • commit notifications + session hooks (notifications, hooks)
  • OpenTelemetry layer (observability)

It sits above the leaf uni-plugin trait crate and below uni-db. Logic that genuinely needs the Uni lifecycle is inverted behind the host::HostCypherExecutor trait, which uni-db implements.

Modules§

cdc_runtime
M11 FU-4 — change-data-capture (CDC) runtime.
commit_result
Commit-result value types, shared by the API crate and the plugin-host hooks engine. Pure data — no Uni coupling.
hooks
Session hooks — before/after interception for queries and commits.
host
Host callback surface.
http_egress
Blocking HTTP egress for capability-gated plugin host functions.
notifications
Commit notifications — reactive awareness of database changes.
observability
OpenTelemetry tracing-subscriber layer for uni-db.
persistence
System-label persistence backends for CustomPlugin.
scheduler
Host-side tokio-backed scheduler driver.
scheduler_persistence
Durable SchedulerPersistence backend for uni-db.
shutdown
synthetic_procedure
Synthetic procedure plugin for declared-procedure body execution.
triggers
Host-side dispatch for TriggerPlugin registrations (M5f).