appmod-catalog-blueprints 1.2.2__tar.gz → 1.4.0__tar.gz

{appmod_catalog_blueprints-1.2.2/src/appmod_catalog_blueprints.egg-info → appmod_catalog_blueprints-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: appmod-catalog-blueprints
-Version: 1.2.2
+Version: 1.4.0
 Summary: Serverless infrastructure components organized by business use cases
 Home-page: https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git
 Author: Amazon Web Services<aws-cdk-dev@amazon.com>
@@ -22,86 +22,58 @@ License-File: LICENSE
 Requires-Dist: aws-cdk-lib<3.0.0,>=2.218.0
 Requires-Dist: aws-cdk.aws-lambda-python-alpha<3.0.0,>=2.218.0.a0
 Requires-Dist: constructs<11.0.0,>=10.0.5
-Requires-Dist: jsii<2.0.0,>=1.115.0
+Requires-Dist: jsii<2.0.0,>=1.118.0
 Requires-Dist: publication>=0.0.3
 Requires-Dist: typeguard<4.3.0,>=2.13.3
 
----
+# AppMod Catalog Blueprints
 
+[![Code](https://img.shields.io/badge/code-GitHub-green)](https://github.com/cdklabs/cdk-appmod-catalog-blueprints)
+[![Website](https://img.shields.io/badge/website-cdklabs.github.io-blue)](https://cdklabs.github.io/cdk-appmod-catalog-blueprints/)
+[![Package](https://img.shields.io/badge/package-construct--hub-orange)](https://constructs.dev/packages/@cdklabs/cdk-appmod-catalog-blueprints/)
 
-## title: Introduction
+Application Modernization (AppMod) Catalog Blueprints is a comprehensive library of use case-driven infrastructure solution blueprints built using AWS well-architected best practices. Designed as composable multi-layered building blocks 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 to accelerate serverless development and modernization on AWS.
 
-# AppMod Catalog Blueprints
+**Key Benefits:**
 
-Application 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.
+* **Use case-driven solutions**: Purpose-built blueprints for common business scenarios like document processing, web applications, and AI workflows, with industry-specific implementations like insurance claims processing
+* **Multi-layered approach**: Infrastructure Foundation → General Use Cases → Industry Examples, allowing you to start with proven patterns and customize as needed.
+* **Composable architecture**: Mix and match independent components with standardized interfaces
+* **Enterprise-ready**: Built-in security, compliance, and AWS Well-Architected best practices
+* **Multi-language support**: Available in TypeScript, Python, Java, and .NET via [JSII](https://aws.github.io/jsii/)
 
-Built 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.
+## How to Use This Library
 
 Get 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).
 
-## Core Use Cases
+| Approach | Best For | Get Started |
+|----------|----------|-------------|
+| **🚀 Rapid Deployment** | Quick evaluation, immediate solutions, proof-of-concepts | Use [examples](./examples/) - deploy complete solutions in minutes with sensible defaults and AWS Well-Architected best practices |
+| **🔧 Custom Development** | Specific requirements, enterprise integration, tailored solutions | Use [individual constructs](./use-cases/) - override defaults, inject custom logic, configure for your environment |
+
+## Use Case Building Blocks
+
+### Core Use Cases
 
 | Use Case | Description | Quick Deploy Examples |
 |----------|-------------|----------------------|
-| **[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/) |
+| **[Document Processing](./use-cases/document-processing/)** | Intelligent 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/) |
 | **[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/) |
 
-## Foundation and Utilities
+### Foundation and Utilities
 
 | Component | Description |
 |-----------|-------------|
-| **[Observability & Monitoring](./use-cases/utilities/observability/)** | Comprehensive monitoring, logging, and alerting with automatic property injection and Lambda Powertools integration |
-| **[Data Masking](./use-cases/utilities/lambda_layers/data-masking/)** | Lambda layer for data masking and PII protection in serverless applications |
-| **[Infrastructure Foundation](./use-cases/framework/)** | Core infrastructure components and utilities for building scalable applications |
-
-## Key Design Principles
-
-AppMod Catalog Blueprints is built on Object-Oriented Programming (OOP) principles, providing a structured approach to infrastructure development through core design concepts:
-
-### Composable Architecture
-
-Build complex enterprise systems by combining independent, reusable components with standardized interfaces.
-
-* **Independent components** with clear interfaces and loose coupling for maximum flexibility
-* **Mix and match building blocks** to create custom solutions across different contexts and use cases
-* **Scalable composition** that maintains consistency while enabling incremental adoption and gradual modernization
-
-### Multi-Layered Building Blocks Architecture
+| **[Agentic AI Framework](./use-cases/framework/agents/)** | Composable enterprise framework for building intelligent AI agents that can be mixed and matched across diverse use cases - from document processing to conversational AI |
+| **[Infrastructure Foundation](./use-cases/framework/foundation/)** | Core infrastructure components including VPC networking, access logging, and EventBridge integration |
+| **[Observability & Monitoring](./use-cases/utilities/#observability)** | Comprehensive monitoring, logging, and alerting with automatic property injection and Lambda Powertools integration |
+| **[Data Masking](./use-cases/utilities/#data-masking)** | Lambda layer for data masking and PII protection in serverless applications |
 
-Our blueprints use a multi-layered architecture that bridges the gap between business requirements and technical implementation:
-
-| Layer | Implementation Type | Purpose | Key Features |
-|-------|-------------------|---------|--------------|
-| **Infrastructure Foundation** | Abstract base classes | Shared infrastructure components and common services | • Standardized interfaces and contracts<br/>• Extensible foundation for custom implementations |
-| **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 |
-| **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 |
-
-### Production-Ready with Smart Defaults
-
-AppMod 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.
-
-| Approach | Best For | Capabilities |
-|----------|----------|--------------|
-| **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 |
-| **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 |
-
-### Security & Compliance
-
-All components include enterprise-grade security by default:
-
-* **CDK Nag Integration**: Automated security compliance checking
-* **AWS Well-Architected**: Security, reliability, and performance best practices
-* **Encryption & IAM**: At-rest/in-transit encryption with least-privilege access
-* **Compliance Reports**: Generate reports with `npm test -- --testPathPattern="nag.test.ts"`
-
-## Essential Commands
+## Getting Started
 
 ### Environment Setup
 
 ```bash
-# Clone the repository
-git clone https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git
-
 # Configure AWS credentials and region
 aws configure
 # OR set AWS profile: export AWS_PROFILE=your-profile-name
@@ -110,73 +82,74 @@ aws configure
 npx cdk bootstrap
 ```
 
-### Quick Start
+### Quick Deploy (Complete Solutions)
 
-Deploy a working example in **5 minutes**:
+Deploy working examples in minutes for immediate value:
 
 ```bash
-# Navigate to any example and deploy
-cd examples/document-processing/agentic-document-processing
-npm install
-npm run deploy
-```
-
-### Build & Deploy Project
-
-```bash
-# Build entire project
-npx projen build
+# Clone the repository
+git clone https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git
 
-# Deploy with specific profile/region
-npx cdk deploy --require-approval never
+# Deploy complete insurance claims processing solution
+cd examples/document-processing/doc-processing-fullstack-webapp
+npm install && npm run deploy
+# Full AI-powered solution with web interface deployed
 
-# Update CDK CLI if needed
-npm install aws-cdk@latest
+# Or deploy basic document processing
+cd examples/document-processing/bedrock-document-processing
+npm install && npm run deploy
 ```
 
-### Development
-
-```bash
-# Run all tests
-npm test
+### Using Individual Constructs
 
-# Run specific test pattern
-npm test -- --testPathPattern="document-processing"
+Add to your existing CDK projects for custom solutions:
 
-# Generate CDK Nag compliance reports
-npm test -- --testPathPattern="nag.test.ts"
+```bash
+# Install the library
+npm install @cdklabs/appmod-catalog-blueprints
+
+# Use in your CDK code
+import { AgenticDocumentProcessing, WebApp } from '@cdklabs/appmod-catalog-blueprints';
+
+const docProcessor = new AgenticDocumentProcessing(this, 'Processor', {
+  agentDefinition: {
+    bedrockModel: { useCrossRegionInference: true },
+    systemPrompt: myPrompt,
+    tools: [myTools]
+  }
+});
 ```
 
-## How to Use This Library
-
-### Quick Start (Deploy Examples)
+## Key Design Principles
 
-1. **Browse Examples**: Start with the [examples](./examples/) folder to see working implementations
-2. **Deploy & Test**: Use `npm run deploy` in any example to get a working system in minutes
-3. **Customize**: Modify example parameters to fit your specific requirements
+AppMod Catalog Blueprints is built on Object-Oriented Programming (OOP) principles, providing a structured approach to infrastructure development through core design concepts:
 
-### Using Individual Constructs
+### Composable Architecture
 
-1. **Import Constructs**: Add `@cdklabs/appmod-catalog-blueprints` to your CDK project
-2. **Choose Your Layer**: Pick the right abstraction level for your needs
-3. **Configure**: Use the configuration options documented in each construct
+Build complex enterprise systems by combining independent, reusable components with standardized interfaces.
 
-### Understanding the Layers
+* **Independent components** with clear interfaces and loose coupling for maximum flexibility
+* **Mix and match building blocks** to create custom solutions across different contexts and use cases
+* **Scalable composition** that maintains consistency while enabling incremental adoption and gradual modernization
 
-**Foundation Layer** (`use-cases/framework/`, `use-cases/utilities/`)
+### Multi-Layered Building Blocks Architecture
 
-* **When to use**: Building custom solutions or need specific infrastructure components
-* **Components**: VPC networking, observability utilities, data management tools, etc.
+Our blueprints use a multi-layered architecture that bridges the gap between business requirements and technical implementation:
 
-**Use Case Layer** (`use-cases/document-processing/`, `use-cases/webapp/`)
+| Layer | Implementation Type | Purpose | Key Features |
+|-------|-------------------|---------|--------------|
+| **Infrastructure Foundation** | Abstract base classes | Shared infrastructure components and common services | • Standardized interfaces and contracts<br/>• Extensible foundation for custom implementations |
+| **General Use Case Implementation** | Concrete implementation classes | Implementations for common patterns across industries | • Configurable parameters for different environments<br/>• Abstract method implementations with general-purpose solutions |
+| **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 |
 
-* **When to use**: Need proven patterns for common business problems
-* **Components**: Document processing workflows, web application hosting, data transformation patterns, etc.
+### Security & Compliance
 
-**Example Layer** (`examples/`)
+All components include enterprise-grade security by default:
 
-* **When to use**: Want complete, deployable solutions
-* **Components**: Industry-specific configurations, end-to-end applications, reference implementations, etc.
+* **CDK Nag Integration**: Automated security compliance checking
+* **AWS Well-Architected**: Security, reliability, and performance best practices
+* **Encryption & IAM**: At-rest/in-transit encryption with least-privilege access
+* **Compliance Reports**: Generate reports with `npm test -- --testPathPattern="nag.test.ts"`
 
 ## Contributing
 

appmod_catalog_blueprints-1.4.0/README.md

@@ -0,0 +1,136 @@
+# AppMod Catalog Blueprints
+
+[![Code](https://img.shields.io/badge/code-GitHub-green)](https://github.com/cdklabs/cdk-appmod-catalog-blueprints)
+[![Website](https://img.shields.io/badge/website-cdklabs.github.io-blue)](https://cdklabs.github.io/cdk-appmod-catalog-blueprints/)
+[![Package](https://img.shields.io/badge/package-construct--hub-orange)](https://constructs.dev/packages/@cdklabs/cdk-appmod-catalog-blueprints/)
+
+Application Modernization (AppMod) Catalog Blueprints is a comprehensive library of use case-driven infrastructure solution blueprints built using AWS well-architected best practices. Designed as composable multi-layered building blocks 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 to accelerate serverless development and modernization on AWS.
+
+**Key Benefits:**
+
+* **Use case-driven solutions**: Purpose-built blueprints for common business scenarios like document processing, web applications, and AI workflows, with industry-specific implementations like insurance claims processing
+* **Multi-layered approach**: Infrastructure Foundation → General Use Cases → Industry Examples, allowing you to start with proven patterns and customize as needed.
+* **Composable architecture**: Mix and match independent components with standardized interfaces
+* **Enterprise-ready**: Built-in security, compliance, and AWS Well-Architected best practices
+* **Multi-language support**: Available in TypeScript, Python, Java, and .NET via [JSII](https://aws.github.io/jsii/)
+
+## How to Use This Library
+
+Get 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).
+
+| Approach | Best For | Get Started |
+|----------|----------|-------------|
+| **🚀 Rapid Deployment** | Quick evaluation, immediate solutions, proof-of-concepts | Use [examples](./examples/) - deploy complete solutions in minutes with sensible defaults and AWS Well-Architected best practices |
+| **🔧 Custom Development** | Specific requirements, enterprise integration, tailored solutions | Use [individual constructs](./use-cases/) - override defaults, inject custom logic, configure for your environment |
+
+## Use Case Building Blocks
+
+### Core Use Cases
+
+| Use Case | Description | Quick Deploy Examples |
+|----------|-------------|----------------------|
+| **[Document Processing](./use-cases/document-processing/)** | Intelligent 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/) |
+| **[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/) |
+
+### Foundation and Utilities
+
+| Component | Description |
+|-----------|-------------|
+| **[Agentic AI Framework](./use-cases/framework/agents/)** | Composable enterprise framework for building intelligent AI agents that can be mixed and matched across diverse use cases - from document processing to conversational AI |
+| **[Infrastructure Foundation](./use-cases/framework/foundation/)** | Core infrastructure components including VPC networking, access logging, and EventBridge integration |
+| **[Observability & Monitoring](./use-cases/utilities/#observability)** | Comprehensive monitoring, logging, and alerting with automatic property injection and Lambda Powertools integration |
+| **[Data Masking](./use-cases/utilities/#data-masking)** | Lambda layer for data masking and PII protection in serverless applications |
+
+## Getting Started
+
+### Environment Setup
+
+```bash
+# Configure AWS credentials and region
+aws configure
+# OR set AWS profile: export AWS_PROFILE=your-profile-name
+
+# Bootstrap your AWS environment (one-time setup)
+npx cdk bootstrap
+```
+
+### Quick Deploy (Complete Solutions)
+
+Deploy working examples in minutes for immediate value:
+
+```bash
+# Clone the repository
+git clone https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git
+
+# Deploy complete insurance claims processing solution
+cd examples/document-processing/doc-processing-fullstack-webapp
+npm install && npm run deploy
+# Full AI-powered solution with web interface deployed
+
+# Or deploy basic document processing
+cd examples/document-processing/bedrock-document-processing
+npm install && npm run deploy
+```
+
+### Using Individual Constructs
+
+Add to your existing CDK projects for custom solutions:
+
+```bash
+# Install the library
+npm install @cdklabs/appmod-catalog-blueprints
+
+# Use in your CDK code
+import { AgenticDocumentProcessing, WebApp } from '@cdklabs/appmod-catalog-blueprints';
+
+const docProcessor = new AgenticDocumentProcessing(this, 'Processor', {
+  agentDefinition: {
+    bedrockModel: { useCrossRegionInference: true },
+    systemPrompt: myPrompt,
+    tools: [myTools]
+  }
+});
+```
+
+## Key Design Principles
+
+AppMod Catalog Blueprints is built on Object-Oriented Programming (OOP) principles, providing a structured approach to infrastructure development through core design concepts:
+
+### Composable Architecture
+
+Build complex enterprise systems by combining independent, reusable components with standardized interfaces.
+
+* **Independent components** with clear interfaces and loose coupling for maximum flexibility
+* **Mix and match building blocks** to create custom solutions across different contexts and use cases
+* **Scalable composition** that maintains consistency while enabling incremental adoption and gradual modernization
+
+### Multi-Layered Building Blocks Architecture
+
+Our blueprints use a multi-layered architecture that bridges the gap between business requirements and technical implementation:
+
+| Layer | Implementation Type | Purpose | Key Features |
+|-------|-------------------|---------|--------------|
+| **Infrastructure Foundation** | Abstract base classes | Shared infrastructure components and common services | • Standardized interfaces and contracts<br/>• Extensible foundation for custom implementations |
+| **General Use Case Implementation** | Concrete implementation classes | Implementations for common patterns across industries | • Configurable parameters for different environments<br/>• Abstract method implementations with general-purpose solutions |
+| **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 |
+
+### Security & Compliance
+
+All components include enterprise-grade security by default:
+
+* **CDK Nag Integration**: Automated security compliance checking
+* **AWS Well-Architected**: Security, reliability, and performance best practices
+* **Encryption & IAM**: At-rest/in-transit encryption with least-privilege access
+* **Compliance Reports**: Generate reports with `npm test -- --testPathPattern="nag.test.ts"`
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/cdklabs/cdk-appmod-catalog-blueprints/blob/main/CONTRIBUTING.md) for detailed guidelines on how to contribute to this project.
+
+## Disclaimer
+
+These 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.
+
+## License
+
+Apache License 2.0 - see [LICENSE](https://github.com/cdklabs/cdk-appmod-catalog-blueprints/blob/main/LICENSE) file for details.

{appmod_catalog_blueprints-1.2.2 → appmod_catalog_blueprints-1.4.0}/setup.py

@@ -5,7 +5,7 @@ kwargs = json.loads(
     """
 {
     "name": "appmod-catalog-blueprints",
-    "version": "1.2.2",
+    "version": "1.4.0",
     "description": "Serverless infrastructure components organized by business use cases",
     "license": "Apache-2.0",
     "url": "https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git",
@@ -26,7 +26,7 @@ kwargs = json.loads(
     ],
     "package_data": {
         "appmod_catalog_blueprints._jsii": [
-            "cdk-appmod-catalog-blueprints@1.2.2.jsii.tgz"
+            "cdk-appmod-catalog-blueprints@1.4.0.jsii.tgz"
         ],
         "appmod_catalog_blueprints": [
             "py.typed"
@@ -37,7 +37,7 @@ kwargs = json.loads(
         "aws-cdk-lib>=2.218.0, <3.0.0",
         "aws-cdk.aws-lambda-python-alpha>=2.218.0.a0, <3.0.0",
         "constructs>=10.0.5, <11.0.0",
-        "jsii>=1.115.0, <2.0.0",
+        "jsii>=1.118.0, <2.0.0",
         "publication>=0.0.3",
         "typeguard>=2.13.3,<4.3.0"
     ],