Struct DocumentServiceWrapper 

pub struct DocumentServiceWrapper { /* private fields */ }

Thread-safe, Clone-able FFI wrapper for the unified Document API.

All methods accept JSON strings and return JSON strings, making them suitable for consumption from Python, Node.js, Go, and other FFI callers.

Implementations

impl DocumentServiceWrapper

pub fn new(service: Box<dyn DocumentService>) -> Self

Create a wrapper from a boxed DocumentService.

pub fn from_arc(service: Arc<dyn DocumentService>) -> Self

Create a wrapper from an Arc<dyn DocumentService>.

pub fn from_agent_wrapper(wrapper: &AgentWrapper) -> BindingResult<Self>

Create a wrapper from an AgentWrapper using the filesystem backend.

This is the typical construction path for language bindings: load an agent, then create a document service from it.

pub fn create_json( &self, json: &str, options_json: Option<&str>, ) -> BindingResult<String>

Create a new document. Returns the signed document as JSON.

options_json is an optional JSON string of CreateOptions. If None, defaults are used.

pub fn get_json(&self, key: &str) -> BindingResult<String>

Get a document by key (id:version). Returns the document JSON.

pub fn get_latest_json(&self, document_id: &str) -> BindingResult<String>

Get the latest version of a document. Returns the document JSON.

pub fn update_json( &self, document_id: &str, new_json: &str, options_json: Option<&str>, ) -> BindingResult<String>

Update a document, creating a new signed version. Returns the new version JSON.

options_json is an optional JSON string of UpdateOptions.

pub fn remove_json(&self, key: &str) -> BindingResult<String>

Remove (tombstone) a document. Returns the tombstoned document JSON.

pub fn list_json(&self, filter_json: Option<&str>) -> BindingResult<String>

List documents with optional filter. Returns JSON array of DocumentSummary.

filter_json is an optional JSON string of ListFilter.

pub fn search_json(&self, query_json: &str) -> BindingResult<String>

Search documents. Returns JSON SearchResults.

query_json is a JSON string of SearchQuery.

pub fn versions_json(&self, document_id: &str) -> BindingResult<String>

Get all versions of a document. Returns JSON array of documents.

pub fn diff_json(&self, key_a: &str, key_b: &str) -> BindingResult<String>

Diff two document versions. Returns JSON DocumentDiff.

pub fn visibility_json(&self, key: &str) -> BindingResult<String>

Get the visibility of a document. Returns JSON string ("public", "private", etc.).

pub fn set_visibility_json( &self, key: &str, visibility_json: &str, ) -> BindingResult<()>

Set the visibility of a document.

visibility_json is a JSON string (e.g., "public", "private", {"restricted":["agent-a"]}).

Trait Implementations

impl Clone for DocumentServiceWrapper

fn clone(&self) -> DocumentServiceWrapper

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.