feat(aws): Support AWS Account Contacts (#4734)

#### Summary

<!--
Explain what problem this PR addresses
-->

<!--

plugins/source/aws/codegen/main.go

@@ -12,6 +12,7 @@ import (
 func generateResources() ([]*recipes.Resource, error) {
 	var resources []*recipes.Resource
 	resources = append(resources, recipes.AccessAnalyzerResources()...)
+	resources = append(resources, recipes.AccountResources()...)
 	resources = append(resources, recipes.ACMResources()...)
 	resources = append(resources, recipes.APIGatewayResources()...)
 	resources = append(resources, recipes.APIGatewayV2Resources()...)

plugins/source/aws/codegen/recipes/account.go

@@ -0,0 +1,46 @@
+package recipes
+
+import (
+	"github.com/aws/aws-sdk-go-v2/service/account/types"
+	"github.com/cloudquery/plugin-sdk/codegen"
+	"github.com/cloudquery/plugin-sdk/schema"
+)
+
+func AccountResources() []*Resource {
+	resources := []*Resource{
+		{
+			SubService:  "alternate_contacts",
+			Struct:      &types.AlternateContact{},
+			Description: "https://docs.aws.amazon.com/accounts/latest/reference/API_AlternateContact.html",
+			PKColumns:   []string{"alternate_contact_type"},
+			ExtraColumns: []codegen.ColumnDefinition{
+				{
+					Name:     "account_id",
+					Type:     schema.TypeString,
+					Resolver: "client.ResolveAWSAccount",
+					Options:  schema.ColumnCreationOptions{PrimaryKey: true},
+				},
+			},
+		},
+		{
+			SubService:  "contacts",
+			Struct:      &types.ContactInformation{},
+			Description: "https://docs.aws.amazon.com/accounts/latest/reference/API_ContactInformation.html",
+			ExtraColumns: []codegen.ColumnDefinition{
+				{
+					Name:     "account_id",
+					Type:     schema.TypeString,
+					Resolver: "client.ResolveAWSAccount",
+					Options:  schema.ColumnCreationOptions{PrimaryKey: true},
+				},
+			},
+		},
+	}
+
+	for _, r := range resources {
+		r.Service = "account"
+		r.Multiplex = `client.AccountMultiplex`
+
+	}
+	return resources
+}

plugins/source/aws/codegen/services/clients.go

@@ -2,6 +2,7 @@ package services
 
 import (
 	"github.com/aws/aws-sdk-go-v2/service/accessanalyzer"
+	"github.com/aws/aws-sdk-go-v2/service/account"
 	"github.com/aws/aws-sdk-go-v2/service/acm"
 	"github.com/aws/aws-sdk-go-v2/service/apigateway"
 	"github.com/aws/aws-sdk-go-v2/service/apigatewayv2"
@@ -94,6 +95,7 @@ import (
 
 var clients = []interface{}{
 	&accessanalyzer.Client{},
+	&account.Client{},
 	&acm.Client{},
 	&apigateway.Client{},
 	&apigatewayv2.Client{},

plugins/source/aws/docs/tables/README.md

@@ -5,6 +5,8 @@
 | [aws_accessanalyzer_analyzers](aws_accessanalyzer_analyzers.md) |
 | ↳ [aws_accessanalyzer_analyzer_findings](aws_accessanalyzer_analyzer_findings.md) |
 | ↳ [aws_accessanalyzer_analyzer_archive_rules](aws_accessanalyzer_analyzer_archive_rules.md) |
+| [aws_account_alternate_contacts](aws_account_alternate_contacts.md) |
+| [aws_account_contacts](aws_account_contacts.md) |
 | [aws_acm_certificates](aws_acm_certificates.md) |
 | [aws_apigateway_api_keys](aws_apigateway_api_keys.md) |
 | [aws_apigateway_client_certificates](aws_apigateway_client_certificates.md) |

plugins/source/aws/docs/tables/aws_account_alternate_contacts.md

@@ -0,0 +1,20 @@
+# Table: aws_account_alternate_contacts
+
+https://docs.aws.amazon.com/accounts/latest/reference/API_AlternateContact.html
+
+The composite primary key for this table is (**account_id**, **alternate_contact_type**).
+
+
+## Columns
+| Name          | Type          |
+| ------------- | ------------- |
+|_cq_source_name|String|
+|_cq_sync_time|Timestamp|
+|_cq_id|UUID|
+|_cq_parent_id|UUID|
+|account_id (PK)|String|
+|alternate_contact_type (PK)|String|
+|email_address|String|
+|name|String|
+|phone_number|String|
+|title|String|

plugins/source/aws/docs/tables/aws_account_contacts.md

@@ -0,0 +1,27 @@
+# Table: aws_account_contacts
+
+https://docs.aws.amazon.com/accounts/latest/reference/API_ContactInformation.html
+
+The primary key for this table is **account_id**.
+
+
+## Columns
+| Name          | Type          |
+| ------------- | ------------- |
+|_cq_source_name|String|
+|_cq_sync_time|Timestamp|
+|_cq_id|UUID|
+|_cq_parent_id|UUID|
+|account_id (PK)|String|
+|address_line1|String|
+|city|String|
+|country_code|String|
+|full_name|String|
+|phone_number|String|
+|postal_code|String|
+|address_line2|String|
+|address_line3|String|
+|company_name|String|
+|district_or_county|String|
+|state_or_region|String|
+|website_url|String|

plugins/source/aws/go.mod

@@ -8,6 +8,7 @@ require (
 	github.com/aws/aws-sdk-go-v2/credentials v1.13.1
 	github.com/aws/aws-sdk-go-v2/feature/s3/manager v1.11.40
 	github.com/aws/aws-sdk-go-v2/service/accessanalyzer v1.17.2
+	github.com/aws/aws-sdk-go-v2/service/account v1.7.11
 	github.com/aws/aws-sdk-go-v2/service/acm v1.16.2
 	github.com/aws/aws-sdk-go-v2/service/apigateway v1.15.24
 	github.com/aws/aws-sdk-go-v2/service/apigatewayv2 v1.12.22

plugins/source/aws/go.sum

@@ -56,6 +56,8 @@ github.com/aws/aws-sdk-go-v2/internal/v4a v1.0.16 h1:2EXB7dtGwRYIN3XQ9qwIW504DVb
 github.com/aws/aws-sdk-go-v2/internal/v4a v1.0.16/go.mod h1:XH+3h395e3WVdd6T2Z3mPxuI+x/HVtdqVOREkTiyubs=
 github.com/aws/aws-sdk-go-v2/service/accessanalyzer v1.17.2 h1:G0p51FKC4VvN76vX3fIGZIcbhW9svxFmZRi99RLWAM4=
 github.com/aws/aws-sdk-go-v2/service/accessanalyzer v1.17.2/go.mod h1:O769hLd/n0YUcFAfCi4g3lnpSntWCKkIFXzgi7H493s=
+github.com/aws/aws-sdk-go-v2/service/account v1.7.11 h1:a/mDtQr8ALZc8g+ZLgykkuN8/7GynTEb+nIsR67bwyQ=
+github.com/aws/aws-sdk-go-v2/service/account v1.7.11/go.mod h1:ubDDEHqWWWFcDG0JtdHj/qDstFF/CHa3HRyI+RLOUwU=
 github.com/aws/aws-sdk-go-v2/service/acm v1.16.2 h1:iY6P2fwGJj+Z6bMxIx99fgXvH7mKDhzDf/ISNsa0Nb0=
 github.com/aws/aws-sdk-go-v2/service/acm v1.16.2/go.mod h1:LR3qi788mHzUYfv2MNs+xwbvig6QlrPYVOhKv/Ae5M0=
 github.com/aws/aws-sdk-go-v2/service/apigateway v1.15.24 h1:eWwaF3m67oAJGBhfzVC9dLXPYhLHB238N1LhgFa8INk=

plugins/source/aws/resources/services/account/alternate_contacts_fetch.go

@@ -0,0 +1,26 @@
+package account
+
+import (
+	"context"
+
+	"github.com/aws/aws-sdk-go-v2/service/account"
+	"github.com/aws/aws-sdk-go-v2/service/account/types"
+	"github.com/cloudquery/cloudquery/plugins/source/aws/client"
+	"github.com/cloudquery/plugin-sdk/schema"
+)
+
+func fetchAccountAlternateContacts(ctx context.Context, meta schema.ClientMeta, parent *schema.Resource, res chan<- interface{}) error {
+	cl := meta.(*client.Client)
+	svc := cl.Services().Account
+	var contactTypes types.AlternateContactType
+	for _, acType := range contactTypes.Values() {
+		var input account.GetAlternateContactInput
+		input.AlternateContactType = acType
+		output, err := svc.GetAlternateContact(ctx, &input)
+		if err != nil {
+			return err
+		}
+		res <- output.AlternateContact
+	}
+	return nil
+}

plugins/source/aws/resources/services/account/alternate_contacts_mock_test.go

@@ -0,0 +1,35 @@
+package account
+
+import (
+	"testing"
+
+	"github.com/aws/aws-sdk-go-v2/service/account"
+	"github.com/aws/aws-sdk-go-v2/service/account/types"
+	"github.com/cloudquery/cloudquery/plugins/source/aws/client"
+	"github.com/cloudquery/cloudquery/plugins/source/aws/client/mocks"
+	"github.com/cloudquery/plugin-sdk/faker"
+	"github.com/golang/mock/gomock"
+)
+
+func buildAlternateContacts(t *testing.T, ctrl *gomock.Controller) client.Services {
+	mock := mocks.NewMockAccountClient(ctrl)
+
+	var ac types.AlternateContact
+	if err := faker.FakeObject(&ac); err != nil {
+		t.Fatal(err)
+	}
+	mock.EXPECT().GetAlternateContact(
+		gomock.Any(),
+		gomock.Any(),
+		gomock.Any(),
+	).Return(
+		&account.GetAlternateContactOutput{AlternateContact: &ac},
+		nil,
+	).MinTimes(1)
+
+	return client.Services{Account: mock}
+}
+
+func TestAlternateContacts(t *testing.T) {
+	client.AwsMockTestHelper(t, AlternateContacts(), buildAlternateContacts, client.TestOptions{})
+}