Repository navigation
Releases: reshdesu/crash-analytics-api
Releases Β· reshdesu/crash-analytics-api
Release list
v1.2.0
π Changes since v1.1.4
What's Changed:
- fix: Resolve HMAC signature verification and client limit issues for read functionality
- feat: Add crash report reading functionality with client libraries and comprehensive documentation
Features
Enterprise Security
- HMAC Authentication - Cryptographically signed requests
- Rate Limiting - IP-based protection (configurable)
- Data Validation - 15+ validation rules prevent abuse
- Anonymous Reporting - Zero personal data collected
Core Functionality
- Universal API - Works with Python, JavaScript, Go, and more
- Auto-Setup - Database tables created automatically
- Multi-app Support - Single API for all your applications
- Self-Healing - Recreates missing tables if needed
Analytics & Insights
- 100+ SQL Queries - Ready-to-use analytics
- Hardware Analysis - GPU, CPU, memory breakdowns
- Error Patterns - Find common crash causes
- Dashboard Ready - Works with Grafana, Metabase
Quick Start
# 1. Fork and clone this repository
git clone https://github.com/reshdesu/crash-analytics-api.git
cd crash-analytics-api
# 2. Install dependencies
pnpm install
# 3. Set up Supabase + Cloudflare (see README.md)
# 4. Deploy
pnpm run deploy
# 5. Test your deployment
API_ENDPOINT="your-endpoint" HMAC_SECRET="your-secret" pnpm testDocumentation
- Setup Guide: See README.md for complete setup instructions
- Analytics Queries: Check database/example-queries.sql for 100+ example queries
- Python Client: Use clients/python/crash_reporter.py in your Python apps
Security
This release has been security audited:
- No secrets in version control
- HMAC request signing prevents abuse
- Rate limiting protects against DoS
- Input validation prevents injection attacks
- Anonymous data collection only
Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Security: Report security issues privately
Built for the developer community. Free, open source, and privacy-first.
v1.1.4
π Changes since v1.1.3
What's Changed:
- fix: Use dynamic repository information in release changelogs instead of hardcoded URLs
- fix: Update README with correct repository URLs instead of placeholders
Features
Enterprise Security
- HMAC Authentication - Cryptographically signed requests
- Rate Limiting - IP-based protection (configurable)
- Data Validation - 15+ validation rules prevent abuse
- Anonymous Reporting - Zero personal data collected
Core Functionality
- Universal API - Works with Python, JavaScript, Go, and more
- Auto-Setup - Database tables created automatically
- Multi-app Support - Single API for all your applications
- Self-Healing - Recreates missing tables if needed
Analytics & Insights
- 100+ SQL Queries - Ready-to-use analytics
- Hardware Analysis - GPU, CPU, memory breakdowns
- Error Patterns - Find common crash causes
- Dashboard Ready - Works with Grafana, Metabase
Quick Start
# 1. Fork and clone this repository
git clone https://github.com/reshdesu/crash-analytics-api.git
cd crash-analytics-api
# 2. Install dependencies
pnpm install
# 3. Set up Supabase + Cloudflare (see README.md)
# 4. Deploy
pnpm run deploy
# 5. Test your deployment
API_ENDPOINT="your-endpoint" HMAC_SECRET="your-secret" pnpm testDocumentation
- Setup Guide: See README.md for complete setup instructions
- Analytics Queries: Check database/example-queries.sql for 100+ example queries
- Python Client: Use clients/python/crash_reporter.py in your Python apps
Security
This release has been security audited:
- No secrets in version control
- HMAC request signing prevents abuse
- Rate limiting protects against DoS
- Input validation prevents injection attacks
- Anonymous data collection only
Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Security: Report security issues privately
Built for the developer community. Free, open source, and privacy-first.
v1.1.3
π Changes since v1.1.2
What's Changed:
- style: Remove emojis and bold formatting for professional release appearance
Features
Enterprise Security
- HMAC Authentication - Cryptographically signed requests
- Rate Limiting - IP-based protection (configurable)
- Data Validation - 15+ validation rules prevent abuse
- Anonymous Reporting - Zero personal data collected
Core Functionality
- Universal API - Works with Python, JavaScript, Go, and more
- Auto-Setup - Database tables created automatically
- Multi-app Support - Single API for all your applications
- Self-Healing - Recreates missing tables if needed
Analytics & Insights
- 100+ SQL Queries - Ready-to-use analytics
- Hardware Analysis - GPU, CPU, memory breakdowns
- Error Patterns - Find common crash causes
- Dashboard Ready - Works with Grafana, Metabase
Quick Start
# 1. Fork and clone this repository
git clone https://github.com/YOUR-USERNAME/crash-analytics-api.git
cd crash-analytics-api
# 2. Install dependencies
pnpm install
# 3. Set up Supabase + Cloudflare (see README.md)
# 4. Deploy
pnpm run deploy
# 5. Test your deployment
API_ENDPOINT="your-endpoint" HMAC_SECRET="your-secret" pnpm testDocumentation
- Setup Guide: See README.md for complete setup instructions
- Analytics Queries: Check database/example-queries.sql for 100+ example queries
- Python Client: Use clients/python/crash_reporter.py in your Python apps
Security
This release has been security audited:
- No secrets in version control
- HMAC request signing prevents abuse
- Rate limiting protects against DoS
- Input validation prevents injection attacks
- Anonymous data collection only
Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Security: Report security issues privately
Built for the developer community. Free, open source, and privacy-first.
v1.1.2
π Changes since v1.1.1
What's Changed:
- simplify: Change release name to just version number instead of long descriptive name
β¨ Features
π Enterprise Security
- HMAC Authentication - Cryptographically signed requests
- Rate Limiting - IP-based protection (configurable)
- Data Validation - 15+ validation rules prevent abuse
- Anonymous Reporting - Zero personal data collected
π οΈ Core Functionality
- Universal API - Works with Python, JavaScript, Go, and more
- Auto-Setup - Database tables created automatically
- Multi-app Support - Single API for all your applications
- Self-Healing - Recreates missing tables if needed
π Analytics & Insights
- 100+ SQL Queries - Ready-to-use analytics
- Hardware Analysis - GPU, CPU, memory breakdowns
- Error Patterns - Find common crash causes
- Dashboard Ready - Works with Grafana, Metabase
π Quick Start
# 1. Fork and clone this repository
git clone https://github.com/YOUR-USERNAME/crash-analytics-api.git
cd crash-analytics-api
# 2. Install dependencies
pnpm install
# 3. Set up Supabase + Cloudflare (see README.md)
# 4. Deploy
pnpm run deploy
# 5. Test your deployment
API_ENDPOINT="your-endpoint" HMAC_SECRET="your-secret" pnpm testπ Documentation
- Setup Guide: See README.md for complete setup instructions
- Analytics Queries: Check database/example-queries.sql for 100+ example queries
- Python Client: Use clients/python/crash_reporter.py in your Python apps
π‘οΈ Security
This release has been security audited:
- β No secrets in version control
- β HMAC request signing prevents abuse
- β Rate limiting protects against DoS
- β Input validation prevents injection attacks
- β Anonymous data collection only
π Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Security: Report security issues privately
Built with β€οΈ for the developer community. Free, open source, and privacy-first.
v1.1.1
π Changes since v1.0.1
What's Changed:
- fix: Fix release workflow YAML syntax by replacing problematic heredoc with echo statements
- fix: Update GitHub Actions workflow to use pnpm instead of npm
- fix: Fix GitHub Actions workflows and update database schema
- cleanup: Remove obsolete and unused files to streamline project
- fix: Resolve Python datetime compatibility issues and improve version management
- docs: Update README with accurate project information and setup process
- security: Remove remaining hardcoded project ID from init-database.js
- feat: Complete Universal Crash Analytics API with automated setup and client libraries
- fix: Remove iphash column and simplify database structure
- fix: Fix iphash generation and add local development environment
- security: Remove fallback values and add environment variable validation
- feat: Complete project restructuring and documentation
- Add comprehensive Wrangler CLI documentation
β¨ Features
π Enterprise Security
- HMAC Authentication - Cryptographically signed requests
- Rate Limiting - IP-based protection (configurable)
- Data Validation - 15+ validation rules prevent abuse
- Anonymous Reporting - Zero personal data collected
π οΈ Core Functionality
- Universal API - Works with Python, JavaScript, Go, and more
- Auto-Setup - Database tables created automatically
- Multi-app Support - Single API for all your applications
- Self-Healing - Recreates missing tables if needed
π Analytics & Insights
- 100+ SQL Queries - Ready-to-use analytics
- Hardware Analysis - GPU, CPU, memory breakdowns
- Error Patterns - Find common crash causes
- Dashboard Ready - Works with Grafana, Metabase
π Quick Start
# 1. Fork and clone this repository
git clone https://github.com/YOUR-USERNAME/crash-analytics-api.git
cd crash-analytics-api
# 2. Install dependencies
pnpm install
# 3. Set up Supabase + Cloudflare (see README.md)
# 4. Deploy
pnpm run deploy
# 5. Test your deployment
API_ENDPOINT="your-endpoint" HMAC_SECRET="your-secret" pnpm testπ Documentation
- Setup Guide: See README.md for complete setup instructions
- Analytics Queries: Check database/example-queries.sql for 100+ example queries
- Python Client: Use clients/python/crash_reporter.py in your Python apps
π‘οΈ Security
This release has been security audited:
- β No secrets in version control
- β HMAC request signing prevents abuse
- β Rate limiting protects against DoS
- β Input validation prevents injection attacks
- β Anonymous data collection only
π Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Security: Report security issues privately
Built with β€οΈ for the developer community. Free, open source, and privacy-first.
v1.0.0
π Universal Crash Analytics API v1.0.0
Production-ready crash reporting service that works with any application!
β¨ What's New in v1.0.0
π Enterprise Security
- HMAC Authentication - Cryptographically signed requests prevent spoofing
- Rate Limiting - IP-based protection (60 req/min default)
- Data Validation - 15+ validation rules prevent malicious payloads
- Row Level Security - Database-level insert-only policies
- Anonymous Reporting - Zero personal data, SHA-256 hashed IPs only
π οΈ Core Features
- Universal API - One endpoint for all your apps (Python, JS, Go, etc.)
- Auto-Setup - Tables created automatically on first use
- Database-first - Tries API first, falls back to local storage
- Multi-app Support - Single deployment handles multiple applications
- Hardware Analytics - Comprehensive system information collection
π Analytics & Insights
- 100+ SQL Queries - Ready-to-use analytics for crash data
- Hardware Breakdowns - GPU, CPU, memory analysis
- Error Pattern Detection - Find common crash causes
- Version Comparison - Track stability across releases
- Dashboard Ready - Works with Grafana, Metabase, custom apps
π Deployment
- Free Hosting - Uses Cloudflare Workers + Supabase free tiers
- 5-Step Setup - Fork β Configure β Deploy β Done
- Self-Healing - Recreates missing tables automatically
- Production Ready - Battle-tested with comprehensive validation
π― Perfect For
- Indie Developers - Cost-effective crash reporting
- Startups - Scalable alternative to expensive services
- Open Source Projects - Community-friendly crash analytics
- Enterprise Teams - Self-hosted with full data control
π Quick Start
# 1. Fork and clone
git clone https://github.com/YOUR-USERNAME/crash-analytics-api.git
cd crash-analytics-api
# 2. Install dependencies
pnpm install
# 3. Configure Cloudflare Worker
# Set environment variables in Cloudflare dashboard
# 4. Deploy
pnpm run deploy
# 5. Test
API_ENDPOINT="your-endpoint" HMAC_SECRET="your-secret" pnpm testπ‘ Usage Example
from crash_reporter import install_crash_handler
# One line to add crash reporting to any Python app
reporter = install_crash_handler(
app_name="my-app",
app_version="v1.0.0",
api_endpoint="https://your-worker.workers.dev",
hmac_secret="your-secret"
)
# All crashes now automatically reported + stored locally if API downπ Analytics Examples
-- GPU crashes in last 7 days
SELECT hardware_specs->'gpu'->>'name' as gpu, COUNT(*) as crashes
FROM crash_reports
WHERE created_at > NOW() - INTERVAL '7 days'
GROUP BY gpu ORDER BY crashes DESC;
-- App stability comparison
SELECT app_version, COUNT(*) / COUNT(DISTINCT ip_hash) as crashes_per_user
FROM crash_reports GROUP BY app_version;π Links
- Repository: https://github.com/reshdesu/crash-analytics-api
- Documentation: See README.md for complete setup guide
- Analytics Queries: database/example-queries.sql (100+ examples)
- Issues: Report bugs or request features
Built with β€οΈ for the developer community. Free, open source, and privacy-first.