@cdklabs/cdk-appmod-catalog-blueprints 1.0.1 → 1.2.0

package/.jsii

@@ -4114,7 +4114,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git",
-  "jsiiVersion": "5.9.5 (build ac5f858)",
+  "jsiiVersion": "5.9.7 (build 1693b5a)",
   "keywords": [
     "cdk"
   ],
@@ -4129,7 +4129,7 @@
   },
   "name": "@cdklabs/cdk-appmod-catalog-blueprints",
   "readme": {
-    "markdown": "# AppMod Use Case Blueprints\n\nServerless infrastructure components for modern application development. This catalog provides composable building blocks organized by business use cases, enabling rapid deployment of secure, scalable solutions.\n\n## Quick Start\n\n**Deploy a working example in 5 minutes:**\n\nClone the repository, build the project, then navigate to any example directory and deploy using CDK with your AWS profile and region.\n\n## Core Use Cases\n\n### 1. 📄 Document Processing\n\nServerless document processing pipeline with AI-powered classification, extraction, and workflow orchestration.\n\n**Architecture:**\n```\nS3 Upload → SQS → Step Functions → Bedrock Models → DynamoDB\n    ↓         ↓         ↓              ↓            ↓\n[Storage] [Buffer] [Workflow]    [AI Processing] [Results]\n```\n\n**Key Features:**\n- **Event-Driven Pipeline**: S3 upload triggers SQS → Step Functions workflow\n- **AI-Powered Processing**: Amazon Bedrock for document classification and extraction\n- **Multi-format Support**: PDF, JPG, PNG document processing\n- **Flexible Workflows**: Base construct with extensible processing steps\n- **State Management**: DynamoDB for workflow state and document metadata\n- **Error Handling**: Dead letter queues and retry mechanisms with observability\n\n**Available Constructs:**\n\n**BaseDocumentProcessing** - Foundation construct providing:\n- S3 bucket with organized prefixes (raw/, processed/, failed/)\n- SQS queue with configurable visibility timeout and DLQ\n- DynamoDB table for document metadata and workflow state\n- Step Functions workflow with customizable processing steps\n- Built-in observability and monitoring\n\n**BedrockDocumentProcessing** - AI-powered document analysis:\n- Document classification using Claude 3.5 Sonnet\n- Entity extraction and content analysis\n- Configurable prompts for classification and extraction\n- Optional enrichment Lambda function integration\n- Automatic workflow state management\n\n**AgenticDocumentProcessing** - Multi-agent document workflows:\n- Advanced multi-step processing with agent coordination\n- Complex document understanding and analysis\n- Configurable agent behaviors and processing flows\n\n### 2. 🌐 Frontend Web Applications\n\nStatic web application hosting with CloudFront distribution and security best practices.\n\n**Architecture:**\n```\nCloudFront → S3 Static Website → Security Headers\n     ↓            ↓                    ↓\n[Global CDN] [Static Assets]    [Security Functions]\n```\n\n**Key Features:**\n- **Global Distribution**: CloudFront CDN for low-latency content delivery\n- **Security Headers**: Automatic injection of security headers via CloudFront functions\n- **SSL/TLS**: Automatic HTTPS with AWS Certificate Manager\n- **Custom Domains**: Support for custom domain names with Route 53 integration\n- **Error Pages**: Custom 404/403 error page handling\n- **Access Logging**: CloudFront access logs for analytics\n\n**Available Constructs:**\n\n**FrontendConstruct** - Complete static website hosting:\n- S3 bucket configured for static website hosting\n- CloudFront distribution with optimized caching\n- Security headers function for OWASP compliance\n- Optional custom domain and SSL certificate\n- Access logging and monitoring integration\n\n### 3. 📊 Observability & Monitoring\n\nComprehensive monitoring, logging, and alerting for AWS infrastructure with automatic property injection and Lambda Powertools integration.\n\n**Features:**\n- **Property Injection**: Automatic observability configuration across AWS services\n- **Lambda Powertools**: Structured logging, metrics, and tracing for Python/Node.js\n- **CloudWatch Integration**: Dashboards, alarms, and custom metrics\n- **X-Ray Tracing**: End-to-end request flow visualization\n- **Bedrock Monitoring**: Specialized observability for Amazon Bedrock workloads\n- **Cost Optimization**: Intelligent log retention and metric filtering\n\n**Available Components:**\n\n**Property Injectors:**\n- `LambdaObservabilityPropertyInjector` - Auto-enables X-Ray tracing for Lambda functions\n- `StateMachineObservabilityPropertyInjector` - Enables logging for Step Functions\n- `CloudfrontDistributionObservabilityPropertyInjector` - CDN monitoring and logging\n\n**Observability Constructs:**\n- `BedrockObservability` - Comprehensive monitoring for Bedrock workloads with log groups, encryption, and data protection\n- `PowertoolsConfig` - Lambda Powertools configuration for structured logging and metrics\n- `Observable` interface - Standardized observability contract for constructs\n\n**Data Protection:**\n- `LogGroupDataProtectionProps` - Configurable data protection policies for CloudWatch logs\n\n### 4. 🏗️ Foundation & Framework\n\nCore infrastructure components and utilities for building scalable applications.\n\n**Available Components:**\n\n**Network Foundation:**\n- `Network` - VPC with public/private subnets, NAT gateways, and security groups\n- `AccessLog` - Centralized access logging configuration for AWS services\n- `EventBridgeBroker` - Event-driven architecture with custom EventBridge bus\n\n**Utilities:**\n- `DataLoader` - Custom resource for loading initial data into databases and services\n- `LambdaIamUtils` - Utility functions for Lambda IAM role and policy management\n- `DefaultRuntimes` - Standardized Lambda runtime configurations\n\n**Lambda Layers:**\n- `DataMasking` - Layer for data masking and PII protection in Lambda functions\n\n## Essential Commands\n\n**Build & Deploy:**\n\nBuild entire project with npx projen build. Deploy with specific profile/region using npx cdk deploy --require-approval never. Update CDK CLI if needed with npm install aws-cdk@latest.\n\n**Development:**\n\nRun tests with npm test. Run specific test pattern with npm test -- --testPathPattern=\"document-processing\". Generate CDK Nag compliance reports with npm test -- --testPathPattern=\"nag.test.ts\".\n\n## Repository Structure\n\n```\nappmod-usecase-blueprints/\n├── use-cases/\n│   ├── document-processing/     # Document processing components\n│   │   ├── base-document-processing.ts\n│   │   ├── bedrock-document-processing.ts\n│   │   ├── agentic-document-processing.ts\n│   │   ├── resources/          # Lambda functions\n│   │   └── tests/              # Unit and CDK Nag tests\n│   ├── webapp/                 # Web application components\n│   │   ├── frontend-construct.ts\n│   │   └── tests/              # Unit and CDK Nag tests\n│   ├── framework/              # Core infrastructure\n│   │   ├── foundation/         # Network, access logs, EventBridge\n│   │   ├── quickstart/         # Base quickstart patterns\n│   │   └── custom-resource/    # Default runtimes\n│   └── utilities/\n│       ├── observability/      # Monitoring components\n│       ├── lambda_layers/      # Shared Lambda layers\n│       ├── data-loader.ts      # Custom resource for data loading\n│       └── lambda-iam-utils.ts # IAM utilities\n├── examples/                   # Ready-to-deploy examples\n│   └── document-processing/\n│       ├── bedrock-document-processing/\n│       ├── agentic-document-processing/\n│       └── doc-processing-fullstack-webapp/\n└── README.md\n```\n\n## Security & Compliance\n\nAll components include:\n- **CDK Nag Integration**: Automated security compliance checking\n- **AWS Well-Architected**: Following best practices for security, reliability, performance\n- **Encryption**: At-rest and in-transit encryption by default\n- **IAM Least Privilege**: Minimal required permissions\n- **VPC Isolation**: Private subnets and security groups\n\n**Generate Compliance Reports:**\n\nRun npm test with testPathPattern=\"nag.test.ts\" to generate reports in cdk.out/*-NagReport.csv\n\n## Examples\n\n### Document Processing\n- **Bedrock Document Processing**: AI-powered document analysis with Claude 3.5 Sonnet\n- **Agentic Document Processing**: Multi-agent document workflows with complex processing\n- **Full-Stack Document Processing Webapp**: Complete document processing application with frontend interface\n\nEach example includes deployment scripts, sample files, and comprehensive documentation.\n\n## Key AWS Services\n\n- **Compute**: Lambda, ECS Fargate, Step Functions\n- **Storage**: S3, DynamoDB\n- **Database**: RDS (MySQL/PostgreSQL)\n- **Networking**: VPC, CloudFront, Application Load Balancer\n- **AI/ML**: Amazon Bedrock, Textract\n- **Monitoring**: CloudWatch, X-Ray\n- **Security**: KMS, Secrets Manager, IAM\n\n## Contributing\n\n1. **Add New Use Case**: Create directory under `use-cases/`\n2. **Follow Structure**: Include constructs, tests, and documentation\n3. **Security First**: All components must pass CDK Nag checks\n4. **Include Monitoring**: Include monitoring, error handling, and cost optimization\n\n## Disclaimer\nThese application solutions are not supported products in their own right, but examples to help our customers use our products from their applications. As our customer, any applications you integrate these examples in should be thoroughly tested, secured, and optimized according to your business's security standards before deploying to production or handling production workloads.\n\n## License\n\nApache License 2.0 - see [LICENSE](./LICENSE) file for details.\n"
+    "markdown": "---\ntitle: Introduction\n---\n\n# AppMod Catalog Blueprints\n\nApplication Modernization (AppMod) Catalog Blueprints is a comprehensive library of production-ready, use case-driven infrastructure blueprints in the form of composable multi-layered building blocks built using [AWS Cloud Development Kit](https://aws.amazon.com/cdk/) (CDK) [L3 constructs](https://docs.aws.amazon.com/cdk/v2/guide/constructs.html). These blueprints offer use case-driven solutions with multiple implementation pathways and industry-specific implementations that are designed to accelerate serverless development and modernization on AWS.\n\nBuilt with [JSII](https://aws.github.io/jsii/), these constructs are available in TypeScript, Python, Java, and .NET, enabling teams to use their preferred programming language while leveraging the same proven infrastructure patterns.\n\nGet started by exploring the [use case constructs](use-cases) and deployable [examples](examples). Learn more from [documentation](https://cdklabs.github.io/cdk-appmod-catalog-blueprints/) and [Construct Hub](https://constructs.dev/packages/@cdklabs/cdk-appmod-catalog-blueprints).\n\n## Core Use Cases\n\n| Use Case | Description | Quick Deploy Examples |\n|----------|-------------|----------------------|\n| **[Document Processing](./use-cases/document-processing/)** | AI-powered document processing workflows with classification, extraction, and agentic capabilities | • [Bedrock Document Processing](./examples/document-processing/bedrock-document-processing/)<br/>• [Agentic Document Processing](./examples/document-processing/agentic-document-processing/)<br/>• [Full-Stack Insurance Claims Processing Web Application](./examples/document-processing/doc-processing-fullstack-webapp/) |\n| **[Web Application](./use-cases/webapp/)** | Static web application hosting with global CDN, security headers, and SPA support | • [Full-Stack Insurance Claims Processing Web Application](./examples/document-processing/doc-processing-fullstack-webapp/) |\n\n## Foundation and Utilities\n\n| Component | Description |\n|-----------|-------------|\n| **[Observability & Monitoring](./use-cases/utilities/observability/)** | Comprehensive monitoring, logging, and alerting with automatic property injection and Lambda Powertools integration |\n| **[Data Masking](./use-cases/utilities/lambda_layers/data-masking/)** | Lambda layer for data masking and PII protection in serverless applications |\n| **[Infrastructure Foundation](./use-cases/framework/)** | Core infrastructure components and utilities for building scalable applications |\n\n## Key Design Principles\n\nAppMod Catalog Blueprints is built on Object-Oriented Programming (OOP) principles, providing a structured approach to infrastructure development through core design concepts:\n\n### Composable Architecture\n\nBuild complex enterprise systems by combining independent, reusable components with standardized interfaces.\n\n- **Independent components** with clear interfaces and loose coupling for maximum flexibility\n- **Mix and match building blocks** to create custom solutions across different contexts and use cases\n- **Scalable composition** that maintains consistency while enabling incremental adoption and gradual modernization\n\n### Multi-Layered Building Blocks Architecture\n\nOur blueprints use a multi-layered architecture that bridges the gap between business requirements and technical implementation:\n\n| Layer | Implementation Type | Purpose | Key Features |\n|-------|-------------------|---------|--------------|\n| **Infrastructure Foundation** | Abstract base classes | Shared infrastructure components and common services | • Standardized interfaces and contracts<br/>• Extensible foundation for custom implementations |\n| **General Use Case Implementation** | Concrete implementation classes | Production-ready implementations for common patterns across industries | • Configurable parameters for different environments<br/>• Abstract method implementations with general-purpose solutions |\n| **Industry-Aligned Implementation** | Configured implementation examples | Pre-configured solutions for specific business domains | • Industry-specific validation rules and workflows<br/>• Built-in compliance requirements and domain expertise |\n\n### Production-Ready with Smart Defaults\n\nAppMod Catalog Blueprints serves both **rapid deployment** needs (for teams wanting immediate solutions) and **custom development** requirements (for teams needing tailored implementations), providing flexibility without compromising on production readiness.\n\n| Approach | Best For | Capabilities |\n|----------|----------|--------------|\n| **Out-of-the-Box Deployment** | Rapid deployment and evaluation | • Deploy complete solutions in minutes using examples for immediate value<br/>• Pre-configured security, monitoring, and best practices for production readiness<br/>• Sensible defaults with production-ready configurations that work immediately<br/>• No infrastructure boilerplate required with minimal learning curve |\n| **Intelligent Customization** | Custom development and integration | • Override defaults to modify behavior without changing core implementation<br/>• Enable/disable optional features to meet specific requirements<br/>• Inject custom logic at predefined extension points while maintaining production readiness<br/>• Configure parameters for different environments and use cases |\n\n### Security & Compliance\n\nAll components include enterprise-grade security by default:\n- **CDK Nag Integration**: Automated security compliance checking\n- **AWS Well-Architected**: Security, reliability, and performance best practices\n- **Encryption & IAM**: At-rest/in-transit encryption with least-privilege access\n- **Compliance Reports**: Generate reports with `npm test -- --testPathPattern=\"nag.test.ts\"`\n\n## Essential Commands\n\n### Environment Setup\n```bash\n# Clone the repository\ngit clone https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git\n\n# Configure AWS credentials and region\naws configure\n# OR set AWS profile: export AWS_PROFILE=your-profile-name\n\n# Bootstrap your AWS environment (one-time setup)\nnpx cdk bootstrap\n```\n\n### Quick Start\n\nDeploy a working example in **5 minutes**:\n\n```bash\n# Navigate to any example and deploy\ncd examples/document-processing/agentic-document-processing\nnpm install\nnpm run deploy\n```\n\n### Build & Deploy Project\n```bash\n# Build entire project\nnpx projen build\n\n# Deploy with specific profile/region\nnpx cdk deploy --require-approval never\n\n# Update CDK CLI if needed\nnpm install aws-cdk@latest\n```\n\n### Development\n```bash\n# Run all tests\nnpm test\n\n# Run specific test pattern\nnpm test -- --testPathPattern=\"document-processing\"\n\n# Generate CDK Nag compliance reports\nnpm test -- --testPathPattern=\"nag.test.ts\"\n```\n\n## How to Use This Library\n\n### Quick Start (Deploy Examples)\n1. **Browse Examples**: Start with the [examples](./examples/) folder to see working implementations\n2. **Deploy & Test**: Use `npm run deploy` in any example to get a working system in minutes\n3. **Customize**: Modify example parameters to fit your specific requirements\n\n### Using Individual Constructs\n1. **Import Constructs**: Add `@cdklabs/appmod-catalog-blueprints` to your CDK project\n2. **Choose Your Layer**: Pick the right abstraction level for your needs\n3. **Configure**: Use the configuration options documented in each construct\n\n### Understanding the Layers\n\n**Foundation Layer** (`use-cases/framework/`, `use-cases/utilities/`)\n- **When to use**: Building custom solutions or need specific infrastructure components\n- **Components**: VPC networking, observability utilities, data management tools, etc.\n\n**Use Case Layer** (`use-cases/document-processing/`, `use-cases/webapp/`)\n- **When to use**: Need proven patterns for common business problems\n- **Components**: Document processing workflows, web application hosting, data transformation patterns, etc.\n\n**Example Layer** (`examples/`)\n- **When to use**: Want complete, deployable solutions\n- **Components**: Industry-specific configurations, end-to-end applications, reference implementations, etc.\n\n## Contributing\n\nSee [CONTRIBUTING.md](https://github.com/cdklabs/cdk-appmod-catalog-blueprints/blob/main/CONTRIBUTING.md) for detailed guidelines on how to contribute to this project.\n\n## Disclaimer\nThese application solutions are not supported products in their own right, but examples to help our customers use our products from their applications. As our customer, any applications you integrate these examples in should be thoroughly tested, secured, and optimized according to your business's security standards before deploying to production or handling production workloads.\n\n## License\n\nApache License 2.0 - see [LICENSE](https://github.com/cdklabs/cdk-appmod-catalog-blueprints/blob/main/LICENSE) file for details.\n"
   },
   "repository": {
     "type": "git",
@@ -4527,12 +4527,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "System prompt for the agent."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/agentic-document-processing.ts",
-            "line": 14
+            "line": 27
           },
           "name": "agentSystemPrompt",
           "optional": true,
