mesh-controller/internal/inventory/chain.go

package inventory

import (
	"context"
	"errors"
	"fmt"
	"sync"

	"github.com/jackc/pgx/v5"
	"github.com/jackc/pgx/v5/pgconn"

	"github.com/novox/mesh-controller/internal/chain"
)

// **The chain moves to the bus kind by kind** (novox/hq ADR 0408 §8, issue 981). The tables of builds, rollouts and
// assignments are copied once into the chain's buckets by the serving controller at its start (MoveChain), which then
// records each kind it moved in chain_moved (migration 0104). **Until a kind is recorded there nothing reads its bucket;
// once it is, nothing reads its tables**: ChainReads answers which, and every method of a kind asks it first.

// The kinds of the chain, as chain_moved names them.
const (
	KindBuilds = "builds"
)

// ErrNoChain is a kind moved to the bus read by an inventory that has no chain attached: a process that did not
// open the bus. Refused loudly, never answered from the tables the move left behind.
var ErrNoChain = errors.New("this kind of record lives on the bus, and this process has not opened the bus")

// movedKinds is which kinds this process has read as moved: once moved, always moved, so it is read from the store
// until it is true and not after.
type movedKinds struct {
	mu   sync.Mutex
	kind map[string]bool
	open ChainOpener
}

// ChainOpener opens the chain on the bus when a process first needs it: a command that reads and never moved anything has
// no bus connection until a kind it reads turns out to be moved.
type ChainOpener func(ctx context.Context) (*chain.Chain, error)

// UseChainOpener gives the inventory the means to open the chain when it needs it and none is attached.
func (i *Inventory) UseChainOpener(open ChainOpener) {
	i.moved.mu.Lock()
	i.moved.open = open
	i.moved.mu.Unlock()
}

// UseChain attaches the chain the moved kinds are read and written through. The serving controller attaches the bus's,
// holding the lease for its writes; a test attaches one in memory.
func (i *Inventory) UseChain(c *chain.Chain) {
	i.moved.mu.Lock()
	defer i.moved.mu.Unlock()
	i.chain = c
}

// attached is the chain this inventory has, nil when none.
func (i *Inventory) attached() *chain.Chain {
	i.moved.mu.Lock()
	defer i.moved.mu.Unlock()
	return i.chain
}

// ChainReads says whether a kind of the chain is read from its bucket: chain_moved names it. It answers the chain to read
// through, and ErrNoChain when the kind is moved and none is attached.
func (i *Inventory) ChainReads(ctx context.Context, kind string) (*chain.Chain, bool, error) {
	i.moved.mu.Lock()
	known := i.moved.kind[kind]
	i.moved.mu.Unlock()
	if !known {
		var moved bool
		err := i.store.Pool().QueryRow(ctx, `select counts ? $1 from chain_moved`, kind).Scan(&moved)
		var pgErr *pgconn.PgError
		if errors.Is(err, pgx.ErrNoRows) || (errors.As(err, &pgErr) && pgErr.Code == "42P01") {
			// No row, or a store older than the migration that makes the table: nothing moved.
			return nil, false, nil
		}
		if err != nil {
			return nil, false, fmt.Errorf("whether %s moved to the bus cannot be read: %w", kind, err)
		}
		if !moved {
			return nil, false, nil
		}
		i.moved.mu.Lock()
		if i.moved.kind == nil {
			i.moved.kind = map[string]bool{}
		}
		i.moved.kind[kind] = true
		i.moved.mu.Unlock()
	}
	i.moved.mu.Lock()
	defer i.moved.mu.Unlock()
	if i.chain == nil && i.moved.open != nil {
		c, err := i.moved.open(ctx)
		if err != nil {
			return nil, false, fmt.Errorf("%w: %s: %v", ErrNoChain, kind, err)
		}
		i.chain = c
	}
	if i.chain == nil {
		return nil, false, fmt.Errorf("%w: %s", ErrNoChain, kind)
	}
	return i.chain, true, nil
}

// ChainMoved is, per kind moved, how many records the move wrote; empty before any is.
func (i *Inventory) ChainMoved(ctx context.Context) (map[string]int, error) {
	var counts map[string]int
	err := i.store.Pool().QueryRow(ctx, `select counts from chain_moved`).Scan(&counts)
	if errors.Is(err, pgx.ErrNoRows) {
		return map[string]int{}, nil
	}
	return counts, err
}