resource.go

package secretsmanager

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

	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/utils"

	secretsmanagerUtils "github.com/stackitcloud/terraform-provider-stackit/stackit/internal/services/secretsmanager/utils"

	"github.com/hashicorp/terraform-plugin-framework-validators/setvalidator"
	"github.com/hashicorp/terraform-plugin-framework-validators/stringvalidator"
	"github.com/hashicorp/terraform-plugin-framework/attr"
	"github.com/hashicorp/terraform-plugin-framework/schema/validator"
	"github.com/hashicorp/terraform-plugin-log/tflog"
	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/conversion"
	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/core"
	"github.com/stackitcloud/terraform-provider-stackit/stackit/internal/validate"

	"github.com/hashicorp/terraform-plugin-framework/resource"
	"github.com/hashicorp/terraform-plugin-framework/resource/schema"
	"github.com/hashicorp/terraform-plugin-framework/resource/schema/planmodifier"
	"github.com/hashicorp/terraform-plugin-framework/resource/schema/stringplanmodifier"
	"github.com/hashicorp/terraform-plugin-framework/types"
	"github.com/stackitcloud/stackit-sdk-go/core/oapierror"
	sdkUtils "github.com/stackitcloud/stackit-sdk-go/core/utils"
	"github.com/stackitcloud/stackit-sdk-go/services/secretsmanager"
)

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

type Model struct {
	Id         types.String `tfsdk:"id"` // needed by TF
	InstanceId types.String `tfsdk:"instance_id"`
	ProjectId  types.String `tfsdk:"project_id"`
	Name       types.String `tfsdk:"name"`
	ACLs       types.Set    `tfsdk:"acls"`
	KmsKey     *KmsKeyModel `tfsdk:"kms_key"`
}

type KmsKeyModel struct {
	KeyId               types.String `tfsdk:"key_id"`
	KeyRingId           types.String `tfsdk:"key_ring_id"`
	KeyVersion          types.Int64  `tfsdk:"key_version"`
	ServiceAccountEmail types.String `tfsdk:"service_account_email"`
}

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

// instanceResource is the resource implementation.
type instanceResource struct {
	client *secretsmanager.APIClient
}

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

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

	apiClient := secretsmanagerUtils.ConfigureClient(ctx, &providerData, &resp.Diagnostics)
	if resp.Diagnostics.HasError() {
		return
	}
	r.client = apiClient
	tflog.Info(ctx, "Secrets Manager instance client configured")
}