@@ -4543,12 +4544,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "If there are python dependencies that are needed by the provided tools, provide the Lambda Layers with the dependencies."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/agentic-document-processing.ts",
-            "line": 16
+            "line": 40
           },
           "name": "lambdaLayers",
           "optional": true,
@@ -4564,12 +4566,32 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "default": "No extra IAM permissions would be automatically\nassigned to the processing agent.",
+            "stability": "experimental",
+            "summary": "Bucket where the tools are located in Primarily use to grant read permission to the processing agent to access the tools."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/agentic-document-processing.ts",
-            "line": 15
+            "line": 22
+          },
+          "name": "toolsBucket",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_s3.Bucket"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "The agent would dynamically load the tools",
+            "stability": "experimental",
+            "summary": "S3 path where the tools are located."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/agentic-document-processing.ts",
+            "line": 33
           },
           "name": "toolsLocation",
           "optional": true,
@@ -4598,7 +4620,7 @@
         },
         "locationInModule": {
           "filename": "use-cases/document-processing/agentic-document-processing.ts",
-          "line": 24
+          "line": 48
         },
         "parameters": [
           {
@@ -4627,7 +4649,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/document-processing/agentic-document-processing.ts",
-        "line": 23
+        "line": 47
       },
       "methods": [
         {
@@ -4638,7 +4660,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/agentic-document-processing.ts",
-            "line": 28
+            "line": 52
           },
           "name": "processingStep",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockDocumentProcessing",
@@ -4678,7 +4700,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/document-processing/agentic-document-processing.ts",
-        "line": 19
+        "line": 43
       },
       "name": "AgenticDocumentProcessingProps",
       "properties": [
@@ -4690,7 +4712,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/agentic-document-processing.ts",
-            "line": 20
+            "line": 44
           },
           "name": "processingAgentParameters",
           "optional": true,
@@ -4719,7 +4741,7 @@
         },
         "locationInModule": {
           "filename": "use-cases/document-processing/base-document-processing.ts",
-          "line": 168
+          "line": 130
         },
         "parameters": [
           {
@@ -4758,7 +4780,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/document-processing/base-document-processing.ts",
-        "line": 136
+        "line": 104
       },
       "methods": [
         {
@@ -4771,7 +4793,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 678
+            "line": 475
           },
           "name": "classificationStep",
           "protected": true,
@@ -4803,7 +4825,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 698
+            "line": 495
           },
           "name": "enrichmentStep",
           "protected": true,
@@ -4832,7 +4854,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 278
+            "line": 196
           },
           "name": "handleStateMachineCreation",
           "parameters": [
@@ -4856,26 +4878,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 490
-          },
-          "name": "handleWorkflowTrigger",
-          "parameters": [
-            {
-              "name": "stateMachine",
-              "type": {
-                "fqn": "aws-cdk-lib.aws_stepfunctions.StateMachine"
-              }
-            }
-          ],
-          "protected": true
-        },
-        {
-          "docs": {
-            "stability": "experimental"
-          },
-          "locationInModule": {
-            "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 666
+            "line": 463
           },
           "name": "metrics",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IObservable",
@@ -4900,7 +4903,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 708
+            "line": 505
           },
           "name": "postProcessingStep",
           "protected": true,
