added new handler for test section, addressed PR feedback

Author: am29d

docs/utilities/parser.md

@@ -252,35 +252,35 @@ We recommend to use the types provided by the parser utility. If you encounter a
 
 ## Testing your code
 
-When testing your handler with **parser decorator** you need to use double assetion to bypass TypeScript type checking in your tests.
+When testing your handler with [**parser decorator**](#parse-events) you need to use double assetion to bypass TypeScript type checking in your tests.
 This is useful when you want to test the handler for invalid payloads or when you want to test the error handling.
 If you are you use middy middleware, you don't need to do this.
 
 === "handlerDecorator.test.ts"
 
-    ```typescript hl_lines="29"
+    ```typescript hl_lines="26"
     --8<-- "examples/snippets/parser/unitTestDecorator.ts"
     ```
-
+    
     1. Use double assertion `as unknown as X` to bypass TypeScript type checking in your tests
 
 === "handlerDecorator.ts"
 
     ```typescript
-    --8<-- "examples/snippets/parser/decorator.ts"
+    --8<-- "examples/snippets/parser/handlerDecorator.ts"
     ```
 
 === "schema.ts"
 
-    ```typescript"
+    ```typescript
     --8<-- "examples/snippets/parser/schema.ts"
     ```
 
 This also works when using `safeParse` option.
 
 === "handlerSafeParse.test.ts"
 
-    ```typescript hl_lines="24-32 38 48"
+    ```typescript hl_lines="21-29 35 45"
     --8<-- "examples/snippets/parser/unitTestSafeParse.ts"
     ```
 
@@ -289,11 +289,11 @@ This also works when using `safeParse` option.
 === "handlerSafeParse.ts"
 
     ```typescript
-    --8<-- "examples/snippets/parser/safeParseDecorator.ts"
+    --8<-- "examples/snippets/parser/handlerSafeParseDecorator.ts"
     ```
 
 === "schema.ts"
 
-    ```typescript"
+    ```typescript
     --8<-- "examples/snippets/parser/schema.ts"
     ```

examples/snippets/parser/handlerDecorator.ts

@@ -0,0 +1,20 @@
+import type { Context } from 'aws-lambda';
+import type { LambdaInterface } from '@aws-lambda-powertools/commons/types';
+import { parser } from '@aws-lambda-powertools/parser';
+import { Logger } from '@aws-lambda-powertools/logger';
+import { orderSchema, type Order } from './schema.js';
+
+const logger = new Logger();
+
+class Lambda implements LambdaInterface {
+  @parser({ schema: orderSchema })
+  public async handler(event: Order, _context: Context): Promise<number> {
+    logger.info('Processing event', { event });
+
+    // ... business logic
+    return event.id;
+  }
+}
+
+const myFunction = new Lambda();
+export const handler = myFunction.handler.bind(myFunction);

examples/snippets/parser/handlerSafeParseDecorator.ts

@@ -0,0 +1,36 @@
+import type { Context } from 'aws-lambda';
+import type { LambdaInterface } from '@aws-lambda-powertools/commons/types';
+import { parser } from '@aws-lambda-powertools/parser';
+import { Logger } from '@aws-lambda-powertools/logger';
+import { orderSchema, type Order } from './schema.js';
+import { EventBridgeEnvelope } from '@aws-lambda-powertools/parser/envelopes';
+import type {
+  ParsedResult,
+  EventBridgeEvent,
+} from '@aws-lambda-powertools/parser/types';
+
+const logger = new Logger();
+
+class Lambda implements LambdaInterface {
+  @parser({
+    schema: orderSchema,
+    envelope: EventBridgeEnvelope,
+    safeParse: true,
+  })
+  public async handler(
+    event: ParsedResult<EventBridgeEvent, Order>,
+    _context: Context
+  ): Promise<number> {
+    logger.info('Processing event', { event });
+    if (event.success) {
+      // ... business logic
+      return event.data.id;
+    } else {
+      logger.error('Failed to parse event', { event });
+      throw new Error('Failed to parse event');
+    }
+  }
+}
+
+const myFunction = new Lambda();
+export const handler = myFunction.handler.bind(myFunction);

examples/snippets/parser/schema.ts

@@ -13,4 +13,6 @@ const orderSchema = z.object({
   optionalField: z.string().optional(),
 });
 
-export { orderSchema };
+type Order = z.infer<typeof orderSchema>;
+
+export { orderSchema, type Order };

examples/snippets/parser/unitTestDecorator.ts

@@ -1,11 +1,8 @@
-import { orderSchema } from 'examples/snippets/parser/schema';
-import { Context } from 'aws-lambda';
-import { handler } from 'examples/snippets/parser/decorator';
-import { z } from 'zod';
+import type { Context } from 'aws-lambda';
+import type { Order } from './schema.js';
+import { handler } from './decorator.js';
 
 describe('Test handler', () => {
-  type Order = z.infer<typeof orderSchema>;
-
   it('should parse event successfully', async () => {
     const testEvent = {
       id: 123,
@@ -19,7 +16,7 @@ describe('Test handler', () => {
       ],
     };
 
-    await expect(handler(testEvent, {} as Context)).resolves.not.toThrow();
+    await expect(handler(testEvent, {} as Context)).resolves.toEqual(123);
   });
 
   it('should throw error if event is invalid', async () => {

examples/snippets/parser/unitTestSafeParse.ts

@@ -1,15 +1,12 @@
-import { orderSchema } from 'examples/snippets/parser/schema';
-import { Context } from 'aws-lambda';
-import { handler } from 'examples/snippets/parser/safeParseDecorator';
-import { z } from 'zod';
+import type { Order } from './schema.js';
+import type { Context } from 'aws-lambda';
+import { handler } from './safeParseDecorator.js';
 import {
   ParsedResult,
   EventBridgeEvent,
 } from '@aws-lambda-powertools/parser/types';
 
 describe('Test handler', () => {
-  type Order = z.infer<typeof orderSchema>;
-
   it('should parse event successfully', async () => {
     const testEvent = {
       version: '0',
@@ -38,7 +35,7 @@ describe('Test handler', () => {
         testEvent as unknown as ParsedResult<EventBridgeEvent, Order>, // (1)!
         {} as Context
       )
-    ).resolves.not.toThrow();
+    ).resolves.toEqual(10876546789);
   });
 
   it('should throw error if event is invalid', async () => {