types.go

package main

import (
	"encoding/json"
	"fmt"
	"os"
	"strconv"
	"strings"
	"time"
)

// Config represents the application configuration
type Config struct {
	ClientID       string `json:"client_id"`
	ClientSecret   string `json:"client_secret"`
	RedirectURI    string `json:"redirect_uri"`
	Scopes         string `json:"scopes"`
	TokenStorePath string `json:"token_store_path"`
	Port           string `json:"port"`
}

// TokenStore holds the authentication tokens
type TokenStore struct {
	AccessToken  string    `json:"access_token"`
	RefreshToken string    `json:"refresh_token"`
	Expiry       time.Time `json:"expiry"`
	TenantID     string    `json:"tenant_id"`
	TenantName   string    `json:"tenant_name"`
	Scopes       string    `json:"scopes"`
	UpdatedAt    time.Time `json:"updated_at"`
}

// TokenResponse from Xero OAuth2
type TokenResponse struct {
	AccessToken  string `json:"access_token"`
	IDToken      string `json:"id_token"`
	ExpiresIn    int    `json:"expires_in"`
	TokenType    string `json:"token_type"`
	RefreshToken string `json:"refresh_token"`
	Scope        string `json:"scope"`
}

// Connection represents a Xero organization connection
type Connection struct {
	ID          string   `json:"id"`
	AuthEventID string   `json:"authEventId"`
	TenantID    string   `json:"tenantId"`
	TenantType  string   `json:"tenantType"`
	TenantName  string   `json:"tenantName"`
	CreatedDate XeroTime `json:"createdDateUtc"`
	UpdatedDate XeroTime `json:"updatedDateUtc"`
}

// Custom time format for Xero API timestamps with high precision
type XeroTime time.Time

func (xt *XeroTime) UnmarshalJSON(b []byte) error {
	s := string(b)
	if s == "null" {
		return nil
	}
	s = s[1 : len(s)-1] // Remove quotes

	// Handle escaped slashes in Microsoft JSON date format: \/Date(1234567890+0000)\/
	s = strings.ReplaceAll(s, `\/`, `/`)

	// Handle Microsoft JSON date format: /Date(1234567890+0000)/
	if strings.HasPrefix(s, "/Date(") && strings.HasSuffix(s, ")/") {
		msStr := s[6 : len(s)-2]
		// Parse milliseconds
		var ms int64
		if dotIdx := strings.Index(msStr, "+"); dotIdx != -1 {
			ms, _ = strconv.ParseInt(msStr[:dotIdx], 10, 64)
		} else if dotIdx := strings.Index(msStr, "-"); dotIdx != -1 {
			ms, _ = strconv.ParseInt(msStr[:dotIdx], 10, 64)
		} else {
			ms, _ = strconv.ParseInt(msStr, 10, 64)
		}
		*xt = XeroTime(time.Unix(ms/1000, (ms%1000)*1000000))
		return nil
	}

	formats := []string{
		"2006-01-02T15:04:05.9999999",
		"2006-01-02T15:04:05.999999",
		"2006-01-02T15:04:05.99999",
		"2006-01-02T15:04:05.9999",
		"2006-01-02T15:04:05.999",
		"2006-01-02T15:04:05.99",
		"2006-01-02T15:04:05.9",
		"2006-01-02T15:04:05",
		"2006-01-02T15:04:05Z07:00",
		"2006-01-02T15:04:05.9999999Z07:00",
		"2006-01-02T15:04:05Z",
		"2006-01-02T15:04:05.9999999Z",
	}

	for _, format := range formats {
		if t, err := time.Parse(format, s); err == nil {
			*xt = XeroTime(t)
			return nil
		}
	}

	return fmt.Errorf("unable to parse time: %s", s)
}

func (xt XeroTime) MarshalJSON() ([]byte, error) {
	t := time.Time(xt)
	if t.IsZero() {
		return []byte("null"), nil
	}
	return []byte(`"` + t.Format(time.RFC3339) + `"`), nil
}

// Invoice represents a Xero invoice
type Invoice struct {
	InvoiceID       string     `json:"InvoiceID"`
	InvoiceNumber   string     `json:"InvoiceNumber"`
	Contact         Contact    `json:"Contact"`
	Type            string     `json:"Type"`
	Status          string     `json:"Status"`
	LineAmountTypes string     `json:"LineAmountTypes"`
	Date            XeroTime   `json:"Date"`
	DueDate         XeroTime   `json:"DueDate"`
	LineItems       []LineItem `json:"LineItems"`
	SubTotal        float64    `json:"SubTotal"`
	TotalTax        float64    `json:"TotalTax"`
	Total           float64    `json:"Total"`
	CurrencyCode    string     `json:"CurrencyCode"`
	AmountDue       float64    `json:"AmountDue"`
	AmountPaid      float64    `json:"AmountPaid"`
	AmountCredited  float64    `json:"AmountCredited"`
	CreatedDateUTC  XeroTime   `json:"CreatedDateUTC"`
	UpdatedDateUTC  XeroTime   `json:"UpdatedDateUTC"`
}

