js-async-locks

Asynchronous lock utilities.

JavaScript exposes the ability to create interleaved execution of asynchronous operations. When this is done with shared state between asynchronous overlapping functions that perform partial state transitions, this can lead to race conditions or data corruption and clobbering, or just invalid pre-condition or post-condition behaviour.

This library provides multiple synchronization constructs that allow one to precisely control concurrent operations. These constructs are intended for pessimistic concurrency control. If you can prefer to use optimistic concurrency control mechanisms. But that is outside the scope of this library. In many cases you cannot use optimistic methods, and thus you need this library.

Installation

1npm install --save @matrixai/async-locks

Development

Run nix develop, and once you're inside, you can use:

1# install (or reinstall packages from package.json)
2npm install
3# build the dist
4npm run build
5# run the repl (this allows you to import from ./src)
6npm run tsx
7# run the tests
8npm run test
9# lint the source code
10npm run lint
11# automatically fix the source
12npm run lintfix

Docs Generation

1npm run docs

See the docs at: https://matrixai.github.io/js-async-locks/

Publishing

Publishing is handled automatically by the staging pipeline.

Prerelease:

1# npm login
2npm version prepatch --preid alpha # premajor/preminor/prepatch
3git push --follow-tags

Release:

1# npm login
2npm version patch # major/minor/patch
3git push --follow-tags

Manually:

1# npm login
2npm version patch # major/minor/patch
3npm run build
4npm publish --access public
5git push
6git push --tags