Repository files navigation

This repository contains Node.js connectors forAmazon Aurora DSQL, a distributed SQL database service that provides high availability and scalability for PostgreSQL-compatible applications.

Aurora DSQL requires IAM-based authentication with time-limited tokens that existing Node.js PostgreSQL drivers do not natively support. These connectors bridge that gap by providing seamless IAM authentication on top of popular PostgreSQL clients.

Built onnode-postgres, the most popular PostgreSQL client for Node.js. This connector extends the node-postgres Client and Pool with automatic IAM authentication for Aurora DSQL.

View Documentation

Sample Usage

Built onPostgres.js, a fast and modern PostgreSQL client. This connector provides IAM authentication while maintaining Postgres.js's tagged template literal query syntax.

View Documentation

Sample Usage

Both connectors provide:

• Automatic IAM Authentication - Handles DSQL token generation and refresh
• Seamless Integration - Built on popular PostgreSQL clients to support existing PostgreSQL applications
• Region Auto-Discovery - Extracts AWS region from DSQL cluster hostname
• Full TypeScript Support - Complete type safety for your applications
• Custom Credentials - Support for custom AWS credential providers

• Node.js 20+
• AWS credentials configured (via AWS CLI, environment variables, or IAM roles)
• Access to an Aurora DSQL cluster

SeeCONTRIBUTING for more information.

This project is licensed under the Apache License 2.0. SeeLICENSE for details.