PLAT-7380 Add singlestoredb_user resource and singlestoredb_users datasource (#57)

* PLAT-7380 Add singlestoredb_user resource and singlestoredb_users datasource

* Add search by email. Update docs.

* Refactor user resource to handle send/revoke invitation and remove user

* Update documantation

* Fix docs

Author: oyeliseiev-ua

docs/data-sources/user.md

@@ -0,0 +1,44 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "singlestoredb_user Data Source - terraform-provider-singlestoredb"
+subcategory: ""
+description: |-
+  Retrieve a specific user using its ID or email with this data source.
+---
+
+# singlestoredb_user (Data Source)
+
+Retrieve a specific user using its ID or email with this data source.
+
+## Example Usage
+
+```terraform
+provider "singlestoredb" {
+  // The SingleStoreDB Terraform provider uses the SINGLESTOREDB_API_KEY environment variable for authentication. 
+  // Please set this environment variable with your SingleStore Management API key.
+  // You can generate this key from the SingleStore Portal at https://portal.singlestore.com/organizations/org-id/api-keys.
+}
+
+data "singlestoredb_user" "this" {
+  id = "9e481f02-7e4c-478a-98b9-df2c712bed4c" # Replace with the actual ID of the user.
+}
+
+output "this_user" {
+  value = data.singlestoredb_user.this
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- `email` (String) The email address of the user.
+- `id` (String) The unique identifier of the user.
+
+### Read-Only
+
+- `first_name` (String) The first name of the user.
+- `last_name` (String) The last name of the user.
+
+

docs/data-sources/users.md

@@ -0,0 +1,51 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "singlestoredb_users Data Source - terraform-provider-singlestoredb"
+subcategory: ""
+description: |-
+  This data source provides a list of users that the current user has access to.
+---
+
+# singlestoredb_users (Data Source)
+
+This data source provides a list of users that the current user has access to.
+
+## Example Usage
+
+```terraform
+provider "singlestoredb" {
+  // The SingleStoreDB Terraform provider uses the SINGLESTOREDB_API_KEY environment variable for authentication. 
+  // Please set this environment variable with your SingleStore Management API key.
+  // You can generate this key from the SingleStore Portal at https://portal.singlestore.com/organizations/org-id/api-keys.
+}
+
+data "singlestoredb_users" "all" {
+}
+
+output "all_users" {
+  value = data.singlestoredb_users.all
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+- `users` (Attributes List) (see [below for nested schema](#nestedatt--users))
+
+<a id="nestedatt--users"></a>
+### Nested Schema for `users`
+
+Optional:
+
+- `email` (String) The email address of the user.
+- `id` (String) The unique identifier of the user.
+
+Read-Only:
+
+- `first_name` (String) The first name of the user.
+- `last_name` (String) The last name of the user.
+
+

docs/resources/user.md

@@ -0,0 +1,49 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "singlestoredb_user Resource - terraform-provider-singlestoredb"
+subcategory: ""
+description: |-
+  The 'apply' action sends a user an invitation to join the organization. The 'destroy' action removes a user from the organization and revokes their pending invitation(s). The 'update' action is not supported for this resource.
+---
+
+# singlestoredb_user (Resource)
+
+The 'apply' action sends a user an invitation to join the organization. The 'destroy' action removes a user from the organization and revokes their pending invitation(s). The 'update' action is not supported for this resource.
+
+## Example Usage
+
+```terraform
+provider "singlestoredb" {
+  // The SingleStoreDB Terraform provider uses the SINGLESTOREDB_API_KEY environment variable for authentication. 
+  // Please set this environment variable with your SingleStore Management API key.
+  // You can generate this key from the SingleStore Portal at https://portal.singlestore.com/organizations/org-id/api-keys.
+}
+
+resource "singlestoredb_user" "this" {
+  email = "[email protected]"
+}
+
+output "singlestoredb_user_this" {
+  value = singlestoredb_user.this
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `email` (String) The email address of the user.
+
+### Optional
+
+- `teams` (List of String) A list of user teams associated with the invitation.
+
+### Read-Only
+
+- `created_at` (String) The timestamp when the invitation was created, in ISO 8601 format.
+- `id` (String) The unique identifier of the invitation.
+- `state` (String) The state of the invitation. Possible values are Pending, Accepted, Refused, or Revoked.
+- `user_id` (String) The unique identifier of the user. It is set when the user accepts the invitation.
+
+

examples/data-sources/singlestoredb_user/data-source.tf

@@ -0,0 +1,13 @@
+provider "singlestoredb" {
+  // The SingleStoreDB Terraform provider uses the SINGLESTOREDB_API_KEY environment variable for authentication. 
+  // Please set this environment variable with your SingleStore Management API key.
+  // You can generate this key from the SingleStore Portal at https://portal.singlestore.com/organizations/org-id/api-keys.
+}
+
+data "singlestoredb_user" "this" {
+  id = "9e481f02-7e4c-478a-98b9-df2c712bed4c" # Replace with the actual ID of the user.
+}
+
+output "this_user" {
+  value = data.singlestoredb_user.this
+}

examples/data-sources/singlestoredb_users/data-source.tf

@@ -0,0 +1,12 @@
+provider "singlestoredb" {
+  // The SingleStoreDB Terraform provider uses the SINGLESTOREDB_API_KEY environment variable for authentication. 
+  // Please set this environment variable with your SingleStore Management API key.
+  // You can generate this key from the SingleStore Portal at https://portal.singlestore.com/organizations/org-id/api-keys.
+}
+
+data "singlestoredb_users" "all" {
+}
+
+output "all_users" {
+  value = data.singlestoredb_users.all
+}

examples/embed.go

@@ -20,6 +20,9 @@ var (
 	WorkspacesGetDataSource          = mustRead("data-sources/singlestoredb_workspace/data-source.tf")
 	WorkspaceGroupsResource          = mustRead("resources/singlestoredb_workspace_group/resource.tf")
 	WorkspacesResource               = mustRead("resources/singlestoredb_workspace/resource.tf")
+	UserGetDataSource                = mustRead("data-sources/singlestoredb_user/data-source.tf")
+	UserResource                     = mustRead("resources/singlestoredb_user/resource.tf")
+	UserListDataSource               = mustRead("data-sources/singlestoredb_users/data-source.tf")
 	InvitationsGetDataSource         = mustRead("data-sources/singlestoredb_invitation/data-source.tf")
 	InvitationsListDataSource        = mustRead("data-sources/singlestoredb_invitations/data-source.tf")
 )

examples/resources/singlestoredb_user/resource.tf

@@ -0,0 +1,13 @@
+provider "singlestoredb" {
+  // The SingleStoreDB Terraform provider uses the SINGLESTOREDB_API_KEY environment variable for authentication. 
+  // Please set this environment variable with your SingleStore Management API key.
+  // You can generate this key from the SingleStore Portal at https://portal.singlestore.com/organizations/org-id/api-keys.
+}
+
+resource "singlestoredb_user" "this" {
+  email = "[email protected]"
+}
+
+output "singlestoredb_user_this" {
+  value = singlestoredb_user.this
+}

internal/provider/privateconnections/resource_test.go

@@ -292,7 +292,7 @@ func TestCRUDPrivateConnection(t *testing.T) {
 			},
 			{
 				Config: testutil.UpdatableConfig(examples.PrivateConnectionsResource).
-					WitPrivateConnectionResource("this")("allow_list", cty.StringVal(updateAllowedList)).
+					WithPrivateConnectionResource("this")("allow_list", cty.StringVal(updateAllowedList)).
 					String(),
 				Check: resource.ComposeAggregateTestCheckFunc(
 					resource.TestCheckResourceAttr("singlestoredb_private_connection.this", config.IDAttribute, privateConnectionID.String()),
@@ -348,7 +348,7 @@ func TestPrivateConnectionResourceIntegration(t *testing.T) {
 			},
 			{
 				Config: testutil.UpdatableConfig(examples.PrivateConnectionsResource).
-					WitPrivateConnectionResource("this")("allow_list", cty.StringVal(updateAllowedList)).
+					WithPrivateConnectionResource("this")("allow_list", cty.StringVal(updateAllowedList)).
 					String(),
 				Check: resource.ComposeAggregateTestCheckFunc(
 					resource.TestCheckResourceAttrSet("singlestoredb_private_connection.this", config.IDAttribute),

internal/provider/provider.go

@@ -18,6 +18,7 @@ import (
 	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/privateconnections"
 	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/regions"
 	regions_v2 "github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/regionsv2"
+	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/users"
 	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/util"
 	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/workspacegroups"
 	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/workspaces"
@@ -163,6 +164,8 @@ func (p *singlestoreProvider) DataSources(_ context.Context) []func() datasource
 		workspaces.NewDataSourceGet,
 		privateconnections.NewDataSourceList,
 		privateconnections.NewDataSourceGet,
+		users.NewDataSourceGet,
+		users.NewDataSourceList,
 		invitations.NewDataSourceList,
 		invitations.NewDataSourceGet,
 	}
@@ -174,6 +177,7 @@ func (p *singlestoreProvider) Resources(_ context.Context) []func() resource.Res
 		workspacegroups.NewResource,
 		workspaces.NewResource,
 		privateconnections.NewResource,
+		users.NewResource,
 	}
 }
 

internal/provider/testutil/updatableconfig.go

@@ -9,6 +9,7 @@ import (
 	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/config"
 	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/invitations"
 	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/privateconnections"
+	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/users"
 	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/workspacegroups"
 	"github.com/singlestore-labs/terraform-provider-singlestoredb/internal/provider/workspaces"
 	"github.com/zclconf/go-cty/cty"
@@ -29,6 +30,14 @@ func (uc UpdatableConfig) WithPrivateConnectionListDataSource(privateConnectionL
 	return withAttribute(uc, config.DataSourceTypeName, []string{dataSourceTypeName(privateconnections.DataSourceListName), privateConnectionListName})
 }
 
+func (uc UpdatableConfig) WithUserGetDataSource(userName string) AttributeSetter {
+	return withAttribute(uc, config.DataSourceTypeName, []string{dataSourceTypeName(users.DataSourceGetName), userName})
+}
+
+func (uc UpdatableConfig) WithUserListDataSource(userListName string) AttributeSetter {
+	return withAttribute(uc, config.DataSourceTypeName, []string{dataSourceTypeName(users.DataSourceListName), userListName})
+}
+
 func (uc UpdatableConfig) WithWorkspaceGroupGetDataSource(workspaceGroupName string) AttributeSetter {
 	return withAttribute(uc, config.DataSourceTypeName, []string{dataSourceTypeName(workspacegroups.DataSourceGetName), workspaceGroupName})
 }
@@ -49,10 +58,14 @@ func (uc UpdatableConfig) WithWorkspaceGroupResource(workspaceGroupName string)
 	return withAttribute(uc, config.ResourceTypeName, []string{resourceTypeName(workspacegroups.ResourceName), workspaceGroupName})
 }
 
-func (uc UpdatableConfig) WitPrivateConnectionResource(privateConnectionName string) AttributeSetter {
+func (uc UpdatableConfig) WithPrivateConnectionResource(privateConnectionName string) AttributeSetter {
 	return withAttribute(uc, config.ResourceTypeName, []string{resourceTypeName(privateconnections.ResourceName), privateConnectionName})
 }
 
+func (uc UpdatableConfig) WithUserResource(userName string) AttributeSetter {
+	return withAttribute(uc, config.ResourceTypeName, []string{resourceTypeName(users.ResourceName), userName})
+}
+
 func (uc UpdatableConfig) WithInvitationGetDataSource(invitationName string) AttributeSetter {
 	return withAttribute(uc, config.DataSourceTypeName, []string{dataSourceTypeName(invitations.DataSourceGetName), invitationName})
 }