@aws-amplify/graphql-transformer-interfaces 3.3.0-rds-5.0 → 3.3.1

package/lib/transformer-context/transformer-context-provider.d.ts

@@ -1,6 +1,7 @@
 import { DocumentNode } from 'graphql';
-import { AppSyncAuthConfiguration, GraphQLAPIProvider, RDSLayerMapping, VpcConfig } from '../graphql-api-provider';
-import { TransformerDataSourceManagerProvider, DatasourceType } from './transformer-datasource-provider';
+import { AppSyncAuthConfiguration, GraphQLAPIProvider } from '../graphql-api-provider';
+import { CustomSqlDataSourceStrategy, ProvisionedConcurrencyConfig, RDSLayerMapping, VpcConfig } from '../model-datasource';
+import { TransformerDataSourceManagerProvider, DataSourceType } from './transformer-datasource-provider';
 import { TransformerProviderRegistry } from './transformer-provider-registry';
 import { TransformerContextOutputProvider } from './transformer-context-output-provider';
 import { StackManagerProvider } from './stack-manager-provider';
@@ -22,7 +23,8 @@ export interface TransformerContextProvider {
     dataSources: TransformerDataSourceManagerProvider;
     providerRegistry: TransformerProviderRegistry;
     inputDocument: DocumentNode;
-    modelToDatasourceMap: Map<string, DatasourceType>;
+    modelToDatasourceMap: Map<string, DataSourceType>;
+    customSqlDataSourceStrategies?: CustomSqlDataSourceStrategy[];
     datasourceSecretParameterLocations: Map<string, TransformerSecrets>;
     output: TransformerContextOutputProvider;
     stackManager: StackManagerProvider;
@@ -36,10 +38,11 @@ export interface TransformerContextProvider {
     getResolverConfig<ResolverConfig>(): ResolverConfig | undefined;
     readonly sqlLambdaVpcConfig?: VpcConfig;
     readonly rdsLayerMapping?: RDSLayerMapping;
+    readonly sqlLambdaProvisionedConcurrencyConfig?: ProvisionedConcurrencyConfig;
 }
-export type TransformerBeforeStepContextProvider = Pick<TransformerContextProvider, 'inputDocument' | 'modelToDatasourceMap' | 'transformParameters' | 'isProjectUsingDataStore' | 'getResolverConfig' | 'authConfig' | 'stackManager' | 'synthParameters'>;
-export type TransformerSchemaVisitStepContextProvider = Pick<TransformerContextProvider, 'inputDocument' | 'modelToDatasourceMap' | 'output' | 'providerRegistry' | 'transformParameters' | 'isProjectUsingDataStore' | 'getResolverConfig' | 'metadata' | 'authConfig' | 'resourceHelper'>;
-export type TransformerValidationStepContextProvider = Pick<TransformerContextProvider, 'inputDocument' | 'modelToDatasourceMap' | 'output' | 'providerRegistry' | 'dataSources' | 'transformParameters' | 'isProjectUsingDataStore' | 'getResolverConfig' | 'metadata' | 'authConfig' | 'resourceHelper' | 'resolvers' | 'stackManager' | 'synthParameters'>;
+export type TransformerBeforeStepContextProvider = Pick<TransformerContextProvider, 'inputDocument' | 'modelToDatasourceMap' | 'customSqlDataSourceStrategies' | 'transformParameters' | 'isProjectUsingDataStore' | 'getResolverConfig' | 'authConfig' | 'stackManager' | 'synthParameters'>;
+export type TransformerSchemaVisitStepContextProvider = Pick<TransformerContextProvider, 'inputDocument' | 'modelToDatasourceMap' | 'customSqlDataSourceStrategies' | 'output' | 'providerRegistry' | 'transformParameters' | 'isProjectUsingDataStore' | 'getResolverConfig' | 'metadata' | 'authConfig' | 'resourceHelper'>;
+export type TransformerValidationStepContextProvider = Pick<TransformerContextProvider, 'inputDocument' | 'modelToDatasourceMap' | 'customSqlDataSourceStrategies' | 'output' | 'providerRegistry' | 'dataSources' | 'transformParameters' | 'isProjectUsingDataStore' | 'getResolverConfig' | 'metadata' | 'authConfig' | 'resourceHelper' | 'resolvers' | 'stackManager' | 'synthParameters'>;
 export type TransformerPrepareStepContextProvider = TransformerValidationStepContextProvider;
 export type TransformerTransformSchemaStepContextProvider = TransformerValidationStepContextProvider;
 //# sourceMappingURL=transformer-context-provider.d.ts.map

package/lib/transformer-context/transformer-context-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transformer-context-provider.d.ts","sourceRoot":"","sources":["../../src/transformer-context/transformer-context-provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transformer-context-provider.d.ts","sourceRoot":"","sources":["../../src/transformer-context/transformer-context-provider.ts"],"names":[],"mappings":"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"}

package/lib/transformer-context/transformer-datasource-provider.d.ts

@@ -16,15 +16,25 @@ export interface NoneDataSourceProvider {
 }
 export type DataSourceInstance = ITable | CfnDomain | HttpDataSource | IFunction | NoneDataSourceProvider;
 export interface TransformerDataSourceManagerProvider {
-    add(type: ObjectTypeDefinitionNode | InterfaceTypeDefinitionNode, dataSourceInstance: DataSourceInstance): void;
-    get(type: ObjectTypeDefinitionNode | InterfaceTypeDefinitionNode): DataSourceInstance;
-    has(name: string): boolean;
+    add: (type: ObjectTypeDefinitionNode | InterfaceTypeDefinitionNode, dataSourceInstance: DataSourceInstance) => void;
+    get: (type: ObjectTypeDefinitionNode | InterfaceTypeDefinitionNode) => DataSourceInstance;
+    has: (name: string) => boolean;
 }
 export interface DataSourceProvider extends BackedDataSource {
 }
-export type DBType = 'DDB' | 'MySQL' | 'Postgres';
-export interface DatasourceType {
+export type DBType = 'DDB' | SQLDBType;
+export type SQLDBType = 'MySQL' | 'Postgres';
+export type DataSourceProvisionStrategy = DynamoDBProvisionStrategy | SQLLambdaModelProvisionStrategy;
+export declare const enum DynamoDBProvisionStrategy {
+    DEFAULT = "DEFAULT",
+    AMPLIFY_TABLE = "AMPLIFY_TABLE"
+}
+export declare const enum SQLLambdaModelProvisionStrategy {
+    DEFAULT = "DEFAULT"
+}
+export interface DataSourceType {
     dbType: DBType;
     provisionDB: boolean;
+    provisionStrategy: DataSourceProvisionStrategy;
 }
 //# sourceMappingURL=transformer-datasource-provider.d.ts.map

package/lib/transformer-context/transformer-datasource-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transformer-datasource-provider.d.ts","sourceRoot":"","sources":["../../src/transformer-context/transformer-datasource-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAEhF,oBAAY,qBAAqB;IAC/B,eAAe,oBAAoB;IACnC,oBAAoB,yBAAyB;IAC7C,UAAU,eAAe;IACzB,mBAAmB,wBAAwB;IAC3C,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,GAAG,sBAAsB,CAAC;AAE1G,MAAM,WAAW,oCAAoC;IACnD,GAAG,CAAC,IAAI,EAAE,wBAAwB,GAAG,2BAA2B,EAAE,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAChH,GAAG,CAAC,IAAI,EAAE,wBAAwB,GAAG,2BAA2B,GAAG,kBAAkB,CAAC;IACtF,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;CAAG;AAK/D,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC;AAMlD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"transformer-datasource-provider.d.ts","sourceRoot":"","sources":["../../src/transformer-context/transformer-datasource-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAEhF,oBAAY,qBAAqB;IAC/B,eAAe,oBAAoB;IACnC,oBAAoB,yBAAyB;IAC7C,UAAU,eAAe;IACzB,mBAAmB,wBAAwB;IAC3C,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,GAAG,sBAAsB,CAAC;AAE1G,MAAM,WAAW,oCAAoC;IACnD,GAAG,EAAE,CAAC,IAAI,EAAE,wBAAwB,GAAG,2BAA2B,EAAE,kBAAkB,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACpH,GAAG,EAAE,CAAC,IAAI,EAAE,wBAAwB,GAAG,2BAA2B,KAAK,kBAAkB,CAAC;IAC1F,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;CAAG;AAK/D,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAKvC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAG7C,MAAM,MAAM,2BAA2B,GAAG,yBAAyB,GAAG,+BAA+B,CAAC;AAMtG,0BAAkB,yBAAyB;IAIzC,OAAO,YAAY;IAInB,aAAa,kBAAkB;CAChC;AAGD,0BAAkB,+BAA+B;IAI/C,OAAO,YAAY;CACpB;AAGD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,2BAA2B,CAAC;CAChD"}

package/lib/transformer-context/transformer-datasource-provider.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AppSyncDataSourceType = void 0;
+exports.SQLLambdaModelProvisionStrategy = exports.DynamoDBProvisionStrategy = exports.AppSyncDataSourceType = void 0;
 var AppSyncDataSourceType;
 (function (AppSyncDataSourceType) {
     AppSyncDataSourceType["AMAZON_DYNAMODB"] = "AMAZON_DYNAMODB";
@@ -10,4 +10,13 @@ var AppSyncDataSourceType;
     AppSyncDataSourceType["HTTP"] = "HTTP";
     AppSyncDataSourceType["NONE"] = "NONE";
 })(AppSyncDataSourceType = exports.AppSyncDataSourceType || (exports.AppSyncDataSourceType = {}));
+var DynamoDBProvisionStrategy;
+(function (DynamoDBProvisionStrategy) {
+    DynamoDBProvisionStrategy["DEFAULT"] = "DEFAULT";
+    DynamoDBProvisionStrategy["AMPLIFY_TABLE"] = "AMPLIFY_TABLE";
+})(DynamoDBProvisionStrategy = exports.DynamoDBProvisionStrategy || (exports.DynamoDBProvisionStrategy = {}));
+var SQLLambdaModelProvisionStrategy;
+(function (SQLLambdaModelProvisionStrategy) {
+    SQLLambdaModelProvisionStrategy["DEFAULT"] = "DEFAULT";
+})(SQLLambdaModelProvisionStrategy = exports.SQLLambdaModelProvisionStrategy || (exports.SQLLambdaModelProvisionStrategy = {}));
 //# sourceMappingURL=transformer-datasource-provider.js.map

package/lib/transformer-context/transformer-datasource-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"transformer-datasource-provider.js","sourceRoot":"","sources":["../../src/transformer-context/transformer-datasource-provider.ts"],"names":[],"mappings":";;;AAMA,IAAY,qBAOX;AAPD,WAAY,qBAAqB;IAC/B,4DAAmC,CAAA;IACnC,sEAA6C,CAAA;IAC7C,kDAAyB,CAAA;IACzB,oEAA2C,CAAA;IAC3C,sCAAa,CAAA;IACb,sCAAa,CAAA;AACf,CAAC,EAPW,qBAAqB,GAArB,6BAAqB,KAArB,6BAAqB,QAOhC"}
+{"version":3,"file":"transformer-datasource-provider.js","sourceRoot":"","sources":["../../src/transformer-context/transformer-datasource-provider.ts"],"names":[],"mappings":";;;AAMA,IAAY,qBAOX;AAPD,WAAY,qBAAqB;IAC/B,4DAAmC,CAAA;IACnC,sEAA6C,CAAA;IAC7C,kDAAyB,CAAA;IACzB,oEAA2C,CAAA;IAC3C,sCAAa,CAAA;IACb,sCAAa,CAAA;AACf,CAAC,EAPW,qBAAqB,GAArB,6BAAqB,KAArB,6BAAqB,QAOhC;AAiCD,IAAkB,yBASjB;AATD,WAAkB,yBAAyB;IAIzC,gDAAmB,CAAA;IAInB,4DAA+B,CAAA;AACjC,CAAC,EATiB,yBAAyB,GAAzB,iCAAyB,KAAzB,iCAAyB,QAS1C;AAGD,IAAkB,+BAKjB;AALD,WAAkB,+BAA+B;IAI/C,sDAAmB,CAAA;AACrB,CAAC,EALiB,+BAA+B,GAA/B,uCAA+B,KAA/B,uCAA+B,QAKhD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-amplify/graphql-transformer-interfaces",
-  "version": "3.3.0-rds-5.0",
+  "version": "3.3.1",
   "description": "Amplify GraphQL transformer interface definitions",
   "repository": {
     "type": "git",
@@ -49,5 +49,5 @@
     ],
     "collectCoverage": true
   },
-  "gitHead": "ddbbff11d6a070cb4d2b9708c60c734a5d139bfc"
+  "gitHead": "5256b5955ee204dd56f8074a43406852f8206c54"
 }

