datasource.go

package server

import (
	"context"
	"fmt"
	"net/http"
	"time"

	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/conversion"
	iaasUtils "github.com/stackitcloud/terraform-provider-stackit/stackit/internal/services/iaas/utils"

	"github.com/hashicorp/terraform-plugin-framework/attr"
	"github.com/hashicorp/terraform-plugin-framework/datasource"
	"github.com/hashicorp/terraform-plugin-framework/datasource/schema"
	"github.com/hashicorp/terraform-plugin-framework/schema/validator"
	"github.com/hashicorp/terraform-plugin-framework/types"
	"github.com/hashicorp/terraform-plugin-framework/types/basetypes"
	"github.com/hashicorp/terraform-plugin-log/tflog"
	"github.com/stackitcloud/stackit-sdk-go/services/iaas"
	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/core"
	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/utils"
	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/validate"
)

// Ensure the implementation satisfies the expected interfaces.
var (
	_ datasource.DataSource = &serverDataSource{}
)

type DataSourceModel struct {
	Id                types.String `tfsdk:"id"` // needed by TF
	ProjectId         types.String `tfsdk:"project_id"`
	Region            types.String `tfsdk:"region"`
	ServerId          types.String `tfsdk:"server_id"`
	MachineType       types.String `tfsdk:"machine_type"`
	Name              types.String `tfsdk:"name"`
	Agent             types.Object `tfsdk:"agent"`
	AvailabilityZone  types.String `tfsdk:"availability_zone"`
	BootVolume        types.Object `tfsdk:"boot_volume"`
	ImageId           types.String `tfsdk:"image_id"`
	NetworkInterfaces types.List   `tfsdk:"network_interfaces"`
	KeypairName       types.String `tfsdk:"keypair_name"`
	Labels            types.Map    `tfsdk:"labels"`
	AffinityGroup     types.String `tfsdk:"affinity_group"`
	UserData          types.String `tfsdk:"user_data"`
	CreatedAt         types.String `tfsdk:"created_at"`
	LaunchedAt        types.String `tfsdk:"launched_at"`
	UpdatedAt         types.String `tfsdk:"updated_at"`
}

var bootVolumeDataTypes = map[string]attr.Type{
	"id":                    basetypes.StringType{},
	"delete_on_termination": basetypes.BoolType{},
}

var agentDataTypes = map[string]attr.Type{
	"provisioned": basetypes.BoolType{},
}

// NewServerDataSource is a helper function to simplify the provider implementation.
func NewServerDataSource() datasource.DataSource {
	return &serverDataSource{}
}

// serverDataSource is the data source implementation.
type serverDataSource struct {
	client       *iaas.APIClient
	providerData core.ProviderData
}

// Metadata returns the data source type name.
func (d *serverDataSource) Metadata(_ context.Context, req datasource.MetadataRequest, resp *datasource.MetadataResponse) {
	resp.TypeName = req.ProviderTypeName + "_server"
}

func (d *serverDataSource) Configure(ctx context.Context, req datasource.ConfigureRequest, resp *datasource.ConfigureResponse) {
	var ok bool
	d.providerData, ok = conversion.ParseProviderData(ctx, req.ProviderData, &resp.Diagnostics)
	if !ok {
		return
	}

	apiClient := iaasUtils.ConfigureClient(ctx, &d.providerData, &resp.Diagnostics)
	if resp.Diagnostics.HasError() {
		return
	}
	d.client = apiClient
	tflog.Info(ctx, "iaas client configured")
}

