@tslock/express

TSLock middleware integration for Express.js.

The Express adapter acquires a lock before entering a route handler, returns a configurable lock-failure response when another request owns the lock, and releases the lock when the response finishes or the client disconnects.

Installation

pnpm add @tslock/core @tslock/express @tslock/in-memory express

Usage

import express from 'express';
import { InMemoryLockProvider } from '@tslock/in-memory';
import { createExpressLock } from '@tslock/express';

const app = express();
const tslock = createExpressLock({
  lockProvider: new InMemoryLockProvider(),
  lockAtMostFor: '30s',
});

app.get('/reports', tslock(), (_req, res) => {
  res.json({ ok: true });
});

The default lock name is derived from the HTTP method and route path. Configure lockNamePrefix, lockAtMostFor, lockAtLeastFor, defaultLockedStatus, or a custom locked response through createExpressLock.

Integration tests

The end-to-end suite starts a real Node HTTP server and exercises concurrent requests, lock release, handler errors, LockAssert, method-specific names, custom status codes, and middleware reentrancy:

pnpm --filter @tslock/express test:integration

Requirements

• Node.js >= 22
• Peer: express

License

Apache 2.0 — see LICENSE for details.