source

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

type ArtifactRef struct {
	APIVersion string `json:"apiVersion"`
	Kind       string `json:"kind"`
	Name       string `json:"name"`
	UID        string `json:"uid,omitempty"`
}

type ManifestSource interface {
	FetchNodeManifests(ctx context.Context, ref aggapi.NodeRef) ([]unstructured.Unstructured, error)
}

type Node struct {
	// APIVersion is the apiVersion of the snapshot CR for this node
	// (e.g. "state-snapshotter.deckhouse.io/v1alpha1" or a domain-specific group).
	// Orphan leaf volume nodes use "snapshot.storage.k8s.io/v1".
	APIVersion string

	// Kind is the kind of the snapshot CR for this node
	// (e.g. "Snapshot", "DemoVirtualMachineSnapshot").
	// Orphan leaf volume nodes always have Kind == "VolumeSnapshot".
	Kind string

	// Name is the metadata.name of the snapshot CR.
	// For orphan leaf nodes it is the captured VolumeSnapshot CR name.
	Name string

	// Namespace is the namespace of the snapshot CR.
	// For the root it is the user-supplied namespace; children inherit it.
	Namespace string

	// UID is the metadata.uid of the snapshot CR. Together with APIVersion/Kind/Namespace/Name
	// it forms the node's SnapshotIdentity (see identity.go), the basis for the resume key and
	// the archive collision discriminator. The readable directory base is NOT derived from it
	// (it comes from the source name; see DirBaseName).
	UID types.UID

	// SourceRef is the identity of the original captured source object, parsed from the
	// namespaced status.sourceRef (see ParseNodeStatus). It is the readable-directory base
	// (SourceRef.Name) and the domain source identity persisted for import reconstruction.
	// Nil when the CR has no status.sourceRef (e.g. some import-mode nodes).
	SourceRef *SourceRefIdentity

	// Data is the node's captured volume payload parsed from the namespaced status.data
	// (Variant A: at most one per node), or nil for aggregators and manifest-only nodes.
	Data *NodeData

	// Ready is this node's own Ready condition (status/reason/message), read from the node's
	// own status.conditions — populated for every node (root and every descendant, including
	// orphan VolumeSnapshot leaves), not only the root. Zero value when the node carries no
	// Ready condition at all; see parseReadyCondition in conditions.go.
	Ready NodeReadyStatus

	// Parent is the parent node. Nil for the root.
	Parent *Node

	// Children are the direct child nodes: domain snapshot children first (in
	// childrenSnapshotRefs order), then orphan leaf volume children for aggregator
	// nodes (in VolumeSnapshot visibility-leaf ref order). Always nil for orphan leaf
	// volume nodes (they are leaves).
	Children []*Node
}

type NodeData struct {
	// SourceRef identifies the captured PersistentVolumeClaim backing this node's data (the
	// data-leaf PVC, distinct from the top-level status.sourceRef live domain object). Its uid is
	// the single volume identity (state-snapshotter dropped the standalone targetUID).
	SourceRef SourceRefIdentity `json:"sourceRef"`
	// ArtifactRef references the cluster-scoped durable data artifact.
	ArtifactRef ArtifactRef `json:"artifactRef"`
	// VolumeMode is the source volume mode (Block or Filesystem).
	VolumeMode string `json:"volumeMode,omitempty"`
	// FsType is the source filesystem type (Filesystem volumes only).
	FsType string `json:"fsType,omitempty"`
	// AccessModes records the source PVC access modes.
	AccessModes []string `json:"accessModes,omitempty"`
	// StorageClassName records the source StorageClass of the captured volume.
	StorageClassName string `json:"storageClassName,omitempty"`
	// Size is the allocated size of the captured volume as a resource.Quantity string (e.g. "10Gi").
	Size string `json:"size,omitempty"`
}

type NodeReadyStatus struct {
	// Status is the condition's status field ("True"/"False"/"Unknown").
	Status string
	// Reason is the condition's reason field (CamelCase, e.g. "ChildSnapshotDeleted").
	Reason string
	// Message is the condition's human-readable message field.
	Message string
}

type SnapshotIdentity struct {
	APIVersion string
	Kind       string
	Namespace  string
	Name       string
	UID        types.UID
}

type SourceRefIdentity struct {
	APIVersion string `json:"apiVersion"`
	Kind       string `json:"kind"`
	Namespace  string `json:"namespace"`
	Name       string `json:"name"`
	UID        string `json:"uid"`
}

type TreeLimits struct {
	MaxDepth int
	MaxNodes int
}