AppSync Javascript resolver implementation

This package provides an implementation for the @aws-appsync/utils package that is available on AWS.

Tip

To ensure you are using the latest version of this package with LocalStack, start LocalStack with the environment variable

APPSYNC_JS_LIBS_VERSION=refresh localstack start

This will fetch the latest version the first time a JavaScript resolver is executed. On next startup this flag is not needed unless the package needs to be updated.

Alternatively the library can be pinned to a specific Git tag or commit by setting: APPSYNC_JS_LIBS_VERSION=<commit or tag>

Requesting functions to be implemented

We do not yet cover all functionality as provided by AWS AppSync. To request missing functions, or to see our function coverage, please see #19.

Development workflow

The test suite has automatic comparison with AWS. The testing workflow looks like:

• Add the test to __tests__/index.test.js passing the string text of the utility you wish to test, for example

test("string", async () => {
  await checkValid(`util.dynamodb.toDynamoDB("test")`);
});

• Run the test against AWS to capture the snapshot:

npm run test:aws

• Run the tests against the local package, using the snapshot for the ground truth

npm run test