terraform-provider-stackitprivatepreview/stackit/internal/services/postgresflexalpha/database/resource.go

package postgresflexalpha

import (
	"context"
	_ "embed"
	"fmt"
	"math"
	"strconv"
	"strings"
	"time"

	"github.com/hashicorp/terraform-plugin-framework/path"
	"github.com/hashicorp/terraform-plugin-framework/resource"
	"github.com/hashicorp/terraform-plugin-framework/types"
	"github.com/hashicorp/terraform-plugin-log/tflog"
	"github.com/stackitcloud/stackit-sdk-go/core/oapierror"
	"github.com/stackitcloud/stackit-sdk-go/services/postgresflex/v3alpha1api"

	"tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/conversion"
	"tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/core"
	postgresflexalphaResGen "tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/services/postgresflexalpha/database/resources_gen"
	postgresflexUtils "tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/services/postgresflexalpha/utils"
	"tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/utils"
	postgresflexalphaWait "tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/wait/postgresflexalpha"
)

var (
	// Ensure the implementation satisfies the expected interfaces.
	_ resource.Resource                = &databaseResource{}
	_ resource.ResourceWithConfigure   = &databaseResource{}
	_ resource.ResourceWithImportState = &databaseResource{}
	_ resource.ResourceWithModifyPlan  = &databaseResource{}
)

// NewDatabaseResource is a helper function to simplify the provider implementation.
func NewDatabaseResource() resource.Resource {
	return &databaseResource{}
}

// resourceModel describes the resource data model.
type resourceModel = postgresflexalphaResGen.DatabaseModel

// databaseResource is the resource implementation.
type databaseResource struct {
	client       *v3alpha1api.APIClient
	providerData core.ProviderData
}

// ModifyPlan adjusts the plan to set the correct region.
func (r *databaseResource) ModifyPlan(
	ctx context.Context,
	req resource.ModifyPlanRequest,
	resp *resource.ModifyPlanResponse,
) { // nolint:gocritic // function signature required by Terraform
	var configModel resourceModel
	// skip initial empty configuration to avoid follow-up errors
	if req.Config.Raw.IsNull() {
		return
	}
	resp.Diagnostics.Append(req.Config.Get(ctx, &configModel)...)
	if resp.Diagnostics.HasError() {
		return
	}

	var planModel resourceModel
	resp.Diagnostics.Append(req.Plan.Get(ctx, &planModel)...)
	if resp.Diagnostics.HasError() {
		return
	}

	utils.AdaptRegion(ctx, configModel.Region, &planModel.Region, r.providerData.GetRegion(), resp)
	if resp.Diagnostics.HasError() {
		return
	}

	resp.Diagnostics.Append(resp.Plan.Set(ctx, planModel)...)
	if resp.Diagnostics.HasError() {
		return
	}
}

// Metadata returns the resource type name.
func (r *databaseResource) Metadata(_ context.Context, req resource.MetadataRequest, resp *resource.MetadataResponse) {
	resp.TypeName = req.ProviderTypeName + "_postgresflexalpha_database"
}

// Configure adds the provider configured client to the resource.
func (r *databaseResource) Configure(
	ctx context.Context,
	req resource.ConfigureRequest,
	resp *resource.ConfigureResponse,
) {
	var ok bool
	r.providerData, ok = conversion.ParseProviderData(ctx, req.ProviderData, &resp.Diagnostics)
	if !ok {
		return
	}

	apiClient := postgresflexUtils.ConfigureClient(ctx, &r.providerData, &resp.Diagnostics)
	if resp.Diagnostics.HasError() {
		return
	}
	r.client = apiClient
	tflog.Info(ctx, "Postgres Flex database client configured")
}

//go:embed planModifiers.yaml
var modifiersFileByte []byte

// Schema defines the schema for the resource.
func (r *databaseResource) Schema(ctx context.Context, _ resource.SchemaRequest, resp *resource.SchemaResponse) {
	s := postgresflexalphaResGen.DatabaseResourceSchema(ctx)

	fields, err := utils.ReadModifiersConfig(modifiersFileByte)
	if err != nil {
		resp.Diagnostics.AddError("error during read modifiers config file", err.Error())
		return
	}

	err = utils.AddPlanModifiersToResourceSchema(fields, &s)
	if err != nil {
		resp.Diagnostics.AddError("error adding plan modifiers", err.Error())
		return
	}
	resp.Schema = s
}

