augint-billing-lib 1.2.0

Billing service library for API usage tracking and Stripe integration.

Augint Billing Library

Billing service library for API usage tracking, tiered pricing calculations, and Stripe integration.

Overview

This library provides the core business logic for:

• Tracking API usage per customer
• Calculating charges with tiered pricing models
• Managing Stripe customers and payments
• Processing webhooks from Stripe
• Publishing billing events to AWS EventBridge
• Generating usage and billing reports

EventBridge Integration

The library automatically publishes billing events to AWS EventBridge for real-time monitoring and integration:

• Usage Tracking: billing.usage.tracked events when API usage is recorded
• Customer Creation: billing.customer.created events for new customers
• Invoice Generation: billing.invoice.created events when invoices are generated
• Payment Processing: billing.payment.processed events for payment status updates

Event publishing can be disabled via BILLING_ENABLE_EVENT_PUBLISHING=false environment variable.

📊 Live Dashboards

📖 Documentation	🧪 Unit Tests	🔬 Integration Tests	📊 Coverage	⚡ Benchmarks	🔒 Security	⚖️ Compliance

🔑 Key Development Characteristics

Characteristic	Details
Merge Strategy	Configurable (see .env)
Deployment Model	Tag-based to PyPI
Environments	Local → PyPI
Preview Environments	N/A (library)
Pipeline Features	Semantic release, Auto-publish to PyPI
Special Considerations	90% coverage requirement, Mutation testing

---

Project Structure

augint-billing-lib-library/
├── src/
│   └── augint_billing_lib/      # Core library code (to be implemented)
├── tests/                   # Test suite (to be implemented)
├── examples/                # Original template code for reference
├── pyproject.toml          # Project dependencies and configuration
├── Makefile                # Development commands
└── README.md               # This file

Development Setup

# Install dependencies
make install

# Run tests
make test

# Check code quality
make lint
make type-check

# Generate documentation
make docs

Implementation Status

The library is fully implemented with all core components. Current implementation includes:

Library Exports (from planning spec)

• BillingService - Main service class
• UsageCollector - Track API usage
• PricingCalculator - Apply tiered pricing
• StripeManager - Stripe operations
• WebhookProcessor - Process Stripe webhooks
• ReportGenerator - Generate reports
• EventPublisher - Publish billing events to EventBridge
• Data models (Customer, UsageRecord, BillingPeriod, etc.)

Key Features Removed (Minimal Version)

• ✅ Feature flags removed
• ✅ Telemetry/Sentry removed
• ✅ Mutation testing removed
• ✅ Complex CLI structures removed

Dependencies

Core dependencies:

• click - CLI framework
• boto3 - AWS SDK (to be added)
• stripe - Stripe SDK (to be added)
• pydantic - Data validation (to be added)

Testing

The project uses pytest with pragmatic coverage targets:

• Library code: 70% coverage target
• Focus on core business logic
• Integration tests for AWS/Stripe interactions