starling

type Account struct {
	ID                AccountID  `json:"accountUid"`
	Type              string     `json:"accountType"`
	DefaultCategoryID CategoryID `json:"defaultCategory"`
	Currency          string     `json:"currency"`
	CreatedAt         time.Time  `json:"createdAt"`
	Name              string     `json:"name"`
}

type AccountID uuid.UUID

type CategoryID uuid.UUID

type Client interface {
	FetchTransactionsSince(ctx context.Context, opts FetchTransactionOptions) ([]*FeedItem, error)
	FetchFeedItem(ctx context.Context, accountID AccountID, categoryID CategoryID, feedItemID FeedItemID) (*FeedItem, error)
	FetchAccounts(ctx context.Context) ([]*Account, error)
	FetchSavingsGoals(ctx context.Context, accountID AccountID) ([]*SavingsGoal, error)
}

type CounterPartyID uuid.UUID

type Direction string

type Error struct {
	HTTPStatus    int
	Code          string         `json:"error"`
	Message       string         `json:"error_description"`
	Success       bool           `json:"success"`
	ErrorMessages []ErrorMessage `json:"errors"`
}

type ErrorMessage struct {
	Message string `json:"message"`
}

type FeedItem struct {
	ID                      FeedItemID     `json:"feedItemUid"`
	Amount                  domain.Money   `json:"amount"` // Amount in the account's currency
	TransactedAt            time.Time      `json:"transactionTime"`
	SettledAt               *time.Time     `json:"settlementTime"`
	CategoryID              CategoryID     `json:"categoryUid"`
	CategoryName            string         `json:"spendingCategory"`
	Description             string         `json:"reference"`
	Status                  Status         `json:"status"`
	UserNote                string         `json:"userNote"`
	Direction               Direction      `json:"direction"`        // Direction of payment, e.g. IN or OUT
	Source                  string         `json:"source"`           // e.g. MASTED_CARD
	SourceSubType           string         `json:"sourceSubType"`    // e.g. Online, ATM, Deposit
	CounterPartyType        string         `json:"counterPartyType"` // e.g. STARLING, MERCHANT
	CounterPartyID          CounterPartyID `json:"counterPartyUid"`
	CounterPartySubEntityID string         `json:"counterPartySubEntityUid"`
	CounterPartyName        string         `json:"counterPartyName"`
	RoundUp                 *RoundUp       `json:"roundUp"`
}

type FeedItemID uuid.UUID

type FetchTransactionOptions struct {
	AccountID  AccountID
	CategoryID CategoryID
	Start      time.Time
	End        time.Time
}

type Option func(*client)

type RoundUp struct {
	GoalCategoryID CategoryID   `json:"goalCategoryUid"`
	Amount         domain.Money `json:"amount"`
}

type SavingsGoal struct {
	ID         SavingsGoalID `json:"savingsGoalUid"`
	Name       string        `json:"name"`
	State      string        `json:"state"`
	Target     domain.Money  `json:"target"`
	TotalSaved domain.Money  `json:"totalSaved"`
}

type SavingsGoalID uuid.UUID

type Status string