scanner

type AgentSkillScannerConfig struct {
}

type CodeAnalysisEnricherConfig struct {
	EnableDepsUsageEvidence bool
}

type Config struct {
	ExcludePatterns    []string
	ConcurrentAnalyzer int
	TransitiveAnalysis bool
	TransitiveDepth    int
	Experimental       bool
}

type InsightsBasedPackageMetaEnricherConfig struct {
	ApiUrl     string
	ApiAuthKey string
}

type MalysisMalwareEnricherConfig struct {
	// Timeout for the enricher starting from the time of initialization.
	// This includes the time taken to submit the package for analysis and
	// waiting for the analysis to complete.
	Timeout time.Duration

	// Timeout for the gRPC operation to the Malysis service. This timeout
	// is for a single gRPC operation.
	GrpcOperationTimeout time.Duration

	// Number of workers to poll the analysis results
	QueryWorkerCount int

	// Maximum number of retries for querying the analysis results for a given
	// analysis identifier.
	MaxQueryRetries int
}

type PackageDependencyCallbackFn func(pkg *models.Package) error

type PackageMetaEnricher interface {
	// Name of the enricher
	Name() string

	// Enrich the package with meta information
	Enrich(pkg *models.Package, cb PackageDependencyCallbackFn) error

	// Wait for all the enrichments to complete
	Wait() error
}

type ScannerCallbackErrArgFn func(error)

type ScannerCallbackNoArgFn func()

type ScannerCallbackOnManifestFn func(manifest *models.PackageManifest)

type ScannerCallbackOnPackageFn func(pkg *models.Package)

type ScannerCallbacks struct {
	OnStartEnumerateManifest ScannerCallbackNoArgFn      // Manifest enumeration is starting
	OnEnumerateManifest      ScannerCallbackOnManifestFn // A manifest is read by reader
	OnStart                  ScannerCallbackNoArgFn      // Manifest scan phase is starting
	OnStartManifest          ScannerCallbackOnManifestFn // A manifest is starting to be scanned
	OnStartPackage           ScannerCallbackOnPackageFn  // A package analysis is starting
	OnAddTransitivePackage   ScannerCallbackOnPackageFn  // A transitive dependency is discovered
	OnDonePackage            ScannerCallbackOnPackageFn  // A package analysis is finished
	OnDoneManifest           ScannerCallbackOnManifestFn // A manifest analysis is finished
	BeforeFinish             ScannerCallbackNoArgFn      // Scan is about to finish
	OnStop                   ScannerCallbackErrArgFn     // Scan is finished
}

type SkillScannerCallbacks struct {
	OnStart        ScannerCallbackNoArgFn  // Scanner is starting
	OnStartEnrich  ScannerCallbackNoArgFn  // Beginning skill enrichment (malware analysis submission)
	OnDoneEnrich   ScannerCallbackNoArgFn  // Enrichment completed
	OnStartAnalyze ScannerCallbackNoArgFn  // Beginning malware analysis
	OnDoneAnalyze  ScannerCallbackNoArgFn  // Analysis completed
	OnStartReport  ScannerCallbackNoArgFn  // Beginning report generation
	OnDoneReport   ScannerCallbackNoArgFn  // Report generation completed
	OnStop         ScannerCallbackErrArgFn // Scanner is stopping (with optional error)
}