// Schema defines the schema for the resource.
func (r *instanceResource) Schema(_ context.Context, _ resource.SchemaRequest, resp *resource.SchemaResponse) {
	descriptions := map[string]string{
		"main":                          "Secrets Manager instance resource schema. Must have a `region` specified in the provider configuration.",
		"id":                            "Terraform's internal resource ID. It is structured as \"`project_id`,`instance_id`\".",
		"instance_id":                   "ID of the Secrets Manager instance.",
		"project_id":                    "STACKIT project ID to which the instance is associated.",
		"name":                          "Instance name.",
		"acls":                          "The access control list for this instance. Each entry is an IP or IP range that is permitted to access, in CIDR notation",
		"kms_key":                       "The STACKIT-KMS key for secret encryption and decryption.",
		"kms_key.key_id":                "UUID of the key within the STACKIT-KMS to use for the encryption.",
		"kms_key.key_ring_id":           "UUID of the keyring where the key is located within the STACKTI-KMS.",
		"kms_key.key_version":           "Version of the key within the STACKIT-KMS to use for the encryption.",
		"kms_key.service_account_email": "Service-Account linked to the Key within the STACKIT-KMS.",
	}

	resp.Schema = schema.Schema{
		Description: descriptions["main"],
		Attributes: map[string]schema.Attribute{
			"id": schema.StringAttribute{
				Description: descriptions["id"],
				Computed:    true,
				PlanModifiers: []planmodifier.String{
					stringplanmodifier.UseStateForUnknown(),
				},
			},
			"instance_id": schema.StringAttribute{
				Description: descriptions["instance_id"],
				Computed:    true,
				PlanModifiers: []planmodifier.String{
					stringplanmodifier.UseStateForUnknown(),
				},
				Validators: []validator.String{
					validate.UUID(),
					validate.NoSeparator(),
				},
			},
			"project_id": schema.StringAttribute{
				Description: descriptions["project_id"],
				Required:    true,
				PlanModifiers: []planmodifier.String{
					stringplanmodifier.RequiresReplace(),
				},
				Validators: []validator.String{
					validate.UUID(),
					validate.NoSeparator(),
				},
			},
			"name": schema.StringAttribute{
				Description:   descriptions["name"],
				Required:      true,
				PlanModifiers: []planmodifier.String{},
				Validators: []validator.String{
					stringvalidator.LengthAtLeast(1),
				},
			},
			"acls": schema.SetAttribute{
				Description: descriptions["acls"],
				ElementType: types.StringType,
				Optional:    true,
				Validators: []validator.Set{
					setvalidator.ValueStringsAre(
						validate.CIDR(),
					),
				},
			},
			"kms_key": schema.SingleNestedAttribute{
				Description: descriptions["kms_key"],
				Optional:    true,
				Attributes: map[string]schema.Attribute{
					"key_id": schema.StringAttribute{
						Description: descriptions["kms_key.key_id"],
						Required:    true,
					},
					"key_ring_id": schema.StringAttribute{
						Description: descriptions["kms_key.key_ring_id"],
						Required:    true,
					},
					"key_version": schema.Int64Attribute{
						Description: descriptions["kms_key.key_version"],
						Required:    true,
					},
					"service_account_email": schema.StringAttribute{
						Description: descriptions["kms_key.service_account_email"],
						Required:    true,
					},
				},
			},
		},
	}
}

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

	ctx = core.InitProviderContext(ctx)

	projectId := model.ProjectId.ValueString()
	ctx = tflog.SetField(ctx, "project_id", projectId)

	var acls []string
	if !(model.ACLs.IsNull() || model.ACLs.IsUnknown()) {
		diags = model.ACLs.ElementsAs(ctx, &acls, false)
		resp.Diagnostics.Append(diags...)
		if resp.Diagnostics.HasError() {
			return
		}
	}

	// Generate API request body from model
	payload, err := toCreatePayload(&model)
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error creating instance", fmt.Sprintf("Creating API payload: %v", err))
		return
	}
	// Create new instance
	createResp, err := r.client.CreateInstance(ctx, projectId).CreateInstancePayload(*payload).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error creating instance", fmt.Sprintf("Calling API: %v", err))
		return
	}

	ctx = core.LogResponse(ctx)

	if createResp.Id == nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error creating instance", "Got empty instance id")
		return
	}
	instanceId := *createResp.Id
	ctx = utils.SetAndLogStateFields(ctx, &resp.Diagnostics, &resp.State, map[string]any{
		"project_id":  projectId,
		"instance_id": instanceId,
	})

	// Create ACLs
	err = updateACLs(ctx, projectId, instanceId, acls, r.client)
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error creating instance", fmt.Sprintf("Creating ACLs: %v", err))
		return
	}
	aclList, err := r.client.ListACLs(ctx, projectId, instanceId).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error creating instance", fmt.Sprintf("Calling API for ACLs data: %v", err))
		return
	}

	// Map response body to schema
	err = mapFields(createResp, aclList, &model)
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error creating instance", fmt.Sprintf("Processing API payload: %v", err))
		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, "Secrets Manager instance created")
}

// Read refreshes the Terraform state with the latest data.
func (r *instanceResource) Read(ctx context.Context, req resource.ReadRequest, resp *resource.ReadResponse) { // nolint:gocritic // function signature required by Terraform
	var model Model
	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()
	ctx = tflog.SetField(ctx, "project_id", projectId)
	ctx = tflog.SetField(ctx, "instance_id", instanceId)

	instanceResp, err := r.client.GetInstance(ctx, projectId, instanceId).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 && oapiErr.StatusCode == http.StatusNotFound {
			resp.State.RemoveResource(ctx)
			return
		}
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error reading instance", fmt.Sprintf("Calling API: %v", err))
		return
	}

	ctx = core.LogResponse(ctx)

	aclList, err := r.client.ListACLs(ctx, projectId, instanceId).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error reading instance", fmt.Sprintf("Calling API for ACLs data: %v", err))
		return
	}

	// Map response body to schema
	err = mapFields(instanceResp, aclList, &model)
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error reading instance", 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, "Secrets Manager instance read")
}

