Changelog

All notable changes to APSO are documented here.

The format is based on Keep a Changelog , and APSO adheres to Semantic Versioning .

[Unreleased]

Added

• Better Auth integration guide
• Flutter frontend integration guide
• Kubernetes deployment examples

Changed

• Improved error messages for schema validation
• Updated TypeORM to v0.3.x

Fixed

• Connection pool exhaustion under high load
• Race condition in concurrent migrations

[1.2.0] - 2024-12-15

Added

• Go (Gin) template: Full support for generating Go backends with Gin and GORM
• API key authentication: Generate and manage API keys for machine-to-machine auth
• Batch operations: Support for bulk create, update, and delete operations
• apso doctor command to diagnose common issues

Changed

• Improved query performance with automatic eager loading hints
• Better TypeScript types in generated SDK
• Reduced Docker image size by 40%

Fixed

• Schema validation now catches circular relationships
• Fixed UUID handling in query parameters
• Resolved memory leak in development hot reload

Security

• Updated dependencies to address CVE-2024-XXXXX
• Added rate limiting to authentication endpoints

[1.1.0] - 2024-10-20

Added

• Python (FastAPI) template: Generate Python backends with FastAPI and SQLAlchemy
• SDK queries: Rich filtering, sorting, and pagination API
• Relationship cascades: Configure cascade behavior for relationships
• Preview environments for pull requests

Changed

• Improved code generation speed by 60%
• Better error messages during schema validation
• Cleaner generated code structure

Fixed

• Fixed migration generation for optional fields
• Resolved issues with ManyToMany relationship tables
• Fixed timezone handling in date fields

[1.0.0] - 2024-08-01

Added

• Initial stable release
• TypeScript (NestJS) template: Complete backend generation
• Schema definition: Entity, field, and relationship configuration
• Multi-tenancy: Organization-based data isolation
• APSO CLI: Project creation, code generation, deployment
• APSO Cloud: Managed hosting platform
• TypeScript SDK: Type-safe frontend integration
• Authentication: JWT-based auth with BYOA support
• API documentation: Automatic Swagger/OpenAPI generation
• Database migrations: TypeORM migration support

[0.9.0] - 2024-06-15 (Beta)

Added

• Beta release for early adopters
• Core code generation functionality
• Basic CLI commands
• PostgreSQL support

Known Issues

• Limited relationship types
• No Python or Go support
• Manual migration management required

Version Compatibility

Upgrading

From 1.1.x to 1.2.x

# Update CLI
npm install -g @apso/cli@latest
 
# Regenerate code
apso generate
 
# Run new migrations
npm run migration:run

No breaking changes. New features are opt-in.

From 1.0.x to 1.1.x

# Update CLI
npm install -g @apso/cli@latest
 
# Update dependencies in package.json
npm update
 
# Regenerate code
apso generate

Breaking changes:

• DTO class names now use Create*Dto and Update*Dto pattern
• Service method signatures changed for pagination

From 0.9.x to 1.0.x

Major upgrade requiring manual migration. See Migration Guide.

Deprecations

Deprecated in 1.2.0

• apso scaffold command (use apso generate instead)
• --legacy flag on generate command

Deprecated in 1.1.0

• findById method (use findOne with where clause)
• Custom migration templates (use extension hooks instead)

Release Schedule

APSO follows a regular release schedule:

• Major releases: Annually (breaking changes)
• Minor releases: Monthly (new features)
• Patch releases: As needed (bug fixes)

Long-Term Support (LTS)

• Major version: 12 months of security updates
• Minor version: 3 months of security updates

Subscribe to Updates

• GitHub Releases: github.com/mavric/apso/releases 
• Newsletter: Subscribe at apso.cloud/newsletter 
• Twitter: @apsodev