style(docs): apply stricter linting (#4574)

Author: dreamorosi

biome.json

@@ -1,5 +1,6 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.2.4/schema.json",
+  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+  "root": true,
   "assist": {
     "actions": {
       "source": {

docs/features/event-handler/appsync-events.md

@@ -210,7 +210,7 @@ When processing batch of items with `aggregate` enabled, you must format the pay
 
 === "Error handling with batch of items"
 
-    ```typescript hl_lines="21-24"
+    ```typescript hl_lines="25-28"
     --8<-- "examples/snippets/event-handler/appsync-events/errorHandlingWithBatchOfItems.ts"
     ```
 

docs/features/event-handler/appsync-graphql.md

@@ -176,7 +176,7 @@ You can use an AppSync JavaScript resolver or a VTL response mapping template to
 
 === "Exception Handling response"
 
-    ```json hl_lines="11 20"
+    ```json hl_lines="9 18"
     --8<-- "examples/snippets/event-handler/appsync-graphql/exceptionHandlingResponse.json"
     ```
 

docs/features/event-handler/rest.md

@@ -479,7 +479,7 @@ You can enable response compression by using the `compress` middleware. This wil
 
 === "Response"
 
-    ```json hl_lines="7-9 11 12"
+    ```json hl_lines="4-5 7-8"
     --8<-- "examples/snippets/event-handler/rest/samples/advanced_compress_res.json"
     ```
 

docs/features/tracer.md

@@ -230,7 +230,7 @@ You can trace other class methods using the `captureMethod` decorator or any arb
 
 === "Manual"
 
-    ```typescript hl_lines="7-13 19 22 26-31"
+    ```typescript hl_lines="7-10 16 21 25 27"
     --8<-- "examples/snippets/tracer/captureMethodManual.ts"
     ```
 

examples/snippets/batch/advancedTracingRecordHandler.ts

@@ -22,7 +22,7 @@ const recordHandler = async (record: SQSRecord): Promise<void> => {
       // do something with the item
       subsegment?.addMetadata('item', item);
     } catch (error) {
-      subsegment?.addError(error);
+      subsegment?.addError(error as Error);
       throw error;
     }
   }

examples/snippets/biome.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "../../node_modules/@biomejs/biome/configuration_schema.json",
+  "extends": "//",
+  "root": false,
+  "linter": {
+    "rules": {
+      "suspicious": {
+        "useAwait": "off"
+      }
+    }
+  }
+}

examples/snippets/event-handler/appsync-events/errorHandlingWithBatchOfItems.ts

@@ -18,9 +18,13 @@ app.onPublish(
           payload: { processed: true, original_payload: payload },
         });
       } catch (error) {
+        const errorString =
+          error instanceof Error
+            ? `${error.name} - ${error.message}`
+            : 'Unknown error';
         returnValues.push({
           id: payload.id,
-          error: `${error.name} - ${error.message}`,
+          error: errorString,
         });
       }
     }

examples/snippets/event-handler/appsync-graphql/advancedTestYourCode.ts

@@ -38,7 +38,7 @@ describe('Unit test for AppSync GraphQL Resolver', () => {
     const event = onGraphqlEventFactory('listLocations', 'Query');
 
     // Act
-    const result = (await handler(event, {} as Context)) as Promise<unknown[]>;
+    const result = (await handler(event, {} as Context)) as unknown[];
 
     // Assess
     expect(result).toHaveLength(2);

examples/snippets/event-handler/appsync-graphql/exceptionHandling.ts

@@ -1,6 +1,6 @@
+import { AssertionError } from 'node:assert';
 import { AppSyncGraphQLResolver } from '@aws-lambda-powertools/event-handler/appsync-graphql';
 import { Logger } from '@aws-lambda-powertools/logger';
-import { AssertionError } from 'node:assert';
 import type { Context } from 'aws-lambda';
 
 const logger = new Logger({