Internal fixes. No functional changes.

Internal fixes. No functional changes.

See Release Notes

Changelog

0.1.0

First beta release of Aim Framework - a modular ecosystem for Dart.

Highlights

• Lightweight, fast web server framework
• Native PostgreSQL driver (no external dependencies)
• Type-safe ORM with Record syntax
• CLI tools with hot reload and database migrations

Web Server (aim_server)

• HTTP server built on Dart's native HttpServer
• Path-based routing with parameter support (/users/:id)
• Composable middleware chain
• JSON, text, HTML response handling
• Real-time SSE streaming support
• Custom error handlers (404, global)

Middleware Packages

• aim_server_cors: CORS configuration
• aim_server_cookie: Secure cookie management
• aim_server_form: Form data parsing
• aim_server_multipart: File upload handling
• aim_server_static: Static file serving
• aim_server_logger: HTTP request logging
• aim_server_sse: Server-Sent Events
• aim_server_jwt: JWT authentication
• aim_server_basic_auth: Basic authentication

Testing (aim_server_testing)

• Test helpers and matchers
• Mock objects for unit testing
• Integration test utilities

Database (aim_database + aim_postgres)

• Database abstraction layer
• Native PostgreSQL Wire Protocol implementation
• SSL/TLS support (disable, allow, prefer, require, verify-ca, verify-full)
• Authentication: cleartext, MD5, SCRAM-SHA-256
• Named parameters (:name) and positional parameters ($1)
• Transaction support with automatic commit/rollback

ORM (aim_orm + aim_orm_postgres + aim_orm_codegen)

• Type-safe table definitions using Dart Record syntax
• Column types: integer, bigint, varchar, text, boolean, timestamp, uuid, json
• Column modifiers: primaryKey, unique, nullable, withDefault, indexed
• Query builders: SELECT, INSERT, UPDATE, DELETE
• Condition operators: eq, gt, lt, gte, lte, inList
• Code generation with build_runner

CLI (aim_cli)

• aim create <name>: Project scaffolding
• aim dev: Development server with hot reload
• aim build: Production build with native compilation
• aim db:generate: Migration SQL generation from schema diff
• aim db:migrate: Apply pending migrations
• aim db:rollback: Rollback migrations
• aim db:status: Show migration status

Known Limitations

• ORM Relations (1:1, 1:N, N:N) not yet supported
• SQLite driver not yet available
• db:reset command not yet implemented

Requirements

• Dart SDK: ^3.10.0
• PostgreSQL: 9.5+ (SCRAM-SHA-256 requires 10+)

First beta release of Aim Framework - a modular ecosystem for Dart.

Highlights

• Lightweight, fast web server framework
• Native PostgreSQL driver (no external dependencies)
• Type-safe ORM with Record syntax
• CLI tools with hot reload and database migrations

Web Server (aim_server)

• HTTP server built on Dart's native HttpServer
• Path-based routing with parameter support (/users/:id)
• Composable middleware chain
• JSON, text, HTML response handling
• Real-time SSE streaming support
• Custom error handlers (404, global)

Middleware Packages

• aim_server_cors: CORS configuration
• aim_server_cookie: Secure cookie management
• aim_server_form: Form data parsing
• aim_server_multipart: File upload handling
• aim_server_static: Static file serving
• aim_server_logger: HTTP request logging
• aim_server_sse: Server-Sent Events
• aim_server_jwt: JWT authentication
• aim_server_basic_auth: Basic authentication

Testing (aim_server_testing)

• Test helpers and matchers
• Mock objects for unit testing
• Integration test utilities

Database (aim_database + aim_postgres)

• Database abstraction layer
• Native PostgreSQL Wire Protocol implementation
• SSL/TLS support (disable, allow, prefer, require, verify-ca, verify-full)
• Authentication: cleartext, MD5, SCRAM-SHA-256
• Named parameters (:name) and positional parameters ($1)
• Transaction support with automatic commit/rollback

ORM (aim_orm + aim_orm_postgres + aim_orm_codegen)

