backend

type ConfigInitializer interface {
	// InitConfigAndAuth loads Atmos config and authenticates the active
	// identity for component/stack, returning a ConfigAndStacksInfo carrying
	// the resulting AuthManager/AuthContext (via e.PropagateAuth).
	InitConfigAndAuth(component, stack, identity string) (*schema.AtmosConfiguration, *schema.ConfigAndStacksInfo, error)
	// DescribeComponent returns the real stack-configured component section
	// (including provision.targets) for component/stack, authenticated via
	// info's AuthManager.
	DescribeComponent(atmosConfig *schema.AtmosConfiguration, info *schema.ConfigAndStacksInfo, component, stack string) (map[string]any, error)
	// DescribeComponentStatic returns the component section for component/stack
	// without authenticating and without evaluating templates or YAML functions,
	// for dry runs that must make no AWS calls. It fails for a component or stack
	// that does not exist.
	DescribeComponentStatic(component, stack string) (map[string]any, error)
}

type CreateBackendParams struct {
	RequestedIdentity string
	AtmosConfig       *schema.AtmosConfiguration
	Component         string
	Stack             string
	ComponentConfig   map[string]any
	AuthContext       *schema.AuthContext
	Target            string
	// contains filtered or unexported fields
}

type DeleteBackendParams struct {
	CreateBackendParams
	Force bool
}

type DescribeBackendParams struct {
	CreateBackendParams
	Format string
}

type ListBackendsParams struct {
	RequestedIdentity string
	Stack             string
	AtmosConfig       *schema.AtmosConfiguration
	Component         string
	ComponentConfig   map[string]any
	AuthContext       *schema.AuthContext
	Format            string
}

type Provisioner interface {
	CreateBackend(ctx context.Context, params *CreateBackendParams) error
	DeleteBackend(ctx context.Context, params *DeleteBackendParams) error
	DescribeBackend(ctx context.Context, params *DescribeBackendParams) error
	ListBackends(ctx context.Context, params *ListBackendsParams) error
	// BackendExists reports whether the target bucket already exists — used by
	// create/update to decide whether a confirmation prompt is needed before
	// reconciling (and overwriting) an existing bucket's defaults.
	BackendExists(ctx context.Context, params *CreateBackendParams) (bool, error)
}