feat(nested-clients): create nested clients for internal sts usage

Author: kuhe

packages/nested-clients/CHANGELOG.md

@@ -0,0 +1,72 @@
+# @aws-sdk/rds-signer
+
+[![NPM version](https://img.shields.io/npm/v/@aws-sdk/rds-signer/latest.svg)](https://www.npmjs.com/package/@aws-sdk/rds-signer)
+[![NPM downloads](https://img.shields.io/npm/dm/@aws-sdk/rds-signer.svg)](https://www.npmjs.com/package/@aws-sdk/rds-signer)
+
+## Description
+
+This package provides utilities for interacting with RDS.
+
+## Installation
+
+```console
+npm install @aws-sdk/rds-signer
+```
+
+## Getting Started
+
+### Import
+
+ES6 import
+
+```js
+import { Signer } from "@aws-sdk/rds-signer";
+```
+
+Or CommonJS import
+
+```js
+const { Signer } = require("@aws-sdk/rds-signer");
+```
+
+### Generate Authentication Token for RDS IAM Authentication
+
+```js
+const signer = new Signer({
+  /**
+   * Required. The hostname of the database to connect to.
+   */
+  hostname: "db.us-east-1.rds.amazonaws.com",
+  /**
+   * Required. The port number the database is listening on.
+   */
+  port: 8000,
+  /**
+   * Required. The username to login as.
+   */
+  username: "user1",
+  /**
+   * Optional. The AWS credentials to sign requests with. Uses the default credential provider chain in not specified.
+   */
+  credentials: fromNodeCredentialProvider(),
+  /**
+   * Optional. The region the database is located in. Uses the region inferred from the runtime if omitted.
+   */
+  region: "us-east-1",
+  /**
+   * Optional. The SHA256 hasher constructor to sign the request.
+   */
+  sha256: HashCtor,
+});
+
+const token = await signer.getAuthToken();
+// Use this token as the password for connecting to your RDS instance
+```
+
+For more details and examples, refer to the following resources. Usage is similar across DB engines.
+
+- [Connecting to your DB instance using IAM authentication](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.Connecting.html)
+- [IAM database authentication for MySQL and PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html)
+- [Using IAM authentication to connect with pgAdmin Amazon Aurora PostgreSQL or Amazon RDS for PostgreSQL](https://aws.amazon.com/blogs/database/using-iam-authentication-to-connect-with-pgadmin-amazon-aurora-postgresql-or-amazon-rds-for-postgresql/)
+- [Use IAM authentication to connect with SQL Workbench/J to Amazon Aurora MySQL or Amazon RDS for MySQL](https://aws.amazon.com/blogs/database/use-iam-authentication-to-connect-with-sql-workbenchj-to-amazon-aurora-mysql-or-amazon-rds-for-mysql/)
+- [AWS CLI v2 rds generate-db-auth-token Documentation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/generate-db-auth-token.html)

packages/nested-clients/README.md

@@ -0,0 +1,4 @@
+{
+  "extends": "../../api-extractor.packages.json",
+  "mainEntryPointFilePath": "./dist-types/index.d.ts"
+}

packages/nested-clients/api-extractor.json

@@ -0,0 +1,55 @@
+{
+  "name": "@aws-sdk/nested-clients",
+  "version": "3.0.0",
+  "description": "Nested clients for AWS SDK packages.",
+  "main": "./dist-cjs/index.js",
+  "module": "./dist-es/index.js",
+  "types": "./dist-types/index.d.ts",
+  "scripts": {
+    "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
+    "build:cjs": "node ../../scripts/compilation/inline nested-clients",
+    "build:es": "tsc -p tsconfig.es.json",
+    "build:include:deps": "lerna run --scope $npm_package_name --include-dependencies build",
+    "build:types": "tsc -p tsconfig.types.json",
+    "build:types:downlevel": "downlevel-dts dist-types dist-types/ts3.4",
+    "clean": "rimraf ./dist-* && rimraf *.tsbuildinfo",
+    "extract:docs": "api-extractor run --local",
+    "test": "yarn g:vitest run",
+    "test:watch": "yarn g:vitest watch"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "author": {
+    "name": "AWS SDK for JavaScript Team",
+    "url": "https://aws.amazon.com/javascript/"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "tslib": "^2.6.2"
+  },
+  "devDependencies": {
+    "concurrently": "7.0.0",
+    "downlevel-dts": "0.10.1",
+    "rimraf": "3.0.2",
+    "typescript": "~5.2.2"
+  },
+  "typesVersions": {
+    "<4.0": {
+      "dist-types/*": [
+        "dist-types/ts3.4/*"
+      ]
+    }
+  },
+  "files": [
+    "dist-*/**"
+  ],
+  "browser": {},
+  "react-native": {},
+  "homepage": "https://github.com/aws/aws-sdk-js-v3/tree/main/packages/nested-clients",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aws/aws-sdk-js-v3.git",
+    "directory": "packages/nested-clients"
+  }
+}

packages/nested-clients/package.json

@@ -0,0 +1 @@
+export {};

packages/nested-clients/src/index.ts

@@ -0,0 +1,9 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "outDir": "dist-cjs",
+    "rootDir": "src"
+  },
+  "extends": "../../tsconfig.cjs.json",
+  "include": ["src/"]
+}

packages/nested-clients/tsconfig.cjs.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "lib": ["dom"],
+    "outDir": "dist-es",
+    "rootDir": "src"
+  },
+  "extends": "../../tsconfig.es.json",
+  "include": ["src/"]
+}

packages/nested-clients/tsconfig.es.json

@@ -0,0 +1,9 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "declarationDir": "dist-types",
+    "rootDir": "src"
+  },
+  "extends": "../../tsconfig.types.json",
+  "include": ["src/"]
+}

packages/nested-clients/tsconfig.types.json

@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    exclude: ["**/*.{integ,e2e,browser}.spec.ts"],
+    include: ["**/*.spec.ts"],
+    environment: "node",
+  },
+});