sdk

type ApplyResult struct {
	Message string         `json:"message,omitempty"`
	State   map[string]any `json:"state,omitempty"`
	Error   string         `json:"error,omitempty"`
}

type CheckResult struct {
	// NeedsChange must be true if the system is NOT yet in the desired state
	// (i.e., Apply should be called). Return false when the system is already
	// in the desired state and no action is required.
	NeedsChange bool           `json:"needs_change"`
	Message     string         `json:"message,omitempty"`
	State       map[string]any `json:"state,omitempty"`
	Error       string         `json:"error,omitempty"`
}

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

type DiscoveredPlugin struct {
	Name   string
	Path   string
	Source string
}

type DiscoveryOptions struct {
	BinaryDir           string
	WorkingDir          string
	PreferredDirs       []string
	DisableFallbackDirs bool
}

type Module interface {
	// Name returns the module's canonical name (e.g. "my-module").
	Name() string
	// Version returns the module's semantic version.
	Version() string
	// Check reports whether the system is already in the desired state.
	// NeedsChange must be true if the system is NOT yet in the desired state
	// (i.e., Apply should be called). Return false when no change is required.
	Check(args map[string]any) (CheckResult, error)
	// Apply brings the system into the desired state.
	Apply(args map[string]any) (ApplyResult, error)
}

type OutputFunc func(line string)

type PluginStatus struct {
	Name         string
	Path         string
	Source       string
	Version      string
	Initialized  bool
	ErrorMessage string
}

type StreamingModule interface {
	Module
	CheckStreaming(args map[string]any, out OutputFunc) (CheckResult, error)
	ApplyStreaming(args map[string]any, out OutputFunc) (ApplyResult, error)
}