core

type ArtifactDigestObj struct {
	BodyHash   HashObj
	BodySha256 []byte
	BodySha1   []byte
	SizeBytes  uint64
	ETag       string
}

type ArtifactKeyObj struct {
	MaterializerID string
	ArtifactKind   string
	ListenerID     string
	Key            string
	Version        string
}

type ArtifactObj struct {
	MaterializerID string
	ArtifactKind   string
	ListenerID     string
	Key            string
	Version        string
	ETag           string
	BodyHash       HashObj
	BodySha256     []byte
	BodySha1       []byte
	SizeBytes      uint64
	FormatVersion  uint32
	FilePath       string
	DegradedReason string
}

type DetectionObj struct {
	IsGo         bool
	IsComposer   bool
	Conflict     bool
	EvidenceJSON string

	// GoZipBlocked means the version tree cannot become a valid Go module zip
	// because of invalid paths, fold collisions, symlinks, or hard module-zip limits.
	GoZipBlocked bool
	// GoZipBlockReason is a short English reason; empty means not blocked.
	GoZipBlockReason string
}

type FeedEventObj struct {
	Key          string
	Version      string
	EventTS      time.Time
	TreeHash     HashObj
	BodyHash     HashObj
	ReleaseNotes string
	FirstPublish bool
}

type HashObj [HashSize]byte

type InputEntryObj struct {
	Path      string
	Mode      string
	Content   []byte
	BlobHash  HashObj
	SizeBytes uint64
}

type IntegrityReportObj struct {
	Errors []string
}

type KeySourceObj struct {
	Key         string
	URL         string
	Class       string
	WebAddr     string
	YggAddr     string
	OriginURL   string
	ListingMode string
	BoundTS     time.Time
}

type PublishObj struct {
	Key             string
	Version         string
	SourceHash      HashObj
	SourceSizeBytes uint64
	UpstreamSeq     int64 // precomputed source position; 0 lets publish assign max+1
	Entries         []InputEntryObj
	Detection       DetectionObj
	RewriteBlobs    []HashObj
	Artifacts       []ArtifactObj
	UpstreamDeleted bool
	EventType       string
	EventMessage    string
	ReleaseNotes    string
	HealPending     bool
	UpstreamRef     string    // source commit SHA; empty means unknown
	VerifiedTS      time.Time // deep verification timestamp to publish; zero leaves it unset
}

type PublishResultObj struct {
	Key        string
	Version    string
	TreeHash   HashObj
	Published  bool
	Skipped    bool
	Historical string
}

type StagedBlobObj struct {
	BlobHash  HashObj
	SizeBytes uint64
	FilePath  string
}

type StagedEntryObj struct {
	Path      string
	Mode      string
	BlobHash  HashObj
	SizeBytes uint64
}

type StagedPublishObj struct {
	Key             string
	Version         string
	SourceHash      HashObj
	SourceSizeBytes uint64
	UpstreamSeq     int64 // precomputed source position; 0 lets publish assign max+1
	Entries         []StagedEntryObj
	Blobs           []StagedBlobObj
	Detection       DetectionObj
	RewriteBlobs    []HashObj
	Artifacts       []ArtifactObj
	UpstreamDeleted bool
	EventType       string
	EventMessage    string
	ReleaseNotes    string
	HealPending     bool
	UpstreamRef     string    // source commit SHA; empty means unknown
	VerifiedTS      time.Time // deep verification timestamp to publish; zero leaves it unset
}

type TreeEntryObj struct {
	Path      string
	Mode      string
	SizeBytes uint64
	BlobHash  HashObj
}

type VersionObj struct {
	Key             string
	Version         string
	SourceHash      HashObj
	SourceSizeBytes uint64
	TreeHash        HashObj
	IngestTS        time.Time
	UpstreamSeq     int64 // source listing position: larger is newer; 0 means unset
	UpstreamDeleted bool
	ReplacedBy      string
	ReleaseNotes    string
	HealPending     bool
	UpstreamRef     string    // commit SHA from source refs advertisement; empty means unknown (brother/legacy)
	VerifiedTS      time.Time // last deep verification time; zero means never verified
}