upsert

const (
	// NOTE: [AddLast] is the *default* when not configured in the [Upserter] (since its the 'empty' type of int aka '0')
	AddLast Placement = iota
	AddAfterKey
	AddBeforeKey
	AddFirst
)

const (
	// SkipIfSame will skip the upsert operation if the incoming KEY+VALUE is identical to the one in the document.
	// This is mostly used in the [update] command where it would not emit a "changed" event.
	SkipIfSame Setting = 1 << iota

	// SkipIfExists will skip the upsert operation if the KEY exists in the document (empty or not).
	// This is useful for adding new KEY to the config file (e.g. during migration/upgrade), but never changing the key
	// if it already exists, regardless of the VALUE/Assignment configuration
	SkipIfExists

	// SkipIfSet will skip the upsert operation if the KEY exists in the document and *NOT* empty.
	SkipIfSet

	// SkipIfEmpty will skip the upsert operation if the KEY VALUE is empty
	SkipIfEmpty

	// Validate the KEY/VALUE pair and fail the operation if its invalid
	Validate

	// ErrorIfMissing will abort if the KEY does *NOT* exists in the target document. This is useful for ensuring
	// you only update keys, not accidentally creating new keys (e.g. in case of a typo).
	ErrorIfMissing

	// Replace comments on *existing* Assignments.
	//
	// Normally comments are only applied to *NEW* keys and not on existing ones.
	UpdateComments
)