Getting Started

NestJS Toolbox is a growing collection of practical NestJS components — TypeORM utilities, logging, access control, API helpers, and more.

Each package is independently installable, lightweight, and follows a decorator-first, zero-config philosophy.

Installation

All packages are published under the @nest-toolbox npm scope. Install only what you need:

npm install @nest-toolbox/response-envelope
npm install @nest-toolbox/request-context
npm install @nest-toolbox/typeorm-audit-log
# ... etc

Packages Overview

🗄️ TypeORM Utilities

Package	Description
typeorm-audit-log	Automatic audit logging with user attribution and diff tracking
typeorm-paginate	Simple, efficient pagination for TypeORM queries
typeorm-soft-delete	Soft delete utilities with enhanced DX
typeorm-upsert	Upsert (insert or update) operations for TypeORM

📝 Logging

Package	Description
bunyan-logger	NestJS LoggerService backed by Bunyan
winston-logger	NestJS LoggerService backed by Winston
http-logger-middleware	HTTP request/response logging middleware
bootstrap-log	Pretty bootstrap log with your app configs

🔧 Utilities

Package	Description
access-control	Flexible role-based access control using role-acl
request-context	Lightweight AsyncLocalStorage-based request context with auto-generated request IDs
response-envelope	Standard API response envelope with interceptor and helpers
open-api-spec-to-ts	Generate TypeScript interfaces from OpenAPI specs
version-generator	Generate version info from git metadata
progress-bar	Simple CLI progress bar for long-running tasks

Philosophy

• Safety > Performance > Developer Experience — in that order
• Decorator-first — @SkipEnvelope(), @Auditable(), @ApiMessage() — just works
• Zero config — sensible defaults, opt-in customization via forRoot()
• Zero technical debt — tested, linted, typed
• Minimal dependencies — each package pulls only what it needs

Contributing

PRs welcome! See the GitHub repository for contribution guidelines.