@@ -4933,7 +4936,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 688
+            "line": 485
           },
           "name": "processingStep",
           "protected": true,
@@ -4961,61 +4964,46 @@
         {
           "docs": {
             "stability": "experimental",
-            "summary": "S3 bucket for document storage with organized prefixes (raw/, processed/, failed/)."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 144
-          },
-          "name": "bucket",
-          "type": {
-            "fqn": "aws-cdk-lib.aws_s3.Bucket"
-          }
-        },
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "Dead letter queue."
+            "summary": "DynamoDB table for storing document processing metadata and workflow state."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 152
+            "line": 112
           },
-          "name": "deadLetterQueue",
+          "name": "documentProcessingTable",
           "type": {
-            "fqn": "aws-cdk-lib.aws_sqs.Queue"
+            "fqn": "aws-cdk-lib.aws_dynamodb.Table"
           }
         },
         {
           "docs": {
             "stability": "experimental",
-            "summary": "DynamoDB table for storing document processing metadata and workflow state."
+            "summary": "KMS key."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 148
+            "line": 116
           },
-          "name": "documentProcessingTable",
+          "name": "encryptionKey",
           "type": {
-            "fqn": "aws-cdk-lib.aws_dynamodb.Table"
+            "fqn": "aws-cdk-lib.aws_kms.Key"
           }
         },
         {
           "docs": {
             "stability": "experimental",
-            "summary": "KMS key."
+            "summary": "Ingress adapter, responsible for triggering workflow."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 154
+            "line": 118
           },
-          "name": "encryptionKey",
+          "name": "ingressAdapter",
           "type": {
-            "fqn": "aws-cdk-lib.aws_kms.Key"
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter"
           }
         },
         {
@@ -5026,7 +5014,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 142
+            "line": 110
           },
           "name": "logGroupDataProtection",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IObservable",
