V5 stable

.github/actions/setup-samples-staging/action.yml

@@ -34,7 +34,7 @@ runs:
       env:
         BRANCH: ${{ github.ref_name }}
       run: |
-        if git ls-remote origin $BRANCH | grep -q refs/heads/next/$BRANCH$; then
+        if git ls-remote origin $BRANCH | grep -q refs/heads/$BRANCH$; then
             # Branch exists, checkout and echo success message
             git fetch origin $BRANCH
             git checkout $BRANCH

.github/workflows/callable-canary-e2e.yml

@@ -15,7 +15,7 @@ jobs:
   prebuild-macos:
     uses: ./.github/workflows/callable-prebuild-amplify-js.yml
     with:
-      runs_on: macos-latest
+      runs_on: macos-12
   prebuild-samples-staging:
     secrets: inherit
     uses: ./.github/workflows/callable-prebuild-samples-staging.yml

.github/workflows/callable-e2e-test-detox.yml

@@ -17,7 +17,7 @@ on:
 jobs:
   e2e-test:
     name: E2E-Detox ${{ inputs.test_name }}
-    runs-on: macos-latest
+    runs-on: macos-12
     timeout-minutes: ${{ inputs.timeout_minutes }}
 
     steps:

.github/workflows/callable-npm-publish-lts-release.yml

@@ -0,0 +1,54 @@
+name: Release LTS version to npm and update repository
+
+on:
+  workflow_call:
+    inputs:
+      target:
+        required: true
+        type: string
+
+jobs:
+  deploy:
+    name: Publish to Amplify Package
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@24cb9080177205b6e8c946b17badbe402adc938f # v3.4.0 https://github.com/actions/checkout/commit/24cb9080177205b6e8c946b17badbe402adc938f
+        with:
+          path: amplify-js
+          token: ${{ secrets.GH_TOKEN_AMPLIFY_JS_WRITE }}
+          # Minimal depth 0 so we can fetch all git tags.
+          fetch-depth: 0
+
+      - name: Setup node and build the repository
+        uses: ./amplify-js/.github/actions/node-and-build
+
+      - name: Run npm publish
+        uses: ./amplify-js/.github/actions/npm-publish
+        with:
+          target: ${{ inputs.target }}
+          npm_token: ${{ secrets.NPM_TOKEN }}
+          github_user: ${{ vars.GH_USER}}
+          github_email: ${{ vars.GH_EMAIL}}
+
+      - name: Set github commit user
+        env:
+          GITHUB_EMAIL: ${{ vars.GH_EMAIL }}
+          GITHUB_USER: ${{ vars.GH_USER }}
+        run: |
+          git config --global user.email $GITHUB_EMAIL
+          git config --global user.name $GITHUB_USER
+
+      - name: Update API documentation
+        working-directory: ./amplify-js
+        run: |
+          yarn run docs
+          git add ./docs/api/
+          git commit -m "chore(release): update API docs [ci skip]"
+
+      - name: Push post release changes
+        working-directory: ./amplify-js
+        env:
+          TARGET_BRANCH: ${{ inputs.target }}
+        run: |
+          git push origin $TARGET_BRANCH

.github/workflows/callable-npm-publish-preid.yml

@@ -22,7 +22,7 @@ jobs:
           ALLOW_PROTECTED_PREIDS: ${{ inputs.allow-protected-preid }}
           PREID: ${{ inputs.preid }}
           FORBIDDEN_PREIDS: latest
-          PROTECTED_PREIDS: next unstable
+          PROTECTED_PREIDS: next unstable stable-5 stable-4
         run: |
           echo "Testing to see if $PREID is in the forbidden list ($FORBIDDEN_PREIDS)"
           for e in $FORBIDDEN_PREIDS; do [[ $PREID == $e ]] && echo "$PREID is forbidden from preid release" && exit 1; done

.github/workflows/callable-npm-publish-release.yml

@@ -12,6 +12,8 @@ jobs:
         with:
           path: amplify-js
           token: ${{ secrets.GH_TOKEN_AMPLIFY_JS_WRITE }}
+          # Minimal depth 0 so we can fetch all git tags.
+          fetch-depth: 0
 
       - name: Setup node and build the repository
         uses: ./amplify-js/.github/actions/node-and-build

