Cozo database for WASM
npm install cozo-lib-wasmThis crate provides Cozo web assembly modules for browsers.
If you are targeting NodeJS, use this instead:
native code is still _much_ faster than WASM.
This document describes how to set up the Cozo WASM module for use.
To learn how to use CozoDB (CozoScript), read the docs.
```
npm install cozo-lib-wasm
Alternatively, you can download cozo_wasm-index.html
from the release page and include
the JS and WASM files directly in your project: see the example
here for
what is required in your code.
See the code here. Basically, you write
`js`
import init, {CozoDb} from "cozo-lib-wasm";
and call
`js`
let db;
init().then(() => {
db = CozoDb.new();
// db can only be used after the promise resolves
})
`ts
export class CozoDb {
free(): void;
static new(): CozoDb;
run(script: string, params: string): string;
export_relations(data: string): string;
// Note that triggers are _not_ run for the relations, if any exists.
// If you need to activate triggers, use queries with parameters.
import_relations(data: string): string;
}
`
Note that this API is synchronous. If your computation runs for a long time,
it will block the main thread. If you know that some of your queries are going to be heavy,
you should consider running Cozo in a web worker. However, the published module
may not work across browsers in web workers (look for the row "Support for ECMAScript
modules" here).
The next section contains some pointers for how to alleviate this, but expect a lot of work.
You will need to install Rust, NodeJS with npm,
and wasm-pack first.
The published module was built with
`bash`
wasm-pack build --target web --release
and the environment variable CARGO_PROFILE_RELEASE_LTO=fat.
The important option is --target web: the above usage instructions only work for this target.
See the documentation here.
if you are interested in running Cozo in a web worker and expect it to run across browsers,
you will need to use the --target no-modules` option, and write a lot of gluing code.
See here for tips.