• Type-safe table definitions using Dart Record syntax
• Column types: integer, bigint, varchar, text, boolean, timestamp, uuid, json
• Column modifiers: primaryKey, unique, nullable, withDefault, indexed
• Query builders: SELECT, INSERT, UPDATE, DELETE
• Condition operators: eq, gt, lt, gte, lte, inList
• Code generation with build_runner

CLI (aim_cli)

• aim create <name>: Project scaffolding
• aim dev: Development server with hot reload
• aim build: Production build with native compilation
• aim db:generate: Migration SQL generation from schema diff
• aim db:migrate: Apply pending migrations
• aim db:rollback: Rollback migrations
• aim db:status: Show migration status

Known Limitations

• ORM Relations (1:1, 1:N, N:N) not yet supported
• SQLite driver not yet available
• db:reset command not yet implemented

Requirements

• Dart SDK: ^3.10.0
• PostgreSQL: 9.5+ (SCRAM-SHA-256 requires 10+)

See Release Notes

Enhancements

• Real-time SSE streaming support: Automatically disables buffering for Server-Sent Events (SSE) responses
  • Detects Content-Type: text/event-stream and sets bufferOutput = false on the underlying HttpResponse
  • Enables real-time event streaming without buffering delays
  • Non-SSE responses continue to use buffering for optimal performance
• Streaming integration tests: Added comprehensive integration tests for SSE streaming behavior
  • Validates real-time event delivery with timestamp verification
  • Ensures buffering behavior is correct for both SSE and non-SSE responses

Technical Details

The server now automatically optimizes response buffering based on content type:

• SSE responses (text/event-stream): Buffering disabled for real-time streaming
• Other responses: Buffering enabled for performance

This change is backward compatible and requires no code changes from users.

New Features

• Public handle(Request) method: Added a new public API for handling requests without the HTTP layer
  • Enables testing Aim applications without starting an actual HTTP server
  • Executes the full request handling logic: routing, middleware, handlers, and error handling
  • Primarily designed for use with aim_server_testing package

Use Case

final app = Aim();
app.get('/users/:id', (c) => c.json({'id': c.param('id')}));

final request = Request('GET', Uri.parse('http://localhost/users/123'));
final response = await app.handle(request);
// response.statusCode == 200

This new API simplifies testing and allows for direct request processing in scenarios where the HTTP layer is not needed.

Fix README.md and pubspec description

Breaking Changes

• CORS middleware removed: CORS functionality has been extracted to the aim_server_cors package
• If you need CORS support, add the aim_server_cors package to your dependencies

Migration

Before:

import 'package:aim_server/aim_server.dart';

final app = Aim();
app.use(cors());

After:

import 'package:aim_server/aim_server.dart';
import 'package:aim_server_cors/aim_server_cors.dart';

final app = Aim();
app.use(cors());

pubspec.yaml:

dependencies:
  aim_server: ^0.1.0
  aim_server_cors: ^0.0.1

Fixes

Fix README.md

Initial release of aim_server - A lightweight and fast web server framework for Dart.

Features

• HTTP Server: Built on Dart's native HTTP server with minimal overhead
• Routing:
  • Path-based routing with support for GET, POST, PUT, DELETE methods
  • Path parameters (e.g., /users/:id)
  • Query parameter support
• Middleware: Composable middleware chain for request/response processing
• Request/Response Handling:
  • JSON request/response support
  • Text and HTML responses
  • Redirect support
  • Custom status codes
• CORS: Built-in Cross-Origin Resource Sharing support
• Error Handling:
  • Custom 404 handler
  • Global error handler
• Environment Variables: Built-in environment variable support with the Env class
• Type Safety: Full Dart type safety throughout the API

Supported

• Dart SDK: ^3.10.0
• Platforms: All platforms supported by Dart (Linux, macOS, Windows)

What's Included

• Core Aim application class
• Context for request handling
• Request and Response abstractions
• Body for request body handling
• Message for HTTP message handling
• CORS middleware utilities
• Environment variable utilities