feat: add meshstack_location resource

Author: grubmeshi

CHANGELOG.md

@@ -1,3 +1,9 @@
+## Unreleased
+
+FEATURES:
+
+- New resource: `meshstack_location` for managing meshStack locations.
+
 ## v0.16.3
 
 FIXES:

client/client.go

@@ -40,6 +40,7 @@ type endpoints struct {
 	Platforms              *url.URL `json:"meshplatforms"`
 	PaymentMethods         *url.URL `json:"meshpaymentmethods"`
 	Integrations           *url.URL `json:"meshintegrations"`
+	Locations              *url.URL `json:"meshlocations"`
 }
 
 type loginRequest struct {
@@ -78,6 +79,7 @@ func NewClient(rootUrl *url.URL, apiKey string, apiSecret string) (*MeshStackPro
 		Platforms:              rootUrl.JoinPath(apiMeshObjectsRoot, "meshplatforms"),
 		PaymentMethods:         rootUrl.JoinPath(apiMeshObjectsRoot, "meshpaymentmethods"),
 		Integrations:           rootUrl.JoinPath(apiMeshObjectsRoot, "meshintegrations"),
+		Locations:              rootUrl.JoinPath(apiMeshObjectsRoot, "meshlocations"),
 	}
 
 	return client, nil

client/location.go

@@ -0,0 +1,169 @@
+package client
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"net/url"
+)
+
+const CONTENT_TYPE_LOCATION = "application/vnd.meshcloud.api.meshlocation.v1-preview.hal+json"
+
+type MeshLocation struct {
+	ApiVersion string               `json:"apiVersion" tfsdk:"api_version"`
+	Kind       string               `json:"kind" tfsdk:"kind"`
+	Metadata   MeshLocationMetadata `json:"metadata" tfsdk:"metadata"`
+	Spec       MeshLocationSpec     `json:"spec" tfsdk:"spec"`
+}
+
+type MeshLocationMetadata struct {
+	Name      string `json:"name" tfsdk:"name"`
+	CreatedOn string `json:"createdOn" tfsdk:"created_on"`
+}
+
+type MeshLocationSpec struct {
+	DisplayName string `json:"displayName" tfsdk:"display_name"`
+}
+
+type MeshLocationCreate struct {
+	ApiVersion string                     `json:"apiVersion" tfsdk:"api_version"`
+	Metadata   MeshLocationCreateMetadata `json:"metadata" tfsdk:"metadata"`
+	Spec       MeshLocationSpec           `json:"spec" tfsdk:"spec"`
+}
+
+type MeshLocationCreateMetadata struct {
+	Name string `json:"name" tfsdk:"name"`
+}
+
+func (c *MeshStackProviderClient) urlForLocation(identifier string) *url.URL {
+	return c.endpoints.Locations.JoinPath(identifier)
+}
+
+func (c *MeshStackProviderClient) ReadLocation(identifier string) (*MeshLocation, error) {
+	targetUrl := c.urlForLocation(identifier)
+
+	req, err := http.NewRequest("GET", targetUrl.String(), nil)
+	if err != nil {
+		return nil, err
+	}
+	req.Header.Set("Accept", CONTENT_TYPE_LOCATION)
+
+	res, err := c.doAuthenticatedRequest(req)
+	if err != nil {
+		return nil, err
+	}
+
+	defer func() {
+		_ = res.Body.Close()
+	}()
+
+	if res.StatusCode == http.StatusNotFound {
+		return nil, nil
+	}
+
+	data, err := io.ReadAll(res.Body)
+	if err != nil {
+		return nil, err
+	}
+
+	if !isSuccessHTTPStatus(res) {
+		return nil, fmt.Errorf("unexpected status code: %d, %s", res.StatusCode, data)
+	}
+
+	var location MeshLocation
+	err = json.Unmarshal(data, &location)
+	if err != nil {
+		return nil, err
+	}
+
+	return &location, nil
+}
+
+func (c *MeshStackProviderClient) CreateLocation(location *MeshLocationCreate) (*MeshLocation, error) {
+	payload, err := json.Marshal(location)
+	if err != nil {
+		return nil, err
+	}
+
+	req, err := http.NewRequest("POST", c.endpoints.Locations.String(), bytes.NewBuffer(payload))
+	if err != nil {
+		return nil, err
+	}
+	req.Header.Set("Content-Type", CONTENT_TYPE_LOCATION)
+	req.Header.Set("Accept", CONTENT_TYPE_LOCATION)
+
+	res, err := c.doAuthenticatedRequest(req)
+	if err != nil {
+		return nil, err
+	}
+
+	defer func() {
+		_ = res.Body.Close()
+	}()
+
+	data, err := io.ReadAll(res.Body)
+	if err != nil {
+		return nil, err
+	}
+
+	if !isSuccessHTTPStatus(res) {
+		return nil, fmt.Errorf("unexpected status code: %d, %s", res.StatusCode, data)
+	}
+
+	var createdLocation MeshLocation
+	err = json.Unmarshal(data, &createdLocation)
+	if err != nil {
+		return nil, err
+	}
+
+	return &createdLocation, nil
+}
+
+func (c *MeshStackProviderClient) UpdateLocation(identifier string, location *MeshLocationCreate) (*MeshLocation, error) {
+	targetUrl := c.urlForLocation(identifier)
+
+	payload, err := json.Marshal(location)
+	if err != nil {
+		return nil, err
+	}
+
+	req, err := http.NewRequest("PUT", targetUrl.String(), bytes.NewBuffer(payload))
+	if err != nil {
+		return nil, err
+	}
+	req.Header.Set("Content-Type", CONTENT_TYPE_LOCATION)
+	req.Header.Set("Accept", CONTENT_TYPE_LOCATION)
+
+	res, err := c.doAuthenticatedRequest(req)
+	if err != nil {
+		return nil, err
+	}
+
+	defer func() {
+		_ = res.Body.Close()
+	}()
+
+	data, err := io.ReadAll(res.Body)
+	if err != nil {
+		return nil, err
+	}
+
+	if !isSuccessHTTPStatus(res) {
+		return nil, fmt.Errorf("unexpected status code: %d, %s", res.StatusCode, data)
+	}
+
+	var updatedLocation MeshLocation
+	err = json.Unmarshal(data, &updatedLocation)
+	if err != nil {
+		return nil, err
+	}
+
+	return &updatedLocation, nil
+}
+
+func (c *MeshStackProviderClient) DeleteLocation(identifier string) error {
+	targetUrl := c.urlForLocation(identifier)
+	return c.deleteMeshObject(*targetUrl, 204)
+}

