Morni RSA Plugin #

A Flutter plugin for integrating Road Side Assistance (RSA) services into your Flutter applications. This plugin provides a seamless interface to manage service requests, user information, and active services.

Features #

• User Management
  • Fetch user information and profile details
• Service Management
  • List all active RSA services
  • Create new service requests
  • Cancel existing service requests
• Multi-language Support
  • Supports both Arabic (ar) and English (en)
• Error Handling
  • Comprehensive error handling and reporting
  • Type-safe API responses

Getting Started #

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  morni_rsa: ^0.0.1

Platform Configuration #

Android

Ensure you have the correct NDK version in your app's build.gradle.kts:

android {
    ndkVersion = "27.0.12077973"
    // ... other configurations
}

iOS

No additional configuration required.

Initialization #

Before using the plugin, initialize it with your API credentials:

import 'package:morni_rsa/service/initialization.dart';
import 'package:morni_rsa/model/language.dart';

void main() {
  MorniService.init(
    "YOUR_API_BASE_URL",
    "YOUR_API_TOKEN",
    Language.en, // or Language.ar for Arabic
  );
  
  runApp(const MyApp());
}

Usage #

Fetch User Information #

final apiService = ApiService();
final response = await apiService.getUser();

if (response.success && response.data != null) {
  final user = response.data!;
  print('User ID: ${user.morniUserId}');
  print('Name: ${user.firstName} ${user.lastName}');
}

Get Active Services #

final apiService = ApiService();
final response = await apiService.getActiveServices();

if (response.success && response.data != null) {
  final services = response.data!;
  for (final service in services) {
    print('Service: ${service.name}');
    print('Description: ${service.description}');
  }
}

Create a Service Request #

final request = ServiceRequest(
  userId: userId,
  serviceId: serviceId,
  addOnId: addOnId,
  pickUpLat: latitude,
  pickUpLng: longitude,
  pickUpTime: DateTime.now(),
  dropOffLocation: 'Location Name',
  note: 'Additional notes',
);

final response = await apiService.createServiceRequest(request);
if (response.success) {
  print('Service request created successfully');
}

Cancel a Service Request #

final response = await apiService.cancelServiceRequest(
  requestId,
  'Cancellation reason',
);

if (response.success) {
  print('Service request cancelled successfully');
}

Example #

Check out the example directory for a complete sample application demonstrating all features.

API Reference #

Models #

• User: Represents user information
• Service: Represents an RSA service
• ServiceRequest: Represents a service request
• ApiResponse<T>: Generic wrapper for API responses

Services #

• ApiService: Main service class for making API calls
• MorniService: Configuration and initialization service

Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

License #

This project is licensed under the LICENSE file in the root directory of this project.

Issues and Feedback #

Please file issues, bugs, or feature requests in our issue tracker.