update comments

Signed-off-by: Nik Nasr <nik@restate.dev>

Author: nikrooz

packages/libs/restate-sdk/src/endpoint/handlers/fetch.ts

@@ -48,8 +48,9 @@ export function fetcher(handler: RestateHandler) {
           abortSignal: event.signal,
         })
         .catch((e) => {
-          // Framework wrapper guarantees writeHead is called and closes the
-          // output stream; anything reaching here is a post-commit error.
+          // wrapResponseWithSafety guarantees writeHead is called and
+          // closes the output stream; anything reaching here is a
+          // post-commit error.
           const error = ensureError(e);
           const logger =
             tryCreateContextualLogger(

packages/libs/restate-sdk/src/endpoint/handlers/generic.ts

@@ -95,7 +95,8 @@ export function createRestateHandler(
 }
 
 /**
- * Framework-level safety net around a user-provided `RestateResponse`.
+ * Safety net around a `RestateResponse` returned by `_handle()`, applied
+ * in `RestateHandlerImpl.handle()` before the response reaches any adapter.
  *
  * Guarantees to adapters:
  *   - `writeHead` is called exactly once on the success path.

packages/libs/restate-sdk/src/endpoint/handlers/lambda.ts

@@ -155,8 +155,8 @@ export class LambdaHandler {
         };
       }
 
-      // Framework wrapper guarantees writeHead was called, so this resolves
-      // synchronously on the next microtask.
+      // wrapResponseWithSafety guarantees writeHead was called, so this
+      // resolves synchronously on the next microtask.
       const head = await headPromise;
 
       const responseBodyBuffer = Buffer.concat(chunks);

packages/libs/restate-sdk/src/endpoint/node_endpoint.ts

@@ -209,7 +209,7 @@ function nodeHandlerImpl(
         abortSignal: abortController.signal,
       })
       .catch((e) => {
-        // Framework wrapper guarantees writeHead is called; anything
+        // wrapResponseWithSafety guarantees writeHead is called; anything
         // reaching here is a post-commit error. Nothing to do but log.
         const error = ensureError(e);
         const logger =