// Create creates the resource and sets the initial Terraform state.
func (r *databaseResource) Create(
	ctx context.Context,
	req resource.CreateRequest,
	resp *resource.CreateResponse,
) { // nolint:gocritic // function signature required by Terraform
	const funcErrorSummary = "[database CREATE] error"
	var model resourceModel
	diags := req.Plan.Get(ctx, &model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}

	ctx = core.InitProviderContext(ctx)

	projectID := model.ProjectId.ValueString()
	region := model.Region.ValueString()
	instanceID := model.InstanceId.ValueString()

	ctx = tflog.SetField(ctx, "project_id", projectID)
	ctx = tflog.SetField(ctx, "instance_id", instanceID)
	ctx = tflog.SetField(ctx, "region", region)

	// Generate API request body from model
	payload, err := toCreatePayload(&model)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			funcErrorSummary,
			fmt.Sprintf("Creating API payload: %v", err),
		)
		return
	}
	// Create new database
	databaseResp, err := r.client.DefaultAPI.CreateDatabaseRequest(
		ctx,
		projectID,
		region,
		instanceID,
	).CreateDatabaseRequestPayload(*payload).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, funcErrorSummary, fmt.Sprintf("Calling API: %v", err))
		return
	}

	dbID, ok := databaseResp.GetIdOk()
	if !ok {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			funcErrorSummary,
			"API didn't return database Id. A database might although have been created",
		)
		return
	}
	databaseID := int64(*dbID)
	databaseIDString := strconv.Itoa(int(*dbID))

	ctx = tflog.SetField(ctx, "database_id", databaseID)
	ctx = core.LogResponse(ctx)

	model.DatabaseId = types.Int64Value(databaseID)
	model.Id = utils.BuildInternalTerraformId(projectID, region, instanceID, databaseIDString)

	// Set data returned by API in id
	resp.Diagnostics.Append(
		resp.State.SetAttribute(
			ctx,
			path.Root("database_id"),
			databaseID,
		)...,
	)
	// Set data returned by API in id
	resp.Diagnostics.Append(
		resp.State.SetAttribute(
			ctx,
			path.Root("id"),
			model.Id,
		)...,
	)

	database, err := postgresflexalphaWait.GetDatabaseByIdWaitHandler(ctx, r.client.DefaultAPI, projectID, instanceID, region, databaseID).
		SetTimeout(15 * time.Minute).
		SetSleepBeforeWait(15 * time.Second).
		WaitWithContext(ctx)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			funcErrorSummary,
			fmt.Sprintf("Getting database details after creation: %v", err),
		)
		return
	}

	// Map response body to schema
	err = mapResourceFields(database, &model)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			funcErrorSummary,
			fmt.Sprintf("map resource fields: %v", err),
		)
		return
	}

	// Set state to fully populated data
	resp.Diagnostics.Append(resp.State.Set(ctx, model)...)
	if resp.Diagnostics.HasError() {
		return
	}
	tflog.Info(ctx, "Postgres Flex database created")
}

// Read refreshes the Terraform state with the latest data.
func (r *databaseResource) Read(
	ctx context.Context,
	req resource.ReadRequest,
	resp *resource.ReadResponse,
) { // nolint:gocritic // function signature required by Terraform
	var model resourceModel
	diags := req.State.Get(ctx, &model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}

	ctx = core.InitProviderContext(ctx)

	projectID := model.ProjectId.ValueString()
	instanceID := model.InstanceId.ValueString()
	region := model.Region.ValueString()
	databaseID := model.DatabaseId.ValueInt64()

	databaseIDString := strconv.Itoa(int(databaseID))

	ctx = tflog.SetField(ctx, "project_id", projectID)
	ctx = tflog.SetField(ctx, "instance_id", instanceID)
	ctx = tflog.SetField(ctx, "region", region)
	ctx = tflog.SetField(ctx, "database_id", databaseID)

	// Set data returned by API in id
	resp.Diagnostics.Append(
		resp.State.SetAttribute(
			ctx,
			path.Root("id"),
			utils.BuildInternalTerraformId(projectID, region, instanceID, databaseIDString),
		)...,
	)

	databaseResp, err := postgresflexalphaWait.GetDatabaseByIdWaitHandler(ctx, r.client.DefaultAPI, projectID, instanceID, region, databaseID).
		SetTimeout(15 * time.Minute).
		SetSleepBeforeWait(15 * time.Second).
		WaitWithContext(ctx)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"Error creating database",
			fmt.Sprintf("Getting database details after creation: %v", err),
		)
		return
	}

	ctx = core.LogResponse(ctx)

	// Map response body to schema
	err = mapResourceFields(databaseResp, &model)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"Error reading database",
			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, "Postgres Flex database read")
}