// Schema defines the schema for the datasource.
func (d *serverDataSource) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
	description := "Server datasource schema. Must have a `region` specified in the provider configuration."
	resp.Schema = schema.Schema{
		MarkdownDescription: description,
		Description:         description,
		Attributes: map[string]schema.Attribute{
			"id": schema.StringAttribute{
				Description: "Terraform's internal resource ID. It is structured as \"`project_id`,`region`,`server_id`\".",
				Computed:    true,
			},
			"project_id": schema.StringAttribute{
				Description: "STACKIT project ID to which the server is associated.",
				Required:    true,
				Validators: []validator.String{
					validate.UUID(),
					validate.NoSeparator(),
				},
			},
			"region": schema.StringAttribute{
				Description: "The resource region. If not defined, the provider region is used.",
				// the region cannot be found, so it has to be passed
				Optional: true,
			},
			"server_id": schema.StringAttribute{
				Description: "The server ID.",
				Required:    true,
				Validators: []validator.String{
					validate.UUID(),
					validate.NoSeparator(),
				},
			},
			"name": schema.StringAttribute{
				Description: "The name of the server.",
				Computed:    true,
			},
			"machine_type": schema.StringAttribute{
				MarkdownDescription: "Name of the type of the machine for the server. Possible values are documented in [Virtual machine flavors](https://docs.stackit.cloud/products/compute-engine/server/basics/machine-types/)",
				Computed:            true,
			},
			"agent": schema.SingleNestedAttribute{
				Description: "STACKIT Server Agent as setup on the server",
				Computed:    true,
				Attributes: map[string]schema.Attribute{
					"provisioned": schema.BoolAttribute{
						Description: "Whether a STACKIT Server Agent is provisioned at the server",
						Computed:    true,
					},
				},
			},
			"availability_zone": schema.StringAttribute{
				Description: "The availability zone of the server.",
				Computed:    true,
			},
			"boot_volume": schema.SingleNestedAttribute{
				Description: "The boot volume for the server",
				Computed:    true,
				Attributes: map[string]schema.Attribute{
					"id": schema.StringAttribute{
						Description: "The ID of the boot volume",
						Computed:    true,
					},
					"delete_on_termination": schema.BoolAttribute{
						Description: "Delete the volume during the termination of the server.",
						Computed:    true,
					},
				},
			},
			"image_id": schema.StringAttribute{
				Description: "The image ID to be used for an ephemeral disk on the server.",
				Computed:    true,
			},
			"network_interfaces": schema.ListAttribute{
				Description: "The IDs of network interfaces which should be attached to the server. Updating it will recreate the server.",
				Computed:    true,
				ElementType: types.StringType,
			},
			"keypair_name": schema.StringAttribute{
				Description: "The name of the keypair used during server creation.",
				Computed:    true,
			},
			"labels": schema.MapAttribute{
				Description: "Labels are key-value string pairs which can be attached to a resource container",
				ElementType: types.StringType,
				Computed:    true,
			},
			"affinity_group": schema.StringAttribute{
				Description: "The affinity group the server is assigned to.",
				Computed:    true,
			},
			"user_data": schema.StringAttribute{
				Description: "User data that is passed via cloud-init to the server.",
				Computed:    true,
			},
			"created_at": schema.StringAttribute{
				Description: "Date-time when the server was created",
				Computed:    true,
			},
			"launched_at": schema.StringAttribute{
				Description: "Date-time when the server was launched",
				Computed:    true,
			},
			"updated_at": schema.StringAttribute{
				Description: "Date-time when the server was updated",
				Computed:    true,
			},
		},
	}
}

// Read refreshes the Terraform state with the latest data.
func (d *serverDataSource) Read(ctx context.Context, req datasource.ReadRequest, resp *datasource.ReadResponse) { // nolint:gocritic // function signature required by Terraform
	var model DataSourceModel
	diags := req.Config.Get(ctx, &model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}
	projectId := model.ProjectId.ValueString()
	region := d.providerData.GetRegionWithOverride(model.Region)
	serverId := model.ServerId.ValueString()

	ctx = core.InitProviderContext(ctx)

	ctx = tflog.SetField(ctx, "project_id", projectId)
	ctx = tflog.SetField(ctx, "region", region)
	ctx = tflog.SetField(ctx, "server_id", serverId)

	serverReq := d.client.GetServer(ctx, projectId, region, serverId)
	serverReq = serverReq.Details(true)
	serverResp, err := serverReq.Execute()
	if err != nil {
		utils.LogError(
			ctx,
			&resp.Diagnostics,
			err,
			"Reading server",
			fmt.Sprintf("Server with ID %q does not exist in project %q.", serverId, projectId),
			map[int]string{
				http.StatusForbidden: fmt.Sprintf("Project with ID %q not found or forbidden access", projectId),
			},
		)
		resp.State.RemoveResource(ctx)
		return
	}

	ctx = core.LogResponse(ctx)

	// Map response body to schema
	err = mapDataSourceFields(ctx, serverResp, &model, region)
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error reading server", fmt.Sprintf("Processing API payload: %v", err))
		return
	}
	// Set refreshed state
	diags = resp.State.Set(ctx, model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}
	tflog.Info(ctx, "server read")
}

