@compas/server/src/middleware/error.js

Koa server and common middleware

import { AppError, isProduction } from "@compas/stdlib";

/**
 * @type {NonNullable<import("../app").ErrorHandlerOptions["onError"]>}
 * Default onError handler that doesn't handle anything
 */
const defaultOnError = () => false;

/**
 * @type {NonNullable<import("../app").ErrorHandlerOptions["onAppError"]>}
 * Default onAppError handler that builds a simple object with key, message and info.
 */
const defaultOnAppError = () => ({});

/**
 * Handle any upstream errors
 *
 * @param {import("../app").ErrorHandlerOptions} opts
 * @returns {Middleware}
 */
export function errorHandler(opts) {
  const onAppError = opts.onAppError ?? defaultOnAppError;
  const onError = opts.onError ?? defaultOnError;

  return async (ctx, next) => {
    try {
      await next();
    } catch (/** @type {any} */ error) {
      if (onError(ctx, error)) {
        return;
      }

      let err = error;
      let log = ctx.log.info;

      if (!AppError.instanceOf(err)) {
        err = AppError.serverError({}, err);
      }

      if (err.status >= 500) {
        log = ctx.log.error;
      }

      ctx.status = err.status;

      const formatted = AppError.format(err);
      formatted.type = "api_error";
      formatted.requestId = ctx.requestId;

      log(formatted);

      if (onAppError === defaultOnAppError) {
        if (isProduction()) {
          delete formatted.stack;
          delete formatted.cause;
        }

        ctx.body = formatted;
      } else {
        ctx.body = onAppError(ctx, err.key, err.info);
      }
    }
  };
}