Merge branch 'main' into fix/bobbor/14653

Author: sarayev

.gitallowed

@@ -0,0 +1,4 @@
+# The following regexes are exceptions for git-secrets - https://github.com/awslabs/git-secrets
+
+# The only AWS account number allowed to be used in tests
+ACCOUNT_ID = '123456789012';

.github/workflows/callable-git-secrets-check.yml

@@ -0,0 +1,25 @@
+name: Git Secrets Check
+on: workflow_call
+
+jobs:
+  git_secrets_check:
+    name: Scan for secrets
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
+        with:
+          path: amplify-js
+
+      - name: Install git-secrets
+        run: |
+          git clone https://github.com/awslabs/git-secrets.git
+          cd git-secrets
+          sudo make install
+
+      - name: Register AWS patterns and scan
+        working-directory: ./amplify-js
+        run: |
+          git secrets --register-aws
+          # Scan only the files in the current checkout (PR merge commit)
+          git secrets --scan

.github/workflows/pr.yml

@@ -43,6 +43,8 @@ jobs:
   dependency-review:
     needs: prebuild
     uses: ./.github/workflows/callable-dependency-review.yml
+  git-secrets-check:
+    uses: ./.github/workflows/callable-git-secrets-check.yml
   all-unit-tests-pass:
     name: Unit and Bundle tests have passed
     needs:
@@ -52,6 +54,7 @@ jobs:
       - github-actions-test
       - tsc-compliance-test
       - dependency-review
+      - git-secrets-check
     runs-on: ubuntu-latest
     if: success() # only run when all checks have passed
     # store success output flag for ci job

.husky/pre-push

@@ -0,0 +1,24 @@
+#!/usr/bin/env sh
+
+# Pre-push hook to scan for secrets using git-secrets
+# This prevents accidentally pushing AWS credentials or other secrets
+
+# Check if git-secrets is installed
+if ! command -v git-secrets >/dev/null 2>&1; then
+  echo ""
+  echo "ERROR: git-secrets is not installed."
+  echo ""
+  echo "Please install git-secrets to continue:"
+  echo ""
+  echo "  macOS:   brew install git-secrets"
+  echo "  Linux:   See https://github.com/awslabs/git-secrets#installing-git-secrets"
+  echo "  Windows: See https://github.com/awslabs/git-secrets#installing-git-secrets"
+  echo ""
+  echo "After installation, register AWS patterns:"
+  echo "  git secrets --register-aws"
+  echo ""
+  exit 1
+fi
+
+# Run git-secrets scan and propagate exit code
+git secrets --scan

CONTRIBUTING.md

