bcl-js

TypeScript library that provides a simple interface for symmetric (i.e., symmetric-key) and asymmetric (i.e., asymmetric-key) encryption/decryption primitives.

Purpose

This library provides simple and straightforward methods for symmetric (i.e., symmetric-key) and asymmetric (i.e., asymmetric-key) cryptographic encryption and decryption capabilities. The library's interface is designed for ease of use and therefore hides from users some of the flexibilities and performance trade-offs that can be leveraged via direct use of the underlying libraries.

The library's name is a reference to Boron trichloride, as it is a wrapper for a limited set of capabilities found in PyNaCl (which is itself a wrapper library for libsodium. However, it can also be an acronym for basic cryptographic library.

Package Installation and Usage

The package is available on npm:

npm install @nthparty/bcl

The library can be imported in the usual ways:

const BCl = require('path/to/dist/bcl.js');  // Standalone
const BCl = require('path/to/dist/bcl.slim.js')(sodium);  // Slim
const { BCl } = require('@nthparty/bcl');  // Node.js

BCl.ready.then(function () {
    const sk = BCl.Symmetric.secret();
    console.log(sk);  // Secret(32) [Uint8Array] [ ... ]
});

The latest browser-optimized distributions can be found here.

Testing and Conventions

All unit tests are executed and their coverage measured when using Jest (see jest.config.js for configuration details):

npm test

Browser-based tests are located in test/browser/, and you can run them either locally, or by visiting the preview.

Style conventions are enforced using ESLint:

eslint src test/bcl.test.ts
# -OR-
npm run-script lint

Contributions

In order to contribute to the source code, open an issue or submit a pull request on the GitHub page for this library. Remember to run npm run-script lint on any proposed code changes.

Versioning

Beginning with version 0.1.0, the version number format for this library and the changes to the library associated with version number increments conform with Semantic Versioning 2.0.0.