fix(type-safe-api): fix websocket api issues (#738)

* fix(type-safe-api): use service namespace in prelude and fix docs

* fix(type-safe-api): ensure smithy async transformer jar is included in cache

Addresses a bug where the smithy async transformer was not published as part of the release build,
since build artifacts were loaded from the cache which didn't include the jar

Author: cogwirrel

packages/type-safe-api/docs/developer_guides/type-safe-api/getting_started.md

@@ -26,7 +26,7 @@ The `TypeSafeApiProject` projen project sets up the project structure for you. C
 1.) To start an empty `monorepo` project, use this command:
 
 ```bash
-pdk new monorepo-ts
+pdk new monorepo-ts --package-manager=pnpm
 ```
 
 2.) Edit your `.projenrc` and configure `TypeSafeApiProject`.
@@ -47,13 +47,15 @@ pdk new monorepo-ts
       TypeSafeApiProject,
     } from "@aws/pdk/type-safe-api";
     import { InfrastructureTsProject } from "@aws/pdk/infrastructure";
+    import { NodePackageManager } from "projen/lib/javascript";
 
     // Create the monorepo
     const monorepo = new MonorepoTsProject({
       name: "my-project",
       devDeps: [
         "@aws/pdk",
       ],
+      packageManager: NodePackageManager.PNPM,
     });
 
     // Create the API project

packages/type-safe-api/docs/developer_guides/type-safe-api/websocket_getting_started.md

@@ -25,7 +25,7 @@ The `TypeSafeWebSocketApiProject` projen project sets up the project structure f
 1.) To start an empty `monorepo` project, use this command:
 
 ```bash
-pdk new monorepo-ts
+pdk new monorepo-ts --package-manager=pnpm
 ```
 
 2.) Edit your `.projenrc` and configure `TypeSafeWebSocketApiProject`.
@@ -35,13 +35,13 @@ pdk new monorepo-ts
     ```ts
     import { MonorepoTsProject } from "@aws/pdk/monorepo";
     import {
-      DocumentationFormat,
       Language,
-      Library,
       ModelLanguage,
       TypeSafeWebSocketApiProject,
+      WebSocketLibrary,
     } from "@aws/pdk/type-safe-api";
     import { InfrastructureTsProject } from "@aws/pdk/infrastructure";
+    import { CloudscapeReactTsWebsiteProject } from "@aws/pdk/cloudscape-react-ts-website";
 
     // Create the monorepo
     const monorepo = new MonorepoTsProject({
@@ -75,10 +75,10 @@ pdk new monorepo-ts
       // Lambda handlers in TypeScript
       handlers: {
         languages: [Language.TYPESCRIPT],
-      }
+      },
       // Generate react hooks to interact with the API from a React website
       library: {
-        libraries: [Library.TYPESCRIPT_WEBSOCKET_HOOKS],
+        libraries: [WebSocketLibrary.TYPESCRIPT_WEBSOCKET_HOOKS],
       },
     });
 
@@ -124,9 +124,11 @@ The generated runtime projects include lambda handler wrappers which provide typ
 
 === "SMITHY"
 
+    Use the `@async` trait to select the operation direction. Choose between `client_to_server`, `server_to_client` or `bidirectional`
+
     Use the `@handler` trait, and specify the language you wish to implement this operation in.
 
-    ```smithy hl_lines="2"
+    ```smithy hl_lines="1-2"
     @async(direction: "client_to_server")
     @handler(language: "typescript")
     operation SubscribeToNotifications {
@@ -143,9 +145,11 @@ The generated runtime projects include lambda handler wrappers which provide typ
 
 === "OPENAPI"
 
+    Use the `x-async` vendor extension to select the operation direction. Choose between `client_to_server`, `server_to_client` or `bidirectional`
+
     Use the `x-handler` vendor extension, specifying the language you wish to implement this operation in.
 
-    ```yaml hl_lines="4-5"
+    ```yaml hl_lines="4-7"
     /SubscribeToNotifications:
       post:
         operationId: SubscribeToNotifications

packages/type-safe-api/project.json

@@ -54,7 +54,7 @@ metadata validators = [
         message: "Operation is missing @async trait"
         configuration: {
             selector: """
-                operation :not([trait|com.aws#async])
+                operation :not([trait|${this.options.serviceNamespace}#async])
             """
         }
     }
@@ -65,7 +65,9 @@ metadata validators = [
         message: "Service is missing @websocketJson trait"
         configuration: {
             selector: """
-                service :not([trait|com.aws#websocketJson])
+                service :not([trait|${
+                  this.options.serviceNamespace
+                }#websocketJson])
             """
         }
     }
@@ -99,8 +101,10 @@ metadata validators = [
         configuration: {
             selector: """
               operation
-              [@trait|com.aws#async: @{direction} = server_to_client]
-              [trait|com.aws#handler]
+              [@trait|${
+                this.options.serviceNamespace
+              }#async: @{direction} = server_to_client]
+              [trait|${this.options.serviceNamespace}#handler]
             """
         }
     }