Skip to main content
Version: 1.2.2

Readable request and error logs

Version: 1.2.2 Date: 2026-10-23

Goal: Match legacy backend request logs: one line per event, scalar fields, no multiline dumps.

Solution: A request middleware, created document and client error (4xx) lines, 5xx errors as scalars, and replacement of logger.error(err) / console.* on the request, ingest, and exception-filter path. Logger formats log / warn / error with scalar fields or an Error, and a [Service] prefix on the same line as the message. Searchable fields are included when the value is known (email, name, document_id, document_name, hash, file_id, file_name, job_id, company_id). printPipeline still prints the aggregation pipeline JSON in its own Nest context.

Files Modified:

  • src/core/logger/logger.service.ts - One-line format ([Service] plus scalar fields and Error)
  • src/core/auth/auth.service.ts - firstName / lastName projection for auth logs
  • src/core/logger/logger.service.spec.ts - Logger format tests
  • src/shared/middleware/request-log.middleware.ts - One line per HTTP request
  • src/app.module.ts - Register the request middleware
  • src/core/error/error.service.ts - 5xx only, one line
  • src/core/error/global-exception.filter.ts - Warn client error for 4xx
  • src/domains/gateway/exceptions/gateway-exception.filter.ts - Warn client error on the gateway
  • src/domains/document/document.service.ts - Ingest success and denied proof access
  • src/domains/document/document.controller.ts - Duplicate-hash failure
  • src/domains/document/document.controller.spec.ts - Logger mock
  • src/core/auth/middleware/authorization.middleware.ts - Rejected token on one line
  • src/core/database/database.provider.ts - Database connection failure on one line
  • src/domains/gateway/gateway.controller.ts - Magic link errors on one line
  • src/domains/gateway/services/config.service.ts - OAuth config parse on one line
  • src/domains/gateway/services/keyvault.service.ts - Key Vault errors on one line
  • src/domains/gateway/services/magic-link.service.ts - Token validation on one line
  • src/domains/gateway/services/auth-strategy-detector.service.ts - Strategy detection on one line
  • src/domains/gateway/services/oauth.service.ts - OAuth errors on one line

Release fragment: fix-log-ingest-header-rejection