models

type Dependency struct {
	AnalysisIdentifier string   `json:"analysis_identifier"`
	Specifiers         []string `json:"specifiers"`
	EnvironmentMarker  *string  `json:"environment_marker,omitempty"`
	Extras             []string `json:"extras,omitempty"`
	ExtraMarker        *string  `json:"extra_marker,omitempty"`
	// Dev indicates this package would not exist in a production install.
	// True when the package is only reachable through dev dependency paths from root.
	Dev        bool          `json:"dev,omitempty"`
	ParseError *string       `json:"parse_error,omitempty"`
	Location   *LocationInfo `json:"source,omitempty"`
}

type DependencyMetadata struct {
	Status       string       `json:"status"` // "success" | "skipped" | "error"
	StatusReason *string      `json:"status_reason,omitempty"`
	Direct       []Dependency `json:"direct"`
	Transitive   []Dependency `json:"transitive,omitempty"`
	ParseErrors  []ParseError `json:"parse_errors,omitempty"`
}

type DepsTreeEdge struct {
	// ParentKey: The package that depends on ChildKey.
	//   - Parsers initially set "" for direct dependencies; enrichLockfileEdges
	//     replaces this with the sourceKey (e.g., "source/github.com/foo/bar").
	//   - Full key with version for transitive dependencies.
	ParentKey string `json:"parent"`
	ChildKey  string `json:"child"`
	Ecosystem string `json:"ecosystem"`
	// Dev indicates this package would not exist in a production install.
	// True when the package is only reachable through dev dependency paths from root.
	Dev      bool          `json:"dev,omitempty"`
	Location *LocationInfo `json:"location,omitempty"`
}

type DetectedManifest struct {
	Ecosystem      string  `json:"ecosystem"`
	PackageManager *string `json:"package_manager,omitempty"`
	// Multiple paths occur when package managers treat several files as one unit:
	// - Python: pyproject.toml + setup.cfg + setup.py (all define the same package)
	// - Ruby: gemspec + Gemfile (bundler reads both when Gemfile has `gemspec` directive)
	// Parsers must iterate ALL paths, not just Paths[0].
	Paths    []string `json:"paths"`
	Lockfile *string  `json:"lockfile,omitempty"`
}

type DistributionInfo struct {
	URL           string `json:"url,omitempty"`
	Filename      string `json:"filename,omitempty"`
	Hash          string `json:"hash,omitempty"`
	HashAlgorithm string `json:"hash_algorithm,omitempty"` // "sha256", "sha512", "sha1"
}

type DynamicDependency struct {
	SourceFile string `json:"source_file"`
	Line       int    `json:"line"`
	Reason     string `json:"reason"`
}

type GitMetadata struct {
	SourceURL              string     `json:"source_url"`
	Status                 string     `json:"status"` // "success" | "skipped" | "error"
	CollectedAt            *time.Time `json:"collected_at,omitempty"`
	StatusReason           *string    `json:"status_reason,omitempty"`
	RecentAuthorsCount     *int       `json:"recent_authors_count,omitempty"`
	MaxMonthlyAuthorsCount *int       `json:"max_monthly_authors_count,omitempty"`
	MaxMonthlyWindowStart  *time.Time `json:"max_monthly_window_start,omitempty"`
	MaxMonthlyWindowEnd    *time.Time `json:"max_monthly_window_end,omitempty"`
	FirstCommit            *time.Time `json:"first_commit,omitempty"`
	LatestHumanCommit      *time.Time `json:"latest_human_commit,omitempty"`
	CommitCount            *int       `json:"commit_count,omitempty"`
	HumanCommitCount       *int       `json:"human_commit_count,omitempty"`
}

type LicenseFile struct {
	Path string `json:"path"`
}

type LocationInfo struct {
	File       *string `json:"file,omitempty"`
	LineNumber *int    `json:"ln,omitempty"`
}

