Usage

Library

See Documentation for examples and API

Associative, multidirectional, multiparental materialized-path realization.

To understand how to use it for your own purposes - look at migrations and tests.

Associative links structure base trigger table.
Column names configuration. You can use your structure, not only id/from_id/to_id with Trigger class options: id_field, to_field, from_field.
Multiparental. Any count of parent links in your trees, not only one.
Multidirectional. Not only from => to direction. You can has many trees with many links with many directions with Trigger class options: isAllowSpreadFromCurrent, isAllowSpreadCurrentTo, isAllowSpreadToCurrent, isAllowSpreadCurrentFrom, isAllowSpreadToInCurrent, isAllowSpreadCurrentFromOut, isAllowSpreadFromOutCurrent, isAllowSpreadCurrentToIn. See multidirectional migrations and tests for details.
Customizable id field type with Trigger class option: id_type.
PostgreSQL only for now.
Hasura support, but not required.
Grouping support. Not only one tree layer for one storage. You can separate multiple tree conditions with Trigger class options: iteratorInsertDeclare, iteratorInsertBegin, iteratorInsertEnd, iteratorDeleteArgumentSend, iteratorDeleteArgumentGet, iteratorDeleteDeclare, iteratorDeleteBegin, iteratorDeleteEnd, groupInsert, groupDelete, additionalFields, additionalData.
Benchmarks.

Install and run docker and npm. And then in this repo directory:

npm ci;
npm run hasura;
npm run migrate;
npm run test;
npm run unmigrate;

This command deletes node_modules, package-lock.json and runs npm i. So everything is refreshed.

npm run package:refresh

npm run package:release

After that it might be required to release new versions of:

Name		Name	Last commit message	Last commit date
Latest commit History 211 Commits
.github/workflows		.github/workflows
benchmarks		benchmarks
imports		imports
migrations		migrations
tests		tests
.gitignore		.gitignore
.gitpod.Dockerfile		.gitpod.Dockerfile
.gitpod.yml		.gitpod.yml
.npmignore		.npmignore
.nvmrc		.nvmrc
LICENSE		LICENSE
check.ts		check.ts
client.ts		client.ts
jest.config.ts		jest.config.ts
main.drawio		main.drawio
main.png		main.png
main.test.ts		main.test.ts
package-lock.json		package-lock.json
package.json		package.json
permissions.ts		permissions.ts
readme.md		readme.md
relationships.ts		relationships.ts
table.ts		table.ts
trigger.ts		trigger.ts
tsconfig.json		tsconfig.json