Errors

DSAR-BE-1413: PERSISTENCE_INVALID_RECORD

Alpha

DSAR is currently in alpha. APIs, package surfaces, configuration, and documentation may change as the project evolves.

Meaning

A record retrieved from the database violates the expected domain contract (e.g. an enum field contains an unrecognised value).

Probable Causes

Database was modified directly, bypassing application-level validation.
A migration introduced or removed valid enum values without updating all records.
Data corruption or encoding issue in the storage layer.

How to Fix

Inspect error.trace.entity and error.trace.field for the offending record.
Verify the stored value against the current domain schema.
Run a data migration to correct invalid records.

Retryable

No. The underlying data must be corrected first.

Response Shape

{
	"ok": false,
	"error": {
		"id": "DSAR-BE-1413",
		"code": "PERSISTENCE_INVALID_RECORD",
		"message": "Persisted record violates domain contract.",
		"status": 400,
		"trace": {
			"entity": "retention_policy",
			"field": "retentionClass",
			"type": "PersistenceInvalidRecordError"
		}
	}
}

Minimal Trigger Example

// Stored row has an unexpected enum value:
// retentionClass = "legacy_hold" or status = "stale_state"
const policy = await persistence.retentionPolicies.findById(policyId);
// Reading this row triggers DSAR-BE-1413 (PERSISTENCE_INVALID_RECORD)
// because `retentionClass` / `status` cannot be decoded to domain enums.