errors

var (
	// ErrItemNotFound is returned when an item is not found in the database
	ErrItemNotFound = errors.New("item not found")

	// ErrInvalidModel is returned when a model struct is invalid
	ErrInvalidModel = errors.New("invalid model")

	// ErrMissingPrimaryKey is returned when a model doesn't have a primary key
	ErrMissingPrimaryKey = errors.New("missing primary key")

	// ErrInvalidPrimaryKey is returned when a primary key value is invalid
	ErrInvalidPrimaryKey = errors.New("invalid primary key")

	// ErrConditionFailed is returned when a condition check fails
	ErrConditionFailed = errors.New("condition check failed")

	// ErrVersionConflict is returned when an optimistic-lock version condition fails.
	// It matches ErrConditionFailed via errors.Is for backward compatibility.
	ErrVersionConflict = conditionSubtypeError("version conflict")

	// ErrThrottled is returned when DynamoDB rejects an operation due to throttling.
	ErrThrottled = errors.New("throttled")

	// ErrTransactionConflict is returned when DynamoDB reports a transaction conflict.
	// It matches ErrTransactionFailed via errors.Is for backward compatibility.
	ErrTransactionConflict = transactionSubtypeError("transaction conflict")

	// ErrIndexNotFound is returned when a specified index doesn't exist
	ErrIndexNotFound = errors.New("index not found")

	// ErrTransactionFailed is returned when a transaction fails
	ErrTransactionFailed = errors.New("transaction failed")

	// ErrBatchOperationFailed is returned when a batch operation partially fails
	ErrBatchOperationFailed = errors.New("batch operation failed")

	// ErrUnsupportedType is returned when a field type is not supported
	ErrUnsupportedType = errors.New("unsupported type")

	// ErrInvalidTag is returned when a struct tag is invalid
	ErrInvalidTag = errors.New("invalid struct tag")

	// ErrTableNotFound is returned when a table doesn't exist
	ErrTableNotFound = errors.New("table not found")

	// ErrDuplicatePrimaryKey is returned when multiple primary keys are defined.
	// It matches ErrInvalidModel via errors.Is because duplicate keys are invalid model shapes.
	// Its declared error type is part of the published API contract.
	ErrDuplicatePrimaryKey error = invalidModelSubtypeError("duplicate primary key definition")

	// ErrEmptyValue is returned when a required value is empty
	ErrEmptyValue = errors.New("empty value")

	// ErrNoUpdatableFields is returned when an update selects no field the caller
	// can write, so there is no assignment to apply.
	ErrNoUpdatableFields = errors.New("no non-key fields to update")

	// ErrInvalidOperator is returned when an invalid query operator is used
	ErrInvalidOperator = errors.New("invalid query operator")

	// ErrEncryptionNotConfigured is returned when a model uses theorydb:"encrypted" fields but no KMS key ARN is configured.
	ErrEncryptionNotConfigured = errors.New("encryption not configured")

	// ErrInvalidEncryptedEnvelope is returned when an encrypted attribute value is not a valid TableTheory envelope.
	ErrInvalidEncryptedEnvelope = errors.New("invalid encrypted envelope")

	// ErrEncryptedFieldNotQueryable is returned when a theorydb:"encrypted" field is used in query/filter conditions.
	ErrEncryptedFieldNotQueryable = errors.New("encrypted fields are not queryable/filterable")

	// ErrImmutableModelMutation is returned when a write-once model is mutated through a generic high-level API.
	ErrImmutableModelMutation = errors.New("immutable model mutation")

	// ErrProtectedFieldMutation is returned when a protected model attribute is mutated through a generic high-level API.
	ErrProtectedFieldMutation = errors.New("protected field mutation")

	// ErrRejectedDeployAuthorityEvidence is returned when provenance/confidence evidence is not deploy-authoritative.
	ErrRejectedDeployAuthorityEvidence = errors.New("rejected deploy authority evidence")
)