@@ -5042,7 +5030,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 140
+            "line": 108
           },
           "name": "metricNamespace",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IObservable",
@@ -5059,44 +5047,13 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 138
+            "line": 106
           },
           "name": "metricServiceName",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IObservable",
           "type": {
             "primitive": "string"
           }
-        },
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "SQS queue for reliable message processing with dead letter queue support."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 146
-          },
-          "name": "queue",
-          "type": {
-            "fqn": "aws-cdk-lib.aws_sqs.Queue"
-          }
-        },
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "Encryption key used by the DocumentProcessingBucket."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 156
-          },
-          "name": "bucketEncryptionKey",
-          "optional": true,
-          "type": {
-            "fqn": "aws-cdk-lib.aws_kms.IKey"
-          }
         }
       ],
       "symbolId": "use-cases/document-processing/base-document-processing:BaseDocumentProcessing"
@@ -5115,46 +5072,10 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/document-processing/base-document-processing.ts",
-        "line": 31
+        "line": 26
       },
       "name": "BaseDocumentProcessingProps",
       "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "remarks": "If not provided, a new bucket will be created with auto-delete enabled based on removalPolicy.",
-            "stability": "experimental",
-            "summary": "S3 bucket for document storage with organized prefixes (raw/, processed/, failed/)."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 36
-          },
-          "name": "bucket",
-          "optional": true,
-          "type": {
-            "fqn": "aws-cdk-lib.aws_s3.Bucket"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "5",
-            "stability": "experimental",
-            "summary": "The number of times a message can be unsuccessfully dequeued before being moved to the dead-letter queue."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 54
-          },
-          "name": "dlqMaxReceiveCount",
-          "optional": true,
-          "type": {
-            "primitive": "number"
-          }
-        },
         {
           "abstract": true,
           "docs": {
@@ -5165,7 +5086,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 41
+            "line": 39
           },
           "name": "documentProcessingTable",
           "optional": true,
@@ -5183,7 +5104,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 76
+            "line": 61
           },
           "name": "enableObservability",
           "optional": true,
