chore: Remove mail.send helpers with on-behalf-of header

.gitignore

@@ -6,3 +6,4 @@ coverage.txt
 sendgrid.env
 .vscode
 prism*
+**/.idea/**/*

USAGE.md

@@ -6000,20 +6000,20 @@ if err != nil {
 <a name="on-behalf-of"></a>
 # On-Behalf of Subuser
 
-The on-behalf-of header allows you to make calls for a particular subuser through the parent account; this can be useful for automating bulk updates or administering a subuser without changing authentication in your code.
-## With Mail Helper Class
+The `on-behalf-of` header allows you to make calls for a particular subuser through the parent account. This can be 
+useful for automating bulk updates or administering a subuser without changing authentication in your code.
 
-```go
-
-client := sendgrid.NewSendClientSubuser(os.Getenv("SENDGRID_API_KEY"), "SUBUSER_USERNAME")
-
-```
-
-## Without Mail Helper Class
+## Note
+The v3/mail/send endpoint does not support the `on-behalf-of` header. ([Source](
+    https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of-subuser
+))
 
 ```go
 
-request := sendgrid.GetRequestSubuser(os.Getenv("SENDGRID_API_KEY"), "/v3/mail/send", "https://api.sendgrid.com", "SUBUSER_USERNAME")
+request := sendgrid.GetRequestSubuser(
+	os.Getenv("SENDGRID_API_KEY"), "/v3/tracking_settings/subscription", 
+	"https://api.sendgrid.com", "SUBUSER_USERNAME",
+)
 
 ```
 

sendgrid.go

@@ -1,6 +1,8 @@
 package sendgrid
 
 import (
+	"strings"
+
 	"github.com/sendgrid/rest"
 )
 
@@ -21,6 +23,10 @@ func GetRequest(key, endpoint, host string) rest.Request {
 // GetRequestSubuser like GetRequest but with On-Behalf of Subuser
 // @return [Request] a default request object
 func GetRequestSubuser(key, endpoint, host, subuser string) rest.Request {
+	if strings.Contains(endpoint, "v3/mail/send") {
+		// TODO: Breaking change: Return an error instead of panicking
+		panic("cannot use on-behalf-of for v3/mail/send")
+	}
 	return createSendGridRequest(sendGridOptions{key, endpoint, host, subuser})
 }
 
@@ -47,11 +53,3 @@ func NewSendClient(key string) *Client {
 	request.Method = "POST"
 	return &Client{request}
 }
-
-// GetRequestSubuser like NewSendClient but with On-Behalf of Subuser
-// @return [Client]
-func NewSendClientSubuser(key, subuser string) *Client {
-	request := GetRequestSubuser(key, "/v3/mail/send", "", subuser)
-	request.Method = "POST"
-	return &Client{request}
-}

sendgrid_test.go

@@ -16,6 +16,7 @@ import (
 	"github.com/sendgrid/rest"
 	"github.com/sendgrid/sendgrid-go/helpers/mail"
 	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
 )
 
 func TestLicenseYear(t *testing.T) {
@@ -84,9 +85,21 @@ func TestGetRequestSubuser(t *testing.T) {
 	ShouldHaveHeaders(&request, t)
 }
 
-func TestNewSendClientSubuser(t *testing.T) {
-	client := NewSendClientSubuser("API_KEY", "subuserUsername")
-	ShouldHaveHeaders(&client.Request, t)
+func TestGetRequestSubUser_ShouldRejectMailSend(t *testing.T) {
+	// https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/on-behalf-of-subuser
+	// > The on-behalf-of header does not work with the mail.send API.
+
+	assertPanicked := func() {
+		rec := recover()
+		err, ok := rec.(string)
+		require.True(t, ok, "Recover should have returned error")
+		assert.NotEqual(t, "", err, "Should have panicked for /v3/mail/send")
+	}
+	defer assertPanicked()
+
+	_ = GetRequestSubuser(
+		"any API key", "/v3/mail/send", "https://example.com", "subuserUsername",
+	)
 }
 
 func getRequest(endpoint string) rest.Request {