.github/workflows/callable-release-verification.yml

@@ -10,7 +10,7 @@ jobs:
   prebuild-macos:
     uses: ./.github/workflows/callable-prebuild-amplify-js.yml
     with:
-      runs_on: macos-latest
+      runs_on: macos-12
   prebuild-samples-staging:
     secrets: inherit
     uses: ./.github/workflows/callable-prebuild-samples-staging.yml

.github/workflows/codeql.yml

@@ -5,7 +5,7 @@ on:
   push:
     branches: ['*']
   pull_request:
-    branches: ['main']
+    branches: ['main', 'v5-stable']
   schedule:
     # Run every Tuesday at midnight GMT
     - cron: '0 0 * * 2'

.github/workflows/push-lts-release.yml

@@ -0,0 +1,25 @@
+name: Push - release from LTS branch to LTS dist tag
+
+concurrency:
+  # group name unique for push to push-latest-release
+  group: push-lts-release-${{ github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    branches:
+      - v5-stable
+
+jobs:
+  e2e:
+    secrets: inherit
+    uses: ./.github/workflows/callable-release-verification.yml
+  release:
+    needs:
+      - e2e
+    permissions:
+      contents: write
+    secrets: inherit
+    uses: ./.github/workflows/callable-npm-publish-lts-release.yml
+    with:
+      target: v5-stable # TODO Update this to support other LTS branches in the future

.github/workflows/snyk-security.yml

@@ -2,7 +2,7 @@ name: Snyk Security
 
 on:
   push:
-    branches: ['release']
+    branches: ['v5-stable']
   schedule:
     - cron: '0 0 * * *' # run daily at midnight GMT
 

docs/api/classes/abstractconvertpredictionsprovider.html

@@ -1001,7 +1001,7 @@ <h3><span class="tsd-flag ts-flagProtected">Protected</span> _config</h3>
 			<aside class="tsd-sources">
 				<p>Inherited from <a href="abstractpredictionsprovider.html">AbstractPredictionsProvider</a>.<a href="abstractpredictionsprovider.html#_config">_config</a></p>
 				<ul>
-					<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L9">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:9</a></li>
+					<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L9">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:9</a></li>
 				</ul>
 			</aside>
 		</section>
@@ -1019,7 +1019,7 @@ <h3>configure</h3>
 					<aside class="tsd-sources">
 						<p>Inherited from <a href="abstractpredictionsprovider.html">AbstractPredictionsProvider</a>.<a href="abstractpredictionsprovider.html#configure">configure</a></p>
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L11">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:11</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L11">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:11</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-parameters-title">Parameters</h4>
@@ -1042,7 +1042,7 @@ <h3>convert</h3>
 				<li class="tsd-description">
 					<aside class="tsd-sources">
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts#L23">packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts:23</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts#L23">packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts:23</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-parameters-title">Parameters</h4>
@@ -1065,7 +1065,7 @@ <h3><span class="tsd-flag ts-flagProtected">Protected</span> convert<wbr>Speech<
 				<li class="tsd-description">
 					<aside class="tsd-sources">
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts#L50">packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts:50</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts#L50">packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts:50</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-parameters-title">Parameters</h4>
@@ -1088,7 +1088,7 @@ <h3><span class="tsd-flag ts-flagProtected">Protected</span> convert<wbr>Text<wb
 				<li class="tsd-description">
 					<aside class="tsd-sources">
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts#L44">packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts:44</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts#L44">packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts:44</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-parameters-title">Parameters</h4>
@@ -1112,7 +1112,7 @@ <h3>get<wbr>Category</h3>
 					<aside class="tsd-sources">
 						<p>Overrides <a href="abstractpredictionsprovider.html">AbstractPredictionsProvider</a>.<a href="abstractpredictionsprovider.html#getcategory">getCategory</a></p>
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts#L19">packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts:19</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts#L19">packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts:19</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">string</span></h4>
@@ -1130,7 +1130,7 @@ <h3><span class="tsd-flag ts-flagAbstract">Abstract</span> get<wbr>Provider<wbr>
 					<aside class="tsd-sources">
 						<p>Inherited from <a href="abstractpredictionsprovider.html">AbstractPredictionsProvider</a>.<a href="abstractpredictionsprovider.html#getprovidername">getProviderName</a></p>
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L17">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:17</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L17">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:17</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">string</span></h4>
@@ -1147,7 +1147,7 @@ <h3><span class="tsd-flag ts-flagProtected">Protected</span> translate<wbr>Text<
 				<li class="tsd-description">
 					<aside class="tsd-sources">
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts#L38">packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts:38</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts#L38">packages/predictions/src/types/Providers/AbstractConvertPredictionsProvider.ts:38</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-parameters-title">Parameters</h4>

docs/api/classes/abstractidentifypredictionsprovider.html

@@ -1001,7 +1001,7 @@ <h3><span class="tsd-flag ts-flagProtected">Protected</span> _config</h3>
 			<aside class="tsd-sources">
 				<p>Inherited from <a href="abstractpredictionsprovider.html">AbstractPredictionsProvider</a>.<a href="abstractpredictionsprovider.html#_config">_config</a></p>
 				<ul>
-					<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L9">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:9</a></li>
+					<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L9">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:9</a></li>
 				</ul>
 			</aside>
 		</section>
@@ -1019,7 +1019,7 @@ <h3>configure</h3>
 					<aside class="tsd-sources">
 						<p>Inherited from <a href="abstractpredictionsprovider.html">AbstractPredictionsProvider</a>.<a href="abstractpredictionsprovider.html#configure">configure</a></p>
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L11">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:11</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L11">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:11</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-parameters-title">Parameters</h4>
@@ -1043,7 +1043,7 @@ <h3>get<wbr>Category</h3>
 					<aside class="tsd-sources">
 						<p>Overrides <a href="abstractpredictionsprovider.html">AbstractPredictionsProvider</a>.<a href="abstractpredictionsprovider.html#getcategory">getCategory</a></p>
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts#L19">packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts:19</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts#L19">packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts:19</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">string</span></h4>
@@ -1061,7 +1061,7 @@ <h3><span class="tsd-flag ts-flagAbstract">Abstract</span> get<wbr>Provider<wbr>
 					<aside class="tsd-sources">
 						<p>Inherited from <a href="abstractpredictionsprovider.html">AbstractPredictionsProvider</a>.<a href="abstractpredictionsprovider.html#getprovidername">getProviderName</a></p>
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L17">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:17</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts#L17">packages/predictions/src/types/Providers/AbstractPredictionsProvider.ts:17</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">string</span></h4>
@@ -1078,7 +1078,7 @@ <h3>identify</h3>
 				<li class="tsd-description">
 					<aside class="tsd-sources">
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts#L23">packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts:23</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts#L23">packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts:23</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-parameters-title">Parameters</h4>
@@ -1101,7 +1101,7 @@ <h3><span class="tsd-flag ts-flagProtected">Protected</span> identify<wbr>Entiti
 				<li class="tsd-description">
 					<aside class="tsd-sources">
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts#L52">packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts:52</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts#L52">packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts:52</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-parameters-title">Parameters</h4>
@@ -1124,7 +1124,7 @@ <h3><span class="tsd-flag ts-flagProtected">Protected</span> identify<wbr>Labels
 				<li class="tsd-description">
 					<aside class="tsd-sources">
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts#L46">packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts:46</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts#L46">packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts:46</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-parameters-title">Parameters</h4>
@@ -1147,7 +1147,7 @@ <h3><span class="tsd-flag ts-flagProtected">Protected</span> identify<wbr>Text</
 				<li class="tsd-description">
 					<aside class="tsd-sources">
 						<ul>
-							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/c3a06153e/packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts#L40">packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts:40</a></li>
+							<li>Defined in <a href="https://github.com/aws-amplify/amplify-js/blob/226700fc8/packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts#L40">packages/predictions/src/types/Providers/AbstractIdentifyPredictionsProvider.ts:40</a></li>
 						</ul>
 					</aside>
 					<h4 class="tsd-parameters-title">Parameters</h4>