@@ -5201,7 +5122,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 88
+            "line": 73
           },
           "name": "encryptionKey",
           "optional": true,
@@ -5219,7 +5140,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 70
+            "line": 55
           },
           "name": "eventbridgeBroker",
           "optional": true,
@@ -5230,38 +5151,37 @@
         {
           "abstract": true,
           "docs": {
-            "default": "resources will run outside of a VPC",
+            "default": "QueuedS3Adapter",
             "stability": "experimental",
-            "summary": "Resources that can run inside a VPC will follow the provided network configuration."
+            "summary": "Adapter that defines how the document processing workflow is triggered."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 82
+            "line": 33
           },
-          "name": "network",
+          "name": "ingressAdapter",
           "optional": true,
           "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.Network"
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "Duration.seconds(300)",
-            "remarks": "Should be longer than expected processing time to prevent duplicate processing.",
+            "default": "resources will run outside of a VPC",
             "stability": "experimental",
-            "summary": "SQS queue visibility timeout for processing messages."
+            "summary": "Resources that can run inside a VPC will follow the provided network configuration."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 47
+            "line": 67
           },
-          "name": "queueVisibilityTimeout",
+          "name": "network",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.Duration"
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.Network"
           }
         },
         {
@@ -5274,7 +5194,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 65
+            "line": 50
           },
           "name": "removalPolicy",
           "optional": true,
