// Copyright 2020-2026 Buf Technologies, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package bufconnect

import "errors"

// AuthError wraps the error returned in the auth provider to add additional context.
type AuthError struct {
	cause       error
	remote      string
	hasToken    bool
	tokenEnvKey string
}

// Unwrap returns the underlying error.
func (e *AuthError) Unwrap() error {
	return e.cause
}

// Error implements the error interface and returns the error message.
func (e *AuthError) Error() string {
	if e.cause == nil {
		return "unknown error"
	}
	return e.cause.Error()
}

// Remote returns the remote the request was sent to.
func (e *AuthError) Remote() string {
	return e.remote
}

// HasToken returns whether a token was included in the request.
func (e *AuthError) HasToken() bool {
	return e.hasToken
}

// TokenEnvKey returns the environment variable used, if any, for authentication.
func (e *AuthError) TokenEnvKey() string {
	return e.tokenEnvKey
}

// AsAuthError uses errors.As to unwrap any error and look for an *AuthError.
func AsAuthError(err error) (*AuthError, bool) {
	var authErr *AuthError
	ok := errors.As(err, &authErr)
	return authErr, ok
}

// AugmentedConnectError wraps an error, providing the Procedure and Addr of
// the request for introspection in callers.
type AugmentedConnectError struct {
	cause     error
	procedure string
	addr      string
}

// Error implements the error interface and returns the error message.
func (e *AugmentedConnectError) Error() string {
	if e.cause == nil {
		return "unknown error"
	}
	return e.cause.Error()
}

// Unwrap returns the underlying error.
func (e *AugmentedConnectError) Unwrap() error {
	return e.cause
}

// Procedure returns the connect.AnyRequest's Spec().Procedure.
func (e *AugmentedConnectError) Procedure() string {
	return e.procedure
}

// Addr returns the connect.AnyRequest's Peer().Addr.
func (e *AugmentedConnectError) Addr() string {
	return e.addr
}