diberry/0519-tsp-js-2

Author: diberry

articles/typespec/includes/quickstart/prereqs-typescript.md

@@ -6,7 +6,7 @@ ms.date: 04/23/2025
 * An active Azure account. [Create an account for free](https://azure.microsoft.com/free) if you don't have one.
 * [Node.js LTS](https://nodejs.org/) installed on your system.
 * [TypeScript](https://www.typescriptlang.org/) for writing and compiling TypeScript code.
-
+* [Docker](https://www.docker.com/)
 * [Visual Studio Code](https://code.visualstudio.com/)
 * [TypeSpec extension](https://marketplace.visualstudio.com/items?itemName=typespec.typespec-vscode)
 * Optional: Deployment with [Azure Developer CLI](/azure/developer/azure-developer-cli/)

articles/typespec/quickstart-scaffold-typescript.md

@@ -86,20 +86,6 @@ TypeSpec defines your API in a language-agnostic way and generates the API serve
     TypeSpec **emitters** are libraries that utilize various TypeSpec compiler APIs to reflect on the TypeSpec compilation process and generate artifacts.
 
 1. Wait for the initialization to complete before continuing.
-
-    ```console
-    Please review the following messages from emitters:
-      @typespec/http-server-js: 
-    
-            Generated JavaScript services require a service runtime:
-            https://nodejs.org/download 
-    
-            Create a JavaScript service project for your TypeSpec:
-            > npx hsjs-scaffold
-    
-            More information on getting started:
-            https://aka.ms/tsp/hsjs/start
-    ```
     
 1. Compile the project:
 
@@ -194,7 +180,7 @@ Now that the basic Express.js API server is working, update the Express.js serve
     ```
 
 1. Create an `./tsp-output/server/src/azure` directory to hold source code specific to Azure.
-1. Create the `cosmos-client.ts` file in that directory to create a Cosmos DB client object and paste in the following code:
+1. Create the `cosmosClient.ts` file in that directory to create a Cosmos DB client object and paste in the following code:
 
     ```typescript
     import { CosmosClient, Database, Container } from "@azure/cosmos";
@@ -289,7 +275,7 @@ Now that the basic Express.js API server is working, update the Express.js serve
 
     Notice the file uses the endpoint, database, and container. It doesn't need a connection string or key because it's using the Azure Identity credential `DefaultAzureCredential`. Learn more about this method of [secure authentication for both local and production](/azure/developer/javascript/sdk/authentication/overview) environments.
 
-1. Create a new Widget controller, `./tsp-output/server/src/controllers/widgets-cosmos.ts`, and paste in the following integration code for Azure Cosmos DB.
+1. Create a new Widget controller, `./tsp-output/server/src/controllers/WidgetsCosmos.ts`, and paste in the following integration code for Azure Cosmos DB.
 
     ```typescript
     import { Widgets, Widget, WidgetList,   AnalyzeResult,Error } from "../generated/models/all/demo-service.js";
@@ -501,12 +487,12 @@ Now that the basic Express.js API server is working, update the Express.js serve
     }
     ```
 
-1. Update the `./tsp-output/server/src/index.ts` to use the new controller. 
+1. Update the `./tsp-output/server/src/index.ts` to import the new controller, get the Azure Cosmos DB environment settings, then create the WidgetsCosmosController and pass to the router`. 
 
     ```typescript
     // Generated by Microsoft TypeSpec
     
-    import { WidgetsCosmosController } from "./controllers/widgets-cosmos.js";
+    import { WidgetsCosmosController } from "./controllers/WidgetsCosmos.js";
     
     import { createDemoServiceRouter } from "./generated/http/router.js";
     
@@ -548,7 +534,7 @@ Now that the basic Express.js API server is working, update the Express.js serve
     });
     ```
 
-1. Compile the TypeScript into JavaScript.
+1. In a terminal at `./tsp-output/server`, compile the TypeScript into JavaScript.
 
     ```console
     tsc
@@ -902,7 +888,7 @@ Create the files needed to have a repeatable deployment with [Azure Developer CL
 
 You can deploy this application to Azure using Azure Container Apps:
 
-1. Authenticate to the Azure Developer CLI:
+1. In a terminal at the root of the project, authenticate to the Azure Developer CLI:
 
     ```console
     azd auth login
@@ -915,6 +901,26 @@ You can deploy this application to Azure using Azure Container Apps:
     azd up
     ```
 
+1. Answer the following prompts with the answers provided:
+
+    * Enter a unique environment name: `tsp-server-js`
+    * Select an Azure Subscription to use: select your subscription
+    * Select an Azure location to use: select a location near you
+    * Pick a resource group to use: Select *Create a new resource group*
+    * Enter a name for the new resource group: accept the default provided
+
+1. Wait until the deployment completes. The response includes information similar to the following:
+
+    ```console
+    Deploying services (azd deploy)
+    
+      (✓) Done: Deploying service api
+      - Endpoint: https://container-app-123.ambitiouscliff-456.centralus.azurecontainerapps.io/
+    
+    
+    SUCCESS: Your up workflow to provision and deploy to Azure completed in 6 minutes 32 seconds.
+    ```
+
 ## Use application in browser
 
 Once deployed, you can: