TypeScript library that provides a simple interface for symmetric (i.e., symmetric-key) and asymmetric (i.e., asymmetric-key) encryption/decryption primitives.
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.
The package is available on npm:
npm install @nthparty/bclThe 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.
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 lintIn 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.
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.