Auth API

A concrete API implementation of the `AuthClient` interface for the Flutter News App Toolkit.

This auth_api package provides a concrete API implementation of the AuthClient interface (defined in package:auth_client) within the Flutter News App Full Source Code Toolkit. It encapsulates the logic for interacting with a backend authentication service via HTTP requests, leveraging package:http_client for underlying communication and standardized error handling. This package is crucial for applications that need to connect to a remote authentication service, ensuring consistent and robust authentication mechanisms across the Flutter mobile app, web dashboard, and Dart Frog backend API.

⭐ Feature Showcase: Robust Backend Authentication Integration

This package offers a comprehensive set of features for integrating with a backend authentication service.

🧱 Core Functionality

🚀 AuthClient Implementation

• AuthApi Class: A concrete implementation of the AuthClient interface, providing a standardized way to interact with a remote authentication service.
• HTTP-Based Communication: Utilizes package:http_client for making HTTP requests to the backend authentication service.

🔐 Authentication Flows

• requestSignInCode: Initiates the process of requesting a sign-in code via email.
• verifySignInCode: Verifies the sign-in code to complete the authentication process.
• signInAnonymously: Allows users to sign in anonymously, creating a temporary user identity on the backend.
• getCurrentUser: Retrieves the currently authenticated user's details from the backend.
• authStateChanges Stream: Provides a stream for monitoring real-time authentication state changes.
• signOut: Handles signing out the current user from the backend.

🛡️ Standardized Error Handling

• HttpException Propagation: Propagates standardized HttpException errors (from core) from the underlying http_client, ensuring consistent and predictable error management across the application layers.

💉 Dependency Injection Ready

• HttpClient Dependency: Requires a configured HttpClient instance (from package:http_client) via its constructor, promoting loose coupling and testability.

💡 Your Advantage: This package provides a robust and production-ready API client for backend authentication. It simplifies the integration of remote authentication services, leverages standardized error handling, and ensures consistent authentication flows across your application ecosystem.

🔑 Licensing

This source code is licensed for commercial use and is provided for local evaluation. A Lifetime Commercial License is required for any production or public-facing application.

Please visit the main Flutter News App Full Source Code Toolkit organization page to review the full license terms and to purchase.