maxsim-flutter 1.0.0

package/templates/modules/api/lib/features/api/domain/exceptions/api_exception.dart.hbs

@@ -0,0 +1,31 @@
+/// Typed exception for API errors with status code and message.
+class ApiException implements Exception {
+  final int? statusCode;
+  final String message;
+  final dynamic data;
+
+  const ApiException({
+    this.statusCode,
+    required this.message,
+    this.data,
+  });
+
+  /// Creates an [ApiException] from a generic error.
+  factory ApiException.fromError(Object error) {
+    return ApiException(message: error.toString());
+  }
+
+  bool get isUnauthorized => statusCode == 401;
+  bool get isForbidden => statusCode == 403;
+  bool get isNotFound => statusCode == 404;
+  bool get isServerError => statusCode != null && statusCode! >= 500;
+  bool get isTimeout => statusCode == null && message.contains('timeout');
+
+  @override
+  String toString() {
+    if (statusCode != null) {
+      return 'ApiException($statusCode): $message';
+    }
+    return 'ApiException: $message';
+  }
+}

package/templates/modules/api/lib/features/api/domain/repositories/api_repository.dart.hbs

@@ -0,0 +1,8 @@
+/// Base repository interface for API operations.
+///
+/// Extend this interface for feature-specific API repositories.
+/// Implementations should use [ApiClient] for HTTP requests.
+abstract class ApiRepository {
+  /// Perform a health check against the API.
+  Future<bool> healthCheck();
+}

package/templates/modules/api/lib/features/api/presentation/providers/api_provider.dart.hbs

@@ -0,0 +1,17 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+import '../../data/datasources/api_client.dart';
+import '../../data/repositories/api_repository_impl.dart';
+import '../../domain/repositories/api_repository.dart';
+
+part 'api_provider.g.dart';
+
+@riverpod
+ApiClient apiClient(Ref ref) {
+  return ApiClient();
+}
+
+@riverpod
+ApiRepository apiRepository(Ref ref) {
+  return ApiRepositoryImpl(ref.watch(apiClientProvider));
+}

package/templates/modules/api/pubspec.partial.yaml

@@ -0,0 +1,7 @@
+dependencies:
+  dio: ^5.7.0
+  retrofit: ^4.4.1
+  json_annotation: ^4.9.0
+dev_dependencies:
+  retrofit_generator: ^9.1.5
+  json_serializable: ^6.9.0

package/templates/modules/auth/lib/features/auth/data/datasources/auth_remote_datasource.dart.hbs

