planner

type APIPlanner interface {
	ResourcePlanner
}

type ActionType string

type AuthStrategyPlanner interface {
	ResourcePlanner
}

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

type Config struct {
	// Namespace specifies the target namespace for planning operations
	Namespace string
}

type ControlPlanePlanner interface {
	ResourcePlanner
}

type CreateConfig struct {
	ResourceType   string
	ResourceName   string
	ResourceRef    string
	RequiredFields []string
	FieldExtractor func(resource any) map[string]any
	Namespace      string
	DependsOn      []string
	References     map[string]ReferenceInfo
	Parent         *ParentInfo
}

type DeleteConfig struct {
	ResourceType string
	ResourceName string
	ResourceRef  string
	ResourceID   string
	Namespace    string
}

type DependencyResolver struct{}

type FieldChange struct {
	Old any `json:"old"`
	New any `json:"new"`
}

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

type Options struct {
	Mode      PlanMode
	Generator string
}

type ParentInfo struct {
	Ref string `json:"ref"`
	ID  string `json:"id"` // May be "[unknown]" for parents in same plan
}

type Plan struct {
	Metadata       PlanMetadata    `json:"metadata"`
	Changes        []PlannedChange `json:"changes"`
	ExecutionOrder []string        `json:"execution_order"`
	Summary        PlanSummary     `json:"summary"`
	Warnings       []PlanWarning   `json:"warnings,omitempty"`
}

type PlanMetadata struct {
	Version     string    `json:"version"`
	GeneratedAt time.Time `json:"generated_at"`
	Generator   string    `json:"generator"`
	Mode        PlanMode  `json:"mode"`
}

type PlanMode string

type PlanSummary struct {
	TotalChanges      int                `json:"total_changes"`
	ByAction          map[ActionType]int `json:"by_action"`
	ByResource        map[string]int     `json:"by_resource"`
	ProtectionChanges *ProtectionSummary `json:"protection_changes,omitempty"`
}

type PlanWarning struct {
	ChangeID string `json:"change_id"`
	Message  string `json:"message"`
}

type PlannedChange struct {
	ID           string `json:"id"`
	ResourceType string `json:"resource_type"`
	ResourceRef  string `json:"resource_ref"`
	ResourceID   string `json:"resource_id,omitempty"` // Only for UPDATE/DELETE
	// Human-readable identifiers for resources without config refs
	ResourceMonikers map[string]string        `json:"resource_monikers,omitempty"`
	Action           ActionType               `json:"action"`
	Fields           map[string]any           `json:"fields"`
	References       map[string]ReferenceInfo `json:"references,omitempty"`
	Parent           *ParentInfo              `json:"parent,omitempty"`
	Protection       any                      `json:"protection,omitempty"` // bool or ProtectionChange
	Namespace        string                   `json:"namespace"`
	DependsOn        []string                 `json:"depends_on,omitempty"`
}

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

type PortalPlanner interface {
	ResourcePlanner
}

type ProtectionChange struct {
	Old bool `json:"old"`
	New bool `json:"new"`
}

type ProtectionChangeConfig struct {
	ResourceType string
	ResourceName string
	ResourceRef  string
	ResourceID   string
	OldProtected bool
	NewProtected bool
	Namespace    string
}

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

type ProtectionSummary struct {
	Protecting   int `json:"protecting"`
	Unprotecting int `json:"unprotecting"`
}

type ReferenceInfo struct {
	// Existing fields for single references
	Ref          string            `json:"ref,omitempty"`
	ID           string            `json:"id,omitempty"`            // May be "[unknown]" for resources in same plan
	LookupFields map[string]string `json:"lookup_fields,omitempty"` // Resource-specific identifying fields

	// New fields for array references
	Refs         []string            `json:"refs,omitempty"`          // Array of reference strings
	ResolvedIDs  []string            `json:"resolved_ids,omitempty"`  // Array of resolved UUIDs
	LookupArrays map[string][]string `json:"lookup_arrays,omitempty"` // Array lookup fields
	IsArray      bool                `json:"is_array,omitempty"`      // Flag to indicate array reference
}

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

type ResolveResult struct {
	// Map of change_id -> field -> resolved reference
	ChangeReferences map[string]map[string]ResolvedReference
	// Errors encountered during resolution
	Errors []error
}

type ResolvedReference struct {
	Ref string
	ID  string
}

type ResourcePlanner interface {
	// PlanChanges is the main entry point for planning changes for a resource type
	PlanChanges(ctx context.Context, plannerCtx *Config, plan *Plan) error
}

type UpdateConfig struct {
	ResourceType    string
	ResourceName    string
	ResourceRef     string
	ResourceID      string
	CurrentFields   map[string]any
	DesiredFields   map[string]any
	CurrentLabels   map[string]string
	DesiredLabels   map[string]string
	RequiredFields  []string
	FieldComparator func(current, desired map[string]any) bool
	Namespace       string
	References      map[string]ReferenceInfo
}