// Update updates the resource and sets the updated Terraform state on success.
func (r *databaseResource) Update(
	ctx context.Context,
	req resource.UpdateRequest,
	resp *resource.UpdateResponse,
) {
	var model resourceModel
	diags := req.Plan.Get(ctx, &model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}

	ctx = core.InitProviderContext(ctx)

	projectId := model.ProjectId.ValueString()
	instanceId := model.InstanceId.ValueString()
	region := model.Region.ValueString()
	databaseId := model.DatabaseId.ValueInt64()

	ctx = tflog.SetField(ctx, "project_id", projectId)
	ctx = tflog.SetField(ctx, "instance_id", instanceId)
	ctx = tflog.SetField(ctx, "region", region)
	ctx = tflog.SetField(ctx, "database_id", databaseId)

	// Retrieve values from state
	var stateModel resourceModel
	diags = req.State.Get(ctx, &stateModel)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}

	modified := false
	var payload v3alpha1api.UpdateDatabasePartiallyRequestPayload
	if stateModel.Name != model.Name {
		payload.Name = model.Name.ValueStringPointer()
		modified = true
	}

	if stateModel.Owner != model.Owner {
		payload.Owner = model.Owner.ValueStringPointer()
		modified = true
	}

	if !modified {
		tflog.Info(ctx, "no modification detected")
		return
	}

	if databaseId > math.MaxInt32 {
		core.LogAndAddError(ctx, &resp.Diagnostics, "error updating database", "databaseID out of bounds for int32")
		return
	}
	databaseID32 := int32(databaseId) //nolint:gosec // TODO
	// Update existing database
	err := r.client.DefaultAPI.UpdateDatabasePartiallyRequest(
		ctx,
		projectId,
		region,
		instanceId,
		databaseID32,
	).UpdateDatabasePartiallyRequestPayload(payload).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "error updating database", err.Error())
		return
	}

	ctx = core.LogResponse(ctx)

	databaseResp, err := postgresflexalphaWait.GetDatabaseByIdWaitHandler(ctx, r.client.DefaultAPI, projectId, instanceId, region, databaseId).
		SetTimeout(15 * time.Minute).
		SetSleepBeforeWait(15 * time.Second).
		WaitWithContext(ctx)
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "error updating database", err.Error())
		return
	}

	ctx = core.LogResponse(ctx)

	// Map response body to schema
	err = mapResourceFields(databaseResp, &model)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"Error reading database",
			fmt.Sprintf("Processing API payload: %v", err),
		)
		return
	}

	// Set state to fully populated data
	resp.Diagnostics.Append(resp.State.Set(ctx, &model)...)
	if resp.Diagnostics.HasError() {
		return
	}
	tflog.Info(ctx, "Postgres Flex database updated")
}

// Delete deletes the resource and removes the Terraform state on success.
func (r *databaseResource) Delete(
	ctx context.Context,
	req resource.DeleteRequest,
	resp *resource.DeleteResponse,
) { // nolint:gocritic // function signature required by Terraform
	var model resourceModel
	diags := req.State.Get(ctx, &model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}

	ctx = core.InitProviderContext(ctx)

	projectID := model.ProjectId.ValueString()
	instanceID := model.InstanceId.ValueString()
	region := model.Region.ValueString()
	databaseID64 := model.DatabaseId.ValueInt64()

	if databaseID64 > math.MaxInt32 {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error in type conversion", "int value too large (databaseId)")
		return
	}
	databaseID := int32(databaseID64) // nolint:gosec // check is performed above
	ctx = tflog.SetField(ctx, "project_id", projectID)
	ctx = tflog.SetField(ctx, "instance_id", instanceID)
	ctx = tflog.SetField(ctx, "region", region)
	ctx = tflog.SetField(ctx, "database_id", databaseID)

	// Delete existing record set
	err := r.client.DefaultAPI.DeleteDatabaseRequest(ctx, projectID, region, instanceID, databaseID).Execute()
	if err != nil {
		oapiErr, ok := err.(*oapierror.GenericOpenAPIError) // nolint:errorlint //complaining that error.As should be used to catch wrapped errors, but this error should not be wrapped
		if ok {
			if oapiErr.StatusCode == 404 {
				resp.State.RemoveResource(ctx)
				return
			}
		}
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error deleting database", fmt.Sprintf("Calling API: %v", err))
	}

	ctx = core.LogResponse(ctx)

	tflog.Info(ctx, "Postgres Flex database deleted")
}

// ImportState imports a resource into the Terraform state on success.
// The expected import identifier format is: [project_id],[region],[instance_id],[database_id]
func (r *databaseResource) ImportState(
	ctx context.Context,
	req resource.ImportStateRequest,
	resp *resource.ImportStateResponse,
) {
	ctx = core.InitProviderContext(ctx)
	idParts := strings.Split(req.ID, core.Separator)

	if len(idParts) != 4 || idParts[0] == "" || idParts[1] == "" || idParts[2] == "" || idParts[3] == "" {
		core.LogAndAddError(
			ctx, &resp.Diagnostics,
			"Error importing database",
			fmt.Sprintf(
				"Expected import identifier with format [project_id],[region],[instance_id],[database_id], got %q",
				req.ID,
			),
		)
		return
	}

	databaseID, err := strconv.ParseInt(idParts[3], 10, 64)
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"Error importing database",
			fmt.Sprintf("Invalid database_id format: %q. It must be a valid integer.", idParts[3]),
		)
		return
	}

	tfIDString := utils.BuildInternalTerraformId(idParts...).ValueString()
	resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("id"), tfIDString)...)
	resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("project_id"), idParts[0])...)
	resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("region"), idParts[1])...)
	resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("instance_id"), idParts[2])...)
	resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("database_id"), databaseID)...)

	core.LogAndAddWarning(
		ctx,
		&resp.Diagnostics,
		"Postgresflex database imported with empty password",
		"The database password is not imported as it is only available upon creation of a new database. The password field will be empty.",
	)

	tflog.Info(ctx, "Postgres Flex database state imported")
}