Zstandard compression library for Node.js

npm install @mongodb-js/zstd

Releases are created automatically and signed using the Node team's GPG key. This applies to the git tag as well as all release packages provided as part of a GitHub release. To verify the provided packages, download the key and import it using gpg:

gpg --import node-driver.asc

The GitHub release contains a detached signature file for the NPM package (named mongodb-js-zstd-X.Y.Z.tgz.sig).

The following command returns the link npm package.

npm view @mongodb-js/[email protected] dist.tarball 

Using the result of the above command, a curl command can return the official npm package for the release.

To verify the integrity of the downloaded package, run the following command:

gpg --verify mongodb-js-zstd-X.Y.Z.tgz.sig mongodb-js-zstd-X.Y.Z.tgz

To verify the native .node packages, follow the same steps as above using mongodb-js-zstd-X.Y.Z-platform.tgz and the corresponding .sig file.

Only the following version combinations with the MongoDB Node.js Driver are considered stable.

Below are the platforms that are available as prebuilds on each github release. prebuild-install downloads these automatically depending on the platform you are running npm install on.

• Linux GLIBC 2.28 or later
  • s390x
  • arm64
  • x64
• Linux MUSL 1.1.20
  • arm64
  • x64
• MacOS universal binary
  • x64
  • arm64
• Windows
  • x64

export function compress(buffer: Buffer | ArrayBuffer | Uint8Array, level: number): Promise<Buffer>;
export function decompress(buffer: Buffer): Promise<Buffer>;

Think you’ve found a bug? Want to see a new feature in @mongodb-js/zstd? Please open a case in our issue management tool, JIRA:

• Create an account and login jira.mongodb.org.
• Navigate to the NODE project jira.mongodb.org/browse/NODE.
• Click Create Issue - Please provide as much information as possible about the issue type and how to reproduce it.

For issues with, questions about, or feedback for the library, please look into our MongoDB Community Forums.

Change history can be found in HISTORY.md.

import { compress, decompress } from '@mongodb-js/zstd';

(async () => {
  const buffer = Buffer.from('test');
  const compressed = await compress(buffer, 10);
  const decompressed = await decompress(compressed);
})();

First, install and build the zstd library:

npm run install-zstd

Then build the bindings:

npm run prebuild

Then test: npm test