helm-external-secrets/providers/v1/onepassword/onepassword.go

/*
Copyright © The ESO Authors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

// Package onepassword implements a 1Password provider for External Secrets.
package onepassword

import (
	"context"
	"errors"
	"fmt"
	"net/url"
	"regexp"
	"slices"
	"sort"
	"strings"
	"sync"
	"time"

	"github.com/1Password/connect-sdk-go/connect"
	"github.com/1Password/connect-sdk-go/onepassword"
	corev1 "k8s.io/api/core/v1"
	kclient "sigs.k8s.io/controller-runtime/pkg/client"
	"sigs.k8s.io/controller-runtime/pkg/webhook/admission"

	esv1 "github.com/external-secrets/external-secrets/apis/externalsecrets/v1"
	"github.com/external-secrets/external-secrets/runtime/esutils"
	"github.com/external-secrets/external-secrets/runtime/esutils/metadata"
	"github.com/external-secrets/external-secrets/runtime/esutils/resolvers"
	"github.com/external-secrets/external-secrets/runtime/find"
)

const (
	userAgent = "external-secrets"

	errOnePasswordStore                           = "received invalid 1Password SecretStore resource: %w"
	errOnePasswordStoreNilSpec                    = "nil spec"
	errOnePasswordStoreNilSpecProvider            = "nil spec.provider"
	errOnePasswordStoreNilSpecProviderOnePassword = "nil spec.provider.onepassword"
	errOnePasswordStoreMissingRefName             = "missing: spec.provider.onepassword.auth.secretRef.connectTokenSecretRef.name"
	errOnePasswordStoreMissingRefKey              = "missing: spec.provider.onepassword.auth.secretRef.connectTokenSecretRef.key"
	errOnePasswordStoreAtLeastOneVault            = "must be at least one vault: spec.provider.onepassword.vaults"
	errOnePasswordStoreInvalidConnectHost         = "unable to parse URL: spec.provider.onepassword.connectHost: %w"
	errOnePasswordStoreNonUniqueVaultNumbers      = "vault order numbers must be unique"
	errGetVault                                   = "error finding 1Password Vault: %w"

	errGetItem               = "error finding 1Password Item: %w"
	errUpdateItem            = "error updating 1Password Item: %w"
	errDocumentNotFound      = "error finding 1Password Document: %w"
	errTagsNotImplemented    = "'find.tags' is not implemented in the 1Password provider"
	errVersionNotImplemented = "'remoteRef.version' is not implemented in the 1Password provider"
	errCreateItem            = "error creating 1Password Item: %w"
	errDeleteItem            = "error deleting 1Password Item: %w"
	// custom error messages.
	errKeyNotFoundMsg             = "key not found in 1Password Vaults"
	errNoVaultsMsg                = "no vaults found"
	errMetadataVaultNotinProvider = "metadata vault '%s' not in provider vaults"
	errExpectedOneItemMsg         = "expected one 1Password Item matching"
	errExpectedOneFieldMsg        = "expected one 1Password ItemField matching"
	errExpectedOneFieldMsgF       = "%w: '%s' in '%s', got %d"

	documentCategory = "DOCUMENT"
	fieldPrefix      = "field"
	filePrefix       = "file"
	prefixSplitter   = "/"
)

// Custom Errors //.
var (
	// ErrKeyNotFound is returned when a key is not found in the 1Password Vaults.
	ErrKeyNotFound = errors.New(errKeyNotFoundMsg)
	// ErrNoVaults is returned when no vaults are found in the 1Password provider.
	ErrNoVaults = errors.New(errNoVaultsMsg)
	// ErrExpectedOneField is returned when more than 1 field is found in the 1Password Vaults.
	ErrExpectedOneField = errors.New(errExpectedOneFieldMsg)
	// ErrExpectedOneItem is returned when more than 1 item is found in the 1Password Vaults.
	ErrExpectedOneItem = errors.New(errExpectedOneItemMsg)
)

// ProviderOnePassword is a provider for 1Password.
type ProviderOnePassword struct {
	vaults map[string]int
	client connect.Client
	mu     sync.Mutex
}

// PushSecretMetadataSpec defines metadata for pushing secrets to 1Password.
type PushSecretMetadataSpec struct {
	Tags  []string `json:"tags,omitempty"`
	Vault string   `json:"vault,omitempty"`
}

// https://github.com/external-secrets/external-secrets/issues/644
var (
	_ esv1.SecretsClient = &ProviderOnePassword{}
	_ esv1.Provider      = &ProviderOnePassword{}
)

// Capabilities return the provider supported capabilities (ReadOnly, WriteOnly, ReadWrite).
func (provider *ProviderOnePassword) Capabilities() esv1.SecretStoreCapabilities {
	return esv1.SecretStoreReadWrite
}

// NewClient constructs a 1Password Provider.
func (provider *ProviderOnePassword) NewClient(ctx context.Context, store esv1.GenericStore, kube kclient.Client, namespace string) (esv1.SecretsClient, error) {
	config := store.GetSpec().Provider.OnePassword
	token, err := resolvers.SecretKeyRef(
		ctx,
		kube,
		store.GetKind(),
		namespace,
		&config.Auth.SecretRef.ConnectToken,
	)
	if err != nil {
		return nil, err
	}
	return &ProviderOnePassword{
		client: newRetryClient(connect.NewClientWithUserAgent(config.ConnectHost, token, userAgent)),
		vaults: config.Vaults,
	}, nil
}

// ValidateStore checks if the provided store is valid.
func (provider *ProviderOnePassword) ValidateStore(store esv1.GenericStore) (admission.Warnings, error) {
	return nil, validateStore(store)
}

func validateStore(store esv1.GenericStore) error {
	// check nils
	storeSpec := store.GetSpec()
	if storeSpec == nil {
		return fmt.Errorf(errOnePasswordStore, errors.New(errOnePasswordStoreNilSpec))
	}
	if storeSpec.Provider == nil {
		return fmt.Errorf(errOnePasswordStore, errors.New(errOnePasswordStoreNilSpecProvider))
	}
	if storeSpec.Provider.OnePassword == nil {
		return fmt.Errorf(errOnePasswordStore, errors.New(errOnePasswordStoreNilSpecProviderOnePassword))
	}

	// check mandatory fields
	config := storeSpec.Provider.OnePassword
	if config.Auth.SecretRef.ConnectToken.Name == "" {
		return fmt.Errorf(errOnePasswordStore, errors.New(errOnePasswordStoreMissingRefName))
	}
	if config.Auth.SecretRef.ConnectToken.Key == "" {
		return fmt.Errorf(errOnePasswordStore, errors.New(errOnePasswordStoreMissingRefKey))
	}

	// check namespace compared to kind
	if err := esutils.ValidateSecretSelector(store, config.Auth.SecretRef.ConnectToken); err != nil {
		return fmt.Errorf(errOnePasswordStore, err)
	}

	// check at least one vault
	if len(config.Vaults) == 0 {
		return fmt.Errorf(errOnePasswordStore, errors.New(errOnePasswordStoreAtLeastOneVault))
	}

	// ensure vault numbers are unique
	if !hasUniqueVaultNumbers(config.Vaults) {
		return fmt.Errorf(errOnePasswordStore, errors.New(errOnePasswordStoreNonUniqueVaultNumbers))
	}

	// check valid URL
	if _, err := url.Parse(config.ConnectHost); err != nil {
		return fmt.Errorf(errOnePasswordStore, fmt.Errorf(errOnePasswordStoreInvalidConnectHost, err))
	}

	return nil
}

func deleteField(fields []*onepassword.ItemField, label string) ([]*onepassword.ItemField, error) {
	// This will always iterate over all items
	// but its done to ensure that two fields with the same label
	// exist resulting in undefined behavior
	var (
		found   bool
		fieldsF = make([]*onepassword.ItemField, 0, len(fields))
	)
	for _, item := range fields {
		if item.Label == label {
			if found {
				return nil, ErrExpectedOneField
			}
			found = true
			continue
		}
		fieldsF = append(fieldsF, item)
	}
	return fieldsF, nil
}

// DeleteSecret removes a secret from 1Password.
func (provider *ProviderOnePassword) DeleteSecret(_ context.Context, ref esv1.PushSecretRemoteRef) error {
	provider.mu.Lock()
	defer provider.mu.Unlock()
	providerItem, err := provider.findItem(ref.GetRemoteKey())
	if err != nil {
		if errors.Is(err, ErrKeyNotFound) {
			return nil
		}

		return err
	}

	providerItem.Fields, err = deleteField(providerItem.Fields, ref.GetProperty())
	if err != nil {
		return fmt.Errorf(errUpdateItem, err)
	}

	if len(providerItem.Sections) == 1 && providerItem.Sections[0].ID == "" && providerItem.Sections[0].Label == "" {
		providerItem.Sections = nil
	}

	if len(providerItem.Fields) == 0 && len(providerItem.Files) == 0 && len(providerItem.Sections) == 0 {
		// Delete the item if there are no fields, files or sections
		if err = provider.client.DeleteItem(providerItem, providerItem.Vault.ID); err != nil {
			return fmt.Errorf(errDeleteItem, err)
		}
		return nil
	}

	if _, err = provider.client.UpdateItem(providerItem, providerItem.Vault.ID); err != nil {
		return fmt.Errorf(errDeleteItem, err)
	}
	return nil
}

// SecretExists checks if a secret exists in 1Password.
func (provider *ProviderOnePassword) SecretExists(_ context.Context, ref esv1.PushSecretRemoteRef) (bool, error) {
	provider.mu.Lock()
	defer provider.mu.Unlock()

	item, err := provider.findItem(ref.GetRemoteKey())
	if errors.Is(err, ErrKeyNotFound) {
		return false, nil
	}
	if err != nil {
		return false, err
	}

	property := ref.GetProperty()
	if property == "" {
		return true, nil
	}

	for _, field := range item.Fields {
		if field.Label == property {
			return true, nil
		}
	}

	return false, nil
}

const (
	passwordLabel = "password"
)

// createItem creates a new item in the first vault. If no vaults exist, it returns an error.
func (provider *ProviderOnePassword) createItem(val []byte, ref esv1.PushSecretData) error {
	// Get the metadata
	metadata, err := metadata.ParseMetadataParameters[PushSecretMetadataSpec](ref.GetMetadata())
	if err != nil {
		return fmt.Errorf("failed to parse push secret metadata: %w", err)
	}

	// Check if there is a vault is specified in the metadata
	vaultID := ""
	if metadata != nil && metadata.Spec.Vault != "" {
		// check if metadata.Spec.Vault is in provider.vaults
		if _, ok := provider.vaults[metadata.Spec.Vault]; !ok {
			return fmt.Errorf(errMetadataVaultNotinProvider, metadata.Spec.Vault)
		}
		vaultID = metadata.Spec.Vault
	} else {
		// Get the first vault from the provider
		sortedVaults := sortVaults(provider.vaults)
		if len(sortedVaults) == 0 {
			return ErrNoVaults
		}
		vaultID = sortedVaults[0]
	}

	// Get the label
	label := ref.GetProperty()
	if label == "" {
		label = passwordLabel
	}

	var tags []string
	if metadata != nil && metadata.Spec.Tags != nil {
		tags = metadata.Spec.Tags
	}

	// Create the item
	item := &onepassword.Item{
		Title:    ref.GetRemoteKey(),
		Category: onepassword.Server,
		Vault: onepassword.ItemVault{
			ID: vaultID,
		},
		Fields: []*onepassword.ItemField{
			generateNewItemField(label, string(val)),
		},
		Tags: tags,
	}

	_, err = provider.client.CreateItem(item, vaultID)
	return err
}

// updateFieldValue updates the fields value of an item with the given label.
// If the label does not exist, a new field is created. If the label exists but
// the value is different, the value is updated. If the label exists and the
// value is the same, nothing is done.
func updateFieldValue(fields []*onepassword.ItemField, label, newVal string) ([]*onepassword.ItemField, error) {
	// This will always iterate over all items.
	// This is done to ensure that two fields with the same label
	// exist resulting in undefined behavior.
	var (
		found bool
		index int
	)
	for i, item := range fields {
		if item.Label == label {
			if found {
				return nil, ErrExpectedOneField
			}
			found = true
			index = i
		}
	}
	if !found {
		return append(fields, generateNewItemField(label, newVal)), nil
	}

	if fields[index].Value != newVal {
		fields[index].Value = newVal
	}

	return fields, nil
}

// generateNewItemField generates a new item field with the given label and value.
func generateNewItemField(label, newVal string) *onepassword.ItemField {
	field := &onepassword.ItemField{
		Label: label,
		Value: newVal,
		Type:  onepassword.FieldTypeConcealed,
	}

	return field
}

// PushSecret creates or updates a secret in 1Password.
func (provider *ProviderOnePassword) PushSecret(ctx context.Context, secret *corev1.Secret, ref esv1.PushSecretData) error {
	provider.mu.Lock()
	defer provider.mu.Unlock()
	val, ok := secret.Data[ref.GetSecretKey()]
	if !ok {
		return ErrKeyNotFound
	}

	title := ref.GetRemoteKey()
	providerItem, err := provider.findItem(title)
	if errors.Is(err, ErrKeyNotFound) {
		if err = provider.createItem(val, ref); err != nil {
			return fmt.Errorf(errCreateItem, err)
		}

		err = provider.waitForFunc(ctx, provider.waitForItemToExist(title))
		return err
	} else if err != nil {
		return err
	}

	label := ref.GetProperty()
	if label == "" {
		label = passwordLabel
	}

	metadata, err := metadata.ParseMetadataParameters[PushSecretMetadataSpec](ref.GetMetadata())
	if err != nil {
		return fmt.Errorf("failed to parse push secret metadata: %w", err)
	}
	if metadata != nil && metadata.Spec.Tags != nil {
		providerItem.Tags = metadata.Spec.Tags
	}

	providerItem.Fields, err = updateFieldValue(providerItem.Fields, label, string(val))
	if err != nil {
		return fmt.Errorf(errUpdateItem, err)
	}

	if _, err = provider.client.UpdateItem(providerItem, providerItem.Vault.ID); err != nil {
		return fmt.Errorf(errUpdateItem, err)
	}

	if err := provider.waitForFunc(ctx, provider.waitForLabelToBeUpdated(title, label, val)); err != nil {
		return fmt.Errorf("failed waiting for label update: %w", err)
	}

	return nil
}

// Clean property string by removing property prefix if needed.
func getObjType(documentType onepassword.ItemCategory, property string) (string, string) {
	if strings.HasPrefix(property, fieldPrefix+prefixSplitter) {
		return fieldPrefix, property[6:]
	}
	if strings.HasPrefix(property, filePrefix+prefixSplitter) {
		return filePrefix, property[5:]
	}

	if documentType == documentCategory {
		return filePrefix, property
	}

	return fieldPrefix, property
}

// GetSecret returns a single secret from the provider.
func (provider *ProviderOnePassword) GetSecret(_ context.Context, ref esv1.ExternalSecretDataRemoteRef) ([]byte, error) {
	provider.mu.Lock()
	defer provider.mu.Unlock()
	if ref.Version != "" {
		return nil, errors.New(errVersionNotImplemented)
	}

	item, err := provider.findItem(ref.Key)
	if err != nil {
		return nil, err
	}

	propertyType, property := getObjType(item.Category, ref.Property)
	if propertyType == filePrefix {
		return provider.getFile(item, property)
	}
	return provider.getField(item, property)
}

// Validate checks if the client is configured correctly
// to be able to retrieve secrets from the provider.
func (provider *ProviderOnePassword) Validate() (esv1.ValidationResult, error) {
	provider.mu.Lock()
	defer provider.mu.Unlock()
	for vaultName := range provider.vaults {
		_, err := provider.client.GetVault(vaultName)
		if err != nil {
			return esv1.ValidationResultError, err
		}
	}

	return esv1.ValidationResultReady, nil
}

// GetSecretMap returns multiple k/v pairs from the provider, for dataFrom.extract.
func (provider *ProviderOnePassword) GetSecretMap(_ context.Context, ref esv1.ExternalSecretDataRemoteRef) (map[string][]byte, error) {
	provider.mu.Lock()
	defer provider.mu.Unlock()
	if ref.Version != "" {
		return nil, errors.New(errVersionNotImplemented)
	}

	item, err := provider.findItem(ref.Key)
	if err != nil {
		return nil, err
	}

	propertyType, property := getObjType(item.Category, ref.Property)
	if propertyType == filePrefix {
		return provider.getFiles(item, property)
	}
	return provider.getFields(item, property)
}

// GetAllSecrets syncs multiple 1Password Items into a single Kubernetes Secret, for dataFrom.find.
func (provider *ProviderOnePassword) GetAllSecrets(_ context.Context, ref esv1.ExternalSecretFind) (map[string][]byte, error) {
	provider.mu.Lock()
	defer provider.mu.Unlock()
	secretData := make(map[string][]byte)
	sortedVaults := sortVaults(provider.vaults)
	for _, vaultName := range sortedVaults {
		vault, err := provider.client.GetVault(vaultName)
		if err != nil {
			return nil, fmt.Errorf(errGetVault, err)
		}

		if ref.Tags != nil {
			err = provider.getAllByTags(vault.ID, ref, secretData)
			if err != nil {
				return nil, err
			}
			return secretData, nil
		}
		err = provider.getAllForVault(vault.ID, ref, secretData)
		if err != nil {
			return nil, err
		}
	}

	return secretData, nil
}

// Close closes the client connection.
func (provider *ProviderOnePassword) Close(_ context.Context) error {
	provider.mu.Lock()
	defer provider.mu.Unlock()
	return nil
}

// nativeItemIDPattern matches a 1Password item ID per the Connect
// server OpenAPI spec (^[\da-z]{26}$). Despite being called "UUIDs"
// in 1Password's SDK and docs, they are not RFC 4122 UUIDs.
// https://github.com/1Password/connect/blob/7485a59/docs/openapi/spec.yaml#L73-L75
var nativeItemIDPattern = regexp.MustCompile(`^[\da-z]{26}$`)

func isNativeItemID(s string) bool {
	return nativeItemIDPattern.MatchString(s)
}

func (provider *ProviderOnePassword) findItem(name string) (*onepassword.Item, error) {
	sortedVaults := sortVaults(provider.vaults)
	for _, vaultName := range sortedVaults {
		vault, err := provider.client.GetVault(vaultName)
		if err != nil {
			return nil, fmt.Errorf(errGetVault, err)
		}

		if isNativeItemID(name) {
			return provider.client.GetItem(name, vault.ID)
		}

		items, err := provider.client.GetItemsByTitle(name, vault.ID)
		if err != nil {
			return nil, fmt.Errorf(errGetItem, err)
		}
		switch {
		case len(items) == 1:
			return provider.client.GetItemByUUID(items[0].ID, items[0].Vault.ID)
		case len(items) > 1:
			return nil, fmt.Errorf("%w: '%s', got %d", ErrExpectedOneItem, name, len(items))
		}
	}

	return nil, fmt.Errorf("%w: %s in: %v", ErrKeyNotFound, name, provider.vaults)
}

func (provider *ProviderOnePassword) getField(item *onepassword.Item, property string) ([]byte, error) {
	// default to a field labeled "password"
	fieldLabel := "password"
	if property != "" {
		fieldLabel = property
	}

	if length := countFieldsWithLabel(fieldLabel, item.Fields); length != 1 {
		return nil, fmt.Errorf("%w: '%s' in '%s', got %d", ErrExpectedOneField, fieldLabel, item.Title, length)
	}

	// caution: do not use client.GetValue here because it has undesirable behavior on keys with a dot in them
	value := ""
	for _, field := range item.Fields {
		if field.Label == fieldLabel {
			value = field.Value
			break
		}
	}

	return []byte(value), nil
}

func (provider *ProviderOnePassword) getFields(item *onepassword.Item, property string) (map[string][]byte, error) {
	secretData := make(map[string][]byte)
	for _, field := range item.Fields {
		if property != "" && field.Label != property {
			continue
		}
		if length := countFieldsWithLabel(field.Label, item.Fields); length != 1 {
			return nil, fmt.Errorf(errExpectedOneFieldMsgF, ErrExpectedOneField, field.Label, item.Title, length)
		}

		// caution: do not use client.GetValue here because it has undesirable behavior on keys with a dot in them
		secretData[field.Label] = []byte(field.Value)
	}

	return secretData, nil
}

func (provider *ProviderOnePassword) getAllFields(item onepassword.Item, ref esv1.ExternalSecretFind, secretData map[string][]byte) error {
	i, err := provider.client.GetItemByUUID(item.ID, item.Vault.ID)
	if err != nil {
		return fmt.Errorf(errGetItem, err)
	}
	item = *i
	for _, field := range item.Fields {
		if length := countFieldsWithLabel(field.Label, item.Fields); length != 1 {
			return fmt.Errorf(errExpectedOneFieldMsgF, ErrExpectedOneField, field.Label, item.Title, length)
		}
		if ref.Name != nil {
			matcher, err := find.New(*ref.Name)
			if err != nil {
				return err
			}
			if !matcher.MatchName(field.Label) {
				continue
			}
		}
		if _, ok := secretData[field.Label]; !ok {
			secretData[field.Label] = []byte(field.Value)
		}
	}

	return nil
}

func (provider *ProviderOnePassword) getFile(item *onepassword.Item, property string) ([]byte, error) {
	for _, file := range item.Files {
		// default to the first file when ref.Property is empty
		if file.Name == property || property == "" {
			contents, err := provider.client.GetFileContent(file)
			if err != nil {
				return nil, err
			}

			return contents, nil
		}
	}

	return nil, fmt.Errorf(errDocumentNotFound, fmt.Errorf("'%s', '%s'", item.Title, property))
}

func (provider *ProviderOnePassword) getFiles(item *onepassword.Item, property string) (map[string][]byte, error) {
	secretData := make(map[string][]byte)
	for _, file := range item.Files {
		if property != "" && file.Name != property {
			continue
		}
		contents, err := provider.client.GetFileContent(file)
		if err != nil {
			return nil, err
		}
		secretData[file.Name] = contents
	}

	return secretData, nil
}

func (provider *ProviderOnePassword) getAllFiles(item onepassword.Item, ref esv1.ExternalSecretFind, secretData map[string][]byte) error {
	for _, file := range item.Files {
		if ref.Name != nil {
			matcher, err := find.New(*ref.Name)
			if err != nil {
				return err
			}
			if !matcher.MatchName(file.Name) {
				continue
			}
		}
		if _, ok := secretData[file.Name]; !ok {
			contents, err := provider.client.GetFileContent(file)
			if err != nil {
				return err
			}
			secretData[file.Name] = contents
		}
	}

	return nil
}

func (provider *ProviderOnePassword) getAllByTags(vaultID string, ref esv1.ExternalSecretFind, secretData map[string][]byte) error {
	items, err := provider.client.GetItems(vaultID)
	if err != nil {
		return fmt.Errorf(errGetItem, err)
	}
	for _, item := range items {
		if !checkTags(ref.Tags, item.Tags) {
			continue
		}
		// handle files
		err = provider.getAllFiles(item, ref, secretData)
		if err != nil {
			return err
		}
		// handle fields
		err = provider.getAllFields(item, ref, secretData)
		if err != nil {
			return err
		}
	}
	return nil
}

// checkTags verifies that all elements in source are present in target.
func checkTags(source map[string]string, target []string) bool {
	for s := range source {
		if !slices.Contains(target, s) {
			return false
		}
	}
	return true
}

func (provider *ProviderOnePassword) getAllForVault(vaultID string, ref esv1.ExternalSecretFind, secretData map[string][]byte) error {
	items, err := provider.client.GetItems(vaultID)
	if err != nil {
		return fmt.Errorf(errGetItem, err)
	}
	for _, item := range items {
		if ref.Path != nil && *ref.Path != item.Title {
			continue
		}

		// handle files
		err = provider.getAllFiles(item, ref, secretData)
		if err != nil {
			return err
		}

		// handle fields
		err = provider.getAllFields(item, ref, secretData)
		if err != nil {
			return err
		}
	}

	return nil
}

// waitForFunc will wait for OnePassword to _actually_ create/update the secret. OnePassword returns immediately after
// the initial create/update which makes the next call for the same item create/update a new item with the same name. Hence, we'll
// wait for the item to exist or be updated on OnePassword's side as well.
// Ideally we could do bulk operations and handle data with one submit, but that would require re-writing the entire
// push secret controller. For now, this is sufficient.
func (provider *ProviderOnePassword) waitForFunc(ctx context.Context, fn func() error) error {
	// check every .5 seconds
	tick := time.NewTicker(500 * time.Millisecond)
	defer tick.Stop()
	done, cancel := context.WithTimeout(ctx, 5*time.Second)
	defer cancel()

	var err error
	for {
		select {
		case <-tick.C:
			if err = fn(); err == nil {
				return nil
			}
		case <-done.Done():
			return fmt.Errorf("timeout to wait for function to run successfully; last error was: %w", err)
		}
	}
}

func (provider *ProviderOnePassword) waitForItemToExist(title string) func() error {
	return func() error {
		_, err := provider.findItem(title)

		return err
	}
}

func (provider *ProviderOnePassword) waitForLabelToBeUpdated(title, label string, val []byte) func() error {
	return func() error {
		item, err := provider.findItem(title)
		if err != nil {
			return err
		}

		for _, field := range item.Fields {
			// we found the label with the right value
			if field.Label == label && field.Value == string(val) {
				return nil
			}
		}

		return fmt.Errorf("label %s no found on value with title %s", title, label)
	}
}

func countFieldsWithLabel(fieldLabel string, fields []*onepassword.ItemField) int {
	count := 0
	for _, field := range fields {
		if field.Label == fieldLabel {
			count++
		}
	}

	return count
}

type orderedVault struct {
	Name  string
	Order int
}

type orderedVaultList []orderedVault

func (list orderedVaultList) Len() int           { return len(list) }
func (list orderedVaultList) Swap(i, j int)      { list[i], list[j] = list[j], list[i] }
func (list orderedVaultList) Less(i, j int) bool { return list[i].Order < list[j].Order }

func sortVaults(vaults map[string]int) []string {
	list := make(orderedVaultList, len(vaults))
	index := 0
	for key, value := range vaults {
		list[index] = orderedVault{key, value}
		index++
	}
	sort.Sort(list)
	sortedVaults := make([]string, 0, len(list))
	for _, item := range list {
		sortedVaults = append(sortedVaults, item.Name)
	}

	return sortedVaults
}

func hasUniqueVaultNumbers(vaults map[string]int) bool {
	unique := make([]int, 0, len(vaults))
	tracker := make(map[int]bool)

	for _, number := range vaults {
		if _, ok := tracker[number]; !ok {
			tracker[number] = true
			unique = append(unique, number)
		}
	}

	return len(vaults) == len(unique)
}

// NewProvider creates a new Provider instance.
func NewProvider() esv1.Provider {
	return &ProviderOnePassword{}
}

// ProviderSpec returns the provider specification for registration.
func ProviderSpec() *esv1.SecretStoreProvider {
	return &esv1.SecretStoreProvider{
		OnePassword: &esv1.OnePasswordProvider{},
	}
}

// MaintenanceStatus returns the maintenance status of the provider.
func MaintenanceStatus() esv1.MaintenanceStatus {
	return esv1.MaintenanceStatusMaintained
}