Module ffi_sparse 

FFI Layer for Sparse Vector Store

C-ABI interface for the Sparse Vector Store, enabling use from Python, C++, and other FFI-capable languages.

Error Codes

Code	Constant	Meaning
1	SVS_SUCCESS	Operation succeeded
0	SVS_ERR_GENERIC	Generic error
-1	SVS_ERR_NULL_PTR	Null pointer argument
-2	SVS_ERR_INVALID_UTF8	Invalid UTF-8 string
-3	SVS_ERR_NOT_FOUND	Store or key not found
-4	SVS_ERR_ALREADY_EXISTS	Store already exists
-100	SVS_ERR_INTERNAL	Internal panic

Constants

SVS_ERR_ALREADY_EXISTS

SVS_ERR_GENERIC

SVS_ERR_INTERNAL

SVS_ERR_INVALID_UTF8

SVS_ERR_NOT_FOUND

SVS_ERR_NULL_PTR

SVS_SUCCESS

Functions

svs_close

Close and remove a sparse vector store from the registry.

svs_delete

Delete a document by key.

svs_exists

Check if a store exists in the registry.

svs_free_key

Free a key string returned by svs_search.

svs_index

Index a sparse vector with a key.

svs_len

Get the number of documents in the store.

svs_new

Create a new sparse vector store.

svs_open

Open an existing index from a file.

svs_save

Save the index to a file.

svs_search

Search for similar documents.

svs_stats

Get index statistics.