/jsC8

Official JS SDK for Macrometa

Primary LanguageTypeScriptApache License 2.0Apache-2.0

jsc8 SDK

npm npm type definitions npm

Javacript SDK for the Macrometa Global Data Mesh.


⚙️ Installation

  • From NPM
npm install jsc8
  • From source:
git clone https://github.com/macrometacorp/jsc8.git
cd jsc8
npm install
npm run dist

🐺 Enable pre-commit hooks

On every commit we will run pre-commit hooks. Pre-commit hooks are running pretty-quick package that runs prettier code formatting. You can find more about pretty-quick and prettier here. (Option 2.) To enable pre-commit hooks you need to run once:

 npx husky install

🧪 Testing

End-to-end tests can be found in src/tests/. Before first run create .env file in the root of the project. In .env file add variables:

  • URL="<your federation url>"
  • FABRIC="<selected fabric>"
  • API_KEY="<your api key>"

.env file is in .gitignore.

To run tests position yourself in the project's root directory and run:

npm run devtest

🔐 Authentication

Currently, jsc8 supports API Key, JWT token, username and password authentication. Preferred method needs to be passed during client creation. We highly recommend that you use API key or JWT token.

You can create you test Macrometa account with this link.

After that you can check out our getting started code examples.

🪛 Update jsC8

npm update jsc8

📗 Examples

You can find code examples in our getting started examples.

🆘 Macrometa Support

If you have any trouble or need help while using SDK please contact support@macrometa.com.

⚖️ License

This library is distributed under the Apache License 2.0 license found in the License.

📜 Code of Conduct

This project and everyone participating in it is governed by the Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to product@macrometa.com.