Function formatOrpcError

src/node/orpc/formatOrpcError.ts:300–395

(error: unknown, interceptorOptions?: unknown)

}

export function formatOrpcError(error: unknown, interceptorOptions?: unknown): FormattedOrpcError {
  try {
    const requestContext = extractRequestContext(interceptorOptions);
    const where =
      requestContext.method && requestContext.path
        ? `${requestContext.method} ${requestContext.path}`
        : (requestContext.path ?? requestContext.url);

    const whereSuffix = where ? ` ${where}` : "";

    const debugDump: Record<string, unknown> = {
      request: requestContext,
    };

    if (error instanceof ORPCError) {
      const code = typeof error.code === "string" ? error.code : String(error.code);
      const status = typeof error.status === "number" ? error.status : undefined;

      debugDump.error = {
        type: "ORPCError",
        code,
        status,
        message: error.message,
        data: toJsonSafe(error.data, { depth: 6, seen: new WeakSet() }),
        stack: error.stack,
      };

      const validation = getValidationErrorInfo(error.cause);
      if (validation) {
        debugDump.cause = {
          type: "ValidationError",
          message: validation.message,
          issues: toJsonSafe(validation.issues, { depth: 6, seen: new WeakSet() }),
          data: toJsonSafe(validation.data, { depth: 6, seen: new WeakSet() }),
        };

        const lines: string[] = [];
        lines.push(
          `ORPC${whereSuffix}: ${code} ${error.message}${
            status !== undefined ? ` (status ${status})` : ""
          }`
        );

        if (validation.issues.length > 0) {
          const maxIssues = 5;
          lines.push(`Validation issues (${validation.issues.length}):`);

          for (const issue of validation.issues.slice(0, maxIssues)) {
            const path = formatIssuePath(issue.path);
            lines.push(`  - ${path}: ${issue.message}`);
          }

          if (validation.issues.length > maxIssues) {
            lines.push(`  (+${validation.issues.length - maxIssues} more)`);
          }
        }

        lines.push(`Data: ${summarizeForLogs(validation.data, 1)}`);