@@ -8,6 +8,7 @@ Whether it's a bug report, new feature, correction, or additional documentation,
 - [Our Design](#our-design)
 - [Development Process](#development-process)
   - [Setting up for local development](#setting-up-for-local-development)
+  - [Setting up git-secrets](#setting-up-git-secrets)
   - [Architecture of the codebase](#architecture-of-the-codebase)
   - [Steps towards contributions](#steps-towards-contributions)
 - [Bug Reports](#bug-reports)
@@ -68,6 +69,74 @@ yarn build
 
 > Note: Make sure to always [sync your fork](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/syncing-a-fork) with main branch of `amplify-js`
 
+## Setting up git-secrets
+
+This repository uses [git-secrets](https://github.com/awslabs/git-secrets) to prevent accidentally pushing AWS credentials or other secrets. A pre-push hook will scan your commits before pushing to the remote repository.
+
+### Installing git-secrets
+
+**macOS (using Homebrew):**
+
+```bash
+brew install git-secrets
+```
+
+**Linux (Debian/Ubuntu):**
+
+```bash
+sudo apt-get install git-secrets
+```
+
+**Linux (manual installation):**
+
+```bash
+git clone https://github.com/awslabs/git-secrets.git
+cd git-secrets
+sudo make install
+```
+
+**Windows (manual installation):**
+
+1. Clone the repository: `git clone https://github.com/awslabs/git-secrets.git`
+2. Add the `git-secrets` directory to your PATH
+3. Alternatively, copy `git-secrets` to a directory already in your PATH
+
+### Registering AWS patterns
+
+After installing git-secrets, register the AWS secret patterns in your local repository:
+
+```bash
+git secrets --register-aws
+```
+
+This registers patterns to detect:
+
+- AWS Access Key IDs (e.g., `AKIAIOSFODNN7EXAMPLE`)
+- AWS Secret Access Keys
+- AWS Session Tokens
+
+You can verify the registered patterns with:
+
+```bash
+git secrets --list
+```
+
+### Handling false positives
+
+If git-secrets flags a legitimate string as a potential secret (false positive), you can add an allowed pattern:
+
+```bash
+# Allow a specific pattern
+git secrets --add --allowed 'AKIAIOSFODNN7EXAMPLE'
+
+# Allow patterns matching a regex
+git secrets --add --allowed 'my-test-pattern.*'
+```
+
+Allowed patterns are stored in `.git/config` and apply only to your local repository.
+
+> **Note:** The pre-push hook will block pushes if git-secrets is not installed. Please install and configure git-secrets before contributing.
+
 ## Architecture of the codebase
 
 Amplify JS is a monorepo built with `Yarn` and `Lerna`. All the categories of Amplify live within the `packages` directory in the root. Each category inside packages has its own `src/` and `package.json`.

docs/api/assets/navigation.js

@@ -2,7 +2,7 @@
 </head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os"</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><div class="table-cell" id="tsd-search" data-base=".."><div class="field"><label for="tsd-search-field" class="tsd-widget tsd-toolbar-icon search no-caption"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="#icon-search"></use></svg></label><input type="text" id="tsd-search-field" aria-label="Search"/></div><div class="field"><div id="tsd-toolbar-links"><a href="https://docs.amplify.aws/">Library Documentation</a><a href="https://www.npmjs.com/package/aws-amplify">NPM</a><a href="https://github.com/aws-amplify/amplify-js">GitHub</a></div></div><ul class="results"><li class="state loading">Preparing search index...</li><li class="state failure">The search index is not available</li></ul><a href="../index.html" class="title">Amplify JS API Documentation</a></div><div class="table-cell" id="tsd-widgets"><a href="#" class="tsd-widget tsd-toolbar-icon menu no-caption" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="#icon-menu"></use></svg></a></div></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb"><li><a href="../index.html">Amplify JS API Documentation</a></li><li><a href="../modules/_aws_amplify_adapter_nextjs.html">@aws-amplify/adapter-nextjs</a></li><li><a href="../modules/_aws_amplify_adapter_nextjs.index.html">index</a></li><li><a href="../modules/_aws_amplify_adapter_nextjs.index._Reference_Types_.html">&lt;Reference Types&gt;</a></li><li><a href="_aws_amplify_adapter_nextjs.index._Reference_Types_.Blob.html">Blob</a></li></ul><h1>Class Blob</h1></div><section class="tsd-panel tsd-comment"><div class="tsd-comment tsd-typography"><p>A <a href="https://developer.mozilla.org/en-US/docs/Web/API/Blob"><code>Blob</code></a> encapsulates immutable, raw data that can be safely shared across
 multiple worker threads.</p>
 </div><div class="tsd-comment tsd-typography"><h4>Since</h4><p>v15.7.0, v14.18.0</p>
-</div></section><section class="tsd-panel tsd-hierarchy"><h4>Hierarchy (<a class="link" href="../hierarchy.html#@aws-amplify/adapter-nextjs.index.<Reference Types>.Blob">view full</a>)</h4><ul class="tsd-hierarchy"><li><span class="target">Blob</span><ul class="tsd-hierarchy"><li><a href="../modules/_aws_amplify_adapter_nextjs.index._Reference_Types_.__home_runner_work_amplify_js_amplify_js_amplify_js_packages_adapter_nextjs_node_modules_undici_types_index_.html" class="tsd-signature-type tsd-kind-namespace">&quot;/home/runner/work/amplify-js/amplify-js/amplify-js/packages/adapter-nextjs/node_modules/undici-types/index&quot;</a><span class="tsd-signature-symbol">.</span><a href="_aws_amplify_adapter_nextjs.index._Reference_Types_.__home_runner_work_amplify_js_amplify_js_amplify_js_packages_adapter_nextjs_node_modules_undici_types_index_.File.html" class="tsd-signature-type tsd-kind-class">File</a></li></ul></li></ul></section><section class="tsd-panel-group tsd-index-group"><section class="tsd-panel tsd-index-panel"><details class="tsd-index-content tsd-index-accordion" open><summary class="tsd-accordion-summary tsd-index-summary"><h5 class="tsd-index-heading uppercase" role="button" aria-expanded="false" tabIndex="0"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="#icon-chevronSmall"></use></svg> Index</h5></summary><div class="tsd-accordion-details"><section class="tsd-index-section"><h3 class="tsd-index-heading">Constructors</h3><div class="tsd-index-list"><a href="_aws_amplify_adapter_nextjs.index._Reference_Types_.Blob.html#constructor" class="tsd-index-link tsd-is-external"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-512"></use></svg><span>constructor</span></a>
+</div></section><section class="tsd-panel tsd-hierarchy"><h4>Hierarchy (<a class="link" href="../hierarchy.html#@aws-amplify/adapter-nextjs.index.<Reference Types>.Blob">view full</a>)</h4><ul class="tsd-hierarchy"><li><span class="target">Blob</span><ul class="tsd-hierarchy"><li><a href="../modules/_aws_amplify_adapter_nextjs.index._Reference_Types_.__Volumes_workplace_Amplify_amplify_js_packages_adapter_nextjs_node_modules_undici_types_index_.html" class="tsd-signature-type tsd-kind-namespace">&quot;/Volumes/workplace/Amplify/amplify-js/packages/adapter-nextjs/node_modules/undici-types/index&quot;</a><span class="tsd-signature-symbol">.</span><a href="_aws_amplify_adapter_nextjs.index._Reference_Types_.__Volumes_workplace_Amplify_amplify_js_packages_adapter_nextjs_node_modules_undici_types_index_.File.html" class="tsd-signature-type tsd-kind-class">File</a></li></ul></li></ul></section><section class="tsd-panel-group tsd-index-group"><section class="tsd-panel tsd-index-panel"><details class="tsd-index-content tsd-index-accordion" open><summary class="tsd-accordion-summary tsd-index-summary"><h5 class="tsd-index-heading uppercase" role="button" aria-expanded="false" tabIndex="0"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="#icon-chevronSmall"></use></svg> Index</h5></summary><div class="tsd-accordion-details"><section class="tsd-index-section"><h3 class="tsd-index-heading">Constructors</h3><div class="tsd-index-list"><a href="_aws_amplify_adapter_nextjs.index._Reference_Types_.Blob.html#constructor" class="tsd-index-link tsd-is-external"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-512"></use></svg><span>constructor</span></a>
 </div></section><section class="tsd-index-section"><h3 class="tsd-index-heading">Properties</h3><div class="tsd-index-list"><a href="_aws_amplify_adapter_nextjs.index._Reference_Types_.Blob.html#size" class="tsd-index-link tsd-is-external"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-1024"></use></svg><span>size</span></a>
 <a href="_aws_amplify_adapter_nextjs.index._Reference_Types_.Blob.html#type" class="tsd-index-link tsd-is-external"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-1024"></use></svg><span>type</span></a>
 </div></section><section class="tsd-index-section"><h3 class="tsd-index-heading">Methods</h3><div class="tsd-index-list"><a href="_aws_amplify_adapter_nextjs.index._Reference_Types_.Blob.html#arrayBuffer" class="tsd-index-link tsd-is-external"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="#icon-2048"></use></svg><span>array<wbr/>Buffer</span></a>