// Update updates the resource and sets the updated Terraform state on success.
func (r *instanceResource) Update(ctx context.Context, req resource.UpdateRequest, resp *resource.UpdateResponse) { // nolint:gocritic // function signature required by Terraform
	var model Model
	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()
	ctx = tflog.SetField(ctx, "project_id", projectId)
	ctx = tflog.SetField(ctx, "instance_id", instanceId)

	// Generate API request body from model
	payload, err := toUpdatePayload(&model)
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error updating instance", fmt.Sprintf("Creating API payload: %v", err))
		return
	}
	// Update instance
	err = r.client.UpdateInstance(ctx, projectId, instanceId).UpdateInstancePayload(*payload).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error updating instance", fmt.Sprintf("Calling API: %v", err))
		return
	}

	ctx = core.LogResponse(ctx)

	var acls []string
	if !(model.ACLs.IsNull() || model.ACLs.IsUnknown()) {
		diags = model.ACLs.ElementsAs(ctx, &acls, false)
		resp.Diagnostics.Append(diags...)
		if resp.Diagnostics.HasError() {
			return
		}
	}

	// Update ACLs
	err = updateACLs(ctx, projectId, instanceId, acls, r.client)
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error updating instance", fmt.Sprintf("Updating ACLs: %v", err))
		return
	}

	instanceResp, err := r.client.GetInstance(ctx, projectId, instanceId).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error updating instance acl", fmt.Sprintf("Calling API: %v", err))
		return
	}

	ctx = core.LogResponse(ctx)

	aclList, err := r.client.ListACLs(ctx, projectId, instanceId).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error updating instance", fmt.Sprintf("Calling API for ACLs data: %v", err))
		return
	}

	// Map response body to schema
	err = mapFields(instanceResp, aclList, &model)
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error updating instance", fmt.Sprintf("Processing API payload: %v", err))
		return
	}

	diags = resp.State.Set(ctx, model)
	resp.Diagnostics.Append(diags...)
	if resp.Diagnostics.HasError() {
		return
	}
	tflog.Info(ctx, "Secrets Manager instance updated")
}

// Delete deletes the resource and removes the Terraform state on success.
func (r *instanceResource) Delete(ctx context.Context, req resource.DeleteRequest, resp *resource.DeleteResponse) { // nolint:gocritic // function signature required by Terraform
	// Retrieve values from state
	var model Model
	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()
	ctx = tflog.SetField(ctx, "project_id", projectId)
	ctx = tflog.SetField(ctx, "instance_id", instanceId)

	// Delete existing instance
	err := r.client.DeleteInstance(ctx, projectId, instanceId).Execute()
	if err != nil {
		core.LogAndAddError(ctx, &resp.Diagnostics, "Error deleting instance", fmt.Sprintf("Calling API: %v", err))
		return
	}

	ctx = core.LogResponse(ctx)

	tflog.Info(ctx, "Secrets Manager instance deleted")
}

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

	if len(idParts) != 2 || idParts[0] == "" || idParts[1] == "" {
		core.LogAndAddError(ctx, &resp.Diagnostics,
			"Error importing instance",
			fmt.Sprintf("Expected import identifier with format: [project_id],[instance_id]  Got: %q", req.ID),
		)
		return
	}
	ctx = utils.SetAndLogStateFields(ctx, &resp.Diagnostics, &resp.State, map[string]any{
		"project_id":  idParts[0],
		"instance_id": idParts[1],
	})
	tflog.Info(ctx, "Secrets Manager instance state imported")
}

func mapFields(instance *secretsmanager.Instance, aclList *secretsmanager.ListACLsResponse, model *Model) error {
	if instance == nil {
		return fmt.Errorf("response input is nil")
	}
	if model == nil {
		return fmt.Errorf("model input is nil")
	}

	var instanceId string
	if model.InstanceId.ValueString() != "" {
		instanceId = model.InstanceId.ValueString()
	} else if instance.Id != nil {
		instanceId = *instance.Id
	} else {
		return fmt.Errorf("instance id not present")
	}

	model.Id = utils.BuildInternalTerraformId(model.ProjectId.ValueString(), instanceId)
	model.InstanceId = types.StringValue(instanceId)
	model.Name = types.StringPointerValue(instance.Name)

	if instance.KmsKey != nil {
		model.KmsKey = &KmsKeyModel{
			KeyId:               types.StringPointerValue(instance.KmsKey.KeyId),
			KeyRingId:           types.StringPointerValue(instance.KmsKey.KeyRingId),
			KeyVersion:          types.Int64PointerValue(instance.KmsKey.KeyVersion),
			ServiceAccountEmail: types.StringPointerValue(instance.KmsKey.ServiceAccountEmail),
		}
	}

	err := mapACLs(aclList, model)
	if err != nil {
		return err
	}

	return nil
}

