form3api.go

package form3api

import (
	"context"
	"fmt"
	"net/http"
	"strconv"
)

// Client communicates with Fake Form 3 Account API
type Client struct {
	baseURL string
	client  HTTPClient
}

// NewClient creates a new Fake Form 3 Account API client.
//
// If httpClient is nil, then built-in http client will be used.
func NewClient(httpClient HTTPClient, baseURL string) *Client {
	if httpClient == nil {
		httpClient = &http.Client{}
	}

	return &Client{
		client:  httpClient,
		baseURL: baseURL,
	}
}

// CreateAccount creates an account.
//
// Form 3 API docs: https://api-docs.form3.tech/api.html?shell#organisation-accounts-create
func (c *Client) CreateAccount(ctx context.Context, r CreateAccount) (*Account, error) {
	var acc *Account
	err := NewRequest().
		WithClient(c.client).
		WithBaseURL(c.baseURL+"/organisation/accounts").
		WithMethod(http.MethodPost).
		Exec(ctx, r, &acc)
	if err != nil {
		return nil, err
	}
	return acc, nil
}

// CreateAccount creates an account.
//
// Form 3 API docs: https://api-docs.form3.tech/api.html?shell#organisation-accounts-fetch
func (c *Client) FetchAccount(ctx context.Context, r FetchAccount) (*Account, error) {
	var acc *Account
	err := NewRequest().
		WithClient(c.client).
		WithBaseURL(c.baseURL+"/organisation/accounts/"+r.AccountID).
		Exec(ctx, nil, &acc)
	if err != nil {
		return nil, err
	}
	return acc, nil
}

// DeleteAccount deletes an account.
//
// Form 3 API docs: https://api-docs.form3.tech/api.html?shell#organisation-accounts-delete
func (c *Client) DeleteAccount(ctx context.Context, r DeleteAccount) error {
	err := NewRequest().
		WithClient(c.client).
		WithMethod(http.MethodDelete).
		WithBaseURL(c.baseURL+"/organisation/accounts/"+r.AccountID+"?version="+strconv.Itoa(int(r.Version))).
		Exec(ctx, nil, nil)
	return err
}

// CreateAccount creates an account.
//
// Form 3 API docs: https://api-docs.form3.tech/api.html?shell#organisation-accounts-list
func (c *Client) ListAccounts(ctx context.Context, r ListAccounts) (*Accounts, error) {
	const defaultPageSize = 100
	if r.Page.Size == 0 {
		r.Page.Size = defaultPageSize
	}

	url := fmt.Sprintf("%s/organisation/accounts?page[number]=%d&page[size]=%d",
		c.baseURL, r.Page.Number, r.Page.Size)

	res := &Accounts{
		AccountData: make([]AccountData, r.Page.Size),
	}

	err := NewRequest().
		WithClient(c.client).
		WithBaseURL(url).
		Exec(ctx, nil, &res)
	if err != nil {
		return nil, err
	}
	return res, nil
}