upstream-mattermost/server/public/utils/json.go

// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
// See LICENSE.txt for license information.

package utils

import (
	"bytes"
	"encoding/json"
	"strings"
	"unicode"

	"github.com/pkg/errors"
)

type HumanizedJSONError struct {
	Err       error
	Line      int
	Character int
}

func (e *HumanizedJSONError) Error() string {
	return e.Err.Error()
}

// HumanizeJSONError extracts error offsets and annotates the error with useful context
func HumanizeJSONError(err error, data []byte) error {
	if syntaxError, ok := err.(*json.SyntaxError); ok {
		return NewHumanizedJSONError(syntaxError, data, syntaxError.Offset)
	} else if unmarshalError, ok := err.(*json.UnmarshalTypeError); ok {
		return NewHumanizedJSONError(unmarshalError, data, unmarshalError.Offset)
	}
	return err
}

func NewHumanizedJSONError(err error, data []byte, offset int64) *HumanizedJSONError {
	if err == nil {
		return nil
	}

	if offset < 0 || offset > int64(len(data)) {
		return &HumanizedJSONError{
			Err: errors.Wrapf(err, "invalid offset %d", offset),
		}
	}

	lineSep := []byte{'\n'}

	line := bytes.Count(data[:offset], lineSep) + 1
	lastLineOffset := bytes.LastIndex(data[:offset], lineSep)
	character := int(offset) - (lastLineOffset + 1) + 1

	return &HumanizedJSONError{
		Line:      line,
		Character: character,
		Err:       errors.Wrapf(err, "parsing error at line %d, character %d", line, character),
	}
}

func IsEmptyJSON(j json.RawMessage) bool {
	if len(j) == 0 {
		return true
	}

	// remove all whitespace
	jj := make([]byte, 0, len(j))
	for _, b := range j {
		if !unicode.IsSpace(rune(b)) {
			jj = append(jj, b)
		}
	}

	if len(jj) == 0 || bytes.Equal(jj, []byte("{}")) || bytes.Equal(jj, []byte("\"\"")) || bytes.Equal(jj, []byte("[]")) {
		return true
	}
	return false
}

func StringPtrToJSON(ptr *string) json.RawMessage {
	if ptr == nil || len(*ptr) == 0 {
		return []byte("{}")
	}
	s := *ptr

	if strings.HasPrefix(s, "{") && strings.HasSuffix(s, "}") {
		return []byte(s)
	}

	if strings.HasPrefix(s, "[") && strings.HasSuffix(s, "]") {
		return []byte(s)
	}

	if strings.HasPrefix(s, "\"") && strings.HasSuffix(s, "\"") {
		return []byte(s)
	}

	// This must be a bare string which will need quotes to make a valid JSON document.
	return []byte("\"" + s + "\"")
}