appsync-client-node

Lightweight AWS AppSync client for Node.js (optimized for AWS Lambda Node.js runtime(s)):

• supports IAM and API Key authentications
• supports XRay tracing or OpenTelemetry Lambda layers auto-instrumentation
• allow to specify URL via environment variable (GRAPHQL_API_ENDPOINT_ENV_NAME)
• properly handles timeouts, abort signal and retries connection-reset errors
• comes with lightweight gql tag (just stipes whitespace and comments) for prettier, GraphQL VSCode syntax highlighting, etc.
• ESM and CommonJs modules
• TypeScript generics support for variables and results
• depends only on @aws-sdk v3 (that comes built-in on Node 18.x lambda runtime) and aws-xray-sdk-core that results in very small bundle (when used with CDK NodejsFunction)
• MIT licensed

Usage

1import { appSyncClient, gql } from "appsync-client-node";
2
3const books = await appSyncClient<ReturnValueType, { author: string }>({
4  query: gql`
5    query books($author: String!) {
6      books(author: $author) {
7        ...BookFragment
8      }
9    }
10  `,
11  variables: {
12    author: "Remark",
13  },
14});

License

MIT