@amn-ms/common

Shared code library for AMN Microservices.

Installation

npm install @amn-ms/common

Contents

Errors

• CustomError - Base error class
• BadRequestError - 400 errors
• NotAuthorizedError - 401 errors
• NotFoundError - 404 errors
• RequestValidationError - Validation errors

Middlewares

• currentUser - Extract user from JWT token
• requireAuth - Protect routes (requires authentication)
• validateRequest - Validate request with express-validator
• errorHandler - Global error handler

Usage

In your microservice:

import { 
  currentUser, 
  requireAuth, 
  errorHandler,
  NotFoundError 
} from '@amn-ms/common';

// Use middlewares
app.use(currentUser);
app.use('/protected', requireAuth);
app.use(errorHandler);

// Throw errors
throw new NotFoundError();

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Publish (updates version automatically)
npm run pub

Building

The package is built using TypeScript and outputs to the build/ directory.

Publishing

1. Make changes to src/
2. Run npm run pub (builds, bumps version, publishes)
3. Or manually: npm run build && npm publish