package/src/graphql-api-provider.ts

@@ -1,6 +1,7 @@
 import { CfnResource, IAsset } from 'aws-cdk-lib';
 import { Construct, IConstruct } from 'constructs';
 import { Grant, IGrantable, IRole } from 'aws-cdk-lib/aws-iam';
+// eslint-disable-next-line import/no-cycle
 import { TransformHostProvider } from './transform-host-provider';
 
 // Auth Config Modes
@@ -56,43 +57,28 @@ export interface OpenIDConnectConfig {
 }
 
 export interface LambdaConfig {
+  /**
+   * Function name, excluding optional `-{env}` suffix.
+   */
   lambdaFunction: string;
-  ttlSeconds?: number;
-}
 
-/**
- * VpcConfig required to deploy a Lambda function in a VPC. The SQL Lambda will be deployed into the specified VPC, subnets, and security
- * groups. The specified subnets and security groups must be in the same VPC. The VPC must have at least one subnet. The construct will also
- * create VPC endpoints in the specified subnets, as well as inbound security rules to allow traffic on port 443 within each security group,
- * to allow the Lambda to read database connection information from Secure Systems Manager. */
-export type VpcConfig = {
-  vpcId: string;
-  subnetAvailabilityZoneConfig: SubnetAvailabilityZone[];
-  securityGroupIds: string[];
-};
-
-/**
- * Although it is possible to create multiple subnets in a single availability zone, VPC Endpoints may only be deployed to a single subnet
- * in a given availability zone. We use this structure to ensure that the Lambda function and VPC endpoints are mutually consistent.
- */
-export type SubnetAvailabilityZone = {
-  SubnetId: string;
-  AvailabilityZone: string;
-};
+  /**
+   * The ARN of an existing Lambda function. If provided, this will circumvent the ARN construction when building the API auth mode config.
+   * The ARN must refer to the same function named in `lambdaFunction`.
+   */
+  lambdaArn?: string;
 
