Skip to main content

WasmDB

Struct WasmDB 

Source
pub struct WasmDB { /* private fields */ }
Expand description

WebAssembly ReifyDB Engine

Provides an in-memory query engine that runs entirely in the browser. All data is stored in memory and lost when the page is closed.

Implementations§

Source§

impl WasmDB

Source

pub fn new() -> Result<WasmDB, JsValue>

Create a new in-memory ReifyDB engine

§Example
import init, { WasmDB } from './pkg/reifydb_engine_wasm.js';

await init();
const db = new WasmDB();
Source

pub fn query(&self, rql: &str) -> Result<JsValue, JsValue>

Execute a query and return results as JavaScript objects

§Example
const results = await db.query(`
  FROM [{ name: "Alice", age: 30 }]
  FILTER age > 25
`);
console.log(results); // [{ name: "Alice", age: 30 }]
Source

pub fn admin(&self, rql: &str) -> Result<JsValue, JsValue>

Execute an admin operation (DDL + DML + Query) and return results

Admin operations include CREATE, ALTER, INSERT, UPDATE, DELETE, etc.

§Example
await db.admin("CREATE NAMESPACE demo");
await db.admin(`
  CREATE TABLE demo.users {
    id: int4,
    name: utf8
  }
`);
Source

pub fn command(&self, rql: &str) -> Result<JsValue, JsValue>

Execute a command (DML) and return results

Commands include INSERT, UPDATE, DELETE, etc. For DDL operations (CREATE, ALTER), use admin() instead.

Source

pub fn query_with_params( &self, rql: &str, params_js: JsValue, ) -> Result<JsValue, JsValue>

Execute query with JSON parameters

§Example
const results = await db.queryWithParams(
  "FROM users FILTER age > $min_age",
  { min_age: 25 }
);
Source

pub fn admin_with_params( &self, rql: &str, params_js: JsValue, ) -> Result<JsValue, JsValue>

Execute admin with JSON parameters

Source

pub fn command_with_params( &self, rql: &str, params_js: JsValue, ) -> Result<JsValue, JsValue>

Execute command with JSON parameters

Trait Implementations§

Source§

impl Default for WasmDB

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Drop for WasmDB

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

impl From<WasmDB> for JsValue

Source§

fn from(value: WasmDB) -> Self

Converts to this type from the input type.
Source§

impl FromWasmAbi for WasmDB

Source§

type Abi = u32

The Wasm ABI type that this converts from when coming back out from the ABI boundary.
Source§

unsafe fn from_abi(js: u32) -> Self

Recover a Self from Self::Abi. Read more
Source§

impl IntoWasmAbi for WasmDB

Source§

type Abi = u32

The Wasm ABI type that this converts into when crossing the ABI boundary.
Source§

fn into_abi(self) -> u32

Convert self into Self::Abi so that it can be sent across the wasm ABI boundary.
Source§

impl LongRefFromWasmAbi for WasmDB

Source§

type Abi = u32

Same as RefFromWasmAbi::Abi
Source§

type Anchor = RcRef<WasmDB>

Same as RefFromWasmAbi::Anchor
Source§

unsafe fn long_ref_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi
Source§

impl OptionFromWasmAbi for WasmDB

Source§

fn is_none(abi: &Self::Abi) -> bool

Tests whether the argument is a “none” instance. If so it will be deserialized as None, and otherwise it will be passed to FromWasmAbi.
Source§

impl OptionIntoWasmAbi for WasmDB

Source§

fn none() -> Self::Abi

Returns an ABI instance indicating “none”, which JS will interpret as the None branch of this option. Read more
Source§

impl RefFromWasmAbi for WasmDB

Source§

type Abi = u32

The Wasm ABI type references to Self are recovered from.
Source§

type Anchor = RcRef<WasmDB>

The type that holds the reference to Self for the duration of the invocation of the function that has an &Self parameter. This is required to ensure that the lifetimes don’t persist beyond one function call, and so that they remain anonymous.
Source§

unsafe fn ref_from_abi(js: Self::Abi) -> Self::Anchor

Recover a Self::Anchor from Self::Abi. Read more
Source§

impl RefMutFromWasmAbi for WasmDB

Source§

type Abi = u32

Same as RefFromWasmAbi::Abi
Source§

type Anchor = RcRefMut<WasmDB>

Same as RefFromWasmAbi::Anchor
Source§

unsafe fn ref_mut_from_abi(js: Self::Abi) -> Self::Anchor

Same as RefFromWasmAbi::ref_from_abi
Source§

impl TryFromJsValue for WasmDB

Source§

fn try_from_js_value(value: JsValue) -> Result<Self, JsValue>

Performs the conversion.
Source§

fn try_from_js_value_ref(value: &JsValue) -> Option<Self>

Performs the conversion.
Source§

impl VectorFromWasmAbi for WasmDB

Source§

type Abi = <Box<[JsValue]> as FromWasmAbi>::Abi

Source§

unsafe fn vector_from_abi(js: Self::Abi) -> Box<[WasmDB]>

Source§

impl VectorIntoWasmAbi for WasmDB

Source§

type Abi = <Box<[JsValue]> as IntoWasmAbi>::Abi

Source§

fn vector_into_abi(vector: Box<[WasmDB]>) -> Self::Abi

Source§

impl WasmDescribe for WasmDB

Source§

impl WasmDescribeVector for WasmDB

Source§

impl SupportsConstructor for WasmDB

Source§

impl SupportsInstanceProperty for WasmDB

Source§

impl SupportsStaticProperty for WasmDB

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> IntoRequest<T> for T

Source§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
Source§

impl<L> LayerExt<L> for L

Source§

fn named_layer<S>(&self, service: S) -> Layered<<L as Layer<S>>::Service, S>
where L: Layer<S>,

Applies the layer to a service and wraps it in Layered.
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> ReturnWasmAbi for T
where T: IntoWasmAbi,

Source§

type Abi = <T as IntoWasmAbi>::Abi

Same as IntoWasmAbi::Abi
Source§

fn return_abi(self) -> <T as ReturnWasmAbi>::Abi

Same as IntoWasmAbi::into_abi, except that it may throw and never return in the case of Err.
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more