peroxide/pkg/pmapi/client.go

// Copyright (c) 2022 Proton Technologies AG
//
// This file is part of ProtonMail Bridge.
//
// ProtonMail Bridge is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// ProtonMail Bridge is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with ProtonMail Bridge.  If not, see <https://www.gnu.org/licenses/>.

package pmapi

import (
	"context"
	"net/http"
	"sync"
	"time"

	"github.com/ProtonMail/gopenpgp/v2/crypto"
	"github.com/go-resty/resty/v2"
)

// client is a client of the protonmail API. It implements the Client interface.
type client struct {
	manager clientManager

	uid, acc, ref string
	authHandlers  []AuthRefreshHandler
	authLocker    sync.RWMutex

	user        *User
	addresses   AddressList
	userKeyRing *crypto.KeyRing
	addrKeyRing map[string]*crypto.KeyRing
	keyRingLock sync.Locker

	exp time.Time
}

func newClient(manager clientManager, uid string) *client {
	return &client{
		manager:     manager,
		uid:         uid,
		addrKeyRing: make(map[string]*crypto.KeyRing),
		keyRingLock: &sync.RWMutex{},
	}
}

func (c *client) withAuth(acc, ref string, exp time.Time) *client {
	c.acc = acc
	c.ref = ref
	c.exp = exp

	return c
}

func (c *client) r(ctx context.Context) (*resty.Request, error) {
	r := c.manager.r(ctx)

	if c.uid != "" {
		r.SetHeader("x-pm-uid", c.uid)
	}

	if time.Now().After(c.exp) {
		if err := c.authRefresh(ctx); err != nil {
			return nil, err
		}
	}

	c.authLocker.RLock()
	defer c.authLocker.RUnlock()

	if c.acc != "" {
		r.SetAuthToken(c.acc)
	}

	return r, nil
}

// do executes fn and may repeat execution in case of retry after "401 Unauthorized" error.
// Note: fn may be called more than once.
func (c *client) do(ctx context.Context, fn func(*resty.Request) (*resty.Response, error)) (*resty.Response, error) {
	r, err := c.r(ctx)
	if err != nil {
		return nil, err
	}

	res, err := wrapNoConnection(fn(r))
	if err != nil {
		if res.StatusCode() != http.StatusUnauthorized {
			// Return also response so caller has more options to decide what to do.
			return res, err
		}

		if !isAuthRefreshDisabled(ctx) {
			if err := c.authRefresh(ctx); err != nil {
				return nil, err
			}

			// We need to reconstruct request since access token is changed with authRefresh.
			r, err := c.r(ctx)
			if err != nil {
				return nil, err
			}

			return wrapNoConnection(fn(r))
		}

		return res, err
	}

	return res, nil
}