-/**
- * Maps a given AWS region to the SQL Lambda layer version ARN for that region.
- */
-export type RDSLayerMapping = {
-  [key: string]: {
-    layerRegion: string;
-  };
-};
+  /**
+   * Optional auth response time to live.
+   */
+  ttlSeconds?: number;
+}
 
 export interface AppSyncFunctionConfigurationProvider extends IConstruct {
   readonly arn: string;
   readonly functionId: string;
 }
+
 export interface DataSourceOptions {
   /**
    * The name of the data source, overrides the id given by cdk

package/src/index.ts

@@ -1,3 +1,4 @@
+// eslint-disable-next-line import/no-cycle
 export * from './transformer-context';
 export { TransformerPluginProvider, TransformerPluginType } from './transformer-plugin-provider';
 export {
@@ -27,13 +28,11 @@ export {
   AppSyncAuthConfigurationUserPoolEntry,
   AppSyncAuthMode,
   UserPoolConfig,
-  VpcConfig,
-  SubnetAvailabilityZone,
   SearchableDataSourceOptions,
-  RDSLayerMapping,
 } from './graphql-api-provider';
 export { TransformHostProvider, DynamoDbDataSourceOptions } from './transform-host-provider';
 export { TransformerLog, TransformerLogLevel } from './transformer-log';
 export type { TransformParameters } from './transformer-context/transform-parameters';
 export type { NestedStackProvider } from './nested-stack-provider';
 export type { AssetProps, AssetProvider, S3Asset } from './asset-provider';
+export * from './model-datasource';

package/src/model-datasource/index.ts

@@ -0,0 +1 @@
+export * from './types';

package/src/model-datasource/types.ts

@@ -0,0 +1,163 @@
+import { DataSourceType } from '../transformer-context/transformer-datasource-provider';
+
+// #########################################################################################################################################
+// If you change types in this file (the internal implementation), be sure to make corresponding necessary changes to
+// amplify-graphql-api-construct/src/model-datasource-strategy.ts (the customer-facing interface) and the adapter functions in this file.
+// #########################################################################################################################################
+
+/**
+ * All known ModelDataSourceStrategies. Concrete strategies vary widely in their requirements and implementations.
+ */
+export type ModelDataSourceStrategy =
+  | DefaultDynamoDbModelDataSourceStrategy
+  | AmplifyDynamoDbModelDataSourceStrategy
+  | SQLLambdaModelDataSourceStrategy;
+
+export interface ModelDataSourceStrategyBase {
+  dbType: ModelDataSourceStrategyDbType;
+}
+
+// TODO: Make this the source of truth for database type definitions used throughout the construct & transformer
+export type ModelDataSourceStrategyDbType = 'DYNAMODB' | 'MYSQL' | 'POSTGRES';
+
+/**
+ * Use default CloudFormation type 'AWS::DynamoDB::Table' to provision table.
+ */
+export interface DefaultDynamoDbModelDataSourceStrategy extends ModelDataSourceStrategyBase {
+  readonly dbType: 'DYNAMODB';
+  readonly provisionStrategy: 'DEFAULT';
+}
+
+/**
+ * Use custom resource type 'Custom::AmplifyDynamoDBTable' to provision table.
+ */
+export interface AmplifyDynamoDbModelDataSourceStrategy extends ModelDataSourceStrategyBase {
+  readonly dbType: 'DYNAMODB';
+  readonly provisionStrategy: 'AMPLIFY_TABLE';
+}
+
+/**
+ * A strategy that creates a Lambda to connect to a pre-existing SQL table to resolve model data.
+ *
+ */
+export interface SQLLambdaModelDataSourceStrategy extends ModelDataSourceStrategyBase {
+  /**
+   * The name of the strategy. This will be used to name the AppSync DataSource itself, plus any associated resources like resolver Lambdas.
+   * This name must be unique across all schema definitions in a GraphQL API.
+   */
+  readonly name: string;
+
+  /**
+   * The type of the SQL database used to process model operations for this definition.
+   */
+  readonly dbType: 'MYSQL' | 'POSTGRES';
+
+  /**
+   * The parameters the Lambda data source will use to connect to the database.
+   */
+  readonly dbConnectionConfig: SqlModelDataSourceDbConnectionConfig;
+
+  /**
+   * The configuration of the VPC into which to install the Lambda.
+   */
+  readonly vpcConfiguration?: VpcConfig;
+
+  /**
+   * Custom SQL statements. The key is the value of the `references` attribute of the `@sql` directive in the `schema`; the value is the SQL
+   * to be executed.
+   */
+  readonly customSqlStatements?: Record<string, string>;
+
+  /**
+   * The configuration for the provisioned concurrency of the Lambda.
+   */
+  readonly sqlLambdaProvisionedConcurrencyConfig?: ProvisionedConcurrencyConfig;
+}
+
+/**
+ * Configuration of the VPC in which to install a Lambda to resolve queries against a SQL-based data source. The SQL Lambda will be deployed
+ * into the specified VPC, subnets, and security groups. The specified subnets and security groups must be in the same VPC. The VPC must
+ * have at least one subnet. The construct will also create VPC service endpoints in the specified subnets, as well as inbound security
+ * rules, to allow traffic on port 443 within each security group. This allows the Lambda to read database connection information from
+ * Secure Systems Manager.
+ */
+export interface VpcConfig {
+  /** The VPC to install the Lambda data source in. */
+  readonly vpcId: string;
+
+  /** The security groups to install the Lambda data source in. */
+  readonly securityGroupIds: string[];
+
+  /** The subnets to install the Lambda data source in, one per availability zone. */
+  readonly subnetAvailabilityZoneConfig: SubnetAvailabilityZone[];
+}
+
+/**
+ * The configuration for the provisioned concurrency of the Lambda.
+ */
+export interface ProvisionedConcurrencyConfig {
+  /** The amount of provisioned concurrency to allocate. **/
+  readonly provisionedConcurrentExecutions: number;
+}
+
+/**
+ * Subnet configuration for VPC endpoints used by a Lambda resolver for a SQL-based data source. Although it is possible to create multiple
+ * subnets in a single availability zone, VPC service endpoints may only be deployed to a single subnet in a given availability zone. This
+ * structure ensures that the Lambda function and VPC service endpoints are mutually consistent.
+ */
+export interface SubnetAvailabilityZone {
+  /** The subnet ID to install the Lambda data source in. */
+  readonly subnetId: string;
+
+  /** The availability zone of the subnet. */
+  readonly availabilityZone: string;
+}
+
+/**
+ * The Secure Systems Manager parameter paths the Lambda data source will use to connect to the database.
+ *
+ * These parameters are retrieved from Secure Systems Manager in the same region as the Lambda.
+ */
+export interface SqlModelDataSourceDbConnectionConfig {
+  /** The Secure Systems Manager parameter containing the hostname of the database. For RDS-based SQL data sources, this can be the hostname
+   * of a database proxy, cluster, or instance.
+   */
+  readonly hostnameSsmPath: string;
+
+  /** The Secure Systems Manager parameter containing the port number of the database proxy, cluster, or instance. */
+  readonly portSsmPath: string;
+
+  /** The Secure Systems Manager parameter containing the username to use when connecting to the database. */
+  readonly usernameSsmPath: string;
+
+  /** The Secure Systems Manager parameter containing the password to use when connecting to the database. */
+  readonly passwordSsmPath: string;
+
+  /** The Secure Systems Manager parameter containing the database name. */
+  readonly databaseNameSsmPath: string;
+}
+
+export interface CustomSqlDataSourceStrategy {
+  readonly typeName: 'Query' | 'Mutation';
+  readonly fieldName: string;
+  // TODO: Replace this when we support heterogeneous SQL data sources in a single API
+  readonly dataSourceType: DataSourceType;
+}
+
+export interface DataSourceStrategiesProvider {
+  /** Maps GraphQL model names to the ModelDataSourceStrategy used to resolve it. The key of the record is the GraphQL type name. */
+  // TODO: Add this back during combine feature
+  // dataSourceStrategies: Record<string, ModelDataSourceStrategy>;
+
+  /** Maps custom Query and Mutation fields to the ModelDataSourceStrategy used to resolve them. */
+  customSqlDataSourceStrategies: CustomSqlDataSourceStrategy[];
+}
+
+/**
+ * Maps a given AWS region to the SQL Lambda layer version ARN for that region. TODO: Rename to SQLLambdaLayerMapping
+ */
+export interface RDSLayerMapping {
+  readonly [key: string]: {
+    layerRegion: string;
+  };
+}

package/src/transform-host-provider.ts

@@ -17,8 +17,8 @@ import {
   DataSourceOptions,
   SearchableDataSourceOptions,
   MappingTemplateProvider,
-  VpcConfig,
 } from './graphql-api-provider';
+import { VpcConfig } from './model-datasource';
 
 export interface DynamoDbDataSourceOptions extends DataSourceOptions {
   /**

package/src/transformer-context/index.ts

@@ -3,21 +3,26 @@ export {
   TransformerDataSourceManagerProvider,
   AppSyncDataSourceType,
   DataSourceInstance,
+  DataSourceType,
   DBType,
-  DatasourceType,
+  DataSourceProvisionStrategy,
+  DynamoDBProvisionStrategy,
+  SQLLambdaModelProvisionStrategy,
+  SQLDBType,
 } from './transformer-datasource-provider';
 export { TransformerContextOutputProvider } from './transformer-context-output-provider';
 export { TransformerProviderRegistry } from './transformer-provider-registry';
 export { TransformerResolverProvider, TransformerResolversManagerProvider } from './transformer-resolver-provider';
 export * from './resource-resource-provider';
 export {
-  TransformerContextProvider,
-  TransformerTransformSchemaStepContextProvider,
   TransformerBeforeStepContextProvider,
+  TransformerContextMetadataProvider,
+  TransformerContextProvider,
   TransformerPrepareStepContextProvider,
   TransformerSchemaVisitStepContextProvider,
-  TransformerValidationStepContextProvider,
   TransformerSecrets,
+  TransformerTransformSchemaStepContextProvider,
+  TransformerValidationStepContextProvider,
 } from './transformer-context-provider';
 export { TransformerSchemaHelperProvider } from './schema-helper-provider';
 export { TransformerPreProcessContextProvider } from './transformer-preprocess-context-provider';

package/src/transformer-context/transform-parameters.ts

@@ -12,6 +12,8 @@ export type TransformParameters = {
   shouldDeepMergeDirectiveConfigDefaults: boolean;
   disableResolverDeduping: boolean;
   sandboxModeEnabled: boolean;
+  allowDestructiveGraphqlSchemaUpdates: boolean;
+  replaceTableUponGsiUpdate: boolean;
 
   // Auth Params
   useSubUsernameForDefaultIdentityClaim: boolean;

package/src/transformer-context/transformer-context-provider.ts

@@ -1,6 +1,7 @@
 import { DocumentNode } from 'graphql';
-import { AppSyncAuthConfiguration, GraphQLAPIProvider, RDSLayerMapping, VpcConfig } from '../graphql-api-provider';
-import { TransformerDataSourceManagerProvider, DatasourceType } from './transformer-datasource-provider';
+import { AppSyncAuthConfiguration, GraphQLAPIProvider } from '../graphql-api-provider';
+import { CustomSqlDataSourceStrategy, ProvisionedConcurrencyConfig, RDSLayerMapping, VpcConfig } from '../model-datasource';
+import { TransformerDataSourceManagerProvider, DataSourceType } from './transformer-datasource-provider';
 import { TransformerProviderRegistry } from './transformer-provider-registry';
 import { TransformerContextOutputProvider } from './transformer-context-output-provider';
 import { StackManagerProvider } from './stack-manager-provider';
@@ -24,7 +25,8 @@ export interface TransformerContextProvider {
   providerRegistry: TransformerProviderRegistry;
 
   inputDocument: DocumentNode;
-  modelToDatasourceMap: Map<string, DatasourceType>;
+  modelToDatasourceMap: Map<string, DataSourceType>;
+  customSqlDataSourceStrategies?: CustomSqlDataSourceStrategy[];
   datasourceSecretParameterLocations: Map<string, TransformerSecrets>;
   output: TransformerContextOutputProvider;
   stackManager: StackManagerProvider;
@@ -39,12 +41,14 @@ export interface TransformerContextProvider {
   getResolverConfig<ResolverConfig>(): ResolverConfig | undefined;
   readonly sqlLambdaVpcConfig?: VpcConfig;
   readonly rdsLayerMapping?: RDSLayerMapping;
+  readonly sqlLambdaProvisionedConcurrencyConfig?: ProvisionedConcurrencyConfig;
 }
 
 export type TransformerBeforeStepContextProvider = Pick<
   TransformerContextProvider,
   | 'inputDocument'
   | 'modelToDatasourceMap'
+  | 'customSqlDataSourceStrategies'
   | 'transformParameters'
   | 'isProjectUsingDataStore'
   | 'getResolverConfig'
@@ -57,6 +61,7 @@ export type TransformerSchemaVisitStepContextProvider = Pick<
   TransformerContextProvider,
   | 'inputDocument'
   | 'modelToDatasourceMap'
+  | 'customSqlDataSourceStrategies'
   | 'output'
   | 'providerRegistry'
   | 'transformParameters'
@@ -71,6 +76,7 @@ export type TransformerValidationStepContextProvider = Pick<
   TransformerContextProvider,
   | 'inputDocument'
   | 'modelToDatasourceMap'
+  | 'customSqlDataSourceStrategies'
   | 'output'
   | 'providerRegistry'
   | 'dataSources'

package/src/transformer-context/transformer-datasource-provider.ts

@@ -20,23 +20,52 @@ export interface NoneDataSourceProvider {
 export type DataSourceInstance = ITable | CfnDomain | HttpDataSource | IFunction | NoneDataSourceProvider;
 
 export interface TransformerDataSourceManagerProvider {
-  add(type: ObjectTypeDefinitionNode | InterfaceTypeDefinitionNode, dataSourceInstance: DataSourceInstance): void;
-  get(type: ObjectTypeDefinitionNode | InterfaceTypeDefinitionNode): DataSourceInstance;
-  has(name: string): boolean;
+  add: (type: ObjectTypeDefinitionNode | InterfaceTypeDefinitionNode, dataSourceInstance: DataSourceInstance) => void;
+  get: (type: ObjectTypeDefinitionNode | InterfaceTypeDefinitionNode) => DataSourceInstance;
+  has: (name: string) => boolean;
 }
 
 export interface DataSourceProvider extends BackedDataSource {}
 
 /**
- * Supported transformable database types.
+ * Supported transformable database types. TODO: Remove this when we normalize database type handling throughout
  */
-export type DBType = 'DDB' | 'MySQL' | 'Postgres';
+export type DBType = 'DDB' | SQLDBType;
 
 /**
- * Configuration for a datasource. Defines the underlying database engine, and instructs the tranformer whether to provision the database
- * storage or whether it already exists.
+ * Supported transformable SQL database types. TODO: Remove this when we normalize database type handling throughout
  */
-export interface DatasourceType {
+export type SQLDBType = 'MySQL' | 'Postgres';
+
+// TODO: add strategy for the RDS. TODO: Move this to amplify-graphql-api-construct
+export type DataSourceProvisionStrategy = DynamoDBProvisionStrategy | SQLLambdaModelProvisionStrategy;
+
+/**
+ * Provisioning configuration for a DynamoDB datasource. TODO: Remove this type in favor of strategy definitions in
+ * amplify-graphql-api-construct
+ */
+export const enum DynamoDBProvisionStrategy {
+  /**
+   * Use default CloudFormation resource of `AWS::DynamoDB::Table`
+   */
+  DEFAULT = 'DEFAULT',
+  /**
+   * Use custom resource type `Custom::AmplifyDynamoDBTable`
+   */
+  AMPLIFY_TABLE = 'AMPLIFY_TABLE',
+}
+
+// TODO: Remove this type in favor of fully-specified SQLLambdaModelDataSourceStrategy from amplify-graphql-api-construct
+export const enum SQLLambdaModelProvisionStrategy {
+  /**
+   * A strategy that creates a Lambda to connect to a pre-existing SQL table to resolve model data.
+   */
+  DEFAULT = 'DEFAULT',
+}
+
+// TODO: Replace usages of this type with ModelDataSourceStrategy
+export interface DataSourceType {
   dbType: DBType;
   provisionDB: boolean;
+  provisionStrategy: DataSourceProvisionStrategy;
 }