A JavaScript library for connecting to a HeavyAI GPU database and running queries.

Install with npm install @heavyai/connector. Then import @heavyai/connector in your JavaScript program.

Visit our API Docs

There have been some potentially breaking changes in v6:

• Prior to v6, the browser version of connector would expose all of the thrift types on window. v6 will continue to do this if you import the script using a standard html <script> tag. But, if you are using a bundler or module system (such as webpack), that is no longer the case. These types will be exported instead (so you can, for example, import { TPixel } from "@heavyai/connector/dist/browser-connector")
• All of the xAsync functions return a Promise - that hasn't changed. The corresponding non-Async functions (ie, query vs queryAsync) now also return Promises. The callback argument on these non-Async versions is optional since you can just use then or catch or the Promise. It's impossible to run any function synchronously now, however. In other words, if you call query without a callback, it's going to run asynchronously and return a Promise.

Open example.html in your browser for a basic query call.

npm ci
npm run build
npm run docs # opens API docs in your browser.

Everything in connector should be unit-tested and linted. You can find these tests in /test.

The linter and all tests run on

npm test

It's our eventual goal to fully lint the files in heavyai-con/src. Try to write libraries/heavyai-con using the projects/dashboard-v2 Es6/7 style to make this goal easier to achieve.

A full list of third-party npm packages and their licenses is maintained in third_party_licenses/THIRD_PARTY_LICENSES.md. To regenerate it after dependency changes, run:

npx github:heavyai/js-license-list

This requires node_modules to be installed (npm install). The script is maintained in the heavyai/js-license-list repo.

Every third-party module from npm that gets includes in the final, distributed bundle has its license verified and license text (if provided) or license type shipped in licenses.txt with the bundle. Licenses must be in the pre-approved list of permissive open-source licenses. If it's necessary to override a license for a module because it's missing or improperly tagged in its package.json, add an entry in license-overrides.json.

License descriptions and public license URLs are maintained in licenses.json as well, but they are not verified and might not be up to date.

NVIDIA takes security seriously. If you discover a vulnerability in HeavyAI Connector, DO NOT open a public issue. Use one of the private reporting channels described in SECURITY.md.

Join the HeavyAI GitHub Discussions to ask questions, share feedback, and report issues. HeavyAI maintainers review issues, discussions, and pull requests on a best effort basis without guaranteed response timelines.

Apache 2.0. See LICENSE.

Variables and function names are used as convention and do not reference any commercial product.