chore: Adds SDK Preview (#2713)

* add client

* SDK update GHA

* simulate Preview update

* example of use for Admin Preview

* Revert "example of use for Admin Preview"

This reverts commit c5edef5.

* rename adminPreview to adminpreview in client

* example of use of SDK Preview

* reverse example

* go mod tidy

Author: lantoli

go.mod

@@ -19,6 +19,7 @@ require (
 	github.com/hashicorp/terraform-plugin-sdk/v2 v2.34.0
 	github.com/hashicorp/terraform-plugin-testing v1.9.0
 	github.com/mongodb-forks/digest v1.1.0
+	github.com/mongodb/atlas-sdk-go v1.0.1-0.20241018094808-b267c50bd90c
 	github.com/spf13/cast v1.6.0
 	github.com/stretchr/testify v1.9.0
 	github.com/zclconf/go-cty v1.15.0

go.sum

@@ -635,6 +635,8 @@ github.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx
 github.com/mmcloughlin/avo v0.5.0/go.mod h1:ChHFdoV7ql95Wi7vuq2YT1bwCJqiWdZrQ1im3VujLYM=
 github.com/mongodb-forks/digest v1.1.0 h1:7eUdsR1BtqLv0mdNm4OXs6ddWvR4X2/OsLwdKksrOoc=
 github.com/mongodb-forks/digest v1.1.0/go.mod h1:rb+EX8zotClD5Dj4NdgxnJXG9nwrlx3NWKJ8xttz1Dg=
+github.com/mongodb/atlas-sdk-go v1.0.1-0.20241018094808-b267c50bd90c h1:O+gTwkWGmepbF1i4IyF0A+i8URWxCxC0DHQWrkRaYWQ=
+github.com/mongodb/atlas-sdk-go v1.0.1-0.20241018094808-b267c50bd90c/go.mod h1:CE0qO1AJFrP9ajK/KnRUwKzoPKVoqAmZVFnsofvTwRE=
 github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e/go.mod h1:zD1mROLANZcx1PVRCS0qkT7pwLkGfwJo4zjcN/Tysno=
 github.com/nxadm/tail v1.4.4/go.mod h1:kenIhsEOeOJmVchQTgglprH7qJGnHDVpk1VPCcaMI8A=
 github.com/nxadm/tail v1.4.8/go.mod h1:+ncqLTQzXmGhMZNUePPaPqPvBxHAIsmXswZKocGu+AU=

internal/config/client.go

@@ -9,6 +9,7 @@ import (
 	"strings"
 	"time"
 
+	adminpreview "github.com/mongodb/atlas-sdk-go/admin"
 	admin20240530 "go.mongodb.org/atlas-sdk/v20240530005/admin"
 	"go.mongodb.org/atlas-sdk/v20240805005/admin"
 	matlasClient "go.mongodb.org/atlas/mongodbatlas"
@@ -32,6 +33,7 @@ type MongoDBClient struct {
 	Atlas           *matlasClient.Client
 	AtlasV2         *admin.APIClient
 	AtlasV220240530 *admin20240530.APIClient // used in advanced_cluster and cloud_backup_schedule for avoiding breaking changes
+	AtlasPreview    *adminpreview.APIClient  // used for preview features, don't use in resources exposed in the provider list
 	Config          *Config
 }
 
@@ -110,13 +112,18 @@ func (c *Config) NewClient(ctx context.Context) (any, error) {
 		return nil, err
 	}
 
+	sdkPreviewClient, err := c.newSDKPreviewClient(client)
+	if err != nil {
+		return nil, err
+	}
+
 	clients := &MongoDBClient{
 		Atlas:           atlasClient,
 		AtlasV2:         sdkV2Client,
 		AtlasV220240530: sdkV220240530Client,
+		AtlasPreview:    sdkPreviewClient,
 		Config:          c,
 	}
-
 	return clients, nil
 }
 
@@ -127,13 +134,11 @@ func (c *Config) newSDKV2Client(client *http.Client) (*admin.APIClient, error) {
 		admin.UseBaseURL(c.BaseURL),
 		admin.UseDebug(false)}
 
-	// Initialize the MongoDB Versioned Atlas Client.
-	sdkv2, err := admin.NewClient(opts...)
+	sdk, err := admin.NewClient(opts...)
 	if err != nil {
 		return nil, err
 	}
-
-	return sdkv2, nil
+	return sdk, nil
 }
 
 func (c *Config) newSDKV220240530Client(client *http.Client) (*admin20240530.APIClient, error) {
@@ -143,13 +148,25 @@ func (c *Config) newSDKV220240530Client(client *http.Client) (*admin20240530.API
 		admin20240530.UseBaseURL(c.BaseURL),
 		admin20240530.UseDebug(false)}
 
-	// Initialize the MongoDB Versioned Atlas Client.
-	sdkv2, err := admin20240530.NewClient(opts...)
+	sdk, err := admin20240530.NewClient(opts...)
 	if err != nil {
 		return nil, err
 	}
+	return sdk, nil
+}
+
+func (c *Config) newSDKPreviewClient(client *http.Client) (*adminpreview.APIClient, error) {
+	opts := []adminpreview.ClientModifier{
+		adminpreview.UseHTTPClient(client),
+		adminpreview.UseUserAgent(userAgent(c)),
+		adminpreview.UseBaseURL(c.BaseURL),
+		adminpreview.UseDebug(false)}
 
-	return sdkv2, nil
+	sdk, err := adminpreview.NewClient(opts...)
+	if err != nil {
+		return nil, err
+	}
+	return sdk, nil
 }
 
 func (c *MongoDBClient) GetRealmClient(ctx context.Context) (*realm.Client, error) {

scripts/update-sdk.sh

@@ -31,5 +31,9 @@ echo "LATEST_SDK_RELEASE: $LATEST_SDK_RELEASE"
 echo  "==> Updating SDK ${CURRENT_SDK_RELEASE} to latest major version ${LATEST_SDK_TAG}"
 
 gomajor get --rewrite "go.mongodb.org/atlas-sdk/${CURRENT_SDK_RELEASE}" "go.mongodb.org/atlas-sdk/${LATEST_SDK_RELEASE}@${LATEST_SDK_TAG}"
+
+echo "==> Updating SDK Preview version"
+go get github.com/mongodb/atlas-sdk-go@preview-latest
+
 go mod tidy
 echo "Done"