feat(v1beta1): load v1beta1 packages

src/api/api.go

@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2021-Present The Zarf Authors
+
+// Package api supplies helpers for working generically with the different API versions
+package api
+
+import (
+	"github.com/zarf-dev/zarf/src/api/v1alpha1"
+	"github.com/zarf-dev/zarf/src/api/v1beta1"
+)
+
+// PackageAccessor is the read contract for a package source, exposing a per-version definition.
+type PackageAccessor interface {
+	AsV1alpha1() (v1alpha1.ZarfPackage, error)
+	AsV1beta1() (v1beta1.Package, error)
+}

src/api/convert/convert.go

@@ -7,10 +7,18 @@ package convert
 import (
 	"github.com/zarf-dev/zarf/src/api/v1alpha1"
 	"github.com/zarf-dev/zarf/src/api/v1beta1"
+	"github.com/zarf-dev/zarf/src/internal/api/types"
 	internalv1alpha1 "github.com/zarf-dev/zarf/src/internal/api/v1alpha1"
 	internalv1beta1 "github.com/zarf-dev/zarf/src/internal/api/v1beta1"
 )
 
+// GenericToCanonicalAPIVersion takes a generic Package and converts it to the API version
+// that package layout is currently using.
+// Intentionally only callable internally since it uses the generic type
+func GenericToCanonicalAPIVersion(gen types.Package) v1alpha1.ZarfPackage {
+	return internalv1alpha1.ConvertFromGeneric(gen)
+}
+
 // PackageV1alpha1ToV1beta1 converts a v1alpha1 ZarfPackage to a v1beta1 Package.
 func PackageV1alpha1ToV1beta1(pkg v1alpha1.ZarfPackage) v1beta1.Package {
 	generic := internalv1alpha1.ConvertToGeneric(pkg)