lock

type ErrAlreadyLocked struct {
	LeaseName string
	Holder    string
}

type ErrLockExpired struct {
	LeaseName string
}

type LeaseManager struct {
	Client client.Client
}

type LeaseOpError struct {
	Op        string // e.g. "creating", "getting", "deleting", "renewing", "taking over"
	LeaseName string
	Err       error
}

type LeaseRef struct {
	Name      string
	Namespace string
}

type Manager interface {
	// Acquire creates or takes over a Lease lock for the given resource.
	// Returns the lease name on success.
	Acquire(ctx context.Context, key ResourceKey, txnName string, timeout time.Duration) (string, error)

	// Release deletes a single Lease lock if held by the given transaction.
	// If the lease is held by a different transaction, the call is a no-op.
	Release(ctx context.Context, lease LeaseRef, txnName string) error

	// ReleaseAll releases multiple leases, returning the first error encountered.
	ReleaseAll(ctx context.Context, leases []LeaseRef, txnName string) error

	// Renew extends the lease duration for a lock held by the given transaction.
	// Returns an error if the lease is not found, expired, or held by a different transaction.
	Renew(ctx context.Context, lease LeaseRef, txnName string, timeout time.Duration) error
}

type ResourceKey struct {
	Namespace string
	Kind      string
	Name      string
}