@@ -0,0 +1,181 @@
+import '../models/auth_user_model.dart';
+{{#ifEquals modules.auth.provider "firebase"}}
+import 'package:firebase_auth/firebase_auth.dart' as firebase;
+{{/ifEquals}}
+{{#ifEquals modules.auth.provider "supabase"}}
+import 'package:supabase_flutter/supabase_flutter.dart';
+{{/ifEquals}}
+
+abstract class AuthRemoteDataSource {
+  Stream<AuthUserModel?> get authStateChanges;
+  Future<AuthUserModel?> get currentUser;
+  Future<AuthUserModel> signInWithEmail(String email, String password);
+  Future<AuthUserModel> registerWithEmail(String email, String password, String? displayName);
+  Future<void> signOut();
+  Future<void> resetPassword(String email);
+}
+{{#ifEquals modules.auth.provider "firebase"}}
+
+class FirebaseAuthDataSource implements AuthRemoteDataSource {
+  final firebase.FirebaseAuth _firebaseAuth;
+
+  FirebaseAuthDataSource({firebase.FirebaseAuth? firebaseAuth})
+      : _firebaseAuth = firebaseAuth ?? firebase.FirebaseAuth.instance;
+
+  AuthUserModel? _mapUser(firebase.User? user) {
+    if (user == null) return null;
+    return AuthUserModel(
+      id: user.uid,
+      email: user.email ?? '',
+      displayName: user.displayName,
+      photoUrl: user.photoURL,
+      emailVerified: user.emailVerified,
+    );
+  }
+
+  @override
+  Stream<AuthUserModel?> get authStateChanges =>
+      _firebaseAuth.authStateChanges().map(_mapUser);
+
+  @override
+  Future<AuthUserModel?> get currentUser async =>
+      _mapUser(_firebaseAuth.currentUser);
+
+  @override
+  Future<AuthUserModel> signInWithEmail(String email, String password) async {
+    final credential = await _firebaseAuth.signInWithEmailAndPassword(
+      email: email,
+      password: password,
+    );
+    return _mapUser(credential.user)!;
+  }
+
+  @override
+  Future<AuthUserModel> registerWithEmail(
+    String email,
+    String password,
+    String? displayName,
+  ) async {
+    final credential = await _firebaseAuth.createUserWithEmailAndPassword(
+      email: email,
+      password: password,
+    );
+    if (displayName != null) {
+      await credential.user?.updateDisplayName(displayName);
+    }
+    return _mapUser(credential.user)!;
+  }
+
+  @override
+  Future<void> signOut() => _firebaseAuth.signOut();
+
+  @override
+  Future<void> resetPassword(String email) =>
+      _firebaseAuth.sendPasswordResetEmail(email: email);
+}
+{{/ifEquals}}
+{{#ifEquals modules.auth.provider "supabase"}}
+
+class SupabaseAuthDataSource implements AuthRemoteDataSource {
+  final SupabaseClient _client;
+
+  SupabaseAuthDataSource({SupabaseClient? client})
+      : _client = client ?? Supabase.instance.client;
+
+  AuthUserModel? _mapUser(User? user) {
+    if (user == null) return null;
+    return AuthUserModel(
+      id: user.id,
+      email: user.email ?? '',
+      displayName: user.userMetadata?['display_name'] as String?,
+      emailVerified: user.emailConfirmedAt != null,
+    );
+  }
+
+  @override
+  Stream<AuthUserModel?> get authStateChanges =>
+      _client.auth.onAuthStateChange.map((event) => _mapUser(event.session?.user));
+
+  @override
+  Future<AuthUserModel?> get currentUser async =>
+      _mapUser(_client.auth.currentUser);
+
+  @override
+  Future<AuthUserModel> signInWithEmail(String email, String password) async {
+    final response = await _client.auth.signInWithPassword(
+      email: email,
+      password: password,
+    );
+    return _mapUser(response.user)!;
+  }
+
+  @override
+  Future<AuthUserModel> registerWithEmail(
+    String email,
+    String password,
+    String? displayName,
+  ) async {
+    final response = await _client.auth.signUp(
+      email: email,
+      password: password,
+      data: displayName != null ? {'display_name': displayName} : null,
+    );
+    return _mapUser(response.user)!;
+  }
+
+  @override
+  Future<void> signOut() => _client.auth.signOut();
+
+  @override
+  Future<void> resetPassword(String email) async {
+    await _client.auth.resetPasswordForEmail(email);
+  }
+}
+{{/ifEquals}}
+{{#ifEquals modules.auth.provider "custom"}}
+
+class CustomAuthDataSource implements AuthRemoteDataSource {
+  // TODO: Implement with your custom backend API.
+  // Inject your HTTP client (e.g., Dio) here.
+
+  @override
+  Stream<AuthUserModel?> get authStateChanges {
+    // TODO: Implement auth state stream (e.g., polling or WebSocket)
+    throw UnimplementedError('Implement auth state changes for custom backend');
+  }
+
+  @override
+  Future<AuthUserModel?> get currentUser {
+    // TODO: Implement current user check (e.g., validate stored token)
+    throw UnimplementedError('Implement current user for custom backend');
+  }
+
+  @override
+  Future<AuthUserModel> signInWithEmail(String email, String password) {
+    // TODO: POST to /auth/login
+    throw UnimplementedError('Implement sign in for custom backend');
+  }
+
+  @override
+  Future<AuthUserModel> registerWithEmail(
+    String email,
+    String password,
+    String? displayName,
+  ) {
+    // TODO: POST to /auth/register
+    throw UnimplementedError('Implement register for custom backend');
+  }
+
+  @override
+  Future<void> signOut() {
+    // TODO: POST to /auth/logout or clear tokens
+    throw UnimplementedError('Implement sign out for custom backend');
+  }
+
+  @override
+  Future<void> resetPassword(String email) {
+    // TODO: POST to /auth/reset-password
+    throw UnimplementedError('Implement reset password for custom backend');
+  }
+}
+{{/ifEquals}}

package/templates/modules/auth/lib/features/auth/data/models/auth_user_model.dart.hbs

@@ -0,0 +1,27 @@
+import '../../domain/entities/user_entity.dart';
+
+class AuthUserModel {
+  final String id;
+  final String email;
+  final String? displayName;
+  final String? photoUrl;
+  final bool emailVerified;
+
+  const AuthUserModel({
+    required this.id,
+    required this.email,
+    this.displayName,
+    this.photoUrl,
+    this.emailVerified = false,
+  });
+
+  UserEntity toEntity() {
+    return UserEntity(
+      id: id,
+      email: email,
+      displayName: displayName,
+      photoUrl: photoUrl,
+      emailVerified: emailVerified,
+    );
+  }
+}

package/templates/modules/auth/lib/features/auth/data/repositories/auth_repository_impl.dart.hbs

@@ -0,0 +1,49 @@
+import '../../domain/entities/user_entity.dart';
+import '../../domain/repositories/auth_repository.dart';
+import '../datasources/auth_remote_datasource.dart';
+
+class AuthRepositoryImpl implements AuthRepository {
+  final AuthRemoteDataSource _remoteDataSource;
+
+  const AuthRepositoryImpl(this._remoteDataSource);
+
+  @override
+  Stream<UserEntity?> get authStateChanges =>
+      _remoteDataSource.authStateChanges.map((model) => model?.toEntity());
+
+  @override
+  Future<UserEntity?> get currentUser async {
+    final model = await _remoteDataSource.currentUser;
+    return model?.toEntity();
+  }
+
+  @override
+  Future<UserEntity> signInWithEmail({
+    required String email,
+    required String password,
+  }) async {
+    final model = await _remoteDataSource.signInWithEmail(email, password);
+    return model.toEntity();
+  }
+
+  @override
+  Future<UserEntity> registerWithEmail({
+    required String email,
+    required String password,
+    String? displayName,
+  }) async {
+    final model = await _remoteDataSource.registerWithEmail(
+      email,
+      password,
+      displayName,
+    );
+    return model.toEntity();
+  }
+
+  @override
+  Future<void> signOut() => _remoteDataSource.signOut();
+
+  @override
+  Future<void> resetPassword({required String email}) =>
+      _remoteDataSource.resetPassword(email);
+}

package/templates/modules/auth/lib/features/auth/domain/entities/user_entity.dart.hbs

@@ -0,0 +1,18 @@
+import 'package:freezed_annotation/freezed_annotation.dart';
+
+part 'user_entity.freezed.dart';
+part 'user_entity.g.dart';
+
+@freezed
+class UserEntity with _$UserEntity {
+  const factory UserEntity({
+    required String id,
+    required String email,
+    String? displayName,
+    String? photoUrl,
+    @Default(false) bool emailVerified,
+  }) = _UserEntity;
+
+  factory UserEntity.fromJson(Map<String, dynamic> json) =>
+      _$UserEntityFromJson(json);
+}

package/templates/modules/auth/lib/features/auth/domain/repositories/auth_repository.dart.hbs

@@ -0,0 +1,22 @@
+import '../entities/user_entity.dart';
+
+abstract class AuthRepository {
+  Stream<UserEntity?> get authStateChanges;
+
+  Future<UserEntity?> get currentUser;
+
+  Future<UserEntity> signInWithEmail({
+    required String email,
+    required String password,
+  });
+
+  Future<UserEntity> registerWithEmail({
+    required String email,
+    required String password,
+    String? displayName,
+  });
+
+  Future<void> signOut();
+
+  Future<void> resetPassword({required String email});
+}

package/templates/modules/auth/lib/features/auth/domain/usecases/register_usecase.dart.hbs

@@ -0,0 +1,20 @@
+import '../entities/user_entity.dart';
+import '../repositories/auth_repository.dart';
+
+class RegisterUseCase {
+  final AuthRepository _repository;
+
+  const RegisterUseCase(this._repository);
+
+  Future<UserEntity> call({
+    required String email,
+    required String password,
+    String? displayName,
+  }) {
+    return _repository.registerWithEmail(
+      email: email,
+      password: password,
+      displayName: displayName,
+    );
+  }
+}

package/templates/modules/auth/lib/features/auth/domain/usecases/sign_in_usecase.dart.hbs

@@ -0,0 +1,15 @@
+import '../entities/user_entity.dart';
+import '../repositories/auth_repository.dart';
+
+class SignInUseCase {
+  final AuthRepository _repository;
+
+  const SignInUseCase(this._repository);
+
+  Future<UserEntity> call({
+    required String email,
+    required String password,
+  }) {
+    return _repository.signInWithEmail(email: email, password: password);
+  }
+}

package/templates/modules/auth/lib/features/auth/domain/usecases/sign_out_usecase.dart.hbs

@@ -0,0 +1,11 @@
+import '../repositories/auth_repository.dart';
+
+class SignOutUseCase {
+  final AuthRepository _repository;
+
+  const SignOutUseCase(this._repository);
+
+  Future<void> call() {
+    return _repository.signOut();
+  }
+}

package/templates/modules/auth/lib/features/auth/presentation/pages/login_page.dart.hbs

@@ -0,0 +1,118 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:go_router/go_router.dart';
+import '../providers/auth_provider.dart';
+
+class LoginPage extends ConsumerStatefulWidget {
+  const LoginPage({super.key});
+
+  @override
+  ConsumerState<LoginPage> createState() => _LoginPageState();
+}
+
+class _LoginPageState extends ConsumerState<LoginPage> {
+  final _formKey = GlobalKey<FormState>();
+  final _emailController = TextEditingController();
+  final _passwordController = TextEditingController();
+  bool _isLoading = false;
+
+  @override
+  void dispose() {
+    _emailController.dispose();
+    _passwordController.dispose();
+    super.dispose();
+  }
+
+  Future<void> _handleLogin() async {
+    if (!_formKey.currentState!.validate()) return;
+
+    setState(() => _isLoading = true);
+
+    try {
+      final repository = ref.read(authRepositoryProvider);
+      await repository.signInWithEmail(
+        email: _emailController.text.trim(),
+        password: _passwordController.text,
+      );
+      if (mounted) {
+        context.go('/');
+      }
+    } catch (e) {
+      if (mounted) {
+        ScaffoldMessenger.of(context).showSnackBar(
+          SnackBar(content: Text('Login failed: $e')),
+        );
+      }
+    } finally {
+      if (mounted) {
+        setState(() => _isLoading = false);
+      }
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('Login')),
+      body: Padding(
+        padding: const EdgeInsets.all(16.0),
+        child: Form(
+          key: _formKey,
+          child: Column(
+            mainAxisAlignment: MainAxisAlignment.center,
+            children: [
+              TextFormField(
+                controller: _emailController,
+                decoration: const InputDecoration(
+                  labelText: 'Email',
+                  border: OutlineInputBorder(),
+                ),
+                keyboardType: TextInputType.emailAddress,
+                validator: (value) {
+                  if (value == null || value.isEmpty) {
+                    return 'Please enter your email';
+                  }
+                  return null;
+                },
+              ),
+              const SizedBox(height: 16),
+              TextFormField(
+                controller: _passwordController,
+                decoration: const InputDecoration(
+                  labelText: 'Password',
+                  border: OutlineInputBorder(),
+                ),
+                obscureText: true,
+                validator: (value) {
+                  if (value == null || value.isEmpty) {
+                    return 'Please enter your password';
+                  }
+                  return null;
+                },
+              ),
+              const SizedBox(height: 24),
+              SizedBox(
+                width: double.infinity,
+                child: FilledButton(
+                  onPressed: _isLoading ? null : _handleLogin,
+                  child: _isLoading
+                      ? const SizedBox(
+                          height: 20,
+                          width: 20,
+                          child: CircularProgressIndicator(strokeWidth: 2),
+                        )
+                      : const Text('Login'),
+                ),
+              ),
+              const SizedBox(height: 16),
+              TextButton(
+                onPressed: () => context.go('/register'),
+                child: const Text("Don't have an account? Register"),
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}

package/templates/modules/auth/lib/features/auth/presentation/pages/register_page.dart.hbs

@@ -0,0 +1,131 @@
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:go_router/go_router.dart';
+import '../providers/auth_provider.dart';
+
+class RegisterPage extends ConsumerStatefulWidget {
+  const RegisterPage({super.key});
+
+  @override
+  ConsumerState<RegisterPage> createState() => _RegisterPageState();
+}
+
+class _RegisterPageState extends ConsumerState<RegisterPage> {
+  final _formKey = GlobalKey<FormState>();
+  final _nameController = TextEditingController();
+  final _emailController = TextEditingController();
+  final _passwordController = TextEditingController();
+  bool _isLoading = false;
+
+  @override
+  void dispose() {
+    _nameController.dispose();
+    _emailController.dispose();
+    _passwordController.dispose();
+    super.dispose();
+  }
+
+  Future<void> _handleRegister() async {
+    if (!_formKey.currentState!.validate()) return;
+
+    setState(() => _isLoading = true);
+
+    try {
+      final repository = ref.read(authRepositoryProvider);
+      await repository.registerWithEmail(
+        email: _emailController.text.trim(),
+        password: _passwordController.text,
+        displayName: _nameController.text.trim().isNotEmpty
+            ? _nameController.text.trim()
+            : null,
+      );
+      if (mounted) {
+        context.go('/');
+      }
+    } catch (e) {
+      if (mounted) {
+        ScaffoldMessenger.of(context).showSnackBar(
+          SnackBar(content: Text('Registration failed: $e')),
+        );
+      }
+    } finally {
+      if (mounted) {
+        setState(() => _isLoading = false);
+      }
+    }
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: const Text('Register')),
+      body: Padding(
+        padding: const EdgeInsets.all(16.0),
+        child: Form(
+          key: _formKey,
+          child: Column(
+            mainAxisAlignment: MainAxisAlignment.center,
+            children: [
+              TextFormField(
+                controller: _nameController,
+                decoration: const InputDecoration(
+                  labelText: 'Display Name (optional)',
+                  border: OutlineInputBorder(),
+                ),
+              ),
+              const SizedBox(height: 16),
+              TextFormField(
+                controller: _emailController,
+                decoration: const InputDecoration(
+                  labelText: 'Email',
+                  border: OutlineInputBorder(),
+                ),
+                keyboardType: TextInputType.emailAddress,
+                validator: (value) {
+                  if (value == null || value.isEmpty) {
+                    return 'Please enter your email';
+                  }
+                  return null;
+                },
+              ),
+              const SizedBox(height: 16),
+              TextFormField(
+                controller: _passwordController,
+                decoration: const InputDecoration(
+                  labelText: 'Password',
+                  border: OutlineInputBorder(),
+                ),
+                obscureText: true,
+                validator: (value) {
+                  if (value == null || value.length < 6) {
+                    return 'Password must be at least 6 characters';
+                  }
+                  return null;
+                },
+              ),
+              const SizedBox(height: 24),
+              SizedBox(
+                width: double.infinity,
+                child: FilledButton(
+                  onPressed: _isLoading ? null : _handleRegister,
+                  child: _isLoading
+                      ? const SizedBox(
+                          height: 20,
+                          width: 20,
+                          child: CircularProgressIndicator(strokeWidth: 2),
+                        )
+                      : const Text('Register'),
+                ),
+              ),
+              const SizedBox(height: 16),
+              TextButton(
+                onPressed: () => context.go('/login'),
+                child: const Text('Already have an account? Login'),
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}