cdk-cost-analyzer 0.1.1

package/README.md

@@ -0,0 +1,480 @@
+# CDK Cost Analyzer
+
+[![CI](https://github.com/buildinginthecloud/cdk-cost-analyzer/actions/workflows/test.yml/badge.svg)](https://github.com/buildinginthecloud/cdk-cost-analyzer/actions/workflows/test.yml)
+
+A TypeScript package that analyzes AWS CDK infrastructure changes and provides cost impact summaries. Compare CloudFormation templates to understand the financial implications of your infrastructure changes before deployment.
+
+## Key Features
+
+- **Template Comparison**: Parse and diff CloudFormation templates (JSON/YAML) to identify added, removed, and modified resources
+- **Cost Estimation**: Calculate monthly costs for AWS resources using real-time AWS Pricing API data
+- **Automatic CDK Synthesis**: Optionally synthesize CDK applications in CI/CD pipelines
+- **Cost Threshold Enforcement**: Fail pipelines when cost increases exceed configured thresholds
+- **Configuration Management**: Project-specific configuration for thresholds, usage assumptions, and exclusions
+- **Dual Interface**: Use as a CLI tool for quick analysis or import as a library for programmatic integration
+- **Clear Reporting**: Generate formatted cost reports in text, JSON, or Markdown formats
+- **GitLab Integration**: Post cost analysis reports as comments on GitLab merge requests
+- **FinOps Awareness**: Help developers understand cost implications during the development cycle
+
+## Use Cases
+
+- Analyze infrastructure changes in GitLab merge requests
+- Estimate costs before deploying CDK applications
+- Enforce cost approval gates in CI/CD pipelines
+- Compare different infrastructure configurations
+- Promote cost-conscious development practices
+
+## Installation
+
+```bash
+npm install cdk-cost-analyzer
+```
+
+## Documentation
+
+- **[Configuration Guide](docs/CONFIGURATION.md)** - Configure thresholds, usage assumptions, and exclusions
+- **[CI/CD Integration](docs/CI_CD.md)** - GitHub Actions and GitLab CI/CD setup guides
+- **[Resource Calculator Reference](docs/CALCULATORS.md)** - Detailed cost calculation methods and assumptions
+- **[Troubleshooting Guide](docs/TROUBLESHOOTING.md)** - Common issues and solutions
+- **[Development Guide](docs/DEVELOPMENT.md)** - Local development, testing, and architecture
+- **[Release Process](docs/RELEASE.md)** - How to release new versions
+- **[Examples](examples/)** - Example templates and API usage demonstrations
+
+## Quick Start
+
+### CLI Usage
+
+```bash
+# Compare two CloudFormation templates
+cdk-cost-analyzer base-template.json target-template.json --region eu-central-1
+
+# Use pipeline command with automatic synthesis
+cdk-cost-analyzer pipeline \
+  --synth \
+  --cdk-app-path ./infrastructure \
+  --region eu-central-1 \
+  --config .cdk-cost-analyzer.yml
+
+# Generate Markdown output
+cdk-cost-analyzer compare base.yaml target.yaml --region us-east-1 --format markdown
+
+# Show help
+cdk-cost-analyzer --help
+```
+
+### Configuration File
+
+Create `.cdk-cost-analyzer.yml` in your project:
+
+```yaml
+# Cost thresholds
+thresholds:
+  default:
+    warning: 50   # USD per month
+    error: 200
+  environments:
+    production:
+      warning: 25
+      error: 100
+
+# Custom usage assumptions
+usageAssumptions:
+  s3:
+    storageGB: 500
+  natGateway:
+    dataProcessedGB: 500
+  alb:
+    newConnectionsPerSecond: 50
+    processedBytesGB: 1000
+
+# Resource exclusions
+exclusions:
+  resourceTypes:
+    - AWS::IAM::Role
+    - AWS::Logs::LogGroup
+```
+
+See the [Configuration Guide](docs/CONFIGURATION.md) for complete documentation.
+
+### GitLab CI/CD Integration
+
+Add to your `.gitlab-ci.yml`:
+
+```yaml
+cost-analysis:
+  stage: cost-analysis
+  image: node:18
+  before_script:
+    - npm install -g cdk-cost-analyzer
+  script:
+    - |
+      cdk-cost-analyzer pipeline \
+        --synth \
+        --cdk-app-path ./infrastructure \
+        --region $AWS_REGION \
+        --config .cdk-cost-analyzer.yml \
+        --format markdown \
+        --post-to-gitlab
+  only:
+    - merge_requests
+```
+
+See the [CI/CD Integration Guide](docs/CI_CD.md) for complete documentation.
+
+### GitHub Actions Integration
+
+Add to your `.github/workflows/ci.yml`:
+
+```yaml
+name: CI
+
+on:
+  push:
+    branches: ['**']
+  pull_request:
+    branches: ['**']
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '18.x'
+          cache: 'npm'
+      - run: npm ci
+      - run: npm run eslint
+      - run: npm run lint
+      - run: npm run build
+      - run: npm run test:silent
+```
+
+The GitHub Actions workflow automatically runs on every push and pull request, executing linting, type checking, build verification, and the complete test suite. See the [CI/CD Integration Guide](docs/CI_CD.md) for complete documentation.
+
+### Programmatic Usage
+
+See [examples/api-usage.js](examples/api-usage.js) for a complete working example.
+
+```typescript
+import { analyzeCosts } from 'cdk-cost-analyzer';
+
+const result = await analyzeCosts({
+  baseTemplate: baseTemplateContent,
+  targetTemplate: targetTemplateContent,
+  region: 'eu-central-1',
+  format: 'text'  // or 'json', 'markdown'
+});
+
+console.log(`Cost delta: ${result.totalDelta} ${result.currency}`);
+console.log(`Added resources: ${result.addedResources.length}`);
+console.log(`Removed resources: ${result.removedResources.length}`);
+console.log(`Modified resources: ${result.modifiedResources.length}`);
+console.log(result.summary); // Formatted report
+```
+
+### GitLab Integration
+
+Post cost analysis reports as comments on GitLab merge requests:
+
+```typescript
+import { analyzeCosts, GitLabIntegration } from 'cdk-cost-analyzer';
+
+// Analyze costs
+const result = await analyzeCosts({
+  baseTemplate: baseTemplateContent,
+  targetTemplate: targetTemplateContent,
+  region: 'eu-central-1',
+  format: 'markdown'
+});
+
+// Post to GitLab MR
+const gitlab = GitLabIntegration.fromEnvironment();
+await gitlab.postMergeRequestComment(
+  process.env.CI_PROJECT_ID!,
+  process.env.CI_MERGE_REQUEST_IID!,
+  result.summary
+);
+```
+
+Configure in `.gitlab-ci.yml`:
+
+```yaml
+cost-analysis:
+  stage: test
+  script:
+    - npm install cdk-cost-analyzer
+    - cdk-cost-analyzer base.json target.json --format markdown > cost-report.md
+    - node -e "require('cdk-cost-analyzer').GitLabIntegration.fromEnvironment().postMergeRequestComment(process.env.CI_PROJECT_ID, process.env.CI_MERGE_REQUEST_IID, require('fs').readFileSync('cost-report.md', 'utf8'))"
+  only:
+    - merge_requests
+```
+
+## Supported Resource Types
+
+### Core Resources (Phase 1 & 2)
+
+- **AWS::EC2::Instance** - EC2 instances with on-demand pricing
+- **AWS::S3::Bucket** - S3 buckets with storage and request costs
+- **AWS::Lambda::Function** - Lambda functions with invocation and duration costs
+- **AWS::RDS::DBInstance** - RDS database instances
+- **AWS::DynamoDB::Table** - DynamoDB tables with provisioned or on-demand billing
+- **AWS::ECS::Service** - ECS services with Fargate or EC2 launch types
+- **AWS::ApiGateway::RestApi** - API Gateway REST APIs
+- **AWS::ApiGatewayV2::Api** - API Gateway HTTP and WebSocket APIs
+
+### Networking Resources (Phase 3 - Current)
+
+- **AWS::EC2::NatGateway** - NAT Gateways with hourly and data processing costs
+- **AWS::ElasticLoadBalancingV2::LoadBalancer** - Application and Network Load Balancers with LCU costs
+- **AWS::EC2::VPCEndpoint** - VPC Endpoints (interface and gateway types)
+
+### Content Delivery & Caching (Phase 3 - Current)
+
+- **AWS::CloudFront::Distribution** - CloudFront distributions with data transfer and request costs
+
+### Coming Soon
+
+- ElastiCache clusters
+- EKS clusters
+- And more...
+
+## Cost Calculation Assumptions
+
+For resources with usage-based pricing, the following default assumptions are used:
+
+### Phase 1 Resources
+- **S3 Buckets**: 100 GB standard storage, 10,000 GET requests/month
+- **Lambda Functions**: 1 million invocations/month, average 1-second duration
+- **RDS Instances**: 100 GB storage, single-AZ deployment
+- **EC2 Instances**: 730 hours/month (full month), on-demand pricing
+
+### Phase 2 Resources
+- **DynamoDB Tables (Provisioned)**: 5 read capacity units, 5 write capacity units
+- **DynamoDB Tables (On-Demand)**: 10M read requests, 1M write requests per month
+- **ECS Services (Fargate)**: 0.25 vCPU, 0.5 GB memory per task
+- **API Gateway (REST)**: 1M requests per month
+- **API Gateway (HTTP)**: 1M requests per month
+- **API Gateway (WebSocket)**: 1M messages, 100K connection minutes per month
+
+### Phase 3 Resources
+- **NAT Gateway**: 500 GB data processed per month
+- **Application Load Balancer**: 50 new connections/sec, 5,000 active connections/min, 1,000 GB processed
+- **Network Load Balancer**: 100 new connections/sec, 10,000 active connections/min, 1,000 GB processed
+- **VPC Endpoint (Interface)**: 100 GB data processed per month
+- **CloudFront Distribution**: 100 GB data transfer out, 1M HTTP/HTTPS requests per month
+
+These assumptions are documented in cost reports and can be customized via configuration file or by extending the calculator classes.
+
+## Report Formats
+
+### Text Format (Default)
+
+```
+============================================================
+CDK Cost Analysis Report
+============================================================
+
+Total Cost Delta: +$245.60
+
+ADDED RESOURCES:
+------------------------------------------------------------
+  • MyEC2Instance (AWS::EC2::Instance): $30.40 [high]
+  • MyRDSInstance (AWS::RDS::DBInstance): $215.20 [high]
+
+REMOVED RESOURCES:
+------------------------------------------------------------
+  (none)
+
+MODIFIED RESOURCES:
+------------------------------------------------------------
+  (none)
+
+============================================================
+```
+
+### Markdown Format
+
+Perfect for GitLab merge request comments:
+
+```markdown
+# CDK Cost Analysis Report
+
+**Total Cost Delta:** +$245.60
+
+## Added Resources
+
+| Logical ID | Type | Monthly Cost |
+|------------|------|--------------|
+| MyEC2Instance | AWS::EC2::Instance | $30.40 |
+| MyRDSInstance | AWS::RDS::DBInstance | $215.20 |
+
+## Modified Resources
+
+| Logical ID | Type | Old Cost | New Cost | Delta |
+|------------|------|----------|----------|-------|
+| MyFunction | AWS::Lambda::Function | $50.00 | $75.00 | +$25.00 |
+```
+
+### JSON Format
+
+For programmatic processing and integration:
+
+```json
+{
+  "totalDelta": 245.60,
+  "currency": "USD",
+  "addedCosts": [...],
+  "removedCosts": [...],
+  "modifiedCosts": [...]
+}
+```
+
+## Configuration
+
+### AWS Credentials
+
+The tool uses the AWS SDK default credential chain. Ensure you have AWS credentials configured:
+
+```bash
+# Via environment variables
+export AWS_ACCESS_KEY_ID=your_access_key
+export AWS_SECRET_ACCESS_KEY=your_secret_key
+
+# Or via AWS CLI configuration
+aws configure
+```
+
+### Region
+
+Specify the AWS region for pricing data:
+
+```bash
+# CLI
+cdk-cost-analyzer base.json target.json --region eu-central-1
+
+# API
+analyzeCosts({ baseTemplate, targetTemplate, region: 'eu-central-1' })
+```
+
+Default region: `eu-central-1`
+
+### GitLab Configuration
+
+For GitLab integration, the following environment variables are used:
+
+- `CI_JOB_TOKEN` or `GITLAB_TOKEN`: GitLab API authentication token
+- `CI_API_V4_URL`: GitLab API URL (defaults to `https://gitlab.com/api/v4`)
+- `CI_PROJECT_ID`: Project ID (automatically set in GitLab CI)
+- `CI_MERGE_REQUEST_IID`: Merge request IID (automatically set in GitLab CI)
+
+## Error Handling
+
+The tool handles errors gracefully:
+
+- **Invalid templates**: Clear error messages for malformed JSON/YAML
+- **Missing pricing data**: Resources marked as "unknown cost" with warnings
+- **API failures**: Automatic retry with exponential backoff, fallback to cached data
+- **Unsupported resources**: Marked as "unknown cost", analysis continues
+- **GitLab API errors**: Descriptive error messages with HTTP status codes
+
+## Development Roadmap
+
+### Phase 1 (MVP) ✓
+
+- Core template parsing and diffing
+- Basic resource costing (EC2, S3, Lambda, RDS)
+- CLI and programmatic API
+- AWS Pricing API integration
+- Text and JSON report formats
+
+### Phase 2 ✓
+
+- Markdown report formatter for GitLab MR comments
+- GitLab integration module for posting reports
+- Extended resource support (DynamoDB, ECS, API Gateway)
+- Property-based testing with fast-check
+- Comprehensive unit tests for all new features
+
+### Phase 3 (Production Readiness) ✓
+
+- **Automatic CDK Synthesis**: Synthesize CDK applications in CI/CD pipelines
+- **Cost Threshold Enforcement**: Fail pipelines when costs exceed configured limits
+- **Configuration Management**: Project-specific configuration files
+- **Additional Resource Calculators**: NAT Gateway, ALB, NLB, VPC Endpoints
+- **Enhanced CLI**: Pipeline command with synthesis and threshold support
+- **Comprehensive Documentation**: Configuration guide, GitLab CI/CD examples
+
+### Phase 4 (Planned)
+
+- Multi-region cost analysis with regional breakdowns
+- Historical cost tracking and trend analysis
+- Cost optimization recommendations
+- Support for Savings Plans and Reserved Instances
+- Additional resource types (CloudFront, ElastiCache, EKS)
+- GitHub Actions integration
+- Slack/Teams notifications
+
+## Testing
+
+The project includes comprehensive test coverage with both unit and property-based tests:
+
+```bash
+# Run all tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Build the project
+npm run build
+
+# Type checking
+npm run lint
+```
+
+## Contributing
+
+Contributions are welcome! Please see the [implementation plan](.kiro/specs/cdk-cost-analyzer/tasks.md) for current development tasks.
+
+### Development Setup
+
+This project uses [Projen](https://projen.io/) for project management. All project configuration is managed through `.projenrc.ts`.
+
+```bash
+# Clone the repository
+git clone https://gitlab.com/anwb/cdk-cost-analyzer.git
+cd cdk-cost-analyzer
+
+# Install dependencies
+npm install
+
+# Synthesize project files (after modifying .projenrc.ts)
+npx projen
+
+# Build the project
+npx projen build
+
+# Run tests
+npx projen test
+
+# Run linting
+npx projen lint
+
+# Compile TypeScript
+npx projen compile
+```
+
+**Important**: Never manually edit generated files like `package.json`, `tsconfig.json`, or `.gitignore`. Always modify `.projenrc.ts` and run `npx projen` to regenerate these files.
+
+### Release Process
+
+See [docs/RELEASE.md](docs/RELEASE.md) for detailed release instructions.
+
+## License
+
+MIT
+
+## Acknowledgments
+
+Inspired by [Infracost](https://www.infracost.io/) for Terraform. Built for ANWB's CDK and GitLab CI/CD workflows.

package/SECURITY.md

@@ -0,0 +1,117 @@
+# Security Policy
+
+## Supported Versions
+
+We release patches for security vulnerabilities in the following versions:
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 0.x.x   | :white_check_mark: |
+
+## Reporting a Vulnerability
+
+We take security vulnerabilities seriously. If you discover a security issue, please report it responsibly.
+
+### How to Report
+
+**Do not** create a public GitHub issue for security vulnerabilities.
+
+Instead, please report security vulnerabilities by emailing:
+
+**yvo@buildinginthecloud.com**
+
+Include the following information:
+- Description of the vulnerability
+- Steps to reproduce the issue
+- Potential impact
+- Suggested fix (if available)
+
+### What to Expect
+
+- **Acknowledgment**: We will acknowledge receipt of your report within 48 hours
+- **Assessment**: We will assess the vulnerability and determine its severity
+- **Fix**: We will work on a fix and coordinate disclosure timing with you
+- **Credit**: We will credit you in the security advisory (unless you prefer to remain anonymous)
+
+### Security Best Practices
+
+When using CDK Cost Analyzer:
+
+1. **AWS Credentials**: Never commit AWS credentials to version control
+   - Use environment variables or AWS credential files
+   - Use IAM roles when running in AWS environments
+   - Follow the principle of least privilege
+
+2. **Dependencies**: Keep dependencies up to date
+   - Run `npm audit` regularly
+   - Update dependencies when security patches are available
+
+3. **CI/CD**: Secure your CI/CD pipelines
+   - Use secrets management for tokens and credentials
+   - Limit access to CI/CD variables
+   - Use protected branches for production deployments
+
+4. **GitLab Integration**: Protect your GitLab tokens
+   - Use project or group access tokens with minimal scope
+   - Store tokens in CI/CD variables (masked and protected)
+   - Rotate tokens regularly
+
+5. **Command Execution**: The tool executes CDK synthesis commands securely
+   - Commands are executed without shell interpretation to prevent injection attacks
+   - Arguments are passed as arrays rather than concatenated strings
+
+## Security Considerations
+
+### AWS Pricing API
+
+The tool requires AWS credentials with `pricing:GetProducts` permission. This is a read-only permission with minimal security risk.
+
+Recommended IAM policy:
+```json
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Effect": "Allow",
+      "Action": [
+        "pricing:GetProducts"
+      ],
+      "Resource": "*"
+    }
+  ]
+}
+```
+
+### GitLab API Access
+
+When using GitLab integration, the tool requires a token with `api` scope to post merge request comments. Use project or group access tokens instead of personal access tokens when possible.
+
+### Template Analysis
+
+The tool parses CloudFormation templates but does not execute them or make changes to your AWS infrastructure. Template analysis is performed locally and does not send template content to external services (except AWS Pricing API for cost data).
+
+## Known Security Considerations
+
+- The tool caches AWS Pricing API responses in memory to reduce API calls. Cached data is not persisted to disk.
+- GitLab API tokens are read from environment variables and not logged or stored.
+- CloudFormation templates may contain sensitive information. Ensure proper access controls on repositories containing templates.
+- CDK synthesis commands are executed with `shell: false` to prevent command injection vulnerabilities.
+
+## Disclosure Policy
+
+We follow coordinated vulnerability disclosure:
+
+1. Security issues are fixed in private
+2. A security advisory is prepared
+3. A new version is released with the fix
+4. The security advisory is published
+5. Credit is given to the reporter (if desired)
+
+## Security Updates
+
+Security updates are released as patch versions and announced through:
+- GitHub Security Advisories
+- Release notes in CHANGELOG.md
+- NPM package updates
+
+Subscribe to repository notifications to stay informed about security updates.

package/dist/api/index.d.ts

@@ -0,0 +1,11 @@
+import { AnalyzeOptions, CostAnalysisResult } from './types';
+export * from './types';
+export { TemplateParseError } from '../parser/TemplateParser';
+export { PricingAPIError, UnsupportedResourceError } from '../pricing/types';
+export * from '../integrations';
+export * from '../reporter/types';
+export * from '../config';
+export * from '../synthesis';
+export * from '../threshold';
+export * from '../pipeline';
+export declare function analyzeCosts(options: AnalyzeOptions): Promise<CostAnalysisResult>;

package/dist/api/index.js

@@ -0,0 +1,65 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnsupportedResourceError = exports.PricingAPIError = exports.TemplateParseError = void 0;
+exports.analyzeCosts = analyzeCosts;
+const DiffEngine_1 = require("../diff/DiffEngine");
+const TemplateParser_1 = require("../parser/TemplateParser");
+const PricingService_1 = require("../pricing/PricingService");
+const Reporter_1 = require("../reporter/Reporter");
+__exportStar(require("./types"), exports);
+var TemplateParser_2 = require("../parser/TemplateParser");
+Object.defineProperty(exports, "TemplateParseError", { enumerable: true, get: function () { return TemplateParser_2.TemplateParseError; } });
+var types_1 = require("../pricing/types");
+Object.defineProperty(exports, "PricingAPIError", { enumerable: true, get: function () { return types_1.PricingAPIError; } });
+Object.defineProperty(exports, "UnsupportedResourceError", { enumerable: true, get: function () { return types_1.UnsupportedResourceError; } });
+__exportStar(require("../integrations"), exports);
+__exportStar(require("../reporter/types"), exports);
+__exportStar(require("../config"), exports);
+__exportStar(require("../synthesis"), exports);
+__exportStar(require("../threshold"), exports);
+__exportStar(require("../pipeline"), exports);
+async function analyzeCosts(options) {
+    const region = options.region || 'eu-central-1';
+    const format = options.format || 'text';
+    if (!options.baseTemplate || !options.targetTemplate) {
+        throw new Error('Both baseTemplate and targetTemplate are required');
+    }
+    const parser = new TemplateParser_1.TemplateParser();
+    const diffEngine = new DiffEngine_1.DiffEngine();
+    const pricingService = new PricingService_1.PricingService();
+    const reporter = new Reporter_1.Reporter();
+    try {
+        const baseTemplateObj = parser.parse(options.baseTemplate);
+        const targetTemplateObj = parser.parse(options.targetTemplate);
+        const diff = diffEngine.diff(baseTemplateObj, targetTemplateObj);
+        const costDelta = await pricingService.getCostDelta(diff, region);
+        const summary = reporter.generateReport(costDelta, format);
+        return {
+            totalDelta: costDelta.totalDelta,
+            currency: costDelta.currency,
+            addedResources: costDelta.addedCosts,
+            removedResources: costDelta.removedCosts,
+            modifiedResources: costDelta.modifiedCosts,
+            summary,
+        };
+    }
+    finally {
+        // Clean up resources to prevent hanging connections
+        pricingService.destroy();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYXBpL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBZ0JBLG9DQW1DQztBQWxERCxtREFBZ0Q7QUFDaEQsNkRBQTBEO0FBQzFELDhEQUEyRDtBQUMzRCxtREFBZ0Q7QUFFaEQsMENBQXdCO0FBQ3hCLDJEQUE4RDtBQUFyRCxvSEFBQSxrQkFBa0IsT0FBQTtBQUMzQiwwQ0FBNkU7QUFBcEUsd0dBQUEsZUFBZSxPQUFBO0FBQUUsaUhBQUEsd0JBQXdCLE9BQUE7QUFDbEQsa0RBQWdDO0FBQ2hDLG9EQUFrQztBQUNsQyw0Q0FBMEI7QUFDMUIsK0NBQTZCO0FBQzdCLCtDQUE2QjtBQUM3Qiw4Q0FBNEI7QUFFckIsS0FBSyxVQUFVLFlBQVksQ0FBQyxPQUF1QjtJQUN4RCxNQUFNLE1BQU0sR0FBRyxPQUFPLENBQUMsTUFBTSxJQUFJLGNBQWMsQ0FBQztJQUNoRCxNQUFNLE1BQU0sR0FBRyxPQUFPLENBQUMsTUFBTSxJQUFJLE1BQU0sQ0FBQztJQUV4QyxJQUFJLENBQUMsT0FBTyxDQUFDLFlBQVksSUFBSSxDQUFDLE9BQU8sQ0FBQyxjQUFjLEVBQUUsQ0FBQztRQUNyRCxNQUFNLElBQUksS0FBSyxDQUFDLG1EQUFtRCxDQUFDLENBQUM7SUFDdkUsQ0FBQztJQUVELE1BQU0sTUFBTSxHQUFHLElBQUksK0JBQWMsRUFBRSxDQUFDO0lBQ3BDLE1BQU0sVUFBVSxHQUFHLElBQUksdUJBQVUsRUFBRSxDQUFDO0lBQ3BDLE1BQU0sY0FBYyxHQUFHLElBQUksK0JBQWMsRUFBRSxDQUFDO0lBQzVDLE1BQU0sUUFBUSxHQUFHLElBQUksbUJBQVEsRUFBRSxDQUFDO0lBRWhDLElBQUksQ0FBQztRQUNILE1BQU0sZUFBZSxHQUFHLE1BQU0sQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFlBQVksQ0FBQyxDQUFDO1FBQzNELE1BQU0saUJBQWlCLEdBQUcsTUFBTSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsY0FBYyxDQUFDLENBQUM7UUFFL0QsTUFBTSxJQUFJLEdBQUcsVUFBVSxDQUFDLElBQUksQ0FBQyxlQUFlLEVBQUUsaUJBQWlCLENBQUMsQ0FBQztRQUVqRSxNQUFNLFNBQVMsR0FBRyxNQUFNLGNBQWMsQ0FBQyxZQUFZLENBQUMsSUFBSSxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBRWxFLE1BQU0sT0FBTyxHQUFHLFFBQVEsQ0FBQyxjQUFjLENBQUMsU0FBUyxFQUFFLE1BQU0sQ0FBQyxDQUFDO1FBRTNELE9BQU87WUFDTCxVQUFVLEVBQUUsU0FBUyxDQUFDLFVBQVU7WUFDaEMsUUFBUSxFQUFFLFNBQVMsQ0FBQyxRQUFRO1lBQzVCLGNBQWMsRUFBRSxTQUFTLENBQUMsVUFBVTtZQUNwQyxnQkFBZ0IsRUFBRSxTQUFTLENBQUMsWUFBWTtZQUN4QyxpQkFBaUIsRUFBRSxTQUFTLENBQUMsYUFBYTtZQUMxQyxPQUFPO1NBQ1IsQ0FBQztJQUNKLENBQUM7WUFBUyxDQUFDO1FBQ1Qsb0RBQW9EO1FBQ3BELGNBQWMsQ0FBQyxPQUFPLEVBQUUsQ0FBQztJQUMzQixDQUFDO0FBQ0gsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IEFuYWx5emVPcHRpb25zLCBDb3N0QW5hbHlzaXNSZXN1bHQgfSBmcm9tICcuL3R5cGVzJztcbmltcG9ydCB7IERpZmZFbmdpbmUgfSBmcm9tICcuLi9kaWZmL0RpZmZFbmdpbmUnO1xuaW1wb3J0IHsgVGVtcGxhdGVQYXJzZXIgfSBmcm9tICcuLi9wYXJzZXIvVGVtcGxhdGVQYXJzZXInO1xuaW1wb3J0IHsgUHJpY2luZ1NlcnZpY2UgfSBmcm9tICcuLi9wcmljaW5nL1ByaWNpbmdTZXJ2aWNlJztcbmltcG9ydCB7IFJlcG9ydGVyIH0gZnJvbSAnLi4vcmVwb3J0ZXIvUmVwb3J0ZXInO1xuXG5leHBvcnQgKiBmcm9tICcuL3R5cGVzJztcbmV4cG9ydCB7IFRlbXBsYXRlUGFyc2VFcnJvciB9IGZyb20gJy4uL3BhcnNlci9UZW1wbGF0ZVBhcnNlcic7XG5leHBvcnQgeyBQcmljaW5nQVBJRXJyb3IsIFVuc3VwcG9ydGVkUmVzb3VyY2VFcnJvciB9IGZyb20gJy4uL3ByaWNpbmcvdHlwZXMnO1xuZXhwb3J0ICogZnJvbSAnLi4vaW50ZWdyYXRpb25zJztcbmV4cG9ydCAqIGZyb20gJy4uL3JlcG9ydGVyL3R5cGVzJztcbmV4cG9ydCAqIGZyb20gJy4uL2NvbmZpZyc7XG5leHBvcnQgKiBmcm9tICcuLi9zeW50aGVzaXMnO1xuZXhwb3J0ICogZnJvbSAnLi4vdGhyZXNob2xkJztcbmV4cG9ydCAqIGZyb20gJy4uL3BpcGVsaW5lJztcblxuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGFuYWx5emVDb3N0cyhvcHRpb25zOiBBbmFseXplT3B0aW9ucyk6IFByb21pc2U8Q29zdEFuYWx5c2lzUmVzdWx0PiB7XG4gIGNvbnN0IHJlZ2lvbiA9IG9wdGlvbnMucmVnaW9uIHx8ICdldS1jZW50cmFsLTEnO1xuICBjb25zdCBmb3JtYXQgPSBvcHRpb25zLmZvcm1hdCB8fCAndGV4dCc7XG5cbiAgaWYgKCFvcHRpb25zLmJhc2VUZW1wbGF0ZSB8fCAhb3B0aW9ucy50YXJnZXRUZW1wbGF0ZSkge1xuICAgIHRocm93IG5ldyBFcnJvcignQm90aCBiYXNlVGVtcGxhdGUgYW5kIHRhcmdldFRlbXBsYXRlIGFyZSByZXF1aXJlZCcpO1xuICB9XG5cbiAgY29uc3QgcGFyc2VyID0gbmV3IFRlbXBsYXRlUGFyc2VyKCk7XG4gIGNvbnN0IGRpZmZFbmdpbmUgPSBuZXcgRGlmZkVuZ2luZSgpO1xuICBjb25zdCBwcmljaW5nU2VydmljZSA9IG5ldyBQcmljaW5nU2VydmljZSgpO1xuICBjb25zdCByZXBvcnRlciA9IG5ldyBSZXBvcnRlcigpO1xuXG4gIHRyeSB7XG4gICAgY29uc3QgYmFzZVRlbXBsYXRlT2JqID0gcGFyc2VyLnBhcnNlKG9wdGlvbnMuYmFzZVRlbXBsYXRlKTtcbiAgICBjb25zdCB0YXJnZXRUZW1wbGF0ZU9iaiA9IHBhcnNlci5wYXJzZShvcHRpb25zLnRhcmdldFRlbXBsYXRlKTtcblxuICAgIGNvbnN0IGRpZmYgPSBkaWZmRW5naW5lLmRpZmYoYmFzZVRlbXBsYXRlT2JqLCB0YXJnZXRUZW1wbGF0ZU9iaik7XG5cbiAgICBjb25zdCBjb3N0RGVsdGEgPSBhd2FpdCBwcmljaW5nU2VydmljZS5nZXRDb3N0RGVsdGEoZGlmZiwgcmVnaW9uKTtcblxuICAgIGNvbnN0IHN1bW1hcnkgPSByZXBvcnRlci5nZW5lcmF0ZVJlcG9ydChjb3N0RGVsdGEsIGZvcm1hdCk7XG5cbiAgICByZXR1cm4ge1xuICAgICAgdG90YWxEZWx0YTogY29zdERlbHRhLnRvdGFsRGVsdGEsXG4gICAgICBjdXJyZW5jeTogY29zdERlbHRhLmN1cnJlbmN5LFxuICAgICAgYWRkZWRSZXNvdXJjZXM6IGNvc3REZWx0YS5hZGRlZENvc3RzLFxuICAgICAgcmVtb3ZlZFJlc291cmNlczogY29zdERlbHRhLnJlbW92ZWRDb3N0cyxcbiAgICAgIG1vZGlmaWVkUmVzb3VyY2VzOiBjb3N0RGVsdGEubW9kaWZpZWRDb3N0cyxcbiAgICAgIHN1bW1hcnksXG4gICAgfTtcbiAgfSBmaW5hbGx5IHtcbiAgICAvLyBDbGVhbiB1cCByZXNvdXJjZXMgdG8gcHJldmVudCBoYW5naW5nIGNvbm5lY3Rpb25zXG4gICAgcHJpY2luZ1NlcnZpY2UuZGVzdHJveSgpO1xuICB9XG59XG4iXX0=

package/dist/api/types.d.ts

@@ -0,0 +1,15 @@
+import { ResourceCost, ModifiedResourceCost } from '../pricing/types';
+export interface AnalyzeOptions {
+    baseTemplate: string;
+    targetTemplate: string;
+    region?: string;
+    format?: 'text' | 'json' | 'markdown';
+}
+export interface CostAnalysisResult {
+    totalDelta: number;
+    currency: string;
+    addedResources: ResourceCost[];
+    removedResources: ResourceCost[];
+    modifiedResources: ModifiedResourceCost[];
+    summary: string;
+}