depgraph

type API struct {
	// Position is the position of the function declaration.
	Position token.Position
	// Pattern is the parsed HTTP mux pattern
	Pattern *directiveparser.DirectiveAPI
	// Function is the function that handles the API
	Function *types.Func
	// Documentation is the extracted function comments
	Documentation string
	// Package is the package that contains the function
	Package *packages.Package
	// OpenAPI is the OpenAPI operation spec for this endpoint
	OpenAPI *spec.Operation
}

type Config struct {
	// Position of the type declaration.
	Position  token.Position
	Type      types.Type
	Directive *directiveparser.DirectiveConfig
	// IsGeneric indicates if this config is a generic type
	IsGeneric bool
	// TypeParams holds the type parameters for generic configs
	TypeParams *types.TypeParamList
}

type CronJob struct {
	// Position is the position of the function declaration.
	Position token.Position
	// Schedule is the parsed cron schedule directive
	Schedule *directiveparser.DirectiveCron
	// Function is the function that handles the cron job
	Function *types.Func
	// Package is the package that contains the function
	Package *packages.Package
}

type Graph struct {
	Dest           *types.Package
	Providers      map[string][]*Provider // All providers including multi and generic
	Configs        map[string]*Config
	GenericConfigs map[string][]*Config // Generic configs by base type name
	APIs           []*API
	CronJobs       []*CronJob
	Subscriptions  []*Subscription
	Middleware     []*Middleware
	Missing        map[*types.Func][]types.Type
}

type Middleware struct {
	// Position is the position of the function declaration.
	Position token.Position
	// Directive is the parsed middleware directive
	Directive *directiveparser.DirectiveMiddleware
	// Function is the function that implements the middleware
	Function *types.Func
	// Package is the package that contains the function
	Package *packages.Package
	// Requires are the dependencies required by this middleware
	Requires []types.Type
	// Factory represents whether the middleware is a factory, or direct middleware function
	Factory bool
}

type Option func(*graphOptions) error

type Provider struct {
	// Position is the position of the function declaration.
	Position  token.Position
	Directive *directiveparser.DirectiveProvider
	// Function is the function that provides the type.
	Function *types.Func
	// Package is the package that contains the function.
	Package  *packages.Package
	Provides types.Type
	Requires []types.Type
	// IsGeneric indicates if this provider is a generic function
	IsGeneric bool
	// TypeParams holds the type parameters for generic providers
	TypeParams *types.TypeParamList
}

type Ref struct {
	Pkg    string // database/sql
	Import string // "database/sql" or impe1d11ad6baa4124f "database/sql"
	Ref    string // *sql.DB or *impe1d11ad6baa4124f.DB
}

type Subscription struct {
	// Position is the position of the function declaration.
	Position token.Position
	// Function is the function that handles the subscription
	Function *types.Func
	// Package is the package that contains the function
	Package *packages.Package
	// TopicType is the event type extracted from pubsub.Event[T]
	TopicType types.Type
}