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

package postgresflexalpha

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

	"github.com/hashicorp/terraform-plugin-framework/diag"
	"github.com/stackitcloud/stackit-sdk-go/core/oapierror"
	"github.com/stackitcloud/stackit-sdk-go/services/postgresflex/v3alpha1api"

	postgresflexalpha "tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/services/postgresflexalpha/user/resources_gen"
	postgresflexUtils "tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/services/postgresflexalpha/utils"
	postgresflexalphaWait "tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/wait/postgresflexalpha"

	"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"

	"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"
	"tf-provider.git.onstackit.cloud/stackit-dev-tools/terraform-provider-stackitprivatepreview/stackit/internal/utils"
)

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

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

// resourceModel represents the Terraform resource state for a PostgreSQL Flex user.
type resourceModel = postgresflexalpha.UserModel

// userResource implements the resource handling for a PostgreSQL Flex user.
type userResource struct {
	client       *v3alpha1api.APIClient
	providerData core.ProviderData
}

// ModifyPlan implements resource.ResourceWithModifyPlan.
// Use the modifier to set the effective region in the current plan.
func (r *userResource) 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 *userResource) Metadata(_ context.Context, req resource.MetadataRequest, resp *resource.MetadataResponse) {
	resp.TypeName = req.ProviderTypeName + "_postgresflexalpha_user"
}

// Configure adds the provider configured client to the resource.
func (r *userResource) 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 user client configured")
}

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

// Schema defines the schema for the resource.
func (r *userResource) Schema(ctx context.Context, _ resource.SchemaRequest, resp *resource.SchemaResponse) {
	s := postgresflexalpha.UserResourceSchema(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
}

func (r *userResource) ValidateConfig(
	ctx context.Context,
	req resource.ValidateConfigRequest,
	resp *resource.ValidateConfigResponse,
) {
	var data resourceModel

	resp.Diagnostics.Append(req.Config.Get(ctx, &data)...)
	if resp.Diagnostics.HasError() {
		return
	}

	var roles []string
	diags := data.Roles.ElementsAs(ctx, &roles, false)
	resp.Diagnostics.Append(diags...)
	if diags.HasError() {
		return
	}

	var resRoles []string
	for _, role := range roles {
		if slices.Contains(resRoles, role) {
			resp.Diagnostics.AddAttributeError(
				path.Root("roles"),
				"Attribute Configuration Error",
				"defined roles MUST NOT contain duplicates",
			)
			return
		}
		resRoles = append(resRoles, role)
	}
}

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

	ctx = core.InitProviderContext(ctx)

	arg := &clientArg{
		projectID:  model.ProjectId.ValueString(),
		instanceID: model.InstanceId.ValueString(),
		region:     r.providerData.GetRegionWithOverride(model.Region),
	}

	ctx = r.setTFLogFields(ctx, arg)

	var roles = r.expandRoles(ctx, model.Roles, &resp.Diagnostics)
	if resp.Diagnostics.HasError() {
		return
	}

	// Generate API request body from model
	payload, err := toCreatePayload(&model, roles)
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error creating user", fmt.Sprintf("Creating API payload: %v", err))
		return
	}

	// Create new user
	userResp, err := r.client.DefaultAPI.CreateUserRequest(
		ctx,
		arg.projectID,
		arg.region,
		arg.instanceID,
	).CreateUserRequestPayload(*payload).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error creating user", fmt.Sprintf("Calling API: %v", err))
		return
	}

	id, ok := userResp.GetIdOk()
	if !ok || *id == 0 {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"Error creating user",
			"API didn't return user Id. A user might have been created",
		)
		return
	}
	arg.userID = int64(*id)

	model.Id = utils.BuildInternalTerraformId(arg.projectID, arg.region, arg.instanceID, strconv.FormatInt(arg.userID, 10))

	ctx = tflog.SetField(ctx, "id", model.Id.ValueString())
	ctx = tflog.SetField(ctx, "user_id", id)

	ctx = core.LogResponse(ctx)

	model.Id = utils.BuildInternalTerraformId(arg.projectID, arg.region, arg.instanceID, strconv.FormatInt(arg.userID, 10))
	model.UserId = types.Int64Value(int64(*id))
	model.Password = types.StringValue(userResp.GetPassword())
	model.Status = types.StringValue(userResp.GetStatus())

	waitResp, err := postgresflexalphaWait.GetUserByIdWaitHandler(
		ctx,
		r.client.DefaultAPI,
		arg.projectID,
		arg.instanceID,
		arg.region,
		int64(*id),
	).SetSleepBeforeWait(
		10 * time.Second,
	).SetTimeout(
		15 * time.Minute,
	).WaitWithContext(ctx)

	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"create user",
			fmt.Sprintf("Instance creation waiting: %v", err),
		)
		return
	}

	if waitResp.Id == 0 {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"create user",
			"Instance creation waiting: returned id is nil",
		)
		return
	}
	if waitResp.Id != *id {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"create user",
			fmt.Sprintf(
				"Instance creation waiting: returned id is wrong: %+v - %+v",
				waitResp.Id,
				id,
			),
		)
		return
	}

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

