Biscuit-wasm

This repo is part of the eclipse biscuit project.

This library wraps the Rust implementation of Eclipse Biscuit tokens in WebAssembly, for usage in NodeJS and browsers.

It provides both EcmaScript and CommonJS modules, along with TypeScript type definitions.

Usage

Add this dependency to your package.json:

{
  "dependencies": {
    "@biscuit-auth/biscuit-wasm": "0.6.0-beta.1"
  }
}

Usage examples are available here.

Node

see the example code in examples/node

The node executable must be started with the --experimental-wasm-modules flag.

In browser

see the example code in examples/frontend

Importing a WebAssembly library with a bundler can take a bit of configuration. We have a working example with Webpack, and would welcome example configuration for other bundlers:

const path = require("path");

module.exports = {
  entry: "./index.js",
  output: {
    filename: "index.js",
    path: path.resolve(__dirname, "dist"),
  },
  experiments: {
    asyncWebAssembly: true,
  },
};

License

Licensed under the Apache 2.0 License.

Copyright 2021 Geoffroy Couprie