feat(lambda): Building Quick Pick structure and Entrypoints (aws#6592)

## Problem
Adding entry points and Quick Pick structure for Serverless Land
integration project. The attached images demonstrate the functionality.
The `metadata.json` file is currently a sample, but it will be modified
to include the exact list of patterns.

## Solution
### **EntryPoints**
From AWS Application Builder
<img width="698" alt="Screenshot 2025-02-16 at 7 33 29 PM"
src="https://github.com/user-attachments/assets/1b0b563e-e6f3-414e-ad7d-b895c172b5f3"
/>

From Command Palette
<img width="920" alt="Screenshot 2025-02-16 at 5 10 37 PM"
src="https://github.com/user-attachments/assets/773c2727-344c-4100-8ee5-09efb52809f7"
/>

From Lambda in AWS Explorer
<img width="481" alt="Screenshot 2025-02-18 at 3 22 54 PM"
src="https://github.com/user-attachments/assets/b4b9a9f8-1e34-44ed-8b6d-0aeaac03e7a0"
/>

From the link in Getting Started Walkthrough
<img width="669" alt="Screenshot 2025-02-18 at 3 36 42 PM"
src="https://github.com/user-attachments/assets/f57a3b20-41df-4845-bbb8-c253bf8db592"
/>

### **Quick Pick**

Pattern selection
<img width="893" alt="Screenshot 2025-02-16 at 7 28 25 PM"
src="https://github.com/user-attachments/assets/1844dd2e-f996-4d54-a9f2-bae9af4eee84"
/>

Runtime selection
<img width="917" alt="Screenshot 2025-02-16 at 7 28 33 PM"
src="https://github.com/user-attachments/assets/73532262-70b1-412a-92e3-7ad12075ecb1"
/>

IaC selection
<img width="907" alt="Screenshot 2025-02-16 at 7 28 39 PM"
src="https://github.com/user-attachments/assets/92c093ce-8e0f-42b5-91f9-f0672dbce9f9"
/>

Project location selection
<img width="921" alt="Screenshot 2025-02-16 at 5 12 04 PM"
src="https://github.com/user-attachments/assets/c24b1b99-834b-4e1a-b34a-062ad927bafa"
/>

Project Name
<img width="909" alt="Screenshot 2025-02-16 at 5 12 19 PM"
src="https://github.com/user-attachments/assets/423165bb-ad59-4c15-b6da-582a44de8753"
/>

---

- Treat all work as PUBLIC. Private `feature/x` branches will not be
squash-merged at release time.
- Your code changes must meet the guidelines in
[CONTRIBUTING.md](https://github.com/aws/aws-toolkit-vscode/blob/master/CONTRIBUTING.md#guidelines).
- License: I confirm that my contribution is made under the terms of the
Apache 2.0 license.

---------

Co-authored-by: Vandita Patidar <[email protected]>

Author: 2 people

packages/core/package.nls.json

@@ -461,5 +461,6 @@
     "AWS.toolkit.lambda.walkthrough.step1.title": "Iterate locally",
     "AWS.toolkit.lambda.walkthrough.step1.description": "Locally test and debug your code.",
     "AWS.toolkit.lambda.walkthrough.step2.title": "Deploy to the cloud",
-    "AWS.toolkit.lambda.walkthrough.step2.description": "Test your application in the cloud from within VS Code. \n\nNote: The AWS CLI and the SAM CLI require AWS Credentials to interact with the cloud. For information on setting up your credentials, see [Authentication and access credentials](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). \n\n[Configure credentials](command:aws.toolkit.lambda.walkthrough.credential)"
+    "AWS.toolkit.lambda.walkthrough.step2.description": "Test your application in the cloud from within VS Code. \n\nNote: The AWS CLI and the SAM CLI require AWS Credentials to interact with the cloud. For information on setting up your credentials, see [Authentication and access credentials](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). \n\n[Configure credentials](command:aws.toolkit.lambda.walkthrough.credential)",
+    "AWS.toolkit.lambda.serverlessLand.quickpickTitle": "Create Lambda Application from template"
 }

packages/core/resources/walkthrough/appBuilder/AppPicker.md

@@ -20,6 +20,6 @@
 		</checkbox>
 	</div>
 </checklist>
-<checkbox class="theme-picker-link" when-checked="command:aws.lambda.createNewSamApp" checked-on="false">
+<checkbox class="theme-picker-link" when-checked="command:aws.toolkit.lambda.createServerlessLandProject" checked-on="false">
 	See more application example...
 </checkbox>

packages/core/src/awsService/appBuilder/activation.ts

@@ -23,7 +23,7 @@ import { ResourceNode } from './explorer/nodes/resourceNode'
 import { getSyncWizard, runSync } from '../../shared/sam/sync'
 import { getDeployWizard, runDeploy } from '../../shared/sam/deploy'
 import { DeployTypeWizard } from './wizards/deployTypeWizard'
-
+import { createNewServerlessLandProject } from './serverlessLand/main'
 export const templateToOpenAppComposer = 'aws.toolkit.appComposer.templateToOpenOnStart'
 
 /**
@@ -200,6 +200,9 @@ async function registerAppBuilderCommands(context: ExtContext): Promise<void> {
                     await runSync('infra', arg, undefined, choices.syncParam)
                 }
             }
+        }),
+        Commands.register({ id: 'aws.toolkit.lambda.createServerlessLandProject', autoconnect: false }, async () => {
+            await createNewServerlessLandProject(context)
         })
     )
 }

packages/core/src/awsService/appBuilder/serverlessLand/main.ts

@@ -0,0 +1,82 @@
+/*!
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import * as nls from 'vscode-nls'
+const localize = nls.loadMessageBundle()
+import * as path from 'path'
+import { getTelemetryReason, getTelemetryResult } from '../../../shared/errors'
+import { getLogger } from '../../../shared/logger/logger'
+import globals from '../../../shared/extensionGlobals'
+import { checklogs } from '../../../shared/localizedText'
+import { Result, telemetry } from '../../../shared/telemetry/telemetry'
+import { CreateServerlessLandWizard } from './wizard'
+import { ExtContext } from '../../../shared/extensions'
+import { addFolderToWorkspace } from '../../../shared/utilities/workspaceUtils'
+
+export const readmeFile: string = 'README.md'
+
+/**
+ * Creates a new Serverless Land project using the provided extension context
+ * @param extContext Extension context containing AWS credentials and region information
+ * @returns Promise that resolves when the project creation is complete
+ *
+ * This function:
+ * 1. Validates AWS credentials and regions
+ * 2. Launches the Serverless Land project creation wizard
+ * 3. Creates the project structure
+ * 4. Adds the project folder to the workspace
+ * 5. Opens the README.md file if available
+ * 6. Handles errors and emits telemetry
+ */
+export async function createNewServerlessLandProject(extContext: ExtContext): Promise<void> {
+    const awsContext = extContext.awsContext
+    let createResult: Result = 'Succeeded'
+    let reason: string | undefined
+
+    try {
+        const credentials = await awsContext.getCredentials()
+        const defaultRegion = awsContext.getCredentialDefaultRegion()
+
+        // Launch the project creation wizard
+        const config = await new CreateServerlessLandWizard({
+            credentials,
+            defaultRegion,
+        }).run()
+        if (!config) {
+            createResult = 'Cancelled'
+            reason = 'userCancelled'
+            return
+        }
+
+        // Add the project folder to the workspace
+        await addFolderToWorkspace(
+            {
+                uri: config.location,
+                name: path.basename(config.location.fsPath),
+            },
+            true
+        )
+    } catch (err) {
+        createResult = getTelemetryResult(err)
+        reason = getTelemetryReason(err)
+
+        globals.outputChannel.show(true)
+        getLogger().error(
+            localize(
+                'AWS.serverlessland.initWizard.general.error',
+                'Error creating new Serverless Land Application. {0}',
+                checklogs()
+            )
+        )
+        getLogger().error('Error creating new Serverless Land Application: %O', err as Error)
+    } finally {
+        // add telemetry
+        // TODO: Will add telemetry once the implementation gets completed
+        telemetry.sam_init.emit({
+            result: createResult,
+            reason: reason,
+        })
+    }
+}

packages/core/src/awsService/appBuilder/serverlessLand/metadata.json

@@ -0,0 +1,60 @@
+{
+    "patterns": {
+        "s3-lambda-resizing-sam": {
+            "name": "Resizing image",
+            "description": "Lambda, S3 • Python, Javascript, Java, .NET • SAM",
+            "runtimes": [
+                {
+                    "id": "python",
+                    "name": "Python"
+                },
+                {
+                    "id": "javascript",
+                    "name": "Javascript"
+                },
+                {
+                    "id": "dotnet",
+                    "name": "Dotnet"
+                },
+                {
+                    "id": "java",
+                    "name": "Java"
+                }
+            ],
+            "iac": [
+                {
+                    "id": "sam",
+                    "name": "SAM"
+                }
+            ]
+        },
+        "apigw-rest-api-lambda-sam": {
+            "name": "Rest API",
+            "description": "Lambda, API Gateway • Python, Javascript, Java, .NET • SAM",
+            "runtimes": [
+                {
+                    "id": "python",
+                    "name": "Python"
+                },
+                {
+                    "id": "javascript",
+                    "name": "Javascript"
+                },
+                {
+                    "id": "dotnet",
+                    "name": "Dotnet"
+                },
+                {
+                    "id": "java",
+                    "name": "Java"
+                }
+            ],
+            "iac": [
+                {
+                    "id": "sam",
+                    "name": "AWS SAM"
+                }
+            ]
+        }
+    }
+}

packages/core/src/awsService/appBuilder/serverlessLand/metadataManager.ts

@@ -0,0 +1,121 @@
+/*!
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as nodefs from 'fs' // eslint-disable-line no-restricted-imports
+import { ToolkitError } from '../../../shared/errors'
+
+interface IaC {
+    id: string
+    name: string
+}
+interface Runtime {
+    id: string
+    name: string
+    version: string
+}
+interface PatternData {
+    name: string
+    description: string
+    runtimes: Runtime[]
+    iac: IaC[]
+}
+
+export interface ProjectMetadata {
+    patterns: Record<string, PatternData>
+}
+
+/**
+ * Manages metadata for serverless application patterns
+ */
+
+export class MetadataManager {
+    private static instance: MetadataManager
+    private metadata: ProjectMetadata | undefined
+
+    private constructor() {}
+
+    public static getInstance(): MetadataManager {
+        if (!MetadataManager.instance) {
+            MetadataManager.instance = new MetadataManager()
+        }
+        return MetadataManager.instance
+    }
+
+    /**
+     * Loads metadata from a JSON file
+     * @param metadataPath Path to the metadata JSON file
+     * @returns Promise containing the parsed ProjectMetadata
+     */
+    public async loadMetadata(metadataPath: string): Promise<ProjectMetadata> {
+        try {
+            if (!this.metadata) {
+                const metadataContent = nodefs.readFileSync(metadataPath, { encoding: 'utf-8' })
+                const parseMetadata = JSON.parse(metadataContent) as ProjectMetadata
+                this.metadata = parseMetadata
+            }
+            return this.metadata
+        } catch (err) {
+            throw new ToolkitError(`Failed to load metadata: ${err instanceof Error ? err.message : String(err)}`)
+        }
+    }
+
+    /**
+     * Retrieves available patterns with their descriptions
+     * @returns Array of pattern objects containing labels and descriptions
+     */
+    public getPatterns(): { label: string; description?: string }[] {
+        if (!this.metadata) {
+            return []
+        }
+        return Object.entries(this.metadata.patterns).map(([patternName, patternData]) => {
+            let description: string | undefined = undefined
+            if (typeof patternData === 'string') {
+                description = patternData
+            } else if (Array.isArray(patternData)) {
+                // If description is an array, join it into a single string
+                description = patternData.join(' ')
+            }
+            if (!patternData || !patternData.name) {
+                return {
+                    label: patternName,
+                    description: description || 'No description available',
+                }
+            }
+            return {
+                label: patternName,
+                description: patternData.description,
+            }
+        })
+    }
+
+    /**
+     * Gets available runtimes for a specific pattern
+     * @param pattern The pattern name to get runtimes for
+     * @returns Array of runtime options with labels
+     */
+    public getRuntimes(pattern: string): { label: string }[] {
+        const patternData = this.metadata?.patterns?.[pattern]
+        if (!patternData || !patternData.runtimes) {
+            return []
+        }
+        return patternData.runtimes.map((runtime) => ({
+            label: runtime.name,
+        }))
+    }
+
+    /**
+     * Gets available Infrastructure as Code options for a specific pattern
+     * @param pattern The pattern name to get IaC options for
+     * @returns Array of IaC options with labels
+     */
+    public getIacOptions(pattern: string): { label: string }[] {
+        const patternData = this.metadata?.patterns?.[pattern]
+        if (!patternData || !patternData.iac) {
+            return []
+        }
+        return patternData.iac.map((iac) => ({
+            label: iac.name,
+        }))
+    }
+}