Central Locking

A NestJS library for distributed locking using Redis. This package helps you manage distributed locks in a NestJS application, ensuring that only one instance of a process runs at a time.

Table of Contents

• Installation
• Usage
  • Setup
  • Using the Locking Decorator
• API
  • CentralLock Decorator
  • LockingService
• Contributing
• Author
• License

Installation

To install the package, use npm or yarn:

1npm install @gromo-fintech/central-locking-service

or

1yarn add @gromo-fintech/central-locking-service

Usage

Setup

First, import the LockingModule into your NestJS application module:

1import { Module } from '@nestjs/common';
2import { LockingModule } from 'central-locking-service';
3
4@Module({
5  imports: [LockingModule],
6})
7export class AppModule {}

Using the Locking Decorator

You can use the CentralLock decorator to ensure a method acquires a lock before execution. This is useful for scenarios where only one instance of a method should run at a time across distributed systems.

1import { CentralLock, LockingService } from 'central-locking-service';
2
3export class SomeService {
4  constructor(private lockingService: LockingService) {}
5
6  @CentralLock({
7    lockKey: 'unique-lock-key',
8    lockDuration: 10000,
9    shouldReleaseAfterExecution: true,
10    shouldThrowErrorIfUnableToAcquireLock: true,
11  })
12  async handleTask() {
13    console.log('Task is being handled.');
14    // Your business logic here
15  }
16}

API

CentralLock Decorator

The CentralLock decorator is used to manage distributed locks on methods.

Options:

• lockKey (string): The key to identify the lock.
• lockDuration (number): The duration (in milliseconds) for which the lock should be held.
• shouldReleaseAfterExecution (boolean): Whether to release the lock after method execution.
• shouldThrowErrorIfUnableToAcquireLock (boolean): Whether to throw an error if unable to acquire the lock.

LockingService

The LockingService provides methods to acquire and release locks.

Methods:

• acquireLock(key: string, duration: number): Promise<void>: Acquires a lock for a specific duration.
• releaseLock(key: string): Promise<void>: Releases the lock for the specified key.

Contributing

Contributions are welcome! Please submit a pull request or open an issue to discuss any changes or improvements.

1. Fork the repository.
2. Create your feature branch: git checkout -b feature/your-feature
3. Commit your changes: git commit -m 'Add some feature'
4. Push to the branch: git push origin feature/your-feature
5. Open a pull request.

Author

Saket Anand

Lead Engineer
Saket Anand is the lead engineer behind the @gromo-fintech/nestjs-central-locking. With a deep focus on leveraging Redis, his work has been central to the efficient central locking provided by this library.

License

MIT licensed