export

type ArchiveWriter interface {
	WriteResource(name string, value interface{}) error
	WriteEntities(func(EntitySink) error) error
	Close() error
}

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

type Data struct {
	Blueprints []api.Blueprint
	Entities   []api.Entity
	Scorecards []api.Scorecard
	Actions    []api.Action
	// BlueprintPermissions maps blueprint identifier -> permissions object.
	BlueprintPermissions map[string]api.Permissions
	// ActionPermissions maps action identifier -> permissions object.
	ActionPermissions map[string]api.Permissions
	// PagePermissions maps page identifier -> permissions object.
	PagePermissions map[string]api.Permissions
	Teams           []api.Team
	Users           []api.User
	Folders         []api.Folder
	Pages           []api.Page
	Integrations    []api.Integration
	TimeoutErrors   []string // Blueprints that timed out during export
	Warnings        []string // Non-fatal issues encountered during collection
	// ReferencedBlueprintIDs is populated when Options.AutoScopeBlueprints is
	// true: the set of blueprint identifiers that produced at least one
	// matching entity/scorecard/action during Collect. Always non-nil.
	ReferencedBlueprintIDs map[string]bool
}

type EntitySink interface {
	WriteEntity(api.Entity) error
}

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

type Options struct {
	OutputPath                    string
	Blueprints                    []string
	Format                        string
	SkipEntities                  bool
	SkipSystemBlueprints          bool // skip _* blueprint schemas and their entities
	SkipSystemBlueprintProperties bool
	IncludeRuleResults            bool // include the _rule_result system blueprint and its entities (excluded by default)
	IncludeResources              []string
	ExcludeBlueprints             []string // deep: exclude blueprint schema + all its resources
	ExcludeBlueprintSchema        []string // shallow: exclude only the blueprint schema, keep resources

	// AutoScopeBlueprints, when true, causes Collect to record which blueprints
	// produced at least one matching entity/scorecard/action into
	// Data.ReferencedBlueprintIDs. It does NOT narrow Data.Blueprints itself —
	// callers that want the narrowed set call FilterBlueprintsToReferenced
	// after combining this signal with any other source of "referenced" (e.g.
	// export.go's separate entity-streaming pass, which never runs inside
	// Collect when SkipEntities is forced true).
	AutoScopeBlueprints bool

	// Per-resource ID filters (client-side, applied after bulk fetch)
	Entities     []string
	Scorecards   []string
	Actions      []string
	Pages        []string
	Integrations []string
	Teams        []string
	Users        []string
}

type Result struct {
	Success           bool
	Message           string
	OutputPath        string
	BlueprintsCount   int
	EntitiesCount     int
	ActionsCount      int
	PagesCount        int
	IntegrationsCount int
	UsersCount        int
	TeamsCount        int
	FoldersCount      int
	Format            string
	TimeoutErrors     []string // Blueprints that timed out during export
	Error             error
}