Struct Storage 

pub struct Storage { /* private fields */ }

A celerix Storage handle backed by Cloudflare Workers KV.

Injected automatically as an axum Extension<Storage> by #[celerix::main]. The binding is auto-resolved to {PROJECT_NAME}_STORAGE.

KV is initialized lazily on first use, so projects that don’t use storage won’t error even without a KV binding configured.

Implementations

impl Storage

pub fn new(env: Env) -> Storage

Create a Storage handle from a worker Env.

pub fn get( &self, key: &str, ) -> SendFuture<impl Future<Output = Result<Option<String>, Error>>>

Get a string value by key.

pub fn put( &self, key: &str, value: &str, ) -> SendFuture<impl Future<Output = Result<(), Error>>>

Put a string value.

pub fn delete( &self, key: &str, ) -> SendFuture<impl Future<Output = Result<(), Error>>>

Delete a key.

pub fn get_item<T>( &self, key: &str, ) -> SendFuture<impl Future<Output = Result<Option<T>, Error>>>

where T: DeserializeOwned + 'static,

Get a JSON-deserialized value by key.

let user: Option<User> = storage.get_item::<User>("user:123").await?;

pub fn set_item<T>( &self, key: &str, value: &T, ) -> SendFuture<impl Future<Output = Result<(), Error>>>

where T: Serialize,

Store a JSON-serializable value by key.

storage.set_item("user:123", &User { name: "Alice".into() }).await?;

pub fn env(&self) -> &Env

Get the underlying worker Env for advanced usage.

Trait Implementations

impl Clone for Storage

fn clone(&self) -> Storage

Returns a duplicate of the value.

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

Performs copy-assignment from source.