func mapDataSourceFields(ctx context.Context, serverResp *iaas.Server, model *DataSourceModel, region string) error {
	if serverResp == nil {
		return fmt.Errorf("response input is nil")
	}
	if model == nil {
		return fmt.Errorf("model input is nil")
	}

	var serverId string
	if model.ServerId.ValueString() != "" {
		serverId = model.ServerId.ValueString()
	} else if serverResp.Id != nil {
		serverId = *serverResp.Id
	} else {
		return fmt.Errorf("server id not present")
	}

	model.Id = utils.BuildInternalTerraformId(model.ProjectId.ValueString(), region, serverId)
	model.Region = types.StringValue(region)

	labels, err := iaasUtils.MapLabels(ctx, serverResp.Labels, model.Labels)
	if err != nil {
		return err
	}

	var createdAt basetypes.StringValue
	if serverResp.CreatedAt != nil {
		createdAtValue := *serverResp.CreatedAt
		createdAt = types.StringValue(createdAtValue.Format(time.RFC3339))
	}
	var updatedAt basetypes.StringValue
	if serverResp.UpdatedAt != nil {
		updatedAtValue := *serverResp.UpdatedAt
		updatedAt = types.StringValue(updatedAtValue.Format(time.RFC3339))
	}
	var launchedAt basetypes.StringValue
	if serverResp.LaunchedAt != nil {
		launchedAtValue := *serverResp.LaunchedAt
		launchedAt = types.StringValue(launchedAtValue.Format(time.RFC3339))
	}
	if serverResp.Nics != nil {
		var respNics []string
		for _, nic := range *serverResp.Nics {
			respNics = append(respNics, *nic.NicId)
		}
		nicTF, diags := types.ListValueFrom(ctx, types.StringType, respNics)
		if diags.HasError() {
			return fmt.Errorf("failed to map networkInterfaces: %w", core.DiagsToError(diags))
		}

		model.NetworkInterfaces = nicTF
	} else {
		model.NetworkInterfaces = types.ListNull(types.StringType)
	}

	if serverResp.BootVolume != nil {
		bootVolume, diags := types.ObjectValue(bootVolumeDataTypes, map[string]attr.Value{
			"id":                    types.StringPointerValue(serverResp.BootVolume.Id),
			"delete_on_termination": types.BoolPointerValue(serverResp.BootVolume.DeleteOnTermination),
		})
		if diags.HasError() {
			return fmt.Errorf("failed to map bootVolume: %w", core.DiagsToError(diags))
		}
		model.BootVolume = bootVolume
	} else {
		model.BootVolume = types.ObjectNull(bootVolumeDataTypes)
	}

	if serverResp.Agent != nil {
		agent, diags := types.ObjectValue(agentDataTypes, map[string]attr.Value{
			"provisioned": types.BoolPointerValue(serverResp.Agent.Provisioned),
		})
		if diags.HasError() {
			return fmt.Errorf("failed to map agent: %w", core.DiagsToError(diags))
		}
		model.Agent = agent
	} else {
		model.Agent = types.ObjectNull(agentDataTypes)
	}

	if serverResp.UserData != nil && len(*serverResp.UserData) > 0 {
		model.UserData = types.StringValue(string(*serverResp.UserData))
	}

	model.AvailabilityZone = types.StringPointerValue(serverResp.AvailabilityZone)
	model.ServerId = types.StringValue(serverId)
	model.MachineType = types.StringPointerValue(serverResp.MachineType)

	model.Name = types.StringPointerValue(serverResp.Name)
	model.Labels = labels
	model.ImageId = types.StringPointerValue(serverResp.ImageId)
	model.KeypairName = types.StringPointerValue(serverResp.KeypairName)
	model.AffinityGroup = types.StringPointerValue(serverResp.AffinityGroup)
	model.CreatedAt = createdAt
	model.UpdatedAt = updatedAt
	model.LaunchedAt = launchedAt

	return nil
}