// CreditNote represents a Xero credit note
type CreditNote struct {
	CreditNoteID     string     `json:"CreditNoteID"`
	CreditNoteNumber string     `json:"CreditNoteNumber"`
	Contact          Contact    `json:"Contact"`
	Type             string     `json:"Type"`
	Status           string     `json:"Status"`
	LineAmountTypes  string     `json:"LineAmountTypes"`
	Date             XeroTime   `json:"Date"`
	LineItems        []LineItem `json:"LineItems"`
	SubTotal         float64    `json:"SubTotal"`
	TotalTax         float64    `json:"TotalTax"`
	Total            float64    `json:"Total"`
	CurrencyCode     string     `json:"CurrencyCode"`
	AmountDue        float64    `json:"AmountDue"`
	AmountCredited   float64    `json:"AmountCredited"`
	RemainingCredit  float64    `json:"RemainingCredit"`
	CreatedDateUTC   XeroTime   `json:"CreatedDateUTC"`
	UpdatedDateUTC   XeroTime   `json:"UpdatedDateUTC"`
}

// LineItem represents an invoice line item
type LineItem struct {
	LineItemID  string  `json:"LineItemID"`
	Description string  `json:"Description"`
	Quantity    float64 `json:"Quantity"`
	UnitAmount  float64 `json:"UnitAmount"`
	AccountCode string  `json:"AccountCode"`
	LineAmount  float64 `json:"LineAmount"`
}

// Contact represents a Xero contact
type Contact struct {
	ContactID      string       `json:"ContactID"`
	Name           string       `json:"Name"`
	EmailAddress   string       `json:"EmailAddress"`
	FirstName      string       `json:"FirstName"`
	LastName       string       `json:"LastName"`
	Addresses      []Address    `json:"Addresses"`
	Phones         []Phone      `json:"Phones"`
	IsCustomer     bool         `json:"IsCustomer"`
	IsSupplier     bool         `json:"IsSupplier"`
	PaymentTerms   PaymentTerms `json:"PaymentTerms"`
	CreatedDateUTC XeroTime     `json:"CreatedDateUTC"`
	UpdatedDateUTC XeroTime     `json:"UpdatedDateUTC"`
}

// Address represents a contact address
type Address struct {
	AddressType  string `json:"AddressType"`
	AddressLine1 string `json:"AddressLine1"`
	AddressLine2 string `json:"AddressLine2"`
	City         string `json:"City"`
	Region       string `json:"Region"`
	PostalCode   string `json:"PostalCode"`
	Country      string `json:"Country"`
}

// Phone represents a contact phone number
type Phone struct {
	PhoneType        string `json:"PhoneType"`
	PhoneNumber      string `json:"PhoneNumber"`
	PhoneAreaCode    string `json:"PhoneAreaCode"`
	PhoneCountryCode string `json:"PhoneCountryCode"`
}

// PaymentTerms represents payment terms for a contact
type PaymentTerms struct {
	Bills TermDetail `json:"Bills"`
	Sales TermDetail `json:"Sales"`
}

// TermDetail represents payment term details
type TermDetail struct {
	Day  int    `json:"Day"`
	Type string `json:"Type"`
}

// Payment represents a Xero payment
type Payment struct {
	PaymentID      string   `json:"PaymentID"`
	Invoice        Invoice  `json:"Invoice"`
	Amount         float64  `json:"Amount"`
	Date           XeroTime `json:"Date"`
	Reference      string   `json:"Reference"`
	IsReconciled   bool     `json:"IsReconciled"`
	Account        Account  `json:"Account"`
	CreatedDateUTC XeroTime `json:"CreatedDateUTC"`
	UpdatedDateUTC XeroTime `json:"UpdatedDateUTC"`
}

// Account represents a Xero account (chart of accounts)
type Account struct {
	AccountID               string   `json:"AccountID"`
	Code                    string   `json:"Code"`
	Name                    string   `json:"Name"`
	Type                    string   `json:"Type"`
	Class                   string   `json:"Class"`
	Status                  string   `json:"Status"`
	Description             string   `json:"Description"`
	BankAccountNumber       string   `json:"BankAccountNumber"`
	CurrencyCode            string   `json:"CurrencyCode"`
	TaxType                 string   `json:"TaxType"`
	EnablePaymentsToAccount bool     `json:"EnablePaymentsToAccount"`
	ShowInExpenseClaims     bool     `json:"ShowInExpenseClaims"`
	Balance                 float64  `json:"Balance"`
	CreatedDateUTC          XeroTime `json:"CreatedDateUTC"`
	UpdatedDateUTC          XeroTime `json:"UpdatedDateUTC"`
}

// APIError represents an Xero API error
type APIError struct {
	Type       string                 `json:"Type"`
	Title      string                 `json:"Title"`
	Status     int                    `json:"Status"`
	Detail     string                 `json:"Detail"`
	Instance   string                 `json:"Instance"`
	Extensions map[string]interface{} `json:"Extensions"`
}

func (e *APIError) Error() string {
	return fmt.Sprintf("%s (%d): %s", e.Title, e.Status, e.Detail)
}

// IsTokenExpired checks if this is a token expiration error
func (e *APIError) IsTokenExpired() bool {
	if e.Extensions == nil {
		return false
	}
	problem, ok := e.Extensions["oauth_problem"].(string)
	return ok && problem == "token_expired"
}

// LoadFromJSON loads an object from JSON file
func LoadFromJSON(filePath string, target interface{}) error {
	data, err := os.ReadFile(filePath)
	if err != nil {
		return err
	}
	return json.Unmarshal(data, target)
}

// SaveToJSON saves an object to JSON file
func SaveToJSON(filePath string, data interface{}) error {
	jsonData, err := json.MarshalIndent(data, "", "  ")
	if err != nil {
		return err
	}
	return os.WriteFile(filePath, jsonData, 0600)
}