@@ -5292,7 +5212,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 60
+            "line": 45
           },
           "name": "workflowTimeout",
           "optional": true,
@@ -5432,7 +5352,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 357
+            "line": 346
           },
           "name": "enrichmentStep",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessing",
@@ -5462,7 +5382,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 319
+            "line": 312
           },
           "name": "generateLambdaRoleForBedrock",
           "parameters": [
@@ -5495,7 +5415,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 377
+            "line": 366
           },
           "name": "postProcessingStep",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessing",
@@ -5528,7 +5448,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 261
+            "line": 257
           },
           "name": "processingStep",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessing",
@@ -6433,6 +6353,82 @@
       "name": "DatabaseEngine",
       "symbolId": "use-cases/utilities/data-loader:DatabaseEngine"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.DefaultDocumentProcessingConfig": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.DefaultDocumentProcessingConfig",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/default-document-processing-config.ts",
+        "line": 4
+      },
+      "name": "DefaultDocumentProcessingConfig",
+      "properties": [
+        {
+          "const": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/default-document-processing-config.ts",
+            "line": 5
+          },
+          "name": "DEFAULT_OBSERVABILITY_METRIC_SVC_NAME",
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/default-document-processing-config:DefaultDocumentProcessingConfig"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.DefaultObservabilityConfig": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Contains default constants for Observability related configuration."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.DefaultObservabilityConfig",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "use-cases/utilities/observability/default-observability-config.ts",
+        "line": 7
+      },
+      "name": "DefaultObservabilityConfig",
+      "properties": [
+        {
+          "const": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Default namespace for powertools."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/utilities/observability/default-observability-config.ts",
+            "line": 12
+          },
+          "name": "DEFAULT_METRIC_NAMESPACE",
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "use-cases/utilities/observability/default-observability-config:DefaultObservabilityConfig"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.DefaultRuntimes": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
@@ -6523,45 +6519,6 @@
       ],
       "symbolId": "use-cases/framework/custom-resource/default-runtimes:DefaultRuntimes"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.DocumentProcessingPrefix": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "docs": {
