Migrate configuration and values

use Bjanczak\FilamentFlexFields\Support\Components\Schema\FamilyValueMigration;
use Bjanczak\FilamentFlexFields\Support\Components\Schema\FamilySchemaDefinition;
use Bjanczak\FilamentFlexFields\Support\Components\Schema\FamilyRenderContext;

// Add these methods to your FamilySchemaAdapter implementation,
// and declare that it also implements FamilyValueMigration.
public function supportsValueMigration(
    int $fromVersion,
    int $toVersion,
): bool {
    return in_array([$fromVersion, $toVersion], [[1, 2], [2, 1]], true);
}

public function migrateStoredValue(
    mixed $value,
    FamilySchemaDefinition $from,
    FamilySchemaDefinition $to,
    FamilyRenderContext $context,
): mixed {
    if ($value === null) {
        return null;
    }

    return $to->valueVersion === 2
        ? ['text' => $value]
        : $value['text'];
}

use Bjanczak\FilamentFlexFields\Support\Components\Schema\FamilySchemaMigration;
use Bjanczak\FilamentFlexFields\Support\Components\Schema\FamilyValueSnapshotCodec;

// Load this snapshot from authorized application storage, never request data.
$before = FamilyValueSnapshotCodec::decode($record->family_snapshot);

$result = app(FamilySchemaMigration::class)->prepare(
    snapshot: $before,
    context: $context,
    authorizeMigration: fn ($field, $context): bool =>
        $fieldPolicy->canMigrate($actor, $record, $field->family),
);

$afterJson = FamilyValueSnapshotCodec::encode($result->after);
$rollbackJson = FamilyValueSnapshotCodec::encode($result->before);

// Persist the new snapshot and your rollback copy atomically,
// using your application's transaction and revision/locking policy.