@biscuit-auth/biscuit-wasm

Biscuit-Wasm

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

It provides an EcmaScript module, along with TypeScript type definitions.

Usage

Add this dependency to your package.json:

{
    "dependencies": {
        "@biscuit-auth/biscuit-wasm": "0.4.0-alpha1"
    }
}

Node

see the example code in examples/node

Due to some wasm side dependencies, to work in Node, biscuit-wasm requires that this be added to the application:

import { webcrypto } from 'node:crypto'
globalThis.crypto = webcrypto

The node executable must also 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

Changelog

0.4.0-alpha1

• allow creating a KeyPair from a PrivateKey (#1) (kanru)
• esm support (#6) (Geoffroy Couprie)
• support for biscuit 3.0 (#3) (Geoffroy Couprie)
• more idiomatic JS naming (#7) (flyboarder)
• make BiscuitBuilder constructor public & clippy fixes (#10) (Pierre Tondereau)
• API cleanup (#9) (Geoffroy Couprie)
• Support for authorizer queries (#12) (Geoffroy Couprie)