Enhanced Testing Infrastructure and Query Coverage:

- Added test query files (air-routes-queries.json, custom-air-routes-queries.json) with GraphQL queries covering filters, sorting, pagination, variables, fragments, and custom directives
- Added manual integration test files for AppSync and Apollo Server validation which can be executed against an airports API that was deployed using the graphQL utility

Additional change to fix the existing Case01 queries which were using the old method of filtering to use the enhanced string comparison filtering.

Added changelog.

Author: andreachild

.jest.js

@@ -2,6 +2,14 @@ export default {
     'transform': {},
     'verbose': true,
     'testSequencer': './test/jestTestSequencer.js',
+    'testPathIgnorePatterns': [
+        '/node_modules/',
+        // tests below are intended to be executed manually
+        'appSyncAirRoutesQueries.test.js',
+        'appSyncCustomAirRoutesQueries.test.js',
+        'apolloAirRoutesQueries.test.js',
+        'apolloCustomAirRoutesQueries.test.js'
+    ],
     'globals': {
         // neptune db that has pre-loaded air routes sample data host and port
         // ex. db-neptune-foo-bar.cluster-abc.us-west-2.neptune.amazonaws.com

CHANGELOG.md

@@ -78,6 +78,8 @@ permissions and limitations under the License.
 * Allow credentials to be refreshed at Apollo runtime by passing the credential
   provider to the
   interceptor  ([#134](https://github.com/aws/amazon-neptune-for-graphql/pull/134))
+* Added manually executed query integration test suites for App Sync and
+  Apollo ([#138](https://github.com/aws/amazon-neptune-for-graphql/pull/138))
 
 ### Bug Fixes
 

TESTING.md

@@ -19,7 +19,7 @@ the following command:
 npm run test:unit
 ```
 
-## Integration Tests
+## Automated Integration Tests
 
 Integration tests execute against a live neptune db cluster or graph and require
 the following prerequisites to run:
@@ -54,6 +54,66 @@ To execute the integration tests use the following command:
 npm run test:integration
 ```
 
+## Manual Integration Tests
+
+In addition to the automated integration tests, there are manual integration
+tests that can be run against live AWS AppSync APIs and Apollo Server instances
+that were deployed via the Amazon Neptune Utility for GraphQL. These tests are
+useful for validating deployed GraphQL APIs that are interfacing Neptune db or
+analytics graphs loaded with the airports sample data.
+
+### AppSync Manual Tests
+
+These tests execute queries against a deployed AWS AppSync API:
+
+#### Standard AppSync Queries
+
+```
+node --experimental-vm-modules node_modules/jest/bin/jest.js test/appSyncAirRoutesQueries.test.js
+```
+
+#### Custom AppSync Queries
+
+```
+node --experimental-vm-modules node_modules/jest/bin/jest.js test/appSyncCustomAirRoutesQueries.test.js
+```
+
+**Prerequisites for AppSync tests:**
+
+- Set environment variables:
+  ```
+  export APP_SYNC_API_ID=your-appsync-api-id
+  export APP_SYNC_API_KEY=your-api-key
+  export APP_SYNC_REGION=your-aws-region
+  ```
+
+### Apollo Server Manual Tests
+
+These tests execute queries against a local Apollo Server instance:
+
+#### Standard Apollo Queries
+
+```
+node --experimental-vm-modules node_modules/jest/bin/jest.js test/apolloAirRoutesQueries.test.js
+```
+
+#### Custom Apollo Queries
+
+```
+node --experimental-vm-modules node_modules/jest/bin/jest.js test/apolloCustomAirRoutesQueries.test.js
+```
+
+### Test Query Suites
+
+Both test suites use JSON files containing GraphQL queries and expected results:
+
+- **`air-routes-queries.json`**: Standard queries including filters, sorting,
+  pagination, variables, and fragments
+- **`custom-air-routes-queries.json`**: Custom queries using `@graphQuery`
+  directives, Gremlin queries, and custom field resolvers. These queries assume
+  that the utility was executed with option
+  `--input-schema-changes-file ./test/air-routes-changes.json`
+
 ## Loading Airports Sample Data Into Neptune
 
 The easiest way to load the airports sample data into Neptune is using

test/TestCases/Case01/queries/Query0002.json

@@ -1,7 +1,7 @@
 {  
     "name": "getAirport _id",
     "description": "Get neptune _id",
-    "graphql": "query MyQuery {\n getAirport(code: \"SEA\") {\n code\n }\n }",
+    "graphql": "query MyQuery {\n getAirport(filter: {code: {eq: \"SEA\"}}) {\n code\n }\n }",
     "result":{
         "code": "SEA"
     }

test/TestCases/Case01/queries/Query0003.json

@@ -2,7 +2,7 @@
     "id": "3",
     "name": "getAirport nested type",
     "description": "Nested types single and array, references in and out",
-    "graphql": "query MyQuery {\n getAirport(code: \"YKM\") {\n city\n continentContainsIn {\n desc\n }\n countryContainsIn {\n desc\n }\n airportRoutesOut {\n code\n }\n }\n }",
+    "graphql": "query MyQuery {\n getAirport(filter: {code: {eq: \"YKM\"}}) {\n city\n continentContainsIn {\n desc\n }\n countryContainsIn {\n desc\n }\n airportRoutesOut {\n code\n }\n }\n }",
     "result":{
         "airportRoutesOut": [
           {

test/TestCases/Case01/queries/Query0004.json

@@ -1,7 +1,7 @@
 {
     "name": "Edge properties 2",
     "description": "Get edge properties in nested array",
-    "graphql": "query MyQuery {\n getAirport(code: \"SEA\") {\n airportRoutesOut {\n code\n route {\n dist\n }\n }\n }\n }\n", 
+    "graphql": "query MyQuery {\n getAirport(filter: {code: {eq: \"SEA\"}}) {\n airportRoutesOut {\n code\n route {\n dist\n }\n }\n }\n }\n", 
     "result": {
         "airportRoutesOut": [
           {

test/TestCases/Case01/queries/Query0005.json

@@ -1,7 +1,7 @@
 {
     "name": "Type graph query 1",
     "description": "Type with graph query returning a scalar",
-    "graphql": "query MyQuery {\n getAirport(code: \"YYZ\") {\n outboundRoutesCount\n }\n }\n",
+    "graphql": "query MyQuery {\n getAirport(filter: {code: {eq: \"YYZ\"}}) {\n outboundRoutesCount\n }\n }\n",
     "result": {
         "outboundRoutesCount": 195
       }

test/air-routes-changes.json

@@ -0,0 +1,38 @@
+[
+  {
+    "type": "Airport",
+    "field": "outboundRoutesCount",
+    "action": "add",
+    "value": "outboundRoutesCount: Int @graphQuery(statement: \"MATCH (this)-[r:route]->(a) RETURN count(r)\")"
+  },
+  {
+    "type": "Query",
+    "field": "getAirportWithGremlin",
+    "action": "add",
+    "value": "getAirportWithGremlin(code:String): Airport @graphQuery(statement: \"g.V().has('airport', 'code', '$code').elementMap()\")"
+  },
+  {
+    "type": "Query",
+    "field": "getContinentsWithGremlin",
+    "action": "add",
+    "value": "getContinentsWithGremlin: [Continent] @cypher(statement: \"g.V().hasLabel('continent').order().elementMap().fold()\")"
+  },
+  {
+    "type": "Query",
+    "field": "getAirportByCode",
+    "action": "add",
+    "value": "getAirportByCode(code:String): Airport @graphQuery(statement: \"MATCH (this: airport {code: '$code'})\")"
+  },
+  {
+    "type": "Query",
+    "field": "getCountriesCountGremlin",
+    "action": "add",
+    "value": "getCountriesCountGremlin: Int @graphQuery(statement: \"g.V().hasLabel('country').count()\")"
+  },
+  {
+    "type": "Query",
+    "field": "getAirportConnection",
+    "action": "add",
+    "value": "getAirportConnection(fromCode: String!, toCode: String!): Airport @cypher(statement: \"MATCH (:airport{code: '$fromCode'})-[:route]->(this:airport)-[:route]->(:airport{code:'$toCode'})\")"
+  }
+]