@aws-amplify/graphql-api-construct 1.16.1-ai-next.0 → 1.17.0

package/node_modules/graphql-transformer-common/CHANGELOG.md

@@ -3,7 +3,7 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [5.1.1-ai-next.0](https://github.com/aws-amplify/amplify-category-api/compare/graphql-transformer-common@5.1.0...graphql-transformer-common@5.1.1-ai-next.0) (2024-11-01)
+## [5.1.1](https://github.com/aws-amplify/amplify-category-api/compare/graphql-transformer-common@5.1.0...graphql-transformer-common@5.1.1) (2024-11-08)
 
 **Note:** Version bump only for package graphql-transformer-common
 

package/node_modules/graphql-transformer-common/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphql-transformer-common",
-  "version": "5.1.1-ai-next.0",
+  "version": "5.1.1",
   "description": "Common code and constants for AppSync Transformers",
   "repository": {
     "type": "git",
@@ -73,5 +73,5 @@
       "printBasicPrototype": true
     }
   },
-  "gitHead": "7e91c8e2fdf06534f35f663db8cfff1c3b7fad9e"
+  "gitHead": "a6ab93200105e655183d8e8bab387797e7a5553d"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-amplify/graphql-api-construct",
-  "version": "1.16.1-ai-next.0",
+  "version": "1.17.0",
   "description": "AppSync GraphQL Api Construct using Amplify GraphQL Transformer.",
   "repository": {
     "type": "git",
@@ -158,26 +158,26 @@
     "semver"
   ],
   "dependencies": {
-    "@aws-amplify/ai-constructs": "0.0.0-test-20241029211113",
+    "@aws-amplify/ai-constructs": "0.8.0",
     "@aws-amplify/backend-output-schemas": "^1.0.0",
     "@aws-amplify/backend-output-storage": "^1.0.0",
-    "@aws-amplify/graphql-auth-transformer": "4.1.6-ai-next.0",
-    "@aws-amplify/graphql-conversation-transformer": "0.5.1-ai-next.0",
-    "@aws-amplify/graphql-default-value-transformer": "3.1.3-ai-next.0",
-    "@aws-amplify/graphql-directives": "2.4.0",
-    "@aws-amplify/graphql-function-transformer": "3.1.5-ai-next.0",
-    "@aws-amplify/graphql-generation-transformer": "0.2.6-ai-next.0",
-    "@aws-amplify/graphql-http-transformer": "3.0.8-ai-next.0",
-    "@aws-amplify/graphql-index-transformer": "3.0.8-ai-next.0",
-    "@aws-amplify/graphql-maps-to-transformer": "4.0.8-ai-next.0",
-    "@aws-amplify/graphql-model-transformer": "3.0.8-ai-next.0",
-    "@aws-amplify/graphql-predictions-transformer": "3.0.8-ai-next.0",
-    "@aws-amplify/graphql-relational-transformer": "3.0.8-ai-next.0",
-    "@aws-amplify/graphql-searchable-transformer": "3.0.8-ai-next.0",
-    "@aws-amplify/graphql-sql-transformer": "0.4.8-ai-next.0",
-    "@aws-amplify/graphql-transformer": "2.1.6-ai-next.0",
-    "@aws-amplify/graphql-transformer-core": "3.2.3-ai-next.0",
-    "@aws-amplify/graphql-transformer-interfaces": "4.1.2",
+    "@aws-amplify/graphql-auth-transformer": "4.1.6",
+    "@aws-amplify/graphql-conversation-transformer": "0.6.0",
+    "@aws-amplify/graphql-default-value-transformer": "3.1.3",
+    "@aws-amplify/graphql-directives": "2.5.0",
+    "@aws-amplify/graphql-function-transformer": "3.1.5",
+    "@aws-amplify/graphql-generation-transformer": "0.2.6",
+    "@aws-amplify/graphql-http-transformer": "3.0.8",
+    "@aws-amplify/graphql-index-transformer": "3.0.8",
+    "@aws-amplify/graphql-maps-to-transformer": "4.0.8",
+    "@aws-amplify/graphql-model-transformer": "3.1.0",
+    "@aws-amplify/graphql-predictions-transformer": "3.0.8",
+    "@aws-amplify/graphql-relational-transformer": "3.1.0",
+    "@aws-amplify/graphql-searchable-transformer": "3.0.8",
+    "@aws-amplify/graphql-sql-transformer": "0.4.8",
+    "@aws-amplify/graphql-transformer": "2.1.6",
+    "@aws-amplify/graphql-transformer-core": "3.3.0",
+    "@aws-amplify/graphql-transformer-interfaces": "4.2.0",
     "@aws-amplify/platform-core": "^1.0.0",
     "@aws-amplify/plugin-types": "^1.0.0",
     "@aws-crypto/crc32": "5.2.0",
@@ -261,7 +261,7 @@
     "graceful-fs": "^4.2.0",
     "graphql": "^15.5.0",
     "graphql-mapping-template": "5.0.1",
-    "graphql-transformer-common": "5.1.1-ai-next.0",
+    "graphql-transformer-common": "5.1.1",
     "hjson": "^3.2.2",
     "immer": "^9.0.12",
     "is-buffer": "~1.1.6",
@@ -282,7 +282,7 @@
     "zod": "^3.22.2"
   },
   "devDependencies": {
-    "@aws-amplify/graphql-transformer-test-utils": "1.0.7-ai-next.0",
+    "@aws-amplify/graphql-transformer-test-utils": "1.0.7",
     "@types/fs-extra": "^8.0.1",
     "@types/node": "^18.0.0",
     "aws-cdk-lib": "2.158.0",
@@ -353,5 +353,5 @@
       "printBasicPrototype": true
     }
   },
