registry

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

type AuthError struct{ Err error }

type ImageConfig struct {
	// Env is the image's environment variables (KEY=VALUE parsed to map).
	Env map[string]string

	// OS is the image's target OS (e.g., "linux").
	OS string

	// Arch is the image's target architecture (e.g., "amd64").
	Arch string

	// Variant is the image's architecture variant (e.g., "v8").
	Variant string

	// Digest is the resolved manifest digest.
	Digest string

	// HasHealthcheck is true if the image defines a HEALTHCHECK (CMD or CMD-SHELL).
	// False if HEALTHCHECK is NONE or absent.
	HasHealthcheck bool

	// WorkingDir is the image's configured working directory (from WORKDIR).
	// Empty string means no explicit WORKDIR was set (default is /).
	WorkingDir string
}

type ImageResolver interface {
	// ResolveConfig resolves image config (env + resolved digest/platform)
	// for the given ref and platform (e.g., "linux/amd64").
	//
	// Error contract:
	//   - AuthError: 401/403, missing/expired creds
	//   - NetworkError: transient network failure
	//   - NotFoundError: ref/tag/manifest not found
	//   - PlatformMismatchError: image exists but no manifest matches platform
	ResolveConfig(ctx context.Context, ref string, platform string) (ImageConfig, error)
}

type NetworkError struct{ Err error }

type NotFoundError struct {
	Ref string
	Err error
}

type PlatformMismatchError struct {
	Ref       string
	Requested string
	Available []string
	Err       error
}

type ResolveRequest struct {
	Ref      string
	Platform string
}