docs/resources/location.md

@@ -0,0 +1,65 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "meshstack_location Resource - terraform-provider-meshstack"
+subcategory: ""
+description: |-
+  Represents a meshStack location.
+---
+
+# meshstack_location (Resource)
+
+Represents a meshStack location.
+
+## Example Usage
+
+```terraform
+resource "meshstack_location" "example" {
+  metadata = {
+    name = "my-location"
+  }
+
+  spec = {
+    display_name = "My Cloud Location"
+  }
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `metadata` (Attributes) (see [below for nested schema](#nestedatt--metadata))
+- `spec` (Attributes) (see [below for nested schema](#nestedatt--spec))
+
+### Read-Only
+
+- `api_version` (String) Location datatype version
+- `kind` (String) meshObject type, always `meshLocation`.
+
+<a id="nestedatt--metadata"></a>
+### Nested Schema for `metadata`
+
+Required:
+
+- `name` (String) Location identifier. Must be unique across all locations.
+
+Read-Only:
+
+- `created_on` (String) Creation timestamp of the location (server-generated).
+
+
+<a id="nestedatt--spec"></a>
+### Nested Schema for `spec`
+
+Required:
+
+- `display_name` (String) The human-readable display name of the location.
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+terraform import meshstack_location.example my-location-identifier
+```

examples/resources/meshstack_location/import.sh

@@ -0,0 +1 @@
+terraform import meshstack_location.example my-location-identifier

examples/resources/meshstack_location/resource.tf

@@ -0,0 +1,9 @@
+resource "meshstack_location" "example" {
+  metadata = {
+    name = "my-location"
+  }
+
+  spec = {
+    display_name = "My Cloud Location"
+  }
+}