chore: suppress reexport and type-only files from coverage metrics in…

… @aws-amplify/graphql-category-api

packages/amplify-graphql-api-construct/src/__tests__/index-import.test.ts

@@ -1,4 +1,8 @@
-// This exists only to provide coverage metrics for various export files
+// ############################################################################
+// This exists only to provide coverage metrics for various export files. If
+// you include executable code in any of the referenced files, you must test it
+// separately in a dedicated *.test.ts file.
+// ############################################################################
 
 import * as src from '../index';
 import * as types from '../types';

packages/amplify-graphql-api-construct/src/index.ts

@@ -1,7 +1,18 @@
+// ############################################################################
+// Note that sections of this file are excluded from test coverage metrics with
+// 'c8 ignore' comments. If you add code to this file, suppress non-executable
+// code from coverage metrics by using a `c8 ignore`. If the code is
+// executable, you MUST NOT suppress it from coverage metrics.
+//
+// `ignore` statements must only span a single block of code. Do not apply an
+// `ignore` statement to multiple blocks, or the entire file.
+// ############################################################################
+
 /* ATTENTION
  *
  * If you modify this file you must also modify packages/amplify-data-construct/src/index.ts to have the same exports
  */
+/* c8 ignore start */
 export type {
   IAMAuthorizationConfig,
   IdentityPoolAuthorizationConfig,
@@ -34,8 +45,17 @@ export type {
   IBackendOutputEntry,
   AddFunctionProps,
 } from './types';
+/* c8 ignore stop */
+
+/* c8 ignore start */
 export { AmplifyGraphqlApi } from './amplify-graphql-api';
+/* c8 ignore stop */
+
+/* c8 ignore start */
 export { AmplifyGraphqlDefinition } from './amplify-graphql-definition';
+/* c8 ignore stop */
+
+/* c8 ignore start */
 export {
   AmplifyDynamoDbTableWrapper,
   TimeToLiveSpecification,
@@ -44,7 +64,20 @@ export {
   SSEType,
   StreamSpecification,
 } from './amplify-dynamodb-table-wrapper';
+/* c8 ignore stop */
+
+/* c8 ignore start */
 export { SQLLambdaModelDataSourceStrategyFactory } from './sql-model-datasource-strategy';
+/* c8 ignore stop */
+
+/* c8 ignore start */
 export * from './model-datasource-strategy-types';
+/* c8 ignore stop */
+
+/* c8 ignore start */
 export type { LogConfig, Logging } from './log-config-types';
+/* c8 ignore stop */
+
+/* c8 ignore start */
 export { FieldLogLevel, RetentionDays } from './log-config-types';
+/* c8 ignore stop */