// Read refreshes the Terraform state with the latest data.
func (r *userResource) 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)

	arg := &clientArg{
		projectID:  model.ProjectId.ValueString(),
		instanceID: model.InstanceId.ValueString(),
		region:     r.providerData.GetRegionWithOverride(model.Region),
	}

	ctx = r.setTFLogFields(ctx, arg)

	ctx = core.InitProviderContext(ctx)

	// Read resource state
	waitResp, err := postgresflexalphaWait.GetUserByIdWaitHandler(
		ctx,
		r.client.DefaultAPI,
		arg.projectID,
		arg.instanceID,
		arg.region,
		model.UserId.ValueInt64(),
	).SetSleepBeforeWait(
		10 * time.Second,
	).SetTimeout(
		15 * time.Minute,
	).WaitWithContext(ctx)

	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"read user",
			fmt.Sprintf("Instance creation waiting: %v", err),
		)
		return
	}

	if int64(waitResp.Id) != model.UserId.ValueInt64() {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"read user",
			"Instance creation waiting: returned id is nil or wrong",
		)
		return
	}
	arg.userID = int64(waitResp.Id)

	ctx = core.LogResponse(ctx)

	err = mapResourceFields(waitResp, &model, model.Region.ValueString())
	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"read user",
			fmt.Sprintf("Wait response mapping: %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 user read")
}

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

	ctx = core.InitProviderContext(ctx)

	arg := &clientArg{
		projectID:  model.ProjectId.ValueString(),
		instanceID: model.InstanceId.ValueString(),
		region:     r.providerData.GetRegionWithOverride(model.Region),
	}

	ctx = r.setTFLogFields(ctx, arg)
	ctx = core.InitProviderContext(ctx)

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

	var roles = r.expandRoles(ctx, model.Roles, &resp.Diagnostics)
	if resp.Diagnostics.HasError() {
		return
	}

	// Generate API request body from model
	payload, err := toUpdatePayload(&model, roles)
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error updating user", fmt.Sprintf("Updating API payload: %v", err))
		return
	}

	userID64 := arg.userID
	if userID64 > math.MaxInt32 {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error in type conversion", "int value too large (userId)")
		return
	}
	userID := int32(userID64) // nolint:gosec // check is performed above

	// Update existing instance
	err = r.client.DefaultAPI.UpdateUserRequest(
		ctx,
		arg.projectID,
		arg.region,
		arg.instanceID,
		userID,
	).UpdateUserRequestPayload(*payload).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error updating user", err.Error())
		return
	}

	ctx = core.LogResponse(ctx)

	// Verify update
	waitResp, err := postgresflexalphaWait.GetUserByIdWaitHandler(
		ctx,
		r.client.DefaultAPI,
		arg.projectID,
		arg.instanceID,
		arg.region,
		model.UserId.ValueInt64(),
	).SetSleepBeforeWait(
		10 * time.Second,
	).SetTimeout(
		15 * time.Minute,
	).WaitWithContext(ctx)

	if err != nil {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"read user",
			fmt.Sprintf("user update waiting: %v", err),
		)
		return
	}

	if int64(waitResp.Id) != model.UserId.ValueInt64() {
		core.LogAndAddError(
			ctx,
			&resp.Diagnostics,
			"update user",
			"User creation waiting: returned id is nil or wrong",
		)
		return
	}
	arg.userID = int64(waitResp.Id)

	// Set state to fully populated data
	diags = resp.State.Set(ctx, stateModel)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}
	tflog.Info(ctx, "Postgres Flex user updated")
}