-        "remarks": "Documents flow through these prefixes based on processing outcomes:\n- Upload → raw/ (triggers processing)\n- Success → processed/ (workflow completed successfully)\n- Failure → failed/ (workflow encountered errors)",
-        "stability": "experimental",
-        "summary": "S3 prefix constants for organizing documents throughout the processing lifecycle."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.DocumentProcessingPrefix",
-      "kind": "enum",
-      "locationInModule": {
-        "filename": "use-cases/document-processing/base-document-processing.ts",
-        "line": 99
-      },
-      "members": [
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "Prefix for newly uploaded documents awaiting processing."
-          },
-          "name": "RAW"
-        },
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "Prefix for documents that failed processing."
-          },
-          "name": "FAILED"
-        },
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "Prefix for successfully processed documents."
-          },
-          "name": "PROCESSED"
-        }
-      ],
-      "name": "DocumentProcessingPrefix",
-      "symbolId": "use-cases/document-processing/base-document-processing:DocumentProcessingPrefix"
-    },
     "@cdklabs/cdk-appmod-catalog-blueprints.EventbridgeBroker": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "base": "constructs.Construct",
@@ -7233,16 +7190,227 @@
       ],
       "symbolId": "use-cases/webapp/frontend-construct:FrontendProps"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.IObservable": {
+    "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
         "stability": "experimental",
