xpkg

type BuildOpt func(*buildOpts)

type Builder struct {
	// contains filtered or unexported fields
}

type CachedClient struct {
	// contains filtered or unexported fields
}

type Client interface {
	// Get fetches and parses a complete package from the given reference.
	// The ref parameter is a package reference (e.g.,
	// "registry.io/org/package:v1.0.0" or "registry.io/org/package@sha256:...").
	//
	// Caching and ImageConfig path rewriting are handled transparently.
	Get(ctx context.Context, ref string, opts ...GetOption) (*Package, error)

	// ListVersions returns available versions for a package source.
	// The source parameter is the package path without tag/digest
	// (e.g., "registry.io/org/package").
	//
	// Honors ImageConfig path rewriting when listing versions.
	ListVersions(ctx context.Context, source string, opts ...GetOption) ([]string, error)
}

type ConfigStore interface {
	// PullSecretFor returns the name of the selected image config and
	// name of the pull secret for a given image.
	PullSecretFor(ctx context.Context, image string) (imageConfig, pullSecret string, err error)
	// ImageVerificationConfigFor returns the ImageConfig for a given image.
	ImageVerificationConfigFor(ctx context.Context, image string) (imageConfig string, iv *v1beta1.ImageVerification, err error)
	// RewritePath returns the name of the selected image config and the
	// rewritten path of the given image based on that config.
	RewritePath(ctx context.Context, image string) (imageConfig, newPath string, err error)
	// RuntimeConfigFor returns the name of the selected image config and the
	// runtime config for a given image.
	RuntimeConfigFor(ctx context.Context, image string) (imageConfig string, runtimeConfig *v1beta1.ImageRuntime, err error)
}

type Fetcher interface {
	Fetch(ctx context.Context, ref name.Reference, secrets ...string) (v1.Image, error)
	Head(ctx context.Context, ref name.Reference, secrets ...string) (*v1.Descriptor, error)
	Tags(ctx context.Context, ref name.Reference, secrets ...string) ([]string, error)
}

type FetcherOpt func(k *K8sFetcher) error

type FsPackageCache struct {
	// contains filtered or unexported fields
}

type GetConfig struct {
	// contains filtered or unexported fields
}

type GetOption func(*GetConfig)

type ImageConfig struct {
	Name   string
	Reason ImageConfigReason
}

type ImageConfigReason string

type ImageConfigStore struct {
	// contains filtered or unexported fields
}

type ImageConfigStoreOption func(*ImageConfigStore)

type K8sFetcher struct {
	// contains filtered or unexported fields
}

type NopCache struct{}

type NopFetcher struct{}

type Package struct {
	*parser.Package

	// Digest is the immutable content identifier (sha256 from OCI image).
	Digest string

	// Version is the package version, either a semver tag (v1.0.0) or digest
	// (sha256:abc123). This is extracted from the original reference used to
	// fetch the package.
	Version string

	// Source is the package source without tag/digest, normalized.
	// This is the ORIGINAL source before any ImageConfig rewriting.
	Source string

	// ResolvedVersion is the package version after ImageConfig rewriting.
	// May differ from Version if an ImageConfig rewrote the tag/digest.
	ResolvedVersion string

	// ResolvedSource is the source after ImageConfig path rewriting.
	// May be the same as Source if no rewriting occurred.
	ResolvedSource string

	// AppliedImageConfigs tracks which ImageConfigs were applied during fetch.
	AppliedImageConfigs []ImageConfig
}

type PackageCache interface {
	Has(id string) bool
	Get(id string) (io.ReadCloser, error)
	Store(id string, content io.ReadCloser) error
	Delete(id string) error
}

type Validator parser.Linter