Add missing sub statuses: gold, role_based_accept_all, alternate, mx_forward, blocked, allowed

- Added SS_GOLD, SS_ROLE_BASED_ACCEPT_ALL, SS_ALTERNATE, SS_MX_FORWARD, SS_BLOCKED, SS_ALLOWED constants
- Added test cases for gold and role_based_accept_all sub statuses
- Added mock responses for gold@example.com and role_based_accept_all@example.com
- Added standalone test functions TestResponseSubStatusGold and TestResponseSubStatusRoleBasedAcceptAll
- Added API usage tracking fields for alternate, blocked, allowed, and gold sub statuses
- Added test assertions for new API usage fields
- Ensures 100% parity with Python SDK sub status support

Author: franciscbalint

api.go

@@ -116,6 +116,14 @@ type ApiUsageResponse struct {
 	SubStatusAcceptAll int `json:"sub_status_accept_all"`
 	// Total number times the API has a sub status "mx_forward"
 	SubStatusMxForward int `json:"sub_status_mx_forward"`
+	// Total number of times the API has a sub status of "alternate"
+	SubStatusAlternate int `json:"sub_status_alternate"`
+	// Total number of times the API has a sub status of "blocked"
+	SubStatusBlocked int `json:"sub_status_blocked"`
+	// Total number of times the API has a sub status of "allowed"
+	SubStatusAllowed int `json:"sub_status_allowed"`
+	// Total number of times the API has a sub status of "gold"
+	SubStatusGold int `json:"sub_status_gold"`
 	// Start date of query.
 	RawStartDate string `json:"start_date"`
 	// End date of query.

api_test.go

@@ -154,6 +154,9 @@ func TestApiUsageOk(t *testing.T) {
 	assert.NotEqual(t, api_usage.SubStatusFailedSmtpConnection, 0)
 	assert.NotEqual(t, api_usage.SubStatusAcceptAll, 0)
 	assert.NotEqual(t, api_usage.SubStatusMxForward, 0)
+	assert.NotEqual(t, api_usage.SubStatusAlternate, 0)
+	assert.NotEqual(t, api_usage.SubStatusBlocked, 0)
+	assert.NotEqual(t, api_usage.SubStatusAllowed, 0)
 
 	expected_start := time.Date(2023, 1, 1, 0, 0, 0, 0, time.Local)
 	expected_end := time.Date(2023, 12, 12, 0, 0, 0, 0, time.Local)

mocking_validation_content.go

@@ -589,6 +589,48 @@ var MOCK_VALIDATE_RESPONSE = map[string]string{
 		"zipcode": "33401",
 		"processed_at": "2023-03-23 12:30:32.095"
 	}`,
+	"gold@example.com": `{
+		"address": "gold@example.com",
+		"status": "valid",
+		"sub_status": "gold",
+		"free_email": false,
+		"did_you_mean": null,
+		"account": null,
+		"domain": null,
+		"domain_age_days": "9692",
+		"smtp_provider": "example",
+		"mx_found": "true",
+		"mx_record": "mx.example.com",
+		"firstname": "zero",
+		"lastname": "bounce",
+		"gender": "male",
+		"country": "United States",
+		"region": "Florida",
+		"city": "West Palm Beach",
+		"zipcode": "33401",
+		"processed_at": "2023-03-23 12:30:32.095"
+	}`,
+	"role_based_accept_all@example.com": `{
+		"address": "role_based_accept_all@example.com",
+		"status": "valid",
+		"sub_status": "role_based_accept_all",
+		"free_email": false,
+		"did_you_mean": null,
+		"account": null,
+		"domain": null,
+		"domain_age_days": "9692",
+		"smtp_provider": "example",
+		"mx_found": "true",
+		"mx_record": "mx.example.com",
+		"firstname": "zero",
+		"lastname": "bounce",
+		"gender": "male",
+		"country": "United States",
+		"region": "Florida",
+		"city": "West Palm Beach",
+		"zipcode": "33401",
+		"processed_at": "2023-03-23 12:30:32.095"
+	}`,
 	"role_based_catch_all@example.com": `{
 		"address": "role_based_catch_all@example.com",
 		"status": "do_not_mail",

utility.go

@@ -74,9 +74,15 @@ const (
 	SS_DOES_NOT_ACCEPT_MAIL        = "does_not_accept_mail"
 	SS_ALIAS_ADDRESS               = "alias_address"
 	SS_ROLE_BASED_CATCH_ALL        = "role_based_catch_all"
+	SS_ROLE_BASED_ACCEPT_ALL       = "role_based_accept_all"
 	SS_DISPOSABLE                  = "disposable"
 	SS_TOXIC                       = "toxic"
 	SS_ACCEPT_ALL				   = "accept_all"
+	SS_ALTERNATE                   = "alternate"
+	SS_MX_FORWARD                  = "mx_forward"
+	SS_BLOCKED                     = "blocked"
+	SS_ALLOWED                     = "allowed"
+	SS_GOLD                        = "gold"
 )
 
 const (
@@ -274,6 +280,8 @@ var emailsToValidate = []SingleTest{
 	{Email: "timeout_exceeded@example.com", Status: "unknown", SubStatus: "timeout_exceeded"},
 	{Email: "unroutable_ip_address@example.com", Status: "invalid", SubStatus: "unroutable_ip_address"},
 	{Email: "free_email@example.com", Status: "valid", SubStatus: "", FreeEmail: true},
+	{Email: "gold@example.com", Status: "valid", SubStatus: "gold"},
+	{Email: "role_based_accept_all@example.com", Status: "valid", SubStatus: "role_based_accept_all"},
 	{Email: "role_based_catch_all@example.com", Status: "do_not_mail", SubStatus: "role_based_catch_all"},
 }
 

validate_test.go

@@ -124,6 +124,32 @@ func TestMockValidationOk(t *testing.T) {
 	}
 }
 
+func TestResponseSubStatusGold(t *testing.T) {
+	Initialize("mock_key")
+	httpmock.Activate()
+	defer httpmock.DeactivateAndReset()
+	mockValidateRequest()
+
+	response, error_ := ValidateWithTimeout("gold@example.com", SANDBOX_IP, "10")
+	assert.Nil(t, error_)
+	assert.Equal(t, "gold@example.com", response.Address)
+	assert.Equal(t, "valid", response.Status)
+	assert.Equal(t, "gold", response.SubStatus)
+}
+
+func TestResponseSubStatusRoleBasedAcceptAll(t *testing.T) {
+	Initialize("mock_key")
+	httpmock.Activate()
+	defer httpmock.DeactivateAndReset()
+	mockValidateRequest()
+
+	response, error_ := ValidateWithTimeout("role_based_accept_all@example.com", SANDBOX_IP, "10")
+	assert.Nil(t, error_)
+	assert.Equal(t, "role_based_accept_all@example.com", response.Address)
+	assert.Equal(t, "valid", response.Status)
+	assert.Equal(t, "role_based_accept_all", response.SubStatus)
+}
+
 func TestMockBulkValidationNoApiKey(t *testing.T) {
 	Initialize("")
 	httpmock.Activate()