type Maintainer struct {
	Name                string     `json:"name,omitempty"`
	Email               string     `json:"email,omitempty"`
	Role                string     `json:"role,omitempty"` // "maintainer" (npm), "author"/"maintainer" (pypi), "owner" (rubygems)
	FirstPublishVersion *string    `json:"first_publish_version,omitempty"`
	FirstPublishDate    *time.Time `json:"first_publish_date,omitempty"`
	LastPublishVersion  *string    `json:"last_publish_version,omitempty"`
	LastPublishDate     *time.Time `json:"last_publish_date,omitempty"`
	VersionCount        int        `json:"version_count,omitempty"`
	IsActive            *bool      `json:"is_active,omitempty"`
}

type ManifestResult struct {
	DetectedManifest
	Name                 *string             `json:"name,omitempty"`
	Private              bool                `json:"private,omitempty"`
	IsDynamic            bool                `json:"is_dynamic,omitempty"`
	DynamicReason        *string             `json:"dynamic_reason,omitempty"`
	InstallScripts       []string            `json:"install_scripts,omitempty"`
	Dependencies         []Dependency        `json:"dependencies"`
	DynamicDependencies  []DynamicDependency `json:"dynamic_dependencies,omitempty"`
	LockfileDependencies []DepsTreeEdge      `json:"lockfile_dependencies"`
	ParseError           *string             `json:"parse_error,omitempty"`
}

type ManifestsResult struct {
	Manifests   []ManifestResult `json:"manifests"`
	ParseErrors []ParseError     `json:"parse_errors,omitempty"`
}

type Package struct {
	Name         string       `json:"name"`
	Ecosystem    string       `json:"ecosystem"`
	Dependencies []Dependency `json:"dependencies"`
	Version      *string      `json:"version,omitempty"`
	License      *string      `json:"license,omitempty"`
	SourceURL    *string      `json:"source_url,omitempty"`
	SourceURLKey *string      `json:"source_url_key,omitempty"`
	ReleaseDate  *time.Time   `json:"release_date,omitempty"`
	Status       string       `json:"status"`
}

type PackageInfo struct {
	Ecosystem string `json:"ecosystem"`
	Name      string `json:"name"`
	Version   string `json:"version,omitempty"`
	Private   bool   `json:"private,omitempty"`
}

type PackageMetadata struct {
	Ecosystem    string            `json:"ecosystem"`
	PackageName  string            `json:"package_name"`
	Version      *string           `json:"version,omitempty"`
	Description  *string           `json:"description,omitempty"`
	Homepage     *string           `json:"homepage,omitempty"`
	SourceURL    *string           `json:"source_url,omitempty"`
	License      *string           `json:"license,omitempty"`
	ReleaseDate  *time.Time        `json:"release_date,omitempty"`
	Dependencies []Dependency      `json:"dependencies,omitempty"`
	Maintainers  []Maintainer      `json:"maintainers,omitempty"`
	Distribution *DistributionInfo `json:"distribution,omitempty"`
	Status       string            `json:"status"` // "success" | "skipped" | "error"
	CollectedAt  *time.Time        `json:"collected_at,omitempty"`
	StatusReason *string           `json:"status_reason,omitempty"`
}

type ParseError struct {
	FilePath  string `json:"file_path"`
	Error     string `json:"error"`
	ErrorType string `json:"error_type,omitempty"` // "read_error" | "parse_error"
}

type VersionInfo struct {
	Version    string    `json:"version"`
	ReleasedAt time.Time `json:"released_at"`
}

type VersionMetadata struct {
	Ecosystem     string        `json:"ecosystem"`
	PackageName   string        `json:"package_name"`
	Versions      []VersionInfo `json:"versions"`
	LatestVersion *VersionInfo  `json:"latest_version,omitempty"`
	CollectedAt   *time.Time    `json:"collected_at,omitempty"`
	Status        string        `json:"status"` // "success", "skip", "error"
	Message       string        `json:"message,omitempty"`
}