docs(maintenance): update examples to v2 (#2242)

* docs(examples): refresh cdk example

* docs(examples): refresh cdk example

* docs: update template & functions

* chore: update arch to arm

* chore: update comments & confis

* chore: removed sam folder & merged samples

* chore: fix tests

* chore: reliability

Author: dreamorosi

.github/boring-cyborg.yml

@@ -71,22 +71,7 @@ labelPRBasedOnFilePath:
     - docs/**/*
     - mkdocs.yml
     - typedoc.js
-    - examples/cdk/bin/*
-    - examples/cdk/functions/*
-    - examples/cdk/functions/**/*
-    - examples/cdk/src/*
-    - examples/cdk/src/**/*
-    - examples/cdk/tests/*
-    - examples/cdk/tests/**/*
-    - examples/cdk/README.md
-    - examples/cdk/cdk.json
-    - examples/sam/events/*
-    - examples/sam/src/*
-    - examples/sam/src/**/*
-    - examples/sam/tests/*
-    - examples/sam/tests/**/*
-    - examples/sam/README.md
-    - examples/sam/template.yaml
+    - examples/app/*
 
   area/automation:
     - .github/scripts/*
@@ -137,8 +122,7 @@ labelPRBasedOnFilePath:
     - packages/parser/README.md
     - layers/tsconfig*.json
     - layers/README.md
-    - examples/sam/tsconfig*.json
-    - examples/cdk/tsconfig*.json
+    - examples/app/tsconfig*.json
 
   type/dependencies:
     - package.json
@@ -153,8 +137,7 @@ labelPRBasedOnFilePath:
     - packages/validator/package.json
     - packages/batch/package.json
     - layers/package.json
-    - examples/cdk/package.json
-    - examples/sam/package.json
+    - examples/app/package.json
 
 ##### Greetings ########################################################################################################
 firstPRWelcomeComment: >

.github/workflows/reusable-run-linting-check-and-unit-tests.yml

@@ -37,7 +37,7 @@ jobs:
       NODE_ENV: dev
     strategy:
       matrix:
-        example: ["sam", "cdk"]
+        example: ["app"]
       fail-fast: false
     defaults:
       run:

.gitignore

@@ -41,10 +41,6 @@ site
 # Generated API documentation (from TypeDoc)
 /api
 
-# SAM Example copies files
-/examples/sam/src/handlers/*
-!/examples/sam/src/handlers/COPY_LAMBDA_FUNCTIONS_HERE
-
 # Layer temp files
 tmp
 

README.md

@@ -84,8 +84,7 @@ Or refer to the installation guide of each utility:
 
 ### Examples
 
-* [CDK](https://github.com/aws-powertools/powertools-lambda-typescript/tree/main/examples/cdk)
-* [SAM](https://github.com/aws-powertools/powertools-lambda-typescript/tree/main/examples/sam)
+You can find examples of how to use Powertools for AWS Lambda (TypeScript) in the [examples](https://github.com/aws-powertools/powertools-lambda-typescript/tree/main/examples/app) directory. The application is a simple REST API that can be deployed via either AWS CDK or AWS SAM.
 
 ### Demo applications
 

docs/contributing/conventions.md

@@ -31,7 +31,7 @@ Whenever possible, we use the same directory structure for all utilities. This m
 There are also a few other workspaces that are not utilities published to npm, but that still share dependencies and/or runtime code with the utilities. These workspaces are:
 
 * `docs/snippets`: contains the documentation code snippets
-* `examples/*`: contains the example projects deployed via AWS CDK or AWS SAM
+* `examples/app`: contains an example project that can be deployed via AWS CDK or AWS SAM
 * `layers`: contains the code used to build and publish the [Lambda layers](../index.md#lambda-layer)
 
 ## Testing definition

docs/index.md

@@ -272,12 +272,9 @@ The examples in this documentation will feature all the approaches described abo
 
 ## Examples
 
-The project's repository includes examples of how to instrument your functions both in AWS CDK and AWS SAM:
+You can find examples of how to use Powertools for AWS Lambda (TypeScript) in the [examples](https://github.com/aws-powertools/powertools-lambda-typescript/tree/main/examples/app){target="_blank"} directory. The application is a simple REST API that can be deployed via either AWS CDK or AWS SAM.
 
-* [AWS CDK](https://github.com/aws-powertools/powertools-lambda-typescript/tree/main/examples/cdk){target="_blank"}
-* [AWS SAM](https://github.com/aws-powertools/powertools-lambda-typescript/tree/main/examples/sam){target="_blank"}
-
-If instead you want to see Powertools for AWS Lambda (TypeScript) in a slightly more complex use case, check the [Serverless TypeScript Demo](https://github.com/aws-samples/serverless-typescript-demo) or the [AWS Lambda performance tuning](https://github.com/aws-samples/optimizations-for-lambda-functions) repository. Both demos use Powertools for AWS Lambda (TypeScript) as well as demonstrating other common techniques for Lambda functions written in TypeScript.
+If instead you want to see Powertools for AWS Lambda (TypeScript) in slightly different use cases, check the [Serverless TypeScript Demo](https://github.com/aws-samples/serverless-typescript-demo) or the [AWS Lambda performance tuning](https://github.com/aws-samples/optimizations-for-lambda-functions) repository. Both demos use Powertools for AWS Lambda (TypeScript) as well as demonstrating other common techniques for Lambda functions written in TypeScript.
 
 
 ## Features

examples/cdk/.gitignore renamed to examples/app/.gitignore

@@ -8,5 +8,13 @@ node_modules
 .cdk.staging
 cdk.out
 lib
+# npm lock file - this is managed by the npm workspace
+package-lock.json
+
+**/.aws-sam
+
+# SAM
+samconfig.toml
+
 # npm lock file - this is managed by the npm workspace
 package-lock.json

examples/cdk/CHANGELOG.md renamed to examples/app/CHANGELOG.md

@@ -1,5 +1,5 @@
 {
-  "app": "npx ts-node --prefer-ts-exts bin/cdk-app.ts",
+  "app": "tsx cdk/example-app.ts",
   "watch": {
     "include": [
       "**"