Implement yarn workspaces for Lambda functions management and update .gitignore

Author: kaiz-io

typescript/postgres-lambda/.gitignore

@@ -2,7 +2,34 @@
 !jest.config.js
 *.d.ts
 node_modules
+**/node_modules
 
 # CDK asset staging directory
 .cdk.staging
 cdk.out
+
+# Yarn specific
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+.pnp.*
+yarn-debug.log*
+yarn-error.log*
+
+# Build artifacts
+dist/
+build/
+*.tsbuildinfo
+
+# IDE files
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db

typescript/postgres-lambda/README.md

@@ -9,6 +9,7 @@ A complete AWS CDK example demonstrating bidirectional integration between Auror
 - **Secure Architecture**: Private subnets, IAM roles, and Secrets Manager integration
 - **Production-Ready**: Includes error handling, connection pooling, and security best practices
 - **Automated Setup**: Custom CDK resource automatically configures PostgreSQL extensions and functions
+- **Yarn Workspaces**: Organized monorepo structure for managing multiple Lambda functions
 
 ## Architecture
 
@@ -23,10 +24,10 @@ graph TD
         end
     end
     
-    L1 -->|"(1) Connect and Query"| DB
-    DB -->|"(2) Invoke via aws_lambda extension"| L2
-    L2 -->|"(3) Return Result"| DB
-    L3 -->|"(4) Setup Extensions & Functions"| DB
+    L1 -->|"1. Connect and Query"| DB
+    DB -->|"2. Invoke via aws_lambda extension"| L2
+    L2 -->|"3. Return Result"| DB
+    L3 -->|"4. Setup Extensions & Functions"| DB
     
     SM[AWS Secrets Manager] -->|Provide Credentials| L1
     SM -->|Provide Credentials| L3
@@ -54,16 +55,17 @@ graph TD
 
 - AWS CDK v2 installed (`npm install -g aws-cdk`)
 - Node.js 18.x or later
+- Yarn package manager installed
 - AWS CLI configured with appropriate credentials
 
 ### Deploy
 
 ```bash
-# Install dependencies
-npm install
+# Install dependencies using yarn workspaces
+yarn install
 
 # Deploy the stack (setup is now automated!)
-npx cdk deploy
+yarn cdk deploy
 ```
 
 The deployment will automatically:
@@ -145,6 +147,30 @@ SELECT validate_data('{"id": 789, "value": "valid data"}'::JSONB);
 └── README.md              # This file
 ```
 
+## Yarn Workspaces
+
+This project uses Yarn Workspaces to manage multiple packages in a monorepo structure:
+
+```bash
+# List all workspaces
+yarn workspaces list
+
+# Run a command in all Lambda workspaces
+yarn workspaces foreach -v --include '@lambda/*' run <command>
+
+# Run a command in a specific workspace
+yarn workspace @lambda/lambda-to-postgres run <command>
+
+# Install dependencies for all workspaces
+yarn install
+```
+
+The workspace structure allows for:
+- Shared dependencies between packages
+- Individual package management
+- Simplified build and deployment process
+- Better organization of Lambda functions
+
 ## Configuration
 
 ### Environment Variables
@@ -215,16 +241,16 @@ Before using in production:
 
 ```bash
 # Build and watch for changes
-npm run watch
+yarn watch
 
 # Run tests
-npm run test
+yarn test
 
 # View CloudFormation template
-npx cdk synth
+yarn cdk synth
 
 # Compare deployed vs current state
-npx cdk diff
+yarn cdk diff
 
 # View stack outputs
 aws cloudformation describe-stacks --stack-name PostgresLambdaStack --query 'Stacks[0].Outputs'
@@ -236,7 +262,7 @@ aws logs describe-log-groups --log-group-name-prefix /aws/lambda/PostgresLambdaS
 ## Cleanup
 
 ```bash
-npx cdk destroy
+yarn cdk destroy
 ```
 
 **Note**: This will delete all resources including the database and any data stored in it.
