initial commit

Author: Arunsai14

examples/complete-lambda-example/README.md

@@ -1,69 +1,5 @@
 # Complete Lambda Example - All Features Showcase
 
-This is the **ultimate example** that demonstrates **ALL features** of the AWS Lambda Terraform module in a single, comprehensive deployment. This example showcases every capability including VPC integration, database connectivity, dead letter queues, versioning, aliases, provisioned concurrency, multiple event sources, KMS encryption, and advanced monitoring.
-
-## 🚀 What This Example Creates
-
-### **Core Infrastructure**
-- ✅ **RDS PostgreSQL Database** with encryption and security groups
-- ✅ **KMS Key** for environment variable encryption
-
-### **Lambda Function Features**
-- ✅ **ARM64 Architecture** for better price-performance
-- ✅ **VPC Integration** with private subnet deployment
-- ✅ **Dead Letter Queue** with SQS for error handling
-- ✅ **Versioning & Aliases** for blue-green deployments
-- ✅ **Provisioned Concurrency** to eliminate cold starts
-- ✅ **KMS Encryption** for environment variables
-- ✅ **Lambda Insights** for advanced monitoring
-- ✅ **Function URL** with CORS configuration
-
-### **Event Sources & Integrations**
-- ✅ **S3 Bucket** with object event notifications
-- ✅ **SNS Topic** with Lambda subscription
-- ✅ **SQS Queue** with event source mapping
-- ✅ **API Gateway** with Lambda proxy integration
-- ✅ **EventBridge** with scheduled invocations
-- ✅ **SSM Parameter Store** with 10+ parameters
-
-### **Monitoring & Observability**
-- ✅ **CloudWatch Dashboard** with comprehensive metrics
-- ✅ **CloudWatch Alarms** for errors, duration, and DLQ
-- ✅ **Custom Metrics** for application-specific monitoring
-- ✅ **Structured Logging** with configurable levels
-
-## 🚀 Quick Start
-
-### 1. **Prerequisites**
-- AWS CLI configured with appropriate permissions
-- Terraform >= 1.3.0 installed
-- Unique S3 bucket name ready
-
-### 2. **Configuration**
-Edit `terraform.tfvars` and update:
-```hcl
-# REQUIRED: Change to a globally unique name
-s3_bucket_name = "your-unique-complete-lambda-bucket-name"
-
-# OPTIONAL: Add your email for notifications
-notification_email = "[email protected]"
-
-# OPTIONAL: Adjust costs by modifying these
-provisioned_concurrent_executions = 3  # Reduce to save money
-```
-
-### 3. **Deploy**
-```bash
-# Initialize Terraform
-terraform init
-
-# Review the plan (will show ~30 resources)
-terraform plan
-
-# Deploy (takes 5-10 minutes)
-terraform apply
-
-
 <!-- BEGIN_TF_DOCS -->
 ## Requirements
 
@@ -87,6 +23,7 @@ terraform apply
 | <a name="module_arc_security_group"></a> [arc\_security\_group](#module\_arc\_security\_group) | sourcefuse/arc-security-group/aws | 0.0.1 |
 | <a name="module_complete_lambda"></a> [complete\_lambda](#module\_complete\_lambda) | ../../ | n/a |
 | <a name="module_rds"></a> [rds](#module\_rds) | sourcefuse/arc-db/aws | 4.0.1 |
+| <a name="module_s3"></a> [s3](#module\_s3) | sourcefuse/arc-s3/aws | 0.0.4 |
 | <a name="module_tags"></a> [tags](#module\_tags) | sourcefuse/arc-tags/aws | 1.2.6 |
 
 ## Resources
@@ -108,19 +45,14 @@ terraform apply
 | [aws_kms_alias.lambda_key_alias](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/kms_alias) | resource |
 | [aws_kms_key.lambda_key](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/kms_key) | resource |
 | [aws_lambda_event_source_mapping.sqs_trigger](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/lambda_event_source_mapping) | resource |
-| [aws_s3_bucket.event_source](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_bucket) | resource |
 | [aws_s3_bucket_notification.lambda_notification](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_bucket_notification) | resource |
-| [aws_s3_bucket_public_access_block.event_source](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_bucket_public_access_block) | resource |
-| [aws_s3_bucket_server_side_encryption_configuration.event_source](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_bucket_server_side_encryption_configuration) | resource |
-| [aws_s3_bucket_versioning.event_source](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_bucket_versioning) | resource |
 | [aws_sns_topic.lambda_notifications](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/sns_topic) | resource |
 | [aws_sns_topic_subscription.email_notification](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/sns_topic_subscription) | resource |
 | [aws_sns_topic_subscription.lambda_subscription](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/sns_topic_subscription) | resource |
 | [aws_sqs_queue.lambda_queue](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/sqs_queue) | resource |
 | [aws_ssm_parameter.lambda_config](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/ssm_parameter) | resource |
 | [archive_file.lambda_zip](https://registry.terraform.io/providers/hashicorp/archive/latest/docs/data-sources/file) | data source |
-| [aws_caller_identity.current](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/caller_identity) | data source |
-| [aws_region.current](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/region) | data source |
+| [aws_kms_key.sns](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/kms_key) | data source |
 | [aws_subnets.private](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/subnets) | data source |
 | [aws_vpc.default](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/vpc) | data source |
 | [aws_vpc.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/vpc) | data source |
@@ -129,6 +61,7 @@ terraform apply
 
 | Name | Description | Type | Default | Required |
 |------|-------------|------|---------|:--------:|
+| <a name="input_acl"></a> [acl](#input\_acl) | ACL value | `string` | n/a | yes |
 | <a name="input_alias_name"></a> [alias\_name](#input\_alias\_name) | Name of the Lambda alias | `string` | `"production"` | no |
 | <a name="input_api_stage_name"></a> [api\_stage\_name](#input\_api\_stage\_name) | API Gateway stage name | `string` | `"prod"` | no |
 | <a name="input_aws_region"></a> [aws\_region](#input\_aws\_region) | AWS region for resources | `string` | `"us-east-1"` | no |
@@ -152,26 +85,16 @@ terraform apply
 
 | Name | Description |
 |------|-------------|
-| <a name="output_api_gateway_rest_api_id"></a> [api\_gateway\_rest\_api\_id](#output\_api\_gateway\_rest\_api\_id) | ID of the API Gateway REST API |
-| <a name="output_api_gateway_url"></a> [api\_gateway\_url](#output\_api\_gateway\_url) | URL of the API Gateway endpoint |
+| <a name="output_alias_arn"></a> [alias\_arn](#output\_alias\_arn) | ARN of the Lambda alias |
+| <a name="output_alias_name"></a> [alias\_name](#output\_alias\_name) | Name of the Lambda alias |
+| <a name="output_arn"></a> [arn](#output\_arn) | ARN of the Lambda function |
 | <a name="output_cloudwatch_dashboard_url"></a> [cloudwatch\_dashboard\_url](#output\_cloudwatch\_dashboard\_url) | URL to the CloudWatch dashboard |
 | <a name="output_dead_letter_queue_arn"></a> [dead\_letter\_queue\_arn](#output\_dead\_letter\_queue\_arn) | ARN of the Dead Letter Queue |
 | <a name="output_dead_letter_queue_url"></a> [dead\_letter\_queue\_url](#output\_dead\_letter\_queue\_url) | URL of the Dead Letter Queue |
-| <a name="output_eventbridge_rule_name"></a> [eventbridge\_rule\_name](#output\_eventbridge\_rule\_name) | Name of the EventBridge rule |
-| <a name="output_kms_key_arn"></a> [kms\_key\_arn](#output\_kms\_key\_arn) | ARN of the KMS key used for encryption |
-| <a name="output_kms_key_id"></a> [kms\_key\_id](#output\_kms\_key\_id) | ID of the KMS key used for encryption |
-| <a name="output_lambda_alias_arn"></a> [lambda\_alias\_arn](#output\_lambda\_alias\_arn) | ARN of the Lambda alias |
-| <a name="output_lambda_alias_name"></a> [lambda\_alias\_name](#output\_lambda\_alias\_name) | Name of the Lambda alias |
-| <a name="output_lambda_function_arn"></a> [lambda\_function\_arn](#output\_lambda\_function\_arn) | ARN of the Lambda function |
-| <a name="output_lambda_function_name"></a> [lambda\_function\_name](#output\_lambda\_function\_name) | Name of the Lambda function |
-| <a name="output_lambda_function_url"></a> [lambda\_function\_url](#output\_lambda\_function\_url) | Lambda function URL (if enabled) |
-| <a name="output_lambda_function_version"></a> [lambda\_function\_version](#output\_lambda\_function\_version) | Published version of the Lambda function |
-| <a name="output_lambda_insights_url"></a> [lambda\_insights\_url](#output\_lambda\_insights\_url) | URL to Lambda Insights |
-| <a name="output_lambda_role_arn"></a> [lambda\_role\_arn](#output\_lambda\_role\_arn) | ARN of the Lambda execution role |
-| <a name="output_s3_bucket_arn"></a> [s3\_bucket\_arn](#output\_s3\_bucket\_arn) | ARN of the S3 bucket for event source |
+| <a name="output_insights_url"></a> [insights\_url](#output\_insights\_url) | URL to Lambda Insights |
+| <a name="output_name"></a> [name](#output\_name) | Name of the Lambda function |
+| <a name="output_role_arn"></a> [role\_arn](#output\_role\_arn) | ARN of the Lambda execution role |
 | <a name="output_s3_bucket_name"></a> [s3\_bucket\_name](#output\_s3\_bucket\_name) | Name of the S3 bucket for event source |
-| <a name="output_sns_topic_arn"></a> [sns\_topic\_arn](#output\_sns\_topic\_arn) | ARN of the SNS topic |
-| <a name="output_sqs_queue_arn"></a> [sqs\_queue\_arn](#output\_sqs\_queue\_arn) | ARN of the SQS queue |
-| <a name="output_sqs_queue_url"></a> [sqs\_queue\_url](#output\_sqs\_queue\_url) | URL of the SQS queue |
-| <a name="output_ssm_parameter_names"></a> [ssm\_parameter\_names](#output\_ssm\_parameter\_names) | Names of the created SSM parameters |
+| <a name="output_url"></a> [url](#output\_url) | Lambda function URL (if enabled) |
+| <a name="output_version"></a> [version](#output\_version) | Published version of the Lambda function |
 <!-- END_TF_DOCS -->