// Delete deletes the resource and removes the Terraform state on success.
func (r *userResource) 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)

	arg := clientArg{
		projectID:  model.ProjectId.ValueString(),
		instanceID: model.InstanceId.ValueString(),
		region:     model.Region.ValueString(),
		userID:     model.UserId.ValueInt64(),
	}

	ctx = r.setTFLogFields(ctx, &arg)
	ctx = core.InitProviderContext(ctx)

	userID64 := arg.userID
	if userID64 > math.MaxInt32 {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error in type conversion", "int value too large (userId)")
		return
	}
	userID := int32(userID64) // nolint:gosec // check is performed above

	// Delete existing record set
	err := r.client.DefaultAPI.DeleteUserRequest(ctx, arg.projectID, arg.region, arg.instanceID, userID).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 user", fmt.Sprintf("error from API: %v", err))
	}

	ctx = core.LogResponse(ctx)

	// TODO: Verify deletion
	// exists, err := r.getUserResource(ctx, &model, arg)
	// if err != nil {
	//	core.LogAndAddError(ctx, &resp.Diagnostics, "Error deleting user", fmt.Sprintf("Calling API: %v", err))
	//	return
	//}
	// if exists {
	//	core.LogAndAddError(
	//		ctx, &resp.Diagnostics, "Error deleting user",
	//		fmt.Sprintf("User ID '%v' resource still exists after deletion", model.UserId.ValueInt32()),
	//	)
	//	return
	//}

	resp.State.RemoveResource(ctx)

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

// clientArg holds the arguments for API calls.
type clientArg struct {
	projectID  string
	instanceID string
	region     string
	userID     int64
}

// 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 *userResource) 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 user",
			fmt.Sprintf(
				"Expected import identifier with format [project_id],[region],[instance_id],[user_id], got %q",
				req.ID,
			),
		)
		return
	}

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

	idString := utils.BuildInternalTerraformId(idParts...)
	resp.Diagnostics.Append(resp.State.SetAttribute(ctx, path.Root("id"), idString)...)
	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("user_id"), userID)...)

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

// setTFLogFields adds relevant fields to the context for terraform logging purposes.
func (r *userResource) setTFLogFields(ctx context.Context, arg *clientArg) context.Context {
	ctx = tflog.SetField(ctx, "project_id", arg.projectID)
	ctx = tflog.SetField(ctx, "instance_id", arg.instanceID)
	ctx = tflog.SetField(ctx, "region", arg.region)
	ctx = tflog.SetField(ctx, "user_id", arg.userID)

	return ctx
}

// expandRoles converts a Terraform list of roles to a string slice.
func (r *userResource) expandRoles(ctx context.Context, rolesSet types.List, diags *diag.Diagnostics) []string {
	if rolesSet.IsNull() || rolesSet.IsUnknown() {
		return nil
	}
	var roles []string
	diags.Append(rolesSet.ElementsAs(ctx, &roles, false)...)
	slices.Sort(roles)
	return roles
}