@@ -265,4 +291,4 @@ npx cdk destroy
 
 ## License
 
-This example is provided under the MIT-0 License. See the LICENSE file for details.
+This example is provided under the MIT-0 License. See the LICENSE file for details.

typescript/postgres-lambda/lambda/lambda-to-postgres/package.json

@@ -1,10 +1,14 @@
 {
-  "name": "lambda-to-postgres",
+  "name": "@lambda/lambda-to-postgres",
   "version": "1.0.0",
-  "description": "Lambda function that calls PostgreSQL",
+  "description": "Lambda function that connects to PostgreSQL",
   "main": "index.js",
+  "scripts": {
+    "build": "echo 'No build needed for JavaScript files'",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
   "dependencies": {
-    "pg": "^8.11.3",
-    "@aws-sdk/client-secrets-manager": "^3.450.0"
+    "pg": "^8.16.3",
+    "aws-sdk": "^2.1377.0"
   }
 }

typescript/postgres-lambda/lambda/postgres-setup/package.json

@@ -1,9 +1,14 @@
 {
-  "name": "postgres-setup",
+  "name": "@lambda/postgres-setup",
   "version": "1.0.0",
+  "description": "Lambda function for automated PostgreSQL setup",
+  "main": "index.js",
+  "scripts": {
+    "build": "echo 'No build needed for JavaScript files'",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
   "dependencies": {
-    "pg": "^8.11.3",
-    "@aws-sdk/client-secrets-manager": "^3.0.0",
-    "node-fetch": "^3.3.2"
+    "pg": "^8.16.3",
+    "aws-sdk": "^2.1377.0"
   }
-}
+}

typescript/postgres-lambda/lambda/postgres-to-lambda/package.json

@@ -1,7 +1,13 @@
 {
-  "name": "postgres-to-lambda",
+  "name": "@lambda/postgres-to-lambda",
   "version": "1.0.0",
-  "description": "Lambda function that is called by PostgreSQL",
+  "description": "Lambda function called by PostgreSQL",
   "main": "index.js",
-  "dependencies": {}
+  "scripts": {
+    "build": "echo 'No build needed for JavaScript files'",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {
+    "aws-sdk": "^2.1377.0"
+  }
 }

typescript/postgres-lambda/lib/postgres-lambda-stack.ts

@@ -98,7 +98,6 @@ export class PostgresLambdaStack extends cdk.Stack {
         DB_SECRET_ARN: dbCluster.secret?.secretArn || '',
         DB_NAME: 'demodb',
         POSTGRES_FUNCTION_NAME: postgresFunction.functionName,
-        AWS_REGION: this.region,
       },
       timeout: cdk.Duration.minutes(5),
     });
@@ -142,4 +141,4 @@ export class PostgresLambdaStack extends cdk.Stack {
       description: 'The ARN of the role that PostgreSQL can assume to invoke Lambda',
     });
   }
-}
+}

typescript/postgres-lambda/package.json

@@ -1,11 +1,17 @@
 {
   "name": "postgres-lambda",
   "version": "0.1.0",
+  "private": true,
+  "workspaces": [
+    ".",
+    "lambda/*"
+  ],
   "bin": {
     "postgres-lambda": "bin/postgres-lambda.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && yarn workspaces foreach -v -A run build",
+    "build:lambda": "yarn workspaces foreach -v -A run build",
     "watch": "tsc -w",
     "test": "jest",
     "cdk": "cdk"
@@ -21,10 +27,8 @@
   },
   "dependencies": {
     "@aws-cdk/aws-lambda-nodejs": "^1.203.0",
-    "@types/pg": "^8.15.4",
     "aws-cdk-lib": "^2.204.0",
     "constructs": "^10.4.2",
-    "esbuild": "^0.25.6",
-    "pg": "^8.16.3"
+    "esbuild": "^0.25.6"
   }
 }