[api] add core/v1alpha3 with per-record TTL Domain types

Introduce v1alpha3 as the new storage version for Domain and DomainZone,
with per-record TTL support via typed DNS record substructs (DNSAddressRecords,
DNSCNAMERecord, etc.) instead of flat string slices.

- Create api/core/v1alpha3 package with Domain, DomainZone, shared types
- Make v1alpha2 and v1alpha spoke versions converting through v1alpha3 hub
- Add cross-version v1alpha<->v1alpha2 conversion functions chaining through
  v1alpha3, since the k8s scheme does not support multi-hop conversion
- Register cross-version conversions on both the apiserver builder scheme
  (via WithAdditionalSchemeInstallers) and the controller-runtime scheme
- Run codegen for deepcopy, register, clients, listers, informers, openapi

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: dilyevsky

api/core/v1alpha/domain_conversion.go

@@ -9,7 +9,7 @@ import (
 	"k8s.io/apiserver/pkg/registry/rest"
 	"sigs.k8s.io/apiserver-runtime/pkg/builder/resource"
 
-	v1alpha2 "github.com/apoxy-dev/apoxy/api/core/v1alpha2"
+	v1alpha3 "github.com/apoxy-dev/apoxy/api/core/v1alpha3"
 )
 
 const (
@@ -309,31 +309,31 @@ func (a *Domain) GetStatus() resource.StatusSubResource {
 var _ resource.MultiVersionObject = &Domain{}
 
 func (a *Domain) NewStorageVersionObject() runtime.Object {
-	return &v1alpha2.Domain{}
+	return &v1alpha3.Domain{}
 }
 
 func (a *Domain) ConvertToStorageVersion(storageObj runtime.Object) error {
-	obj, ok := storageObj.(*v1alpha2.Domain)
+	obj, ok := storageObj.(*v1alpha3.Domain)
 	if !ok {
-		return errors.New("failed to convert to v1alpha2 Domain")
+		return errors.New("failed to convert to v1alpha3 Domain")
 	}
 
 	obj.ObjectMeta = *a.ObjectMeta.DeepCopy()
-	obj.Spec = *convertDomainSpecFromV1Alpha1ToV1Alpha2(&a.Spec)
-	obj.Status = *convertDomainStatusFromV1Alpha1ToV1Alpha2(&a.Status)
+	obj.Spec = *convertDomainSpecFromV1Alpha1ToV1Alpha3(&a.Spec)
+	obj.Status = *convertDomainStatusFromV1Alpha1ToV1Alpha3(&a.Status)
 
 	return nil
 }
 
 func (a *Domain) ConvertFromStorageVersion(storageObj runtime.Object) error {
-	obj, ok := storageObj.(*v1alpha2.Domain)
+	obj, ok := storageObj.(*v1alpha3.Domain)
 	if !ok {
-		return errors.New("failed to convert from v1alpha2 Domain")
+		return errors.New("failed to convert from v1alpha3 Domain")
 	}
 
 	a.ObjectMeta = *obj.ObjectMeta.DeepCopy()
-	a.Spec = *convertDomainSpecFromV1Alpha2ToV1Alpha1(&obj.Spec)
-	a.Status = *convertDomainStatusFromV1Alpha2ToV1Alpha1(&obj.Status)
+	a.Spec = *convertDomainSpecFromV1Alpha3ToV1Alpha1(&obj.Spec)
+	a.Status = *convertDomainStatusFromV1Alpha3ToV1Alpha1(&obj.Status)
 
 	return nil
 }

api/core/v1alpha/domain_types.go

@@ -9,7 +9,7 @@ import (
 	"k8s.io/apiserver/pkg/registry/rest"
 	"sigs.k8s.io/apiserver-runtime/pkg/builder/resource"
 
-	v1alpha2 "github.com/apoxy-dev/apoxy/api/core/v1alpha2"
+	v1alpha3 "github.com/apoxy-dev/apoxy/api/core/v1alpha3"
 )
 
 // +kubebuilder:object:root=true
@@ -243,34 +243,34 @@ func (a *DomainZone) GetStatus() resource.StatusSubResource {
 var _ resource.MultiVersionObject = &DomainZone{}
 
 func (a *DomainZone) NewStorageVersionObject() runtime.Object {
-	return &v1alpha2.DomainZone{}
+	return &v1alpha3.DomainZone{}
 }
 
 func (a *DomainZone) ConvertToStorageVersion(storageObj runtime.Object) error {
-	obj, ok := storageObj.(*v1alpha2.DomainZone)
+	obj, ok := storageObj.(*v1alpha3.DomainZone)
 	if !ok {
-		return errors.New("failed to convert to v1alpha2 DomainZone")
+		return errors.New("failed to convert to v1alpha3 DomainZone")
 	}
 
 	obj.ObjectMeta = *a.ObjectMeta.DeepCopy()
 
 	// Convert Spec
 	obj.Spec.Nameservers = a.Spec.Nameservers
 	if a.Spec.RegistrationConfig != nil {
-		obj.Spec.RegistrationConfig = &v1alpha2.RegistrationConfig{
+		obj.Spec.RegistrationConfig = &v1alpha3.RegistrationConfig{
 			AutoRenew:               a.Spec.RegistrationConfig.AutoRenew,
 			RegistrationPeriodYears: a.Spec.RegistrationConfig.RegistrationPeriodYears,
 		}
 		if a.Spec.RegistrationConfig.Registrant != nil {
-			obj.Spec.RegistrationConfig.Registrant = &v1alpha2.Registrant{
+			obj.Spec.RegistrationConfig.Registrant = &v1alpha3.Registrant{
 				FirstName:    a.Spec.RegistrationConfig.Registrant.FirstName,
 				LastName:     a.Spec.RegistrationConfig.Registrant.LastName,
 				Email:        a.Spec.RegistrationConfig.Registrant.Email,
 				Phone:        a.Spec.RegistrationConfig.Registrant.Phone,
 				Organization: a.Spec.RegistrationConfig.Registrant.Organization,
 			}
 			if a.Spec.RegistrationConfig.Registrant.Address != nil {
-				obj.Spec.RegistrationConfig.Registrant.Address = &v1alpha2.Address{
+				obj.Spec.RegistrationConfig.Registrant.Address = &v1alpha3.Address{
 					AddressLine1:  a.Spec.RegistrationConfig.Registrant.Address.AddressLine1,
 					AddressLine2:  a.Spec.RegistrationConfig.Registrant.Address.AddressLine2,
 					City:          a.Spec.RegistrationConfig.Registrant.Address.City,
@@ -283,10 +283,10 @@ func (a *DomainZone) ConvertToStorageVersion(storageObj runtime.Object) error {
 	}
 
 	// Convert Status
-	obj.Status.Phase = v1alpha2.DomainZonePhase(a.Status.Phase)
+	obj.Status.Phase = v1alpha3.DomainZonePhase(a.Status.Phase)
 	obj.Status.Conditions = a.Status.Conditions
 	if a.Status.RegistrationStatus != nil {
-		obj.Status.RegistrationStatus = &v1alpha2.RegistrationStatus{
+		obj.Status.RegistrationStatus = &v1alpha3.RegistrationStatus{
 			RegistrationID: a.Status.RegistrationStatus.RegistrationID,
 			EstimatedCost:  a.Status.RegistrationStatus.EstimatedCost,
 			PaymentURL:     a.Status.RegistrationStatus.PaymentURL,
@@ -296,7 +296,7 @@ func (a *DomainZone) ConvertToStorageVersion(storageObj runtime.Object) error {
 		}
 	}
 	if a.Status.Nameservers != nil {
-		obj.Status.Nameservers = &v1alpha2.NameserverStatus{
+		obj.Status.Nameservers = &v1alpha3.NameserverStatus{
 			Required: a.Status.Nameservers.Required,
 			Current:  a.Status.Nameservers.Current,
 		}
@@ -306,9 +306,9 @@ func (a *DomainZone) ConvertToStorageVersion(storageObj runtime.Object) error {
 }
 
 func (a *DomainZone) ConvertFromStorageVersion(storageObj runtime.Object) error {
-	obj, ok := storageObj.(*v1alpha2.DomainZone)
+	obj, ok := storageObj.(*v1alpha3.DomainZone)
 	if !ok {
-		return errors.New("failed to convert from v1alpha2 DomainZone")
+		return errors.New("failed to convert from v1alpha3 DomainZone")
 	}
 
 	a.ObjectMeta = *obj.ObjectMeta.DeepCopy()