update ws and sql sequences

Author: jyecusch

docs/architecture/apis.mdx

@@ -113,6 +113,7 @@ sequenceDiagram
   Nitric->>Nitric: Generate OpenAPI Spec
   Nitric->>Provider: Forward Nitric Spec
   Provider->>IAC: Provision API Gateway
+  Provider->>IAC: Provision IAM
 ```
 
 ### Runtime Sequence

docs/architecture/sql.mdx

@@ -52,28 +52,46 @@ classDef edgeLabel line-height:2;
 
 </details>
 
-## 2. Sequence Diagram (Level 2)
+## 2. Sequence
+
+### Build Sequence
+
+Below is the sequence of events that occur when a developer registers a SQL database with Nitric.
+
+```mermaid
+sequenceDiagram
+    participant Worker as App Worker(s)
+    participant SDK as Nitric SDK
+    participant Nitric as Nitric CLI
+    participant Provider as Nitric Provider <br> (plugin)
+    participant IAC as IaC <br> (e.g. Terraform)
+
+    Worker->>SDK: Register SQL Database
+    SDK->>Nitric: Register SQL Database
+
+    Nitric->>Provider: Forward Nitric Spec
+    Provider->>IAC: Provision Database Cluster
+    Provider->>IAC: Provision Database Instance
+    Provider->>IAC: Provision IAM
+```
+
+### Runtime Sequence
+
+Below is the runtime flow of a database operation in a Nitric application, using the Nitric SDK. The SDK provides access to the connection details for the SQL database. All database operations are performed as usual, without any additional Nitric-specific steps.
 
 ```mermaid
 sequenceDiagram
-    participant Client as Client
-    participant NitricSDK as Nitric SDK
-    participant NitricRuntime as Nitric Runtime
-    participant SQLDatabase as SQL Database (e.g., PostgreSQL, MySQL)
-
-    Client->>NitricSDK: Perform SQL operation (e.g., query, insert, update)
-    NitricSDK->>NitricRuntime: Forward SQL API call
-    NitricRuntime->>SQLDatabase: Execute SQL operation
-
-    alt Successful Operation
-        SQLDatabase-->>NitricRuntime: Return result (e.g., query data or success status)
-        NitricRuntime-->>NitricSDK: Return result
-        NitricSDK-->>Client: Return result to client
-    else Failure
-        SQLDatabase-->>NitricRuntime: Return error
-        NitricRuntime-->>NitricSDK: Forward error
-        NitricSDK-->>Client: Return error response
-    end
+    participant Client as App Code
+    participant SDK as Nitric SDK
+    participant Nitric as Nitric Runtime <br> (plugin)
+    participant CloudAPI as Cloud DMBS <br> (e.g. AWS RDS)
+
+    Client->>SDK: connectionString()
+    SDK->>Nitric: Forward Request
+    Nitric->>Nitric: Convert Request
+    Nitric->>CloudAPI: Retrieve Connection String
+
+    Client->>CloudAPI: Execute SQL Query
 ```
 
 ## 3. Component

docs/architecture/websockets.mdx

@@ -47,31 +47,66 @@ classDef edgeLabel line-height:2;
 
 ## 2. Sequence
 
+### Build Sequence
+
+Here is the sequence of events that occur when a developer registers an Websocket API with Nitric, including the registration of handlers for connection, message, and disconnection events.
+
+```mermaid
+sequenceDiagram
+  participant Worker as App Worker(s)
+  participant SDK as Nitric SDK
+  participant Nitric as Nitric CLI
+  participant Provider as Nitric Provider <br> (plugin)
+  participant IAC as IaC <br> (e.g. Terraform)
+
+  Worker->>SDK: Register Websocket(s)
+  SDK->>Nitric: Register Websocket(s)
+
+  Worker->>SDK: Register Connection Handler
+  SDK->>Nitric: Register Connection Handler
+  Worker->>SDK: Register Message Handler
+  SDK->>Nitric: Register Message Handler
+  Worker->>SDK: Register Disconnection Handler
+  SDK->>Nitric: Register Disconnection Handler
+
+  Nitric->>Provider: Forward Nitric Spec
+  Provider->>IAC: Provision Websocket API
+  Provider->>IAC: Provision IAM
+```
+
+### Runtime Sequence
+
+Here is the sequence of events that occur at runtime when a websocket connection is established, messages are sent and received, and the connection is closed.
+
 ```mermaid
 sequenceDiagram
     participant Client as Client
+    participant WSGateway as WebSocket Gateway <br> (e.g. AWS API Gateway)
+    participant NitricRuntime as Nitric Runtime <br> (plugin)
     participant NitricSDK as Nitric SDK
-    participant NitricRuntime as Nitric Runtime
-    participant WebSocketGateway as Cloud WebSocket Gateway (e.g., AWS API Gateway, GCP WebSocket Gateway)
+    participant App as App Code
 
-    Client->>NitricSDK: Connect to WebSocket endpoint
-    NitricSDK->>NitricRuntime: Forward connection request
-    NitricRuntime->>WebSocketGateway: Establish WebSocket connection
+    Client->>WSGateway: Connect to ws:// endpoint
+    WSGateway->>NitricRuntime: Forward Connection Event
+    NitricRuntime->>NitricSDK: Connection Callback
 
     loop Real-Time Communication
-        Client->>NitricSDK: Send or receive WebSocket message
-        NitricSDK->>NitricRuntime: Forward message
-        NitricRuntime->>WebSocketGateway: Relay message
-        WebSocketGateway-->>NitricRuntime: Forward response or broadcast message
-        NitricRuntime-->>NitricSDK: Relay message to the client
-        NitricSDK-->>Client: Deliver message
+        alt Client Message
+          Client->>WSGateway: Send WS Message
+          WSGateway->>NitricRuntime: Forward Message
+          NitricRuntime->>NitricSDK: Forward Message
+          NitricSDK->>App: Message Callback
+        else Server Message
+          App->>NitricSDK: Send WS Message
+          NitricSDK->>NitricRuntime: Forward Message
+          NitricRuntime->>WSGateway: Forward Message
+          WSGateway->>Client: Deliver Message
+        end
     end
 
-    alt Disconnect
-        Client->>NitricSDK: Disconnect from WebSocket
-        NitricSDK->>NitricRuntime: Notify runtime
-        NitricRuntime->>WebSocketGateway: Close WebSocket connection
-    end
+    Client->>WSGateway: Disconnect
+    WSGateway->>NitricRuntime: Forward Disconnection Event
+    NitricRuntime->>NitricSDK: Disconnection Callback
 ```
 
 ## 3. Component