feat(gen2-migration): add imported-resources app (#14709)

* fix(cli-internal): skip imported auth resources in refactor step

Imported (reference) auth resources have no nested CloudFormation
stack — they reference externally-managed Cognito resources. The
refactor step was unconditionally creating an
AuthCognitoForwardRefactorer for every auth:Cognito resource,
which then failed with "unable to find source stack" because
there is no stack to find.

Now checks serviceType === 'imported' in amplify-meta.json before
creating the refactorer, matching the existing pattern in the
generate step. Added tests for both forward and rollback paths.
---
Prompt: In the gen2-migration tool, I am getting this error
when trying to refactor an app with an imported auth resource -
"[AuthCognitoForwardRefactorer] unable to find source stack"

* feat: commit snapshots

* feat: add pre-refactor snapshot

* feat: post refactor snapshot

* chore: sanitize fully

* chore: add tests

* feat: add imported-resources snapshot tests
Add generate/refactor snapshots and update CognitoIdentityMock to support imported auth resources.

* chore: more mocks

* chore: updated snapshiot

* chore: update snapshots

* chore: sanitize

* chore: replace aws cli calls with sdk calls

---------

Co-authored-by: Eli Polonsky <epolon@amazon.com>

Author: dgandhi62

amplify-migration-apps/imported-resources/.eslintignore

@@ -0,0 +1 @@
+amplify-codegen-temp/models/models

amplify-migration-apps/imported-resources/.gitignore

@@ -0,0 +1,46 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+#amplify-do-not-edit-begin
+amplify/\#current-cloud-backend
+amplify/.config/local-*
+amplify/logs
+amplify/mock-data
+amplify/mock-api-resources
+amplify/backend/amplify-meta.json
+amplify/backend/.temp
+build/
+dist/
+node_modules/
+aws-exports.js
+awsconfiguration.json
+amplifyconfiguration.json
+amplifyconfiguration.dart
+amplify-build-config.json
+amplify-gradle-config.json
+amplifytools.xcconfig
+.secret-*
+**.sample
+#amplify-do-not-edit-end

amplify-migration-apps/imported-resources/.graphqlconfig.yml

@@ -0,0 +1,15 @@
+projects:
+  amplifytestapp2:
+    schemaPath: src/graphql/schema.json
+    includes:
+      - src/graphql/**/*.ts
+    excludes:
+      - ./amplify/**
+    extensions:
+      amplify:
+        codeGenTarget: typescript
+        generatedFileName: src/API.ts
+        docsFilePath: src/graphql
+extensions:
+  amplify:
+    version: 3

amplify-migration-apps/imported-resources/README.md

@@ -0,0 +1,288 @@
+# Imported Resources (Amplify Gen1)
+
+<img width="625" height="300" src="./images/app.png" />
+
+This is a project board app that supports authentication. Each Project board can hold multiple Todo items,
+each of which has a title, description, and optionally, images. Todos do not need to be in a Project
+and can exist unassigned.
+
+- Unauthenticated users can only view Projects and Todos, and cannot modify or delete them.
+- Authenticated users can create Projects and Todos, and modify/delete their own. They may add
+
+Todos to Projects that are not their own, but cannot change the Project settings.
+
+> [!NOTICE]
+> Since amplify operations add files to your local directory, its better not to operate within this repo.
+> Instead, create your own private GitHub repository and copy the app over.
+
+## Install Dependencies
+
+```console
+npm install
+```
+
+## Initialize Environment
+
+```console
+amplify init
+```
+
+```console
+⚠️ For new projects, we recommend starting with AWS Amplify Gen 2, our new code-first developer experience. Get started at https://docs.amplify.aws/react/start/quickstart/
+✔ Do you want to continue with Amplify Gen 1? (y/N) · yes
+✔ Why would you like to use Amplify Gen 1? · Prefer not to answer
+Note: It is recommended to run this command from the root of your app directory
+? Enter a name for the project importedresources
+The following configuration will be applied:
+
+Project information
+| Name: importedresources
+| Environment: dev
+| Default editor: Visual Studio Code
+| App type: javascript
+| Javascript framework: none
+| Source Directory Path: src
+| Distribution Directory Path: dist
+| Build Command: npm run-script build
+| Start Command: npm run-script start
+
+? Initialize the project with the above configuration? No
+? Enter a name for the environment main
+? Choose your default editor: Visual Studio Code
+✔ Choose the type of app that you're building · javascript
+Please tell us about your project
+? What javascript framework are you using react
+? Source Directory Path:  src
+? Distribution Directory Path: dist
+? Build Command:  npm run-script build
+? Start Command: npm run-script start
+Using default provider  awscloudformation
+? Select the authentication method you want to use: AWS profile
+
+For more information on AWS Profiles, see:
+https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html
+
+? Please choose the profile you want to use default
+```
+
+## Add Categories
+
+### Auth
+
+Create a userPool and identityPool managed outside of Amplify
+
+```console
+npm run create-auth    
+```
+
+```console
+amplify import auth 
+```
+
+Use the ids printed in the previous step
+
+```console
+? What type of auth resource do you want to import? Cognito User Pool and Identity Pool
+? Select the User Pool you want to import:
+✔ Select a Web client to import:
+✔ Select a Native client to import:
+✔ Only one Identity Pool resource found:
+```
+
+
+### Api
+
+GraphQL API with schema containing:
+
+- _Todo_ model.
+- _Project_ model with a `@hasMany` relationship to the _Todo_ model.
+- _getRandomQuote_ query that returns inspirational quotes by invoking a
+  lambda function using the `@function` directive.
+
+```console
+amplify add api
+```
+
+```console
+? Select from one of the below mentioned services: GraphQL
+? Here is the GraphQL API that we will create. Select a setting to edit or continue Continue
+? Choose a schema template: Single object with fields (e.g., “Todo” with ID, name, description)
+✔ Do you want to edit the schema now? (Y/n) · no
+```
+
+### Storage
+
+S3-based storage for images of the _Todo_ model. Authenticated users can perform all operations,
+unauthenticated users can only read.
+
+```console
+amplify add storage
+```
+
+```console
+? Select from one of the below mentioned services: Content (Images, audio, video, etc.)
+✔ Provide a friendly name for your resource that will be used to label this category in the project: · (accept default value)
+✔ Provide bucket name: · (accept default value)
+✔ Who should have access: · Auth and guest users
+✔ What kind of access do you want for Authenticated users? · create/update, read, delete
+✔ What kind of access do you want for Guest users? · read
+✔ Do you want to add a Lambda Trigger for your S3 Bucket? (y/N) · no
+```
+
+### Function
+
+Node.js lambda function that generates inspirational quotes.
+
+```console
+amplify add function
+```
+
+```console
+? Select which capability you want to add: Lambda function (serverless function)
+? Provide an AWS Lambda function name: quotegenerator
+? Choose the runtime that you want to use: NodeJS
+? Choose the function template that you want to use: Hello World
+
+✅ Available advanced settings:
+- Resource access permissions
+- Scheduled recurring invocation
+- Lambda layers configuration
+- Environment variables configuration
+- Secret values configuration
+
+? Do you want to configure advanced settings? No
+? Do you want to edit the local lambda function now? No
+```
+
+## Configure
+
+```console
+npm run configure
+```
+
+## Deploy Backend
+
+```console
+amplify push
+```
+
+```console
+┌──────────┬───────────────────────┬───────────┬───────────────────┐
+│ Category │ Resource name         │ Operation │ Provider plugin   │
+├──────────┼───────────────────────┼───────────┼───────────────────┤
+│ Api      │ importedresources         │ Create    │ awscloudformation │
+├──────────┼───────────────────────┼───────────┼───────────────────┤
+│ Auth     │ importedresourcesea1b8c4c │ Imported    │ awscloudformation │
+├──────────┼───────────────────────┼───────────┼───────────────────┤
+│ Storage  │ s3742db757            │ Create    │ awscloudformation │
+├──────────┼───────────────────────┼───────────┼───────────────────┤
+│ Function │ quotegenerator        │ Create    │ awscloudformation │
+└──────────┴───────────────────────┴───────────┴───────────────────┘
+
+✔ Are you sure you want to continue? (Y/n) · yes
+? Do you want to generate code for your newly created GraphQL API No
+```
+
+## Publish Frontend
+
+To publish the frontend, we leverage the Amplify hosting console. First push everything to the `main` branch:
+
+```console
+git add .
+git commit -m "feat: gen1"
+git push origin main
+```
+
+Next, accept all the default values and follow the getting started wizard to connect your repo and branch.
+
+![](./images/hosting-get-started.png)
+![](./images/add-main-branch.png)
+![](./images/deploying-main-branch.png)
+
+Wait for the deployment to finish successfully.
+
+## Migrating to Gen2
+
+> Based on https://github.com/aws-amplify/amplify-cli/blob/gen2-migration/GEN2_MIGRATION_GUIDE.md
+
+First and install the experimental CLI package the provides the new commands:
+
+```console
+npm install --no-save @aws-amplify/cli-internal-gen2-migration-experimental-alpha
+```
+
+Now run them:
+
+```console
+npx amplify gen2-migration lock
+```
+
+```console
+git checkout -b gen2-main
+npx amplify gen2-migration generate
+```
+
+**Edit in `./amplify/data/resource.ts`:**
+
+```diff
+- branchName: "main"
++ branchName: "gen2-main"
+```
+
+**Edit in `./amplify/function/quotegenerator/index.js`:**
+
+```diff
+- exports.handler = async (event) => {
++ export async function handler(event) {
+```
+
+**Edit in `./src/main.tsx`:**
+
+```diff
+- import amplifyconfig from './amplifyconfiguration.json';
++ import amplifyconfig from '../amplify_outputs.json';
+```
+
+```console
+git add .
+git commit -m "feat: migrate to gen2"
+git push origin gen2-main
+```
+
+Now connect the `gen2-main` branch to the hosting service:
+
+![](./images/add-gen2-main-branch.png)
+![](./images/deploying-gen2-main-branch.png)
+
+Wait for the deployment to finish successfully. Next, locate the root stack of the Gen2 branch:
+
+![](./images/find-gen2-stack.png)
+
+```console
+npm install --no-save @aws-amplify/cli-internal-gen2-migration-experimental-alpha
+```
+
+```console
+git checkout main
+npx amplify gen2-migration refactor --to <gen2-stack-name>
+```
+
+```console
+git checkout gen2-main
+```
+
+**Edit in `./amplify/backend.ts`:**
+
+```diff
+- // s3Bucket.bucketName = '...';
++ s3Bucket.bucketName = '...';
+```
+
+```console
+git add .
+git commit -m "chore: post refactor"
+git push origin gen2-main
+```
+
+Wait for the deployment to finish successfully.
+# importedresources

amplify-migration-apps/imported-resources/_snapshot.post.generate/.gitignore

@@ -0,0 +1,28 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+node_modules
+dist
+dist-ssr
+*.local
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+# amplify
+.amplify
+amplify_outputs*
+amplifyconfiguration*
+aws-exports*
+build