DS Express Errors (오류 라이브러리 중앙화) — v1.8.0 및 v1.8.1 릴리스 노트

Source: Dev.to

v1.8.0 – 2026년 1월 11일

새로운 기능

• Custom error classes – setConfig를 통해 직접 만든 오류 클래스(예: Zod, Joi)를 제공하여 검증을 강화합니다.
• Selective mappers – 설정을 통해 필요한 매퍼만 활성화해 불필요한 검사를 줄입니다.
• Rate‑limited logger – 로거 과부하를 방지하기 위해 maxLoggerRequests(기본값 100 요청/분)를 추가했습니다.
• Colourful logger output – 내장 로거가 색상을 지원해 가독성을 높였습니다.
• New Prisma error codes – P2005, P2006, P2007, P2011, P2027 오류 코드 처리를 추가했습니다.
• Additional error type – Errors.GatewayTimeout(message) 오류 타입이 새롭게 제공됩니다.

매퍼 개선

• Express‑validator – 잘못된 로직을 수정했습니다.
• Mongoose – 상태 코드 처리를 수정하고 내부 safeStringify 메서드에서 BigInt 검사를 추가했습니다.
• Sequelize – 상태 코드 처리를 수정하고 매핑을 다음을 포함하도록 업데이트했습니다:
  • SequelizeOptimisticLockError
  • SequelizeEmptyResultError
  • SequelizeDatabaseError
  • SequelizeConnectionError
  • SequelizeTimeoutError
• Prisma – 오류 처리를 확대하고 검증 로직을 정교화했습니다.

로거 리팩터링

• custom logger 지원을 추가했습니다.
• logDebug에 대한 누락된 api import를 수정했습니다.

설정 하이라이트

// Example snippet for enabling selective mappers and rate limiting
dsExpressErrors.setConfig({
  mappers: {
    zod: true,
    joi: true,
    // disable others you don't need
  },
  maxLoggerRequests: 100, // max log entries per minute
  // optional: provide your own error classes
  errorClasses: {
    ZodError: ZodError,
    JoiError: Joi.ValidationError,
  },
});

유용한 링크

• Official Changelog
• Documentation
• Roadmap
• Discussions / Ideas