-        "summary": "Interface providing configuration parameters for constructs that support Observability."
+        "summary": "Abstraction to enable different types of source triggers for the intelligent document processing workflow."
       },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IObservable",
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter",
       "kind": "interface",
       "locationInModule": {
-        "filename": "use-cases/utilities/observability/observable.ts",
+        "filename": "use-cases/document-processing/adapter/adapter.ts",
+        "line": 13
+      },
+      "methods": [
+        {
+          "abstract": true,
+          "docs": {
+            "returns": "Chain to be added to the state machine to handle failure scenarios",
+            "stability": "experimental",
+            "summary": "Create the adapter specific handler for failed processing."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/adapter.ts",
+            "line": 47
+          },
+          "name": "createFailedChain",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "Scope to use in relation to the CDK hierarchy."
+              },
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_stepfunctions.Chain"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Important: resource created should trigger the state machine",
+            "returns": "Resources that are created",
+            "stability": "experimental",
+            "summary": "Create resources that would receive the data and trigger the workflow."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/adapter.ts",
+            "line": 30
+          },
+          "name": "createIngressTrigger",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "Scope to use in relation to the CDK hierarchy."
+              },
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "docs": {
+                "summary": "The workflow of the document processor."
+              },
+              "name": "stateMachine",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_stepfunctions.StateMachine"
+              }
+            },
+            {
+              "docs": {
+                "summary": "The parameters passed to the document processing L3 Construct."
+              },
+              "name": "props",
+              "type": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessingProps"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "primitive": "any"
+                },
+                "kind": "map"
+              }
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "returns": "Chain to be added to the state machine to handle successful scenarios",
+            "stability": "experimental",
+            "summary": "Create the adapter specific handler for successful processing."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/adapter.ts",
+            "line": 54
+          },
+          "name": "createSuccessChain",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "Scope to use in relation to the CDK hierarchy."
+              },
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_stepfunctions.Chain"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "returns": "PolicyStatement[] IAM policy statements that would included in the state machine IAM role",
+            "stability": "experimental",
+            "summary": "Generate IAM statements that can be used by other resources to access the storage."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/adapter.ts",
+            "line": 40
+          },
+          "name": "generateAdapterIAMPolicies",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "(Optional) list of additional actions in relation to the underlying storage for the adapter."
+              },
+              "name": "additionalIAMActions",
+              "optional": true,
+              "type": {
+                "collection": {
+                  "elementtype": {
+                    "primitive": "string"
+                  },
+                  "kind": "array"
+                }
+              }
+            },
+            {
+              "docs": {
+                "summary": "(Optional) whether the resulting permissions would only be the IAM actions indicated in the `additionalIAMActions` parameter."
+              },
+              "name": "narrowActions",
+              "optional": true,
+              "type": {
+                "primitive": "boolean"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
+                },
+                "kind": "array"
+              }
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Initializes the adapter."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/adapter.ts",
+            "line": 19
+          },
+          "name": "init",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "Scope to use in relation to the CDK hierarchy."
+              },
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "docs": {
+                "summary": "The parameters passed to the document processing L3 Construct."
+              },
+              "name": "props",
+              "type": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessingProps"
+              }
+            }
+          ]
+        }
+      ],
+      "name": "IAdapter",
+      "symbolId": "use-cases/document-processing/adapter/adapter:IAdapter"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.IObservable": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Interface providing configuration parameters for constructs that support Observability."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IObservable",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/utilities/observability/observable.ts",
         "line": 33
       },
       "methods": [
@@ -8615,6 +8783,335 @@
       "name": "PowertoolsConfig",
       "symbolId": "use-cases/utilities/observability/powertools-config:PowertoolsConfig"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.QueuedS3Adapter": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "docs": {
+        "stability": "experimental",
+        "summary": "This adapter allows the intelligent document processing workflow to be triggered by files that are uploaded into a S3 Bucket."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.QueuedS3Adapter",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+          "line": 91
+        },
+        "parameters": [
+          {
+            "name": "adapterProps",
+            "optional": true,
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.QueuedS3AdapterProps"
+            }
+          }
+        ]
+      },
+      "interfaces": [
+        "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter"
+      ],
+      "kind": "class",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+        "line": 86
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Create the adapter specific handler for failed processing."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+            "line": 272
+          },
+          "name": "createFailedChain",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_stepfunctions.Chain"
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "Important: resource created should trigger the state machine",
+            "stability": "experimental",
+            "summary": "Create resources that would receive the data and trigger the workflow."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+            "line": 148
+          },
+          "name": "createIngressTrigger",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "stateMachine",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_stepfunctions.StateMachine"
+              }
+            },
+            {
+              "name": "props",
+              "type": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessingProps"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "primitive": "any"
+                },
+                "kind": "map"
+              }
+            }
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Create the adapter specific handler for successful processing."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+            "line": 301
+          },
+          "name": "createSuccessChain",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_stepfunctions.Chain"
+            }
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Generate IAM statements that can be used by other resources to access the storage."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+            "line": 235
+          },
+          "name": "generateAdapterIAMPolicies",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter",
+          "parameters": [
+            {
+              "name": "additionalIAMActions",
+              "optional": true,
+              "type": {
+                "collection": {
+                  "elementtype": {
+                    "primitive": "string"
+                  },
+                  "kind": "array"
+                }
+              }
+            },
+            {
+              "name": "narrowActions",
+              "optional": true,
+              "type": {
+                "primitive": "boolean"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
+                },
+                "kind": "array"
+              }
+            }
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Initializes the adapter."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+            "line": 101
+          },
+          "name": "init",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "props",
+              "type": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessingProps"
+              }
+            }
+          ]
+        }
+      ],
+      "name": "QueuedS3Adapter",
+      "symbolId": "use-cases/document-processing/adapter/queued-s3-adapter:QueuedS3Adapter"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.QueuedS3AdapterProps": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Props for the Queued S3 Adapter."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.QueuedS3AdapterProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+        "line": 36
+      },
+      "name": "QueuedS3AdapterProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "create a new bucket",
+            "remarks": "If not provided, a new bucket will be created with auto-delete enabled based on removalPolicy.",
+            "stability": "experimental",
+            "summary": "S3 bucket for document storage with organized prefixes (raw/, processed/, failed/)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+            "line": 43
+          },
+          "name": "bucket",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_s3.Bucket"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "5",
+            "stability": "experimental",
+            "summary": "The number of times a message can be unsuccessfully dequeued before being moved to the dead-letter queue."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+            "line": 79
+          },
+          "name": "dlqMaxReceiveCount",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"failed/\"",
+            "stability": "experimental",
+            "summary": "S3 prefix where the files that failed processing would be stored."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+            "line": 65
+          },
+          "name": "failedPrefix",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"processed/\"",
+            "stability": "experimental",
+            "summary": "S3 prefix where the processed files would be stored."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+            "line": 58
+          },
+          "name": "processedPrefix",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "Duration.seconds(300)",
+            "remarks": "Should be longer than expected processing time to prevent duplicate processing.",
+            "stability": "experimental",
+            "summary": "SQS queue visibility timeout for processing messages."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+            "line": 72
+          },
+          "name": "queueVisibilityTimeout",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.Duration"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "\"raw/\"",
+            "remarks": "This serves as the trigger point for processing",
+            "stability": "experimental",
+            "summary": "S3 prefix where the raw files would be stored."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
+            "line": 51
+          },
+          "name": "rawPrefix",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/adapter/queued-s3-adapter:QueuedS3AdapterProps"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.StateMachineObservabilityPropertyInjector": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
@@ -8715,6 +9212,6 @@
       "symbolId": "use-cases/utilities/observability/state-machine-observability-property-injector:StateMachineObservabilityPropertyInjector"
     }
   },
-  "version": "1.0.1",
-  "fingerprint": "gXFtKyl0Tf6rX3hEsuw2mZnPF0GYkbN0hz/AfG7iAWw="
+  "version": "1.2.0",
+  "fingerprint": "bxix0WuQUtBQp/AQiQ5+a39FblaGHjk5JKX+dLuOZU0="
 }