bookclerk_plugin_database_d1::atomic

Development These docs follow the development version and change with every merge.

Last updated View as Markdown

Generic D1 HTTP batch() executor for host-authored SQL plans.

The guest does not parse Bookclerk operation names. Production and tests use D1Proxy::run_typed_atomic (ExecuteRequest).

Item Kind Summary
is_ambiguous_d1 function True when err is a D1 ambiguous-commit marker.
plugin_error_from_d1 function Maps a D1 DbErr onto the guest ABI.

Functions

is_ambiguous_d1

pub fn is_ambiguous_d1(err: &DbErr) -> bool

True when err is a D1 ambiguous-commit marker.

plugin_error_from_d1

pub fn plugin_error_from_d1(err: DbErr) -> PluginError

Maps a D1 DbErr onto the guest ABI.

Ambiguity wins: a receipt-lost or D1 ambiguous failure is unavailable even when it wraps a cap failure, because the mutation may have committed and a terminal limit_exceeded would tell the caller it did not. The canonical limit text stays in the message so the host still reads the cap back. A cap failure without the marker is limit_exceeded with details; other retryable failures are unavailable, client 4xx is invalid_params, and engine codes go through the shared mapper.

Generated from crates/bookclerk-plugins/optional/database-d1 at main · View as Markdown