Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 14 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,35 +15,33 @@
> This repository is for the JavaScript client library for TerminusDB and
> TerminusCMS.

[**TerminusDB**][terminusdb] is an [open-source][terminusdb-repo] graph database
and document store. It allows you to link JSON documents in a powerful knowledge
graph all through a simple document API.
[**TerminusDB**][terminusdb] is an [open-source][terminusdb-repo] graph database and document store. It allows you to link JSON documents in a powerful knowledge graph all through a simple document API.

[terminusdb]: https://terminusdb.org/
[terminusdb-docs]: https://terminusdb.org/docs/
[terminusdb-repo]: https://github.com/terminusdb/terminusdb

**TerminusCMS** is a [headless content management system](https://terminusdb.com/terminuscms/) for complex enviroments. Try it out for yourself, it's free to get started with generous limits. Clone a demo project to play around. [Sign up][dashboard].
It is the model-based, in-memory, and distributed knowledge graph database for hierarchical records with a git-for-data collaboration model at its heart. So many great things in a single package and a high precision datalog query language with advanced features like transactions, schema validation and unification.

[dashboard]: https://dashboard.terminusdb.com/
For many, it serves as a headless content management system for complex enviroments with push, pull, clone, rebase and merge capabilities with immutable history and a strong schema checker that covers both the simplest and most advanced models.

Use the [cloud-based studio environment](https://studio.dfrnt.com/) to [build graph data products in the cloud](https://dfrnt.com/solutions-studio) or in your [localhost dockerized TerminusDB instances](https://terminusdb.org/docs/install-terminusdb-as-a-docker-container/). Try it out for yourself, it's free to get started with generous limits, clone a demo project to play around.

## Requirements

- Node.js version 10+ if using the TerminusDB client library as a Node.js package
- Node.js version 20+ if using the TerminusDB client library as a Node.js package (might work with earlier versions too).

## Installation

The TerminusDB JavaScript client library can be used either as a Node.js package
or as a script that runs in the browser.
The TerminusDB JavaScript client library can be used either as a Node.js package or as a script that runs in the browser.

### NPM Package

> :memo: If you don't already have Node.js installed, [install it][node-install] first.

[node-install]: https://docs.npmjs.com/downloading-and-installing-node-js-and-npm

To install the `terminusdb-client` package as a dependency in an existing
package, run:
To install the `@terminusdb/terminusdb-client` package as a dependency in an existing package, run:

```sh
$ npm install --save @terminusdb/terminusdb-client
Expand All @@ -53,15 +51,13 @@ This command updates your `package.json`.

### Script

To use the `terminusdb-client` script on a webpage sourced from a CDN, add this
to your HTML:
To use the `terminusdb-client` script on a webpage sourced from a CDN, add this to your HTML:

```html
<script src="https://unpkg.com/@terminusdb/terminusdb-client/dist/terminusdb-client.min.js"></script>
```

Alternatively, you can download the latest [`terminusdb-client.min.js`][js], add
it to your sources, and use that in the `<script>` instead.
Alternatively, you can download the latest [`terminusdb-client.min.js`][js], add it to your sources, and use that in the `<script>` instead.

[js]: https://unpkg.com/@terminusdb/terminusdb-client/dist/terminusdb-client.min.js

Expand All @@ -70,7 +66,7 @@ it to your sources, and use that in the `<script>` instead.
This example creates a simple dataProduct, starting to create a database model the schema
and insert a simple document

For the [full Documentation](https://terminusdb.com/docs/javascript)
For the [full Documentation](https://terminusdb.org/docs/javascript)

```javascript
const TerminusClient = require("@terminusdb/terminusdb-client");
Expand Down Expand Up @@ -139,7 +135,7 @@ async function createDataProduct(){

## Options

connections options.
Connections options.

To initialize `TerminusDB client` with custom options use

Expand All @@ -157,6 +153,8 @@ const client = new TerminusClient.WOQLClient("http://127.0.0.1:6363/", {

The TerminusDB API can be found at the [TerminusDB Documentation][terminusdb-docs].

TerminusDB communicates using JSON over HTTP. It works with advanced datatypes including integers, floats, decimals, big integers, arbitrary precision decimals, dates and other important XML Datatypes. Math is capped at 20 digits of precision, where the core is ready to support higher precision if needed.

## Report Issues

If you encounter any issues, please report it with your os and environment setup, the version that you are using, and a simple reproducible case.
Expand Down
1 change: 1 addition & 0 deletions docs/release_process.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,6 @@
1. Add target version number to release notes
1. Check in and merge
1. Pick the latest version from the RELEASE_NOTES.md file
1. Update package.json version and run npm install
1. Tag the repo locally and push the tag, align the release (git tag -s v11.x.x)
1. The new release will be built and published 🎉
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@terminusdb/terminusdb-client",
"version": "10.0.33",
"version": "11.1.1",
"description": "TerminusDB client library",
"main": "index.js",
"types": "./dist/typescript/index.d.ts",
Expand Down