errors.go

// Copyright 2017-2026 Allow2 Pty Ltd. All rights reserved.
// Use of this source code is governed by the Allow2 API and SDK Licence.

package allow2service

import "fmt"

// Allow2Error is the base error for all Allow2 SDK errors.
type Allow2Error struct {
	Message string
	Context map[string]interface{}
}

func (e *Allow2Error) Error() string {
	return e.Message
}

// ApiError is thrown when an Allow2 API call fails with an unexpected error.
type ApiError struct {
	Allow2Error
	HTTPStatusCode int
	ResponseBody   map[string]interface{}
}

func (e *ApiError) Error() string {
	if e.HTTPStatusCode > 0 {
		return fmt.Sprintf("%s (HTTP %d)", e.Message, e.HTTPStatusCode)
	}
	return e.Message
}

// Unwrap returns the underlying Allow2Error.
func (e *ApiError) Unwrap() error {
	return &e.Allow2Error
}

// TokenExpiredError is thrown when the OAuth2 token refresh fails
// and no valid token is available.
type TokenExpiredError struct {
	Allow2Error
	UserID string
}

func (e *TokenExpiredError) Error() string {
	return e.Message
}

// Unwrap returns the underlying Allow2Error.
func (e *TokenExpiredError) Unwrap() error {
	return &e.Allow2Error
}

// GetUserID returns the user ID associated with this error.
func (e *TokenExpiredError) GetUserID() string {
	return e.UserID
}

// UnpairedError is thrown when the service account is no longer linked (HTTP 401/403 from API).
// The integration should redirect the user through OAuth2 re-pairing.
type UnpairedError struct {
	Allow2Error
	UserID string
}

func (e *UnpairedError) Error() string {
	if e.Message != "" {
		return e.Message
	}
	return "Service account is no longer linked. Re-pairing required."
}

// Unwrap returns the underlying Allow2Error.
func (e *UnpairedError) Unwrap() error {
	return &e.Allow2Error
}

// GetUserID returns the user ID associated with this error.
func (e *UnpairedError) GetUserID() string {
	return e.UserID
}