func mapACLs(aclList *secretsmanager.ListACLsResponse, model *Model) error {
	if aclList == nil {
		return fmt.Errorf("nil ACL list")
	}
	if aclList.Acls == nil || len(*aclList.Acls) == 0 {
		model.ACLs = types.SetNull(types.StringType)
		return nil
	}

	acls := []attr.Value{}
	for _, acl := range *aclList.Acls {
		acls = append(acls, types.StringValue(*acl.Cidr))
	}
	aclsList, diags := types.SetValue(types.StringType, acls)
	if diags.HasError() {
		return fmt.Errorf("mapping ACLs: %w", core.DiagsToError(diags))
	}
	model.ACLs = aclsList
	return nil
}

func toCreatePayload(model *Model) (*secretsmanager.CreateInstancePayload, error) {
	if model == nil {
		return nil, fmt.Errorf("nil model")
	}
	payload := &secretsmanager.CreateInstancePayload{
		Name: conversion.StringValueToPointer(model.Name),
	}

	if model.KmsKey != nil {
		payload.KmsKey = &secretsmanager.KmsKeyPayload{
			KeyId:               conversion.StringValueToPointer(model.KmsKey.KeyId),
			KeyRingId:           conversion.StringValueToPointer(model.KmsKey.KeyRingId),
			KeyVersion:          conversion.Int64ValueToPointer(model.KmsKey.KeyVersion),
			ServiceAccountEmail: conversion.StringValueToPointer(model.KmsKey.ServiceAccountEmail),
		}
	}

	return payload, nil
}

func toUpdatePayload(model *Model) (*secretsmanager.UpdateInstancePayload, error) {
	if model == nil {
		return nil, fmt.Errorf("nil model")
	}

	payload := &secretsmanager.UpdateInstancePayload{
		Name: conversion.StringValueToPointer(model.Name),
	}

	if model.KmsKey != nil {
		payload.KmsKey = &secretsmanager.KmsKeyPayload{
			KeyId:               conversion.StringValueToPointer(model.KmsKey.KeyId),
			KeyRingId:           conversion.StringValueToPointer(model.KmsKey.KeyRingId),
			KeyVersion:          conversion.Int64ValueToPointer(model.KmsKey.KeyVersion),
			ServiceAccountEmail: conversion.StringValueToPointer(model.KmsKey.ServiceAccountEmail),
		}
	}

	return payload, nil
}

// updateACLs creates and deletes ACLs so that the instance's ACLs are the ones in the model
func updateACLs(ctx context.Context, projectId, instanceId string, acls []string, client *secretsmanager.APIClient) error {
	// Get ACLs current state
	currentACLsResp, err := client.ListACLs(ctx, projectId, instanceId).Execute()
	if err != nil {
		return fmt.Errorf("fetching current ACLs: %w", err)
	}

	type aclState struct {
		isInModel bool
		isCreated bool
		id        string
	}
	aclsState := make(map[string]*aclState)
	for _, cidr := range acls {
		aclsState[cidr] = &aclState{
			isInModel: true,
		}
	}
	for _, acl := range *currentACLsResp.Acls {
		cidr := *acl.Cidr
		if _, ok := aclsState[cidr]; !ok {
			aclsState[cidr] = &aclState{}
		}
		aclsState[cidr].isCreated = true
		aclsState[cidr].id = *acl.Id
	}

	// Create/delete ACLs
	for cidr, state := range aclsState {
		if state.isInModel && !state.isCreated {
			payload := secretsmanager.CreateACLPayload{
				Cidr: sdkUtils.Ptr(cidr),
			}
			_, err := client.CreateACL(ctx, projectId, instanceId).CreateACLPayload(payload).Execute()
			if err != nil {
				return fmt.Errorf("creating ACL '%v': %w", cidr, err)
			}
		}

		if !state.isInModel && state.isCreated {
			err := client.DeleteACL(ctx, projectId, instanceId, state.id).Execute()
			if err != nil {
				return fmt.Errorf("deleting ACL '%v': %w", cidr, err)
			}
		}
	}

	return nil
}