-  "gitHead": "7e91c8e2fdf06534f35f663db8cfff1c3b7fad9e"
+  "gitHead": "a6ab93200105e655183d8e8bab387797e7a5553d"
 }

package/src/amplify-graphql-api.ts

@@ -1,7 +1,7 @@
 import * as path from 'path';
 import { Construct } from 'constructs';
 import { ExecuteTransformConfig, executeTransform } from '@aws-amplify/graphql-transformer';
-import { NestedStack, Stack } from 'aws-cdk-lib';
+import { NestedStack, Stack, Annotations } from 'aws-cdk-lib';
 import { AttributionMetadataStorage, StackMetadataBackendOutputStorageStrategy } from '@aws-amplify/backend-output-storage';
 import { graphqlOutputKey } from '@aws-amplify/backend-output-schemas';
 import type { GraphqlOutput, AwsAppsyncAuthenticationType } from '@aws-amplify/backend-output-schemas';
@@ -50,6 +50,7 @@ import {
 import { getStackForScope, walkAndProcessNodes } from './internal/construct-tree';
 import { getDataSourceStrategiesProvider } from './internal/data-source-config';
 import { getMetadataDataSources, getMetadataAuthorizationModes, getMetadataCustomOperations } from './internal/metadata';
+import { isImportedAmplifyDynamoDbModelDataSourceStrategy } from '@aws-amplify/graphql-transformer-core';
 
 /**
  * L3 Construct which invokes the Amplify Transformer Pattern over an input Graphql Schema.
@@ -160,6 +161,20 @@ export class AmplifyGraphqlApi extends Construct {
       dataStoreConfiguration,
     } = props;
 
+    // TODO: GEN1_GEN2_MIGRATION
+    // print warning when using experimental features.
+    // remove this code block when the feature is released.
+    // start block
+    const usingImportedAmplifyDynamoDbModelDataSourceStrategy = Object.values(definition.dataSourceStrategies).some((strategy) => {
+      return isImportedAmplifyDynamoDbModelDataSourceStrategy(strategy);
+    });
+    if (usingImportedAmplifyDynamoDbModelDataSourceStrategy) {
+      Annotations.of(this).addWarning(
+        'ImportedAmplifyDynamoDbModelDataSourceStrategy is experimental and is not recommended for production use. This functionality may be changed or removed without warning.',
+      );
+    }
+    // end block
+
     if (conflictResolution && dataStoreConfiguration) {
       throw new Error(
         'conflictResolution is deprecated. conflictResolution and dataStoreConfiguration cannot be used together. Please use dataStoreConfiguration.',

package/src/model-datasource-strategy-types.ts

@@ -12,6 +12,7 @@
 export type ModelDataSourceStrategy =
   | DefaultDynamoDbModelDataSourceStrategy
   | AmplifyDynamoDbModelDataSourceStrategy
+  | ImportedAmplifyDynamoDbModelDataSourceStrategy
   | SQLLambdaModelDataSourceStrategy;
 
 /**
@@ -40,6 +41,30 @@ export interface AmplifyDynamoDbModelDataSourceStrategy {
   readonly provisionStrategy: 'AMPLIFY_TABLE';
 }
 
+// TODO: GEN1_GEN2_MIGRATION
+// remove @experimental tag
+// Decide final naming of API
+/**
+ * Use custom resource type 'Custom::ImportedAmplifyDynamoDBTable' to manage an imported table.
+ *
+ * Tables can be imported only if they meet the following criteria.
+ * 1. The imported table must have been created with through an Amplify Gen 1 project.
+ * 2. The imported table must be in the same account and region as this construct.
+ * 3. The imported table properties must match the corresponding table properties specified in this construct.
+ *    (AttributeDefinitions, KeySchema, GlobalSecondaryIndexes, BillingModeSummary, ProvisionedThroughput, StreamSpecification, SSEDescription, DeletionProtectionEnabled)
+ *
+ * The imported tables will follow the auth rules defined in this construct.
+ * The auth rules of the source Gen 1 project will not apply to the API created by this construct.
+ * Ensure the correct auth rules have been set to prevent data exposure.
+ *
+ * @experimental Not recommended for production use. This functionality may be changed or removed without warning.
+ */
+export interface ImportedAmplifyDynamoDbModelDataSourceStrategy {
+  readonly dbType: 'DYNAMODB';
+  readonly provisionStrategy: 'IMPORTED_AMPLIFY_TABLE';
+  readonly tableName: string;
+}
+
 /**
  * A strategy that creates a Lambda to connect to a pre-existing SQL table to resolve model data.
  */

package/src/types.ts

@@ -753,7 +753,7 @@ export interface AmplifyGraphqlApiProps {
   readonly translationBehavior?: PartialTranslationBehavior;
 
   /**
-   * Strategy to store construct outputs. If no outputStorageStrategey is provided a default strategy will be used.
+   * Strategy to store construct outputs. If no outputStorageStrategy is provided a default strategy will be used.
    */
   readonly outputStorageStrategy?: IBackendOutputStorageStrategy;